@syntrologie/runtime-sdk 0.2.21 → 1.0.0

package/dist/actions/executors/tour.js

@@ -0,0 +1,332 @@
+/**
+ * Tour Executor
+ *
+ * Orchestrates sequential tour steps with cross-page state persistence.
+ * Tours can span multiple pages and resume after navigation.
+ *
+ * Each step contains an inner action (modal, tooltip) that gets executed.
+ * The tour listens for CTA click events to advance to the next step.
+ */
+/** Storage key for active tour state */
+const ACTIVE_TOUR_KEY = 'syntro_active_tour';
+/** Track active tour executors to prevent duplicates */
+const activeTours = new Map();
+/**
+ * Get active tour state from localStorage
+ */
+function getTourState(tourId) {
+    try {
+        const data = localStorage.getItem(ACTIVE_TOUR_KEY);
+        if (!data)
+            return null;
+        const state = JSON.parse(data);
+        // Only return if it matches the requested tour
+        if (state.tourId !== tourId)
+            return null;
+        return state;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save tour state to localStorage
+ */
+function saveTourState(state) {
+    try {
+        localStorage.setItem(ACTIVE_TOUR_KEY, JSON.stringify(state));
+    }
+    catch {
+        // Storage may be full or unavailable
+    }
+}
+/**
+ * Clear tour state from localStorage
+ */
+function clearTourState() {
+    try {
+        localStorage.removeItem(ACTIVE_TOUR_KEY);
+    }
+    catch {
+        // Ignore errors
+    }
+}
+/**
+ * Get current route/path
+ */
+function getCurrentRoute() {
+    return window.location.pathname;
+}
+/**
+ * Check if a step matches the current route
+ */
+function stepMatchesRoute(step) {
+    if (!step.route)
+        return true;
+    const currentRoute = getCurrentRoute();
+    // Simple pattern matching - step.route can be exact path or glob pattern
+    if (step.route.includes('*')) {
+        const pattern = new RegExp(`^${step.route.replace(/\*/g, '.*')}$`);
+        return pattern.test(currentRoute);
+    }
+    return currentRoute === step.route;
+}
+/**
+ * Execute a tour action
+ *
+ * Tours orchestrate a sequence of steps, persisting state to localStorage
+ * to support cross-page navigation. Each step contains an action to execute
+ * and optionally defines transitions based on action events.
+ */
+export const executeTour = async (action, context) => {
+    const { tourId, steps, startStep, autoStart = true } = action;
+    if (steps.length === 0) {
+        throw new Error(`Tour "${tourId}" has no steps`);
+    }
+    // Self-guard: if this tour is already running, return no-op
+    // This prevents duplicate modals when applyBatch is called multiple times
+    if (activeTours.has(tourId)) {
+        return {
+            cleanup: async () => {
+                // Delegate to the original tour's cleanup
+                const existing = activeTours.get(tourId);
+                if (existing) {
+                    await existing.cleanup();
+                }
+            },
+        };
+    }
+    // Check if we can execute inner actions
+    if (!context.applyAction) {
+        throw new Error('Tour executor requires applyAction in context');
+    }
+    // Get or initialize tour state
+    let state = getTourState(tourId);
+    const isResumingTour = !!state;
+    // If not resuming and autoStart is false, don't start the tour
+    if (!isResumingTour && !autoStart) {
+        return {
+            cleanup: () => { },
+        };
+    }
+    if (!state) {
+        state = {
+            tourId,
+            currentStepId: startStep || steps[0].id,
+            startedAt: Date.now(),
+        };
+        saveTourState(state);
+    }
+    // Find the current step
+    let currentStepIndex = steps.findIndex((s) => s.id === state.currentStepId);
+    if (currentStepIndex === -1) {
+        // Step not found, use startStep or first step
+        const initialStepId = startStep || steps[0].id;
+        currentStepIndex = steps.findIndex((s) => s.id === initialStepId);
+        if (currentStepIndex === -1)
+            currentStepIndex = 0;
+        state.currentStepId = steps[currentStepIndex].id;
+        saveTourState(state);
+    }
+    const currentStep = steps[currentStepIndex];
+    // Check if current step matches the route
+    if (!stepMatchesRoute(currentStep)) {
+        // Current page doesn't match this step's route
+        // Tour is "waiting" for navigation to the correct page
+        context.publishEvent('tour.waiting_for_route', {
+            tourId,
+            stepId: currentStep.id,
+            expectedRoute: currentStep.route,
+            currentRoute: getCurrentRoute(),
+        });
+        // Return a no-op that cleans up when tour ends
+        return {
+            cleanup: () => { },
+        };
+    }
+    // Track state
+    let isDestroyed = false;
+    let currentActionHandle = null;
+    let eventUnsubscribe = null;
+    let routeWatcher = null;
+    /**
+     * Clean up current step
+     */
+    const cleanupCurrentStep = async () => {
+        if (eventUnsubscribe) {
+            eventUnsubscribe();
+            eventUnsubscribe = null;
+        }
+        if (currentActionHandle && currentActionHandle.isApplied()) {
+            await currentActionHandle.revert();
+            currentActionHandle = null;
+        }
+    };
+    /**
+     * Advance to the next step
+     */
+    const advanceToStep = async (nextStepId) => {
+        if (isDestroyed)
+            return;
+        // Clean up current step
+        await cleanupCurrentStep();
+        if (nextStepId === 'end') {
+            // Tour complete
+            clearTourState();
+            context.publishEvent('tour.completed', {
+                tourId,
+                totalSteps: steps.length,
+            });
+            isDestroyed = true;
+            return;
+        }
+        // Find next step
+        const nextStep = steps.find((s) => s.id === nextStepId);
+        if (!nextStep) {
+            console.error(`[Tour] Step "${nextStepId}" not found`);
+            return;
+        }
+        // Update state
+        state.currentStepId = nextStepId;
+        saveTourState(state);
+        context.publishEvent('tour.step_changed', {
+            tourId,
+            previousStepId: currentStep.id,
+            nextStepId,
+        });
+        // If the next step has a different route, let navigation happen
+        if (nextStep.route && nextStep.route !== getCurrentRoute()) {
+            context.publishEvent('tour.awaiting_navigation', {
+                tourId,
+                stepId: nextStepId,
+                targetRoute: nextStep.route,
+            });
+            // Tour will resume when page reloads and this executor runs again
+            return;
+        }
+        // Execute the next step's action
+        await executeStep(nextStep);
+    };
+    /**
+     * Execute a step's inner action and set up event listeners
+     */
+    const executeStep = async (step) => {
+        if (isDestroyed)
+            return;
+        context.publishEvent('tour.step_started', {
+            tourId,
+            stepId: step.id,
+            stepIndex: steps.findIndex((s) => s.id === step.id),
+            totalSteps: steps.length,
+        });
+        // Execute the inner action
+        try {
+            currentActionHandle = await context.applyAction(step.action);
+        }
+        catch (error) {
+            console.error(`[Tour] Failed to execute step "${step.id}":`, error);
+            context.publishEvent('tour.step_failed', {
+                tourId,
+                stepId: step.id,
+                error: String(error),
+            });
+            return;
+        }
+        // Subscribe to CTA click events if there are transitions defined
+        if (step.onAction && context.subscribeEvent) {
+            eventUnsubscribe = context.subscribeEvent('action.modal_cta_clicked', (props) => {
+                const actionId = props === null || props === void 0 ? void 0 : props.actionId;
+                if (actionId && step.onAction) {
+                    const nextStepId = step.onAction[actionId];
+                    if (nextStepId) {
+                        advanceToStep(nextStepId);
+                    }
+                }
+            });
+            // Also listen for tooltip CTA clicks
+            const tooltipUnsubscribe = context.subscribeEvent('action.tooltip_cta_clicked', (props) => {
+                const actionId = props === null || props === void 0 ? void 0 : props.actionId;
+                if (actionId && step.onAction) {
+                    const nextStepId = step.onAction[actionId];
+                    if (nextStepId) {
+                        advanceToStep(nextStepId);
+                    }
+                }
+            });
+            // Combine unsubscribes
+            const originalUnsubscribe = eventUnsubscribe;
+            eventUnsubscribe = () => {
+                originalUnsubscribe();
+                tooltipUnsubscribe();
+            };
+        }
+    };
+    // Set up route change watcher for SPAs
+    const setupRouteWatcher = () => {
+        let lastPath = getCurrentRoute();
+        const checkRoute = () => {
+            const currentPath = getCurrentRoute();
+            if (currentPath !== lastPath) {
+                lastPath = currentPath;
+                context.publishEvent('tour.route_changed', {
+                    tourId,
+                    newRoute: currentPath,
+                });
+            }
+        };
+        // Watch for popstate (back/forward navigation)
+        window.addEventListener('popstate', checkRoute);
+        // Watch for pushState/replaceState
+        const origPushState = history.pushState.bind(history);
+        const origReplaceState = history.replaceState.bind(history);
+        history.pushState = (...args) => {
+            origPushState(...args);
+            queueMicrotask(checkRoute);
+        };
+        history.replaceState = (...args) => {
+            origReplaceState(...args);
+            queueMicrotask(checkRoute);
+        };
+        return () => {
+            window.removeEventListener('popstate', checkRoute);
+            history.pushState = origPushState;
+            history.replaceState = origReplaceState;
+        };
+    };
+    routeWatcher = setupRouteWatcher();
+    // Publish tour started/resumed event
+    if (!isResumingTour) {
+        context.publishEvent('tour.started', {
+            tourId,
+            totalSteps: steps.length,
+            startStepId: state.currentStepId,
+        });
+    }
+    else {
+        context.publishEvent('tour.resumed', {
+            tourId,
+            stepId: state.currentStepId,
+        });
+    }
+    // Execute the current step
+    await executeStep(currentStep);
+    // Create cleanup function
+    const cleanup = async () => {
+        isDestroyed = true;
+        // Remove from active tours
+        activeTours.delete(tourId);
+        await cleanupCurrentStep();
+        if (routeWatcher) {
+            routeWatcher();
+        }
+        // Don't clear tour state on cleanup - allow resume
+        context.publishEvent('tour.paused', {
+            tourId,
+            stepId: state.currentStepId,
+        });
+    };
+    // Register this tour as active
+    activeTours.set(tourId, { cleanup });
+    return { cleanup };
+};
+//# sourceMappingURL=tour.js.map

package/dist/actions/executors/tour.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour.js","sourceRoot":"","sources":["../../../src/actions/executors/tour.ts"],"names":[],"mappings":"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"}

package/dist/actions/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Actions Module
+ *
+ * Unified execution layer for interventions (highlight, tooltip, badge, DOM modifications).
+ */
+export { createActionEngine } from './ActionEngine';
+export type { ActionEngine, ActionEngineOptions, ActionEngineExecutorRegistry, ActionHandle, BatchActionHandle, ActiveAction, ActionStep, ActionKind, HighlightAction, PulseAction, BadgeAction, TooltipAction, InsertHtmlAction, SetTextAction, SetAttrAction, AddClassAction, RemoveClassAction, SetStyleAction, MountWidgetAction, ScrollToAction, NavigateAction, HighlightStyle, BadgePosition, TooltipContent, TooltipTrigger, InsertPosition, WidgetConfig, ActionState, ValidationResult, ValidationError, ValidationWarning, ExecutorResult, ExecutorContext, ExecutorCleanup, ExecutorUpdate, ActionExecutor, } from './types';
+export { validateAction, validateActions } from './validation';
+export { ExecutorRegistry, executorRegistry, getExecutor, hasExecutor } from './executors';
+export type { ExecutorRegistration } from './executors';

package/dist/actions/index.js

@@ -0,0 +1,12 @@
+/**
+ * Actions Module
+ *
+ * Unified execution layer for interventions (highlight, tooltip, badge, DOM modifications).
+ */
+// Main factory
+export { createActionEngine } from './ActionEngine';
+// Validation
+export { validateAction, validateActions } from './validation';
+// Executors (for advanced usage)
+export { ExecutorRegistry, executorRegistry, getExecutor, hasExecutor } from './executors';
+//# sourceMappingURL=index.js.map

package/dist/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAqDpD,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/D,iCAAiC;AACjC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}