@yagolive/event-kit 1.0.6 → 1.0.7

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## @1.0.7 (2026-06-10)
+
+### 新增
+
+- **sendAction 单次超时配置**: `ActionBridge.sendAction` 与适配器 `sendAction` 新增 `option?: { timeout?: number }` 参数
+  - `timeout` 默认使用全局 `timeout`(适配器构造时传入,默认 30000ms)
+  - 仅当 `timeout > 0` 时启用超时检测；传 `0` 或负值可禁用单次超时
+  - `ActionBridge.sendAction` 支持以下调用方式（向后兼容）：
+    - `sendAction(action)`
+    - `sendAction(action, callback)` — 旧的回调风格
+    - `sendAction(action, option)` — 第二个参数为对象时识别为 option
+    - `sendAction(action, callback, option)`
+  - 类型新增：`SendActionOption` 接口由 `@yagolive/event-kit/adapters` 导出
+  - `MockAdapter` 的 `MockCall` 新增可选 `option` 字段,便于测试断言
+
+### 使用示例
+
+```javascript
+// 自定义单次超时(毫秒)
+await bridge.sendAction(action, { timeout: 5000 });
+
+// 禁用单次超时
+await bridge.sendAction(action, { timeout: -1 });
+```
+
+---
+
 ## @1.0.6 (2026-06-09)
 
 ### 新增

package/README.md

@@ -363,6 +363,10 @@ enterRoom.addOpenGiftPopupCallback(
 const action = bridge.createEnterRoomActionWithData(enterRoom);
 const result = await bridge.sendAction(action);
 
+// 自定义单次超时(毫秒);timeout<=0 表示禁用超时
+const result2 = await bridge.sendAction(action, { timeout: 5000 });
+const result3 = await bridge.sendAction(action, { timeout: -1 }); // 不超时
+
 // 销毁
 bridge.destroy();
 ```

package/dist/js/action_bridge.umd.js

@@ -1,6 +1,6 @@
 /**
  * YAGO Event Kit - Action Bridge (Full)
- * @version 1.0.6
+ * @version 1.0.7
  *
  * Generated by build script - do not edit manually.
  * Supports: Browser script tag, CommonJS, AMD
@@ -806,17 +806,21 @@ var RNWebViewAdapter = class {
     }
     this._callbacks = {};
   }
-  sendAction(action) {
+  sendAction(action, option) {
     var self = this;
     var messageId = "msg_" + Date.now() + "_" + Math.random().toString(36).substr(2, 9);
     action.messageId = messageId;
+    var timeout = option && option.timeout != null ? option.timeout : self._timeout;
     return new Promise(function(resolve, reject) {
-      var timer = setTimeout(function() {
-        delete self._callbacks[messageId];
-        reject(new Error("[ActionBridge] Timeout: no response for action " + action.type));
-      }, self._timeout);
+      var timer = null;
+      if (timeout > 0) {
+        timer = setTimeout(function() {
+          delete self._callbacks[messageId];
+          reject(new Error("[ActionBridge] Timeout: no response for action " + action.type));
+        }, timeout);
+      }
       self._callbacks[messageId] = function(result, error) {
-        clearTimeout(timer);
+        if (timer) clearTimeout(timer);
         delete self._callbacks[messageId];
         if (error) reject(error);
         else resolve(result);
@@ -882,13 +886,14 @@ var MockAdapter = class {
     this._calls = [];
     this._mockResults = {};
   }
-  sendAction(action) {
+  sendAction(action, option) {
     var self = this;
     this._calls.push({
       type: action.type,
       data: action.data != null ? action.data.toMap() : {},
       messageId: action.messageId,
-      timestamp: Date.now()
+      timestamp: Date.now(),
+      option
     });
     return new Promise(function(resolve, reject) {
       var mockResult = self._mockResults[action.type];
@@ -930,8 +935,12 @@ var ActionBridge = class _ActionBridge {
   get ActionData() {
     return ActionData;
   }
-  sendAction(action, callback) {
-    var promise = this._adapter.sendAction(action);
+  sendAction(action, callback, option) {
+    if (callback && typeof callback === "object" && option === void 0) {
+      option = callback;
+      callback = void 0;
+    }
+    var promise = this._adapter.sendAction(action, option);
     if (callback) {
       promise.then(
         function(result) {

package/dist/js/action_creator.umd.js

@@ -1,6 +1,6 @@
 /**
  * YAGO Event Kit - Action Creator (Core Only)
- * @version 1.0.6
+ * @version 1.0.7
  *
  * Generated by build script - do not edit manually.
  * Supports: Browser script tag, CommonJS, AMD

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yagolive/event-kit",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "YAGO Event Kit - 跨环境 Action 创建与通信工具库，支持浏览器、React、Vue",
   "main": "src/index.js",
   "browser": "dist/js/action_bridge.umd.js",

package/src/adapters/MockAdapter.js

@@ -15,13 +15,14 @@ export default class MockAdapter {
   init() {}
   destroy() { this._calls = []; this._mockResults = {}; }
 
-  sendAction(action) {
+  sendAction(action, option) {
     var self = this;
     this._calls.push({
       type: action.type,
       data: action.data != null ? action.data.toMap() : {},
       messageId: action.messageId,
       timestamp: Date.now(),
+      option: option,
     });
     return new Promise(function (resolve, reject) {
       var mockResult = self._mockResults[action.type];

package/src/adapters/RNWebViewAdapter.js

@@ -29,17 +29,21 @@ export default class RNWebViewAdapter {
     this._callbacks = {};
   }
 
-  sendAction(action) {
+  sendAction(action, option) {
     var self = this;
     var messageId = 'msg_' + Date.now() + '_' + Math.random().toString(36).substr(2, 9);
     action.messageId = messageId;
+    var timeout = option && option.timeout != null ? option.timeout : self._timeout;
     return new Promise(function (resolve, reject) {
-      var timer = setTimeout(function () {
-        delete self._callbacks[messageId];
-        reject(new Error('[ActionBridge] Timeout: no response for action ' + action.type));
-      }, self._timeout);
+      var timer = null;
+      if (timeout > 0) {
+        timer = setTimeout(function () {
+          delete self._callbacks[messageId];
+          reject(new Error('[ActionBridge] Timeout: no response for action ' + action.type));
+        }, timeout);
+      }
       self._callbacks[messageId] = function (result, error) {
-        clearTimeout(timer);
+        if (timer) clearTimeout(timer);
         delete self._callbacks[messageId];
         if (error) reject(error);
         else resolve(result);

package/src/adapters/index.d.ts

@@ -1,7 +1,10 @@
-import { Action, Jump, Navigate, Replace, EnterRoom, LiveDetect, Onelink, ActionType, ActionData, ActionCreator } from '../core/index.js';
+export interface SendActionOption {
+  /** 单次发送的超时时间(毫秒)。默认使用全局 timeout,仅当 timeout>0 时启用超时检测 */
+  timeout?: number;
+}
 
 export interface IActionAdapter {
-  sendAction(action: any): Promise<any>;
+  sendAction(action: any, option?: SendActionOption): Promise<any>;
   sendActionNoReply?(action: any): void;
   init?(): void;
   destroy?(): void;
@@ -13,7 +16,7 @@ export interface AdapterOptions {
 
 export declare class RNWebViewAdapter implements IActionAdapter {
   constructor(options?: AdapterOptions);
-  sendAction(action: any): Promise<any>;
+  sendAction(action: any, option?: SendActionOption): Promise<any>;
   sendActionNoReply(action: any): void;
   init(): void;
   destroy(): void;
@@ -24,6 +27,7 @@ export interface MockCall {
   data: Record<string, any>;
   messageId: string;
   timestamp: number;
+  option?: SendActionOption;
 }
 
 export interface MockAdapterOptions extends AdapterOptions {
@@ -37,7 +41,7 @@ export declare class MockAdapter implements IActionAdapter {
   getCalls(): MockCall[];
   clearCalls(): this;
   clearMocks(): this;
-  sendAction(action: any): Promise<any>;
+  sendAction(action: any, option?: SendActionOption): Promise<any>;
   sendActionNoReply(action: any): void;
   init(): void;
   destroy(): void;

package/src/bridge/ActionBridge.js

@@ -24,8 +24,12 @@ export default class ActionBridge {
     return ActionData;
   }
 
-  sendAction(action, callback) {
-    var promise = this._adapter.sendAction(action);
+  sendAction(action, callback, option) {
+    if (callback && typeof callback === 'object' && option === undefined) {
+      option = callback;
+      callback = undefined;
+    }
+    var promise = this._adapter.sendAction(action, option);
     if (callback) {
       promise.then(
         function (result) {

package/src/bridge/index.d.ts

@@ -2,7 +2,7 @@ import {
   Action, Jump, Navigate, Replace, Goback, EnterRoom, LiveDetect, Onelink, AgencyInvite, Recharge, Close, Config,
   ActionType, ActionData, ActionCreator,
 } from '../core/index.js';
-import { IActionAdapter, RNWebViewAdapter, MockAdapter, AdapterOptions } from '../adapters/index.js';
+import { IActionAdapter, RNWebViewAdapter, MockAdapter, AdapterOptions, SendActionOption } from '../adapters/index.js';
 
 export declare class ActionBridge {
   constructor(adapter: IActionAdapter, options?: AdapterOptions);
@@ -11,7 +11,8 @@ export declare class ActionBridge {
   readonly ActionType: typeof ActionType;
   readonly ActionData: typeof ActionData;
 
-  sendAction(action: any, callback?: (result: any, error: any) => void): Promise<any>;
+  sendAction(action: any, callback?: (result: any, error: any) => void, option?: SendActionOption): Promise<any>;
+  sendAction(action: any, option?: SendActionOption): Promise<any>;
   sendActionNoReply(action: any): void;
 
   jump(path: string): Promise<any>;