virlen-remote 0.1.0

package/dist/transport/memory.js

@@ -0,0 +1,135 @@
+export class MemoryTransport {
+    constructor() {
+        this._state = 'connecting';
+        /** 对端；由 `createMemoryPair()` 建立双向链接。 */
+        this.peer = null;
+        this.messageListeners = new Set();
+        this.stateListeners = new Set();
+        this.metrics = { sent: 0, received: 0, dropped: 0 };
+        /** 随机丢包率 0..1（测试用）。 */
+        this.lossRate = 0;
+        /** 确定性丢包：>0 时下一次 send 丢弃该帧并自减。 */
+        this.dropNextOutgoing = 0;
+        /** 确定性丢包：>0 时下一次投递丢弃该帧并自减。 */
+        this.dropNextIncoming = 0;
+    }
+    get state() {
+        return this._state;
+    }
+    get bufferedAmount() {
+        return 0;
+    }
+    /** 累计统计（测试断言用）。 */
+    get stats() {
+        return { ...this.metrics };
+    }
+    send(bytes) {
+        this.metrics.sent++;
+        if (this._state !== 'open' || !this.peer) {
+            this.metrics.dropped++;
+            return;
+        }
+        if (this.dropNextOutgoing > 0) {
+            this.dropNextOutgoing--;
+            this.metrics.dropped++;
+            return;
+        }
+        if (this.lossRate > 0 && Math.random() < this.lossRate) {
+            this.metrics.dropped++;
+            return;
+        }
+        this.peer.deliver(bytes);
+    }
+    close() {
+        this.setState('closed');
+    }
+    onMessage(listener) {
+        this.messageListeners.add(listener);
+        return () => {
+            this.messageListeners.delete(listener);
+        };
+    }
+    onStateChange(listener) {
+        this.stateListeners.add(listener);
+        return () => {
+            this.stateListeners.delete(listener);
+        };
+    }
+    // ───────────────────────── 测试辅助 ─────────────────────────
+    open() {
+        this.setState('open');
+    }
+    /** 模拟链路断开（双向，原子：先写两端状态再通知）。 */
+    disconnect() {
+        this.transition('closed');
+    }
+    /** 模拟链路恢复（双向，原子）。 */
+    reconnect() {
+        this.transition('open');
+    }
+    /** 让接下来 n 次 send 静默丢弃（验证幂等/重放）。 */
+    dropOutgoing(n) {
+        this.dropNextOutgoing = n;
+    }
+    /** 让接下来 n 次投递静默丢弃（验证超时/重放）。 */
+    dropIncoming(n) {
+        this.dropNextIncoming = n;
+    }
+    deliver(bytes) {
+        if (this._state !== 'open') {
+            this.metrics.dropped++;
+            return;
+        }
+        if (this.dropNextIncoming > 0) {
+            this.dropNextIncoming--;
+            this.metrics.dropped++;
+            return;
+        }
+        // 异步投递：模拟真实链路的异步边界；queueMicrotask 保证先进先出（顺序性）
+        queueMicrotask(() => {
+            if (this._state !== 'open')
+                return;
+            this.metrics.received++;
+            for (const listener of this.messageListeners)
+                listener(bytes);
+        });
+    }
+    transition(state) {
+        const changed = [];
+        if (this._state !== state) {
+            this._state = state;
+            changed.push(this);
+        }
+        const peer = this.peer;
+        if (peer && peer._state !== state) {
+            peer._state = state;
+            changed.push(peer);
+        }
+        // 关键：**先把两端状态写完，再逐个通知**。
+        // 否则「重放」的一侧会在通知回调里立即发送，而对端此刻仍是 closed
+        // → 帧被 deliver() 静默丢弃，重放失效（真实链路恢复时同样会踩到）。
+        for (const t of changed)
+            t.notifyState();
+    }
+    notifyState() {
+        for (const listener of [...this.stateListeners])
+            listener(this._state);
+    }
+    setState(state) {
+        if (this._state === state)
+            return;
+        this._state = state;
+        this.notifyState();
+    }
+}
+/** 建立一对互连的 transport（双方初始即 open）。 */
+export function createMemoryPair() {
+    const a = new MemoryTransport();
+    const b = new MemoryTransport();
+    a.peer = b;
+    b.peer = a;
+    a.open();
+    b.open();
+    return [a, b];
+}
+//# sourceMappingURL=memory.js.map

package/dist/transport/memory.js.map

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

package/dist/transport/rtc.d.ts

@@ -0,0 +1,76 @@
+/**
+ * RTC transport —— 真实链路（WebRTC DataChannel）。
+ *
+ * 只依赖两个注入点，因此**可单测**（不需要真实 WebRTC）：
+ *   - `signaling`：信令通道（`SignalingChannel`，M3 用 SSE 实现；测试用环回实现）
+ *   - `createPeerConnection`：`RTCPeerConnection` 工厂（测试用假实现）
+ *
+ * 角色（见 §8 拍板）：**电脑(host) 发起 offer**，手机(guest) 应答。
+ * 电脑常驻房间，手机加入后由电脑发 offer —— 手机可能在后台切换，桌面是稳定进程。
+ *
+ * 状态映射：`connected → open`；`failed/closed → closed`；`disconnected → connecting`（等重连）。
+ */
+import type { Transport, TransportState } from './types.js';
+import type { SignalingChannel, SignalingRole } from './signaling.js';
+import type { IceServerInit } from './ice.js';
+export interface RtcTransportOptions {
+    role: SignalingRole;
+    signaling: SignalingChannel;
+    /**
+     * ICE 服务器列表。**不再有内置默认值**（M7，§31）：两端都由
+     * `resolveIceServers()` 决定（自定义 > 服务端下发 > 缓存 > 空）。
+     */
+    iceServers?: IceServerInit[];
+    /** 数据通道 label（对两端须一致）。 */
+    channelLabel?: string;
+    /** 注入 `RTCPeerConnection` 工厂（测试用；默认取全局构造器）。 */
+    createPeerConnection?: (config: RTCConfiguration) => RTCPeerConnection;
+}
+export declare class RtcTransport implements Transport {
+    private readonly options;
+    private _state;
+    private readonly messageListeners;
+    private readonly stateListeners;
+    private pc;
+    private dc;
+    private pendingCandidates;
+    private started;
+    /** 被顶号（致命）：置位后一切重建/重连动作都无意义。 */
+    private replaced;
+    private readonly readyPromise;
+    private readyResolve;
+    private readyReject;
+    constructor(options: RtcTransportOptions);
+    get state(): TransportState;
+    get bufferedAmount(): number;
+    /** 链路真正可用的 Promise（DataChannel open 时 resolve）；失败/关闭时 reject。 */
+    whenReady(): Promise<void>;
+    /** 加入信令房间并开始协商。使用方创建后调用一次（不需要 await，靠状态/`whenReady` 驱动）。 */
+    start(): Promise<void>;
+    send(bytes: Uint8Array): void;
+    close(): void;
+    onMessage(listener: (bytes: Uint8Array) => void): () => void;
+    onStateChange(listener: (state: TransportState) => void): () => void;
+    private onPeer;
+    /**
+     * 被服务端顶号（同一台电脑已有别的手机接入）。
+     *
+     * 顺序是刻意的：**先把错误告知上层，再改状态**。上层（手机端 `connectionStore`）在
+     * 看到 `closed` 时会安排自动重连 —— 而重连会把刚接入的那台手机再顶掉（乒乓）。
+     * 所以「被顶号」这个事实必须先于状态变化到达。
+     */
+    private onKicked;
+    private ensurePC;
+    private startOffer;
+    private handleRemote;
+    private flushCandidates;
+    private setupDataChannel;
+    private onConnectionState;
+    private teardownPeer;
+    private fail;
+    private onErrorListeners;
+    /** 订阅「链路级错误」（区别于状态变化）；返回取消订阅函数。 */
+    onError(listener: (error: Error) => void): () => void;
+    private setState;
+}
+//# sourceMappingURL=rtc.d.ts.map

package/dist/transport/rtc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc.d.ts","sourceRoot":"","sources":["../../src/transport/rtc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxD,OAAO,KAAK,EAAc,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAG1C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAA;IACnB,SAAS,EAAE,gBAAgB,CAAA;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,aAAa,EAAE,CAAA;IAC5B,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,+CAA+C;IAC/C,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,iBAAiB,CAAA;CACvE;AAOD,qBAAa,YAAa,YAAW,SAAS;IAgBhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAfpC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyC;IAC1E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAE5E,OAAO,CAAC,EAAE,CAAiC;IAC3C,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,iBAAiB,CAA4B;IACrD,OAAO,CAAC,OAAO,CAAQ;IACvB,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAQ;IAExB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,WAAW,CAAwC;IAE3D,YAA6B,OAAO,EAAE,mBAAmB,EAYxD;IAED,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,iEAAiE;IACjE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzB;IAED,4DAA4D;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ3B;IAED,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAM5B;IAED,KAAK,IAAI,IAAI,CAUZ;IAED,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAK3D;IAED,aAAa,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAKnE;IAID,OAAO,CAAC,MAAM;IAgBd;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,QAAQ;YAeF,UAAU;YAeV,YAAY;YAkCZ,eAAe;IAU7B,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,gBAAgB,CAAwC;IAEhE,mCAAmC;IACnC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAKpD;IAED,OAAO,CAAC,QAAQ;CAKjB"}

package/dist/transport/rtc.js

@@ -0,0 +1,310 @@
+import { BridgeError, toBridgeError } from '../protocol/errors.js';
+export class RtcTransport {
+    constructor(options) {
+        this.options = options;
+        this._state = 'connecting';
+        this.messageListeners = new Set();
+        this.stateListeners = new Set();
+        this.pc = null;
+        this.dc = null;
+        this.pendingCandidates = [];
+        this.started = false;
+        /** 被顶号（致命）：置位后一切重建/重连动作都无意义。 */
+        this.replaced = false;
+        this.readyResolve = null;
+        this.readyReject = null;
+        this.onErrorListeners = null;
+        this.readyPromise = new Promise((resolve, reject) => {
+            this.readyResolve = resolve;
+            this.readyReject = reject;
+        });
+        const sig = options.signaling;
+        sig.onPeer = (peerId) => this.onPeer(peerId);
+        sig.onData = (data) => {
+            void this.handleRemote(data);
+        };
+        sig.onError = (err) => this.fail(err);
+        sig.onKicked = (info) => this.onKicked(info);
+    }
+    get state() {
+        return this._state;
+    }
+    get bufferedAmount() {
+        return this.dc?.bufferedAmount ?? 0;
+    }
+    /** 链路真正可用的 Promise（DataChannel open 时 resolve）；失败/关闭时 reject。 */
+    whenReady() {
+        return this.readyPromise;
+    }
+    /** 加入信令房间并开始协商。使用方创建后调用一次（不需要 await，靠状态/`whenReady` 驱动）。 */
+    async start() {
+        if (this.started)
+            return;
+        this.started = true;
+        try {
+            await this.options.signaling.join();
+        }
+        catch (err) {
+            this.fail(toBridgeError(err));
+        }
+    }
+    send(bytes) {
+        const dc = this.dc;
+        if (this._state !== 'open' || !dc || dc.readyState !== 'open')
+            return;
+        // 注：DOM 定义的 `send` 要求 `ArrayBufferView<ArrayBuffer>`，而 `Uint8Array` 泛型是
+        // `ArrayBufferLike`（可能含 SharedArrayBuffer）。实际数据永远是普通 buffer，安全 cast。
+        dc.send(bytes);
+    }
+    close() {
+        if (this._state === 'closed')
+            return;
+        this.teardownPeer();
+        try {
+            this.options.signaling.close();
+        }
+        catch {
+            /* 忽略 */
+        }
+        this.setState('closed');
+        this.readyReject?.(new Error('transport closed'));
+    }
+    onMessage(listener) {
+        this.messageListeners.add(listener);
+        return () => {
+            this.messageListeners.delete(listener);
+        };
+    }
+    onStateChange(listener) {
+        this.stateListeners.add(listener);
+        return () => {
+            this.stateListeners.delete(listener);
+        };
+    }
+    // ───────────────────────── 内部：信令 → 协商 ─────────────────────────
+    onPeer(peerId) {
+        // 被顶号后信令已停用：此时任何对端变化都不该再重建 PC（重建出来也是死链路）
+        if (this.replaced)
+            return;
+        if (peerId === null) {
+            // 对端离开：清掉旧连接，回到等待态（手机重连后会重新触发）
+            this.teardownPeer();
+            this.setState('connecting');
+            return;
+        }
+        // 只有 host 主动发起：guest 必须等 offer 到达才建 PC（否则会建两次 PC、上下文串味）
+        if (this.options.role === 'host') {
+            this.ensurePC();
+            void this.startOffer();
+        }
+    }
+    /**
+     * 被服务端顶号（同一台电脑已有别的手机接入）。
+     *
+     * 顺序是刻意的：**先把错误告知上层，再改状态**。上层（手机端 `connectionStore`）在
+     * 看到 `closed` 时会安排自动重连 —— 而重连会把刚接入的那台手机再顶掉（乒乓）。
+     * 所以「被顶号」这个事实必须先于状态变化到达。
+     */
+    onKicked(info) {
+        if (this.replaced)
+            return;
+        this.replaced = true;
+        this.fail(new BridgeError('E_REPLACED', '该电脑已被另一台手机接管连接', {
+            data: { reason: info.reason },
+        }));
+        this.teardownPeer();
+        try {
+            this.options.signaling.close();
+        }
+        catch {
+            /* 忽略 */
+        }
+        // 状态置 closed 收尾（`_state` 为 closed 时 `close()` 也不会重复处理）
+        this.setState('closed');
+    }
+    ensurePC() {
+        if (this.pc)
+            return this.pc;
+        const factory = this.options.createPeerConnection ?? defaultFactory();
+        const pc = factory({ iceServers: this.options.iceServers ?? [] });
+        this.pc = pc;
+        pc.onicecandidate = (e) => {
+            if (!e.candidate)
+                return;
+            void this.options.signaling.send({ kind: 'candidate', cand: candidateToJson(e.candidate) });
+        };
+        pc.onconnectionstatechange = () => this.onConnectionState(pc.connectionState);
+        pc.ondatachannel = (e) => this.setupDataChannel(e.channel);
+        return pc;
+    }
+    async startOffer() {
+        const pc = this.pc;
+        if (!pc)
+            return;
+        if (!this.dc) {
+            this.setupDataChannel(pc.createDataChannel(this.options.channelLabel ?? 'virlen'));
+        }
+        try {
+            const offer = await pc.createOffer();
+            await pc.setLocalDescription(offer);
+            await this.options.signaling.send({ kind: 'offer', sdp: pc.localDescription ?? offer });
+        }
+        catch (err) {
+            this.fail(toBridgeError(err));
+        }
+    }
+    async handleRemote(data) {
+        const msg = data;
+        if (!msg || typeof msg !== 'object' || typeof msg.kind !== 'string')
+            return;
+        try {
+            if (msg.kind === 'offer') {
+                // 每个 offer 视作新会话：清旧上下文，避免新旧 ICE 串味（同 rtc.js）
+                if (this.pc)
+                    this.teardownPeer();
+                const pc = this.ensurePC();
+                await pc.setRemoteDescription(msg.sdp);
+                await this.flushCandidates();
+                const answer = await pc.createAnswer();
+                await pc.setLocalDescription(answer);
+                await this.options.signaling.send({ kind: 'answer', sdp: pc.localDescription ?? answer });
+            }
+            else if (msg.kind === 'answer') {
+                const pc = this.pc;
+                if (!pc)
+                    return;
+                if (pc.signalingState === 'have-local-offer') {
+                    await pc.setRemoteDescription(msg.sdp);
+                    await this.flushCandidates();
+                }
+            }
+            else if (msg.kind === 'candidate') {
+                const pc = this.pc;
+                if (!pc || !msg.cand)
+                    return;
+                if (pc.remoteDescription && pc.remoteDescription.type) {
+                    await pc.addIceCandidate(msg.cand).catch(() => { });
+                }
+                else {
+                    this.pendingCandidates.push(msg.cand);
+                }
+            }
+        }
+        catch (err) {
+            this.fail(toBridgeError(err));
+        }
+    }
+    async flushCandidates() {
+        const list = this.pendingCandidates;
+        this.pendingCandidates = [];
+        const pc = this.pc;
+        if (!pc)
+            return;
+        for (const cand of list) {
+            await pc.addIceCandidate(cand).catch(() => { });
+        }
+    }
+    setupDataChannel(channel) {
+        this.dc = channel;
+        try {
+            channel.binaryType = 'arraybuffer';
+        }
+        catch {
+            /* 某些实现只读 */
+        }
+        channel.onopen = () => {
+            this.setState('open');
+            this.readyResolve?.();
+        };
+        channel.onclose = () => {
+            // 通道关闭：等待对端重连（不永久 closed）
+            this.setState('connecting');
+        };
+        channel.onmessage = (e) => {
+            const bytes = toBytes(e.data);
+            if (!bytes)
+                return;
+            for (const listener of [...this.messageListeners])
+                listener(bytes);
+        };
+    }
+    onConnectionState(connState) {
+        switch (connState) {
+            case 'connected':
+                // ⚠️ **不在这里置 open**：`connectionState` 可能**早于** DataChannel 的 `open` 触发。
+                // 尤其 guest（手机）侧：dc 是 `ondatachannel` **异步交付**的，此刻 `this.dc` 可能还是 null
+                // → 上层 `whenReady` 已 resolve、`transport.state==='open'`，但 `send()` 因 dc 未就绪而
+                // **静默丢弃**（2026-09 真机踩过：手机“连接超时”，电脑端日志 open→4s→connecting）。
+                // 统一以 `dc.onopen` 为准 —— 回归用例在 rtc-transport.test.ts。
+                break;
+            case 'failed':
+            case 'closed':
+                this.setState('closed');
+                this.readyReject?.(new Error(`peer connection ${connState}`));
+                break;
+            case 'disconnected':
+                this.setState('connecting');
+                break;
+            default:
+                break;
+        }
+    }
+    teardownPeer() {
+        this.pendingCandidates = [];
+        try {
+            this.dc?.close();
+        }
+        catch {
+            /* 忽略 */
+        }
+        try {
+            this.pc?.close();
+        }
+        catch {
+            /* 忽略 */
+        }
+        this.dc = null;
+        this.pc = null;
+    }
+    fail(error) {
+        this.readyReject?.(error);
+        this.onErrorListeners?.(error);
+    }
+    /** 订阅「链路级错误」（区别于状态变化）；返回取消订阅函数。 */
+    onError(listener) {
+        this.onErrorListeners = listener;
+        return () => {
+            if (this.onErrorListeners === listener)
+                this.onErrorListeners = null;
+        };
+    }
+    setState(state) {
+        if (this._state === state)
+            return;
+        this._state = state;
+        for (const listener of [...this.stateListeners])
+            listener(state);
+    }
+}
+function defaultFactory() {
+    return (config) => {
+        const Ctor = globalThis
+            .RTCPeerConnection;
+        if (!Ctor) {
+            throw new Error('当前环境没有 RTCPeerConnection，未注入 createPeerConnection');
+        }
+        return new Ctor(config);
+    };
+}
+function candidateToJson(candidate) {
+    const withJson = candidate;
+    return typeof withJson.toJSON === 'function' ? withJson.toJSON() : candidate;
+}
+function toBytes(data) {
+    if (data instanceof Uint8Array)
+        return data;
+    if (data instanceof ArrayBuffer)
+        return new Uint8Array(data);
+    return null;
+}
+//# sourceMappingURL=rtc.js.map

package/dist/transport/rtc.js.map

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

package/dist/transport/signaling.d.ts

@@ -0,0 +1,101 @@
+import { type RoomStatus } from '../protocol/identity.js';
+export type SignalingRole = 'host' | 'guest';
+/** 被顶号的通知内容（服务器 `kicked` 事件）。 */
+export interface KickedInfo {
+    /** `replaced` = 同一台电脑已有新的手机接入（本端被顶掉）；`takeover` = 电脑端重入接管。 */
+    reason: string;
+}
+/** `EventSource` 的最小形状（注入测试替身用）。 */
+export interface EventSourceLike {
+    onopen: ((event: unknown) => void) | null;
+    onerror: ((event: unknown) => void) | null;
+    onmessage: ((event: {
+        data: string;
+    }) => void) | null;
+    close(): void;
+}
+export interface SignalingChannel {
+    readonly selfId: string;
+    readonly peerId: string | null;
+    onPeer: ((peerId: string | null) => void) | null;
+    onData: ((data: unknown) => void) | null;
+    onError: ((error: Error) => void) | null;
+    /**
+     * 本端被服务端顶号（**不是**普通掉线）。
+     *
+     * 为什么必须独立成回调而不是兼做 `onError`：上层要做出**完全相反的动作** ——
+     * 普通掉线自动重连，被顶号**绝不能自动重连**（否则两台手机会互相顶来顶去）。
+     */
+    onKicked: ((info: KickedInfo) => void) | null;
+    /** 加入房间；返回本端 id。 */
+    join(): Promise<string>;
+    /** 把一条信令发给当前对端（无对端时 no-op）。 */
+    send(data: unknown): Promise<void>;
+    close(): void;
+}
+export interface SseSignalingOptions {
+    /** 信令基址，如 `https://virlen.cn/api/rtc/`（末尾斜杠可有可无）。 */
+    baseUrl: string;
+    room: string;
+    role: SignalingRole;
+    /** 本端设备 key（电脑 `dk-…` / 手机 `mk-…`）；服务器用于日志与 host 房主校验。 */
+    deviceKey?: string;
+    /** 本端显示名（服务器日志可读性）。 */
+    clientName?: string;
+    /**
+     * 加入时要求房间内已有 host（手机端用）。
+     * 无 host 时 `join()` 直接抛错 —— 比「先占住 guest 位再等 15 秒超时」诚实得多。
+     */
+    requireHostOnline?: boolean;
+    /** 注入（测试用）；默认取全局 `fetch`。 */
+    fetchImpl?: typeof fetch;
+    /** 注入（测试用）；默认 `(url) => new EventSource(url)`。 */
+    eventSourceFactory?: (url: string) => EventSourceLike;
+}
+export declare class SseSignalingClient implements SignalingChannel {
+    private readonly options;
+    selfId: string;
+    peerId: string | null;
+    onPeer: ((peerId: string | null) => void) | null;
+    onData: ((data: unknown) => void) | null;
+    onError: ((error: Error) => void) | null;
+    onKicked: ((info: KickedInfo) => void) | null;
+    private readonly base;
+    private es;
+    private closed;
+    /** 被顶号后置位：此后一切信令发送都无意义（房间已把我们移除）。 */
+    private kicked;
+    constructor(options: SseSignalingOptions);
+    join(): Promise<string>;
+    send(data: unknown): Promise<void>;
+    close(): void;
+    private fetch;
+    private openEvents;
+    private route;
+    /**
+     * 被顶号：先通知上层（它要据此关掉自动重连），再关掉事件流。
+     *
+     * 顺序很重要：`onKicked` 里上层会去 `transport.close()`，而 reconnect 的判定
+     * 就在那条路径上 —— 先把「被顶号」这个事实告知，再关流，才不会出现「先判定为重连、后知道是顶号」。
+     */
+    private handleKicked;
+    private setPeer;
+}
+/** 批量查房间在线状态（**不加入房间**，不占 guest 位）。 */
+export interface FetchRoomStatusOptions {
+    /** 信令基址，如 `https://virlen.cn/api/rtc/`。 */
+    baseUrl: string;
+    /** 要查的房间号（由 `roomFor(电脑 key)` 派生）。 */
+    rooms: string[];
+    fetchImpl?: typeof fetch;
+}
+/**
+ * 查询一批房间的在线状态。
+ *
+ * 失败时**返回空数组而不抛错**：手机端列表的「在线状态」只是提示，
+ * 信令服务不可用/版本过旧（无 `/status`）时应当退化为「未知」，而不是把整个列表打挂。
+ */
+export declare function fetchRoomStatus(options: FetchRoomStatusOptions): Promise<RoomStatus[]>;
+/** 便利封装：`电脑 key → 在线?`（手机端列表用）。 */
+export declare function fetchHostOnlineMap(baseUrl: string, hostKeys: string[], fetchImpl?: typeof fetch): Promise<Map<string, boolean>>;
+//# sourceMappingURL=signaling.d.ts.map

package/dist/transport/signaling.d.ts.map

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