@scpxl/nodejs-framework 1.0.13 → 1.0.17

package/README.md

@@ -2,194 +2,117 @@
 
 A comprehensive Node.js framework for building modern applications with support for web servers, databases, queues, caching, and more.
 
-## Installation
+Opinionated TypeScript framework combining Fastify, WebSockets, Redis, BullMQ, and MikroORM under a unified Application lifecycle.
 
-Install the framework from NPM:
+## Install
 
-```sh
+```bash
 npm install @scpxl/nodejs-framework
 ```
 
 ## Quick Start
 
 ```ts
-import { WebApplication } from '@scpxl/nodejs-framework/application';
+import { Application } from '@scpxl/nodejs-framework';
 
-const app = new WebApplication({
-  webServer: {
-    port: 3000,
-    host: '0.0.0.0'
-  },
-  database: {
-    host: 'localhost',
-    port: 5432,
-    dbName: 'myapp',
-    user: 'user',
-    password: 'password'
-  }
+const app = new Application({
+  webserver: { port: 3000 },
+  logger: { level: 'info' },
 });
 
 await app.start();
-```
-
-## Features
-
-- 🚀 **FastAPI-powered Web Server** with auto-routing
-- 🗄️ **Database Integration** with MikroORM and PostgreSQL
-- 📦 **Queue System** using BullMQ and Redis
-- 🔄 **WebSocket Support** for real-time communication
-- 🗄️ **Caching Layer** with Redis integration
-- ☁️ **AWS S3 Integration** for file storage
-- 🔐 **Authentication System** with JWT
-- 📊 **Structured Logging** with Winston
-- 🧪 **Built-in Testing Utils**
-- ⚡ **Performance Monitoring**
 
-## Development (Framework Contributors)
-
-### Local Development
-
-Clone this repository and switch to the project specific Node.js version:
-
-```sh
-git clone https://github.com/PXLbros/pxl-nodejs-framework.git
-cd pxl-nodejs-framework
-nvm use
-npm install
-```
-
-### Build
-
-```sh
-npm run build
-```
-
-### Testing with Yalc (Local Development)
-
-For local testing before publishing to NPM:
-
-```sh
-# Build and publish locally
-npm run build:local
-
-# In your project
-yalc add @pxl/nodejs-framework
+app.webserver.route({
+  method: 'GET',
+  url: '/health',
+  handler: async () => ({ ok: true }),
+});
 ```
 
-## Development
-
-### Local Development
-
-For local development with automatic publishing through **Yalc**:
+## Add WebSocket
 
-```sh
-npm run dev
+```ts
+app.websocket.onConnection(client => {
+  client.sendJSON({ welcome: true });
+});
 ```
 
-For building locally with Yalc publishing:
+## Add Queue Job
 
-```sh
-npm run build:local
+```ts
+await app.queue.manager.add('email', { userId: 123 });
 ```
 
-For building without Yalc (CI/production build):
+## Configuration Example
 
-```sh
-npm run build
+```ts
+new Application({
+  webserver: { port: 3000 },
+  websocket: { enabled: true },
+  queue: { enabled: true },
+  redis: { host: '127.0.0.1', port: 6379 },
+  database: {
+    /* MikroORM config */
+  },
+  logger: { level: 'info' },
+});
 ```
 
-## CI/CD Pipeline
-
-This project uses GitHub Actions for continuous integration and deployment:
-
-### Build and Test (CI)
-
-- Runs on all pull requests
-- Installs dependencies, runs linting, builds the project, and runs tests
-
-### Build and Publish
-
-- Runs on pushes to `main`/`master` branches and version tags
-- Builds the project and publishes to npm
-- Beta releases are published on pushes to main/master branches
-- Stable releases are published when version tags are created
-
-### Setup for Publishing
-
-To enable automatic publishing, configure the following repository secret:
-
-- `NPM_TOKEN`: Your npm authentication token
-
-> **Note**: The `dist/` folder is gitignored and automatically generated during the CI/CD process. Do not commit built files to the repository.
-
-## Releasing
+## Features
 
-Use the built-in release script to create new versions:
+- Unified lifecycle (start/stop all subsystems)
+- Fastify routing + raw access
+- WebSocket client + room management
+- BullMQ queue integration
+- MikroORM database integration
+- Redis cache + pub/sub
+- Structured logging
+- Utilities & services layer
 
-### Quick Release Commands
+## Documentation
 
-```sh
-# Patch release (1.0.0 → 1.0.1)
-npm run release -- --patch
+Full docs & guides (VitePress) + API reference (TypeDoc).
 
-# Minor release (1.0.0 → 1.1.0)
-npm run release -- --minor
+- Getting Started, Concepts, Guides
+- API: https://pxlbros.github.io/pxl-nodejs-framework/
 
-# Major release (1.0.0 → 2.0.0)
-npm run release -- --major
+To run local docs site (once cloned):
 
-# Specific version
-npm run release -- --version 2.1.3
+```bash
+npm run docs:site:dev
 ```
 
-### Release Process
+## Graceful Shutdown
 
-The release script will:
-
-1. Check that your working directory is clean
-2. Verify you're on the main/master branch
-3. Update the version in `package.json`
-4. Create a git commit and tag
-5. Push to origin, triggering GitHub Actions
-
-### Dry Run
-
-Preview what the release script will do without making changes:
-
-```sh
-npm run release -- --patch --dry-run
+```ts
+process.on('SIGINT', () => app.stop());
+process.on('SIGTERM', () => app.stop());
 ```
 
-### Help
-
-For more information about the release script:
+## Example Service Pattern
 
-```sh
-npm run release -- --help
+```ts
+class UserService {
+  constructor(private app: Application) {}
+  async register(data: any) {
+    // use app.database / app.queue / app.logger
+  }
+}
 ```
 
-## Documentation
+## When Not to Use
 
-The API documentation is automatically generated using TypeDoc and deployed via GitHub Actions to GitHub Pages.
+If you only need a single HTTP server or minimal script, this framework may be heavier than needed.
 
-### Local Documentation Development
+## Contributing
 
-To generate and view documentation locally:
+Issues and PRs welcome. Development scripts remain available:
 
-```sh
-npm run docs
+```bash
+npm run dev     # watch build
+npm run build   # production build
 ```
 
-This will generate the documentation in the `docs/` folder. You can then open `docs/index.html` in your browser.
-
-### Automated Documentation Deployment
-
-Documentation is automatically built and deployed to GitHub Pages when:
-
-- Code is pushed to the `main` or `master` branch
-- Pull requests are opened against `main` or `master` branch
-- Manual workflow dispatch is triggered
-
-The documentation will be available at: `https://[your-username].github.io/[repository-name]/`
+---
 
-> **Note**: The `docs/` folder is gitignored and should not be committed to the repository as it's automatically generated by the CI/CD pipeline.
+Released under ISC License.

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

@@ -6,6 +6,7 @@ import type RedisInstance from '../redis/instance.js';
 import CacheManager from '../cache/manager.js';
 import EventManager from '../event/manager.js';
 import { PerformanceMonitor } from '../performance/performance-monitor.js';
+import { LifecycleManager } from '../lifecycle/lifecycle-manager.js';
 export type { ApplicationConfig } from './base-application.interface.js';
 export default abstract class BaseApplication {
     /** Unique instance ID */
@@ -38,6 +39,8 @@ export default abstract class BaseApplication {
     eventManager?: EventManager;
     /** Performance monitor */
     performanceMonitor?: PerformanceMonitor;
+    /** Lifecycle manager */
+    protected lifecycle: LifecycleManager;
     get Name(): string;
     /**
      * Application constructor

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

@@ -15,6 +15,8 @@ import EventManager from "../event/manager.js";
 import Logger from "../logger/logger.js";
 import { PerformanceMonitor } from "../performance/performance-monitor.js";
 import { CachePerformanceWrapper, DatabasePerformanceWrapper, QueuePerformanceWrapper } from "../performance/index.js";
+import { LifecycleManager } from "../lifecycle/lifecycle-manager.js";
+import { requestExit } from "../lifecycle/exit.js";
 class BaseApplication {
   static {
     __name(this, "BaseApplication");
@@ -49,6 +51,8 @@ class BaseApplication {
   eventManager;
   /** Performance monitor */
   performanceMonitor;
+  /** Lifecycle manager */
+  lifecycle = new LifecycleManager();
   get Name() {
     return this.config.name;
   }
@@ -233,8 +237,11 @@ class BaseApplication {
         await options.onStarted({ startupTime });
       }
     } catch (error) {
-      console.error(error);
-      process.exit(1);
+      Logger.error({
+        error: error instanceof Error ? error : new Error(String(error)),
+        message: "startInstance failure"
+      });
+      throw error;
     }
   }
   /**
@@ -263,14 +270,16 @@ class BaseApplication {
     if (this.config.performanceMonitoring.monitorCacheOperations !== false) {
       CachePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);
     }
-    if (this.config.performanceMonitoring.reportInterval && this.config.performanceMonitoring.reportInterval > 0) {
-      setInterval(() => {
-        const reportFormat = this.config.performanceMonitoring?.reportFormat ?? "detailed";
-        const report = this.performanceMonitor?.generateFormattedReport(reportFormat);
-        if (report) {
-          Logger.info({ message: report });
-        }
-      }, this.config.performanceMonitoring.reportInterval);
+    if (this.config.performanceMonitoring?.reportInterval && this.config.performanceMonitoring.reportInterval > 0) {
+      this.lifecycle.trackInterval(
+        setInterval(() => {
+          const reportFormat = this.config.performanceMonitoring?.reportFormat ?? "detailed";
+          const report = this.performanceMonitor?.generateFormattedReport(reportFormat);
+          if (report) {
+            Logger.info({ message: report });
+          }
+        }, this.config.performanceMonitoring.reportInterval)
+      );
     }
   }
   setupGlobalErrorHandlers() {
@@ -300,7 +309,7 @@ class BaseApplication {
         error: error instanceof Error ? error : new Error(String(error)),
         message: "Error during graceful shutdown"
       });
-      process.exit(1);
+      requestExit({ code: 1, reason: "graceful-shutdown-error", error });
     });
   }
   /**
@@ -323,7 +332,7 @@ class BaseApplication {
     this.isStopping = true;
     const forceExitTimeout = setTimeout(() => {
       Logger.warn({ message: "Forced shutdown due to timeout" });
-      process.exit(1);
+      requestExit({ code: 1, reason: "forced-timeout" });
     }, this.shutdownTimeout);
     try {
       await this.stopCallback();
@@ -333,14 +342,14 @@ class BaseApplication {
         await onStopped({ runtime });
       }
       clearTimeout(forceExitTimeout);
-      process.exit(0);
+      requestExit({ code: 0, reason: "shutdown-complete" });
     } catch (error) {
       Logger.error({
         error: error instanceof Error ? error : new Error(String(error)),
         message: "Error during shutdown"
       });
       clearTimeout(forceExitTimeout);
-      process.exit(1);
+      requestExit({ code: 1, reason: "shutdown-error", error });
     }
   }
 }

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 { PerformanceMonitor } from '../performance/performance-monitor.js';\nimport { CachePerformanceWrapper, DatabasePerformanceWrapper, QueuePerformanceWrapper } from '../performance/index.js';\n\n// Re-export types for external use\nexport type { ApplicationConfig } from './base-application.interface.js';\n\nexport default abstract class BaseApplication {\n  /** Unique instance ID */\n  public uniqueInstanceId: string;\n\n  /** Shutdown signals */\n  protected shutdownSignals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT'];\n\n  /** Application start time */\n  protected startTime: [number, number] = [0, 0];\n\n  /** Whether application is stopping */\n  protected isStopping = false;\n\n  /** Shutdown timeout (30 seconds) */\n  protected shutdownTimeout = 30000;\n\n  /** Cache for application version to avoid repeated imports */\n  private static applicationVersionCache: string | undefined;\n\n  /** Cluster worker ID */\n  protected workerId = cluster.isWorker && cluster.worker ? cluster.worker.id : null;\n\n  /** Application config */\n  protected config: ApplicationConfig;\n\n  /** Application version */\n  protected applicationVersion?: string;\n\n  /** Redis manager */\n  public redisManager: RedisManager;\n\n  /** Cache manager */\n  public cacheManager: CacheManager;\n\n  /** Database manager */\n  public databaseManager?: DatabaseManager;\n\n  /** Queue manager */\n  public queueManager?: QueueManager;\n\n  /** Event manager */\n  public eventManager?: EventManager;\n\n  /** Performance monitor */\n  public performanceMonitor?: PerformanceMonitor;\n\n  public get Name() {\n    return this.config.name;\n  }\n\n  /**\n   * Application constructor\n   */\n  constructor(config: ApplicationConfig) {\n    const computerName = os.hostname();\n\n    this.uniqueInstanceId = `${config.instanceId}-${computerName}-${OS.getUniqueComputerId()}`;\n\n    this.config = config;\n\n    // const schema = Joi.object({\n    //   name: Joi.string().required(),\n\n    //   redis: {\n    //     host: Joi.string().required(),\n    //     port: Joi.number().required(),\n    //     password: Joi.string().allow('').optional(),\n    //   },\n\n    //   database: {\n    //     host: Joi.string().required(),\n    //     port: Joi.number().required(),\n    //     username: Joi.string().required(),\n    //     password: Joi.string().required(),\n    //     databaseName: Joi.string().required(),\n    //   },\n    // });\n\n    // // Validation application constructor props\n    // const validationResult = schema.validate(props);\n\n    // if (validationResult.error) {\n    //   throw new Error(validationResult.error.message);\n    // }\n\n    // Initialize Redis manager\n    this.redisManager = new RedisManager({\n      applicationConfig: this.config,\n      host: this.config.redis.host,\n      port: this.config.redis.port,\n      password: this.config.redis.password,\n    });\n\n    // Initialize cache manager\n    this.cacheManager = new CacheManager({\n      applicationConfig: this.config,\n      redisManager: this.redisManager,\n    });\n\n    // Initialize performance monitor\n    this.initializePerformanceMonitor();\n\n    // Set up global error handlers\n    this.setupGlobalErrorHandlers();\n\n    if (this.config.database && this.config.database.enabled === true) {\n      const defaultEntitiesDirectory = join(this.config.rootDirectory, 'src', 'database', 'entities');\n\n      if (!this.config.database.entitiesDirectory) {\n        this.config.database.entitiesDirectory = defaultEntitiesDirectory;\n      }\n\n      if (!existsSync(this.config.database.entitiesDirectory)) {\n        throw new Error(`Database entities directory not found (Path: ${this.config.database.entitiesDirectory})`);\n      }\n\n      // Initialize Database manager\n      this.databaseManager = new DatabaseManager({\n        applicationConfig: this.config,\n        host: this.config.database.host,\n        port: this.config.database.port,\n        username: this.config.database.username,\n        password: this.config.database.password,\n        databaseName: this.config.database.databaseName,\n        entitiesDirectory: this.config.database.entitiesDirectory,\n      });\n    }\n  }\n\n  /**\n   * Get application version\n   */\n  public async getApplicationVersion(): Promise<string> {\n    // Return cached version if available\n    if (BaseApplication.applicationVersionCache !== undefined) {\n      return BaseApplication.applicationVersionCache;\n    }\n\n    // Resolve the path to package.json\n    const __filename = fileURLToPath(import.meta.url);\n    const __dirname = dirname(__filename);\n    const packageJsonPath = resolve(__dirname, '../../package.json');\n\n    // Read and parse the file\n    const fileContents = readFileSync(packageJsonPath, 'utf-8');\n    const packageJson = JSON.parse(fileContents);\n\n    if (!packageJson?.version) {\n      throw new Error('Application version not found');\n    }\n\n    // Cache and return the version\n    BaseApplication.applicationVersionCache = packageJson.version;\n\n    return packageJson.version;\n  }\n\n  /**\n   * Start application\n   */\n  public async start(): Promise<void> {\n    // Start application timer\n    this.startTime = process.hrtime();\n\n    // Get application version`\n    this.applicationVersion = await this.getApplicationVersion();\n\n    const startInstanceOptions: ApplicationStartInstanceOptions = {\n      // onStarted: ({ startupTime }) => {\n      //   if (this.config.log?.startUp) {\n      //     Logger.info('Application started', {\n      //       Name: this.config.name,\n      //       'PXL Framework Version': this.applicationVersion,\n      //       'Startup Time': Time.formatTime({ time: startupTime, format: 's', numDecimals: 2, showUnit: true }),\n      //     });\n      //   }\n\n      //   if (this.config.events?.onStarted) {\n      //     this.config.events.onStarted({ app: this, startupTime });\n      //   }\n      // },\n      onStarted: this.onStarted.bind(this),\n    };\n\n    const stopInstanceOptions: ApplicationStopInstanceOptions = {\n      // onStopped: ({ runtime }) => {\n      //   if (this.config.log?.shutdown) {\n      //     Logger.info('Application stopped', {\n      //       Name: this.config.name,\n      //       'Runtime': Time.formatTime({ time: runtime, format: 's', numDecimals: 2, showUnit: true }),\n      //     });\n      //   }\n\n      //   if (this.config.events?.onStopped) {\n      //     this.config.events.onStopped({ app: this, runtime });\n      //   }\n      // },\n      onStopped: this.onStopped.bind(this),\n    };\n\n    if (this.config.cluster?.enabled) {\n      // Initialize clustered application\n      const clusterManager = new ClusterManager({\n        config: this.config.cluster,\n\n        startApplicationCallback: () => this.startInstance(startInstanceOptions),\n        stopApplicationCallback: () => this.stop(stopInstanceOptions),\n      });\n\n      // Start cluster\n      clusterManager.start();\n    } else {\n      // Start standalone application\n      await this.startInstance(startInstanceOptions);\n\n      // Handle standalone application shutdown\n      this.handleShutdown({\n        onStopped: stopInstanceOptions.onStopped,\n      });\n    }\n  }\n\n  /**\n   * Before application start\n   */\n  private async onBeforeStart(): Promise<{\n    redisInstance: RedisInstance;\n    databaseInstance: DatabaseInstance | null;\n    queueManager: QueueManager;\n    eventManager?: EventManager;\n  }> {\n    // Connect to Redis\n    const redisInstance = await this.redisManager.connect();\n\n    // Connect to database\n    const databaseInstance = this.databaseManager ? await this.databaseManager.connect() : null;\n\n    let eventManager: EventManager | undefined;\n\n    if (this.config.event?.enabled) {\n      eventManager = new EventManager({\n        applicationConfig: this.config,\n        options: this.config.event,\n        events: this.config.event.events || [],\n        redisInstance,\n        databaseInstance,\n        // queueManager,\n      });\n\n      eventManager.load();\n    }\n\n    // Initialize queue\n    const queueManager = new QueueManager({\n      applicationConfig: this.config,\n      options: {\n        processorsDirectory: this.config.queue.processorsDirectory,\n      },\n      queues: this.config.queue.queues,\n      redisInstance,\n      databaseInstance,\n      eventManager,\n    });\n\n    // Register queues\n    await queueManager.registerQueues({\n      queues: this.config.queue.queues,\n    });\n\n    return {\n      redisInstance,\n      databaseInstance,\n      queueManager,\n      eventManager,\n    };\n  }\n\n  /**\n   * Application started event\n   */\n  protected onStarted({ startupTime: _startupTime }: { startupTime: number }): void {}\n\n  /**\n   * Application stopped event\n   */\n  protected onStopped({ runtime: _runtime }: { runtime: number }): void {}\n\n  /**\n   * Before application stop event\n   */\n  private async onBeforeStop(): Promise<void> {\n    // Disconnect from Redis\n    await this.redisManager.disconnect();\n\n    if (this.databaseManager) {\n      // Disconnect from database\n      await this.databaseManager.disconnect();\n    }\n  }\n\n  /**\n   * Start application instance\n   */\n  private async startInstance(options: ApplicationStartInstanceOptions): Promise<void> {\n    try {\n      // Before application start\n      const { redisInstance, databaseInstance, queueManager, eventManager } = await this.onBeforeStart();\n\n      // Start application\n      await this.startHandler({\n        redisInstance,\n        databaseInstance,\n        queueManager,\n        eventManager,\n      });\n\n      // Calculate application startup time\n      const startupTime = Time.calculateElapsedTime({\n        startTime: this.startTime,\n      });\n\n      // On application started\n      if (options.onStarted) {\n        await options.onStarted({ startupTime });\n      }\n    } catch (error) {\n      // Log error\n      console.error(error);\n\n      process.exit(1);\n    }\n  }\n\n  protected abstract startHandler({\n    redisInstance,\n    databaseInstance,\n    queueManager,\n    eventManager,\n  }: {\n    redisInstance: RedisInstance;\n    databaseInstance?: DatabaseInstance | null;\n    queueManager: QueueManager;\n    eventManager?: EventManager | null;\n  }): Promise<void>;\n\n  protected abstract stopCallback(): void;\n\n  /**\n   * Set up global error handlers\n   */\n  /**\n   * Initialize performance monitor\n   */\n  private initializePerformanceMonitor(): void {\n    // Check if performance monitoring is enabled\n    if (!this.config.performanceMonitoring?.enabled) {\n      return;\n    }\n\n    // Initialize performance monitor with configuration\n    this.performanceMonitor = PerformanceMonitor.initialize({\n      enabled: true,\n      thresholds: this.config.performanceMonitoring.thresholds,\n      maxMetricsHistory: this.config.performanceMonitoring.maxMetricsHistory,\n      logSlowOperations: this.config.performanceMonitoring.logSlowOperations,\n      logAllOperations: this.config.performanceMonitoring.logAllOperations,\n    });\n\n    // Set up performance monitoring for different components\n    if (this.config.performanceMonitoring.monitorDatabaseOperations !== false) {\n      DatabasePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);\n    }\n\n    if (this.config.performanceMonitoring.monitorQueueOperations !== false) {\n      QueuePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);\n    }\n\n    if (this.config.performanceMonitoring.monitorCacheOperations !== false) {\n      CachePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);\n    }\n\n    // Set up periodic performance reports if configured\n    if (this.config.performanceMonitoring.reportInterval && this.config.performanceMonitoring.reportInterval > 0) {\n      setInterval(() => {\n        const reportFormat = this.config.performanceMonitoring?.reportFormat ?? 'detailed';\n        const report = this.performanceMonitor?.generateFormattedReport(reportFormat);\n\n        if (report) {\n          Logger.info({ message: report });\n        }\n      }, this.config.performanceMonitoring.reportInterval);\n    }\n  }\n\n  private setupGlobalErrorHandlers(): void {\n    // Handle uncaught exceptions\n    process.on('uncaughtException', error => {\n      Logger.error({ error, message: 'Uncaught Exception' });\n      this.initiateGracefulShutdown();\n    });\n\n    // Handle unhandled promise rejections\n    process.on('unhandledRejection', (reason, promise) => {\n      Logger.error({\n        error: reason instanceof Error ? reason : new Error(String(reason)),\n        message: 'Unhandled Rejection',\n        meta: { promise },\n      });\n      this.initiateGracefulShutdown();\n    });\n  }\n\n  /**\n   * Initiate graceful shutdown\n   */\n  private initiateGracefulShutdown(): void {\n    if (this.isStopping) {\n      return;\n    }\n\n    Logger.info({ message: 'Initiating graceful shutdown due to error' });\n    this.stop().catch(error => {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(String(error)),\n        message: 'Error during graceful shutdown',\n      });\n      process.exit(1);\n    });\n  }\n\n  /**\n   * Handle shutdown\n   */\n  public handleShutdown({ onStopped }: { onStopped?: ({ runtime }: { runtime: number }) => void }): void {\n    this.shutdownSignals.forEach(signal => {\n      process.on(signal, async () => {\n        // Stop application\n        await this.stop({ onStopped });\n      });\n    });\n  }\n\n  /**\n   * Stop application\n   */\n  private async stop({ onStopped }: ApplicationStopInstanceOptions = {}): Promise<void> {\n    if (this.isStopping) {\n      return;\n    }\n\n    this.isStopping = true;\n\n    // Set timeout for forced termination\n    const forceExitTimeout = setTimeout(() => {\n      Logger.warn({ message: 'Forced shutdown due to timeout' });\n      process.exit(1);\n    }, this.shutdownTimeout);\n\n    try {\n      // Stop callback\n      await this.stopCallback();\n\n      // Disconnect\n      await this.onBeforeStop();\n\n      if (onStopped) {\n        // Calculate runtime\n        const runtime = process.uptime() * 1000;\n\n        // Emit stopped event\n        await onStopped({ runtime });\n      }\n\n      clearTimeout(forceExitTimeout);\n      process.exit(0);\n    } catch (error) {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(String(error)),\n        message: 'Error during shutdown',\n      });\n      clearTimeout(forceExitTimeout);\n      process.exit(1);\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import cluster from 'cluster';\nimport { existsSync, readFileSync } from 'fs';\nimport { fileURLToPath } from 'url';\nimport { dirname, join, resolve } from 'path';\nimport { type DatabaseInstance, DatabaseManager } from '../database/index.js';\nimport QueueManager from '../queue/manager.js';\nimport RedisManager from '../redis/manager.js';\nimport type {\n  ApplicationConfig,\n  ApplicationStartInstanceOptions,\n  ApplicationStopInstanceOptions,\n} from './base-application.interface.js';\nimport ClusterManager from '../cluster/cluster-manager.js';\nimport type RedisInstance from '../redis/instance.js';\nimport { OS, Time } from '../util/index.js';\nimport CacheManager from '../cache/manager.js';\nimport os from 'os';\nimport EventManager from '../event/manager.js';\nimport Logger from '../logger/logger.js';\nimport { PerformanceMonitor } from '../performance/performance-monitor.js';\nimport { CachePerformanceWrapper, DatabasePerformanceWrapper, QueuePerformanceWrapper } from '../performance/index.js';\nimport { LifecycleManager } from '../lifecycle/lifecycle-manager.js';\nimport { requestExit } from '../lifecycle/exit.js';\n\n// Re-export types for external use\nexport type { ApplicationConfig } from './base-application.interface.js';\n\nexport default abstract class BaseApplication {\n  /** Unique instance ID */\n  public uniqueInstanceId: string;\n\n  /** Shutdown signals */\n  protected shutdownSignals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT'];\n\n  /** Application start time */\n  protected startTime: [number, number] = [0, 0];\n\n  /** Whether application is stopping */\n  protected isStopping = false;\n\n  /** Shutdown timeout (30 seconds) */\n  protected shutdownTimeout = 30000;\n\n  /** Cache for application version to avoid repeated imports */\n  private static applicationVersionCache: string | undefined;\n\n  /** Cluster worker ID */\n  protected workerId = cluster.isWorker && cluster.worker ? cluster.worker.id : null;\n\n  /** Application config */\n  protected config: ApplicationConfig;\n\n  /** Application version */\n  protected applicationVersion?: string;\n\n  /** Redis manager */\n  public redisManager: RedisManager;\n\n  /** Cache manager */\n  public cacheManager: CacheManager;\n\n  /** Database manager */\n  public databaseManager?: DatabaseManager;\n\n  /** Queue manager */\n  public queueManager?: QueueManager;\n\n  /** Event manager */\n  public eventManager?: EventManager;\n\n  /** Performance monitor */\n  public performanceMonitor?: PerformanceMonitor;\n\n  /** Lifecycle manager */\n  protected lifecycle: LifecycleManager = new LifecycleManager();\n\n  public get Name() {\n    return this.config.name;\n  }\n\n  /**\n   * Application constructor\n   */\n  constructor(config: ApplicationConfig) {\n    const computerName = os.hostname();\n\n    this.uniqueInstanceId = `${config.instanceId}-${computerName}-${OS.getUniqueComputerId()}`;\n\n    this.config = config;\n\n    // const schema = Joi.object({\n    //   name: Joi.string().required(),\n\n    //   redis: {\n    //     host: Joi.string().required(),\n    //     port: Joi.number().required(),\n    //     password: Joi.string().allow('').optional(),\n    //   },\n\n    //   database: {\n    //     host: Joi.string().required(),\n    //     port: Joi.number().required(),\n    //     username: Joi.string().required(),\n    //     password: Joi.string().required(),\n    //     databaseName: Joi.string().required(),\n    //   },\n    // });\n\n    // // Validation application constructor props\n    // const validationResult = schema.validate(props);\n\n    // if (validationResult.error) {\n    //   throw new Error(validationResult.error.message);\n    // }\n\n    // Initialize Redis manager\n    this.redisManager = new RedisManager({\n      applicationConfig: this.config,\n      host: this.config.redis.host,\n      port: this.config.redis.port,\n      password: this.config.redis.password,\n    });\n\n    // Initialize cache manager\n    this.cacheManager = new CacheManager({\n      applicationConfig: this.config,\n      redisManager: this.redisManager,\n    });\n\n    // Initialize performance monitor\n    this.initializePerformanceMonitor();\n\n    // Set up global error handlers\n    this.setupGlobalErrorHandlers();\n\n    if (this.config.database && this.config.database.enabled === true) {\n      const defaultEntitiesDirectory = join(this.config.rootDirectory, 'src', 'database', 'entities');\n\n      if (!this.config.database.entitiesDirectory) {\n        this.config.database.entitiesDirectory = defaultEntitiesDirectory;\n      }\n\n      if (!existsSync(this.config.database.entitiesDirectory)) {\n        throw new Error(`Database entities directory not found (Path: ${this.config.database.entitiesDirectory})`);\n      }\n\n      // Initialize Database manager\n      this.databaseManager = new DatabaseManager({\n        applicationConfig: this.config,\n        host: this.config.database.host,\n        port: this.config.database.port,\n        username: this.config.database.username,\n        password: this.config.database.password,\n        databaseName: this.config.database.databaseName,\n        entitiesDirectory: this.config.database.entitiesDirectory,\n      });\n    }\n  }\n\n  /**\n   * Get application version\n   */\n  public async getApplicationVersion(): Promise<string> {\n    // Return cached version if available\n    if (BaseApplication.applicationVersionCache !== undefined) {\n      return BaseApplication.applicationVersionCache;\n    }\n\n    // Resolve the path to package.json\n    const __filename = fileURLToPath(import.meta.url);\n    const __dirname = dirname(__filename);\n    const packageJsonPath = resolve(__dirname, '../../package.json');\n\n    // Read and parse the file\n    const fileContents = readFileSync(packageJsonPath, 'utf-8');\n    const packageJson = JSON.parse(fileContents);\n\n    if (!packageJson?.version) {\n      throw new Error('Application version not found');\n    }\n\n    // Cache and return the version\n    BaseApplication.applicationVersionCache = packageJson.version;\n\n    return packageJson.version;\n  }\n\n  /**\n   * Start application\n   */\n  public async start(): Promise<void> {\n    // Start application timer\n    this.startTime = process.hrtime();\n\n    // Get application version`\n    this.applicationVersion = await this.getApplicationVersion();\n\n    const startInstanceOptions: ApplicationStartInstanceOptions = {\n      // onStarted: ({ startupTime }) => {\n      //   if (this.config.log?.startUp) {\n      //     Logger.info('Application started', {\n      //       Name: this.config.name,\n      //       'PXL Framework Version': this.applicationVersion,\n      //       'Startup Time': Time.formatTime({ time: startupTime, format: 's', numDecimals: 2, showUnit: true }),\n      //     });\n      //   }\n\n      //   if (this.config.events?.onStarted) {\n      //     this.config.events.onStarted({ app: this, startupTime });\n      //   }\n      // },\n      onStarted: this.onStarted.bind(this),\n    };\n\n    const stopInstanceOptions: ApplicationStopInstanceOptions = {\n      // onStopped: ({ runtime }) => {\n      //   if (this.config.log?.shutdown) {\n      //     Logger.info('Application stopped', {\n      //       Name: this.config.name,\n      //       'Runtime': Time.formatTime({ time: runtime, format: 's', numDecimals: 2, showUnit: true }),\n      //     });\n      //   }\n\n      //   if (this.config.events?.onStopped) {\n      //     this.config.events.onStopped({ app: this, runtime });\n      //   }\n      // },\n      onStopped: this.onStopped.bind(this),\n    };\n\n    if (this.config.cluster?.enabled) {\n      // Initialize clustered application\n      const clusterManager = new ClusterManager({\n        config: this.config.cluster,\n\n        startApplicationCallback: () => this.startInstance(startInstanceOptions),\n        stopApplicationCallback: () => this.stop(stopInstanceOptions),\n      });\n\n      // Start cluster\n      clusterManager.start();\n    } else {\n      // Start standalone application\n      await this.startInstance(startInstanceOptions);\n\n      // Handle standalone application shutdown\n      this.handleShutdown({\n        onStopped: stopInstanceOptions.onStopped,\n      });\n    }\n  }\n\n  /**\n   * Before application start\n   */\n  private async onBeforeStart(): Promise<{\n    redisInstance: RedisInstance;\n    databaseInstance: DatabaseInstance | null;\n    queueManager: QueueManager;\n    eventManager?: EventManager;\n  }> {\n    // Connect to Redis\n    const redisInstance = await this.redisManager.connect();\n\n    // Connect to database\n    const databaseInstance = this.databaseManager ? await this.databaseManager.connect() : null;\n\n    let eventManager: EventManager | undefined;\n\n    if (this.config.event?.enabled) {\n      eventManager = new EventManager({\n        applicationConfig: this.config,\n        options: this.config.event,\n        events: this.config.event.events || [],\n        redisInstance,\n        databaseInstance,\n        // queueManager,\n      });\n\n      eventManager.load();\n    }\n\n    // Initialize queue\n    const queueManager = new QueueManager({\n      applicationConfig: this.config,\n      options: {\n        processorsDirectory: this.config.queue.processorsDirectory,\n      },\n      queues: this.config.queue.queues,\n      redisInstance,\n      databaseInstance,\n      eventManager,\n    });\n\n    // Register queues\n    await queueManager.registerQueues({\n      queues: this.config.queue.queues,\n    });\n\n    return {\n      redisInstance,\n      databaseInstance,\n      queueManager,\n      eventManager,\n    };\n  }\n\n  /**\n   * Application started event\n   */\n  protected onStarted({ startupTime: _startupTime }: { startupTime: number }): void {}\n\n  /**\n   * Application stopped event\n   */\n  protected onStopped({ runtime: _runtime }: { runtime: number }): void {}\n\n  /**\n   * Before application stop event\n   */\n  private async onBeforeStop(): Promise<void> {\n    // Disconnect from Redis\n    await this.redisManager.disconnect();\n\n    if (this.databaseManager) {\n      // Disconnect from database\n      await this.databaseManager.disconnect();\n    }\n  }\n\n  /**\n   * Start application instance\n   */\n  private async startInstance(options: ApplicationStartInstanceOptions): Promise<void> {\n    try {\n      // Before application start\n      const { redisInstance, databaseInstance, queueManager, eventManager } = await this.onBeforeStart();\n\n      // Start application\n      await this.startHandler({\n        redisInstance,\n        databaseInstance,\n        queueManager,\n        eventManager,\n      });\n\n      // Calculate application startup time\n      const startupTime = Time.calculateElapsedTime({\n        startTime: this.startTime,\n      });\n\n      // On application started\n      if (options.onStarted) {\n        await options.onStarted({ startupTime });\n      }\n    } catch (error) {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(String(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  /**\n   * Set up global error handlers\n   */\n  /**\n   * Initialize performance monitor\n   */\n  private initializePerformanceMonitor(): void {\n    // Check if performance monitoring is enabled\n    if (!this.config.performanceMonitoring?.enabled) {\n      return;\n    }\n\n    // Initialize performance monitor with configuration\n    this.performanceMonitor = PerformanceMonitor.initialize({\n      enabled: true,\n      thresholds: this.config.performanceMonitoring.thresholds,\n      maxMetricsHistory: this.config.performanceMonitoring.maxMetricsHistory,\n      logSlowOperations: this.config.performanceMonitoring.logSlowOperations,\n      logAllOperations: this.config.performanceMonitoring.logAllOperations,\n    });\n\n    // Set up performance monitoring for different components\n    if (this.config.performanceMonitoring.monitorDatabaseOperations !== false) {\n      DatabasePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);\n    }\n\n    if (this.config.performanceMonitoring.monitorQueueOperations !== false) {\n      QueuePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);\n    }\n\n    if (this.config.performanceMonitoring.monitorCacheOperations !== false) {\n      CachePerformanceWrapper.setPerformanceMonitor(this.performanceMonitor);\n    }\n\n    // Set up periodic performance reports if configured\n    if (this.config.performanceMonitoring?.reportInterval && this.config.performanceMonitoring.reportInterval > 0) {\n      this.lifecycle.trackInterval(\n        setInterval(() => {\n          const reportFormat = this.config.performanceMonitoring?.reportFormat ?? 'detailed';\n          const report = this.performanceMonitor?.generateFormattedReport(reportFormat);\n\n          if (report) {\n            Logger.info({ message: report });\n          }\n        }, this.config.performanceMonitoring.reportInterval),\n      );\n    }\n  }\n\n  private setupGlobalErrorHandlers(): void {\n    // Handle uncaught exceptions\n    process.on('uncaughtException', error => {\n      Logger.error({ error, message: 'Uncaught Exception' });\n      this.initiateGracefulShutdown();\n    });\n\n    // Handle unhandled promise rejections\n    process.on('unhandledRejection', (reason, promise) => {\n      Logger.error({\n        error: reason instanceof Error ? reason : new Error(String(reason)),\n        message: 'Unhandled Rejection',\n        meta: { promise },\n      });\n      this.initiateGracefulShutdown();\n    });\n  }\n\n  /**\n   * Initiate graceful shutdown\n   */\n  private initiateGracefulShutdown(): void {\n    if (this.isStopping) {\n      return;\n    }\n\n    Logger.info({ message: 'Initiating graceful shutdown due to error' });\n    this.stop().catch(error => {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(String(error)),\n        message: 'Error during graceful shutdown',\n      });\n      requestExit({ code: 1, reason: 'graceful-shutdown-error', error });\n    });\n  }\n\n  /**\n   * Handle shutdown\n   */\n  public handleShutdown({ onStopped }: { onStopped?: ({ runtime }: { runtime: number }) => void }): void {\n    this.shutdownSignals.forEach(signal => {\n      process.on(signal, async () => {\n        // Stop application\n        await this.stop({ onStopped });\n      });\n    });\n  }\n\n  /**\n   * Stop application\n   */\n  private async stop({ onStopped }: ApplicationStopInstanceOptions = {}): Promise<void> {\n    if (this.isStopping) {\n      return;\n    }\n\n    this.isStopping = true;\n\n    // Set timeout for forced termination\n    const forceExitTimeout = setTimeout(() => {\n      Logger.warn({ message: 'Forced shutdown due to timeout' });\n      requestExit({ code: 1, reason: 'forced-timeout' });\n    }, this.shutdownTimeout);\n\n    try {\n      // Stop callback\n      await this.stopCallback();\n\n      // Disconnect\n      await this.onBeforeStop();\n\n      if (onStopped) {\n        // Calculate runtime\n        const runtime = process.uptime() * 1000;\n        // Emit stopped event\n        await onStopped({ runtime });\n      }\n\n      clearTimeout(forceExitTimeout);\n      requestExit({ code: 0, reason: 'shutdown-complete' });\n    } catch (error) {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(String(error)),\n        message: 'Error during shutdown',\n      });\n      clearTimeout(forceExitTimeout);\n      requestExit({ code: 1, reason: 'shutdown-error', error });\n    }\n  }\n}\n"],
+  "mappings": ";;AAAA,OAAO,aAAa;AACpB,SAAS,YAAY,oBAAoB;AACzC,SAAS,qBAAqB;AAC9B,SAAS,SAAS,MAAM,eAAe;AACvC,SAAgC,uBAAuB;AACvD,OAAO,kBAAkB;AACzB,OAAO,kBAAkB;AAMzB,OAAO,oBAAoB;AAE3B,SAAS,IAAI,YAAY;AACzB,OAAO,kBAAkB;AACzB,OAAO,QAAQ;AACf,OAAO,kBAAkB;AACzB,OAAO,YAAY;AACnB,SAAS,0BAA0B;AACnC,SAAS,yBAAyB,4BAA4B,+BAA+B;AAC7F,SAAS,wBAAwB;AACjC,SAAS,mBAAmB;AAK5B,MAAO,gBAAuC;AAAA,EA3B9C,OA2B8C;AAAA;AAAA;AAAA;AAAA,EAErC;AAAA;AAAA,EAGG,kBAAoC,CAAC,WAAW,QAAQ;AAAA;AAAA,EAGxD,YAA8B,CAAC,GAAG,CAAC;AAAA;AAAA,EAGnC,aAAa;AAAA;AAAA,EAGb,kBAAkB;AAAA;AAAA,EAG5B,OAAe;AAAA;AAAA,EAGL,WAAW,QAAQ,YAAY,QAAQ,SAAS,QAAQ,OAAO,KAAK;AAAA;AAAA,EAGpE;AAAA;AAAA,EAGA;AAAA;AAAA,EAGH;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGG,YAA8B,IAAI,iBAAiB;AAAA,EAE7D,IAAW,OAAO;AAChB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY,QAA2B;AACrC,UAAM,eAAe,GAAG,SAAS;AAEjC,SAAK,mBAAmB,GAAG,OAAO,UAAU,IAAI,YAAY,IAAI,GAAG,oBAAoB,CAAC;AAExF,SAAK,SAAS;AA4Bd,SAAK,eAAe,IAAI,aAAa;AAAA,MACnC,mBAAmB,KAAK;AAAA,MACxB,MAAM,KAAK,OAAO,MAAM;AAAA,MACxB,MAAM,KAAK,OAAO,MAAM;AAAA,MACxB,UAAU,KAAK,OAAO,MAAM;AAAA,IAC9B,CAAC;AAGD,SAAK,eAAe,IAAI,aAAa;AAAA,MACnC,mBAAmB,KAAK;AAAA,MACxB,cAAc,KAAK;AAAA,IACrB,CAAC;AAGD,SAAK,6BAA6B;AAGlC,SAAK,yBAAyB;AAE9B,QAAI,KAAK,OAAO,YAAY,KAAK,OAAO,SAAS,YAAY,MAAM;AACjE,YAAM,2BAA2B,KAAK,KAAK,OAAO,eAAe,OAAO,YAAY,UAAU;AAE9F,UAAI,CAAC,KAAK,OAAO,SAAS,mBAAmB;AAC3C,aAAK,OAAO,SAAS,oBAAoB;AAAA,MAC3C;AAEA,UAAI,CAAC,WAAW,KAAK,OAAO,SAAS,iBAAiB,GAAG;AACvD,cAAM,IAAI,MAAM,gDAAgD,KAAK,OAAO,SAAS,iBAAiB,GAAG;AAAA,MAC3G;AAGA,WAAK,kBAAkB,IAAI,gBAAgB;AAAA,QACzC,mBAAmB,KAAK;AAAA,QACxB,MAAM,KAAK,OAAO,SAAS;AAAA,QAC3B,MAAM,KAAK,OAAO,SAAS;AAAA,QAC3B,UAAU,KAAK,OAAO,SAAS;AAAA,QAC/B,UAAU,KAAK,OAAO,SAAS;AAAA,QAC/B,cAAc,KAAK,OAAO,SAAS;AAAA,QACnC,mBAAmB,KAAK,OAAO,SAAS;AAAA,MAC1C,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,wBAAyC;AAEpD,QAAI,gBAAgB,4BAA4B,QAAW;AACzD,aAAO,gBAAgB;AAAA,IACzB;AAGA,UAAM,aAAa,cAAc,YAAY,GAAG;AAChD,UAAM,YAAY,QAAQ,UAAU;AACpC,UAAM,kBAAkB,QAAQ,WAAW,oBAAoB;AAG/D,UAAM,eAAe,aAAa,iBAAiB,OAAO;AAC1D,UAAM,cAAc,KAAK,MAAM,YAAY;AAE3C,QAAI,CAAC,aAAa,SAAS;AACzB,YAAM,IAAI,MAAM,+BAA+B;AAAA,IACjD;AAGA,oBAAgB,0BAA0B,YAAY;AAEtD,WAAO,YAAY;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,QAAuB;AAElC,SAAK,YAAY,QAAQ,OAAO;AAGhC,SAAK,qBAAqB,MAAM,KAAK,sBAAsB;AAE3D,UAAM,uBAAwD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAc5D,WAAW,KAAK,UAAU,KAAK,IAAI;AAAA,IACrC;AAEA,UAAM,sBAAsD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAa1D,WAAW,KAAK,UAAU,KAAK,IAAI;AAAA,IACrC;AAEA,QAAI,KAAK,OAAO,SAAS,SAAS;AAEhC,YAAM,iBAAiB,IAAI,eAAe;AAAA,QACxC,QAAQ,KAAK,OAAO;AAAA,QAEpB,0BAA0B,6BAAM,KAAK,cAAc,oBAAoB,GAA7C;AAAA,QAC1B,yBAAyB,6BAAM,KAAK,KAAK,mBAAmB,GAAnC;AAAA,MAC3B,CAAC;AAGD,qBAAe,MAAM;AAAA,IACvB,OAAO;AAEL,YAAM,KAAK,cAAc,oBAAoB;AAG7C,WAAK,eAAe;AAAA,QAClB,WAAW,oBAAoB;AAAA,MACjC,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,gBAKX;AAED,UAAM,gBAAgB,MAAM,KAAK,aAAa,QAAQ;AAGtD,UAAM,mBAAmB,KAAK,kBAAkB,MAAM,KAAK,gBAAgB,QAAQ,IAAI;AAEvF,QAAI;AAEJ,QAAI,KAAK,OAAO,OAAO,SAAS;AAC9B,qBAAe,IAAI,aAAa;AAAA,QAC9B,mBAAmB,KAAK;AAAA,QACxB,SAAS,KAAK,OAAO;AAAA,QACrB,QAAQ,KAAK,OAAO,MAAM,UAAU,CAAC;AAAA,QACrC;AAAA,QACA;AAAA;AAAA,MAEF,CAAC;AAED,mBAAa,KAAK;AAAA,IACpB;AAGA,UAAM,eAAe,IAAI,aAAa;AAAA,MACpC,mBAAmB,KAAK;AAAA,MACxB,SAAS;AAAA,QACP,qBAAqB,KAAK,OAAO,MAAM;AAAA,MACzC;AAAA,MACA,QAAQ,KAAK,OAAO,MAAM;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAGD,UAAM,aAAa,eAAe;AAAA,MAChC,QAAQ,KAAK,OAAO,MAAM;AAAA,IAC5B,CAAC;AAED,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKU,UAAU,EAAE,aAAa,aAAa,GAAkC;AAAA,EAAC;AAAA;AAAA;AAAA;AAAA,EAKzE,UAAU,EAAE,SAAS,SAAS,GAA8B;AAAA,EAAC;AAAA;AAAA;AAAA;AAAA,EAKvE,MAAc,eAA8B;AAE1C,UAAM,KAAK,aAAa,WAAW;AAEnC,QAAI,KAAK,iBAAiB;AAExB,YAAM,KAAK,gBAAgB,WAAW;AAAA,IACxC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,cAAc,SAAyD;AACnF,QAAI;AAEF,YAAM,EAAE,eAAe,kBAAkB,cAAc,aAAa,IAAI,MAAM,KAAK,cAAc;AAGjG,YAAM,KAAK,aAAa;AAAA,QACtB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAGD,YAAM,cAAc,KAAK,qBAAqB;AAAA,QAC5C,WAAW,KAAK;AAAA,MAClB,CAAC;AAGD,UAAI,QAAQ,WAAW;AACrB,cAAM,QAAQ,UAAU,EAAE,YAAY,CAAC;AAAA,MACzC;AAAA,IACF,SAAS,OAAO;AACd,aAAO,MAAM;AAAA,QACX,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,QAC/D,SAAS;AAAA,MACX,CAAC;AACD,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBQ,+BAAqC;AAE3C,QAAI,CAAC,KAAK,OAAO,uBAAuB,SAAS;AAC/C;AAAA,IACF;AAGA,SAAK,qBAAqB,mBAAmB,WAAW;AAAA,MACtD,SAAS;AAAA,MACT,YAAY,KAAK,OAAO,sBAAsB;AAAA,MAC9C,mBAAmB,KAAK,OAAO,sBAAsB;AAAA,MACrD,mBAAmB,KAAK,OAAO,sBAAsB;AAAA,MACrD,kBAAkB,KAAK,OAAO,sBAAsB;AAAA,IACtD,CAAC;AAGD,QAAI,KAAK,OAAO,sBAAsB,8BAA8B,OAAO;AACzE,iCAA2B,sBAAsB,KAAK,kBAAkB;AAAA,IAC1E;AAEA,QAAI,KAAK,OAAO,sBAAsB,2BAA2B,OAAO;AACtE,8BAAwB,sBAAsB,KAAK,kBAAkB;AAAA,IACvE;AAEA,QAAI,KAAK,OAAO,sBAAsB,2BAA2B,OAAO;AACtE,8BAAwB,sBAAsB,KAAK,kBAAkB;AAAA,IACvE;AAGA,QAAI,KAAK,OAAO,uBAAuB,kBAAkB,KAAK,OAAO,sBAAsB,iBAAiB,GAAG;AAC7G,WAAK,UAAU;AAAA,QACb,YAAY,MAAM;AAChB,gBAAM,eAAe,KAAK,OAAO,uBAAuB,gBAAgB;AACxE,gBAAM,SAAS,KAAK,oBAAoB,wBAAwB,YAAY;AAE5E,cAAI,QAAQ;AACV,mBAAO,KAAK,EAAE,SAAS,OAAO,CAAC;AAAA,UACjC;AAAA,QACF,GAAG,KAAK,OAAO,sBAAsB,cAAc;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,2BAAiC;AAEvC,YAAQ,GAAG,qBAAqB,WAAS;AACvC,aAAO,MAAM,EAAE,OAAO,SAAS,qBAAqB,CAAC;AACrD,WAAK,yBAAyB;AAAA,IAChC,CAAC;AAGD,YAAQ,GAAG,sBAAsB,CAAC,QAAQ,YAAY;AACpD,aAAO,MAAM;AAAA,QACX,OAAO,kBAAkB,QAAQ,SAAS,IAAI,MAAM,OAAO,MAAM,CAAC;AAAA,QAClE,SAAS;AAAA,QACT,MAAM,EAAE,QAAQ;AAAA,MAClB,CAAC;AACD,WAAK,yBAAyB;AAAA,IAChC,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKQ,2BAAiC;AACvC,QAAI,KAAK,YAAY;AACnB;AAAA,IACF;AAEA,WAAO,KAAK,EAAE,SAAS,4CAA4C,CAAC;AACpE,SAAK,KAAK,EAAE,MAAM,WAAS;AACzB,aAAO,MAAM;AAAA,QACX,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,QAC/D,SAAS;AAAA,MACX,CAAC;AACD,kBAAY,EAAE,MAAM,GAAG,QAAQ,2BAA2B,MAAM,CAAC;AAAA,IACnE,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKO,eAAe,EAAE,UAAU,GAAqE;AACrG,SAAK,gBAAgB,QAAQ,YAAU;AACrC,cAAQ,GAAG,QAAQ,YAAY;AAE7B,cAAM,KAAK,KAAK,EAAE,UAAU,CAAC;AAAA,MAC/B,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,KAAK,EAAE,UAAU,IAAoC,CAAC,GAAkB;AACpF,QAAI,KAAK,YAAY;AACnB;AAAA,IACF;AAEA,SAAK,aAAa;AAGlB,UAAM,mBAAmB,WAAW,MAAM;AACxC,aAAO,KAAK,EAAE,SAAS,iCAAiC,CAAC;AACzD,kBAAY,EAAE,MAAM,GAAG,QAAQ,iBAAiB,CAAC;AAAA,IACnD,GAAG,KAAK,eAAe;AAEvB,QAAI;AAEF,YAAM,KAAK,aAAa;AAGxB,YAAM,KAAK,aAAa;AAExB,UAAI,WAAW;AAEb,cAAM,UAAU,QAAQ,OAAO,IAAI;AAEnC,cAAM,UAAU,EAAE,QAAQ,CAAC;AAAA,MAC7B;AAEA,mBAAa,gBAAgB;AAC7B,kBAAY,EAAE,MAAM,GAAG,QAAQ,oBAAoB,CAAC;AAAA,IACtD,SAAS,OAAO;AACd,aAAO,MAAM;AAAA,QACX,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,QAC/D,SAAS;AAAA,MACX,CAAC;AACD,mBAAa,gBAAgB;AAC7B,kBAAY,EAAE,MAAM,GAAG,QAAQ,kBAAkB,MAAM,CAAC;AAAA,IAC1D;AAAA,EACF;AACF;",
   "names": []
 }

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

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

package/dist/cluster/cluster-manager.js

@@ -3,6 +3,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 import cluster from "node:cluster";
 import { cpus } from "node:os";
 import { Logger } from "../logger/index.js";
+import { requestExit } from "../lifecycle/exit.js";
 class ClusterManager {
   static {
     __name(this, "ClusterManager");
@@ -92,7 +93,7 @@ class ClusterManager {
         const clusterWorkers = cluster.workers ?? {};
         const numClusterWorkers = Object.keys(clusterWorkers).length;
         if (exitedWorkers === numClusterWorkers) {
-          process.exit();
+          requestExit({ code: 0, reason: "cluster-workers-exited" });
         }
       });
     } else {

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/cluster/cluster-manager.ts"],
-  "sourcesContent": ["import cluster from 'node:cluster';\nimport { cpus } from 'node:os';\nimport type {\n  ClusterManagerConfig,\n  ClusterManagerProps,\n  ClusterManagerWorkerModeManualConfig,\n} from './cluster-manager.interface.js';\nimport { Logger } from '../logger/index.js';\n\nexport default class ClusterManager {\n  private readonly config: ClusterManagerConfig;\n\n  private startApplicationCallback: () => Promise<void>;\n  private stopApplicationCallback: () => Promise<void>;\n\n  private shutdownSignals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT'];\n  private isShuttingDown = false;\n\n  constructor({ config, startApplicationCallback, stopApplicationCallback }: ClusterManagerProps) {\n    this.config = config;\n\n    this.startApplicationCallback = startApplicationCallback;\n    this.stopApplicationCallback = stopApplicationCallback;\n  }\n\n  public start(): void {\n    if (cluster.isPrimary) {\n      this.setupPrimary();\n    } else {\n      this.setupWorker();\n    }\n\n    this.handleShutdown();\n  }\n\n  private setupPrimary(): void {\n    const numCPUs: number = cpus().length;\n\n    const numClusterWorkers =\n      this.config.workerMode === 'auto' ? numCPUs : (this.config as ClusterManagerWorkerModeManualConfig).workerCount;\n\n    for (let workerIndex = 0; workerIndex < numClusterWorkers; workerIndex++) {\n      cluster.fork();\n    }\n\n    cluster.on('online', worker => {\n      Logger.debug({\n        message: 'Started cluster worker',\n        meta: {\n          ID: worker.id,\n          PID: worker.process.pid,\n        },\n      });\n    });\n\n    cluster.on('exit', () => {\n      if (!this.isShuttingDown) {\n        // Restart worker on unexpected exit\n        cluster.fork();\n      }\n    });\n\n    Logger.debug({\n      message: 'Started cluster master',\n      meta: {\n        Mode: this.config.workerMode,\n        'Worker Count': numClusterWorkers,\n        CPUs: numCPUs,\n      },\n    });\n  }\n\n  private async setupWorker(): Promise<void> {\n    await this.startApplicationCallback();\n\n    process.on('message', async message => {\n      if (message === 'shutdown') {\n        Logger.debug({\n          message: 'Worker received shutdown message, stopping...',\n          meta: {\n            PID: process.pid,\n          },\n        });\n\n        // Stop application\n        await this.stopApplicationCallback();\n      }\n    });\n  }\n\n  private handleShutdown(): void {\n    this.shutdownSignals.forEach(signal => {\n      process.on(signal, async () => await this.initiateShutdown());\n    });\n  }\n\n  private async initiateShutdown(): Promise<void> {\n    if (this.isShuttingDown) {\n      return;\n    }\n\n    this.isShuttingDown = true;\n\n    if (cluster.isPrimary) {\n      for (const id in cluster.workers) {\n        const worker = cluster.workers[id];\n\n        if (!worker) {\n          continue;\n        }\n\n        worker.send('shutdown');\n      }\n\n      let exitedWorkers = 0;\n\n      cluster.on('exit', () => {\n        exitedWorkers++;\n\n        const clusterWorkers = cluster.workers ?? {};\n        const numClusterWorkers = Object.keys(clusterWorkers).length;\n\n        if (exitedWorkers === numClusterWorkers) {\n          process.exit();\n        }\n      });\n    } else {\n      await this.stopApplicationCallback();\n    }\n  }\n}\n"],
-  "mappings": ";;AAAA,OAAO,aAAa;AACpB,SAAS,YAAY;AAMrB,SAAS,cAAc;AAEvB,MAAO,eAA6B;AAAA,EATpC,OASoC;AAAA;AAAA;AAAA,EACjB;AAAA,EAET;AAAA,EACA;AAAA,EAEA,kBAAoC,CAAC,WAAW,QAAQ;AAAA,EACxD,iBAAiB;AAAA,EAEzB,YAAY,EAAE,QAAQ,0BAA0B,wBAAwB,GAAwB;AAC9F,SAAK,SAAS;AAEd,SAAK,2BAA2B;AAChC,SAAK,0BAA0B;AAAA,EACjC;AAAA,EAEO,QAAc;AACnB,QAAI,QAAQ,WAAW;AACrB,WAAK,aAAa;AAAA,IACpB,OAAO;AACL,WAAK,YAAY;AAAA,IACnB;AAEA,SAAK,eAAe;AAAA,EACtB;AAAA,EAEQ,eAAqB;AAC3B,UAAM,UAAkB,KAAK,EAAE;AAE/B,UAAM,oBACJ,KAAK,OAAO,eAAe,SAAS,UAAW,KAAK,OAAgD;AAEtG,aAAS,cAAc,GAAG,cAAc,mBAAmB,eAAe;AACxE,cAAQ,KAAK;AAAA,IACf;AAEA,YAAQ,GAAG,UAAU,YAAU;AAC7B,aAAO,MAAM;AAAA,QACX,SAAS;AAAA,QACT,MAAM;AAAA,UACJ,IAAI,OAAO;AAAA,UACX,KAAK,OAAO,QAAQ;AAAA,QACtB;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAED,YAAQ,GAAG,QAAQ,MAAM;AACvB,UAAI,CAAC,KAAK,gBAAgB;AAExB,gBAAQ,KAAK;AAAA,MACf;AAAA,IACF,CAAC;AAED,WAAO,MAAM;AAAA,MACX,SAAS;AAAA,MACT,MAAM;AAAA,QACJ,MAAM,KAAK,OAAO;AAAA,QAClB,gBAAgB;AAAA,QAChB,MAAM;AAAA,MACR;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,cAA6B;AACzC,UAAM,KAAK,yBAAyB;AAEpC,YAAQ,GAAG,WAAW,OAAM,YAAW;AACrC,UAAI,YAAY,YAAY;AAC1B,eAAO,MAAM;AAAA,UACX,SAAS;AAAA,UACT,MAAM;AAAA,YACJ,KAAK,QAAQ;AAAA,UACf;AAAA,QACF,CAAC;AAGD,cAAM,KAAK,wBAAwB;AAAA,MACrC;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEQ,iBAAuB;AAC7B,SAAK,gBAAgB,QAAQ,YAAU;AACrC,cAAQ,GAAG,QAAQ,YAAY,MAAM,KAAK,iBAAiB,CAAC;AAAA,IAC9D,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,mBAAkC;AAC9C,QAAI,KAAK,gBAAgB;AACvB;AAAA,IACF;AAEA,SAAK,iBAAiB;AAEtB,QAAI,QAAQ,WAAW;AACrB,iBAAW,MAAM,QAAQ,SAAS;AAChC,cAAM,SAAS,QAAQ,QAAQ,EAAE;AAEjC,YAAI,CAAC,QAAQ;AACX;AAAA,QACF;AAEA,eAAO,KAAK,UAAU;AAAA,MACxB;AAEA,UAAI,gBAAgB;AAEpB,cAAQ,GAAG,QAAQ,MAAM;AACvB;AAEA,cAAM,iBAAiB,QAAQ,WAAW,CAAC;AAC3C,cAAM,oBAAoB,OAAO,KAAK,cAAc,EAAE;AAEtD,YAAI,kBAAkB,mBAAmB;AACvC,kBAAQ,KAAK;AAAA,QACf;AAAA,MACF,CAAC;AAAA,IACH,OAAO;AACL,YAAM,KAAK,wBAAwB;AAAA,IACrC;AAAA,EACF;AACF;",
+  "sourcesContent": ["import cluster from 'node:cluster';\nimport { cpus } from 'node:os';\nimport type {\n  ClusterManagerConfig,\n  ClusterManagerProps,\n  ClusterManagerWorkerModeManualConfig,\n} from './cluster-manager.interface.js';\nimport { Logger } from '../logger/index.js';\nimport { requestExit } from '../lifecycle/exit.js';\n\nexport default class ClusterManager {\n  private readonly config: ClusterManagerConfig;\n\n  private startApplicationCallback: () => Promise<void>;\n  private stopApplicationCallback: () => Promise<void>;\n\n  private shutdownSignals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT'];\n  private isShuttingDown = false;\n\n  constructor({ config, startApplicationCallback, stopApplicationCallback }: ClusterManagerProps) {\n    this.config = config;\n\n    this.startApplicationCallback = startApplicationCallback;\n    this.stopApplicationCallback = stopApplicationCallback;\n  }\n\n  public start(): void {\n    if (cluster.isPrimary) {\n      this.setupPrimary();\n    } else {\n      this.setupWorker();\n    }\n\n    this.handleShutdown();\n  }\n\n  private setupPrimary(): void {\n    const numCPUs: number = cpus().length;\n\n    const numClusterWorkers =\n      this.config.workerMode === 'auto' ? numCPUs : (this.config as ClusterManagerWorkerModeManualConfig).workerCount;\n\n    for (let workerIndex = 0; workerIndex < numClusterWorkers; workerIndex++) {\n      cluster.fork();\n    }\n\n    cluster.on('online', worker => {\n      Logger.debug({\n        message: 'Started cluster worker',\n        meta: {\n          ID: worker.id,\n          PID: worker.process.pid,\n        },\n      });\n    });\n\n    cluster.on('exit', () => {\n      if (!this.isShuttingDown) {\n        // Restart worker on unexpected exit\n        cluster.fork();\n      }\n    });\n\n    Logger.debug({\n      message: 'Started cluster master',\n      meta: {\n        Mode: this.config.workerMode,\n        'Worker Count': numClusterWorkers,\n        CPUs: numCPUs,\n      },\n    });\n  }\n\n  private async setupWorker(): Promise<void> {\n    await this.startApplicationCallback();\n\n    process.on('message', async message => {\n      if (message === 'shutdown') {\n        Logger.debug({\n          message: 'Worker received shutdown message, stopping...',\n          meta: {\n            PID: process.pid,\n          },\n        });\n\n        // Stop application\n        await this.stopApplicationCallback();\n      }\n    });\n  }\n\n  private handleShutdown(): void {\n    this.shutdownSignals.forEach(signal => {\n      process.on(signal, async () => await this.initiateShutdown());\n    });\n  }\n\n  private async initiateShutdown(): Promise<void> {\n    if (this.isShuttingDown) {\n      return;\n    }\n\n    this.isShuttingDown = true;\n\n    if (cluster.isPrimary) {\n      for (const id in cluster.workers) {\n        const worker = cluster.workers[id];\n\n        if (!worker) {\n          continue;\n        }\n\n        worker.send('shutdown');\n      }\n\n      let exitedWorkers = 0;\n\n      cluster.on('exit', () => {\n        exitedWorkers++;\n\n        const clusterWorkers = cluster.workers ?? {};\n        const numClusterWorkers = Object.keys(clusterWorkers).length;\n\n        if (exitedWorkers === numClusterWorkers) {\n          requestExit({ code: 0, reason: 'cluster-workers-exited' });\n        }\n      });\n    } else {\n      await this.stopApplicationCallback();\n    }\n  }\n}\n"],
+  "mappings": ";;AAAA,OAAO,aAAa;AACpB,SAAS,YAAY;AAMrB,SAAS,cAAc;AACvB,SAAS,mBAAmB;AAE5B,MAAO,eAA6B;AAAA,EAVpC,OAUoC;AAAA;AAAA;AAAA,EACjB;AAAA,EAET;AAAA,EACA;AAAA,EAEA,kBAAoC,CAAC,WAAW,QAAQ;AAAA,EACxD,iBAAiB;AAAA,EAEzB,YAAY,EAAE,QAAQ,0BAA0B,wBAAwB,GAAwB;AAC9F,SAAK,SAAS;AAEd,SAAK,2BAA2B;AAChC,SAAK,0BAA0B;AAAA,EACjC;AAAA,EAEO,QAAc;AACnB,QAAI,QAAQ,WAAW;AACrB,WAAK,aAAa;AAAA,IACpB,OAAO;AACL,WAAK,YAAY;AAAA,IACnB;AAEA,SAAK,eAAe;AAAA,EACtB;AAAA,EAEQ,eAAqB;AAC3B,UAAM,UAAkB,KAAK,EAAE;AAE/B,UAAM,oBACJ,KAAK,OAAO,eAAe,SAAS,UAAW,KAAK,OAAgD;AAEtG,aAAS,cAAc,GAAG,cAAc,mBAAmB,eAAe;AACxE,cAAQ,KAAK;AAAA,IACf;AAEA,YAAQ,GAAG,UAAU,YAAU;AAC7B,aAAO,MAAM;AAAA,QACX,SAAS;AAAA,QACT,MAAM;AAAA,UACJ,IAAI,OAAO;AAAA,UACX,KAAK,OAAO,QAAQ;AAAA,QACtB;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAED,YAAQ,GAAG,QAAQ,MAAM;AACvB,UAAI,CAAC,KAAK,gBAAgB;AAExB,gBAAQ,KAAK;AAAA,MACf;AAAA,IACF,CAAC;AAED,WAAO,MAAM;AAAA,MACX,SAAS;AAAA,MACT,MAAM;AAAA,QACJ,MAAM,KAAK,OAAO;AAAA,QAClB,gBAAgB;AAAA,QAChB,MAAM;AAAA,MACR;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,cAA6B;AACzC,UAAM,KAAK,yBAAyB;AAEpC,YAAQ,GAAG,WAAW,OAAM,YAAW;AACrC,UAAI,YAAY,YAAY;AAC1B,eAAO,MAAM;AAAA,UACX,SAAS;AAAA,UACT,MAAM;AAAA,YACJ,KAAK,QAAQ;AAAA,UACf;AAAA,QACF,CAAC;AAGD,cAAM,KAAK,wBAAwB;AAAA,MACrC;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEQ,iBAAuB;AAC7B,SAAK,gBAAgB,QAAQ,YAAU;AACrC,cAAQ,GAAG,QAAQ,YAAY,MAAM,KAAK,iBAAiB,CAAC;AAAA,IAC9D,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,mBAAkC;AAC9C,QAAI,KAAK,gBAAgB;AACvB;AAAA,IACF;AAEA,SAAK,iBAAiB;AAEtB,QAAI,QAAQ,WAAW;AACrB,iBAAW,MAAM,QAAQ,SAAS;AAChC,cAAM,SAAS,QAAQ,QAAQ,EAAE;AAEjC,YAAI,CAAC,QAAQ;AACX;AAAA,QACF;AAEA,eAAO,KAAK,UAAU;AAAA,MACxB;AAEA,UAAI,gBAAgB;AAEpB,cAAQ,GAAG,QAAQ,MAAM;AACvB;AAEA,cAAM,iBAAiB,QAAQ,WAAW,CAAC;AAC3C,cAAM,oBAAoB,OAAO,KAAK,cAAc,EAAE;AAEtD,YAAI,kBAAkB,mBAAmB;AACvC,sBAAY,EAAE,MAAM,GAAG,QAAQ,yBAAyB,CAAC;AAAA,QAC3D;AAAA,MACF,CAAC;AAAA,IACH,OAAO;AACL,YAAM,KAAK,wBAAwB;AAAA,IACrC;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/lifecycle/exit.d.ts

@@ -0,0 +1,10 @@
+export interface ExitOutcome {
+    code: number;
+    reason: string;
+    error?: unknown;
+}
+type ExitHandler = (outcome: ExitOutcome) => void;
+export declare function setExitHandler(next: ExitHandler): void;
+export declare function requestExit(outcome: ExitOutcome): void;
+export {};
+//# sourceMappingURL=exit.d.ts.map

package/dist/lifecycle/exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.d.ts","sourceRoot":"","sources":["../../src/lifecycle/exit.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;AAMlD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,QAE/C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,QAO/C"}

package/dist/lifecycle/exit.js

@@ -0,0 +1,23 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+let handler = /* @__PURE__ */ __name((outcome) => {
+  process.exit(outcome.code);
+}, "handler");
+function setExitHandler(next) {
+  handler = next;
+}
+__name(setExitHandler, "setExitHandler");
+function requestExit(outcome) {
+  try {
+    handler(outcome);
+  } catch (err) {
+    console.error("Exit handler failure", err);
+    process.exit(outcome.code);
+  }
+}
+__name(requestExit, "requestExit");
+export {
+  requestExit,
+  setExitHandler
+};
+//# sourceMappingURL=exit.js.map

package/dist/lifecycle/exit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lifecycle/exit.ts"],
+  "sourcesContent": ["export interface ExitOutcome {\n  code: number;\n  reason: string;\n  error?: unknown;\n}\n\ntype ExitHandler = (outcome: ExitOutcome) => void;\n\nlet handler: ExitHandler = outcome => {\n  process.exit(outcome.code);\n};\n\nexport function setExitHandler(next: ExitHandler) {\n  handler = next;\n}\n\nexport function requestExit(outcome: ExitOutcome) {\n  try {\n    handler(outcome);\n  } catch (err) {\n    console.error('Exit handler failure', err);\n    process.exit(outcome.code);\n  }\n}\n"],
+  "mappings": ";;AAQA,IAAI,UAAuB,oCAAW;AACpC,UAAQ,KAAK,QAAQ,IAAI;AAC3B,GAF2B;AAIpB,SAAS,eAAe,MAAmB;AAChD,YAAU;AACZ;AAFgB;AAIT,SAAS,YAAY,SAAsB;AAChD,MAAI;AACF,YAAQ,OAAO;AAAA,EACjB,SAAS,KAAK;AACZ,YAAQ,MAAM,wBAAwB,GAAG;AACzC,YAAQ,KAAK,QAAQ,IAAI;AAAA,EAC3B;AACF;AAPgB;",
+  "names": []
+}

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

@@ -0,0 +1,13 @@
+export declare class LifecycleManager {
+    private shutdownHooks;
+    private intervals;
+    private timeouts;
+    private shuttingDown;
+    onShutdown(fn: () => void | Promise<void>): () => void;
+    trackInterval(id: NodeJS.Timeout): NodeJS.Timeout;
+    trackTimeout(id: NodeJS.Timeout): NodeJS.Timeout;
+    shutdown(): Promise<{
+        errors: unknown[];
+    }>;
+}
+//# sourceMappingURL=lifecycle-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-manager.d.ts","sourceRoot":"","sources":["../../src/lifecycle/lifecycle-manager.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,YAAY,CAAS;IAE7B,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO;IAKhC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO;IAKzB,QAAQ,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;CA0BjD"}

package/dist/lifecycle/lifecycle-manager.js

@@ -0,0 +1,54 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class LifecycleManager {
+  static {
+    __name(this, "LifecycleManager");
+  }
+  shutdownHooks = [];
+  intervals = /* @__PURE__ */ new Set();
+  timeouts = /* @__PURE__ */ new Set();
+  shuttingDown = false;
+  onShutdown(fn) {
+    this.shutdownHooks.push(fn);
+    return () => {
+      const i = this.shutdownHooks.indexOf(fn);
+      if (i >= 0) this.shutdownHooks.splice(i, 1);
+    };
+  }
+  trackInterval(id) {
+    this.intervals.add(id);
+    return id;
+  }
+  trackTimeout(id) {
+    this.timeouts.add(id);
+    return id;
+  }
+  async shutdown() {
+    if (this.shuttingDown) {
+      return { errors: [] };
+    }
+    this.shuttingDown = true;
+    for (const id of this.intervals) {
+      clearInterval(id);
+    }
+    for (const id of this.timeouts) {
+      clearTimeout(id);
+    }
+    this.intervals.clear();
+    this.timeouts.clear();
+    const errors = [];
+    for (let i = this.shutdownHooks.length - 1; i >= 0; i--) {
+      const hook = this.shutdownHooks[i];
+      try {
+        await hook();
+      } catch (e) {
+        errors.push(e);
+      }
+    }
+    return { errors };
+  }
+}
+export {
+  LifecycleManager
+};
+//# sourceMappingURL=lifecycle-manager.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lifecycle/lifecycle-manager.ts"],
+  "sourcesContent": ["export class LifecycleManager {\n  private shutdownHooks: Array<() => void | Promise<void>> = [];\n  private intervals = new Set<NodeJS.Timeout>();\n  private timeouts = new Set<NodeJS.Timeout>();\n  private shuttingDown = false;\n\n  onShutdown(fn: () => void | Promise<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  trackInterval(id: NodeJS.Timeout) {\n    this.intervals.add(id);\n    return id;\n  }\n\n  trackTimeout(id: NodeJS.Timeout) {\n    this.timeouts.add(id);\n    return id;\n  }\n\n  async shutdown(): Promise<{ errors: unknown[] }> {\n    if (this.shuttingDown) {\n      return { errors: [] };\n    }\n    this.shuttingDown = true;\n\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    const errors: unknown[] = [];\n    for (let i = this.shutdownHooks.length - 1; i >= 0; i--) {\n      const hook = this.shutdownHooks[i];\n      try {\n        await hook();\n      } catch (e) {\n        errors.push(e);\n      }\n    }\n    return { errors };\n  }\n}\n"],
+  "mappings": ";;AAAO,MAAM,iBAAiB;AAAA,EAA9B,OAA8B;AAAA;AAAA;AAAA,EACpB,gBAAmD,CAAC;AAAA,EACpD,YAAY,oBAAI,IAAoB;AAAA,EACpC,WAAW,oBAAI,IAAoB;AAAA,EACnC,eAAe;AAAA,EAEvB,WAAW,IAAgC;AACzC,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,cAAc,IAAoB;AAChC,SAAK,UAAU,IAAI,EAAE;AACrB,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,IAAoB;AAC/B,SAAK,SAAS,IAAI,EAAE;AACpB,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,WAA2C;AAC/C,QAAI,KAAK,cAAc;AACrB,aAAO,EAAE,QAAQ,CAAC,EAAE;AAAA,IACtB;AACA,SAAK,eAAe;AAEpB,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;AAEpB,UAAM,SAAoB,CAAC;AAC3B,aAAS,IAAI,KAAK,cAAc,SAAS,GAAG,KAAK,GAAG,KAAK;AACvD,YAAM,OAAO,KAAK,cAAc,CAAC;AACjC,UAAI;AACF,cAAM,KAAK;AAAA,MACb,SAAS,GAAG;AACV,eAAO,KAAK,CAAC;AAAA,MACf;AAAA,IACF;AACA,WAAO,EAAE,OAAO;AAAA,EAClB;AACF;",
+  "names": []
+}

package/dist/logger/logger.d.ts

@@ -12,7 +12,7 @@ export declare class Logger {
         sentryDsn: string;
         environment: string;
     }): void;
-    log({ level, message, meta, options, }: {
+    log({ level, message, meta, options: _options, }: {
         level: LoggerLevels;
         message: unknown;
         meta?: Record<string, unknown>;
@@ -23,16 +23,19 @@ export declare class Logger {
         meta?: Record<string, unknown>;
         options?: LogOptions;
     }): void;
+    debug(message: unknown, meta?: Record<string, unknown>): void;
     info({ message, meta, options, }: {
         message: unknown;
         meta?: Record<string, unknown>;
         options?: LogOptions;
     }): void;
+    info(message: unknown, meta?: Record<string, unknown>): void;
     warn({ message, meta, options, }: {
         message: unknown;
         meta?: Record<string, unknown>;
         options?: LogOptions;
     }): void;
+    warn(message: unknown, meta?: Record<string, unknown>): void;
     error({ error, message, meta, options, }: {
         error: Error | unknown;
         message?: string;

package/dist/logger/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,GACT,UAAU,GACV,OAAO,GACP,WAAW,GACX,WAAW,GACX,OAAO,GACP,UAAU,GACV,OAAO,GACP,OAAO,CAAC;AAEZ,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,MAAM,CAAiB;IAE/B,OAAO,CAAC,WAAW,CAAqB;IAEjC,mBAAmB,UAAS;IAEnC,OAAO;WAwDO,WAAW,IAAI,MAAM;IAQnC,OAAO,CAAC,eAAe;IAwBhB,UAAU,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAiBxF,GAAG,CAAC,EACT,KAAK,EACL,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB,GAAG,IAAI;IAcD,KAAK,CAAC,EACX,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB,GAAG,IAAI;IAID,IAAI,CAAC,EACV,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB,GAAG,IAAI;IAID,IAAI,CAAC,EACV,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB,GAAG,IAAI;IAID,KAAK,CAAC,EACX,KAAK,EACL,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE;QACD,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB,GAAG,IAAI;IAiBD,MAAM,CAAC,EACZ,KAAK,EACL,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB,GAAG,IAAI;CAGT;;AAED,wBAAoC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,GACT,UAAU,GACV,OAAO,GACP,WAAW,GACX,WAAW,GACX,OAAO,GACP,UAAU,GACV,OAAO,GACP,OAAO,CAAC;AAEZ,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,MAAM,CAAiB;IAE/B,OAAO,CAAC,WAAW,CAAqB;IAEjC,mBAAmB,UAAS;IAEnC,OAAO;WAwDO,WAAW,IAAI,MAAM;IAQnC,OAAO,CAAC,eAAe;IAwBhB,UAAU,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAiBxF,GAAG,CAAC,EACT,KAAK,EACL,OAAO,EACP,IAAI,EACJ,OAAO,EAAE,QAAQ,GAClB,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB,GAAG,IAAI;IAcD,KAAK,CAAC,EACX,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB,GAAG,IAAI;IACD,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAiB7D,IAAI,CAAC,EACV,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB,GAAG,IAAI;IACD,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAiB5D,IAAI,CAAC,EACV,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB,GAAG,IAAI;IACD,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAiB5D,KAAK,CAAC,EACX,KAAK,EACL,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE;QACD,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB,GAAG,IAAI;IAiBD,MAAM,CAAC,EACZ,KAAK,EACL,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB,GAAG,IAAI;CAGT;;AAED,wBAAoC"}

package/dist/logger/logger.js

@@ -102,7 +102,7 @@ class Logger {
     level,
     message,
     meta,
-    options
+    options: _options
   }) {
     if (message instanceof Error) {
       const errorMessage = message.stack ?? message.toString();
@@ -113,26 +113,41 @@ class Logger {
       this.logger.log(level, JSON.stringify(message), meta);
     }
   }
-  debug({
-    message,
-    meta,
-    options
-  }) {
-    this.log({ level: "debug", message, meta, options });
+  debug(messageOrOptions, meta) {
+    if (typeof messageOrOptions === "object" && messageOrOptions !== null && "message" in messageOrOptions) {
+      const {
+        message,
+        meta: optionsMeta,
+        options
+      } = messageOrOptions;
+      this.log({ level: "debug", message, meta: optionsMeta, options });
+    } else {
+      this.log({ level: "debug", message: messageOrOptions, meta, options: void 0 });
+    }
   }
-  info({
-    message,
-    meta,
-    options
-  }) {
-    this.log({ level: "info", message, meta, options });
+  info(messageOrOptions, meta) {
+    if (typeof messageOrOptions === "object" && messageOrOptions !== null && "message" in messageOrOptions) {
+      const {
+        message,
+        meta: optionsMeta,
+        options
+      } = messageOrOptions;
+      this.log({ level: "info", message, meta: optionsMeta, options });
+    } else {
+      this.log({ level: "info", message: messageOrOptions, meta, options: void 0 });
+    }
   }
-  warn({
-    message,
-    meta,
-    options
-  }) {
-    this.log({ level: "warn", message, meta, options });
+  warn(messageOrOptions, meta) {
+    if (typeof messageOrOptions === "object" && messageOrOptions !== null && "message" in messageOrOptions) {
+      const {
+        message,
+        meta: optionsMeta,
+        options
+      } = messageOrOptions;
+      this.log({ level: "warn", message, meta: optionsMeta, options });
+    } else {
+      this.log({ level: "warn", message: messageOrOptions, meta, options: void 0 });
+    }
   }
   error({
     error,

package/dist/logger/logger.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/logger/logger.ts"],
-  "sourcesContent": ["import * as Sentry from '@sentry/node';\nimport { nodeProfilingIntegration } from '@sentry/profiling-node';\nimport cluster from 'node:cluster';\nimport winston from 'winston';\nimport type { LogOptions } from '../websocket/utils.js';\n\nexport type LoggerLevels =\n  | 'error'\n  | 'warn'\n  | 'info'\n  | 'command'\n  | 'database'\n  | 'redis'\n  | 'webServer'\n  | 'webSocket'\n  | 'queue'\n  | 'queueJob'\n  | 'event'\n  | 'debug';\n\nexport class Logger {\n  private static instance: Logger;\n  private logger: winston.Logger;\n\n  private environment: string | undefined;\n\n  public isSentryInitialized = false;\n\n  private constructor() {\n    this.environment = process.env.NODE_ENV;\n\n    const customFormat = this.getCustomFormat();\n\n    const customLevels: winston.config.AbstractConfigSetLevels = {\n      error: 0,\n      warn: 1,\n      info: 2,\n      command: 3,\n      database: 4,\n      redis: 5,\n      webServer: 6,\n      webSocket: 7,\n      queue: 8,\n      queueJob: 9,\n      event: 10,\n      debug: 11,\n    };\n\n    const customColors: winston.config.AbstractConfigSetColors = {\n      error: 'red',\n      warn: 'yellow',\n      info: 'blue',\n      command: 'cyan',\n      database: 'brightGreen',\n      redis: 'brightYellow',\n      webServer: 'brightBlue',\n      webSocket: 'brightMagenta',\n      queue: 'gray',\n      queueJob: 'blue',\n      event: 'brightGreen',\n      debug: 'brightCyan',\n    };\n\n    winston.addColors(customColors);\n\n    this.logger = winston.createLogger({\n      levels: customLevels,\n      level: this.environment === 'production' ? 'info' : 'debug',\n      format: winston.format.combine(\n        winston.format.timestamp({\n          format: 'YYYY-MM-DD HH:mm:ss',\n        }),\n        winston.format.errors({ stack: true }),\n        winston.format.splat(),\n        winston.format.json(),\n      ),\n      transports: [\n        new winston.transports.Console({\n          format: winston.format.combine(winston.format.colorize(), customFormat),\n        }),\n      ],\n    });\n  }\n\n  public static getInstance(): Logger {\n    if (!Logger.instance) {\n      Logger.instance = new Logger();\n    }\n\n    return Logger.instance;\n  }\n\n  private getCustomFormat(): winston.Logform.Format {\n    return winston.format.printf(({ level, message, timestamp, ...meta }) => {\n      if (cluster.isWorker && cluster.worker) {\n        meta['Worker'] = cluster.worker.id; // .process.pid;\n      }\n\n      const metaString = Object.entries(meta)\n        .map(([key, value]) => {\n          return `${key}: ${value}`;\n        })\n        .join(' | ');\n\n      if (level === 'error') {\n        if (this.isSentryInitialized) {\n          const errorMessage = typeof message === 'string' ? message : JSON.stringify(message);\n\n          Sentry.captureException(new Error(errorMessage));\n        }\n      }\n\n      return `[${timestamp}] ${level}: ${message}${metaString ? ` (${metaString})` : ''}`;\n    });\n  }\n\n  public initSentry({ sentryDsn, environment }: { sentryDsn: string; environment: string }): void {\n    if (!sentryDsn) {\n      this.logger.warn('Missing Sentry DSN when initializing Sentry');\n\n      return;\n    }\n\n    Sentry.init({\n      dsn: sentryDsn,\n      integrations: [nodeProfilingIntegration()],\n      tracesSampleRate: 1.0,\n      environment,\n    });\n\n    this.isSentryInitialized = true;\n  }\n\n  public log({\n    level,\n    message,\n    meta,\n    options,\n  }: {\n    level: LoggerLevels;\n    message: unknown;\n    meta?: Record<string, unknown>;\n    options?: LogOptions;\n  }): void {\n    // if (options?.muteWorker) {\n    // }\n\n    if (message instanceof Error) {\n      const errorMessage = message.stack ?? message.toString();\n      this.logger.log(level, errorMessage, meta);\n    } else if (typeof message === 'string') {\n      this.logger.log(level, message, meta);\n    } else {\n      this.logger.log(level, JSON.stringify(message), meta);\n    }\n  }\n\n  public debug({\n    message,\n    meta,\n    options,\n  }: {\n    message: unknown;\n    meta?: Record<string, unknown>;\n    options?: LogOptions;\n  }): void {\n    this.log({ level: 'debug', message, meta, options });\n  }\n\n  public info({\n    message,\n    meta,\n    options,\n  }: {\n    message: unknown;\n    meta?: Record<string, unknown>;\n    options?: LogOptions;\n  }): void {\n    this.log({ level: 'info', message, meta, options });\n  }\n\n  public warn({\n    message,\n    meta,\n    options,\n  }: {\n    message: unknown;\n    meta?: Record<string, unknown>;\n    options?: LogOptions;\n  }): void {\n    this.log({ level: 'warn', message, meta, options });\n  }\n\n  public error({\n    error,\n    message,\n    meta,\n    options,\n  }: {\n    error: Error | unknown;\n    message?: string;\n    meta?: Record<string, unknown>;\n    options?: LogOptions;\n  }): void {\n    if (message) {\n      // If a message is provided, combine it with the error for better context\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      const combinedMessage = `${message}: ${errorMessage}`;\n      this.log({ level: 'error', message: combinedMessage, meta, options });\n\n      // Also capture the original error for Sentry if it's an Error object\n      if (error instanceof Error && this.isSentryInitialized) {\n        Sentry.captureException(error);\n      }\n    } else {\n      // Original behavior when no message is provided\n      this.log({ level: 'error', message: error, meta, options });\n    }\n  }\n\n  public custom({\n    level,\n    message,\n    meta,\n    options,\n  }: {\n    level: LoggerLevels;\n    message: unknown;\n    meta?: Record<string, unknown>;\n    options?: LogOptions;\n  }): void {\n    this.log({ level, message, meta, options });\n  }\n}\n\nexport default Logger.getInstance();\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as Sentry from '@sentry/node';\nimport { nodeProfilingIntegration } from '@sentry/profiling-node';\nimport cluster from 'node:cluster';\nimport winston from 'winston';\nimport type { LogOptions } from '../websocket/utils.js';\n\nexport type LoggerLevels =\n  | 'error'\n  | 'warn'\n  | 'info'\n  | 'command'\n  | 'database'\n  | 'redis'\n  | 'webServer'\n  | 'webSocket'\n  | 'queue'\n  | 'queueJob'\n  | 'event'\n  | 'debug';\n\nexport class Logger {\n  private static instance: Logger;\n  private logger: winston.Logger;\n\n  private environment: string | undefined;\n\n  public isSentryInitialized = false;\n\n  private constructor() {\n    this.environment = process.env.NODE_ENV;\n\n    const customFormat = this.getCustomFormat();\n\n    const customLevels: winston.config.AbstractConfigSetLevels = {\n      error: 0,\n      warn: 1,\n      info: 2,\n      command: 3,\n      database: 4,\n      redis: 5,\n      webServer: 6,\n      webSocket: 7,\n      queue: 8,\n      queueJob: 9,\n      event: 10,\n      debug: 11,\n    };\n\n    const customColors: winston.config.AbstractConfigSetColors = {\n      error: 'red',\n      warn: 'yellow',\n      info: 'blue',\n      command: 'cyan',\n      database: 'brightGreen',\n      redis: 'brightYellow',\n      webServer: 'brightBlue',\n      webSocket: 'brightMagenta',\n      queue: 'gray',\n      queueJob: 'blue',\n      event: 'brightGreen',\n      debug: 'brightCyan',\n    };\n\n    winston.addColors(customColors);\n\n    this.logger = winston.createLogger({\n      levels: customLevels,\n      level: this.environment === 'production' ? 'info' : 'debug',\n      format: winston.format.combine(\n        winston.format.timestamp({\n          format: 'YYYY-MM-DD HH:mm:ss',\n        }),\n        winston.format.errors({ stack: true }),\n        winston.format.splat(),\n        winston.format.json(),\n      ),\n      transports: [\n        new winston.transports.Console({\n          format: winston.format.combine(winston.format.colorize(), customFormat),\n        }),\n      ],\n    });\n  }\n\n  public static getInstance(): Logger {\n    if (!Logger.instance) {\n      Logger.instance = new Logger();\n    }\n\n    return Logger.instance;\n  }\n\n  private getCustomFormat(): winston.Logform.Format {\n    return winston.format.printf(({ level, message, timestamp, ...meta }) => {\n      if (cluster.isWorker && cluster.worker) {\n        meta['Worker'] = cluster.worker.id; // .process.pid;\n      }\n\n      const metaString = Object.entries(meta)\n        .map(([key, value]) => {\n          return `${key}: ${value}`;\n        })\n        .join(' | ');\n\n      if (level === 'error') {\n        if (this.isSentryInitialized) {\n          const errorMessage = typeof message === 'string' ? message : JSON.stringify(message);\n\n          Sentry.captureException(new Error(errorMessage));\n        }\n      }\n\n      return `[${timestamp}] ${level}: ${message}${metaString ? ` (${metaString})` : ''}`;\n    });\n  }\n\n  public initSentry({ sentryDsn, environment }: { sentryDsn: string; environment: string }): void {\n    if (!sentryDsn) {\n      this.logger.warn('Missing Sentry DSN when initializing Sentry');\n\n      return;\n    }\n\n    Sentry.init({\n      dsn: sentryDsn,\n      integrations: [nodeProfilingIntegration()],\n      tracesSampleRate: 1.0,\n      environment,\n    });\n\n    this.isSentryInitialized = true;\n  }\n\n  public log({\n    level,\n    message,\n    meta,\n    options: _options,\n  }: {\n    level: LoggerLevels;\n    message: unknown;\n    meta?: Record<string, unknown>;\n    options?: LogOptions;\n  }): void {\n    // if (options?.muteWorker) {\n    // }\n\n    if (message instanceof Error) {\n      const errorMessage = message.stack ?? message.toString();\n      this.logger.log(level, errorMessage, meta);\n    } else if (typeof message === 'string') {\n      this.logger.log(level, message, meta);\n    } else {\n      this.logger.log(level, JSON.stringify(message), meta);\n    }\n  }\n\n  public debug({\n    message,\n    meta,\n    options,\n  }: {\n    message: unknown;\n    meta?: Record<string, unknown>;\n    options?: LogOptions;\n  }): void;\n  public debug(message: unknown, meta?: Record<string, unknown>): void;\n  public debug(\n    messageOrOptions: unknown | { message: unknown; meta?: Record<string, unknown>; options?: LogOptions },\n    meta?: Record<string, unknown>,\n  ): void {\n    if (typeof messageOrOptions === 'object' && messageOrOptions !== null && 'message' in messageOrOptions) {\n      const {\n        message,\n        meta: optionsMeta,\n        options,\n      } = messageOrOptions as { message: unknown; meta?: Record<string, unknown>; options?: LogOptions };\n      this.log({ level: 'debug', message, meta: optionsMeta, options });\n    } else {\n      this.log({ level: 'debug', message: messageOrOptions, meta, options: undefined });\n    }\n  }\n\n  public info({\n    message,\n    meta,\n    options,\n  }: {\n    message: unknown;\n    meta?: Record<string, unknown>;\n    options?: LogOptions;\n  }): void;\n  public info(message: unknown, meta?: Record<string, unknown>): void;\n  public info(\n    messageOrOptions: unknown | { message: unknown; meta?: Record<string, unknown>; options?: LogOptions },\n    meta?: Record<string, unknown>,\n  ): void {\n    if (typeof messageOrOptions === 'object' && messageOrOptions !== null && 'message' in messageOrOptions) {\n      const {\n        message,\n        meta: optionsMeta,\n        options,\n      } = messageOrOptions as { message: unknown; meta?: Record<string, unknown>; options?: LogOptions };\n      this.log({ level: 'info', message, meta: optionsMeta, options });\n    } else {\n      this.log({ level: 'info', message: messageOrOptions, meta, options: undefined });\n    }\n  }\n\n  public warn({\n    message,\n    meta,\n    options,\n  }: {\n    message: unknown;\n    meta?: Record<string, unknown>;\n    options?: LogOptions;\n  }): void;\n  public warn(message: unknown, meta?: Record<string, unknown>): void;\n  public warn(\n    messageOrOptions: unknown | { message: unknown; meta?: Record<string, unknown>; options?: LogOptions },\n    meta?: Record<string, unknown>,\n  ): void {\n    if (typeof messageOrOptions === 'object' && messageOrOptions !== null && 'message' in messageOrOptions) {\n      const {\n        message,\n        meta: optionsMeta,\n        options,\n      } = messageOrOptions as { message: unknown; meta?: Record<string, unknown>; options?: LogOptions };\n      this.log({ level: 'warn', message, meta: optionsMeta, options });\n    } else {\n      this.log({ level: 'warn', message: messageOrOptions, meta, options: undefined });\n    }\n  }\n\n  public error({\n    error,\n    message,\n    meta,\n    options,\n  }: {\n    error: Error | unknown;\n    message?: string;\n    meta?: Record<string, unknown>;\n    options?: LogOptions;\n  }): void {\n    if (message) {\n      // If a message is provided, combine it with the error for better context\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      const combinedMessage = `${message}: ${errorMessage}`;\n      this.log({ level: 'error', message: combinedMessage, meta, options });\n\n      // Also capture the original error for Sentry if it's an Error object\n      if (error instanceof Error && this.isSentryInitialized) {\n        Sentry.captureException(error);\n      }\n    } else {\n      // Original behavior when no message is provided\n      this.log({ level: 'error', message: error, meta, options });\n    }\n  }\n\n  public custom({\n    level,\n    message,\n    meta,\n    options,\n  }: {\n    level: LoggerLevels;\n    message: unknown;\n    meta?: Record<string, unknown>;\n    options?: LogOptions;\n  }): void {\n    this.log({ level, message, meta, options });\n  }\n}\n\nexport default Logger.getInstance();\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/websocket/websocket-base.js

@@ -22,7 +22,7 @@ class WebSocketBase {
     const controllers = await Loader.loadModulesInDirectory({
       directory: controllersDirectory,
       // NOTE:
-      // When getting "system", it gets /app/node_modules/@pxl/nodejs-framework/dist/websocket/controllers/server
+      // When getting "system", it gets /app/node_modules/@scpxl/nodejs-framework/dist/websocket/controllers/server
       // Therefor .js is needed also
       // Fix so only .ts vs .js is needed
       extensions: [".ts", ".js"]

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/websocket/websocket-base.ts"],
-  "sourcesContent": ["import { existsSync } from 'fs';\nimport type { WebSocketMessageHandler, WebSocketRoute, WebSocketType } from './websocket.interface.js';\nimport { getRouteKey, log, parseServerMessage } from './utils.js';\nimport type { WebSocketServerBaseControllerType } from './controller/server/base.interface.js';\nimport type { WebSocketClientBaseControllerType } from './controller/client/base.interface.js';\nimport type WebSocket from 'ws';\nimport { Helper, Loader } from '../util/index.js';\n\nexport default abstract class WebSocketBase {\n  protected routes: WebSocketRoute[] = [];\n  protected routeHandlers: Map<string, WebSocketMessageHandler> = new Map();\n\n  protected defaultRoutes: WebSocketRoute[] = [];\n\n  public abstract get type(): WebSocketType;\n\n  protected abstract getControllerDependencies(): any;\n  protected abstract shouldPrintRoutes(): boolean;\n  protected abstract handleMessageError(clientId: string, error: string): void;\n\n  protected async configureRoutes(routes: WebSocketRoute[], controllersDirectory: string): Promise<void> {\n    // log ('Configuring routes', { Type: this.type, 'Controllers Directory': controllersDirectory });\n\n    const controllersDirectoryExists = await existsSync(controllersDirectory);\n\n    if (!controllersDirectoryExists) {\n      log('Controllers directory not found', {\n        Directory: controllersDirectory,\n      });\n\n      return;\n    }\n\n    const scriptFileExtension = Helper.getScriptFileExtension();\n\n    // Load controllers\n    const controllers = await Loader.loadModulesInDirectory({\n      directory: controllersDirectory,\n      // NOTE:\n      // When getting \"system\", it gets /app/node_modules/@pxl/nodejs-framework/dist/websocket/controllers/server\n      // Therefor .js is needed also\n      // Fix so only .ts vs .js is needed\n      extensions: ['.ts', '.js'],\n    });\n\n    for (const route of routes) {\n      let ControllerClass: WebSocketServerBaseControllerType | WebSocketClientBaseControllerType;\n\n      // log('Registering route', {\n      //   Type: route.type,\n      //   Controller: route.controller ? route.controller.toString() : route.controllerName,\n      //   Action: route.action,\n      // });\n\n      if (route.controller) {\n        ControllerClass = route.controller;\n      } else if (route.controllerName) {\n        ControllerClass = controllers[route.controllerName];\n      } else {\n        throw new Error('WebSocket controller config not found');\n      }\n\n      if (typeof ControllerClass !== 'function') {\n        log('Controller not found', {\n          Controller: route.controllerName,\n          Path: `${controllersDirectory}/${route.controllerName}.${scriptFileExtension}`,\n        });\n\n        continue;\n      }\n\n      const controllerDependencies = this.getControllerDependencies();\n\n      const controllerInstance = new ControllerClass(controllerDependencies);\n\n      const controllerHandler = controllerInstance[\n        route.action as keyof typeof controllerInstance\n      ] as WebSocketMessageHandler;\n      const routeKey = getRouteKey(route.type, route.action);\n\n      this.routeHandlers.set(routeKey, controllerHandler);\n    }\n\n    if (this.shouldPrintRoutes()) {\n      log('Routes:', { Type: this.type });\n\n      this.printRoutes();\n    }\n  }\n\n  protected async handleServerMessage(ws: WebSocket, message: WebSocket.Data, clientId: string): Promise<void | any> {\n    try {\n      const parsedMessage = parseServerMessage(message);\n      const type = parsedMessage.type;\n      const action = parsedMessage.action;\n\n      log('Incoming message', {\n        'Client ID': clientId,\n        Type: type ?? '-',\n        Action: action ?? '-',\n      });\n\n      const routeKey = getRouteKey(parsedMessage.type as string, parsedMessage.action as string);\n\n      const messageHandler = this.routeHandlers.get(routeKey);\n\n      if (messageHandler) {\n        const messageResponse = await messageHandler(ws, clientId, parsedMessage.data);\n\n        return {\n          type,\n          action,\n          response: messageResponse,\n        };\n      }\n      // throw new Error(`Route handler not found (Route Key: ${routeKey} | Type: ${type} | Action: ${action})`);\n\n      log('Route handler not found', {\n        RouteKey: routeKey,\n        Type: type,\n        Action: action,\n      });\n\n      // if (\n      //   typeof this.applicationConfig.webSocket\n      //     ?.serverMessageHandler === 'function'\n      // ) {\n      //   // Execute custom application subscriber event handler\n      //   this.applicationConfig.webSocket.serverMessageHandler(\n      //     {\n      //       ws,\n      //       clientId,\n      //       parsedMessage,\n      //     },\n      //   );\n      // }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Unknown error';\n\n      log(errorMessage);\n\n      this.handleMessageError(clientId, errorMessage);\n    }\n  }\n\n  protected printRoutes(): void {\n    let routesString = '';\n\n    const routeKeys = Array.from(this.routeHandlers.keys());\n\n    routeKeys.forEach((routeKey, index) => {\n      const [type, action] = routeKey.split(':');\n\n      routesString += `Type: ${type} -> Action: ${action}`;\n\n      if (index !== routeKeys.length - 1) {\n        routesString += '\\n';\n      }\n    });\n\n    log(routesString);\n  }\n}\n"],
+  "sourcesContent": ["import { existsSync } from 'fs';\nimport type { WebSocketMessageHandler, WebSocketRoute, WebSocketType } from './websocket.interface.js';\nimport { getRouteKey, log, parseServerMessage } from './utils.js';\nimport type { WebSocketServerBaseControllerType } from './controller/server/base.interface.js';\nimport type { WebSocketClientBaseControllerType } from './controller/client/base.interface.js';\nimport type WebSocket from 'ws';\nimport { Helper, Loader } from '../util/index.js';\n\nexport default abstract class WebSocketBase {\n  protected routes: WebSocketRoute[] = [];\n  protected routeHandlers: Map<string, WebSocketMessageHandler> = new Map();\n\n  protected defaultRoutes: WebSocketRoute[] = [];\n\n  public abstract get type(): WebSocketType;\n\n  protected abstract getControllerDependencies(): any;\n  protected abstract shouldPrintRoutes(): boolean;\n  protected abstract handleMessageError(clientId: string, error: string): void;\n\n  protected async configureRoutes(routes: WebSocketRoute[], controllersDirectory: string): Promise<void> {\n    // log ('Configuring routes', { Type: this.type, 'Controllers Directory': controllersDirectory });\n\n    const controllersDirectoryExists = await existsSync(controllersDirectory);\n\n    if (!controllersDirectoryExists) {\n      log('Controllers directory not found', {\n        Directory: controllersDirectory,\n      });\n\n      return;\n    }\n\n    const scriptFileExtension = Helper.getScriptFileExtension();\n\n    // Load controllers\n    const controllers = await Loader.loadModulesInDirectory({\n      directory: controllersDirectory,\n      // NOTE:\n      // When getting \"system\", it gets /app/node_modules/@scpxl/nodejs-framework/dist/websocket/controllers/server\n      // Therefor .js is needed also\n      // Fix so only .ts vs .js is needed\n      extensions: ['.ts', '.js'],\n    });\n\n    for (const route of routes) {\n      let ControllerClass: WebSocketServerBaseControllerType | WebSocketClientBaseControllerType;\n\n      // log('Registering route', {\n      //   Type: route.type,\n      //   Controller: route.controller ? route.controller.toString() : route.controllerName,\n      //   Action: route.action,\n      // });\n\n      if (route.controller) {\n        ControllerClass = route.controller;\n      } else if (route.controllerName) {\n        ControllerClass = controllers[route.controllerName];\n      } else {\n        throw new Error('WebSocket controller config not found');\n      }\n\n      if (typeof ControllerClass !== 'function') {\n        log('Controller not found', {\n          Controller: route.controllerName,\n          Path: `${controllersDirectory}/${route.controllerName}.${scriptFileExtension}`,\n        });\n\n        continue;\n      }\n\n      const controllerDependencies = this.getControllerDependencies();\n\n      const controllerInstance = new ControllerClass(controllerDependencies);\n\n      const controllerHandler = controllerInstance[\n        route.action as keyof typeof controllerInstance\n      ] as WebSocketMessageHandler;\n      const routeKey = getRouteKey(route.type, route.action);\n\n      this.routeHandlers.set(routeKey, controllerHandler);\n    }\n\n    if (this.shouldPrintRoutes()) {\n      log('Routes:', { Type: this.type });\n\n      this.printRoutes();\n    }\n  }\n\n  protected async handleServerMessage(ws: WebSocket, message: WebSocket.Data, clientId: string): Promise<void | any> {\n    try {\n      const parsedMessage = parseServerMessage(message);\n      const type = parsedMessage.type;\n      const action = parsedMessage.action;\n\n      log('Incoming message', {\n        'Client ID': clientId,\n        Type: type ?? '-',\n        Action: action ?? '-',\n      });\n\n      const routeKey = getRouteKey(parsedMessage.type as string, parsedMessage.action as string);\n\n      const messageHandler = this.routeHandlers.get(routeKey);\n\n      if (messageHandler) {\n        const messageResponse = await messageHandler(ws, clientId, parsedMessage.data);\n\n        return {\n          type,\n          action,\n          response: messageResponse,\n        };\n      }\n      // throw new Error(`Route handler not found (Route Key: ${routeKey} | Type: ${type} | Action: ${action})`);\n\n      log('Route handler not found', {\n        RouteKey: routeKey,\n        Type: type,\n        Action: action,\n      });\n\n      // if (\n      //   typeof this.applicationConfig.webSocket\n      //     ?.serverMessageHandler === 'function'\n      // ) {\n      //   // Execute custom application subscriber event handler\n      //   this.applicationConfig.webSocket.serverMessageHandler(\n      //     {\n      //       ws,\n      //       clientId,\n      //       parsedMessage,\n      //     },\n      //   );\n      // }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Unknown error';\n\n      log(errorMessage);\n\n      this.handleMessageError(clientId, errorMessage);\n    }\n  }\n\n  protected printRoutes(): void {\n    let routesString = '';\n\n    const routeKeys = Array.from(this.routeHandlers.keys());\n\n    routeKeys.forEach((routeKey, index) => {\n      const [type, action] = routeKey.split(':');\n\n      routesString += `Type: ${type} -> Action: ${action}`;\n\n      if (index !== routeKeys.length - 1) {\n        routesString += '\\n';\n      }\n    });\n\n    log(routesString);\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scpxl/nodejs-framework",
-  "version": "1.0.13",
+  "version": "1.0.17",
   "description": "PXL Node.js Framework",
   "engines": {
     "node": ">=22.0.0"
@@ -69,21 +69,25 @@
     "build": "npm run clean && node esbuild.config.js",
     "build:tsc": "npm run clean && tsc",
     "build:local": "npm run clean && node esbuild.config.js && yalc push",
-    "docs": "typedoc",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
     "release": "node scripts/release.js",
     "prepare": "husky",
+    "postinstall": "npm run build || echo 'Build failed, dist files may be missing'",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
-    "format": "prettier --check .",
-    "format:fix": "prettier --write .",
+    "prettier": "prettier --check .",
+    "prettier:fix": "prettier --write .",
     "typecheck": "tsc --noEmit",
-    "test": "node --test --experimental-strip-types test/**/*.test.ts",
-    "test:watch": "node --test --watch --experimental-strip-types test/**/*.test.ts",
-    "test:coverage": "node --test --experimental-test-coverage --experimental-strip-types test/**/*.test.ts",
-    "test:unit": "node --test --experimental-strip-types test/unit/**/*.test.ts",
-    "test:integration": "node --test --experimental-strip-types test/integration/**/*.test.ts",
-    "test:e2e": "node --test --experimental-strip-types test/e2e/**/*.test.ts",
-    "check-all": "npm run lint && npm run format && npm run typecheck",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:unit": "vitest run test/unit",
+    "test:integration": "vitest run test/integration",
+    "test:e2e": "vitest run test/e2e",
+    "test:ui": "vitest --ui",
+    "check-all": "npm run lint && npm run prettier && npm run typecheck",
     "yalc:publish": "yalc publish",
     "yalc:push": "yalc push",
     "dev:yalc": "npm run build && npm run yalc:push"
@@ -100,6 +104,8 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.1.0",
     "@typescript-eslint/parser": "^8.1.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
     "del-cli": "^6.0.0",
     "esbuild": "^0.25.5",
     "eslint": "^9.9.0",
@@ -115,7 +121,8 @@
     "ts-node": "^10.9.2",
     "tsc-alias": "^1.8.16",
     "tsconfig-paths": "^4.2.0",
-    "typedoc": "^0.28.7"
+    "vitepress": "^1.6.4",
+    "vitest": "^3.2.4"
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.496.0",