sx-peerjs-http-util 1.0.6 → 1.2.0

package/dist/PeerJsWrapper.d.ts

@@ -0,0 +1,172 @@
+/**
+ * PeerJsWrapper - 封装 PeerJS 为类似 HTTP 的 API
+ *
+ * 核心功能：
+ * 1. 类似 HTTP 的请求/响应机制（send/relaySend）
+ * 2. 语音/视频通话（call/onIncomingCall）
+ * 3. 中继路由（relaySend/getRoutingTable/getKnownNodes）
+ *
+ * @example
+ * // 基本请求
+ * const wrapper = new PeerJsWrapper();
+ * const data = await wrapper.send(peerId, '/api/hello', { name: 'world' });
+ *
+ * // 中继请求
+ * await wrapper.relaySend(targetId, '/api/data', 'test', ['relayNode1', 'relayNode2']);
+ *
+ * // 语音通话
+ * const call = await wrapper.call(peerId, { video: true });
+ */
+import type { Request, Response, SimpleHandler, CallOptions, CallSession, CallState, CallStateListener, IncomingCallEvent, IncomingCallListener, RouteEntry, RelayConfig, RelayMessage, ServerConfig } from './types';
+export declare const VERSION: string;
+/**
+ * PeerJsWrapper 主类
+ * 封装 PeerJS，提供类似 HTTP 的 API
+ */
+export declare class PeerJsWrapper {
+    /** 本地 Peer ID */
+    private myPeerId;
+    /** PeerJS 实例 */
+    private peerInstance;
+    /** 当前活跃的传入连接集合 */
+    private connections;
+    /** 待处理的请求映射表（用于请求-响应匹配） */
+    private pendingRequests;
+    /** 路径处理器映射表 */
+    private simpleHandlers;
+    /** 重连定时器 */
+    private reconnectTimer;
+    /** 是否已销毁 */
+    private isDestroyed;
+    /** 是否开启调试模式 */
+    private isDebug;
+    /** 服务器配置 */
+    private serverConfig?;
+    /** 当前活跃的通话 */
+    private activeCall;
+    /** 来电监听器集合 */
+    private incomingCallListeners;
+    /** 路由管理器 */
+    private router;
+    /** 消息处理器 */
+    private messageHandler;
+    /**
+     * 创建 PeerJsWrapper 实例
+     * @param peerId 可选的 Peer ID，如果不提供则自动生成 UUID
+     * @param isDebug 是否开启调试模式，开启后会打印事件日志
+     * @param server 可选的信令服务器配置，不提供则使用 PeerJS 公共服务器
+     * @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;
+    private whenReady;
+    private waitForReady;
+    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;
+    offIncomingCall(listener: IncomingCallListener): void;
+    getActiveCall(): CallSession | null;
+    private setupMediaConnectionHandlers;
+    private cleanupCall;
+    private handleIncomingCall;
+    registerHandler(path: string, handler: SimpleHandler): void;
+    unregisterHandler(path: string): void;
+    destroy(): void;
+}
+export type { Request, Response, SimpleHandler, CallOptions, CallSession, CallState, CallStateListener, IncomingCallEvent, IncomingCallListener, RouteEntry, RelayConfig, RelayMessage };
+//# sourceMappingURL=PeerJsWrapper.d.ts.map

package/dist/PeerJsWrapper.d.ts.map

@@ -0,0 +1 @@
+{"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"}

package/dist/constants.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 常量定义
+ * 集中管理所有魔法数字和配置值
+ */
+/** 连接超时（毫秒） */
+export declare const CONNECTION_TIMEOUT_MS = 30000;
+/** 发送超时（毫秒） */
+export declare const SEND_TIMEOUT_MS = 10000;
+/** 重连延迟（毫秒） */
+export declare const RECONNECT_DELAY_MS = 1000;
+/** 路由过期时间（毫秒） */
+export declare const ROUTE_EXPIRE_AGE_MS: number;
+/** 路由表容量限制 */
+export declare const MAX_ROUTING_ENTRIES = 50;
+/** 直连节点容量限制 */
+export declare const MAX_DIRECT_NODES = 5;
+/** 路由清理周期（毫秒） */
+export declare const ROUTE_CLEANUP_INTERVAL_MS: number;
+/** 路由广播周期（毫秒） */
+export declare const ROUTE_BROADCAST_INTERVAL_MS: number;
+/** 默认 TTL（Time To Live）- 消息最大跳数 */
+export declare const DEFAULT_TTL = 128;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAe;AACf,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C,eAAe;AACf,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,eAAe;AACf,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,iBAAiB;AACjB,eAAO,MAAM,mBAAmB,QAAgB,CAAC;AAEjD,cAAc;AACd,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,eAAe;AACf,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,iBAAiB;AACjB,eAAO,MAAM,yBAAyB,QAAY,CAAC;AAEnD,iBAAiB;AACjB,eAAO,MAAM,2BAA2B,QAAY,CAAC;AAErD,mCAAmC;AACnC,eAAO,MAAM,WAAW,MAAM,CAAC"}

package/dist/index.d.ts

@@ -1,185 +1,4 @@
-import type { Request, Response, SimpleHandler, CallOptions, CallSession, CallState, CallStateListener, IncomingCallEvent, IncomingCallListener } from './types';
-export declare const VERSION: string;
-/**
- * 服务器配置（PeerJS 信令服务器）
- */
-export interface ServerConfig {
-    host?: string;
-    port?: number;
-    path?: string;
-    secure?: boolean;
-}
-/**
- * PeerJsWrapper - 封装 PeerJS 为类似 HTTP 的 API
- *
- * @example
- * ```js
- * const wrapper = new PeerJsWrapper();
- * const data = await wrapper.send(peerId, '/api/hello', { name: 'world' });
- * console.log(data); // 直接输出响应数据
- *
- * // 服务端注册处理器
- * wrapper.registerHandler('/api/hello', (data) => {
- *   return { message: 'hello' }; // 直接返回数据
- * });
- * ```
- */
-export declare class PeerJsWrapper {
-    /**
-     * 本地 Peer ID，构造时确定（传入或自动生成）
-     */
-    private myPeerId;
-    /**
-     * PeerJS 实例
-     */
-    private peerInstance;
-    /**
-     * 当前活跃的传入连接集合
-     */
-    private connections;
-    /**
-     * 待处理的请求映射表（用于请求-响应匹配）
-     */
-    private pendingRequests;
-    /**
-     * 路径处理器映射表
-     */
-    private simpleHandlers;
-    /**
-     * 重连定时器
-     */
-    private reconnectTimer;
-    /**
-     * 是否已销毁
-     */
-    private isDestroyed;
-    /**
-     * 是否开启调试模式
-     */
-    private isDebug;
-    /**
-     * 服务器配置
-     */
-    private serverConfig?;
-    /**
-     * 当前活跃的通话
-     */
-    private activeCall;
-    /**
-     * 来电监听器集合
-     */
-    private incomingCallListeners;
-    /**
-     * 创建 PeerJsWrapper 实例
-     * @param peerId 可选的 Peer ID，如果不提供则自动生成 UUID
-     * @param isDebug 是否开启调试模式，开启后会打印事件日志
-     * @param server 可选的信令服务器配置，不提供则使用 PeerJS 公共服务器
-     */
-    constructor(peerId?: string, isDebug?: boolean, server?: ServerConfig);
-    /**
-     * 调试日志输出
-     * @param obj 对象名
-     * @param event 事件名
-     * @param data 事件数据
-     */
-    private debugLog;
-    /**
-     * 连接到 PeerJS 服务器
-     */
-    private connect;
-    /**
-     * 设置 Peer 实例的事件处理器
-     */
-    private setupPeerEventHandlers;
-    /**
-     * 安排重连
-     */
-    private scheduleReconnect;
-    /**
-     * 执行重连
-     */
-    private reconnect;
-    /**
-     * 获取当前 Peer ID
-     * @returns string 当前 Peer ID
-     */
-    getPeerId(): string;
-    /**
-     * 等待 Peer 连接就绪（连接到信令服务器）
-     * @returns Promise<void> 当连接成功时 resolve
-     */
-    whenReady(): Promise<void>;
-    /**
-     * 等待 Peer 连接就绪
-     */
-    private waitForReady;
-    /**
-     * 发送请求到指定 Peer
-     * @param peerId 对端设备 ID
-     * @param path 请求路径
-     * @param data 请求数据
-     * @returns Promise<unknown> 返回响应数据（自动拆箱，只返回 data 部分）
-     */
-    send(peerId: string, path: string, data?: unknown): Promise<unknown>;
-    /**
-     * 设置传入连接处理器
-     */
-    private setupIncomingConnectionHandler;
-    /**
-     * 发起语音/视频通话
-     * @param peerId 对端设备 ID
-     * @param options 通话选项
-     * @returns Promise<CallSession> 通话会话对象
-     */
-    call(peerId: string, options?: CallOptions): Promise<CallSession>;
-    /**
-     * 注册来电监听器
-     * @param listener 来电回调函数
-     */
-    onIncomingCall(listener: IncomingCallListener): void;
-    /**
-     * 移除来电监听器
-     * @param listener 来电回调函数
-     */
-    offIncomingCall(listener: IncomingCallListener): void;
-    /**
-     * 获取当前活跃的通话
-     * @returns CallSession | null 当前通话会话，无通话时返回 null
-     */
-    getActiveCall(): CallSession | null;
-    /**
-     * 设置 MediaConnection 事件处理器
-     */
-    private setupMediaConnectionHandlers;
-    /**
-     * 清理通话资源
-     */
-    private cleanupCall;
-    /**
-     * 处理来电
-     */
-    private handleIncomingCall;
-    /**
-     * 注册简化处理器（直接返回数据，自动装箱）
-     * @param path 请求路径
-     * @param handler 处理器函数，接收请求数据，直接返回响应数据
-     */
-    registerHandler(path: string, handler: SimpleHandler): void;
-    /**
-     * 注销简化处理器
-     * @param path 请求路径
-     */
-    unregisterHandler(path: string): void;
-    /**
-     * 内部请求处理方法
-     * @param from 发送者的 Peer ID
-     * @param request 请求数据
-     */
-    private handleRequest;
-    /**
-     * 关闭所有连接并销毁 Peer 实例
-     */
-    destroy(): void;
-}
-export type { Request, Response, SimpleHandler, CallOptions, CallSession, CallState, CallStateListener, IncomingCallEvent, IncomingCallListener };
+export { PeerJsWrapper, VERSION } from './PeerJsWrapper';
+export { initRoutingDB, loadRoutingTable, saveRouteEntry, saveRouteEntries, deleteRouteEntry, loadDirectNodes, saveDirectNode, saveDirectNodes, clearAllRoutingData } from './RoutingDB';
+export type { Request, Response, SimpleHandler, CallOptions, CallSession, CallState, CallStateListener, IncomingCallEvent, IncomingCallListener, RouteEntry, NextHop, DirectNodeLatency, RelayConfig, RelayMessage, ServerConfig } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAIjB,eAAO,MAAM,OAAO,QAAc,CAAC;AAanC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAsID;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAS;IAEzB;;OAEG;IACH,OAAO,CAAC,YAAY,CAAqB;IAEzC;;OAEG;IACH,OAAO,CAAC,WAAW,CAA6B;IAEhD;;OAEG;IACH,OAAO,CAAC,eAAe,CAOnB;IAEJ;;OAEG;IACH,OAAO,CAAC,cAAc,CAAoC;IAE1D;;OAEG;IACH,OAAO,CAAC,cAAc,CAA8C;IAEpE;;OAEG;IACH,OAAO,CAAC,WAAW,CAAS;IAE5B;;OAEG;IACH,OAAO,CAAC,OAAO,CAAU;IAEzB;;OAEG;IACH,OAAO,CAAC,YAAY,CAAC,CAAe;IAEpC;;OAEG;IACH,OAAO,CAAC,UAAU,CAAgC;IAElD;;OAEG;IACH,OAAO,CAAC,qBAAqB,CAAmC;IAEhE;;;;;OAKG;gBACS,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,YAAY;IAOrE;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,OAAO,CAAC,OAAO;IAUf;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2C9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,SAAS;IAmBjB;;;OAGG;IACH,SAAS,IAAI,MAAM;IAInB;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAuFpE;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAuDtC;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAwFjE;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIpD;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIrD;;;OAGG;IACH,aAAa,IAAI,WAAW,GAAG,IAAI;IAInC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAuBpC;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqE1B;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAI3D;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;OAIG;YACW,aAAa;IAe3B;;OAEG;IACH,OAAO,IAAI,IAAI;CAmChB;AAGD,YAAY,EACV,OAAO,EACP,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACrB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,eAAe,EACf,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,OAAO,EACP,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,OAAO,EACP,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC"}