@funnelsgrove/payments 0.6.0 → 0.7.1

package/README.md

@@ -74,6 +74,7 @@ When a live funnel still uses one of these, migrate the funnel deliberately with
 ## Public Surfaces
 
 - `config/billing.config`: billing catalog, mapping, plan, and discount contracts.
+- `services/publishedBillingRuntime.service`: resolves one published runtime artifact into component-ready plans, defaults, upsells, downsells, discounts, and flow experiments.
 - `services/planCatalog.service`: plan resolution and selection helpers.
 - `services/runtimeBillingPlanCatalog.service`: test/live runtime catalog selection.
 - `services/paywallOffer.service`: timed discount and display-plan helpers.
@@ -82,6 +83,8 @@ When a live funnel still uses one of these, migrate the funnel deliberately with
 - `components/shared/*`: plan selector, checkout dialogs, Express Checkout wrappers, wallet placeholders, and trust assets.
 - `testing/walletCheckoutSmoke`: wallet checkout smoke assertions.
 
+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.
+
 ## Engineering Rules
 
 - Keep provider-specific implementation under `src/providers/<provider>`.

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './services/preview-frame.service.js';
 export * from './services/runtime-mode.service.js';
 export * from './services/planCatalog.service.js';
 export * from './services/runtimeBillingPlanCatalog.service.js';
+export * from './services/publishedBillingRuntime.service.js';
 export * from './services/paywallOffer.service.js';
 export * from './services/stripe.service.js';
 export * from './services/checkoutCompletionAnalytics.service.js';

package/dist/index.js

@@ -4,6 +4,7 @@ export * from './services/preview-frame.service.js';
 export * from './services/runtime-mode.service.js';
 export * from './services/planCatalog.service.js';
 export * from './services/runtimeBillingPlanCatalog.service.js';
+export * from './services/publishedBillingRuntime.service.js';
 export * from './services/paywallOffer.service.js';
 // Stripe API clients and checkout completion handoff.
 export * from './services/stripe.service.js';

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

@@ -0,0 +1,29 @@
+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 './stripe.service.js';
+export type PublishedBillingPlan = BillingFallbackPlanConfig & OfferSetRuntimePlanOverrides;
+export type ResolvedPublishedBillingRuntime = {
+    revisionId: string | null;
+    mode: RuntimeMode;
+    offerSetId: string;
+    experimentId: string | null;
+    variantKey: string | null;
+    experiments: readonly FunnelExperimentDefinition[];
+    flowExperiments: readonly FunnelManifestExperiment[];
+    plans: readonly PaywallPlan[];
+    planCatalog: Record<string, PublishedBillingPlan>;
+    defaultPlanKey: string;
+    discounts: BillingDiscountCatalog | null;
+    upsells: readonly PublishedBillingPlan[];
+    downsells: readonly PublishedBillingPlan[];
+};
+export declare const resolvePublishedBillingRuntime: ({ config, featureFlags, mode, search, defaultOfferSetId, baseCatalogsByMode, fallbackDiscounts, resolvedExperiments, }: {
+    config: ResolvedFunnelRuntimeConfig | null;
+    featureFlags: Readonly<Record<string, string>>;
+    mode: RuntimeMode;
+    search?: string;
+    defaultOfferSetId?: string;
+    baseCatalogsByMode?: Partial<Record<RuntimeMode, BillingPlanCatalog>>;
+    fallbackDiscounts?: BillingDiscountList;
+    resolvedExperiments?: ResolvedPublishedExperiments;
+}) => ResolvedPublishedBillingRuntime;

package/dist/services/publishedBillingRuntime.service.js

@@ -0,0 +1,40 @@
+import { resolveGeneratedOfferSetRuntime, resolvePublishedOfferSetSelection, resolvePublishedRuntimeExperiments, } from '@funnelsgrove/runtime';
+import { buildBillingDiscountCatalog } from './paywallOffer.service.js';
+import { buildConfigPaywallPlans } from './stripe.service.js';
+export const resolvePublishedBillingRuntime = ({ config, featureFlags, mode, search = '', defaultOfferSetId, baseCatalogsByMode, fallbackDiscounts, resolvedExperiments = resolvePublishedRuntimeExperiments(config), }) => {
+    var _a, _b;
+    const offerSets = (_a = config === null || config === void 0 ? void 0 : config.offerSets) !== null && _a !== void 0 ? _a : [];
+    const selection = resolvePublishedOfferSetSelection({
+        offerSets,
+        pricingExperiments: resolvedExperiments.pricingExperiments,
+        featureFlags,
+        search,
+        defaultOfferSetId,
+    });
+    const runtime = resolveGeneratedOfferSetRuntime({
+        offerSets,
+        offerSetId: selection.offerSetId,
+        baseCatalogsByMode,
+        fallbackDiscounts,
+    });
+    const planCatalog = runtime.getPlanCatalog(mode);
+    const getPlans = (keys) => keys
+        .map((key) => planCatalog[key])
+        .filter((plan) => Boolean(plan));
+    const discountList = runtime.getDiscountList(mode);
+    return {
+        revisionId: (_b = config === null || config === void 0 ? void 0 : config.revisionId) !== null && _b !== void 0 ? _b : null,
+        mode,
+        offerSetId: selection.offerSetId,
+        experimentId: selection.experimentId,
+        variantKey: selection.variantKey,
+        experiments: resolvedExperiments.experiments,
+        flowExperiments: resolvedExperiments.flowExperiments,
+        plans: buildConfigPaywallPlans(planCatalog, runtime.planKeys),
+        planCatalog,
+        defaultPlanKey: runtime.defaultPlanKey,
+        discounts: discountList.length > 0 ? buildBillingDiscountCatalog(discountList) : null,
+        upsells: getPlans(runtime.upsellPlanKeys),
+        downsells: getPlans(runtime.downsellPlanKeys),
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/payments",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/The-Solid-Grove/funnelsgrove.git",
@@ -33,7 +33,7 @@
   },
   "dependencies": {
     "@funnelsgrove/analytics": "^0.1.28",
-    "@funnelsgrove/runtime": "^0.6.0",
+    "@funnelsgrove/runtime": "^0.7.1",
     "@stripe/react-stripe-js": "^5.6.0",
     "@stripe/stripe-js": "^8.7.0",
     "react": "19.2.3",