im-rtc-call-engine 1.0.0

package/dist/state/roomRecv.js

@@ -0,0 +1,209 @@
+import { FrameType } from '../signaling/registry.js';
+import { clearedRoom, replayBuffered, roomOut } from './roomMachine.js';
+import { bool, str } from './types.js';
+/**
+ * 房间状态机的**下行帧**分支。
+ *
+ * 与 roomMachine.ts 拆开是体量红线（CONVENTIONS §2）；「上行动作」与「下行帧」
+ * 本来也是两组独立的关注点。
+ */
+const ROOM_JOIN_OK = `${FrameType.roomJoin}.ok`;
+const ROOM_LEAVE_OK = `${FrameType.roomLeave}.ok`;
+const ROOM_PUBLISH_OK = `${FrameType.roomPublish}.ok`;
+const ROOM_UNPUBLISH_OK = `${FrameType.roomUnpublish}.ok`;
+const ROOM_UNSUBSCRIBE_OK = `${FrameType.roomUnsubscribe}.ok`;
+/** reduceRoomRecv 处理一条下行房间帧。 */
+export function reduceRoomRecv(ctx, type, data) {
+    if (ctx.state === 'idle')
+        return handleLateFrame(ctx, type, data);
+    switch (type) {
+        case ROOM_JOIN_OK:
+            return handleJoinOk(ctx, data);
+        case ROOM_LEAVE_OK:
+            return roomOut(clearedRoom('idle'), [], [
+                { cb: 'onRoomLeft', args: { room_id: ctx.roomId } },
+            ]);
+        case ROOM_PUBLISH_OK:
+            return handlePublishOk(ctx, data);
+        case FrameType.roomAnswer:
+            // 服务端对 pub offer 的应答：本端那条上行协商完成了。
+            return roomOut({ ...ctx, publish: promoteAll(ctx.publish, 'publishing', 'published') });
+        case FrameType.roomOffer:
+            return handleSubOffer(ctx, data);
+        case ROOM_UNPUBLISH_OK:
+            return roomOut({ ...ctx, publish: dropByState(ctx.publish, 'unpublishing') });
+        case ROOM_UNSUBSCRIBE_OK:
+            return roomOut({ ...ctx, subscribe: dropByState(ctx.subscribe, 'unsubscribing') });
+        case FrameType.roomParticipantJoined:
+            return roomOut(ctx, [], [{ cb: 'onUserEnter', args: { uid: str(data, 'uid') } }]);
+        case FrameType.roomParticipantLeft:
+            return handleParticipantLeft(ctx, data);
+        case FrameType.roomTrackPublished:
+            return handleTrackPublished(ctx, data);
+        case FrameType.roomTrackUnpublished:
+            return handleTrackUnpublished(ctx, data);
+        case FrameType.roomTrackMuted:
+            return handleTrackMuted(ctx, data);
+        case FrameType.roomActiveSpeakers:
+            return roomOut(ctx, [], [{ cb: 'onActiveSpeakers', args: { speakers: data['speakers'] } }]);
+        case FrameType.roomQuality:
+            return roomOut(ctx, [], [{ cb: 'onNetworkQuality', args: { entries: data['entries'] } }]);
+        case FrameType.roomClosed:
+            return roomOut(clearedRoom('idle'), [], [
+                {
+                    cb: 'onRoomClosed',
+                    args: { room_id: str(data, 'room_id'), reason: str(data, 'reason') },
+                },
+            ]);
+        default:
+            // 其余的 .ok（subscribe / update_layer / mute）不改状态也不抛回调。
+            return roomOut(ctx);
+    }
+}
+/**
+ * handleLateFrame：**idle 下迟到的房间帧一律丢弃**，与通话机的第 2 条规则同一个道理——
+ * 本地已经不在房里，这些帧说的是一个本端不再关心的房间。
+ *
+ * 唯一例外是 `room.join.ok`：它说明**服务端已经把我们放进房了**，而本地早就收场了
+ * （强制收场时还卡在路上的那条 join，或 join 超时回滚之后才回来的应答）。
+ * 认领它会把一个没人要的房间捡回来；不理它，服务端就一直挂着这个人——服务端只验房票、
+ * 不查通话成员。所以补发一条 `room.leave`，本地状态不动。那条 leave 的 `.ok` 回来时
+ * 同样落在这里被丢掉，不会多抛一次 onRoomLeft。与 iOS `IMRoomMachine.handleLateFrame` 同形。
+ */
+function handleLateFrame(ctx, type, data) {
+    const roomId = str(data, 'room_id');
+    if (type !== ROOM_JOIN_OK || roomId === '')
+        return roomOut(ctx);
+    return roomOut(ctx, [{ type: FrameType.roomLeave, data: { room_id: roomId } }]);
+}
+/** handleJoinOk 用快照把房间一次性搭起来：先成员，再他们的 Track。 */
+function handleJoinOk(ctx, data) {
+    const emit = [{ cb: 'onRoomJoined', args: { room_id: str(data, 'room_id') } }];
+    const remoteTracks = { ...ctx.remoteTracks };
+    const subscribe = { ...ctx.subscribe };
+    for (const participant of asArray(data['participants'])) {
+        emit.push({ cb: 'onUserEnter', args: { uid: str(participant, 'uid') } });
+    }
+    for (const track of asArray(data['tracks'])) {
+        const trackId = str(track, 'track_id');
+        const kind = str(track, 'kind') === 'video' ? 'video' : 'audio';
+        remoteTracks[trackId] = {
+            uid: str(track, 'uid'),
+            kind,
+            participantId: str(track, 'participant_id'),
+        };
+        emit.push(availabilityEvent(kind, str(track, 'uid'), !bool(track, 'muted')));
+        // 自动订阅是**服务端**做的，客户端这边只记账，等 sub offer 来把它们坐实。
+        if (ctx.autoSubscribe)
+            subscribe[trackId] = 'subscribing';
+    }
+    // 进房成功之后**立刻重放 joining 期间攒下的意图**（不变量 R2）：
+    // 宿主在 onCallBegin 里就发起的 publish 走的正是这条路。
+    const replayed = replayBuffered({
+        ...ctx,
+        state: 'joined',
+        // **这一笔账只在这里记**：它是「服务端真的受理了我们」的唯一证据，
+        // resumeRoom 靠它分辨 reconnecting 的两种来路。
+        didJoin: true,
+        roomId: str(data, 'room_id'),
+        participantId: str(data, 'participant_id'),
+        remoteTracks,
+        subscribe,
+    });
+    return roomOut(replayed.state, [...replayed.send], [...emit, ...replayed.emit]);
+}
+function handlePublishOk(ctx, data) {
+    const cid = str(data, 'cid');
+    const trackId = str(data, 'track_id');
+    // 拿到 track_id 之后才发 pub offer：服务端要靠 msid 里的 cid 认领 m-line（§3.2）。
+    return roomOut({ ...ctx, publishTrackIds: { ...ctx.publishTrackIds, [cid]: trackId } }, [{ type: FrameType.roomOffer, data: { pc: 'pub', sdp: '' } }]);
+}
+/**
+ * handleSubOffer：**sub PC 的 offerer 恒为服务端**（§3.3），我们只负责应答。
+ * 应答的同时把「订阅中」坐实为「已订阅」——那条流这时才真的挂上来。
+ */
+function handleSubOffer(ctx, data) {
+    if (str(data, 'pc') !== 'sub')
+        return roomOut(ctx);
+    const send = [{ type: FrameType.roomAnswer, data: { pc: 'sub', sdp: '' } }];
+    return roomOut({ ...ctx, subscribe: promoteAll(ctx.subscribe, 'subscribing', 'subscribed') }, send);
+}
+function handleParticipantLeft(ctx, data) {
+    const participantId = str(data, 'participant_id');
+    const remoteTracks = {};
+    const subscribe = { ...ctx.subscribe };
+    for (const [trackId, track] of Object.entries(ctx.remoteTracks)) {
+        if (track.participantId === participantId) {
+            // 人走了，他的 Track 与我们对它的订阅一起清掉——不清的话重连时会重放一个死订阅。
+            delete subscribe[trackId];
+            continue;
+        }
+        remoteTracks[trackId] = track;
+    }
+    return roomOut({ ...ctx, remoteTracks, subscribe }, [], [
+        { cb: 'onUserLeave', args: { uid: str(data, 'uid') } },
+    ]);
+}
+function handleTrackPublished(ctx, data) {
+    const trackId = str(data, 'track_id');
+    const kind = str(data, 'kind') === 'video' ? 'video' : 'audio';
+    const uid = str(data, 'uid');
+    const subscribe = { ...ctx.subscribe };
+    if (ctx.autoSubscribe)
+        subscribe[trackId] = 'subscribing';
+    return roomOut({
+        ...ctx,
+        remoteTracks: {
+            ...ctx.remoteTracks,
+            [trackId]: { uid, kind, participantId: str(data, 'participant_id') },
+        },
+        subscribe,
+    }, [], [availabilityEvent(kind, uid, !bool(data, 'muted'))]);
+}
+/** handleTrackUnpublished：帧里**不带 kind**，只能靠本地记账知道该抛音频还是视频事件。 */
+function handleTrackUnpublished(ctx, data) {
+    const trackId = str(data, 'track_id');
+    const known = ctx.remoteTracks[trackId];
+    const remoteTracks = { ...ctx.remoteTracks };
+    const subscribe = { ...ctx.subscribe };
+    delete remoteTracks[trackId];
+    delete subscribe[trackId];
+    const emit = known === undefined ? [] : [availabilityEvent(known.kind, known.uid, false)];
+    return roomOut({ ...ctx, remoteTracks, subscribe }, [], emit);
+}
+function handleTrackMuted(ctx, data) {
+    const kind = str(data, 'kind') === 'video' ? 'video' : 'audio';
+    return roomOut(ctx, [], [availabilityEvent(kind, str(data, 'uid'), !bool(data, 'muted'))]);
+}
+/** availabilityEvent 把「Track 有没有」翻译成 §7.5 的两个回调之一。 */
+function availabilityEvent(kind, uid, available) {
+    return {
+        cb: kind === 'video' ? 'onUserVideoAvailable' : 'onUserAudioAvailable',
+        args: { uid, available },
+    };
+}
+function promoteAll(map, from, to) {
+    const out = {};
+    for (const [key, value] of Object.entries(map)) {
+        out[key] = value === from ? to : value;
+    }
+    return out;
+}
+function dropByState(map, target) {
+    const out = {};
+    for (const [key, value] of Object.entries(map)) {
+        if (value !== target)
+            out[key] = value;
+    }
+    return out;
+}
+function asArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => item !== null && typeof item === 'object' && !Array.isArray(item));
+}
+/** publishStateOf 供测试与诊断读取某个 cid 的发布状态。 */
+export function publishStateOf(ctx, cid) {
+    return ctx.publish[cid];
+}
+//# sourceMappingURL=roomRecv.js.map

package/dist/state/roomRecv.js.map

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

package/dist/state/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 状态机的公共类型。
+ *
+ * 状态机是**纯函数 reducer**：`(state, input) => { state, send, emit }`。
+ * 不碰网络、不碰 DOM、不碰计时器——所以它能被
+ * `im-rtc-server/docs/conformance/*_fsm.json` 的向量逐条驱动，
+ * 与另外三端跑**同一份**用例。
+ */
+/** OutgoingFrame 是状态机要求发出去的一帧（线路形状，snake_case）。 */
+export interface OutgoingFrame {
+    readonly type: string;
+    readonly data: Readonly<Record<string, unknown>>;
+}
+/**
+ * EmittedEvent 是状态机要求抛给宿主的一个回调。
+ *
+ * `args` 的键用**协议的 snake_case 名**，与一致性向量一致；
+ * 由 engine 门面转成各端惯用形式再交给宿主。
+ */
+export interface EmittedEvent {
+    readonly cb: string;
+    readonly args: Readonly<Record<string, unknown>>;
+}
+/** MachineOutput 是一次状态转移的产物。 */
+export interface MachineOutput<S> {
+    readonly state: S;
+    readonly send: readonly OutgoingFrame[];
+    readonly emit: readonly EmittedEvent[];
+}
+/** MachineInput 是驱动状态机的三种输入之一（与向量的 act / recv / internal 一一对应）。 */
+export type MachineInput = 
+/** 宿主调用了 engine 的公开方法。 */
+{
+    readonly kind: 'act';
+    readonly op: string;
+    readonly args?: Readonly<Record<string, unknown>>;
+}
+/** 收到一条下行帧。 */
+ | {
+    readonly kind: 'recv';
+    readonly type: string;
+    readonly data: Readonly<Record<string, unknown>>;
+}
+/**
+ * engine 内部事件，既不来自信令也不来自宿主（如媒体就绪）。
+ * `args` 只有「哪一条被拒了」这类需要带标识的才有（`publish_failed` 的 cid、`subscribe_failed` 的 track_id）。
+ */
+ | {
+    readonly kind: 'internal';
+    readonly name: string;
+    readonly args?: Readonly<Record<string, unknown>>;
+};
+/** str 从线路数据里安全取一个字符串字段。 */
+export declare function str(data: Readonly<Record<string, unknown>>, key: string): string;
+/** num 从线路数据里安全取一个整数字段。 */
+export declare function num(data: Readonly<Record<string, unknown>>, key: string): number;
+/** bool 从线路数据里安全取一个布尔字段。 */
+export declare function bool(data: Readonly<Record<string, unknown>>, key: string): boolean;
+/** strArray 从线路数据里安全取一个字符串数组字段。 */
+export declare function strArray(data: Readonly<Record<string, unknown>>, key: string): string[];
+//# sourceMappingURL=types.d.ts.map

package/dist/state/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED,gCAAgC;AAChC,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;CACxC;AAED,mEAAmE;AACnE,MAAM,MAAM,YAAY;AACtB,0BAA0B;AACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE;AAClG,eAAe;GACb;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AACH;;;GAGG;GACD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD,CAAC;AAEN,4BAA4B;AAC5B,wBAAgB,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhF;AAED,2BAA2B;AAC3B,wBAAgB,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhF;AAED,4BAA4B;AAC5B,wBAAgB,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAElF;AAED,mCAAmC;AACnC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAIvF"}

package/dist/state/types.js

@@ -0,0 +1,30 @@
+/**
+ * 状态机的公共类型。
+ *
+ * 状态机是**纯函数 reducer**：`(state, input) => { state, send, emit }`。
+ * 不碰网络、不碰 DOM、不碰计时器——所以它能被
+ * `im-rtc-server/docs/conformance/*_fsm.json` 的向量逐条驱动，
+ * 与另外三端跑**同一份**用例。
+ */
+/** str 从线路数据里安全取一个字符串字段。 */
+export function str(data, key) {
+    const value = data[key];
+    return typeof value === 'string' ? value : '';
+}
+/** num 从线路数据里安全取一个整数字段。 */
+export function num(data, key) {
+    const value = data[key];
+    return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+}
+/** bool 从线路数据里安全取一个布尔字段。 */
+export function bool(data, key) {
+    return data[key] === true;
+}
+/** strArray 从线路数据里安全取一个字符串数组字段。 */
+export function strArray(data, key) {
+    const value = data[key];
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => typeof item === 'string');
+}
+//# sourceMappingURL=types.js.map

package/dist/state/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8CH,4BAA4B;AAC5B,MAAM,UAAU,GAAG,CAAC,IAAuC,EAAE,GAAW;IACtE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,GAAG,CAAC,IAAuC,EAAE,GAAW;IACtE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,IAAI,CAAC,IAAuC,EAAE,GAAW;IACvE,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AAC5B,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,QAAQ,CAAC,IAAuC,EAAE,GAAW;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,11 @@
+/**
+ * SDK_VERSION 是 im-rtc SDK 的版本号。
+ *
+ * **四端（iOS / Android / Web / 桌面）共用同一个版本号**，一起升。
+ * 它会拼进 `sys.hello` 的 `sdk` 字段（`web/<版本>`），只用于日志与灰度，不参与任何逻辑（协议 §1.2）；
+ * 宿主也可以拿它显示在「关于」里。
+ *
+ * 升版本时要同步改 `packages/call-engine/package.json` 与 `packages/call-uikit-react/package.json`。
+ */
+export declare const SDK_VERSION = "1.0.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,11 @@
+/**
+ * SDK_VERSION 是 im-rtc SDK 的版本号。
+ *
+ * **四端（iOS / Android / Web / 桌面）共用同一个版本号**，一起升。
+ * 它会拼进 `sys.hello` 的 `sdk` 字段（`web/<版本>`），只用于日志与灰度，不参与任何逻辑（协议 §1.2）；
+ * 宿主也可以拿它显示在「关于」里。
+ *
+ * 升版本时要同步改 `packages/call-engine/package.json` 与 `packages/call-uikit-react/package.json`。
+ */
+export const SDK_VERSION = '1.0.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "im-rtc-call-engine",
+  "version": "1.0.0",
+  "description": "im-rtc 的无 UI 核心：信令、状态机、媒体、设备。框架无关，禁止依赖任何 UI 库。",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run",
+    "prepublishOnly": "tsc -b"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BLiYing/im-rtc-web.git",
+    "directory": "packages/call-engine"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}