@br-validators/core 0.10.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BR Validators contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# @br-validators/core
+
+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)
+
+> The unscoped name `br-validators` on npm is a different package. Use **`@br-validators/core`**.
+
+---
+
+## Install
+
+```bash
+npm install @br-validators/core
+```
+
+Requires Node ≥ 18. ESM only (`"type": "module"`).
+
+---
+
+## Supported types
+
+| 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 |
+
+Subpath imports for tree-shaking:
+
+```typescript
+import { validateCnpj } from '@br-validators/core/cnpj';
+import { validateInscricaoEstadual } from '@br-validators/core/inscricao-estadual';
+```
+
+---
+
+## Examples
+
+```typescript
+import { validateCnpj, formatCnpj } from '@br-validators/core';
+
+const result = validateCnpj('12ABC34501DE35');
+// { ok: true, value: '12ABC34501DE35', format: 'alphanumeric', ... }
+
+formatCnpj('12ABC34501DE35');
+// { ok: true, formatted: '12.ABC.345/01DE-35', ... }
+```
+
+```typescript
+import { validateInscricaoEstadual } from '@br-validators/core/inscricao-estadual';
+
+validateInscricaoEstadual('110042490114', { uf: 'SP' });
+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)
+
+Per-type URLs also available via constants (`CNPJ_OFFICIAL_SOURCE_URL`, `IE_OFFICIAL_SOURCE_URLS`, etc.).
+
+---
+
+## API reference
+
+[docs/LIBRARY-API.md](https://github.com/AlexandreZanata/doc-raiz/blob/main/docs/LIBRARY-API.md)
+
+---
+
+## CLI companion
+
+```bash
+npm install -g @br-validators/cli
+br-validators cnpj validate 12ABC34501DE35 --json
+```
+
+---
+
+## License
+
+MIT

package/dist/boleto.d.ts

@@ -0,0 +1,113 @@
+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';
+
+/**
+ * FEBRABAN bank boleto (cobrança) — linha digitável + código de barras.
+ * @see Convenção da Cobrança FB-0061/2021 — Anexos V, VI, IX, X
+ * @see https://cmsarquivos.febraban.org.br/Arquivos/documentos/PDF/Conven%C3%A7%C3%A3o%20da%20Cobran%C3%A7a%20-%2005_02_2021_f.pdf
+ */
+declare const BOLETO_LINHA_LENGTH = 47;
+declare const BOLETO_CODIGO_BARRAS_LENGTH = 44;
+declare const BOLETO_CURRENCY_REAL = "9";
+declare const BOLETO_CODE_ISPB_HOLDER = "988";
+declare const BOLETO_CURRENCY_ISPB = "0";
+declare const BOLETO_GOLDEN_LINHA_MASKED = "03399.02579 08991.834006 71742.301014 6 14500000099668";
+declare const BOLETO_GOLDEN_LINHA_STRIPPED = "03399025790899183400671742301014614500000099668";
+declare const BOLETO_GOLDEN_CODIGO_BARRAS = "03396145000000996689025708991834007174230101";
+declare const BOLETO_GOLDEN_LINHA_BB_STRIPPED = "00191234546789012345767890123457112340000001500";
+declare const BOLETO_GOLDEN_CODIGO_BARRAS_BB = "00191123400000015001234567890123456789012345";
+declare const BOLETO_GOLDEN_LINHA_SITUACAO2_STRIPPED = "98801234516789012345767890123457760746948000112";
+declare const BOLETO_GOLDEN_CODIGO_BARRAS_SITUACAO2 = "98807607469480001121234567890123456789012345";
+declare const BOLETO_OFFICIAL_SOURCE_URL = "https://cmsarquivos.febraban.org.br/Arquivos/documentos/PDF/Conven%C3%A7%C3%A3o%20da%20Cobran%C3%A7a%20-%2005_02_2021_f.pdf";
+declare const BOLETO_LAYOUTS_PORTAL_URL = "https://portal.febraban.org.br/pagina/3425/33/pt-br/layout-febraban";
+
+/**
+ * Modulo 10 — linha digitável field DVs (Anexo IX).
+ */
+declare function computeModulo10FieldDv(digits: string): number;
+
+/**
+ * Modulo 11 — código de barras general DV (Anexo X).
+ */
+declare function computeModulo11BarcodeDv(barcodeWithoutDv: string): number;
+
+type DetectedBoletoInputKind = 'linha-digitavel' | 'codigo-barras' | 'arrecadacao' | 'unknown';
+declare function detectBoletoInputKind(input: string): DetectedBoletoInputKind;
+
+type BoletoSituacaoKind = 'situacao-1' | 'situacao-2' | 'unknown';
+type BoletoSituacaoCode = '1' | '2';
+declare function detectBoletoSituacao(stripped: string): BoletoSituacaoKind;
+
+declare function convertLinhaToCodigoBarrasDigits(strippedLinha: string): string;
+declare function convertCodigoBarrasToLinhaDigits(barcode: string): string;
+
+/** FEBRABAN typable linha digitável mask (47 digits). */
+declare function applyLinhaDigitavelMask(stripped47: string): string;
+/** Backward-compatible alias for applyLinhaDigitavelMask. */
+declare function formatLinhaDigitavel(stripped: string): string;
+
+/**
+ * Linha digitável validation — modulo 10 field DVs (Anexo IX).
+ * @see BR-BOLETO-002, BR-BOLETO-008
+ */
+
+declare function stripLinhaDigitavel(input: string): string;
+declare function validateLinhaDigitavel(input: string): BoletoValidationResult;
+
+/**
+ * Código de barras validation — modulo 11 general DV (Anexo X).
+ * @see BR-BOLETO-003, BR-BOLETO-004, BR-BOLETO-010
+ */
+
+declare function stripCodigoBarras(input: string): string;
+declare function validateCodigoBarras(input: string): BoletoValidationResult;
+
+/**
+ * Due-date factor semantic validation (Situação 1 only).
+ * @see BR-BOLETO-012
+ */
+
+type FatorVencimentoValidationResult = {
+    ok: true;
+    factor: string;
+    hasDueDate: boolean;
+} | {
+    ok: false;
+    code: ValidationErrorCode;
+    message: string;
+};
+declare function validateFatorVencimento(factor: string): FatorVencimentoValidationResult;
+
+/**
+ * Document amount semantic validation (Situação 1 only).
+ * @see BR-BOLETO-013
+ */
+
+type ValorDocumentoValidationResult = {
+    ok: true;
+    amountCents: number;
+} | {
+    ok: false;
+    code: ValidationErrorCode;
+    message: string;
+};
+declare function validateValorDocumento(value: string): ValorDocumentoValidationResult;
+
+/**
+ * Boleto validation — linha digitável + código de barras (FEBRABAN cobrança).
+ * @see docs/use-cases/UC-007-validate-boleto.md
+ */
+
+type ValidateBoletoOptions = {
+    kind?: BoletoInputKind;
+    validateDueFactor?: boolean;
+    validateAmount?: boolean;
+};
+declare function isValidBoleto(input: string, options?: ValidateBoletoOptions): boolean;
+declare function validateBoleto(input: string, options?: ValidateBoletoOptions): BoletoValidationResult;
+declare function convertLinhaToCodigoBarras(input: string): BoletoValidationResult;
+declare function convertCodigoBarrasToLinhaDigitavel(input: string): BoletoValidationResult;
+
+declare function formatBoleto(input: string): FormatResult;
+
+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, BoletoInputKind, type BoletoSituacaoCode, type BoletoSituacaoKind, BoletoValidationResult, type DetectedBoletoInputKind, type FatorVencimentoValidationResult, type ValidateBoletoOptions, ValidationErrorCode, type ValorDocumentoValidationResult, applyLinhaDigitavelMask, computeModulo10FieldDv, computeModulo11BarcodeDv, convertCodigoBarrasToLinhaDigitavel, convertCodigoBarrasToLinhaDigits, convertLinhaToCodigoBarras, convertLinhaToCodigoBarrasDigits, detectBoletoInputKind, detectBoletoSituacao, formatBoleto, formatLinhaDigitavel, isValidBoleto, stripCodigoBarras, stripLinhaDigitavel, validateBoleto, validateCodigoBarras, validateFatorVencimento, validateLinhaDigitavel, validateValorDocumento };

package/dist/boleto.js

@@ -0,0 +1,4 @@
+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';
+//# sourceMappingURL=boleto.js.map
+//# sourceMappingURL=boleto.js.map

package/dist/boleto.js.map

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

package/dist/cartao-credito.d.ts

@@ -0,0 +1,47 @@
+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';
+
+/**
+ * Credit card PAN constants — ISO/IEC 7812-1 Annex B (Luhn).
+ * @see https://www.iso.org/standard/70484.html
+ * @see docs/use-cases/UC-008-validate-cartao-credito.md
+ */
+type CardBrand = 'visa' | 'mastercard' | 'amex' | 'elo' | 'hipercard' | 'unknown';
+declare const CARTAO_PAN_MIN_LENGTH = 8;
+declare const CARTAO_PAN_MAX_LENGTH = 19;
+declare const CARTAO_GOLDEN_VISA = "4111111111111111";
+declare const CARTAO_GOLDEN_MASTERCARD = "5555555555554444";
+declare const CARTAO_GOLDEN_AMEX = "378282246310005";
+declare const CARTAO_GOLDEN_LUHN_WALKTHROUGH = "79927398713";
+declare const CARTAO_GOLDEN_VISA_MASKED = "4111 1111 1111 1111";
+declare const CARTAO_GOLDEN_MIN_LENGTH = "12345674";
+declare const CARTAO_OFFICIAL_SOURCE_URL = "https://www.iso.org/standard/70484.html";
+declare const CARTAO_IEC_SOURCE_URL = "https://webstore.iec.ch/en/publication/59763";
+
+/**
+ * Best-effort card brand from IIN prefix — non-authoritative (BR-LUHN-005).
+ */
+
+declare function detectCardBrand(strippedPan: string): CardBrand;
+
+/**
+ * Luhn checksum — ISO/IEC 7812-1 Annex B (modulus-10 double-add-double).
+ * @see BR-LUHN-003
+ */
+declare function computeLuhnSum(pan: string): number;
+/** ISO/IEC 7812-1 Annex B — returns true when PAN passes Luhn. */
+declare function passesLuhn(pan: string): boolean;
+
+declare function isValidLuhn(input: string): boolean;
+declare function isValidCartaoCredito(input: string): boolean;
+declare function validateCartaoCredito(input: string): CartaoCreditoValidationResult;
+
+/**
+ * Strip credit card PAN mask — digits only (BR-LUHN-001).
+ * @see https://www.iso.org/standard/70484.html
+ */
+declare function stripCartaoCredito(input: string): string;
+
+declare function formatCartaoCredito(input: string): FormatResult;
+
+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, type CardBrand, CartaoCreditoValidationResult, FormatResult, computeLuhnSum, detectCardBrand, formatCartaoCredito, isValidCartaoCredito, isValidLuhn, passesLuhn, stripCartaoCredito, validateCartaoCredito };

package/dist/cartao-credito.js

@@ -0,0 +1,4 @@
+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';
+//# sourceMappingURL=cartao-credito.js.map
+//# sourceMappingURL=cartao-credito.js.map

package/dist/cartao-credito.js.map

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

package/dist/cep.d.ts

@@ -0,0 +1,20 @@
+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';
+
+declare const CEP_GOLDEN_PRIMARY = "01310100";
+declare const CEP_GOLDEN_SECONDARY = "20040020";
+declare const CEP_GOLDEN_PRIMARY_MASKED = "01310-100";
+declare const CEP_OFFICIAL_SOURCE_URL = "https://www.correios.com.br/atendimento/developers/manuais/manual-api-busca-cep";
+
+declare function isValidCep(input: string): boolean;
+declare function validateCep(input: string): ValidationResult;
+
+/**
+ * Strip CEP mask — digits only (BR-CEP-001).
+ * @see https://www.correios.com.br/atendimento/developers/manuais/manual-api-busca-cep
+ */
+declare function stripCep(input: string): string;
+
+declare function formatCep(input: string): FormatResult;
+
+export { CEP_GOLDEN_PRIMARY, CEP_GOLDEN_PRIMARY_MASKED, CEP_GOLDEN_SECONDARY, CEP_OFFICIAL_SOURCE_URL, FormatResult, ValidationResult, formatCep, isValidCep, stripCep, validateCep };

package/dist/cep.js

@@ -0,0 +1,7 @@
+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-EB3G4IG6.js';
+import './chunk-UCJPSJN5.js';
+import './chunk-DKRM66US.js';
+//# sourceMappingURL=cep.js.map
+//# sourceMappingURL=cep.js.map

package/dist/cep.js.map

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

package/dist/chunk-54DTXC6V.js

@@ -0,0 +1,207 @@
+import { brandCartaoCredito } from './chunk-DKRM66US.js';
+
+// src/strip/cartao-credito.ts
+function stripCartaoCredito(input) {
+  return input.replace(/\D/g, "");
+}
+
+// src/core/cartao-credito/constants.ts
+var CARTAO_PAN_MIN_LENGTH = 8;
+var CARTAO_PAN_MAX_LENGTH = 19;
+var CARTAO_GOLDEN_VISA = "4111111111111111";
+var CARTAO_GOLDEN_MASTERCARD = "5555555555554444";
+var CARTAO_GOLDEN_AMEX = "378282246310005";
+var CARTAO_GOLDEN_LUHN_WALKTHROUGH = "79927398713";
+var CARTAO_GOLDEN_VISA_MASKED = "4111 1111 1111 1111";
+var CARTAO_GOLDEN_MIN_LENGTH = "12345674";
+var CARTAO_OFFICIAL_SOURCE_URL = "https://www.iso.org/standard/70484.html";
+var CARTAO_IEC_SOURCE_URL = "https://webstore.iec.ch/en/publication/59763";
+var ELO_IIN_PREFIXES = [
+  "401178",
+  "401179",
+  "431274",
+  "438935",
+  "451416",
+  "457393",
+  "457631",
+  "457632",
+  "504175",
+  "506699",
+  "506770",
+  "509048",
+  "509049",
+  "627780",
+  "636297",
+  "636368",
+  "650031",
+  "650032",
+  "650033",
+  "650035",
+  "650051",
+  "650405",
+  "650439",
+  "650485",
+  "650486",
+  "650487",
+  "650488",
+  "650489",
+  "650490",
+  "650491",
+  "650492",
+  "650493",
+  "650494",
+  "650495",
+  "650496",
+  "650497",
+  "650498",
+  "650499",
+  "651652",
+  "651653",
+  "651654",
+  "651655",
+  "651656",
+  "651657",
+  "651658",
+  "651659",
+  "651660",
+  "655000",
+  "655001"
+];
+var HIPERCARD_IIN_PREFIXES = ["606282", "384100"];
+
+// src/core/cartao-credito/detect-brand.ts
+function detectCardBrand(strippedPan) {
+  for (const prefix of ELO_IIN_PREFIXES) {
+    if (strippedPan.startsWith(prefix)) {
+      return "elo";
+    }
+  }
+  for (const prefix of HIPERCARD_IIN_PREFIXES) {
+    if (strippedPan.startsWith(prefix)) {
+      return "hipercard";
+    }
+  }
+  if (/^3[47]/.test(strippedPan)) {
+    return "amex";
+  }
+  if (/^5[1-5]/.test(strippedPan) || /^2[2-7]/.test(strippedPan)) {
+    return "mastercard";
+  }
+  if (strippedPan.startsWith("4")) {
+    return "visa";
+  }
+  return "unknown";
+}
+
+// src/core/cartao-credito/luhn.ts
+function computeLuhnSum(pan) {
+  let sum = 0;
+  let double = false;
+  for (let i = pan.length - 1; i >= 0; i--) {
+    let digit = Number(pan.charAt(i));
+    if (double) {
+      digit *= 2;
+      if (digit > 9) {
+        digit -= 9;
+      }
+    }
+    sum += digit;
+    double = !double;
+  }
+  return sum;
+}
+function passesLuhn(pan) {
+  return computeLuhnSum(pan) % 10 === 0;
+}
+
+// src/core/cartao-credito/mask.ts
+function applyCartaoCreditoMask(canonical) {
+  if (canonical.length < CARTAO_PAN_MIN_LENGTH || canonical.length > CARTAO_PAN_MAX_LENGTH) {
+    throw new Error(`PAN must have between ${CARTAO_PAN_MIN_LENGTH} and ${CARTAO_PAN_MAX_LENGTH} digits to apply mask`);
+  }
+  if (canonical.length === 15) {
+    return `${canonical.slice(0, 4)} ${canonical.slice(4, 10)} ${canonical.slice(10)}`;
+  }
+  const groups = [];
+  for (let i = 0; i < canonical.length; i += 4) {
+    groups.push(canonical.slice(i, i + 4));
+  }
+  return groups.join(" ");
+}
+
+// src/core/cartao-credito/index.ts
+function failure(code, message) {
+  return { ok: false, code, message };
+}
+function hasRepeatedDigits(value) {
+  const first = value[0];
+  for (let i = 1; i < value.length; i++) {
+    if (value[i] !== first) {
+      return false;
+    }
+  }
+  return true;
+}
+function validateStructure(input, stripped) {
+  if (stripped.length === 0) {
+    return failure("EMPTY_INPUT", "Credit card PAN input is empty");
+  }
+  const withoutMask = input.replace(/[\s-]/g, "");
+  if (/[^0-9]/.test(withoutMask)) {
+    return failure("INVALID_CHARACTER", "Credit card PAN contains invalid characters");
+  }
+  if (stripped.length < CARTAO_PAN_MIN_LENGTH || stripped.length > CARTAO_PAN_MAX_LENGTH) {
+    return failure(
+      "INVALID_LENGTH",
+      `Credit card PAN must have between ${CARTAO_PAN_MIN_LENGTH} and ${CARTAO_PAN_MAX_LENGTH} digits after normalization`
+    );
+  }
+  if (hasRepeatedDigits(stripped)) {
+    return failure("KNOWN_INVALID_PATTERN", "Credit card PAN with all identical digits is invalid");
+  }
+  return null;
+}
+function isValidLuhn(input) {
+  const stripped = stripCartaoCredito(input);
+  if (stripped.length < CARTAO_PAN_MIN_LENGTH || stripped.length > CARTAO_PAN_MAX_LENGTH) {
+    return false;
+  }
+  const withoutMask = input.replace(/[\s-]/g, "");
+  if (/[^0-9]/.test(withoutMask)) {
+    return false;
+  }
+  return passesLuhn(stripped);
+}
+function isValidCartaoCredito(input) {
+  return validateCartaoCredito(input).ok;
+}
+function validateCartaoCredito(input) {
+  const stripped = stripCartaoCredito(input);
+  const structural = validateStructure(input, stripped);
+  if (structural) {
+    return structural;
+  }
+  if (!passesLuhn(stripped)) {
+    return failure("INVALID_CHECK_DIGIT", "Credit card PAN check digit is invalid");
+  }
+  const brand = detectCardBrand(stripped);
+  return {
+    ok: true,
+    value: brandCartaoCredito(stripped),
+    format: "cartao-credito",
+    brand
+  };
+}
+
+// src/format/cartao-credito.ts
+function formatCartaoCredito(input) {
+  const result = validateCartaoCredito(input);
+  if (!result.ok) {
+    return { ok: false, code: result.code, message: result.message };
+  }
+  return { ok: true, formatted: applyCartaoCreditoMask(result.value) };
+}
+
+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 };
+//# sourceMappingURL=chunk-54DTXC6V.js.map
+//# sourceMappingURL=chunk-54DTXC6V.js.map

package/dist/chunk-54DTXC6V.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/strip/cartao-credito.ts","../src/core/cartao-credito/constants.ts","../src/core/cartao-credito/detect-brand.ts","../src/core/cartao-credito/luhn.ts","../src/core/cartao-credito/mask.ts","../src/core/cartao-credito/index.ts","../src/format/cartao-credito.ts"],"names":[],"mappings":"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","file":"chunk-54DTXC6V.js","sourcesContent":["/**\n * Strip credit card PAN mask — digits only (BR-LUHN-001).\n * @see https://www.iso.org/standard/70484.html\n */\nexport function stripCartaoCredito(input: string): string {\n  return input.replace(/\\D/g, '');\n}\n","/**\n * Credit card PAN constants — ISO/IEC 7812-1 Annex B (Luhn).\n * @see https://www.iso.org/standard/70484.html\n * @see docs/use-cases/UC-008-validate-cartao-credito.md\n */\nexport type CardBrand = 'visa' | 'mastercard' | 'amex' | 'elo' | 'hipercard' | 'unknown';\n\nexport const CARTAO_PAN_MIN_LENGTH = 8;\nexport const CARTAO_PAN_MAX_LENGTH = 19;\n\nexport const CARTAO_GOLDEN_VISA = '4111111111111111';\nexport const CARTAO_GOLDEN_MASTERCARD = '5555555555554444';\nexport const CARTAO_GOLDEN_AMEX = '378282246310005';\nexport const CARTAO_GOLDEN_LUHN_WALKTHROUGH = '79927398713';\nexport const CARTAO_GOLDEN_VISA_MASKED = '4111 1111 1111 1111';\nexport const CARTAO_GOLDEN_MIN_LENGTH = '12345674';\n\nexport const CARTAO_OFFICIAL_SOURCE_URL = 'https://www.iso.org/standard/70484.html';\nexport const CARTAO_IEC_SOURCE_URL = 'https://webstore.iec.ch/en/publication/59763';\n\n/** Best-effort IIN prefixes — longest match first (BR-LUHN-005, non-authoritative). */\nexport const ELO_IIN_PREFIXES = [\n  '401178',\n  '401179',\n  '431274',\n  '438935',\n  '451416',\n  '457393',\n  '457631',\n  '457632',\n  '504175',\n  '506699',\n  '506770',\n  '509048',\n  '509049',\n  '627780',\n  '636297',\n  '636368',\n  '650031',\n  '650032',\n  '650033',\n  '650035',\n  '650051',\n  '650405',\n  '650439',\n  '650485',\n  '650486',\n  '650487',\n  '650488',\n  '650489',\n  '650490',\n  '650491',\n  '650492',\n  '650493',\n  '650494',\n  '650495',\n  '650496',\n  '650497',\n  '650498',\n  '650499',\n  '651652',\n  '651653',\n  '651654',\n  '651655',\n  '651656',\n  '651657',\n  '651658',\n  '651659',\n  '651660',\n  '655000',\n  '655001',\n] as const;\n\nexport const HIPERCARD_IIN_PREFIXES = ['606282', '384100'] as const;\n","/**\n * Best-effort card brand from IIN prefix — non-authoritative (BR-LUHN-005).\n */\nimport type { CardBrand } from './constants.js';\nimport { ELO_IIN_PREFIXES, HIPERCARD_IIN_PREFIXES } from './constants.js';\n\nexport type { CardBrand };\n\nexport function detectCardBrand(strippedPan: string): CardBrand {\n  for (const prefix of ELO_IIN_PREFIXES) {\n    if (strippedPan.startsWith(prefix)) {\n      return 'elo';\n    }\n  }\n\n  for (const prefix of HIPERCARD_IIN_PREFIXES) {\n    if (strippedPan.startsWith(prefix)) {\n      return 'hipercard';\n    }\n  }\n\n  if (/^3[47]/.test(strippedPan)) {\n    return 'amex';\n  }\n\n  if (/^5[1-5]/.test(strippedPan) || /^2[2-7]/.test(strippedPan)) {\n    return 'mastercard';\n  }\n\n  if (strippedPan.startsWith('4')) {\n    return 'visa';\n  }\n\n  return 'unknown';\n}\n","/**\n * Luhn checksum — ISO/IEC 7812-1 Annex B (modulus-10 double-add-double).\n * @see BR-LUHN-003\n */\n\nexport function computeLuhnSum(pan: string): number {\n  let sum = 0;\n  let double = false;\n  for (let i = pan.length - 1; i >= 0; i--) {\n    let digit = Number(pan.charAt(i));\n    if (double) {\n      digit *= 2;\n      if (digit > 9) {\n        digit -= 9;\n      }\n    }\n    sum += digit;\n    double = !double;\n  }\n  return sum;\n}\n\n/** ISO/IEC 7812-1 Annex B — returns true when PAN passes Luhn. */\nexport function passesLuhn(pan: string): boolean {\n  return computeLuhnSum(pan) % 10 === 0;\n}\n","import { CARTAO_PAN_MAX_LENGTH, CARTAO_PAN_MIN_LENGTH } from './constants.js';\n\n/** Grouped display mask (BR-LUHN-007). */\nexport function applyCartaoCreditoMask(canonical: string): string {\n  if (canonical.length < CARTAO_PAN_MIN_LENGTH || canonical.length > CARTAO_PAN_MAX_LENGTH) {\n    throw new Error(`PAN must have between ${CARTAO_PAN_MIN_LENGTH} and ${CARTAO_PAN_MAX_LENGTH} digits to apply mask`);\n  }\n\n  if (canonical.length === 15) {\n    return `${canonical.slice(0, 4)} ${canonical.slice(4, 10)} ${canonical.slice(10)}`;\n  }\n\n  const groups: string[] = [];\n  for (let i = 0; i < canonical.length; i += 4) {\n    groups.push(canonical.slice(i, i + 4));\n  }\n  return groups.join(' ');\n}\n","/**\n * Credit card PAN validation — Luhn / ISO/IEC 7812-1 Annex B.\n * @see docs/use-cases/UC-008-validate-cartao-credito.md\n */\nimport { stripCartaoCredito } from '../../strip/cartao-credito.js';\nimport type { CartaoCreditoValidationResult } from '../../types/validation-result.js';\nimport { brandCartaoCredito } from '../../types/validation-result.js';\nimport { detectCardBrand } from './detect-brand.js';\nimport { CARTAO_PAN_MAX_LENGTH, CARTAO_PAN_MIN_LENGTH } from './constants.js';\nimport { passesLuhn } from './luhn.js';\n\nexport {\n  CARTAO_GOLDEN_AMEX,\n  CARTAO_GOLDEN_LUHN_WALKTHROUGH,\n  CARTAO_GOLDEN_MASTERCARD,\n  CARTAO_GOLDEN_MIN_LENGTH,\n  CARTAO_GOLDEN_VISA,\n  CARTAO_GOLDEN_VISA_MASKED,\n  CARTAO_IEC_SOURCE_URL,\n  CARTAO_OFFICIAL_SOURCE_URL,\n  CARTAO_PAN_MAX_LENGTH,\n  CARTAO_PAN_MIN_LENGTH,\n} from './constants.js';\nexport type { CardBrand } from './constants.js';\nexport { detectCardBrand } from './detect-brand.js';\nexport { computeLuhnSum, passesLuhn } from './luhn.js';\nexport { applyCartaoCreditoMask } from './mask.js';\n\ntype FailedResult = Extract<CartaoCreditoValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message };\n}\n\nfunction hasRepeatedDigits(value: string): boolean {\n  const first = value[0];\n  for (let i = 1; i < value.length; i++) {\n    if (value[i] !== first) {\n      return false;\n    }\n  }\n  return true;\n}\n\nfunction validateStructure(input: string, stripped: string): FailedResult | null {\n  if (stripped.length === 0) {\n    return failure('EMPTY_INPUT', 'Credit card PAN input is empty');\n  }\n\n  const withoutMask = input.replace(/[\\s-]/g, '');\n  if (/[^0-9]/.test(withoutMask)) {\n    return failure('INVALID_CHARACTER', 'Credit card PAN contains invalid characters');\n  }\n\n  if (stripped.length < CARTAO_PAN_MIN_LENGTH || stripped.length > CARTAO_PAN_MAX_LENGTH) {\n    return failure(\n      'INVALID_LENGTH',\n      `Credit card PAN must have between ${CARTAO_PAN_MIN_LENGTH} and ${CARTAO_PAN_MAX_LENGTH} digits after normalization`,\n    );\n  }\n\n  if (hasRepeatedDigits(stripped)) {\n    return failure('KNOWN_INVALID_PATTERN', 'Credit card PAN with all identical digits is invalid');\n  }\n\n  return null;\n}\n\nexport function isValidLuhn(input: string): boolean {\n  const stripped = stripCartaoCredito(input);\n  if (stripped.length < CARTAO_PAN_MIN_LENGTH || stripped.length > CARTAO_PAN_MAX_LENGTH) {\n    return false;\n  }\n  const withoutMask = input.replace(/[\\s-]/g, '');\n  if (/[^0-9]/.test(withoutMask)) {\n    return false;\n  }\n  return passesLuhn(stripped);\n}\n\nexport function isValidCartaoCredito(input: string): boolean {\n  return validateCartaoCredito(input).ok;\n}\n\nexport function validateCartaoCredito(input: string): CartaoCreditoValidationResult {\n  const stripped = stripCartaoCredito(input);\n  const structural = validateStructure(input, stripped);\n  if (structural) {\n    return structural;\n  }\n\n  if (!passesLuhn(stripped)) {\n    return failure('INVALID_CHECK_DIGIT', 'Credit card PAN check digit is invalid');\n  }\n\n  const brand = detectCardBrand(stripped);\n  return {\n    ok: true,\n    value: brandCartaoCredito(stripped),\n    format: 'cartao-credito',\n    brand,\n  };\n}\n","import { applyCartaoCreditoMask } from '../core/cartao-credito/mask.js';\nimport { validateCartaoCredito } from '../core/cartao-credito/index.js';\nimport type { FormatResult } from '../types/validation-result.js';\n\nexport function formatCartaoCredito(input: string): FormatResult {\n  const result = validateCartaoCredito(input);\n  if (!result.ok) {\n    return { ok: false, code: result.code, message: result.message };\n  }\n  return { ok: true, formatted: applyCartaoCreditoMask(result.value) };\n}\n"]}

package/dist/chunk-7FOWIH6F.js

@@ -0,0 +1,20 @@
+import { validateCnpj, applyCnpjMask } from './chunk-M66MGLHE.js';
+
+// src/format/cnpj.ts
+function formatCnpj(input) {
+  const result = validateCnpj(input);
+  if (!result.ok) {
+    return { ok: false, code: result.code, message: result.message };
+  }
+  return { ok: true, formatted: applyCnpjMask(result.value) };
+}
+function formatCnpjNumeric(input) {
+  return formatCnpj(input);
+}
+function formatCnpjAlphanumeric(input) {
+  return formatCnpj(input);
+}
+
+export { formatCnpj, formatCnpjAlphanumeric, formatCnpjNumeric };
+//# sourceMappingURL=chunk-7FOWIH6F.js.map
+//# sourceMappingURL=chunk-7FOWIH6F.js.map

package/dist/chunk-7FOWIH6F.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/format/cnpj.ts"],"names":[],"mappings":";;;AAIO,SAAS,WAAW,KAAA,EAA6B;AACtD,EAAA,MAAM,MAAA,GAAS,aAAa,KAAK,CAAA;AACjC,EAAA,IAAI,CAAC,OAAO,EAAA,EAAI;AACd,IAAA,OAAO,EAAE,IAAI,KAAA,EAAO,IAAA,EAAM,OAAO,IAAA,EAAM,OAAA,EAAS,OAAO,OAAA,EAAQ;AAAA,EACjE;AACA,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,WAAW,aAAA,CAAc,MAAA,CAAO,KAAK,CAAA,EAAE;AAC5D;AAEO,SAAS,kBAAkB,KAAA,EAA6B;AAC7D,EAAA,OAAO,WAAW,KAAK,CAAA;AACzB;AAEO,SAAS,uBAAuB,KAAA,EAA6B;AAClE,EAAA,OAAO,WAAW,KAAK,CAAA;AACzB","file":"chunk-7FOWIH6F.js","sourcesContent":["import { applyCnpjMask } from '../core/cnpj/mask.js';\nimport { validateCnpj } from '../core/cnpj/index.js';\nimport type { FormatResult } from '../types/validation-result.js';\n\nexport function formatCnpj(input: string): FormatResult {\n  const result = validateCnpj(input);\n  if (!result.ok) {\n    return { ok: false, code: result.code, message: result.message };\n  }\n  return { ok: true, formatted: applyCnpjMask(result.value) };\n}\n\nexport function formatCnpjNumeric(input: string): FormatResult {\n  return formatCnpj(input);\n}\n\nexport function formatCnpjAlphanumeric(input: string): FormatResult {\n  return formatCnpj(input);\n}\n"]}