@delopay/sdk 0.125.0 → 0.127.0

package/dist/index.js

@@ -33,6 +33,10 @@ import {
   Files,
   Forex,
   LOCALIZABLE_COPY_FIELDS,
+  MAX_SECTION_LABEL_LENGTH,
+  MAX_SECTION_ORDER,
+  METHOD_SECTIONS,
+  MIN_SECTION_ORDER,
   NATIVE_PANES_MAX,
   NATIVE_PANE_CATEGORY_KEYS,
   NATIVE_PANE_ICON_KEYS,
@@ -43,6 +47,7 @@ import {
   RTL_CHECKOUT_LOCALES,
   Regions,
   Risk,
+  SECTION_ALIASES,
   STRIPE_FALLBACK_PANE_CATALOG,
   STRIPE_FALLBACK_PANE_METHODS,
   STRIPE_NATIVE_PANE_METHODS,
@@ -59,6 +64,7 @@ import {
   Search,
   Settlement,
   Subscriptions,
+  UNKNOWN_SECTION_ORDER,
   WCAG_AA_TEXT,
   WCAG_AA_UI,
   Webhooks,
@@ -67,12 +73,14 @@ import {
   applyBrandingVariables,
   buildBrandingExport,
   buttonPadValue,
+  canonicalSectionId,
   checkoutCopy,
   checkoutLocaleDir,
   cloneBranding,
   cloneCustomField,
   cloneNativePane,
   clonePane,
+  compareSections,
   contrastRatio,
   copyTranslationsKey,
   customFieldContextFromMetadata,
@@ -83,10 +91,13 @@ import {
   decodeBadges,
   decodeBranding,
   decodeCustomFields,
+  decodeMethodSectionLabels,
+  decodeMethodSectionOrder,
   decodeNativePanes,
   decodePanes,
   defaultBranding,
   defaultCustomFieldVisibility,
+  defaultMethodSectionOrder,
   defaultNativePane,
   defaultOperatorForSource,
   defaultPane,
@@ -94,6 +105,8 @@ import {
   encodeBadges,
   encodeBranding,
   encodeCustomFields,
+  encodeMethodSectionLabels,
+  encodeMethodSectionOrder,
   encodeNativePanes,
   encodePanes,
   evaluateCustomFieldCondition,
@@ -106,6 +119,7 @@ import {
   isCheckboxChecked,
   isDarkSurface,
   isHexColor,
+  knownSectionLabelKey,
   leaf,
   logoDimensions,
   nativePaneMethodInfo,
@@ -122,16 +136,19 @@ import {
   readableInkOn,
   ruleMatchToTree,
   sanitizeCustomCss,
+  sectionLabel,
+  sectionOrderOf,
   shadowFor,
   surchargeFigurePlan,
   surchargeShowsLabel,
   surchargeStyleDrawsAShape,
   surchargeWordFor,
   surfacePadValue,
+  validSectionOrder,
   validatePanes,
   verticalGapValue,
   visibleCustomFields
-} from "./chunk-VJIRHNXT.js";
+} from "./chunk-D44FJRXS.js";
 export {
   ALL_CUSTOM_FIELD_CONDITION_SOURCES,
   ALL_CUSTOM_FIELD_OPERATORS,
@@ -167,6 +184,10 @@ export {
   Files,
   Forex,
   LOCALIZABLE_COPY_FIELDS,
+  MAX_SECTION_LABEL_LENGTH,
+  MAX_SECTION_ORDER,
+  METHOD_SECTIONS,
+  MIN_SECTION_ORDER,
   NATIVE_PANES_MAX,
   NATIVE_PANE_CATEGORY_KEYS,
   NATIVE_PANE_ICON_KEYS,
@@ -177,6 +198,7 @@ export {
   RTL_CHECKOUT_LOCALES,
   Regions,
   Risk,
+  SECTION_ALIASES,
   STRIPE_FALLBACK_PANE_CATALOG,
   STRIPE_FALLBACK_PANE_METHODS,
   STRIPE_NATIVE_PANE_METHODS,
@@ -193,6 +215,7 @@ export {
   Search,
   Settlement,
   Subscriptions,
+  UNKNOWN_SECTION_ORDER,
   WCAG_AA_TEXT,
   WCAG_AA_UI,
   Webhooks,
@@ -201,12 +224,14 @@ export {
   applyBrandingVariables,
   buildBrandingExport,
   buttonPadValue,
+  canonicalSectionId,
   checkoutCopy,
   checkoutLocaleDir,
   cloneBranding,
   cloneCustomField,
   cloneNativePane,
   clonePane,
+  compareSections,
   contrastRatio,
   copyTranslationsKey,
   customFieldContextFromMetadata,
@@ -217,10 +242,13 @@ export {
   decodeBadges,
   decodeBranding,
   decodeCustomFields,
+  decodeMethodSectionLabels,
+  decodeMethodSectionOrder,
   decodeNativePanes,
   decodePanes,
   defaultBranding,
   defaultCustomFieldVisibility,
+  defaultMethodSectionOrder,
   defaultNativePane,
   defaultOperatorForSource,
   defaultPane,
@@ -228,6 +256,8 @@ export {
   encodeBadges,
   encodeBranding,
   encodeCustomFields,
+  encodeMethodSectionLabels,
+  encodeMethodSectionOrder,
   encodeNativePanes,
   encodePanes,
   evaluateCustomFieldCondition,
@@ -240,6 +270,7 @@ export {
   isCheckboxChecked,
   isDarkSurface,
   isHexColor,
+  knownSectionLabelKey,
   leaf,
   logoDimensions,
   nativePaneMethodInfo,
@@ -256,12 +287,15 @@ export {
   readableInkOn,
   ruleMatchToTree,
   sanitizeCustomCss,
+  sectionLabel,
+  sectionOrderOf,
   shadowFor,
   surchargeFigurePlan,
   surchargeShowsLabel,
   surchargeStyleDrawsAShape,
   surchargeWordFor,
   surfacePadValue,
+  validSectionOrder,
   validatePanes,
   verticalGapValue,
   visibleCustomFields

package/dist/internal.cjs

@@ -64,6 +64,10 @@ __export(internal_exports, {
   Forex: () => Forex,
   Gsm: () => Gsm,
   LOCALIZABLE_COPY_FIELDS: () => LOCALIZABLE_COPY_FIELDS,
+  MAX_SECTION_LABEL_LENGTH: () => MAX_SECTION_LABEL_LENGTH,
+  MAX_SECTION_ORDER: () => MAX_SECTION_ORDER,
+  METHOD_SECTIONS: () => METHOD_SECTIONS,
+  MIN_SECTION_ORDER: () => MIN_SECTION_ORDER,
   NATIVE_PANES_MAX: () => NATIVE_PANES_MAX,
   NATIVE_PANE_CATEGORY_KEYS: () => NATIVE_PANE_CATEGORY_KEYS,
   NATIVE_PANE_ICON_KEYS: () => NATIVE_PANE_ICON_KEYS,
@@ -76,6 +80,7 @@ __export(internal_exports, {
   RTL_CHECKOUT_LOCALES: () => RTL_CHECKOUT_LOCALES,
   Regions: () => Regions,
   Risk: () => Risk,
+  SECTION_ALIASES: () => SECTION_ALIASES,
   STRIPE_FALLBACK_PANE_CATALOG: () => STRIPE_FALLBACK_PANE_CATALOG,
   STRIPE_FALLBACK_PANE_METHODS: () => STRIPE_FALLBACK_PANE_METHODS,
   STRIPE_NATIVE_PANE_METHODS: () => STRIPE_NATIVE_PANE_METHODS,
@@ -92,6 +97,7 @@ __export(internal_exports, {
   Search: () => Search,
   Settlement: () => Settlement,
   Subscriptions: () => Subscriptions,
+  UNKNOWN_SECTION_ORDER: () => UNKNOWN_SECTION_ORDER,
   WCAG_AA_TEXT: () => WCAG_AA_TEXT,
   WCAG_AA_UI: () => WCAG_AA_UI,
   Webhooks: () => Webhooks,
@@ -100,12 +106,14 @@ __export(internal_exports, {
   applyBrandingVariables: () => applyBrandingVariables,
   buildBrandingExport: () => buildBrandingExport,
   buttonPadValue: () => buttonPadValue,
+  canonicalSectionId: () => canonicalSectionId,
   checkoutCopy: () => checkoutCopy,
   checkoutLocaleDir: () => checkoutLocaleDir,
   cloneBranding: () => cloneBranding,
   cloneCustomField: () => cloneCustomField,
   cloneNativePane: () => cloneNativePane,
   clonePane: () => clonePane,
+  compareSections: () => compareSections,
   contrastRatio: () => contrastRatio,
   copyTranslationsKey: () => copyTranslationsKey,
   customFieldContextFromMetadata: () => customFieldContextFromMetadata,
@@ -116,10 +124,13 @@ __export(internal_exports, {
   decodeBadges: () => decodeBadges,
   decodeBranding: () => decodeBranding,
   decodeCustomFields: () => decodeCustomFields,
+  decodeMethodSectionLabels: () => decodeMethodSectionLabels,
+  decodeMethodSectionOrder: () => decodeMethodSectionOrder,
   decodeNativePanes: () => decodeNativePanes,
   decodePanes: () => decodePanes,
   defaultBranding: () => defaultBranding,
   defaultCustomFieldVisibility: () => defaultCustomFieldVisibility,
+  defaultMethodSectionOrder: () => defaultMethodSectionOrder,
   defaultNativePane: () => defaultNativePane,
   defaultOperatorForSource: () => defaultOperatorForSource,
   defaultPane: () => defaultPane,
@@ -127,6 +138,8 @@ __export(internal_exports, {
   encodeBadges: () => encodeBadges,
   encodeBranding: () => encodeBranding,
   encodeCustomFields: () => encodeCustomFields,
+  encodeMethodSectionLabels: () => encodeMethodSectionLabels,
+  encodeMethodSectionOrder: () => encodeMethodSectionOrder,
   encodeNativePanes: () => encodeNativePanes,
   encodePanes: () => encodePanes,
   evaluateCustomFieldCondition: () => evaluateCustomFieldCondition,
@@ -139,6 +152,7 @@ __export(internal_exports, {
   isCheckboxChecked: () => isCheckboxChecked,
   isDarkSurface: () => isDarkSurface,
   isHexColor: () => isHexColor,
+  knownSectionLabelKey: () => knownSectionLabelKey,
   leaf: () => leaf,
   logoDimensions: () => logoDimensions,
   nativePaneMethodInfo: () => nativePaneMethodInfo,
@@ -155,12 +169,15 @@ __export(internal_exports, {
   readableInkOn: () => readableInkOn,
   ruleMatchToTree: () => ruleMatchToTree,
   sanitizeCustomCss: () => sanitizeCustomCss,
+  sectionLabel: () => sectionLabel,
+  sectionOrderOf: () => sectionOrderOf,
   shadowFor: () => shadowFor,
   surchargeFigurePlan: () => surchargeFigurePlan,
   surchargeShowsLabel: () => surchargeShowsLabel,
   surchargeStyleDrawsAShape: () => surchargeStyleDrawsAShape,
   surchargeWordFor: () => surchargeWordFor,
   surfacePadValue: () => surfacePadValue,
+  validSectionOrder: () => validSectionOrder,
   validatePanes: () => validatePanes,
   verticalGapValue: () => verticalGapValue,
   visibleCustomFields: () => visibleCustomFields
@@ -5634,6 +5651,151 @@ var DEFAULT_BADGES_DARK = [
     borderColor: "#1e40af"
   }
 ];
+var METHOD_SECTION_ORDER_KEY = "methodSectionOrder";
+var METHOD_SECTION_LABELS_KEY = "methodSectionLabels";
+var MIN_SECTION_ORDER = 1;
+var MAX_SECTION_ORDER = 100;
+var MAX_SECTION_LABEL_LENGTH = 120;
+var METHOD_SECTIONS = [
+  { id: "card", labelKey: "sections.card", order: 10 },
+  { id: "wallet", labelKey: "sections.wallets", order: 20 },
+  { id: "bnpl", labelKey: "sections.bnpl", order: 30 },
+  { id: "bank_redirect", labelKey: "sections.onlineBanking", order: 40 },
+  { id: "bank_transfer", labelKey: "sections.bankTransfer", order: 45 },
+  { id: "crypto", labelKey: "sections.cryptocurrency", order: 50 },
+  { id: "game_items", labelKey: "sections.gameItems", order: 60 },
+  { id: "voucher", labelKey: "sections.vouchers", order: 70 },
+  { id: "gift_card", labelKey: "sections.giftCards", order: 75 },
+  { id: "reward", labelKey: "sections.rewards", order: 80 },
+  { id: "cash", labelKey: "sections.cash", order: 90 }
+];
+var SECTION_ALIASES = {
+  card_redirect: "card"
+};
+var UNKNOWN_SECTION_ORDER = MAX_SECTION_ORDER;
+function canonicalSectionId(category) {
+  return SECTION_ALIASES[category] ?? category;
+}
+function defaultMethodSectionOrder() {
+  const order = {};
+  for (const section of METHOD_SECTIONS) order[section.id] = section.order;
+  return order;
+}
+function validSectionOrder(raw) {
+  if (typeof raw !== "number" || !Number.isInteger(raw)) return null;
+  if (raw < MIN_SECTION_ORDER || raw > MAX_SECTION_ORDER) return null;
+  return raw;
+}
+function decodeMethodSectionOrder(raw) {
+  const order = defaultMethodSectionOrder();
+  if (raw === void 0) return order;
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return order;
+  }
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) return order;
+  for (const [key, value] of Object.entries(parsed)) {
+    const valid = validSectionOrder(value);
+    if (valid === null) continue;
+    order[canonicalSectionId(key)] = valid;
+  }
+  return order;
+}
+function encodeMethodSectionOrder(order) {
+  return JSON.stringify(order);
+}
+function decodeMethodSectionLabels(raw) {
+  if (raw === void 0) return {};
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return {};
+  }
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+  const labels = {};
+  for (const [section, byLocale] of Object.entries(parsed)) {
+    if (!section || byLocale === null || typeof byLocale !== "object" || Array.isArray(byLocale)) {
+      continue;
+    }
+    const kept = {};
+    for (const [locale, text] of Object.entries(byLocale)) {
+      if (typeof text !== "string") continue;
+      const trimmed = text.trim();
+      if (!trimmed) continue;
+      kept[locale] = trimmed.slice(0, MAX_SECTION_LABEL_LENGTH);
+    }
+    if (Object.keys(kept).length > 0) labels[canonicalSectionId(section)] = kept;
+  }
+  return labels;
+}
+function encodeMethodSectionLabels(labels) {
+  const cleaned = {};
+  for (const [section, byLocale] of Object.entries(labels)) {
+    const kept = {};
+    for (const [locale, text] of Object.entries(byLocale)) {
+      const trimmed = (text ?? "").trim();
+      if (trimmed) kept[locale] = trimmed.slice(0, MAX_SECTION_LABEL_LENGTH);
+    }
+    if (Object.keys(kept).length > 0) cleaned[section] = kept;
+  }
+  return Object.keys(cleaned).length > 0 ? JSON.stringify(cleaned) : null;
+}
+function sectionCatalogueIndex(sectionId) {
+  const index = METHOD_SECTIONS.findIndex((section) => section.id === sectionId);
+  return index === -1 ? METHOD_SECTIONS.length : index;
+}
+function sectionOrderOf(order, category) {
+  return order[canonicalSectionId(category)] ?? UNKNOWN_SECTION_ORDER;
+}
+function compareSections(order) {
+  return (a, b) => {
+    const left = canonicalSectionId(a);
+    const right = canonicalSectionId(b);
+    const byOrder = sectionOrderOf(order, left) - sectionOrderOf(order, right);
+    if (byOrder !== 0) return byOrder;
+    const byCatalogue = sectionCatalogueIndex(left) - sectionCatalogueIndex(right);
+    if (byCatalogue !== 0) return byCatalogue;
+    return left < right ? -1 : left > right ? 1 : 0;
+  };
+}
+function sectionLabel(labels, category, locale, knownKey, translate) {
+  const id = canonicalSectionId(category);
+  if (id in labels) {
+    const captions = labels[id];
+    const matched = translationFor(captions, locale)?.trim();
+    if (matched) return matched;
+    for (const value of Object.values(captions)) {
+      const any = value.trim();
+      if (any) return any;
+    }
+  }
+  if (knownKey) {
+    const translated = translate(knownKey);
+    if (translated) return translated;
+  }
+  return category;
+}
+function parseSectionOrderLoose(raw) {
+  if (typeof raw === "string") return decodeMethodSectionOrder(raw);
+  if (raw !== null && typeof raw === "object" && !Array.isArray(raw)) {
+    return decodeMethodSectionOrder(JSON.stringify(raw));
+  }
+  return defaultMethodSectionOrder();
+}
+function parseSectionLabelsLoose(raw) {
+  if (typeof raw === "string") return decodeMethodSectionLabels(raw);
+  if (raw !== null && typeof raw === "object" && !Array.isArray(raw)) {
+    return decodeMethodSectionLabels(JSON.stringify(raw));
+  }
+  return {};
+}
+function knownSectionLabelKey(category) {
+  const id = canonicalSectionId(category);
+  return METHOD_SECTIONS.find((section) => section.id === id)?.labelKey;
+}
 var DEFAULT_BRANDING_BASE = {
   displayName: "",
   logoUrl: "",
@@ -5722,7 +5884,9 @@ var DEFAULT_BRANDING = {
   ...DEFAULT_BRANDING_BASE,
   ...LIGHT_PALETTE,
   trustBadges: DEFAULT_BADGES.map((b) => ({ ...b })),
-  customFields: []
+  customFields: [],
+  methodSectionOrder: defaultMethodSectionOrder(),
+  methodSectionLabels: {}
 };
 var DEFAULT_BRANDING_DARK = {
   ...DEFAULT_BRANDING_BASE,
@@ -5743,7 +5907,9 @@ var DEFAULT_BRANDING_DARK = {
   surchargeColor: "#fbbf24",
   discountColor: "#34d399",
   trustBadges: DEFAULT_BADGES_DARK.map((b) => ({ ...b })),
-  customFields: []
+  customFields: [],
+  methodSectionOrder: defaultMethodSectionOrder(),
+  methodSectionLabels: {}
 };
 function defaultBranding() {
   return cloneBranding(DEFAULT_BRANDING);
@@ -5753,6 +5919,10 @@ function cloneBranding(b) {
     ...b,
     trustBadges: b.trustBadges.map((badge) => ({ ...badge })),
     customFields: b.customFields.map(cloneCustomField),
+    methodSectionOrder: { ...b.methodSectionOrder },
+    methodSectionLabels: Object.fromEntries(
+      Object.entries(b.methodSectionLabels).map(([id, byLocale]) => [id, { ...byLocale }])
+    ),
     // Copied, not shared. A spread alone would leave the clone pointing at the
     // original's maps, and the dashboard edits a clone precisely so the form
     // can be abandoned without touching what is saved.
@@ -6368,6 +6538,8 @@ function decodeBranding(source) {
     showOrderItems: parseBool(extras["showOrderItems"], DEFAULT_BRANDING.showOrderItems),
     trustBadges: decodedBadges ?? DEFAULT_BRANDING.trustBadges.map((b) => ({ ...b })),
     customFields: decodedCustomFields ?? [],
+    methodSectionOrder: decodeMethodSectionOrder(extras[METHOD_SECTION_ORDER_KEY]),
+    methodSectionLabels: decodeMethodSectionLabels(extras[METHOD_SECTION_LABELS_KEY]),
     headerText: s(source.payment_form_header_text),
     payButtonLabel: s(source.payment_button_text),
     cardTermsMessage: s(source.custom_message_for_card_terms),
@@ -6434,8 +6606,11 @@ function encodeBranding(branding, base) {
     logoShape: branding.logoShape,
     logoSize: branding.logoSize,
     labelStyle: branding.labelStyle,
-    trustBadges: encodeBadges(branding.trustBadges)
+    trustBadges: encodeBadges(branding.trustBadges),
+    [METHOD_SECTION_ORDER_KEY]: encodeMethodSectionOrder(branding.methodSectionOrder)
   };
+  const sectionLabels = encodeMethodSectionLabels(branding.methodSectionLabels);
+  if (sectionLabels) extras[METHOD_SECTION_LABELS_KEY] = sectionLabels;
   if (branding.customFields.length > 0) {
     extras["customFields"] = encodeCustomFields(branding.customFields);
   }
@@ -6637,6 +6812,10 @@ function parseImportedBranding(raw) {
     showOrderItems: parseBool(root["showOrderItems"], dflt.showOrderItems),
     trustBadges,
     customFields,
+    // An export writes the decoded maps; a hand-written file may carry the
+    // JSON strings the bag uses. Both are accepted, and neither is required.
+    methodSectionOrder: parseSectionOrderLoose(root[METHOD_SECTION_ORDER_KEY]),
+    methodSectionLabels: parseSectionLabelsLoose(root[METHOD_SECTION_LABELS_KEY]),
     headerText: sStr(root["headerText"], dflt.headerText),
     payButtonLabel: sStr(root["payButtonLabel"], dflt.payButtonLabel),
     cardTermsMessage: sStr(root["cardTermsMessage"], dflt.cardTermsMessage),
@@ -8458,6 +8637,10 @@ var DelopayInternal = class extends Delopay {
   Forex,
   Gsm,
   LOCALIZABLE_COPY_FIELDS,
+  MAX_SECTION_LABEL_LENGTH,
+  MAX_SECTION_ORDER,
+  METHOD_SECTIONS,
+  MIN_SECTION_ORDER,
   NATIVE_PANES_MAX,
   NATIVE_PANE_CATEGORY_KEYS,
   NATIVE_PANE_ICON_KEYS,
@@ -8470,6 +8653,7 @@ var DelopayInternal = class extends Delopay {
   RTL_CHECKOUT_LOCALES,
   Regions,
   Risk,
+  SECTION_ALIASES,
   STRIPE_FALLBACK_PANE_CATALOG,
   STRIPE_FALLBACK_PANE_METHODS,
   STRIPE_NATIVE_PANE_METHODS,
@@ -8486,6 +8670,7 @@ var DelopayInternal = class extends Delopay {
   Search,
   Settlement,
   Subscriptions,
+  UNKNOWN_SECTION_ORDER,
   WCAG_AA_TEXT,
   WCAG_AA_UI,
   Webhooks,
@@ -8494,12 +8679,14 @@ var DelopayInternal = class extends Delopay {
   applyBrandingVariables,
   buildBrandingExport,
   buttonPadValue,
+  canonicalSectionId,
   checkoutCopy,
   checkoutLocaleDir,
   cloneBranding,
   cloneCustomField,
   cloneNativePane,
   clonePane,
+  compareSections,
   contrastRatio,
   copyTranslationsKey,
   customFieldContextFromMetadata,
@@ -8510,10 +8697,13 @@ var DelopayInternal = class extends Delopay {
   decodeBadges,
   decodeBranding,
   decodeCustomFields,
+  decodeMethodSectionLabels,
+  decodeMethodSectionOrder,
   decodeNativePanes,
   decodePanes,
   defaultBranding,
   defaultCustomFieldVisibility,
+  defaultMethodSectionOrder,
   defaultNativePane,
   defaultOperatorForSource,
   defaultPane,
@@ -8521,6 +8711,8 @@ var DelopayInternal = class extends Delopay {
   encodeBadges,
   encodeBranding,
   encodeCustomFields,
+  encodeMethodSectionLabels,
+  encodeMethodSectionOrder,
   encodeNativePanes,
   encodePanes,
   evaluateCustomFieldCondition,
@@ -8533,6 +8725,7 @@ var DelopayInternal = class extends Delopay {
   isCheckboxChecked,
   isDarkSurface,
   isHexColor,
+  knownSectionLabelKey,
   leaf,
   logoDimensions,
   nativePaneMethodInfo,
@@ -8549,12 +8742,15 @@ var DelopayInternal = class extends Delopay {
   readableInkOn,
   ruleMatchToTree,
   sanitizeCustomCss,
+  sectionLabel,
+  sectionOrderOf,
   shadowFor,
   surchargeFigurePlan,
   surchargeShowsLabel,
   surchargeStyleDrawsAShape,
   surchargeWordFor,
   surfacePadValue,
+  validSectionOrder,
   validatePanes,
   verticalGapValue,
   visibleCustomFields