@heybox/hb-sdk 0.4.0 → 0.4.2

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

package/dist/cli-chunks/{deploy-CknDDoS_.cjs → deploy-71Eb_W7K.cjs}

@@ -5,8 +5,8 @@ var fs = require('node:fs');
 var fs$1 = require('node:fs/promises');
 var path = require('node:path');
 var promises = require('node:readline/promises');
-var session = require('./session-CMBN3o9z.cjs');
-var index = require('./index-io4h3kr-.cjs');
+var session = require('./session-DNG8Q6Ni.cjs');
+var index = require('./index-p5XZBWaZ.cjs');
 var node_crypto = require('node:crypto');
 
 var re = {exports: {}};
@@ -3328,7 +3328,7 @@ async function createDefaultCosClient(uploadToken) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-yjJgBEBF.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-X-XUt2Ei.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {

package/dist/cli-chunks/{dev-BS9h09yG.cjs → dev-B_HCfuH4.cjs}

@@ -9,7 +9,7 @@ var node_url = require('node:url');
 var net = require('node:net');
 var node_http = require('node:http');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-io4h3kr-.cjs');
+var index = require('./index-p5XZBWaZ.cjs');
 require('node:process');
 require('node:buffer');
 require('node:util');
@@ -186,6 +186,21 @@ async function getPorts(options) {
 	throw new Error('No available ports found');
 }
 
+async function selectAvailablePort(options) {
+    const maxAttempts = options.maxAttempts ?? 20;
+    const port = await options.getPort({
+        host: options.host,
+        port: createPortCandidates(options.startPort, maxAttempts),
+    });
+    if (port < options.startPort || port >= options.startPort + maxAttempts) {
+        throw new Error(`无法找到可用 ${options.label} 端口，起始端口: ${options.startPort}`);
+    }
+    return port;
+}
+function createPortCandidates(startPort, count) {
+    return Array.from({ length: count }, (_, index) => startPort + index);
+}
+
 const MINI_PROGRAM_URL_QUERY_PARAM$1 = 'mini_url';
 const LAN_ADDRESSES_PATH = '/__hb_sdk_lan_addresses__';
 const MOCK_NETWORK_PROXY_PATH = '/__hb_sdk_mock_network__';
@@ -536,14 +551,12 @@ function readContentType(filePath) {
     return 'application/octet-stream';
 }
 async function listenHttpServer(server, options, getPortImpl) {
-    const maxAttempts = 20;
-    const port = await getPortImpl({
+    const port = await selectAvailablePort({
+        getPort: getPortImpl,
         host: DEV_LISTEN_HOST$1,
-        port: createPortCandidates(options.port, maxAttempts),
+        label: 'mock host',
+        startPort: options.port,
     });
-    if (port < options.port || port >= options.port + maxAttempts) {
-        throw new Error(`无法找到可用 mock host 端口，起始端口: ${options.port}`);
-    }
     await new Promise((resolve, reject) => {
         const onError = (error) => {
             server.off('listening', onListening);
@@ -560,9 +573,6 @@ async function listenHttpServer(server, options, getPortImpl) {
     const address = server.address();
     return address.port;
 }
-function createPortCandidates(startPort, count) {
-    return Array.from({ length: count }, (_, index) => startPort + index);
-}
 function readErrorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }
@@ -628,18 +638,30 @@ async function runDevCommand(options, runtime = {}) {
     const logger = runtime.logger ?? index.createCliLogger();
     const fetchImpl = runtime.fetchImpl ?? fetch;
     const openUrl = runtime.openExternalUrl ?? browser.openExternalUrl;
+    const networkInterfaceSnapshot = (runtime.networkInterfaces ?? os.networkInterfaces)();
+    const getPortImpl = runtime.getPort ?? getPorts;
+    const appPort = await selectAvailablePort({
+        getPort: getPortImpl,
+        host: DEV_LISTEN_HOST,
+        label: 'Vite dev server',
+        startPort: options.port ?? DEFAULT_APP_PORT,
+    });
+    const resolvedOptions = {
+        ...options,
+        port: appPort,
+    };
     const projectRoot = findProjectRoot(runtime.cwd ?? process.cwd());
     const vite = await logger.task('正在加载项目 Vite', () => loadProjectVite(projectRoot), { successText: '已加载项目 Vite' });
-    const appServer = await logger.task('正在创建 Vite dev server', () => withManagedDevOutputEnv(() => vite.createServer(createViteServerOptions(projectRoot, options)), runtime.env), { successText: '已创建 Vite dev server' });
-    await logger.task('正在启动 Vite dev server', () => appServer.listen(options.port ?? DEFAULT_APP_PORT), {
+    const appServer = await logger.task('正在创建 Vite dev server', () => withManagedDevOutputEnv(() => vite.createServer(createViteServerOptions(projectRoot, resolvedOptions)), runtime.env), { successText: '已创建 Vite dev server' });
+    await logger.task('正在启动 Vite dev server', () => appServer.listen(appPort), {
         successText: 'Vite dev server 已启动',
     });
-    const appUrl = await logger.task('正在探测小程序入口', () => resolveViteAppUrl(appServer, options, fetchImpl), {
+    const appUrl = await logger.task('正在探测小程序入口', () => resolveViteAppUrl(appServer, resolvedOptions, fetchImpl), {
         successText: '已确定小程序入口',
     });
     const lanAddresses = createLanAddressCandidates({
         appUrl,
-        interfaces: (runtime.networkInterfaces ?? os.networkInterfaces)(),
+        interfaces: networkInterfaceSnapshot,
         runtimeUrl: options.runtimeUrl,
         viteNetworkUrls: appServer.resolvedUrls?.network ?? [],
     });
@@ -649,7 +671,7 @@ async function runDevCommand(options, runtime = {}) {
         mockHost = await logger.task('正在启动 Mock runtime host', () => startMiniProgramMockHostServer({
             appUrl,
             fetchImpl,
-            getPort: runtime.getPort ?? getPorts,
+            getPort: getPortImpl,
             defaultLanAddressId: lanAddresses[0]?.id,
             lanAddresses,
             macAppProtocol: createMacAppProtocol(appUrl, { runtimeUrl: options.runtimeUrl }),
@@ -711,9 +733,12 @@ function createViteServerOptions(projectRoot, options) {
     const configFile = resolveProjectViteConfig(projectRoot);
     const server = {
         cors: true,
+        hmr: {
+            clientPort: options.port ?? DEFAULT_APP_PORT,
+        },
         host: DEV_LISTEN_HOST,
         port: options.port ?? DEFAULT_APP_PORT,
-        strictPort: false,
+        strictPort: true,
     };
     if (configFile) {
         return {
@@ -856,24 +881,19 @@ function createLanAddressCandidates(options) {
     const viteNetworkUrlByHost = new Map(options.viteNetworkUrls
         .map((url) => [readUrlHost(url), url])
         .filter((entry) => Boolean(entry[0])));
-    const candidates = Object.entries(options.interfaces)
-        .flatMap(([name, infos]) => (infos ?? []).map((info) => ({
-        info,
-        name,
-    })))
-        .filter(({ info }) => info.family === 'IPv4' && !info.internal && isPrivateIPv4(info.address))
-        .map(({ info, name }) => {
-        const appUrl = viteNetworkUrlByHost.get(info.address) ?? replaceUrlHost(options.appUrl, info.address);
+    const candidates = createLanInterfaceCandidates(options.interfaces)
+        .map(({ address, id, name }) => {
+        const appUrl = viteNetworkUrlByHost.get(address) ?? replaceUrlHost(options.appUrl, address);
         if (!appUrl) {
             return undefined;
         }
         const candidate = {
-            address: info.address,
+            address,
             appUrl,
-            id: `${name}-${info.address}`,
+            id,
             name,
         };
-        const runtimeUrl = rewriteLoopbackUrlHost(options.runtimeUrl, info.address);
+        const runtimeUrl = rewriteLoopbackUrlHost(options.runtimeUrl, address);
         if (runtimeUrl !== undefined) {
             candidate.mobileAppQrPayload = createMobileAppQrPayload(appUrl, { runtimeUrl });
         }
@@ -892,6 +912,22 @@ function createLanAddressCandidates(options) {
         return readInterfacePriority(left.name) - readInterfacePriority(right.name) || left.name.localeCompare(right.name);
     });
 }
+function createLanInterfaceCandidates(interfaces) {
+    return Object.entries(interfaces)
+        .flatMap(([name, infos]) => (infos ?? []).map((info) => ({
+        info,
+        name,
+    })))
+        .filter(({ info }) => info.family === 'IPv4' && !info.internal && isPrivateIPv4(info.address))
+        .map(({ info, name }) => ({
+        address: info.address,
+        id: `${name}-${info.address}`,
+        name,
+    }))
+        .sort((left, right) => {
+        return readInterfacePriority(left.name) - readInterfacePriority(right.name) || left.name.localeCompare(right.name);
+    });
+}
 function rewriteLoopbackUrlHost(input, host) {
     if (input === undefined || input === '') {
         return undefined;

package/dist/cli-chunks/{doctor-WTl1HCW0.cjs → doctor-B_UT0kAa.cjs}

@@ -4,7 +4,7 @@ var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var os = require('node:os');
 var path = require('node:path');
-var index = require('./index-io4h3kr-.cjs');
+var index = require('./index-p5XZBWaZ.cjs');
 require('node:module');
 require('path');
 require('os');

package/dist/cli-chunks/{index-yjJgBEBF.cjs → index-X-XUt2Ei.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var index$2 = require('./index-io4h3kr-.cjs');
+var index$2 = require('./index-p5XZBWaZ.cjs');
 var require$$0$2 = require('fs');
 var require$$2$1 = require('crypto');
 var require$$1$2 = require('path');
 var require$$0$3 = require('assert');
 var require$$4$2 = require('events');
 var require$$1$1 = require('util');
-var deploy = require('./deploy-CknDDoS_.cjs');
+var deploy = require('./deploy-71Eb_W7K.cjs');
 var require$$0$5 = require('net');
 var require$$0$4 = require('url');
 var require$$2$2 = require('http');

package/dist/cli-chunks/{index-io4h3kr-.cjs → index-p5XZBWaZ.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-io4h3kr-.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-p5XZBWaZ.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-io4h3kr-.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-p5XZBWaZ.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-io4h3kr-.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-p5XZBWaZ.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-io4h3kr-.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-p5XZBWaZ.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-io4h3kr-.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-p5XZBWaZ.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -13092,7 +13092,7 @@ function readErrorMessage(error, options = {}) {
 }
 
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.4.0';
+const BUILT_CLI_VERSION = '0.4.2';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -13249,31 +13249,31 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-B-A53Sta.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-COcBbeEc.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-B-A53Sta.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-COcBbeEc.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-B-A53Sta.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-COcBbeEc.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-D1j9UnM7.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-CPI9SgG3.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDeployCommand = async (...args) => {
-    const { runDeployCommand } = await Promise.resolve().then(function () { return require('./deploy-CknDDoS_.cjs'); }).then(function (n) { return n.deploy; });
+    const { runDeployCommand } = await Promise.resolve().then(function () { return require('./deploy-71Eb_W7K.cjs'); }).then(function (n) { return n.deploy; });
     return runDeployCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-BS9h09yG.cjs'); });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-B_HCfuH4.cjs'); });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-WTl1HCW0.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-B_UT0kAa.cjs'); });
     return runDoctorCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {

package/dist/cli-chunks/{login-B-A53Sta.cjs → login-COcBbeEc.cjs}

@@ -2,9 +2,9 @@
 
 var node_crypto = require('node:crypto');
 var node_http = require('node:http');
-var session = require('./session-CMBN3o9z.cjs');
+var session = require('./session-DNG8Q6Ni.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-io4h3kr-.cjs');
+var index = require('./index-p5XZBWaZ.cjs');
 require('node:path');
 require('fs');
 require('constants');

package/dist/cli-chunks/{session-CMBN3o9z.cjs → session-DNG8Q6Ni.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var path = require('node:path');
-var index = require('./index-io4h3kr-.cjs');
+var index = require('./index-p5XZBWaZ.cjs');
 var require$$0$2 = require('fs');
 var require$$0 = require('constants');
 var require$$0$1 = require('stream');

package/dist/cli.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./cli-chunks/index-io4h3kr-.cjs');
+var index = require('./cli-chunks/index-p5XZBWaZ.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');

package/dist/templates/vue3-vite-ts/README.md.ejs

@@ -13,6 +13,10 @@ npm run build
 npm run deploy
 ```
 
+## 依赖说明
+
+`@heybox/hb-sdk` 是小程序页面运行时会 import 的 SDK，因此模板把它放在 `dependencies`。Vite、TypeScript、Vitest 等只参与本地开发、测试或构建的工具放在 `devDependencies`。
+
 ## 开发模式
 
 - `npm run dev`：启动本地 Vite 服务和 `hb-sdk` 内置 mock runtime host，适合本地调试 SDK 能力；调试页内可点击按钮在 Mac 版 APP 中启动同一页面，也可以选择局域网网卡后用手机小黑盒 APP 扫码调试。手机需要与电脑处在同一局域网，并使用支持小程序调试壳的新版小黑盒 APP。Codex、VSCode 等内嵌浏览器可能无法唤起系统 APP，需要时请在系统浏览器中打开同一个调试页后重试。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "",
   "exports": {
     ".": {

package/skill/references/api-root.md

@@ -19,7 +19,7 @@
 ## Package metadata
 
 - Package: `@heybox/hb-sdk`
-- Version at generation time: `0.4.0`
+- Version at generation time: `0.4.2`
 - Public root export: `@heybox/hb-sdk`
 - Protocol export: `@heybox/hb-sdk/protocol`
 - Vite plugin export: `@heybox/hb-sdk/vite`

package/skill/references/cli.md

@@ -577,6 +577,10 @@ npm run build
 npm run deploy
 ```
 
+## 依赖说明
+
+`@heybox/hb-sdk` 是小程序页面运行时会 import 的 SDK，因此模板把它放在 `dependencies`。Vite、TypeScript、Vitest 等只参与本地开发、测试或构建的工具放在 `devDependencies`。
+
 ## 开发模式
 
 - `npm run dev`：启动本地 Vite 服务和 `hb-sdk` 内置 mock runtime host，适合本地调试 SDK 能力；调试页内可点击按钮在 Mac 版 APP 中启动同一页面，也可以选择局域网网卡后用手机小黑盒 APP 扫码调试。手机需要与电脑处在同一局域网，并使用支持小程序调试壳的新版小黑盒 APP。Codex、VSCode 等内嵌浏览器可能无法唤起系统 APP，需要时请在系统浏览器中打开同一个调试页后重试。

package/skill/skill.json

@@ -1,11 +1,11 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.4.0+skill.6e13c65735d8",
+  "skillVersion": "0.4.2+skill.fc5802b13fbb",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.4.0",
-    "compatibility": "0.4.0"
+    "version": "0.4.2",
+    "compatibility": "0.4.2"
   },
   "source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
-  "integrity": "sha256-6e13c65735d8de3ac9c9dd48b16412b93e3497038d0582b5eed05355dc3397bd"
+  "integrity": "sha256-fc5802b13fbbfc70964dc56c9cc5d5888e2bed739ed38fbe17555a418e8a744d"
 }