@scpxl/nodejs-framework 1.0.32 → 1.0.43

package/dist/websocket/websocket.interface.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/websocket/websocket.interface.ts"],
-  "sourcesContent": ["import type { WebSocketServer as NativeWebSocketServer, WebSocket } from 'ws';\nimport type WebSocketServerInstance from './websocket-server.js';\nimport type DatabaseInstance from '../database/instance.js';\nimport type QueueManager from '../queue/manager.js';\nimport type RedisInstance from '../redis/instance.js';\nimport type { WebSocketServerBaseControllerType } from './controller/server/base.interface.js';\nimport type { WebSocketClientBaseControllerType } from './controller/client/base.interface.js';\n\nexport type WebSocketType = 'server' | 'client';\n\nexport interface WebSocketSubscriberHandlerContext<TMessage = any> {\n  /** Redis channel that emitted the message */\n  channel: string;\n\n  /** Parsed message payload */\n  message: TMessage;\n\n  /** Running WebSocket server instance */\n  webSocketServer: WebSocketServerInstance;\n\n  /** Database instance bound to the application */\n  databaseInstance: DatabaseInstance;\n\n  /** Redis instance used by the framework */\n  redisInstance: RedisInstance;\n\n  /** Queue manager instance used by the framework */\n  queueManager: QueueManager;\n}\n\nexport type WebSocketSubscriberHandler<TMessage = any> = (\n  context: WebSocketSubscriberHandlerContext<TMessage>,\n) => unknown | Promise<unknown>;\n\nexport type WebSocketSubscriberMatcher<TMessage = any> =\n  | string\n  | RegExp\n  | ((context: WebSocketSubscriberHandlerContext<TMessage>) => boolean);\n\nexport interface WebSocketSubscriberDefinition<TMessage = any> {\n  /** Optional identifier, used for logging and debugging */\n  name?: string;\n\n  /** Optional description to document the handler */\n  description?: string;\n\n  /** Optional priority to control execution order (higher runs first) */\n  priority?: number;\n\n  /** Optional explicit channel filters */\n  channels?: string[];\n\n  /** Optional matchers that allow advanced filtering */\n  matchers?: WebSocketSubscriberMatcher<TMessage>[];\n\n  /** Handler that will be invoked when the message is matched */\n  handle: WebSocketSubscriberHandler<TMessage>;\n}\n\nexport interface WebSocketSubscriberHandlersConfig {\n  /** Directory that contains subscriber handler modules */\n  directory?: string;\n\n  /** Additional handlers defined inline */\n  handlers?: WebSocketSubscriberDefinition[];\n}\n\nexport interface WebSocketDebugOptions {\n  printRoutes?: boolean;\n  printConnectedClients?: 'simple' | 'table';\n}\n\nexport interface WebSocketMessage<TData = unknown> {\n  type: string;\n  action: string;\n  data: TData;\n}\n\nexport interface WebSocketEventsConfig {\n  onServerStarted?: ({ webSocketServer }: { webSocketServer: NativeWebSocketServer }) => void;\n  onConnected?: ({\n    ws,\n    clientId,\n    joinRoom,\n  }: {\n    ws: WebSocket;\n    clientId: string;\n    joinRoom({\n      userId,\n      userType,\n      username,\n      roomName,\n    }: {\n      userId?: string;\n      userType?: string;\n      username?: string;\n      roomName: string;\n    }): void;\n  }) => void;\n  onDisconnected?: ({ clientId }: { clientId?: string }) => void;\n  onError?: ({ error }: { error: Error }) => void;\n  onMessage?: <TData = unknown>({\n    ws,\n    clientId,\n    data,\n    redisInstance,\n    queueManager,\n    databaseInstance,\n  }: {\n    ws: WebSocket;\n    clientId: string;\n    data: WebSocketMessage<TData>;\n    redisInstance: RedisInstance;\n    queueManager: QueueManager;\n    databaseInstance: DatabaseInstance;\n  }) => void;\n  /** Fired when attempting to reconnect */\n  onReconnecting?: ({ attempt, delay }: { attempt: number; delay: number }) => void;\n  /** Fired when reconnection is successful */\n  onReconnected?: ({ clientId }: { clientId?: string }) => void;\n  /** Fired when max reconnection attempts are reached */\n  onReconnectFailed?: ({ attempts }: { attempts: number }) => void;\n}\n\nexport interface WebSocketOptions {\n  /** WebSocket type */\n  type: WebSocketType;\n\n  /** WebSocket host */\n  host?: string;\n\n  /** WebSocket URL */\n  url: string;\n\n  /** WebSocket controllers directory */\n  controllersDirectory: string;\n\n  /** Disconnect inactive WebSocket clients configuration  */\n  disconnectInactiveClients?: {\n    /** Whether to enable disconnection of inactive WebSocket clients */\n    enabled?: boolean;\n\n    /** Interval check time in milliseconds */\n    intervalCheckTime?: number;\n\n    /** Inactive time in milliseconds */\n    inactiveTime?: number;\n\n    /** Whether to log disconnection of inactive WebSocket clients */\n    log?: boolean;\n  };\n\n  rooms?: {\n    enabled?: boolean;\n    clientCanJoinMultipleRooms?: boolean;\n  };\n\n  /** WebSocket debug options */\n  debug?: WebSocketDebugOptions;\n\n  /** WebSocket events */\n  events?: WebSocketEventsConfig;\n\n  /** WebSocket subscriber handlers configuration */\n  subscriberHandlers?: WebSocketSubscriberHandlersConfig;\n}\n\nexport interface WebSocketRoute {\n  /** WebSocket route type */\n  type: string;\n\n  /** WebSocket route controller name */\n  controllerName: string;\n\n  /** WebSocket route controller */\n  controller?: WebSocketServerBaseControllerType | WebSocketClientBaseControllerType;\n\n  /** WebSocket route action */\n  action: string;\n}\n\nexport interface WebSocketConstructorParams {\n  /** WebSocket options */\n  options: WebSocketOptions;\n\n  /** WebSocket routes */\n  routes: WebSocketRoute[];\n\n  /** Redis instance */\n  redisInstance: RedisInstance;\n\n  /** Queue manager */\n  queueManager: QueueManager;\n\n  /** Database instance */\n  databaseInstance: DatabaseInstance;\n}\n\nexport interface WebSocketConnectedClientData {\n  /** WebSocket client */\n  ws: WebSocket | null;\n\n  /** Last activity time */\n  lastActivity: number;\n\n  /** Client username */\n  username?: string;\n}\n\nexport interface WebSocketMessageResponse {\n  error?: string;\n}\n\nexport interface WebSocketMessageHandler<TData = unknown, TResponse = WebSocketMessageResponse> {\n  (ws: WebSocket, clientId: string, data: TData): Promise<TResponse> | TResponse;\n}\n\nexport enum WebSocketRedisSubscriberEvent {\n  ClientConnected = 'clientConnected',\n  ClientDisconnected = 'clientDisconnected',\n  DisconnectClient = 'disconnectClient',\n  ClientJoinedRoom = 'clientJoinedRoom',\n  ClientLeftRoom = 'clientLeftRoom',\n  SendMessage = 'sendMessage',\n  SendMessageToAll = 'sendMessageToAll',\n  MessageError = 'messageError',\n  QueueJobCompleted = 'queueJobCompleted',\n  QueueJobError = 'queueJobError',\n  Custom = 'custom',\n}\n"],
-  "mappings": "AAyNO,IAAK,gCAAL,kBAAKA,mCAAL;AACL,EAAAA,+BAAA,qBAAkB;AAClB,EAAAA,+BAAA,wBAAqB;AACrB,EAAAA,+BAAA,sBAAmB;AACnB,EAAAA,+BAAA,sBAAmB;AACnB,EAAAA,+BAAA,oBAAiB;AACjB,EAAAA,+BAAA,iBAAc;AACd,EAAAA,+BAAA,sBAAmB;AACnB,EAAAA,+BAAA,kBAAe;AACf,EAAAA,+BAAA,uBAAoB;AACpB,EAAAA,+BAAA,mBAAgB;AAChB,EAAAA,+BAAA,YAAS;AAXC,SAAAA;AAAA,GAAA;",
+  "sourcesContent": ["import type { WebSocketServer as NativeWebSocketServer, WebSocket } from 'ws';\nimport type WebSocketServerInstance from './websocket-server.js';\nimport type DatabaseInstance from '../database/instance.js';\nimport type QueueManager from '../queue/manager.js';\nimport type RedisInstance from '../redis/instance.js';\nimport type { WebSocketServerBaseControllerType } from './controller/server/base.interface.js';\nimport type { WebSocketClientBaseControllerType } from './controller/client/base.interface.js';\n\nexport type WebSocketType = 'server' | 'client';\n\nexport interface WebSocketSubscriberHandlerContext<TMessage = any> {\n  /** Redis channel that emitted the message */\n  channel: string;\n\n  /** Parsed message payload */\n  message: TMessage;\n\n  /** Running WebSocket server instance */\n  webSocketServer: WebSocketServerInstance;\n\n  /** Database instance bound to the application */\n  databaseInstance: DatabaseInstance;\n\n  /** Redis instance used by the framework */\n  redisInstance: RedisInstance;\n\n  /** Queue manager instance used by the framework */\n  queueManager: QueueManager;\n}\n\nexport type WebSocketSubscriberHandler<TMessage = any> = (\n  context: WebSocketSubscriberHandlerContext<TMessage>,\n) => unknown | Promise<unknown>;\n\nexport type WebSocketSubscriberMatcher<TMessage = any> =\n  | string\n  | RegExp\n  | ((context: WebSocketSubscriberHandlerContext<TMessage>) => boolean);\n\nexport interface WebSocketSubscriberDefinition<TMessage = any> {\n  /** Optional identifier, used for logging and debugging */\n  name?: string;\n\n  /** Optional description to document the handler */\n  description?: string;\n\n  /** Optional priority to control execution order (higher runs first) */\n  priority?: number;\n\n  /** Optional explicit channel filters */\n  channels?: string[];\n\n  /** Optional matchers that allow advanced filtering */\n  matchers?: WebSocketSubscriberMatcher<TMessage>[];\n\n  /** Handler that will be invoked when the message is matched */\n  handle: WebSocketSubscriberHandler<TMessage>;\n\n  /** Optional middleware to apply to this handler */\n  middleware?: Array<{\n    name: string;\n    onBefore?: (context: WebSocketSubscriberHandlerContext<TMessage>) => boolean | Promise<boolean>;\n    onAfter?: (context: WebSocketSubscriberHandlerContext<TMessage>, result: unknown) => void | Promise<void>;\n    onError?: (context: WebSocketSubscriberHandlerContext<TMessage>, error: Error) => boolean | Promise<boolean>;\n  }>;\n}\n\nexport interface WebSocketSubscriberHandlersConfig {\n  /** Directory that contains subscriber handler modules */\n  directory?: string;\n\n  /** Additional handlers defined inline */\n  handlers?: WebSocketSubscriberDefinition[];\n}\n\nexport interface WebSocketDebugOptions {\n  printRoutes?: boolean;\n  printConnectedClients?: 'simple' | 'table';\n}\n\nexport interface WebSocketMessage<TData = unknown> {\n  type: string;\n  action: string;\n  data: TData;\n}\n\nexport interface WebSocketEventsConfig {\n  onServerStarted?: ({ webSocketServer }: { webSocketServer: NativeWebSocketServer }) => void;\n  onConnected?: ({\n    ws,\n    clientId,\n    joinRoom,\n  }: {\n    ws: WebSocket;\n    clientId: string;\n    joinRoom({\n      userId,\n      userType,\n      username,\n      roomName,\n    }: {\n      userId?: string;\n      userType?: string;\n      username?: string;\n      roomName: string;\n    }): void;\n  }) => void;\n  onDisconnected?: ({ clientId }: { clientId?: string }) => void;\n  onError?: ({ error }: { error: Error }) => void;\n  onMessage?: <TData = unknown>({\n    ws,\n    clientId,\n    data,\n    redisInstance,\n    queueManager,\n    databaseInstance,\n  }: {\n    ws: WebSocket;\n    clientId: string;\n    data: WebSocketMessage<TData>;\n    redisInstance: RedisInstance;\n    queueManager: QueueManager;\n    databaseInstance: DatabaseInstance;\n  }) => void;\n  /** Fired when attempting to reconnect */\n  onReconnecting?: ({ attempt, delay }: { attempt: number; delay: number }) => void;\n  /** Fired when reconnection is successful */\n  onReconnected?: ({ clientId }: { clientId?: string }) => void;\n  /** Fired when max reconnection attempts are reached */\n  onReconnectFailed?: ({ attempts }: { attempts: number }) => void;\n}\n\nexport interface WebSocketOptions {\n  /** WebSocket type */\n  type: WebSocketType;\n\n  /** WebSocket host */\n  host?: string;\n\n  /** WebSocket URL */\n  url: string;\n\n  /** WebSocket controllers directory */\n  controllersDirectory: string;\n\n  /** Disconnect inactive WebSocket clients configuration  */\n  disconnectInactiveClients?: {\n    /** Whether to enable disconnection of inactive WebSocket clients */\n    enabled?: boolean;\n\n    /** Interval check time in milliseconds */\n    intervalCheckTime?: number;\n\n    /** Inactive time in milliseconds */\n    inactiveTime?: number;\n\n    /** Whether to log disconnection of inactive WebSocket clients */\n    log?: boolean;\n  };\n\n  rooms?: {\n    enabled?: boolean;\n    clientCanJoinMultipleRooms?: boolean;\n  };\n\n  /** WebSocket debug options */\n  debug?: WebSocketDebugOptions;\n\n  /** WebSocket events */\n  events?: WebSocketEventsConfig;\n\n  /** WebSocket subscriber handlers configuration */\n  subscriberHandlers?: WebSocketSubscriberHandlersConfig;\n}\n\nexport interface WebSocketRoute {\n  /** WebSocket route type */\n  type: string;\n\n  /** WebSocket route controller name */\n  controllerName: string;\n\n  /** WebSocket route controller */\n  controller?: WebSocketServerBaseControllerType | WebSocketClientBaseControllerType;\n\n  /** WebSocket route action */\n  action: string;\n}\n\nexport interface WebSocketConstructorParams {\n  /** WebSocket options */\n  options: WebSocketOptions;\n\n  /** WebSocket routes */\n  routes: WebSocketRoute[];\n\n  /** Redis instance */\n  redisInstance: RedisInstance;\n\n  /** Queue manager */\n  queueManager: QueueManager;\n\n  /** Database instance */\n  databaseInstance: DatabaseInstance;\n}\n\nexport interface WebSocketConnectedClientData {\n  /** WebSocket client */\n  ws: WebSocket | null;\n\n  /** Last activity time */\n  lastActivity: number;\n\n  /** Client username */\n  username?: string;\n}\n\nexport interface WebSocketMessageResponse {\n  error?: string;\n}\n\nexport interface WebSocketMessageHandler<TData = unknown, TResponse = WebSocketMessageResponse> {\n  (ws: WebSocket, clientId: string, data: TData): Promise<TResponse> | TResponse;\n}\n\nexport enum WebSocketRedisSubscriberEvent {\n  ClientConnected = 'clientConnected',\n  ClientDisconnected = 'clientDisconnected',\n  DisconnectClient = 'disconnectClient',\n  ClientJoinedRoom = 'clientJoinedRoom',\n  ClientLeftRoom = 'clientLeftRoom',\n  SendMessage = 'sendMessage',\n  SendMessageToAll = 'sendMessageToAll',\n  MessageError = 'messageError',\n  QueueJobCompleted = 'queueJobCompleted',\n  QueueJobError = 'queueJobError',\n  Custom = 'custom',\n}\n"],
+  "mappings": "AAiOO,IAAK,gCAAL,kBAAKA,mCAAL;AACL,EAAAA,+BAAA,qBAAkB;AAClB,EAAAA,+BAAA,wBAAqB;AACrB,EAAAA,+BAAA,sBAAmB;AACnB,EAAAA,+BAAA,sBAAmB;AACnB,EAAAA,+BAAA,oBAAiB;AACjB,EAAAA,+BAAA,iBAAc;AACd,EAAAA,+BAAA,sBAAmB;AACnB,EAAAA,+BAAA,kBAAe;AACf,EAAAA,+BAAA,uBAAoB;AACpB,EAAAA,+BAAA,mBAAgB;AAChB,EAAAA,+BAAA,YAAS;AAXC,SAAAA;AAAA,GAAA;",
   "names": ["WebSocketRedisSubscriberEvent"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scpxl/nodejs-framework",
-  "version": "1.0.32",
+  "version": "1.0.43",
   "description": "PXL Node.js Framework",
   "repository": {
     "type": "git",
@@ -103,7 +103,6 @@
   ],
   "scripts": {
     "dev": "node scripts/hmr-watcher-enhanced.js",
-    "dev:legacy": "node scripts/hmr-watcher.js",
     "dev:import-map": "tsx src/index.ts",
     "clean": "del-cli dist",
     "build": "npm run clean && node esbuild.config.js",
@@ -149,8 +148,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",
+    "@vitest/coverage-v8": "^4.0.6",
+    "@vitest/ui": "^4.0.6",
     "concurrently": "^9.1.2",
     "del-cli": "^7.0.0",
     "esbuild": "^0.25.5",
@@ -164,12 +163,12 @@
     "husky": "^9.1.7",
     "lint-staged": "^16.1.2",
     "prettier": "^3.1.1",
-    "redis-memory-server": "^0.13.0",
+    "redis-memory-server": "^0.14.0",
     "simple-git": "^3.25.0",
     "tsx": "^4.19.2",
     "tsc-alias": "^1.8.16",
     "vitepress": "^1.6.4",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.6"
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.496.0",