@heybox/hb-sdk-protocol 0.8.3-alpha.3 → 0.8.3-alpha.5

package/dist/index.esm.js

@@ -445,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;
@@ -595,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']);
@@ -661,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']);
@@ -728,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']);
@@ -802,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) &&
@@ -872,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) &&
@@ -1051,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)) &&
@@ -1111,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'])) {
@@ -1122,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) &&
@@ -1140,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';
@@ -1161,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',
@@ -1605,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)) {
@@ -1614,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();
@@ -1630,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] = {
@@ -1640,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] = {
@@ -1651,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);
+}
+
+/** 仅供开发工具和 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, 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, isManagedMiniProgramRuntimePermissionKey, isMiniProgramBridgeMessage, isMiniProgramByteArray, isMiniProgramCompanionPrepareProgress, isMiniProgramDirectoryDescriptor, isMiniProgramDirectoryRef, isMiniProgramDownloadProgressPayload, isMiniProgramFileDescriptor, isMiniProgramFileRef, isMiniProgramFileStat, isMiniProgramFileSystemEntityDescriptor, isMiniProgramNativeBinaryChunk, isMiniProgramNativeHostDescription, isMiniProgramNativeHostMessage, isMiniProgramOperationProgressPayload, isMiniProgramPathRootRef, isMiniProgramPermissionKey, isMiniProgramRelativePath, parseMiniProgramRuntimePermissions };
+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/package.json

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

package/src/index.ts

@@ -2,6 +2,7 @@ export * from './bridge';
 export * from './capabilities';
 export * from './constants';
 export * from './guards';
+export * from './local-dev-grant';
 export * from './native-host';
 export * from './payloads';
 export * from './permission-catalog';