im-rtc-call-engine 1.0.0

package/dist/signaling/frameSender.js

@@ -0,0 +1,57 @@
+import { toFrameProps } from './caseMapping.js';
+import { lookupFrame } from './registry.js';
+/**
+ * FrameSender 把状态机产出的**意图**变成线路上的一帧。
+ *
+ * # 为什么这一层要单独存在
+ *
+ * 状态机是纯函数，产不出 SDP——它给的协商帧 `sdp` 字段是空的。
+ * 「取真值填进去」这件事既要碰媒体层又要碰连接，放在状态机里会毁掉它的可测性，
+ * 放在门面里则让门面同时管路由、填 SDP 和事件三件事。所以单独一层：
+ * **门面只管把帧交给它，它只管把帧变成真的**。
+ */
+export class FrameSender {
+    media;
+    /** 服务端最近一次下发的 sub offer，答复时要用。 */
+    lastSubOfferSdp = '';
+    constructor(media) {
+        this.media = media;
+    }
+    /** noteSubOffer 记下服务端下发的 sub offer。**答复它时才有得可答**。 */
+    noteSubOffer(sdp) {
+        this.lastSubOfferSdp = sdp;
+    }
+    /**
+     * send 发一帧并返回应答（`{type, data}`）。
+     *
+     * 返回应答而不是直接消化掉：**`.ok` 也要喂回状态机**——join.ok / publish.ok
+     * 都是状态推进的关键一步，漏掉那一半会让房间永远停在 `joining`。
+     */
+    async send(connection, type, data) {
+        const fields = lookupFrame(type);
+        if (fields === undefined)
+            return null;
+        const filled = { ...data };
+        if (type === 'room.offer' && filled['pc'] === 'pub') {
+            filled['sdp'] = await this.media.createPubOffer();
+        }
+        else if (type === 'room.answer' && filled['pc'] === 'sub') {
+            filled['sdp'] = await this.media.answerSubOffer(this.lastSubOfferSdp);
+        }
+        const reply = await connection.request(type, fields, toFrameProps(fields, filled));
+        return { type: reply.envelope.type, data: reply.data };
+    }
+    /** sendCandidate 发一个本端候选。候选是尽力而为的，失败由调用方转成 error 事件。 */
+    async sendCandidate(connection, pc, candidate) {
+        const fields = lookupFrame('room.ice_candidate');
+        if (fields === undefined)
+            return;
+        await connection.request('room.ice_candidate', fields, {
+            pc,
+            candidate: candidate.candidate ?? '',
+            sdpMid: candidate.sdpMid ?? '',
+            sdpMLineIndex: candidate.sdpMLineIndex ?? 0,
+        });
+    }
+}
+//# sourceMappingURL=frameSender.js.map

package/dist/signaling/frameSender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameSender.js","sourceRoot":"","sources":["../../src/signaling/frameSender.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,OAAO,WAAW;IACL,KAAK,CAAe;IACrC,kCAAkC;IAC1B,eAAe,GAAG,EAAE,CAAC;IAE7B,YAAY,KAAmB;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,qDAAqD;IACrD,YAAY,CAAC,GAAW;QACtB,IAAI,CAAC,eAAe,GAAG,GAAG,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CACR,UAAsB,EACtB,IAAY,EACZ,IAAuC;QAEvC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAEtC,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;QACpD,IAAI,IAAI,KAAK,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YACpD,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QACpD,CAAC;aAAM,IAAI,IAAI,KAAK,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YAC5D,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACnF,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACzD,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,aAAa,CACjB,UAAsB,EACtB,EAAU,EACV,SAA8B;QAE9B,MAAM,MAAM,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;QACjD,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QACjC,MAAM,UAAU,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE;YACrD,EAAE;YACF,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,EAAE;YACpC,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,EAAE;YAC9B,aAAa,EAAE,SAAS,CAAC,aAAa,IAAI,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,299 @@
+/**
+ * call 域：振铃流程。见 RTC_PROTOCOL.md §4。
+ * Call 层**不碰媒体**——接通后一切走 room 帧。所以这里没有一个 SDP 字段。
+ */
+/**
+ * INVITE_FIELDS：发起通话。
+ *
+ * user_data 是 opaque **字符串**不是对象——宿主要塞任意结构自己序列化。
+ * 这条是为了 C++ 端不必处理任意嵌套（§2.4 规则 5）。服务端原样透传，不解析。
+ */
+export declare const INVITE_FIELDS: {
+    /** 1v1 恰好 1 个；群 ≤8（房内含主叫共 9 人）。 */
+    readonly calleeIds: {
+        readonly kind: "stringArray";
+        readonly wire: "callee_ids";
+    };
+    readonly mediaType: {
+        readonly kind: "enum";
+        readonly wire: "media_type";
+        readonly values: readonly ["audio", "video"];
+        readonly fallback: "audio";
+    };
+    readonly isGroup: {
+        readonly kind: "bool";
+        readonly wire: "is_group";
+    };
+    /** '' = 服务端建房。 */
+    readonly roomId: {
+        readonly kind: "string";
+        readonly wire: "room_id";
+    };
+    readonly timeoutSec: {
+        readonly kind: "int";
+        readonly wire: "timeout_sec";
+        readonly default: 30;
+        readonly min: 5;
+        readonly max: 120;
+    };
+    readonly userData: {
+        readonly kind: "string";
+        readonly wire: "user_data";
+    };
+    /**
+     * 宿主自己的群号，opaque，≤64 字节，禁止空白与换行（服务端校验，本端也在 engine.ts 拦一道）。
+     * 通话期间不可改；服务端不解析、不校验群成员关系，只原样带出去（§3.2）。
+     */
+    readonly chatGroupId: {
+        readonly kind: "string";
+        readonly wire: "chat_group_id";
+    };
+};
+/** INVITE_OK_FIELDS：**主叫此时禁止 room.join**——接听前不进 SFU（§4.1）。 */
+export declare const INVITE_OK_FIELDS: {
+    readonly callId: {
+        readonly kind: "string";
+        readonly wire: "call_id";
+    };
+    readonly roomId: {
+        readonly kind: "string";
+        readonly wire: "room_id";
+    };
+    readonly invitedAtMs: {
+        readonly kind: "int";
+        readonly wire: "invited_at_ms";
+    };
+};
+/**
+ * CALL_ID_FIELDS：只带 call_id 的上行帧共用
+ * （accept / reject / cancel / hangup / join）。
+ *
+ * 接通后主叫也用 hangup，**不用 cancel**——两个词不共用一条路径，
+ * 避免「取消一通已接通的电话」这种歧义。
+ */
+export declare const CALL_ID_FIELDS: {
+    readonly callId: {
+        readonly kind: "string";
+        readonly wire: "call_id";
+    };
+};
+/** INVITE_MORE_FIELDS：群通话中途加邀（P4）。通话里的任何人都能发。 */
+export declare const INVITE_MORE_FIELDS: {
+    readonly callId: {
+        readonly kind: "string";
+        readonly wire: "call_id";
+    };
+    readonly calleeIds: {
+        readonly kind: "stringArray";
+        readonly wire: "callee_ids";
+    };
+};
+/** INCOMING_FIELDS：被叫收到的邀请，对应 onCallReceived。 */
+export declare const INCOMING_FIELDS: {
+    readonly callId: {
+        readonly kind: "string";
+        readonly wire: "call_id";
+    };
+    readonly roomId: {
+        readonly kind: "string";
+        readonly wire: "room_id";
+    };
+    readonly caller: {
+        readonly kind: "string";
+        readonly wire: "caller";
+    };
+    readonly calleeIds: {
+        readonly kind: "stringArray";
+        readonly wire: "callee_ids";
+    };
+    readonly mediaType: {
+        readonly kind: "enum";
+        readonly wire: "media_type";
+        readonly values: readonly ["audio", "video"];
+        readonly fallback: "audio";
+    };
+    readonly isGroup: {
+        readonly kind: "bool";
+        readonly wire: "is_group";
+    };
+    readonly timeoutSec: {
+        readonly kind: "int";
+        readonly wire: "timeout_sec";
+        readonly default: 30;
+        readonly min: 5;
+        readonly max: 120;
+    };
+    readonly invitedAtMs: {
+        readonly kind: "int";
+        readonly wire: "invited_at_ms";
+    };
+    readonly userData: {
+        readonly kind: "string";
+        readonly wire: "user_data";
+    };
+    /** 群号，Kit 靠它决定「添加成员」列谁（§3.2）。 */
+    readonly chatGroupId: {
+        readonly kind: "string";
+        readonly wire: "chat_group_id";
+    };
+};
+/**
+ * RINGING_FIELDS：告诉主叫「对方设备开始响铃了」，每个被叫 uid 只发一次。
+ * UI 据此把「正在呼叫…」改成「等待对方接听…」。它**不对应任何回调**。
+ */
+export declare const RINGING_FIELDS: {
+    readonly callId: {
+        readonly kind: "string";
+        readonly wire: "call_id";
+    };
+    readonly uid: {
+        readonly kind: "string";
+        readonly wire: "uid";
+    };
+    readonly deviceCount: {
+        readonly kind: "int";
+        readonly wire: "device_count";
+    };
+};
+/**
+ * MEMBER_OUTCOME_FIELDS：某成员的裁决，四个帧共用
+ * （call.accepted / rejected / busy / no_answer）。
+ */
+export declare const MEMBER_OUTCOME_FIELDS: {
+    readonly callId: {
+        readonly kind: "string";
+        readonly wire: "call_id";
+    };
+    readonly uid: {
+        readonly kind: "string";
+        readonly wire: "uid";
+    };
+};
+/** CANCELLED_FIELDS：主叫取消，发给全部被叫设备。 */
+export declare const CANCELLED_FIELDS: {
+    readonly callId: {
+        readonly kind: "string";
+        readonly wire: "call_id";
+    };
+    readonly by: {
+        readonly kind: "string";
+        readonly wire: "by";
+    };
+};
+/**
+ * CONNECTED_FIELDS：「可以进房了」，对应 onCallBegin。
+ *
+ * call.accept.ok 是纯 ack，房间信息只在这一条帧里——一个东西一条路径。
+ */
+export declare const CONNECTED_FIELDS: {
+    readonly callId: {
+        readonly kind: "string";
+        readonly wire: "call_id";
+    };
+    readonly roomId: {
+        readonly kind: "string";
+        readonly wire: "room_id";
+    };
+    /** 绑定 (room_id, uid, device_id)，TTL 5 分钟、一次性。**不要整条打日志**。 */
+    readonly roomToken: {
+        readonly kind: "string";
+        readonly wire: "room_token";
+    };
+    readonly mediaType: {
+        readonly kind: "enum";
+        readonly wire: "media_type";
+        readonly values: readonly ["audio", "video"];
+        readonly fallback: "audio";
+    };
+    readonly isGroup: {
+        readonly kind: "bool";
+        readonly wire: "is_group";
+    };
+    /** 通话时长的起点，服务端时钟。 */
+    readonly connectedAtMs: {
+        readonly kind: "int";
+        readonly wire: "connected_at_ms";
+    };
+    readonly acceptedBy: {
+        readonly kind: "string";
+        readonly wire: "accepted_by";
+    };
+    /**
+     * 发起人。`call.join` 进来的人没收过 `call.incoming`，只能从这里知道是谁打的（§3.2）。
+     */
+    readonly caller: {
+        readonly kind: "string";
+        readonly wire: "caller";
+    };
+    /** 同 call.invite，中途加入与断线恢复后也拿得到群号。 */
+    readonly chatGroupId: {
+        readonly kind: "string";
+        readonly wire: "chat_group_id";
+    };
+    /** 同 call.invite，原样回显。 */
+    readonly userData: {
+        readonly kind: "string";
+        readonly wire: "user_data";
+    };
+};
+/** HANDLED_ELSEWHERE_FIELDS：本账号另一台设备处理了这通电话。 */
+export declare const HANDLED_ELSEWHERE_FIELDS: {
+    readonly callId: {
+        readonly kind: "string";
+        readonly wire: "call_id";
+    };
+    readonly action: {
+        readonly kind: "enum";
+        readonly wire: "action";
+        readonly values: readonly ["accept", "reject"];
+        readonly fallback: "accept";
+    };
+    readonly deviceId: {
+        readonly kind: "string";
+        readonly wire: "device_id";
+    };
+};
+/**
+ * ENDED_FIELDS：**唯一终态帧**。
+ *
+ * 铁律：每个成员设备收到且仅收到一条；所有结局都走它；
+ * 宿主只监听它也必须能完整记录一通电话。
+ */
+export declare const ENDED_FIELDS: {
+    readonly callId: {
+        readonly kind: "string";
+        readonly wire: "call_id";
+    };
+    readonly roomId: {
+        readonly kind: "string";
+        readonly wire: "room_id";
+    };
+    readonly reason: {
+        readonly kind: "enum";
+        readonly wire: "reason";
+        readonly values: readonly ["hangup", "cancel", "reject", "no_answer", "busy", "offline", "answered_elsewhere", "rejected_elsewhere", "kicked", "room_closed", "network", "error"];
+        readonly fallback: "error";
+    };
+    /** 未接通恒为 0。**四端禁止自己算时长**（时钟偏移），一律用这个值。 */
+    readonly durationSec: {
+        readonly kind: "int";
+        readonly wire: "duration_sec";
+    };
+    /** 动作发起人 uid；服务端自行判定时为 ''。 */
+    readonly endedBy: {
+        readonly kind: "string";
+        readonly wire: "ended_by";
+    };
+    /**
+     * 这通电话是谁打的。
+     *
+     * **忙线那条不振铃**，被叫拿到的第一帧也是最后一帧就是它——没有这个字段就说不出
+     * 「谁来过电话」（协议 §4.2）。字段没登记在这里的话解码器会把它丢掉，
+     * `onCallMissed` 拿到的 caller 就是空串。
+     */
+    readonly caller: {
+        readonly kind: "string";
+        readonly wire: "caller";
+    };
+};
+//# sourceMappingURL=frames.call.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frames.call.d.ts","sourceRoot":"","sources":["../../src/signaling/frames.call.ts"],"names":[],"mappings":"AAUA;;;GAGG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,aAAa;IACxB,mCAAmC;;;;;;;;;;;;;;;IAInC,kBAAkB;;;;;;;;;;;;;;;;IAUlB;;;OAGG;;;;;CAE2B,CAAC;AAEjC,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAIG,CAAC;AAEjC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;CAEK,CAAC;AAEjC,iDAAiD;AACjD,eAAO,MAAM,kBAAkB;;;;;;;;;CAGC,CAAC;AAEjC,iDAAiD;AACjD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgB1B,iCAAiC;;;;;CAEH,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;CAIK,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;CAGF,CAAC;AAEjC,sCAAsC;AACtC,eAAO,MAAM,gBAAgB;;;;;;;;;CAGG,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;IAG3B,6DAA6D;;;;;;;;;;;;;;;IAI7D,qBAAqB;;;;;;;;;IAGrB;;OAEG;;;;;IAEH,sCAAsC;;;;;IAEtC,0BAA0B;;;;;CAEI,CAAC;AAEjC,gDAAgD;AAChD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;CAIL,CAAC;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;IAIvB,0CAA0C;;;;;IAE1C,8BAA8B;;;;;IAE9B;;;;;;OAMG;;;;;CAE2B,CAAC"}

package/dist/signaling/frames.call.js

@@ -0,0 +1,149 @@
+import { DEFAULT_TIMEOUT_SEC, HANDLED_ACTIONS, MAX_TIMEOUT_SEC, MEDIA_TYPES, MIN_TIMEOUT_SEC, REASONS, } from './enums.js';
+/**
+ * call 域：振铃流程。见 RTC_PROTOCOL.md §4。
+ * Call 层**不碰媒体**——接通后一切走 room 帧。所以这里没有一个 SDP 字段。
+ */
+/**
+ * INVITE_FIELDS：发起通话。
+ *
+ * user_data 是 opaque **字符串**不是对象——宿主要塞任意结构自己序列化。
+ * 这条是为了 C++ 端不必处理任意嵌套（§2.4 规则 5）。服务端原样透传，不解析。
+ */
+export const INVITE_FIELDS = {
+    /** 1v1 恰好 1 个；群 ≤8（房内含主叫共 9 人）。 */
+    calleeIds: { kind: 'stringArray', wire: 'callee_ids' },
+    mediaType: { kind: 'enum', wire: 'media_type', values: MEDIA_TYPES, fallback: 'audio' },
+    isGroup: { kind: 'bool', wire: 'is_group' },
+    /** '' = 服务端建房。 */
+    roomId: { kind: 'string', wire: 'room_id' },
+    timeoutSec: {
+        kind: 'int',
+        wire: 'timeout_sec',
+        default: DEFAULT_TIMEOUT_SEC,
+        min: MIN_TIMEOUT_SEC,
+        max: MAX_TIMEOUT_SEC,
+    },
+    userData: { kind: 'string', wire: 'user_data' },
+    /**
+     * 宿主自己的群号，opaque，≤64 字节，禁止空白与换行（服务端校验，本端也在 engine.ts 拦一道）。
+     * 通话期间不可改；服务端不解析、不校验群成员关系，只原样带出去（§3.2）。
+     */
+    chatGroupId: { kind: 'string', wire: 'chat_group_id' },
+};
+/** INVITE_OK_FIELDS：**主叫此时禁止 room.join**——接听前不进 SFU（§4.1）。 */
+export const INVITE_OK_FIELDS = {
+    callId: { kind: 'string', wire: 'call_id' },
+    roomId: { kind: 'string', wire: 'room_id' },
+    invitedAtMs: { kind: 'int', wire: 'invited_at_ms' },
+};
+/**
+ * CALL_ID_FIELDS：只带 call_id 的上行帧共用
+ * （accept / reject / cancel / hangup / join）。
+ *
+ * 接通后主叫也用 hangup，**不用 cancel**——两个词不共用一条路径，
+ * 避免「取消一通已接通的电话」这种歧义。
+ */
+export const CALL_ID_FIELDS = {
+    callId: { kind: 'string', wire: 'call_id' },
+};
+/** INVITE_MORE_FIELDS：群通话中途加邀（P4）。通话里的任何人都能发。 */
+export const INVITE_MORE_FIELDS = {
+    callId: { kind: 'string', wire: 'call_id' },
+    calleeIds: { kind: 'stringArray', wire: 'callee_ids' },
+};
+/** INCOMING_FIELDS：被叫收到的邀请，对应 onCallReceived。 */
+export const INCOMING_FIELDS = {
+    callId: { kind: 'string', wire: 'call_id' },
+    roomId: { kind: 'string', wire: 'room_id' },
+    caller: { kind: 'string', wire: 'caller' },
+    calleeIds: { kind: 'stringArray', wire: 'callee_ids' },
+    mediaType: { kind: 'enum', wire: 'media_type', values: MEDIA_TYPES, fallback: 'audio' },
+    isGroup: { kind: 'bool', wire: 'is_group' },
+    timeoutSec: {
+        kind: 'int',
+        wire: 'timeout_sec',
+        default: DEFAULT_TIMEOUT_SEC,
+        min: MIN_TIMEOUT_SEC,
+        max: MAX_TIMEOUT_SEC,
+    },
+    invitedAtMs: { kind: 'int', wire: 'invited_at_ms' },
+    userData: { kind: 'string', wire: 'user_data' },
+    /** 群号，Kit 靠它决定「添加成员」列谁（§3.2）。 */
+    chatGroupId: { kind: 'string', wire: 'chat_group_id' },
+};
+/**
+ * RINGING_FIELDS：告诉主叫「对方设备开始响铃了」，每个被叫 uid 只发一次。
+ * UI 据此把「正在呼叫…」改成「等待对方接听…」。它**不对应任何回调**。
+ */
+export const RINGING_FIELDS = {
+    callId: { kind: 'string', wire: 'call_id' },
+    uid: { kind: 'string', wire: 'uid' },
+    deviceCount: { kind: 'int', wire: 'device_count' },
+};
+/**
+ * MEMBER_OUTCOME_FIELDS：某成员的裁决，四个帧共用
+ * （call.accepted / rejected / busy / no_answer）。
+ */
+export const MEMBER_OUTCOME_FIELDS = {
+    callId: { kind: 'string', wire: 'call_id' },
+    uid: { kind: 'string', wire: 'uid' },
+};
+/** CANCELLED_FIELDS：主叫取消，发给全部被叫设备。 */
+export const CANCELLED_FIELDS = {
+    callId: { kind: 'string', wire: 'call_id' },
+    by: { kind: 'string', wire: 'by' },
+};
+/**
+ * CONNECTED_FIELDS：「可以进房了」，对应 onCallBegin。
+ *
+ * call.accept.ok 是纯 ack，房间信息只在这一条帧里——一个东西一条路径。
+ */
+export const CONNECTED_FIELDS = {
+    callId: { kind: 'string', wire: 'call_id' },
+    roomId: { kind: 'string', wire: 'room_id' },
+    /** 绑定 (room_id, uid, device_id)，TTL 5 分钟、一次性。**不要整条打日志**。 */
+    roomToken: { kind: 'string', wire: 'room_token' },
+    mediaType: { kind: 'enum', wire: 'media_type', values: MEDIA_TYPES, fallback: 'audio' },
+    isGroup: { kind: 'bool', wire: 'is_group' },
+    /** 通话时长的起点，服务端时钟。 */
+    connectedAtMs: { kind: 'int', wire: 'connected_at_ms' },
+    acceptedBy: { kind: 'string', wire: 'accepted_by' },
+    /**
+     * 发起人。`call.join` 进来的人没收过 `call.incoming`，只能从这里知道是谁打的（§3.2）。
+     */
+    caller: { kind: 'string', wire: 'caller' },
+    /** 同 call.invite，中途加入与断线恢复后也拿得到群号。 */
+    chatGroupId: { kind: 'string', wire: 'chat_group_id' },
+    /** 同 call.invite，原样回显。 */
+    userData: { kind: 'string', wire: 'user_data' },
+};
+/** HANDLED_ELSEWHERE_FIELDS：本账号另一台设备处理了这通电话。 */
+export const HANDLED_ELSEWHERE_FIELDS = {
+    callId: { kind: 'string', wire: 'call_id' },
+    action: { kind: 'enum', wire: 'action', values: HANDLED_ACTIONS, fallback: 'accept' },
+    deviceId: { kind: 'string', wire: 'device_id' },
+};
+/**
+ * ENDED_FIELDS：**唯一终态帧**。
+ *
+ * 铁律：每个成员设备收到且仅收到一条；所有结局都走它；
+ * 宿主只监听它也必须能完整记录一通电话。
+ */
+export const ENDED_FIELDS = {
+    callId: { kind: 'string', wire: 'call_id' },
+    roomId: { kind: 'string', wire: 'room_id' },
+    reason: { kind: 'enum', wire: 'reason', values: REASONS, fallback: 'error' },
+    /** 未接通恒为 0。**四端禁止自己算时长**（时钟偏移），一律用这个值。 */
+    durationSec: { kind: 'int', wire: 'duration_sec' },
+    /** 动作发起人 uid；服务端自行判定时为 ''。 */
+    endedBy: { kind: 'string', wire: 'ended_by' },
+    /**
+     * 这通电话是谁打的。
+     *
+     * **忙线那条不振铃**，被叫拿到的第一帧也是最后一帧就是它——没有这个字段就说不出
+     * 「谁来过电话」（协议 §4.2）。字段没登记在这里的话解码器会把它丢掉，
+     * `onCallMissed` 拿到的 caller 就是空串。
+     */
+    caller: { kind: 'string', wire: 'caller' },
+};
+//# sourceMappingURL=frames.call.js.map

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

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