@zudojs/core 0.0.1

package/dist/errors/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/core/errors
+ *
+ * Core error types and error handling utilities.
+ */
+export { ErrorCode } from "./errorCode.code.js";
+export type { ErrorCode as ErrorCodeType } from "./errorCode.code.js";
+export { FrameworkError, type FrameworkErrorJSON, } from "./frameworkError.error.js";
+export { InvalidArgumentError, InvalidStateError, ProviderNotFoundError, ProviderAlreadyRegisteredError, ConfigurationNotFoundError, ExecutionContextNotFoundError, AdapterNotFoundError, } from "./exceptions.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,YAAY,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEtE,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,8BAA8B,EAC9B,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/core/errors
+ *
+ * Core error types and error handling utilities.
+ */
+export { ErrorCode } from "./errorCode.code.js";
+export { FrameworkError, } from "./frameworkError.error.js";
+export { InvalidArgumentError, InvalidStateError, ProviderNotFoundError, ProviderAlreadyRegisteredError, ConfigurationNotFoundError, ExecutionContextNotFoundError, AdapterNotFoundError, } from "./exceptions.js";
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIhD,OAAO,EACL,cAAc,GAEf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,8BAA8B,EAC9B,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @zudojs/core
+ *
+ * Core framework primitives and runtime infrastructure.
+ *
+ * Public API
+ * ----------
+ *
+ * contracts
+ * errors
+ * logging
+ * lifecycle
+ * context
+ * configuration
+ * modules
+ * runtime
+ *
+ * Internal implementation details should not be imported directly
+ * by consumers when a public export is available here.
+ */
+export * from "./container/index.js";
+export * from "./contracts/index.js";
+export * from "./errors/index.js";
+export * from "./logging/index.js";
+export * from "./lifecycle/index.js";
+export * from "./context/index.js";
+export * from "./configuration/index.js";
+export * from "./modules/index.js";
+export * from "./runtime/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,cAAc,sBAAsB,CAAC;AAQrC,cAAc,sBAAsB,CAAC;AAQrC,cAAc,mBAAmB,CAAC;AAQlC,cAAc,oBAAoB,CAAC;AAQnC,cAAc,sBAAsB,CAAC;AAQrC,cAAc,oBAAoB,CAAC;AAQnC,cAAc,0BAA0B,CAAC;AAQzC,cAAc,oBAAoB,CAAC;AAQnC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,75 @@
+/**
+ * @zudojs/core
+ *
+ * Core framework primitives and runtime infrastructure.
+ *
+ * Public API
+ * ----------
+ *
+ * contracts
+ * errors
+ * logging
+ * lifecycle
+ * context
+ * configuration
+ * modules
+ * runtime
+ *
+ * Internal implementation details should not be imported directly
+ * by consumers when a public export is available here.
+ */
+/*
+ * ============================================================
+ * Container
+ * ============================================================
+ */
+export * from "./container/index.js";
+/*
+ * ============================================================
+ * Contracts
+ * ============================================================
+ */
+export * from "./contracts/index.js";
+/*
+ * ============================================================
+ * Errors
+ * ============================================================
+ */
+export * from "./errors/index.js";
+/*
+ * ============================================================
+ * Logging
+ * ============================================================
+ */
+export * from "./logging/index.js";
+/*
+ * ============================================================
+ * Lifecycle
+ * ============================================================
+ */
+export * from "./lifecycle/index.js";
+/*
+ * ============================================================
+ * Context
+ * ============================================================
+ */
+export * from "./context/index.js";
+/*
+ * ============================================================
+ * Configuration
+ * ============================================================
+ */
+export * from "./configuration/index.js";
+/*
+ * ============================================================
+ * Modules
+ * ============================================================
+ */
+export * from "./modules/index.js";
+/*
+ * ============================================================
+ * Runtime
+ * ============================================================
+ */
+export * from "./runtime/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AAErC;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AAErC;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC;AAElC;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AAEnC;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AAErC;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AAEnC;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AAEzC;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AAEnC;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/core/lifecycle/core
+ *
+ * Core lifecycle state machine, hooks, and registry.
+ */
+export { LifecycleState, type LifecycleParticipant } from "./lifecycle.js";
+export { hasInitializeHook, hasStartHook, hasStopHook, hasDestroyHook, type OnInitialize, type OnStart, type OnStop, type OnDestroy, type LifecycleHook, } from "./lifecycleHook.hook.js";
+export { LifecycleRegistry, type LifecycleComponent, type LifecycleRegistration, } from "./lifecycleRegistry.registry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,GAC3B,MAAM,iCAAiC,CAAC"}

package/dist/lifecycle/core/index.js

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/core/lifecycle/core
+ *
+ * Core lifecycle state machine, hooks, and registry.
+ */
+export { LifecycleState } from "./lifecycle.js";
+export { hasInitializeHook, hasStartHook, hasStopHook, hasDestroyHook, } from "./lifecycleHook.hook.js";
+export { LifecycleRegistry, } from "./lifecycleRegistry.registry.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lifecycle/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAA6B,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,cAAc,GAMf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,iBAAiB,GAGlB,MAAM,iCAAiC,CAAC"}

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

@@ -0,0 +1,44 @@
+import type { Logger } from "../../logging/core/logger.js";
+/** Lifecycle states supported by the Zudojs application runtime. */
+export declare const LifecycleState: {
+    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 LifecycleState = (typeof LifecycleState)[keyof typeof LifecycleState];
+/** A lifecycle participant can participate in application initialization and shutdown. */
+export interface LifecycleParticipant {
+    readonly name: string;
+    initialize?(): Promise<void> | void;
+    start?(): Promise<void> | void;
+    stop?(): Promise<void> | void;
+    dispose?(): Promise<void> | void;
+}
+/** Options used by the lifecycle manager. */
+export interface LifecycleOptions {
+    readonly logger?: Logger;
+    readonly continueOnShutdownError?: boolean;
+}
+/** Coordinates initialization, startup, shutdown, and disposal of application resources. */
+export declare class Lifecycle {
+    private state;
+    private readonly participants;
+    private readonly logger?;
+    private readonly continueOnShutdownError;
+    constructor(options?: LifecycleOptions);
+    getState(): LifecycleState;
+    getParticipants(): readonly LifecycleParticipant[];
+    register(participant: LifecycleParticipant): void;
+    initialize(): Promise<void>;
+    start(): Promise<void>;
+    private waitForInitialization;
+    stop(): Promise<void>;
+    dispose(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/core/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,oEAAoE;AACpE,eAAO,MAAM,cAAc;aACzB,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,cAAc,GACxB,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEvD,0FAA0F;AAC1F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClC;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC5C;AAED,4FAA4F;AAC5F,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8B;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAU;IAElD,YAAmB,OAAO,GAAE,gBAAqB,EAGhD;IAEM,QAAQ,IAAI,cAAc,CAEhC;IACM,eAAe,IAAI,SAAS,oBAAoB,EAAE,CAExD;IAEM,QAAQ,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAcvD;IAEY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBvC;IAEY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA8BlC;YAEa,qBAAqB;IAetB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAqCjC;IAEY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAsBpC;IAEY,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAoBrC;CACF"}

package/dist/lifecycle/core/lifecycle.js

@@ -0,0 +1,179 @@
+/** Lifecycle states supported by the Zudojs application runtime. */
+export const LifecycleState = {
+    CREATED: "created",
+    INITIALIZING: "initializing",
+    INITIALIZED: "initialized",
+    STARTING: "starting",
+    RUNNING: "running",
+    STOPPING: "stopping",
+    STOPPED: "stopped",
+    FAILED: "failed",
+};
+/** Coordinates initialization, startup, shutdown, and disposal of application resources. */
+export class Lifecycle {
+    state = LifecycleState.CREATED;
+    participants = [];
+    logger;
+    continueOnShutdownError;
+    constructor(options = {}) {
+        this.logger = options.logger;
+        this.continueOnShutdownError = options.continueOnShutdownError ?? true;
+    }
+    getState() {
+        return this.state;
+    }
+    getParticipants() {
+        return [...this.participants];
+    }
+    register(participant) {
+        if (this.state !== LifecycleState.CREATED &&
+            this.state !== LifecycleState.INITIALIZING &&
+            this.state !== LifecycleState.INITIALIZED) {
+            throw new Error(`Cannot register lifecycle participant "${participant.name}" while application is "${this.state}".`);
+        }
+        this.participants.push(participant);
+        this.logger?.debug("Lifecycle participant registered", {
+            participant: participant.name,
+        });
+    }
+    async initialize() {
+        if (this.state === LifecycleState.INITIALIZED)
+            return;
+        if (this.state === LifecycleState.INITIALIZING)
+            return this.waitForInitialization();
+        if (this.state !== LifecycleState.CREATED)
+            throw new Error(`Cannot initialize application while state is "${this.state}".`);
+        this.state = LifecycleState.INITIALIZING;
+        this.logger?.debug("Application initialization started");
+        try {
+            for (const participant of this.participants) {
+                this.logger?.debug("Initializing lifecycle participant", {
+                    participant: participant.name,
+                });
+                await participant.initialize?.();
+            }
+            this.state = LifecycleState.INITIALIZED;
+            this.logger?.info("Application initialization completed");
+        }
+        catch (error) {
+            this.state = LifecycleState.FAILED;
+            this.logger?.error("Application initialization failed", error);
+            throw error;
+        }
+    }
+    async start() {
+        if (this.state === LifecycleState.RUNNING ||
+            this.state === LifecycleState.STARTING)
+            return;
+        if (this.state === LifecycleState.CREATED)
+            await this.initialize();
+        if (this.state === LifecycleState.INITIALIZING)
+            await this.waitForInitialization();
+        if (this.state !== LifecycleState.INITIALIZED)
+            throw new Error(`Cannot start application while state is "${this.state}".`);
+        this.state = LifecycleState.STARTING;
+        this.logger?.debug("Application startup started");
+        try {
+            for (const participant of this.participants) {
+                this.logger?.debug("Starting lifecycle participant", {
+                    participant: participant.name,
+                });
+                await participant.start?.();
+            }
+            this.state = LifecycleState.RUNNING;
+            this.logger?.info("Application startup completed");
+        }
+        catch (error) {
+            this.state = LifecycleState.FAILED;
+            this.logger?.error("Application startup failed", error);
+            throw error;
+        }
+    }
+    async waitForInitialization() {
+        for (let attempt = 0; attempt < 100; attempt++) {
+            if (this.state === LifecycleState.INITIALIZED ||
+                this.state === LifecycleState.FAILED)
+                return;
+            if (this.state !== LifecycleState.INITIALIZING)
+                return;
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+        throw new Error(`Timed out waiting for initialization to complete. Current state: "${this.state}".`);
+    }
+    async stop() {
+        if (this.state === LifecycleState.STOPPED)
+            return;
+        if (this.state !== LifecycleState.RUNNING &&
+            this.state !== LifecycleState.FAILED)
+            throw new Error(`Cannot stop application while state is "${this.state}".`);
+        this.state = LifecycleState.STOPPING;
+        this.logger?.debug("Application shutdown started");
+        const errors = [];
+        for (let i = this.participants.length - 1; i >= 0; i--) {
+            const participant = this.participants[i];
+            try {
+                this.logger?.debug("Stopping lifecycle participant", {
+                    participant: participant.name,
+                });
+                await participant.stop?.();
+            }
+            catch (error) {
+                errors.push(error);
+                this.logger?.error("Failed to stop lifecycle participant", error, {
+                    participant: participant.name,
+                });
+                if (!this.continueOnShutdownError)
+                    break;
+            }
+        }
+        this.state = LifecycleState.STOPPED;
+        this.logger?.info("Application shutdown completed");
+        if (errors.length > 0)
+            throw new AggregateError(errors, "One or more lifecycle participants failed to stop.");
+    }
+    async dispose() {
+        const errors = [];
+        for (let i = this.participants.length - 1; i >= 0; i--) {
+            const participant = this.participants[i];
+            try {
+                this.logger?.debug("Disposing lifecycle participant", {
+                    participant: participant.name,
+                });
+                await participant.dispose?.();
+            }
+            catch (error) {
+                errors.push(error);
+                this.logger?.error("Failed to dispose lifecycle participant", error, {
+                    participant: participant.name,
+                });
+                if (!this.continueOnShutdownError)
+                    break;
+            }
+        }
+        if (errors.length > 0)
+            throw new AggregateError(errors, "One or more lifecycle participants failed to dispose.");
+    }
+    async shutdown() {
+        let stopError;
+        try {
+            await this.stop();
+        }
+        catch (error) {
+            stopError = error;
+        }
+        let disposeError;
+        try {
+            await this.dispose();
+        }
+        catch (error) {
+            disposeError = error;
+        }
+        if (stopError && disposeError)
+            throw new AggregateError([stopError, disposeError], "Application shutdown completed with errors.");
+        if (stopError)
+            throw stopError;
+        if (disposeError)
+            throw disposeError;
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

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

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

package/dist/lifecycle/core/lifecycleHook.hook.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Called when the application is being initialized.
+ *
+ * Use this hook for preparing dependencies, validating configuration,
+ * registering resources, or performing other initialization work.
+ */
+export interface OnInitialize {
+    onInitialize(): Promise<void> | void;
+}
+/**
+ * Called when the application is starting.
+ *
+ * Use this hook for starting active processes such as HTTP servers,
+ * queue consumers, schedulers, workers, or message listeners.
+ */
+export interface OnStart {
+    onStart(): Promise<void> | void;
+}
+/**
+ * Called when the application is stopping.
+ *
+ * Use this hook to stop accepting new work and gracefully terminate
+ * active processes.
+ */
+export interface OnStop {
+    onStop(): Promise<void> | void;
+}
+/**
+ * Called when the application is being destroyed.
+ *
+ * Use this hook for releasing resources such as connections,
+ * file handles, timers, subscriptions, and external clients.
+ */
+export interface OnDestroy {
+    onDestroy(): Promise<void> | void;
+}
+/**
+ * A component that participates in one or more lifecycle phases.
+ *
+ * Components can implement only the hooks they actually need.
+ */
+export type LifecycleHook = Partial<OnInitialize> & Partial<OnStart> & Partial<OnStop> & Partial<OnDestroy>;
+/**
+ * Type guard for initialization hooks.
+ */
+export declare function hasInitializeHook(value: unknown): value is OnInitialize;
+/**
+ * Type guard for start hooks.
+ */
+export declare function hasStartHook(value: unknown): value is OnStart;
+/**
+ * Type guard for stop hooks.
+ */
+export declare function hasStopHook(value: unknown): value is OnStop;
+/**
+ * Type guard for destroy hooks.
+ */
+export declare function hasDestroyHook(value: unknown): value is OnDestroy;
+//# sourceMappingURL=lifecycleHook.hook.d.ts.map

package/dist/lifecycle/core/lifecycleHook.hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleHook.hook.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/core/lifecycleHook.hook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACtC;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,GAC/C,OAAO,CAAC,OAAO,CAAC,GAChB,OAAO,CAAC,MAAM,CAAC,GACf,OAAO,CAAC,SAAS,CAAC,CAAC;AAErB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAOvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAO7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAO3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAOjE"}

package/dist/lifecycle/core/lifecycleHook.hook.js

@@ -0,0 +1,37 @@
+/**
+ * Type guard for initialization hooks.
+ */
+export function hasInitializeHook(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "onInitialize" in value &&
+        typeof value.onInitialize === "function");
+}
+/**
+ * Type guard for start hooks.
+ */
+export function hasStartHook(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "onStart" in value &&
+        typeof value.onStart === "function");
+}
+/**
+ * Type guard for stop hooks.
+ */
+export function hasStopHook(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "onStop" in value &&
+        typeof value.onStop === "function");
+}
+/**
+ * Type guard for destroy hooks.
+ */
+export function hasDestroyHook(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "onDestroy" in value &&
+        typeof value.onDestroy === "function");
+}
+//# sourceMappingURL=lifecycleHook.hook.js.map

package/dist/lifecycle/core/lifecycleHook.hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleHook.hook.js","sourceRoot":"","sources":["../../../src/lifecycle/core/lifecycleHook.hook.ts"],"names":[],"mappings":"AAkDA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,cAAc,IAAI,KAAK;QACvB,OAAO,KAAK,CAAC,YAAY,KAAK,UAAU,CACzC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK;QAClB,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU,CACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,QAAQ,IAAI,KAAK;QACjB,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,CACnC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,WAAW,IAAI,KAAK;QACpB,OAAO,KAAK,CAAC,SAAS,KAAK,UAAU,CACtC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,101 @@
+import type { LifecycleHook } from "./lifecycleHook.hook.js";
+import type { LifecycleParticipant } from "./lifecycle.js";
+/**
+ * Any component that can participate in the application lifecycle.
+ */
+export type LifecycleComponent = LifecycleParticipant | LifecycleHook;
+/**
+ * Internal lifecycle registration.
+ *
+ * The registry stores components in a normalized representation
+ * so the lifecycle manager does not need to care whether a
+ * component uses the full participant API or individual hooks.
+ */
+export interface LifecycleRegistration {
+    /**
+     * Unique registration identifier.
+     */
+    readonly id: string;
+    /**
+     * Human-readable component name.
+     */
+    readonly name: string;
+    /**
+     * Original registered component.
+     */
+    readonly component: LifecycleComponent;
+    /**
+     * Registration order.
+     *
+     * Lower numbers are initialized first and stopped last.
+     */
+    readonly order: number;
+    /**
+     * Whether the component exposes the full lifecycle participant API.
+     */
+    readonly isParticipant: boolean;
+}
+/**
+ * Registry responsible for lifecycle component registration
+ * and deterministic ordering.
+ */
+export declare class LifecycleRegistry {
+    private readonly registrations;
+    private sequence;
+    /**
+     * 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: LifecycleComponent, name?: string): LifecycleRegistration;
+    /**
+     * Unregisters a component by registration ID.
+     */
+    unregister(id: string): boolean;
+    /**
+     * Returns all registrations in initialization/startup order.
+     */
+    getAll(): readonly LifecycleRegistration[];
+    /**
+     * Returns all registrations in shutdown/destruction order.
+     */
+    getReverse(): readonly LifecycleRegistration[];
+    /**
+     * Finds a registration by ID.
+     */
+    getById(id: string): LifecycleRegistration | undefined;
+    /**
+     * Finds a registration by component name.
+     */
+    getByName(name: string): LifecycleRegistration | undefined;
+    /**
+     * Checks whether a component is registered.
+     */
+    has(component: LifecycleComponent): boolean;
+    /**
+     * Returns the number of registered components.
+     */
+    size(): number;
+    /**
+     * Removes all registrations.
+     */
+    clear(): void;
+    /**
+     * Creates a stable registration ID.
+     */
+    private createId;
+    /**
+     * Determines whether a component is a full
+     * LifecycleParticipant.
+     */
+    private isLifecycleParticipant;
+    /**
+     * Resolves a readable component name.
+     */
+    private resolveComponentName;
+}
+//# sourceMappingURL=lifecycleRegistry.registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleRegistry.registry.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/core/lifecycleRegistry.registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,GAAG,aAAa,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IAEvC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;IAE7D,OAAO,CAAC,QAAQ,CAAK;IAErB;;;;;;;;OAQG;IACI,QAAQ,CACb,SAAS,EAAE,kBAAkB,EAC7B,IAAI,CAAC,EAAE,MAAM,GACZ,qBAAqB,CAcvB;IAED;;OAEG;IACI,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAYrC;IAED;;OAEG;IACI,MAAM,IAAI,SAAS,qBAAqB,EAAE,CAEhD;IAED;;OAEG;IACI,UAAU,IAAI,SAAS,qBAAqB,EAAE,CAEpD;IAED;;OAEG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAE5D;IAED;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAIhE;IAED;;OAEG;IACI,GAAG,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAIjD;IAED;;OAEG;IACI,IAAI,IAAI,MAAM,CAEpB;IAED;;OAEG;IACI,KAAK,IAAI,IAAI,CAEnB;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAiB7B"}