@scpxl/nodejs-framework 1.0.22 → 1.0.25

package/dist/error/index.js

@@ -1,5 +1,5 @@
 import { ErrorCode, ErrorSeverity } from "./error.interface.js";
-import { ErrorReporter } from "./error-reporter.js";
+import { ErrorReporter, safeSerializeError } from "./error-reporter.js";
 import {
   FrameworkError,
   ConfigurationError,
@@ -29,6 +29,7 @@ export {
   ValidationError,
   WebServerError,
   WebSocketError,
-  default2 as errorReporter
+  default2 as errorReporter,
+  safeSerializeError
 };
 //# sourceMappingURL=index.js.map

package/dist/error/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/error/index.ts"],
-  "sourcesContent": ["export type { ErrorEnvelope, ErrorReportOptions } from './error.interface.js';\nexport { ErrorCode, ErrorSeverity } from './error.interface.js';\nexport { ErrorReporter } from './error-reporter.js';\nexport {\n  FrameworkError,\n  ConfigurationError,\n  ValidationError,\n  DatabaseError,\n  RedisError,\n  QueueError,\n  WebServerError,\n  WebSocketError,\n  LifecycleError,\n  ResourceNotFoundError,\n  NotImplementedError,\n} from './framework-errors.js';\n\n// Export default instance for convenience\nexport { default as errorReporter } from './error-reporter.js';\n"],
-  "mappings": "AACA,SAAS,WAAW,qBAAqB;AACzC,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAoB,WAAXA,gBAAgC;",
+  "sourcesContent": ["export type { ErrorEnvelope, ErrorReportOptions } from './error.interface.js';\nexport { ErrorCode, ErrorSeverity } from './error.interface.js';\nexport { ErrorReporter, safeSerializeError } from './error-reporter.js';\nexport {\n  FrameworkError,\n  ConfigurationError,\n  ValidationError,\n  DatabaseError,\n  RedisError,\n  QueueError,\n  WebServerError,\n  WebSocketError,\n  LifecycleError,\n  ResourceNotFoundError,\n  NotImplementedError,\n} from './framework-errors.js';\n\n// Export default instance for convenience\nexport { default as errorReporter } from './error-reporter.js';\n"],
+  "mappings": "AACA,SAAS,WAAW,qBAAqB;AACzC,SAAS,eAAe,0BAA0B;AAClD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAoB,WAAXA,gBAAgC;",
   "names": ["default"]
 }

package/dist/event/controller/base.d.ts

@@ -0,0 +1,23 @@
+import type { DatabaseInstance } from '../../database/index.js';
+import type { RedisInstance } from '../../redis/index.js';
+import type { EventControllerConstructorParams } from './base.interface.js';
+import { Logger } from '../../logger/index.js';
+import type { ApplicationConfig } from '../../application/base-application.interface.js';
+export default abstract class BaseEventController {
+    protected logger: typeof Logger;
+    protected workerId: number | undefined;
+    protected applicationConfig: ApplicationConfig;
+    protected redisInstance: RedisInstance;
+    protected databaseInstance: DatabaseInstance | null;
+    constructor({ applicationConfig, redisInstance, databaseInstance }: EventControllerConstructorParams);
+    /**
+     * Enhanced logger with structured methods
+     */
+    log: {
+        error: (error: Error | unknown, message?: string, meta?: Record<string, unknown>) => void;
+        info: (message: string, meta?: Record<string, unknown>) => void;
+        warn: (message: string, meta?: Record<string, unknown>) => void;
+        debug: (message: string, meta?: Record<string, unknown>) => void;
+    };
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/event/controller/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/event/controller/base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAGzF,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,mBAAmB;IAC/C,SAAS,CAAC,MAAM,EAAE,OAAO,MAAM,CAAU;IAEzC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAE/C,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IAEvC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;gBAExC,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,EAAE,gCAAgC;IAUpG;;OAEG;IACI,GAAG;uBACO,KAAK,GAAG,OAAO,YAAY,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;wBAavE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;wBAI7C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;yBAI5C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;MAG9D;CACH"}

package/dist/event/controller/base.interface.d.ts

@@ -0,0 +1,11 @@
+import type { ApplicationConfig } from '../../application/base-application.interface.js';
+import type { DatabaseInstance } from '../../database/index.js';
+import type { RedisInstance } from '../../redis/index.js';
+import type EventBaseController from './base.js';
+export interface EventControllerConstructorParams {
+    applicationConfig: ApplicationConfig;
+    redisInstance: RedisInstance;
+    databaseInstance: DatabaseInstance | null;
+}
+export type EventControllerType = new (params: EventControllerConstructorParams) => EventBaseController;
+//# sourceMappingURL=base.interface.d.ts.map

package/dist/event/controller/base.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.interface.d.ts","sourceRoot":"","sources":["../../../src/event/controller/base.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,mBAAmB,MAAM,WAAW,CAAC;AAEjD,MAAM,WAAW,gCAAgC;IAC/C,iBAAiB,EAAE,iBAAiB,CAAC;IAErC,aAAa,EAAE,aAAa,CAAC;IAE7B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,MAAM,mBAAmB,GAAG,KAAK,MAAM,EAAE,gCAAgC,KAAK,mBAAmB,CAAC"}

package/dist/event/controller/base.js

@@ -2,6 +2,7 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 import cluster from "cluster";
 import { Logger } from "../../logger/index.js";
+import { safeSerializeError } from "../../error/error-reporter.js";
 class BaseEventController {
   static {
     __name(this, "BaseEventController");
@@ -26,7 +27,7 @@ class BaseEventController {
       if (message) {
         const errorMeta = {
           ...meta ?? {},
-          error: error instanceof Error ? error.message : String(error),
+          error: error instanceof Error ? error.message : safeSerializeError(error),
           stack: error instanceof Error ? error.stack : void 0
         };
         this.logger.custom({ level: "event", message, meta: errorMeta });

package/dist/event/controller/base.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/event/controller/base.ts"],
-  "sourcesContent": ["import cluster from 'cluster';\nimport type { DatabaseInstance } from '../../database/index.js';\nimport type { RedisInstance } from '../../redis/index.js';\nimport type { EventControllerConstructorParams } from './base.interface.js';\nimport { Logger } from '../../logger/index.js';\nimport type { ApplicationConfig } from '../../application/base-application.interface.js';\n\nexport default abstract class BaseEventController {\n  protected logger: typeof Logger = Logger;\n\n  protected workerId: number | undefined;\n\n  protected applicationConfig: ApplicationConfig;\n\n  protected redisInstance: RedisInstance;\n  // protected queueManager: QueueManager;\n  protected databaseInstance: DatabaseInstance | null;\n\n  constructor({ applicationConfig, redisInstance, databaseInstance }: EventControllerConstructorParams) {\n    this.workerId = cluster.worker?.id;\n\n    this.applicationConfig = applicationConfig;\n\n    this.redisInstance = redisInstance;\n    // this.queueManager = queueManager;\n    this.databaseInstance = databaseInstance;\n  }\n\n  /**\n   * Enhanced logger with structured methods\n   */\n  public log = {\n    error: (error: Error | unknown, message?: string, meta?: Record<string, unknown>): void => {\n      if (message) {\n        const errorMeta = {\n          ...(meta ?? {}),\n          error: error instanceof Error ? error.message : String(error),\n          stack: error instanceof Error ? error.stack : undefined,\n        };\n        this.logger.custom({ level: 'event', message, meta: errorMeta });\n      } else {\n        this.logger.custom({ level: 'event', message: error });\n      }\n    },\n\n    info: (message: string, meta?: Record<string, unknown>): void => {\n      this.logger.custom({ level: 'event', message, meta });\n    },\n\n    warn: (message: string, meta?: Record<string, unknown>): void => {\n      this.logger.custom({ level: 'event', message, meta });\n    },\n\n    debug: (message: string, meta?: Record<string, unknown>): void => {\n      this.logger.custom({ level: 'event', message, meta });\n    },\n  };\n}\n"],
-  "mappings": ";;AAAA,OAAO,aAAa;AAIpB,SAAS,cAAc;AAGvB,MAAO,oBAA2C;AAAA,EAPlD,OAOkD;AAAA;AAAA;AAAA,EACtC,SAAwB;AAAA,EAExB;AAAA,EAEA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EAEV,YAAY,EAAE,mBAAmB,eAAe,iBAAiB,GAAqC;AACpG,SAAK,WAAW,QAAQ,QAAQ;AAEhC,SAAK,oBAAoB;AAEzB,SAAK,gBAAgB;AAErB,SAAK,mBAAmB;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKO,MAAM;AAAA,IACX,OAAO,wBAAC,OAAwB,SAAkB,SAAyC;AACzF,UAAI,SAAS;AACX,cAAM,YAAY;AAAA,UAChB,GAAI,QAAQ,CAAC;AAAA,UACb,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,UAC5D,OAAO,iBAAiB,QAAQ,MAAM,QAAQ;AAAA,QAChD;AACA,aAAK,OAAO,OAAO,EAAE,OAAO,SAAS,SAAS,MAAM,UAAU,CAAC;AAAA,MACjE,OAAO;AACL,aAAK,OAAO,OAAO,EAAE,OAAO,SAAS,SAAS,MAAM,CAAC;AAAA,MACvD;AAAA,IACF,GAXO;AAAA,IAaP,MAAM,wBAAC,SAAiB,SAAyC;AAC/D,WAAK,OAAO,OAAO,EAAE,OAAO,SAAS,SAAS,KAAK,CAAC;AAAA,IACtD,GAFM;AAAA,IAIN,MAAM,wBAAC,SAAiB,SAAyC;AAC/D,WAAK,OAAO,OAAO,EAAE,OAAO,SAAS,SAAS,KAAK,CAAC;AAAA,IACtD,GAFM;AAAA,IAIN,OAAO,wBAAC,SAAiB,SAAyC;AAChE,WAAK,OAAO,OAAO,EAAE,OAAO,SAAS,SAAS,KAAK,CAAC;AAAA,IACtD,GAFO;AAAA,EAGT;AACF;",
+  "sourcesContent": ["import cluster from 'cluster';\nimport type { DatabaseInstance } from '../../database/index.js';\nimport type { RedisInstance } from '../../redis/index.js';\nimport type { EventControllerConstructorParams } from './base.interface.js';\nimport { Logger } from '../../logger/index.js';\nimport type { ApplicationConfig } from '../../application/base-application.interface.js';\nimport { safeSerializeError } from '../../error/error-reporter.js';\n\nexport default abstract class BaseEventController {\n  protected logger: typeof Logger = Logger;\n\n  protected workerId: number | undefined;\n\n  protected applicationConfig: ApplicationConfig;\n\n  protected redisInstance: RedisInstance;\n  // protected queueManager: QueueManager;\n  protected databaseInstance: DatabaseInstance | null;\n\n  constructor({ applicationConfig, redisInstance, databaseInstance }: EventControllerConstructorParams) {\n    this.workerId = cluster.worker?.id;\n\n    this.applicationConfig = applicationConfig;\n\n    this.redisInstance = redisInstance;\n    // this.queueManager = queueManager;\n    this.databaseInstance = databaseInstance;\n  }\n\n  /**\n   * Enhanced logger with structured methods\n   */\n  public log = {\n    error: (error: Error | unknown, message?: string, meta?: Record<string, unknown>): void => {\n      if (message) {\n        const errorMeta = {\n          ...(meta ?? {}),\n          error: error instanceof Error ? error.message : safeSerializeError(error),\n          stack: error instanceof Error ? error.stack : undefined,\n        };\n        this.logger.custom({ level: 'event', message, meta: errorMeta });\n      } else {\n        this.logger.custom({ level: 'event', message: error });\n      }\n    },\n\n    info: (message: string, meta?: Record<string, unknown>): void => {\n      this.logger.custom({ level: 'event', message, meta });\n    },\n\n    warn: (message: string, meta?: Record<string, unknown>): void => {\n      this.logger.custom({ level: 'event', message, meta });\n    },\n\n    debug: (message: string, meta?: Record<string, unknown>): void => {\n      this.logger.custom({ level: 'event', message, meta });\n    },\n  };\n}\n"],
+  "mappings": ";;AAAA,OAAO,aAAa;AAIpB,SAAS,cAAc;AAEvB,SAAS,0BAA0B;AAEnC,MAAO,oBAA2C;AAAA,EARlD,OAQkD;AAAA;AAAA;AAAA,EACtC,SAAwB;AAAA,EAExB;AAAA,EAEA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EAEV,YAAY,EAAE,mBAAmB,eAAe,iBAAiB,GAAqC;AACpG,SAAK,WAAW,QAAQ,QAAQ;AAEhC,SAAK,oBAAoB;AAEzB,SAAK,gBAAgB;AAErB,SAAK,mBAAmB;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKO,MAAM;AAAA,IACX,OAAO,wBAAC,OAAwB,SAAkB,SAAyC;AACzF,UAAI,SAAS;AACX,cAAM,YAAY;AAAA,UAChB,GAAI,QAAQ,CAAC;AAAA,UACb,OAAO,iBAAiB,QAAQ,MAAM,UAAU,mBAAmB,KAAK;AAAA,UACxE,OAAO,iBAAiB,QAAQ,MAAM,QAAQ;AAAA,QAChD;AACA,aAAK,OAAO,OAAO,EAAE,OAAO,SAAS,SAAS,MAAM,UAAU,CAAC;AAAA,MACjE,OAAO;AACL,aAAK,OAAO,OAAO,EAAE,OAAO,SAAS,SAAS,MAAM,CAAC;AAAA,MACvD;AAAA,IACF,GAXO;AAAA,IAaP,MAAM,wBAAC,SAAiB,SAAyC;AAC/D,WAAK,OAAO,OAAO,EAAE,OAAO,SAAS,SAAS,KAAK,CAAC;AAAA,IACtD,GAFM;AAAA,IAIN,MAAM,wBAAC,SAAiB,SAAyC;AAC/D,WAAK,OAAO,OAAO,EAAE,OAAO,SAAS,SAAS,KAAK,CAAC;AAAA,IACtD,GAFM;AAAA,IAIN,OAAO,wBAAC,SAAiB,SAAyC;AAChE,WAAK,OAAO,OAAO,EAAE,OAAO,SAAS,SAAS,KAAK,CAAC;AAAA,IACtD,GAFO;AAAA,EAGT;AACF;",
   "names": []
 }

package/dist/event/index.d.ts

@@ -0,0 +1,5 @@
+export { default as EventManager } from './manager.js';
+export * from './manager.interface.js';
+export { default as EventBaseController } from './controller/base.js';
+export * from './controller/base.interface.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AACvD,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACtE,cAAc,gCAAgC,CAAC"}

package/dist/event/manager.d.ts

@@ -0,0 +1,21 @@
+import type { EventManagerConstructorParams } from './manager.interface.js';
+export default class EventManager {
+    private logger;
+    private applicationConfig;
+    private options;
+    private events;
+    private redisInstance;
+    private databaseInstance;
+    private eventHandlers;
+    constructor(params: EventManagerConstructorParams);
+    load(): Promise<void>;
+    run<TPayload = unknown>({ name, data }: {
+        name: string;
+        data: TPayload;
+    }): Promise<void>;
+    /**
+     * Log event message
+     */
+    log(message: string, meta?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/event/manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,6BAA6B,EAE9B,MAAM,wBAAwB,CAAC;AAMhC,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,OAAO,CAAC,MAAM,CAAyB;IAEvC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAgB;IAErC,OAAO,CAAC,gBAAgB,CAA0B;IAElD,OAAO,CAAC,aAAa,CAA4B;gBAErC,MAAM,EAAE,6BAA6B;IAqBpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmFrB,GAAG,CAAC,QAAQ,GAAG,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BrG;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlE"}

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/event/manager.js

@@ -88,10 +88,11 @@ class EventManager {
       Events: registeredEvents.length ? registeredEvents : "-"
     });
     if (this.options.debug?.printEvents) {
-      this.log("Registered Events:");
-      for (const eventName of registeredEvents) {
-        console.log(`- ${eventName}`);
-      }
+      this.logger.custom({
+        level: "event",
+        message: `Registered Events:
+${registeredEvents.map((e) => `- ${e}`).join("\n")}`
+      });
     }
   }
   async run({ name, data }) {

package/dist/event/manager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/event/manager.ts"],
-  "sourcesContent": ["// event-manager.ts\nimport { Logger } from '../logger/index.js';\nimport { File, Helper, Loader } from '../util/index.js';\nimport type {\n  EventDefinition,\n  EventHandler,\n  EventManagerConstructorParams,\n  EventManagerOptions,\n} from './manager.interface.js';\nimport type { ApplicationConfig } from '../application/base-application.interface.js';\nimport type DatabaseInstance from '../database/instance.js';\nimport type { RedisInstance } from '../redis/index.js';\nimport type { EventControllerType } from './controller/base.interface.js';\n\nexport default class EventManager {\n  private logger: typeof Logger = Logger;\n\n  private applicationConfig: ApplicationConfig;\n  private options: EventManagerOptions;\n  private events: EventDefinition[];\n  private redisInstance: RedisInstance;\n  // private queueManager: QueueManager;\n  private databaseInstance: DatabaseInstance | null;\n\n  private eventHandlers: Map<string, EventHandler>;\n\n  constructor(params: EventManagerConstructorParams) {\n    const defaultOptions: Partial<EventManagerOptions> = {\n      log: {\n        startUp: true,\n      },\n      debug: {\n        printEvents: false,\n      },\n    };\n\n    this.options = Helper.defaultsDeep(params.options, defaultOptions);\n\n    this.applicationConfig = params.applicationConfig;\n    this.events = params.events;\n    this.redisInstance = params.redisInstance;\n    // this.queueManager = params.queueManager;\n    this.databaseInstance = params.databaseInstance;\n\n    this.eventHandlers = new Map();\n  }\n\n  public async load(): Promise<void> {\n    // Check if controllers directory exists\n    const controllersDirectoryExists = await File.pathExists(this.options.controllersDirectory);\n\n    if (!controllersDirectoryExists) {\n      return;\n    }\n\n    // Load controllers\n    const controllers = await Loader.loadModulesInDirectory({\n      directory: this.options.controllersDirectory,\n      extensions: ['.ts', '.js'],\n    });\n\n    // Load event handlers\n    for (const event of this.events) {\n      let ControllerClass: EventControllerType;\n      let controllerName: string;\n\n      if (event.controller) {\n        ControllerClass = event.controller;\n        controllerName = ControllerClass.name;\n      } else if (event.controllerName) {\n        ControllerClass = controllers[event.controllerName] as EventControllerType;\n        controllerName = event.controllerName;\n      } else {\n        throw new Error('Event controller not specified');\n      }\n\n      if (typeof ControllerClass !== 'function') {\n        const controllerPath = `${this.options.controllersDirectory}/${event.controllerName}.ts`;\n        this.logger.warn({\n          message: 'Event controller not found',\n          meta: {\n            Controller: event.controllerName,\n            Path: controllerPath,\n            Event: event.name,\n          },\n        });\n        continue;\n      }\n\n      // Initialize controller instance\n      const controllerInstance = new ControllerClass({\n        applicationConfig: this.applicationConfig,\n        redisInstance: this.redisInstance,\n        // queueManager: this.queueManager,\n        databaseInstance: this.databaseInstance,\n      });\n\n      const handler = controllerInstance[event.handlerName as keyof typeof controllerInstance];\n\n      if (!handler || typeof handler !== 'function') {\n        this.logger.warn({\n          message: 'Event handler not found',\n          meta: {\n            Controller: controllerName,\n            Handler: event.handlerName,\n            Event: event.name,\n          },\n        });\n        continue;\n      }\n\n      // Store the handler\n      this.eventHandlers.set(event.name, (handler as EventHandler).bind(controllerInstance));\n    }\n\n    // Log the list of registered events\n    const registeredEvents = Array.from(this.eventHandlers.keys());\n\n    this.log('Registered Events:', {\n      Events: registeredEvents.length ? registeredEvents : '-',\n    });\n\n    if (this.options.debug?.printEvents) {\n      this.log('Registered Events:');\n\n      for (const eventName of registeredEvents) {\n        console.log(`- ${eventName}`);\n      }\n    }\n  }\n\n  public async run<TPayload = unknown>({ name, data }: { name: string; data: TPayload }): Promise<void> {\n    try {\n      const handler = this.eventHandlers.get(name);\n\n      if (!handler) {\n        const availableEvents = Array.from(this.eventHandlers.keys()).join(', ');\n\n        this.logger.warn({\n          message: 'Event handler not found for event',\n          meta: {\n            Event: name,\n            AvailableEvents: availableEvents,\n          },\n        });\n\n        throw new Error(`Event handler not found for event '${name}'. Available events are: ${availableEvents}`);\n      }\n\n      await handler(data);\n\n      this.log('Event executed', { Event: name });\n    } catch (error) {\n      this.logger.error({ error });\n    }\n  }\n\n  /**\n   * Log event message\n   */\n  public log(message: string, meta?: Record<string, unknown>): void {\n    this.logger.custom({ level: 'event', message, meta });\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["// event-manager.ts\nimport { Logger } from '../logger/index.js';\nimport { File, Helper, Loader } from '../util/index.js';\nimport type {\n  EventDefinition,\n  EventHandler,\n  EventManagerConstructorParams,\n  EventManagerOptions,\n} from './manager.interface.js';\nimport type { ApplicationConfig } from '../application/base-application.interface.js';\nimport type DatabaseInstance from '../database/instance.js';\nimport type { RedisInstance } from '../redis/index.js';\nimport type { EventControllerType } from './controller/base.interface.js';\n\nexport default class EventManager {\n  private logger: typeof Logger = Logger;\n\n  private applicationConfig: ApplicationConfig;\n  private options: EventManagerOptions;\n  private events: EventDefinition[];\n  private redisInstance: RedisInstance;\n  // private queueManager: QueueManager;\n  private databaseInstance: DatabaseInstance | null;\n\n  private eventHandlers: Map<string, EventHandler>;\n\n  constructor(params: EventManagerConstructorParams) {\n    const defaultOptions: Partial<EventManagerOptions> = {\n      log: {\n        startUp: true,\n      },\n      debug: {\n        printEvents: false,\n      },\n    };\n\n    this.options = Helper.defaultsDeep(params.options, defaultOptions);\n\n    this.applicationConfig = params.applicationConfig;\n    this.events = params.events;\n    this.redisInstance = params.redisInstance;\n    // this.queueManager = params.queueManager;\n    this.databaseInstance = params.databaseInstance;\n\n    this.eventHandlers = new Map();\n  }\n\n  public async load(): Promise<void> {\n    // Check if controllers directory exists\n    const controllersDirectoryExists = await File.pathExists(this.options.controllersDirectory);\n\n    if (!controllersDirectoryExists) {\n      return;\n    }\n\n    // Load controllers\n    const controllers = await Loader.loadModulesInDirectory({\n      directory: this.options.controllersDirectory,\n      extensions: ['.ts', '.js'],\n    });\n\n    // Load event handlers\n    for (const event of this.events) {\n      let ControllerClass: EventControllerType;\n      let controllerName: string;\n\n      if (event.controller) {\n        ControllerClass = event.controller;\n        controllerName = ControllerClass.name;\n      } else if (event.controllerName) {\n        ControllerClass = controllers[event.controllerName] as EventControllerType;\n        controllerName = event.controllerName;\n      } else {\n        throw new Error('Event controller not specified');\n      }\n\n      if (typeof ControllerClass !== 'function') {\n        const controllerPath = `${this.options.controllersDirectory}/${event.controllerName}.ts`;\n        this.logger.warn({\n          message: 'Event controller not found',\n          meta: {\n            Controller: event.controllerName,\n            Path: controllerPath,\n            Event: event.name,\n          },\n        });\n        continue;\n      }\n\n      // Initialize controller instance\n      const controllerInstance = new ControllerClass({\n        applicationConfig: this.applicationConfig,\n        redisInstance: this.redisInstance,\n        // queueManager: this.queueManager,\n        databaseInstance: this.databaseInstance,\n      });\n\n      const handler = controllerInstance[event.handlerName as keyof typeof controllerInstance];\n\n      if (!handler || typeof handler !== 'function') {\n        this.logger.warn({\n          message: 'Event handler not found',\n          meta: {\n            Controller: controllerName,\n            Handler: event.handlerName,\n            Event: event.name,\n          },\n        });\n        continue;\n      }\n\n      // Store the handler\n      this.eventHandlers.set(event.name, (handler as EventHandler).bind(controllerInstance));\n    }\n\n    // Log the list of registered events\n    const registeredEvents = Array.from(this.eventHandlers.keys());\n\n    this.log('Registered Events:', {\n      Events: registeredEvents.length ? registeredEvents : '-',\n    });\n\n    if (this.options.debug?.printEvents) {\n      this.logger.custom({\n        level: 'event',\n        message: `Registered Events:\\n${registeredEvents.map(e => `- ${e}`).join('\\n')}`,\n      });\n    }\n  }\n\n  public async run<TPayload = unknown>({ name, data }: { name: string; data: TPayload }): Promise<void> {\n    try {\n      const handler = this.eventHandlers.get(name);\n\n      if (!handler) {\n        const availableEvents = Array.from(this.eventHandlers.keys()).join(', ');\n\n        this.logger.warn({\n          message: 'Event handler not found for event',\n          meta: {\n            Event: name,\n            AvailableEvents: availableEvents,\n          },\n        });\n\n        throw new Error(`Event handler not found for event '${name}'. Available events are: ${availableEvents}`);\n      }\n\n      await handler(data);\n\n      this.log('Event executed', { Event: name });\n    } catch (error) {\n      this.logger.error({ error });\n    }\n  }\n\n  /**\n   * Log event message\n   */\n  public log(message: string, meta?: Record<string, unknown>): void {\n    this.logger.custom({ level: 'event', message, meta });\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

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,QAuB/C"}

package/dist/lifecycle/exit.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lifecycle/exit.ts"],
-  "sourcesContent": ["export type ExitCode = 0 | 1 | 2 | 130 | 137 | 143;\n\nexport interface ExitOutcome {\n  code: ExitCode;\n  reason: string;\n  error?: unknown;\n}\n\ntype ExitHandler = (outcome: ExitOutcome) => void;\n\nlet handler: ExitHandler = outcome => {\n  process.exit(outcome.code);\n};\n\nexport function setExitHandler(next: ExitHandler) {\n  handler = next;\n}\n\nexport function requestExit(outcome: ExitOutcome) {\n  const nodeEnv = process.env.NODE_ENV ?? '';\n  const isTestEnv =\n    nodeEnv.toLowerCase() === 'test' ||\n    'VITEST' in process.env ||\n    'VITEST_WORKER_ID' in process.env ||\n    process.argv.some(a => a.includes('vitest')) ||\n    typeof (globalThis as any).afterAll === 'function';\n\n  if (isTestEnv) {\n    // Suppress real process exit during tests; vitest intercepts and would throw otherwise.\n    console.info(`[exit] (test env) code=${outcome.code} reason=${outcome.reason}`);\n    return;\n  }\n\n  try {\n    handler(outcome);\n  } catch (err) {\n    console.error('Exit handler failure', err);\n    process.exit(outcome.code);\n  }\n}\n"],
-  "mappings": ";;AAUA,IAAI,UAAuB,oCAAW;AACpC,UAAQ,KAAK,QAAQ,IAAI;AAC3B,GAF2B;AAIpB,SAAS,eAAe,MAAmB;AAChD,YAAU;AACZ;AAFgB;AAIT,SAAS,YAAY,SAAsB;AAChD,QAAM,UAAU,QAAQ,IAAI,YAAY;AACxC,QAAM,YACJ,QAAQ,YAAY,MAAM,UAC1B,YAAY,QAAQ,OACpB,sBAAsB,QAAQ,OAC9B,QAAQ,KAAK,KAAK,OAAK,EAAE,SAAS,QAAQ,CAAC,KAC3C,OAAQ,WAAmB,aAAa;AAE1C,MAAI,WAAW;AAEb,YAAQ,KAAK,0BAA0B,QAAQ,IAAI,WAAW,QAAQ,MAAM,EAAE;AAC9E;AAAA,EACF;AAEA,MAAI;AACF,YAAQ,OAAO;AAAA,EACjB,SAAS,KAAK;AACZ,YAAQ,MAAM,wBAAwB,GAAG;AACzC,YAAQ,KAAK,QAAQ,IAAI;AAAA,EAC3B;AACF;AArBgB;",
+  "sourcesContent": ["export type ExitCode = 0 | 1 | 2 | 130 | 137 | 143;\n\nexport interface ExitOutcome {\n  code: ExitCode;\n  reason: string;\n  error?: unknown;\n}\n\ntype ExitHandler = (outcome: ExitOutcome) => void;\n\nlet handler: ExitHandler = outcome => {\n  process.exit(outcome.code);\n};\n\nexport function setExitHandler(next: ExitHandler) {\n  handler = next;\n}\n\nexport function requestExit(outcome: ExitOutcome) {\n  const nodeEnv = process.env.NODE_ENV ?? '';\n  const isTestEnv =\n    nodeEnv.toLowerCase() === 'test' ||\n    'VITEST' in process.env ||\n    'VITEST_WORKER_ID' in process.env ||\n    process.argv.some(a => a.includes('vitest')) ||\n    typeof (globalThis as any).afterAll === 'function';\n\n  if (isTestEnv) {\n    // Suppress real process exit during tests; vitest intercepts and would throw otherwise.\n    // Note: Using console here intentionally as Logger may not be available during test teardown\n    console.info(`[exit] (test env) code=${outcome.code} reason=${outcome.reason}`);\n    return;\n  }\n\n  try {\n    handler(outcome);\n  } catch (err) {\n    // Note: Using console here intentionally as this is a critical failure path\n    console.error('Exit handler failure', err);\n    process.exit(outcome.code);\n  }\n}\n"],
+  "mappings": ";;AAUA,IAAI,UAAuB,oCAAW;AACpC,UAAQ,KAAK,QAAQ,IAAI;AAC3B,GAF2B;AAIpB,SAAS,eAAe,MAAmB;AAChD,YAAU;AACZ;AAFgB;AAIT,SAAS,YAAY,SAAsB;AAChD,QAAM,UAAU,QAAQ,IAAI,YAAY;AACxC,QAAM,YACJ,QAAQ,YAAY,MAAM,UAC1B,YAAY,QAAQ,OACpB,sBAAsB,QAAQ,OAC9B,QAAQ,KAAK,KAAK,OAAK,EAAE,SAAS,QAAQ,CAAC,KAC3C,OAAQ,WAAmB,aAAa;AAE1C,MAAI,WAAW;AAGb,YAAQ,KAAK,0BAA0B,QAAQ,IAAI,WAAW,QAAQ,MAAM,EAAE;AAC9E;AAAA,EACF;AAEA,MAAI;AACF,YAAQ,OAAO;AAAA,EACjB,SAAS,KAAK;AAEZ,YAAQ,MAAM,wBAAwB,GAAG;AACzC,YAAQ,KAAK,QAAQ,IAAI;AAAA,EAC3B;AACF;AAvBgB;",
   "names": []
 }

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;