@thalys.mazzitelli.cotta/cnpj-validator-br 1.0.0

package/LICENSE

@@ -0,0 +1,6 @@
+MIT License
+
+Copyright (c) 2026 Thalys Mazzitelli Cotta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files...

package/README.md

@@ -0,0 +1,151 @@
+# 📦 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
+
+> (Disponível após publicação no npm)
+
+```bash
+npm install @thalys/cnpj-validator-br
+```
+
+---
+
+## 📌 Uso
+
+```js
+const cnpj = require("@thalys/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)
+
+```js
+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
+```
+
+---
+
+## ⚙️ Como rodar localmente
+
+```bash
+node src/index.js
+```
+
+Ou usar no modo interativo:
+
+```bash
+node
+```
+
+```js
+const cnpj = require("./src");
+
+cnpj.validate("12.345.678/0001-95");
+```
+
+---
+
+## 🧪 Testes
+
+Os testes estão localizados na pasta:
+
+```
+tests/
+```
+
+Você pode executar manualmente via Node ou integrar futuramente com frameworks como:
+
+* 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**
+
+---
+
+## 👨‍💻 Autor
+
+Desenvolvido por **Thalys Mazzitelli Cotta**
+🔗 https://github.com/Thalysinho
+
+---
+
+## 📄 Licença
+
+Este projeto está sob a licença MIT.
+
+---

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@thalys.mazzitelli.cotta/cnpj-validator-br",
+  "version": "1.0.0",
+  "author": {
+  "name": "Thalys Mazzitelli Cotta",
+  "url": "https://github.com/Thalysinho"
+  },
+  "main": "src/index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": ["cnpj", "validator", "brasil"],
+  "license": "ISC",
+  "description": ""
+}

package/src/clean.js

@@ -0,0 +1,14 @@
+// O clean.js: pega o valor que a pessoa digitou e devolve uma versão “limpa”, pronta para validar e formatar.
+// entrada suja -> saída limpa
+/*
+1- aceitar qualquer entrada
+2- transformar em string
+3- deixar tudo em maiúsculo
+4- remover tudo que não for letra ou número
+*/
+function clean(value) {
+    if (value === null || value === undefined) return '';
+    
+    return String(value).toUpperCase().replace(/[^0-9A-Z]/g, '');
+}
+module.exports = clean;

package/src/dv.js

@@ -0,0 +1,40 @@
+// O dv.js é o coração da validação.
+// -transformar cada caractere em valor numérico para o cálculo ( ASCII - 48 )
+// -calcular os dígitos verificadores usando módulo 11
+// RESUMO: pegar os caracteres e tranforma-los em números ( A -> 65 (tabela ASCII) - 48 = 17 ) e depois calcular os dígitos verificadores usando módulo 11.
+/* DV = dígito verificador. (2 últimos dígitos do CNPJ)
+    os 12 primeiros caracteres formam a base
+    os 2 últimos são os DVs
+*/
+
+function charToValue(char) {
+  return char.charCodeAt(0) - 48;
+}
+
+function calculateDV(base, weights) {
+  let sum = 0;
+
+  for (let i = 0; i < base.length; i++) {
+    sum += charToValue(base[i]) * weights[i];
+  }
+
+  const remainder = sum % 11;
+
+  return remainder < 2 ? 0 : 11 - remainder;
+}
+
+function calculateCNPJDVs(base12) {
+  const firstWeights = [5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2];
+  const secondWeights = [6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2];
+
+  const firstDV = calculateDV(base12, firstWeights);
+  const secondDV = calculateDV(base12 + firstDV, secondWeights);
+
+  return `${firstDV}${secondDV}`;
+}
+
+module.exports = {
+  charToValue,
+  calculateDV,
+  calculateCNPJDVs,
+};

package/src/format.js

@@ -0,0 +1,29 @@
+// O format.js vai pegar o valor já digitado e devolver com a máscara visual do CNPJ.
+// transforma isso: 12345678000195 em isso: 12.345.678/0001-95 // 12ABC34501DE35 em 12.ABC.345/01DE-35
+/*
+estrutura do CNPJ: XX.XXX.XXX/XXXX-XX
+Então os separadores entram nessas posições:
+depois do 2º caractere -> .
+depois do 5º caractere -> .
+depois do 8º caractere -> /
+depois do 12º caractere -> -
+*/
+
+const clean = require("./clean");
+
+function format(value) {
+  const cleanedValue = clean(value).slice(0, 14);
+  let formattedValue = "";
+
+  for (let i = 0; i < cleanedValue.length; i++) {
+    if (i === 2 || i === 5) formattedValue += ".";
+    if (i === 8) formattedValue += "/";
+    if (i === 12) formattedValue += "-";
+
+    formattedValue += cleanedValue[i];
+  }
+
+  return formattedValue;
+}
+
+module.exports = format;

package/src/index.js

@@ -0,0 +1,9 @@
+const clean = require("./clean");
+const format = require("./format");
+const validate = require("./validate");
+
+module.exports = {
+  clean,
+  format,
+  validate,
+};

package/src/validate.js

@@ -0,0 +1,32 @@
+/*
+    O validate.js compara o os DVs calculados com os DVs informados
+
+ Ele precisa:
+    limpar o valor
+    verificar se tem 14 caracteres
+    verificar se o formato básico é válido
+    separar base e DV informado
+    calcular o DV correto
+    comparar os dois
+    e retorna true ou false  
+*/
+
+const clean = require("./clean");
+const { calculateCNPJDVs } = require("./dv");
+
+function validate(value) {
+  const cleanedValue = clean(value);
+  const cnpjPattern = /^[A-Z0-9]{12}[0-9]{2}$/;
+
+  if (cleanedValue.length !== 14) return false;
+  if (!cnpjPattern.test(cleanedValue)) return false;
+  if (/^\d{14}$/.test(cleanedValue) && /^(\d)\1{13}$/.test(cleanedValue)) return false
+
+  const base12 = cleanedValue.slice(0, 12);
+  const informedDVs = cleanedValue.slice(12);
+  const calculatedDVs = calculateCNPJDVs(base12);
+
+  return informedDVs === calculatedDVs;
+}
+
+module.exports = validate;

package/tests/cnpj.test.js

@@ -0,0 +1,5 @@
+const cnpj = require("../src");
+
+console.log('Cleaned CNPJ: ' + cnpj.clean("12.ABC.345/01DE-35"));
+console.log('Formatted CNPJ: ' + cnpj.format("12ABC34501DE35"));
+console.log('Valid CNPJ: ' + cnpj.validate("12.345.678/0001-95"));