@br-validators/core 1.1.0 → 1.3.0

package/README.md

@@ -29,7 +29,7 @@ Every Brazilian SaaS eventually reinvents CPF validation — usually wrong.
 - ✅ **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, Bacen banks, DDD lookup with weekly freshness ([DATA-FRESHNESS.md](../../docs/DATA-FRESHNESS.md))
+- ✅ **Reference data** — IBGE, Bacen banks, DDD lookup, national holidays, CNAE, CFOP, NCM, CBO — embedded offline with weekly freshness ([DATA-FRESHNESS.md](../../docs/DATA-FRESHNESS.md))
 - ✅ **ESM only**, Node ≥ 18, works in browser, Bun, Deno
 
 ---
@@ -234,7 +234,7 @@ br-validators generate inscricao-estadual-produtor-rural --masked --seed 42
 |---|---|---|---|
 | 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` |
+| 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` |
@@ -258,7 +258,46 @@ br-validators generate inscricao-estadual-produtor-rural --masked --seed 42
 | **generate()** | `@br-validators/core/generate` | `br-validators generate …` | `/generate` |
 | **buildStaticPixBrCode()** | `@br-validators/core/brcode` | — | `/pix` (QR panel) |
 
-Full official sources per type: [docs/OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/OFFICIAL-SOURCES.md)
+### 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 | Key APIs | Official source |
+|---------|---------|----------|-----------------|
+| IBGE states + municipalities | `@br-validators/core/ibge` | `getEstados`, `getMunicipios`, `getMunicipioPorCodigo` | [IBGE localidades API](https://servicodados.ibge.gov.br/api/docs/localidades) |
+| Bacen STR banks (COMPE / ISPB) | `@br-validators/core/bancos` | `getBancos`, `getBancoPorCodigo`, `getBancoPorIspb` | [Bacen Participantes STR](https://www.bcb.gov.br/content/estabilidadefinanceira/str1/ParticipantesSTR.csv) |
+| DDD geographic lookup | `@br-validators/core/telefone` | `getDddInfo` (extends telefone validator) | [Anatel DDD panel](https://informacoes.anatel.gov.br/paineis/areas-tarifarias/codigos-nacionais) |
+| National holidays | `@br-validators/core/feriados` | `isFeriadoNacional`, `getFeriadosNacionais`, `getProximoDiaUtil` | [Lei 662/1949](https://www.planalto.gov.br/ccivil_03/leis/l0662.htm) + annual Portaria MGI |
+| CNAE 2.3 subclasses | `@br-validators/core/cnaes` | `getCnaePorCodigo`, `searchCnaes` | [IBGE CNAE API v2](https://servicodados.ibge.gov.br/api/docs/cnae) |
+| CFOP fiscal operations | `@br-validators/core/cfop` | `getCfopPorCodigo`, `searchCfop` | [CONFAZ CFOP SINIEF](https://www.confaz.fazenda.gov.br/legislacao/ajustes/sinief/cfop_cvsn_70_vigente) |
+| NCM Mercosur nomenclature | `@br-validators/core/ncm` | `getNcmPorCodigo`, `searchNcm` | [Siscomex NCM JSON](https://portalunico.siscomex.gov.br/classif/api/publico/nomenclatura/download/json) |
+| CBO 2002 occupations | `@br-validators/core/cbo` | `getCboPorCodigo`, `searchCbo` | [MTE CBO downloads](https://www.gov.br/trabalho-e-emprego/pt-br/assuntos/cbo/servicos/downloads) |
+| CEP prefix lookup | `@br-validators/core/cep` | `getCepFaixaInfo`, `getCepFaixas` | [IBGE CNEFE 2022](https://www.ibge.gov.br/estatisticas/sociais/populacao/38734-cadastro-nacional-de-enderecos-para-fins-estatisticos.html) |
+| Data transparency catalog | `@br-validators/core/data-catalog` | `getDataCatalog`, `getDatasetMetadata` | Aggregates all `metadata.json` entries |
+
+```typescript
+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 { getNcmPorCodigo } from '@br-validators/core/ncm';
+import { getCboPorCodigo } from '@br-validators/core/cbo';
+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
+getDataCatalog().length;              // 8 registered datasets
+```
+
+Freshness table (auto-updated weekly): [docs/DATA-FRESHNESS.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/DATA-FRESHNESS.md) · Per-type official URLs: [docs/OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/OFFICIAL-SOURCES.md)
 
 ---
 

package/dist/bancos.js

@@ -1,4 +1,4 @@
-import { metadata_default } from './chunk-XADVBV73.js';
+import { metadata_default } from './chunk-WH6W3NUA.js';
 
 // src/bancos/data/bancos.json
 var bancos_default = [

package/dist/batch.js

@@ -1,30 +1,31 @@
-export { batch } from './chunk-N5CER3QZ.js';
-import './chunk-I66ZRSEN.js';
-import './chunk-EFEE6CMO.js';
-import './chunk-CSVGWTCG.js';
-import './chunk-665E36SC.js';
-import './chunk-CDNOUZEI.js';
+export { batch } from './chunk-QK27VDVB.js';
+import './chunk-NT3TNF3R.js';
 import './chunk-AO6UTQ4A.js';
 import './chunk-JLCQ7MGC.js';
 import './chunk-3LMDBXU6.js';
-import './chunk-KTEQPYYN.js';
+import './chunk-OOUEURR7.js';
+import './chunk-XHDRWM46.js';
+import './chunk-665E36SC.js';
+import './chunk-CDNOUZEI.js';
+import './chunk-VKG7UEN5.js';
+import './chunk-RRVGW333.js';
 import './chunk-AU6TW3GH.js';
 import './chunk-N6RQICAP.js';
 import './chunk-E2EFGMWA.js';
-import './chunk-V7UJ55KW.js';
-import './chunk-H3MLGGFI.js';
-import './chunk-P2KNN6ZR.js';
-import './chunk-63G7QO73.js';
-import './chunk-ANWQBKGN.js';
-import './chunk-TE6NSONR.js';
-import './chunk-YNVMVDFN.js';
-import './chunk-YYHS5WQN.js';
-import './chunk-4SNBZFS5.js';
-import './chunk-UCJPSJN5.js';
+import './chunk-MZDCVTN6.js';
+import './chunk-KLONQL76.js';
 import './chunk-CSRBRKXY.js';
 import './chunk-FBARVLLP.js';
+import './chunk-KGCLQ7QX.js';
+import './chunk-L7PF4KD6.js';
 import './chunk-OTZHMJYE.js';
+import './chunk-ANWQBKGN.js';
+import './chunk-P6TOL5VY.js';
+import './chunk-YYHS5WQN.js';
+import './chunk-4SNBZFS5.js';
+import './chunk-DQUMIETC.js';
 import './chunk-EB3G4IG6.js';
+import './chunk-UCJPSJN5.js';
 import './chunk-NUQSMT4Y.js';
 //# sourceMappingURL=batch.js.map
 //# sourceMappingURL=batch.js.map

package/dist/brcode.js

@@ -1,13 +1,13 @@
 import './chunk-RYGAK7PB.js';
-export { BRCODE_GOLDEN_COMPOSITE, BRCODE_GOLDEN_DYNAMIC_URL, BRCODE_GOLDEN_STATIC_CPF, BRCODE_GOLDEN_STATIC_EMAIL, BRCODE_GOLDEN_STATIC_EVP, BRCODE_OFFICIAL_SOURCE_URL, BRCODE_PIX_INITIATION_MANUAL_URL, buildStaticPixBrCode, computeCrc16Ccitt, findPixMerchantAccount, findTlvField, isValidBrCode, normalizeBrCodePayload, parseBrCode, parseBrCodePayload, parseTlvSequence, validateBrCode, verifyBrCodeCrc } from './chunk-V7UJ55KW.js';
-import './chunk-H3MLGGFI.js';
-import './chunk-P2KNN6ZR.js';
-import './chunk-63G7QO73.js';
-import './chunk-UCJPSJN5.js';
+export { BRCODE_GOLDEN_COMPOSITE, BRCODE_GOLDEN_DYNAMIC_URL, BRCODE_GOLDEN_STATIC_CPF, BRCODE_GOLDEN_STATIC_EMAIL, BRCODE_GOLDEN_STATIC_EVP, BRCODE_OFFICIAL_SOURCE_URL, BRCODE_PIX_INITIATION_MANUAL_URL, buildStaticPixBrCode, computeCrc16Ccitt, findPixMerchantAccount, findTlvField, isValidBrCode, normalizeBrCodePayload, parseBrCode, parseBrCodePayload, parseTlvSequence, validateBrCode, verifyBrCodeCrc } from './chunk-MZDCVTN6.js';
+import './chunk-KLONQL76.js';
 import './chunk-CSRBRKXY.js';
 import './chunk-FBARVLLP.js';
+import './chunk-KGCLQ7QX.js';
+import './chunk-L7PF4KD6.js';
 import './chunk-OTZHMJYE.js';
 import './chunk-EB3G4IG6.js';
+import './chunk-UCJPSJN5.js';
 import './chunk-NUQSMT4Y.js';
 //# sourceMappingURL=brcode.js.map
 //# sourceMappingURL=brcode.js.map

package/dist/cbo.d.ts

@@ -0,0 +1,41 @@
+import { b as DatasetChanges, c as DatasetVerification } from './types-CBIZxgfG.js';
+
+interface Cbo {
+    codigo: string;
+    descricao: string;
+}
+interface CboDataVersion {
+    id: 'cbo';
+    nome: string;
+    fonte: string;
+    endpoints: string[];
+    capturadoEm: string;
+    atualizadoEm: string;
+    contagens: {
+        cbo: number;
+    };
+    alteracoes: DatasetChanges;
+    verificacao: DatasetVerification;
+    documentacao: string;
+}
+
+/**
+ * CBO 2002 occupation lookup — offline embedded data from official MTE CSV.
+ * @see https://www.gov.br/trabalho-e-emprego/pt-br/assuntos/cbo/servicos/downloads
+ */
+
+declare function getCbos(): readonly Cbo[];
+declare function getCboPorCodigo(codigo: string): Cbo | undefined;
+declare function searchCbo(query: string, options?: {
+    limit?: number;
+}): readonly Cbo[];
+
+declare const CBO_OCUPACAO_CSV_URL = "https://www.gov.br/trabalho-e-emprego/pt-br/assuntos/cbo/servicos/downloads/cbo2002-ocupacao.csv";
+declare const CBO_GOLDEN_ANALISTA_SISTEMAS = "212405";
+declare const CBO_GOLDEN_OFICIAL_AERONAUTICA = "010105";
+declare const CBO_MIN_OCUPACOES = 2400;
+declare const CBO_MAX_OCUPACOES = 2800;
+
+declare const CBO_DATA_VERSION: CboDataVersion;
+
+export { CBO_DATA_VERSION, CBO_GOLDEN_ANALISTA_SISTEMAS, CBO_GOLDEN_OFICIAL_AERONAUTICA, CBO_MAX_OCUPACOES, CBO_MIN_OCUPACOES, CBO_OCUPACAO_CSV_URL, type Cbo, type CboDataVersion, getCboPorCodigo, getCbos, searchCbo };