@br-validators/core 0.12.0-alpha.3 → 1.1.0

package/dist/chunk-ASQ2XIN2.js

@@ -0,0 +1,99 @@
+import { formatTelefone } from './chunk-PNPESCSP.js';
+import { formatTituloEleitor } from './chunk-EVULAGR5.js';
+import { formatIeProdutorRural } from './chunk-54UWHK5L.js';
+import { formatNfeChave } from './chunk-JKDU7QYP.js';
+import { formatPisPasep } from './chunk-VSW3NBJQ.js';
+import { formatPixKey } from './chunk-IYOPXJLY.js';
+import { formatPlaca } from './chunk-YD5MPZWY.js';
+import { formatRenavam } from './chunk-LAEUXOF6.js';
+import { formatCpf } from './chunk-TJCE4TVX.js';
+import { formatInscricaoEstadual } from './chunk-665E36SC.js';
+import { formatBoleto } from './chunk-XWHGXSQV.js';
+import { formatCartaoCredito } from './chunk-B6A7VF4R.js';
+import { formatCep } from './chunk-MESOO5GZ.js';
+import { formatCnh } from './chunk-VWVQWN2G.js';
+import { formatCnpj } from './chunk-RMTHCPIV.js';
+
+// src/mask/index.ts
+var MASKABLE_DOCUMENT_TYPES = [
+  "cpf",
+  "cnpj",
+  "cep",
+  "placa",
+  "pis-pasep",
+  "telefone",
+  "cnh",
+  "renavam",
+  "titulo-eleitor",
+  "nfe-chave",
+  "boleto",
+  "cartao-credito",
+  "inscricao-estadual",
+  "inscricao-estadual-produtor-rural",
+  "pix"
+];
+function isMaskableDocumentType(type) {
+  return MASKABLE_DOCUMENT_TYPES.includes(type);
+}
+function mask(raw, type, options = {}) {
+  if (type === "inscricao-estadual" && !options.uf) {
+    return {
+      ok: false,
+      code: "UNSUPPORTED_FORMAT",
+      message: "UF is required for inscricao-estadual masking"
+    };
+  }
+  return dispatchMask(raw, type, options);
+}
+function maskRuntime(type, raw, options = {}) {
+  if (!isMaskableDocumentType(type)) {
+    return { ok: false, code: "UNSUPPORTED_FORMAT", message: `Unknown document type: ${type}` };
+  }
+  return mask(raw, type, options);
+}
+function dispatchMask(raw, type, options) {
+  switch (type) {
+    case "cpf":
+      return formatCpf(raw);
+    case "cnpj":
+      return formatCnpj(raw);
+    case "cep":
+      return formatCep(raw);
+    case "placa":
+      return formatPlaca(raw);
+    case "pis-pasep":
+      return formatPisPasep(raw);
+    case "telefone":
+      return formatTelefone(raw);
+    case "cnh":
+      return formatCnh(raw);
+    case "renavam":
+      return formatRenavam(raw);
+    case "titulo-eleitor":
+      return formatTituloEleitor(raw);
+    case "nfe-chave":
+      return formatNfeChave(raw);
+    case "boleto":
+      return formatBoleto(raw);
+    case "cartao-credito":
+      return formatCartaoCredito(raw);
+    case "inscricao-estadual":
+      return formatInscricaoEstadual(raw, { uf: options.uf });
+    case "inscricao-estadual-produtor-rural":
+      return formatIeProdutorRural(raw);
+    case "pix":
+      return formatPixKey(raw);
+    default: {
+      const _exhaustive = type;
+      return {
+        ok: false,
+        code: "UNSUPPORTED_FORMAT",
+        message: `Unsupported type: ${String(_exhaustive)}`
+      };
+    }
+  }
+}
+
+export { MASKABLE_DOCUMENT_TYPES, isMaskableDocumentType, mask, maskRuntime };
+//# sourceMappingURL=chunk-ASQ2XIN2.js.map
+//# sourceMappingURL=chunk-ASQ2XIN2.js.map

package/dist/chunk-ASQ2XIN2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mask/index.ts"],"names":[],"mappings":"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","file":"chunk-ASQ2XIN2.js","sourcesContent":["/**\n * Unified display mask — delegates to existing `format*` (BR-MASK-001).\n * @see docs/use-cases/UC-003-format-document.md\n * @see docs/OFFICIAL-SOURCES.md\n */\nimport { formatInscricaoEstadual } from '../core/inscricao-estadual/index.js';\nimport { formatBoleto } from '../format/boleto.js';\nimport { formatCartaoCredito } from '../format/cartao-credito.js';\nimport { formatCep } from '../format/cep.js';\nimport { formatCnh } from '../format/cnh.js';\nimport { formatCnpj } from '../format/cnpj.js';\nimport { formatCpf } from '../format/cpf.js';\nimport { formatIeProdutorRural } from '../format/inscricao-estadual-produtor-rural.js';\nimport { formatNfeChave } from '../format/nfe-chave.js';\nimport { formatPisPasep } from '../format/pis-pasep.js';\nimport { formatPixKey } from '../format/pix.js';\nimport { formatPlaca } from '../format/placa.js';\nimport { formatRenavam } from '../format/renavam.js';\nimport { formatTelefone } from '../format/telefone.js';\nimport { formatTituloEleitor } from '../format/titulo-eleitor.js';\nimport type { FormatResult, UfCode } from '../types/validation-result.js';\n\nexport type MaskableDocumentType =\n  | 'cpf'\n  | 'cnpj'\n  | 'cep'\n  | 'placa'\n  | 'pis-pasep'\n  | 'telefone'\n  | 'cnh'\n  | 'renavam'\n  | 'titulo-eleitor'\n  | 'nfe-chave'\n  | 'boleto'\n  | 'cartao-credito'\n  | 'inscricao-estadual'\n  | 'inscricao-estadual-produtor-rural'\n  | 'pix';\n\nexport const MASKABLE_DOCUMENT_TYPES = [\n  'cpf',\n  'cnpj',\n  'cep',\n  'placa',\n  'pis-pasep',\n  'telefone',\n  'cnh',\n  'renavam',\n  'titulo-eleitor',\n  'nfe-chave',\n  'boleto',\n  'cartao-credito',\n  'inscricao-estadual',\n  'inscricao-estadual-produtor-rural',\n  'pix',\n] as const satisfies readonly MaskableDocumentType[];\n\nexport type MaskOptions = {\n  uf?: UfCode;\n};\n\nexport function isMaskableDocumentType(type: string): type is MaskableDocumentType {\n  return (MASKABLE_DOCUMENT_TYPES as readonly string[]).includes(type);\n}\n\nexport function mask(\n  raw: string,\n  type: MaskableDocumentType,\n  options: MaskOptions = {},\n): FormatResult {\n  if (type === 'inscricao-estadual' && !options.uf) {\n    return {\n      ok: false,\n      code: 'UNSUPPORTED_FORMAT',\n      message: 'UF is required for inscricao-estadual masking',\n    };\n  }\n\n  return dispatchMask(raw, type, options);\n}\n\n/** Runtime guard for dynamic callers (non-exhaustive type string). */\nexport function maskRuntime(\n  type: string,\n  raw: string,\n  options: MaskOptions = {},\n): FormatResult {\n  if (!isMaskableDocumentType(type)) {\n    return { ok: false, code: 'UNSUPPORTED_FORMAT', message: `Unknown document type: ${type}` };\n  }\n  return mask(raw, type, options);\n}\n\nfunction dispatchMask(raw: string, type: MaskableDocumentType, options: MaskOptions): FormatResult {\n  switch (type) {\n    case 'cpf':\n      return formatCpf(raw);\n    case 'cnpj':\n      return formatCnpj(raw);\n    case 'cep':\n      return formatCep(raw);\n    case 'placa':\n      return formatPlaca(raw);\n    case 'pis-pasep':\n      return formatPisPasep(raw);\n    case 'telefone':\n      return formatTelefone(raw);\n    case 'cnh':\n      return formatCnh(raw);\n    case 'renavam':\n      return formatRenavam(raw);\n    case 'titulo-eleitor':\n      return formatTituloEleitor(raw);\n    case 'nfe-chave':\n      return formatNfeChave(raw);\n    case 'boleto':\n      return formatBoleto(raw);\n    case 'cartao-credito':\n      return formatCartaoCredito(raw);\n    case 'inscricao-estadual':\n      return formatInscricaoEstadual(raw, { uf: options.uf as UfCode });\n    case 'inscricao-estadual-produtor-rural':\n      return formatIeProdutorRural(raw);\n    case 'pix':\n      return formatPixKey(raw);\n    default: {\n      const _exhaustive: never = type;\n      return {\n        ok: false,\n        code: 'UNSUPPORTED_FORMAT',\n        message: `Unsupported type: ${String(_exhaustive)}`,\n      };\n    }\n  }\n}\n"]}

package/dist/chunk-AU6TW3GH.js

@@ -0,0 +1,136 @@
+import { validateArrecadacao, validateCodigoBarras } from './chunk-N6RQICAP.js';
+import { detectBoletoInputKind, validateLinhaDigitavel, convertLinhaToCodigoBarrasDigits, convertCodigoBarrasToLinhaDigits, detectBoletoSituacao } from './chunk-E2EFGMWA.js';
+import { brandCodigoBarras, brandLinhaDigitavel } from './chunk-NUQSMT4Y.js';
+
+// src/core/boleto/fator-vencimento.ts
+var FATOR_MIN = 1;
+var FATOR_SEMANTIC_MAX = 9997;
+function validateFatorVencimento(factor) {
+  if (!/^\d{4}$/.test(factor)) {
+    return {
+      ok: false,
+      code: "INVALID_LENGTH",
+      message: "Due-date factor must have exactly 4 digits"
+    };
+  }
+  if (factor === "0000") {
+    return { ok: true, factor, hasDueDate: false };
+  }
+  const days = Number(factor);
+  if (days < FATOR_MIN || days > FATOR_SEMANTIC_MAX) {
+    return {
+      ok: false,
+      code: "UNSUPPORTED_FORMAT",
+      message: "Due-date factor is out of the supported range"
+    };
+  }
+  return { ok: true, factor, hasDueDate: true };
+}
+
+// src/core/boleto/valor-documento.ts
+function validateValorDocumento(value) {
+  if (!/^\d{10}$/.test(value)) {
+    return {
+      ok: false,
+      code: "INVALID_LENGTH",
+      message: "Document amount must have exactly 10 digits (centavos)"
+    };
+  }
+  return { ok: true, amountCents: Number(value) };
+}
+
+// src/core/boleto/semantic.ts
+function failure(code, message, inputKind) {
+  return { ok: false, code, message, inputKind };
+}
+function validateSemanticFields(barcode, options, inputKind) {
+  if (detectBoletoSituacao(barcode) !== "situacao-1") {
+    return null;
+  }
+  if (options.validateDueFactor) {
+    const factorResult = validateFatorVencimento(barcode.slice(5, 9));
+    if (!factorResult.ok) {
+      return failure(factorResult.code, factorResult.message, inputKind);
+    }
+  }
+  if (options.validateAmount && detectBoletoSituacao(barcode) === "situacao-1") {
+    validateValorDocumento(barcode.slice(9, 19));
+  }
+  return null;
+}
+
+// src/core/boleto/index.ts
+function failure2(code, message, inputKind) {
+  return { ok: false, code, message, ...inputKind ? { inputKind } : {} };
+}
+function validateByKind(input, kind, options) {
+  const result = kind === "linha-digitavel" ? validateLinhaDigitavel(input) : validateCodigoBarras(input);
+  if (!result.ok) {
+    return result;
+  }
+  const barcode = kind === "linha-digitavel" ? convertLinhaToCodigoBarrasDigits(result.value) : result.value;
+  const semanticError = validateSemanticFields(barcode, options ?? {}, kind);
+  if (semanticError) {
+    return semanticError;
+  }
+  return result;
+}
+function isValidBoleto(input, options) {
+  return validateBoleto(input, options).ok;
+}
+function validateBoleto(input, options) {
+  const trimmed = input.trim();
+  if (trimmed.length === 0) {
+    return failure2("EMPTY_INPUT", "Boleto input is empty");
+  }
+  const detected = detectBoletoInputKind(trimmed);
+  if (detected === "arrecadacao") {
+    return validateArrecadacao(trimmed);
+  }
+  if (options?.kind !== void 0) {
+    if (detected !== "unknown" && detected !== options.kind) {
+      return failure2(
+        "UNSUPPORTED_FORMAT",
+        `Boleto detected as ${detected} but forced kind is ${options.kind}`,
+        options.kind
+      );
+    }
+    return validateByKind(trimmed, options.kind, options);
+  }
+  if (detected === "unknown") {
+    return failure2("UNSUPPORTED_FORMAT", "Boleto input kind could not be determined");
+  }
+  return validateByKind(trimmed, detected, options);
+}
+function convertLinhaToCodigoBarras(input) {
+  const result = validateLinhaDigitavel(input);
+  if (!result.ok) {
+    return result;
+  }
+  const barcode = convertLinhaToCodigoBarrasDigits(result.value);
+  return {
+    ok: true,
+    value: brandCodigoBarras(barcode),
+    inputKind: "codigo-barras",
+    format: "codigo-barras",
+    situacao: result.situacao
+  };
+}
+function convertCodigoBarrasToLinhaDigitavel(input) {
+  const result = validateCodigoBarras(input);
+  if (!result.ok) {
+    return result;
+  }
+  const linha = convertCodigoBarrasToLinhaDigits(result.value);
+  return {
+    ok: true,
+    value: brandLinhaDigitavel(linha),
+    inputKind: "linha-digitavel",
+    format: "linha-digitavel",
+    situacao: result.situacao
+  };
+}
+
+export { convertCodigoBarrasToLinhaDigitavel, convertLinhaToCodigoBarras, isValidBoleto, validateBoleto, validateFatorVencimento, validateValorDocumento };
+//# sourceMappingURL=chunk-AU6TW3GH.js.map
+//# sourceMappingURL=chunk-AU6TW3GH.js.map

package/dist/chunk-AU6TW3GH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/boleto/fator-vencimento.ts","../src/core/boleto/valor-documento.ts","../src/core/boleto/semantic.ts","../src/core/boleto/index.ts"],"names":["failure"],"mappings":"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","file":"chunk-AU6TW3GH.js","sourcesContent":["/**\n * Due-date factor semantic validation (Situação 1 only).\n * @see BR-BOLETO-012\n */\nimport type { ValidationErrorCode } from '../../types/validation-result.js';\n\nconst FATOR_MIN = 1;\n/** FEBRABAN factor space; values above this fail optional semantic validation. */\nconst FATOR_SEMANTIC_MAX = 9997;\n\nexport type FatorVencimentoValidationResult =\n  | { ok: true; factor: string; hasDueDate: boolean }\n  | { ok: false; code: ValidationErrorCode; message: string };\n\nexport function validateFatorVencimento(factor: string): FatorVencimentoValidationResult {\n  if (!/^\\d{4}$/.test(factor)) {\n    return {\n      ok: false,\n      code: 'INVALID_LENGTH',\n      message: 'Due-date factor must have exactly 4 digits',\n    };\n  }\n\n  if (factor === '0000') {\n    return { ok: true, factor, hasDueDate: false };\n  }\n\n  const days = Number(factor);\n  if (days < FATOR_MIN || days > FATOR_SEMANTIC_MAX) {\n    return {\n      ok: false,\n      code: 'UNSUPPORTED_FORMAT',\n      message: 'Due-date factor is out of the supported range',\n    };\n  }\n\n  return { ok: true, factor, hasDueDate: true };\n}\n","/**\n * Document amount semantic validation (Situação 1 only).\n * @see BR-BOLETO-013\n */\nimport type { ValidationErrorCode } from '../../types/validation-result.js';\n\nexport type ValorDocumentoValidationResult =\n  | { ok: true; amountCents: number }\n  | { ok: false; code: ValidationErrorCode; message: string };\n\nexport function validateValorDocumento(value: string): ValorDocumentoValidationResult {\n  if (!/^\\d{10}$/.test(value)) {\n    return {\n      ok: false,\n      code: 'INVALID_LENGTH',\n      message: 'Document amount must have exactly 10 digits (centavos)',\n    };\n  }\n\n  return { ok: true, amountCents: Number(value) };\n}\n","/**\n * Optional semantic checks for Situação 1 cobrança fields.\n * @see BR-BOLETO-012, BR-BOLETO-013\n */\nimport type { BoletoInputKind, BoletoValidationResult } from '../../types/validation-result.js';\nimport { detectBoletoSituacao } from './detect-situacao.js';\nimport { validateFatorVencimento } from './fator-vencimento.js';\nimport { validateValorDocumento } from './valor-documento.js';\n\nexport type SemanticValidationOptions = {\n  validateDueFactor?: boolean;\n  validateAmount?: boolean;\n};\n\ntype FailedResult = Extract<BoletoValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string, inputKind: BoletoInputKind): FailedResult {\n  return { ok: false, code, message, inputKind };\n}\n\nexport function validateSemanticFields(\n  barcode: string,\n  options: SemanticValidationOptions,\n  inputKind: BoletoInputKind,\n): FailedResult | null {\n  if (detectBoletoSituacao(barcode) !== 'situacao-1') {\n    return null;\n  }\n\n  if (options.validateDueFactor) {\n    const factorResult = validateFatorVencimento(barcode.slice(5, 9));\n    if (!factorResult.ok) {\n      return failure(factorResult.code, factorResult.message, inputKind);\n    }\n  }\n\n  if (options.validateAmount && detectBoletoSituacao(barcode) === 'situacao-1') {\n    validateValorDocumento(barcode.slice(9, 19));\n  }\n\n  return null;\n}\n","/**\n * Boleto validation — linha digitável + código de barras (FEBRABAN cobrança).\n * @see docs/use-cases/UC-007-validate-boleto.md\n */\nimport type { BoletoInputKind, BoletoValidationResult } from '../../types/validation-result.js';\nimport { brandCodigoBarras, brandLinhaDigitavel } from '../../types/validation-result.js';\nimport { validateCodigoBarras } from './codigo-barras.js';\nimport {\n  convertCodigoBarrasToLinhaDigits,\n  convertLinhaToCodigoBarrasDigits,\n} from './convert.js';\nimport { detectBoletoInputKind } from './detect.js';\nimport { validateLinhaDigitavel } from './linha-digitavel.js';\nimport { validateSemanticFields } from './semantic.js';\nimport { validateArrecadacao } from './arrecadacao.js';\n\nexport {\n  BOLETO_CODIGO_BARRAS_LENGTH,\n  BOLETO_CODE_ISPB_HOLDER,\n  BOLETO_CURRENCY_ISPB,\n  BOLETO_CURRENCY_REAL,\n  BOLETO_GOLDEN_CODIGO_BARRAS,\n  BOLETO_GOLDEN_CODIGO_BARRAS_BB,\n  BOLETO_GOLDEN_CODIGO_BARRAS_SITUACAO2,\n  BOLETO_GOLDEN_LINHA_BB_STRIPPED,\n  BOLETO_GOLDEN_LINHA_MASKED,\n  BOLETO_GOLDEN_LINHA_SITUACAO2_STRIPPED,\n  BOLETO_GOLDEN_LINHA_STRIPPED,\n  BOLETO_LAYOUTS_PORTAL_URL,\n  BOLETO_LINHA_LENGTH,\n  BOLETO_OFFICIAL_SOURCE_URL,\n  BOLETO_ARRECADACAO_LINHA_LENGTH,\n  BOLETO_ARRECADACAO_CODIGO_BARRAS_LENGTH,\n  BOLETO_ARRECADACAO_PRODUCT_ID,\n  BOLETO_ARRECADACAO_OFFICIAL_SOURCE_URL,\n} from './constants.js';\nexport { computeModulo10FieldDv } from './modulo10.js';\nexport { computeModulo11BarcodeDv } from './modulo11.js';\nexport { detectBoletoInputKind, type DetectedBoletoInputKind } from './detect.js';\nexport {\n  detectBoletoSituacao,\n  toBoletoSituacaoCode,\n  type BoletoSituacaoCode,\n  type BoletoSituacaoKind,\n} from './detect-situacao.js';\nexport {\n  convertCodigoBarrasToLinhaDigits,\n  convertLinhaToCodigoBarrasDigits,\n} from './convert.js';\nexport {\n  formatLinhaDigitavel,\n  stripLinhaDigitavel,\n  validateLinhaDigitavel,\n} from './linha-digitavel.js';\nexport { applyLinhaDigitavelMask } from './mask.js';\nexport { stripCodigoBarras, validateCodigoBarras } from './codigo-barras.js';\nexport { validateFatorVencimento, type FatorVencimentoValidationResult } from './fator-vencimento.js';\nexport { validateValorDocumento, type ValorDocumentoValidationResult } from './valor-documento.js';\nexport { validateSemanticFields } from './semantic.js';\nexport {\n  buildArrecadacaoGoldenPair,\n  isValidArrecadacao,\n  linhaArrecadacaoToCodigoBarras,\n  stripArrecadacao,\n  validateArrecadacao,\n  validateArrecadacaoCodigoBarras,\n  validateArrecadacaoLinha,\n} from './arrecadacao.js';\nexport type { ArrecadacaoInputKind, ArrecadacaoValidationResult } from './arrecadacao.js';\nexport {\n  computeArrecadacaoModulo10Dv,\n  computeArrecadacaoModulo11Dv,\n  getArrecadacaoDvCalculator,\n  isArrecadacaoValueType,\n} from './arrecadacao-modulo.js';\nexport type { ArrecadacaoValueType } from './arrecadacao-modulo.js';\n\nexport type ValidateBoletoOptions = {\n  kind?: BoletoInputKind;\n  validateDueFactor?: boolean;\n  validateAmount?: boolean;\n};\n\ntype FailedResult = Extract<BoletoValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string, inputKind?: BoletoInputKind): FailedResult {\n  return { ok: false, code, message, ...(inputKind ? { inputKind } : {}) };\n}\n\nfunction validateByKind(input: string, kind: BoletoInputKind, options?: ValidateBoletoOptions): BoletoValidationResult {\n  const result = kind === 'linha-digitavel' ? validateLinhaDigitavel(input) : validateCodigoBarras(input);\n  if (!result.ok) {\n    return result;\n  }\n\n  const barcode =\n    kind === 'linha-digitavel'\n      ? convertLinhaToCodigoBarrasDigits(result.value)\n      : result.value;\n\n  const semanticError = validateSemanticFields(barcode, options ?? {}, kind);\n  if (semanticError) {\n    return semanticError;\n  }\n\n  return result;\n}\n\nexport function isValidBoleto(input: string, options?: ValidateBoletoOptions): boolean {\n  return validateBoleto(input, options).ok;\n}\n\nexport function validateBoleto(input: string, options?: ValidateBoletoOptions): BoletoValidationResult {\n  const trimmed = input.trim();\n  if (trimmed.length === 0) {\n    return failure('EMPTY_INPUT', 'Boleto input is empty');\n  }\n\n  const detected = detectBoletoInputKind(trimmed);\n\n  if (detected === 'arrecadacao') {\n    return validateArrecadacao(trimmed);\n  }\n\n  if (options?.kind !== undefined) {\n    if (detected !== 'unknown' && detected !== options.kind) {\n      return failure(\n        'UNSUPPORTED_FORMAT',\n        `Boleto detected as ${detected} but forced kind is ${options.kind}`,\n        options.kind,\n      );\n    }\n    return validateByKind(trimmed, options.kind, options);\n  }\n\n  if (detected === 'unknown') {\n    return failure('UNSUPPORTED_FORMAT', 'Boleto input kind could not be determined');\n  }\n\n  return validateByKind(trimmed, detected, options);\n}\n\nexport function convertLinhaToCodigoBarras(input: string): BoletoValidationResult {\n  const result = validateLinhaDigitavel(input);\n  if (!result.ok) {\n    return result;\n  }\n  const barcode = convertLinhaToCodigoBarrasDigits(result.value);\n  return {\n    ok: true,\n    value: brandCodigoBarras(barcode),\n    inputKind: 'codigo-barras',\n    format: 'codigo-barras',\n    situacao: result.situacao,\n  };\n}\n\nexport function convertCodigoBarrasToLinhaDigitavel(input: string): BoletoValidationResult {\n  const result = validateCodigoBarras(input);\n  if (!result.ok) {\n    return result;\n  }\n  const linha = convertCodigoBarrasToLinhaDigits(result.value);\n  return {\n    ok: true,\n    value: brandLinhaDigitavel(linha),\n    inputKind: 'linha-digitavel',\n    format: 'linha-digitavel',\n    situacao: result.situacao,\n  };\n}\n"]}

package/dist/{chunk-XW5G2RAL.js → chunk-B6A7VF4R.js}

@@ -1,4 +1,4 @@
-import { validateCartaoCredito, applyCartaoCreditoMask } from './chunk-AK5GVYQ5.js';
+import { validateCartaoCredito, applyCartaoCreditoMask } from './chunk-ANWQBKGN.js';
 
 // src/format/cartao-credito.ts
 function formatCartaoCredito(input) {
@@ -10,5 +10,5 @@ function formatCartaoCredito(input) {
 }
 
 export { formatCartaoCredito };
-//# sourceMappingURL=chunk-XW5G2RAL.js.map
-//# sourceMappingURL=chunk-XW5G2RAL.js.map
+//# sourceMappingURL=chunk-B6A7VF4R.js.map
+//# sourceMappingURL=chunk-B6A7VF4R.js.map

package/dist/{chunk-XW5G2RAL.js.map → chunk-B6A7VF4R.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/format/cartao-credito.ts"],"names":[],"mappings":";;;AAIO,SAAS,oBAAoB,KAAA,EAA6B;AAC/D,EAAA,MAAM,MAAA,GAAS,sBAAsB,KAAK,CAAA;AAC1C,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,sBAAA,CAAuB,MAAA,CAAO,KAAK,CAAA,EAAE;AACrE","file":"chunk-XW5G2RAL.js","sourcesContent":["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"]}
+{"version":3,"sources":["../src/format/cartao-credito.ts"],"names":[],"mappings":";;;AAIO,SAAS,oBAAoB,KAAA,EAA6B;AAC/D,EAAA,MAAM,MAAA,GAAS,sBAAsB,KAAK,CAAA;AAC1C,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,sBAAA,CAAuB,MAAA,CAAO,KAAK,CAAA,EAAE;AACrE","file":"chunk-B6A7VF4R.js","sourcesContent":["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"]}