@zudojs/core 0.0.1

package/dist/lifecycle/core/lifecycleRegistry.registry.js

@@ -0,0 +1,115 @@
+/**
+ * Registry responsible for lifecycle component registration
+ * and deterministic ordering.
+ */
+export class LifecycleRegistry {
+    registrations = [];
+    sequence = 0;
+    /**
+     * Registers a lifecycle component.
+     *
+     * Components are executed in registration order during
+     * initialization and startup.
+     *
+     * Components are executed in reverse registration order
+     * during stopping and destruction.
+     */
+    register(component, name) {
+        const registration = {
+            id: this.createId(),
+            name: name ?? this.resolveComponentName(component),
+            component,
+            order: this.sequence,
+            isParticipant: this.isLifecycleParticipant(component),
+        };
+        this.sequence += 1;
+        this.registrations.push(registration);
+        return registration;
+    }
+    /**
+     * Unregisters a component by registration ID.
+     */
+    unregister(id) {
+        const index = this.registrations.findIndex((registration) => registration.id === id);
+        if (index === -1) {
+            return false;
+        }
+        this.registrations.splice(index, 1);
+        return true;
+    }
+    /**
+     * Returns all registrations in initialization/startup order.
+     */
+    getAll() {
+        return [...this.registrations].sort((a, b) => a.order - b.order);
+    }
+    /**
+     * Returns all registrations in shutdown/destruction order.
+     */
+    getReverse() {
+        return [...this.registrations].sort((a, b) => b.order - a.order);
+    }
+    /**
+     * Finds a registration by ID.
+     */
+    getById(id) {
+        return this.registrations.find((registration) => registration.id === id);
+    }
+    /**
+     * Finds a registration by component name.
+     */
+    getByName(name) {
+        return this.registrations.find((registration) => registration.name === name);
+    }
+    /**
+     * Checks whether a component is registered.
+     */
+    has(component) {
+        return this.registrations.some((registration) => registration.component === component);
+    }
+    /**
+     * Returns the number of registered components.
+     */
+    size() {
+        return this.registrations.length;
+    }
+    /**
+     * Removes all registrations.
+     */
+    clear() {
+        this.registrations.length = 0;
+    }
+    /**
+     * Creates a stable registration ID.
+     */
+    createId() {
+        return `lifecycle:${this.sequence}`;
+    }
+    /**
+     * Determines whether a component is a full
+     * LifecycleParticipant.
+     */
+    isLifecycleParticipant(component) {
+        return (typeof component === "object" &&
+            component !== null &&
+            "name" in component &&
+            typeof component.name === "string");
+    }
+    /**
+     * Resolves a readable component name.
+     */
+    resolveComponentName(component) {
+        if (this.isLifecycleParticipant(component)) {
+            return component.name;
+        }
+        if (typeof component === "object" &&
+            component !== null &&
+            "constructor" in component &&
+            typeof component.constructor === "function" &&
+            component.constructor.name) {
+            return component.constructor.name;
+        }
+        return "anonymous";
+    }
+}
+//# sourceMappingURL=lifecycleRegistry.registry.js.map

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

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

package/dist/lifecycle/core/lifecycleState.state.d.ts

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

package/dist/lifecycle/core/lifecycleState.state.d.ts.map

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

package/dist/lifecycle/core/lifecycleState.state.js

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

package/dist/lifecycle/core/lifecycleState.state.js.map

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

package/dist/lifecycle/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Core lifecycle state machine and participant contracts.
+ *
+ * Lifecycle is the internal implementation used by LifecycleManager.
+ * Consumers should use LifecycleManager as the primary API.
+ */
+export * from "./core/index.js";
+export * from "./manager/index.js";
+export * from "./scope/index.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;;;;;GAKG;AACH,cAAc,iBAAiB,CAAC;AAEhC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,kBAAkB,CAAC"}

package/dist/lifecycle/index.js

@@ -0,0 +1,10 @@
+/**
+ * Core lifecycle state machine and participant contracts.
+ *
+ * Lifecycle is the internal implementation used by LifecycleManager.
+ * Consumers should use LifecycleManager as the primary API.
+ */
+export * from "./core/index.js";
+export * from "./manager/index.js";
+export * from "./scope/index.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;;;;;GAKG;AACH,cAAc,iBAAiB,CAAC;AAEhC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,kBAAkB,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/core/lifecycle/manager
+ *
+ * Lifecycle orchestration.
+ */
+export { LifecycleManager, type LifecycleManagerOptions, type ManagedLifecycleComponent, } from "./lifecycleManager.manager.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/manager/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,GAC/B,MAAM,+BAA+B,CAAC"}

package/dist/lifecycle/manager/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/core/lifecycle/manager
+ *
+ * Lifecycle orchestration.
+ */
+export { LifecycleManager, } from "./lifecycleManager.manager.js";
+//# sourceMappingURL=index.js.map

package/dist/lifecycle/manager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lifecycle/manager/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,gBAAgB,GAGjB,MAAM,+BAA+B,CAAC"}

package/dist/lifecycle/manager/lifecycleManager.manager.d.ts

@@ -0,0 +1,33 @@
+import type { Logger } from "../../logging/core/logger.js";
+import { type LifecycleHook } from "../core/lifecycleHook.hook.js";
+import { LifecycleState, type LifecycleParticipant } from "../core/lifecycle.js";
+/** Anything that can participate in the managed application lifecycle. */
+export type ManagedLifecycleComponent = LifecycleParticipant | LifecycleHook;
+/** Options for LifecycleManager. */
+export interface LifecycleManagerOptions {
+    readonly logger?: Logger;
+    readonly continueOnShutdownError?: boolean;
+}
+/**
+ * Coordinates lifecycle hooks and lifecycle participants.
+ * Primary API for application-level lifecycle management.
+ */
+export declare class LifecycleManager {
+    private readonly lifecycle;
+    private readonly components;
+    private readonly logger?;
+    private readonly continueOnShutdownError;
+    constructor(options?: LifecycleManagerOptions);
+    getState(): LifecycleState;
+    getComponents(): readonly ManagedLifecycleComponent[];
+    register(component: ManagedLifecycleComponent): void;
+    initialize(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    destroy(): Promise<void>;
+    shutdown(): Promise<void>;
+    private runHook;
+    private isLifecycleParticipant;
+    private getComponentName;
+}
+//# sourceMappingURL=lifecycleManager.manager.d.ts.map

package/dist/lifecycle/manager/lifecycleManager.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleManager.manager.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/manager/lifecycleManager.manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,cAAc,EACd,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAE9B,0EAA0E;AAC1E,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,GAAG,aAAa,CAAC;AAE7E,oCAAoC;AACpC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC5C;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAU;IAElD,YAAmB,OAAO,GAAE,uBAA4B,EAOvD;IAEM,QAAQ,IAAI,cAAc,CAEhC;IACM,aAAa,IAAI,SAAS,yBAAyB,EAAE,CAE3D;IAEM,QAAQ,CAAC,SAAS,EAAE,yBAAyB,GAAG,IAAI,CAI1D;IAEY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAcvC;IAEY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAclC;IAEY,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAwBjC;IAEY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAwBpC;IAEY,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBrC;YAEa,OAAO;IAWrB,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,gBAAgB;CAYzB"}

package/dist/lifecycle/manager/lifecycleManager.manager.js

@@ -0,0 +1,157 @@
+import { hasDestroyHook, hasInitializeHook, hasStartHook, hasStopHook, } from "../core/lifecycleHook.hook.js";
+import { Lifecycle, LifecycleState, } from "../core/lifecycle.js";
+/**
+ * Coordinates lifecycle hooks and lifecycle participants.
+ * Primary API for application-level lifecycle management.
+ */
+export class LifecycleManager {
+    lifecycle;
+    components = [];
+    logger;
+    continueOnShutdownError;
+    constructor(options = {}) {
+        this.logger = options.logger;
+        this.continueOnShutdownError = options.continueOnShutdownError ?? true;
+        this.lifecycle = new Lifecycle({
+            logger: this.logger,
+            continueOnShutdownError: this.continueOnShutdownError,
+        });
+    }
+    getState() {
+        return this.lifecycle.getState();
+    }
+    getComponents() {
+        return [...this.components];
+    }
+    register(component) {
+        this.components.push(component);
+        if (this.isLifecycleParticipant(component))
+            this.lifecycle.register(component);
+    }
+    async initialize() {
+        if (this.getState() !== LifecycleState.CREATED)
+            return;
+        this.logger?.debug("Lifecycle manager initialization started");
+        try {
+            for (const component of this.components) {
+                if (hasInitializeHook(component))
+                    await this.runHook(component, "onInitialize", "initialize");
+            }
+            await this.lifecycle.initialize();
+            this.logger?.debug("Lifecycle manager initialization completed");
+        }
+        catch (error) {
+            this.logger?.error("Lifecycle manager initialization failed", error);
+            throw error;
+        }
+    }
+    async start() {
+        if (this.getState() === LifecycleState.CREATED)
+            await this.initialize();
+        this.logger?.debug("Lifecycle manager startup started");
+        try {
+            for (const component of this.components) {
+                if (hasStartHook(component))
+                    await this.runHook(component, "onStart", "start");
+            }
+            await this.lifecycle.start();
+            this.logger?.debug("Lifecycle manager startup completed");
+        }
+        catch (error) {
+            this.logger?.error("Lifecycle manager startup failed", error);
+            throw error;
+        }
+    }
+    async stop() {
+        const errors = [];
+        this.logger?.debug("Lifecycle manager shutdown started");
+        for (let i = this.components.length - 1; i >= 0; i--) {
+            const component = this.components[i];
+            if (!hasStopHook(component))
+                continue;
+            try {
+                await this.runHook(component, "onStop", "stop");
+            }
+            catch (error) {
+                errors.push(error);
+                if (!this.continueOnShutdownError)
+                    break;
+            }
+        }
+        try {
+            await this.lifecycle.stop();
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        if (errors.length > 0)
+            throw new AggregateError(errors, "Lifecycle shutdown completed with errors.");
+        this.logger?.debug("Lifecycle manager shutdown completed");
+    }
+    async destroy() {
+        const errors = [];
+        this.logger?.debug("Lifecycle manager destruction started");
+        for (let i = this.components.length - 1; i >= 0; i--) {
+            const component = this.components[i];
+            if (!hasDestroyHook(component))
+                continue;
+            try {
+                await this.runHook(component, "onDestroy", "destroy");
+            }
+            catch (error) {
+                errors.push(error);
+                if (!this.continueOnShutdownError)
+                    break;
+            }
+        }
+        try {
+            await this.lifecycle.dispose();
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        if (errors.length > 0)
+            throw new AggregateError(errors, "Lifecycle destruction completed with errors.");
+        this.logger?.debug("Lifecycle manager destruction completed");
+    }
+    async shutdown() {
+        const errors = [];
+        try {
+            await this.stop();
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        try {
+            await this.destroy();
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        if (errors.length > 0)
+            throw new AggregateError(errors, "Application shutdown completed with errors.");
+    }
+    async runHook(component, hook, label) {
+        this.logger?.debug(`Running lifecycle ${label} hook`, {
+            component: this.getComponentName(component),
+        });
+        await component[hook]?.();
+    }
+    isLifecycleParticipant(component) {
+        return (typeof component === "object" &&
+            component !== null &&
+            "name" in component &&
+            typeof component.name === "string");
+    }
+    getComponentName(component) {
+        if ("name" in component && typeof component.name === "string")
+            return component.name;
+        if (typeof component === "object" &&
+            component !== null &&
+            "constructor" in component &&
+            typeof component.constructor === "function")
+            return component.constructor.name;
+        return "anonymous";
+    }
+}
+//# sourceMappingURL=lifecycleManager.manager.js.map

package/dist/lifecycle/manager/lifecycleManager.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleManager.manager.js","sourceRoot":"","sources":["../../../src/lifecycle/manager/lifecycleManager.manager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,WAAW,GAEZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,SAAS,EACT,cAAc,GAEf,MAAM,sBAAsB,CAAC;AAW9B;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACV,SAAS,CAAY;IACrB,UAAU,GAAgC,EAAE,CAAC;IAC7C,MAAM,CAAU;IAChB,uBAAuB,CAAU;IAElD,YAAmB,OAAO,GAA4B,EAAE;QACtD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,IAAI,IAAI,CAAC;QACvE,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;SACtD,CAAC,CAAC;IACL,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;IACM,aAAa;QAClB,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAEM,QAAQ,CAAC,SAAoC;QAClD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC;YACxC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,cAAc,CAAC,OAAO;YAAE,OAAO;QACvD,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC/D,IAAI,CAAC;YACH,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACxC,IAAI,iBAAiB,CAAC,SAAS,CAAC;oBAC9B,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;YAChE,CAAC;YACD,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,4CAA4C,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;YACrE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,cAAc,CAAC,OAAO;YAAE,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACxC,IAAI,YAAY,CAAC,SAAS,CAAC;oBACzB,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;YAC9D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACzD,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACrD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;gBAAE,SAAS;YACtC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,IAAI,CAAC,IAAI,CAAC,uBAAuB;oBAAE,MAAM;YAC3C,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YACnB,MAAM,IAAI,cAAc,CACtB,MAAM,EACN,2CAA2C,CAC5C,CAAC;QACJ,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC7D,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC5D,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACrD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC;gBAAE,SAAS;YACzC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;YACxD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,IAAI,CAAC,IAAI,CAAC,uBAAuB;oBAAE,MAAM;YAC3C,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YACnB,MAAM,IAAI,cAAc,CACtB,MAAM,EACN,8CAA8C,CAC/C,CAAC;QACJ,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAChE,CAAC;IAEM,KAAK,CAAC,QAAQ;QACnB,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YACnB,MAAM,IAAI,cAAc,CACtB,MAAM,EACN,6CAA6C,CAC9C,CAAC;IACN,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,SAAwB,EACxB,IAAyD,EACzD,KAAa;QAEb,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,qBAAqB,KAAK,OAAO,EAAE;YACpD,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC;SAC5C,CAAC,CAAC;QACH,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IAC5B,CAAC;IAEO,sBAAsB,CAC5B,SAAoC;QAEpC,OAAO,CACL,OAAO,SAAS,KAAK,QAAQ;YAC7B,SAAS,KAAK,IAAI;YAClB,MAAM,IAAI,SAAS;YACnB,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,CACnC,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,SAAoC;QAC3D,IAAI,MAAM,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;YAC3D,OAAO,SAAS,CAAC,IAAI,CAAC;QACxB,IACE,OAAO,SAAS,KAAK,QAAQ;YAC7B,SAAS,KAAK,IAAI;YAClB,aAAa,IAAI,SAAS;YAC1B,OAAO,SAAS,CAAC,WAAW,KAAK,UAAU;YAE3C,OAAO,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC;QACpC,OAAO,WAAW,CAAC;IACrB,CAAC;CACF"}

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

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/lifecycle/scope
+ *
+ * Isolated lifecycle boundaries for applications,
+ * modules, plugins, workers, and services.
+ */
+export { LifecycleScope, LifecycleScopeState, type LifecycleScopeOptions, } from "./lifecycleScope.scope.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/scope/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,KAAK,qBAAqB,GAC3B,MAAM,2BAA2B,CAAC"}

package/dist/lifecycle/scope/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/lifecycle/scope
+ *
+ * Isolated lifecycle boundaries for applications,
+ * modules, plugins, workers, and services.
+ */
+export { LifecycleScope, LifecycleScopeState, } from "./lifecycleScope.scope.js";
+//# sourceMappingURL=index.js.map

package/dist/lifecycle/scope/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lifecycle/scope/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,GAEpB,MAAM,2BAA2B,CAAC"}

package/dist/lifecycle/scope/lifecycleScope.scope.d.ts

@@ -0,0 +1,49 @@
+import type { Logger } from "../../logging/core/logger.js";
+import type { LifecycleComponent, LifecycleRegistration } from "../core/lifecycleRegistry.registry.js";
+/** Lifecycle scope state. */
+export declare const LifecycleScopeState: {
+    readonly CREATED: "created";
+    readonly INITIALIZING: "initializing";
+    readonly INITIALIZED: "initialized";
+    readonly STARTING: "starting";
+    readonly RUNNING: "running";
+    readonly STOPPING: "stopping";
+    readonly STOPPED: "stopped";
+    readonly FAILED: "failed";
+};
+export type LifecycleScopeState = (typeof LifecycleScopeState)[keyof typeof LifecycleScopeState];
+/** Options used when creating a lifecycle scope. */
+export interface LifecycleScopeOptions {
+    readonly name: string;
+    readonly parent?: LifecycleScope;
+    readonly logger?: Logger;
+    readonly continueOnShutdownError?: boolean;
+}
+/**
+ * Represents an independently managed lifecycle boundary.
+ * Can represent an Application, Module, Plugin, Worker, Service, or Feature.
+ */
+export declare class LifecycleScope {
+    private state;
+    private readonly name;
+    private readonly parent?;
+    private readonly logger?;
+    private readonly continueOnShutdownError;
+    private readonly registry;
+    private readonly children;
+    constructor(options: LifecycleScopeOptions);
+    getName(): string;
+    getState(): LifecycleScopeState;
+    getParent(): LifecycleScope | undefined;
+    getChildren(): readonly LifecycleScope[];
+    getRegistrations(): readonly LifecycleRegistration[];
+    register(component: LifecycleComponent, name?: string): LifecycleRegistration;
+    unregister(id: string): boolean;
+    initialize(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    destroy(): Promise<void>;
+    shutdown(): Promise<void>;
+    private addChild;
+}
+//# sourceMappingURL=lifecycleScope.scope.d.ts.map

package/dist/lifecycle/scope/lifecycleScope.scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleScope.scope.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/scope/lifecycleScope.scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,uCAAuC,CAAC;AAG/C,6BAA6B;AAC7B,eAAO,MAAM,mBAAmB;aAC9B,OAAO,EAAE,SAAS;aAClB,YAAY,EAAE,cAAc;aAC5B,WAAW,EAAE,aAAa;aAC1B,QAAQ,EAAE,UAAU;aACpB,OAAO,EAAE,SAAS;aAClB,QAAQ,EAAE,UAAU;aACpB,OAAO,EAAE,SAAS;aAClB,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjE,oDAAoD;AACpD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC5C;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAoD;IACjE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAU;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IAEjD,YAAmB,OAAO,EAAE,qBAAqB,EAMhD;IAEM,OAAO,IAAI,MAAM,CAEvB;IACM,QAAQ,IAAI,mBAAmB,CAErC;IACM,SAAS,IAAI,cAAc,GAAG,SAAS,CAE7C;IACM,WAAW,IAAI,SAAS,cAAc,EAAE,CAE9C;IACM,gBAAgB,IAAI,SAAS,qBAAqB,EAAE,CAE1D;IAEM,QAAQ,CACb,SAAS,EAAE,kBAAkB,EAC7B,IAAI,CAAC,EAAE,MAAM,GACZ,qBAAqB,CAUvB;IAEM,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErC;IAEY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAuCvC;IAEY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAiClC;IAEY,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAqDjC;IAEY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA4CpC;IAEY,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBrC;IAED,OAAO,CAAC,QAAQ;CAIjB"}