@heybox/hb-sdk 0.9.6-alpha.1 → 0.9.6-alpha.3

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-B-rjfibN.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-C2Vw0-AC.js">
+    <script type="module" crossorigin src="/assets/index-Cd6MCK70.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-BQyQdYEd.js">
     <link rel="stylesheet" crossorigin href="/assets/index-DSTlrpnQ.css">
   </head>
   <body>

package/dist/index.cjs.js

@@ -7509,7 +7509,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.6-alpha.1';
+    : '0.9.6-alpha.3';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);
@@ -11389,13 +11389,18 @@ function getFollowStatus(requester) {
  *
  * @throws {@link HbMiniProgramSDKError} `userInfo` 未声明或不可用、握手失败、Host 不支持该能力、
  * 当前小程序身份缺失、账号/隔离身份读取失败、返回结构不合法、Runtime 终止，或请求期间
- * 账号与授权上下文变化时抛出。
+ * 账号与授权上下文变化时抛出。第三方联网小程序的身份读取返回 `SERVER_API_REQUIRED`。
  *
  * @remarks
+ * **网络权限决定用户信息的读取入口：`local` 模式使用本方法；联网的 `server` 模式
+ * 使用 `auth.login()` 与服务端换票，调用本方法读取身份会返回 `SERVER_API_REQUIRED`。**
+ *
  * 当前账号未登录属于正常返回分支，不抛错。账号已登录时，该能力不展示授权 UI，也不要求
  * 可信用户手势；Runtime 会静默建立或读取当前小程序的隔离 `app_user_id`，并授予
  * `identity` 与 `profile`。它只要求 Manifest 中声明 `userInfo`，不要求公开 `network`
- * 权限，也不返回可供服务端换票的授权码；开启网络权限后仍可调用。
+ * 权限，也不返回可供服务端换票的授权码。第三方小程序在启用网络权限的 `server` 模式下
+ * 会以 `SERVER_API_REQUIRED` 拒绝身份读取，应改用 `auth.login()` 并由开发者服务端换票；
+ * `local` 与兼容 `legacy` 模式保留直接读取能力。
  *
  * @example
  * ```ts

package/dist/index.esm.js

@@ -7505,7 +7505,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.6-alpha.1';
+    : '0.9.6-alpha.3';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);
@@ -11385,13 +11385,18 @@ function getFollowStatus(requester) {
  *
  * @throws {@link HbMiniProgramSDKError} `userInfo` 未声明或不可用、握手失败、Host 不支持该能力、
  * 当前小程序身份缺失、账号/隔离身份读取失败、返回结构不合法、Runtime 终止，或请求期间
- * 账号与授权上下文变化时抛出。
+ * 账号与授权上下文变化时抛出。第三方联网小程序的身份读取返回 `SERVER_API_REQUIRED`。
  *
  * @remarks
+ * **网络权限决定用户信息的读取入口：`local` 模式使用本方法；联网的 `server` 模式
+ * 使用 `auth.login()` 与服务端换票，调用本方法读取身份会返回 `SERVER_API_REQUIRED`。**
+ *
  * 当前账号未登录属于正常返回分支，不抛错。账号已登录时，该能力不展示授权 UI，也不要求
  * 可信用户手势；Runtime 会静默建立或读取当前小程序的隔离 `app_user_id`，并授予
  * `identity` 与 `profile`。它只要求 Manifest 中声明 `userInfo`，不要求公开 `network`
- * 权限，也不返回可供服务端换票的授权码；开启网络权限后仍可调用。
+ * 权限，也不返回可供服务端换票的授权码。第三方小程序在启用网络权限的 `server` 模式下
+ * 会以 `SERVER_API_REQUIRED` 拒绝身份读取，应改用 `auth.login()` 并由开发者服务端换票；
+ * `local` 与兼容 `legacy` 模式保留直接读取能力。
  *
  * @example
  * ```ts

package/dist/vite.cjs.js

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

package/dist/vite.esm.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.9.6-alpha.1",
+  "version": "0.9.6-alpha.3",
   "sideEffects": [
     "./src/index.ts",
     "./src/core/singleton.ts",
@@ -77,7 +77,7 @@
     "undici": "^7.28.0",
     "ws": "^8.18.0",
     "sharp": "^0.34.5",
-    "@heybox/hb-sdk-protocol": "0.9.6-alpha.1"
+    "@heybox/hb-sdk-protocol": "0.9.6-alpha.3"
   },
   "peerDependencies": {
     "vite": ">=5"
@@ -129,12 +129,12 @@
     "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-domain/heybox-theme": "~0.1.0",
-    "@heybox/hb-sdk-runtime": "~0.9.6-alpha.1",
-    "@heybox/hb-api": "~1.28.20",
     "@heybox-domain/heybox-vue3-ui": "~0.1.0",
-    "@heybox/runtime-policy": "~0.2.1",
+    "@heybox/hb-api": "~1.28.20",
+    "@heybox/hb-sdk-runtime": "~0.9.6-alpha.3",
+    "@heybox-domain/heybox-theme": "~0.1.0",
     "@heybox/runtime": "~0.2.1",
+    "@heybox/runtime-policy": "~0.2.1",
     "@heybox/runtime-transport-fetch": "~0.2.1"
   },
   "publishConfig": {

package/skill/skill.json

@@ -1,15 +1,15 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.9.6-alpha.1+skill.fe3b525ecac8",
+  "skillVersion": "0.9.6-alpha.3+skill.fe3b525ecac8",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.9.6-alpha.1",
-    "compatibility": "0.9.6-alpha.1"
+    "version": "0.9.6-alpha.3",
+    "compatibility": "0.9.6-alpha.3"
   },
   "distribution": {
     "type": "npm",
     "package": "@heybox/hb-sdk",
-    "version": "0.9.6-alpha.1",
+    "version": "0.9.6-alpha.3",
     "path": "skill"
   },
   "integrity": "sha256-fe3b525ecac8431e1774ee453864cf9ba58ff6897272e2356ceb17b621c8c427"

package/types/index.d.ts

@@ -2875,6 +2875,8 @@ interface MiniProgramUserModule {
      *
      * @throws {@link HbMiniProgramSDKError} `PERMISSION_NOT_IN_SNAPSHOT` / `PERMISSION_DENIED` 表示
      * 当前运行快照缺少或未启用 `userInfo` 权限；`INVALID_STATE` 表示缺少 canonical 小程序身份；
+     * `SERVER_API_REQUIRED` 表示第三方小程序处于联网的 `server` 模式，应使用 `auth.login()`
+     * 并由开发者服务端换票读取身份；
      * `REQUEST_FAILED` / `REQUEST_UNSUPPORTED` / `INVALID_RESPONSE` 表示 Host 或资料读取失败；
      * `HEYBOX_APP_LOGIN_REQUIRED` 表示初次登录态检查后，Host 会话在隔离身份读取期间失效；
      * `AUTHORIZATION_CONTEXT_CHANGED` 表示请求期间发生账号切换或授权撤销；
@@ -2887,9 +2889,14 @@ interface MiniProgramUserModule {
      * 两种情况调用方都应停止立即重试，避免把用户 IP 打成被封。
      *
      * @remarks
+     * **无网络的 `local` 模式使用本方法；有网络的 `server` 模式使用
+     * `auth.login()` 与服务端换票，调用本方法读取身份会返回 `SERVER_API_REQUIRED`。**
+     * 本地扫码调试的临时网络批准同样会影响身份模式。
+     *
      * 该读取不展示授权 UI，也不要求可信用户手势。Manifest 中必须声明 `userInfo`，但不需要
      * 公开 `network` 权限；Manifest 权限与 `authorization.identity/profile` 表示的用户授权是
-     * 两层独立门禁。开启网络权限后仍可调用本方法。
+     * 两层独立门禁。第三方小程序进入联网的 `server` 模式后不能调用本方法获取身份；
+     * 应使用 `auth.login()` 并由开发者服务端换票。`local` 与兼容 `legacy` 模式保留直接读取能力。
      *
      * 当前账号未登录是正常返回分支，不是 `HEYBOX_APP_LOGIN_REQUIRED` 错误。已登录时 Runtime
      * 会静默建立或读取本小程序隔离身份，并授予 `identity` 与 `profile`。`app_user_id` 只在