@appfunnel-dev/sdk 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,68 @@
 # Changelog
 
+## 2.1.0
+
+### `methods` is now `options`, and it styles the wallet button
+
+`<Checkout>` and `<CheckoutButton>` take `options` where they took `methods`. Everything `methods`
+did works the same under the new name, and `methods` keeps working.
+
+New in `options`: `express`, the wallet button. It takes Stripe's own Express Checkout Element
+options — which wallets show (`paymentMethods`), how many buttons per row and how many rows
+(`layout`), and the buttons' height, colour and label (`buttonHeight`, `buttonTheme`, `buttonType`).
+
+```tsx
+<Checkout
+  offering="plan"
+  options={{ express: { paymentMethods: { link: 'auto' }, layout: { maxColumns: 1 }, buttonHeight: 48 } }}
+/>
+```
+
+### The wallet button offers Apple Pay and Google Pay only
+
+The wallet button used to offer every wallet the Stripe account had turned on, Link, PayPal, Amazon
+Pay and Klarna included. It now offers Apple Pay and Google Pay, both `'always'`; the others are off
+unless a funnel names them in `options.express.paymentMethods`. Anything you name is merged over
+that default, one wallet at a time.
+
+`'always'` shows Apple Pay and Google Pay wherever the browser supports them, even before the
+visitor has added a card. Set `'auto'` to show them only where a card is ready to pay.
+
+## 2.0.1
+
+A checkout that names no offering is now caught, in both places it can be caught.
+
+### A missing `offering` fails the build
+
+`<Checkout>`, `<CheckoutButton>` and `<UpsellButton>` must name the offering slot they charge.
+A tag that doesn't now fails the build, with the file and line:
+
+```
+checkout with no `offering`:
+  pages/paywall.tsx:27  <Checkout>
+```
+
+This closes a gap where such a tag was invisible end to end. It contributes no offering
+reference, so the manifest's unknown/unassigned-slot validation never saw the slot and the
+publish gate passed with nothing to check — while at runtime the charge resolved to nothing and
+the page shipped with a dead paywall. A funnel build is a bundler transform, so types are
+stripped rather than checked; nothing else in the deploy path was looking.
+
+The shape that hits this most often is the pre-2.0 spelling `<Checkout product="plan">`, where
+the offering arrives under the old prop name and `offering` is simply absent.
+
+Tags whose offering cannot be read statically are unaffected: `offering={expr}` and a tag
+carrying a spread (`<Checkout {...props} />`) both pass — the same relaxation the rest of the
+page scan applies to anything it cannot enumerate.
+
+### A missing `offering` is refused at runtime
+
+For the cases no static scan can see — an `offering={expr}` that evaluated to nothing, a spread
+that did not carry one — the components now refuse instead of resolving nothing. The refusal
+reports through the normal failure path (`checkout.failed`, a non-retryable `processing_error`,
+any `onFailed` routes) and renders nothing chargeable. On `<UpsellButton>` the trigger itself
+never renders: an upsell charges off-session on the first tap, so there must be nothing to tap.
+
 ## 2.0.0
 
 First stable release of the v2 SDK, and the first v2 release published to the `latest`
@@ -7,11 +70,14 @@ dist-tag. Everything from `2.0.0-canary.1` through `2.0.0-canary.36` is folded i
 release; the canary line is closed.
 
 **`npm install @appfunnel-dev/sdk` now resolves to 2.0.0, not 0.17.0.** v2 is a rewrite,
-not an upgrade — a 0.17 funnel will not build against it. Stay on 0.17 by pinning the
-exact version:
+not an upgrade — a 0.17 funnel will not build against it.
+
+**The 2.0.x line is the only thing on the registry.** Every 0.x release and the whole
+`2.0.0-canary.*` line have been unpublished, so there is no version to stay on: a funnel
+still pinned to one of them fails its next build at install (`ETARGET`). Move the pin:
 
 ```json
-{ "dependencies": { "@appfunnel-dev/sdk": "0.17.0" } }
+{ "dependencies": { "@appfunnel-dev/sdk": "2.0.0" } }
 ```
 
 ### The v2 surface

package/dist/{checkout-BYcOfyg_.d.ts → checkout-BPYU4wXF.d.ts}

@@ -1,5 +1,5 @@
 import { ReactNode, ComponentType, ReactElement } from 'react';
-import { Appearance } from '@stripe/stripe-js';
+import { Appearance, StripeExpressCheckoutElementOptions } from '@stripe/stripe-js';
 import { CheckoutSettings } from '@paddle/paddle-js';
 import { c as CheckoutProvider, b as CheckoutIntent, d as CheckoutSurface, U as UpsellKind, C as CheckoutError, a as CheckoutErrorCategory, h as PaymentMode, H as HostedPaymentMode, e as OpensIn, i as PaymentRendering } from './capabilities-BtnJi2JD.js';
 
@@ -99,10 +99,11 @@ interface CheckoutRequest {
      */
     appearance?: CheckoutAppearance;
     /**
-     * How the provider LISTS the payment methods — see {@link CheckoutMethods}. Display-only, same
-     * as `appearance`: it never leaves the browser.
+     * How the provider LISTS the payment methods and draws the wallet button — the author's
+     * `options` (see {@link CheckoutOptions}). Display-only, same as `appearance`: it never leaves
+     * the browser.
      */
-    methods?: CheckoutMethods;
+    methods?: CheckoutOptions;
     /**
      * Classes for the buttons the SDK renders itself — see {@link CheckoutClassNames}. Display-only.
      */
@@ -162,22 +163,22 @@ interface CheckoutAppearance {
     paddle?: Pick<CheckoutSettings, 'theme' | 'frameStyle' | 'frameInitialHeight'>;
 }
 /**
- * How the list of payment methods is PRESENTED, in the surfaces the SDK mounts itself.
+ * How the payment methods are PRESENTED — the method list and the wallet button — in the surfaces
+ * the SDK mounts itself.
  *
  * Normalized, unlike {@link CheckoutAppearance} — and the difference is real rather than an
  * inconsistency. Appearance is a token bag whose true cross-provider intersection is roughly empty,
  * so a shared shape there would be a lie. "Stack the methods and start them collapsed" is one idea
  * with one meaning, so it gets one spelling.
  *
- * The DEFAULT is `{ layout: 'accordion', collapsed: true }`: the buyer sees the methods they can pay
- * with — wallets included — and picks one before any field appears, instead of landing on an open
- * card form with the wallet they'd have preferred hidden below it.
+ * The DEFAULT is `{ layout: 'accordion', collapsed: false }` — the first method open — and a wallet
+ * button offering Apple Pay and Google Pay (see {@link CheckoutOptions.express}).
  *
  * ```tsx
  * <Checkout offering="plan" />                                          // accordion, collapsed
- * <Checkout offering="plan" methods={{ collapsed: false }} />           // first method open
- * <Checkout offering="plan" methods={{ layout: 'tabs' }} />             // methods across the top
- * <Checkout offering="plan" methods={{ order: ['apple_pay', 'card'] }} /> // lead with Apple Pay
+ * <Checkout offering="plan" options={{ collapsed: false }} />           // first method open
+ * <Checkout offering="plan" options={{ layout: 'tabs' }} />             // methods across the top
+ * <Checkout offering="plan" options={{ order: ['apple_pay', 'card'] }} /> // lead with Apple Pay
  * ```
  *
  * **Only applies where the SDK mounts the method list** — `payment="card"`, and the `payment="auto"`
@@ -186,7 +187,7 @@ interface CheckoutAppearance {
  * setting. Wallets also have to be able to appear at all before ordering them means anything — that
  * needs the domain registered with Stripe as a payment method domain.
  */
-interface CheckoutMethods {
+interface CheckoutOptions {
     /** `'accordion'` (default) stacks the methods as rows; `'tabs'` runs them across the top. */
     layout?: 'accordion' | 'tabs';
     /** Start with every method closed, so the buyer chooses before any fields render. Default `true`. */
@@ -208,7 +209,32 @@ interface CheckoutMethods {
      * nowhere else to go on this screen. Leave it on unless the funnel is deliberately wallet-only.
      */
     payAnotherWay?: boolean;
+    /**
+     * The wallet BUTTON — Stripe's Express Checkout Element options, passed through as-is: which
+     * wallets it offers (`paymentMethods`), how many buttons per row and how many rows (`layout`),
+     * and the buttons' height, colour and label (`buttonHeight`, `buttonTheme`, `buttonType`).
+     *
+     * ```tsx
+     * <Checkout offering="plan" options={{ express: { paymentMethods: { link: 'auto' } } }} />
+     * <Checkout offering="plan" options={{ express: { layout: { maxColumns: 1 }, buttonHeight: 48 } }} />
+     * ```
+     *
+     * `paymentMethods` defaults to Apple Pay and Google Pay (`'always'`) with Link, PayPal, Amazon Pay
+     * and Klarna off (`'never'`), merged per wallet over that default — `{ link: 'auto' }` adds Link
+     * and leaves the rest as they were. `'always'` shows Apple Pay / Google Pay wherever the browser
+     * supports them, even before the buyer has added a card; `'auto'` only where one is ready to pay.
+     * Everything else unset is Stripe's default. Stripe only.
+     */
+    express?: CheckoutExpressOptions;
 }
+/**
+ * The part of Stripe's `StripeExpressCheckoutElementOptions` that decides what the wallet button
+ * offers and how it LOOKS. The rest (line items, shipping, email and phone collection) belongs to the
+ * charge, which the SDK sets, so it isn't offered here.
+ */
+type CheckoutExpressOptions = Pick<StripeExpressCheckoutElementOptions, 'paymentMethods' | 'paymentMethodOrder' | 'layout' | 'buttonHeight' | 'buttonTheme' | 'buttonType'>;
+/** @deprecated Renamed to {@link CheckoutOptions}. */
+type CheckoutMethods = CheckoutOptions;
 interface CheckoutResult {
     ok: boolean;
     error?: CheckoutError;
@@ -222,6 +248,12 @@ interface CheckoutResult {
      * source of truth for payment events; the SDK doesn't mint these.)
      */
     eventId?: string;
+    /**
+     * Server-decided acquisition shape. A trial start reports `subscription.trial_started`
+     * (→ Meta/TikTok StartTrial), never `purchase.complete`/`subscription.created` — see
+     * {@link CheckoutSettlement.acquisition}.
+     */
+    acquisition?: 'direct' | 'free_trial' | 'paid_trial';
 }
 interface CheckoutCallbacks {
     onSuccess: (result: CheckoutResult) => void;
@@ -502,9 +534,11 @@ interface CheckoutCommonProps extends Omit<UseCheckoutOptions, 'managed'> {
      * fields render in a cross-origin iframe the funnel's CSS can't reach.
      */
     appearance?: CheckoutAppearance;
-    /** How the provider lists the payment methods ({@link CheckoutMethods}) — accordion + collapsed
-     *  by default. Ignored on surfaces where the provider owns the whole UI. */
-    methods?: CheckoutMethods;
+    /** How the payment methods are listed and how the wallet button looks ({@link CheckoutOptions}).
+     *  Ignored on surfaces where the provider owns the whole UI. */
+    options?: CheckoutOptions;
+    /** @deprecated Renamed to `options`. */
+    methods?: CheckoutOptions;
 }
 /**
  * The `managed` × `payment` constraint, as a type rather than a runtime rejection.
@@ -741,4 +775,4 @@ declare function UpsellButton(props: UpsellButtonProps): ReactNode;
  */
 declare function CheckoutResume(options?: UseCheckoutOptions): ReactNode;
 
-export { useCheckout as A, type CheckoutDriverContext as C, type FailureModalProps as F, type MockDriverOptions as M, type OnFailedMap as O, type PaymentAxis as P, type TriggerAxis as T, UpsellButton as U, type CheckoutDriver as a, Checkout as b, type CheckoutAppearance as c, CheckoutButton as d, type CheckoutButtonProps as e, type CheckoutCallbacks as f, type CheckoutClassNames as g, type CheckoutCommonProps as h, type CheckoutHandle as i, type CheckoutInlineProps as j, type CheckoutMethods as k, type CheckoutProps as l, type CheckoutRequest as m, type CheckoutResult as n, CheckoutResume as o, CheckoutSpinner as p, type CheckoutStatus as q, type FailureRoute as r, type OpensAxis as s, type TriggerState as t, type UpsellButtonProps as u, type UpsellCommonProps as v, type UpsellRecovery as w, type UseCheckoutOptions as x, createMockDriver as y, driverWithEmail as z };
+export { createMockDriver as A, driverWithEmail as B, type CheckoutDriverContext as C, useCheckout as D, type FailureModalProps as F, type MockDriverOptions as M, type OnFailedMap as O, type PaymentAxis as P, type TriggerAxis as T, UpsellButton as U, type CheckoutDriver as a, Checkout as b, type CheckoutAppearance as c, CheckoutButton as d, type CheckoutButtonProps as e, type CheckoutCallbacks as f, type CheckoutClassNames as g, type CheckoutCommonProps as h, type CheckoutExpressOptions as i, type CheckoutHandle as j, type CheckoutInlineProps as k, type CheckoutMethods as l, type CheckoutOptions as m, type CheckoutProps as n, type CheckoutRequest as o, type CheckoutResult as p, CheckoutResume as q, CheckoutSpinner as r, type CheckoutStatus as s, type FailureRoute as t, type OpensAxis as u, type TriggerState as v, type UpsellButtonProps as w, type UpsellCommonProps as x, type UpsellRecovery as y, type UseCheckoutOptions as z };

package/dist/{checkout-BM1T-u6_.d.cts → checkout-BzP__Mxe.d.cts}

@@ -1,5 +1,5 @@
 import { ReactNode, ComponentType, ReactElement } from 'react';
-import { Appearance } from '@stripe/stripe-js';
+import { Appearance, StripeExpressCheckoutElementOptions } from '@stripe/stripe-js';
 import { CheckoutSettings } from '@paddle/paddle-js';
 import { c as CheckoutProvider, b as CheckoutIntent, d as CheckoutSurface, U as UpsellKind, C as CheckoutError, a as CheckoutErrorCategory, h as PaymentMode, H as HostedPaymentMode, e as OpensIn, i as PaymentRendering } from './capabilities-BtnJi2JD.cjs';
 
@@ -99,10 +99,11 @@ interface CheckoutRequest {
      */
     appearance?: CheckoutAppearance;
     /**
-     * How the provider LISTS the payment methods — see {@link CheckoutMethods}. Display-only, same
-     * as `appearance`: it never leaves the browser.
+     * How the provider LISTS the payment methods and draws the wallet button — the author's
+     * `options` (see {@link CheckoutOptions}). Display-only, same as `appearance`: it never leaves
+     * the browser.
      */
-    methods?: CheckoutMethods;
+    methods?: CheckoutOptions;
     /**
      * Classes for the buttons the SDK renders itself — see {@link CheckoutClassNames}. Display-only.
      */
@@ -162,22 +163,22 @@ interface CheckoutAppearance {
     paddle?: Pick<CheckoutSettings, 'theme' | 'frameStyle' | 'frameInitialHeight'>;
 }
 /**
- * How the list of payment methods is PRESENTED, in the surfaces the SDK mounts itself.
+ * How the payment methods are PRESENTED — the method list and the wallet button — in the surfaces
+ * the SDK mounts itself.
  *
  * Normalized, unlike {@link CheckoutAppearance} — and the difference is real rather than an
  * inconsistency. Appearance is a token bag whose true cross-provider intersection is roughly empty,
  * so a shared shape there would be a lie. "Stack the methods and start them collapsed" is one idea
  * with one meaning, so it gets one spelling.
  *
- * The DEFAULT is `{ layout: 'accordion', collapsed: true }`: the buyer sees the methods they can pay
- * with — wallets included — and picks one before any field appears, instead of landing on an open
- * card form with the wallet they'd have preferred hidden below it.
+ * The DEFAULT is `{ layout: 'accordion', collapsed: false }` — the first method open — and a wallet
+ * button offering Apple Pay and Google Pay (see {@link CheckoutOptions.express}).
  *
  * ```tsx
  * <Checkout offering="plan" />                                          // accordion, collapsed
- * <Checkout offering="plan" methods={{ collapsed: false }} />           // first method open
- * <Checkout offering="plan" methods={{ layout: 'tabs' }} />             // methods across the top
- * <Checkout offering="plan" methods={{ order: ['apple_pay', 'card'] }} /> // lead with Apple Pay
+ * <Checkout offering="plan" options={{ collapsed: false }} />           // first method open
+ * <Checkout offering="plan" options={{ layout: 'tabs' }} />             // methods across the top
+ * <Checkout offering="plan" options={{ order: ['apple_pay', 'card'] }} /> // lead with Apple Pay
  * ```
  *
  * **Only applies where the SDK mounts the method list** — `payment="card"`, and the `payment="auto"`
@@ -186,7 +187,7 @@ interface CheckoutAppearance {
  * setting. Wallets also have to be able to appear at all before ordering them means anything — that
  * needs the domain registered with Stripe as a payment method domain.
  */
-interface CheckoutMethods {
+interface CheckoutOptions {
     /** `'accordion'` (default) stacks the methods as rows; `'tabs'` runs them across the top. */
     layout?: 'accordion' | 'tabs';
     /** Start with every method closed, so the buyer chooses before any fields render. Default `true`. */
@@ -208,7 +209,32 @@ interface CheckoutMethods {
      * nowhere else to go on this screen. Leave it on unless the funnel is deliberately wallet-only.
      */
     payAnotherWay?: boolean;
+    /**
+     * The wallet BUTTON — Stripe's Express Checkout Element options, passed through as-is: which
+     * wallets it offers (`paymentMethods`), how many buttons per row and how many rows (`layout`),
+     * and the buttons' height, colour and label (`buttonHeight`, `buttonTheme`, `buttonType`).
+     *
+     * ```tsx
+     * <Checkout offering="plan" options={{ express: { paymentMethods: { link: 'auto' } } }} />
+     * <Checkout offering="plan" options={{ express: { layout: { maxColumns: 1 }, buttonHeight: 48 } }} />
+     * ```
+     *
+     * `paymentMethods` defaults to Apple Pay and Google Pay (`'always'`) with Link, PayPal, Amazon Pay
+     * and Klarna off (`'never'`), merged per wallet over that default — `{ link: 'auto' }` adds Link
+     * and leaves the rest as they were. `'always'` shows Apple Pay / Google Pay wherever the browser
+     * supports them, even before the buyer has added a card; `'auto'` only where one is ready to pay.
+     * Everything else unset is Stripe's default. Stripe only.
+     */
+    express?: CheckoutExpressOptions;
 }
+/**
+ * The part of Stripe's `StripeExpressCheckoutElementOptions` that decides what the wallet button
+ * offers and how it LOOKS. The rest (line items, shipping, email and phone collection) belongs to the
+ * charge, which the SDK sets, so it isn't offered here.
+ */
+type CheckoutExpressOptions = Pick<StripeExpressCheckoutElementOptions, 'paymentMethods' | 'paymentMethodOrder' | 'layout' | 'buttonHeight' | 'buttonTheme' | 'buttonType'>;
+/** @deprecated Renamed to {@link CheckoutOptions}. */
+type CheckoutMethods = CheckoutOptions;
 interface CheckoutResult {
     ok: boolean;
     error?: CheckoutError;
@@ -222,6 +248,12 @@ interface CheckoutResult {
      * source of truth for payment events; the SDK doesn't mint these.)
      */
     eventId?: string;
+    /**
+     * Server-decided acquisition shape. A trial start reports `subscription.trial_started`
+     * (→ Meta/TikTok StartTrial), never `purchase.complete`/`subscription.created` — see
+     * {@link CheckoutSettlement.acquisition}.
+     */
+    acquisition?: 'direct' | 'free_trial' | 'paid_trial';
 }
 interface CheckoutCallbacks {
     onSuccess: (result: CheckoutResult) => void;
@@ -502,9 +534,11 @@ interface CheckoutCommonProps extends Omit<UseCheckoutOptions, 'managed'> {
      * fields render in a cross-origin iframe the funnel's CSS can't reach.
      */
     appearance?: CheckoutAppearance;
-    /** How the provider lists the payment methods ({@link CheckoutMethods}) — accordion + collapsed
-     *  by default. Ignored on surfaces where the provider owns the whole UI. */
-    methods?: CheckoutMethods;
+    /** How the payment methods are listed and how the wallet button looks ({@link CheckoutOptions}).
+     *  Ignored on surfaces where the provider owns the whole UI. */
+    options?: CheckoutOptions;
+    /** @deprecated Renamed to `options`. */
+    methods?: CheckoutOptions;
 }
 /**
  * The `managed` × `payment` constraint, as a type rather than a runtime rejection.
@@ -741,4 +775,4 @@ declare function UpsellButton(props: UpsellButtonProps): ReactNode;
  */
 declare function CheckoutResume(options?: UseCheckoutOptions): ReactNode;
 
-export { useCheckout as A, type CheckoutDriverContext as C, type FailureModalProps as F, type MockDriverOptions as M, type OnFailedMap as O, type PaymentAxis as P, type TriggerAxis as T, UpsellButton as U, type CheckoutDriver as a, Checkout as b, type CheckoutAppearance as c, CheckoutButton as d, type CheckoutButtonProps as e, type CheckoutCallbacks as f, type CheckoutClassNames as g, type CheckoutCommonProps as h, type CheckoutHandle as i, type CheckoutInlineProps as j, type CheckoutMethods as k, type CheckoutProps as l, type CheckoutRequest as m, type CheckoutResult as n, CheckoutResume as o, CheckoutSpinner as p, type CheckoutStatus as q, type FailureRoute as r, type OpensAxis as s, type TriggerState as t, type UpsellButtonProps as u, type UpsellCommonProps as v, type UpsellRecovery as w, type UseCheckoutOptions as x, createMockDriver as y, driverWithEmail as z };
+export { createMockDriver as A, driverWithEmail as B, type CheckoutDriverContext as C, useCheckout as D, type FailureModalProps as F, type MockDriverOptions as M, type OnFailedMap as O, type PaymentAxis as P, type TriggerAxis as T, UpsellButton as U, type CheckoutDriver as a, Checkout as b, type CheckoutAppearance as c, CheckoutButton as d, type CheckoutButtonProps as e, type CheckoutCallbacks as f, type CheckoutClassNames as g, type CheckoutCommonProps as h, type CheckoutExpressOptions as i, type CheckoutHandle as j, type CheckoutInlineProps as k, type CheckoutMethods as l, type CheckoutOptions as m, type CheckoutProps as n, type CheckoutRequest as o, type CheckoutResult as p, CheckoutResume as q, CheckoutSpinner as r, type CheckoutStatus as s, type FailureRoute as t, type OpensAxis as u, type TriggerState as v, type UpsellButtonProps as w, type UpsellCommonProps as x, type UpsellRecovery as y, type UseCheckoutOptions as z };

package/dist/{chunk-PN7CRJAF.js → chunk-AW2YURFE.js}

@@ -491,10 +491,23 @@ function interpolate(str, params) {
   if (!params) return str;
   return str.replace(/\{\{(\w+)\}\}/g, (_, k) => k in params ? String(params[k]) : `{{${k}}}`);
 }
-function lookup(catalog, chain, key) {
+var baseLang = (locale) => locale.split("-")[0];
+function lookupMessage(catalog, chain, key) {
   for (const loc of chain) {
-    const v = catalog[loc]?.[key];
-    if (v !== void 0) return v;
+    const lang = baseLang(loc);
+    const exact = catalog[loc]?.[key];
+    if (exact !== void 0) return exact;
+    if (lang !== loc) {
+      const wide = catalog[lang]?.[key];
+      if (wide !== void 0) return wide;
+    }
+    const siblings = Object.keys(catalog).filter(
+      (k) => k !== loc && k !== lang && baseLang(k) === lang
+    );
+    if (siblings.length === 1) {
+      const only = catalog[siblings[0]]?.[key];
+      if (only !== void 0) return only;
+    }
   }
   return void 0;
 }
@@ -538,9 +551,11 @@ function useTranslation() {
   }, [locale, config]);
   const t = useMemo(() => {
     const fn = ((key, params) => {
-      const raw = lookup(catalog, chain, key);
+      const raw = lookupMessage(catalog, chain, key);
       if (raw === void 0) {
-        devWarn(`[appfunnel] missing translation: "${key}" (${locale})`);
+        devWarn(
+          `[appfunnel] missing translation: "${key}" (${locale}; tried ${chain.join(" \u2192 ")})`
+        );
         return key;
       }
       return interpolate(raw, params);
@@ -6978,6 +6993,10 @@ function Modal(props) {
 }
 
 // src/commerce/checkout.tsx
+function refuseOffering(offering, as) {
+  if (typeof offering === "string" && offering.trim() !== "") return void 0;
+  return `<${as}> has no \`offering\` \u2014 there is nothing to charge. Name the offering slot (offering="plan"). If you are migrating from an older SDK, the prop used to be \`product\`.`;
+}
 function refuseSurface(provider, surface, managed) {
   if (!managed) return void 0;
   const check = validateCheckout(provider, surface, { managed });
@@ -7158,20 +7177,31 @@ function useCheckout(opts = {}) {
       funnel.data.set({ purchased: true });
       const { productId, isSubscription } = productFacts(product);
       const amount = result.amountMinor != null ? result.amountMinor / 100 : void 0;
-      tracker.track("purchase.complete", {
-        amount,
-        currency: result.currency,
-        productId,
-        eventId: result.eventId
-        // server-minted (browser↔CAPI dedup); undefined if none
-      });
-      if (isSubscription) {
-        tracker.track("subscription.created", {
+      const isTrialStart = result.acquisition === "free_trial" || result.acquisition === "paid_trial";
+      if (isTrialStart) {
+        tracker.track("subscription.trial_started", {
           amount,
           currency: result.currency,
           productId,
           eventId: result.eventId
+          // server-minted (browser↔CAPI dedup)
         });
+      } else {
+        tracker.track("purchase.complete", {
+          amount,
+          currency: result.currency,
+          productId,
+          eventId: result.eventId
+          // server-minted (browser↔CAPI dedup); undefined if none
+        });
+        if (isSubscription) {
+          tracker.track("subscription.created", {
+            amount,
+            currency: result.currency,
+            productId,
+            eventId: result.eventId
+          });
+        }
       }
       opts.onSuccess?.(result);
       if (advance) nav.next();
@@ -7542,7 +7572,7 @@ function CheckoutImpl({
     notePreviewCheckout(as, product);
     checkout.callbacksFor(product, surface).onSuccess({ ok: true });
   };
-  const rejection = refuseSurface(driver.provider, surface, managed);
+  const rejection = refuseOffering(offering, as) ?? refuseSurface(driver.provider, surface, managed);
   const callbacksRef = useRef(checkout.callbacksFor);
   callbacksRef.current = checkout.callbacksFor;
   useEffect(() => {
@@ -7610,6 +7640,7 @@ function Checkout(props) {
     payment,
     className,
     appearance,
+    options: displayOptions,
     methods,
     classNames,
     ...options
@@ -7620,7 +7651,8 @@ function Checkout(props) {
     offering,
     className,
     appearance,
-    methods,
+    // `options` is the prop; `methods` is its old name, still accepted.
+    methods: displayOptions ?? methods,
     classNames,
     as: "Checkout",
     // The axes resolve, and the result is always an INLINE rendering: `<Checkout>` is the payment
@@ -7638,6 +7670,7 @@ function CheckoutButton(props) {
     children,
     className,
     appearance,
+    options: displayOptions,
     methods,
     classNames,
     ...options
@@ -7648,7 +7681,7 @@ function CheckoutButton(props) {
     offering,
     className,
     appearance,
-    methods,
+    methods: displayOptions ?? methods,
     classNames,
     asChild,
     children,
@@ -7697,6 +7730,14 @@ function UpsellButton(props) {
   );
   const checkout = useCheckout({ ...options, intent: "upsell", recoverySurface });
   const isSample = useOffering(offering)?.sample === true;
+  const rejection = refuseOffering(offering, "UpsellButton");
+  const callbacksRef = useRef(checkout.callbacksFor);
+  callbacksRef.current = checkout.callbacksFor;
+  useEffect(() => {
+    if (!rejection) return;
+    callbacksRef.current(product).onError(checkoutError("processing_error", rejection, { retryable: false }));
+  }, []);
+  if (rejection) return null;
   return trigger(
     () => {
       if (isSample) {
@@ -9494,5 +9535,5 @@ function useGroupProgress() {
 }
 
 export { Checkout, CheckoutButton, CheckoutResume, CheckoutSpinner, EmbedBridge, FunnelProvider, FunnelToaster, FunnelView, Modal, Sheet, UpsellButton, VariableStore, attachBus, buildAcquisition, buildContext, createBus, createConsoleTracker, createFunnelStore, createMockDriver, defineModal, dismissAllModals, driverWithEmail, ensureCheckoutButtonStyles, exposurePayload, hideModal, isValidEmail, newEventId, registerModal, removeModal, showModal, toast, unregisterModal, useActiveLocale, useCheckout, useClickIds, useContextValue, useData, useDevice, useExperiment, useField, useFunnel, useGroupProgress, useLocale, useMarketingConsent, useModal, useNavigation, useOffering, useOfferings, usePage, useResponse, useSystem, useTracker, useTranslation, useUserAttribute, useUtm, withBus };
-//# sourceMappingURL=chunk-PN7CRJAF.js.map
-//# sourceMappingURL=chunk-PN7CRJAF.js.map
+//# sourceMappingURL=chunk-AW2YURFE.js.map
+//# sourceMappingURL=chunk-AW2YURFE.js.map