@heybox/hb-sdk-protocol 0.8.3-alpha.2 → 0.8.3-alpha.4

package/dist/index.esm.js

@@ -39,6 +39,7 @@ const USER_GET_STEAM_GAME_LIST_METHOD = 'user.getSteamGameList';
 const SHARE_COPY_LINK_METHOD = 'share.copyLink';
 const SHARE_SHOW_SHARE_MENU_METHOD = 'share.showShareMenu';
 const SHARE_SCREENSHOT_METHOD = 'share.screenshot';
+const VIEWPORT_SET_DISPLAY_METHOD = 'viewport.setDisplay';
 const VIEWPORT_GET_WINDOW_INFO_METHOD = 'viewport.getWindowInfo';
 const VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD = 'viewport.setNavigationBarStyle';
 const STORAGE_GET_STORAGE_METHOD = 'storage.getStorage';
@@ -162,6 +163,13 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         requirement: { kind: 'none' },
         risk: 'low',
     },
+    {
+        method: VIEWPORT_SET_DISPLAY_METHOD,
+        module: 'viewport',
+        capability: VIEWPORT_SET_DISPLAY_METHOD,
+        requirement: { kind: 'none' },
+        risk: 'low',
+    },
     {
         method: STORAGE_GET_STORAGE_METHOD,
         module: 'storage',
@@ -437,7 +445,7 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
  * @see [parseMiniProgramRuntimePermissions](/reference/symbols/protocol/functions/parseMiniProgramRuntimePermissions) Runtime 权限快照解析器。
  */
 function isMiniProgramBridgeMessage(value) {
-    if (!isRecord$2(value))
+    if (!isRecord$3(value))
         return false;
     if (value.namespace !== MINI_PROGRAM_MESSAGE_NAMESPACE || (value.version !== 1 && value.version !== 2) || !isNonEmptyString$1(value.nonce)) {
         return false;
@@ -587,7 +595,7 @@ function isMiniProgramRelativePath(value) {
  * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 可作为 derived path root 的目录代理。
  */
 function isMiniProgramPathRootRef(value) {
-    if (!isRecord$2(value))
+    if (!isRecord$3(value))
         return false;
     if (value.kind === 'sandbox')
         return hasOnlyKeys(value, ['kind']);
@@ -653,7 +661,7 @@ function isMiniProgramPathRootRef(value) {
  * @see [FileHandle](/reference/symbols/root/interfaces/FileHandle) 使用文件引用的公开 I/O 代理。
  */
 function isMiniProgramFileRef(value) {
-    if (!isRecord$2(value) || value.kind !== 'file')
+    if (!isRecord$3(value) || value.kind !== 'file')
         return false;
     if (isNonEmptyString$1(value.handleId)) {
         return hasOnlyKeys(value, ['kind', 'handleId']);
@@ -720,7 +728,7 @@ function isMiniProgramFileRef(value) {
  * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 使用目录引用的公开路径操作代理。
  */
 function isMiniProgramDirectoryRef(value) {
-    if (!isRecord$2(value) || value.kind !== 'directory')
+    if (!isRecord$3(value) || value.kind !== 'directory')
         return false;
     if (isNonEmptyString$1(value.handleId)) {
         return hasOnlyKeys(value, ['kind', 'handleId']);
@@ -794,7 +802,7 @@ function isMiniProgramDirectoryRef(value) {
  * @see [SaveFileResult](/reference/symbols/protocol/types/SaveFileResult) save picker 的 direct-ref 文件结果。
  */
 function isMiniProgramFileDescriptor(value) {
-    return (isRecord$2(value) &&
+    return (isRecord$3(value) &&
         value.kind === 'file' &&
         isNonEmptyString$1(value.name) &&
         isFileMode(value.mode) &&
@@ -864,7 +872,7 @@ function isMiniProgramFileDescriptor(value) {
  * @see [PickDirectoryResult](/reference/symbols/protocol/types/PickDirectoryResult) picker 的 direct-ref 返回契约。
  */
 function isMiniProgramDirectoryDescriptor(value) {
-    return (isRecord$2(value) &&
+    return (isRecord$3(value) &&
         value.kind === 'directory' &&
         isNonEmptyString$1(value.name) &&
         isFileMode(value.mode) &&
@@ -1043,7 +1051,7 @@ function isMiniProgramByteArray(value) {
  * @see [FileHandle](/reference/symbols/root/interfaces/FileHandle) 提供 `stat()` 的当前 session 文件代理。
  */
 function isMiniProgramFileStat(value) {
-    return (isRecord$2(value) &&
+    return (isRecord$3(value) &&
         value.kind === 'file' &&
         isNonNegativeSafeInteger(value.size) &&
         (value.modifiedAt === undefined || isNonNegativeFiniteNumber(value.modifiedAt)) &&
@@ -1103,7 +1111,7 @@ function isMiniProgramFileStat(value) {
  * @see [isMiniProgramBridgeMessage](/reference/symbols/protocol/functions/isMiniProgramBridgeMessage) operation progress envelope 的最低校验。
  */
 function isMiniProgramDownloadProgressPayload(value) {
-    if (!isRecord$2(value) ||
+    if (!isRecord$3(value) ||
         !isNonNegativeSafeInteger(value.loaded) ||
         typeof value.lengthComputable !== 'boolean' ||
         !hasOnlyKeys(value, ['loaded', 'total', 'lengthComputable'])) {
@@ -1114,7 +1122,7 @@ function isMiniProgramDownloadProgressPayload(value) {
     return isNonNegativeSafeInteger(value.total) && value.loaded <= value.total;
 }
 function isMiniProgramCompanionPrepareProgress(value) {
-    if (!isRecord$2(value))
+    if (!isRecord$3(value))
         return false;
     if (value.phase === 'downloading') {
         return (isNonNegativeSafeInteger(value.loaded) &&
@@ -1132,10 +1140,10 @@ function isMiniProgramOperationProgressPayload(value) {
     return isMiniProgramDownloadProgressPayload(value) || isMiniProgramCompanionPrepareProgress(value);
 }
 function isSDKHandshakePayload(value) {
-    return isRecord$2(value) && isNonEmptyString$1(value.href) && typeof value.userAgent === 'string' && isNonEmptyString$1(value.sdkVersion);
+    return isRecord$3(value) && isNonEmptyString$1(value.href) && typeof value.userAgent === 'string' && isNonEmptyString$1(value.sdkVersion);
 }
 function isBridgeError(value) {
-    return isRecord$2(value) && isNonEmptyString$1(value.code) && typeof value.message === 'string';
+    return isRecord$3(value) && isNonEmptyString$1(value.code) && typeof value.message === 'string';
 }
 function isFileMode(value) {
     return value === 'read' || value === 'readwrite';
@@ -1153,156 +1161,10 @@ function hasOnlyKeys(value, allowedKeys) {
     const allowed = new Set(allowedKeys);
     return Object.keys(value).every((key) => allowed.has(key));
 }
-function isRecord$2(value) {
+function isRecord$3(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 
-/** 由 scripts/generate-native-host-contract.mjs 生成，请勿手改。 */
-const MINI_PROGRAM_NATIVE_HOST_PROTOCOL_VERSION = 1;
-const MINI_PROGRAM_NATIVE_HOST_CONTRACT_REVISION = 1;
-const MINI_PROGRAM_NATIVE_CHUNK_MAX_BYTES = 65536;
-const MINI_PROGRAM_NATIVE_OPERATIONS = {
-    "system": [
-        "describe"
-    ],
-    "network": [
-        "open",
-        "read",
-        "release",
-        "transfer"
-    ],
-    "files": [
-        "create",
-        "remove",
-        "exists",
-        "openRead",
-        "openWrite",
-        "read",
-        "release",
-        "write",
-        "stat",
-        "list",
-        "pickFiles",
-        "pickDirectory",
-        "saveFile"
-    ]
-};
-const MINI_PROGRAM_NATIVE_HOST_DESCRIPTION = {
-    "protocolVersion": 1,
-    "contractRevision": 1,
-    "operations": {
-        "system": [
-            "describe"
-        ],
-        "network": [
-            "open",
-            "read",
-            "release",
-            "transfer"
-        ],
-        "files": [
-            "create",
-            "remove",
-            "exists",
-            "openRead",
-            "openWrite",
-            "read",
-            "release",
-            "write",
-            "stat",
-            "list",
-            "pickFiles",
-            "pickDirectory",
-            "saveFile"
-        ]
-    }
-};
-
-/** Android WebMessageListener object 与 iOS WKScriptMessageHandler 共用名称。 */
-const MINI_PROGRAM_NATIVE_HOST_OBJECT = 'hbMiniProgramHost';
-/** Native 通过主文档 CustomEvent 回送 progress/result/error。 */
-const MINI_PROGRAM_NATIVE_HOST_MESSAGE_EVENT = 'heybox:miniprogram-native-host-message';
-function isMiniProgramNativeHostMessage(value) {
-    if (!isRecord$1(value) || !isNonEmptyString(value.requestId))
-        return false;
-    if (value.type === 'progress')
-        return Object.prototype.hasOwnProperty.call(value, 'payload');
-    if (value.type === 'result')
-        return !Object.prototype.hasOwnProperty.call(value, 'error');
-    if (value.type !== 'error' || !isRecord$1(value.error))
-        return false;
-    return isNonEmptyString(value.error.code) && isNonEmptyString(value.error.message);
-}
-function isMiniProgramNativeHostDescription(value) {
-    if (!isRecord$1(value) ||
-        !isPositiveSafeInteger(value.protocolVersion) ||
-        !isPositiveSafeInteger(value.contractRevision) ||
-        !isRecord$1(value.operations))
-        return false;
-    const operations = value.operations;
-    if (!isOperationList(operations.system) ||
-        !isOperationList(operations.network) ||
-        !isOperationList(operations.files))
-        return false;
-    return operations.system.includes('describe');
-}
-function isMiniProgramNativeBinaryChunk(value) {
-    return (isRecord$1(value) &&
-        isNonEmptyString(value.resourceId) &&
-        typeof value.data === 'string' &&
-        Number.isSafeInteger(value.byteLength) &&
-        Number(value.byteLength) >= 0 &&
-        Number(value.byteLength) <= MINI_PROGRAM_NATIVE_CHUNK_MAX_BYTES &&
-        typeof value.eof === 'boolean' &&
-        (Number(value.byteLength) > 0 || value.eof));
-}
-function isRecord$1(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-}
-function isNonEmptyString(value) {
-    return typeof value === 'string' && value.length > 0;
-}
-function isPositiveSafeInteger(value) {
-    return Number.isSafeInteger(value) && Number(value) > 0;
-}
-function isOperationList(value) {
-    return (Array.isArray(value) &&
-        value.every(operation => isNonEmptyString(operation) && operation === operation.trim()) &&
-        new Set(value).size === value.length);
-}
-
-/** 当前用户信息与登录能力支持的完整 scope 目录（canonical 顺序）。 */
-const USER_INFO_AUTHORIZATION_SCOPES = ['identity', 'profile', 'steam_account'];
-/** Companion alias 的跨构建、Runtime 与 Host 规范。 */
-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',
-    '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',
-];
-
 const MINI_PROGRAM_PERMISSION_KEYS = [
     'userInfo',
     'steamLibrary',
@@ -1456,6 +1318,7 @@ const MINI_PROGRAM_NO_DECLARATION_METHODS = [
     'ui.hideLoading',
     'viewport.getWindowInfo',
     'viewport.setNavigationBarStyle',
+    'viewport.setDisplay',
     'device.vibrate',
     'navigation.close',
     'navigation.reload',
@@ -1596,7 +1459,7 @@ function isManagedMiniProgramRuntimePermissionKey(key) {
  * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
  */
 function parseMiniProgramRuntimePermissions(snapshot) {
-    if (!isRecord(snapshot) || snapshot.schema_version !== 1 || !Array.isArray(snapshot.entries)) {
+    if (!isRecord$2(snapshot) || snapshot.schema_version !== 1 || !Array.isArray(snapshot.entries)) {
         return { valid: false, permissions: {} };
     }
     if (snapshot.revision !== undefined && (typeof snapshot.revision !== 'number' || !Number.isInteger(snapshot.revision) || snapshot.revision < 0)) {
@@ -1605,7 +1468,7 @@ function parseMiniProgramRuntimePermissions(snapshot) {
     const seenKeys = new Set();
     const permissions = {};
     for (const rawEntry of snapshot.entries) {
-        if (!isRecord(rawEntry) || typeof rawEntry.key !== 'string' || !rawEntry.key.trim()) {
+        if (!isRecord$2(rawEntry) || typeof rawEntry.key !== 'string' || !rawEntry.key.trim()) {
             return { valid: false, permissions: {} };
         }
         const inputKey = rawEntry.key.trim();
@@ -1621,7 +1484,7 @@ function parseMiniProgramRuntimePermissions(snapshot) {
         }
         if (key === 'network') {
             const config = rawEntry.config;
-            if (!isRecord(config) || typeof config.useOfficialDomain !== 'boolean') {
+            if (!isRecord$2(config) || typeof config.useOfficialDomain !== 'boolean') {
                 return { valid: false, permissions: {} };
             }
             permissions[key] = {
@@ -1631,7 +1494,7 @@ function parseMiniProgramRuntimePermissions(snapshot) {
             };
             continue;
         }
-        if (rawEntry.config !== null && rawEntry.config !== undefined && (!isRecord(rawEntry.config) || Object.keys(rawEntry.config).length > 0)) {
+        if (rawEntry.config !== null && rawEntry.config !== undefined && (!isRecord$2(rawEntry.config) || Object.keys(rawEntry.config).length > 0)) {
             return { valid: false, permissions: {} };
         }
         permissions[key] = {
@@ -1642,8 +1505,264 @@ function parseMiniProgramRuntimePermissions(snapshot) {
     }
     return { valid: true, permissions };
 }
-function isRecord(value) {
+function isRecord$2(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 
-export { AUTH_LOGIN_METHOD, CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_INFO_METHOD, CLOUD_LEADERBOARD_GET_LIST_METHOD, CLOUD_LEADERBOARD_SUBMIT_METHOD, COMPANION_ALIAS_PATTERN, COMPANION_CANCEL_PREPARATION_METHOD, COMPANION_ERROR_CODES, COMPANION_GET_ACTIVE_SESSION_METHOD, COMPANION_GET_INFO_METHOD, COMPANION_GET_PREPARATION_STATUS_METHOD, COMPANION_LAUNCH_METHOD, COMPANION_OPEN_ATTACHMENT_METHOD, COMPANION_PREPARE_METHOD, COMPANION_SESSION_ACK_OUTPUT_METHOD, COMPANION_SESSION_CLOSE_STDIN_METHOD, COMPANION_SESSION_EXIT_EVENT, COMPANION_SESSION_OUTPUT_EVENT, COMPANION_SESSION_OWNERSHIP_LOST_EVENT, COMPANION_SESSION_TERMINATE_METHOD, COMPANION_SESSION_WRITE_METHOD, COMPANION_SHOW_NOTIFICATION_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, DIRECTORY_CREATE_METHOD, DIRECTORY_EXISTS_METHOD, DIRECTORY_LIST_METHOD, DIRECTORY_REMOVE_METHOD, FILES_PICK_DIRECTORY_METHOD, FILES_PICK_FILES_METHOD, FILES_SAVE_FILE_METHOD, FILE_CREATE_METHOD, FILE_EXISTS_METHOD, FILE_READ_BYTES_METHOD, FILE_READ_TEXT_METHOD, FILE_REMOVE_METHOD, FILE_STAT_METHOD, FILE_WRITE_BYTES_METHOD, FILE_WRITE_TEXT_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_NATIVE_CHUNK_MAX_BYTES, MINI_PROGRAM_NATIVE_HOST_CONTRACT_REVISION, MINI_PROGRAM_NATIVE_HOST_DESCRIPTION, MINI_PROGRAM_NATIVE_HOST_MESSAGE_EVENT, MINI_PROGRAM_NATIVE_HOST_OBJECT, MINI_PROGRAM_NATIVE_HOST_PROTOCOL_VERSION, MINI_PROGRAM_NATIVE_OPERATIONS, MINI_PROGRAM_NO_DECLARATION_METHODS, MINI_PROGRAM_OPERATION_PROGRESS_METHOD, MINI_PROGRAM_PERMISSION_CATALOG, MINI_PROGRAM_PERMISSION_KEYS, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_DOWNLOAD_METHOD, NETWORK_REQUEST_METHOD, RUNTIME_LOCATION_PROBE_METHOD, SDK_CSP_VIOLATION_METHOD, SDK_HANDSHAKE_METHOD, SDK_LOCATION_REPORT_METHOD, SHARE_COPY_LINK_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_INFO_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, USER_INFO_AUTHORIZATION_SCOPES, USER_REVOKE_AUTHORIZATION_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isManagedMiniProgramRuntimePermissionKey, isMiniProgramBridgeMessage, isMiniProgramByteArray, isMiniProgramCompanionPrepareProgress, isMiniProgramDirectoryDescriptor, isMiniProgramDirectoryRef, isMiniProgramDownloadProgressPayload, isMiniProgramFileDescriptor, isMiniProgramFileRef, isMiniProgramFileStat, isMiniProgramFileSystemEntityDescriptor, isMiniProgramNativeBinaryChunk, isMiniProgramNativeHostDescription, isMiniProgramNativeHostMessage, isMiniProgramOperationProgressPayload, isMiniProgramPathRootRef, isMiniProgramPermissionKey, isMiniProgramRelativePath, parseMiniProgramRuntimePermissions };
+/** 仅供开发工具和 Host 使用；新增权限必须单独评估，不能从平台审批目录自动推导。 */
+const LOCAL_DEV_GRANT_PERMISSION_KEYS = ['network', 'companion'];
+/**
+ * 严格解析本地 grant。任何未知字段、重复权限或非法配置都拒绝整份输入。
+ * 只校验数据合同；票据、身份、摘要、过期时间和 CLI lease 必须由 Host 另行验证。
+ */
+function parseMiniProgramLocalDevGrant(value) {
+    if (!hasExactFields(value, ['schema_version', 'revision', 'entries']) ||
+        value.schema_version !== 1 ||
+        typeof value.revision !== 'number' ||
+        !Number.isSafeInteger(value.revision) ||
+        value.revision < 0 ||
+        !Array.isArray(value.entries) ||
+        value.entries.length > LOCAL_DEV_GRANT_PERMISSION_KEYS.length)
+        return { valid: false };
+    const entries = [];
+    const seen = new Set();
+    for (const entry of value.entries) {
+        if (!hasExactFields(entry, ['key', 'status', 'config']) || entry.status !== 'enabled')
+            return { valid: false };
+        if (typeof entry.key !== 'string' || seen.has(entry.key))
+            return { valid: false };
+        seen.add(entry.key);
+        if (entry.key === 'network') {
+            if (!hasExactFields(entry.config, ['useOfficialDomain']) || entry.config.useOfficialDomain !== false)
+                return { valid: false };
+            entries.push({ key: 'network', status: 'enabled', config: { useOfficialDomain: false } });
+        }
+        else if (entry.key === 'companion') {
+            if (!hasExactFields(entry.config, []))
+                return { valid: false };
+            entries.push({ key: 'companion', status: 'enabled', config: {} });
+        }
+        else {
+            return { valid: false };
+        }
+    }
+    entries.sort((a, b) => LOCAL_DEV_GRANT_PERMISSION_KEYS.indexOf(a.key) - LOCAL_DEV_GRANT_PERMISSION_KEYS.indexOf(b.key));
+    return { valid: true, grant: { schema_version: 1, revision: value.revision, entries } };
+}
+/**
+ * 从已校验声明生成批准缺口。Companion 默认不符合资格，由 CLI 确认平台、产物与摘要后显式加入。
+ * 空 entries 可保留 revision，不能作为存在临时权限的判断依据。
+ */
+function createMiniProgramLocalDevGrant(options) {
+    if (!Number.isSafeInteger(options.revision) || options.revision < 0)
+        throw new Error('本地调试权限 revision 必须是非负安全整数');
+    const approvals = parseMiniProgramRuntimePermissions(options.runtimePermissions);
+    const eligible = new Set(options.eligiblePermissionKeys ?? ['network']);
+    const entries = [];
+    for (const key of LOCAL_DEV_GRANT_PERMISSION_KEYS) {
+        if (!eligible.has(key) || options.declaredPermissions[key]?.enabled !== true)
+            continue;
+        if (approvals.valid && approvals.permissions[key]?.status === 'enabled')
+            continue;
+        entries.push(key === 'network'
+            ? { key, status: 'enabled', config: { useOfficialDomain: false } }
+            : { key, status: 'enabled', config: {} });
+    }
+    return { schema_version: 1, revision: options.revision, entries };
+}
+/**
+ * 线上基线先与本地声明求交，再补齐临时权限，返回与输入脱离的普通 Runtime 快照。
+ * 调用方只可在当前 Dev Session 已验证且用户接受后传入 grant；本函数不证明其可信来源。
+ * 非法 grant 整体降权到基线，已批准配置不会被临时配置覆盖。
+ */
+function composeLocalDevRuntimePermissions(options) {
+    const baseline = parseMiniProgramRuntimePermissions(options.runtimePermissions);
+    const parsed = parseMiniProgramLocalDevGrant(options.localDevGrant);
+    const permissions = baseline.valid ? baseline.permissions : {};
+    for (const key of MINI_PROGRAM_PERMISSION_KEYS) {
+        if (options.declaredPermissions[key]?.enabled !== true) {
+            delete permissions[key];
+        }
+        else if (key === 'network' && permissions.network) {
+            permissions.network.config.useOfficialDomain = permissions.network.status === 'enabled'
+                && permissions.network.config.useOfficialDomain === true
+                && options.declaredPermissions.network?.useOfficialDomain === true;
+        }
+    }
+    const temporaryPermissionKeys = [];
+    if (parsed.valid) {
+        for (const entry of parsed.grant.entries) {
+            if (options.declaredPermissions[entry.key]?.enabled !== true || permissions[entry.key]?.status === 'enabled')
+                continue;
+            permissions[entry.key] = entry;
+            temporaryPermissionKeys.push(entry.key);
+        }
+    }
+    const revision = isRecord$1(options.runtimePermissions) && typeof options.runtimePermissions.revision === 'number'
+        && Number.isSafeInteger(options.runtimePermissions.revision) && options.runtimePermissions.revision >= 0
+        ? options.runtimePermissions.revision : undefined;
+    return {
+        runtimePermissions: {
+            schema_version: 1,
+            ...(revision === undefined ? {} : { revision }),
+            entries: MINI_PROGRAM_PERMISSION_KEYS.flatMap((key) => permissions[key] ? [permissions[key]] : []),
+        },
+        temporaryPermissionKeys,
+        grantValid: parsed.valid,
+    };
+}
+function isRecord$1(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function hasExactFields(value, fields) {
+    return isRecord$1(value) && Object.keys(value).length === fields.length
+        && fields.every((field) => Object.prototype.hasOwnProperty.call(value, field));
+}
+
+/** 由 scripts/generate-native-host-contract.mjs 生成，请勿手改。 */
+const MINI_PROGRAM_NATIVE_HOST_PROTOCOL_VERSION = 1;
+const MINI_PROGRAM_NATIVE_HOST_CONTRACT_REVISION = 1;
+const MINI_PROGRAM_NATIVE_CHUNK_MAX_BYTES = 65536;
+const MINI_PROGRAM_NATIVE_OPERATIONS = {
+    "system": [
+        "describe"
+    ],
+    "network": [
+        "open",
+        "read",
+        "release",
+        "transfer"
+    ],
+    "files": [
+        "create",
+        "remove",
+        "exists",
+        "openRead",
+        "openWrite",
+        "read",
+        "release",
+        "write",
+        "stat",
+        "list",
+        "pickFiles",
+        "pickDirectory",
+        "saveFile"
+    ]
+};
+const MINI_PROGRAM_NATIVE_HOST_DESCRIPTION = {
+    "protocolVersion": 1,
+    "contractRevision": 1,
+    "operations": {
+        "system": [
+            "describe"
+        ],
+        "network": [
+            "open",
+            "read",
+            "release",
+            "transfer"
+        ],
+        "files": [
+            "create",
+            "remove",
+            "exists",
+            "openRead",
+            "openWrite",
+            "read",
+            "release",
+            "write",
+            "stat",
+            "list",
+            "pickFiles",
+            "pickDirectory",
+            "saveFile"
+        ]
+    }
+};
+
+/** Android WebMessageListener object 与 iOS WKScriptMessageHandler 共用名称。 */
+const MINI_PROGRAM_NATIVE_HOST_OBJECT = 'hbMiniProgramHost';
+/** Native 通过主文档 CustomEvent 回送 progress/result/error。 */
+const MINI_PROGRAM_NATIVE_HOST_MESSAGE_EVENT = 'heybox:miniprogram-native-host-message';
+function isMiniProgramNativeHostMessage(value) {
+    if (!isRecord(value) || !isNonEmptyString(value.requestId))
+        return false;
+    if (value.type === 'progress')
+        return Object.prototype.hasOwnProperty.call(value, 'payload');
+    if (value.type === 'result')
+        return !Object.prototype.hasOwnProperty.call(value, 'error');
+    if (value.type !== 'error' || !isRecord(value.error))
+        return false;
+    return isNonEmptyString(value.error.code) && isNonEmptyString(value.error.message);
+}
+function isMiniProgramNativeHostDescription(value) {
+    if (!isRecord(value) ||
+        !isPositiveSafeInteger(value.protocolVersion) ||
+        !isPositiveSafeInteger(value.contractRevision) ||
+        !isRecord(value.operations))
+        return false;
+    const operations = value.operations;
+    if (!isOperationList(operations.system) ||
+        !isOperationList(operations.network) ||
+        !isOperationList(operations.files))
+        return false;
+    return operations.system.includes('describe');
+}
+function isMiniProgramNativeBinaryChunk(value) {
+    return (isRecord(value) &&
+        isNonEmptyString(value.resourceId) &&
+        typeof value.data === 'string' &&
+        Number.isSafeInteger(value.byteLength) &&
+        Number(value.byteLength) >= 0 &&
+        Number(value.byteLength) <= MINI_PROGRAM_NATIVE_CHUNK_MAX_BYTES &&
+        typeof value.eof === 'boolean' &&
+        (Number(value.byteLength) > 0 || value.eof));
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+function isPositiveSafeInteger(value) {
+    return Number.isSafeInteger(value) && Number(value) > 0;
+}
+function isOperationList(value) {
+    return (Array.isArray(value) &&
+        value.every(operation => isNonEmptyString(operation) && operation === operation.trim()) &&
+        new Set(value).size === value.length);
+}
+
+/** 当前用户信息与登录能力支持的完整 scope 目录（canonical 顺序）。 */
+const USER_INFO_AUTHORIZATION_SCOPES = ['identity', 'profile', 'steam_account'];
+/** Companion alias 的跨构建、Runtime 与 Host 规范。 */
+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',
+    '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 { AUTH_LOGIN_METHOD, CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_INFO_METHOD, CLOUD_LEADERBOARD_GET_LIST_METHOD, CLOUD_LEADERBOARD_SUBMIT_METHOD, COMPANION_ALIAS_PATTERN, COMPANION_CANCEL_PREPARATION_METHOD, COMPANION_ERROR_CODES, COMPANION_GET_ACTIVE_SESSION_METHOD, COMPANION_GET_INFO_METHOD, COMPANION_GET_PREPARATION_STATUS_METHOD, COMPANION_LAUNCH_METHOD, COMPANION_OPEN_ATTACHMENT_METHOD, COMPANION_PREPARE_METHOD, COMPANION_SESSION_ACK_OUTPUT_METHOD, COMPANION_SESSION_CLOSE_STDIN_METHOD, COMPANION_SESSION_EXIT_EVENT, COMPANION_SESSION_OUTPUT_EVENT, COMPANION_SESSION_OWNERSHIP_LOST_EVENT, COMPANION_SESSION_TERMINATE_METHOD, COMPANION_SESSION_WRITE_METHOD, COMPANION_SHOW_NOTIFICATION_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, DIRECTORY_CREATE_METHOD, DIRECTORY_EXISTS_METHOD, DIRECTORY_LIST_METHOD, DIRECTORY_REMOVE_METHOD, FILES_PICK_DIRECTORY_METHOD, FILES_PICK_FILES_METHOD, FILES_SAVE_FILE_METHOD, FILE_CREATE_METHOD, FILE_EXISTS_METHOD, FILE_READ_BYTES_METHOD, FILE_READ_TEXT_METHOD, FILE_REMOVE_METHOD, FILE_STAT_METHOD, FILE_WRITE_BYTES_METHOD, FILE_WRITE_TEXT_METHOD, LOCAL_DEV_GRANT_PERMISSION_KEYS, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_NATIVE_CHUNK_MAX_BYTES, MINI_PROGRAM_NATIVE_HOST_CONTRACT_REVISION, MINI_PROGRAM_NATIVE_HOST_DESCRIPTION, MINI_PROGRAM_NATIVE_HOST_MESSAGE_EVENT, MINI_PROGRAM_NATIVE_HOST_OBJECT, MINI_PROGRAM_NATIVE_HOST_PROTOCOL_VERSION, MINI_PROGRAM_NATIVE_OPERATIONS, MINI_PROGRAM_NO_DECLARATION_METHODS, MINI_PROGRAM_OPERATION_PROGRESS_METHOD, MINI_PROGRAM_PERMISSION_CATALOG, MINI_PROGRAM_PERMISSION_KEYS, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_DOWNLOAD_METHOD, NETWORK_REQUEST_METHOD, RUNTIME_LOCATION_PROBE_METHOD, SDK_CSP_VIOLATION_METHOD, SDK_HANDSHAKE_METHOD, SDK_LOCATION_REPORT_METHOD, SHARE_COPY_LINK_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_INFO_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, USER_INFO_AUTHORIZATION_SCOPES, USER_REVOKE_AUTHORIZATION_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_DISPLAY_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, composeLocalDevRuntimePermissions, createMiniProgramLocalDevGrant, isManagedMiniProgramRuntimePermissionKey, isMiniProgramBridgeMessage, isMiniProgramByteArray, isMiniProgramCompanionPrepareProgress, isMiniProgramDirectoryDescriptor, isMiniProgramDirectoryRef, isMiniProgramDownloadProgressPayload, isMiniProgramFileDescriptor, isMiniProgramFileRef, isMiniProgramFileStat, isMiniProgramFileSystemEntityDescriptor, isMiniProgramNativeBinaryChunk, isMiniProgramNativeHostDescription, isMiniProgramNativeHostMessage, isMiniProgramOperationProgressPayload, isMiniProgramPathRootRef, isMiniProgramPermissionKey, isMiniProgramRelativePath, parseMiniProgramLocalDevGrant, parseMiniProgramRuntimePermissions };

package/generated/permission-catalog.json

@@ -1,5 +1,5 @@
 {
-  "hash": "411af8cb9f6bffc9a10c7b1bdf8eda6f777d25e52e34b8b2e72eb9ab0b2ee095",
+  "hash": "6a5978e344f22fd060ff55f77a1248a7c161cd8fbf5be2b8c73eddd308e8fe78",
   "permissions": [
     {
       "key": "userInfo",
@@ -177,6 +177,7 @@
     "ui.hideLoading",
     "viewport.getWindowInfo",
     "viewport.setNavigationBarStyle",
+    "viewport.setDisplay",
     "device.vibrate",
     "navigation.close",
     "navigation.reload",

package/package.json

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

package/src/bridge.ts

@@ -18,6 +18,8 @@ import type { MiniProgramCapabilityProgress, MiniProgramProgressMethod } from '.
 export type MiniProgramBridgeMessageType = 'handshake' | 'request' | 'response' | 'event' | 'cancel';
 export type MiniProgramEventName =
   | 'launch'
+  | 'viewport_change'
+  | 'display_change'
   | 'ready'
   | 'show'
   | 'hide'
@@ -123,6 +125,12 @@ export interface MiniProgramBridgeProgressMessage<
   error?: never;
 }
 export interface MiniProgramEventPayloadMap {
+  /** 展示状态实际变化后通知；不回放初始状态，不支持或失败时不通知。 */
+  display_change: import('./payloads').MiniProgramDisplayState & {
+    /** api 为开发者调用；user 为用户点击宿主退出全屏按钮。同目标合并时保留首次发起来源。旧宿主可能不提供。 */
+    source?: 'api' | 'user';
+  };
+  viewport_change: import('./payloads').MiniProgramWindowInfoResult;
   launch: { timestamp: number; url?: string };
   ready: { timestamp: number };
   show: { timestamp: number; source?: string };