@scpxl/nodejs-framework 1.0.22 → 1.0.24

package/README.md

@@ -152,33 +152,146 @@ await app.queue.manager.addJobToQueue({
 });
 ```
 
+### Simple Load Test
+
+Run lightweight load against any endpoint while iterating locally:
+
+```bash
+npm run load:test -- --url http://localhost:3000/health --requests 200 --concurrency 10
+```
+
+Switch to a time-based stream for soak-style checks:
+
+```bash
+npm run load:test -- --url http://localhost:3000/api/users --duration 30 --concurrency 8 --method POST --body '{"name":"Test"}' --header 'Content-Type: application/json'
+```
+
+The script reports latency percentiles, status code counts, and a few failure samples for quick feedback.
+
 ### WebSocket Server
 
+Real-time bidirectional communication with room support and authentication:
+
 ```typescript
 import { WebApplication } from '@scpxl/nodejs-framework';
+import { WebSocketServerBaseController } from '@scpxl/nodejs-framework/websocket';
+import type { WebSocket } from 'ws';
+
+// Create WebSocket controller
+class ChatController extends WebSocketServerBaseController {
+  public send = (ws: WebSocket, clientId: string, data: any) => {
+    // Broadcast to all clients
+    this.webSocketServer.sendMessageToAll({
+      data: {
+        type: 'chat',
+        action: 'message',
+        data: {
+          clientId,
+          text: data.text,
+          timestamp: new Date().toISOString(),
+        },
+      },
+    });
+
+    return { success: true };
+  };
+}
 
 const app = new WebApplication({
   name: 'chat-app',
   webserver: { port: 3000 },
-  websocket: { enabled: true },
+  websocket: {
+    enabled: true,
+    type: 'server',
+    url: 'ws://localhost:3000/ws',
+    controllersDirectory: './controllers',
+    routes: [
+      {
+        type: 'chat',
+        action: 'send',
+        controllerName: 'chat',
+        controller: ChatController,
+      },
+    ],
+    // Optional: JWT authentication
+    // Clients connect with: ws://localhost:3000/ws?token=<jwt>
+    events: {
+      onConnected: ({ ws, clientId }) => {
+        console.log('Client connected:', clientId);
+        ws.send(
+          JSON.stringify({
+            type: 'system',
+            action: 'connected',
+            data: { clientId, message: 'Welcome!' },
+          }),
+        );
+      },
+    },
+  },
   redis: { host: '127.0.0.1', port: 6379 },
+  auth: {
+    jwtSecretKey: process.env.JWT_SECRET || 'your-secret-key',
+  },
 });
 
 await app.start();
+console.log('WebSocket server running at ws://localhost:3000/ws');
+```
+
+#### Using Rooms
+
+```typescript
+// Client joins a room (built-in system controller)
+// Send from client: { type: 'system', action: 'joinRoom', data: { roomName: 'general', username: 'Alice' } }
+
+// Server-side: Broadcast to room members
+const roomClients = app.websocket.server.rooms.get('general');
+roomClients?.forEach(clientId => {
+  const client = app.websocket.server.clientManager.getClient({ clientId });
+  if (client?.ws) {
+    app.websocket.server.sendClientMessage(client.ws, {
+      type: 'room',
+      action: 'message',
+      data: { text: 'Room-specific announcement' },
+    });
+  }
+});
+```
 
-// Handle WebSocket connections
-app.websocket.server.onConnection(client => {
-  console.log('Client connected:', client.id);
+#### Using WebSocket Service
 
-  client.sendJSON({ type: 'welcome', message: 'Connected to chat server' });
+Simplified API for common operations:
 
-  client.on('message', data => {
-    // Broadcast to all clients
-    app.websocket.server.broadcast({ type: 'chat', data });
-  });
+```typescript
+import { WebSocketService } from '@scpxl/nodejs-framework/websocket';
+
+const wsService = new WebSocketService({
+  webSocketServer: app.websocket.server,
+  redisInstance: app.redis.instance,
+  workerId: String(process.pid),
 });
+
+// Broadcast to all clients
+await wsService.broadcast({
+  type: 'notification',
+  action: 'alert',
+  data: { message: 'New features available!' },
+});
+
+// Send to specific rooms
+await wsService.sendToRooms(['vip', 'premium'], {
+  type: 'offer',
+  action: 'new',
+  data: { discount: 20 },
+});
+
+// Convenience methods
+await wsService.sendUserMessage('profileUpdated', { userId: 123 });
+await wsService.sendSystemMessage('maintenance', { minutes: 5 });
 ```
 
+See the [WebSocket Guide](./docs/guides/websocket.md) for complete documentation.
+
 ---
 
 ## 📚 Documentation
@@ -336,6 +449,51 @@ See [examples/README.md](examples/README.md) for more details.
 
 ## 🛠️ Development
 
+### CLI (`pxl`)
+
+The framework now ships with a bundled CLI executable exposed as `pxl` when the package is installed.
+
+Current capabilities:
+
+- `pxl --version` / `pxl -v` / `pxl version` – Print framework version
+- `pxl info` (or just `pxl`) – Display banner + roadmap
+
+Planned subcommands (roadmap):
+
+- `pxl doctor` – Environment diagnostics (Node version, dependency checks, Redis/Postgres availability)
+- `pxl generate` – Scaffolding for applications, routes, commands, processors
+- `pxl analyze` – Project inspection (unused files, dependency graph summary)
+
+Usage examples:
+
+```bash
+# Show version
+pxl --version
+
+# Show framework banner and roadmap
+pxl info
+
+# (Future) Run doctor diagnostics
+pxl doctor
+```
+
+Development Note:
+
+When iterating locally, rebuild after CLI changes:
+
+```bash
+npm run build && pxl info
+```
+
+To test unpublished changes in another project via yalc:
+
+```bash
+npm run build:local
+yalc add @scpxl/nodejs-framework
+```
+
+For contributions adding new subcommands, implement them in `src/cli/` and register via the yargs builder in `src/cli/index.ts`.
+
 ### Build Commands
 
 ```bash
@@ -380,6 +538,38 @@ npm run test:ui
 
 The framework maintains **80% code coverage** across all metrics (lines, branches, functions, statements) as enforced by Vitest thresholds.
 
+### Framework Status Report
+
+Generate a cross-platform project health snapshot (dependency counts, git status, directory sizes, large packages, outdated/age metrics):
+
+```bash
+npm run status
+```
+
+Optional flags:
+
+```bash
+npm run status -- --include-cache               # Include .turbo/ and .next/cache directories
+npm run status -- --exclude "coverage,fixtures,**/*.snap"  # Additional exclude globs (comma-separated)
+```
+
+What it does:
+
+- Collects repo & package metadata (version, scripts, dependency counts)
+- Summarizes current git branch, last commit, and pending change counts
+- Computes sizes for `src`, `dist`, and `node_modules` using fast native traversal (`fast-folder-size`) with a JS fallback, filtering via `.gitignore` / `.npmignore` plus exclusions
+- Lists the largest packages in `node_modules` (top 8 by size)
+- Ranks outdated dependencies by publish age and major version lag (uses `npm outdated` / `npm view`)
+- Provides age distribution stats for installed top-level packages
+
+Exclusions & Ignore Behavior:
+
+- Always respects patterns found in `.gitignore` and `.npmignore` (except always keeps top-level `dist` & `node_modules`)
+- Built-in default excludes: `coverage/`, `fixtures/`, and `**/*.snap`
+- Skips heavy build caches (`.turbo`, `.next/cache`) unless `--include-cache` is passed
+
+Return codes: exits with non-zero only on unexpected internal errors; missing npm or network failures simply degrade sections gracefully.
+
 ### Local Development with Yalc
 
 For testing changes in consuming applications:

package/dist/api-requester/api-requester.d.ts

@@ -0,0 +1,32 @@
+export interface ApiRequestConfig extends Omit<RequestInit, 'method' | 'body' | 'headers'> {
+    headers?: Record<string, string | undefined>;
+    params?: Record<string, string | number | boolean | null | undefined>;
+    responseType?: 'json' | 'text';
+}
+export interface ApiResponse<T> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+}
+export default class ApiRequester {
+    private readonly baseURL;
+    private readonly defaultHeaders;
+    constructor(baseURL: string, headers?: Record<string, string>);
+    get<T>(url: string, config?: ApiRequestConfig): Promise<ApiResponse<T> | undefined>;
+    post<T, R>(url: string, data: T, config?: ApiRequestConfig): Promise<ApiResponse<R> | undefined>;
+    put<T, R>(url: string, data: T, config?: ApiRequestConfig): Promise<ApiResponse<R> | undefined>;
+    delete<T>(url: string, config?: ApiRequestConfig): Promise<ApiResponse<T> | undefined>;
+    private request;
+    private mergeHeaders;
+    private prepareBody;
+    private shouldSerializeAsJson;
+    private headersToRecord;
+    private buildUrl;
+    private isAbsoluteUrl;
+    private combineWithBase;
+    private parseResponse;
+    private createHttpError;
+    private handleError;
+}
+//# sourceMappingURL=api-requester.d.ts.map

package/dist/api-requester/api-requester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-requester.d.ts","sourceRoot":"","sources":["../../src/api-requester/api-requester.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AA0BD,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;gBAE5C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAKpD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAInF,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAIhG,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAI/F,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;YAIrF,OAAO;IAsCrB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,eAAe;YAUT,aAAa;YAkBb,eAAe;IAoC7B,OAAO,CAAC,WAAW;CAapB"}

package/dist/api-requester/index.d.ts

@@ -0,0 +1,3 @@
+export { default as ApiRequester } from './api-requester.js';
+export type { ApiRequestConfig, ApiResponse } from './api-requester.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api-requester/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api-requester/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,106 @@
+import { type DatabaseInstance, DatabaseManager } from '../database/index.js';
+import QueueManager from '../queue/manager.js';
+import RedisManager from '../redis/manager.js';
+import type { ApplicationConfig, ApplicationStopInstanceOptions } from './base-application.interface.js';
+import type RedisInstance from '../redis/instance.js';
+import CacheManager from '../cache/manager.js';
+import EventManager from '../event/manager.js';
+import type { PerformanceMonitor } from '../performance/performance-monitor.js';
+import { LifecycleManager, ShutdownController } from '../lifecycle/index.js';
+export type { ApplicationConfig } from './base-application.interface.js';
+export default abstract class BaseApplication {
+    /** Unique instance ID */
+    uniqueInstanceId: string;
+    /** Application start time */
+    protected startTime: number;
+    /** Shutdown timeout (30 seconds) */
+    protected shutdownTimeout: number;
+    /** Cache for application version to avoid repeated imports */
+    private static applicationVersionCache;
+    /** Cluster worker ID */
+    protected workerId: number | null;
+    /** Application config */
+    protected config: ApplicationConfig;
+    /** Application version */
+    protected applicationVersion?: string;
+    /** Redis manager */
+    redisManager: RedisManager;
+    /** Cache manager */
+    cacheManager: CacheManager;
+    /** Database manager */
+    databaseManager?: DatabaseManager;
+    /** Queue manager */
+    queueManager?: QueueManager;
+    /** Event manager */
+    eventManager?: EventManager;
+    /** Performance monitor */
+    performanceMonitor?: PerformanceMonitor;
+    /** Lifecycle manager */
+    lifecycle: LifecycleManager;
+    /** Shutdown controller */
+    shutdownController: ShutdownController;
+    get Name(): string;
+    /**
+     * Application constructor
+     */
+    constructor(config: ApplicationConfig);
+    /**
+     * Get application version
+     */
+    getApplicationVersion(): Promise<string>;
+    /**
+     * Start application
+     */
+    start(): Promise<void>;
+    /**
+     * Before application start
+     */
+    private onBeforeStart;
+    /**
+     * Application started event
+     */
+    protected onStarted({ startupTime: _startupTime }: {
+        startupTime: number;
+    }): void;
+    /**
+     * Application stopped event
+     */
+    protected onStopped({ runtime: _runtime }: {
+        runtime: number;
+    }): void;
+    /**
+     * Start application instance
+     */
+    private startInstance;
+    protected abstract startHandler({ redisInstance, databaseInstance, queueManager, eventManager, }: {
+        redisInstance: RedisInstance;
+        databaseInstance?: DatabaseInstance | null;
+        queueManager: QueueManager;
+        eventManager?: EventManager | null;
+    }): Promise<void>;
+    protected abstract stopCallback(): void;
+    /**
+     * Set up global error handlers
+     */
+    /**
+     * Initialize performance monitor
+     */
+    private setupGlobalErrorHandlers;
+    /**
+     * Register shutdown hooks for proper cleanup
+     */
+    private registerShutdownHooks;
+    /**
+     * Initiate graceful shutdown
+     */
+    private initiateGracefulShutdown;
+    /**
+     * Stop application using lifecycle manager
+     */
+    stop({ onStopped }?: ApplicationStopInstanceOptions): Promise<void>;
+    /**
+     * Finalize exit: during tests, suppress actual process exit to avoid failing vitest runs.
+     */
+    private finalizeExit;
+}
+//# sourceMappingURL=base-application.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-application.d.ts","sourceRoot":"","sources":["../../src/application/base-application.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,YAAY,MAAM,qBAAqB,CAAC;AAC/C,OAAO,YAAY,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EACV,iBAAiB,EAEjB,8BAA8B,EAC/B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAC;AAEtD,OAAO,YAAY,MAAM,qBAAqB,CAAC;AAE/C,OAAO,YAAY,MAAM,qBAAqB,CAAC;AAE/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAGhF,OAAO,EAAwB,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAKnG,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,eAAe;IAC3C,yBAAyB;IAClB,gBAAgB,EAAE,MAAM,CAAC;IAEhC,6BAA6B;IAC7B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAK;IAEhC,oCAAoC;IACpC,SAAS,CAAC,eAAe,SAAS;IAElC,8DAA8D;IAC9D,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAqB;IAE3D,wBAAwB;IACxB,SAAS,CAAC,QAAQ,gBAAiE;IAEnF,yBAAyB;IACzB,SAAS,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEpC,0BAA0B;IAC1B,SAAS,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAEtC,oBAAoB;IACb,YAAY,EAAE,YAAY,CAAC;IAElC,oBAAoB;IACb,YAAY,EAAE,YAAY,CAAC;IAElC,uBAAuB;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAEzC,oBAAoB;IACb,YAAY,CAAC,EAAE,YAAY,CAAC;IAEnC,oBAAoB;IACb,YAAY,CAAC,EAAE,YAAY,CAAC;IAEnC,0BAA0B;IACnB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAE/C,wBAAwB;IACjB,SAAS,EAAE,gBAAgB,CAAC;IAEnC,0BAA0B;IACnB,kBAAkB,EAAE,kBAAkB,CAAC;IAE9C,IAAW,IAAI,WAEd;IAED;;OAEG;gBACS,MAAM,EAAE,iBAAiB;IAiFrC;;OAEG;IACU,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC;IAyBrD;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCnC;;OAEG;YACW,aAAa;IAuE3B;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAEjF;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAErE;;OAEG;YACW,aAAa;IA0D3B,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAC9B,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,EAAE;QACD,aAAa,EAAE,aAAa,CAAC;QAC7B,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAC3C,YAAY,EAAE,YAAY,CAAC;QAC3B,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;KACpC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjB,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,IAAI;IAEvC;;OAEG;IACH;;OAEG;IAIH,OAAO,CAAC,wBAAwB;IAkBhC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;OAEG;YACW,wBAAwB;IA6BtC;;OAEG;IACU,IAAI,CAAC,EAAE,SAAS,EAAE,GAAE,8BAAmC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCpF;;OAEG;IACH,OAAO,CAAC,YAAY;CAerB"}

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

@@ -0,0 +1,162 @@
+import type { ClusterManagerConfig } from '../cluster/cluster-manager.interface.js';
+import type DatabaseInstance from '../database/instance.js';
+import type { EventDefinition } from '../event/manager.interface.js';
+import type { PerformanceMonitorOptions, PerformanceThresholds } from '../performance/performance-monitor.js';
+import type { QueueItem } from '../queue/index.interface.js';
+import type { WebServerDebugOptions, WebServerLogConfig, WebServerOptions, WebServerRoute } from '../webserver/webserver.interface.js';
+import type WebSocketServer from '../websocket/websocket-server.js';
+import type { WebSocketOptions, WebSocketRoute, WebSocketType } from '../websocket/websocket.interface.js';
+export type OnStartedEvent = ({ startupTime }: {
+    startupTime: number;
+}) => void;
+export type OnStoppedEvent = ({ runtime }: {
+    runtime: number;
+}) => void;
+export interface ApplicationStartInstanceOptions {
+    /** On started event */
+    onStarted?: OnStartedEvent;
+}
+export interface ApplicationStopInstanceOptions {
+    /** On stopped event */
+    onStopped?: OnStoppedEvent;
+}
+export interface ApplicationRedisConfig {
+    /** Redis host */
+    host: string;
+    /** Redis port */
+    port: number;
+    /** Redis password */
+    password?: string;
+}
+export interface ApplicationCacheConfig {
+}
+export interface ApplicationDatabaseConfig {
+    /** Whether to enable database */
+    enabled: boolean;
+    /** Database host */
+    host: string;
+    /** Database port */
+    port: number;
+    /** Database username */
+    username: string;
+    /** Database password */
+    password: string;
+    /** Database name */
+    databaseName: string;
+    /** Entities directory */
+    entitiesDirectory: string;
+}
+export interface ApplicationQueueConfig {
+    /** Initial queues */
+    queues: QueueItem[];
+    /** Queue processors directory */
+    processorsDirectory: string;
+    log?: {
+        jobRegistered?: boolean;
+        jobAdded?: boolean;
+        jobCompleted?: boolean;
+        queueRegistered?: boolean;
+        queuesRegistered?: boolean;
+        queueWaiting?: boolean;
+    };
+}
+export interface ApplicationEventConfig {
+    /** Whether to enable event system */
+    enabled: boolean;
+    /** Event controllers directory */
+    controllersDirectory: string;
+    /** Event definitions */
+    events: EventDefinition[];
+}
+export interface ApplicationEmailConfig {
+}
+export interface ApplicationAuthConfig {
+    /** JWT secret key for token verification */
+    jwtSecretKey: string;
+}
+export interface ApplicationWebSocketConfig extends WebSocketOptions {
+    /** WebSocket type */
+    type: WebSocketType;
+    /** Whether to enable WebSocket */
+    enabled: boolean;
+    /** WebSocket routes */
+    routes: WebSocketRoute[];
+    /** WebSocket server message handler */
+    serverMessageHandler?: (options: {
+        ws: WebSocket;
+        clientId: string;
+        parsedMessage: any;
+    }) => void;
+    /** WebSocket subscriber event handler */
+    subscriberEventHandler?: (options: {
+        channel: string;
+        message: any;
+        webSocketServer: WebSocketServer;
+        databaseInstance: DatabaseInstance;
+    }) => void;
+}
+export interface ApplicationWebServerConfig extends WebServerOptions {
+    /** Whether to enable web server */
+    enabled: boolean;
+    /** Web server routes */
+    routes: WebServerRoute[];
+    log?: WebServerLogConfig;
+    debug: WebServerDebugOptions;
+}
+export interface ApplicationCommandsConfig {
+    commandsDirectory: string;
+}
+export interface ApplicationLogConfig {
+    startUp?: boolean;
+    shutdown?: boolean;
+    showRequestIdInConsole?: boolean;
+}
+export interface ApplicationPerformanceConfig extends PerformanceMonitorOptions {
+    /** Whether to enable performance monitoring */
+    enabled?: boolean;
+    /** Performance thresholds for different operations */
+    thresholds?: Partial<PerformanceThresholds>;
+    /** Whether to monitor HTTP requests */
+    monitorHttpRequests?: boolean;
+    /** Whether to monitor database operations */
+    monitorDatabaseOperations?: boolean;
+    /** Whether to monitor WebSocket operations */
+    monitorWebSocketOperations?: boolean;
+    /** Whether to monitor queue operations */
+    monitorQueueOperations?: boolean;
+    /** Whether to monitor cache operations */
+    monitorCacheOperations?: boolean;
+    /** Performance report generation interval in milliseconds */
+    reportInterval?: number;
+    /** Performance report format: 'simple' for one-line, 'detailed' for multi-line */
+    reportFormat?: 'simple' | 'detailed';
+}
+export interface ApplicationConfig {
+    /** Application name */
+    name: string;
+    /** Application instance ID */
+    instanceId: string;
+    /** Root directory */
+    rootDirectory: string;
+    /** Cluster configuration */
+    cluster?: ClusterManagerConfig;
+    /** Redis configuration */
+    redis: ApplicationRedisConfig;
+    /** Cache configuration */
+    cache?: ApplicationCacheConfig;
+    /** Database configuration */
+    database?: ApplicationDatabaseConfig;
+    /** Queue configuration */
+    queue: ApplicationQueueConfig;
+    /** Event configuration */
+    event?: ApplicationEventConfig;
+    /** Log configuration */
+    log?: ApplicationLogConfig;
+    /** Performance monitoring configuration */
+    performanceMonitoring?: ApplicationPerformanceConfig;
+    /** Email configuration */
+    email?: ApplicationEmailConfig;
+    /** Authentication configuration */
+    auth?: ApplicationAuthConfig;
+}
+//# sourceMappingURL=base-application.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-application.interface.d.ts","sourceRoot":"","sources":["../../src/application/base-application.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACf,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,eAAe,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAE3G,MAAM,MAAM,cAAc,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC;AAExE,MAAM,WAAW,+BAA+B;IAC9C,uBAAuB;IACvB,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AACD,MAAM,WAAW,8BAA8B;IAC7C,uBAAuB;IACvB,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IAEb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;CAAG;AAE1C,MAAM,WAAW,yBAAyB;IACxC,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IAEjB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IAEjB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IAEjB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,yBAAyB;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpB,iCAAiC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,GAAG,CAAC,EAAE;QACJ,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IAEjB,kCAAkC;IAClC,oBAAoB,EAAE,MAAM,CAAC;IAE7B,wBAAwB;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;CAAG;AAE1C,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB;AAUD,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAClE,qBAAqB;IACrB,IAAI,EAAE,aAAa,CAAC;IAEpB,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IAEjB,uBAAuB;IACvB,MAAM,EAAE,cAAc,EAAE,CAAC;IAEzB,uCAAuC;IACvC,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,GAAG,CAAA;KAAE,KAAK,IAAI,CAAC;IAElG,yCAAyC;IACzC,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,GAAG,CAAC;QACb,eAAe,EAAE,eAAe,CAAC;QACjC,gBAAgB,EAAE,gBAAgB,CAAC;KACpC,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAClE,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IAWjB,wBAAwB;IACxB,MAAM,EAAE,cAAc,EAAE,CAAC;IAKzB,GAAG,CAAC,EAAE,kBAAkB,CAAC;IAEzB,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,4BAA6B,SAAQ,yBAAyB;IAC7E,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAE5C,uCAAuC;IACvC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,6CAA6C;IAC7C,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAEpC,8CAA8C;IAC9C,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC,0CAA0C;IAC1C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,0CAA0C;IAC1C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,kFAAkF;IAClF,YAAY,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IAEnB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IAEtB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAE/B,0BAA0B;IAC1B,KAAK,EAAE,sBAAsB,CAAC;IAE9B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAE/B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IAErC,0BAA0B;IAC1B,KAAK,EAAE,sBAAsB,CAAC;IAE9B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAE/B,wBAAwB;IACxB,GAAG,CAAC,EAAE,oBAAoB,CAAC;IAE3B,2CAA2C;IAC3C,qBAAqB,CAAC,EAAE,4BAA4B,CAAC;IAErD,0BAA0B;IAC1B,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAE/B,mCAAmC;IACnC,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B"}

package/dist/application/base-application.js

@@ -72,6 +72,9 @@ ${formatted}`);
     const computerName = os.hostname();
     this.uniqueInstanceId = `${config.instanceId}-${computerName}-${OS.getUniqueComputerId()}`;
     this.config = config;
+    if (this.config.log?.showRequestIdInConsole !== void 0) {
+      Logger.configure({ showRequestIdInConsole: this.config.log.showRequestIdInConsole });
+    }
     const lifecycleConfig = {
       gracefulShutdown: {
         timeoutMs: this.shutdownTimeout