im-rtc-call-engine 1.0.0

package/dist/state/forceEnd.js

@@ -0,0 +1,96 @@
+import { CallEndReason, callDurationSec } from '../reasons.js';
+import { FrameType } from '../signaling/registry.js';
+import { initialCallContext } from './callMachine.js';
+import { clearedRoom } from './roomMachine.js';
+/**
+ * 强制收场：红键按下去**等不到结束事件**时的出口（门面见 `CallEngine.forceEnd`）。
+ *
+ * # 为什么 hangup 不够
+ *
+ * hangup 只发帧，状态由随后的 `call.ended` 推进——服务端才是裁决方（§5.1）。帧要是根本没发出去，
+ * 这一场就永远收不掉：2026-09-13 14:54 iOS frank 按了挂断，`call.hangup` 一帧没到服务端，
+ * Kit 的看门狗把界面收了，Engine 却还留在通话与房间里，别人一直看得见他，直到 14:58 整通结束。
+ *
+ * # 这里只算「该发什么、收成什么样」
+ *
+ * 纯函数，与 `dropLostSession` 同一个形状：通话机、房间机一起归零，抛唯一的结束出口。
+ * **发帧由帧循环直接交给信令连接**（不排在在途请求后面），关媒体走既有的 `LEAVE_CALLBACKS`。
+ * 五端同形：iOS `IMEngineMachine.forceEnd`、Android 同名。
+ */
+/**
+ * forceEnd 算出强制收场的结果。没有进行中的通话也不在房里时原样返回（`emit` 为空）。
+ *
+ * 时长与恢复失败时 I8 的那条例外同一个算法：本地已经收场，服务端那条带真值的 `call.ended`
+ * 随后会因为 idle 被丢掉，没有更准的值可用。起点优先用**本端**进来那一刻（`callStartedAtMs`），
+ * 没记到才退回整通电话的 `connected_at_ms`——中途被拉进来的人用后者会偏大
+ * （2026-09-15 10:05 iOS frank 待了约 6 秒，本地写成 124 秒）。
+ *
+ * `reason` 不给就按此刻状态挑（红键）；给了就用它——`room.publish` 被拒时帧循环传 `error`，
+ * 那不是用户挂的，写成 hangup 是撒谎。
+ */
+export function forceEnd(ctx, nowMs, reasonOverride) {
+    if (ctx.call.state !== 'idle') {
+        const { frames, reason: byState } = endFrames(ctx.call);
+        const reason = reasonOverride ?? byState;
+        const startedAtMs = ctx.callStartedAtMs > 0 ? ctx.callStartedAtMs : ctx.call.connectedAtMs;
+        return {
+            state: { room: clearedRoom('idle'), call: initialCallContext, callStartedAtMs: 0 },
+            send: frames,
+            emit: [
+                {
+                    cb: 'onCallEnd',
+                    args: {
+                        call_id: ctx.call.callId,
+                        reason,
+                        duration_sec: callDurationSec(startedAtMs, nowMs),
+                        ended_by: '',
+                    },
+                },
+            ],
+        };
+    }
+    if (ctx.room.state === 'idle')
+        return { state: ctx, send: [], emit: [] };
+    // 没有通话却在房里：会议。结束动作是离房（uikit 的红键在会议里就是 leaveRoom）。
+    const send = ctx.room.roomId === '' ? [] : [{ type: FrameType.roomLeave, data: { room_id: ctx.room.roomId } }];
+    return {
+        state: { ...ctx, room: clearedRoom('idle') },
+        send,
+        emit: [{ cb: 'onRoomLeft', args: { room_id: ctx.room.roomId } }],
+    };
+}
+/**
+ * endFrames 按通话此刻的状态挑结束帧，以及本地收场写哪个结束原因。
+ *
+ * - `accepting` 发 **reject + hangup 两帧**：accept 有没有在服务端落地，本端不知道。
+ *   还在响铃就是 reject 生效（随后那条 hangup 被拒，无害）；已经接起来就是 hangup 生效。
+ * - `inviting` 还没拿到 call_id（`call.invite.ok` 没回来）时**此刻发不了 cancel**，
+ *   由那条 invite.ok 迟到时补发（`callRecv.ts` 的 `handleLateFrame`）。
+ */
+export function endFrames(call) {
+    let reason = CallEndReason.hangup;
+    let types = [];
+    switch (call.state) {
+        case 'idle':
+            return { frames: [], reason };
+        case 'ringing':
+            reason = CallEndReason.reject;
+            types = [FrameType.callReject];
+            break;
+        case 'inviting':
+            reason = CallEndReason.cancel;
+            types = [FrameType.callCancel];
+            break;
+        case 'accepting':
+            types = [FrameType.callReject, FrameType.callHangup];
+            break;
+        case 'connecting':
+        case 'connected':
+            types = [FrameType.callHangup];
+            break;
+    }
+    if (call.callId === '')
+        return { frames: [], reason };
+    return { frames: types.map((type) => ({ type, data: { call_id: call.callId } })), reason };
+}
+//# sourceMappingURL=forceEnd.js.map

package/dist/state/forceEnd.js.map

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

package/dist/state/roomMachine.d.ts

@@ -0,0 +1,92 @@
+import type { Layer, TrackKind } from '../signaling/enums.js';
+import type { EmittedEvent, MachineInput, MachineOutput, OutgoingFrame } from './types.js';
+/**
+ * 房间状态机：RTC_PROTOCOL.md §5.3 的 TS 实现。
+ *
+ * 一致性向量：`im-rtc-server/docs/conformance/room_fsm.json`，四端跑同一份。
+ *
+ * # 三条不变量（协议 §5.3 的 R1~R3）
+ *
+ * - **R1** 只有 `joined` 才允许 publish / subscribe / mute；其余状态**本地拒绝**，
+ *   不发上去让服务端报错。
+ * - **R2** `joining` 与 `reconnecting` 期间**禁止发任何房间帧**，但要把用户意图
+ *   缓存下来，进房/恢复后一次性重放。这两个状态的共同点是**宿主观察不到**——
+ *   它拿到 onCallBegin 就推流是最自然的写法，不该因为一个内部中间态而失败。
+ * - **R3** 订阅与换层是**幂等**的：重复 subscribe 同一条 track 等价于换层。
+ */
+/** RoomState 是房间连接状态。 */
+export type RoomState = 'idle' | 'joining' | 'joined' | 'leaving' | 'reconnecting';
+/** PublishState 是一条本端 Track 的发布状态。 */
+export type PublishState = 'publishing' | 'published' | 'unpublishing';
+/** SubscribeState 是一条远端 Track 的订阅状态。 */
+export type SubscribeState = 'subscribing' | 'subscribed' | 'unsubscribing';
+/** RemoteTrack 是远端 Track 的本地记账。 */
+export interface RemoteTrack {
+    readonly uid: string;
+    readonly kind: TrackKind;
+    readonly participantId: string;
+}
+/** RoomContext 是房间状态机持有的全部数据。 */
+export interface RoomContext {
+    readonly state: RoomState;
+    readonly roomId: string;
+    readonly roomToken: string;
+    readonly participantId: string;
+    readonly autoSubscribe: boolean;
+    /** cid → 发布状态。用 cid 而不是 track_id：发布请求发出时还没有 track_id。 */
+    readonly publish: Readonly<Record<string, PublishState>>;
+    /** cid → 服务端分配的 track_id。 */
+    readonly publishTrackIds: Readonly<Record<string, string>>;
+    /** track_id → 订阅状态。 */
+    readonly subscribe: Readonly<Record<string, SubscribeState>>;
+    /** track_id → 远端 Track 记账。`track_unpublished` 帧不带 kind，只能靠它。 */
+    readonly remoteTracks: Readonly<Record<string, RemoteTrack>>;
+    /** 期望的最高层。track_id → layer。 */
+    readonly layers: Readonly<Record<string, Layer>>;
+    /** joining / reconnecting 期间缓存的用户意图（不变量 R2）。 */
+    readonly buffered: readonly BufferedIntent[];
+    /**
+     * 这个房间**真的收到过 `room.join.ok`** 吗。
+     *
+     * 只有它能区分 `reconnecting` 的两种来路：从 `joined` 断的（服务端那边成员关系还在，
+     * 恢复后直接回 `joined`），还是从 `joining` 断的（`room.join` 还在飞，服务端从没受理过）。
+     * 少了它，{@link resumeRoom} 会把后者也宣布成 `joined`。
+     *
+     * **不进一致性向量**：向量只断言 `room` / `publish` / `subscribe` 那几个键，
+     * 这是本端为了分辨来路自己记的账。四端同一份（iOS / Android 的 `didJoin`）。
+     */
+    readonly didJoin: boolean;
+}
+/**
+ * BufferedIntent 是攒下来的一次调用，**存的是意图不是帧**。
+ *
+ * 存帧的话重放时只能原样发出去，状态（比如 `publish[cid]='publishing'`）就漏掉了；
+ * 存意图则可以在 joined 态重新走一遍正常路径，跟没缓存过一模一样。
+ */
+export interface BufferedIntent {
+    readonly op: string;
+    readonly args: Readonly<Record<string, unknown>>;
+}
+/** initialRoomContext 是 idle 态的初值。 */
+export declare const initialRoomContext: RoomContext;
+/** roomOut 构造一次状态转移的产物。roomRecv.ts 也用它。 */
+export declare function roomOut(state: RoomContext, send?: OutgoingFrame[], emit?: EmittedEvent[]): MachineOutput<RoomContext>;
+/** clearedRoom 把房间相关的记账全部清空，但保留 state 由调用方决定。 */
+export declare function clearedRoom(state: RoomState): RoomContext;
+/** reduceRoom 是房间状态机的唯一入口。 */
+export declare function reduceRoom(ctx: RoomContext, input: MachineInput): MachineOutput<RoomContext>;
+/**
+ * resumeRoom 在重连成功后恢复房间：重放缓存的用户意图。
+ *
+ * `resumed=false` 时**必须回到 idle 并重新 join**（协议 §1.4）——
+ * 服务端那边的成员关系已经过期了，装作还在只会让 UI 撒谎。
+ */
+export declare function resumeRoom(ctx: RoomContext, resumed: boolean): MachineOutput<RoomContext>;
+/**
+ * replayBuffered 在 joined 态把攒下的意图重新走一遍。
+ *
+ * **重放走的是正常路径**（reduceRoomAct），不是把缓存的帧直接吐出去——
+ * 这样状态更新与帧生成永远一致，不会出现「帧发了但本地记账没跟上」。
+ */
+export declare function replayBuffered(ctx: RoomContext): MachineOutput<RoomContext>;
+//# sourceMappingURL=roomMachine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roomMachine.d.ts","sourceRoot":"","sources":["../../src/state/roomMachine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3F;;;;;;;;;;;;;GAaG;AAEH,yBAAyB;AACzB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,cAAc,CAAC;AAEnF,sCAAsC;AACtC,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAEvE,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,eAAe,CAAC;AAE5E,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACzD,6BAA6B;IAC7B,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,uBAAuB;IACvB,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAC7D,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAC7D,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACjD,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,EAAE,WAahC,CAAC;AAEF,2CAA2C;AAC3C,wBAAgB,OAAO,CACrB,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,aAAa,EAAO,EAC1B,IAAI,GAAE,YAAY,EAAO,GACxB,aAAa,CAAC,WAAW,CAAC,CAE5B;AAED,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,CAEzD;AAED,8BAA8B;AAC9B,wBAAgB,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,GAAG,aAAa,CAAC,WAAW,CAAC,CAS5F;AA8ED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAKzF;AA+BD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC,CAa3E"}

package/dist/state/roomMachine.js

@@ -0,0 +1,319 @@
+import { ErrorCode, errorName } from '../errors.js';
+import { FrameType } from '../signaling/registry.js';
+import { reduceRoomRecv } from './roomRecv.js';
+import { bool, str } from './types.js';
+/** initialRoomContext 是 idle 态的初值。 */
+export const initialRoomContext = {
+    state: 'idle',
+    roomId: '',
+    roomToken: '',
+    participantId: '',
+    autoSubscribe: true,
+    publish: {},
+    publishTrackIds: {},
+    subscribe: {},
+    remoteTracks: {},
+    layers: {},
+    buffered: [],
+    didJoin: false,
+};
+/** roomOut 构造一次状态转移的产物。roomRecv.ts 也用它。 */
+export function roomOut(state, send = [], emit = []) {
+    return { state, send, emit };
+}
+/** clearedRoom 把房间相关的记账全部清空，但保留 state 由调用方决定。 */
+export function clearedRoom(state) {
+    return { ...initialRoomContext, state };
+}
+/** reduceRoom 是房间状态机的唯一入口。 */
+export function reduceRoom(ctx, input) {
+    switch (input.kind) {
+        case 'act':
+            return reduceRoomAct(ctx, input.op, input.args ?? {});
+        case 'recv':
+            return reduceRoomRecv(ctx, input.type, input.data);
+        case 'internal':
+            return reduceRoomInternal(ctx, input.name, input.args ?? {});
+    }
+}
+function reduceRoomInternal(ctx, name, args) {
+    switch (name) {
+        case 'disconnected':
+            // 断线**不等于**离房：协议给了 30 秒恢复窗口，房内其他人这时还看得见我们。
+            return ctx.state === 'idle' ? roomOut(ctx) : roomOut({ ...ctx, state: 'reconnecting' });
+        case 'ws_closed_4403':
+        case 'reset':
+            return roomOut(clearedRoom('idle'));
+        case 'join_failed':
+            /*
+              进房被拒（房间没了、票过期、已在房里…）。**退回 idle**，否则状态机
+              永远停在 joining，之后每次 publish 都被 R1 本地拒成 2005。
+      
+              **还要抛 `onRoomLeft`**：只清状态的话宿主什么都不知道，会议界面会一直停在
+              「正在进入会议…」——和「呼叫被拒却不回 idle」是同一类毛病，
+              界面需要一个明确的收场信号。房间的收场信号就是这一条。
+            */
+            return ctx.state === 'joining'
+                ? roomOut(clearedRoom('idle'), [], [{ cb: 'onRoomLeft', args: { room_id: ctx.roomId } }])
+                : roomOut(ctx);
+        case 'leave_failed':
+            /*
+              离房被拒（1203 未在房间里、1201 房间没了…）。**照样当离成功收场**——
+              服务端回 1203 恰恰说明我们已经不在房里了，本地再挂着毫无意义。
+      
+              不接这一条的后果比进房失败更重：房间永久停在 `leaving`，`onRoomLeft` 抛不出去，
+              于是 engine 那边的 `LEAVE_CALLBACKS` 不命中、媒体面不归零，**摄像头指示灯一直亮**；
+              而之后每次 join / leave 都被 R1 本地拒成 2005，除非 logout 否则再也进不了房。
+            */
+            return ctx.state === 'leaving'
+                ? roomOut(clearedRoom('idle'), [], [{ cb: 'onRoomLeft', args: { room_id: ctx.roomId } }])
+                : roomOut(ctx);
+        case 'publish_failed':
+            return dropFailedPublish(ctx, str(args, 'cid'));
+        case 'subscribe_failed':
+            return dropFailedSubscribe(ctx, str(args, 'track_id'));
+        default:
+            return roomOut(ctx);
+    }
+}
+/**
+ * dropFailedPublish：`room.publish` 被拒（或没送到）时把那条 `publishing` 摘掉（静默失败审计 §A）。
+ *
+ * 不摘的话它永远停在 `publishing`：`publish.ok` 不会来，pub offer 永远不产出。
+ * **通话里走不到这里**——帧循环直接把整通强制收场（reason=error），因为推不上去的那一端
+ * 对方全程听不见看不见，留在通话里只是一块撒谎的界面。这里只管没有通话的会议房。
+ * 错误本身由帧循环先抛过了，这里不再重复抛。
+ */
+function dropFailedPublish(ctx, cid) {
+    if (ctx.publish[cid] !== 'publishing')
+        return roomOut(ctx);
+    const publish = { ...ctx.publish };
+    delete publish[cid];
+    return roomOut({ ...ctx, publish });
+}
+/**
+ * dropFailedSubscribe：`room.subscribe` 被拒时把那条 `subscribing` 连同层记账摘掉。
+ *
+ * 不摘的话不变量 R3 会把之后的每次重订都当成「已经订过、只换层」，
+ * 只发 `room.update_layer`，**再也发不出 `room.subscribe`**。最常见的来路是 1301：
+ * 订阅与对方的 `track_unpublished` 赛跑输了，此时摘掉正是实情。
+ */
+function dropFailedSubscribe(ctx, trackId) {
+    if (ctx.subscribe[trackId] !== 'subscribing')
+        return roomOut(ctx);
+    const subscribe = { ...ctx.subscribe };
+    const layers = { ...ctx.layers };
+    delete subscribe[trackId];
+    delete layers[trackId];
+    return roomOut({ ...ctx, subscribe, layers });
+}
+/**
+ * resumeRoom 在重连成功后恢复房间：重放缓存的用户意图。
+ *
+ * `resumed=false` 时**必须回到 idle 并重新 join**（协议 §1.4）——
+ * 服务端那边的成员关系已经过期了，装作还在只会让 UI 撒谎。
+ */
+export function resumeRoom(ctx, resumed) {
+    if (!resumed)
+        return roomOut(clearedRoom('idle'));
+    if (ctx.state !== 'reconnecting')
+        return roomOut(ctx);
+    if (!ctx.didJoin)
+        return rejoin(ctx);
+    return replayBuffered({ ...ctx, state: 'joined' });
+}
+/**
+ * rejoin 把「进房还没落地就断了」的那一轮**重发一遍**。
+ *
+ * `disconnected` 会把**任何**非 idle 状态推进 `reconnecting`，`joining` 也在内。
+ * 而从 `joining` 断的那一种，`room.join` 当时还在飞：服务端从没受理过我们，
+ * 恢复的只是那条 WS 会话，**不是房间成员关系**。原先无条件宣布 `joined`，
+ * 于是本端以为自己在房里，之后每一帧都换回 1201/1203，
+ * 而重新 join 又因为「不在 idle」被本地拒成 2005——一个哑掉的死局。
+ *
+ * **本端踩得比另外两端更稳**：`handleClose` 是**同步**调 `onDisconnected` 的，
+ * 而 `dispatch` 头一行就同步 reduce；`rejectAll` 触发的 `join_failed` 只能等微任务。
+ * 所以 `disconnected` **每次都赢**，那条本该兜住它的 `join_failed` 必定变成空操作
+ * （它 guard 在 `joining` 上，而状态早被推走了）。iOS 那边是竞态，这里是稳定复现。
+ *
+ * 所以判据改成认 {@link RoomContext.didJoin} 这笔账，**不认时序**。
+ * 房号与房票都还在手上，该做的正是把那次没落地的进房重来一遍；
+ * 攒下的意图照旧留着，等进房后再重放。
+ */
+function rejoin(ctx) {
+    // 连房号都没有（`join` 的帧还没产出就断了）：没得重发，干净地回 idle。
+    if (ctx.roomId === '')
+        return roomOut(clearedRoom('idle'));
+    return roomOut({ ...ctx, state: 'joining' }, [
+        {
+            type: FrameType.roomJoin,
+            data: { room_id: ctx.roomId, room_token: ctx.roomToken, auto_subscribe: ctx.autoSubscribe },
+        },
+    ]);
+}
+/**
+ * replayBuffered 在 joined 态把攒下的意图重新走一遍。
+ *
+ * **重放走的是正常路径**（reduceRoomAct），不是把缓存的帧直接吐出去——
+ * 这样状态更新与帧生成永远一致，不会出现「帧发了但本地记账没跟上」。
+ */
+export function replayBuffered(ctx) {
+    if (ctx.buffered.length === 0)
+        return roomOut(ctx);
+    let state = { ...ctx, buffered: [] };
+    const send = [];
+    const emit = [];
+    for (const intent of ctx.buffered) {
+        const result = reduceRoomAct(state, intent.op, intent.args);
+        state = result.state;
+        send.push(...result.send);
+        emit.push(...result.emit);
+    }
+    return roomOut(state, send, emit);
+}
+function reduceRoomAct(ctx, op, args) {
+    if (op === 'join')
+        return joinRoom(ctx, args);
+    if (op === 'leave') {
+        return ctx.state === 'joined'
+            ? roomOut({ ...ctx, state: 'leaving' }, [
+                { type: FrameType.roomLeave, data: { room_id: ctx.roomId } },
+            ])
+            : localReject(ctx);
+    }
+    // R1：只有 joined 才允许发布/订阅类操作。
+    // R2：**joining 与 reconnecting** 期间把意图缓存下来，之后重放——
+    //     不是丢掉，也不是发上去。这两个状态宿主都观察不到，
+    //     在它们上面报「状态非法」等于让宿主为一个内部细节买单。
+    if (ctx.state === 'joining' || ctx.state === 'reconnecting') {
+        return bufferIntent(ctx, op, args);
+    }
+    if (ctx.state !== 'joined')
+        return localReject(ctx);
+    switch (op) {
+        case 'publish':
+            return publishTrack(ctx, args);
+        case 'unpublish':
+            return unpublishTrack(ctx, args);
+        case 'mute':
+            return roomOut(ctx, [{ type: FrameType.roomMute, data: muteData(args) }]);
+        case 'subscribe':
+            return subscribeTrack(ctx, args);
+        case 'unsubscribe':
+            return unsubscribeTrack(ctx, args);
+        case 'update_layer':
+            return updateLayer(ctx, args);
+        /*
+          上行那条 PC 断了，重新 offer 一次把 ICE 打回来（媒体层已经把 restart 位置好了）。
+          **不进 BUFFERABLE_OPS**：这是「此刻网断了」的即时反应，等到重放的时候
+          那条 PC 早就换过一轮了，补发一个过期的重启只会白折腾一次协商。
+        */
+        case 'restart_pub_ice':
+            return roomOut(ctx, [{ type: FrameType.roomOffer, data: { pc: 'pub', sdp: '' } }]);
+        default:
+            return localReject(ctx);
+    }
+}
+function joinRoom(ctx, args) {
+    if (ctx.state !== 'idle')
+        return localReject(ctx);
+    // auto_subscribe 默认 true——直接读 args 会把「没写」当成 false，
+    // 那正是协议 §2.4 点名的发送侧陷阱。
+    const autoSubscribe = args['auto_subscribe'] === undefined ? true : bool(args, 'auto_subscribe');
+    const roomId = str(args, 'room_id');
+    const roomToken = str(args, 'room_token');
+    return roomOut({ ...ctx, state: 'joining', roomId, roomToken, autoSubscribe }, [
+        {
+            type: FrameType.roomJoin,
+            data: { room_id: roomId, room_token: roomToken, auto_subscribe: autoSubscribe },
+        },
+    ]);
+}
+function publishTrack(ctx, args) {
+    const cid = str(args, 'cid');
+    return roomOut({ ...ctx, publish: { ...ctx.publish, [cid]: 'publishing' } }, [
+        {
+            type: FrameType.roomPublish,
+            data: {
+                cid,
+                kind: str(args, 'kind'),
+                source: str(args, 'source'),
+                simulcast: bool(args, 'simulcast'),
+            },
+        },
+    ]);
+}
+function unpublishTrack(ctx, args) {
+    const trackId = str(args, 'track_id');
+    const cid = cidOfTrack(ctx, trackId);
+    const publish = { ...ctx.publish };
+    if (cid !== undefined)
+        publish[cid] = 'unpublishing';
+    return roomOut({ ...ctx, publish }, [
+        { type: FrameType.roomUnpublish, data: { track_id: trackId } },
+    ]);
+}
+/**
+ * subscribeTrack：**重复订阅等价于换层**（不变量 R3）。
+ *
+ * 客户端的订阅与服务端的 `track_unpublished` 天然会赛跑，所以这条路径必须幂等。
+ */
+function subscribeTrack(ctx, args) {
+    const trackId = str(args, 'track_id');
+    const maxLayer = (str(args, 'max_layer') || 'm');
+    if (ctx.subscribe[trackId] !== undefined) {
+        return roomOut({ ...ctx, layers: { ...ctx.layers, [trackId]: maxLayer } }, [
+            { type: FrameType.roomUpdateLayer, data: { track_id: trackId, max_layer: maxLayer } },
+        ]);
+    }
+    return roomOut({
+        ...ctx,
+        subscribe: { ...ctx.subscribe, [trackId]: 'subscribing' },
+        layers: { ...ctx.layers, [trackId]: maxLayer },
+    }, [{ type: FrameType.roomSubscribe, data: { track_id: trackId, max_layer: maxLayer } }]);
+}
+function unsubscribeTrack(ctx, args) {
+    const trackId = str(args, 'track_id');
+    return roomOut({ ...ctx, subscribe: { ...ctx.subscribe, [trackId]: 'unsubscribing' } }, [
+        { type: FrameType.roomUnsubscribe, data: { track_id: trackId } },
+    ]);
+}
+function updateLayer(ctx, args) {
+    const trackId = str(args, 'track_id');
+    const maxLayer = (str(args, 'max_layer') || 'm');
+    return roomOut({ ...ctx, layers: { ...ctx.layers, [trackId]: maxLayer } }, [
+        { type: FrameType.roomUpdateLayer, data: { track_id: trackId, max_layer: maxLayer } },
+    ]);
+}
+/** BUFFERABLE_OPS 是值得攒下来重放的操作——正好是 R1 管的那一组。 */
+const BUFFERABLE_OPS = new Set([
+    'publish',
+    'unpublish',
+    'mute',
+    'subscribe',
+    'unsubscribe',
+    'update_layer',
+]);
+/** bufferIntent 把中间态期间的用户意图缓存起来（不变量 R2）。 */
+function bufferIntent(ctx, op, args) {
+    // 不认识的 op 照旧本地拒绝：缓存的是**合法但来早了**的调用，不是笔误。
+    if (!BUFFERABLE_OPS.has(op))
+        return localReject(ctx);
+    return roomOut({ ...ctx, buffered: [...ctx.buffered, { op, args }] });
+}
+function muteData(args) {
+    return { track_id: str(args, 'track_id'), muted: bool(args, 'muted') };
+}
+function cidOfTrack(ctx, trackId) {
+    return Object.entries(ctx.publishTrackIds).find(([, id]) => id === trackId)?.[0];
+}
+/** localReject 是不变量 R1 的落点：错误状态下的调用**本地拒绝**，不发上去。 */
+function localReject(ctx) {
+    return roomOut(ctx, [], [
+        {
+            cb: 'onError',
+            args: { code: ErrorCode.invalidState, name: errorName(ErrorCode.invalidState) },
+        },
+    ]);
+}
+//# sourceMappingURL=roomMachine.js.map

package/dist/state/roomMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roomMachine.js","sourceRoot":"","sources":["../../src/state/roomMachine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AA4EvC,sCAAsC;AACtC,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,EAAE;IACV,SAAS,EAAE,EAAE;IACb,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,IAAI;IACnB,OAAO,EAAE,EAAE;IACX,eAAe,EAAE,EAAE;IACnB,SAAS,EAAE,EAAE;IACb,YAAY,EAAE,EAAE;IAChB,MAAM,EAAE,EAAE;IACV,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,KAAK;CACf,CAAC;AAEF,2CAA2C;AAC3C,MAAM,UAAU,OAAO,CACrB,KAAkB,EAClB,OAAwB,EAAE,EAC1B,OAAuB,EAAE;IAEzB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,WAAW,CAAC,KAAgB;IAC1C,OAAO,EAAE,GAAG,kBAAkB,EAAE,KAAK,EAAE,CAAC;AAC1C,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,UAAU,CAAC,GAAgB,EAAE,KAAmB;IAC9D,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,KAAK;YACR,OAAO,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACxD,KAAK,MAAM;YACT,OAAO,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACrD,KAAK,UAAU;YACb,OAAO,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CACzB,GAAgB,EAChB,IAAY,EACZ,IAAuC;IAEvC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,cAAc;YACjB,2CAA2C;YAC3C,OAAO,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;QAC1F,KAAK,gBAAgB,CAAC;QACtB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;QACtC,KAAK,aAAa;YAChB;;;;;;;cAOE;YACF,OAAO,GAAG,CAAC,KAAK,KAAK,SAAS;gBAC5B,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBACzF,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnB,KAAK,cAAc;YACjB;;;;;;;cAOE;YACF,OAAO,GAAG,CAAC,KAAK,KAAK,SAAS;gBAC5B,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBACzF,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnB,KAAK,gBAAgB;YACnB,OAAO,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAClD,KAAK,kBAAkB;YACrB,OAAO,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QACzD;YACE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iBAAiB,CAAC,GAAgB,EAAE,GAAW;IACtD,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,YAAY;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACpB,OAAO,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,GAAgB,EAAE,OAAe;IAC5D,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,aAAa;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;IACjC,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,OAAO,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,GAAgB,EAAE,OAAgB;IAC3D,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,IAAI,GAAG,CAAC,KAAK,KAAK,cAAc;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO,cAAc,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,MAAM,CAAC,GAAgB;IAC9B,2CAA2C;IAC3C,IAAI,GAAG,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,OAAO,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;QAC3C;YACE,IAAI,EAAE,SAAS,CAAC,QAAQ;YACxB,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,CAAC,aAAa,EAAE;SAC5F;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAgB;IAC7C,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IAEnD,IAAI,KAAK,GAAgB,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAClD,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5D,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,aAAa,CACpB,GAAgB,EAChB,EAAU,EACV,IAAuC;IAEvC,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QACnB,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;YAC3B,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;gBACpC,EAAE,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE;aAC7D,CAAC;YACJ,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,4BAA4B;IAC5B,iDAAiD;IACjD,gCAAgC;IAChC,kCAAkC;IAClC,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;QAC5D,OAAO,YAAY,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAEpD,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACjC,KAAK,WAAW;YACd,OAAO,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5E,KAAK,WAAW;YACd,OAAO,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,KAAK,aAAa;YAChB,OAAO,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACrC,KAAK,cAAc;YACjB,OAAO,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAChC;;;;UAIE;QACF,KAAK,iBAAiB;YACpB,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACrF;YACE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CACf,GAAgB,EAChB,IAAuC;IAEvC,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAClD,mDAAmD;IACnD,uBAAuB;IACvB,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACjG,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAE1C,OAAO,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE;QAC7E;YACE,IAAI,EAAE,SAAS,CAAC,QAAQ;YACxB,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE;SAChF;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CACnB,GAAgB,EAChB,IAAuC;IAEvC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7B,OAAO,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE;QAC3E;YACE,IAAI,EAAE,SAAS,CAAC,WAAW;YAC3B,IAAI,EAAE;gBACJ,GAAG;gBACH,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC;gBACvB,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC;gBAC3B,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;aACnC;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CACrB,GAAgB,EAChB,IAAuC;IAEvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IACnC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC;IAErD,OAAO,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE;QAClC,EAAE,IAAI,EAAE,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;KAC/D,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CACrB,GAAgB,EAChB,IAAuC;IAEvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,GAAG,CAAU,CAAC;IAE1D,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YACzE,EAAE,IAAI,EAAE,SAAS,CAAC,eAAe,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;SACtF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CACZ;QACE,GAAG,GAAG;QACN,SAAS,EAAE,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE;QACzD,MAAM,EAAE,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE;KAC/C,EACD,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,CACtF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,GAAgB,EAChB,IAAuC;IAEvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE;QACtF,EAAE,IAAI,EAAE,SAAS,CAAC,eAAe,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;KACjE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAClB,GAAgB,EAChB,IAAuC;IAEvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,GAAG,CAAU,CAAC;IAC1D,OAAO,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;QACzE,EAAE,IAAI,EAAE,SAAS,CAAC,eAAe,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;KACtF,CAAC,CAAC;AACL,CAAC;AAED,gDAAgD;AAChD,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IAClD,SAAS;IACT,WAAW;IACX,MAAM;IACN,WAAW;IACX,aAAa;IACb,cAAc;CACf,CAAC,CAAC;AAEH,4CAA4C;AAC5C,SAAS,YAAY,CACnB,GAAgB,EAChB,EAAU,EACV,IAAuC;IAEvC,yCAAyC;IACzC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,QAAQ,CAAC,IAAuC;IACvD,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,SAAS,UAAU,CAAC,GAAgB,EAAE,OAAe;IACnD,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,qDAAqD;AACrD,SAAS,WAAW,CAAC,GAAgB;IACnC,OAAO,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE;QACtB;YACE,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE;SAChF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/state/roomRecv.d.ts

@@ -0,0 +1,7 @@
+import type { PublishState, RoomContext } from './roomMachine.js';
+import type { MachineOutput } from './types.js';
+/** reduceRoomRecv 处理一条下行房间帧。 */
+export declare function reduceRoomRecv(ctx: RoomContext, type: string, data: Readonly<Record<string, unknown>>): MachineOutput<RoomContext>;
+/** publishStateOf 供测试与诊断读取某个 cid 的发布状态。 */
+export declare function publishStateOf(ctx: RoomContext, cid: string): PublishState | undefined;
+//# sourceMappingURL=roomRecv.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roomRecv.d.ts","sourceRoot":"","sources":["../../src/state/roomRecv.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAe,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAE/F,OAAO,KAAK,EAAgB,aAAa,EAAiB,MAAM,YAAY,CAAC;AAgB7E,gCAAgC;AAChC,wBAAgB,cAAc,CAC5B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,aAAa,CAAC,WAAW,CAAC,CA6C5B;AA0MD,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEtF"}