ftown-bridge 0.13.5 → 0.15.0

package/dist/direct-transport/peer-manager.d.ts

@@ -0,0 +1,66 @@
+import { type SignalMessage } from './contract.js';
+/** Minimal structural view of a node-datachannel DataChannel (injectable for tests). */
+export interface DirectDataChannel {
+    sendMessage(msg: string): boolean;
+    isOpen(): boolean;
+    close(): void;
+    onOpen(cb: () => void): void;
+    onClosed(cb: () => void): void;
+    onError(cb: (err: string) => void): void;
+    onMessage(cb: (msg: string | Buffer | ArrayBuffer) => void): void;
+}
+/** Minimal structural view of a node-datachannel PeerConnection (injectable for tests). */
+export interface DirectPeerConnection {
+    setRemoteDescription(sdp: string, type: string): void;
+    addRemoteCandidate(candidate: string, mid: string): void;
+    onLocalDescription(cb: (sdp: string, type: string) => void): void;
+    onLocalCandidate(cb: (candidate: string, mid: string) => void): void;
+    onStateChange(cb: (state: string) => void): void;
+    onDataChannel(cb: (dc: DirectDataChannel) => void): void;
+    close(): void;
+}
+export type PeerConnectionFactory = (peerName: string, config: {
+    iceServers: string[];
+}) => DirectPeerConnection;
+export interface DirectPeerManagerOptions {
+    /** This bridge's identity (as advertised on bridges:presence). */
+    bridgeId: string;
+    /** Emits bridge-originated answers/ICE over the signaling channel. */
+    sendSignal: (msg: SignalMessage) => void;
+    /** DataChannel `input` frames feed here (same sink as terminal-input). */
+    onInput: (sessionId: string, data: string) => void;
+    /** DataChannel `resize` frames feed here (same sink as terminal-input). */
+    onResize: (sessionId: string, cols: number, rows: number) => void;
+    /** Returns the current full serialized screen for a session on attach. */
+    onAttach: (sessionId: string) => string;
+    /** node-datachannel PeerConnection factory; defaults to the real module. */
+    peerConnectionFactory?: PeerConnectionFactory;
+    /** Injectable clock for keepalive/teardown timers (defaults to Date.now). */
+    now?: () => number;
+}
+/**
+ * Manages client-initiated WebRTC peers behind an injectable node-datachannel
+ * factory. Answers offers, relays ICE, and fans terminal output/screen to all
+ * attached peers over the `ftown` DataChannel.
+ */
+export declare class DirectPeerManager {
+    readonly bridgeId: string;
+    private readonly sendSignalCb;
+    private readonly onInputCb;
+    private readonly onResizeCb;
+    private readonly onAttachCb;
+    private readonly factory;
+    private readonly peers;
+    constructor(options: DirectPeerManagerOptions);
+    /** Never throws — a malformed signal must not propagate into the publication listener. */
+    handleSignal(msg: SignalMessage): void;
+    sendOutput(sessionId: string, data: string): void;
+    sendScreen(sessionId: string, data: string): void;
+    hasAttachedPeers(sessionId: string): boolean;
+    closeAll(): void;
+    teardown(pairId: string): void;
+    emitSignal(partial: Omit<SignalMessage, 'bridgeId'>): void;
+    getScreen(sessionId: string): string;
+    deliverInput(sessionId: string, data: string): void;
+    deliverResize(sessionId: string, cols: number, rows: number): void;
+}

package/dist/direct-transport/peer-manager.js

@@ -0,0 +1,364 @@
+import { PeerConnection } from 'node-datachannel';
+import { DIRECT_PROTOCOL_VERSION, PING_INTERVAL_MS, STUN_SERVERS, } from './contract.js';
+const ICE_DISCONNECT_GRACE_MS = 10_000;
+const MAX_MISSED_PINGS = 2;
+/** Peers that never reach channel-open within this window are torn down (leak guard). */
+const PAIRING_TIMEOUT_MS = 30_000;
+/**
+ * Max chars per DataChannel frame `data` field. Worst-case UTF-8 is 4 bytes per
+ * 2 chars, so 32k chars stays under ~128 KiB — safely below the ~256 KiB max
+ * message size negotiated by libdatachannel and browsers. Larger payloads are
+ * chunked: for screens, one `screen` frame (stream reset) followed by `output`
+ * continuation frames — receivers apply them sequentially, reconstructing the
+ * full serialized screen without any wire-format change.
+ */
+const MAX_FRAME_DATA_CHARS = 32_000;
+function chunkData(data) {
+    if (data.length <= MAX_FRAME_DATA_CHARS)
+        return [data];
+    const chunks = [];
+    for (let i = 0; i < data.length; i += MAX_FRAME_DATA_CHARS) {
+        chunks.push(data.slice(i, i + MAX_FRAME_DATA_CHARS));
+    }
+    return chunks;
+}
+const defaultPeerConnectionFactory = (peerName, config) => 
+// Verified structural match against node-datachannel's PeerConnection surface.
+new PeerConnection(peerName, config);
+/**
+ * One WebRTC peer (one connection attempt, keyed by pairId). Owns its
+ * PeerConnection + DataChannel, per-session monotonic seq, attach set, and
+ * keepalive/teardown timers.
+ */
+class DirectPeer {
+    pairId;
+    clientId;
+    pc;
+    manager;
+    dc;
+    helloOk = false;
+    closed = false;
+    attached = new Set();
+    seq = new Map();
+    pingTimer;
+    missedPings = 0;
+    iceDisconnectTimer;
+    pairingTimer;
+    constructor(manager, pc, pairId, clientId) {
+        this.manager = manager;
+        this.pc = pc;
+        this.pairId = pairId;
+        this.clientId = clientId;
+        pc.onLocalDescription((sdp, type) => {
+            if (type === 'answer') {
+                this.manager.emitSignal({ type: 'webrtc_answer', pairId, clientId, payload: sdp });
+            }
+        });
+        pc.onLocalCandidate((candidate, mid) => {
+            const payload = { candidate, mid };
+            this.manager.emitSignal({ type: 'webrtc_ice', pairId, clientId, payload: JSON.stringify(payload) });
+        });
+        pc.onStateChange((state) => this.onStateChange(state));
+        pc.onDataChannel((dc) => this.bindDataChannel(dc));
+        // Leak guard: tear down attempts that never reach channel-open (client
+        // vanished pre-ICE); keepalive only starts once the channel opens.
+        this.pairingTimer = setTimeout(() => this.manager.teardown(this.pairId), PAIRING_TIMEOUT_MS);
+        this.pairingTimer.unref?.();
+    }
+    hasAttached(sessionId) {
+        return this.attached.has(sessionId);
+    }
+    /** Throws on native rejection of the SDP; the manager catches and tears down. */
+    applyOffer(sdp) {
+        this.pc.setRemoteDescription(sdp, 'offer');
+    }
+    applyIce(payload) {
+        let parsed;
+        try {
+            parsed = JSON.parse(payload);
+        }
+        catch {
+            return;
+        }
+        if (typeof parsed.candidate !== 'string')
+            return;
+        try {
+            this.pc.addRemoteCandidate(parsed.candidate, parsed.mid ?? '');
+        }
+        catch {
+            // Malformed candidate ⇒ drop it; ICE can still complete on other candidates.
+        }
+    }
+    sendScreen(sessionId, data) {
+        if (!this.attached.has(sessionId))
+            return;
+        // Large screens are chunked: `screen` resets the stream (seq 0), `output`
+        // continuation frames carry the remainder; receivers apply them in order.
+        const chunks = chunkData(data);
+        this.seq.set(sessionId, chunks.length - 1);
+        this.send({ kind: 'screen', sessionId, data: chunks[0], seq: 0 });
+        for (let i = 1; i < chunks.length; i++) {
+            this.send({ kind: 'output', sessionId, data: chunks[i], seq: i });
+        }
+    }
+    sendOutput(sessionId, data) {
+        if (!this.attached.has(sessionId))
+            return;
+        for (const chunk of chunkData(data)) {
+            const next = (this.seq.get(sessionId) ?? 0) + 1;
+            this.seq.set(sessionId, next);
+            this.send({ kind: 'output', sessionId, data: chunk, seq: next });
+        }
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.pingTimer)
+            clearInterval(this.pingTimer);
+        if (this.iceDisconnectTimer)
+            clearTimeout(this.iceDisconnectTimer);
+        if (this.pairingTimer)
+            clearTimeout(this.pairingTimer);
+        this.attached.clear();
+        this.seq.clear();
+        try {
+            this.dc?.close();
+        }
+        catch { /* already gone */ }
+        try {
+            this.pc.close();
+        }
+        catch { /* already gone */ }
+    }
+    bindDataChannel(dc) {
+        this.dc = dc;
+        dc.onMessage((msg) => {
+            if (typeof msg !== 'string')
+                return;
+            this.handleFrame(msg);
+        });
+        dc.onClosed(() => this.manager.teardown(this.pairId));
+        dc.onError(() => this.manager.teardown(this.pairId));
+        if (dc.isOpen())
+            this.startKeepalive();
+        else
+            dc.onOpen(() => this.startKeepalive());
+    }
+    startKeepalive() {
+        if (this.pairingTimer) {
+            clearTimeout(this.pairingTimer);
+            this.pairingTimer = undefined;
+        }
+        if (this.pingTimer)
+            return;
+        this.missedPings = 0;
+        this.pingTimer = setInterval(() => {
+            if (this.missedPings >= MAX_MISSED_PINGS) {
+                this.manager.teardown(this.pairId);
+                return;
+            }
+            this.missedPings += 1;
+            this.send({ kind: 'ping' });
+        }, PING_INTERVAL_MS);
+        this.pingTimer.unref?.();
+    }
+    handleFrame(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        switch (msg.kind) {
+            case 'hello': {
+                if (msg.protocolVersion !== DIRECT_PROTOCOL_VERSION) {
+                    this.manager.teardown(this.pairId);
+                    return;
+                }
+                this.helloOk = true;
+                this.send({ kind: 'hello_ack', bridgeId: this.manager.bridgeId, protocolVersion: DIRECT_PROTOCOL_VERSION });
+                return;
+            }
+            case 'attach': {
+                if (!this.helloOk)
+                    return;
+                this.attached.add(msg.sessionId);
+                const screen = this.manager.getScreen(msg.sessionId);
+                this.sendScreen(msg.sessionId, screen);
+                return;
+            }
+            case 'detach': {
+                this.attached.delete(msg.sessionId);
+                this.seq.delete(msg.sessionId);
+                return;
+            }
+            case 'input': {
+                if (!this.helloOk)
+                    return;
+                this.manager.deliverInput(msg.sessionId, msg.data);
+                return;
+            }
+            case 'resize': {
+                if (!this.helloOk)
+                    return;
+                this.manager.deliverResize(msg.sessionId, msg.cols, msg.rows);
+                return;
+            }
+            case 'ping': {
+                this.send({ kind: 'pong' });
+                return;
+            }
+            case 'pong': {
+                this.missedPings = 0;
+                return;
+            }
+            default:
+                // Unknown kind ⇒ ignore.
+                return;
+        }
+    }
+    onStateChange(state) {
+        if (state === 'disconnected') {
+            if (this.iceDisconnectTimer)
+                return;
+            this.iceDisconnectTimer = setTimeout(() => this.manager.teardown(this.pairId), ICE_DISCONNECT_GRACE_MS);
+            this.iceDisconnectTimer.unref?.();
+        }
+        else if (state === 'connected') {
+            if (this.iceDisconnectTimer) {
+                clearTimeout(this.iceDisconnectTimer);
+                this.iceDisconnectTimer = undefined;
+            }
+        }
+        else if (state === 'failed' || state === 'closed') {
+            this.manager.teardown(this.pairId);
+        }
+    }
+    send(msg) {
+        if (this.closed || !this.dc || !this.dc.isOpen())
+            return;
+        try {
+            this.dc.sendMessage(JSON.stringify(msg));
+        }
+        catch {
+            // Drop the frame rather than kill the connection; a genuinely dead
+            // channel is detected by onClosed/onError or missed pings.
+        }
+    }
+}
+/**
+ * Manages client-initiated WebRTC peers behind an injectable node-datachannel
+ * factory. Answers offers, relays ICE, and fans terminal output/screen to all
+ * attached peers over the `ftown` DataChannel.
+ */
+export class DirectPeerManager {
+    bridgeId;
+    sendSignalCb;
+    onInputCb;
+    onResizeCb;
+    onAttachCb;
+    factory;
+    peers = new Map();
+    constructor(options) {
+        this.bridgeId = options.bridgeId;
+        this.sendSignalCb = options.sendSignal;
+        this.onInputCb = options.onInput;
+        this.onResizeCb = options.onResize;
+        this.onAttachCb = options.onAttach;
+        this.factory = options.peerConnectionFactory ?? defaultPeerConnectionFactory;
+    }
+    /** Never throws — a malformed signal must not propagate into the publication listener. */
+    handleSignal(msg) {
+        if (msg.bridgeId !== this.bridgeId)
+            return;
+        if (typeof msg.pairId !== 'string' || msg.pairId === '')
+            return;
+        try {
+            switch (msg.type) {
+                case 'webrtc_offer': {
+                    if (typeof msg.payload !== 'string' || msg.payload === '')
+                        return;
+                    if (typeof msg.clientId !== 'string' || msg.clientId === '')
+                        return;
+                    // Replace any prior pairing for this pairId AND any stale peer of the
+                    // same client (reconnect) so a session never gets duplicate frames.
+                    this.teardown(msg.pairId);
+                    for (const peer of [...this.peers.values()]) {
+                        if (peer.clientId === msg.clientId)
+                            this.teardown(peer.pairId);
+                    }
+                    const pc = this.factory(`ftown-${msg.pairId}`, { iceServers: [...STUN_SERVERS] });
+                    const peer = new DirectPeer(this, pc, msg.pairId, msg.clientId);
+                    this.peers.set(msg.pairId, peer);
+                    try {
+                        peer.applyOffer(msg.payload);
+                    }
+                    catch {
+                        // Malformed SDP: abort just this pairing attempt and tell the client.
+                        this.teardown(msg.pairId);
+                        this.emitSignal({ type: 'webrtc_close', pairId: msg.pairId, clientId: msg.clientId, payload: '' });
+                    }
+                    return;
+                }
+                case 'webrtc_ice': {
+                    if (typeof msg.payload !== 'string')
+                        return;
+                    this.peers.get(msg.pairId)?.applyIce(msg.payload);
+                    return;
+                }
+                case 'webrtc_close': {
+                    this.teardown(msg.pairId);
+                    return;
+                }
+                default:
+                    // webrtc_answer (our own echo) and anything else ⇒ ignore.
+                    return;
+            }
+        }
+        catch (err) {
+            console.error('[DirectTransport] Failed to handle signal:', err);
+        }
+    }
+    sendOutput(sessionId, data) {
+        for (const peer of this.peers.values())
+            peer.sendOutput(sessionId, data);
+    }
+    sendScreen(sessionId, data) {
+        for (const peer of this.peers.values())
+            peer.sendScreen(sessionId, data);
+    }
+    hasAttachedPeers(sessionId) {
+        for (const peer of this.peers.values()) {
+            if (peer.hasAttached(sessionId))
+                return true;
+        }
+        return false;
+    }
+    closeAll() {
+        for (const peer of this.peers.values())
+            peer.close();
+        this.peers.clear();
+    }
+    teardown(pairId) {
+        const peer = this.peers.get(pairId);
+        if (!peer)
+            return;
+        this.peers.delete(pairId);
+        peer.close();
+    }
+    emitSignal(partial) {
+        this.sendSignalCb({ ...partial, bridgeId: this.bridgeId });
+    }
+    getScreen(sessionId) {
+        return this.onAttachCb(sessionId);
+    }
+    deliverInput(sessionId, data) {
+        this.onInputCb(sessionId, data);
+    }
+    deliverResize(sessionId, cols, rows) {
+        this.onResizeCb(sessionId, cols, rows);
+    }
+}
+//# sourceMappingURL=peer-manager.js.map

package/dist/direct-transport/peer-manager.js.map

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

package/dist/direct-transport/publish-router.d.ts

@@ -0,0 +1,48 @@
+import { type DirectCommandMessage } from './contract.js';
+import type { DirectPeerManager } from './peer-manager.js';
+import type { WatchRegistry } from './watch-registry.js';
+/** Minimal view of CentrifugoClient's terminal publish surface (R2 fallback path). */
+export interface CentrifugoPublisher {
+    publishTerminalData(userId: string, sessionId: string, data: string): Promise<void>;
+    publishTerminalScreen(userId: string, sessionId: string, raw: string): Promise<void>;
+}
+/** Minimal view of the loopback WS rung (LoopbackPeerServer) the router fans to. */
+export interface LoopbackPeerServerLike {
+    sendOutput(sessionId: string, data: string): void;
+    sendScreen(sessionId: string, data: string): void;
+    hasAttachedPeers(sessionId: string): boolean;
+}
+export interface PublishRouterOptions {
+    registry: WatchRegistry;
+    peerManager: DirectPeerManager;
+    centrifugo: CentrifugoPublisher;
+    userId: string;
+    /** Optional loopback WS rung; output/screen fan out to it as well as WebRTC. */
+    loopback?: LoopbackPeerServerLike;
+    /**
+     * Optional guard: only register watchers for sessions this bridge owns (watch
+     * messages fan out to every bridge on the shared commands channel). Defaults
+     * to accepting all sessionIds.
+     */
+    isKnownSession?: (sessionId: string) => boolean;
+}
+/**
+ * Implements R2: terminal output/screen always fan out to direct-attached peers;
+ * they also go to Centrifugo iff the session has an unexpired remote watcher.
+ * Truncation for the Centrifugo path stays inside CentrifugoClient's publishers.
+ */
+export declare class PublishRouter {
+    private readonly registry;
+    private readonly peerManager;
+    private readonly centrifugo;
+    private readonly userId;
+    private readonly loopback?;
+    private readonly isKnownSession;
+    constructor(options: PublishRouterOptions);
+    /** R2 gating: a session is direct-attached if EITHER local rung has a peer. */
+    hasAttachedPeers(sessionId: string): boolean;
+    publishTerminalData(sessionId: string, data: string): void;
+    publishTerminalScreen(sessionId: string, screen: string): void;
+    /** Never throws — runs inside the Centrifugo publication listener. */
+    handleCommand(msg: DirectCommandMessage): void;
+}

package/dist/direct-transport/publish-router.js

@@ -0,0 +1,72 @@
+import { isSignalMessage, isWatchMessage } from './contract.js';
+/**
+ * Implements R2: terminal output/screen always fan out to direct-attached peers;
+ * they also go to Centrifugo iff the session has an unexpired remote watcher.
+ * Truncation for the Centrifugo path stays inside CentrifugoClient's publishers.
+ */
+export class PublishRouter {
+    registry;
+    peerManager;
+    centrifugo;
+    userId;
+    loopback;
+    isKnownSession;
+    constructor(options) {
+        this.registry = options.registry;
+        this.peerManager = options.peerManager;
+        this.centrifugo = options.centrifugo;
+        this.userId = options.userId;
+        this.loopback = options.loopback;
+        this.isKnownSession = options.isKnownSession ?? (() => true);
+    }
+    /** R2 gating: a session is direct-attached if EITHER local rung has a peer. */
+    hasAttachedPeers(sessionId) {
+        return (this.peerManager.hasAttachedPeers(sessionId) ||
+            (this.loopback?.hasAttachedPeers(sessionId) ?? false));
+    }
+    publishTerminalData(sessionId, data) {
+        this.peerManager.sendOutput(sessionId, data);
+        this.loopback?.sendOutput(sessionId, data);
+        if (this.registry.hasWatchers(sessionId)) {
+            this.centrifugo.publishTerminalData(this.userId, sessionId, data).catch((err) => {
+                console.error(`[DirectTransport] Failed to publish terminal data for ${sessionId}:`, err);
+            });
+        }
+    }
+    publishTerminalScreen(sessionId, screen) {
+        this.peerManager.sendScreen(sessionId, screen);
+        this.loopback?.sendScreen(sessionId, screen);
+        if (this.registry.hasWatchers(sessionId)) {
+            this.centrifugo.publishTerminalScreen(this.userId, sessionId, screen).catch((err) => {
+                console.error(`[DirectTransport] Failed to publish terminal screen for ${sessionId}:`, err);
+            });
+        }
+    }
+    /** Never throws — runs inside the Centrifugo publication listener. */
+    handleCommand(msg) {
+        try {
+            if (isSignalMessage(msg)) {
+                this.peerManager.handleSignal(msg);
+                return;
+            }
+            if (isWatchMessage(msg)) {
+                if (typeof msg.sessionId !== 'string' || msg.sessionId === '')
+                    return;
+                if (typeof msg.clientId !== 'string' || msg.clientId === '')
+                    return;
+                if (msg.type === 'terminal_watch') {
+                    if (!this.isKnownSession(msg.sessionId))
+                        return;
+                    this.registry.watch(msg.sessionId, msg.clientId);
+                }
+                else {
+                    this.registry.unwatch(msg.sessionId, msg.clientId);
+                }
+            }
+        }
+        catch (err) {
+            console.error('[DirectTransport] Failed to handle direct command:', err);
+        }
+    }
+}
+//# sourceMappingURL=publish-router.js.map

package/dist/direct-transport/publish-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-router.js","sourceRoot":"","sources":["../../src/direct-transport/publish-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAA6B,MAAM,eAAe,CAAC;AAgC3F;;;;GAIG;AACH,MAAM,OAAO,aAAa;IACP,QAAQ,CAAgB;IACxB,WAAW,CAAoB;IAC/B,UAAU,CAAsB;IAChC,MAAM,CAAS;IACf,QAAQ,CAA0B;IAClC,cAAc,CAAiC;IAEhE,YAAY,OAA6B;QACvC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,+EAA+E;IAC/E,gBAAgB,CAAC,SAAiB;QAChC,OAAO,CACL,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,SAAS,CAAC;YAC5C,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,CACtD,CAAC;IACJ,CAAC;IAED,mBAAmB,CAAC,SAAiB,EAAE,IAAY;QACjD,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC9E,OAAO,CAAC,KAAK,CAAC,yDAAyD,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC;YAC5F,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,qBAAqB,CAAC,SAAiB,EAAE,MAAc;QACrD,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBAClF,OAAO,CAAC,KAAK,CAAC,2DAA2D,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC;YAC9F,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,aAAa,CAAC,GAAyB;QACrC,IAAI,CAAC;YACH,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;gBACnC,OAAO;YACT,CAAC;YACD,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS,KAAK,EAAE;oBAAE,OAAO;gBACtE,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE;oBAAE,OAAO;gBACpE,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;oBAClC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC;wBAAE,OAAO;oBAChD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACnD,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,oDAAoD,EAAE,GAAG,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;CACF"}

package/dist/direct-transport/watch-registry.d.ts

@@ -0,0 +1,38 @@
+type FirstWatcherCallback = (sessionId: string) => void;
+export interface WatchRegistryOptions {
+    /** Injectable clock (defaults to Date.now) so tests can control expiry. */
+    now?: () => number;
+    /** Watcher lifetime; defaults to the frozen WATCH_TTL_MS. */
+    ttlMs?: number;
+    /** Housekeeping sweep interval; set 0 to disable the timer (lazy expiry only). */
+    sweepIntervalMs?: number;
+}
+/**
+ * Tracks unexpired remote watchers per session. Expiry is lazy (evaluated
+ * against the injectable clock on every read) with an optional unref'd sweep
+ * timer for memory housekeeping. `onFirstWatcher` fires when a session
+ * transitions 0 -> 1 live watchers; `onNewWatcher` fires whenever a clientId
+ * that was not already a live watcher registers (first watcher, each
+ * additional distinct client, and re-registration after TTL expiry — but not
+ * heartbeat refreshes).
+ */
+export declare class WatchRegistry {
+    private readonly watchers;
+    private readonly firstWatcherCallbacks;
+    private readonly newWatcherCallbacks;
+    private readonly now;
+    private readonly ttlMs;
+    private readonly sweepTimer?;
+    constructor(options?: WatchRegistryOptions);
+    watch(sessionId: string, clientId: string): void;
+    unwatch(sessionId: string, clientId: string): void;
+    hasWatchers(sessionId: string): boolean;
+    onFirstWatcher(cb: FirstWatcherCallback): void;
+    /** Fires for every distinct client registration (incl. post-expiry re-registration). */
+    onNewWatcher(cb: FirstWatcherCallback): void;
+    dispose(): void;
+    /** Prunes expired entries from `inner` and returns the remaining live count. */
+    private liveCount;
+    private sweep;
+}
+export {};