@syntrologie/runtime-sdk 0.2.21 → 1.0.0

package/dist/apps/AppRegistry.js

@@ -0,0 +1,317 @@
+/**
+ * App Registry
+ *
+ * Central registry for managing SynOS apps.
+ * Handles app registration, activation, deactivation, and lifecycle management.
+ */
+import { createAppContext, cleanupAppContext } from './AppContext';
+/**
+ * App registry for managing SynOS apps.
+ */
+export class AppRegistry {
+    constructor() {
+        this.apps = new Map();
+        this.eventListeners = new Set();
+        this.runtime = null;
+    }
+    /**
+     * Bind the registry to a runtime instance.
+     * Must be called before apps can be activated.
+     */
+    bind(runtime) {
+        this.runtime = runtime;
+    }
+    /**
+     * Unbind from the current runtime.
+     * Deactivates all active apps first.
+     */
+    async unbind() {
+        // Deactivate all active apps
+        for (const [appId, registration] of this.apps) {
+            if (registration.state === 'active') {
+                await this.deactivate(appId);
+            }
+        }
+        this.runtime = null;
+    }
+    /**
+     * Register an app.
+     *
+     * Registration makes the app available but does not activate it.
+     * Call activate() to start the app's runtime extensions.
+     */
+    register(manifest) {
+        // Validate manifest
+        if (!manifest.id || typeof manifest.id !== 'string') {
+            throw new Error("App manifest must have an 'id' property");
+        }
+        if (!manifest.version || typeof manifest.version !== 'string') {
+            throw new Error("App manifest must have a 'version' property");
+        }
+        if (!manifest.name || typeof manifest.name !== 'string') {
+            throw new Error("App manifest must have a 'name' property");
+        }
+        // Check for existing registration
+        if (this.apps.has(manifest.id)) {
+            const existing = this.apps.get(manifest.id);
+            if (existing.state === 'active') {
+                throw new Error(`Cannot re-register active app: ${manifest.id}`);
+            }
+            console.warn(`[AppRegistry] Overriding existing app registration: ${manifest.id}`);
+        }
+        // Create registration
+        const registration = {
+            manifest,
+            state: 'registered',
+            registeredAt: Date.now(),
+        };
+        this.apps.set(manifest.id, registration);
+        // Emit event
+        this.emit({
+            type: 'app:registered',
+            appId: manifest.id,
+            manifest,
+        });
+        return registration;
+    }
+    /**
+     * 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
+     */
+    async activate(appId) {
+        var _a;
+        const registration = this.apps.get(appId);
+        if (!registration) {
+            throw new Error(`App not registered: ${appId}`);
+        }
+        if (registration.state === 'active') {
+            console.warn(`[AppRegistry] App already active: ${appId}`);
+            return;
+        }
+        if (!this.runtime) {
+            throw new Error('AppRegistry not bound to a runtime. Call bind() first.');
+        }
+        // Check dependencies
+        if (registration.manifest.dependencies) {
+            for (const depId of registration.manifest.dependencies) {
+                const dep = this.apps.get(depId);
+                if (!dep || dep.state !== 'active') {
+                    throw new Error(`App ${appId} depends on ${depId}, which is not active`);
+                }
+            }
+        }
+        // Update state
+        registration.state = 'activating';
+        try {
+            // Create app context
+            const isBuiltIn = ((_a = registration.manifest.metadata) === null || _a === void 0 ? void 0 : _a.isBuiltIn) === true;
+            const context = createAppContext({
+                appId,
+                runtime: this.runtime,
+                isBuiltIn,
+            });
+            // Register runtime extensions
+            const { runtime: runtimeExtensions } = registration.manifest;
+            const cleanupFns = [];
+            if (runtimeExtensions) {
+                // Register actions
+                if (runtimeExtensions.actions) {
+                    for (const actionDef of runtimeExtensions.actions) {
+                        context.registerAction(actionDef);
+                    }
+                }
+                // Register widgets
+                if (runtimeExtensions.widgets) {
+                    for (const widgetDef of runtimeExtensions.widgets) {
+                        context.registerWidget(widgetDef);
+                    }
+                }
+                // Set up event handlers
+                if (runtimeExtensions.events) {
+                    for (const handler of runtimeExtensions.events) {
+                        const unsubscribe = this.runtime.events.subscribe((event) => {
+                            if (handler.names.includes(event.name)) {
+                                const eventContext = {
+                                    appId,
+                                    state: context.state,
+                                    telemetry: context.telemetry,
+                                    surfaces: context.surfaces,
+                                };
+                                try {
+                                    handler.handler(event, eventContext);
+                                }
+                                catch (error) {
+                                    console.error(`[AppRegistry] Event handler error in ${appId}:`, error);
+                                }
+                            }
+                        });
+                        cleanupFns.push(unsubscribe);
+                    }
+                }
+            }
+            // Store cleanup function
+            registration.cleanup = async () => {
+                // Run cleanup functions
+                for (const fn of cleanupFns) {
+                    try {
+                        await fn();
+                    }
+                    catch (error) {
+                        console.error(`[AppRegistry] Cleanup error in ${appId}:`, error);
+                    }
+                }
+                // Clean up app context resources
+                cleanupAppContext(appId, this.runtime);
+            };
+            // Update state
+            registration.state = 'active';
+            registration.activatedAt = Date.now();
+            // Emit event
+            this.emit({ type: 'app:activated', appId });
+        }
+        catch (error) {
+            registration.state = 'error';
+            registration.error = String(error);
+            this.emit({ type: 'app:error', appId, error: String(error) });
+            throw error;
+        }
+    }
+    /**
+     * Deactivate an app.
+     *
+     * Deactivating an app:
+     * 1. Runs the cleanup function
+     * 2. Unregisters all actions and widgets
+     * 3. Removes event handlers
+     */
+    async deactivate(appId) {
+        var _a;
+        const registration = this.apps.get(appId);
+        if (!registration) {
+            throw new Error(`App not registered: ${appId}`);
+        }
+        if (registration.state !== 'active') {
+            console.warn(`[AppRegistry] App not active: ${appId}`);
+            return;
+        }
+        // Check if any active apps depend on this one
+        for (const [otherId, other] of this.apps) {
+            if (other.state === 'active' && ((_a = other.manifest.dependencies) === null || _a === void 0 ? void 0 : _a.includes(appId))) {
+                throw new Error(`Cannot deactivate ${appId}: app ${otherId} depends on it`);
+            }
+        }
+        // Update state
+        registration.state = 'deactivating';
+        try {
+            // Run cleanup
+            if (registration.cleanup) {
+                await registration.cleanup();
+                registration.cleanup = undefined;
+            }
+            // Update state
+            registration.state = 'inactive';
+            // Emit event
+            this.emit({ type: 'app:deactivated', appId });
+        }
+        catch (error) {
+            registration.state = 'error';
+            registration.error = String(error);
+            this.emit({ type: 'app:error', appId, error: String(error) });
+            throw error;
+        }
+    }
+    /**
+     * Unregister an app.
+     *
+     * The app must be inactive before it can be unregistered.
+     */
+    async unregister(appId) {
+        const registration = this.apps.get(appId);
+        if (!registration) {
+            return;
+        }
+        if (registration.state === 'active') {
+            await this.deactivate(appId);
+        }
+        this.apps.delete(appId);
+        // Emit event
+        this.emit({ type: 'app:unregistered', appId });
+    }
+    /**
+     * Get an app registration.
+     */
+    get(appId) {
+        return this.apps.get(appId);
+    }
+    /**
+     * Check if an app is registered.
+     */
+    has(appId) {
+        return this.apps.has(appId);
+    }
+    /**
+     * Check if an app is active.
+     */
+    isActive(appId) {
+        const registration = this.apps.get(appId);
+        return (registration === null || registration === void 0 ? void 0 : registration.state) === 'active';
+    }
+    /**
+     * List all registered apps.
+     */
+    list() {
+        return Array.from(this.apps.values());
+    }
+    /**
+     * List all active apps.
+     */
+    listActive() {
+        return Array.from(this.apps.values()).filter((r) => r.state === 'active');
+    }
+    /**
+     * List all apps with editor modules.
+     */
+    listEditable() {
+        return Array.from(this.apps.values()).filter((r) => r.manifest.editor !== undefined);
+    }
+    /**
+     * Subscribe to registry events.
+     */
+    subscribe(callback) {
+        this.eventListeners.add(callback);
+        return () => {
+            this.eventListeners.delete(callback);
+        };
+    }
+    /**
+     * Emit an event to all listeners.
+     */
+    emit(event) {
+        for (const listener of this.eventListeners) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error('[AppRegistry] Event listener error:', error);
+            }
+        }
+    }
+    /**
+     * Clean up all apps.
+     */
+    async destroy() {
+        await this.unbind();
+        this.apps.clear();
+        this.eventListeners.clear();
+    }
+}
+/**
+ * Default singleton instance of AppRegistry.
+ */
+export const appRegistry = new AppRegistry();
+//# sourceMappingURL=AppRegistry.js.map

package/dist/apps/AppRegistry.js.map

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

package/dist/apps/examples/gamification-app.example.d.ts

@@ -0,0 +1,305 @@
+/**
+ * EXAMPLE: Gamification App
+ *
+ * This file demonstrates the complete structure of a SynOS app.
+ * Apps are self-contained modules that can be loaded from CDN.
+ *
+ * An app provides:
+ * 1. Runtime extensions (actions, widgets, event handlers)
+ * 2. Config schema (Zod validation)
+ * 3. Editor component (for visual editing)
+ *
+ * This file would be bundled as a standalone module (ES or UMD)
+ * and deployed to CDN at: {cdnBase}/apps/gamification/index.js
+ */
+import { z } from 'zod';
+import type { NormalizedEvent } from '../../events/types';
+import type { AppEventContext } from '../types';
+/**
+ * App config schema - defines what config this app expects.
+ */
+export declare const configSchema: z.ZodObject<{
+    badges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodString;
+        trigger: z.ZodObject<{
+            event: z.ZodString;
+            count: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            event: string;
+            count?: number | undefined;
+        }, {
+            event: string;
+            count?: number | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        trigger: {
+            event: string;
+            count?: number | undefined;
+        };
+        id: string;
+        name: string;
+        icon: string;
+        description?: string | undefined;
+    }, {
+        trigger: {
+            event: string;
+            count?: number | undefined;
+        };
+        id: string;
+        name: string;
+        icon: string;
+        description?: string | undefined;
+    }>, "many">>;
+    showProgress: z.ZodDefault<z.ZodBoolean>;
+    celebrationStyle: z.ZodDefault<z.ZodEnum<["confetti", "toast", "modal"]>>;
+}, "strip", z.ZodTypeAny, {
+    badges: {
+        trigger: {
+            event: string;
+            count?: number | undefined;
+        };
+        id: string;
+        name: string;
+        icon: string;
+        description?: string | undefined;
+    }[];
+    showProgress: boolean;
+    celebrationStyle: "toast" | "modal" | "confetti";
+}, {
+    badges?: {
+        trigger: {
+            event: string;
+            count?: number | undefined;
+        };
+        id: string;
+        name: string;
+        icon: string;
+        description?: string | undefined;
+    }[] | undefined;
+    showProgress?: boolean | undefined;
+    celebrationStyle?: "toast" | "modal" | "confetti" | undefined;
+}>;
+export type GamificationConfig = z.infer<typeof configSchema>;
+/**
+ * Action: Award a badge to the user.
+ */
+declare const AwardBadgeSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"gamification:award_badge">;
+    badgeId: z.ZodString;
+    showCelebration: z.ZodDefault<z.ZodBoolean>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "gamification:award_badge";
+    badgeId: string;
+    showCelebration: boolean;
+    label?: string | undefined;
+}, {
+    kind: "gamification:award_badge";
+    badgeId: string;
+    label?: string | undefined;
+    showCelebration?: boolean | undefined;
+}>;
+/**
+ * Action: Show the progress widget.
+ */
+declare const ShowProgressSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"gamification:show_progress">;
+    slot: z.ZodDefault<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "gamification:show_progress";
+    slot: string;
+    label?: string | undefined;
+}, {
+    kind: "gamification:show_progress";
+    slot?: string | undefined;
+    label?: string | undefined;
+}>;
+/**
+ * Award badge executor.
+ */
+declare function executeAwardBadge(action: z.infer<typeof AwardBadgeSchema>, context: any): Promise<{
+    cleanup: () => void;
+}>;
+/**
+ * Show progress executor.
+ */
+declare function executeShowProgress(action: z.infer<typeof ShowProgressSchema>, context: any): Promise<{
+    cleanup: () => void;
+}>;
+/**
+ * Props passed to the editor component.
+ */
+interface EditorPanelProps {
+    config: Record<string, unknown>;
+    onChange: (config: Record<string, unknown>) => void;
+    editor: {
+        setDirty: (dirty: boolean) => void;
+        navigateHome: () => Promise<boolean>;
+        save: () => Promise<void>;
+        publish: (captureScreenshot?: boolean) => Promise<void>;
+    };
+    platformClient?: unknown;
+}
+/**
+ * Gamification editor component.
+ */
+declare function GamificationEditor({ config, onChange, editor }: EditorPanelProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * The complete app manifest.
+ * This is what gets registered with the AppRegistry.
+ */
+export declare const manifest: {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    runtime: {
+        actions: ({
+            kind: string;
+            schema: z.ZodObject<{
+                kind: z.ZodLiteral<"gamification:award_badge">;
+                badgeId: z.ZodString;
+                showCelebration: z.ZodDefault<z.ZodBoolean>;
+                label: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "gamification:award_badge";
+                badgeId: string;
+                showCelebration: boolean;
+                label?: string | undefined;
+            }, {
+                kind: "gamification:award_badge";
+                badgeId: string;
+                label?: string | undefined;
+                showCelebration?: boolean | undefined;
+            }>;
+            executor: typeof executeAwardBadge;
+        } | {
+            kind: string;
+            schema: z.ZodObject<{
+                kind: z.ZodLiteral<"gamification:show_progress">;
+                slot: z.ZodDefault<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "gamification:show_progress";
+                slot: string;
+                label?: string | undefined;
+            }, {
+                kind: "gamification:show_progress";
+                slot?: string | undefined;
+                label?: string | undefined;
+            }>;
+            executor: typeof executeShowProgress;
+        })[];
+        widgets: ({
+            id: string;
+            component: {
+                mount(container: HTMLElement, config?: {
+                    badgeId: string;
+                    icon: string;
+                    name: string;
+                }): () => void;
+            };
+            metadata: {
+                name: string;
+                icon: string;
+            };
+        } | {
+            id: string;
+            component: {
+                mount(container: HTMLElement, config?: {
+                    progress: number;
+                    total: number;
+                }): () => void;
+            };
+            metadata: {
+                name: string;
+                icon: string;
+            };
+        })[];
+        events: {
+            names: string[];
+            handler: (event: NormalizedEvent, _ctx: AppEventContext) => void;
+        }[];
+    };
+    configSchema: z.ZodObject<{
+        badges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            icon: z.ZodString;
+            trigger: z.ZodObject<{
+                event: z.ZodString;
+                count: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                event: string;
+                count?: number | undefined;
+            }, {
+                event: string;
+                count?: number | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            trigger: {
+                event: string;
+                count?: number | undefined;
+            };
+            id: string;
+            name: string;
+            icon: string;
+            description?: string | undefined;
+        }, {
+            trigger: {
+                event: string;
+                count?: number | undefined;
+            };
+            id: string;
+            name: string;
+            icon: string;
+            description?: string | undefined;
+        }>, "many">>;
+        showProgress: z.ZodDefault<z.ZodBoolean>;
+        celebrationStyle: z.ZodDefault<z.ZodEnum<["confetti", "toast", "modal"]>>;
+    }, "strip", z.ZodTypeAny, {
+        badges: {
+            trigger: {
+                event: string;
+                count?: number | undefined;
+            };
+            id: string;
+            name: string;
+            icon: string;
+            description?: string | undefined;
+        }[];
+        showProgress: boolean;
+        celebrationStyle: "toast" | "modal" | "confetti";
+    }, {
+        badges?: {
+            trigger: {
+                event: string;
+                count?: number | undefined;
+            };
+            id: string;
+            name: string;
+            icon: string;
+            description?: string | undefined;
+        }[] | undefined;
+        showProgress?: boolean | undefined;
+        celebrationStyle?: "toast" | "modal" | "confetti" | undefined;
+    }>;
+    editor: {
+        component: typeof GamificationEditor;
+        panel: {
+            title: string;
+            icon: string;
+            description: string;
+        };
+    };
+    metadata: {
+        author: string;
+        tags: string[];
+    };
+};
+export default manifest;