@br-validators/core 0.10.0-alpha.0 → 0.12.0-alpha.0

package/README.md

@@ -3,7 +3,7 @@
 100% open-source Brazilian document validators (MIT).
 
 **npm:** [`@br-validators/core`](https://www.npmjs.com/package/@br-validators/core)  
-**Repo:** [github.com/AlexandreZanata/doc-raiz](https://github.com/AlexandreZanata/doc-raiz)
+**Repo:** [github.com/AlexandreZanata/br-validators](https://github.com/AlexandreZanata/br-validators)
 
 > The unscoped name `br-validators` on npm is a different package. Use **`@br-validators/core`**.
 
@@ -26,6 +26,9 @@ Requires Node ≥ 18. ESM only (`"type": "module"`).
 | CNPJ | `validateCnpj`, `formatCnpj`, `stripCnpj` | `12ABC34501DE35` |
 | CPF | `validateCpf`, `formatCpf`, `stripCpf` | `12345678909` |
 | CEP | `validateCep`, `formatCep`, `stripCep` | `01310100` |
+| Telefone | `validateTelefone`, `formatTelefone`, `stripTelefone` | `11999999999` |
+| CNH | `validateCnh`, `formatCnh`, `stripCnh` | `62472927637` (11 digits, no CPF mask) |
+| RENAVAM | `validateRenavam`, `formatRenavam`, `stripRenavam` | `63977791104` (11 digits, modulo 11 peso 9) |
 | Placa | `validatePlaca`, `formatPlaca`, `convertPlacaToMercosul` | `ABC1D23` |
 | PIS/PASEP | `validatePisPasep`, `formatPisPasep` | `10027230888` |
 | PIX key | `validatePixKey`, `formatPixKey` | `pix@bcb.gov.br` |
@@ -65,7 +68,7 @@ validateInscricaoEstadual('0730000100109', { uf: 'DF' });
 
 ## Official sources
 
-Every algorithm cites a primary government source. Full table: [OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/doc-raiz/blob/main/docs/OFFICIAL-SOURCES.md)
+Every algorithm cites a primary government source. Full table: [OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/OFFICIAL-SOURCES.md)
 
 Per-type URLs also available via constants (`CNPJ_OFFICIAL_SOURCE_URL`, `IE_OFFICIAL_SOURCE_URLS`, etc.).
 
@@ -73,7 +76,7 @@ Per-type URLs also available via constants (`CNPJ_OFFICIAL_SOURCE_URL`, `IE_OFFI
 
 ## API reference
 
-[docs/LIBRARY-API.md](https://github.com/AlexandreZanata/doc-raiz/blob/main/docs/LIBRARY-API.md)
+[docs/LIBRARY-API.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/LIBRARY-API.md)
 
 ---
 

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-BK4qJuei.js';
-export { a as BoletoSituacao, f as CodigoBarras, D as DocumentFormat, L as LinhaDigitavel } from './validation-result-BK4qJuei.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-AKJHIJ5E.js';
-import './chunk-DKRM66US.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

@@ -0,0 +1,79 @@
+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";
+declare const BRCODE_PIX_INITIATION_MANUAL_URL = "https://www.bcb.gov.br/content/estabilidadefinanceira/pix/Regulamento_Pix/II_ManualdePadroesparaIniciacaodoPix.pdf";
+/** Manual de Padrões PIX — static QR, EVP key (CRC 1D3D). */
+declare const BRCODE_GOLDEN_STATIC_EVP = "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-4266554400005204000053039865802BR5913Fulano de Tal6008BRASILIA62070503***63041D3D";
+/** Manual de Padrões PIX — dynamic QR with amount (CRC 7309). */
+declare const BRCODE_GOLDEN_DYNAMIC_URL = "00020101021226730014br.gov.bcb.pix2551pix.example.com/v2/8b3da2f39a4140d1a91abd93113bd4415204000053039865406123.455802BR5913Fulano de Tal6008BRASILIA62190515RP12345678-201963047309";
+/** Manual BR Code — composite payload with PIX + other arranjos (CRC AD38). */
+declare const BRCODE_GOLDEN_COMPOSITE = "00020104141234567890123426580014BR.GOV.BCB.PIX0136123e4567-e12b-12d1-a456-42665544000027300012BR.COM.OUTRO011001234567895204000053039865406123.455802BR5917NOME DO RECEBEDOR6008BRASILIA61087007490062190515RP12345678-201980390012BR.COM.OUTRO01190123.ABCD.3456.WXYZ6304AD38";
+/** Golden CPF PIX key 12345678909 — CRC computed per manual algorithm. */
+declare const BRCODE_GOLDEN_STATIC_CPF = "00020126330014br.gov.bcb.pix0111123456789095204000053039865802BR5917NOME DO RECEBEDOR6009SAO PAULO62070503***6304258E";
+/** Golden email pix@bcb.gov.br — CRC computed per manual algorithm. */
+declare const BRCODE_GOLDEN_STATIC_EMAIL = "00020126360014br.gov.bcb.pix0114pix@bcb.gov.br5204000053039865802BR5913Fulano de Tal6008BRASILIA62070503***6304A7E9";
+
+/** CRC16-CCITT-FALSE — polynomial 0x1021, initial 0xFFFF (Bacen Manual BR Code). */
+declare function computeCrc16Ccitt(payload: string): string;
+declare function verifyBrCodeCrc(payload: string): {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+};
+
+type BrCodeParsedFields = {
+    merchantName: string;
+    merchantCity: string;
+    amount?: string;
+    txid?: string;
+    pixKey?: PixKey;
+    pixKeyType?: PixKeyType;
+    pixInitiationUrl?: string;
+};
+type BrCodeParseFailure = {
+    ok: false;
+    code: ValidationErrorCode;
+    message: string;
+};
+type BrCodeParseSuccess = {
+    ok: true;
+    payload: string;
+    fields: BrCodeParsedFields;
+};
+type BrCodeParseResult = BrCodeParseSuccess | BrCodeParseFailure;
+declare function normalizeBrCodePayload(input: string): string;
+declare function parseBrCodePayload(input: string): BrCodeParseResult;
+
+type TlvField = {
+    id: string;
+    value: string;
+};
+type TlvParseFailure = {
+    ok: false;
+    message: string;
+};
+type TlvParseSuccess = {
+    ok: true;
+    fields: TlvField[];
+};
+type TlvParseResult = TlvParseSuccess | TlvParseFailure;
+declare function parseTlvSequence(data: string): TlvParseResult;
+declare function findTlvField(fields: TlvField[], id: string): string | undefined;
+declare function findPixMerchantAccount(fields: TlvField[]): {
+    value: string;
+    nestedFields: TlvField[];
+} | undefined;
+
+/**
+ * BR Code (PIX QR) payload parsing — EMV TLV + CRC16-CCITT.
+ * @see https://www.bcb.gov.br/content/estabilidadefinanceira/spb_docs/ManualBRCode.pdf
+ */
+
+declare function isValidBrCode(input: string): boolean;
+declare function parseBrCode(input: string): BrCodeValidationResult;
+declare function validateBrCode(input: string): BrCodeValidationResult;
+
+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, type BrCodeParseResult, type BrCodeParsedFields, BrCodeValidationResult, PixKeyType, type TlvField, type TlvParseResult, computeCrc16Ccitt, findPixMerchantAccount, findTlvField, isValidBrCode, normalizeBrCodePayload, parseBrCode, parseBrCodePayload, parseTlvSequence, validateBrCode, verifyBrCodeCrc };

package/dist/brcode.js

@@ -0,0 +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, 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-KQDLIGSG.js';
+import './chunk-F6PTZY4O.js';
+import './chunk-UCJPSJN5.js';
+import './chunk-OTZHMJYE.js';
+import './chunk-MSLJF2FM.js';
+//# sourceMappingURL=brcode.js.map
+//# sourceMappingURL=brcode.js.map

package/dist/brcode.js.map

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

package/dist/cartao-credito.d.ts

@@ -1,5 +1,5 @@
-import { c as CartaoCreditoValidationResult, F as FormatResult } from './validation-result-BK4qJuei.js';
-export { C as CartaoCredito, D as DocumentFormat, V as ValidationErrorCode } from './validation-result-BK4qJuei.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-54DTXC6V.js';
-import './chunk-DKRM66US.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 { m as ValidationResult, F as FormatResult } from './validation-result-BK4qJuei.js';
-export { d as Cep, D as DocumentFormat, V as ValidationErrorCode } from './validation-result-BK4qJuei.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-RMKTJQBB.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-DKRM66US.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-RMKTJQBB.js → chunk-2JJS46FM.js}

@@ -1,5 +1,5 @@
-import { stripCep } from './chunk-W6UXVWSR.js';
-import { brandCep } from './chunk-DKRM66US.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-RMKTJQBB.js.map
-//# sourceMappingURL=chunk-RMKTJQBB.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"]}