velocious 1.0.356 → 1.0.358

package/build/src/beacon/client.js

@@ -0,0 +1,224 @@
+// @ts-check
+import { randomUUID } from "node:crypto";
+import net from "node:net";
+import JsonSocket from "../background-jobs/json-socket.js";
+import EventEmitter from "../utils/event-emitter.js";
+const DEFAULT_RECONNECT_DELAY_MS = 1000;
+const MAX_RECONNECT_DELAY_MS = 30_000;
+/**
+ * @typedef {function(import("./types.js").BeaconBroadcastMessage): void} BeaconBroadcastHandler
+ */
+/**
+ * BeaconClient connects to a `velocious beacon` daemon and exchanges
+ * broadcasts with all peer processes connected to the same daemon.
+ *
+ * Lifecycle:
+ *   const client = new BeaconClient({host, port, peerType: "server"})
+ *   await client.connect()                         // resolves on first successful connect
+ *   client.onBroadcast((message) => { ... })       // every fan-out
+ *   client.publish({channel, broadcastParams, body})
+ *   await client.close()
+ *
+ * Reconnect: on socket close (without an explicit `close()` call) the
+ * client schedules a reconnect with exponential backoff. While the
+ * underlying socket is down, `publish(...)` returns false and the
+ * caller can fall back to local-only delivery; subsequent reconnects do
+ * not replay missed publishes (Beacon is pubsub, not a queue).
+ */
+export default class BeaconClient extends EventEmitter {
+    /**
+     * @param {object} args - Options.
+     * @param {string} args.host - Beacon host.
+     * @param {number} args.port - Beacon port.
+     * @param {string} [args.peerType] - Optional human-readable peer label.
+     * @param {string} [args.peerId] - Optional explicit peer id (defaults to a random UUID).
+     * @param {number} [args.reconnectDelayMs] - Starting reconnect delay in ms.
+     * @param {number} [args.maxReconnectDelayMs] - Maximum reconnect delay in ms.
+     */
+    constructor({ host, port, peerType, peerId, reconnectDelayMs, maxReconnectDelayMs }) {
+        super();
+        this.host = host;
+        this.port = port;
+        this.peerType = peerType;
+        this.peerId = peerId || randomUUID();
+        this._initialReconnectDelayMs = reconnectDelayMs ?? DEFAULT_RECONNECT_DELAY_MS;
+        this._maxReconnectDelayMs = maxReconnectDelayMs ?? MAX_RECONNECT_DELAY_MS;
+        this._reconnectDelayMs = this._initialReconnectDelayMs;
+        /** @type {JsonSocket | undefined} */
+        this._jsonSocket = undefined;
+        /** @type {net.Socket | undefined} */
+        this._socket = undefined;
+        this._connected = false;
+        this._closed = false;
+        /** @type {NodeJS.Timeout | undefined} */
+        this._reconnectTimer = undefined;
+        /** @type {Promise<void> | undefined} */
+        this._connectPromise = undefined;
+        /**
+         * Last socket error observed while connected, surfaced as the disconnect reason.
+         * @type {Error | undefined}
+         */
+        this._lastSocketError = undefined;
+    }
+    /** @returns {string} - The peer id sent on the hello handshake. */
+    getPeerId() { return this.peerId; }
+    /** @returns {boolean} - Whether the underlying socket is currently connected. */
+    isConnected() { return this._connected; }
+    /**
+     * Resolves on the first successful connect. Subsequent calls return
+     * the same promise. Subsequent reconnects after a drop are silent —
+     * use `on("connect")` / `on("disconnect", reason)` to observe them.
+     * The `disconnect` listener receives an `Error` reason: either the
+     * underlying socket error, or `Error("Beacon broker disconnected")`
+     * when the close had no preceding error.
+     * @returns {Promise<void>}
+     */
+    async connect() {
+        if (this._closed)
+            throw new Error("BeaconClient has been closed");
+        if (this._connectPromise)
+            return await this._connectPromise;
+        this._connectPromise = new Promise((resolve, reject) => {
+            const onConnect = () => {
+                this.off("connect", onConnect);
+                this.off("connect-error", onError);
+                resolve();
+            };
+            const onError = (/** @type {Error} */ error) => {
+                this.off("connect", onConnect);
+                this.off("connect-error", onError);
+                reject(error);
+            };
+            this.on("connect", onConnect);
+            this.on("connect-error", onError);
+        });
+        this._openSocket();
+        return await this._connectPromise;
+    }
+    /**
+     * Publishes a broadcast message to all peers (including this one,
+     * unless the daemon is restarted mid-publish).
+     * @param {object} args - Broadcast args.
+     * @param {string} args.channel - Channel name.
+     * @param {Record<string, any>} args.broadcastParams - Routing params.
+     * @param {any} args.body - Message body.
+     * @returns {boolean} - True if the publish was written to the socket. False if the client is currently disconnected.
+     */
+    publish({ channel, broadcastParams, body }) {
+        if (!this._connected || !this._jsonSocket)
+            return false;
+        /** @type {import("./types.js").BeaconBroadcastMessage} */
+        const message = {
+            type: "broadcast",
+            channel,
+            broadcastParams,
+            body,
+            originPeerId: this.peerId
+        };
+        try {
+            this._jsonSocket.send(message);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Registers a handler called once for every `broadcast` message
+     * received from the daemon (including echoes of this client's own
+     * publishes — synapse-style fan-out).
+     * @param {BeaconBroadcastHandler} handler - Handler.
+     * @returns {() => void} - Unregister function.
+     */
+    onBroadcast(handler) {
+        this.on("broadcast", handler);
+        return () => this.off("broadcast", handler);
+    }
+    /** @returns {Promise<void>} - Resolves once the socket is closed. */
+    async close() {
+        this._closed = true;
+        if (this._reconnectTimer) {
+            clearTimeout(this._reconnectTimer);
+            this._reconnectTimer = undefined;
+        }
+        if (this._socket) {
+            const socket = this._socket;
+            await new Promise((resolve) => {
+                socket.once("close", () => resolve(undefined));
+                socket.end();
+            });
+        }
+    }
+    /**
+     * @returns {void}
+     */
+    _openSocket() {
+        if (this._closed)
+            return;
+        const socket = net.createConnection({ host: this.host, port: this.port });
+        this._socket = socket;
+        const jsonSocket = new JsonSocket(socket);
+        this._jsonSocket = jsonSocket;
+        socket.on("connect", () => {
+            this._connected = true;
+            this._reconnectDelayMs = this._initialReconnectDelayMs;
+            jsonSocket.send({
+                type: "hello",
+                role: "client",
+                peerId: this.peerId,
+                peerType: this.peerType
+            });
+            this.emit("connect");
+        });
+        jsonSocket.on("message", (/** @type {import("./types.js").BeaconSocketMessage} */ message) => {
+            if (message?.type === "broadcast") {
+                this.emit("broadcast", message);
+            }
+        });
+        jsonSocket.on("error", (error) => {
+            if (!this._connected) {
+                // Initial connect failed — surface to `connect()`'s promise via `connect-error`.
+                // No `error` emit: that channel is for established-session errors; the
+                // initial-connect path is owned by `connect-error`.
+                this.emit("connect-error", error);
+            }
+            else {
+                // Established session error. Cache so the upcoming `close` event can
+                // surface it as the disconnect reason.
+                this._lastSocketError = error;
+                this.emit("error", error);
+            }
+        });
+        jsonSocket.on("close", () => {
+            const wasConnected = this._connected;
+            this._connected = false;
+            this._jsonSocket = undefined;
+            this._socket = undefined;
+            // Explicit close() sets `_closed = true` before ending the socket.
+            // Don't surface user-initiated teardown as a disconnect "error" —
+            // only network-driven drops should be reported.
+            if (wasConnected && !this._closed) {
+                const reason = this._lastSocketError || new Error("Beacon broker disconnected");
+                this.emit("disconnect", reason);
+            }
+            this._lastSocketError = undefined;
+            if (this._closed)
+                return;
+            this._scheduleReconnect();
+        });
+    }
+    /**
+     * @returns {void}
+     */
+    _scheduleReconnect() {
+        if (this._reconnectTimer)
+            return;
+        const delay = this._reconnectDelayMs;
+        this._reconnectTimer = setTimeout(() => {
+            this._reconnectTimer = undefined;
+            this._reconnectDelayMs = Math.min(delay * 2, this._maxReconnectDelayMs);
+            this._openSocket();
+        }, delay);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2JlYWNvbi9jbGllbnQuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sRUFBQyxVQUFVLEVBQUMsTUFBTSxhQUFhLENBQUE7QUFDdEMsT0FBTyxHQUFHLE1BQU0sVUFBVSxDQUFBO0FBRTFCLE9BQU8sVUFBVSxNQUFNLG1DQUFtQyxDQUFBO0FBQzFELE9BQU8sWUFBWSxNQUFNLDJCQUEyQixDQUFBO0FBRXBELE1BQU0sMEJBQTBCLEdBQUcsSUFBSSxDQUFBO0FBQ3ZDLE1BQU0sc0JBQXNCLEdBQUcsTUFBTSxDQUFBO0FBRXJDOztHQUVHO0FBRUg7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQkc7QUFDSCxNQUFNLENBQUMsT0FBTyxPQUFPLFlBQWEsU0FBUSxZQUFZO0lBQ3BEOzs7Ozs7OztPQVFHO0lBQ0gsWUFBWSxFQUFDLElBQUksRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFLE1BQU0sRUFBRSxnQkFBZ0IsRUFBRSxtQkFBbUIsRUFBQztRQUMvRSxLQUFLLEVBQUUsQ0FBQTtRQUNQLElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFBO1FBQ2hCLElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFBO1FBQ2hCLElBQUksQ0FBQyxRQUFRLEdBQUcsUUFBUSxDQUFBO1FBQ3hCLElBQUksQ0FBQyxNQUFNLEdBQUcsTUFBTSxJQUFJLFVBQVUsRUFBRSxDQUFBO1FBQ3BDLElBQUksQ0FBQyx3QkFBd0IsR0FBRyxnQkFBZ0IsSUFBSSwwQkFBMEIsQ0FBQTtRQUM5RSxJQUFJLENBQUMsb0JBQW9CLEdBQUcsbUJBQW1CLElBQUksc0JBQXNCLENBQUE7UUFDekUsSUFBSSxDQUFDLGlCQUFpQixHQUFHLElBQUksQ0FBQyx3QkFBd0IsQ0FBQTtRQUN0RCxxQ0FBcUM7UUFDckMsSUFBSSxDQUFDLFdBQVcsR0FBRyxTQUFTLENBQUE7UUFDNUIscUNBQXFDO1FB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LFNBQVMsQ0FBQTtZQUM1QixJQUFJLENBQUMsT0FBTyxHQUFHLFNBQVMsQ0FBQTtZQUV4QixtRUFBbUU7WUFDbkUsa0VBQWtFO1lBQ2xFLGdEQUFnRDtZQUNoRCxJQUFJLFlBQVksSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQztnQkFDbEMsTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLGdCQUFnQixJQUFJLElBQUksS0FBSyxDQUFDLDRCQUE0QixDQUFDLENBQUE7Z0JBRS9FLElBQUksQ0FBQyxJQUFJLENBQUMsWUFBWSxFQUFFLE1BQU0sQ0FBQyxDQUFBO1lBQ2pDLENBQUM7WUFFRCxJQUFJLENBQUMsZ0JBQWdCLEdBQUcsU0FBUyxDQUFBO1lBRWpDLElBQUksSUFBSSxDQUFDLE9BQU87Z0JBQUUsT0FBTTtZQUV4QixJQUFJLENBQUMsa0JBQWtCLEVBQUUsQ0FBQTtRQUMzQixDQUFDLENBQUMsQ0FBQTtJQUNKLENBQUM7SUFFRDs7T0FFRztJQUNILGtCQUFrQjtRQUNoQixJQUFJLElBQUksQ0FBQyxlQUFlO1lBQUUsT0FBTTtRQUVoQyxNQUFNLEtBQUssR0FBRyxJQUFJLENBQUMsaUJBQWlCLENBQUE7UUFFcEMsSUFBSSxDQUFDLGVBQWUsR0FBRyxVQUFVLENBQUMsR0FBRyxFQUFFO1lBQ3JDLElBQUksQ0FBQyxlQUFlLEdBQUcsU0FBUyxDQUFBO1lBQ2hDLElBQUksQ0FBQyxpQkFBaUIsR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLEtBQUssR0FBRyxDQUFDLEVBQUUsSUFBSSxDQUFDLG9CQUFvQixDQUFDLENBQUE7WUFDdkUsSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFBO1FBQ3BCLENBQUMsRUFBRSxLQUFLLENBQUMsQ0FBQTtJQUNYLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5pbXBvcnQge3JhbmRvbVVVSUR9IGZyb20gXCJub2RlOmNyeXB0b1wiXG5pbXBvcnQgbmV0IGZyb20gXCJub2RlOm5ldFwiXG5cbmltcG9ydCBKc29uU29ja2V0IGZyb20gXCIuLi9iYWNrZ3JvdW5kLWpvYnMvanNvbi1zb2NrZXQuanNcIlxuaW1wb3J0IEV2ZW50RW1pdHRlciBmcm9tIFwiLi4vdXRpbHMvZXZlbnQtZW1pdHRlci5qc1wiXG5cbmNvbnN0IERFRkFVTFRfUkVDT05ORUNUX0RFTEFZX01TID0gMTAwMFxuY29uc3QgTUFYX1JFQ09OTkVDVF9ERUxBWV9NUyA9IDMwXzAwMFxuXG4vKipcbiAqIEB0eXBlZGVmIHtmdW5jdGlvbihpbXBvcnQoXCIuL3R5cGVzLmpzXCIpLkJlYWNvbkJyb2FkY2FzdE1lc3NhZ2UpOiB2b2lkfSBCZWFjb25Ccm9hZGNhc3RIYW5kbGVyXG4gKi9cblxuLyoqXG4gKiBCZWFjb25DbGllbnQgY29ubmVjdHMgdG8gYSBgdmVsb2Npb3VzIGJlYWNvbmAgZGFlbW9uIGFuZCBleGNoYW5nZXNcbiAqIGJyb2FkY2FzdHMgd2l0aCBhbGwgcGVlciBwcm9jZXNzZXMgY29ubmVjdGVkIHRvIHRoZSBzYW1lIGRhZW1vbi5cbiAqXG4gKiBMaWZlY3ljbGU6XG4gKiAgIGNvbnN0IGNsaWVudCA9IG5ldyBCZWFjb25DbGllbnQoe2hvc3QsIHBvcnQsIHBlZXJUeXBlOiBcInNlcnZlclwifSlcbiAqICAgYXdhaXQgY2xpZW50LmNvbm5lY3QoKSAgICAgICAgICAgICAgICAgICAgICAgICAvLyByZXNvbHZlcyBvbiBmaXJzdCBzdWNjZXNzZnVsIGNvbm5lY3RcbiAqICAgY2xpZW50Lm9uQnJvYWRjYXN0KChtZXNzYWdlKSA9PiB7IC4uLiB9KSAgICAgICAvLyBldmVyeSBmYW4tb3V0XG4gKiAgIGNsaWVudC5wdWJsaXNoKHtjaGFubmVsLCBicm9hZGNhc3RQYXJhbXMsIGJvZHl9KVxuICogICBhd2FpdCBjbGllbnQuY2xvc2UoKVxuICpcbiAqIFJlY29ubmVjdDogb24gc29ja2V0IGNsb3NlICh3aXRob3V0IGFuIGV4cGxpY2l0IGBjbG9zZSgpYCBjYWxsKSB0aGVcbiAqIGNsaWVudCBzY2hlZHVsZXMgYSByZWNvbm5lY3Qgd2l0aCBleHBvbmVudGlhbCBiYWNrb2ZmLiBXaGlsZSB0aGVcbiAqIHVuZGVybHlpbmcgc29ja2V0IGlzIGRvd24sIGBwdWJsaXNoKC4uLilgIHJldHVybnMgZmFsc2UgYW5kIHRoZVxuICogY2FsbGVyIGNhbiBmYWxsIGJhY2sgdG8gbG9jYWwtb25seSBkZWxpdmVyeTsgc3Vic2VxdWVudCByZWNvbm5lY3RzIGRvXG4gKiBub3QgcmVwbGF5IG1pc3NlZCBwdWJsaXNoZXMgKEJlYWNvbiBpcyBwdWJzdWIsIG5vdCBhIHF1ZXVlKS5cbiAqL1xuZXhwb3J0IGRlZmF1bHQgY2xhc3MgQmVhY29uQ2xpZW50IGV4dGVuZHMgRXZlbnRFbWl0dGVyIHtcbiAgLyoqXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBhcmdzIC0gT3B0aW9ucy5cbiAgICogQHBhcmFtIHtzdHJpbmd9IGFyZ3MuaG9zdCAtIEJlYWNvbiBob3N0LlxuICAgKiBAcGFyYW0ge251bWJlcn0gYXJncy5wb3J0IC0gQmVhY29uIHBvcnQuXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBbYXJncy5wZWVyVHlwZV0gLSBPcHRpb25hbCBodW1hbi1yZWFkYWJsZSBwZWVyIGxhYmVsLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gW2FyZ3MucGVlcklkXSAtIE9wdGlvbmFsIGV4cGxpY2l0IHBlZXIgaWQgKGRlZmF1bHRzIHRvIGEgcmFuZG9tIFVVSUQpLlxuICAgKiBAcGFyYW0ge251bWJlcn0gW2FyZ3MucmVjb25uZWN0RGVsYXlNc10gLSBTdGFydGluZyByZWNvbm5lY3QgZGVsYXkgaW4gbXMuXG4gICAqIEBwYXJhbSB7bnVtYmVyfSBbYXJncy5tYXhSZWNvbm5lY3REZWxheU1zXSAtIE1heGltdW0gcmVjb25uZWN0IGRlbGF5IGluIG1zLlxuICAgKi9cbiAgY29uc3RydWN0b3Ioe2hvc3QsIHBvcnQsIHBlZXJUeXBlLCBwZWVySWQsIHJlY29ubmVjdERlbGF5TXMsIG1heFJlY29ubmVjdERlbGF5TXN9KSB7XG4gICAgc3VwZXIoKVxuICAgIHRoaXMuaG9zdCA9IGhvc3RcbiAgICB0aGlzLnBvcnQgPSBwb3J0XG4gICAgdGhpcy5wZWVyVHlwZSA9IHBlZXJUeXBlXG4gICAgdGhpcy5wZWVySWQgPSBwZWVySWQgfHwgcmFuZG9tVVVJRCgpXG4gICAgdGhpcy5faW5pdGlhbFJlY29ubmVjdERlbGF5TXMgPSByZWNvbm5lY3REZWxheU1zID8/IERFRkFVTFRfUkVDT05ORUNUX0RFTEFZX01TXG4gICAgdGhpcy5fbWF4UmVjb25uZWN0RGVsYXlNcyA9IG1heFJlY29ubmVjdERlbGF5TXMgPz8gTUFYX1JFQ09OTkVDVF9ERUxBWV9NU1xuICAgIHRoaXMuX3JlY29ubmVjdERlbGF5TXMgPSB0aGlzLl9pbml0aWFsUmVjb25uZWN0RGVsYXlNc1xuICAgIC8qKiBAdHlwZSB7SnNvblNvY2tldCB8IHVuZGVmaW5lZH0gKi9cbiAgICB0aGlzLl9qc29uU29ja2V0ID0gdW5kZWZpbmVkXG4gICAgLyoqIEB0eXBlIHtuZXQuU29ja2V0IHwgdW5kZWZpbmVkfSAqL1xuICAgIHRoaXMuX3NvY2tldCA9IHVuZGVmaW5lZFxuICAgIHRoaXMuX2Nvbm5lY3RlZCA9IGZhbHNlXG4gICAgdGhpcy5fY2xvc2VkID0gZmFsc2VcbiAgICAvKiogQHR5cGUge05vZGVKUy5UaW1lb3V0IHwgdW5kZWZpbmVkfSAqL1xuICAgIHRoaXMuX3JlY29ubmVjdFRpbWVyID0gdW5kZWZpbmVkXG4gICAgLyoqIEB0eXBlIHtQcm9taXNlPHZvaWQ+IHwgdW5kZWZpbmVkfSAqL1xuICAgIHRoaXMuX2Nvbm5lY3RQcm9taXNlID0gdW5kZWZpbmVkXG4gICAgLyoqXG4gICAgICogTGFzdCBzb2NrZXQgZXJyb3Igb2JzZXJ2ZWQgd2hpbGUgY29ubmVjdGVkLCBzdXJmYWNlZCBhcyB0aGUgZGlzY29ubmVjdCByZWFzb24uXG4gICAgICogQHR5cGUge0Vycm9yIHwgdW5kZWZpbmVkfVxuICAgICAqL1xuICAgIHRoaXMuX2xhc3RTb2NrZXRFcnJvciA9IHVuZGVmaW5lZFxuICB9XG5cbiAgLyoqIEByZXR1cm5zIHtzdHJpbmd9IC0gVGhlIHBlZXIgaWQgc2VudCBvbiB0aGUgaGVsbG8gaGFuZHNoYWtlLiAqL1xuICBnZXRQZWVySWQoKSB7IHJldHVybiB0aGlzLnBlZXJJZCB9XG5cbiAgLyoqIEByZXR1cm5zIHtib29sZWFufSAtIFdoZXRoZXIgdGhlIHVuZGVybHlpbmcgc29ja2V0IGlzIGN1cnJlbnRseSBjb25uZWN0ZWQuICovXG4gIGlzQ29ubmVjdGVkKCkgeyByZXR1cm4gdGhpcy5fY29ubmVjdGVkIH1cblxuICAvKipcbiAgICogUmVzb2x2ZXMgb24gdGhlIGZpcnN0IHN1Y2Nlc3NmdWwgY29ubmVjdC4gU3Vic2VxdWVudCBjYWxscyByZXR1cm5cbiAgICogdGhlIHNhbWUgcHJvbWlzZS4gU3Vic2VxdWVudCByZWNvbm5lY3RzIGFmdGVyIGEgZHJvcCBhcmUgc2lsZW50IOKAlFxuICAgKiB1c2UgYG9uKFwiY29ubmVjdFwiKWAgLyBgb24oXCJkaXNjb25uZWN0XCIsIHJlYXNvbilgIHRvIG9ic2VydmUgdGhlbS5cbiAgICogVGhlIGBkaXNjb25uZWN0YCBsaXN0ZW5lciByZWNlaXZlcyBhbiBgRXJyb3JgIHJlYXNvbjogZWl0aGVyIHRoZVxuICAgKiB1bmRlcmx5aW5nIHNvY2tldCBlcnJvciwgb3IgYEVycm9yKFwiQmVhY29uIGJyb2tlciBkaXNjb25uZWN0ZWRcIilgXG4gICAqIHdoZW4gdGhlIGNsb3NlIGhhZCBubyBwcmVjZWRpbmcgZXJyb3IuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPHZvaWQ+fVxuICAgKi9cbiAgYXN5bmMgY29ubmVjdCgpIHtcbiAgICBpZiAodGhpcy5fY2xvc2VkKSB0aHJvdyBuZXcgRXJyb3IoXCJCZWFjb25DbGllbnQgaGFzIGJlZW4gY2xvc2VkXCIpXG4gICAgaWYgKHRoaXMuX2Nvbm5lY3RQcm9taXNlKSByZXR1cm4gYXdhaXQgdGhpcy5fY29ubmVjdFByb21pc2VcblxuICAgIHRoaXMuX2Nvbm5lY3RQcm9taXNlID0gbmV3IFByb21pc2UoKHJlc29sdmUsIHJlamVjdCkgPT4ge1xuICAgICAgY29uc3Qgb25Db25uZWN0ID0gKCkgPT4ge1xuICAgICAgICB0aGlzLm9mZihcImNvbm5lY3RcIiwgb25Db25uZWN0KVxuICAgICAgICB0aGlzLm9mZihcImNvbm5lY3QtZXJyb3JcIiwgb25FcnJvcilcbiAgICAgICAgcmVzb2x2ZSgpXG4gICAgICB9XG4gICAgICBjb25zdCBvbkVycm9yID0gKC8qKiBAdHlwZSB7RXJyb3J9ICovIGVycm9yKSA9PiB7XG4gICAgICAgIHRoaXMub2ZmKFwiY29ubmVjdFwiLCBvbkNvbm5lY3QpXG4gICAgICAgIHRoaXMub2ZmKFwiY29ubmVjdC1lcnJvclwiLCBvbkVycm9yKVxuICAgICAgICByZWplY3QoZXJyb3IpXG4gICAgICB9XG5cbiAgICAgIHRoaXMub24oXCJjb25uZWN0XCIsIG9uQ29ubmVjdClcbiAgICAgIHRoaXMub24oXCJjb25uZWN0LWVycm9yXCIsIG9uRXJyb3IpXG4gICAgfSlcblxuICAgIHRoaXMuX29wZW5Tb2NrZXQoKVxuXG4gICAgcmV0dXJuIGF3YWl0IHRoaXMuX2Nvbm5lY3RQcm9taXNlXG4gIH1cblxuICAvKipcbiAgICogUHVibGlzaGVzIGEgYnJvYWRjYXN0IG1lc3NhZ2UgdG8gYWxsIHBlZXJzIChpbmNsdWRpbmcgdGhpcyBvbmUsXG4gICAqIHVubGVzcyB0aGUgZGFlbW9uIGlzIHJlc3RhcnRlZCBtaWQtcHVibGlzaCkuXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBhcmdzIC0gQnJvYWRjYXN0IGFyZ3MuXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBhcmdzLmNoYW5uZWwgLSBDaGFubmVsIG5hbWUuXG4gICAqIEBwYXJhbSB7UmVjb3JkPHN0cmluZywgYW55Pn0gYXJncy5icm9hZGNhc3RQYXJhbXMgLSBSb3V0aW5nIHBhcmFtcy5cbiAgICogQHBhcmFtIHthbnl9IGFyZ3MuYm9keSAtIE1lc3NhZ2UgYm9keS5cbiAgICogQHJldHVybnMge2Jvb2xlYW59IC0gVHJ1ZSBpZiB0aGUgcHVibGlzaCB3YXMgd3JpdHRlbiB0byB0aGUgc29ja2V0LiBGYWxzZSBpZiB0aGUgY2xpZW50IGlzIGN1cnJlbnRseSBkaXNjb25uZWN0ZWQuXG4gICAqL1xuICBwdWJsaXNoKHtjaGFubmVsLCBicm9hZGNhc3RQYXJhbXMsIGJvZHl9KSB7XG4gICAgaWYgKCF0aGlzLl9jb25uZWN0ZWQgfHwgIXRoaXMuX2pzb25Tb2NrZXQpIHJldHVybiBmYWxzZVxuXG4gICAgLyoqIEB0eXBlIHtpbXBvcnQoXCIuL3R5cGVzLmpzXCIpLkJlYWNvbkJyb2FkY2FzdE1lc3NhZ2V9ICovXG4gICAgY29uc3QgbWVzc2FnZSA9IHtcbiAgICAgIHR5cGU6IFwiYnJvYWRjYXN0XCIsXG4gICAgICBjaGFubmVsLFxuICAgICAgYnJvYWRjYXN0UGFyYW1zLFxuICAgICAgYm9keSxcbiAgICAgIG9yaWdpblBlZXJJZDogdGhpcy5wZWVySWRcbiAgICB9XG5cbiAgICB0cnkge1xuICAgICAgdGhpcy5fanNvblNvY2tldC5zZW5kKG1lc3NhZ2UpXG4gICAgICByZXR1cm4gdHJ1ZVxuICAgIH0gY2F0Y2gge1xuICAgICAgcmV0dXJuIGZhbHNlXG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFJlZ2lzdGVycyBhIGhhbmRsZXIgY2FsbGVkIG9uY2UgZm9yIGV2ZXJ5IGBicm9hZGNhc3RgIG1lc3NhZ2VcbiAgICogcmVjZWl2ZWQgZnJvbSB0aGUgZGFlbW9uIChpbmNsdWRpbmcgZWNob2VzIG9mIHRoaXMgY2xpZW50J3Mgb3duXG4gICAqIHB1Ymxpc2hlcyDigJQgc3luYXBzZS1zdHlsZSBmYW4tb3V0KS5cbiAgICogQHBhcmFtIHtCZWFjb25Ccm9hZGNhc3RIYW5kbGVyfSBoYW5kbGVyIC0gSGFuZGxlci5cbiAgICogQHJldHVybnMgeygpID0+IHZvaWR9IC0gVW5yZWdpc3RlciBmdW5jdGlvbi5cbiAgICovXG4gIG9uQnJvYWRjYXN0KGhhbmRsZXIpIHtcbiAgICB0aGlzLm9uKFwiYnJvYWRjYXN0XCIsIGhhbmRsZXIpXG4gICAgcmV0dXJuICgpID0+IHRoaXMub2ZmKFwiYnJvYWRjYXN0XCIsIGhhbmRsZXIpXG4gIH1cblxuICAvKiogQHJldHVybnMge1Byb21pc2U8dm9pZD59IC0gUmVzb2x2ZXMgb25jZSB0aGUgc29ja2V0IGlzIGNsb3NlZC4gKi9cbiAgYXN5bmMgY2xvc2UoKSB7XG4gICAgdGhpcy5fY2xvc2VkID0gdHJ1ZVxuXG4gICAgaWYgKHRoaXMuX3JlY29ubmVjdFRpbWVyKSB7XG4gICAgICBjbGVhclRpbWVvdXQodGhpcy5fcmVjb25uZWN0VGltZXIpXG4gICAgICB0aGlzLl9yZWNvbm5lY3RUaW1lciA9IHVuZGVmaW5lZFxuICAgIH1cblxuICAgIGlmICh0aGlzLl9zb2NrZXQpIHtcbiAgICAgIGNvbnN0IHNvY2tldCA9IHRoaXMuX3NvY2tldFxuXG4gICAgICBhd2FpdCBuZXcgUHJvbWlzZSgocmVzb2x2ZSkgPT4ge1xuICAgICAgICBzb2NrZXQub25jZShcImNsb3NlXCIsICgpID0+IHJlc29sdmUodW5kZWZpbmVkKSlcbiAgICAgICAgc29ja2V0LmVuZCgpXG4gICAgICB9KVxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIF9vcGVuU29ja2V0KCkge1xuICAgIGlmICh0aGlzLl9jbG9zZWQpIHJldHVyblxuXG4gICAgY29uc3Qgc29ja2V0ID0gbmV0LmNyZWF0ZUNvbm5lY3Rpb24oe2hvc3Q6IHRoaXMuaG9zdCwgcG9ydDogdGhpcy5wb3J0fSlcbiAgICB0aGlzLl9zb2NrZXQgPSBzb2NrZXRcbiAgICBjb25zdCBqc29uU29ja2V0ID0gbmV3IEpzb25Tb2NrZXQoc29ja2V0KVxuICAgIHRoaXMuX2pzb25Tb2NrZXQgPSBqc29uU29ja2V0XG5cbiAgICBzb2NrZXQub24oXCJjb25uZWN0XCIsICgpID0+IHtcbiAgICAgIHRoaXMuX2Nvbm5lY3RlZCA9IHRydWVcbiAgICAgIHRoaXMuX3JlY29ubmVjdERlbGF5TXMgPSB0aGlzLl9pbml0aWFsUmVjb25uZWN0RGVsYXlNc1xuXG4gICAgICBqc29uU29ja2V0LnNlbmQoe1xuICAgICAgICB0eXBlOiBcImhlbGxvXCIsXG4gICAgICAgIHJvbGU6IFwiY2xpZW50XCIsXG4gICAgICAgIHBlZXJJZDogdGhpcy5wZWVySWQsXG4gICAgICAgIHBlZXJUeXBlOiB0aGlzLnBlZXJUeXBlXG4gICAgICB9KVxuXG4gICAgICB0aGlzLmVtaXQoXCJjb25uZWN0XCIpXG4gICAgfSlcblxuICAgIGpzb25Tb2NrZXQub24oXCJtZXNzYWdlXCIsICgvKiogQHR5cGUge2ltcG9ydChcIi4vdHlwZXMuanNcIikuQmVhY29uU29ja2V0TWVzc2FnZX0gKi8gbWVzc2FnZSkgPT4ge1xuICAgICAgaWYgKG1lc3NhZ2U/LnR5cGUgPT09IFwiYnJvYWRjYXN0XCIpIHtcbiAgICAgICAgdGhpcy5lbWl0KFwiYnJvYWRjYXN0XCIsIG1lc3NhZ2UpXG4gICAgICB9XG4gICAgfSlcblxuICAgIGpzb25Tb2NrZXQub24oXCJlcnJvclwiLCAoZXJyb3IpID0+IHtcbiAgICAgIGlmICghdGhpcy5fY29ubmVjdGVkKSB7XG4gICAgICAgIC8vIEluaXRpYWwgY29ubmVjdCBmYWlsZWQg4oCUIHN1cmZhY2UgdG8gYGNvbm5lY3QoKWAncyBwcm9taXNlIHZpYSBgY29ubmVjdC1lcnJvcmAuXG4gICAgICAgIC8vIE5vIGBlcnJvcmAgZW1pdDogdGhhdCBjaGFubmVsIGlzIGZvciBlc3RhYmxpc2hlZC1zZXNzaW9uIGVycm9yczsgdGhlXG4gICAgICAgIC8vIGluaXRpYWwtY29ubmVjdCBwYXRoIGlzIG93bmVkIGJ5IGBjb25uZWN0LWVycm9yYC5cbiAgICAgICAgdGhpcy5lbWl0KFwiY29ubmVjdC1lcnJvclwiLCBlcnJvcilcbiAgICAgIH0gZWxzZSB7XG4gICAgICAgIC8vIEVzdGFibGlzaGVkIHNlc3Npb24gZXJyb3IuIENhY2hlIHNvIHRoZSB1cGNvbWluZyBgY2xvc2VgIGV2ZW50IGNhblxuICAgICAgICAvLyBzdXJmYWNlIGl0IGFzIHRoZSBkaXNjb25uZWN0IHJlYXNvbi5cbiAgICAgICAgdGhpcy5fbGFzdFNvY2tldEVycm9yID0gZXJyb3JcbiAgICAgICAgdGhpcy5lbWl0KFwiZXJyb3JcIiwgZXJyb3IpXG4gICAgICB9XG4gICAgfSlcblxuICAgIGpzb25Tb2NrZXQub24oXCJjbG9zZVwiLCAoKSA9PiB7XG4gICAgICBjb25zdCB3YXNDb25uZWN0ZWQgPSB0aGlzLl9jb25uZWN0ZWRcblxuICAgICAgdGhpcy5fY29ubmVjdGVkID0gZmFsc2VcbiAgICAgIHRoaXMuX2pzb25Tb2NrZXQgPSB1bmRlZmluZWRcbiAgICAgIHRoaXMuX3NvY2tldCA9IHVuZGVmaW5lZFxuXG4gICAgICAvLyBFeHBsaWNpdCBjbG9zZSgpIHNldHMgYF9jbG9zZWQgPSB0cnVlYCBiZWZvcmUgZW5kaW5nIHRoZSBzb2NrZXQuXG4gICAgICAvLyBEb24ndCBzdXJmYWNlIHVzZXItaW5pdGlhdGVkIHRlYXJkb3duIGFzIGEgZGlzY29ubmVjdCBcImVycm9yXCIg4oCUXG4gICAgICAvLyBvbmx5IG5ldHdvcmstZHJpdmVuIGRyb3BzIHNob3VsZCBiZSByZXBvcnRlZC5cbiAgICAgIGlmICh3YXNDb25uZWN0ZWQgJiYgIXRoaXMuX2Nsb3NlZCkge1xuICAgICAgICBjb25zdCByZWFzb24gPSB0aGlzLl9sYXN0U29ja2V0RXJyb3IgfHwgbmV3IEVycm9yKFwiQmVhY29uIGJyb2tlciBkaXNjb25uZWN0ZWRcIilcblxuICAgICAgICB0aGlzLmVtaXQoXCJkaXNjb25uZWN0XCIsIHJlYXNvbilcbiAgICAgIH1cblxuICAgICAgdGhpcy5fbGFzdFNvY2tldEVycm9yID0gdW5kZWZpbmVkXG5cbiAgICAgIGlmICh0aGlzLl9jbG9zZWQpIHJldHVyblxuXG4gICAgICB0aGlzLl9zY2hlZHVsZVJlY29ubmVjdCgpXG4gICAgfSlcbiAgfVxuXG4gIC8qKlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIF9zY2hlZHVsZVJlY29ubmVjdCgpIHtcbiAgICBpZiAodGhpcy5fcmVjb25uZWN0VGltZXIpIHJldHVyblxuXG4gICAgY29uc3QgZGVsYXkgPSB0aGlzLl9yZWNvbm5lY3REZWxheU1zXG5cbiAgICB0aGlzLl9yZWNvbm5lY3RUaW1lciA9IHNldFRpbWVvdXQoKCkgPT4ge1xuICAgICAgdGhpcy5fcmVjb25uZWN0VGltZXIgPSB1bmRlZmluZWRcbiAgICAgIHRoaXMuX3JlY29ubmVjdERlbGF5TXMgPSBNYXRoLm1pbihkZWxheSAqIDIsIHRoaXMuX21heFJlY29ubmVjdERlbGF5TXMpXG4gICAgICB0aGlzLl9vcGVuU29ja2V0KClcbiAgICB9LCBkZWxheSlcbiAgfVxufVxuIl19

package/build/src/beacon/in-process-broker.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Registers a peer with the broker. Returns an unregister function.
+ * @param {InProcessPeer} peer - Peer instance.
+ * @returns {() => void} - Unregister function.
+ */
+export function registerInProcessPeer(peer: InProcessPeer): () => void;
+/**
+ * Schedules a fan-out of the given message to every registered peer.
+ * Each delivery is its own microtask so handlers run in the order peers
+ * registered, but never synchronously inside the publish call.
+ * @param {import("./types.js").BeaconBroadcastMessage} message - Broadcast message.
+ * @returns {void}
+ */
+export function publishToInProcessPeers(message: import("./types.js").BeaconBroadcastMessage): void;
+/**
+ * @returns {number} - Current peer count. Exposed for diagnostics and tests.
+ */
+export function getInProcessPeerCount(): number;
+export type InProcessPeer = {
+    _receiveBroadcast: (message: import("./types.js").BeaconBroadcastMessage) => void;
+};
+//# sourceMappingURL=in-process-broker.d.ts.map

package/build/src/beacon/in-process-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-broker.d.ts","sourceRoot":"","sources":["../../../src/beacon/in-process-broker.js"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,4CAHW,aAAa,GACX,MAAM,IAAI,CAQtB;AAED;;;;;;GAMG;AACH,iDAHW,OAAO,YAAY,EAAE,sBAAsB,GACzC,IAAI,CAehB;AAED;;GAEG;AACH,yCAFa,MAAM,CAIlB;4BA7Ca;IAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,OAAO,YAAY,EAAE,sBAAsB,KAAK,IAAI,CAAA;CAAC"}

package/build/src/beacon/in-process-broker.js

@@ -0,0 +1,61 @@
+// @ts-check
+/**
+ * Module-level broker singleton for in-process Beacon mode.
+ *
+ * Every `InProcessBeaconClient` registers itself here on `connect()` and
+ * unregisters on `close()`. `publish(message)` schedules a microtask
+ * fan-out to every registered peer's `_receiveBroadcast(message)`. The
+ * microtask boundary keeps "publish, then receive" ordering safe even
+ * when the publisher and a subscriber are the same client — without it,
+ * a synchronous fan-out could re-enter the caller mid-publish if a
+ * broadcast handler synchronously published again.
+ *
+ * Designed for two scenarios:
+ *   1. Tests with multiple `Configuration` instances in one process
+ *      (no TCP socket setup, deterministic ordering via microtasks).
+ *   2. Single-process production deployments that want the same
+ *      `broadcastToChannel` ergonomics without running the daemon.
+ */
+/** @typedef {{_receiveBroadcast: (message: import("./types.js").BeaconBroadcastMessage) => void}} InProcessPeer */
+/** @type {Set<InProcessPeer>} */
+const peers = new Set();
+/**
+ * Registers a peer with the broker. Returns an unregister function.
+ * @param {InProcessPeer} peer - Peer instance.
+ * @returns {() => void} - Unregister function.
+ */
+export function registerInProcessPeer(peer) {
+    peers.add(peer);
+    return () => {
+        peers.delete(peer);
+    };
+}
+/**
+ * Schedules a fan-out of the given message to every registered peer.
+ * Each delivery is its own microtask so handlers run in the order peers
+ * registered, but never synchronously inside the publish call.
+ * @param {import("./types.js").BeaconBroadcastMessage} message - Broadcast message.
+ * @returns {void}
+ */
+export function publishToInProcessPeers(message) {
+    for (const peer of peers) {
+        queueMicrotask(() => {
+            try {
+                peer._receiveBroadcast(message);
+            }
+            catch (error) {
+                // Mirrors the daemon's per-peer fan-out resilience: a thrown
+                // handler on one peer must not prevent delivery to others. The
+                // caller's framework-error path covers higher-level reporting.
+                console.error("In-process Beacon peer threw during broadcast delivery:", error);
+            }
+        });
+    }
+}
+/**
+ * @returns {number} - Current peer count. Exposed for diagnostics and tests.
+ */
+export function getInProcessPeerCount() {
+    return peers.size;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW4tcHJvY2Vzcy1icm9rZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmVhY29uL2luLXByb2Nlc3MtYnJva2VyLmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLFlBQVk7QUFFWjs7Ozs7Ozs7Ozs7Ozs7OztHQWdCRztBQUVILG1IQUFtSDtBQUVuSCxpQ0FBaUM7QUFDakMsTUFBTSxLQUFLLEdBQUcsSUFBSSxHQUFHLEVBQUUsQ0FBQTtBQUV2Qjs7OztHQUlHO0FBQ0gsTUFBTSxVQUFVLHFCQUFxQixDQUFDLElBQUk7SUFDeEMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsQ0FBQTtJQUVmLE9BQU8sR0FBRyxFQUFFO1FBQ1YsS0FBSyxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQTtJQUNwQixDQUFDLENBQUE7QUFDSCxDQUFDO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsTUFBTSxVQUFVLHVCQUF1QixDQUFDLE9BQU87SUFDN0MsS0FBSyxNQUFNLElBQUksSUFBSSxLQUFLLEVBQUUsQ0FBQztRQUN6QixjQUFjLENBQUMsR0FBRyxFQUFFO1lBQ2xCLElBQUksQ0FBQztnQkFDSCxJQUFJLENBQUMsaUJBQWlCLENBQUMsT0FBTyxDQUFDLENBQUE7WUFDakMsQ0FBQztZQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7Z0JBQ2YsNkRBQTZEO2dCQUM3RCwrREFBK0Q7Z0JBQy9ELCtEQUErRDtnQkFDL0QsT0FBTyxDQUFDLEtBQUssQ0FBQyx5REFBeUQsRUFBRSxLQUFLLENBQUMsQ0FBQTtZQUNqRixDQUFDO1FBQ0gsQ0FBQyxDQUFDLENBQUE7SUFDSixDQUFDO0FBQ0gsQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLHFCQUFxQjtJQUNuQyxPQUFPLEtBQUssQ0FBQyxJQUFJLENBQUE7QUFDbkIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG4vKipcbiAqIE1vZHVsZS1sZXZlbCBicm9rZXIgc2luZ2xldG9uIGZvciBpbi1wcm9jZXNzIEJlYWNvbiBtb2RlLlxuICpcbiAqIEV2ZXJ5IGBJblByb2Nlc3NCZWFjb25DbGllbnRgIHJlZ2lzdGVycyBpdHNlbGYgaGVyZSBvbiBgY29ubmVjdCgpYCBhbmRcbiAqIHVucmVnaXN0ZXJzIG9uIGBjbG9zZSgpYC4gYHB1Ymxpc2gobWVzc2FnZSlgIHNjaGVkdWxlcyBhIG1pY3JvdGFza1xuICogZmFuLW91dCB0byBldmVyeSByZWdpc3RlcmVkIHBlZXIncyBgX3JlY2VpdmVCcm9hZGNhc3QobWVzc2FnZSlgLiBUaGVcbiAqIG1pY3JvdGFzayBib3VuZGFyeSBrZWVwcyBcInB1Ymxpc2gsIHRoZW4gcmVjZWl2ZVwiIG9yZGVyaW5nIHNhZmUgZXZlblxuICogd2hlbiB0aGUgcHVibGlzaGVyIGFuZCBhIHN1YnNjcmliZXIgYXJlIHRoZSBzYW1lIGNsaWVudCDigJQgd2l0aG91dCBpdCxcbiAqIGEgc3luY2hyb25vdXMgZmFuLW91dCBjb3VsZCByZS1lbnRlciB0aGUgY2FsbGVyIG1pZC1wdWJsaXNoIGlmIGFcbiAqIGJyb2FkY2FzdCBoYW5kbGVyIHN5bmNocm9ub3VzbHkgcHVibGlzaGVkIGFnYWluLlxuICpcbiAqIERlc2lnbmVkIGZvciB0d28gc2NlbmFyaW9zOlxuICogICAxLiBUZXN0cyB3aXRoIG11bHRpcGxlIGBDb25maWd1cmF0aW9uYCBpbnN0YW5jZXMgaW4gb25lIHByb2Nlc3NcbiAqICAgICAgKG5vIFRDUCBzb2NrZXQgc2V0dXAsIGRldGVybWluaXN0aWMgb3JkZXJpbmcgdmlhIG1pY3JvdGFza3MpLlxuICogICAyLiBTaW5nbGUtcHJvY2VzcyBwcm9kdWN0aW9uIGRlcGxveW1lbnRzIHRoYXQgd2FudCB0aGUgc2FtZVxuICogICAgICBgYnJvYWRjYXN0VG9DaGFubmVsYCBlcmdvbm9taWNzIHdpdGhvdXQgcnVubmluZyB0aGUgZGFlbW9uLlxuICovXG5cbi8qKiBAdHlwZWRlZiB7e19yZWNlaXZlQnJvYWRjYXN0OiAobWVzc2FnZTogaW1wb3J0KFwiLi90eXBlcy5qc1wiKS5CZWFjb25Ccm9hZGNhc3RNZXNzYWdlKSA9PiB2b2lkfX0gSW5Qcm9jZXNzUGVlciAqL1xuXG4vKiogQHR5cGUge1NldDxJblByb2Nlc3NQZWVyPn0gKi9cbmNvbnN0IHBlZXJzID0gbmV3IFNldCgpXG5cbi8qKlxuICogUmVnaXN0ZXJzIGEgcGVlciB3aXRoIHRoZSBicm9rZXIuIFJldHVybnMgYW4gdW5yZWdpc3RlciBmdW5jdGlvbi5cbiAqIEBwYXJhbSB7SW5Qcm9jZXNzUGVlcn0gcGVlciAtIFBlZXIgaW5zdGFuY2UuXG4gKiBAcmV0dXJucyB7KCkgPT4gdm9pZH0gLSBVbnJlZ2lzdGVyIGZ1bmN0aW9uLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVnaXN0ZXJJblByb2Nlc3NQZWVyKHBlZXIpIHtcbiAgcGVlcnMuYWRkKHBlZXIpXG5cbiAgcmV0dXJuICgpID0+IHtcbiAgICBwZWVycy5kZWxldGUocGVlcilcbiAgfVxufVxuXG4vKipcbiAqIFNjaGVkdWxlcyBhIGZhbi1vdXQgb2YgdGhlIGdpdmVuIG1lc3NhZ2UgdG8gZXZlcnkgcmVnaXN0ZXJlZCBwZWVyLlxuICogRWFjaCBkZWxpdmVyeSBpcyBpdHMgb3duIG1pY3JvdGFzayBzbyBoYW5kbGVycyBydW4gaW4gdGhlIG9yZGVyIHBlZXJzXG4gKiByZWdpc3RlcmVkLCBidXQgbmV2ZXIgc3luY2hyb25vdXNseSBpbnNpZGUgdGhlIHB1Ymxpc2ggY2FsbC5cbiAqIEBwYXJhbSB7aW1wb3J0KFwiLi90eXBlcy5qc1wiKS5CZWFjb25Ccm9hZGNhc3RNZXNzYWdlfSBtZXNzYWdlIC0gQnJvYWRjYXN0IG1lc3NhZ2UuXG4gKiBAcmV0dXJucyB7dm9pZH1cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHB1Ymxpc2hUb0luUHJvY2Vzc1BlZXJzKG1lc3NhZ2UpIHtcbiAgZm9yIChjb25zdCBwZWVyIG9mIHBlZXJzKSB7XG4gICAgcXVldWVNaWNyb3Rhc2soKCkgPT4ge1xuICAgICAgdHJ5IHtcbiAgICAgICAgcGVlci5fcmVjZWl2ZUJyb2FkY2FzdChtZXNzYWdlKVxuICAgICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgICAgLy8gTWlycm9ycyB0aGUgZGFlbW9uJ3MgcGVyLXBlZXIgZmFuLW91dCByZXNpbGllbmNlOiBhIHRocm93blxuICAgICAgICAvLyBoYW5kbGVyIG9uIG9uZSBwZWVyIG11c3Qgbm90IHByZXZlbnQgZGVsaXZlcnkgdG8gb3RoZXJzLiBUaGVcbiAgICAgICAgLy8gY2FsbGVyJ3MgZnJhbWV3b3JrLWVycm9yIHBhdGggY292ZXJzIGhpZ2hlci1sZXZlbCByZXBvcnRpbmcuXG4gICAgICAgIGNvbnNvbGUuZXJyb3IoXCJJbi1wcm9jZXNzIEJlYWNvbiBwZWVyIHRocmV3IGR1cmluZyBicm9hZGNhc3QgZGVsaXZlcnk6XCIsIGVycm9yKVxuICAgICAgfVxuICAgIH0pXG4gIH1cbn1cblxuLyoqXG4gKiBAcmV0dXJucyB7bnVtYmVyfSAtIEN1cnJlbnQgcGVlciBjb3VudC4gRXhwb3NlZCBmb3IgZGlhZ25vc3RpY3MgYW5kIHRlc3RzLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0SW5Qcm9jZXNzUGVlckNvdW50KCkge1xuICByZXR1cm4gcGVlcnMuc2l6ZVxufVxuIl19

package/build/src/beacon/in-process-client.d.ts

@@ -0,0 +1,74 @@
+declare const InProcessBeaconClient_base: typeof import("eventemitter3").EventEmitter;
+/**
+ * @typedef {function(import("./types.js").BeaconBroadcastMessage): void} BeaconBroadcastHandler
+ */
+/**
+ * In-process counterpart to `BeaconClient`. Registers with the
+ * module-level `in-process-broker` singleton so peers in the same
+ * process exchange broadcasts without ever touching TCP. Implements the
+ * same external surface as `BeaconClient` (`connect`, `publish`,
+ * `onBroadcast`, `isConnected`, `getPeerId`, `close`) so
+ * `Configuration` can use either client interchangeably.
+ *
+ * Lifecycle differs from `BeaconClient` in two intentional ways:
+ *   - `connect()` resolves immediately; there is no broker to wait for.
+ *   - There is no reconnect loop and no `connect-error` / `disconnect`
+ *     event surface, because nothing can fail.
+ */
+export default class InProcessBeaconClient extends InProcessBeaconClient_base {
+    /**
+     * @param {object} [args] - Options.
+     * @param {string} [args.peerType] - Optional human-readable peer label.
+     * @param {string} [args.peerId] - Optional explicit peer id (defaults to a random UUID).
+     */
+    constructor({ peerType, peerId }?: {
+        peerType?: string | undefined;
+        peerId?: string | undefined;
+    });
+    peerType: string | undefined;
+    peerId: string;
+    _connected: boolean;
+    /** @type {(() => void) | undefined} */
+    _unregister: (() => void) | undefined;
+    /** @returns {string} - Peer id. */
+    getPeerId(): string;
+    /** @returns {boolean} - Whether the peer is registered with the broker. */
+    isConnected(): boolean;
+    /**
+     * Registers with the in-process broker. Idempotent.
+     * @returns {Promise<void>}
+     */
+    connect(): Promise<void>;
+    /**
+     * Publishes a broadcast to every registered peer (including this
+     * one). Returns false if `connect()` hasn't been called yet, matching
+     * `BeaconClient` semantics.
+     * @param {object} args - Broadcast args.
+     * @param {string} args.channel - Channel name.
+     * @param {Record<string, any>} args.broadcastParams - Routing params.
+     * @param {any} args.body - Message body.
+     * @returns {boolean} - True when the broadcast was queued.
+     */
+    publish({ channel, broadcastParams, body }: {
+        channel: string;
+        broadcastParams: Record<string, any>;
+        body: any;
+    }): boolean;
+    /**
+     * Registers a handler called once for every broadcast received.
+     * @param {BeaconBroadcastHandler} handler - Handler.
+     * @returns {() => void} - Unregister function.
+     */
+    onBroadcast(handler: BeaconBroadcastHandler): () => void;
+    /**
+     * Receives a broadcast from the broker. Called by `in-process-broker`.
+     * @param {import("./types.js").BeaconBroadcastMessage} message - Broadcast message.
+     * @returns {void}
+     */
+    _receiveBroadcast(message: import("./types.js").BeaconBroadcastMessage): void;
+    /** @returns {Promise<void>} - Unregisters from the broker. */
+    close(): Promise<void>;
+}
+export type BeaconBroadcastHandler = (arg0: import("./types.js").BeaconBroadcastMessage) => void;
+export {};
+//# sourceMappingURL=in-process-client.d.ts.map

package/build/src/beacon/in-process-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-client.d.ts","sourceRoot":"","sources":["../../../src/beacon/in-process-client.js"],"names":[],"mappings":";AAOA;;GAEG;AAEH;;;;;;;;;;;;GAYG;AACH;IACE;;;;OAIG;IACH,mCAHG;QAAsB,QAAQ;QACR,MAAM;KAC9B,EAQA;IALC,6BAAwB;IACxB,eAAoC;IACpC,oBAAuB;IACvB,uCAAuC;IACvC,aADW,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CACP;IAG9B,mCAAmC;IACnC,aADc,MAAM,CACc;IAElC,2EAA2E;IAC3E,eADc,OAAO,CACmB;IAExC;;;OAGG;IACH,WAFa,OAAO,CAAC,IAAI,CAAC,CAQzB;IAED;;;;;;;;;OASG;IACH,4CALG;QAAqB,OAAO,EAApB,MAAM;QACoB,eAAe,EAAzC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;QACT,IAAI,EAAd,GAAG;KACX,GAAU,OAAO,CAiBnB;IAED;;;;OAIG;IACH,qBAHW,sBAAsB,GACpB,MAAM,IAAI,CAKtB;IAED;;;;OAIG;IACH,2BAHW,OAAO,YAAY,EAAE,sBAAsB,GACzC,IAAI,CAIhB;IAED,8DAA8D;IAC9D,SADc,OAAO,CAAC,IAAI,CAAC,CAK1B;CACF;qCArGY,CAAS,IAA2C,EAA3C,OAAO,YAAY,EAAE,sBAAsB,KAAG,IAAI"}

package/build/src/beacon/in-process-client.js

@@ -0,0 +1,99 @@
+// @ts-check
+import { randomUUID } from "node:crypto";
+import EventEmitter from "../utils/event-emitter.js";
+import { publishToInProcessPeers, registerInProcessPeer } from "./in-process-broker.js";
+/**
+ * @typedef {function(import("./types.js").BeaconBroadcastMessage): void} BeaconBroadcastHandler
+ */
+/**
+ * In-process counterpart to `BeaconClient`. Registers with the
+ * module-level `in-process-broker` singleton so peers in the same
+ * process exchange broadcasts without ever touching TCP. Implements the
+ * same external surface as `BeaconClient` (`connect`, `publish`,
+ * `onBroadcast`, `isConnected`, `getPeerId`, `close`) so
+ * `Configuration` can use either client interchangeably.
+ *
+ * Lifecycle differs from `BeaconClient` in two intentional ways:
+ *   - `connect()` resolves immediately; there is no broker to wait for.
+ *   - There is no reconnect loop and no `connect-error` / `disconnect`
+ *     event surface, because nothing can fail.
+ */
+export default class InProcessBeaconClient extends EventEmitter {
+    /**
+     * @param {object} [args] - Options.
+     * @param {string} [args.peerType] - Optional human-readable peer label.
+     * @param {string} [args.peerId] - Optional explicit peer id (defaults to a random UUID).
+     */
+    constructor({ peerType, peerId } = {}) {
+        super();
+        this.peerType = peerType;
+        this.peerId = peerId || randomUUID();
+        this._connected = false;
+        /** @type {(() => void) | undefined} */
+        this._unregister = undefined;
+    }
+    /** @returns {string} - Peer id. */
+    getPeerId() { return this.peerId; }
+    /** @returns {boolean} - Whether the peer is registered with the broker. */
+    isConnected() { return this._connected; }
+    /**
+     * Registers with the in-process broker. Idempotent.
+     * @returns {Promise<void>}
+     */
+    async connect() {
+        if (this._connected)
+            return;
+        this._unregister = registerInProcessPeer(this);
+        this._connected = true;
+        this.emit("connect");
+    }
+    /**
+     * Publishes a broadcast to every registered peer (including this
+     * one). Returns false if `connect()` hasn't been called yet, matching
+     * `BeaconClient` semantics.
+     * @param {object} args - Broadcast args.
+     * @param {string} args.channel - Channel name.
+     * @param {Record<string, any>} args.broadcastParams - Routing params.
+     * @param {any} args.body - Message body.
+     * @returns {boolean} - True when the broadcast was queued.
+     */
+    publish({ channel, broadcastParams, body }) {
+        if (!this._connected)
+            return false;
+        /** @type {import("./types.js").BeaconBroadcastMessage} */
+        const message = {
+            type: "broadcast",
+            channel,
+            broadcastParams,
+            body,
+            originPeerId: this.peerId
+        };
+        publishToInProcessPeers(message);
+        return true;
+    }
+    /**
+     * Registers a handler called once for every broadcast received.
+     * @param {BeaconBroadcastHandler} handler - Handler.
+     * @returns {() => void} - Unregister function.
+     */
+    onBroadcast(handler) {
+        this.on("broadcast", handler);
+        return () => this.off("broadcast", handler);
+    }
+    /**
+     * Receives a broadcast from the broker. Called by `in-process-broker`.
+     * @param {import("./types.js").BeaconBroadcastMessage} message - Broadcast message.
+     * @returns {void}
+     */
+    _receiveBroadcast(message) {
+        this.emit("broadcast", message);
+    }
+    /** @returns {Promise<void>} - Unregisters from the broker. */
+    async close() {
+        if (this._unregister)
+            this._unregister();
+        this._unregister = undefined;
+        this._connected = false;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW4tcHJvY2Vzcy1jbGllbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmVhY29uL2luLXByb2Nlc3MtY2xpZW50LmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLFlBQVk7QUFFWixPQUFPLEVBQUMsVUFBVSxFQUFDLE1BQU0sYUFBYSxDQUFBO0FBRXRDLE9BQU8sWUFBWSxNQUFNLDJCQUEyQixDQUFBO0FBQ3BELE9BQU8sRUFBQyx1QkFBdUIsRUFBRSxxQkFBcUIsRUFBQyxNQUFNLHdCQUF3QixDQUFBO0FBRXJGOztHQUVHO0FBRUg7Ozs7Ozs7Ozs7OztHQVlHO0FBQ0gsTUFBTSxDQUFDLE9BQU8sT0FBTyxxQkFBc0IsU0FBUSxZQUFZO0lBQzdEOzs7O09BSUc7SUFDSCxZQUFZLEVBQUMsUUFBUSxFQUFFLE1BQU0sRUFBQyxHQUFHLEVBQUU7UUFDakMsS0FBSyxFQUFFLENBQUE7UUFDUCxJQUFJLENBQUMsUUFBUSxHQUFHLFFBQVEsQ0FBQTtRQUN4QixJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sSUFBSSxVQUFVLEVBQUUsQ0FBQTtRQUNwQyxJQUFJLENBQUMsVUFBVSxHQUFHLEtBQUssQ0FBQTtRQUN2Qix1Q0FBdUM7UUFDdkMsSUFBSSxDQUFDLFdBQVcsR0FBRyxTQUFTLENBQUE7SUFDOUIsQ0FBQztJQUVELG1DQUFtQztJQUNuQyxTQUFTLEtBQUssT0FBTyxJQUFJLENBQUMsTUFBTSxDQUFBLENBQUMsQ0FBQztJQUVsQywyRUFBMkU7SUFDM0UsV0FBVyxLQUFLLE9BQU8sSUFBSSxDQUFDLFVBQVUsQ0FBQSxDQUFDLENBQUM7SUFFeEM7OztPQUdHO0lBQ0gsS0FBSyxDQUFDLE9BQU87UUFDWCxJQUFJLElBQUksQ0FBQyxVQUFVO1lBQUUsT0FBTTtRQUUzQixJQUFJLENBQUMsV0FBVyxHQUFHLHFCQUFxQixDQUFDLElBQUksQ0FBQyxDQUFBO1FBQzlDLElBQUksQ0FBQyxVQUFVLEdBQUcsSUFBSSxDQUFBO1FBQ3RCLElBQUksQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUE7SUFDdEIsQ0FBQztJQUVEOzs7Ozs7Ozs7T0FTRztJQUNILE9BQU8sQ0FBQyxFQUFDLE9BQU8sRUFBRSxlQUFlLEVBQUUsSUFBSSxFQUFDO1FBQ3RDLElBQUksQ0FBQyxJQUFJLENBQUMsVUFBVTtZQUFFLE9BQU8sS0FBSyxDQUFBO1FBRWxDLDBEQUEwRDtRQUMxRCxNQUFNLE9BQU8sR0FBRztZQUNkLElBQUksRUFBRSxXQUFXO1lBQ2pCLE9BQU87WUFDUCxlQUFlO1lBQ2YsSUFBSTtZQUNKLFlBQVksRUFBRSxJQUFJLENBQUMsTUFBTTtTQUMxQixDQUFBO1FBRUQsdUJBQXVCLENBQUMsT0FBTyxDQUFDLENBQUE7UUFFaEMsT0FBTyxJQUFJLENBQUE7SUFDYixDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILFdBQVcsQ0FBQyxPQUFPO1FBQ2pCLElBQUksQ0FBQyxFQUFFLENBQUMsV0FBVyxFQUFFLE9BQU8sQ0FBQyxDQUFBO1FBQzdCLE9BQU8sR0FBRyxFQUFFLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxXQUFXLEVBQUUsT0FBTyxDQUFDLENBQUE7SUFDN0MsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxpQkFBaUIsQ0FBQyxPQUFPO1FBQ3ZCLElBQUksQ0FBQyxJQUFJLENBQUMsV0FBVyxFQUFFLE9BQU8sQ0FBQyxDQUFBO0lBQ2pDLENBQUM7SUFFRCw4REFBOEQ7SUFDOUQsS0FBSyxDQUFDLEtBQUs7UUFDVCxJQUFJLElBQUksQ0FBQyxXQUFXO1lBQUUsSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFBO1FBQ3hDLElBQUksQ0FBQyxXQUFXLEdBQUcsU0FBUyxDQUFBO1FBQzVCLElBQUksQ0FBQyxVQUFVLEdBQUcsS0FBSyxDQUFBO0lBQ3pCLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5pbXBvcnQge3JhbmRvbVVVSUR9IGZyb20gXCJub2RlOmNyeXB0b1wiXG5cbmltcG9ydCBFdmVudEVtaXR0ZXIgZnJvbSBcIi4uL3V0aWxzL2V2ZW50LWVtaXR0ZXIuanNcIlxuaW1wb3J0IHtwdWJsaXNoVG9JblByb2Nlc3NQZWVycywgcmVnaXN0ZXJJblByb2Nlc3NQZWVyfSBmcm9tIFwiLi9pbi1wcm9jZXNzLWJyb2tlci5qc1wiXG5cbi8qKlxuICogQHR5cGVkZWYge2Z1bmN0aW9uKGltcG9ydChcIi4vdHlwZXMuanNcIikuQmVhY29uQnJvYWRjYXN0TWVzc2FnZSk6IHZvaWR9IEJlYWNvbkJyb2FkY2FzdEhhbmRsZXJcbiAqL1xuXG4vKipcbiAqIEluLXByb2Nlc3MgY291bnRlcnBhcnQgdG8gYEJlYWNvbkNsaWVudGAuIFJlZ2lzdGVycyB3aXRoIHRoZVxuICogbW9kdWxlLWxldmVsIGBpbi1wcm9jZXNzLWJyb2tlcmAgc2luZ2xldG9uIHNvIHBlZXJzIGluIHRoZSBzYW1lXG4gKiBwcm9jZXNzIGV4Y2hhbmdlIGJyb2FkY2FzdHMgd2l0aG91dCBldmVyIHRvdWNoaW5nIFRDUC4gSW1wbGVtZW50cyB0aGVcbiAqIHNhbWUgZXh0ZXJuYWwgc3VyZmFjZSBhcyBgQmVhY29uQ2xpZW50YCAoYGNvbm5lY3RgLCBgcHVibGlzaGAsXG4gKiBgb25Ccm9hZGNhc3RgLCBgaXNDb25uZWN0ZWRgLCBgZ2V0UGVlcklkYCwgYGNsb3NlYCkgc29cbiAqIGBDb25maWd1cmF0aW9uYCBjYW4gdXNlIGVpdGhlciBjbGllbnQgaW50ZXJjaGFuZ2VhYmx5LlxuICpcbiAqIExpZmVjeWNsZSBkaWZmZXJzIGZyb20gYEJlYWNvbkNsaWVudGAgaW4gdHdvIGludGVudGlvbmFsIHdheXM6XG4gKiAgIC0gYGNvbm5lY3QoKWAgcmVzb2x2ZXMgaW1tZWRpYXRlbHk7IHRoZXJlIGlzIG5vIGJyb2tlciB0byB3YWl0IGZvci5cbiAqICAgLSBUaGVyZSBpcyBubyByZWNvbm5lY3QgbG9vcCBhbmQgbm8gYGNvbm5lY3QtZXJyb3JgIC8gYGRpc2Nvbm5lY3RgXG4gKiAgICAgZXZlbnQgc3VyZmFjZSwgYmVjYXVzZSBub3RoaW5nIGNhbiBmYWlsLlxuICovXG5leHBvcnQgZGVmYXVsdCBjbGFzcyBJblByb2Nlc3NCZWFjb25DbGllbnQgZXh0ZW5kcyBFdmVudEVtaXR0ZXIge1xuICAvKipcbiAgICogQHBhcmFtIHtvYmplY3R9IFthcmdzXSAtIE9wdGlvbnMuXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBbYXJncy5wZWVyVHlwZV0gLSBPcHRpb25hbCBodW1hbi1yZWFkYWJsZSBwZWVyIGxhYmVsLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gW2FyZ3MucGVlcklkXSAtIE9wdGlvbmFsIGV4cGxpY2l0IHBlZXIgaWQgKGRlZmF1bHRzIHRvIGEgcmFuZG9tIFVVSUQpLlxuICAgKi9cbiAgY29uc3RydWN0b3Ioe3BlZXJUeXBlLCBwZWVySWR9ID0ge30pIHtcbiAgICBzdXBlcigpXG4gICAgdGhpcy5wZWVyVHlwZSA9IHBlZXJUeXBlXG4gICAgdGhpcy5wZWVySWQgPSBwZWVySWQgfHwgcmFuZG9tVVVJRCgpXG4gICAgdGhpcy5fY29ubmVjdGVkID0gZmFsc2VcbiAgICAvKiogQHR5cGUgeygoKSA9PiB2b2lkKSB8IHVuZGVmaW5lZH0gKi9cbiAgICB0aGlzLl91bnJlZ2lzdGVyID0gdW5kZWZpbmVkXG4gIH1cblxuICAvKiogQHJldHVybnMge3N0cmluZ30gLSBQZWVyIGlkLiAqL1xuICBnZXRQZWVySWQoKSB7IHJldHVybiB0aGlzLnBlZXJJZCB9XG5cbiAgLyoqIEByZXR1cm5zIHtib29sZWFufSAtIFdoZXRoZXIgdGhlIHBlZXIgaXMgcmVnaXN0ZXJlZCB3aXRoIHRoZSBicm9rZXIuICovXG4gIGlzQ29ubmVjdGVkKCkgeyByZXR1cm4gdGhpcy5fY29ubmVjdGVkIH1cblxuICAvKipcbiAgICogUmVnaXN0ZXJzIHdpdGggdGhlIGluLXByb2Nlc3MgYnJva2VyLiBJZGVtcG90ZW50LlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTx2b2lkPn1cbiAgICovXG4gIGFzeW5jIGNvbm5lY3QoKSB7XG4gICAgaWYgKHRoaXMuX2Nvbm5lY3RlZCkgcmV0dXJuXG5cbiAgICB0aGlzLl91bnJlZ2lzdGVyID0gcmVnaXN0ZXJJblByb2Nlc3NQZWVyKHRoaXMpXG4gICAgdGhpcy5fY29ubmVjdGVkID0gdHJ1ZVxuICAgIHRoaXMuZW1pdChcImNvbm5lY3RcIilcbiAgfVxuXG4gIC8qKlxuICAgKiBQdWJsaXNoZXMgYSBicm9hZGNhc3QgdG8gZXZlcnkgcmVnaXN0ZXJlZCBwZWVyIChpbmNsdWRpbmcgdGhpc1xuICAgKiBvbmUpLiBSZXR1cm5zIGZhbHNlIGlmIGBjb25uZWN0KClgIGhhc24ndCBiZWVuIGNhbGxlZCB5ZXQsIG1hdGNoaW5nXG4gICAqIGBCZWFjb25DbGllbnRgIHNlbWFudGljcy5cbiAgICogQHBhcmFtIHtvYmplY3R9IGFyZ3MgLSBCcm9hZGNhc3QgYXJncy5cbiAgICogQHBhcmFtIHtzdHJpbmd9IGFyZ3MuY2hhbm5lbCAtIENoYW5uZWwgbmFtZS5cbiAgICogQHBhcmFtIHtSZWNvcmQ8c3RyaW5nLCBhbnk+fSBhcmdzLmJyb2FkY2FzdFBhcmFtcyAtIFJvdXRpbmcgcGFyYW1zLlxuICAgKiBAcGFyYW0ge2FueX0gYXJncy5ib2R5IC0gTWVzc2FnZSBib2R5LlxuICAgKiBAcmV0dXJucyB7Ym9vbGVhbn0gLSBUcnVlIHdoZW4gdGhlIGJyb2FkY2FzdCB3YXMgcXVldWVkLlxuICAgKi9cbiAgcHVibGlzaCh7Y2hhbm5lbCwgYnJvYWRjYXN0UGFyYW1zLCBib2R5fSkge1xuICAgIGlmICghdGhpcy5fY29ubmVjdGVkKSByZXR1cm4gZmFsc2VcblxuICAgIC8qKiBAdHlwZSB7aW1wb3J0KFwiLi90eXBlcy5qc1wiKS5CZWFjb25Ccm9hZGNhc3RNZXNzYWdlfSAqL1xuICAgIGNvbnN0IG1lc3NhZ2UgPSB7XG4gICAgICB0eXBlOiBcImJyb2FkY2FzdFwiLFxuICAgICAgY2hhbm5lbCxcbiAgICAgIGJyb2FkY2FzdFBhcmFtcyxcbiAgICAgIGJvZHksXG4gICAgICBvcmlnaW5QZWVySWQ6IHRoaXMucGVlcklkXG4gICAgfVxuXG4gICAgcHVibGlzaFRvSW5Qcm9jZXNzUGVlcnMobWVzc2FnZSlcblxuICAgIHJldHVybiB0cnVlXG4gIH1cblxuICAvKipcbiAgICogUmVnaXN0ZXJzIGEgaGFuZGxlciBjYWxsZWQgb25jZSBmb3IgZXZlcnkgYnJvYWRjYXN0IHJlY2VpdmVkLlxuICAgKiBAcGFyYW0ge0JlYWNvbkJyb2FkY2FzdEhhbmRsZXJ9IGhhbmRsZXIgLSBIYW5kbGVyLlxuICAgKiBAcmV0dXJucyB7KCkgPT4gdm9pZH0gLSBVbnJlZ2lzdGVyIGZ1bmN0aW9uLlxuICAgKi9cbiAgb25Ccm9hZGNhc3QoaGFuZGxlcikge1xuICAgIHRoaXMub24oXCJicm9hZGNhc3RcIiwgaGFuZGxlcilcbiAgICByZXR1cm4gKCkgPT4gdGhpcy5vZmYoXCJicm9hZGNhc3RcIiwgaGFuZGxlcilcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWNlaXZlcyBhIGJyb2FkY2FzdCBmcm9tIHRoZSBicm9rZXIuIENhbGxlZCBieSBgaW4tcHJvY2Vzcy1icm9rZXJgLlxuICAgKiBAcGFyYW0ge2ltcG9ydChcIi4vdHlwZXMuanNcIikuQmVhY29uQnJvYWRjYXN0TWVzc2FnZX0gbWVzc2FnZSAtIEJyb2FkY2FzdCBtZXNzYWdlLlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIF9yZWNlaXZlQnJvYWRjYXN0KG1lc3NhZ2UpIHtcbiAgICB0aGlzLmVtaXQoXCJicm9hZGNhc3RcIiwgbWVzc2FnZSlcbiAgfVxuXG4gIC8qKiBAcmV0dXJucyB7UHJvbWlzZTx2b2lkPn0gLSBVbnJlZ2lzdGVycyBmcm9tIHRoZSBicm9rZXIuICovXG4gIGFzeW5jIGNsb3NlKCkge1xuICAgIGlmICh0aGlzLl91bnJlZ2lzdGVyKSB0aGlzLl91bnJlZ2lzdGVyKClcbiAgICB0aGlzLl91bnJlZ2lzdGVyID0gdW5kZWZpbmVkXG4gICAgdGhpcy5fY29ubmVjdGVkID0gZmFsc2VcbiAgfVxufVxuIl19

package/build/src/beacon/server.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Beacon broker daemon.
+ *
+ * Accepts JsonSocket connections from any number of peer processes and
+ * fans every `broadcast` message out to every connected peer.
+ * Intentionally stateless — there is no persistence, no replay, no
+ * channel-name filtering on the daemon. Per-process subscription
+ * matching (already implemented by `_broadcastToChannelLocal`) does the
+ * filtering.
+ */
+export default class BeaconServer {
+    /**
+     * @param {object} args - Options.
+     * @param {import("../configuration.js").default} args.configuration - Configuration.
+     * @param {string} [args.host] - Hostname to bind. Defaults to the configured beacon host.
+     * @param {number} [args.port] - Port to bind. Defaults to the configured beacon port.
+     */
+    constructor({ configuration, host, port }: {
+        configuration: import("../configuration.js").default;
+        host?: string | undefined;
+        port?: number | undefined;
+    });
+    configuration: import("../configuration.js").default;
+    host: string;
+    port: number;
+    logger: Logger;
+    /** @type {Set<JsonSocket>} */
+    peers: Set<JsonSocket>;
+    /** @type {net.Server | undefined} */
+    server: net.Server | undefined;
+    /**
+     * @returns {Promise<void>} - Resolves when listening.
+     */
+    start(): Promise<void>;
+    /**
+     * @returns {Promise<void>} - Resolves when closed.
+     */
+    stop(): Promise<void>;
+    /**
+     * @returns {number} - Bound port.
+     */
+    getPort(): number;
+    /**
+     * @returns {number} - Number of connected peers.
+     */
+    getPeerCount(): number;
+    /**
+     * @param {import("net").Socket} socket - Socket.
+     * @returns {void}
+     */
+    _handleConnection(socket: import("net").Socket): void;
+    /**
+     * @param {import("./types.js").BeaconBroadcastMessage} message - Broadcast message.
+     * @returns {void}
+     */
+    _fanOut(message: import("./types.js").BeaconBroadcastMessage): void;
+}
+import Logger from "../logger.js";
+import JsonSocket from "../background-jobs/json-socket.js";
+import net from "net";
+//# sourceMappingURL=server.d.ts.map

package/build/src/beacon/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/beacon/server.js"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH;IACE;;;;;OAKG;IACH,2CAJG;QAAoD,aAAa,EAAzD,OAAO,qBAAqB,EAAE,OAAO;QACvB,IAAI;QACJ,IAAI;KAC5B,EAWA;IATC,qDAAkC;IAElC,aAA+B;IAC/B,aAAyD;IACzD,eAA8B;IAC9B,8BAA8B;IAC9B,OADW,GAAG,CAAC,UAAU,CAAC,CACJ;IACtB,qCAAqC;IACrC,QADW,GAAG,CAAC,MAAM,GAAG,SAAS,CACV;IAGzB;;OAEG;IACH,SAFa,OAAO,CAAC,IAAI,CAAC,CAgBzB;IAED;;OAEG;IACH,QAFa,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;OAEG;IACH,WAFa,MAAM,CAIlB;IAED;;OAEG;IACH,gBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,0BAHW,OAAO,KAAK,EAAE,MAAM,GAClB,IAAI,CA6BhB;IAED;;;OAGG;IACH,iBAHW,OAAO,YAAY,EAAE,sBAAsB,GACzC,IAAI,CAUhB;CACF;mBA7HkB,cAAc;uBADV,mCAAmC;gBAF1C,KAAK"}