@funnelsgrove/payments 0.11.14 → 0.11.16

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/hooks/useStripeSubscriptionCheckoutSession.d.ts

@@ -50,9 +50,11 @@ export type StripeSubscriptionCheckoutSession = {
 export declare const buildStripeSubscriptionCheckoutPreparationAnalyticsMetadata: (analyticsMetadata: Record<string, unknown> | null | undefined, options?: StripeSubscriptionCheckoutPreparationOptions) => Record<string, unknown> | null | undefined;
 export type StripeSubscriptionCheckoutIntentKeyInput = Pick<StripeSubscriptionCheckoutSessionInput, 'checkoutMode' | 'couponId' | 'customerEmail' | 'paymentProfileId' | 'provider' | 'returnUrl' | 'runtimeConfig' | 'runtimeConfigRevisionId' | 'stripePublishableKey' | 'userId'> & {
     analyticsMetadata?: Record<string, unknown> | null;
+    planKey?: string | null;
 };
-export declare function buildStripeSubscriptionCheckoutIntentKey({ checkoutMode, couponId, customerEmail, returnUrl, runtimeConfig, runtimeConfigRevisionId, paymentProfileId, provider, stripePublishableKey, userId, }: StripeSubscriptionCheckoutIntentKeyInput): string;
+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

@@ -37,7 +37,7 @@ export const buildStripeSubscriptionCheckoutPreparationAnalyticsMetadata = (anal
     const _b = analyticsMetadata !== null && analyticsMetadata !== void 0 ? analyticsMetadata : {}, { payment_method: _paymentMethod, paymentMethod: _camelCasePaymentMethod } = _b, metadata = __rest(_b, ["payment_method", "paymentMethod"]);
     return Object.assign(Object.assign(Object.assign({}, metadata), (checkoutStartSource ? { checkoutStartSource } : {})), (paymentMethod ? { payment_method: paymentMethod } : {}));
 };
-export function buildStripeSubscriptionCheckoutIntentKey({ checkoutMode, couponId, customerEmail, returnUrl, runtimeConfig, runtimeConfigRevisionId, paymentProfileId, provider, stripePublishableKey, userId, }) {
+export function buildStripeSubscriptionCheckoutIntentKey({ checkoutMode, couponId, customerEmail, returnUrl, runtimeConfig, runtimeConfigRevisionId, paymentProfileId, planKey, provider, stripePublishableKey, userId, }) {
     var _a;
     const runtimeConfigSignature = [
         normalizeRuntimeConfigValue(runtimeConfig === null || runtimeConfig === void 0 ? void 0 : runtimeConfig.apiBaseUrl),
@@ -59,6 +59,7 @@ export function buildStripeSubscriptionCheckoutIntentKey({ checkoutMode, couponI
         customerEmailSignature,
         userIdSignature,
         (couponId === null || couponId === void 0 ? void 0 : couponId.trim()) || '',
+        (planKey === null || planKey === void 0 ? void 0 : planKey.trim()) || '',
         returnUrl.trim(),
     ].join('|');
 }
@@ -69,6 +70,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;
@@ -77,20 +81,31 @@ 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 configured = enabled &&
         (isStripeConfigured(checkoutMode) ||
             Boolean(normalizeRuntimeConfigValue(runtimeConfig === null || runtimeConfig === void 0 ? void 0 : runtimeConfig.funnelSdkPublishableKey)) ||
             Boolean(normalizeRuntimeConfigValue(stripePublishableKey)));
+    const planKey = [
+        (_a = plan === null || plan === void 0 ? void 0 : plan.id) !== null && _a !== void 0 ? _a : '',
+        (_b = plan === null || plan === void 0 ? void 0 : plan.providerPlanId) !== null && _b !== void 0 ? _b : '',
+        (_c = plan === null || plan === void 0 ? void 0 : plan.amountCents) !== null && _c !== void 0 ? _c : '',
+        (_d = displayPlan === null || displayPlan === void 0 ? void 0 : displayPlan.id) !== null && _d !== void 0 ? _d : '',
+        (_e = displayPlan === null || displayPlan === void 0 ? void 0 : displayPlan.amountCents) !== null && _e !== void 0 ? _e : '',
+    ].join('|');
     const intentKey = buildStripeSubscriptionCheckoutIntentKey({
         checkoutMode,
         couponId,
         customerEmail,
+        planKey,
         returnUrl,
         runtimeConfig,
         runtimeConfigRevisionId,
@@ -99,13 +114,6 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
         stripePublishableKey,
         userId,
     });
-    const planKey = [
-        (_a = plan === null || plan === void 0 ? void 0 : plan.id) !== null && _a !== void 0 ? _a : '',
-        (_b = plan === null || plan === void 0 ? void 0 : plan.providerPlanId) !== null && _b !== void 0 ? _b : '',
-        (_c = plan === null || plan === void 0 ? void 0 : plan.amountCents) !== null && _c !== void 0 ? _c : '',
-        (_d = displayPlan === null || displayPlan === void 0 ? void 0 : displayPlan.id) !== null && _d !== void 0 ? _d : '',
-        (_e = displayPlan === null || displayPlan === void 0 ? void 0 : displayPlan.amountCents) !== null && _e !== void 0 ? _e : '',
-    ].join('|');
     const activeClientSecret = clientSecretIntentKey === intentKey ? clientSecret : null;
     const activeCheckoutSessionId = clientSecretIntentKey === intentKey ? checkoutSessionId : null;
     const activePlanKey = clientSecretIntentKey === intentKey ? clientSecretPlanKey : null;
@@ -125,21 +133,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;
@@ -302,6 +321,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/services/checkoutObservability.service.d.ts

@@ -29,6 +29,9 @@ 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 {};

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,
@@ -96,9 +121,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 +142,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,14 +164,20 @@ 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,

package/package.json

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