@syntrologie/runtime-sdk 0.2.21 → 1.0.0

package/dist/apps/AppLoader.js

@@ -0,0 +1,282 @@
+/**
+ * App Loader
+ *
+ * Handles loading apps from CDN based on canvas config requirements.
+ *
+ * Loading Strategy:
+ * 1. Core apps (built-in actions) are bundled with runtime - no loading needed
+ * 2. External apps are loaded from CDN when config references them
+ *
+ * The loader determines which apps are needed by scanning the canvas config for:
+ * - Action kinds with namespaces (e.g., "gamification:awardBadge")
+ * - Widget IDs with namespaces (e.g., "gamification:leaderboard")
+ * - Explicit app references in config
+ */
+// ============================================================================
+// Core Apps (bundled with runtime)
+// ============================================================================
+/**
+ * Core action kinds that are bundled with the runtime.
+ * These don't require loading external apps.
+ */
+const CORE_ACTION_KINDS = new Set([
+    // Overlay actions (bundled via @syntrologie/adapt-overlays)
+    'overlays:highlight',
+    'overlays:pulse',
+    'overlays:badge',
+    'overlays:tooltip',
+    'overlays:modal',
+    // Content actions (bundled via @syntrologie/adapt-content)
+    'content:insertHtml',
+    'content:setText',
+    'content:setAttr',
+    'content:addClass',
+    'content:removeClass',
+    'content:setStyle',
+    // Core actions (bundled with runtime)
+    'core:mountWidget',
+    'core:wait',
+    'core:sequence',
+    'core:parallel',
+    'core:tour',
+]);
+/**
+ * Map action/widget namespace prefixes to CDN app IDs.
+ * Needed when the action kind prefix doesn't match the CDN bundle directory name.
+ * e.g., action "faq:update" has namespace "faq" but the CDN bundle is "adaptive-faq".
+ */
+const NAMESPACE_TO_APP_ID = {
+    faq: 'adaptive-faq',
+    nav: 'adaptive-nav',
+    gamification: 'adaptive-gamification',
+    chatbot: 'adaptive-chatbot',
+};
+/**
+ * Resolve a namespace prefix to its CDN app ID.
+ */
+function resolveAppId(namespace) {
+    var _a;
+    return (_a = NAMESPACE_TO_APP_ID[namespace]) !== null && _a !== void 0 ? _a : namespace;
+}
+/**
+ * Check if an action kind is a core action.
+ */
+export function isCoreActionKind(kind) {
+    return CORE_ACTION_KINDS.has(kind);
+}
+/**
+ * Extract app ID from a namespaced action kind.
+ * e.g., "gamification:awardBadge" → "gamification"
+ * e.g., "navigation:scrollTo" → "nav" (via namespace mapping)
+ */
+export function getAppIdFromActionKind(kind) {
+    if (isCoreActionKind(kind))
+        return null;
+    const colonIndex = kind.indexOf(':');
+    if (colonIndex === -1)
+        return null;
+    return resolveAppId(kind.slice(0, colonIndex));
+}
+/**
+ * Extract app ID from a namespaced widget ID.
+ * e.g., "gamification:leaderboard" → "gamification"
+ */
+export function getAppIdFromWidgetId(widgetId) {
+    const colonIndex = widgetId.indexOf(':');
+    if (colonIndex === -1)
+        return null;
+    return resolveAppId(widgetId.slice(0, colonIndex));
+}
+// ============================================================================
+// App Loader
+// ============================================================================
+/**
+ * Create an app loader instance.
+ */
+export function createAppLoader(options) {
+    const { cdnBase, registry, timeout = 10000, onLoadStart, onLoadEnd } = options;
+    /** Cache of loading promises to avoid duplicate loads */
+    const loadingPromises = new Map();
+    /** Cache of loaded app URLs */
+    const loadedUrls = new Set();
+    /** Cache of failed CDN loads to avoid repeated attempts in the same session */
+    const failedApps = new Map();
+    /**
+     * Get the CDN URL for an app.
+     */
+    function getAppUrl(appId) {
+        // Convention: adaptives are at {cdnBase}/adaptives/{appId}/index.js
+        return `${cdnBase}/adaptives/${appId}/index.js`;
+    }
+    /**
+     * Load a single app from CDN.
+     */
+    async function loadApp(appId) {
+        var _a;
+        // Check if already registered (covers locally-injected bundles)
+        if (registry.has(appId)) {
+            return { appId, success: true, manifest: (_a = registry.get(appId)) === null || _a === void 0 ? void 0 : _a.manifest };
+        }
+        // Check if previously failed — don't retry CDN in the same session.
+        // If the app gets loaded by other means (e.g., local script tag),
+        // the registry.has() check above will catch it on the next call.
+        if (failedApps.has(appId)) {
+            return failedApps.get(appId);
+        }
+        // Check if already loading
+        if (loadingPromises.has(appId)) {
+            return loadingPromises.get(appId);
+        }
+        // Start loading
+        const loadPromise = (async () => {
+            onLoadStart === null || onLoadStart === void 0 ? void 0 : onLoadStart(appId);
+            try {
+                const url = getAppUrl(appId);
+                // Skip if already loaded this URL
+                if (loadedUrls.has(url)) {
+                    const registration = registry.get(appId);
+                    if (registration) {
+                        onLoadEnd === null || onLoadEnd === void 0 ? void 0 : onLoadEnd(appId, true);
+                        return { appId, success: true, manifest: registration.manifest };
+                    }
+                }
+                // Create timeout promise
+                const timeoutPromise = new Promise((_, reject) => {
+                    setTimeout(() => reject(new Error(`Timeout loading app: ${appId}`)), timeout);
+                });
+                // Fetch and execute the app bundle
+                const loadPromise = loadAppBundle(url, appId);
+                await Promise.race([loadPromise, timeoutPromise]);
+                loadedUrls.add(url);
+                // Get the registered manifest
+                const registration = registry.get(appId);
+                if (!registration) {
+                    throw new Error(`App ${appId} did not register after loading`);
+                }
+                onLoadEnd === null || onLoadEnd === void 0 ? void 0 : onLoadEnd(appId, true);
+                return { appId, success: true, manifest: registration.manifest };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                onLoadEnd === null || onLoadEnd === void 0 ? void 0 : onLoadEnd(appId, false, errorMessage);
+                const result = { appId, success: false, error: errorMessage };
+                failedApps.set(appId, result);
+                return result;
+            }
+            finally {
+                loadingPromises.delete(appId);
+            }
+        })();
+        loadingPromises.set(appId, loadPromise);
+        return loadPromise;
+    }
+    /**
+     * Load an app bundle from a URL.
+     */
+    async function loadAppBundle(url, appId) {
+        var _a;
+        // For browser environments, we use dynamic import or script loading
+        if (typeof window !== 'undefined') {
+            // Try dynamic import first (for ES modules)
+            try {
+                const module = await import(/* webpackIgnore: true */ url);
+                // The module should export a manifest and optionally auto-register
+                if (module.manifest) {
+                    registry.register(module.manifest);
+                }
+                else if ((_a = module.default) === null || _a === void 0 ? void 0 : _a.manifest) {
+                    registry.register(module.default.manifest);
+                }
+                else if (module.default) {
+                    // If module.default is the manifest itself
+                    registry.register(module.default);
+                }
+                return;
+            }
+            catch {
+                // Fall back to script tag loading for UMD bundles
+            }
+            // Script tag loading for UMD bundles
+            return new Promise((resolve, reject) => {
+                const script = document.createElement('script');
+                script.src = url;
+                script.async = true;
+                script.onload = () => {
+                    // UMD bundles should register themselves via global
+                    const registered = registry.get(appId);
+                    if (registered) {
+                        resolve();
+                    }
+                    else {
+                        reject(new Error(`App ${appId} did not self-register`));
+                    }
+                };
+                script.onerror = () => {
+                    reject(new Error(`Failed to load app script: ${url}`));
+                };
+                document.head.appendChild(script);
+            });
+        }
+        // For SSR/Node environments, we can't dynamically load apps
+        throw new Error('Dynamic app loading not supported in SSR');
+    }
+    /**
+     * Analyze config to determine which apps need to be loaded.
+     */
+    function getRequiredApps(config) {
+        var _a;
+        const appIds = new Set();
+        // Check explicit app references
+        if (config.apps) {
+            for (const appId of config.apps) {
+                appIds.add(appId);
+            }
+        }
+        // Check action kinds for namespaced actions
+        if (config.actions) {
+            for (const action of config.actions) {
+                const appId = getAppIdFromActionKind(action.kind);
+                if (appId) {
+                    appIds.add(appId);
+                }
+                // Also check core:mountWidget actions for widget namespaces
+                if (action.kind === 'core:mountWidget') {
+                    const widgetId = (_a = action.widget) === null || _a === void 0 ? void 0 : _a.widgetId;
+                    if (widgetId) {
+                        const widgetAppId = getAppIdFromWidgetId(widgetId);
+                        if (widgetAppId) {
+                            appIds.add(widgetAppId);
+                        }
+                    }
+                }
+            }
+        }
+        return Array.from(appIds);
+    }
+    /**
+     * Load all apps required by a config.
+     */
+    async function loadAppsForConfig(config) {
+        const requiredApps = getRequiredApps(config);
+        if (requiredApps.length === 0) {
+            return [];
+        }
+        // Load all apps in parallel
+        const results = await Promise.all(requiredApps.map((appId) => loadApp(appId)));
+        return results;
+    }
+    /**
+     * Preload apps without activating them.
+     */
+    async function preloadApps(appIds) {
+        return Promise.all(appIds.map((appId) => loadApp(appId)));
+    }
+    return {
+        loadApp,
+        loadAppsForConfig,
+        preloadApps,
+        getRequiredApps,
+        getAppUrl,
+    };
+}
+//# sourceMappingURL=AppLoader.js.map

package/dist/apps/AppLoader.js.map

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

package/dist/apps/AppRegistry.d.ts

@@ -0,0 +1,102 @@
+/**
+ * App Registry
+ *
+ * Central registry for managing SynOS apps.
+ * Handles app registration, activation, deactivation, and lifecycle management.
+ */
+import type { SmartCanvasRuntime } from '../runtime';
+import type { AppManifest, AppRegistration, AppRegistryEvent } from './types';
+/**
+ * Callback for app registry events.
+ */
+export type AppRegistryEventCallback = (event: AppRegistryEvent) => void;
+/**
+ * App registry for managing SynOS apps.
+ */
+export declare class AppRegistry {
+    private apps;
+    private eventListeners;
+    private runtime;
+    /**
+     * Bind the registry to a runtime instance.
+     * Must be called before apps can be activated.
+     */
+    bind(runtime: SmartCanvasRuntime): void;
+    /**
+     * Unbind from the current runtime.
+     * Deactivates all active apps first.
+     */
+    unbind(): Promise<void>;
+    /**
+     * Register an app.
+     *
+     * Registration makes the app available but does not activate it.
+     * Call activate() to start the app's runtime extensions.
+     */
+    register(manifest: AppManifest): AppRegistration;
+    /**
+     * Activate an app.
+     *
+     * Activating an app:
+     * 1. Creates an AppContext for sandboxed runtime access
+     * 2. Registers the app's actions with ExecutorRegistry
+     * 3. Registers the app's widgets with WidgetRegistry
+     * 4. Sets up the app's event handlers
+     */
+    activate(appId: string): Promise<void>;
+    /**
+     * Deactivate an app.
+     *
+     * Deactivating an app:
+     * 1. Runs the cleanup function
+     * 2. Unregisters all actions and widgets
+     * 3. Removes event handlers
+     */
+    deactivate(appId: string): Promise<void>;
+    /**
+     * Unregister an app.
+     *
+     * The app must be inactive before it can be unregistered.
+     */
+    unregister(appId: string): Promise<void>;
+    /**
+     * Get an app registration.
+     */
+    get(appId: string): AppRegistration | undefined;
+    /**
+     * Check if an app is registered.
+     */
+    has(appId: string): boolean;
+    /**
+     * Check if an app is active.
+     */
+    isActive(appId: string): boolean;
+    /**
+     * List all registered apps.
+     */
+    list(): AppRegistration[];
+    /**
+     * List all active apps.
+     */
+    listActive(): AppRegistration[];
+    /**
+     * List all apps with editor modules.
+     */
+    listEditable(): AppRegistration[];
+    /**
+     * Subscribe to registry events.
+     */
+    subscribe(callback: AppRegistryEventCallback): () => void;
+    /**
+     * Emit an event to all listeners.
+     */
+    private emit;
+    /**
+     * Clean up all apps.
+     */
+    destroy(): Promise<void>;
+}
+/**
+ * Default singleton instance of AppRegistry.
+ */
+export declare const appRegistry: AppRegistry;