@yagolive/event-kit 1.0.6 → 1.0.8

package/CHANGELOG.md

@@ -1,5 +1,71 @@
 # Changelog
 
+## @1.0.8 (2026-06-17)
+
+### 新增
+
+- **Track Action（统计事件上报）**: 新增统计事件上报动作类型
+  - `ActionType.TRACK` = `'track'`
+  - `Track` 数据类：必填字段 `name`(string，事件名)；可选字段 `params`(Record，事件参数)、`options`(Record，事件选项)、`text`
+  - `ActionCreator.buildTrack(name)`、`createTrackAction(name)`、`createTrackActionWithData(track)`
+  - `ActionBridge.track(name, params?, options?)`、`buildTrack(name)`、`createTrackAction(name)`、`createTrackActionWithData(track)`
+  - `bridge.track(name, params, options)` 便捷方法支持传入事件参数和选项
+
+- **GrantBenefits Action（权益下发）**: 新增权益下发动作类型
+  - `ActionType.GRANT_BENEFITS` = `'grant_benefits'`
+  - `GrantBenefits` 数据类：必填字段 `benefits`(BSBenefit[]，下发权益列表)；可选字段 `title`(弹窗标题)、`message`(弹窗消息)、`okAction`(Action，确认按钮动作)、`closeable`(boolean，是否允许关闭，默认 true)、`duration`(number，自动关闭时间，单位 ms)、`theme`(弹窗主题配置)、`text`
+  - `GrantBenefits.Theme` 内部类：`image`(主题图片)、`tintColor`(主题色)、`buttonImage`(按钮图片，可选)、`topInset`(头部高度，默认 196)
+  - `ActionCreator.buildGrantBenefits(benefits)`、`createGrantBenefitsAction(benefits)`、`createGrantBenefitsActionWithData(grantBenefits)`
+  - `ActionBridge.grantBenefits(benefits, options?)`、`buildGrantBenefits(benefits)`、`createGrantBenefitsAction(benefits)`、`createGrantBenefitsActionWithData(grantBenefits)`
+  - `bridge.grantBenefits(benefits, options)` 便捷方法支持传入可选配置对象
+
+### Action 类型完整列表
+
+| 类型 | 字段 | 说明 |
+|------|------|------|
+| jump | path: string, text?: string | 页面跳转 |
+| navigate | screen: string, params?: Record, text?: string | 导航到指定屏幕 |
+| replace | screen: string, params?: Record, text?: string | 替换当前页面 |
+| goback | text?: string | 返回上一页 |
+| enter_room | id?: number, match?: string, callbacks?: Record, useReplace?: boolean, text?: string | 进入房间 |
+| live_detect | text?: string | 活体检测 |
+| onelink | url: string, share?: boolean, text?: string | 分享链接 |
+| agency_invite | id: number, type: string, title?: string, message?: string, agencyInfo?: AgencyInfo, accepted?: boolean, text?: string | 工会邀请 |
+| recharge | text?: string | 充值操作 |
+| close | text?: string | 关闭 WebView 窗口（addon 附加） |
+| config | theme?: 'dark' \| 'light', brandColor?: string, tintColor?: string, title?: string, text?: string | 配置 WebView 主题（addon 附加） |
+| track | name: string, params?: Record, options?: Record, text?: string | 统计事件上报 |
+| grant_benefits | benefits: any[], title?: string, message?: string, okAction?: Action, closeable?: boolean, duration?: number, theme?: { image, tintColor, buttonImage?, topInset? }, text?: string | 权益下发 |
+
+---
+
+## @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

@@ -169,8 +169,8 @@ import { ActionCreator } from '@yagolive/event-kit';
 
 | 属性 | 类型 | 说明 |
 |------|------|------|
-| `ActionData` | Object | 包含所有数据类型类：Jump, Navigate, Replace, Goback, EnterRoom, LiveDetect, Onelink, AgencyInvite, Recharge, Close, Config |
-| `ActionType` | Object | Action 类型枚举：JUMP, NAVIGATE, REPLACE, GOBACK, ENTER_ROOM, LIVE_DETECT, ONELINK, AGENCY_INVITE, RECHARGE, CLOSE, CONFIG |
+| `ActionData` | Object | 包含所有数据类型类：Jump, Navigate, Replace, Goback, EnterRoom, LiveDetect, Onelink, AgencyInvite, Recharge, Close, Config, Track, GrantBenefits |
+| `ActionType` | Object | Action 类型枚举：JUMP, NAVIGATE, REPLACE, GOBACK, ENTER_ROOM, LIVE_DETECT, ONELINK, AGENCY_INVITE, RECHARGE, CLOSE, CONFIG, TRACK, GRANT_BENEFITS |
 
 #### 工厂方法
 
@@ -211,6 +211,12 @@ import { ActionCreator } from '@yagolive/event-kit';
 | `buildConfig()` | - | Config | 构建 Config 对象（链式配置，addon） |
 | `createConfigAction()` | - | Action | 创建配置 Action（addon） |
 | `createConfigActionWithData(config)` | config: Config | Action | 从 Config 对象创建 Action（addon） |
+| `buildTrack(name)` | name: string | Track | 构建 Track 对象（链式配置） |
+| `createTrackAction(name)` | name: string | Action | 创建统计事件上报 Action |
+| `createTrackActionWithData(track)` | track: Track | Action | 从 Track 对象创建 Action |
+| `buildGrantBenefits(benefits)` | benefits: any[] | GrantBenefits | 构建 GrantBenefits 对象（链式配置） |
+| `createGrantBenefitsAction(benefits)` | benefits: any[] | Action | 创建权益下发 Action |
+| `createGrantBenefitsActionWithData(grantBenefits)` | grantBenefits: GrantBenefits | Action | 从 GrantBenefits 对象创建 Action |
 
 #### 使用示例
 
@@ -255,6 +261,8 @@ ActionType.AGENCY_INVITE // 'agency_invite'
 ActionType.RECHARGE     // 'recharge'
 ActionType.CLOSE        // 'close'   (addon)
 ActionType.CONFIG       // 'config'  (addon)
+ActionType.TRACK        // 'track'
+ActionType.GRANT_BENEFITS // 'grant_benefits'
 ```
 
 ### ActionBridge
@@ -334,6 +342,12 @@ new ActionBridge(adapter, options?)
 | `config(options?)` | options?: { theme?: 'dark' \| 'light', brandColor?: string, tintColor?: string, title?: string } | Promise | 配置 WebView 主题色（addon） |
 | `buildConfig()` | - | Config | 构建 Config 对象（链式配置，addon） |
 | `createConfigActionWithData(config)` | config: Config | Action | 从 Config 对象创建 Action（addon） |
+| `track(name, params?, options?)` | name: string, params?: Object, options?: Object | Promise | 统计事件上报 |
+| `buildTrack(name)` | name: string | Track | 构建 Track 对象（链式配置） |
+| `createTrackActionWithData(track)` | track: Track | Action | 从 Track 对象创建 Action（不自动发送） |
+| `grantBenefits(benefits, options?)` | benefits: any[], options?: { title?, message?, okAction?, closeable?, duration?, theme?, text? } | Promise | 权益下发 |
+| `buildGrantBenefits(benefits)` | benefits: any[] | GrantBenefits | 构建 GrantBenefits 对象（链式配置） |
+| `createGrantBenefitsActionWithData(grantBenefits)` | grantBenefits: GrantBenefits | Action | 从 GrantBenefits 对象创建 Action（不自动发送） |
 
 #### 静态方法
 
@@ -363,6 +377,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();
 ```
@@ -729,6 +747,49 @@ Onelink Action 数据。
 - `Config.Theme.DARK` = `'dark'`
 - `Config.Theme.LIGHT` = `'light'`
 
+### Track
+
+统计事件上报 Action 数据。
+
+| 方法 | 参数 | 说明 |
+|------|------|------|
+| `constructor(name)` | name: string (必填) | 创建 Track 数据 |
+| `setText(text)` | text: string | 设置显示文本，返回 this |
+| `setName(name)` | name: string (必填) | 设置事件名，返回 this |
+| `setParams(params)` | params: Record<string, any> | 设置事件参数，返回 this |
+| `setOptions(options)` | options: Record<string, any> | 设置事件选项，返回 this |
+
+### GrantBenefits
+
+权益下发 Action 数据。
+
+| 方法 | 参数 | 说明 |
+|------|------|------|
+| `constructor(benefits)` | benefits: any[] (必填) | 创建 GrantBenefits 数据 |
+| `setText(text)` | text: string | 设置显示文本，返回 this |
+| `setBenefits(benefits)` | benefits: any[] (必填) | 设置权益列表，返回 this |
+| `setTitle(title)` | title: string | 设置弹窗标题，返回 this |
+| `setMessage(message)` | message: string | 设置弹窗消息，返回 this |
+| `setOkAction(okAction)` | okAction: Action | 设置确认按钮动作，返回 this |
+| `setCloseable(closeable)` | closeable: boolean | 设置是否允许关闭，返回 this |
+| `setDuration(duration)` | duration: number | 设置自动关闭时间（毫秒），返回 this |
+| `setTheme(theme)` | theme: Theme | 设置弹窗主题配置，返回 this |
+
+**静态属性：**
+
+| 属性 | 说明 |
+|------|------|
+| `GrantBenefits.Theme` | 弹窗主题配置内部类 |
+
+**Theme 内部类：**
+
+| 方法 | 参数 | 说明 |
+|------|------|------|
+| `setImage(image)` | image: string (必填) | 设置主题图片，返回 this |
+| `setTintColor(tintColor)` | tintColor: string (必填) | 设置主题色，返回 this |
+| `setButtonImage(buttonImage)` | buttonImage: string | 设置按钮图片，返回 this |
+| `setTopInset(topInset)` | topInset: number | 设置头部高度（默认 196），返回 this |
+
 ### Action
 
 Action 对象，封装类型和数据。

package/dist/js/action_bridge.umd.js

@@ -1,6 +1,6 @@
 /**
  * YAGO Event Kit - Action Bridge (Full)
- * @version 1.0.6
+ * @version 1.0.8
  *
  * Generated by build script - do not edit manually.
  * Supports: Browser script tag, CommonJS, AMD
@@ -593,6 +593,195 @@ Config.Theme = {
 };
 var Config_default = Config;
 
+// src/core/types/Track.js
+var Track = class {
+  constructor(name) {
+    this.text = null;
+    if (name == null) {
+      throw new Error("name cannot be null");
+    }
+    this.name = name;
+    this.params = null;
+    this.options = null;
+  }
+  getText() {
+    return this.text;
+  }
+  setText(text) {
+    this.text = text;
+    return this;
+  }
+  getName() {
+    return this.name;
+  }
+  setName(name) {
+    if (name == null) throw new Error("name cannot be null");
+    this.name = name;
+    return this;
+  }
+  getParams() {
+    return this.params;
+  }
+  setParams(params) {
+    this.params = params != null ? params : null;
+    return this;
+  }
+  getOptions() {
+    return this.options;
+  }
+  setOptions(options) {
+    this.options = options != null ? options : null;
+    return this;
+  }
+  toMap() {
+    const map = {};
+    if (this.text != null) map.text = this.text;
+    if (this.name != null) map.name = this.name;
+    if (this.params != null) map.params = this.params;
+    if (this.options != null) map.options = this.options;
+    return map;
+  }
+};
+var Track_default = Track;
+
+// src/core/types/GrantBenefits.js
+var Theme = class {
+  constructor() {
+    this.image = null;
+    this.tintColor = null;
+    this.buttonImage = null;
+    this.topInset = null;
+  }
+  getImage() {
+    return this.image;
+  }
+  setImage(image) {
+    this.image = image;
+    return this;
+  }
+  getTintColor() {
+    return this.tintColor;
+  }
+  setTintColor(tintColor) {
+    this.tintColor = tintColor;
+    return this;
+  }
+  getButtonImage() {
+    return this.buttonImage;
+  }
+  setButtonImage(buttonImage) {
+    this.buttonImage = buttonImage;
+    return this;
+  }
+  getTopInset() {
+    return this.topInset;
+  }
+  setTopInset(topInset) {
+    this.topInset = topInset;
+    return this;
+  }
+  toMap() {
+    const map = {};
+    if (this.image != null) map.image = this.image;
+    if (this.tintColor != null) map.tintColor = this.tintColor;
+    if (this.buttonImage != null) map.buttonImage = this.buttonImage;
+    if (this.topInset != null) map.topInset = this.topInset;
+    return map;
+  }
+};
+var GrantBenefits = class {
+  constructor(benefits) {
+    this.text = null;
+    if (benefits == null) {
+      throw new Error("benefits cannot be null");
+    }
+    this.benefits = benefits;
+    this.title = null;
+    this.message = null;
+    this.okAction = null;
+    this.closeable = null;
+    this.duration = null;
+    this.theme = null;
+  }
+  getText() {
+    return this.text;
+  }
+  setText(text) {
+    this.text = text;
+    return this;
+  }
+  getBenefits() {
+    return this.benefits;
+  }
+  setBenefits(benefits) {
+    if (benefits == null) throw new Error("benefits cannot be null");
+    this.benefits = benefits;
+    return this;
+  }
+  getTitle() {
+    return this.title;
+  }
+  setTitle(title) {
+    this.title = title;
+    return this;
+  }
+  getMessage() {
+    return this.message;
+  }
+  setMessage(message) {
+    this.message = message;
+    return this;
+  }
+  getOkAction() {
+    return this.okAction;
+  }
+  setOkAction(okAction) {
+    this.okAction = okAction;
+    return this;
+  }
+  getCloseable() {
+    return this.closeable;
+  }
+  setCloseable(closeable) {
+    this.closeable = closeable;
+    return this;
+  }
+  getDuration() {
+    return this.duration;
+  }
+  setDuration(duration) {
+    this.duration = duration;
+    return this;
+  }
+  getTheme() {
+    return this.theme;
+  }
+  setTheme(theme) {
+    this.theme = theme;
+    return this;
+  }
+  toMap() {
+    const map = {};
+    if (this.text != null) map.text = this.text;
+    if (this.title != null) map.title = this.title;
+    if (this.message != null) map.message = this.message;
+    if (this.benefits != null) map.benefits = this.benefits;
+    if (this.okAction != null) {
+      if (typeof this.okAction.toMap === "function") {
+        map.okAction = this.okAction.toMap();
+      } else {
+        map.okAction = this.okAction;
+      }
+    }
+    if (this.closeable != null) map.closeable = this.closeable;
+    if (this.duration != null) map.duration = this.duration;
+    if (this.theme != null) map.theme = this.theme.toMap();
+    return map;
+  }
+};
+GrantBenefits.Theme = Theme;
+var GrantBenefits_default = GrantBenefits;
+
 // src/core/types/Action.js
 var Action = class {
   constructor(type, data) {
@@ -641,7 +830,9 @@ var ActionType = {
   AGENCY_INVITE: "agency_invite",
   RECHARGE: "recharge",
   CLOSE: "close",
-  CONFIG: "config"
+  CONFIG: "config",
+  TRACK: "track",
+  GRANT_BENEFITS: "grant_benefits"
 };
 var ActionData = {
   Jump: Jump_default,
@@ -654,7 +845,9 @@ var ActionData = {
   AgencyInvite: AgencyInvite_default,
   Recharge: Recharge_default,
   Close: Close_default,
-  Config: Config_default
+  Config: Config_default,
+  Track: Track_default,
+  GrantBenefits: GrantBenefits_default
 };
 var ActionCreator = {
   ActionData,
@@ -776,6 +969,26 @@ var ActionCreator = {
   },
   createConfigActionWithData(config) {
     return new Action_default(ActionType.CONFIG, config);
+  },
+  // Track
+  buildTrack(name) {
+    return new Track_default(name);
+  },
+  createTrackAction(name) {
+    return new Action_default(ActionType.TRACK, new Track_default(name));
+  },
+  createTrackActionWithData(track) {
+    return new Action_default(ActionType.TRACK, track);
+  },
+  // GrantBenefits
+  buildGrantBenefits(benefits) {
+    return new GrantBenefits_default(benefits);
+  },
+  createGrantBenefitsAction(benefits) {
+    return new Action_default(ActionType.GRANT_BENEFITS, new GrantBenefits_default(benefits));
+  },
+  createGrantBenefitsActionWithData(grantBenefits) {
+    return new Action_default(ActionType.GRANT_BENEFITS, grantBenefits);
   }
 };
 
@@ -806,17 +1019,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 +1099,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 +1148,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) {
@@ -1094,6 +1316,43 @@ var ActionBridge = class _ActionBridge {
   createConfigActionWithData(config) {
     return ActionCreator.createConfigActionWithData(config);
   }
+  track(name, params, options) {
+    var data = ActionCreator.buildTrack(name);
+    if (params != null) data.setParams(params);
+    if (options != null) data.setOptions(options);
+    return this._adapter.sendAction(ActionCreator.createTrackActionWithData(data));
+  }
+  buildTrack(name) {
+    return ActionCreator.buildTrack(name);
+  }
+  createTrackAction(name) {
+    return ActionCreator.createTrackAction(name);
+  }
+  createTrackActionWithData(track) {
+    return ActionCreator.createTrackActionWithData(track);
+  }
+  grantBenefits(benefits, options) {
+    var data = ActionCreator.buildGrantBenefits(benefits);
+    if (options) {
+      if (options.title != null) data.setTitle(options.title);
+      if (options.message != null) data.setMessage(options.message);
+      if (options.okAction != null) data.setOkAction(options.okAction);
+      if (options.closeable != null) data.setCloseable(options.closeable);
+      if (options.duration != null) data.setDuration(options.duration);
+      if (options.theme != null) data.setTheme(options.theme);
+      if (options.text != null) data.setText(options.text);
+    }
+    return this._adapter.sendAction(ActionCreator.createGrantBenefitsActionWithData(data));
+  }
+  buildGrantBenefits(benefits) {
+    return ActionCreator.buildGrantBenefits(benefits);
+  }
+  createGrantBenefitsAction(benefits) {
+    return ActionCreator.createGrantBenefitsAction(benefits);
+  }
+  createGrantBenefitsActionWithData(grantBenefits) {
+    return ActionCreator.createGrantBenefitsActionWithData(grantBenefits);
+  }
   destroy() {
     if (typeof this._adapter.destroy === "function") {
       this._adapter.destroy();

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.8
  *
  * Generated by build script - do not edit manually.
  * Supports: Browser script tag, CommonJS, AMD
@@ -593,6 +593,195 @@ Config.Theme = {
 };
 var Config_default = Config;
 
+// src/core/types/Track.js
+var Track = class {
+  constructor(name) {
+    this.text = null;
+    if (name == null) {
+      throw new Error("name cannot be null");
+    }
+    this.name = name;
+    this.params = null;
+    this.options = null;
+  }
+  getText() {
+    return this.text;
+  }
+  setText(text) {
+    this.text = text;
+    return this;
+  }
+  getName() {
+    return this.name;
+  }
+  setName(name) {
+    if (name == null) throw new Error("name cannot be null");
+    this.name = name;
+    return this;
+  }
+  getParams() {
+    return this.params;
+  }
+  setParams(params) {
+    this.params = params != null ? params : null;
+    return this;
+  }
+  getOptions() {
+    return this.options;
+  }
+  setOptions(options) {
+    this.options = options != null ? options : null;
+    return this;
+  }
+  toMap() {
+    const map = {};
+    if (this.text != null) map.text = this.text;
+    if (this.name != null) map.name = this.name;
+    if (this.params != null) map.params = this.params;
+    if (this.options != null) map.options = this.options;
+    return map;
+  }
+};
+var Track_default = Track;
+
+// src/core/types/GrantBenefits.js
+var Theme = class {
+  constructor() {
+    this.image = null;
+    this.tintColor = null;
+    this.buttonImage = null;
+    this.topInset = null;
+  }
+  getImage() {
+    return this.image;
+  }
+  setImage(image) {
+    this.image = image;
+    return this;
+  }
+  getTintColor() {
+    return this.tintColor;
+  }
+  setTintColor(tintColor) {
+    this.tintColor = tintColor;
+    return this;
+  }
+  getButtonImage() {
+    return this.buttonImage;
+  }
+  setButtonImage(buttonImage) {
+    this.buttonImage = buttonImage;
+    return this;
+  }
+  getTopInset() {
+    return this.topInset;
+  }
+  setTopInset(topInset) {
+    this.topInset = topInset;
+    return this;
+  }
+  toMap() {
+    const map = {};
+    if (this.image != null) map.image = this.image;
+    if (this.tintColor != null) map.tintColor = this.tintColor;
+    if (this.buttonImage != null) map.buttonImage = this.buttonImage;
+    if (this.topInset != null) map.topInset = this.topInset;
+    return map;
+  }
+};
+var GrantBenefits = class {
+  constructor(benefits) {
+    this.text = null;
+    if (benefits == null) {
+      throw new Error("benefits cannot be null");
+    }
+    this.benefits = benefits;
+    this.title = null;
+    this.message = null;
+    this.okAction = null;
+    this.closeable = null;
+    this.duration = null;
+    this.theme = null;
+  }
+  getText() {
+    return this.text;
+  }
+  setText(text) {
+    this.text = text;
+    return this;
+  }
+  getBenefits() {
+    return this.benefits;
+  }
+  setBenefits(benefits) {
+    if (benefits == null) throw new Error("benefits cannot be null");
+    this.benefits = benefits;
+    return this;
+  }
+  getTitle() {
+    return this.title;
+  }
+  setTitle(title) {
+    this.title = title;
+    return this;
+  }
+  getMessage() {
+    return this.message;
+  }
+  setMessage(message) {
+    this.message = message;
+    return this;
+  }
+  getOkAction() {
+    return this.okAction;
+  }
+  setOkAction(okAction) {
+    this.okAction = okAction;
+    return this;
+  }
+  getCloseable() {
+    return this.closeable;
+  }
+  setCloseable(closeable) {
+    this.closeable = closeable;
+    return this;
+  }
+  getDuration() {
+    return this.duration;
+  }
+  setDuration(duration) {
+    this.duration = duration;
+    return this;
+  }
+  getTheme() {
+    return this.theme;
+  }
+  setTheme(theme) {
+    this.theme = theme;
+    return this;
+  }
+  toMap() {
+    const map = {};
+    if (this.text != null) map.text = this.text;
+    if (this.title != null) map.title = this.title;
+    if (this.message != null) map.message = this.message;
+    if (this.benefits != null) map.benefits = this.benefits;
+    if (this.okAction != null) {
+      if (typeof this.okAction.toMap === "function") {
+        map.okAction = this.okAction.toMap();
+      } else {
+        map.okAction = this.okAction;
+      }
+    }
+    if (this.closeable != null) map.closeable = this.closeable;
+    if (this.duration != null) map.duration = this.duration;
+    if (this.theme != null) map.theme = this.theme.toMap();
+    return map;
+  }
+};
+GrantBenefits.Theme = Theme;
+var GrantBenefits_default = GrantBenefits;
+
 // src/core/types/Action.js
 var Action = class {
   constructor(type, data) {
@@ -641,7 +830,9 @@ var ActionType = {
   AGENCY_INVITE: "agency_invite",
   RECHARGE: "recharge",
   CLOSE: "close",
-  CONFIG: "config"
+  CONFIG: "config",
+  TRACK: "track",
+  GRANT_BENEFITS: "grant_benefits"
 };
 var ActionData = {
   Jump: Jump_default,
@@ -654,7 +845,9 @@ var ActionData = {
   AgencyInvite: AgencyInvite_default,
   Recharge: Recharge_default,
   Close: Close_default,
-  Config: Config_default
+  Config: Config_default,
+  Track: Track_default,
+  GrantBenefits: GrantBenefits_default
 };
 var ActionCreator = {
   ActionData,
@@ -776,6 +969,26 @@ var ActionCreator = {
   },
   createConfigActionWithData(config) {
     return new Action_default(ActionType.CONFIG, config);
+  },
+  // Track
+  buildTrack(name) {
+    return new Track_default(name);
+  },
+  createTrackAction(name) {
+    return new Action_default(ActionType.TRACK, new Track_default(name));
+  },
+  createTrackActionWithData(track) {
+    return new Action_default(ActionType.TRACK, track);
+  },
+  // GrantBenefits
+  buildGrantBenefits(benefits) {
+    return new GrantBenefits_default(benefits);
+  },
+  createGrantBenefitsAction(benefits) {
+    return new Action_default(ActionType.GRANT_BENEFITS, new GrantBenefits_default(benefits));
+  },
+  createGrantBenefitsActionWithData(grantBenefits) {
+    return new Action_default(ActionType.GRANT_BENEFITS, grantBenefits);
   }
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yagolive/event-kit",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "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) {
@@ -216,6 +220,47 @@ export default class ActionBridge {
     return ActionCreator.createConfigActionWithData(config);
   }
 
+  track(name, params, options) {
+    var data = ActionCreator.buildTrack(name);
+    if (params != null) data.setParams(params);
+    if (options != null) data.setOptions(options);
+    return this._adapter.sendAction(ActionCreator.createTrackActionWithData(data));
+  }
+
+  buildTrack(name) {
+    return ActionCreator.buildTrack(name);
+  }
+  createTrackAction(name) {
+    return ActionCreator.createTrackAction(name);
+  }
+  createTrackActionWithData(track) {
+    return ActionCreator.createTrackActionWithData(track);
+  }
+
+  grantBenefits(benefits, options) {
+    var data = ActionCreator.buildGrantBenefits(benefits);
+    if (options) {
+      if (options.title != null) data.setTitle(options.title);
+      if (options.message != null) data.setMessage(options.message);
+      if (options.okAction != null) data.setOkAction(options.okAction);
+      if (options.closeable != null) data.setCloseable(options.closeable);
+      if (options.duration != null) data.setDuration(options.duration);
+      if (options.theme != null) data.setTheme(options.theme);
+      if (options.text != null) data.setText(options.text);
+    }
+    return this._adapter.sendAction(ActionCreator.createGrantBenefitsActionWithData(data));
+  }
+
+  buildGrantBenefits(benefits) {
+    return ActionCreator.buildGrantBenefits(benefits);
+  }
+  createGrantBenefitsAction(benefits) {
+    return ActionCreator.createGrantBenefitsAction(benefits);
+  }
+  createGrantBenefitsActionWithData(grantBenefits) {
+    return ActionCreator.createGrantBenefitsActionWithData(grantBenefits);
+  }
+
   destroy() {
     if (typeof this._adapter.destroy === 'function') {
       this._adapter.destroy();

package/src/bridge/index.d.ts

@@ -1,8 +1,8 @@
 import {
-  Action, Jump, Navigate, Replace, Goback, EnterRoom, LiveDetect, Onelink, AgencyInvite, Recharge, Close, Config,
+  Action, Jump, Navigate, Replace, Goback, EnterRoom, LiveDetect, Onelink, AgencyInvite, Recharge, Close, Config, Track, GrantBenefits,
   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>;
@@ -71,6 +72,16 @@ export declare class ActionBridge {
   createConfigAction(): Action;
   createConfigActionWithData(config: Config): Action;
 
+  track(name: string, params?: Record<string, any>, options?: Record<string, any>): Promise<any>;
+  buildTrack(name: string): Track;
+  createTrackAction(name: string): Action;
+  createTrackActionWithData(track: Track): Action;
+
+  grantBenefits(benefits: any[], options?: { title?: string; message?: string; okAction?: Action; closeable?: boolean; duration?: number; theme?: any; text?: string }): Promise<any>;
+  buildGrantBenefits(benefits: any[]): GrantBenefits;
+  createGrantBenefitsAction(benefits: any[]): Action;
+  createGrantBenefitsActionWithData(grantBenefits: GrantBenefits): Action;
+
   destroy(): void;
 
   static ActionCreator: typeof ActionCreator;

package/src/core/ActionCreator.js

@@ -9,6 +9,8 @@ import AgencyInvite from './types/AgencyInvite.js';
 import Recharge from './types/Recharge.js';
 import Close from './types/Close.js';
 import Config from './types/Config.js';
+import Track from './types/Track.js';
+import GrantBenefits from './types/GrantBenefits.js';
 import Action from './types/Action.js';
 
 const ActionType = {
@@ -23,6 +25,8 @@ const ActionType = {
   RECHARGE: 'recharge',
   CLOSE: 'close',
   CONFIG: 'config',
+  TRACK: 'track',
+  GRANT_BENEFITS: 'grant_benefits',
 };
 
 const ActionData = {
@@ -37,6 +41,8 @@ const ActionData = {
   Recharge,
   Close,
   Config,
+  Track,
+  GrantBenefits,
 };
 
 const ActionCreator = {
@@ -195,6 +201,32 @@ const ActionCreator = {
   createConfigActionWithData(config) {
     return new Action(ActionType.CONFIG, config);
   },
+
+  // Track
+  buildTrack(name) {
+    return new Track(name);
+  },
+
+  createTrackAction(name) {
+    return new Action(ActionType.TRACK, new Track(name));
+  },
+
+  createTrackActionWithData(track) {
+    return new Action(ActionType.TRACK, track);
+  },
+
+  // GrantBenefits
+  buildGrantBenefits(benefits) {
+    return new GrantBenefits(benefits);
+  },
+
+  createGrantBenefitsAction(benefits) {
+    return new Action(ActionType.GRANT_BENEFITS, new GrantBenefits(benefits));
+  },
+
+  createGrantBenefitsActionWithData(grantBenefits) {
+    return new Action(ActionType.GRANT_BENEFITS, grantBenefits);
+  },
 };
 
 export { ActionCreator, ActionData, ActionType };

package/src/core/index.d.ts

@@ -225,6 +225,70 @@ export class Config {
   toMap(): Record<string, any>;
 }
 
+export class Track {
+  constructor(name: string);
+  text: string | null;
+  name: string;
+  params: Record<string, any> | null;
+  options: Record<string, any> | null;
+  getText(): string | null;
+  setText(text: string): this;
+  getName(): string;
+  setName(name: string): this;
+  getParams(): Record<string, any> | null;
+  setParams(params: Record<string, any>): this;
+  getOptions(): Record<string, any> | null;
+  setOptions(options: Record<string, any>): this;
+  toMap(): Record<string, any>;
+}
+
+export class GrantBenefitsTheme {
+  constructor();
+  image: string | null;
+  tintColor: string | null;
+  buttonImage: string | null;
+  topInset: number | null;
+  getImage(): string | null;
+  setImage(image: string): this;
+  getTintColor(): string | null;
+  setTintColor(tintColor: string): this;
+  getButtonImage(): string | null;
+  setButtonImage(buttonImage: string): this;
+  getTopInset(): number | null;
+  setTopInset(topInset: number): this;
+  toMap(): Record<string, any>;
+}
+
+export class GrantBenefits {
+  constructor(benefits: any[]);
+  text: string | null;
+  benefits: any[];
+  title: string | null;
+  message: string | null;
+  okAction: Action | null;
+  closeable: boolean | null;
+  duration: number | null;
+  theme: GrantBenefitsTheme | null;
+  static Theme: typeof GrantBenefitsTheme;
+  getText(): string | null;
+  setText(text: string): this;
+  getBenefits(): any[];
+  setBenefits(benefits: any[]): this;
+  getTitle(): string | null;
+  setTitle(title: string): this;
+  getMessage(): string | null;
+  setMessage(message: string): this;
+  getOkAction(): Action | null;
+  setOkAction(okAction: Action): this;
+  getCloseable(): boolean | null;
+  setCloseable(closeable: boolean): this;
+  getDuration(): number | null;
+  setDuration(duration: number): this;
+  getTheme(): GrantBenefitsTheme | null;
+  setTheme(theme: GrantBenefitsTheme): this;
+  toMap(): Record<string, any>;
+}
+
 export class Action {
   constructor(type: ActionTypeValue, data: any);
   type: ActionTypeValue;
@@ -238,7 +302,7 @@ export class Action {
   toJson(): string;
 }
 
-export type ActionTypeValue = 'jump' | 'navigate' | 'replace' | 'goback' | 'enter_room' | 'live_detect' | 'onelink' | 'agency_invite' | 'recharge' | 'close' | 'config';
+export type ActionTypeValue = 'jump' | 'navigate' | 'replace' | 'goback' | 'enter_room' | 'live_detect' | 'onelink' | 'agency_invite' | 'recharge' | 'close' | 'config' | 'track' | 'grant_benefits';
 
 export const ActionType: {
   JUMP: 'jump';
@@ -252,6 +316,8 @@ export const ActionType: {
   RECHARGE: 'recharge';
   CLOSE: 'close';
   CONFIG: 'config';
+  TRACK: 'track';
+  GRANT_BENEFITS: 'grant_benefits';
 };
 
 export const ActionData: {
@@ -266,6 +332,8 @@ export const ActionData: {
   Recharge: typeof Recharge;
   Close: typeof Close;
   Config: typeof Config;
+  Track: typeof Track;
+  GrantBenefits: typeof GrantBenefits;
 };
 
 export const ActionCreator: {
@@ -306,4 +374,10 @@ export const ActionCreator: {
   buildConfig(): Config;
   createConfigAction(): Action;
   createConfigActionWithData(config: Config): Action;
+  buildTrack(name: string): Track;
+  createTrackAction(name: string): Action;
+  createTrackActionWithData(track: Track): Action;
+  buildGrantBenefits(benefits: any[]): GrantBenefits;
+  createGrantBenefitsAction(benefits: any[]): Action;
+  createGrantBenefitsActionWithData(grantBenefits: GrantBenefits): Action;
 };

package/src/core/index.js

@@ -10,4 +10,6 @@ export { default as AgencyInvite } from './types/AgencyInvite.js';
 export { default as Recharge } from './types/Recharge.js';
 export { default as Close } from './types/Close.js';
 export { default as Config } from './types/Config.js';
+export { default as Track } from './types/Track.js';
+export { default as GrantBenefits } from './types/GrantBenefits.js';
 export { default as Action } from './types/Action.js';

package/src/core/types/GrantBenefits.js

@@ -0,0 +1,86 @@
+class Theme {
+  constructor() {
+    this.image = null;
+    this.tintColor = null;
+    this.buttonImage = null;
+    this.topInset = null;
+  }
+
+  getImage() { return this.image; }
+  setImage(image) { this.image = image; return this; }
+  getTintColor() { return this.tintColor; }
+  setTintColor(tintColor) { this.tintColor = tintColor; return this; }
+  getButtonImage() { return this.buttonImage; }
+  setButtonImage(buttonImage) { this.buttonImage = buttonImage; return this; }
+  getTopInset() { return this.topInset; }
+  setTopInset(topInset) { this.topInset = topInset; return this; }
+
+  toMap() {
+    const map = {};
+    if (this.image != null) map.image = this.image;
+    if (this.tintColor != null) map.tintColor = this.tintColor;
+    if (this.buttonImage != null) map.buttonImage = this.buttonImage;
+    if (this.topInset != null) map.topInset = this.topInset;
+    return map;
+  }
+}
+
+class GrantBenefits {
+  constructor(benefits) {
+    this.text = null;
+    if (benefits == null) {
+      throw new Error('benefits cannot be null');
+    }
+    this.benefits = benefits;
+    this.title = null;
+    this.message = null;
+    this.okAction = null;
+    this.closeable = null;
+    this.duration = null;
+    this.theme = null;
+  }
+
+  getText() { return this.text; }
+  setText(text) { this.text = text; return this; }
+  getBenefits() { return this.benefits; }
+  setBenefits(benefits) {
+    if (benefits == null) throw new Error('benefits cannot be null');
+    this.benefits = benefits;
+    return this;
+  }
+  getTitle() { return this.title; }
+  setTitle(title) { this.title = title; return this; }
+  getMessage() { return this.message; }
+  setMessage(message) { this.message = message; return this; }
+  getOkAction() { return this.okAction; }
+  setOkAction(okAction) { this.okAction = okAction; return this; }
+  getCloseable() { return this.closeable; }
+  setCloseable(closeable) { this.closeable = closeable; return this; }
+  getDuration() { return this.duration; }
+  setDuration(duration) { this.duration = duration; return this; }
+  getTheme() { return this.theme; }
+  setTheme(theme) { this.theme = theme; return this; }
+
+  toMap() {
+    const map = {};
+    if (this.text != null) map.text = this.text;
+    if (this.title != null) map.title = this.title;
+    if (this.message != null) map.message = this.message;
+    if (this.benefits != null) map.benefits = this.benefits;
+    if (this.okAction != null) {
+      if (typeof this.okAction.toMap === 'function') {
+        map.okAction = this.okAction.toMap();
+      } else {
+        map.okAction = this.okAction;
+      }
+    }
+    if (this.closeable != null) map.closeable = this.closeable;
+    if (this.duration != null) map.duration = this.duration;
+    if (this.theme != null) map.theme = this.theme.toMap();
+    return map;
+  }
+}
+
+GrantBenefits.Theme = Theme;
+
+export default GrantBenefits;

package/src/core/types/Track.js

@@ -0,0 +1,35 @@
+class Track {
+  constructor(name) {
+    this.text = null;
+    if (name == null) {
+      throw new Error('name cannot be null');
+    }
+    this.name = name;
+    this.params = null;
+    this.options = null;
+  }
+
+  getText() { return this.text; }
+  setText(text) { this.text = text; return this; }
+  getName() { return this.name; }
+  setName(name) {
+    if (name == null) throw new Error('name cannot be null');
+    this.name = name;
+    return this;
+  }
+  getParams() { return this.params; }
+  setParams(params) { this.params = params != null ? params : null; return this; }
+  getOptions() { return this.options; }
+  setOptions(options) { this.options = options != null ? options : null; return this; }
+
+  toMap() {
+    const map = {};
+    if (this.text != null) map.text = this.text;
+    if (this.name != null) map.name = this.name;
+    if (this.params != null) map.params = this.params;
+    if (this.options != null) map.options = this.options;
+    return map;
+  }
+}
+
+export default Track;

package/src/index.d.ts

@@ -1,4 +1,4 @@
 export { ActionBridge } from './bridge/index.js';
-export { ActionCreator, ActionData, ActionType, Jump, Navigate, Replace, Goback, EnterRoom, LiveDetect, Onelink, AgencyInvite, Recharge, Close, Config, Action } from './core/index.js';
+export { ActionCreator, ActionData, ActionType, Jump, Navigate, Replace, Goback, EnterRoom, LiveDetect, Onelink, AgencyInvite, Recharge, Close, Config, Track, GrantBenefits, Action } from './core/index.js';
 export { RNWebViewAdapter, MockAdapter, IActionAdapter, MockCall } from './adapters/index.js';
 export { ActionBridgeProvider, useActionBridge } from './integrations/react/index.js';

package/src/index.js

@@ -12,4 +12,6 @@ export { AgencyInvite } from './core/index.js';
 export { Recharge } from './core/index.js';
 export { Close } from './core/index.js';
 export { Config } from './core/index.js';
+export { Track } from './core/index.js';
+export { GrantBenefits } from './core/index.js';
 export { Action } from './core/index.js';