@procedures/client 0.0.0-stage → 0.1.0

package/dist/events/bus.js

@@ -0,0 +1,511 @@
+/**
+ * Event Bus Implementation
+ *
+ * Central pub/sub system for streaming coordination.
+ */
+/** The error of a wait that its signal ended. */
+function abortedError(channel) {
+    const error = new Error(`The wait on channel "${channel}" was aborted`);
+    error.name = "AbortError";
+    return error;
+}
+// =============================================================================
+// Event Bus Implementation
+// =============================================================================
+/**
+ * Default event bus implementation.
+ * Supports pub/sub messaging with async iteration.
+ */
+export class DefaultEventBus {
+    subscribers = new Map();
+    buffer = new Map();
+    /** For each channel, a function per open stream that ends it (for `clear()`). */
+    streamEnders = new Map();
+    options;
+    constructor(options = {}) {
+        this.options = {
+            bufferSize: options.bufferSize ?? 0,
+            onError: options.onError ?? ((error, channel) => {
+                console.error(`EventBus error on channel "${channel}":`, error);
+            }),
+            debug: options.debug ?? false,
+        };
+    }
+    /**
+     * Emit an event on a channel.
+     */
+    emit(channel, data) {
+        if (this.options.debug) {
+            console.log(`[EventBus] emit "${channel}":`, data);
+        }
+        // Buffer event if configured
+        if (this.options.bufferSize > 0) {
+            const channelBuffer = this.buffer.get(channel) ?? [];
+            channelBuffer.push(data);
+            // Trim buffer to max size
+            while (channelBuffer.length > this.options.bufferSize) {
+                channelBuffer.shift();
+            }
+            this.buffer.set(channel, channelBuffer);
+        }
+        // Notify subscribers
+        const channelSubs = this.subscribers.get(channel);
+        if (!channelSubs)
+            return;
+        for (const handler of channelSubs) {
+            try {
+                const result = handler(data);
+                // Handle async handlers
+                if (result instanceof Promise) {
+                    result.catch((error) => this.options.onError(error, channel));
+                }
+            }
+            catch (error) {
+                this.options.onError(error instanceof Error ? error : new Error(String(error)), channel);
+            }
+        }
+    }
+    /**
+     * Subscribe to events on a channel.
+     */
+    on(channel, handler) {
+        if (this.options.debug) {
+            console.log(`[EventBus] subscribe "${channel}"`);
+        }
+        let channelSubs = this.subscribers.get(channel);
+        if (!channelSubs) {
+            channelSubs = new Set();
+            this.subscribers.set(channel, channelSubs);
+        }
+        channelSubs.add(handler);
+        // Replay buffered events if any
+        const buffered = this.buffer.get(channel);
+        if (buffered && buffered.length > 0) {
+            for (const data of buffered) {
+                try {
+                    const result = handler(data);
+                    if (result instanceof Promise) {
+                        result.catch((error) => this.options.onError(error, channel));
+                    }
+                }
+                catch (error) {
+                    this.options.onError(error instanceof Error ? error : new Error(String(error)), channel);
+                }
+            }
+        }
+        // The unsubscribe function works once, and removes only the set it added to. (Before, a
+        // repeated call of an old unsubscribe removed the set of a newer subscriber: deep dive CORE-15.)
+        let subscribed = true;
+        return () => {
+            if (!subscribed)
+                return;
+            subscribed = false;
+            if (this.options.debug) {
+                console.log(`[EventBus] unsubscribe "${channel}"`);
+            }
+            channelSubs.delete(handler);
+            // Clean up empty channel sets
+            if (channelSubs.size === 0 && this.subscribers.get(channel) === channelSubs) {
+                this.subscribers.delete(channel);
+            }
+        };
+    }
+    /**
+     * Subscribe to a single event on a channel. On a buffered channel, the first buffered event
+     * resolves the promise. When the signal aborts first, the promise rejects with an `AbortError`.
+     */
+    once(channel, options = {}) {
+        const { signal } = options;
+        return new Promise((resolve, reject) => {
+            if (signal?.aborted) {
+                reject(abortedError(channel));
+                return;
+            }
+            let settled = false;
+            let unsubscribe;
+            const onAbort = () => {
+                if (settled)
+                    return;
+                settled = true;
+                unsubscribe?.();
+                reject(abortedError(channel));
+            };
+            // on() can replay a buffered event before it returns: the handler must not need
+            // `unsubscribe` yet (before, it threw a ReferenceError, and the promise never settled)
+            unsubscribe = this.on(channel, (data) => {
+                if (settled)
+                    return;
+                settled = true;
+                unsubscribe?.();
+                signal?.removeEventListener("abort", onAbort);
+                resolve(data);
+            });
+            if (settled) {
+                unsubscribe();
+                return;
+            }
+            signal?.addEventListener("abort", onAbort, { once: true });
+        });
+    }
+    /**
+     * Create an async iterable for a channel. The stream ends when the reader stops, when the
+     * signal of the options aborts, or when `clear()` removes the channel.
+     */
+    stream(channel, options = {}) {
+        const self = this;
+        const { signal } = options;
+        return {
+            [Symbol.asyncIterator]() {
+                const queue = [];
+                let resolve = null;
+                let done = signal?.aborted ?? false;
+                // Subscribe to channel
+                const unsubscribe = done
+                    ? () => { }
+                    : self.on(channel, (data) => {
+                        if (done)
+                            return;
+                        if (resolve) {
+                            // Someone is waiting, resolve immediately
+                            const r = resolve;
+                            resolve = null;
+                            r({ value: data, done: false });
+                        }
+                        else {
+                            // Queue for later
+                            queue.push(data);
+                        }
+                    });
+                // End the stream: no more events, and a waiting reader gets `done`
+                const end = () => {
+                    if (done)
+                        return;
+                    done = true;
+                    unsubscribe();
+                    signal?.removeEventListener("abort", end);
+                    self.streamEnders.get(channel)?.delete(end);
+                    const r = resolve;
+                    resolve = null;
+                    r?.({ value: undefined, done: true });
+                };
+                if (!done) {
+                    signal?.addEventListener("abort", end, { once: true });
+                    let enders = self.streamEnders.get(channel);
+                    if (!enders) {
+                        enders = new Set();
+                        self.streamEnders.set(channel, enders);
+                    }
+                    enders.add(end);
+                }
+                return {
+                    async next() {
+                        // If we have queued items, return one
+                        if (queue.length > 0) {
+                            return { value: queue.shift(), done: false };
+                        }
+                        if (done) {
+                            return { value: undefined, done: true };
+                        }
+                        // Wait for next event
+                        return new Promise((r) => {
+                            resolve = r;
+                        });
+                    },
+                    async return() {
+                        queue.length = 0;
+                        end();
+                        return { value: undefined, done: true };
+                    },
+                    async throw(error) {
+                        queue.length = 0;
+                        end();
+                        throw error;
+                    },
+                };
+            },
+        };
+    }
+    /**
+     * Get the number of subscribers on a channel.
+     */
+    subscriberCount(channel) {
+        return this.subscribers.get(channel)?.size ?? 0;
+    }
+    /**
+     * Check if a channel has any subscribers.
+     */
+    hasSubscribers(channel) {
+        return this.subscriberCount(channel) > 0;
+    }
+    /**
+     * Get all active channel names.
+     */
+    channels() {
+        return Array.from(this.subscribers.keys());
+    }
+    /**
+     * Remove all subscribers from a channel.
+     */
+    clear(channel) {
+        if (this.options.debug) {
+            console.log(`[EventBus] clear "${channel}"`);
+        }
+        this.subscribers.delete(channel);
+        this.buffer.delete(channel);
+        // The streams of the channel end: before, their readers waited forever (deep dive CORE-15)
+        for (const end of [...(this.streamEnders.get(channel) ?? [])])
+            end();
+        this.streamEnders.delete(channel);
+    }
+    /**
+     * Remove all subscribers from all channels.
+     */
+    clearAll() {
+        if (this.options.debug) {
+            console.log("[EventBus] clearAll");
+        }
+        this.subscribers.clear();
+        this.buffer.clear();
+        for (const enders of [...this.streamEnders.values()]) {
+            for (const end of [...enders])
+                end();
+        }
+        this.streamEnders.clear();
+    }
+}
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Create a new event bus instance.
+ *
+ * @param options - Event bus options
+ * @returns EventBus instance
+ *
+ * @example
+ * ```typescript
+ * const bus = createEventBus();
+ *
+ * bus.on("updates", (data) => console.log(data));
+ * bus.emit("updates", { message: "Hello" });
+ * ```
+ */
+export function createEventBus(options) {
+    return new DefaultEventBus(options);
+}
+/**
+ * Create a typed event bus with predefined channels.
+ *
+ * @param options - Event bus options
+ * @returns TypedEventBus instance
+ *
+ * @example
+ * ```typescript
+ * interface MyChannels {
+ *   "user:created": { id: string; name: string };
+ *   "user:updated": User;
+ * }
+ *
+ * const bus = createTypedEventBus<MyChannels>();
+ *
+ * // Type-safe
+ * bus.emit("user:created", { id: "1", name: "John" });
+ * bus.on("user:created", (user) => console.log(user.name));
+ * ```
+ */
+export function createTypedEventBus(options) {
+    return new DefaultEventBus(options);
+}
+// =============================================================================
+// Global Event Bus
+// =============================================================================
+/**
+ * Global event bus singleton.
+ * Use for application-wide event coordination.
+ */
+let globalBus;
+/**
+ * Get or create the global event bus.
+ *
+ * @param options - Options for creating the bus (only used on first call)
+ * @returns Global EventBus instance
+ */
+export function getGlobalEventBus(options) {
+    if (!globalBus) {
+        globalBus = createEventBus(options);
+    }
+    return globalBus;
+}
+/**
+ * Reset the global event bus.
+ * Useful for testing.
+ */
+export function resetGlobalEventBus() {
+    globalBus?.clearAll();
+    globalBus = undefined;
+}
+/**
+ * A view of a bus whose `stream()` and `once()` use a signal when the caller gives none. The
+ * context of a procedure gets this view: when the invocation aborts, the handler's waits on
+ * the bus end, and the handler can finish (deep dive CORE-15).
+ *
+ * @param bus - The event bus
+ * @param signal - The signal of the invocation
+ * @returns An EventBus that shares the subscribers of `bus`
+ */
+export function withEventBusSignal(bus, signal) {
+    const waitOptions = (options) => ({ signal: options?.signal ?? signal });
+    return {
+        emit: (channel, data) => bus.emit(channel, data),
+        on: (channel, handler) => bus.on(channel, handler),
+        once: (channel, options) => bus.once(channel, waitOptions(options)),
+        stream: (channel, options) => bus.stream(channel, waitOptions(options)),
+        subscriberCount: (channel) => bus.subscriberCount(channel),
+        hasSubscribers: (channel) => bus.hasSubscribers(channel),
+        channels: () => bus.channels(),
+        clear: (channel) => bus.clear(channel),
+        clearAll: () => bus.clearAll(),
+    };
+}
+// =============================================================================
+// Utilities
+// =============================================================================
+/**
+ * Create a channel prefix helper for namespaced events.
+ *
+ * @param prefix - Prefix for all channels
+ * @returns Object with prefixed emit/on/stream methods
+ *
+ * @example
+ * ```typescript
+ * const userEvents = createChannelPrefix(bus, "user");
+ *
+ * userEvents.emit("created", { id: "1" }); // Emits "user:created"
+ * userEvents.on("updated", handler);       // Subscribes to "user:updated"
+ * ```
+ */
+export function createChannelPrefix(bus, prefix) {
+    const prefixed = (channel) => `${prefix}:${channel}`;
+    return {
+        emit(channel, data) {
+            bus.emit(prefixed(channel), data);
+        },
+        on(channel, handler) {
+            return bus.on(prefixed(channel), handler);
+        },
+        once(channel, options) {
+            return bus.once(prefixed(channel), options);
+        },
+        stream(channel, options) {
+            return bus.stream(prefixed(channel), options);
+        },
+    };
+}
+/**
+ * Forward events from one channel to another.
+ *
+ * @param bus - Event bus
+ * @param from - Source channel
+ * @param to - Destination channel
+ * @returns Unsubscribe function
+ */
+export function forwardChannel(bus, from, to) {
+    return bus.on(from, (data) => bus.emit(to, data));
+}
+/**
+ * Merge multiple channels into one.
+ *
+ * @param bus - Event bus
+ * @param sources - Source channels
+ * @param target - Target channel
+ * @returns Unsubscribe function for all sources
+ */
+export function mergeChannels(bus, sources, target) {
+    const unsubscribes = sources.map((source) => forwardChannel(bus, source, target));
+    return () => {
+        for (const unsub of unsubscribes) {
+            unsub();
+        }
+    };
+}
+/**
+ * Filter events on a channel.
+ *
+ * @param bus - Event bus
+ * @param source - Source channel
+ * @param target - Target channel
+ * @param predicate - Filter function
+ * @returns Unsubscribe function
+ */
+export function filterChannel(bus, source, target, predicate) {
+    return bus.on(source, (data) => {
+        if (predicate(data)) {
+            bus.emit(target, data);
+        }
+    });
+}
+/**
+ * Transform events from one channel to another.
+ *
+ * @param bus - Event bus
+ * @param source - Source channel
+ * @param target - Target channel
+ * @param transform - Transform function
+ * @returns Unsubscribe function
+ */
+export function mapChannel(bus, source, target, transform) {
+    return bus.on(source, (data) => {
+        bus.emit(target, transform(data));
+    });
+}
+/**
+ * Debounce events on a channel.
+ *
+ * @param bus - Event bus
+ * @param source - Source channel
+ * @param target - Target channel
+ * @param delay - Debounce delay in milliseconds
+ * @returns Unsubscribe function
+ */
+export function debounceChannel(bus, source, target, delay) {
+    let timer = null;
+    let lastData;
+    const unsub = bus.on(source, (data) => {
+        lastData = data;
+        if (timer) {
+            clearTimeout(timer);
+        }
+        timer = setTimeout(() => {
+            if (lastData !== undefined) {
+                bus.emit(target, lastData);
+            }
+            timer = null;
+        }, delay);
+    });
+    return () => {
+        unsub();
+        if (timer) {
+            clearTimeout(timer);
+        }
+    };
+}
+/**
+ * Throttle events on a channel.
+ *
+ * @param bus - Event bus
+ * @param source - Source channel
+ * @param target - Target channel
+ * @param interval - Throttle interval in milliseconds
+ * @returns Unsubscribe function
+ */
+export function throttleChannel(bus, source, target, interval) {
+    let lastEmit = 0;
+    return bus.on(source, (data) => {
+        const now = Date.now();
+        if (now - lastEmit >= interval) {
+            lastEmit = now;
+            bus.emit(target, data);
+        }
+    });
+}
+//# sourceMappingURL=bus.js.map

package/dist/events/bus.js.map

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

package/dist/events/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Events Module
+ *
+ * Central pub/sub system for streaming coordination.
+ *
+ * @example
+ * ```typescript
+ * import { createEventBus, createTypedEventBus } from "client/events";
+ *
+ * // Simple usage
+ * const bus = createEventBus();
+ * bus.on("updates", (data) => console.log(data));
+ * bus.emit("updates", { message: "Hello" });
+ *
+ * // Typed channels
+ * interface MyChannels {
+ *   "user:created": { id: string; name: string };
+ *   "user:updated": { id: string; changes: Record<string, unknown> };
+ * }
+ *
+ * const typedBus = createTypedEventBus<MyChannels>();
+ * typedBus.emit("user:created", { id: "1", name: "John" }); // Type-safe
+ *
+ * // Streaming iteration
+ * for await (const update of bus.stream("updates")) {
+ *   console.log(update);
+ * }
+ * ```
+ */
+export type { Event, EventHandler, Unsubscribe, EventBus, TypedEventBus, ChannelMap, SystemChannels, ProcedureChannels, DefaultChannels, EventBusOptions, EventWaitOptions, } from "./types.js";
+export { DefaultEventBus } from "./bus.js";
+export { createEventBus, createTypedEventBus, getGlobalEventBus, resetGlobalEventBus, withEventBusSignal, } from "./bus.js";
+export { createChannelPrefix, forwardChannel, mergeChannels, filterChannel, mapChannel, debounceChannel, throttleChannel, } from "./bus.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,YAAY,EACV,KAAK,EACL,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,aAAa,EACb,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,36 @@
+/**
+ * Events Module
+ *
+ * Central pub/sub system for streaming coordination.
+ *
+ * @example
+ * ```typescript
+ * import { createEventBus, createTypedEventBus } from "client/events";
+ *
+ * // Simple usage
+ * const bus = createEventBus();
+ * bus.on("updates", (data) => console.log(data));
+ * bus.emit("updates", { message: "Hello" });
+ *
+ * // Typed channels
+ * interface MyChannels {
+ *   "user:created": { id: string; name: string };
+ *   "user:updated": { id: string; changes: Record<string, unknown> };
+ * }
+ *
+ * const typedBus = createTypedEventBus<MyChannels>();
+ * typedBus.emit("user:created", { id: "1", name: "John" }); // Type-safe
+ *
+ * // Streaming iteration
+ * for await (const update of bus.stream("updates")) {
+ *   console.log(update);
+ * }
+ * ```
+ */
+// Implementation
+export { DefaultEventBus } from "./bus.js";
+// Factory functions
+export { createEventBus, createTypedEventBus, getGlobalEventBus, resetGlobalEventBus, withEventBusSignal, } from "./bus.js";
+// Utilities
+export { createChannelPrefix, forwardChannel, mergeChannels, filterChannel, mapChannel, debounceChannel, throttleChannel, } from "./bus.js";
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAiBH,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,oBAAoB;AACpB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,YAAY;AACZ,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,eAAe,GAChB,MAAM,UAAU,CAAC"}