@scpxl/nodejs-framework 1.0.22 → 1.0.25

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

@@ -0,0 +1,18 @@
+import type { ClusterManagerProps } from './cluster-manager.interface.js';
+export default class ClusterManager {
+    private readonly config;
+    private startApplicationCallback;
+    private stopApplicationCallback;
+    private shutdownSignals;
+    private isShuttingDown;
+    private initialWorkerCount;
+    private shutdownTimeout;
+    private shutdownTimer?;
+    constructor({ config, startApplicationCallback, stopApplicationCallback }: ClusterManagerProps);
+    start(): void;
+    private setupPrimary;
+    private setupWorker;
+    private handleShutdown;
+    private initiateShutdown;
+}
+//# sourceMappingURL=cluster-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-manager.d.ts","sourceRoot":"","sources":["../../src/cluster/cluster-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,mBAAmB,EAEpB,MAAM,gCAAgC,CAAC;AAIxC,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAE9C,OAAO,CAAC,wBAAwB,CAAsB;IACtD,OAAO,CAAC,uBAAuB,CAAsB;IAErD,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAC,CAAiB;gBAE3B,EAAE,MAAM,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,EAAE,mBAAmB;IAOvF,KAAK,IAAI,IAAI;IAUpB,OAAO,CAAC,YAAY;YAiDN,WAAW;IAkBzB,OAAO,CAAC,cAAc;YAMR,gBAAgB;CA2D/B"}

package/dist/cluster/cluster-manager.interface.d.ts

@@ -0,0 +1,23 @@
+export type ClusterWorkerMode = 'auto' | 'manual';
+export interface ClusterManagerDisabledConfig {
+    enabled: false;
+    workerMode?: ClusterWorkerMode;
+    workerCount?: never;
+}
+export interface ClusterManagerEnabledConfigBase {
+    enabled: true;
+}
+export interface ClusterManagerWorkerModeAutoConfig extends ClusterManagerEnabledConfigBase {
+    workerMode: 'auto';
+}
+export interface ClusterManagerWorkerModeManualConfig extends ClusterManagerEnabledConfigBase {
+    workerMode: 'manual';
+    workerCount: number;
+}
+export type ClusterManagerConfig = ClusterManagerDisabledConfig | ClusterManagerWorkerModeAutoConfig | ClusterManagerWorkerModeManualConfig;
+export interface ClusterManagerProps {
+    config: ClusterManagerConfig;
+    startApplicationCallback: () => Promise<void>;
+    stopApplicationCallback: () => Promise<void>;
+}
+//# sourceMappingURL=cluster-manager.interface.d.ts.map

package/dist/cluster/cluster-manager.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-manager.interface.d.ts","sourceRoot":"","sources":["../../src/cluster/cluster-manager.interface.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,KAAK,CAAC;IACf,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,kCAAmC,SAAQ,+BAA+B;IACzF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oCAAqC,SAAQ,+BAA+B;IAC3F,UAAU,EAAE,QAAQ,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,oBAAoB,GAC5B,4BAA4B,GAC5B,kCAAkC,GAClC,oCAAoC,CAAC;AAEzC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,oBAAoB,CAAC;IAE7B,wBAAwB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,uBAAuB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C"}

package/dist/cluster/cluster-manager.js

@@ -13,6 +13,10 @@ class ClusterManager {
   stopApplicationCallback;
   shutdownSignals = ["SIGTERM", "SIGINT"];
   isShuttingDown = false;
+  initialWorkerCount = 0;
+  shutdownTimeout = 3e4;
+  // 30 seconds
+  shutdownTimer;
   constructor({ config, startApplicationCallback, stopApplicationCallback }) {
     this.config = config;
     this.startApplicationCallback = startApplicationCallback;
@@ -29,6 +33,7 @@ class ClusterManager {
   setupPrimary() {
     const numCPUs = cpus().length;
     const numClusterWorkers = this.config.workerMode === "auto" ? numCPUs : this.config.workerCount;
+    this.initialWorkerCount = numClusterWorkers;
     for (let workerIndex = 0; workerIndex < numClusterWorkers; workerIndex++) {
       cluster.fork();
     }
@@ -41,8 +46,17 @@ class ClusterManager {
         }
       });
     });
-    cluster.on("exit", () => {
+    cluster.on("exit", (worker, code, signal) => {
       if (!this.isShuttingDown) {
+        Logger.warn({
+          message: "Cluster worker died unexpectedly, restarting",
+          meta: {
+            ID: worker.id,
+            PID: worker.process.pid,
+            exitCode: code,
+            signal
+          }
+        });
         cluster.fork();
       }
     });
@@ -80,18 +94,41 @@ class ClusterManager {
     }
     this.isShuttingDown = true;
     if (cluster.isPrimary) {
-      Object.values(cluster.workers ?? {}).forEach((worker) => {
-        if (worker) {
-          worker.send("shutdown");
-        }
+      Logger.info({
+        message: "Initiating cluster shutdown",
+        meta: { workerCount: this.initialWorkerCount }
       });
       let exitedWorkers = 0;
-      cluster.on("exit", () => {
+      const exitHandler = /* @__PURE__ */ __name(() => {
         exitedWorkers++;
-        const numClusterWorkers = Object.values(cluster.workers ?? {}).filter(Boolean).length;
-        if (exitedWorkers === numClusterWorkers) {
+        Logger.debug({
+          message: "Cluster worker exited during shutdown",
+          meta: { exitedWorkers, totalWorkers: this.initialWorkerCount }
+        });
+        if (exitedWorkers === this.initialWorkerCount) {
+          if (this.shutdownTimer) {
+            clearTimeout(this.shutdownTimer);
+          }
+          Logger.info({ message: "All cluster workers exited gracefully" });
           requestExit({ code: 0, reason: "cluster-workers-exited" });
         }
+      }, "exitHandler");
+      cluster.on("exit", exitHandler);
+      this.shutdownTimer = setTimeout(() => {
+        Logger.warn({
+          message: "Cluster shutdown timeout reached, forcing exit",
+          meta: {
+            exitedWorkers,
+            totalWorkers: this.initialWorkerCount,
+            timeoutMs: this.shutdownTimeout
+          }
+        });
+        requestExit({ code: 1, reason: "cluster-shutdown-timeout" });
+      }, this.shutdownTimeout);
+      Object.values(cluster.workers ?? {}).forEach((worker) => {
+        if (worker) {
+          worker.send("shutdown");
+        }
       });
     } else {
       await this.stopApplicationCallback();

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/cluster/cluster-manager.ts"],
-  "sourcesContent": ["import cluster from 'node:cluster';\nimport { cpus } from 'node:os';\nimport type {\n  ClusterManagerConfig,\n  ClusterManagerProps,\n  ClusterManagerWorkerModeManualConfig,\n} from './cluster-manager.interface.js';\nimport { Logger } from '../logger/index.js';\nimport { requestExit } from '../lifecycle/exit.js';\n\nexport default class ClusterManager {\n  private readonly config: ClusterManagerConfig;\n\n  private startApplicationCallback: () => Promise<void>;\n  private stopApplicationCallback: () => Promise<void>;\n\n  private shutdownSignals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT'];\n  private isShuttingDown = false;\n\n  constructor({ config, startApplicationCallback, stopApplicationCallback }: ClusterManagerProps) {\n    this.config = config;\n\n    this.startApplicationCallback = startApplicationCallback;\n    this.stopApplicationCallback = stopApplicationCallback;\n  }\n\n  public start(): void {\n    if (cluster.isPrimary) {\n      this.setupPrimary();\n    } else {\n      this.setupWorker();\n    }\n\n    this.handleShutdown();\n  }\n\n  private setupPrimary(): void {\n    const numCPUs: number = cpus().length;\n\n    const numClusterWorkers =\n      this.config.workerMode === 'auto' ? numCPUs : (this.config as ClusterManagerWorkerModeManualConfig).workerCount;\n\n    for (let workerIndex = 0; workerIndex < numClusterWorkers; workerIndex++) {\n      cluster.fork();\n    }\n\n    cluster.on('online', worker => {\n      Logger.debug({\n        message: 'Started cluster worker',\n        meta: {\n          ID: worker.id,\n          PID: worker.process.pid,\n        },\n      });\n    });\n\n    cluster.on('exit', () => {\n      if (!this.isShuttingDown) {\n        // Restart worker on unexpected exit\n        cluster.fork();\n      }\n    });\n\n    Logger.debug({\n      message: 'Started cluster master',\n      meta: {\n        Mode: this.config.workerMode,\n        'Worker Count': numClusterWorkers,\n        CPUs: numCPUs,\n      },\n    });\n  }\n\n  private async setupWorker(): Promise<void> {\n    await this.startApplicationCallback();\n\n    process.on('message', async message => {\n      if (message === 'shutdown') {\n        Logger.debug({\n          message: 'Worker received shutdown message, stopping...',\n          meta: {\n            PID: process.pid,\n          },\n        });\n\n        // Stop application\n        await this.stopApplicationCallback();\n      }\n    });\n  }\n\n  private handleShutdown(): void {\n    this.shutdownSignals.forEach(signal => {\n      process.on(signal, async () => await this.initiateShutdown());\n    });\n  }\n\n  private async initiateShutdown(): Promise<void> {\n    if (this.isShuttingDown) {\n      return;\n    }\n\n    this.isShuttingDown = true;\n\n    if (cluster.isPrimary) {\n      Object.values(cluster.workers ?? {}).forEach(worker => {\n        if (worker) {\n          worker.send('shutdown');\n        }\n      });\n\n      let exitedWorkers = 0;\n\n      cluster.on('exit', () => {\n        exitedWorkers++;\n\n        const numClusterWorkers = Object.values(cluster.workers ?? {}).filter(Boolean).length;\n\n        if (exitedWorkers === numClusterWorkers) {\n          requestExit({ code: 0, reason: 'cluster-workers-exited' });\n        }\n      });\n    } else {\n      await this.stopApplicationCallback();\n    }\n  }\n}\n"],
-  "mappings": ";;AAAA,OAAO,aAAa;AACpB,SAAS,YAAY;AAMrB,SAAS,cAAc;AACvB,SAAS,mBAAmB;AAE5B,MAAO,eAA6B;AAAA,EAVpC,OAUoC;AAAA;AAAA;AAAA,EACjB;AAAA,EAET;AAAA,EACA;AAAA,EAEA,kBAAoC,CAAC,WAAW,QAAQ;AAAA,EACxD,iBAAiB;AAAA,EAEzB,YAAY,EAAE,QAAQ,0BAA0B,wBAAwB,GAAwB;AAC9F,SAAK,SAAS;AAEd,SAAK,2BAA2B;AAChC,SAAK,0BAA0B;AAAA,EACjC;AAAA,EAEO,QAAc;AACnB,QAAI,QAAQ,WAAW;AACrB,WAAK,aAAa;AAAA,IACpB,OAAO;AACL,WAAK,YAAY;AAAA,IACnB;AAEA,SAAK,eAAe;AAAA,EACtB;AAAA,EAEQ,eAAqB;AAC3B,UAAM,UAAkB,KAAK,EAAE;AAE/B,UAAM,oBACJ,KAAK,OAAO,eAAe,SAAS,UAAW,KAAK,OAAgD;AAEtG,aAAS,cAAc,GAAG,cAAc,mBAAmB,eAAe;AACxE,cAAQ,KAAK;AAAA,IACf;AAEA,YAAQ,GAAG,UAAU,YAAU;AAC7B,aAAO,MAAM;AAAA,QACX,SAAS;AAAA,QACT,MAAM;AAAA,UACJ,IAAI,OAAO;AAAA,UACX,KAAK,OAAO,QAAQ;AAAA,QACtB;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAED,YAAQ,GAAG,QAAQ,MAAM;AACvB,UAAI,CAAC,KAAK,gBAAgB;AAExB,gBAAQ,KAAK;AAAA,MACf;AAAA,IACF,CAAC;AAED,WAAO,MAAM;AAAA,MACX,SAAS;AAAA,MACT,MAAM;AAAA,QACJ,MAAM,KAAK,OAAO;AAAA,QAClB,gBAAgB;AAAA,QAChB,MAAM;AAAA,MACR;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,cAA6B;AACzC,UAAM,KAAK,yBAAyB;AAEpC,YAAQ,GAAG,WAAW,OAAM,YAAW;AACrC,UAAI,YAAY,YAAY;AAC1B,eAAO,MAAM;AAAA,UACX,SAAS;AAAA,UACT,MAAM;AAAA,YACJ,KAAK,QAAQ;AAAA,UACf;AAAA,QACF,CAAC;AAGD,cAAM,KAAK,wBAAwB;AAAA,MACrC;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEQ,iBAAuB;AAC7B,SAAK,gBAAgB,QAAQ,YAAU;AACrC,cAAQ,GAAG,QAAQ,YAAY,MAAM,KAAK,iBAAiB,CAAC;AAAA,IAC9D,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,mBAAkC;AAC9C,QAAI,KAAK,gBAAgB;AACvB;AAAA,IACF;AAEA,SAAK,iBAAiB;AAEtB,QAAI,QAAQ,WAAW;AACrB,aAAO,OAAO,QAAQ,WAAW,CAAC,CAAC,EAAE,QAAQ,YAAU;AACrD,YAAI,QAAQ;AACV,iBAAO,KAAK,UAAU;AAAA,QACxB;AAAA,MACF,CAAC;AAED,UAAI,gBAAgB;AAEpB,cAAQ,GAAG,QAAQ,MAAM;AACvB;AAEA,cAAM,oBAAoB,OAAO,OAAO,QAAQ,WAAW,CAAC,CAAC,EAAE,OAAO,OAAO,EAAE;AAE/E,YAAI,kBAAkB,mBAAmB;AACvC,sBAAY,EAAE,MAAM,GAAG,QAAQ,yBAAyB,CAAC;AAAA,QAC3D;AAAA,MACF,CAAC;AAAA,IACH,OAAO;AACL,YAAM,KAAK,wBAAwB;AAAA,IACrC;AAAA,EACF;AACF;",
+  "sourcesContent": ["import cluster from 'node:cluster';\nimport { cpus } from 'node:os';\nimport type {\n  ClusterManagerConfig,\n  ClusterManagerProps,\n  ClusterManagerWorkerModeManualConfig,\n} from './cluster-manager.interface.js';\nimport { Logger } from '../logger/index.js';\nimport { requestExit } from '../lifecycle/exit.js';\n\nexport default class ClusterManager {\n  private readonly config: ClusterManagerConfig;\n\n  private startApplicationCallback: () => Promise<void>;\n  private stopApplicationCallback: () => Promise<void>;\n\n  private shutdownSignals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT'];\n  private isShuttingDown = false;\n  private initialWorkerCount = 0;\n  private shutdownTimeout = 30000; // 30 seconds\n  private shutdownTimer?: NodeJS.Timeout;\n\n  constructor({ config, startApplicationCallback, stopApplicationCallback }: ClusterManagerProps) {\n    this.config = config;\n\n    this.startApplicationCallback = startApplicationCallback;\n    this.stopApplicationCallback = stopApplicationCallback;\n  }\n\n  public start(): void {\n    if (cluster.isPrimary) {\n      this.setupPrimary();\n    } else {\n      this.setupWorker();\n    }\n\n    this.handleShutdown();\n  }\n\n  private setupPrimary(): void {\n    const numCPUs: number = cpus().length;\n\n    const numClusterWorkers =\n      this.config.workerMode === 'auto' ? numCPUs : (this.config as ClusterManagerWorkerModeManualConfig).workerCount;\n\n    // Track initial worker count for shutdown\n    this.initialWorkerCount = numClusterWorkers;\n\n    for (let workerIndex = 0; workerIndex < numClusterWorkers; workerIndex++) {\n      cluster.fork();\n    }\n\n    cluster.on('online', worker => {\n      Logger.debug({\n        message: 'Started cluster worker',\n        meta: {\n          ID: worker.id,\n          PID: worker.process.pid,\n        },\n      });\n    });\n\n    cluster.on('exit', (worker, code, signal) => {\n      if (!this.isShuttingDown) {\n        // Restart worker on unexpected exit\n        Logger.warn({\n          message: 'Cluster worker died unexpectedly, restarting',\n          meta: {\n            ID: worker.id,\n            PID: worker.process.pid,\n            exitCode: code,\n            signal,\n          },\n        });\n        cluster.fork();\n      }\n    });\n\n    Logger.debug({\n      message: 'Started cluster master',\n      meta: {\n        Mode: this.config.workerMode,\n        'Worker Count': numClusterWorkers,\n        CPUs: numCPUs,\n      },\n    });\n  }\n\n  private async setupWorker(): Promise<void> {\n    await this.startApplicationCallback();\n\n    process.on('message', async message => {\n      if (message === 'shutdown') {\n        Logger.debug({\n          message: 'Worker received shutdown message, stopping...',\n          meta: {\n            PID: process.pid,\n          },\n        });\n\n        // Stop application\n        await this.stopApplicationCallback();\n      }\n    });\n  }\n\n  private handleShutdown(): void {\n    this.shutdownSignals.forEach(signal => {\n      process.on(signal, async () => await this.initiateShutdown());\n    });\n  }\n\n  private async initiateShutdown(): Promise<void> {\n    if (this.isShuttingDown) {\n      return;\n    }\n\n    this.isShuttingDown = true;\n\n    if (cluster.isPrimary) {\n      Logger.info({\n        message: 'Initiating cluster shutdown',\n        meta: { workerCount: this.initialWorkerCount },\n      });\n\n      let exitedWorkers = 0;\n\n      // Set up exit handler BEFORE sending shutdown messages to avoid race condition\n      const exitHandler = () => {\n        exitedWorkers++;\n\n        Logger.debug({\n          message: 'Cluster worker exited during shutdown',\n          meta: { exitedWorkers, totalWorkers: this.initialWorkerCount },\n        });\n\n        if (exitedWorkers === this.initialWorkerCount) {\n          if (this.shutdownTimer) {\n            clearTimeout(this.shutdownTimer);\n          }\n          Logger.info({ message: 'All cluster workers exited gracefully' });\n          requestExit({ code: 0, reason: 'cluster-workers-exited' });\n        }\n      };\n\n      // Attach exit listener first\n      cluster.on('exit', exitHandler);\n\n      // Set shutdown timeout\n      this.shutdownTimer = setTimeout(() => {\n        Logger.warn({\n          message: 'Cluster shutdown timeout reached, forcing exit',\n          meta: {\n            exitedWorkers,\n            totalWorkers: this.initialWorkerCount,\n            timeoutMs: this.shutdownTimeout,\n          },\n        });\n        requestExit({ code: 1, reason: 'cluster-shutdown-timeout' });\n      }, this.shutdownTimeout);\n\n      // Now send shutdown messages to all workers\n      Object.values(cluster.workers ?? {}).forEach(worker => {\n        if (worker) {\n          worker.send('shutdown');\n        }\n      });\n    } else {\n      await this.stopApplicationCallback();\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cluster/index.d.ts

@@ -0,0 +1,2 @@
+export { ClusterManagerConfig, ClusterManagerDisabledConfig, ClusterManagerWorkerModeAutoConfig, ClusterManagerWorkerModeManualConfig, type ClusterWorkerMode, } from './cluster-manager.interface.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cluster/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,kCAAkC,EAClC,oCAAoC,EACpC,KAAK,iBAAiB,GACvB,MAAM,gCAAgC,CAAC"}

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

@@ -0,0 +1,19 @@
+import { type Argv } from 'yargs';
+declare class CommandManager {
+    argv: Argv;
+    constructor();
+    addCommand({ command, description, builder, handler, }: {
+        command: string;
+        description: string;
+        builder: (yargs: Argv) => Argv;
+        handler: (argv: any) => void;
+    }): this;
+    addOption({ option, description, type, }: {
+        option: string;
+        description: string;
+        type: 'string' | 'boolean' | 'number';
+    }): this;
+    parse(): void;
+}
+export default CommandManager;
+//# sourceMappingURL=command-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-manager.d.ts","sourceRoot":"","sources":["../../src/command/command-manager.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,IAAI,EAAE,MAAM,OAAO,CAAC;AAGzC,cAAM,cAAc;IACX,IAAI,EAAE,IAAI,CAAC;;IAQX,UAAU,CAAC,EAChB,OAAO,EACP,WAAW,EACX,OAAO,EACP,OAAO,GACR,EAAE;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,CAAC;QAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;KAC9B,GAAG,IAAI;IAMD,SAAS,CAAC,EACf,MAAM,EACN,WAAW,EACX,IAAI,GACL,EAAE;QACD,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;KACvC,GAAG,IAAI;IASD,KAAK,IAAI,IAAI;CAGrB;AAED,eAAe,cAAc,CAAC"}

package/dist/command/command.d.ts

@@ -0,0 +1,27 @@
+import type { ApplicationConfig } from '../application/base-application.interface.js';
+import type DatabaseInstance from '../database/instance.js';
+import type { QueueManager } from '../queue/index.js';
+import type RedisInstance from '../redis/instance.js';
+import type { CommandConstructorParams } from './command.interface.js';
+import { Logger } from '../logger/index.js';
+export default abstract class Command {
+    /** Command name */
+    abstract name: string;
+    /** Command description */
+    abstract description: string;
+    protected applicationConfig: ApplicationConfig;
+    protected redisInstance: RedisInstance;
+    protected queueManager: QueueManager;
+    protected databaseInstance: DatabaseInstance;
+    protected logger: typeof Logger;
+    constructor({ applicationConfig, redisInstance, queueManager, databaseInstance }: CommandConstructorParams);
+    /**
+     * Run command
+     */
+    abstract run(argv?: unknown): Promise<void>;
+    /**
+     * Log command message
+     */
+    log(message: string, meta?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=command.d.ts.map

package/dist/command/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/command/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,OAAO;IACnC,mBAAmB;IACnB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,0BAA0B;IAC1B,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAE/C,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAE7C,SAAS,CAAC,MAAM,EAAE,OAAO,MAAM,CAAC;gBAEpB,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAAE,wBAAwB;IAU1G;;OAEG;aACa,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAElD;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAUlE"}

package/dist/command/command.interface.d.ts

@@ -0,0 +1,11 @@
+import type { ApplicationConfig } from '../application/base-application.interface.js';
+import type DatabaseInstance from '../database/instance.js';
+import type { QueueManager } from '../queue/index.js';
+import type RedisInstance from '../redis/instance.js';
+export interface CommandConstructorParams {
+    applicationConfig: ApplicationConfig;
+    redisInstance: RedisInstance;
+    queueManager: QueueManager;
+    databaseInstance: DatabaseInstance;
+}
+//# sourceMappingURL=command.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.interface.d.ts","sourceRoot":"","sources":["../../src/command/command.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,EAAE,iBAAiB,CAAC;IAErC,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC"}

package/dist/command/index.d.ts

@@ -0,0 +1,3 @@
+export { default as Command } from './command.js';
+export { default as CommandManager } from './command-manager.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/config/env.d.ts

@@ -0,0 +1,11 @@
+import { type InferFrameworkConfig } from './schema.js';
+/**
+ * Load a partial framework configuration from environment variables. This is intentionally
+ * conservative: only widely useful primitives are supported. Complex structures (e.g. routes)
+ * should be defined in code and merged before validation.
+ *
+ * Naming convention: PXL_<SECTION>_<FIELD>
+ */
+export declare function loadFrameworkConfigFromEnv(): Partial<InferFrameworkConfig>;
+/** Deep merge helper (shallow for primitives & plain objects) */
+//# sourceMappingURL=env.d.ts.map

package/dist/config/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAsBxD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAAC,oBAAoB,CAAC,CA6F1E;AAED,iEAAiE"}

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export * from './schema.js';
+export * from './env.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}