@scpxl/nodejs-framework 1.0.32 → 1.0.43

package/dist/websocket/subscriber-middleware.js

@@ -0,0 +1,200 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { Logger } from "../logger/index.js";
+async function executeWithMiddleware(handler, middleware, context) {
+  for (const mw of middleware) {
+    try {
+      const shouldContinue = mw.onBefore ? await mw.onBefore(context) : true;
+      if (!shouldContinue) {
+        Logger.info({
+          message: "Middleware skipped handler execution",
+          meta: {
+            middleware: mw.name,
+            channel: context.channel
+          }
+        });
+        return;
+      }
+    } catch (error) {
+      Logger.error({
+        message: "Middleware onBefore failed",
+        meta: {
+          middleware: mw.name,
+          channel: context.channel,
+          error: error instanceof Error ? error.message : String(error)
+        }
+      });
+      throw error;
+    }
+  }
+  let result;
+  try {
+    result = await handler(context);
+  } catch (error) {
+    for (const mw of middleware) {
+      if (!mw.onError) {
+        continue;
+      }
+      try {
+        const shouldSuppress = await mw.onError(context, error instanceof Error ? error : new Error(String(error)));
+        if (shouldSuppress) {
+          return;
+        }
+      } catch (mwError) {
+        Logger.error({
+          message: "Middleware onError failed",
+          meta: {
+            middleware: mw.name,
+            channel: context.channel,
+            error: mwError instanceof Error ? mwError.message : String(mwError)
+          }
+        });
+      }
+    }
+    throw error;
+  }
+  for (const mw of middleware) {
+    if (!mw.onAfter) {
+      continue;
+    }
+    try {
+      await mw.onAfter(context, result);
+    } catch (error) {
+      Logger.error({
+        message: "Middleware onAfter failed",
+        meta: {
+          middleware: mw.name,
+          channel: context.channel,
+          error: error instanceof Error ? error.message : String(error)
+        }
+      });
+    }
+  }
+}
+__name(executeWithMiddleware, "executeWithMiddleware");
+const loggingMiddleware = /* @__PURE__ */ __name((handlerName) => ({
+  name: "logging",
+  onBefore: /* @__PURE__ */ __name((context) => {
+    Logger.info({
+      message: `${handlerName}: Starting execution`,
+      meta: {
+        channel: context.channel
+      }
+    });
+    return true;
+  }, "onBefore"),
+  onAfter: /* @__PURE__ */ __name((context, result) => {
+    Logger.info({
+      message: `${handlerName}: Completed successfully`,
+      meta: {
+        channel: context.channel,
+        resultType: typeof result
+      }
+    });
+  }, "onAfter"),
+  onError: /* @__PURE__ */ __name((context, error) => {
+    Logger.error({
+      message: `${handlerName}: Failed`,
+      meta: {
+        channel: context.channel,
+        error: error.message
+      }
+    });
+    return false;
+  }, "onError")
+}), "loggingMiddleware");
+const timingMiddleware = /* @__PURE__ */ __name(() => {
+  const startTimes = /* @__PURE__ */ new Map();
+  return {
+    name: "timing",
+    onBefore: /* @__PURE__ */ __name((context) => {
+      startTimes.set(context.channel, Date.now());
+      return true;
+    }, "onBefore"),
+    onAfter: /* @__PURE__ */ __name((context) => {
+      const startTime = startTimes.get(context.channel);
+      if (startTime) {
+        const duration = Date.now() - startTime;
+        startTimes.delete(context.channel);
+        Logger.info({
+          message: "Handler execution timing",
+          meta: {
+            channel: context.channel,
+            durationMs: duration
+          }
+        });
+      }
+    }, "onAfter"),
+    onError: /* @__PURE__ */ __name((context) => {
+      startTimes.delete(context.channel);
+      return false;
+    }, "onError")
+  };
+}, "timingMiddleware");
+const validationMiddleware = /* @__PURE__ */ __name((validator) => ({
+  name: "validation",
+  onBefore: /* @__PURE__ */ __name(async (context) => {
+    try {
+      await validator(context.message);
+      return true;
+    } catch (error) {
+      Logger.warn({
+        message: "Message validation failed",
+        meta: {
+          channel: context.channel,
+          error: error instanceof Error ? error.message : String(error)
+        }
+      });
+      throw error;
+    }
+  }, "onBefore")
+}), "validationMiddleware");
+const rateLimitMiddleware = /* @__PURE__ */ __name((maxExecutions, windowMs) => {
+  const executionTimes = /* @__PURE__ */ new Map();
+  return {
+    name: "rate-limit",
+    onBefore: /* @__PURE__ */ __name((context) => {
+      const channel = context.channel;
+      const now = Date.now();
+      const times = executionTimes.get(channel) ?? [];
+      const recentTimes = times.filter((t) => now - t < windowMs);
+      if (recentTimes.length >= maxExecutions) {
+        Logger.warn({
+          message: "Rate limit exceeded",
+          meta: {
+            channel,
+            maxExecutions,
+            windowMs
+          }
+        });
+        return false;
+      }
+      recentTimes.push(now);
+      executionTimes.set(channel, recentTimes);
+      return true;
+    }, "onBefore")
+  };
+}, "rateLimitMiddleware");
+const errorRecoveryMiddleware = /* @__PURE__ */ __name((maxRetries = 3, _delayMs = 1e3) => ({
+  name: "error-recovery",
+  onError: /* @__PURE__ */ __name(async (context, error) => {
+    Logger.warn({
+      message: "Handler error, could implement retry logic",
+      meta: {
+        channel: context.channel,
+        error: error.message,
+        suggestedRetries: maxRetries
+      }
+    });
+    return false;
+  }, "onError")
+}), "errorRecoveryMiddleware");
+export {
+  errorRecoveryMiddleware,
+  executeWithMiddleware,
+  loggingMiddleware,
+  rateLimitMiddleware,
+  timingMiddleware,
+  validationMiddleware
+};
+//# sourceMappingURL=subscriber-middleware.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/websocket/subscriber-middleware.ts"],
+  "sourcesContent": ["import type { WebSocketSubscriberHandler, WebSocketSubscriberHandlerContext } from './websocket.interface.js';\nimport { Logger } from '../logger/index.js';\n\n/**\n * Middleware that can intercept and modify subscriber handler execution\n */\nexport interface WebSocketSubscriberMiddleware {\n  /**\n   * Unique identifier for the middleware\n   */\n  name: string;\n\n  /**\n   * Runs before the handler\n   * Return false to skip handler execution\n   */\n  onBefore?: (context: WebSocketSubscriberHandlerContext) => boolean | Promise<boolean>;\n\n  /**\n   * Runs after successful handler execution\n   */\n  onAfter?: (context: WebSocketSubscriberHandlerContext, result: unknown) => void | Promise<void>;\n\n  /**\n   * Runs on handler error\n   * Return true to suppress the error, false to rethrow\n   */\n  onError?: (context: WebSocketSubscriberHandlerContext, error: Error) => boolean | Promise<boolean>;\n}\n\n/**\n * Execute middleware pipeline and handler\n * @param handler - The handler to execute\n * @param middleware - Array of middleware to apply\n * @param context - Handler context\n */\nexport async function executeWithMiddleware(\n  handler: WebSocketSubscriberHandler,\n  middleware: WebSocketSubscriberMiddleware[],\n  context: WebSocketSubscriberHandlerContext,\n): Promise<void> {\n  // Execute \"before\" middleware\n  for (const mw of middleware) {\n    try {\n      const shouldContinue = mw.onBefore ? await mw.onBefore(context) : true;\n      if (!shouldContinue) {\n        Logger.info({\n          message: 'Middleware skipped handler execution',\n          meta: {\n            middleware: mw.name,\n            channel: context.channel,\n          },\n        });\n        return;\n      }\n    } catch (error) {\n      Logger.error({\n        message: 'Middleware onBefore failed',\n        meta: {\n          middleware: mw.name,\n          channel: context.channel,\n          error: error instanceof Error ? error.message : String(error),\n        },\n      });\n      throw error;\n    }\n  }\n\n  // Execute handler\n  let result: unknown;\n  try {\n    result = await handler(context);\n  } catch (error) {\n    // Execute \"error\" middleware\n    for (const mw of middleware) {\n      if (!mw.onError) {\n        continue;\n      }\n\n      try {\n        const shouldSuppress = await mw.onError(context, error instanceof Error ? error : new Error(String(error)));\n        if (shouldSuppress) {\n          return;\n        }\n      } catch (mwError) {\n        Logger.error({\n          message: 'Middleware onError failed',\n          meta: {\n            middleware: mw.name,\n            channel: context.channel,\n            error: mwError instanceof Error ? mwError.message : String(mwError),\n          },\n        });\n      }\n    }\n\n    throw error;\n  }\n\n  // Execute \"after\" middleware\n  for (const mw of middleware) {\n    if (!mw.onAfter) {\n      continue;\n    }\n\n    try {\n      await mw.onAfter(context, result);\n    } catch (error) {\n      Logger.error({\n        message: 'Middleware onAfter failed',\n        meta: {\n          middleware: mw.name,\n          channel: context.channel,\n          error: error instanceof Error ? error.message : String(error),\n        },\n      });\n    }\n  }\n}\n\n/**\n * Built-in middleware for logging handler execution\n */\nexport const loggingMiddleware = (handlerName: string): WebSocketSubscriberMiddleware => ({\n  name: 'logging',\n  onBefore: context => {\n    Logger.info({\n      message: `${handlerName}: Starting execution`,\n      meta: {\n        channel: context.channel,\n      },\n    });\n    return true;\n  },\n  onAfter: (context, result) => {\n    Logger.info({\n      message: `${handlerName}: Completed successfully`,\n      meta: {\n        channel: context.channel,\n        resultType: typeof result,\n      },\n    });\n  },\n  onError: (context, error) => {\n    Logger.error({\n      message: `${handlerName}: Failed`,\n      meta: {\n        channel: context.channel,\n        error: error.message,\n      },\n    });\n    return false; // Don't suppress the error\n  },\n});\n\n/**\n * Built-in middleware for timing handler execution\n */\nexport const timingMiddleware = (): WebSocketSubscriberMiddleware => {\n  const startTimes = new Map<string, number>();\n\n  return {\n    name: 'timing',\n    onBefore: context => {\n      startTimes.set(context.channel, Date.now());\n      return true;\n    },\n    onAfter: context => {\n      const startTime = startTimes.get(context.channel);\n      if (startTime) {\n        const duration = Date.now() - startTime;\n        startTimes.delete(context.channel);\n        Logger.info({\n          message: 'Handler execution timing',\n          meta: {\n            channel: context.channel,\n            durationMs: duration,\n          },\n        });\n      }\n    },\n    onError: context => {\n      startTimes.delete(context.channel);\n      return false;\n    },\n  };\n};\n\n/**\n * Built-in middleware for validating message structure\n */\nexport const validationMiddleware = (\n  validator: (message: unknown) => void | Promise<void>,\n): WebSocketSubscriberMiddleware => ({\n  name: 'validation',\n  onBefore: async context => {\n    try {\n      await validator(context.message);\n      return true;\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 * Built-in middleware for rate limiting\n */\nexport const rateLimitMiddleware = (maxExecutions: number, windowMs: number): WebSocketSubscriberMiddleware => {\n  const executionTimes = new Map<string, number[]>();\n\n  return {\n    name: 'rate-limit',\n    onBefore: context => {\n      const channel = context.channel;\n      const now = Date.now();\n      const times = executionTimes.get(channel) ?? [];\n\n      // Remove old entries\n      const recentTimes = times.filter(t => now - t < windowMs);\n\n      if (recentTimes.length >= maxExecutions) {\n        Logger.warn({\n          message: 'Rate limit exceeded',\n          meta: {\n            channel,\n            maxExecutions,\n            windowMs,\n          },\n        });\n        return false;\n      }\n\n      recentTimes.push(now);\n      executionTimes.set(channel, recentTimes);\n      return true;\n    },\n  };\n};\n\n/**\n * Built-in middleware for error handling and recovery\n */\nexport const errorRecoveryMiddleware = (maxRetries = 3, _delayMs = 1000): WebSocketSubscriberMiddleware => ({\n  name: 'error-recovery',\n  onError: async (context, error) => {\n    Logger.warn({\n      message: 'Handler error, could implement retry logic',\n      meta: {\n        channel: context.channel,\n        error: error.message,\n        suggestedRetries: maxRetries,\n      },\n    });\n    return false; // Don't suppress - let error bubble up\n  },\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/websocket/subscriber-utils.d.ts

@@ -0,0 +1,88 @@
+import type { WebSocketSubscriberHandler, WebSocketSubscriberHandlerContext, WebSocketSubscriberMatcher } from './websocket.interface.js';
+/**
+ * Utility functions for building and composing WebSocket subscriber handlers
+ */
+/**
+ * Create a predicate matcher for message properties
+ * @param key - The property key to check
+ * @param value - The expected value
+ */
+export declare function matchByProperty(key: string, value: unknown): WebSocketSubscriberMatcher;
+/**
+ * Create a predicate matcher for message property patterns
+ * @param key - The property key to check
+ * @param predicate - Function to test the value
+ */
+export declare function matchByPropertyPredicate<_T = unknown>(key: string, predicate: (value: unknown) => boolean): WebSocketSubscriberMatcher;
+/**
+ * Safely get nested property from an object
+ * @param obj - The object to search
+ * @param path - Dot-notation path (e.g., 'user.id' or 'data.items.0.name')
+ */
+export declare function getNestedProperty(obj: any, path: string): unknown;
+/**
+ * Wrap a handler with error handling
+ * @param handler - The handler to wrap
+ * @param onError - Error handler callback
+ * @param throwError - Whether to rethrow the error after handling
+ */
+export declare function withErrorHandler<TMessage = any>(handler: WebSocketSubscriberHandler<TMessage>, onError?: (error: Error, context: WebSocketSubscriberHandlerContext<TMessage>) => void | Promise<void>, _throwError?: boolean): WebSocketSubscriberHandler<TMessage>;
+/**
+ * Wrap a handler with logging
+ * @param handler - The handler to wrap
+ * @param handlerName - Name for logging purposes
+ */
+export declare function withLogging<TMessage = any>(handler: WebSocketSubscriberHandler<TMessage>, handlerName?: string): WebSocketSubscriberHandler<TMessage>;
+/**
+ * Wrap a handler with rate limiting
+ * @param handler - The handler to wrap
+ * @param maxExecutions - Max executions allowed
+ * @param windowMs - Time window in milliseconds
+ * @param onRateLimited - Optional callback when rate limited
+ */
+export declare function withRateLimit<TMessage = any>(handler: WebSocketSubscriberHandler<TMessage>, maxExecutions: number, windowMs: number, onRateLimited?: (context: WebSocketSubscriberHandlerContext<TMessage>) => void | Promise<void>): WebSocketSubscriberHandler<TMessage>;
+/**
+ * Wrap a handler with retry logic
+ * @param handler - The handler to wrap
+ * @param maxRetries - Maximum number of retries
+ * @param delayMs - Delay between retries in milliseconds
+ * @param backoffMultiplier - Multiplier for exponential backoff (default: 1, no backoff)
+ */
+export declare function withRetry<TMessage = any>(handler: WebSocketSubscriberHandler<TMessage>, maxRetries: number, delayMs: number, backoffMultiplier?: number): WebSocketSubscriberHandler<TMessage>;
+/**
+ * Compose multiple handlers into a single handler
+ * Executes handlers sequentially, passing context through each one
+ * @param handlers - Array of handlers to compose
+ */
+export declare function composeHandlers<TMessage = any>(handlers: WebSocketSubscriberHandler<TMessage>[]): WebSocketSubscriberHandler<TMessage>;
+/**
+ * Create a filter handler that conditionally executes based on a predicate
+ * @param predicate - Function that returns true if handler should execute
+ * @param handler - The handler to execute conditionally
+ */
+export declare function withFilter<TMessage = any>(predicate: (context: WebSocketSubscriberHandlerContext<TMessage>) => boolean | Promise<boolean>, handler: WebSocketSubscriberHandler<TMessage>): WebSocketSubscriberHandler<TMessage>;
+/**
+ * Validate message structure before execution
+ * @param validator - Function that validates the message and throws if invalid
+ * @param handler - The handler to wrap
+ */
+export declare function withValidation<TMessage = any>(validator: (message: TMessage) => void | Promise<void>, handler: WebSocketSubscriberHandler<TMessage>): WebSocketSubscriberHandler<TMessage>;
+/**
+ * Add metadata/context to a handler execution
+ * @param metadata - Metadata to add to context
+ * @param handler - The handler to wrap
+ */
+export declare function withMetadata<TMessage = any>(metadata: Record<string, unknown>, handler: WebSocketSubscriberHandler<TMessage>): WebSocketSubscriberHandler<TMessage>;
+/**
+ * Debounce handler execution by channel
+ * @param handler - The handler to wrap
+ * @param delayMs - Debounce delay in milliseconds
+ */
+export declare function withDebounce<TMessage = any>(handler: WebSocketSubscriberHandler<TMessage>, delayMs: number): WebSocketSubscriberHandler<TMessage>;
+/**
+ * Throttle handler execution by channel
+ * @param handler - The handler to wrap
+ * @param intervalMs - Throttle interval in milliseconds
+ */
+export declare function withThrottle<TMessage = any>(handler: WebSocketSubscriberHandler<TMessage>, intervalMs: number): WebSocketSubscriberHandler<TMessage>;
+//# sourceMappingURL=subscriber-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber-utils.d.ts","sourceRoot":"","sources":["../../src/websocket/subscriber-utils.ts"],"names":[],"mappings":"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"}

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/utils.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/websocket/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AAGhC,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;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/utils.js

@@ -1,8 +1,12 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import crypto from "node:crypto";
 import { Logger } from "../logger/index.js";
 function generateClientId() {
-  return Math.random().toString(36).substr(2, 9);
+  if (typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID().replace(/-/g, "");
+  }
+  return crypto.randomBytes(16).toString("hex");
 }
 __name(generateClientId, "generateClientId");
 function log(message, meta, options) {

package/dist/websocket/utils.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/websocket/utils.ts"],
-  "sourcesContent": ["import type WebSocket from 'ws';\nimport { Logger } from '../logger/index.js';\n\nexport interface LogOptions {\n  muteWorker?: boolean;\n}\n\nexport function generateClientId(): string {\n  return Math.random().toString(36).substr(2, 9);\n}\n\nexport function log(message: string, meta?: Record<string, unknown>, options?: LogOptions): void {\n  Logger.custom({ level: 'webSocket', message, meta, options });\n}\n\nexport function parseServerMessage(message: WebSocket.Data): Record<string, unknown> {\n  let parsedMessage;\n\n  try {\n    parsedMessage = JSON.parse(message.toString());\n  } catch {\n    throw new Error('Failed to parse JSON');\n  }\n\n  if (!parsedMessage) {\n    throw new Error('Invalid WebSocket message');\n  } else if (!parsedMessage.type) {\n    throw new Error('Missing WebSocket message type');\n  } else if (!parsedMessage.action) {\n    throw new Error('Missing WebSocket message action');\n  }\n\n  return parsedMessage;\n}\n\nexport function getRouteKey(type: string, action: string): string {\n  return `${type}:${action}`;\n}\n"],
-  "mappings": ";;AACA,SAAS,cAAc;AAMhB,SAAS,mBAA2B;AACzC,SAAO,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,GAAG,CAAC;AAC/C;AAFgB;AAIT,SAAS,IAAI,SAAiB,MAAgC,SAA4B;AAC/F,SAAO,OAAO,EAAE,OAAO,aAAa,SAAS,MAAM,QAAQ,CAAC;AAC9D;AAFgB;AAIT,SAAS,mBAAmB,SAAkD;AACnF,MAAI;AAEJ,MAAI;AACF,oBAAgB,KAAK,MAAM,QAAQ,SAAS,CAAC;AAAA,EAC/C,QAAQ;AACN,UAAM,IAAI,MAAM,sBAAsB;AAAA,EACxC;AAEA,MAAI,CAAC,eAAe;AAClB,UAAM,IAAI,MAAM,2BAA2B;AAAA,EAC7C,WAAW,CAAC,cAAc,MAAM;AAC9B,UAAM,IAAI,MAAM,gCAAgC;AAAA,EAClD,WAAW,CAAC,cAAc,QAAQ;AAChC,UAAM,IAAI,MAAM,kCAAkC;AAAA,EACpD;AAEA,SAAO;AACT;AAlBgB;AAoBT,SAAS,YAAY,MAAc,QAAwB;AAChE,SAAO,GAAG,IAAI,IAAI,MAAM;AAC1B;AAFgB;",
+  "sourcesContent": ["import crypto from 'node:crypto';\nimport type WebSocket from 'ws';\nimport { Logger } from '../logger/index.js';\n\nexport interface LogOptions {\n  muteWorker?: boolean;\n}\n\nexport function generateClientId(): string {\n  if (typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID().replace(/-/g, '');\n  }\n\n  return crypto.randomBytes(16).toString('hex');\n}\n\nexport function log(message: string, meta?: Record<string, unknown>, options?: LogOptions): void {\n  Logger.custom({ level: 'webSocket', message, meta, options });\n}\n\nexport function parseServerMessage(message: WebSocket.Data): Record<string, unknown> {\n  let parsedMessage;\n\n  try {\n    parsedMessage = JSON.parse(message.toString());\n  } catch {\n    throw new Error('Failed to parse JSON');\n  }\n\n  if (!parsedMessage) {\n    throw new Error('Invalid WebSocket message');\n  } else if (!parsedMessage.type) {\n    throw new Error('Missing WebSocket message type');\n  } else if (!parsedMessage.action) {\n    throw new Error('Missing WebSocket message action');\n  }\n\n  return parsedMessage;\n}\n\nexport function getRouteKey(type: string, action: string): string {\n  return `${type}:${action}`;\n}\n"],
+  "mappings": ";;AAAA,OAAO,YAAY;AAEnB,SAAS,cAAc;AAMhB,SAAS,mBAA2B;AACzC,MAAI,OAAO,OAAO,eAAe,YAAY;AAC3C,WAAO,OAAO,WAAW,EAAE,QAAQ,MAAM,EAAE;AAAA,EAC7C;AAEA,SAAO,OAAO,YAAY,EAAE,EAAE,SAAS,KAAK;AAC9C;AANgB;AAQT,SAAS,IAAI,SAAiB,MAAgC,SAA4B;AAC/F,SAAO,OAAO,EAAE,OAAO,aAAa,SAAS,MAAM,QAAQ,CAAC;AAC9D;AAFgB;AAIT,SAAS,mBAAmB,SAAkD;AACnF,MAAI;AAEJ,MAAI;AACF,oBAAgB,KAAK,MAAM,QAAQ,SAAS,CAAC;AAAA,EAC/C,QAAQ;AACN,UAAM,IAAI,MAAM,sBAAsB;AAAA,EACxC;AAEA,MAAI,CAAC,eAAe;AAClB,UAAM,IAAI,MAAM,2BAA2B;AAAA,EAC7C,WAAW,CAAC,cAAc,MAAM;AAC9B,UAAM,IAAI,MAAM,gCAAgC;AAAA,EAClD,WAAW,CAAC,cAAc,QAAQ;AAChC,UAAM,IAAI,MAAM,kCAAkC;AAAA,EACpD;AAEA,SAAO;AACT;AAlBgB;AAoBT,SAAS,YAAY,MAAc,QAAwB;AAChE,SAAO,GAAG,IAAI,IAAI,MAAM;AAC1B;AAFgB;",
   "names": []
 }

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

@@ -1 +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"}
+{"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;cAiFtF,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-base.js

@@ -46,7 +46,15 @@ class WebSocketBase {
       const controllerInstance = new ControllerClass(controllerDependencies);
       const controllerHandler = controllerInstance[route.action];
       const routeKey = getRouteKey(route.type, route.action);
-      this.routeHandlers.set(routeKey, controllerHandler);
+      if (typeof controllerHandler !== "function") {
+        log("Controller action not found", {
+          Controller: route.controllerName ?? ControllerClass.name,
+          Action: route.action,
+          RouteKey: routeKey
+        });
+        continue;
+      }
+      this.routeHandlers.set(routeKey, controllerHandler.bind(controllerInstance));
     }
     if (this.shouldPrintRoutes()) {
       log("Routes:", { Type: this.type });