Validar nomes de feature flags

Esta capacidade valida um nome candidato contra um padrão prático da indústria: não vazio, todo em minúsculas, em kebab-case com hífens ou em snake_case (nunca os dois separadores na mesma string), pelo menos dois segmentos, prefixo descritivo como enable, feature, ff, rollout ou beta, no máximo sessenta e quatro caracteres e sem separadores nas bordas nem consecutivos. Entrada vazia falha com invalid_input e não é cobrada. Falhas de convenção devolvem um payload de sucesso com valid em false e uma lista ordenada de issues para a integração contínua falhar o build com um relatório claro.

O que a convenção de nomes exige

Primeiro, não pode estar vazio nem ser só espaços: um nome vazio é rejeitado imediatamente como invalid_input porque não há nada útil a avaliar. Segundo, cada caractere deve ser letra ASCII minúscula, dígito e exatamente um estilo de separador: hífens para kebab-case ou underscores para snake_case. Juntas, essas regras se alinham a chaves no estilo LaunchDarkly, toggles Unleash e a maioria dos arquivos JSON ou YAML internos sem inventar um dialeto de um único fornecedor.

Contrato de entrada, formato da resposta e erros

Em sucesso a resposta sempre inclui valid (booleano), o name após trim, style (kebab, snake ou null quando o padrão não foi classificado), prefix (primeiro segmento ou null), segments como array ordenado de strings, segment_count, has_descriptive_prefix, issues como lista estável e ordenada de códigos legíveis por máquina, e uma frase curta de convention adequada à interface. Quando o nome existe mas quebra a convenção, valid é false e issues lista códigos como not_lowercase, mixed_separators, missing_descriptive_prefix, too_few_segments, invalid_characters, consecutive_separators, leading_or_trailing_separator, too_long, missing_separator_segments ou invalid_pattern—sem lançar erro—para linters e bots de pull request imprimirem todos os problemas de uma vez. Somente nomes vazios, ausentes ou não string lançam invalid_input; essas falhas não consomem saldo pré-pago.

Onde a validação de nomes de flags se paga

Equipes de plataforma e de experiência do desenvolvedor conectam esta verificação a geradores de scaffolding para que novos flags não entrem sem prefixo nem estilo de separador. Jobs de integração contínua examinam pull requests que tocam catálogos de flags ou arquivos de ambiente de exemplo e falham o build quando um nome confundiria operadores meses depois. Ferramentas de analytics de produto e de experimentos usam as mesmas regras ao registrar chaves de rollout para painéis agruparem por prefixo de forma consistente em mobile, web e backend. Bots de code review chamam a API com uma string candidata e colam a lista de issues no fio da revisão em vez de discutir estilo por gosto. Como cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo, você pode validar milhares de nomes em um script de migração sem gasto surpresa; envios vazios permanecem sem cobrança como erros do cliente. Mantenha a tabela de prefixos alinhada ao estilo da sua organização mapeando verbos internos para o conjunto suportado, ou envolva este endpoint e rejeite qualquer prefixo que sua política proíba mesmo quando a convenção base passa.