📦 CNPJ Validator BR

Validador de CNPJ para Node.js com suporte a:

• ✅ CNPJ tradicional (numérico)
• ✅ Novo CNPJ alfanumérico (Brasil - 2026)
• ✅ Máscara automática
• ✅ Limpeza de entrada
• ✅ Validação com dígito verificador (módulo 11)

🚀 Instalação

npm install @thalys.mazzitelli.cotta/cnpj-validator-br

📌 Uso

const cnpj = require("@thalys.mazzitelli.cotta/cnpj-validator-br");

// Limpar (remove caracteres especiais)
cnpj.clean("12.345.678/0001-95");
// "12345678000195"

// Formatar (aplica máscara)
cnpj.format("12345678000195");
// "12.345.678/0001-95"

// Validar (retorna true ou false)
cnpj.validate("12.345.678/0001-95");
// true

🔢 Exemplo com CNPJ alfanumérico (2026)

cnpj.clean("12.ABC.345/01DE-35");
// "12ABC34501DE35"

cnpj.format("12ABC34501DE35");
// "12.ABC.345/01DE-35"

cnpj.validate("12.ABC.345/01DE-35");
// true ou false

🧠 Funcionalidades

• Limpeza de caracteres inválidos
• Formatação padrão: XX.XXX.XXX/XXXX-XX
• Validação com módulo 11
• Compatível com novo padrão alfanumérico (Brasil - 2026)
• Suporte a entrada parcial (ideal para inputs)

🏗️ Estrutura do Projeto

cnpj-validator-br/
├─ src/
│  ├─ clean.js
│  ├─ format.js
│  ├─ dv.js
│  ├─ validate.js
│  └─ index.js
├─ tests/
│  └─ cnpj.test.js
├─ package.json
├─ README.md
├─ .gitignore
└─ LICENSE

⚙️ Uso local (desenvolvimento)

node src/index.js

Ou no modo interativo:

node

const cnpj = require("./src");

cnpj.validate("12.345.678/0001-95");

🧪 Testes

Os testes estão localizados na pasta:

tests/

Sugestão de evolução:

• Jest
• Mocha

📚 Sobre o cálculo do DV

A validação do CNPJ é feita com base no algoritmo de módulo 11, utilizando:

• pesos específicos para cada posição
• cálculo do resto da divisão por 11

Regra:

• resto < 2 → DV = 0
• caso contrário → DV = 11 - resto

Para o novo CNPJ alfanumérico:

• caracteres são convertidos usando ASCII - 48

🚧 Roadmap (próximas melhorias)

• [ ] Suporte a ES Modules (import/export)
• [ ] Tipagem com TypeScript
• [ ] Validação de CPF
• [ ] Publicação de versão com testes automatizados

👨‍💻 Autor

Desenvolvido por Thalys Mazzitelli Cotta 🔗 https://github.com/Thalysinho

📄 Licença

Este projeto está sob a licença MIT.