rdsh-gateway 0.8.1 → 0.8.3

package/dist/join.d.ts

@@ -62,6 +62,16 @@ export interface StartJoinOptions {
     name?: string;
     /** 宿主代持的 dsh 浏览器会话 cookie（`dsh-auth-*`，0.1.2+）；有值时注入隧道→本地转发 */
     dshAuthCookieHeader?: string | null;
+    /**
+     * 心跳间隔（缺省 30s，协议 PROTOCOL.md「心跳与重连」）。
+     * 测试可注入毫秒级小值以快速验证超时判定。
+     */
+    heartbeatMs?: number;
+    /**
+     * 发出 PING 后等待对端任何帧的上限（缺省 10s）；超时即判连接已死并主动断开。
+     * 测试可注入小值。
+     */
+    pongTimeoutMs?: number;
 }
 /** 可停止的 join 隧道句柄。 */
 export interface JoinHandle {

package/dist/join.js

@@ -41,6 +41,8 @@ export async function detectInsecure(hubUrl) {
     }
 }
 const HEARTBEAT_MS = 30_000;
+/** 发出 PING 后等待对端任何帧的上限：超时即判连接已死并主动断开（协议 PROTOCOL.md）。 */
+const PONG_TIMEOUT_MS = 10_000;
 const RECONNECT_BASE_MS = 1_000;
 const RECONNECT_MAX_MS = 60_000;
 /** hub HTTP 调用（node:https 支持自签跳过校验 —— undici fetch 不受 NODE_TLS_REJECT_UNAUTHORIZED 影响）。 */
@@ -212,7 +214,13 @@ export function startJoin(opts) {
     let shuttingDown = false;
     let reconnectDelay = RECONNECT_BASE_MS;
     let heartbeat;
+    /** 发出 PING 后的存活死线：期间收到**任何**入站帧即撤销（PROTOCOL.md 心跳与重连）。 */
+    let livenessDeadline;
     let currentClient;
+    const heartbeatMs = opts.heartbeatMs ?? HEARTBEAT_MS;
+    const pongTimeoutMs = opts.pongTimeoutMs ?? PONG_TIMEOUT_MS;
+    /** 日志用人类可读单位：生产 30000ms → "30s"；测试注入的毫秒值原样显示。 */
+    const heartbeatLabel = heartbeatMs % 1000 === 0 ? `${heartbeatMs / 1000}s` : `${heartbeatMs}ms`;
     /** 发送一个隧道帧（走当前隧道 WS；flags 由调用方在 encodeFrame 时给定）。 */
     function sendTunnelFrame(frame) {
         if (currentClient !== undefined && currentClient.readyState === currentClient.OPEN) {
@@ -597,6 +605,10 @@ export function startJoin(opts) {
             clearInterval(heartbeat);
             heartbeat = undefined;
         }
+        if (livenessDeadline !== undefined) {
+            clearTimeout(livenessDeadline);
+            livenessDeadline = undefined;
+        }
         plainDispatcher.cleanup();
         for (const raw of rawStreams.values())
             raw.inner.cleanup();
@@ -626,18 +638,38 @@ export function startJoin(opts) {
         client.on("open", () => {
             reconnectDelay = RECONNECT_BASE_MS;
             setState("connected");
-            log("info", "tunnel established (heartbeat 30s)");
+            log("info", `tunnel established (heartbeat ${heartbeatLabel})`);
             if (heartbeat !== undefined)
                 clearInterval(heartbeat);
             heartbeat = setInterval(() => {
                 if (client.readyState === client.OPEN) {
                     client.send(encodeFrame(FRAME_TYPE.PING, 0, jsonPayload({ ts: Date.now() })));
+                    // 发出 PING 后武装死线：pongTimeoutMs 内收到任何入站帧即撤销（下方 message 处理）。
+                    // 只在**没有未决死线**时武装——上一发 PING 未获回应时原死线继续计时，不重置。
+                    if (livenessDeadline === undefined) {
+                        livenessDeadline = setTimeout(() => {
+                            livenessDeadline = undefined;
+                            log("info", `heartbeat timeout — no frame from hub within ${pongTimeoutMs}ms; reconnecting`);
+                            try {
+                                client.terminate();
+                            }
+                            catch {
+                                /* 已关闭 */
+                            }
+                        }, pongTimeoutMs);
+                        livenessDeadline.unref?.();
+                    }
                 }
-            }, HEARTBEAT_MS);
+            }, heartbeatMs);
         });
         client.on("message", (data, isBinary) => {
             if (!isBinary)
                 return;
+            // 任何入站帧都是存活证据 → 撤销死线（不限于 PONG）
+            if (livenessDeadline !== undefined) {
+                clearTimeout(livenessDeadline);
+                livenessDeadline = undefined;
+            }
             const chunk = Array.isArray(data)
                 ? Buffer.concat(data)
                 : Buffer.isBuffer(data)

package/dist/spawn-dsh.d.ts

@@ -40,9 +40,12 @@ export declare function compareDshVersions(a: string, b: string): number;
 /**
  * remote-dsh 已实测兼容的 dsh 版本窗口（registry 实存版本定界）。
  * ⚠️ 适配新的 dsh 版本并真机实测后，须同步扩展此窗口（见 doc/fix/20260907-dsh-0.1.2-rc1-auth/）。
+ * 2026-09-11：MAX 扩到 `0.1.5-rc.2` —— 真机实测通过（spawn + ready 行 token + 会话 cookie 换发 +
+ * `/api` 转发 + HTML 注入 + WS `/api/remote.mux` 桥接 + join 的 `patchLoopbackJs` 命中），
+ * 见 doc/review/20260911-dsh-0.1.5-rc.2-plugin-compat.md §5。
  */
 export declare const DSH_COMPAT_MIN = "0.1.1-rc.2";
-export declare const DSH_COMPAT_MAX = "0.1.2-rc.1";
+export declare const DSH_COMPAT_MAX = "0.1.5-rc.2";
 /**
  * 版本落在实测窗口外时的提示文案（零文档导向：直接给动作指令，用户不查表）。
  * - 比 max 新 → 升级 remote-dsh 或暂用旧 dsh；

package/dist/spawn-dsh.js

@@ -197,9 +197,12 @@ export function compareDshVersions(a, b) {
 /**
  * remote-dsh 已实测兼容的 dsh 版本窗口（registry 实存版本定界）。
  * ⚠️ 适配新的 dsh 版本并真机实测后，须同步扩展此窗口（见 doc/fix/20260907-dsh-0.1.2-rc1-auth/）。
+ * 2026-09-11：MAX 扩到 `0.1.5-rc.2` —— 真机实测通过（spawn + ready 行 token + 会话 cookie 换发 +
+ * `/api` 转发 + HTML 注入 + WS `/api/remote.mux` 桥接 + join 的 `patchLoopbackJs` 命中），
+ * 见 doc/review/20260911-dsh-0.1.5-rc.2-plugin-compat.md §5。
  */
 export const DSH_COMPAT_MIN = "0.1.1-rc.2";
-export const DSH_COMPAT_MAX = "0.1.2-rc.1";
+export const DSH_COMPAT_MAX = "0.1.5-rc.2";
 /**
  * 版本落在实测窗口外时的提示文案（零文档导向：直接给动作指令，用户不查表）。
  * - 比 max 新 → 升级 remote-dsh 或暂用旧 dsh；

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rdsh-gateway",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "rdsh host-side component: LAN auth gateway + outbound tunnel endpoint (spawns dsh web)",
   "license": "MIT",
   "type": "module",