@funnelsgrove/runtime 0.7.0 → 0.7.2

package/README.md

@@ -37,6 +37,7 @@ documented in [`docs/product-specs/funnel-template-runtime.md`](../../docs/produ
 
 - `config/*`: manifest, theme, font, env, and builder-preview contracts.
 - `runtime/*`: flow, routing, attribution, feature flags, preview bridge, URL attributes, and manifest validation.
+- `runtime/published-runtime-resolution`: running-experiment normalization and immutable offer-set selection from pricing assignments.
 - `services/*`: API client, runtime mode, public env, project env, logger, and funnel state helpers.
 - `components/*`: generic runtime context, subscription handoff/management, editor panel, dev info, and base controls.
 - `content/*` and `steps/types`: shared step content and taxonomy contracts.

package/dist/index.d.ts

@@ -23,6 +23,7 @@ export type { FunnelStepChoices } from './runtime/use-step-choices.js';
 export * from './runtime/preview-bridge.js';
 export * from './runtime/preview-definition-overrides.js';
 export * from './runtime/offer-set-runtime.js';
+export * from './runtime/published-runtime-resolution.js';
 export * from './runtime/route-resolver.js';
 export * from './runtime/submit-email-capture.js';
 export * from './runtime/subscription-handoff.js';

package/dist/index.js

@@ -24,6 +24,7 @@ export { useStepChoices } from './runtime/use-step-choices.js';
 export * from './runtime/preview-bridge.js';
 export * from './runtime/preview-definition-overrides.js';
 export * from './runtime/offer-set-runtime.js';
+export * from './runtime/published-runtime-resolution.js';
 export * from './runtime/route-resolver.js';
 export * from './runtime/submit-email-capture.js';
 export * from './runtime/subscription-handoff.js';

package/dist/runtime/published-runtime-resolution.d.ts

@@ -0,0 +1,23 @@
+import type { FunnelExperimentDefinition, FunnelPricingExperimentDefinition } from '../config/funnel.experiments.types.js';
+import type { FunnelManifestExperiment } from '../config/funnel.manifest.types.js';
+import type { ResolvedFunnelRuntimeConfig } from '../services/funnel-runtime-config.js';
+import type { GeneratedOfferSet } from './offer-set-runtime.js';
+export type ResolvedPublishedExperiments = {
+    experiments: readonly FunnelExperimentDefinition[];
+    pricingExperiments: readonly FunnelPricingExperimentDefinition[];
+    flowExperiments: readonly FunnelManifestExperiment[];
+};
+export type PublishedOfferSetSelection = {
+    offerSetId: string;
+    offerSet: GeneratedOfferSet | null;
+    experimentId: string | null;
+    variantKey: string | null;
+};
+export declare const resolvePublishedRuntimeExperiments: (config: ResolvedFunnelRuntimeConfig | null) => ResolvedPublishedExperiments;
+export declare const resolvePublishedOfferSetSelection: ({ offerSets, pricingExperiments, featureFlags, search, defaultOfferSetId, }: {
+    offerSets: readonly GeneratedOfferSet[];
+    pricingExperiments: readonly FunnelPricingExperimentDefinition[];
+    featureFlags: Readonly<Record<string, string>>;
+    search?: string;
+    defaultOfferSetId?: string;
+}) => PublishedOfferSetSelection;

package/dist/runtime/published-runtime-resolution.js

@@ -0,0 +1,72 @@
+import { toManifestExperiments } from '../config/funnel.experiments.types.js';
+const getPricingExperimentVariants = (experiment) => {
+    var _a;
+    return ((_a = experiment.variants) === null || _a === void 0 ? void 0 : _a.length)
+        ? experiment.variants
+        : [experiment.control, experiment.variant];
+};
+export const resolvePublishedRuntimeExperiments = (config) => {
+    var _a;
+    const experiments = (_a = config === null || config === void 0 ? void 0 : config.experiments.filter((experiment) => { var _a; return ((_a = experiment.status) !== null && _a !== void 0 ? _a : 'running') === 'running'; })) !== null && _a !== void 0 ? _a : [];
+    return {
+        experiments,
+        pricingExperiments: experiments.filter((experiment) => experiment.type === 'pricing'),
+        flowExperiments: toManifestExperiments(experiments),
+    };
+};
+export const resolvePublishedOfferSetSelection = ({ offerSets, pricingExperiments, featureFlags, search = '', defaultOfferSetId, }) => {
+    var _a, _b, _c, _d, _e;
+    const activeOfferSets = offerSets.filter((offerSet) => {
+        var _a;
+        return (offerSet.isActive !== false && Boolean((_a = offerSet.id) === null || _a === void 0 ? void 0 : _a.trim()));
+    });
+    const activeOfferSetsById = new Map(activeOfferSets.map((offerSet) => [offerSet.id.trim(), offerSet]));
+    const params = new URLSearchParams(search);
+    const forcedExperimentId = params.get('mode') === 'test'
+        ? ((_a = params.get('experiment')) === null || _a === void 0 ? void 0 : _a.trim()) || null
+        : null;
+    const forcedVariantKey = forcedExperimentId
+        ? ((_b = params.get('variant')) === null || _b === void 0 ? void 0 : _b.trim()) || null
+        : null;
+    const resolveExperimentSelection = (experiment, variantKey) => {
+        if (!variantKey) {
+            return null;
+        }
+        const variant = getPricingExperimentVariants(experiment)
+            .find((candidate) => candidate.variantKey === variantKey);
+        const offerSet = variant ? activeOfferSetsById.get(variant.offerSetId) : null;
+        return variant && offerSet
+            ? {
+                offerSetId: offerSet.id,
+                offerSet,
+                experimentId: experiment.id,
+                variantKey,
+            }
+            : null;
+    };
+    if (forcedExperimentId) {
+        const forcedExperiment = pricingExperiments.find((experiment) => experiment.id === forcedExperimentId);
+        const forcedSelection = forcedExperiment
+            ? resolveExperimentSelection(forcedExperiment, forcedVariantKey)
+            : null;
+        if (forcedSelection) {
+            return forcedSelection;
+        }
+    }
+    for (const experiment of pricingExperiments) {
+        const selection = resolveExperimentSelection(experiment, ((_c = featureFlags[experiment.id]) === null || _c === void 0 ? void 0 : _c.trim()) || null);
+        if (selection) {
+            return selection;
+        }
+    }
+    const defaultOfferSet = defaultOfferSetId
+        ? activeOfferSetsById.get(defaultOfferSetId.trim())
+        : null;
+    const offerSet = (_d = defaultOfferSet !== null && defaultOfferSet !== void 0 ? defaultOfferSet : activeOfferSets[0]) !== null && _d !== void 0 ? _d : null;
+    return {
+        offerSetId: (_e = offerSet === null || offerSet === void 0 ? void 0 : offerSet.id) !== null && _e !== void 0 ? _e : '',
+        offerSet,
+        experimentId: null,
+        variantKey: null,
+    };
+};

package/dist/services/funnel-runtime-config.js

@@ -40,26 +40,33 @@ const getLegacyProviderMapping = (plan, mode) => {
 const buildPlanModeConfig = (item, mode, legacyPlan = null) => {
     var _a, _b;
     const metadata = isRecord(item.metadata) ? item.metadata : {};
+    const directMappings = isRecord(item.providerMappingsByMode)
+        ? item.providerMappingsByMode
+        : {};
     const metadataMappings = isRecord(metadata.providerMappingsByMode)
         ? metadata.providerMappingsByMode
         : {};
-    const metadataMapping = isRecord(metadataMappings[mode]) ? metadataMappings[mode] : {};
+    const modeMapping = isRecord(directMappings[mode])
+        ? directMappings[mode]
+        : isRecord(metadataMappings[mode])
+            ? metadataMappings[mode]
+            : {};
     const legacyMapping = getLegacyProviderMapping(legacyPlan, mode);
     const prefix = mode === 'test' ? 'test' : 'live';
     const providerPlanId = (pickString(item, `${prefix}ProviderPlanId`, `${prefix}_provider_plan_id`)
-        || pickString(metadataMapping, 'providerPlanId')
+        || pickString(modeMapping, 'providerPlanId')
         || (legacyMapping ? pickString(legacyMapping, 'providerPlanId', 'provider_plan_id') : null));
     if (!providerPlanId) {
         return null;
     }
-    const amountMinor = (_a = pickNumber(metadataMapping, 'amountCents')) !== null && _a !== void 0 ? _a : (legacyMapping ? pickNumber(legacyMapping, 'amountMinor', 'amount_minor') : null);
-    const interval = pickString(metadataMapping, 'billingInterval')
+    const amountMinor = (_a = pickNumber(modeMapping, 'amountCents')) !== null && _a !== void 0 ? _a : (legacyMapping ? pickNumber(legacyMapping, 'amountMinor', 'amount_minor') : null);
+    const interval = pickString(modeMapping, 'billingInterval')
         || (legacyMapping ? pickString(legacyMapping, 'interval') : null);
-    const intervalCount = (_b = pickNumber(metadataMapping, 'billingIntervalCount')) !== null && _b !== void 0 ? _b : (legacyMapping ? pickNumber(legacyMapping, 'intervalCount', 'interval_count') : null);
-    const currency = pickString(metadataMapping, 'currency')
+    const intervalCount = (_b = pickNumber(modeMapping, 'billingIntervalCount')) !== null && _b !== void 0 ? _b : (legacyMapping ? pickNumber(legacyMapping, 'intervalCount', 'interval_count') : null);
+    const currency = pickString(modeMapping, 'currency')
         || (legacyMapping ? pickString(legacyMapping, 'currency') : null);
     const amountMajor = amountMinor === null ? null : amountMinor / 100;
-    const priceLabel = pickString(metadataMapping, 'priceLabel') || (amountMajor === null
+    const priceLabel = pickString(modeMapping, 'priceLabel') || (amountMajor === null
         ? null
         : new Intl.NumberFormat('en-US', {
             style: 'currency',
@@ -67,12 +74,12 @@ const buildPlanModeConfig = (item, mode, legacyPlan = null) => {
             minimumFractionDigits: 2,
             maximumFractionDigits: 2,
         }).format(amountMajor) + (interval ? `/${interval}` : ''));
-    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ providerPlanId }, (priceLabel ? { priceLabel } : {})), (pickString(metadataMapping, 'perDayAmount')
-        ? { perDayAmount: pickString(metadataMapping, 'perDayAmount') }
-        : {})), (pickString(metadataMapping, 'perDayLabel')
-        ? { perDayLabel: pickString(metadataMapping, 'perDayLabel') }
-        : {})), (amountMinor === null ? {} : { amountCents: amountMinor })), (pickString(metadataMapping, 'checkoutSummaryLabel')
-        ? { checkoutSummaryLabel: pickString(metadataMapping, 'checkoutSummaryLabel') }
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ providerPlanId }, (priceLabel ? { priceLabel } : {})), (pickString(modeMapping, 'perDayAmount')
+        ? { perDayAmount: pickString(modeMapping, 'perDayAmount') }
+        : {})), (pickString(modeMapping, 'perDayLabel')
+        ? { perDayLabel: pickString(modeMapping, 'perDayLabel') }
+        : {})), (amountMinor === null ? {} : { amountCents: amountMinor })), (pickString(modeMapping, 'checkoutSummaryLabel')
+        ? { checkoutSummaryLabel: pickString(modeMapping, 'checkoutSummaryLabel') }
         : amountMajor === null
             ? {}
             : { checkoutSummaryLabel: `${new Intl.NumberFormat('en-US', {

package/package.json

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