@funnelsgrove/payments 0.11.15 → 0.11.17

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

@@ -319,7 +319,7 @@ function SharedStripeCheckoutV2CheckoutSessionForm({ amountCents, buttonColor, c
                             effectiveSelectedMethod === 'wallet' ? 'is-visible' : '',
                         ]
                             .filter(Boolean)
-                            .join(' '), children: [_jsxs("p", { className: 'shared-checkout-v2-secure-pill', children: [_jsx(SecurityLockIcon, { className: 'shared-checkout-v2-secure-pill-icon' }), secureLabel] }), _jsxs("div", { className: 'shared-checkout-v2-wallet-shell', "aria-label": walletAriaLabel, children: [_jsx(StripeCheckoutExpressCheckoutButton, { amountCents: amountCents, availabilityPaymentMethods: walletPaymentMethods, beforeConfirm: ensureCustomerEmail, checkoutAnalytics: checkoutAnalytics, checkoutSessionId: checkoutSessionId, className: 'shared-checkout-v2-express-buttons', confirmEmail: false, customerEmail: resolvedCustomerEmail, customerName: customerName, initialAvailable: initialWalletAvailable, keepInitialAvailableOnReady: initialWalletAvailable === true, onAvailabilityChange: handleWalletAvailabilityChange, onError: (message) => setSharedError(message, true), onPaymentInfoSubmitted: onPaymentInfoSubmitted, onSuccess: trackCheckoutSuccess, options: expressCheckoutOptions, returnUrl: returnUrl, summaryLabel: expressCheckoutSummaryLabel, supportedCountries: normalizedSupportedCountries, unsupportedCountryMessage: unsupportedCountryMessage }), _jsx("span", { className: 'shared-checkout-v2-sr-only', children: walletAriaLabel })] })] }), _jsxs("div", { hidden: effectiveSelectedMethod !== 'card', className: [
+                            .join(' '), children: [_jsxs("p", { className: 'shared-checkout-v2-secure-pill', children: [_jsx(SecurityLockIcon, { className: 'shared-checkout-v2-secure-pill-icon' }), secureLabel] }), _jsxs("div", { className: 'shared-checkout-v2-wallet-shell', "aria-label": walletAriaLabel, children: [_jsx(StripeCheckoutExpressCheckoutButton, { amountCents: amountCents, availabilityPaymentMethods: walletPaymentMethods, beforeConfirm: ensureCustomerEmail, checkoutAnalytics: checkoutAnalytics, checkoutSessionId: checkoutSessionId, className: 'shared-checkout-v2-express-buttons', confirmEmail: false, customerEmail: resolvedCustomerEmail, customerName: customerName, initialAvailable: initialWalletAvailable, keepInitialAvailableOnReady: initialWalletAvailable === true, onAvailabilityChange: handleWalletAvailabilityChange, onError: (message) => setSharedError(message, true), onPaymentInfoSubmitted: onPaymentInfoSubmitted, onPaymentRejected: () => setSelectedMethod('card'), onSuccess: trackCheckoutSuccess, options: expressCheckoutOptions, returnUrl: returnUrl, summaryLabel: expressCheckoutSummaryLabel, supportedCountries: normalizedSupportedCountries, unsupportedCountryMessage: unsupportedCountryMessage }), _jsx("span", { className: 'shared-checkout-v2-sr-only', children: walletAriaLabel })] })] }), _jsxs("div", { hidden: effectiveSelectedMethod !== 'card', className: [
                             'shared-checkout-v2-card-panel',
                             effectiveSelectedMethod === 'card' ? 'is-visible' : '',
                         ]

package/dist/providers/stripe/components/StripeCheckoutExpressCheckoutButton.d.ts

@@ -22,7 +22,12 @@ export type StripeCheckoutExpressCheckoutButtonProps = {
     onCancel?: () => void;
     onError?: (message: string | null) => void;
     onPaymentInfoSubmitted?: () => void | Promise<void>;
+    onPaymentRejected?: (input: {
+        declineCode?: string;
+        message: string;
+        paymentMethod?: string;
+    }) => void;
     onSuccess?: () => void | Promise<void>;
     unsupportedCountryMessage?: string;
 };
-export declare function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAnalytics, checkoutSessionId, returnUrl, confirmEmail, customerEmail, className, options, availabilityPaymentMethods, initialAvailable, keepInitialAvailableOnReady, serverUpdateKey, supportedCountries, onServerUpdate, onAvailabilityChange, onCancel, onError, onPaymentInfoSubmitted, onSuccess, unsupportedCountryMessage, }: StripeCheckoutExpressCheckoutButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAnalytics, checkoutSessionId, returnUrl, confirmEmail, customerEmail, className, options, availabilityPaymentMethods, initialAvailable, keepInitialAvailableOnReady, serverUpdateKey, supportedCountries, onServerUpdate, onAvailabilityChange, onCancel, onError, onPaymentInfoSubmitted, onPaymentRejected, onSuccess, unsupportedCountryMessage, }: StripeCheckoutExpressCheckoutButtonProps): import("react/jsx-runtime").JSX.Element;

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

@@ -4,7 +4,8 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { ExpressCheckoutElement, useCheckout, } from '@stripe/react-stripe-js/checkout';
 import { queueStripeSubscriptionCheckoutStarted, trackPaidStripeSubscriptionCheckoutCompleted, trackStripeSubscriptionPaymentInfoSubmitted, } from '../services/checkoutCompletionAnalytics.service.js';
 import { getUnsupportedCheckoutCountryMessage, normalizeSupportedCheckoutCountries, } from './checkoutCountries.js';
-import { trackCheckoutCanceled, trackCheckoutFailureShown, } from '../../../services/checkoutObservability.service.js';
+import { classifyCheckoutFailure, trackCheckoutCanceled, trackCheckoutFailureShown, } from '../../../services/checkoutObservability.service.js';
+import { toAnalyticsPaymentMethod } from '../../../services/paymentMethodAnalytics.service.js';
 const ExpressCheckoutElementWithCancel = ExpressCheckoutElement;
 const buildDefaultOptions = () => ({
     buttonHeight: 55,
@@ -29,7 +30,28 @@ const buildDefaultOptions = () => ({
         paypal: 'never',
     },
 });
-export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAnalytics, checkoutSessionId, returnUrl, confirmEmail = true, customerEmail, className, options, availabilityPaymentMethods = ['applePay'], initialAvailable, keepInitialAvailableOnReady = false, serverUpdateKey, supportedCountries, onServerUpdate, onAvailabilityChange, onCancel, onError, onPaymentInfoSubmitted, onSuccess, unsupportedCountryMessage, }) {
+const normalizeStripeCheckoutProviderError = (error) => {
+    if (!error || typeof error !== 'object') {
+        return {};
+    }
+    const record = error;
+    const paymentFailed = record.paymentFailed && typeof record.paymentFailed === 'object'
+        ? record.paymentFailed
+        : null;
+    return {
+        code: typeof record.code === 'string' ? record.code : undefined,
+        decline_code: typeof record.decline_code === 'string' ? record.decline_code : undefined,
+        paymentFailed: paymentFailed
+            ? {
+                declineCode: typeof paymentFailed.declineCode === 'string'
+                    ? paymentFailed.declineCode
+                    : undefined,
+            }
+            : undefined,
+        type: typeof record.type === 'string' ? record.type : undefined,
+    };
+};
+export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAnalytics, checkoutSessionId, returnUrl, confirmEmail = true, customerEmail, className, options, availabilityPaymentMethods = ['applePay'], initialAvailable, keepInitialAvailableOnReady = false, serverUpdateKey, supportedCountries, onServerUpdate, onAvailabilityChange, onCancel, onError, onPaymentInfoSubmitted, onPaymentRejected, onSuccess, unsupportedCountryMessage, }) {
     const checkoutState = useCheckout();
     const appliedServerUpdateKeyRef = useRef('');
     const [appliedServerUpdateKey, setAppliedServerUpdateKey] = useState('');
@@ -143,6 +165,7 @@ export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAna
             paymentMethod }));
     };
     const reportFailure = (message, failureStage, paymentMethod, providerError) => {
+        var _a, _b;
         if (checkoutAnalytics) {
             trackCheckoutFailureShown({
                 analytics: checkoutAnalytics,
@@ -151,7 +174,7 @@ export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAna
                 failureStage,
                 paymentMethod,
                 provider: 'stripe',
-                providerDeclineCode: providerError === null || providerError === void 0 ? void 0 : providerError.decline_code,
+                providerDeclineCode: (_a = providerError === null || providerError === void 0 ? void 0 : providerError.decline_code) !== null && _a !== void 0 ? _a : (_b = providerError === null || providerError === void 0 ? void 0 : providerError.paymentFailed) === null || _b === void 0 ? void 0 : _b.declineCode,
                 providerErrorCode: providerError === null || providerError === void 0 ? void 0 : providerError.code,
                 providerErrorType: providerError === null || providerError === void 0 ? void 0 : providerError.type,
             });
@@ -159,7 +182,7 @@ export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAna
         onError === null || onError === void 0 ? void 0 : onError(message);
     };
     const handleConfirm = async (event) => {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e, _f;
         // Checkout Sessions omits the Express Checkout onClick callback. Confirmation
         // and cancellation are the reliable wallet-intent boundaries for this provider.
         // Session-based analytics deduplication keeps this idempotent if onClick fires.
@@ -227,7 +250,22 @@ export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAna
             : {})), { expressCheckoutConfirmEvent: event, redirect: 'if_required' }));
         if (result.type === 'error') {
             const message = result.error.message || 'Wallet checkout failed.';
-            reportFailure(message, 'wallet_confirmation', event.expressPaymentType, result.error);
+            const providerError = normalizeStripeCheckoutProviderError(result.error);
+            reportFailure(message, 'wallet_confirmation', event.expressPaymentType, providerError);
+            const declineCode = (_f = (_d = providerError.decline_code) !== null && _d !== void 0 ? _d : (_e = providerError.paymentFailed) === null || _e === void 0 ? void 0 : _e.declineCode) !== null && _f !== void 0 ? _f : undefined;
+            if (classifyCheckoutFailure({
+                errorMessage: message,
+                provider: 'stripe',
+                providerDeclineCode: declineCode,
+                providerErrorCode: providerError.code,
+                providerErrorType: providerError.type,
+            }) === 'payment_rejection') {
+                onPaymentRejected === null || onPaymentRejected === void 0 ? void 0 : onPaymentRejected({
+                    declineCode,
+                    message,
+                    paymentMethod: toAnalyticsPaymentMethod(event.expressPaymentType) || undefined,
+                });
+            }
             event.paymentFailed({ reason: 'fail', message });
             return;
         }

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

@@ -5,6 +5,7 @@ import { StripeExpressCheckoutElement } from './StripeExpressCheckoutElement.js'
 import { trackStripeSubscriptionCheckoutStarted, } from '../services/checkoutCompletionAnalytics.service.js';
 import { toAnalyticsPaymentMethod } from '../../../services/paymentMethodAnalytics.service.js';
 import { isInactiveCheckoutSessionError, } from '../hooks/useStripeSubscriptionCheckoutSession.js';
+import { trackCheckoutWalletReady } from '../../../services/checkoutObservability.service.js';
 export function getWalletSubscriptionCheckoutRenderState({ expressCheckoutAllowed, hasActiveClientSecret, hasStripePromise, suspended, walletAvailable, walletPreparing, }) {
     const shouldRenderExpressCheckout = !suspended &&
         expressCheckoutAllowed &&
@@ -42,6 +43,23 @@ export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availa
     const [walletCheckoutStartedAfterClickIntentKey, setWalletCheckoutStartedAfterClickIntentKey] = useState(null);
     const autoWalletPreparationIntentKeyRef = useRef(null);
     const walletCheckoutStartedAfterClickSessionIdRef = useRef(null);
+    const walletReadinessCycleRef = useRef(null);
+    if (!walletReadinessCycleRef.current
+        || walletReadinessCycleRef.current.intentKey !== session.intentKey) {
+        walletReadinessCycleRef.current = {
+            clientSecretReceivedAtMs: null,
+            intentKey: session.intentKey,
+            mountedAtMs: null,
+            reportedCheckoutSessionId: null,
+            requestStartedAtMs: null,
+        };
+    }
+    useEffect(() => {
+        const cycle = walletReadinessCycleRef.current;
+        if ((cycle === null || cycle === void 0 ? void 0 : cycle.intentKey) === session.intentKey && cycle.mountedAtMs === null) {
+            cycle.mountedAtMs = performance.now();
+        }
+    }, [session.intentKey]);
     const slotDisabled = disabled || !session.configured;
     const analyticsPaymentMethod = toAnalyticsPaymentMethod(availabilityPaymentMethod);
     const walletAvailable = walletAvailability.intentKey === session.intentKey
@@ -76,6 +94,25 @@ export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availa
                 intentKey,
             });
     }, []);
+    const startWalletPreparationTiming = useCallback((intentKey) => {
+        var _a;
+        const cycle = walletReadinessCycleRef.current;
+        if (!cycle || cycle.intentKey !== intentKey) {
+            return;
+        }
+        const requestStartedAtMs = performance.now();
+        (_a = cycle.mountedAtMs) !== null && _a !== void 0 ? _a : (cycle.mountedAtMs = requestStartedAtMs);
+        cycle.requestStartedAtMs = requestStartedAtMs;
+        cycle.clientSecretReceivedAtMs = null;
+        cycle.reportedCheckoutSessionId = null;
+    }, []);
+    const finishWalletPreparationTiming = useCallback((intentKey, readyClientSecret) => {
+        const cycle = walletReadinessCycleRef.current;
+        if (!readyClientSecret || !cycle || cycle.intentKey !== intentKey) {
+            return;
+        }
+        cycle.clientSecretReceivedAtMs = performance.now();
+    }, []);
     const autoWalletClientSecret = session.activeClientSecret;
     const autoWalletIntentKey = session.intentKey;
     const autoWalletLoading = session.loading.wallet;
@@ -93,11 +130,13 @@ export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availa
             return;
         }
         autoWalletPreparationIntentKeyRef.current = autoWalletIntentKey;
+        startWalletPreparationTiming(autoWalletIntentKey);
         void prepareWalletCheckout({
             checkoutStartSource: 'wallet_render',
             paymentMethod: analyticsPaymentMethod,
         })
             .then((readyClientSecret) => {
+            finishWalletPreparationTiming(autoWalletIntentKey, readyClientSecret);
             if (!readyClientSecret) {
                 reportWalletPreparationFailure(autoWalletIntentKey);
             }
@@ -108,9 +147,11 @@ export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availa
         autoWalletIntentKey,
         autoWalletLoading,
         expressCheckoutAllowed,
+        finishWalletPreparationTiming,
         prepareWalletCheckout,
         reportWalletPreparationFailure,
         slotDisabled,
+        startWalletPreparationTiming,
         suspended,
         walletAvailable,
     ]);
@@ -149,7 +190,33 @@ export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availa
         onError === null || onError === void 0 ? void 0 : onError(message);
     };
     const handleAvailabilityChange = (available) => {
+        var _a;
         reportWalletAvailability(session.intentKey, available);
+        const cycle = walletReadinessCycleRef.current;
+        const checkoutSessionId = ((_a = session.checkoutSessionId) === null || _a === void 0 ? void 0 : _a.trim()) || '';
+        if (!available
+            || !checkoutAnalytics
+            || !checkoutSessionId
+            || !cycle
+            || cycle.intentKey !== session.intentKey
+            || cycle.mountedAtMs === null
+            || cycle.requestStartedAtMs === null
+            || cycle.clientSecretReceivedAtMs === null
+            || cycle.reportedCheckoutSessionId === checkoutSessionId) {
+            return;
+        }
+        const readyAtMs = performance.now();
+        cycle.reportedCheckoutSessionId = checkoutSessionId;
+        trackCheckoutWalletReady({
+            analytics: checkoutAnalytics,
+            checkoutSessionId,
+            paymentMethod: availabilityPaymentMethod,
+            provider: 'stripe',
+            walletClientSecretToReadyMs: Math.max(0, readyAtMs - cycle.clientSecretReceivedAtMs),
+            walletMountToReadyMs: Math.max(0, readyAtMs - cycle.mountedAtMs),
+            walletMountToRequestMs: Math.max(0, cycle.requestStartedAtMs - cycle.mountedAtMs),
+            walletRequestMs: Math.max(0, cycle.clientSecretReceivedAtMs - cycle.requestStartedAtMs),
+        });
     };
     const handlePlaceholderClick = async () => {
         if (slotDisabled || session.loading.wallet) {
@@ -160,10 +227,12 @@ export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availa
             return;
         }
         setWalletCheckoutStartedAfterClickIntentKey(session.intentKey);
+        startWalletPreparationTiming(session.intentKey);
         const readyClientSecret = await session.prepareWalletCheckout({
             checkoutStartSource: 'wallet_click',
             paymentMethod: analyticsPaymentMethod,
         });
+        finishWalletPreparationTiming(session.intentKey, readyClientSecret);
         if (!readyClientSecret) {
             setWalletCheckoutStartedAfterClickIntentKey(null);
             reportWalletPreparationFailure(session.intentKey);

package/dist/providers/stripe/hooks/checkoutAttempt.d.ts

@@ -1,11 +1,14 @@
 export type StripeCheckoutAttempt = {
     key: string;
     id: string;
+    createdAtMs: number;
 };
+export declare const STRIPE_CHECKOUT_ATTEMPT_RETRY_WINDOW_MS: number;
 export declare const resolveStripeCheckoutAttempt: (input: {
     current: StripeCheckoutAttempt | null;
     forceNew: boolean;
     intentKey: string;
     paymentsApiVersion?: "v1" | "v2" | null;
     createId: () => string;
+    nowMs?: number;
 }) => StripeCheckoutAttempt | null;

package/dist/providers/stripe/hooks/checkoutAttempt.js

@@ -1,10 +1,14 @@
+export const STRIPE_CHECKOUT_ATTEMPT_RETRY_WINDOW_MS = 20 * 60 * 1000;
 export const resolveStripeCheckoutAttempt = (input) => {
-    var _a;
+    var _a, _b;
     if (input.paymentsApiVersion !== 'v2') {
         return null;
     }
-    if (!input.forceNew && ((_a = input.current) === null || _a === void 0 ? void 0 : _a.key) === input.intentKey) {
+    const nowMs = (_a = input.nowMs) !== null && _a !== void 0 ? _a : Date.now();
+    if (!input.forceNew
+        && ((_b = input.current) === null || _b === void 0 ? void 0 : _b.key) === input.intentKey
+        && nowMs - input.current.createdAtMs <= STRIPE_CHECKOUT_ATTEMPT_RETRY_WINDOW_MS) {
         return input.current;
     }
-    return { key: input.intentKey, id: input.createId() };
+    return { key: input.intentKey, id: input.createId(), createdAtMs: nowMs };
 };

package/dist/providers/stripe/hooks/checkoutIdentity.d.ts

@@ -0,0 +1,7 @@
+import { type CheckoutIdentityStatus } from '@funnelsgrove/runtime';
+export declare const isStripeCheckoutIdentityReady: (input: {
+    runtimeConfig?: {
+        paymentsApiVersion?: "v1" | "v2" | null;
+    } | null;
+    userId?: string | null;
+}, getIdentityStatus?: (userId: string | null | undefined) => CheckoutIdentityStatus) => boolean;

package/dist/providers/stripe/hooks/checkoutIdentity.js

@@ -0,0 +1,6 @@
+import { getCheckoutIdentityStatus, } from '@funnelsgrove/runtime';
+export const isStripeCheckoutIdentityReady = (input, getIdentityStatus = getCheckoutIdentityStatus) => {
+    var _a;
+    return ((_a = input.runtimeConfig) === null || _a === void 0 ? void 0 : _a.paymentsApiVersion) !== 'v2'
+        || getIdentityStatus(input.userId) !== 'pending';
+};

package/dist/providers/stripe/hooks/useStripeOneTimeCheckoutSession.d.ts

@@ -2,6 +2,7 @@ import type { Stripe } from '@stripe/stripe-js';
 import type { RuntimeMode } from '@funnelsgrove/runtime';
 import { type CheckoutPreparationLoading, type CheckoutPreparationSource } from '../../paymentProvider.types.js';
 import { type PaywallPlan, type StripeRuntimeConfigOverrides } from '../services/stripe.service.js';
+export { isStripeCheckoutIdentityReady as isStripeOneTimeCheckoutIdentityReady, } from './checkoutIdentity.js';
 type StripeOneTimeCheckoutPlanInput = Pick<PaywallPlan, 'amountCents' | 'analyticsPurchaseValue' | 'description' | 'id' | 'providerPlanId' | 'title' | 'funnelPlanKey' | 'offerSetId' | 'offerSetKey'>;
 export type StripeOneTimeCheckoutSessionInput = {
     runtimeConfigRevisionId?: string | null;
@@ -49,4 +50,3 @@ export type StripeOneTimeCheckoutIntentKeyInput = Pick<StripeOneTimeCheckoutSess
 export declare function buildStripeOneTimeCheckoutIntentKey({ runtimeConfigRevisionId, paymentProfileId, provider, checkoutMode, couponId, customerEmail, plan, returnUrl, runtimeConfig, stripePublishableKey, userId, }: StripeOneTimeCheckoutIntentKeyInput): string;
 export declare function shouldResetStripeOneTimeCheckoutSessionForIntentKey(previousIntentKey: string | null, nextIntentKey: string): boolean;
 export declare function useStripeOneTimeCheckoutSession({ runtimeConfigRevisionId, paymentProfileId, provider, analyticsMetadata, checkoutMode, couponId, customerEmail, enabled, onError, plan, returnUrl, runtimeConfig, stripePublishableKey, userId, }: StripeOneTimeCheckoutSessionInput): StripeOneTimeCheckoutSession;
-export {};

package/dist/providers/stripe/hooks/useStripeOneTimeCheckoutSession.js

@@ -16,6 +16,8 @@ import { createStripeOneTimeCheckout, getStripePromise, isStripeConfigured, } fr
 import { isInactiveCheckoutSessionError } from './useStripeSubscriptionCheckoutSession.js';
 import { toAnalyticsPaymentMethod } from '../../../services/paymentMethodAnalytics.service.js';
 import { resolveStripeCheckoutAttempt, } from './checkoutAttempt.js';
+import { isStripeCheckoutIdentityReady } from './checkoutIdentity.js';
+export { isStripeCheckoutIdentityReady as isStripeOneTimeCheckoutIdentityReady, } from './checkoutIdentity.js';
 export function resolveStripeOneTimeCheckoutPreparationOptions(source, options = {}) {
     var _a, _b;
     const checkoutStartSource = (_a = options.checkoutStartSource) !== null && _a !== void 0 ? _a : (source === 'wallet' ? 'wallet_render' : 'card_click');
@@ -85,7 +87,12 @@ export function useStripeOneTimeCheckoutSession({ runtimeConfigRevisionId, payme
     const requestIdRef = useRef(0);
     const attemptRef = useRef(null);
     const anonymousUserIdRef = useRef(null);
+    const checkoutIdentityReady = isStripeCheckoutIdentityReady({
+        runtimeConfig,
+        userId,
+    });
     const configured = enabled &&
+        checkoutIdentityReady &&
         (isStripeConfigured(checkoutMode) ||
             Boolean(normalizeRuntimeConfigValue(runtimeConfig === null || runtimeConfig === void 0 ? void 0 : runtimeConfig.funnelSdkPublishableKey)) ||
             Boolean(normalizeRuntimeConfigValue(stripePublishableKey)));

package/dist/providers/stripe/hooks/useStripeSubscriptionCheckoutSession.d.ts

@@ -4,6 +4,7 @@ import { type CheckoutPreparationLoading, type CheckoutPreparationSource } from
 import type { PaywallDisplayPlan } from '../../../services/paywallOffer.service.js';
 import { type PaywallPlan, type StripeRuntimeConfigOverrides } from '../services/stripe.service.js';
 import { type CheckoutObservabilityAnalyticsContext } from '../../../services/checkoutObservability.service.js';
+export { isStripeCheckoutIdentityReady as isStripeSubscriptionCheckoutIdentityReady, } from './checkoutIdentity.js';
 export type StripeSubscriptionCheckoutSessionInput = {
     analyticsMetadata?: Record<string, unknown> | null;
     checkoutAnalytics?: CheckoutObservabilityAnalyticsContext | null;
@@ -55,5 +56,6 @@ export type StripeSubscriptionCheckoutIntentKeyInput = Pick<StripeSubscriptionCh
 export declare function buildStripeSubscriptionCheckoutIntentKey({ checkoutMode, couponId, customerEmail, returnUrl, runtimeConfig, runtimeConfigRevisionId, paymentProfileId, planKey, provider, stripePublishableKey, userId, }: StripeSubscriptionCheckoutIntentKeyInput): string;
 export declare function shouldResetStripeSubscriptionCheckoutSessionForIntentKey(previousIntentKey: string | null, nextIntentKey: string): boolean;
 export declare function isInactiveCheckoutSessionError(message?: string | null): boolean;
+export declare function shouldAutoRecoverStripeSubscriptionCheckoutSession(message: string | null | undefined, alreadyRecovered: boolean): boolean;
 export declare const shouldReportStripeCheckoutFailureShown: (message: string) => boolean;
 export declare function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMetadata, checkoutAnalytics, couponId, customerEmail, displayPlan, enabled, onError, plan, returnUrl, runtimeConfig, runtimeConfigRevisionId, paymentProfileId, provider, stripePublishableKey, userId, }: StripeSubscriptionCheckoutSessionInput): StripeSubscriptionCheckoutSession;

package/dist/providers/stripe/hooks/useStripeSubscriptionCheckoutSession.js

@@ -16,6 +16,8 @@ import { createStripeSubscriptionCheckout, getStripePromise, isStripeConfigured,
 import { toAnalyticsPaymentMethod } from '../../../services/paymentMethodAnalytics.service.js';
 import { resolveCheckoutObservabilityAnalyticsContext, trackCheckoutFailureShown, } from '../../../services/checkoutObservability.service.js';
 import { resolveStripeCheckoutAttempt, } from './checkoutAttempt.js';
+import { isStripeCheckoutIdentityReady } from './checkoutIdentity.js';
+export { isStripeCheckoutIdentityReady as isStripeSubscriptionCheckoutIdentityReady, } from './checkoutIdentity.js';
 export function resolveStripeSubscriptionCheckoutPreparationOptions(source, options = {}) {
     var _a, _b;
     const checkoutStartSource = (_a = options.checkoutStartSource) !== null && _a !== void 0 ? _a : (source === 'wallet' ? 'wallet_render' : 'card_click');
@@ -70,6 +72,9 @@ export function isInactiveCheckoutSessionError(message) {
     var _a;
     return /\bcheckout session\b.*\bno longer active\b/i.test((_a = message === null || message === void 0 ? void 0 : message.trim()) !== null && _a !== void 0 ? _a : '');
 }
+export function shouldAutoRecoverStripeSubscriptionCheckoutSession(message, alreadyRecovered) {
+    return !alreadyRecovered && isInactiveCheckoutSessionError(message);
+}
 export const shouldReportStripeCheckoutFailureShown = (message) => !isInactiveCheckoutSessionError(message);
 export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMetadata, checkoutAnalytics, couponId, customerEmail, displayPlan, enabled = true, onError, plan, returnUrl, runtimeConfig, runtimeConfigRevisionId, paymentProfileId, provider, stripePublishableKey, userId, }) {
     var _a, _b, _c, _d, _e;
@@ -78,13 +83,21 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
     const [checkoutSessionId, setCheckoutSessionId] = useState(null);
     const [clientSecretPlanKey, setClientSecretPlanKey] = useState(null);
     const [error, setErrorState] = useState(null);
+    const [recoveryRequest, setRecoveryRequest] = useState(0);
     const [loading, setLoading] = useState(createEmptyCheckoutPreparationLoading);
     const [runtimeStripePublishableKey, setRuntimeStripePublishableKey] = useState(null);
     const creatingIntentRef = useRef(null);
     const requestIdRef = useRef(0);
     const attemptRef = useRef(null);
+    const recoveredIntentKeyRef = useRef(null);
+    const handledRecoveryRequestRef = useRef(0);
     const anonymousUserIdRef = useRef(null);
+    const checkoutIdentityReady = isStripeCheckoutIdentityReady({
+        runtimeConfig,
+        userId,
+    });
     const configured = enabled &&
+        checkoutIdentityReady &&
         (isStripeConfigured(checkoutMode) ||
             Boolean(normalizeRuntimeConfigValue(runtimeConfig === null || runtimeConfig === void 0 ? void 0 : runtimeConfig.funnelSdkPublishableKey)) ||
             Boolean(normalizeRuntimeConfigValue(stripePublishableKey)));
@@ -127,21 +140,32 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
     }, []);
     const setError = useCallback((message) => {
         if (isInactiveCheckoutSessionError(message)) {
-            clearActiveCheckoutSession();
-            setErrorState(null);
-            onError === null || onError === void 0 ? void 0 : onError(null);
+            const alreadyRecovered = recoveredIntentKeyRef.current === intentKey;
+            if (shouldAutoRecoverStripeSubscriptionCheckoutSession(message, alreadyRecovered)) {
+                clearActiveCheckoutSession();
+                setErrorState(null);
+                onError === null || onError === void 0 ? void 0 : onError(null);
+                recoveredIntentKeyRef.current = intentKey;
+                setRecoveryRequest((current) => current + 1);
+            }
+            else {
+                setErrorState(message);
+                onError === null || onError === void 0 ? void 0 : onError(message);
+            }
             return;
         }
         setErrorState(message);
         onError === null || onError === void 0 ? void 0 : onError(message);
-    }, [clearActiveCheckoutSession, onError]);
+    }, [clearActiveCheckoutSession, intentKey, onError]);
     const reset = useCallback(() => {
         attemptRef.current = null;
+        recoveredIntentKeyRef.current = null;
+        handledRecoveryRequestRef.current = recoveryRequest;
         clearActiveCheckoutSession();
         setLoading(createEmptyCheckoutPreparationLoading());
         setRuntimeStripePublishableKey(null);
         setError(null);
-    }, [clearActiveCheckoutSession, setError]);
+    }, [clearActiveCheckoutSession, recoveryRequest, setError]);
     useIsomorphicLayoutEffect(() => {
         const previousIntentKey = previousIntentKeyRef.current;
         previousIntentKeyRef.current = intentKey;
@@ -304,6 +328,16 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
     const prepareWalletCheckout = useCallback((options = {}) => prepareCheckout('wallet', options), [prepareCheckout]);
     const restartCardCheckout = useCallback((options = {}) => prepareCheckout('card', Object.assign(Object.assign({}, options), { forceNew: true })), [prepareCheckout]);
     const restartWalletCheckout = useCallback((options = {}) => prepareCheckout('wallet', Object.assign(Object.assign({}, options), { forceNew: true })), [prepareCheckout]);
+    useEffect(() => {
+        if (recoveryRequest === 0
+            || handledRecoveryRequestRef.current === recoveryRequest) {
+            return;
+        }
+        handledRecoveryRequestRef.current = recoveryRequest;
+        void restartCardCheckout({
+            checkoutStartSource: 'checkout_render',
+        });
+    }, [recoveryRequest, restartCardCheckout]);
     const updateCheckoutSessionPlan = useCallback(async () => {
         if (!configured || !plan || !displayPlan || !activeCheckoutSessionId) {
             return false;

package/dist/providers/stripe/services/checkout/requests.d.ts

@@ -1,5 +1,8 @@
 import type { CreateOneTimeCheckoutInput, CreateSubscriptionCheckoutInput, UpdateSubscriptionCheckoutPlanInput, VerifySubscriptionCheckoutPaymentInput } from './types.js';
 export declare const toOneTimeCheckoutRequest: (input: CreateOneTimeCheckoutInput) => {
+    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
+    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+    checkoutIdentityToken: string;
     planKey: string;
     runtimeConfigRevisionId: string | null | undefined;
     paymentProfileId: string | null | undefined;
@@ -18,10 +21,33 @@ export declare const toOneTimeCheckoutRequest: (input: CreateOneTimeCheckoutInpu
     customerEmail: string | undefined;
     returnUrl: string;
     userId: string | undefined;
+} | {
     environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
     runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+    checkoutIdentityToken?: undefined;
+    planKey: string;
+    runtimeConfigRevisionId: string | null | undefined;
+    paymentProfileId: string | null | undefined;
+    provider: "stripe" | null | undefined;
+    anonymousUserId: string | null | undefined;
+    idempotencyKey: string | null | undefined;
+    offerSetId: string | undefined;
+    offerSetKey: string | undefined;
+    planId: string;
+    providerPlanId: string | undefined;
+    title: string;
+    description: string | undefined;
+    amountCents: number;
+    couponId: string | undefined;
+    analyticsMetadata: Record<string, unknown> | undefined;
+    customerEmail: string | undefined;
+    returnUrl: string;
+    userId: string | undefined;
 };
 export declare const toSubscriptionCheckoutRequest: (input: CreateSubscriptionCheckoutInput) => {
+    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
+    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+    checkoutIdentityToken: string;
     offerSetId: string | undefined;
     offerSetKey: string | undefined;
     planId: string;
@@ -47,8 +73,35 @@ export declare const toSubscriptionCheckoutRequest: (input: CreateSubscriptionCh
     customerEmail: string | undefined;
     returnUrl: string;
     userId: string | undefined;
+} | {
     environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
     runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+    checkoutIdentityToken?: undefined;
+    offerSetId: string | undefined;
+    offerSetKey: string | undefined;
+    planId: string;
+    planKey: string;
+    providerPlanId: string | undefined;
+    provider: "stripe" | null | undefined;
+    paymentProfileId: string | undefined;
+    runtimeConfigRevisionId: string | undefined;
+    anonymousUserId: string | undefined;
+    idempotencyKey: string | undefined;
+    title: string;
+    description: string | undefined;
+    amountCents: number;
+    billingInterval: import("../../../../index.js").BillingPlanInterval;
+    billingIntervalCount: number;
+    followUpProviderPlanId: string | undefined;
+    followUpPlanTitle: string | undefined;
+    followUpBillingInterval: import("../../../../index.js").BillingPlanInterval | undefined;
+    followUpBillingIntervalCount: number | undefined;
+    introIterations: number | undefined;
+    couponId: string | undefined;
+    analyticsMetadata: Record<string, unknown> | undefined;
+    customerEmail: string | undefined;
+    returnUrl: string;
+    userId: string | undefined;
 };
 export declare const toSubscriptionCheckoutPlanRequest: (input: UpdateSubscriptionCheckoutPlanInput) => {
     checkoutSessionId: string;

package/dist/providers/stripe/services/checkout/requests.js

@@ -1,63 +1,20 @@
 import { getPaywallPlanRequestId } from '../../../../services/paywallPlans/selection.js';
 import { normalizeCheckoutAnalyticsMetadata } from '../shared/checkoutMetadata.js';
 import { requireCheckoutRecurringConfig, requireCheckoutSessionId, } from '../shared/checkout.validator.js';
+import { getCheckoutIdentityToken } from '@funnelsgrove/runtime';
+const toCheckoutIdentityRequestFields = (userId) => {
+    const canonicalUserId = userId === null || userId === void 0 ? void 0 : userId.trim();
+    const checkoutIdentityToken = getCheckoutIdentityToken(canonicalUserId);
+    return checkoutIdentityToken ? { checkoutIdentityToken } : {};
+};
 export const toOneTimeCheckoutRequest = (input) => {
     var _a, _b, _c, _d, _e, _f, _g, _h;
-    return {
-        planKey: ((_a = input.plan.funnelPlanKey) === null || _a === void 0 ? void 0 : _a.trim()) || input.plan.id,
-        runtimeConfigRevisionId: input.runtimeConfigRevisionId,
-        paymentProfileId: input.paymentProfileId,
-        provider: input.provider,
-        anonymousUserId: input.anonymousUserId,
-        idempotencyKey: input.idempotencyKey,
-        offerSetId: ((_b = input.plan.offerSetId) === null || _b === void 0 ? void 0 : _b.trim()) || undefined,
-        offerSetKey: ((_c = input.plan.offerSetKey) === null || _c === void 0 ? void 0 : _c.trim()) || undefined,
-        planId: getPaywallPlanRequestId(input.plan),
-        providerPlanId: ((_d = input.plan.providerPlanId) === null || _d === void 0 ? void 0 : _d.trim()) || undefined,
-        title: input.plan.title,
-        description: ((_e = input.plan.description) === null || _e === void 0 ? void 0 : _e.trim()) || undefined,
-        amountCents: input.plan.amountCents,
-        couponId: ((_f = input.couponId) === null || _f === void 0 ? void 0 : _f.trim()) || undefined,
-        analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan),
-        customerEmail: ((_g = input.customerEmail) === null || _g === void 0 ? void 0 : _g.trim()) || undefined,
-        returnUrl: input.returnUrl,
-        userId: ((_h = input.user_id) === null || _h === void 0 ? void 0 : _h.trim()) || undefined,
-        environment: input.environment,
-        runtimeConfig: input.runtimeConfig,
-    };
+    return Object.assign(Object.assign({ planKey: ((_a = input.plan.funnelPlanKey) === null || _a === void 0 ? void 0 : _a.trim()) || input.plan.id, runtimeConfigRevisionId: input.runtimeConfigRevisionId, paymentProfileId: input.paymentProfileId, provider: input.provider, anonymousUserId: input.anonymousUserId, idempotencyKey: input.idempotencyKey, offerSetId: ((_b = input.plan.offerSetId) === null || _b === void 0 ? void 0 : _b.trim()) || undefined, offerSetKey: ((_c = input.plan.offerSetKey) === null || _c === void 0 ? void 0 : _c.trim()) || undefined, planId: getPaywallPlanRequestId(input.plan), providerPlanId: ((_d = input.plan.providerPlanId) === null || _d === void 0 ? void 0 : _d.trim()) || undefined, title: input.plan.title, description: ((_e = input.plan.description) === null || _e === void 0 ? void 0 : _e.trim()) || undefined, amountCents: input.plan.amountCents, couponId: ((_f = input.couponId) === null || _f === void 0 ? void 0 : _f.trim()) || undefined, analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan), customerEmail: ((_g = input.customerEmail) === null || _g === void 0 ? void 0 : _g.trim()) || undefined, returnUrl: input.returnUrl, userId: ((_h = input.user_id) === null || _h === void 0 ? void 0 : _h.trim()) || undefined }, toCheckoutIdentityRequestFields(input.user_id)), { environment: input.environment, runtimeConfig: input.runtimeConfig });
 };
 export const toSubscriptionCheckoutRequest = (input) => {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
     const recurring = requireCheckoutRecurringConfig(input.plan);
-    return {
-        offerSetId: ((_a = input.plan.offerSetId) === null || _a === void 0 ? void 0 : _a.trim()) || undefined,
-        offerSetKey: ((_b = input.plan.offerSetKey) === null || _b === void 0 ? void 0 : _b.trim()) || undefined,
-        planId: getPaywallPlanRequestId(input.plan),
-        planKey: ((_c = input.plan.funnelPlanKey) === null || _c === void 0 ? void 0 : _c.trim()) || input.plan.id,
-        providerPlanId: ((_d = input.plan.providerPlanId) === null || _d === void 0 ? void 0 : _d.trim()) || undefined,
-        provider: input.provider,
-        paymentProfileId: ((_e = input.paymentProfileId) === null || _e === void 0 ? void 0 : _e.trim()) || undefined,
-        runtimeConfigRevisionId: ((_f = input.runtimeConfigRevisionId) === null || _f === void 0 ? void 0 : _f.trim()) || undefined,
-        anonymousUserId: ((_g = input.anonymousUserId) === null || _g === void 0 ? void 0 : _g.trim()) || undefined,
-        idempotencyKey: ((_h = input.idempotencyKey) === null || _h === void 0 ? void 0 : _h.trim()) || undefined,
-        title: input.plan.title,
-        description: ((_j = input.plan.description) === null || _j === void 0 ? void 0 : _j.trim()) || undefined,
-        amountCents: input.plan.amountCents,
-        billingInterval: recurring.interval,
-        billingIntervalCount: recurring.intervalCount,
-        followUpProviderPlanId: ((_k = input.plan.followUpProviderPlanId) === null || _k === void 0 ? void 0 : _k.trim()) || undefined,
-        followUpPlanTitle: ((_l = input.plan.followUpPlanTitle) === null || _l === void 0 ? void 0 : _l.trim()) || undefined,
-        followUpBillingInterval: input.plan.followUpBillingInterval,
-        followUpBillingIntervalCount: input.plan.followUpBillingIntervalCount,
-        introIterations: input.plan.introIterations,
-        couponId: ((_m = input.couponId) === null || _m === void 0 ? void 0 : _m.trim()) || undefined,
-        analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan),
-        customerEmail: ((_o = input.customerEmail) === null || _o === void 0 ? void 0 : _o.trim()) || undefined,
-        returnUrl: input.returnUrl,
-        userId: ((_p = input.user_id) === null || _p === void 0 ? void 0 : _p.trim()) || undefined,
-        environment: input.environment,
-        runtimeConfig: input.runtimeConfig,
-    };
+    return Object.assign(Object.assign({ offerSetId: ((_a = input.plan.offerSetId) === null || _a === void 0 ? void 0 : _a.trim()) || undefined, offerSetKey: ((_b = input.plan.offerSetKey) === null || _b === void 0 ? void 0 : _b.trim()) || undefined, planId: getPaywallPlanRequestId(input.plan), planKey: ((_c = input.plan.funnelPlanKey) === null || _c === void 0 ? void 0 : _c.trim()) || input.plan.id, providerPlanId: ((_d = input.plan.providerPlanId) === null || _d === void 0 ? void 0 : _d.trim()) || undefined, provider: input.provider, paymentProfileId: ((_e = input.paymentProfileId) === null || _e === void 0 ? void 0 : _e.trim()) || undefined, runtimeConfigRevisionId: ((_f = input.runtimeConfigRevisionId) === null || _f === void 0 ? void 0 : _f.trim()) || undefined, anonymousUserId: ((_g = input.anonymousUserId) === null || _g === void 0 ? void 0 : _g.trim()) || undefined, idempotencyKey: ((_h = input.idempotencyKey) === null || _h === void 0 ? void 0 : _h.trim()) || undefined, title: input.plan.title, description: ((_j = input.plan.description) === null || _j === void 0 ? void 0 : _j.trim()) || undefined, amountCents: input.plan.amountCents, billingInterval: recurring.interval, billingIntervalCount: recurring.intervalCount, followUpProviderPlanId: ((_k = input.plan.followUpProviderPlanId) === null || _k === void 0 ? void 0 : _k.trim()) || undefined, followUpPlanTitle: ((_l = input.plan.followUpPlanTitle) === null || _l === void 0 ? void 0 : _l.trim()) || undefined, followUpBillingInterval: input.plan.followUpBillingInterval, followUpBillingIntervalCount: input.plan.followUpBillingIntervalCount, introIterations: input.plan.introIterations, couponId: ((_m = input.couponId) === null || _m === void 0 ? void 0 : _m.trim()) || undefined, analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan), customerEmail: ((_o = input.customerEmail) === null || _o === void 0 ? void 0 : _o.trim()) || undefined, returnUrl: input.returnUrl, userId: ((_p = input.user_id) === null || _p === void 0 ? void 0 : _p.trim()) || undefined }, toCheckoutIdentityRequestFields(input.user_id)), { environment: input.environment, runtimeConfig: input.runtimeConfig });
 };
 export const toSubscriptionCheckoutPlanRequest = (input) => {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;

package/dist/services/checkoutObservability.service.d.ts

@@ -29,6 +29,20 @@ type CheckoutFailureShownInput = CheckoutObservabilityInput & {
     providerErrorCode?: string | null;
     providerErrorType?: string | null;
 };
+export type CheckoutFailureCategory = 'network_failure' | 'payment_rejection' | 'platform_failure' | 'session_failure' | 'validation_failure';
+export type CheckoutFailureClassificationInput = Pick<CheckoutFailureShownInput, 'errorMessage' | 'provider' | 'providerDeclineCode' | 'providerErrorCode' | 'providerErrorType'>;
+export declare const classifyCheckoutFailure: (input: CheckoutFailureClassificationInput) => CheckoutFailureCategory;
 export declare const trackCheckoutFailureShown: (input: CheckoutFailureShownInput) => string | null;
 export declare const trackCheckoutCanceled: (input: CheckoutObservabilityInput) => string | null;
+export type CheckoutWalletReadyInput = {
+    analytics: CheckoutObservabilityAnalyticsContext;
+    checkoutSessionId: string;
+    paymentMethod: unknown;
+    provider: 'stripe';
+    walletClientSecretToReadyMs: number;
+    walletMountToReadyMs: number;
+    walletMountToRequestMs: number;
+    walletRequestMs: number;
+};
+export declare const trackCheckoutWalletReady: (input: CheckoutWalletReadyInput) => string | null;
 export {};

package/dist/services/checkoutObservability.service.js

@@ -37,7 +37,31 @@ const STRIPE_PAYMENT_REJECTION_CODES = new Set([
     'invalid_expiry_month',
     'invalid_expiry_year',
     'payment_intent_authentication_failure',
+    'paymentFailed',
 ]);
+export const classifyCheckoutFailure = (input) => {
+    const providerDeclineCode = asNonEmptyString(input.providerDeclineCode);
+    const providerErrorCode = asNonEmptyString(input.providerErrorCode);
+    const providerErrorType = asNonEmptyString(input.providerErrorType);
+    if (input.provider === 'stripe' && (Boolean(providerDeclineCode)
+        || providerErrorType === 'card_error'
+        || (providerErrorCode ? STRIPE_PAYMENT_REJECTION_CODES.has(providerErrorCode) : false))) {
+        return 'payment_rejection';
+    }
+    const message = input.errorMessage.trim();
+    if (/checkout session.*no longer active/i.test(message)
+        || /selected offer is no longer available/i.test(message)) {
+        return 'session_failure';
+    }
+    if (/failed to fetch|load failed|network|connection to (?:the )?provider|too many requests/i.test(message)) {
+        return 'network_failure';
+    }
+    if (/(?:email|card number|expiration|expiry|cvc|zip|postal code|billing address|country).*(?:required|incomplete|incorrect|invalid|unsupported)/i.test(message)
+        || /(?:required|incomplete|incorrect|invalid|unsupported).*(?:email|card number|expiration|expiry|cvc|zip|postal code|billing address|country)/i.test(message)) {
+        return 'validation_failure';
+    }
+    return 'platform_failure';
+};
 const sanitizeErrorMessage = (value) => value
     .replace(/[\r\n\t]+/g, ' ')
     .replace(/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/gi, '[redacted-email]')
@@ -68,6 +92,7 @@ const reportCheckoutObservability = (input) => {
             environment,
             errorCode: input.errorCode,
             errorMessage: input.errorMessage,
+            failureCategory: input.failureCategory,
             eventId: input.eventId,
             eventType: input.eventType,
             failureStage: input.failureStage,
@@ -78,6 +103,10 @@ const reportCheckoutObservability = (input) => {
             providerDeclineCode: input.providerDeclineCode,
             providerErrorCode: input.providerErrorCode,
             providerErrorType: input.providerErrorType,
+            walletClientSecretToReadyMs: input.walletClientSecretToReadyMs,
+            walletMountToReadyMs: input.walletMountToReadyMs,
+            walletMountToRequestMs: input.walletMountToRequestMs,
+            walletRequestMs: input.walletRequestMs,
         }),
         keepalive: true,
     }).then(() => undefined);
@@ -96,9 +125,9 @@ const resolveErrorCode = (message, requestedCode) => {
     return 'checkout_failure';
 };
 const emitCheckoutObservability = (eventType, input, failure) => {
-    var _a, _b;
+    var _a, _b, _c, _d;
     const paymentMethod = toAnalyticsPaymentMethod(input.paymentMethod);
-    const metadata = Object.assign(Object.assign({}, ((_a = input.analytics.metadata) !== null && _a !== void 0 ? _a : {})), { checkout_session_id: ((_b = input.checkoutSessionId) === null || _b === void 0 ? void 0 : _b.trim()) || undefined, checkout_failure_stage: input.failureStage, payment_provider: input.provider, payment_method: paymentMethod || undefined, error_code: failure === null || failure === void 0 ? void 0 : failure.errorCode, error_message: failure === null || failure === void 0 ? void 0 : failure.errorMessage, provider_decline_code: failure === null || failure === void 0 ? void 0 : failure.providerDeclineCode, provider_error_code: failure === null || failure === void 0 ? void 0 : failure.providerErrorCode, provider_error_type: failure === null || failure === void 0 ? void 0 : failure.providerErrorType });
+    const metadata = Object.assign(Object.assign({}, ((_a = input.analytics.metadata) !== null && _a !== void 0 ? _a : {})), { checkout_session_id: ((_b = input.checkoutSessionId) === null || _b === void 0 ? void 0 : _b.trim()) || undefined, checkout_failure_stage: input.failureStage, payment_provider: input.provider, payment_method: paymentMethod || undefined, error_code: failure === null || failure === void 0 ? void 0 : failure.errorCode, error_message: failure === null || failure === void 0 ? void 0 : failure.errorMessage, checkout_failure_category: (_c = failure === null || failure === void 0 ? void 0 : failure.failureCategory) !== null && _c !== void 0 ? _c : (eventType === 'checkout_canceled' ? 'user_canceled' : undefined), provider_decline_code: failure === null || failure === void 0 ? void 0 : failure.providerDeclineCode, provider_error_code: failure === null || failure === void 0 ? void 0 : failure.providerErrorCode, provider_error_type: failure === null || failure === void 0 ? void 0 : failure.providerErrorType });
     const eventId = publicAnalyticsSdk.track({
         eventType,
         environment: input.analytics.environment,
@@ -117,6 +146,7 @@ const emitCheckoutObservability = (eventType, input, failure) => {
         checkoutSessionId: input.checkoutSessionId,
         errorCode: failure === null || failure === void 0 ? void 0 : failure.errorCode,
         errorMessage: failure === null || failure === void 0 ? void 0 : failure.errorMessage,
+        failureCategory: (_d = failure === null || failure === void 0 ? void 0 : failure.failureCategory) !== null && _d !== void 0 ? _d : (eventType === 'checkout_canceled' ? 'user_canceled' : undefined),
         eventId,
         eventType,
         failureStage: input.failureStage,
@@ -138,17 +168,69 @@ export const trackCheckoutFailureShown = (input) => {
     const providerDeclineCode = (_a = asNonEmptyString(input.providerDeclineCode)) === null || _a === void 0 ? void 0 : _a.slice(0, 120);
     const providerErrorCode = (_b = asNonEmptyString(input.providerErrorCode)) === null || _b === void 0 ? void 0 : _b.slice(0, 120);
     const providerErrorType = (_c = asNonEmptyString(input.providerErrorType)) === null || _c === void 0 ? void 0 : _c.slice(0, 120);
-    const paymentRejected = input.provider === 'stripe' && (Boolean(providerDeclineCode)
-        || providerErrorType === 'card_error'
-        || (providerErrorCode ? STRIPE_PAYMENT_REJECTION_CODES.has(providerErrorCode) : false));
+    const failureCategory = classifyCheckoutFailure({
+        errorMessage,
+        provider: input.provider,
+        providerDeclineCode,
+        providerErrorCode,
+        providerErrorType,
+    });
+    const paymentRejected = failureCategory === 'payment_rejection';
     return emitCheckoutObservability(paymentRejected ? 'checkout_payment_rejected' : 'checkout_failure_shown', input, {
         errorCode: paymentRejected
             ? providerDeclineCode || providerErrorCode || 'payment_rejected'
             : resolveErrorCode(errorMessage, input.errorCode),
         errorMessage,
+        failureCategory,
         providerDeclineCode,
         providerErrorCode,
         providerErrorType,
     });
 };
 export const trackCheckoutCanceled = (input) => emitCheckoutObservability('checkout_canceled', input);
+const normalizeWalletTiming = (value) => (Number.isFinite(value) && value >= 0 && value <= 300000 ? value : null);
+export const trackCheckoutWalletReady = (input) => {
+    var _a;
+    const checkoutSessionId = input.checkoutSessionId.trim();
+    const paymentMethod = toAnalyticsPaymentMethod(input.paymentMethod);
+    const walletClientSecretToReadyMs = normalizeWalletTiming(input.walletClientSecretToReadyMs);
+    const walletMountToReadyMs = normalizeWalletTiming(input.walletMountToReadyMs);
+    const walletMountToRequestMs = normalizeWalletTiming(input.walletMountToRequestMs);
+    const walletRequestMs = normalizeWalletTiming(input.walletRequestMs);
+    if (!checkoutSessionId
+        || !paymentMethod
+        || walletClientSecretToReadyMs === null
+        || walletMountToReadyMs === null
+        || walletMountToRequestMs === null
+        || walletRequestMs === null) {
+        return null;
+    }
+    const eventId = publicAnalyticsSdk.track({
+        environment: input.analytics.environment,
+        eventId: `wallet-ready:${checkoutSessionId}:${paymentMethod}`,
+        eventType: 'checkout_wallet_ready',
+        featureFlags: input.analytics.featureFlags,
+        metadata: Object.assign(Object.assign({}, ((_a = input.analytics.metadata) !== null && _a !== void 0 ? _a : {})), { checkout_session_id: checkoutSessionId, payment_method: paymentMethod, payment_provider: input.provider, wallet_client_secret_to_ready_ms: walletClientSecretToReadyMs, wallet_mount_to_ready_ms: walletMountToReadyMs, wallet_mount_to_request_ms: walletMountToRequestMs, wallet_checkout_request_ms: walletRequestMs }),
+        stepContractVersion: input.analytics.stepContractVersion,
+        stepId: input.analytics.stepId,
+        stepName: input.analytics.stepName,
+        stepType: input.analytics.stepType,
+    });
+    if (!eventId) {
+        return null;
+    }
+    void reportCheckoutObservability({
+        analytics: input.analytics,
+        checkoutSessionId,
+        eventId,
+        eventType: 'checkout_wallet_ready',
+        paymentMethod,
+        provider: input.provider,
+        walletClientSecretToReadyMs,
+        walletMountToReadyMs,
+        walletMountToRequestMs,
+        walletRequestMs,
+    }).catch(() => undefined);
+    void publicAnalyticsSdk.flush().catch(() => 0);
+    return eventId;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/payments",
-  "version": "0.11.15",
+  "version": "0.11.17",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/The-Solid-Grove/funnelsgrove.git",
@@ -33,7 +33,7 @@
   },
   "dependencies": {
     "@funnelsgrove/analytics": "^0.1.86",
-    "@funnelsgrove/runtime": "^0.11.2",
+    "@funnelsgrove/runtime": "^0.11.4",
     "@solidgate/react-sdk": "1.34.0",
     "@stripe/react-stripe-js": "^5.6.0",
     "@stripe/stripe-js": "^8.7.0",