@syntrologie/runtime-sdk 0.2.21 → 1.0.0-canary.1

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

@@ -0,0 +1,117 @@
+/**
+ * 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 type { ActionStep, ActionKind, ActionExecutor, ValidationResult } from '../types';
+import type { ZodSchema } from 'zod';
+/**
+ * Registration entry for an executor.
+ */
+export interface ExecutorRegistration {
+    kind: string;
+    executor: ActionExecutor<any>;
+    schema?: ZodSchema;
+    source: string;
+    isBuiltIn: boolean;
+}
+/**
+ * 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 declare class ExecutorRegistry {
+    private executors;
+    /**
+     * Constructor - registers core executors synchronously.
+     * These are available IMMEDIATELY when the module loads,
+     * enabling instant action execution without waiting for app activation.
+     */
+    constructor();
+    /**
+     * Register a core executor (synchronous, built-in, cannot be overridden).
+     */
+    private registerCore;
+    /**
+     * 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: string, executor: ActionExecutor<any>, schema?: ZodSchema, source?: string, isBuiltIn?: boolean): void;
+    /**
+     * 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: string): boolean;
+    /**
+     * Unregister all executors from a specific source.
+     *
+     * @param source - The source app ID
+     */
+    unregisterBySource(source: string): void;
+    /**
+     * Get the executor for an action kind.
+     */
+    get(kind: string): ActionExecutor<ActionStep> | undefined;
+    /**
+     * Get the full registration for an action kind.
+     */
+    getRegistration(kind: string): ExecutorRegistration | undefined;
+    /**
+     * Check if an executor exists for a given action kind.
+     */
+    has(kind: string): boolean;
+    /**
+     * Validate an action using its registered schema.
+     *
+     * @param action - The action to validate
+     * @returns Validation result
+     */
+    validate(action: unknown): ValidationResult;
+    /**
+     * List all registered action kinds.
+     */
+    list(): string[];
+    /**
+     * List all registrations.
+     */
+    listRegistrations(): ExecutorRegistration[];
+    /**
+     * Get all built-in action kinds.
+     */
+    getBuiltInKinds(): string[];
+    /**
+     * Get all custom action kinds.
+     */
+    getCustomKinds(): string[];
+}
+/**
+ * Default singleton instance of ExecutorRegistry.
+ */
+export declare const executorRegistry: ExecutorRegistry;
+/**
+ * Get the executor for an action kind.
+ * @deprecated Use executorRegistry.get() instead
+ */
+export declare function getExecutor(kind: ActionKind | string): ActionExecutor<ActionStep> | undefined;
+/**
+ * Check if an executor exists for a given action kind.
+ * @deprecated Use executorRegistry.has() instead
+ */
+export declare function hasExecutor(kind: ActionKind | string): boolean;
+export { executeInsertHtml, executeSetText, executeSetAttr, executeAddClass, executeRemoveClass, executeSetStyle, } from '@syntrologie/adapt-content/runtime';
+export { executeHighlight, executePulse, executeBadge, executeTooltip, executeModal, } from '@syntrologie/adapt-overlays/runtime';
+export { executeScrollTo, executeNavigate } from '@syntrologie/adapt-navigation/runtime';
+export { executeTour } from './tour';

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 only (bundled with runtime)
+// Lazy apps (gamification, faq, nav) are loaded dynamically from CDN
+import { executors as contentExecutors } from '@syntrologie/adapt-content/runtime';
+import { executors as overlayExecutors } from '@syntrologie/adapt-overlays/runtime';
+import { executors as navigationExecutors } from '@syntrologie/adapt-navigation/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);
+        }
+        // NOTE: Lazy apps (gamification, faq, nav) are NOT registered here.
+        // They are loaded dynamically from CDN via AppLoader when config requires them.
+        // 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/adapt-content/runtime';
+export { executeHighlight, executePulse, executeBadge, executeTooltip, executeModal, } from '@syntrologie/adapt-overlays/runtime';
+export { executeScrollTo, executeNavigate } from '@syntrologie/adapt-navigation/runtime';
+// NOTE: Lazy app executors (gamification, faq, nav) are NOT re-exported here.
+// They are loaded dynamically from CDN via AppLoader when config requires them.
+// 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>;