@scpxl/nodejs-framework 1.0.17 → 1.0.19

package/dist/util/timing.js

@@ -0,0 +1,98 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class TimerInstance {
+  static {
+    __name(this, "TimerInstance");
+  }
+  startTime;
+  constructor(startTime) {
+    this.startTime = startTime;
+  }
+  stop() {
+    return performance.now() - this.startTime;
+  }
+  elapsed() {
+    return performance.now() - this.startTime;
+  }
+}
+class Timing {
+  static {
+    __name(this, "Timing");
+  }
+  /**
+   * Get current high-resolution timestamp in milliseconds.
+   * Uses performance.now() which provides sub-millisecond precision.
+   */
+  static now() {
+    return performance.now();
+  }
+  /**
+   * Start a timer and return a Timer instance.
+   * Call timer.stop() to get elapsed time in milliseconds.
+   */
+  static start() {
+    return new TimerInstance(performance.now());
+  }
+  /**
+   * Measure the execution time of a function (async or sync).
+   * Returns both the function result and timing information.
+   */
+  static async measure(fn, options = {}) {
+    const startTime = performance.now();
+    const result = await fn();
+    const endTime = performance.now();
+    const duration = endTime - startTime;
+    if (options.log) {
+      const name = options.name ?? "Anonymous function";
+      const message = `${name} executed`;
+      if (options.logger) {
+        options.logger(message, duration);
+      } else {
+        console.log(`${message} in ${duration.toFixed(3)}ms`);
+      }
+    }
+    return {
+      result,
+      duration,
+      startTime,
+      endTime
+    };
+  }
+  /**
+   * Measure the execution time of a synchronous function.
+   * Returns both the function result and timing information.
+   */
+  static measureSync(fn, options = {}) {
+    const startTime = performance.now();
+    const result = fn();
+    const endTime = performance.now();
+    const duration = endTime - startTime;
+    if (options.log) {
+      const name = options.name ?? "Anonymous function";
+      const message = `${name} executed`;
+      if (options.logger) {
+        options.logger(message, duration);
+      } else {
+        console.log(`${message} in ${duration.toFixed(3)}ms`);
+      }
+    }
+    return {
+      result,
+      duration,
+      startTime,
+      endTime
+    };
+  }
+  /**
+   * Calculate duration between two timestamps in milliseconds.
+   * Both timestamps should be from performance.now().
+   */
+  static duration(startTime, endTime) {
+    return endTime - startTime;
+  }
+}
+var timing_default = Timing;
+export {
+  timing_default as default
+};
+//# sourceMappingURL=timing.js.map

package/dist/util/timing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/util/timing.ts"],
+  "sourcesContent": ["import type { MeasureOptions, Timer, TimingResult } from './timing.interface.js';\n\n/**\n * Timer instance implementation using performance.now()\n */\nclass TimerInstance implements Timer {\n  public readonly startTime: number;\n\n  constructor(startTime: number) {\n    this.startTime = startTime;\n  }\n\n  stop(): number {\n    return performance.now() - this.startTime;\n  }\n\n  elapsed(): number {\n    return performance.now() - this.startTime;\n  }\n}\n\n/**\n * Modern high-resolution timing utility using performance.now()\n *\n * Provides simple APIs for measuring function execution time and manual timing.\n * All durations are returned in milliseconds with decimal precision.\n */\nclass Timing {\n  /**\n   * Get current high-resolution timestamp in milliseconds.\n   * Uses performance.now() which provides sub-millisecond precision.\n   */\n  static now(): number {\n    return performance.now();\n  }\n\n  /**\n   * Start a timer and return a Timer instance.\n   * Call timer.stop() to get elapsed time in milliseconds.\n   */\n  static start(): Timer {\n    return new TimerInstance(performance.now());\n  }\n\n  /**\n   * Measure the execution time of a function (async or sync).\n   * Returns both the function result and timing information.\n   */\n  static async measure<T>(fn: () => T | Promise<T>, options: MeasureOptions = {}): Promise<TimingResult<T>> {\n    const startTime = performance.now();\n    const result = await fn();\n    const endTime = performance.now();\n    const duration = endTime - startTime;\n\n    if (options.log) {\n      const name = options.name ?? 'Anonymous function';\n      const message = `${name} executed`;\n      if (options.logger) {\n        options.logger(message, duration);\n      } else {\n        console.log(`${message} in ${duration.toFixed(3)}ms`);\n      }\n    }\n\n    return {\n      result,\n      duration,\n      startTime,\n      endTime,\n    };\n  }\n\n  /**\n   * Measure the execution time of a synchronous function.\n   * Returns both the function result and timing information.\n   */\n  static measureSync<T>(fn: () => T, options: MeasureOptions = {}): TimingResult<T> {\n    const startTime = performance.now();\n    const result = fn();\n    const endTime = performance.now();\n    const duration = endTime - startTime;\n\n    if (options.log) {\n      const name = options.name ?? 'Anonymous function';\n      const message = `${name} executed`;\n      if (options.logger) {\n        options.logger(message, duration);\n      } else {\n        console.log(`${message} in ${duration.toFixed(3)}ms`);\n      }\n    }\n\n    return {\n      result,\n      duration,\n      startTime,\n      endTime,\n    };\n  }\n\n  /**\n   * Calculate duration between two timestamps in milliseconds.\n   * Both timestamps should be from performance.now().\n   */\n  static duration(startTime: number, endTime: number): number {\n    return endTime - startTime;\n  }\n}\n\nexport default Timing;\n"],
+  "mappings": ";;AAKA,MAAM,cAA+B;AAAA,EALrC,OAKqC;AAAA;AAAA;AAAA,EACnB;AAAA,EAEhB,YAAY,WAAmB;AAC7B,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,OAAe;AACb,WAAO,YAAY,IAAI,IAAI,KAAK;AAAA,EAClC;AAAA,EAEA,UAAkB;AAChB,WAAO,YAAY,IAAI,IAAI,KAAK;AAAA,EAClC;AACF;AAQA,MAAM,OAAO;AAAA,EA3Bb,OA2Ba;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAKX,OAAO,MAAc;AACnB,WAAO,YAAY,IAAI;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,QAAe;AACpB,WAAO,IAAI,cAAc,YAAY,IAAI,CAAC;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAa,QAAW,IAA0B,UAA0B,CAAC,GAA6B;AACxG,UAAM,YAAY,YAAY,IAAI;AAClC,UAAM,SAAS,MAAM,GAAG;AACxB,UAAM,UAAU,YAAY,IAAI;AAChC,UAAM,WAAW,UAAU;AAE3B,QAAI,QAAQ,KAAK;AACf,YAAM,OAAO,QAAQ,QAAQ;AAC7B,YAAM,UAAU,GAAG,IAAI;AACvB,UAAI,QAAQ,QAAQ;AAClB,gBAAQ,OAAO,SAAS,QAAQ;AAAA,MAClC,OAAO;AACL,gBAAQ,IAAI,GAAG,OAAO,OAAO,SAAS,QAAQ,CAAC,CAAC,IAAI;AAAA,MACtD;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,YAAe,IAAa,UAA0B,CAAC,GAAoB;AAChF,UAAM,YAAY,YAAY,IAAI;AAClC,UAAM,SAAS,GAAG;AAClB,UAAM,UAAU,YAAY,IAAI;AAChC,UAAM,WAAW,UAAU;AAE3B,QAAI,QAAQ,KAAK;AACf,YAAM,OAAO,QAAQ,QAAQ;AAC7B,YAAM,UAAU,GAAG,IAAI;AACvB,UAAI,QAAQ,QAAQ;AAClB,gBAAQ,OAAO,SAAS,QAAQ;AAAA,MAClC,OAAO;AACL,gBAAQ,IAAI,GAAG,OAAO,OAAO,SAAS,QAAQ,CAAC,CAAC,IAAI;AAAA,MACtD;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,SAAS,WAAmB,SAAyB;AAC1D,WAAO,UAAU;AAAA,EACnB;AACF;AAEA,IAAO,iBAAQ;",
+  "names": []
+}

package/dist/util/url.js

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 const buildQueryString = /* @__PURE__ */ __name((params) => {
-  return Object.keys(params).filter((key) => params[key] !== void 0 && params[key] !== "").map((key) => `${encodeURIComponent(key)}=${encodeURIComponent(params[key])}`).join("&");
+  return Object.entries(params).filter(([, value]) => value !== void 0 && value !== "").map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`).join("&");
 }, "buildQueryString");
 var url_default = {
   buildQueryString

package/dist/util/url.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/util/url.ts"],
-  "sourcesContent": ["const buildQueryString = (params: { [key: string]: string | number | boolean }): string => {\n  return Object.keys(params)\n    .filter(key => params[key] !== undefined && params[key] !== '')\n    .map(key => `${encodeURIComponent(key)}=${encodeURIComponent(params[key])}`)\n    .join('&');\n};\n\nexport default {\n  buildQueryString,\n};\n"],
-  "mappings": ";;AAAA,MAAM,mBAAmB,wBAAC,WAAiE;AACzF,SAAO,OAAO,KAAK,MAAM,EACtB,OAAO,SAAO,OAAO,GAAG,MAAM,UAAa,OAAO,GAAG,MAAM,EAAE,EAC7D,IAAI,SAAO,GAAG,mBAAmB,GAAG,CAAC,IAAI,mBAAmB,OAAO,GAAG,CAAC,CAAC,EAAE,EAC1E,KAAK,GAAG;AACb,GALyB;AAOzB,IAAO,cAAQ;AAAA,EACb;AACF;",
+  "sourcesContent": ["const buildQueryString = (params: { [key: string]: string | number | boolean }): string => {\n  return Object.entries(params)\n    .filter(([, value]) => value !== undefined && value !== '')\n    .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)\n    .join('&');\n};\n\nexport default {\n  buildQueryString,\n};\n"],
+  "mappings": ";;AAAA,MAAM,mBAAmB,wBAAC,WAAiE;AACzF,SAAO,OAAO,QAAQ,MAAM,EACzB,OAAO,CAAC,CAAC,EAAE,KAAK,MAAM,UAAU,UAAa,UAAU,EAAE,EACzD,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,GAAG,mBAAmB,GAAG,CAAC,IAAI,mBAAmB,OAAO,KAAK,CAAC,CAAC,EAAE,EACvF,KAAK,GAAG;AACb,GALyB;AAOzB,IAAO,cAAQ;AAAA,EACb;AACF;",
   "names": []
 }

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

@@ -7,6 +7,7 @@ import type { ApiError, ApiResponse, WebServerBaseControllerConstructorParams }
 import type { ApplicationConfig } from '../../application/base-application.interface.js';
 import type EventManager from '../../event/manager.js';
 import type { WebServerOptions } from '../webserver.interface.js';
+import type { LifecycleManager } from '../../lifecycle/lifecycle-manager.js';
 export interface AuthenticatedUser {
     userId: number;
     payload: any;
@@ -19,7 +20,8 @@ export default abstract class BaseController {
     protected queueManager: QueueManager;
     protected eventManager: EventManager;
     protected databaseInstance: DatabaseInstance;
-    constructor({ applicationConfig, webServerOptions, redisInstance, queueManager, eventManager, databaseInstance, }: WebServerBaseControllerConstructorParams);
+    protected lifecycleManager: LifecycleManager;
+    constructor({ applicationConfig, webServerOptions, redisInstance, queueManager, eventManager, databaseInstance, lifecycleManager, }: WebServerBaseControllerConstructorParams);
     protected sendSuccessResponse<T = any>({ reply, data, statusCode, meta, }: {
         reply: FastifyReply;
         data: T;

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

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE,MAAM,qBAAqB,CAAC;AAE3G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAIlE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,GAAG,CAAC;CACd;AAED,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,cAAc;IAC1C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC/C,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAE7C,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;gBAEjC,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,GACjB,EAAE,wCAAwC;IAY3C,SAAS,CAAC,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,EACrC,KAAK,EACL,IAAI,EACJ,UAA2B,EAC3B,IAAI,GACL,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC;QACR,UAAU,CAAC,EAAE,WAAW,CAAC;QACzB,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;KAC/B;IAYD,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,MAA6B;IAW1F,SAAS,CAAC,iBAAiB,CAAC,EAC1B,KAAK,EACL,KAAK,EACL,UAAoC,EACpC,SAAS,GACV,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,WAAW,CAAC;QACzB,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;KAC9B;IA6CD,OAAO,CAAC,YAAY;cAoBJ,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAwErH"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE,MAAM,qBAAqB,CAAC;AAE3G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,GAAG,CAAC;CACd;AAED,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,cAAc;IAC1C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC/C,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAE7C,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC7C,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;gBAEjC,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,EAAE,wCAAwC;IAa3C,SAAS,CAAC,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,EACrC,KAAK,EACL,IAAI,EACJ,UAA2B,EAC3B,IAAI,GACL,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC;QACR,UAAU,CAAC,EAAE,WAAW,CAAC;QACzB,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;KAC/B;IAYD,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,MAA6B;IAW1F,SAAS,CAAC,iBAAiB,CAAC,EAC1B,KAAK,EACL,KAAK,EACL,UAAoC,EACpC,SAAS,GACV,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,WAAW,CAAC;QACzB,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;KAC9B;IA6CD,OAAO,CAAC,YAAY;cAoBJ,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAwErH"}

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

@@ -5,6 +5,7 @@ import type { QueueManager } from '../../queue/index.js';
 import type { RedisInstance } from '../../redis/index.js';
 import type { WebServerOptions } from '../webserver.interface.js';
 import type WebServerBaseController from './base.js';
+import type { LifecycleManager } from '../../lifecycle/lifecycle-manager.js';
 export interface WebServerBaseControllerConstructorParams {
     applicationConfig: ApplicationConfig;
     webServerOptions: WebServerOptions;
@@ -12,6 +13,7 @@ export interface WebServerBaseControllerConstructorParams {
     queueManager: QueueManager;
     eventManager: EventManager;
     databaseInstance: DatabaseInstance;
+    lifecycleManager: LifecycleManager;
 }
 export type WebServerBaseControllerType = new (params: WebServerBaseControllerConstructorParams) => WebServerBaseController;
 export interface ApiResponse<T = any> {

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

@@ -1 +1 @@
-{"version":3,"file":"base.interface.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/base.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,uBAAuB,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,wCAAwC;IACvD,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,MAAM,2BAA2B,GAAG,KACxC,MAAM,EAAE,wCAAwC,KAC7C,uBAAuB,CAAC;AAE7B,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE;YACX,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,GAAG,gBAAgB,GAAG,eAAe,GAAG,WAAW,GAAG,cAAc,GAAG,cAAc,CAAC;IACxG,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"base.interface.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/base.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,uBAAuB,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,MAAM,WAAW,wCAAwC;IACvD,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,MAAM,2BAA2B,GAAG,KACxC,MAAM,EAAE,wCAAwC,KAC7C,uBAAuB,CAAC;AAE7B,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE;YACX,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,GAAG,gBAAgB,GAAG,eAAe,GAAG,WAAW,GAAG,cAAc,GAAG,cAAc,CAAC;IACxG,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC5B"}

package/dist/webserver/controller/base.js

@@ -15,13 +15,15 @@ class BaseController {
   queueManager;
   eventManager;
   databaseInstance;
+  lifecycleManager;
   constructor({
     applicationConfig,
     webServerOptions,
     redisInstance,
     queueManager,
     eventManager,
-    databaseInstance
+    databaseInstance,
+    lifecycleManager
   }) {
     this.workerId = cluster.worker?.id;
     this.applicationConfig = applicationConfig;
@@ -30,6 +32,7 @@ class BaseController {
     this.queueManager = queueManager;
     this.eventManager = eventManager;
     this.databaseInstance = databaseInstance;
+    this.lifecycleManager = lifecycleManager;
   }
   sendSuccessResponse({
     reply,

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/webserver/controller/base.ts"],
-  "sourcesContent": ["import { StatusCodes } from 'http-status-codes';\nimport type { FastifyReply, FastifyRequest } from 'fastify';\nimport type { DatabaseInstance } from '../../database/index.js';\nimport type { RedisInstance } from '../../redis/index.js';\nimport type { QueueManager } from '../../queue/index.js';\nimport type { ApiError, ApiResponse, WebServerBaseControllerConstructorParams } from './base.interface.js';\nimport { Logger } from '../../logger/index.js';\nimport type { ApplicationConfig } from '../../application/base-application.interface.js';\nimport type EventManager from '../../event/manager.js';\nimport cluster from 'cluster';\nimport type { WebServerOptions } from '../webserver.interface.js';\nimport Jwt from '../../auth/jwt.js';\n// import { env } from '../../env';\n\nexport interface AuthenticatedUser {\n  userId: number;\n  payload: any;\n}\n\nexport default abstract class BaseController {\n  protected workerId: number | undefined;\n\n  protected applicationConfig: ApplicationConfig;\n  protected webServerOptions: WebServerOptions;\n\n  protected redisInstance: RedisInstance;\n  protected queueManager: QueueManager;\n  protected eventManager: EventManager;\n  protected databaseInstance: DatabaseInstance;\n\n  constructor({\n    applicationConfig,\n    webServerOptions,\n    redisInstance,\n    queueManager,\n    eventManager,\n    databaseInstance,\n  }: WebServerBaseControllerConstructorParams) {\n    this.workerId = cluster.worker?.id;\n\n    this.applicationConfig = applicationConfig;\n    this.webServerOptions = webServerOptions;\n\n    this.redisInstance = redisInstance;\n    this.queueManager = queueManager;\n    this.eventManager = eventManager;\n    this.databaseInstance = databaseInstance;\n  }\n\n  protected sendSuccessResponse<T = any>({\n    reply,\n    data,\n    statusCode = StatusCodes.OK,\n    meta,\n  }: {\n    reply: FastifyReply;\n    data: T;\n    statusCode?: StatusCodes;\n    meta?: ApiResponse<T>['meta'];\n  }) {\n    const response: ApiResponse<T> = {\n      data,\n      meta: {\n        timestamp: new Date().toISOString(),\n        requestId: reply.request.id || 'unknown',\n        ...meta,\n      },\n    };\n    reply.status(statusCode).send(response);\n  }\n\n  protected sendNotFoundResponse(reply: FastifyReply, message: string = 'Resource not found') {\n    const error: ApiError = {\n      message,\n      type: 'not_found',\n      timestamp: new Date().toISOString(),\n      requestId: reply.request.id || 'unknown',\n    };\n    const response: ApiResponse = { error };\n    reply.status(StatusCodes.NOT_FOUND).send(response);\n  }\n\n  protected sendErrorResponse({\n    reply,\n    error,\n    statusCode = StatusCodes.BAD_REQUEST,\n    errorType,\n  }: {\n    reply: FastifyReply;\n    error: unknown;\n    statusCode?: StatusCodes;\n    errorType?: ApiError['type'];\n  }) {\n    let publicErrorMessage: string;\n    let errorDetails: any = undefined;\n\n    if (this.webServerOptions.errors?.verbose === true) {\n      if (error instanceof Error) {\n        publicErrorMessage = error.stack ?? error.message;\n        errorDetails = { stack: error.stack, name: error.name };\n      } else {\n        publicErrorMessage = String(error);\n      }\n    } else {\n      if (process.env.NODE_ENV === 'production') {\n        if (error instanceof Error) {\n          publicErrorMessage = 'Something went wrong';\n        } else if (typeof error === 'string') {\n          publicErrorMessage = error;\n        } else {\n          publicErrorMessage = 'An unknown error occurred';\n        }\n      } else {\n        if (error instanceof Error) {\n          publicErrorMessage = error.stack ?? error.message;\n          errorDetails = { stack: error.stack, name: error.name };\n        } else {\n          publicErrorMessage = String(error);\n        }\n      }\n    }\n\n    Logger.custom({ level: 'webServer', message: error });\n    console.error(error);\n\n    const apiError: ApiError = {\n      message: publicErrorMessage,\n      type: errorType ?? this.getErrorType(statusCode),\n      timestamp: new Date().toISOString(),\n      requestId: reply.request.id || 'unknown',\n      ...(errorDetails && { details: errorDetails }),\n    };\n\n    const response: ApiResponse = { error: apiError };\n    reply.status(statusCode).send(response);\n  }\n\n  private getErrorType(statusCode: StatusCodes): ApiError['type'] {\n    switch (statusCode) {\n      case StatusCodes.UNAUTHORIZED:\n        return 'authentication';\n      case StatusCodes.FORBIDDEN:\n        return 'authorization';\n      case StatusCodes.NOT_FOUND:\n        return 'not_found';\n      case StatusCodes.BAD_REQUEST:\n      case StatusCodes.UNPROCESSABLE_ENTITY:\n        return 'validation';\n      case StatusCodes.INTERNAL_SERVER_ERROR:\n      case StatusCodes.BAD_GATEWAY:\n      case StatusCodes.SERVICE_UNAVAILABLE:\n        return 'server_error';\n      default:\n        return 'client_error';\n    }\n  }\n\n  protected async authenticateRequest(request: FastifyRequest, reply: FastifyReply): Promise<AuthenticatedUser | null> {\n    // Get JWT secret key from application config\n    const jwtSecretKey = this.applicationConfig.auth?.jwtSecretKey;\n\n    if (!jwtSecretKey) {\n      this.sendErrorResponse({\n        reply,\n        error: 'Authentication not configured.',\n        statusCode: StatusCodes.INTERNAL_SERVER_ERROR,\n        errorType: 'server_error',\n      });\n      return null;\n    }\n\n    const authHeader = request.headers.authorization;\n\n    if (!authHeader) {\n      this.sendErrorResponse({\n        reply,\n        error: 'No token provided.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n\n    if (!authHeader.startsWith('Bearer ')) {\n      this.sendErrorResponse({\n        reply,\n        error: 'Invalid token.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n\n    try {\n      const importedJwtSecretKey = await Jwt.importJwtSecretKey({\n        jwtSecretKey,\n      });\n\n      // Remove \"Bearer \" from token\n      const jwtAccessToken = authHeader.substring(7);\n\n      const { payload } = await Jwt.jwtVerify(jwtAccessToken, importedJwtSecretKey);\n\n      if (!payload.sub) {\n        this.sendErrorResponse({\n          reply,\n          error: 'Invalid token payload.',\n          statusCode: StatusCodes.UNAUTHORIZED,\n          errorType: 'authentication',\n        });\n        return null;\n      }\n\n      const userId = parseInt(payload.sub);\n\n      return {\n        userId,\n        payload,\n      };\n    } catch {\n      this.sendErrorResponse({\n        reply,\n        error: 'Invalid or expired token.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { StatusCodes } from 'http-status-codes';\nimport type { FastifyReply, FastifyRequest } from 'fastify';\nimport type { DatabaseInstance } from '../../database/index.js';\nimport type { RedisInstance } from '../../redis/index.js';\nimport type { QueueManager } from '../../queue/index.js';\nimport type { ApiError, ApiResponse, WebServerBaseControllerConstructorParams } from './base.interface.js';\nimport { Logger } from '../../logger/index.js';\nimport type { ApplicationConfig } from '../../application/base-application.interface.js';\nimport type EventManager from '../../event/manager.js';\nimport cluster from 'cluster';\nimport type { WebServerOptions } from '../webserver.interface.js';\nimport type { LifecycleManager } from '../../lifecycle/lifecycle-manager.js';\nimport Jwt from '../../auth/jwt.js';\n\nexport interface AuthenticatedUser {\n  userId: number;\n  payload: any;\n}\n\nexport default abstract class BaseController {\n  protected workerId: number | undefined;\n\n  protected applicationConfig: ApplicationConfig;\n  protected webServerOptions: WebServerOptions;\n\n  protected redisInstance: RedisInstance;\n  protected queueManager: QueueManager;\n  protected eventManager: EventManager;\n  protected databaseInstance: DatabaseInstance;\n  protected lifecycleManager: LifecycleManager;\n\n  constructor({\n    applicationConfig,\n    webServerOptions,\n    redisInstance,\n    queueManager,\n    eventManager,\n    databaseInstance,\n    lifecycleManager,\n  }: WebServerBaseControllerConstructorParams) {\n    this.workerId = cluster.worker?.id;\n\n    this.applicationConfig = applicationConfig;\n    this.webServerOptions = webServerOptions;\n\n    this.redisInstance = redisInstance;\n    this.queueManager = queueManager;\n    this.eventManager = eventManager;\n    this.databaseInstance = databaseInstance;\n    this.lifecycleManager = lifecycleManager;\n  }\n\n  protected sendSuccessResponse<T = any>({\n    reply,\n    data,\n    statusCode = StatusCodes.OK,\n    meta,\n  }: {\n    reply: FastifyReply;\n    data: T;\n    statusCode?: StatusCodes;\n    meta?: ApiResponse<T>['meta'];\n  }) {\n    const response: ApiResponse<T> = {\n      data,\n      meta: {\n        timestamp: new Date().toISOString(),\n        requestId: reply.request.id || 'unknown',\n        ...meta,\n      },\n    };\n    reply.status(statusCode).send(response);\n  }\n\n  protected sendNotFoundResponse(reply: FastifyReply, message: string = 'Resource not found') {\n    const error: ApiError = {\n      message,\n      type: 'not_found',\n      timestamp: new Date().toISOString(),\n      requestId: reply.request.id || 'unknown',\n    };\n    const response: ApiResponse = { error };\n    reply.status(StatusCodes.NOT_FOUND).send(response);\n  }\n\n  protected sendErrorResponse({\n    reply,\n    error,\n    statusCode = StatusCodes.BAD_REQUEST,\n    errorType,\n  }: {\n    reply: FastifyReply;\n    error: unknown;\n    statusCode?: StatusCodes;\n    errorType?: ApiError['type'];\n  }) {\n    let publicErrorMessage: string;\n    let errorDetails: any = undefined;\n\n    if (this.webServerOptions.errors?.verbose === true) {\n      if (error instanceof Error) {\n        publicErrorMessage = error.stack ?? error.message;\n        errorDetails = { stack: error.stack, name: error.name };\n      } else {\n        publicErrorMessage = String(error);\n      }\n    } else {\n      if (process.env.NODE_ENV === 'production') {\n        if (error instanceof Error) {\n          publicErrorMessage = 'Something went wrong';\n        } else if (typeof error === 'string') {\n          publicErrorMessage = error;\n        } else {\n          publicErrorMessage = 'An unknown error occurred';\n        }\n      } else {\n        if (error instanceof Error) {\n          publicErrorMessage = error.stack ?? error.message;\n          errorDetails = { stack: error.stack, name: error.name };\n        } else {\n          publicErrorMessage = String(error);\n        }\n      }\n    }\n\n    Logger.custom({ level: 'webServer', message: error });\n    console.error(error);\n\n    const apiError: ApiError = {\n      message: publicErrorMessage,\n      type: errorType ?? this.getErrorType(statusCode),\n      timestamp: new Date().toISOString(),\n      requestId: reply.request.id || 'unknown',\n      ...(errorDetails && { details: errorDetails }),\n    };\n\n    const response: ApiResponse = { error: apiError };\n    reply.status(statusCode).send(response);\n  }\n\n  private getErrorType(statusCode: StatusCodes): ApiError['type'] {\n    switch (statusCode) {\n      case StatusCodes.UNAUTHORIZED:\n        return 'authentication';\n      case StatusCodes.FORBIDDEN:\n        return 'authorization';\n      case StatusCodes.NOT_FOUND:\n        return 'not_found';\n      case StatusCodes.BAD_REQUEST:\n      case StatusCodes.UNPROCESSABLE_ENTITY:\n        return 'validation';\n      case StatusCodes.INTERNAL_SERVER_ERROR:\n      case StatusCodes.BAD_GATEWAY:\n      case StatusCodes.SERVICE_UNAVAILABLE:\n        return 'server_error';\n      default:\n        return 'client_error';\n    }\n  }\n\n  protected async authenticateRequest(request: FastifyRequest, reply: FastifyReply): Promise<AuthenticatedUser | null> {\n    // Get JWT secret key from application config\n    const jwtSecretKey = this.applicationConfig.auth?.jwtSecretKey;\n\n    if (!jwtSecretKey) {\n      this.sendErrorResponse({\n        reply,\n        error: 'Authentication not configured.',\n        statusCode: StatusCodes.INTERNAL_SERVER_ERROR,\n        errorType: 'server_error',\n      });\n      return null;\n    }\n\n    const authHeader = request.headers.authorization;\n\n    if (!authHeader) {\n      this.sendErrorResponse({\n        reply,\n        error: 'No token provided.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n\n    if (!authHeader.startsWith('Bearer ')) {\n      this.sendErrorResponse({\n        reply,\n        error: 'Invalid token.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n\n    try {\n      const importedJwtSecretKey = await Jwt.importJwtSecretKey({\n        jwtSecretKey,\n      });\n\n      // Remove \"Bearer \" from token\n      const jwtAccessToken = authHeader.substring(7);\n\n      const { payload } = await Jwt.jwtVerify(jwtAccessToken, importedJwtSecretKey);\n\n      if (!payload.sub) {\n        this.sendErrorResponse({\n          reply,\n          error: 'Invalid token payload.',\n          statusCode: StatusCodes.UNAUTHORIZED,\n          errorType: 'authentication',\n        });\n        return null;\n      }\n\n      const userId = parseInt(payload.sub);\n\n      return {\n        userId,\n        payload,\n      };\n    } catch {\n      this.sendErrorResponse({\n        reply,\n        error: 'Invalid or expired token.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/webserver/controller/health.d.ts

@@ -1,7 +1,14 @@
 import type { FastifyReply, FastifyRequest } from 'fastify';
 import BaseController from './base.js';
 export default class HealthController extends BaseController {
-    health: (_: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    /**
+     * Liveness probe: process is up and not in stopping phase.
+     */
+    live: (_: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    /**
+     * Readiness probe: service dependencies are available & lifecycle is RUNNING with aggregated readiness.
+     */
+    ready: (_: FastifyRequest, reply: FastifyReply) => Promise<void>;
     private checkDatabaseConnection;
     private checkRedisConnection;
 }

package/dist/webserver/controller/health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,cAAc,MAAM,WAAW,CAAC;AAEvC,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,cAAc;IACnD,MAAM,GAAU,GAAG,cAAc,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CA4B3E;YAEY,uBAAuB;YAQvB,oBAAoB;CAOnC"}
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,cAAc,MAAM,WAAW,CAAC;AAGvC,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,cAAc;IAC1D;;OAEG;IACI,IAAI,GAAU,GAAG,cAAc,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CAQzE;IAEF;;OAEG;IACI,KAAK,GAAU,GAAG,cAAc,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CA6B1E;YAEY,uBAAuB;YAQvB,oBAAoB;CAOnC"}

package/dist/webserver/controller/health.js

@@ -1,34 +1,48 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 import BaseController from "./base.js";
+import { LifecyclePhase } from "../../lifecycle/types.js";
 class HealthController extends BaseController {
   static {
     __name(this, "HealthController");
   }
-  health = /* @__PURE__ */ __name(async (_, reply) => {
-    try {
-      const healthCheckPromises = [this.checkDatabaseConnection(), this.checkRedisConnection()];
-      const results = await Promise.all(
-        healthCheckPromises.map((healthCheckPromise) => healthCheckPromise.catch((error) => error))
-      );
-      const isDatabaseHealthy = results[0] === true;
-      const isRedisHealthy = results[1] === true;
-      const isAllHealthy = results.every((result) => result === true);
-      reply.send({
-        healthy: isAllHealthy,
-        services: {
-          database: { healthy: isDatabaseHealthy },
-          redis: { healthy: isRedisHealthy }
-          // queue: { activeItems: activeQueueItems },
-        }
-      });
-    } catch (error) {
-      reply.status(500).send({
-        healthy: false,
-        error: error.message
+  /**
+   * Liveness probe: process is up and not in stopping phase.
+   */
+  live = /* @__PURE__ */ __name(async (_, reply) => {
+    const phase = this.lifecycleManager.phase;
+    const shuttingDown = phase === LifecyclePhase.STOPPING || phase === LifecyclePhase.STOPPED;
+    if (shuttingDown) {
+      reply.code(503).send({ live: false, phase });
+      return;
+    }
+    reply.send({ live: true, phase });
+  }, "live");
+  /**
+   * Readiness probe: service dependencies are available & lifecycle is RUNNING with aggregated readiness.
+   */
+  ready = /* @__PURE__ */ __name(async (_, reply) => {
+    const phase = this.lifecycleManager.phase;
+    const readinessStatus = await this.lifecycleManager.getReadinessStatus();
+    const probes = {};
+    for (const check of readinessStatus.checks) {
+      probes[check.name] = { healthy: check.ready, required: true };
+    }
+    const requiredFailures = Object.entries(probes).filter(([, v]) => v.required && !v.healthy).map(([k]) => k);
+    const ready = readinessStatus.ready;
+    if (!ready) {
+      reply.code(503).send({
+        ready: false,
+        phase,
+        probes,
+        notReady: phase !== LifecyclePhase.RUNNING ? "lifecycle-phase" : "readiness-checks-failed",
+        failed: requiredFailures,
+        aggregatedReadiness: true
       });
+      return;
     }
-  }, "health");
+    reply.send({ ready: true, phase, probes, aggregatedReadiness: true });
+  }, "ready");
   async checkDatabaseConnection() {
     try {
       return await this.databaseInstance.isConnected();

package/dist/webserver/controller/health.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/webserver/controller/health.ts"],
-  "sourcesContent": ["import type { FastifyReply, FastifyRequest } from 'fastify';\nimport BaseController from './base.js';\n\nexport default class HealthController extends BaseController {\n  public health = async (_: FastifyRequest, reply: FastifyReply): Promise<void> => {\n    try {\n      const healthCheckPromises = [this.checkDatabaseConnection(), this.checkRedisConnection()];\n\n      const results = await Promise.all(\n        healthCheckPromises.map(healthCheckPromise => healthCheckPromise.catch(error => error)),\n      );\n\n      const isDatabaseHealthy = results[0] === true;\n      const isRedisHealthy = results[1] === true;\n      // const activeQueueItems = await this.queueManager.listAllJobsWithStatus();\n\n      const isAllHealthy = results.every(result => result === true);\n\n      reply.send({\n        healthy: isAllHealthy,\n        services: {\n          database: { healthy: isDatabaseHealthy },\n          redis: { healthy: isRedisHealthy },\n          // queue: { activeItems: activeQueueItems },\n        },\n      });\n    } catch (error: unknown) {\n      reply.status(500).send({\n        healthy: false,\n        error: (error as Error).message,\n      });\n    }\n  };\n\n  private async checkDatabaseConnection(): Promise<boolean> {\n    try {\n      return await this.databaseInstance.isConnected();\n    } catch {\n      return false;\n    }\n  }\n\n  private async checkRedisConnection(): Promise<boolean> {\n    try {\n      return await this.redisInstance.isConnected();\n    } catch {\n      return false;\n    }\n  }\n}\n"],
-  "mappings": ";;AACA,OAAO,oBAAoB;AAE3B,MAAO,yBAAuC,eAAe;AAAA,EAH7D,OAG6D;AAAA;AAAA;AAAA,EACpD,SAAS,8BAAO,GAAmB,UAAuC;AAC/E,QAAI;AACF,YAAM,sBAAsB,CAAC,KAAK,wBAAwB,GAAG,KAAK,qBAAqB,CAAC;AAExF,YAAM,UAAU,MAAM,QAAQ;AAAA,QAC5B,oBAAoB,IAAI,wBAAsB,mBAAmB,MAAM,WAAS,KAAK,CAAC;AAAA,MACxF;AAEA,YAAM,oBAAoB,QAAQ,CAAC,MAAM;AACzC,YAAM,iBAAiB,QAAQ,CAAC,MAAM;AAGtC,YAAM,eAAe,QAAQ,MAAM,YAAU,WAAW,IAAI;AAE5D,YAAM,KAAK;AAAA,QACT,SAAS;AAAA,QACT,UAAU;AAAA,UACR,UAAU,EAAE,SAAS,kBAAkB;AAAA,UACvC,OAAO,EAAE,SAAS,eAAe;AAAA;AAAA,QAEnC;AAAA,MACF,CAAC;AAAA,IACH,SAAS,OAAgB;AACvB,YAAM,OAAO,GAAG,EAAE,KAAK;AAAA,QACrB,SAAS;AAAA,QACT,OAAQ,MAAgB;AAAA,MAC1B,CAAC;AAAA,IACH;AAAA,EACF,GA5BgB;AAAA,EA8BhB,MAAc,0BAA4C;AACxD,QAAI;AACF,aAAO,MAAM,KAAK,iBAAiB,YAAY;AAAA,IACjD,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAc,uBAAyC;AACrD,QAAI;AACF,aAAO,MAAM,KAAK,cAAc,YAAY;AAAA,IAC9C,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { FastifyReply, FastifyRequest } from 'fastify';\nimport BaseController from './base.js';\nimport { LifecyclePhase } from '../../lifecycle/types.js';\n\nexport default class HealthController extends BaseController {\n  /**\n   * Liveness probe: process is up and not in stopping phase.\n   */\n  public live = async (_: FastifyRequest, reply: FastifyReply): Promise<void> => {\n    const phase = this.lifecycleManager.phase;\n    const shuttingDown = phase === LifecyclePhase.STOPPING || phase === LifecyclePhase.STOPPED;\n    if (shuttingDown) {\n      reply.code(503).send({ live: false, phase });\n      return;\n    }\n    reply.send({ live: true, phase });\n  };\n\n  /**\n   * Readiness probe: service dependencies are available & lifecycle is RUNNING with aggregated readiness.\n   */\n  public ready = async (_: FastifyRequest, reply: FastifyReply): Promise<void> => {\n    const phase = this.lifecycleManager.phase;\n    const readinessStatus = await this.lifecycleManager.getReadinessStatus();\n\n    // Convert readiness check results to probe format for backward compatibility\n    const probes: Record<string, { healthy: boolean; required: boolean }> = {};\n    for (const check of readinessStatus.checks) {\n      probes[check.name] = { healthy: check.ready, required: true };\n    }\n\n    const requiredFailures = Object.entries(probes)\n      .filter(([, v]) => v.required && !v.healthy)\n      .map(([k]) => k);\n\n    const ready = readinessStatus.ready;\n\n    if (!ready) {\n      reply.code(503).send({\n        ready: false,\n        phase,\n        probes,\n        notReady: phase !== LifecyclePhase.RUNNING ? 'lifecycle-phase' : 'readiness-checks-failed',\n        failed: requiredFailures,\n        aggregatedReadiness: true,\n      });\n      return;\n    }\n\n    reply.send({ ready: true, phase, probes, aggregatedReadiness: true });\n  };\n\n  private async checkDatabaseConnection(): Promise<boolean> {\n    try {\n      return await this.databaseInstance.isConnected();\n    } catch {\n      return false;\n    }\n  }\n\n  private async checkRedisConnection(): Promise<boolean> {\n    try {\n      return await this.redisInstance.isConnected();\n    } catch {\n      return false;\n    }\n  }\n}\n"],
+  "mappings": ";;AACA,OAAO,oBAAoB;AAC3B,SAAS,sBAAsB;AAE/B,MAAO,yBAAuC,eAAe;AAAA,EAJ7D,OAI6D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAIpD,OAAO,8BAAO,GAAmB,UAAuC;AAC7E,UAAM,QAAQ,KAAK,iBAAiB;AACpC,UAAM,eAAe,UAAU,eAAe,YAAY,UAAU,eAAe;AACnF,QAAI,cAAc;AAChB,YAAM,KAAK,GAAG,EAAE,KAAK,EAAE,MAAM,OAAO,MAAM,CAAC;AAC3C;AAAA,IACF;AACA,UAAM,KAAK,EAAE,MAAM,MAAM,MAAM,CAAC;AAAA,EAClC,GARc;AAAA;AAAA;AAAA;AAAA,EAaP,QAAQ,8BAAO,GAAmB,UAAuC;AAC9E,UAAM,QAAQ,KAAK,iBAAiB;AACpC,UAAM,kBAAkB,MAAM,KAAK,iBAAiB,mBAAmB;AAGvE,UAAM,SAAkE,CAAC;AACzE,eAAW,SAAS,gBAAgB,QAAQ;AAC1C,aAAO,MAAM,IAAI,IAAI,EAAE,SAAS,MAAM,OAAO,UAAU,KAAK;AAAA,IAC9D;AAEA,UAAM,mBAAmB,OAAO,QAAQ,MAAM,EAC3C,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,EAC1C,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AAEjB,UAAM,QAAQ,gBAAgB;AAE9B,QAAI,CAAC,OAAO;AACV,YAAM,KAAK,GAAG,EAAE,KAAK;AAAA,QACnB,OAAO;AAAA,QACP;AAAA,QACA;AAAA,QACA,UAAU,UAAU,eAAe,UAAU,oBAAoB;AAAA,QACjE,QAAQ;AAAA,QACR,qBAAqB;AAAA,MACvB,CAAC;AACD;AAAA,IACF;AAEA,UAAM,KAAK,EAAE,OAAO,MAAM,OAAO,QAAQ,qBAAqB,KAAK,CAAC;AAAA,EACtE,GA7Be;AAAA,EA+Bf,MAAc,0BAA4C;AACxD,QAAI;AACF,aAAO,MAAM,KAAK,iBAAiB,YAAY;AAAA,IACjD,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAc,uBAAyC;AACrD,QAAI;AACF,aAAO,MAAM,KAAK,cAAc,YAAY;AAAA,IAC9C,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/webserver/webserver.d.ts

@@ -1,8 +1,10 @@
 import { type FastifyInstance, type HTTPMethods } from 'fastify';
 import { type WebServerConstructorParams } from './webserver.interface.js';
+import type { LifecycleManager } from '../lifecycle/lifecycle-manager.js';
 declare module 'fastify' {
     interface FastifyRequest {
-        startTime?: [number, number];
+        startTime?: number;
+        requestId?: string;
     }
 }
 declare class WebServer {
@@ -15,11 +17,19 @@ declare class WebServer {
     private eventManager;
     private databaseInstance;
     fastifyServer: FastifyInstance;
-    constructor(params: WebServerConstructorParams);
+    private lifecycleManager;
+    private _isReady;
+    constructor(params: WebServerConstructorParams & {
+        lifecycleManager: LifecycleManager;
+    });
     /**
      * Load web server.
      */
     load(): Promise<void>;
+    /**
+     * Configure security features (Helmet, Rate Limiting)
+     */
+    private configureSecurity;
     /**
      * Configure hooks.
      */
@@ -56,6 +66,10 @@ declare class WebServer {
      * Stop web server.
      */
     stop(): Promise<void>;
+    /**
+     * Check if web server is ready to accept traffic.
+     */
+    isReady(): boolean;
     /**
      * Log web server message
      */

package/dist/webserver/webserver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webserver.d.ts","sourceRoot":"","sources":["../../src/webserver/webserver.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,KAAK,eAAe,EAA0C,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAGlH,OAAO,EACL,KAAK,0BAA0B,EAIhC,MAAM,0BAA0B,CAAC;AAalC,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,cAAc;QACtB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC9B;CACF;AAED,cAAM,SAAS;IACb,OAAO,CAAC,MAAM,CAAyB;IAEvC,OAAO,CAAC,iBAAiB,CAAoB;IAE7C,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,MAAM,CAAmB;IAEjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAEpC,aAAa,EAAE,eAAe,CAAC;gBAE1B,MAAM,EAAE,0BAA0B;IA8C9C;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAclC;;OAEG;IACH,OAAO,CAAC,cAAc;YAeR,QAAQ;YAeR,SAAS;YAkBT,UAAU;YAkCV,OAAO;YAMP,OAAO;IAIrB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,yBAAyB;IAcjC;;OAEG;YACW,eAAe;IAmJhB,WAAW,CAAC,EACvB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,SAAS,EACT,WAAW,EACX,eAAe,GAChB,EAAE;QACD,kBAAkB,EAAE,GAAG,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;QACzC,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE;YAChB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;YAClC,MAAM,EAAE;gBAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;aAAE,CAAC;SAChC,CAAC;KACH,GAAG,OAAO,CAAC,IAAI,CAAC;IA0CjB;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWnC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlE;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"webserver.d.ts","sourceRoot":"","sources":["../../src/webserver/webserver.ts"],"names":[],"mappings":"AACA,OAAgB,EAAE,KAAK,eAAe,EAA0C,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAKlH,OAAO,EACL,KAAK,0BAA0B,EAIhC,MAAM,0BAA0B,CAAC;AASlC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAK1E,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,cAAc;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CACF;AAED,cAAM,SAAS;IACb,OAAO,CAAC,MAAM,CAAyB;IAEvC,OAAO,CAAC,iBAAiB,CAAoB;IAE7C,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,MAAM,CAAmB;IAEjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAEpC,aAAa,EAAE,eAAe,CAAC;IAEtC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,0BAA0B,GAAG;QAAE,gBAAgB,EAAE,gBAAgB,CAAA;KAAE;IAgDvF;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBlC;;OAEG;YACW,iBAAiB;IAiD/B;;OAEG;IACH,OAAO,CAAC,cAAc;YAeR,QAAQ;YAeR,SAAS;YA2BT,UAAU;YAuCV,OAAO;YAMP,OAAO;IAIrB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,yBAAyB;IAcjC;;OAEG;YACW,eAAe;IA+JhB,WAAW,CAAC,EACvB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,SAAS,EACT,WAAW,EACX,eAAe,GAChB,EAAE;QACD,kBAAkB,EAAE,GAAG,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;QACzC,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE;YAChB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;YAClC,MAAM,EAAE;gBAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;aAAE,CAAC;SAChC,CAAC;KACH,GAAG,OAAO,CAAC,IAAI,CAAC;IA+DjB;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAanC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC;;OAEG;IACI,OAAO,IAAI,OAAO;IAIzB;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlE;AAED,eAAe,SAAS,CAAC"}

package/dist/webserver/webserver.interface.d.ts

@@ -5,6 +5,7 @@ import type { RedisInstance } from '../redis/index.js';
 import type { WebServerBaseControllerType } from './controller/base.interface.js';
 import type { ApplicationConfig } from '../application/base-application.interface.js';
 import type EventManager from '../event/manager.js';
+import type { LifecycleManager } from '../lifecycle/lifecycle-manager.js';
 export interface WebServerConstructorParams {
     /** Application configuration */
     applicationConfig: ApplicationConfig;
@@ -20,6 +21,8 @@ export interface WebServerConstructorParams {
     eventManager: EventManager;
     /** Database instance */
     databaseInstance: DatabaseInstance;
+    /** Lifecycle manager */
+    lifecycleManager: LifecycleManager;
 }
 export declare enum WebServerRouteType {
     Default = "default",
@@ -100,11 +103,43 @@ export type WebServerCorsOptions = WebServerCorsDisabledOptionsBase | WebServerC
 export interface WebServerErrorsOptions {
     verbose: boolean;
 }
+export interface WebServerSecurityHelmetOptions {
+    enabled?: boolean;
+    contentSecurityPolicy?: boolean;
+    crossOriginEmbedderPolicy?: boolean;
+    crossOriginOpenerPolicy?: boolean;
+    crossOriginResourcePolicy?: boolean;
+    dnsPrefetchControl?: boolean;
+    frameguard?: boolean;
+    hidePoweredBy?: boolean;
+    hsts?: boolean;
+    ieNoOpen?: boolean;
+    noSniff?: boolean;
+    originAgentCluster?: boolean;
+    permittedCrossDomainPolicies?: boolean;
+    referrerPolicy?: boolean;
+    xssFilter?: boolean;
+}
+export interface WebServerSecurityRateLimitOptions {
+    enabled?: boolean;
+    max?: number;
+    timeWindow?: string;
+    ban?: number;
+    cache?: number;
+}
+export interface WebServerSecurityOptions {
+    helmet?: WebServerSecurityHelmetOptions;
+    rateLimit?: WebServerSecurityRateLimitOptions;
+}
 export interface WebServerOptions {
     /** Web server host */
     host: string;
     /** Web server port */
     port: number;
+    /** Maximum request body size in bytes (default: 100MB) */
+    bodyLimit?: number;
+    /** Connection timeout in milliseconds (default: 30s) */
+    connectionTimeout?: number;
     /** Web server CORS options */
     cors?: WebServerCorsOptions;
     /** Web server error options */
@@ -112,6 +147,8 @@ export interface WebServerOptions {
     /** Web server controllers directory */
     controllersDirectory: string;
     log?: WebServerLogConfig;
+    /** Web server security options (helmet, rate limiting) */
+    security?: WebServerSecurityOptions;
     /** Web server debug options */
     debug?: WebServerDebugOptions;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"webserver.interface.d.ts","sourceRoot":"","sources":["../../src/webserver/webserver.interface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"webserver.interface.d.ts","sourceRoot":"","sources":["../../src/webserver/webserver.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,WAAW,0BAA0B;IACzC,gCAAgC;IAChC,iBAAiB,EAAE,iBAAiB,CAAC;IAErC,yBAAyB;IACzB,OAAO,EAAE,gBAAgB,CAAC;IAE1B,wBAAwB;IACxB,MAAM,EAAE,cAAc,EAAE,CAAC;IAEzB,qBAAqB;IACrB,aAAa,EAAE,aAAa,CAAC;IAE7B,oBAAoB;IACpB,YAAY,EAAE,YAAY,CAAC;IAE3B,oBAAoB;IACpB,YAAY,EAAE,YAAY,CAAC;IAE3B,wBAAwB;IACxB,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC,wBAAwB;IACxB,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,iBAAiB;IACjB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAE1B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IAEb,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,uBAAuB;IACvB,UAAU,CAAC,EAAE,2BAA2B,CAAC;IAEzC,uBAAuB;IACvB,UAAU,CAAC,EAAE;QACX,sBAAsB;QACtB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;QAElC,wBAAwB;QACxB,MAAM,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;KAChC,CAAC;CACH;AAED,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC;IAEjC,mBAAmB;IACnB,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IAEpC,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC;IAEhC,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,qBAAqB,GAAG,oBAAoB,CAAC;AAE1E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClC,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;QACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sBAAsB,CAAC,EAAE;QACvB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,2BAA4B,SAAQ,+BAA+B;IAClF,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,gCAAgC,GAAG,2BAA2B,CAAC;AAElG,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,8BAA8B,CAAC;IACxC,SAAS,CAAC,EAAE,iCAAiC,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IAEb,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAE5B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAEhC,uCAAuC;IACvC,oBAAoB,EAAE,MAAM,CAAC;IAE7B,GAAG,CAAC,EAAE,kBAAkB,CAAC;IAEzB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAEpC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B"}

package/dist/webserver/webserver.interface.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/webserver/webserver.interface.ts"],
-  "sourcesContent": ["import type { HTTPMethods } from 'fastify';\nimport type { DatabaseInstance } from '../database/index.js';\nimport type { QueueManager } from '../queue/index.js';\nimport type { RedisInstance } from '../redis/index.js';\nimport type { WebServerBaseControllerType } from './controller/base.interface.js';\nimport type { ApplicationConfig } from '../application/base-application.interface.js';\nimport type EventManager from '../event/manager.js';\n\nexport interface WebServerConstructorParams {\n  /** Application configuration */\n  applicationConfig: ApplicationConfig;\n\n  /** Web server options */\n  options: WebServerOptions;\n\n  /** Web server routes */\n  routes: WebServerRoute[];\n\n  /** Redis instance */\n  redisInstance: RedisInstance;\n\n  /** Queue manager */\n  queueManager: QueueManager;\n\n  /** Event manager */\n  eventManager: EventManager;\n\n  /** Database instance */\n  databaseInstance: DatabaseInstance;\n}\n\nexport enum WebServerRouteType {\n  Default = 'default',\n  Entity = 'entity',\n}\n\nexport interface BaseWebServerRoute {\n  /** Route type */\n  type?: WebServerRouteType;\n\n  /** Route path */\n  path: string;\n\n  /** Route controller name */\n  controllerName?: string;\n\n  /** Route controller */\n  controller?: WebServerBaseControllerType;\n\n  /** Route validation */\n  validation?: {\n    /** Validation type */\n    type: 'body' | 'query' | 'params';\n\n    /** Validation schema */\n    schema: { [key: string]: any };\n  };\n}\n\nexport interface DefaultWebServerRoute extends BaseWebServerRoute {\n  type: WebServerRouteType.Default;\n\n  /** Route method */\n  method: HTTPMethods | HTTPMethods[];\n\n  /** Route action */\n  action: string;\n}\n\nexport interface EntityWebServerRoute extends BaseWebServerRoute {\n  type: WebServerRouteType.Entity;\n\n  /** Entity name */\n  entityName: string;\n}\n\nexport type WebServerRoute = DefaultWebServerRoute | EntityWebServerRoute;\n\nexport interface RouteValidationSchema {\n  type: 'body' | 'query' | 'params';\n  schema: {\n    type: 'object';\n    properties: { [key: string]: any };\n    required: string[];\n  };\n}\n\nexport interface EntityRouteDefinition {\n  path: string;\n  method: HTTPMethods | HTTPMethods[];\n  action: string;\n  validationSchema?: RouteValidationSchema;\n}\n\nexport interface WebServerLogConfig {\n  startUp?: boolean;\n}\n\nexport interface WebServerDebugOptions {\n  printRoutes?: boolean;\n  simulateSlowConnection?: {\n    enabled?: boolean;\n    delay?: number;\n  };\n}\n\nexport interface WebServerCorsBaseOptions {\n  /** Whether CORS is enabled */\n  enabled: boolean;\n}\n\nexport interface WebServerCorsDisabledOptionsBase {\n  enabled: false;\n}\n\nexport interface WebServerCorsEnabledOptionsBase {\n  enabled: true;\n}\n\nexport interface WebServerCorsEnabledOptions extends WebServerCorsEnabledOptionsBase {\n  urls: string[];\n}\n\nexport type WebServerCorsOptions = WebServerCorsDisabledOptionsBase | WebServerCorsEnabledOptions;\n\nexport interface WebServerErrorsOptions {\n  verbose: boolean;\n}\n\nexport interface WebServerOptions {\n  /** Web server host */\n  host: string;\n\n  /** Web server port */\n  port: number;\n\n  /** Web server CORS options */\n  cors?: WebServerCorsOptions;\n\n  /** Web server error options */\n  errors?: WebServerErrorsOptions;\n\n  /** Web server controllers directory */\n  controllersDirectory: string;\n\n  log?: WebServerLogConfig;\n\n  /** Web server debug options */\n  debug?: WebServerDebugOptions;\n}\n\n// export interface WebServerLogParams {\n//   /** Method */\n//   Method: string;\n\n//   /** Path */\n//   Path: string;\n\n//   /** Status code */\n//   Status: number;\n\n//   /** IP address */\n//   IP?: string;\n\n//   /** Execution time */\n//   Time?: string;\n\n//   [key: string]: unknown;\n// }\n"],
-  "mappings": "AA+BO,IAAK,qBAAL,kBAAKA,wBAAL;AACL,EAAAA,oBAAA,aAAU;AACV,EAAAA,oBAAA,YAAS;AAFC,SAAAA;AAAA,GAAA;",
+  "sourcesContent": ["import type { HTTPMethods } from 'fastify';\nimport type { DatabaseInstance } from '../database/index.js';\nimport type { QueueManager } from '../queue/index.js';\nimport type { RedisInstance } from '../redis/index.js';\nimport type { WebServerBaseControllerType } from './controller/base.interface.js';\nimport type { ApplicationConfig } from '../application/base-application.interface.js';\nimport type EventManager from '../event/manager.js';\nimport type { LifecycleManager } from '../lifecycle/lifecycle-manager.js';\n\nexport interface WebServerConstructorParams {\n  /** Application configuration */\n  applicationConfig: ApplicationConfig;\n\n  /** Web server options */\n  options: WebServerOptions;\n\n  /** Web server routes */\n  routes: WebServerRoute[];\n\n  /** Redis instance */\n  redisInstance: RedisInstance;\n\n  /** Queue manager */\n  queueManager: QueueManager;\n\n  /** Event manager */\n  eventManager: EventManager;\n\n  /** Database instance */\n  databaseInstance: DatabaseInstance;\n\n  /** Lifecycle manager */\n  lifecycleManager: LifecycleManager;\n}\n\nexport enum WebServerRouteType {\n  Default = 'default',\n  Entity = 'entity',\n}\n\nexport interface BaseWebServerRoute {\n  /** Route type */\n  type?: WebServerRouteType;\n\n  /** Route path */\n  path: string;\n\n  /** Route controller name */\n  controllerName?: string;\n\n  /** Route controller */\n  controller?: WebServerBaseControllerType;\n\n  /** Route validation */\n  validation?: {\n    /** Validation type */\n    type: 'body' | 'query' | 'params';\n\n    /** Validation schema */\n    schema: { [key: string]: any };\n  };\n}\n\nexport interface DefaultWebServerRoute extends BaseWebServerRoute {\n  type: WebServerRouteType.Default;\n\n  /** Route method */\n  method: HTTPMethods | HTTPMethods[];\n\n  /** Route action */\n  action: string;\n}\n\nexport interface EntityWebServerRoute extends BaseWebServerRoute {\n  type: WebServerRouteType.Entity;\n\n  /** Entity name */\n  entityName: string;\n}\n\nexport type WebServerRoute = DefaultWebServerRoute | EntityWebServerRoute;\n\nexport interface RouteValidationSchema {\n  type: 'body' | 'query' | 'params';\n  schema: {\n    type: 'object';\n    properties: { [key: string]: any };\n    required: string[];\n  };\n}\n\nexport interface EntityRouteDefinition {\n  path: string;\n  method: HTTPMethods | HTTPMethods[];\n  action: string;\n  validationSchema?: RouteValidationSchema;\n}\n\nexport interface WebServerLogConfig {\n  startUp?: boolean;\n}\n\nexport interface WebServerDebugOptions {\n  printRoutes?: boolean;\n  simulateSlowConnection?: {\n    enabled?: boolean;\n    delay?: number;\n  };\n}\n\nexport interface WebServerCorsBaseOptions {\n  /** Whether CORS is enabled */\n  enabled: boolean;\n}\n\nexport interface WebServerCorsDisabledOptionsBase {\n  enabled: false;\n}\n\nexport interface WebServerCorsEnabledOptionsBase {\n  enabled: true;\n}\n\nexport interface WebServerCorsEnabledOptions extends WebServerCorsEnabledOptionsBase {\n  urls: string[];\n}\n\nexport type WebServerCorsOptions = WebServerCorsDisabledOptionsBase | WebServerCorsEnabledOptions;\n\nexport interface WebServerErrorsOptions {\n  verbose: boolean;\n}\n\nexport interface WebServerSecurityHelmetOptions {\n  enabled?: boolean;\n  contentSecurityPolicy?: boolean;\n  crossOriginEmbedderPolicy?: boolean;\n  crossOriginOpenerPolicy?: boolean;\n  crossOriginResourcePolicy?: boolean;\n  dnsPrefetchControl?: boolean;\n  frameguard?: boolean;\n  hidePoweredBy?: boolean;\n  hsts?: boolean;\n  ieNoOpen?: boolean;\n  noSniff?: boolean;\n  originAgentCluster?: boolean;\n  permittedCrossDomainPolicies?: boolean;\n  referrerPolicy?: boolean;\n  xssFilter?: boolean;\n}\n\nexport interface WebServerSecurityRateLimitOptions {\n  enabled?: boolean;\n  max?: number;\n  timeWindow?: string;\n  ban?: number;\n  cache?: number;\n}\n\nexport interface WebServerSecurityOptions {\n  helmet?: WebServerSecurityHelmetOptions;\n  rateLimit?: WebServerSecurityRateLimitOptions;\n}\n\nexport interface WebServerOptions {\n  /** Web server host */\n  host: string;\n\n  /** Web server port */\n  port: number;\n\n  /** Maximum request body size in bytes (default: 100MB) */\n  bodyLimit?: number;\n\n  /** Connection timeout in milliseconds (default: 30s) */\n  connectionTimeout?: number;\n\n  /** Web server CORS options */\n  cors?: WebServerCorsOptions;\n\n  /** Web server error options */\n  errors?: WebServerErrorsOptions;\n\n  /** Web server controllers directory */\n  controllersDirectory: string;\n\n  log?: WebServerLogConfig;\n\n  /** Web server security options (helmet, rate limiting) */\n  security?: WebServerSecurityOptions;\n\n  /** Web server debug options */\n  debug?: WebServerDebugOptions;\n}\n\n// export interface WebServerLogParams {\n//   /** Method */\n//   Method: string;\n\n//   /** Path */\n//   Path: string;\n\n//   /** Status code */\n//   Status: number;\n\n//   /** IP address */\n//   IP?: string;\n\n//   /** Execution time */\n//   Time?: string;\n\n//   [key: string]: unknown;\n// }\n"],
+  "mappings": "AAmCO,IAAK,qBAAL,kBAAKA,wBAAL;AACL,EAAAA,oBAAA,aAAU;AACV,EAAAA,oBAAA,YAAS;AAFC,SAAAA;AAAA,GAAA;",
   "names": ["WebServerRouteType"]
 }