im-rtc-call-engine 1.0.0

package/dist/signaling/frames.room.js

@@ -0,0 +1,165 @@
+import { LAYERS, PC_ROLES, REASONS, ROOM_KINDS, TRACK_KINDS, TRACK_SOURCES, } from './enums.js';
+/**
+ * room 域：房间与媒体。见 RTC_PROTOCOL.md §3。
+ * Room 层是媒体的全部——1v1、群通话、会议都用同一套帧。
+ */
+/** PARTICIPANT_FIELDS：房间成员快照。 */
+export const PARTICIPANT_FIELDS = {
+    participantId: { kind: 'string', wire: 'participant_id' },
+    uid: { kind: 'string', wire: 'uid' },
+    deviceId: { kind: 'string', wire: 'device_id' },
+    joinedAtMs: { kind: 'int', wire: 'joined_at_ms' },
+};
+/** TRACK_FIELDS：一条已发布 Track 的快照。 */
+export const TRACK_FIELDS = {
+    trackId: { kind: 'string', wire: 'track_id' },
+    participantId: { kind: 'string', wire: 'participant_id' },
+    uid: { kind: 'string', wire: 'uid' },
+    kind: { kind: 'enum', wire: 'kind', values: TRACK_KINDS, fallback: 'audio' },
+    source: { kind: 'enum', wire: 'source', values: TRACK_SOURCES, fallback: 'microphone' },
+    codec: { kind: 'string', wire: 'codec' },
+    /** 空数组 = 单层。**不能是 null**。 */
+    simulcastLayers: { kind: 'enumArray', wire: 'simulcast_layers', values: LAYERS, fallback: 'l' },
+    muted: { kind: 'bool', wire: 'muted' },
+};
+/**
+ * JOIN_FIELDS：进房请求。
+ *
+ * **注意 auto_subscribe / publish_audio 默认是 true**：直接用零值对象发这一帧，
+ * 线路上会变成 false，人进了房却收不到任何流。发送侧一律用 newJoinData()。
+ */
+export const JOIN_FIELDS = {
+    roomId: { kind: 'string', wire: 'room_id' },
+    roomToken: { kind: 'string', wire: 'room_token' },
+    autoSubscribe: { kind: 'bool', wire: 'auto_subscribe', default: true },
+    publishAudio: { kind: 'bool', wire: 'publish_audio', default: true },
+    publishVideo: { kind: 'bool', wire: 'publish_video', default: false },
+};
+/** JOIN_OK_FIELDS：带回整个房间的快照，客户端据此一次性把九宫格搭起来。 */
+export const JOIN_OK_FIELDS = {
+    roomId: { kind: 'string', wire: 'room_id' },
+    roomKind: { kind: 'enum', wire: 'room_kind', values: ROOM_KINDS, fallback: 'call_group' },
+    participantId: { kind: 'string', wire: 'participant_id' },
+    maxParticipants: { kind: 'int', wire: 'max_participants' },
+    joinedAtMs: { kind: 'int', wire: 'joined_at_ms' },
+    participants: { kind: 'objectArray', wire: 'participants', fields: PARTICIPANT_FIELDS },
+    tracks: { kind: 'objectArray', wire: 'tracks', fields: TRACK_FIELDS },
+};
+/** LEAVE_FIELDS：离房请求。 */
+export const LEAVE_FIELDS = {
+    roomId: { kind: 'string', wire: 'room_id' },
+};
+/**
+ * PUBLISH_FIELDS：发布请求。
+ *
+ * cid 是**客户端**生成的本地 track 标识，必须出现在随后 pub offer 的 msid 里；
+ * 服务端靠它把 SDP 的 m-line 认回 track_id。
+ */
+export const PUBLISH_FIELDS = {
+    cid: { kind: 'string', wire: 'cid' },
+    kind: { kind: 'enum', wire: 'kind', values: TRACK_KINDS, fallback: 'audio' },
+    source: { kind: 'enum', wire: 'source', values: TRACK_SOURCES, fallback: 'microphone' },
+    simulcast: { kind: 'bool', wire: 'simulcast' },
+    width: { kind: 'int', wire: 'width' },
+    height: { kind: 'int', wire: 'height' },
+    maxBitrateKbps: { kind: 'int', wire: 'max_bitrate_kbps' },
+};
+/** PUBLISH_OK_FIELDS：回带 track_id 与原样回显的 cid 供配对。 */
+export const PUBLISH_OK_FIELDS = {
+    trackId: { kind: 'string', wire: 'track_id' },
+    cid: { kind: 'string', wire: 'cid' },
+};
+/** TRACK_ID_FIELDS：只带 track_id 的帧（unpublish / unsubscribe）。 */
+export const TRACK_ID_FIELDS = {
+    trackId: { kind: 'string', wire: 'track_id' },
+};
+/** MUTE_FIELDS：开关麦克风/摄像头。**这不是 unpublish**，Track 与协商都保留。 */
+export const MUTE_FIELDS = {
+    trackId: { kind: 'string', wire: 'track_id' },
+    muted: { kind: 'bool', wire: 'muted' },
+};
+/** LAYER_FIELDS：订阅与换层。max_layer 是**上界不是命令**。 */
+export const LAYER_FIELDS = {
+    trackId: { kind: 'string', wire: 'track_id' },
+    maxLayer: { kind: 'enum', wire: 'max_layer', values: LAYERS, fallback: 'l', default: 'm' },
+};
+/** SDP_FIELDS：room.offer 与 room.answer 共用。 */
+export const SDP_FIELDS = {
+    pc: { kind: 'enum', wire: 'pc', values: PC_ROLES, fallback: 'pub' },
+    sdp: { kind: 'string', wire: 'sdp' },
+};
+/** ICE_FIELDS：trickle ICE 候选。candidate 为 '' 表示收集结束，接收方必须容忍。 */
+export const ICE_FIELDS = {
+    pc: { kind: 'enum', wire: 'pc', values: PC_ROLES, fallback: 'pub' },
+    candidate: { kind: 'string', wire: 'candidate' },
+    sdpMid: { kind: 'string', wire: 'sdp_mid' },
+    sdpMLineIndex: { kind: 'int', wire: 'sdp_mline_index' },
+};
+/** PARTICIPANT_JOINED_FIELDS：有人进房。 */
+export const PARTICIPANT_JOINED_FIELDS = {
+    roomId: { kind: 'string', wire: 'room_id' },
+    participantId: { kind: 'string', wire: 'participant_id' },
+    uid: { kind: 'string', wire: 'uid' },
+    deviceId: { kind: 'string', wire: 'device_id' },
+    joinedAtMs: { kind: 'int', wire: 'joined_at_ms' },
+};
+/** PARTICIPANT_LEFT_FIELDS：有人离房。reason 取 §6 的子集。 */
+export const PARTICIPANT_LEFT_FIELDS = {
+    roomId: { kind: 'string', wire: 'room_id' },
+    participantId: { kind: 'string', wire: 'participant_id' },
+    uid: { kind: 'string', wire: 'uid' },
+    deviceId: { kind: 'string', wire: 'device_id' },
+    reason: { kind: 'enum', wire: 'reason', values: REASONS, fallback: 'error' },
+    durationSec: { kind: 'int', wire: 'duration_sec' },
+};
+/** TRACK_PUBLISHED_FIELDS：有人发布了 Track。 */
+export const TRACK_PUBLISHED_FIELDS = {
+    roomId: { kind: 'string', wire: 'room_id' },
+    ...TRACK_FIELDS,
+};
+/** TRACK_UNPUBLISHED_FIELDS：有人销毁了 Track。 */
+export const TRACK_UNPUBLISHED_FIELDS = {
+    roomId: { kind: 'string', wire: 'room_id' },
+    trackId: { kind: 'string', wire: 'track_id' },
+    participantId: { kind: 'string', wire: 'participant_id' },
+    uid: { kind: 'string', wire: 'uid' },
+};
+/** TRACK_MUTED_FIELDS：对应 onUserAudioAvailable / onUserVideoAvailable。 */
+export const TRACK_MUTED_FIELDS = {
+    roomId: { kind: 'string', wire: 'room_id' },
+    trackId: { kind: 'string', wire: 'track_id' },
+    participantId: { kind: 'string', wire: 'participant_id' },
+    uid: { kind: 'string', wire: 'uid' },
+    kind: { kind: 'enum', wire: 'kind', values: TRACK_KINDS, fallback: 'audio' },
+    muted: { kind: 'bool', wire: 'muted' },
+};
+/** SPEAKER_FIELDS：一个正在说话的人。volume 0~100，**整数**。 */
+export const SPEAKER_FIELDS = {
+    participantId: { kind: 'string', wire: 'participant_id' },
+    uid: { kind: 'string', wire: 'uid' },
+    volume: { kind: 'int', wire: 'volume', min: 0, max: 100 },
+};
+/** ACTIVE_SPEAKERS_FIELDS：服务端节流 300ms，客户端**不得**依赖更高频率。 */
+export const ACTIVE_SPEAKERS_FIELDS = {
+    roomId: { kind: 'string', wire: 'room_id' },
+    speakers: { kind: 'objectArray', wire: 'speakers', fields: SPEAKER_FIELDS },
+};
+/** QUALITY_ENTRY_FIELDS：一个人的网络质量，level 0~6。 */
+export const QUALITY_ENTRY_FIELDS = {
+    participantId: { kind: 'string', wire: 'participant_id' },
+    uid: { kind: 'string', wire: 'uid' },
+    // 越界折成 0 = unknown，**不是钳到 6**——把未知说成「已断开」会误导 UI。
+    level: { kind: 'int', wire: 'level', min: 0, max: 6, outOfRange: 0 },
+};
+/** QUALITY_FIELDS：服务端节流 2s。 */
+export const QUALITY_FIELDS = {
+    roomId: { kind: 'string', wire: 'room_id' },
+    entries: { kind: 'objectArray', wire: 'entries', fields: QUALITY_ENTRY_FIELDS },
+};
+/** ROOM_CLOSED_FIELDS：房间结束。 */
+export const ROOM_CLOSED_FIELDS = {
+    roomId: { kind: 'string', wire: 'room_id' },
+    reason: { kind: 'enum', wire: 'reason', values: REASONS, fallback: 'error' },
+    durationSec: { kind: 'int', wire: 'duration_sec' },
+};
+//# sourceMappingURL=frames.room.js.map

package/dist/signaling/frames.room.js.map

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

package/dist/signaling/frames.sys.d.ts

@@ -0,0 +1,145 @@
+/** sys 域：连接、鉴权、心跳、错误。见 RTC_PROTOCOL.md §1 与 §7。 */
+/** EMPTY_FIELDS 用于 data 恒为 {} 的帧：sys.ping / sys.pong / 各种纯 ack。 */
+export declare const EMPTY_FIELDS: {};
+/**
+ * HELLO_FIELDS：WS 打开后必须在 5 秒内发出的第一帧（§1.2）。
+ *
+ * token 走首帧而不是 URL 查询串：查询串会进网关日志、Referer 与浏览器历史。
+ */
+export declare const HELLO_FIELDS: {
+    readonly protocolVersion: {
+        readonly kind: "int";
+        readonly wire: "protocol_version";
+        readonly default: 1;
+    };
+    readonly token: {
+        readonly kind: "string";
+        readonly wire: "token";
+    };
+    readonly deviceId: {
+        readonly kind: "string";
+        readonly wire: "device_id";
+    };
+    /** 重连恢复用；首次连接为 ''。 */
+    readonly sessionId: {
+        readonly kind: "string";
+        readonly wire: "session_id";
+    };
+    /** 仅用于日志与灰度，**禁止参与逻辑**。 */
+    readonly sdk: {
+        readonly kind: "string";
+        readonly wire: "sdk";
+    };
+};
+/** LIMITS_FIELDS：服务端下发的限额，让客户端能本地预校验（§2.6）。 */
+export declare const LIMITS_FIELDS: {
+    readonly maxFrameBytes: {
+        readonly kind: "int";
+        readonly wire: "max_frame_bytes";
+    };
+    readonly maxCallees: {
+        readonly kind: "int";
+        readonly wire: "max_callees";
+    };
+    readonly maxRoomParticipants: {
+        readonly kind: "int";
+        readonly wire: "max_room_participants";
+    };
+    readonly maxUserDataBytes: {
+        readonly kind: "int";
+        readonly wire: "max_user_data_bytes";
+    };
+    readonly ringTimeoutSecDefault: {
+        readonly kind: "int";
+        readonly wire: "ring_timeout_sec_default";
+    };
+};
+/** HELLO_OK_FIELDS：鉴权成功的应答。 */
+export declare const HELLO_OK_FIELDS: {
+    readonly uid: {
+        readonly kind: "string";
+        readonly wire: "uid";
+    };
+    readonly deviceId: {
+        readonly kind: "string";
+        readonly wire: "device_id";
+    };
+    readonly sessionId: {
+        readonly kind: "string";
+        readonly wire: "session_id";
+    };
+    /** 供客户端算时钟偏移，**只做展示**。 */
+    readonly serverTimeMs: {
+        readonly kind: "int";
+        readonly wire: "server_time_ms";
+    };
+    readonly resumed: {
+        readonly kind: "bool";
+        readonly wire: "resumed";
+    };
+    readonly pingIntervalSec: {
+        readonly kind: "int";
+        readonly wire: "ping_interval_sec";
+    };
+    /**
+     * 本次握手用的那张票的到期时刻（Unix 毫秒）。**0 = 未知**。
+     *
+     * 客户端据此在到期前主动换票，而不是等下一次重连撞上 4401 再被动补救。
+     * **禁止自己解析 token 取 exp**——票对客户端是 opaque 的，可能根本不是 JWT。
+     */
+    readonly tokenExpiresAtMs: {
+        readonly kind: "int";
+        readonly wire: "token_expires_at_ms";
+    };
+    readonly limits: {
+        readonly kind: "object";
+        readonly wire: "limits";
+        readonly fields: {
+            readonly maxFrameBytes: {
+                readonly kind: "int";
+                readonly wire: "max_frame_bytes";
+            };
+            readonly maxCallees: {
+                readonly kind: "int";
+                readonly wire: "max_callees";
+            };
+            readonly maxRoomParticipants: {
+                readonly kind: "int";
+                readonly wire: "max_room_participants";
+            };
+            readonly maxUserDataBytes: {
+                readonly kind: "int";
+                readonly wire: "max_user_data_bytes";
+            };
+            readonly ringTimeoutSecDefault: {
+                readonly kind: "int";
+                readonly wire: "ring_timeout_sec_default";
+            };
+        };
+    };
+};
+/** ERROR_FIELDS：sys.error 的 data（§7）。 */
+export declare const ERROR_FIELDS: {
+    readonly code: {
+        readonly kind: "int";
+        readonly wire: "code";
+    };
+    readonly name: {
+        readonly kind: "string";
+        readonly wire: "name";
+    };
+    /** 英文固定短语，给开发者看；**禁止直接显示给用户**。 */
+    readonly msg: {
+        readonly kind: "string";
+        readonly wire: "msg";
+    };
+    readonly forType: {
+        readonly kind: "string";
+        readonly wire: "for_type";
+    };
+    readonly retryable: {
+        readonly kind: "bool";
+        readonly wire: "retryable";
+    };
+};
+//# sourceMappingURL=frames.sys.d.ts.map

package/dist/signaling/frames.sys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.sys.d.ts","sourceRoot":"","sources":["../../src/signaling/frames.sys.ts"],"names":[],"mappings":"AAEA,mDAAmD;AAEnD,mEAAmE;AACnE,eAAO,MAAM,YAAY,IAAoC,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;IAIvB,sBAAsB;;;;;IAEtB,2BAA2B;;;;;CAEG,CAAC;AAEjC,+CAA+C;AAC/C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;CAMM,CAAC;AAEjC,+BAA+B;AAC/B,eAAO,MAAM,eAAe;;;;;;;;;;;;;IAI1B,0BAA0B;;;;;;;;;;;;;IAI1B;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAG2B,CAAC;AAEjC,yCAAyC;AACzC,eAAO,MAAM,YAAY;;;;;;;;;IAGvB,kCAAkC;;;;;;;;;;;;;CAIJ,CAAC"}

package/dist/signaling/frames.sys.js

@@ -0,0 +1,53 @@
+/** sys 域：连接、鉴权、心跳、错误。见 RTC_PROTOCOL.md §1 与 §7。 */
+/** EMPTY_FIELDS 用于 data 恒为 {} 的帧：sys.ping / sys.pong / 各种纯 ack。 */
+export const EMPTY_FIELDS = {};
+/**
+ * HELLO_FIELDS：WS 打开后必须在 5 秒内发出的第一帧（§1.2）。
+ *
+ * token 走首帧而不是 URL 查询串：查询串会进网关日志、Referer 与浏览器历史。
+ */
+export const HELLO_FIELDS = {
+    protocolVersion: { kind: 'int', wire: 'protocol_version', default: 1 },
+    token: { kind: 'string', wire: 'token' },
+    deviceId: { kind: 'string', wire: 'device_id' },
+    /** 重连恢复用；首次连接为 ''。 */
+    sessionId: { kind: 'string', wire: 'session_id' },
+    /** 仅用于日志与灰度，**禁止参与逻辑**。 */
+    sdk: { kind: 'string', wire: 'sdk' },
+};
+/** LIMITS_FIELDS：服务端下发的限额，让客户端能本地预校验（§2.6）。 */
+export const LIMITS_FIELDS = {
+    maxFrameBytes: { kind: 'int', wire: 'max_frame_bytes' },
+    maxCallees: { kind: 'int', wire: 'max_callees' },
+    maxRoomParticipants: { kind: 'int', wire: 'max_room_participants' },
+    maxUserDataBytes: { kind: 'int', wire: 'max_user_data_bytes' },
+    ringTimeoutSecDefault: { kind: 'int', wire: 'ring_timeout_sec_default' },
+};
+/** HELLO_OK_FIELDS：鉴权成功的应答。 */
+export const HELLO_OK_FIELDS = {
+    uid: { kind: 'string', wire: 'uid' },
+    deviceId: { kind: 'string', wire: 'device_id' },
+    sessionId: { kind: 'string', wire: 'session_id' },
+    /** 供客户端算时钟偏移，**只做展示**。 */
+    serverTimeMs: { kind: 'int', wire: 'server_time_ms' },
+    resumed: { kind: 'bool', wire: 'resumed' },
+    pingIntervalSec: { kind: 'int', wire: 'ping_interval_sec' },
+    /**
+     * 本次握手用的那张票的到期时刻（Unix 毫秒）。**0 = 未知**。
+     *
+     * 客户端据此在到期前主动换票，而不是等下一次重连撞上 4401 再被动补救。
+     * **禁止自己解析 token 取 exp**——票对客户端是 opaque 的，可能根本不是 JWT。
+     */
+    tokenExpiresAtMs: { kind: 'int', wire: 'token_expires_at_ms' },
+    limits: { kind: 'object', wire: 'limits', fields: LIMITS_FIELDS },
+};
+/** ERROR_FIELDS：sys.error 的 data（§7）。 */
+export const ERROR_FIELDS = {
+    code: { kind: 'int', wire: 'code' },
+    name: { kind: 'string', wire: 'name' },
+    /** 英文固定短语，给开发者看；**禁止直接显示给用户**。 */
+    msg: { kind: 'string', wire: 'msg' },
+    forType: { kind: 'string', wire: 'for_type' },
+    retryable: { kind: 'bool', wire: 'retryable' },
+};
+//# sourceMappingURL=frames.sys.js.map

package/dist/signaling/frames.sys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.sys.js","sourceRoot":"","sources":["../../src/signaling/frames.sys.ts"],"names":[],"mappings":"AAEA,mDAAmD;AAEnD,mEAAmE;AACnE,MAAM,CAAC,MAAM,YAAY,GAAG,EAAiC,CAAC;AAE9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,eAAe,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,EAAE;IACtE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE;IACxC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE;IAC/C,sBAAsB;IACtB,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE;IACjD,2BAA2B;IAC3B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE;CACN,CAAC;AAEjC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE;IACvD,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE;IAChD,mBAAmB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,uBAAuB,EAAE;IACnE,gBAAgB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC9D,qBAAqB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,0BAA0B,EAAE;CAC1C,CAAC;AAEjC,+BAA+B;AAC/B,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE;IACpC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE;IAC/C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE;IACjD,0BAA0B;IAC1B,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE;IACrD,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;IAC1C,eAAe,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE;IAC3D;;;;;OAKG;IACH,gBAAgB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC9D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE;CACnC,CAAC;AAEjC,yCAAyC;AACzC,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE;IACnC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE;IACtC,kCAAkC;IAClC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE;IACpC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE;IAC7C,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE;CAChB,CAAC"}

package/dist/signaling/handshakeGiveUp.d.ts

@@ -0,0 +1,36 @@
+import type { KickedOutReason } from './connectionTypes.js';
+/**
+ * 握手失败该不该一次就放弃，放弃的话按哪种原因抛给宿主。返回 `null` = 照常退避重连。
+ *
+ * **不可重试 ≠ 参数不对**，三类的处置完全不同，合成一类等于给宿主一条错的建议：
+ *
+ * | 码 | 抛什么 | 宿主该做什么 |
+ * |---|---|---|
+ * | 1101 `token_invalid` | `authExpired` | **换一枚票再来**。签名密钥轮换、票被吊销都长这样，而换票正好救得了 |
+ * | 1104 `kicked_out` | `takenOver` | 回登录页。服务端的吊销名单走的就是「`sys.error{1104}` + 4403」这一对 |
+ * | 1004 / 1006 / 1106 … | `configRejected` | 去改配置。换票和重试都救不了——`device_id` 里那个空格不会因为再来一次就没了 |
+ *
+ * 判据仍然是错误码表里的 `retryable`，不在这里另立一张名单——那张表是四端共用的
+ * 一致性向量的一部分（`error_codes.json`），另立名单等于给它开了个后门。
+ *
+ * # 两条边界
+ *
+ * 1. **local 组的码不是服务端的裁决。** `Connection.close()` 会拿 `2005 invalid_state`
+ *    （它 `retryable === false`）把在飞的握手结掉，那是宿主自己按的 logout。
+ *    不挡掉的话一次正常的 logout 会报成「服务端拒了你的参数」——而静默续期正是
+ *    先 logout 再换票，会当场变成把人踹回登录页。
+ *    超时（2004）与断线（2003）也在 local 组，照常走重连。
+ * 2. **本端不认识的码信帧上自带的 `retryable`**（见 `RtcError.unknownCodeRetryable`），
+ *    不能拿折算后的 1501 当真——那样服务端新加的终局码会退化成无限重连。
+ *
+ * # 为什么不像 4401 那样给三次机会
+ *
+ * 4401 给三次是因为「票刚好过期」换一枚新票就能好，而重连时宿主可能已经
+ * `updateToken` 了。这里不一样：**`device_id` 里有个空格这件事，重连一万次
+ * 它还是有空格**。给三次机会只是把同一条错误在日志里刷三遍，把真正的原因埋掉。
+ *
+ * 独立成一个纯函数（而不是留在 `Connection` 里）有两个好处：这条判据能被直接钉住，
+ * 不必每次都摆一套假服务端；`connection.ts` 也不用为它继续长胖。
+ */
+export declare function handshakeGiveUpReason(err: unknown): KickedOutReason | null;
+//# sourceMappingURL=handshakeGiveUp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handshakeGiveUp.d.ts","sourceRoot":"","sources":["../../src/signaling/handshakeGiveUp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAQ1E"}

package/dist/signaling/handshakeGiveUp.js

@@ -0,0 +1,48 @@
+import { ErrorCode, isLocalError, isRtcError } from '../errors.js';
+/**
+ * 握手失败该不该一次就放弃，放弃的话按哪种原因抛给宿主。返回 `null` = 照常退避重连。
+ *
+ * **不可重试 ≠ 参数不对**，三类的处置完全不同，合成一类等于给宿主一条错的建议：
+ *
+ * | 码 | 抛什么 | 宿主该做什么 |
+ * |---|---|---|
+ * | 1101 `token_invalid` | `authExpired` | **换一枚票再来**。签名密钥轮换、票被吊销都长这样，而换票正好救得了 |
+ * | 1104 `kicked_out` | `takenOver` | 回登录页。服务端的吊销名单走的就是「`sys.error{1104}` + 4403」这一对 |
+ * | 1004 / 1006 / 1106 … | `configRejected` | 去改配置。换票和重试都救不了——`device_id` 里那个空格不会因为再来一次就没了 |
+ *
+ * 判据仍然是错误码表里的 `retryable`，不在这里另立一张名单——那张表是四端共用的
+ * 一致性向量的一部分（`error_codes.json`），另立名单等于给它开了个后门。
+ *
+ * # 两条边界
+ *
+ * 1. **local 组的码不是服务端的裁决。** `Connection.close()` 会拿 `2005 invalid_state`
+ *    （它 `retryable === false`）把在飞的握手结掉，那是宿主自己按的 logout。
+ *    不挡掉的话一次正常的 logout 会报成「服务端拒了你的参数」——而静默续期正是
+ *    先 logout 再换票，会当场变成把人踹回登录页。
+ *    超时（2004）与断线（2003）也在 local 组，照常走重连。
+ * 2. **本端不认识的码信帧上自带的 `retryable`**（见 `RtcError.unknownCodeRetryable`），
+ *    不能拿折算后的 1501 当真——那样服务端新加的终局码会退化成无限重连。
+ *
+ * # 为什么不像 4401 那样给三次机会
+ *
+ * 4401 给三次是因为「票刚好过期」换一枚新票就能好，而重连时宿主可能已经
+ * `updateToken` 了。这里不一样：**`device_id` 里有个空格这件事，重连一万次
+ * 它还是有空格**。给三次机会只是把同一条错误在日志里刷三遍，把真正的原因埋掉。
+ *
+ * 独立成一个纯函数（而不是留在 `Connection` 里）有两个好处：这条判据能被直接钉住，
+ * 不必每次都摆一套假服务端；`connection.ts` 也不用为它继续长胖。
+ */
+export function handshakeGiveUpReason(err) {
+    if (!isRtcError(err) || isLocalError(err.code))
+        return null;
+    // 未知码优先信帧上那一位；连帧上都没有就当可重试，维持「不认识就先退避着」的老行为。
+    const retryable = err.unknownCodeRetryable ?? err.retryable;
+    if (retryable)
+        return null;
+    if (err.code === ErrorCode.tokenInvalid)
+        return 'authExpired';
+    if (err.code === ErrorCode.kickedOut)
+        return 'takenOver';
+    return 'configRejected';
+}
+//# sourceMappingURL=handshakeGiveUp.js.map

package/dist/signaling/handshakeGiveUp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshakeGiveUp.js","sourceRoot":"","sources":["../../src/signaling/handshakeGiveUp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5D,4CAA4C;IAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,oBAAoB,IAAI,GAAG,CAAC,SAAS,CAAC;IAC5D,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,YAAY;QAAE,OAAO,aAAa,CAAC;IAC9D,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,SAAS;QAAE,OAAO,WAAW,CAAC;IACzD,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/signaling/heartbeat.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 心跳（RTC_PROTOCOL.md §1.3）。
+ *
+ * **判活条件是「收到对端任何一帧」，不是「pong 回来了」**——服务端发的任何帧
+ * 都证明它还活着。所以 `noteFrameReceived()` 由读循环无差别调用。
+ *
+ * 从 Connection 里拆出来是为了体量红线（CONVENTIONS §2），
+ * 顺带让「连续 3 个周期没动静就判死」这条规则有了独立的测试面。
+ */
+/** MISS_LIMIT 是判死前允许连续静默的周期数（§1.3：3 个周期 = 45 秒）。 */
+export declare const MISS_LIMIT = 3;
+/** HeartbeatCallbacks 是心跳的两个出口。 */
+export interface HeartbeatCallbacks {
+    /** 该发一个 sys.ping 了。 */
+    sendPing: () => void;
+    /** 连续静默超限，连接该判死了。 */
+    onDead: () => void;
+}
+/** Heartbeat 管理 ping 定时器与静默计数。 */
+export declare class Heartbeat {
+    private readonly callbacks;
+    private timer;
+    private missed;
+    constructor(callbacks: HeartbeatCallbacks);
+    /** start 按服务端下发的间隔起心跳。重复调用会先停掉旧的。 */
+    start(intervalSec: number): void;
+    /** noteFrameReceived 由读循环无差别调用：收到任何帧都算对端活着。 */
+    noteFrameReceived(): void;
+    /** stop 停掉心跳。幂等。 */
+    stop(): void;
+    /** missedBeats 供测试与诊断观察。 */
+    get missedBeats(): number;
+}
+//# sourceMappingURL=heartbeat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/signaling/heartbeat.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,oDAAoD;AACpD,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,qBAAqB;IACrB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,kCAAkC;AAClC,qBAAa,SAAS;IAIR,OAAO,CAAC,QAAQ,CAAC,SAAS;IAHtC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,MAAM,CAAK;gBAEU,SAAS,EAAE,kBAAkB;IAE1D,qCAAqC;IACrC,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAgBhC,+CAA+C;IAC/C,iBAAiB,IAAI,IAAI;IAIzB,oBAAoB;IACpB,IAAI,IAAI,IAAI;IAOZ,4BAA4B;IAC5B,IAAI,WAAW,IAAI,MAAM,CAExB;CACF"}

package/dist/signaling/heartbeat.js

@@ -0,0 +1,52 @@
+import { logger } from '../logger.js';
+/**
+ * 心跳（RTC_PROTOCOL.md §1.3）。
+ *
+ * **判活条件是「收到对端任何一帧」，不是「pong 回来了」**——服务端发的任何帧
+ * 都证明它还活着。所以 `noteFrameReceived()` 由读循环无差别调用。
+ *
+ * 从 Connection 里拆出来是为了体量红线（CONVENTIONS §2），
+ * 顺带让「连续 3 个周期没动静就判死」这条规则有了独立的测试面。
+ */
+/** MISS_LIMIT 是判死前允许连续静默的周期数（§1.3：3 个周期 = 45 秒）。 */
+export const MISS_LIMIT = 3;
+/** Heartbeat 管理 ping 定时器与静默计数。 */
+export class Heartbeat {
+    callbacks;
+    timer = null;
+    missed = 0;
+    constructor(callbacks) {
+        this.callbacks = callbacks;
+    }
+    /** start 按服务端下发的间隔起心跳。重复调用会先停掉旧的。 */
+    start(intervalSec) {
+        this.stop();
+        this.missed = 0;
+        const intervalMs = Math.max(1, intervalSec) * 1000;
+        this.timer = setInterval(() => {
+            this.missed += 1;
+            if (this.missed > MISS_LIMIT) {
+                logger.warn('心跳超时，判定连接已死', { missed: this.missed });
+                this.callbacks.onDead();
+                return;
+            }
+            this.callbacks.sendPing();
+        }, intervalMs);
+    }
+    /** noteFrameReceived 由读循环无差别调用：收到任何帧都算对端活着。 */
+    noteFrameReceived() {
+        this.missed = 0;
+    }
+    /** stop 停掉心跳。幂等。 */
+    stop() {
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /** missedBeats 供测试与诊断观察。 */
+    get missedBeats() {
+        return this.missed;
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/signaling/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/signaling/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;GAQG;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAU5B,kCAAkC;AAClC,MAAM,OAAO,SAAS;IAIS;IAHrB,KAAK,GAA0C,IAAI,CAAC;IACpD,MAAM,GAAG,CAAC,CAAC;IAEnB,YAA6B,SAA6B;QAA7B,cAAS,GAAT,SAAS,CAAoB;IAAG,CAAC;IAE9D,qCAAqC;IACrC,KAAK,CAAC,WAAmB;QACvB,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;QAEnD,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACjB,IAAI,IAAI,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBACpD,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;gBACxB,OAAO;YACT,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,EAAE,UAAU,CAAC,CAAC;IACjB,CAAC;IAED,+CAA+C;IAC/C,iBAAiB;QACf,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,oBAAoB;IACpB,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/signaling/pendingRequests.d.ts

@@ -0,0 +1,33 @@
+import { RtcError } from '../errors.js';
+import type { Envelope } from './envelope.js';
+/**
+ * 在途请求表：**按 `req_id` 配对，不按帧类型**。
+ *
+ * pub 侧的 `room.offer` 是由 **`room.answer`** 应答的（协议 §3.3 固定 offerer），
+ * 只看类型对不上号；按 req_id 配对还顺带解决了「多个同类请求在途」的问题。
+ */
+/** RequestResult 是一次请求的应答。 */
+export interface RequestResult {
+    readonly envelope: Envelope;
+    readonly data: Record<string, unknown>;
+}
+/** PendingRequests 管理在途请求与它们的超时。 */
+export declare class PendingRequests {
+    private readonly timeoutMs;
+    private readonly waiters;
+    constructor(timeoutMs: number);
+    /** track 登记一个在途请求，返回它的 Promise。 */
+    track(reqId: string, type: string): Promise<RequestResult>;
+    /** abandon 撤掉一个还没发出去就失败的请求。 */
+    abandon(reqId: string): void;
+    /**
+     * settle 用一帧应答结算在途请求。
+     * 返回 false 表示这个 req_id 没人在等——调用方应当把它当事件处理。
+     */
+    settle(envelope: Envelope, decode: (env: Envelope) => Record<string, unknown>): boolean;
+    /** rejectAll 在断线时把全部在途请求失败掉——它们的应答永远不会来了。 */
+    rejectAll(error: RtcError): void;
+    /** size 供测试与诊断观察。 */
+    get size(): number;
+}
+//# sourceMappingURL=pendingRequests.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pendingRequests.d.ts","sourceRoot":"","sources":["../../src/signaling/pendingRequests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,QAAQ,EAAoB,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;GAKG;AAEH,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AASD,oCAAoC;AACpC,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAExB,SAAS,EAAE,MAAM;IAE9C,mCAAmC;IACnC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAU1D,+BAA+B;IAC/B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO5B;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAcvF,6CAA6C;IAC7C,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAQhC,qBAAqB;IACrB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}