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

package/dist/vite.cjs.js

@@ -2948,7 +2948,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.8.3-alpha.6';
+    : '0.8.3';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。
@@ -3229,7 +3229,7 @@ function deviceLogBootstrap(token) {
     return `<script>(function(){if(window.__hb_sdk_device_logs_installed__)return;
 window.__hb_sdk_device_logs_installed__=true;
 window.__hb_sdk_mini_dev_console_installed__=true;
-var endpoint='${DEVICE_LOG_PATH}',credential='${token}',id='',queue=[],seq=0,busy=false,dropped=0;
+var endpoint='${DEVICE_LOG_PATH}',credential='${token}',id='',queue=[],seq=0,busy=false,dropped=0,retryDelay=1000;
 var registrationId=Array.from(crypto.getRandomValues(new Uint8Array(16)),function(n){return n.toString(16).padStart(2,'0')}).join('');
 var send=window.fetch.bind(window);
 var sandboxResult;
@@ -3251,19 +3251,21 @@ window.addEventListener('error',function(e){add('error',[e.message])});
 window.addEventListener('unhandledrejection',function(e){add('error',[e.reason])});
 async function flush(){if(busy)return;
 busy=true;
+var success=false;
 try{if(!id){var ua=navigator.userAgent;
 var platform=window.name==='__hb_sdk_mini_dev__'?'Browser':/Android/i.test(ua)?'Android':/iPhone|iPad/i.test(ua)?'iOS':/Windows/i.test(ua)?'Windows':/Mac/i.test(ua)?'macOS':'Browser';
 var r=await send(endpoint,{method:'POST',headers:{'content-type':'application/json','x-hb-log-token':credential},body:JSON.stringify({register:true,platform:platform,registrationId:registrationId}),signal:AbortSignal.timeout(5000)});
-if(!r.ok)return;
+if(!r.ok)throw 0;
 var d=await r.json();
 id=d.id;
 credential=d.token}if(dropped){add('warn',['日志缓冲已丢弃 '+dropped+' 条']);
 dropped=0}var batch=queue.slice(0,50);
 while(batch.length>1&&new TextEncoder().encode(JSON.stringify(batch)).length>48000)batch.pop();
 var result=await send(endpoint,{method:'POST',headers:{'content-type':'application/json','x-hb-log-token':credential},body:JSON.stringify({id:id,logs:batch,sandboxResult:sandboxResult}),signal:AbortSignal.timeout(5000)});
-if(result.ok){var ack=await result.json();sandboxResult=undefined;
+if(!result.ok)throw 0;
+var ack=await result.json();sandboxResult=undefined;
 if(ack.sandboxRequest){try{var entries=await window.__hbSdkSandboxList(ack.sandboxRequest.path);sandboxResult={requestId:ack.sandboxRequest.requestId,entries:entries.slice(0,200),truncated:entries.length>200}}catch(e){sandboxResult={requestId:ack.sandboxRequest.requestId,error:true}}}
-queue=queue.filter(function(l){return l.sequence>ack.sequence})}}catch(e){}finally{busy=false}}setInterval(flush,1000);
+queue=queue.filter(function(l){return l.sequence>ack.sequence});success=true}catch(e){}finally{retryDelay=success?1000:Math.min(retryDelay*2,30000);busy=false;setTimeout(flush,retryDelay)}}
 flush()})();
 </script>`;
 }
@@ -13101,7 +13103,13 @@ function enforceMiniappHtmlPolicy(html, options = {}) {
     if (options.skipPlatformCsp) {
         return serialize(document);
     }
-    const content = options.hmrWebSocketUrl ? PRODUCTION_CSP.replace("connect-src 'none'", `connect-src ${options.hmrWebSocketUrl}`) : PRODUCTION_CSP;
+    const connectSources = Array.from(new Set([
+        options.hmrWebSocketUrl,
+        ...(options.deviceLogUploadUrls ?? []),
+    ].filter((source) => Boolean(source))));
+    const content = connectSources.length > 0
+        ? PRODUCTION_CSP.replace("connect-src 'none'", `connect-src ${connectSources.join(' ')}`)
+        : PRODUCTION_CSP;
     head.childNodes.unshift({
         nodeName: 'meta',
         tagName: 'meta',
@@ -13428,6 +13436,8 @@ function miniappManifest() {
     let outDir = 'dist';
     let command = 'build';
     let hmrWebSocketUrl;
+    let configuredDeviceLogUploadUrls = [];
+    let devServer;
     /** 构建链路中更早的失败原因；closeBundle 不得再用产物校验覆盖它。 */
     let priorBuildError;
     return {
@@ -13457,8 +13467,10 @@ function miniappManifest() {
             outDir = resolved.build.outDir;
             command = resolved.command;
             hmrWebSocketUrl = resolveHmrWebSocketUrl(resolved);
+            configuredDeviceLogUploadUrls = resolveConfiguredDeviceLogUploadUrls(resolved);
         },
         configureServer(server) {
+            devServer = server;
             // 开发期只对「仍是旧模板移动端默认」的声明做非阻断提示。声明缺失或非法一律交由
             // build / remote deploy 链路拒绝，因此这里只容忍读取阶段的异常，保持 hb-sdk dev
             // 既有的启动语义；warn 调用留在 try 之外，避免把插件上下文错误一起吞掉。
@@ -13706,7 +13718,15 @@ function miniappManifest() {
         },
         transformIndexHtml(html) {
             const enforced = enforceMiniappHtmlPolicy(html, {
-                ...(command === 'serve' ? { hmrWebSocketUrl } : {}),
+                ...(command === 'serve'
+                    ? {
+                        deviceLogUploadUrls: Array.from(new Set([
+                            ...configuredDeviceLogUploadUrls,
+                            ...resolveViteDeviceLogUploadUrls(devServer?.resolvedUrls),
+                        ])),
+                        hmrWebSocketUrl,
+                    }
+                    : {}),
                 skipPlatformCsp,
             });
             return command === 'serve'
@@ -13901,6 +13921,48 @@ function resolveHmrWebSocketUrl(resolved) {
     const port = options.clientPort ?? options.port ?? resolved.server.port;
     return `${protocol}://${host}${port ? `:${port}` : ''}`;
 }
+function resolveConfiguredDeviceLogUploadUrls(resolved) {
+    if (resolved.command !== 'serve')
+        return [];
+    const protocol = resolved.server.https ? 'https' : 'http';
+    const configuredHost = resolved.server.host;
+    const hosts = new Set();
+    if (typeof configuredHost === 'string' && configuredHost !== '0.0.0.0' && configuredHost !== '::') {
+        hosts.add(configuredHost);
+    }
+    else {
+        hosts.add('127.0.0.1');
+    }
+    return Array.from(hosts, host => createDeviceLogUploadUrl(protocol, host, resolved.server.port)).filter((url) => Boolean(url));
+}
+function resolveViteDeviceLogUploadUrls(resolvedUrls) {
+    if (!resolvedUrls)
+        return [];
+    return Array.from(new Set([...resolvedUrls.local, ...resolvedUrls.network].map(url => {
+        try {
+            const endpoint = new URL(DEVICE_LOG_PATH, url);
+            if (endpoint.protocol !== 'http:' && endpoint.protocol !== 'https:')
+                return undefined;
+            endpoint.username = '';
+            endpoint.password = '';
+            endpoint.search = '';
+            endpoint.hash = '';
+            return endpoint.toString();
+        }
+        catch {
+            return undefined;
+        }
+    }).filter((url) => Boolean(url))));
+}
+function createDeviceLogUploadUrl(protocol, host, port) {
+    try {
+        const normalizedHost = host.startsWith('[') || !host.includes(':') ? host : `[${host}]`;
+        return new URL(DEVICE_LOG_PATH, `${protocol}://${normalizedHost}${port === undefined ? '' : `:${port}`}`).toString();
+    }
+    catch {
+        return undefined;
+    }
+}
 
 exports.HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN_ENV = HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN_ENV;
 exports.HB_SDK_MINI_PROGRAM_MANIFEST_ACCESS_TOKEN_ENV = HB_SDK_MINI_PROGRAM_MANIFEST_ACCESS_TOKEN_ENV;

package/dist/vite.esm.js

@@ -2945,7 +2945,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.8.3-alpha.6';
+    : '0.8.3';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。
@@ -3226,7 +3226,7 @@ function deviceLogBootstrap(token) {
     return `<script>(function(){if(window.__hb_sdk_device_logs_installed__)return;
 window.__hb_sdk_device_logs_installed__=true;
 window.__hb_sdk_mini_dev_console_installed__=true;
-var endpoint='${DEVICE_LOG_PATH}',credential='${token}',id='',queue=[],seq=0,busy=false,dropped=0;
+var endpoint='${DEVICE_LOG_PATH}',credential='${token}',id='',queue=[],seq=0,busy=false,dropped=0,retryDelay=1000;
 var registrationId=Array.from(crypto.getRandomValues(new Uint8Array(16)),function(n){return n.toString(16).padStart(2,'0')}).join('');
 var send=window.fetch.bind(window);
 var sandboxResult;
@@ -3248,19 +3248,21 @@ window.addEventListener('error',function(e){add('error',[e.message])});
 window.addEventListener('unhandledrejection',function(e){add('error',[e.reason])});
 async function flush(){if(busy)return;
 busy=true;
+var success=false;
 try{if(!id){var ua=navigator.userAgent;
 var platform=window.name==='__hb_sdk_mini_dev__'?'Browser':/Android/i.test(ua)?'Android':/iPhone|iPad/i.test(ua)?'iOS':/Windows/i.test(ua)?'Windows':/Mac/i.test(ua)?'macOS':'Browser';
 var r=await send(endpoint,{method:'POST',headers:{'content-type':'application/json','x-hb-log-token':credential},body:JSON.stringify({register:true,platform:platform,registrationId:registrationId}),signal:AbortSignal.timeout(5000)});
-if(!r.ok)return;
+if(!r.ok)throw 0;
 var d=await r.json();
 id=d.id;
 credential=d.token}if(dropped){add('warn',['日志缓冲已丢弃 '+dropped+' 条']);
 dropped=0}var batch=queue.slice(0,50);
 while(batch.length>1&&new TextEncoder().encode(JSON.stringify(batch)).length>48000)batch.pop();
 var result=await send(endpoint,{method:'POST',headers:{'content-type':'application/json','x-hb-log-token':credential},body:JSON.stringify({id:id,logs:batch,sandboxResult:sandboxResult}),signal:AbortSignal.timeout(5000)});
-if(result.ok){var ack=await result.json();sandboxResult=undefined;
+if(!result.ok)throw 0;
+var ack=await result.json();sandboxResult=undefined;
 if(ack.sandboxRequest){try{var entries=await window.__hbSdkSandboxList(ack.sandboxRequest.path);sandboxResult={requestId:ack.sandboxRequest.requestId,entries:entries.slice(0,200),truncated:entries.length>200}}catch(e){sandboxResult={requestId:ack.sandboxRequest.requestId,error:true}}}
-queue=queue.filter(function(l){return l.sequence>ack.sequence})}}catch(e){}finally{busy=false}}setInterval(flush,1000);
+queue=queue.filter(function(l){return l.sequence>ack.sequence});success=true}catch(e){}finally{retryDelay=success?1000:Math.min(retryDelay*2,30000);busy=false;setTimeout(flush,retryDelay)}}
 flush()})();
 </script>`;
 }
@@ -13098,7 +13100,13 @@ function enforceMiniappHtmlPolicy(html, options = {}) {
     if (options.skipPlatformCsp) {
         return serialize(document);
     }
-    const content = options.hmrWebSocketUrl ? PRODUCTION_CSP.replace("connect-src 'none'", `connect-src ${options.hmrWebSocketUrl}`) : PRODUCTION_CSP;
+    const connectSources = Array.from(new Set([
+        options.hmrWebSocketUrl,
+        ...(options.deviceLogUploadUrls ?? []),
+    ].filter((source) => Boolean(source))));
+    const content = connectSources.length > 0
+        ? PRODUCTION_CSP.replace("connect-src 'none'", `connect-src ${connectSources.join(' ')}`)
+        : PRODUCTION_CSP;
     head.childNodes.unshift({
         nodeName: 'meta',
         tagName: 'meta',
@@ -13425,6 +13433,8 @@ function miniappManifest() {
     let outDir = 'dist';
     let command = 'build';
     let hmrWebSocketUrl;
+    let configuredDeviceLogUploadUrls = [];
+    let devServer;
     /** 构建链路中更早的失败原因；closeBundle 不得再用产物校验覆盖它。 */
     let priorBuildError;
     return {
@@ -13454,8 +13464,10 @@ function miniappManifest() {
             outDir = resolved.build.outDir;
             command = resolved.command;
             hmrWebSocketUrl = resolveHmrWebSocketUrl(resolved);
+            configuredDeviceLogUploadUrls = resolveConfiguredDeviceLogUploadUrls(resolved);
         },
         configureServer(server) {
+            devServer = server;
             // 开发期只对「仍是旧模板移动端默认」的声明做非阻断提示。声明缺失或非法一律交由
             // build / remote deploy 链路拒绝，因此这里只容忍读取阶段的异常，保持 hb-sdk dev
             // 既有的启动语义；warn 调用留在 try 之外，避免把插件上下文错误一起吞掉。
@@ -13703,7 +13715,15 @@ function miniappManifest() {
         },
         transformIndexHtml(html) {
             const enforced = enforceMiniappHtmlPolicy(html, {
-                ...(command === 'serve' ? { hmrWebSocketUrl } : {}),
+                ...(command === 'serve'
+                    ? {
+                        deviceLogUploadUrls: Array.from(new Set([
+                            ...configuredDeviceLogUploadUrls,
+                            ...resolveViteDeviceLogUploadUrls(devServer?.resolvedUrls),
+                        ])),
+                        hmrWebSocketUrl,
+                    }
+                    : {}),
                 skipPlatformCsp,
             });
             return command === 'serve'
@@ -13898,5 +13918,47 @@ function resolveHmrWebSocketUrl(resolved) {
     const port = options.clientPort ?? options.port ?? resolved.server.port;
     return `${protocol}://${host}${port ? `:${port}` : ''}`;
 }
+function resolveConfiguredDeviceLogUploadUrls(resolved) {
+    if (resolved.command !== 'serve')
+        return [];
+    const protocol = resolved.server.https ? 'https' : 'http';
+    const configuredHost = resolved.server.host;
+    const hosts = new Set();
+    if (typeof configuredHost === 'string' && configuredHost !== '0.0.0.0' && configuredHost !== '::') {
+        hosts.add(configuredHost);
+    }
+    else {
+        hosts.add('127.0.0.1');
+    }
+    return Array.from(hosts, host => createDeviceLogUploadUrl(protocol, host, resolved.server.port)).filter((url) => Boolean(url));
+}
+function resolveViteDeviceLogUploadUrls(resolvedUrls) {
+    if (!resolvedUrls)
+        return [];
+    return Array.from(new Set([...resolvedUrls.local, ...resolvedUrls.network].map(url => {
+        try {
+            const endpoint = new URL(DEVICE_LOG_PATH, url);
+            if (endpoint.protocol !== 'http:' && endpoint.protocol !== 'https:')
+                return undefined;
+            endpoint.username = '';
+            endpoint.password = '';
+            endpoint.search = '';
+            endpoint.hash = '';
+            return endpoint.toString();
+        }
+        catch {
+            return undefined;
+        }
+    }).filter((url) => Boolean(url))));
+}
+function createDeviceLogUploadUrl(protocol, host, port) {
+    try {
+        const normalizedHost = host.startsWith('[') || !host.includes(':') ? host : `[${host}]`;
+        return new URL(DEVICE_LOG_PATH, `${protocol}://${normalizedHost}${port === undefined ? '' : `:${port}`}`).toString();
+    }
+    catch {
+        return undefined;
+    }
+}
 
 export { HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN_ENV, HB_SDK_MINI_PROGRAM_MANIFEST_ACCESS_TOKEN_ENV, MINIAPP_PLATFORM_VALUES, miniappManifest };

package/docs/device-logs.md

@@ -29,8 +29,8 @@ Agent 应保存 `epoch` 和 `nextCursor`，`hasMore` 为 true 时继续翻页。
 
 ## 有界行为与权限
 
-每个页面最多缓冲 500 条，每批最多 50 条并限制编码后的请求体；失败后按原序号重试。服务器最多保存 5000 条、64 个设备会话，每设备每秒最多接收 200 条。设备 15 秒未心跳标记离线，旧日志保留直到被环形缓冲淘汰。超过页面缓冲时补充丢弃数量提示。开发服务凭证最长有效 12 小时，到期需重启开发服务并重新打开页面。
+每个页面最多缓冲 500 条，每批最多 50 条并限制编码后的请求体；失败后按原序号指数退避重试，最长等待 30 秒。服务器最多保存 5000 条、64 个设备会话，每设备每秒最多接收 200 条。设备 15 秒未心跳标记离线，旧日志保留直到被环形缓冲淘汰。超过页面缓冲时补充丢弃数量提示。开发服务凭证最长有效 12 小时，到期需重启开发服务并重新打开页面。
 
-设备上传凭证不能读取日志或上传其他会话的记录。读取接口只开放给本机数字 loopback Host，拒绝外站 Origin；授权边界是当前机器的本地开发者进程。页面上传只使用同源路径，不依赖 HTTPS 宿主页面连接跨源明文 WebSocket。上传前移除 URL query、fragment、userinfo 和常见凭据字段，服务端再次脱敏。此功能不能代替开发者对业务日志中的个人信息做最小化处理。
+设备上传凭证不能读取日志或上传其他会话的记录。读取接口只开放给本机数字 loopback Host，拒绝外站 Origin；授权边界是当前机器的本地开发者进程。页面上传只使用同源路径，`hb-sdk dev` 的平台 CSP 仅精确放行各实际开发服务地址下的日志端点，不开放其它浏览器网络出口，也不依赖 HTTPS 宿主页面连接跨源明文 WebSocket。上传前移除 URL query、fragment、userinfo 和常见凭据字段，服务端再次脱敏。此功能不能代替开发者对业务日志中的个人信息做最小化处理。
 
 当前聚合的是小程序页面和 SDK 的日志，不包含手机原生进程、PC 原生进程或 Companion stdout/stderr。调试台自身的 Runtime/Host 本地日志仍只在该页面显示。真机本地网络权限、宿主 CSP 及系统策略可能阻止连接，需要使用实际手机和 PC Extension 验证。

package/docs/runtime-host-migration.md

@@ -51,10 +51,11 @@ Browser Dev Host 由 SDK CLI 提供 Vue 3 调试台并注入 `@heybox/hb-sdk-run
 
 调试台不提供权限修改、Browser/Mobile 页签或重复二维码入口。线上批准基线与 CLI 根据声明生成的本地 grant 分开传输，Browser Fake 允许白名单内临时权限并保留线上未批准提示；唯一的 Mobile 二维码入口位于调试台右上角，并复用既有 LAN 网卡与 Dev Session 生命周期。
 
-## 新 PC 页面通道合同与窗口几何
+## 新 PC 页面通道合同与窗口导航
 
 小程序 Host 的页面通道以 `namespace` + `protocolVersion` + `contractRevision` 协商。当前详情页的
-`NEW_PC_HOST_CONTRACT_REVISION` 是 `1.7.0`，同时把 `1.1.0` / `1.4.0` / `1.5.0` / `1.6.0` 保留为 legacy revision。
+`NEW_PC_HOST_CONTRACT_REVISION` 是 `1.8.0`，同时把 `1.1.0` / `1.4.0` / `1.5.0` / `1.6.0` / `1.7.0` 保留为 legacy revision。
+`1.8.0` 新增私有 `navigation.openWindow` capability，用于把 Runtime 已收窄的 `miniProgramId` 与可选编码后 `extra` 交给桌面插件开窗；旧 revision 不得宣告该能力。
 双方必须在握手时选出**共同支持的最高 revision**，不能只读 `marker.contractRevision`：旧插件会把 marker 固定为
 其 legacy revision 供已部署页面兼容读取，真正的版本集合在 `supportedContractRevisions` 中；只回退 marker
 会把“支持到 1.5.0”的插件错误降级到 `1.1.0`。任一侧都不支持的组合必须在握手阶段明确失败，不做静默降级。
@@ -69,9 +70,10 @@ Browser Dev Host 由 SDK CLI 提供 Vue 3 调试台并注入 `@heybox/hb-sdk-run
 `source === 'program'` 的程序化变更（例如宿主恢复上次尺寸、响应系统缩放）只更新当前运行时几何，不得覆盖
 用户记忆。位置（`x` / `y`）始终不对开发者开放，页面不得声明或设置。
 
-detail 页面与工坊插件（Desktop Extension）共享同一通道合同，必须**成对发布和成对回滚**：只升级一侧会出现
-`HOST_VERSION_UNSUPPORTED` 或几何语义不一致。0.8.1 的正式发布说明需把 `0.8.1-alpha.14` 中的“合同升级到
-`1.6.0`”更正为 `1.7.0`，或明确写成 `1.6.0 → 1.7.0` 增量。
+detail 页面与工坊插件（Desktop Extension）通过最高公共 revision 支持独立发布和回滚。单侧升级时双方继续
+协商到旧 revision；例如只有一侧支持 `1.8.0` 时仍使用 `1.7.0`，现有能力保持可用，仅新的
+`mini_program` 目标返回 `REQUEST_UNSUPPORTED`。只有双方没有公共 revision 时才返回
+`HOST_VERSION_UNSUPPORTED`，不得静默切换到 Mobile、Web 或旧 PC Host。
 
 ## Host diagnostics
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.8.3-alpha.6",
+  "version": "0.8.3",
   "sideEffects": [
     "./src/index.ts",
     "./src/core/singleton.ts",
@@ -65,7 +65,7 @@
     "undici": "^7.28.0",
     "ws": "^8.18.0",
     "sharp": "^0.34.5",
-    "@heybox/hb-sdk-protocol": "0.8.3-alpha.6"
+    "@heybox/hb-sdk-protocol": "0.8.3"
   },
   "peerDependencies": {
     "vite": ">=5"
@@ -116,13 +116,13 @@
     "vue-tsc": "^3.3.7",
     "vite": "^8.0.12",
     "vitest": "^3.2.4",
-    "@heybox-domain/heybox-vue3-ui": "~0.1.0",
     "@heybox-domain/heybox-theme": "~0.1.0",
+    "@heybox-domain/heybox-vue3-ui": "~0.1.0",
     "@heybox/hb-api": "~1.28.9",
-    "@heybox/hb-sdk-runtime": "~0.8.3-alpha.6",
+    "@heybox/hb-sdk-runtime": "~0.8.3",
+    "@heybox/runtime": "~0.2.0",
     "@heybox/runtime-policy": "~0.2.0",
-    "@heybox/runtime-transport-fetch": "~0.2.0",
-    "@heybox/runtime": "~0.2.0"
+    "@heybox/runtime-transport-fetch": "~0.2.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",

package/skill/skill.json

@@ -1,15 +1,15 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.8.3-alpha.6+skill.aa24d6656331",
+  "skillVersion": "0.8.3+skill.aa24d6656331",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.8.3-alpha.6",
-    "compatibility": "0.8.3-alpha.6"
+    "version": "0.8.3",
+    "compatibility": "0.8.3"
   },
   "distribution": {
     "type": "npm",
     "package": "@heybox/hb-sdk",
-    "version": "0.8.3-alpha.6",
+    "version": "0.8.3",
     "path": "skill"
   },
   "integrity": "sha256-aa24d6656331cbad8f6aae7735258a49d7f1a82f6e900415de53a1b93a30ddb8"

package/types/index.d.ts

@@ -16,7 +16,7 @@ export type { CreateOptions, DirectoryHandle, FileHandle, FileMode, FileStat, Fi
 export type { HideLoadingPayload, HideLoadingResult, MiniProgramToastStatus, MiniProgramUiModule, ShowLoadingPayload, ShowLoadingResult, ShowToastPayload, ShowToastResult, } from './modules/ui';
 export type { MiniProgramDeviceModule, MiniProgramVibrateIntensity, SetClipboardPayload, SetClipboardResult, VibratePayload, VibrateResult, } from './modules/device';
 export type { MiniProgramEnvironmentInfo, MiniProgramEnvironmentModule, MiniProgramOperatingSystemName, MiniProgramRuntimeMode, } from './modules/environment';
-export type { ClosePayload, CloseResult, MiniProgramAppPageTarget, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, MiniProgramNavigationModule, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenGameDetailAppPageOptions, OpenPostDetailAppPagePayload, OpenPostDetailAppPageOptions, OpenUserDetailAppPagePayload, OpenUserDetailAppPageOptions, ReloadPayload, ReloadResult, } from './modules/navigation';
+export type { ClosePayload, CloseResult, MiniProgramAppPageTarget, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, MiniProgramNavigationModule, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenGameDetailAppPageOptions, OpenMiniProgramAppPagePayload, OpenMiniProgramAppPageOptions, OpenPostDetailAppPagePayload, OpenPostDetailAppPageOptions, OpenUserDetailAppPagePayload, OpenUserDetailAppPageOptions, ReloadPayload, ReloadResult, } from './modules/navigation';
 import { getHandshakeState, off, on, onHandshakeStateChange } from './core/singleton';
 declare const hbSDK: {
     getHandshakeState: typeof getHandshakeState;

package/types/modules/navigation/app-pages/index.d.ts

@@ -1,4 +1,4 @@
 import type { OpenAppPageOptions, OpenAppPagePayload } from './types';
-export type { MiniProgramAppPageTarget, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenGameDetailAppPageOptions, OpenPostDetailAppPagePayload, OpenPostDetailAppPageOptions, OpenUserDetailAppPagePayload, OpenUserDetailAppPageOptions, } from './types';
+export type { MiniProgramAppPageTarget, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenGameDetailAppPageOptions, OpenMiniProgramAppPagePayload, OpenMiniProgramAppPageOptions, OpenPostDetailAppPagePayload, OpenPostDetailAppPageOptions, OpenUserDetailAppPagePayload, OpenUserDetailAppPageOptions, } from './types';
 /** 校验并规范化打开黑盒 App 页面参数。 */
 export declare function normalizeOpenAppPageOptions(options: OpenAppPageOptions): OpenAppPagePayload;

package/types/modules/navigation/app-pages/types.d.ts

@@ -1,3 +1,4 @@
+import type { MiniProgramShareExtraValue } from '../../share/types';
 /**
  * 小程序可请求打开的黑盒 App 页面目标。
  *
@@ -5,11 +6,12 @@
  * - `game_detail`：小黑盒游戏详情页。
  * - `user_detail`：小黑盒用户详情页。
  * - `post_detail`：小黑盒帖子详情页，可选定位评论。
+ * - `mini_program`：另一个公开发布的小程序。
  *
- * 移动端 Host 支持这三类语义目标；当前 PC Host 只支持 `game_detail`。该联合不接受任意
- * URL、scheme 或内部路由路径，不支持的目标会在 SDK 或 Host 边界明确拒绝。
+ * 移动端 Host 支持全部目标；PC Host 支持 `game_detail` 与 `mini_program`。该联合不接受任意
+ * URL、scheme、目标版本或内部路由路径，不支持的目标会在 SDK 或 Host 边界明确拒绝。
  */
-export type MiniProgramAppPageTarget = 'game_detail' | 'user_detail' | 'post_detail';
+export type MiniProgramAppPageTarget = 'game_detail' | 'user_detail' | 'post_detail' | 'mini_program';
 /**
  * 游戏详情的游戏平台类型：`pc`、`console`（主机）或 `mobile`（移动游戏）。
  * 值区分大小写，不接受平台别名。
@@ -68,6 +70,18 @@ export interface OpenPostDetailAppPageOptions {
      */
     commentId?: string | number;
 }
+/** 打开另一个公开发布小程序的参数。 */
+export interface OpenMiniProgramAppPageOptions {
+    /** 固定为 `mini_program`。 */
+    target: 'mini_program';
+    /** 目标小程序 ID。SDK 会 trim 并拒绝空值；实际可访问性与版本由 Host 决定。 */
+    miniProgramId: string;
+    /**
+     * 可选启动数据。目标小程序通过 `share.getExtra()` 同步读取；省略与显式传入 `null` 含义不同。
+     * 值域、嵌套和 128 字节 MessagePack 上限与分享 `extra` 完全一致。
+     */
+    extra?: MiniProgramShareExtraValue;
+}
 /**
  * 打开黑盒 App 页面的判别联合参数。
  *
@@ -83,7 +97,7 @@ export interface OpenPostDetailAppPageOptions {
  *
  * @see [navigation.openAppPage](/reference/sdk/navigation/openAppPage)
  */
-export type OpenAppPageOptions = OpenGameDetailAppPageOptions | OpenUserDetailAppPageOptions | OpenPostDetailAppPageOptions;
+export type OpenAppPageOptions = OpenGameDetailAppPageOptions | OpenUserDetailAppPageOptions | OpenPostDetailAppPageOptions | OpenMiniProgramAppPageOptions;
 /**
  * 打开游戏详情页的规范化 bridge payload；`appId` 与可选 `skuId` 已转换为非空字符串。
  */
@@ -101,12 +115,16 @@ export type OpenPostDetailAppPagePayload = Omit<OpenPostDetailAppPageOptions, 'l
     rootCommentId?: string;
     commentId?: string;
 };
+/** 打开目标小程序的规范化 bridge payload；`miniProgramId` 已 trim。 */
+export type OpenMiniProgramAppPagePayload = Omit<OpenMiniProgramAppPageOptions, 'miniProgramId'> & {
+    miniProgramId: string;
+};
 /**
  * `navigation.openAppPage` 发送给 Host Runtime 的判别联合 payload。
  *
  * @remarks 只包含目标白名单字段；Runtime 会再次校验并构造固定的 Host 页面路由。
  */
-export type OpenAppPagePayload = OpenGameDetailAppPagePayload | OpenUserDetailAppPagePayload | OpenPostDetailAppPagePayload;
+export type OpenAppPagePayload = OpenGameDetailAppPagePayload | OpenUserDetailAppPagePayload | OpenPostDetailAppPagePayload | OpenMiniProgramAppPagePayload;
 /**
  * `navigation.openAppPage` 成功时 resolve `undefined`。
  *

package/types/modules/navigation/index.d.ts

@@ -1,7 +1,7 @@
 import type { MiniProgramRequester } from '../../core/client';
 import { type OpenAppPageOptions } from './app-pages';
 export { NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD } from '../../protocol/capabilities';
-export type { MiniProgramAppPageTarget, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenGameDetailAppPageOptions, OpenPostDetailAppPagePayload, OpenPostDetailAppPageOptions, OpenUserDetailAppPagePayload, OpenUserDetailAppPageOptions, } from './app-pages';
+export type { MiniProgramAppPageTarget, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenGameDetailAppPageOptions, OpenMiniProgramAppPagePayload, OpenMiniProgramAppPageOptions, OpenPostDetailAppPagePayload, OpenPostDetailAppPageOptions, OpenUserDetailAppPagePayload, OpenUserDetailAppPageOptions, } from './app-pages';
 /**
  * `navigation.close` 的无参 payload。
  *
@@ -178,7 +178,7 @@ export interface MiniProgramNavigationModule {
      */
     reload(): Promise<void>;
     /**
-     * 请求宿主打开受 SDK 白名单约束的黑盒 App 页面。
+     * 请求宿主打开受 SDK 白名单约束的黑盒 App 页面或公开小程序。
      *
      * @param options - 由 `target` 判别的目标页参数；字段与规范化规则见 {@link OpenAppPageOptions}。
      * @returns Host 接收参数并发起页面路由后 resolve `undefined`；不会等待目标页加载或返回目标页结果。
@@ -192,15 +192,15 @@ export interface MiniProgramNavigationModule {
      * 时，还会返回对应握手错误码或 `REQUEST_TIMEOUT`；其他 Host 路由失败保留其 SDK 错误码。
      *
      * @remarks
-     * 公开白名单仅包含游戏详情、用户详情和帖子详情；不能传任意 URL、scheme 或客户端内部
-     * 路径。SDK 会 trim 字符串，把 `appId`、`skuId`、`linkId`、`rootCommentId`、`commentId`
-     * 中的数字转换为字符串，并丢弃目标类型未声明的额外字段。Runtime 在 Host 边界再次校验，
-     * 再构造固定路由，页面提供的字段不能覆盖目标路径。
+     * 公开白名单包含游戏详情、用户详情、帖子详情和公开小程序；不能传任意 URL、scheme、版本
+     * 或客户端内部路径。`mini_program` 只接受 `miniProgramId` 与可选 `extra`，目标版本和访问性
+     * 由 Host 决定。`extra` 与分享扩展数据使用相同格式，目标小程序通过 `share.getExtra()` 读取。
+     * Runtime 会在 Host 边界再次校验，页面提供的字段不能覆盖目标路径或窗口展示参数。
      *
-     * 移动端 Host 支持三个目标。当前 Windows/macOS PC Host 只支持 `game_detail`，并只把
-     * `appId` 交给游戏详情导航；`gameType` 仍须合法，而 `page`、`hSrc`、`skuId` 不保证在 PC
-     * 生效。调用方应按目标和平台处理 `REQUEST_UNSUPPORTED`，不能仅凭方法出现在能力目录中
-     * 推断每种目标都可用。
+     * 移动端 Host 支持全部四类目标。当前 Windows/macOS PC Host 支持 `game_detail` 和
+     * `mini_program`，仍不支持 `user_detail`、`post_detail`；游戏详情只把 `appId` 交给导航，
+     * `gameType` 仍须合法，而 `page`、`hSrc`、`skuId` 不保证在 PC 生效。调用方应按目标和平台
+     * 处理 `REQUEST_UNSUPPORTED`，不能仅凭方法出现在能力目录中推断每种目标都可用。
      *
      * 该调用无需 `package.json#heybox.permissions` 声明、平台批准、用户授权或可信用户手势。
      * 它只发起一次 App 导航，没有返回值或 disposer，也不会替代
@@ -236,11 +236,20 @@ export interface MiniProgramNavigationModule {
      *     commentId,
      *   })
      * }
+     *
+     * async function openMiniProgram() {
+     *   await hbSDK.navigation.openAppPage({
+     *     target: 'mini_program',
+     *     miniProgramId: '2e2b8e19-8d73-45f8-8785-b87fd5535510',
+     *     extra: { page: 'ranking' },
+     *   })
+     * }
      * ```
      *
      * @see {@link OpenGameDetailAppPageOptions}
      * @see {@link OpenUserDetailAppPageOptions}
      * @see {@link OpenPostDetailAppPageOptions}
+     * @see {@link OpenMiniProgramAppPageOptions}
      * @see [navigation.close](/reference/sdk/navigation/close)
      * @see [navigation.reload](/reference/sdk/navigation/reload)
      * @see [权限声明](/guide/permissions#无需声明的-api)
@@ -280,14 +289,14 @@ export declare function close(requester: MiniProgramRequester): Promise<void>;
  */
 export declare function reload(requester: MiniProgramRequester): Promise<void>;
 /**
- * 请求宿主打开受 SDK 白名单约束的黑盒 App 页面。
+ * 请求宿主打开受 SDK 白名单约束的黑盒 App 页面或公开小程序。
  *
  * @param requester - 底层 bridge 请求能力。
  * @param options - 由 `target` 判别的目标页参数；发送前会校验并规范化。
  * @returns Host 发起受控页面路由后 resolve `undefined`。
  * @throws {@link HbMiniProgramSDKError} 参数非法、目标不受 Host 支持、路由失败或 SDK /
  * Runtime 已终止时抛出。
- * @remarks 该能力不接受任意 URL 或内部路由，也无需 Manifest 权限或可信用户手势。
+ * @remarks 该能力不接受任意 URL、版本或内部路由，也无需 Manifest 权限或可信用户手势。
  * @see [navigation.openAppPage](/reference/sdk/navigation/openAppPage)
  */
 export declare function openAppPage(requester: MiniProgramRequester, options: OpenAppPageOptions): Promise<void>;

package/types/modules/share/extra.d.ts

@@ -1,3 +1,5 @@
 import type { MiniProgramShareExtraValue } from './types';
+/** 校验公开启动扩展数据，并保持调用方传入的值语义不变。 */
+export declare function normalizeMiniProgramShareExtra(value: unknown): MiniProgramShareExtraValue;
 /** 读取小程序启动时携带的分享数据。 */
 export declare function readMiniProgramShareExtra(launchHref?: string): MiniProgramShareExtraValue | undefined;

package/types/modules/share/types.d.ts

@@ -14,6 +14,7 @@ export type MiniProgramShareChannel = 'wechatSession' | 'wechatTimeline' | 'qqFr
  * @remarks
  * 只允许 `null`、有限数字、字符串、布尔值、数组和普通对象；`undefined`、`NaN`、
  * `Infinity`、`bigint`、`symbol`、函数、循环引用、`Date`、`Map` 和其他 class 实例均不受支持。
+ * 普通对象的 key 不能是 MessagePack 解码器保留的 `__proto__`。
  * 合法的 `null`、`false`、`0` 与空字符串在 {@link MiniProgramShareModule.getExtra | share.getExtra}
  * 中会原样返回，不能用真假值判断是否存在分享数据。
  *

package/types/protocol.d.ts

@@ -1,5 +1,5 @@
 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, DIRECTORY_CREATE_METHOD, DIRECTORY_EXISTS_METHOD, DIRECTORY_LIST_METHOD, DIRECTORY_REMOVE_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_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_OPERATION_PROGRESS_METHOD, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_METHOD, NETWORK_DOWNLOAD_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_INFO_AUTHORIZATION_SCOPES, USER_GET_INFO_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, USER_REVOKE_AUTHORIZATION_METHOD, VIEWPORT_SET_DISPLAY_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isManagedMiniProgramRuntimePermissionKey, isMiniProgramByteArray, isMiniProgramBridgeMessage, isMiniProgramDirectoryDescriptor, isMiniProgramDirectoryRef, isMiniProgramDownloadProgressPayload, isMiniProgramFileDescriptor, isMiniProgramFileRef, isMiniProgramFileStat, isMiniProgramFileSystemEntityDescriptor, isMiniProgramPathRootRef, isMiniProgramRelativePath, parseMiniProgramRuntimePermissions, } from '@heybox/hb-sdk-protocol';
-export type { AuthorizedUserInfo, ClosePayload, CloseResult, CopyLinkPayload, CopyLinkResult, DirectoryCreatePayload, DirectoryCreateResult, DirectoryExistsPayload, DirectoryExistsResult, DirectoryListPayload, DirectoryListResult, DirectoryRemovePayload, DirectoryRemoveResult, DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, GetSteamGameListPayload, GetSteamGameListResult, GetStoragePayload, GetStorageResult, GetUserInfoPayload, GetUserInfoResult, MiniProgramOrientationMode, SetDisplayPayload, SetDisplayResult, MiniProgramDisplayState, GetWindowInfoPayload, GetWindowInfoResult, DownloadProgressPayload, HideLoadingPayload, HideLoadingResult, FileCreatePayload, FileCreateResult, FileExistsPayload, FileExistsResult, FileReadBytesPayload, FileReadBytesResult, FileReadTextPayload, FileReadTextResult, FileRemovePayload, FileRemoveResult, FileStatPayload, FileStatResult, FileWriteBytesPayload, FileWriteBytesResult, FileWriteTextPayload, FileWriteTextResult, LeaderboardEntry, LeaderboardOrder, LoginPayload, LoginResult, LoginScope, MiniProgramAuthMethod, MiniProgramBridgeError, MiniProgramBridgeCancelMessage, MiniProgramBridgeMessage, MiniProgramBridgeMessageType, MiniProgramBridgeProgressMessage, MiniProgramBridgeMethod, MiniProgramCapabilityDefinition, MiniProgramCapabilityModule, MiniProgramCapabilityPayload, MiniProgramCapabilityPayloadMap, MiniProgramCapabilityResult, MiniProgramCapabilityResultMap, MiniProgramCapabilityRisk, MiniProgramCloudMethod, MiniProgramDeviceMethod, MiniProgramDirectoryDescriptor, MiniProgramDirectoryMethod, MiniProgramDirectoryRef, MiniProgramDirectDirectoryRef, MiniProgramDirectFileRef, MiniProgramEventName, MiniProgramEventPayloadMap, MiniProgramFileDescriptor, MiniProgramFileMode, MiniProgramFileMethod, MiniProgramFileRef, MiniProgramFilesMethod, MiniProgramFileStat, MiniProgramFileSystemEntityDescriptor, MiniProgramFileSystemEntityRef, MiniProgramPathRootRef, MiniProgramSandboxRootRef, MiniProgramNavigationBarForegroundStyle, MiniProgramNavigationMethod, MiniProgramNetworkHeaders, MiniProgramNetworkMethod, MiniProgramNetworkParams, MiniProgramNetworkRequestMethod, MiniProgramOperatingSystemName, MiniProgramRuntimePermissionEntry, MiniProgramRuntimeEnvironmentInfo, MiniProgramRuntimeMode, MiniProgramRuntimePermissionsSnapshot, MiniProgramRuntimePermissionStatus, MiniProgramSafeArea, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareMethod, MiniProgramSharePostOptions, MiniProgramStorageMethod, MiniProgramToastStatus, MiniProgramUiMethod, MiniProgramUserInfoResult, MiniProgramUserMethod, MiniProgramVibrateIntensity, MiniProgramViewportMethod, MiniProgramWindowInfoResult, NetworkRequestPayload, NetworkResponsePayload, NetworkDownloadPayload, NetworkDownloadResult, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenPostDetailAppPagePayload, OpenUserDetailAppPagePayload, PickDirectoryPayload, PickDirectoryResult, PickFilesPayload, PickFilesResult, ParsedMiniProgramRuntimePermissions, ReloadPayload, ReloadResult, RevokeAuthorizationPayload, RevokeAuthorizationResult, RuntimeLocationProbePayload, ScreenshotPayload, ScreenshotResult, SaveFilePayload, SaveFileResult, SDKCSPBlockedResourceType, SDKCSPViolationPayload, SDKHandshakePayload, SDKHandshakeResult, SDKLocationReportPayload, SDKLocationReportTrigger, SetClipboardPayload, SetClipboardResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, SetStoragePayload, ShowLoadingPayload, ShowLoadingResult, ShowShareMenuPayload, ShowShareMenuResult, ShowToastPayload, ShowToastResult, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult, UserInfoAuthorization, UserInfoAuthorizationScope, UserInfoAuthorizationStatus, VibratePayload, VibrateResult, } from '@heybox/hb-sdk-protocol';
+export type { AuthorizedUserInfo, ClosePayload, CloseResult, CopyLinkPayload, CopyLinkResult, DirectoryCreatePayload, DirectoryCreateResult, DirectoryExistsPayload, DirectoryExistsResult, DirectoryListPayload, DirectoryListResult, DirectoryRemovePayload, DirectoryRemoveResult, DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, GetSteamGameListPayload, GetSteamGameListResult, GetStoragePayload, GetStorageResult, GetUserInfoPayload, GetUserInfoResult, MiniProgramOrientationMode, SetDisplayPayload, SetDisplayResult, MiniProgramDisplayState, GetWindowInfoPayload, GetWindowInfoResult, DownloadProgressPayload, HideLoadingPayload, HideLoadingResult, FileCreatePayload, FileCreateResult, FileExistsPayload, FileExistsResult, FileReadBytesPayload, FileReadBytesResult, FileReadTextPayload, FileReadTextResult, FileRemovePayload, FileRemoveResult, FileStatPayload, FileStatResult, FileWriteBytesPayload, FileWriteBytesResult, FileWriteTextPayload, FileWriteTextResult, LeaderboardEntry, LeaderboardOrder, LoginPayload, LoginResult, LoginScope, MiniProgramAuthMethod, MiniProgramBridgeError, MiniProgramBridgeCancelMessage, MiniProgramBridgeMessage, MiniProgramBridgeMessageType, MiniProgramBridgeProgressMessage, MiniProgramBridgeMethod, MiniProgramCapabilityDefinition, MiniProgramCapabilityModule, MiniProgramCapabilityPayload, MiniProgramCapabilityPayloadMap, MiniProgramCapabilityResult, MiniProgramCapabilityResultMap, MiniProgramCapabilityRisk, MiniProgramCloudMethod, MiniProgramDeviceMethod, MiniProgramDirectoryDescriptor, MiniProgramDirectoryMethod, MiniProgramDirectoryRef, MiniProgramDirectDirectoryRef, MiniProgramDirectFileRef, MiniProgramEventName, MiniProgramEventPayloadMap, MiniProgramFileDescriptor, MiniProgramFileMode, MiniProgramFileMethod, MiniProgramFileRef, MiniProgramFilesMethod, MiniProgramFileStat, MiniProgramFileSystemEntityDescriptor, MiniProgramFileSystemEntityRef, MiniProgramPathRootRef, MiniProgramSandboxRootRef, MiniProgramNavigationBarForegroundStyle, MiniProgramNavigationMethod, MiniProgramNetworkHeaders, MiniProgramNetworkMethod, MiniProgramNetworkParams, MiniProgramNetworkRequestMethod, MiniProgramOperatingSystemName, MiniProgramRuntimePermissionEntry, MiniProgramRuntimeEnvironmentInfo, MiniProgramRuntimeMode, MiniProgramRuntimePermissionsSnapshot, MiniProgramRuntimePermissionStatus, MiniProgramSafeArea, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareMethod, MiniProgramSharePostOptions, MiniProgramStorageMethod, MiniProgramToastStatus, MiniProgramUiMethod, MiniProgramUserInfoResult, MiniProgramUserMethod, MiniProgramVibrateIntensity, MiniProgramViewportMethod, MiniProgramWindowInfoResult, NetworkRequestPayload, NetworkResponsePayload, NetworkDownloadPayload, NetworkDownloadResult, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenMiniProgramAppPagePayload, OpenPostDetailAppPagePayload, OpenUserDetailAppPagePayload, PickDirectoryPayload, PickDirectoryResult, PickFilesPayload, PickFilesResult, ParsedMiniProgramRuntimePermissions, ReloadPayload, ReloadResult, RevokeAuthorizationPayload, RevokeAuthorizationResult, RuntimeLocationProbePayload, ScreenshotPayload, ScreenshotResult, SaveFilePayload, SaveFileResult, SDKCSPBlockedResourceType, SDKCSPViolationPayload, SDKHandshakePayload, SDKHandshakeResult, SDKLocationReportPayload, SDKLocationReportTrigger, SetClipboardPayload, SetClipboardResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, SetStoragePayload, ShowLoadingPayload, ShowLoadingResult, ShowShareMenuPayload, ShowShareMenuResult, ShowToastPayload, ShowToastResult, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult, UserInfoAuthorization, UserInfoAuthorizationScope, UserInfoAuthorizationStatus, VibratePayload, VibrateResult, } from '@heybox/hb-sdk-protocol';
 export type { LoginOptions } from './modules/auth';
 export type { GetSteamGameListOptions } from './modules/user';
 export type { MiniProgramEventHandler } from './protocol/types';

package/types/vite/html-policy.d.ts

@@ -1,5 +1,6 @@
 export declare const PRODUCTION_CSP: string;
 export declare function enforceMiniappHtmlPolicy(html: string, options?: {
+    deviceLogUploadUrls?: readonly string[];
     hmrWebSocketUrl?: string;
     skipPlatformCsp?: boolean;
 }): string;