@funnelsgrove/payments 0.11.2 → 0.11.3

package/README.md

@@ -108,11 +108,11 @@ Funnels should call `resolvePublishedBillingRuntime` once at their runtime-provi
 - Stripe owns real card fields and wallet controls. Local wallet buttons are placeholders until Stripe confirms availability.
 - Keep `planId` as the funnel plan key and send Stripe's price id only as `providerPlanId`; the API uses both fields to resolve the active test/live offer mapping.
 - Wallet unavailable state must fall back to card/manual checkout or disappear.
-- Count `checkout_started` only at shared UI boundaries: when a shared card dialog opens or when Stripe reports Apple Pay / Google Pay intent. Checkout Sessions use confirmation as a fallback because Stripe omits their click callback.
+- Count `checkout_started` only at shared UI boundaries: when a shared card dialog opens or when Stripe reports Apple Pay / Google Pay intent. Checkout Sessions use confirmation or cancellation as a fallback because Stripe omits their click callback. Cancellation recovers the start with `checkout_start_source: wallet_cancel`; its timestamp is dismissal time, not wallet-open time. Closing the browser before either callback is still unobservable. Cancel has no payment-method field, so the method is included only when the element enables exactly one method.
 - Pass `checkoutAnalytics` to every current shared dialog and wallet surface. The package then owns `checkout_started`, `add_payment_info`, and verified `checkout_completed`, all deduplicated by the actual Checkout Session.
 - Call funnel lifecycle `completeStep` only from the shared checkout `onSuccess` callback. Payment-info submission is not step completion.
 - Wallet slots may create render-only Checkout Sessions on mount so Apple Pay and Google Pay render before the visitor taps. Session creation is technical preparation and must never emit `checkout_started`.
-- Shared checkout analytics deduplicates `checkout_started` by Checkout Session id. Wallet confirmation may retry the start signal when the click callback is unavailable, without creating a duplicate.
+- Shared checkout analytics deduplicates `checkout_started` by Checkout Session id. Wallet confirmation and cancellation may retry the start signal when the click callback is unavailable, without creating a duplicate. Cancellation never emits payment-info or purchase completion events.
 - Do not call `publicAnalyticsSdk.trackCheckoutStarted`, `trackPaymentInfoSubmitted`, or `trackCheckoutCompleted` directly from funnel checkout components.
 - Funnel paywalls should style wallet buttons through the shared slot API: `className` for the Stripe button/placeholder, `slotClassName` for the outer slot, `appearance` for Stripe Elements appearance, and `options` for Stripe Express Checkout options.
 - Keep discount math reusable here, but keep offer activation timing in funnel code.

package/dist/providers/stripe/components/StripeCheckoutExpressCheckoutButton.js

@@ -95,16 +95,18 @@ export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAna
         }
         await (onSuccess === null || onSuccess === void 0 ? void 0 : onSuccess());
     };
-    const queueCheckoutStarted = (paymentMethod) => {
+    const queueCheckoutStarted = (paymentMethod, checkoutStartSource = 'wallet_click') => {
         if (!checkoutAnalytics) {
             return;
         }
-        queueStripeSubscriptionCheckoutStarted(Object.assign(Object.assign({}, checkoutAnalytics), { checkoutSessionId, checkoutStartSource: 'wallet_click', paymentMethod }));
+        queueStripeSubscriptionCheckoutStarted(Object.assign(Object.assign({}, checkoutAnalytics), { checkoutSessionId,
+            checkoutStartSource,
+            paymentMethod }));
     };
     const handleConfirm = async (event) => {
         var _a, _b, _c;
         // Checkout Sessions omits the Express Checkout onClick callback. Confirmation
-        // is therefore the first reliable wallet-intent boundary for this provider.
+        // and cancellation are the reliable wallet-intent boundaries for this provider.
         // Session-based analytics deduplication keeps this idempotent if onClick fires.
         queueCheckoutStarted(event.expressPaymentType);
         if (checkoutState.type !== 'success') {
@@ -176,13 +178,22 @@ export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAna
         queueCheckoutStarted(event.expressPaymentType);
         event.resolve();
     };
+    const handleCancel = () => {
+        var _a;
+        // Dismissal proves the wallet was opened, even when Stripe omitted onClick.
+        // Cancel has no method field; only single-method placements can identify it.
+        const enabledMethods = Object.entries((_a = resolvedOptions.paymentMethods) !== null && _a !== void 0 ? _a : {})
+            .filter(([, availability]) => availability !== 'never');
+        queueCheckoutStarted(enabledMethods.length === 1 ? enabledMethods[0][0] : undefined, 'wallet_cancel');
+        onCancel === null || onCancel === void 0 ? void 0 : onCancel();
+    };
     return (_jsxs(_Fragment, { children: [_jsx("div", { className: [
                     'stripe-express-checkout-button',
                     className !== null && className !== void 0 ? className : '',
                     effectiveWalletAvailable === false ? 'is-hidden' : '',
                 ]
                     .filter(Boolean)
-                    .join(' '), children: _jsx(ExpressCheckoutElementWithCancel, { options: resolvedOptions, onCancel: onCancel, onClick: handleClick, onConfirm: (event) => void handleConfirm(event), onLoadError: ({ error }) => {
+                    .join(' '), children: _jsx(ExpressCheckoutElementWithCancel, { options: resolvedOptions, onCancel: handleCancel, onClick: handleClick, onConfirm: (event) => void handleConfirm(event), onLoadError: ({ error }) => {
                         setWalletAvailable(false);
                         onAvailabilityChange === null || onAvailabilityChange === void 0 ? void 0 : onAvailabilityChange(false);
                         onError === null || onError === void 0 ? void 0 : onError(error.message || 'Unable to load wallet checkout.');

package/dist/providers/stripe/services/checkoutCompletionAnalytics.service.d.ts

@@ -12,7 +12,7 @@ export type StripeSubscriptionCheckoutAnalyticsContext = {
 };
 export type TrackStripeSubscriptionCheckoutStartedInput = StripeSubscriptionCheckoutAnalyticsContext & {
     checkoutSessionId?: string | null;
-    checkoutStartSource?: 'card_form_open' | 'wallet_click';
+    checkoutStartSource?: 'card_form_open' | 'wallet_click' | 'wallet_cancel';
     paymentMethod?: unknown;
 };
 export type TrackPaidStripeSubscriptionCheckoutCompletedInput = StripeSubscriptionCheckoutAnalyticsContext & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/payments",
-  "version": "0.11.2",
+  "version": "0.11.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/The-Solid-Grove/funnelsgrove.git",