@delopay/sdk 0.134.0 → 0.137.0

package/dist/index.cjs

@@ -20,6 +20,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AIRWALLEX_AUTOFILL_TREATMENTS: () => AIRWALLEX_AUTOFILL_TREATMENTS,
+  AIRWALLEX_CARD_LAYOUTS: () => AIRWALLEX_CARD_LAYOUTS,
+  AIRWALLEX_CARD_PRESETS: () => AIRWALLEX_CARD_PRESETS,
+  AIRWALLEX_CARD_PRESET_FALLBACK: () => AIRWALLEX_CARD_PRESET_FALLBACK,
+  AIRWALLEX_FIELD_CHROMES: () => AIRWALLEX_FIELD_CHROMES,
+  AIRWALLEX_FIELD_FONT_SIZES: () => AIRWALLEX_FIELD_FONT_SIZES,
+  AIRWALLEX_FIELD_WEIGHTS: () => AIRWALLEX_FIELD_WEIGHTS,
+  AIRWALLEX_FOCUS_RINGS: () => AIRWALLEX_FOCUS_RINGS,
+  AIRWALLEX_LABEL_STYLES: () => AIRWALLEX_LABEL_STYLES,
+  AIRWALLEX_NETWORK_MARKS: () => AIRWALLEX_NETWORK_MARKS,
   ALL_CUSTOM_FIELD_CONDITION_SOURCES: () => ALL_CUSTOM_FIELD_CONDITION_SOURCES,
   ALL_CUSTOM_FIELD_OPERATORS: () => ALL_CUSTOM_FIELD_OPERATORS,
   ALL_CUSTOM_FIELD_TYPES: () => ALL_CUSTOM_FIELD_TYPES,
@@ -90,9 +100,15 @@ __export(index_exports, {
   WCAG_AA_TEXT: () => WCAG_AA_TEXT,
   WCAG_AA_UI: () => WCAG_AA_UI,
   Webhooks: () => Webhooks,
+  airwallexCardLayout: () => airwallexCardLayout,
+  airwallexCardLayoutIsCoherent: () => airwallexCardLayoutIsCoherent,
+  airwallexCellWeight: () => airwallexCellWeight,
+  airwallexFieldFontPx: () => airwallexFieldFontPx,
+  airwallexFieldWeightValue: () => airwallexFieldWeightValue,
   allOf: () => allOf,
   anyOf: () => anyOf,
   applyBrandingVariables: () => applyBrandingVariables,
+  asAirwallexCardPreset: () => asAirwallexCardPreset,
   buildBrandingExport: () => buildBrandingExport,
   buttonPadValue: () => buttonPadValue,
   canonicalSectionId: () => canonicalSectionId,
@@ -156,6 +172,8 @@ __export(index_exports, {
   programToTree: () => programToTree,
   radiusValue: () => radiusValue,
   readableInkOn: () => readableInkOn,
+  resolveAirwallexCardPreset: () => resolveAirwallexCardPreset,
+  resolveAirwallexLabelStyle: () => resolveAirwallexLabelStyle,
   ruleMatchToTree: () => ruleMatchToTree,
   sanitizeCustomCss: () => sanitizeCustomCss,
   sectionLabel: () => sectionLabel,
@@ -1045,10 +1063,68 @@ var Customers = class {
       query: toQuery(params)
     });
   }
+  /**
+   * Retrieve one customer, scoped to the authenticated dashboard user's shop
+   * (business profile). The shop-scoped counterpart of {@link retrieve}, and
+   * what makes a shop's own customer list clickable: the list is
+   * `ProfileCustomerRead` while {@link retrieve} is merchant-level, so a shop
+   * member could see a customer they could not open.
+   *
+   * A customer belonging to a sibling shop answers `CustomerNotFound` — the
+   * same answer as a customer that does not exist, deliberately, so one shop
+   * cannot enumerate another's customer ids.
+   *
+   * `GET /customers/profile/{customerId}`
+   *
+   * @param customerId - The unique customer ID.
+   * @returns The customer, with `profile_ids` narrowed to the caller's own shop.
+   */
+  async retrieveByProfile(customerId) {
+    return this.request("GET", `/customers/profile/${encodeURIComponent(customerId)}`);
+  }
+  /**
+   * Create a customer from a shop, recording that it belongs to that shop so
+   * the shop can see the customer it just created. The shop is taken from the
+   * credential; a caller-chosen `customer_id` is rejected.
+   *
+   * `POST /customers/profile`
+   *
+   * @param params - The customer to create.
+   * @returns The created customer.
+   */
+  async createByProfile(params) {
+    return this.request("POST", "/customers/profile", { body: params });
+  }
+  /**
+   * Update a customer from a shop, if the customer belongs to that shop.
+   * A sibling shop's customer answers `CustomerNotFound`, as with
+   * {@link retrieveByProfile}.
+   *
+   * `POST /customers/profile/{customerId}`
+   *
+   * @param customerId - The customer ID to update.
+   * @param params - Fields to update.
+   * @returns The updated customer.
+   */
+  async updateByProfile(customerId, params) {
+    return this.request("POST", `/customers/profile/${encodeURIComponent(customerId)}`, {
+      body: params
+    });
+  }
   /** List mandates for a customer. `GET /customers/{customerId}/mandates` */
   async listMandates(customerId) {
     return this.request("GET", `/customers/${encodeURIComponent(customerId)}/mandates`);
   }
+  /**
+   * List one customer's mandates, scoped to the caller's shop. Same membership
+   * rule as {@link retrieveByProfile}: a sibling shop's customer answers
+   * `CustomerNotFound` before any mandate is read.
+   *
+   * `GET /customers/profile/{customerId}/mandates`
+   */
+  async listMandatesByProfile(customerId) {
+    return this.request("GET", `/customers/profile/${encodeURIComponent(customerId)}/mandates`);
+  }
 };
 
 // src/resources/disputes.ts
@@ -1780,6 +1856,43 @@ var Payments = class {
       options
     );
   }
+  /**
+   * What the payment's rail says about settling each attempt: whether the
+   * money is still `pending` in the rail's hands, `available` in its balance
+   * (**not** paid out), `paid_out` to a bank — with the payout's date and
+   * reference — or came back as `payout_failed`; and, for the rest, which
+   * kind of not-knowing applies (`unavailable`, `unknown`, `not_recorded`).
+   * See {@link ConnectorSettlementStatus} for the seven values. The same
+   * status for the active attempt rides on every list row and retrieve as
+   * `connector_settlement_status`, and the list filters on it.
+   *
+   * Not the hosted-shop settlement API under `settlement.*`, which is host →
+   * shop owner and manual; this is acquirer → merchant bank, per payment.
+   *
+   * `GET /payments/{paymentId}/settlement`
+   *
+   * @param paymentId - The payment intent ID.
+   * @param options - Optional per-call extras: extra `headers`, a `timeout`
+   *   override, and an `AbortSignal`.
+   * @returns The attempts this caller may see, oldest first, each with its
+   *   settlement status.
+   * @throws If the payment does not exist (404), or the caller is a
+   *   profile-scoped (shop) role, who is refused rather than shown a redacted
+   *   body (403).
+   *
+   * @example
+   * ```typescript
+   * const { attempts } = await delopay.payments.settlement('pay_abc123');
+   * for (const attempt of attempts) {
+   *   if (attempt.status === 'paid_out') {
+   *     console.log(attempt.paid_out_at, attempt.payout_reference);
+   *   }
+   * }
+   * ```
+   */
+  async settlement(paymentId, options) {
+    return this.request("GET", `/payments/${encodeURIComponent(paymentId)}/settlement`, options);
+  }
   /**
    * Update an existing payment intent before it is confirmed.
    *
@@ -1951,7 +2064,10 @@ var Payments = class {
   /**
    * List payments by filter, scoped to the caller's profile (the shop-user
    * twin of `listByFilter`). The backend narrows to the profile from the
-   * auth context, so `profile_id` / `project_id` must not be sent.
+   * auth context, so `profile_id` / `project_id` must not be sent — and
+   * neither may `connector_settlement_status`, which this route refuses
+   * (403): a shop-scoped viewer is not shown the settlement state, and the
+   * type leaves the key out so it cannot be probed through `total_count`.
    *
    * Not to be confused with {@link Payments.listByProfile}, which is the GET
    * cursor variant and rejects this body.
@@ -5389,6 +5505,120 @@ function feeProgram() {
   return new FeeProgramBuilder();
 }
 
+// src/airwallexCard.ts
+var AIRWALLEX_CARD_PRESETS = [
+  "single_row",
+  "split_fields",
+  "split_fields_labelled",
+  "stacked",
+  "number_expiry_row",
+  "compact"
+];
+var SPLIT = ["cardNumber", "expiry", "cvc"];
+var AIRWALLEX_CARD_LAYOUTS = {
+  // Airwallex's combined element. One iframe, one row, and the only preset
+  // whose insides are not ours to lay out — which is why it carries no
+  // captions: there is nothing to caption but the row as a whole.
+  single_row: {
+    elements: ["card"],
+    rows: [["card"]],
+    labels: false,
+    density: "default"
+  },
+  // The trio with placeholders carrying the meaning. Shorter than the
+  // labelled variant and fine on a wide surface.
+  split_fields: {
+    elements: SPLIT,
+    rows: [["cardNumber"], ["expiry", "cvc"]],
+    labels: false,
+    density: "default"
+  },
+  // The default. The same geometry, captioned — which is what makes it
+  // survive a narrow embed, where a bare field row stops being self-evident.
+  split_fields_labelled: {
+    elements: SPLIT,
+    rows: [["cardNumber"], ["expiry", "cvc"]],
+    labels: true,
+    density: "default"
+  },
+  // Every field full width. Expiry and CVC side by side start to crowd below
+  // roughly 320px, and this is the layout that does not.
+  stacked: {
+    elements: SPLIT,
+    rows: [["cardNumber"], ["expiry"], ["cvc"]],
+    labels: true,
+    density: "default"
+  },
+  // Two rows instead of two-plus-one: shorter than the split forms without
+  // the ambiguity of a single combined field.
+  //
+  // 3:2, not an even split. A card number is nineteen characters and an expiry
+  // is five, so halving the row clipped the number's own placeholder at 460px
+  // — seen in the preview before this was weighted. The proposal drew it even;
+  // the merchant-facing decision was taken on the two drawn side by side and
+  // the weighted one was chosen, so do not "restore" the even split to match
+  // the original mock.
+  number_expiry_row: {
+    elements: SPLIT,
+    rows: [["cardNumber", "expiry"], ["cvc"]],
+    weights: { cardNumber: 3, expiry: 2 },
+    labels: true,
+    density: "default"
+  },
+  // Split geometry at reduced density and type size, for a checkout embedded
+  // in a page that already has its own chrome.
+  compact: {
+    elements: SPLIT,
+    rows: [["cardNumber"], ["expiry", "cvc"]],
+    labels: false,
+    density: "compact"
+  }
+};
+var AIRWALLEX_CARD_PRESET_FALLBACK = "split_fields_labelled";
+function resolveAirwallexCardPreset(fromBranding, fromConnector) {
+  return asPreset(fromBranding) ?? asPreset(fromConnector) ?? AIRWALLEX_CARD_PRESET_FALLBACK;
+}
+function asAirwallexCardPreset(value) {
+  return asPreset(value);
+}
+function asPreset(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim().toLowerCase();
+  return AIRWALLEX_CARD_PRESETS.includes(trimmed) ? trimmed : null;
+}
+function airwallexCardLayout(preset) {
+  return AIRWALLEX_CARD_LAYOUTS[preset];
+}
+function airwallexCellWeight(layout, field) {
+  const weight = layout.weights?.[field];
+  return typeof weight === "number" && Number.isFinite(weight) && weight > 0 ? weight : 1;
+}
+function airwallexCardLayoutIsCoherent(layout) {
+  const drawn = layout.rows.flat();
+  if (drawn.length !== layout.elements.length) return false;
+  return layout.elements.every((field) => drawn.filter((f) => f === field).length === 1);
+}
+var AIRWALLEX_LABEL_STYLES = ["above", "inline", "floating", "none"];
+function resolveAirwallexLabelStyle(override, layout) {
+  if (typeof override === "string" && AIRWALLEX_LABEL_STYLES.includes(override)) {
+    return override;
+  }
+  return layout.labels ? "above" : "none";
+}
+var AIRWALLEX_FIELD_CHROMES = ["outlined", "filled", "underline"];
+var AIRWALLEX_FOCUS_RINGS = ["none", "subtle", "strong"];
+var AIRWALLEX_AUTOFILL_TREATMENTS = ["system", "brand", "neutral"];
+var AIRWALLEX_FIELD_FONT_SIZES = ["sm", "md", "lg"];
+var AIRWALLEX_FIELD_WEIGHTS = ["regular", "medium", "semibold"];
+function airwallexFieldFontPx(size, density) {
+  const base = size === "sm" ? 14 : size === "lg" ? 18 : 16;
+  return density === "compact" ? Math.max(13, base - 1) : base;
+}
+function airwallexFieldWeightValue(weight) {
+  return weight === "regular" ? 400 : weight === "semibold" ? 600 : 500;
+}
+var AIRWALLEX_NETWORK_MARKS = ["visa", "mastercard", "amex", "discover"];
+
 // src/branding.ts
 function surchargeShowsLabel(labelMode, style, position) {
   if (labelMode !== "labelled") return false;
@@ -5924,6 +6154,25 @@ var DEFAULT_BRANDING_BASE = {
   paymentLayout: "tabs",
   labelStyle: "above",
   showPoweredBy: true,
+  // Every one of these defaults to what the Airwallex pane already did before
+  // the section existed, so a merchant who never opens it sees no change:
+  // empty preset (defer to the connector account), an outlined box, 16px /
+  // 500 type, no focus ring, the browser's own autofill highlight, no valid
+  // tint, no marks. The single deliberate change of behaviour is not here —
+  // it is the fallback at the END of `resolveAirwallexCardPreset`, which
+  // moves a shop that configured NOTHING from the combined row to the
+  // labelled split form.
+  airwallexCardPreset: "",
+  // Off. With this on, no buyer can pay by card on the shop.
+  airwallexHideCard: false,
+  airwallexFieldChrome: "outlined",
+  airwallexLabelStyle: "",
+  airwallexFieldFontSize: "md",
+  airwallexFieldWeight: "medium",
+  airwallexFocusRing: "none",
+  airwallexAutofill: "system",
+  airwallexValidTint: false,
+  airwallexNetworkMarks: false,
   customCss: ""
 };
 var DEFAULT_BRANDING = {
@@ -6033,6 +6282,10 @@ function pickEnum(value, allowed, fallback) {
   if (typeof value !== "string") return fallback;
   return allowed.includes(value) ? value : fallback;
 }
+function pickEnumOrEmpty(value, allowed) {
+  if (typeof value !== "string") return "";
+  return allowed.includes(value) ? value : "";
+}
 function parseBool(value, fallback) {
   if (typeof value === "boolean") return value;
   if (value === "true") return true;
@@ -6603,6 +6856,53 @@ function decodeBranding(source) {
     ),
     labelStyle,
     showPoweredBy: source.branding_visibility !== false,
+    // The two that can be empty use `pickEnumOrEmpty`, not `pickEnum`: a
+    // value this build does not know has to decode to "unset" and defer, the
+    // same as a key that was never written. Sending it to a concrete default
+    // instead would make an older checkout override the connector account of
+    // a merchant who picked a preset a newer dashboard offers.
+    airwallexCardPreset: pickEnumOrEmpty(
+      extras["airwallexCardPreset"],
+      AIRWALLEX_CARD_PRESETS
+    ),
+    airwallexHideCard: parseBool(extras["airwallexHideCard"], DEFAULT_BRANDING.airwallexHideCard),
+    airwallexFieldChrome: pickEnum(
+      extras["airwallexFieldChrome"],
+      AIRWALLEX_FIELD_CHROMES,
+      DEFAULT_BRANDING.airwallexFieldChrome
+    ),
+    airwallexLabelStyle: pickEnumOrEmpty(
+      extras["airwallexLabelStyle"],
+      AIRWALLEX_LABEL_STYLES
+    ),
+    airwallexFieldFontSize: pickEnum(
+      extras["airwallexFieldFontSize"],
+      AIRWALLEX_FIELD_FONT_SIZES,
+      DEFAULT_BRANDING.airwallexFieldFontSize
+    ),
+    airwallexFieldWeight: pickEnum(
+      extras["airwallexFieldWeight"],
+      AIRWALLEX_FIELD_WEIGHTS,
+      DEFAULT_BRANDING.airwallexFieldWeight
+    ),
+    airwallexFocusRing: pickEnum(
+      extras["airwallexFocusRing"],
+      AIRWALLEX_FOCUS_RINGS,
+      DEFAULT_BRANDING.airwallexFocusRing
+    ),
+    airwallexAutofill: pickEnum(
+      extras["airwallexAutofill"],
+      AIRWALLEX_AUTOFILL_TREATMENTS,
+      DEFAULT_BRANDING.airwallexAutofill
+    ),
+    airwallexValidTint: parseBool(
+      extras["airwallexValidTint"],
+      DEFAULT_BRANDING.airwallexValidTint
+    ),
+    airwallexNetworkMarks: parseBool(
+      extras["airwallexNetworkMarks"],
+      DEFAULT_BRANDING.airwallexNetworkMarks
+    ),
     customCss: s(extras["customCss"])
   };
 }
@@ -6658,6 +6958,21 @@ function encodeBranding(branding, base) {
     logoShape: branding.logoShape,
     logoSize: branding.logoSize,
     labelStyle: branding.labelStyle,
+    // Written unconditionally, empty string included. The encoder REPLACES
+    // `sdk_ui_rules.branding` wholesale, so a key it skips is a key it
+    // deletes — and here the empty string is a real value ("no choice made"),
+    // not an absence. Omitting it would be indistinguishable from omitting it
+    // by accident, which is how `summaryOrder` was lost.
+    airwallexCardPreset: branding.airwallexCardPreset,
+    airwallexHideCard: String(branding.airwallexHideCard),
+    airwallexFieldChrome: branding.airwallexFieldChrome,
+    airwallexLabelStyle: branding.airwallexLabelStyle,
+    airwallexFieldFontSize: branding.airwallexFieldFontSize,
+    airwallexFieldWeight: branding.airwallexFieldWeight,
+    airwallexFocusRing: branding.airwallexFocusRing,
+    airwallexAutofill: branding.airwallexAutofill,
+    airwallexValidTint: String(branding.airwallexValidTint),
+    airwallexNetworkMarks: String(branding.airwallexNetworkMarks),
     trustBadges: encodeBadges(branding.trustBadges),
     [METHOD_SECTION_ORDER_KEY]: encodeMethodSectionOrder(branding.methodSectionOrder)
   };
@@ -6885,6 +7200,47 @@ function parseImportedBranding(raw) {
     ),
     labelStyle,
     showPoweredBy: parseBool(root["showPoweredBy"], dflt.showPoweredBy),
+    // An imported profile that predates this section carries none of these
+    // and lands on the defaults — which is to say on "defer", so importing an
+    // old export into a shop does not take that shop's connector setting
+    // away. The one field that would be dangerous to import loosely is the
+    // hide switch, and `parseBool` only says true for a literal `true`.
+    airwallexCardPreset: pickEnumOrEmpty(
+      root["airwallexCardPreset"],
+      AIRWALLEX_CARD_PRESETS
+    ),
+    airwallexHideCard: parseBool(root["airwallexHideCard"], dflt.airwallexHideCard),
+    airwallexFieldChrome: pickEnum(
+      root["airwallexFieldChrome"],
+      AIRWALLEX_FIELD_CHROMES,
+      dflt.airwallexFieldChrome
+    ),
+    airwallexLabelStyle: pickEnumOrEmpty(
+      root["airwallexLabelStyle"],
+      AIRWALLEX_LABEL_STYLES
+    ),
+    airwallexFieldFontSize: pickEnum(
+      root["airwallexFieldFontSize"],
+      AIRWALLEX_FIELD_FONT_SIZES,
+      dflt.airwallexFieldFontSize
+    ),
+    airwallexFieldWeight: pickEnum(
+      root["airwallexFieldWeight"],
+      AIRWALLEX_FIELD_WEIGHTS,
+      dflt.airwallexFieldWeight
+    ),
+    airwallexFocusRing: pickEnum(
+      root["airwallexFocusRing"],
+      AIRWALLEX_FOCUS_RINGS,
+      dflt.airwallexFocusRing
+    ),
+    airwallexAutofill: pickEnum(
+      root["airwallexAutofill"],
+      AIRWALLEX_AUTOFILL_TREATMENTS,
+      dflt.airwallexAutofill
+    ),
+    airwallexValidTint: parseBool(root["airwallexValidTint"], dflt.airwallexValidTint),
+    airwallexNetworkMarks: parseBool(root["airwallexNetworkMarks"], dflt.airwallexNetworkMarks),
     customCss: sStr(root["customCss"], dflt.customCss).slice(0, CUSTOM_CSS_MAX_LENGTH)
   };
 }
@@ -7723,6 +8079,16 @@ var decodeNativePanes = decodePanes;
 var encodeNativePanes = encodePanes;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AIRWALLEX_AUTOFILL_TREATMENTS,
+  AIRWALLEX_CARD_LAYOUTS,
+  AIRWALLEX_CARD_PRESETS,
+  AIRWALLEX_CARD_PRESET_FALLBACK,
+  AIRWALLEX_FIELD_CHROMES,
+  AIRWALLEX_FIELD_FONT_SIZES,
+  AIRWALLEX_FIELD_WEIGHTS,
+  AIRWALLEX_FOCUS_RINGS,
+  AIRWALLEX_LABEL_STYLES,
+  AIRWALLEX_NETWORK_MARKS,
   ALL_CUSTOM_FIELD_CONDITION_SOURCES,
   ALL_CUSTOM_FIELD_OPERATORS,
   ALL_CUSTOM_FIELD_TYPES,
@@ -7793,9 +8159,15 @@ var encodeNativePanes = encodePanes;
   WCAG_AA_TEXT,
   WCAG_AA_UI,
   Webhooks,
+  airwallexCardLayout,
+  airwallexCardLayoutIsCoherent,
+  airwallexCellWeight,
+  airwallexFieldFontPx,
+  airwallexFieldWeightValue,
   allOf,
   anyOf,
   applyBrandingVariables,
+  asAirwallexCardPreset,
   buildBrandingExport,
   buttonPadValue,
   canonicalSectionId,
@@ -7859,6 +8231,8 @@ var encodeNativePanes = encodePanes;
   programToTree,
   radiusValue,
   readableInkOn,
+  resolveAirwallexCardPreset,
+  resolveAirwallexLabelStyle,
   ruleMatchToTree,
   sanitizeCustomCss,
   sectionLabel,