@scpxl/nodejs-framework 1.0.49 → 1.0.50

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

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

package/dist/application/base-application.js

@@ -412,6 +412,12 @@ ${formatted}`);
       Logger.info({ message: "Executing custom stop callback" });
       await this.stopCallback();
     });
+    this.lifecycle.onShutdown(async () => {
+      if (this.queueManager) {
+        Logger.info({ message: "Closing queue manager (workers and queues)" });
+        await this.queueManager.disconnect();
+      }
+    });
     this.lifecycle.onShutdown(async () => {
       if (this.redisManager) {
         Logger.info({ message: "Disconnecting from Redis" });

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

@@ -1,7 +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 type { PerformanceMonitor } from '../performance/performance-monitor.js';\n// Performance monitoring now pluginized\nimport { PerformanceMonitorPlugin } from '../performance/performance-monitor.plugin.js';\nimport { type LifecycleConfig, LifecycleManager, ShutdownController } from '../lifecycle/index.js';\nimport { ConfigValidationError, formatConfigIssues, validateFrameworkConfig } from '../config/schema.js';\nimport { type ExitOutcome, requestExit } from '../lifecycle/exit.js';\nimport { safeSerializeError } from '../error/error-reporter.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  /** Application start time */\n  protected startTime: number = 0;\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  private static globalErrorHandlersRegistered = false;\n  private static readonly instances = new Set<WeakRef<BaseApplication>>();\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  /** Lifecycle manager */\n  public lifecycle: LifecycleManager;\n\n  /** Shutdown controller */\n  public shutdownController: ShutdownController;\n\n  public get Name() {\n    return this.config.name;\n  }\n\n  /**\n   * Application constructor\n   */\n  constructor(config: ApplicationConfig) {\n    // Validate configuration early (fail-fast before side effects)\n    try {\n      const validated = validateFrameworkConfig(config as any);\n      config = validated as unknown as ApplicationConfig;\n    } catch (err) {\n      if (err instanceof ConfigValidationError) {\n        const formatted = formatConfigIssues(err.issues);\n        throw new Error(`Configuration validation failed:\\n${formatted}`);\n      }\n      throw err;\n    }\n    const computerName = os.hostname();\n\n    this.uniqueInstanceId = `${config.instanceId}-${computerName}-${OS.getUniqueComputerId()}`;\n    this.config = config;\n\n    // Configure logger with application settings\n    if (this.config.log?.showRequestIdInConsole !== undefined) {\n      Logger.configure({ showRequestIdInConsole: this.config.log.showRequestIdInConsole });\n    }\n\n    // Initialize lifecycle management\n    const lifecycleConfig: Partial<LifecycleConfig> = {\n      gracefulShutdown: {\n        timeoutMs: this.shutdownTimeout,\n      },\n      readiness: {\n        timeoutMs: 30000,\n        checkIntervalMs: 100,\n      },\n    };\n    this.lifecycle = new LifecycleManager(lifecycleConfig);\n    this.shutdownController = new ShutdownController(this.lifecycle);\n\n    // Register shutdown hooks for cleanup\n    this.registerShutdownHooks();\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      redisManager: this.redisManager,\n    });\n\n    // Register performance monitor plugin (idempotent & opt-in)\n    PerformanceMonitorPlugin.register(this);\n\n    // Track instance and ensure global error handlers are registered once\n    BaseApplication.registerInstance(this);\n\n    if (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 = Time.now();\n\n    // Get application version`\n    this.applicationVersion = await this.getApplicationVersion();\n\n    // Log initial startup message with version\n    Logger.info({\n      message: 'Starting application',\n      meta: {\n        Name: this.config.name,\n        'Instance ID': this.config.instanceId,\n        'PXL Framework Version': this.applicationVersion,\n      },\n    });\n\n    const startInstanceOptions: ApplicationStartInstanceOptions = {\n      onStarted: this.onStarted.bind(this),\n    };\n\n    const stopInstanceOptions: ApplicationStopInstanceOptions = {\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      // Note: Signal handling should be implemented at the application launcher level\n      // The lifecycle manager provides the stop() method for programmatic shutdown\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    const phaseStartTime = Time.now();\n\n    // Connect to Redis\n    if (process.env.DEBUG_TESTS) {\n      console.log('[BaseApplication] Connecting to Redis...');\n    }\n    const redisInstance = await this.redisManager.connect();\n    if (process.env.DEBUG_TESTS) {\n      const redisElapsed = Time.calculateElapsedTimeMs({ startTime: phaseStartTime });\n      console.log(`[BaseApplication] Redis connected (${redisElapsed}ms)`);\n    }\n\n    // Connect to database\n    let databaseInstance: DatabaseInstance | null = null;\n    if (this.databaseManager) {\n      if (process.env.DEBUG_TESTS) {\n        console.log('[BaseApplication] Connecting to database...');\n      }\n      const dbStartTime = Time.now();\n      databaseInstance = await this.databaseManager.connect();\n      if (process.env.DEBUG_TESTS) {\n        const dbElapsed = Time.calculateElapsedTimeMs({ startTime: dbStartTime });\n        console.log(`[BaseApplication] Database connected (${dbElapsed}ms)`);\n      }\n    }\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    // Register readiness checks for key services\n    this.lifecycle.addReadinessCheck('redis', async () => {\n      try {\n        return await redisInstance.isConnected();\n      } catch {\n        return false;\n      }\n    });\n\n    if (databaseInstance) {\n      this.lifecycle.addReadinessCheck('database', async () => {\n        try {\n          return await databaseInstance.isConnected();\n        } catch {\n          return false;\n        }\n      });\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   * Start application instance\n   */\n  private async startInstance(options: ApplicationStartInstanceOptions): Promise<void> {\n    try {\n      // Phase 1: Initialize (resource setup)\n      if (process.env.DEBUG_TESTS) {\n        console.log('[startInstance] Phase 1: Initializing lifecycle...');\n      }\n      const initStartTime = Time.now();\n      const initResult = await this.lifecycle.initialize();\n      if (process.env.DEBUG_TESTS) {\n        const initElapsed = Time.calculateElapsedTimeMs({ startTime: initStartTime });\n        console.log(`[startInstance] Phase 1 complete (${initElapsed}ms)`);\n      }\n      if (initResult.errors.length > 0) {\n        Logger.warn({\n          message: 'Lifecycle init phase encountered errors',\n          meta: { errors: initResult.errors.map(e => (e instanceof Error ? e.message : String(e))) },\n        });\n      }\n\n      // Before application start\n      if (process.env.DEBUG_TESTS) {\n        console.log('[startInstance] Connecting to services (Redis, Database, Queue, Events)...');\n      }\n      const beforeStartTime = Time.now();\n      const { redisInstance, databaseInstance, queueManager, eventManager } = await this.onBeforeStart();\n\n      // Store managers on instance for external access\n      this.queueManager = queueManager;\n      if (eventManager) {\n        this.eventManager = eventManager;\n      }\n\n      if (process.env.DEBUG_TESTS) {\n        const beforeStartElapsed = Time.calculateElapsedTimeMs({ startTime: beforeStartTime });\n        console.log(`[startInstance] Services connected (${beforeStartElapsed}ms)`);\n      }\n\n      // Phase 2: Start (component startup)\n      if (process.env.DEBUG_TESTS) {\n        console.log('[startInstance] Phase 2: Starting lifecycle components...');\n      }\n      const startStartTime = Time.now();\n      const startResult = await this.lifecycle.start();\n      if (process.env.DEBUG_TESTS) {\n        const startElapsed = Time.calculateElapsedTimeMs({ startTime: startStartTime });\n        console.log(`[startInstance] Phase 2 complete (${startElapsed}ms)`);\n      }\n      if (startResult.errors.length > 0) {\n        Logger.warn({\n          message: 'Lifecycle start phase encountered errors',\n          meta: { errors: startResult.errors.map(e => (e instanceof Error ? e.message : String(e))) },\n        });\n      }\n\n      // Start application\n      if (process.env.DEBUG_TESTS) {\n        console.log('[startInstance] Starting application handler...');\n      }\n      const handlerStartTime = Time.now();\n      await this.startHandler({\n        redisInstance,\n        databaseInstance,\n        queueManager,\n        eventManager,\n      });\n      if (process.env.DEBUG_TESTS) {\n        const handlerElapsed = Time.calculateElapsedTimeMs({ startTime: handlerStartTime });\n        console.log(`[startInstance] Application handler started (${handlerElapsed}ms)`);\n      }\n\n      // Phase 3: Ready (application accepting traffic)\n      if (process.env.DEBUG_TESTS) {\n        console.log('[startInstance] Phase 3: Waiting for application to be ready...');\n      }\n      const readyStartTime = Time.now();\n      const readyResult = await this.lifecycle.ready();\n      if (process.env.DEBUG_TESTS) {\n        const readyElapsed = Time.calculateElapsedTimeMs({ startTime: readyStartTime });\n        console.log(`[startInstance] Phase 3 complete (${readyElapsed}ms)`);\n      }\n      if (readyResult.errors.length > 0) {\n        Logger.warn({\n          message: 'Lifecycle ready phase encountered errors',\n          meta: { errors: readyResult.errors.map(e => (e instanceof Error ? e.message : String(e))) },\n        });\n      }\n\n      // Calculate application startup time\n      const startupTime = Time.calculateElapsedTimeMs({\n        startTime: this.startTime,\n      });\n\n      // On application started\n      if (options.onStarted) {\n        await options.onStarted({ startupTime });\n      }\n    } catch (error) {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(safeSerializeError(error)),\n        message: 'startInstance failure',\n      });\n      throw error;\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  private static registerInstance(instance: BaseApplication): void {\n    BaseApplication.pruneStaleInstances();\n    BaseApplication.instances.add(new WeakRef(instance));\n    BaseApplication.registerGlobalErrorHandlers();\n  }\n\n  private static unregisterInstance(instance: BaseApplication): void {\n    for (const ref of Array.from(BaseApplication.instances)) {\n      const current = ref.deref();\n      if (!current || current === instance) {\n        BaseApplication.instances.delete(ref);\n      }\n    }\n  }\n\n  private static pruneStaleInstances(): void {\n    for (const ref of Array.from(BaseApplication.instances)) {\n      if (!ref.deref()) {\n        BaseApplication.instances.delete(ref);\n      }\n    }\n  }\n\n  private static getActiveInstances(): BaseApplication[] {\n    const active: BaseApplication[] = [];\n    const stale: WeakRef<BaseApplication>[] = [];\n\n    for (const ref of BaseApplication.instances) {\n      const instance = ref.deref();\n      if (instance) {\n        active.push(instance);\n      } else {\n        stale.push(ref);\n      }\n    }\n\n    for (const ref of stale) {\n      BaseApplication.instances.delete(ref);\n    }\n\n    return active;\n  }\n\n  private static registerGlobalErrorHandlers(): void {\n    if (BaseApplication.globalErrorHandlersRegistered) {\n      return;\n    }\n\n    process.on('uncaughtException', error => {\n      Logger.error({ error, message: 'Uncaught Exception' });\n      for (const app of BaseApplication.getActiveInstances()) {\n        app.initiateGracefulShutdown();\n      }\n    });\n\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: String(promise) },\n      });\n      for (const app of BaseApplication.getActiveInstances()) {\n        app.initiateGracefulShutdown();\n      }\n    });\n\n    BaseApplication.globalErrorHandlersRegistered = true;\n  }\n\n  /**\n   * Register shutdown hooks for proper cleanup\n   */\n  private registerShutdownHooks(): void {\n    // Register shutdown hooks in reverse dependency order\n    this.lifecycle.onShutdown(() => {\n      BaseApplication.unregisterInstance(this);\n    });\n\n    this.lifecycle.onShutdown(async () => {\n      Logger.info({ message: 'Executing custom stop callback' });\n      await this.stopCallback();\n    });\n\n    this.lifecycle.onShutdown(async () => {\n      if (this.redisManager) {\n        Logger.info({ message: 'Disconnecting from Redis' });\n        await this.redisManager.disconnect();\n      }\n    });\n\n    this.lifecycle.onShutdown(async () => {\n      if (this.databaseManager) {\n        Logger.info({ message: 'Disconnecting from database' });\n        await this.databaseManager.disconnect();\n      }\n    });\n\n    // Performance monitor is handled via trackInterval, so it will be cleaned up automatically\n  }\n\n  /**\n   * Initiate graceful shutdown\n   */\n  private async initiateGracefulShutdown(): Promise<void> {\n    if (this.shutdownController.isShuttingDown) {\n      return;\n    }\n\n    Logger.info({ message: 'Initiating graceful shutdown due to error' });\n    try {\n      const result = await this.shutdownController.initiate('error-triggered');\n      if (result.errors.length > 0) {\n        Logger.error({\n          message: 'Errors during shutdown',\n          error: result.errors,\n        });\n        this.finalizeExit({ code: 1, reason: 'graceful-shutdown-error', error: result.errors });\n      } else if (result.timedOut) {\n        Logger.warn({ message: 'Shutdown timed out' });\n        this.finalizeExit({ code: 1, reason: 'shutdown-timeout' });\n      } else {\n        this.finalizeExit({ code: 0, reason: 'error-shutdown-complete' });\n      }\n    } catch (error) {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(safeSerializeError(error)),\n        message: 'Error during graceful shutdown',\n      });\n      this.finalizeExit({ code: 1, reason: 'graceful-shutdown-error', error });\n    }\n  }\n\n  /**\n   * Stop application using lifecycle manager\n   */\n  public async stop({ onStopped }: ApplicationStopInstanceOptions = {}): Promise<void> {\n    if (this.shutdownController.isShuttingDown) {\n      return;\n    }\n\n    // Register the onStopped callback if provided\n    if (onStopped) {\n      this.lifecycle.onShutdown(() => {\n        const runtime = process.uptime() * 1000;\n        onStopped({ runtime });\n      });\n    }\n\n    try {\n      const result = await this.shutdownController.initiate('manual-stop');\n      if (result.errors.length > 0) {\n        Logger.error({\n          message: 'Errors during shutdown',\n          error: result.errors,\n        });\n        this.finalizeExit({ code: 1, reason: 'shutdown-error', error: result.errors });\n      } else if (result.timedOut) {\n        Logger.warn({ message: 'Shutdown timed out' });\n        this.finalizeExit({ code: 1, reason: 'shutdown-timeout' });\n      } else {\n        this.finalizeExit({ code: 0, reason: 'shutdown-complete' });\n      }\n    } catch (error) {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(safeSerializeError(error)),\n        message: 'Error during shutdown',\n      });\n      this.finalizeExit({ code: 1, reason: 'shutdown-error', error });\n    }\n  }\n\n  /**\n   * Finalize exit: during tests, suppress actual process exit to avoid failing vitest runs.\n   */\n  private finalizeExit(outcome: ExitOutcome): void {\n    const nodeEnv = process.env.NODE_ENV ?? '';\n    const isTestEnv =\n      nodeEnv.toLowerCase() === 'test' ||\n      'VITEST' in process.env ||\n      'VITEST_WORKER_ID' in process.env ||\n      process.argv.some(a => a.includes('vitest')) ||\n      typeof (globalThis as any).afterAll === 'function';\n\n    if (isTestEnv) {\n      Logger.info({ message: `Skipping process exit in test environment (${outcome.reason})`, code: outcome.code });\n      return;\n    }\n    requestExit(outcome);\n  }\n}\n"],
-  "mappings": "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",
+  "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 type { PerformanceMonitor } from '../performance/performance-monitor.js';\n// Performance monitoring now pluginized\nimport { PerformanceMonitorPlugin } from '../performance/performance-monitor.plugin.js';\nimport { type LifecycleConfig, LifecycleManager, ShutdownController } from '../lifecycle/index.js';\nimport { ConfigValidationError, formatConfigIssues, validateFrameworkConfig } from '../config/schema.js';\nimport { type ExitOutcome, requestExit } from '../lifecycle/exit.js';\nimport { safeSerializeError } from '../error/error-reporter.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  /** Application start time */\n  protected startTime: number = 0;\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  private static globalErrorHandlersRegistered = false;\n  private static readonly instances = new Set<WeakRef<BaseApplication>>();\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  /** Lifecycle manager */\n  public lifecycle: LifecycleManager;\n\n  /** Shutdown controller */\n  public shutdownController: ShutdownController;\n\n  public get Name() {\n    return this.config.name;\n  }\n\n  /**\n   * Application constructor\n   */\n  constructor(config: ApplicationConfig) {\n    // Validate configuration early (fail-fast before side effects)\n    try {\n      const validated = validateFrameworkConfig(config as any);\n      config = validated as unknown as ApplicationConfig;\n    } catch (err) {\n      if (err instanceof ConfigValidationError) {\n        const formatted = formatConfigIssues(err.issues);\n        throw new Error(`Configuration validation failed:\\n${formatted}`);\n      }\n      throw err;\n    }\n    const computerName = os.hostname();\n\n    this.uniqueInstanceId = `${config.instanceId}-${computerName}-${OS.getUniqueComputerId()}`;\n    this.config = config;\n\n    // Configure logger with application settings\n    if (this.config.log?.showRequestIdInConsole !== undefined) {\n      Logger.configure({ showRequestIdInConsole: this.config.log.showRequestIdInConsole });\n    }\n\n    // Initialize lifecycle management\n    const lifecycleConfig: Partial<LifecycleConfig> = {\n      gracefulShutdown: {\n        timeoutMs: this.shutdownTimeout,\n      },\n      readiness: {\n        timeoutMs: 30000,\n        checkIntervalMs: 100,\n      },\n    };\n    this.lifecycle = new LifecycleManager(lifecycleConfig);\n    this.shutdownController = new ShutdownController(this.lifecycle);\n\n    // Register shutdown hooks for cleanup\n    this.registerShutdownHooks();\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      redisManager: this.redisManager,\n    });\n\n    // Register performance monitor plugin (idempotent & opt-in)\n    PerformanceMonitorPlugin.register(this);\n\n    // Track instance and ensure global error handlers are registered once\n    BaseApplication.registerInstance(this);\n\n    if (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 = Time.now();\n\n    // Get application version`\n    this.applicationVersion = await this.getApplicationVersion();\n\n    // Log initial startup message with version\n    Logger.info({\n      message: 'Starting application',\n      meta: {\n        Name: this.config.name,\n        'Instance ID': this.config.instanceId,\n        'PXL Framework Version': this.applicationVersion,\n      },\n    });\n\n    const startInstanceOptions: ApplicationStartInstanceOptions = {\n      onStarted: this.onStarted.bind(this),\n    };\n\n    const stopInstanceOptions: ApplicationStopInstanceOptions = {\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      // Note: Signal handling should be implemented at the application launcher level\n      // The lifecycle manager provides the stop() method for programmatic shutdown\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    const phaseStartTime = Time.now();\n\n    // Connect to Redis\n    if (process.env.DEBUG_TESTS) {\n      console.log('[BaseApplication] Connecting to Redis...');\n    }\n    const redisInstance = await this.redisManager.connect();\n    if (process.env.DEBUG_TESTS) {\n      const redisElapsed = Time.calculateElapsedTimeMs({ startTime: phaseStartTime });\n      console.log(`[BaseApplication] Redis connected (${redisElapsed}ms)`);\n    }\n\n    // Connect to database\n    let databaseInstance: DatabaseInstance | null = null;\n    if (this.databaseManager) {\n      if (process.env.DEBUG_TESTS) {\n        console.log('[BaseApplication] Connecting to database...');\n      }\n      const dbStartTime = Time.now();\n      databaseInstance = await this.databaseManager.connect();\n      if (process.env.DEBUG_TESTS) {\n        const dbElapsed = Time.calculateElapsedTimeMs({ startTime: dbStartTime });\n        console.log(`[BaseApplication] Database connected (${dbElapsed}ms)`);\n      }\n    }\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    // Register readiness checks for key services\n    this.lifecycle.addReadinessCheck('redis', async () => {\n      try {\n        return await redisInstance.isConnected();\n      } catch {\n        return false;\n      }\n    });\n\n    if (databaseInstance) {\n      this.lifecycle.addReadinessCheck('database', async () => {\n        try {\n          return await databaseInstance.isConnected();\n        } catch {\n          return false;\n        }\n      });\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   * Start application instance\n   */\n  private async startInstance(options: ApplicationStartInstanceOptions): Promise<void> {\n    try {\n      // Phase 1: Initialize (resource setup)\n      if (process.env.DEBUG_TESTS) {\n        console.log('[startInstance] Phase 1: Initializing lifecycle...');\n      }\n      const initStartTime = Time.now();\n      const initResult = await this.lifecycle.initialize();\n      if (process.env.DEBUG_TESTS) {\n        const initElapsed = Time.calculateElapsedTimeMs({ startTime: initStartTime });\n        console.log(`[startInstance] Phase 1 complete (${initElapsed}ms)`);\n      }\n      if (initResult.errors.length > 0) {\n        Logger.warn({\n          message: 'Lifecycle init phase encountered errors',\n          meta: { errors: initResult.errors.map(e => (e instanceof Error ? e.message : String(e))) },\n        });\n      }\n\n      // Before application start\n      if (process.env.DEBUG_TESTS) {\n        console.log('[startInstance] Connecting to services (Redis, Database, Queue, Events)...');\n      }\n      const beforeStartTime = Time.now();\n      const { redisInstance, databaseInstance, queueManager, eventManager } = await this.onBeforeStart();\n\n      // Store managers on instance for external access\n      this.queueManager = queueManager;\n      if (eventManager) {\n        this.eventManager = eventManager;\n      }\n\n      if (process.env.DEBUG_TESTS) {\n        const beforeStartElapsed = Time.calculateElapsedTimeMs({ startTime: beforeStartTime });\n        console.log(`[startInstance] Services connected (${beforeStartElapsed}ms)`);\n      }\n\n      // Phase 2: Start (component startup)\n      if (process.env.DEBUG_TESTS) {\n        console.log('[startInstance] Phase 2: Starting lifecycle components...');\n      }\n      const startStartTime = Time.now();\n      const startResult = await this.lifecycle.start();\n      if (process.env.DEBUG_TESTS) {\n        const startElapsed = Time.calculateElapsedTimeMs({ startTime: startStartTime });\n        console.log(`[startInstance] Phase 2 complete (${startElapsed}ms)`);\n      }\n      if (startResult.errors.length > 0) {\n        Logger.warn({\n          message: 'Lifecycle start phase encountered errors',\n          meta: { errors: startResult.errors.map(e => (e instanceof Error ? e.message : String(e))) },\n        });\n      }\n\n      // Start application\n      if (process.env.DEBUG_TESTS) {\n        console.log('[startInstance] Starting application handler...');\n      }\n      const handlerStartTime = Time.now();\n      await this.startHandler({\n        redisInstance,\n        databaseInstance,\n        queueManager,\n        eventManager,\n      });\n      if (process.env.DEBUG_TESTS) {\n        const handlerElapsed = Time.calculateElapsedTimeMs({ startTime: handlerStartTime });\n        console.log(`[startInstance] Application handler started (${handlerElapsed}ms)`);\n      }\n\n      // Phase 3: Ready (application accepting traffic)\n      if (process.env.DEBUG_TESTS) {\n        console.log('[startInstance] Phase 3: Waiting for application to be ready...');\n      }\n      const readyStartTime = Time.now();\n      const readyResult = await this.lifecycle.ready();\n      if (process.env.DEBUG_TESTS) {\n        const readyElapsed = Time.calculateElapsedTimeMs({ startTime: readyStartTime });\n        console.log(`[startInstance] Phase 3 complete (${readyElapsed}ms)`);\n      }\n      if (readyResult.errors.length > 0) {\n        Logger.warn({\n          message: 'Lifecycle ready phase encountered errors',\n          meta: { errors: readyResult.errors.map(e => (e instanceof Error ? e.message : String(e))) },\n        });\n      }\n\n      // Calculate application startup time\n      const startupTime = Time.calculateElapsedTimeMs({\n        startTime: this.startTime,\n      });\n\n      // On application started\n      if (options.onStarted) {\n        await options.onStarted({ startupTime });\n      }\n    } catch (error) {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(safeSerializeError(error)),\n        message: 'startInstance failure',\n      });\n      throw error;\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  private static registerInstance(instance: BaseApplication): void {\n    BaseApplication.pruneStaleInstances();\n    BaseApplication.instances.add(new WeakRef(instance));\n    BaseApplication.registerGlobalErrorHandlers();\n  }\n\n  private static unregisterInstance(instance: BaseApplication): void {\n    for (const ref of Array.from(BaseApplication.instances)) {\n      const current = ref.deref();\n      if (!current || current === instance) {\n        BaseApplication.instances.delete(ref);\n      }\n    }\n  }\n\n  private static pruneStaleInstances(): void {\n    for (const ref of Array.from(BaseApplication.instances)) {\n      if (!ref.deref()) {\n        BaseApplication.instances.delete(ref);\n      }\n    }\n  }\n\n  private static getActiveInstances(): BaseApplication[] {\n    const active: BaseApplication[] = [];\n    const stale: WeakRef<BaseApplication>[] = [];\n\n    for (const ref of BaseApplication.instances) {\n      const instance = ref.deref();\n      if (instance) {\n        active.push(instance);\n      } else {\n        stale.push(ref);\n      }\n    }\n\n    for (const ref of stale) {\n      BaseApplication.instances.delete(ref);\n    }\n\n    return active;\n  }\n\n  private static registerGlobalErrorHandlers(): void {\n    if (BaseApplication.globalErrorHandlersRegistered) {\n      return;\n    }\n\n    process.on('uncaughtException', error => {\n      Logger.error({ error, message: 'Uncaught Exception' });\n      for (const app of BaseApplication.getActiveInstances()) {\n        app.initiateGracefulShutdown();\n      }\n    });\n\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: String(promise) },\n      });\n      for (const app of BaseApplication.getActiveInstances()) {\n        app.initiateGracefulShutdown();\n      }\n    });\n\n    BaseApplication.globalErrorHandlersRegistered = true;\n  }\n\n  /**\n   * Register shutdown hooks for proper cleanup\n   */\n  private registerShutdownHooks(): void {\n    // Register shutdown hooks in reverse dependency order\n    this.lifecycle.onShutdown(() => {\n      BaseApplication.unregisterInstance(this);\n    });\n\n    this.lifecycle.onShutdown(async () => {\n      Logger.info({ message: 'Executing custom stop callback' });\n      await this.stopCallback();\n    });\n\n    this.lifecycle.onShutdown(async () => {\n      if (this.queueManager) {\n        Logger.info({ message: 'Closing queue manager (workers and queues)' });\n        await this.queueManager.disconnect();\n      }\n    });\n\n    this.lifecycle.onShutdown(async () => {\n      if (this.redisManager) {\n        Logger.info({ message: 'Disconnecting from Redis' });\n        await this.redisManager.disconnect();\n      }\n    });\n\n    this.lifecycle.onShutdown(async () => {\n      if (this.databaseManager) {\n        Logger.info({ message: 'Disconnecting from database' });\n        await this.databaseManager.disconnect();\n      }\n    });\n\n    // Performance monitor is handled via trackInterval, so it will be cleaned up automatically\n  }\n\n  /**\n   * Initiate graceful shutdown\n   */\n  private async initiateGracefulShutdown(): Promise<void> {\n    if (this.shutdownController.isShuttingDown) {\n      return;\n    }\n\n    Logger.info({ message: 'Initiating graceful shutdown due to error' });\n    try {\n      const result = await this.shutdownController.initiate('error-triggered');\n      if (result.errors.length > 0) {\n        Logger.error({\n          message: 'Errors during shutdown',\n          error: result.errors,\n        });\n        this.finalizeExit({ code: 1, reason: 'graceful-shutdown-error', error: result.errors });\n      } else if (result.timedOut) {\n        Logger.warn({ message: 'Shutdown timed out' });\n        this.finalizeExit({ code: 1, reason: 'shutdown-timeout' });\n      } else {\n        this.finalizeExit({ code: 0, reason: 'error-shutdown-complete' });\n      }\n    } catch (error) {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(safeSerializeError(error)),\n        message: 'Error during graceful shutdown',\n      });\n      this.finalizeExit({ code: 1, reason: 'graceful-shutdown-error', error });\n    }\n  }\n\n  /**\n   * Stop application using lifecycle manager\n   */\n  public async stop({ onStopped }: ApplicationStopInstanceOptions = {}): Promise<void> {\n    if (this.shutdownController.isShuttingDown) {\n      return;\n    }\n\n    // Register the onStopped callback if provided\n    if (onStopped) {\n      this.lifecycle.onShutdown(() => {\n        const runtime = process.uptime() * 1000;\n        onStopped({ runtime });\n      });\n    }\n\n    try {\n      const result = await this.shutdownController.initiate('manual-stop');\n      if (result.errors.length > 0) {\n        Logger.error({\n          message: 'Errors during shutdown',\n          error: result.errors,\n        });\n        this.finalizeExit({ code: 1, reason: 'shutdown-error', error: result.errors });\n      } else if (result.timedOut) {\n        Logger.warn({ message: 'Shutdown timed out' });\n        this.finalizeExit({ code: 1, reason: 'shutdown-timeout' });\n      } else {\n        this.finalizeExit({ code: 0, reason: 'shutdown-complete' });\n      }\n    } catch (error) {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(safeSerializeError(error)),\n        message: 'Error during shutdown',\n      });\n      this.finalizeExit({ code: 1, reason: 'shutdown-error', error });\n    }\n  }\n\n  /**\n   * Finalize exit: during tests, suppress actual process exit to avoid failing vitest runs.\n   */\n  private finalizeExit(outcome: ExitOutcome): void {\n    const nodeEnv = process.env.NODE_ENV ?? '';\n    const isTestEnv =\n      nodeEnv.toLowerCase() === 'test' ||\n      'VITEST' in process.env ||\n      'VITEST_WORKER_ID' in process.env ||\n      process.argv.some(a => a.includes('vitest')) ||\n      typeof (globalThis as any).afterAll === 'function';\n\n    if (isTestEnv) {\n      Logger.info({ message: `Skipping process exit in test environment (${outcome.reason})`, code: outcome.code });\n      return;\n    }\n    requestExit(outcome);\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -62,5 +62,11 @@ export declare class LifecycleManager {
         ready: boolean;
         checks: ReadinessCheckResult[];
     }>;
+    /**
+     * Reset the lifecycle manager to its initial state.
+     * This clears all hooks, tracked resources, and readiness checks.
+     * Useful for testing or when reinitializing the application.
+     */
+    reset(): void;
 }
 //# sourceMappingURL=lifecycle-manager.d.ts.map

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

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

package/dist/lifecycle/lifecycle-manager.js

@@ -268,6 +268,34 @@ class LifecycleManager {
     const ready = this._isReady && this._phase === LifecyclePhase.RUNNING && checks.every((c) => c.ready);
     return { ready, checks };
   }
+  /**
+   * Reset the lifecycle manager to its initial state.
+   * This clears all hooks, tracked resources, and readiness checks.
+   * Useful for testing or when reinitializing the application.
+   */
+  reset() {
+    this.initHooks.length = 0;
+    this.startHooks.length = 0;
+    this.readyHooks.length = 0;
+    this.beforeShutdownHooks.length = 0;
+    this.shutdownHooks.length = 0;
+    for (const id of this.intervals) {
+      clearInterval(id);
+    }
+    for (const id of this.timeouts) {
+      clearTimeout(id);
+    }
+    for (const controller of this.abortControllers) {
+      controller.abort();
+    }
+    this.disposables.clear();
+    this.intervals.clear();
+    this.timeouts.clear();
+    this.abortControllers.clear();
+    this.readinessChecks.clear();
+    this._phase = LifecyclePhase.CREATED;
+    this._isReady = false;
+  }
 }
 export {
   LifecycleManager

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

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

package/dist/queue/manager.d.ts

@@ -18,6 +18,7 @@ export default class QueueManager {
     private databaseInstance;
     private eventManager?;
     private queues;
+    private workers;
     private jobProcessors;
     constructor({ applicationConfig, options, queues: _queues, redisInstance, databaseInstance, eventManager, }: QueueManagerConstructorParams);
     registerQueues({ queues }: {
@@ -36,6 +37,11 @@ export default class QueueManager {
     }) => Promise<Job<QueueJobData<TPayload, TMetadata>, TResult, TName> | undefined>;
     private workerProcessor;
     listAllJobsWithStatus(): Promise<JobSummary[]>;
+    /**
+     * Disconnect all queues and workers, cleanup resources.
+     * Should be called during application shutdown.
+     */
+    disconnect(): Promise<void>;
     /**
      * Log queue message
      */

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

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/queue/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAgD,MAAM,QAAQ,CAAC;AAEhF,OAAO,KAAK,EAAE,6BAA6B,EAAuB,MAAM,wBAAwB,CAAC;AAOjG,OAAO,KAAK,EAAY,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAItD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,OAAO,CAAC,MAAM,CAAyB;IAEvC,OAAO,CAAC,iBAAiB,CAAoB;IAE7C,OAAO,CAAC,OAAO,CAAsB;IAErC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,YAAY,CAAC,CAAe;IAEpC,OAAO,CAAC,MAAM,CAAiC;IAE/C,OAAO,CAAC,aAAa,CAAyC;gBAElD,EACV,iBAAiB,EACjB,OAAO,EACP,MAAM,EAAE,OAAO,EACf,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,EAAE,6BAA6B;IAgBnB,cAAc,CAAC,EAAE,MAAM,EAAE,EAAE;QAAE,MAAM,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC/E,OAAO,CAAC,aAAa;IAsErB,OAAO,CAAC,qBAAqB;IA0C7B,OAAO,CAAC,YAAY,CAElB;IAEF,OAAO,CAAC,cAAc,CAIpB;IAEF,OAAO,CAAC,eAAe,CAKrB;IAEF,OAAO,CAAC,cAAc,CAEpB;IAEK,aAAa,GAClB,QAAQ,SAAS,eAAe,GAAG,eAAe,EAClD,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,OAAO,GAAG,OAAO,EACjB,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,2BAIC;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;KACzC,KAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC,CA0B7E;IAEF,OAAO,CAAC,eAAe,CA2ErB;IAEW,qBAAqB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IA6B3D;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlE"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/queue/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAgD,MAAM,QAAQ,CAAC;AAEhF,OAAO,KAAK,EAAE,6BAA6B,EAAuB,MAAM,wBAAwB,CAAC;AAOjG,OAAO,KAAK,EAAY,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAItD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,OAAO,CAAC,MAAM,CAAyB;IAEvC,OAAO,CAAC,iBAAiB,CAAoB;IAE7C,OAAO,CAAC,OAAO,CAAsB;IAErC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,YAAY,CAAC,CAAe;IAEpC,OAAO,CAAC,MAAM,CAAiC;IAE/C,OAAO,CAAC,OAAO,CAAuC;IAEtD,OAAO,CAAC,aAAa,CAAyC;gBAElD,EACV,iBAAiB,EACjB,OAAO,EACP,MAAM,EAAE,OAAO,EACf,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,EAAE,6BAA6B;IAgBnB,cAAc,CAAC,EAAE,MAAM,EAAE,EAAE;QAAE,MAAM,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC/E,OAAO,CAAC,aAAa;IAwErB,OAAO,CAAC,qBAAqB;IA0C7B,OAAO,CAAC,YAAY,CAElB;IAEF,OAAO,CAAC,cAAc,CAIpB;IAEF,OAAO,CAAC,eAAe,CAKrB;IAEF,OAAO,CAAC,cAAc,CAEpB;IAEK,aAAa,GAClB,QAAQ,SAAS,eAAe,GAAG,eAAe,EAClD,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,OAAO,GAAG,OAAO,EACjB,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,2BAIC;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;KACzC,KAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC,CAyB7E;IAEF,OAAO,CAAC,eAAe,CA2ErB;IAEW,qBAAqB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IA6B3D;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCxC;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlE"}

package/dist/queue/manager.js

@@ -16,6 +16,7 @@ class QueueManager {
   databaseInstance;
   eventManager;
   queues = /* @__PURE__ */ new Map();
+  workers = /* @__PURE__ */ new Map();
   jobProcessors = /* @__PURE__ */ new Map();
   constructor({
     applicationConfig,
@@ -93,7 +94,7 @@ class QueueManager {
         autorun: true,
         ...queue.settings ?? {}
       };
-      new QueueWorker({
+      const worker = new QueueWorker({
         applicationConfig: this.applicationConfig,
         queueManager: this,
         name: queue.name,
@@ -101,6 +102,7 @@ class QueueManager {
         options: workerOptions,
         redisInstance: this.redisInstance
       });
+      this.workers.set(queue.name, worker);
     }
     this.queues.set(queue.name, queueInstance);
     if (this.applicationConfig.queue.log?.queueRegistered) {
@@ -173,10 +175,10 @@ class QueueManager {
       return;
     }
     const job = await queue.add(jobId, data);
-    const dataStr = JSON.stringify(data);
-    const maxLogDataStrLength = 50;
-    const truncatedLogDataStr = dataStr.length > maxLogDataStrLength ? `${dataStr.substring(0, maxLogDataStrLength)}...` : dataStr;
     if (this.applicationConfig.queue.log?.jobAdded) {
+      const dataStr = JSON.stringify(data);
+      const maxLogDataStrLength = 50;
+      const truncatedLogDataStr = dataStr.length > maxLogDataStrLength ? `${dataStr.substring(0, maxLogDataStrLength)}...` : dataStr;
       this.log("Job added", {
         Queue: queueId,
         "Job ID": jobId,
@@ -267,6 +269,39 @@ class QueueManager {
     }
     return jobsSummary;
   }
+  /**
+   * Disconnect all queues and workers, cleanup resources.
+   * Should be called during application shutdown.
+   */
+  async disconnect() {
+    for (const [name, worker] of this.workers) {
+      try {
+        await worker.cleanup();
+        this.log("Worker closed", { Name: name });
+      } catch (error) {
+        Logger.error({
+          error,
+          message: `Failed to close worker: ${name}`
+        });
+      }
+    }
+    for (const [name, queue] of this.queues) {
+      try {
+        queue.removeAllListeners();
+        await queue.close();
+        this.log("Queue closed", { Name: name });
+      } catch (error) {
+        Logger.error({
+          error,
+          message: `Failed to close queue: ${name}`
+        });
+      }
+    }
+    this.workers.clear();
+    this.queues.clear();
+    this.jobProcessors.clear();
+    this.log("Queue manager disconnected");
+  }
   /**
    * Log queue message
    */

package/dist/queue/manager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/queue/manager.ts"],
-  "sourcesContent": ["import { type Job, Queue, type QueueOptions, type WorkerOptions } from 'bullmq';\nimport path from 'path';\nimport type { QueueManagerConstructorParams, QueueManagerOptions } from './manager.interface.js';\nimport type { RedisInstance } from '../redis/index.js';\nimport type { DatabaseInstance } from '../database/index.js';\nimport { Logger } from '../logger/index.js';\nimport QueueWorker from './worker.js';\nimport type BaseProcessor from './processor/base.js';\nimport { File, Helper, Loader, Time } from '../util/index.js';\nimport type { QueueJob, QueueJobData, QueueJobPayload } from './job.interface.js';\nimport type { ProcessorConstructor } from './processor/processor.interface.js';\nimport type { QueueItem } from './index.interface.js';\nimport type { ApplicationConfig } from '../application/base-application.interface.js';\nimport type EventManager from '../event/manager.js';\n\nexport interface JobSummary {\n  id: string;\n  name: string;\n  queueName: string;\n  state: 'active' | 'waiting' | 'completed' | 'failed' | 'delayed' | 'paused';\n  attemptsMade: number;\n  failedReason?: string;\n}\n\nexport default class QueueManager {\n  private logger: typeof Logger = Logger;\n\n  private applicationConfig: ApplicationConfig;\n\n  private options: QueueManagerOptions;\n\n  private redisInstance: RedisInstance;\n  private databaseInstance: DatabaseInstance | null;\n  private eventManager?: EventManager;\n\n  private queues: Map<string, Queue> = new Map();\n\n  private jobProcessors: Map<string, BaseProcessor> = new Map();\n\n  constructor({\n    applicationConfig,\n    options,\n    queues: _queues,\n    redisInstance,\n    databaseInstance,\n    eventManager,\n  }: QueueManagerConstructorParams) {\n    // Merge options with defaults if provided\n    if (options) {\n      this.options = options;\n    } else {\n      // This shouldn't happen, but handle the edge case\n      this.options = { processorsDirectory: '' };\n    }\n\n    this.applicationConfig = applicationConfig;\n\n    this.redisInstance = redisInstance;\n    this.databaseInstance = databaseInstance;\n    this.eventManager = eventManager;\n  }\n\n  public async registerQueues({ queues }: { queues: QueueItem[] }): Promise<void> {\n    if (!queues) {\n      return;\n    }\n\n    // Check if processors directory exists\n    const processorsDirectoryExists = await File.pathExists(this.options.processorsDirectory);\n\n    if (!processorsDirectoryExists) {\n      return;\n    }\n\n    try {\n      const jobProcessorClasses = await Loader.loadModulesInDirectory<ProcessorConstructor>({\n        directory: this.options.processorsDirectory,\n        extensions: ['.ts', '.js'],\n      });\n\n      for (const queue of queues) {\n        this.registerQueue({ queue, jobProcessorClasses });\n      }\n\n      if (this.applicationConfig.queue.log?.queuesRegistered) {\n        this.log('Registered queue', {\n          'Queue Count': queues.length,\n          'Job Count': this.jobProcessors.size,\n        });\n      }\n    } catch (error) {\n      Logger.error({ error });\n    }\n  }\n\n  private registerQueue({\n    queue,\n    jobProcessorClasses,\n  }: {\n    queue: QueueItem;\n    jobProcessorClasses: Record<string, ProcessorConstructor>;\n  }): void {\n    if (!queue.jobs) {\n      Logger.warn({\n        message: 'No jobs found for queue, skip register',\n        meta: {\n          Name: queue.name,\n        },\n      });\n\n      return;\n    }\n\n    // Merge framework defaults with queue-specific default job options\n    const queueOptions: QueueOptions = {\n      connection: this.redisInstance.client,\n      defaultJobOptions: {\n        removeOnComplete: true,\n        removeOnFail: true,\n        ...(queue.defaultJobOptions ?? {}),\n      },\n    };\n\n    const queueInstance = new Queue(queue.name, queueOptions);\n\n    queueInstance.on('error', this.onQueueError);\n    queueInstance.on('waiting', this.onQueueWaiting);\n    queueInstance.on('progress', this.onQueueProgress);\n    queueInstance.on('removed', this.onQueueRemoved);\n\n    if (!queue.isExternal) {\n      // Build worker options, applying per-queue runtime settings\n      const workerOptions: WorkerOptions = {\n        connection: this.redisInstance.client,\n        autorun: true,\n        ...(queue.settings ?? {}),\n      };\n\n      new QueueWorker({\n        applicationConfig: this.applicationConfig,\n        queueManager: this,\n        name: queue.name,\n        processor: this.workerProcessor,\n        options: workerOptions,\n        redisInstance: this.redisInstance,\n      });\n    }\n\n    this.queues.set(queue.name, queueInstance);\n\n    if (this.applicationConfig.queue.log?.queueRegistered) {\n      this.log('Registered queue', {\n        Name: queue.name,\n        Settings: queue.settings ? JSON.stringify(queue.settings) : 'default',\n      });\n    }\n\n    // Register job processors\n    this.registerJobProcessors({\n      queue,\n      jobs: queue.jobs,\n      jobProcessorClasses,\n    });\n  }\n\n  private registerJobProcessors({\n    queue,\n    jobs,\n    jobProcessorClasses,\n  }: {\n    queue: QueueItem;\n    jobs: QueueJob[];\n    jobProcessorClasses: Record<string, ProcessorConstructor>;\n  }): void {\n    if (!jobs) {\n      return;\n    }\n\n    const scriptFileExtension = Helper.getScriptFileExtension();\n\n    for (const job of jobs) {\n      if (!queue.isExternal) {\n        const ProcessorClass = jobProcessorClasses[job.id];\n\n        if (!ProcessorClass) {\n          const jobPath = path.join(this.options.processorsDirectory, `${job.id}.${scriptFileExtension}`);\n\n          throw new Error(`Processor class not found (Job ID: ${job.id} | Path: ${jobPath})`);\n        }\n\n        const processorInstance = new ProcessorClass(\n          this,\n          this.applicationConfig,\n          this.redisInstance,\n          this.databaseInstance,\n          this.eventManager,\n        );\n\n        this.jobProcessors.set(job.id, processorInstance);\n      }\n\n      if (this.applicationConfig.queue.log?.jobRegistered) {\n        this.log('Job registered', { ID: job.id });\n      }\n    }\n  }\n\n  private onQueueError = (error: Error): void => {\n    Logger.error({ error });\n  };\n\n  private onQueueWaiting = (job: Job): void => {\n    if (this.applicationConfig.queue.log?.queueWaiting) {\n      this.log('Waiting...', { Queue: job.queueName, Job: job.id });\n    }\n  };\n\n  private onQueueProgress = (jobId: string, progress: unknown): void => {\n    this.log('Progress update', {\n      'Job ID': jobId,\n      Progress: progress,\n    });\n  };\n\n  private onQueueRemoved = (jobId: string): void => {\n    this.log('Removed queue', { Job: jobId });\n  };\n\n  public addJobToQueue = async <\n    TPayload extends QueueJobPayload = QueueJobPayload,\n    TMetadata extends Record<string, unknown> = Record<string, unknown>,\n    TResult = unknown,\n    TName extends string = string,\n  >({\n    queueId,\n    jobId,\n    data,\n  }: {\n    queueId: string;\n    jobId: TName;\n    data: QueueJobData<TPayload, TMetadata>;\n  }): Promise<Job<QueueJobData<TPayload, TMetadata>, TResult, TName> | undefined> => {\n    const queue = this.queues.get(queueId);\n\n    if (!queue) {\n      this.log('Queue not found', { 'Queue ID': queueId });\n\n      return;\n    }\n\n    const job = (await queue.add(jobId, data)) as Job<QueueJobData<TPayload, TMetadata>, TResult, TName>;\n\n    const dataStr = JSON.stringify(data);\n\n    const maxLogDataStrLength = 50;\n    const truncatedLogDataStr =\n      dataStr.length > maxLogDataStrLength ? `${dataStr.substring(0, maxLogDataStrLength)}...` : dataStr;\n\n    if (this.applicationConfig.queue.log?.jobAdded) {\n      this.log('Job added', {\n        Queue: queueId,\n        'Job ID': jobId,\n        Data: truncatedLogDataStr,\n      });\n    }\n\n    return job;\n  };\n\n  private workerProcessor = async (job: Job): Promise<unknown> => {\n    if (!job) {\n      return;\n    }\n\n    const startTime = Time.now();\n\n    // Add start time to job data\n    if (typeof job.updateData === 'function') {\n      try {\n        await job.updateData({ ...job.data, startTime });\n      } catch (error) {\n        Logger.warn({\n          message: 'Failed to persist job metadata before processing',\n          meta: {\n            Queue: job.queueName,\n            'Job Name': job.name,\n            'Job ID': job.id,\n            Error: error instanceof Error ? error.message : String(error),\n          },\n        });\n      }\n    }\n\n    this.log('Worker processing...', {\n      Queue: job.queueName,\n      'Job Name': job.name,\n      'Job ID': job.id,\n    });\n\n    const processor = this.jobProcessors.get(job.name);\n\n    if (!processor) {\n      throw new Error(`No processor registered for job (Name: ${job.name})`);\n    }\n\n    let result: unknown;\n    let error: Error | undefined;\n\n    try {\n      // Call beforeProcess hook\n      await processor.beforeProcess({ job });\n\n      // Execute main processing\n      result = await processor.process({ job });\n\n      return result;\n    } catch (err) {\n      error = err as Error;\n\n      Logger.warn({\n        message: 'Queue worker processing error',\n        meta: {\n          Queue: job.queueName,\n          'Job Name': job.name,\n          'Job ID': job.id,\n          Error: error.message,\n        },\n      });\n\n      Logger.error({ error });\n\n      throw error; // Re-throw to mark job as failed\n    } finally {\n      // ALWAYS call afterProcess for cleanup (even on error)\n      try {\n        await processor.afterProcess({ job, result, error });\n      } catch (cleanupError) {\n        // Log but don't throw - cleanup errors shouldn't fail the job\n        Logger.error({\n          error: cleanupError,\n          message: 'Error in processor afterProcess cleanup',\n        });\n      }\n    }\n  };\n\n  public async listAllJobsWithStatus(): Promise<JobSummary[]> {\n    const jobsSummary: JobSummary[] = [];\n\n    for (const [queueName, queue] of this.queues) {\n      const jobStates = ['active', 'waiting', 'completed', 'failed', 'delayed', 'paused'] as const;\n\n      const jobsDetailsPromises = jobStates.map(async state => {\n        const jobs = await queue.getJobs([state]);\n        return jobs.map(\n          (job): JobSummary => ({\n            id: job.id ?? 'unknown',\n            name: job.name ?? 'unknown',\n            queueName,\n            state,\n            attemptsMade: job.attemptsMade,\n            failedReason: job.failedReason,\n          }),\n        );\n      });\n\n      const results = await Promise.all(jobsDetailsPromises);\n      const flattenedResults = results.flat();\n\n      jobsSummary.push(...flattenedResults);\n    }\n\n    return jobsSummary;\n  }\n\n  /**\n   * Log queue message\n   */\n  public log(message: string, meta?: Record<string, unknown>): void {\n    this.logger.custom({ level: 'queue', message, meta });\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { type Job, Queue, type QueueOptions, type WorkerOptions } from 'bullmq';\nimport path from 'path';\nimport type { QueueManagerConstructorParams, QueueManagerOptions } from './manager.interface.js';\nimport type { RedisInstance } from '../redis/index.js';\nimport type { DatabaseInstance } from '../database/index.js';\nimport { Logger } from '../logger/index.js';\nimport QueueWorker from './worker.js';\nimport type BaseProcessor from './processor/base.js';\nimport { File, Helper, Loader, Time } from '../util/index.js';\nimport type { QueueJob, QueueJobData, QueueJobPayload } from './job.interface.js';\nimport type { ProcessorConstructor } from './processor/processor.interface.js';\nimport type { QueueItem } from './index.interface.js';\nimport type { ApplicationConfig } from '../application/base-application.interface.js';\nimport type EventManager from '../event/manager.js';\n\nexport interface JobSummary {\n  id: string;\n  name: string;\n  queueName: string;\n  state: 'active' | 'waiting' | 'completed' | 'failed' | 'delayed' | 'paused';\n  attemptsMade: number;\n  failedReason?: string;\n}\n\nexport default class QueueManager {\n  private logger: typeof Logger = Logger;\n\n  private applicationConfig: ApplicationConfig;\n\n  private options: QueueManagerOptions;\n\n  private redisInstance: RedisInstance;\n  private databaseInstance: DatabaseInstance | null;\n  private eventManager?: EventManager;\n\n  private queues: Map<string, Queue> = new Map();\n\n  private workers: Map<string, QueueWorker> = new Map();\n\n  private jobProcessors: Map<string, BaseProcessor> = new Map();\n\n  constructor({\n    applicationConfig,\n    options,\n    queues: _queues,\n    redisInstance,\n    databaseInstance,\n    eventManager,\n  }: QueueManagerConstructorParams) {\n    // Merge options with defaults if provided\n    if (options) {\n      this.options = options;\n    } else {\n      // This shouldn't happen, but handle the edge case\n      this.options = { processorsDirectory: '' };\n    }\n\n    this.applicationConfig = applicationConfig;\n\n    this.redisInstance = redisInstance;\n    this.databaseInstance = databaseInstance;\n    this.eventManager = eventManager;\n  }\n\n  public async registerQueues({ queues }: { queues: QueueItem[] }): Promise<void> {\n    if (!queues) {\n      return;\n    }\n\n    // Check if processors directory exists\n    const processorsDirectoryExists = await File.pathExists(this.options.processorsDirectory);\n\n    if (!processorsDirectoryExists) {\n      return;\n    }\n\n    try {\n      const jobProcessorClasses = await Loader.loadModulesInDirectory<ProcessorConstructor>({\n        directory: this.options.processorsDirectory,\n        extensions: ['.ts', '.js'],\n      });\n\n      for (const queue of queues) {\n        this.registerQueue({ queue, jobProcessorClasses });\n      }\n\n      if (this.applicationConfig.queue.log?.queuesRegistered) {\n        this.log('Registered queue', {\n          'Queue Count': queues.length,\n          'Job Count': this.jobProcessors.size,\n        });\n      }\n    } catch (error) {\n      Logger.error({ error });\n    }\n  }\n\n  private registerQueue({\n    queue,\n    jobProcessorClasses,\n  }: {\n    queue: QueueItem;\n    jobProcessorClasses: Record<string, ProcessorConstructor>;\n  }): void {\n    if (!queue.jobs) {\n      Logger.warn({\n        message: 'No jobs found for queue, skip register',\n        meta: {\n          Name: queue.name,\n        },\n      });\n\n      return;\n    }\n\n    // Merge framework defaults with queue-specific default job options\n    const queueOptions: QueueOptions = {\n      connection: this.redisInstance.client,\n      defaultJobOptions: {\n        removeOnComplete: true,\n        removeOnFail: true,\n        ...(queue.defaultJobOptions ?? {}),\n      },\n    };\n\n    const queueInstance = new Queue(queue.name, queueOptions);\n\n    queueInstance.on('error', this.onQueueError);\n    queueInstance.on('waiting', this.onQueueWaiting);\n    queueInstance.on('progress', this.onQueueProgress);\n    queueInstance.on('removed', this.onQueueRemoved);\n\n    if (!queue.isExternal) {\n      // Build worker options, applying per-queue runtime settings\n      const workerOptions: WorkerOptions = {\n        connection: this.redisInstance.client,\n        autorun: true,\n        ...(queue.settings ?? {}),\n      };\n\n      const worker = new QueueWorker({\n        applicationConfig: this.applicationConfig,\n        queueManager: this,\n        name: queue.name,\n        processor: this.workerProcessor,\n        options: workerOptions,\n        redisInstance: this.redisInstance,\n      });\n\n      this.workers.set(queue.name, worker);\n    }\n\n    this.queues.set(queue.name, queueInstance);\n\n    if (this.applicationConfig.queue.log?.queueRegistered) {\n      this.log('Registered queue', {\n        Name: queue.name,\n        Settings: queue.settings ? JSON.stringify(queue.settings) : 'default',\n      });\n    }\n\n    // Register job processors\n    this.registerJobProcessors({\n      queue,\n      jobs: queue.jobs,\n      jobProcessorClasses,\n    });\n  }\n\n  private registerJobProcessors({\n    queue,\n    jobs,\n    jobProcessorClasses,\n  }: {\n    queue: QueueItem;\n    jobs: QueueJob[];\n    jobProcessorClasses: Record<string, ProcessorConstructor>;\n  }): void {\n    if (!jobs) {\n      return;\n    }\n\n    const scriptFileExtension = Helper.getScriptFileExtension();\n\n    for (const job of jobs) {\n      if (!queue.isExternal) {\n        const ProcessorClass = jobProcessorClasses[job.id];\n\n        if (!ProcessorClass) {\n          const jobPath = path.join(this.options.processorsDirectory, `${job.id}.${scriptFileExtension}`);\n\n          throw new Error(`Processor class not found (Job ID: ${job.id} | Path: ${jobPath})`);\n        }\n\n        const processorInstance = new ProcessorClass(\n          this,\n          this.applicationConfig,\n          this.redisInstance,\n          this.databaseInstance,\n          this.eventManager,\n        );\n\n        this.jobProcessors.set(job.id, processorInstance);\n      }\n\n      if (this.applicationConfig.queue.log?.jobRegistered) {\n        this.log('Job registered', { ID: job.id });\n      }\n    }\n  }\n\n  private onQueueError = (error: Error): void => {\n    Logger.error({ error });\n  };\n\n  private onQueueWaiting = (job: Job): void => {\n    if (this.applicationConfig.queue.log?.queueWaiting) {\n      this.log('Waiting...', { Queue: job.queueName, Job: job.id });\n    }\n  };\n\n  private onQueueProgress = (jobId: string, progress: unknown): void => {\n    this.log('Progress update', {\n      'Job ID': jobId,\n      Progress: progress,\n    });\n  };\n\n  private onQueueRemoved = (jobId: string): void => {\n    this.log('Removed queue', { Job: jobId });\n  };\n\n  public addJobToQueue = async <\n    TPayload extends QueueJobPayload = QueueJobPayload,\n    TMetadata extends Record<string, unknown> = Record<string, unknown>,\n    TResult = unknown,\n    TName extends string = string,\n  >({\n    queueId,\n    jobId,\n    data,\n  }: {\n    queueId: string;\n    jobId: TName;\n    data: QueueJobData<TPayload, TMetadata>;\n  }): Promise<Job<QueueJobData<TPayload, TMetadata>, TResult, TName> | undefined> => {\n    const queue = this.queues.get(queueId);\n\n    if (!queue) {\n      this.log('Queue not found', { 'Queue ID': queueId });\n\n      return;\n    }\n\n    const job = (await queue.add(jobId, data)) as Job<QueueJobData<TPayload, TMetadata>, TResult, TName>;\n\n    if (this.applicationConfig.queue.log?.jobAdded) {\n      const dataStr = JSON.stringify(data);\n      const maxLogDataStrLength = 50;\n      const truncatedLogDataStr =\n        dataStr.length > maxLogDataStrLength ? `${dataStr.substring(0, maxLogDataStrLength)}...` : dataStr;\n\n      this.log('Job added', {\n        Queue: queueId,\n        'Job ID': jobId,\n        Data: truncatedLogDataStr,\n      });\n    }\n\n    return job;\n  };\n\n  private workerProcessor = async (job: Job): Promise<unknown> => {\n    if (!job) {\n      return;\n    }\n\n    const startTime = Time.now();\n\n    // Add start time to job data\n    if (typeof job.updateData === 'function') {\n      try {\n        await job.updateData({ ...job.data, startTime });\n      } catch (error) {\n        Logger.warn({\n          message: 'Failed to persist job metadata before processing',\n          meta: {\n            Queue: job.queueName,\n            'Job Name': job.name,\n            'Job ID': job.id,\n            Error: error instanceof Error ? error.message : String(error),\n          },\n        });\n      }\n    }\n\n    this.log('Worker processing...', {\n      Queue: job.queueName,\n      'Job Name': job.name,\n      'Job ID': job.id,\n    });\n\n    const processor = this.jobProcessors.get(job.name);\n\n    if (!processor) {\n      throw new Error(`No processor registered for job (Name: ${job.name})`);\n    }\n\n    let result: unknown;\n    let error: Error | undefined;\n\n    try {\n      // Call beforeProcess hook\n      await processor.beforeProcess({ job });\n\n      // Execute main processing\n      result = await processor.process({ job });\n\n      return result;\n    } catch (err) {\n      error = err as Error;\n\n      Logger.warn({\n        message: 'Queue worker processing error',\n        meta: {\n          Queue: job.queueName,\n          'Job Name': job.name,\n          'Job ID': job.id,\n          Error: error.message,\n        },\n      });\n\n      Logger.error({ error });\n\n      throw error; // Re-throw to mark job as failed\n    } finally {\n      // ALWAYS call afterProcess for cleanup (even on error)\n      try {\n        await processor.afterProcess({ job, result, error });\n      } catch (cleanupError) {\n        // Log but don't throw - cleanup errors shouldn't fail the job\n        Logger.error({\n          error: cleanupError,\n          message: 'Error in processor afterProcess cleanup',\n        });\n      }\n    }\n  };\n\n  public async listAllJobsWithStatus(): Promise<JobSummary[]> {\n    const jobsSummary: JobSummary[] = [];\n\n    for (const [queueName, queue] of this.queues) {\n      const jobStates = ['active', 'waiting', 'completed', 'failed', 'delayed', 'paused'] as const;\n\n      const jobsDetailsPromises = jobStates.map(async state => {\n        const jobs = await queue.getJobs([state]);\n        return jobs.map(\n          (job): JobSummary => ({\n            id: job.id ?? 'unknown',\n            name: job.name ?? 'unknown',\n            queueName,\n            state,\n            attemptsMade: job.attemptsMade,\n            failedReason: job.failedReason,\n          }),\n        );\n      });\n\n      const results = await Promise.all(jobsDetailsPromises);\n      const flattenedResults = results.flat();\n\n      jobsSummary.push(...flattenedResults);\n    }\n\n    return jobsSummary;\n  }\n\n  /**\n   * Disconnect all queues and workers, cleanup resources.\n   * Should be called during application shutdown.\n   */\n  public async disconnect(): Promise<void> {\n    // First, close all workers (they process jobs)\n    for (const [name, worker] of this.workers) {\n      try {\n        await worker.cleanup();\n        this.log('Worker closed', { Name: name });\n      } catch (error) {\n        Logger.error({\n          error,\n          message: `Failed to close worker: ${name}`,\n        });\n      }\n    }\n\n    // Then, close all queues (they manage job state)\n    for (const [name, queue] of this.queues) {\n      try {\n        queue.removeAllListeners();\n        await queue.close();\n        this.log('Queue closed', { Name: name });\n      } catch (error) {\n        Logger.error({\n          error,\n          message: `Failed to close queue: ${name}`,\n        });\n      }\n    }\n\n    // Clear all maps\n    this.workers.clear();\n    this.queues.clear();\n    this.jobProcessors.clear();\n\n    this.log('Queue manager disconnected');\n  }\n\n  /**\n   * Log queue message\n   */\n  public log(message: string, meta?: Record<string, unknown>): void {\n    this.logger.custom({ level: 'queue', message, meta });\n  }\n}\n"],
+  "mappings": "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",
   "names": ["error"]
 }

package/dist/queue/worker.d.ts

@@ -10,5 +10,10 @@ export default class QueueWorker extends Worker {
     private onWorkerFailed;
     private onWorkerStalled;
     private onWorkerCompleted;
+    /**
+     * Cleanup worker resources before shutdown.
+     * Removes all event listeners and closes the worker connection.
+     */
+    cleanup(): Promise<void>;
 }
 //# sourceMappingURL=worker.d.ts.map

package/dist/queue/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/queue/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAQ1E,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,MAAM;IAC7C,OAAO,CAAC,iBAAiB,CAAoB;IAE7C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,EACV,iBAAiB,EACjB,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,OAAO,EACP,aAAa,GACd,EAAE,4BAA4B;IAe/B,OAAO,CAAC,cAAc,CAMpB;IAEF,OAAO,CAAC,aAAa,CAEnB;IAEF,OAAO,CAAC,cAAc,CAcpB;IAEF,OAAO,CAAC,eAAe,CAErB;IAEF,OAAO,CAAC,iBAAiB,CAwBvB;CACH"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/queue/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAQ1E,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,MAAM;IAC7C,OAAO,CAAC,iBAAiB,CAAoB;IAE7C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,EACV,iBAAiB,EACjB,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,OAAO,EACP,aAAa,GACd,EAAE,4BAA4B;IAe/B,OAAO,CAAC,cAAc,CAMpB;IAEF,OAAO,CAAC,aAAa,CAEnB;IAEF,OAAO,CAAC,cAAc,CAcpB;IAEF,OAAO,CAAC,eAAe,CAErB;IAEF,OAAO,CAAC,iBAAiB,CAwBvB;IAEF;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAItC"}

package/dist/queue/worker.js

@@ -65,6 +65,14 @@ class QueueWorker extends Worker {
       });
     }
   }, "onWorkerCompleted");
+  /**
+   * Cleanup worker resources before shutdown.
+   * Removes all event listeners and closes the worker connection.
+   */
+  async cleanup() {
+    this.removeAllListeners();
+    await this.close();
+  }
 }
 export {
   QueueWorker as default