@jhh96/light-app-bridge 1.3.2 → 1.4.1

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

@@ -104,6 +104,8 @@ function bindMessageBackend(cb) {
                 ev.off('native-call-js', handler);
             else if (ev && typeof ev.removeListener === 'function')
                 ev.removeListener('native-call-js', handler);
+            else if (ev && typeof ev.remove === 'function')
+                ev.remove('native-call-js', handler); // waltz ≥1.1.7 API
         });
     }
     // 2. 定义 handleMessageFromNative 路径：无 waltz 时。
@@ -152,6 +154,12 @@ function parseHandleMessageFromNative(raw) {
             // handleMessageFromNative 入参带 responseId 包装
             responseData = parsed && parsed.responseData != null ? parsed.responseData : parsed;
         }
+        // waltz ≥1.1.7：event 总线（bl）派发载荷为 {id, data} 包装，responseData 在 .data 里
+        //（旧版 nativeCallWeb 直接派发裸 responseData）。裸数据有 .body 无 .data、包装有
+        // .data 无 .body，判据互斥，两种版本同一解析出口。
+        if (responseData && responseData.body == null && responseData.data != null) {
+            responseData = responseData.data;
+        }
         if (!responseData || !responseData.body || responseData.body.eventName !== 'plugin-message') {
             return null;
         }
@@ -759,6 +767,14 @@ export default class LightAppBridge {
         this._disconnectCbs.push(cb);
         return this;
     }
+    /**
+     * 当前绑定对端 webContentsId（未连接/失联时为 null）。
+     * 调用方在业务时点（如用户提问）快照此值，之后经 send({to}) 定向发送，
+     * 即可保证指令送达该时点所在的轻应用窗口（round 钉扎）。
+     */
+    get peerId() {
+        return this._peer;
+    }
     /**
      * 等待连接建立（握手完成）。构造时已自动发起握手，直接 await 即可。
      * @returns 对端 webContentsId
@@ -832,12 +848,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.2",
+  "version": "1.4.1",
   "type": "module",
   "description": "招商随行（WorkLink）插件窗口(plugin)与轻应用窗口(lightapp)之间的双向通信 SDK",
   "main": "./dist/index.js",