@funnelsgrove/runtime 0.7.0 → 0.7.1

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/package.json

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