@br-validators/core 0.10.0-alpha.0

package/dist/chunk-SE33CFGM.js

@@ -0,0 +1,276 @@
+import { validateCnpj, applyCnpjMask, detectCnpjFormat } from './chunk-M66MGLHE.js';
+import { stripCnpj } from './chunk-EB3G4IG6.js';
+import { validateCpf, applyCpfMask } from './chunk-PBNVKDCF.js';
+import { stripCpf } from './chunk-UCJPSJN5.js';
+import { brandPixKey } from './chunk-DKRM66US.js';
+
+// src/core/pix/cnpj.ts
+function failure(code, message) {
+  return { ok: false, code, message, keyType: "cnpj" };
+}
+function validatePixCnpjKey(input) {
+  const trimmed = input.trim();
+  if (trimmed.length === 0) {
+    return failure("EMPTY_INPUT", "PIX CNPJ key input is empty");
+  }
+  const result = validateCnpj(trimmed);
+  if (!result.ok) {
+    return { ok: false, code: result.code, message: result.message, keyType: "cnpj" };
+  }
+  return {
+    ok: true,
+    value: brandPixKey(result.value),
+    keyType: "cnpj",
+    format: result.format
+  };
+}
+
+// src/core/pix/cpf.ts
+function failure2(code, message) {
+  return { ok: false, code, message, keyType: "cpf" };
+}
+function validatePixCpfKey(input) {
+  const trimmed = input.trim();
+  if (trimmed.length === 0) {
+    return failure2("EMPTY_INPUT", "PIX CPF key input is empty");
+  }
+  const result = validateCpf(trimmed);
+  if (!result.ok) {
+    return { ok: false, code: result.code, message: result.message, keyType: "cpf" };
+  }
+  return {
+    ok: true,
+    value: brandPixKey(result.value),
+    keyType: "cpf",
+    format: result.format
+  };
+}
+
+// src/core/pix/constants.ts
+var PIX_EMAIL_MAX_LENGTH = 77;
+var PIX_EMAIL_PATTERN = /^[a-z0-9.!#$'*+/=?^_`{|}~-]+@[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)*$/;
+var PIX_PHONE_E164_PATTERN = /^\+[1-9]\d{1,14}$/;
+var PIX_PHONE_BR_MOBILE_PATTERN = /^\+55\d{2}9\d{8}$/;
+var PIX_EVP_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+var PIX_CPF_DIGITS_PATTERN = /^[0-9]{11}$/;
+var PIX_GOLDEN_CPF = "12345678909";
+var PIX_GOLDEN_CNPJ_NUMERIC = "11222333000181";
+var PIX_GOLDEN_CNPJ_ALPHANUMERIC = "12ABC34501DE35";
+var PIX_GOLDEN_EMAIL = "pix@bcb.gov.br";
+var PIX_GOLDEN_PHONE = "+5510998765432";
+var PIX_GOLDEN_EVP = "123e4567-e89b-12d3-a456-426655440000";
+var PIX_OFFICIAL_SOURCE_URL = "https://www.bcb.gov.br/content/estabilidadefinanceira/pix/Regulamento_Pix/II_ManualdePadroesparaIniciacaodoPix.pdf";
+var PIX_DICT_API_SOURCE_URL = "https://aprendervalor.bcb.gov.br/content/estabilidadefinanceira/pix/API-DICT_v2-9-0.html";
+
+// src/core/pix/detect.ts
+function isCpfShapedInput(input) {
+  const trimmed = input.trim();
+  const stripped = stripCpf(trimmed);
+  if (!PIX_CPF_DIGITS_PATTERN.test(stripped)) {
+    return false;
+  }
+  return /^[\d.\-\s]+$/.test(trimmed);
+}
+function isCnpjShapedInput(input) {
+  const trimmed = input.trim();
+  const stripped = stripCnpj(trimmed);
+  if (detectCnpjFormat(stripped) === "unknown") {
+    return false;
+  }
+  return /^[A-Za-z0-9./\-\s]+$/.test(trimmed);
+}
+function detectPixKeyType(input) {
+  const trimmed = input.trim();
+  if (trimmed.length === 0) {
+    return "unknown";
+  }
+  if (trimmed.includes("@")) {
+    return "email";
+  }
+  if (trimmed.startsWith("+")) {
+    return "phone";
+  }
+  if (PIX_EVP_PATTERN.test(trimmed)) {
+    return "evp";
+  }
+  if (isCpfShapedInput(trimmed)) {
+    return "cpf";
+  }
+  if (isCnpjShapedInput(trimmed)) {
+    return "cnpj";
+  }
+  return "unknown";
+}
+
+// src/core/pix/email.ts
+function failure3(code, message) {
+  return { ok: false, code, message, keyType: "email" };
+}
+function validatePixEmailKey(input) {
+  const trimmed = input.trim();
+  if (trimmed.length === 0) {
+    return failure3("EMPTY_INPUT", "PIX email key input is empty");
+  }
+  if (trimmed !== trimmed.toLowerCase()) {
+    return failure3("INVALID_CHARACTER", "PIX email key must be lowercase");
+  }
+  if (trimmed.length > PIX_EMAIL_MAX_LENGTH) {
+    return failure3("INVALID_LENGTH", `PIX email key must have at most ${PIX_EMAIL_MAX_LENGTH} characters`);
+  }
+  if (!trimmed.includes("@") || !PIX_EMAIL_PATTERN.test(trimmed)) {
+    return failure3("UNSUPPORTED_FORMAT", "PIX email key format is invalid");
+  }
+  return {
+    ok: true,
+    value: brandPixKey(trimmed),
+    keyType: "email",
+    format: "email"
+  };
+}
+
+// src/core/pix/evp.ts
+function failure4(code, message) {
+  return { ok: false, code, message, keyType: "evp" };
+}
+function validatePixEvpKey(input) {
+  const trimmed = input.trim();
+  if (trimmed.length === 0) {
+    return failure4("EMPTY_INPUT", "PIX EVP key input is empty");
+  }
+  if (trimmed !== trimmed.toLowerCase()) {
+    return failure4("INVALID_CHARACTER", "PIX EVP key must be lowercase");
+  }
+  if (!PIX_EVP_PATTERN.test(trimmed)) {
+    return failure4("UNSUPPORTED_FORMAT", "PIX EVP key must be a lowercase UUID with hyphens");
+  }
+  return {
+    ok: true,
+    value: brandPixKey(trimmed),
+    keyType: "evp",
+    format: "evp"
+  };
+}
+
+// src/core/pix/phone.ts
+function failure5(code, message) {
+  return { ok: false, code, message, keyType: "phone" };
+}
+function validatePixPhoneKey(input) {
+  const trimmed = input.trim();
+  if (trimmed.length === 0) {
+    return failure5("EMPTY_INPUT", "PIX phone key input is empty");
+  }
+  if (!trimmed.startsWith("+")) {
+    return failure5("INVALID_CHARACTER", "PIX phone key must start with + (E.164)");
+  }
+  if (!PIX_PHONE_E164_PATTERN.test(trimmed)) {
+    return failure5("INVALID_CHARACTER", "PIX phone key contains invalid characters");
+  }
+  if (!trimmed.startsWith("+55")) {
+    return failure5("UNSUPPORTED_FORMAT", "PIX phone key must use Brazilian country code +55");
+  }
+  if (!PIX_PHONE_BR_MOBILE_PATTERN.test(trimmed)) {
+    return failure5("UNSUPPORTED_FORMAT", "PIX phone key must match Brazilian mobile format +55DD9XXXXXXXX");
+  }
+  return {
+    ok: true,
+    value: brandPixKey(trimmed),
+    keyType: "phone",
+    format: "phone"
+  };
+}
+
+// src/core/pix/mask.ts
+function applyPixCpfKeyMask(canonical) {
+  return applyCpfMask(canonical);
+}
+function applyPixCnpjKeyMask(canonical) {
+  return applyCnpjMask(canonical);
+}
+function applyPixPhoneKeyMask(e164) {
+  const match = /^\+55(\d{2})(9\d{4})(\d{4})$/.exec(e164);
+  if (!match) {
+    throw new Error("PIX phone key must be a validated Brazilian mobile E.164 number");
+  }
+  return `+55 (${match[1]}) ${match[2]}-${match[3]}`;
+}
+function applyPixEmailKeyMask(email) {
+  return email.toLowerCase().trim();
+}
+function applyPixEvpKeyMask(uuid) {
+  return uuid.toLowerCase();
+}
+
+// src/core/pix/index.ts
+function failure6(code, message, keyType) {
+  return { ok: false, code, message, ...keyType ? { keyType } : {} };
+}
+function validateByType(input, keyType) {
+  switch (keyType) {
+    case "cpf":
+      return validatePixCpfKey(input);
+    case "cnpj":
+      return validatePixCnpjKey(input);
+    case "email":
+      return validatePixEmailKey(input);
+    case "phone":
+      return validatePixPhoneKey(input);
+    case "evp":
+      return validatePixEvpKey(input);
+    default: {
+      const _exhaustive = keyType;
+      return failure6("UNSUPPORTED_FORMAT", `Unknown PIX key type: ${_exhaustive}`);
+    }
+  }
+}
+function isValidPixKey(input, options) {
+  return validatePixKey(input, options).ok;
+}
+function validatePixKey(input, options) {
+  const trimmed = input.trim();
+  if (trimmed.length === 0) {
+    return failure6("EMPTY_INPUT", "PIX key input is empty");
+  }
+  const detected = detectPixKeyType(trimmed);
+  if (options?.type !== void 0) {
+    if (detected !== "unknown" && detected !== options.type) {
+      return failure6(
+        "UNSUPPORTED_FORMAT",
+        `PIX key detected as ${detected} but forced type is ${options.type}`,
+        options.type
+      );
+    }
+    return validateByType(trimmed, options.type);
+  }
+  if (detected === "unknown") {
+    return failure6("UNSUPPORTED_FORMAT", "PIX key type could not be determined");
+  }
+  return validateByType(trimmed, detected);
+}
+
+// src/format/pix.ts
+function applyPixMask(keyType, value) {
+  switch (keyType) {
+    case "cpf":
+      return applyPixCpfKeyMask(value);
+    case "cnpj":
+      return applyPixCnpjKeyMask(value);
+    case "phone":
+      return applyPixPhoneKeyMask(value);
+    case "email":
+      return applyPixEmailKeyMask(value);
+    case "evp":
+      return applyPixEvpKeyMask(value);
+  }
+}
+function formatPixKey(input, options) {
+  const result = validatePixKey(input, options);
+  if (!result.ok) {
+    return { ok: false, code: result.code, message: result.message };
+  }
+  return { ok: true, formatted: applyPixMask(result.keyType, result.value) };
+}
+
+export { PIX_DICT_API_SOURCE_URL, PIX_GOLDEN_CNPJ_ALPHANUMERIC, PIX_GOLDEN_CNPJ_NUMERIC, PIX_GOLDEN_CPF, PIX_GOLDEN_EMAIL, PIX_GOLDEN_EVP, PIX_GOLDEN_PHONE, PIX_OFFICIAL_SOURCE_URL, applyPixCnpjKeyMask, applyPixCpfKeyMask, applyPixEmailKeyMask, applyPixEvpKeyMask, applyPixPhoneKeyMask, detectPixKeyType, formatPixKey, isValidPixKey, validatePixCnpjKey, validatePixCpfKey, validatePixEmailKey, validatePixEvpKey, validatePixKey, validatePixPhoneKey };
+//# sourceMappingURL=chunk-SE33CFGM.js.map
+//# sourceMappingURL=chunk-SE33CFGM.js.map

package/dist/chunk-SE33CFGM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/pix/cnpj.ts","../src/core/pix/cpf.ts","../src/core/pix/constants.ts","../src/core/pix/detect.ts","../src/core/pix/email.ts","../src/core/pix/evp.ts","../src/core/pix/phone.ts","../src/core/pix/mask.ts","../src/core/pix/index.ts","../src/format/pix.ts"],"names":["failure"],"mappings":"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","file":"chunk-SE33CFGM.js","sourcesContent":["import { validateCnpj } from '../cnpj/index.js';\nimport type { PixValidationResult } from '../../types/validation-result.js';\nimport { brandPixKey } from '../../types/validation-result.js';\n\ntype FailedResult = Extract<PixValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message, keyType: 'cnpj' };\n}\n\nexport function validatePixCnpjKey(input: string): PixValidationResult {\n  const trimmed = input.trim();\n  if (trimmed.length === 0) {\n    return failure('EMPTY_INPUT', 'PIX CNPJ key input is empty');\n  }\n\n  const result = validateCnpj(trimmed);\n  if (!result.ok) {\n    return { ok: false, code: result.code, message: result.message, keyType: 'cnpj' };\n  }\n\n  return {\n    ok: true,\n    value: brandPixKey(result.value),\n    keyType: 'cnpj',\n    format: result.format,\n  };\n}\n","import { validateCpf } from '../cpf/index.js';\nimport type { PixValidationResult } from '../../types/validation-result.js';\nimport { brandPixKey } from '../../types/validation-result.js';\n\ntype FailedResult = Extract<PixValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message, keyType: 'cpf' };\n}\n\nexport function validatePixCpfKey(input: string): PixValidationResult {\n  const trimmed = input.trim();\n  if (trimmed.length === 0) {\n    return failure('EMPTY_INPUT', 'PIX CPF key input is empty');\n  }\n\n  const result = validateCpf(trimmed);\n  if (!result.ok) {\n    return { ok: false, code: result.code, message: result.message, keyType: 'cpf' };\n  }\n\n  return {\n    ok: true,\n    value: brandPixKey(result.value),\n    keyType: 'cpf',\n    format: result.format,\n  };\n}\n","/**\n * PIX key constants — Bacen DICT API + Manual de Iniciação do Pix.\n * @see https://aprendervalor.bcb.gov.br/content/estabilidadefinanceira/pix/API-DICT_v2-9-0.html\n * @see https://www.bcb.gov.br/content/estabilidadefinanceira/pix/Regulamento_Pix/II_ManualdePadroesparaIniciacaodoPix.pdf\n * @see docs/use-cases/UC-005-validate-pix-key.md\n */\nexport const PIX_EMAIL_MAX_LENGTH = 77;\nexport const PIX_EMAIL_PATTERN =\n  /^[a-z0-9.!#$'*+/=?^_`{|}~-]+@[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)*$/;\n\nexport const PIX_PHONE_E164_PATTERN = /^\\+[1-9]\\d{1,14}$/;\nexport const PIX_PHONE_BR_MOBILE_PATTERN = /^\\+55\\d{2}9\\d{8}$/;\n\nexport const PIX_EVP_PATTERN =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;\n\nexport const PIX_CPF_DIGITS_PATTERN = /^[0-9]{11}$/;\n\nexport const PIX_GOLDEN_CPF = '12345678909';\nexport const PIX_GOLDEN_CNPJ_NUMERIC = '11222333000181';\nexport const PIX_GOLDEN_CNPJ_ALPHANUMERIC = '12ABC34501DE35';\nexport const PIX_GOLDEN_EMAIL = 'pix@bcb.gov.br';\nexport const PIX_GOLDEN_PHONE = '+5510998765432';\nexport const PIX_GOLDEN_PHONE_SECONDARY = '+5561912345678';\nexport const PIX_GOLDEN_EVP = '123e4567-e89b-12d3-a456-426655440000';\nexport const PIX_GOLDEN_EMAIL_SECONDARY = 'fulano_da_silva.recebedor@example.com';\n\nexport const PIX_OFFICIAL_SOURCE_URL =\n  'https://www.bcb.gov.br/content/estabilidadefinanceira/pix/Regulamento_Pix/II_ManualdePadroesparaIniciacaodoPix.pdf';\n\nexport const PIX_DICT_API_SOURCE_URL =\n  'https://aprendervalor.bcb.gov.br/content/estabilidadefinanceira/pix/API-DICT_v2-9-0.html';\n","import { stripCnpj } from '../../strip/cnpj.js';\nimport { stripCpf } from '../../strip/cpf.js';\nimport type { PixKeyType } from '../../types/validation-result.js';\nimport { detectCnpjFormat } from '../cnpj/detect.js';\nimport {\n  PIX_CPF_DIGITS_PATTERN,\n  PIX_EVP_PATTERN,\n} from './constants.js';\n\nexport type DetectedPixKeyType = PixKeyType | 'unknown';\n\nfunction isCpfShapedInput(input: string): boolean {\n  const trimmed = input.trim();\n  const stripped = stripCpf(trimmed);\n  if (!PIX_CPF_DIGITS_PATTERN.test(stripped)) {\n    return false;\n  }\n  return /^[\\d.\\-\\s]+$/.test(trimmed);\n}\n\nfunction isCnpjShapedInput(input: string): boolean {\n  const trimmed = input.trim();\n  const stripped = stripCnpj(trimmed);\n  if (detectCnpjFormat(stripped) === 'unknown') {\n    return false;\n  }\n  return /^[A-Za-z0-9./\\-\\s]+$/.test(trimmed);\n}\n\nexport function detectPixKeyType(input: string): DetectedPixKeyType {\n  const trimmed = input.trim();\n  if (trimmed.length === 0) {\n    return 'unknown';\n  }\n\n  if (trimmed.includes('@')) {\n    return 'email';\n  }\n\n  if (trimmed.startsWith('+')) {\n    return 'phone';\n  }\n\n  if (PIX_EVP_PATTERN.test(trimmed)) {\n    return 'evp';\n  }\n\n  if (isCpfShapedInput(trimmed)) {\n    return 'cpf';\n  }\n\n  if (isCnpjShapedInput(trimmed)) {\n    return 'cnpj';\n  }\n\n  return 'unknown';\n}\n","import type { PixValidationResult } from '../../types/validation-result.js';\nimport { brandPixKey } from '../../types/validation-result.js';\nimport { PIX_EMAIL_MAX_LENGTH, PIX_EMAIL_PATTERN } from './constants.js';\n\ntype FailedResult = Extract<PixValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message, keyType: 'email' };\n}\n\nexport function validatePixEmailKey(input: string): PixValidationResult {\n  const trimmed = input.trim();\n  if (trimmed.length === 0) {\n    return failure('EMPTY_INPUT', 'PIX email key input is empty');\n  }\n\n  if (trimmed !== trimmed.toLowerCase()) {\n    return failure('INVALID_CHARACTER', 'PIX email key must be lowercase');\n  }\n\n  if (trimmed.length > PIX_EMAIL_MAX_LENGTH) {\n    return failure('INVALID_LENGTH', `PIX email key must have at most ${PIX_EMAIL_MAX_LENGTH} characters`);\n  }\n\n  if (!trimmed.includes('@') || !PIX_EMAIL_PATTERN.test(trimmed)) {\n    return failure('UNSUPPORTED_FORMAT', 'PIX email key format is invalid');\n  }\n\n  return {\n    ok: true,\n    value: brandPixKey(trimmed),\n    keyType: 'email',\n    format: 'email',\n  };\n}\n","import type { PixValidationResult } from '../../types/validation-result.js';\nimport { brandPixKey } from '../../types/validation-result.js';\nimport { PIX_EVP_PATTERN } from './constants.js';\n\ntype FailedResult = Extract<PixValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message, keyType: 'evp' };\n}\n\nexport function validatePixEvpKey(input: string): PixValidationResult {\n  const trimmed = input.trim();\n  if (trimmed.length === 0) {\n    return failure('EMPTY_INPUT', 'PIX EVP key input is empty');\n  }\n\n  if (trimmed !== trimmed.toLowerCase()) {\n    return failure('INVALID_CHARACTER', 'PIX EVP key must be lowercase');\n  }\n\n  if (!PIX_EVP_PATTERN.test(trimmed)) {\n    return failure('UNSUPPORTED_FORMAT', 'PIX EVP key must be a lowercase UUID with hyphens');\n  }\n\n  return {\n    ok: true,\n    value: brandPixKey(trimmed),\n    keyType: 'evp',\n    format: 'evp',\n  };\n}\n","import type { PixValidationResult } from '../../types/validation-result.js';\nimport { brandPixKey } from '../../types/validation-result.js';\nimport { PIX_PHONE_BR_MOBILE_PATTERN, PIX_PHONE_E164_PATTERN } from './constants.js';\n\ntype FailedResult = Extract<PixValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message, keyType: 'phone' };\n}\n\nexport function validatePixPhoneKey(input: string): PixValidationResult {\n  const trimmed = input.trim();\n  if (trimmed.length === 0) {\n    return failure('EMPTY_INPUT', 'PIX phone key input is empty');\n  }\n\n  if (!trimmed.startsWith('+')) {\n    return failure('INVALID_CHARACTER', 'PIX phone key must start with + (E.164)');\n  }\n\n  if (!PIX_PHONE_E164_PATTERN.test(trimmed)) {\n    return failure('INVALID_CHARACTER', 'PIX phone key contains invalid characters');\n  }\n\n  if (!trimmed.startsWith('+55')) {\n    return failure('UNSUPPORTED_FORMAT', 'PIX phone key must use Brazilian country code +55');\n  }\n\n  if (!PIX_PHONE_BR_MOBILE_PATTERN.test(trimmed)) {\n    return failure('UNSUPPORTED_FORMAT', 'PIX phone key must match Brazilian mobile format +55DD9XXXXXXXX');\n  }\n\n  return {\n    ok: true,\n    value: brandPixKey(trimmed),\n    keyType: 'phone',\n    format: 'phone',\n  };\n}\n","/**\n * PIX key display masks — delegates to parent validators where applicable (BR-PIX-001…005).\n * @see docs/use-cases/UC-003-format-document.md\n */\nimport { applyCnpjMask } from '../cnpj/mask.js';\nimport { applyCpfMask } from '../cpf/mask.js';\n\nexport function applyPixCpfKeyMask(canonical: string): string {\n  return applyCpfMask(canonical);\n}\n\nexport function applyPixCnpjKeyMask(canonical: string): string {\n  return applyCnpjMask(canonical);\n}\n\n/** Brazilian mobile E.164 → +55 (DD) 9XXXX-XXXX display. */\nexport function applyPixPhoneKeyMask(e164: string): string {\n  const match = /^\\+55(\\d{2})(9\\d{4})(\\d{4})$/.exec(e164);\n  if (!match) {\n    throw new Error('PIX phone key must be a validated Brazilian mobile E.164 number');\n  }\n  return `+55 (${match[1]}) ${match[2]}-${match[3]}`;\n}\n\nexport function applyPixEmailKeyMask(email: string): string {\n  return email.toLowerCase().trim();\n}\n\nexport function applyPixEvpKeyMask(uuid: string): string {\n  return uuid.toLowerCase();\n}\n","/**\n * PIX key validation — five Bacen types (CPF, CNPJ, email, phone, EVP).\n * @see docs/use-cases/UC-005-validate-pix-key.md\n */\nimport type { PixKeyType, PixValidationResult } from '../../types/validation-result.js';\nimport { validatePixCnpjKey } from './cnpj.js';\nimport { validatePixCpfKey } from './cpf.js';\nimport { detectPixKeyType } from './detect.js';\nimport { validatePixEmailKey } from './email.js';\nimport { validatePixEvpKey } from './evp.js';\nimport { validatePixPhoneKey } from './phone.js';\n\nexport {\n  PIX_DICT_API_SOURCE_URL,\n  PIX_GOLDEN_CNPJ_ALPHANUMERIC,\n  PIX_GOLDEN_CNPJ_NUMERIC,\n  PIX_GOLDEN_CPF,\n  PIX_GOLDEN_EMAIL,\n  PIX_GOLDEN_EMAIL_SECONDARY,\n  PIX_GOLDEN_EVP,\n  PIX_GOLDEN_PHONE,\n  PIX_GOLDEN_PHONE_SECONDARY,\n  PIX_OFFICIAL_SOURCE_URL,\n} from './constants.js';\nexport { detectPixKeyType, type DetectedPixKeyType } from './detect.js';\nexport { validatePixCpfKey } from './cpf.js';\nexport { validatePixCnpjKey } from './cnpj.js';\nexport { validatePixEmailKey } from './email.js';\nexport { validatePixPhoneKey } from './phone.js';\nexport { validatePixEvpKey } from './evp.js';\nexport {\n  applyPixCnpjKeyMask,\n  applyPixCpfKeyMask,\n  applyPixEmailKeyMask,\n  applyPixEvpKeyMask,\n  applyPixPhoneKeyMask,\n} from './mask.js';\n\nexport type ValidatePixKeyOptions = {\n  type?: PixKeyType;\n};\n\ntype FailedResult = Extract<PixValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string, keyType?: PixKeyType): FailedResult {\n  return { ok: false, code, message, ...(keyType ? { keyType } : {}) };\n}\n\nfunction validateByType(input: string, keyType: PixKeyType): PixValidationResult {\n  switch (keyType) {\n    case 'cpf':\n      return validatePixCpfKey(input);\n    case 'cnpj':\n      return validatePixCnpjKey(input);\n    case 'email':\n      return validatePixEmailKey(input);\n    case 'phone':\n      return validatePixPhoneKey(input);\n    case 'evp':\n      return validatePixEvpKey(input);\n    default: {\n      const _exhaustive: never = keyType;\n      return failure('UNSUPPORTED_FORMAT', `Unknown PIX key type: ${_exhaustive}`);\n    }\n  }\n}\n\nexport function isValidPixKey(input: string, options?: ValidatePixKeyOptions): boolean {\n  return validatePixKey(input, options).ok;\n}\n\nexport function validatePixKey(input: string, options?: ValidatePixKeyOptions): PixValidationResult {\n  const trimmed = input.trim();\n  if (trimmed.length === 0) {\n    return failure('EMPTY_INPUT', 'PIX key input is empty');\n  }\n\n  const detected = detectPixKeyType(trimmed);\n\n  if (options?.type !== undefined) {\n    if (detected !== 'unknown' && detected !== options.type) {\n      return failure(\n        'UNSUPPORTED_FORMAT',\n        `PIX key detected as ${detected} but forced type is ${options.type}`,\n        options.type,\n      );\n    }\n    return validateByType(trimmed, options.type);\n  }\n\n  if (detected === 'unknown') {\n    return failure('UNSUPPORTED_FORMAT', 'PIX key type could not be determined');\n  }\n\n  return validateByType(trimmed, detected);\n}\n","/**\n * Format decorator — strip → validate → apply official mask (UC-003).\n * @see docs/use-cases/UC-003-format-document.md\n * @see docs/VALIDATION-RULES.md BR-GLOBAL-002\n */\nimport type { ValidatePixKeyOptions } from '../core/pix/index.js';\nimport { validatePixKey } from '../core/pix/index.js';\nimport {\n  applyPixCnpjKeyMask,\n  applyPixCpfKeyMask,\n  applyPixEmailKeyMask,\n  applyPixEvpKeyMask,\n  applyPixPhoneKeyMask,\n} from '../core/pix/mask.js';\nimport type { FormatResult, PixKeyType } from '../types/validation-result.js';\n\nfunction applyPixMask(keyType: PixKeyType, value: string): string {\n  switch (keyType) {\n    case 'cpf':\n      return applyPixCpfKeyMask(value);\n    case 'cnpj':\n      return applyPixCnpjKeyMask(value);\n    case 'phone':\n      return applyPixPhoneKeyMask(value);\n    case 'email':\n      return applyPixEmailKeyMask(value);\n    case 'evp':\n      return applyPixEvpKeyMask(value);\n  }\n}\n\nexport function formatPixKey(input: string, options?: ValidatePixKeyOptions): FormatResult {\n  const result = validatePixKey(input, options);\n  if (!result.ok) {\n    return { ok: false, code: result.code, message: result.message };\n  }\n\n  return { ok: true, formatted: applyPixMask(result.keyType, result.value) };\n}\n"]}

package/dist/chunk-UCJPSJN5.js

@@ -0,0 +1,8 @@
+// src/strip/cpf.ts
+function stripCpf(input) {
+  return input.replace(/\D/g, "");
+}
+
+export { stripCpf };
+//# sourceMappingURL=chunk-UCJPSJN5.js.map
+//# sourceMappingURL=chunk-UCJPSJN5.js.map

package/dist/chunk-UCJPSJN5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/strip/cpf.ts"],"names":[],"mappings":";AAIO,SAAS,SAAS,KAAA,EAAuB;AAC9C,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AAChC","file":"chunk-UCJPSJN5.js","sourcesContent":["/**\n * Strip CPF mask — digits only (BR-CPF-002).\n * @see https://www.gov.br/receitafederal/pt-br/assuntos/cpf\n */\nexport function stripCpf(input: string): string {\n  return input.replace(/\\D/g, '');\n}\n"]}

package/dist/chunk-W6UXVWSR.js

@@ -0,0 +1,13 @@
+// src/strip/cep.ts
+function stripCep(input) {
+  return input.replace(/\D/g, "");
+}
+
+// src/strip/placa.ts
+function stripPlaca(input) {
+  return input.replace(/[^A-Za-z0-9]/g, "").toUpperCase();
+}
+
+export { stripCep, stripPlaca };
+//# sourceMappingURL=chunk-W6UXVWSR.js.map
+//# sourceMappingURL=chunk-W6UXVWSR.js.map

package/dist/chunk-W6UXVWSR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/strip/cep.ts","../src/strip/placa.ts"],"names":[],"mappings":";AAIO,SAAS,SAAS,KAAA,EAAuB;AAC9C,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AAChC;;;ACFO,SAAS,WAAW,KAAA,EAAuB;AAChD,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,eAAA,EAAiB,EAAE,EAAE,WAAA,EAAY;AACxD","file":"chunk-W6UXVWSR.js","sourcesContent":["/**\n * Strip CEP mask — digits only (BR-CEP-001).\n * @see https://www.correios.com.br/atendimento/developers/manuais/manual-api-busca-cep\n */\nexport function stripCep(input: string): string {\n  return input.replace(/\\D/g, '');\n}\n","/**\n * Strip placa mask — preserve A-Z0-9, uppercase (BR-PLACA-004).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nexport function stripPlaca(input: string): string {\n  return input.replace(/[^A-Za-z0-9]/g, '').toUpperCase();\n}\n"]}

package/dist/chunk-YY4M2YS6.js

@@ -0,0 +1,115 @@
+import { stripPlaca } from './chunk-W6UXVWSR.js';
+import { brandPlaca } from './chunk-DKRM66US.js';
+
+// src/core/placa/constants.ts
+var PLACA_LENGTH = 7;
+var PLACA_LEGACY_PATTERN = /^[A-Z]{3}[0-9]{4}$/;
+var PLACA_MERCOSUL_PATTERN = /^[A-Z]{3}[0-9][A-Z0-9][0-9]{2}$/;
+var PLACA_LEGACY_TO_MERCOSUL_MAP = {
+  "0": "A",
+  "1": "B",
+  "2": "C",
+  "3": "D",
+  "4": "E",
+  "5": "F",
+  "6": "G",
+  "7": "H",
+  "8": "I",
+  "9": "J"
+};
+var PLACA_GOLDEN_MERCOSUL = "ABC1D23";
+var PLACA_GOLDEN_LEGACY = "ABC1234";
+var PLACA_GOLDEN_CONVERSION_FROM = "ABC1234";
+var PLACA_GOLDEN_CONVERSION_TO = "ABC1C34";
+var PLACA_OFFICIAL_SOURCE_URL = "https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf";
+
+// src/core/placa/detect.ts
+function detectPlacaFormat(input) {
+  const stripped = stripPlaca(input);
+  if (stripped.length !== PLACA_LENGTH) {
+    return "unknown";
+  }
+  if (PLACA_LEGACY_PATTERN.test(stripped)) {
+    return "legacy";
+  }
+  if (PLACA_MERCOSUL_PATTERN.test(stripped)) {
+    return "mercosul";
+  }
+  return "unknown";
+}
+
+// src/core/placa/legacy.ts
+function isValidPlacaLegacy(input) {
+  const stripped = stripPlaca(input);
+  return PLACA_LEGACY_PATTERN.test(stripped);
+}
+
+// src/core/placa/mercosul.ts
+function isValidPlacaMercosul(input) {
+  const stripped = stripPlaca(input);
+  return PLACA_MERCOSUL_PATTERN.test(stripped);
+}
+
+// src/core/placa/convert.ts
+function failure(code, message) {
+  return { ok: false, code, message };
+}
+function convertPlacaToMercosul(input) {
+  const stripped = stripPlaca(input);
+  if (stripped.length === 0) {
+    return failure("EMPTY_INPUT", "Placa input is empty");
+  }
+  if (detectPlacaFormat(input) !== "legacy") {
+    return failure("UNSUPPORTED_FORMAT", "Conversion requires a valid legacy plate (LLLNNNN)");
+  }
+  const prefix = stripped.slice(0, 4);
+  const mapped = PLACA_LEGACY_TO_MERCOSUL_MAP[stripped.charAt(4)];
+  const suffix = stripped.slice(5);
+  return { ok: true, formatted: `${prefix}${mapped}${suffix}` };
+}
+
+// src/core/placa/index.ts
+function failure2(code, message) {
+  return { ok: false, code, message };
+}
+function validateStructure(input, stripped) {
+  if (stripped.length === 0) {
+    return failure2("EMPTY_INPUT", "Placa input is empty");
+  }
+  const withoutSeparators = input.replace(/[-\s]/g, "");
+  if (/[^A-Za-z0-9]/.test(withoutSeparators)) {
+    return failure2("INVALID_CHARACTER", "Placa contains invalid characters");
+  }
+  if (stripped.length !== PLACA_LENGTH) {
+    return failure2("INVALID_LENGTH", `Placa must have ${PLACA_LENGTH} characters after normalization`);
+  }
+  return null;
+}
+function isValidPlaca(input) {
+  return validatePlaca(input).ok;
+}
+function validatePlaca(input) {
+  const stripped = stripPlaca(input);
+  const structural = validateStructure(input, stripped);
+  if (structural) {
+    return structural;
+  }
+  const format = detectPlacaFormat(input);
+  if (format === "unknown") {
+    return failure2("UNSUPPORTED_FORMAT", "Placa does not match legacy or Mercosul format");
+  }
+  return { ok: true, value: brandPlaca(stripped), format };
+}
+
+// src/format/placa.ts
+function formatPlaca(input) {
+  const result = validatePlaca(input);
+  if (!result.ok) {
+    return { ok: false, code: result.code, message: result.message };
+  }
+  return { ok: true, formatted: result.value };
+}
+
+export { PLACA_GOLDEN_CONVERSION_FROM, PLACA_GOLDEN_CONVERSION_TO, PLACA_GOLDEN_LEGACY, PLACA_GOLDEN_MERCOSUL, PLACA_OFFICIAL_SOURCE_URL, convertPlacaToMercosul, detectPlacaFormat, formatPlaca, isValidPlaca, isValidPlacaLegacy, isValidPlacaMercosul, validatePlaca };
+//# sourceMappingURL=chunk-YY4M2YS6.js.map
+//# sourceMappingURL=chunk-YY4M2YS6.js.map

package/dist/chunk-YY4M2YS6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/placa/constants.ts","../src/core/placa/detect.ts","../src/core/placa/legacy.ts","../src/core/placa/mercosul.ts","../src/core/placa/convert.ts","../src/core/placa/index.ts","../src/format/placa.ts"],"names":["failure"],"mappings":"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","file":"chunk-YY4M2YS6.js","sourcesContent":["/**\n * License plate patterns — CONTRAN 729/2018 (legacy + Mercosul).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n * @see docs/use-cases/UC-004-validate-placa.md — golden vectors ABC1D23, ABC1234\n */\nexport const PLACA_LENGTH = 7;\nexport const PLACA_LEGACY_PATTERN = /^[A-Z]{3}[0-9]{4}$/;\nexport const PLACA_MERCOSUL_PATTERN = /^[A-Z]{3}[0-9][A-Z0-9][0-9]{2}$/;\nexport const PLACA_LEGACY_TO_MERCOSUL_MAP: Record<string, string> = {\n  '0': 'A',\n  '1': 'B',\n  '2': 'C',\n  '3': 'D',\n  '4': 'E',\n  '5': 'F',\n  '6': 'G',\n  '7': 'H',\n  '8': 'I',\n  '9': 'J',\n};\nexport const PLACA_GOLDEN_MERCOSUL = 'ABC1D23';\nexport const PLACA_GOLDEN_LEGACY = 'ABC1234';\nexport const PLACA_GOLDEN_CONVERSION_FROM = 'ABC1234';\nexport const PLACA_GOLDEN_CONVERSION_TO = 'ABC1C34';\nexport const PLACA_OFFICIAL_SOURCE_URL =\n  'https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf';\n","/**\n * License plate format detection — legacy vs Mercosul (CONTRAN).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nimport { stripPlaca } from '../../strip/index.js';\nimport { PLACA_LENGTH, PLACA_LEGACY_PATTERN, PLACA_MERCOSUL_PATTERN } from './constants.js';\n\nexport type PlacaFormat = 'legacy' | 'mercosul' | 'unknown';\n\nexport function detectPlacaFormat(input: string): PlacaFormat {\n  const stripped = stripPlaca(input);\n  if (stripped.length !== PLACA_LENGTH) {\n    return 'unknown';\n  }\n  if (PLACA_LEGACY_PATTERN.test(stripped)) {\n    return 'legacy';\n  }\n  if (PLACA_MERCOSUL_PATTERN.test(stripped)) {\n    return 'mercosul';\n  }\n  return 'unknown';\n}\n","/**\n * License plate — legacy format LLLNNNN (CONTRAN).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nimport { stripPlaca } from '../../strip/index.js';\nimport { PLACA_LEGACY_PATTERN } from './constants.js';\n\nexport function isValidPlacaLegacy(input: string): boolean {\n  const stripped = stripPlaca(input);\n  return PLACA_LEGACY_PATTERN.test(stripped);\n}\n","/**\n * License plate — Mercosul format LLLNLNN (CONTRAN).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nimport { stripPlaca } from '../../strip/index.js';\nimport { PLACA_MERCOSUL_PATTERN } from './constants.js';\n\nexport function isValidPlacaMercosul(input: string): boolean {\n  const stripped = stripPlaca(input);\n  return PLACA_MERCOSUL_PATTERN.test(stripped);\n}\n","/**\n * Legacy → Mercosul plate conversion (CONTRAN digit-to-letter table).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nimport type { FormatResult } from '../../types/validation-result.js';\nimport { stripPlaca } from '../../strip/index.js';\nimport { PLACA_LEGACY_TO_MERCOSUL_MAP } from './constants.js';\nimport { detectPlacaFormat } from './detect.js';\n\ntype FailedResult = Extract<FormatResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message };\n}\n\nexport function convertPlacaToMercosul(input: string): FormatResult {\n  const stripped = stripPlaca(input);\n  if (stripped.length === 0) {\n    return failure('EMPTY_INPUT', 'Placa input is empty');\n  }\n\n  if (detectPlacaFormat(input) !== 'legacy') {\n    return failure('UNSUPPORTED_FORMAT', 'Conversion requires a valid legacy plate (LLLNNNN)');\n  }\n\n  const prefix = stripped.slice(0, 4);\n  const mapped = PLACA_LEGACY_TO_MERCOSUL_MAP[stripped.charAt(4)];\n  const suffix = stripped.slice(5);\n  return { ok: true, formatted: `${prefix}${mapped}${suffix}` };\n}\n","/**\n * License plate validation — legacy (LLLNNNN) + Mercosul (LLLNLNN). CONTRAN 729/2018.\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n * @see docs/use-cases/UC-004-validate-placa.md — golden vectors ABC1D23, ABC1234\n */\nimport { stripPlaca } from '../../strip/index.js';\nimport type { DocumentFormat, Placa, ValidationResult } from '../../types/validation-result.js';\nimport { brandPlaca } from '../../types/validation-result.js';\nimport { detectPlacaFormat } from './detect.js';\nimport { PLACA_LENGTH } from './constants.js';\n\nexport {\n  PLACA_GOLDEN_CONVERSION_FROM,\n  PLACA_GOLDEN_CONVERSION_TO,\n  PLACA_GOLDEN_LEGACY,\n  PLACA_GOLDEN_MERCOSUL,\n  PLACA_OFFICIAL_SOURCE_URL,\n} from './constants.js';\nexport { detectPlacaFormat, type PlacaFormat } from './detect.js';\nexport { isValidPlacaLegacy } from './legacy.js';\nexport { isValidPlacaMercosul } from './mercosul.js';\nexport { convertPlacaToMercosul } from './convert.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', 'Placa input is empty');\n  }\n\n  const withoutSeparators = input.replace(/[-\\s]/g, '');\n  if (/[^A-Za-z0-9]/.test(withoutSeparators)) {\n    return failure('INVALID_CHARACTER', 'Placa contains invalid characters');\n  }\n\n  if (stripped.length !== PLACA_LENGTH) {\n    return failure('INVALID_LENGTH', `Placa must have ${PLACA_LENGTH} characters after normalization`);\n  }\n\n  return null;\n}\n\nexport function isValidPlaca(input: string): boolean {\n  return validatePlaca(input).ok;\n}\n\nexport function validatePlaca(input: string): ValidationResult<Placa> {\n  const stripped = stripPlaca(input);\n  const structural = validateStructure(input, stripped);\n  if (structural) {\n    return structural;\n  }\n\n  const format = detectPlacaFormat(input);\n  if (format === 'unknown') {\n    return failure('UNSUPPORTED_FORMAT', 'Placa does not match legacy or Mercosul format');\n  }\n\n  return { ok: true, value: brandPlaca(stripped), format: format as DocumentFormat };\n}\n","import { validatePlaca } from '../core/placa/index.js';\nimport type { FormatResult } from '../types/validation-result.js';\n\nexport function formatPlaca(input: string): FormatResult {\n  const result = validatePlaca(input);\n  if (!result.ok) {\n    return { ok: false, code: result.code, message: result.message };\n  }\n  return { ok: true, formatted: result.value };\n}\n"]}