@delopay/sdk 0.77.0 → 0.79.0

package/dist/index.cjs

@@ -30,6 +30,7 @@ __export(index_exports, {
   BRANDING_EXPORT_VERSION: () => BRANDING_EXPORT_VERSION,
   CHECKBOX_CHECKED: () => CHECKBOX_CHECKED,
   CHECKBOX_UNCHECKED: () => CHECKBOX_UNCHECKED,
+  CHECKOUT_EVENT_KINDS: () => CHECKOUT_EVENT_KINDS,
   CUSTOM_CSS_MAX_LENGTH: () => CUSTOM_CSS_MAX_LENGTH,
   CUSTOM_FIELDS_MAX: () => CUSTOM_FIELDS_MAX,
   CUSTOM_FIELD_CONDITIONS_MAX: () => CUSTOM_FIELD_CONDITIONS_MAX,
@@ -49,7 +50,11 @@ __export(index_exports, {
   FeeProgramBuilder: () => FeeProgramBuilder,
   Files: () => Files,
   Forex: () => Forex,
+  NATIVE_PANES_MAX: () => NATIVE_PANES_MAX,
+  NATIVE_PANE_CATEGORY_KEYS: () => NATIVE_PANE_CATEGORY_KEYS,
+  NATIVE_PANE_ICON_KEYS: () => NATIVE_PANE_ICON_KEYS,
   Regions: () => Regions,
+  STRIPE_NATIVE_PANE_METHODS: () => STRIPE_NATIVE_PANE_METHODS,
   Search: () => Search,
   Subscriptions: () => Subscriptions,
   Webhooks: () => Webhooks,
@@ -60,6 +65,7 @@ __export(index_exports, {
   buttonPadValue: () => buttonPadValue,
   cloneBranding: () => cloneBranding,
   cloneCustomField: () => cloneCustomField,
+  cloneNativePane: () => cloneNativePane,
   customFieldContextFromMetadata: () => customFieldContextFromMetadata,
   customFieldIsTextLike: () => customFieldIsTextLike,
   customFieldOperatorTakesValue: () => customFieldOperatorTakesValue,
@@ -68,15 +74,19 @@ __export(index_exports, {
   decodeBadges: () => decodeBadges,
   decodeBranding: () => decodeBranding,
   decodeCustomFields: () => decodeCustomFields,
+  decodeNativePanes: () => decodeNativePanes,
   defaultBranding: () => defaultBranding,
   defaultCustomFieldVisibility: () => defaultCustomFieldVisibility,
+  defaultNativePane: () => defaultNativePane,
   defaultOperatorForSource: () => defaultOperatorForSource,
   encodeBadges: () => encodeBadges,
   encodeBranding: () => encodeBranding,
   encodeCustomFields: () => encodeCustomFields,
+  encodeNativePanes: () => encodeNativePanes,
   evaluateCustomFieldCondition: () => evaluateCustomFieldCondition,
   evaluateCustomFieldVisibility: () => evaluateCustomFieldVisibility,
   feeProgram: () => feeProgram,
+  focusedCheckoutUrl: () => focusedCheckoutUrl,
   fontStack: () => fontStack,
   fontWeightValue: () => fontWeightValue,
   inputPadValue: () => inputPadValue,
@@ -85,6 +95,7 @@ __export(index_exports, {
   isHexColor: () => isHexColor,
   leaf: () => leaf,
   logoDimensions: () => logoDimensions,
+  nativePaneMethodInfo: () => nativePaneMethodInfo,
   parseCustomFieldsLoose: () => parseCustomFieldsLoose,
   parseImportedBranding: () => parseImportedBranding,
   programToTree: () => programToTree,
@@ -1153,10 +1164,45 @@ var PaymentMethods = class {
     return this.request("DELETE", `/payment-methods/${encodeURIComponent(methodId)}`);
   }
   /**
-   * List payment methods using a client secret.
+   * List the payment methods available for a payment — the discovery endpoint a
+   * custom checkout renders its tiles from.
    *
-   * @param params - Filter by `client_secret`.
-   * @returns Array of payment methods.
+   * Callable with a publishable key plus the payment's `client_secret`, so it
+   * runs from the browser. The returned set is already filtered by country,
+   * order value and the merchant's availability rules, and each entry carries
+   * `display` (name + icon slug) and `amount_limits` (the order values it stays
+   * available for) so you do not have to maintain either alongside.
+   *
+   * This is *not* the customer's saved methods — see {@link listForCustomer}.
+   *
+   * @param params - `client_secret`, plus optional `country`, `amount` and filters.
+   * @returns The methods available for the payment, grouped by payment method.
+   *
+   * @example
+   * ```typescript
+   * const { payment_methods } = await delopay.paymentMethods.list({
+   *   client_secret: 'pay_abc_secret_xyz',
+   *   country: 'DE',
+   *   amount: 25000,
+   * });
+   *
+   * for (const group of payment_methods) {
+   *   for (const method of group.payment_method_types) {
+   *     // Re-check availability yourself as the cart total changes, instead of
+   *     // re-listing on every keystroke.
+   *     const limits = method.amount_limits;
+   *     const available =
+   *       !limits ||
+   *       ((limits.min_amount == null || cartTotal >= limits.min_amount) &&
+   *         (limits.max_amount == null || cartTotal <= limits.max_amount) &&
+   *         !limits.excluded_ranges.some(
+   *           (band) => cartTotal >= band.min_amount && cartTotal <= band.max_amount,
+   *         ));
+   *
+   *     if (available) render(method.display?.display_name, method.display?.icon_slug);
+   *   }
+   * }
+   * ```
    */
   async list(params) {
     return this.request("GET", "/payment-methods", {
@@ -4782,6 +4828,230 @@ function shadowFor(style) {
       return "none";
   }
 }
+
+// src/nativePanes.ts
+var STRIPE_NATIVE_PANE_METHODS = [
+  {
+    key: "apple_pay",
+    rail: "wallet",
+    defaultLabel: "Apple Pay",
+    defaultSublabel: "Pay with Apple Pay",
+    defaultCategory: "wallet",
+    defaultIcon: "apple"
+  },
+  {
+    key: "google_pay",
+    rail: "wallet",
+    defaultLabel: "Google Pay",
+    defaultSublabel: "Pay with Google Pay",
+    defaultCategory: "wallet",
+    defaultIcon: "google"
+  },
+  {
+    key: "link",
+    rail: "wallet",
+    defaultLabel: "Link",
+    defaultSublabel: "Pay with saved details",
+    defaultCategory: "wallet",
+    defaultIcon: "wallet"
+  },
+  {
+    key: "klarna",
+    rail: "redirect",
+    defaultLabel: "Klarna",
+    defaultSublabel: "Pay later or in instalments",
+    defaultCategory: "bnpl",
+    defaultIcon: "bnpl"
+  },
+  {
+    key: "affirm",
+    rail: "redirect",
+    defaultLabel: "Affirm",
+    defaultSublabel: "Pay over time",
+    defaultCategory: "bnpl",
+    defaultIcon: "bnpl"
+  },
+  {
+    key: "ideal",
+    rail: "redirect",
+    defaultLabel: "iDEAL",
+    defaultSublabel: "Pay from your bank",
+    defaultCategory: "bank_redirect",
+    defaultIcon: "bank"
+  },
+  // eps / p24 / bancontact were removed from the router catalog: Stripe
+  // hard-requires billing fields the focused checkout never collects (full
+  // name for EPS/Bancontact, email for Przelewy24), so their tiles could
+  // never succeed. They may return behind billing-aware gating.
+  {
+    key: "alipay",
+    rail: "redirect",
+    defaultLabel: "Alipay",
+    defaultSublabel: "Pay with Alipay",
+    defaultCategory: "wallet",
+    defaultIcon: "wallet"
+  },
+  {
+    key: "revolut_pay",
+    rail: "redirect",
+    defaultLabel: "Revolut Pay",
+    defaultSublabel: "Pay with Revolut",
+    defaultCategory: "wallet",
+    defaultIcon: "wallet"
+  },
+  {
+    key: "amazon_pay",
+    rail: "redirect",
+    defaultLabel: "Amazon Pay",
+    defaultSublabel: "Pay with Amazon",
+    defaultCategory: "wallet",
+    defaultIcon: "wallet"
+  }
+];
+var NATIVE_PANE_ICON_KEYS = [
+  "wallet",
+  "card",
+  "bank",
+  "apple",
+  "google",
+  "bnpl",
+  "cash"
+];
+var NATIVE_PANE_CATEGORY_KEYS = [
+  "wallet",
+  "card",
+  "bnpl",
+  "bank_redirect",
+  "bank_transfer",
+  "cash"
+];
+var NATIVE_PANES_MAX = 12;
+function nativePaneMethodInfo(method) {
+  return STRIPE_NATIVE_PANE_METHODS.find((m) => m.key === method);
+}
+function defaultNativePane(method) {
+  const info = nativePaneMethodInfo(method);
+  return {
+    method,
+    enabled: true,
+    label: "",
+    labelTranslations: {},
+    sublabel: null,
+    sublabelTranslations: {},
+    category: "",
+    icon: info?.defaultIcon ?? "",
+    iconSvg: "",
+    displayOrder: 0,
+    visibility: "always"
+  };
+}
+function cloneNativePane(pane) {
+  return {
+    ...pane,
+    labelTranslations: { ...pane.labelTranslations },
+    sublabelTranslations: { ...pane.sublabelTranslations }
+  };
+}
+function isObject2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseTranslations2(raw) {
+  if (!isObject2(raw)) return {};
+  const out = {};
+  for (const [locale, value] of Object.entries(raw)) {
+    if (typeof value === "string" && value.length > 0) out[locale] = value;
+  }
+  return out;
+}
+function str(raw) {
+  return typeof raw === "string" ? raw : "";
+}
+var DISPLAY_ORDER_MIN = -2147483648;
+var DISPLAY_ORDER_MAX = 2147483647;
+function clampDisplayOrder(raw) {
+  if (!Number.isFinite(raw)) return 0;
+  return Math.min(DISPLAY_ORDER_MAX, Math.max(DISPLAY_ORDER_MIN, Math.trunc(raw)));
+}
+function decodeNativePanes(raw) {
+  if (!Array.isArray(raw)) return null;
+  const decodeRow = (entry, method) => ({
+    method,
+    enabled: entry["enabled"] !== false,
+    label: str(entry["label"]),
+    labelTranslations: parseTranslations2(entry["label_translations"]),
+    sublabel: typeof entry["sublabel"] === "string" ? entry["sublabel"] : null,
+    sublabelTranslations: parseTranslations2(entry["sublabel_translations"]),
+    category: str(entry["category"]),
+    icon: str(entry["icon"]),
+    iconSvg: str(entry["icon_svg"]),
+    displayOrder: clampDisplayOrder(Number(entry["display_order"])),
+    // Anything unrecognised degrades to `always` rather than dropping the row.
+    visibility: entry["visibility"] === "embedded_only" ? "embedded_only" : "always"
+  });
+  const indexByMethod = /* @__PURE__ */ new Map();
+  const out = [];
+  for (const entry of raw) {
+    if (out.length >= NATIVE_PANES_MAX) break;
+    if (!isObject2(entry)) continue;
+    const method = str(entry["method"]).trim();
+    if (!method) continue;
+    const kept = indexByMethod.get(method);
+    if (kept !== void 0) {
+      const enabled = entry["enabled"] !== false;
+      const existing = out[kept];
+      if (enabled && existing && !existing.enabled) out[kept] = decodeRow(entry, method);
+      continue;
+    }
+    indexByMethod.set(method, out.length);
+    out.push(decodeRow(entry, method));
+  }
+  return out;
+}
+function encodeNativePanes(panes) {
+  const nonEmpty = (map) => {
+    const entries = Object.entries(map).filter(([, v]) => v.trim().length > 0);
+    return entries.length > 0 ? Object.fromEntries(entries) : void 0;
+  };
+  return panes.slice(0, NATIVE_PANES_MAX).map((pane) => {
+    const labelTranslations = nonEmpty(pane.labelTranslations);
+    const sublabelTranslations = nonEmpty(pane.sublabelTranslations);
+    return {
+      method: pane.method,
+      enabled: pane.enabled,
+      ...pane.label.trim() ? { label: pane.label.trim() } : {},
+      ...labelTranslations ? { label_translations: labelTranslations } : {},
+      // `null` omits the key entirely (catalog default wins); `''` is sent
+      // as-is because that is how the merchant hides the second line.
+      ...pane.sublabel !== null ? { sublabel: pane.sublabel } : {},
+      ...sublabelTranslations ? { sublabel_translations: sublabelTranslations } : {},
+      ...pane.category.trim() ? { category: pane.category.trim() } : {},
+      ...pane.icon.trim() ? { icon: pane.icon.trim() } : {},
+      ...pane.iconSvg.trim() ? { icon_svg: pane.iconSvg.trim() } : {},
+      // Clamped on encode too, not only decode: the router's strict i32 row
+      // decode drops a row whole for a fractional or out-of-range value, so
+      // writing e.g. 3.5 or Date.now() verbatim would silently delete the
+      // pane at render while every read surface shows it healthy.
+      display_order: clampDisplayOrder(pane.displayOrder),
+      visibility: pane.visibility
+    };
+  });
+}
+function focusedCheckoutUrl(params) {
+  const base = params.checkoutBaseUrl.replace(/\/+$/, "");
+  const path = `${base}/pay/${encodeURIComponent(params.merchantId)}/${encodeURIComponent(
+    params.paymentId
+  )}`;
+  const query = new URLSearchParams({ pane: params.method });
+  if (params.locale) query.set("locale", params.locale);
+  if (params.customFieldsCollected) query.set("cf", "1");
+  return `${path}?${query.toString()}`;
+}
+var CHECKOUT_EVENT_KINDS = [
+  "native_pane_selected",
+  "native_pane_tab_opened",
+  "native_pane_tab_blocked",
+  "native_pane_abandoned"
+];
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ALL_CUSTOM_FIELD_CONDITION_SOURCES,
@@ -4794,6 +5064,7 @@ function shadowFor(style) {
   BRANDING_EXPORT_VERSION,
   CHECKBOX_CHECKED,
   CHECKBOX_UNCHECKED,
+  CHECKOUT_EVENT_KINDS,
   CUSTOM_CSS_MAX_LENGTH,
   CUSTOM_FIELDS_MAX,
   CUSTOM_FIELD_CONDITIONS_MAX,
@@ -4813,7 +5084,11 @@ function shadowFor(style) {
   FeeProgramBuilder,
   Files,
   Forex,
+  NATIVE_PANES_MAX,
+  NATIVE_PANE_CATEGORY_KEYS,
+  NATIVE_PANE_ICON_KEYS,
   Regions,
+  STRIPE_NATIVE_PANE_METHODS,
   Search,
   Subscriptions,
   Webhooks,
@@ -4824,6 +5099,7 @@ function shadowFor(style) {
   buttonPadValue,
   cloneBranding,
   cloneCustomField,
+  cloneNativePane,
   customFieldContextFromMetadata,
   customFieldIsTextLike,
   customFieldOperatorTakesValue,
@@ -4832,15 +5108,19 @@ function shadowFor(style) {
   decodeBadges,
   decodeBranding,
   decodeCustomFields,
+  decodeNativePanes,
   defaultBranding,
   defaultCustomFieldVisibility,
+  defaultNativePane,
   defaultOperatorForSource,
   encodeBadges,
   encodeBranding,
   encodeCustomFields,
+  encodeNativePanes,
   evaluateCustomFieldCondition,
   evaluateCustomFieldVisibility,
   feeProgram,
+  focusedCheckoutUrl,
   fontStack,
   fontWeightValue,
   inputPadValue,
@@ -4849,6 +5129,7 @@ function shadowFor(style) {
   isHexColor,
   leaf,
   logoDimensions,
+  nativePaneMethodInfo,
   parseCustomFieldsLoose,
   parseImportedBranding,
   programToTree,