@heybox/hb-sdk 0.7.4-alpha.4 → 0.7.4-alpha.6

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.7.4-alpha.6
+
+### SDK / CLI
+
+- Browser Dev Host 增加私有双栈连接，并继续保留现有 HTTP/SSE fallback；连接不可用时仍可按原调试流程工作。
+- Mobile 二维码统一使用 `open_inapp` 与 `heybox://` `openWindow` 包装的局域网短链接；短链返回跳转页，打开完整 `heybox-mini-dev://sandbox` 协议后延迟调用 `closeWindow` 关闭中间页。移除不再需要的 `--raw-protocol` 与 `--runtime-url` 参数。
+- `hb-sdk dev` 不再支持匿名调试；启动 Browser、Mac 或 Mobile 调试前必须完成 CLI 登录并绑定小程序，且远端 Dev Context 必须可用。
+- PC/Mac 与移动端的原生启动、账号、网络、存储和权限契约保持不变，本版本不要求更新原生客户端。
+- Mobile 调试短链使用 LAN HTTP，只应在受信局域网内使用；不要在公共或不受信网络中暴露调试服务。
+- Browser Dev Host 的 `network.request` 代理允许办公网、Tailscale 与 Clash fake-ip 解析到的本机/局域网地址；仍拒绝 metadata、NAT64 和跨 origin redirect。
+- Browser Mock 使用 Node 中的 `hb-sdk login` 会话代发 Host `heybox-session` 请求，调试页去掉 Bridge/User 状态和登录按钮，改为简单授权弹窗。凭证不下发到浏览器。
+
+## 0.7.4-alpha.5
+
+### Share extra
+
+- `share.showShareMenu()` 支持携带 JSON-compatible `extra`，新增 `share.copyLink()` 复制并返回相同格式的通用分享链接；链接启动后可通过同步 `share.getExtra()` 恢复页面状态。
+
 ## 0.7.4-alpha.4
 
 ### SDK

package/README.md

@@ -110,7 +110,7 @@ SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握
 | ------------ | ------------------------------------------------------------ |
 | `auth`       | 获取交给开发者服务端交换的短期授权码                         |
 | `user`       | 读取 Host 当前用户资料、隔离身份或撤销授权                   |
-| `share`      | 打开分享或截图分享流程                                       |
+| `share`      | 打开分享、复制链接或截图分享流程                             |
 | `ui`         | 展示 Toast 和 Loading                                        |
 | `device`     | 调用振动和剪贴板能力                                         |
 | `navigation` | 关闭、刷新页面或打开小黑盒页面                               |
@@ -139,6 +139,22 @@ SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握
 - 仅当远端已启用 `network.request` 时，`hb-sdk dev` 与 `hb-sdk remote deploy` 构建才会跳过平台 CSP；其他构建继续注入平台 CSP。`useOfficialDomain` 不参与 CSP 跳过判定。
 - 构建必须启用 `miniappManifest()`，推荐统一使用 `hb-sdk build`。
 
+## 分享扩展数据
+
+默认分享和复制链接可以携带小程序自行定义的页面状态：
+
+```ts
+await hbSDK.share.showShareMenu({
+  title: '排行榜',
+  desc: '查看当前排名',
+  extra: { page: 'ranking', options: [1, 2, 3] },
+});
+
+const sharedState = hbSDK.share.getExtra();
+```
+
+`extra` 只支持 JSON-compatible 数据，没有有效数据时 `getExtra()` 返回 `undefined`。完整的路由示例和参数限制见[社区分享预置](https://docs.xiaoheihe.cn/hb_sdk/recipes/community-share)。
+
 ## 云端排行榜
 
 删除当前用户的排行榜成绩属于破坏性操作，只能在明确的用户操作和二次确认后执行：
@@ -183,6 +199,8 @@ hb-sdk remote deploy --release-note "本次更新说明"
 | `hb-sdk build`         | 执行生产构建与产物校验，不包含类型检查 |
 | `hb-sdk remote deploy` | 构建、上传并提交当前版本审核           |
 
+`hb-sdk dev` 不要求升级 Android、iOS 或 Mac 客户端。启动前必须先运行 `hb-sdk login` 并通过 `hb-sdk remote create` 或 `hb-sdk remote bind` 绑定小程序；未登录、未绑定或远端 Dev Context 不可用时不会启动 Vite、Browser Dev Host、Mac 或 Mobile 调试入口。Browser Mock 会自动在实时与兼容链路间切换；Mobile 统一使用 `open_inapp` 与 `heybox://` `openWindow` 包装的局域网短链 `http://<lan-ip>:<browser-dev-host-port>/l/<token>`。短链返回跳转页，先打开带 `heybox-mini-dev://sandbox`、`mini_url`、身份、启动票和 LAN Dev Context 的完整协议，约 500ms 后再发 `closeWindow` 关掉中间页。调试页权限覆盖只影响本地状态，不会修改线上配置。完整操作见 [CLI 指南](https://docs.xiaoheihe.cn/hb_sdk/guide/cli)，实现与安全边界由 [Runtime Host 迁移](./docs/runtime-host-migration.md) 维护。
+
 远端提交前需要完成 CLI 登录和小程序绑定。完整的登录、绑定、预览、版本与发布流程见 [CLI 指南](https://docs.xiaoheihe.cn/hb_sdk/guide/cli)。
 
 ## 文档

package/dist/cli-chunks/{build-BqGFRLe-.cjs → build-DF74IHGR.cjs}

@@ -5,8 +5,8 @@ var fs = require('node:fs/promises');
 var path = require('node:path');
 var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
 var runtimeGate = require('./runtime-gate-CtV7rWyX.cjs');
-var index = require('./index-CyEqCbeu.cjs');
-var projectVite = require('./project-vite-BUY9DgYo.cjs');
+var index = require('./index-DxQgKWRT.cjs');
+var projectVite = require('./project-vite-D_NNB_Ib.cjs');
 require('node:async_hooks');
 require('node:module');
 require('path');

package/dist/cli-chunks/{context-DTr3hRTv.cjs → context-QemmshdY.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var session = require('./session-BUjFX2U2.cjs');
+var session = require('./session-C2zY7XHn.cjs');
 var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
@@ -45,6 +45,23 @@ function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 
+function parseBrowserDevPermissionState(value) {
+    if (!isPlainRecord(value) || !hasExactKeys(value, ['networkRequest']))
+        return undefined;
+    const networkRequest = value.networkRequest;
+    if (!isPlainRecord(networkRequest) || !hasExactKeys(networkRequest, ['status', 'useOfficialDomain']))
+        return undefined;
+    if (networkRequest.status !== 'enabled' && networkRequest.status !== 'disabled')
+        return undefined;
+    if (typeof networkRequest.useOfficialDomain !== 'boolean')
+        return undefined;
+    return {
+        networkRequest: {
+            status: networkRequest.status,
+            useOfficialDomain: networkRequest.useOfficialDomain,
+        },
+    };
+}
 function shouldSkipMiniappPlatformCsp(runtimePermissions) {
     const parsed = parseMiniProgramRuntimePermissions(runtimePermissions);
     const networkRequest = parsed.permissions['network.request'];
@@ -87,6 +104,13 @@ function cloneDefaultPermissionState() {
         networkRequest: { ...DEFAULT_PERMISSION_STATE.networkRequest },
     };
 }
+function isPlainRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;
+}
+function hasExactKeys(value, keys) {
+    const actualKeys = Object.keys(value);
+    return actualKeys.length === keys.length && keys.every((key) => Object.hasOwn(value, key));
+}
 
 function createRemoteApiClient(options) {
     return {
@@ -401,6 +425,7 @@ exports.createBrowserDevRuntimePermissions = createBrowserDevRuntimePermissions;
 exports.createLocalDevLaunchToken = createLocalDevLaunchToken;
 exports.createRemoteApiClientForEnvironment = createRemoteApiClientForEnvironment;
 exports.getBoundMiniProgram = getBoundMiniProgram;
+exports.parseBrowserDevPermissionState = parseBrowserDevPermissionState;
 exports.parseMiniProgramRuntimePermissions = parseMiniProgramRuntimePermissions;
 exports.readBoundMiniProgramId = readBoundMiniProgramId;
 exports.readBoundMiniProgramIdFromPackageJson = readBoundMiniProgramIdFromPackageJson;

package/dist/cli-chunks/{create-OkiiiH4I.cjs → create-Ch9m8w8M.cjs}

@@ -5,7 +5,7 @@ var fs = require('node:fs/promises');
 var path = require('node:path');
 var require$$0 = require('fs');
 var require$$1 = require('path');
-var index = require('./index-CyEqCbeu.cjs');
+var index = require('./index-DxQgKWRT.cjs');
 require('node:module');
 require('os');
 require('readline');