Valida e higieniza dados brasileiros (CPF, CNPJ, telefone, CEP e mais) em workflows do n8n.
npm install n8n-nodes-br-data-utils

Nó do n8n para validar e higienizar dados brasileiros (CPF, CNPJ, telefone, celular e CEP).
``bash`
npm install n8n-nodes-br-data-utils
- ✅ CPF: Validação com dígitos verificadores + higienização
- ✅ CNPJ: Validação com dígitos verificadores + higienização
- ✅ Telefone: Validação números fixos (10 dígitos) + higienização
- ✅ Celular: Validação números celulares (11 dígitos) + higienização
- ✅ CEP: Validação códigos postais (8 dígitos) + higienização
1. Adicione o nó "BR Data Utils" no seu workflow
2. Selecione a operação (validar CPF, CNPJ, etc.)
3. Insira o valor a ser processado
`json`
{
"operation": "validarCpf",
"original": "111.444.777-35",
"isValid": true,
"masked": "111.444.777-35",
"unmasked": "11144477735",
"error": null
}
`bashClone o repositório
git clone https://github.com/edumoreirajj/n8n-nodes-br-data-utils.git
cd n8n-nodes-br-data-utils
$3
`bash
Desenvolvimento
npm run build # Compila TypeScript
npm run watch # Compila em modo watch
npm run format # Formata código com Prettier
npm run dev # Build + testesTestes
npm test # Executa todos os testes
npm run test:watch # Testes em modo watch
npm run test:coverage # Testes com coberturaTestes específicos
npm test cpf # Apenas testes de CPF
npm test cnpj # Apenas testes de CNPJ
npm test cep # Apenas testes de CEP
npm test telefone # Apenas testes de telefone
npm test validators # Todos os validadores
`$3
`
n8n-nodes-br-data-utils/
├── nodes/BrDataUtils/
│ ├── validators/ # Validadores brasileiros
│ │ ├── cpf.ts # Validação de CPF
│ │ ├── cnpj.ts # Validação de CNPJ
│ │ ├── cep.ts # Validação de CEP
│ │ ├── telefone.ts # Validação de telefones
│ │ └── index.ts # Exports centralizados
│ ├── types.ts # TypeScript definitions
│ └── BrDataUtils.node.ts # Nó principal do n8n
├── tests/
│ ├── validators/ # Testes dos validadores
│ │ ├── cpf.test.ts
│ │ ├── cnpj.test.ts
│ │ ├── cep.test.ts
│ │ └── telefone.test.ts
│ └── setup.ts # Configuração global dos testes
├── .prettierrc # Configuração do Prettier
├── .editorconfig # Configuração do Editor
├── .gitattributes # Normalização Git
├── jest.config.js # Configuração do Jest
└── tsconfig.json # Configuração do TypeScript
`$3
Este projeto segue rigorosos padrões de código:
#### 🎨 Formatação automática com Prettier
`bash
npm run format # Formata todo o código automaticamente
`Configuração (
.prettierrc):
- Fim de linha: LF (Unix)
- Ponto e vírgula: Sempre presente
- Aspas simples: Preferidas
- Indentação: 2 espaços
- Largura máxima: 100 caracteres#### 📝 EditorConfig
O projeto usa
.editorconfig para consistência entre editores:
- Charset: UTF-8
- Fim de linha: LF
- Indentação: 2 espaços
- Remove espaços em branco no final das linhas#### 🔀 Git normalization
Configurado via
.gitattributes:
- Todos os arquivos de texto usam LF
- Arquivos binários preservados sem alteração$3
Os testes seguem as boas práticas:
- Jest como framework de testes
- TypeScript com tipagem completa
- Cobertura de código com thresholds mínimos
- Testes organizados por validador e cenários
- Casos de teste brasileiros específicos
Cada validador possui testes abrangentes cobrindo:
- ✅ Casos válidos: Dados brasileiros corretos com diferentes formatações
- ❌ Casos inválidos: Dados incorretos, caracteres inválidos, tamanhos errados
- 🔄 Edge cases: Formatações mistas, espaços, valores nulos
- 🎨 Formatação: Mascaramento e limpeza de dados
$3
1. Faça um fork do projeto
2. Crie uma branch para sua feature (
git checkout -b feature/nova-feature)
3. Execute formatação: npm run format
4. Execute os testes: npm test
5. Commit suas mudanças (git commit -am 'Adiciona nova feature')
6. Push para a branch (git push origin feature/nova-feature)
7. Abra um Pull Request$3
O projeto utiliza:
- Pre-commit hooks executam testes antes do commit
- Prettier para formatação automática consistente
- EditorConfig para padronização entre diferentes editores
- GitHub Actions para CI/CD automatizado
- Cobertura de testes mínima de 80%
- Normalização Git com LF em todos os arquivos texto
#### ⚡ Workflow de desenvolvimento recomendado
`bash
1. Faça suas alterações
2. Formate o código
npm run format3. Execute os testes
npm test4. Build do projeto
npm run build5. Ou use o comando combinado
npm run dev # Equivale a: build + test
``MIT License - veja LICENSE para detalhes.