@heybox/hb-sdk 0.7.3 → 0.7.4-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 0.7.4-alpha.1
+
+### Breaking / Host Runtime
+
+- Runtime 已硬切到 `ports` + Capability Module 架构：移除 `platformAdapter`、Heybox Runtime factory 和独立 Mock Runtime。Host 集成改用 `@heybox/hb-sdk-runtime` 的 `createMiniProgramRuntime()`、`host-contract` 与 `web-host` 入口。
+- 新增零依赖 `@heybox/hb-sdk-protocol` 作为 wire contract owner；`@heybox/hb-sdk/protocol` 仅保留兼容 re-export。Runtime 内部不再提供独立 `runtime-request`/Transport facade，所有 Runtime 网络 I/O 经过 `HostNetworkPort`。
+- 这是 Host/Runtime 集成的 breaking change；小程序业务 API（`auth`、`user`、`share`、`network` 等）保持公开契约，DOM/network helper 与旧 mock-host 仅允许按迁移文档清理。
+- 同步记录 network security hardening（敏感 header、受保护 endpoint 和显式 credential realm）与 typed-void result correction（void method 统一返回 `undefined`；排行榜删除仍返回 `{ deleted }`）。
+
+### SDK
+
+- 统一服务端密钥名称并补充接入文档 (@heybox-spa/open).
+- Browser Dev Host 未配置外部 one-time code / PKCE 服务时明确禁用登录入口，避免把 CLI 登录态或 credential 暴露给调试页面。
+
+### Runtime
+
+- 完成 Runtime Host 分层硬切 (@heybox/hb-sdk-runtime).
+- 修复 Mobile storage 对象读取、PC Host 重试与公开网络能力声明，并保证 terminal abort 后截图 chrome cleanup 可跨独立发布入口恢复。
+
+### Release
+
+- Protocol、Runtime 与 SDK 改为版本锁步的 release family，固定按 Protocol、Runtime、SDK candidate 发布并最后提升 SDK dist-tag；支持无副作用 dry-run、失败续跑和显式 dist-tag rollback。
+- Runtime 与 SDK 发布产物精确锁定同版本 Protocol，避免后续 Protocol patch 改变已发布版本的安装图。
+
+### SDK / Runtime
+
+- 保留无网络模式 `user.getInfo()` 对 `identity` 与 `profile` 的隐式 full-scope 授权，并迁移到新的 Protocol/Capability owner。
+
 ## 0.7.3
 
 ### SDK
@@ -219,7 +247,7 @@
 
 - 将截图来源身份绑定到启动详情返回的小程序 ID，避免信任未经绑定的宿主 URL 参数 (@heybox/hb-sdk-runtime)。
 - 自定义 `resolveLaunchUrl` 可通过 `helpers.bindCanonicalIdentity` 回填可信小程序身份，避免 cloud / 截图来源在覆盖启动解析时丢失 identity (@heybox/hb-sdk-runtime)。
-- Mock Runtime 支持显式 `identity`，并在注释中标明 mock host URL 与生产启动详情信任边界的差异 (@heybox/hb-sdk-runtime)。
+- Mock Runtime 支持显式 `identity`，并在注释中标明 browser dev host URL 与生产启动详情信任边界的差异 (@heybox/hb-sdk-runtime)。
 
 ## 0.6.6
 

package/README.md

@@ -4,6 +4,8 @@
 
 SDK 只提供面向小程序开发者的稳定接口，不提供客户端内部协议、登录凭据或私有实现入口。本地浏览器调试请使用 `hb-sdk dev` 提供的 Mock 环境，发布前仍需在小黑盒 APP 中完成真机验收。
 
+宿主集成边界：`@heybox/hb-sdk-runtime` 运行在 iframe 外并负责 bridge/Host Port；跨 iframe 的 wire contract 唯一维护在零依赖 `@heybox/hb-sdk-protocol`。业务页面不需要创建 Runtime、实现 Host Port 或导入协议包；客户端 SDK 只依赖已兼容 re-export 的 `@heybox/hb-sdk/protocol`。
+
 ## 快速开始
 
 ### 创建新项目
@@ -190,3 +192,6 @@ hb-sdk remote deploy --release-note "本次更新说明"
 - [Recipes](https://docs.xiaoheihe.cn/hb_sdk/recipes/)
 - [API Reference](https://docs.xiaoheihe.cn/hb_sdk/reference/)
 - [小程序工坊上架规则](https://docs.xiaoheihe.cn/hb_sdk/guide/mini-program-publishing-rules)
+- [Runtime Host 迁移](./docs/runtime-host-migration.md)
+
+Host/Runtime 集成维护者请先阅读 [`@heybox/hb-sdk-runtime` README](../hb-sdk-runtime/README.md)、[Runtime Reference](../hb-sdk-runtime/docs/reference/) 和 [`@heybox/hb-sdk-protocol` README](../hb-sdk-protocol/README.md)。

package/dist/cli-chunks/{build-0sZ873iU.cjs → build-Cej8ObyY.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-CIucOD2H.cjs');
-var projectVite = require('./project-vite-ESaxoAE1.cjs');
+var index = require('./index-BCd2vU5D.cjs');
+var projectVite = require('./project-vite-BtIYxLkt.cjs');
 require('node:async_hooks');
 require('node:module');
 require('path');

package/dist/cli-chunks/{context-DNQEI7m7.cjs → context-DATgeHkI.cjs}

@@ -1,27 +1,15 @@
 'use strict';
 
-var session = require('./session-C9KHqijL.cjs');
+var session = require('./session-9ZWPGpqB.cjs');
 var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var path = require('node:path');
 
 const MANAGED_RUNTIME_PERMISSION_KEYS = new Set(['network.request']);
-/**
- * 判断 permission key 是否由 Runtime 权限快照管理。
- *
- * @param key 待判断的 permission key。
- * @returns 该 key 需要读取 Runtime 权限快照时返回 `true`。
- */
 function isManagedMiniProgramRuntimePermissionKey(key) {
     return MANAGED_RUNTIME_PERMISSION_KEYS.has(key);
 }
-/**
- * 解析服务端权限快照；格式不完整时整份快照失效并 fail closed。
- *
- * @param snapshot 待校验的服务端权限快照。
- * @returns 解析状态和通过校验的受管权限。
- */
 function parseMiniProgramRuntimePermissions(snapshot) {
     if (!isRecord(snapshot) || snapshot.schema_version !== 1 || !Array.isArray(snapshot.entries)) {
         return { valid: false, permissions: {} };
@@ -40,9 +28,8 @@ function parseMiniProgramRuntimePermissions(snapshot) {
             return { valid: false, permissions: {} };
         }
         seenKeys.add(key);
-        if (!isManagedMiniProgramRuntimePermissionKey(key)) {
+        if (!isManagedMiniProgramRuntimePermissionKey(key))
             continue;
-        }
         if (key === 'network.request' && typeof rawEntry.config.useOfficialDomain !== 'boolean') {
             return { valid: false, permissions: {} };
         }
@@ -69,7 +56,7 @@ const DEFAULT_PERMISSION_STATE = {
         useOfficialDomain: false,
     },
 };
-function createMiniProgramMockPermissionState(context) {
+function createBrowserDevPermissionState(context) {
     const parsed = parseMiniProgramRuntimePermissions(context.runtimePermissions);
     const networkRequest = parsed.permissions['network.request'];
     return parsed.valid && networkRequest
@@ -81,7 +68,7 @@ function createMiniProgramMockPermissionState(context) {
         }
         : cloneDefaultPermissionState();
 }
-function createMiniProgramMockRuntimePermissions(state) {
+function createBrowserDevRuntimePermissions(state) {
     return {
         schema_version: 1,
         entries: [
@@ -409,9 +396,9 @@ function isTruthyEnvFlag(value) {
 }
 
 exports.MiniProgramProjectBindingError = MiniProgramProjectBindingError;
+exports.createBrowserDevPermissionState = createBrowserDevPermissionState;
+exports.createBrowserDevRuntimePermissions = createBrowserDevRuntimePermissions;
 exports.createLocalDevLaunchToken = createLocalDevLaunchToken;
-exports.createMiniProgramMockPermissionState = createMiniProgramMockPermissionState;
-exports.createMiniProgramMockRuntimePermissions = createMiniProgramMockRuntimePermissions;
 exports.createRemoteApiClientForEnvironment = createRemoteApiClientForEnvironment;
 exports.getBoundMiniProgram = getBoundMiniProgram;
 exports.parseMiniProgramRuntimePermissions = parseMiniProgramRuntimePermissions;

package/dist/cli-chunks/{create-BkE71M2U.cjs → create-LXHV_lW5.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-CIucOD2H.cjs');
+var index = require('./index-BCd2vU5D.cjs');
 require('node:module');
 require('os');
 require('readline');