@br-validators/core 0.11.0-alpha.0 → 0.12.0-alpha.1

package/README.md

@@ -1,11 +1,12 @@
 # @br-validators/core
 
-100% open-source Brazilian document validators (MIT).
+100% open-source Brazilian document validators (MIT). Pure TypeScript — no HTTP lookups, no frameworks.
 
 **npm:** [`@br-validators/core`](https://www.npmjs.com/package/@br-validators/core)  
-**Repo:** [github.com/AlexandreZanata/br-validators](https://github.com/AlexandreZanata/br-validators)
+**Repo:** [github.com/AlexandreZanata/br-validators](https://github.com/AlexandreZanata/br-validators)  
+**Playground:** [doc-raiz-playground.vercel.app](https://doc-raiz-playground.vercel.app/)
 
-> The unscoped name `br-validators` on npm is a different package. Use **`@br-validators/core`**.
+> The unscoped name `br-validators` on npm is a **different package**. Use **`@br-validators/core`**.
 
 ---
 
@@ -19,61 +20,164 @@ Requires Node ≥ 18. ESM only (`"type": "module"`).
 
 ---
 
-## Supported types
+## Platform APIs
 
-| Module | Functions | Golden vector |
-|--------|-----------|---------------|
-| CNPJ | `validateCnpj`, `formatCnpj`, `stripCnpj` | `12ABC34501DE35` |
-| CPF | `validateCpf`, `formatCpf`, `stripCpf` | `12345678909` |
-| CEP | `validateCep`, `formatCep`, `stripCep` | `01310100` |
-| Placa | `validatePlaca`, `formatPlaca`, `convertPlacaToMercosul` | `ABC1D23` |
-| PIS/PASEP | `validatePisPasep`, `formatPisPasep` | `10027230888` |
-| PIX key | `validatePixKey`, `formatPixKey` | `pix@bcb.gov.br` |
-| Boleto | `validateBoleto`, `formatBoleto` | Situação 1 + 2 |
-| Credit card | `validateCartaoCredito`, `passesLuhn` | `4111111111111111` |
-| IE (27 UFs) | `validateInscricaoEstadual`, `validateIeSp`, … | per UF — see docs |
+Cross-cutting helpers that **compose existing validators** — never duplicate check-digit logic.
 
-Subpath imports for tree-shaking:
+| API | Import | Purpose |
+|-----|--------|---------|
+| **`detect()`** | `@br-validators/core/detect` | Classify raw input (priority router over all shipped types) |
+| **`sanitize()`** | `@br-validators/core/sanitize` | ETL fixes → validate (returns `fixes[]`) |
+| **`generate()`** | `@br-validators/core/generate` | Synthetic **test fixtures** only (`seed` for reproducibility) |
+
+```typescript
+import { detect, sanitize, generate } from '@br-validators/core';
+import { validateCpf } from '@br-validators/core/cpf';
+
+// Auto-detect document type
+detect('123.456.789-09');
+// → { type: 'cpf', ok: true, value: '12345678909', format: 'numeric' }
+
+detect('110042490114', { uf: 'SP' });
+// → { type: 'inscricao-estadual', ok: true, ... }
+
+// Messy ETL input → canonical + fix audit trail
+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: [...] }
+
+// Synthetic valid documents for tests (never production IDs)
+const cpf = generate('cpf', { seed: 42 });
+validateCpf(cpf).ok; // true
+
+generate('cnpj', { format: 'alphanumeric', masked: true, seed: 7 });
+generate('placa', { format: 'mercosul', seed: 3 });
+```
+
+**Detect notes:** 11-digit bucket tries CPF → CNH → PIS (RENAVAM equivalent DV may classify as `pis-pasep`). IE detection requires `{ uf }`. 48-digit boleto arrecadação is skipped.
+
+**Generate policy:** 9 types — CPF, CNPJ, CEP, placa, PIS, RENAVAM, CNH, telefone, cartão. Excludes boleto, NF-e chave, IE, BR Code, PIX.
+
+---
+
+## Per-type validators
+
+Every module exposes `validate*`, `format*`, `strip*` (where applicable). All return `ValidationResult` — **never throw** on invalid input.
+
+| Subpath | Key functions | Golden vector |
+|---------|---------------|---------------|
+| `./cnpj` | `validateCnpj`, `formatCnpj`, `stripCnpj` | `12ABC34501DE35` (alphanumeric) |
+| `./cpf` | `validateCpf`, `formatCpf`, `stripCpf` | `12345678909` |
+| `./cep` | `validateCep`, `formatCep`, `stripCep` | `01310100` |
+| `./telefone` | `validateTelefone`, `formatTelefone`, `stripTelefone` | `11999999999` (celular) |
+| `./cnh` | `validateCnh`, `formatCnh`, `stripCnh` | `62472927637` (11 digits, no CPF mask) |
+| `./renavam` | `validateRenavam`, `formatRenavam`, `stripRenavam` | `63977791104` |
+| `./titulo-eleitor` | `validateTituloEleitor`, `formatTituloEleitor`, `stripTituloEleitor` | `004356870906` |
+| `./nfe-chave` | `validateNfeChave`, `parseNfeChave`, `formatNfeChave` | `52060433009911002506550120000007800267301615` |
+| `./brcode` | `validateBrCode`, `parseBrCode` | EMV PIX payload (CRC16) |
+| `./placa` | `validatePlaca`, `formatPlaca`, `convertPlacaToMercosul` | `ABC1D23` (Mercosul), `ABC1234` (legacy) |
+| `./pis-pasep` | `validatePisPasep`, `formatPisPasep`, `stripPisPasep` | `10027230888` |
+| `./pix` | `validatePixKey`, `formatPixKey`, `detectPixKeyType` | `pix@bcb.gov.br` |
+| `./boleto` | `validateBoleto`, `formatBoleto`, `convertLinhaToCodigoBarras` | Situação 1 + 2 (FEBRABAN) |
+| `./cartao-credito` | `validateCartaoCredito`, `passesLuhn`, `detectCardBrand` | `4111111111111111` |
+| `./inscricao-estadual` | `validateInscricaoEstadual`, `formatInscricaoEstadual` | `110042490114` (SP) — **27 UFs**, `{ uf }` required |
+| `./inscricao-estadual-produtor-rural` | `validateIeProdutorRural`, `validateIeSpRural` | `P011004243002` (SP Regra II) |
+
+Tree-shaking via subpaths:
 
 ```typescript
 import { validateCnpj } from '@br-validators/core/cnpj';
+import { validateNfeChave } from '@br-validators/core/nfe-chave';
+import { validateTituloEleitor } from '@br-validators/core/titulo-eleitor';
+import { validateBrCode } from '@br-validators/core/brcode';
 import { validateInscricaoEstadual } from '@br-validators/core/inscricao-estadual';
+import { validateIeProdutorRural } from '@br-validators/core/inscricao-estadual-produtor-rural';
 ```
 
 ---
 
 ## Examples
 
+### CNPJ (numeric + alphanumeric)
+
 ```typescript
 import { validateCnpj, formatCnpj } from '@br-validators/core';
 
-const result = validateCnpj('12ABC34501DE35');
-// { ok: true, value: '12ABC34501DE35', format: 'alphanumeric', ... }
+validateCnpj('12ABC34501DE35');
+// { ok: true, value: '12ABC34501DE35', format: 'alphanumeric' }
 
 formatCnpj('12ABC34501DE35');
-// { ok: true, formatted: '12.ABC.345/01DE-35', ... }
+// { ok: true, formatted: '12.ABC.345/01DE-35' }
 ```
 
+### Inscrição Estadual (all 27 UFs)
+
 ```typescript
 import { validateInscricaoEstadual } from '@br-validators/core/inscricao-estadual';
 
 validateInscricaoEstadual('110042490114', { uf: 'SP' });
 validateInscricaoEstadual('0730000100109', { uf: 'DF' });
+// getIeOfficialSourceUrl('SP') → SEFAZ primary URL
+```
+
+### SP produtor rural (`P` prefix)
+
+```typescript
+import { validateIeProdutorRural } from '@br-validators/core/inscricao-estadual-produtor-rural';
+
+validateIeProdutorRural('SP', 'P-01100424.3/002');
+// { ok: true, value: 'P011004243002', ... }
+```
+
+### NF-e / NFC-e chave de acesso (44 digits)
+
+```typescript
+import { validateNfeChave, parseNfeChave } from '@br-validators/core/nfe-chave';
+
+const result = validateNfeChave('52060433009911002506550120000007800267301615');
+// { ok: true, parsed: { cUF, cnpj, mod, serie, nNF, ... }, uf: 'GO' }
+```
+
+### BR Code (PIX QR payload)
+
+```typescript
+import { validateBrCode } from '@br-validators/core/brcode';
+
+validateBrCode('00020126580014br.gov.bcb.pix0136...63041D3D');
+// { ok: true, pixKey, merchantName, merchantCity, ... }
+```
+
+### Boleto (linha digitável ↔ código de barras)
+
+```typescript
+import { validateBoleto, convertLinhaToCodigoBarras } from '@br-validators/core/boleto';
+
+validateBoleto('03399.02579 08991.834006 71742.301014 6 14500000099668');
 ```
 
 ---
 
 ## Official sources
 
-Every algorithm cites a primary government source. Full table: [OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/OFFICIAL-SOURCES.md)
+Every algorithm cites a primary government or standards body source (RFB, Bacen, CONTRAN, TSE, SEFAZ, FEBRABAN, ISO, Correios, Anatel, SIPREV).
+
+Full index: [docs/OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/OFFICIAL-SOURCES.md)
+
+Per-type constants: `CNPJ_OFFICIAL_SOURCE_URL`, `NFE_CHAVE_OFFICIAL_SOURCE_URL`, `IE_OFFICIAL_SOURCE_URLS`, `BRCODE_OFFICIAL_SOURCE_URL`, etc.
 
-Per-type URLs also available via constants (`CNPJ_OFFICIAL_SOURCE_URL`, `IE_OFFICIAL_SOURCE_URLS`, etc.).
+Golden test vectors: `tests/vectors/*.official.json` in the repo.
 
 ---
 
 ## API reference
 
-[docs/LIBRARY-API.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/LIBRARY-API.md)
+| Doc | Content |
+|-----|---------|
+| [LIBRARY-API.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/LIBRARY-API.md) | Full signatures + platform APIs |
+| [VALIDATION-RULES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/VALIDATION-RULES.md) | Business rules (BR-* IDs) |
+| [DELIVERY-SURFACES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/DELIVERY-SURFACES.md) | Library + CLI + playground matrix |
 
 ---
 
@@ -81,11 +185,32 @@ Per-type URLs also available via constants (`CNPJ_OFFICIAL_SOURCE_URL`, `IE_OFFI
 
 ```bash
 npm install -g @br-validators/cli
+
+br-validators list
 br-validators cnpj validate 12ABC34501DE35 --json
+br-validators nfe-chave validate 52060433009911002506550120000007800267301615 --json
+br-validators titulo-eleitor validate 004356870906
+br-validators brcode validate '<emv-payload>'
+br-validators ie validate 110042490114 --uf SP
+
+# Platform APIs
+br-validators detect '123.456.789-09' --json
+br-validators sanitize cpf ' 123.456.789-09 ' --json
+br-validators generate cpf --seed 42 --masked --json
 ```
 
 ---
 
+## Related packages (monorepo)
+
+| Package | Status |
+|---------|--------|
+| `@br-validators/cli` | Published — terminal CLI |
+| `@br-validators/zod` | Workspace — Zod schemas (not on npm yet) |
+| `@br-validators/react-hook-form` | Workspace — RHF resolvers (not on npm yet) |
+
+---
+
 ## License
 
 MIT

package/dist/boleto.d.ts

@@ -1,5 +1,5 @@
-import { b as BoletoValidationResult, V as ValidationErrorCode, B as BoletoInputKind, F as FormatResult } from './validation-result-C-Ei-lZH.js';
-export { a as BoletoSituacao, h as CodigoBarras, D as DocumentFormat, L as LinhaDigitavel } from './validation-result-C-Ei-lZH.js';
+import { b as BoletoValidationResult, V as ValidationErrorCode, B as BoletoInputKind, F as FormatResult } from './validation-result-BhQE-1_O.js';
+export { a as BoletoSituacao, i as CodigoBarras, D as DocumentFormat, L as LinhaDigitavel } from './validation-result-BhQE-1_O.js';
 
 /**
  * FEBRABAN bank boleto (cobrança) — linha digitável + código de barras.

package/dist/boleto.js

@@ -1,4 +1,5 @@
-export { BOLETO_CODE_ISPB_HOLDER, BOLETO_CODIGO_BARRAS_LENGTH, BOLETO_CURRENCY_ISPB, BOLETO_CURRENCY_REAL, BOLETO_GOLDEN_CODIGO_BARRAS, BOLETO_GOLDEN_CODIGO_BARRAS_BB, BOLETO_GOLDEN_CODIGO_BARRAS_SITUACAO2, BOLETO_GOLDEN_LINHA_BB_STRIPPED, BOLETO_GOLDEN_LINHA_MASKED, BOLETO_GOLDEN_LINHA_SITUACAO2_STRIPPED, BOLETO_GOLDEN_LINHA_STRIPPED, BOLETO_LAYOUTS_PORTAL_URL, BOLETO_LINHA_LENGTH, BOLETO_OFFICIAL_SOURCE_URL, applyLinhaDigitavelMask, computeModulo10FieldDv, computeModulo11BarcodeDv, convertCodigoBarrasToLinhaDigitavel, convertCodigoBarrasToLinhaDigits, convertLinhaToCodigoBarras, convertLinhaToCodigoBarrasDigits, detectBoletoInputKind, detectBoletoSituacao, formatBoleto, formatLinhaDigitavel, isValidBoleto, stripCodigoBarras, stripLinhaDigitavel, validateBoleto, validateCodigoBarras, validateFatorVencimento, validateLinhaDigitavel, validateValorDocumento } from './chunk-IW3ESGWH.js';
-import './chunk-BBL6ZPXH.js';
+export { formatBoleto } from './chunk-FXLVNCG3.js';
+export { BOLETO_CODE_ISPB_HOLDER, BOLETO_CODIGO_BARRAS_LENGTH, BOLETO_CURRENCY_ISPB, BOLETO_CURRENCY_REAL, BOLETO_GOLDEN_CODIGO_BARRAS, BOLETO_GOLDEN_CODIGO_BARRAS_BB, BOLETO_GOLDEN_CODIGO_BARRAS_SITUACAO2, BOLETO_GOLDEN_LINHA_BB_STRIPPED, BOLETO_GOLDEN_LINHA_MASKED, BOLETO_GOLDEN_LINHA_SITUACAO2_STRIPPED, BOLETO_GOLDEN_LINHA_STRIPPED, BOLETO_LAYOUTS_PORTAL_URL, BOLETO_LINHA_LENGTH, BOLETO_OFFICIAL_SOURCE_URL, applyLinhaDigitavelMask, computeModulo10FieldDv, computeModulo11BarcodeDv, convertCodigoBarrasToLinhaDigitavel, convertCodigoBarrasToLinhaDigits, convertLinhaToCodigoBarras, convertLinhaToCodigoBarrasDigits, detectBoletoInputKind, detectBoletoSituacao, formatLinhaDigitavel, isValidBoleto, stripCodigoBarras, stripLinhaDigitavel, validateBoleto, validateCodigoBarras, validateFatorVencimento, validateLinhaDigitavel, validateValorDocumento } from './chunk-4W4OKLSZ.js';
+import './chunk-MSLJF2FM.js';
 //# sourceMappingURL=boleto.js.map
 //# sourceMappingURL=boleto.js.map

package/dist/brcode.d.ts

@@ -1,5 +1,5 @@
-import { k as PixKey, l as PixKeyType, V as ValidationErrorCode, d as BrCodeValidationResult } from './validation-result-C-Ei-lZH.js';
-export { c as BrCodePayload } from './validation-result-C-Ei-lZH.js';
+import { p as PixKey, q as PixKeyType, V as ValidationErrorCode, d as BrCodeValidationResult } from './validation-result-BhQE-1_O.js';
+export { c as BrCodePayload } from './validation-result-BhQE-1_O.js';
 
 /** Bacen Manual BR Code — EMV-QRCPS-MPM TLV + CRC16-CCITT */
 declare const BRCODE_OFFICIAL_SOURCE_URL = "https://www.bcb.gov.br/content/estabilidadefinanceira/spb_docs/ManualBRCode.pdf";

package/dist/brcode.js

@@ -1,10 +1,13 @@
-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, computeCrc16Ccitt, findPixMerchantAccount, findTlvField, isValidBrCode, normalizeBrCodePayload, parseBrCode, parseBrCodePayload, parseTlvSequence, validateBrCode, verifyBrCodeCrc } from './chunk-GEHAH4OH.js';
-import './chunk-D5JMGN7U.js';
-import './chunk-UE4PVN6Y.js';
+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, computeCrc16Ccitt, findPixMerchantAccount, findTlvField, isValidBrCode, normalizeBrCodePayload, parseBrCode, parseBrCodePayload, parseTlvSequence, validateBrCode, verifyBrCodeCrc } from './chunk-WCQUQ2WX.js';
+import './chunk-MK7OJUF5.js';
+import './chunk-XUO7FV6Z.js';
+import './chunk-YXELVV37.js';
 import './chunk-EB3G4IG6.js';
-import './chunk-5BBNLRZP.js';
+import './chunk-KQDLIGSG.js';
+import './chunk-F6PTZY4O.js';
 import './chunk-UCJPSJN5.js';
-import './chunk-B2TDI3YS.js';
-import './chunk-BBL6ZPXH.js';
+import './chunk-OTZHMJYE.js';
+import './chunk-MSLJF2FM.js';
 //# sourceMappingURL=brcode.js.map
 //# sourceMappingURL=brcode.js.map

package/dist/cartao-credito.d.ts

@@ -1,5 +1,5 @@
-import { e as CartaoCreditoValidationResult, F as FormatResult } from './validation-result-C-Ei-lZH.js';
-export { C as CartaoCredito, D as DocumentFormat, V as ValidationErrorCode } from './validation-result-C-Ei-lZH.js';
+import { e as CartaoCreditoValidationResult, F as FormatResult } from './validation-result-BhQE-1_O.js';
+export { C as CartaoCredito, D as DocumentFormat, V as ValidationErrorCode } from './validation-result-BhQE-1_O.js';
 
 /**
  * Credit card PAN constants — ISO/IEC 7812-1 Annex B (Luhn).

package/dist/cartao-credito.js

@@ -1,4 +1,6 @@
-export { CARTAO_GOLDEN_AMEX, CARTAO_GOLDEN_LUHN_WALKTHROUGH, CARTAO_GOLDEN_MASTERCARD, CARTAO_GOLDEN_MIN_LENGTH, CARTAO_GOLDEN_VISA, CARTAO_GOLDEN_VISA_MASKED, CARTAO_IEC_SOURCE_URL, CARTAO_OFFICIAL_SOURCE_URL, CARTAO_PAN_MAX_LENGTH, CARTAO_PAN_MIN_LENGTH, computeLuhnSum, detectCardBrand, formatCartaoCredito, isValidCartaoCredito, isValidLuhn, passesLuhn, stripCartaoCredito, validateCartaoCredito } from './chunk-CR45BOLS.js';
-import './chunk-BBL6ZPXH.js';
+import './chunk-CQPM43VV.js';
+export { formatCartaoCredito } from './chunk-XKY2CV3G.js';
+export { CARTAO_GOLDEN_AMEX, CARTAO_GOLDEN_LUHN_WALKTHROUGH, CARTAO_GOLDEN_MASTERCARD, CARTAO_GOLDEN_MIN_LENGTH, CARTAO_GOLDEN_VISA, CARTAO_GOLDEN_VISA_MASKED, CARTAO_IEC_SOURCE_URL, CARTAO_OFFICIAL_SOURCE_URL, CARTAO_PAN_MAX_LENGTH, CARTAO_PAN_MIN_LENGTH, computeLuhnSum, detectCardBrand, isValidCartaoCredito, isValidLuhn, passesLuhn, stripCartaoCredito, validateCartaoCredito } from './chunk-EPKHEW5V.js';
+import './chunk-MSLJF2FM.js';
 //# sourceMappingURL=cartao-credito.js.map
 //# sourceMappingURL=cartao-credito.js.map

package/dist/cep.d.ts

@@ -1,5 +1,5 @@
-import { q as ValidationResult, F as FormatResult } from './validation-result-C-Ei-lZH.js';
-export { f as Cep, D as DocumentFormat, V as ValidationErrorCode } from './validation-result-C-Ei-lZH.js';
+import { x as ValidationResult, F as FormatResult } from './validation-result-BhQE-1_O.js';
+export { f as Cep, D as DocumentFormat, V as ValidationErrorCode } from './validation-result-BhQE-1_O.js';
 
 declare const CEP_GOLDEN_PRIMARY = "01310100";
 declare const CEP_GOLDEN_SECONDARY = "20040020";

package/dist/cep.js

@@ -1,7 +1,10 @@
-export { CEP_GOLDEN_PRIMARY, CEP_GOLDEN_PRIMARY_MASKED, CEP_GOLDEN_SECONDARY, CEP_OFFICIAL_SOURCE_URL, formatCep, isValidCep, validateCep } from './chunk-GLKGX552.js';
-export { stripCep } from './chunk-W6UXVWSR.js';
+import './chunk-2CNYSY3Z.js';
+export { formatCep } from './chunk-ZAUZRIOU.js';
+export { CEP_GOLDEN_PRIMARY, CEP_GOLDEN_PRIMARY_MASKED, CEP_GOLDEN_SECONDARY, CEP_OFFICIAL_SOURCE_URL, isValidCep, validateCep } from './chunk-2JJS46FM.js';
+export { stripCep } from './chunk-YYHS5WQN.js';
+import './chunk-4SNBZFS5.js';
 import './chunk-EB3G4IG6.js';
 import './chunk-UCJPSJN5.js';
-import './chunk-BBL6ZPXH.js';
+import './chunk-MSLJF2FM.js';
 //# sourceMappingURL=cep.js.map
 //# sourceMappingURL=cep.js.map

package/dist/chunk-2CNYSY3Z.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-2CNYSY3Z.js.map
+//# sourceMappingURL=chunk-2CNYSY3Z.js.map

package/dist/chunk-2CNYSY3Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-2CNYSY3Z.js"}

package/dist/{chunk-GLKGX552.js → chunk-2JJS46FM.js}

@@ -1,5 +1,5 @@
-import { stripCep } from './chunk-W6UXVWSR.js';
-import { brandCep } from './chunk-BBL6ZPXH.js';
+import { stripCep } from './chunk-YYHS5WQN.js';
+import { brandCep } from './chunk-MSLJF2FM.js';
 
 // src/core/cep/constants.ts
 var CEP_LENGTH = 8;
@@ -38,24 +38,6 @@ function validateCep(input) {
   return { ok: true, value: brandCep(stripped), format: "numeric" };
 }
 
-// src/core/cep/mask.ts
-function applyCepMask(canonical) {
-  const match = CEP_MASK_PATTERN.exec(canonical);
-  if (!match) {
-    throw new Error("CEP must have exactly 8 digits to apply mask");
-  }
-  return `${match[1]}-${match[2]}`;
-}
-
-// src/format/cep.ts
-function formatCep(input) {
-  const result = validateCep(input);
-  if (!result.ok) {
-    return { ok: false, code: result.code, message: result.message };
-  }
-  return { ok: true, formatted: applyCepMask(result.value) };
-}
-
-export { CEP_GOLDEN_PRIMARY, CEP_GOLDEN_PRIMARY_MASKED, CEP_GOLDEN_SECONDARY, CEP_OFFICIAL_SOURCE_URL, formatCep, isValidCep, validateCep };
-//# sourceMappingURL=chunk-GLKGX552.js.map
-//# sourceMappingURL=chunk-GLKGX552.js.map
+export { CEP_GOLDEN_PRIMARY, CEP_GOLDEN_PRIMARY_MASKED, CEP_GOLDEN_SECONDARY, CEP_MASK_PATTERN, CEP_OFFICIAL_SOURCE_URL, isValidCep, validateCep };
+//# sourceMappingURL=chunk-2JJS46FM.js.map
+//# sourceMappingURL=chunk-2JJS46FM.js.map

package/dist/chunk-2JJS46FM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/cep/constants.ts","../src/core/cep/index.ts"],"names":[],"mappings":";;;;AAKO,IAAM,UAAA,GAAa,CAAA;AACnB,IAAM,gBAAA,GAAmB;AAGzB,IAAM,kBAAA,GAAqB;AAC3B,IAAM,oBAAA,GAAuB;AAC7B,IAAM,yBAAA,GAA4B;AAClC,IAAM,uBAAA,GACX;;;ACMF,SAAS,OAAA,CAAQ,MAA4B,OAAA,EAA+B;AAC1E,EAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,IAAA,EAAM,OAAA,EAAQ;AACpC;AAEA,SAAS,iBAAA,CAAkB,OAAe,QAAA,EAAuC;AAC/E,EAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACzB,IAAA,OAAO,OAAA,CAAQ,eAAe,oBAAoB,CAAA;AAAA,EACpD;AAEA,EAAA,MAAM,WAAA,GAAc,KAAA,CAAM,OAAA,CAAQ,QAAA,EAAU,EAAE,CAAA;AAC9C,EAAA,IAAI,QAAA,CAAS,IAAA,CAAK,WAAW,CAAA,EAAG;AAC9B,IAAA,OAAO,OAAA,CAAQ,qBAAqB,iCAAiC,CAAA;AAAA,EACvE;AAEA,EAAA,IAAI,QAAA,CAAS,WAAW,UAAA,EAAY;AAClC,IAAA,OAAO,OAAA,CAAQ,gBAAA,EAAkB,CAAA,cAAA,EAAiB,UAAU,CAAA,2BAAA,CAA6B,CAAA;AAAA,EAC3F;AAEA,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,WAAW,KAAA,EAAwB;AACjD,EAAA,OAAO,WAAA,CAAY,KAAK,CAAA,CAAE,EAAA;AAC5B;AAEO,SAAS,YAAY,KAAA,EAAiC;AAC3D,EAAA,MAAM,QAAA,GAAW,SAAS,KAAK,CAAA;AAC/B,EAAA,MAAM,UAAA,GAAa,iBAAA,CAAkB,KAAA,EAAO,QAAQ,CAAA;AACpD,EAAA,IAAI,UAAA,EAAY;AACd,IAAA,OAAO,UAAA;AAAA,EACT;AAEA,EAAA,OAAO,EAAE,IAAI,IAAA,EAAM,KAAA,EAAO,SAAS,QAAQ,CAAA,EAAG,QAAQ,SAAA,EAAU;AAClE","file":"chunk-2JJS46FM.js","sourcesContent":["/**\n * CEP constants — 8 digits, no check digit (Correios).\n * @see https://www.correios.com.br/atendimento/developers/manuais/manual-api-busca-cep\n * @see docs/VALIDATION-RULES.md BR-CEP-001 — golden vector 01310100\n */\nexport const CEP_LENGTH = 8;\nexport const CEP_MASK_PATTERN = /^(\\d{5})(\\d{3})$/;\nexport const CEP_NUMERIC_PATTERN = /^\\d{8}$/;\n\nexport const CEP_GOLDEN_PRIMARY = '01310100';\nexport const CEP_GOLDEN_SECONDARY = '20040020';\nexport const CEP_GOLDEN_PRIMARY_MASKED = '01310-100';\nexport const CEP_OFFICIAL_SOURCE_URL =\n  'https://www.correios.com.br/atendimento/developers/manuais/manual-api-busca-cep';\n","/**\n * CEP validation — structural only, no check digit (Correios).\n * @see https://www.correios.com.br/atendimento/developers/manuais/manual-api-busca-cep\n * @see docs/VALIDATION-RULES.md BR-CEP-001 — golden vector 01310100\n */\nimport { stripCep } from '../../strip/index.js';\nimport type { ValidationResult } from '../../types/validation-result.js';\nimport { brandCep } from '../../types/validation-result.js';\nimport { CEP_LENGTH } from './constants.js';\n\nexport {\n  CEP_GOLDEN_PRIMARY,\n  CEP_GOLDEN_PRIMARY_MASKED,\n  CEP_GOLDEN_SECONDARY,\n  CEP_OFFICIAL_SOURCE_URL,\n} from './constants.js';\n\ntype FailedResult = Extract<ValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message };\n}\n\nfunction validateStructure(input: string, stripped: string): FailedResult | null {\n  if (stripped.length === 0) {\n    return failure('EMPTY_INPUT', 'CEP input is empty');\n  }\n\n  const withoutMask = input.replace(/[-\\s]/g, '');\n  if (/[^0-9]/.test(withoutMask)) {\n    return failure('INVALID_CHARACTER', 'CEP contains invalid characters');\n  }\n\n  if (stripped.length !== CEP_LENGTH) {\n    return failure('INVALID_LENGTH', `CEP must have ${CEP_LENGTH} digits after normalization`);\n  }\n\n  return null;\n}\n\nexport function isValidCep(input: string): boolean {\n  return validateCep(input).ok;\n}\n\nexport function validateCep(input: string): ValidationResult {\n  const stripped = stripCep(input);\n  const structural = validateStructure(input, stripped);\n  if (structural) {\n    return structural;\n  }\n\n  return { ok: true, value: brandCep(stripped), format: 'numeric' };\n}\n"]}