@scpxl/nodejs-framework 1.0.22 → 1.0.25

package/dist/websocket/controller/server/base.interface.d.ts

@@ -0,0 +1,13 @@
+import type DatabaseInstance from '../../../database/instance.js';
+import type QueueManager from '../../../queue/manager.js';
+import type { RedisInstance } from '../../../redis/index.js';
+import type WebSocketServer from '../../websocket-server.js';
+import type WebSocketBaseController from './base.js';
+export interface WebSocketServerBaseControllerConstructorParams {
+    webSocketServer: WebSocketServer;
+    redisInstance: RedisInstance;
+    queueManager: QueueManager;
+    databaseInstance: DatabaseInstance;
+}
+export type WebSocketServerBaseControllerType = new (params: WebSocketServerBaseControllerConstructorParams) => WebSocketBaseController;
+//# sourceMappingURL=base.interface.d.ts.map

package/dist/websocket/controller/server/base.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.interface.d.ts","sourceRoot":"","sources":["../../../../src/websocket/controller/server/base.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,YAAY,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,eAAe,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,uBAAuB,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,8CAA8C;IAC7D,eAAe,EAAE,eAAe,CAAC;IAUjC,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,MAAM,iCAAiC,GAAG,KAC9C,MAAM,EAAE,8CAA8C,KACnD,uBAAuB,CAAC"}

package/dist/websocket/controllers/client/system.d.ts

@@ -0,0 +1,6 @@
+import type { WebSocket } from 'ws';
+import { WebSocketClientBaseController } from '../../index.js';
+export default class SystemController extends WebSocketClientBaseController {
+    clientList: (_clientWebSocket: WebSocket, _webSocketClientId: string, _data: any) => any;
+}
+//# sourceMappingURL=system.d.ts.map

package/dist/websocket/controllers/client/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../src/websocket/controllers/client/system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,6BAA6B;IAClE,UAAU,GAAI,kBAAkB,SAAS,EAAE,oBAAoB,MAAM,EAAE,OAAO,GAAG,KAAG,GAAG,CAE5F;CACH"}

package/dist/websocket/controllers/server/system.d.ts

@@ -0,0 +1,7 @@
+import type { WebSocket } from 'ws';
+import WebSocketServerBaseController from '../../controller/server/base.js';
+export default class SystemController extends WebSocketServerBaseController {
+    joinRoom: (clientWebSocket: WebSocket, webSocketClientId: string, data: any) => any;
+    leaveRoom: (clientWebSocket: WebSocket, webSocketClientId: string, data: any) => any;
+}
+//# sourceMappingURL=system.d.ts.map

package/dist/websocket/controllers/server/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../src/websocket/controllers/server/system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,6BAA6B,MAAM,iCAAiC,CAAC;AAG5E,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,6BAA6B;IAClE,QAAQ,GAAI,iBAAiB,SAAS,EAAE,mBAAmB,MAAM,EAAE,MAAM,GAAG,KAAG,GAAG,CA6CvF;IAEK,SAAS,GAAI,iBAAiB,SAAS,EAAE,mBAAmB,MAAM,EAAE,MAAM,GAAG,KAAG,GAAG,CAqCxF;CACH"}

package/dist/websocket/index.d.ts

@@ -0,0 +1,9 @@
+export type { WebSocketRoute } from './websocket.interface.js';
+export { WebSocketRedisSubscriberEvent } from './websocket.interface.js';
+export { default as WebSocketServerBaseController } from './controller/server/base.js';
+export { default as WebSocketClientBaseController } from './controller/client/base.js';
+export { WebSocketService } from './websocket-service.js';
+export type { WebSocketMessage, WebSocketServiceOptions } from './websocket-service.js';
+export { WebSocketAuthService } from './websocket-auth.js';
+export type { WebSocketAuthResult } from './websocket-auth.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/websocket/index.js

@@ -2,7 +2,9 @@ import { WebSocketRedisSubscriberEvent } from "./websocket.interface.js";
 import { default as default2 } from "./controller/server/base.js";
 import { default as default3 } from "./controller/client/base.js";
 import { WebSocketService } from "./websocket-service.js";
+import { WebSocketAuthService } from "./websocket-auth.js";
 export {
+  WebSocketAuthService,
   default3 as WebSocketClientBaseController,
   WebSocketRedisSubscriberEvent,
   default2 as WebSocketServerBaseController,

package/dist/websocket/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/websocket/index.ts"],
-  "sourcesContent": ["export type { WebSocketRoute } from './websocket.interface.js';\nexport { WebSocketRedisSubscriberEvent } from './websocket.interface.js';\nexport { default as WebSocketServerBaseController } from './controller/server/base.js';\nexport { default as WebSocketClientBaseController } from './controller/client/base.js';\nexport { WebSocketService } from './websocket-service.js';\nexport type { WebSocketMessage, WebSocketServiceOptions } from './websocket-service.js';\n"],
-  "mappings": "AACA,SAAS,qCAAqC;AAC9C,SAAoB,WAAXA,gBAAgD;AACzD,SAAoB,WAAXA,gBAAgD;AACzD,SAAS,wBAAwB;",
+  "sourcesContent": ["export type { WebSocketRoute } from './websocket.interface.js';\nexport { WebSocketRedisSubscriberEvent } from './websocket.interface.js';\nexport { default as WebSocketServerBaseController } from './controller/server/base.js';\nexport { default as WebSocketClientBaseController } from './controller/client/base.js';\nexport { WebSocketService } from './websocket-service.js';\nexport type { WebSocketMessage, WebSocketServiceOptions } from './websocket-service.js';\nexport { WebSocketAuthService } from './websocket-auth.js';\nexport type { WebSocketAuthResult } from './websocket-auth.js';\n"],
+  "mappings": "AACA,SAAS,qCAAqC;AAC9C,SAAoB,WAAXA,gBAAgD;AACzD,SAAoB,WAAXA,gBAAgD;AACzD,SAAS,wBAAwB;AAEjC,SAAS,4BAA4B;",
   "names": ["default"]
 }

package/dist/websocket/routes/client/system.d.ts

@@ -0,0 +1,3 @@
+import type { WebSocketRoute } from '../../websocket.interface.js';
+export declare const webSocketSystemClientRoutes: WebSocketRoute[];
+//# sourceMappingURL=system.d.ts.map

package/dist/websocket/routes/client/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../src/websocket/routes/client/system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,eAAO,MAAM,2BAA2B,EAAE,cAAc,EAMvD,CAAC"}

package/dist/websocket/routes/server/system.d.ts

@@ -0,0 +1,3 @@
+import type { WebSocketRoute } from '../../websocket.interface.js';
+export declare const webSocketSystemClientRoutes: WebSocketRoute[];
+//# sourceMappingURL=system.d.ts.map

package/dist/websocket/routes/server/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../src/websocket/routes/server/system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,eAAO,MAAM,2BAA2B,EAAE,cAAc,EAWvD,CAAC"}

package/dist/websocket/utils.d.ts

@@ -0,0 +1,9 @@
+import type WebSocket from 'ws';
+export interface LogOptions {
+    muteWorker?: boolean;
+}
+export declare function generateClientId(): string;
+export declare function log(message: string, meta?: Record<string, unknown>, options?: LogOptions): void;
+export declare function parseServerMessage(message: WebSocket.Data): Record<string, unknown>;
+export declare function getRouteKey(type: string, action: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/websocket/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/websocket/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AAGhC,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAE/F;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBnF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/websocket/websocket-auth.d.ts

@@ -0,0 +1,17 @@
+import type { WebApplicationConfig } from '../application/web-application.interface.js';
+export interface WebSocketAuthResult {
+    userId: number;
+    payload: Record<string, unknown>;
+}
+export declare class WebSocketAuthService {
+    private readonly applicationConfig;
+    constructor(applicationConfig: WebApplicationConfig);
+    /**
+     * Validates WebSocket authentication token from URL query parameters
+     * @param url - The WebSocket connection URL
+     * @returns Authentication result with userId and payload, or null if no token provided
+     * @throws Error if authentication fails
+     */
+    validateAuth(url: string): Promise<WebSocketAuthResult | null>;
+}
+//# sourceMappingURL=websocket-auth.d.ts.map

package/dist/websocket/websocket-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-auth.d.ts","sourceRoot":"","sources":["../../src/websocket/websocket-auth.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAExF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,oBAAoB;IAEpE;;;;;OAKG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;CAmCrE"}

package/dist/websocket/websocket-auth.js

@@ -0,0 +1,46 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { URL } from "url";
+import Jwt from "../auth/jwt.js";
+class WebSocketAuthService {
+  constructor(applicationConfig) {
+    this.applicationConfig = applicationConfig;
+  }
+  static {
+    __name(this, "WebSocketAuthService");
+  }
+  /**
+   * Validates WebSocket authentication token from URL query parameters
+   * @param url - The WebSocket connection URL
+   * @returns Authentication result with userId and payload, or null if no token provided
+   * @throws Error if authentication fails
+   */
+  async validateAuth(url) {
+    try {
+      const parsedUrl = new URL(url, "ws://localhost");
+      const token = parsedUrl.searchParams.get("token");
+      if (!token) {
+        return null;
+      }
+      const jwtSecretKey = this.applicationConfig.auth?.jwtSecretKey;
+      if (!jwtSecretKey) {
+        throw new Error("JWT secret key not configured");
+      }
+      const importedJwtSecretKey = await Jwt.importJwtSecretKey({
+        jwtSecretKey
+      });
+      const { payload } = await Jwt.jwtVerify(token, importedJwtSecretKey);
+      const userId = parseInt(payload.sub);
+      if (isNaN(userId)) {
+        throw new Error("Invalid user ID in token");
+      }
+      return { userId, payload };
+    } catch (error) {
+      throw new Error(`JWT verification failed: ${error.message}`);
+    }
+  }
+}
+export {
+  WebSocketAuthService
+};
+//# sourceMappingURL=websocket-auth.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/websocket/websocket-auth.ts"],
+  "sourcesContent": ["import { URL } from 'url';\nimport Jwt from '../auth/jwt.js';\nimport type { WebApplicationConfig } from '../application/web-application.interface.js';\n\nexport interface WebSocketAuthResult {\n  userId: number;\n  payload: Record<string, unknown>;\n}\n\nexport class WebSocketAuthService {\n  constructor(private readonly applicationConfig: WebApplicationConfig) {}\n\n  /**\n   * Validates WebSocket authentication token from URL query parameters\n   * @param url - The WebSocket connection URL\n   * @returns Authentication result with userId and payload, or null if no token provided\n   * @throws Error if authentication fails\n   */\n  async validateAuth(url: string): Promise<WebSocketAuthResult | null> {\n    try {\n      const parsedUrl = new URL(url, 'ws://localhost');\n      const token = parsedUrl.searchParams.get('token');\n\n      if (!token) {\n        return null; // No token provided, allow unauthenticated connection\n      }\n\n      // Get JWT secret key from application config\n      const jwtSecretKey = this.applicationConfig.auth?.jwtSecretKey;\n\n      if (!jwtSecretKey) {\n        throw new Error('JWT secret key not configured');\n      }\n\n      // Import JWT secret key\n      const importedJwtSecretKey = await Jwt.importJwtSecretKey({\n        jwtSecretKey,\n      });\n\n      // Verify JWT token\n      const { payload } = await Jwt.jwtVerify(token, importedJwtSecretKey);\n\n      const userId = parseInt(payload.sub as string);\n\n      if (isNaN(userId)) {\n        throw new Error('Invalid user ID in token');\n      }\n\n      return { userId, payload };\n    } catch (error: any) {\n      throw new Error(`JWT verification failed: ${error.message}`);\n    }\n  }\n}\n"],
+  "mappings": ";;AAAA,SAAS,WAAW;AACpB,OAAO,SAAS;AAQT,MAAM,qBAAqB;AAAA,EAChC,YAA6B,mBAAyC;AAAzC;AAAA,EAA0C;AAAA,EAVzE,OASkC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAShC,MAAM,aAAa,KAAkD;AACnE,QAAI;AACF,YAAM,YAAY,IAAI,IAAI,KAAK,gBAAgB;AAC/C,YAAM,QAAQ,UAAU,aAAa,IAAI,OAAO;AAEhD,UAAI,CAAC,OAAO;AACV,eAAO;AAAA,MACT;AAGA,YAAM,eAAe,KAAK,kBAAkB,MAAM;AAElD,UAAI,CAAC,cAAc;AACjB,cAAM,IAAI,MAAM,+BAA+B;AAAA,MACjD;AAGA,YAAM,uBAAuB,MAAM,IAAI,mBAAmB;AAAA,QACxD;AAAA,MACF,CAAC;AAGD,YAAM,EAAE,QAAQ,IAAI,MAAM,IAAI,UAAU,OAAO,oBAAoB;AAEnE,YAAM,SAAS,SAAS,QAAQ,GAAa;AAE7C,UAAI,MAAM,MAAM,GAAG;AACjB,cAAM,IAAI,MAAM,0BAA0B;AAAA,MAC5C;AAEA,aAAO,EAAE,QAAQ,QAAQ;AAAA,IAC3B,SAAS,OAAY;AACnB,YAAM,IAAI,MAAM,4BAA4B,MAAM,OAAO,EAAE;AAAA,IAC7D;AAAA,EACF;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,19 @@
+import type { WebSocketMessageHandler, WebSocketRoute, WebSocketType } from './websocket.interface.js';
+import type WebSocket from 'ws';
+export default abstract class WebSocketBase {
+    protected routes: WebSocketRoute[];
+    protected routeHandlers: Map<string, WebSocketMessageHandler>;
+    protected defaultRoutes: WebSocketRoute[];
+    abstract get type(): WebSocketType;
+    protected abstract getControllerDependencies(): Record<string, unknown>;
+    protected abstract shouldPrintRoutes(): boolean;
+    protected abstract handleMessageError(clientId: string, error: string): void;
+    protected configureRoutes(routes: WebSocketRoute[], controllersDirectory: string): Promise<void>;
+    protected handleServerMessage(ws: WebSocket, message: WebSocket.Data, clientId: string): Promise<{
+        type: unknown;
+        action: unknown;
+        response: unknown;
+    } | void>;
+    protected printRoutes(): void;
+}
+//# sourceMappingURL=websocket-base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-base.d.ts","sourceRoot":"","sources":["../../src/websocket/websocket-base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAIvG,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AAGhC,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,aAAa;IACzC,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,CAAM;IACxC,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAa;IAE1E,SAAS,CAAC,aAAa,EAAE,cAAc,EAAE,CAAM;IAE/C,aAAoB,IAAI,IAAI,aAAa,CAAC;IAE1C,SAAS,CAAC,QAAQ,CAAC,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvE,SAAS,CAAC,QAAQ,CAAC,iBAAiB,IAAI,OAAO;IAC/C,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;cAE5D,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAwEtF,mBAAmB,CACjC,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,SAAS,CAAC,IAAI,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAuDxE,SAAS,CAAC,WAAW,IAAI,IAAI;CAiB9B"}

package/dist/websocket/websocket-client-manager.d.ts

@@ -0,0 +1,53 @@
+import WebSocket from 'ws';
+import type { WebSocketClientData } from './websocket-client-manager.interface.js';
+export default class WebSocketClientManager {
+    private clients;
+    addClient({ clientId, ws, lastActivity, user, }: {
+        clientId: string;
+        ws: WebSocket | null;
+        lastActivity: number;
+        user?: {
+            userId: number;
+            payload: any;
+        } | null;
+    }): void;
+    getClientId({ ws }: {
+        ws: WebSocket;
+    }): string | undefined;
+    getClient({ clientId, requireWs, }: {
+        clientId: string;
+        requireWs?: boolean;
+    }): WebSocketClientData | undefined;
+    updateClient({ clientId, key, data, broadcastClientList, }: {
+        clientId: string;
+        key: string;
+        data: any;
+        broadcastClientList?: boolean;
+    }): void;
+    removeClient(clientId: string): void;
+    getClientList(): {
+        [key: string]: any;
+        clientId: string;
+    }[];
+    getClientByKey({ key, value, requireWs, userType, }: {
+        key: string;
+        value: string;
+        requireWs?: boolean;
+        userType?: string;
+    }): {
+        ws: WebSocket | null;
+        lastActivity: number;
+        roomName?: string;
+        clientId: string;
+    } | undefined;
+    getClients({ userType }?: {
+        userType?: string;
+    }): WebSocketClientData[];
+    disconnectClient({ clientId }: {
+        clientId: string;
+    }): void;
+    printClients(): void;
+    broadcastClientList(type: string): void;
+    cleanup(): void;
+}
+//# sourceMappingURL=websocket-client-manager.d.ts.map

package/dist/websocket/websocket-client-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-client-manager.d.ts","sourceRoot":"","sources":["../../src/websocket/websocket-client-manager.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAKnF,MAAM,CAAC,OAAO,OAAO,sBAAsB;IACzC,OAAO,CAAC,OAAO,CAA+C;IAEvD,SAAS,CAAC,EACf,QAAQ,EACR,EAAE,EACF,YAAY,EACZ,IAAI,GACL,EAAE;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,SAAS,GAAG,IAAI,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,GAAG,CAAA;SAAE,GAAG,IAAI,CAAC;KAChD;IAiBM,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE;QAAE,EAAE,EAAE,SAAS,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS;IAI1D,SAAS,CAAC,EACf,QAAQ,EACR,SAAS,GACV,EAAE;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,mBAAmB,GAAG,SAAS;IAU5B,YAAY,CAAC,EAClB,QAAQ,EACR,GAAG,EACH,IAAI,EACJ,mBAAmB,GACpB,EAAE;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,GAAG,CAAC;QACV,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B;IA2CM,YAAY,CAAC,QAAQ,EAAE,MAAM;IAsB7B,aAAa;;kBAEN,MAAM;;IAcb,cAAc,CAAC,EACpB,GAAG,EACH,KAAK,EACL,SAAS,EACT,QAAQ,GACT,EAAE;QACD,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;;;;;;IA6BM,UAAU,CAAC,EAAE,QAAQ,EAAE,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;IAgBnD,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;IAwBnD,YAAY;IAwBZ,mBAAmB,CAAC,IAAI,EAAE,MAAM;IA0BhC,OAAO,IAAI,IAAI;CAsBvB"}

package/dist/websocket/websocket-client-manager.interface.d.ts

@@ -0,0 +1,8 @@
+import type WebSocket from 'ws';
+export interface WebSocketClientData {
+    ws: WebSocket | null;
+    lastActivity: number;
+    roomName?: string;
+    [key: string]: any;
+}
+//# sourceMappingURL=websocket-client-manager.interface.d.ts.map

package/dist/websocket/websocket-client-manager.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-client-manager.interface.d.ts","sourceRoot":"","sources":["../../src/websocket/websocket-client-manager.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AAEhC,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,SAAS,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/websocket/websocket-client-manager.js

@@ -4,6 +4,7 @@ import WebSocket from "ws";
 import { log } from "./utils.js";
 import { Helper, Time } from "../util/index.js";
 import cluster from "cluster";
+import { safeSerializeError } from "../error/error-reporter.js";
 class WebSocketClientManager {
   static {
     __name(this, "WebSocketClientManager");
@@ -51,7 +52,7 @@ class WebSocketClientManager {
       return;
     }
     if (key === "__proto__" || key === "constructor" || key === "prototype") {
-      console.warn(`Blocked attempt to modify dangerous property: ${key}`);
+      log("Blocked attempt to modify dangerous property", { Property: key });
       return;
     }
     const allowedClientProperties = [
@@ -67,7 +68,7 @@ class WebSocketClientManager {
       "permissions"
     ];
     if (!allowedClientProperties.includes(key)) {
-      console.warn(`Blocked attempt to modify unauthorized property: ${key}`);
+      log("Blocked attempt to modify unauthorized property", { Property: key });
       return;
     }
     Reflect.set(client, key, data);
@@ -87,7 +88,7 @@ class WebSocketClientManager {
         }
       } catch (error) {
         log("Error cleaning up WebSocket connection", {
-          error: error instanceof Error ? error.message : String(error)
+          error: error instanceof Error ? error.message : safeSerializeError(error)
         });
       }
     }
@@ -194,7 +195,7 @@ class WebSocketClientManager {
         );
       } catch (error) {
         log("Error broadcasting client list", {
-          error: error instanceof Error ? error.message : String(error)
+          error: error instanceof Error ? error.message : safeSerializeError(error)
         });
       }
     });
@@ -210,7 +211,7 @@ class WebSocketClientManager {
         } catch (error) {
           log("Error cleaning up client connection", {
             clientId,
-            error: error instanceof Error ? error.message : String(error)
+            error: error instanceof Error ? error.message : safeSerializeError(error)
           });
         }
       }

package/dist/websocket/websocket-client-manager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/websocket/websocket-client-manager.ts"],
-  "sourcesContent": ["import WebSocket from 'ws';\nimport { log } from './utils.js';\nimport type { WebSocketClientData } from './websocket-client-manager.interface.js';\nimport { Helper, Time } from '../util/index.js';\nimport cluster from 'cluster';\n\nexport default class WebSocketClientManager {\n  private clients: Map<string, WebSocketClientData> = new Map();\n\n  public addClient({\n    clientId,\n    ws,\n    lastActivity,\n    user,\n  }: {\n    clientId: string;\n    ws: WebSocket | null;\n    lastActivity: number;\n    user?: { userId: number; payload: any } | null;\n  }) {\n    this.clients.set(clientId, {\n      ws,\n      lastActivity,\n      user,\n    });\n\n    this.broadcastClientList('addClient');\n\n    log('Client connected', {\n      ID: clientId,\n      UserId: user?.userId ?? 'unauthenticated',\n    });\n\n    this.printClients();\n  }\n\n  public getClientId({ ws }: { ws: WebSocket }): string | undefined {\n    return [...this.clients.entries()].find(([_, value]) => value.ws === ws)?.[0];\n  }\n\n  public getClient({\n    clientId,\n    requireWs,\n  }: {\n    clientId: string;\n    requireWs?: boolean;\n  }): WebSocketClientData | undefined {\n    const client = this.clients.get(clientId);\n\n    if (requireWs && !client?.ws) {\n      return undefined;\n    }\n\n    return client;\n  }\n\n  public updateClient({\n    clientId,\n    key,\n    data,\n    broadcastClientList,\n  }: {\n    clientId: string;\n    key: string;\n    data: any;\n    broadcastClientList?: boolean;\n  }) {\n    const client = this.clients.get(clientId);\n\n    if (!client) {\n      return;\n    }\n\n    // Prevent prototype pollution attacks\n    if (key === '__proto__' || key === 'constructor' || key === 'prototype') {\n      console.warn(`Blocked attempt to modify dangerous property: ${key}`);\n      return;\n    }\n\n    // Define allowed client properties to prevent unauthorized modifications\n    const allowedClientProperties = [\n      'id',\n      'ws',\n      'room',\n      'userId',\n      'username',\n      'metadata',\n      'connectedAt',\n      'lastActivity',\n      'status',\n      'permissions',\n    ];\n\n    if (!allowedClientProperties.includes(key)) {\n      console.warn(`Blocked attempt to modify unauthorized property: ${key}`);\n      return;\n    }\n\n    Reflect.set(client, key, data);\n\n    this.clients.set(clientId, client);\n\n    if (broadcastClientList !== false) {\n      this.broadcastClientList('updateClient');\n    }\n\n    this.printClients();\n  }\n\n  public removeClient(clientId: string) {\n    const client = this.clients.get(clientId);\n\n    // Clean up WebSocket connection if it exists\n    if (client?.ws) {\n      try {\n        client.ws.removeAllListeners();\n        if (client.ws.readyState === WebSocket.OPEN) {\n          client.ws.close();\n        }\n      } catch (error) {\n        log('Error cleaning up WebSocket connection', {\n          error: error instanceof Error ? error.message : String(error),\n        });\n      }\n    }\n\n    this.clients.delete(clientId);\n    this.broadcastClientList('removeClient');\n    this.printClients();\n  }\n\n  public getClientList() {\n    const clientList: {\n      clientId: string;\n      [key: string]: any;\n    }[] = [];\n\n    this.clients.forEach((clientData, clientId) => {\n      clientList.push({\n        clientId,\n        ...clientData,\n      });\n    });\n\n    return clientList;\n  }\n\n  public getClientByKey({\n    key,\n    value,\n    requireWs,\n    userType,\n  }: {\n    key: string;\n    value: string;\n    requireWs?: boolean;\n    userType?: string;\n  }) {\n    const clients = [...this.clients.entries()];\n\n    const client = clients.find(([_, clientData]) => {\n      const deepKeyValue = Helper.getValueFromObject(clientData, key);\n\n      const isValueMatching = deepKeyValue === value;\n\n      if (userType && clientData.user?.userType !== userType) {\n        return false;\n      }\n\n      return isValueMatching;\n    });\n\n    const formattedClient = client\n      ? {\n          clientId: client[0],\n          ...client[1],\n        }\n      : undefined;\n\n    if (requireWs && !formattedClient?.ws) {\n      return undefined;\n    }\n\n    return formattedClient;\n  }\n\n  public getClients({ userType }: { userType?: string } = {}) {\n    const clients: WebSocketClientData[] = [];\n\n    this.clients.forEach((clientData, clientId) => {\n      if (userType && clientData.user?.userType !== userType) {\n        return;\n      }\n\n      clientData.clientId = clientId;\n\n      clients.push(clientData);\n    });\n\n    return clients;\n  }\n\n  public disconnectClient({ clientId }: { clientId: string }) {\n    const clientInfo = this.clients.get(clientId);\n\n    if (clientInfo?.ws) {\n      const connectedTime = Date.now() - clientInfo.lastActivity;\n\n      clientInfo.ws.close();\n\n      log('WebSocket client was disconnected due to inactivity', {\n        ID: clientId,\n        'Time Connected': Time.formatTime({\n          time: connectedTime,\n          format: 's',\n        }),\n      });\n    }\n\n    this.removeClient(clientId);\n\n    log('Client disconnected', { ID: clientId });\n\n    this.printClients();\n  }\n\n  public printClients() {\n    const numClients = this.clients.size;\n\n    const workerId = cluster.isWorker && cluster.worker ? cluster.worker.id : null;\n\n    let logOutput = '\\n-------------------------------------------------------\\n';\n    logOutput += `Connected clients (Count: ${numClients}${workerId ? ` | Worker: ${workerId}` : ''}):\\n`;\n    logOutput += '-------------------------------------------------------\\n';\n\n    if (numClients > 0) {\n      this.clients.forEach((client, clientId) => {\n        logOutput += `ID: ${clientId} | Username: ${client?.user?.username ?? '-'} | User Type: ${client?.user?.userType ?? '-'} | Email: ${client.user?.email ?? '-'}\\n`;\n      });\n    } else {\n      logOutput += 'No clients';\n    }\n\n    logOutput += '\\n';\n\n    log(logOutput, undefined, {\n      muteWorker: true,\n    });\n  }\n\n  public broadcastClientList(type: string) {\n    const clientList = this.getClientList();\n\n    this.clients.forEach(({ ws }) => {\n      if (!ws || ws.readyState !== WebSocket.OPEN) {\n        return;\n      }\n\n      try {\n        ws.send(\n          JSON.stringify({\n            type: 'system',\n            action: 'clientList',\n            clientListType: type,\n            data: clientList,\n          }),\n        );\n      } catch (error) {\n        // Handle send errors (e.g., connection closed)\n        log('Error broadcasting client list', {\n          error: error instanceof Error ? error.message : String(error),\n        });\n      }\n    });\n  }\n\n  public cleanup(): void {\n    // Clean up all client connections\n    this.clients.forEach((client, clientId) => {\n      if (client.ws) {\n        try {\n          client.ws.removeAllListeners();\n          if (client.ws.readyState === WebSocket.OPEN) {\n            client.ws.close();\n          }\n        } catch (error) {\n          log('Error cleaning up client connection', {\n            clientId,\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n      }\n    });\n\n    // Clear all clients\n    this.clients.clear();\n    log('WebSocket client manager cleaned up');\n  }\n}\n"],
-  "mappings": ";;AAAA,OAAO,eAAe;AACtB,SAAS,WAAW;AAEpB,SAAS,QAAQ,YAAY;AAC7B,OAAO,aAAa;AAEpB,MAAO,uBAAqC;AAAA,EAN5C,OAM4C;AAAA;AAAA;AAAA,EAClC,UAA4C,oBAAI,IAAI;AAAA,EAErD,UAAU;AAAA,IACf;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAKG;AACD,SAAK,QAAQ,IAAI,UAAU;AAAA,MACzB;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,SAAK,oBAAoB,WAAW;AAEpC,QAAI,oBAAoB;AAAA,MACtB,IAAI;AAAA,MACJ,QAAQ,MAAM,UAAU;AAAA,IAC1B,CAAC;AAED,SAAK,aAAa;AAAA,EACpB;AAAA,EAEO,YAAY,EAAE,GAAG,GAA0C;AAChE,WAAO,CAAC,GAAG,KAAK,QAAQ,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,KAAK,MAAM,MAAM,OAAO,EAAE,IAAI,CAAC;AAAA,EAC9E;AAAA,EAEO,UAAU;AAAA,IACf;AAAA,IACA;AAAA,EACF,GAGoC;AAClC,UAAM,SAAS,KAAK,QAAQ,IAAI,QAAQ;AAExC,QAAI,aAAa,CAAC,QAAQ,IAAI;AAC5B,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAAA,EAEO,aAAa;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAKG;AACD,UAAM,SAAS,KAAK,QAAQ,IAAI,QAAQ;AAExC,QAAI,CAAC,QAAQ;AACX;AAAA,IACF;AAGA,QAAI,QAAQ,eAAe,QAAQ,iBAAiB,QAAQ,aAAa;AACvE,cAAQ,KAAK,iDAAiD,GAAG,EAAE;AACnE;AAAA,IACF;AAGA,UAAM,0BAA0B;AAAA,MAC9B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAEA,QAAI,CAAC,wBAAwB,SAAS,GAAG,GAAG;AAC1C,cAAQ,KAAK,oDAAoD,GAAG,EAAE;AACtE;AAAA,IACF;AAEA,YAAQ,IAAI,QAAQ,KAAK,IAAI;AAE7B,SAAK,QAAQ,IAAI,UAAU,MAAM;AAEjC,QAAI,wBAAwB,OAAO;AACjC,WAAK,oBAAoB,cAAc;AAAA,IACzC;AAEA,SAAK,aAAa;AAAA,EACpB;AAAA,EAEO,aAAa,UAAkB;AACpC,UAAM,SAAS,KAAK,QAAQ,IAAI,QAAQ;AAGxC,QAAI,QAAQ,IAAI;AACd,UAAI;AACF,eAAO,GAAG,mBAAmB;AAC7B,YAAI,OAAO,GAAG,eAAe,UAAU,MAAM;AAC3C,iBAAO,GAAG,MAAM;AAAA,QAClB;AAAA,MACF,SAAS,OAAO;AACd,YAAI,0CAA0C;AAAA,UAC5C,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,QAC9D,CAAC;AAAA,MACH;AAAA,IACF;AAEA,SAAK,QAAQ,OAAO,QAAQ;AAC5B,SAAK,oBAAoB,cAAc;AACvC,SAAK,aAAa;AAAA,EACpB;AAAA,EAEO,gBAAgB;AACrB,UAAM,aAGA,CAAC;AAEP,SAAK,QAAQ,QAAQ,CAAC,YAAY,aAAa;AAC7C,iBAAW,KAAK;AAAA,QACd;AAAA,QACA,GAAG;AAAA,MACL,CAAC;AAAA,IACH,CAAC;AAED,WAAO;AAAA,EACT;AAAA,EAEO,eAAe;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAKG;AACD,UAAM,UAAU,CAAC,GAAG,KAAK,QAAQ,QAAQ,CAAC;AAE1C,UAAM,SAAS,QAAQ,KAAK,CAAC,CAAC,GAAG,UAAU,MAAM;AAC/C,YAAM,eAAe,OAAO,mBAAmB,YAAY,GAAG;AAE9D,YAAM,kBAAkB,iBAAiB;AAEzC,UAAI,YAAY,WAAW,MAAM,aAAa,UAAU;AACtD,eAAO;AAAA,MACT;AAEA,aAAO;AAAA,IACT,CAAC;AAED,UAAM,kBAAkB,SACpB;AAAA,MACE,UAAU,OAAO,CAAC;AAAA,MAClB,GAAG,OAAO,CAAC;AAAA,IACb,IACA;AAEJ,QAAI,aAAa,CAAC,iBAAiB,IAAI;AACrC,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAAA,EAEO,WAAW,EAAE,SAAS,IAA2B,CAAC,GAAG;AAC1D,UAAM,UAAiC,CAAC;AAExC,SAAK,QAAQ,QAAQ,CAAC,YAAY,aAAa;AAC7C,UAAI,YAAY,WAAW,MAAM,aAAa,UAAU;AACtD;AAAA,MACF;AAEA,iBAAW,WAAW;AAEtB,cAAQ,KAAK,UAAU;AAAA,IACzB,CAAC;AAED,WAAO;AAAA,EACT;AAAA,EAEO,iBAAiB,EAAE,SAAS,GAAyB;AAC1D,UAAM,aAAa,KAAK,QAAQ,IAAI,QAAQ;AAE5C,QAAI,YAAY,IAAI;AAClB,YAAM,gBAAgB,KAAK,IAAI,IAAI,WAAW;AAE9C,iBAAW,GAAG,MAAM;AAEpB,UAAI,uDAAuD;AAAA,QACzD,IAAI;AAAA,QACJ,kBAAkB,KAAK,WAAW;AAAA,UAChC,MAAM;AAAA,UACN,QAAQ;AAAA,QACV,CAAC;AAAA,MACH,CAAC;AAAA,IACH;AAEA,SAAK,aAAa,QAAQ;AAE1B,QAAI,uBAAuB,EAAE,IAAI,SAAS,CAAC;AAE3C,SAAK,aAAa;AAAA,EACpB;AAAA,EAEO,eAAe;AACpB,UAAM,aAAa,KAAK,QAAQ;AAEhC,UAAM,WAAW,QAAQ,YAAY,QAAQ,SAAS,QAAQ,OAAO,KAAK;AAE1E,QAAI,YAAY;AAChB,iBAAa,6BAA6B,UAAU,GAAG,WAAW,cAAc,QAAQ,KAAK,EAAE;AAAA;AAC/F,iBAAa;AAEb,QAAI,aAAa,GAAG;AAClB,WAAK,QAAQ,QAAQ,CAAC,QAAQ,aAAa;AACzC,qBAAa,OAAO,QAAQ,gBAAgB,QAAQ,MAAM,YAAY,GAAG,iBAAiB,QAAQ,MAAM,YAAY,GAAG,aAAa,OAAO,MAAM,SAAS,GAAG;AAAA;AAAA,MAC/J,CAAC;AAAA,IACH,OAAO;AACL,mBAAa;AAAA,IACf;AAEA,iBAAa;AAEb,QAAI,WAAW,QAAW;AAAA,MACxB,YAAY;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAEO,oBAAoB,MAAc;AACvC,UAAM,aAAa,KAAK,cAAc;AAEtC,SAAK,QAAQ,QAAQ,CAAC,EAAE,GAAG,MAAM;AAC/B,UAAI,CAAC,MAAM,GAAG,eAAe,UAAU,MAAM;AAC3C;AAAA,MACF;AAEA,UAAI;AACF,WAAG;AAAA,UACD,KAAK,UAAU;AAAA,YACb,MAAM;AAAA,YACN,QAAQ;AAAA,YACR,gBAAgB;AAAA,YAChB,MAAM;AAAA,UACR,CAAC;AAAA,QACH;AAAA,MACF,SAAS,OAAO;AAEd,YAAI,kCAAkC;AAAA,UACpC,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,QAC9D,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEO,UAAgB;AAErB,SAAK,QAAQ,QAAQ,CAAC,QAAQ,aAAa;AACzC,UAAI,OAAO,IAAI;AACb,YAAI;AACF,iBAAO,GAAG,mBAAmB;AAC7B,cAAI,OAAO,GAAG,eAAe,UAAU,MAAM;AAC3C,mBAAO,GAAG,MAAM;AAAA,UAClB;AAAA,QACF,SAAS,OAAO;AACd,cAAI,uCAAuC;AAAA,YACzC;AAAA,YACA,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,UAC9D,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF,CAAC;AAGD,SAAK,QAAQ,MAAM;AACnB,QAAI,qCAAqC;AAAA,EAC3C;AACF;",
+  "sourcesContent": ["import WebSocket from 'ws';\nimport { log } from './utils.js';\nimport type { WebSocketClientData } from './websocket-client-manager.interface.js';\nimport { Helper, Time } from '../util/index.js';\nimport cluster from 'cluster';\nimport { safeSerializeError } from '../error/error-reporter.js';\n\nexport default class WebSocketClientManager {\n  private clients: Map<string, WebSocketClientData> = new Map();\n\n  public addClient({\n    clientId,\n    ws,\n    lastActivity,\n    user,\n  }: {\n    clientId: string;\n    ws: WebSocket | null;\n    lastActivity: number;\n    user?: { userId: number; payload: any } | null;\n  }) {\n    this.clients.set(clientId, {\n      ws,\n      lastActivity,\n      user,\n    });\n\n    this.broadcastClientList('addClient');\n\n    log('Client connected', {\n      ID: clientId,\n      UserId: user?.userId ?? 'unauthenticated',\n    });\n\n    this.printClients();\n  }\n\n  public getClientId({ ws }: { ws: WebSocket }): string | undefined {\n    return [...this.clients.entries()].find(([_, value]) => value.ws === ws)?.[0];\n  }\n\n  public getClient({\n    clientId,\n    requireWs,\n  }: {\n    clientId: string;\n    requireWs?: boolean;\n  }): WebSocketClientData | undefined {\n    const client = this.clients.get(clientId);\n\n    if (requireWs && !client?.ws) {\n      return undefined;\n    }\n\n    return client;\n  }\n\n  public updateClient({\n    clientId,\n    key,\n    data,\n    broadcastClientList,\n  }: {\n    clientId: string;\n    key: string;\n    data: any;\n    broadcastClientList?: boolean;\n  }) {\n    const client = this.clients.get(clientId);\n\n    if (!client) {\n      return;\n    }\n\n    // Prevent prototype pollution attacks\n    if (key === '__proto__' || key === 'constructor' || key === 'prototype') {\n      log('Blocked attempt to modify dangerous property', { Property: key });\n      return;\n    }\n\n    // Define allowed client properties to prevent unauthorized modifications\n    const allowedClientProperties = [\n      'id',\n      'ws',\n      'room',\n      'userId',\n      'username',\n      'metadata',\n      'connectedAt',\n      'lastActivity',\n      'status',\n      'permissions',\n    ];\n\n    if (!allowedClientProperties.includes(key)) {\n      log('Blocked attempt to modify unauthorized property', { Property: key });\n      return;\n    }\n\n    Reflect.set(client, key, data);\n\n    this.clients.set(clientId, client);\n\n    if (broadcastClientList !== false) {\n      this.broadcastClientList('updateClient');\n    }\n\n    this.printClients();\n  }\n\n  public removeClient(clientId: string) {\n    const client = this.clients.get(clientId);\n\n    // Clean up WebSocket connection if it exists\n    if (client?.ws) {\n      try {\n        client.ws.removeAllListeners();\n        if (client.ws.readyState === WebSocket.OPEN) {\n          client.ws.close();\n        }\n      } catch (error) {\n        log('Error cleaning up WebSocket connection', {\n          error: error instanceof Error ? error.message : safeSerializeError(error),\n        });\n      }\n    }\n\n    this.clients.delete(clientId);\n    this.broadcastClientList('removeClient');\n    this.printClients();\n  }\n\n  public getClientList() {\n    const clientList: {\n      clientId: string;\n      [key: string]: any;\n    }[] = [];\n\n    this.clients.forEach((clientData, clientId) => {\n      clientList.push({\n        clientId,\n        ...clientData,\n      });\n    });\n\n    return clientList;\n  }\n\n  public getClientByKey({\n    key,\n    value,\n    requireWs,\n    userType,\n  }: {\n    key: string;\n    value: string;\n    requireWs?: boolean;\n    userType?: string;\n  }) {\n    const clients = [...this.clients.entries()];\n\n    const client = clients.find(([_, clientData]) => {\n      const deepKeyValue = Helper.getValueFromObject(clientData, key);\n\n      const isValueMatching = deepKeyValue === value;\n\n      if (userType && clientData.user?.userType !== userType) {\n        return false;\n      }\n\n      return isValueMatching;\n    });\n\n    const formattedClient = client\n      ? {\n          clientId: client[0],\n          ...client[1],\n        }\n      : undefined;\n\n    if (requireWs && !formattedClient?.ws) {\n      return undefined;\n    }\n\n    return formattedClient;\n  }\n\n  public getClients({ userType }: { userType?: string } = {}) {\n    const clients: WebSocketClientData[] = [];\n\n    this.clients.forEach((clientData, clientId) => {\n      if (userType && clientData.user?.userType !== userType) {\n        return;\n      }\n\n      clientData.clientId = clientId;\n\n      clients.push(clientData);\n    });\n\n    return clients;\n  }\n\n  public disconnectClient({ clientId }: { clientId: string }) {\n    const clientInfo = this.clients.get(clientId);\n\n    if (clientInfo?.ws) {\n      const connectedTime = Date.now() - clientInfo.lastActivity;\n\n      clientInfo.ws.close();\n\n      log('WebSocket client was disconnected due to inactivity', {\n        ID: clientId,\n        'Time Connected': Time.formatTime({\n          time: connectedTime,\n          format: 's',\n        }),\n      });\n    }\n\n    this.removeClient(clientId);\n\n    log('Client disconnected', { ID: clientId });\n\n    this.printClients();\n  }\n\n  public printClients() {\n    const numClients = this.clients.size;\n\n    const workerId = cluster.isWorker && cluster.worker ? cluster.worker.id : null;\n\n    let logOutput = '\\n-------------------------------------------------------\\n';\n    logOutput += `Connected clients (Count: ${numClients}${workerId ? ` | Worker: ${workerId}` : ''}):\\n`;\n    logOutput += '-------------------------------------------------------\\n';\n\n    if (numClients > 0) {\n      this.clients.forEach((client, clientId) => {\n        logOutput += `ID: ${clientId} | Username: ${client?.user?.username ?? '-'} | User Type: ${client?.user?.userType ?? '-'} | Email: ${client.user?.email ?? '-'}\\n`;\n      });\n    } else {\n      logOutput += 'No clients';\n    }\n\n    logOutput += '\\n';\n\n    log(logOutput, undefined, {\n      muteWorker: true,\n    });\n  }\n\n  public broadcastClientList(type: string) {\n    const clientList = this.getClientList();\n\n    this.clients.forEach(({ ws }) => {\n      if (!ws || ws.readyState !== WebSocket.OPEN) {\n        return;\n      }\n\n      try {\n        ws.send(\n          JSON.stringify({\n            type: 'system',\n            action: 'clientList',\n            clientListType: type,\n            data: clientList,\n          }),\n        );\n      } catch (error) {\n        // Handle send errors (e.g., connection closed)\n        log('Error broadcasting client list', {\n          error: error instanceof Error ? error.message : safeSerializeError(error),\n        });\n      }\n    });\n  }\n\n  public cleanup(): void {\n    // Clean up all client connections\n    this.clients.forEach((client, clientId) => {\n      if (client.ws) {\n        try {\n          client.ws.removeAllListeners();\n          if (client.ws.readyState === WebSocket.OPEN) {\n            client.ws.close();\n          }\n        } catch (error) {\n          log('Error cleaning up client connection', {\n            clientId,\n            error: error instanceof Error ? error.message : safeSerializeError(error),\n          });\n        }\n      }\n    });\n\n    // Clear all clients\n    this.clients.clear();\n    log('WebSocket client manager cleaned up');\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/websocket/websocket-client.d.ts

@@ -0,0 +1,64 @@
+import type { WebSocketRoute, WebSocketType } from './websocket.interface.js';
+import type RedisInstance from '../redis/instance.js';
+import type QueueManager from '../queue/manager.js';
+import type DatabaseInstance from '../database/instance.js';
+import type { WebSocketClientProps } from './websocket-client.interface.js';
+import WebSocketBase from './websocket-base.js';
+export default class WebSocketClient extends WebSocketBase {
+    protected defaultRoutes: WebSocketRoute[];
+    private applicationConfig;
+    private options;
+    private redisInstance;
+    private queueManager;
+    private databaseInstance;
+    private ws?;
+    private clientId?;
+    private isConnected;
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    private reconnectDelay;
+    private reconnectTimer?;
+    private shouldReconnect;
+    constructor(props: WebSocketClientProps);
+    get type(): WebSocketType;
+    load(): Promise<void>;
+    connectToServer(): Promise<void>;
+    protected getControllerDependencies(): {
+        sendMessage: (data: unknown) => void;
+        redisInstance: RedisInstance;
+        queueManager: QueueManager;
+        databaseInstance: DatabaseInstance;
+    };
+    protected shouldPrintRoutes(): boolean;
+    private handleIncomingMessage;
+    protected handleMessageError(clientId: string, error: string): void;
+    sendClientMessage: (data: unknown, binary?: boolean) => void;
+    sendMessage: (data: unknown) => void;
+    disconnect(): void;
+    isClientConnected(): boolean;
+    /**
+     * Schedule a reconnection attempt with exponential backoff
+     */
+    private scheduleReconnect;
+    /**
+     * Attempt to reconnect to the server
+     */
+    private attemptReconnect;
+    /**
+     * Enable auto-reconnection
+     */
+    enableAutoReconnect(): void;
+    /**
+     * Disable auto-reconnection
+     */
+    disableAutoReconnect(): void;
+    /**
+     * Get connection status
+     */
+    getConnectionStatus(): {
+        isConnected: boolean;
+        reconnectAttempts: number;
+        autoReconnectEnabled: boolean;
+    };
+}
+//# sourceMappingURL=websocket-client.d.ts.map

package/dist/websocket/websocket-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-client.d.ts","sourceRoot":"","sources":["../../src/websocket/websocket-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAMhD,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,aAAa;IACxD,SAAS,CAAC,aAAa,EAAE,cAAc,EAAE,CAMvC;IAEF,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,EAAE,CAAC,CAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,oBAAoB,CAAc;IAC1C,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,eAAe,CAAiB;gBAE5B,KAAK,EAAE,oBAAoB;IAWvC,IAAW,IAAI,IAAI,aAAa,CAE/B;IAEY,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IA+E7C,SAAS,CAAC,yBAAyB,IAAI;QACrC,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;QACrC,aAAa,EAAE,aAAa,CAAC;QAC7B,YAAY,EAAE,YAAY,CAAC;QAC3B,gBAAgB,EAAE,gBAAgB,CAAC;KACpC;IAQD,SAAS,CAAC,iBAAiB,IAAI,OAAO;IAItC,OAAO,CAAC,qBAAqB,CAqB3B;IAEF,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5D,iBAAiB,GAAI,MAAM,OAAO,EAAE,SAAQ,OAAe,KAAG,IAAI,CAUvE;IAEK,WAAW,GAAI,MAAM,OAAO,KAAG,IAAI,CAExC;IAEK,UAAU,IAAI,IAAI;IAoBlB,iBAAiB,IAAI,OAAO;IAInC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;OAEG;YACW,gBAAgB;IA4B9B;;OAEG;IACI,mBAAmB,IAAI,IAAI;IAIlC;;OAEG;IACI,oBAAoB,IAAI,IAAI;IASnC;;OAEG;IACI,mBAAmB,IAAI;QAC5B,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,oBAAoB,EAAE,OAAO,CAAC;KAC/B;CAOF"}

package/dist/websocket/websocket-client.interface.d.ts

@@ -0,0 +1,14 @@
+import type { ApplicationConfig } from '../application/base-application.interface.js';
+import type DatabaseInstance from '../database/instance.js';
+import type QueueManager from '../queue/manager.js';
+import type { RedisInstance } from '../redis/index.js';
+import type { WebSocketOptions, WebSocketRoute } from './websocket.interface.js';
+export interface WebSocketClientProps {
+    applicationConfig: ApplicationConfig;
+    options: WebSocketOptions;
+    redisInstance: RedisInstance;
+    queueManager: QueueManager;
+    databaseInstance: DatabaseInstance;
+    routes: WebSocketRoute[];
+}
+//# sourceMappingURL=websocket-client.interface.d.ts.map

package/dist/websocket/websocket-client.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-client.interface.d.ts","sourceRoot":"","sources":["../../src/websocket/websocket-client.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAEjF,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B"}