@funnelsgrove/runtime 0.1.46 → 0.1.48

package/dist/runtime/experiment-assignment.js

@@ -1,9 +1,30 @@
 import { resolveExperimentVariant } from './posthog-flags.js';
+const resolveForcedVariant = (input) => {
+    var _a, _b;
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    try {
+        const params = new URLSearchParams(window.location.search);
+        if (params.get('mode') !== 'test' || params.get('experiment') !== input.experimentId) {
+            return null;
+        }
+        const variantKey = (_a = params.get('variant')) === null || _a === void 0 ? void 0 : _a.trim();
+        return variantKey ? (_b = input.variants.find((variant) => variant.variantKey === variantKey)) !== null && _b !== void 0 ? _b : null : null;
+    }
+    catch (_c) {
+        return null;
+    }
+};
 export const resolveExperimentAssignment = (input) => {
     var _a;
     if (input.variants.length === 0) {
         return null;
     }
+    const forcedVariant = resolveForcedVariant(input);
+    if (forcedVariant) {
+        return { variantKey: forcedVariant.variantKey, routeToStepId: forcedVariant.routeToStepId };
+    }
     const resolved = resolveExperimentVariant(input.experimentId);
     const match = resolved ? input.variants.find((variant) => variant.variantKey === resolved) : undefined;
     if (match) {

package/dist/runtime/use-funnel-flow-controller.js

@@ -76,6 +76,7 @@ export function useFunnelFlowController({ analytics, initialStepId, initialAttri
     const firstStepViewedTrackedRef = useRef(false);
     const stepStartedAtByIdRef = useRef({});
     const engagedStepIdsRef = useRef(new Set());
+    const firstStepEngagementTimerRef = useRef(null);
     const currentUserIdRef = useRef(user.id);
     const safeActiveStepId = useMemo(() => { var _a; return (_a = resolveRenderableStepId(activeStepId)) !== null && _a !== void 0 ? _a : safeInitialStepId; }, [activeStepId, resolveRenderableStepId, safeInitialStepId]);
     const activeStepMeta = stepById[safeActiveStepId];
@@ -415,40 +416,41 @@ export function useFunnelFlowController({ analytics, initialStepId, initialAttri
                     occurredAt: startedAt,
                     featureFlags: postHogFeatureFlagsRef.current,
                 });
+                if (!engagedStepIdsRef.current.has(renderedStepId)) {
+                    if (firstStepEngagementTimerRef.current !== null) {
+                        window.clearTimeout(firstStepEngagementTimerRef.current);
+                    }
+                    const engagedStepId = renderedStepId;
+                    const engagedStartedAt = startedAt;
+                    const engagedStepName = stepName;
+                    const engagedStepType = stepType;
+                    firstStepEngagementTimerRef.current = window.setTimeout(() => {
+                        var _a;
+                        firstStepEngagementTimerRef.current = null;
+                        if (prevStepIdRef.current !== engagedStepId ||
+                            engagedStepIdsRef.current.has(engagedStepId)) {
+                            return;
+                        }
+                        engagedStepIdsRef.current.add(engagedStepId);
+                        const engagedAt = new Date().toISOString();
+                        (_a = analytics === null || analytics === void 0 ? void 0 : analytics.trackStepEngaged) === null || _a === void 0 ? void 0 : _a.call(analytics, {
+                            userId: currentUserIdRef.current,
+                            environment: analyticsRuntimeMode,
+                            stepId: engagedStepId,
+                            stepName: engagedStepName,
+                            stepType: engagedStepType,
+                            startedAt: engagedStartedAt,
+                            engagedAt,
+                            durationMs: FIRST_STEP_ENGAGEMENT_THRESHOLD_MS,
+                            engagementThresholdMs: FIRST_STEP_ENGAGEMENT_THRESHOLD_MS,
+                            featureFlags: postHogFeatureFlagsRef.current,
+                        });
+                    }, FIRST_STEP_ENGAGEMENT_THRESHOLD_MS);
+                }
             }
         }
         attributesAtStepStart.current = Object.assign({}, attributesRef.current);
         prevStepIdRef.current = renderedStepId;
-        if (isPreviewRuntime ||
-            renderedStepId !== defaultStepId ||
-            engagedStepIdsRef.current.has(renderedStepId)) {
-            return;
-        }
-        const engagedStepId = renderedStepId;
-        const engagedStartedAt = startedAt;
-        const engagedStepName = stepName;
-        const engagedStepType = stepType;
-        const timer = window.setTimeout(() => {
-            var _a;
-            if (prevStepIdRef.current !== engagedStepId || engagedStepIdsRef.current.has(engagedStepId)) {
-                return;
-            }
-            engagedStepIdsRef.current.add(engagedStepId);
-            const engagedAt = new Date().toISOString();
-            (_a = analytics === null || analytics === void 0 ? void 0 : analytics.trackStepEngaged) === null || _a === void 0 ? void 0 : _a.call(analytics, {
-                userId: currentUserIdRef.current,
-                environment: analyticsRuntimeMode,
-                stepId: engagedStepId,
-                stepName: engagedStepName,
-                stepType: engagedStepType,
-                startedAt: engagedStartedAt,
-                engagedAt,
-                durationMs: FIRST_STEP_ENGAGEMENT_THRESHOLD_MS,
-                engagementThresholdMs: FIRST_STEP_ENGAGEMENT_THRESHOLD_MS,
-                featureFlags: postHogFeatureFlagsRef.current,
-            });
-        }, FIRST_STEP_ENGAGEMENT_THRESHOLD_MS);
-        return () => window.clearTimeout(timer);
     }, [
         activeStepId,
         analytics,
@@ -462,6 +464,12 @@ export function useFunnelFlowController({ analytics, initialStepId, initialAttri
         renderedStepMeta === null || renderedStepMeta === void 0 ? void 0 : renderedStepMeta.type,
         safeActiveStepId,
     ]);
+    useEffect(() => () => {
+        if (firstStepEngagementTimerRef.current !== null) {
+            window.clearTimeout(firstStepEngagementTimerRef.current);
+            firstStepEngagementTimerRef.current = null;
+        }
+    }, []);
     useEffect(() => {
         setActiveStepId(safeInitialStepId);
     }, [safeInitialStepId]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/runtime",
-  "version": "0.1.46",
+  "version": "0.1.48",
   "type": "module",
   "private": false,
   "main": "./dist/index.js",