@funnelsgrove/payments 0.11.4 → 0.11.6

package/dist/services/paywallPlans/recurring.js

@@ -0,0 +1,72 @@
+const asTrimmedStringOrNull = (value) => {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed || null;
+};
+const asFiniteNumberOrNull = (value) => {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        return null;
+    }
+    return value;
+};
+const asPositiveIntOrNull = (value) => {
+    const numeric = asFiniteNumberOrNull(value);
+    if (numeric === null || numeric <= 0) {
+        return null;
+    }
+    return Math.round(numeric);
+};
+const asBillingPlanIntervalOrNull = (value) => {
+    var _a;
+    const normalized = (_a = asTrimmedStringOrNull(value)) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+    if (normalized !== 'day' &&
+        normalized !== 'week' &&
+        normalized !== 'month' &&
+        normalized !== 'year') {
+        return null;
+    }
+    return normalized;
+};
+const inferCheckoutPlanRecurringFromText = (value) => {
+    const normalized = value === null || value === void 0 ? void 0 : value.trim().toLowerCase();
+    if (!normalized) {
+        return null;
+    }
+    const countedMatch = normalized.match(/(\d+)\s*[- ]?(day|week|month|year)s?\b/);
+    if (countedMatch) {
+        return {
+            interval: countedMatch[2],
+            intervalCount: Number.parseInt(countedMatch[1] || '1', 10) || 1,
+        };
+    }
+    if (normalized.includes('daily') || normalized.includes('day')) {
+        return { interval: 'day', intervalCount: 1 };
+    }
+    if (normalized.includes('weekly') || normalized.includes('week')) {
+        return { interval: 'week', intervalCount: 1 };
+    }
+    if (normalized.includes('monthly') || normalized.includes('month')) {
+        return { interval: 'month', intervalCount: 1 };
+    }
+    if (normalized.includes('yearly') ||
+        normalized.includes('annual') ||
+        normalized.includes('year')) {
+        return { interval: 'year', intervalCount: 1 };
+    }
+    return null;
+};
+export const resolveCheckoutPlanRecurringConfig = (plan) => {
+    const explicitInterval = asBillingPlanIntervalOrNull(plan.billingInterval);
+    if (explicitInterval) {
+        return {
+            interval: explicitInterval,
+            intervalCount: asPositiveIntOrNull(plan.billingIntervalCount) || 1,
+        };
+    }
+    return (inferCheckoutPlanRecurringFromText(plan.title) ||
+        inferCheckoutPlanRecurringFromText(plan.providerPlanId) ||
+        inferCheckoutPlanRecurringFromText(plan.id) ||
+        inferCheckoutPlanRecurringFromText(plan.description));
+};

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

@@ -0,0 +1,11 @@
+import type { BillingFallbackPlanConfig, BillingPlanCatalog, BillingPlanInputCatalog } from '../../config/billing.config.js';
+import type { PaywallPlan, PaywallPlanResolutionOptions } from './types.js';
+import type { ResolvedCountryPricing } from '@funnelsgrove/runtime';
+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 const getPaywallPlanRequestId: (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;

package/dist/services/paywallPlans/selection.js

@@ -0,0 +1,144 @@
+import { billingPlanList } from '../../config/billing.config.js';
+import { isBillingPlanMappingCatalog } from '../planCatalog.service.js';
+const parseBillingIntervalFromText = (value) => {
+    const normalized = (value === null || value === void 0 ? void 0 : value.trim().toLowerCase()) || '';
+    if (!normalized) {
+        return null;
+    }
+    const explicitMatch = normalized.match(/(?:^|[^a-z])(\d+)?\s*-?\s*(day|week|month|year)s?(?:[^a-z]|$)/);
+    if (explicitMatch === null || explicitMatch === void 0 ? void 0 : explicitMatch[2]) {
+        return {
+            interval: explicitMatch[2],
+            intervalCount: explicitMatch[1] ? Number(explicitMatch[1]) : 1,
+        };
+    }
+    const slashMatch = normalized.match(/\/\s*(day|week|month|year)s?\b/);
+    if (slashMatch === null || slashMatch === void 0 ? void 0 : slashMatch[1]) {
+        return {
+            interval: slashMatch[1],
+            intervalCount: 1,
+        };
+    }
+    return null;
+};
+const resolveConfigBillingInterval = (plan) => {
+    var _a, _b, _c, _d;
+    const inferred = (_a = parseBillingIntervalFromText(plan.priceLabel)) !== null && _a !== void 0 ? _a : parseBillingIntervalFromText(plan.title);
+    const interval = (_b = plan.billingInterval) !== null && _b !== void 0 ? _b : inferred === null || inferred === void 0 ? void 0 : inferred.interval;
+    if (!interval) {
+        return {};
+    }
+    return {
+        interval,
+        intervalCount: (_d = (_c = plan.billingIntervalCount) !== null && _c !== void 0 ? _c : inferred === null || inferred === void 0 ? void 0 : inferred.intervalCount) !== null && _d !== void 0 ? _d : 1,
+    };
+};
+const toConfigPaywallPlan = (key, plan) => {
+    var _a, _b, _c;
+    const interval = resolveConfigBillingInterval(plan);
+    return Object.assign(Object.assign({}, plan), { id: ((_a = plan.id) === null || _a === void 0 ? void 0 : _a.trim()) || key.trim() || ((_b = plan.providerPlanId) === null || _b === void 0 ? void 0 : _b.trim()) || plan.projectPlanId.trim(), perDayLabel: ((_c = plan.perDayLabel) === null || _c === void 0 ? void 0 : _c.trim()) || 'per day', billingInterval: interval.interval, billingIntervalCount: interval.intervalCount, source: 'config' });
+};
+const fallbackPaywallPlans = buildConfigPaywallPlans(billingPlanList);
+const reorderPlans = (plans, pricing) => {
+    if (!pricing || pricing.offerOrder.length === 0) {
+        return plans;
+    }
+    const orderByPlanId = new Map(pricing.offerOrder.map((planId, index) => [planId, index]));
+    return [...plans].sort((left, right) => {
+        const leftIndex = orderByPlanId.get(left.id);
+        const rightIndex = orderByPlanId.get(right.id);
+        if (leftIndex === undefined && rightIndex === undefined) {
+            return 0;
+        }
+        if (leftIndex === undefined) {
+            return 1;
+        }
+        if (rightIndex === undefined) {
+            return -1;
+        }
+        return leftIndex - rightIndex;
+    });
+};
+export function buildConfigPaywallPlans(planCatalog, orderedPlanIds = []) {
+    const plans = Array.isArray(planCatalog)
+        ? planCatalog.map((plan, index) => toConfigPaywallPlan(String(index), plan))
+        : Object.entries(planCatalog !== null && planCatalog !== void 0 ? planCatalog : {}).map(([key, plan]) => toConfigPaywallPlan(key, plan));
+    return getOrderedPaywallPlans(plans, orderedPlanIds);
+}
+const toFallbackPaywallPlans = (planCatalog, options) => {
+    const sourcePlans = buildConfigPaywallPlans(planCatalog);
+    return reorderPlans(sourcePlans.length > 0 ? sourcePlans : fallbackPaywallPlans, options === null || options === void 0 ? void 0 : options.pricing);
+};
+const isFallbackBillingPlanCatalog = (planCatalog) => {
+    return Array.isArray(planCatalog) || !isBillingPlanMappingCatalog(planCatalog);
+};
+export function getFallbackPlans(planCatalog, options) {
+    if (!planCatalog) {
+        return reorderPlans(fallbackPaywallPlans, options === null || options === void 0 ? void 0 : options.pricing);
+    }
+    if (!isFallbackBillingPlanCatalog(planCatalog)) {
+        return [];
+    }
+    return toFallbackPaywallPlans(planCatalog, options);
+}
+export function getOrderedPaywallPlans(plans, orderedPlanIds) {
+    if (orderedPlanIds.length === 0) {
+        return plans;
+    }
+    const planByKey = new Map();
+    for (const plan of plans) {
+        for (const key of [plan.id, plan.providerPlanId]) {
+            const normalizedKey = key === null || key === void 0 ? void 0 : key.trim();
+            if (normalizedKey && !planByKey.has(normalizedKey)) {
+                planByKey.set(normalizedKey, plan);
+            }
+        }
+    }
+    const selectedPlans = [];
+    const selectedPlanIds = new Set();
+    for (const planId of orderedPlanIds) {
+        const plan = planByKey.get(planId.trim()) || null;
+        if (!plan || selectedPlanIds.has(plan.id)) {
+            continue;
+        }
+        selectedPlans.push(plan);
+        selectedPlanIds.add(plan.id);
+    }
+    return selectedPlans;
+}
+export function getDefaultPlanId(plans, pricing) {
+    var _a, _b;
+    if (plans.length === 0) {
+        return null;
+    }
+    const countryDefaultPlanId = (_a = pricing === null || pricing === void 0 ? void 0 : pricing.defaultOfferKey) === null || _a === void 0 ? void 0 : _a.trim();
+    if (countryDefaultPlanId && plans.some((plan) => plan.id === countryDefaultPlanId)) {
+        return countryDefaultPlanId;
+    }
+    return ((_b = plans[0]) === null || _b === void 0 ? void 0 : _b.id) || null;
+}
+export function getPaywallPlanSelectionValue(plan) {
+    var _a;
+    return ((_a = plan.providerPlanId) === null || _a === void 0 ? void 0 : _a.trim()) || plan.id;
+}
+// The API resolves offer-set mappings by the funnel plan key. Stripe's price id travels in
+// providerPlanId; duplicating it into planId bypasses the configured test/live offer mapping.
+export const getPaywallPlanRequestId = (plan) => plan.id.trim() || getPaywallPlanSelectionValue(plan);
+export function findPaywallPlan(plans, selectionValue) {
+    const normalizedSelectionValue = (selectionValue === null || selectionValue === void 0 ? void 0 : selectionValue.trim()) || '';
+    if (!normalizedSelectionValue) {
+        return null;
+    }
+    return (plans.find((plan) => {
+        var _a;
+        const providerPlanId = ((_a = plan.providerPlanId) === null || _a === void 0 ? void 0 : _a.trim()) || '';
+        return plan.id === normalizedSelectionValue || providerPlanId === normalizedSelectionValue;
+    }) || null);
+}
+export function getDefaultPlanSelectionValue(plans, pricing) {
+    const defaultPlanId = getDefaultPlanId(plans, pricing);
+    if (!defaultPlanId) {
+        return null;
+    }
+    return getPaywallPlanSelectionValue(plans.find((plan) => plan.id === defaultPlanId) || plans[0]);
+}

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

@@ -0,0 +1,39 @@
+import type { BillingFallbackPlanConfig, BillingPlanInterval } from '../../config/billing.config.js';
+import type { ResolvedCountryPricing } 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 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 CheckoutPlanRecurringConfig = {
+    interval: BillingPlanInterval;
+    intervalCount: number;
+};

package/dist/services/paywallPlans/types.js

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

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

@@ -0,0 +1,10 @@
+export type { PaywallPlan } from './paywallPlans/types.js';
+export type { PaywallPlanResolutionOptions } from './paywallPlans/types.js';
+export { buildConfigPaywallPlans } from './paywallPlans/selection.js';
+export { getFallbackPlans } from './paywallPlans/selection.js';
+export { getOrderedPaywallPlans } from './paywallPlans/selection.js';
+export { getDefaultPlanId } from './paywallPlans/selection.js';
+export { getPaywallPlanSelectionValue } from './paywallPlans/selection.js';
+export { findPaywallPlan } from './paywallPlans/selection.js';
+export { getDefaultPlanSelectionValue } from './paywallPlans/selection.js';
+export { resolveCheckoutPlanRecurringConfig } from './paywallPlans/recurring.js';

package/dist/services/paywallPlans.service.js

@@ -0,0 +1,8 @@
+export { buildConfigPaywallPlans } from './paywallPlans/selection.js';
+export { getFallbackPlans } from './paywallPlans/selection.js';
+export { getOrderedPaywallPlans } from './paywallPlans/selection.js';
+export { getDefaultPlanId } from './paywallPlans/selection.js';
+export { getPaywallPlanSelectionValue } from './paywallPlans/selection.js';
+export { findPaywallPlan } from './paywallPlans/selection.js';
+export { getDefaultPlanSelectionValue } from './paywallPlans/selection.js';
+export { resolveCheckoutPlanRecurringConfig } from './paywallPlans/recurring.js';

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

@@ -1,6 +1,6 @@
 import { type FunnelExperimentDefinition, type FunnelManifestExperiment, type OfferSetRuntimePlanOverrides, type ResolvedFunnelRuntimeConfig, type ResolvedPublishedExperiments, type RuntimeMode } from '@funnelsgrove/runtime';
 import type { BillingDiscountCatalog, BillingDiscountList, BillingFallbackPlanConfig, BillingPlanCatalog } from '../config/billing.config.js';
-import { type PaywallPlan } from '../providers/stripe/services/stripe.service.js';
+import { type PaywallPlan } from './paywallPlans.service.js';
 export type PublishedBillingPlan = BillingFallbackPlanConfig & OfferSetRuntimePlanOverrides;
 export type ResolvedPublishedBillingRuntime = {
     revisionId: string | null;

package/dist/services/publishedBillingRuntime.service.js

@@ -1,6 +1,6 @@
 import { resolveGeneratedOfferSetRuntime, resolvePublishedOfferSetSelection, resolvePublishedRuntimeExperiments, } from '@funnelsgrove/runtime';
 import { buildBillingDiscountCatalog } from './paywallOffer.service.js';
-import { buildConfigPaywallPlans, } from '../providers/stripe/services/stripe.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, _h;
     const offerSets = (_a = config === null || config === void 0 ? void 0 : config.offerSets) !== null && _a !== void 0 ? _a : [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/payments",
-  "version": "0.11.4",
+  "version": "0.11.6",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/The-Solid-Grove/funnelsgrove.git",