sx-peerjs-http-util 1.1.0 → 1.2.0

package/dist/types.d.ts

@@ -27,17 +27,36 @@ export interface ServerConfig {
 }
 /**
  * 路由表条目
+ * 记录目标节点的可选下一跳列表，每个下一跳都有延迟信息
  */
 export interface RouteEntry {
     /** 目标节点 */
     target: string;
-    /** 下一跳节点 */
-    nextHop: string;
-    /** 跳数 */
+    /** 可选的下一跳列表（按延迟升序排列） */
+    nextHops: NextHop[];
+    /** 跳数（到目标的最小跳数） */
     hops: number;
-    /** 通过哪个节点学到的 */
-    via: string;
-    /** 学习时间戳 */
+    /** 更新时间戳 */
+    timestamp: number;
+}
+/**
+ * 下一跳信息
+ */
+export interface NextHop {
+    /** 下一跳节点 ID */
+    nodeId: string;
+    /** 到目标的延迟（毫秒） */
+    latency: number;
+}
+/**
+ * 直连节点延迟记录
+ */
+export interface DirectNodeLatency {
+    /** 节点 ID */
+    nodeId: string;
+    /** 直连延迟（毫秒） */
+    latency: number;
+    /** 更新时间戳 */
     timestamp: number;
 }
 /**
@@ -52,7 +71,7 @@ export interface RelayConfig {
  */
 export interface RelayMessage {
     /** 消息类型 */
-    type: 'relay-request' | 'relay-response' | 'route-update';
+    type: 'relay-request' | 'relay-response' | 'route-update' | 'route-query' | 'route-response';
     /** 消息 ID */
     id: string;
     /** 原始目标节点 */
@@ -61,6 +80,8 @@ export interface RelayMessage {
     relayPath: string[];
     /** 剩余可用转发节点列表 */
     forwardPath: string[];
+    /** TTL（Time To Live）- 消息存活跳数，防止死循环 */
+    ttl?: number;
     /** 请求数据 */
     request?: Request;
     /** 响应数据 */
@@ -70,6 +91,26 @@ export interface RelayMessage {
         /** 可达节点列表 */
         reachableNodes: string[];
     };
+    /** 路由查询信息 */
+    routeQuery?: {
+        /** 查询的原始发起者 */
+        queryOrigin: string;
+        /** 查询目标节点 */
+        targetNode: string;
+        /** 查询经过的路径（防止循环） */
+        queryPath: string[];
+    };
+    /** 路由查询响应信息 */
+    routeResponse?: {
+        /** 查询的原始发起者 */
+        queryOrigin: string;
+        /** 响应者节点 */
+        responder: string;
+        /** 目标节点 */
+        targetNode: string;
+        /** 到目标的延迟（毫秒） */
+        latency: number;
+    };
 }
 /**
  * 简化处理器函数类型（直接返回数据，自动装箱为 Response）

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sx-peerjs-http-util",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "A browser library that wraps PeerJS with a simple HTTP-like API",
   "main": "dist/index.esm.js",
   "module": "dist/index.esm.js",

package/dist/Routing.d.ts

@@ -1,88 +0,0 @@
-/**
- * RoutingManager - 路由管理模块
- *
- * 负责中继通信的核心功能：
- * - 维护已知的成功通信节点列表（knownNodes）
- * - 维护路由表（routingTable）
- * - 广播路由更新到邻居节点
- * - 处理收到的路由更新消息
- *
- * 路由机制：
- * 1. 每次成功通信后，记录对方节点为已知节点
- * 2. 成功后广播路由更新，告知对方自己可达的节点
- * 3. 收到路由更新后，合并到本地路由表
- *
- * @example
- * const routing = new RoutingManager(callbacks, { maxRelayNodes: 5 });
- * routing.recordSuccessfulNode(peerId);  // 记录成功节点
- * routing.broadcastRouteUpdate();         // 广播路由
- * const table = routing.getRoutingTable(); // 获取路由表
- */
-import type { Peer } from 'peerjs';
-import type { RouteEntry, RelayConfig, RelayMessage } from './types';
-/**
- * 路由管理器回调接口
- */
-export interface RoutingCallbacks {
-    /** 获取本地 Peer ID */
-    getMyPeerId(): string;
-    /** 获取 PeerJS 实例 */
-    getPeerInstance(): Peer | null;
-    /** 调试日志函数 */
-    debugLog: (obj: string, event: string, data?: unknown) => void;
-}
-/**
- * 路由管理器类
- * 负责维护路由表和节点发现
- */
-export declare class RoutingManager {
-    /** 路由表：target -> RouteEntry */
-    private routingTable;
-    /** 已知的成功通信节点列表 */
-    private knownNodes;
-    /** 中继配置 */
-    private relayConfig;
-    /** 回调函数集合 */
-    private callbacks;
-    /**
-     * 创建路由管理器
-     * @param callbacks 回调函数集合
-     * @param relayConfig 中继配置（可选）
-     */
-    constructor(callbacks: RoutingCallbacks, relayConfig?: RelayConfig);
-    /**
-     * 记录成功的通信节点
-     * 将成功通信的节点添加到已知节点列表
-     * @param nodeId 节点 ID
-     */
-    recordSuccessfulNode(nodeId: string): void;
-    /**
-     * 广播路由更新
-     * 向所有已知节点发送路由更新消息，告知它们本节点可达的节点列表
-     */
-    broadcastRouteUpdate(): Promise<void>;
-    /**
-     * 发送路由更新到指定节点
-     * @param targetId 目标节点 ID
-     * @param reachableNodes 可达的节点列表
-     */
-    private sendRouteUpdate;
-    /**
-     * 处理收到的路由更新
-     * 合并对端发来的可达节点信息到本地路由表
-     * @param fromPeerId 发送路由更新的节点 ID
-     * @param message 路由更新消息
-     */
-    handleRouteUpdate(fromPeerId: string, message: RelayMessage): void;
-    /**
-     * 获取路由表（用于调试和显示）
-     * @returns 路由表对象
-     */
-    getRoutingTable(): Record<string, RouteEntry>;
-    /**
-     * 获取已知节点列表
-     * @returns 已知节点 ID 数组
-     */
-    getKnownNodes(): string[];
-}
-//# sourceMappingURL=Routing.d.ts.map

package/dist/Routing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Routing.d.ts","sourceRoot":"","sources":["../src/Routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB;IACnB,WAAW,IAAI,MAAM,CAAC;IACtB,mBAAmB;IACnB,eAAe,IAAI,IAAI,GAAG,IAAI,CAAC;IAC/B,aAAa;IACb,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAChE;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,+BAA+B;IAC/B,OAAO,CAAC,YAAY,CAAiC;IACrD,kBAAkB;IAClB,OAAO,CAAC,UAAU,CAAgB;IAClC,WAAW;IACX,OAAO,CAAC,WAAW,CAAc;IACjC,aAAa;IACb,OAAO,CAAC,SAAS,CAAmB;IAEpC;;;;OAIG;gBACS,SAAS,EAAE,gBAAgB,EAAE,WAAW,CAAC,EAAE,WAAW;IAKlE;;;;OAIG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAe1C;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3C;;;;OAIG;YACW,eAAe;IA2C7B;;;;;OAKG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IA6BlE;;;OAGG;IACH,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAQ7C;;;OAGG;IACH,aAAa,IAAI,MAAM,EAAE;CAG1B"}