docsbr

A docsbr é uma biblioteca TypeScript-first para validação, formatação e geração de documentos brasileiros. Lidar com CPF e CNPJ exige implementar manualmente o algoritmo Mod-11, as máscaras de formatação e a lógica de geração; a biblioteca reúne todas essas operações em uma API mínima, previsível e consistente entre os módulos.

O pacote é leve, não tem dependências externas e tem suporte nativo a ESM, funcionando no Node.js 18 ou superior, em bundlers modernos como Vite e esbuild e no navegador. Está publicado no npm, com testes escritos em Vitest para todos os módulos.

Principais características:

• Validação de CPF e CNPJ pelo algoritmo Mod-11, fiel às especificações da Receita Federal
• Formatação e remoção de máscara, aceitando valores com ou sem pontuação
• Geração de documentos válidos aleatórios, com ou sem formatação
• Importação por namespace ou por subcaminho, com suporte a tree-shaking
• Tipagem completa em TypeScript e nenhuma dependência externa

Uma biblioteca pensada para resolver de forma simples um problema comum no desenvolvimento de sistemas brasileiros.