@zudojs/runtime 0.0.1

package/dist/lifecycle/lifecycle.type.d.ts

@@ -0,0 +1,51 @@
+import type { Module } from "@zudojs/core";
+/**
+ * Lifecycle hook phases for modules.
+ */
+export type LifecyclePhase = "initialize" | "start" | "stop" | "destroy";
+/**
+ * Result of a lifecycle operation.
+ */
+export interface LifecycleResult {
+    readonly phase: LifecyclePhase;
+    readonly succeeded: readonly string[];
+    readonly failed: readonly LifecycleFailure[];
+    readonly durationMs: number;
+}
+/**
+ * Failure information for a lifecycle operation.
+ */
+export interface LifecycleFailure {
+    readonly moduleId: string;
+    readonly phase: LifecyclePhase;
+    readonly error: Error;
+    readonly durationMs: number;
+}
+/**
+ * Context passed to lifecycle hooks.
+ */
+export interface LifecycleContext {
+    readonly runtimeId: string;
+    readonly environment: string;
+    readonly phase: LifecyclePhase;
+    readonly moduleId: string;
+    readonly container: import("@zudojs/container").Container;
+    readonly logger: import("@zudojs/logger").Logger;
+}
+/**
+ * A module entry in the lifecycle manager.
+ */
+export interface ManagedModule {
+    readonly module: Module;
+    readonly depth: number;
+    readonly dependencies: readonly string[];
+}
+/**
+ * Options for lifecycle management.
+ */
+export interface LifecycleManagerOptions {
+    readonly shutdownTimeout?: number;
+    readonly continueOnFailure?: boolean;
+    readonly parallelInitialization?: boolean;
+}
+//# sourceMappingURL=lifecycle.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.type.d.ts","sourceRoot":"","sources":["../../src/lifecycle/lifecycle.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,mBAAmB,EAAE,SAAS,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,OAAO,gBAAgB,EAAE,MAAM,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAC3C"}

package/dist/lifecycle/lifecycle.type.js

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

package/dist/lifecycle/lifecycle.type.js.map

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

package/dist/readiness/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Runtime readiness tracking.
+ */
+export { ReadinessTracker } from "./readiness.core.js";
+export type { ReadinessState, ReadinessCheck, ReadinessTrackerState, ReadinessOptions, } from "./readiness.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/readiness/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,YAAY,EACV,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/readiness/index.js

@@ -0,0 +1,5 @@
+/**
+ * Runtime readiness tracking.
+ */
+export { ReadinessTracker } from "./readiness.core.js";
+//# sourceMappingURL=index.js.map

package/dist/readiness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/readiness/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/readiness/readiness.core.d.ts

@@ -0,0 +1,45 @@
+import type { ReadinessState, ReadinessTrackerState, ReadinessOptions } from "./readiness.type.js";
+/**
+ * Tracks runtime readiness state.
+ */
+export declare class ReadinessTracker {
+    private state;
+    private readonly checks;
+    private readonly autoMarkReady;
+    private ready;
+    private reason?;
+    constructor(options?: ReadinessOptions);
+    /**
+     * Registers a readiness check.
+     */
+    registerCheck(name: string, check: () => boolean | Promise<boolean>): void;
+    /**
+     * Updates a readiness check result.
+     */
+    updateCheck(name: string, check: () => boolean | Promise<boolean>): Promise<void>;
+    /**
+     * Marks the runtime as ready.
+     */
+    markReady(reason?: string): void;
+    /**
+     * Marks the runtime as not ready.
+     */
+    markNotReady(reason?: string): void;
+    /**
+     * Updates the readiness state.
+     */
+    setState(state: ReadinessState, reason?: string): void;
+    /**
+     * Returns whether the runtime is ready.
+     */
+    isReady(): boolean;
+    /**
+     * Returns the current readiness state.
+     */
+    getState(): ReadinessTrackerState;
+    /**
+     * Evaluates overall readiness based on registered checks.
+     */
+    private evaluateReadiness;
+}
+//# sourceMappingURL=readiness.core.d.ts.map

package/dist/readiness/readiness.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.core.d.ts","sourceRoot":"","sources":["../../src/readiness/readiness.core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAEd,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAC,CAAS;IAExB,YAAmB,OAAO,GAAE,gBAAqB,EAQhD;IAED;;OAEG;IACI,aAAa,CAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GACtC,IAAI,CAQN;IAED;;OAEG;IACU,WAAW,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAqBf;IAED;;OAEG;IACI,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAItC;IAED;;OAEG;IACI,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAOzC;IAED;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAU5D;IAED;;OAEG;IACI,OAAO,IAAI,OAAO,CAExB;IAED;;OAEG;IACI,QAAQ,IAAI,qBAAqB,CAOvC;IAED;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAW1B"}

package/dist/readiness/readiness.core.js

@@ -0,0 +1,115 @@
+/**
+ * Tracks runtime readiness state.
+ */
+export class ReadinessTracker {
+    state = "not_ready";
+    checks = new Map();
+    autoMarkReady;
+    ready = false;
+    reason;
+    constructor(options = {}) {
+        this.autoMarkReady = options.autoMarkReady ?? true;
+        if (options.initialChecks) {
+            for (const check of options.initialChecks) {
+                this.registerCheck(check.name, check.check);
+            }
+        }
+    }
+    /**
+     * Registers a readiness check.
+     */
+    registerCheck(name, check) {
+        this.checks.set(name, {
+            name,
+            ready: false,
+            lastCheckedAt: new Date(),
+        });
+        this.evaluateReadiness();
+    }
+    /**
+     * Updates a readiness check result.
+     */
+    async updateCheck(name, check) {
+        const startTime = Date.now();
+        try {
+            const result = await check();
+            this.checks.set(name, {
+                name,
+                ready: result,
+                lastCheckedAt: new Date(),
+            });
+        }
+        catch {
+            this.checks.set(name, {
+                name,
+                ready: false,
+                lastCheckedAt: new Date(),
+                message: "Check threw an error",
+            });
+        }
+        this.evaluateReadiness();
+    }
+    /**
+     * Marks the runtime as ready.
+     */
+    markReady(reason) {
+        this.state = "ready";
+        this.ready = true;
+        this.reason = reason;
+    }
+    /**
+     * Marks the runtime as not ready.
+     */
+    markNotReady(reason) {
+        this.ready = false;
+        this.reason = reason;
+        if (this.state === "ready") {
+            this.state = "degraded";
+        }
+    }
+    /**
+     * Updates the readiness state.
+     */
+    setState(state, reason) {
+        this.state = state;
+        if (state === "ready") {
+            this.ready = true;
+        }
+        else if (state === "not_ready" || state === "shutting_down") {
+            this.ready = false;
+        }
+        this.reason = reason;
+    }
+    /**
+     * Returns whether the runtime is ready.
+     */
+    isReady() {
+        return this.ready;
+    }
+    /**
+     * Returns the current readiness state.
+     */
+    getState() {
+        return Object.freeze({
+            state: this.state,
+            checks: Object.freeze(new Map(this.checks)),
+            ready: this.ready,
+            reason: this.reason,
+        });
+    }
+    /**
+     * Evaluates overall readiness based on registered checks.
+     */
+    evaluateReadiness() {
+        if (this.autoMarkReady && this.checks.size > 0) {
+            const allReady = [...this.checks.values()].every((check) => check.ready);
+            if (allReady && !this.ready) {
+                this.markReady("All readiness checks passed.");
+            }
+            else if (!allReady && this.ready) {
+                this.markNotReady("One or more readiness checks failed.");
+            }
+        }
+    }
+}
+//# sourceMappingURL=readiness.core.js.map

package/dist/readiness/readiness.core.js.map

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

package/dist/readiness/readiness.type.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Readiness state of the runtime.
+ */
+export type ReadinessState = "not_ready" | "initializing" | "ready" | "degraded" | "shutting_down";
+/**
+ * Readiness check result.
+ */
+export interface ReadinessCheck {
+    readonly name: string;
+    readonly ready: boolean;
+    readonly message?: string;
+    readonly lastCheckedAt: Date;
+}
+/**
+ * Readiness tracker state.
+ */
+export interface ReadinessTrackerState {
+    readonly state: ReadinessState;
+    readonly checks: ReadonlyMap<string, ReadinessCheck>;
+    readonly ready: boolean;
+    readonly reason?: string;
+}
+/**
+ * Options for readiness tracking.
+ */
+export interface ReadinessOptions {
+    /**
+     * Initial readiness checks to register.
+     */
+    readonly initialChecks?: ReadonlyArray<{
+        readonly name: string;
+        readonly check: () => boolean | Promise<boolean>;
+    }>;
+    /**
+     * Whether to automatically mark as ready when all checks pass.
+     * @default true
+     */
+    readonly autoMarkReady?: boolean;
+}
+//# sourceMappingURL=readiness.type.d.ts.map

package/dist/readiness/readiness.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.type.d.ts","sourceRoot":"","sources":["../../src/readiness/readiness.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GACxB,WAAW,GAAG,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,eAAe,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;QACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAClD,CAAC,CAAC;IAEH;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC"}

package/dist/readiness/readiness.type.js

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

package/dist/readiness/readiness.type.js.map

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

package/dist/registry/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @zudojs/runtime — Registry Barrel
+ */
+export { RuntimeRegistry } from "./registry.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,5 @@
+/**
+ * @zudojs/runtime — Registry Barrel
+ */
+export { RuntimeRegistry } from "./registry.core.js";
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registry/registry.core.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @zudojs/runtime — Runtime Registry
+ *
+ * Manages multiple runtime instances for scenarios where Zudojs
+ * runs multiple applications or workers in a single process.
+ */
+import type { Runtime } from "../runtime/runtime.core.js";
+/**
+ * Runtime registry for managing multiple runtime instances.
+ *
+ * Useful for:
+ * - API server + Worker + Scheduler in one process
+ * - Testing multiple runtime configurations
+ * - Embedded runtimes
+ */
+export declare class RuntimeRegistry {
+    private readonly runtimes;
+    /**
+     * Register a runtime instance.
+     */
+    register(id: string, runtime: Runtime): void;
+    /**
+     * Unregister a runtime instance.
+     */
+    unregister(id: string): void;
+    /**
+     * Get a runtime by ID.
+     */
+    get(id: string): Runtime | undefined;
+    /**
+     * Get a required runtime by ID (throws if not found).
+     */
+    require(id: string): Runtime;
+    /**
+     * Check if a runtime is registered.
+     */
+    has(id: string): boolean;
+    /**
+     * Get all registered runtime IDs.
+     */
+    getIds(): readonly string[];
+    /**
+     * Get all registered runtimes.
+     */
+    getAll(): readonly Runtime[];
+    /**
+     * Get the count of registered runtimes.
+     */
+    get size(): number;
+    /**
+     * Start all registered runtimes.
+     */
+    startAll(): Promise<void>;
+    /**
+     * Stop all registered runtimes.
+     */
+    stopAll(): Promise<void>;
+    /**
+     * Check if all runtimes are ready.
+     */
+    isAllReady(): boolean;
+    /**
+     * Get status of all runtimes.
+     */
+    getStatus(): Record<string, {
+        state: string;
+        ready: boolean;
+    }>;
+    /**
+     * Clear all registered runtimes.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=registry.core.d.ts.map

package/dist/registry/registry.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.core.d.ts","sourceRoot":"","sources":["../../src/registry/registry.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAEvD;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAK3C;IAED;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3B;IAED;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEnC;IAED;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAM3B;IAED;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEvB;IAED;;OAEG;IACH,MAAM,IAAI,SAAS,MAAM,EAAE,CAE1B;IAED;;OAEG;IACH,MAAM,IAAI,SAAS,OAAO,EAAE,CAE3B;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAI9B;IAED;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAU7B;IAED;;OAEG;IACH,UAAU,IAAI,OAAO,CAOpB;IAED;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAS7D;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;CACF"}

package/dist/registry/registry.core.js

@@ -0,0 +1,126 @@
+/**
+ * @zudojs/runtime — Runtime Registry
+ *
+ * Manages multiple runtime instances for scenarios where Zudojs
+ * runs multiple applications or workers in a single process.
+ */
+/**
+ * Runtime registry for managing multiple runtime instances.
+ *
+ * Useful for:
+ * - API server + Worker + Scheduler in one process
+ * - Testing multiple runtime configurations
+ * - Embedded runtimes
+ */
+export class RuntimeRegistry {
+    runtimes = new Map();
+    /**
+     * Register a runtime instance.
+     */
+    register(id, runtime) {
+        if (this.runtimes.has(id)) {
+            throw new Error(`Runtime "${id}" is already registered.`);
+        }
+        this.runtimes.set(id, runtime);
+    }
+    /**
+     * Unregister a runtime instance.
+     */
+    unregister(id) {
+        this.runtimes.delete(id);
+    }
+    /**
+     * Get a runtime by ID.
+     */
+    get(id) {
+        return this.runtimes.get(id);
+    }
+    /**
+     * Get a required runtime by ID (throws if not found).
+     */
+    require(id) {
+        const runtime = this.runtimes.get(id);
+        if (!runtime) {
+            throw new Error(`Runtime "${id}" not found.`);
+        }
+        return runtime;
+    }
+    /**
+     * Check if a runtime is registered.
+     */
+    has(id) {
+        return this.runtimes.has(id);
+    }
+    /**
+     * Get all registered runtime IDs.
+     */
+    getIds() {
+        return Array.from(this.runtimes.keys());
+    }
+    /**
+     * Get all registered runtimes.
+     */
+    getAll() {
+        return Array.from(this.runtimes.values());
+    }
+    /**
+     * Get the count of registered runtimes.
+     */
+    get size() {
+        return this.runtimes.size;
+    }
+    /**
+     * Start all registered runtimes.
+     */
+    async startAll() {
+        for (const runtime of this.runtimes.values()) {
+            await runtime.start();
+        }
+    }
+    /**
+     * Stop all registered runtimes.
+     */
+    async stopAll() {
+        // Stop in reverse registration order
+        const runtimes = Array.from(this.runtimes.values()).reverse();
+        for (const runtime of runtimes) {
+            try {
+                await runtime.stop();
+            }
+            catch {
+                // Continue stopping other runtimes even if one fails
+            }
+        }
+    }
+    /**
+     * Check if all runtimes are ready.
+     */
+    isAllReady() {
+        for (const runtime of this.runtimes.values()) {
+            if (!runtime.ready) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Get status of all runtimes.
+     */
+    getStatus() {
+        const result = {};
+        for (const [id, runtime] of this.runtimes) {
+            result[id] = {
+                state: runtime.state,
+                ready: runtime.ready,
+            };
+        }
+        return result;
+    }
+    /**
+     * Clear all registered runtimes.
+     */
+    clear() {
+        this.runtimes.clear();
+    }
+}
+//# sourceMappingURL=registry.core.js.map

package/dist/registry/registry.core.js.map

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

package/dist/runtime/runtime.core.d.ts

@@ -0,0 +1,97 @@
+import type { Logger } from "@zudojs/logger";
+import type { EventBus } from "@zudojs/events";
+import type { Container } from "@zudojs/container";
+import type { Module } from "@zudojs/core";
+import type { RuntimeState, RuntimeStatus } from "../runtimeState/index.js";
+import type { RuntimeOptions } from "../runtimeOptions/index.js";
+import type { RuntimeContext } from "../runtimeContext/index.js";
+/**
+ * Zudojs runtime interface.
+ *
+ * The runtime is the orchestrator that manages the complete
+ * application lifecycle from creation through shutdown.
+ */
+export interface Runtime {
+    readonly state: RuntimeState;
+    readonly status: RuntimeStatus;
+    readonly context: RuntimeContext;
+    readonly ready: boolean;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+/**
+ * Dependencies required to create a runtime.
+ */
+export interface RuntimeDependencies {
+    readonly modules: ReadonlyMap<string, Module>;
+    readonly logger: Logger;
+    readonly container: Container;
+    readonly eventBus: EventBus;
+}
+/**
+ * Default runtime implementation.
+ */
+export declare class DefaultRuntime implements Runtime {
+    private _state;
+    private _status;
+    private _context;
+    private _ready;
+    private _startedAt?;
+    private _stoppedAt?;
+    private _failedAt?;
+    private _error?;
+    private readonly options;
+    private readonly modules;
+    private readonly logger;
+    private readonly lifecycle;
+    private readonly signalHandler;
+    private readonly readinessTracker;
+    private startPromise;
+    private stopPromise;
+    constructor(dependencies: RuntimeDependencies, options: RuntimeOptions);
+    /**
+     * Current runtime state.
+     */
+    get state(): RuntimeState;
+    /**
+     * Current runtime status.
+     */
+    get status(): RuntimeStatus;
+    /**
+     * Runtime context.
+     */
+    get context(): RuntimeContext;
+    /**
+     * Whether the runtime is ready.
+     */
+    get ready(): boolean;
+    /**
+     * Starts the runtime.
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the runtime.
+     */
+    stop(): Promise<void>;
+    /**
+     * Performs runtime startup.
+     */
+    private performStart;
+    /**
+     * Performs runtime shutdown.
+     */
+    private performStop;
+    /**
+     * Transitions to a new state.
+     */
+    private transitionTo;
+    /**
+     * Emits a runtime event.
+     */
+    private emitEvent;
+}
+/**
+ * Creates a runtime instance.
+ */
+export declare function createRuntime(dependencies: RuntimeDependencies, options: RuntimeOptions): Runtime;
+//# sourceMappingURL=runtime.core.d.ts.map

package/dist/runtime/runtime.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.core.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAGd,MAAM,0BAA0B,CAAC;AAQlC,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AAIpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAkCjE;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,cAAe,YAAW,OAAO;IAC5C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAC,CAAO;IAC1B,OAAO,CAAC,UAAU,CAAC,CAAO;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAO;IACzB,OAAO,CAAC,MAAM,CAAC,CAAQ;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IAEpD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,WAAW,CAA4B;IAE/C,YACE,YAAY,EAAE,mBAAmB,EACjC,OAAO,EAAE,cAAc,EAsCxB;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,YAAY,CAE/B;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,aAAa,CAEjC;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,cAAc,CAEnC;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,OAAO,CAE1B;IAED;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAsBlC;IAED;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BjC;IAED;;OAEG;YACW,YAAY;IAqF1B;;OAEG;YACW,WAAW;IA2DzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,SAAS;CAYlB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,mBAAmB,EACjC,OAAO,EAAE,cAAc,GACtB,OAAO,CAET"}