@heybox/hb-sdk 0.9.2-alpha.9 → 0.9.3-alpha.0

package/dist/devtools/browser-dev-host/index.html

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="theme-color" content="#f4f5f7" />
     <title>小程序工坊调试台</title>
-    <script type="module" crossorigin src="/assets/index-DrbZkH9C.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-D9lPBkUV.js">
+    <script type="module" crossorigin src="/assets/index-BxPfCFAg.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-DxU-uwcm.js">
     <link rel="stylesheet" crossorigin href="/assets/index-7Cq8iNcD.css">
   </head>
   <body>

package/dist/index.cjs.js

@@ -7299,7 +7299,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.2-alpha.9';
+    : '0.9.3-alpha.0';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);

package/dist/index.esm.js

@@ -7295,7 +7295,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.2-alpha.9';
+    : '0.9.3-alpha.0';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);

package/dist/vite.cjs.js

@@ -10304,7 +10304,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.2-alpha.9';
+    : '0.9.3-alpha.0';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/dist/vite.esm.js

@@ -10301,7 +10301,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.2-alpha.9';
+    : '0.9.3-alpha.0';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.9.2-alpha.9",
+  "version": "0.9.3-alpha.0",
   "sideEffects": [
     "./src/index.ts",
     "./src/core/singleton.ts",
@@ -76,7 +76,7 @@
     "undici": "^7.28.0",
     "ws": "^8.18.0",
     "sharp": "^0.34.5",
-    "@heybox/hb-sdk-protocol": "0.9.2-alpha.9"
+    "@heybox/hb-sdk-protocol": "0.9.3-alpha.0"
   },
   "peerDependencies": {
     "vite": ">=5"
@@ -128,13 +128,13 @@
     "vitest": "^3.2.4",
     "@ai-desktop/view-contract": "file:../hb-sdk-protocol/vendor/view-contract-2.2.2-6ac49bbf6410.tgz",
     "rollup-plugin-dts": "6.4.0",
-    "@heybox/hb-sdk-runtime": "~0.9.2-alpha.9",
-    "@heybox-domain/heybox-theme": "~0.1.0",
     "@heybox-domain/heybox-vue3-ui": "~0.1.0",
-    "@heybox/hb-api": "~1.28.14",
+    "@heybox-domain/heybox-theme": "~0.1.0",
+    "@heybox/hb-sdk-runtime": "~0.9.3-alpha.0",
+    "@heybox/hb-api": "~1.28.16",
     "@heybox/runtime": "~0.2.1",
-    "@heybox/runtime-policy": "~0.2.1",
-    "@heybox/runtime-transport-fetch": "~0.2.1"
+    "@heybox/runtime-transport-fetch": "~0.2.1",
+    "@heybox/runtime-policy": "~0.2.1"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",

package/skill/skill.json

@@ -1,15 +1,15 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.9.2-alpha.9+skill.4d7b063940c3",
+  "skillVersion": "0.9.3-alpha.0+skill.4d7b063940c3",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.9.2-alpha.9",
-    "compatibility": "0.9.2-alpha.9"
+    "version": "0.9.3-alpha.0",
+    "compatibility": "0.9.3-alpha.0"
   },
   "distribution": {
     "type": "npm",
     "package": "@heybox/hb-sdk",
-    "version": "0.9.2-alpha.9",
+    "version": "0.9.3-alpha.0",
     "path": "skill"
   },
   "integrity": "sha256-4d7b063940c341502cf34c481b656be96ac27f1a252055b2b1af445c6392264c"

package/types/index.d.ts

@@ -4549,8 +4549,14 @@ interface MiniProgramCloudLeaderboardModule {
 }
 /** 当前用户在当前小程序下的字符串云存储；需声明 cloud_storage 权限。 */
 interface MiniProgramCloudStorageModule {
-    /** 读取原始字符串，不存在返回 undefined，空字符串正常返回。key 仅支持 1–128 位字母、数字、下划线和连字符。
-     * @throws HbMiniProgramSDKError 参数错误、权限不足、登录失效或请求失败时拒绝 Promise。
+    /**
+     * 读取原始字符串，不存在返回 `undefined`，空字符串正常返回。key 仅支持 1–128 位字母、数字、下划线和连字符。
+     *
+     * @remarks
+     * 当前用户须已登录小黑盒客户端。未登录时，Promise 以 `UNAUTHORIZED` 拒绝，
+     * 不会自动拉起登录或发送云存储请求；业务应提示用户登录成功后重试。
+     *
+     * @throws {@link HbMiniProgramSDKError} 未登录（`UNAUTHORIZED`）、参数错误、权限不足或请求失败时抛出。
      *
      * @since 0.9.2
      * @hbPlatform android
@@ -4565,10 +4571,17 @@ interface MiniProgramCloudStorageModule {
      * @hbClient macos none
      */
     getStorage(key: string): Promise<string | undefined>;
-    /** 写入最多 16KB 的 UTF-8 字符串。同 key 在首笔调用起固定 500ms 窗口内合并，仅提交最终值。
+    /**
+     * 写入最多 16KB 的 UTF-8 字符串。同 key 在首笔调用起固定 500ms 窗口内合并，仅提交最终值。
      * 后续调用不延长窗口；合并调用的 Promise 在最终值获远端确认后一起完成。
      * 不同 key 独立提交，同 key 请求串行；删除隔开窗口，不跨删除合并写入。
-     * 版本由 Runtime 管理；冲突返回 VERSION_CONFLICT。失败时拒绝同 key 已排队操作，需重新读取，不自动覆盖重试。
+     * 版本由 Runtime 管理；冲突返回 `VERSION_CONFLICT`。失败时拒绝同 key 已排队操作，需重新读取，不自动覆盖重试。
+     *
+     * @remarks
+     * 当前用户须已登录小黑盒客户端。未登录时，Promise 以 `UNAUTHORIZED` 拒绝，
+     * 不会自动拉起登录或发送云存储请求；业务应提示用户登录成功后重试。
+     *
+     * @throws {@link HbMiniProgramSDKError} 未登录（`UNAUTHORIZED`）、参数错误、权限不足或请求失败时抛出。
      *
      * @since 0.9.2
      * @hbPlatform android
@@ -4583,7 +4596,15 @@ interface MiniProgramCloudStorageModule {
      * @hbClient macos none
      */
     setStorage(key: string, value: string): Promise<void>;
-    /** 删除整个键值记录；不存在也视为成功，与同 key 的写入保持调用顺序。
+    /**
+     * 删除整个键值记录；不存在也视为成功，与同 key 的写入保持调用顺序。
+     *
+     * @remarks
+     * 当前用户须已登录小黑盒客户端。未登录时，Promise 以 `UNAUTHORIZED` 拒绝，
+     * 不会自动拉起登录或发送云存储请求；业务应提示用户登录成功后重试。
+     *
+     * @throws {@link HbMiniProgramSDKError} 未登录（`UNAUTHORIZED`）、参数错误、权限不足或请求失败时抛出。
+     *
      * @since 0.9.2
      * @hbPlatform android
      * @hbPlatform ios
@@ -4597,7 +4618,15 @@ interface MiniProgramCloudStorageModule {
      * @hbClient macos none
      */
     removeItem(key: string): Promise<void>;
-    /** 返回当前用户在当前小程序下全部 key，不暴露数量、配额和内部版本。
+    /**
+     * 返回当前用户在当前小程序下全部 key，不暴露数量、配额和内部版本。
+     *
+     * @remarks
+     * 当前用户须已登录小黑盒客户端。未登录时，Promise 以 `UNAUTHORIZED` 拒绝，
+     * 不会自动拉起登录或发送云存储请求；业务应提示用户登录成功后重试。
+     *
+     * @throws {@link HbMiniProgramSDKError} 未登录（`UNAUTHORIZED`）、参数错误、权限不足或请求失败时抛出。
+     *
      * @since 0.9.2
      * @hbPlatform android
      * @hbPlatform ios