@wetspace/wetrtc 3.0.2 → 4.0.0

package/README.md

@@ -1,29 +1,156 @@
-# WetRTC
-
-本工具库是基于 WebRTC 的进一步封装，简化了其 WebRTC 中生涩的 API 的使用. 如果要考虑到兼容性，推荐引入`webrtc-adapter`这个适配库
-
-适配库的安装：
-
-`npm install webrtc-adapter`
-
-[适配库的使用文档地址](https://github.com/webrtchacks/adapter#readme)
-
-在 Electron 应用中是不需要使用适配库的，高版本的 Electron 对该部分支持非常到位
-
-## 1. 下载安装
-
-`npm i @wetspace/wetrtc -S` 或 `yarn add @wetspace/wetrtc`
-
-## 2. 源码地址
-
-[地址链接](https://gitee.com/wetspace/wetrtc)
-
-## 3. Chrome 对 RTC 的测试指标显示地址
-
-**`chrome://webrtc-internals/`**:该地址就是当你开启了 WebRTC 的音视频传输，它就能显示一些通讯中的基本信息，可用于某些功能的调试
-
-## 4. 测试体验工具（音视频通讯）
-
-[安装包地址（windows）](https://pan.baidu.com/s/10tniytcLmS1w7JFooT3Jsg?pwd=pov4)
-
-<!-- 下载地址：[windows 版本]() -->
+# @wetspace/wetrtc
+
+框架无关的 WebRTC 连接库 — 简化 SDP/ICE 协商、媒体管理与 DataChannel，信令传输由你自选。
+
+[![npm version](https://img.shields.io/npm/v/@wetspace/wetrtc)](https://www.npmjs.com/package/@wetspace/wetrtc)
+[![license](https://img.shields.io/npm/l/@wetspace/wetrtc)](./LICENSE)
+
+## 特性
+
+- **框架无关** — 不绑定 React / Vue / Angular，浏览器、Electron、Node.js 均可使用
+- **信令解耦** — 实现 `SignalChannel` 即可接入 WebSocket、Socket.IO、HTTP 长轮询等
+- **完整子系统** — 媒体捕获、DataChannel、连接统计与诊断
+- **Perfect Negotiation** — 内置 `polite` / `impolite` 模式，避免 glare 冲突
+- **低延迟屏幕共享** — H.264 / Opus 偏好、编码参数与 playout delay 调优
+- **自动重连** — 可配置指数退避，ICE 断开后自动恢复
+- **TypeScript** — 完整类型定义与强类型事件
+
+## 安装
+
+```bash
+npm install @wetspace/wetrtc
+# or
+pnpm add @wetspace/wetrtc
+# or
+yarn add @wetspace/wetrtc
+```
+
+### 浏览器兼容性
+
+若需兼容旧版浏览器，建议额外安装 [webrtc-adapter](https://github.com/webrtchacks/adapter)：
+
+```bash
+npm install webrtc-adapter
+```
+
+并在入口最早处引入：
+
+```ts
+import 'webrtc-adapter'
+```
+
+> **Electron** 应用通常无需 adapter，较新版本 Chromium 对 WebRTC 支持已足够完善。
+
+## 快速开始
+
+WetRTC 需要一个**信令通道**交换 SDP 与 ICE。你只需实现 `SignalChannel` 接口：
+
+```ts
+import type { SignalChannel } from '@wetspace/wetrtc'
+
+const ws = new WebSocket('wss://signal.example.com')
+
+export const signal: SignalChannel = {
+  async send(data) {
+    ws.send(JSON.stringify(data))
+  },
+  onMessage(handler) {
+    const listener = (e: MessageEvent) => handler(JSON.parse(e.data))
+    ws.addEventListener('message', listener)
+    return () => ws.removeEventListener('message', listener)
+  },
+}
+```
+
+创建连接并监听远端媒体：
+
+```ts
+import { WetRTC } from '@wetspace/wetrtc'
+
+const rtc = new WetRTC({
+  signal,
+  direction: 'sendrecv',
+  iceServers: [{ urls: 'stun:stun.l.google.com:19302' }],
+})
+
+rtc.on('track', (ev) => {
+  videoEl.srcObject = ev.streams[0]
+})
+
+rtc.on('statechange', (state) => {
+  console.log('connection:', state)
+})
+
+await rtc.connect()
+
+// 使用完毕后释放
+rtc.dispose()
+```
+
+## 连接方向
+
+| 方向 | 说明 |
+|------|------|
+| `sendrecv` | 双向（默认），可发送和接收媒体 |
+| `sendonly` | 仅发送，如屏幕共享主机 |
+| `recvonly` | 仅接收，如手机观看端 |
+
+## 屏幕共享示例
+
+```ts
+const rtc = new WetRTC({
+  signal,
+  direction: 'sendonly',
+  preferredVideoCodec: 'h264',
+  videoEncoding: {
+    maxBitrate: 4_000_000,
+    maxFramerate: 30,
+  },
+})
+
+const stream = await navigator.mediaDevices.getDisplayMedia({ video: true })
+for (const track of stream.getTracks()) {
+  rtc.peerConnection.addTrack(track, stream)
+}
+
+await rtc.connect()
+```
+
+## 主要导出
+
+| 导出 | 说明 |
+|------|------|
+| `WetRTC` | 主入口，门面类 |
+| `SignalManager` | 信令子系统（高级用法） |
+| `MediaManager` | 媒体设备管理 |
+| `DataManager` | DataChannel 与文件传输 |
+| `StatsMonitor` | 连接质量统计 |
+| `applyH264CodecPreference` 等 | 编解码器与编码调优工具 |
+
+完整 API 见[在线文档](https://www.wetspace.top/docs/wetrtc/)。
+
+## 文档
+
+- [快速开始](https://www.wetspace.top/docs/wetrtc/guide/getting-started)
+- [核心概念](https://www.wetspace.top/docs/wetrtc/guide/core-concepts)
+- [信令](https://www.wetspace.top/docs/wetrtc/guide/signaling)
+- [低延迟屏幕共享](https://www.wetspace.top/docs/wetrtc/guide/low-latency-screenshare)
+- [WET 扩展屏](https://www.wetspace.top/docs/wetrtc/wet-screen/) — 基于本库的产品示例
+
+## 开发
+
+```bash
+pnpm install
+pnpm build    # 输出到 dist/
+pnpm test
+```
+
+## 相关链接
+
+- **npm**: https://www.npmjs.com/package/@wetspace/wetrtc
+- **源码**: https://gitee.com/wetspace/wetrtc
+- **文档**: https://www.wetspace.top/docs/wetrtc/
+
+## License
+
+MIT — 详见仓库根目录 [LICENSE](https://gitee.com/wetspace/wetrtc/blob/master/LICENSE)。

package/dist/es/__test__/codec-preference.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it } from "vitest";
+import {
+  sortVideoCodecsH264First,
+  sortAudioCodecsOpusFirst
+} from "../media/codec-preference";
+describe("sortVideoCodecsH264First", () => {
+  it("places H264 codecs before others", () => {
+    const codecs = [
+      { mimeType: "video/VP8", clockRate: 9e4, channels: void 0, sdpFmtpLine: void 0 },
+      { mimeType: "video/H264", clockRate: 9e4, channels: void 0, sdpFmtpLine: "level-asymmetry-allowed=1;packetization-mode=0" },
+      { mimeType: "video/VP9", clockRate: 9e4, channels: void 0, sdpFmtpLine: void 0 },
+      { mimeType: "video/H264", clockRate: 9e4, channels: void 0, sdpFmtpLine: "level-asymmetry-allowed=1;packetization-mode=1" }
+    ];
+    const sorted = sortVideoCodecsH264First(codecs);
+    expect(sorted[0].mimeType).toBe("video/H264");
+    expect(sorted[0].sdpFmtpLine).toContain("packetization-mode=1");
+    expect(sorted[1].mimeType).toBe("video/H264");
+    expect(sorted[2].mimeType).toBe("video/VP8");
+    expect(sorted[3].mimeType).toBe("video/VP9");
+  });
+});
+describe("sortAudioCodecsOpusFirst", () => {
+  it("places Opus codecs before others", () => {
+    const codecs = [
+      { mimeType: "audio/PCMU", clockRate: 8e3, channels: 1, sdpFmtpLine: void 0 },
+      { mimeType: "audio/opus", clockRate: 48e3, channels: 2, sdpFmtpLine: "minptime=10;useinbandfec=1" },
+      { mimeType: "audio/PCMA", clockRate: 8e3, channels: 1, sdpFmtpLine: void 0 }
+    ];
+    const sorted = sortAudioCodecsOpusFirst(codecs);
+    expect(sorted[0].mimeType).toBe("audio/opus");
+    expect(sorted[1].mimeType).toBe("audio/PCMU");
+    expect(sorted[2].mimeType).toBe("audio/PCMA");
+  });
+});
+
+//# sourceMappingURL=codec-preference.test.js.map

package/dist/es/__test__/codec-preference.test.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"AAAA,SAAS,UAAU,QAAQ,UAAU;AACrC;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AAEP,SAAS,4BAA4B,MAAM;AACzC,KAAG,oCAAoC,MAAM;AAC3C,UAAM,SAAS;AAAA,MACb,EAAE,UAAU,aAAa,WAAW,KAAO,UAAU,QAAW,aAAa,OAAU;AAAA,MACvF,EAAE,UAAU,cAAc,WAAW,KAAO,UAAU,QAAW,aAAa,iDAAiD;AAAA,MAC/H,EAAE,UAAU,aAAa,WAAW,KAAO,UAAU,QAAW,aAAa,OAAU;AAAA,MACvF,EAAE,UAAU,cAAc,WAAW,KAAO,UAAU,QAAW,aAAa,iDAAiD;AAAA,IACjI;AAEA,UAAM,SAAS,yBAAyB,MAAM;AAE9C,WAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,YAAY;AAC5C,WAAO,OAAO,CAAC,EAAE,WAAW,EAAE,UAAU,sBAAsB;AAC9D,WAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,YAAY;AAC5C,WAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,WAAW;AAC3C,WAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,WAAW;AAAA,EAC7C,CAAC;AACH,CAAC;AAED,SAAS,4BAA4B,MAAM;AACzC,KAAG,oCAAoC,MAAM;AAC3C,UAAM,SAAS;AAAA,MACb,EAAE,UAAU,cAAc,WAAW,KAAM,UAAU,GAAG,aAAa,OAAU;AAAA,MAC/E,EAAE,UAAU,cAAc,WAAW,MAAO,UAAU,GAAG,aAAa,6BAA6B;AAAA,MACnG,EAAE,UAAU,cAAc,WAAW,KAAM,UAAU,GAAG,aAAa,OAAU;AAAA,IACjF;AAEA,UAAM,SAAS,yBAAyB,MAAM;AAE9C,WAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,YAAY;AAC5C,WAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,YAAY;AAC5C,WAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,YAAY;AAAA,EAC9C,CAAC;AACH,CAAC","names":[],"ignoreList":[],"sources":["../../../src/__test__/codec-preference.test.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest';\r\nimport {\r\n  sortVideoCodecsH264First,\r\n  sortAudioCodecsOpusFirst,\r\n  type VideoRtpCodec,\r\n  type AudioRtpCodec,\r\n} from '../media/codec-preference';\r\n\r\ndescribe('sortVideoCodecsH264First', () => {\r\n  it('places H264 codecs before others', () => {\r\n    const codecs = [\r\n      { mimeType: 'video/VP8', clockRate: 90000, channels: undefined, sdpFmtpLine: undefined },\r\n      { mimeType: 'video/H264', clockRate: 90000, channels: undefined, sdpFmtpLine: 'level-asymmetry-allowed=1;packetization-mode=0' },\r\n      { mimeType: 'video/VP9', clockRate: 90000, channels: undefined, sdpFmtpLine: undefined },\r\n      { mimeType: 'video/H264', clockRate: 90000, channels: undefined, sdpFmtpLine: 'level-asymmetry-allowed=1;packetization-mode=1' },\r\n    ] as VideoRtpCodec[];\r\n\r\n    const sorted = sortVideoCodecsH264First(codecs);\r\n\r\n    expect(sorted[0].mimeType).toBe('video/H264');\r\n    expect(sorted[0].sdpFmtpLine).toContain('packetization-mode=1');\r\n    expect(sorted[1].mimeType).toBe('video/H264');\r\n    expect(sorted[2].mimeType).toBe('video/VP8');\r\n    expect(sorted[3].mimeType).toBe('video/VP9');\r\n  });\r\n});\r\n\r\ndescribe('sortAudioCodecsOpusFirst', () => {\r\n  it('places Opus codecs before others', () => {\r\n    const codecs = [\r\n      { mimeType: 'audio/PCMU', clockRate: 8000, channels: 1, sdpFmtpLine: undefined },\r\n      { mimeType: 'audio/opus', clockRate: 48000, channels: 2, sdpFmtpLine: 'minptime=10;useinbandfec=1' },\r\n      { mimeType: 'audio/PCMA', clockRate: 8000, channels: 1, sdpFmtpLine: undefined },\r\n    ] as AudioRtpCodec[];\r\n\r\n    const sorted = sortAudioCodecsOpusFirst(codecs);\r\n\r\n    expect(sorted[0].mimeType).toBe('audio/opus');\r\n    expect(sorted[1].mimeType).toBe('audio/PCMU');\r\n    expect(sorted[2].mimeType).toBe('audio/PCMA');\r\n  });\r\n});\r\n//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJtYXBwaW5ncyI6IiIsIm5hbWVzIjpbXSwiaWdub3JlTGlzdCI6W10sInNvdXJjZXMiOltdLCJzb3VyY2VzQ29udGVudCI6W119"]}

package/dist/es/__test__/data-manager.test.js

@@ -0,0 +1,60 @@
+import { describe, expect, it, vi } from "vitest";
+import { DataManager } from "../data/data-manager";
+function createChannel(label = "file-test") {
+  const listeners = /* @__PURE__ */ new Map();
+  return {
+    label,
+    readyState: "open",
+    bufferedAmount: 0,
+    bufferedAmountLowThreshold: 0,
+    send: vi.fn(),
+    close: vi.fn(),
+    addEventListener: vi.fn((type, fn) => {
+      if (!listeners.has(type))
+        listeners.set(type, /* @__PURE__ */ new Set());
+      listeners.get(type).add(fn);
+    }),
+    removeEventListener: vi.fn((type, fn) => {
+      listeners.get(type)?.delete(fn);
+    }),
+    onmessage: null,
+    onopen: null,
+    onclose: null,
+    onerror: null
+  };
+}
+function createPc(channel) {
+  return {
+    createDataChannel: vi.fn(() => channel)
+  };
+}
+describe("DataManager", () => {
+  it("receives a complete file", async () => {
+    const channel = createChannel();
+    const manager = new DataManager(createPc(channel));
+    const handler = vi.fn();
+    manager.onFile(handler);
+    manager.createChannel("file-test");
+    channel.onmessage?.({ data: JSON.stringify({
+      type: "file-meta",
+      name: "hello.txt",
+      size: 5,
+      chunks: 1,
+      mimeType: "text/plain"
+    }) });
+    channel.onmessage?.({ data: new Blob(["hello"]) });
+    channel.onmessage?.({ data: JSON.stringify({ type: "file-complete", name: "hello.txt" }) });
+    expect(handler).toHaveBeenCalledTimes(1);
+    const [meta, blob] = handler.mock.calls[0];
+    expect(meta).toEqual({ name: "hello.txt", size: 5, type: "text/plain" });
+    expect(await blob.text()).toBe("hello");
+  });
+  it("rejects sendFile when file exceeds maxFileSize", async () => {
+    const channel = createChannel();
+    const manager = new DataManager(createPc(channel));
+    const file = new File(["too large"], "large.txt");
+    await expect(manager.sendFile(file, { maxFileSize: 1 })).rejects.toThrow(/maxFileSize/);
+  });
+});
+
+//# sourceMappingURL=data-manager.test.js.map

package/dist/es/__test__/data-manager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"AAAA,SAAS,UAAU,QAAQ,IAAI,UAAU;AACzC,SAAS,mBAAmB;AAE5B,SAAS,cAAc,QAAQ,aAA6B;AAC1D,QAAM,YAAY,oBAAI,IAA2C;AACjE,SAAO;AAAA,IACL;AAAA,IACA,YAAY;AAAA,IACZ,gBAAgB;AAAA,IAChB,4BAA4B;AAAA,IAC5B,MAAM,GAAG,GAAG;AAAA,IACZ,OAAO,GAAG,GAAG;AAAA,IACb,kBAAkB,GAAG,GAAG,CAAC,MAAc,OAAiC;AACtE,UAAI,CAAC,UAAU,IAAI,IAAI;AAAG,kBAAU,IAAI,MAAM,oBAAI,IAAI,CAAC;AACvD,gBAAU,IAAI,IAAI,EAAG,IAAI,EAAE;AAAA,IAC7B,CAAC;AAAA,IACD,qBAAqB,GAAG,GAAG,CAAC,MAAc,OAAiC;AACzE,gBAAU,IAAI,IAAI,GAAG,OAAO,EAAE;AAAA,IAChC,CAAC;AAAA,IACD,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,SAAS;AAAA,EACX;AACF;AAEA,SAAS,SAAS,SAA4C;AAC5D,SAAO;AAAA,IACL,mBAAmB,GAAG,GAAG,MAAM,OAAO;AAAA,EACxC;AACF;AAEA,SAAS,eAAe,MAAM;AAC5B,KAAG,4BAA4B,YAAY;AACzC,UAAM,UAAU,cAAc;AAC9B,UAAM,UAAU,IAAI,YAAY,SAAS,OAAO,CAAC;AACjD,UAAM,UAAU,GAAG,GAAG;AAEtB,YAAQ,OAAO,OAAO;AACtB,YAAQ,cAAc,WAAW;AAEjC,YAAQ,YAAY,EAAE,MAAM,KAAK,UAAU;AAAA,MACzC,MAAM;AAAA,MACN,MAAM;AAAA,MACN,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,UAAU;AAAA,IACZ,CAAC,EAAE,CAAiB;AACpB,YAAQ,YAAY,EAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAiB;AACjE,YAAQ,YAAY,EAAE,MAAM,KAAK,UAAU,EAAE,MAAM,iBAAiB,MAAM,YAAY,CAAC,EAAE,CAAiB;AAE1G,WAAO,OAAO,EAAE,sBAAsB,CAAC;AACvC,UAAM,CAAC,MAAM,IAAI,IAAI,QAAQ,KAAK,MAAM,CAAC;AACzC,WAAO,IAAI,EAAE,QAAQ,EAAE,MAAM,aAAa,MAAM,GAAG,MAAM,aAAa,CAAC;AACvE,WAAO,MAAM,KAAK,KAAK,CAAC,EAAE,KAAK,OAAO;AAAA,EACxC,CAAC;AAED,KAAG,kDAAkD,YAAY;AAC/D,UAAM,UAAU,cAAc;AAC9B,UAAM,UAAU,IAAI,YAAY,SAAS,OAAO,CAAC;AACjD,UAAM,OAAO,IAAI,KAAK,CAAC,WAAW,GAAG,WAAW;AAEhD,UAAM,OAAO,QAAQ,SAAS,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,EAAE,QAAQ,QAAQ,aAAa;AAAA,EACxF,CAAC;AACH,CAAC","names":[],"ignoreList":[],"sources":["../../../src/__test__/data-manager.test.ts"],"sourcesContent":["import { describe, expect, it, vi } from 'vitest';\r\nimport { DataManager } from '../data/data-manager';\r\n\r\nfunction createChannel(label = 'file-test'): RTCDataChannel {\r\n  const listeners = new Map<string, Set<(...args: any[]) => void>>();\r\n  return {\r\n    label,\r\n    readyState: 'open',\r\n    bufferedAmount: 0,\r\n    bufferedAmountLowThreshold: 0,\r\n    send: vi.fn(),\r\n    close: vi.fn(),\r\n    addEventListener: vi.fn((type: string, fn: (...args: any[]) => void) => {\r\n      if (!listeners.has(type)) listeners.set(type, new Set());\r\n      listeners.get(type)!.add(fn);\r\n    }),\r\n    removeEventListener: vi.fn((type: string, fn: (...args: any[]) => void) => {\r\n      listeners.get(type)?.delete(fn);\r\n    }),\r\n    onmessage: null,\r\n    onopen: null,\r\n    onclose: null,\r\n    onerror: null,\r\n  } as unknown as RTCDataChannel;\r\n}\r\n\r\nfunction createPc(channel: RTCDataChannel): RTCPeerConnection {\r\n  return {\r\n    createDataChannel: vi.fn(() => channel),\r\n  } as unknown as RTCPeerConnection;\r\n}\r\n\r\ndescribe('DataManager', () => {\r\n  it('receives a complete file', async () => {\r\n    const channel = createChannel();\r\n    const manager = new DataManager(createPc(channel));\r\n    const handler = vi.fn();\r\n\r\n    manager.onFile(handler);\r\n    manager.createChannel('file-test');\r\n\r\n    channel.onmessage?.({ data: JSON.stringify({\r\n      type: 'file-meta',\r\n      name: 'hello.txt',\r\n      size: 5,\r\n      chunks: 1,\r\n      mimeType: 'text/plain',\r\n    }) } as MessageEvent);\r\n    channel.onmessage?.({ data: new Blob(['hello']) } as MessageEvent);\r\n    channel.onmessage?.({ data: JSON.stringify({ type: 'file-complete', name: 'hello.txt' }) } as MessageEvent);\r\n\r\n    expect(handler).toHaveBeenCalledTimes(1);\r\n    const [meta, blob] = handler.mock.calls[0];\r\n    expect(meta).toEqual({ name: 'hello.txt', size: 5, type: 'text/plain' });\r\n    expect(await blob.text()).toBe('hello');\r\n  });\r\n\r\n  it('rejects sendFile when file exceeds maxFileSize', async () => {\r\n    const channel = createChannel();\r\n    const manager = new DataManager(createPc(channel));\r\n    const file = new File(['too large'], 'large.txt');\r\n\r\n    await expect(manager.sendFile(file, { maxFileSize: 1 })).rejects.toThrow(/maxFileSize/);\r\n  });\r\n});\r\n//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJtYXBwaW5ncyI6IiIsIm5hbWVzIjpbXSwiaWdub3JlTGlzdCI6W10sInNvdXJjZXMiOltdLCJzb3VyY2VzQ29udGVudCI6W119"]}

package/dist/es/__test__/fsm.test.js

@@ -0,0 +1,33 @@
+import { describe, it, expect } from "vitest";
+import { ConnectionStateMachine } from "../fsm";
+describe("ConnectionStateMachine", () => {
+  it("starts in idle", () => {
+    const fsm = new ConnectionStateMachine();
+    expect(fsm.state).toBe("idle");
+  });
+  it("allows idle → signaling → connecting → connected", () => {
+    const fsm = new ConnectionStateMachine();
+    fsm.transition("signaling");
+    fsm.transition("connecting");
+    fsm.transition("connected");
+    expect(fsm.state).toBe("connected");
+  });
+  it("throws on illegal transition idle → connected", () => {
+    const fsm = new ConnectionStateMachine();
+    expect(() => fsm.transition("connected")).toThrow(/Invalid state transition/);
+  });
+  it("force sets state without validation", () => {
+    const fsm = new ConnectionStateMachine();
+    fsm.force("connected");
+    expect(fsm.state).toBe("connected");
+  });
+  it("failed can return to idle", () => {
+    const fsm = new ConnectionStateMachine();
+    fsm.transition("signaling");
+    fsm.transition("failed");
+    fsm.transition("idle");
+    expect(fsm.state).toBe("idle");
+  });
+});
+
+//# sourceMappingURL=fsm.test.js.map

package/dist/es/__test__/fsm.test.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"AAAA,SAAS,UAAU,IAAI,cAAc;AACrC,SAAS,8BAA8B;AAEvC,SAAS,0BAA0B,MAAM;AACvC,KAAG,kBAAkB,MAAM;AACzB,UAAM,MAAM,IAAI,uBAAuB;AACvC,WAAO,IAAI,KAAK,EAAE,KAAK,MAAM;AAAA,EAC/B,CAAC;AAED,KAAG,oDAAoD,MAAM;AAC3D,UAAM,MAAM,IAAI,uBAAuB;AACvC,QAAI,WAAW,WAAW;AAC1B,QAAI,WAAW,YAAY;AAC3B,QAAI,WAAW,WAAW;AAC1B,WAAO,IAAI,KAAK,EAAE,KAAK,WAAW;AAAA,EACpC,CAAC;AAED,KAAG,iDAAiD,MAAM;AACxD,UAAM,MAAM,IAAI,uBAAuB;AACvC,WAAO,MAAM,IAAI,WAAW,WAAW,CAAC,EAAE,QAAQ,0BAA0B;AAAA,EAC9E,CAAC;AAED,KAAG,uCAAuC,MAAM;AAC9C,UAAM,MAAM,IAAI,uBAAuB;AACvC,QAAI,MAAM,WAAW;AACrB,WAAO,IAAI,KAAK,EAAE,KAAK,WAAW;AAAA,EACpC,CAAC;AAED,KAAG,6BAA6B,MAAM;AACpC,UAAM,MAAM,IAAI,uBAAuB;AACvC,QAAI,WAAW,WAAW;AAC1B,QAAI,WAAW,QAAQ;AACvB,QAAI,WAAW,MAAM;AACrB,WAAO,IAAI,KAAK,EAAE,KAAK,MAAM;AAAA,EAC/B,CAAC;AACH,CAAC","names":[],"ignoreList":[],"sources":["../../../src/__test__/fsm.test.ts"],"sourcesContent":["import { describe, it, expect } from 'vitest';\r\nimport { ConnectionStateMachine } from '../fsm';\r\n\r\ndescribe('ConnectionStateMachine', () => {\r\n  it('starts in idle', () => {\r\n    const fsm = new ConnectionStateMachine();\r\n    expect(fsm.state).toBe('idle');\r\n  });\r\n\r\n  it('allows idle → signaling → connecting → connected', () => {\r\n    const fsm = new ConnectionStateMachine();\r\n    fsm.transition('signaling');\r\n    fsm.transition('connecting');\r\n    fsm.transition('connected');\r\n    expect(fsm.state).toBe('connected');\r\n  });\r\n\r\n  it('throws on illegal transition idle → connected', () => {\r\n    const fsm = new ConnectionStateMachine();\r\n    expect(() => fsm.transition('connected')).toThrow(/Invalid state transition/);\r\n  });\r\n\r\n  it('force sets state without validation', () => {\r\n    const fsm = new ConnectionStateMachine();\r\n    fsm.force('connected');\r\n    expect(fsm.state).toBe('connected');\r\n  });\r\n\r\n  it('failed can return to idle', () => {\r\n    const fsm = new ConnectionStateMachine();\r\n    fsm.transition('signaling');\r\n    fsm.transition('failed');\r\n    fsm.transition('idle');\r\n    expect(fsm.state).toBe('idle');\r\n  });\r\n});\r\n//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJtYXBwaW5ncyI6IiIsIm5hbWVzIjpbXSwiaWdub3JlTGlzdCI6W10sInNvdXJjZXMiOltdLCJzb3VyY2VzQ29udGVudCI6W119"]}

package/dist/es/__test__/media-manager.test.js

@@ -0,0 +1,41 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { MediaManager } from "../media/media-manager";
+describe("MediaManager", () => {
+  afterEach(() => {
+    vi.unstubAllGlobals();
+  });
+  it("maps display options to getDisplayMedia constraints", async () => {
+    const stream = {};
+    const getDisplayMedia = vi.fn().mockResolvedValue(stream);
+    vi.stubGlobal("navigator", {
+      mediaDevices: {
+        getDisplayMedia,
+        getUserMedia: vi.fn()
+      }
+    });
+    await MediaManager.getDisplayMedia({
+      width: 1920,
+      height: 1080,
+      frameRate: 30,
+      audio: true
+    });
+    expect(getDisplayMedia).toHaveBeenCalledWith({
+      video: { width: 1920, height: 1080, frameRate: 30 },
+      audio: true
+    });
+  });
+  it("instance getDisplayMedia delegates to static implementation", async () => {
+    const stream = {};
+    const getDisplayMedia = vi.fn().mockResolvedValue(stream);
+    vi.stubGlobal("navigator", {
+      mediaDevices: {
+        getDisplayMedia,
+        getUserMedia: vi.fn()
+      }
+    });
+    const media = new MediaManager();
+    await expect(media.getDisplayMedia({ audio: false })).resolves.toBe(stream);
+  });
+});
+
+//# sourceMappingURL=media-manager.test.js.map

package/dist/es/__test__/media-manager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"AAAA,SAAS,WAAW,UAAU,QAAQ,IAAI,UAAU;AACpD,SAAS,oBAAoB;AAE7B,SAAS,gBAAgB,MAAM;AAC7B,YAAU,MAAM;AACd,OAAG,iBAAiB;AAAA,EACtB,CAAC;AAED,KAAG,uDAAuD,YAAY;AACpE,UAAM,SAAS,CAAC;AAChB,UAAM,kBAAkB,GAAG,GAAG,EAAE,kBAAkB,MAAM;AACxD,OAAG,WAAW,aAAa;AAAA,MACzB,cAAc;AAAA,QACZ;AAAA,QACA,cAAc,GAAG,GAAG;AAAA,MACtB;AAAA,IACF,CAAC;AAED,UAAM,aAAa,gBAAgB;AAAA,MACjC,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,WAAW;AAAA,MACX,OAAO;AAAA,IACT,CAAC;AAED,WAAO,eAAe,EAAE,qBAAqB;AAAA,MAC3C,OAAO,EAAE,OAAO,MAAM,QAAQ,MAAM,WAAW,GAAG;AAAA,MAClD,OAAO;AAAA,IACT,CAAC;AAAA,EACH,CAAC;AAED,KAAG,+DAA+D,YAAY;AAC5E,UAAM,SAAS,CAAC;AAChB,UAAM,kBAAkB,GAAG,GAAG,EAAE,kBAAkB,MAAM;AACxD,OAAG,WAAW,aAAa;AAAA,MACzB,cAAc;AAAA,QACZ;AAAA,QACA,cAAc,GAAG,GAAG;AAAA,MACtB;AAAA,IACF,CAAC;AAED,UAAM,QAAQ,IAAI,aAAa;AAC/B,UAAM,OAAO,MAAM,gBAAgB,EAAE,OAAO,MAAM,CAAC,CAAC,EAAE,SAAS,KAAK,MAAM;AAAA,EAC5E,CAAC;AACH,CAAC","names":[],"ignoreList":[],"sources":["../../../src/__test__/media-manager.test.ts"],"sourcesContent":["import { afterEach, describe, expect, it, vi } from 'vitest';\r\nimport { MediaManager } from '../media/media-manager';\r\n\r\ndescribe('MediaManager', () => {\r\n  afterEach(() => {\r\n    vi.unstubAllGlobals();\r\n  });\r\n\r\n  it('maps display options to getDisplayMedia constraints', async () => {\r\n    const stream = {} as MediaStream;\r\n    const getDisplayMedia = vi.fn().mockResolvedValue(stream);\r\n    vi.stubGlobal('navigator', {\r\n      mediaDevices: {\r\n        getDisplayMedia,\r\n        getUserMedia: vi.fn(),\r\n      },\r\n    });\r\n\r\n    await MediaManager.getDisplayMedia({\r\n      width: 1920,\r\n      height: 1080,\r\n      frameRate: 30,\r\n      audio: true,\r\n    });\r\n\r\n    expect(getDisplayMedia).toHaveBeenCalledWith({\r\n      video: { width: 1920, height: 1080, frameRate: 30 },\r\n      audio: true,\r\n    });\r\n  });\r\n\r\n  it('instance getDisplayMedia delegates to static implementation', async () => {\r\n    const stream = {} as MediaStream;\r\n    const getDisplayMedia = vi.fn().mockResolvedValue(stream);\r\n    vi.stubGlobal('navigator', {\r\n      mediaDevices: {\r\n        getDisplayMedia,\r\n        getUserMedia: vi.fn(),\r\n      },\r\n    });\r\n\r\n    const media = new MediaManager();\r\n    await expect(media.getDisplayMedia({ audio: false })).resolves.toBe(stream);\r\n  });\r\n});\r\n//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJtYXBwaW5ncyI6IiIsIm5hbWVzIjpbXSwiaWdub3JlTGlzdCI6W10sInNvdXJjZXMiOltdLCJzb3VyY2VzQ29udGVudCI6W119"]}

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

@@ -0,0 +1,100 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { ConnectionStateMachine } from "../fsm";
+import { SignalManager } from "../signal/signal-manager";
+function createMockPc(overrides = {}) {
+  const listeners = /* @__PURE__ */ new Map();
+  return {
+    signalingState: "stable",
+    localDescription: null,
+    remoteDescription: null,
+    iceConnectionState: "new",
+    addEventListener: vi.fn((type, fn) => {
+      if (!listeners.has(type))
+        listeners.set(type, /* @__PURE__ */ new Set());
+      listeners.get(type).add(fn);
+    }),
+    removeEventListener: vi.fn((type, fn) => {
+      listeners.get(type)?.delete(fn);
+    }),
+    createOffer: vi.fn().mockResolvedValue({ type: "offer", sdp: "mock-offer" }),
+    createAnswer: vi.fn().mockResolvedValue({ type: "answer", sdp: "mock-answer" }),
+    setLocalDescription: vi.fn().mockImplementation(async (desc) => {
+      mock.localDescription = desc;
+    }),
+    setRemoteDescription: vi.fn().mockImplementation(async (desc) => {
+      mock.remoteDescription = desc;
+    }),
+    addIceCandidate: vi.fn().mockResolvedValue(void 0),
+    ...overrides
+  };
+}
+let mock;
+function createSignalChannel() {
+  const handlers = [];
+  return {
+    handlers,
+    send: vi.fn().mockResolvedValue(void 0),
+    onMessage(handler) {
+      handlers.push(handler);
+      return () => {
+        const idx = handlers.indexOf(handler);
+        if (idx >= 0)
+          handlers.splice(idx, 1);
+      };
+    }
+  };
+}
+describe("SignalManager", () => {
+  let fsm;
+  let channel;
+  beforeEach(() => {
+    mock = createMockPc();
+    fsm = new ConnectionStateMachine();
+    channel = createSignalChannel();
+  });
+  it("createOffer sends offer and enters signaling", async () => {
+    const sm = new SignalManager(channel, mock, fsm, true);
+    await sm.createOffer();
+    expect(channel.send).toHaveBeenCalledWith(
+      expect.objectContaining({ type: "offer", sdp: "mock-offer" })
+    );
+    expect(fsm.state).toBe("signaling");
+  });
+  it("createOffer does not repeat signaling transition", async () => {
+    fsm.transition("signaling");
+    const sm = new SignalManager(channel, mock, fsm, true);
+    await expect(sm.createOffer()).resolves.toBeUndefined();
+    expect(fsm.state).toBe("signaling");
+  });
+  it("handleOffer sends answer", async () => {
+    const sm = new SignalManager(channel, mock, fsm, true);
+    await sm.handleOffer("remote-offer-sdp");
+    expect(mock.setRemoteDescription).toHaveBeenCalled();
+    expect(mock.createAnswer).toHaveBeenCalled();
+    expect(channel.send).toHaveBeenCalledWith(
+      expect.objectContaining({ type: "answer" })
+    );
+  });
+  it("setPeerConnection rebinds without throwing", () => {
+    const sm = new SignalManager(channel, mock, fsm, true);
+    const newPc = createMockPc();
+    expect(() => sm.setPeerConnection(newPc)).not.toThrow();
+  });
+  it("impolite peer ignores colliding offer", async () => {
+    mock = createMockPc({ signalingState: "have-local-offer" });
+    const sm = new SignalManager(channel, mock, fsm, false);
+    sm.makingOffer = true;
+    await sm.handleOffer("colliding-offer");
+    expect(mock.setRemoteDescription).not.toHaveBeenCalled();
+  });
+  it("polite peer rolls back colliding offer", async () => {
+    mock = createMockPc({ signalingState: "have-local-offer" });
+    const sm = new SignalManager(channel, mock, fsm, true);
+    sm.makingOffer = true;
+    await sm.handleOffer("colliding-offer");
+    expect(mock.setLocalDescription).toHaveBeenCalledWith({ type: "rollback" });
+    expect(mock.setRemoteDescription).toHaveBeenCalledWith({ type: "offer", sdp: "colliding-offer" });
+  });
+});
+
+//# sourceMappingURL=signal-manager.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"mappings":"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","names":[],"ignoreList":[],"sources":["../../../src/__test__/signal-manager.test.ts"],"sourcesContent":["import { describe, it, expect, vi, beforeEach } from 'vitest';\r\nimport { ConnectionStateMachine } from '../fsm';\r\nimport { SignalManager } from '../signal/signal-manager';\r\nimport type { SignalChannel } from '../signal/types';\r\n\r\nfunction createMockPc(overrides: Partial<RTCPeerConnection> = {}): RTCPeerConnection {\r\n  const listeners = new Map<string, Set<EventListener>>();\r\n  return {\r\n    signalingState: 'stable',\r\n    localDescription: null,\r\n    remoteDescription: null,\r\n    iceConnectionState: 'new',\r\n    addEventListener: vi.fn((type: string, fn: EventListener) => {\r\n      if (!listeners.has(type)) listeners.set(type, new Set());\r\n      listeners.get(type)!.add(fn);\r\n    }),\r\n    removeEventListener: vi.fn((type: string, fn: EventListener) => {\r\n      listeners.get(type)?.delete(fn);\r\n    }),\r\n    createOffer: vi.fn().mockResolvedValue({ type: 'offer', sdp: 'mock-offer' }),\r\n    createAnswer: vi.fn().mockResolvedValue({ type: 'answer', sdp: 'mock-answer' }),\r\n    setLocalDescription: vi.fn().mockImplementation(async (desc) => {\r\n      (mock as any).localDescription = desc;\r\n    }),\r\n    setRemoteDescription: vi.fn().mockImplementation(async (desc) => {\r\n      (mock as any).remoteDescription = desc;\r\n    }),\r\n    addIceCandidate: vi.fn().mockResolvedValue(undefined),\r\n    ...overrides,\r\n  } as unknown as RTCPeerConnection;\r\n}\r\n\r\nlet mock: RTCPeerConnection;\r\n\r\nfunction createSignalChannel(): SignalChannel & { handlers: Array<(msg: unknown) => void> } {\r\n  const handlers: Array<(msg: unknown) => void> = [];\r\n  return {\r\n    handlers,\r\n    send: vi.fn().mockResolvedValue(undefined),\r\n    onMessage(handler: (msg: unknown) => void) {\r\n      handlers.push(handler);\r\n      return () => {\r\n        const idx = handlers.indexOf(handler);\r\n        if (idx >= 0) handlers.splice(idx, 1);\r\n      };\r\n    },\r\n  };\r\n}\r\n\r\ndescribe('SignalManager', () => {\r\n  let fsm: ConnectionStateMachine;\r\n  let channel: ReturnType<typeof createSignalChannel>;\r\n\r\n  beforeEach(() => {\r\n    mock = createMockPc();\r\n    fsm = new ConnectionStateMachine();\r\n    channel = createSignalChannel();\r\n  });\r\n\r\n  it('createOffer sends offer and enters signaling', async () => {\r\n    const sm = new SignalManager(channel, mock, fsm, true);\r\n    await sm.createOffer();\r\n\r\n    expect(channel.send).toHaveBeenCalledWith(\r\n      expect.objectContaining({ type: 'offer', sdp: 'mock-offer' }),\r\n    );\r\n    expect(fsm.state).toBe('signaling');\r\n  });\r\n\r\n  it('createOffer does not repeat signaling transition', async () => {\r\n    fsm.transition('signaling');\r\n    const sm = new SignalManager(channel, mock, fsm, true);\r\n\r\n    await expect(sm.createOffer()).resolves.toBeUndefined();\r\n    expect(fsm.state).toBe('signaling');\r\n  });\r\n\r\n  it('handleOffer sends answer', async () => {\r\n    const sm = new SignalManager(channel, mock, fsm, true);\r\n    await sm.handleOffer('remote-offer-sdp');\r\n\r\n    expect(mock.setRemoteDescription).toHaveBeenCalled();\r\n    expect(mock.createAnswer).toHaveBeenCalled();\r\n    expect(channel.send).toHaveBeenCalledWith(\r\n      expect.objectContaining({ type: 'answer' }),\r\n    );\r\n  });\r\n\r\n  it('setPeerConnection rebinds without throwing', () => {\r\n    const sm = new SignalManager(channel, mock, fsm, true);\r\n    const newPc = createMockPc();\r\n    expect(() => sm.setPeerConnection(newPc)).not.toThrow();\r\n  });\r\n\r\n  it('impolite peer ignores colliding offer', async () => {\r\n    mock = createMockPc({ signalingState: 'have-local-offer' as RTCSignalingState });\r\n    const sm = new SignalManager(channel, mock, fsm, false);\r\n    (sm as any).makingOffer = true;\r\n\r\n    await sm.handleOffer('colliding-offer');\r\n\r\n    expect(mock.setRemoteDescription).not.toHaveBeenCalled();\r\n  });\r\n\r\n  it('polite peer rolls back colliding offer', async () => {\r\n    mock = createMockPc({ signalingState: 'have-local-offer' as RTCSignalingState });\r\n    const sm = new SignalManager(channel, mock, fsm, true);\r\n    (sm as any).makingOffer = true;\r\n\r\n    await sm.handleOffer('colliding-offer');\r\n\r\n    expect(mock.setLocalDescription).toHaveBeenCalledWith({ type: 'rollback' });\r\n    expect(mock.setRemoteDescription).toHaveBeenCalledWith({ type: 'offer', sdp: 'colliding-offer' });\r\n  });\r\n});\r\n//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJtYXBwaW5ncyI6IiIsIm5hbWVzIjpbXSwiaWdub3JlTGlzdCI6W10sInNvdXJjZXMiOltdLCJzb3VyY2VzQ29udGVudCI6W119"]}

package/dist/es/__test__/wetrtc-lifecycle.test.js

@@ -0,0 +1,152 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { WetRTC } from "../wetrtc";
+const pcs = [];
+class MockPeerConnection {
+  constructor() {
+    this.iceConnectionState = "new";
+    this.connectionState = "new";
+    this.signalingState = "stable";
+    this.localDescription = null;
+    this.remoteDescription = null;
+    this.senders = [];
+    this.transceivers = [];
+    this.closed = false;
+    this.addEventListener = vi.fn();
+    this.removeEventListener = vi.fn();
+    this.createDataChannel = vi.fn(() => ({ close: vi.fn(), readyState: "open" }));
+    this.createOffer = vi.fn().mockResolvedValue({ type: "offer", sdp: "offer" });
+    this.createAnswer = vi.fn().mockResolvedValue({ type: "answer", sdp: "answer" });
+    this.setLocalDescription = vi.fn().mockImplementation(async (desc) => {
+      this.localDescription = desc;
+    });
+    this.setRemoteDescription = vi.fn().mockImplementation(async (desc) => {
+      this.remoteDescription = desc;
+    });
+    this.addIceCandidate = vi.fn().mockResolvedValue(void 0);
+    this.getStats = vi.fn().mockResolvedValue({ forEach: vi.fn() });
+    this.close = vi.fn(() => {
+      this.closed = true;
+    });
+    this.getSenders = vi.fn(() => this.senders);
+    this.getTransceivers = vi.fn(() => this.transceivers);
+    this.addTransceiver = vi.fn((kind, init) => {
+      const transceiver = {
+        direction: init?.direction ?? "sendrecv",
+        sender: {},
+        receiver: {},
+        mid: null,
+        currentDirection: null,
+        stop: vi.fn()
+      };
+      this.transceivers.push(transceiver);
+      return transceiver;
+    });
+    this.addTrack = vi.fn((track) => {
+      const sender = {
+        track,
+        replaceTrack: vi.fn().mockResolvedValue(void 0)
+      };
+      const transceiver = {
+        direction: "sendrecv",
+        sender,
+        receiver: {},
+        mid: null,
+        currentDirection: null,
+        stop: vi.fn()
+      };
+      this.senders.push(sender);
+      this.transceivers.push(transceiver);
+      return sender;
+    });
+    this.removeTrack = vi.fn();
+    pcs.push(this);
+  }
+}
+function signal() {
+  return {
+    send: vi.fn().mockResolvedValue(void 0),
+    onMessage: vi.fn(() => () => {
+    })
+  };
+}
+function streamWithTrack(kind = "video") {
+  const track = {
+    id: `${kind}-1`,
+    kind,
+    stop: vi.fn(),
+    addEventListener: vi.fn()
+  };
+  const tracks = [track];
+  const stream = {
+    getTracks: () => tracks,
+    getVideoTracks: () => kind === "video" ? tracks : [],
+    addTrack: vi.fn((next) => {
+      if (!tracks.includes(next))
+        tracks.push(next);
+    }),
+    removeTrack: vi.fn((next) => {
+      const idx = tracks.indexOf(next);
+      if (idx >= 0)
+        tracks.splice(idx, 1);
+    })
+  };
+  return { stream, track };
+}
+describe("WetRTC lifecycle", () => {
+  beforeEach(() => {
+    pcs.length = 0;
+    vi.stubGlobal("RTCPeerConnection", MockPeerConnection);
+  });
+  afterEach(() => {
+    vi.unstubAllGlobals();
+  });
+  it("disconnect rebinds peer connection and restores local tracks", async () => {
+    const channel = signal();
+    const rtc = new WetRTC({ signal: channel, reconnect: false });
+    const { stream, track } = streamWithTrack();
+    const firstPc = rtc.peerConnection;
+    rtc.addTrack(track, stream);
+    await rtc.disconnect();
+    expect(channel.send).toHaveBeenCalledWith({ type: "bye" });
+    const nextPc = rtc.peerConnection;
+    expect(nextPc).not.toBe(firstPc);
+    expect(firstPc.close).toHaveBeenCalled();
+    expect(nextPc.addTrack).toHaveBeenCalledWith(track, stream);
+    expect(rtc.state).toBe("idle");
+  });
+  it("recvonly connect creates recvonly transceivers", async () => {
+    const rtc = new WetRTC({ signal: signal(), direction: "recvonly", reconnect: false });
+    await rtc.connect();
+    const pc = rtc.peerConnection;
+    expect(pc.addTransceiver).toHaveBeenCalledWith("video", { direction: "recvonly" });
+    expect(pc.addTransceiver).toHaveBeenCalledWith("audio", { direction: "recvonly" });
+  });
+  it("recvonly initiator sends offer", async () => {
+    const ch = signal();
+    const rtc = new WetRTC({
+      signal: ch,
+      direction: "recvonly",
+      initiator: true,
+      reconnect: false
+    });
+    await rtc.connect();
+    expect(ch.send).toHaveBeenCalledWith(
+      expect.objectContaining({ type: "offer" })
+    );
+  });
+  it("sendonly passive does not send offer", async () => {
+    const ch = signal();
+    const rtc = new WetRTC({
+      signal: ch,
+      direction: "sendonly",
+      initiator: false,
+      reconnect: false
+    });
+    await rtc.connect();
+    expect(ch.send).not.toHaveBeenCalledWith(
+      expect.objectContaining({ type: "offer" })
+    );
+  });
+});
+
+//# sourceMappingURL=wetrtc-lifecycle.test.js.map