@heybox/hb-sdk-protocol 0.8.1-alpha.12 → 0.8.1-alpha.14

package/README.md

@@ -46,7 +46,7 @@ import { MINI_PROGRAM_PROTOCOL_CAPABILITIES, type MiniProgramBridgeMessage } fro
 
 耗时能力通过 `MiniProgramCapabilityProgressMap` 按 method 绑定进度 payload；当前覆盖 `network.download` 与 `companion.prepare`。Companion Session wire 只携带不透明 Session ID、controller generation、原始字节 chunk/ack、exit 和 ownership-lost 事件，不暴露 PID、路径或原生句柄。
 
-`CompanionInfo.source` 由可信 Host 标识 `local-dev` 或 `released`，与 `signatureStatus` 一起供授权展示使用；旧 Host 未提供来源时保持未知，不能推定为已审核产物。
+`CompanionInfo.source` 由可信 Host 标识 `local-dev`、`preview` 或 `released`，与 `signatureStatus` 一起供授权展示使用；`preview` 表示审核前预览产物，旧 Host 未提供来源时保持未知，不能推定为已审核产物。
 
 协议包不决定业务授权。`auth.login()` 的 UI、账号会话、授权码签发和 OpenAPI 都由 Host/服务端负责；协议层只传递经过约束的 request/response 数据。
 

package/dist/index.cjs.js

@@ -600,6 +600,7 @@ const COMPANION_ALIAS_PATTERN = /^[a-z][a-z0-9-]{0,31}$/;
 /** Companion Host 可跨 bridge 保留的稳定领域错误码。 */
 const COMPANION_ERROR_CODES = [
     'COMPANION_UNSUPPORTED',
+    'COMPANION_PREVIEW_UNSUPPORTED',
     'COMPANION_NOT_DECLARED',
     'COMPANION_TARGET_UNSUPPORTED',
     'COMPANION_NOT_PREPARED',

package/dist/index.esm.js

@@ -598,6 +598,7 @@ const COMPANION_ALIAS_PATTERN = /^[a-z][a-z0-9-]{0,31}$/;
 /** Companion Host 可跨 bridge 保留的稳定领域错误码。 */
 const COMPANION_ERROR_CODES = [
     'COMPANION_UNSUPPORTED',
+    'COMPANION_PREVIEW_UNSUPPORTED',
     'COMPANION_NOT_DECLARED',
     'COMPANION_TARGET_UNSUPPORTED',
     'COMPANION_NOT_PREPARED',

package/package.json

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

package/src/capabilities.ts

@@ -164,7 +164,9 @@ export const COMPANION_SHOW_NOTIFICATION_METHOD = 'companion.showNotification' a
 export type MiniProgramAuthMethod = typeof AUTH_LOGIN_METHOD;
 export type MiniProgramUserMethod = typeof USER_GET_INFO_METHOD | typeof USER_REVOKE_AUTHORIZATION_METHOD | typeof USER_GET_STEAM_GAME_LIST_METHOD;
 export type MiniProgramShareMethod = typeof SHARE_COPY_LINK_METHOD | typeof SHARE_SHOW_SHARE_MENU_METHOD | typeof SHARE_SCREENSHOT_METHOD;
-export type MiniProgramViewportMethod = typeof VIEWPORT_GET_WINDOW_INFO_METHOD | typeof VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD;
+export type MiniProgramViewportMethod =
+  | typeof VIEWPORT_GET_WINDOW_INFO_METHOD
+  | typeof VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD;
 export type MiniProgramStorageMethod = typeof STORAGE_GET_STORAGE_METHOD | typeof STORAGE_SET_STORAGE_METHOD;
 export type MiniProgramNetworkMethod = typeof NETWORK_REQUEST_METHOD | typeof NETWORK_DOWNLOAD_METHOD;
 export type MiniProgramFilesMethod = typeof FILES_PICK_FILES_METHOD | typeof FILES_PICK_DIRECTORY_METHOD | typeof FILES_SAVE_FILE_METHOD;

package/src/payloads.ts

@@ -494,6 +494,7 @@ export const COMPANION_ALIAS_PATTERN = /^[a-z][a-z0-9-]{0,31}$/;
 /** Companion Host 可跨 bridge 保留的稳定领域错误码。 */
 export const COMPANION_ERROR_CODES = [
   'COMPANION_UNSUPPORTED',
+  'COMPANION_PREVIEW_UNSUPPORTED',
   'COMPANION_NOT_DECLARED',
   'COMPANION_TARGET_UNSUPPORTED',
   'COMPANION_NOT_PREPARED',
@@ -527,7 +528,7 @@ export interface CompanionInfo {
   archiveBytes: number;
   signatureStatus: CompanionSignatureStatus;
   /** Host 确认的产物来源；旧 Host 缺省时来源未知。 */
-  source?: 'local-dev' | 'released';
+  source?: 'local-dev' | 'preview' | 'released';
 }
 
 export interface CompanionErrorSummary {

package/types/payloads.d.ts

@@ -468,7 +468,7 @@ export type CompanionSignatureStatus = 'unsigned' | 'valid' | 'invalid' | 'unkno
 /** Companion alias 的跨构建、Runtime 与 Host 规范。 */
 export declare const COMPANION_ALIAS_PATTERN: RegExp;
 /** Companion Host 可跨 bridge 保留的稳定领域错误码。 */
-export declare const COMPANION_ERROR_CODES: readonly ["COMPANION_UNSUPPORTED", "COMPANION_NOT_DECLARED", "COMPANION_TARGET_UNSUPPORTED", "COMPANION_NOT_PREPARED", "COMPANION_PREPARATION_CANCELLED", "COMPANION_DOWNLOAD_FAILED", "COMPANION_DESCRIPTOR_UNAVAILABLE", "COMPANION_ARCHIVE_INVALID", "COMPANION_INTEGRITY_FAILED", "COMPANION_ENTRYPOINT_INVALID", "COMPANION_USER_CANCELLED", "COMPANION_ELEVATION_DENIED", "COMPANION_OS_BLOCKED", "COMPANION_LAUNCH_FAILED", "COMPANION_SESSION_VERSION_MISMATCH", "COMPANION_SESSION_OWNERSHIP_LOST", "COMPANION_SESSION_EXITED", "COMPANION_PIPE_CLOSED", "COMPANION_OUTPUT_LIMIT", "COMPANION_PROCESS_CRASHED", "COMPANION_ATTACHMENT_NOT_FOUND", "COMPANION_NOTIFICATION_UNAVAILABLE", "COMPANION_TERMINATE_FAILED"];
+export declare const COMPANION_ERROR_CODES: readonly ["COMPANION_UNSUPPORTED", "COMPANION_PREVIEW_UNSUPPORTED", "COMPANION_NOT_DECLARED", "COMPANION_TARGET_UNSUPPORTED", "COMPANION_NOT_PREPARED", "COMPANION_PREPARATION_CANCELLED", "COMPANION_DOWNLOAD_FAILED", "COMPANION_DESCRIPTOR_UNAVAILABLE", "COMPANION_ARCHIVE_INVALID", "COMPANION_INTEGRITY_FAILED", "COMPANION_ENTRYPOINT_INVALID", "COMPANION_USER_CANCELLED", "COMPANION_ELEVATION_DENIED", "COMPANION_OS_BLOCKED", "COMPANION_LAUNCH_FAILED", "COMPANION_SESSION_VERSION_MISMATCH", "COMPANION_SESSION_OWNERSHIP_LOST", "COMPANION_SESSION_EXITED", "COMPANION_PIPE_CLOSED", "COMPANION_OUTPUT_LIMIT", "COMPANION_PROCESS_CRASHED", "COMPANION_ATTACHMENT_NOT_FOUND", "COMPANION_NOTIFICATION_UNAVAILABLE", "COMPANION_TERMINATE_FAILED"];
 export type CompanionErrorCode = (typeof COMPANION_ERROR_CODES)[number];
 export interface CompanionInfo {
     alias: string;
@@ -478,7 +478,7 @@ export interface CompanionInfo {
     archiveBytes: number;
     signatureStatus: CompanionSignatureStatus;
     /** Host 确认的产物来源；旧 Host 缺省时来源未知。 */
-    source?: 'local-dev' | 'released';
+    source?: 'local-dev' | 'preview' | 'released';
 }
 export interface CompanionErrorSummary {
     code: CompanionErrorCode;