docsbr
Biblioteca TypeScript, sin dependencias, para validar, formatear y generar documentos brasileños como CPF y CNPJ.
Acerca del Proyecto
docsbr es una biblioteca TypeScript-first para la validación, el formateo y la generación de documentos brasileños. Trabajar con CPF y CNPJ exige implementar manualmente el algoritmo Mod-11, las máscaras de formato y la lógica de generación; la biblioteca reúne todas estas operaciones en una API mínima, predecible y coherente entre los módulos.
El paquete es ligero, no tiene dependencias externas y tiene soporte nativo para ESM, funcionando en Node.js 18 o superior, en bundlers modernos como Vite y esbuild y en el navegador. Está publicado en npm, con pruebas escritas en Vitest para todos los módulos.
Características principales:
- Validación de CPF y CNPJ con el algoritmo Mod-11, fiel a las especificaciones de la Receita Federal de Brasil
- Formateo y eliminación de máscara, aceptando valores con o sin puntuación
- Generación aleatoria de documentos válidos, con o sin formato
- Importación por namespace o por subruta, con soporte para tree-shaking
- Tipado completo en TypeScript y ninguna dependencia externa
Una biblioteca pensada para resolver de forma sencilla un problema común en el desarrollo de sistemas brasileños.