@funnelsgrove/runtime 0.1.40 → 0.1.41

package/dist/runtime/use-funnel-flow-controller.d.ts

@@ -1,6 +1,7 @@
 import { type Dispatch, type SetStateAction } from 'react';
 import type { FunnelContextValue } from '../components/FunnelContext.js';
 import type { FunnelManifestExperiment } from '../config/funnel.manifest.types.js';
+import type { FunnelUserAnswers } from '../sdk/userAnswers.js';
 import type { FunnelStepMeta } from '../steps/types.js';
 export type FunnelFlowControllerExperiment<StepId extends string> = FunnelManifestExperiment & {
     stepId: StepId;
@@ -11,6 +12,8 @@ export type FunnelFlowControllerExperiment<StepId extends string> = FunnelManife
 type StepComponentRegistry = Record<string, unknown>;
 type FunnelFlowAnalyticsAdapter = {
     trackStepStarted?: (input: {
+        userId?: string;
+        environment?: 'test' | 'live';
         stepId: string;
         stepName: string;
         stepType?: string;
@@ -18,6 +21,8 @@ type FunnelFlowAnalyticsAdapter = {
         featureFlags?: Record<string, string>;
     }) => string | null;
     trackStepCompleted?: (input: {
+        userId?: string;
+        environment?: 'test' | 'live';
         stepId: string;
         stepName: string;
         stepType?: string;
@@ -27,6 +32,8 @@ type FunnelFlowAnalyticsAdapter = {
         featureFlags?: Record<string, string>;
     }) => string | null;
     trackStepEngaged?: (input: {
+        userId?: string;
+        environment?: 'test' | 'live';
         stepId: string;
         stepName: string;
         stepType?: string;
@@ -37,6 +44,8 @@ type FunnelFlowAnalyticsAdapter = {
         featureFlags?: Record<string, string>;
     }) => string | null;
     trackFunnelStarted?: (input: {
+        userId?: string;
+        environment?: 'test' | 'live';
         stepId: string;
         stepName: string;
         stepType?: string;
@@ -44,6 +53,8 @@ type FunnelFlowAnalyticsAdapter = {
         featureFlags?: Record<string, string>;
     }) => string | null;
     trackFirstStepViewed?: (input: {
+        userId?: string;
+        environment?: 'test' | 'live';
         stepId: string;
         stepName: string;
         stepType?: string;
@@ -54,6 +65,7 @@ type FunnelFlowAnalyticsAdapter = {
 type UseFunnelFlowControllerInput<StepId extends string> = {
     analytics?: FunnelFlowAnalyticsAdapter;
     initialStepId?: StepId;
+    initialAttributes?: FunnelUserAnswers;
     lockToInitialStep?: boolean;
     defaultStepId: StepId;
     stepSequence: readonly StepId[];
@@ -107,5 +119,5 @@ export declare function computeRenderSuspended(input: {
     }>;
     isPreviewRuntime?: boolean;
 }): boolean;
-export declare function useFunnelFlowController<StepId extends string>({ analytics, initialStepId, lockToInitialStep, defaultStepId, stepSequence, stepById, stepComponentById, funnelExperiments, getPathForStep, getStepIdFromPath, getSequentialNextStepId, getChoiceTargetsForStep, isFunnelStepId, resolveConfiguredNextStep, resolveRuntimeInitialStepId, }: UseFunnelFlowControllerInput<StepId>): UseFunnelFlowControllerResult<StepId>;
+export declare function useFunnelFlowController<StepId extends string>({ analytics, initialStepId, initialAttributes, lockToInitialStep, defaultStepId, stepSequence, stepById, stepComponentById, funnelExperiments, getPathForStep, getStepIdFromPath, getSequentialNextStepId, getChoiceTargetsForStep, isFunnelStepId, resolveConfiguredNextStep, resolveRuntimeInitialStepId, }: UseFunnelFlowControllerInput<StepId>): UseFunnelFlowControllerResult<StepId>;
 export {};

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

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useMemo, useRef, useState, } from 'react';
 import { writeStepChoice } from '../sdk/userAnswers.js';
 import { apiService } from '../services/api.service.js';
 import { logger } from '../services/logger.js';
-import { FUNNEL_ID, FUNNEL_VERSION_ID, POSTHOG_API_HOST, POSTHOG_PROJECT_API_KEY, PROJECT_ID, } from '../services/runtime-api.config.js';
+import { FUNNEL_ID, POSTHOG_API_HOST, POSTHOG_PROJECT_API_KEY, PROJECT_ID, } from '../services/runtime-api.config.js';
 import { buildHostedStepLocation, dispatchWindowCustomEvent, } from './browser-helpers.js';
 import { isPreviewStepLockRequested, resolveNextStepFromContext, shouldRunAutoAdvanceTimer, } from './funnel-flow.js';
 import { usePreviewBridge } from './preview-bridge.js';
@@ -14,47 +14,13 @@ import { bootstrapPostHog, identifyPostHog, isPostHogReady, resolveExperimentVar
 import { isEditorEnabled, useRuntimeMode } from '../services/runtime-mode.service.js';
 import { isPreviewFrameRuntime } from '../services/preview-frame.service.js';
 const FIRST_STEP_ENGAGEMENT_THRESHOLD_MS = 1000;
-const buildFeatureFlagProperties = (featureFlags) => {
-    return Object.fromEntries(Object.entries(featureFlags).map(([key, value]) => [`$feature/${key}`, value]));
-};
-const capturePostHogStepEvent = (event, properties) => {
-    const payload = JSON.stringify({
-        api_key: POSTHOG_PROJECT_API_KEY,
-        batch: [
-            {
-                event,
-                properties: Object.assign({ $groups: {
-                        project: PROJECT_ID,
-                    }, $insert_id: typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'
-                        ? crypto.randomUUID()
-                        : `${event}_${Date.now()}_${Math.random().toString(16).slice(2)}`, event_source: 'client' }, properties),
-                timestamp: new Date().toISOString(),
-            },
-        ],
-    });
-    const endpoint = `${POSTHOG_API_HOST}/batch/`;
-    if (typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function') {
-        const accepted = navigator.sendBeacon(endpoint, new Blob([payload], { type: 'application/json' }));
-        if (accepted) {
-            return;
-        }
-    }
-    void fetch(endpoint, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: payload,
-        keepalive: true,
-    }).catch(() => {
-        // Analytics delivery must never block funnel interaction.
-    });
-};
 export function computeRenderSuspended(input) {
     if (input.isPreviewRuntime || input.postHogReady) {
         return false;
     }
     return input.experiments.some((experiment) => experiment.stepId === input.activeStepId);
 }
-export function useFunnelFlowController({ analytics, initialStepId, lockToInitialStep = false, defaultStepId, stepSequence, stepById, stepComponentById, funnelExperiments, getPathForStep, getStepIdFromPath, getSequentialNextStepId, getChoiceTargetsForStep, isFunnelStepId, resolveConfiguredNextStep, resolveRuntimeInitialStepId, }) {
+export function useFunnelFlowController({ analytics, initialStepId, initialAttributes, lockToInitialStep = false, defaultStepId, stepSequence, stepById, stepComponentById, funnelExperiments, getPathForStep, getStepIdFromPath, getSequentialNextStepId, getChoiceTargetsForStep, isFunnelStepId, resolveConfiguredNextStep, resolveRuntimeInitialStepId, }) {
     var _a, _b;
     const [runtimeMode, setRuntimeMode] = useRuntimeMode();
     const [editorModeEnabled, setEditorModeEnabled] = useState(false);
@@ -93,7 +59,7 @@ export function useFunnelFlowController({ analytics, initialStepId, lockToInitia
         return resolveFallbackStepId(requestedStepId);
     }, [initialStepId, resolveFallbackStepId, resolveRuntimeInitialStepId]);
     const [activeStepId, setActiveStepId] = useState(safeInitialStepId);
-    const [attributes, setAttributes] = useState({});
+    const [attributes, setAttributes] = useState(() => (Object.assign({}, (initialAttributes || {}))));
     const [user, setUser] = useState(() => ({
         id: apiService.getOrCreateClientUserId(),
         name: '',
@@ -357,10 +323,11 @@ export function useFunnelFlowController({ analytics, initialStepId, lockToInitia
         };
         const stepType = meta.type;
         const startedAt = stepStartedAtByIdRef.current[meta.id] || record.completedAt;
-        const durationMs = Math.max(0, new Date(record.completedAt).getTime() - new Date(startedAt).getTime());
         dispatchWindowCustomEvent('funnel:step-completed', record);
         if (!isPreviewRuntime) {
             (_a = analytics === null || analytics === void 0 ? void 0 : analytics.trackStepCompleted) === null || _a === void 0 ? void 0 : _a.call(analytics, {
+                userId: currentUserIdRef.current,
+                environment: runtimeMode,
                 stepId: record.stepId,
                 stepName: record.stepName,
                 stepType,
@@ -369,18 +336,6 @@ export function useFunnelFlowController({ analytics, initialStepId, lockToInitia
                 selected: record.choices,
                 featureFlags: postHogFeatureFlagsRef.current,
             });
-            if (!(analytics === null || analytics === void 0 ? void 0 : analytics.trackStepCompleted)) {
-                apiService.trackStepCompleted({
-                    userId: currentUserIdRef.current,
-                    stepId: record.stepId,
-                    stepName: record.stepName,
-                    stepType,
-                    startedAt,
-                    endedAt: record.completedAt,
-                    selected: record.choices,
-                });
-                capturePostHogStepEvent('step_completed', Object.assign({ distinct_id: currentUserIdRef.current, funnel_id: FUNNEL_ID || undefined, funnel_version_id: FUNNEL_VERSION_ID || undefined, project_id: PROJECT_ID || undefined, environment: runtimeMode, step_id: record.stepId, step_name: record.stepName, step_type: stepType, started_at: startedAt, ended_at: record.completedAt, duration_ms: Number.isFinite(durationMs) ? durationMs : undefined, selected: record.choices }, buildFeatureFlagProperties(postHogFeatureFlagsRef.current)));
-            }
         }
         setUser((prev) => {
             var _a, _b;
@@ -430,25 +385,19 @@ export function useFunnelFlowController({ analytics, initialStepId, lockToInitia
         stepStartedAtByIdRef.current[renderedStepId] = startedAt;
         if (!isPreviewRuntime) {
             (_a = analytics === null || analytics === void 0 ? void 0 : analytics.trackStepStarted) === null || _a === void 0 ? void 0 : _a.call(analytics, {
+                userId: currentUserIdRef.current,
+                environment: runtimeMode,
                 stepId: renderedStepId,
                 stepName,
                 stepType,
                 startedAt,
                 featureFlags: postHogFeatureFlagsRef.current,
             });
-            if (!(analytics === null || analytics === void 0 ? void 0 : analytics.trackStepStarted)) {
-                apiService.trackStepStarted({
-                    userId: currentUserIdRef.current,
-                    stepId: renderedStepId,
-                    stepName,
-                    stepType,
-                    startedAt,
-                });
-                capturePostHogStepEvent('step_started', Object.assign({ distinct_id: currentUserIdRef.current, funnel_id: FUNNEL_ID || undefined, funnel_version_id: FUNNEL_VERSION_ID || undefined, project_id: PROJECT_ID || undefined, environment: runtimeMode, step_id: renderedStepId, step_name: stepName, step_type: stepType, started_at: startedAt }, buildFeatureFlagProperties(postHogFeatureFlagsRef.current)));
-            }
             if (!firstStepViewedTrackedRef.current && safeActiveStepId === defaultStepId) {
                 firstStepViewedTrackedRef.current = true;
                 (_b = analytics === null || analytics === void 0 ? void 0 : analytics.trackFunnelStarted) === null || _b === void 0 ? void 0 : _b.call(analytics, {
+                    userId: currentUserIdRef.current,
+                    environment: runtimeMode,
                     stepId: renderedStepId,
                     stepName,
                     stepType,
@@ -456,6 +405,8 @@ export function useFunnelFlowController({ analytics, initialStepId, lockToInitia
                     featureFlags: postHogFeatureFlagsRef.current,
                 });
                 (_c = analytics === null || analytics === void 0 ? void 0 : analytics.trackFirstStepViewed) === null || _c === void 0 ? void 0 : _c.call(analytics, {
+                    userId: currentUserIdRef.current,
+                    environment: runtimeMode,
                     stepId: renderedStepId,
                     stepName,
                     stepType,
@@ -483,6 +434,8 @@ export function useFunnelFlowController({ analytics, initialStepId, lockToInitia
             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: runtimeMode,
                 stepId: engagedStepId,
                 stepName: engagedStepName,
                 stepType: engagedStepType,
@@ -492,22 +445,6 @@ export function useFunnelFlowController({ analytics, initialStepId, lockToInitia
                 engagementThresholdMs: FIRST_STEP_ENGAGEMENT_THRESHOLD_MS,
                 featureFlags: postHogFeatureFlagsRef.current,
             });
-            if (!(analytics === null || analytics === void 0 ? void 0 : analytics.trackStepEngaged)) {
-                apiService.trackFunnelEvent({
-                    userId: currentUserIdRef.current,
-                    eventType: 'step_engaged',
-                    stepId: engagedStepId,
-                    stepName: engagedStepName,
-                    stepType: engagedStepType,
-                    startedAt: engagedStartedAt,
-                    endedAt: engagedAt,
-                    metadata: {
-                        durationMs: FIRST_STEP_ENGAGEMENT_THRESHOLD_MS,
-                        engagementThresholdMs: FIRST_STEP_ENGAGEMENT_THRESHOLD_MS,
-                    },
-                });
-                capturePostHogStepEvent('step_engaged', Object.assign({ distinct_id: currentUserIdRef.current, funnel_id: FUNNEL_ID || undefined, funnel_version_id: FUNNEL_VERSION_ID || undefined, project_id: PROJECT_ID || undefined, environment: runtimeMode, step_id: engagedStepId, step_name: engagedStepName, step_type: engagedStepType, started_at: engagedStartedAt, ended_at: engagedAt, duration_ms: FIRST_STEP_ENGAGEMENT_THRESHOLD_MS, engagement_threshold_ms: FIRST_STEP_ENGAGEMENT_THRESHOLD_MS }, buildFeatureFlagProperties(postHogFeatureFlagsRef.current)));
-            }
         }, FIRST_STEP_ENGAGEMENT_THRESHOLD_MS);
         return () => window.clearTimeout(timer);
     }, [

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

@@ -11,26 +11,6 @@ export type AppUser = {
 type AppUserInput = Omit<AppUser, 'document'> & {
     document?: Record<string, unknown>;
 };
-export type FunnelEvent = {
-    userId: string;
-    eventType: string;
-    stepId?: string;
-    stepName?: string;
-    stepType?: string;
-    startedAt?: string;
-    endedAt?: string;
-    selected?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-};
-export type StepCompletionEvent = {
-    userId: string;
-    stepId: string;
-    stepName: string;
-    stepType?: string;
-    startedAt: string;
-    endedAt: string;
-    selected: Record<string, unknown>;
-};
 export type ManageSubscriptionsResponse = {
     user: {
         id: string;
@@ -100,16 +80,6 @@ declare class ApiService {
         userId?: string;
         source?: 'camera' | 'upload';
     }): Promise<TempPhotoUploadResult>;
-    private sendEventAsync;
-    trackFunnelEvent(event: FunnelEvent): void;
-    trackStepStarted(input: {
-        userId: string;
-        stepId: string;
-        stepName: string;
-        stepType?: string;
-        startedAt: string;
-    }): void;
-    trackStepCompleted(event: StepCompletionEvent): void;
     getManageSubscriptions(): Promise<ManageSubscriptionsResponse>;
     updateSubscription(input: {
         subscriptionId: string;

package/dist/services/api.service.js

@@ -121,18 +121,6 @@ const persistUserId = (value, funnelId = FUNNEL_ID) => {
     }
     return normalized;
 };
-const buildSdkEvent = (event) => {
-    return {
-        eventType: event.eventType,
-        stepId: event.stepId || null,
-        stepName: event.stepName || null,
-        stepType: event.stepType || null,
-        startedAt: event.startedAt || null,
-        endedAt: event.endedAt || null,
-        selected: event.selected || {},
-        metadata: Object.assign({ environment: resolveRuntimeAnalyticsEnvironment() }, (event.metadata || {})),
-    };
-};
 const withMergedAttributionDocument = (document, attribution) => {
     const normalizedDocument = asRecord(document);
     if (!attribution) {
@@ -455,61 +443,6 @@ class ApiService {
             uploadedAt,
         };
     }
-    sendEventAsync(event) {
-        const publishableKey = getFunnelSdkPublishableKey();
-        if (!publishableKey) {
-            return;
-        }
-        const payload = JSON.stringify({
-            publishableKey,
-            funnelId: FUNNEL_ID || undefined,
-            funnelVersionId: FUNNEL_VERSION_ID || undefined,
-            user_id: event.userId,
-            events: [buildSdkEvent(event)],
-        });
-        const endpoint = buildMainApiUrl('/sdk/public/events');
-        if (canUseDom() && typeof navigator.sendBeacon === 'function') {
-            const blob = new Blob([payload], { type: 'application/json' });
-            const accepted = navigator.sendBeacon(endpoint, blob);
-            if (accepted) {
-                return;
-            }
-        }
-        void fetch(endpoint, {
-            method: 'POST',
-            headers: buildSdkHeaders({ 'Content-Type': 'application/json' }),
-            body: payload,
-            keepalive: true,
-        }).catch(() => {
-            // Never block UI if analytics delivery fails.
-        });
-    }
-    trackFunnelEvent(event) {
-        const userId = persistUserId(event.userId || this.getOrCreateClientUserId(), FUNNEL_ID);
-        this.sendEventAsync(Object.assign(Object.assign({}, event), { userId }));
-    }
-    trackStepStarted(input) {
-        this.trackFunnelEvent({
-            userId: input.userId,
-            eventType: 'step_start',
-            stepId: input.stepId,
-            stepName: input.stepName,
-            stepType: input.stepType,
-            startedAt: input.startedAt,
-        });
-    }
-    trackStepCompleted(event) {
-        this.trackFunnelEvent({
-            userId: event.userId,
-            eventType: 'step_end',
-            stepId: event.stepId,
-            stepName: event.stepName,
-            stepType: event.stepType,
-            startedAt: event.startedAt,
-            endedAt: event.endedAt,
-            selected: event.selected,
-        });
-    }
     async getManageSubscriptions() {
         const userId = this.getSubscriptionManagementUserId();
         const stripeCustomerId = this.getSubscriptionManagementStripeCustomerId();

package/package.json

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