sx-peerjs-http-util 1.1.0 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 # sx-peerjs-http-util
 
-一个浏览器端库，将 PeerJS 封装成简单易用的类似 HTTP 的 API，并支持语音/视频通话。
+将 PeerJS 封装成类似 HTTP 的 API，支持语音/视频通话和自动路由。
 
 ## 在线 Demo
 
@@ -11,235 +11,54 @@
 | [语音通话](https://anarckk.github.io/sx-peerjs-http-util/demos/voice-call/index.html) | 一对一语音通话 |
 | [视频通话](https://anarckk.github.io/sx-peerjs-http-util/demos/video-call/index.html) | 一对一视频通话 |
 
-> **提示**：打开两个浏览器窗口，分别选择"身份1"和"身份2"即可开始通信，无需手动复制 Peer ID。
-
-## 特性
-
-- 简单的请求-响应 API，类似 HTTP
-- 基于 PeerJS (WebRTC) 实现 P2P 通信
-- **语音/视频通话**：支持一对一语音和视频通话
-- TypeScript 支持
-- 完整的 E2E 测试
-- **支持 NPM 和 CDN 两种引入方式**
-- **自动断线重连**
-- **可指定或自动生成 Peer ID**
-
 ## 安装
 
-### NPM 方式
-
+**NPM:**
 ```bash
 npm install sx-peerjs-http-util peerjs
 ```
 
-### CDN 方式
-
+**CDN:**
 ```html
-<!-- UMD 版本已内置 PeerJS，只需引入一个文件 -->
 <script src="https://unpkg.com/sx-peerjs-http-util/dist/index.umd.js"></script>
 ```
 
-## 使用方式
-
-### PeerJsWrapper 类
+## 快速开始
 
 ```typescript
 import { PeerJsWrapper } from 'sx-peerjs-http-util';
 
-// 创建实例（不指定 ID 则自动生成 UUID）
 const wrapper = new PeerJsWrapper();
-
-// 或指定 Peer ID
-// const wrapper = new PeerJsWrapper('my-custom-id');
-
-// 等待连接就绪
 await wrapper.whenReady();
 
-// 获取 Peer ID（同步方法）
-const peerId = wrapper.getPeerId();
-console.log('My Peer ID:', peerId);
-```
-
-### 发送请求 (send)
-
-```typescript
-// 发送请求到对端设备
-const data = await wrapper.send('remote-peer-id', '/api/hello', { name: 'world' });
-console.log(data); // 直接输出响应数据（自动拆箱）
-```
-
-### 注册处理器 (registerHandler)
-
-```typescript
-// 服务端注册处理器
+// 注册处理器
 wrapper.registerHandler('/api/hello', (from, data) => {
-  return { message: 'hello', received: data }; // 直接返回数据，自动装箱
+  return { message: 'hello', received: data };
 });
 
-// 注销处理器
-wrapper.unregisterHandler('/api/hello');
+// 发送请求（自动路由）
+const data = await wrapper.send('remote-peer-id', '/api/hello', { name: 'world' });
 ```
 
-### 语音/视频通话
+## 语音/视频通话
 
 ```typescript
-// 发起语音通话
-const callSession = await wrapper.call('remote-peer-id', { video: false });
-
-// 发起视频通话
-// const callSession = await wrapper.call('remote-peer-id', { video: true });
+// 发起通话
+const call = await wrapper.call('remote-peer-id', { video: true });
 
 // 监听来电
-wrapper.onIncomingCall((event) => {
-  console.log('来电:', event.from, event.hasVideo ? '视频' : '语音');
-
-  // 接听
-  const session = await event.answer();
-
-  // 或拒绝
-  // event.reject();
+wrapper.onIncomingCall(async (event) => {
+  const session = await event.answer();  // 接听
+  // 或 event.reject();  // 拒绝
 });
-
-// 获取本地媒体流（立即可用）
-const localStream = callSession.getLocalStream();
-
-// 远程媒体流需要等待 connected 状态
-callSession.onStateChange((state) => {
-  if (state === 'connected') {
-    const remoteStream = callSession.getRemoteStream();
-    // 将 remoteStream 设置到 <audio> 或 <video> 元素
-  }
-});
-
-// 控制通话
-callSession.toggleMute();   // 切换静音
-callSession.toggleVideo();  // 切换视频开关
-callSession.hangUp();       // 挂断
-```
-
-### 销毁实例 (destroy)
-
-```typescript
-wrapper.destroy();
-```
-
-## API 参考
-
-### `new PeerJsWrapper(peerId?: string, isDebug?: boolean, server?: ServerConfig)`
-
-创建 PeerJsWrapper 实例。
-
-- `peerId` (可选): 指定 Peer ID，不提供则自动生成 UUID
-- `isDebug` (可选): 是否开启调试模式，开启后会打印事件日志，格式为 `{对象} {事件名} {事件变量}`
-- `server` (可选): 自定义信令服务器配置，不提供则使用 PeerJS 公共服务器
-  - `host`: 服务器地址
-  - `port`: 端口号
-  - `path`: 路径（如 `/peerjs`）
-  - `secure`: 是否使用 HTTPS/WSS
-
-### `getPeerId(): string`
-
-获取当前 Peer ID（同步方法，立即返回）。
-
-### `whenReady(): Promise<void>`
-
-等待 Peer 连接到信令服务器。
-
-### `send(peerId: string, path: string, data?: unknown): Promise<unknown>`
-
-发送请求到指定 Peer。
-
-- `peerId`: 对端设备 ID
-- `path`: 请求路径
-- `data`: 请求数据 (可选)
-- 返回: 响应数据（自动拆箱，只返回 data 部分）
-
-### `registerHandler(path: string, handler: SimpleHandler): void`
-
-注册路径处理器。
-
-- `path`: 请求路径
-- `handler`: 处理器函数，签名 `(from: string, data?: unknown) => Promise<unknown> | unknown`
-
-### `unregisterHandler(path: string): void`
-
-注销路径处理器。
-
-### `call(peerId: string, options?: CallOptions): Promise<CallSession>`
-
-发起语音/视频通话。
-
-- `peerId`: 对端设备 ID
-- `options`: 通话选项
-  - `video`: 是否启用视频（默认 false）
-  - `metadata`: 自定义元数据
-- 返回: `CallSession` 通话会话对象
-
-### `onIncomingCall(listener: IncomingCallListener): void`
-
-注册来电监听器。
-
-- `listener`: 监听器函数，接收 `IncomingCallEvent` 对象
-
-### `offIncomingCall(listener: IncomingCallListener): void`
-
-移除来电监听器。
-
-### `getActiveCall(): CallSession | null`
-
-获取当前活跃的通话会话。
-
-### `destroy(): void`
-
-关闭所有连接并销毁实例（会自动挂断活跃通话）。
-
-## CallSession 接口
-
-通话会话对象，用于控制通话。
-
-| 属性/方法 | 说明 |
-|-----------|------|
-| `peerId` | 对端的 Peer ID |
-| `hasVideo` | 是否包含视频 |
-| `isConnected` | 是否已连接 |
-| `getLocalStream()` | 获取本地媒体流 |
-| `getRemoteStream()` | 获取远程媒体流 |
-| `toggleMute()` | 切换静音状态，返回新的静音状态 |
-| `toggleVideo()` | 切换视频开关，返回新的视频状态 |
-| `hangUp()` | 挂断通话 |
-| `onStateChange(listener)` | 注册状态变化监听器 |
-| `offStateChange(listener)` | 移除状态变化监听器 |
-
-## IncomingCallEvent 接口
-
-来电事件对象。
-
-| 属性/方法 | 说明 |
-|-----------|------|
-| `from` | 呼叫者的 Peer ID |
-| `hasVideo` | 是否包含视频 |
-| `metadata` | 呼叫者传递的元数据 |
-| `answer()` | 接听来电，返回 `Promise<CallSession>` |
-| `reject()` | 拒绝来电 |
-
-## E2E 测试
-
-```bash
-npm run test:e2e
 ```
 
-## 注意事项
+## API 文档
 
-- 每次请求都会创建新的 Peer 连接，请求完成后会自动清理
-- 请求超时时间为 30 秒
-- 此库仅用于浏览器环境
-- 需要使用 PeerJS 信令服务器（默认使用公共服务器）
-- CDN 版本 (UMD) 已内置 PeerJS，无需额外引入
-- NPM 版本需要单独安装 peerjs 依赖
-- **自动断线重连**：网络断开时会自动尝试重连（每秒重试一次）
-- **语音/视频通话**：同一时间只能有一个活跃通话，通话超时 30 秒无应答自动挂断
+完整 API 文档见 [docs/api.md](docs/api.md)
 
-## 发布
+## 注意
 
-- NPM: https://www.npmjs.com/package/sx-peerjs-http-util
-- CDN: https://unpkg.com/sx-peerjs-http-util/dist/index.umd.js
+- 仅限浏览器环境
+- 请求超时 30 秒
+- 每次请求创建新连接

package/dist/MessageHandler.d.ts

@@ -83,6 +83,14 @@ export declare class MessageHandler {
      * 判断结果是否为错误响应
      */
     private isErrorResponse;
+    /**
+     * 创建连接并发送中继消息的通用方法
+     * @param targetId 目标节点 ID
+     * @param message 要发送的消息
+     * @param extractResponse 从响应消息中提取数据的函数
+     * @returns Promise<Response>
+     */
+    private createConnectionAndSend;
     /**
      * 转发中继请求到下一个节点
      * @param nextHop 下一跳节点 ID

package/dist/MessageHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageHandler.d.ts","sourceRoot":"","sources":["../src/MessageHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mBAAmB;IACnB,WAAW,IAAI,MAAM,CAAC;IACtB,mBAAmB;IACnB,eAAe,IAAI,IAAI,GAAG,IAAI,CAAC;IAC/B,aAAa;IACb,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,eAAe;IACf,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAChD,aAAa;IACb,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/D,iBAAiB;IACjB,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CACrE;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,aAAa;IACb,OAAO,CAAC,SAAS,CAA0B;IAE3C;;;OAGG;gBACS,SAAS,EAAE,uBAAuB;IAI9C;;;;;;;OAOG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOnG;;;;;OAKG;YACW,mBAAmB;IAQjC;;;;;;OAMG;YACW,kBAAkB;IAgDhC;;;;;;OAMG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAUlF;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;OAKG;YACW,YAAY;IAsD1B;;;;;;OAMG;YACW,eAAe;CAgE9B"}
+{"version":3,"file":"MessageHandler.d.ts","sourceRoot":"","sources":["../src/MessageHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG9E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mBAAmB;IACnB,WAAW,IAAI,MAAM,CAAC;IACtB,mBAAmB;IACnB,eAAe,IAAI,IAAI,GAAG,IAAI,CAAC;IAC/B,aAAa;IACb,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,eAAe;IACf,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAChD,aAAa;IACb,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/D,iBAAiB;IACjB,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CACrE;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,aAAa;IACb,OAAO,CAAC,SAAS,CAA0B;IAE3C;;;OAGG;gBACS,SAAS,EAAE,uBAAuB;IAI9C;;;;;;;OAOG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOnG;;;;;OAKG;YACW,mBAAmB;IAQjC;;;;;;OAMG;YACW,kBAAkB;IAuDhC;;;;;;OAMG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAUlF;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAsD/B;;;;;OAKG;YACW,YAAY;IAa1B;;;;;;OAMG;YACW,eAAe;CA2B9B"}

package/dist/PeerJsWrapper.d.ts

@@ -47,7 +47,7 @@ export declare class PeerJsWrapper {
     /** 来电监听器集合 */
     private incomingCallListeners;
     /** 路由管理器 */
-    private routingManager;
+    private router;
     /** 消息处理器 */
     private messageHandler;
     /**
@@ -58,18 +58,104 @@ export declare class PeerJsWrapper {
      * @param relayConfig 可选的中继配置
      */
     constructor(peerId?: string, isDebug?: boolean, server?: ServerConfig, relayConfig?: RelayConfig);
+    /**
+     * 创建实例并等待就绪（语法糖）
+     * @param peerId 可选的 Peer ID
+     * @param isDebug 是否开启调试模式
+     * @param server 可选的信令服务器配置
+     * @param relayConfig 可选的中继配置
+     * @returns Promise<PeerJsWrapper>
+     */
+    static create(peerId?: string, isDebug?: boolean, server?: ServerConfig, relayConfig?: RelayConfig): Promise<PeerJsWrapper>;
     private debugLog;
     private connect;
     private setupPeerEventHandlers;
     private scheduleReconnect;
     private reconnect;
     getPeerId(): string;
-    whenReady(): Promise<void>;
+    private whenReady;
     private waitForReady;
-    relaySend(targetId: string, path: string, data: unknown, relayNodes: string[]): Promise<unknown>;
     getRoutingTable(): Record<string, RouteEntry>;
     getKnownNodes(): string[];
+    /**
+     * 发送中继消息的辅助方法
+     * @param targetId 目标节点 ID
+     * @param message 中继消息
+     */
+    private sendRelayMessage;
+    /**
+     * 尝试直连目标节点
+     * @param targetId 目标节点 ID
+     * @param path 请求路径
+     * @param data 请求数据
+     * @param requestId 请求 ID
+     * @returns Promise<unknown> - 响应数据
+     */
+    private tryDirectConnect;
+    /**
+     * 通过中继节点转发请求
+     * @param nextHopId 下一跳节点 ID
+     * @param targetId 原始目标节点 ID
+     * @param path 请求路径
+     * @param data 请求数据
+     * @returns Promise<unknown> - 响应数据
+     */
+    private relayVia;
+    /**
+     * 自动路由发送
+     *
+     * 1. 查路由表 → 有路由 → 尝试中继 → 全部失败 → 降级直连 → 失败 → 结束
+     * 2. 路由表无目标 → 直连 → 失败 → 结束
+     * @param peerId 目标节点 ID
+     * @param path 请求路径
+     * @param data 请求数据
+     * @returns Promise<unknown> - 响应数据
+     */
     send(peerId: string, path: string, data?: unknown): Promise<unknown>;
+    /**
+     * 处理发送错误
+     * @param peerId 目标节点 ID
+     * @param error 错误对象
+     * @returns Promise
+     */
+    private handleSendError;
+    /**
+     * 降级到直连尝试
+     * @param peerId 目标节点 ID
+     * @param path 请求路径
+     * @param data 请求数据
+     * @param requestId 请求 ID
+     * @returns Promise
+     */
+    private fallbackToDirect;
+    /**
+     * 尝试通过中继链转发
+     * @param targetId 目标节点 ID
+     * @param path 请求路径
+     * @param data 请求数据
+     * @param nextHops 下一跳列表
+     * @param index 当前尝试的下一跳索引
+     * @returns Promise<unknown>
+     */
+    private tryRelayChain;
+    /**
+     * 执行路由发现
+     * @param targetId 目标节点 ID
+     * @param path 请求路径
+     * @param data 请求数据
+     * @param requestId 请求 ID
+     * @returns Promise<unknown>
+     */
+    private performRouteDiscovery;
+    /**
+     * 中继发送（内部方法，不对外暴露）
+     * @param targetId 目标节点 ID
+     * @param path 请求路径
+     * @param data 请求数据
+     * @param relayNodes 手动指定的中继节点（可选，不指定则自动路由）
+     * @returns Promise<unknown>
+     */
+    private relaySend;
     private setupIncomingConnectionHandler;
     call(peerId: string, options?: CallOptions): Promise<CallSession>;
     onIncomingCall(listener: IncomingCallListener): void;

package/dist/PeerJsWrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PeerJsWrapper.d.ts","sourceRoot":"","sources":["../src/PeerJsWrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EACV,OAAO,EACP,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,eAAO,MAAM,OAAO,QAAc,CAAC;AAoCnC;;;GAGG;AACH,qBAAa,aAAa;IACxB,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAS;IACzB,gBAAgB;IAChB,OAAO,CAAC,YAAY,CAAqB;IACzC,kBAAkB;IAClB,OAAO,CAAC,WAAW,CAA6B;IAChD,2BAA2B;IAC3B,OAAO,CAAC,eAAe,CAAqC;IAC5D,eAAe;IACf,OAAO,CAAC,cAAc,CAAoC;IAC1D,YAAY;IACZ,OAAO,CAAC,cAAc,CAA8C;IACpE,YAAY;IACZ,OAAO,CAAC,WAAW,CAAS;IAC5B,eAAe;IACf,OAAO,CAAC,OAAO,CAAU;IACzB,YAAY;IACZ,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,cAAc;IACd,OAAO,CAAC,UAAU,CAAgC;IAClD,cAAc;IACd,OAAO,CAAC,qBAAqB,CAAmC;IAEhE,YAAY;IACZ,OAAO,CAAC,cAAc,CAAiB;IACvC,YAAY;IACZ,OAAO,CAAC,cAAc,CAAiB;IAEvC;;;;;;OAMG;gBACS,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,WAAW;IAsBhG,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,sBAAsB;IAuC9B,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,SAAS;IAgBjB,SAAS,IAAI,MAAM;IAInB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,OAAO,CAAC,YAAY;IA6BpB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IA6EhG,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAI7C,aAAa,IAAI,MAAM,EAAE;IAIzB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAkFpE,OAAO,CAAC,8BAA8B;IA2FtC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IA+EjE,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIpD,eAAe,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIrD,aAAa,IAAI,WAAW,GAAG,IAAI;IAInC,OAAO,CAAC,4BAA4B;IAoBpC,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,kBAAkB;IA6D1B,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAI3D,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC,OAAO,IAAI,IAAI;CAgChB;AAED,YAAY,EACV,OAAO,EACP,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,YAAY,EACb,CAAC"}
+{"version":3,"file":"PeerJsWrapper.d.ts","sourceRoot":"","sources":["../src/PeerJsWrapper.ts"],"names":[],"mappings":"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"}

package/dist/Router.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Router - 路由管理器
+ *
+ * 负责中继通信的核心功能：
+ * - 维护直连节点列表及延迟（directNodes）
+ * - 维护路由表（routingTable）：目标节点 -> 多个下一跳（含延迟）
+ * - 广播路由更新到邻居节点
+ * - 路由发现：当直连和路由表都失败时，广播询问谁能连通目标
+ * - 处理路由查询和响应
+ *
+ * 路由机制：
+ * 1. 每次成功通信后，记录对方节点为直连节点并测量延迟
+ * 2. 成功后广播路由更新，告知对方自己可达的节点
+ * 3. 收到路由更新后，合并到本地路由表
+ * 4. 直连失败且路由表为空时，执行路由发现广播
+ */
+import type { Peer } from 'peerjs';
+import type { RouteEntry, NextHop, DirectNodeLatency, RelayConfig, RelayMessage } from './types';
+/**
+ * 路由管理器回调接口
+ */
+export interface RoutingCallbacks {
+    /** 获取本地 Peer ID */
+    getMyPeerId(): string;
+    /** 获取 PeerJS 实例 */
+    getPeerInstance(): Peer | null;
+    /** 调试日志函数 */
+    debugLog: (obj: string, event: string, data?: unknown) => void;
+    /** 发送中继消息 */
+    sendRelayMessage(targetId: string, message: RelayMessage): Promise<void>;
+    /** 处理路由查询响应 */
+    onRouteDiscoveryResponse?: (targetId: string, latency: number) => void;
+}
+/**
+ * 路由器类
+ * 负责维护路由表、节点发现和自动路由选择
+ */
+export declare class Router {
+    /** 路由表：target -> RouteEntry */
+    private routingTable;
+    /** 直连节点及延迟列表 */
+    private directNodes;
+    /** 中继配置 */
+    private relayConfig;
+    /** 回调函数集合 */
+    private callbacks;
+    /** 等待路由发现响应的 pending 队列 */
+    private pendingRouteQueries;
+    /** 定时清理定时器 */
+    private cleanupTimer;
+    /** 周期广播定时器 */
+    private broadcastTimer;
+    /**
+     * 创建路由管理器
+     * @param callbacks 回调函数集合
+     * @param relayConfig 中继配置（可选）
+     */
+    constructor(callbacks: RoutingCallbacks, relayConfig?: RelayConfig);
+    /**
+     * 初始化路由管理器（从 IndexedDB 加载数据并启动定时任务）
+     */
+    init(): Promise<void>;
+    /**
+     * 从 IndexedDB 加载路由数据
+     */
+    private loadFromDB;
+    /**
+     * 启动定时维护任务
+     */
+    private startMaintenanceTasks;
+    /**
+     * 清理过期路由条目
+     */
+    private cleanupExpiredEntries;
+    /**
+     * 持久化路由表到 IndexedDB
+     */
+    persist(): Promise<void>;
+    /**
+     * 销毁路由管理器（清理定时器）
+     */
+    destroy(): void;
+    /**
+     * 记录成功的直连通信
+     * @param nodeId 节点 ID
+     * @param latency 延迟（毫秒）
+     */
+    recordDirectNode(nodeId: string, latency: number): void;
+    /**
+     * 获取直连节点列表（按延迟升序）
+     * @returns 直连节点列表
+     */
+    getDirectNodes(): DirectNodeLatency[];
+    /**
+     * 检查是否可以直连目标节点
+     * @param targetId 目标节点 ID
+     * @returns 是否可以直连
+     */
+    canReachDirectly(targetId: string): boolean;
+    /**
+     * 获取到直连节点的延迟
+     * @param nodeId 节点 ID
+     * @returns 延迟（毫秒），如果不存在返回 null
+     */
+    getDirectLatency(nodeId: string): number | null;
+    /**
+     * 移除失效的路由（通信失败时调用）
+     * @param nodeId 失效的节点 ID
+     */
+    removeRoute(nodeId: string): void;
+    /**
+     * 检查路由表是否为空
+     * @returns 是否为空
+     */
+    isRoutingTableEmpty(): boolean;
+    /**
+     * 记录成功通信的节点（兼容旧接口）
+     * @param nodeId 节点 ID
+     */
+    recordSuccessfulNode(nodeId: string): void;
+    /**
+     * 广播路由更新
+     * 向所有直连节点发送路由更新消息，告知它们本节点可达的节点列表
+     */
+    broadcastRouteUpdate(): Promise<void>;
+    /**
+     * 获取本节点可达的节点列表
+     * @returns 可达节点数组（直连节点 + 自己）
+     */
+    private getReachableNodes;
+    /**
+     * 发送路由更新到指定节点
+     * @param targetId 目标节点 ID
+     * @param reachableNodes 可达的节点列表
+     */
+    private sendRouteUpdate;
+    /**
+     * 处理收到的路由更新
+     * 合并对端发来的可达节点信息到本地路由表
+     * @param fromPeerId 发送路由更新的节点 ID
+     * @param message 路由更新消息
+     */
+    handleRouteUpdate(fromPeerId: string, message: RelayMessage): void;
+    /**
+     * 执行路由发现广播
+     * 当直连和路由表都失败时，向所有直连节点广播询问谁能连通目标
+     * @param targetId 目标节点 ID
+     * @returns 路由条目（如果发现）
+     */
+    discoverRoute(targetId: string): Promise<RouteEntry | null>;
+    /**
+     * 处理路由查询消息
+     * @param fromPeerId 发送查询的节点
+     * @param message 路由查询消息
+     */
+    handleRouteQuery(fromPeerId: string, message: RelayMessage): void;
+    /**
+     * 处理路由查询响应
+     * @param fromPeerId 响应者节点
+     * @param message 路由响应消息
+     */
+    handleRouteResponse(fromPeerId: string, message: RelayMessage): void;
+    /**
+     * 查找到目标节点的下一跳
+     * @param targetId 目标节点 ID
+     * @returns 下一跳信息，如果没有则返回 null
+     */
+    findNextHopToTarget(targetId: string): NextHop | null;
+    /**
+     * 获取到目标节点的所有下一跳（按延迟升序）
+     * @param targetId 目标节点 ID
+     * @returns 下一跳列表
+     */
+    getNextHopsToTarget(targetId: string): NextHop[];
+    /**
+     * 获取路由表
+     * @returns 路由表对象
+     */
+    getRoutingTable(): Record<string, RouteEntry>;
+    /**
+     * 获取已知节点列表（兼容旧接口）
+     * @returns 节点 ID 数组
+     */
+    getKnownNodes(): string[];
+}
+//# sourceMappingURL=Router.d.ts.map

package/dist/Router.d.ts.map

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

package/dist/RoutingDB.d.ts

@@ -0,0 +1,75 @@
+/**
+ * RoutingDB.ts - 路由表 IndexedDB 持久化模块
+ *
+ * 提供路由表的持久化存储功能，使用 IndexedDB 而非 localStorage
+ * 以支持大规模路由表存储
+ *
+ * 数据库结构：
+ * - peerjs-routing-db (版本 1)
+ *   - routing-table: 路由表条目 (keyPath: target)
+ *   - direct-nodes: 直连节点 (keyPath: nodeId)
+ */
+import type { RouteEntry, DirectNodeLatency } from './types';
+/**
+ * 初始化数据库
+ * @returns Promise<void>
+ */
+export declare function initRoutingDB(): Promise<void>;
+/**
+ * 保存路由表条目
+ * @param entry 路由表条目
+ */
+export declare function saveRouteEntry(entry: RouteEntry): Promise<void>;
+/**
+ * 批量保存路由表条目
+ * @param entries 路由表条目数组
+ */
+export declare function saveRouteEntries(entries: RouteEntry[]): Promise<void>;
+/**
+ * 删除路由表条目
+ * @param target 目标节点 ID
+ */
+export declare function deleteRouteEntry(target: string): Promise<void>;
+/**
+ * 加载全部路由表
+ * @returns Promise<RouteEntry[]>
+ */
+export declare function loadRoutingTable(): Promise<RouteEntry[]>;
+/**
+ * 清理过期路由表条目
+ * @param maxAgeMs 最大保留时间（毫秒），默认 5 分钟
+ * @returns Promise<number> 删除的条目数量
+ */
+export declare function cleanupExpiredRoutes(maxAgeMs?: number): Promise<number>;
+/**
+ * 保存直连节点
+ * @param node 直连节点
+ */
+export declare function saveDirectNode(node: DirectNodeLatency): Promise<void>;
+/**
+ * 批量保存直连节点
+ * @param nodes 直连节点数组
+ */
+export declare function saveDirectNodes(nodes: DirectNodeLatency[]): Promise<void>;
+/**
+ * 加载全部直连节点
+ * @returns Promise<DirectNodeLatency[]>
+ */
+export declare function loadDirectNodes(): Promise<DirectNodeLatency[]>;
+/**
+ * 删除直连节点
+ * @param nodeId 节点 ID
+ */
+export declare function deleteDirectNode(nodeId: string): Promise<void>;
+/**
+ * 清理过期直连节点
+ * @param maxAgeMs 最大保留时间（毫秒），默认 5 分钟
+ * @returns Promise<number> 删除的节点数量
+ */
+export declare function cleanupExpiredNodes(maxAgeMs?: number): Promise<number>;
+/**
+ * 清除全部路由数据
+ * @returns Promise<void>
+ */
+export declare function clearAllRoutingData(): Promise<void>;
+//# sourceMappingURL=RoutingDB.d.ts.map

package/dist/RoutingDB.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoutingDB.d.ts","sourceRoot":"","sources":["../src/RoutingDB.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AA+E7D;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAc3E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAE9D;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,GAAE,MAA4B,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBlG;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAc/E;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAEpE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,GAAE,MAA4B,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBjG;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBzD"}