@funnelsgrove/payments 0.22.6 → 0.23.0

package/README.md

@@ -194,3 +194,13 @@ including legacy wallet launchers. Mount it before wallet launch, persist throug
 `isValidCheckoutEmail` and `isCheckoutEmailError` share validation and recovery
 classification. `onCustomerEmailChange` in the card dialog reports a committed
 email, not each draft keystroke, so typing cannot prepare sessions for unsaved input.
+
+## Offer price money
+
+Published plans expose optional `money: ProviderMoney`; new mappings supply it. Discount presentation and purchase analytics use its amount, currency and exponent. `amountCents` remains a legacy wire alias and does not define the scale of structured money. Independent plans can use different currencies. Currency is selected by the provider price, not by an Offer Set setting.
+
+### Published offer selection and checkout attempts
+
+Use `resolvePublishedBillingRuntimeState` with configuration, browser locale and experiment assignments that are ready. Its result is `pending`, `resolved` or `error`. Pending/error states must not prepare Stripe card/wallet or Solidgate checkout; the maintained templates render an inert zero-plan state rather than a starter catalog.
+
+`usePinnedPublishedBillingRuntime` holds the complete resolved catalog at the first payment preparation. Wire its `pin` callback to preparation and release both the payment session and this snapshot on explicit reset. Displayed prices, provider, revision, source version, locale and experiment assignment then remain consistent through background updates. The visitor can still choose another plan within the pinned offer set. A new attempt after reset can adopt the latest configuration.

package/dist/config/billing.config.d.ts

@@ -1,3 +1,4 @@
+import type { ProviderMoney } from '@funnelsgrove/runtime';
 export type BillingPlanComparison = {
     perDay: string;
     perWeek: string;
@@ -16,6 +17,8 @@ export type BillingPlanConfig = {
     featuredTag?: string;
     perDayAmount: string;
     amountCents: number;
+    money?: ProviderMoney;
+    currency?: string;
     analyticsPurchaseValue?: number;
     checkoutSummaryLabel?: string;
     followUpProviderPlanId?: string;

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './services/planCatalog.service.js';
 export * from './services/paywallPlans.service.js';
 export * from './services/runtimeBillingPlanCatalog.service.js';
 export * from './services/publishedBillingRuntime.service.js';
+export * from './services/usePinnedPublishedBillingRuntime.js';
 export * from './services/paywallOffer.service.js';
 export * from './services/paymentMethodAnalytics.service.js';
 export * from './services/checkoutObservability.service.js';

package/dist/index.js

@@ -6,6 +6,7 @@ export * from './services/planCatalog.service.js';
 export * from './services/paywallPlans.service.js';
 export * from './services/runtimeBillingPlanCatalog.service.js';
 export * from './services/publishedBillingRuntime.service.js';
+export * from './services/usePinnedPublishedBillingRuntime.js';
 export * from './services/paywallOffer.service.js';
 export * from './services/paymentMethodAnalytics.service.js';
 export * from './services/checkoutObservability.service.js';

package/dist/providers/solidgate/components/SolidgateCheckoutDialog.d.ts

@@ -1,3 +1,3 @@
 import type { SolidgateCheckoutDialogProps } from './SolidgateCheckoutDialog.types.js';
 export type { SolidgateCheckoutDialogState, SolidgateCheckoutDialogContent, SolidgateCheckoutDialogPresentation, SolidgateCheckoutDialogProps, SolidgateCheckoutAnalyticsContext, } from './SolidgateCheckoutDialog.types.js';
-export declare function SolidgateCheckoutDialog({ open, request, customerEmail, checkoutAnalytics, content, presentation, onClose, onCustomerEmailCommit, onSuccess, onRetry, onError, onStateChange, }: SolidgateCheckoutDialogProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SolidgateCheckoutDialog({ open, request, customerEmail, checkoutAnalytics, content, presentation, onClose, onCustomerEmailCommit, onSuccess, onRetry, onError, onPreparationStart, onStateChange, }: SolidgateCheckoutDialogProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/providers/solidgate/components/SolidgateCheckoutDialog.js

@@ -65,7 +65,7 @@ const trackSolidgateCheckoutEvent = async (eventName, attemptId, context) => {
     }
 };
 const isAbortError = (error) => (error instanceof DOMException && error.name === 'AbortError');
-export function SolidgateCheckoutDialog({ open, request, customerEmail, checkoutAnalytics, content, presentation, onClose, onCustomerEmailCommit, onSuccess, onRetry, onError, onStateChange, }) {
+export function SolidgateCheckoutDialog({ open, request, customerEmail, checkoutAnalytics, content, presentation, onClose, onCustomerEmailCommit, onSuccess, onRetry, onError, onPreparationStart, onStateChange, }) {
     const copy = useMemo(() => (Object.assign(Object.assign({}, defaultContent), content)), [content]);
     const [view, setView] = useState(initialView);
     const [retryRequest, setRetryRequest] = useState(null);
@@ -76,6 +76,7 @@ export function SolidgateCheckoutDialog({ open, request, customerEmail, checkout
     const [emailSubmitting, setEmailSubmitting] = useState(false);
     const [mountedPaymentAttemptId, setMountedPaymentAttemptId] = useState(null);
     const prepareAbortRef = useRef(null);
+    const preparedRequestRef = useRef(null);
     const statusAbortRef = useRef(null);
     const successAttemptRef = useRef(null);
     const paymentInfoAttemptRef = useRef(null);
@@ -146,6 +147,8 @@ export function SolidgateCheckoutDialog({ open, request, customerEmail, checkout
         runtimeFunnelId,
         successUrl,
     ]);
+    const latestRequestRef = useRef(normalizedRequest);
+    latestRequestRef.current = normalizedRequest;
     const setState = useCallback((nextView) => {
         var _a;
         setView(nextView);
@@ -167,8 +170,9 @@ export function SolidgateCheckoutDialog({ open, request, customerEmail, checkout
     }, []);
     const requiresEmailCommit = Boolean(onCustomerEmailCommit);
     useEffect(() => {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g;
         if (!open) {
+            preparedRequestRef.current = null;
             (_a = prepareAbortRef.current) === null || _a === void 0 ? void 0 : _a.abort();
             (_b = statusAbortRef.current) === null || _b === void 0 ? void 0 : _b.abort();
             return;
@@ -184,8 +188,10 @@ export function SolidgateCheckoutDialog({ open, request, customerEmail, checkout
             return;
         }
         const controller = new AbortController();
-        (_e = prepareAbortRef.current) === null || _e === void 0 ? void 0 : _e.abort();
-        (_f = statusAbortRef.current) === null || _f === void 0 ? void 0 : _f.abort();
+        onPreparationStart === null || onPreparationStart === void 0 ? void 0 : onPreparationStart();
+        const preparedRequest = (_e = preparedRequestRef.current) !== null && _e !== void 0 ? _e : (preparedRequestRef.current = latestRequestRef.current);
+        (_f = prepareAbortRef.current) === null || _f === void 0 ? void 0 : _f.abort();
+        (_g = statusAbortRef.current) === null || _g === void 0 ? void 0 : _g.abort();
         prepareAbortRef.current = controller;
         successAttemptRef.current = null;
         paymentInfoAttemptRef.current = null;
@@ -195,7 +201,7 @@ export function SolidgateCheckoutDialog({ open, request, customerEmail, checkout
                 setState(initialView);
             }
         });
-        void prepareSolidgateCheckout(Object.assign(Object.assign({}, normalizedRequest), { signal: controller.signal }))
+        void prepareSolidgateCheckout(Object.assign(Object.assign({}, preparedRequest), { signal: controller.signal }))
             .then((checkout) => {
             if (!controller.signal.aborted) {
                 setState({ state: 'ready', checkout, canResumeVerification: false });
@@ -211,7 +217,7 @@ export function SolidgateCheckoutDialog({ open, request, customerEmail, checkout
             }
         });
         return () => controller.abort();
-    }, [committedEmail, normalizedRequest, open, requiresEmailCommit, setState, trackFailure]);
+    }, [checkoutKey, committedEmail, onPreparationStart, open, requiresEmailCommit, setState, trackFailure]);
     const paymentFormMounted = Boolean(view.checkout && mountedPaymentAttemptId === view.checkout.attemptId);
     const showPreparingLoader = view.state === 'loading'
         || (view.state === 'ready' && !paymentFormMounted);
@@ -395,8 +401,11 @@ export function SolidgateCheckoutDialog({ open, request, customerEmail, checkout
                                     setState(Object.assign(Object.assign({}, view), { state: 'recoverable_error', canResumeVerification: false }));
                                     trackFailure(copyRef.current.error, 'payment_form', (_a = view.checkout) === null || _a === void 0 ? void 0 : _a.attemptId);
                                     (_b = onErrorRef.current) === null || _b === void 0 ? void 0 : _b.call(onErrorRef, copyRef.current.error);
-                                } }, view.checkout.attemptId)) : null, presentation && view.checkout && showForm ? (_jsx("p", { className: 'solidgate-checkout-secure', children: presentation.secureLabel })) : null, statusMessage && view.state !== 'ready' ? (_jsx("div", { className: 'solidgate-checkout-status', children: _jsx("p", { role: 'status', "aria-live": 'polite', children: statusMessage }) })) : null, view.canResumeVerification ? (_jsx("button", { type: 'button', onClick: () => void verifyCanonicalStatus(), className: 'solidgate-checkout-action solidgate-checkout-action--spaced', children: copy.resumeVerification })) : null, (view.state === 'recoverable_error' || view.state === 'expired') && !view.canResumeVerification ? (_jsx("button", { type: 'button', onClick: onRetry || (() => setRetryRequest({
-                                    originalKey: idempotencyKey,
-                                    key: crypto.randomUUID(),
-                                })), className: 'solidgate-checkout-action solidgate-checkout-action--spaced', children: copy.retry })) : null] })) : null] }), _jsx("style", { children: solidgateCheckoutDialogStyles })] }));
+                                } }, view.checkout.attemptId)) : null, presentation && view.checkout && showForm ? (_jsx("p", { className: 'solidgate-checkout-secure', children: presentation.secureLabel })) : null, statusMessage && view.state !== 'ready' ? (_jsx("div", { className: 'solidgate-checkout-status', children: _jsx("p", { role: 'status', "aria-live": 'polite', children: statusMessage }) })) : null, view.canResumeVerification ? (_jsx("button", { type: 'button', onClick: () => void verifyCanonicalStatus(), className: 'solidgate-checkout-action solidgate-checkout-action--spaced', children: copy.resumeVerification })) : null, (view.state === 'recoverable_error' || view.state === 'expired') && !view.canResumeVerification ? (_jsx("button", { type: 'button', onClick: onRetry || (() => {
+                                    preparedRequestRef.current = null;
+                                    setRetryRequest({
+                                        originalKey: idempotencyKey,
+                                        key: crypto.randomUUID(),
+                                    });
+                                }), className: 'solidgate-checkout-action solidgate-checkout-action--spaced', children: copy.retry })) : null] })) : null] }), _jsx("style", { children: solidgateCheckoutDialogStyles })] }));
 }

package/dist/providers/solidgate/components/SolidgateCheckoutDialog.types.d.ts

@@ -1,4 +1,5 @@
 import type { FunnelSdkRuntimeConfigOverrides, FunnelStepType, RuntimeMode } from '@funnelsgrove/runtime';
+import type { PublicAnalyticsFeatureFlags } from '@funnelsgrove/analytics';
 import type { PrepareSolidgateCheckoutInput, SolidgateCheckoutPreparation } from '../services/solidgate.service.js';
 export type SolidgateCheckoutDialogState = 'collecting_email' | 'loading' | 'ready' | 'submitting' | 'verifying' | 'success' | 'recoverable_error' | 'expired';
 export type SolidgateCheckoutDialogContent = {
@@ -52,11 +53,12 @@ export type SolidgateCheckoutDialogProps = {
     onSuccess?: (checkout: SolidgateCheckoutPreparation) => void | Promise<void>;
     onRetry?: () => void;
     onError?: (message: string) => void;
+    onPreparationStart?: () => void;
     onStateChange?: (state: SolidgateCheckoutDialogState) => void;
 };
 export type SolidgateCheckoutAnalyticsContext = {
     environment?: RuntimeMode;
-    featureFlags?: Record<string, string | null | undefined>;
+    featureFlags?: PublicAnalyticsFeatureFlags;
     metadata?: Record<string, unknown> | null;
     runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
     stepId: string;

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

@@ -15,6 +15,8 @@ export type StripeOneTimeCheckoutSessionInput = {
     couponId?: string | null;
     customerEmail?: string | null;
     enabled?: boolean;
+    onPreparationStart?: () => void;
+    onReset?: () => void;
     onError?: (message: string | null) => void;
     plan?: StripeOneTimeCheckoutPlanInput | null;
     returnUrl: string;
@@ -52,4 +54,4 @@ export type StripeOneTimeCheckoutIntentKeyInput = Pick<StripeOneTimeCheckoutSess
 };
 export declare function buildStripeOneTimeCheckoutIntentKey({ runtimeConfigRevisionId, paymentProfileId, provider, checkoutMode, couponId, customerEmail, plan, returnUrl, runtimeConfig, stripePublishableKey, userId, }: StripeOneTimeCheckoutIntentKeyInput): string;
 export declare function shouldResetStripeOneTimeCheckoutSessionForIntentKey(previousIntentKey: string | null, nextIntentKey: string): boolean;
-export declare function useStripeOneTimeCheckoutSession({ runtimeConfigRevisionId, paymentProfileId, provider, analyticsMetadata, checkoutAnalytics, checkoutMode, couponId, customerEmail, enabled, onError, plan, returnUrl, runtimeConfig, stripePublishableKey, stripeLocale, userId, }: StripeOneTimeCheckoutSessionInput): StripeOneTimeCheckoutSession;
+export declare function useStripeOneTimeCheckoutSession({ runtimeConfigRevisionId: nextRuntimeConfigRevisionId, paymentProfileId: nextPaymentProfileId, provider: nextProvider, analyticsMetadata, checkoutAnalytics, checkoutMode: nextCheckoutMode, couponId, customerEmail, enabled, onError, onPreparationStart, onReset, plan, returnUrl, runtimeConfig: nextRuntimeConfig, stripePublishableKey: nextStripePublishableKey, stripeLocale, userId, }: StripeOneTimeCheckoutSessionInput): StripeOneTimeCheckoutSession;

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

@@ -71,8 +71,20 @@ export function buildStripeOneTimeCheckoutIntentKey({ runtimeConfigRevisionId, p
 export function shouldResetStripeOneTimeCheckoutSessionForIntentKey(previousIntentKey, nextIntentKey) {
     return previousIntentKey !== null && previousIntentKey !== nextIntentKey;
 }
-export function useStripeOneTimeCheckoutSession({ runtimeConfigRevisionId, paymentProfileId, provider, analyticsMetadata, checkoutAnalytics, checkoutMode, couponId, customerEmail, enabled = true, onError, plan, returnUrl, runtimeConfig, stripePublishableKey, stripeLocale, userId, }) {
-    var _a, _b, _c;
+export function useStripeOneTimeCheckoutSession({ runtimeConfigRevisionId: nextRuntimeConfigRevisionId, paymentProfileId: nextPaymentProfileId, provider: nextProvider, analyticsMetadata, checkoutAnalytics, checkoutMode: nextCheckoutMode, couponId, customerEmail, enabled = true, onError, onPreparationStart, onReset, plan, returnUrl, runtimeConfig: nextRuntimeConfig, stripePublishableKey: nextStripePublishableKey, stripeLocale, userId, }) {
+    var _a, _b, _c, _d, _e;
+    const preparedSelectionRef = useRef(null);
+    const nextSelection = {
+        checkoutMode: nextCheckoutMode,
+        runtimeConfig: nextRuntimeConfig,
+        runtimeConfigRevisionId: nextRuntimeConfigRevisionId,
+        paymentProfileId: nextPaymentProfileId,
+        provider: nextProvider,
+        stripePublishableKey: nextStripePublishableKey,
+    };
+    const latestSelectionRef = useRef(nextSelection);
+    latestSelectionRef.current = nextSelection;
+    const { checkoutMode, runtimeConfig, runtimeConfigRevisionId, paymentProfileId, provider, stripePublishableKey, } = (_a = preparedSelectionRef.current) !== null && _a !== void 0 ? _a : nextSelection;
     const [clientSecret, setClientSecret] = useState(null);
     const [clientSecretIntentKey, setClientSecretIntentKey] = useState(null);
     const [checkoutSessionId, setCheckoutSessionId] = useState(null);
@@ -106,9 +118,10 @@ export function useStripeOneTimeCheckoutSession({ runtimeConfigRevisionId, payme
         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 : '',
+        (_b = plan === null || plan === void 0 ? void 0 : plan.offerSetId) !== null && _b !== void 0 ? _b : '',
+        (_c = plan === null || plan === void 0 ? void 0 : plan.id) !== null && _c !== void 0 ? _c : '',
+        (_d = plan === null || plan === void 0 ? void 0 : plan.providerPlanId) !== null && _d !== void 0 ? _d : '',
+        (_e = plan === null || plan === void 0 ? void 0 : plan.amountCents) !== null && _e !== void 0 ? _e : '',
     ].join('|');
     const activeClientSecret = clientSecretIntentKey === intentKey ? clientSecret : null;
     const activeCheckoutSessionId = clientSecretIntentKey === intentKey ? checkoutSessionId : null;
@@ -139,12 +152,17 @@ export function useStripeOneTimeCheckoutSession({ runtimeConfigRevisionId, payme
         onError === null || onError === void 0 ? void 0 : onError(message);
     }, [clearActiveCheckoutSession, onError]);
     const reset = useCallback(() => {
+        preparedSelectionRef.current = null;
         attemptRef.current = null;
         clearActiveCheckoutSession();
         setLoading(createEmptyCheckoutPreparationLoading());
         setRuntimeStripePublishableKey(null);
         setError(null);
     }, [clearActiveCheckoutSession, setError]);
+    const releaseAndReset = useCallback(() => {
+        reset();
+        onReset === null || onReset === void 0 ? void 0 : onReset();
+    }, [onReset, reset]);
     useIsomorphicLayoutEffect(() => {
         const previousIntentKey = previousIntentKeyRef.current;
         previousIntentKeyRef.current = intentKey;
@@ -278,9 +296,12 @@ export function useStripeOneTimeCheckoutSession({ runtimeConfigRevisionId, payme
         userId,
     ]);
     const prepareCheckout = useCallback(async (source, options = {}) => {
+        var _a;
         if (!configured || !plan) {
             return null;
         }
+        onPreparationStart === null || onPreparationStart === void 0 ? void 0 : onPreparationStart();
+        (_a = preparedSelectionRef.current) !== null && _a !== void 0 ? _a : (preparedSelectionRef.current = latestSelectionRef.current);
         if (!options.forceNew && activeClientSecret) {
             return activeClientSecret;
         }
@@ -297,6 +318,7 @@ export function useStripeOneTimeCheckoutSession({ runtimeConfigRevisionId, payme
         configured,
         createCheckoutSession,
         plan,
+        onPreparationStart,
         setError,
         setSourceLoading,
     ]);
@@ -314,7 +336,7 @@ export function useStripeOneTimeCheckoutSession({ runtimeConfigRevisionId, payme
         prepareCardCheckout,
         prepareWalletCheckout,
         provider: 'stripe',
-        reset,
+        reset: releaseAndReset,
         restartCardCheckout,
         restartWalletCheckout,
         planKey,
@@ -330,7 +352,7 @@ export function useStripeOneTimeCheckoutSession({ runtimeConfigRevisionId, payme
         planKey,
         prepareCardCheckout,
         prepareWalletCheckout,
-        reset,
+        releaseAndReset,
         restartCardCheckout,
         restartWalletCheckout,
         setError,

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

@@ -13,6 +13,8 @@ export type StripeSubscriptionCheckoutSessionInput = {
     customerEmail?: string | null;
     displayPlan?: PaywallDisplayPlan | null;
     enabled?: boolean;
+    onPreparationStart?: () => void;
+    onReset?: () => void;
     onError?: (message: string | null) => void;
     plan?: PaywallPlan | null;
     returnUrl: string;
@@ -59,4 +61,4 @@ export declare function shouldResetStripeSubscriptionCheckoutSessionForIntentKey
 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, stripeLocale, userId, }: StripeSubscriptionCheckoutSessionInput): StripeSubscriptionCheckoutSession;
+export declare function useStripeSubscriptionCheckoutSession({ checkoutMode: nextCheckoutMode, analyticsMetadata, checkoutAnalytics, couponId, customerEmail, displayPlan, enabled, onError, onPreparationStart, onReset, plan, returnUrl, runtimeConfig: nextRuntimeConfig, runtimeConfigRevisionId: nextRuntimeConfigRevisionId, paymentProfileId: nextPaymentProfileId, provider: nextProvider, stripePublishableKey: nextStripePublishableKey, stripeLocale, userId, }: StripeSubscriptionCheckoutSessionInput): StripeSubscriptionCheckoutSession;

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

@@ -71,8 +71,20 @@ export function shouldAutoRecoverStripeSubscriptionCheckoutSession(message, alre
     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, stripeLocale, userId, }) {
-    var _a, _b, _c, _d, _e;
+export function useStripeSubscriptionCheckoutSession({ checkoutMode: nextCheckoutMode, analyticsMetadata, checkoutAnalytics, couponId, customerEmail, displayPlan, enabled = true, onError, onPreparationStart, onReset, plan, returnUrl, runtimeConfig: nextRuntimeConfig, runtimeConfigRevisionId: nextRuntimeConfigRevisionId, paymentProfileId: nextPaymentProfileId, provider: nextProvider, stripePublishableKey: nextStripePublishableKey, stripeLocale, userId, }) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const preparedSelectionRef = useRef(null);
+    const nextSelection = {
+        checkoutMode: nextCheckoutMode,
+        runtimeConfig: nextRuntimeConfig,
+        runtimeConfigRevisionId: nextRuntimeConfigRevisionId,
+        paymentProfileId: nextPaymentProfileId,
+        provider: nextProvider,
+        stripePublishableKey: nextStripePublishableKey,
+    };
+    const latestSelectionRef = useRef(nextSelection);
+    latestSelectionRef.current = nextSelection;
+    const { checkoutMode, runtimeConfig, runtimeConfigRevisionId, paymentProfileId, provider, stripePublishableKey, } = (_a = preparedSelectionRef.current) !== null && _a !== void 0 ? _a : nextSelection;
     const [clientSecret, setClientSecret] = useState(null);
     const [clientSecretIntentKey, setClientSecretIntentKey] = useState(null);
     const [checkoutSessionId, setCheckoutSessionId] = useState(null);
@@ -97,11 +109,12 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
             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 : '',
+        (_b = plan === null || plan === void 0 ? void 0 : plan.offerSetId) !== null && _b !== void 0 ? _b : '',
+        (_c = plan === null || plan === void 0 ? void 0 : plan.id) !== null && _c !== void 0 ? _c : '',
+        (_d = plan === null || plan === void 0 ? void 0 : plan.providerPlanId) !== null && _d !== void 0 ? _d : '',
+        (_e = plan === null || plan === void 0 ? void 0 : plan.amountCents) !== null && _e !== void 0 ? _e : '',
+        (_f = displayPlan === null || displayPlan === void 0 ? void 0 : displayPlan.id) !== null && _f !== void 0 ? _f : '',
+        (_g = displayPlan === null || displayPlan === void 0 ? void 0 : displayPlan.amountCents) !== null && _g !== void 0 ? _g : '',
     ].join('|');
     const intentKey = buildStripeSubscriptionCheckoutIntentKey({
         checkoutMode,
@@ -153,6 +166,7 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
         onError === null || onError === void 0 ? void 0 : onError(message);
     }, [clearActiveCheckoutSession, intentKey, onError]);
     const reset = useCallback(() => {
+        preparedSelectionRef.current = null;
         attemptRef.current = null;
         recoveredIntentKeyRef.current = null;
         handledRecoveryRequestRef.current = recoveryRequest;
@@ -161,6 +175,10 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
         setRuntimeStripePublishableKey(null);
         setError(null);
     }, [clearActiveCheckoutSession, recoveryRequest, setError]);
+    const releaseAndReset = useCallback(() => {
+        reset();
+        onReset === null || onReset === void 0 ? void 0 : onReset();
+    }, [onReset, reset]);
     useIsomorphicLayoutEffect(() => {
         const previousIntentKey = previousIntentKeyRef.current;
         previousIntentKeyRef.current = intentKey;
@@ -300,9 +318,12 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
         userId,
     ]);
     const prepareCheckout = useCallback(async (source, options = {}) => {
+        var _a;
         if (!configured || !plan || !displayPlan) {
             return null;
         }
+        onPreparationStart === null || onPreparationStart === void 0 ? void 0 : onPreparationStart();
+        (_a = preparedSelectionRef.current) !== null && _a !== void 0 ? _a : (preparedSelectionRef.current = latestSelectionRef.current);
         if (!options.forceNew && activeClientSecret) {
             return activeClientSecret;
         }
@@ -320,6 +341,7 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
         createCheckoutSubscription,
         displayPlan,
         plan,
+        onPreparationStart,
         setError,
         setSourceLoading,
     ]);
@@ -416,7 +438,7 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
         prepareCardCheckout,
         prepareWalletCheckout,
         provider: 'stripe',
-        reset,
+        reset: releaseAndReset,
         restartCardCheckout,
         restartWalletCheckout,
         planKey,
@@ -434,7 +456,7 @@ export function useStripeSubscriptionCheckoutSession({ checkoutMode, analyticsMe
         planKey,
         prepareCardCheckout,
         prepareWalletCheckout,
-        reset,
+        releaseAndReset,
         restartCardCheckout,
         restartWalletCheckout,
         setError,

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

@@ -3,6 +3,13 @@ export declare const toOneTimeCheckoutRequest: (input: CreateOneTimeCheckoutInpu
     environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
     runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
     checkoutIdentityToken: string;
+    couponId: string | undefined;
+    analyticsMetadata: Record<string, unknown> | undefined;
+    customerEmail: string | undefined;
+    returnUrl: string;
+    userId: string | undefined;
+    currency?: string | undefined;
+    money?: import("@funnelsgrove/runtime").ProviderMoney | undefined;
     planKey: string;
     runtimeConfigRevisionId: string | null | undefined;
     paymentProfileId: string | null | undefined;
@@ -16,15 +23,17 @@ export declare const toOneTimeCheckoutRequest: (input: CreateOneTimeCheckoutInpu
     title: string;
     description: string | undefined;
     amountCents: number;
+} | {
+    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
+    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+    checkoutIdentityToken?: undefined;
     couponId: string | undefined;
     analyticsMetadata: Record<string, unknown> | undefined;
     customerEmail: string | undefined;
     returnUrl: string;
     userId: string | undefined;
-} | {
-    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
-    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
-    checkoutIdentityToken?: undefined;
+    currency?: string | undefined;
+    money?: import("@funnelsgrove/runtime").ProviderMoney | undefined;
     planKey: string;
     runtimeConfigRevisionId: string | null | undefined;
     paymentProfileId: string | null | undefined;
@@ -38,29 +47,11 @@ export declare const toOneTimeCheckoutRequest: (input: CreateOneTimeCheckoutInpu
     title: string;
     description: string | undefined;
     amountCents: number;
-    couponId: string | undefined;
-    analyticsMetadata: Record<string, unknown> | undefined;
-    customerEmail: string | undefined;
-    returnUrl: string;
-    userId: string | undefined;
 };
 export declare const toSubscriptionCheckoutRequest: (input: CreateSubscriptionCheckoutInput) => {
     environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
     runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
     checkoutIdentityToken: string;
-    offerSetId: string | undefined;
-    offerSetKey: string | undefined;
-    planId: string;
-    planKey: string;
-    providerPlanId: string | undefined;
-    provider: "stripe" | null | undefined;
-    paymentProfileId: string | undefined;
-    runtimeConfigRevisionId: string | undefined;
-    anonymousUserId: string | undefined;
-    idempotencyKey: string | undefined;
-    title: string;
-    description: string | undefined;
-    amountCents: number;
     billingInterval: import("../../../../index.js").BillingPlanInterval;
     billingIntervalCount: number;
     followUpProviderPlanId: string | undefined;
@@ -73,10 +64,8 @@ export declare const toSubscriptionCheckoutRequest: (input: CreateSubscriptionCh
     customerEmail: string | undefined;
     returnUrl: string;
     userId: string | undefined;
-} | {
-    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
-    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
-    checkoutIdentityToken?: undefined;
+    currency?: string | undefined;
+    money?: import("@funnelsgrove/runtime").ProviderMoney | undefined;
     offerSetId: string | undefined;
     offerSetKey: string | undefined;
     planId: string;
@@ -90,6 +79,10 @@ export declare const toSubscriptionCheckoutRequest: (input: CreateSubscriptionCh
     title: string;
     description: string | undefined;
     amountCents: number;
+} | {
+    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
+    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+    checkoutIdentityToken?: undefined;
     billingInterval: import("../../../../index.js").BillingPlanInterval;
     billingIntervalCount: number;
     followUpProviderPlanId: string | undefined;
@@ -102,9 +95,8 @@ export declare const toSubscriptionCheckoutRequest: (input: CreateSubscriptionCh
     customerEmail: string | undefined;
     returnUrl: string;
     userId: string | undefined;
-};
-export declare const toSubscriptionCheckoutPlanRequest: (input: UpdateSubscriptionCheckoutPlanInput) => {
-    checkoutSessionId: string;
+    currency?: string | undefined;
+    money?: import("@funnelsgrove/runtime").ProviderMoney | undefined;
     offerSetId: string | undefined;
     offerSetKey: string | undefined;
     planId: string;
@@ -113,9 +105,13 @@ export declare const toSubscriptionCheckoutPlanRequest: (input: UpdateSubscripti
     provider: "stripe" | null | undefined;
     paymentProfileId: string | undefined;
     runtimeConfigRevisionId: string | undefined;
+    anonymousUserId: string | undefined;
+    idempotencyKey: string | undefined;
     title: string;
     description: string | undefined;
     amountCents: number;
+};
+export declare const toSubscriptionCheckoutPlanRequest: (input: UpdateSubscriptionCheckoutPlanInput) => {
     billingInterval: import("../../../../index.js").BillingPlanInterval;
     billingIntervalCount: number;
     followUpProviderPlanId: string | undefined;
@@ -129,6 +125,20 @@ export declare const toSubscriptionCheckoutPlanRequest: (input: UpdateSubscripti
     userId: string | undefined;
     environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
     runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+    currency?: string | undefined;
+    money?: import("@funnelsgrove/runtime").ProviderMoney | undefined;
+    checkoutSessionId: string;
+    offerSetId: string | undefined;
+    offerSetKey: string | undefined;
+    planId: string;
+    planKey: string;
+    providerPlanId: string | undefined;
+    provider: "stripe" | null | undefined;
+    paymentProfileId: string | undefined;
+    runtimeConfigRevisionId: string | undefined;
+    title: string;
+    description: string | undefined;
+    amountCents: number;
 };
 export declare const toSubscriptionCheckoutStatusRequest: (input: VerifySubscriptionCheckoutPaymentInput) => {
     checkoutSessionId: string;

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

@@ -8,44 +8,24 @@ const toCheckoutIdentityRequestFields = (userId) => {
     return checkoutIdentityToken ? { checkoutIdentityToken } : {};
 };
 export const toOneTimeCheckoutRequest = (input) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
-    return Object.assign(Object.assign({ planKey: ((_a = input.plan.funnelPlanKey) === null || _a === void 0 ? void 0 : _a.trim()) || input.plan.id, runtimeConfigRevisionId: input.runtimeConfigRevisionId, paymentProfileId: input.paymentProfileId, provider: input.provider, anonymousUserId: input.anonymousUserId, idempotencyKey: input.idempotencyKey, offerSetId: ((_b = input.plan.offerSetId) === null || _b === void 0 ? void 0 : _b.trim()) || undefined, offerSetKey: ((_c = input.plan.offerSetKey) === null || _c === void 0 ? void 0 : _c.trim()) || undefined, planId: getPaywallPlanRequestId(input.plan), providerPlanId: ((_d = input.plan.providerPlanId) === null || _d === void 0 ? void 0 : _d.trim()) || undefined, title: input.plan.title, description: ((_e = input.plan.description) === null || _e === void 0 ? void 0 : _e.trim()) || undefined, amountCents: input.plan.amountCents, couponId: ((_f = input.couponId) === null || _f === void 0 ? void 0 : _f.trim()) || undefined, analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan), customerEmail: ((_g = input.customerEmail) === null || _g === void 0 ? void 0 : _g.trim()) || undefined, returnUrl: input.returnUrl, userId: ((_h = input.user_id) === null || _h === void 0 ? void 0 : _h.trim()) || undefined }, toCheckoutIdentityRequestFields(input.user_id)), { environment: input.environment, runtimeConfig: input.runtimeConfig });
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ planKey: ((_a = input.plan.funnelPlanKey) === null || _a === void 0 ? void 0 : _a.trim()) || input.plan.id, runtimeConfigRevisionId: input.runtimeConfigRevisionId, paymentProfileId: input.paymentProfileId, provider: input.provider, anonymousUserId: input.anonymousUserId, idempotencyKey: input.idempotencyKey, offerSetId: ((_b = input.plan.offerSetId) === null || _b === void 0 ? void 0 : _b.trim()) || undefined, offerSetKey: ((_c = input.plan.offerSetKey) === null || _c === void 0 ? void 0 : _c.trim()) || undefined, planId: getPaywallPlanRequestId(input.plan), providerPlanId: ((_d = input.plan.providerPlanId) === null || _d === void 0 ? void 0 : _d.trim()) || undefined, title: input.plan.title, description: ((_e = input.plan.description) === null || _e === void 0 ? void 0 : _e.trim()) || undefined, amountCents: input.plan.amountCents }, (input.plan.money ? { money: input.plan.money } : {})), (((_f = input.plan.money) === null || _f === void 0 ? void 0 : _f.currency) || input.plan.currency
+        ? { currency: (_h = (_g = input.plan.money) === null || _g === void 0 ? void 0 : _g.currency) !== null && _h !== void 0 ? _h : input.plan.currency }
+        : {})), { couponId: ((_j = input.couponId) === null || _j === void 0 ? void 0 : _j.trim()) || undefined, analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan), customerEmail: ((_k = input.customerEmail) === null || _k === void 0 ? void 0 : _k.trim()) || undefined, returnUrl: input.returnUrl, userId: ((_l = input.user_id) === null || _l === void 0 ? void 0 : _l.trim()) || undefined }), toCheckoutIdentityRequestFields(input.user_id)), { environment: input.environment, runtimeConfig: input.runtimeConfig });
 };
 export const toSubscriptionCheckoutRequest = (input) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
     const recurring = requireCheckoutRecurringConfig(input.plan);
-    return Object.assign(Object.assign({ offerSetId: ((_a = input.plan.offerSetId) === null || _a === void 0 ? void 0 : _a.trim()) || undefined, offerSetKey: ((_b = input.plan.offerSetKey) === null || _b === void 0 ? void 0 : _b.trim()) || undefined, planId: getPaywallPlanRequestId(input.plan), planKey: ((_c = input.plan.funnelPlanKey) === null || _c === void 0 ? void 0 : _c.trim()) || input.plan.id, providerPlanId: ((_d = input.plan.providerPlanId) === null || _d === void 0 ? void 0 : _d.trim()) || undefined, provider: input.provider, paymentProfileId: ((_e = input.paymentProfileId) === null || _e === void 0 ? void 0 : _e.trim()) || undefined, runtimeConfigRevisionId: ((_f = input.runtimeConfigRevisionId) === null || _f === void 0 ? void 0 : _f.trim()) || undefined, anonymousUserId: ((_g = input.anonymousUserId) === null || _g === void 0 ? void 0 : _g.trim()) || undefined, idempotencyKey: ((_h = input.idempotencyKey) === null || _h === void 0 ? void 0 : _h.trim()) || undefined, title: input.plan.title, description: ((_j = input.plan.description) === null || _j === void 0 ? void 0 : _j.trim()) || undefined, amountCents: input.plan.amountCents, billingInterval: recurring.interval, billingIntervalCount: recurring.intervalCount, followUpProviderPlanId: ((_k = input.plan.followUpProviderPlanId) === null || _k === void 0 ? void 0 : _k.trim()) || undefined, followUpPlanTitle: ((_l = input.plan.followUpPlanTitle) === null || _l === void 0 ? void 0 : _l.trim()) || undefined, followUpBillingInterval: input.plan.followUpBillingInterval, followUpBillingIntervalCount: input.plan.followUpBillingIntervalCount, introIterations: input.plan.introIterations, couponId: ((_m = input.couponId) === null || _m === void 0 ? void 0 : _m.trim()) || undefined, analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan), customerEmail: ((_o = input.customerEmail) === null || _o === void 0 ? void 0 : _o.trim()) || undefined, returnUrl: input.returnUrl, userId: ((_p = input.user_id) === null || _p === void 0 ? void 0 : _p.trim()) || undefined }, toCheckoutIdentityRequestFields(input.user_id)), { environment: input.environment, runtimeConfig: input.runtimeConfig });
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ offerSetId: ((_a = input.plan.offerSetId) === null || _a === void 0 ? void 0 : _a.trim()) || undefined, offerSetKey: ((_b = input.plan.offerSetKey) === null || _b === void 0 ? void 0 : _b.trim()) || undefined, planId: getPaywallPlanRequestId(input.plan), planKey: ((_c = input.plan.funnelPlanKey) === null || _c === void 0 ? void 0 : _c.trim()) || input.plan.id, providerPlanId: ((_d = input.plan.providerPlanId) === null || _d === void 0 ? void 0 : _d.trim()) || undefined, provider: input.provider, paymentProfileId: ((_e = input.paymentProfileId) === null || _e === void 0 ? void 0 : _e.trim()) || undefined, runtimeConfigRevisionId: ((_f = input.runtimeConfigRevisionId) === null || _f === void 0 ? void 0 : _f.trim()) || undefined, anonymousUserId: ((_g = input.anonymousUserId) === null || _g === void 0 ? void 0 : _g.trim()) || undefined, idempotencyKey: ((_h = input.idempotencyKey) === null || _h === void 0 ? void 0 : _h.trim()) || undefined, title: input.plan.title, description: ((_j = input.plan.description) === null || _j === void 0 ? void 0 : _j.trim()) || undefined, amountCents: input.plan.amountCents }, (input.plan.money ? { money: input.plan.money } : {})), (((_k = input.plan.money) === null || _k === void 0 ? void 0 : _k.currency) || input.plan.currency
+        ? { currency: (_m = (_l = input.plan.money) === null || _l === void 0 ? void 0 : _l.currency) !== null && _m !== void 0 ? _m : input.plan.currency }
+        : {})), { billingInterval: recurring.interval, billingIntervalCount: recurring.intervalCount, followUpProviderPlanId: ((_o = input.plan.followUpProviderPlanId) === null || _o === void 0 ? void 0 : _o.trim()) || undefined, followUpPlanTitle: ((_p = input.plan.followUpPlanTitle) === null || _p === void 0 ? void 0 : _p.trim()) || undefined, followUpBillingInterval: input.plan.followUpBillingInterval, followUpBillingIntervalCount: input.plan.followUpBillingIntervalCount, introIterations: input.plan.introIterations, couponId: ((_q = input.couponId) === null || _q === void 0 ? void 0 : _q.trim()) || undefined, analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan), customerEmail: ((_r = input.customerEmail) === null || _r === void 0 ? void 0 : _r.trim()) || undefined, returnUrl: input.returnUrl, userId: ((_s = input.user_id) === null || _s === void 0 ? void 0 : _s.trim()) || undefined }), toCheckoutIdentityRequestFields(input.user_id)), { environment: input.environment, runtimeConfig: input.runtimeConfig });
 };
 export const toSubscriptionCheckoutPlanRequest = (input) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
     const recurring = requireCheckoutRecurringConfig(input.plan);
-    return {
-        checkoutSessionId: input.checkoutSessionId.trim(),
-        offerSetId: ((_a = input.plan.offerSetId) === null || _a === void 0 ? void 0 : _a.trim()) || undefined,
-        offerSetKey: ((_b = input.plan.offerSetKey) === null || _b === void 0 ? void 0 : _b.trim()) || undefined,
-        planId: getPaywallPlanRequestId(input.plan),
-        planKey: ((_c = input.plan.funnelPlanKey) === null || _c === void 0 ? void 0 : _c.trim()) || input.plan.id,
-        providerPlanId: ((_d = input.plan.providerPlanId) === null || _d === void 0 ? void 0 : _d.trim()) || undefined,
-        provider: input.provider,
-        paymentProfileId: ((_e = input.paymentProfileId) === null || _e === void 0 ? void 0 : _e.trim()) || undefined,
-        runtimeConfigRevisionId: ((_f = input.runtimeConfigRevisionId) === null || _f === void 0 ? void 0 : _f.trim()) || undefined,
-        title: input.plan.title,
-        description: ((_g = input.plan.description) === null || _g === void 0 ? void 0 : _g.trim()) || undefined,
-        amountCents: input.plan.amountCents,
-        billingInterval: recurring.interval,
-        billingIntervalCount: recurring.intervalCount,
-        followUpProviderPlanId: ((_h = input.plan.followUpProviderPlanId) === null || _h === void 0 ? void 0 : _h.trim()) || undefined,
-        followUpPlanTitle: ((_j = input.plan.followUpPlanTitle) === null || _j === void 0 ? void 0 : _j.trim()) || undefined,
-        followUpBillingInterval: input.plan.followUpBillingInterval,
-        followUpBillingIntervalCount: input.plan.followUpBillingIntervalCount,
-        introIterations: input.plan.introIterations,
-        couponId: ((_k = input.couponId) === null || _k === void 0 ? void 0 : _k.trim()) || undefined,
-        analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan),
-        customerEmail: ((_l = input.customerEmail) === null || _l === void 0 ? void 0 : _l.trim()) || undefined,
-        userId: ((_m = input.user_id) === null || _m === void 0 ? void 0 : _m.trim()) || undefined,
-        environment: input.environment,
-        runtimeConfig: input.runtimeConfig,
-    };
+    return Object.assign(Object.assign(Object.assign({ checkoutSessionId: input.checkoutSessionId.trim(), offerSetId: ((_a = input.plan.offerSetId) === null || _a === void 0 ? void 0 : _a.trim()) || undefined, offerSetKey: ((_b = input.plan.offerSetKey) === null || _b === void 0 ? void 0 : _b.trim()) || undefined, planId: getPaywallPlanRequestId(input.plan), planKey: ((_c = input.plan.funnelPlanKey) === null || _c === void 0 ? void 0 : _c.trim()) || input.plan.id, providerPlanId: ((_d = input.plan.providerPlanId) === null || _d === void 0 ? void 0 : _d.trim()) || undefined, provider: input.provider, paymentProfileId: ((_e = input.paymentProfileId) === null || _e === void 0 ? void 0 : _e.trim()) || undefined, runtimeConfigRevisionId: ((_f = input.runtimeConfigRevisionId) === null || _f === void 0 ? void 0 : _f.trim()) || undefined, title: input.plan.title, description: ((_g = input.plan.description) === null || _g === void 0 ? void 0 : _g.trim()) || undefined, amountCents: input.plan.amountCents }, (input.plan.money ? { money: input.plan.money } : {})), (((_h = input.plan.money) === null || _h === void 0 ? void 0 : _h.currency) || input.plan.currency
+        ? { currency: (_k = (_j = input.plan.money) === null || _j === void 0 ? void 0 : _j.currency) !== null && _k !== void 0 ? _k : input.plan.currency }
+        : {})), { billingInterval: recurring.interval, billingIntervalCount: recurring.intervalCount, followUpProviderPlanId: ((_l = input.plan.followUpProviderPlanId) === null || _l === void 0 ? void 0 : _l.trim()) || undefined, followUpPlanTitle: ((_m = input.plan.followUpPlanTitle) === null || _m === void 0 ? void 0 : _m.trim()) || undefined, followUpBillingInterval: input.plan.followUpBillingInterval, followUpBillingIntervalCount: input.plan.followUpBillingIntervalCount, introIterations: input.plan.introIterations, couponId: ((_o = input.couponId) === null || _o === void 0 ? void 0 : _o.trim()) || undefined, analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan), customerEmail: ((_p = input.customerEmail) === null || _p === void 0 ? void 0 : _p.trim()) || undefined, userId: ((_q = input.user_id) === null || _q === void 0 ? void 0 : _q.trim()) || undefined, environment: input.environment, runtimeConfig: input.runtimeConfig });
 };
 export const toSubscriptionCheckoutStatusRequest = (input) => {
     const checkoutSessionId = requireCheckoutSessionId(input.checkoutSessionId);

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

@@ -1,9 +1,10 @@
 import type { FunnelStepType, RuntimeMode } from '@funnelsgrove/runtime';
+import { type PublicAnalyticsFeatureFlags } from '@funnelsgrove/analytics';
 import type { StripeRuntimeConfigOverrides } from './shared/types.js';
 import type { ChargeOneClickPaymentResponse, CompleteStripeOneClickPaymentInput } from './oneClick/types.js';
 export type StripeSubscriptionCheckoutAnalyticsContext = {
     environment?: RuntimeMode;
-    featureFlags?: Record<string, string | null | undefined>;
+    featureFlags?: PublicAnalyticsFeatureFlags;
     metadata?: Record<string, unknown> | null;
     runtimeConfig?: StripeRuntimeConfigOverrides;
     stepId: string;

package/dist/providers/stripe/services/checkoutCompletionAnalytics.service.js

@@ -176,7 +176,7 @@ export async function trackPaidStripeSubscriptionCheckoutCompleted(input) {
     }
 }
 export async function trackPaidStripeOneClickPaymentCompleted(input, payment) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
     const context = input.checkoutAnalytics;
     const paymentIntentId = (_a = payment.paymentIntentId) === null || _a === void 0 ? void 0 : _a.trim();
     if (!context || payment.status !== 'succeeded' || !paymentIntentId) {
@@ -202,7 +202,7 @@ export async function trackPaidStripeOneClickPaymentCompleted(input, payment) {
             stepContractVersion: context.stepContractVersion,
             featureFlags: context.featureFlags,
             metadata: Object.assign(Object.assign(Object.assign({}, asRecord(input.analyticsMetadata)), asRecord(context.metadata)), { userId,
-                environment, amountCents: (_g = payment.amountCents) !== null && _g !== void 0 ? _g : input.amountCents, currency: (_j = (_h = payment.currency) !== null && _h !== void 0 ? _h : input.currency) !== null && _j !== void 0 ? _j : 'usd', planId: input.planId, providerPlanId: input.providerPlanId, payment_provider: 'stripe' }),
+                environment, amountCents: (_g = payment.amountCents) !== null && _g !== void 0 ? _g : input.amountCents, money: (_h = payment.money) !== null && _h !== void 0 ? _h : input.money, currency: (_o = (_l = (_k = (_j = payment.money) === null || _j === void 0 ? void 0 : _j.currency) !== null && _k !== void 0 ? _k : payment.currency) !== null && _l !== void 0 ? _l : (_m = input.money) === null || _m === void 0 ? void 0 : _m.currency) !== null && _o !== void 0 ? _o : input.currency, planId: input.planId, providerPlanId: input.providerPlanId, payment_provider: 'stripe' }),
         });
         if (eventId) {
             markCheckoutSessionTracked('checkout_completed', paymentIntentId, runtimeConfig);

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

@@ -1,5 +1,17 @@
 import type { CreateCheckoutSessionInput } from './types.js';
 export declare const toHostedCheckoutRequest: (input: CreateCheckoutSessionInput) => {
+    billingInterval: import("../../../../index.js").BillingPlanInterval;
+    billingIntervalCount: number;
+    couponId: string | undefined;
+    analyticsMetadata: Record<string, unknown> | undefined;
+    successUrl: string;
+    cancelUrl: string;
+    customerEmail: string | undefined;
+    userId: string | undefined;
+    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
+    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+    currency?: string | undefined;
+    money?: import("@funnelsgrove/runtime").ProviderMoney | undefined;
     planKey: string;
     paymentProfileId: string | null | undefined;
     provider: "stripe" | null | undefined;
@@ -14,14 +26,4 @@ export declare const toHostedCheckoutRequest: (input: CreateCheckoutSessionInput
     title: string;
     description: string | undefined;
     amountCents: number;
-    billingInterval: import("../../../../index.js").BillingPlanInterval;
-    billingIntervalCount: number;
-    couponId: string | undefined;
-    analyticsMetadata: Record<string, unknown> | undefined;
-    successUrl: string;
-    cancelUrl: string;
-    customerEmail: string | undefined;
-    userId: string | undefined;
-    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
-    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
 };

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

@@ -2,32 +2,9 @@ import { requireCheckoutRecurringConfig } from '../shared/checkout.validator.js'
 import { getPaywallPlanRequestId } from '../../../../services/paywallPlans/selection.js';
 import { normalizeCheckoutAnalyticsMetadata } from '../shared/checkoutMetadata.js';
 export const toHostedCheckoutRequest = (input) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
     const recurring = requireCheckoutRecurringConfig(input.plan);
-    return {
-        planKey: ((_a = input.plan.funnelPlanKey) === null || _a === void 0 ? void 0 : _a.trim()) || input.plan.id,
-        paymentProfileId: input.paymentProfileId,
-        provider: input.provider,
-        runtimeConfigRevisionId: input.runtimeConfigRevisionId,
-        anonymousUserId: input.anonymousUserId,
-        checkoutIdentityToken: input.checkoutIdentityToken,
-        idempotencyKey: input.idempotencyKey,
-        offerSetId: ((_b = input.plan.offerSetId) === null || _b === void 0 ? void 0 : _b.trim()) || undefined,
-        offerSetKey: ((_c = input.plan.offerSetKey) === null || _c === void 0 ? void 0 : _c.trim()) || undefined,
-        planId: getPaywallPlanRequestId(input.plan),
-        providerPlanId: ((_d = input.plan.providerPlanId) === null || _d === void 0 ? void 0 : _d.trim()) || undefined,
-        title: input.plan.title,
-        description: ((_e = input.plan.description) === null || _e === void 0 ? void 0 : _e.trim()) || undefined,
-        amountCents: input.plan.amountCents,
-        billingInterval: recurring.interval,
-        billingIntervalCount: recurring.intervalCount,
-        couponId: ((_f = input.couponId) === null || _f === void 0 ? void 0 : _f.trim()) || undefined,
-        analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan),
-        successUrl: input.successUrl,
-        cancelUrl: input.cancelUrl,
-        customerEmail: ((_g = input.customerEmail) === null || _g === void 0 ? void 0 : _g.trim()) || undefined,
-        userId: ((_h = input.user_id) === null || _h === void 0 ? void 0 : _h.trim()) || undefined,
-        environment: input.environment,
-        runtimeConfig: input.runtimeConfig,
-    };
+    return Object.assign(Object.assign(Object.assign({ planKey: ((_a = input.plan.funnelPlanKey) === null || _a === void 0 ? void 0 : _a.trim()) || input.plan.id, paymentProfileId: input.paymentProfileId, provider: input.provider, runtimeConfigRevisionId: input.runtimeConfigRevisionId, anonymousUserId: input.anonymousUserId, checkoutIdentityToken: input.checkoutIdentityToken, idempotencyKey: input.idempotencyKey, offerSetId: ((_b = input.plan.offerSetId) === null || _b === void 0 ? void 0 : _b.trim()) || undefined, offerSetKey: ((_c = input.plan.offerSetKey) === null || _c === void 0 ? void 0 : _c.trim()) || undefined, planId: getPaywallPlanRequestId(input.plan), providerPlanId: ((_d = input.plan.providerPlanId) === null || _d === void 0 ? void 0 : _d.trim()) || undefined, title: input.plan.title, description: ((_e = input.plan.description) === null || _e === void 0 ? void 0 : _e.trim()) || undefined, amountCents: input.plan.amountCents }, (input.plan.money ? { money: input.plan.money } : {})), (((_f = input.plan.money) === null || _f === void 0 ? void 0 : _f.currency) || input.plan.currency
+        ? { currency: (_h = (_g = input.plan.money) === null || _g === void 0 ? void 0 : _g.currency) !== null && _h !== void 0 ? _h : input.plan.currency }
+        : {})), { billingInterval: recurring.interval, billingIntervalCount: recurring.intervalCount, couponId: ((_j = input.couponId) === null || _j === void 0 ? void 0 : _j.trim()) || undefined, analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan), successUrl: input.successUrl, cancelUrl: input.cancelUrl, customerEmail: ((_k = input.customerEmail) === null || _k === void 0 ? void 0 : _k.trim()) || undefined, userId: ((_l = input.user_id) === null || _l === void 0 ? void 0 : _l.trim()) || undefined, environment: input.environment, runtimeConfig: input.runtimeConfig });
 };

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

@@ -1,13 +1,5 @@
 import type { ChargeOneClickPaymentInput } from './types.js';
 export declare const toOneClickPaymentRequest: (input: ChargeOneClickPaymentInput) => {
-    planKey: string | null | undefined;
-    offerSetId: string | null | undefined;
-    runtimeConfigRevisionId: string | null | undefined;
-    paymentProfileId: string | null | undefined;
-    provider: "stripe" | null | undefined;
-    planId: string;
-    providerPlanId: string | undefined;
-    amountCents: number;
     currency: string | undefined;
     description: string | undefined;
     analyticsMetadata: Record<string, unknown> | undefined;
@@ -17,4 +9,13 @@ export declare const toOneClickPaymentRequest: (input: ChargeOneClickPaymentInpu
     idempotencyKey: string | undefined;
     environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
     runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+    money?: import("@funnelsgrove/runtime").ProviderMoney | undefined;
+    planKey: string | null | undefined;
+    offerSetId: string | null | undefined;
+    runtimeConfigRevisionId: string | null | undefined;
+    paymentProfileId: string | null | undefined;
+    provider: "stripe" | null | undefined;
+    planId: string;
+    providerPlanId: string | undefined;
+    amountCents: number;
 };

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

@@ -1,23 +1,5 @@
 import { normalizeAnalyticsMetadata } from '../shared/checkoutMetadata.js';
 export const toOneClickPaymentRequest = (input) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-    return {
-        planKey: input.planKey,
-        offerSetId: input.offerSetId,
-        runtimeConfigRevisionId: input.runtimeConfigRevisionId,
-        paymentProfileId: input.paymentProfileId,
-        provider: input.provider,
-        planId: input.planId,
-        providerPlanId: ((_a = input.providerPlanId) === null || _a === void 0 ? void 0 : _a.trim()) || undefined,
-        amountCents: input.amountCents,
-        currency: ((_b = input.currency) === null || _b === void 0 ? void 0 : _b.trim()) || undefined,
-        description: ((_c = input.description) === null || _c === void 0 ? void 0 : _c.trim()) || undefined,
-        analyticsMetadata: normalizeAnalyticsMetadata(input.analyticsMetadata),
-        userId: ((_d = input.userId) === null || _d === void 0 ? void 0 : _d.trim()) || ((_e = input.user_id) === null || _e === void 0 ? void 0 : _e.trim()) || undefined,
-        stripeCustomerId: ((_f = input.stripeCustomerId) === null || _f === void 0 ? void 0 : _f.trim()) || ((_g = input.stripe_customer_id) === null || _g === void 0 ? void 0 : _g.trim()) || undefined,
-        checkoutSessionId: ((_h = input.checkoutSessionId) === null || _h === void 0 ? void 0 : _h.trim()) || undefined,
-        idempotencyKey: ((_j = input.idempotencyKey) === null || _j === void 0 ? void 0 : _j.trim()) || undefined,
-        environment: input.environment,
-        runtimeConfig: input.runtimeConfig,
-    };
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+    return Object.assign(Object.assign({ planKey: input.planKey, offerSetId: input.offerSetId, runtimeConfigRevisionId: input.runtimeConfigRevisionId, paymentProfileId: input.paymentProfileId, provider: input.provider, planId: input.planId, providerPlanId: ((_a = input.providerPlanId) === null || _a === void 0 ? void 0 : _a.trim()) || undefined, amountCents: input.amountCents }, (input.money ? { money: input.money } : {})), { currency: (_c = (_b = input.money) === null || _b === void 0 ? void 0 : _b.currency) !== null && _c !== void 0 ? _c : (((_d = input.currency) === null || _d === void 0 ? void 0 : _d.trim()) || undefined), description: ((_e = input.description) === null || _e === void 0 ? void 0 : _e.trim()) || undefined, analyticsMetadata: normalizeAnalyticsMetadata(input.analyticsMetadata), userId: ((_f = input.userId) === null || _f === void 0 ? void 0 : _f.trim()) || ((_g = input.user_id) === null || _g === void 0 ? void 0 : _g.trim()) || undefined, stripeCustomerId: ((_h = input.stripeCustomerId) === null || _h === void 0 ? void 0 : _h.trim()) || ((_j = input.stripe_customer_id) === null || _j === void 0 ? void 0 : _j.trim()) || undefined, checkoutSessionId: ((_k = input.checkoutSessionId) === null || _k === void 0 ? void 0 : _k.trim()) || undefined, idempotencyKey: ((_l = input.idempotencyKey) === null || _l === void 0 ? void 0 : _l.trim()) || undefined, environment: input.environment, runtimeConfig: input.runtimeConfig });
 };

package/dist/providers/stripe/services/oneClick/types.d.ts

@@ -1,4 +1,4 @@
-import type { RuntimeMode } from '@funnelsgrove/runtime';
+import type { ProviderMoney, RuntimeMode } from '@funnelsgrove/runtime';
 import type { StripeRuntimeConfigOverrides } from '../shared/types.js';
 import type { StripeSubscriptionCheckoutAnalyticsContext } from '../checkoutCompletionAnalytics.service.js';
 export type ChargeOneClickPaymentInput = {
@@ -10,6 +10,7 @@ export type ChargeOneClickPaymentInput = {
     provider?: 'stripe' | null;
     providerPlanId?: string | null;
     amountCents: number;
+    money?: ProviderMoney;
     analyticsMetadata?: Record<string, unknown> | null;
     checkoutSessionId?: string | null;
     currency?: string | null;
@@ -28,6 +29,7 @@ export type ChargeOneClickPaymentResponse = {
     paymentIntentId: string;
     status: string;
     amountCents?: number;
+    money?: ProviderMoney;
     clientSecret?: string;
     currency?: string;
     environment?: 'test' | 'live';

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

@@ -1,7 +1,8 @@
+import { type PublicAnalyticsFeatureFlags } from '@funnelsgrove/analytics';
 import { type FunnelSdkRuntimeConfigOverrides, type FunnelStepType, type RuntimeMode } from '@funnelsgrove/runtime';
 export type CheckoutObservabilityAnalyticsContext = {
     environment?: RuntimeMode;
-    featureFlags?: Record<string, string | null | undefined>;
+    featureFlags?: PublicAnalyticsFeatureFlags;
     metadata?: Record<string, unknown> | null;
     runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
     stepId?: string;

package/dist/services/checkoutObservability.service.js

@@ -1,4 +1,4 @@
-import { publicAnalyticsSdk } from '@funnelsgrove/analytics';
+import { publicAnalyticsSdk, } from '@funnelsgrove/analytics';
 import { buildMainApiUrl, buildSdkHeaders, FUNNEL_ID, FUNNEL_VERSION_ID, } from '@funnelsgrove/runtime';
 import { toAnalyticsPaymentMethod } from './paymentMethodAnalytics.service.js';
 const asNonEmptyString = (value) => typeof value === 'string' && value.trim() ? value.trim() : null;

package/dist/services/paywallOffer.service.js

@@ -1,3 +1,5 @@
+import { formatProviderMoney } from '@funnelsgrove/runtime';
+const withAmountMinor = (money, amountMinor) => (Object.assign(Object.assign({}, money), { amountMinor }));
 const isBillingDiscountList = (discounts) => {
     return Array.isArray(discounts);
 };
@@ -259,21 +261,30 @@ export const buildDiscountedPaywallPlans = (input) => {
     const currency = ((_a = input.currency) === null || _a === void 0 ? void 0 : _a.trim()) || 'USD';
     const locale = ((_b = input.locale) === null || _b === void 0 ? void 0 : _b.trim()) || 'en-US';
     return input.plans.map((plan) => {
-        var _a, _b;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         const billingDays = getBillingDays(plan);
+        const planCurrency = ((_b = (_a = plan.money) === null || _a === void 0 ? void 0 : _a.currency) !== null && _b !== void 0 ? _b : (_c = plan.currency) === null || _c === void 0 ? void 0 : _c.trim()) || currency;
         const fixed = input.amountOffMinor !== undefined;
         const hasActiveDiscount = Boolean(input.couponId) && (fixed
             ? Number.isSafeInteger(input.amountOffMinor) && input.amountOffMinor > 0
-                && ((_a = input.discountCurrency) === null || _a === void 0 ? void 0 : _a.toUpperCase()) === currency.toUpperCase()
+                && ((_d = input.discountCurrency) === null || _d === void 0 ? void 0 : _d.toUpperCase()) === planCurrency.toUpperCase()
             : typeof input.discountPercent === 'number');
-        const discountedAmountCents = !hasActiveDiscount ? plan.amountCents : fixed
-            ? Math.max(0, plan.amountCents - input.amountOffMinor)
-            : getDiscountedAmountCents(plan.amountCents, (_b = input.discountPercent) !== null && _b !== void 0 ? _b : 0);
+        const baseAmountMinor = (_f = (_e = plan.money) === null || _e === void 0 ? void 0 : _e.amountMinor) !== null && _f !== void 0 ? _f : plan.amountCents;
+        const discountedAmountCents = !hasActiveDiscount ? baseAmountMinor : fixed
+            ? Math.max(0, baseAmountMinor - input.amountOffMinor)
+            : getDiscountedAmountCents(baseAmountMinor, (_g = input.discountPercent) !== null && _g !== void 0 ? _g : 0);
+        const discountedMoney = plan.money
+            ? withAmountMinor(plan.money, discountedAmountCents)
+            : undefined;
         const discountedPerDayAmount = billingDays && billingDays > 0
-            ? formatMoneyFromCents(Math.round(discountedAmountCents / billingDays), currency, locale)
+            ? discountedMoney
+                ? formatProviderMoney(withAmountMinor(discountedMoney, Math.round(discountedMoney.amountMinor / billingDays)), locale)
+                : formatMoneyFromCents(Math.round(discountedAmountCents / billingDays), planCurrency, locale)
             : plan.perDayAmount;
-        return Object.assign(Object.assign({}, plan), { amountCents: discountedAmountCents, priceLabel: hasActiveDiscount
-                ? formatMoneyFromCents(discountedAmountCents, currency, locale)
+        return Object.assign(Object.assign({}, plan), { amountCents: discountedAmountCents, money: discountedMoney, currency: (_j = (_h = plan.money) === null || _h === void 0 ? void 0 : _h.currency) !== null && _j !== void 0 ? _j : plan.currency, priceLabel: hasActiveDiscount
+                ? discountedMoney
+                    ? formatProviderMoney(discountedMoney, locale)
+                    : formatMoneyFromCents(discountedAmountCents, planCurrency, locale)
                 : plan.priceLabel, oldPriceLabel: hasActiveDiscount ? plan.priceLabel : undefined, perDayAmount: hasActiveDiscount ? discountedPerDayAmount : plan.perDayAmount, baseAmountCents: plan.amountCents, basePriceLabel: plan.priceLabel, basePerDayAmount: plan.perDayAmount, oldPerDayAmount: hasActiveDiscount ? plan.perDayAmount : null, couponId: hasActiveDiscount ? input.couponId : null, hasActiveDiscount });
     });
 };

package/dist/services/paywallPlans/types.d.ts

@@ -1,5 +1,5 @@
 import type { BillingFallbackPlanConfig, BillingPlanInterval } from '../../config/billing.config.js';
-import type { ResolvedCountryPricing } from '@funnelsgrove/runtime';
+import type { ProviderMoney, ResolvedCountryPricing } from '@funnelsgrove/runtime';
 export type PaywallPlan = {
     id: string;
     funnelPlanKey?: string;
@@ -15,6 +15,8 @@ export type PaywallPlan = {
     perDayAmount: string;
     perDayLabel: string;
     amountCents: number;
+    money?: ProviderMoney;
+    currency?: string;
     analyticsPurchaseValue?: number;
     comparison?: BillingFallbackPlanConfig['comparison'];
     checkoutOriginalAmountCents?: number;
@@ -32,7 +34,7 @@ export type PaywallPlanResolutionOptions = {
     locale?: string | null;
     pricing?: ResolvedCountryPricing<string> | null;
 };
-export type CheckoutSessionPlanInput = Pick<PaywallPlan, 'amountCents' | 'analyticsPurchaseValue' | 'billingInterval' | 'billingIntervalCount' | 'description' | 'funnelPlanKey' | 'id' | 'providerPlanId' | 'title' | 'followUpProviderPlanId' | 'followUpPlanTitle' | 'followUpBillingInterval' | 'followUpBillingIntervalCount' | 'introIterations' | 'offerSetId' | 'offerSetKey'>;
+export type CheckoutSessionPlanInput = Pick<PaywallPlan, 'amountCents' | 'money' | 'currency' | 'analyticsPurchaseValue' | 'billingInterval' | 'billingIntervalCount' | 'description' | 'funnelPlanKey' | 'id' | 'providerPlanId' | 'title' | 'followUpProviderPlanId' | 'followUpPlanTitle' | 'followUpBillingInterval' | 'followUpBillingIntervalCount' | 'introIterations' | 'offerSetId' | 'offerSetKey'>;
 export type CheckoutPlanRecurringConfig = {
     interval: BillingPlanInterval;
     intervalCount: number;

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

@@ -4,6 +4,7 @@ import { type PaywallPlan } from './paywallPlans.service.js';
 export type PublishedBillingPlan = BillingFallbackPlanConfig & OfferSetRuntimePlanOverrides;
 export type ResolvedPublishedBillingRuntime = {
     revisionId: string | null;
+    sourceVersionId: string | null;
     paymentsApiVersion: 'v2';
     mode: RuntimeMode;
     offerSetId: string;
@@ -12,6 +13,8 @@ export type ResolvedPublishedBillingRuntime = {
     stripePublishableKey: string | null;
     experimentId: string | null;
     variantKey: string | null;
+    locale: string | null;
+    featureFlags: Readonly<Record<string, string | boolean>>;
     experiments: readonly FunnelExperimentDefinition[];
     flowExperiments: readonly FunnelManifestExperiment[];
     plans: readonly PaywallPlan[];
@@ -20,14 +23,32 @@ export type ResolvedPublishedBillingRuntime = {
     discounts: BillingDiscountCatalog | null;
     upsells: readonly PublishedBillingPlan[];
     downsells: readonly PublishedBillingPlan[];
+    /** Published plan keys withheld because this mode has no chargeable price for them. */
+    unavailablePlanKeys: readonly string[];
 };
-export declare const resolvePublishedBillingRuntime: ({ config, featureFlags, mode, search, defaultOfferSetId, baseCatalogsByMode, fallbackDiscounts, resolvedExperiments, }: {
+export declare const EMPTY_PUBLISHED_BILLING_RUNTIME: ResolvedPublishedBillingRuntime;
+export declare const resolvePublishedBillingRuntime: ({ config, featureFlags, mode, search, defaultOfferSetId, locale, baseCatalogsByMode, fallbackDiscounts, resolvedExperiments, }: {
     config: ResolvedFunnelRuntimeConfig | null;
-    featureFlags: Readonly<Record<string, string>>;
+    featureFlags: Readonly<Record<string, string | boolean>>;
     mode: RuntimeMode;
     search?: string;
     defaultOfferSetId?: string;
+    locale?: string | null;
     baseCatalogsByMode?: Partial<Record<RuntimeMode, BillingPlanCatalog>>;
     fallbackDiscounts?: BillingDiscountList;
     resolvedExperiments?: ResolvedPublishedExperiments;
 }) => ResolvedPublishedBillingRuntime;
+export type PublishedBillingRuntimeResolution = {
+    status: 'pending';
+    runtime: null;
+    error: null;
+} | {
+    status: 'resolved';
+    runtime: ResolvedPublishedBillingRuntime;
+    error: null;
+} | {
+    status: 'error';
+    runtime: null;
+    error: Error;
+};
+export declare const resolvePublishedBillingRuntimeState: (input: Parameters<typeof resolvePublishedBillingRuntime>[0], ready?: boolean) => PublishedBillingRuntimeResolution;

package/dist/services/publishedBillingRuntime.service.js

@@ -1,8 +1,16 @@
 import { resolveGeneratedOfferSetRuntime, resolvePublishedOfferSetSelection, resolvePublishedRuntimeExperiments, } from '@funnelsgrove/runtime';
 import { buildBillingDiscountCatalog } from './paywallOffer.service.js';
 import { buildConfigPaywallPlans, } from './paywallPlans.service.js';
-export const resolvePublishedBillingRuntime = ({ config, featureFlags, mode, search = '', defaultOfferSetId, baseCatalogsByMode, fallbackDiscounts, resolvedExperiments = resolvePublishedRuntimeExperiments(config), }) => {
-    var _a, _b, _c, _d, _e, _f, _g;
+export const EMPTY_PUBLISHED_BILLING_RUNTIME = Object.freeze({
+    revisionId: null, sourceVersionId: null, paymentsApiVersion: 'v2', mode: 'live',
+    offerSetId: '', paymentProfileId: null, provider: 'stripe', stripePublishableKey: null,
+    experimentId: null, variantKey: null, locale: null, experiments: [], flowExperiments: [],
+    featureFlags: Object.freeze({}),
+    plans: [], planCatalog: {}, defaultPlanKey: '', discounts: null, upsells: [], downsells: [],
+    unavailablePlanKeys: [],
+});
+export const resolvePublishedBillingRuntime = ({ config, featureFlags, mode, search = '', defaultOfferSetId, locale, baseCatalogsByMode, fallbackDiscounts, resolvedExperiments = resolvePublishedRuntimeExperiments(config), }) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
     const offerSets = (_a = config === null || config === void 0 ? void 0 : config.offerSets) !== null && _a !== void 0 ? _a : [];
     const selection = resolvePublishedOfferSetSelection({
         offerSets,
@@ -10,7 +18,12 @@ export const resolvePublishedBillingRuntime = ({ config, featureFlags, mode, sea
         featureFlags,
         search,
         defaultOfferSetId: defaultOfferSetId || (config === null || config === void 0 ? void 0 : config.defaultOfferSetId) || undefined,
+        locale,
+        localeContractVersion: config === null || config === void 0 ? void 0 : config.localeContractVersion,
     });
+    if ((config === null || config === void 0 ? void 0 : config.localeContractVersion) === 1 && offerSets.length > 0 && !selection.offerSetId) {
+        throw new Error('Published billing runtime has no valid offer set selection');
+    }
     const runtime = resolveGeneratedOfferSetRuntime({
         offerSets,
         offerSetId: selection.offerSetId,
@@ -24,18 +37,24 @@ export const resolvePublishedBillingRuntime = ({ config, featureFlags, mode, sea
     const discountList = runtime.getDiscountList(mode);
     const provider = runtime.getPaymentProvider(mode);
     const paymentProviderConfig = (_c = (_b = runtime.offerSet) === null || _b === void 0 ? void 0 : _b.paymentProviderConfigByMode) === null || _c === void 0 ? void 0 : _c[mode];
+    const pinnedFeatureFlags = Object.assign(Object.assign({}, featureFlags), (selection.experimentId && selection.variantKey
+        ? { [selection.experimentId]: selection.variantKey }
+        : {}));
     return {
         revisionId: (_d = config === null || config === void 0 ? void 0 : config.revisionId) !== null && _d !== void 0 ? _d : null,
+        sourceVersionId: (_e = config === null || config === void 0 ? void 0 : config.sourceVersionId) !== null && _e !== void 0 ? _e : null,
         paymentsApiVersion: 'v2',
         mode,
         offerSetId: selection.offerSetId,
-        paymentProfileId: ((_f = (_e = runtime.offerSet) === null || _e === void 0 ? void 0 : _e.paymentProfileId) === null || _f === void 0 ? void 0 : _f.trim()) || null,
+        paymentProfileId: ((_g = (_f = runtime.offerSet) === null || _f === void 0 ? void 0 : _f.paymentProfileId) === null || _g === void 0 ? void 0 : _g.trim()) || null,
         provider,
         stripePublishableKey: provider === 'stripe' && (paymentProviderConfig === null || paymentProviderConfig === void 0 ? void 0 : paymentProviderConfig.provider) === 'stripe'
-            ? ((_g = paymentProviderConfig === null || paymentProviderConfig === void 0 ? void 0 : paymentProviderConfig.stripePublishableKey) === null || _g === void 0 ? void 0 : _g.trim()) || null
+            ? ((_h = paymentProviderConfig === null || paymentProviderConfig === void 0 ? void 0 : paymentProviderConfig.stripePublishableKey) === null || _h === void 0 ? void 0 : _h.trim()) || null
             : null,
         experimentId: selection.experimentId,
         variantKey: selection.variantKey,
+        locale: selection.locale,
+        featureFlags: Object.freeze(pinnedFeatureFlags),
         experiments: resolvedExperiments.experiments,
         flowExperiments: resolvedExperiments.flowExperiments,
         plans: buildConfigPaywallPlans(planCatalog, runtime.planKeys),
@@ -44,5 +63,20 @@ export const resolvePublishedBillingRuntime = ({ config, featureFlags, mode, sea
         discounts: discountList.length > 0 ? buildBillingDiscountCatalog(discountList) : null,
         upsells: getPlans(runtime.upsellPlanKeys),
         downsells: getPlans(runtime.downsellPlanKeys),
+        unavailablePlanKeys: runtime.getUnavailablePlanKeys(mode),
     };
 };
+export const resolvePublishedBillingRuntimeState = (input, ready = true) => {
+    if (!ready)
+        return { status: 'pending', runtime: null, error: null };
+    try {
+        return { status: 'resolved', runtime: resolvePublishedBillingRuntime(input), error: null };
+    }
+    catch (error) {
+        return {
+            status: 'error',
+            runtime: null,
+            error: error instanceof Error ? error : new Error('Unable to resolve published billing runtime'),
+        };
+    }
+};

package/dist/services/usePinnedPublishedBillingRuntime.d.ts

@@ -0,0 +1,10 @@
+import type { PublishedBillingRuntimeResolution, ResolvedPublishedBillingRuntime } from './publishedBillingRuntime.service.js';
+export type PinnedPublishedBillingRuntime = {
+    runtime: ResolvedPublishedBillingRuntime | null;
+    resolution: PublishedBillingRuntimeResolution;
+    pinned: boolean;
+    pin: () => void;
+    reset: () => void;
+};
+/** Keeps every visible and billable field on one published snapshot once preparation starts. */
+export declare const usePinnedPublishedBillingRuntime: (current: PublishedBillingRuntimeResolution) => PinnedPublishedBillingRuntime;

package/dist/services/usePinnedPublishedBillingRuntime.js

@@ -0,0 +1,23 @@
+'use client';
+import { useCallback, useState } from 'react';
+/** Keeps every visible and billable field on one published snapshot once preparation starts. */
+export const usePinnedPublishedBillingRuntime = (current) => {
+    const [pinnedRuntime, setPinnedRuntime] = useState(null);
+    const pin = useCallback(() => {
+        if (current.status !== 'resolved')
+            return;
+        setPinnedRuntime((existing) => existing !== null && existing !== void 0 ? existing : current.runtime);
+    }, [current]);
+    const reset = useCallback(() => {
+        setPinnedRuntime(null);
+    }, []);
+    return {
+        runtime: pinnedRuntime !== null && pinnedRuntime !== void 0 ? pinnedRuntime : current.runtime,
+        resolution: pinnedRuntime
+            ? { status: 'resolved', runtime: pinnedRuntime, error: null }
+            : current,
+        pinned: pinnedRuntime !== null,
+        pin,
+        reset,
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/payments",
-  "version": "0.22.6",
+  "version": "0.23.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/The-Solid-Grove/funnelsgrove.git",
@@ -46,11 +46,11 @@
     "jsdom": "20.0.3",
     "typescript": "^5",
     "vitest": "^3.2.4",
-    "@funnelsgrove/runtime": "0.20.3",
-    "@funnelsgrove/analytics": "0.3.0"
+    "@funnelsgrove/runtime": "0.21.0",
+    "@funnelsgrove/analytics": "0.4.0"
   },
   "peerDependencies": {
-    "@funnelsgrove/runtime": "^0.19.1 || ^0.20.0",
-    "@funnelsgrove/analytics": "^0.1.111 || ^0.2.0 || ^0.3.0"
+    "@funnelsgrove/runtime": "^0.21.0",
+    "@funnelsgrove/analytics": "^0.4.0"
   }
 }