validations-locale

Validação de valores de acordo com a localidade

✨ Agora com suporte ao novo CNPJ Alfanumérico! 🇧🇷

Instalação

npm install validations-locale --save

Utilização

Validação de CPF

import { IdentificationValidation } from "validations-locale";

const localeValidations = new IdentificationValidation( "pt-BR" );

// Valida CPF
const isValidCPF = localeValidations.isSSNValid( "34513872713" );
console.log(isValidCPF); // true

Validação de CNPJ (Numérico e Alfanumérico)

import { IdentificationValidation } from "validations-locale";

const localeValidations = new IdentificationValidation( "pt-BR" );

// Valida CNPJ numérico (formato atual)
const isValidCNPJ = localeValidations.isEINValid( "39621351000155" );
console.log(isValidCNPJ); // true

// Valida CNPJ alfanumérico (novo formato)
const isValidAlphanumeric = localeValidations.isEINValid( "1A2B3C4D567802" );
console.log(isValidAlphanumeric); // true

// Aceita CNPJ com máscara
const isValidWithMask = localeValidations.isEINValid( "1A.2B3.C4D/5678-02" );
console.log(isValidWithMask); // true

Recursos

✅ CNPJ Alfanumérico

Este pacote já está atualizado para validar o novo formato de CNPJ Alfanumérico da Receita Federal do Brasil, que entrará em vigor em julho de 2026. O novo formato permite:

• 8 primeiras posições alfanuméricas (letras maiúsculas e números)
• 4 posições seguintes alfanuméricas (ordem do estabelecimento)
• 2 dígitos verificadores numéricos
• Validação usando tabela ASCII com cálculo por módulo 11
• Compatibilidade total com CNPJs numéricos existentes

Formato: A1B2C3D4/1A2B-99 ou sem máscara: A1B2C3D41A2B99

Locales

• pt-BR

Métodos

isSSNValid( value:String ) : boolean

Verifica se é um CPF válido

• Aceita CPF com ou sem máscara
• Exemplo: "345.138.727-13" ou "34513872713"

isEINValid( value:String ) : boolean

Verifica se é um CNPJ válido (numérico ou alfanumérico)

• Aceita CNPJ com ou sem máscara
• Suporta formato numérico: "39.621.351/0001-55" ou "39621351000155"
• Suporta formato alfanumérico: "1A.2B3.C4D/5678-02" ou "1A2B3C4D567802"
• Aceita letras maiúsculas e minúsculas (converte automaticamente)

Licença

MIT