@funnelsgrove/payments 0.31.0 → 0.33.0

package/dist/components/ManageSubscriptionScreen.d.ts

@@ -46,6 +46,7 @@ type ManageSubscription = RuntimeSubscription & {
 };
 export declare function ManageSubscriptionScreen({ stepId, content, homeStepId, nodeId, plans, }: ManageSubscriptionScreenProps): import("react/jsx-runtime").JSX.Element;
 export declare const __manageSubscriptionScreenTestables: {
+    isCancelledActiveSubscription: (subscription: ManageSubscription) => boolean;
     resolveBillingDateLabel: (subscription: Pick<ManageSubscription, "cancelAtPeriodEnd" | "currentPeriodEnd" | "status">, options?: {
         cancelled?: boolean;
         past?: boolean;

package/dist/components/ManageSubscriptionScreen.js

@@ -8,7 +8,8 @@ const pastSubscriptionsNote = 'Past subscriptions are already canceled or expire
 const cancelledSubscriptionsNote = 'These subscriptions are cancelled and remain active until the date shown below.';
 const getNormalizedStatus = (subscription) => subscription.status.trim().toLowerCase();
 const isCancelledActiveSubscription = (subscription) => {
-    return subscription.cancelAtPeriodEnd && getNormalizedStatus(subscription) !== 'canceled';
+    return subscription.cancelAtPeriodEnd && (getNormalizedStatus(subscription) !== 'canceled'
+        || Date.parse(subscription.currentPeriodEnd || '') > Date.now());
 };
 const isCancellableSubscription = (subscription) => {
     return getNormalizedStatus(subscription) !== 'canceled' && !subscription.cancelAtPeriodEnd;
@@ -243,6 +244,7 @@ function SubscriptionSection({ title, subscriptions, plans, onSelect, descriptio
                 }) })] }));
 }
 export const __manageSubscriptionScreenTestables = {
+    isCancelledActiveSubscription,
     resolveBillingDateLabel,
     resolveSubscriptionStatusLabel,
 };

package/dist/generated/package-version.d.ts

@@ -1 +1 @@
-export declare const PAYMENTS_PACKAGE_VERSION = "0.31.0";
+export declare const PAYMENTS_PACKAGE_VERSION = "0.33.0";

package/dist/generated/package-version.js

@@ -1,2 +1,2 @@
 // Generated by scripts/generate-package-version.mjs.
-export const PAYMENTS_PACKAGE_VERSION = "0.31.0";
+export const PAYMENTS_PACKAGE_VERSION = "0.33.0";

package/dist/index.d.ts

@@ -15,3 +15,5 @@ export * from './providers/solidgate/index.js';
 export { ManageSubscriptionScreen, type ManageSubscriptionContent, type ManageSubscriptionScreenProps, type ManageSubscriptionLabels, } from './components/ManageSubscriptionScreen.js';
 export { isCheckoutEmailError, isValidCheckoutEmail } from './services/checkoutEmail.js';
 export * from './components/CheckoutEmailDialog.js';
+export { PayPalCheckout, type PayPalCheckoutProps } from './providers/paypal/PayPalCheckout.js';
+export { readPendingPayPalCheckout } from './providers/paypal/paypalCheckout.service.js';

package/dist/index.js

@@ -18,3 +18,5 @@ export * from './providers/solidgate/index.js';
 export { ManageSubscriptionScreen, } from './components/ManageSubscriptionScreen.js';
 export { isCheckoutEmailError, isValidCheckoutEmail } from './services/checkoutEmail.js';
 export * from './components/CheckoutEmailDialog.js';
+export { PayPalCheckout } from './providers/paypal/PayPalCheckout.js';
+export { readPendingPayPalCheckout } from './providers/paypal/paypalCheckout.service.js';

package/dist/providers/paypal/PayPalCheckout.d.ts

@@ -0,0 +1,8 @@
+import { type PayPalCheckoutInput } from './paypalCheckout.service.js';
+export type PayPalCheckoutProps = PayPalCheckoutInput & {
+    onSuccess: () => void;
+    onPreparationStart?: () => void;
+    onPendingChange?: (pending: boolean) => void;
+};
+/** A keyed instance owns one merchant/plan selection throughout buyer approval. */
+export declare function PayPalCheckout(props: PayPalCheckoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/providers/paypal/PayPalCheckout.js

@@ -0,0 +1,210 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { completePaywallCheckout, retainPaywallCheckout } from '@funnelsgrove/runtime';
+import { loadPayPalSdk } from './paypalSdk.js';
+import { PayPalCheckoutRequestError, readPendingPayPalCheckout, storePendingPayPalCheckout, preparePayPalCheckout, verifyPayPalCheckout } from './paypalCheckout.service.js';
+/** A keyed instance owns one merchant/plan selection throughout buyer approval. */
+export function PayPalCheckout(props) {
+    const container = useRef(null);
+    const attemptKey = useRef(crypto.randomUUID());
+    const callbacks = useRef(props);
+    callbacks.current = props;
+    const [error, setError] = useState(null);
+    const [state, setState] = useState('loading');
+    const [retry, setRetry] = useState(0);
+    const [summary, setSummary] = useState(props.option.summary);
+    const verifyRef = useRef(null);
+    const inputKey = JSON.stringify([props.option, props.environment, props.funnelEndUserId, props.offerSetId, props.funnelPlanKey, props.runtimeConfig]);
+    useEffect(() => {
+        var _a, _b, _c, _d, _e;
+        const pending = readPendingPayPalCheckout(callbacks.current);
+        const input = pending ? Object.assign(Object.assign({}, callbacks.current), { option: pending.option, offerSetId: pending.offerSetId, funnelPlanKey: pending.funnelPlanKey }) : callbacks.current;
+        setSummary(input.option.summary);
+        const controller = new AbortController();
+        let button;
+        let attempt = null;
+        let verifying = false;
+        let approved = false;
+        let blocked = false;
+        let completed = false;
+        let idempotencyKey = attemptKey.current;
+        const storageKey = `fg-paypal:${input.environment}:${((_a = input.runtimeConfig) === null || _a === void 0 ? void 0 : _a.funnelId) || ''}:${input.funnelEndUserId}:${input.offerSetId}:${input.funnelPlanKey}:${input.option.paymentProfileId}:${input.option.providerPlanId}`;
+        try {
+            const saved = sessionStorage.getItem(storageKey);
+            if (saved === null || saved === void 0 ? void 0 : saved.startsWith('{')) {
+                const record = JSON.parse(saved);
+                if (typeof record.key === 'string')
+                    idempotencyKey = record.key;
+                if (typeof ((_b = record.attempt) === null || _b === void 0 ? void 0 : _b.attemptId) === 'string' && typeof ((_c = record.attempt) === null || _c === void 0 ? void 0 : _c.subscriptionId) === 'string') {
+                    attempt = record.attempt;
+                    approved = record.approved === true;
+                }
+            }
+            else if (saved)
+                idempotencyKey = saved;
+        }
+        catch ( /* In-memory key still protects retries when browser storage is disabled. */_f) { /* In-memory key still protects retries when browser storage is disabled. */ }
+        if (pending) {
+            attempt = pending.attempt;
+            approved = pending.approved !== false;
+            idempotencyKey = pending.idempotencyKey;
+        }
+        const persist = () => {
+            try {
+                sessionStorage.setItem(storageKey, JSON.stringify({ key: idempotencyKey, attempt, approved }));
+            }
+            catch ( /* Optional persistence. */_a) { /* Optional persistence. */ }
+            if (attempt)
+                storePendingPayPalCheckout(input, { option: input.option, offerSetId: input.offerSetId, funnelPlanKey: input.funnelPlanKey, attempt, idempotencyKey, approved });
+        };
+        persist();
+        const showError = (message) => {
+            var _a, _b;
+            if (controller.signal.aborted || blocked || completed)
+                return;
+            setError(message);
+            setState(attempt ? 'pending' : 'ready');
+            if (!attempt)
+                (_b = (_a = callbacks.current).onPendingChange) === null || _b === void 0 ? void 0 : _b.call(_a, false);
+        };
+        const showRequestError = (error, fallback) => {
+            var _a, _b;
+            if (controller.signal.aborted || completed)
+                return;
+            if (error instanceof PayPalCheckoutRequestError) {
+                blocked = true;
+                setError(error.message);
+                setState('blocked');
+                (_b = (_a = callbacks.current).onPendingChange) === null || _b === void 0 ? void 0 : _b.call(_a, true);
+                return;
+            }
+            showError(fallback);
+        };
+        const verify = async () => {
+            var _a, _b;
+            if (!attempt || verifying || controller.signal.aborted)
+                return;
+            verifying = true;
+            setError(null);
+            setState('verifying');
+            try {
+                // Polling is bounded; a pending payment retains the same attempt for a manual recheck.
+                for (let index = 0; index < 20 && !controller.signal.aborted; index += 1) {
+                    const status = await verifyPayPalCheckout(input, attempt, controller.signal);
+                    if (controller.signal.aborted)
+                        return;
+                    if (status === 'succeeded') {
+                        const embedded = await completePaywallCheckout('paypal', attempt.attemptId, { signal: controller.signal });
+                        if (controller.signal.aborted)
+                            return;
+                        completed = true;
+                        setState('success');
+                        storePendingPayPalCheckout(input, null);
+                        try {
+                            sessionStorage.removeItem(storageKey);
+                        }
+                        catch ( /* Optional persistence. */_c) { /* Optional persistence. */ }
+                        (_b = (_a = callbacks.current).onPendingChange) === null || _b === void 0 ? void 0 : _b.call(_a, false);
+                        if (!embedded)
+                            callbacks.current.onSuccess();
+                        return;
+                    }
+                    if (status === 'requires_payment' && !approved) {
+                        await renderButton();
+                        return;
+                    }
+                    await new Promise(resolve => {
+                        const done = () => { clearTimeout(timeout); controller.signal.removeEventListener('abort', done); resolve(); };
+                        const timeout = setTimeout(done, 1500);
+                        controller.signal.addEventListener('abort', done, { once: true });
+                    });
+                }
+                showError('PayPal is still confirming your subscription. Check its status before trying another purchase.');
+            }
+            catch (error) {
+                showRequestError(error, 'Unable to confirm your subscription yet. Check payment status to continue.');
+            }
+            finally {
+                verifying = false;
+            }
+        };
+        verifyRef.current = verify;
+        setState('loading');
+        setError(null);
+        const renderButton = async () => {
+            if (controller.signal.aborted)
+                return;
+            if (button) {
+                setState('ready');
+                return;
+            }
+            const sdk = await loadPayPalSdk(input.option.clientId, input.environment, input.option.currency);
+            if (controller.signal.aborted || !container.current)
+                return;
+            button = sdk.Buttons({
+                fundingSource: sdk.FUNDING.PAYPAL, style: { label: 'paypal', layout: 'vertical', height: 48 },
+                createSubscription: async () => {
+                    var _a, _b, _c, _d;
+                    if (controller.signal.aborted || completed || blocked)
+                        throw new Error('This PayPal checkout is no longer accepting approval.');
+                    (_b = (_a = callbacks.current).onPreparationStart) === null || _b === void 0 ? void 0 : _b.call(_a);
+                    (_d = (_c = callbacks.current).onPendingChange) === null || _d === void 0 ? void 0 : _d.call(_c, true);
+                    setError(null);
+                    setState('approving');
+                    try {
+                        if (attempt) {
+                            const status = await verifyPayPalCheckout(input, attempt, controller.signal);
+                            if (status !== 'requires_payment') {
+                                await verify();
+                                throw new Error('Check payment status before approving this subscription.');
+                            }
+                        }
+                        else {
+                            attempt = await preparePayPalCheckout(input, idempotencyKey, controller.signal);
+                        }
+                        persist();
+                        retainPaywallCheckout('paypal', attempt.attemptId, input.option.paymentProfileId);
+                        return attempt.subscriptionId;
+                    }
+                    catch (error) {
+                        showRequestError(error, 'PayPal is temporarily unavailable. Please try again.');
+                        throw error;
+                    }
+                },
+                onApprove: async (data) => {
+                    if (controller.signal.aborted || completed || blocked)
+                        return;
+                    if (!attempt || data.subscriptionID !== attempt.subscriptionId) {
+                        showError('Unable to match this PayPal approval. Check payment status.');
+                        return;
+                    }
+                    approved = true;
+                    persist();
+                    await verify();
+                },
+                onCancel: () => { var _a, _b; if (!controller.signal.aborted && !approved && !completed && !blocked) {
+                    attempt = null;
+                    persist();
+                    storePendingPayPalCheckout(input, null);
+                    setState('ready');
+                    (_b = (_a = callbacks.current).onPendingChange) === null || _b === void 0 ? void 0 : _b.call(_a, false);
+                } },
+                onError: () => showError('PayPal is temporarily unavailable. Please try again.'),
+            });
+            await button.render(container.current);
+            if (!controller.signal.aborted)
+                setState('ready');
+        };
+        if (attempt) {
+            (_e = (_d = callbacks.current).onPendingChange) === null || _e === void 0 ? void 0 : _e.call(_d, true);
+            retainPaywallCheckout('paypal', attempt.attemptId, input.option.paymentProfileId);
+            void verify();
+        }
+        else {
+            void renderButton().catch(() => showError('Unable to load PayPal. Please try again.'));
+        }
+        return () => { controller.abort(); verifyRef.current = null; void (button === null || button === void 0 ? void 0 : button.close().catch(() => undefined)); };
+    }, [inputKey, retry]);
+    return _jsxs("section", { "aria-label": 'PayPal payment', className: 'space-y-3', children: [_jsxs("p", { className: 'text-sm', children: ["PayPal \u00B7 ", summary] }), _jsx("div", { ref: container, hidden: state === 'blocked' || state === 'pending' || state === 'verifying' || state === 'success' }), state === 'loading' ? _jsx("p", { role: 'status', children: "Loading PayPal\u2026" }) : null, state === 'verifying' ? _jsx("p", { role: 'status', children: "Confirming your subscription\u2026" }) : null, state === 'success' ? _jsx("p", { role: 'status', children: "Subscription confirmed." }) : null, error ? _jsx("p", { role: 'alert', children: error }) : null, state === 'pending' ? _jsx("button", { type: 'button', onClick: () => { var _a; return void ((_a = verifyRef.current) === null || _a === void 0 ? void 0 : _a.call(verifyRef)); }, children: "Check payment status" })
+                : error && state !== 'blocked' ? _jsx("button", { type: 'button', onClick: () => setRetry(value => value + 1), children: "Retry PayPal" }) : null] });
+}

package/dist/providers/paypal/paypalCheckout.service.d.ts

@@ -0,0 +1,35 @@
+import { type FunnelSdkRuntimeConfigOverrides } from '@funnelsgrove/runtime';
+import type { PayPalBillingOption } from '../../services/publishedBillingRuntime.service.js';
+export type PayPalCheckoutInput = {
+    option: PayPalBillingOption;
+    environment: 'test' | 'live';
+    funnelEndUserId: string;
+    offerSetId: string;
+    funnelPlanKey: string;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+};
+export type PayPalCheckoutAttempt = {
+    attemptId: string;
+    subscriptionId: string;
+};
+declare const checkoutErrorMessages: {
+    checkout_unavailable: string;
+    checkout_outcome_unresolved: string;
+    already_subscribed_to_product: string;
+};
+export declare class PayPalCheckoutRequestError extends Error {
+    readonly code: keyof typeof checkoutErrorMessages;
+    constructor(code: keyof typeof checkoutErrorMessages);
+}
+export declare function preparePayPalCheckout(input: PayPalCheckoutInput, idempotencyKey: string, signal: AbortSignal): Promise<PayPalCheckoutAttempt>;
+export declare function verifyPayPalCheckout(input: PayPalCheckoutInput, attempt: PayPalCheckoutAttempt, signal: AbortSignal): Promise<'succeeded' | 'requires_payment' | 'verifying' | 'preparing'>;
+export type PendingPayPalCheckout = Pick<PayPalCheckoutInput, 'option' | 'offerSetId' | 'funnelPlanKey'> & {
+    attempt: PayPalCheckoutAttempt;
+    idempotencyKey: string;
+    approved?: boolean;
+};
+type PendingScope = Pick<PayPalCheckoutInput, 'runtimeConfig' | 'environment' | 'funnelEndUserId'>;
+/** A prepared checkout must survive a lost approval callback or default-plan change. */
+export declare const readPendingPayPalCheckout: (scope: PendingScope) => PendingPayPalCheckout | null;
+export declare const storePendingPayPalCheckout: (scope: PendingScope, value: PendingPayPalCheckout | null) => void;
+export {};

package/dist/providers/paypal/paypalCheckout.service.js

@@ -0,0 +1,87 @@
+import { FUNNEL_ID, FUNNEL_SDK_PUBLISHABLE_KEY, buildMainApiUrl, resolvePreviewPaymentPublishableKey } from '@funnelsgrove/runtime';
+const record = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+const checkoutErrorMessages = {
+    checkout_unavailable: 'This PayPal checkout is no longer available. Please contact support before starting another purchase.',
+    checkout_outcome_unresolved: 'We are still checking this PayPal checkout. Please wait or contact support before starting another purchase.',
+    already_subscribed_to_product: 'You already have an active subscription to this product.',
+};
+export class PayPalCheckoutRequestError extends Error {
+    constructor(code) {
+        super(checkoutErrorMessages[code]);
+        this.code = code;
+        this.name = 'PayPalCheckoutRequestError';
+    }
+}
+async function request(input, path, signal, body) {
+    var _a, _b, _c, _d;
+    const key = resolvePreviewPaymentPublishableKey((_b = (_a = input.runtimeConfig) === null || _a === void 0 ? void 0 : _a.funnelSdkPublishableKey) !== null && _b !== void 0 ? _b : FUNNEL_SDK_PUBLISHABLE_KEY);
+    const base = (_d = (_c = input.runtimeConfig) === null || _c === void 0 ? void 0 : _c.apiBaseUrl) === null || _d === void 0 ? void 0 : _d.trim().replace(/\/+$/, '');
+    const response = await fetch(base ? `${base}${path}` : buildMainApiUrl(path), Object.assign({ method: body ? 'POST' : 'GET', signal, headers: Object.assign(Object.assign({}, (body ? { 'content-type': 'application/json' } : {})), (key ? { 'x-sdk-publishable-key': key } : {})) }, (body ? { body: JSON.stringify(body) } : {})));
+    if (!response.ok) {
+        const failure = await response.json().catch(() => null);
+        if (record(failure) && (failure.code === 'checkout_unavailable'
+            || failure.code === 'checkout_outcome_unresolved' || failure.code === 'already_subscribed_to_product')) {
+            throw new PayPalCheckoutRequestError(failure.code);
+        }
+        throw new Error('Unable to confirm with PayPal. Please try again.');
+    }
+    const result = await response.json();
+    if (!record(result))
+        throw new Error('Invalid PayPal checkout response.');
+    return result;
+}
+export async function preparePayPalCheckout(input, idempotencyKey, signal) {
+    var _a;
+    const result = await request(input, '/sdk/public/v2/payments/checkout-sessions', signal, {
+        provider: 'paypal', checkoutType: 'subscription', uiMode: 'custom', environment: input.environment,
+        paymentProfileId: input.option.paymentProfileId, providerPlanId: input.option.providerPlanId,
+        funnelId: ((_a = input.runtimeConfig) === null || _a === void 0 ? void 0 : _a.funnelId) || FUNNEL_ID, funnelEndUserId: input.funnelEndUserId,
+        offerSetId: input.offerSetId, planKey: input.funnelPlanKey, idempotencyKey,
+        returnUrl: window.location.href, successUrl: window.location.href, failUrl: window.location.href,
+    });
+    const initialization = result.initialization;
+    if (typeof result.attemptId !== 'string' || !result.attemptId || !record(initialization)
+        || initialization.kind !== 'paypal' || initialization.clientId !== input.option.clientId
+        || typeof initialization.subscriptionId !== 'string' || !initialization.subscriptionId)
+        throw new Error('Invalid PayPal checkout response.');
+    return { attemptId: result.attemptId, subscriptionId: initialization.subscriptionId };
+}
+export async function verifyPayPalCheckout(input, attempt, signal) {
+    var _a;
+    const query = new URLSearchParams({ provider: 'paypal', funnelId: ((_a = input.runtimeConfig) === null || _a === void 0 ? void 0 : _a.funnelId) || FUNNEL_ID, funnelEndUserId: input.funnelEndUserId });
+    const result = await request(input, `/sdk/public/v2/payments/checkout-sessions/${encodeURIComponent(attempt.attemptId)}?${query}`, signal);
+    if (result.attemptId !== attempt.attemptId)
+        throw new Error('Invalid PayPal checkout response.');
+    if (result.status === 'failed' || result.status === 'expired')
+        throw new PayPalCheckoutRequestError('checkout_unavailable');
+    if (result.status !== 'succeeded' && result.status !== 'requires_payment'
+        && result.status !== 'verifying' && result.status !== 'preparing')
+        throw new Error('Invalid PayPal checkout response.');
+    return result.status;
+}
+const pendingKey = (scope) => { var _a; return `fg-paypal-pending:${scope.environment}:${((_a = scope.runtimeConfig) === null || _a === void 0 ? void 0 : _a.funnelId) || FUNNEL_ID}:${scope.funnelEndUserId}`; };
+/** A prepared checkout must survive a lost approval callback or default-plan change. */
+export const readPendingPayPalCheckout = (scope) => {
+    try {
+        const value = JSON.parse(sessionStorage.getItem(pendingKey(scope)) || 'null');
+        if (!record(value) || !record(value.attempt) || !record(value.option)
+            || ![value.offerSetId, value.funnelPlanKey, value.idempotencyKey, value.attempt.attemptId, value.attempt.subscriptionId,
+                value.option.paymentProfileId, value.option.providerPlanId, value.option.clientId, value.option.currency, value.option.summary]
+                .every(field => typeof field === 'string' && field.length > 0)
+            || typeof value.option.amountMinor !== 'number')
+            return null;
+        return value;
+    }
+    catch (_a) {
+        return null;
+    }
+};
+export const storePendingPayPalCheckout = (scope, value) => {
+    try {
+        if (value)
+            sessionStorage.setItem(pendingKey(scope), JSON.stringify(value));
+        else
+            sessionStorage.removeItem(pendingKey(scope));
+    }
+    catch ( /* Browser storage can be unavailable; the mounted checkout still retains ownership. */_a) { /* Browser storage can be unavailable; the mounted checkout still retains ownership. */ }
+};

package/dist/providers/paypal/paypalSdk.d.ts

@@ -0,0 +1,25 @@
+type PayPalButton = {
+    render: (container: HTMLElement) => Promise<void>;
+    close: () => Promise<void>;
+};
+export type PayPalSdk = {
+    FUNDING: {
+        PAYPAL: string;
+    };
+    Buttons: (options: {
+        fundingSource: string;
+        style: {
+            label: string;
+            layout: string;
+            height: number;
+        };
+        createSubscription: () => Promise<string>;
+        onApprove: (data: {
+            subscriptionID: string;
+        }) => Promise<void>;
+        onCancel: () => void;
+        onError: () => void;
+    }) => PayPalButton;
+};
+export declare function loadPayPalSdk(clientId: string, environment: 'test' | 'live', currency: string): Promise<PayPalSdk>;
+export {};

package/dist/providers/paypal/paypalSdk.js

@@ -0,0 +1,33 @@
+const instances = new Map();
+let sequence = 0;
+export function loadPayPalSdk(clientId, environment, currency) {
+    const key = JSON.stringify([clientId, environment, currency]);
+    const existing = instances.get(key);
+    if (existing)
+        return existing;
+    const namespace = `fgPayPal${++sequence}`;
+    const pending = new Promise((resolve, reject) => {
+        const script = document.createElement('script');
+        const query = new URLSearchParams({ 'client-id': clientId, components: 'buttons', intent: 'subscription', vault: 'true', currency,
+            'integration-date': '2026-09-30' });
+        script.src = `https://www.paypal.com/sdk/js?${query}`;
+        script.dataset.namespace = namespace;
+        script.async = true;
+        const failed = () => { clearTimeout(timeout); script.remove(); reject(new Error('Unable to load PayPal. Please try again.')); };
+        const timeout = setTimeout(failed, 20000);
+        script.onerror = failed;
+        script.onload = () => {
+            clearTimeout(timeout);
+            const sdk = window[namespace];
+            if (!(sdk === null || sdk === void 0 ? void 0 : sdk.Buttons)) {
+                failed();
+                return;
+            }
+            resolve(sdk);
+        };
+        document.head.appendChild(script);
+    });
+    instances.set(key, pending);
+    void pending.catch(() => instances.delete(key));
+    return pending;
+}

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

@@ -2,14 +2,23 @@ import { type FunnelExperimentDefinition, type FunnelManifestExperiment, type Of
 import type { BillingDiscountCatalog, BillingDiscountList, BillingFallbackPlanConfig, BillingPlanCatalog } from '../config/billing.config.js';
 import { type PaywallPlan } from './paywallPlans.service.js';
 export type PublishedBillingPlan = BillingFallbackPlanConfig & OfferSetRuntimePlanOverrides;
+export type PayPalBillingOption = {
+    paymentProfileId: string;
+    clientId: string;
+    providerPlanId: string;
+    amountMinor: number;
+    currency: string;
+    summary: string;
+};
 export type ResolvedPublishedBillingRuntime = {
+    paypalOptionsByPlanKey?: Readonly<Record<string, PayPalBillingOption>>;
     revisionId: string | null;
     sourceVersionId: string | null;
     paymentsApiVersion: 'v2';
     mode: RuntimeMode;
     offerSetId: string;
     paymentProfileId: string | null;
-    provider: 'stripe' | 'solidgate';
+    provider: 'stripe' | 'solidgate' | 'paypal';
     stripePublishableKey: string | null;
     experimentId: string | null;
     variantKey: string | null;

package/dist/services/publishedBillingRuntime.service.js

@@ -10,7 +10,7 @@ export const EMPTY_PUBLISHED_BILLING_RUNTIME = Object.freeze({
     unavailablePlanKeys: [],
 });
 export const resolvePublishedBillingRuntime = ({ config, featureFlags, mode, search = '', defaultOfferSetId, locale, baseCatalogsByMode, fallbackDiscounts, resolvedExperiments = resolvePublishedRuntimeExperiments(config), }) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
     const offerSets = (_a = config === null || config === void 0 ? void 0 : config.offerSets) !== null && _a !== void 0 ? _a : [];
     const selection = resolvePublishedOfferSetSelection({
         offerSets,
@@ -37,19 +37,36 @@ 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 paypalOptionsByPlanKey = {};
+    for (const item of ((_d = runtime.offerSet) === null || _d === void 0 ? void 0 : _d.items) || []) {
+        const binding = (_e = item.paymentProfileBindings) === null || _e === void 0 ? void 0 : _e.find(candidate => candidate.provider === 'paypal');
+        const profileId = (binding === null || binding === void 0 ? void 0 : binding.paymentProfileId) || (provider === 'paypal' ? (_f = runtime.offerSet) === null || _f === void 0 ? void 0 : _f.paymentProfileId : null);
+        if (!profileId)
+            continue;
+        const mapping = binding ? (_g = binding.providerMappingsByMode) === null || _g === void 0 ? void 0 : _g[mode] : (_h = item.providerMappingsByMode) === null || _h === void 0 ? void 0 : _h[mode];
+        const profileConfig = ((_l = (_k = (_j = runtime.offerSet) === null || _j === void 0 ? void 0 : _j.paymentProviderConfigByProfileId) === null || _k === void 0 ? void 0 : _k[profileId]) === null || _l === void 0 ? void 0 : _l[mode])
+            || (provider === 'paypal' ? paymentProviderConfig : null);
+        const clientId = (profileConfig === null || profileConfig === void 0 ? void 0 : profileConfig.provider) === 'paypal' ? profileConfig.paypalClientId : null;
+        if (!(mapping === null || mapping === void 0 ? void 0 : mapping.providerPlanId) || !clientId || !mapping.checkoutSummaryLabel || mapping.amountCents == null || !mapping.currency)
+            continue;
+        paypalOptionsByPlanKey[item.funnelPlanKey] = { paymentProfileId: profileId, clientId,
+            providerPlanId: mapping.providerPlanId, summary: mapping.checkoutSummaryLabel,
+            amountMinor: mapping.amountCents, currency: mapping.currency };
+    }
     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,
+        paypalOptionsByPlanKey,
+        revisionId: (_m = config === null || config === void 0 ? void 0 : config.revisionId) !== null && _m !== void 0 ? _m : null,
+        sourceVersionId: (_o = config === null || config === void 0 ? void 0 : config.sourceVersionId) !== null && _o !== void 0 ? _o : null,
         paymentsApiVersion: 'v2',
         mode,
         offerSetId: selection.offerSetId,
-        paymentProfileId: ((_g = (_f = runtime.offerSet) === null || _f === void 0 ? void 0 : _f.paymentProfileId) === null || _g === void 0 ? void 0 : _g.trim()) || null,
+        paymentProfileId: ((_q = (_p = runtime.offerSet) === null || _p === void 0 ? void 0 : _p.paymentProfileId) === null || _q === void 0 ? void 0 : _q.trim()) || null,
         provider,
         stripePublishableKey: provider === 'stripe' && (paymentProviderConfig === null || paymentProviderConfig === void 0 ? void 0 : paymentProviderConfig.provider) === 'stripe'
-            ? ((_h = paymentProviderConfig === null || paymentProviderConfig === void 0 ? void 0 : paymentProviderConfig.stripePublishableKey) === null || _h === void 0 ? void 0 : _h.trim()) || null
+            ? ((_r = paymentProviderConfig === null || paymentProviderConfig === void 0 ? void 0 : paymentProviderConfig.stripePublishableKey) === null || _r === void 0 ? void 0 : _r.trim()) || null
             : null,
         experimentId: selection.experimentId,
         variantKey: selection.variantKey,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/payments",
-  "version": "0.31.0",
+  "version": "0.33.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.26.0",
-    "@funnelsgrove/analytics": "0.8.0"
+    "@funnelsgrove/runtime": "0.28.0",
+    "@funnelsgrove/analytics": "0.10.0"
   },
   "peerDependencies": {
-    "@funnelsgrove/runtime": "^0.26.0",
-    "@funnelsgrove/analytics": "^0.8.0"
+    "@funnelsgrove/runtime": "^0.28.0",
+    "@funnelsgrove/analytics": "^0.10.0"
   }
 }