@yagolive/event-kit 1.0.8 → 1.0.9

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## @1.0.9 (2026-06-24)
+
+### 新增
+
+- **Ask Action（通用询问）**: 新增通用询问动作类型，用于触发邀请、审核等需要用户确认/拒绝的场景
+  - `ActionType.ASK` = `'ask'`
+  - `Ask` 数据类：必填字段 `id`(number，询问 ID)；可选字段 `title`(string，询问标题)、`message`(string，询问内容)、`accepted`(boolean，当前回复状态)、`text`
+  - `ActionCreator.buildAsk(id)`、`createAskAction(id)`、`createAskActionWithData(ask)`
+  - `ActionBridge.ask(id, options?)`、`buildAsk(id)`、`createAskAction(id)`、`createAskActionWithData(ask)`
+  - `bridge.ask(id, options)` 便捷方法支持传入 `{ title?, message?, accepted?, text? }`
+  - **语义**：app 侧消费时遵循以下规则——`title` 或 `message` 任一非空时弹出 `ConfirmDialog` 让用户选择；均为空则进入静默模式（如系统消息卡片中直接展示 Accept/Reject 按钮）
+
+### 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 | 分享链接 |
+| ask | id: number, title?: string, message?: string, accepted?: 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.8 (2026-06-17)
 
 ### 新增

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, Track, GrantBenefits |
-| `ActionType` | Object | Action 类型枚举：JUMP, NAVIGATE, REPLACE, GOBACK, ENTER_ROOM, LIVE_DETECT, ONELINK, AGENCY_INVITE, RECHARGE, CLOSE, CONFIG, TRACK, GRANT_BENEFITS |
+| `ActionData` | Object | 包含所有数据类型类：Jump, Navigate, Replace, Goback, EnterRoom, LiveDetect, Onelink, Ask, AgencyInvite, Recharge, Close, Config, Track, GrantBenefits |
+| `ActionType` | Object | Action 类型枚举：JUMP, NAVIGATE, REPLACE, GOBACK, ENTER_ROOM, LIVE_DETECT, ONELINK, ASK, AGENCY_INVITE, RECHARGE, CLOSE, CONFIG, TRACK, GRANT_BENEFITS |
 
 #### 工厂方法
 
@@ -199,6 +199,9 @@ import { ActionCreator } from '@yagolive/event-kit';
 | `buildOnelink(url?)` | url?: string | Onelink | 构建 Onelink 对象（链式配置） |
 | `createOnelinkAction(url)` | url: string | Action | 创建 Onelink Action |
 | `createOnelinkActionWithData(onelink)` | onelink: Onelink | Action | 从 Onelink 对象创建 Action |
+| `buildAsk(id)` | id: number | Ask | 构建 Ask 对象（链式配置） |
+| `createAskAction(id)` | id: number | Action | 创建通用询问 Action |
+| `createAskActionWithData(ask)` | ask: Ask | Action | 从 Ask 对象创建 Action |
 | `buildAgencyInvite(id, type)` | id: number, type: string | AgencyInvite | 构建 AgencyInvite 对象（链式配置） |
 | `createAgencyInviteAction(id, type)` | id: number, type: string | Action | 创建工会邀请 Action |
 | `createAgencyInviteActionWithData(agencyInvite)` | agencyInvite: AgencyInvite | Action | 从 AgencyInvite 对象创建 Action |
@@ -257,6 +260,7 @@ ActionType.GOBACK       // 'goback'
 ActionType.ENTER_ROOM   // 'enter_room'
 ActionType.LIVE_DETECT  // 'live_detect'
 ActionType.ONELINK      // 'onelink'
+ActionType.ASK          // 'ask'
 ActionType.AGENCY_INVITE // 'agency_invite'
 ActionType.RECHARGE     // 'recharge'
 ActionType.CLOSE        // 'close'   (addon)
@@ -330,6 +334,9 @@ new ActionBridge(adapter, options?)
 | `onelink(url)` | url: string | Promise | 打开 Onelink |
 | `buildOnelink(url?)` | url?: string | Onelink | 构建 Onelink 对象（链式配置） |
 | `createOnelinkActionWithData(onelink)` | onelink: Onelink | Action | 从 Onelink 对象创建 Action（不自动发送） |
+| `ask(id, options?)` | id: number, options?: { title?, message?, accepted?, text? } | Promise | 通用询问（邀请/审核） |
+| `buildAsk(id)` | id: number | Ask | 构建 Ask 对象（链式配置） |
+| `createAskActionWithData(ask)` | ask: Ask | Action | 从 Ask 对象创建 Action（不自动发送） |
 | `agencyInvite(id, type)` | id: number, type: string | Promise | 工会邀请 |
 | `buildAgencyInvite(id, type)` | id: number, type: string | AgencyInvite | 构建 AgencyInvite 对象（链式配置） |
 | `createAgencyInviteActionWithData(agencyInvite)` | agencyInvite: AgencyInvite | Action | 从 AgencyInvite 对象创建 Action（不自动发送） |
@@ -679,6 +686,21 @@ Onelink Action 数据。
 | `setUrl(url)` | url: string (必填) | 设置链接 URL，返回 this |
 | `setShare(share)` | share: boolean | 设置是否显示分享弹窗，返回 this |
 
+### Ask
+
+通用询问 Action 数据，用于邀请、审核等需要用户确认/拒绝的场景。
+
+> **App 侧消费语义**：当 `title` 或 `message` 任一非空时，app 侧弹出 `ConfirmDialog` 让用户确认；均为空则进入静默模式，由调用方（如系统消息卡片）在界面上直接展示 Accept/Reject 按钮。
+
+| 方法 | 参数 | 说明 |
+|------|------|------|
+| `constructor(id)` | id: number (必填) | 创建通用询问数据 |
+| `setText(text)` | text: string | 设置显示文本，返回 this |
+| `setId(id)` | id: number | 设置询问 ID，返回 this |
+| `setTitle(title)` | title: string | 设置询问标题，返回 this |
+| `setMessage(message)` | message: string | 设置询问内容，返回 this |
+| `setAccepted(accepted)` | accepted: boolean | 设置当前回复状态（true=已接受，false=已拒绝，未设置=未回复），返回 this |
+
 ### AgencyInvite
 
 工会邀请 Action 数据。

package/dist/js/action_bridge.umd.js

@@ -1,6 +1,6 @@
 /**
  * YAGO Event Kit - Action Bridge (Full)
- * @version 1.0.8
+ * @version 1.0.9
  *
  * Generated by build script - do not edit manually.
  * Supports: Browser script tag, CommonJS, AMD
@@ -358,6 +358,63 @@ var Onelink = class {
 };
 var Onelink_default = Onelink;
 
+// src/core/types/Ask.js
+var Ask = class {
+  constructor(id) {
+    if (id == null) throw new Error("id cannot be null");
+    this.text = null;
+    this.id = id;
+    this.title = null;
+    this.message = null;
+    this.accepted = null;
+  }
+  getText() {
+    return this.text;
+  }
+  setText(text) {
+    this.text = text;
+    return this;
+  }
+  getId() {
+    return this.id;
+  }
+  setId(id) {
+    this.id = id;
+    return this;
+  }
+  getTitle() {
+    return this.title;
+  }
+  setTitle(title) {
+    this.title = title;
+    return this;
+  }
+  getMessage() {
+    return this.message;
+  }
+  setMessage(message) {
+    this.message = message;
+    return this;
+  }
+  getAccepted() {
+    return this.accepted;
+  }
+  setAccepted(accepted) {
+    this.accepted = accepted;
+    return this;
+  }
+  toMap() {
+    const map = {};
+    if (this.text != null) map.text = this.text;
+    if (this.id != null) map.id = this.id;
+    if (this.title != null) map.title = this.title;
+    if (this.message != null) map.message = this.message;
+    if (this.accepted != null) map.accepted = this.accepted;
+    return map;
+  }
+};
+var Ask_default = Ask;
+
 // src/core/types/AgencyInvite.js
 var AgencyInfo = class {
   constructor() {
@@ -827,6 +884,7 @@ var ActionType = {
   ENTER_ROOM: "enter_room",
   LIVE_DETECT: "live_detect",
   ONELINK: "onelink",
+  ASK: "ask",
   AGENCY_INVITE: "agency_invite",
   RECHARGE: "recharge",
   CLOSE: "close",
@@ -842,6 +900,7 @@ var ActionData = {
   EnterRoom: EnterRoom_default,
   LiveDetect: LiveDetect_default,
   Onelink: Onelink_default,
+  Ask: Ask_default,
   AgencyInvite: AgencyInvite_default,
   Recharge: Recharge_default,
   Close: Close_default,
@@ -930,6 +989,16 @@ var ActionCreator = {
   createOnelinkActionWithData(onelink) {
     return new Action_default(ActionType.ONELINK, onelink);
   },
+  // Ask
+  buildAsk(id) {
+    return new Ask_default(id);
+  },
+  createAskAction(id) {
+    return new Action_default(ActionType.ASK, new Ask_default(id));
+  },
+  createAskActionWithData(ask) {
+    return new Action_default(ActionType.ASK, ask);
+  },
   // AgencyInvite
   buildAgencyInvite(id, type) {
     return new AgencyInvite_default(id, type);
@@ -1261,6 +1330,25 @@ var ActionBridge = class _ActionBridge {
   createOnelinkActionWithData(onelink) {
     return ActionCreator.createOnelinkActionWithData(onelink);
   }
+  ask(id, options) {
+    var data = ActionCreator.buildAsk(id);
+    if (options) {
+      if (options.title != null) data.setTitle(options.title);
+      if (options.message != null) data.setMessage(options.message);
+      if (options.accepted != null) data.setAccepted(options.accepted);
+      if (options.text != null) data.setText(options.text);
+    }
+    return this._adapter.sendAction(ActionCreator.createAskActionWithData(data));
+  }
+  buildAsk(id) {
+    return ActionCreator.buildAsk(id);
+  }
+  createAskAction(id) {
+    return ActionCreator.createAskAction(id);
+  }
+  createAskActionWithData(ask) {
+    return ActionCreator.createAskActionWithData(ask);
+  }
   agencyInvite(id, type) {
     return this._adapter.sendAction(ActionCreator.createAgencyInviteAction(id, type));
   }

package/dist/js/action_creator.umd.js

@@ -1,6 +1,6 @@
 /**
  * YAGO Event Kit - Action Creator (Core Only)
- * @version 1.0.8
+ * @version 1.0.9
  *
  * Generated by build script - do not edit manually.
  * Supports: Browser script tag, CommonJS, AMD
@@ -358,6 +358,63 @@ var Onelink = class {
 };
 var Onelink_default = Onelink;
 
+// src/core/types/Ask.js
+var Ask = class {
+  constructor(id) {
+    if (id == null) throw new Error("id cannot be null");
+    this.text = null;
+    this.id = id;
+    this.title = null;
+    this.message = null;
+    this.accepted = null;
+  }
+  getText() {
+    return this.text;
+  }
+  setText(text) {
+    this.text = text;
+    return this;
+  }
+  getId() {
+    return this.id;
+  }
+  setId(id) {
+    this.id = id;
+    return this;
+  }
+  getTitle() {
+    return this.title;
+  }
+  setTitle(title) {
+    this.title = title;
+    return this;
+  }
+  getMessage() {
+    return this.message;
+  }
+  setMessage(message) {
+    this.message = message;
+    return this;
+  }
+  getAccepted() {
+    return this.accepted;
+  }
+  setAccepted(accepted) {
+    this.accepted = accepted;
+    return this;
+  }
+  toMap() {
+    const map = {};
+    if (this.text != null) map.text = this.text;
+    if (this.id != null) map.id = this.id;
+    if (this.title != null) map.title = this.title;
+    if (this.message != null) map.message = this.message;
+    if (this.accepted != null) map.accepted = this.accepted;
+    return map;
+  }
+};
+var Ask_default = Ask;
+
 // src/core/types/AgencyInvite.js
 var AgencyInfo = class {
   constructor() {
@@ -827,6 +884,7 @@ var ActionType = {
   ENTER_ROOM: "enter_room",
   LIVE_DETECT: "live_detect",
   ONELINK: "onelink",
+  ASK: "ask",
   AGENCY_INVITE: "agency_invite",
   RECHARGE: "recharge",
   CLOSE: "close",
@@ -842,6 +900,7 @@ var ActionData = {
   EnterRoom: EnterRoom_default,
   LiveDetect: LiveDetect_default,
   Onelink: Onelink_default,
+  Ask: Ask_default,
   AgencyInvite: AgencyInvite_default,
   Recharge: Recharge_default,
   Close: Close_default,
@@ -930,6 +989,16 @@ var ActionCreator = {
   createOnelinkActionWithData(onelink) {
     return new Action_default(ActionType.ONELINK, onelink);
   },
+  // Ask
+  buildAsk(id) {
+    return new Ask_default(id);
+  },
+  createAskAction(id) {
+    return new Action_default(ActionType.ASK, new Ask_default(id));
+  },
+  createAskActionWithData(ask) {
+    return new Action_default(ActionType.ASK, ask);
+  },
   // AgencyInvite
   buildAgencyInvite(id, type) {
     return new AgencyInvite_default(id, type);

package/package.json

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

package/src/bridge/ActionBridge.js

@@ -157,6 +157,27 @@ export default class ActionBridge {
     return ActionCreator.createOnelinkActionWithData(onelink);
   }
 
+  ask(id, options) {
+    var data = ActionCreator.buildAsk(id);
+    if (options) {
+      if (options.title != null) data.setTitle(options.title);
+      if (options.message != null) data.setMessage(options.message);
+      if (options.accepted != null) data.setAccepted(options.accepted);
+      if (options.text != null) data.setText(options.text);
+    }
+    return this._adapter.sendAction(ActionCreator.createAskActionWithData(data));
+  }
+
+  buildAsk(id) {
+    return ActionCreator.buildAsk(id);
+  }
+  createAskAction(id) {
+    return ActionCreator.createAskAction(id);
+  }
+  createAskActionWithData(ask) {
+    return ActionCreator.createAskActionWithData(ask);
+  }
+
   agencyInvite(id, type) {
     return this._adapter.sendAction(ActionCreator.createAgencyInviteAction(id, type));
   }

package/src/bridge/index.d.ts

@@ -1,5 +1,5 @@
 import {
-  Action, Jump, Navigate, Replace, Goback, EnterRoom, LiveDetect, Onelink, AgencyInvite, Recharge, Close, Config, Track, GrantBenefits,
+  Action, Jump, Navigate, Replace, Goback, EnterRoom, LiveDetect, Onelink, Ask, AgencyInvite, Recharge, Close, Config, Track, GrantBenefits,
   ActionType, ActionData, ActionCreator,
 } from '../core/index.js';
 import { IActionAdapter, RNWebViewAdapter, MockAdapter, AdapterOptions, SendActionOption } from '../adapters/index.js';
@@ -52,6 +52,11 @@ export declare class ActionBridge {
   createOnelinkAction(url: string): Action;
   createOnelinkActionWithData(onelink: Onelink): Action;
 
+  ask(id: number, options?: { title?: string; message?: string; accepted?: boolean; text?: string }): Promise<any>;
+  buildAsk(id: number): Ask;
+  createAskAction(id: number): Action;
+  createAskActionWithData(ask: Ask): Action;
+
   agencyInvite(id: number, type: string): Promise<any>;
   buildAgencyInvite(id: number, type: string): AgencyInvite;
   createAgencyInviteAction(id: number, type: string): Action;

package/src/core/ActionCreator.js

@@ -5,6 +5,7 @@ import EnterRoom from './types/EnterRoom.js';
 import Goback from './types/Goback.js';
 import LiveDetect from './types/LiveDetect.js';
 import Onelink from './types/Onelink.js';
+import Ask from './types/Ask.js';
 import AgencyInvite from './types/AgencyInvite.js';
 import Recharge from './types/Recharge.js';
 import Close from './types/Close.js';
@@ -21,6 +22,7 @@ const ActionType = {
   ENTER_ROOM: 'enter_room',
   LIVE_DETECT: 'live_detect',
   ONELINK: 'onelink',
+  ASK: 'ask',
   AGENCY_INVITE: 'agency_invite',
   RECHARGE: 'recharge',
   CLOSE: 'close',
@@ -37,6 +39,7 @@ const ActionData = {
   EnterRoom,
   LiveDetect,
   Onelink,
+  Ask,
   AgencyInvite,
   Recharge,
   Close,
@@ -150,6 +153,19 @@ const ActionCreator = {
     return new Action(ActionType.ONELINK, onelink);
   },
 
+  // Ask
+  buildAsk(id) {
+    return new Ask(id);
+  },
+
+  createAskAction(id) {
+    return new Action(ActionType.ASK, new Ask(id));
+  },
+
+  createAskActionWithData(ask) {
+    return new Action(ActionType.ASK, ask);
+  },
+
   // AgencyInvite
   buildAgencyInvite(id, type) {
     return new AgencyInvite(id, type);

package/src/core/index.d.ts

@@ -131,6 +131,26 @@ export class Onelink {
   toMap(): Record<string, any>;
 }
 
+export class Ask {
+  constructor(id: number);
+  text: string | null;
+  id: number;
+  title: string | null;
+  message: string | null;
+  accepted: boolean | null;
+  getText(): string | null;
+  setText(text: string): this;
+  getId(): number;
+  setId(id: number): this;
+  getTitle(): string | null;
+  setTitle(title: string): this;
+  getMessage(): string | null;
+  setMessage(message: string): this;
+  getAccepted(): boolean | null;
+  setAccepted(accepted: boolean): this;
+  toMap(): Record<string, any>;
+}
+
 export class AgencyInfo {
   id: string | null;
   name: string | null;
@@ -302,7 +322,7 @@ export class Action {
   toJson(): string;
 }
 
-export type ActionTypeValue = 'jump' | 'navigate' | 'replace' | 'goback' | 'enter_room' | 'live_detect' | 'onelink' | 'agency_invite' | 'recharge' | 'close' | 'config' | 'track' | 'grant_benefits';
+export type ActionTypeValue = 'jump' | 'navigate' | 'replace' | 'goback' | 'enter_room' | 'live_detect' | 'onelink' | 'ask' | 'agency_invite' | 'recharge' | 'close' | 'config' | 'track' | 'grant_benefits';
 
 export const ActionType: {
   JUMP: 'jump';
@@ -312,6 +332,7 @@ export const ActionType: {
   ENTER_ROOM: 'enter_room';
   LIVE_DETECT: 'live_detect';
   ONELINK: 'onelink';
+  ASK: 'ask';
   AGENCY_INVITE: 'agency_invite';
   RECHARGE: 'recharge';
   CLOSE: 'close';
@@ -328,6 +349,7 @@ export const ActionData: {
   EnterRoom: typeof EnterRoom;
   LiveDetect: typeof LiveDetect;
   Onelink: typeof Onelink;
+  Ask: typeof Ask;
   AgencyInvite: typeof AgencyInvite;
   Recharge: typeof Recharge;
   Close: typeof Close;
@@ -362,6 +384,9 @@ export const ActionCreator: {
   buildOnelink(url: string): Onelink;
   createOnelinkAction(url: string): Action;
   createOnelinkActionWithData(onelink: Onelink): Action;
+  buildAsk(id: number): Ask;
+  createAskAction(id: number): Action;
+  createAskActionWithData(ask: Ask): Action;
   buildAgencyInvite(id: number, type: string): AgencyInvite;
   createAgencyInviteAction(id: number, type: string): Action;
   createAgencyInviteActionWithData(agencyInvite: AgencyInvite): Action;

package/src/core/index.js

@@ -6,6 +6,7 @@ export { default as Goback } from './types/Goback.js';
 export { default as EnterRoom } from './types/EnterRoom.js';
 export { default as LiveDetect } from './types/LiveDetect.js';
 export { default as Onelink } from './types/Onelink.js';
+export { default as Ask } from './types/Ask.js';
 export { default as AgencyInvite } from './types/AgencyInvite.js';
 export { default as Recharge } from './types/Recharge.js';
 export { default as Close } from './types/Close.js';

package/src/core/types/Ask.js

@@ -0,0 +1,28 @@
+class Ask {
+  constructor(id) {
+    if (id == null) throw new Error('id cannot be null');
+    this.text = null;
+    this.id = id;
+    this.title = null;
+    this.message = null;
+    this.accepted = null;
+  }
+
+  getText() { return this.text; } setText(text) { this.text = text; return this; }
+  getId() { return this.id; } setId(id) { this.id = id; return this; }
+  getTitle() { return this.title; } setTitle(title) { this.title = title; return this; }
+  getMessage() { return this.message; } setMessage(message) { this.message = message; return this; }
+  getAccepted() { return this.accepted; } setAccepted(accepted) { this.accepted = accepted; return this; }
+
+  toMap() {
+    const map = {};
+    if (this.text != null) map.text = this.text;
+    if (this.id != null) map.id = this.id;
+    if (this.title != null) map.title = this.title;
+    if (this.message != null) map.message = this.message;
+    if (this.accepted != null) map.accepted = this.accepted;
+    return map;
+  }
+}
+
+export default Ask;

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, Track, GrantBenefits, Action } from './core/index.js';
+export { ActionCreator, ActionData, ActionType, Jump, Navigate, Replace, Goback, EnterRoom, LiveDetect, Onelink, Ask, 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

@@ -8,6 +8,7 @@ export { Goback } from './core/index.js';
 export { EnterRoom } from './core/index.js';
 export { LiveDetect } from './core/index.js';
 export { Onelink } from './core/index.js';
+export { Ask } from './core/index.js';
 export { AgencyInvite } from './core/index.js';
 export { Recharge } from './core/index.js';
 export { Close } from './core/index.js';