@pawells/rxjs-events 1.0.1 → 1.1.0

package/build/event-pipeline.d.ts

@@ -0,0 +1,96 @@
+import { EventHandler } from './handler.js';
+import { TEventData } from './event-data.js';
+/**
+ * Debounces event emission from an EventHandler.
+ * Events are delayed until `ms` milliseconds have passed without any new events.
+ * Useful for expensive operations triggered by high-frequency events.
+ *
+ * @template TObject - The object type for the handler
+ * @template TEvent - The event type
+ * @param handler - EventHandler to debounce events from
+ * @param ms - Debounce delay in milliseconds
+ * @returns A new EventHandler that emits debounced events
+ *
+ * @example
+ * ```typescript
+ * const handler = new EventHandler<SearchQuery, SearchEvent>('Search');
+ * const debounced = DebounceEvents(handler, 300);
+ *
+ * // Subscribe to the debounced handler
+ * debounced.Subscribe((event) => {
+ *   console.log('Search executed after 300ms of inactivity');
+ * });
+ *
+ * handler.Trigger({ query: 'a' });
+ * handler.Trigger({ query: 'ab' });
+ * handler.Trigger({ query: 'abc' }); // Only this final query will be debounced
+ * ```
+ */
+export declare function DebounceEvents<TObject extends object = object, TEvent extends TEventData = TEventData>(handler: EventHandler<TObject, TEvent>, ms: number): EventHandler<TObject, TEvent>;
+/**
+ * Throttles event emission from an EventHandler.
+ * Events are emitted at most once per `ms` milliseconds.
+ * Guarantees that the most recent event is eventually emitted.
+ *
+ * @template TObject - The object type for the handler
+ * @template TEvent - The event type
+ * @param handler - EventHandler to throttle events from
+ * @param ms - Throttle interval in milliseconds
+ * @returns A new EventHandler that emits throttled events
+ *
+ * @example
+ * ```typescript
+ * const handler = new EventHandler<MouseEvent, PositionEvent>('MouseMove');
+ * const throttled = ThrottleEvents(handler, 100);
+ *
+ * throttled.Subscribe((event) => {
+ *   console.log('Position updated (max once per 100ms)');
+ * });
+ *
+ * // High-frequency events will be throttled
+ * for (let i = 0; i < 100; i++) {
+ *   handler.Trigger({ x: i, y: i });
+ * }
+ * ```
+ */
+export declare function ThrottleEvents<TObject extends object = object, TEvent extends TEventData = TEventData>(handler: EventHandler<TObject, TEvent>, ms: number): EventHandler<TObject, TEvent>;
+/**
+ * Pipes event payloads through a series of transform functions.
+ * Each function receives the output of the previous function and must return a value
+ * that can be passed to the next function.
+ *
+ * @template TEvent - The input event type
+ * @template TResult - The final result type after all transforms
+ * @param handler - EventHandler to pipe events from
+ * @param fns - Transform functions to apply in sequence
+ * @returns AsyncIterableIterator of transformed results
+ *
+ * @remarks
+ * Due to the underlying Pipe utility from @pawells/typescript-common accepting `(arg: any) => any`,
+ * the transform functions must use implicit typing or explicit any casts. The first function
+ * receives the event, and subsequent functions receive the output of the previous function.
+ *
+ * @example
+ * ```typescript
+ * interface MessageEvent extends TEventData {
+ *   Message: {
+ *     text: string;
+ *     userId: string;
+ *   };
+ * }
+ *
+ * const handler = new EventHandler<any, MessageEvent>('Message');
+ *
+ * // Transform events through a pipeline: extract → uppercase → log
+ * for await (const result of PipeEvents(
+ *   handler,
+ *   (event: MessageEvent) => event.Message.text,
+ *   (text: string) => text.toUpperCase(),
+ *   (text: string) => `processed: ${text}`
+ * )) {
+ *   console.log(result);
+ * }
+ * ```
+ */
+export declare function PipeEvents<TEvent extends TEventData = TEventData, TResult = any>(handler: EventHandler<any, TEvent>, ...fns: Array<(v: any) => any>): AsyncIterableIterator<TResult>;
+//# sourceMappingURL=event-pipeline.d.ts.map

package/build/event-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-pipeline.d.ts","sourceRoot":"","sources":["../src/event-pipeline.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,SAAS,UAAU,GAAG,UAAU,EACrG,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,EACtC,EAAE,EAAE,MAAM,GACR,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAS/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,SAAS,UAAU,GAAG,UAAU,EACrG,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,EACtC,EAAE,EAAE,MAAM,GACR,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAS/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAS,UAAU,GAAG,UAAU,EAAE,OAAO,GAAG,GAAG,EAC/E,OAAO,EAAE,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,EAClC,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC,GAC5B,qBAAqB,CAAC,OAAO,CAAC,CAahC"}

package/build/event-pipeline.js

@@ -0,0 +1,127 @@
+import { Debounce, Pipe, Throttle } from '@pawells/typescript-common';
+import { EventHandler } from './handler.js';
+/**
+ * Debounces event emission from an EventHandler.
+ * Events are delayed until `ms` milliseconds have passed without any new events.
+ * Useful for expensive operations triggered by high-frequency events.
+ *
+ * @template TObject - The object type for the handler
+ * @template TEvent - The event type
+ * @param handler - EventHandler to debounce events from
+ * @param ms - Debounce delay in milliseconds
+ * @returns A new EventHandler that emits debounced events
+ *
+ * @example
+ * ```typescript
+ * const handler = new EventHandler<SearchQuery, SearchEvent>('Search');
+ * const debounced = DebounceEvents(handler, 300);
+ *
+ * // Subscribe to the debounced handler
+ * debounced.Subscribe((event) => {
+ *   console.log('Search executed after 300ms of inactivity');
+ * });
+ *
+ * handler.Trigger({ query: 'a' });
+ * handler.Trigger({ query: 'ab' });
+ * handler.Trigger({ query: 'abc' }); // Only this final query will be debounced
+ * ```
+ */
+export function DebounceEvents(handler, ms) {
+    const debouncedHandler = new EventHandler(handler.Name);
+    const debouncedTrigger = Debounce((event) => {
+        // Extract payload from the event object before triggering to avoid double-wrapping
+        const payload = event[handler.Name];
+        debouncedHandler.Trigger(payload);
+    }, ms);
+    handler.Subscribe((event) => debouncedTrigger(event));
+    return debouncedHandler;
+}
+/**
+ * Throttles event emission from an EventHandler.
+ * Events are emitted at most once per `ms` milliseconds.
+ * Guarantees that the most recent event is eventually emitted.
+ *
+ * @template TObject - The object type for the handler
+ * @template TEvent - The event type
+ * @param handler - EventHandler to throttle events from
+ * @param ms - Throttle interval in milliseconds
+ * @returns A new EventHandler that emits throttled events
+ *
+ * @example
+ * ```typescript
+ * const handler = new EventHandler<MouseEvent, PositionEvent>('MouseMove');
+ * const throttled = ThrottleEvents(handler, 100);
+ *
+ * throttled.Subscribe((event) => {
+ *   console.log('Position updated (max once per 100ms)');
+ * });
+ *
+ * // High-frequency events will be throttled
+ * for (let i = 0; i < 100; i++) {
+ *   handler.Trigger({ x: i, y: i });
+ * }
+ * ```
+ */
+export function ThrottleEvents(handler, ms) {
+    const throttledHandler = new EventHandler(handler.Name);
+    const throttledTrigger = Throttle((event) => {
+        // Extract payload from the event object before triggering to avoid double-wrapping
+        const payload = event[handler.Name];
+        throttledHandler.Trigger(payload);
+    }, ms);
+    handler.Subscribe((event) => throttledTrigger(event));
+    return throttledHandler;
+}
+/**
+ * Pipes event payloads through a series of transform functions.
+ * Each function receives the output of the previous function and must return a value
+ * that can be passed to the next function.
+ *
+ * @template TEvent - The input event type
+ * @template TResult - The final result type after all transforms
+ * @param handler - EventHandler to pipe events from
+ * @param fns - Transform functions to apply in sequence
+ * @returns AsyncIterableIterator of transformed results
+ *
+ * @remarks
+ * Due to the underlying Pipe utility from @pawells/typescript-common accepting `(arg: any) => any`,
+ * the transform functions must use implicit typing or explicit any casts. The first function
+ * receives the event, and subsequent functions receive the output of the previous function.
+ *
+ * @example
+ * ```typescript
+ * interface MessageEvent extends TEventData {
+ *   Message: {
+ *     text: string;
+ *     userId: string;
+ *   };
+ * }
+ *
+ * const handler = new EventHandler<any, MessageEvent>('Message');
+ *
+ * // Transform events through a pipeline: extract → uppercase → log
+ * for await (const result of PipeEvents(
+ *   handler,
+ *   (event: MessageEvent) => event.Message.text,
+ *   (text: string) => text.toUpperCase(),
+ *   (text: string) => `processed: ${text}`
+ * )) {
+ *   console.log(result);
+ * }
+ * ```
+ */
+export function PipeEvents(handler, ...fns) {
+    return (async function* () {
+        if (fns.length === 0) {
+            for await (const event of handler) {
+                yield event;
+            }
+            return;
+        }
+        const pipeline = Pipe(...fns);
+        for await (const event of handler) {
+            yield pipeline(event);
+        }
+    })();
+}
+//# sourceMappingURL=event-pipeline.js.map

package/build/event-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-pipeline.js","sourceRoot":"","sources":["../src/event-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,cAAc,CAC7B,OAAsC,EACtC,EAAU;IAEV,MAAM,gBAAgB,GAAG,IAAI,YAAY,CAAkB,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,CAAC,KAAa,EAAE,EAAE;QACnD,mFAAmF;QACnF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAoB,CAAY,CAAC;QAC/D,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,OAAO,gBAAgB,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,cAAc,CAC7B,OAAsC,EACtC,EAAU;IAEV,MAAM,gBAAgB,GAAG,IAAI,YAAY,CAAkB,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,CAAC,KAAa,EAAE,EAAE;QACnD,mFAAmF;QACnF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAoB,CAAY,CAAC;QAC/D,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,OAAO,gBAAgB,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,UAAU,CACzB,OAAkC,EAClC,GAAG,GAA2B;IAE9B,OAAO,CAAC,KAAK,SAAS,CAAC;QACtB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBACnC,MAAM,KAAuB,CAAC;YAC/B,CAAC;YACD,OAAO;QACR,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAI,GAAuB,CAAC,CAAC;QACnD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YACnC,MAAM,QAAQ,CAAC,KAAK,CAAY,CAAC;QAClC,CAAC;IACF,CAAC,CAAC,EAAE,CAAC;AACN,CAAC"}

package/build/handler.d.ts

@@ -8,6 +8,10 @@ import { TEventFunction } from './event-function.js';
  * @template TObject - The type of data objects that can be triggered as events
  * @template TEvent - The event data type extending TEventData that will be received by subscribers
  *
+ * @remarks
+ * **Error Handling:** Subscribe-based handlers log errors to console.error and stop receiving events.
+ * For in-band error propagation, use GetAsyncIterableIterator() instead, which throws on errors.
+ *
  * @example
  * ```typescript
  * interface MessageData {
@@ -33,7 +37,7 @@ import { TEventFunction } from './event-function.js';
  * // Unsubscribe
  * handler.Unsubscribe(subscription);
  *
- * // Async iteration
+ * // Async iteration (propagates errors)
  * for await (const event of handler.GetAsyncIterableIterator()) {
  *   console.log('Async event:', event.MessageReceived.text);
  *   break; // Important: break to avoid infinite loop
@@ -49,8 +53,8 @@ export declare class EventHandler<TObject extends object = object, TEvent extend
     /**
      * Creates a new EventHandler instance.
      *
-     * @param name - The name of the event type to handle. Cannot be empty.
-     * @throws {Error} 'Event Name is Empty' - When the provided name is an empty string
+     * @param name - The name of the event type to handle. Cannot be empty or whitespace-only.
+     * @throws {Error} 'Event Name is Empty' - When the provided name is an empty string or contains only whitespace
      *
      * @example
      * ```typescript
@@ -221,5 +225,35 @@ export declare class EventHandler<TObject extends object = object, TEvent extend
      * ```
      */
     Destroy(): void;
+    /**
+     * Gets the total count of active subscriptions.
+     *
+     * @returns The number of currently active subscriptions
+     *
+     * @example
+     * ```typescript
+     * const handler = new EventHandler('TestEvent');
+     * handler.Subscribe((event) => { });
+     * handler.Subscribe((event) => { });
+     * console.log(handler.GetSubscriptionCount()); // 2
+     * ```
+     */
+    GetSubscriptionCount(): number;
+    /**
+     * Gets all subscription IDs that are currently active.
+     * The returned array is a snapshot of active IDs at the time of the call.
+     *
+     * @returns Array of active subscription IDs
+     *
+     * @example
+     * ```typescript
+     * const handler = new EventHandler('TestEvent');
+     * const id1 = handler.Subscribe((event) => { });
+     * const id2 = handler.Subscribe((event) => { });
+     * const ids = handler.GetActiveSubscriptionIds();
+     * console.log(ids); // [0, 1] or similar
+     * ```
+     */
+    GetActiveSubscriptionIds(): number[];
 }
 //# sourceMappingURL=handler.d.ts.map

package/build/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,YAAY,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,YAAY,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,SAAS,UAAU,GAAG,UAAU;IAChG;;;OAGG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;;;;;;;;;;OAWG;gBACS,IAAI,EAAE,MAAM;IAKxB,oEAAoE;IACpE,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAmC;IAEtF;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAEhE,uEAAuE;IACvE,OAAO,CAAC,OAAO,CAAa;IAE5B,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IAEnE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACY,wBAAwB,IAAI,qBAAqB,CAAC,MAAM,CAAC;IAsExE;;;;;;;;;;;;;;;;;;OAkBG;IACI,gBAAgB,IAAI,aAAa,CAAC,MAAM,CAAC;IAIhD;;;;;;;;;;;OAWG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC;IAI9D;;;;;;;;;;;;;;;;;OAiBG;IACI,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAKnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACI,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,MAAM;IA6BzD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAW9C;;;;;;;;;;OAUG;IACI,OAAO,IAAI,IAAI;CAYtB"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,YAAY,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,YAAY,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,SAAS,UAAU,GAAG,UAAU;IAChG;;;OAGG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;;;;;;;;;;OAWG;gBACS,IAAI,EAAE,MAAM;IAKxB,oEAAoE;IACpE,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAmC;IAEtF;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAEhE,uEAAuE;IACvE,OAAO,CAAC,OAAO,CAAa;IAE5B,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IAEnE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACY,wBAAwB,IAAI,qBAAqB,CAAC,MAAM,CAAC;IAsExE;;;;;;;;;;;;;;;;;;OAkBG;IACI,gBAAgB,IAAI,aAAa,CAAC,MAAM,CAAC;IAIhD;;;;;;;;;;;OAWG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC;IAI9D;;;;;;;;;;;;;;;;;OAiBG;IACI,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAKnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACI,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,MAAM;IA6BzD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAW9C;;;;;;;;;;OAUG;IACI,OAAO,IAAI,IAAI;IAatB;;;;;;;;;;;;OAYG;IACI,oBAAoB,IAAI,MAAM;IAIrC;;;;;;;;;;;;;;OAcG;IACI,wBAAwB,IAAI,MAAM,EAAE;CAG3C"}

package/build/handler.js

@@ -6,6 +6,10 @@ import { Subject } from 'rxjs';
  * @template TObject - The type of data objects that can be triggered as events
  * @template TEvent - The event data type extending TEventData that will be received by subscribers
  *
+ * @remarks
+ * **Error Handling:** Subscribe-based handlers log errors to console.error and stop receiving events.
+ * For in-band error propagation, use GetAsyncIterableIterator() instead, which throws on errors.
+ *
  * @example
  * ```typescript
  * interface MessageData {
@@ -31,7 +35,7 @@ import { Subject } from 'rxjs';
  * // Unsubscribe
  * handler.Unsubscribe(subscription);
  *
- * // Async iteration
+ * // Async iteration (propagates errors)
  * for await (const event of handler.GetAsyncIterableIterator()) {
  *   console.log('Async event:', event.MessageReceived.text);
  *   break; // Important: break to avoid infinite loop
@@ -47,8 +51,8 @@ export class EventHandler {
     /**
      * Creates a new EventHandler instance.
      *
-     * @param name - The name of the event type to handle. Cannot be empty.
-     * @throws {Error} 'Event Name is Empty' - When the provided name is an empty string
+     * @param name - The name of the event type to handle. Cannot be empty or whitespace-only.
+     * @throws {Error} 'Event Name is Empty' - When the provided name is an empty string or contains only whitespace
      *
      * @example
      * ```typescript
@@ -58,7 +62,7 @@ export class EventHandler {
      */
     constructor(name) {
         this.Name = name;
-        if (this.Name.length === 0)
+        if (this.Name.length === 0 || !this.Name.trim())
             throw new Error('Event Name is Empty');
     }
     /** Internal map storing active subscriptions by their unique IDs */
@@ -337,5 +341,39 @@ export class EventHandler {
         this._subscriptions.clear();
         this._AvailableIds.clear();
     }
+    /**
+     * Gets the total count of active subscriptions.
+     *
+     * @returns The number of currently active subscriptions
+     *
+     * @example
+     * ```typescript
+     * const handler = new EventHandler('TestEvent');
+     * handler.Subscribe((event) => { });
+     * handler.Subscribe((event) => { });
+     * console.log(handler.GetSubscriptionCount()); // 2
+     * ```
+     */
+    GetSubscriptionCount() {
+        return this._subscriptions.size;
+    }
+    /**
+     * Gets all subscription IDs that are currently active.
+     * The returned array is a snapshot of active IDs at the time of the call.
+     *
+     * @returns Array of active subscription IDs
+     *
+     * @example
+     * ```typescript
+     * const handler = new EventHandler('TestEvent');
+     * const id1 = handler.Subscribe((event) => { });
+     * const id2 = handler.Subscribe((event) => { });
+     * const ids = handler.GetActiveSubscriptionIds();
+     * console.log(ids); // [0, 1] or similar
+     * ```
+     */
+    GetActiveSubscriptionIds() {
+        return Array.from(this._subscriptions.keys());
+    }
 }
 //# sourceMappingURL=handler.js.map

package/build/handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAgB,MAAM,MAAM,CAAC;AAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,OAAO,YAAY;IACxB;;;OAGG;IACa,IAAI,CAAS;IAE7B;;;;;;;;;;;OAWG;IACH,YAAY,IAAY;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzF,CAAC;IAED,oEAAoE;IAC1D,cAAc,GAA8B,IAAI,GAAG,EAAwB,CAAC;IAEtF;;;;;OAKG;IACc,aAAa,GAAgB,IAAI,GAAG,EAAU,CAAC;IAEhE,uEAAuE;IAC/D,OAAO,GAAW,CAAC,CAAC;IAE5B,mDAAmD;IAClC,QAAQ,GAAoB,IAAI,OAAO,EAAU,CAAC;IAEnE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,KAAK,CAAC,CAAE,wBAAwB;QACtC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,OAAiC,CAAC;QACtC,IAAI,MAAgD,CAAC;QACrD,IAAI,OAAkC,CAAC;QACvC,IAAI,KAAc,CAAC;QACnB,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC5C,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;gBACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,IAAI,OAAO,EAAE,CAAC;oBACb,OAAO,EAAE,CAAC;oBACV,OAAO,GAAG,SAAS,CAAC;oBACpB,MAAM,GAAG,SAAS,CAAC;oBACnB,OAAO,GAAG,SAAS,CAAC;gBACrB,CAAC;YACF,CAAC;YACD,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;gBACd,QAAQ,GAAG,IAAI,CAAC;gBAChB,KAAK,GAAG,GAAG,CAAC;gBACZ,IAAI,MAAM,EAAE,CAAC;oBACZ,MAAM,CAAC,GAAG,CAAC,CAAC;oBACZ,OAAO,GAAG,SAAS,CAAC;oBACpB,MAAM,GAAG,SAAS,CAAC;oBACnB,OAAO,GAAG,SAAS,CAAC;gBACrB,CAAC;YACF,CAAC;YACD,QAAQ,EAAE,GAAG,EAAE;gBACd,IAAI,OAAO,EAAE,CAAC;oBACb,OAAO,EAAE,CAAC;oBACV,OAAO,GAAG,SAAS,CAAC;oBACpB,MAAM,GAAG,SAAS,CAAC;oBACnB,OAAO,GAAG,SAAS,CAAC;gBACrB,CAAC;YACF,CAAC;SACD,CAAC,CAAC;QAEH,IAAI,CAAC;YACJ,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;gBAC7B,IAAI,QAAQ,EAAE,CAAC;oBACd,MAAM,KAAK,CAAC;gBACb,CAAC;gBAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;wBACxC,OAAO,GAAG,GAAG,CAAC;wBACd,MAAM,GAAG,GAAG,CAAC;oBACd,CAAC,CAAC,CAAC;oBACH,MAAM,OAAO,CAAC;gBACf,CAAC;gBAED,IAAI,QAAQ,EAAE,CAAC;oBACd,MAAM,KAAK,CAAC;gBACb,CAAC;gBAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;oBAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBACzB,MAAM,KAAK,CAAC;oBACb,CAAC;gBACF,CAAC;qBAAM,CAAC;oBACP,MAAM;gBACP,CAAC;YACF,CAAC;QACF,CAAC;gBAAS,CAAC;YACV,YAAY,CAAC,WAAW,EAAE,CAAC;QAC5B,CAAC;IACF,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACI,gBAAgB;QACtB,OAAO,IAAI,CAAC,wBAAwB,EAAE,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;OAWG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC;QAC5B,OAAO,IAAI,CAAC,wBAAwB,EAAE,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACI,OAAO,CAAC,IAAa;QAC3B,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAY,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACI,SAAS,CAAC,OAA+B;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YACnC,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;gBACd,6DAA6D;gBAC7D,wFAAwF;gBACxF,4DAA4D;gBAC5D,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;YACxD,CAAC;SACD,CAAC,CAAC;QAEH,4CAA4C;QAC5C,IAAI,EAAU,CAAC;QAEf,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACjC,yCAAyC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;YAC7C,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAe,CAAC;YACrC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACP,0CAA0C;YAC1C,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;YAClB,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACjC,OAAO,EAAE,CAAC;IACX,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,WAAW,CAAC,YAAoB;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,CAAC,GAAG;YAAE,OAAO;QAEjB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACzC,GAAG,CAAC,WAAW,EAAE,CAAC;QAElB,oEAAoE;QACpE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;OAUG;IACI,OAAO;QACb,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAEzB,uCAAuC;QACvC,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YACzD,YAAY,CAAC,WAAW,EAAE,CAAC;QAC5B,CAAC;QAED,4CAA4C;QAC5C,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,oBAAoB;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACI,wBAAwB;QAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;CACD"}

package/build/index.d.ts

@@ -6,4 +6,7 @@ export * from './extract-event-payload.js';
 export * from './event-filter.js';
 export * from './handler.js';
 export * from './async-observable.js';
+export * from './event-operators.js';
+export * from './event-pipeline.js';
+export * from './nestjs-pubsub.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,qBAAqB,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAElC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,qBAAqB,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAElC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/build/index.js

@@ -4,4 +4,7 @@ export * from './event-filter.js';
 // IAsyncGeneratorESN is an implementation detail of AsyncObservable; not re-exported here.
 export * from './handler.js';
 export * from './async-observable.js';
+export * from './event-operators.js';
+export * from './event-pipeline.js';
+export * from './nestjs-pubsub.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,2FAA2F;AAC3F,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,2FAA2F;AAC3F,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/build/nestjs-pubsub.d.ts

@@ -0,0 +1,171 @@
+/**
+ * PubSub engine interface compatible with NestJS GraphQL subscriptions.
+ * Defines the contract that must be implemented for GraphQL subscription handling.
+ *
+ * @remarks
+ * This interface is defined locally to avoid a dependency on the graphql-subscriptions package.
+ * It implements the standard PubSubEngine interface used by NestJS GraphQL.
+ */
+export interface IPubSubEngine {
+    /**
+     * Publishes a message to a specific trigger channel.
+     * @param triggerName - The name of the trigger to publish to
+     * @param payload - The payload to publish
+     */
+    publish(triggerName: string, payload: any): Promise<void>;
+    /**
+     * Subscribes to messages on a trigger channel.
+     * @param triggerName - The name of the trigger to subscribe to
+     * @param onMessage - Callback function when a message is received
+     * @param options - Optional subscription options
+     * @returns A subscription ID that can be used to unsubscribe
+     */
+    subscribe(triggerName: string, onMessage: (payload: any) => void, options?: Record<string, unknown>): Promise<number>;
+    /**
+     * Unsubscribes from a trigger channel using the subscription ID.
+     * @param subId - The subscription ID returned from subscribe()
+     */
+    unsubscribe(subId: number): void;
+    /**
+     * Creates an async iterator for one or more trigger channels.
+     * Used by GraphQL subscriptions to iterate over published values.
+     * @param triggers - Single trigger name or array of trigger names to listen to
+     * @returns AsyncIterableIterator that yields published payloads
+     */
+    asyncIterator<T = any>(triggers: string | string[]): AsyncIterableIterator<T>;
+}
+/**
+ * Adapter that makes EventHandler compatible with NestJS GraphQL @Subscription() decorators.
+ * Implements the IPubSubEngine interface for pub/sub messaging patterns.
+ *
+ * This adapter bridges EventHandler with GraphQL subscriptions by maintaining a map of
+ * EventHandlers (one per trigger name) and coordinating subscription/publication.
+ *
+ * @remarks
+ * - No external dependencies required (graphql-subscriptions not needed)
+ * - Each trigger name gets its own EventHandler for isolation
+ * - Thread-safe subscription ID management
+ *
+ * @example
+ * ```typescript
+ * // In your NestJS GraphQL module:
+ * import { EventHandlerPubSub } from '@pawells/rxjs-events';
+ *
+ * const pubSub = new EventHandlerPubSub();
+ *
+ * // In a GraphQL resolver:
+ * @Subscription(() => MessagePayload, {
+ *   resolve: (payload) => payload,
+ * })
+ * messageSent(): AsyncIterableIterator<MessagePayload> {
+ *   return pubSub.asyncIterator<MessagePayload>('MESSAGE_SENT');
+ * }
+ *
+ * // In a mutation:
+ * @Mutation(() => MessagePayload)
+ * sendMessage(@Args('text') text: string): MessagePayload {
+ *   const payload = { text, timestamp: Date.now() };
+ *   pubSub.publish('MESSAGE_SENT', payload);
+ *   return payload;
+ * }
+ * ```
+ */
+export declare class EventHandlerPubSub implements IPubSubEngine {
+    /**
+     * Map storing EventHandlers indexed by trigger name.
+     * Each trigger maintains its own handler for event isolation.
+     */
+    private readonly _handlers;
+    /**
+     * Map storing handler subscriptions and their IDs for cleanup.
+     * Maps subscription ID to [handler, subscription ID within handler].
+     */
+    private readonly _subscriptions;
+    /**
+     * Counter for generating unique subscription IDs across all triggers.
+     */
+    private _nextSubscriptionId;
+    /**
+     * Gets or creates an EventHandler for a specific trigger name.
+     *
+     * @param triggerName - The trigger channel name
+     * @returns The EventHandler for this trigger
+     */
+    private _getOrCreateHandler;
+    /**
+     * Publishes a payload to all subscribers of a trigger.
+     *
+     * @param triggerName - The trigger channel name
+     * @param payload - The payload to publish
+     */
+    publish(triggerName: string, payload: any): Promise<void>;
+    /**
+     * Subscribes to a trigger channel and calls the callback when messages are published.
+     *
+     * @param triggerName - The trigger channel name
+     * @param onMessage - Callback function that receives the published payload
+     * @param _options - Optional subscription options (not used in current implementation)
+     * @returns Unique subscription ID for later unsubscription
+     */
+    subscribe(triggerName: string, onMessage: (payload: any) => void, _options?: Record<string, unknown>): Promise<number>;
+    /**
+     * Unsubscribes from a trigger channel.
+     *
+     * @param subId - The subscription ID returned from subscribe()
+     */
+    unsubscribe(subId: number): void;
+    /**
+     * Creates an async iterator for one or more trigger channels.
+     * Useful for GraphQL subscription resolvers.
+     *
+     * @template T - The type of values yielded by the iterator
+     * @param triggers - Single trigger name or array of trigger names
+     * @returns AsyncIterableIterator that yields published payloads
+     *
+     * @example
+     * ```typescript
+     * // Subscribe to a single trigger
+     * const iterator = pubSub.asyncIterator('USER_CREATED');
+     *
+     * // Subscribe to multiple triggers
+     * const iterator = pubSub.asyncIterator(['USER_CREATED', 'USER_UPDATED']);
+     * ```
+     */
+    asyncIterator<T = any>(triggers: string | string[]): AsyncIterableIterator<T>;
+    /**
+     * Merges async iterators from multiple trigger handlers.
+     * Events from any trigger are yielded as they arrive.
+     *
+     * @template T - The type of values yielded
+     * @param triggers - Array of trigger names
+     * @returns Merged async iterator that yields events from all triggers concurrently
+     */
+    private _mergeAsyncIterators;
+}
+/**
+ * Wraps an async iterator with a filter predicate for use with GraphQL subscriptions.
+ * Mirrors the withFilter helper from graphql-subscriptions.
+ *
+ * @template T - The type of values in the iterator
+ * @param asyncIteratorFn - Function that returns an async iterator
+ * @param filterFn - Predicate function that determines which values to yield (async functions supported)
+ * @returns Filtered async iterator
+ *
+ * @example
+ * ```typescript
+ * const pubSub = new EventHandlerPubSub();
+ *
+ * // In a GraphQL resolver:
+ * @Subscription(() => UserPayload)
+ * userUpdated(
+ *   @Args('userId') userId: string
+ * ): AsyncIterableIterator<UserPayload> {
+ *   return WithFilter(
+ *     () => pubSub.asyncIterator<UserPayload>('USER_UPDATED'),
+ *     (payload: UserPayload) => payload.userId === userId
+ *   );
+ * }
+ * ```
+ */
+export declare function WithFilter<T>(asyncIteratorFn: () => AsyncIterableIterator<T>, filterFn: (payload: T) => boolean | Promise<boolean>): AsyncIterableIterator<T>;
+//# sourceMappingURL=nestjs-pubsub.d.ts.map

package/build/nestjs-pubsub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs-pubsub.d.ts","sourceRoot":"","sources":["../src/nestjs-pubsub.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC7B;;;;OAIG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtH;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;;OAKG;IACH,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;CAC9E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACvD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkD;IAE5E;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4D;IAE3F;;OAEG;IACH,OAAO,CAAC,mBAAmB,CAAK;IAEhC;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;;;OAKG;IACU,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtE;;;;;;;OAOG;IACU,SAAS,CACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,EACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC;IAYlB;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASvC;;;;;;;;;;;;;;;;OAgBG;IACI,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAoBpF;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;CA6C5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC3B,eAAe,EAAE,MAAM,qBAAqB,CAAC,CAAC,CAAC,EAC/C,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAClD,qBAAqB,CAAC,CAAC,CAAC,CAa1B"}