@funnelsgrove/payments 0.1.55 → 0.1.57

package/README.md

@@ -13,13 +13,17 @@ Read this file before editing checkout code. Deeper implementation docs:
 
 ## Current Checkout Path
 
+Render every visible wallet placement with `StripeSubscriptionWalletSurface`. It is the normal current path for Apple Pay and Google Pay:
+
+- Each surface owns one private Checkout Session per simultaneously visible wallet placement, isolated by its own `surfaceId`.
+- Simultaneously visible placements may use the same plan and coupon; nothing is shared because each surface keeps its own session.
+- When the selected plan changes, the surface updates the existing Checkout Session in place without changing `surfaceId`, React `key`, `clientSecret`, `CheckoutProvider`, or the Express Checkout iframe.
+
 Use these for new subscription paywalls:
 
+- `StripeSubscriptionWalletSurface`
 - `useStripeSubscriptionCheckoutSession`
 - `SharedStripeCheckoutV2Dialog`
-- `ApplePaySubscriptionCheckoutSlot`
-- `GooglePaySubscriptionCheckoutSlot`
-- `WalletSubscriptionCheckoutSlot`
 - `trackPaidStripeSubscriptionCheckoutCompleted`
 
 Use these for new one-time paywall plans:
@@ -29,6 +33,10 @@ Use these for new one-time paywall plans:
 
 Use `chargeStripeOneClickPayment` for post-checkout one-click upsells when the shared client helper fits the funnel. It delegates to `funnelSdkService.chargeOneClickPayment`.
 
+## Advanced Wallet Primitives
+
+`ApplePaySubscriptionCheckoutSlot`, `GooglePaySubscriptionCheckoutSlot`, and `WalletSubscriptionCheckoutSlot` stay exported and runtime-compatible. They are backward-compatible advanced low-level primitives: reach for them only when a placement needs wiring `StripeSubscriptionWalletSurface` does not cover. Never share one `useStripeSubscriptionCheckoutSession` result across placements; give each visible placement its own session.
+
 ## Compatibility-Only Surfaces
 
 Keep these exports available for saved drafts, old published artifacts, and controlled migrations. Do not use them for new subscription checkout work:
@@ -70,7 +78,7 @@ When a live funnel still uses one of these, migrate the funnel deliberately with
 - `services/runtimeBillingPlanCatalog.service`: test/live runtime catalog selection.
 - `services/paywallOffer.service`: timed discount and display-plan helpers.
 - `services/stripe.service`: Stripe loader, Checkout Session, hosted checkout, one-click, one-time Checkout Session clients, and deprecated PaymentIntent compatibility clients.
-- `providers/*`: provider-neutral checkout state and Stripe subscription checkout slots.
+- `providers/*`: provider-neutral checkout state, the Stripe subscription wallet surface, and Stripe subscription checkout slots.
 - `components/shared/*`: plan selector, checkout dialogs, Express Checkout wrappers, wallet placeholders, and trust assets.
 - `testing/walletCheckoutSmoke`: wallet checkout smoke assertions.
 

package/dist/components/shared/SharedStripeCheckoutDialog.js

@@ -16,7 +16,7 @@ import { CardCvcElement, CardExpiryElement, CardNumberElement, Elements, useElem
 import { ApplePaySubscribeButton } from './ApplePaySubscribeButton.js';
 import { PaymentBrandMark, SecurityLockIcon, StripeWordmark, } from './CheckoutBrandAssets.js';
 import { StripeExpressCheckoutButton } from './StripeExpressCheckoutButton.js';
-import { trackStripeSubscriptionCheckoutStarted, } from '../../services/checkoutCompletionAnalytics.service.js';
+import { queueStripeSubscriptionCheckoutStarted, } from '../../services/checkoutCompletionAnalytics.service.js';
 const isValidEmail = (value) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
 const defaultPaymentMethodLabels = ['Visa', 'Mastercard', 'PayPal', 'G Pay', 'Apple Pay'];
 const normalizeBillingName = (input) => {
@@ -100,7 +100,7 @@ function getFriendlyCardErrorMessage(error) {
         ? error.message
         : 'Payment failed. Please review your card details and try again.';
 }
-function SharedStripeCheckoutForm({ amountCents, clientSecret, closeAriaLabel, customerEmailEditable = false, customerEmailInvalidMessage = 'Enter a valid email address.', customerEmailLabel = 'Email', customerEmailPlaceholder = 'Enter your email', customerEmail, customerName, legalNotice, onClose, onCustomerEmailChange, onCustomerEmailCommit, onError, onSuccess, paymentMethodLabels = defaultPaymentMethodLabels, poweredByLabel, processingLabel, renewalNotice, returnUrl, secureLabel, submitLabel, summaryLabel, summaryRows, summaryTitle, title, totalLabel, totalValue, walletPlaceholderLabel, summaryNote, }) {
+function SharedStripeCheckoutForm({ amountCents, checkoutAnalytics, checkoutSessionId, clientSecret, closeAriaLabel, customerEmailEditable = false, customerEmailInvalidMessage = 'Enter a valid email address.', customerEmailLabel = 'Email', customerEmailPlaceholder = 'Enter your email', customerEmail, customerName, legalNotice, onClose, onCustomerEmailChange, onCustomerEmailCommit, onError, onSuccess, paymentMethodLabels = defaultPaymentMethodLabels, poweredByLabel, processingLabel, renewalNotice, returnUrl, secureLabel, submitLabel, summaryLabel, summaryRows, summaryTitle, title, totalLabel, totalValue, walletPlaceholderLabel, summaryNote, }) {
     const stripe = useStripe();
     const elements = useElements();
     const [submitting, setSubmitting] = useState(false);
@@ -191,6 +191,9 @@ function SharedStripeCheckoutForm({ amountCents, clientSecret, closeAriaLabel, c
                 setSubmitting(false);
                 return;
             }
+            if (checkoutAnalytics) {
+                queueStripeSubscriptionCheckoutStarted(Object.assign(Object.assign({}, checkoutAnalytics), { checkoutSessionId, paymentMethod: 'card' }));
+            }
             const result = await stripe.confirmCardPayment(clientSecret, {
                 payment_method: {
                     card: cardNumberElement,
@@ -227,7 +230,7 @@ function SharedStripeCheckoutForm({ amountCents, clientSecret, closeAriaLabel, c
                                     ? 'is-positive'
                                     : row.tone === 'negative'
                                         ? 'is-negative'
-                                        : undefined, children: row.value })] }, row.id))), _jsxs("div", { className: 'shared-stripe-checkout-summary-total', children: [_jsx("span", { children: totalLabel }), _jsx("strong", { children: totalValue })] }), summaryNote ? (_jsx("p", { className: 'shared-stripe-checkout-summary-note', children: summaryNote })) : null] }), _jsxs("form", { className: 'shared-stripe-checkout-form', onSubmit: (event) => void handleSubmit(event), children: [_jsxs("div", { className: 'shared-stripe-checkout-wallet-shell', children: [walletAvailable !== true ? (_jsx(ApplePaySubscribeButton, { className: 'shared-stripe-checkout-wallet-placeholder', disabled: walletFallbackDisabled, label: walletPlaceholderLabel })) : null, walletCheckoutAllowed ? (_jsx(StripeExpressCheckoutButton, { amountCents: amountCents, beforeConfirm: ensureCustomerEmail, summaryLabel: summaryLabel, returnUrl: returnUrl, customerEmail: resolvedCustomerEmail, customerName: customerName, className: 'shared-stripe-checkout-wallet-button', onAvailabilityChange: setWalletAvailable, onError: setSharedError })) : null] }), _jsxs("div", { className: 'shared-stripe-checkout-card-surface', children: [_jsxs("div", { className: 'shared-stripe-checkout-field-group shared-stripe-checkout-field-group--wide', children: [_jsx("p", { className: 'shared-stripe-checkout-field-label', children: customerEmailLabel }), _jsx("div", { className: 'shared-stripe-checkout-field shared-stripe-checkout-field--wide', children: _jsx("input", { type: 'email', inputMode: 'email', autoComplete: 'email', className: [
+                                        : undefined, children: row.value })] }, row.id))), _jsxs("div", { className: 'shared-stripe-checkout-summary-total', children: [_jsx("span", { children: totalLabel }), _jsx("strong", { children: totalValue })] }), summaryNote ? (_jsx("p", { className: 'shared-stripe-checkout-summary-note', children: summaryNote })) : null] }), _jsxs("form", { className: 'shared-stripe-checkout-form', onSubmit: (event) => void handleSubmit(event), children: [_jsxs("div", { className: 'shared-stripe-checkout-wallet-shell', children: [walletAvailable !== true ? (_jsx(ApplePaySubscribeButton, { className: 'shared-stripe-checkout-wallet-placeholder', disabled: walletFallbackDisabled, label: walletPlaceholderLabel })) : null, walletCheckoutAllowed ? (_jsx(StripeExpressCheckoutButton, { amountCents: amountCents, beforeConfirm: ensureCustomerEmail, checkoutAnalytics: checkoutAnalytics, checkoutSessionId: checkoutSessionId, summaryLabel: summaryLabel, returnUrl: returnUrl, customerEmail: resolvedCustomerEmail, customerName: customerName, className: 'shared-stripe-checkout-wallet-button', onAvailabilityChange: setWalletAvailable, onError: setSharedError })) : null] }), _jsxs("div", { className: 'shared-stripe-checkout-card-surface', children: [_jsxs("div", { className: 'shared-stripe-checkout-field-group shared-stripe-checkout-field-group--wide', children: [_jsx("p", { className: 'shared-stripe-checkout-field-label', children: customerEmailLabel }), _jsx("div", { className: 'shared-stripe-checkout-field shared-stripe-checkout-field--wide', children: _jsx("input", { type: 'email', inputMode: 'email', autoComplete: 'email', className: [
                                                 'shared-stripe-checkout-text-input',
                                                 customerEmailEditable ? '' : 'is-readonly',
                                             ]
@@ -246,12 +249,6 @@ function SharedStripeCheckoutForm({ amountCents, clientSecret, closeAriaLabel, c
 }
 export function SharedStripeCheckoutDialog(_a) {
     var { checkoutAnalytics, checkoutSessionId, clientSecret, onClose, stripePromise } = _a, props = __rest(_a, ["checkoutAnalytics", "checkoutSessionId", "clientSecret", "onClose", "stripePromise"]);
-    useEffect(() => {
-        if (!checkoutAnalytics) {
-            return;
-        }
-        void trackStripeSubscriptionCheckoutStarted(Object.assign({ checkoutSessionId }, checkoutAnalytics));
-    }, [checkoutAnalytics, checkoutSessionId, clientSecret]);
     useEffect(() => {
         const handleKeyDown = (event) => {
             if (event.key === 'Escape') {
@@ -263,7 +260,7 @@ export function SharedStripeCheckoutDialog(_a) {
     }, [onClose]);
     return (_jsxs(_Fragment, { children: [_jsx("div", { className: 'shared-stripe-checkout-overlay', role: 'presentation', onClick: onClose, children: _jsx("div", { className: 'shared-stripe-checkout-shell', role: 'dialog', "aria-modal": 'true', "aria-labelledby": 'shared-stripe-checkout-title', onClick: (event) => event.stopPropagation(), children: _jsx(Elements, { stripe: stripePromise, options: {
                             clientSecret,
-                        }, children: _jsx(SharedStripeCheckoutForm, Object.assign({}, props, { clientSecret: clientSecret, onClose: onClose })) }) }) }), _jsx("style", { children: sharedStripeCheckoutDialogStyles })] }));
+                        }, children: _jsx(SharedStripeCheckoutForm, Object.assign({}, props, { checkoutAnalytics: checkoutAnalytics, checkoutSessionId: checkoutSessionId, clientSecret: clientSecret, onClose: onClose })) }) }) }), _jsx("style", { children: sharedStripeCheckoutDialogStyles })] }));
 }
 const sharedStripeCheckoutDialogStyles = `
 .shared-stripe-checkout-overlay {

package/dist/components/shared/SharedStripeCheckoutV2Dialog.js

@@ -18,7 +18,7 @@ import { StripeCheckoutExpressCheckoutButton } from './StripeCheckoutExpressChec
 import { getUnsupportedCheckoutCountryMessage, normalizeSupportedCheckoutCountries, } from './checkoutCountries.js';
 import { isInactiveCheckoutSessionError } from '../../providers/stripe/useStripeSubscriptionCheckoutSession.js';
 import { getStripeWalletPaymentMethodOrder, usePlatformWalletPaymentMethods, } from './walletPlatform.js';
-import { trackPaidStripeSubscriptionCheckoutCompleted, trackStripeSubscriptionCheckoutStarted, } from '../../services/checkoutCompletionAnalytics.service.js';
+import { queueStripeSubscriptionCheckoutStarted, trackPaidStripeSubscriptionCheckoutCompleted, } from '../../services/checkoutCompletionAnalytics.service.js';
 const defaultPaymentMethodLabels = ['Visa', 'Mastercard', 'Maestro', 'Discover'];
 const stripeCheckoutV2Appearance = {
     labels: 'above',
@@ -250,6 +250,9 @@ function SharedStripeCheckoutV2CheckoutSessionForm({ amountCents, buttonColor, c
                 setSubmitting(false);
                 return;
             }
+            if (checkoutAnalytics) {
+                queueStripeSubscriptionCheckoutStarted(Object.assign(Object.assign({}, checkoutAnalytics), { checkoutSessionId, paymentMethod: 'card' }));
+            }
             await (onPaymentInfoSubmitted === null || onPaymentInfoSubmitted === void 0 ? void 0 : onPaymentInfoSubmitted());
             const result = await checkoutState.checkout.confirm({
                 redirect: 'if_required',
@@ -293,7 +296,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, className: 'shared-checkout-v2-express-buttons', confirmEmail: false, customerEmail: resolvedCustomerEmail, customerName: customerName, initialAvailable: initialWalletAvailable, keepInitialAvailableOnReady: initialWalletAvailable === true, onAvailabilityChange: handleWalletAvailabilityChange, onError: setSharedError, 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: setSharedError, 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: [
                             'shared-checkout-v2-card-panel',
                             effectiveSelectedMethod === 'card' ? 'is-visible' : '',
                         ]
@@ -327,12 +330,6 @@ export function SharedStripeCheckoutV2Dialog(_a) {
     var { checkoutAnalytics, checkoutSessionId, clientSecret, onClose, stripePromise, supportedCountries } = _a, props = __rest(_a, ["checkoutAnalytics", "checkoutSessionId", "clientSecret", "onClose", "stripePromise", "supportedCountries"]);
     const normalizedSupportedCountries = useMemo(() => normalizeSupportedCheckoutCountries(supportedCountries), [supportedCountries]);
     const fixedBillingCountry = getFixedSupportedBillingCountry(normalizedSupportedCountries);
-    useEffect(() => {
-        if (!checkoutAnalytics) {
-            return;
-        }
-        void trackStripeSubscriptionCheckoutStarted(Object.assign({ checkoutSessionId }, checkoutAnalytics));
-    }, [checkoutAnalytics, checkoutSessionId, clientSecret]);
     useEffect(() => {
         const handleKeyDown = (event) => {
             if (event.key === 'Escape') {

package/dist/components/shared/StripeCheckoutExpressCheckoutButton.js

@@ -2,7 +2,7 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { ExpressCheckoutElement, useCheckout, } from '@stripe/react-stripe-js/checkout';
-import { trackPaidStripeSubscriptionCheckoutCompleted, trackStripeSubscriptionCheckoutStarted, } from '../../services/checkoutCompletionAnalytics.service.js';
+import { queueStripeSubscriptionCheckoutStarted, trackPaidStripeSubscriptionCheckoutCompleted, } from '../../services/checkoutCompletionAnalytics.service.js';
 import { getUnsupportedCheckoutCountryMessage, normalizeSupportedCheckoutCountries, } from './checkoutCountries.js';
 const ExpressCheckoutElementWithCancel = ExpressCheckoutElement;
 const buildDefaultOptions = () => ({
@@ -124,7 +124,7 @@ export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAna
             return;
         }
         if (checkoutAnalytics) {
-            await trackStripeSubscriptionCheckoutStarted(Object.assign({ checkoutSessionId }, checkoutAnalytics));
+            queueStripeSubscriptionCheckoutStarted(Object.assign(Object.assign({}, checkoutAnalytics), { checkoutSessionId, paymentMethod: event.expressPaymentType }));
         }
         let preparedCustomerEmail = (customerEmail === null || customerEmail === void 0 ? void 0 : customerEmail.trim()) || null;
         if (beforeConfirm) {

package/dist/components/shared/StripeExpressCheckoutButton.d.ts

@@ -1,7 +1,10 @@
 import type { AvailablePaymentMethods, StripeExpressCheckoutElementOptions } from '@stripe/stripe-js';
+import { type StripeSubscriptionCheckoutAnalyticsContext } from '../../services/checkoutCompletionAnalytics.service.js';
 export type StripeExpressCheckoutButtonProps = {
     amountCents: number;
     beforeConfirm?: () => Promise<string | null>;
+    checkoutAnalytics?: StripeSubscriptionCheckoutAnalyticsContext | null;
+    checkoutSessionId?: string | null;
     summaryLabel: string;
     returnUrl: string;
     customerEmail?: string | null;
@@ -17,4 +20,4 @@ export type StripeExpressCheckoutButtonProps = {
     onPaymentInfoSubmitted?: () => void | Promise<void>;
     onSuccess?: () => void | Promise<void>;
 };
-export declare function StripeExpressCheckoutButton({ amountCents, beforeConfirm, summaryLabel, returnUrl, customerEmail, customerName, className, options, availabilityPaymentMethods, initialAvailable, keepInitialAvailableOnReady, onAvailabilityChange, onCancel, onError, onPaymentInfoSubmitted, onSuccess, }: StripeExpressCheckoutButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function StripeExpressCheckoutButton({ amountCents, beforeConfirm, checkoutAnalytics, checkoutSessionId, summaryLabel, returnUrl, customerEmail, customerName, className, options, availabilityPaymentMethods, initialAvailable, keepInitialAvailableOnReady, onAvailabilityChange, onCancel, onError, onPaymentInfoSubmitted, onSuccess, }: StripeExpressCheckoutButtonProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/shared/StripeExpressCheckoutButton.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { useMemo, useState } from 'react';
 import { ExpressCheckoutElement, useElements, useStripe } from '@stripe/react-stripe-js';
+import { queueStripeSubscriptionCheckoutStarted, } from '../../services/checkoutCompletionAnalytics.service.js';
 const normalizeBillingName = (input) => {
     var _a, _b, _c;
     const normalizedName = (_a = input.name) === null || _a === void 0 ? void 0 : _a.trim();
@@ -53,7 +54,7 @@ const buildDefaultOptions = (input) => {
 const isSuccessfulIntentStatus = (status) => {
     return status === 'succeeded' || status === 'processing' || status === 'requires_capture';
 };
-export function StripeExpressCheckoutButton({ amountCents, beforeConfirm, summaryLabel, returnUrl, customerEmail, customerName, className, options, availabilityPaymentMethods = ['applePay'], initialAvailable, keepInitialAvailableOnReady = false, onAvailabilityChange, onCancel, onError, onPaymentInfoSubmitted, onSuccess, }) {
+export function StripeExpressCheckoutButton({ amountCents, beforeConfirm, checkoutAnalytics, checkoutSessionId, summaryLabel, returnUrl, customerEmail, customerName, className, options, availabilityPaymentMethods = ['applePay'], initialAvailable, keepInitialAvailableOnReady = false, onAvailabilityChange, onCancel, onError, onPaymentInfoSubmitted, onSuccess, }) {
     const stripe = useStripe();
     const elements = useElements();
     const [walletAvailable, setWalletAvailable] = useState(initialAvailable !== null && initialAvailable !== void 0 ? initialAvailable : null);
@@ -77,6 +78,9 @@ export function StripeExpressCheckoutButton({ amountCents, beforeConfirm, summar
             return;
         }
         onError === null || onError === void 0 ? void 0 : onError(null);
+        if (checkoutAnalytics) {
+            queueStripeSubscriptionCheckoutStarted(Object.assign(Object.assign({}, checkoutAnalytics), { checkoutSessionId, paymentMethod: event.expressPaymentType }));
+        }
         let preparedCustomerEmail = (customerEmail === null || customerEmail === void 0 ? void 0 : customerEmail.trim()) || null;
         if (beforeConfirm) {
             try {

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './services/runtimeBillingPlanCatalog.service.js';
 export * from './services/paywallOffer.service.js';
 export * from './services/stripe.service.js';
 export * from './services/checkoutCompletionAnalytics.service.js';
+export * from './services/paymentMethodAnalytics.service.js';
 export * from './hooks/useResolvedPaywallPlans.js';
 export * from './providers/paymentProvider.types.js';
 export * from './providers/stripe/useStripeSubscriptionCheckoutSession.js';
@@ -13,6 +14,7 @@ export * from './providers/stripe/useStripeOneTimeCheckoutSession.js';
 export * from './providers/stripe/WalletSubscriptionCheckoutSlot.js';
 export * from './providers/stripe/ApplePaySubscriptionCheckoutSlot.js';
 export * from './providers/stripe/GooglePaySubscriptionCheckoutSlot.js';
+export * from './providers/stripe/StripeSubscriptionWalletSurface.js';
 export { ManageSubscriptionScreen, type ManageSubscriptionContent, type ManageSubscriptionScreenProps, } from './components/ManageSubscriptionScreen.js';
 export * from './components/shared/SharedStripeCheckoutV2Dialog.js';
 export * from './components/shared/StripeExpressCheckoutElement.js';

package/dist/index.js

@@ -8,6 +8,7 @@ export * from './services/paywallOffer.service.js';
 // Stripe API clients and checkout completion handoff.
 export * from './services/stripe.service.js';
 export * from './services/checkoutCompletionAnalytics.service.js';
+export * from './services/paymentMethodAnalytics.service.js';
 export * from './hooks/useResolvedPaywallPlans.js';
 // Provider-neutral and Stripe subscription checkout primitives.
 export * from './providers/paymentProvider.types.js';
@@ -16,6 +17,7 @@ export * from './providers/stripe/useStripeOneTimeCheckoutSession.js';
 export * from './providers/stripe/WalletSubscriptionCheckoutSlot.js';
 export * from './providers/stripe/ApplePaySubscriptionCheckoutSlot.js';
 export * from './providers/stripe/GooglePaySubscriptionCheckoutSlot.js';
+export * from './providers/stripe/StripeSubscriptionWalletSurface.js';
 // Shared checkout and subscription-management UI.
 export { ManageSubscriptionScreen, } from './components/ManageSubscriptionScreen.js';
 export * from './components/shared/SharedStripeCheckoutV2Dialog.js';

package/dist/providers/stripe/ApplePaySubscriptionCheckoutSlot.d.ts

@@ -4,4 +4,9 @@ export type ApplePaySubscriptionCheckoutSlotProps = Omit<WalletSubscriptionCheck
     options?: Partial<StripeCheckoutExpressCheckoutElementOptions>;
     placeholderLabel?: string;
 };
+/**
+ * @deprecated Prefer StripeSubscriptionWalletSurface for visible wallet placements. This slot stays
+ * exported and runtime-compatible as an advanced low-level primitive; its checkout session must
+ * never be shared across placements.
+ */
 export declare function ApplePaySubscriptionCheckoutSlot({ options, placeholderLabel, ...slotProps }: ApplePaySubscriptionCheckoutSlotProps): import("react/jsx-runtime").JSX.Element;

package/dist/providers/stripe/ApplePaySubscriptionCheckoutSlot.js

@@ -36,6 +36,11 @@ const applePayExpressCheckoutOptions = {
         paypal: 'never',
     },
 };
+/**
+ * @deprecated Prefer StripeSubscriptionWalletSurface for visible wallet placements. This slot stays
+ * exported and runtime-compatible as an advanced low-level primitive; its checkout session must
+ * never be shared across placements.
+ */
 export function ApplePaySubscriptionCheckoutSlot(_a) {
     var _b, _c, _d, _e, _f, _g, _h, _j, _k;
     var { options, placeholderLabel = 'Subscribe with Apple Pay' } = _a, slotProps = __rest(_a, ["options", "placeholderLabel"]);

package/dist/providers/stripe/GooglePaySubscriptionCheckoutSlot.d.ts

@@ -4,4 +4,9 @@ export type GooglePaySubscriptionCheckoutSlotProps = Omit<WalletSubscriptionChec
     options?: Partial<StripeCheckoutExpressCheckoutElementOptions>;
     placeholderLabel?: string;
 };
+/**
+ * @deprecated Prefer StripeSubscriptionWalletSurface for visible wallet placements. This slot stays
+ * exported and runtime-compatible as an advanced low-level primitive; its checkout session must
+ * never be shared across placements.
+ */
 export declare function GooglePaySubscriptionCheckoutSlot({ options, placeholderLabel, ...slotProps }: GooglePaySubscriptionCheckoutSlotProps): import("react/jsx-runtime").JSX.Element;

package/dist/providers/stripe/GooglePaySubscriptionCheckoutSlot.js

@@ -36,6 +36,11 @@ const googlePayExpressCheckoutOptions = {
         paypal: 'never',
     },
 };
+/**
+ * @deprecated Prefer StripeSubscriptionWalletSurface for visible wallet placements. This slot stays
+ * exported and runtime-compatible as an advanced low-level primitive; its checkout session must
+ * never be shared across placements.
+ */
 export function GooglePaySubscriptionCheckoutSlot(_a) {
     var _b, _c, _d, _e, _f, _g, _h, _j, _k;
     var { options, placeholderLabel = 'Subscribe with Google Pay' } = _a, slotProps = __rest(_a, ["options", "placeholderLabel"]);

package/dist/providers/stripe/StripeSubscriptionWalletSurface.d.ts

@@ -0,0 +1,82 @@
+import { type ReactNode } from 'react';
+import type { Appearance, StripeCheckoutExpressCheckoutElementOptions } from '@stripe/stripe-js';
+import { type PlatformWalletPaymentMethod } from '../../components/shared/walletPlatform.js';
+import type { StripeSubscriptionCheckoutAnalyticsContext } from '../../services/checkoutCompletionAnalytics.service.js';
+import { type StripeSubscriptionCheckoutSessionInput } from './useStripeSubscriptionCheckoutSession.js';
+export type StripeSubscriptionWalletSurfaceCheckoutInput = Omit<StripeSubscriptionCheckoutSessionInput, 'onError'> & {
+    customerName?: string | null;
+};
+export type StripeSubscriptionWalletSurfaceAvailability = {
+    anyAvailable: boolean;
+    methods: Partial<Record<PlatformWalletPaymentMethod, boolean>>;
+    resolved: boolean;
+};
+export type StripeSubscriptionWalletSurfaceAvailabilityState = {
+    intentKey: string;
+    methods: Partial<Record<PlatformWalletPaymentMethod, boolean>>;
+};
+export type StripeSubscriptionWalletSurfaceErrorContext = {
+    paymentMethod?: PlatformWalletPaymentMethod;
+    surfaceId: string;
+};
+export type StripeSubscriptionWalletSurfaceErrorEmission = {
+    context: StripeSubscriptionWalletSurfaceErrorContext;
+    errorState: StripeSubscriptionWalletSurfaceErrorState;
+    message: string | null;
+};
+export type StripeSubscriptionWalletSurfaceErrorState = {
+    methodMessages: Partial<Record<PlatformWalletPaymentMethod, string>>;
+    surfaceMessage: string | null;
+};
+export type StripeSubscriptionWalletSurfaceRenderStateInput = {
+    anyAvailable: boolean;
+    configured: boolean;
+    paymentMethodCount: number;
+    resolved: boolean;
+    suspended: boolean;
+};
+export declare function buildStripeSubscriptionWalletSurfaceAnalyticsMetadata(analyticsMetadata: Record<string, unknown> | null | undefined, surfaceId: string): Record<string, unknown>;
+export declare function buildStripeSubscriptionWalletSurfaceCheckoutAnalytics(checkoutAnalytics: StripeSubscriptionCheckoutAnalyticsContext | null | undefined, surfaceId: string): StripeSubscriptionCheckoutAnalyticsContext | null;
+export declare function normalizeStripeSubscriptionWalletSurfaceMethods(paymentMethods: readonly PlatformWalletPaymentMethod[]): PlatformWalletPaymentMethod[];
+export declare function getStripeSubscriptionWalletSurfaceVisibleMethods(paymentMethods: readonly PlatformWalletPaymentMethod[], methods: Partial<Record<PlatformWalletPaymentMethod, boolean>>): PlatformWalletPaymentMethod[];
+export declare function getStripeSubscriptionWalletSurfaceMethodAvailability(state: StripeSubscriptionWalletSurfaceAvailabilityState, intentKey: string): Partial<Record<PlatformWalletPaymentMethod, boolean>>;
+export declare function applyStripeSubscriptionWalletSurfaceMethodAvailability(state: StripeSubscriptionWalletSurfaceAvailabilityState, intentKey: string, method: PlatformWalletPaymentMethod, available: boolean): StripeSubscriptionWalletSurfaceAvailabilityState;
+export declare function buildStripeSubscriptionWalletSurfaceAvailability(paymentMethods: readonly PlatformWalletPaymentMethod[], methods: Partial<Record<PlatformWalletPaymentMethod, boolean>>): StripeSubscriptionWalletSurfaceAvailability;
+export declare function shouldRenderStripeSubscriptionWalletSurface({ anyAvailable, configured, paymentMethodCount, resolved, suspended, }: StripeSubscriptionWalletSurfaceRenderStateInput): boolean;
+export declare function resolveStripeSubscriptionWalletSurfaceError({ errorState, message, paymentMethod, surfaceId, }: {
+    errorState: StripeSubscriptionWalletSurfaceErrorState;
+    message: string | null;
+    paymentMethod?: PlatformWalletPaymentMethod;
+    surfaceId: string;
+}): StripeSubscriptionWalletSurfaceErrorEmission | null;
+export type StripeSubscriptionWalletSurfaceProps = {
+    amountCents: number;
+    appearance?: Appearance;
+    applePayOptions?: Partial<StripeCheckoutExpressCheckoutElementOptions>;
+    applePayPlaceholderLabel?: string;
+    beforeConfirm?: () => Promise<string | null>;
+    checkout: StripeSubscriptionWalletSurfaceCheckoutInput;
+    checkoutAnalytics?: StripeSubscriptionCheckoutAnalyticsContext | null;
+    className?: string;
+    containerClassName?: string;
+    disabled?: boolean;
+    googlePayOptions?: Partial<StripeCheckoutExpressCheckoutElementOptions>;
+    googlePayPlaceholderLabel?: string;
+    onAvailabilityChange?: (availability: StripeSubscriptionWalletSurfaceAvailability) => void;
+    onCancel?: () => void;
+    onError?: (message: string | null, context: StripeSubscriptionWalletSurfaceErrorContext) => void;
+    onPaymentInfoSubmitted?: () => void | Promise<void>;
+    onSuccess?: () => void | Promise<void>;
+    onUnavailableClick?: () => Promise<void> | void;
+    paymentMethods?: readonly PlatformWalletPaymentMethod[];
+    renderHeader?: (props: {
+        availability: StripeSubscriptionWalletSurfaceAvailability;
+    }) => ReactNode;
+    resolveMethodClassName?: (method: PlatformWalletPaymentMethod) => string | undefined;
+    resolveMethodWrapperClassName?: (method: PlatformWalletPaymentMethod) => string | undefined;
+    slotClassName?: string;
+    summaryLabel: string;
+    surfaceId: string;
+    suspended?: boolean;
+};
+export declare function StripeSubscriptionWalletSurface({ amountCents, appearance, applePayOptions, applePayPlaceholderLabel, beforeConfirm, checkout, checkoutAnalytics, className, containerClassName, disabled, googlePayOptions, googlePayPlaceholderLabel, onAvailabilityChange, onCancel, onError, onPaymentInfoSubmitted, onSuccess, onUnavailableClick, paymentMethods, renderHeader, resolveMethodClassName, resolveMethodWrapperClassName, slotClassName, summaryLabel, surfaceId, suspended, }: StripeSubscriptionWalletSurfaceProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/providers/stripe/StripeSubscriptionWalletSurface.js

@@ -0,0 +1,188 @@
+'use client';
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { usePlatformWalletPaymentMethods, } from '../../components/shared/walletPlatform.js';
+import { ApplePaySubscriptionCheckoutSlot } from './ApplePaySubscriptionCheckoutSlot.js';
+import { GooglePaySubscriptionCheckoutSlot } from './GooglePaySubscriptionCheckoutSlot.js';
+import { useStripeSubscriptionCheckoutSession, } from './useStripeSubscriptionCheckoutSession.js';
+export function buildStripeSubscriptionWalletSurfaceAnalyticsMetadata(analyticsMetadata, surfaceId) {
+    return Object.assign(Object.assign({}, (analyticsMetadata !== null && analyticsMetadata !== void 0 ? analyticsMetadata : {})), { checkoutSurfaceId: surfaceId });
+}
+export function buildStripeSubscriptionWalletSurfaceCheckoutAnalytics(checkoutAnalytics, surfaceId) {
+    if (!checkoutAnalytics) {
+        return null;
+    }
+    return Object.assign(Object.assign({}, checkoutAnalytics), { metadata: buildStripeSubscriptionWalletSurfaceAnalyticsMetadata(checkoutAnalytics.metadata, surfaceId) });
+}
+export function normalizeStripeSubscriptionWalletSurfaceMethods(paymentMethods) {
+    return paymentMethods.filter((method, index) => paymentMethods.indexOf(method) === index);
+}
+export function getStripeSubscriptionWalletSurfaceVisibleMethods(paymentMethods, methods) {
+    return paymentMethods.filter((method) => methods[method] !== false);
+}
+export function getStripeSubscriptionWalletSurfaceMethodAvailability(state, intentKey) {
+    return state.intentKey === intentKey ? state.methods : {};
+}
+export function applyStripeSubscriptionWalletSurfaceMethodAvailability(state, intentKey, method, available) {
+    return {
+        intentKey,
+        methods: Object.assign(Object.assign({}, getStripeSubscriptionWalletSurfaceMethodAvailability(state, intentKey)), { [method]: available }),
+    };
+}
+export function buildStripeSubscriptionWalletSurfaceAvailability(paymentMethods, methods) {
+    const reportedMethods = paymentMethods.filter((method) => typeof methods[method] === 'boolean');
+    return {
+        anyAvailable: reportedMethods.some((method) => methods[method] === true),
+        methods: reportedMethods.reduce((current, method) => (Object.assign(Object.assign({}, current), { [method]: methods[method] === true })), {}),
+        resolved: reportedMethods.length === paymentMethods.length,
+    };
+}
+export function shouldRenderStripeSubscriptionWalletSurface({ anyAvailable, configured, paymentMethodCount, resolved, suspended, }) {
+    return configured && !suspended && paymentMethodCount > 0 && (!resolved || anyAvailable);
+}
+export function resolveStripeSubscriptionWalletSurfaceError({ errorState, message, paymentMethod, surfaceId, }) {
+    if (paymentMethod && errorState.methodMessages[paymentMethod] === message) {
+        return null;
+    }
+    if (!paymentMethod) {
+        const methodMessages = Object.values(errorState.methodMessages);
+        if (message === null) {
+            if (errorState.surfaceMessage === null && methodMessages.length === 0) {
+                return null;
+            }
+        }
+        else if (errorState.surfaceMessage === message || methodMessages.includes(message)) {
+            return null;
+        }
+    }
+    const nextErrorState = message === null
+        ? { methodMessages: {}, surfaceMessage: null }
+        : paymentMethod
+            ? Object.assign(Object.assign({}, errorState), { methodMessages: Object.assign(Object.assign({}, errorState.methodMessages), { [paymentMethod]: message }) }) : Object.assign(Object.assign({}, errorState), { surfaceMessage: message });
+    return {
+        context: Object.assign(Object.assign({}, (paymentMethod ? { paymentMethod } : {})), { surfaceId }),
+        errorState: nextErrorState,
+        message,
+    };
+}
+// Availability identity used to notify consumers only when the aggregate actually changed.
+function buildAvailabilitySignature(availability) {
+    return [
+        availability.resolved ? 'resolved' : 'unresolved',
+        availability.anyAvailable ? 'available' : 'unavailable',
+        Object.entries(availability.methods)
+            .map(([method, available]) => `${method}:${available ? '1' : '0'}`)
+            .sort()
+            .join(','),
+    ].join('|');
+}
+export function StripeSubscriptionWalletSurface({ amountCents, appearance, applePayOptions, applePayPlaceholderLabel, beforeConfirm, checkout, checkoutAnalytics, className, containerClassName, disabled, googlePayOptions, googlePayPlaceholderLabel, onAvailabilityChange, onCancel, onError, onPaymentInfoSubmitted, onSuccess, onUnavailableClick, paymentMethods, renderHeader, resolveMethodClassName, resolveMethodWrapperClassName, slotClassName, summaryLabel, surfaceId, suspended = false, }) {
+    var _a;
+    const platformWalletPaymentMethods = usePlatformWalletPaymentMethods();
+    const walletPaymentMethods = normalizeStripeSubscriptionWalletSurfaceMethods(paymentMethods !== null && paymentMethods !== void 0 ? paymentMethods : platformWalletPaymentMethods);
+    const normalizedSurfaceId = surfaceId.trim();
+    const { customerName } = checkout, checkoutSessionInput = __rest(checkout, ["customerName"]);
+    const surfaceAnalyticsMetadata = useMemo(() => buildStripeSubscriptionWalletSurfaceAnalyticsMetadata(checkout.analyticsMetadata, normalizedSurfaceId), [checkout.analyticsMetadata, normalizedSurfaceId]);
+    const session = useStripeSubscriptionCheckoutSession(Object.assign(Object.assign({}, checkoutSessionInput), { analyticsMetadata: surfaceAnalyticsMetadata }));
+    const surfaceCheckoutAnalytics = useMemo(() => buildStripeSubscriptionWalletSurfaceCheckoutAnalytics(checkoutAnalytics, normalizedSurfaceId), [checkoutAnalytics, normalizedSurfaceId]);
+    const [availabilityState, setAvailabilityState] = useState({
+        intentKey: session.intentKey,
+        methods: {},
+    });
+    const availability = buildStripeSubscriptionWalletSurfaceAvailability(walletPaymentMethods, getStripeSubscriptionWalletSurfaceMethodAvailability(availabilityState, session.intentKey));
+    const availabilitySignature = buildAvailabilitySignature(availability);
+    const reportedAvailabilitySignatureRef = useRef(null);
+    const errorStateRef = useRef({
+        methodMessages: {},
+        surfaceMessage: null,
+    });
+    const emitError = useCallback((message, paymentMethod) => {
+        const emission = resolveStripeSubscriptionWalletSurfaceError({
+            errorState: errorStateRef.current,
+            message,
+            paymentMethod,
+            surfaceId: normalizedSurfaceId,
+        });
+        if (!emission) {
+            return;
+        }
+        errorStateRef.current = emission.errorState;
+        onError === null || onError === void 0 ? void 0 : onError(emission.message, emission.context);
+    }, [normalizedSurfaceId, onError]);
+    useEffect(() => {
+        if (reportedAvailabilitySignatureRef.current === availabilitySignature) {
+            return;
+        }
+        reportedAvailabilitySignatureRef.current = availabilitySignature;
+        onAvailabilityChange === null || onAvailabilityChange === void 0 ? void 0 : onAvailabilityChange(availability);
+    }, [availability, availabilitySignature, onAvailabilityChange]);
+    useEffect(() => {
+        emitError(session.error);
+    }, [emitError, session.error]);
+    const renderWalletMethod = (method) => {
+        var _a;
+        const slotProps = {
+            amountCents,
+            appearance,
+            beforeConfirm,
+            checkoutAnalytics: surfaceCheckoutAnalytics,
+            className: (_a = resolveMethodClassName === null || resolveMethodClassName === void 0 ? void 0 : resolveMethodClassName(method)) !== null && _a !== void 0 ? _a : className,
+            customerEmail: checkout.customerEmail,
+            customerName,
+            disabled,
+            onAvailabilityChange: (available) => setAvailabilityState((current) => applyStripeSubscriptionWalletSurfaceMethodAvailability(current, session.intentKey, method, available)),
+            onCancel,
+            onError: (message) => emitError(message, method),
+            onPaymentInfoSubmitted,
+            onSuccess,
+            onUnavailableClick,
+            returnUrl: checkout.returnUrl,
+            session,
+            slotClassName,
+            summaryLabel,
+        };
+        if (method === 'applePay') {
+            return (_jsx(ApplePaySubscriptionCheckoutSlot, Object.assign({}, slotProps, { options: applePayOptions, placeholderLabel: applePayPlaceholderLabel })));
+        }
+        if (method === 'googlePay') {
+            return (_jsx(GooglePaySubscriptionCheckoutSlot, Object.assign({}, slotProps, { options: googlePayOptions, placeholderLabel: googlePayPlaceholderLabel })));
+        }
+        return null;
+    };
+    const visibleWalletPaymentMethods = getStripeSubscriptionWalletSurfaceVisibleMethods(walletPaymentMethods, availability.methods);
+    const shouldRenderSurface = shouldRenderStripeSubscriptionWalletSurface({
+        anyAvailable: availability.anyAvailable,
+        configured: session.configured,
+        paymentMethodCount: walletPaymentMethods.length,
+        resolved: availability.resolved,
+        suspended,
+    });
+    if (!shouldRenderSurface) {
+        return null;
+    }
+    return (_jsxs("div", { className: [
+            'stripe-subscription-wallet-surface',
+            containerClassName !== null && containerClassName !== void 0 ? containerClassName : '',
+        ]
+            .filter(Boolean)
+            .join(' '), "data-wallet-surface-id": normalizedSurfaceId, children: [(_a = renderHeader === null || renderHeader === void 0 ? void 0 : renderHeader({ availability })) !== null && _a !== void 0 ? _a : null, visibleWalletPaymentMethods.map((method) => {
+                var _a;
+                return (_jsx("div", { className: [
+                        'stripe-subscription-wallet-surface__method',
+                        (_a = resolveMethodWrapperClassName === null || resolveMethodWrapperClassName === void 0 ? void 0 : resolveMethodWrapperClassName(method)) !== null && _a !== void 0 ? _a : '',
+                    ]
+                        .filter(Boolean)
+                        .join(' '), "data-wallet-payment-method": method, children: renderWalletMethod(method) }, method));
+            })] }));
+}

package/dist/providers/stripe/WalletSubscriptionCheckoutSlot.d.ts

@@ -50,5 +50,10 @@ export type WalletSubscriptionCheckoutSlotProps = {
     suspended?: boolean;
 };
 export declare function WalletSubscriptionCheckoutLoadingPlaceholder({ className, label, }: Pick<WalletPlaceholderButtonProps, 'className' | 'label'>): import("react/jsx-runtime").JSX.Element;
+/**
+ * @deprecated Prefer StripeSubscriptionWalletSurface for visible wallet placements. This slot stays
+ * exported and runtime-compatible as an advanced low-level primitive; its checkout session must
+ * never be shared across placements.
+ */
 export declare function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availabilityPaymentMethod, beforeConfirm, checkoutAnalytics, className, customerEmail, customerName, disabled, expressCheckoutAllowed, onAvailabilityChange, onCancel, onError, onPaymentInfoSubmitted, onSuccess, onUnavailableClick, options, placeholderLabel, renderPreparingPlaceholder, renderPlaceholder, returnUrl, session, slotClassName, summaryLabel, suspended, }: WalletSubscriptionCheckoutSlotProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/providers/stripe/WalletSubscriptionCheckoutSlot.js

@@ -3,6 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useCallback, useEffect, useRef, useState } from 'react';
 import { StripeExpressCheckoutElement } from '../../components/shared/StripeExpressCheckoutElement.js';
 import { trackStripeSubscriptionCheckoutStarted, } from '../../services/checkoutCompletionAnalytics.service.js';
+import { toAnalyticsPaymentMethod } from '../../services/paymentMethodAnalytics.service.js';
 import { isInactiveCheckoutSessionError, } from './useStripeSubscriptionCheckoutSession.js';
 export function getWalletSubscriptionCheckoutRenderState({ expressCheckoutAllowed, hasActiveClientSecret, hasStripePromise, suspended, walletAvailable, walletPreparing, }) {
     const shouldRenderExpressCheckout = !suspended &&
@@ -28,6 +29,11 @@ export function WalletSubscriptionCheckoutLoadingPlaceholder({ className, label,
             .filter(Boolean)
             .join(' '), "aria-label": label, role: 'status', children: [_jsx("span", { className: 'wallet-subscription-checkout-slot__loading-bar' }), _jsx("style", { children: walletSubscriptionCheckoutLoadingPlaceholderStyles })] }));
 }
+/**
+ * @deprecated Prefer StripeSubscriptionWalletSurface for visible wallet placements. This slot stays
+ * exported and runtime-compatible as an advanced low-level primitive; its checkout session must
+ * never be shared across placements.
+ */
 export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availabilityPaymentMethod, beforeConfirm, checkoutAnalytics, className, customerEmail, customerName, disabled = false, expressCheckoutAllowed = true, onAvailabilityChange, onCancel, onError, onPaymentInfoSubmitted, onSuccess, onUnavailableClick, options, placeholderLabel, renderPreparingPlaceholder, renderPlaceholder, returnUrl, session, slotClassName, summaryLabel, suspended = false, }) {
     const [walletAvailability, setWalletAvailability] = useState({
         available: null,
@@ -37,6 +43,7 @@ export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availa
     const autoWalletPreparationIntentKeyRef = useRef(null);
     const walletCheckoutStartedAfterClickSessionIdRef = useRef(null);
     const slotDisabled = disabled || !session.configured;
+    const analyticsPaymentMethod = toAnalyticsPaymentMethod(availabilityPaymentMethod);
     const walletAvailable = walletAvailability.intentKey === session.intentKey
         ? walletAvailability.available
         : null;
@@ -84,6 +91,7 @@ export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availa
         void session
             .prepareWalletCheckout({
             checkoutStartSource: 'wallet_render',
+            paymentMethod: analyticsPaymentMethod,
         })
             .then((readyClientSecret) => {
             if (!readyClientSecret) {
@@ -91,6 +99,7 @@ export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availa
             }
         });
     }, [
+        analyticsPaymentMethod,
         expressCheckoutAllowed,
         reportWalletPreparationFailure,
         session.activeClientSecret,
@@ -112,8 +121,9 @@ export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availa
             return;
         }
         walletCheckoutStartedAfterClickSessionIdRef.current = session.checkoutSessionId;
-        void trackStripeSubscriptionCheckoutStarted(Object.assign({ checkoutSessionId: session.checkoutSessionId }, checkoutAnalytics));
+        void trackStripeSubscriptionCheckoutStarted(Object.assign(Object.assign({}, checkoutAnalytics), { checkoutSessionId: session.checkoutSessionId, paymentMethod: analyticsPaymentMethod }));
     }, [
+        analyticsPaymentMethod,
         checkoutAnalytics,
         session.checkoutSessionId,
         session.intentKey,
@@ -127,6 +137,7 @@ export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availa
             });
             void session.restartWalletCheckout({
                 checkoutStartSource: 'wallet_render',
+                paymentMethod: analyticsPaymentMethod,
             });
             return;
         }
@@ -147,6 +158,7 @@ export function WalletSubscriptionCheckoutSlot({ amountCents, appearance, availa
         setWalletCheckoutStartedAfterClickIntentKey(session.intentKey);
         const readyClientSecret = await session.prepareWalletCheckout({
             checkoutStartSource: 'wallet_render',
+            paymentMethod: analyticsPaymentMethod,
         });
         if (!readyClientSecret) {
             setWalletCheckoutStartedAfterClickIntentKey(null);

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

@@ -1,6 +1,6 @@
 import type { Stripe } from '@stripe/stripe-js';
 import type { RuntimeMode } from '@funnelsgrove/runtime';
-import { type CheckoutPreparationLoading } from '../paymentProvider.types.js';
+import { type CheckoutPreparationLoading, type CheckoutPreparationSource } from '../paymentProvider.types.js';
 import { type PaywallPlan, type StripeRuntimeConfigOverrides } from '../../services/stripe.service.js';
 type StripeOneTimeCheckoutPlanInput = Pick<PaywallPlan, 'amountCents' | 'analyticsPurchaseValue' | 'description' | 'id' | 'providerPlanId' | 'title'>;
 export type StripeOneTimeCheckoutSessionInput = {
@@ -16,9 +16,11 @@ export type StripeOneTimeCheckoutSessionInput = {
     userId?: string | null;
 };
 export type StripeOneTimeCheckoutPreparationOptions = {
-    checkoutStartSource?: 'card_click' | 'wallet_click' | 'wallet_render' | (string & {});
+    checkoutStartSource?: 'card_click' | 'checkout_render' | 'wallet_click' | 'wallet_render' | (string & {});
     forceNew?: boolean;
+    paymentMethod?: unknown;
 };
+export declare function resolveStripeOneTimeCheckoutPreparationOptions(source: CheckoutPreparationSource, options?: StripeOneTimeCheckoutPreparationOptions): StripeOneTimeCheckoutPreparationOptions;
 export type StripeOneTimeCheckoutSession = {
     activeClientSecret: string | null;
     checkoutSessionId: string | null;
@@ -36,6 +38,7 @@ export type StripeOneTimeCheckoutSession = {
     setError: (message: string | null) => void;
     stripePromise: Promise<Stripe | null> | null;
 };
+export declare const buildStripeOneTimeCheckoutPreparationAnalyticsMetadata: (analyticsMetadata: Record<string, unknown> | null | undefined, options?: StripeOneTimeCheckoutPreparationOptions) => Record<string, unknown> | null | undefined;
 export type StripeOneTimeCheckoutIntentKeyInput = Pick<StripeOneTimeCheckoutSessionInput, 'checkoutMode' | 'couponId' | 'customerEmail' | 'plan' | 'returnUrl' | 'runtimeConfig' | 'userId'> & {
     analyticsMetadata?: Record<string, unknown> | null;
 };

package/dist/providers/stripe/useStripeOneTimeCheckoutSession.js

@@ -1,8 +1,26 @@
 'use client';
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, } from 'react';
 import { createEmptyCheckoutPreparationLoading, } from '../paymentProvider.types.js';
 import { createStripeOneTimeCheckout, getStripePromise, isStripeConfigured, } from '../../services/stripe.service.js';
 import { isInactiveCheckoutSessionError } from './useStripeSubscriptionCheckoutSession.js';
+import { toAnalyticsPaymentMethod } from '../../services/paymentMethodAnalytics.service.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');
+    const paymentMethod = (_b = options.paymentMethod) !== null && _b !== void 0 ? _b : (source === 'card' && checkoutStartSource !== 'checkout_render' ? 'card' : undefined);
+    return Object.assign(Object.assign(Object.assign({}, options), { checkoutStartSource }), (paymentMethod !== undefined ? { paymentMethod } : {}));
+}
 const getFriendlyStripeCheckoutError = (error) => {
     const message = error instanceof Error ? error.message : 'Unable to initialize checkout';
     return message === 'Internal server error'
@@ -11,13 +29,12 @@ const getFriendlyStripeCheckoutError = (error) => {
 };
 const normalizeRuntimeConfigValue = (value) => (value === null || value === void 0 ? void 0 : value.trim()) || '';
 const useIsomorphicLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;
-const buildCheckoutPreparationAnalyticsMetadata = (analyticsMetadata, options = {}) => {
+export const buildStripeOneTimeCheckoutPreparationAnalyticsMetadata = (analyticsMetadata, options = {}) => {
     var _a;
     const checkoutStartSource = (_a = options.checkoutStartSource) === null || _a === void 0 ? void 0 : _a.trim();
-    if (!checkoutStartSource) {
-        return analyticsMetadata;
-    }
-    return Object.assign(Object.assign({}, (analyticsMetadata !== null && analyticsMetadata !== void 0 ? analyticsMetadata : {})), { checkoutStartSource });
+    const paymentMethod = toAnalyticsPaymentMethod(options.paymentMethod);
+    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 buildStripeOneTimeCheckoutIntentKey({ checkoutMode, couponId, customerEmail, plan, returnUrl, runtimeConfig, userId, }) {
     var _a;
@@ -141,7 +158,7 @@ export function useStripeOneTimeCheckoutSession({ analyticsMetadata, checkoutMod
             try {
                 const response = await createStripeOneTimeCheckout({
                     plan,
-                    analyticsMetadata: buildCheckoutPreparationAnalyticsMetadata(analyticsMetadataRef.current, options),
+                    analyticsMetadata: buildStripeOneTimeCheckoutPreparationAnalyticsMetadata(analyticsMetadataRef.current, options),
                     couponId,
                     customerEmail,
                     returnUrl,
@@ -198,7 +215,6 @@ export function useStripeOneTimeCheckoutSession({ analyticsMetadata, checkoutMod
         userId,
     ]);
     const prepareCheckout = useCallback(async (source, options = {}) => {
-        var _a;
         if (!configured || !plan) {
             return null;
         }
@@ -208,7 +224,7 @@ export function useStripeOneTimeCheckoutSession({ analyticsMetadata, checkoutMod
         setSourceLoading(source, true);
         setError(null);
         try {
-            return await createCheckoutSession(Object.assign(Object.assign({}, options), { checkoutStartSource: (_a = options.checkoutStartSource) !== null && _a !== void 0 ? _a : (source === 'wallet' ? 'wallet_render' : 'card_click') }));
+            return await createCheckoutSession(Object.assign({}, resolveStripeOneTimeCheckoutPreparationOptions(source, options)));
         }
         finally {
             setSourceLoading(source, false);

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

@@ -1,6 +1,6 @@
 import type { Stripe } from '@stripe/stripe-js';
 import type { RuntimeMode } from '@funnelsgrove/runtime';
-import { type CheckoutPreparationLoading } from '../paymentProvider.types.js';
+import { type CheckoutPreparationLoading, type CheckoutPreparationSource } from '../paymentProvider.types.js';
 import type { PaywallDisplayPlan } from '../../services/paywallOffer.service.js';
 import { type PaywallPlan, type StripeRuntimeConfigOverrides } from '../../services/stripe.service.js';
 export type StripeSubscriptionCheckoutSessionInput = {
@@ -17,9 +17,11 @@ export type StripeSubscriptionCheckoutSessionInput = {
     userId?: string | null;
 };
 export type StripeSubscriptionCheckoutPreparationOptions = {
-    checkoutStartSource?: 'card_click' | 'wallet_click' | 'wallet_render' | (string & {});
+    checkoutStartSource?: 'card_click' | 'checkout_render' | 'wallet_click' | 'wallet_render' | (string & {});
     forceNew?: boolean;
+    paymentMethod?: unknown;
 };
+export declare function resolveStripeSubscriptionCheckoutPreparationOptions(source: CheckoutPreparationSource, options?: StripeSubscriptionCheckoutPreparationOptions): StripeSubscriptionCheckoutPreparationOptions;
 export type StripeSubscriptionCheckoutSession = {
     activeClientSecret: string | null;
     activePlanKey: string | null;
@@ -39,6 +41,7 @@ export type StripeSubscriptionCheckoutSession = {
     stripePromise: Promise<Stripe | null> | null;
     updateCheckoutSessionPlan: () => Promise<boolean>;
 };
+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' | 'returnUrl' | 'runtimeConfig' | 'userId'> & {
     analyticsMetadata?: Record<string, unknown> | null;
 };

package/dist/providers/stripe/useStripeSubscriptionCheckoutSession.js

@@ -1,7 +1,25 @@
 'use client';
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, } from 'react';
 import { createEmptyCheckoutPreparationLoading, } from '../paymentProvider.types.js';
 import { createStripeSubscriptionCheckout, getStripePromise, isStripeConfigured, updateStripeSubscriptionCheckoutPlan, } from '../../services/stripe.service.js';
+import { toAnalyticsPaymentMethod } from '../../services/paymentMethodAnalytics.service.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');
+    const paymentMethod = (_b = options.paymentMethod) !== null && _b !== void 0 ? _b : (source === 'card' && checkoutStartSource !== 'checkout_render' ? 'card' : undefined);
+    return Object.assign(Object.assign(Object.assign({}, options), { checkoutStartSource }), (paymentMethod !== undefined ? { paymentMethod } : {}));
+}
 const getFriendlyStripeCheckoutError = (error) => {
     const message = error instanceof Error ? error.message : 'Unable to initialize checkout';
     return message === 'Internal server error'
@@ -10,13 +28,12 @@ const getFriendlyStripeCheckoutError = (error) => {
 };
 const normalizeRuntimeConfigValue = (value) => (value === null || value === void 0 ? void 0 : value.trim()) || '';
 const useIsomorphicLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;
-const buildCheckoutPreparationAnalyticsMetadata = (analyticsMetadata, options = {}) => {
+export const buildStripeSubscriptionCheckoutPreparationAnalyticsMetadata = (analyticsMetadata, options = {}) => {
     var _a;
     const checkoutStartSource = (_a = options.checkoutStartSource) === null || _a === void 0 ? void 0 : _a.trim();
-    if (!checkoutStartSource) {
-        return analyticsMetadata;
-    }
-    return Object.assign(Object.assign({}, (analyticsMetadata !== null && analyticsMetadata !== void 0 ? analyticsMetadata : {})), { checkoutStartSource });
+    const paymentMethod = toAnalyticsPaymentMethod(options.paymentMethod);
+    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, userId, }) {
     const runtimeConfigSignature = [
@@ -142,7 +159,7 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
             try {
                 const response = await createStripeSubscriptionCheckout({
                     plan,
-                    analyticsMetadata: buildCheckoutPreparationAnalyticsMetadata(analyticsMetadataRef.current, options),
+                    analyticsMetadata: buildStripeSubscriptionCheckoutPreparationAnalyticsMetadata(analyticsMetadataRef.current, options),
                     couponId,
                     customerEmail,
                     returnUrl,
@@ -201,7 +218,6 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
         userId,
     ]);
     const prepareCheckout = useCallback(async (source, options = {}) => {
-        var _a;
         if (!configured || !plan || !displayPlan) {
             return null;
         }
@@ -211,7 +227,7 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
         setSourceLoading(source, true);
         setError(null);
         try {
-            return await createCheckoutSubscription(Object.assign(Object.assign({}, options), { checkoutStartSource: (_a = options.checkoutStartSource) !== null && _a !== void 0 ? _a : (source === 'wallet' ? 'wallet_render' : 'card_click') }));
+            return await createCheckoutSubscription(Object.assign({}, resolveStripeSubscriptionCheckoutPreparationOptions(source, options)));
         }
         finally {
             setSourceLoading(source, false);

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

@@ -12,6 +12,7 @@ export type StripeSubscriptionCheckoutAnalyticsContext = {
 };
 export type TrackStripeSubscriptionCheckoutStartedInput = StripeSubscriptionCheckoutAnalyticsContext & {
     checkoutSessionId?: string | null;
+    paymentMethod?: unknown;
 };
 export type TrackPaidStripeSubscriptionCheckoutCompletedInput = StripeSubscriptionCheckoutAnalyticsContext & {
     checkoutSessionId?: string | null;
@@ -19,4 +20,5 @@ export type TrackPaidStripeSubscriptionCheckoutCompletedInput = StripeSubscripti
 export type TrackStripeSubscriptionCheckoutStartedResult = 'already_tracked' | 'analytics_rejected' | 'missing_checkout_session' | 'tracked';
 export type TrackPaidStripeSubscriptionCheckoutCompletedResult = 'already_tracked' | 'analytics_rejected' | 'missing_checkout_session' | 'tracked' | 'unpaid';
 export declare function trackStripeSubscriptionCheckoutStarted(input: TrackStripeSubscriptionCheckoutStartedInput): Promise<TrackStripeSubscriptionCheckoutStartedResult>;
+export declare function queueStripeSubscriptionCheckoutStarted(input: TrackStripeSubscriptionCheckoutStartedInput): void;
 export declare function trackPaidStripeSubscriptionCheckoutCompleted(input: TrackPaidStripeSubscriptionCheckoutCompletedInput): Promise<TrackPaidStripeSubscriptionCheckoutCompletedResult>;

package/dist/services/checkoutCompletionAnalytics.service.js

@@ -1,5 +1,17 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 import { publicAnalyticsSdk, } from '@funnelsgrove/analytics';
 import { verifyStripeSubscriptionCheckoutPayment, } from './stripe.service.js';
+import { toAnalyticsPaymentMethod } from './paymentMethodAnalytics.service.js';
 const asRecord = (value) => {
     return value && typeof value === 'object' && !Array.isArray(value)
         ? value
@@ -49,7 +61,8 @@ export async function trackStripeSubscriptionCheckoutStarted(input) {
     }
     activeCheckoutStartedKeys.add(startedKey);
     try {
-        const metadata = asRecord(input.metadata);
+        const _b = asRecord(input.metadata), { payment_method: _paymentMethod, payment_provider: _paymentProvider } = _b, metadata = __rest(_b, ["payment_method", "payment_provider"]);
+        const paymentMethod = toAnalyticsPaymentMethod(input.paymentMethod);
         const conversionInput = {
             eventId: checkoutSessionId,
             featureFlags: input.featureFlags,
@@ -57,7 +70,7 @@ export async function trackStripeSubscriptionCheckoutStarted(input) {
             stepName: input.stepName,
             stepType: input.stepType,
             stepContractVersion: input.stepContractVersion,
-            metadata: Object.assign(Object.assign({}, metadata), { checkoutSessionId, checkout_session_id: checkoutSessionId, environment: input.environment || metadata.environment }),
+            metadata: Object.assign(Object.assign(Object.assign({}, metadata), { checkoutSessionId, checkout_session_id: checkoutSessionId, environment: input.environment || metadata.environment, payment_provider: 'stripe' }), (paymentMethod ? { payment_method: paymentMethod } : {})),
         };
         const eventId = publicAnalyticsSdk.trackCheckoutStarted(conversionInput);
         if (!eventId) {
@@ -71,6 +84,9 @@ export async function trackStripeSubscriptionCheckoutStarted(input) {
         activeCheckoutStartedKeys.delete(startedKey);
     }
 }
+export function queueStripeSubscriptionCheckoutStarted(input) {
+    void trackStripeSubscriptionCheckoutStarted(input).catch(() => undefined);
+}
 export async function trackPaidStripeSubscriptionCheckoutCompleted(input) {
     var _a;
     const checkoutSessionId = ((_a = input.checkoutSessionId) === null || _a === void 0 ? void 0 : _a.trim()) || '';

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

@@ -0,0 +1,2 @@
+export type AnalyticsPaymentMethod = 'apple_pay' | 'card' | 'google_pay';
+export declare function toAnalyticsPaymentMethod(value: unknown): AnalyticsPaymentMethod | undefined;

package/dist/services/paymentMethodAnalytics.service.js

@@ -0,0 +1,14 @@
+export function toAnalyticsPaymentMethod(value) {
+    switch (value) {
+        case 'applePay':
+        case 'apple_pay':
+            return 'apple_pay';
+        case 'card':
+            return 'card';
+        case 'googlePay':
+        case 'google_pay':
+            return 'google_pay';
+        default:
+            return undefined;
+    }
+}

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

@@ -44,7 +44,7 @@ export declare function getStripeSyncedPlans(mode: RuntimeMode, planCatalog?: Bi
 export declare function resolvePaywallPlansFromProjectPlans(projectPlans: readonly RemoteProjectBillingPlan[], planCatalog?: BillingPlanInputCatalog | readonly BillingFallbackPlanConfig[], options?: PaywallPlanResolutionOptions): readonly PaywallPlan[];
 export declare function getPaywallPlans(mode: RuntimeMode, planCatalog?: BillingPlanInputCatalog | readonly BillingFallbackPlanConfig[], options?: PaywallPlanResolutionOptions): Promise<readonly PaywallPlan[]>;
 export declare function isStripeConfigured(mode: RuntimeMode): boolean;
-export declare function getStripePromise(mode: RuntimeMode, runtimePublishableKey?: string | null): Promise<Stripe | null> | null;
+export declare function getStripePromise(_mode: RuntimeMode, runtimePublishableKey?: string | null): Promise<Stripe | null> | null;
 type CheckoutSessionPlanInput = Pick<PaywallPlan, 'amountCents' | 'analyticsPurchaseValue' | 'billingInterval' | 'billingIntervalCount' | 'description' | 'id' | 'providerPlanId' | 'title' | 'followUpProviderPlanId' | 'followUpPlanTitle' | 'followUpBillingInterval' | 'followUpBillingIntervalCount' | 'introIterations'>;
 type CheckoutPlanRecurringConfig = {
     interval: BillingPlanInterval;
@@ -80,6 +80,10 @@ type CreateOneTimeCheckoutResponse = {
     checkoutSessionId?: string;
     stripePublishableKey?: string;
     environment?: 'test' | 'live';
+    paymentProfileId?: string;
+    userId?: string;
+    anonymousUserId?: string;
+    funnelEndUserId?: string;
 };
 export declare function createStripeOneTimeCheckout(input: CreateOneTimeCheckoutInput): Promise<CreateOneTimeCheckoutResponse>;
 /**
@@ -124,6 +128,10 @@ type CreateSubscriptionCheckoutResponse = {
     subscriptionId?: string;
     stripePublishableKey?: string;
     environment?: 'test' | 'live';
+    paymentProfileId?: string;
+    userId?: string;
+    anonymousUserId?: string;
+    funnelEndUserId?: string;
 };
 type UpdateSubscriptionCheckoutPlanInput = {
     checkoutSessionId: string;
@@ -169,6 +177,12 @@ type CreateCheckoutSessionInput = {
 type CreateCheckoutSessionResponse = {
     sessionId?: string;
     url: string;
+    stripePublishableKey?: string;
+    environment?: 'test' | 'live';
+    paymentProfileId?: string;
+    userId?: string;
+    anonymousUserId?: string;
+    funnelEndUserId?: string;
 };
 export declare function createStripeCheckoutSession(input: CreateCheckoutSessionInput): Promise<CreateCheckoutSessionResponse>;
 export declare function redirectToStripeCheckout(input: CreateCheckoutSessionInput): Promise<string>;

package/dist/services/stripe.service.js

@@ -432,8 +432,8 @@ export async function getPaywallPlans(mode, planCatalog, options) {
 export function isStripeConfigured(mode) {
     return getStripePublishableKeyFromEnv(mode).length > 0 || FUNNEL_SDK_PUBLISHABLE_KEY.length > 0;
 }
-export function getStripePromise(mode, runtimePublishableKey) {
-    const resolvedPublishableKey = (runtimePublishableKey !== null && runtimePublishableKey !== void 0 ? runtimePublishableKey : getStripePublishableKeyFromEnv(mode)).trim();
+export function getStripePromise(_mode, runtimePublishableKey) {
+    const resolvedPublishableKey = (runtimePublishableKey === null || runtimePublishableKey === void 0 ? void 0 : runtimePublishableKey.trim()) || '';
     if (!resolvedPublishableKey) {
         return null;
     }

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@funnelsgrove/payments",
-  "version": "0.1.55",
+  "version": "0.1.57",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/The-Solid-Grove/funnelsgrove.git",
+    "directory": "apps/funnel-payments"
+  },
   "type": "module",
   "private": false,
   "main": "./dist/index.js",