@delopay/sdk 0.230.0 → 0.234.0

package/dist/index.cjs

@@ -139,6 +139,11 @@ __export(index_exports, {
   WHOP_CARD_PRESETS: () => WHOP_CARD_PRESETS,
   WHOP_EMAIL_LABELS: () => WHOP_EMAIL_LABELS,
   WHOP_GRAY_COLORS: () => WHOP_GRAY_COLORS,
+  WHOP_LOOKS: () => WHOP_LOOKS,
+  WHOP_LOOK_SETTINGS: () => WHOP_LOOK_SETTINGS,
+  WHOP_RADII: () => WHOP_RADII,
+  WHOP_SELECTIONS: () => WHOP_SELECTIONS,
+  WHOP_SHADOWS: () => WHOP_SHADOWS,
   Webhooks: () => Webhooks,
   WhopResolutionCases: () => WhopResolutionCases,
   airwallexCardLayout: () => airwallexCardLayout,
@@ -211,6 +216,7 @@ __export(index_exports, {
   knownSectionLabelKey: () => knownSectionLabelKey,
   leaf: () => leaf,
   logoDimensions: () => logoDimensions,
+  matchWhopLook: () => matchWhopLook,
   nativePaneMethodInfo: () => nativePaneMethodInfo,
   nearestWhopAccent: () => nearestWhopAccent,
   noticeText: () => noticeText,
@@ -248,6 +254,7 @@ __export(index_exports, {
   surfacePadValue: () => surfacePadValue,
   validSectionOrder: () => validSectionOrder,
   validatePanes: () => validatePanes,
+  vaultFormAppearance: () => vaultFormAppearance,
   verticalGapValue: () => verticalGapValue,
   visibleCustomFields: () => visibleCustomFields,
   whopAccentSwatch: () => whopAccentSwatch,
@@ -2100,6 +2107,20 @@ var PaymentLinks = class {
   async retrieve(linkId) {
     return this.request("GET", `/payment-link/${encodeURIComponent(linkId)}`);
   }
+  /**
+   * The merchant and payment an opaque checkout link opens.
+   *
+   * A link the API issues today is `/pay/{payment_link_id}`, so it names
+   * neither the merchant nor the payment. This answers which ones it means.
+   * Unauthenticated, like the checkout render it precedes: no credential is
+   * needed or sent beyond what the client already carries. An unknown id is a
+   * 404.
+   *
+   * `GET /payment-link/resolve/{payment_link_id}`
+   */
+  async resolve(paymentLinkId) {
+    return this.request("GET", `/payment-link/resolve/${encodeURIComponent(paymentLinkId)}`);
+  }
   /**
    * List payment links, optionally filtered by status or date range.
    *
@@ -8910,6 +8931,114 @@ var WHOP_GRAY_COLORS = [
   "sand"
 ];
 var WHOP_BILLING_DETAILS = ["minimal", "full"];
+var WHOP_RADII = ["checkout", "square", "small", "medium", "large"];
+var WHOP_SHADOWS = ["none", "soft"];
+var WHOP_SELECTIONS = ["radio_tint", "radio", "tint"];
+var WHOP_LOOKS = [
+  "standard",
+  "clean",
+  "whop",
+  "cards",
+  "tiles",
+  "soft",
+  "minimal"
+];
+var WHOP_LOOK_SETTINGS = {
+  // The fewest fields Whop takes a card with, laid out as Stripe's card
+  // form: the email, the number above expiry and code, then one group of
+  // name, country (preselected) and postal code. Whop refuses a card without
+  // any of them. The wallets are the shop's own express buttons.
+  standard: {
+    whopCardPreset: "card_stacked",
+    whopBillingDetails: "minimal",
+    whopSeparated: false,
+    whopFieldChrome: "outlined",
+    whopEmailLabel: "above",
+    whopRadius: "checkout",
+    whopShadow: "soft",
+    whopMethodIcons: true,
+    whopSelection: "radio_tint"
+  },
+  // Flat fields like the checkout's own, the method list with the chosen
+  // method tinted beside its radio.
+  clean: {
+    whopCardPreset: "accordion",
+    whopBillingDetails: "minimal",
+    whopSeparated: false,
+    whopFieldChrome: "outlined",
+    whopEmailLabel: "above",
+    whopRadius: "checkout",
+    whopShadow: "none",
+    whopMethodIcons: true,
+    whopSelection: "radio_tint"
+  },
+  // Whop's own form: its corners, its soft shadow, its radio dots.
+  whop: {
+    whopCardPreset: "accordion",
+    whopBillingDetails: "minimal",
+    whopSeparated: false,
+    whopFieldChrome: "outlined",
+    whopEmailLabel: "above",
+    whopRadius: "small",
+    whopShadow: "soft",
+    whopMethodIcons: true,
+    whopSelection: "radio"
+  },
+  // Each method its own raised card, the chosen one tinted, no dots.
+  cards: {
+    whopCardPreset: "accordion",
+    whopBillingDetails: "minimal",
+    whopSeparated: true,
+    whopFieldChrome: "outlined",
+    whopEmailLabel: "above",
+    whopRadius: "medium",
+    whopShadow: "soft",
+    whopMethodIcons: true,
+    whopSelection: "tint"
+  },
+  // The methods as tiles above the card's fields.
+  tiles: {
+    whopCardPreset: "tiles",
+    whopBillingDetails: "minimal",
+    whopSeparated: false,
+    whopFieldChrome: "outlined",
+    whopEmailLabel: "above",
+    whopRadius: "checkout",
+    whopShadow: "none",
+    whopMethodIcons: true,
+    whopSelection: "radio_tint"
+  },
+  // Filled fields with the captions inside, round corners.
+  soft: {
+    whopCardPreset: "accordion",
+    whopBillingDetails: "minimal",
+    whopSeparated: false,
+    whopFieldChrome: "filled",
+    whopEmailLabel: "floating",
+    whopRadius: "large",
+    whopShadow: "none",
+    whopMethodIcons: false,
+    whopSelection: "radio_tint"
+  },
+  // The card alone on one line, underlined, captions inside.
+  minimal: {
+    whopCardPreset: "card_compact",
+    whopBillingDetails: "minimal",
+    whopSeparated: false,
+    whopFieldChrome: "underline",
+    whopEmailLabel: "floating",
+    whopRadius: "square",
+    whopShadow: "none",
+    whopMethodIcons: true,
+    whopSelection: "radio_tint"
+  }
+};
+function matchWhopLook(settings) {
+  const keys = Object.keys(WHOP_LOOK_SETTINGS.clean);
+  return WHOP_LOOKS.find(
+    (look) => keys.every((key) => WHOP_LOOK_SETTINGS[look][key] === settings[key])
+  ) ?? null;
+}
 
 // src/branding.ts
 function surchargeShowsLabel(labelMode, style, position) {
@@ -9184,6 +9313,19 @@ function inputPadValue(size) {
 function buttonPadValue(size) {
   return BUTTON_PAD[size] ?? BUTTON_PAD.md;
 }
+function vaultFormAppearance(b, danger) {
+  return {
+    surface: b.surface,
+    text: b.text,
+    border: b.border,
+    accent: b.primary,
+    ...danger ? { danger } : {},
+    font: b.fontFamily,
+    radius: b.radiusInput,
+    size: b.inputSize,
+    labels: b.labelStyle
+  };
+}
 function logoDimensions(size) {
   switch (size) {
     case "sm":
@@ -9663,7 +9805,7 @@ var DEFAULT_BRANDING_BASE = {
   micropaymentFieldFontSize: "md",
   micropaymentFieldWeight: "regular",
   micropaymentFocusRing: "strong",
-  whopCardPreset: "accordion",
+  whopCardPreset: "card_stacked",
   whopAccentColor: "auto",
   whopGrayColor: "auto",
   whopBillingDetails: "minimal",
@@ -9673,6 +9815,10 @@ var DEFAULT_BRANDING_BASE = {
   whopFieldFontSize: "md",
   whopFieldWeight: "regular",
   whopFocusRing: "strong",
+  whopRadius: "checkout",
+  whopShadow: "soft",
+  whopMethodIcons: true,
+  whopSelection: "radio_tint",
   customCss: ""
 };
 var DEFAULT_BRANDING = {
@@ -10661,6 +10807,18 @@ function decodeBranding(source) {
       CARD_FOCUS_RINGS,
       DEFAULT_BRANDING.whopFocusRing
     ),
+    whopRadius: pickEnum(extras["whopRadius"], WHOP_RADII, DEFAULT_BRANDING.whopRadius),
+    whopShadow: pickEnum(
+      extras["whopShadow"],
+      WHOP_SHADOWS,
+      DEFAULT_BRANDING.whopShadow
+    ),
+    whopMethodIcons: parseBool(extras["whopMethodIcons"], DEFAULT_BRANDING.whopMethodIcons),
+    whopSelection: pickEnum(
+      extras["whopSelection"],
+      WHOP_SELECTIONS,
+      DEFAULT_BRANDING.whopSelection
+    ),
     paypalValidTint: parseBool(extras["paypalValidTint"], DEFAULT_BRANDING.paypalValidTint),
     nomupayFormStyle: pickEnum(
       extras["nomupayFormStyle"],
@@ -10818,6 +10976,10 @@ function encodeBranding(branding, base) {
     whopFieldFontSize: branding.whopFieldFontSize,
     whopFieldWeight: branding.whopFieldWeight,
     whopFocusRing: branding.whopFocusRing,
+    whopRadius: branding.whopRadius,
+    whopShadow: branding.whopShadow,
+    whopMethodIcons: String(branding.whopMethodIcons),
+    whopSelection: branding.whopSelection,
     paypalValidTint: String(branding.paypalValidTint),
     nomupayFormStyle: branding.nomupayFormStyle,
     nomupayShowLabels: String(branding.nomupayShowLabels),
@@ -11271,6 +11433,14 @@ function parseImportedBranding(raw) {
       CARD_FOCUS_RINGS,
       dflt.whopFocusRing
     ),
+    whopRadius: pickEnum(root["whopRadius"], WHOP_RADII, dflt.whopRadius),
+    whopShadow: pickEnum(root["whopShadow"], WHOP_SHADOWS, dflt.whopShadow),
+    whopMethodIcons: parseBool(root["whopMethodIcons"], dflt.whopMethodIcons),
+    whopSelection: pickEnum(
+      root["whopSelection"],
+      WHOP_SELECTIONS,
+      dflt.whopSelection
+    ),
     paypalValidTint: parseBool(root["paypalValidTint"], dflt.paypalValidTint),
     nomupayFormStyle: pickEnum(
       root["nomupayFormStyle"],
@@ -11810,11 +11980,29 @@ var CheckoutSession = class {
    * reports the vault as enabled and still expects its cards cloaked. The same
    * status also covers a payment that does not exist.
    *
+   * `params.appearance` asks for a form styled to match the page (Enigma
+   * Vault). The answer then carries `height`, the frame height to use. If the
+   * vault refuses the styled form the answer is the plain one, without
+   * `height`. `params.locale` is the buyer's locale.
+   *
    * `GET /payment-link/{merchantId}/{paymentId}/vault/collect-session`
    */
-  async vaultCollectSession(options) {
+  async vaultCollectSession(options, params) {
+    const look = params?.appearance;
     return this.client.request("GET", `${this.linkBase}/vault/collect-session`, {
       ...options,
+      query: {
+        locale: params?.locale,
+        form_surface: look?.surface,
+        form_text: look?.text,
+        form_border: look?.border,
+        form_accent: look?.accent,
+        form_danger: look?.danger,
+        form_font: look?.font,
+        form_radius: look?.radius,
+        form_size: look?.size,
+        form_labels: look?.labels
+      },
       headers: this.bearerHeaders(options?.headers)
     });
   }
@@ -12403,9 +12591,10 @@ function encodePanes(panes) {
     };
   });
 }
+var OPAQUE_PAYMENT_LINK_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
 function focusedCheckoutUrl(params) {
   const base = params.checkoutBaseUrl.replace(/\/+$/, "");
-  const path = `${base}/pay/${encodeURIComponent(params.merchantId)}/${encodeURIComponent(
+  const path = params.paymentLinkId && OPAQUE_PAYMENT_LINK_ID.test(params.paymentLinkId) ? `${base}/pay/${params.paymentLinkId}` : `${base}/pay/${encodeURIComponent(params.merchantId)}/${encodeURIComponent(
     params.paymentId
   )}`;
   const query = new URLSearchParams({ pane: params.method });
@@ -12564,6 +12753,11 @@ var encodeNativePanes = encodePanes;
   WHOP_CARD_PRESETS,
   WHOP_EMAIL_LABELS,
   WHOP_GRAY_COLORS,
+  WHOP_LOOKS,
+  WHOP_LOOK_SETTINGS,
+  WHOP_RADII,
+  WHOP_SELECTIONS,
+  WHOP_SHADOWS,
   Webhooks,
   WhopResolutionCases,
   airwallexCardLayout,
@@ -12636,6 +12830,7 @@ var encodeNativePanes = encodePanes;
   knownSectionLabelKey,
   leaf,
   logoDimensions,
+  matchWhopLook,
   nativePaneMethodInfo,
   nearestWhopAccent,
   noticeText,
@@ -12673,6 +12868,7 @@ var encodeNativePanes = encodePanes;
   surfacePadValue,
   validSectionOrder,
   validatePanes,
+  vaultFormAppearance,
   verticalGapValue,
   visibleCustomFields,
   whopAccentSwatch,