technical-reference · implemented
Helper — BrazilianDocumentHelper
Formatação de CPF e CNPJ brasileiros a partir de valores normalizados.
Responsabilidade
Formata CPF, CNPJ e valores cuja natureza depende da quantidade de dígitos. Não valida dígitos verificadores: validação de CPF na fronteira de persistência continua em CpfCast ou no validator apropriado.
| Método | Comportamento |
|---|---|
formatCpf() | Formata 11 dígitos como 000.000.000-00; entrada inválida é preservada. |
formatCnpj() | Formata 14 dígitos como 00.000.000/0000-00; entrada inválida é preservada. |
formatCpfCnpj() | Escolhe CPF/CNPJ pelo tamanho; entrada vazia vira -. |
Checklist
- Implementar CPF, CNPJ e escolha automática por tamanho.
- Reutilizar DigitsHelper.
- Expor fachadas globais equivalentes.
- Cobrir valores mascarados e tamanhos inválidos em testes unitários diretos.