@jhh96/light-app-bridge 1.1.1 → 1.2.1

package/dist/lightAppBridge.d.ts

@@ -139,6 +139,28 @@ export default class LightAppBridge {
     constructor(role?: BridgeRole, options?: BridgeOptions);
     /** debug 日志（options.debug 开启时打印，前缀带角色便于双端对照） */
     private _log;
+    /**
+     * debug 模式下在 window 挂载控制台测试方法（挂在单一入口 __lightAppBridge 下，
+     * destroy 时注销）：
+     *
+     *   __lightAppBridge.send(data, timeout?) —— 以本实例身份向对端发一条请求，返回 Promise。
+     *     等价于业务代码里的 bridge.send(...)。
+     *       await __lightAppBridge.send({ action: 'ping' })
+     *       await __lightAppBridge.send({ action: 'scroll.to', payload: {...} }, 5000)
+     *
+     *   __lightAppBridge.inject(type, data?, fromId?, id?) —— 模拟对端来一条消息，直接喂给
+     *   本实例的消息分发入口（绕过原生投递层），无需真实对端窗口即可测试收发逻辑。
+     *   type 取信封类型：'hello' | 'ack' | 'req' | 'res' | 'ping'
+     *       __lightAppBridge.inject('ping')                     // 看本端自动回 pong
+     *       __lightAppBridge.inject('req', { action: 'test' })  // 触发本端 onMessage handler
+     *       __lightAppBridge.inject('hello', null, 42)          // 模拟 webContentsId=42 的对端握手
+     *       __lightAppBridge.inject('res', {ok:1}, 77, reqId)   // 回 res：第 4 参传原请求 id 配对唤醒
+     *
+     * 多实例同时开启 debug 时后注册者覆盖前者（控制台操作的是最后创建的实例）。
+     * 不挂实例本身（避免控制台误触内部状态）。
+     */
+    private _registerDebugHelpers;
+    private _debugCleanup;
     /** 校验依赖是否就绪，缺失抛出明确异常 */
     private _checkDeps;
     /** 绑定消息监听：优先 waltz；无 waltz 时定义/包装 window.handleMessageFromNative */

package/dist/lightAppBridge.js

@@ -202,6 +202,7 @@ export default class LightAppBridge {
         this._probeOk = false; // 兜底探测是否收到 ack
         this._probeTimers = []; // 防 destroy 后悬挂
         this._disconnectCbs = [];
+        this._debugCleanup = null;
         let r = role === 'plugin' || role === 'lightapp' ? role : 'lightapp';
         if (role !== 'plugin' && role !== 'lightapp') {
             const wl = window.worklink;
@@ -232,6 +233,7 @@ export default class LightAppBridge {
         });
         this._checkDeps(); // 依赖校验，缺失直接抛异常
         this._startListener(); // 绑定消息监听（waltz 或定义 handleMessageFromNative）
+        this._registerDebugHelpers(); // debug 模式：注册控制台测试方法
         this.connect(); // 构造即自动发起握手（内部会等监听就绪）
     }
     /** debug 日志（options.debug 开启时打印，前缀带角色便于双端对照） */
@@ -240,6 +242,58 @@ export default class LightAppBridge {
             return;
         console.log(`[LightAppBridge:${this.role}]`, ...args);
     }
+    // —— debug 控制台测试方法（options.debug 开启时挂 window）—— //
+    /**
+     * debug 模式下在 window 挂载控制台测试方法（挂在单一入口 __lightAppBridge 下，
+     * destroy 时注销）：
+     *
+     *   __lightAppBridge.send(data, timeout?) —— 以本实例身份向对端发一条请求，返回 Promise。
+     *     等价于业务代码里的 bridge.send(...)。
+     *       await __lightAppBridge.send({ action: 'ping' })
+     *       await __lightAppBridge.send({ action: 'scroll.to', payload: {...} }, 5000)
+     *
+     *   __lightAppBridge.inject(type, data?, fromId?, id?) —— 模拟对端来一条消息，直接喂给
+     *   本实例的消息分发入口（绕过原生投递层），无需真实对端窗口即可测试收发逻辑。
+     *   type 取信封类型：'hello' | 'ack' | 'req' | 'res' | 'ping'
+     *       __lightAppBridge.inject('ping')                     // 看本端自动回 pong
+     *       __lightAppBridge.inject('req', { action: 'test' })  // 触发本端 onMessage handler
+     *       __lightAppBridge.inject('hello', null, 42)          // 模拟 webContentsId=42 的对端握手
+     *       __lightAppBridge.inject('res', {ok:1}, 77, reqId)   // 回 res：第 4 参传原请求 id 配对唤醒
+     *
+     * 多实例同时开启 debug 时后注册者覆盖前者（控制台操作的是最后创建的实例）。
+     * 不挂实例本身（避免控制台误触内部状态）。
+     */
+    _registerDebugHelpers() {
+        if (!this._debug)
+            return;
+        const w = window;
+        const sendFn = (data, timeout) => {
+            // eslint-disable-next-line no-console
+            console.log(`[LightAppBridge:${this.role}] send→`, data);
+            return this.send(data, timeout != null ? { timeout } : undefined);
+        };
+        const injectFn = (type, data, fromId, id) => {
+            const envelope = this._envelope(type, data != null ? data : {}, id || genId() // res 场景必须传原请求 id 才能配对唤醒（未传则生成新 id，作为陌生 res 被忽略）
+            );
+            // eslint-disable-next-line no-console
+            console.log(`[LightAppBridge:${this.role}] inject←`, envelope);
+            this._onMessage({ envelope, fromWebContentsId: fromId != null ? fromId : 0 });
+        };
+        const facade = { send: sendFn, inject: injectFn };
+        const prev = w.__lightAppBridge; // 多实例 debug：保留被覆盖者的清理引用链
+        w.__lightAppBridge = facade;
+        // eslint-disable-next-line no-console
+        console.info(`[LightAppBridge:${this.role}] debug 方法已挂载: ` +
+            'await __lightAppBridge.send(data, timeout?) 发请求 / ' +
+            '__lightAppBridge.inject(type, data?, fromId?, id?) 模拟来消息');
+        this._debugCleanup = () => {
+            // 仅当仍是自己挂的 facade 才清理，避免误删后建实例的挂载
+            if (w.__lightAppBridge === facade)
+                delete w.__lightAppBridge;
+            else
+                w.__lightAppBridge = prev;
+        };
+    }
     /** 校验依赖是否就绪，缺失抛出明确异常 */
     _checkDeps() {
         const w = window;
@@ -821,6 +875,14 @@ export default class LightAppBridge {
             catch { /* ignore */ }
             this._unlisten = null;
         }
+        // 注销 debug 控制台测试方法
+        if (this._debugCleanup) {
+            try {
+                this._debugCleanup();
+            }
+            catch { /* ignore */ }
+            this._debugCleanup = null;
+        }
         this._clearHelloTimer();
         this._stopDynamicPoll();
         this._stopPing();

package/package.json

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