@heybox/hb-sdk 0.5.16 → 0.5.18

package/dist/cli-chunks/{index-B-lA2GE7.cjs → index-CsOcGUzF.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-B-lA2GE7.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-CsOcGUzF.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-B-lA2GE7.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-CsOcGUzF.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-B-lA2GE7.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-CsOcGUzF.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-B-lA2GE7.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-CsOcGUzF.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-B-lA2GE7.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-CsOcGUzF.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -13068,10 +13068,12 @@ async function pathExists$1(filePath) {
 }
 
 class CliError extends Error {
+    httpStatus;
     verboseMessage;
-    constructor(message, verboseMessage) {
+    constructor(message, verboseMessage, options = {}) {
         super(message);
         this.name = 'CliError';
+        this.httpStatus = options.httpStatus;
         this.verboseMessage = verboseMessage;
     }
 }
@@ -13093,8 +13095,228 @@ function readErrorMessage(error, options = {}) {
     return String(error);
 }
 
+/**
+ * 极简 .env 文件解析器。
+ *
+ * 只支持 hb-sdk CLI 需要的最小语义：KEY=VALUE、空行、`#` 注释、单/双引号包裹值。
+ * 不做变量插值，不展开 shell 转义，避免引入额外依赖。
+ */
+/**
+ * 解析 .env 文件内容为 key/value 记录，保持原始出现顺序的 key 列表。
+ */
+function parseDotenvFile(content) {
+    const entries = {};
+    const keys = [];
+    for (const rawLine of content.split(/\r?\n/)) {
+        const line = stripInlineComment(rawLine).trim();
+        if (!line || line.startsWith('#')) {
+            continue;
+        }
+        const equalsIndex = line.indexOf('=');
+        if (equalsIndex <= 0) {
+            continue;
+        }
+        const key = line.slice(0, equalsIndex).trim();
+        if (!isValidEnvKey(key)) {
+            continue;
+        }
+        const rawValue = line.slice(equalsIndex + 1).trim();
+        const value = unquoteDotenvValue(rawValue);
+        if (!Object.prototype.hasOwnProperty.call(entries, key)) {
+            keys.push(key);
+        }
+        entries[key] = value;
+    }
+    return { entries, keys };
+}
+function stripInlineComment(line) {
+    // 仅处理未被引号包裹的行内注释，避免误伤值里的 #。
+    let inSingle = false;
+    let inDouble = false;
+    for (let i = 0; i < line.length; i += 1) {
+        const char = line[i];
+        if (char === "'" && !inDouble) {
+            inSingle = !inSingle;
+        }
+        else if (char === '"' && !inSingle) {
+            inDouble = !inDouble;
+        }
+        else if (char === '#' && !inSingle && !inDouble) {
+            return line.slice(0, i);
+        }
+    }
+    return line;
+}
+function unquoteDotenvValue(value) {
+    if (value.length >= 2) {
+        const first = value[0];
+        const last = value[value.length - 1];
+        if (first === '"' && last === '"') {
+            return value.slice(1, -1).replace(/\\(["\\$])/g, '$1');
+        }
+        if (first === "'" && last === "'") {
+            return value.slice(1, -1);
+        }
+    }
+    return value;
+}
+function isValidEnvKey(key) {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(key);
+}
+
+const DEFAULT_READ_FILE = (path) => fs$1.readFileSync(path, 'utf8');
+function resolveEnvPresetFilePath(argv, env = process.env, cwd = process.cwd()) {
+    const explicit = readEnvFileArgFromArgv(argv);
+    if (explicit) {
+        return path.resolve(cwd, explicit);
+    }
+    const name = readEnvNameArgFromArgv(argv) ?? env.HB_SDK_ENV;
+    if (name) {
+        return path.resolve(cwd, `.env.${name}`);
+    }
+    return undefined;
+}
+function loadEnvPreset(argv, options = {}) {
+    const targetEnv = options.env ?? process.env;
+    const cwd = options.cwd ?? process.cwd();
+    const readFile = options.readFile ?? DEFAULT_READ_FILE;
+    const filePath = resolveEnvPresetFilePath(argv, targetEnv, cwd);
+    if (!filePath) {
+        return { filePath: undefined, appliedKeys: [], skippedKeys: [] };
+    }
+    let content;
+    try {
+        content = readFile(filePath);
+    }
+    catch {
+        // 文件不存在或不可读时静默跳过，与 dotenv 默认行为一致。
+        return { filePath, appliedKeys: [], skippedKeys: [] };
+    }
+    const { entries } = parseDotenvFile(content);
+    const appliedKeys = [];
+    const skippedKeys = [];
+    for (const [key, value] of Object.entries(entries)) {
+        if (targetEnv[key] !== undefined && targetEnv[key] !== '') {
+            skippedKeys.push(key);
+            continue;
+        }
+        targetEnv[key] = value;
+        appliedKeys.push(key);
+    }
+    return { filePath, appliedKeys, skippedKeys };
+}
+/**
+ * 从 argv 中提取 `--env-file <path>` 的值。
+ * 支持 `--env-file path`、`--env-file=path` 两种写法。
+ */
+function readEnvFileArgFromArgv(argv) {
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === '--env-file') {
+            return argv[i + 1];
+        }
+        if (arg?.startsWith('--env-file=')) {
+            return arg.slice('--env-file='.length);
+        }
+    }
+    return undefined;
+}
+/**
+ * 从 argv 中提取 `--env <name>` 的值。
+ * 支持 `--env name`、`--env=name` 两种写法。
+ */
+function readEnvNameArgFromArgv(argv) {
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === '--env') {
+            return argv[i + 1];
+        }
+        if (arg?.startsWith('--env=')) {
+            return arg.slice('--env='.length);
+        }
+    }
+    return undefined;
+}
+
+const globalHeyboxCliRequestConfig = {};
+function configureHeyboxCliRequestConfig(config) {
+    const normalized = normalizeHeyboxRylaiServiceTagConfig(config);
+    if (normalized.default_tag) {
+        globalHeyboxCliRequestConfig.default_tag = normalized.default_tag;
+    }
+    else {
+        delete globalHeyboxCliRequestConfig.default_tag;
+    }
+    if (normalized.special_tag) {
+        globalHeyboxCliRequestConfig.special_tag = normalized.special_tag;
+    }
+    else {
+        delete globalHeyboxCliRequestConfig.special_tag;
+    }
+}
+function readHeyboxCliRequestConfig() {
+    return normalizeHeyboxRylaiServiceTagConfig(globalHeyboxCliRequestConfig);
+}
+/**
+ * 当 tag 为非空字符串时，把它设为 CLI 全局 default_tag；为空时不改动现有配置，
+ * 避免清掉 env 预设阶段已注入的值。
+ */
+function applyServiceTagIfNeeded(tag) {
+    const normalized = normalizeHeyboxRylaiServiceTag(tag);
+    if (!normalized) {
+        return;
+    }
+    configureHeyboxCliRequestConfig({ default_tag: normalized });
+}
+function resolveHeyboxRylaiServiceTag(pathWithQuery, config = readHeyboxCliRequestConfig()) {
+    const normalized = normalizeHeyboxRylaiServiceTagConfig(config);
+    const pathname = pathWithQuery ? getPathname(pathWithQuery) : '';
+    const specialTag = normalized.special_tag;
+    if (pathname && specialTag?.path_prefix_list.some((prefix) => pathname.startsWith(prefix))) {
+        return specialTag.tag_name;
+    }
+    return normalized.default_tag;
+}
+function normalizeHeyboxRylaiServiceTagConfig(config) {
+    const defaultTag = normalizeHeyboxRylaiServiceTag(config.default_tag);
+    const specialTagName = normalizeHeyboxRylaiServiceTag(config.special_tag?.tag_name);
+    const pathPrefixList = config.special_tag?.path_prefix_list?.filter(isValidPathPrefix) || [];
+    return {
+        ...(defaultTag ? { default_tag: defaultTag } : {}),
+        ...(specialTagName && pathPrefixList.length
+            ? {
+                special_tag: {
+                    tag_name: specialTagName,
+                    path_prefix_list: pathPrefixList,
+                },
+            }
+            : {}),
+    };
+}
+function normalizeHeyboxRylaiServiceTag(value) {
+    const tag = String(value ?? '').trim();
+    if (!tag) {
+        return undefined;
+    }
+    if (/[\r\n]/.test(tag)) {
+        throw new Error('x-rylai-service-tag 不允许包含换行符');
+    }
+    return tag;
+}
+function isValidPathPrefix(value) {
+    return typeof value === 'string' && value.startsWith('/') && !/[\r\n]/.test(value);
+}
+function getPathname(pathWithQuery) {
+    try {
+        return new URL(pathWithQuery, 'https://api.xiaoheihe.cn').pathname;
+    }
+    catch {
+        return '';
+    }
+}
+
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.5.16';
+const BUILT_CLI_VERSION = '0.5.18';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -13132,7 +13354,9 @@ async function runCli(options = {}) {
     const processLike = options.process ?? process;
     const argv = options.argv ?? process.argv;
     const verbose = hasVerboseArg(argv);
+    const logger = resolveStandaloneLogger(options, verbose);
     try {
+        preloadCliEnvPreset(argv, { logger });
         await createCliProgram(options).parseAsync(argv);
     }
     catch (error) {
@@ -13141,7 +13365,7 @@ async function runCli(options = {}) {
             return;
         }
         if (!(error instanceof CommanderError)) {
-            (options.printError ?? printError)(error, { logger: resolveStandaloneLogger(options, verbose), verbose });
+            (options.printError ?? printError)(error, { logger, verbose });
         }
         processLike.exit(error instanceof CommanderError ? error.exitCode : 1);
     }
@@ -13165,6 +13389,8 @@ function createCliProgram(overrides = {}) {
         .description('hb-sdk developer tools')
         .version(getCliVersion())
         .option('-v, --verbose', '输出详细调试信息')
+        .option('--env <name>', '加载项目根下 .env.<name> 预设，把其中的 HB_SDK_* 变量注入当前进程（不覆盖已有值）')
+        .option('--env-file <path>', '显式指定 .env 文件路径，优先级高于 --env')
         .showHelpAfterError()
         .exitOverride();
     installVersionUpdateReminder(program, handlers.printUpdateReminder, resolveLogger);
@@ -13220,7 +13446,8 @@ function addRemotePublicOptions(command) {
         .option('--json', '以 JSON 格式输出 remote 命令结果')
         .option('--api-base-url <url>', 'Heybox 后台 API origin，默认读取 HB_SDK_API_BASE_URL 或生产地址')
         .option('--login-base-url <url>', '校验 CLI 登录态使用的登录 origin，默认读取 HB_SDK_LOGIN_BASE_URL 或生产地址')
-        .option('--allow-unsafe-api-base-url', '允许向非 Heybox HTTPS API origin 发送登录态，仅限本地调试'));
+        .option('--allow-unsafe-api-base-url', '允许向非 Heybox HTTPS API origin 发送登录态，仅限本地调试')
+        .option('--service-tag <tag>', '给 Heybox 后台请求附加 x-rylai-service-tag，默认读取 HB_SDK_SERVICE_TAG'));
 }
 function installRemoteCommands(program, handlers, resolveLogger) {
     const remote = addRemotePublicOptions(program.command('remote').description('管理当前项目绑定的远程 Heybox 工坊小程序'));
@@ -13357,6 +13584,7 @@ function readRemoteCommonOptions(command) {
         apiBaseUrl: readStringOption(options.apiBaseUrl),
         json: Boolean(options.json),
         loginBaseUrl: readStringOption(options.loginBaseUrl),
+        serviceTag: readStringOption(options.serviceTag),
         verbose: Boolean(options.verbose),
     };
 }
@@ -13411,31 +13639,31 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-CP6xdTYa.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-Ct-46gLx.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-CP6xdTYa.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-Ct-46gLx.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-CP6xdTYa.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-Ct-46gLx.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-DUwSoYT4.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-OZOIdeBz.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-78XBGRX3.cjs'); });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-DXz8izSJ.cjs'); });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-CHrjGIQ1.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-DjMSJoQ5.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-CdEyGDRq.cjs'); }).then(function (n) { return n.remote; });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-C77axNSw.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {
@@ -13493,6 +13721,25 @@ function readCommandFromActionArgs(args) {
     const lastArg = args[args.length - 1];
     return lastArg instanceof Command ? lastArg : undefined;
 }
+/**
+ * 在 commander 解析前加载 .env 预设，把其中的 HB_SDK_* 变量注入 process.env（不覆盖已有值），
+ * 并把 HB_SDK_SERVICE_TAG 同步到 CLI 全局请求配置。
+ * 这样后续 resolveHeyboxApiBaseUrl / resolveHeyboxLoginBaseUrl 读 process.env 时即可拿到预设值。
+ */
+function preloadCliEnvPreset(argv, options = {}) {
+    const result = loadEnvPreset(argv);
+    if (!result.filePath) {
+        return;
+    }
+    options.logger?.debug(`已加载 env 预设: ${result.filePath}`);
+    if (result.appliedKeys.length) {
+        options.logger?.debug(`env 预设生效: ${result.appliedKeys.join(', ')}`);
+    }
+    if (result.skippedKeys.length) {
+        options.logger?.debug(`env 预设跳过（已有值）: ${result.skippedKeys.join(', ')}`);
+    }
+    applyServiceTagIfNeeded(process.env.HB_SDK_SERVICE_TAG);
+}
 function parsePositivePort(value) {
     const parsed = Number(value);
     if (!Number.isInteger(parsed) || parsed <= 0) {
@@ -13514,6 +13761,7 @@ exports.HB_SDK_SKILL_INDEX_URL = HB_SDK_SKILL_INDEX_URL;
 exports.HB_SDK_SKILL_INSTALL_COMMAND = HB_SDK_SKILL_INSTALL_COMMAND;
 exports.HB_SDK_SKILL_NAME = HB_SDK_SKILL_NAME;
 exports.HB_SDK_SKILL_SOURCE = HB_SDK_SKILL_SOURCE;
+exports.applyServiceTagIfNeeded = applyServiceTagIfNeeded;
 exports.commonjsGlobal = commonjsGlobal;
 exports.createCliLogger = createCliLogger;
 exports.createCliProgram = createCliProgram;
@@ -13523,4 +13771,5 @@ exports.readErrorMessage = readErrorMessage;
 exports.requireEnvPaths = requireEnvPaths;
 exports.requireOnetime = requireOnetime;
 exports.requireSafeBuffer = requireSafeBuffer;
+exports.resolveHeyboxRylaiServiceTag = resolveHeyboxRylaiServiceTag;
 exports.runCli = runCli;

package/dist/cli-chunks/{login-CP6xdTYa.cjs → login-Ct-46gLx.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-Cfl5cGf8.cjs');
+var session = require('./session-dRGPpyS1.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-B-lA2GE7.cjs');
+var index = require('./index-CsOcGUzF.cjs');
 require('node:path');
 require('fs');
 require('constants');