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

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 本文件随 `@heybox/hb-sdk` npm 包公开分发，只记录外部小程序开发者可观察到的变化。内部集成、实现策略和审查证据不在此维护。
 
+## 0.8.1-alpha.3
+
+- 目标平台声明统一迁移到 `package.json#heybox.platforms`；`miniappManifest()` 恢复无参调用，并在构建时将该声明写入 `dist/manifest.json`。
+- `hb-sdk dev`、`hb-sdk build` 和普通 `hb-sdk remote deploy` 会拒绝缺失或非法的平台声明；build/deploy 也会拒绝与项目配置不一致的 Manifest。已有项目升级时需把原 Vite 参数中的 `platforms` 移入 `package.json#heybox`。
+
+## 0.8.1-alpha.2
+
+- 新增 `environment.getInfo()` 与 `environment.getInfoSync()`，用于读取运行模式、小黑盒 App 版本、canonical 小程序 ID/版本、操作系统和 SDK 版本的冻结快照。
+- 异步方法会自动等待 SDK 握手；同步方法仅在 `ready` 后可用，提前调用返回 `ENVIRONMENT_NOT_READY`。
+- 环境信息无需权限，只用于界面适配、兼容降级和诊断。旧 Host 与缺失字段按 `null` / `'unknown'` 降级，不影响小程序启动。
+- Runtime 与 Host 集成新增向后兼容的握手环境 response；现有 SDK 会忽略该 response，现有 Host 仍可与新 SDK 握手。
+
 ## 0.8.1-alpha.1
 
 - 预发布版本：更新日志文档改为直接投影结构完整的稳定版条目，与 npm 当前版本和 dist-tag 独立发布、独立重试。

package/README.md

@@ -94,7 +94,17 @@ async function revokeAuthorizationFromUserAction() {
 
 `user.revokeAuthorization()` 位于无需声明白名单，不接收小程序 ID、黑盒用户 ID 或手势参数。调用必须来自可信用户操作，否则返回 `USER_GESTURE_REQUIRED`。撤销成功后，后续身份或授权读取会重新进入授权流程；SDK 不会替业务清理已经持久化的数据。
 
-已有 Vite 项目还需要启用构建插件：
+已有 Vite 项目先在 `package.json#heybox.platforms` 声明实际承诺适配的平台：
+
+```json
+{
+  "heybox": {
+    "platforms": ["android", "ios", "ohos"]
+  }
+}
+```
+
+再启用构建插件：
 
 ```ts
 import { miniappManifest } from '@heybox/hb-sdk/vite';
@@ -102,12 +112,30 @@ import { defineConfig } from 'vite';
 
 export default defineConfig({
   base: './',
-  plugins: [miniappManifest({ platforms: ['android', 'ios', 'ohos'] })],
+  plugins: [miniappManifest()],
 });
 ```
 
 完整接入步骤见[快速开始](https://docs.xiaoheihe.cn/hb_sdk/guide/quick-start)。
 
+## 环境信息
+
+使用 `environment.getInfo()` 读取当前实例的冻结环境快照；它会自动等待 SDK 握手：
+
+```ts
+const info = await hbSDK.environment.getInfo();
+
+console.log(info.runtime.mode);
+console.log(info.host.appVersion);
+console.log(info.miniProgram.id, info.miniProgram.version);
+console.log(info.operatingSystem.name, info.operatingSystem.version);
+console.log(info.sdk.version);
+```
+
+已经确认 SDK 为 `ready` 时，可以通过 `environment.getInfoSync()` 同步读取同一份快照；握手前调用会抛出 `ENVIRONMENT_NOT_READY`。旧 Host 或缺失字段会返回固定结构，以 `null` / `'unknown'` 表示未知值。除 `sdk.version` 外，版本字段均为不透明字符串。
+
+环境信息无需权限，只用于界面适配、兼容降级、埋点和诊断，不能作为鉴权、权限控制或风控依据。完整字段和 Browser Mock 行为见[环境信息](https://docs.xiaoheihe.cn/hb_sdk/guide/environment)。
+
 ## 文件与下载
 
 `files` 提供当前小程序私有 sandbox 和由用户选择授予的外部 File/Directory；
@@ -172,6 +200,7 @@ SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握
 | 模块         | 用途                                            |
 | ------------ | ----------------------------------------------- |
 | `auth`       | 获取交给开发者服务端交换的短期授权码            |
+| `environment` | 读取当前实例的冻结环境快照                      |
 | `user`       | 读取 Host 当前用户资料、隔离身份或撤销授权      |
 | `share`      | 打开分享、复制链接或截图分享流程                |
 | `ui`         | 展示 Toast 和 Loading                           |
@@ -212,7 +241,7 @@ SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握
 - Host 文件错误只保留稳定 code 与 canonical 安全文案；原始 message、data、native path 和 credential 不会进入小程序。
 - `FileStat.size` 是非负 safe integer；`modifiedAt` / `createdAt` 若存在，单位为 Unix epoch milliseconds。
 - 仅当当前版本声明且平台已批准 `network` 时，`hb-sdk dev` 与 `hb-sdk remote deploy` 构建才会跳过平台 CSP；其他构建继续注入平台 CSP。`useOfficialDomain` 不参与 CSP 跳过判定。
-- 构建必须启用 `miniappManifest({ platforms })` 并显式声明实际承诺适配的平台，推荐统一使用 `hb-sdk build`。新项目模板中的 `['android', 'ios', 'ohos']` 只是初始配置，不代表已经完成真机验收。
+- 构建必须启用 `miniappManifest()`，并在 `package.json#heybox.platforms` 显式声明实际承诺适配的平台，推荐统一使用 `hb-sdk build`。新项目模板中的 `['android', 'ios', 'ohos']` 只是初始配置，不代表已经完成真机验收。
 
 私有 Page Channel 适配没有修改 `@heybox/hb-sdk` 公开 API 或 iframe wire；本次 files/download
 Runtime 能力随 `0.8.0-alpha.11` release family 发布，部署 detail 前必须保证

package/dist/cli-chunks/{build-kMLIWqWY.cjs → build-B5Sbi8Sq.cjs}

@@ -3,11 +3,11 @@
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-DdQtxdut.cjs');
-var runtimeGate = require('./runtime-gate-FseEYZze.cjs');
-var index = require('./index-Buner4kE.cjs');
-var projectVite = require('./project-vite-B-sK-qup.cjs');
-require('./version-TXwWxKvv.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-XAZFauvZ.cjs');
+var runtimeGate = require('./runtime-gate-BWb8QIcX.cjs');
+var index = require('./index-DCJN-V1y.cjs');
+var projectVite = require('./project-vite-DMxdOWsU.cjs');
+require('./version-BGzCIQhE.cjs');
 require('node:async_hooks');
 require('node:module');
 require('path');
@@ -28,6 +28,7 @@ async function runBuildCommand(_options = {}, runtime = {}) {
     const env = runtime.env ?? process.env;
     const mode = env.HB_SDK_ENV?.trim() || undefined;
     const skipPlatformCsp = runtimePermissionEnv.shouldSkipMiniappPlatformCspFromEnv(env);
+    const declaredPlatforms = runtimePermissionEnv.readMiniappPlatformsFromPackageJson(projectRoot);
     runtimePermissionEnv.readMiniappPermissionsFromPackageJson(projectRoot, runtimePermissionEnv.resolveMiniappSdkVersion());
     await fs.rm(distDir, { force: true, recursive: true });
     try {
@@ -46,7 +47,7 @@ async function runBuildCommand(_options = {}, runtime = {}) {
                     write: true,
                 },
             }), { successText: 'Vite 构建完成' });
-            const result = await validateBuildOutput(projectRoot, logger);
+            const result = await validateBuildOutput(projectRoot, logger, declaredPlatforms);
             logger.success(`构建完成: dist/ | manifest version ${result.version} | sdkVersion ${result.sdkVersion} | 待上传文件 ${result.fileCount} 个 | ${formatSize(result.totalBytes)}`);
             return result;
         }, env);
@@ -75,7 +76,7 @@ function createFixedBuildOutputPlugin(projectRoot) {
         },
     };
 }
-async function validateBuildOutput(projectRoot, logger) {
+async function validateBuildOutput(projectRoot, logger, declaredPlatforms) {
     const distDir = path.join(projectRoot, 'dist');
     const entryHtmlPath = path.join(distDir, 'index.html');
     const manifestPath = path.join(distDir, 'manifest.json');
@@ -89,11 +90,14 @@ async function validateBuildOutput(projectRoot, logger) {
     if (!runtimeGate.hasMiniappRuntimeGate(entryHtml)) {
         throw new Error('dist/index.html 缺少平台 Runtime 启动门禁，请在 Vite 配置中显式启用 miniappManifest()');
     }
-    const { manifest, hadBom } = runtimeGate.parseMiniappManifestJson(await fs.readFile(manifestPath, 'utf8'), 'dist/manifest.json');
+    const { manifest, hadBom } = runtimePermissionEnv.parseMiniappManifestJson(await fs.readFile(manifestPath, 'utf8'), 'dist/manifest.json');
     if (hadBom) {
         logger.warn('dist/manifest.json 包含 BOM，已自动剥离');
     }
-    const { platforms, sdkVersion, version, permissions } = runtimeGate.validateMiniappManifestForDeploy(manifest);
+    const { platforms, sdkVersion, version, permissions } = runtimePermissionEnv.validateMiniappManifestForDeploy(manifest);
+    if (!runtimePermissionEnv.areMiniappPlatformsEqual(platforms, declaredPlatforms)) {
+        throw new Error('dist/manifest.json.platforms 与 package.json#heybox.platforms 不一致，请重新 build');
+    }
     const allFiles = await walkDistFiles(distDir);
     const uploadFiles = allFiles.filter((file) => runtimePermissionEnv.shouldUploadDistFile(file.relativePath));
     const sizeError = runtimePermissionEnv.validateUploadTotalSize(uploadFiles);

package/dist/cli-chunks/{context-CzFFRcL4.cjs → context-DuxaBL3Y.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var runtimePermissionEnv = require('./runtime-permission-env-DdQtxdut.cjs');
-var session = require('./session-DHbw2Xgh.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-XAZFauvZ.cjs');
+var session = require('./session-BnoHxzFq.cjs');
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var path = require('node:path');

package/dist/cli-chunks/{create-0ow6gA9w.cjs → create-CIfZrg3F.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-Buner4kE.cjs');
+var index = require('./index-DCJN-V1y.cjs');
 require('node:module');
 require('os');
 require('readline');

package/dist/cli-chunks/{dev-CPBPdpyu.cjs → dev-CFubP5kW.cjs}

@@ -8,17 +8,17 @@ var node_crypto = require('node:crypto');
 var promises = require('node:dns/promises');
 var node_http = require('node:http');
 var node_module = require('node:module');
-var context = require('./context-CzFFRcL4.cjs');
-var runtimePermissionEnv = require('./runtime-permission-env-DdQtxdut.cjs');
+var context = require('./context-DuxaBL3Y.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-XAZFauvZ.cjs');
 var undici = require('undici');
 var fs$1 = require('node:fs/promises');
-var index = require('./index-Buner4kE.cjs');
+var index = require('./index-DCJN-V1y.cjs');
 var require$$0$1 = require('crypto');
 var require$$0 = require('buffer');
-var session = require('./session-DHbw2Xgh.cjs');
+var session = require('./session-BnoHxzFq.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var projectVite = require('./project-vite-B-sK-qup.cjs');
-var version = require('./version-TXwWxKvv.cjs');
+var projectVite = require('./project-vite-DMxdOWsU.cjs');
+var version = require('./version-BGzCIQhE.cjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 class Locked extends Error {
@@ -1851,8 +1851,8 @@ const DEFAULT_CHANNEL_TRANSPORT = {
 };
 const IPV4_LOOPBACK_ADDRESSES = new net.BlockList();
 IPV4_LOOPBACK_ADDRESSES.addSubnet('127.0.0.0', 8, 'ipv4');
-const { WebSocket, WebSocketServer } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-CPBPdpyu.cjs', document.baseURI).href)))('ws');
-const { parse: parseHtml } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-CPBPdpyu.cjs', document.baseURI).href)))('parse5');
+const { WebSocket, WebSocketServer } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-CFubP5kW.cjs', document.baseURI).href)))('ws');
+const { parse: parseHtml } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-CFubP5kW.cjs', document.baseURI).href)))('parse5');
 const BROWSER_DEV_HOST_ROOT_CANDIDATES = [
     path.resolve(__dirname, 'devtools/browser-dev-host'),
     path.resolve(__dirname, '../devtools/browser-dev-host'),
@@ -10902,7 +10902,7 @@ function assertNodeRuntimeCapabilities(ctx, settings) {
 function createNodeRealtimeDriverRegistry() {
     const registry = createRuntimeRealtimeDriverRegistry();
     registry.registerLazy('node-websocket', async () => {
-        const mod = await Promise.resolve().then(function () { return require('./index.esm-qwrdRuy-.cjs'); });
+        const mod = await Promise.resolve().then(function () { return require('./index.esm-8hgZlNF8.cjs'); });
         return mod.createNodeWebSocketRuntimeDriver();
     });
     return registry;
@@ -14991,6 +14991,7 @@ async function runDevCommand(options, runtime = {}) {
         port: appPort,
     };
     const projectRoot = projectVite.findProjectRoot(runtime.cwd ?? process.cwd());
+    runtimePermissionEnv.readMiniappPlatformsFromPackageJson(projectRoot);
     const { context: devLaunchContext, miniProgram } = await loadDevLaunchContext({
         env: runtime.env,
         fetchImpl,

package/dist/cli-chunks/{doctor-DQ8ctFKC.cjs → doctor-IPKn3PBn.cjs}

@@ -3,7 +3,7 @@
 var fs = require('node:fs/promises');
 var os = require('node:os');
 var path = require('node:path');
-var index = require('./index-Buner4kE.cjs');
+var index = require('./index-DCJN-V1y.cjs');
 require('node:module');
 require('node:fs');
 require('path');

package/dist/cli-chunks/{index-Buner4kE.cjs → index-DCJN-V1y.cjs}

@@ -234,19 +234,19 @@ function requireArgument () {
 
 var command = {};
 
-const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-Buner4kE.cjs', document.baseURI).href)));
+const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DCJN-V1y.cjs', document.baseURI).href)));
 function __require$4() { return require$5("node:events"); }
 
-const require$4 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-Buner4kE.cjs', document.baseURI).href)));
+const require$4 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DCJN-V1y.cjs', document.baseURI).href)));
 function __require$3() { return require$4("node:child_process"); }
 
-const require$3 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-Buner4kE.cjs', document.baseURI).href)));
+const require$3 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DCJN-V1y.cjs', document.baseURI).href)));
 function __require$2() { return require$3("node:path"); }
 
-const require$2 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-Buner4kE.cjs', document.baseURI).href)));
+const require$2 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DCJN-V1y.cjs', document.baseURI).href)));
 function __require$1() { return require$2("node:fs"); }
 
-const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-Buner4kE.cjs', document.baseURI).href)));
+const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DCJN-V1y.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -13353,7 +13353,7 @@ function getPathname(pathWithQuery) {
 }
 
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.8.1-alpha.1';
+const BUILT_CLI_VERSION = '0.8.1-alpha.3';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -13701,39 +13701,39 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-DoduAO_f.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-CoB9jXxC.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-DoduAO_f.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-CoB9jXxC.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-DoduAO_f.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-CoB9jXxC.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunBuildCommand = async (...args) => {
-    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-kMLIWqWY.cjs'); });
+    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-B5Sbi8Sq.cjs'); });
     return runBuildCommand(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-0ow6gA9w.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-CIfZrg3F.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-CPBPdpyu.cjs'); }).then(function (n) { return n.dev; });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-CFubP5kW.cjs'); }).then(function (n) { return n.dev; });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-DQ8ctFKC.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-IPKn3PBn.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunSkillInstallCommand = async (...args) => {
-    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-6IVv12JW.cjs'); });
+    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-CDEJtATn.cjs'); });
     return runSkillInstallCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-CF_SRmnj.cjs'); });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-D4ZcngLn.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {

package/dist/cli-chunks/{index-RDcIrvwi.cjs → index-KHhdZ8eZ.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var index$2 = require('./index-Buner4kE.cjs');
+var index$2 = require('./index-DCJN-V1y.cjs');
 var require$$0$3 = require('fs');
 var require$$0$2 = require('crypto');
 var require$$1$2 = require('path');
 var require$$0$5 = require('assert');
 var require$$0$4 = require('events');
 var require$$1$1 = require('util');
-var runtimePermissionEnv = require('./runtime-permission-env-DdQtxdut.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-XAZFauvZ.cjs');
 var require$$0$7 = require('net');
 var require$$0$6 = require('url');
 var require$$2$1 = require('http');

package/dist/cli-chunks/{index.esm-qwrdRuy-.cjs → index.esm-8hgZlNF8.cjs}

@@ -11,8 +11,8 @@ var require$$0$4 = require('url');
 var require$$0 = require('zlib');
 var require$$0$1 = require('buffer');
 var require$$1 = require('util');
-var index = require('./index-Buner4kE.cjs');
-var dev = require('./dev-CPBPdpyu.cjs');
+var index = require('./index-DCJN-V1y.cjs');
+var dev = require('./dev-CFubP5kW.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');
@@ -27,11 +27,11 @@ require('node:net');
 require('node:crypto');
 require('node:dns/promises');
 require('node:http');
-require('./context-CzFFRcL4.cjs');
-require('./runtime-permission-env-DdQtxdut.cjs');
-require('./version-TXwWxKvv.cjs');
+require('./context-DuxaBL3Y.cjs');
+require('./runtime-permission-env-XAZFauvZ.cjs');
+require('./version-BGzCIQhE.cjs');
 require('node:async_hooks');
-require('./session-DHbw2Xgh.cjs');
+require('./session-BnoHxzFq.cjs');
 require('fs');
 require('constants');
 require('undici');
@@ -41,7 +41,7 @@ require('node:buffer');
 require('node:url');
 require('node:util');
 require('node:child_process');
-require('./project-vite-B-sK-qup.cjs');
+require('./project-vite-DMxdOWsU.cjs');
 
 var bufferUtil = {exports: {}};
 

package/dist/cli-chunks/{login-DoduAO_f.cjs → login-CoB9jXxC.cjs}

@@ -3,9 +3,9 @@
 var promises = require('node:readline/promises');
 var node_crypto = require('node:crypto');
 var node_http = require('node:http');
-var session = require('./session-DHbw2Xgh.cjs');
+var session = require('./session-BnoHxzFq.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-Buner4kE.cjs');
+var index = require('./index-DCJN-V1y.cjs');
 require('node:path');
 require('fs');
 require('constants');

package/dist/cli-chunks/{project-vite-B-sK-qup.cjs → project-vite-DMxdOWsU.cjs}

@@ -5,7 +5,7 @@ var fs$1 = require('node:fs/promises');
 var node_module = require('node:module');
 var path = require('node:path');
 var node_url = require('node:url');
-var index = require('./index-Buner4kE.cjs');
+var index = require('./index-DCJN-V1y.cjs');
 
 function findProjectRoot(startDir) {
     let current = path.resolve(startDir);

package/dist/cli-chunks/{remote-CF_SRmnj.cjs → remote-D4ZcngLn.cjs}

@@ -1,16 +1,16 @@
 'use strict';
 
 var promises = require('node:readline/promises');
-var index = require('./index-Buner4kE.cjs');
-var session = require('./session-DHbw2Xgh.cjs');
+var index = require('./index-DCJN-V1y.cjs');
+var session = require('./session-BnoHxzFq.cjs');
 var childProcess = require('node:child_process');
 var fs = require('node:fs');
 var fs$1 = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-DdQtxdut.cjs');
-var runtimeGate = require('./runtime-gate-FseEYZze.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-XAZFauvZ.cjs');
 var node_crypto = require('node:crypto');
-var context = require('./context-CzFFRcL4.cjs');
+var runtimeGate = require('./runtime-gate-BWb8QIcX.cjs');
+var context = require('./context-DuxaBL3Y.cjs');
 require('node:module');
 require('path');
 require('os');
@@ -23,7 +23,7 @@ require('buffer');
 require('util');
 require('fs');
 require('constants');
-require('./version-TXwWxKvv.cjs');
+require('./version-BGzCIQhE.cjs');
 require('node:async_hooks');
 
 async function getCDNUploadInfo(options, runtime = {}) {
@@ -272,7 +272,7 @@ function createDefaultCosClient(uploadToken, COS) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-RDcIrvwi.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-KHhdZ8eZ.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {
@@ -509,6 +509,7 @@ async function runDeployCommand(options, runtime = {}) {
         throw new Error('未在 package.json 中找到 heybox.miniProgramId，请先配置 mini program id');
     }
     const fromVersion = options.fromVersion?.trim();
+    const declaredPlatforms = fromVersion ? undefined : runtimePermissionEnv.readMiniappPlatformsFromPackageJson(projectRoot);
     const releaseNote = await resolveDeployReleaseNote(options, runtime);
     const session$1 = await logger.task('正在校验 Heybox 登录态', () => (runtime.requireAuthSession ?? session.requireHeyboxAuthSession)({ loginBaseUrl }), { successText: 'Heybox 登录态有效' });
     logger.debug(`Heybox API: ${apiBaseUrl}`);
@@ -583,6 +584,9 @@ async function runDeployCommand(options, runtime = {}) {
             const distDir = path.join(projectRoot, 'dist');
             const parsedManifest = await readDeployManifest(projectRoot, logger);
             ({ manifest, version } = parsedManifest);
+            if (!declaredPlatforms || !runtimePermissionEnv.areMiniappPlatformsEqual(parsedManifest.platforms, declaredPlatforms)) {
+                throw new Error('dist/manifest.json.platforms 与 package.json#heybox.platforms 不一致，请重新 build 后再 deploy');
+            }
             if (version !== precheckVersion) {
                 throw new Error(`dist/manifest.json.version (${version}) 与预检版本 (${precheckVersion}) 不一致，请重新 build 后再 deploy`);
             }
@@ -734,11 +738,11 @@ async function readDeployManifest(projectRoot, logger) {
     if (!runtimeGate.hasMiniappRuntimeGate(entryHtml)) {
         throw new Error('dist/index.html 缺少平台 Runtime 启动门禁，请在 Vite 配置中启用 miniappManifest() 后重新 build');
     }
-    const { manifest, hadBom } = runtimeGate.parseMiniappManifestJson(await fs$1.readFile(manifestPath, 'utf8'), 'dist/manifest.json');
+    const { manifest, hadBom } = runtimePermissionEnv.parseMiniappManifestJson(await fs$1.readFile(manifestPath, 'utf8'), 'dist/manifest.json');
     if (hadBom) {
         logger.warn('dist/manifest.json 包含 BOM，已自动剥离');
     }
-    const validated = runtimeGate.validateMiniappManifestForDeploy(manifest);
+    const validated = runtimePermissionEnv.validateMiniappManifestForDeploy(manifest);
     return {
         manifest: { ...manifest, platforms: validated.platforms },
         sdkVersion: validated.sdkVersion,
@@ -747,7 +751,7 @@ async function readDeployManifest(projectRoot, logger) {
     };
 }
 function validateVersionForDeploy(version, sourceLabel) {
-    if (typeof version !== 'string' || !runtimeGate.isValidMiniappManifestVersion(version)) {
+    if (typeof version !== 'string' || !runtimePermissionEnv.isValidMiniappManifestVersion(version)) {
         throw new Error(`${sourceLabel} 必须是合法 SemVer，允许 prerelease，不允许 build metadata 和 0.0.0：${String(version)}`);
     }
     return version.trim();

package/dist/cli-chunks/{runtime-gate-FseEYZze.cjs → runtime-gate-BWb8QIcX.cjs}

@@ -1,109 +1,5 @@
 'use strict';
 
-var runtimePermissionEnv = require('./runtime-permission-env-DdQtxdut.cjs');
-
-const MINIAPP_PLATFORM_VALUES = ['android', 'ios', 'ohos', 'windows', 'macos', 'linux'];
-function isValidMiniappManifestVersion(version) {
-    return getMiniappManifestVersionError(version) === undefined;
-}
-function validateMiniappManifestVersion(version, sourceLabel = 'manifest.version') {
-    const error = getMiniappManifestVersionError(version);
-    if (error) {
-        throw new Error(`${sourceLabel} ${error}`);
-    }
-    return String(version).trim();
-}
-function parseMiniappManifestJson(raw, sourceLabel = 'manifest.json') {
-    const hadBom = raw.charCodeAt(0) === 0xfeff;
-    const text = hadBom ? raw.slice(1) : raw;
-    let parsed;
-    try {
-        parsed = JSON.parse(text);
-    }
-    catch (error) {
-        throw new Error(`${sourceLabel} 不是合法 JSON：${formatReason(error)}`);
-    }
-    if (!isManifestRecord(parsed)) {
-        throw new Error(`${sourceLabel} 必须是 JSON 对象`);
-    }
-    return {
-        manifest: parsed,
-        hadBom,
-    };
-}
-function validateMiniappManifestForDeploy(manifest) {
-    const version = validateMiniappManifestVersion(manifest.version, 'manifest.version');
-    const sdkVersion = validateSdkVersion(manifest.sdkVersion, 'manifest.sdkVersion');
-    const permissions = runtimePermissionEnv.parseMiniappPermissions(manifest.permissions, {
-        present: Object.prototype.hasOwnProperty.call(manifest, 'permissions'),
-        sdkVersion,
-        sourceLabel: 'manifest.permissions',
-    });
-    return {
-        version,
-        sdkVersion,
-        platforms: validateMiniappPlatforms(manifest.platforms, 'manifest.platforms'),
-        ...(permissions.permissions === undefined ? {} : { permissions: permissions.permissions }),
-    };
-}
-function validateMiniappPlatforms(platforms, sourceLabel = 'platforms') {
-    if (!Array.isArray(platforms) || platforms.length === 0) {
-        throw new Error(`${sourceLabel} 必须是非空平台数组`);
-    }
-    const allowedPlatforms = new Set(MINIAPP_PLATFORM_VALUES);
-    const seen = new Set();
-    for (const platform of platforms) {
-        if (typeof platform !== 'string' || !allowedPlatforms.has(platform)) {
-            throw new Error(`${sourceLabel} 包含不支持的平台：${String(platform)}`);
-        }
-        if (seen.has(platform)) {
-            throw new Error(`${sourceLabel} 包含重复平台：${platform}`);
-        }
-        seen.add(platform);
-    }
-    return Object.freeze(MINIAPP_PLATFORM_VALUES.filter((platform) => seen.has(platform)));
-}
-function validateSdkVersion(version, sourceLabel = 'sdkVersion') {
-    if (typeof version !== 'string' || version.trim() === '') {
-        throw new Error(`${sourceLabel} 必须是合法 SemVer：${String(version)}`);
-    }
-    const normalized = version.trim();
-    const parsed = runtimePermissionEnv.semverExports.parse(normalized);
-    if (!parsed || parsed.version !== normalized || parsed.build.length > 0) {
-        throw new Error(`${sourceLabel} 必须是合法 SemVer：${normalized}`);
-    }
-    return normalized;
-}
-function isManifestRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function getMiniappManifestVersionError(version) {
-    if (typeof version !== 'string' || version.trim() === '') {
-        return `必须是合法 SemVer：${String(version)}`;
-    }
-    const normalized = version.trim();
-    const parsed = runtimePermissionEnv.semverExports.parse(normalized);
-    if (!parsed) {
-        return `必须是合法 SemVer：${normalized}`;
-    }
-    if (parsed.build.length > 0) {
-        return `不能包含 build metadata：${normalized}`;
-    }
-    if (parsed.version !== normalized) {
-        return `必须是合法 SemVer：${normalized}`;
-    }
-    if (parsed.major === 0 && parsed.minor === 0 && parsed.patch === 0) {
-        return '不能是模板默认版本 0.0.0';
-    }
-    return undefined;
-}
-function formatReason(error) {
-    if (error instanceof Error && error.message) {
-        return error.message;
-    }
-    return String(error);
-}
-
 const UNDEFINED_CODE_POINTS = new Set([
     65534, 65535, 131070, 131071, 196606, 196607, 262142, 262143, 327678, 327679, 393214,
     393215, 458750, 458751, 524286, 524287, 589822, 589823, 655358, 655359, 720894,
@@ -8390,6 +8286,3 @@ function walk(node, visit) {
 }
 
 exports.hasMiniappRuntimeGate = hasMiniappRuntimeGate;
-exports.isValidMiniappManifestVersion = isValidMiniappManifestVersion;
-exports.parseMiniappManifestJson = parseMiniappManifestJson;
-exports.validateMiniappManifestForDeploy = validateMiniappManifestForDeploy;