@delopay/sdk 0.69.0 → 0.71.0

package/dist/internal.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/internal.ts
 var internal_exports = {};
 __export(internal_exports, {
+  ALL_CUSTOM_FIELD_TYPES: () => ALL_CUSTOM_FIELD_TYPES,
   Admin: () => Admin,
   AdminPortal: () => AdminPortal,
   Analytics: () => Analytics,
@@ -29,6 +30,8 @@ __export(internal_exports, {
   BRANDING_EXPORT_FORMAT: () => BRANDING_EXPORT_FORMAT,
   BRANDING_EXPORT_VERSION: () => BRANDING_EXPORT_VERSION,
   CUSTOM_CSS_MAX_LENGTH: () => CUSTOM_CSS_MAX_LENGTH,
+  CUSTOM_FIELDS_MAX: () => CUSTOM_FIELDS_MAX,
+  CUSTOM_FIELD_KEY_PATTERN: () => CUSTOM_FIELD_KEY_PATTERN,
   Cache: () => Cache,
   CardIssuers: () => CardIssuers,
   Cards: () => Cards,
@@ -61,11 +64,16 @@ __export(internal_exports, {
   buildBrandingExport: () => buildBrandingExport,
   buttonPadValue: () => buttonPadValue,
   cloneBranding: () => cloneBranding,
+  cloneCustomField: () => cloneCustomField,
+  customFieldOptionLabel: () => customFieldOptionLabel,
+  customFieldText: () => customFieldText,
   decodeBadges: () => decodeBadges,
   decodeBranding: () => decodeBranding,
+  decodeCustomFields: () => decodeCustomFields,
   defaultBranding: () => defaultBranding,
   encodeBadges: () => encodeBadges,
   encodeBranding: () => encodeBranding,
+  encodeCustomFields: () => encodeCustomFields,
   feeProgram: () => feeProgram,
   fontStack: () => fontStack,
   fontWeightValue: () => fontWeightValue,
@@ -74,6 +82,7 @@ __export(internal_exports, {
   isHexColor: () => isHexColor,
   leaf: () => leaf,
   logoDimensions: () => logoDimensions,
+  parseCustomFieldsLoose: () => parseCustomFieldsLoose,
   parseImportedBranding: () => parseImportedBranding,
   programToTree: () => programToTree,
   radiusValue: () => radiusValue,
@@ -747,10 +756,14 @@ var Disputes = class {
     return this.request("PUT", "/disputes/evidence", { body: params });
   }
   /**
-   * Retrieve previously submitted evidence for a dispute.
+   * Retrieve previously stored evidence for a dispute.
+   *
+   * Returns an ARRAY of file-evidence blocks (this was previously mistyped
+   * as the flat submit-request shape). Only file evidence is reported —
+   * text evidence is not retrievable once submitted.
    *
    * @param disputeId - The dispute ID.
-   * @returns The submitted evidence.
+   * @returns The stored file-evidence blocks.
    */
   async retrieveEvidence(disputeId) {
     return this.request("GET", `/disputes/evidence/${encodeURIComponent(disputeId)}`);
@@ -788,16 +801,22 @@ var Disputes = class {
     return this.request("GET", "/disputes/profile/aggregate", { query: params });
   }
   /**
-   * Fetch the latest dispute state from the connector (gateway).
-   * `GET /disputes/{connectorId}/fetch`
+   * Fetch the latest dispute state from the connector (gateway) and persist it.
+   * `GET /disputes/{disputeId}?force_sync=true`
+   *
+   * The path parameter is the **Delopay dispute id** (`dp_…`). Force-sync asks the
+   * backend to pull the dispute from the connector (supported where the connector
+   * implements the dispute-sync flow, e.g. Stripe) and update the stored record
+   * before returning it.
    *
-   * Note: the path parameter is the **connector dispute id** on the gateway, not the
-   * Delopay dispute id. Method is GET (not POST) and this method signature was
-   * previously wrong — callers depending on the old `POST /disputes/{id}/fetch_from_connector`
-   * path were silently hitting 404s.
+   * Note: this method previously called `GET /disputes/{id}/fetch`, which is a
+   * different backend route — a bulk import keyed by **merchant connector account
+   * id** with a required date range — so every call with a dispute id failed.
    */
-  async fetchFromConnector(connectorId) {
-    return this.request("GET", `/disputes/${encodeURIComponent(connectorId)}/fetch`);
+  async fetchFromConnector(disputeId) {
+    return this.request("GET", `/disputes/${encodeURIComponent(disputeId)}`, {
+      query: { force_sync: "true" }
+    });
   }
 };
 
@@ -3949,7 +3968,8 @@ var DEFAULT_BRANDING_BASE = {
 var DEFAULT_BRANDING = {
   ...DEFAULT_BRANDING_BASE,
   ...LIGHT_PALETTE,
-  trustBadges: DEFAULT_BADGES.map((b) => ({ ...b }))
+  trustBadges: DEFAULT_BADGES.map((b) => ({ ...b })),
+  customFields: []
 };
 var DEFAULT_BRANDING_DARK = {
   ...DEFAULT_BRANDING_BASE,
@@ -3964,13 +3984,27 @@ var DEFAULT_BRANDING_DARK = {
   buttonBackground: "#1E4FEB",
   buttonText: "#ffffff",
   surfaceStyle: "flat",
-  trustBadges: DEFAULT_BADGES_DARK.map((b) => ({ ...b }))
+  trustBadges: DEFAULT_BADGES_DARK.map((b) => ({ ...b })),
+  customFields: []
 };
 function defaultBranding() {
   return cloneBranding(DEFAULT_BRANDING);
 }
 function cloneBranding(b) {
-  return { ...b, trustBadges: b.trustBadges.map((badge) => ({ ...badge })) };
+  return {
+    ...b,
+    trustBadges: b.trustBadges.map((badge) => ({ ...badge })),
+    customFields: b.customFields.map(cloneCustomField)
+  };
+}
+function cloneCustomField(f) {
+  return {
+    ...f,
+    labelTranslations: { ...f.labelTranslations },
+    placeholderTranslations: { ...f.placeholderTranslations },
+    helpTextTranslations: { ...f.helpTextTranslations },
+    options: f.options.map((o) => ({ ...o, labelTranslations: { ...o.labelTranslations } }))
+  };
 }
 var CUSTOM_CSS_MAX_LENGTH = 5e4;
 function sanitizeCustomCss(raw) {
@@ -4048,10 +4082,135 @@ function encodeBadges(badges) {
     }))
   );
 }
+var CUSTOM_FIELDS_MAX = 20;
+var CUSTOM_FIELD_KEY_PATTERN = /^[A-Za-z][A-Za-z0-9_-]{0,39}$/;
+var ALL_CUSTOM_FIELD_TYPES = [
+  "text",
+  "textarea",
+  "password",
+  "email",
+  "select"
+];
+function parseTranslations(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {};
+  const out = {};
+  for (const [k, v] of Object.entries(raw)) {
+    if (typeof v === "string" && v.length > 0) out[k] = v;
+  }
+  return out;
+}
+function parseBoundedInt(raw) {
+  const n = typeof raw === "number" ? raw : typeof raw === "string" ? Number(raw) : NaN;
+  if (!Number.isInteger(n) || n < 0) return null;
+  return Math.min(n, 5e3);
+}
+function normalizeCustomField(raw, index) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
+  const f = raw;
+  const key = typeof f["key"] === "string" ? f["key"].trim() : "";
+  if (!CUSTOM_FIELD_KEY_PATTERN.test(key)) return null;
+  const type = pickEnum(f["type"], ALL_CUSTOM_FIELD_TYPES, "text");
+  const options = type === "select" && Array.isArray(f["options"]) ? f["options"].filter((o) => !!o && typeof o === "object").map((o) => {
+    const value = typeof o["value"] === "string" ? o["value"] : "";
+    return {
+      value,
+      label: typeof o["label"] === "string" && o["label"] ? o["label"] : value,
+      labelTranslations: parseTranslations(o["labelTranslations"])
+    };
+  }).filter((o) => o.value.length > 0) : [];
+  const minLength = parseBoundedInt(f["minLength"]);
+  const maxLength = parseBoundedInt(f["maxLength"]);
+  return {
+    id: typeof f["id"] === "string" && f["id"] ? f["id"] : `field-${index}`,
+    key,
+    type,
+    label: typeof f["label"] === "string" && f["label"] ? f["label"] : key,
+    labelTranslations: parseTranslations(f["labelTranslations"]),
+    placeholder: typeof f["placeholder"] === "string" ? f["placeholder"] : "",
+    placeholderTranslations: parseTranslations(f["placeholderTranslations"]),
+    helpText: typeof f["helpText"] === "string" ? f["helpText"] : "",
+    helpTextTranslations: parseTranslations(f["helpTextTranslations"]),
+    required: parseBool(f["required"], false),
+    enabled: parseBool(f["enabled"], true),
+    minLength,
+    // Guard inverted bounds at decode so consumers never see min > max.
+    maxLength: maxLength !== null && minLength !== null && maxLength < minLength ? null : maxLength,
+    defaultValue: typeof f["defaultValue"] === "string" ? f["defaultValue"] : "",
+    options
+  };
+}
+function parseCustomFieldsLoose(raw) {
+  if (!Array.isArray(raw)) return null;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (let i = 0; i < raw.length && out.length < CUSTOM_FIELDS_MAX; i++) {
+    const field = normalizeCustomField(raw[i], i);
+    if (!field || seen.has(field.key)) continue;
+    seen.add(field.key);
+    out.push(field);
+  }
+  return out;
+}
+function decodeCustomFields(raw) {
+  if (raw === void 0) return null;
+  try {
+    return parseCustomFieldsLoose(JSON.parse(raw));
+  } catch {
+    return null;
+  }
+}
+function encodeCustomFields(fields) {
+  const nonEmpty = (m) => {
+    const entries = Object.entries(m).filter(([, v]) => v.trim().length > 0);
+    return entries.length > 0 ? Object.fromEntries(entries) : void 0;
+  };
+  return JSON.stringify(
+    fields.map((f) => ({
+      id: f.id,
+      key: f.key,
+      type: f.type,
+      label: f.label,
+      ...nonEmpty(f.labelTranslations) ? { labelTranslations: nonEmpty(f.labelTranslations) } : {},
+      ...f.placeholder ? { placeholder: f.placeholder } : {},
+      ...nonEmpty(f.placeholderTranslations) ? { placeholderTranslations: nonEmpty(f.placeholderTranslations) } : {},
+      ...f.helpText ? { helpText: f.helpText } : {},
+      ...nonEmpty(f.helpTextTranslations) ? { helpTextTranslations: nonEmpty(f.helpTextTranslations) } : {},
+      ...f.required ? { required: true } : {},
+      ...f.enabled ? {} : { enabled: false },
+      ...f.minLength !== null ? { minLength: f.minLength } : {},
+      ...f.maxLength !== null ? { maxLength: f.maxLength } : {},
+      ...f.defaultValue ? { defaultValue: f.defaultValue } : {},
+      ...f.type === "select" ? { options: f.options } : {}
+    }))
+  );
+}
+function translationFor(map, locale) {
+  if (!locale) return null;
+  const own = (k) => {
+    const v = Object.prototype.hasOwnProperty.call(map, k) ? map[k] : void 0;
+    return typeof v === "string" && v.length > 0 ? v : null;
+  };
+  const exact = own(locale);
+  if (exact) return exact;
+  const base = locale.split("-")[0];
+  return base && base !== locale ? own(base) : null;
+}
+function customFieldText(field, part, locale) {
+  const map = part === "label" ? field.labelTranslations : part === "placeholder" ? field.placeholderTranslations : field.helpTextTranslations;
+  const translated = translationFor(map, locale);
+  if (translated) return translated;
+  const fallback = field[part];
+  if (fallback) return fallback;
+  return part === "label" ? field.key : "";
+}
+function customFieldOptionLabel(option, locale) {
+  return translationFor(option.labelTranslations, locale) ?? (option.label || option.value);
+}
 function decodeBranding(source) {
   if (!source) return cloneBranding(DEFAULT_BRANDING);
   const extras = source.sdk_ui_rules?.[BRANDING_GROUP_KEY] ?? {};
   const decodedBadges = decodeBadges(extras["trustBadges"]);
+  const decodedCustomFields = decodeCustomFields(extras["customFields"]);
   const displayName = s(source.merchant_name) || s(source.seller_name);
   const logoUrl = s(source.merchant_logo) || s(source.logo);
   const tagline = s(extras["tagline"]) || s(source.merchant_description);
@@ -4153,6 +4312,7 @@ function decodeBranding(source) {
     showCurrencyCode: parseBool(extras["showCurrencyCode"], DEFAULT_BRANDING.showCurrencyCode),
     showOrderItems: parseBool(extras["showOrderItems"], DEFAULT_BRANDING.showOrderItems),
     trustBadges: decodedBadges ?? DEFAULT_BRANDING.trustBadges.map((b) => ({ ...b })),
+    customFields: decodedCustomFields ?? [],
     headerText: s(source.payment_form_header_text),
     payButtonLabel: s(source.payment_button_text),
     cardTermsMessage: s(source.custom_message_for_card_terms),
@@ -4206,6 +4366,9 @@ function encodeBranding(branding, base) {
     labelStyle: branding.labelStyle,
     trustBadges: encodeBadges(branding.trustBadges)
   };
+  if (branding.customFields.length > 0) {
+    extras["customFields"] = encodeCustomFields(branding.customFields);
+  }
   const tagline = trim(branding.tagline);
   if (tagline) extras["tagline"] = tagline;
   const footer = trim(branding.footerText);
@@ -4256,6 +4419,7 @@ function parseImportedBranding(raw) {
   const sStr = (v, fallback) => typeof v === "string" ? v : fallback;
   const sHex = (v, fallback) => typeof v === "string" && isHexColor(v) ? v : fallback;
   const trustBadges = parseTrustBadgesLoose(root["trustBadges"]) ?? dflt.trustBadges.map((b) => ({ ...b }));
+  const customFields = parseCustomFieldsLoose(root["customFields"]) ?? [];
   const labelStyle = (() => {
     const v = root["labelStyle"];
     if (v === "above" || v === "hidden") return v;
@@ -4326,6 +4490,7 @@ function parseImportedBranding(raw) {
     showCurrencyCode: parseBool(root["showCurrencyCode"], dflt.showCurrencyCode),
     showOrderItems: parseBool(root["showOrderItems"], dflt.showOrderItems),
     trustBadges,
+    customFields,
     headerText: sStr(root["headerText"], dflt.headerText),
     payButtonLabel: sStr(root["payButtonLabel"], dflt.payButtonLabel),
     cardTermsMessage: sStr(root["cardTermsMessage"], dflt.cardTermsMessage),
@@ -4959,6 +5124,7 @@ var DelopayInternal = class extends Delopay {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ALL_CUSTOM_FIELD_TYPES,
   Admin,
   AdminPortal,
   Analytics,
@@ -4968,6 +5134,8 @@ var DelopayInternal = class extends Delopay {
   BRANDING_EXPORT_FORMAT,
   BRANDING_EXPORT_VERSION,
   CUSTOM_CSS_MAX_LENGTH,
+  CUSTOM_FIELDS_MAX,
+  CUSTOM_FIELD_KEY_PATTERN,
   Cache,
   CardIssuers,
   Cards,
@@ -5000,11 +5168,16 @@ var DelopayInternal = class extends Delopay {
   buildBrandingExport,
   buttonPadValue,
   cloneBranding,
+  cloneCustomField,
+  customFieldOptionLabel,
+  customFieldText,
   decodeBadges,
   decodeBranding,
+  decodeCustomFields,
   defaultBranding,
   encodeBadges,
   encodeBranding,
+  encodeCustomFields,
   feeProgram,
   fontStack,
   fontWeightValue,
@@ -5013,6 +5186,7 @@ var DelopayInternal = class extends Delopay {
   isHexColor,
   leaf,
   logoDimensions,
+  parseCustomFieldsLoose,
   parseImportedBranding,
   programToTree,
   radiusValue,