@funnelsgrove/payments 0.11.4 → 0.11.5

package/README.md

@@ -102,6 +102,26 @@ When a live funnel still uses one of these, migrate the funnel deliberately with
 
 Funnels should call `resolvePublishedBillingRuntime` once at their runtime-provider boundary. Screens consume its resolved view and should not parse offer sets or pricing-experiment variants themselves. Pass the resolved `stripePublishableKey` into shared Stripe checkout hooks so Stripe.js can load while the Checkout Session request is still in flight; the key returned by that request remains the compatibility fallback.
 
+## Client implementation structure
+
+Provider-neutral plan types, selection and recurrence live in
+`services/paywallPlans/`, exposed through `paywallPlans.service.ts`.
+`publishedBillingRuntime` and timed-offer helpers must not import a provider
+service just to resolve or display plans. Shared config/services are checked for
+provider dependencies in `paymentBoundaries.test.ts`.
+
+Stripe browser operations live in `providers/stripe/services/checkout/`,
+`hostedCheckout/`, `oneClick/` and the compatibility-only `paymentIntent/`.
+Keep request mappers (`requests.ts`) beside the short async operation functions;
+common validation and metadata normalization belong in the local `shared/` folder.
+`stripeClient.ts` owns the Stripe.js cache. One-click orchestration calls the
+charge and confirmation functions in its own folder, without a workflow layer.
+
+`stripe.service.ts` remains a compatibility export facade. All existing root
+exports, signatures, SDK payloads, errors and confirmation behavior remain intact.
+HTTP transport and V1/V2 endpoint choice belong to the runtime SDK, not payments.
+No automatic charge retry, V1 fallback, or extra conversion event is introduced.
+
 ## Engineering Rules
 
 - Keep every provider-specific component, hook, service, and test helper under `src/providers/<provider>`. Add future providers as sibling folders; do not place provider SDK imports in root `components`, `hooks`, or `services`.

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './config/billing.config.js';
 export * from './services/preview-frame.service.js';
 export * from './services/runtime-mode.service.js';
 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/paywallOffer.service.js';

package/dist/index.js

@@ -3,6 +3,7 @@ export * from './config/billing.config.js';
 export * from './services/preview-frame.service.js';
 export * from './services/runtime-mode.service.js';
 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/paywallOffer.service.js';

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

@@ -0,0 +1,2 @@
+import type { CreateOneTimeCheckoutInput, CreateOneTimeCheckoutResponse } from './types.js';
+export declare function createStripeOneTimeCheckout(input: CreateOneTimeCheckoutInput): Promise<CreateOneTimeCheckoutResponse>;

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

@@ -0,0 +1,5 @@
+import { funnelSdkService } from '@funnelsgrove/runtime';
+import { toOneTimeCheckoutRequest } from './requests.js';
+export async function createStripeOneTimeCheckout(input) {
+    return funnelSdkService.createOneTimeCheckout(toOneTimeCheckoutRequest(input));
+}

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

@@ -0,0 +1,2 @@
+import type { CreateSubscriptionCheckoutInput, CreateSubscriptionCheckoutResponse } from './types.js';
+export declare function createStripeSubscriptionCheckout(input: CreateSubscriptionCheckoutInput): Promise<CreateSubscriptionCheckoutResponse>;

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

@@ -0,0 +1,5 @@
+import { funnelSdkService } from '@funnelsgrove/runtime';
+import { toSubscriptionCheckoutRequest } from './requests.js';
+export async function createStripeSubscriptionCheckout(input) {
+    return funnelSdkService.createSubscriptionCheckout(toSubscriptionCheckoutRequest(input));
+}

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

@@ -0,0 +1,83 @@
+import type { CreateOneTimeCheckoutInput, CreateSubscriptionCheckoutInput, UpdateSubscriptionCheckoutPlanInput, VerifySubscriptionCheckoutPaymentInput } from './types.js';
+export declare const toOneTimeCheckoutRequest: (input: CreateOneTimeCheckoutInput) => {
+    planKey: string;
+    runtimeConfigRevisionId: string | null | undefined;
+    paymentProfileId: string | null | undefined;
+    provider: "stripe" | null | undefined;
+    anonymousUserId: string | null | undefined;
+    idempotencyKey: string | null | undefined;
+    offerSetId: string | undefined;
+    offerSetKey: string | undefined;
+    planId: string;
+    providerPlanId: string | undefined;
+    title: string;
+    description: string | undefined;
+    amountCents: number;
+    couponId: string | undefined;
+    analyticsMetadata: Record<string, unknown> | undefined;
+    customerEmail: string | undefined;
+    returnUrl: string;
+    userId: string | undefined;
+    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
+    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+};
+export declare const toSubscriptionCheckoutRequest: (input: CreateSubscriptionCheckoutInput) => {
+    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;
+    title: string;
+    description: string | undefined;
+    amountCents: number;
+    billingInterval: import("../../../../index.js").BillingPlanInterval;
+    billingIntervalCount: number;
+    followUpProviderPlanId: string | undefined;
+    followUpPlanTitle: string | undefined;
+    followUpBillingInterval: import("../../../../index.js").BillingPlanInterval | undefined;
+    followUpBillingIntervalCount: number | undefined;
+    introIterations: number | undefined;
+    couponId: string | undefined;
+    analyticsMetadata: Record<string, unknown> | undefined;
+    customerEmail: string | undefined;
+    returnUrl: string;
+    userId: string | undefined;
+    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
+    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+};
+export declare const toSubscriptionCheckoutPlanRequest: (input: UpdateSubscriptionCheckoutPlanInput) => {
+    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;
+    billingInterval: import("../../../../index.js").BillingPlanInterval;
+    billingIntervalCount: number;
+    followUpProviderPlanId: string | undefined;
+    followUpPlanTitle: string | undefined;
+    followUpBillingInterval: import("../../../../index.js").BillingPlanInterval | undefined;
+    followUpBillingIntervalCount: number | undefined;
+    introIterations: number | undefined;
+    couponId: string | undefined;
+    analyticsMetadata: Record<string, unknown> | undefined;
+    customerEmail: string | undefined;
+    userId: string | undefined;
+    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
+    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+};
+export declare const toSubscriptionCheckoutStatusRequest: (input: VerifySubscriptionCheckoutPaymentInput) => {
+    checkoutSessionId: string;
+    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
+    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+};

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

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

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

@@ -0,0 +1,83 @@
+import type { CheckoutSessionPlanInput } from '../../../../services/paywallPlans/types.js';
+import type { RuntimeMode } from '@funnelsgrove/runtime';
+import type { StripeRuntimeConfigOverrides } from '../shared/types.js';
+export type CreateOneTimeCheckoutInput = {
+    plan: CheckoutSessionPlanInput;
+    runtimeConfigRevisionId?: string | null;
+    paymentProfileId?: string | null;
+    provider?: 'stripe' | null;
+    anonymousUserId?: string | null;
+    idempotencyKey?: string | null;
+    couponId?: string | null;
+    analyticsMetadata?: Record<string, unknown> | null;
+    customerEmail?: string | null;
+    returnUrl: string;
+    user_id?: string | null;
+    environment?: RuntimeMode;
+    runtimeConfig?: StripeRuntimeConfigOverrides;
+};
+export type CreateOneTimeCheckoutResponse = {
+    clientSecret: string;
+    checkoutSessionId?: string;
+    stripePublishableKey?: string;
+    environment?: 'test' | 'live';
+    paymentProfileId?: string;
+    userId?: string;
+    anonymousUserId?: string;
+    funnelEndUserId?: string;
+};
+export type CreateSubscriptionCheckoutInput = {
+    plan: CheckoutSessionPlanInput;
+    runtimeConfigRevisionId?: string | null;
+    paymentProfileId?: string | null;
+    provider?: 'stripe' | null;
+    anonymousUserId?: string | null;
+    couponId?: string | null;
+    analyticsMetadata?: Record<string, unknown> | null;
+    customerEmail?: string | null;
+    returnUrl: string;
+    user_id?: string | null;
+    environment?: RuntimeMode;
+    runtimeConfig?: StripeRuntimeConfigOverrides;
+};
+export type CreateSubscriptionCheckoutResponse = {
+    clientSecret: string;
+    checkoutSessionId?: string;
+    subscriptionId?: string;
+    stripePublishableKey?: string;
+    environment?: 'test' | 'live';
+    paymentProfileId?: string;
+    userId?: string;
+    anonymousUserId?: string;
+    funnelEndUserId?: string;
+};
+export type UpdateSubscriptionCheckoutPlanInput = {
+    checkoutSessionId: string;
+    plan: CheckoutSessionPlanInput;
+    runtimeConfigRevisionId?: string | null;
+    paymentProfileId?: string | null;
+    provider?: 'stripe' | null;
+    couponId?: string | null;
+    analyticsMetadata?: Record<string, unknown> | null;
+    customerEmail?: string | null;
+    user_id?: string | null;
+    environment?: RuntimeMode;
+    runtimeConfig?: StripeRuntimeConfigOverrides;
+};
+export type UpdateSubscriptionCheckoutPlanResponse = {
+    checkoutSessionId: string;
+    environment?: 'test' | 'live';
+};
+export type VerifySubscriptionCheckoutPaymentInput = {
+    checkoutSessionId: string;
+    environment?: RuntimeMode;
+    runtimeConfig?: StripeRuntimeConfigOverrides;
+};
+export type VerifySubscriptionCheckoutPaymentResponse = {
+    checkoutSessionId: string;
+    paid: boolean;
+    paymentStatus?: string | null;
+    status?: string | null;
+    environment?: 'test' | 'live';
+    analyticsMetadata?: Record<string, unknown>;
+};

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,2 @@
+import type { UpdateSubscriptionCheckoutPlanInput, UpdateSubscriptionCheckoutPlanResponse } from './types.js';
+export declare function updateStripeSubscriptionCheckoutPlan(input: UpdateSubscriptionCheckoutPlanInput): Promise<UpdateSubscriptionCheckoutPlanResponse>;

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

@@ -0,0 +1,5 @@
+import { funnelSdkService } from '@funnelsgrove/runtime';
+import { toSubscriptionCheckoutPlanRequest } from './requests.js';
+export async function updateStripeSubscriptionCheckoutPlan(input) {
+    return funnelSdkService.updateSubscriptionCheckoutPlan(toSubscriptionCheckoutPlanRequest(input));
+}

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

@@ -0,0 +1,2 @@
+import type { VerifySubscriptionCheckoutPaymentInput, VerifySubscriptionCheckoutPaymentResponse } from './types.js';
+export declare function verifyStripeSubscriptionCheckoutPayment(input: VerifySubscriptionCheckoutPaymentInput): Promise<VerifySubscriptionCheckoutPaymentResponse>;

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

@@ -0,0 +1,5 @@
+import { funnelSdkService } from '@funnelsgrove/runtime';
+import { toSubscriptionCheckoutStatusRequest } from './requests.js';
+export async function verifyStripeSubscriptionCheckoutPayment(input) {
+    return funnelSdkService.verifySubscriptionCheckout(toSubscriptionCheckoutStatusRequest(input));
+}

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

@@ -0,0 +1,2 @@
+import type { CreateCheckoutSessionInput, CreateCheckoutSessionResponse } from './types.js';
+export declare function createStripeCheckoutSession(input: CreateCheckoutSessionInput): Promise<CreateCheckoutSessionResponse>;

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

@@ -0,0 +1,5 @@
+import { funnelSdkService } from '@funnelsgrove/runtime';
+import { toHostedCheckoutRequest } from './requests.js';
+export async function createStripeCheckoutSession(input) {
+    return funnelSdkService.createHostedCheckoutSession(toHostedCheckoutRequest(input));
+}

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

@@ -0,0 +1,2 @@
+import type { CreateCheckoutSessionInput } from './types.js';
+export declare function redirectToStripeCheckout(input: CreateCheckoutSessionInput): Promise<string>;

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

@@ -0,0 +1,13 @@
+import { createStripeCheckoutSession } from './createCheckoutSession.js';
+export async function redirectToStripeCheckout(input) {
+    var _a;
+    const response = await createStripeCheckoutSession(input);
+    const checkoutUrl = (_a = response.url) === null || _a === void 0 ? void 0 : _a.trim();
+    if (!checkoutUrl) {
+        throw new Error('Stripe did not return a checkout url');
+    }
+    if (typeof window !== 'undefined') {
+        window.location.assign(checkoutUrl);
+    }
+    return checkoutUrl;
+}

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

@@ -0,0 +1,20 @@
+import type { CreateCheckoutSessionInput } from './types.js';
+export declare const toHostedCheckoutRequest: (input: CreateCheckoutSessionInput) => {
+    offerSetId: string | undefined;
+    offerSetKey: string | undefined;
+    planId: string;
+    providerPlanId: string | undefined;
+    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

@@ -0,0 +1,26 @@
+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;
+    const recurring = requireCheckoutRecurringConfig(input.plan);
+    return {
+        offerSetId: ((_a = input.plan.offerSetId) === null || _a === void 0 ? void 0 : _a.trim()) || undefined,
+        offerSetKey: ((_b = input.plan.offerSetKey) === null || _b === void 0 ? void 0 : _b.trim()) || undefined,
+        planId: getPaywallPlanRequestId(input.plan),
+        providerPlanId: ((_c = input.plan.providerPlanId) === null || _c === void 0 ? void 0 : _c.trim()) || undefined,
+        title: input.plan.title,
+        description: ((_d = input.plan.description) === null || _d === void 0 ? void 0 : _d.trim()) || undefined,
+        amountCents: input.plan.amountCents,
+        billingInterval: recurring.interval,
+        billingIntervalCount: recurring.intervalCount,
+        couponId: ((_e = input.couponId) === null || _e === void 0 ? void 0 : _e.trim()) || undefined,
+        analyticsMetadata: normalizeCheckoutAnalyticsMetadata(input.analyticsMetadata, input.plan),
+        successUrl: input.successUrl,
+        cancelUrl: input.cancelUrl,
+        customerEmail: ((_f = input.customerEmail) === null || _f === void 0 ? void 0 : _f.trim()) || undefined,
+        userId: ((_g = input.user_id) === null || _g === void 0 ? void 0 : _g.trim()) || undefined,
+        environment: input.environment,
+        runtimeConfig: input.runtimeConfig,
+    };
+};

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

@@ -0,0 +1,24 @@
+import type { CheckoutSessionPlanInput } from '../../../../services/paywallPlans/types.js';
+import type { RuntimeMode } from '@funnelsgrove/runtime';
+import type { StripeRuntimeConfigOverrides } from '../shared/types.js';
+export type CreateCheckoutSessionInput = {
+    plan: CheckoutSessionPlanInput;
+    successUrl: string;
+    cancelUrl: string;
+    couponId?: string | null;
+    analyticsMetadata?: Record<string, unknown> | null;
+    customerEmail?: string | null;
+    user_id?: string | null;
+    environment?: RuntimeMode;
+    runtimeConfig?: StripeRuntimeConfigOverrides;
+};
+export type CreateCheckoutSessionResponse = {
+    sessionId?: string;
+    url: string;
+    stripePublishableKey?: string;
+    environment?: 'test' | 'live';
+    paymentProfileId?: string;
+    userId?: string;
+    anonymousUserId?: string;
+    funnelEndUserId?: string;
+};

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,2 @@
+import type { ChargeOneClickPaymentInput, ChargeOneClickPaymentResponse } from './types.js';
+export declare function chargeStripeOneClickPayment(input: ChargeOneClickPaymentInput): Promise<ChargeOneClickPaymentResponse>;

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

@@ -0,0 +1,5 @@
+import { funnelSdkService } from '@funnelsgrove/runtime';
+import { toOneClickPaymentRequest } from './requests.js';
+export async function chargeStripeOneClickPayment(input) {
+    return funnelSdkService.chargeOneClickPayment(toOneClickPaymentRequest(input));
+}

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

@@ -0,0 +1,3 @@
+import type { CompleteStripeOneClickPaymentInput, CompleteStripeOneClickPaymentResponse } from './types.js';
+export declare const requiresStripeOneClickConfirmation: (status: string) => boolean;
+export declare function completeStripeOneClickPayment(input: CompleteStripeOneClickPaymentInput): Promise<CompleteStripeOneClickPaymentResponse>;

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

@@ -0,0 +1,13 @@
+import { chargeStripeOneClickPayment } from './chargePayment.js';
+import { confirmOneClickPayment } from './confirmation.js';
+export const requiresStripeOneClickConfirmation = (status) => {
+    return status === 'requires_action' || status === 'requires_confirmation';
+};
+export async function completeStripeOneClickPayment(input) {
+    const payment = await chargeStripeOneClickPayment(input);
+    if (!requiresStripeOneClickConfirmation(payment.status)) {
+        return Object.assign(Object.assign({}, payment), { confirmationAttempted: false });
+    }
+    const status = await confirmOneClickPayment(payment, input);
+    return Object.assign(Object.assign({}, payment), { status, confirmationAttempted: true });
+}

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

@@ -0,0 +1,6 @@
+import type { RuntimeMode } from '@funnelsgrove/runtime';
+import type { ChargeOneClickPaymentResponse } from './types.js';
+export declare const confirmOneClickPayment: (payment: ChargeOneClickPaymentResponse, input: {
+    returnUrl: string;
+    environment?: RuntimeMode;
+}) => Promise<string>;

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

@@ -0,0 +1,22 @@
+import { getStripePromise } from '../stripeClient.js';
+export const confirmOneClickPayment = async (payment, input) => {
+    var _a, _b, _c, _d, _e, _f;
+    const clientSecret = (_a = payment.clientSecret) === null || _a === void 0 ? void 0 : _a.trim();
+    const stripePublishableKey = (_b = payment.stripePublishableKey) === null || _b === void 0 ? void 0 : _b.trim();
+    if (!clientSecret || !stripePublishableKey) {
+        throw new Error('One-click payment requires Stripe confirmation, but confirmation details are missing.');
+    }
+    const stripe = await getStripePromise((_d = (_c = payment.environment) !== null && _c !== void 0 ? _c : input.environment) !== null && _d !== void 0 ? _d : 'live', stripePublishableKey);
+    if (!stripe) {
+        throw new Error('Stripe could not be initialized for one-click payment confirmation.');
+    }
+    const confirmation = await stripe.confirmPayment({
+        clientSecret,
+        confirmParams: { return_url: input.returnUrl },
+        redirect: 'if_required',
+    });
+    if (confirmation.error) {
+        throw new Error(confirmation.error.message || 'Unable to confirm one-click payment.');
+    }
+    return (_f = (_e = confirmation.paymentIntent) === null || _e === void 0 ? void 0 : _e.status) !== null && _f !== void 0 ? _f : payment.status;
+};

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

@@ -0,0 +1,20 @@
+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;
+    userId: string | undefined;
+    stripeCustomerId: string | undefined;
+    checkoutSessionId: string | undefined;
+    idempotencyKey: string | undefined;
+    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
+    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+};

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

@@ -0,0 +1,23 @@
+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,
+    };
+};

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

@@ -0,0 +1,40 @@
+import type { RuntimeMode } from '@funnelsgrove/runtime';
+import type { StripeRuntimeConfigOverrides } from '../shared/types.js';
+export type ChargeOneClickPaymentInput = {
+    planId: string;
+    planKey?: string | null;
+    offerSetId?: string | null;
+    runtimeConfigRevisionId?: string | null;
+    paymentProfileId?: string | null;
+    provider?: 'stripe' | null;
+    providerPlanId?: string | null;
+    amountCents: number;
+    analyticsMetadata?: Record<string, unknown> | null;
+    checkoutSessionId?: string | null;
+    currency?: string | null;
+    description?: string | null;
+    idempotencyKey?: string | null;
+    stripeCustomerId?: string | null;
+    userId?: string | null;
+    /** @deprecated Use stripeCustomerId. */
+    stripe_customer_id?: string | null;
+    /** @deprecated Use userId. */
+    user_id?: string | null;
+    environment?: RuntimeMode;
+    runtimeConfig?: StripeRuntimeConfigOverrides;
+};
+export type ChargeOneClickPaymentResponse = {
+    paymentIntentId: string;
+    status: string;
+    amountCents?: number;
+    clientSecret?: string;
+    currency?: string;
+    environment?: 'test' | 'live';
+    stripePublishableKey?: string;
+};
+export type CompleteStripeOneClickPaymentInput = ChargeOneClickPaymentInput & {
+    returnUrl: string;
+};
+export type CompleteStripeOneClickPaymentResponse = ChargeOneClickPaymentResponse & {
+    confirmationAttempted: boolean;
+};

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

@@ -0,0 +1 @@
+export {};

package/dist/providers/stripe/services/paymentIntent/createPaymentIntent.d.ts

@@ -0,0 +1,5 @@
+import type { CreatePaymentIntentInput, CreatePaymentIntentResponse } from './types.js';
+/**
+ * @deprecated Use createStripeOneTimeCheckout for one-time paywall checkout.
+ */
+export declare function createStripePaymentIntent(input: CreatePaymentIntentInput): Promise<CreatePaymentIntentResponse>;

package/dist/providers/stripe/services/paymentIntent/createPaymentIntent.js

@@ -0,0 +1,8 @@
+import { funnelSdkService } from '@funnelsgrove/runtime';
+import { toPaymentIntentRequest } from './requests.js';
+/**
+ * @deprecated Use createStripeOneTimeCheckout for one-time paywall checkout.
+ */
+export async function createStripePaymentIntent(input) {
+    return funnelSdkService.createOneTimePaymentIntent(toPaymentIntentRequest(input));
+}