im-rtc-call-engine 1.0.0

package/dist/engine.js

@@ -0,0 +1,489 @@
+import { byteLength } from './bytes.js';
+import { violatesCallOptionLimits } from './callOptions.js';
+import { EngineBus } from './engineBus.js';
+import { engineConnectionHandlers, engineMediaDeps } from './engineWiring.js';
+import { ErrorCode, RtcError } from './errors.js';
+import { FrameLoop } from './frameLoop.js';
+import { logger } from './logger.js';
+import { checkDeviceId, checkRoomId } from './protocolId.js';
+import { CallEndReason } from './reasons.js';
+import { probeCamera, probeMicrophone, publishCamera, publishMicrophone, setMuted, setRemoteLayer, } from './media/engineMediaApi.js';
+import { MediaBridge } from './media/mediaBridge.js';
+import { mediaEvents } from './media/mediaPlane.js';
+import { WebRTCAdapter } from './media/webrtcAdapter.js';
+import { createConnection } from './signaling/connectionFactory.js';
+import { FrameSender } from './signaling/frameSender.js';
+/** CallEngine 是宿主唯一需要接触的类型。 */
+export class CallEngine {
+    bus = new EngineBus();
+    bridge;
+    media;
+    options;
+    sender;
+    connection = null;
+    /** 握手拿到的自己的 uid。用来挡「呼叫自己」，也供宿主读。 */
+    myUid = '';
+    loop;
+    /** 最近一次 hello.ok 喂进状态机的那个 promise，`login()` 要等它。 */
+    helloApplied = Promise.resolve();
+    /** 终态销毁标记。见 {@link destroy}。 */
+    destroyed = false;
+    constructor(options) {
+        // 与 Android 的 `Config.init` 对齐：构造时就拦，不等宿主取完票走到 login()。
+        checkDeviceId(options.deviceId);
+        this.options = options;
+        this.media = options.media ?? new WebRTCAdapter(undefined, options.videoProfile);
+        this.bridge = new MediaBridge(this.media);
+        this.sender = new FrameSender(this.media);
+        this.loop = new FrameLoop({
+            bus: this.bus,
+            bridge: this.bridge,
+            media: this.media,
+            sender: this.sender,
+            connection: () => this.connection,
+            mediaDeps: () => engineMediaDeps(this.wiring()),
+        });
+    }
+    /** on 订阅事件，返回退订函数。事件表见 events.ts（= 设计文档 §7.5）。 */
+    on(name, handler) {
+        return this.bus.on(name, handler);
+    }
+    /** uid 是当前登录的用户。未登录时是空串。 */
+    get uid() {
+        return this.myUid;
+    }
+    /** state 返回当前的通话与房间状态，供 UI 渲染。 */
+    get state() {
+        return this.loop.state;
+    }
+    /**
+     * login 建立信令连接并完成握手。
+     *
+     * # 重复调用会被拒掉
+     *
+     * **两条 WS 带着同一个 uid + device_id，服务端按顶号把先来的那条踢下线**，于是宿主收到
+     * 一个**假的 `kickedOut{takenOver}`**——「账号在别处登录」，可根本没有别处，就是这台
+     * 机器自己把自己踢了。更隐蔽的是旧那条**从不 close**：它的 `ResumeDeadline` 在第一次
+     * 断开时就已经武装好（只有 `close()` 撤得掉），约 75 秒后照样触发 `onSessionUnrecoverable`，
+     * 把**新会话**的房间清成 idle 并合成一条 `onCallEnd(network)`——用户刚换票重登、
+     * 正通着话，画面无故收场。而 `events.ts` 恰恰建议宿主在 `kickedOut{authExpired}` 之后
+     * 「取一枚新票再 login」，正好走的就是这条路。
+     *
+     * 要换账号或换一枚票，先 `logout()`。（连着的时候换票用 {@link updateToken}。）
+     * iOS 的 `login(_:)` 早就是这条规矩，本端是没跟上的那个。
+     *
+     * # 失败会把摊子收干净
+     *
+     * 握手失败时把连接关掉、`connection` 置回 null。不收的话上面那道门会把**重试**
+     * 也一起挡掉，用户从此再也登不上——比原来的毛病还糟。
+     */
+    async login(token) {
+        this.assertNotDestroyed();
+        if (this.connection !== null) {
+            throw new RtcError(ErrorCode.invalidState, {
+                cause: new Error('已经登录了：换账号或换票请先 logout()'),
+            });
+        }
+        const connection = createConnection({
+            url: this.options.url,
+            token,
+            deviceId: this.options.deviceId,
+            ...(this.options.webSocketFactory === undefined
+                ? {}
+                : { webSocketFactory: this.options.webSocketFactory }),
+        }, engineConnectionHandlers(this.wiring(), (applied) => {
+            this.helloApplied = applied;
+        }));
+        this.connection = connection;
+        this.bridge.open(mediaEvents(engineMediaDeps(this.wiring())));
+        let hello;
+        try {
+            hello = await connection.connect();
+        }
+        catch (err) {
+            // 收摊：不收的话上面那道「已经登录了」的门会把重试也挡掉。
+            connection.close();
+            this.bridge.close();
+            if (this.connection === connection)
+                this.connection = null;
+            throw err;
+        }
+        this.myUid = hello.uid;
+        // 首次登录要等状态机吃完 hello.ok 再返回：宿主拿到 login 的返回值时，
+        // engine 的状态应该已经是最终的了。（重连那些不需要等——没人在 await 它们。）
+        await this.helloApplied;
+        return hello;
+    }
+    /**
+     * updateToken 换一枚新的接入票。**下一次重连时生效，不打断当前连接。**
+     *
+     * # 为什么是宿主推给我们，而不是我们去要
+     *
+     * 协议 §1.5 说 `4401` 的处置是「换新 token 后重连」。**换票是宿主的事**——
+     * 票从宿主的账号体系来，engine 不认识那套东西，也不该替它决定什么时候去要。
+     * 所以这里是 push 不是 pull：没有「token provider 回调」这种设计。
+     *
+     * # 宿主该怎么用
+     *
+     * 在 `disconnected` 里看到 `code === 4401` 就去取一枚新票、调这个方法。
+     * 重连是已经排好的（第一档 1 秒起），所以**只要在下一次尝试之前调到就行**；
+     * 连续 3 次鉴权失败之后 engine 会抛 `kickedOut` 收手，那时就只能重新 `login` 了。
+     *
+     * 连上着的时候调它也是安全的（比如票快过期了提前换）——当前连接不受影响。
+     */
+    updateToken(token, expiresAtMs) {
+        this.connection?.updateToken(token, expiresAtMs);
+    }
+    /** logout 关掉连接与媒体。 */
+    logout() {
+        this.connection?.close();
+        this.connection = null;
+        this.bridge.close();
+        this.loop.reset();
+    }
+    /**
+     * destroy 终态销毁：`logout()` + 清空全部事件订阅。**不可逆**，给宿主整个放手音视频能力时用
+     * （账号注销、SDK 卸载）。**可重复调用**——已经销毁过再调什么都不做，不会重复 logout。
+     *
+     * # 之后再调别的方法
+     *
+     * 会发起动作的方法（`login` / `call` / `accept` / … / `publishMicrophone` / `openCamera` 等，
+     * 经 {@link act} 或 {@link mediaApi} 转发的那一批）一律**抛 `2005 invalid_state`**，
+     * 不是静默空操作：事件订阅已经清空，静默的话宿主的 `hangup()` 之类调用会石沉大海——
+     * 不抛错也不会有任何事件把原因告诉它，界面只会永远停在转圈。与 `login()` 拦
+     * 「已经登录了」同一个理由：让宿主一调就知道错在哪，不用猜。
+     *
+     * `logout()` / `forceEnd()` / `on()` / `uid` / `state`，以及读或清理类的方法
+     * （`attachView` 传 `null`、`attachLocalView` 传 `null`、`localTrack`、`stopLocalPreview`、
+     * `updateToken`）**不受影响**，销毁后调用仍然安全——宿主卸载时经常无脑清理这几个，
+     * 不该因为清理顺序先后而报错。
+     */
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.logout();
+        this.bus.clear();
+        this.destroyed = true;
+    }
+    /**
+     * assertNotDestroyed 挡住 {@link destroy} 之后的调用。见 destroy 的文档注释。
+     */
+    assertNotDestroyed() {
+        if (this.destroyed) {
+            throw new RtcError(ErrorCode.invalidState, { cause: new Error('engine 已销毁（destroy 之后不可再用）') });
+        }
+    }
+    /**
+     * act 是「发一个业务动作、等状态机处理完」的公共外壳：`call` / `accept` / `reject` / `cancel` /
+     * `hangup` / `inviteMore` / `joinCall` / `joinRoom` / `leaveRoom` 共用，唯一的区别只是
+     * op 名与参数。抽出来顺带把 {@link assertNotDestroyed} 的检查收在一处。
+     */
+    async act(op, args) {
+        this.assertNotDestroyed();
+        await this.loop.dispatch(args === undefined ? { kind: 'act', op } : { kind: 'act', op, args });
+    }
+    /**
+     * call 发起通话。**名单里不能有自己**，见 {@link rejectsSelf}。
+     *
+     * `options` 传布尔值等同旧的 `isGroup` 参数（三参数签名保持兼容）；传 {@link CallOptions}
+     * 可以带上群号 / user_data / 振铃超时（HOST_INTEGRATION_DESIGN §3.3）。
+     */
+    async call(calleeIds, mediaType, options) {
+        this.assertNotDestroyed();
+        const opts = typeof options === 'boolean' ? { isGroup: options } : (options ?? {});
+        const isGroup = opts.isGroup ?? false;
+        const chatGroupId = opts.chatGroupId ?? '';
+        const userData = opts.userData ?? '';
+        if (this.rejectsSelf(calleeIds, '呼叫') || this.rejectsBadCallOptions(chatGroupId, userData)) {
+            /*
+              **本地拒掉也要给界面一个出口。**
+      
+              调用方（uikit / 宿主）在调 `call()` 之前就已经切到「正在呼叫…」了——
+              这是对的，不然按下去几百毫秒没反应。但只抛一个 error 事件，
+              界面不知道该退回哪儿：实测三人测试里 carol 卡在「正在呼叫…」，
+              连点五次挂断收到五个 2005（状态机是 idle，没有 call 可挂），
+              除了刷新页面没有别的出路。
+      
+              `callEnd` 是所有结束分支的唯一出口（设计 §7.5），
+              这一条与「服务端拒了 invite」（call_failed）走同一个出口，界面只认它。
+              chatGroupId / userData 超限走同一个出口——不上线路，理由同上。
+            */
+            this.bus.emit('callEnd', {
+                callId: '',
+                reason: CallEndReason.error,
+                durationSec: 0,
+                endedBy: '',
+            });
+            return;
+        }
+        const args = { callee_ids: calleeIds, media_type: mediaType, is_group: isGroup };
+        // 省略表达「没传」，见 callMachine.ts startCall 的同一条注释。
+        if (chatGroupId !== '')
+            args['chat_group_id'] = chatGroupId;
+        if (userData !== '')
+            args['user_data'] = userData;
+        if (opts.timeoutSec !== undefined)
+            args['timeout_sec'] = opts.timeoutSec;
+        await this.act('call', args);
+    }
+    /**
+     * joinCall 是「群成员看到『进行中』主动加入」（协议 §4.1 `call.join`）。
+     *
+     * **「怎么知道有通话在进行中」不是 engine 的事**——宿主拿 webhook `call.started`
+     * 或后台 `GET /v1/calls?chat_group_id=...&active=1` 自己判断、自己摆横幅。
+     * 服务端拒绝（不存在 / 已结束 / 满员 / 本人已在通话中 / 宿主邀请鉴权回调拒绝 1409）
+     * 时与 `call()` 被拒同一个出口：`onError` + `onCallEnd(error)`。
+     */
+    async joinCall(callId) {
+        await this.act('join_call', { call_id: callId });
+    }
+    /** accept 接听。 */
+    async accept() {
+        await this.act('accept');
+    }
+    /** reject 拒接。 */
+    async reject() {
+        await this.act('reject');
+    }
+    /** cancel 取消呼出（**仅接通前**；接通后用 hangup）。 */
+    async cancel() {
+        await this.act('cancel');
+    }
+    /** hangup 挂断（接通后，主被叫都用它）。 */
+    async hangup() {
+        await this.act('hangup');
+    }
+    /**
+     * forceEnd 强制结束当前这一场：**结束帧立刻上线路，本地立刻收场，不等服务端**（设计文档 §7.5，五端同名）。
+     *
+     * 给「红键按下去、等不到结束事件」用——uikit 的红键看门狗 3 秒到点就调它。宿主自画 UI 时同理：
+     * `hangup()` 发出去几秒没收到 `callEnd`，就调这个。同步、不抛。
+     *
+     * 与 `hangup()` 的区别：`hangup()` 只发帧、等服务端的 `call.ended` 推进状态（§5.1），
+     * 帧没发出去或被拒了，这一场就收不掉（2026-09-13 iOS frank：界面收了，人还挂在房里四分钟）。
+     * `forceEnd()` 不等：按此刻状态挑结束帧（通话中 hangup、响铃中 reject、拨出中 cancel、
+     * 会议里 room.leave）**直接交给信令连接**，再本地收场并抛 `callEnd` / `roomLeft`；
+     * 服务端随后的 `call.ended` 会因为本地已是 idle 被静默丢弃，不会抛第二次。
+     *
+     * 收场之后才到的东西也兜住了：迟到的 `room.join.ok` 补发 `room.leave`（服务端只验房票、
+     * 不查通话成员），迟到的 `call.invite.ok` 补发 `call.cancel`、`call.connected` 补发 `call.hangup`，
+     * 迟到的候选与 SDP 不再交给媒体层。
+     *
+     * **已知限制**：没登录 / 连接断着时帧发不出去，只做本地收场；服务端那边由恢复窗口到期兜底。
+     */
+    forceEnd() {
+        this.loop.forceEnd();
+    }
+    /**
+     * inviteMore 往进行中的群通话里再拉人（协议 §4.1 `call.invite_more`）。
+     * 名单里同样不能有自己，见 {@link rejectsSelf}。
+     *
+     * **通话里的任何人都能发**（2026-09-15 起，原先仅主叫）；还在响铃 / 已离场的人发会被服务端拒成
+     * `1407 not_call_owner`（交互稿 §05）。房间满了回 `1202 room_full`；离场的发起人也能被重新邀请。
+     */
+    async inviteMore(calleeIds) {
+        this.assertNotDestroyed();
+        if (this.rejectsSelf(calleeIds, '加人'))
+            return;
+        await this.act('invite_more', { callee_ids: calleeIds });
+    }
+    /**
+     * probeMicrophone 在拨出 / 接听**之前**探一下麦克风权限（交互稿 §01）。
+     *
+     * 拿到就放掉，不占设备；被拒抛 `2001`、没设备抛 `2002`。
+     */
+    async probeMicrophone() {
+        await probeMicrophone(this.mediaApi());
+    }
+    /**
+     * probeCamera 只探摄像头权限，**不起预览**。契约同 `probeMicrophone`。
+     *
+     * 摄像头默认关着的场合（群通话、来电页上关掉了摄像头）也可能要先问权限，
+     * 拿预览去探会把摄像头真的打开。要看见自己另调 `startLocalPreview`。
+     */
+    async probeCamera() {
+        await probeCamera(this.mediaApi());
+    }
+    /** joinRoom 直接进一个会议房（不走振铃）。 */
+    async joinRoom(roomId, roomToken, autoSubscribe = true) {
+        this.assertNotDestroyed();
+        // 宿主指定的房间号同属 §2.5，不拦的话又是一条「1004 但不说为什么」。
+        checkRoomId(roomId);
+        await this.act('join', { room_id: roomId, room_token: roomToken, auto_subscribe: autoSubscribe });
+    }
+    /** leaveRoom 离房。 */
+    async leaveRoom() {
+        await this.act('leave');
+    }
+    /** publishMicrophone 发布麦克风，返回轨道的 cid。 */
+    async publishMicrophone() {
+        return publishMicrophone(this.mediaApi());
+    }
+    /**
+     * openMicrophone 是麦克风开关的**按类型**便捷接口（与腾讯 TUICallEngine 同名）。
+     *
+     * 这条轨道还没发布过就发布（等价 `publishMicrophone()`）；已经发布了就取消静音，
+     * **不会重新发布**——重复发布同一路麦克风会在 pub PC 上多挂一条 sender。
+     *
+     * 「发没发布过」问的是**媒体适配器自己的账**（`media.publishedMicrophoneCid()`），
+     * 不在门面另开一份：宿主先直接调 `publishMicrophone()` 发布过、再调这个方法的话，
+     * 门面自己那份账不知道已经发布过，会误判成「没发布」再发一次（2026-09-15 iOS 踩过）。
+     * `publishMicrophone()` / `setMuted(cid)` 仍然保留，给需要自己管 cid 的宿主用。
+     */
+    async openMicrophone() {
+        const cid = this.media.publishedMicrophoneCid();
+        if (cid !== null) {
+            await this.setMuted(cid, false);
+            return;
+        }
+        await this.publishMicrophone();
+    }
+    /**
+     * closeMicrophone 关麦克风：对已发布的那条轨道 `setMuted(cid, true)`——**不 unpublish**，
+     * 协商保留。没发布过是空操作。
+     */
+    async closeMicrophone() {
+        const cid = this.media.publishedMicrophoneCid();
+        if (cid !== null)
+            await this.setMuted(cid, true);
+    }
+    /**
+     * startLocalPreview 只起本端采集，**不发布**（设计文档 §7.5，四端同名）。
+     *
+     * 拨出中还没有房间，推流无从谈起，但界面这时就该让人看见自己（草图 §03-E）。
+     * 随后的 `publishCamera` 复用这条轨道，不会把摄像头开第二次。
+     *
+     * 返回轨道的 cid，宿主拿它调 `attachLocalView`。
+     */
+    async startLocalPreview() {
+        this.assertNotDestroyed();
+        const info = await this.media.startLocalPreview();
+        return info.cid;
+    }
+    /**
+     * stopLocalPreview 进房前关摄像头：**真的停采集**，指示灯灭（设计文档 §7.5）。
+     *
+     * 只停还没发布的预览；已发布的摄像头走 `setMuted`。再打开时重新 `startLocalPreview`，cid 会变。
+     */
+    async stopLocalPreview() {
+        await this.media.stopLocalPreview();
+        this.bridge.refreshLocalViews();
+    }
+    /** publishCamera 发布摄像头。已经在预览的话复用那条轨道。 */
+    async publishCamera(simulcast = true) {
+        return publishCamera(this.mediaApi(), simulcast);
+    }
+    /**
+     * openCamera 是摄像头开关的**按类型**便捷接口。还没发布就发布（有本端预览时复用它，
+     * 同 `publishCamera()` 现有逻辑）；已发布就取消静音——通话中开关摄像头走的是
+     * `setMuted` 既有的「关停采集、开重新采集换 sender」语义，不重新协商。
+     *
+     * 「发没发布过」同样问媒体适配器自己的账（`media.publishedCameraCid()`），
+     * 理由见 {@link openMicrophone}。
+     */
+    async openCamera() {
+        const cid = this.media.publishedCameraCid();
+        if (cid !== null) {
+            await this.setMuted(cid, false);
+            return;
+        }
+        await this.publishCamera();
+    }
+    /** closeCamera 关摄像头：`setMuted(cid, true)`（停采集，指示灯灭；不 unpublish）。没发布过是空操作。 */
+    async closeCamera() {
+        const cid = this.media.publishedCameraCid();
+        if (cid !== null)
+            await this.setMuted(cid, true);
+    }
+    /**
+     * setMuted 开关本端某条轨道。**不是 unpublish**，协商保留。
+     *
+     * 摄像头关 = 停采集（指示灯灭），开 = 重新采集换上去，cid 不变；重新采集失败时抛 RtcError。
+     */
+    async setMuted(cid, muted) {
+        await setMuted(this.mediaApi(), cid, muted);
+        this.bridge.refreshLocalViews();
+    }
+    /** localTrack 取本端轨道做预览。 */
+    localTrack(cid) {
+        return this.media.localTrack(cid);
+    }
+    /**
+     * attachView 把某个 uid 的远端画面挂到一个 `<video>` 上；传 `null` 卸载。
+     *
+     * **这是 UI 拿到画面的唯一途径**（CONVENTIONS §1）：uikit 不许自己碰
+     * `RTCPeerConnection`，也不该自己拼 `MediaStream`。
+     */
+    attachView(uid, el) {
+        this.bridge.attachView(uid, el);
+    }
+    /** attachLocalView 把本端某条轨道挂到元素上做预览；传 `null` 卸载。 */
+    attachLocalView(cid, el) {
+        this.bridge.attachLocalView(cid, el);
+    }
+    /**
+     * setRemoteLayer 报某人画面的**层上界**（协议 §3.5：上界不是命令）。
+     *
+     * 九宫格缩略图报 `l`、双击放大报 `h`。**不触发重协商**，也不保证立刻切——
+     * 服务端要等目标层的关键帧，还会再按带宽估计压一次。
+     */
+    async setRemoteLayer(uid, layer) {
+        await setRemoteLayer(this.mediaApi(), uid, layer);
+    }
+    // ── 内部 ──────────────────────────────────────────────
+    /**
+     * rejectsSelf 挡住「名单里有自己」，就地报错并返回 true。
+     *
+     * 服务端会以 `1004 bad_params` 拒掉（"callee_ids 不能含主叫自己"），但那条链路上的
+     * 失败很难看懂：界面已经乐观地进了「正在呼叫…」，而错误只是一条没头没尾的 1004。
+     * （实测撞过：Demo 的群呼默认名单里正好有登录的那个人。）
+     *
+     * **一份实现供 call 与 inviteMore 共用**——两处各写一遍的话，改了一处忘了另一处，
+     * 就又是一个「同一条规则在一处成立、另一处不成立」。
+     */
+    rejectsSelf(calleeIds, what) {
+        if (this.myUid === '' || !calleeIds.includes(this.myUid))
+            return false;
+        logger.warn(`${what}名单里含自己，已就地拒掉`, { uid: this.myUid });
+        this.bus.emitError(new RtcError(ErrorCode.badParams));
+        return true;
+    }
+    /**
+     * rejectsBadCallOptions 挡住超限的 `chatGroupId` / `userData`，就地报错并返回 true。
+     *
+     * 服务端会以 `1004 bad_params` 拒掉，但那条链路上主叫已经乐观地进了「正在呼叫…」，
+     * 错误只是一条没头没尾的 1004——与 {@link rejectsSelf} 同一个理由，本地先拦，
+     * 走同一个出口（HOST_INTEGRATION_DESIGN §3.3）。判断本身在 `callOptions.ts`
+     * （纯函数，直接单测）；这里只管日志与出口这两件带副作用的事。
+     */
+    rejectsBadCallOptions(chatGroupId, userData) {
+        if (!violatesCallOptionLimits(chatGroupId, userData))
+            return false;
+        logger.warn('chatGroupId / userData 超限，已就地拒掉', {
+            chatGroupId, userDataBytes: byteLength(userData),
+        });
+        this.bus.emitError(new RtcError(ErrorCode.badParams));
+        return true;
+    }
+    /** mediaApi 是交给 media/engineMediaApi 那几个编排函数的一把依赖。 */
+    mediaApi() {
+        this.assertNotDestroyed();
+        return { media: this.media, loop: this.loop, bus: this.bus };
+    }
+    /**
+     * wiring 是交给 engineWiring 那两个装配函数的一把依赖。
+     *
+     * 每次现造一个：里面的 `connection` 是闭包，读的永远是**当前**那条连接
+     * ——它会随重连换对象。
+     */
+    wiring() {
+        return {
+            bus: this.bus,
+            bridge: this.bridge,
+            sender: this.sender,
+            loop: this.loop,
+            connection: () => this.connection,
+        };
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/engineBus.d.ts

@@ -0,0 +1,16 @@
+import type { EngineEventHandler, EngineEventName, EngineEvents } from './events.js';
+import type { EmittedEvent } from './state/types.js';
+export declare class EngineBus {
+    private readonly bus;
+    /** on 订阅事件，返回退订函数。 */
+    on<K extends EngineEventName>(name: K, handler: EngineEventHandler<K>): () => void;
+    /** emit 抛一个事件，并按级别记一条日志。 */
+    emit<K extends EngineEventName>(name: K, payload: EngineEvents[K]): void;
+    /** emitMachine 把状态机的 `onXxx` 翻成公开事件名，并把参数转成 camelCase。 */
+    emitMachine(event: EmittedEvent): void;
+    /** emitError 把任意异常收敛成 error 事件。 */
+    emitError(err: unknown): void;
+    /** clear 清空全部订阅。给 `CallEngine.destroy()` 用——终态销毁，之后不会再抛任何事件。 */
+    clear(): void;
+}
+//# sourceMappingURL=engineBus.d.ts.map

package/dist/engineBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineBus.d.ts","sourceRoot":"","sources":["../src/engineBus.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAuBrD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IAEtC,sBAAsB;IACtB,EAAE,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAIlF,4BAA4B;IAC5B,IAAI,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAMxE,0DAA0D;IAC1D,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAmBtC,mCAAmC;IACnC,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAS7B,gEAAgE;IAChE,KAAK,IAAI,IAAI;CAGd"}

package/dist/engineBus.js

@@ -0,0 +1,89 @@
+import { ErrorCode, RtcError, errorName, isRtcError } from './errors.js';
+import { EventBus } from './eventBus.js';
+import { MACHINE_EVENT_NAMES } from './events.js';
+import { logger } from './logger.js';
+import { camelizeArgs } from './signaling/caseMapping.js';
+/**
+ * engine 的事件出口：抛给宿主的同时**写一条日志**。
+ *
+ * # 为什么事件要进日志
+ *
+ * 出问题时最需要的一样东西是「这一通电话到底发生了什么」，而那正是公开事件表。
+ * 只有宿主自己订阅才看得到的话，一次排障就得让人手动复制事件流——
+ * 复制不全、顺序错乱、跟服务端日志对不上时间轴。
+ * 走 `logger` 之后，宿主装一个 sink 就能把两端与服务端放在同一条时间轴上读。
+ *
+ * # 级别怎么定
+ *
+ * 按 `docs/mechanism/LOGGING.md`：info 是**状态跃迁**，一次 1v1 通话个位数条。
+ * `activeSpeakers` / `networkQuality` 是服务端节流后的**周期性**事件（300ms / 2s），
+ * 放 info 会把真正要看的那几条冲掉，所以降到 debug。
+ */
+const PERIODIC_EVENTS = new Set([
+    'activeSpeakers',
+    'networkQuality',
+]);
+export class EngineBus {
+    bus = new EventBus();
+    /** on 订阅事件，返回退订函数。 */
+    on(name, handler) {
+        return this.bus.on(name, handler);
+    }
+    /** emit 抛一个事件，并按级别记一条日志。 */
+    emit(name, payload) {
+        if (PERIODIC_EVENTS.has(name))
+            logger.debug(`event ${name}`, toFields(payload));
+        else
+            logger.info(`event ${name}`, toFields(payload));
+        this.bus.emit(name, payload);
+    }
+    /** emitMachine 把状态机的 `onXxx` 翻成公开事件名，并把参数转成 camelCase。 */
+    emitMachine(event) {
+        const name = MACHINE_EVENT_NAMES[event.cb];
+        if (name === undefined) {
+            logger.warn('状态机抛了一个没登记的回调', { cb: event.cb });
+            return;
+        }
+        const args = camelizeArgs(event.args);
+        /*
+          callCancelled 的公开事件字段改成了 uid（四端命名核对，2026-09-15），但一致性向量
+          （四端共用，见 call_fsm.json）钉的是线路字段名 by，callRecv.ts 不能跟着改——
+          只在进公开事件表这最后一步做翻译，别处都还是 by。
+        */
+        if (name === 'callCancelled' && Object.hasOwn(args, 'by')) {
+            args['uid'] = args['by'];
+            delete args['by'];
+        }
+        this.emit(name, args);
+    }
+    /** emitError 把任意异常收敛成 error 事件。 */
+    emitError(err) {
+        const error = isRtcError(err) ? err : new RtcError(ErrorCode.internal, { cause: err });
+        this.emit('error', {
+            code: error.code,
+            name: errorName(error.code),
+            message: error.message,
+        });
+    }
+    /** clear 清空全部订阅。给 `CallEngine.destroy()` 用——终态销毁，之后不会再抛任何事件。 */
+    clear() {
+        this.bus.clear();
+    }
+}
+/**
+ * toFields 把事件参数摊平成日志字段。
+ *
+ * 对象与数组转成 JSON 字符串：日志字段是给人 grep 的，嵌套结构在一行里读不出来，
+ * 而且各家 sink 对嵌套值的处理还不一致。
+ */
+function toFields(payload) {
+    if (payload === null || typeof payload !== 'object')
+        return {};
+    const out = {};
+    for (const [key, value] of Object.entries(payload)) {
+        out[key] =
+            value !== null && typeof value === 'object' ? JSON.stringify(value) : value;
+    }
+    return out;
+}
+//# sourceMappingURL=engineBus.js.map

package/dist/engineBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineBus.js","sourceRoot":"","sources":["../src/engineBus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,eAAe,GAAiC,IAAI,GAAG,CAAC;IAC5D,gBAAgB;IAChB,gBAAgB;CACjB,CAAC,CAAC;AAEH,MAAM,OAAO,SAAS;IACH,GAAG,GAAG,IAAI,QAAQ,EAAE,CAAC;IAEtC,sBAAsB;IACtB,EAAE,CAA4B,IAAO,EAAE,OAA8B;QACnE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAA4B,IAAO,EAAE,OAAwB;QAC/D,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;;YAC3E,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,0DAA0D;IAC1D,WAAW,CAAC,KAAmB;QAC7B,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC;;;;UAIE;QACF,IAAI,IAAI,KAAK,eAAe,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAa,CAAC,CAAC;IACjC,CAAC;IAED,mCAAmC;IACnC,SAAS,CAAC,GAAY;QACpB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACjB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;YAC3B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC;IAED,gEAAgE;IAChE,KAAK;QACH,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;CACF;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,OAAgB;IAChC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC/D,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAkC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,GAAG,CAAC;YACN,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/engineWiring.d.ts

@@ -0,0 +1,40 @@
+import type { EngineBus } from './engineBus.js';
+import type { FrameLoop } from './frameLoop.js';
+import type { MediaBridge } from './media/mediaBridge.js';
+import type { MediaPlaneDeps } from './media/mediaPlane.js';
+import type { Connection } from './signaling/connection.js';
+import type { EngineConnectionHandlers } from './signaling/connectionFactory.js';
+import type { FrameSender } from './signaling/frameSender.js';
+/**
+ * 门面的**装配**那一半：把连接回调与媒体依赖拼出来。
+ *
+ * 单拎出来不是为了凑行数——这两块是 `CallEngine` 里**唯一不属于公开 API 的东西**。
+ * 它旁边那些方法（`call` / `accept` / `publishCamera` …）是宿主直接调的签名，
+ * 拆出去只会让每个方法多一跳；而这两块是纯接线，宿主永远看不见，
+ * 放在门面里只是让那个文件一直贴着 400 行的红线。
+ */
+/** EngineWiring 是接线要用到的那一把东西。 */
+export interface EngineWiring {
+    bus: EngineBus;
+    bridge: MediaBridge;
+    sender: FrameSender;
+    loop: FrameLoop;
+    /**
+     * 当前连接。**取成函数**：它会随重连换对象，传值的话拿到的是构造那一刻的旧账。
+     */
+    connection: () => Connection | null;
+}
+/**
+ * engineMediaDeps 是交给媒体接线的那一小把依赖（见 media/mediaPlane.ts）。
+ *
+ * `uidOf` 同样读的是状态机的**当前**快照，理由和 `connection` 那条一样。
+ */
+export declare function engineMediaDeps(w: EngineWiring): MediaPlaneDeps;
+/**
+ * engineConnectionHandlers 把连接层的回调接到状态机与事件总线上。
+ *
+ * `noteHelloApplied` 是回给门面的那条线：`login()` 要 await「hello.ok 已经喂进状态机」，
+ * 而握手结果**每一次**都从这里进来（包括自动重连那些），所以 promise 只能由这里产出。
+ */
+export declare function engineConnectionHandlers(w: EngineWiring, noteHelloApplied: (applied: Promise<void>) => void): EngineConnectionHandlers;
+//# sourceMappingURL=engineWiring.d.ts.map