@delopay/sdk 0.232.0 → 0.235.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,
@@ -8925,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) {
@@ -9691,7 +9805,7 @@ var DEFAULT_BRANDING_BASE = {
   micropaymentFieldFontSize: "md",
   micropaymentFieldWeight: "regular",
   micropaymentFocusRing: "strong",
-  whopCardPreset: "accordion",
+  whopCardPreset: "card_stacked",
   whopAccentColor: "auto",
   whopGrayColor: "auto",
   whopBillingDetails: "minimal",
@@ -9701,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 = {
@@ -10689,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"],
@@ -10846,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),
@@ -11299,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"],
@@ -11427,6 +11569,21 @@ function withoutCredentialHeaders(extra) {
   }
   return out;
 }
+function vaultFormQuery(params) {
+  const look = params?.appearance;
+  return {
+    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
+  };
+}
 function withoutHeader(headers, name) {
   const out = {};
   for (const [key, value] of Object.entries(headers)) {
@@ -11846,21 +12003,31 @@ var CheckoutSession = class {
    * `GET /payment-link/{merchantId}/{paymentId}/vault/collect-session`
    */
   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
-      },
+      query: vaultFormQuery(params),
+      headers: this.bearerHeaders(options?.headers)
+    });
+  }
+  /**
+   * The saved cards the buyer of this payment can pay with, on a shop whose
+   * vault keeps the security code itself (Enigma Vault): the cards of the
+   * payment's own customer that the shop's vault holds, most recently used
+   * first. A payment without a customer answers an empty list.
+   *
+   * Draw saved cards from this list, not from the customer's payment-method
+   * list: that one also carries cards the security-code form cannot open.
+   * To pay with one, mint its form with {@link vaultSecurityCodeSession},
+   * and confirm with its `payment_token` once the form reports the code
+   * stored.
+   *
+   * A shop without a vault, and a VGS shop, answer `400`.
+   *
+   * `GET /payment-link/{merchantId}/{paymentId}/vault/saved-cards`
+   */
+  async vaultSavedCards(options) {
+    return this.client.request("GET", `${this.linkBase}/vault/saved-cards`, {
+      ...options,
       headers: this.bearerHeaders(options?.headers)
     });
   }
@@ -11870,15 +12037,24 @@ var CheckoutSession = class {
    * vault's own form, so it never reaches the checkout; confirm with the saved
    * card's `payment_token` once the form reports it stored.
    *
-   * `paymentToken` is the saved card's token from the payment-method list. A
+   * `paymentToken` is the saved card's token from {@link vaultSavedCards}. A
    * VGS shop answers `400`: VGS re-collects the code with Collect.
    *
+   * `params.appearance` asks for a form styled to match the page, as on
+   * {@link vaultCollectSession}. The styled form is the security-code field
+   * alone, with no label: draw the label beside the frame, and size the frame
+   * to the answer's `height`. `labels` is ignored. If the vault refuses the
+   * styled form the answer is the plain one, without `height`.
+   *
+   * The form stores one code and then disables itself. After a failed
+   * payment, mint a new form before the buyer tries again.
+   *
    * `GET /payment-link/{merchantId}/{paymentId}/vault/security-code-session`
    */
-  async vaultSecurityCodeSession(paymentToken, options) {
+  async vaultSecurityCodeSession(paymentToken, options, params) {
     return this.client.request("GET", `${this.linkBase}/vault/security-code-session`, {
       ...options,
-      query: { payment_token: paymentToken },
+      query: { payment_token: paymentToken, ...vaultFormQuery(params) },
       headers: this.bearerHeaders(options?.headers)
     });
   }
@@ -12611,6 +12787,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,
@@ -12683,6 +12864,7 @@ var encodeNativePanes = encodePanes;
   knownSectionLabelKey,
   leaf,
   logoDimensions,
+  matchWhopLook,
   nativePaneMethodInfo,
   nearestWhopAccent,
   noticeText,