Commit inicial do projeto
br-docs
validação completa de documentos brasileiros
npm install br-docsFuncionalidades
Tudo que você precisa para trabalhar com documentos brasileiros com segurança e performance.
Validação Completa
Valide CPF, CNPJ, CEP, CNH, telefone, e-mail, PIX, boletos e códigos de barras com precisão e um único clique.
Altíssima Performance
Desempenho otimizado para aplicações de alta demanda, garantindo respostas rápidas e eficientes.
Pull request preparado para revisão
Merge realizado e deploy automático
Open-Source
Comunidade ativa, GitHub aberto e contribuições guiadas pela transparência e segurança.
Zero Dependências
Pacote leve que roda sem nada além do Node.js, ideal para embarcar em qualquer projeto.
Por que usar o br-docs?
O br-docs elimina códigos duplicados, regras frágeis e regex perdido no projeto — entregando validações precisas, padronizadas e testadas para CNPJ, CPF, CEP, CNH, boleto, telefone e muito mais.
before.ts
br-docs.ts
1function validateCPF(value: string) {
2 const clean = value.replace(/\\D/g, "")
3 if (clean.length !== 11 || /(\\d)\\1{10}/.test(clean)) return false
4
5 const calcDigit = (slice: number) => {
6 let sum = 0
7 for (let i = 0; i < slice; i++) {
8 sum += Number(clean[i]) * (slice + 1 - i)
9 }
10 const rest = (sum * 10) % 11
11 return rest === Number(clean[slice])
12 }
13
14 return calcDigit(9) && calcDigit(10)
15}
16
17const normalisePhone = (phone: string) => {
18 const clean = phone.replace(/\\D/g, "")
19 if (clean.length !== 11) throw new Error("Telefone inválido")
20 return "(" + clean.slice(0, 2) + ") " + clean.slice(2, 7) + "-" + clean.slice(7)
21}1import { Cpf, Cnpj, Pix } from "br-docs";
2
3Cpf.isValid("123.456.789-09"); // true
4
5Cnpj.isValid("11.222.333/0001-81"); // true
6
7Cnh.isValid("12345678901"); // true
8
9Pix.isValid("123.456.789-09"); // true
10Pix.isValid("test@example.com"); // trueInstalação Rápida
npm install br-docsLightweight
~20KB minificado. Sem impacto na performance da sua app.
Instantâneo
Zero configuração. Comece a usar imediatamente.
Seguro
Sem requisições externas. Tudo roda localmente.
O que Developers Dizem
Feedback de profissionais que usam br-docs
João Silva
Desenvolvedor Full Stack
"Simples, rápido e funciona perfeitamente! Economizei horas de desenvolvimento."
Maria Santos
Arquiteta de Software
"Zero dependências externas? Perfeito! Exatamente o que precisávamos em produção."
Pedro Oliveira
Tech Lead
"Uso em todos os meus projetos. A documentação é clara!"