@funnelsgrove/payments 0.11.4 → 0.11.5

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

@@ -0,0 +1,12 @@
+import type { CreatePaymentIntentInput } from './types.js';
+export declare const toPaymentIntentRequest: (input: CreatePaymentIntentInput) => {
+    offerSetId: string | undefined;
+    offerSetKey: string | undefined;
+    planId: string;
+    amountCents: number;
+    couponId: string | undefined;
+    analyticsMetadata: Record<string, unknown> | undefined;
+    userId: string | undefined;
+    environment: import("@funnelsgrove/runtime").RuntimeMode | undefined;
+    runtimeConfig: import("@funnelsgrove/runtime").FunnelSdkRuntimeConfigOverrides | undefined;
+};

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

@@ -0,0 +1,15 @@
+import { normalizeAnalyticsMetadata } from '../shared/checkoutMetadata.js';
+export const toPaymentIntentRequest = (input) => {
+    var _a, _b, _c, _d;
+    return {
+        offerSetId: ((_a = input.offerSetId) === null || _a === void 0 ? void 0 : _a.trim()) || undefined,
+        offerSetKey: ((_b = input.offerSetKey) === null || _b === void 0 ? void 0 : _b.trim()) || undefined,
+        planId: input.planId,
+        amountCents: input.amountCents,
+        couponId: ((_c = input.couponId) === null || _c === void 0 ? void 0 : _c.trim()) || undefined,
+        analyticsMetadata: normalizeAnalyticsMetadata(input.analyticsMetadata),
+        userId: ((_d = input.user_id) === null || _d === void 0 ? void 0 : _d.trim()) || undefined,
+        environment: input.environment,
+        runtimeConfig: input.runtimeConfig,
+    };
+};

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

@@ -0,0 +1,18 @@
+import type { RuntimeMode } from '@funnelsgrove/runtime';
+import type { StripeRuntimeConfigOverrides } from '../shared/types.js';
+export type CreatePaymentIntentInput = {
+    planId: string;
+    offerSetId?: string | null;
+    offerSetKey?: string | null;
+    amountCents: number;
+    couponId?: string | null;
+    analyticsMetadata?: Record<string, unknown> | null;
+    user_id?: string | null;
+    environment?: RuntimeMode;
+    runtimeConfig?: StripeRuntimeConfigOverrides;
+};
+export type CreatePaymentIntentResponse = {
+    clientSecret: string;
+    stripePublishableKey?: string;
+    environment?: 'test' | 'live';
+};

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

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

package/dist/providers/stripe/services/shared/checkout.validator.d.ts

@@ -0,0 +1,3 @@
+import type { CheckoutSessionPlanInput } from '../../../../services/paywallPlans/types.js';
+export declare const requireCheckoutRecurringConfig: (plan: CheckoutSessionPlanInput) => import("../../../../services/paywallPlans/types.js").CheckoutPlanRecurringConfig;
+export declare const requireCheckoutSessionId: (value: string) => string;

package/dist/providers/stripe/services/shared/checkout.validator.js

@@ -0,0 +1,15 @@
+import { resolveCheckoutPlanRecurringConfig } from '../../../../services/paywallPlans/recurring.js';
+export const requireCheckoutRecurringConfig = (plan) => {
+    const recurring = resolveCheckoutPlanRecurringConfig(plan);
+    if (!recurring) {
+        throw new Error('Unable to resolve the recurring interval for the selected plan');
+    }
+    return recurring;
+};
+export const requireCheckoutSessionId = (value) => {
+    const checkoutSessionId = value.trim();
+    if (!checkoutSessionId) {
+        throw new Error('checkoutSessionId is required');
+    }
+    return checkoutSessionId;
+};

package/dist/providers/stripe/services/shared/checkoutMetadata.d.ts

@@ -0,0 +1,3 @@
+import type { CheckoutSessionPlanInput } from '../../../../services/paywallPlans/types.js';
+export declare const normalizeAnalyticsMetadata: (metadata: Record<string, unknown> | null | undefined) => Record<string, unknown> | undefined;
+export declare const normalizeCheckoutAnalyticsMetadata: (metadata: Record<string, unknown> | null | undefined, plan: Pick<CheckoutSessionPlanInput, "analyticsPurchaseValue">) => Record<string, unknown> | undefined;

package/dist/providers/stripe/services/shared/checkoutMetadata.js

@@ -0,0 +1,107 @@
+const isRecord = (value) => {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+};
+const asTrimmedStringOrNull = (value) => {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    return value.trim() || null;
+};
+const asNonNegativeNumberOrNull = (value) => {
+    const numeric = typeof value === 'number'
+        ? value
+        : typeof value === 'string' && value.trim()
+            ? Number(value.trim())
+            : null;
+    if (numeric === null || !Number.isFinite(numeric) || numeric < 0) {
+        return null;
+    }
+    return Math.round(numeric * 100) / 100;
+};
+const SENSITIVE_CHECKOUT_URL_QUERY_KEYS = new Set([
+    'customeremail',
+    'customer_email',
+    'email',
+    'fullname',
+    'full_name',
+    'name',
+    'phone',
+    'phonenumber',
+    'phone_number',
+]);
+const sanitizeCheckoutUrl = (value) => {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    try {
+        const parsed = new URL(trimmed, typeof window !== 'undefined' ? window.location.origin : 'https://example.invalid');
+        for (const key of Array.from(parsed.searchParams.keys())) {
+            if (SENSITIVE_CHECKOUT_URL_QUERY_KEYS.has(key.trim().toLowerCase())) {
+                parsed.searchParams.delete(key);
+            }
+        }
+        return parsed.toString();
+    }
+    catch (_a) {
+        return trimmed;
+    }
+};
+const currentCheckoutUrl = () => {
+    var _a;
+    if (typeof window === 'undefined') {
+        return undefined;
+    }
+    return sanitizeCheckoutUrl((_a = window.location) === null || _a === void 0 ? void 0 : _a.href);
+};
+const readMetaCookieValue = (name) => {
+    var _a;
+    if (typeof document === 'undefined') {
+        return undefined;
+    }
+    let cookieHeader;
+    try {
+        cookieHeader = document.cookie;
+    }
+    catch (_b) {
+        return undefined;
+    }
+    const encodedValue = (_a = cookieHeader
+        .split(';')
+        .map((part) => part.trim())
+        .find((part) => part.startsWith(`${name}=`))) === null || _a === void 0 ? void 0 : _a.slice(name.length + 1);
+    if (!encodedValue) {
+        return undefined;
+    }
+    try {
+        const value = decodeURIComponent(encodedValue).trim();
+        return value && value.length <= 2048 ? value : undefined;
+    }
+    catch (_c) {
+        const value = encodedValue.trim();
+        return value && value.length <= 2048 ? value : undefined;
+    }
+};
+export const normalizeAnalyticsMetadata = (metadata) => {
+    const normalized = Object.fromEntries(Object.entries(isRecord(metadata) ? metadata : {}).filter(([, value]) => value !== undefined && value !== null && value !== ''));
+    const fbc = asTrimmedStringOrNull(normalized.fbc) ||
+        asTrimmedStringOrNull(normalized._fbc) ||
+        readMetaCookieValue('_fbc');
+    const fbp = asTrimmedStringOrNull(normalized.fbp) ||
+        asTrimmedStringOrNull(normalized._fbp) ||
+        readMetaCookieValue('_fbp');
+    const checkoutUrl = sanitizeCheckoutUrl(normalized.url) || currentCheckoutUrl();
+    const withCheckoutUrl = Object.assign(Object.assign(Object.assign(Object.assign({}, normalized), (fbc ? { fbc } : {})), (fbp ? { fbp } : {})), (checkoutUrl ? { url: checkoutUrl } : {}));
+    return Object.keys(withCheckoutUrl).length > 0 ? withCheckoutUrl : undefined;
+};
+export const normalizeCheckoutAnalyticsMetadata = (metadata, plan) => {
+    const normalized = normalizeAnalyticsMetadata(metadata);
+    const analyticsPurchaseValue = asNonNegativeNumberOrNull(plan.analyticsPurchaseValue);
+    if (analyticsPurchaseValue === null) {
+        return normalized;
+    }
+    return Object.assign(Object.assign({}, (normalized !== null && normalized !== void 0 ? normalized : {})), { analyticsPurchaseValue });
+};

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

@@ -0,0 +1,2 @@
+import type { FunnelSdkRuntimeConfigOverrides } from '@funnelsgrove/runtime';
+export type StripeRuntimeConfigOverrides = FunnelSdkRuntimeConfigOverrides;

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

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

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

@@ -1,221 +1,29 @@
-import { type Stripe } from '@stripe/stripe-js';
-import { type BillingFallbackPlanConfig, type BillingPlanCatalog, type BillingPlanInterval, type BillingPlanInputCatalog } from '../../../config/billing.config.js';
-import { type FunnelSdkRuntimeConfigOverrides, type ResolvedCountryPricing } from '@funnelsgrove/runtime';
-import type { RuntimeMode } from '@funnelsgrove/runtime';
-export type PaywallPlan = {
-    id: string;
-    funnelPlanKey?: string;
-    projectPlanId?: string;
-    offerSetId?: string;
-    offerSetKey?: string;
-    title: string;
-    description?: string;
-    providerPlanId?: string;
-    priceLabel: string;
-    oldPriceLabel?: string;
-    featuredTag?: string;
-    perDayAmount: string;
-    perDayLabel: string;
-    amountCents: number;
-    analyticsPurchaseValue?: number;
-    comparison?: BillingFallbackPlanConfig['comparison'];
-    checkoutOriginalAmountCents?: number;
-    checkoutSummaryLabel?: string;
-    billingInterval?: BillingPlanInterval;
-    billingIntervalCount?: number;
-    followUpProviderPlanId?: string;
-    followUpPlanTitle?: string;
-    followUpBillingInterval?: BillingPlanInterval;
-    followUpBillingIntervalCount?: number;
-    introIterations?: number;
-    source: 'stripe' | 'config';
-};
-export type StripeRuntimeConfigOverrides = FunnelSdkRuntimeConfigOverrides;
-export type PaywallPlanResolutionOptions = {
-    locale?: string | null;
-    pricing?: ResolvedCountryPricing<string> | null;
-};
-export declare function buildConfigPaywallPlans(planCatalog?: BillingPlanCatalog | readonly BillingFallbackPlanConfig[], orderedPlanIds?: readonly string[]): readonly PaywallPlan[];
-export declare function getFallbackPlans(planCatalog?: BillingPlanInputCatalog | readonly BillingFallbackPlanConfig[], options?: PaywallPlanResolutionOptions): readonly PaywallPlan[];
-export declare function getOrderedPaywallPlans(plans: readonly PaywallPlan[], orderedPlanIds: readonly string[]): readonly PaywallPlan[];
-export declare function getDefaultPlanId(plans: readonly PaywallPlan[], pricing?: ResolvedCountryPricing<string> | null): string | null;
-export declare function getPaywallPlanSelectionValue(plan: Pick<PaywallPlan, 'id' | 'providerPlanId'>): string;
-export declare function findPaywallPlan(plans: readonly PaywallPlan[], selectionValue: string | null | undefined): PaywallPlan | null;
-export declare function getDefaultPlanSelectionValue(plans: readonly PaywallPlan[], pricing?: ResolvedCountryPricing<string> | null): string | null;
-export declare function isStripeConfigured(mode: RuntimeMode): boolean;
-export declare function getStripePromise(_mode: RuntimeMode, runtimePublishableKey?: string | null): Promise<Stripe | null> | null;
-type CheckoutSessionPlanInput = Pick<PaywallPlan, 'amountCents' | 'analyticsPurchaseValue' | 'billingInterval' | 'billingIntervalCount' | 'description' | 'funnelPlanKey' | 'id' | 'providerPlanId' | 'title' | 'followUpProviderPlanId' | 'followUpPlanTitle' | 'followUpBillingInterval' | 'followUpBillingIntervalCount' | 'introIterations' | 'offerSetId' | 'offerSetKey'>;
-type CheckoutPlanRecurringConfig = {
-    interval: BillingPlanInterval;
-    intervalCount: number;
-};
-export declare const resolveCheckoutPlanRecurringConfig: (plan: CheckoutSessionPlanInput) => CheckoutPlanRecurringConfig | null;
-type CreatePaymentIntentInput = {
-    planId: string;
-    offerSetId?: string | null;
-    offerSetKey?: string | null;
-    amountCents: number;
-    couponId?: string | null;
-    analyticsMetadata?: Record<string, unknown> | null;
-    user_id?: string | null;
-    environment?: RuntimeMode;
-    runtimeConfig?: StripeRuntimeConfigOverrides;
-};
-type CreatePaymentIntentResponse = {
-    clientSecret: string;
-    stripePublishableKey?: string;
-    environment?: 'test' | 'live';
-};
-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;
-};
-type CreateOneTimeCheckoutResponse = {
-    clientSecret: string;
-    checkoutSessionId?: string;
-    stripePublishableKey?: string;
-    environment?: 'test' | 'live';
-    paymentProfileId?: string;
-    userId?: string;
-    anonymousUserId?: string;
-    funnelEndUserId?: string;
-};
-export declare function createStripeOneTimeCheckout(input: CreateOneTimeCheckoutInput): Promise<CreateOneTimeCheckoutResponse>;
-/**
- * @deprecated Use createStripeOneTimeCheckout for one-time paywall checkout.
- */
-export declare function createStripePaymentIntent(input: CreatePaymentIntentInput): Promise<CreatePaymentIntentResponse>;
-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 declare function chargeStripeOneClickPayment(input: ChargeOneClickPaymentInput): Promise<ChargeOneClickPaymentResponse>;
-export type CompleteStripeOneClickPaymentInput = ChargeOneClickPaymentInput & {
-    returnUrl: string;
-};
-export type CompleteStripeOneClickPaymentResponse = ChargeOneClickPaymentResponse & {
-    confirmationAttempted: boolean;
-};
-export declare const requiresStripeOneClickConfirmation: (status: string) => boolean;
-export declare function completeStripeOneClickPayment(input: CompleteStripeOneClickPaymentInput): Promise<CompleteStripeOneClickPaymentResponse>;
-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;
-};
-type CreateSubscriptionCheckoutResponse = {
-    clientSecret: string;
-    checkoutSessionId?: string;
-    subscriptionId?: string;
-    stripePublishableKey?: string;
-    environment?: 'test' | 'live';
-    paymentProfileId?: string;
-    userId?: string;
-    anonymousUserId?: string;
-    funnelEndUserId?: string;
-};
-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;
-};
-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>;
-};
-export declare function createStripeSubscriptionCheckout(input: CreateSubscriptionCheckoutInput): Promise<CreateSubscriptionCheckoutResponse>;
-export declare function updateStripeSubscriptionCheckoutPlan(input: UpdateSubscriptionCheckoutPlanInput): Promise<UpdateSubscriptionCheckoutPlanResponse>;
-export declare function verifyStripeSubscriptionCheckoutPayment(input: VerifySubscriptionCheckoutPaymentInput): Promise<VerifySubscriptionCheckoutPaymentResponse>;
-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;
-};
-type CreateCheckoutSessionResponse = {
-    sessionId?: string;
-    url: string;
-    stripePublishableKey?: string;
-    environment?: 'test' | 'live';
-    paymentProfileId?: string;
-    userId?: string;
-    anonymousUserId?: string;
-    funnelEndUserId?: string;
-};
-export declare function createStripeCheckoutSession(input: CreateCheckoutSessionInput): Promise<CreateCheckoutSessionResponse>;
-export declare function redirectToStripeCheckout(input: CreateCheckoutSessionInput): Promise<string>;
-export {};
+export type { PaywallPlan } from '../../../services/paywallPlans/types.js';
+export type { StripeRuntimeConfigOverrides } from './shared/types.js';
+export type { PaywallPlanResolutionOptions } from '../../../services/paywallPlans/types.js';
+export { buildConfigPaywallPlans } from '../../../services/paywallPlans/selection.js';
+export { getFallbackPlans } from '../../../services/paywallPlans/selection.js';
+export { getOrderedPaywallPlans } from '../../../services/paywallPlans/selection.js';
+export { getDefaultPlanId } from '../../../services/paywallPlans/selection.js';
+export { getPaywallPlanSelectionValue } from '../../../services/paywallPlans/selection.js';
+export { findPaywallPlan } from '../../../services/paywallPlans/selection.js';
+export { getDefaultPlanSelectionValue } from '../../../services/paywallPlans/selection.js';
+export { isStripeConfigured } from './stripeClient.js';
+export { getStripePromise } from './stripeClient.js';
+export { resolveCheckoutPlanRecurringConfig } from '../../../services/paywallPlans/recurring.js';
+export { createStripeOneTimeCheckout } from './checkout/createOneTimeCheckout.js';
+export { createStripePaymentIntent } from './paymentIntent/createPaymentIntent.js';
+export type { ChargeOneClickPaymentInput } from './oneClick/types.js';
+export type { ChargeOneClickPaymentResponse } from './oneClick/types.js';
+export { chargeStripeOneClickPayment } from './oneClick/chargePayment.js';
+export type { CompleteStripeOneClickPaymentInput } from './oneClick/types.js';
+export type { CompleteStripeOneClickPaymentResponse } from './oneClick/types.js';
+export { requiresStripeOneClickConfirmation } from './oneClick/completePayment.js';
+export { completeStripeOneClickPayment } from './oneClick/completePayment.js';
+export type { VerifySubscriptionCheckoutPaymentInput } from './checkout/types.js';
+export type { VerifySubscriptionCheckoutPaymentResponse } from './checkout/types.js';
+export { createStripeSubscriptionCheckout } from './checkout/createSubscriptionCheckout.js';
+export { updateStripeSubscriptionCheckoutPlan } from './checkout/updateSubscriptionCheckoutPlan.js';
+export { verifyStripeSubscriptionCheckoutPayment } from './checkout/verifySubscriptionCheckoutPayment.js';
+export { createStripeCheckoutSession } from './hostedCheckout/createCheckoutSession.js';
+export { redirectToStripeCheckout } from './hostedCheckout/redirectToCheckout.js';