@macroui/event-tracker 1.3.0 → 1.3.1

package/dist/plugin/predictive-batcher.cjs

@@ -0,0 +1,61 @@
+'use strict';
+
+/**
+ * Predictive Batching（v1.2.0）
+ *
+ *  - 监听 user activity（click/scroll/keypress/mousemove 节流）
+ *  - 高活动期：缩短 batch flush 间隔
+ *  - 低活动期：拉长间隔，省电 / 省流量
+ *  - 通过 SDK config.batch_send.dynamic_interval 启用
+ *
+ * 不属于 SDK 强耦合：作为可选插件
+ */
+/**
+ * 不修改 SDK 内部，而是提供一个工具函数 getInterval(opts)
+ * 业务侧在 BatchSender.flush interval 决策时调用
+ */
+function makeIntervalPredictor(opts) {
+    var _a, _b, _c, _d, _e;
+    if (opts === void 0) { opts = {}; }
+    var min = (_a = opts.minInterval) !== null && _a !== void 0 ? _a : 1000;
+    var max = (_b = opts.maxInterval) !== null && _b !== void 0 ? _b : 30000;
+    var winMs = (_c = opts.windowMs) !== null && _c !== void 0 ? _c : 5000;
+    var threshold = (_d = opts.activityThreshold) !== null && _d !== void 0 ? _d : 5;
+    var events = (_e = opts.events) !== null && _e !== void 0 ? _e : ['click', 'scroll', 'keypress'];
+    var counts = [];
+    if (typeof window !== 'undefined') {
+        var handler = function () {
+            var now = Date.now();
+            counts.push(now);
+            while (counts.length && now - counts[0] > winMs)
+                counts.shift();
+        };
+        for (var _i = 0, events_1 = events; _i < events_1.length; _i++) {
+            var e = events_1[_i];
+            window.addEventListener(e, handler, { passive: true });
+        }
+    }
+    return function () {
+        if (counts.length > threshold)
+            return min;
+        if (counts.length > 0)
+            return Math.round(min + (max - min) * (1 - counts.length / threshold));
+        return max;
+    };
+}
+function predictiveBatcher(opts) {
+    if (opts === void 0) { opts = {}; }
+    var predict = makeIntervalPredictor(opts);
+    return {
+        name: 'predictive-batcher',
+        install: function (_a) {
+            var config = _a.config;
+            // 把 dynamic_interval 计算器挂到 config（BatchSender 可选读取）
+            config.batch_send_predict = predict;
+        },
+    };
+}
+
+exports.makeIntervalPredictor = makeIntervalPredictor;
+exports.predictiveBatcher = predictiveBatcher;
+//# sourceMappingURL=predictive-batcher.cjs.map

package/dist/plugin/predictive-batcher.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"predictive-batcher.cjs","sources":["../../src/plugins/predictive-batcher/index.ts"],"sourcesContent":["/**\n * Predictive Batching（v1.2.0）\n *\n *  - 监听 user activity（click/scroll/keypress/mousemove 节流）\n *  - 高活动期：缩短 batch flush 间隔\n *  - 低活动期：拉长间隔，省电 / 省流量\n *  - 通过 SDK config.batch_send.dynamic_interval 启用\n *\n * 不属于 SDK 强耦合：作为可选插件\n */\n\nimport type { Plugin } from '../../core/plugin.js';\n\nexport interface PredictiveBatchOptions {\n  /** 最小间隔（活动期） */\n  minInterval?: number;\n  /** 最大间隔（静默期） */\n  maxInterval?: number;\n  /** 活动统计窗口（ms） */\n  windowMs?: number;\n  /** 活动阈值（窗口内事件 > 此数视为活动期） */\n  activityThreshold?: number;\n  /** 是否监听这些事件类型 */\n  events?: ('click' | 'scroll' | 'keypress' | 'mousemove' | 'touchstart')[];\n}\n\n/**\n * 不修改 SDK 内部，而是提供一个工具函数 getInterval(opts)\n * 业务侧在 BatchSender.flush interval 决策时调用\n */\nexport function makeIntervalPredictor(opts: PredictiveBatchOptions = {}): () => number {\n  const min = opts.minInterval ?? 1000;\n  const max = opts.maxInterval ?? 30000;\n  const winMs = opts.windowMs ?? 5000;\n  const threshold = opts.activityThreshold ?? 5;\n  const events = opts.events ?? ['click', 'scroll', 'keypress'];\n  const counts: number[] = [];\n\n  if (typeof window !== 'undefined') {\n    const handler = () => {\n      const now = Date.now();\n      counts.push(now);\n      while (counts.length && now - counts[0] > winMs) counts.shift();\n    };\n    for (const e of events) window.addEventListener(e, handler, { passive: true });\n  }\n\n  return () => {\n    if (counts.length > threshold) return min;\n    if (counts.length > 0) return Math.round(min + (max - min) * (1 - counts.length / threshold));\n    return max;\n  };\n}\n\nexport function predictiveBatcher(opts: PredictiveBatchOptions = {}): Plugin {\n  const predict = makeIntervalPredictor(opts);\n  return {\n    name: 'predictive-batcher',\n    install({ config }) {\n      // 把 dynamic_interval 计算器挂到 config（BatchSender 可选读取）\n      (config as unknown as { batch_send_predict?: () => number }).batch_send_predict = predict;\n    },\n  };\n}"],"names":[],"mappings":";;AAAA;;;;;;;;;AASG;AAiBH;;;AAGG;AACG,SAAU,qBAAqB,CAAC,IAAiC,EAAA;;AAAjC,IAAA,IAAA,IAAA,KAAA,MAAA,EAAA,EAAA,IAAA,GAAA,EAAiC,CAAA,CAAA;IACrE,IAAM,GAAG,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,IAAI;IACpC,IAAM,GAAG,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,KAAK;IACrC,IAAM,KAAK,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,QAAQ,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,IAAI;IACnC,IAAM,SAAS,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,iBAAiB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,CAAC;AAC7C,IAAA,IAAM,MAAM,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,MAAM,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;IAC7D,IAAM,MAAM,GAAa,EAAE;AAE3B,IAAA,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;AACjC,QAAA,IAAM,OAAO,GAAG,YAAA;AACd,YAAA,IAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;AACtB,YAAA,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;YAChB,OAAO,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK;gBAAE,MAAM,CAAC,KAAK,EAAE;AACjE,QAAA,CAAC;AACD,QAAA,KAAgB,UAAM,EAAN,QAAA,GAAA,MAAM,EAAN,EAAA,GAAA,QAAA,CAAA,MAAM,EAAN,EAAA,EAAM,EAAA;AAAjB,YAAA,IAAM,CAAC,GAAA,QAAA,CAAA,EAAA,CAAA;AAAY,YAAA,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAAC,QAAA;IACjF;IAEA,OAAO,YAAA;AACL,QAAA,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS;AAAE,YAAA,OAAO,GAAG;AACzC,QAAA,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAC7F,QAAA,OAAO,GAAG;AACZ,IAAA,CAAC;AACH;AAEM,SAAU,iBAAiB,CAAC,IAAiC,EAAA;AAAjC,IAAA,IAAA,IAAA,KAAA,MAAA,EAAA,EAAA,IAAA,GAAA,EAAiC,CAAA,CAAA;AACjE,IAAA,IAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC;IAC3C,OAAO;AACL,QAAA,IAAI,EAAE,oBAAoB;AAC1B,QAAA,OAAO,YAAC,EAAU,EAAA;AAAR,YAAA,IAAA,MAAM,GAAA,EAAA,CAAA,MAAA;;AAEb,YAAA,MAA2D,CAAC,kBAAkB,GAAG,OAAO;QAC3F,CAAC;KACF;AACH;;;;;"}

package/dist/plugin/predictive-batcher.mjs

@@ -0,0 +1,58 @@
+/**
+ * Predictive Batching（v1.2.0）
+ *
+ *  - 监听 user activity（click/scroll/keypress/mousemove 节流）
+ *  - 高活动期：缩短 batch flush 间隔
+ *  - 低活动期：拉长间隔，省电 / 省流量
+ *  - 通过 SDK config.batch_send.dynamic_interval 启用
+ *
+ * 不属于 SDK 强耦合：作为可选插件
+ */
+/**
+ * 不修改 SDK 内部，而是提供一个工具函数 getInterval(opts)
+ * 业务侧在 BatchSender.flush interval 决策时调用
+ */
+function makeIntervalPredictor(opts) {
+    var _a, _b, _c, _d, _e;
+    if (opts === void 0) { opts = {}; }
+    var min = (_a = opts.minInterval) !== null && _a !== void 0 ? _a : 1000;
+    var max = (_b = opts.maxInterval) !== null && _b !== void 0 ? _b : 30000;
+    var winMs = (_c = opts.windowMs) !== null && _c !== void 0 ? _c : 5000;
+    var threshold = (_d = opts.activityThreshold) !== null && _d !== void 0 ? _d : 5;
+    var events = (_e = opts.events) !== null && _e !== void 0 ? _e : ['click', 'scroll', 'keypress'];
+    var counts = [];
+    if (typeof window !== 'undefined') {
+        var handler = function () {
+            var now = Date.now();
+            counts.push(now);
+            while (counts.length && now - counts[0] > winMs)
+                counts.shift();
+        };
+        for (var _i = 0, events_1 = events; _i < events_1.length; _i++) {
+            var e = events_1[_i];
+            window.addEventListener(e, handler, { passive: true });
+        }
+    }
+    return function () {
+        if (counts.length > threshold)
+            return min;
+        if (counts.length > 0)
+            return Math.round(min + (max - min) * (1 - counts.length / threshold));
+        return max;
+    };
+}
+function predictiveBatcher(opts) {
+    if (opts === void 0) { opts = {}; }
+    var predict = makeIntervalPredictor(opts);
+    return {
+        name: 'predictive-batcher',
+        install: function (_a) {
+            var config = _a.config;
+            // 把 dynamic_interval 计算器挂到 config（BatchSender 可选读取）
+            config.batch_send_predict = predict;
+        },
+    };
+}
+
+export { makeIntervalPredictor, predictiveBatcher };
+//# sourceMappingURL=predictive-batcher.mjs.map

package/dist/plugin/predictive-batcher.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"predictive-batcher.mjs","sources":["../../src/plugins/predictive-batcher/index.ts"],"sourcesContent":["/**\n * Predictive Batching（v1.2.0）\n *\n *  - 监听 user activity（click/scroll/keypress/mousemove 节流）\n *  - 高活动期：缩短 batch flush 间隔\n *  - 低活动期：拉长间隔，省电 / 省流量\n *  - 通过 SDK config.batch_send.dynamic_interval 启用\n *\n * 不属于 SDK 强耦合：作为可选插件\n */\n\nimport type { Plugin } from '../../core/plugin.js';\n\nexport interface PredictiveBatchOptions {\n  /** 最小间隔（活动期） */\n  minInterval?: number;\n  /** 最大间隔（静默期） */\n  maxInterval?: number;\n  /** 活动统计窗口（ms） */\n  windowMs?: number;\n  /** 活动阈值（窗口内事件 > 此数视为活动期） */\n  activityThreshold?: number;\n  /** 是否监听这些事件类型 */\n  events?: ('click' | 'scroll' | 'keypress' | 'mousemove' | 'touchstart')[];\n}\n\n/**\n * 不修改 SDK 内部，而是提供一个工具函数 getInterval(opts)\n * 业务侧在 BatchSender.flush interval 决策时调用\n */\nexport function makeIntervalPredictor(opts: PredictiveBatchOptions = {}): () => number {\n  const min = opts.minInterval ?? 1000;\n  const max = opts.maxInterval ?? 30000;\n  const winMs = opts.windowMs ?? 5000;\n  const threshold = opts.activityThreshold ?? 5;\n  const events = opts.events ?? ['click', 'scroll', 'keypress'];\n  const counts: number[] = [];\n\n  if (typeof window !== 'undefined') {\n    const handler = () => {\n      const now = Date.now();\n      counts.push(now);\n      while (counts.length && now - counts[0] > winMs) counts.shift();\n    };\n    for (const e of events) window.addEventListener(e, handler, { passive: true });\n  }\n\n  return () => {\n    if (counts.length > threshold) return min;\n    if (counts.length > 0) return Math.round(min + (max - min) * (1 - counts.length / threshold));\n    return max;\n  };\n}\n\nexport function predictiveBatcher(opts: PredictiveBatchOptions = {}): Plugin {\n  const predict = makeIntervalPredictor(opts);\n  return {\n    name: 'predictive-batcher',\n    install({ config }) {\n      // 把 dynamic_interval 计算器挂到 config（BatchSender 可选读取）\n      (config as unknown as { batch_send_predict?: () => number }).batch_send_predict = predict;\n    },\n  };\n}"],"names":[],"mappings":"AAAA;;;;;;;;;AASG;AAiBH;;;AAGG;AACG,SAAU,qBAAqB,CAAC,IAAiC,EAAA;;AAAjC,IAAA,IAAA,IAAA,KAAA,MAAA,EAAA,EAAA,IAAA,GAAA,EAAiC,CAAA,CAAA;IACrE,IAAM,GAAG,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,IAAI;IACpC,IAAM,GAAG,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,KAAK;IACrC,IAAM,KAAK,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,QAAQ,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,IAAI;IACnC,IAAM,SAAS,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,iBAAiB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,CAAC;AAC7C,IAAA,IAAM,MAAM,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,MAAM,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;IAC7D,IAAM,MAAM,GAAa,EAAE;AAE3B,IAAA,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;AACjC,QAAA,IAAM,OAAO,GAAG,YAAA;AACd,YAAA,IAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;AACtB,YAAA,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;YAChB,OAAO,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK;gBAAE,MAAM,CAAC,KAAK,EAAE;AACjE,QAAA,CAAC;AACD,QAAA,KAAgB,UAAM,EAAN,QAAA,GAAA,MAAM,EAAN,EAAA,GAAA,QAAA,CAAA,MAAM,EAAN,EAAA,EAAM,EAAA;AAAjB,YAAA,IAAM,CAAC,GAAA,QAAA,CAAA,EAAA,CAAA;AAAY,YAAA,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAAC,QAAA;IACjF;IAEA,OAAO,YAAA;AACL,QAAA,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS;AAAE,YAAA,OAAO,GAAG;AACzC,QAAA,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAC7F,QAAA,OAAO,GAAG;AACZ,IAAA,CAAC;AACH;AAEM,SAAU,iBAAiB,CAAC,IAAiC,EAAA;AAAjC,IAAA,IAAA,IAAA,KAAA,MAAA,EAAA,EAAA,IAAA,GAAA,EAAiC,CAAA,CAAA;AACjE,IAAA,IAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC;IAC3C,OAAO;AACL,QAAA,IAAI,EAAE,oBAAoB;AAC1B,QAAA,OAAO,YAAC,EAAU,EAAA;AAAR,YAAA,IAAA,MAAM,GAAA,EAAA,CAAA,MAAA;;AAEb,YAAA,MAA2D,CAAC,kBAAkB,GAAG,OAAO;QAC3F,CAAC;KACF;AACH;;;;"}

package/dist/plugin/webview-bridge.cjs

@@ -40,22 +40,29 @@ function isBrowser() {
 }
 
 /**
- * WebView 桥（vapph5 协议）
- *  - 客户端（iOS/Android）注入 window.vapph5define 对象
- *  - H5 通过 vapph5define.call(name, args) 调用客户端方法
- *  - 客户端通过 vapph5define.handle(name, fn) 监听 H5 调用
+ * WebView 桥（v2 RPC）
  *
- * 本插件负责：
- *  1. 探测 WebView 标识
- *  2. 在 SDK 启动时调用 vapph5define.call('getAppInfo')，把 app_version/app_id/...
- *     注入到 config 与公共属性
- *  3. 暴露 helper：bridge.call(name, args) 与 bridge.on(name, fn)
+ *  v1: vapph5define.call(name, args) 同步返回，缺点：
+ *    - 没法 timeout
+ *    - 没法传 callback-style
+ *    - 没法识别 native async
+ *
+ *  v2:
+ *    - RPC 协议：call(name, args, cbId) → native 通过 vapph5define.rpc.response(cbId, result)
+ *    - 自动超时（默认 5s）→ reject
+ *    - 自动探测：window.vapph5define.rpc / window.vapph5define.call 任一可用
+ *    - SDK 暴露 sdk.bridge.callAsync(name, args) 返回 Promise
+ *    - 兼容旧 sdk.bridge.call(name, args)
+ *    - install 时 fetch app info 可 await
  */
 function webviewBridge(opts) {
     if (opts === void 0) { opts = {}; }
+    var rpcCbSeq = 0;
+    var rpcPending = new Map();
     return {
         name: 'webview-bridge',
         install: function (_a) {
+            var _b;
             var sdk = _a.sdk, config = _a.config;
             if (!isBrowser())
                 return;
@@ -65,7 +72,54 @@ function webviewBridge(opts) {
             if (!define || typeof define.call !== 'function') {
                 return; // 不在 WebView 中
             }
-            // 暴露 SDK 内部调用的便捷方法
+            var timeout = (_b = opts.timeout) !== null && _b !== void 0 ? _b : 5000;
+            var callAsync = function (name, args, timeoutMs) {
+                return new Promise(function (resolve, reject) {
+                    // 优先用 v2 rpc
+                    if (define.rpc && typeof define.rpc.call === 'function') {
+                        var cbId_1 = "rpc_".concat(++rpcCbSeq, "_").concat(Date.now());
+                        var t = setTimeout(function () {
+                            rpcPending.delete(cbId_1);
+                            reject(new Error("[WebViewBridge] RPC '".concat(name, "' timeout after ").concat(timeoutMs !== null && timeoutMs !== void 0 ? timeoutMs : timeout, "ms")));
+                        }, timeoutMs !== null && timeoutMs !== void 0 ? timeoutMs : timeout);
+                        rpcPending.set(cbId_1, { resolve: resolve, reject: reject, timer: t });
+                        try {
+                            define.rpc.call(name, cbId_1, args);
+                        }
+                        catch (e) {
+                            clearTimeout(t);
+                            rpcPending.delete(cbId_1);
+                            reject(e);
+                        }
+                    }
+                    else {
+                        // fallback v1：同步转异步
+                        try {
+                            var r = define.call(name, args);
+                            resolve(r);
+                        }
+                        catch (e) {
+                            reject(e);
+                        }
+                    }
+                });
+            };
+            // 注册 v2 rpc response 监听
+            if (define.rpc && typeof define.rpc.response === 'function') {
+                define.handle('rpc.response', function (cbId, result, err) {
+                    if (typeof cbId !== 'string')
+                        return;
+                    var p = rpcPending.get(cbId);
+                    if (!p)
+                        return;
+                    rpcPending.delete(cbId);
+                    clearTimeout(p.timer);
+                    if (err)
+                        p.reject(new Error(String(err)));
+                    else
+                        p.resolve(result);
+                });
+            }
             var bridge = {
                 call: function (name) {
                     var args = [];
@@ -74,35 +128,33 @@ function webviewBridge(opts) {
                     }
                     return define.call.apply(define, __spreadArray([name], args, false));
                 },
+                callAsync: callAsync,
                 on: function (name, fn) { return define.handle(name, fn); },
                 isInApp: function () { return define.isInApp === true || define.call('isInApp') === true; },
             };
             sdk.bridge = bridge;
             config.is_webview = true;
             if (opts.fetchOnInit !== false) {
-                try {
-                    var protocolName = opts.protocolName || 'getAppInfo';
-                    var result = define.call(protocolName);
-                    if (result && typeof result === 'object') {
-                        var fm = opts.fieldMap || {};
-                        for (var _i = 0, _b = Object.entries(fm); _i < _b.length; _i++) {
-                            var _c = _b[_i], sdkKey = _c[0], resultKey = _c[1];
-                            var v = result[resultKey];
-                            if (v !== undefined && v !== null) {
-                                config[sdkKey] = v;
-                            }
+                // 用 callAsync（支持 v2 rpc + v1 同步），避免阻塞 install
+                var protocolName = opts.protocolName || 'getAppInfo';
+                void callAsync(protocolName).then(function (result) {
+                    if (!result || typeof result !== 'object')
+                        return;
+                    var fm = opts.fieldMap || {};
+                    for (var _i = 0, _a = Object.entries(fm); _i < _a.length; _i++) {
+                        var _b = _a[_i], sdkKey = _b[0], resultKey = _b[1];
+                        var v = result[resultKey];
+                        if (v !== undefined && v !== null) {
+                            config[sdkKey] = v;
                         }
-                        sdk.register({
-                            $app_version: result.app_version || result.appVersion,
-                            $app_id: result.app_id || result.appId,
-                            $channel: result.channel,
-                            $lib: result.lib || result.lib_name || result.libName,
-                        });
                     }
-                }
-                catch (_d) {
-                    /* ignore */
-                }
+                    sdk.register({
+                        $app_version: result.app_version || result.appVersion,
+                        $app_id: result.app_id || result.appId,
+                        $channel: result.channel,
+                        $lib: result.lib || result.lib_name || result.libName,
+                    });
+                }).catch(function () { });
             }
         },
     };

package/dist/plugin/webview-bridge.mjs

@@ -38,22 +38,29 @@ function isBrowser() {
 }
 
 /**
- * WebView 桥（vapph5 协议）
- *  - 客户端（iOS/Android）注入 window.vapph5define 对象
- *  - H5 通过 vapph5define.call(name, args) 调用客户端方法
- *  - 客户端通过 vapph5define.handle(name, fn) 监听 H5 调用
+ * WebView 桥（v2 RPC）
  *
- * 本插件负责：
- *  1. 探测 WebView 标识
- *  2. 在 SDK 启动时调用 vapph5define.call('getAppInfo')，把 app_version/app_id/...
- *     注入到 config 与公共属性
- *  3. 暴露 helper：bridge.call(name, args) 与 bridge.on(name, fn)
+ *  v1: vapph5define.call(name, args) 同步返回，缺点：
+ *    - 没法 timeout
+ *    - 没法传 callback-style
+ *    - 没法识别 native async
+ *
+ *  v2:
+ *    - RPC 协议：call(name, args, cbId) → native 通过 vapph5define.rpc.response(cbId, result)
+ *    - 自动超时（默认 5s）→ reject
+ *    - 自动探测：window.vapph5define.rpc / window.vapph5define.call 任一可用
+ *    - SDK 暴露 sdk.bridge.callAsync(name, args) 返回 Promise
+ *    - 兼容旧 sdk.bridge.call(name, args)
+ *    - install 时 fetch app info 可 await
  */
 function webviewBridge(opts) {
     if (opts === void 0) { opts = {}; }
+    var rpcCbSeq = 0;
+    var rpcPending = new Map();
     return {
         name: 'webview-bridge',
         install: function (_a) {
+            var _b;
             var sdk = _a.sdk, config = _a.config;
             if (!isBrowser())
                 return;
@@ -63,7 +70,54 @@ function webviewBridge(opts) {
             if (!define || typeof define.call !== 'function') {
                 return; // 不在 WebView 中
             }
-            // 暴露 SDK 内部调用的便捷方法
+            var timeout = (_b = opts.timeout) !== null && _b !== void 0 ? _b : 5000;
+            var callAsync = function (name, args, timeoutMs) {
+                return new Promise(function (resolve, reject) {
+                    // 优先用 v2 rpc
+                    if (define.rpc && typeof define.rpc.call === 'function') {
+                        var cbId_1 = "rpc_".concat(++rpcCbSeq, "_").concat(Date.now());
+                        var t = setTimeout(function () {
+                            rpcPending.delete(cbId_1);
+                            reject(new Error("[WebViewBridge] RPC '".concat(name, "' timeout after ").concat(timeoutMs !== null && timeoutMs !== void 0 ? timeoutMs : timeout, "ms")));
+                        }, timeoutMs !== null && timeoutMs !== void 0 ? timeoutMs : timeout);
+                        rpcPending.set(cbId_1, { resolve: resolve, reject: reject, timer: t });
+                        try {
+                            define.rpc.call(name, cbId_1, args);
+                        }
+                        catch (e) {
+                            clearTimeout(t);
+                            rpcPending.delete(cbId_1);
+                            reject(e);
+                        }
+                    }
+                    else {
+                        // fallback v1：同步转异步
+                        try {
+                            var r = define.call(name, args);
+                            resolve(r);
+                        }
+                        catch (e) {
+                            reject(e);
+                        }
+                    }
+                });
+            };
+            // 注册 v2 rpc response 监听
+            if (define.rpc && typeof define.rpc.response === 'function') {
+                define.handle('rpc.response', function (cbId, result, err) {
+                    if (typeof cbId !== 'string')
+                        return;
+                    var p = rpcPending.get(cbId);
+                    if (!p)
+                        return;
+                    rpcPending.delete(cbId);
+                    clearTimeout(p.timer);
+                    if (err)
+                        p.reject(new Error(String(err)));
+                    else
+                        p.resolve(result);
+                });
+            }
             var bridge = {
                 call: function (name) {
                     var args = [];
@@ -72,35 +126,33 @@ function webviewBridge(opts) {
                     }
                     return define.call.apply(define, __spreadArray([name], args, false));
                 },
+                callAsync: callAsync,
                 on: function (name, fn) { return define.handle(name, fn); },
                 isInApp: function () { return define.isInApp === true || define.call('isInApp') === true; },
             };
             sdk.bridge = bridge;
             config.is_webview = true;
             if (opts.fetchOnInit !== false) {
-                try {
-                    var protocolName = opts.protocolName || 'getAppInfo';
-                    var result = define.call(protocolName);
-                    if (result && typeof result === 'object') {
-                        var fm = opts.fieldMap || {};
-                        for (var _i = 0, _b = Object.entries(fm); _i < _b.length; _i++) {
-                            var _c = _b[_i], sdkKey = _c[0], resultKey = _c[1];
-                            var v = result[resultKey];
-                            if (v !== undefined && v !== null) {
-                                config[sdkKey] = v;
-                            }
+                // 用 callAsync（支持 v2 rpc + v1 同步），避免阻塞 install
+                var protocolName = opts.protocolName || 'getAppInfo';
+                void callAsync(protocolName).then(function (result) {
+                    if (!result || typeof result !== 'object')
+                        return;
+                    var fm = opts.fieldMap || {};
+                    for (var _i = 0, _a = Object.entries(fm); _i < _a.length; _i++) {
+                        var _b = _a[_i], sdkKey = _b[0], resultKey = _b[1];
+                        var v = result[resultKey];
+                        if (v !== undefined && v !== null) {
+                            config[sdkKey] = v;
                         }
-                        sdk.register({
-                            $app_version: result.app_version || result.appVersion,
-                            $app_id: result.app_id || result.appId,
-                            $channel: result.channel,
-                            $lib: result.lib || result.lib_name || result.libName,
-                        });
                     }
-                }
-                catch (_d) {
-                    /* ignore */
-                }
+                    sdk.register({
+                        $app_version: result.app_version || result.appVersion,
+                        $app_id: result.app_id || result.appId,
+                        $channel: result.channel,
+                        $lib: result.lib || result.lib_name || result.libName,
+                    });
+                }).catch(function () { });
             }
         },
     };

package/dist/stats.cjs

@@ -0,0 +1,148 @@
+'use strict';
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
+
+var __assign = function() {
+    __assign = Object.assign || function __assign(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+/**
+ * Sender 失败统计（v1.2.0）
+ *
+ *  - 每个 sender 维护 attempts / success / failure / total_duration
+ *  - SDK 全局汇总
+ *  - 用户可 sdk.getStats() 查
+ *  - 自动每 60s 输出到 console（debug 模式）
+ */
+var StatsCollector = /** @class */ (function () {
+    function StatsCollector() {
+        this.total = 0;
+        this.success = 0;
+        this.failure = 0;
+        this.retry = 0;
+        this.in_flight = 0;
+        this.flushCount = 0;
+        this.bySender = new Map();
+    }
+    /** 记录一次发送开始 */
+    StatsCollector.prototype.recordStart = function (senderName) {
+        this.total++;
+        this.in_flight++;
+        var s = this.getOrCreate(senderName);
+        s.attempts++;
+        return Date.now();
+    };
+    /** 记录一次发送成功 */
+    StatsCollector.prototype.recordSuccess = function (senderName, startTs) {
+        this.success++;
+        this.in_flight = Math.max(0, this.in_flight - 1);
+        var s = this.getOrCreate(senderName);
+        var dur = Date.now() - startTs;
+        s.total_duration += dur;
+        s.avg_duration = s.total_duration / s.attempts;
+        if (dur > s.max_duration)
+            s.max_duration = dur;
+    };
+    /** 记录一次发送失败 */
+    StatsCollector.prototype.recordFailure = function (senderName, startTs, err) {
+        this.failure++;
+        this.in_flight = Math.max(0, this.in_flight - 1);
+        var s = this.getOrCreate(senderName);
+        s.failure++;
+        s.last_error = err.message;
+        s.last_error_at = Date.now();
+    };
+    /** 记录一次重试 */
+    StatsCollector.prototype.recordRetry = function () {
+        this.retry++;
+    };
+    /** 记录一次 flush */
+    StatsCollector.prototype.recordFlush = function () {
+        this.flushCount++;
+        this.lastFlushAt = Date.now();
+    };
+    /** 拍快照 */
+    StatsCollector.prototype.snapshot = function () {
+        var by_sender = {};
+        for (var _i = 0, _a = this.bySender; _i < _a.length; _i++) {
+            var _b = _a[_i], k = _b[0], v = _b[1];
+            by_sender[k] = __assign({}, v);
+        }
+        return {
+            total: this.total,
+            success: this.success,
+            failure: this.failure,
+            retry: this.retry,
+            in_flight: this.in_flight,
+            flush_count: this.flushCount,
+            last_flush_at: this.lastFlushAt,
+            by_sender: by_sender,
+            taken_at: Date.now(),
+        };
+    };
+    /** 重置 */
+    StatsCollector.prototype.reset = function () {
+        this.total = 0;
+        this.success = 0;
+        this.failure = 0;
+        this.retry = 0;
+        this.in_flight = 0;
+        this.flushCount = 0;
+        this.lastFlushAt = undefined;
+        this.bySender.clear();
+    };
+    /** 列出所有 sender 名 */
+    StatsCollector.prototype.listSenders = function () {
+        return Array.from(this.bySender.keys());
+    };
+    StatsCollector.prototype.getOrCreate = function (name) {
+        var s = this.bySender.get(name);
+        if (!s) {
+            s = {
+                name: name,
+                attempts: 0,
+                success: 0,
+                failure: 0,
+                total_duration: 0,
+                avg_duration: 0,
+                max_duration: 0,
+            };
+            this.bySender.set(name, s);
+        }
+        return s;
+    };
+    return StatsCollector;
+}());
+/** 全局单例 */
+var GLOBAL_STATS = new StatsCollector();
+
+exports.GLOBAL_STATS = GLOBAL_STATS;
+exports.StatsCollector = StatsCollector;
+//# sourceMappingURL=stats.cjs.map