@p2pdotme/sdk 1.2.16 → 1.2.17

package/dist/country.d.ts

@@ -29,6 +29,8 @@ type CurrencyCode = (typeof CURRENCY)[keyof typeof CURRENCY];
  */
 declare const CURRENCY_CODES: [CurrencyCode, ...CurrencyCode[]];
 
+/** Joins an optional QR payload with typed fields (`qr||phone|cci`). */
+declare const PACKED_PAYMENT_ID_SEP = "||";
 interface PaymentIdFieldConfig {
     readonly key: string;
     readonly label: string;
@@ -36,6 +38,11 @@ interface PaymentIdFieldConfig {
     readonly displayLabel: string | null;
     readonly validate: (value: string) => boolean;
     readonly validationErrorMessage: string;
+    /**
+     * When true, an empty value is allowed. If every field is optional, at least
+     * one field must still be filled (see `validatePaymentIdFields`).
+     */
+    readonly optional?: boolean;
 }
 interface CountryOption {
     readonly country: string;
@@ -57,14 +64,97 @@ interface CountryOption {
     readonly isAlpha: boolean;
     readonly disabled: boolean;
     readonly disabledPaymentTypes: readonly string[];
+    /**
+     * Merchant/seller provides payment details by uploading a QR image.
+     * Distinct from PAY, where the buyer scans a QR. Default: false.
+     */
+    readonly uploadPaymentQR?: boolean;
+    /** Structural check for a standalone QR payload (no `||` pack). */
+    readonly validateQr?: (payload: string) => boolean;
+    /**
+     * Fill catalog fields from a validated QR (e.g. Yape/Plin phone in EMVCo).
+     * Only used when the typed fallback did not already set the key.
+     */
+    readonly hydrateFieldsFromQr?: (qr: string) => Partial<Record<string, string>>;
 }
 
 /** All supported countries with their currency metadata, payment methods, and display config. */
 declare const COUNTRY_OPTIONS: readonly CountryOption[];
+declare function getCountryOption(currency: CurrencyCode | null | undefined): CountryOption | undefined;
+/**
+ * Whether the merchant/seller provides payment details by uploading a QR image.
+ * Distinct from PAY (`disabledPaymentTypes`), where the buyer scans a QR.
+ */
+declare function uploadsPaymentQR(currency: CurrencyCode | null | undefined): boolean;
+/**
+ * Whether a stored payment ID may include a QR payload (`qr||fields` or
+ * standalone QR). Derived from `validateQr` — no extra flag.
+ */
+declare function usesPackedPaymentId(currency: CurrencyCode | null | undefined): boolean;
+/**
+ * Apps mount the catalog form (PackedPaymentInput): QR upload and/or
+ * more than one typed field.
+ */
+declare function usesCatalogPaymentForm(currency: CurrencyCode | null | undefined): boolean;
 
 /** Payment ID field configuration for each supported currency. */
 declare const PAYMENT_ID_FIELDS: Record<CurrencyCode, PaymentIdFieldConfig[]>;
 
+/**
+ * Yape/Plin EMVCo: country PE, currency 604, CRC-16/CCITT-FALSE.
+ * CRC is required on upload so we never persist a truncated screenshot.
+ * (PAY render in the merchant is looser; that path does not use this.)
+ */
+declare function validatePeruvianQr(payload: string): boolean;
+/**
+ * Suiche 7B / Pago Móvil collection QR: `base64?merchantId=NNNN&…`.
+ * The base64 is bank AES — we cannot decode phone/RIF from it, only the
+ * envelope. Reject packed `||` IDs so a stored compound string is never
+ * treated as a QR. Scan & Pay uses the looser `isPagoMovilQr` envelope.
+ */
+declare function validateVenezuelanQr(payload: string): boolean;
+
+/** Validates a 20-digit Peruvian CCI (spaces ignored). */
+declare function validatePeruvianCci(value: string): boolean;
+/**
+ * Validates a Yape/Plin phone: `9` + 8 digits, optional `+51` / `51` prefix.
+ */
+declare function validatePeruvianPhone(value: string): boolean;
+/**
+ * Validates a Peruvian payment key for the legacy single-field path.
+ * Accepts either a 20-digit CCI or a Yape/Plin phone number.
+ */
+declare function validatePeruvianPaymentKey(value: string): boolean;
+type PeruvianPaymentIdParts = {
+    qr: string | null;
+    phone: string | null;
+    cci: string | null;
+};
+/** QR payload and/or CCI and/or Yape/Plin phone. */
+declare function validatePeruvianPaymentId(value: string): boolean;
+
+/**
+ * Validates Venezuelan phone number for Pago Movil.
+ * Format: 04XX-XXXXXXX (11 digits starting with 04).
+ */
+declare function validateVenezuelanPhoneNumber(phoneNumber: string): boolean;
+/**
+ * Validates Venezuelan Cédula/RIF for Pago Móvil.
+ * Format: prefix (V|E|J|G|R|P) followed by digits.
+ * Includes natural persons (V), foreigners (E), companies (J), government (G),
+ * residual (R), and passport-linked accounts (P).
+ */
+declare function validateVenezuelanRif(rif: string): boolean;
+type VenezuelanPaymentIdParts = {
+    qr: string | null;
+    compound: string | null;
+};
+/**
+ * Accepts a Suiche 7B QR payload, the typed `phone|rif|bank` fallback,
+ * or both packed as `qr||phone|rif|bank`.
+ */
+declare function validateVenezuelanPaymentId(value: string): boolean;
+
 /**
  * Validates Argentine payment IDs (CBU, CVU, or Alias).
  * CBU/CVU: 22 digits with checksum. Alias: 6-20 alphanumeric characters.
@@ -139,18 +229,6 @@ declare function validateNigerianAccountNumber(accountNumber: string): boolean;
  */
 declare function validateNigerianAccountName(accountName: string): boolean;
 
-/**
- * Validates a Peruvian payment key for the SELL text-key path.
- * Accepts either a 20-digit CCI (Código de Cuenta Interbancario, spaces ignored)
- * or a Yape/Plin phone number (optional `+51`/`51` prefix, then `9` + 8 digits).
- */
-declare function validatePeruvianPaymentKey(value: string): boolean;
-/**
- * Validates a Yape/Plin EMVCo QR payload: parseable TLV, country (tag 58) `PE`,
- * currency (tag 53) `604` (PEN), and a matching CRC-16/CCITT-FALSE (tag 63).
- */
-declare function validatePeruvianQr(payload: string): boolean;
-
 /**
  * Validates a Philippine mobile number for InstaPay (GCash / Maya).
  * Mobile numbers are 10 digits starting with 9, and are commonly written
@@ -158,27 +236,52 @@ declare function validatePeruvianQr(payload: string): boolean;
  */
 declare function validatePhilippinePhoneNumber(phoneNumber: string): boolean;
 
-/**
- * Validates Venezuelan phone number for Pago Movil.
- * Format: 04XX-XXXXXXX (11 digits starting with 04).
- */
-declare function validateVenezuelanPhoneNumber(phoneNumber: string): boolean;
-/**
- * Validates Venezuelan Cédula/RIF for Pago Móvil.
- * Format: prefix (V|E|J|G|R|P) followed by digits.
- * Includes natural persons (V), foreigners (E), companies (J), government (G),
- * residual (R), and passport-linked accounts (P).
- */
-declare function validateVenezuelanRif(rif: string): boolean;
-
 /** Serializes multiple fields into a pipe-separated string. */
 declare function serializeCompoundPaymentId(...fields: string[]): string;
 /** Deserializes a pipe-separated payment ID into its component fields. */
 declare function deserializeCompoundPaymentId(paymentId: string): string[];
 /**
  * Formats a compound payment ID for display using optional labels.
- * Fields without a label are shown as-is, fields with a label are shown as "Label: value".
+ * Empty parts (optional fields left blank) are omitted.
  */
 declare function formatCompoundPaymentIdForDisplay(paymentId: string, labels: (string | null)[]): string;
+/**
+ * Validates a stored payment ID against `PAYMENT_ID_FIELDS`.
+ * Optional fields may be empty; if every field is optional, at least one must
+ * be filled. A legacy single token (no `|`) matches any one field's validator.
+ */
+declare function validatePaymentIdFields(fields: readonly PaymentIdFieldConfig[], paymentId: string): boolean;
+/**
+ * Splits a stored payment ID into per-field values for form hydration.
+ * A legacy single token is assigned to the first field whose validator matches.
+ */
+declare function assignPaymentIdToFieldValues(fields: readonly PaymentIdFieldConfig[], paymentId: string): Record<string, string>;
+declare function unpackPackedPaymentId(paymentId: string): {
+    qr: string;
+    rest: string;
+};
+/**
+ * QR blob from a stored payment ID, or `null` if none / invalid.
+ */
+declare function getStoredQrPayload(currency: CurrencyCode | null | undefined, paymentId: string | null | undefined): string | null;
+/**
+ * Builds a stored payment ID: optional validated QR packed with catalog fields.
+ */
+declare function packStoredPaymentId(currency: CurrencyCode, qr: string | null | undefined, fieldValues: Record<string, string>): string;
+/**
+ * Validates a stored payment ID: optional packed QR, then catalog fields.
+ * QR-only is valid when the country exposes `validateQr`.
+ */
+declare function validateStoredPaymentId(currency: CurrencyCode, paymentId: string): boolean;
+/**
+ * Typed-field values for form hydration. Packed QR prefix is stripped.
+ * `hydrateFieldsFromQr` fills keys the typed fallback left empty (PEN phone).
+ */
+declare function assignStoredPaymentIdToFieldValues(currency: CurrencyCode, paymentId: string): Record<string, string>;
+/**
+ * Human-readable stored ID: labeled typed fields, never the raw QR blob.
+ * QR-only returns an empty string so the caller can substitute a label.
+ */
+declare function formatStoredPaymentIdForDisplay(currency: CurrencyCode, paymentId: string): string;
 
-export { COUNTRY_OPTIONS, CURRENCY, CURRENCY_CODES, type CountryOption, type CurrencyCode, PAYMENT_ID_FIELDS, type PaymentIdFieldConfig, deserializeCompoundPaymentId, formatCompoundPaymentIdForDisplay, serializeCompoundPaymentId, validateArgentinePaymentId, validateColombianPaymentId, validateCubanCardNumber, validateCubanPhoneNumber, validateEcuadorianAccountName, validateEcuadorianAccountNumber, validateEcuadorianCedula, validateIndonesianPhoneNumber, validateMexicanPaymentId, validateNigerianAccountName, validateNigerianAccountNumber, validatePIXId, validatePeruvianPaymentKey, validatePeruvianQr, validatePhilippinePhoneNumber, validateRevolutId, validateUPIId, validateVenezuelanPhoneNumber, validateVenezuelanRif };
+export { COUNTRY_OPTIONS, CURRENCY, CURRENCY_CODES, type CountryOption, type CurrencyCode, PACKED_PAYMENT_ID_SEP, PAYMENT_ID_FIELDS, type PaymentIdFieldConfig, type PeruvianPaymentIdParts, type VenezuelanPaymentIdParts, assignPaymentIdToFieldValues, assignStoredPaymentIdToFieldValues, deserializeCompoundPaymentId, formatCompoundPaymentIdForDisplay, formatStoredPaymentIdForDisplay, getCountryOption, getStoredQrPayload, packStoredPaymentId, serializeCompoundPaymentId, unpackPackedPaymentId, uploadsPaymentQR, usesCatalogPaymentForm, usesPackedPaymentId, validateArgentinePaymentId, validateColombianPaymentId, validateCubanCardNumber, validateCubanPhoneNumber, validateEcuadorianAccountName, validateEcuadorianAccountNumber, validateEcuadorianCedula, validateIndonesianPhoneNumber, validateMexicanPaymentId, validateNigerianAccountName, validateNigerianAccountNumber, validatePIXId, validatePaymentIdFields, validatePeruvianCci, validatePeruvianPaymentId, validatePeruvianPaymentKey, validatePeruvianPhone, validatePeruvianQr, validatePhilippinePhoneNumber, validateRevolutId, validateStoredPaymentId, validateUPIId, validateVenezuelanPaymentId, validateVenezuelanPhoneNumber, validateVenezuelanQr, validateVenezuelanRif };

package/dist/country.mjs

@@ -597,18 +597,10 @@ var NGN_COUNTRY_OPTION = {
   disabledPaymentTypes: []
 };
 
-// src/country/currencies/pen.ts
-var PEN_PLACEHOLDER = "CCI (20 digits) or Yape/Plin phone (9XXXXXXXX)";
-var PEN_VALIDATION_ERROR = "Please enter a valid 20-digit CCI or Yape/Plin phone number";
-function validatePeruvianPaymentKey(value) {
-  if (!value || value.trim().length === 0) return false;
-  const trimmed = value.trim();
-  const cci = trimmed.replace(/\s+/g, "");
-  if (/^\d{20}$/.test(cci)) return true;
-  const phone = trimmed.replace(/\s+/g, "").replace(/^\+?51/, "");
-  if (/^9\d{8}$/.test(phone)) return true;
-  return false;
-}
+// src/country/types.ts
+var PACKED_PAYMENT_ID_SEP = "||";
+
+// src/country/qr-validator.ts
 function crc16ccitt(s) {
   let crc = 65535;
   for (let i = 0; i < s.length; i++) {
@@ -643,14 +635,145 @@ function validatePeruvianQr(payload) {
   const expected = crc16ccitt(data.substring(0, marker + 4));
   return expected.toUpperCase() === crcTag.toUpperCase();
 }
+function validateVenezuelanQr(payload) {
+  if (!payload || typeof payload !== "string") return false;
+  const trimmed = payload.trim();
+  if (trimmed.includes(PACKED_PAYMENT_ID_SEP)) return false;
+  const qIdx = trimmed.indexOf("?");
+  if (qIdx < 40) return false;
+  const blob = trimmed.substring(0, qIdx);
+  if (!/^[A-Za-z0-9+/=]+$/.test(blob)) return false;
+  return /(?:^|[?&])merchantId=\d{3,4}(?:&|$)/.test(trimmed.substring(qIdx));
+}
+
+// src/country/currencies/pen.ts
+var PEN_PHONE_PLACEHOLDER = "PERU_PHONE_PLACEHOLDER";
+var PEN_CCI_PLACEHOLDER = "PERU_CCI_PLACEHOLDER";
+var PEN_PHONE_VALIDATION_ERROR = "Please enter a valid Yape/Plin phone (9XXXXXXXX)";
+var PEN_CCI_VALIDATION_ERROR = "Please enter a valid 20-digit CCI";
+function validatePeruvianCci(value) {
+  if (!value || value.trim().length === 0) return false;
+  return /^\d{20}$/.test(value.trim().replace(/\s+/g, ""));
+}
+function validatePeruvianPhone(value) {
+  if (!value || value.trim().length === 0) return false;
+  const phone = value.trim().replace(/\s+/g, "").replace(/^\+?51/, "");
+  return /^9\d{8}$/.test(phone);
+}
+function validatePeruvianPaymentKey(value) {
+  return validatePeruvianCci(value) || validatePeruvianPhone(value);
+}
+function normalizePeruvianPaymentKey(value) {
+  const trimmed = value.trim();
+  const cci = trimmed.replace(/\s+/g, "");
+  if (/^\d{20}$/.test(cci)) return cci;
+  const phone = trimmed.replace(/\s+/g, "").replace(/^\+?51/, "");
+  if (/^9\d{8}$/.test(phone)) return phone;
+  return cci;
+}
+function looksLikeTlv(value) {
+  if (value.length < 5 || !/^\d{4}/.test(value)) return false;
+  const len = Number.parseInt(value.slice(2, 4), 10);
+  return !Number.isNaN(len) && len >= 0 && 4 + len <= value.length;
+}
+function phoneFromTlvValue(value) {
+  const trimmed = value.trim();
+  if (!trimmed) return null;
+  if (validatePeruvianPhone(trimmed)) return normalizePeruvianPaymentKey(trimmed);
+  if (/^[0-9a-f]+$/i.test(trimmed) && /[a-f]/i.test(trimmed)) return null;
+  const match = trimmed.match(/(^|[^0-9])(\+?51)?(9\d{8})(?![0-9])/);
+  if (!match) return null;
+  const candidate = `${match[2] ?? ""}${match[3]}`;
+  return validatePeruvianPhone(candidate) ? normalizePeruvianPaymentKey(candidate) : null;
+}
+function extractPeruvianPhoneFromQr(payload) {
+  let pos = 0;
+  while (pos + 4 <= payload.length) {
+    const tag = payload.slice(pos, pos + 2);
+    const len = Number.parseInt(payload.slice(pos + 2, pos + 4), 10);
+    if (Number.isNaN(len) || len < 0 || pos + 4 + len > payload.length) break;
+    const value = payload.slice(pos + 4, pos + 4 + len);
+    const direct = phoneFromTlvValue(value);
+    if (direct) return direct;
+    if (tag >= "02" && tag <= "51" || tag === "62" || tag === "64" || looksLikeTlv(value)) {
+      const nested = extractPeruvianPhoneFromQr(value);
+      if (nested) return nested;
+    }
+    pos += 4 + len;
+  }
+  const glued = payload.match(/\+51\s*9\d{8}/);
+  if (glued && validatePeruvianPhone(glued[0])) {
+    return normalizePeruvianPaymentKey(glued[0]);
+  }
+  return null;
+}
+function parsePeruvianFallback(value) {
+  const trimmed = value.trim();
+  if (!trimmed) return { phone: null, cci: null };
+  const tokens = trimmed.split("|").map((token) => token.trim()).filter(Boolean);
+  let phone = null;
+  let cci = null;
+  for (const token of tokens) {
+    if (!phone && validatePeruvianPhone(token)) {
+      phone = normalizePeruvianPaymentKey(token);
+      continue;
+    }
+    if (!cci && validatePeruvianCci(token)) {
+      cci = normalizePeruvianPaymentKey(token);
+    }
+  }
+  return { phone, cci };
+}
+function parsePeruvianPaymentId(value) {
+  if (!value || typeof value !== "string") {
+    return { qr: null, phone: null, cci: null };
+  }
+  const trimmed = value.trim();
+  const sep = trimmed.indexOf(PACKED_PAYMENT_ID_SEP);
+  if (sep >= 0) {
+    const left = trimmed.slice(0, sep);
+    const right = trimmed.slice(sep + PACKED_PAYMENT_ID_SEP.length);
+    const fallback2 = parsePeruvianFallback(right);
+    const qr = validatePeruvianQr(left) ? left : null;
+    return {
+      qr,
+      phone: fallback2.phone ?? (qr ? extractPeruvianPhoneFromQr(qr) : null),
+      cci: fallback2.cci
+    };
+  }
+  if (validatePeruvianQr(trimmed)) {
+    return {
+      qr: trimmed,
+      phone: extractPeruvianPhoneFromQr(trimmed),
+      cci: null
+    };
+  }
+  const fallback = parsePeruvianFallback(trimmed);
+  return { qr: null, phone: fallback.phone, cci: fallback.cci };
+}
+function validatePeruvianPaymentId(value) {
+  if (!value || typeof value !== "string") return false;
+  const { qr, phone, cci } = parsePeruvianPaymentId(value);
+  return Boolean(qr || phone || cci);
+}
 var PEN_PAYMENT_FIELDS = [
   {
-    key: "paymentId",
-    label: "CCI_YAPE_PLIN",
-    placeholder: PEN_PLACEHOLDER,
-    displayLabel: "CCI / Yape / Plin",
-    validate: validatePeruvianPaymentKey,
-    validationErrorMessage: PEN_VALIDATION_ERROR
+    key: "phone",
+    label: "PERU_PHONE_LABEL",
+    placeholder: PEN_PHONE_PLACEHOLDER,
+    displayLabel: "Yape / Plin phone",
+    validate: validatePeruvianPhone,
+    validationErrorMessage: PEN_PHONE_VALIDATION_ERROR,
+    optional: true
+  },
+  {
+    key: "cci",
+    label: "PERU_CCI_LABEL",
+    placeholder: PEN_CCI_PLACEHOLDER,
+    displayLabel: "CCI",
+    validate: validatePeruvianCci,
+    validationErrorMessage: PEN_CCI_VALIDATION_ERROR,
+    optional: true
   }
 ];
 var PEN_COUNTRY_OPTION = {
@@ -671,7 +794,13 @@ var PEN_COUNTRY_OPTION = {
   precision: 2,
   isAlpha: true,
   disabled: false,
-  disabledPaymentTypes: []
+  disabledPaymentTypes: [],
+  uploadPaymentQR: true,
+  validateQr: validatePeruvianQr,
+  hydrateFieldsFromQr: (qr) => {
+    const phone = extractPeruvianPhoneFromQr(qr);
+    return phone ? { phone } : {};
+  }
 };
 
 // src/country/currencies/php.ts
@@ -780,6 +909,32 @@ function validateVenezuelanRif(rif) {
   const trimmed = rif.trim().toUpperCase();
   return /^[VEJGRP]\d+$/.test(trimmed);
 }
+function isValidVenezuelanCompound(value) {
+  const parts = value.split("|");
+  if (parts.length !== 3) return false;
+  return validateVenezuelanPhoneNumber(parts[0]) && validateVenezuelanRif(parts[1]) && parts[2].trim().length > 0;
+}
+function parseVenezuelanPaymentId(value) {
+  if (!value || typeof value !== "string") return { qr: null, compound: null };
+  const trimmed = value.trim();
+  const sep = trimmed.indexOf(PACKED_PAYMENT_ID_SEP);
+  if (sep >= 0) {
+    const left = trimmed.slice(0, sep);
+    const right = trimmed.slice(sep + PACKED_PAYMENT_ID_SEP.length);
+    return {
+      qr: validateVenezuelanQr(left) ? left : null,
+      compound: isValidVenezuelanCompound(right) ? right : null
+    };
+  }
+  if (validateVenezuelanQr(trimmed)) return { qr: trimmed, compound: null };
+  if (isValidVenezuelanCompound(trimmed)) return { qr: null, compound: trimmed };
+  return { qr: null, compound: null };
+}
+function validateVenezuelanPaymentId(value) {
+  if (!value || typeof value !== "string") return false;
+  const { qr, compound } = parseVenezuelanPaymentId(value);
+  return qr !== null || compound !== null;
+}
 var VEN_PAYMENT_FIELDS = [
   {
     key: "phone",
@@ -825,27 +980,11 @@ var VEN_COUNTRY_OPTION = {
   precision: 2,
   isAlpha: false,
   disabled: false,
-  disabledPaymentTypes: []
+  disabledPaymentTypes: [],
+  uploadPaymentQR: true,
+  validateQr: validateVenezuelanQr
 };
 
-// src/country/countries.ts
-var COUNTRY_OPTIONS = [
-  INR_COUNTRY_OPTION,
-  IDR_COUNTRY_OPTION,
-  BRL_COUNTRY_OPTION,
-  ARS_COUNTRY_OPTION,
-  MEX_COUNTRY_OPTION,
-  VEN_COUNTRY_OPTION,
-  NGN_COUNTRY_OPTION,
-  COP_COUNTRY_OPTION,
-  CUP_COUNTRY_OPTION,
-  ECU_COUNTRY_OPTION,
-  PEN_COUNTRY_OPTION,
-  PHP_COUNTRY_OPTION,
-  EUR_COUNTRY_OPTION,
-  USD_COUNTRY_OPTION
-];
-
 // src/country/payment-fields.ts
 var PAYMENT_ID_FIELDS = {
   INR: INR_PAYMENT_FIELDS,
@@ -864,6 +1003,38 @@ var PAYMENT_ID_FIELDS = {
   PHP: PHP_PAYMENT_FIELDS
 };
 
+// src/country/countries.ts
+var COUNTRY_OPTIONS = [
+  INR_COUNTRY_OPTION,
+  IDR_COUNTRY_OPTION,
+  BRL_COUNTRY_OPTION,
+  ARS_COUNTRY_OPTION,
+  MEX_COUNTRY_OPTION,
+  VEN_COUNTRY_OPTION,
+  NGN_COUNTRY_OPTION,
+  COP_COUNTRY_OPTION,
+  CUP_COUNTRY_OPTION,
+  ECU_COUNTRY_OPTION,
+  PEN_COUNTRY_OPTION,
+  PHP_COUNTRY_OPTION,
+  EUR_COUNTRY_OPTION,
+  USD_COUNTRY_OPTION
+];
+function getCountryOption(currency) {
+  if (!currency) return void 0;
+  return COUNTRY_OPTIONS.find((c) => c.currency === currency);
+}
+function uploadsPaymentQR(currency) {
+  return getCountryOption(currency)?.uploadPaymentQR === true;
+}
+function usesPackedPaymentId(currency) {
+  return getCountryOption(currency)?.validateQr != null;
+}
+function usesCatalogPaymentForm(currency) {
+  if (!currency) return false;
+  return uploadsPaymentQR(currency) || (PAYMENT_ID_FIELDS[currency]?.length ?? 0) > 1;
+}
+
 // src/country/validators.ts
 function serializeCompoundPaymentId(...fields) {
   return fields.join("|");
@@ -873,16 +1044,171 @@ function deserializeCompoundPaymentId(paymentId) {
 }
 function formatCompoundPaymentIdForDisplay(paymentId, labels) {
   const parts = deserializeCompoundPaymentId(paymentId);
-  return parts.map((part, i) => labels[i] ? `${labels[i]}: ${part}` : part).join(" | ");
+  return parts.map((part, i) => {
+    if (!part?.trim()) return null;
+    return labels[i] ? `${labels[i]}: ${part}` : part;
+  }).filter((part) => part !== null).join(" | ");
+}
+function validatePaymentIdFields(fields, paymentId) {
+  if (!paymentId || paymentId.trim().length === 0) return false;
+  if (!fields.length) return false;
+  if (fields.length === 1) {
+    return fields[0].validate(paymentId);
+  }
+  const parts = deserializeCompoundPaymentId(paymentId);
+  if (parts.length === 1) {
+    if (!fields.some((field) => field.optional)) return false;
+    return fields.some((field) => field.validate(parts[0]));
+  }
+  const values = fields.map((_, i) => (parts[i] ?? "").trim());
+  const eachOk = fields.every((field, i) => {
+    const value = values[i];
+    if (!value) return field.optional === true;
+    return field.validate(value);
+  });
+  if (!eachOk) return false;
+  return values.some((value) => value.length > 0);
+}
+function assignPaymentIdToFieldValues(fields, paymentId) {
+  const result = {};
+  for (const field of fields) result[field.key] = "";
+  if (!paymentId) return result;
+  const { rest } = unpackPackedPaymentId(paymentId);
+  if (!rest) return result;
+  const tokens = deserializeCompoundPaymentId(rest).map((part) => part.trim()).filter((part) => part.length > 0);
+  const claimed = /* @__PURE__ */ new Set();
+  for (const token of tokens) {
+    const field = fields.find((item) => !claimed.has(item.key) && item.validate(token));
+    if (field) {
+      result[field.key] = token;
+      claimed.add(field.key);
+    }
+  }
+  if (claimed.size === 0 && tokens.length === 1 && fields.length === 1) {
+    result[fields[0].key] = tokens[0];
+    return result;
+  }
+  if (claimed.size < Math.min(tokens.length, fields.length)) {
+    fields.forEach((field, i) => {
+      if (!result[field.key]) result[field.key] = tokens[i] ?? "";
+    });
+  }
+  return result;
+}
+function unpackPackedPaymentId(paymentId) {
+  const sep = paymentId.indexOf(PACKED_PAYMENT_ID_SEP);
+  if (sep < 0) return { qr: "", rest: paymentId };
+  return {
+    qr: paymentId.slice(0, sep),
+    rest: paymentId.slice(sep + PACKED_PAYMENT_ID_SEP.length)
+  };
+}
+function isStandaloneQr(validateQr, value) {
+  return !!validateQr?.(value);
+}
+function getStoredQrPayload(currency, paymentId) {
+  if (!currency || !paymentId) return null;
+  const option = getCountryOption(currency);
+  if (!option?.validateQr) return null;
+  const trimmed = paymentId.trim();
+  const { qr } = unpackPackedPaymentId(trimmed);
+  if (qr && option.validateQr(qr)) return qr;
+  if (isStandaloneQr(option.validateQr, trimmed)) return trimmed;
+  return null;
+}
+function packedTypedRest(fields, fieldValues) {
+  const parts = fields.map((field) => {
+    const value = (fieldValues[field.key] ?? "").trim();
+    if (!value) return "";
+    return field.validate(value) ? value : "";
+  });
+  if (!parts.some((part) => part.length > 0)) return "";
+  return serializeCompoundPaymentId(...parts);
+}
+function packStoredPaymentId(currency, qr, fieldValues) {
+  const fields = PAYMENT_ID_FIELDS[currency] ?? [];
+  const option = getCountryOption(currency);
+  const trimmedQr = qr?.trim() ?? "";
+  const q = trimmedQr && option?.validateQr?.(trimmedQr) ? trimmedQr : "";
+  const rest = packedTypedRest(fields, fieldValues);
+  if (q && rest) return `${q}${PACKED_PAYMENT_ID_SEP}${rest}`;
+  return q || rest;
+}
+function fieldsMatchStoredId(fields, paymentId) {
+  if (validatePaymentIdFields(fields, paymentId)) return true;
+  const assigned = assignPaymentIdToFieldValues(fields, paymentId);
+  const filled = fields.filter((field) => (assigned[field.key] || "").trim().length > 0);
+  if (filled.length === 0) return false;
+  return fields.every(
+    (field) => field.optional === true || (assigned[field.key] || "").trim().length > 0
+  );
+}
+function validateStoredPaymentId(currency, paymentId) {
+  if (!paymentId || paymentId.trim().length === 0) return false;
+  const fields = PAYMENT_ID_FIELDS[currency];
+  if (!fields?.length) return false;
+  const option = getCountryOption(currency);
+  const trimmed = paymentId.trim();
+  const { qr, rest } = unpackPackedPaymentId(trimmed);
+  if (qr) {
+    if (!option?.validateQr?.(qr)) return false;
+    if (!rest.trim()) return true;
+    return fieldsMatchStoredId(fields, rest);
+  }
+  if (isStandaloneQr(option?.validateQr, trimmed)) return true;
+  return fieldsMatchStoredId(fields, trimmed);
+}
+function assignStoredPaymentIdToFieldValues(currency, paymentId) {
+  const fields = PAYMENT_ID_FIELDS[currency] ?? [];
+  const option = getCountryOption(currency);
+  const trimmed = paymentId.trim();
+  const { qr, rest } = unpackPackedPaymentId(trimmed);
+  let qrPayload = "";
+  let typed = rest.trim();
+  if (qr && option?.validateQr?.(qr)) {
+    qrPayload = qr;
+  } else if (isStandaloneQr(option?.validateQr, trimmed)) {
+    qrPayload = trimmed;
+    typed = "";
+  }
+  const values = assignPaymentIdToFieldValues(fields, typed);
+  if (qrPayload && option?.hydrateFieldsFromQr) {
+    const extra = option.hydrateFieldsFromQr(qrPayload);
+    for (const [key, value] of Object.entries(extra)) {
+      if (value && !values[key]) values[key] = value;
+    }
+  }
+  return values;
+}
+function formatStoredPaymentIdForDisplay(currency, paymentId) {
+  const fields = PAYMENT_ID_FIELDS[currency] ?? [];
+  const values = assignStoredPaymentIdToFieldValues(currency, paymentId);
+  if (fields.length <= 1) return (values[fields[0]?.key ?? ""] || "").trim();
+  return fields.map((field) => {
+    const value = (values[field.key] || "").trim();
+    if (!value) return null;
+    return field.displayLabel ? `${field.displayLabel}: ${value}` : value;
+  }).filter((part) => part !== null).join(" | ");
 }
 export {
   COUNTRY_OPTIONS,
   CURRENCY,
   CURRENCY_CODES,
+  PACKED_PAYMENT_ID_SEP,
   PAYMENT_ID_FIELDS,
+  assignPaymentIdToFieldValues,
+  assignStoredPaymentIdToFieldValues,
   deserializeCompoundPaymentId,
   formatCompoundPaymentIdForDisplay,
+  formatStoredPaymentIdForDisplay,
+  getCountryOption,
+  getStoredQrPayload,
+  packStoredPaymentId,
   serializeCompoundPaymentId,
+  unpackPackedPaymentId,
+  uploadsPaymentQR,
+  usesCatalogPaymentForm,
+  usesPackedPaymentId,
   validateArgentinePaymentId,
   validateColombianPaymentId,
   validateCubanCardNumber,
@@ -895,12 +1221,19 @@ export {
   validateNigerianAccountName,
   validateNigerianAccountNumber,
   validatePIXId,
+  validatePaymentIdFields,
+  validatePeruvianCci,
+  validatePeruvianPaymentId,
   validatePeruvianPaymentKey,
+  validatePeruvianPhone,
   validatePeruvianQr,
   validatePhilippinePhoneNumber,
   validateRevolutId,
+  validateStoredPaymentId,
   validateUPIId,
+  validateVenezuelanPaymentId,
   validateVenezuelanPhoneNumber,
+  validateVenezuelanQr,
   validateVenezuelanRif
 };
 //# sourceMappingURL=country.mjs.map