im-rtc-call-engine 1.0.0

package/dist/signaling/pendingRequests.js

@@ -0,0 +1,57 @@
+import { ErrorCode, RtcError, rtcErrorFromWire } from '../errors.js';
+/** PendingRequests 管理在途请求与它们的超时。 */
+export class PendingRequests {
+    timeoutMs;
+    waiters = new Map();
+    constructor(timeoutMs) {
+        this.timeoutMs = timeoutMs;
+    }
+    /** track 登记一个在途请求，返回它的 Promise。 */
+    track(reqId, type) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.waiters.delete(reqId);
+                reject(new RtcError(ErrorCode.signalingTimeout, { forType: type }));
+            }, this.timeoutMs);
+            this.waiters.set(reqId, { resolve, reject, timer, type });
+        });
+    }
+    /** abandon 撤掉一个还没发出去就失败的请求。 */
+    abandon(reqId) {
+        const waiter = this.waiters.get(reqId);
+        if (waiter === undefined)
+            return;
+        clearTimeout(waiter.timer);
+        this.waiters.delete(reqId);
+    }
+    /**
+     * settle 用一帧应答结算在途请求。
+     * 返回 false 表示这个 req_id 没人在等——调用方应当把它当事件处理。
+     */
+    settle(envelope, decode) {
+        const waiter = this.waiters.get(envelope.reqId);
+        if (waiter === undefined)
+            return false;
+        this.waiters.delete(envelope.reqId);
+        clearTimeout(waiter.timer);
+        if (envelope.type === 'sys.error') {
+            waiter.reject(rtcErrorFromWire(envelope.data, waiter.type));
+            return true;
+        }
+        waiter.resolve({ envelope, data: decode(envelope) });
+        return true;
+    }
+    /** rejectAll 在断线时把全部在途请求失败掉——它们的应答永远不会来了。 */
+    rejectAll(error) {
+        for (const waiter of this.waiters.values()) {
+            clearTimeout(waiter.timer);
+            waiter.reject(error);
+        }
+        this.waiters.clear();
+    }
+    /** size 供测试与诊断观察。 */
+    get size() {
+        return this.waiters.size;
+    }
+}
+//# sourceMappingURL=pendingRequests.js.map

package/dist/signaling/pendingRequests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pendingRequests.js","sourceRoot":"","sources":["../../src/signaling/pendingRequests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAuBrE,oCAAoC;AACpC,MAAM,OAAO,eAAe;IAGG;IAFZ,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD,YAA6B,SAAiB;QAAjB,cAAS,GAAT,SAAS,CAAQ;IAAG,CAAC;IAElD,mCAAmC;IACnC,KAAK,CAAC,KAAa,EAAE,IAAY;QAC/B,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACpD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC3B,MAAM,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACtE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACnB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+BAA+B;IAC/B,OAAO,CAAC,KAAa;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QACjC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,QAAkB,EAAE,MAAkD;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE3B,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6CAA6C;IAC7C,SAAS,CAAC,KAAe;QACvB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,qBAAqB;IACrB,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}

package/dist/signaling/reconnector.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 重连调度（RTC_PROTOCOL.md §1.4）。
+ *
+ * 从 Connection 里拆出来是为了体量红线（CONVENTIONS §2），也让「退避档 + 抖动 +
+ * 什么时候放弃」这组规则有独立的测试面。
+ *
+ * **注意它不判断「该不该重连」**——那是关闭码的事（`webSocket.ts` 的
+ * `shouldReconnect`）。这里只管「决定重连之后，等多久、第几次」。
+ */
+export declare class Reconnector {
+    private readonly reconnect;
+    private readonly onFailed;
+    private readonly random;
+    private timer;
+    private attempt;
+    /** 已经彻底放弃。见 stop() —— 这是**闩**，不是一次性的取消。 */
+    private stopped;
+    constructor(reconnect: () => Promise<void>, onFailed: (error: unknown) => void, random?: () => number);
+    /**
+     * schedule 安排下一次重连。
+     *
+     * **已经排着一次就什么都不做**（不重排、不进档）。一次失败会从两条路同时走到这里：
+     * `connect()` 的 promise 被拒（下面的 catch）和 socket 的 close 事件——
+     * 每次都重排的话退避档一次涨两级，日志里是 `attempt=14` 紧跟着 `attempt=15`，
+     * 十几分钟后就退到了几十秒一次，看着像「不重连了」。
+     */
+    schedule(): void;
+    /** succeeded 在一次连接成功后把退避档重置，并解掉 stop() 的闩。 */
+    succeeded(): void;
+    /**
+     * stop 彻底放弃重连，**并挡住之后的 schedule()**。
+     *
+     * 为什么不能只 `cancel()`：一次失败会从两条路走到这里，而 `connect()` 被拒的那条
+     * 是**微任务**——它排在 close 事件的处理之后。只取消定时器的话，
+     * 刚放弃完，那个迟到的 catch 又把重连排了回来，「不再重连」等于没生效。
+     */
+    stop(): void;
+    /** cancel 取消未触发的重连。幂等。 */
+    cancel(): void;
+    /** attempts 供测试与诊断观察。 */
+    get attempts(): number;
+}
+//# sourceMappingURL=reconnector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconnector.d.ts","sourceRoot":"","sources":["../../src/signaling/reconnector.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,qBAAa,WAAW;IAOpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAK;IACpB,2CAA2C;IAC3C,OAAO,CAAC,OAAO,CAAS;gBAGL,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAClC,MAAM,GAAE,MAAM,MAAoB;IAGrD;;;;;;;OAOG;IACH,QAAQ,IAAI,IAAI;IAgBhB,8CAA8C;IAC9C,SAAS,IAAI,IAAI;IAKjB;;;;;;OAMG;IACH,IAAI,IAAI,IAAI;IAKZ,0BAA0B;IAC1B,MAAM,IAAI,IAAI;IAOd,yBAAyB;IACzB,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF"}

package/dist/signaling/reconnector.js

@@ -0,0 +1,76 @@
+import { logger } from '../logger.js';
+import { backoffDelayMs } from './backoff.js';
+/**
+ * 重连调度（RTC_PROTOCOL.md §1.4）。
+ *
+ * 从 Connection 里拆出来是为了体量红线（CONVENTIONS §2），也让「退避档 + 抖动 +
+ * 什么时候放弃」这组规则有独立的测试面。
+ *
+ * **注意它不判断「该不该重连」**——那是关闭码的事（`webSocket.ts` 的
+ * `shouldReconnect`）。这里只管「决定重连之后，等多久、第几次」。
+ */
+export class Reconnector {
+    reconnect;
+    onFailed;
+    random;
+    timer = null;
+    attempt = 0;
+    /** 已经彻底放弃。见 stop() —— 这是**闩**，不是一次性的取消。 */
+    stopped = false;
+    constructor(reconnect, onFailed, random = Math.random) {
+        this.reconnect = reconnect;
+        this.onFailed = onFailed;
+        this.random = random;
+    }
+    /**
+     * schedule 安排下一次重连。
+     *
+     * **已经排着一次就什么都不做**（不重排、不进档）。一次失败会从两条路同时走到这里：
+     * `connect()` 的 promise 被拒（下面的 catch）和 socket 的 close 事件——
+     * 每次都重排的话退避档一次涨两级，日志里是 `attempt=14` 紧跟着 `attempt=15`，
+     * 十几分钟后就退到了几十秒一次，看着像「不重连了」。
+     */
+    schedule() {
+        if (this.stopped || this.timer !== null)
+            return;
+        const delayMs = backoffDelayMs(this.attempt, this.random);
+        this.attempt += 1;
+        logger.info('计划重连', { attempt: this.attempt, delayMs });
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.reconnect().catch((err) => {
+                this.onFailed(err);
+                // 失败后继续退避——档位不重置，否则断网期间会退化成每秒重试。
+                this.schedule();
+            });
+        }, delayMs);
+    }
+    /** succeeded 在一次连接成功后把退避档重置，并解掉 stop() 的闩。 */
+    succeeded() {
+        this.attempt = 0;
+        this.stopped = false;
+    }
+    /**
+     * stop 彻底放弃重连，**并挡住之后的 schedule()**。
+     *
+     * 为什么不能只 `cancel()`：一次失败会从两条路走到这里，而 `connect()` 被拒的那条
+     * 是**微任务**——它排在 close 事件的处理之后。只取消定时器的话，
+     * 刚放弃完，那个迟到的 catch 又把重连排了回来，「不再重连」等于没生效。
+     */
+    stop() {
+        this.stopped = true;
+        this.cancel();
+    }
+    /** cancel 取消未触发的重连。幂等。 */
+    cancel() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    /** attempts 供测试与诊断观察。 */
+    get attempts() {
+        return this.attempt;
+    }
+}
+//# sourceMappingURL=reconnector.js.map

package/dist/signaling/reconnector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnector.js","sourceRoot":"","sources":["../../src/signaling/reconnector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAW;IAOH;IACA;IACA;IARX,KAAK,GAAyC,IAAI,CAAC;IACnD,OAAO,GAAG,CAAC,CAAC;IACpB,2CAA2C;IACnC,OAAO,GAAG,KAAK,CAAC;IAExB,YACmB,SAA8B,EAC9B,QAAkC,EAClC,SAAuB,IAAI,CAAC,MAAM;QAFlC,cAAS,GAAT,SAAS,CAAqB;QAC9B,aAAQ,GAAR,QAAQ,CAA0B;QAClC,WAAM,GAAN,MAAM,CAA4B;IAClD,CAAC;IAEJ;;;;;;;OAOG;IACH,QAAQ;QACN,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO;QAChD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAExD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBAC3C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACnB,iCAAiC;gBACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAED,8CAA8C;IAC9C,SAAS;QACP,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,0BAA0B;IAC1B,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/signaling/registry.d.ts

@@ -0,0 +1,100 @@
+import type { Envelope } from './envelope.js';
+import type { FrameData, FrameFields } from './fieldSpec.js';
+/**
+ * 帧类型注册表，对应 RTC_PROTOCOL.md 附录 A 的帧索引。
+ *
+ * 「加一个帧」的完整动作是：改协议文档 → 改 conformance 向量 → 在这里注册 → 四仓跟进。
+ * 顺序不许颠倒（§9）。
+ */
+/** FrameType 是全部帧类型的常量表。命名规则见 §2.3：`<域>.<动作>[.ok]`。 */
+export declare const FrameType: {
+    readonly hello: "sys.hello";
+    readonly helloOk: "sys.hello.ok";
+    readonly ping: "sys.ping";
+    readonly pong: "sys.pong";
+    readonly error: "sys.error";
+    readonly roomJoin: "room.join";
+    readonly roomLeave: "room.leave";
+    readonly roomPublish: "room.publish";
+    readonly roomUnpublish: "room.unpublish";
+    readonly roomMute: "room.mute";
+    readonly roomSubscribe: "room.subscribe";
+    readonly roomUnsubscribe: "room.unsubscribe";
+    readonly roomUpdateLayer: "room.update_layer";
+    readonly roomOffer: "room.offer";
+    readonly roomAnswer: "room.answer";
+    readonly roomIceCandidate: "room.ice_candidate";
+    readonly roomParticipantJoined: "room.participant_joined";
+    readonly roomParticipantLeft: "room.participant_left";
+    readonly roomTrackPublished: "room.track_published";
+    readonly roomTrackUnpublished: "room.track_unpublished";
+    readonly roomTrackMuted: "room.track_muted";
+    readonly roomActiveSpeakers: "room.active_speakers";
+    readonly roomQuality: "room.quality";
+    readonly roomClosed: "room.closed";
+    readonly callInvite: "call.invite";
+    readonly callAccept: "call.accept";
+    readonly callReject: "call.reject";
+    readonly callCancel: "call.cancel";
+    readonly callHangup: "call.hangup";
+    readonly callInviteMore: "call.invite_more";
+    readonly callJoin: "call.join";
+    readonly callIncoming: "call.incoming";
+    readonly callRinging: "call.ringing";
+    readonly callAccepted: "call.accepted";
+    readonly callRejected: "call.rejected";
+    readonly callBusy: "call.busy";
+    readonly callNoAnswer: "call.no_answer";
+    readonly callCancelled: "call.cancelled";
+    readonly callConnected: "call.connected";
+    readonly callHandledElsewhere: "call.handled_elsewhere";
+    readonly callEnded: "call.ended";
+};
+/**
+ * REQUEST_TYPES 是全部上行请求帧。请求必须带非空 req_id，且**恰好**有一条应答。
+ *
+ * room.offer / answer / ice_candidate 不在这张表里——它们是双向的，
+ * 「谁是请求方」由 pc 字段决定（§3.3），不由 type 决定。
+ */
+export declare const REQUEST_TYPES: readonly string[];
+/**
+ * RESERVED_TYPES 是 §3.6 的会议层留位帧：**已占名但 v1 不实现**。
+ * 客户端不该发它们；收到服务端的 1003 时要能分清「将来会有」与「压根没有」。
+ */
+export declare const RESERVED_TYPES: readonly string[];
+/** isRequestType 报告这个 type 是不是上行请求帧。 */
+export declare function isRequestType(type: string): boolean;
+/** isReservedType 报告这个 type 是不是已占名但未实现的会议层帧。 */
+export declare function isReservedType(type: string): boolean;
+/**
+ * lookupFrame 返回某帧类型的字段声明。
+ *
+ * 请求帧的 .ok 如果没单独登记，一律给空对象——纯 ack 是常态，
+ * 不必为每个 room.mute.ok 写一份声明。
+ */
+export declare function lookupFrame(type: string): FrameFields | undefined;
+/** knownFrameTypes 列出全部已注册的帧类型（不含自动派生的 .ok），供测试核对。 */
+export declare function knownFrameTypes(): string[];
+/**
+ * decodeFrame 按 Envelope.type 解出帧数据。
+ *
+ * 未注册的 type 抛 unknown_type——但**客户端收到未知 type 时应当静默忽略**
+ * （§2.3 前向兼容，服务端可能比客户端新），别把这个错误抛给宿主。
+ */
+export declare function decodeFrame(envelope: Envelope): Record<string, unknown>;
+/**
+ * newFrameData 返回某帧**已填好协议默认值**的数据对象。
+ *
+ * # 发送方必须用它
+ *
+ * 「可选字段用省略表达，接收方按默认值填」（§2.4 规则 2）只对**省略**成立。
+ * 而 JSON.stringify 会把显式的 false / 0 编码出去：直接写
+ * `{ room_id: 'r-1' }` 少了 auto_subscribe，写 `{ ..., auto_subscribe: false }`
+ * 又把默认的 true 覆盖成了 false。两种写法都会让人进了房收不到任何流。
+ *
+ * 三端同理（Go 的结构体零值、Swift 的 Codable）。**发送侧一律从这里开始改字段。**
+ */
+export declare function newFrameData<F extends FrameFields>(fields: F): FrameData<F>;
+/** encodeFrame 把帧数据映射回线路上的 snake_case data。 */
+export declare function encodeFrame<F extends FrameFields>(fields: F, value: FrameData<F>): Record<string, unknown>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/signaling/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAK7D;;;;;GAKG;AAEH,uDAAuD;AACvD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CZ,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAkB1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAS3C,CAAC;AAKF,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AA+DD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAQjE;AAED,sDAAsD;AACtD,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAE3E;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,CAAC,SAAS,WAAW,EAC/C,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB"}

package/dist/signaling/registry.js

@@ -0,0 +1,217 @@
+import { ErrorCode, RtcError } from '../errors.js';
+import { OK_SUFFIX, okType } from './envelope.js';
+import { decodeFields, encodeFields } from './fieldSpec.js';
+import * as call from './frames.call.js';
+import * as room from './frames.room.js';
+import * as sys from './frames.sys.js';
+/**
+ * 帧类型注册表，对应 RTC_PROTOCOL.md 附录 A 的帧索引。
+ *
+ * 「加一个帧」的完整动作是：改协议文档 → 改 conformance 向量 → 在这里注册 → 四仓跟进。
+ * 顺序不许颠倒（§9）。
+ */
+/** FrameType 是全部帧类型的常量表。命名规则见 §2.3：`<域>.<动作>[.ok]`。 */
+export const FrameType = {
+    hello: 'sys.hello',
+    helloOk: 'sys.hello.ok',
+    ping: 'sys.ping',
+    pong: 'sys.pong',
+    error: 'sys.error',
+    roomJoin: 'room.join',
+    roomLeave: 'room.leave',
+    roomPublish: 'room.publish',
+    roomUnpublish: 'room.unpublish',
+    roomMute: 'room.mute',
+    roomSubscribe: 'room.subscribe',
+    roomUnsubscribe: 'room.unsubscribe',
+    roomUpdateLayer: 'room.update_layer',
+    roomOffer: 'room.offer',
+    roomAnswer: 'room.answer',
+    roomIceCandidate: 'room.ice_candidate',
+    roomParticipantJoined: 'room.participant_joined',
+    roomParticipantLeft: 'room.participant_left',
+    roomTrackPublished: 'room.track_published',
+    roomTrackUnpublished: 'room.track_unpublished',
+    roomTrackMuted: 'room.track_muted',
+    roomActiveSpeakers: 'room.active_speakers',
+    roomQuality: 'room.quality',
+    roomClosed: 'room.closed',
+    callInvite: 'call.invite',
+    callAccept: 'call.accept',
+    callReject: 'call.reject',
+    callCancel: 'call.cancel',
+    callHangup: 'call.hangup',
+    callInviteMore: 'call.invite_more',
+    callJoin: 'call.join',
+    callIncoming: 'call.incoming',
+    callRinging: 'call.ringing',
+    callAccepted: 'call.accepted',
+    callRejected: 'call.rejected',
+    callBusy: 'call.busy',
+    callNoAnswer: 'call.no_answer',
+    callCancelled: 'call.cancelled',
+    callConnected: 'call.connected',
+    callHandledElsewhere: 'call.handled_elsewhere',
+    callEnded: 'call.ended',
+};
+/**
+ * REQUEST_TYPES 是全部上行请求帧。请求必须带非空 req_id，且**恰好**有一条应答。
+ *
+ * room.offer / answer / ice_candidate 不在这张表里——它们是双向的，
+ * 「谁是请求方」由 pc 字段决定（§3.3），不由 type 决定。
+ */
+export const REQUEST_TYPES = [
+    FrameType.hello,
+    FrameType.ping,
+    FrameType.roomJoin,
+    FrameType.roomLeave,
+    FrameType.roomPublish,
+    FrameType.roomUnpublish,
+    FrameType.roomMute,
+    FrameType.roomSubscribe,
+    FrameType.roomUnsubscribe,
+    FrameType.roomUpdateLayer,
+    FrameType.callInvite,
+    FrameType.callAccept,
+    FrameType.callReject,
+    FrameType.callCancel,
+    FrameType.callHangup,
+    FrameType.callInviteMore,
+    FrameType.callJoin,
+];
+/**
+ * RESERVED_TYPES 是 §3.6 的会议层留位帧：**已占名但 v1 不实现**。
+ * 客户端不该发它们；收到服务端的 1003 时要能分清「将来会有」与「压根没有」。
+ */
+export const RESERVED_TYPES = [
+    'room.mute_participant',
+    'room.kick',
+    'room.lock',
+    'room.raise_hand',
+    'room.participant_muted',
+    'room.participant_kicked',
+    'room.hand_raised',
+    'room.locked',
+];
+const REQUEST_SET = new Set(REQUEST_TYPES);
+const RESERVED_SET = new Set(RESERVED_TYPES);
+/** isRequestType 报告这个 type 是不是上行请求帧。 */
+export function isRequestType(type) {
+    return REQUEST_SET.has(type);
+}
+/** isReservedType 报告这个 type 是不是已占名但未实现的会议层帧。 */
+export function isReservedType(type) {
+    return RESERVED_SET.has(type);
+}
+const REGISTRY = {
+    [FrameType.hello]: sys.HELLO_FIELDS,
+    [FrameType.helloOk]: sys.HELLO_OK_FIELDS,
+    [FrameType.ping]: sys.EMPTY_FIELDS,
+    [FrameType.pong]: sys.EMPTY_FIELDS,
+    [FrameType.error]: sys.ERROR_FIELDS,
+    [FrameType.roomJoin]: room.JOIN_FIELDS,
+    [FrameType.roomLeave]: room.LEAVE_FIELDS,
+    [FrameType.roomPublish]: room.PUBLISH_FIELDS,
+    [FrameType.roomUnpublish]: room.TRACK_ID_FIELDS,
+    [FrameType.roomMute]: room.MUTE_FIELDS,
+    [FrameType.roomSubscribe]: room.LAYER_FIELDS,
+    [FrameType.roomUnsubscribe]: room.TRACK_ID_FIELDS,
+    [FrameType.roomUpdateLayer]: room.LAYER_FIELDS,
+    [FrameType.roomOffer]: room.SDP_FIELDS,
+    [FrameType.roomAnswer]: room.SDP_FIELDS,
+    [FrameType.roomIceCandidate]: room.ICE_FIELDS,
+    [FrameType.roomParticipantJoined]: room.PARTICIPANT_JOINED_FIELDS,
+    [FrameType.roomParticipantLeft]: room.PARTICIPANT_LEFT_FIELDS,
+    [FrameType.roomTrackPublished]: room.TRACK_PUBLISHED_FIELDS,
+    [FrameType.roomTrackUnpublished]: room.TRACK_UNPUBLISHED_FIELDS,
+    [FrameType.roomTrackMuted]: room.TRACK_MUTED_FIELDS,
+    [FrameType.roomActiveSpeakers]: room.ACTIVE_SPEAKERS_FIELDS,
+    [FrameType.roomQuality]: room.QUALITY_FIELDS,
+    [FrameType.roomClosed]: room.ROOM_CLOSED_FIELDS,
+    [FrameType.callInvite]: call.INVITE_FIELDS,
+    [FrameType.callAccept]: call.CALL_ID_FIELDS,
+    [FrameType.callReject]: call.CALL_ID_FIELDS,
+    [FrameType.callCancel]: call.CALL_ID_FIELDS,
+    [FrameType.callHangup]: call.CALL_ID_FIELDS,
+    [FrameType.callInviteMore]: call.INVITE_MORE_FIELDS,
+    [FrameType.callJoin]: call.CALL_ID_FIELDS,
+    [FrameType.callIncoming]: call.INCOMING_FIELDS,
+    [FrameType.callRinging]: call.RINGING_FIELDS,
+    [FrameType.callAccepted]: call.MEMBER_OUTCOME_FIELDS,
+    [FrameType.callRejected]: call.MEMBER_OUTCOME_FIELDS,
+    [FrameType.callBusy]: call.MEMBER_OUTCOME_FIELDS,
+    [FrameType.callNoAnswer]: call.MEMBER_OUTCOME_FIELDS,
+    [FrameType.callCancelled]: call.CANCELLED_FIELDS,
+    [FrameType.callConnected]: call.CONNECTED_FIELDS,
+    [FrameType.callHandledElsewhere]: call.HANDLED_ELSEWHERE_FIELDS,
+    [FrameType.callEnded]: call.ENDED_FIELDS,
+};
+const OK_REGISTRY = {
+    [okType(FrameType.hello)]: sys.HELLO_OK_FIELDS,
+    [okType(FrameType.roomJoin)]: room.JOIN_OK_FIELDS,
+    [okType(FrameType.roomPublish)]: room.PUBLISH_OK_FIELDS,
+    [okType(FrameType.callInvite)]: call.INVITE_OK_FIELDS,
+    // room.offer 没有 .ok —— pub 侧的 offer 由 room.answer 直接作为应答回来（§3.3）。
+    [okType(FrameType.roomAnswer)]: sys.EMPTY_FIELDS,
+    [okType(FrameType.roomIceCandidate)]: sys.EMPTY_FIELDS,
+    [okType(FrameType.callAccept)]: sys.EMPTY_FIELDS,
+    [okType(FrameType.callJoin)]: sys.EMPTY_FIELDS,
+    [okType(FrameType.callInviteMore)]: sys.EMPTY_FIELDS,
+};
+/**
+ * lookupFrame 返回某帧类型的字段声明。
+ *
+ * 请求帧的 .ok 如果没单独登记，一律给空对象——纯 ack 是常态，
+ * 不必为每个 room.mute.ok 写一份声明。
+ */
+export function lookupFrame(type) {
+    const direct = REGISTRY[type] ?? OK_REGISTRY[type];
+    if (direct !== undefined)
+        return direct;
+    if (type.endsWith(OK_SUFFIX)) {
+        const base = type.slice(0, -OK_SUFFIX.length);
+        if (isRequestType(base))
+            return sys.EMPTY_FIELDS;
+    }
+    return undefined;
+}
+/** knownFrameTypes 列出全部已注册的帧类型（不含自动派生的 .ok），供测试核对。 */
+export function knownFrameTypes() {
+    return [...Object.keys(REGISTRY), ...Object.keys(OK_REGISTRY)];
+}
+/**
+ * decodeFrame 按 Envelope.type 解出帧数据。
+ *
+ * 未注册的 type 抛 unknown_type——但**客户端收到未知 type 时应当静默忽略**
+ * （§2.3 前向兼容，服务端可能比客户端新），别把这个错误抛给宿主。
+ */
+export function decodeFrame(envelope) {
+    const fields = lookupFrame(envelope.type);
+    if (fields === undefined) {
+        throw new RtcError(ErrorCode.unknownType, {
+            forType: envelope.type,
+            cause: new Error(`未注册的帧 "${envelope.type}"`),
+        });
+    }
+    return decodeFields(fields, envelope.data);
+}
+/**
+ * newFrameData 返回某帧**已填好协议默认值**的数据对象。
+ *
+ * # 发送方必须用它
+ *
+ * 「可选字段用省略表达，接收方按默认值填」（§2.4 规则 2）只对**省略**成立。
+ * 而 JSON.stringify 会把显式的 false / 0 编码出去：直接写
+ * `{ room_id: 'r-1' }` 少了 auto_subscribe，写 `{ ..., auto_subscribe: false }`
+ * 又把默认的 true 覆盖成了 false。两种写法都会让人进了房收不到任何流。
+ *
+ * 三端同理（Go 的结构体零值、Swift 的 Codable）。**发送侧一律从这里开始改字段。**
+ */
+export function newFrameData(fields) {
+    return decodeFields(fields, {});
+}
+/** encodeFrame 把帧数据映射回线路上的 snake_case data。 */
+export function encodeFrame(fields, value) {
+    return encodeFields(fields, value);
+}
+//# sourceMappingURL=registry.js.map

package/dist/signaling/registry.js.map

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

package/dist/signaling/resumeDeadline.d.ts

@@ -0,0 +1,48 @@
+/** 协议 §1.4 的恢复窗口：30 秒。**四端同一个值**，服务端的 `ResumeWindow` 也是它。 */
+export declare const RESUME_WINDOW_SEC = 30;
+/** 服务端判一条连接死掉要连续几个心跳周期收不到东西（§1.3）。 */
+export declare const SERVER_DEATH_PINGS = 3;
+/** 余量：跨过服务端窗口到期那一刻再收场，别跟它抢同一秒。 */
+export declare const GIVE_UP_GRACE_SEC = 5;
+export declare function giveUpDelayMs(pingIntervalSec: number): number;
+/**
+ * 「服务端已经彻底放弃这条会话」的倒计时（协议 §1.4）。
+ *
+ * # 为什么需要它
+ *
+ * 客户端本地放弃的唯一入口原本是「重连上了但 `resumed=false`」——**它要求先连回来**。
+ * 网络一直不回来的话那一刻永远不会到，界面就永远停在「正在重连」，
+ * 而且**连挂断都点不动**（挂断只产出一帧发不出去的 `call.hangup`，
+ * 本地状态按 §4.2 铁律 1 一动不动）。真机 2026-09-08 的 iOS 端就是这一幕。
+ *
+ * # 从 Connection 里拆出来
+ *
+ * 和 `Reconnector` 同一个理由：体量红线（CONVENTIONS §2），
+ * 也让「什么时候该放弃」这条规则有独立的测试面。
+ */
+export declare class ResumeDeadline {
+    private readonly onUnrecoverable;
+    private timer;
+    private pingIntervalSec;
+    constructor(onUnrecoverable: () => void);
+    /**
+     * 握手成功：撤掉倒计时，并记下服务端给的心跳周期（上界要拿它推算）。
+     *
+     * **不管 `resumed` 是真是假都要撤** —— 服务端已经给出裁决，
+     * `resumed=false` 那条自有 `handleHelloOk` 去收场，不该再由倒计时补一刀。
+     */
+    connected(pingIntervalSec: number): void;
+    /**
+     * 起倒计时。
+     *
+     * **只在第一次断开时起**：每一次重连失败都会走到调用点，每次都重排的话
+     * 截止时刻就一直往后挪、永远不会到——而那正是它要治的病。
+     * 起点是第一次断开的那一刻，与服务端算的是同一笔账。
+     */
+    arm(): void;
+    /** 撤销。连上了、或宿主 logout 了都要调。幂等。 */
+    cancel(): void;
+    /** armed 供测试与诊断观察。 */
+    get armed(): boolean;
+}
+//# sourceMappingURL=resumeDeadline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resumeDeadline.d.ts","sourceRoot":"","sources":["../../src/signaling/resumeDeadline.ts"],"names":[],"mappings":"AAEA,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAkBnC,wBAAgB,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,eAAe;IAH5C,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,eAAe,CAAM;gBAEA,eAAe,EAAE,MAAM,IAAI;IAExD;;;;;OAKG;IACH,SAAS,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAKxC;;;;;;OAMG;IACH,GAAG,IAAI,IAAI;IAWX,iCAAiC;IACjC,MAAM,IAAI,IAAI;IAOd,sBAAsB;IACtB,IAAI,KAAK,IAAI,OAAO,CAEnB;CACF"}