@heybox/hb-sdk-protocol 0.8.3-alpha.6 → 0.8.3-alpha.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk-protocol",
-  "version": "0.8.3-alpha.6",
+  "version": "0.8.3-alpha.9",
   "description": "Heybox mini-program iframe bridge wire contracts.",
   "sideEffects": false,
   "exports": {

package/src/payloads.ts

@@ -645,8 +645,8 @@ export type ReloadPayload = void;
  * 保留；关键持久化不能依赖 Promise 后续语句或 `unload` 回调。
  */
 export type ReloadResult = void;
-/** 允许打开的 App 页面目标白名单；不包含任意 URL、scheme 或内部路由。 */
-export type MiniProgramAppPageTarget = 'game_detail' | 'user_detail' | 'post_detail';
+/** 允许打开的 App 页面与公开小程序目标白名单；不包含任意 URL、scheme 或内部路由。 */
+export type MiniProgramAppPageTarget = 'game_detail' | 'user_detail' | 'post_detail' | 'mini_program';
 /** 游戏平台类型：PC、主机或移动游戏。 */
 export type MiniProgramGameDetailGameType = 'pc' | 'console' | 'mobile';
 /** 游戏详情首屏：详情主页或百科页。 */
@@ -684,16 +684,30 @@ export type OpenPostDetailAppPagePayload = {
   /** 可选的非空目标评论 ID 字符串。 */
   commentId?: string;
 };
+/** 打开另一个公开发布小程序的 wire payload；目标版本与访问性由 Host 决定。 */
+export type OpenMiniProgramAppPagePayload = {
+  /** 固定判别值。 */
+  target: 'mini_program';
+  /** trim 后的非空目标小程序 ID。 */
+  miniProgramId: string;
+  /** 可选 JSON-compatible 启动数据；Runtime 会按分享 `extra` 合同再次校验和编码。 */
+  extra?: unknown;
+};
 /**
  * `navigation.openAppPage` 的判别联合 wire payload。
  *
  * @remarks
  * Runtime 只读取上述白名单字段并构造固定 Host 路由；额外 URL、path、scheme 或窗口字段
- * 不会透传。移动端 Host 支持三个目标，当前 PC Host 只支持 `game_detail` 且只消费 `appId`。
+ * 不会透传。移动端 Host 支持全部四类目标；当前 PC Host 支持 `game_detail` 与 `mini_program`，
+ * 仍拒绝用户详情和帖子详情。
  *
  * @see [App-facing navigation.openAppPage](/reference/sdk/navigation/openAppPage)
  */
-export type OpenAppPagePayload = OpenGameDetailAppPagePayload | OpenUserDetailAppPagePayload | OpenPostDetailAppPagePayload;
+export type OpenAppPagePayload =
+  | OpenGameDetailAppPagePayload
+  | OpenUserDetailAppPagePayload
+  | OpenPostDetailAppPagePayload
+  | OpenMiniProgramAppPagePayload;
 /**
  * Host 接收参数并发起受控路由后的结果为 `undefined`。
  *

package/types/payloads.d.ts

@@ -610,8 +610,8 @@ export type ReloadPayload = void;
  * 保留；关键持久化不能依赖 Promise 后续语句或 `unload` 回调。
  */
 export type ReloadResult = void;
-/** 允许打开的 App 页面目标白名单；不包含任意 URL、scheme 或内部路由。 */
-export type MiniProgramAppPageTarget = 'game_detail' | 'user_detail' | 'post_detail';
+/** 允许打开的 App 页面与公开小程序目标白名单；不包含任意 URL、scheme 或内部路由。 */
+export type MiniProgramAppPageTarget = 'game_detail' | 'user_detail' | 'post_detail' | 'mini_program';
 /** 游戏平台类型：PC、主机或移动游戏。 */
 export type MiniProgramGameDetailGameType = 'pc' | 'console' | 'mobile';
 /** 游戏详情首屏：详情主页或百科页。 */
@@ -649,16 +649,26 @@ export type OpenPostDetailAppPagePayload = {
     /** 可选的非空目标评论 ID 字符串。 */
     commentId?: string;
 };
+/** 打开另一个公开发布小程序的 wire payload；目标版本与访问性由 Host 决定。 */
+export type OpenMiniProgramAppPagePayload = {
+    /** 固定判别值。 */
+    target: 'mini_program';
+    /** trim 后的非空目标小程序 ID。 */
+    miniProgramId: string;
+    /** 可选 JSON-compatible 启动数据；Runtime 会按分享 `extra` 合同再次校验和编码。 */
+    extra?: unknown;
+};
 /**
  * `navigation.openAppPage` 的判别联合 wire payload。
  *
  * @remarks
  * Runtime 只读取上述白名单字段并构造固定 Host 路由；额外 URL、path、scheme 或窗口字段
- * 不会透传。移动端 Host 支持三个目标，当前 PC Host 只支持 `game_detail` 且只消费 `appId`。
+ * 不会透传。移动端 Host 支持全部四类目标；当前 PC Host 支持 `game_detail` 与 `mini_program`，
+ * 仍拒绝用户详情和帖子详情。
  *
  * @see [App-facing navigation.openAppPage](/reference/sdk/navigation/openAppPage)
  */
-export type OpenAppPagePayload = OpenGameDetailAppPagePayload | OpenUserDetailAppPagePayload | OpenPostDetailAppPagePayload;
+export type OpenAppPagePayload = OpenGameDetailAppPagePayload | OpenUserDetailAppPagePayload | OpenPostDetailAppPagePayload | OpenMiniProgramAppPagePayload;
 /**
  * Host 接收参数并发起受控路由后的结果为 `undefined`。
  *