@delopay/sdk 0.163.0 → 0.165.0

package/dist/{chunk-Y6TADN6R.js → chunk-CP5M5WR6.js}

@@ -1763,6 +1763,16 @@ var Payments = class {
    * Not the hosted-shop settlement API under `settlement.*`, which is host →
    * shop owner and manual; this is acquirer → merchant bank, per payment.
    *
+   * Each attempt also carries what the rail itself took for it —
+   * `processor_cost_amount` with its own `processor_cost_currency` and
+   * `processor_cost_exponent`, the `processor_cost_source` that says how the
+   * figure was obtained, the `processor_cost_basis` behind an estimate, and
+   * the `connector_method_code` it was priced under. Recorded for **every**
+   * merchant, not only those that host shops. Never present an `estimated`
+   * cost as an observation, and read an absent `processor_cost_source` as
+   * "nothing was ever written", which is not the `unavailable` the rail
+   * answers with.
+   *
    * `GET /payments/{paymentId}/settlement`
    *
    * @param paymentId - The payment intent ID.
@@ -1781,6 +1791,9 @@ var Payments = class {
    *   if (attempt.status === 'paid_out') {
    *     console.log(attempt.paid_out_at, attempt.payout_reference);
    *   }
+   *   if (attempt.processor_cost_source === 'estimated') {
+   *     // Label it an estimate — it was derived from a cost schedule.
+   *   }
    * }
    * ```
    */
@@ -5016,6 +5029,65 @@ var Settlement = class {
       ...options
     });
   }
+  /**
+   * What a period's payments cost at the rails, grouped by shop, connector
+   * and payment method. Answers for **every** merchant, including one that
+   * hosts nobody — it reads the per-attempt settlement record rather than the
+   * settlement lines, which exist only where hosting fees are configured.
+   *
+   * A sibling of {@link Settlement.cost} rather than a widening of it. That
+   * endpoint is a profit statement whose revenue term is hosting income, and
+   * a merchant who hosts nobody has none. This publishes cost and never
+   * margin.
+   *
+   * Send `year` and `month` together to report one UTC calendar month, or
+   * neither for the running month so far.
+   *
+   * **The response carries no period total, and a caller must not compute
+   * one here.** Every figure keeps the unit the rail reported it in, and the
+   * unit is part of each bucket's key, so adding two buckets is not addition.
+   * Convert caller-side if you need one number, and say which rates you used.
+   * The counts are totalled, because a count has no unit.
+   *
+   * Two distinctions not to flatten when rendering a bucket:
+   * `cost_amount` covers `reported_count + estimated_count` attempts out of
+   * `attempt_count` and is a lower bound whenever those disagree; and
+   * `unavailable_count` (the rail says it has no figure) means something
+   * different from `unwritten_count` (a gap in our own recording).
+   *
+   * **Merchant scope.** A token scoped to a single shop, a role narrowed to
+   * specific connector accounts, or a role without the settlement-read
+   * permission group is refused `403`: what a rail charged is the merchant's
+   * own cost base, and here it is the whole response, so there is nothing
+   * coherent to redact down to. Gate the surface on the caller's scope rather
+   * than calling it and handling the failure.
+   *
+   * `GET /settlement/processor-cost`
+   *
+   * @example
+   * ```typescript
+   * const period = await delopay.settlement.processorCost({
+   *   test_mode: false,
+   *   year: 2026,
+   *   month: 7,
+   * });
+   * for (const bucket of period.buckets) {
+   *   // Each bucket is its own unit — render per bucket, never a sum.
+   *   console.log(bucket.connector, bucket.cost_amount, bucket.cost_currency);
+   * }
+   * ```
+   */
+  async processorCost(params, options) {
+    return this.request("GET", "/settlement/processor-cost", {
+      query: {
+        profile_id: params?.profile_id,
+        test_mode: params?.test_mode,
+        year: params?.year,
+        month: params?.month
+      },
+      ...options
+    });
+  }
   /**
    * List generated settlement statements, newest first.
    *
@@ -6424,6 +6496,66 @@ function surchargeWordFor(branding, isDiscount, locale) {
     locale
   );
 }
+var NOTICE_SECTIONS = ["summary", "payment"];
+var NOTICES_PER_SECTION = 3;
+var NOTICE_LABEL_MAX_LENGTH = 80;
+var NOTICE_ICONS = [
+  "lock",
+  "shield",
+  "check",
+  "truck",
+  "package",
+  "refresh",
+  "star",
+  "support",
+  "globe",
+  "tag",
+  "heart",
+  "leaf",
+  "clock",
+  "bank"
+];
+var NOTICE_ICON_FALLBACK = "check";
+var NOTICE_ICON_PATHS = {
+  lock: [
+    "M6 10h12a2 2 0 0 1 2 2v7a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-7a2 2 0 0 1 2-2z",
+    "M8 10V7a4 4 0 0 1 8 0v3"
+  ],
+  shield: ["M12 3l7 3v6c0 4.2-2.9 7.6-7 9-4.1-1.4-7-4.8-7-9V6z", "M9 12l2.5 2.5 4-4.5"],
+  check: ["M21 12a9 9 0 1 1-18 0a9 9 0 1 1 18 0z", "M8 12.5l3 3 5-6"],
+  truck: [
+    "M3 7.5h10v9H3z",
+    "M13 11h4l3 3v2.5h-7z",
+    "M8.8 18a1.8 1.8 0 1 1-3.6 0a1.8 1.8 0 1 1 3.6 0z",
+    "M18.8 18a1.8 1.8 0 1 1-3.6 0a1.8 1.8 0 1 1 3.6 0z"
+  ],
+  package: [
+    "M11 21.73a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73z",
+    "M12 22V12",
+    "M3.29 7L12 12l8.71-5"
+  ],
+  refresh: ["M20 12a8 8 0 1 1-2.5-5.8", "M20 4v5h-5"],
+  star: ["m12 3.6 2.6 5.3 5.9.9-4.3 4.1 1 5.8-5.2-2.7-5.2 2.7 1-5.8-4.3-4.1 5.9-.9z"],
+  support: [
+    "M5 13v-1a7 7 0 0 1 14 0v1",
+    "M3.5 14.5a1.8 1.8 0 0 1 1.8-1.8H7v5H5.3a1.8 1.8 0 0 1-1.8-1.8z",
+    "M20.5 14.5a1.8 1.8 0 0 0-1.8-1.8H17v5h1.7a1.8 1.8 0 0 0 1.8-1.8z",
+    "M19 17.7v.8a2.5 2.5 0 0 1-2.5 2.5H13"
+  ],
+  globe: [
+    "M21 12a9 9 0 1 1-18 0a9 9 0 1 1 18 0z",
+    "M3 12h18",
+    "M12 3a14 14 0 0 1 0 18a14 14 0 0 1 0-18z"
+  ],
+  tag: ["M11 3H4v7l10 10 7-7z", "M9.1 7a1.3 1.3 0 1 1-2.6 0a1.3 1.3 0 1 1 2.6 0z"],
+  heart: ["M12 20s-7-4.4-7-9.3A3.9 3.9 0 0 1 12 8a3.9 3.9 0 0 1 7 2.7c0 4.9-7 9.3-7 9.3z"],
+  leaf: ["M20 4c0 9-5.4 13-9.5 13A4.5 4.5 0 0 1 6 12.5C6 7 12 4 20 4z", "M4 20c2-4.5 5-7.5 9-9.5"],
+  clock: ["M21 12a9 9 0 1 1-18 0a9 9 0 1 1 18 0z", "M12 7v5l3 2"],
+  bank: ["M3 9.5 12 4l9 5.5", "M5 10v8M9.5 10v8M14.5 10v8M19 10v8", "M3 20h18"]
+};
+function isNoticeIcon(value) {
+  return typeof value === "string" && NOTICE_ICONS.includes(value);
+}
 var FONT_STACKS = {
   inter: "'Inter Variable', 'Inter', system-ui, -apple-system, sans-serif",
   system: "system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif",
@@ -6593,6 +6725,96 @@ var DEFAULT_BADGES_DARK = [
     borderColor: "#1e40af"
   }
 ];
+var DEFAULT_NOTICES = [
+  {
+    id: "secure",
+    section: "summary",
+    icon: "shield",
+    label: "Secure payment",
+    labelTranslations: {
+      de: "Sichere Zahlung",
+      fr: "Paiement s\xE9curis\xE9",
+      es: "Pago seguro",
+      it: "Pagamento sicuro",
+      nl: "Veilig betalen",
+      zh: "\u5B89\u5168\u652F\u4ED8",
+      "zh-Hant": "\u5B89\u5168\u4ED8\u6B3E",
+      hi: "\u0938\u0941\u0930\u0915\u094D\u0937\u093F\u0924 \u092D\u0941\u0917\u0924\u093E\u0928",
+      ar: "\u062F\u0641\u0639 \u0622\u0645\u0646"
+    }
+  },
+  {
+    id: "ssl",
+    section: "summary",
+    icon: "lock",
+    label: "Encrypted \xB7 256-bit SSL",
+    labelTranslations: {
+      de: "Verschl\xFCsselt \xB7 256-Bit-SSL",
+      fr: "Chiffr\xE9 \xB7 SSL 256 bits",
+      es: "Cifrado \xB7 SSL de 256 bits",
+      it: "Crittografato \xB7 SSL a 256 bit",
+      nl: "Versleuteld \xB7 256-bit SSL",
+      zh: "\u52A0\u5BC6 \xB7 256 \u4F4D SSL",
+      "zh-Hant": "\u52A0\u5BC6 \xB7 256 \u4F4D\u5143 SSL",
+      hi: "\u090F\u0928\u094D\u0915\u094D\u0930\u093F\u092A\u094D\u091F\u0947\u0921 \xB7 256-\u092C\u093F\u091F SSL",
+      ar: "\u0645\u0634\u0641\u0651\u0631 \xB7 SSL \u0628\u0637\u0648\u0644 256 \u0628\u062A"
+    }
+  }
+];
+function defaultNotices() {
+  return DEFAULT_NOTICES.map(cloneNotice);
+}
+function cloneNotice(notice) {
+  return { ...notice, labelTranslations: { ...notice.labelTranslations } };
+}
+function hexChannels(hex) {
+  const raw = /^#([0-9a-f]{6})$/i.exec(hex.trim())?.[1];
+  if (!raw) return null;
+  return [
+    parseInt(raw.slice(0, 2), 16),
+    parseInt(raw.slice(2, 4), 16),
+    parseInt(raw.slice(4, 6), 16)
+  ];
+}
+function isThemeTintedBadgeColouring(textColor, fill, border) {
+  const primary = hexChannels(textColor);
+  const bg = hexChannels(fill);
+  const line = hexChannels(border);
+  if (!primary || !bg || !line) return false;
+  const mixed = (surface, to, share) => Math.round(surface + (to - surface) * share);
+  return primary.every((p, i) => {
+    for (let surface = 0; surface <= 255; surface += 1) {
+      if (mixed(surface, p, 0.08) === bg[i] && mixed(surface, p, 0.3) === line[i]) return true;
+    }
+    return false;
+  });
+}
+function isDefaultBadgeSet(badges) {
+  if (badges.length !== DEFAULT_BADGES.length) return false;
+  const sameContent = badges.every(
+    (badge, i) => badge.id === DEFAULT_BADGES[i]?.id && badge.label === DEFAULT_BADGES[i]?.label
+  );
+  if (!sameContent) return false;
+  const colouring = (set) => set.map((b) => [b.textColor, b.backgroundColor, b.borderColor ?? ""].join("|").toLowerCase()).join("/");
+  const mine = colouring(badges);
+  if (mine === colouring(DEFAULT_BADGES) || mine === colouring(DEFAULT_BADGES_DARK)) return true;
+  const [first] = badges;
+  const border = first?.borderColor;
+  if (!first || !border) return false;
+  const same = (a, b) => (a ?? "").toLowerCase() === b.toLowerCase();
+  return badges.every(
+    (b) => same(b.textColor, first.textColor) && same(b.backgroundColor, first.backgroundColor) && same(b.borderColor, border)
+  ) && isThemeTintedBadgeColouring(first.textColor, first.backgroundColor, border);
+}
+function resolveNoticesAndBadges(savedBadges, savedNotices) {
+  if (savedNotices !== null) {
+    return { trustBadges: savedBadges ?? [], notices: savedNotices };
+  }
+  if (savedBadges === null || isDefaultBadgeSet(savedBadges)) {
+    return { trustBadges: [], notices: defaultNotices() };
+  }
+  return { trustBadges: savedBadges, notices: [] };
+}
 var METHOD_SECTION_ORDER_KEY = "methodSectionOrder";
 var METHOD_SECTION_LABELS_KEY = "methodSectionLabels";
 var MIN_SECTION_ORDER = 1;
@@ -6879,7 +7101,11 @@ var DEFAULT_BRANDING_BASE = {
 var DEFAULT_BRANDING = {
   ...DEFAULT_BRANDING_BASE,
   ...LIGHT_PALETTE,
-  trustBadges: DEFAULT_BADGES.map((b) => ({ ...b })),
+  // No badges by default since todos#218 — notices took their place.
+  // `DEFAULT_BADGES` stays exported because `isDefaultBadgeSet` still has to
+  // recognise the pair on shops saved before.
+  trustBadges: [],
+  notices: defaultNotices(),
   customFields: [],
   methodSectionOrder: defaultMethodSectionOrder(),
   methodSectionLabels: {}
@@ -6902,7 +7128,8 @@ var DEFAULT_BRANDING_DARK = {
   // end of the ramp — 10.69 and 9.29 against the dark surface, also pinned.
   surchargeColor: "#fbbf24",
   discountColor: "#34d399",
-  trustBadges: DEFAULT_BADGES_DARK.map((b) => ({ ...b })),
+  trustBadges: [],
+  notices: defaultNotices(),
   customFields: [],
   methodSectionOrder: defaultMethodSectionOrder(),
   methodSectionLabels: {}
@@ -6914,6 +7141,7 @@ function cloneBranding(b) {
   return {
     ...b,
     trustBadges: b.trustBadges.map((badge) => ({ ...badge })),
+    notices: b.notices.map(cloneNotice),
     customFields: b.customFields.map(cloneCustomField),
     methodSectionOrder: { ...b.methodSectionOrder },
     methodSectionLabels: Object.fromEntries(
@@ -7023,6 +7251,80 @@ function encodeBadges(badges) {
     }))
   );
 }
+var NOTICE_ID_MAX_LENGTH = 40;
+function capNoticeText(value) {
+  return Array.from(value).slice(0, NOTICE_LABEL_MAX_LENGTH).join("");
+}
+function normalizeNotices(list) {
+  const seen = /* @__PURE__ */ new Set();
+  const perSection = /* @__PURE__ */ new Map();
+  const out = [];
+  list.forEach((raw, index) => {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) return;
+    const src = raw;
+    const label = typeof src["label"] === "string" ? capNoticeText(src["label"]) : "";
+    const labelTranslations = {};
+    for (const [locale, text] of Object.entries(parseTranslations(src["labelTranslations"]))) {
+      labelTranslations[locale] = capNoticeText(text);
+    }
+    if (label.trim().length === 0 && Object.keys(labelTranslations).length === 0) return;
+    const section = pickEnum(src["section"], NOTICE_SECTIONS, "summary");
+    const used = perSection.get(section) ?? 0;
+    if (used >= NOTICES_PER_SECTION) return;
+    perSection.set(section, used + 1);
+    let id = typeof src["id"] === "string" ? src["id"].replace(/[^A-Za-z0-9_-]/g, "").slice(0, NOTICE_ID_MAX_LENGTH) : "";
+    if (!id || seen.has(id)) id = `notice-${index + 1}`;
+    while (seen.has(id)) id = `${id}x`;
+    seen.add(id);
+    out.push({
+      id,
+      section,
+      icon: isNoticeIcon(src["icon"]) ? src["icon"] : NOTICE_ICON_FALLBACK,
+      label,
+      labelTranslations
+    });
+  });
+  return out;
+}
+function decodeNotices(raw) {
+  if (raw === void 0) return null;
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return null;
+  }
+  return Array.isArray(parsed) ? normalizeNotices(parsed) : null;
+}
+function parseNoticesLoose(raw) {
+  if (typeof raw === "string") return decodeNotices(raw);
+  return Array.isArray(raw) ? normalizeNotices(raw) : null;
+}
+function encodeNotices(notices) {
+  return JSON.stringify(
+    notices.map((n) => {
+      const translations = Object.entries(n.labelTranslations).filter(
+        ([, text]) => text.trim().length > 0
+      );
+      return {
+        id: n.id,
+        section: n.section,
+        icon: n.icon,
+        label: n.label,
+        ...translations.length > 0 ? { labelTranslations: Object.fromEntries(translations) } : {}
+      };
+    })
+  );
+}
+function noticeText(notice, locale) {
+  return translationFor(notice.labelTranslations, locale) ?? notice.label;
+}
+function noticesIn(notices, section) {
+  return notices.filter((n) => n.section === section).slice(0, NOTICES_PER_SECTION);
+}
+function shownNotices(notices, section, locale) {
+  return noticesIn(notices, section).map((notice) => ({ notice, text: noticeText(notice, locale).trim() })).filter((entry) => entry.text.length > 0);
+}
 var CUSTOM_FIELDS_MAX = 20;
 var CUSTOM_FIELD_KEY_PATTERN = /^[A-Za-z][A-Za-z0-9_-]{0,39}$/;
 var ALL_CUSTOM_FIELD_TYPES = [
@@ -7366,7 +7668,10 @@ function customFieldOptionLabel(option, locale) {
 function decodeBranding(source) {
   if (!source) return cloneBranding(DEFAULT_BRANDING);
   const extras = source.sdk_ui_rules?.[BRANDING_GROUP_KEY] ?? {};
-  const decodedBadges = decodeBadges(extras["trustBadges"]);
+  const trustRow = resolveNoticesAndBadges(
+    decodeBadges(extras["trustBadges"]),
+    decodeNotices(extras["notices"])
+  );
   const decodedCustomFields = decodeCustomFields(extras["customFields"]);
   const displayName = s(source.merchant_name) || s(source.seller_name);
   const logoUrl = s(source.merchant_logo) || s(source.logo);
@@ -7545,7 +7850,8 @@ function decodeBranding(source) {
     totalLabel: s(extras["totalLabel"]) || DEFAULT_BRANDING.totalLabel,
     showCurrencyCode: parseBool(extras["showCurrencyCode"], DEFAULT_BRANDING.showCurrencyCode),
     showOrderItems: parseBool(extras["showOrderItems"], DEFAULT_BRANDING.showOrderItems),
-    trustBadges: decodedBadges ?? DEFAULT_BRANDING.trustBadges.map((b) => ({ ...b })),
+    trustBadges: trustRow.trustBadges,
+    notices: trustRow.notices,
     customFields: decodedCustomFields ?? [],
     methodSectionOrder: decodeMethodSectionOrder(extras[METHOD_SECTION_ORDER_KEY]),
     methodSectionLabels: decodeMethodSectionLabels(extras[METHOD_SECTION_LABELS_KEY]),
@@ -7829,9 +8135,14 @@ function encodeBranding(branding, base) {
     nomupayApplePayButtonType: branding.nomupayApplePayButtonType,
     nomupayGooglePayButtonColor: branding.nomupayGooglePayButtonColor,
     nomupayGooglePayButtonType: branding.nomupayGooglePayButtonType,
-    trustBadges: encodeBadges(branding.trustBadges),
+    // Always written, `[]` included — its presence is what stops a later
+    // decode from migrating the shop again (`resolveNoticesAndBadges`).
+    notices: encodeNotices(branding.notices),
     [METHOD_SECTION_ORDER_KEY]: encodeMethodSectionOrder(branding.methodSectionOrder)
   };
+  if (branding.trustBadges.length > 0) {
+    extras["trustBadges"] = encodeBadges(branding.trustBadges);
+  }
   const sectionLabels = encodeMethodSectionLabels(branding.methodSectionLabels);
   if (sectionLabels) extras[METHOD_SECTION_LABELS_KEY] = sectionLabels;
   if (branding.customFields.length > 0) {
@@ -7897,7 +8208,10 @@ function parseImportedBranding(raw) {
   const dflt = DEFAULT_BRANDING;
   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 { trustBadges, notices } = resolveNoticesAndBadges(
+    parseTrustBadgesLoose(root["trustBadges"]),
+    parseNoticesLoose(root["notices"])
+  );
   const customFields = parseCustomFieldsLoose(root["customFields"]) ?? [];
   const labelStyle = (() => {
     const v = root["labelStyle"];
@@ -8040,6 +8354,7 @@ function parseImportedBranding(raw) {
     showCurrencyCode: parseBool(root["showCurrencyCode"], dflt.showCurrencyCode),
     showOrderItems: parseBool(root["showOrderItems"], dflt.showOrderItems),
     trustBadges,
+    notices,
     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.
@@ -9289,6 +9604,13 @@ export {
   copyTranslationsKey,
   checkoutCopy,
   surchargeWordFor,
+  NOTICE_SECTIONS,
+  NOTICES_PER_SECTION,
+  NOTICE_LABEL_MAX_LENGTH,
+  NOTICE_ICONS,
+  NOTICE_ICON_FALLBACK,
+  NOTICE_ICON_PATHS,
+  isNoticeIcon,
   fontStack,
   radiusValue,
   fontWeightValue,
@@ -9304,6 +9626,11 @@ export {
   isDarkSurface,
   DEFAULT_BADGES,
   DEFAULT_BADGES_DARK,
+  DEFAULT_NOTICES,
+  defaultNotices,
+  cloneNotice,
+  isDefaultBadgeSet,
+  resolveNoticesAndBadges,
   MIN_SECTION_ORDER,
   MAX_SECTION_ORDER,
   MAX_SECTION_LABEL_LENGTH,
@@ -9330,6 +9657,12 @@ export {
   sanitizeCustomCss,
   decodeBadges,
   encodeBadges,
+  decodeNotices,
+  parseNoticesLoose,
+  encodeNotices,
+  noticeText,
+  noticesIn,
+  shownNotices,
   CUSTOM_FIELDS_MAX,
   CUSTOM_FIELD_KEY_PATTERN,
   ALL_CUSTOM_FIELD_TYPES,
@@ -9392,4 +9725,4 @@ export {
   decodeNativePanes,
   encodeNativePanes
 };
-//# sourceMappingURL=chunk-Y6TADN6R.js.map
+//# sourceMappingURL=chunk-CP5M5WR6.js.map