im-rtc-call-engine 1.0.0

package/dist/frameLoop.js

@@ -0,0 +1,346 @@
+import { ErrorCode, RtcError } from './errors.js';
+import { LogField, logger } from './logger.js';
+import { addRemoteCandidate } from './media/mediaPlane.js';
+import { CallEndReason } from './reasons.js';
+import { toFrameProps } from './signaling/caseMapping.js';
+import { lookupFrame } from './signaling/registry.js';
+import { initialEngineContext, reduceEngine } from './state/engineMachine.js';
+import { forceEnd as planForceEnd } from './state/forceEnd.js';
+/**
+ * engine 的**核心循环**：输入喂进状态机 → 产出的帧发出去 → 应答再喂回来。
+ *
+ * 从 `engine.ts` 拆出来的理由是体量红线（CONVENTIONS §2），但这一刀本来就该切：
+ * 门面负责的是**对宿主的那张 API 表**，这里负责的是**状态机与线路之间的往返**。
+ * 状态机的当前快照也归这里管——它是这个循环的状态，不是门面的字段。
+ */
+/**
+ * LEAVE_CALLBACKS 是「这一轮媒体到此为止」的信号。
+ *
+ * 三个都要算：通话正常结束、自己离房、房间被服务端关掉。
+ * 少算一个的后果是同一条：下一次进房带着上一轮的 PeerConnection。
+ */
+const LEAVE_CALLBACKS = new Set(['onCallEnd', 'onRoomLeft', 'onRoomClosed']);
+/** LATE_MEDIA_FRAMES 是交给媒体层之前要先看房间还在不在的那几帧。见 `handleIncoming` 开头。 */
+const LATE_MEDIA_FRAMES = new Set(['room.ice_candidate', 'room.offer', 'room.answer']);
+/** SLOW_REQUEST_MS：请求往返超过这么久记一条。正常是几十毫秒。 */
+const SLOW_REQUEST_MS = 2_000;
+/** FrameLoop 持有状态机快照，并驱动它。 */
+export class FrameLoop {
+    deps;
+    ctx = initialEngineContext;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** state 是状态机的当前快照，供门面转给 UI。 */
+    get state() {
+        return this.ctx;
+    }
+    /** reset 把状态机归零（logout 用）。 */
+    reset() {
+        this.ctx = initialEngineContext;
+    }
+    /**
+     * handleIncoming 是**所有下行帧的唯一入口**——事件与应答都走它。
+     *
+     * 这里曾经漏了应答那一半：`.ok` 走的是 `request()` 的 Promise，没喂回状态机，
+     * 于是 `room.join` 发出去了、`room.join.ok` 回来了，房间状态却永远停在 `joining`，
+     * 随后的 publish 全被 R1「只有 joined 才允许发布」本地拒掉。
+     */
+    async handleIncoming(type, data) {
+        const { media, sender } = this.deps;
+        /*
+          **房间已经不在了，迟到的媒体帧不许交给媒体层。**
+    
+          强制收场、通话结束之后才到的候选或 SDP 要是照常交下去，媒体层会在一个没人要的房间上
+          继续协商、甚至把 PeerConnection 重新建起来，一直挂到下一次关媒体。
+          状态机那一侧由房间机的 idle 分支丢弃（`roomRecv.ts` 的 `handleLateFrame`）。
+        */
+        if (this.ctx.room.state === 'idle' && LATE_MEDIA_FRAMES.has(type)) {
+            logger.debug('房间已不在，丢弃迟到的媒体帧', { type });
+            return;
+        }
+        if (type === 'room.ice_candidate') {
+            await addRemoteCandidate(this.deps.mediaDeps(), (pc, init) => media.addRemoteCandidate(pc, init), data);
+            return; // 候选只关媒体层的事，状态机不认识它
+        }
+        if (type === 'room.offer' && data['pc'] === 'sub') {
+            sender.noteSubOffer(typeof data['sdp'] === 'string' ? data['sdp'] : '');
+        }
+        if (type === 'room.answer' && data['pc'] === 'pub') {
+            // 先把 SDP 应用到媒体层，再让状态机把发布状态推进到 published。
+            await media.applyPubAnswer(typeof data['sdp'] === 'string' ? data['sdp'] : '');
+        }
+        await this.dispatch({ kind: 'recv', type, data });
+    }
+    /** dispatch 把一个输入喂进状态机，然后发帧、抛事件。 */
+    async dispatch(input) {
+        await this.apply(reduceEngine(this.ctx, input), input);
+    }
+    /**
+     * forceEnd 强制收掉当前这一场：**先把结束帧直接交给信令连接，再在本地收场**（`CallEngine.forceEnd`）。
+     *
+     * # 为什么不走 dispatch
+     *
+     * dispatch 产出的帧要排在 `sendFrame` 的 await 链上——前面要是还有一个在途请求
+     * （比如迟迟没回的 room.join），结束帧就跟着一起卡住。2026-09-13 iOS frank 那次
+     * `call.hangup` 一帧都没到服务端，卡的正是这一段。所以帧走 `Connection.fire`，
+     * 在这次调用里就同步写进 socket。
+     *
+     * # 为什么这里不用比对「是不是同一场」
+     *
+     * 算帧与本地收场在同一次同步调用里完成，中间不会插进别的帧（iOS 那边隔着 actor 才要比对）。
+     * 拨出中还没拿到 call_id 的，此刻发不了 cancel：本地照样收场，
+     * 那条 invite.ok 迟到时由通话机的 idle 分支补发（`callRecv.ts` 的 `handleLateFrame`）。
+     */
+    forceEnd(nowMs = Date.now(), reason) {
+        const plan = planForceEnd(this.ctx, nowMs, reason);
+        if (plan.emit.length === 0) {
+            logger.info('强制收场：没有进行中的通话或房间', {});
+            return;
+        }
+        logger.warn('强制收场', {
+            [LogField.callId]: this.ctx.call.callId,
+            call_state: this.ctx.call.state,
+            [LogField.roomId]: this.ctx.room.roomId,
+            room_state: this.ctx.room.state,
+            frames: plan.send.map((frame) => frame.type).join(','),
+        });
+        this.fireFrames(plan.send);
+        // 结束帧已经直发过了，这里只落状态与事件；apply 的同步前半段（记状态、关媒体、抛事件）当场跑完。
+        this.apply({ state: plan.state, send: [], emit: plan.emit }).catch((err) => this.deps.bus.emitError(err));
+    }
+    /** fireFrames 把结束帧直接交给信令连接，不等应答。 */
+    fireFrames(frames) {
+        const connection = this.deps.connection();
+        if (connection === null) {
+            if (frames.length > 0)
+                logger.warn('强制收场：没有信令连接，结束帧发不出去，只做本地收场', {});
+            return;
+        }
+        for (const frame of frames) {
+            const fields = lookupFrame(frame.type);
+            if (fields !== undefined)
+                connection.fire(frame.type, fields, toFrameProps(fields, frame.data));
+        }
+    }
+    /**
+     * apply 把一次推进的结果落地：记状态、同步媒体层、抛事件、发帧。
+     *
+     * **发帧之前的部分都是同步的**——`forceEnd` 靠这一点在调用返回前就把事件抛完。
+     */
+    async apply(result, input) {
+        const { bus, bridge } = this.deps;
+        this.ctx = result.state;
+        // 认领新到的远端轨道，**并把状态机里已经没有的那些摘掉**（见 syncRemoteTracks）。
+        bridge.syncRemoteTracks(this.ctx.room.remoteTracks);
+        // **一通结束就把媒体面归零**，在抛事件之前：宿主收到 onCallEnd 时
+        // engine 已经是干净的，下一通不会带着上一通的轨道去协商。
+        if (result.emit.some((event) => LEAVE_CALLBACKS.has(event.cb)))
+            bridge.reset();
+        /*
+          **先抛事件、再发帧**，顺序不能反。
+    
+          事件说的是「刚刚发生了什么」，帧说的是「接下来要做什么」——反过来的话，
+          帧的应答会在本轮事件之前就被处理掉，宿主收到的回调顺序就乱了。
+          实测症状：`call.connected` 产出 onCallBegin（事件）与 room.join（帧），
+          先发帧的话 join.ok 立刻回来并抛出 onRoomJoined，于是宿主看到的是
+          **roomJoined 和 userEnter 排在 callBegin 前面**——它还没被告知有这通电话，
+          就先收到了这通电话房间里的事件。
+        */
+        if (input !== undefined)
+            this.logLocalReject(input, result.emit);
+        for (const event of result.emit) {
+            /*
+              **`onDisconnected` 由连接层独占**，状态机那一份不往外发。
+      
+              两边都发的话宿主每次断线收到**两条** `disconnected`，而且状态机那条
+              是空载荷的（一致性向量里就是 `args: {}`——它只关心状态怎么走，
+              关闭码不是状态机的事）。实测日志里的样子是：一条 `{}`、一条
+              `{code:4401,willReconnect:false}`，中间还夹着一条假的 4403——
+              那是「鉴权失败到顶」复用了 `ws_closed_4403` 这个内部事件留下的。
+              宿主想数重连次数就没法数了。
+            */
+            if (event.cb === 'onDisconnected')
+                continue;
+            /*
+              **`onKickedOut` 同理由连接层独占。**
+      
+              状态机那一份也是空载荷的，而宿主真正需要的是**为什么被踢**：
+              `takenOver`（被顶号/被吊销，回登录页）与 `authExpired`（票的问题，换票重来）
+              处置完全相反。状态机不可能知道这个——它只收到一个 `ws_closed_4403` 内部事件，
+              而「鉴权失败到顶」也复用了同一个内部事件（见上面那段注释）。
+              两边都发的话宿主会收到两条 kickedOut，其中一条还没有 reason。
+            */
+            if (event.cb === 'onKickedOut')
+                continue;
+            bus.emitMachine(event);
+        }
+        /*
+          有人开了摄像头：等他的**新画面真的上屏**再抛一次 firstVideoFrame（见 `FirstFrameGate`）。
+          放在抛事件之后——界面先收到 userVideoAvailable 记成「等画面」，再等这一帧来揭示。
+        */
+        for (const uid of videoTurnedOn(result.emit)) {
+            bridge.awaitFirstVideoFrame(uid, (trackId) => bus.emit('firstVideoFrame', { uid, trackId }));
+        }
+        for (const frame of result.send) {
+            await this.sendFrame(frame);
+        }
+    }
+    /** sendFrame 发一帧，并把应答喂回状态机。 */
+    async sendFrame(frame) {
+        const connection = this.deps.connection();
+        /*
+          **没有连接不是「什么都不做」，是一次失败。**
+    
+          原先这里是裸的 `if (connection === null) return`：状态机已经迁移过了，帧却没发出去，
+          既不回滚也不报错。宿主在 `login()` 之前（或 `logout()` 之后）调一次 `call()`，
+          通话机就永久停在 `inviting`——界面「正在呼叫…」转个不停，之后 `hangup()` 被本地
+          拒成 2005、`cancel()` 产出的帧同样被丢掉，**再也回不到 idle**，下一通真电话也被
+          2005 挡住。走下面这条收场路径之后，宿主拿到的是一条 `2007 not_logged_in`
+          加一次正常的 `callEnd`，界面收得掉。（Android 的 `IMSignalConnection.request`
+          未连接时就是立刻回 `NOT_LOGGED_IN`，本端这个码定义了却一直没人用。）
+        */
+        if (connection === null) {
+            const err = new RtcError(ErrorCode.notLoggedIn, { forType: frame.type });
+            this.deps.bus.emitError(err);
+            await this.rollback(frame);
+            return;
+        }
+        const startedMs = Date.now();
+        try {
+            const reply = await this.deps.sender.send(connection, frame.type, frame.data);
+            noteSlowRequest(frame.type, startedMs, false);
+            // **应答也要喂回状态机**：join.ok / publish.ok 都是状态推进的关键一步。
+            if (reply !== null)
+                await this.handleIncoming(reply.type, reply.data);
+        }
+        catch (err) {
+            noteSlowRequest(frame.type, startedMs, true);
+            // 请求失败不该中断整个事件流：转成 error 事件交给宿主。
+            this.deps.bus.emitError(err);
+            await this.rollback(frame);
+        }
+    }
+    /**
+     * rollback 把「这一帧没送到」翻译成状态机能收场的内部事件。
+     *
+     * **一张表管住所有中间态**：留在中间态的代价永远是同一种——界面停在一个转圈的屏上，
+     * 而之后每一个动作都被不变量本地拒成 2005，宿主只看到一串没头没尾的 2005，
+     * 真正的原因早淹在上一条 error 里了。四端同一张表（Android 的
+     * `IMCallEngine.onRequestFailed`、iOS 的 `IMFrameLoop.sendFrame`）。
+     */
+    async rollback(frame) {
+        const { type } = frame;
+        /*
+          呼叫 / 接听 / 主动加入被拒都要退回 idle。
+    
+          `call.invite` 不退的话界面停在「正在呼叫…」，而服务端根本没有这通电话，
+          之后每次挂断都换回 1401 call_not_found，用户永远退不出那一屏。
+          **`call.accept` 与 `call.join` 是后补的**：被拒时通话机滞留在 `accepting`，
+          而 `reject()` 要求 `ringing`——来电屏上两个按钮全都点不动，一个出口都没有。
+        */
+        if (type === 'call.invite' || type === 'call.accept' || type === 'call.join') {
+            await this.dispatch({ kind: 'internal', name: 'call_failed' });
+            return;
+        }
+        /*
+          **进房失败要把房间状态退回 idle**。
+    
+          不退的话状态机永远停在 `joining`，之后每一次 publish 都会被不变量 R1
+          本地拒掉（2005 invalid_state），而宿主只看到两条没头没尾的 2005——
+          真正的原因（那条 room.join 被服务端拒了）已经淹在上一条 error 里了。
+          退回 idle 至少让「重进一次」成为可能。
+        */
+        if (type === 'room.join') {
+            await this.dispatch({ kind: 'internal', name: 'join_failed' });
+            return;
+        }
+        /*
+          **离房被拒也要退回 idle**：服务端在「会话已不在房间里」时回 1203，
+          而那正说明我们已经不在房里了。不接这一条的话房间永久停在 `leaving`——
+          `onRoomLeft` 抛不出来，于是 `LEAVE_CALLBACKS` 不命中、`bridge.reset()` 不跑，
+          **摄像头与麦克风一直开着**，而之后每次 join / leave 都被本地拒成 2005，
+          这台 engine 除非 logout 否则再也进不了房。
+        */
+        if (type === 'room.leave') {
+            await this.dispatch({ kind: 'internal', name: 'leave_failed' });
+            return;
+        }
+        /*
+          **发布被拒：通话里直接收掉整通（reason=error），没有通话才只回滚那一条**（静默失败审计 §A）。
+    
+          原先这张表不认 `room.publish`，那条轨道永远停在 `publishing`：publish.ok 不来 →
+          pub offer 永不产出 → 上行从未协商。界面显示已接通、计时器在走、按钮显示没静音，
+          **对方全程听不见看不见，零提示**。留在通话里只报错也不够——Kit 并不展示这类错误，
+          而服务端会拒的几种情形（房间已不在、同一路重复发布、请求超时）重试都救不回来。
+          收场走 forceEnd：挂断帧不排队、callEnd 只抛一次，各端 Kit 本来就认它。
+        */
+        if (type === 'room.publish') {
+            if (this.ctx.call.state !== 'idle') {
+                logger.warn('发布被拒，结束本端通话', { [LogField.callId]: this.ctx.call.callId });
+                this.forceEnd(Date.now(), CallEndReason.error);
+                return;
+            }
+            await this.dispatch({ kind: 'internal', name: 'publish_failed', args: { cid: frame.data['cid'] } });
+            return;
+        }
+        // 订阅被拒只摘记账，不收场：最常见的 1301 是订阅与对方停推赛跑输了，通话本身没事。
+        if (type === 'room.subscribe') {
+            await this.dispatch({
+                kind: 'internal',
+                name: 'subscribe_failed',
+                args: { track_id: frame.data['track_id'] },
+            });
+        }
+    }
+    /**
+     * logLocalReject 把「状态机本地拒掉了一个动作」记成一条**说得清的**日志。
+     *
+     * 宿主收到的 `onError` 只有 `code=2005 / invalid_state`——**哪个动作、当时什么状态，
+     * 一个字都没有**。三人会议那次排查就卡在这里：日志里十几条一模一样的 2005，
+     * 要读代码才能推出「点的是挂断、而会议里没有 call」。
+     *
+     * 不把这些塞进 `onError` 的载荷，是因为那是四端共用的公开回调表；
+     * 诊断信息进日志就够了。
+     */
+    logLocalReject(input, emit) {
+        if (input.kind !== 'act')
+            return;
+        const rejected = emit.some((event) => event.cb === 'onError' && event.args['code'] === ErrorCode.invalidState);
+        if (!rejected)
+            return;
+        logger.warn('动作被状态机本地拒绝', {
+            op: input.op,
+            call_state: this.ctx.call.state,
+            room_state: this.ctx.room.state,
+        });
+    }
+}
+/**
+ * noteSlowRequest 记下「这一帧从交给 sender 到拿回应答」慢得不正常的那几次。
+ *
+ * 2026-09-13 iOS frank 的 room.join 从状态机产出到服务端收到隔了 28.6 秒，而客户端一个字都没留下。
+ * 有了这一条，拿 `elapsed_ms` 对服务端的受理时刻，就分得清慢在本端发出之前还是服务端那边。
+ */
+function noteSlowRequest(type, startedMs, failed) {
+    const elapsedMs = Date.now() - startedMs;
+    if (elapsedMs < SLOW_REQUEST_MS)
+        return;
+    logger.warn('请求往返慢', { type, elapsed_ms: elapsedMs, failed });
+}
+/**
+ * videoTurnedOn 挑出这一批事件里「开了摄像头」的人。只看视频、只看开——
+ * 关摄像头与麦克风开关不用等画面（Android `videoTurnedOn` 同一条判据）。
+ */
+export function videoTurnedOn(emit) {
+    const uids = [];
+    for (const event of emit) {
+        if (event.cb !== 'onUserVideoAvailable' || event.args['available'] !== true)
+            continue;
+        const uid = event.args['uid'];
+        if (typeof uid === 'string' && uid !== '')
+            uids.push(uid);
+    }
+    return uids;
+}
+//# sourceMappingURL=frameLoop.js.map

package/dist/frameLoop.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `im-rtc-call-engine` —— im-rtc 的无 UI 核心。
+ *
+ * **框架无关**：本包禁止依赖 react 或任何 UI 库，且必须能在无 DOM 的环境构造
+ * （一致性向量测试就跑在 Node 里）。DOM / WebRTC 的接触点收敛在 media/ 与 devices/。
+ *
+ * **协议契约在 `im-rtc-server/docs/RTC_PROTOCOL.md`，本仓只读引用**——
+ * 不得单方面加字段。改协议 = 改四个仓 + 同步一致性向量。
+ *
+ * 当前进度（P2 第一刀）：信令帧的编解码与协议常量。
+ * 状态机、WS 客户端、媒体适配器随后落地。
+ */
+export { SDK_VERSION } from './version.js';
+export { ERROR_DEFINITIONS, ErrorCode, RtcError, errorName, isLocalError, isRetryable, isRtcError, lookupError, } from './errors.js';
+export type { ErrorCodeName, ErrorCodeValue, ErrorDefinition } from './errors.js';
+/** 宿主可以自己先验一遍生成的 id，不必等到 login() / joinRoom() 才发现（协议 §2.5）。 */
+export { checkDeviceId, checkRoomId } from './protocolId.js';
+export { CallEndReason, GROUP_DOMINANT_PRIORITY, callDurationSec, dominantReason, normalizeReason, } from './reasons.js';
+export type { CallEndReasonValue } from './reasons.js';
+export { LogField, clearDiagnostics, exportDiagnostics, logger, redact, redactCandidate, redactSdp, setLogClock, setLogLevel, setLogSink, } from './logger.js';
+export type { DiagnosticEntry, LogFields, LogLevel, LogSink } from './logger.js';
+export { MAX_FRAME_BYTES, OK_SUFFIX, decodeEnvelope, encodeEnvelope, isEvent, okType, } from './signaling/envelope.js';
+export type { Envelope } from './signaling/envelope.js';
+export { checkDiscipline } from './signaling/discipline.js';
+export { DEFAULT_TIMEOUT_SEC, LAYERS, MAX_TIMEOUT_SEC, MEDIA_TYPES, MIN_TIMEOUT_SEC, PC_ROLES, REASONS, ROOM_KINDS, TRACK_KINDS, TRACK_SOURCES, } from './signaling/enums.js';
+export type { HandledAction, Layer, MediaType, PcRole, RoomKind, TrackKind, TrackSource, } from './signaling/enums.js';
+export { FrameType, REQUEST_TYPES, RESERVED_TYPES, decodeFrame, encodeFrame, isRequestType, isReservedType, knownFrameTypes, lookupFrame, newFrameData, } from './signaling/registry.js';
+export type { FieldSpec, FrameData, FrameFields } from './signaling/fieldSpec.js';
+export { BACKOFF_STEPS_MS, backoffDelayMs } from './signaling/backoff.js';
+export { CloseCode, shouldReconnect } from './signaling/webSocket.js';
+export type { WebSocketFactory, WebSocketLike } from './signaling/webSocket.js';
+export { Connection } from './signaling/connection.js';
+export type { ConnectionEvents, ConnectionOptions, ConnectionState, HelloOk } from './signaling/connection.js';
+export { initialCallContext, reduceCall, synthesizeNetworkEnd } from './state/callMachine.js';
+export type { CallContext, CallRole, CallState } from './state/callMachine.js';
+export { initialRoomContext, reduceRoom, resumeRoom } from './state/roomMachine.js';
+export type { PublishState, RoomContext, RoomState, SubscribeState } from './state/roomMachine.js';
+export { initialEngineContext, reduceEngine } from './state/engineMachine.js';
+export type { EngineContext } from './state/engineMachine.js';
+export type { EmittedEvent, MachineInput, MachineOutput, OutgoingFrame } from './state/types.js';
+export { CallEngine } from './engine.js';
+export type { CallOptions, EngineOptions } from './engine.js';
+export { EventBus } from './eventBus.js';
+export { EngineBus } from './engineBus.js';
+export { MACHINE_EVENT_NAMES } from './events.js';
+export type { CallRoleName, EngineEventHandler, EngineEventName, EngineEvents } from './events.js';
+export { WebRTCAdapter } from './media/webrtcAdapter.js';
+export { VideoProfiles, defaultVideoProfile, videoConstraints } from './media/videoProfile.js';
+export type { VideoProfile } from './media/videoProfile.js';
+export { ViewRegistry } from './media/viewRegistry.js';
+export { MediaBridge } from './media/mediaBridge.js';
+export type { ViewElement } from './media/viewRegistry.js';
+export { camelizeArgs, snakeToCamel, toFrameProps } from './signaling/caseMapping.js';
+export { FrameSender } from './signaling/frameSender.js';
+export { parseCandidate } from './signaling/candidate.js';
+export { createConnection } from './signaling/connectionFactory.js';
+export type { ParsedCandidate } from './signaling/candidate.js';
+export type { LocalTrackInfo, MediaAdapter, MediaAdapterEvents, MediaSource, } from './media/mediaAdapter.js';
+export * as frames from './signaling/frames.room.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAElF,+DAA+D;AAC/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,eAAe,EACf,SAAS,EACT,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEjF,OAAO,EACL,eAAe,EACf,SAAS,EACT,cAAc,EACd,cAAc,EACd,OAAO,EACP,MAAM,GACP,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EACL,mBAAmB,EACnB,MAAM,EACN,eAAe,EACf,WAAW,EACX,eAAe,EACf,QAAQ,EACR,OAAO,EACP,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,aAAa,EACb,KAAK,EACL,SAAS,EACT,MAAM,EACN,QAAQ,EACR,SAAS,EACT,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,SAAS,EACT,aAAa,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,GACb,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAElF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAE/G,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpF,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjG,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC/F,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EACV,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,42 @@
+/**
+ * `im-rtc-call-engine` —— im-rtc 的无 UI 核心。
+ *
+ * **框架无关**：本包禁止依赖 react 或任何 UI 库，且必须能在无 DOM 的环境构造
+ * （一致性向量测试就跑在 Node 里）。DOM / WebRTC 的接触点收敛在 media/ 与 devices/。
+ *
+ * **协议契约在 `im-rtc-server/docs/RTC_PROTOCOL.md`，本仓只读引用**——
+ * 不得单方面加字段。改协议 = 改四个仓 + 同步一致性向量。
+ *
+ * 当前进度（P2 第一刀）：信令帧的编解码与协议常量。
+ * 状态机、WS 客户端、媒体适配器随后落地。
+ */
+export { SDK_VERSION } from './version.js';
+export { ERROR_DEFINITIONS, ErrorCode, RtcError, errorName, isLocalError, isRetryable, isRtcError, lookupError, } from './errors.js';
+/** 宿主可以自己先验一遍生成的 id，不必等到 login() / joinRoom() 才发现（协议 §2.5）。 */
+export { checkDeviceId, checkRoomId } from './protocolId.js';
+export { CallEndReason, GROUP_DOMINANT_PRIORITY, callDurationSec, dominantReason, normalizeReason, } from './reasons.js';
+export { LogField, clearDiagnostics, exportDiagnostics, logger, redact, redactCandidate, redactSdp, setLogClock, setLogLevel, setLogSink, } from './logger.js';
+export { MAX_FRAME_BYTES, OK_SUFFIX, decodeEnvelope, encodeEnvelope, isEvent, okType, } from './signaling/envelope.js';
+export { checkDiscipline } from './signaling/discipline.js';
+export { DEFAULT_TIMEOUT_SEC, LAYERS, MAX_TIMEOUT_SEC, MEDIA_TYPES, MIN_TIMEOUT_SEC, PC_ROLES, REASONS, ROOM_KINDS, TRACK_KINDS, TRACK_SOURCES, } from './signaling/enums.js';
+export { FrameType, REQUEST_TYPES, RESERVED_TYPES, decodeFrame, encodeFrame, isRequestType, isReservedType, knownFrameTypes, lookupFrame, newFrameData, } from './signaling/registry.js';
+export { BACKOFF_STEPS_MS, backoffDelayMs } from './signaling/backoff.js';
+export { CloseCode, shouldReconnect } from './signaling/webSocket.js';
+export { Connection } from './signaling/connection.js';
+export { initialCallContext, reduceCall, synthesizeNetworkEnd } from './state/callMachine.js';
+export { initialRoomContext, reduceRoom, resumeRoom } from './state/roomMachine.js';
+export { initialEngineContext, reduceEngine } from './state/engineMachine.js';
+export { CallEngine } from './engine.js';
+export { EventBus } from './eventBus.js';
+export { EngineBus } from './engineBus.js';
+export { MACHINE_EVENT_NAMES } from './events.js';
+export { WebRTCAdapter } from './media/webrtcAdapter.js';
+export { VideoProfiles, defaultVideoProfile, videoConstraints } from './media/videoProfile.js';
+export { ViewRegistry } from './media/viewRegistry.js';
+export { MediaBridge } from './media/mediaBridge.js';
+export { camelizeArgs, snakeToCamel, toFrameProps } from './signaling/caseMapping.js';
+export { FrameSender } from './signaling/frameSender.js';
+export { parseCandidate } from './signaling/candidate.js';
+export { createConnection } from './signaling/connectionFactory.js';
+export * as frames from './signaling/frames.room.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,+DAA+D;AAC/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,eAAe,EACf,SAAS,EACT,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,SAAS,EACT,cAAc,EACd,cAAc,EACd,OAAO,EACP,MAAM,GACP,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EACL,mBAAmB,EACnB,MAAM,EACN,eAAe,EACf,WAAW,EACX,eAAe,EACf,QAAQ,EACR,OAAO,EACP,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,sBAAsB,CAAC;AAW9B,OAAO,EACL,SAAS,EACT,aAAa,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,GACb,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAGvD,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9F,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpF,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI9E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE/F,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AASpE,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 日志：**engine / uikit / demo 的唯一日志入口**（CONVENTIONS §6）。
+ *
+ * 机制与取舍见 `im-rtc-server/docs/mechanism/LOGGING.md`——那份文档是四仓统一的。
+ * 三条要点：
+ * - **三条管道分开**：诊断日志（这里）/ 业务事件（engine 回调）/ 质量指标（onNetworkQuality）。
+ * - **级别按「谁该被叫醒」分**：断线是 `warn` 不是 `error`（那是常态）；
+ *   `info` 只记状态跃迁，一次通话个位数条。
+ * - **不提供任何兼容桥接**——想打日志只有这一条路。姊妹项目上正是因为有桥接兜底，
+ *   54 处违规才能长期无人察觉。`scripts/check-logging.sh` 会拦住直接用 console 的写法。
+ */
+/** LogLevel 是日志级别。 */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/** LogFields 是结构化字段。 */
+export type LogFields = Readonly<Record<string, unknown>>;
+/** LogSink 接收一条日志。宿主可以替换它把日志接进自己的体系。 */
+export type LogSink = (level: LogLevel, message: string, fields: LogFields) => void;
+/**
+ * LogField 是必带字段的名字，**与服务端 internal/observability 的常量一一对应**。
+ *
+ * 别写字符串字面量：`room_id` / `roomId` / `room` 三种写法同时出现在一份日志里，
+ * 就没法按字段检索了。
+ */
+export declare const LogField: {
+    readonly requestId: "request_id";
+    readonly sessionId: "session_id";
+    readonly roomId: "room_id";
+    readonly callId: "call_id";
+    readonly uid: "uid";
+    readonly deviceId: "device_id";
+    readonly trackId: "track_id";
+    readonly code: "code";
+};
+/** DiagnosticEntry 是环形缓冲里的一条。 */
+export interface DiagnosticEntry {
+    readonly atMs: number;
+    readonly level: LogLevel;
+    readonly message: string;
+    readonly fields: LogFields;
+}
+/** setLogSink 替换日志出口。传 null 恢复默认。 */
+export declare function setLogSink(next: LogSink | null): void;
+/** setLogLevel 设置最低输出级别。生产建议 'info'。 */
+export declare function setLogLevel(level: LogLevel): void;
+/** setLogClock 注入时钟，仅供测试。 */
+export declare function setLogClock(next: (() => number) | null): void;
+/**
+ * exportDiagnostics 导出最近的日志，供宿主做「报告问题」按钮。
+ *
+ * **不受 setLogLevel 影响**：环形缓冲永远记 `info` 及以上，
+ * 否则用户报障时正好没开 debug，等于什么都没有。
+ */
+export declare function exportDiagnostics(): DiagnosticEntry[];
+/** clearDiagnostics 清空环形缓冲（通话结束或宿主登出时）。 */
+export declare function clearDiagnostics(): void;
+/** logger 是日志的公开入口。 */
+export declare const logger: {
+    debug: (message: string, fields?: LogFields) => void;
+    info: (message: string, fields?: LogFields) => void;
+    warn: (message: string, fields?: LogFields) => void;
+    error: (message: string, fields?: LogFields) => void;
+};
+export { redact, redactCandidate, redactSdp } from './redact.js';
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,sBAAsB;AACtB,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,wBAAwB;AACxB,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE1D,wCAAwC;AACxC,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;AAEpF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;CASX,CAAC;AAEX,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B;AAgCD,qCAAqC;AACrC,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAErD;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED,6BAA6B;AAC7B,wBAAgB,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,eAAe,EAAE,CAErD;AAED,2CAA2C;AAC3C,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAYD,uBAAuB;AACvB,eAAO,MAAM,MAAM;qBACA,MAAM,WAAU,SAAS,KAAQ,IAAI;oBACtC,MAAM,WAAU,SAAS,KAAQ,IAAI;oBACrC,MAAM,WAAU,SAAS,KAAQ,IAAI;qBACpC,MAAM,WAAU,SAAS,KAAQ,IAAI;CACvD,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}