@jhh96/light-app-bridge 1.3.1 → 1.4.0

package/dist/lightAppBridge.d.ts

@@ -99,6 +99,14 @@ export interface BridgeOptions {
 export interface SendOptions {
     /** 本次超时(ms)，不传用实例默认值 */
     timeout?: number;
+    /**
+     * 定向发送的目标 webContentsId（round 钉扎投递）。
+     * 不传（或 null/undefined）= 发往当前绑定对端（dynamic 模式即当前激活窗口）；
+     * 显式传历史对端 id = 向该窗口定向发送，绝不漂移到当前 peer——
+     * 用于"指令必须送达提问时刻的轻应用"语义。目标窗口已关闭时
+     * invoke 抛错快速失败（或按 timeout 超时），不会静默改投其他窗口。
+     */
+    to?: number | null;
 }
 /**
  * 请求消息处理器。返回值（含 Promise 解析值）会作为回复发回发送方。
@@ -251,6 +259,12 @@ export default class LightAppBridge {
     private _handleDisconnect;
     /** 监听对端失联（ping 与 hello 兜底探测均无响应时触发一次） */
     onDisconnect(cb: (peerId: number | null) => void): this;
+    /**
+     * 当前绑定对端 webContentsId（未连接/失联时为 null）。
+     * 调用方在业务时点（如用户提问）快照此值，之后经 send({to}) 定向发送，
+     * 即可保证指令送达该时点所在的轻应用窗口（round 钉扎）。
+     */
+    get peerId(): number | null;
     /**
      * 等待连接建立（握手完成）。构造时已自动发起握手，直接 await 即可。
      * @returns 对端 webContentsId

package/dist/lightAppBridge.js

@@ -268,10 +268,13 @@ export default class LightAppBridge {
         if (!this._debug)
             return;
         const w = window;
-        const sendFn = (data, timeout) => {
+        // 第二参兼容 number（超时毫秒）与 object（send 的 options 形态）：
+        // 传 { timeout: 1500 } 时不再被当成数字拼进超时串（曾报"请求超时 ([object Object]ms)"）
+        const sendFn = (data, opts) => {
             // eslint-disable-next-line no-console
             console.log(`[LightAppBridge:${this.role}] send→`, data);
-            return this.send(data, timeout != null ? { timeout } : undefined);
+            const options = typeof opts === 'number' ? { timeout: opts } : opts;
+            return this.send(data, options);
         };
         const injectFn = (type, data, fromId, id) => {
             const envelope = this._envelope(type, data != null ? data : {}, id || genId() // res 场景必须传原请求 id 才能配对唤醒（未传则生成新 id，作为陌生 res 被忽略）
@@ -756,6 +759,14 @@ export default class LightAppBridge {
         this._disconnectCbs.push(cb);
         return this;
     }
+    /**
+     * 当前绑定对端 webContentsId（未连接/失联时为 null）。
+     * 调用方在业务时点（如用户提问）快照此值，之后经 send({to}) 定向发送，
+     * 即可保证指令送达该时点所在的轻应用窗口（round 钉扎）。
+     */
+    get peerId() {
+        return this._peer;
+    }
     /**
      * 等待连接建立（握手完成）。构造时已自动发起握手，直接 await 即可。
      * @returns 对端 webContentsId
@@ -829,12 +840,12 @@ export default class LightAppBridge {
             return Promise.reject(new Error('实例已销毁'));
         const timeout = options.timeout != null ? options.timeout : this.timeout;
         return this.ready().then(() => {
-            // 发送目标取当前 _peer（而非 ready() resolve 的快照）：
-            // dynamic 模式迁移重绑后，后续 send 立即发往新对端。
-            const targetId = this._peer;
+            // 发送目标：显式 to（round 钉扎）优先；否则取当前 _peer（而非 ready()
+            // resolve 的快照）——dynamic 模式迁移重绑后，后续 send 立即发往新对端。
+            const targetId = options.to != null ? options.to : this._peer;
             const id = genId();
             const envelope = this._envelope('req', data, id);
-            this._log('send→ id=' + id + ' 目标=' + targetId + ' data=' + debugPayload(data));
+            this._log('send→ id=' + id + ' 目标=' + targetId + (options.to != null ? '(钉扎)' : '') + ' data=' + debugPayload(data));
             return new Promise((resolve, reject) => {
                 const timer = setTimeout(() => {
                     if (this._pending.has(id)) {

package/package.json

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