@syntrologie/runtime-sdk 1.0.1-canary.3 → 2.0.0-canary.1

package/dist/actions/executors/index.js

@@ -0,0 +1,242 @@
+/**
+ * Action Executor Registry
+ *
+ * Extensible registry that maps action kinds to their executor functions.
+ * Apps can register custom executors at runtime.
+ *
+ * Core app executors are imported from their respective app packages.
+ */
+// Import executors from core app packages
+import { executors as contentExecutors } from "@syntrologie/app-content/runtime";
+import { executors as overlayExecutors } from "@syntrologie/app-overlays/runtime";
+import { executors as navigationExecutors } from "@syntrologie/app-navigation/runtime";
+import { executors as gamificationExecutors } from "@syntrologie/app-gamification/runtime";
+import { executeTour } from "./tour";
+/**
+ * Extensible registry for action executors.
+ *
+ * Core executors (setText, highlight, etc.) are registered synchronously
+ * at construction time for immediate availability - no async loading.
+ *
+ * External app executors are registered when apps activate.
+ */
+export class ExecutorRegistry {
+    /**
+     * Constructor - registers core executors synchronously.
+     * These are available IMMEDIATELY when the module loads,
+     * enabling instant action execution without waiting for app activation.
+     */
+    constructor() {
+        this.executors = new Map();
+        // Register all executors from core app packages
+        for (const { kind, executor } of contentExecutors) {
+            this.registerCore(kind, executor);
+        }
+        for (const { kind, executor } of overlayExecutors) {
+            this.registerCore(kind, executor);
+        }
+        for (const { kind, executor } of navigationExecutors) {
+            this.registerCore(kind, executor);
+        }
+        for (const { kind, executor } of gamificationExecutors) {
+            this.registerCore(kind, executor);
+        }
+        // core:mountWidget is handled specially in ActionEngine since it delegates to Surfaces
+        this.registerCore("core:mountWidget", async () => {
+            throw new Error("core:mountWidget must be handled by ActionEngine");
+        });
+        // Register core:tour executor
+        this.registerCore("core:tour", executeTour);
+    }
+    /**
+     * Register a core executor (synchronous, built-in, cannot be overridden).
+     */
+    registerCore(kind, executor, schema) {
+        this.executors.set(kind, {
+            kind,
+            executor,
+            schema,
+            source: "core",
+            isBuiltIn: true,
+        });
+    }
+    /**
+     * Register an executor for an action kind.
+     *
+     * @param kind - The action kind (e.g., "gamification:awardBadge")
+     * @param executor - The executor function
+     * @param schema - Optional Zod schema for validation
+     * @param source - The source app ID (for tracking)
+     * @param isBuiltIn - Whether this is from a built-in app (prevents override)
+     */
+    register(kind, executor, schema, source = "custom", isBuiltIn = false) {
+        if (this.executors.has(kind)) {
+            const existing = this.executors.get(kind);
+            if (existing.isBuiltIn) {
+                throw new Error(`Cannot override built-in executor: ${kind}`);
+            }
+            console.warn(`[ExecutorRegistry] Overriding executor for kind: ${kind}`);
+        }
+        this.executors.set(kind, {
+            kind,
+            executor,
+            schema,
+            source,
+            isBuiltIn,
+        });
+    }
+    /**
+     * Unregister an executor.
+     *
+     * @param kind - The action kind to unregister
+     * @returns true if the executor was unregistered, false if not found or built-in
+     */
+    unregister(kind) {
+        const existing = this.executors.get(kind);
+        if (!existing) {
+            return false;
+        }
+        if (existing.isBuiltIn) {
+            console.warn(`[ExecutorRegistry] Cannot unregister built-in executor: ${kind}`);
+            return false;
+        }
+        this.executors.delete(kind);
+        return true;
+    }
+    /**
+     * Unregister all executors from a specific source.
+     *
+     * @param source - The source app ID
+     */
+    unregisterBySource(source) {
+        for (const [kind, registration] of this.executors.entries()) {
+            if (registration.source === source) {
+                this.executors.delete(kind);
+            }
+        }
+    }
+    /**
+     * Get the executor for an action kind.
+     */
+    get(kind) {
+        var _a;
+        return (_a = this.executors.get(kind)) === null || _a === void 0 ? void 0 : _a.executor;
+    }
+    /**
+     * Get the full registration for an action kind.
+     */
+    getRegistration(kind) {
+        return this.executors.get(kind);
+    }
+    /**
+     * Check if an executor exists for a given action kind.
+     */
+    has(kind) {
+        return this.executors.has(kind);
+    }
+    /**
+     * Validate an action using its registered schema.
+     *
+     * @param action - The action to validate
+     * @returns Validation result
+     */
+    validate(action) {
+        const errors = [];
+        if (!action || typeof action !== "object") {
+            errors.push({
+                code: "INVALID_ACTION",
+                message: "Action must be an object",
+            });
+            return { valid: false, errors, warnings: [] };
+        }
+        const kind = action.kind;
+        if (!kind || typeof kind !== "string") {
+            errors.push({
+                code: "MISSING_KIND",
+                message: "Action must have a 'kind' property",
+            });
+            return { valid: false, errors, warnings: [] };
+        }
+        const registration = this.executors.get(kind);
+        if (!registration) {
+            errors.push({
+                code: "UNKNOWN_KIND",
+                message: `Unknown action kind: ${kind}`,
+                field: "kind",
+            });
+            return { valid: false, errors, warnings: [] };
+        }
+        // If schema is provided, validate against it
+        if (registration.schema) {
+            const result = registration.schema.safeParse(action);
+            if (!result.success) {
+                for (const issue of result.error.issues) {
+                    errors.push({
+                        code: "SCHEMA_VALIDATION_ERROR",
+                        message: issue.message,
+                        field: issue.path.join("."),
+                    });
+                }
+                return { valid: false, errors, warnings: [] };
+            }
+        }
+        return { valid: true, errors: [], warnings: [] };
+    }
+    /**
+     * List all registered action kinds.
+     */
+    list() {
+        return Array.from(this.executors.keys());
+    }
+    /**
+     * List all registrations.
+     */
+    listRegistrations() {
+        return Array.from(this.executors.values());
+    }
+    /**
+     * Get all built-in action kinds.
+     */
+    getBuiltInKinds() {
+        return Array.from(this.executors.entries())
+            .filter(([, reg]) => reg.isBuiltIn)
+            .map(([kind]) => kind);
+    }
+    /**
+     * Get all custom action kinds.
+     */
+    getCustomKinds() {
+        return Array.from(this.executors.entries())
+            .filter(([, reg]) => !reg.isBuiltIn)
+            .map(([kind]) => kind);
+    }
+}
+// ============================================================================
+// Singleton and backwards-compatible exports
+// ============================================================================
+/**
+ * Default singleton instance of ExecutorRegistry.
+ */
+export const executorRegistry = new ExecutorRegistry();
+/**
+ * Get the executor for an action kind.
+ * @deprecated Use executorRegistry.get() instead
+ */
+export function getExecutor(kind) {
+    return executorRegistry.get(kind);
+}
+/**
+ * Check if an executor exists for a given action kind.
+ * @deprecated Use executorRegistry.has() instead
+ */
+export function hasExecutor(kind) {
+    return executorRegistry.has(kind);
+}
+// Re-export individual executors from app packages for backwards compatibility
+export { executeInsertHtml, executeSetText, executeSetAttr, executeAddClass, executeRemoveClass, executeSetStyle, } from "@syntrologie/app-content/runtime";
+export { executeHighlight, executePulse, executeBadge, executeTooltip, executeModal, } from "@syntrologie/app-overlays/runtime";
+export { executeScrollTo, executeNavigate, } from "@syntrologie/app-navigation/runtime";
+export { executeAwardBadge, executeAddPoints, } from "@syntrologie/app-gamification/runtime";
+// Core executors
+export { executeTour } from "./tour";
+//# sourceMappingURL=index.js.map

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

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

package/dist/actions/executors/tour.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+import type { TourAction, ActionExecutor } from "../types";
+/**
+ * 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 declare const executeTour: ActionExecutor<TourAction>;

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);
+            checkRoute();
+        };
+        history.replaceState = (...args) => {
+            origReplaceState(...args);
+            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,EACL,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC"}