@wetspace/wetrtc 3.0.1 → 4.0.0

package/dist/es/signal/signal-manager.js

@@ -0,0 +1,250 @@
+import { createLogger } from "../utils/types";
+const DEFAULT_CONFIG = {
+  negotiationTimeout: 3e4,
+  iceGatheringTimeout: 1e4
+};
+class SignalManager {
+  constructor(channel, pc, fsm, polite, config) {
+    this.channel = channel;
+    this.pc = pc;
+    this.fsm = fsm;
+    this.polite = polite;
+    this.makingOffer = false;
+    this.ignoreOffer = false;
+    this.pendingCandidates = [];
+    this.cleanups = [];
+    this.config = { ...DEFAULT_CONFIG, ...config };
+    this.logger = createLogger();
+    this.setupListeners();
+  }
+  /** 切换 PeerConnection（disconnect / reconnect 后 rebind） */
+  setPeerConnection(pc) {
+    this.teardownListeners();
+    this.pc = pc;
+    this.pendingCandidates = [];
+    this.makingOffer = false;
+    this.ignoreOffer = false;
+    this.setupListeners();
+  }
+  /** 发起协商（创建 offer） */
+  async createOffer() {
+    if (this.fsm.is("connected")) {
+      return this.renegotiateAsOfferer();
+    }
+    this.enterSignaling();
+    try {
+      this.makingOffer = true;
+      const offer = await this.withTimeout(
+        this.pc.createOffer(),
+        this.config.negotiationTimeout,
+        "createOffer timeout"
+      );
+      await this.pc.setLocalDescription(offer);
+      await this.channel.send({
+        type: "offer",
+        sdp: this.pc.localDescription.sdp
+      });
+      this.logger.info("Offer sent");
+    } catch (err) {
+      this.failConnection();
+      throw new Error(`Create offer failed: ${err.message}`);
+    } finally {
+      this.makingOffer = false;
+    }
+  }
+  /** 接收远端 offer 并创建 answer */
+  async handleOffer(sdp) {
+    const offerCollision = this.makingOffer || this.pc.signalingState !== "stable";
+    if (offerCollision) {
+      if (!this.polite) {
+        this.logger.warn("Ignoring colliding offer (impolite peer)");
+        this.ignoreOffer = true;
+        return;
+      }
+      this.logger.info("Rolling back local offer (polite peer)");
+      await this.pc.setLocalDescription({ type: "rollback" });
+    }
+    this.ignoreOffer = false;
+    if (this.fsm.is("connected")) {
+      return this.renegotiateAsAnswerer(sdp);
+    }
+    this.enterSignaling();
+    try {
+      await this.pc.setRemoteDescription({ type: "offer", sdp });
+      await this.flushPendingCandidates();
+      const answer = await this.withTimeout(
+        this.pc.createAnswer(),
+        this.config.negotiationTimeout,
+        "createAnswer timeout"
+      );
+      await this.pc.setLocalDescription(answer);
+      await this.channel.send({
+        type: "answer",
+        sdp: this.pc.localDescription.sdp
+      });
+      this.logger.info("Answer sent");
+    } catch (err) {
+      this.failConnection();
+      throw new Error(`Handle offer failed: ${err.message}`);
+    }
+  }
+  /** 接收远端 answer */
+  async handleAnswer(sdp) {
+    if (this.ignoreOffer)
+      return;
+    if (this.pc.signalingState === "stable") {
+      this.logger.warn("Received answer in stable state, ignoring");
+      return;
+    }
+    await this.pc.setRemoteDescription({ type: "answer", sdp });
+    await this.flushPendingCandidates();
+    this.logger.info("Answer received and set");
+  }
+  /** ICE 候选管理 */
+  async addIceCandidate(candidate) {
+    if (this.pc.remoteDescription) {
+      try {
+        await this.pc.addIceCandidate(new RTCIceCandidate(candidate));
+      } catch (err) {
+        this.logger.warn("Failed to add ICE candidate:", err.message);
+      }
+    } else {
+      this.pendingCandidates.push(candidate);
+    }
+  }
+  dispose() {
+    this.teardownListeners();
+    this.pendingCandidates.length = 0;
+  }
+  // ── private ──
+  async renegotiateAsOfferer() {
+    this.logger.info("Starting renegotiation (offerer)");
+    this.makingOffer = true;
+    try {
+      const offer = await this.pc.createOffer();
+      await this.pc.setLocalDescription(offer);
+      await this.channel.send({
+        type: "offer",
+        sdp: this.pc.localDescription.sdp
+      });
+    } finally {
+      this.makingOffer = false;
+    }
+  }
+  async renegotiateAsAnswerer(sdp) {
+    this.logger.info("Starting renegotiation (answerer)");
+    await this.pc.setRemoteDescription({ type: "offer", sdp });
+    await this.flushPendingCandidates();
+    const answer = await this.pc.createAnswer();
+    await this.pc.setLocalDescription(answer);
+    await this.channel.send({
+      type: "answer",
+      sdp: this.pc.localDescription.sdp
+    });
+  }
+  enterSignaling() {
+    if (this.fsm.is("idle")) {
+      this.fsm.transition("signaling");
+    }
+  }
+  failConnection() {
+    if (!this.fsm.is("failed", "disposed")) {
+      this.fsm.transition("failed");
+    }
+  }
+  setupListeners() {
+    const onIceCandidate = (ev) => {
+      if (ev.candidate) {
+        this.channel.send({
+          type: "ice-candidate",
+          candidate: ev.candidate.toJSON()
+        }).catch((err) => this.logger.warn("Failed to send ICE candidate:", err));
+      }
+    };
+    this.pc.addEventListener("icecandidate", onIceCandidate);
+    const onIceState = () => {
+      this.logger.debug("ICE state:", this.pc.iceConnectionState);
+      switch (this.pc.iceConnectionState) {
+        case "checking":
+          if (this.fsm.is("signaling")) {
+            this.fsm.transition("connecting");
+          }
+          break;
+        case "connected":
+        case "completed":
+          if (this.fsm.is("signaling", "connecting")) {
+            if (this.fsm.is("signaling")) {
+              this.fsm.transition("connecting");
+            }
+            this.fsm.transition("connected");
+          }
+          break;
+        case "disconnected":
+          if (this.fsm.is("connected")) {
+            this.fsm.transition("reconnecting");
+          }
+          break;
+        case "failed":
+          this.fsm.transition("failed");
+          break;
+      }
+    };
+    this.pc.addEventListener("iceconnectionstatechange", onIceState);
+    const unsubMsg = this.channel.onMessage(async (msg) => {
+      switch (msg.type) {
+        case "offer":
+          await this.handleOffer(msg.sdp).catch(
+            (err) => this.logger.error("Handle offer error:", err)
+          );
+          break;
+        case "answer":
+          await this.handleAnswer(msg.sdp).catch(
+            (err) => this.logger.error("Handle answer error:", err)
+          );
+          break;
+        case "ice-candidate":
+          if (msg.candidate) {
+            await this.addIceCandidate(msg.candidate).catch(() => {
+            });
+          }
+          break;
+        case "bye":
+          this.logger.info("Peer sent bye");
+          this.fsm.force("idle");
+          break;
+      }
+    });
+    this.cleanups.push(
+      () => this.pc.removeEventListener("icecandidate", onIceCandidate),
+      () => this.pc.removeEventListener("iceconnectionstatechange", onIceState),
+      unsubMsg
+    );
+  }
+  teardownListeners() {
+    for (const cleanup of this.cleanups)
+      cleanup();
+    this.cleanups.length = 0;
+  }
+  async flushPendingCandidates() {
+    if (this.pendingCandidates.length === 0)
+      return;
+    const batch = [...this.pendingCandidates];
+    this.pendingCandidates.length = 0;
+    await Promise.allSettled(
+      batch.map((c) => this.pc.addIceCandidate(new RTCIceCandidate(c)))
+    );
+  }
+  withTimeout(promise, ms, msg) {
+    return Promise.race([
+      promise,
+      new Promise(
+        (_, reject) => setTimeout(() => reject(new Error(`[SignalManager] ${msg}`)), ms)
+      )
+    ]);
+  }
+}
+export {
+  SignalManager
+};
+
+//# sourceMappingURL=signal-manager.js.map

package/dist/es/signal/signal-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"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","names":[],"ignoreList":[],"sources":["../../../src/signal/signal-manager.ts"],"sourcesContent":["import type { SignalChannel } from './types';\r\nimport { ConnectionStateMachine } from '../fsm';\r\nimport { createLogger, type Logger } from '../utils/types';\r\nimport type { IDisposable } from '../disposable';\r\n\r\nexport interface SignalConfig {\r\n  /** SDP 交换超时 (ms)，默认 30000 */\r\n  negotiationTimeout?: number;\r\n  /** ICE 候选收集超时 (ms)，默认 10000 */\r\n  iceGatheringTimeout?: number;\r\n}\r\n\r\nconst DEFAULT_CONFIG: Required<SignalConfig> = {\r\n  negotiationTimeout: 30_000,\r\n  iceGatheringTimeout: 10_000,\r\n};\r\n\r\n/**\r\n * 信令管理器 — 负责 SDP / ICE 信令的序列化与协商流程\r\n */\r\nexport class SignalManager implements IDisposable {\r\n  private config: Required<SignalConfig>;\r\n  private logger: Logger;\r\n  private makingOffer = false;\r\n  private ignoreOffer = false;\r\n  private pendingCandidates: RTCIceCandidateInit[] = [];\r\n  private cleanups: (() => void)[] = [];\r\n\r\n  constructor(\r\n    private channel: SignalChannel,\r\n    private pc: RTCPeerConnection,\r\n    private fsm: ConnectionStateMachine,\r\n    private polite: boolean,\r\n    config?: SignalConfig,\r\n  ) {\r\n    this.config = { ...DEFAULT_CONFIG, ...config };\r\n    this.logger = createLogger();\r\n    this.setupListeners();\r\n  }\r\n\r\n  /** 切换 PeerConnection（disconnect / reconnect 后 rebind） */\r\n  setPeerConnection(pc: RTCPeerConnection): void {\r\n    this.teardownListeners();\r\n    this.pc = pc;\r\n    this.pendingCandidates = [];\r\n    this.makingOffer = false;\r\n    this.ignoreOffer = false;\r\n    this.setupListeners();\r\n  }\r\n\r\n  /** 发起协商（创建 offer） */\r\n  async createOffer(): Promise<void> {\r\n    if (this.fsm.is('connected')) {\r\n      return this.renegotiateAsOfferer();\r\n    }\r\n\r\n    this.enterSignaling();\r\n\r\n    try {\r\n      this.makingOffer = true;\r\n      const offer = await this.withTimeout(\r\n        this.pc.createOffer(),\r\n        this.config.negotiationTimeout,\r\n        'createOffer timeout',\r\n      );\r\n\r\n      await this.pc.setLocalDescription(offer);\r\n      await this.channel.send({\r\n        type: 'offer',\r\n        sdp: this.pc.localDescription!.sdp,\r\n      });\r\n\r\n      this.logger.info('Offer sent');\r\n    } catch (err) {\r\n      this.failConnection();\r\n      throw new Error(`Create offer failed: ${(err as Error).message}`);\r\n    } finally {\r\n      this.makingOffer = false;\r\n    }\r\n  }\r\n\r\n  /** 接收远端 offer 并创建 answer */\r\n  async handleOffer(sdp: string): Promise<void> {\r\n    const offerCollision =\r\n      this.makingOffer || this.pc.signalingState !== 'stable';\r\n\r\n    if (offerCollision) {\r\n      if (!this.polite) {\r\n        this.logger.warn('Ignoring colliding offer (impolite peer)');\r\n        this.ignoreOffer = true;\r\n        return;\r\n      }\r\n      this.logger.info('Rolling back local offer (polite peer)');\r\n      await this.pc.setLocalDescription({ type: 'rollback' });\r\n    }\r\n\r\n    this.ignoreOffer = false;\r\n\r\n    if (this.fsm.is('connected')) {\r\n      return this.renegotiateAsAnswerer(sdp);\r\n    }\r\n\r\n    this.enterSignaling();\r\n\r\n    try {\r\n      await this.pc.setRemoteDescription({ type: 'offer', sdp });\r\n      await this.flushPendingCandidates();\r\n\r\n      const answer = await this.withTimeout(\r\n        this.pc.createAnswer(),\r\n        this.config.negotiationTimeout,\r\n        'createAnswer timeout',\r\n      );\r\n\r\n      await this.pc.setLocalDescription(answer);\r\n      await this.channel.send({\r\n        type: 'answer',\r\n        sdp: this.pc.localDescription!.sdp,\r\n      });\r\n\r\n      this.logger.info('Answer sent');\r\n    } catch (err) {\r\n      this.failConnection();\r\n      throw new Error(`Handle offer failed: ${(err as Error).message}`);\r\n    }\r\n  }\r\n\r\n  /** 接收远端 answer */\r\n  async handleAnswer(sdp: string): Promise<void> {\r\n    if (this.ignoreOffer) return;\r\n\r\n    if (this.pc.signalingState === 'stable') {\r\n      this.logger.warn('Received answer in stable state, ignoring');\r\n      return;\r\n    }\r\n\r\n    await this.pc.setRemoteDescription({ type: 'answer', sdp });\r\n    await this.flushPendingCandidates();\r\n    this.logger.info('Answer received and set');\r\n  }\r\n\r\n  /** ICE 候选管理 */\r\n  async addIceCandidate(candidate: RTCIceCandidateInit): Promise<void> {\r\n    if (this.pc.remoteDescription) {\r\n      try {\r\n        await this.pc.addIceCandidate(new RTCIceCandidate(candidate));\r\n      } catch (err) {\r\n        this.logger.warn('Failed to add ICE candidate:', (err as Error).message);\r\n      }\r\n    } else {\r\n      this.pendingCandidates.push(candidate);\r\n    }\r\n  }\r\n\r\n  dispose(): void {\r\n    this.teardownListeners();\r\n    this.pendingCandidates.length = 0;\r\n  }\r\n\r\n  // ── private ──\r\n\r\n  private async renegotiateAsOfferer(): Promise<void> {\r\n    this.logger.info('Starting renegotiation (offerer)');\r\n    this.makingOffer = true;\r\n    try {\r\n      const offer = await this.pc.createOffer();\r\n      await this.pc.setLocalDescription(offer);\r\n      await this.channel.send({\r\n        type: 'offer',\r\n        sdp: this.pc.localDescription!.sdp,\r\n      });\r\n    } finally {\r\n      this.makingOffer = false;\r\n    }\r\n  }\r\n\r\n  private async renegotiateAsAnswerer(sdp: string): Promise<void> {\r\n    this.logger.info('Starting renegotiation (answerer)');\r\n    await this.pc.setRemoteDescription({ type: 'offer', sdp });\r\n    await this.flushPendingCandidates();\r\n    const answer = await this.pc.createAnswer();\r\n    await this.pc.setLocalDescription(answer);\r\n    await this.channel.send({\r\n      type: 'answer',\r\n      sdp: this.pc.localDescription!.sdp,\r\n    });\r\n  }\r\n\r\n  private enterSignaling(): void {\r\n    if (this.fsm.is('idle')) {\r\n      this.fsm.transition('signaling');\r\n    }\r\n  }\r\n\r\n  private failConnection(): void {\r\n    if (!this.fsm.is('failed', 'disposed')) {\r\n      this.fsm.transition('failed');\r\n    }\r\n  }\r\n\r\n  private setupListeners(): void {\r\n    const onIceCandidate = (ev: RTCPeerConnectionIceEvent) => {\r\n      if (ev.candidate) {\r\n        this.channel.send({\r\n          type: 'ice-candidate',\r\n          candidate: ev.candidate.toJSON(),\r\n        }).catch(err => this.logger.warn('Failed to send ICE candidate:', err));\r\n      }\r\n    };\r\n    this.pc.addEventListener('icecandidate', onIceCandidate);\r\n\r\n    const onIceState = () => {\r\n      this.logger.debug('ICE state:', this.pc.iceConnectionState);\r\n      switch (this.pc.iceConnectionState) {\r\n        case 'checking':\r\n          if (this.fsm.is('signaling')) {\r\n            this.fsm.transition('connecting');\r\n          }\r\n          break;\r\n        case 'connected':\r\n        case 'completed':\r\n          if (this.fsm.is('signaling', 'connecting')) {\r\n            if (this.fsm.is('signaling')) {\r\n              this.fsm.transition('connecting');\r\n            }\r\n            this.fsm.transition('connected');\r\n          }\r\n          break;\r\n        case 'disconnected':\r\n          if (this.fsm.is('connected')) {\r\n            this.fsm.transition('reconnecting');\r\n          }\r\n          break;\r\n        case 'failed':\r\n          this.fsm.transition('failed');\r\n          break;\r\n      }\r\n    };\r\n    this.pc.addEventListener('iceconnectionstatechange', onIceState);\r\n\r\n    const unsubMsg = this.channel.onMessage(async (msg) => {\r\n      switch (msg.type) {\r\n        case 'offer':\r\n          await this.handleOffer(msg.sdp!).catch(err =>\r\n            this.logger.error('Handle offer error:', err)\r\n          );\r\n          break;\r\n        case 'answer':\r\n          await this.handleAnswer(msg.sdp!).catch(err =>\r\n            this.logger.error('Handle answer error:', err)\r\n          );\r\n          break;\r\n        case 'ice-candidate':\r\n          if (msg.candidate) {\r\n            await this.addIceCandidate(msg.candidate).catch(() => {});\r\n          }\r\n          break;\r\n        case 'bye':\r\n          this.logger.info('Peer sent bye');\r\n          this.fsm.force('idle');\r\n          break;\r\n      }\r\n    });\r\n\r\n    this.cleanups.push(\r\n      () => this.pc.removeEventListener('icecandidate', onIceCandidate),\r\n      () => this.pc.removeEventListener('iceconnectionstatechange', onIceState),\r\n      unsubMsg,\r\n    );\r\n  }\r\n\r\n  private teardownListeners(): void {\r\n    for (const cleanup of this.cleanups) cleanup();\r\n    this.cleanups.length = 0;\r\n  }\r\n\r\n  private async flushPendingCandidates(): Promise<void> {\r\n    if (this.pendingCandidates.length === 0) return;\r\n    const batch = [...this.pendingCandidates];\r\n    this.pendingCandidates.length = 0;\r\n    await Promise.allSettled(\r\n      batch.map(c => this.pc.addIceCandidate(new RTCIceCandidate(c)))\r\n    );\r\n  }\r\n\r\n  private withTimeout<T>(promise: Promise<T>, ms: number, msg: string): Promise<T> {\r\n    return Promise.race([\r\n      promise,\r\n      new Promise<T>((_, reject) =>\r\n        setTimeout(() => reject(new Error(`[SignalManager] ${msg}`)), ms)\r\n      ),\r\n    ]);\r\n  }\r\n}\r\n//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJtYXBwaW5ncyI6IiIsIm5hbWVzIjpbXSwiaWdub3JlTGlzdCI6W10sInNvdXJjZXMiOltdLCJzb3VyY2VzQ29udGVudCI6W119"]}

package/dist/es/signal/types.d.ts

@@ -0,0 +1,26 @@
+import { TypedEmitter } from '../utils/types';
+/** 信令消息体 */
+export interface SignalMessage {
+    type: 'offer' | 'answer' | 'ice-candidate' | 'bye';
+    sdp?: string;
+    candidate?: RTCIceCandidateInit;
+}
+/** 信令通道接口 — 由上层实现（Socket.IO / WebSocket / HTTP 长轮询等） */
+export interface SignalChannel {
+    /** 发送信令到远端 */
+    send(data: SignalMessage): Promise<void>;
+    /** 接收远端信令，返回取消监听的函数 */
+    onMessage(handler: (data: SignalMessage) => void): () => void;
+}
+/** 信令通道事件 */
+export type SignalChannelEvents = {
+    message: (msg: SignalMessage) => void;
+    error: (err: Error) => void;
+    closed: () => void;
+};
+/** 基于 TypedEmitter 的信令通道基类 */
+export declare abstract class BaseSignalChannel extends TypedEmitter<SignalChannelEvents> implements SignalChannel {
+    abstract send(data: SignalMessage): Promise<void>;
+    abstract onMessage(handler: (data: SignalMessage) => void): () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/es/signal/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/signal/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,YAAY;AACZ,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,eAAe,GAAG,KAAK,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,cAAc;IACd,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,uBAAuB;IACvB,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC/D;AAED,aAAa;AACb,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IACtC,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF,8BAA8B;AAC9B,8BAAsB,iBACpB,SAAQ,YAAY,CAAC,mBAAmB,CACxC,YAAW,aAAa;IAExB,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;CACvE"}

package/dist/es/signal/types.js

@@ -0,0 +1,8 @@
+import { TypedEmitter } from "../utils/types";
+class BaseSignalChannel extends TypedEmitter {
+}
+export {
+  BaseSignalChannel
+};
+
+//# sourceMappingURL=types.js.map

package/dist/es/signal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"AAAA,SAAS,oBAAoB;AAyBtB,MAAe,0BACZ,aAEV;AAGA","names":[],"ignoreList":[],"sources":["../../../src/signal/types.ts"],"sourcesContent":["import { TypedEmitter } from '../utils/types';\r\n\r\n/** 信令消息体 */\r\nexport interface SignalMessage {\r\n  type: 'offer' | 'answer' | 'ice-candidate' | 'bye';\r\n  sdp?: string;\r\n  candidate?: RTCIceCandidateInit;\r\n}\r\n\r\n/** 信令通道接口 — 由上层实现（Socket.IO / WebSocket / HTTP 长轮询等） */\r\nexport interface SignalChannel {\r\n  /** 发送信令到远端 */\r\n  send(data: SignalMessage): Promise<void>;\r\n  /** 接收远端信令，返回取消监听的函数 */\r\n  onMessage(handler: (data: SignalMessage) => void): () => void;\r\n}\r\n\r\n/** 信令通道事件 */\r\nexport type SignalChannelEvents = {\r\n  message: (msg: SignalMessage) => void;\r\n  error: (err: Error) => void;\r\n  closed: () => void;\r\n};\r\n\r\n/** 基于 TypedEmitter 的信令通道基类 */\r\nexport abstract class BaseSignalChannel\r\n  extends TypedEmitter<SignalChannelEvents>\r\n  implements SignalChannel\r\n{\r\n  abstract send(data: SignalMessage): Promise<void>;\r\n  abstract onMessage(handler: (data: SignalMessage) => void): () => void;\r\n}//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJtYXBwaW5ncyI6IiIsIm5hbWVzIjpbXSwiaWdub3JlTGlzdCI6W10sInNvdXJjZXMiOltdLCJzb3VyY2VzQ29udGVudCI6W119"]}

package/dist/es/stats/stats-monitor.d.ts

@@ -0,0 +1,32 @@
+import type { IDisposable } from '../disposable';
+import type { StatsMonitorOptions, StatsSnapshot, DiagnosticReport, DiagnosticIssue } from './types';
+export type { StatsMonitorOptions, StatsSnapshot, DiagnosticReport, DiagnosticIssue };
+/**
+ * Stats 监控器 — WebRTC internals 采集 + 诊断
+ */
+export declare class StatsMonitor implements IDisposable {
+    private logger;
+    private options;
+    private pc;
+    private timer;
+    private handlers;
+    private lastSnapshot;
+    private currentInterval;
+    constructor(pc: RTCPeerConnection, options?: StatsMonitorOptions);
+    /** 切换 PeerConnection（disconnect / reconnect 后 rebind） */
+    setPeerConnection(pc: RTCPeerConnection): void;
+    /** 启动采集 */
+    start(): void;
+    /** 停止采集 */
+    stop(): void;
+    /** 获取最近一次快照 */
+    getSnapshot(): StatsSnapshot | null;
+    /** 订阅指标变化 */
+    onStats(handler: (snapshot: StatsSnapshot) => void): () => void;
+    /** 生成诊断报告 */
+    diagnose(): DiagnosticReport;
+    dispose(): void;
+    private collect;
+    private parseStats;
+}
+//# sourceMappingURL=stats-monitor.d.ts.map

package/dist/es/stats/stats-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-monitor.d.ts","sourceRoot":"","sources":["../../../src/stats/stats-monitor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAOtF;;GAEG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,eAAe,CAAS;gBAEpB,EAAE,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAOhE,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI;IAK9C,WAAW;IACX,KAAK,IAAI,IAAI;IAOb,WAAW;IACX,IAAI,IAAI,IAAI;IAKZ,eAAe;IACf,WAAW,IAAI,aAAa,GAAG,IAAI;IAInC,aAAa;IACb,OAAO,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAO/D,aAAa;IACb,QAAQ,IAAI,gBAAgB;IAsE5B,OAAO,IAAI,IAAI;YAQD,OAAO;IAwBrB,OAAO,CAAC,UAAU;CAqEnB"}

package/dist/es/stats/stats-monitor.js

@@ -0,0 +1,191 @@
+import { createLogger, createTimer } from "../utils/types";
+const DEFAULT_OPTIONS = {
+  interval: 2e3,
+  idleInterval: 5e3
+};
+class StatsMonitor {
+  constructor(pc, options) {
+    this.timer = null;
+    this.handlers = [];
+    this.lastSnapshot = null;
+    this.pc = pc;
+    this.options = { ...DEFAULT_OPTIONS, ...options };
+    this.currentInterval = this.options.interval;
+    this.logger = createLogger();
+  }
+  /** 切换 PeerConnection（disconnect / reconnect 后 rebind） */
+  setPeerConnection(pc) {
+    this.pc = pc;
+    this.lastSnapshot = null;
+  }
+  /** 启动采集 */
+  start() {
+    if (this.timer)
+      return;
+    this.timer = createTimer(() => this.collect(), this.currentInterval);
+    this.collect();
+    this.logger.info("StatsMonitor started");
+  }
+  /** 停止采集 */
+  stop() {
+    this.timer?.dispose();
+    this.timer = null;
+  }
+  /** 获取最近一次快照 */
+  getSnapshot() {
+    return this.lastSnapshot;
+  }
+  /** 订阅指标变化 */
+  onStats(handler) {
+    this.handlers.push(handler);
+    return () => {
+      this.handlers = this.handlers.filter((h) => h !== handler);
+    };
+  }
+  /** 生成诊断报告 */
+  diagnose() {
+    if (!this.lastSnapshot) {
+      return { healthy: true, issues: [], summary: "No data collected yet" };
+    }
+    const issues = [];
+    const s = this.lastSnapshot;
+    if (s.packetsLostPercent > 5) {
+      issues.push({
+        severity: "warning",
+        metric: "packetsLostPercent",
+        value: `${s.packetsLostPercent.toFixed(1)}%`,
+        threshold: "5%",
+        suggestion: "考虑降低分辨率或帧率，检查网络稳定性"
+      });
+    }
+    if (s.packetsLostPercent > 15) {
+      issues.push({
+        severity: "error",
+        metric: "packetsLostPercent",
+        value: `${s.packetsLostPercent.toFixed(1)}%`,
+        threshold: "15%",
+        suggestion: "严重丢包，建议切换到 TURN 中继或检查防火墙设置"
+      });
+    }
+    if (s.roundTripTime > 300) {
+      issues.push({
+        severity: "warning",
+        metric: "roundTripTime",
+        value: `${s.roundTripTime.toFixed(0)}ms`,
+        threshold: "300ms",
+        suggestion: "网络延迟较高，影响实时交互体验"
+      });
+    }
+    if (s.iceState === "disconnected" || s.iceState === "failed") {
+      issues.push({
+        severity: "error",
+        metric: "iceState",
+        value: s.iceState,
+        threshold: "connected",
+        suggestion: "连接已断开，检查网络或重启连接"
+      });
+    }
+    if (s.frameRate > 0 && s.frameRate < 15) {
+      issues.push({
+        severity: "warning",
+        metric: "frameRate",
+        value: `${s.frameRate} fps`,
+        threshold: "15 fps",
+        suggestion: "编码帧率过低，尝试降低分辨率"
+      });
+    }
+    const healthy = issues.length === 0;
+    const summary = healthy ? "所有指标正常" : `检测到 ${issues.length} 个问题`;
+    return { healthy, issues, summary };
+  }
+  dispose() {
+    this.stop();
+    this.handlers.length = 0;
+    this.lastSnapshot = null;
+  }
+  // ── private ──
+  async collect() {
+    try {
+      const report = await this.pc.getStats();
+      const snapshot = this.parseStats(report);
+      if (snapshot.connectionState === "connected" && this.currentInterval !== this.options.idleInterval) {
+        this.currentInterval = this.options.idleInterval;
+        this.timer?.dispose();
+        this.timer = createTimer(() => this.collect(), this.currentInterval);
+      }
+      this.lastSnapshot = snapshot;
+      for (const handler of this.handlers) {
+        try {
+          handler(snapshot);
+        } catch {
+        }
+      }
+    } catch (err) {
+    }
+  }
+  parseStats(report) {
+    let bytesSent = 0;
+    let bytesReceived = 0;
+    let packetsLost = 0;
+    let roundTripTime = 0;
+    let jitter = 0;
+    let frameRate = 0;
+    let resolution = "unknown";
+    let codec = "unknown";
+    const statsArray = [];
+    report.forEach((stat) => statsArray.push(stat));
+    for (const stat of statsArray) {
+      switch (stat.type) {
+        case "outbound-rtp":
+          if (stat.kind === "video") {
+            bytesSent += stat.bytesSent ?? 0;
+            packetsLost += stat.packetsLost ?? 0;
+            frameRate = stat.framesPerSecond ?? 0;
+          }
+          break;
+        case "inbound-rtp":
+          if (stat.kind === "video") {
+            bytesReceived += stat.bytesReceived ?? 0;
+            jitter = (stat.jitter ?? 0) * 1e3;
+            frameRate = Math.max(frameRate, stat.framesPerSecond ?? 0);
+            resolution = stat.frameWidth && stat.frameHeight ? `${stat.frameWidth}x${stat.frameHeight}` : resolution;
+          }
+          break;
+        case "remote-inbound-rtp":
+          roundTripTime = (stat.roundTripTime ?? 0) * 1e3;
+          break;
+        case "codec":
+          if (stat.mimeType?.startsWith("video/")) {
+            codec = stat.mimeType;
+          }
+          break;
+        case "candidate-pair":
+          if (stat.state === "succeeded" && stat.nominated) {
+            roundTripTime = roundTripTime || (stat.currentRoundTripTime ?? 0) * 1e3;
+          }
+          break;
+      }
+    }
+    const totalSent = bytesSent;
+    const packetsLostPercent = totalSent > 0 ? packetsLost / (totalSent / 1200 + packetsLost) * 100 : 0;
+    return {
+      timestamp: Date.now(),
+      bytesSent,
+      bytesReceived,
+      packetsLost,
+      packetsLostPercent: Math.round(packetsLostPercent * 100) / 100,
+      roundTripTime: Math.round(roundTripTime),
+      jitter: Math.round(jitter * 100) / 100,
+      frameRate: Math.round(frameRate),
+      resolution,
+      codec: codec.split("/").pop() ?? codec,
+      iceState: this.pc.iceConnectionState,
+      connectionState: this.pc.connectionState
+    };
+  }
+}
+export {
+  StatsMonitor
+};
+
+//# sourceMappingURL=stats-monitor.js.map

package/dist/es/stats/stats-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"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","names":[],"ignoreList":[],"sources":["../../../src/stats/stats-monitor.ts"],"sourcesContent":["import { createLogger, type Logger, createTimer } from '../utils/types';\r\nimport type { IDisposable } from '../disposable';\r\nimport type {\r\n  StatsMonitorOptions,\r\n  StatsSnapshot,\r\n  DiagnosticReport,\r\n  DiagnosticIssue,\r\n} from './types';\r\n\r\nexport type { StatsMonitorOptions, StatsSnapshot, DiagnosticReport, DiagnosticIssue };\r\n\r\nconst DEFAULT_OPTIONS: Required<StatsMonitorOptions> = {\r\n  interval: 2000,\r\n  idleInterval: 5000,\r\n};\r\n\r\n/**\r\n * Stats 监控器 — WebRTC internals 采集 + 诊断\r\n */\r\nexport class StatsMonitor implements IDisposable {\r\n  private logger: Logger;\r\n  private options: Required<StatsMonitorOptions>;\r\n  private pc: RTCPeerConnection;\r\n  private timer: IDisposable | null = null;\r\n  private handlers: ((snapshot: StatsSnapshot) => void)[] = [];\r\n  private lastSnapshot: StatsSnapshot | null = null;\r\n  private currentInterval: number;\r\n\r\n  constructor(pc: RTCPeerConnection, options?: StatsMonitorOptions) {\r\n    this.pc = pc;\r\n    this.options = { ...DEFAULT_OPTIONS, ...options };\r\n    this.currentInterval = this.options.interval;\r\n    this.logger = createLogger();\r\n  }\r\n\r\n  /** 切换 PeerConnection（disconnect / reconnect 后 rebind） */\r\n  setPeerConnection(pc: RTCPeerConnection): void {\r\n    this.pc = pc;\r\n    this.lastSnapshot = null;\r\n  }\r\n\r\n  /** 启动采集 */\r\n  start(): void {\r\n    if (this.timer) return;\r\n    this.timer = createTimer(() => this.collect(), this.currentInterval);\r\n    this.collect(); // 立即采集一次\r\n    this.logger.info('StatsMonitor started');\r\n  }\r\n\r\n  /** 停止采集 */\r\n  stop(): void {\r\n    this.timer?.dispose();\r\n    this.timer = null;\r\n  }\r\n\r\n  /** 获取最近一次快照 */\r\n  getSnapshot(): StatsSnapshot | null {\r\n    return this.lastSnapshot;\r\n  }\r\n\r\n  /** 订阅指标变化 */\r\n  onStats(handler: (snapshot: StatsSnapshot) => void): () => void {\r\n    this.handlers.push(handler);\r\n    return () => {\r\n      this.handlers = this.handlers.filter(h => h !== handler);\r\n    };\r\n  }\r\n\r\n  /** 生成诊断报告 */\r\n  diagnose(): DiagnosticReport {\r\n    if (!this.lastSnapshot) {\r\n      return { healthy: true, issues: [], summary: 'No data collected yet' };\r\n    }\r\n    const issues: DiagnosticIssue[] = [];\r\n    const s = this.lastSnapshot;\r\n\r\n    // 丢包率 > 5%\r\n    if (s.packetsLostPercent > 5) {\r\n      issues.push({\r\n        severity: 'warning',\r\n        metric: 'packetsLostPercent',\r\n        value: `${s.packetsLostPercent.toFixed(1)}%`,\r\n        threshold: '5%',\r\n        suggestion: '考虑降低分辨率或帧率，检查网络稳定性',\r\n      });\r\n    }\r\n\r\n    // 丢包率 > 15%\r\n    if (s.packetsLostPercent > 15) {\r\n      issues.push({\r\n        severity: 'error',\r\n        metric: 'packetsLostPercent',\r\n        value: `${s.packetsLostPercent.toFixed(1)}%`,\r\n        threshold: '15%',\r\n        suggestion: '严重丢包，建议切换到 TURN 中继或检查防火墙设置',\r\n      });\r\n    }\r\n\r\n    // RTT > 300ms\r\n    if (s.roundTripTime > 300) {\r\n      issues.push({\r\n        severity: 'warning',\r\n        metric: 'roundTripTime',\r\n        value: `${s.roundTripTime.toFixed(0)}ms`,\r\n        threshold: '300ms',\r\n        suggestion: '网络延迟较高，影响实时交互体验',\r\n      });\r\n    }\r\n\r\n    // ICE 断开\r\n    if (s.iceState === 'disconnected' || s.iceState === 'failed') {\r\n      issues.push({\r\n        severity: 'error',\r\n        metric: 'iceState',\r\n        value: s.iceState,\r\n        threshold: 'connected',\r\n        suggestion: '连接已断开，检查网络或重启连接',\r\n      });\r\n    }\r\n\r\n    // 帧率过低\r\n    if (s.frameRate > 0 && s.frameRate < 15) {\r\n      issues.push({\r\n        severity: 'warning',\r\n        metric: 'frameRate',\r\n        value: `${s.frameRate} fps`,\r\n        threshold: '15 fps',\r\n        suggestion: '编码帧率过低，尝试降低分辨率',\r\n      });\r\n    }\r\n\r\n    const healthy = issues.length === 0;\r\n    const summary = healthy\r\n      ? '所有指标正常'\r\n      : `检测到 ${issues.length} 个问题`;\r\n\r\n    return { healthy, issues, summary };\r\n  }\r\n\r\n  dispose(): void {\r\n    this.stop();\r\n    this.handlers.length = 0;\r\n    this.lastSnapshot = null;\r\n  }\r\n\r\n  // ── private ──\r\n\r\n  private async collect(): Promise<void> {\r\n    try {\r\n      const report = await this.pc.getStats();\r\n      const snapshot = this.parseStats(report);\r\n\r\n      // 连接后降频\r\n      if (\r\n        snapshot.connectionState === 'connected' &&\r\n        this.currentInterval !== this.options.idleInterval\r\n      ) {\r\n        this.currentInterval = this.options.idleInterval;\r\n        this.timer?.dispose();\r\n        this.timer = createTimer(() => this.collect(), this.currentInterval);\r\n      }\r\n\r\n      this.lastSnapshot = snapshot;\r\n      for (const handler of this.handlers) {\r\n        try { handler(snapshot); } catch {}\r\n      }\r\n    } catch (err) {\r\n      // getStats 失败不中断\r\n    }\r\n  }\r\n\r\n  private parseStats(report: RTCStatsReport): StatsSnapshot {\r\n    let bytesSent = 0;\r\n    let bytesReceived = 0;\r\n    let packetsLost = 0;\r\n    let roundTripTime = 0;\r\n    let jitter = 0;\r\n    let frameRate = 0;\r\n    let resolution = 'unknown';\r\n    let codec = 'unknown';\r\n\r\n    // 使用类型断言处理 RTCStatsReport 的迭代\r\n    const statsArray: any[] = [];\r\n    report.forEach((stat: any) => statsArray.push(stat));\r\n    \r\n    for (const stat of statsArray) {\r\n      switch (stat.type) {\r\n        case 'outbound-rtp':\r\n          if (stat.kind === 'video') {\r\n            bytesSent += stat.bytesSent ?? 0;\r\n            packetsLost += stat.packetsLost ?? 0;\r\n            frameRate = stat.framesPerSecond ?? 0;\r\n          }\r\n          break;\r\n        case 'inbound-rtp':\r\n          if (stat.kind === 'video') {\r\n            bytesReceived += stat.bytesReceived ?? 0;\r\n            jitter = (stat.jitter ?? 0) * 1000; // seconds → ms\r\n            frameRate = Math.max(frameRate, stat.framesPerSecond ?? 0);\r\n            resolution = stat.frameWidth && stat.frameHeight\r\n              ? `${stat.frameWidth}x${stat.frameHeight}`\r\n              : resolution;\r\n          }\r\n          break;\r\n        case 'remote-inbound-rtp':\r\n          roundTripTime = (stat.roundTripTime ?? 0) * 1000;\r\n          break;\r\n        case 'codec':\r\n          if (stat.mimeType?.startsWith('video/')) {\r\n            codec = stat.mimeType;\r\n          }\r\n          break;\r\n        case 'candidate-pair':\r\n          if (stat.state === 'succeeded' && stat.nominated) {\r\n            roundTripTime = roundTripTime || (stat.currentRoundTripTime ?? 0) * 1000;\r\n          }\r\n          break;\r\n      }\r\n    }\r\n\r\n    const totalSent = bytesSent;\r\n    const packetsLostPercent = totalSent > 0\r\n      ? (packetsLost / ((totalSent / 1200) + packetsLost)) * 100\r\n      : 0;\r\n\r\n    return {\r\n      timestamp: Date.now(),\r\n      bytesSent,\r\n      bytesReceived,\r\n      packetsLost,\r\n      packetsLostPercent: Math.round(packetsLostPercent * 100) / 100,\r\n      roundTripTime: Math.round(roundTripTime),\r\n      jitter: Math.round(jitter * 100) / 100,\r\n      frameRate: Math.round(frameRate),\r\n      resolution,\r\n      codec: codec.split('/').pop() ?? codec,\r\n      iceState: this.pc.iceConnectionState,\r\n      connectionState: this.pc.connectionState,\r\n    };\r\n  }\r\n}//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJtYXBwaW5ncyI6IiIsIm5hbWVzIjpbXSwiaWdub3JlTGlzdCI6W10sInNvdXJjZXMiOltdLCJzb3VyY2VzQ29udGVudCI6W119"]}

package/dist/es/stats/types.d.ts

@@ -0,0 +1,33 @@
+export interface StatsMonitorOptions {
+    /** 采集间隔 (ms)，默认 2000 */
+    interval?: number;
+    /** 连接后降频 (ms)，默认 5000 */
+    idleInterval?: number;
+}
+export interface StatsSnapshot {
+    timestamp: number;
+    bytesSent: number;
+    bytesReceived: number;
+    packetsLost: number;
+    packetsLostPercent: number;
+    roundTripTime: number;
+    jitter: number;
+    frameRate: number;
+    resolution: string;
+    codec: string;
+    iceState: RTCIceConnectionState;
+    connectionState: RTCPeerConnectionState;
+}
+export interface DiagnosticReport {
+    healthy: boolean;
+    issues: DiagnosticIssue[];
+    summary: string;
+}
+export interface DiagnosticIssue {
+    severity: 'warning' | 'error';
+    metric: string;
+    value: number | string;
+    threshold: number | string;
+    suggestion: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/es/stats/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/stats/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,qBAAqB,CAAC;IAChC,eAAe,EAAE,sBAAsB,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB"}