@scpxl/nodejs-framework 1.0.42 → 1.0.43

package/dist/websocket/subscriber-utils.js

@@ -0,0 +1,227 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { Logger } from "../logger/index.js";
+function matchByProperty(key, value) {
+  return (context) => {
+    try {
+      const messageValue = getNestedProperty(context.message, key);
+      return messageValue === value;
+    } catch {
+      return false;
+    }
+  };
+}
+__name(matchByProperty, "matchByProperty");
+function matchByPropertyPredicate(key, predicate) {
+  return (context) => {
+    try {
+      const messageValue = getNestedProperty(context.message, key);
+      return predicate(messageValue);
+    } catch {
+      return false;
+    }
+  };
+}
+__name(matchByPropertyPredicate, "matchByPropertyPredicate");
+function getNestedProperty(obj, path) {
+  const keys = path.split(".");
+  let current = obj;
+  for (const key of keys) {
+    if (current == null) {
+      return void 0;
+    }
+    current = current[key];
+  }
+  return current;
+}
+__name(getNestedProperty, "getNestedProperty");
+function withErrorHandler(handler, onError, _throwError = false) {
+  return async (context) => {
+    try {
+      return await handler(context);
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      if (onError) {
+        try {
+          await onError(err, context);
+        } catch (callbackError) {
+          Logger.error({
+            message: "Error handler callback failed",
+            meta: { originalError: err.message, callbackError }
+          });
+        }
+      }
+      if (_throwError) {
+        throw err;
+      }
+    }
+  };
+}
+__name(withErrorHandler, "withErrorHandler");
+function withLogging(handler, handlerName = "subscriber-handler") {
+  return async (context) => {
+    const startTime = Date.now();
+    const messageKeys = context.message && typeof context.message === "object" ? Object.keys(context.message).slice(0, 5) : [];
+    Logger.info({
+      message: `${handlerName}: Starting handler execution`,
+      meta: {
+        channel: context.channel,
+        messageKeys
+      }
+    });
+    try {
+      const result = await handler(context);
+      const duration = Date.now() - startTime;
+      Logger.info({
+        message: `${handlerName}: Handler completed successfully`,
+        meta: { channel: context.channel, durationMs: duration }
+      });
+      return result;
+    } catch (error) {
+      const duration = Date.now() - startTime;
+      Logger.error({
+        message: `${handlerName}: Handler failed`,
+        meta: {
+          channel: context.channel,
+          error: error instanceof Error ? error.message : String(error),
+          durationMs: duration
+        }
+      });
+      throw error;
+    }
+  };
+}
+__name(withLogging, "withLogging");
+function withRateLimit(handler, maxExecutions, windowMs, onRateLimited) {
+  const executionTimes = [];
+  return async (context) => {
+    const now = Date.now();
+    while (executionTimes.length > 0 && executionTimes[0] < now - windowMs) {
+      executionTimes.shift();
+    }
+    if (executionTimes.length >= maxExecutions) {
+      if (onRateLimited) {
+        await onRateLimited(context);
+      }
+      return;
+    }
+    executionTimes.push(now);
+    return await handler(context);
+  };
+}
+__name(withRateLimit, "withRateLimit");
+function withRetry(handler, maxRetries, delayMs, backoffMultiplier = 1) {
+  return async (context) => {
+    let lastError = null;
+    let currentDelay = delayMs;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      try {
+        return await handler(context);
+      } catch (error) {
+        lastError = error instanceof Error ? error : new Error(String(error));
+        if (attempt < maxRetries) {
+          await new Promise((resolve) => setTimeout(resolve, currentDelay));
+          currentDelay = Math.floor(currentDelay * backoffMultiplier);
+        }
+      }
+    }
+    throw lastError;
+  };
+}
+__name(withRetry, "withRetry");
+function composeHandlers(handlers) {
+  return async (context) => {
+    for (const handler of handlers) {
+      await handler(context);
+    }
+  };
+}
+__name(composeHandlers, "composeHandlers");
+function withFilter(predicate, handler) {
+  return async (context) => {
+    const shouldExecute = await predicate(context);
+    if (shouldExecute) {
+      return await handler(context);
+    }
+  };
+}
+__name(withFilter, "withFilter");
+function withValidation(validator, handler) {
+  return async (context) => {
+    try {
+      await validator(context.message);
+      return await handler(context);
+    } catch (error) {
+      Logger.warn({
+        message: "Message validation failed",
+        meta: {
+          channel: context.channel,
+          error: error instanceof Error ? error.message : String(error)
+        }
+      });
+      throw error;
+    }
+  };
+}
+__name(withValidation, "withValidation");
+function withMetadata(metadata, handler) {
+  return async (context) => {
+    const enrichedContext = {
+      ...context,
+      metadata
+    };
+    return await handler(enrichedContext);
+  };
+}
+__name(withMetadata, "withMetadata");
+function withDebounce(handler, delayMs) {
+  const timers = /* @__PURE__ */ new Map();
+  return async (context) => {
+    const channel = context.channel;
+    const existingTimer = timers.get(channel);
+    if (existingTimer) {
+      clearTimeout(existingTimer);
+    }
+    return new Promise((resolve) => {
+      const timer = setTimeout(async () => {
+        try {
+          await handler(context);
+        } finally {
+          timers.delete(channel);
+          resolve();
+        }
+      }, delayMs);
+      timers.set(channel, timer);
+    });
+  };
+}
+__name(withDebounce, "withDebounce");
+function withThrottle(handler, intervalMs) {
+  const lastExecutionTime = /* @__PURE__ */ new Map();
+  return async (context) => {
+    const channel = context.channel;
+    const now = Date.now();
+    const lastTime = lastExecutionTime.get(channel) ?? 0;
+    if (now - lastTime >= intervalMs) {
+      lastExecutionTime.set(channel, now);
+      return await handler(context);
+    }
+  };
+}
+__name(withThrottle, "withThrottle");
+export {
+  composeHandlers,
+  getNestedProperty,
+  matchByProperty,
+  matchByPropertyPredicate,
+  withDebounce,
+  withErrorHandler,
+  withFilter,
+  withLogging,
+  withMetadata,
+  withRateLimit,
+  withRetry,
+  withThrottle,
+  withValidation
+};
+//# sourceMappingURL=subscriber-utils.js.map

package/dist/websocket/subscriber-utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/websocket/subscriber-utils.ts"],
+  "sourcesContent": ["import type {\n  WebSocketSubscriberHandler,\n  WebSocketSubscriberHandlerContext,\n  WebSocketSubscriberMatcher,\n} from './websocket.interface.js';\nimport { Logger } from '../logger/index.js';\n\n/**\n * Utility functions for building and composing WebSocket subscriber handlers\n */\n\n/**\n * Create a predicate matcher for message properties\n * @param key - The property key to check\n * @param value - The expected value\n */\nexport function matchByProperty(key: string, value: unknown): WebSocketSubscriberMatcher {\n  return (context: WebSocketSubscriberHandlerContext) => {\n    try {\n      const messageValue = getNestedProperty(context.message, key);\n      return messageValue === value;\n    } catch {\n      return false;\n    }\n  };\n}\n\n/**\n * Create a predicate matcher for message property patterns\n * @param key - The property key to check\n * @param predicate - Function to test the value\n */\nexport function matchByPropertyPredicate<_T = unknown>(\n  key: string,\n  predicate: (value: unknown) => boolean,\n): WebSocketSubscriberMatcher {\n  return (context: WebSocketSubscriberHandlerContext) => {\n    try {\n      const messageValue = getNestedProperty(context.message, key);\n      return predicate(messageValue);\n    } catch {\n      return false;\n    }\n  };\n}\n\n/**\n * Safely get nested property from an object\n * @param obj - The object to search\n * @param path - Dot-notation path (e.g., 'user.id' or 'data.items.0.name')\n */\nexport function getNestedProperty(obj: any, path: string): unknown {\n  const keys = path.split('.');\n  let current = obj;\n\n  for (const key of keys) {\n    if (current == null) {\n      return undefined;\n    }\n    // eslint-disable-next-line security/detect-object-injection\n    current = current[key];\n  }\n\n  return current;\n}\n\n/**\n * Wrap a handler with error handling\n * @param handler - The handler to wrap\n * @param onError - Error handler callback\n * @param throwError - Whether to rethrow the error after handling\n */\nexport function withErrorHandler<TMessage = any>(\n  handler: WebSocketSubscriberHandler<TMessage>,\n  onError?: (error: Error, context: WebSocketSubscriberHandlerContext<TMessage>) => void | Promise<void>,\n  _throwError = false,\n): WebSocketSubscriberHandler<TMessage> {\n  return async (context: WebSocketSubscriberHandlerContext<TMessage>) => {\n    try {\n      return await handler(context);\n    } catch (error) {\n      const err = error instanceof Error ? error : new Error(String(error));\n\n      if (onError) {\n        try {\n          await onError(err, context);\n        } catch (callbackError) {\n          Logger.error({\n            message: 'Error handler callback failed',\n            meta: { originalError: err.message, callbackError },\n          });\n        }\n      }\n\n      if (_throwError) {\n        throw err;\n      }\n    }\n  };\n}\n\n/**\n * Wrap a handler with logging\n * @param handler - The handler to wrap\n * @param handlerName - Name for logging purposes\n */\nexport function withLogging<TMessage = any>(\n  handler: WebSocketSubscriberHandler<TMessage>,\n  handlerName = 'subscriber-handler',\n): WebSocketSubscriberHandler<TMessage> {\n  return async (context: WebSocketSubscriberHandlerContext<TMessage>) => {\n    const startTime = Date.now();\n    const messageKeys =\n      context.message && typeof context.message === 'object'\n        ? Object.keys(context.message as Record<string, unknown>).slice(0, 5)\n        : [];\n    Logger.info({\n      message: `${handlerName}: Starting handler execution`,\n      meta: {\n        channel: context.channel,\n        messageKeys,\n      },\n    });\n\n    try {\n      const result = await handler(context);\n      const duration = Date.now() - startTime;\n      Logger.info({\n        message: `${handlerName}: Handler completed successfully`,\n        meta: { channel: context.channel, durationMs: duration },\n      });\n      return result;\n    } catch (error) {\n      const duration = Date.now() - startTime;\n      Logger.error({\n        message: `${handlerName}: Handler failed`,\n        meta: {\n          channel: context.channel,\n          error: error instanceof Error ? error.message : String(error),\n          durationMs: duration,\n        },\n      });\n      throw error;\n    }\n  };\n}\n\n/**\n * Wrap a handler with rate limiting\n * @param handler - The handler to wrap\n * @param maxExecutions - Max executions allowed\n * @param windowMs - Time window in milliseconds\n * @param onRateLimited - Optional callback when rate limited\n */\nexport function withRateLimit<TMessage = any>(\n  handler: WebSocketSubscriberHandler<TMessage>,\n  maxExecutions: number,\n  windowMs: number,\n  onRateLimited?: (context: WebSocketSubscriberHandlerContext<TMessage>) => void | Promise<void>,\n): WebSocketSubscriberHandler<TMessage> {\n  const executionTimes: number[] = [];\n\n  return async (context: WebSocketSubscriberHandlerContext<TMessage>) => {\n    const now = Date.now();\n\n    // Remove old entries outside the window\n    while (executionTimes.length > 0 && executionTimes[0] < now - windowMs) {\n      executionTimes.shift();\n    }\n\n    if (executionTimes.length >= maxExecutions) {\n      if (onRateLimited) {\n        await onRateLimited(context);\n      }\n      return;\n    }\n\n    executionTimes.push(now);\n    return await handler(context);\n  };\n}\n\n/**\n * Wrap a handler with retry logic\n * @param handler - The handler to wrap\n * @param maxRetries - Maximum number of retries\n * @param delayMs - Delay between retries in milliseconds\n * @param backoffMultiplier - Multiplier for exponential backoff (default: 1, no backoff)\n */\nexport function withRetry<TMessage = any>(\n  handler: WebSocketSubscriberHandler<TMessage>,\n  maxRetries: number,\n  delayMs: number,\n  backoffMultiplier = 1,\n): WebSocketSubscriberHandler<TMessage> {\n  return async (context: WebSocketSubscriberHandlerContext<TMessage>) => {\n    let lastError: Error | null = null;\n    let currentDelay = delayMs;\n\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      try {\n        return await handler(context);\n      } catch (error) {\n        lastError = error instanceof Error ? error : new Error(String(error));\n\n        if (attempt < maxRetries) {\n          await new Promise(resolve => setTimeout(resolve, currentDelay));\n          currentDelay = Math.floor(currentDelay * backoffMultiplier);\n        }\n      }\n    }\n\n    throw lastError;\n  };\n}\n\n/**\n * Compose multiple handlers into a single handler\n * Executes handlers sequentially, passing context through each one\n * @param handlers - Array of handlers to compose\n */\nexport function composeHandlers<TMessage = any>(\n  handlers: WebSocketSubscriberHandler<TMessage>[],\n): WebSocketSubscriberHandler<TMessage> {\n  return async (context: WebSocketSubscriberHandlerContext<TMessage>) => {\n    for (const handler of handlers) {\n      await handler(context);\n    }\n  };\n}\n\n/**\n * Create a filter handler that conditionally executes based on a predicate\n * @param predicate - Function that returns true if handler should execute\n * @param handler - The handler to execute conditionally\n */\nexport function withFilter<TMessage = any>(\n  predicate: (context: WebSocketSubscriberHandlerContext<TMessage>) => boolean | Promise<boolean>,\n  handler: WebSocketSubscriberHandler<TMessage>,\n): WebSocketSubscriberHandler<TMessage> {\n  return async (context: WebSocketSubscriberHandlerContext<TMessage>) => {\n    const shouldExecute = await predicate(context);\n    if (shouldExecute) {\n      return await handler(context);\n    }\n  };\n}\n\n/**\n * Validate message structure before execution\n * @param validator - Function that validates the message and throws if invalid\n * @param handler - The handler to wrap\n */\nexport function withValidation<TMessage = any>(\n  validator: (message: TMessage) => void | Promise<void>,\n  handler: WebSocketSubscriberHandler<TMessage>,\n): WebSocketSubscriberHandler<TMessage> {\n  return async (context: WebSocketSubscriberHandlerContext<TMessage>) => {\n    try {\n      await validator(context.message);\n      return await handler(context);\n    } catch (error) {\n      Logger.warn({\n        message: 'Message validation failed',\n        meta: {\n          channel: context.channel,\n          error: error instanceof Error ? error.message : String(error),\n        },\n      });\n      throw error;\n    }\n  };\n}\n\n/**\n * Add metadata/context to a handler execution\n * @param metadata - Metadata to add to context\n * @param handler - The handler to wrap\n */\nexport function withMetadata<TMessage = any>(\n  metadata: Record<string, unknown>,\n  handler: WebSocketSubscriberHandler<TMessage>,\n): WebSocketSubscriberHandler<TMessage> {\n  return async (context: WebSocketSubscriberHandlerContext<TMessage>) => {\n    const enrichedContext = {\n      ...context,\n      metadata,\n    } as any;\n\n    return await handler(enrichedContext);\n  };\n}\n\n/**\n * Debounce handler execution by channel\n * @param handler - The handler to wrap\n * @param delayMs - Debounce delay in milliseconds\n */\nexport function withDebounce<TMessage = any>(\n  handler: WebSocketSubscriberHandler<TMessage>,\n  delayMs: number,\n): WebSocketSubscriberHandler<TMessage> {\n  const timers = new Map<string, NodeJS.Timeout>();\n\n  return async (context: WebSocketSubscriberHandlerContext<TMessage>) => {\n    const channel = context.channel;\n\n    // Cancel previous timer for this channel\n    const existingTimer = timers.get(channel);\n    if (existingTimer) {\n      clearTimeout(existingTimer);\n    }\n\n    // Set new timer\n    return new Promise<void>(resolve => {\n      const timer = setTimeout(async () => {\n        try {\n          await handler(context);\n        } finally {\n          timers.delete(channel);\n          resolve();\n        }\n      }, delayMs);\n\n      timers.set(channel, timer);\n    });\n  };\n}\n\n/**\n * Throttle handler execution by channel\n * @param handler - The handler to wrap\n * @param intervalMs - Throttle interval in milliseconds\n */\nexport function withThrottle<TMessage = any>(\n  handler: WebSocketSubscriberHandler<TMessage>,\n  intervalMs: number,\n): WebSocketSubscriberHandler<TMessage> {\n  const lastExecutionTime = new Map<string, number>();\n\n  return async (context: WebSocketSubscriberHandlerContext<TMessage>) => {\n    const channel = context.channel;\n    const now = Date.now();\n    const lastTime = lastExecutionTime.get(channel) ?? 0;\n\n    if (now - lastTime >= intervalMs) {\n      lastExecutionTime.set(channel, now);\n      return await handler(context);\n    }\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -78,12 +78,52 @@ export default class WebSocketServer extends WebSocketBase {
      * Broadcast a message to all connected WebSocket clients
      * @param data - The data to broadcast (will be JSON stringified)
      * @param excludeClientId - Optional client ID to exclude from broadcast
+     * @param predicate - Optional function to filter clients
      */
-    broadcastToAllClients({ data, excludeClientId, }: {
+    broadcastToAllClients({ data, excludeClientId, predicate, }: {
         data: {
             [key: string]: any;
         };
         excludeClientId?: string;
+        predicate?: (clientData: {
+            clientId: string;
+            userData: any;
+        }) => boolean;
+    }): void;
+    /**
+     * Broadcast a message to all clients in a specific room
+     * @param roomName - The room to broadcast to
+     * @param data - The data to broadcast
+     * @param excludeClientId - Optional client ID to exclude from broadcast
+     */
+    broadcastToRoom({ roomName, data, excludeClientId, }: {
+        roomName: string;
+        data: {
+            [key: string]: any;
+        };
+        excludeClientId?: string;
+    }): void;
+    /**
+     * Broadcast a message to specific users
+     * @param userIds - Array of user IDs to broadcast to
+     * @param data - The data to broadcast
+     */
+    broadcastToUsers({ userIds, data }: {
+        userIds: (string | number)[];
+        data: {
+            [key: string]: any;
+        };
+    }): void;
+    /**
+     * Broadcast a message to a specific client
+     * @param clientId - The client ID to send to
+     * @param data - The data to send
+     */
+    broadcastToClient({ clientId, data }: {
+        clientId: string;
+        data: {
+            [key: string]: any;
+        };
     }): void;
     sendMessageError({ webSocketClientId, error }: {
         webSocketClientId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"websocket-server.d.ts","sourceRoot":"","sources":["../../src/websocket/websocket-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,eAAe,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpE,OAAO,EAGL,KAAK,cAAc,EAInB,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAClC,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;AAC5E,OAAO,sBAAsB,MAAM,+BAA+B,CAAC;AAEnE,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAMhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,aAAa;IACxD,SAAS,CAAC,aAAa,EAAE,cAAc,EAAE,CAWvC;IAEF,OAAO,CAAC,MAAM,CAAC,CAAK;IAEpB,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,OAAO,CAAmB;IAC3B,aAAa,yBAAgC;IACpD,OAAO,CAAC,WAAW,CAEhB;IACH,OAAO,CAAC,WAAW,CAAuB;IAE1C,IAAW,KAAK,6BAEf;IACD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,2BAA2B,CAA2D;IAC9F,OAAO,CAAC,yBAAyB,CAAuC;IACxE,OAAO,CAAC,0BAA0B,CAAuC;IAEzE,8BAA8B;IAC9B,OAAO,CAAC,qBAAqB,CAY3B;gBAEU,KAAK,EAAE,oBAAoB;IAcvC,IAAW,IAAI,IAAI,aAAa,CAE/B;YAEa,qBAAqB;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAYpB,sBAAsB;IA6DpC,OAAO,CAAC,yBAAyB;IAwCjC,OAAO,CAAC,yBAAyB;IAmDjC,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,4BAA4B;IAqCpC,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,eAAe;YA6BT,yBAAyB;IAwD1B,KAAK,CAAC,EAAE,aAAa,EAAE,EAAE;QAAE,aAAa,EAAE,eAAe,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,EAAE,CAAA;KAAE,CAAC;IA4CrF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuClC,SAAS,CAAC,yBAAyB,IAAI;QACrC,eAAe,EAAE,eAAe,CAAC;QACjC,aAAa,EAAE,aAAa,CAAC;QAC7B,YAAY,EAAE,YAAY,CAAC;QAC3B,gBAAgB,EAAE,gBAAgB,CAAC;KACpC;IASD,SAAS,CAAC,iBAAiB,IAAI,OAAO;IAItC,OAAO,CAAC,iBAAiB,CAkCvB;IAEF;;OAEG;IACH,OAAO,CAAC,uBAAuB,CAgI7B;IAEF,OAAO,CAAC,iBAAiB,CAEvB;IAEF,OAAO,CAAC,4BAA4B,CAmDlC;IAEK,SAAS,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE;QAAE,EAAE,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAgD7E,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,+BAA+B,CAwBrC;IAEF,OAAO,CAAC,mBAAmB,CA6CzB;IAEF,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWnE;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA8B5B;;;;OAIG;IACI,qBAAqB,CAAC,EAC3B,IAAI,EACJ,eAAe,GAChB,EAAE;QACD,IAAI,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;QAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,GAAG,IAAI;IAuBD,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAwCzG,OAAO,CAAC,UAAU;IAwCL,QAAQ,CAAC,EACpB,EAAE,EACF,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,EAAE;QACD,EAAE,EAAE,SAAS,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAoHM,iBAAiB,GAAI,IAAI,SAAS,EAAE,MAAM,OAAO,EAAE,SAAQ,OAAe,KAAG,IAAI,CAItF;IAEK,WAAW,GAAI,UAAU;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAG,IAAI,CAUtD;IAEK,gBAAgB,GAAI,UAAU;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAG,IAAI,CAU3D;IAEK,iBAAiB,GAAI,UAAU;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAG,IAAI,CAO5D;IAEK,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,GAAG,EAAE;CAG9D"}
+{"version":3,"file":"websocket-server.d.ts","sourceRoot":"","sources":["../../src/websocket/websocket-server.ts"],"names":[],"mappings":"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"}

package/dist/websocket/websocket-server.js

@@ -14,6 +14,7 @@ import WebSocketRoomManager from "./websocket-room-manager.js";
 import logger from "../logger/logger.js";
 import { WebSocketAuthService } from "./websocket-auth.js";
 import { File, Loader } from "../util/index.js";
+import { executeWithMiddleware } from "./subscriber-middleware.js";
 class WebSocketServer extends WebSocketBase {
   static {
     __name(this, "WebSocketServer");
@@ -326,15 +327,19 @@ class WebSocketServer extends WebSocketBase {
       return;
     }
     const orderedHandlers = Array.from(candidates).sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
-    for (const handler of orderedHandlers) {
+    for (const handlerDef of orderedHandlers) {
       try {
-        await handler.handle(context);
+        if (handlerDef.middleware && handlerDef.middleware.length > 0) {
+          await executeWithMiddleware(handlerDef.handle, handlerDef.middleware, context);
+        } else {
+          await handlerDef.handle(context);
+        }
       } catch (error) {
         logger.error({
           error,
           message: "WebSocket subscriber handler failed",
           meta: {
-            Handler: handler.name ?? "(anonymous)",
+            Handler: handlerDef.name ?? "(anonymous)",
             Channel: channel
           }
         });
@@ -729,10 +734,12 @@ class WebSocketServer extends WebSocketBase {
    * Broadcast a message to all connected WebSocket clients
    * @param data - The data to broadcast (will be JSON stringified)
    * @param excludeClientId - Optional client ID to exclude from broadcast
+   * @param predicate - Optional function to filter clients
    */
   broadcastToAllClients({
     data,
-    excludeClientId
+    excludeClientId,
+    predicate
   }) {
     if (!this.server) {
       log("Server not started when broadcasting to all clients");
@@ -742,15 +749,91 @@ class WebSocketServer extends WebSocketBase {
       if (client.readyState !== WebSocket.OPEN) {
         continue;
       }
-      if (excludeClientId) {
-        const clientId = this.clientManager.getClientId({ ws: client });
-        if (clientId === excludeClientId) {
+      const clientId = this.clientManager.getClientId({ ws: client });
+      if (excludeClientId && clientId === excludeClientId) {
+        continue;
+      }
+      if (predicate && clientId) {
+        const clientData = this.clientManager.getClient({ clientId });
+        if (!clientData || !predicate({ clientId, userData: clientData.user })) {
           continue;
         }
       }
       client.send(JSON.stringify(data));
     }
   }
+  /**
+   * Broadcast a message to all clients in a specific room
+   * @param roomName - The room to broadcast to
+   * @param data - The data to broadcast
+   * @param excludeClientId - Optional client ID to exclude from broadcast
+   */
+  broadcastToRoom({
+    roomName,
+    data,
+    excludeClientId
+  }) {
+    if (!this.server) {
+      log("Server not started when broadcasting to room", { roomName });
+      return;
+    }
+    const room = this.roomManager.rooms.get(roomName);
+    if (!room) {
+      log("Room not found when broadcasting", { roomName });
+      return;
+    }
+    for (const clientId of room) {
+      if (excludeClientId && clientId === excludeClientId) {
+        continue;
+      }
+      const client = this.clientManager.getClient({ clientId });
+      if (!client?.ws || client.ws.readyState !== WebSocket.OPEN) {
+        continue;
+      }
+      client.ws.send(JSON.stringify(data));
+    }
+  }
+  /**
+   * Broadcast a message to specific users
+   * @param userIds - Array of user IDs to broadcast to
+   * @param data - The data to broadcast
+   */
+  broadcastToUsers({ userIds, data }) {
+    if (!this.server) {
+      log("Server not started when broadcasting to users");
+      return;
+    }
+    const userIdSet = new Set(userIds.map((id) => String(id)));
+    for (const client of this.server.clients) {
+      if (client.readyState !== WebSocket.OPEN) {
+        continue;
+      }
+      const clientId = this.clientManager.getClientId({ ws: client });
+      const clientData = clientId ? this.clientManager.getClient({ clientId }) : null;
+      if (!clientData?.user) {
+        continue;
+      }
+      const clientUserId = String(clientData.user.id ?? clientData.user.userId);
+      if (userIdSet.has(clientUserId)) {
+        client.send(JSON.stringify(data));
+      }
+    }
+  }
+  /**
+   * Broadcast a message to a specific client
+   * @param clientId - The client ID to send to
+   * @param data - The data to send
+   */
+  broadcastToClient({ clientId, data }) {
+    const client = this.clientManager.getClient({ clientId });
+    if (!client?.ws || client.ws.readyState !== WebSocket.OPEN) {
+      log("Client not found or not connected when broadcasting to specific client", {
+        clientId
+      });
+      return;
+    }
+    client.ws.send(JSON.stringify(data));
+  }
   sendMessageError({ webSocketClientId, error }) {
     const client = this.clientManager.getClient({
       clientId: webSocketClientId