@furystack/cross-node-bus 1.0.0

package/esm/define-in-process-cross-node-bus.js

@@ -0,0 +1,27 @@
+import { CrossNodeBusTelemetryToken } from './cross-node-bus-telemetry.js';
+import { InProcessCrossNodeBus } from './in-process-cross-node-bus.js';
+/**
+ * Returns a {@link ServiceFactory} bound to {@link CrossNodeBus}. Use it to
+ * override the default factory at boot:
+ *
+ * ```ts
+ * injector.bind(
+ *   CrossNodeBus,
+ *   defineInProcessCrossNodeBus({ topicPrefix: 'svc-a/' }),
+ * )
+ * ```
+ *
+ * Mirrors the `defineXxxCrossNodeBusAdapter` shape future transport
+ * adapters expose. Wires telemetry and disposal into the surrounding
+ * injector scope.
+ */
+export const defineInProcessCrossNodeBus = (options = {}) => {
+    return ({ inject, onDispose }) => {
+        const telemetry = inject(CrossNodeBusTelemetryToken);
+        const bus = new InProcessCrossNodeBus({ ...options, telemetry });
+        // eslint-disable-next-line furystack/prefer-using-wrapper -- delegated to onDispose
+        onDispose(() => bus[Symbol.dispose]());
+        return bus;
+    };
+};
+//# sourceMappingURL=define-in-process-cross-node-bus.js.map

package/esm/define-in-process-cross-node-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-in-process-cross-node-bus.js","sourceRoot":"","sources":["../src/define-in-process-cross-node-bus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAA;AAC1E,OAAO,EAAE,qBAAqB,EAAqC,MAAM,gCAAgC,CAAA;AAUzG;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,UAA8C,EAAE,EAClB,EAAE;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAA;QACpD,MAAM,GAAG,GAAG,IAAI,qBAAqB,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC,CAAA;QAChE,oFAAoF;QACpF,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QACtC,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;AACH,CAAC,CAAA"}

package/esm/errors.d.ts

@@ -0,0 +1,21 @@
+import type { CrossNodeBusCapabilities } from './types.js';
+/**
+ * Thrown synchronously by {@link CrossNodeBus.replay} when `fromSeq` falls
+ * outside the adapter's retained window. Facades catch this and fall back
+ * to a full-snapshot path.
+ */
+export declare class ReplayWindowExceededError extends Error {
+    readonly topic: string;
+    readonly fromSeq: string;
+    readonly oldestRetainedSeq: string | undefined;
+    constructor(topic: string, fromSeq: string, oldestRetainedSeq: string | undefined);
+}
+/**
+ * Thrown synchronously by an adapter when a caller invokes a method that
+ * requires a capability the adapter does not advertise.
+ */
+export declare class UnsupportedCapabilityError extends Error {
+    readonly capability: keyof CrossNodeBusCapabilities;
+    constructor(capability: keyof CrossNodeBusCapabilities);
+}
+//# sourceMappingURL=errors.d.ts.map

package/esm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAE1D;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,SAAgB,KAAK,EAAE,MAAM,CAAA;IAC7B,SAAgB,OAAO,EAAE,MAAM,CAAA;IAC/B,SAAgB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAA;gBAEzC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,SAAS;CAWlF;AAED;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,UAAU,EAAE,MAAM,wBAAwB,CAAA;gBAE9C,UAAU,EAAE,MAAM,wBAAwB;CAKvD"}

package/esm/errors.js

@@ -0,0 +1,30 @@
+/**
+ * Thrown synchronously by {@link CrossNodeBus.replay} when `fromSeq` falls
+ * outside the adapter's retained window. Facades catch this and fall back
+ * to a full-snapshot path.
+ */
+export class ReplayWindowExceededError extends Error {
+    topic;
+    fromSeq;
+    oldestRetainedSeq;
+    constructor(topic, fromSeq, oldestRetainedSeq) {
+        super(`Replay window exceeded for topic "${topic}": requested fromSeq=${fromSeq}, oldest retained=${oldestRetainedSeq ?? 'none'}`);
+        this.name = 'ReplayWindowExceededError';
+        this.topic = topic;
+        this.fromSeq = fromSeq;
+        this.oldestRetainedSeq = oldestRetainedSeq;
+    }
+}
+/**
+ * Thrown synchronously by an adapter when a caller invokes a method that
+ * requires a capability the adapter does not advertise.
+ */
+export class UnsupportedCapabilityError extends Error {
+    capability;
+    constructor(capability) {
+        super(`Adapter does not support capability: ${capability}`);
+        this.name = 'UnsupportedCapabilityError';
+        this.capability = capability;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClC,KAAK,CAAQ;IACb,OAAO,CAAQ;IACf,iBAAiB,CAAoB;IAErD,YAAY,KAAa,EAAE,OAAe,EAAE,iBAAqC;QAC/E,KAAK,CACH,qCAAqC,KAAK,wBAAwB,OAAO,qBACvE,iBAAiB,IAAI,MACvB,EAAE,CACH,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;QACvC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAA;IAC5C,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnC,UAAU,CAAgC;IAE1D,YAAY,UAA0C;QACpD,KAAK,CAAC,wCAAwC,UAAU,EAAE,CAAC,CAAA;QAC3D,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAA;QACxC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;CACF"}

package/esm/errors.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.spec.d.ts.map

package/esm/errors.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.spec.d.ts","sourceRoot":"","sources":["../src/errors.spec.ts"],"names":[],"mappings":""}

package/esm/errors.spec.js

@@ -0,0 +1,30 @@
+import { describe, expect, it } from 'vitest';
+import { ReplayWindowExceededError, UnsupportedCapabilityError } from './errors.js';
+describe('errors', () => {
+    describe('ReplayWindowExceededError', () => {
+        it('captures the topic, fromSeq and oldestRetainedSeq', () => {
+            const error = new ReplayWindowExceededError('topic', '5', '7');
+            expect(error.name).toBe('ReplayWindowExceededError');
+            expect(error.topic).toBe('topic');
+            expect(error.fromSeq).toBe('5');
+            expect(error.oldestRetainedSeq).toBe('7');
+            expect(error.message).toContain('topic');
+            expect(error.message).toContain('5');
+            expect(error.message).toContain('7');
+        });
+        it('reports "none" when no messages are retained', () => {
+            const error = new ReplayWindowExceededError('topic', '5', undefined);
+            expect(error.oldestRetainedSeq).toBeUndefined();
+            expect(error.message).toContain('none');
+        });
+    });
+    describe('UnsupportedCapabilityError', () => {
+        it('captures the missing capability name', () => {
+            const error = new UnsupportedCapabilityError('replay');
+            expect(error.name).toBe('UnsupportedCapabilityError');
+            expect(error.capability).toBe('replay');
+            expect(error.message).toContain('replay');
+        });
+    });
+});
+//# sourceMappingURL=errors.spec.js.map

package/esm/errors.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.spec.js","sourceRoot":"","sources":["../src/errors.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAEnF,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACzC,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,KAAK,GAAG,IAAI,yBAAyB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;YAC9D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;YACpD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACjC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC/B,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACzC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;YACxC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;YACpC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QACtC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,KAAK,GAAG,IAAI,yBAAyB,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAA;YACpE,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,aAAa,EAAE,CAAA;YAC/C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAC1C,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,KAAK,GAAG,IAAI,0BAA0B,CAAC,QAAQ,CAAC,CAAA;YACtD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;YACrD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACvC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/esm/in-process-cross-node-bus.d.ts

@@ -0,0 +1,58 @@
+import type { CrossNodeBusTelemetry } from './cross-node-bus-telemetry.js';
+import { MemoryBroker } from './memory-broker.js';
+import type { CrossNodeBus } from './cross-node-bus.js';
+import type { BusMessage, CrossNodeBusCapabilities } from './types.js';
+/**
+ * Options accepted by {@link InProcessCrossNodeBus}.
+ */
+export type InProcessCrossNodeBusOptions = {
+    /**
+     * Shared {@link MemoryBroker}. When omitted a private broker is minted —
+     * single-instance behavior matches an isolated EventHub. The testing
+     * harness passes the same broker to N buses so they can observe each
+     * other's publishes without an external transport.
+     */
+    broker?: MemoryBroker;
+    /** Stable, per-process identifier. Defaults to `local-${crypto.randomUUID()}`. */
+    nodeId?: string;
+    /**
+     * Wire-level prefix applied to every topic on `publish` / `subscribe`.
+     * Defaults to `''` (no prefix). Multi-service simulations pick distinct
+     * prefixes per bus so cross-service eavesdrop can be exercised against a
+     * single shared broker.
+     */
+    topicPrefix?: string;
+    /**
+     * Convenience for the common case of "one bus, fresh private broker, this
+     * many retained messages per topic". Ignored when `broker` is provided.
+     */
+    replayWindow?: number;
+    /** Sink for `onCrossNodePublished` / `onCrossNodeReceived` / `onCrossNodeError`. */
+    telemetry?: CrossNodeBusTelemetry;
+};
+/**
+ * In-process default {@link CrossNodeBus} adapter. Backs single-node
+ * deployments out of the box and powers the multi-instance testing harness
+ * exposed at `@furystack/cross-node-bus/testing`.
+ *
+ * Local fan-out is multiplexed: regardless of how many handlers subscribe
+ * to a single wire topic, the bus opens exactly one broker subscription and
+ * dispatches arrivals to its own handler set. This keeps `onCrossNodeReceived`
+ * counting one event per arrival rather than per handler invocation, and
+ * mirrors the consumer-group shape future network adapters will use.
+ */
+export declare class InProcessCrossNodeBus implements CrossNodeBus {
+    #private;
+    readonly nodeId: string;
+    readonly capabilities: CrossNodeBusCapabilities;
+    constructor(options?: InProcessCrossNodeBusOptions);
+    publish(topic: string, payload: unknown): Promise<void>;
+    subscribe(topic: string, handler: (message: BusMessage) => void): Disposable;
+    subscribeRemoteOnly(topic: string, handler: (message: BusMessage) => void): Disposable;
+    subscribeForeign(prefix: string, topic: string, handler: (message: BusMessage) => void): Disposable;
+    replay(topic: string, fromSeq: string): AsyncIterable<BusMessage>;
+    compareSeq(a: string, b: string): number;
+    oldestSeq(topic: string): string | undefined;
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=in-process-cross-node-bus.d.ts.map

package/esm/in-process-cross-node-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-cross-node-bus.d.ts","sourceRoot":"","sources":["../src/in-process-cross-node-bus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAEtE;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oFAAoF;IACpF,SAAS,CAAC,EAAE,qBAAqB,CAAA;CAClC,CAAA;AAcD;;;;;;;;;;GAUG;AACH,qBAAa,qBAAsB,YAAW,YAAY;;IACxD,SAAgB,MAAM,EAAE,MAAM,CAAA;IAC9B,SAAgB,YAAY,EAAE,wBAAwB,CAAe;gBAczD,OAAO,GAAE,4BAAiC;IAkBzC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB7D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,UAAU;IAK5E,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,UAAU;IAMtF,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,UAAU;IAKnG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC;IAUjE,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAIxC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK5C,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAkGhC"}

package/esm/in-process-cross-node-bus.js

@@ -0,0 +1,196 @@
+import { randomUUID } from 'node:crypto';
+import { MemoryBroker } from './memory-broker.js';
+const CAPABILITIES = Object.freeze({
+    persistent: false,
+    replay: true,
+    assignsSequence: true,
+});
+/**
+ * In-process default {@link CrossNodeBus} adapter. Backs single-node
+ * deployments out of the box and powers the multi-instance testing harness
+ * exposed at `@furystack/cross-node-bus/testing`.
+ *
+ * Local fan-out is multiplexed: regardless of how many handlers subscribe
+ * to a single wire topic, the bus opens exactly one broker subscription and
+ * dispatches arrivals to its own handler set. This keeps `onCrossNodeReceived`
+ * counting one event per arrival rather than per handler invocation, and
+ * mirrors the consumer-group shape future network adapters will use.
+ */
+export class InProcessCrossNodeBus {
+    nodeId;
+    capabilities = CAPABILITIES;
+    #broker;
+    #ownsBroker;
+    #topicPrefix;
+    #telemetry;
+    /** displayTopic per wire topic — keyed by wire string for O(1) routing. */
+    #localHandlers = new Map();
+    /** Live broker subscription per wire topic, opened on first local handler. */
+    #brokerHandles = new Map();
+    #disposed = false;
+    constructor(options = {}) {
+        this.#ownsBroker = options.broker === undefined;
+        this.nodeId = options.nodeId ?? `local-${randomUUID()}`;
+        this.#topicPrefix = options.topicPrefix ?? '';
+        this.#telemetry = options.telemetry;
+        this.#broker =
+            options.broker ??
+                new MemoryBroker({
+                    replayWindow: options.replayWindow,
+                    onEviction: (wire, evictedSeq, retainedCount) => this.#telemetry?.emit('onCrossNodeWindowEvicted', {
+                        topic: this.#displayTopicFor(wire),
+                        evictedSeq,
+                        retainedCount,
+                    }),
+                });
+    }
+    async publish(topic, payload) {
+        this.#ensureLive();
+        const wire = this.#wireTopic(topic);
+        let byteLength = 0;
+        if (this.#telemetry) {
+            try {
+                byteLength = Buffer.byteLength(JSON.stringify(payload) ?? '');
+            }
+            catch (error) {
+                this.#telemetry.emit('onCrossNodeError', { topic, error, phase: 'serialize' });
+            }
+        }
+        try {
+            this.#broker.publish(wire, this.nodeId, payload, (error) => {
+                this.#telemetry?.emit('onCrossNodeError', { topic, error, phase: 'subscribe' });
+            });
+        }
+        catch (error) {
+            this.#telemetry?.emit('onCrossNodeError', { topic, error, phase: 'publish' });
+            throw error;
+        }
+        this.#telemetry?.emit('onCrossNodePublished', { topic, originId: this.nodeId, byteLength });
+    }
+    subscribe(topic, handler) {
+        this.#ensureLive();
+        return this.#subscribeWire(this.#wireTopic(topic), topic, handler, 'subscribe');
+    }
+    subscribeRemoteOnly(topic, handler) {
+        return this.subscribe(topic, (message) => {
+            if (message.originId !== this.nodeId)
+                handler(message);
+        });
+    }
+    subscribeForeign(prefix, topic, handler) {
+        this.#ensureLive();
+        return this.#subscribeWire(`${prefix}${topic}`, topic, handler, 'subscribeForeign');
+    }
+    replay(topic, fromSeq) {
+        this.#ensureLive();
+        try {
+            return this.#broker.replay(this.#wireTopic(topic), fromSeq);
+        }
+        catch (error) {
+            this.#telemetry?.emit('onCrossNodeError', { topic, error, phase: 'replay' });
+            throw error;
+        }
+    }
+    compareSeq(a, b) {
+        return Number(a) - Number(b);
+    }
+    oldestSeq(topic) {
+        this.#ensureLive();
+        return this.#broker.oldestSeq(this.#wireTopic(topic));
+    }
+    [Symbol.dispose]() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        for (const handle of this.#brokerHandles.values()) {
+            handle[Symbol.dispose]();
+        }
+        this.#brokerHandles.clear();
+        this.#localHandlers.clear();
+        if (this.#ownsBroker) {
+            this.#broker[Symbol.dispose]();
+        }
+    }
+    #wireTopic(topic) {
+        return `${this.#topicPrefix}${topic}`;
+    }
+    /**
+     * Reverse-resolve the caller-facing display topic for a wire topic. When
+     * local handlers exist their displayTopic is authoritative — `subscribe`
+     * always yields `prefix+t` and `subscribeForeign` always yields `p+t`, so
+     * the first entry is representative. Falls back to the wire string when no
+     * subscriber on this bus has registered (publish-only buses never need to
+     * round-trip a display name; the wire is the most accurate label).
+     */
+    #displayTopicFor(wire) {
+        const handlers = this.#localHandlers.get(wire);
+        if (!handlers)
+            return wire;
+        const first = handlers.values().next().value;
+        return first ? first.displayTopic : wire;
+    }
+    #subscribeWire(wire, displayTopic, handler, phase) {
+        const entry = { handler, displayTopic };
+        let handlers = this.#localHandlers.get(wire);
+        if (!handlers) {
+            handlers = new Set();
+            this.#localHandlers.set(wire, handlers);
+            try {
+                const brokerHandle = this.#broker.subscribe(wire, (message) => this.#deliver(wire, message));
+                this.#brokerHandles.set(wire, brokerHandle);
+            }
+            catch (error) {
+                this.#localHandlers.delete(wire);
+                this.#telemetry?.emit('onCrossNodeError', { topic: displayTopic, error, phase });
+                throw error;
+            }
+        }
+        handlers.add(entry);
+        return {
+            [Symbol.dispose]: () => {
+                const current = this.#localHandlers.get(wire);
+                if (!current)
+                    return;
+                current.delete(entry);
+                if (current.size === 0) {
+                    this.#localHandlers.delete(wire);
+                    this.#brokerHandles.get(wire)?.[Symbol.dispose]();
+                    this.#brokerHandles.delete(wire);
+                }
+            },
+        };
+    }
+    #deliver(wire, message) {
+        const handlers = this.#localHandlers.get(wire);
+        if (!handlers || handlers.size === 0)
+            return;
+        if (this.#telemetry) {
+            // Multiple subscribers on the same wire share a displayTopic that maps
+            // 1:1 to the wire string: `subscribe(t)` always yields prefix+t and
+            // `subscribeForeign(p, t)` always yields p+t. The first entry's
+            // displayTopic is therefore representative.
+            const first = handlers.values().next().value;
+            if (first) {
+                this.#telemetry.emit('onCrossNodeReceived', {
+                    topic: first.displayTopic,
+                    originId: message.originId,
+                    lagMs: Date.now() - Date.parse(message.emittedAt),
+                });
+            }
+        }
+        for (const entry of handlers) {
+            try {
+                entry.handler(message);
+            }
+            catch (error) {
+                this.#telemetry?.emit('onCrossNodeError', { topic: entry.displayTopic, error, phase: 'subscribe' });
+            }
+        }
+    }
+    #ensureLive() {
+        if (this.#disposed) {
+            throw new Error('InProcessCrossNodeBus has been disposed');
+        }
+    }
+}
+//# sourceMappingURL=in-process-cross-node-bus.js.map

package/esm/in-process-cross-node-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-cross-node-bus.js","sourceRoot":"","sources":["../src/in-process-cross-node-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAiCjD,MAAM,YAAY,GAA6B,MAAM,CAAC,MAAM,CAAC;IAC3D,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,IAAI;IACZ,eAAe,EAAE,IAAI;CACtB,CAAC,CAAA;AAQF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,qBAAqB;IAChB,MAAM,CAAQ;IACd,YAAY,GAA6B,YAAY,CAAA;IAE5D,OAAO,CAAc;IACrB,WAAW,CAAS;IACpB,YAAY,CAAQ;IACpB,UAAU,CAAmC;IAEtD,2EAA2E;IAClE,cAAc,GAAiC,IAAI,GAAG,EAAE,CAAA;IACjE,8EAA8E;IACrE,cAAc,GAA4B,IAAI,GAAG,EAAE,CAAA;IAE5D,SAAS,GAAG,KAAK,CAAA;IAEjB,YAAY,UAAwC,EAAE;QACpD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAA;QAC/C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,UAAU,EAAE,EAAE,CAAA;QACvD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAA;QAC7C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAA;QACnC,IAAI,CAAC,OAAO;YACV,OAAO,CAAC,MAAM;gBACd,IAAI,YAAY,CAAC;oBACf,YAAY,EAAE,OAAO,CAAC,YAAY;oBAClC,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,EAAE,CAC9C,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,0BAA0B,EAAE;wBAChD,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;wBAClC,UAAU;wBACV,aAAa;qBACd,CAAC;iBACL,CAAC,CAAA;IACN,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,OAAgB;QAClD,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;QACnC,IAAI,UAAU,GAAG,CAAC,CAAA;QAClB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;YAC/D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;YAChF,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACzD,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;YACjF,CAAC,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;YAC7E,MAAM,KAAK,CAAA;QACb,CAAC;QACD,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;IAC7F,CAAC;IAEM,SAAS,CAAC,KAAa,EAAE,OAAsC;QACpE,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;IACjF,CAAC;IAEM,mBAAmB,CAAC,KAAa,EAAE,OAAsC;QAC9E,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACvC,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QACxD,CAAC,CAAC,CAAA;IACJ,CAAC;IAEM,gBAAgB,CAAC,MAAc,EAAE,KAAa,EAAE,OAAsC;QAC3F,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,MAAM,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAA;IACrF,CAAC;IAEM,MAAM,CAAC,KAAa,EAAE,OAAe;QAC1C,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAA;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;YAC5E,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAEM,UAAU,CAAC,CAAS,EAAE,CAAS;QACpC,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC;IAEM,SAAS,CAAC,KAAa;QAC5B,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IACvD,CAAC;IAEM,CAAC,MAAM,CAAC,OAAO,CAAC;QACrB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAM;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YAClD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;QAC1B,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAA;QAC3B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAA;QAC3B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;QAChC,CAAC;IACH,CAAC;IAED,UAAU,CAAC,KAAa;QACtB,OAAO,GAAG,IAAI,CAAC,YAAY,GAAG,KAAK,EAAE,CAAA;IACvC,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAC,IAAY;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QAC1B,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;QAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAA;IAC1C,CAAC;IAED,cAAc,CACZ,IAAY,EACZ,YAAoB,EACpB,OAAsC,EACtC,KAAuC;QAEvC,MAAM,KAAK,GAAe,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;QACnD,IAAI,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAA;YACpB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YACvC,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;gBAC5F,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBAChC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;gBAChF,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACnB,OAAO;YACL,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE;gBACrB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBAC7C,IAAI,CAAC,OAAO;oBAAE,OAAM;gBACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACrB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACvB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;oBAChC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;oBACjD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBAClC,CAAC;YACH,CAAC;SACF,CAAA;IACH,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,OAAmB;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;YAAE,OAAM;QAC5C,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,uEAAuE;YACvE,oEAAoE;YACpE,gEAAgE;YAChE,4CAA4C;YAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;YAC5C,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,qBAAqB,EAAE;oBAC1C,KAAK,EAAE,KAAK,CAAC,YAAY;oBACzB,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;iBAClD,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACxB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;YACrG,CAAC;QACH,CAAC;IACH,CAAC;IAED,WAAW;QACT,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;CACF"}

package/esm/in-process-cross-node-bus.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=in-process-cross-node-bus.spec.d.ts.map

package/esm/in-process-cross-node-bus.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-cross-node-bus.spec.d.ts","sourceRoot":"","sources":["../src/in-process-cross-node-bus.spec.ts"],"names":[],"mappings":""}