@jhh96/light-app-bridge 1.0.4 → 1.0.5

package/dist/lightAppBridge.d.ts

@@ -37,7 +37,7 @@ export interface Envelope {
 export interface BridgeOptions {
     /** send 默认超时(ms)，默认 3000 */
     timeout?: number;
-    /** 握手超时(ms)，默认 30000 */
+    /** 握手超时(ms)，默认 30000。仅 plugin 角色生效；lightapp 端持续等待，不超时 */
     handshakeTimeout?: number;
 }
 /** send 单次调用选项 */
@@ -86,8 +86,8 @@ export default class LightAppBridge {
     private _onMessage;
     /**
      * 建立连接（握手）。构造时已自动调用，通常无需手动调；如需重新握手可再次调用。
-     *   - 插件：发起握手（解析目标 id → 发 hello → 每秒重试直到收到 ack）
-     *   - 轻应用：启动握手等待（被动等 hello；若插件始终未来则超时）
+     *   - 插件：发起握手（解析目标 id → 发 hello → 每秒重试直到收到 ack 或超时）
+     *   - 轻应用：被动等待 hello（持续监听，不超时——插件可能任意晚才发起连接）
      * 多次调用幂等，返回同一个连接 Promise。
      * @returns 对端 webContentsId
      */

package/dist/lightAppBridge.js

@@ -237,8 +237,8 @@ export default class LightAppBridge {
     // —— 连接 / 握手 —— //
     /**
      * 建立连接（握手）。构造时已自动调用，通常无需手动调；如需重新握手可再次调用。
-     *   - 插件：发起握手（解析目标 id → 发 hello → 每秒重试直到收到 ack）
-     *   - 轻应用：启动握手等待（被动等 hello；若插件始终未来则超时）
+     *   - 插件：发起握手（解析目标 id → 发 hello → 每秒重试直到收到 ack 或超时）
+     *   - 轻应用：被动等待 hello（持续监听，不超时——插件可能任意晚才发起连接）
      * 多次调用幂等，返回同一个连接 Promise。
      * @returns 对端 webContentsId
      */
@@ -249,13 +249,16 @@ export default class LightAppBridge {
         this._connectStarted = true;
         // 等监听后端绑定完成后再握手，避免对端的 ack/hello 在监听绑定前到达而丢失
         const listenerReady = (_a = this._listenerReady) !== null && _a !== void 0 ? _a : Promise.resolve();
-        // 握手超时保护
-        this._handshakeTimer = setTimeout(() => {
-            if (!this._connected) {
-                this._connectDeferred.reject(new Error(`握手超时 (${this.handshakeTimeout}ms)，对端未响应`));
-                this._clearHelloTimer();
-            }
-        }, this.handshakeTimeout);
+        // 握手超时保护：仅插件（主动方）需要——它发了 hello 却收不到 ack 说明对端异常。
+        // 轻应用（被动方）持续等待，不超时：插件可能任意晚才发起连接。
+        if (this.role === 'plugin') {
+            this._handshakeTimer = setTimeout(() => {
+                if (!this._connected) {
+                    this._connectDeferred.reject(new Error(`握手超时 (${this.handshakeTimeout}ms)，对端未响应`));
+                    this._clearHelloTimer();
+                }
+            }, this.handshakeTimeout);
+        }
         listenerReady
             .then(() => {
             if (this._connected)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhh96/light-app-bridge",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "type": "module",
   "description": "招商随行（WorkLink）插件窗口(plugin)与轻应用窗口(lightapp)之间的双向通信 SDK",
   "main": "./dist/index.js",