@scpxl/nodejs-framework 1.0.13

package/dist/application/base-application.js

@@ -0,0 +1,350 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import cluster from "cluster";
+import { existsSync, readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join, resolve } from "path";
+import { DatabaseManager } from "../database/index.js";
+import QueueManager from "../queue/manager.js";
+import RedisManager from "../redis/manager.js";
+import ClusterManager from "../cluster/cluster-manager.js";
+import { OS, Time } from "../util/index.js";
+import CacheManager from "../cache/manager.js";
+import os from "os";
+import EventManager from "../event/manager.js";
+import Logger from "../logger/logger.js";
+import { PerformanceMonitor } from "../performance/performance-monitor.js";
+import { CachePerformanceWrapper, DatabasePerformanceWrapper, QueuePerformanceWrapper } from "../performance/index.js";
+class BaseApplication {
+  static {
+    __name(this, "BaseApplication");
+  }
+  /** Unique instance ID */
+  uniqueInstanceId;
+  /** Shutdown signals */
+  shutdownSignals = ["SIGTERM", "SIGINT"];
+  /** Application start time */
+  startTime = [0, 0];
+  /** Whether application is stopping */
+  isStopping = false;
+  /** Shutdown timeout (30 seconds) */
+  shutdownTimeout = 3e4;
+  /** Cache for application version to avoid repeated imports */
+  static applicationVersionCache;
+  /** Cluster worker ID */
+  workerId = cluster.isWorker && cluster.worker ? cluster.worker.id : null;
+  /** Application config */
+  config;
+  /** Application version */
+  applicationVersion;
+  /** Redis manager */
+  redisManager;
+  /** Cache manager */
+  cacheManager;
+  /** Database manager */
+  databaseManager;
+  /** Queue manager */
+  queueManager;
+  /** Event manager */
+  eventManager;
+  /** Performance monitor */
+  performanceMonitor;
+  get Name() {
+    return this.config.name;
+  }
+  /**
+   * Application constructor
+   */
+  constructor(config) {
+    const computerName = os.hostname();
+    this.uniqueInstanceId = `${config.instanceId}-${computerName}-${OS.getUniqueComputerId()}`;
+    this.config = config;
+    this.redisManager = new RedisManager({
+      applicationConfig: this.config,
+      host: this.config.redis.host,
+      port: this.config.redis.port,
+      password: this.config.redis.password
+    });
+    this.cacheManager = new CacheManager({
+      applicationConfig: this.config,
+      redisManager: this.redisManager
+    });
+    this.initializePerformanceMonitor();
+    this.setupGlobalErrorHandlers();
+    if (this.config.database && this.config.database.enabled === true) {
+      const defaultEntitiesDirectory = join(this.config.rootDirectory, "src", "database", "entities");
+      if (!this.config.database.entitiesDirectory) {
+        this.config.database.entitiesDirectory = defaultEntitiesDirectory;
+      }
+      if (!existsSync(this.config.database.entitiesDirectory)) {
+        throw new Error(`Database entities directory not found (Path: ${this.config.database.entitiesDirectory})`);
+      }
+      this.databaseManager = new DatabaseManager({
+        applicationConfig: this.config,
+        host: this.config.database.host,
+        port: this.config.database.port,
+        username: this.config.database.username,
+        password: this.config.database.password,
+        databaseName: this.config.database.databaseName,
+        entitiesDirectory: this.config.database.entitiesDirectory
+      });
+    }
+  }
+  /**
+   * Get application version
+   */
+  async getApplicationVersion() {
+    if (BaseApplication.applicationVersionCache !== void 0) {
+      return BaseApplication.applicationVersionCache;
+    }
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const packageJsonPath = resolve(__dirname, "../../package.json");
+    const fileContents = readFileSync(packageJsonPath, "utf-8");
+    const packageJson = JSON.parse(fileContents);
+    if (!packageJson?.version) {
+      throw new Error("Application version not found");
+    }
+    BaseApplication.applicationVersionCache = packageJson.version;
+    return packageJson.version;
+  }
+  /**
+   * Start application
+   */
+  async start() {
+    this.startTime = process.hrtime();
+    this.applicationVersion = await this.getApplicationVersion();
+    const startInstanceOptions = {
+      // onStarted: ({ startupTime }) => {
+      //   if (this.config.log?.startUp) {
+      //     Logger.info('Application started', {
+      //       Name: this.config.name,
+      //       'PXL Framework Version': this.applicationVersion,
+      //       'Startup Time': Time.formatTime({ time: startupTime, format: 's', numDecimals: 2, showUnit: true }),
+      //     });
+      //   }
+      //   if (this.config.events?.onStarted) {
+      //     this.config.events.onStarted({ app: this, startupTime });
+      //   }
+      // },
+      onStarted: this.onStarted.bind(this)
+    };
+    const stopInstanceOptions = {
+      // onStopped: ({ runtime }) => {
+      //   if (this.config.log?.shutdown) {
+      //     Logger.info('Application stopped', {
+      //       Name: this.config.name,
+      //       'Runtime': Time.formatTime({ time: runtime, format: 's', numDecimals: 2, showUnit: true }),
+      //     });
+      //   }
+      //   if (this.config.events?.onStopped) {
+      //     this.config.events.onStopped({ app: this, runtime });
+      //   }
+      // },
+      onStopped: this.onStopped.bind(this)
+    };
+    if (this.config.cluster?.enabled) {
+      const clusterManager = new ClusterManager({
+        config: this.config.cluster,
+        startApplicationCallback: /* @__PURE__ */ __name(() => this.startInstance(startInstanceOptions), "startApplicationCallback"),
+        stopApplicationCallback: /* @__PURE__ */ __name(() => this.stop(stopInstanceOptions), "stopApplicationCallback")
+      });
+      clusterManager.start();
+    } else {
+      await this.startInstance(startInstanceOptions);
+      this.handleShutdown({
+        onStopped: stopInstanceOptions.onStopped
+      });
+    }
+  }
+  /**
+   * Before application start
+   */
+  async onBeforeStart() {
+    const redisInstance = await this.redisManager.connect();
+    const databaseInstance = this.databaseManager ? await this.databaseManager.connect() : null;
+    let eventManager;
+    if (this.config.event?.enabled) {
+      eventManager = new EventManager({
+        applicationConfig: this.config,
+        options: this.config.event,
+        events: this.config.event.events || [],
+        redisInstance,
+        databaseInstance
+        // queueManager,
+      });
+      eventManager.load();
+    }
+    const queueManager = new QueueManager({
+      applicationConfig: this.config,
+      options: {
+        processorsDirectory: this.config.queue.processorsDirectory
+      },
+      queues: this.config.queue.queues,
+      redisInstance,
+      databaseInstance,
+      eventManager
+    });
+    await queueManager.registerQueues({
+      queues: this.config.queue.queues
+    });
+    return {
+      redisInstance,
+      databaseInstance,
+      queueManager,
+      eventManager
+    };
+  }
+  /**
+   * Application started event
+   */
+  onStarted({ startupTime: _startupTime }) {
+  }
+  /**
+   * Application stopped event
+   */
+  onStopped({ runtime: _runtime }) {
+  }
+  /**
+   * Before application stop event
+   */
+  async onBeforeStop() {
+    await this.redisManager.disconnect();
+    if (this.databaseManager) {
+      await this.databaseManager.disconnect();
+    }
+  }
+  /**
+   * Start application instance
+   */
+  async startInstance(options) {
+    try {
+      const { redisInstance, databaseInstance, queueManager, eventManager } = await this.onBeforeStart();
+      await this.startHandler({
+        redisInstance,
+        databaseInstance,
+        queueManager,
+        eventManager
+      });
+      const startupTime = Time.calculateElapsedTime({
+        startTime: this.startTime
+      });
+      if (options.onStarted) {
+        await options.onStarted({ startupTime });
+      }
+    } catch (error) {
+      console.error(error);
+      process.exit(1);
+    }
+  }
+  /**
+   * Set up global error handlers
+   */
+  /**
+   * Initialize performance monitor
+   */
+  initializePerformanceMonitor() {
+    if (!this.config.performanceMonitoring?.enabled) {
+      return;
+    }
+    this.performanceMonitor = PerformanceMonitor.initialize({
+      enabled: true,
+      thresholds: this.config.performanceMonitoring.thresholds,
+      maxMetricsHistory: this.config.performanceMonitoring.maxMetricsHistory,
+      logSlowOperations: this.config.performanceMonitoring.logSlowOperations,
+      logAllOperations: this.config.performanceMonitoring.logAllOperations
+    });
+    if (this.config.performanceMonitoring.monitorDatabaseOperations !== false) {
+      DatabasePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);
+    }
+    if (this.config.performanceMonitoring.monitorQueueOperations !== false) {
+      QueuePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);
+    }
+    if (this.config.performanceMonitoring.monitorCacheOperations !== false) {
+      CachePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);
+    }
+    if (this.config.performanceMonitoring.reportInterval && this.config.performanceMonitoring.reportInterval > 0) {
+      setInterval(() => {
+        const reportFormat = this.config.performanceMonitoring?.reportFormat ?? "detailed";
+        const report = this.performanceMonitor?.generateFormattedReport(reportFormat);
+        if (report) {
+          Logger.info({ message: report });
+        }
+      }, this.config.performanceMonitoring.reportInterval);
+    }
+  }
+  setupGlobalErrorHandlers() {
+    process.on("uncaughtException", (error) => {
+      Logger.error({ error, message: "Uncaught Exception" });
+      this.initiateGracefulShutdown();
+    });
+    process.on("unhandledRejection", (reason, promise) => {
+      Logger.error({
+        error: reason instanceof Error ? reason : new Error(String(reason)),
+        message: "Unhandled Rejection",
+        meta: { promise }
+      });
+      this.initiateGracefulShutdown();
+    });
+  }
+  /**
+   * Initiate graceful shutdown
+   */
+  initiateGracefulShutdown() {
+    if (this.isStopping) {
+      return;
+    }
+    Logger.info({ message: "Initiating graceful shutdown due to error" });
+    this.stop().catch((error) => {
+      Logger.error({
+        error: error instanceof Error ? error : new Error(String(error)),
+        message: "Error during graceful shutdown"
+      });
+      process.exit(1);
+    });
+  }
+  /**
+   * Handle shutdown
+   */
+  handleShutdown({ onStopped }) {
+    this.shutdownSignals.forEach((signal) => {
+      process.on(signal, async () => {
+        await this.stop({ onStopped });
+      });
+    });
+  }
+  /**
+   * Stop application
+   */
+  async stop({ onStopped } = {}) {
+    if (this.isStopping) {
+      return;
+    }
+    this.isStopping = true;
+    const forceExitTimeout = setTimeout(() => {
+      Logger.warn({ message: "Forced shutdown due to timeout" });
+      process.exit(1);
+    }, this.shutdownTimeout);
+    try {
+      await this.stopCallback();
+      await this.onBeforeStop();
+      if (onStopped) {
+        const runtime = process.uptime() * 1e3;
+        await onStopped({ runtime });
+      }
+      clearTimeout(forceExitTimeout);
+      process.exit(0);
+    } catch (error) {
+      Logger.error({
+        error: error instanceof Error ? error : new Error(String(error)),
+        message: "Error during shutdown"
+      });
+      clearTimeout(forceExitTimeout);
+      process.exit(1);
+    }
+  }
+}
+export {
+  BaseApplication as default
+};
+//# sourceMappingURL=base-application.js.map

package/dist/application/base-application.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/application/base-application.ts"],
+  "sourcesContent": ["import cluster from 'cluster';\nimport { existsSync, readFileSync } from 'fs';\nimport { fileURLToPath } from 'url';\nimport { dirname, join, resolve } from 'path';\nimport { type DatabaseInstance, DatabaseManager } from '../database/index.js';\nimport QueueManager from '../queue/manager.js';\nimport RedisManager from '../redis/manager.js';\nimport type {\n  ApplicationConfig,\n  ApplicationStartInstanceOptions,\n  ApplicationStopInstanceOptions,\n} from './base-application.interface.js';\nimport ClusterManager from '../cluster/cluster-manager.js';\nimport type RedisInstance from '../redis/instance.js';\nimport { OS, Time } from '../util/index.js';\nimport CacheManager from '../cache/manager.js';\nimport os from 'os';\nimport EventManager from '../event/manager.js';\nimport Logger from '../logger/logger.js';\nimport { PerformanceMonitor } from '../performance/performance-monitor.js';\nimport { CachePerformanceWrapper, DatabasePerformanceWrapper, QueuePerformanceWrapper } from '../performance/index.js';\n\n// Re-export types for external use\nexport type { ApplicationConfig } from './base-application.interface.js';\n\nexport default abstract class BaseApplication {\n  /** Unique instance ID */\n  public uniqueInstanceId: string;\n\n  /** Shutdown signals */\n  protected shutdownSignals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT'];\n\n  /** Application start time */\n  protected startTime: [number, number] = [0, 0];\n\n  /** Whether application is stopping */\n  protected isStopping = false;\n\n  /** Shutdown timeout (30 seconds) */\n  protected shutdownTimeout = 30000;\n\n  /** Cache for application version to avoid repeated imports */\n  private static applicationVersionCache: string | undefined;\n\n  /** Cluster worker ID */\n  protected workerId = cluster.isWorker && cluster.worker ? cluster.worker.id : null;\n\n  /** Application config */\n  protected config: ApplicationConfig;\n\n  /** Application version */\n  protected applicationVersion?: string;\n\n  /** Redis manager */\n  public redisManager: RedisManager;\n\n  /** Cache manager */\n  public cacheManager: CacheManager;\n\n  /** Database manager */\n  public databaseManager?: DatabaseManager;\n\n  /** Queue manager */\n  public queueManager?: QueueManager;\n\n  /** Event manager */\n  public eventManager?: EventManager;\n\n  /** Performance monitor */\n  public performanceMonitor?: PerformanceMonitor;\n\n  public get Name() {\n    return this.config.name;\n  }\n\n  /**\n   * Application constructor\n   */\n  constructor(config: ApplicationConfig) {\n    const computerName = os.hostname();\n\n    this.uniqueInstanceId = `${config.instanceId}-${computerName}-${OS.getUniqueComputerId()}`;\n\n    this.config = config;\n\n    // const schema = Joi.object({\n    //   name: Joi.string().required(),\n\n    //   redis: {\n    //     host: Joi.string().required(),\n    //     port: Joi.number().required(),\n    //     password: Joi.string().allow('').optional(),\n    //   },\n\n    //   database: {\n    //     host: Joi.string().required(),\n    //     port: Joi.number().required(),\n    //     username: Joi.string().required(),\n    //     password: Joi.string().required(),\n    //     databaseName: Joi.string().required(),\n    //   },\n    // });\n\n    // // Validation application constructor props\n    // const validationResult = schema.validate(props);\n\n    // if (validationResult.error) {\n    //   throw new Error(validationResult.error.message);\n    // }\n\n    // Initialize Redis manager\n    this.redisManager = new RedisManager({\n      applicationConfig: this.config,\n      host: this.config.redis.host,\n      port: this.config.redis.port,\n      password: this.config.redis.password,\n    });\n\n    // Initialize cache manager\n    this.cacheManager = new CacheManager({\n      applicationConfig: this.config,\n      redisManager: this.redisManager,\n    });\n\n    // Initialize performance monitor\n    this.initializePerformanceMonitor();\n\n    // Set up global error handlers\n    this.setupGlobalErrorHandlers();\n\n    if (this.config.database && this.config.database.enabled === true) {\n      const defaultEntitiesDirectory = join(this.config.rootDirectory, 'src', 'database', 'entities');\n\n      if (!this.config.database.entitiesDirectory) {\n        this.config.database.entitiesDirectory = defaultEntitiesDirectory;\n      }\n\n      if (!existsSync(this.config.database.entitiesDirectory)) {\n        throw new Error(`Database entities directory not found (Path: ${this.config.database.entitiesDirectory})`);\n      }\n\n      // Initialize Database manager\n      this.databaseManager = new DatabaseManager({\n        applicationConfig: this.config,\n        host: this.config.database.host,\n        port: this.config.database.port,\n        username: this.config.database.username,\n        password: this.config.database.password,\n        databaseName: this.config.database.databaseName,\n        entitiesDirectory: this.config.database.entitiesDirectory,\n      });\n    }\n  }\n\n  /**\n   * Get application version\n   */\n  public async getApplicationVersion(): Promise<string> {\n    // Return cached version if available\n    if (BaseApplication.applicationVersionCache !== undefined) {\n      return BaseApplication.applicationVersionCache;\n    }\n\n    // Resolve the path to package.json\n    const __filename = fileURLToPath(import.meta.url);\n    const __dirname = dirname(__filename);\n    const packageJsonPath = resolve(__dirname, '../../package.json');\n\n    // Read and parse the file\n    const fileContents = readFileSync(packageJsonPath, 'utf-8');\n    const packageJson = JSON.parse(fileContents);\n\n    if (!packageJson?.version) {\n      throw new Error('Application version not found');\n    }\n\n    // Cache and return the version\n    BaseApplication.applicationVersionCache = packageJson.version;\n\n    return packageJson.version;\n  }\n\n  /**\n   * Start application\n   */\n  public async start(): Promise<void> {\n    // Start application timer\n    this.startTime = process.hrtime();\n\n    // Get application version`\n    this.applicationVersion = await this.getApplicationVersion();\n\n    const startInstanceOptions: ApplicationStartInstanceOptions = {\n      // onStarted: ({ startupTime }) => {\n      //   if (this.config.log?.startUp) {\n      //     Logger.info('Application started', {\n      //       Name: this.config.name,\n      //       'PXL Framework Version': this.applicationVersion,\n      //       'Startup Time': Time.formatTime({ time: startupTime, format: 's', numDecimals: 2, showUnit: true }),\n      //     });\n      //   }\n\n      //   if (this.config.events?.onStarted) {\n      //     this.config.events.onStarted({ app: this, startupTime });\n      //   }\n      // },\n      onStarted: this.onStarted.bind(this),\n    };\n\n    const stopInstanceOptions: ApplicationStopInstanceOptions = {\n      // onStopped: ({ runtime }) => {\n      //   if (this.config.log?.shutdown) {\n      //     Logger.info('Application stopped', {\n      //       Name: this.config.name,\n      //       'Runtime': Time.formatTime({ time: runtime, format: 's', numDecimals: 2, showUnit: true }),\n      //     });\n      //   }\n\n      //   if (this.config.events?.onStopped) {\n      //     this.config.events.onStopped({ app: this, runtime });\n      //   }\n      // },\n      onStopped: this.onStopped.bind(this),\n    };\n\n    if (this.config.cluster?.enabled) {\n      // Initialize clustered application\n      const clusterManager = new ClusterManager({\n        config: this.config.cluster,\n\n        startApplicationCallback: () => this.startInstance(startInstanceOptions),\n        stopApplicationCallback: () => this.stop(stopInstanceOptions),\n      });\n\n      // Start cluster\n      clusterManager.start();\n    } else {\n      // Start standalone application\n      await this.startInstance(startInstanceOptions);\n\n      // Handle standalone application shutdown\n      this.handleShutdown({\n        onStopped: stopInstanceOptions.onStopped,\n      });\n    }\n  }\n\n  /**\n   * Before application start\n   */\n  private async onBeforeStart(): Promise<{\n    redisInstance: RedisInstance;\n    databaseInstance: DatabaseInstance | null;\n    queueManager: QueueManager;\n    eventManager?: EventManager;\n  }> {\n    // Connect to Redis\n    const redisInstance = await this.redisManager.connect();\n\n    // Connect to database\n    const databaseInstance = this.databaseManager ? await this.databaseManager.connect() : null;\n\n    let eventManager: EventManager | undefined;\n\n    if (this.config.event?.enabled) {\n      eventManager = new EventManager({\n        applicationConfig: this.config,\n        options: this.config.event,\n        events: this.config.event.events || [],\n        redisInstance,\n        databaseInstance,\n        // queueManager,\n      });\n\n      eventManager.load();\n    }\n\n    // Initialize queue\n    const queueManager = new QueueManager({\n      applicationConfig: this.config,\n      options: {\n        processorsDirectory: this.config.queue.processorsDirectory,\n      },\n      queues: this.config.queue.queues,\n      redisInstance,\n      databaseInstance,\n      eventManager,\n    });\n\n    // Register queues\n    await queueManager.registerQueues({\n      queues: this.config.queue.queues,\n    });\n\n    return {\n      redisInstance,\n      databaseInstance,\n      queueManager,\n      eventManager,\n    };\n  }\n\n  /**\n   * Application started event\n   */\n  protected onStarted({ startupTime: _startupTime }: { startupTime: number }): void {}\n\n  /**\n   * Application stopped event\n   */\n  protected onStopped({ runtime: _runtime }: { runtime: number }): void {}\n\n  /**\n   * Before application stop event\n   */\n  private async onBeforeStop(): Promise<void> {\n    // Disconnect from Redis\n    await this.redisManager.disconnect();\n\n    if (this.databaseManager) {\n      // Disconnect from database\n      await this.databaseManager.disconnect();\n    }\n  }\n\n  /**\n   * Start application instance\n   */\n  private async startInstance(options: ApplicationStartInstanceOptions): Promise<void> {\n    try {\n      // Before application start\n      const { redisInstance, databaseInstance, queueManager, eventManager } = await this.onBeforeStart();\n\n      // Start application\n      await this.startHandler({\n        redisInstance,\n        databaseInstance,\n        queueManager,\n        eventManager,\n      });\n\n      // Calculate application startup time\n      const startupTime = Time.calculateElapsedTime({\n        startTime: this.startTime,\n      });\n\n      // On application started\n      if (options.onStarted) {\n        await options.onStarted({ startupTime });\n      }\n    } catch (error) {\n      // Log error\n      console.error(error);\n\n      process.exit(1);\n    }\n  }\n\n  protected abstract startHandler({\n    redisInstance,\n    databaseInstance,\n    queueManager,\n    eventManager,\n  }: {\n    redisInstance: RedisInstance;\n    databaseInstance?: DatabaseInstance | null;\n    queueManager: QueueManager;\n    eventManager?: EventManager | null;\n  }): Promise<void>;\n\n  protected abstract stopCallback(): void;\n\n  /**\n   * Set up global error handlers\n   */\n  /**\n   * Initialize performance monitor\n   */\n  private initializePerformanceMonitor(): void {\n    // Check if performance monitoring is enabled\n    if (!this.config.performanceMonitoring?.enabled) {\n      return;\n    }\n\n    // Initialize performance monitor with configuration\n    this.performanceMonitor = PerformanceMonitor.initialize({\n      enabled: true,\n      thresholds: this.config.performanceMonitoring.thresholds,\n      maxMetricsHistory: this.config.performanceMonitoring.maxMetricsHistory,\n      logSlowOperations: this.config.performanceMonitoring.logSlowOperations,\n      logAllOperations: this.config.performanceMonitoring.logAllOperations,\n    });\n\n    // Set up performance monitoring for different components\n    if (this.config.performanceMonitoring.monitorDatabaseOperations !== false) {\n      DatabasePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);\n    }\n\n    if (this.config.performanceMonitoring.monitorQueueOperations !== false) {\n      QueuePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);\n    }\n\n    if (this.config.performanceMonitoring.monitorCacheOperations !== false) {\n      CachePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);\n    }\n\n    // Set up periodic performance reports if configured\n    if (this.config.performanceMonitoring.reportInterval && this.config.performanceMonitoring.reportInterval > 0) {\n      setInterval(() => {\n        const reportFormat = this.config.performanceMonitoring?.reportFormat ?? 'detailed';\n        const report = this.performanceMonitor?.generateFormattedReport(reportFormat);\n\n        if (report) {\n          Logger.info({ message: report });\n        }\n      }, this.config.performanceMonitoring.reportInterval);\n    }\n  }\n\n  private setupGlobalErrorHandlers(): void {\n    // Handle uncaught exceptions\n    process.on('uncaughtException', error => {\n      Logger.error({ error, message: 'Uncaught Exception' });\n      this.initiateGracefulShutdown();\n    });\n\n    // Handle unhandled promise rejections\n    process.on('unhandledRejection', (reason, promise) => {\n      Logger.error({\n        error: reason instanceof Error ? reason : new Error(String(reason)),\n        message: 'Unhandled Rejection',\n        meta: { promise },\n      });\n      this.initiateGracefulShutdown();\n    });\n  }\n\n  /**\n   * Initiate graceful shutdown\n   */\n  private initiateGracefulShutdown(): void {\n    if (this.isStopping) {\n      return;\n    }\n\n    Logger.info({ message: 'Initiating graceful shutdown due to error' });\n    this.stop().catch(error => {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(String(error)),\n        message: 'Error during graceful shutdown',\n      });\n      process.exit(1);\n    });\n  }\n\n  /**\n   * Handle shutdown\n   */\n  public handleShutdown({ onStopped }: { onStopped?: ({ runtime }: { runtime: number }) => void }): void {\n    this.shutdownSignals.forEach(signal => {\n      process.on(signal, async () => {\n        // Stop application\n        await this.stop({ onStopped });\n      });\n    });\n  }\n\n  /**\n   * Stop application\n   */\n  private async stop({ onStopped }: ApplicationStopInstanceOptions = {}): Promise<void> {\n    if (this.isStopping) {\n      return;\n    }\n\n    this.isStopping = true;\n\n    // Set timeout for forced termination\n    const forceExitTimeout = setTimeout(() => {\n      Logger.warn({ message: 'Forced shutdown due to timeout' });\n      process.exit(1);\n    }, this.shutdownTimeout);\n\n    try {\n      // Stop callback\n      await this.stopCallback();\n\n      // Disconnect\n      await this.onBeforeStop();\n\n      if (onStopped) {\n        // Calculate runtime\n        const runtime = process.uptime() * 1000;\n\n        // Emit stopped event\n        await onStopped({ runtime });\n      }\n\n      clearTimeout(forceExitTimeout);\n      process.exit(0);\n    } catch (error) {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(String(error)),\n        message: 'Error during shutdown',\n      });\n      clearTimeout(forceExitTimeout);\n      process.exit(1);\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,18 @@
+import type DatabaseInstance from '../database/instance.js';
+import type QueueManager from '../queue/manager.js';
+import type RedisInstance from '../redis/instance.js';
+import BaseApplication from './base-application.js';
+import type { CommandApplicationConfig } from './command-application.interface.js';
+export default class CommandApplication extends BaseApplication {
+    /** Command application config */
+    protected config: CommandApplicationConfig;
+    constructor(config: CommandApplicationConfig);
+    protected startHandler({ redisInstance, databaseInstance, queueManager, }: {
+        redisInstance: RedisInstance;
+        databaseInstance: DatabaseInstance;
+        queueManager: QueueManager;
+    }): Promise<void>;
+    private stopCommand;
+    protected stopCallback(): void;
+}
+//# sourceMappingURL=command-application.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-application.d.ts","sourceRoot":"","sources":["../../src/application/command-application.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAE5D,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAC;AACtD,OAAO,eAAe,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAGnF,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,eAAe;IAC7D,iCAAiC;IACjC,SAAS,CAAC,MAAM,EAAE,wBAAwB,CAAC;gBAE/B,MAAM,EAAE,wBAAwB;cA0B5B,YAAY,CAAC,EAC3B,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,EAAE;QACD,aAAa,EAAE,aAAa,CAAC;QAC7B,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,YAAY,EAAE,YAAY,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IA4FjB,OAAO,CAAC,WAAW;IAKnB,SAAS,CAAC,YAAY,IAAI,IAAI;CAG/B"}

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

@@ -0,0 +1,26 @@
+import type CommandManager from '../command/command-manager.js';
+import type { ApplicationConfig } from './base-application.interface.js';
+import type CommandApplication from './command-application.js';
+export interface CommandApplicationEventsConfig {
+    onStarted?: ({ app, startupTime }: {
+        app: CommandApplication;
+        startupTime: number;
+    }) => void;
+    onStopped?: ({ app, runtime }: {
+        app: CommandApplication;
+        runtime: number;
+    }) => void;
+}
+export interface CommandApplicationConfig extends ApplicationConfig {
+    /** Commands directory */
+    commandsDirectory: string;
+    /** Command manager */
+    commandManager: CommandManager;
+    /** Command debug config */
+    debug?: {
+        measureExecutionTime?: boolean;
+    };
+    /** Command application events */
+    events?: CommandApplicationEventsConfig;
+}
+//# sourceMappingURL=command-application.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-application.interface.d.ts","sourceRoot":"","sources":["../../src/application/command-application.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,kBAAkB,MAAM,0BAA0B,CAAC;AAE/D,MAAM,WAAW,8BAA8B;IAC7C,SAAS,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE;QAAE,GAAG,EAAE,kBAAkB,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7F,SAAS,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;QAAE,GAAG,EAAE,kBAAkB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACtF;AAED,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,yBAAyB;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,sBAAsB;IACtB,cAAc,EAAE,cAAc,CAAC;IAE/B,2BAA2B;IAC3B,KAAK,CAAC,EAAE;QACN,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;IAEF,iCAAiC;IACjC,MAAM,CAAC,EAAE,8BAA8B,CAAC;CACzC"}

package/dist/application/command-application.interface.js

@@ -0,0 +1 @@
+//# sourceMappingURL=command-application.interface.js.map

package/dist/application/command-application.interface.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/application/command-application.js

@@ -0,0 +1,110 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { existsSync } from "fs";
+import { Logger } from "../logger/index.js";
+import BaseApplication from "./base-application.js";
+import { Helper, Loader, Time } from "../util/index.js";
+class CommandApplication extends BaseApplication {
+  static {
+    __name(this, "CommandApplication");
+  }
+  /** Command application config */
+  config;
+  constructor(config) {
+    super(config);
+    const defaultConfig = {
+      cluster: {
+        enabled: false
+      },
+      log: {
+        startUp: false
+      },
+      debug: {
+        measureExecutionTime: false
+      }
+    };
+    const mergedConfig = Helper.defaultsDeep(config, defaultConfig);
+    if (mergedConfig.cluster) {
+      mergedConfig.cluster.enabled = false;
+    }
+    this.config = mergedConfig;
+  }
+  async startHandler({
+    redisInstance,
+    databaseInstance,
+    queueManager
+  }) {
+    const startTime = performance.now();
+    const argv = this.config.commandManager.argv;
+    const parsedArgv = argv.parseSync();
+    if (parsedArgv._.length === 0) {
+      Logger.warn({ message: "No command provided" });
+      this.stopCommand();
+      return;
+    }
+    const inputCommandName = parsedArgv._[0];
+    const commandsDirectoryExists = await existsSync(this.config.commandsDirectory);
+    if (!commandsDirectoryExists) {
+      Logger.warn({
+        message: "Commands directory not found",
+        meta: {
+          Directory: this.config.commandsDirectory
+        }
+      });
+      return;
+    }
+    const commands = await Loader.loadModulesInDirectory({
+      directory: this.config.commandsDirectory,
+      extensions: [".ts", ".js"]
+    });
+    let CommandClass = null;
+    if (Object.prototype.hasOwnProperty.call(commands, inputCommandName)) {
+      CommandClass = Reflect.get(commands, inputCommandName);
+    }
+    if (!CommandClass) {
+      Logger.warn({
+        message: "Command not found",
+        meta: { Command: inputCommandName }
+      });
+      return;
+    }
+    const command = new CommandClass({
+      applicationConfig: this.config,
+      redisInstance,
+      queueManager,
+      databaseInstance
+    });
+    Logger.info({
+      message: "Command started",
+      meta: { Command: inputCommandName }
+    });
+    await command.run(parsedArgv);
+    const commandCompletedLogParams = {
+      Command: inputCommandName
+    };
+    if (this.config.debug?.measureExecutionTime) {
+      const endTime = performance.now();
+      const executionTime = endTime - startTime;
+      commandCompletedLogParams["Execution Time"] = Time.formatTime({
+        time: executionTime,
+        numDecimals: 2,
+        showUnit: true
+      });
+    }
+    Logger.info({
+      message: "Command completed",
+      meta: commandCompletedLogParams
+    });
+    this.stopCommand();
+  }
+  stopCommand() {
+    this.handleShutdown({ onStopped: this.onStopped.bind(this) });
+  }
+  stopCallback() {
+    Logger.info({ message: "Command stopped" });
+  }
+}
+export {
+  CommandApplication as default
+};
+//# sourceMappingURL=command-application.js.map

package/dist/application/command-application.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/application/command-application.ts"],
+  "sourcesContent": ["import { existsSync } from 'fs';\nimport type DatabaseInstance from '../database/instance.js';\nimport { Logger } from '../logger/index.js';\nimport type QueueManager from '../queue/manager.js';\nimport type RedisInstance from '../redis/instance.js';\nimport BaseApplication from './base-application.js';\nimport type { CommandApplicationConfig } from './command-application.interface.js';\nimport { Helper, Loader, Time } from '../util/index.js';\n\nexport default class CommandApplication extends BaseApplication {\n  /** Command application config */\n  protected config: CommandApplicationConfig;\n\n  constructor(config: CommandApplicationConfig) {\n    super(config);\n\n    const defaultConfig: Partial<CommandApplicationConfig> = {\n      cluster: {\n        enabled: false,\n      },\n\n      log: {\n        startUp: false,\n      },\n\n      debug: {\n        measureExecutionTime: false,\n      },\n    };\n\n    const mergedConfig: CommandApplicationConfig = Helper.defaultsDeep(config, defaultConfig);\n\n    if (mergedConfig.cluster) {\n      mergedConfig.cluster.enabled = false;\n    }\n\n    this.config = mergedConfig;\n  }\n\n  protected async startHandler({\n    redisInstance,\n    databaseInstance,\n    queueManager,\n  }: {\n    redisInstance: RedisInstance;\n    databaseInstance: DatabaseInstance;\n    queueManager: QueueManager;\n  }): Promise<void> {\n    const startTime = performance.now();\n\n    // get argv (yargs) input args\n    const argv = this.config.commandManager.argv;\n\n    const parsedArgv = argv.parseSync();\n\n    if (parsedArgv._.length === 0) {\n      Logger.warn({ message: 'No command provided' });\n\n      this.stopCommand();\n\n      return;\n    }\n\n    const inputCommandName = parsedArgv._[0];\n\n    const commandsDirectoryExists = await existsSync(this.config.commandsDirectory);\n\n    if (!commandsDirectoryExists) {\n      Logger.warn({\n        message: 'Commands directory not found',\n        meta: {\n          Directory: this.config.commandsDirectory,\n        },\n      });\n\n      return;\n    }\n\n    // Load commands\n    const commands = await Loader.loadModulesInDirectory({\n      directory: this.config.commandsDirectory,\n      extensions: ['.ts', '.js'],\n    });\n\n    // Find command by name - use safe property access to prevent object injection\n    let CommandClass = null;\n    if (Object.prototype.hasOwnProperty.call(commands, inputCommandName)) {\n      CommandClass = Reflect.get(commands, inputCommandName);\n    }\n\n    if (!CommandClass) {\n      Logger.warn({\n        message: 'Command not found',\n        meta: { Command: inputCommandName },\n      });\n\n      return;\n    }\n\n    // Initialize command\n    const command = new CommandClass({\n      applicationConfig: this.config,\n      redisInstance,\n      queueManager,\n      databaseInstance,\n    });\n\n    Logger.info({\n      message: 'Command started',\n      meta: { Command: inputCommandName },\n    });\n\n    // Run command\n    await command.run(parsedArgv);\n\n    const commandCompletedLogParams: Record<string, unknown> = {\n      Command: inputCommandName,\n    };\n\n    if (this.config.debug?.measureExecutionTime) {\n      const endTime = performance.now();\n      const executionTime = endTime - startTime;\n\n      commandCompletedLogParams['Execution Time'] = Time.formatTime({\n        time: executionTime,\n        numDecimals: 2,\n        showUnit: true,\n      });\n    }\n\n    Logger.info({\n      message: 'Command completed',\n      meta: commandCompletedLogParams,\n    });\n\n    // Call shutdown signtal to stop the command\n    this.stopCommand();\n  }\n\n  private stopCommand(): void {\n    // Use existing graceful shutdown mechanism instead of self-termination\n    this.handleShutdown({ onStopped: this.onStopped.bind(this) });\n  }\n\n  protected stopCallback(): void {\n    Logger.info({ message: 'Command stopped' });\n  }\n}\n"],
+  "mappings": ";;AAAA,SAAS,kBAAkB;AAE3B,SAAS,cAAc;AAGvB,OAAO,qBAAqB;AAE5B,SAAS,QAAQ,QAAQ,YAAY;AAErC,MAAO,2BAAyC,gBAAgB;AAAA,EAThE,OASgE;AAAA;AAAA;AAAA;AAAA,EAEpD;AAAA,EAEV,YAAY,QAAkC;AAC5C,UAAM,MAAM;AAEZ,UAAM,gBAAmD;AAAA,MACvD,SAAS;AAAA,QACP,SAAS;AAAA,MACX;AAAA,MAEA,KAAK;AAAA,QACH,SAAS;AAAA,MACX;AAAA,MAEA,OAAO;AAAA,QACL,sBAAsB;AAAA,MACxB;AAAA,IACF;AAEA,UAAM,eAAyC,OAAO,aAAa,QAAQ,aAAa;AAExF,QAAI,aAAa,SAAS;AACxB,mBAAa,QAAQ,UAAU;AAAA,IACjC;AAEA,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAgB,aAAa;AAAA,IAC3B;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAIkB;AAChB,UAAM,YAAY,YAAY,IAAI;AAGlC,UAAM,OAAO,KAAK,OAAO,eAAe;AAExC,UAAM,aAAa,KAAK,UAAU;AAElC,QAAI,WAAW,EAAE,WAAW,GAAG;AAC7B,aAAO,KAAK,EAAE,SAAS,sBAAsB,CAAC;AAE9C,WAAK,YAAY;AAEjB;AAAA,IACF;AAEA,UAAM,mBAAmB,WAAW,EAAE,CAAC;AAEvC,UAAM,0BAA0B,MAAM,WAAW,KAAK,OAAO,iBAAiB;AAE9E,QAAI,CAAC,yBAAyB;AAC5B,aAAO,KAAK;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,UACJ,WAAW,KAAK,OAAO;AAAA,QACzB;AAAA,MACF,CAAC;AAED;AAAA,IACF;AAGA,UAAM,WAAW,MAAM,OAAO,uBAAuB;AAAA,MACnD,WAAW,KAAK,OAAO;AAAA,MACvB,YAAY,CAAC,OAAO,KAAK;AAAA,IAC3B,CAAC;AAGD,QAAI,eAAe;AACnB,QAAI,OAAO,UAAU,eAAe,KAAK,UAAU,gBAAgB,GAAG;AACpE,qBAAe,QAAQ,IAAI,UAAU,gBAAgB;AAAA,IACvD;AAEA,QAAI,CAAC,cAAc;AACjB,aAAO,KAAK;AAAA,QACV,SAAS;AAAA,QACT,MAAM,EAAE,SAAS,iBAAiB;AAAA,MACpC,CAAC;AAED;AAAA,IACF;AAGA,UAAM,UAAU,IAAI,aAAa;AAAA,MAC/B,mBAAmB,KAAK;AAAA,MACxB;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,WAAO,KAAK;AAAA,MACV,SAAS;AAAA,MACT,MAAM,EAAE,SAAS,iBAAiB;AAAA,IACpC,CAAC;AAGD,UAAM,QAAQ,IAAI,UAAU;AAE5B,UAAM,4BAAqD;AAAA,MACzD,SAAS;AAAA,IACX;AAEA,QAAI,KAAK,OAAO,OAAO,sBAAsB;AAC3C,YAAM,UAAU,YAAY,IAAI;AAChC,YAAM,gBAAgB,UAAU;AAEhC,gCAA0B,gBAAgB,IAAI,KAAK,WAAW;AAAA,QAC5D,MAAM;AAAA,QACN,aAAa;AAAA,QACb,UAAU;AAAA,MACZ,CAAC;AAAA,IACH;AAEA,WAAO,KAAK;AAAA,MACV,SAAS;AAAA,MACT,MAAM;AAAA,IACR,CAAC;AAGD,SAAK,YAAY;AAAA,EACnB;AAAA,EAEQ,cAAoB;AAE1B,SAAK,eAAe,EAAE,WAAW,KAAK,UAAU,KAAK,IAAI,EAAE,CAAC;AAAA,EAC9D;AAAA,EAEU,eAAqB;AAC7B,WAAO,KAAK,EAAE,SAAS,kBAAkB,CAAC;AAAA,EAC5C;AACF;",
+  "names": []
+}

package/dist/application/index.d.ts

@@ -0,0 +1,5 @@
+export { default as WebApplication } from './web-application.js';
+export { default as CommandApplication } from './command-application.js';
+export type { ApplicationConfig } from './base-application.interface.js';
+export type { WebApplicationConfig } from './web-application.interface.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/application/index.js

@@ -0,0 +1,7 @@
+import { default as default2 } from "./web-application.js";
+import { default as default3 } from "./command-application.js";
+export {
+  default3 as CommandApplication,
+  default2 as WebApplication
+};
+//# sourceMappingURL=index.js.map

package/dist/application/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/application/index.ts"],
+  "sourcesContent": ["export { default as WebApplication } from './web-application.js';\nexport { default as CommandApplication } from './command-application.js';\nexport type { ApplicationConfig } from './base-application.interface.js';\nexport type { WebApplicationConfig } from './web-application.interface.js';\n"],
+  "mappings": "AAAA,SAAoB,WAAXA,gBAAiC;AAC1C,SAAoB,WAAXA,gBAAqC;",
+  "names": ["default"]
+}