docs-br-js

Biblioteca de validação e extração de informação de documentos oficiais brasileiros.

Documentos suportados:

• CNPJ - validação com caracteres alfanuméricos (2026)
• CPF
• Inscrição estadual
• CNH
• PIS/PASEP
• RG
• RENAVAM
• Título de eleitor
• Certidões

Instalação

1$ npm install @fsavio/docs-br

Como usar

CNPJ

Validação

1import { cnpj } from '@fsavio/docs-br'
2
3// CNPJ válido
4const valid = cnpj.validate('48217216000130');
5console.log(valid); // { sucesso: true, dados: "48217216000130" }
6
7// CNPJ válido com caracteres alfanuméricos
8const alfanumValid = cnpj.validate('UU97L8QM000130');
9console.log(alfanumValid); // { sucesso: true, erro: "UU97L8QM000130" }
10
11// CNPJ com tamanho diferentes de 14
12const invalidLength = cnpj.validate('123');
13console.log(invalidLength); // { sucesso: false, erro: "invalid-length" }
14
15// CNPJ com caracteres inválidos
16const invalidChars = cnpj.validate('??????????????');
17console.log(invalidChars); // { sucesso: false, erro: "invalid-chars" }
18
19// CNPJ com dígitos verificadores inválidos
20const invalidCheckDigits = cnpj.validate('48217216000199');
21console.log(invalidCheckDigits); // { sucesso: false, erro: "invalid-check-digits" }
22
23// CNPJ alfanumérico com dígitos verificadores inválidos
24const invalidCheckDigitsAlfanum = cnpj.validate('UU97L8QM000199');
25console.log(invalidCheckDigitsAlfanum); // { sucesso: false, erro: "invalid-check-digits" }