@oyinlola141/lattice-lifecycle 0.1.0

package/README.md

@@ -0,0 +1,19 @@
+# @latticejs/lifecycle
+
+Application and component lifecycle orchestration — state machine, dependency ordering, graceful shutdown, rollback, and signals.
+
+## Installation
+
+```bash
+npm install @latticejs/lifecycle
+```
+
+## Usage
+
+```typescript
+import { /* add usage here */ } from "@latticejs/lifecycle";
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @oyinlola141/lattice-lifecycle
+ *
+ * Application and component lifecycle orchestration for the Lattice framework.
+ *
+ * Manages state machines, dependency ordering, graceful shutdown, rollback,
+ * timeouts, retries, and process signals.
+ *
+ * @example
+ * ```ts
+ * import { createLifecycleManager } from "@oyinlola141/lattice-lifecycle";
+ *
+ * const lifecycle = createLifecycleManager();
+ *
+ * lifecycle.register(database, { id: "database", critical: true });
+ * lifecycle.register(queue, { id: "queue", dependsOn: ["database"] });
+ * lifecycle.register(server, { id: "server", dependsOn: ["queue"] });
+ *
+ * await lifecycle.start();
+ * // ... application running ...
+ * await lifecycle.shutdown();
+ * ```
+ */
+export { LifecycleStateMachine } from "./lifecycleState/index.js";
+export { STARTUP_PHASES, SHUTDOWN_PHASES, getPhaseHookName, getComponentMethod, } from "./lifecyclePhase/index.js";
+export type { LifecycleComponent, LifecycleRegistrationOptions, LifecycleRetryOptions, LifecycleRegistration, } from "./lifecycleComponent/index.js";
+export type { LifecycleContext } from "./lifecycleContext/index.js";
+export { createLifecycleContext } from "./lifecycleContext/index.js";
+export { LifecycleRegistry } from "./lifecycleRegistry/index.js";
+export { DependencyGraph, topologicalSort, reverseTopologicalSort, withTimeout, withAbort, withConcurrency, } from "./lifecycleInternal/index.js";
+export type { TopologicalStage } from "./lifecycleInternal/index.js";
+export { buildExecutionPlan } from "./lifecyclePlan/index.js";
+export type { ExecutionStage, ExecutionPlan } from "./lifecyclePlan/index.js";
+export { LifecycleExecutor } from "./lifecycleExecutor/index.js";
+export type { ExecutionResult } from "./lifecycleExecutor/index.js";
+export { LifecycleManager, createLifecycleManager } from "./lifecycleManager/index.js";
+export type { LifecycleManagerOptions } from "./lifecycleManager/index.js";
+export { LifecycleEventEmitter } from "./lifecycleEvents/index.js";
+export type { LifecycleEventType, LifecycleComponentEvent, LifecycleApplicationEvent, LifecycleEvent, LifecycleEventListener, } from "./lifecycleEvents/index.js";
+export { installSignalHandlers, DEFAULT_SHUTDOWN_SIGNALS, } from "./lifecycleSignal/index.js";
+export type { SignalHandlerOptions } from "./lifecycleSignal/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;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACL,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,kBAAkB,EAClB,4BAA4B,EAC5B,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EACL,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,WAAW,EACX,SAAS,EACT,eAAe,GAChB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACvF,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,cAAc,EACd,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * @latticejs/lifecycle
+ *
+ * Application and component lifecycle orchestration for the Lattice framework.
+ *
+ * Manages state machines, dependency ordering, graceful shutdown, rollback,
+ * timeouts, retries, and process signals.
+ *
+ * @example
+ * ```ts
+ * import { createLifecycleManager } from "@latticejs/lifecycle";
+ *
+ * const lifecycle = createLifecycleManager();
+ *
+ * lifecycle.register(database, { id: "database", critical: true });
+ * lifecycle.register(queue, { id: "queue", dependsOn: ["database"] });
+ * lifecycle.register(server, { id: "server", dependsOn: ["queue"] });
+ *
+ * await lifecycle.start();
+ * // ... application running ...
+ * await lifecycle.shutdown();
+ * ```
+ */
+export { LifecycleStateMachine } from "./lifecycleState/index.js";
+export { STARTUP_PHASES, SHUTDOWN_PHASES, getPhaseHookName, getComponentMethod, } from "./lifecyclePhase/index.js";
+export { createLifecycleContext } from "./lifecycleContext/index.js";
+export { LifecycleRegistry } from "./lifecycleRegistry/index.js";
+export { DependencyGraph, topologicalSort, reverseTopologicalSort, withTimeout, withAbort, withConcurrency, } from "./lifecycleInternal/index.js";
+export { buildExecutionPlan } from "./lifecyclePlan/index.js";
+export { LifecycleExecutor } from "./lifecycleExecutor/index.js";
+export { LifecycleManager, createLifecycleManager } from "./lifecycleManager/index.js";
+export { LifecycleEventEmitter } from "./lifecycleEvents/index.js";
+export { installSignalHandlers, DEFAULT_SHUTDOWN_SIGNALS, } from "./lifecycleSignal/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;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACL,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAQnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EACL,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,WAAW,EACX,SAAS,EACT,eAAe,GAChB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAEvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAQnE,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC"}

package/dist/lifecycleComponent/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @oyinlola141/lattice-lifecycle/component
+ *
+ * Lifecycle component interface and registration types.
+ */
+export type { LifecycleComponent, LifecycleRegistrationOptions, LifecycleRetryOptions, LifecycleRegistration, } from "./lifecycleComponent.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycleComponent/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,kBAAkB,EAClB,4BAA4B,EAC5B,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC"}

package/dist/lifecycleComponent/index.js

@@ -0,0 +1,7 @@
+/**
+ * @latticejs/lifecycle/component
+ *
+ * Lifecycle component interface and registration types.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/lifecycleComponent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycleComponent/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/lifecycleComponent/lifecycleComponent.type.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @oyinlola141/lattice-lifecycle/component
+ *
+ * Lifecycle component interface — the contract for managed resources.
+ */
+import type { LifecycleContext } from "../lifecycleContext/lifecycleContext.type.js";
+/**
+ * Interface for components that participate in the lifecycle.
+ * All hook methods are optional — components only implement what they need.
+ */
+export interface LifecycleComponent {
+    /** Unique name identifying this component. */
+    readonly name: string;
+    /** Initialize the component (prepare configuration, create internal objects). */
+    initialize?(context: LifecycleContext): Promise<void>;
+    /** Start the component (connect to databases, start servers). */
+    start?(context: LifecycleContext): Promise<void>;
+    /** Confirm the component is ready to serve (health check, warm-up). */
+    ready?(context: LifecycleContext): Promise<void>;
+    /** Gracefully stop the component (stop accepting work, drain queues). */
+    stop?(context: LifecycleContext): Promise<void>;
+    /** Final resource cleanup (close connections, clear timers). */
+    dispose?(context: LifecycleContext): Promise<void>;
+}
+/** Options for registering a lifecycle component. */
+export interface LifecycleRegistrationOptions {
+    /** Unique ID for this component. Defaults to component.name. */
+    readonly id?: string;
+    /** IDs of components that must start before this one. */
+    readonly dependsOn?: readonly string[];
+    /** Priority for ordering within the same dependency level. Higher = earlier. */
+    readonly priority?: number;
+    /** If true, application startup fails when this component fails. Defaults to true. */
+    readonly critical?: boolean;
+    /** Timeout in ms for individual component operations. */
+    readonly timeout?: number;
+    /** Retry configuration for failed operations. */
+    readonly retry?: LifecycleRetryOptions;
+}
+/** Retry options for component operations. */
+export interface LifecycleRetryOptions {
+    /** Maximum number of retry attempts. */
+    readonly attempts?: number;
+    /** Delay between retries in ms. */
+    readonly delay?: number;
+    /** Maximum delay between retries in ms. */
+    readonly maxDelay?: number;
+    /** Backoff strategy. */
+    readonly backoff?: "fixed" | "exponential";
+}
+/** A component with its registration metadata. */
+export interface LifecycleRegistration {
+    /** Unique ID. */
+    readonly id: string;
+    /** The component instance. */
+    readonly component: LifecycleComponent;
+    /** IDs of dependencies. */
+    readonly dependsOn: readonly string[];
+    /** Priority within same dependency level. */
+    readonly priority: number;
+    /** Whether failure should abort application startup. */
+    readonly critical: boolean;
+    /** Timeout in ms for individual operations. */
+    readonly timeout: number;
+    /** Retry configuration. */
+    readonly retry: LifecycleRetryOptions;
+}
+//# sourceMappingURL=lifecycleComponent.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleComponent.type.d.ts","sourceRoot":"","sources":["../../src/lifecycleComponent/lifecycleComponent.type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAErF;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iFAAiF;IACjF,UAAU,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,iEAAiE;IACjE,KAAK,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,uEAAuE;IACvE,KAAK,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,yEAAyE;IACzE,IAAI,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,gEAAgE;IAChE,OAAO,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED,qDAAqD;AACrD,MAAM,WAAW,4BAA4B;IAC3C,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAErB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEvC,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAED,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,mCAAmC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,wBAAwB;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;CAC5C;AAED,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,iBAAiB;IACjB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IAEvC,2BAA2B;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAEtC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;CACvC"}

package/dist/lifecycleComponent/lifecycleComponent.type.js

@@ -0,0 +1,7 @@
+/**
+ * @latticejs/lifecycle/component
+ *
+ * Lifecycle component interface — the contract for managed resources.
+ */
+export {};
+//# sourceMappingURL=lifecycleComponent.type.js.map

package/dist/lifecycleComponent/lifecycleComponent.type.js.map

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

package/dist/lifecycleContext/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @oyinlola141/lattice-lifecycle/context
+ *
+ * Lifecycle context type and factory.
+ */
+export type { LifecycleContext } from "./lifecycleContext.type.js";
+export { createLifecycleContext } from "./lifecycleContext.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycleContext/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/lifecycleContext/index.js

@@ -0,0 +1,7 @@
+/**
+ * @latticejs/lifecycle/context
+ *
+ * Lifecycle context type and factory.
+ */
+export { createLifecycleContext } from "./lifecycleContext.type.js";
+//# sourceMappingURL=index.js.map

package/dist/lifecycleContext/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycleContext/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/lifecycleContext/lifecycleContext.type.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @oyinlola141/lattice-lifecycle/context
+ *
+ * Lifecycle context — passed to component hooks during phase execution.
+ */
+import type { LifecyclePhase } from "@oyinlola141/lattice-constants";
+/**
+ * Context passed to lifecycle component hooks.
+ * Provides cancellation, metadata, and phase information.
+ */
+export interface LifecycleContext {
+    /** AbortSignal for cancelling long-running operations. */
+    readonly signal: AbortSignal;
+    /** The current lifecycle phase. */
+    readonly phase: LifecyclePhase;
+    /** Timestamp when the lifecycle started. */
+    readonly startedAt: number;
+    /** Arbitrary metadata for the current operation. */
+    readonly metadata: ReadonlyMap<string, unknown>;
+}
+/** Creates a lifecycle context. */
+export declare function createLifecycleContext(phase: LifecyclePhase, startedAt: number, signal?: AbortSignal, metadata?: Record<string, unknown>): LifecycleContext;
+//# sourceMappingURL=lifecycleContext.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleContext.type.d.ts","sourceRoot":"","sources":["../../src/lifecycleContext/lifecycleContext.type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAE/B,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD;AAED,mCAAmC;AACnC,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,gBAAgB,CAOlB"}

package/dist/lifecycleContext/lifecycleContext.type.js

@@ -0,0 +1,15 @@
+/**
+ * @latticejs/lifecycle/context
+ *
+ * Lifecycle context — passed to component hooks during phase execution.
+ */
+/** Creates a lifecycle context. */
+export function createLifecycleContext(phase, startedAt, signal, metadata) {
+    return {
+        signal: signal ?? new AbortController().signal,
+        phase,
+        startedAt,
+        metadata: new Map(Object.entries(metadata ?? {})),
+    };
+}
+//# sourceMappingURL=lifecycleContext.type.js.map

package/dist/lifecycleContext/lifecycleContext.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleContext.type.js","sourceRoot":"","sources":["../../src/lifecycleContext/lifecycleContext.type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsBH,mCAAmC;AACnC,MAAM,UAAU,sBAAsB,CACpC,KAAqB,EACrB,SAAiB,EACjB,MAAoB,EACpB,QAAkC;IAElC,OAAO;QACL,MAAM,EAAE,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM;QAC9C,KAAK;QACL,SAAS;QACT,QAAQ,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;KAClD,CAAC;AACJ,CAAC"}

package/dist/lifecycleEvents/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @oyinlola141/lattice-lifecycle/events
+ *
+ * Lifecycle event emitter for observability integration.
+ */
+export { LifecycleEventEmitter } from "./lifecycleEvents.core.js";
+export type { LifecycleEventType, LifecycleComponentEvent, LifecycleApplicationEvent, LifecycleEvent, LifecycleEventListener, } from "./lifecycleEvents.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycleEvents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,cAAc,EACd,sBAAsB,GACvB,MAAM,2BAA2B,CAAC"}

package/dist/lifecycleEvents/index.js

@@ -0,0 +1,7 @@
+/**
+ * @latticejs/lifecycle/events
+ *
+ * Lifecycle event emitter for observability integration.
+ */
+export { LifecycleEventEmitter } from "./lifecycleEvents.core.js";
+//# sourceMappingURL=index.js.map

package/dist/lifecycleEvents/index.js.map

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

package/dist/lifecycleEvents/lifecycleEvents.core.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @oyinlola141/lattice-lifecycle/events
+ *
+ * Lifecycle event emitter — emits typed events for observability integration.
+ */
+/** Lifecycle event types. */
+export type LifecycleEventType = "component:registered" | "component:initializing" | "component:initialized" | "component:starting" | "component:started" | "component:ready" | "component:stopping" | "component:stopped" | "component:failed" | "application:initializing" | "application:initialized" | "application:starting" | "application:ready" | "application:stopping" | "application:stopped" | "application:disposed";
+/** Event payload for component events. */
+export interface LifecycleComponentEvent {
+    /** Component ID. */
+    readonly componentId: string;
+    /** Duration in ms (for completion events). */
+    readonly duration?: number;
+    /** Error if the event represents a failure. */
+    readonly error?: unknown;
+}
+/** Event payload for application events. */
+export interface LifecycleApplicationEvent {
+    /** Timestamp. */
+    readonly timestamp: number;
+    /** Duration in ms (for completion events). */
+    readonly duration?: number;
+}
+/** A lifecycle event with its type and payload. */
+export interface LifecycleEvent {
+    /** The event type. */
+    readonly type: LifecycleEventType;
+    /** Component payload (for component events). */
+    readonly component?: LifecycleComponentEvent;
+    /** Duration in ms (for completion events). */
+    readonly duration?: number;
+    /** Error if the event represents a failure. */
+    readonly error?: unknown;
+    /** Timestamp. */
+    readonly timestamp: number;
+}
+/** Event listener function. */
+export type LifecycleEventListener = (event: LifecycleEvent) => void;
+/**
+ * Simple event emitter for lifecycle events.
+ * Integrates with observability without depending on the events package.
+ */
+export declare class LifecycleEventEmitter {
+    private readonly _listeners;
+    /** Subscribes to an event type. */
+    on(type: LifecycleEventType, listener: LifecycleEventListener): () => void;
+    /** Emits an event. */
+    emit(type: LifecycleEventType, data: Omit<LifecycleEvent, "type" | "timestamp">): void;
+    /** Removes all listeners. */
+    clear(): void;
+}
+//# sourceMappingURL=lifecycleEvents.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleEvents.core.d.ts","sourceRoot":"","sources":["../../src/lifecycleEvents/lifecycleEvents.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,6BAA6B;AAC7B,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,wBAAwB,GACxB,uBAAuB,GACvB,oBAAoB,GACpB,mBAAmB,GACnB,iBAAiB,GACjB,oBAAoB,GACpB,mBAAmB,GACnB,kBAAkB,GAClB,0BAA0B,GAC1B,yBAAyB,GACzB,sBAAsB,GACtB,mBAAmB,GACnB,sBAAsB,GACtB,qBAAqB,GACrB,sBAAsB,CAAC;AAE3B,0CAA0C;AAC1C,MAAM,WAAW,uBAAuB;IACtC,oBAAoB;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,4CAA4C;AAC5C,MAAM,WAAW,yBAAyB;IACxC,iBAAiB;IACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,uBAAuB,CAAC;IAC7C,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB;IACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,+BAA+B;AAC/B,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAErE;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8D;IAEzF,mCAAmC;IAC5B,EAAE,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAShF;IAED,sBAAsB;IACf,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,WAAW,CAAC,GAAG,IAAI,CAiB5F;IAED,6BAA6B;IACtB,KAAK,IAAI,IAAI,CAEnB;CACF"}

package/dist/lifecycleEvents/lifecycleEvents.core.js

@@ -0,0 +1,46 @@
+/**
+ * @latticejs/lifecycle/events
+ *
+ * Lifecycle event emitter — emits typed events for observability integration.
+ */
+/**
+ * Simple event emitter for lifecycle events.
+ * Integrates with observability without depending on the events package.
+ */
+export class LifecycleEventEmitter {
+    _listeners = new Map();
+    /** Subscribes to an event type. */
+    on(type, listener) {
+        if (!this._listeners.has(type)) {
+            this._listeners.set(type, new Set());
+        }
+        this._listeners.get(type).add(listener);
+        return () => {
+            this._listeners.get(type)?.delete(listener);
+        };
+    }
+    /** Emits an event. */
+    emit(type, data) {
+        const event = {
+            type,
+            timestamp: Date.now(),
+            ...data,
+        };
+        const listeners = this._listeners.get(type);
+        if (listeners) {
+            for (const listener of listeners) {
+                try {
+                    listener(event);
+                }
+                catch {
+                    // Intentional no-op: event listeners must not crash lifecycle operations.
+                }
+            }
+        }
+    }
+    /** Removes all listeners. */
+    clear() {
+        this._listeners.clear();
+    }
+}
+//# sourceMappingURL=lifecycleEvents.core.js.map

package/dist/lifecycleEvents/lifecycleEvents.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleEvents.core.js","sourceRoot":"","sources":["../../src/lifecycleEvents/lifecycleEvents.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0DH;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACf,UAAU,GAAG,IAAI,GAAG,EAAmD,CAAC;IAEzF,mCAAmC;IAC5B,EAAE,CAAC,IAAwB,EAAE,QAAgC;QAClE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEzC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC;IACJ,CAAC;IAED,sBAAsB;IACf,IAAI,CAAC,IAAwB,EAAE,IAAgD;QACpF,MAAM,KAAK,GAAmB;YAC5B,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG,IAAI;SACR,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;gBAAC,MAAM,CAAC;oBACP,0EAA0E;gBAC5E,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,6BAA6B;IACtB,KAAK;QACV,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/dist/lifecycleExecutor/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @oyinlola141/lattice-lifecycle/executor
+ *
+ * Lifecycle executor — runs component hooks with timeout, retry, and concurrency.
+ */
+export { LifecycleExecutor } from "./lifecycleExecutor.core.js";
+export type { ExecutionResult } from "./lifecycleExecutor.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycleExecutor/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/lifecycleExecutor/index.js

@@ -0,0 +1,7 @@
+/**
+ * @latticejs/lifecycle/executor
+ *
+ * Lifecycle executor — runs component hooks with timeout, retry, and concurrency.
+ */
+export { LifecycleExecutor } from "./lifecycleExecutor.core.js";
+//# sourceMappingURL=index.js.map

package/dist/lifecycleExecutor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycleExecutor/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/lifecycleExecutor/lifecycleExecutor.core.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @oyinlola141/lattice-lifecycle/executor
+ *
+ * Lifecycle executor — runs component hooks with timeout, retry, and error handling.
+ */
+import type { LifecyclePhase } from "@oyinlola141/lattice-constants";
+import type { LifecycleRegistration } from "../lifecycleComponent/lifecycleComponent.type.js";
+import type { LifecycleContext } from "../lifecycleContext/lifecycleContext.type.js";
+/** Result of executing a component hook. */
+export interface ExecutionResult {
+    /** Component ID. */
+    readonly id: string;
+    /** The phase that was executed. */
+    readonly phase: LifecyclePhase;
+    /** Duration in ms. */
+    readonly duration: number;
+    /** Error if the hook failed. */
+    readonly error?: unknown;
+    /** Whether the operation succeeded. */
+    readonly success: boolean;
+}
+/**
+ * Executes lifecycle component hooks with timeout, retry, and concurrency support.
+ */
+export declare class LifecycleExecutor {
+    /**
+     * Executes a single component hook.
+     */
+    execute(registration: LifecycleRegistration, phase: LifecyclePhase, context: LifecycleContext): Promise<ExecutionResult>;
+    /**
+     * Executes a stage of components in parallel with concurrency limit.
+     */
+    executeStage(registrations: readonly LifecycleRegistration[], phase: LifecyclePhase, context: LifecycleContext, concurrency: number): Promise<readonly ExecutionResult[]>;
+}
+//# sourceMappingURL=lifecycleExecutor.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleExecutor.core.d.ts","sourceRoot":"","sources":["../../src/lifecycleExecutor/lifecycleExecutor.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAOrF,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACU,OAAO,CAClB,YAAY,EAAE,qBAAqB,EACnC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CA2D1B;IAED;;OAEG;IACU,YAAY,CACvB,aAAa,EAAE,SAAS,qBAAqB,EAAE,EAC/C,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAarC;CACF"}

package/dist/lifecycleExecutor/lifecycleExecutor.core.js

@@ -0,0 +1,88 @@
+/**
+ * @latticejs/lifecycle/executor
+ *
+ * Lifecycle executor — runs component hooks with timeout, retry, and error handling.
+ */
+import { withTimeout, withConcurrency } from "../lifecycleInternal/index.js";
+import { getComponentMethod } from "../lifecyclePhase/index.js";
+import { LifecycleComponentError, } from "@latticejs/errors";
+/**
+ * Executes lifecycle component hooks with timeout, retry, and concurrency support.
+ */
+export class LifecycleExecutor {
+    /**
+     * Executes a single component hook.
+     */
+    async execute(registration, phase, context) {
+        const methodName = getComponentMethod(phase);
+        const hook = registration.component[methodName];
+        if (typeof hook !== "function") {
+            return {
+                id: registration.id,
+                phase,
+                duration: 0,
+                success: true,
+            };
+        }
+        const startTime = Date.now();
+        let lastError;
+        const retryConfig = registration.retry;
+        const maxAttempts = 1 + (retryConfig.attempts ?? 0);
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            try {
+                await withTimeout(async () => {
+                    const result = hook.call(registration.component, context);
+                    if (result instanceof Promise) {
+                        await result;
+                    }
+                }, registration.timeout, registration.id, phase);
+                return {
+                    id: registration.id,
+                    phase,
+                    duration: Date.now() - startTime,
+                    success: true,
+                };
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < maxAttempts - 1) {
+                    const delay = calculateDelay(retryConfig, attempt);
+                    await sleep(delay);
+                }
+            }
+        }
+        return {
+            id: registration.id,
+            phase,
+            duration: Date.now() - startTime,
+            error: lastError,
+            success: false,
+        };
+    }
+    /**
+     * Executes a stage of components in parallel with concurrency limit.
+     */
+    async executeStage(registrations, phase, context, concurrency) {
+        const results = [];
+        await withConcurrency(registrations, concurrency, async (reg) => {
+            const result = await this.execute(reg, phase, context);
+            results.push(result);
+        });
+        return results;
+    }
+}
+/** Calculates retry delay with backoff. */
+function calculateDelay(config, attempt) {
+    const base = config.delay ?? 500;
+    const max = config.maxDelay ?? 10_000;
+    const backoff = config.backoff ?? "exponential";
+    if (backoff === "exponential") {
+        return Math.min(base * 2 ** attempt, max);
+    }
+    return base;
+}
+/** Sleeps for the given duration. */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=lifecycleExecutor.core.js.map

package/dist/lifecycleExecutor/lifecycleExecutor.core.js.map

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

package/dist/lifecycleInternal/asyncUtils.core.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @oyinlola141/lattice-lifecycle/internal/async-utils
+ *
+ * Async utilities for timeout, abort, and concurrency control.
+ */
+/**
+ * Executes an async operation with a timeout.
+ * Throws LifecycleTimeoutError if the timeout is exceeded.
+ */
+export declare function withTimeout<T>(fn: () => Promise<T>, timeoutMs: number, componentId: string, phase: string): Promise<T>;
+/**
+ * Executes an async operation with abort signal support.
+ */
+export declare function withAbort<T>(fn: (signal: AbortSignal) => Promise<T>, signal: AbortSignal): Promise<T>;
+/**
+ * Executes async operations with a concurrency limit.
+ */
+export declare function withConcurrency<T>(items: readonly T[], concurrency: number, fn: (item: T, index: number) => Promise<void>): Promise<void>;
+//# sourceMappingURL=asyncUtils.core.d.ts.map

package/dist/lifecycleInternal/asyncUtils.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncUtils.core.d.ts","sourceRoot":"","sources":["../../src/lifecycleInternal/asyncUtils.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,CAAC,CAkBZ;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACvC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAkBf"}