@jhh96/light-app-bridge 1.3.2 → 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

@@ -759,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
@@ -832,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.2",
+  "version": "1.4.0",
   "type": "module",
   "description": "招商随行（WorkLink）插件窗口(plugin)与轻应用窗口(lightapp)之间的双向通信 SDK",
   "main": "./dist/index.js",