@scpxl/nodejs-framework 1.0.42 → 1.0.43

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

@@ -1,4 +1,4 @@
-import type { WebSocketSubscriberDefinition, WebSocketSubscriberHandler, WebSocketSubscriberMatcher } from './websocket.interface.js';
+import type { WebSocketSubscriberDefinition, WebSocketSubscriberHandler, WebSocketSubscriberHandlerContext, WebSocketSubscriberMatcher } from './websocket.interface.js';
 type ChannelConfig = {
     channel: string;
     channels?: never;
@@ -14,10 +14,17 @@ type MatchConfig = {
     channel?: never;
     channels?: never;
 };
+type MiddlewareConfig = Array<{
+    name: string;
+    onBefore?: (context: WebSocketSubscriberHandlerContext) => boolean | Promise<boolean>;
+    onAfter?: (context: WebSocketSubscriberHandlerContext, result: unknown) => void | Promise<void>;
+    onError?: (context: WebSocketSubscriberHandlerContext, error: Error) => boolean | Promise<boolean>;
+}>;
 type BaseConfig = {
     name?: string;
     description?: string;
     priority?: number;
+    middleware?: MiddlewareConfig;
     handle: WebSocketSubscriberHandler;
 };
 export type DefineWebSocketSubscriberConfig = BaseConfig & (ChannelConfig | ChannelsConfig | MatchConfig);

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

@@ -1 +1 @@
-{"version":3,"file":"define-subscriber.d.ts","sourceRoot":"","sources":["../../src/websocket/define-subscriber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAElC,KAAK,aAAa,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,KAAK,EAAE,0BAA0B,GAAG,0BAA0B,EAAE,CAAC;IACjE,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,0BAA0B,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,UAAU,GAAG,CAAC,aAAa,GAAG,cAAc,GAAG,WAAW,CAAC,CAAC;AAE1G,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,+BAA+B,GAAG,6BAA6B,CA4BhH"}
+{"version":3,"file":"define-subscriber.d.ts","sourceRoot":"","sources":["../../src/websocket/define-subscriber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,iCAAiC,EACjC,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAElC,KAAK,aAAa,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,KAAK,EAAE,0BAA0B,GAAG,0BAA0B,EAAE,CAAC;IACjE,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,CAAC;AAEF,KAAK,gBAAgB,GAAG,KAAK,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,iCAAiC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,iCAAiC,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChG,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,iCAAiC,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpG,CAAC,CAAC;AAEH,KAAK,UAAU,GAAG;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,MAAM,EAAE,0BAA0B,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,UAAU,GAAG,CAAC,aAAa,GAAG,cAAc,GAAG,WAAW,CAAC,CAAC;AAE1G,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,+BAA+B,GAAG,6BAA6B,CA6BhH"}

package/dist/websocket/define-subscriber.js

@@ -23,7 +23,8 @@ function defineWebSocketSubscriber(config) {
     priority: config.priority,
     channels,
     matchers,
-    handle: config.handle
+    handle: config.handle,
+    middleware: config.middleware
   };
 }
 __name(defineWebSocketSubscriber, "defineWebSocketSubscriber");

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/websocket/define-subscriber.ts"],
-  "sourcesContent": ["import type {\n  WebSocketSubscriberDefinition,\n  WebSocketSubscriberHandler,\n  WebSocketSubscriberMatcher,\n} from './websocket.interface.js';\n\ntype ChannelConfig = {\n  channel: string;\n  channels?: never;\n  match?: never;\n};\n\ntype ChannelsConfig = {\n  channels: string[];\n  channel?: never;\n  match?: never;\n};\n\ntype MatchConfig = {\n  match: WebSocketSubscriberMatcher | WebSocketSubscriberMatcher[];\n  channel?: never;\n  channels?: never;\n};\n\ntype BaseConfig = {\n  name?: string;\n  description?: string;\n  priority?: number;\n  handle: WebSocketSubscriberHandler;\n};\n\nexport type DefineWebSocketSubscriberConfig = BaseConfig & (ChannelConfig | ChannelsConfig | MatchConfig);\n\nexport function defineWebSocketSubscriber(config: DefineWebSocketSubscriberConfig): WebSocketSubscriberDefinition {\n  let matchers: WebSocketSubscriberMatcher[] = [];\n  if ('match' in config) {\n    const matchConfig = config as MatchConfig & BaseConfig;\n    matchers = Array.isArray(matchConfig.match) ? [...matchConfig.match] : [matchConfig.match];\n  }\n\n  let channels: string[] = [];\n  if ('channel' in config) {\n    const channelConfig = config as ChannelConfig & BaseConfig;\n    channels = [channelConfig.channel];\n  } else if ('channels' in config) {\n    const channelsConfig = config as ChannelsConfig & BaseConfig;\n    channels = [...channelsConfig.channels];\n  }\n\n  if (channels.length === 0 && matchers.length === 0) {\n    throw new Error('defineWebSocketSubscriber requires either channel(s) or a match function.');\n  }\n\n  return {\n    name: config.name,\n    description: config.description,\n    priority: config.priority,\n    channels,\n    matchers,\n    handle: config.handle,\n  };\n}\n"],
-  "mappings": ";;AAiCO,SAAS,0BAA0B,QAAwE;AAChH,MAAI,WAAyC,CAAC;AAC9C,MAAI,WAAW,QAAQ;AACrB,UAAM,cAAc;AACpB,eAAW,MAAM,QAAQ,YAAY,KAAK,IAAI,CAAC,GAAG,YAAY,KAAK,IAAI,CAAC,YAAY,KAAK;AAAA,EAC3F;AAEA,MAAI,WAAqB,CAAC;AAC1B,MAAI,aAAa,QAAQ;AACvB,UAAM,gBAAgB;AACtB,eAAW,CAAC,cAAc,OAAO;AAAA,EACnC,WAAW,cAAc,QAAQ;AAC/B,UAAM,iBAAiB;AACvB,eAAW,CAAC,GAAG,eAAe,QAAQ;AAAA,EACxC;AAEA,MAAI,SAAS,WAAW,KAAK,SAAS,WAAW,GAAG;AAClD,UAAM,IAAI,MAAM,2EAA2E;AAAA,EAC7F;AAEA,SAAO;AAAA,IACL,MAAM,OAAO;AAAA,IACb,aAAa,OAAO;AAAA,IACpB,UAAU,OAAO;AAAA,IACjB;AAAA,IACA;AAAA,IACA,QAAQ,OAAO;AAAA,EACjB;AACF;AA5BgB;",
+  "sourcesContent": ["import type {\n  WebSocketSubscriberDefinition,\n  WebSocketSubscriberHandler,\n  WebSocketSubscriberHandlerContext,\n  WebSocketSubscriberMatcher,\n} from './websocket.interface.js';\n\ntype ChannelConfig = {\n  channel: string;\n  channels?: never;\n  match?: never;\n};\n\ntype ChannelsConfig = {\n  channels: string[];\n  channel?: never;\n  match?: never;\n};\n\ntype MatchConfig = {\n  match: WebSocketSubscriberMatcher | WebSocketSubscriberMatcher[];\n  channel?: never;\n  channels?: never;\n};\n\ntype MiddlewareConfig = Array<{\n  name: string;\n  onBefore?: (context: WebSocketSubscriberHandlerContext) => boolean | Promise<boolean>;\n  onAfter?: (context: WebSocketSubscriberHandlerContext, result: unknown) => void | Promise<void>;\n  onError?: (context: WebSocketSubscriberHandlerContext, error: Error) => boolean | Promise<boolean>;\n}>;\n\ntype BaseConfig = {\n  name?: string;\n  description?: string;\n  priority?: number;\n  middleware?: MiddlewareConfig;\n  handle: WebSocketSubscriberHandler;\n};\n\nexport type DefineWebSocketSubscriberConfig = BaseConfig & (ChannelConfig | ChannelsConfig | MatchConfig);\n\nexport function defineWebSocketSubscriber(config: DefineWebSocketSubscriberConfig): WebSocketSubscriberDefinition {\n  let matchers: WebSocketSubscriberMatcher[] = [];\n  if ('match' in config) {\n    const matchConfig = config as MatchConfig & BaseConfig;\n    matchers = Array.isArray(matchConfig.match) ? [...matchConfig.match] : [matchConfig.match];\n  }\n\n  let channels: string[] = [];\n  if ('channel' in config) {\n    const channelConfig = config as ChannelConfig & BaseConfig;\n    channels = [channelConfig.channel];\n  } else if ('channels' in config) {\n    const channelsConfig = config as ChannelsConfig & BaseConfig;\n    channels = [...channelsConfig.channels];\n  }\n\n  if (channels.length === 0 && matchers.length === 0) {\n    throw new Error('defineWebSocketSubscriber requires either channel(s) or a match function.');\n  }\n\n  return {\n    name: config.name,\n    description: config.description,\n    priority: config.priority,\n    channels,\n    matchers,\n    handle: config.handle,\n    middleware: config.middleware,\n  };\n}\n"],
+  "mappings": ";;AA0CO,SAAS,0BAA0B,QAAwE;AAChH,MAAI,WAAyC,CAAC;AAC9C,MAAI,WAAW,QAAQ;AACrB,UAAM,cAAc;AACpB,eAAW,MAAM,QAAQ,YAAY,KAAK,IAAI,CAAC,GAAG,YAAY,KAAK,IAAI,CAAC,YAAY,KAAK;AAAA,EAC3F;AAEA,MAAI,WAAqB,CAAC;AAC1B,MAAI,aAAa,QAAQ;AACvB,UAAM,gBAAgB;AACtB,eAAW,CAAC,cAAc,OAAO;AAAA,EACnC,WAAW,cAAc,QAAQ;AAC/B,UAAM,iBAAiB;AACvB,eAAW,CAAC,GAAG,eAAe,QAAQ;AAAA,EACxC;AAEA,MAAI,SAAS,WAAW,KAAK,SAAS,WAAW,GAAG;AAClD,UAAM,IAAI,MAAM,2EAA2E;AAAA,EAC7F;AAEA,SAAO;AAAA,IACL,MAAM,OAAO;AAAA,IACb,aAAa,OAAO;AAAA,IACpB,UAAU,OAAO;AAAA,IACjB;AAAA,IACA;AAAA,IACA,QAAQ,OAAO;AAAA,IACf,YAAY,OAAO;AAAA,EACrB;AACF;AA7BgB;",
   "names": []
 }

package/dist/websocket/index.d.ts

@@ -8,4 +8,8 @@ export type { WebSocketMessage, WebSocketServiceOptions } from './websocket-serv
 export { WebSocketAuthService } from './websocket-auth.js';
 export type { WebSocketAuthResult } from './websocket-auth.js';
 export { defineWebSocketSubscriber } from './define-subscriber.js';
+export { matchByProperty, matchByPropertyPredicate, getNestedProperty, withErrorHandler, withLogging, withRateLimit, withRetry, composeHandlers, withFilter, withValidation, withMetadata, withDebounce, withThrottle, } from './subscriber-utils.js';
+export { executeWithMiddleware } from './subscriber-middleware.js';
+export type { WebSocketSubscriberMiddleware } from './subscriber-middleware.js';
+export { loggingMiddleware, timingMiddleware, validationMiddleware, rateLimitMiddleware, errorRecoveryMiddleware, } from './subscriber-middleware.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,YAAY,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,iCAAiC,EACjC,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAClC,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;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}
+{"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,YAAY,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,iCAAiC,EACjC,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAClC,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;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,SAAS,EACT,eAAe,EACf,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC"}

package/dist/websocket/index.js

@@ -4,12 +4,54 @@ import { default as default3 } from "./controller/client/base.js";
 import { WebSocketService } from "./websocket-service.js";
 import { WebSocketAuthService } from "./websocket-auth.js";
 import { defineWebSocketSubscriber } from "./define-subscriber.js";
+import {
+  matchByProperty,
+  matchByPropertyPredicate,
+  getNestedProperty,
+  withErrorHandler,
+  withLogging,
+  withRateLimit,
+  withRetry,
+  composeHandlers,
+  withFilter,
+  withValidation,
+  withMetadata,
+  withDebounce,
+  withThrottle
+} from "./subscriber-utils.js";
+import { executeWithMiddleware } from "./subscriber-middleware.js";
+import {
+  loggingMiddleware,
+  timingMiddleware,
+  validationMiddleware,
+  rateLimitMiddleware,
+  errorRecoveryMiddleware
+} from "./subscriber-middleware.js";
 export {
   WebSocketAuthService,
   default3 as WebSocketClientBaseController,
   WebSocketRedisSubscriberEvent,
   default2 as WebSocketServerBaseController,
   WebSocketService,
-  defineWebSocketSubscriber
+  composeHandlers,
+  defineWebSocketSubscriber,
+  errorRecoveryMiddleware,
+  executeWithMiddleware,
+  getNestedProperty,
+  loggingMiddleware,
+  matchByProperty,
+  matchByPropertyPredicate,
+  rateLimitMiddleware,
+  timingMiddleware,
+  validationMiddleware,
+  withDebounce,
+  withErrorHandler,
+  withFilter,
+  withLogging,
+  withMetadata,
+  withRateLimit,
+  withRetry,
+  withThrottle,
+  withValidation
 };
 //# sourceMappingURL=index.js.map

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 type {\n  WebSocketSubscriberDefinition,\n  WebSocketSubscriberHandler,\n  WebSocketSubscriberHandlerContext,\n  WebSocketSubscriberMatcher,\n  WebSocketSubscriberHandlersConfig,\n} 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';\nexport { defineWebSocketSubscriber } from './define-subscriber.js';\n"],
-  "mappings": "AACA,SAAS,qCAAqC;AAQ9C,SAAoB,WAAXA,gBAAgD;AACzD,SAAoB,WAAXA,gBAAgD;AACzD,SAAS,wBAAwB;AAEjC,SAAS,4BAA4B;AAErC,SAAS,iCAAiC;",
+  "sourcesContent": ["export type { WebSocketRoute } from './websocket.interface.js';\nexport { WebSocketRedisSubscriberEvent } from './websocket.interface.js';\nexport type {\n  WebSocketSubscriberDefinition,\n  WebSocketSubscriberHandler,\n  WebSocketSubscriberHandlerContext,\n  WebSocketSubscriberMatcher,\n  WebSocketSubscriberHandlersConfig,\n} 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';\nexport { defineWebSocketSubscriber } from './define-subscriber.js';\n\n// WebSocket subscriber utilities\nexport {\n  matchByProperty,\n  matchByPropertyPredicate,\n  getNestedProperty,\n  withErrorHandler,\n  withLogging,\n  withRateLimit,\n  withRetry,\n  composeHandlers,\n  withFilter,\n  withValidation,\n  withMetadata,\n  withDebounce,\n  withThrottle,\n} from './subscriber-utils.js';\n\n// WebSocket subscriber middleware\nexport { executeWithMiddleware } from './subscriber-middleware.js';\nexport type { WebSocketSubscriberMiddleware } from './subscriber-middleware.js';\nexport {\n  loggingMiddleware,\n  timingMiddleware,\n  validationMiddleware,\n  rateLimitMiddleware,\n  errorRecoveryMiddleware,\n} from './subscriber-middleware.js';\n"],
+  "mappings": "AACA,SAAS,qCAAqC;AAQ9C,SAAoB,WAAXA,gBAAgD;AACzD,SAAoB,WAAXA,gBAAgD;AACzD,SAAS,wBAAwB;AAEjC,SAAS,4BAA4B;AAErC,SAAS,iCAAiC;AAG1C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,6BAA6B;AAEtC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;",
   "names": ["default"]
 }

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

@@ -0,0 +1,52 @@
+import type { WebSocketSubscriberHandler, WebSocketSubscriberHandlerContext } from './websocket.interface.js';
+/**
+ * Middleware that can intercept and modify subscriber handler execution
+ */
+export interface WebSocketSubscriberMiddleware {
+    /**
+     * Unique identifier for the middleware
+     */
+    name: string;
+    /**
+     * Runs before the handler
+     * Return false to skip handler execution
+     */
+    onBefore?: (context: WebSocketSubscriberHandlerContext) => boolean | Promise<boolean>;
+    /**
+     * Runs after successful handler execution
+     */
+    onAfter?: (context: WebSocketSubscriberHandlerContext, result: unknown) => void | Promise<void>;
+    /**
+     * Runs on handler error
+     * Return true to suppress the error, false to rethrow
+     */
+    onError?: (context: WebSocketSubscriberHandlerContext, error: Error) => boolean | Promise<boolean>;
+}
+/**
+ * Execute middleware pipeline and handler
+ * @param handler - The handler to execute
+ * @param middleware - Array of middleware to apply
+ * @param context - Handler context
+ */
+export declare function executeWithMiddleware(handler: WebSocketSubscriberHandler, middleware: WebSocketSubscriberMiddleware[], context: WebSocketSubscriberHandlerContext): Promise<void>;
+/**
+ * Built-in middleware for logging handler execution
+ */
+export declare const loggingMiddleware: (handlerName: string) => WebSocketSubscriberMiddleware;
+/**
+ * Built-in middleware for timing handler execution
+ */
+export declare const timingMiddleware: () => WebSocketSubscriberMiddleware;
+/**
+ * Built-in middleware for validating message structure
+ */
+export declare const validationMiddleware: (validator: (message: unknown) => void | Promise<void>) => WebSocketSubscriberMiddleware;
+/**
+ * Built-in middleware for rate limiting
+ */
+export declare const rateLimitMiddleware: (maxExecutions: number, windowMs: number) => WebSocketSubscriberMiddleware;
+/**
+ * Built-in middleware for error handling and recovery
+ */
+export declare const errorRecoveryMiddleware: (maxRetries?: number, _delayMs?: number) => WebSocketSubscriberMiddleware;
+//# sourceMappingURL=subscriber-middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber-middleware.d.ts","sourceRoot":"","sources":["../../src/websocket/subscriber-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAC;AAG9G;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,iCAAiC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtF;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,iCAAiC,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhG;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,iCAAiC,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpG;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,0BAA0B,EACnC,UAAU,EAAE,6BAA6B,EAAE,EAC3C,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,IAAI,CAAC,CA8Ef;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,aAAa,MAAM,KAAG,6BA8BtD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,6BA4BnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,WAAW,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KACpD,6BAiBD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,eAAe,MAAM,EAAE,UAAU,MAAM,KAAG,6BA8B7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,mBAAc,EAAE,iBAAe,KAAG,6BAaxE,CAAC"}

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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"}