@delopay/sdk 0.115.0 → 0.117.0

package/dist/{chunk-VH5NCMH6.js → chunk-RN4LGMQM.js}

@@ -532,9 +532,9 @@ var Connectors = class {
   /**
    * Update a connector account.
    *
-   * `connector_webhook_details` **merges** into the stored block key by key
-   * (be#992): an absent key keeps its stored secret, an explicit value is
-   * written, and an explicit empty string clears that secret. Send only the
+   * `connector_webhook_details` **merges** into the stored block key by key:
+   * an absent key keeps its stored secret, an explicit value is written, and
+   * an explicit empty string clears that secret. Send only the
    * keys the operator typed — padding the other environment's keys with `''`
    * clears a live signing secret and inbound webhooks stop verifying.
    *
@@ -4164,11 +4164,12 @@ var Settlement = class {
   /**
    * Record payout progress on a statement (`unpaid` / `partial` / `paid`).
    *
-   * Subject to the caller's `settlement_payout` operation limit, which can
-   * only be a per-operation ceiling: an over-limit call fails with `DE_01`
-   * and nothing is recorded. There is no approval route out of it — four-eyes
-   * needs an executor that can run the operation once somebody says yes, and
-   * only refunds have one, so a settlement rule can only block.
+   * Subject to the caller's `settlement_payout` operation limit — a
+   * per-operation ceiling, a windowed total, a windowed count, or any
+   * combination: an over-limit call fails with `DE_01` and nothing is
+   * recorded. There is no approval route out of it — four-eyes needs an
+   * executor that can run the operation once somebody says yes, and only
+   * refunds have one, so a settlement rule can only block.
    *
    * `POST /settlement/statements/{statementId}/payout`
    */
@@ -5034,6 +5035,121 @@ function feeProgram() {
 }
 
 // src/branding.ts
+function surchargeShowsLabel(labelMode, style, position) {
+  if (labelMode !== "labelled") return false;
+  return !(style === "ribbon" && (position === "cornerStart" || position === "cornerEnd"));
+}
+function surchargeFigurePlan(branding, isDiscount, percentAvailable) {
+  const mode = isDiscount ? branding.discountFigure : branding.surchargeFigure;
+  const label = surchargeShowsLabel(
+    branding.surchargeLabel,
+    branding.surchargeStyle,
+    branding.surchargePosition
+  );
+  if (!percentAvailable) return { first: "amount", second: null, label };
+  const ordered = {
+    amount: ["amount", null],
+    percent: ["percent", null],
+    amountThenPercent: ["amount", "percent"],
+    percentThenAmount: ["percent", "amount"]
+  };
+  const [first, second] = ordered[mode];
+  const cornerRibbon = branding.surchargeStyle === "ribbon" && (branding.surchargePosition === "cornerStart" || branding.surchargePosition === "cornerEnd");
+  return { first, second: cornerRibbon ? null : second, label };
+}
+function readableInkOn(color) {
+  const onBlack = contrastRatio(color, "#000000");
+  const onWhite = contrastRatio(color, "#ffffff");
+  if (onBlack === null || onWhite === null) return "#ffffff";
+  return onBlack >= onWhite ? "#000000" : "#ffffff";
+}
+var SURCHARGE_FONT_SIZE = {
+  sm: "0.6875rem",
+  md: "0.8125rem",
+  lg: "0.9375rem"
+};
+var SURCHARGE_PAD = {
+  sm: "1px 6px",
+  md: "2px 8px",
+  lg: "3px 10px"
+};
+var SURCHARGE_RADIUS = {
+  pill: "999px",
+  rounded: "6px",
+  square: "0px"
+};
+var SURCHARGE_BORDER_WIDTH = {
+  none: "0px",
+  thin: "1px",
+  medium: "2px",
+  thick: "3px"
+};
+var SURCHARGE_FONT_WEIGHT = {
+  regular: "400",
+  medium: "600",
+  bold: "700"
+};
+var SURCHARGE_POSITIONS = [
+  "trailing",
+  "inline",
+  "below",
+  "above",
+  "cornerStart",
+  "cornerEnd"
+];
+var SURCHARGE_STYLES = [
+  "plain",
+  "underline",
+  "outline",
+  "badge",
+  "solid",
+  "ribbon"
+];
+var SURCHARGE_BORDER_WIDTHS = [
+  "none",
+  "thin",
+  "medium",
+  "thick"
+];
+var SURCHARGE_BORDER_STYLES = [
+  "solid",
+  "dashed",
+  "dotted"
+];
+var SURCHARGE_SIZES = ["sm", "md", "lg"];
+function surchargeStyleDrawsAShape(style) {
+  return style === "badge" || style === "outline" || style === "solid";
+}
+var SURCHARGE_SHAPES = ["pill", "rounded", "square"];
+var SURCHARGE_WEIGHTS = ["regular", "medium", "bold"];
+var SURCHARGE_SIGNS = ["always", "minusOnly", "none"];
+var SURCHARGE_LABEL_MODES = ["amount", "labelled"];
+var SURCHARGE_FIGURE_MODES = [
+  "amount",
+  "percent",
+  "amountThenPercent",
+  "percentThenAmount"
+];
+var CHECKOUT_LOCALES = ["en", "de"];
+var LOCALIZABLE_COPY_FIELDS = [
+  "headerText",
+  "payButtonLabel",
+  "cardTermsMessage",
+  "footerText"
+];
+function copyTranslationsKey(field) {
+  return `${field}Translations`;
+}
+function checkoutCopy(branding, field, locale) {
+  const translated = translationFor(branding[copyTranslationsKey(field)], locale);
+  return translated ?? branding[field];
+}
+function surchargeWordFor(branding, isDiscount, locale) {
+  return translationFor(
+    isDiscount ? branding.discountWordTranslations : branding.surchargeWordTranslations,
+    locale
+  );
+}
 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",
@@ -5224,6 +5340,44 @@ var DEFAULT_BRANDING_BASE = {
   verticalGap: "comfortable",
   inputSize: "md",
   buttonSize: "md",
+  // Disclosure on by default: with provider-scoped pricing the tile is where
+  // the buyer chooses between prices, and a price they cannot see is one they
+  // find out about on the statement.
+  showSurcharge: true,
+  surchargePosition: "trailing",
+  surchargeStyle: "badge",
+  surchargeSize: "sm",
+  surchargeShape: "pill",
+  surchargeBorderWidth: "thin",
+  surchargeBorderStyle: "solid",
+  surchargeWeight: "medium",
+  surchargeSign: "always",
+  surchargeUppercase: false,
+  // Named, not bare. A tile that reads "-EUR 2.50" beside a brand name is a
+  // number with no subject — buyers read it as the price, not as a change to
+  // it. "Discount -EUR 2.50" needs no interpreting, and the word is what makes
+  // the default configuration legible without the merchant touching anything.
+  surchargeLabel: "labelled",
+  // The two directions default differently on purpose, which is the whole
+  // reason they are two settings. A fee is something a buyer acts on in money,
+  // so it leads with money and says nothing else. A saving is something worth
+  // advertising, and the share is the persuasive half of it — "-5.1% (EUR
+  // 2.50)" sells what "-EUR 2.50" merely states, and the amount is still right
+  // there beside it.
+  surchargeFigure: "amount",
+  discountFigure: "percentThenAmount",
+  // Empty: the checkout's own localized words are the default, in every
+  // language it ships. A merchant fills these in only to say it differently.
+  surchargeWordTranslations: {},
+  discountWordTranslations: {},
+  // amber-700 / emerald-700, not the 600s: the `plain` style renders the
+  // disclosure as coloured TEXT, so it is bound by `WCAG_AA_TEXT` (4.5) rather
+  // than by the 3:1 a coloured shape would be, and the 600s come to 3.19 and
+  // 3.77 against the default white surface. These are 5.02 and 5.48, pinned by
+  // tests. Far enough apart to read as opposite news at a glance rather than as
+  // two shades of "extra".
+  surchargeColor: "#b45309",
+  discountColor: "#047857",
   layout: "split",
   summaryPosition: "left",
   showOrderSummary: true,
@@ -5232,10 +5386,17 @@ var DEFAULT_BRANDING_BASE = {
   totalLabel: "Total",
   showCurrencyCode: false,
   showOrderItems: true,
+  // Each flat field keeps its meaning: what the merchant wrote, used in every
+  // locale that carries no override. Empty maps therefore change nothing for a
+  // profile saved before translations existed.
   headerText: "",
+  headerTextTranslations: {},
   payButtonLabel: "",
+  payButtonLabelTranslations: {},
   cardTermsMessage: "",
+  cardTermsMessageTranslations: {},
   footerText: "",
+  footerTextTranslations: {},
   supportEmail: "",
   paymentLayout: "tabs",
   labelStyle: "above",
@@ -5261,6 +5422,11 @@ var DEFAULT_BRANDING_DARK = {
   buttonBackground: "#1E4FEB",
   buttonText: "#ffffff",
   surfaceStyle: "flat",
+  // amber-400 / emerald-400: the 700s above are far too dark to read on
+  // slate-900, and this pair is the same news in the same order at the light
+  // 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 })),
   customFields: []
 };
@@ -5271,7 +5437,16 @@ function cloneBranding(b) {
   return {
     ...b,
     trustBadges: b.trustBadges.map((badge) => ({ ...badge })),
-    customFields: b.customFields.map(cloneCustomField)
+    customFields: b.customFields.map(cloneCustomField),
+    // 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.
+    surchargeWordTranslations: { ...b.surchargeWordTranslations },
+    discountWordTranslations: { ...b.discountWordTranslations },
+    headerTextTranslations: { ...b.headerTextTranslations },
+    payButtonLabelTranslations: { ...b.payButtonLabelTranslations },
+    cardTermsMessageTranslations: { ...b.cardTermsMessageTranslations },
+    footerTextTranslations: { ...b.footerTextTranslations }
   };
 }
 function cloneCustomField(f) {
@@ -5422,13 +5597,25 @@ function defaultCustomFieldVisibility() {
   return { mode: "always", match: "all", conditions: [] };
 }
 function parseTranslations(raw) {
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {};
+  let value = raw;
+  if (typeof value === "string") {
+    try {
+      value = JSON.parse(value);
+    } catch {
+      return {};
+    }
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
   const out = {};
-  for (const [k, v] of Object.entries(raw)) {
-    if (typeof v === "string" && v.length > 0) out[k] = v;
+  for (const [k, v] of Object.entries(value)) {
+    if (typeof v === "string" && v.trim().length > 0) out[k] = v;
   }
   return out;
 }
+function encodeTranslations(map) {
+  const entries = Object.entries(map).filter(([, v]) => v.trim().length > 0);
+  return entries.length > 0 ? JSON.stringify(Object.fromEntries(entries)) : void 0;
+}
 function normalizeCondition(raw, index) {
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
   const c = raw;
@@ -5780,6 +5967,74 @@ function decodeBranding(source) {
       ["sm", "md", "lg"],
       DEFAULT_BRANDING.buttonSize
     ),
+    showSurcharge: parseBool(extras["showSurcharge"], DEFAULT_BRANDING.showSurcharge),
+    surchargePosition: pickEnum(
+      extras["surchargePosition"],
+      SURCHARGE_POSITIONS,
+      DEFAULT_BRANDING.surchargePosition
+    ),
+    surchargeStyle: pickEnum(
+      extras["surchargeStyle"],
+      SURCHARGE_STYLES,
+      DEFAULT_BRANDING.surchargeStyle
+    ),
+    surchargeSize: pickEnum(
+      extras["surchargeSize"],
+      SURCHARGE_SIZES,
+      DEFAULT_BRANDING.surchargeSize
+    ),
+    surchargeShape: pickEnum(
+      extras["surchargeShape"],
+      SURCHARGE_SHAPES,
+      DEFAULT_BRANDING.surchargeShape
+    ),
+    surchargeBorderWidth: pickEnum(
+      extras["surchargeBorderWidth"],
+      SURCHARGE_BORDER_WIDTHS,
+      DEFAULT_BRANDING.surchargeBorderWidth
+    ),
+    surchargeBorderStyle: pickEnum(
+      extras["surchargeBorderStyle"],
+      SURCHARGE_BORDER_STYLES,
+      DEFAULT_BRANDING.surchargeBorderStyle
+    ),
+    surchargeWeight: pickEnum(
+      extras["surchargeWeight"],
+      SURCHARGE_WEIGHTS,
+      DEFAULT_BRANDING.surchargeWeight
+    ),
+    surchargeSign: pickEnum(
+      extras["surchargeSign"],
+      SURCHARGE_SIGNS,
+      DEFAULT_BRANDING.surchargeSign
+    ),
+    surchargeUppercase: parseBool(
+      extras["surchargeUppercase"],
+      DEFAULT_BRANDING.surchargeUppercase
+    ),
+    surchargeLabel: pickEnum(
+      extras["surchargeLabel"],
+      SURCHARGE_LABEL_MODES,
+      DEFAULT_BRANDING.surchargeLabel
+    ),
+    surchargeFigure: pickEnum(
+      extras["surchargeFigure"],
+      SURCHARGE_FIGURE_MODES,
+      DEFAULT_BRANDING.surchargeFigure
+    ),
+    discountFigure: pickEnum(
+      extras["discountFigure"],
+      SURCHARGE_FIGURE_MODES,
+      DEFAULT_BRANDING.discountFigure
+    ),
+    surchargeWordTranslations: parseTranslations(extras["surchargeWordTranslations"]),
+    discountWordTranslations: parseTranslations(extras["discountWordTranslations"]),
+    headerTextTranslations: parseTranslations(extras["headerTextTranslations"]),
+    payButtonLabelTranslations: parseTranslations(extras["payButtonLabelTranslations"]),
+    cardTermsMessageTranslations: parseTranslations(extras["cardTermsMessageTranslations"]),
+    footerTextTranslations: parseTranslations(extras["footerTextTranslations"]),
+    surchargeColor: s(extras["surchargeColor"]) || DEFAULT_BRANDING.surchargeColor,
+    discountColor: s(extras["discountColor"]) || DEFAULT_BRANDING.discountColor,
     layout: pickEnum(extras["layout"], ["compact", "split"], DEFAULT_BRANDING.layout),
     summaryPosition: pickEnum(
       extras["summaryPosition"],
@@ -5833,6 +6088,21 @@ function encodeBranding(branding, base) {
     verticalGap: branding.verticalGap,
     inputSize: branding.inputSize,
     buttonSize: branding.buttonSize,
+    showSurcharge: String(branding.showSurcharge),
+    surchargePosition: branding.surchargePosition,
+    surchargeStyle: branding.surchargeStyle,
+    surchargeSize: branding.surchargeSize,
+    surchargeShape: branding.surchargeShape,
+    surchargeBorderWidth: branding.surchargeBorderWidth,
+    surchargeBorderStyle: branding.surchargeBorderStyle,
+    surchargeWeight: branding.surchargeWeight,
+    surchargeSign: branding.surchargeSign,
+    surchargeUppercase: String(branding.surchargeUppercase),
+    surchargeLabel: branding.surchargeLabel,
+    surchargeFigure: branding.surchargeFigure,
+    discountFigure: branding.discountFigure,
+    surchargeColor: branding.surchargeColor,
+    discountColor: branding.discountColor,
     layout: branding.layout,
     summaryPosition: branding.summaryPosition,
     showOrderSummary: String(branding.showOrderSummary),
@@ -5850,6 +6120,17 @@ function encodeBranding(branding, base) {
   if (branding.customFields.length > 0) {
     extras["customFields"] = encodeCustomFields(branding.customFields);
   }
+  for (const key of [
+    "surchargeWordTranslations",
+    "discountWordTranslations",
+    "headerTextTranslations",
+    "payButtonLabelTranslations",
+    "cardTermsMessageTranslations",
+    "footerTextTranslations"
+  ]) {
+    const encoded = encodeTranslations(branding[key]);
+    if (encoded) extras[key] = encoded;
+  }
   const tagline = trim(branding.tagline);
   if (tagline) extras["tagline"] = tagline;
   const footer = trim(branding.footerText);
@@ -5958,6 +6239,71 @@ function parseImportedBranding(raw) {
     ),
     inputSize: pickEnum(root["inputSize"], ["sm", "md", "lg"], dflt.inputSize),
     buttonSize: pickEnum(root["buttonSize"], ["sm", "md", "lg"], dflt.buttonSize),
+    showSurcharge: parseBool(root["showSurcharge"], dflt.showSurcharge),
+    surchargePosition: pickEnum(
+      root["surchargePosition"],
+      SURCHARGE_POSITIONS,
+      dflt.surchargePosition
+    ),
+    surchargeStyle: pickEnum(
+      root["surchargeStyle"],
+      SURCHARGE_STYLES,
+      dflt.surchargeStyle
+    ),
+    surchargeSize: pickEnum(
+      root["surchargeSize"],
+      SURCHARGE_SIZES,
+      dflt.surchargeSize
+    ),
+    surchargeShape: pickEnum(
+      root["surchargeShape"],
+      SURCHARGE_SHAPES,
+      dflt.surchargeShape
+    ),
+    surchargeBorderWidth: pickEnum(
+      root["surchargeBorderWidth"],
+      SURCHARGE_BORDER_WIDTHS,
+      dflt.surchargeBorderWidth
+    ),
+    surchargeBorderStyle: pickEnum(
+      root["surchargeBorderStyle"],
+      SURCHARGE_BORDER_STYLES,
+      dflt.surchargeBorderStyle
+    ),
+    surchargeWeight: pickEnum(
+      root["surchargeWeight"],
+      SURCHARGE_WEIGHTS,
+      dflt.surchargeWeight
+    ),
+    surchargeSign: pickEnum(
+      root["surchargeSign"],
+      SURCHARGE_SIGNS,
+      dflt.surchargeSign
+    ),
+    surchargeUppercase: parseBool(root["surchargeUppercase"], dflt.surchargeUppercase),
+    surchargeLabel: pickEnum(
+      root["surchargeLabel"],
+      SURCHARGE_LABEL_MODES,
+      dflt.surchargeLabel
+    ),
+    surchargeFigure: pickEnum(
+      root["surchargeFigure"],
+      SURCHARGE_FIGURE_MODES,
+      dflt.surchargeFigure
+    ),
+    discountFigure: pickEnum(
+      root["discountFigure"],
+      SURCHARGE_FIGURE_MODES,
+      dflt.discountFigure
+    ),
+    surchargeWordTranslations: parseTranslations(root["surchargeWordTranslations"]),
+    discountWordTranslations: parseTranslations(root["discountWordTranslations"]),
+    headerTextTranslations: parseTranslations(root["headerTextTranslations"]),
+    payButtonLabelTranslations: parseTranslations(root["payButtonLabelTranslations"]),
+    cardTermsMessageTranslations: parseTranslations(root["cardTermsMessageTranslations"]),
+    footerTextTranslations: parseTranslations(root["footerTextTranslations"]),
+    surchargeColor: sHex(root["surchargeColor"], dflt.surchargeColor),
+    discountColor: sHex(root["discountColor"], dflt.discountColor),
     layout: pickEnum(root["layout"], ["compact", "split"], dflt.layout),
     summaryPosition: pickEnum(
       root["summaryPosition"],
@@ -6024,6 +6370,19 @@ function applyBrandingVariables(el, b) {
   set("--dp-gap-vertical", VERTICAL_GAP[b.verticalGap]);
   set("--dp-input-pad", INPUT_PAD[b.inputSize]);
   set("--dp-button-pad", BUTTON_PAD[b.buttonSize]);
+  set("--dp-surcharge", b.surchargeColor);
+  set("--dp-discount", b.discountColor);
+  set("--dp-surcharge-ink", readableInkOn(b.surchargeColor));
+  set("--dp-discount-ink", readableInkOn(b.discountColor));
+  set("--dp-surcharge-size", SURCHARGE_FONT_SIZE[b.surchargeSize]);
+  set("--dp-surcharge-pad", SURCHARGE_PAD[b.surchargeSize]);
+  set("--dp-surcharge-radius", SURCHARGE_RADIUS[b.surchargeShape]);
+  set("--dp-surcharge-weight", SURCHARGE_FONT_WEIGHT[b.surchargeWeight]);
+  set(
+    "--dp-surcharge-border-width",
+    SURCHARGE_BORDER_WIDTH[b.surchargeStyle === "outline" && b.surchargeBorderWidth === "none" ? "thin" : b.surchargeBorderWidth]
+  );
+  set("--dp-surcharge-border-style", b.surchargeBorderStyle);
   set("--dp-shadow", shadowFor(b.surfaceStyle));
   set(
     "--dp-surface-border",
@@ -6414,9 +6773,9 @@ var STRIPE_FALLBACK_PANE_METHODS = [
     requiresBillingCountry: true,
     defaultLabel: "Klarna",
     // NOT the router's current "Pay later or in 3 instalments". This table is
-    // what a router predating the capability endpoint (delopay-backend#964)
-    // renders, and that copy only gained the "3" in delopay-backend#1051 —
-    // the same release that added the endpoint. Restating the new string here
+    // what a router predating the capability endpoint renders, and that copy
+    // only gained the "3" in the same release that added the endpoint.
+    // Restating the new string here
     // would put copy no reachable router emits in front of a merchant, and
     // would change what the deprecated `nativePaneMethodInfo` has returned
     // since 0.106.0.
@@ -6766,6 +7125,25 @@ export {
   programToTree,
   FeeProgramBuilder,
   feeProgram,
+  surchargeShowsLabel,
+  surchargeFigurePlan,
+  readableInkOn,
+  SURCHARGE_POSITIONS,
+  SURCHARGE_STYLES,
+  SURCHARGE_BORDER_WIDTHS,
+  SURCHARGE_BORDER_STYLES,
+  SURCHARGE_SIZES,
+  surchargeStyleDrawsAShape,
+  SURCHARGE_SHAPES,
+  SURCHARGE_WEIGHTS,
+  SURCHARGE_SIGNS,
+  SURCHARGE_LABEL_MODES,
+  SURCHARGE_FIGURE_MODES,
+  CHECKOUT_LOCALES,
+  LOCALIZABLE_COPY_FIELDS,
+  copyTranslationsKey,
+  checkoutCopy,
+  surchargeWordFor,
   fontStack,
   radiusValue,
   fontWeightValue,
@@ -6852,4 +7230,4 @@ export {
   decodeNativePanes,
   encodeNativePanes
 };
-//# sourceMappingURL=chunk-VH5NCMH6.js.map
+//# sourceMappingURL=chunk-RN4LGMQM.js.map