@scpxl/nodejs-framework 1.0.22 → 1.0.24

package/dist/event/manager.interface.d.ts

@@ -0,0 +1,137 @@
+import type { ApplicationConfig } from '../application/base-application.interface.js';
+import type { RedisInstance } from '../redis/index.js';
+import type { DatabaseInstance } from '../database/index.js';
+import type { EventControllerType } from './controller/base.interface.js';
+export type EventHandler<TPayload = unknown> = (data: TPayload) => Promise<void> | void;
+export interface EventDefinition {
+    name: string;
+    handlerName: string;
+    controllerName?: string;
+    controller?: EventControllerType;
+}
+export interface ApplicationEvents {
+    'application:started': {
+        instanceId: string;
+        timestamp: Date;
+        config: ApplicationConfig;
+    };
+    'application:stopping': {
+        instanceId: string;
+        timestamp: Date;
+        reason?: string;
+    };
+    'application:stopped': {
+        instanceId: string;
+        timestamp: Date;
+        exitCode?: number;
+    };
+    'database:connected': {
+        instanceId: string;
+        timestamp: Date;
+        connectionInfo: {
+            host: string;
+            port: number;
+            database: string;
+        };
+    };
+    'database:disconnected': {
+        instanceId: string;
+        timestamp: Date;
+        reason?: string;
+    };
+    'database:error': {
+        instanceId: string;
+        timestamp: Date;
+        error: Error;
+    };
+    'redis:connected': {
+        instanceId: string;
+        timestamp: Date;
+        connectionInfo: {
+            host: string;
+            port: number;
+        };
+    };
+    'redis:disconnected': {
+        instanceId: string;
+        timestamp: Date;
+        reason?: string;
+    };
+    'redis:error': {
+        instanceId: string;
+        timestamp: Date;
+        error: Error;
+    };
+    'queue:job:added': {
+        instanceId: string;
+        timestamp: Date;
+        queueId: string;
+        jobId: string;
+        data: Record<string, unknown>;
+    };
+    'queue:job:completed': {
+        instanceId: string;
+        timestamp: Date;
+        queueId: string;
+        jobId: string;
+        result?: unknown;
+        processingTime: number;
+    };
+    'queue:job:failed': {
+        instanceId: string;
+        timestamp: Date;
+        queueId: string;
+        jobId: string;
+        error: Error;
+        attemptsMade: number;
+        attemptsRemaining: number;
+    };
+    'websocket:client:connected': {
+        instanceId: string;
+        timestamp: Date;
+        clientId: string;
+        remoteAddress?: string;
+    };
+    'websocket:client:disconnected': {
+        instanceId: string;
+        timestamp: Date;
+        clientId: string;
+        reason?: string;
+    };
+    'websocket:message:received': {
+        instanceId: string;
+        timestamp: Date;
+        clientId: string;
+        messageType: string;
+        action: string;
+        data?: Record<string, unknown>;
+    };
+    'websocket:message:sent': {
+        instanceId: string;
+        timestamp: Date;
+        clientId: string;
+        messageType: string;
+        action: string;
+        data?: Record<string, unknown>;
+    };
+}
+export interface CustomApplicationEvents {
+}
+export type AllApplicationEvents = ApplicationEvents & CustomApplicationEvents;
+export interface EventManagerOptions {
+    controllersDirectory: string;
+    log?: {
+        startUp?: boolean;
+    };
+    debug?: {
+        printEvents?: boolean;
+    };
+}
+export interface EventManagerConstructorParams {
+    applicationConfig: ApplicationConfig;
+    options: EventManagerOptions;
+    events: EventDefinition[];
+    redisInstance: RedisInstance;
+    databaseInstance: DatabaseInstance | null;
+}
+//# sourceMappingURL=manager.interface.d.ts.map

package/dist/event/manager.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.interface.d.ts","sourceRoot":"","sources":["../../src/event/manager.interface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAG1E,MAAM,MAAM,YAAY,CAAC,QAAQ,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAExF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAEhC,qBAAqB,EAAE;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,MAAM,EAAE,iBAAiB,CAAC;KAC3B,CAAC;IACF,sBAAsB,EAAE;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,qBAAqB,EAAE;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAGF,oBAAoB,EAAE;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,cAAc,EAAE;YACd,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC;IACF,uBAAuB,EAAE;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,gBAAgB,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,KAAK,EAAE,KAAK,CAAC;KACd,CAAC;IAGF,iBAAiB,EAAE;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,cAAc,EAAE;YACd,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;IACF,oBAAoB,EAAE;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,KAAK,EAAE,KAAK,CAAC;KACd,CAAC;IAGF,iBAAiB,EAAE;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,CAAC;IACF,qBAAqB,EAAE;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,kBAAkB,EAAE;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,KAAK,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IAGF,4BAA4B,EAAE;QAC5B,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,+BAA+B,EAAE;QAC/B,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,4BAA4B,EAAE;QAC5B,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAAC;IACF,wBAAwB,EAAE;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAAC;CACH;AAID,MAAM,WAAW,uBAAuB;CAAG;AAG3C,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,uBAAuB,CAAC;AAW/E,MAAM,WAAW,mBAAmB;IAClC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,GAAG,CAAC,EAAE;QACJ,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,6BAA6B;IAC5C,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,aAAa,EAAE,aAAa,CAAC;IAE7B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC3C"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+declare const __dirname: string;
+export { __dirname as baseDir };
+export * from './api-requester/index.js';
+export * from './application/index.js';
+export * from './auth/index.js';
+export * from './cache/index.js';
+export * from './command/index.js';
+export * from './config/index.js';
+export * from './database/index.js';
+export * from './error/index.js';
+export * from './event/index.js';
+export * from './lifecycle/index.js';
+export * from './logger/index.js';
+export * from './performance/index.js';
+export * from './queue/index.js';
+export * from './redis/index.js';
+export * from './request-context/index.js';
+export * from './services/index.js';
+export * from './util/index.js';
+export * from './webserver/index.js';
+export * from './websocket/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":"AAIA,QAAA,MAAM,SAAS,QAA2B,CAAC;AAE3C,OAAO,EAAE,SAAS,IAAI,OAAO,EAAE,CAAC;AAEhC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/lifecycle/exit.d.ts

@@ -0,0 +1,11 @@
+export type ExitCode = 0 | 1 | 2 | 130 | 137 | 143;
+export interface ExitOutcome {
+    code: ExitCode;
+    reason: string;
+    error?: unknown;
+}
+type ExitHandler = (outcome: ExitOutcome) => void;
+export declare function setExitHandler(next: ExitHandler): void;
+export declare function requestExit(outcome: ExitOutcome): void;
+export {};
+//# sourceMappingURL=exit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exit.d.ts","sourceRoot":"","sources":["../../src/lifecycle/exit.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;AAMlD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,QAE/C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,QAqB/C"}

package/dist/lifecycle/index.d.ts

@@ -0,0 +1,7 @@
+export { LifecycleManager } from './lifecycle-manager.js';
+export { ShutdownController } from './shutdown-controller.js';
+export { requestExit, setExitHandler } from './exit.js';
+export type { ExitCode, ExitOutcome } from './exit.js';
+export type { Disposable, LifecycleHook, LifecycleConfig } from './types.js';
+export { LifecyclePhase } from './types.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":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGxD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEvD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,66 @@
+import { type Disposable, type LifecycleConfig, type LifecycleHook, LifecyclePhase, type ReadinessCheck, type ReadinessCheckResult } from './types.js';
+export declare class LifecycleManager {
+    private _phase;
+    private config;
+    private initHooks;
+    private startHooks;
+    private readyHooks;
+    private beforeShutdownHooks;
+    private shutdownHooks;
+    private disposables;
+    private intervals;
+    private timeouts;
+    private abortControllers;
+    private readinessChecks;
+    private _isReady;
+    constructor(config?: Partial<LifecycleConfig>);
+    get phase(): LifecyclePhase;
+    get isShuttingDown(): boolean;
+    get isReady(): boolean;
+    onInit(fn: LifecycleHook): () => void;
+    onStart(fn: LifecycleHook): () => void;
+    onReady(fn: LifecycleHook): () => void;
+    onBeforeShutdown(fn: LifecycleHook): () => void;
+    onShutdown(fn: LifecycleHook): () => void;
+    addReadinessCheck(name: string, check: ReadinessCheck): () => void;
+    trackDisposable(disposable: Disposable | {
+        dispose: () => void | Promise<void>;
+    }): Disposable;
+    trackInterval(id: NodeJS.Timeout): NodeJS.Timeout;
+    trackTimeout(id: NodeJS.Timeout): NodeJS.Timeout;
+    /**
+     * Track an AbortController for automatic cleanup on shutdown.
+     * When the lifecycle manager shuts down, it will call abort() on all tracked controllers.
+     * @param controller - The AbortController to track
+     * @returns The same AbortController for chaining
+     */
+    trackAbortController(controller: AbortController): AbortController;
+    /**
+     * Create and track a new AbortController.
+     * Convenience method that creates a new controller and automatically tracks it.
+     * @returns A new tracked AbortController
+     */
+    createAbortController(): AbortController;
+    initialize(): Promise<{
+        errors: unknown[];
+    }>;
+    start(): Promise<{
+        errors: unknown[];
+    }>;
+    ready(): Promise<{
+        errors: unknown[];
+    }>;
+    shutdown(): Promise<{
+        errors: unknown[];
+        timedOut: boolean;
+    }>;
+    private performShutdown;
+    private executeHooks;
+    private waitForReadiness;
+    private executeReadinessChecks;
+    getReadinessStatus(): Promise<{
+        ready: boolean;
+        checks: ReadinessCheckResult[];
+    }>;
+}
+//# sourceMappingURL=lifecycle-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-manager.d.ts","sourceRoot":"","sources":["../../src/lifecycle/lifecycle-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAEpB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,aAAa,CAAuB;IAE5C,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,gBAAgB,CAA8B;IAEtD,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAYjD,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,MAAM,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAQrC,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAQtC,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAQtC,gBAAgB,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAQ/C,UAAU,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAQzC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,IAAI;IAOlE,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG;QAAE,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GAAG,UAAU;IAO7F,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO;IAKjD,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO;IAKhD;;;;;OAKG;IACH,oBAAoB,CAAC,UAAU,EAAE,eAAe,GAAG,eAAe;IAKlE;;;;OAIG;IACH,qBAAqB,IAAI,eAAe;IAKlC,UAAU,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAU5C,KAAK,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAUvC,KAAK,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAkBvC,QAAQ,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;YA2BrD,eAAe;YA4Cf,YAAY;YAYZ,gBAAgB;YAmChB,sBAAsB;IAiC9B,kBAAkB,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;CAKxF"}

package/dist/lifecycle/lifecycle-manager.js

@@ -149,23 +149,18 @@ class LifecycleManager {
     this._phase = LifecyclePhase.STOPPING;
     const timeoutMs = this.config.gracefulShutdown.timeoutMs;
     if (timeoutMs > 0) {
-      let completed = false;
-      let timedOut = false;
-      const shutdownPromise = this.performShutdown().then((result3) => {
-        completed = true;
-        return result3;
-      });
+      const shutdownPromise = this.performShutdown().then((result3) => ({
+        ...result3,
+        timedOut: false
+      }));
       const timeoutPromise = new Promise((resolve) => {
         setTimeout(() => {
-          if (!completed) {
-            timedOut = true;
-            resolve({ errors: ["Shutdown timeout exceeded"] });
-          }
+          resolve({ errors: ["Shutdown timeout exceeded"], timedOut: true });
         }, timeoutMs);
       });
       const result2 = await Promise.race([shutdownPromise, timeoutPromise]);
       this._phase = LifecyclePhase.STOPPED;
-      return { errors: result2.errors, timedOut };
+      return result2;
     }
     const result = await this.performShutdown();
     this._phase = LifecyclePhase.STOPPED;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lifecycle/lifecycle-manager.ts"],
-  "sourcesContent": ["import {\n  type Disposable,\n  type LifecycleConfig,\n  type LifecycleHook,\n  LifecyclePhase,\n  type ReadinessCheck,\n  type ReadinessCheckResult,\n} from './types.js';\n\nexport class LifecycleManager {\n  private _phase: LifecyclePhase = LifecyclePhase.CREATED;\n  private config: LifecycleConfig;\n\n  private initHooks: LifecycleHook[] = [];\n  private startHooks: LifecycleHook[] = [];\n  private readyHooks: LifecycleHook[] = [];\n  private beforeShutdownHooks: LifecycleHook[] = [];\n  private shutdownHooks: LifecycleHook[] = [];\n\n  private disposables = new Set<Disposable>();\n  private intervals = new Set<NodeJS.Timeout>();\n  private timeouts = new Set<NodeJS.Timeout>();\n  private abortControllers = new Set<AbortController>();\n\n  private readinessChecks = new Map<string, ReadinessCheck>();\n  private _isReady = false;\n\n  constructor(config: Partial<LifecycleConfig> = {}) {\n    this.config = {\n      gracefulShutdown: {\n        timeoutMs: config.gracefulShutdown?.timeoutMs ?? 10000,\n      },\n      readiness: {\n        timeoutMs: config.readiness?.timeoutMs ?? 30000,\n        checkIntervalMs: config.readiness?.checkIntervalMs ?? 100,\n      },\n    };\n  }\n\n  get phase(): LifecyclePhase {\n    return this._phase;\n  }\n\n  get isShuttingDown(): boolean {\n    return this._phase === LifecyclePhase.STOPPING || this._phase === LifecyclePhase.STOPPED;\n  }\n\n  get isReady(): boolean {\n    return this._isReady && this._phase === LifecyclePhase.RUNNING;\n  }\n\n  onInit(fn: LifecycleHook): () => void {\n    this.initHooks.push(fn);\n    return () => {\n      const i = this.initHooks.indexOf(fn);\n      if (i >= 0) this.initHooks.splice(i, 1);\n    };\n  }\n\n  onStart(fn: LifecycleHook): () => void {\n    this.startHooks.push(fn);\n    return () => {\n      const i = this.startHooks.indexOf(fn);\n      if (i >= 0) this.startHooks.splice(i, 1);\n    };\n  }\n\n  onReady(fn: LifecycleHook): () => void {\n    this.readyHooks.push(fn);\n    return () => {\n      const i = this.readyHooks.indexOf(fn);\n      if (i >= 0) this.readyHooks.splice(i, 1);\n    };\n  }\n\n  onBeforeShutdown(fn: LifecycleHook): () => void {\n    this.beforeShutdownHooks.push(fn);\n    return () => {\n      const i = this.beforeShutdownHooks.indexOf(fn);\n      if (i >= 0) this.beforeShutdownHooks.splice(i, 1);\n    };\n  }\n\n  onShutdown(fn: LifecycleHook): () => void {\n    this.shutdownHooks.push(fn);\n    return () => {\n      const i = this.shutdownHooks.indexOf(fn);\n      if (i >= 0) this.shutdownHooks.splice(i, 1);\n    };\n  }\n\n  addReadinessCheck(name: string, check: ReadinessCheck): () => void {\n    this.readinessChecks.set(name, check);\n    return () => {\n      this.readinessChecks.delete(name);\n    };\n  }\n\n  trackDisposable(disposable: Disposable | { dispose: () => void | Promise<void> }): Disposable {\n    const d: Disposable =\n      'dispose' in disposable ? { dispose: () => (disposable as { dispose: () => void }).dispose() } : disposable;\n    this.disposables.add(d);\n    return d;\n  }\n\n  trackInterval(id: NodeJS.Timeout): NodeJS.Timeout {\n    this.intervals.add(id);\n    return id;\n  }\n\n  trackTimeout(id: NodeJS.Timeout): NodeJS.Timeout {\n    this.timeouts.add(id);\n    return id;\n  }\n\n  /**\n   * Track an AbortController for automatic cleanup on shutdown.\n   * When the lifecycle manager shuts down, it will call abort() on all tracked controllers.\n   * @param controller - The AbortController to track\n   * @returns The same AbortController for chaining\n   */\n  trackAbortController(controller: AbortController): AbortController {\n    this.abortControllers.add(controller);\n    return controller;\n  }\n\n  /**\n   * Create and track a new AbortController.\n   * Convenience method that creates a new controller and automatically tracks it.\n   * @returns A new tracked AbortController\n   */\n  createAbortController(): AbortController {\n    const controller = new AbortController();\n    return this.trackAbortController(controller);\n  }\n\n  async initialize(): Promise<{ errors: unknown[] }> {\n    if (this._phase !== LifecyclePhase.CREATED) {\n      return { errors: [] };\n    }\n    this._phase = LifecyclePhase.INITIALIZING;\n\n    const errors = await this.executeHooks(this.initHooks, 'init');\n    return { errors };\n  }\n\n  async start(): Promise<{ errors: unknown[] }> {\n    if (this._phase !== LifecyclePhase.INITIALIZING) {\n      return { errors: [] };\n    }\n    this._phase = LifecyclePhase.STARTING;\n\n    const errors = await this.executeHooks(this.startHooks, 'start');\n    return { errors };\n  }\n\n  async ready(): Promise<{ errors: unknown[] }> {\n    if (this._phase !== LifecyclePhase.STARTING) {\n      return { errors: [] };\n    }\n    this._phase = LifecyclePhase.RUNNING;\n\n    const errors = await this.executeHooks(this.readyHooks, 'ready');\n\n    // Wait for readiness checks to pass\n    const readinessResult = await this.waitForReadiness();\n    if (readinessResult.errors.length > 0) {\n      errors.push(...readinessResult.errors);\n    }\n    this._isReady = readinessResult.ready;\n\n    return { errors };\n  }\n\n  async shutdown(): Promise<{ errors: unknown[]; timedOut: boolean }> {\n    if (this.isShuttingDown) {\n      return { errors: [], timedOut: false };\n    }\n    this._phase = LifecyclePhase.STOPPING;\n\n    const timeoutMs = this.config.gracefulShutdown.timeoutMs;\n    if (timeoutMs > 0) {\n      let completed = false;\n      let timedOut = false;\n      const shutdownPromise = this.performShutdown().then(result => {\n        completed = true;\n        return result;\n      });\n      const timeoutPromise = new Promise<{ errors: unknown[] }>(resolve => {\n        setTimeout(() => {\n          if (!completed) {\n            timedOut = true;\n            resolve({ errors: ['Shutdown timeout exceeded'] });\n          }\n        }, timeoutMs);\n      });\n      const result = await Promise.race([shutdownPromise, timeoutPromise]);\n      this._phase = LifecyclePhase.STOPPED;\n      return { errors: result.errors, timedOut };\n    }\n\n    const result = await this.performShutdown();\n    this._phase = LifecyclePhase.STOPPED;\n    return { errors: result.errors, timedOut: false };\n  }\n\n  private async performShutdown(): Promise<{ errors: unknown[] }> {\n    const errors: unknown[] = [];\n\n    // Execute before-shutdown hooks in registration order (FIFO)\n    const beforeShutdownErrors = await this.executeHooks(this.beforeShutdownHooks, 'before-shutdown');\n    errors.push(...beforeShutdownErrors);\n\n    // Abort all tracked AbortControllers\n    for (const controller of this.abortControllers) {\n      try {\n        controller.abort();\n      } catch (e) {\n        errors.push(e);\n      }\n    }\n    this.abortControllers.clear();\n\n    // Clear intervals and timeouts\n    for (const id of this.intervals) {\n      clearInterval(id);\n    }\n    for (const id of this.timeouts) {\n      clearTimeout(id);\n    }\n    this.intervals.clear();\n    this.timeouts.clear();\n\n    // Dispose of tracked disposables\n    for (const disposable of this.disposables) {\n      try {\n        await disposable.dispose();\n      } catch (e) {\n        errors.push(e);\n      }\n    }\n    this.disposables.clear();\n\n    // Execute shutdown hooks in reverse registration order (LIFO)\n    const shutdownErrors = await this.executeHooks([...this.shutdownHooks].reverse(), 'shutdown');\n    errors.push(...shutdownErrors);\n\n    return { errors };\n  }\n\n  private async executeHooks(hooks: LifecycleHook[], _phase: string): Promise<unknown[]> {\n    const errors: unknown[] = [];\n    for (const hook of hooks) {\n      try {\n        await hook();\n      } catch (e) {\n        errors.push(e);\n      }\n    }\n    return errors;\n  }\n\n  private async waitForReadiness(): Promise<{ ready: boolean; errors: unknown[] }> {\n    if (this.readinessChecks.size === 0) {\n      return { ready: true, errors: [] };\n    }\n\n    const timeoutMs = this.config.readiness?.timeoutMs ?? 30000;\n    const checkIntervalMs = this.config.readiness?.checkIntervalMs ?? 100;\n    const startTime = Date.now();\n    const errors: unknown[] = [];\n\n    while (Date.now() - startTime < timeoutMs) {\n      const results = await this.executeReadinessChecks();\n      const allReady = results.every(r => r.ready);\n\n      if (allReady) {\n        return { ready: true, errors };\n      }\n\n      // Collect unique errors from failed checks\n      for (const result of results) {\n        if (!result.ready && result.error) {\n          const errorMessage = result.error.message;\n          if (!errors.some(e => (e as Error)?.message === errorMessage)) {\n            errors.push(result.error);\n          }\n        }\n      }\n\n      // Wait before next check\n      await new Promise(resolve => setTimeout(resolve, checkIntervalMs));\n    }\n\n    return { ready: false, errors: [...errors, new Error('Readiness check timeout exceeded')] };\n  }\n\n  private async executeReadinessChecks(): Promise<ReadinessCheckResult[]> {\n    const checkEntries = Array.from(this.readinessChecks.entries());\n\n    const settledResults = await Promise.allSettled(\n      checkEntries.map(async ([name, check]) => {\n        try {\n          const result = await check();\n          return { name, ready: result };\n        } catch (error) {\n          return { name, ready: false, error: error as Error };\n        }\n      }),\n    );\n\n    return settledResults.map((settledResult, index) => {\n      const checkEntry = checkEntries.at(index);\n      if (!checkEntry) {\n        throw new Error(`Missing check entry at index ${index}`);\n      }\n      const [name] = checkEntry;\n\n      if (settledResult.status === 'fulfilled') {\n        return settledResult.value;\n      }\n\n      return {\n        name,\n        ready: false,\n        error: settledResult.reason as Error,\n      };\n    });\n  }\n\n  async getReadinessStatus(): Promise<{ ready: boolean; checks: ReadinessCheckResult[] }> {\n    const checks = await this.executeReadinessChecks();\n    const ready = this._isReady && this._phase === LifecyclePhase.RUNNING && checks.every(c => c.ready);\n    return { ready, checks };\n  }\n}\n"],
-  "mappings": ";;AAAA;AAAA,EAIE;AAAA,OAGK;AAEA,MAAM,iBAAiB;AAAA,EAT9B,OAS8B;AAAA;AAAA;AAAA,EACpB,SAAyB,eAAe;AAAA,EACxC;AAAA,EAEA,YAA6B,CAAC;AAAA,EAC9B,aAA8B,CAAC;AAAA,EAC/B,aAA8B,CAAC;AAAA,EAC/B,sBAAuC,CAAC;AAAA,EACxC,gBAAiC,CAAC;AAAA,EAElC,cAAc,oBAAI,IAAgB;AAAA,EAClC,YAAY,oBAAI,IAAoB;AAAA,EACpC,WAAW,oBAAI,IAAoB;AAAA,EACnC,mBAAmB,oBAAI,IAAqB;AAAA,EAE5C,kBAAkB,oBAAI,IAA4B;AAAA,EAClD,WAAW;AAAA,EAEnB,YAAY,SAAmC,CAAC,GAAG;AACjD,SAAK,SAAS;AAAA,MACZ,kBAAkB;AAAA,QAChB,WAAW,OAAO,kBAAkB,aAAa;AAAA,MACnD;AAAA,MACA,WAAW;AAAA,QACT,WAAW,OAAO,WAAW,aAAa;AAAA,QAC1C,iBAAiB,OAAO,WAAW,mBAAmB;AAAA,MACxD;AAAA,IACF;AAAA,EACF;AAAA,EAEA,IAAI,QAAwB;AAC1B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,iBAA0B;AAC5B,WAAO,KAAK,WAAW,eAAe,YAAY,KAAK,WAAW,eAAe;AAAA,EACnF;AAAA,EAEA,IAAI,UAAmB;AACrB,WAAO,KAAK,YAAY,KAAK,WAAW,eAAe;AAAA,EACzD;AAAA,EAEA,OAAO,IAA+B;AACpC,SAAK,UAAU,KAAK,EAAE;AACtB,WAAO,MAAM;AACX,YAAM,IAAI,KAAK,UAAU,QAAQ,EAAE;AACnC,UAAI,KAAK,EAAG,MAAK,UAAU,OAAO,GAAG,CAAC;AAAA,IACxC;AAAA,EACF;AAAA,EAEA,QAAQ,IAA+B;AACrC,SAAK,WAAW,KAAK,EAAE;AACvB,WAAO,MAAM;AACX,YAAM,IAAI,KAAK,WAAW,QAAQ,EAAE;AACpC,UAAI,KAAK,EAAG,MAAK,WAAW,OAAO,GAAG,CAAC;AAAA,IACzC;AAAA,EACF;AAAA,EAEA,QAAQ,IAA+B;AACrC,SAAK,WAAW,KAAK,EAAE;AACvB,WAAO,MAAM;AACX,YAAM,IAAI,KAAK,WAAW,QAAQ,EAAE;AACpC,UAAI,KAAK,EAAG,MAAK,WAAW,OAAO,GAAG,CAAC;AAAA,IACzC;AAAA,EACF;AAAA,EAEA,iBAAiB,IAA+B;AAC9C,SAAK,oBAAoB,KAAK,EAAE;AAChC,WAAO,MAAM;AACX,YAAM,IAAI,KAAK,oBAAoB,QAAQ,EAAE;AAC7C,UAAI,KAAK,EAAG,MAAK,oBAAoB,OAAO,GAAG,CAAC;AAAA,IAClD;AAAA,EACF;AAAA,EAEA,WAAW,IAA+B;AACxC,SAAK,cAAc,KAAK,EAAE;AAC1B,WAAO,MAAM;AACX,YAAM,IAAI,KAAK,cAAc,QAAQ,EAAE;AACvC,UAAI,KAAK,EAAG,MAAK,cAAc,OAAO,GAAG,CAAC;AAAA,IAC5C;AAAA,EACF;AAAA,EAEA,kBAAkB,MAAc,OAAmC;AACjE,SAAK,gBAAgB,IAAI,MAAM,KAAK;AACpC,WAAO,MAAM;AACX,WAAK,gBAAgB,OAAO,IAAI;AAAA,IAClC;AAAA,EACF;AAAA,EAEA,gBAAgB,YAA8E;AAC5F,UAAM,IACJ,aAAa,aAAa,EAAE,SAAS,6BAAO,WAAuC,QAAQ,GAAtD,WAAwD,IAAI;AACnG,SAAK,YAAY,IAAI,CAAC;AACtB,WAAO;AAAA,EACT;AAAA,EAEA,cAAc,IAAoC;AAChD,SAAK,UAAU,IAAI,EAAE;AACrB,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,IAAoC;AAC/C,SAAK,SAAS,IAAI,EAAE;AACpB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,qBAAqB,YAA8C;AACjE,SAAK,iBAAiB,IAAI,UAAU;AACpC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,wBAAyC;AACvC,UAAM,aAAa,IAAI,gBAAgB;AACvC,WAAO,KAAK,qBAAqB,UAAU;AAAA,EAC7C;AAAA,EAEA,MAAM,aAA6C;AACjD,QAAI,KAAK,WAAW,eAAe,SAAS;AAC1C,aAAO,EAAE,QAAQ,CAAC,EAAE;AAAA,IACtB;AACA,SAAK,SAAS,eAAe;AAE7B,UAAM,SAAS,MAAM,KAAK,aAAa,KAAK,WAAW,MAAM;AAC7D,WAAO,EAAE,OAAO;AAAA,EAClB;AAAA,EAEA,MAAM,QAAwC;AAC5C,QAAI,KAAK,WAAW,eAAe,cAAc;AAC/C,aAAO,EAAE,QAAQ,CAAC,EAAE;AAAA,IACtB;AACA,SAAK,SAAS,eAAe;AAE7B,UAAM,SAAS,MAAM,KAAK,aAAa,KAAK,YAAY,OAAO;AAC/D,WAAO,EAAE,OAAO;AAAA,EAClB;AAAA,EAEA,MAAM,QAAwC;AAC5C,QAAI,KAAK,WAAW,eAAe,UAAU;AAC3C,aAAO,EAAE,QAAQ,CAAC,EAAE;AAAA,IACtB;AACA,SAAK,SAAS,eAAe;AAE7B,UAAM,SAAS,MAAM,KAAK,aAAa,KAAK,YAAY,OAAO;AAG/D,UAAM,kBAAkB,MAAM,KAAK,iBAAiB;AACpD,QAAI,gBAAgB,OAAO,SAAS,GAAG;AACrC,aAAO,KAAK,GAAG,gBAAgB,MAAM;AAAA,IACvC;AACA,SAAK,WAAW,gBAAgB;AAEhC,WAAO,EAAE,OAAO;AAAA,EAClB;AAAA,EAEA,MAAM,WAA8D;AAClE,QAAI,KAAK,gBAAgB;AACvB,aAAO,EAAE,QAAQ,CAAC,GAAG,UAAU,MAAM;AAAA,IACvC;AACA,SAAK,SAAS,eAAe;AAE7B,UAAM,YAAY,KAAK,OAAO,iBAAiB;AAC/C,QAAI,YAAY,GAAG;AACjB,UAAI,YAAY;AAChB,UAAI,WAAW;AACf,YAAM,kBAAkB,KAAK,gBAAgB,EAAE,KAAK,CAAAA,YAAU;AAC5D,oBAAY;AACZ,eAAOA;AAAA,MACT,CAAC;AACD,YAAM,iBAAiB,IAAI,QAA+B,aAAW;AACnE,mBAAW,MAAM;AACf,cAAI,CAAC,WAAW;AACd,uBAAW;AACX,oBAAQ,EAAE,QAAQ,CAAC,2BAA2B,EAAE,CAAC;AAAA,UACnD;AAAA,QACF,GAAG,SAAS;AAAA,MACd,CAAC;AACD,YAAMA,UAAS,MAAM,QAAQ,KAAK,CAAC,iBAAiB,cAAc,CAAC;AACnE,WAAK,SAAS,eAAe;AAC7B,aAAO,EAAE,QAAQA,QAAO,QAAQ,SAAS;AAAA,IAC3C;AAEA,UAAM,SAAS,MAAM,KAAK,gBAAgB;AAC1C,SAAK,SAAS,eAAe;AAC7B,WAAO,EAAE,QAAQ,OAAO,QAAQ,UAAU,MAAM;AAAA,EAClD;AAAA,EAEA,MAAc,kBAAkD;AAC9D,UAAM,SAAoB,CAAC;AAG3B,UAAM,uBAAuB,MAAM,KAAK,aAAa,KAAK,qBAAqB,iBAAiB;AAChG,WAAO,KAAK,GAAG,oBAAoB;AAGnC,eAAW,cAAc,KAAK,kBAAkB;AAC9C,UAAI;AACF,mBAAW,MAAM;AAAA,MACnB,SAAS,GAAG;AACV,eAAO,KAAK,CAAC;AAAA,MACf;AAAA,IACF;AACA,SAAK,iBAAiB,MAAM;AAG5B,eAAW,MAAM,KAAK,WAAW;AAC/B,oBAAc,EAAE;AAAA,IAClB;AACA,eAAW,MAAM,KAAK,UAAU;AAC9B,mBAAa,EAAE;AAAA,IACjB;AACA,SAAK,UAAU,MAAM;AACrB,SAAK,SAAS,MAAM;AAGpB,eAAW,cAAc,KAAK,aAAa;AACzC,UAAI;AACF,cAAM,WAAW,QAAQ;AAAA,MAC3B,SAAS,GAAG;AACV,eAAO,KAAK,CAAC;AAAA,MACf;AAAA,IACF;AACA,SAAK,YAAY,MAAM;AAGvB,UAAM,iBAAiB,MAAM,KAAK,aAAa,CAAC,GAAG,KAAK,aAAa,EAAE,QAAQ,GAAG,UAAU;AAC5F,WAAO,KAAK,GAAG,cAAc;AAE7B,WAAO,EAAE,OAAO;AAAA,EAClB;AAAA,EAEA,MAAc,aAAa,OAAwB,QAAoC;AACrF,UAAM,SAAoB,CAAC;AAC3B,eAAW,QAAQ,OAAO;AACxB,UAAI;AACF,cAAM,KAAK;AAAA,MACb,SAAS,GAAG;AACV,eAAO,KAAK,CAAC;AAAA,MACf;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,mBAAmE;AAC/E,QAAI,KAAK,gBAAgB,SAAS,GAAG;AACnC,aAAO,EAAE,OAAO,MAAM,QAAQ,CAAC,EAAE;AAAA,IACnC;AAEA,UAAM,YAAY,KAAK,OAAO,WAAW,aAAa;AACtD,UAAM,kBAAkB,KAAK,OAAO,WAAW,mBAAmB;AAClE,UAAM,YAAY,KAAK,IAAI;AAC3B,UAAM,SAAoB,CAAC;AAE3B,WAAO,KAAK,IAAI,IAAI,YAAY,WAAW;AACzC,YAAM,UAAU,MAAM,KAAK,uBAAuB;AAClD,YAAM,WAAW,QAAQ,MAAM,OAAK,EAAE,KAAK;AAE3C,UAAI,UAAU;AACZ,eAAO,EAAE,OAAO,MAAM,OAAO;AAAA,MAC/B;AAGA,iBAAW,UAAU,SAAS;AAC5B,YAAI,CAAC,OAAO,SAAS,OAAO,OAAO;AACjC,gBAAM,eAAe,OAAO,MAAM;AAClC,cAAI,CAAC,OAAO,KAAK,OAAM,GAAa,YAAY,YAAY,GAAG;AAC7D,mBAAO,KAAK,OAAO,KAAK;AAAA,UAC1B;AAAA,QACF;AAAA,MACF;AAGA,YAAM,IAAI,QAAQ,aAAW,WAAW,SAAS,eAAe,CAAC;AAAA,IACnE;AAEA,WAAO,EAAE,OAAO,OAAO,QAAQ,CAAC,GAAG,QAAQ,IAAI,MAAM,kCAAkC,CAAC,EAAE;AAAA,EAC5F;AAAA,EAEA,MAAc,yBAA0D;AACtE,UAAM,eAAe,MAAM,KAAK,KAAK,gBAAgB,QAAQ,CAAC;AAE9D,UAAM,iBAAiB,MAAM,QAAQ;AAAA,MACnC,aAAa,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;AACxC,YAAI;AACF,gBAAM,SAAS,MAAM,MAAM;AAC3B,iBAAO,EAAE,MAAM,OAAO,OAAO;AAAA,QAC/B,SAAS,OAAO;AACd,iBAAO,EAAE,MAAM,OAAO,OAAO,MAAsB;AAAA,QACrD;AAAA,MACF,CAAC;AAAA,IACH;AAEA,WAAO,eAAe,IAAI,CAAC,eAAe,UAAU;AAClD,YAAM,aAAa,aAAa,GAAG,KAAK;AACxC,UAAI,CAAC,YAAY;AACf,cAAM,IAAI,MAAM,gCAAgC,KAAK,EAAE;AAAA,MACzD;AACA,YAAM,CAAC,IAAI,IAAI;AAEf,UAAI,cAAc,WAAW,aAAa;AACxC,eAAO,cAAc;AAAA,MACvB;AAEA,aAAO;AAAA,QACL;AAAA,QACA,OAAO;AAAA,QACP,OAAO,cAAc;AAAA,MACvB;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,qBAAkF;AACtF,UAAM,SAAS,MAAM,KAAK,uBAAuB;AACjD,UAAM,QAAQ,KAAK,YAAY,KAAK,WAAW,eAAe,WAAW,OAAO,MAAM,OAAK,EAAE,KAAK;AAClG,WAAO,EAAE,OAAO,OAAO;AAAA,EACzB;AACF;",
+  "sourcesContent": ["import {\n  type Disposable,\n  type LifecycleConfig,\n  type LifecycleHook,\n  LifecyclePhase,\n  type ReadinessCheck,\n  type ReadinessCheckResult,\n} from './types.js';\n\nexport class LifecycleManager {\n  private _phase: LifecyclePhase = LifecyclePhase.CREATED;\n  private config: LifecycleConfig;\n\n  private initHooks: LifecycleHook[] = [];\n  private startHooks: LifecycleHook[] = [];\n  private readyHooks: LifecycleHook[] = [];\n  private beforeShutdownHooks: LifecycleHook[] = [];\n  private shutdownHooks: LifecycleHook[] = [];\n\n  private disposables = new Set<Disposable>();\n  private intervals = new Set<NodeJS.Timeout>();\n  private timeouts = new Set<NodeJS.Timeout>();\n  private abortControllers = new Set<AbortController>();\n\n  private readinessChecks = new Map<string, ReadinessCheck>();\n  private _isReady = false;\n\n  constructor(config: Partial<LifecycleConfig> = {}) {\n    this.config = {\n      gracefulShutdown: {\n        timeoutMs: config.gracefulShutdown?.timeoutMs ?? 10000,\n      },\n      readiness: {\n        timeoutMs: config.readiness?.timeoutMs ?? 30000,\n        checkIntervalMs: config.readiness?.checkIntervalMs ?? 100,\n      },\n    };\n  }\n\n  get phase(): LifecyclePhase {\n    return this._phase;\n  }\n\n  get isShuttingDown(): boolean {\n    return this._phase === LifecyclePhase.STOPPING || this._phase === LifecyclePhase.STOPPED;\n  }\n\n  get isReady(): boolean {\n    return this._isReady && this._phase === LifecyclePhase.RUNNING;\n  }\n\n  onInit(fn: LifecycleHook): () => void {\n    this.initHooks.push(fn);\n    return () => {\n      const i = this.initHooks.indexOf(fn);\n      if (i >= 0) this.initHooks.splice(i, 1);\n    };\n  }\n\n  onStart(fn: LifecycleHook): () => void {\n    this.startHooks.push(fn);\n    return () => {\n      const i = this.startHooks.indexOf(fn);\n      if (i >= 0) this.startHooks.splice(i, 1);\n    };\n  }\n\n  onReady(fn: LifecycleHook): () => void {\n    this.readyHooks.push(fn);\n    return () => {\n      const i = this.readyHooks.indexOf(fn);\n      if (i >= 0) this.readyHooks.splice(i, 1);\n    };\n  }\n\n  onBeforeShutdown(fn: LifecycleHook): () => void {\n    this.beforeShutdownHooks.push(fn);\n    return () => {\n      const i = this.beforeShutdownHooks.indexOf(fn);\n      if (i >= 0) this.beforeShutdownHooks.splice(i, 1);\n    };\n  }\n\n  onShutdown(fn: LifecycleHook): () => void {\n    this.shutdownHooks.push(fn);\n    return () => {\n      const i = this.shutdownHooks.indexOf(fn);\n      if (i >= 0) this.shutdownHooks.splice(i, 1);\n    };\n  }\n\n  addReadinessCheck(name: string, check: ReadinessCheck): () => void {\n    this.readinessChecks.set(name, check);\n    return () => {\n      this.readinessChecks.delete(name);\n    };\n  }\n\n  trackDisposable(disposable: Disposable | { dispose: () => void | Promise<void> }): Disposable {\n    const d: Disposable =\n      'dispose' in disposable ? { dispose: () => (disposable as { dispose: () => void }).dispose() } : disposable;\n    this.disposables.add(d);\n    return d;\n  }\n\n  trackInterval(id: NodeJS.Timeout): NodeJS.Timeout {\n    this.intervals.add(id);\n    return id;\n  }\n\n  trackTimeout(id: NodeJS.Timeout): NodeJS.Timeout {\n    this.timeouts.add(id);\n    return id;\n  }\n\n  /**\n   * Track an AbortController for automatic cleanup on shutdown.\n   * When the lifecycle manager shuts down, it will call abort() on all tracked controllers.\n   * @param controller - The AbortController to track\n   * @returns The same AbortController for chaining\n   */\n  trackAbortController(controller: AbortController): AbortController {\n    this.abortControllers.add(controller);\n    return controller;\n  }\n\n  /**\n   * Create and track a new AbortController.\n   * Convenience method that creates a new controller and automatically tracks it.\n   * @returns A new tracked AbortController\n   */\n  createAbortController(): AbortController {\n    const controller = new AbortController();\n    return this.trackAbortController(controller);\n  }\n\n  async initialize(): Promise<{ errors: unknown[] }> {\n    if (this._phase !== LifecyclePhase.CREATED) {\n      return { errors: [] };\n    }\n    this._phase = LifecyclePhase.INITIALIZING;\n\n    const errors = await this.executeHooks(this.initHooks, 'init');\n    return { errors };\n  }\n\n  async start(): Promise<{ errors: unknown[] }> {\n    if (this._phase !== LifecyclePhase.INITIALIZING) {\n      return { errors: [] };\n    }\n    this._phase = LifecyclePhase.STARTING;\n\n    const errors = await this.executeHooks(this.startHooks, 'start');\n    return { errors };\n  }\n\n  async ready(): Promise<{ errors: unknown[] }> {\n    if (this._phase !== LifecyclePhase.STARTING) {\n      return { errors: [] };\n    }\n    this._phase = LifecyclePhase.RUNNING;\n\n    const errors = await this.executeHooks(this.readyHooks, 'ready');\n\n    // Wait for readiness checks to pass\n    const readinessResult = await this.waitForReadiness();\n    if (readinessResult.errors.length > 0) {\n      errors.push(...readinessResult.errors);\n    }\n    this._isReady = readinessResult.ready;\n\n    return { errors };\n  }\n\n  async shutdown(): Promise<{ errors: unknown[]; timedOut: boolean }> {\n    if (this.isShuttingDown) {\n      return { errors: [], timedOut: false };\n    }\n    this._phase = LifecyclePhase.STOPPING;\n\n    const timeoutMs = this.config.gracefulShutdown.timeoutMs;\n    if (timeoutMs > 0) {\n      const shutdownPromise = this.performShutdown().then(result => ({\n        ...result,\n        timedOut: false,\n      }));\n      const timeoutPromise = new Promise<{ errors: unknown[]; timedOut: boolean }>(resolve => {\n        setTimeout(() => {\n          resolve({ errors: ['Shutdown timeout exceeded'], timedOut: true });\n        }, timeoutMs);\n      });\n      const result = await Promise.race([shutdownPromise, timeoutPromise]);\n      this._phase = LifecyclePhase.STOPPED;\n      return result;\n    }\n\n    const result = await this.performShutdown();\n    this._phase = LifecyclePhase.STOPPED;\n    return { errors: result.errors, timedOut: false };\n  }\n\n  private async performShutdown(): Promise<{ errors: unknown[] }> {\n    const errors: unknown[] = [];\n\n    // Execute before-shutdown hooks in registration order (FIFO)\n    const beforeShutdownErrors = await this.executeHooks(this.beforeShutdownHooks, 'before-shutdown');\n    errors.push(...beforeShutdownErrors);\n\n    // Abort all tracked AbortControllers\n    for (const controller of this.abortControllers) {\n      try {\n        controller.abort();\n      } catch (e) {\n        errors.push(e);\n      }\n    }\n    this.abortControllers.clear();\n\n    // Clear intervals and timeouts\n    for (const id of this.intervals) {\n      clearInterval(id);\n    }\n    for (const id of this.timeouts) {\n      clearTimeout(id);\n    }\n    this.intervals.clear();\n    this.timeouts.clear();\n\n    // Dispose of tracked disposables\n    for (const disposable of this.disposables) {\n      try {\n        await disposable.dispose();\n      } catch (e) {\n        errors.push(e);\n      }\n    }\n    this.disposables.clear();\n\n    // Execute shutdown hooks in reverse registration order (LIFO)\n    const shutdownErrors = await this.executeHooks([...this.shutdownHooks].reverse(), 'shutdown');\n    errors.push(...shutdownErrors);\n\n    return { errors };\n  }\n\n  private async executeHooks(hooks: LifecycleHook[], _phase: string): Promise<unknown[]> {\n    const errors: unknown[] = [];\n    for (const hook of hooks) {\n      try {\n        await hook();\n      } catch (e) {\n        errors.push(e);\n      }\n    }\n    return errors;\n  }\n\n  private async waitForReadiness(): Promise<{ ready: boolean; errors: unknown[] }> {\n    if (this.readinessChecks.size === 0) {\n      return { ready: true, errors: [] };\n    }\n\n    const timeoutMs = this.config.readiness?.timeoutMs ?? 30000;\n    const checkIntervalMs = this.config.readiness?.checkIntervalMs ?? 100;\n    const startTime = Date.now();\n    const errors: unknown[] = [];\n\n    while (Date.now() - startTime < timeoutMs) {\n      const results = await this.executeReadinessChecks();\n      const allReady = results.every(r => r.ready);\n\n      if (allReady) {\n        return { ready: true, errors };\n      }\n\n      // Collect unique errors from failed checks\n      for (const result of results) {\n        if (!result.ready && result.error) {\n          const errorMessage = result.error.message;\n          if (!errors.some(e => (e as Error)?.message === errorMessage)) {\n            errors.push(result.error);\n          }\n        }\n      }\n\n      // Wait before next check\n      await new Promise(resolve => setTimeout(resolve, checkIntervalMs));\n    }\n\n    return { ready: false, errors: [...errors, new Error('Readiness check timeout exceeded')] };\n  }\n\n  private async executeReadinessChecks(): Promise<ReadinessCheckResult[]> {\n    const checkEntries = Array.from(this.readinessChecks.entries());\n\n    const settledResults = await Promise.allSettled(\n      checkEntries.map(async ([name, check]) => {\n        try {\n          const result = await check();\n          return { name, ready: result };\n        } catch (error) {\n          return { name, ready: false, error: error as Error };\n        }\n      }),\n    );\n\n    return settledResults.map((settledResult, index) => {\n      const checkEntry = checkEntries.at(index);\n      if (!checkEntry) {\n        throw new Error(`Missing check entry at index ${index}`);\n      }\n      const [name] = checkEntry;\n\n      if (settledResult.status === 'fulfilled') {\n        return settledResult.value;\n      }\n\n      return {\n        name,\n        ready: false,\n        error: settledResult.reason as Error,\n      };\n    });\n  }\n\n  async getReadinessStatus(): Promise<{ ready: boolean; checks: ReadinessCheckResult[] }> {\n    const checks = await this.executeReadinessChecks();\n    const ready = this._isReady && this._phase === LifecyclePhase.RUNNING && checks.every(c => c.ready);\n    return { ready, checks };\n  }\n}\n"],
+  "mappings": "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",
   "names": ["result"]
 }

package/dist/lifecycle/shutdown-controller.d.ts

@@ -0,0 +1,15 @@
+import type { LifecycleManager } from './lifecycle-manager.js';
+import type { LifecycleHook } from './types.js';
+export declare class ShutdownController {
+    private lifecycle;
+    private _isShuttingDown;
+    private _hasInitiated;
+    constructor(lifecycle: LifecycleManager);
+    get isShuttingDown(): boolean;
+    register(fn: LifecycleHook): () => void;
+    initiate(_reason: string, _signal?: string): Promise<{
+        errors: unknown[];
+        timedOut: boolean;
+    }>;
+}
+//# sourceMappingURL=shutdown-controller.d.ts.map

package/dist/lifecycle/shutdown-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-controller.d.ts","sourceRoot":"","sources":["../../src/lifecycle/shutdown-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,kBAAkB;IAIjB,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAS;gBAEV,SAAS,EAAE,gBAAgB;IAE/C,IAAI,cAAc,IAAI,OAAO,CAO5B;IAED,QAAQ,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAIjC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAerG"}

package/dist/lifecycle/types.d.ts

@@ -0,0 +1,28 @@
+export interface Disposable {
+    dispose(): Promise<void> | void;
+}
+export declare enum LifecyclePhase {
+    CREATED = "created",
+    INITIALIZING = "initializing",
+    STARTING = "starting",
+    RUNNING = "running",
+    STOPPING = "stopping",
+    STOPPED = "stopped"
+}
+export type LifecycleHook = () => Promise<void> | void;
+export type ReadinessCheck = () => Promise<boolean> | boolean;
+export interface ReadinessCheckResult {
+    name: string;
+    ready: boolean;
+    error?: Error;
+}
+export interface LifecycleConfig {
+    gracefulShutdown: {
+        timeoutMs: number;
+    };
+    readiness?: {
+        timeoutMs?: number;
+        checkIntervalMs?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEvD,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH"}

package/dist/logger/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Logger } from './logger.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/logger/logger.d.ts

@@ -0,0 +1,59 @@
+import type { LogOptions } from '../websocket/utils.js';
+export type LoggerLevels = 'error' | 'warn' | 'info' | 'command' | 'database' | 'redis' | 'webServer' | 'webSocket' | 'queue' | 'queueJob' | 'event' | 'debug';
+export declare class Logger {
+    private static instance;
+    private logger;
+    private environment;
+    isSentryInitialized: boolean;
+    private showRequestIdInConsole;
+    private constructor();
+    static getInstance(): Logger;
+    private getCustomFormat;
+    configure({ showRequestIdInConsole }: {
+        showRequestIdInConsole?: boolean;
+    }): void;
+    initSentry({ sentryDsn, environment }: {
+        sentryDsn: string;
+        environment: string;
+    }): void;
+    log({ level, message, meta, options: _options, }: {
+        level: LoggerLevels;
+        message: unknown;
+        meta?: Record<string, unknown>;
+        options?: LogOptions;
+    }): void;
+    debug({ message, meta, options, }: {
+        message: unknown;
+        meta?: Record<string, unknown>;
+        options?: LogOptions;
+    }): void;
+    debug(message: unknown, meta?: Record<string, unknown>): void;
+    info({ message, meta, options, }: {
+        message: unknown;
+        meta?: Record<string, unknown>;
+        options?: LogOptions;
+    }): void;
+    info(message: unknown, meta?: Record<string, unknown>): void;
+    warn({ message, meta, options, }: {
+        message: unknown;
+        meta?: Record<string, unknown>;
+        options?: LogOptions;
+    }): void;
+    warn(message: unknown, meta?: Record<string, unknown>): void;
+    error(args: {
+        error: Error | unknown;
+        message?: string;
+        meta?: Record<string, unknown>;
+        options?: LogOptions;
+    }): void;
+    error(error: Error | unknown, message?: string, meta?: Record<string, unknown>, options?: LogOptions): void;
+    custom({ level, message, meta, options, }: {
+        level: LoggerLevels;
+        message: unknown;
+        meta?: Record<string, unknown>;
+        options?: LogOptions;
+    }): void;
+}
+declare const _default: Logger;
+export default _default;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger/logger.d.ts.map

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

package/dist/logger/logger.interface.d.ts

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

package/dist/logger/logger.interface.d.ts.map

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

package/dist/logger/logger.js

@@ -13,6 +13,8 @@ class Logger {
   logger;
   environment;
   isSentryInitialized = false;
+  showRequestIdInConsole = true;
+  // Default to true for backward compatibility
   constructor() {
     this.environment = process.env.NODE_ENV;
     const customFormat = this.getCustomFormat();
@@ -72,7 +74,7 @@ class Logger {
   getCustomFormat() {
     return winston.format.printf(({ level, message, timestamp, ...meta }) => {
       const requestId = getRequestId();
-      if (requestId && !meta["requestId"]) {
+      if (requestId && !meta["requestId"] && this.showRequestIdInConsole) {
         meta["requestId"] = requestId;
       }
       if (cluster.isWorker && cluster.worker) {
@@ -110,6 +112,11 @@ class Logger {
       return `[${timestamp}] ${level}: ${message}${metaString ? ` (${metaString})` : ""}`;
     });
   }
+  configure({ showRequestIdInConsole }) {
+    if (showRequestIdInConsole !== void 0) {
+      this.showRequestIdInConsole = showRequestIdInConsole;
+    }
+  }
   initSentry({ sentryDsn, environment }) {
     if (!sentryDsn) {
       this.logger.warn("Missing Sentry DSN when initializing Sentry");