@orbytautomation/engine 0.1.0

package/dist/lifecycle/EngineLifecycle.js

@@ -0,0 +1,209 @@
+/**
+ * Engine Lifecycle Manager
+ *
+ * Manages engine startup, runtime, and shutdown phases.
+ * Coordinates initialization and cleanup of all engine components.
+ *
+ * @module lifecycle
+ */
+/**
+ * Engine lifecycle state
+ */
+export var EngineState;
+(function (EngineState) {
+    EngineState["STOPPED"] = "stopped";
+    EngineState["STARTING"] = "starting";
+    EngineState["RUNNING"] = "running";
+    EngineState["STOPPING"] = "stopping";
+    EngineState["ERROR"] = "error";
+})(EngineState || (EngineState = {}));
+/**
+ * Engine lifecycle manager
+ */
+export class EngineLifecycle {
+    state = EngineState.STOPPED;
+    components = [];
+    listeners = [];
+    stateHistory = [];
+    /**
+     * Register a lifecycle component
+     *
+     * @param component - Component to register
+     */
+    registerComponent(component) {
+        if (this.state !== EngineState.STOPPED) {
+            throw new Error('Cannot register components while engine is running');
+        }
+        this.components.push(component);
+    }
+    /**
+     * Register multiple components
+     *
+     * @param components - Components to register
+     */
+    registerComponents(components) {
+        for (const component of components) {
+            this.registerComponent(component);
+        }
+    }
+    /**
+     * Add state change listener
+     *
+     * @param listener - Listener function
+     */
+    on(listener) {
+        this.listeners.push(listener);
+    }
+    /**
+     * Remove state change listener
+     *
+     * @param listener - Listener to remove
+     */
+    off(listener) {
+        const index = this.listeners.indexOf(listener);
+        if (index !== -1) {
+            this.listeners.splice(index, 1);
+        }
+    }
+    /**
+     * Start the engine
+     *
+     * Initializes all registered components in order.
+     */
+    async start() {
+        if (this.state !== EngineState.STOPPED) {
+            throw new Error(`Cannot start engine from state: ${this.state}`);
+        }
+        this.setState(EngineState.STARTING, 'Engine starting...');
+        try {
+            // Start components in order
+            for (const component of this.components) {
+                if (component.start) {
+                    this.emit('info', `Starting ${component.name}...`);
+                    await component.start();
+                    this.emit('info', `${component.name} started`);
+                }
+            }
+            this.setState(EngineState.RUNNING, 'Engine running');
+            this.emit('info', 'Engine started successfully');
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.setState(EngineState.ERROR, 'Engine start failed', err);
+            throw err;
+        }
+    }
+    /**
+     * Stop the engine
+     *
+     * Cleanly shuts down all components in reverse order.
+     */
+    async stop() {
+        if (this.state === EngineState.STOPPED) {
+            return; // Already stopped
+        }
+        if (this.state === EngineState.STOPPING) {
+            throw new Error('Engine is already stopping');
+        }
+        this.setState(EngineState.STOPPING, 'Engine stopping...');
+        try {
+            // Stop components in reverse order
+            const reversedComponents = [...this.components].reverse();
+            for (const component of reversedComponents) {
+                if (component.stop) {
+                    this.emit('info', `Stopping ${component.name}...`);
+                    try {
+                        await component.stop();
+                        this.emit('info', `${component.name} stopped`);
+                    }
+                    catch (error) {
+                        // Log but continue stopping other components
+                        this.emit('error', `Error stopping ${component.name}: ${error}`);
+                    }
+                }
+            }
+            this.setState(EngineState.STOPPED, 'Engine stopped');
+            this.emit('info', 'Engine stopped successfully');
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.setState(EngineState.ERROR, 'Engine stop failed', err);
+            throw err;
+        }
+    }
+    /**
+     * Graceful shutdown with timeout
+     *
+     * @param timeoutMs - Maximum time to wait for shutdown
+     */
+    async gracefulShutdown(timeoutMs = 30000) {
+        const shutdownPromise = this.stop();
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => {
+                reject(new Error(`Engine shutdown timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+        });
+        try {
+            await Promise.race([shutdownPromise, timeoutPromise]);
+        }
+        catch (error) {
+            this.emit('error', `Forced shutdown: ${error}`);
+            // Force state to stopped
+            this.state = EngineState.STOPPED;
+            throw error;
+        }
+    }
+    /**
+     * Get current engine state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Check if engine is running
+     */
+    isRunning() {
+        return this.state === EngineState.RUNNING;
+    }
+    /**
+     * Get state history
+     */
+    getHistory() {
+        return [...this.stateHistory];
+    }
+    /**
+     * Get registered components
+     */
+    getComponents() {
+        return [...this.components];
+    }
+    /**
+     * Set engine state and notify listeners
+     */
+    setState(state, details, error) {
+        this.state = state;
+        const event = {
+            state,
+            timestamp: new Date(),
+            details,
+            error,
+        };
+        this.stateHistory.push(event);
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (err) {
+                console.error('Error in lifecycle listener:', err);
+            }
+        }
+    }
+    /**
+     * Emit log message to console
+     */
+    emit(level, message) {
+        const prefix = level === 'error' ? '❌' : '✓';
+        console.log(`${prefix} [Lifecycle] ${message}`);
+    }
+}
+//# sourceMappingURL=EngineLifecycle.js.map

package/dist/lifecycle/EngineLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngineLifecycle.js","sourceRoot":"","sources":["../../src/lifecycle/EngineLifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;IACrB,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;IACrB,8BAAe,CAAA;AACjB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAkCD;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,KAAK,GAAgB,WAAW,CAAC,OAAO,CAAC;IACzC,UAAU,GAAyB,EAAE,CAAC;IACtC,SAAS,GAAwB,EAAE,CAAC;IACpC,YAAY,GAAqB,EAAE,CAAC;IAE5C;;;;OAIG;IACH,iBAAiB,CAAC,SAA6B;QAC7C,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,oDAAoD,CACrD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,UAAgC;QACjD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,EAAE,CAAC,QAA2B;QAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,QAA2B;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,CAAC,KAAK,EAAE,CAChD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;QAE1D,IAAI,CAAC;YACH,4BAA4B;YAC5B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACxC,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;oBACpB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,SAAS,CAAC,IAAI,KAAK,CAAC,CAAC;oBACnD,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;oBACxB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,UAAU,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;YAC7D,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;YACvC,OAAO,CAAC,kBAAkB;QAC5B,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;QAE1D,IAAI,CAAC;YACH,mCAAmC;YACnC,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;YAE1D,KAAK,MAAM,SAAS,IAAI,kBAAkB,EAAE,CAAC;gBAC3C,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;oBACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,SAAS,CAAC,IAAI,KAAK,CAAC,CAAC;oBACnD,IAAI,CAAC;wBACH,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;wBACvB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,UAAU,CAAC,CAAC;oBACjD,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,6CAA6C;wBAC7C,IAAI,CAAC,IAAI,CACP,OAAO,EACP,kBAAkB,SAAS,CAAC,IAAI,KAAK,KAAK,EAAE,CAC7C,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,CAAC,CAAC;YAC5D,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAAC,YAAoB,KAAK;QAC9C,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YACtD,UAAU,CAAC,GAAG,EAAE;gBACd,MAAM,CAAC,IAAI,KAAK,CACd,mCAAmC,SAAS,IAAI,CACjD,CAAC,CAAC;YACL,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,oBAAoB,KAAK,EAAE,CAAC,CAAC;YAChD,yBAAyB;YACzB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC;YACjC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,OAAO,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,QAAQ,CACd,KAAkB,EAClB,OAAgB,EAChB,KAAa;QAEb,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,MAAM,KAAK,GAAmB;YAC5B,KAAK;YACL,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO;YACP,KAAK;SACN,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE9B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,IAAI,CAAC,KAAuB,EAAE,OAAe;QACnD,MAAM,MAAM,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,gBAAgB,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/lifecycle/ShutdownManager.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shutdown Manager
+ *
+ * Handles graceful engine shutdown and cleanup.
+ *
+ * @module lifecycle
+ */
+/**
+ * Shutdown handler function
+ */
+export type ShutdownHandler = () => Promise<void> | void;
+/**
+ * Shutdown manager for graceful engine shutdown
+ */
+export declare class ShutdownManager {
+    private handlers;
+    private shutdownInProgress;
+    /**
+     * Register a shutdown handler
+     *
+     * Handlers are executed in FIFO order on shutdown.
+     *
+     * @param name - Handler name
+     * @param handler - Shutdown handler function
+     */
+    registerHandler(name: string, handler: ShutdownHandler): void;
+    /**
+     * Execute all shutdown handlers
+     *
+     * @param timeoutMs - Maximum time per handler
+     */
+    executeHandlers(timeoutMs?: number): Promise<void>;
+    /**
+     * Setup signal handlers for graceful shutdown
+     *
+     * @param onShutdown - Function to call on shutdown signal
+     */
+    static setupSignalHandlers(onShutdown: () => Promise<void>): void;
+    /**
+     * Check if shutdown is in progress
+     */
+    isShuttingDown(): boolean;
+}
+//# sourceMappingURL=ShutdownManager.d.ts.map

package/dist/lifecycle/ShutdownManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShutdownManager.d.ts","sourceRoot":"","sources":["../../src/lifecycle/ShutdownManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEzD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAyD;IACzE,OAAO,CAAC,kBAAkB,CAAS;IAEnC;;;;;;;OAOG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAI7D;;;;OAIG;IACG,eAAe,CAAC,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC/D;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IA2CjE;;OAEG;IACH,cAAc,IAAI,OAAO;CAG1B"}

package/dist/lifecycle/ShutdownManager.js

@@ -0,0 +1,105 @@
+/**
+ * Shutdown Manager
+ *
+ * Handles graceful engine shutdown and cleanup.
+ *
+ * @module lifecycle
+ */
+/**
+ * Shutdown manager for graceful engine shutdown
+ */
+export class ShutdownManager {
+    handlers = [];
+    shutdownInProgress = false;
+    /**
+     * Register a shutdown handler
+     *
+     * Handlers are executed in FIFO order on shutdown.
+     *
+     * @param name - Handler name
+     * @param handler - Shutdown handler function
+     */
+    registerHandler(name, handler) {
+        this.handlers.push({ name, handler });
+    }
+    /**
+     * Execute all shutdown handlers
+     *
+     * @param timeoutMs - Maximum time per handler
+     */
+    async executeHandlers(timeoutMs = 10000) {
+        if (this.shutdownInProgress) {
+            console.log('⚠️  Shutdown already in progress');
+            return;
+        }
+        this.shutdownInProgress = true;
+        console.log('🛑 Executing shutdown handlers...\n');
+        for (const { name, handler } of this.handlers) {
+            try {
+                const handlerPromise = handler();
+                const timeoutPromise = new Promise((_, reject) => {
+                    setTimeout(() => {
+                        reject(new Error(`Timeout after ${timeoutMs}ms`));
+                    }, timeoutMs);
+                });
+                await Promise.race([handlerPromise, timeoutPromise]);
+                console.log(`  ✓ ${name}`);
+            }
+            catch (error) {
+                console.log(`  ✗ ${name}: ${error instanceof Error ? error.message : error}`);
+                // Continue with other handlers even if one fails
+            }
+        }
+        console.log('');
+        this.shutdownInProgress = false;
+    }
+    /**
+     * Setup signal handlers for graceful shutdown
+     *
+     * @param onShutdown - Function to call on shutdown signal
+     */
+    static setupSignalHandlers(onShutdown) {
+        const signals = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+        for (const signal of signals) {
+            process.on(signal, async () => {
+                console.log(`\n📡 Received ${signal} signal`);
+                try {
+                    await onShutdown();
+                    process.exit(0);
+                }
+                catch (error) {
+                    console.error('❌ Shutdown error:', error);
+                    process.exit(1);
+                }
+            });
+        }
+        // Handle uncaught errors
+        process.on('uncaughtException', async (error) => {
+            console.error('❌ Uncaught exception:', error);
+            try {
+                await onShutdown();
+            }
+            catch {
+                // Ignore errors during emergency shutdown
+            }
+            process.exit(1);
+        });
+        process.on('unhandledRejection', async (reason) => {
+            console.error('❌ Unhandled rejection:', reason);
+            try {
+                await onShutdown();
+            }
+            catch {
+                // Ignore errors during emergency shutdown
+            }
+            process.exit(1);
+        });
+    }
+    /**
+     * Check if shutdown is in progress
+     */
+    isShuttingDown() {
+        return this.shutdownInProgress;
+    }
+}
+//# sourceMappingURL=ShutdownManager.js.map

package/dist/lifecycle/ShutdownManager.js.map

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

package/dist/lifecycle/StartupManager.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Startup Manager
+ *
+ * Handles engine initialization and startup checks.
+ *
+ * @module lifecycle
+ */
+/**
+ * Startup check result
+ */
+export interface StartupCheck {
+    name: string;
+    passed: boolean;
+    message?: string;
+    duration: number;
+}
+/**
+ * Startup check function
+ */
+export type CheckFunction = () => Promise<void> | void;
+/**
+ * Startup manager for engine initialization
+ */
+export declare class StartupManager {
+    private checks;
+    /**
+     * Register a startup check
+     *
+     * @param name - Check name
+     * @param checkFn - Check function (should throw on failure)
+     */
+    registerCheck(name: string, checkFn: CheckFunction): void;
+    /**
+     * Run all startup checks
+     *
+     * @returns Array of check results
+     * @throws {Error} If any critical check fails
+     */
+    runChecks(): Promise<StartupCheck[]>;
+    /**
+     * Create default startup checks
+     */
+    static createDefaultChecks(): StartupManager;
+}
+//# sourceMappingURL=StartupManager.d.ts.map

package/dist/lifecycle/StartupManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartupManager.d.ts","sourceRoot":"","sources":["../../src/lifecycle/StartupManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEvD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyC;IAEvD;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAIzD;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAgD1C;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,cAAc;CAuC7C"}

package/dist/lifecycle/StartupManager.js

@@ -0,0 +1,97 @@
+/**
+ * Startup Manager
+ *
+ * Handles engine initialization and startup checks.
+ *
+ * @module lifecycle
+ */
+/**
+ * Startup manager for engine initialization
+ */
+export class StartupManager {
+    checks = new Map();
+    /**
+     * Register a startup check
+     *
+     * @param name - Check name
+     * @param checkFn - Check function (should throw on failure)
+     */
+    registerCheck(name, checkFn) {
+        this.checks.set(name, checkFn);
+    }
+    /**
+     * Run all startup checks
+     *
+     * @returns Array of check results
+     * @throws {Error} If any critical check fails
+     */
+    async runChecks() {
+        const results = [];
+        console.log('🔍 Running startup checks...\n');
+        for (const [name, checkFn] of this.checks.entries()) {
+            const startTime = Date.now();
+            try {
+                await checkFn();
+                const duration = Date.now() - startTime;
+                results.push({
+                    name,
+                    passed: true,
+                    duration,
+                });
+                console.log(`  ✓ ${name} (${duration}ms)`);
+            }
+            catch (error) {
+                const duration = Date.now() - startTime;
+                const message = error instanceof Error ? error.message : String(error);
+                results.push({
+                    name,
+                    passed: false,
+                    message,
+                    duration,
+                });
+                console.log(`  ✗ ${name}: ${message} (${duration}ms)`);
+            }
+        }
+        console.log('');
+        // Check if any failed
+        const failed = results.filter(r => !r.passed);
+        if (failed.length > 0) {
+            throw new Error(`${failed.length} startup check(s) failed:\n` +
+                failed.map(f => `  - ${f.name}: ${f.message}`).join('\n'));
+        }
+        return results;
+    }
+    /**
+     * Create default startup checks
+     */
+    static createDefaultChecks() {
+        const manager = new StartupManager();
+        // Check Node version
+        manager.registerCheck('Node.js version', () => {
+            const version = process.versions.node;
+            const major = parseInt(version.split('.')[0], 10);
+            if (major < 18) {
+                throw new Error(`Node.js ${version} is not supported. Minimum: 18.0.0`);
+            }
+        });
+        // Check memory availability
+        manager.registerCheck('Memory availability', () => {
+            const freeMem = process.memoryUsage().heapTotal;
+            const minRequired = 100 * 1024 * 1024; // 100MB
+            if (freeMem < minRequired) {
+                throw new Error(`Insufficient memory: ${Math.round(freeMem / 1024 / 1024)}MB available, ` +
+                    `${Math.round(minRequired / 1024 / 1024)}MB required`);
+            }
+        });
+        // Check environment
+        manager.registerCheck('Environment variables', () => {
+            // Add any required env var checks here
+            // Example:
+            // if (!process.env.REQUIRED_VAR) {
+            //   throw new Error('REQUIRED_VAR not set');
+            // }
+        });
+        return manager;
+    }
+}
+//# sourceMappingURL=StartupManager.js.map

package/dist/lifecycle/StartupManager.js.map

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

package/dist/lifecycle/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Lifecycle Module
+ *
+ * Engine lifecycle management (startup, runtime, shutdown).
+ */
+export * from './EngineLifecycle.js';
+export * from './StartupManager.js';
+export * from './ShutdownManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lifecycle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/lifecycle/index.js

@@ -0,0 +1,9 @@
+/**
+ * Lifecycle Module
+ *
+ * Engine lifecycle management (startup, runtime, shutdown).
+ */
+export * from './EngineLifecycle.js';
+export * from './StartupManager.js';
+export * from './ShutdownManager.js';
+//# sourceMappingURL=index.js.map

package/dist/lifecycle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/logging/LogLevel.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=LogLevel.d.ts.map

package/dist/logging/LogLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.d.ts","sourceRoot":"","sources":["../../src/logging/LogLevel.ts"],"names":[],"mappings":""}

package/dist/logging/LogLevel.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=LogLevel.js.map

package/dist/logging/LogLevel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.js","sourceRoot":"","sources":["../../src/logging/LogLevel.ts"],"names":[],"mappings":""}

package/dist/logging/Logger.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Logger.d.ts.map

package/dist/logging/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/logging/Logger.ts"],"names":[],"mappings":""}

package/dist/logging/Logger.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Logger.js.map

package/dist/logging/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/logging/Logger.ts"],"names":[],"mappings":""}

package/dist/logging/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":""}

package/dist/logging/index.js

@@ -0,0 +1,4 @@
+export {};
+// export * from './LogLevel.js';
+// export * from './Logger.js';
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":";AAAA,iCAAiC;AACjC,+BAA+B"}