@br-validators/core
v1.10.0-data.41
Published
The Brazilian document validation library for TypeScript — CPF, CNPJ (alphanumeric), NF-e, PIX, boleto, IE (27 UFs), offline IBGE/ANP/NCM/CST/LC116 reference data, and 15+ more. Zero deps, fully typed, never throws.
Maintainers
Keywords
Readme
@br-validators/core
The Brazilian document validation library for TypeScript.
Validate, format, and generate CPF, CNPJ (including the new alphanumeric format), NF-e, BR Code PIX, boleto, IE (all 27 states), EAN barcodes, CNIS/NIT, ANP fuel prices, and 20+ more — zero dependencies, fully typed, never throws.
npm install @br-validators/coreTry it now → doc-raiz-playground.vercel.app
CLI → npm install -g @br-validators/cli
⚠️ The unscoped
br-validatorson npm is a different package. Use@br-validators/core.
Why this library
Every Brazilian SaaS eventually reinvents CPF validation — usually wrong.@br-validators/core implements each algorithm from its official primary source
(Receita Federal, Bacen, CONTRAN, TSE, SEFAZ, FEBRABAN, Anatel) so you don't have to.
- ✅ CNPJ alfanumérico — new RFB format (effective July 2026), ready now
- ✅ 21+ document types — CPF, CNPJ, CEP, NF-e chave, processo judicial CNJ, BR Code PIX, boleto (cobrança + arrecadação), CNH, RENAVAM, placa, PIS/PASEP, CNIS/NIT, EAN-8/EAN-13, PIX key, cartão de crédito, IE (27 UFs), IE produtor rural, título de eleitor, telefone, + platform APIs above
- ✅ Zero runtime dependencies — pure TypeScript logic, no HTTP calls
- ✅ Never throws — every function returns
{ ok: true, value } | { ok: false, message, code } - ✅ Tree-shakeable — subpath imports per document type
- ✅ Reference data — IBGE (municipalities + NF-e
cMunFG), Bacen banks, DDD lookup, national holidays, CNAE, CFOP, CST, LC 116, NCM, IBPT tax burden, Simples Nacional, CBO, natureza jurídica, NBS, CEST, eSocial categorias, CNPJ motivos, moedas, PTAX cotações, países Bacen, NF-e cUF, IRPF / INSS tables, SELIC meta, ISS municipal (top 500 PIB), Incoterms, portos, aeroportos, ANP fuel prices (LPC) — embedded offline with daily freshness (DATA-FRESHNESS.md; ANP weekly) - ✅ ESM only, Node ≥ 18, works in browser, Bun, Deno
Quick start
import { validateCpf, formatCpf } from '@br-validators/core';
validateCpf('123.456.789-09');
// { ok: true, value: '12345678909' }
formatCpf('12345678909');
// { ok: true, formatted: '123.456.789-09' }
validateCpf('111.111.111-11');
// { ok: false, message: 'CPF with all identical digits is invalid', code: 'KNOWN_INVALID_PATTERN' }CNPJ — numeric and alphanumeric (new RFB format)
import { validateCnpj, formatCnpj } from '@br-validators/core/cnpj';
// Numeric (current format)
validateCnpj('11.222.333/0001-81');
// { ok: true, value: '11222333000181', format: 'numeric' }
// Alphanumeric (new format — effective July 2026)
validateCnpj('12ABC34501DE35');
// { ok: true, value: '12ABC34501DE35', format: 'alphanumeric' }
formatCnpj('12ABC34501DE35');
// { ok: true, formatted: '12.ABC.345/01DE-35' }Auto-detect document type
import { detect } from '@br-validators/core';
detect('123.456.789-09');
// { type: 'cpf', ok: true, value: '12345678909' }
detect('ABC1D23');
// { type: 'placa', ok: true, format: 'mercosul' }
detect('110042490114', { uf: 'SP' });
// { type: 'inscricao-estadual', ok: true }Generate valid documents for tests
import { generate } from '@br-validators/core';
generate('cpf', { seed: 42 }); // reproducible, always valid
generate('cnpj', { format: 'alphanumeric', masked: true });
generate('placa', { format: 'mercosul' });
generate('renavam');
generate('cnh');
generate('inscricao-estadual', { uf: 'SP', seed: 42 });
generate('titulo-eleitor', { uf: 'SC', seed: 42 });
generate('cartao-credito', { brand: 'visa', seed: 42 });
generate('pix', { seed: 42 }); // EVP UUID — Bacen DICT
generate('nfe-chave', { seed: 42 }); // MOC §2.2.6 modulo-11 DV
generate('brcode', { seed: 42 }); // static PIX EMV + CRC16
generate('boleto', { masked: true }); // FEBRABAN cobrança Situação 1
generate('boleto-arrecadacao'); // FEBRABAN Layout v7
generate('inscricao-estadual-produtor-rural', { masked: true }); // SP SINTEGRA Bloco II
generate()is for test fixtures and seed data only — never use in production.
Alphanumeric CPF:generate('cpf', { format: 'alphanumeric' })throwsCPF_ALPHA_SPEC_PENDINGuntil RFB publishes the official algorithm (OFFICIAL-SOURCES.md).
ETL / data cleanup
import { sanitize } from '@br-validators/core';
sanitize(' 123.456.789-09 ', 'cpf');
// { ok: true, value: '12345678909', fixes: ['trimmed', 'removed_non_digits'] }
sanitize('110.042.490.114', 'inscricao-estadual', { uf: 'SP' });
// { ok: true, value: '110042490114', fixes: [...] }NF-e chave de acesso (44 digits)
import { validateNfeChave, parseNfeChave } from '@br-validators/core/nfe-chave';
const result = validateNfeChave('52060433009911002506550120000007800267301615');
// { ok: true, parsed: { cUF: '52', cnpj: '33009911002506', mod: '55', ... }, uf: 'GO' }BR Code (PIX QR payload)
import {
buildStaticPixBrCode,
parseBrCode,
validateBrCode,
} from '@br-validators/core/brcode';
// Permanent static QR (no amount — payer sets value at payment time)
const payload = buildStaticPixBrCode({
pixKey: '[email protected]',
merchantName: 'Fulano de Tal',
merchantCity: 'BRASILIA',
});
validateBrCode(payload).ok; // true
// Fixed-value static QR
buildStaticPixBrCode({
pixKey: '[email protected]',
merchantName: 'Fulano de Tal',
merchantCity: 'BRASILIA',
amount: '10.50',
});
parseBrCode(payload);
// { ok: true, pixKey, pixKeyType, merchantName, merchantCity, amount, txid }Playground: doc-raiz-playground.vercel.app/pix renders the QR image from buildStaticPixBrCode output. Official sources: Bacen Manual BR Code · Manual de Padrões PIX.
Boleto — cobrança + arrecadação
import { validateBoleto, validateArrecadacao } from '@br-validators/core/boleto';
validateBoleto('03399.02579 08991.834006 71742.301014 6 14500000099668');
// cobrança Situação 1/2 — FEBRABAN FB-0061/2021
validateArrecadacao('846300000003812345678906123456789015234567890129');
// arrecadação 48-digit — FEBRABAN Layout v7Platform APIs — mask, compare, batch, diff
import { mask, compare, batch, diff } from '@br-validators/core';
mask('12345678909', 'cpf');
// { ok: true, formatted: '123.456.789-09' }
compare('123.456.789-09', '12345678909', 'cpf');
// { equal: true }
batch(['12345678909', 'invalid'], 'cpf');
// { valid: [...], invalid: [...], summary: { total: 2, valid: 1, invalid: 1 } }
diff('12345678909', '12345678901', 'cpf');
// { changed: true, fields: [{ field: 'dv', a: '09', b: '01' }] }Fiscal code validators (NCM, CFOP, CST)
import { validateNcm } from '@br-validators/core/ncm';
import { validateCfop } from '@br-validators/core/cfop';
import { validateCst } from '@br-validators/core/cst';
import { lookupNcmPorCodigo } from '@br-validators/core/ncm';
validateNcm('01012100'); // { ok: true, value: '01012100', row: { ... } }
validateCfop('1102'); // dotted or plain CONFAZ codes
validateCst('00', { tax: 'icms' });
lookupNcmPorCodigo('01012100'); // LookupResult — ok / not-found / invalid-formatPer-type rules and official sources: docs/OFFICIAL-SOURCES.md · API contract: docs/LIBRARY-API.md
Backend / form integration:
format*andmask()validate first — they never left-pad partial input ("0"will not become000.000.000-00). Do not combinepadStartwith display formatting inonChange; pad to full width only at submit if your API requires it. Details: LIBRARY-API.md — display vs backend normalization.
Form handler (React / Next.js)
'use client';
import { validateCnpj, formatCnpj } from '@br-validators/core/cnpj';
import { useState } from 'react';
export function CnpjField() {
const [input, setInput] = useState('');
const result = input ? validateCnpj(input) : null;
const formatted = result?.ok ? formatCnpj(result.value) : null;
return (
<div>
<input value={input} onChange={e => setInput(e.target.value)} />
{formatted?.ok && <p>✅ {formatted.formatted}</p>}
{result && !result.ok && <p>❌ {result.message}</p>}
</div>
);
}Shell / CI
br-validators cnpj validate "$CNPJ" --quiet || exit 1
br-validators ie validate "$IE" --uf SP --json
br-validators detect '123.456.789-09' --json
br-validators generate cpf --seed 42 --masked
br-validators generate pix --seed 42
br-validators generate nfe-chave --seed 42
br-validators generate brcode --seed 42
br-validators generate boleto --masked --seed 42
br-validators generate boleto-arrecadacao --seed 42
br-validators generate inscricao-estadual-produtor-rural --masked --seed 42All supported types
| Document | Subpath import | CLI | Playground |
|---|---|---|---|
| CPF | @br-validators/core/cpf | br-validators cpf … | /cpf |
| CNPJ (numeric + alphanumeric) | @br-validators/core/cnpj | br-validators cnpj … | /cnpj |
| CEP | @br-validators/core/cep | br-validators cep … | /cep (+ getCepFaixaInfo prefix lookup) |
| Telefone | @br-validators/core/telefone | br-validators telefone … | /telefone |
| CNH | @br-validators/core/cnh | br-validators cnh … | /cnh |
| RENAVAM | @br-validators/core/renavam | br-validators renavam … | /renavam |
| Título de Eleitor | @br-validators/core/titulo-eleitor | br-validators titulo-eleitor … | /titulo-eleitor |
| Processo judicial CNJ | @br-validators/core/processo-judicial | br-validators processo-judicial … | /processo-judicial |
| RG (27 UFs — identity card) | @br-validators/core/rg | br-validators rg … --uf SP | /rg |
| Placa (Mercosul + legada) | @br-validators/core/placa | br-validators placa … | /placa |
| PIS / PASEP / NIS | @br-validators/core/pis-pasep | br-validators pis-pasep … | /pis |
| CNIS / NIT (worker ID) | @br-validators/core/cnis | br-validators cnis … | /cnis |
| EAN-8 / EAN-13 (barcode) | @br-validators/core/ean | br-validators ean … | /ean |
| PIX key | @br-validators/core/pix | br-validators pix … | /pix |
| BR Code (PIX QR payload + builder) | @br-validators/core/brcode | br-validators brcode … | /brcode |
| Boleto cobrança (Situação 1 + 2) | @br-validators/core/boleto | br-validators boleto … | /boleto |
| Boleto arrecadação (48/44) | @br-validators/core/boleto | br-validators boleto … | /boleto |
| NF-e / NFC-e chave (44 digits) | @br-validators/core/nfe-chave | br-validators nfe-chave … | /nfe-chave |
| Cartão de crédito (Luhn) | @br-validators/core/cartao-credito | br-validators cartao … | /cartao-credito |
| Inscrição Estadual (27 UFs) | @br-validators/core/inscricao-estadual | br-validators ie … --uf SP | /ie |
| IE Produtor Rural | @br-validators/core/inscricao-estadual-produtor-rural | br-validators ie … (auto P) | /ie |
| detect() | @br-validators/core/detect | br-validators detect … | /detect |
| sanitize() | @br-validators/core/sanitize | br-validators sanitize … | /sanitize |
| mask() | @br-validators/core/mask | br-validators mask … | via per-type format |
| compare() | @br-validators/core/compare | br-validators compare … | /compare |
| batch() | @br-validators/core/batch | br-validators batch … | /batch |
| diff() | @br-validators/core/diff | br-validators diff … | /diff |
| generate() | @br-validators/core/generate | br-validators generate … | /generate |
| buildStaticPixBrCode() | @br-validators/core/brcode | — | /pix (QR panel) |
Reference data (offline lookup)
Embedded JSON from official .gov.br sources — no runtime HTTP. Each module exports *_DATA_VERSION with capture date, row counts, and source URLs. Aggregated via @br-validators/core/data-catalog.
| Dataset | Subpath | CLI | Playground | Key APIs | Official source |
|---------|---------|-----|------------|----------|-----------------|
| IBGE states + municipalities + NF-e cMunFG | @br-validators/core/ibge | ibge lookup · list | /data/ibge | getEstados, getMunicipios, getMunicipioPorCodigo, toCmunFg, parseCmunFg | IBGE localidades API |
| Bacen STR banks (COMPE / ISPB) | @br-validators/core/bancos | bancos lookup · list | /data/bancos | getBancos, getBancoPorCodigo, getBancoPorIspb | Bacen Participantes STR |
| ANAC public aerodromos | @br-validators/core/aeroportos | aeroportos lookup | /data/logistics | getAeroportos, getAeroportoPorIata, getAeroportoPorIcao, getAeroportosPorMunicipio | ANAC aeródromos públicos CSV |
| ANTAQ port installations | @br-validators/core/portos | portos lookup | /data/logistics | getPortoPorCodigo, searchPortos, getPortosPorMunicipio | ANTAQ instalações portuárias zip |
| ANP fuel prices (LPC) | @br-validators/core/anp-combustiveis | — | /data/logistics | getAnpPrecosMedios, getAnpPrecosMediosPorIbge, getAnpSemanaAtual | ANP levantamento LPC |
| TSE ↔ IBGE municipality codes | @br-validators/core/tse-municipios | tse-municipios lookup | /data/ibge (cross-ref) | getMapeamentoTseIbge, getMunicipioIbgePorCodigoTse, getCodigosTsePorMunicipio | TSE municipio_tse_ibge.zip |
| DDD geographic lookup | @br-validators/core/telefone | ddd lookup | — | getDddInfo (extends telefone validator) | Anatel DDD panel |
| National holidays | @br-validators/core/feriados | feriados list --year | /data/calendar | isFeriadoNacional, getFeriadosNacionais, getProximoDiaUtil | Lei 662/1949 + annual Portaria MGI |
| CNAE 2.3 subclasses | @br-validators/core/cnaes | cnae lookup · search | /data/fiscal | getCnaePorCodigo, searchCnaes | IBGE CNAE API v2 |
| CFOP fiscal operations | @br-validators/core/cfop | cfop lookup · search | /data/fiscal | getCfopPorCodigo, searchCfop | CONFAZ CFOP SINIEF |
| CST (ICMS, IPI, PIS, COFINS) | @br-validators/core/cst | — | /data/fiscal | getCstIcmsPorCodigo, getCstIpiPorCodigo, searchCstIcms | RFB SPED CST tables |
| LC 116 ISS services | @br-validators/core/lc116 | — | /data/fiscal | getLc116PorCodigo, searchLc116 | LC 116/2003 Planalto |
| eSocial (categorias + rubricas) | @br-validators/core/esocial | — | /data/payroll | getEsocialCategoriaPorCodigo, getEsocialRubricaPorCodigo, searchEsocialRubricas | eSocial S-1.3 Tabelas |
| NCM Mercosur nomenclature | @br-validators/core/ncm | ncm lookup · search | /data/fiscal | getNcmPorCodigo, searchNcm | Siscomex NCM JSON |
| IBPT approximate NCM tax burden | @br-validators/core/ibpt | — | /data/fiscal | getIbptCargaPorNcmUf, computeIbptCargaTotal | IBPT Lei 12.741/2012 |
| Simples Nacional annex tables | @br-validators/core/simples-nacional | — | /data/fiscal | getSimplesAnexo, getSimplesFaixa, computeSimplesAliquotaEfetiva | LC 123/2006 Planalto |
| CNPJ motivos situação cadastral | @br-validators/core/cnpj-motivos | — | /data/fiscal | getMotivosSituacaoCadastral, getMotivoSituacaoCadastralPorCodigo | RFB Motivos.zip |
| Natureza jurídica (CNPJ) | @br-validators/core/natureza-juridica | natureza-juridica lookup | /data/fiscal | getNaturezaJuridicaPorCodigo | RFB Naturezas.zip |
| NBS (NFSe Nacional) | @br-validators/core/nbs | nbs lookup | /data/fiscal | getNbsPorCodigo, searchNbs | NFSe Anexo B NBS2 xlsx |
| CEST (substituição tributária) | @br-validators/core/cest | cest lookup | /data/fiscal | getCestPorCodigo, getCestPorNcm, searchCest | CONFAZ ICMS 142/2018 |
| ISO 4217 + Bacen PTAX moedas | @br-validators/core/moedas | moedas lookup | /data/trade | getMoedaPorCodigo, searchMoedas | Bacen PTAX Moedas API |
| Bacen PTAX Fechamento | @br-validators/core/ptax | ptax lookup · ptax historico | /data/trade | getPtaxCotacao, getPtaxHistorico, getPtaxUltimoDiaUtil (+ dataReferencia, isStale) | Bacen Olinda PTAX API |
| NF-e Bacen country codes | @br-validators/core/paises-bacen | paises-bacen lookup | /data/trade | getPaisPorCodigoBacen, getPaisesBacen | NF-e country table |
| NF-e cUF (IBGE state codes) | @br-validators/core/nfe-cuf | nfe-cuf lookup | /data/fiscal | getCufPorCodigo, lookupCufPorCodigo | NF-e cUF table |
| IRPF progressive brackets | @br-validators/core/irpf | irpf tabela · irpf calc | /data/payroll | getIrpfTabelaProgressiva, calcularIrpfMensal | RFB IRPF tables |
| INSS contribution brackets | @br-validators/core/inss | inss tabela · inss calc | /data/payroll | getInssTabelaContribuicao, calcularInssMensal | INSS contribution rates |
| Bacen SELIC meta | @br-validators/core/selic | selic | /data/finance | getSelicMeta, getSelicMetaPorData | Bacen SGS série 432 |
| ISS municipal rates (top 500 PIB + MUNIC/IBGE fallback) | @br-validators/core/iss-municipal | iss-municipal lookup · list · search [--uf] | /data/fiscal | lookupIssMunicipalPorIbge (500 → munic-ibge → LC 116), getIssMunicipalPorIbge, getAllIssMunicipal — check fonte + warning | IBGE SIDRA PIB 5938 · MUNIC 2024 |
| ICC Incoterms 2020 | @br-validators/core/incoterms | incoterms lookup | /data/trade | getIncotermPorCodigo, getIncoterms | ICC Incoterms rules |
| CBO 2002 occupations | @br-validators/core/cbo | cbo lookup · search | /data/fiscal | getCboPorCodigo, searchCbo | MTE CBO downloads |
| CEP prefix lookup | @br-validators/core/cep | cep faixa | — | getCepFaixaInfo, getCepFaixas | IBGE CNEFE 2022 |
| Data transparency catalog | @br-validators/core/data-catalog | — | /data/catalog | getDataCatalog, getDatasetMetadata | Aggregates all metadata.json entries |
PTAX embed: last 90 business days (
janelaDiasUteis: 90) — not live Bacen. Every cotacao includesdataReferenciaandisStale. UsegetPtaxHistorico(moeda, { desde, ate })for contract-period FX variation. See DATA-FRESHNESS.md.
getAll*(): each lookup row above has a matchinggetAll*()export — see Listing reference data below.
import { getMunicipioPorCodigo } from '@br-validators/core/ibge';
import { getBancoPorCodigo } from '@br-validators/core/bancos';
import { getDddInfo } from '@br-validators/core/telefone';
import { isFeriadoNacional } from '@br-validators/core/feriados';
import { getCnaePorCodigo } from '@br-validators/core/cnaes';
import { getCfopPorCodigo } from '@br-validators/core/cfop';
import { getCstIcmsPorCodigo } from '@br-validators/core/cst';
import { getLc116PorCodigo } from '@br-validators/core/lc116';
import { getNcmPorCodigo } from '@br-validators/core/ncm';
import { getCboPorCodigo } from '@br-validators/core/cbo';
import { getNaturezaJuridicaPorCodigo } from '@br-validators/core/natureza-juridica';
import { getNbsPorCodigo } from '@br-validators/core/nbs';
import { getCestPorCodigo } from '@br-validators/core/cest';
import { getMoedaPorCodigo } from '@br-validators/core/moedas';
import { getPtaxUltimoDiaUtil, getPtaxHistorico } from '@br-validators/core/ptax';
import { getPaisPorCodigoBacen } from '@br-validators/core/paises-bacen';
import { getIncotermPorCodigo } from '@br-validators/core/incoterms';
import { getAeroportoPorIata } from '@br-validators/core/aeroportos';
import { getPortoPorCodigo } from '@br-validators/core/portos';
import { getAnpPrecosMedios } from '@br-validators/core/anp-combustiveis';
import { getSelicMeta } from '@br-validators/core/selic';
import { getIrpfTabelaProgressiva } from '@br-validators/core/irpf';
import { getInssTabelaContribuicao } from '@br-validators/core/inss';
import { getCufPorCodigo } from '@br-validators/core/nfe-cuf';
import { lookupIssMunicipalPorIbge } from '@br-validators/core/iss-municipal';
import { getDataCatalog } from '@br-validators/core/data-catalog';
getMunicipioPorCodigo(3550308)?.nome; // São Paulo
getBancoPorCodigo('001')?.nome; // Banco do Brasil
getDddInfo('11')?.uf; // SP
isFeriadoNacional('2026-01-01'); // true — Confraternização Universal
getCnaePorCodigo('6201501'); // custom software development
getCfopPorCodigo('1.102'); // accepts CONFAZ dotted format
getNcmPorCodigo('01012100'); // purebred horses (8-digit leaf)
getCboPorCodigo('212405'); // systems development analyst
getNaturezaJuridicaPorCodigo('2062'); // Sociedade Empresária Limitada
getNbsPorCodigo('1.1502.50.00'); // TI systems integration (NFSe)
getCestPorCodigo('0302100'); // returnable beer bottle (ST)
getMoedaPorCodigo('BRL')?.nome; // Real Brasileiro
const ptax = getPtaxUltimoDiaUtil('USD');
ptax.dataReferencia; // always expose to callers
ptax.isStale; // true when embed > 1 business day old
ptax.warning; // present when stale
getPtaxHistorico('USD', { desde: '2026-06-01', ate: '2026-06-26' });
// each row: dataReferencia, isStale, warning
getPaisPorCodigoBacen('1058')?.nome; // Brasil (NF-e cPais)
getIncotermPorCodigo('FOB')?.nome; // Free On Board
getAeroportoPorIata('GRU')?.nome; // Guarulhos — SP
getPortoPorCodigo('BRSSZ')?.nome; // Santos organized port
getAnpPrecosMedios({ uf: 'SP', municipio: 'São Paulo', produto: 'GASOLINE_REGULAR' })?.precoMedio;
getSelicMeta()?.valor; // latest Bacen SELIC meta (% a.a.)
getIrpfTabelaProgressiva(2026); // progressive monthly brackets
getInssTabelaContribuicao(2026); // INSS contribution table
getCufPorCodigo('35')?.uf; // SP (NF-e cUF)
const iss = getIssMunicipalPorIbge(3509502); // Campinas — estimativa row
if (iss?.fonte === 'estimativa') {
console.warn(iss.warning); // not for NFSe emission
}
getDataCatalog().length; // registered datasetsListing reference data (getAll*)
import { getAllNcm } from '@br-validators/core/ncm';
import { getAllCfop } from '@br-validators/core/cfop';
import { getAllCstIcms } from '@br-validators/core/cst';
getAllNcm().length; // full NCM embed
getAllCfop().length; // full CFOP embed
getAllCstIcms(); // ICMS CST rowsAlso: getAllBancos, getAllEsocialCategorias, getAllIssMunicipal, getAllAeroportos. Deprecated names (getNcms, getCfops) — MIGRATION.md.
Freshness table (auto-updated daily; ANP weekly): docs/DATA-FRESHNESS.md · Per-type official URLs: docs/OFFICIAL-SOURCES.md
Current release
v1.10.0 — Phase 35 (EXP-35): CSOSN, eSocial rubricas, PTAX 90d + getPtaxHistorico, ISS MUNIC/IBGE cascade, batch CSV, PIX sanitize, bundle size docs, ISS fonte. CHANGELOG
Tree-shaking
// Only ships the CPF module — nothing else
import { validateCpf } from '@br-validators/core/cpf';
// Only ships NF-e module
import { parseNfeChave } from '@br-validators/core/nfe-chave';Bundle size (gzipped)
Measured @br-validators/[email protected] with pnpm measure:bundle-sizes (esbuild ESM bundle per subpath). Reference-data subpaths include embedded JSON; some validators (e.g. cep, sanitize) also bundle shared core dependencies when imported alone.
| Subpath | Raw (esbuild) | Gzip | Notes |
|---------|---------------|------|-------|
| @br-validators/core/cpf | 4.0 KB | 1.5 KB | validator only |
| @br-validators/core/cnpj | 6.8 KB | 2.0 KB | validator only |
| @br-validators/core/cep | 2340.8 KB | 161.8 KB | validator only |
| @br-validators/core/ncm | 914.6 KB | 142.2 KB | includes embed |
| @br-validators/core/cfop | 100.3 KB | 9.4 KB | includes embed |
| @br-validators/core/cst | 19.1 KB | 3.4 KB | includes embed |
| @br-validators/core/pix | 17.6 KB | 3.9 KB | validator only |
| @br-validators/core/ptax | 214.2 KB | 22.4 KB | includes embed |
| @br-validators/core/ibge | 392.6 KB | 60.5 KB | includes embed |
| @br-validators/core/sanitize | 2995.5 KB | 219.4 KB | platform utilities |
Full table (62 subpaths): data/bundle-sizes/subpath-sizes.md.
Related packages
| Package | npm |
|---|---|
| @br-validators/cli | Terminal — validate, format, detect, generate |
| @br-validators/zod | Zod 3/4 schemas |
| @br-validators/react-hook-form | RHF rules + resolvers |
| @br-validators/express | Express + Fastify middleware |
| @br-validators/vue | Vue 3 composables |
Contributing
Issues, corrections, and new document types are welcome.
See CONTRIBUTING.md and open good first issue items.
License
MIT — permanently free and open source.
