@weapp-tailwindcss/hbuilderx-runner 0.1.6 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -54,3 +54,11 @@ If one CLI matches multiple hosts, the runner reports an ambiguity instead of gu
54
54
  Some HBuilderX releases reject concurrent stable and Alpha processes. The runner never closes an existing instance automatically; it reports `cli-instance-mismatch` when the target edition cannot start, so close the conflicting instance before retrying.
55
55
 
56
56
  `runPnpmCommand`, `spawnPnpmCommand`, `hbuilderxPnpmArgs`, and the synchronous `startLaunch` remain for compatibility. Use a bound runner when the stable/Alpha choice must be deterministic; the `@dcloudio/hbuilderx-cli` pnpm wrapper performs its own process discovery and cannot provide that guarantee.
57
+
58
+ ## Timeouts and cleanup
59
+
60
+ After `timeoutMs`, `runCommand` cleans up its own process before waiting for the real `close` event and final logs. Cleanup has a separate budget: POSIX waits up to one second after the requested signal, then up to one second after `SIGKILL`; Windows runs `taskkill /T /F` with a five-second timeout, then waits up to one second for closure. Cleanup already in progress also waits for descendants in the default detached process group, including descendants that close their pipes before the root exits.
61
+
62
+ A graceful exit code of zero after the business deadline still has the `timeout` classification. `allowFailure` permits business failures, but never cleanup failures. `HBuilderXCommandError.cleanupError` and `cause` retain cleanup diagnostics alongside the command, cwd, observed exit and recent logs. A Windows partial tree-termination failure remains an error even if the root closes.
63
+
64
+ Call and await `stop()` before a long-running root process closes. Repeated calls share the same cleanup result. Natural closure revokes the numeric PID/group handle to avoid targeting a later process that reuses it; services that deliberately leave the group are outside this scope. With `detached: false`, only the owned root's closure is confirmed. The synchronous `killProcessTree` remains a best-effort compatibility request, not cleanup confirmation. Unreaped POSIX orphan processes or persistent permission errors that prevent confirmation cause conservative cleanup failure.
package/README.zh-CN.md CHANGED
@@ -55,3 +55,11 @@ macOS 默认路径为 `/Applications/HBuilderX.app/Contents/MacOS/cli` 和 `/App
55
55
  部分 HBuilderX 版本自身会拒绝 stable 与 Alpha 跨版本并行运行。runner 不会擅自关闭当前实例;目标版本无法启动时会抛出 `cli-instance-mismatch`,请关闭冲突实例后重试。
56
56
 
57
57
  `runPnpmCommand`、`spawnPnpmCommand`、`hbuilderxPnpmArgs` 和同步 `startLaunch` 为兼容旧调用保留。需要固定 stable/Alpha 时应使用绑定 runner;`@dcloudio/hbuilderx-cli` 的 pnpm 包装器会重新按运行进程探测版本,无法提供同等保证。
58
+
59
+ ## 超时与清理
60
+
61
+ `runCommand` 达到 `timeoutMs` 后先清理自己启动的进程,再等待真实 `close` 和最终日志。清理使用独立预算:POSIX 先发送请求信号,最多等待 1 秒,再发送 `SIGKILL` 并最多等待 1 秒;Windows 使用最多 5 秒的 `taskkill /T /F`,随后最多等待 1 秒确认关闭。默认独立进程组中的后代即使关闭管道、根进程先退出,也纳入已开始的清理。
62
+
63
+ 业务超时后即使进程优雅地返回 0,结果仍是 `timeout`。`allowFailure` 只允许返回业务失败,不放行清理失败;清理失败通过 `HBuilderXCommandError.cleanupError` 和 `cause` 保留,主错误继续记录命令、cwd、退出状态和最近日志。Windows 部分终止失败不会因根进程关闭而被抹掉。
64
+
65
+ 长驻命令必须在根进程 `close` 前调用并等待 `stop()`,重复调用复用同一次清理结果。自然关闭后注销数字 PID/进程组句柄,避免误终止后来复用该编号的进程;不会追踪主动脱离独立组的服务。`detached: false` 只确认所持有的根进程关闭。同步 `killProcessTree` 仅保留兼容的终止请求,不等同于清理成功。POSIX 进程组若仍含未回收的孤儿进程,或权限错误持续导致无法确认组已消失,清理会保守失败。
package/dist/index.cjs CHANGED
@@ -51,7 +51,7 @@ function wait(ms) {
51
51
  const macOSStableCli = "/Applications/HBuilderX.app/Contents/MacOS/cli";
52
52
  const macOSAlphaCli = "/Applications/HBuilderX-Alpha.app/Contents/MacOS/cli";
53
53
  function resolveCandidateSource(candidate, env) {
54
- if (candidate === env.HBUILDERX_CLI_PATH) return "env";
54
+ if (candidate === env["HBUILDERX_CLI_PATH"]) return "env";
55
55
  if (candidate === "/Applications/HBuilderX.app/Contents/MacOS/cli" || candidate === "/Applications/HBuilderX-Alpha.app/Contents/MacOS/cli") return "default-path";
56
56
  return "candidate";
57
57
  }
@@ -68,8 +68,8 @@ async function resolveConfiguredCli(options) {
68
68
  source: resolveCandidateSource(candidate, env)
69
69
  };
70
70
  }
71
- if (env.HBUILDERX_CLI_PATH && await fileExists(env.HBUILDERX_CLI_PATH)) return {
72
- path: env.HBUILDERX_CLI_PATH,
71
+ if (env["HBUILDERX_CLI_PATH"] && await fileExists(env["HBUILDERX_CLI_PATH"])) return {
72
+ path: env["HBUILDERX_CLI_PATH"],
73
73
  source: "env"
74
74
  };
75
75
  }
@@ -92,9 +92,9 @@ function inferHBuilderXChannel(file) {
92
92
  if (/HBuilderX(?:\.app)?[\\/]/i.test(file) || /HBuilderX\.exe$/i.test(file)) return "stable";
93
93
  return "unknown";
94
94
  }
95
- function getDefaultHBuilderXCliCandidates(env = node_process.default.env, channel = resolveHBuilderXChannel(env.HBUILDERX_CHANNEL), platform = node_process.default.platform) {
95
+ function getDefaultHBuilderXCliCandidates(env = node_process.default.env, channel = resolveHBuilderXChannel(env["HBUILDERX_CHANNEL"]), platform = node_process.default.platform) {
96
96
  const defaults = platform === "darwin" ? channel === "stable" ? [macOSStableCli] : channel === "alpha" ? [macOSAlphaCli] : [macOSStableCli, macOSAlphaCli] : [];
97
- return unique([env.HBUILDERX_CLI_PATH, ...defaults].filter((item) => Boolean(item)));
97
+ return unique([env["HBUILDERX_CLI_PATH"], ...defaults].filter((item) => Boolean(item)));
98
98
  }
99
99
  function extractHBuilderXMacOSExecutables(output) {
100
100
  return unique(Array.from(output.matchAll(/(\/[^\r\n]*?HBuilderX(?:-Alpha|\s+Alpha)?\.app\/Contents\/MacOS\/HBuilderX)(?=\s|$)/gi), (match) => match[1]));
@@ -202,7 +202,7 @@ async function firstExisting(items) {
202
202
  }
203
203
  async function resolveHBuilderXCliInfoFromOptions(options = {}) {
204
204
  const env = options.env ?? node_process.default.env;
205
- const channel = resolveHBuilderXChannel(options.channel ?? env.HBUILDERX_CHANNEL);
205
+ const channel = resolveHBuilderXChannel(options.channel ?? env["HBUILDERX_CHANNEL"]);
206
206
  const running = await findRunningHBuilderXCliCandidates();
207
207
  const configured = await resolveConfiguredCli(options);
208
208
  if (configured) return {
@@ -357,37 +357,138 @@ function formatRecentLogs(logs, maxLength = 6e3) {
357
357
  return important.length > 0 ? `关键错误:\n${important.join("\n")}\n\n最近日志:\n${recent}` : recent;
358
358
  }
359
359
  //#endregion
360
- //#region src/process.ts
361
- var HBuilderXCommandError = class extends Error {
362
- result;
363
- constructor(message, result) {
364
- super(message);
365
- this.name = "HBuilderXCommandError";
366
- this.result = result;
367
- }
368
- };
369
- function killProcessTree(child, signal = "SIGTERM") {
370
- const pid = child.pid;
371
- if (!pid || child.exitCode != null) return;
360
+ //#region src/process/termination.ts
361
+ const ownedGroups = /* @__PURE__ */ new WeakMap();
362
+ const closedChildren = /* @__PURE__ */ new WeakSet();
363
+ const shutdownWaitMs = 1e3;
364
+ /** 只记录本次 spawn 创建的独立进程组,不从外部 PID 猜测组归属。 */
365
+ function registerProcessGroup(child, detached) {
366
+ if (node_process.default.platform !== "win32" && detached && child.pid) ownedGroups.set(child, child.pid);
367
+ child.once("close", () => {
368
+ closedChildren.add(child);
369
+ ownedGroups.delete(child);
370
+ });
371
+ }
372
+ function signalOwnedTree(child, signal, group) {
373
+ if (!child.pid) return;
372
374
  if (node_process.default.platform === "win32") {
373
- (0, node_child_process.spawnSync)("taskkill", [
375
+ if (child.exitCode !== null || child.signalCode !== null || closedChildren.has(child)) return;
376
+ const result = (0, node_child_process.spawnSync)("taskkill", [
374
377
  "/pid",
375
- String(pid),
378
+ String(child.pid),
376
379
  "/t",
377
380
  "/f"
378
381
  ], {
379
- stdio: "ignore",
382
+ timeout: 5e3,
383
+ killSignal: "SIGKILL",
384
+ maxBuffer: 65536,
385
+ encoding: "utf8",
386
+ stdio: [
387
+ "ignore",
388
+ "pipe",
389
+ "pipe"
390
+ ],
380
391
  windowsHide: true
381
392
  });
393
+ if (result.error || result.status !== 0) throw new Error(`taskkill pid=${child.pid} 失败,exit=${result.status} signal=${result.signal}\n${result.error?.message ?? ""}\n${result.stderr ?? ""}\n${result.stdout ?? ""}`, { cause: result.error });
382
394
  return;
383
395
  }
384
- try {
385
- node_process.default.kill(-pid, signal);
386
- } catch {
396
+ if (group) try {
397
+ node_process.default.kill(-group, signal);
398
+ return;
399
+ } catch (error) {
400
+ if (error.code !== "ESRCH") throw error;
401
+ }
402
+ if (!closedChildren.has(child) && child.exitCode === null && child.signalCode === null && !child.kill(signal)) throw new Error(`未能向子进程 pid=${child.pid} 发送 ${signal}`);
403
+ }
404
+ /** 同步入口在 close 后失效,避免稍后向复用的 PID 或进程组发送信号。 */
405
+ function signalProcessTree(child, signal) {
406
+ if (!closedChildren.has(child)) signalOwnedTree(child, signal, ownedGroups.get(child));
407
+ }
408
+ function waitForCleanup(closed, isGroupGone) {
409
+ return new Promise((resolve, reject) => {
410
+ let didClose = false;
411
+ let finished = false;
412
+ let lastProbeError;
413
+ const finish = (done, error) => {
414
+ finished = true;
415
+ clearTimeout(deadline);
416
+ clearInterval(poll);
417
+ if (error) reject(error);
418
+ else resolve(done);
419
+ };
420
+ const check = () => {
421
+ if (finished) return;
422
+ try {
423
+ const groupGone = isGroupGone();
424
+ lastProbeError = void 0;
425
+ if (didClose && groupGone) finish(true);
426
+ } catch (error) {
427
+ lastProbeError = error;
428
+ }
429
+ };
430
+ const expire = () => finish(false, lastProbeError);
431
+ const deadline = setTimeout(expire, shutdownWaitMs);
432
+ const poll = setInterval(check, 25);
433
+ closed.then(() => {
434
+ didClose = true;
435
+ check();
436
+ });
437
+ check();
438
+ });
439
+ }
440
+ /** 清理预算独立于业务超时;只持有本轮开始时仍有效的组归属。 */
441
+ async function stopProcessTree(child, closed, signal) {
442
+ let group = ownedGroups.get(child);
443
+ const errors = [];
444
+ const isGroupGone = () => {
445
+ if (!group) return true;
446
+ try {
447
+ node_process.default.kill(-group, 0);
448
+ return false;
449
+ } catch (error) {
450
+ if (error.code !== "ESRCH") throw error;
451
+ group = void 0;
452
+ ownedGroups.delete(child);
453
+ return true;
454
+ }
455
+ };
456
+ const signals = node_process.default.platform === "win32" || signal === "SIGKILL" ? [signal] : [signal, "SIGKILL"];
457
+ for (const nextSignal of signals) {
458
+ try {
459
+ signalOwnedTree(child, nextSignal, group);
460
+ } catch (error) {
461
+ errors.push(error);
462
+ }
387
463
  try {
388
- child.kill(signal);
389
- } catch {}
464
+ if (await waitForCleanup(closed, isGroupGone)) {
465
+ if (!errors.length) return;
466
+ break;
467
+ }
468
+ } catch (error) {
469
+ errors.push(error);
470
+ }
390
471
  }
472
+ const details = errors.map((error) => error instanceof Error ? error.message : String(error)).join("\n");
473
+ throw new AggregateError(errors, `子进程 pid=${child.pid ?? "unknown"} 的有界清理未成功:需确认 close 和本轮进程组结束\n${details}`.trim());
474
+ }
475
+ //#endregion
476
+ //#region src/process.ts
477
+ var HBuilderXCommandError = class extends Error {
478
+ result;
479
+ cleanupError;
480
+ constructor(message, result, cleanupError) {
481
+ super(message, cleanupError ? { cause: cleanupError } : void 0);
482
+ this.name = "HBuilderXCommandError";
483
+ this.result = result;
484
+ if (cleanupError) this.cleanupError = cleanupError;
485
+ }
486
+ };
487
+ /** 保留同步请求终止的兼容入口;需要确认关闭时必须等待 spawned.stop()。 */
488
+ function killProcessTree(child, signal = "SIGTERM") {
489
+ try {
490
+ signalProcessTree(child, signal);
491
+ } catch {}
391
492
  }
392
493
  function createCommandResult(options, exit, logs, timedOut = false) {
393
494
  const output = formatRecentLogs(logs);
@@ -401,21 +502,27 @@ function createCommandResult(options, exit, logs, timedOut = false) {
401
502
  issue: timedOut ? createTimeoutIssue() : classifyHBuilderXOutput(output)
402
503
  };
403
504
  }
404
- function buildCommandError(prefix, options, exit, logs, timedOut = false) {
505
+ function buildCommandError(prefix, options, exit, logs, timedOut = false, cleanupError) {
405
506
  const result = createCommandResult(options, exit, logs, timedOut);
507
+ if (cleanupError && !timedOut) result.issue = {
508
+ kind: "process-exit",
509
+ message: "子进程清理失败,未确认关闭或进程树终止。"
510
+ };
406
511
  return new HBuilderXCommandError([
407
512
  `${prefix}: ${options.command} ${options.args.join(" ")}`,
408
513
  `cwd=${options.cwd}`,
409
514
  `exit=${exit.signal ?? exit.code}`,
410
515
  `issue=${result.issue.kind}: ${result.issue.message}`,
411
516
  result.issue.hint ? `hint=${result.issue.hint}` : "",
412
- result.output
413
- ].filter(Boolean).join("\n"), result);
517
+ result.output,
518
+ cleanupError ? `cleanup=${cleanupError.message}` : ""
519
+ ].filter(Boolean).join("\n"), result, cleanupError);
414
520
  }
415
521
  function spawnCommand(options) {
522
+ const detached = options.detached ?? node_process.default.platform !== "win32";
416
523
  const child = (0, cross_spawn.default)(options.command, options.args, {
417
524
  cwd: options.cwd,
418
- detached: options.detached ?? node_process.default.platform !== "win32",
525
+ detached,
419
526
  stdio: options.stdio === "inherit" ? "inherit" : [
420
527
  "ignore",
421
528
  "pipe",
@@ -424,14 +531,16 @@ function spawnCommand(options) {
424
531
  env: {
425
532
  ...node_process.default.env,
426
533
  ...options.env,
427
- NODE_OPTIONS: options.env?.NODE_OPTIONS ?? node_process.default.env.NODE_OPTIONS ?? "--max-old-space-size=8192"
534
+ NODE_OPTIONS: options.env?.["NODE_OPTIONS"] ?? node_process.default.env["NODE_OPTIONS"] ?? "--max-old-space-size=8192"
428
535
  }
429
536
  });
537
+ registerProcessGroup(child, detached);
430
538
  const logs = options.stdio === "inherit" ? [] : collectProcessOutput(child);
431
539
  child.on("error", (error) => logs.push(`${error.message}\n`));
432
540
  let exit;
541
+ let stopping;
433
542
  const closed = new Promise((resolve) => {
434
- child.on("close", (code, signal) => {
543
+ child.once("close", (code, signal) => {
435
544
  exit = {
436
545
  code,
437
546
  signal
@@ -449,9 +558,16 @@ function spawnCommand(options) {
449
558
  ensureRunning() {
450
559
  if (exit && exit.code !== 0) throw buildCommandError("命令提前退出", options, exit, logs);
451
560
  },
452
- async stop(signal = "SIGTERM") {
453
- killProcessTree(child, signal);
454
- await Promise.race([closed, wait(5e3)]);
561
+ stop(signal = "SIGTERM") {
562
+ if (stopping) return stopping;
563
+ if (exit) return Promise.resolve();
564
+ stopping = stopProcessTree(child, closed, signal).catch((error) => {
565
+ throw buildCommandError("命令清理失败", options, {
566
+ code: child.exitCode,
567
+ signal: child.signalCode
568
+ }, logs, false, error);
569
+ });
570
+ return stopping;
455
571
  }
456
572
  };
457
573
  }
@@ -460,19 +576,26 @@ async function runCommand(options) {
460
576
  let timer;
461
577
  let timedOut = false;
462
578
  try {
463
- const exit = await (options.timeoutMs == null ? spawned.closed : Promise.race([spawned.closed, new Promise((resolve) => {
579
+ const deadline = Symbol("deadline");
580
+ const outcome = await (options.timeoutMs == null ? spawned.closed : Promise.race([spawned.closed, new Promise((resolve) => {
464
581
  timer = setTimeout(() => {
465
582
  timedOut = true;
466
- killProcessTree(spawned.child);
467
- resolve({
468
- code: null,
469
- signal: "SIGTERM"
470
- });
583
+ resolve(deadline);
471
584
  }, options.timeoutMs);
472
585
  })]));
586
+ if (outcome === deadline) try {
587
+ await spawned.stop();
588
+ } catch (error) {
589
+ const cleanupError = error instanceof HBuilderXCommandError ? error.cleanupError ?? error : error;
590
+ throw buildCommandError("命令超时且清理失败", options, {
591
+ code: spawned.child.exitCode,
592
+ signal: spawned.child.signalCode
593
+ }, spawned.logs, true, cleanupError);
594
+ }
595
+ const exit = outcome === deadline ? await spawned.closed : outcome;
473
596
  const result = createCommandResult(options, exit, spawned.logs, timedOut);
474
- if (exit.code === 0 || options.allowFailure) return result;
475
- throw buildCommandError(options.timeoutMs != null && exit.code == null ? "命令超时" : "命令失败", options, exit, spawned.logs, timedOut);
597
+ if (!timedOut && exit.code === 0 || options.allowFailure) return result;
598
+ throw buildCommandError(timedOut ? "命令超时" : "命令失败", options, exit, spawned.logs, timedOut);
476
599
  } finally {
477
600
  if (timer) clearTimeout(timer);
478
601
  }
@@ -578,7 +701,7 @@ async function connectHBuilderXHost(options) {
578
701
  };
579
702
  const assertCommand = (result) => {
580
703
  if (result.issue.kind === "cli-instance-mismatch" || result.issue.kind === "cli-host-ambiguous") throw createRunnerError(cliPath, cwd, result.args, result.issue.kind, result.issue.message, result.issue.hint ?? "请检查目标 HBuilderX host。", logs);
581
- if (result.exit.code !== 0) throw new HBuilderXCommandError(`HBuilderX host 命令失败:${cliPath} ${result.args.join(" ")}\ncwd=${cwd}\nexit=${result.exit.signal ?? result.exit.code}\nissue=${result.issue.kind}\n${formatRecentLogs(logs)}`, result);
704
+ if (result.issue.kind === "timeout" || result.exit.code !== 0) throw new HBuilderXCommandError(`HBuilderX host 命令失败:${cliPath} ${result.args.join(" ")}\ncwd=${cwd}\nexit=${result.exit.signal ?? result.exit.code}\nissue=${result.issue.kind}\n${formatRecentLogs(logs)}`, result);
582
705
  };
583
706
  const probe = async () => {
584
707
  const listed = await command(["listhost"]);
@@ -647,11 +770,12 @@ async function createHBuilderXRunner(options = {}) {
647
770
  };
648
771
  const cwd = options.cwd ?? node_process.default.cwd();
649
772
  const timeoutMs = options.timeoutMs ?? defaultStartupTimeoutMs;
773
+ const candidates = options.hbuilderxCliPath ? [options.hbuilderxCliPath] : options.candidates;
650
774
  const resolveOptions = {
651
- candidates: options.hbuilderxCliPath ? [options.hbuilderxCliPath] : options.candidates,
652
- channel: options.channel,
775
+ ...candidates !== void 0 ? { candidates } : {},
776
+ ...options.channel !== void 0 ? { channel: options.channel } : {},
653
777
  env,
654
- host: options.host
778
+ ...options.host !== void 0 ? { host: options.host } : {}
655
779
  };
656
780
  const configured = await resolveConfiguredCli(resolveOptions);
657
781
  const resolution = configured ? {
@@ -662,15 +786,15 @@ async function createHBuilderXRunner(options = {}) {
662
786
  ...env,
663
787
  HBUILDERX_CLI_PATH: resolution.path
664
788
  };
665
- const requestedChannel = resolveHBuilderXChannel(options.channel ?? env.HBUILDERX_CHANNEL);
789
+ const requestedChannel = resolveHBuilderXChannel(options.channel ?? env["HBUILDERX_CHANNEL"]);
666
790
  const expectedChannel = resolution.channel !== "unknown" ? resolution.channel : requestedChannel === "auto" ? inferHBuilderXChannel(resolution.path) : requestedChannel;
667
- const explicitHost = options.host ?? env.HBUILDERX_HOST;
791
+ const explicitHost = options.host ?? env["HBUILDERX_HOST"];
668
792
  const selected = await connectHBuilderXHost({
669
793
  cliPath: resolution.path,
670
794
  cwd,
671
795
  env: cliEnv,
672
796
  expectedChannel,
673
- explicitHost,
797
+ ...explicitHost !== void 0 ? { explicitHost } : {},
674
798
  timeoutMs
675
799
  });
676
800
  const boundResolution = {
@@ -759,14 +883,14 @@ async function resolveHBuilderXCliInfo(candidatesOrOptions, env = node_process.d
759
883
  }
760
884
  async function resolveHBuilderXCli(candidatesOrOptions) {
761
885
  const options = Array.isArray(candidatesOrOptions) ? { candidates: candidatesOrOptions } : candidatesOrOptions ?? {};
762
- resolveHBuilderXChannel(options.channel ?? (options.env ?? node_process.default.env).HBUILDERX_CHANNEL);
886
+ resolveHBuilderXChannel(options.channel ?? (options.env ?? node_process.default.env)["HBUILDERX_CHANNEL"]);
763
887
  return (await resolveConfiguredCli(options))?.path ?? (await resolveHBuilderXCliInfoFromOptions(options)).path;
764
888
  }
765
889
  function createHBuilderXEnv(options = {}) {
766
890
  return {
767
891
  ...options.env,
768
- HBUILDERX_CLI_PATH: options.hbuilderxCliPath ?? options.env?.HBUILDERX_CLI_PATH ?? node_process.default.env.HBUILDERX_CLI_PATH ?? getDefaultHBuilderXCliCandidates()[0],
769
- NODE_OPTIONS: options.env?.NODE_OPTIONS ?? node_process.default.env.NODE_OPTIONS ?? "--max-old-space-size=8192"
892
+ HBUILDERX_CLI_PATH: options.hbuilderxCliPath ?? options.env?.["HBUILDERX_CLI_PATH"] ?? node_process.default.env["HBUILDERX_CLI_PATH"] ?? getDefaultHBuilderXCliCandidates()[0],
893
+ NODE_OPTIONS: options.env?.["NODE_OPTIONS"] ?? node_process.default.env["NODE_OPTIONS"] ?? "--max-old-space-size=8192"
770
894
  };
771
895
  }
772
896
  function hbuilderxPnpmArgs(args) {
@@ -781,8 +905,8 @@ async function runPnpmCommand(options) {
781
905
  command: "pnpm",
782
906
  args: options.args,
783
907
  cwd: options.cwd,
784
- timeoutMs: options.timeoutMs,
785
- allowFailure: options.allowFailure,
908
+ ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
909
+ ...options.allowFailure !== void 0 ? { allowFailure: options.allowFailure } : {},
786
910
  env: createHBuilderXEnv(options)
787
911
  });
788
912
  }
@@ -846,9 +970,9 @@ function resolveAdbCommand(env = node_process.default.env) {
846
970
  env: {}
847
971
  };
848
972
  const candidates = [
849
- env.ANDROID_HOME,
850
- env.ANDROID_SDK_ROOT,
851
- env.HOME ? node_path.default.join(env.HOME, "Library/Android/sdk") : void 0,
973
+ env["ANDROID_HOME"],
974
+ env["ANDROID_SDK_ROOT"],
975
+ env["HOME"] ? node_path.default.join(env["HOME"], "Library/Android/sdk") : void 0,
852
976
  "/opt/android-sdk",
853
977
  "/usr/local/share/android-sdk"
854
978
  ].filter((item) => Boolean(item));
@@ -859,9 +983,9 @@ function resolveAdbCommand(env = node_process.default.env) {
859
983
  command: adbPath,
860
984
  output: candidate.output,
861
985
  env: {
862
- ANDROID_HOME: env.ANDROID_HOME ?? sdkRoot,
863
- ANDROID_SDK_ROOT: env.ANDROID_SDK_ROOT ?? sdkRoot,
864
- PATH: `${node_path.default.dirname(adbPath)}${node_path.default.delimiter}${env.PATH ?? ""}`
986
+ ANDROID_HOME: env["ANDROID_HOME"] ?? sdkRoot,
987
+ ANDROID_SDK_ROOT: env["ANDROID_SDK_ROOT"] ?? sdkRoot,
988
+ PATH: `${node_path.default.dirname(adbPath)}${node_path.default.delimiter}${env["PATH"] ?? ""}`
865
989
  }
866
990
  };
867
991
  }
@@ -890,7 +1014,7 @@ function assertIosSimulatorToolchain(env = node_process.default.env) {
890
1014
  if (!simctl.ok || !xcodebuild.ok || firstLaunchStatus?.ok === false) throw new Error([
891
1015
  "当前机器缺少 iOS 模拟器所需的完整 Xcode 工具链,无法运行 HBuilderX app-ios E2E。",
892
1016
  `xcode-select: ${xcodeSelect.output || "unknown"}`,
893
- `DEVELOPER_DIR: ${env.DEVELOPER_DIR || "未设置"}`,
1017
+ `DEVELOPER_DIR: ${env["DEVELOPER_DIR"] || "未设置"}`,
894
1018
  `simctl: ${simctl.output || "not found"}`,
895
1019
  `xcodebuild: ${xcodebuild.output || "not found"}`,
896
1020
  `firstLaunchStatus: ${firstLaunchStatus?.output || (firstLaunchStatus?.ok === false ? "not ready" : "unknown")}`,
@@ -936,7 +1060,7 @@ function selectPreferredIosSimulatorDevice(devices) {
936
1060
  })[0];
937
1061
  }
938
1062
  function resolveIosSimulatorDeviceId(env = node_process.default.env) {
939
- const explicitDeviceId = env.E2E_HBUILDERX_IOS_DEVICE_ID;
1063
+ const explicitDeviceId = env["E2E_HBUILDERX_IOS_DEVICE_ID"];
940
1064
  if (explicitDeviceId) return explicitDeviceId;
941
1065
  const booted = runTool("xcrun", [
942
1066
  "simctl",
@@ -965,9 +1089,9 @@ function resolveIosSimulatorDeviceId(env = node_process.default.env) {
965
1089
  }
966
1090
  function resolveHdcCommand(env = node_process.default.env) {
967
1091
  const candidates = [
968
- env.DEMO_VISUAL_HARMONY_HDC_PATH,
969
- env.E2E_HBUILDERX_HARMONY_HDC_PATH,
970
- env.HDC_PATH,
1092
+ env["DEMO_VISUAL_HARMONY_HDC_PATH"],
1093
+ env["E2E_HBUILDERX_HARMONY_HDC_PATH"],
1094
+ env["HDC_PATH"],
971
1095
  "hdc",
972
1096
  node_process.default.platform === "darwin" ? "/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc" : void 0
973
1097
  ].filter((item) => Boolean(item));
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { Buffer } from "node:buffer";
2
1
  import { ChildProcess } from "node:child_process";
2
+ import { Buffer } from "node:buffer";
3
3
  //#region src/fs.d.ts
4
4
  export declare function fileExists(file: string): Promise<boolean>;
5
5
  export declare function readUtf8(file: string): Promise<string>;
@@ -25,6 +25,7 @@ export interface HBuilderXCommandOptions {
25
25
  command: string;
26
26
  args: string[];
27
27
  cwd: string;
28
+ /** 业务截止时间;超时后另有有界进程清理预算。 */
28
29
  timeoutMs?: number;
29
30
  env?: Record<string, string | undefined>;
30
31
  allowFailure?: boolean;
@@ -46,6 +47,7 @@ export interface SpawnedHBuilderXCommand {
46
47
  command: string;
47
48
  args: string[];
48
49
  cwd: string;
50
+ /** 在 close 前启动有界清理并确认本轮进程树结束;失败抛出诊断,多次调用复用同一结果。 */
49
51
  stop: (signal?: NodeJS.Signals) => Promise<void>;
50
52
  closed: Promise<CommandExit>;
51
53
  ensureRunning: () => void;
@@ -138,8 +140,10 @@ export declare function resolveHBuilderXCliInfoFromOptions(options?: HBuilderXCl
138
140
  //#region src/process.d.ts
139
141
  export declare class HBuilderXCommandError extends Error {
140
142
  readonly result: HBuilderXCommandResult;
141
- constructor(message: string, result: HBuilderXCommandResult);
143
+ readonly cleanupError?: Error;
144
+ constructor(message: string, result: HBuilderXCommandResult, cleanupError?: Error);
142
145
  }
146
+ /** 保留同步请求终止的兼容入口;需要确认关闭时必须等待 spawned.stop()。 */
143
147
  export declare function killProcessTree(child: ChildProcess, signal?: NodeJS.Signals): void;
144
148
  export declare function spawnCommand(options: HBuilderXCommandOptions): SpawnedHBuilderXCommand;
145
149
  export declare function runCommand(options: HBuilderXCommandOptions): Promise<HBuilderXCommandResult>;
package/dist/index.mjs CHANGED
@@ -24,7 +24,7 @@ function wait(ms) {
24
24
  const macOSStableCli = "/Applications/HBuilderX.app/Contents/MacOS/cli";
25
25
  const macOSAlphaCli = "/Applications/HBuilderX-Alpha.app/Contents/MacOS/cli";
26
26
  function resolveCandidateSource(candidate, env) {
27
- if (candidate === env.HBUILDERX_CLI_PATH) return "env";
27
+ if (candidate === env["HBUILDERX_CLI_PATH"]) return "env";
28
28
  if (candidate === "/Applications/HBuilderX.app/Contents/MacOS/cli" || candidate === "/Applications/HBuilderX-Alpha.app/Contents/MacOS/cli") return "default-path";
29
29
  return "candidate";
30
30
  }
@@ -41,8 +41,8 @@ async function resolveConfiguredCli(options) {
41
41
  source: resolveCandidateSource(candidate, env)
42
42
  };
43
43
  }
44
- if (env.HBUILDERX_CLI_PATH && await fileExists(env.HBUILDERX_CLI_PATH)) return {
45
- path: env.HBUILDERX_CLI_PATH,
44
+ if (env["HBUILDERX_CLI_PATH"] && await fileExists(env["HBUILDERX_CLI_PATH"])) return {
45
+ path: env["HBUILDERX_CLI_PATH"],
46
46
  source: "env"
47
47
  };
48
48
  }
@@ -65,9 +65,9 @@ function inferHBuilderXChannel(file) {
65
65
  if (/HBuilderX(?:\.app)?[\\/]/i.test(file) || /HBuilderX\.exe$/i.test(file)) return "stable";
66
66
  return "unknown";
67
67
  }
68
- function getDefaultHBuilderXCliCandidates(env = process.env, channel = resolveHBuilderXChannel(env.HBUILDERX_CHANNEL), platform = process.platform) {
68
+ function getDefaultHBuilderXCliCandidates(env = process.env, channel = resolveHBuilderXChannel(env["HBUILDERX_CHANNEL"]), platform = process.platform) {
69
69
  const defaults = platform === "darwin" ? channel === "stable" ? [macOSStableCli] : channel === "alpha" ? [macOSAlphaCli] : [macOSStableCli, macOSAlphaCli] : [];
70
- return unique([env.HBUILDERX_CLI_PATH, ...defaults].filter((item) => Boolean(item)));
70
+ return unique([env["HBUILDERX_CLI_PATH"], ...defaults].filter((item) => Boolean(item)));
71
71
  }
72
72
  function extractHBuilderXMacOSExecutables(output) {
73
73
  return unique(Array.from(output.matchAll(/(\/[^\r\n]*?HBuilderX(?:-Alpha|\s+Alpha)?\.app\/Contents\/MacOS\/HBuilderX)(?=\s|$)/gi), (match) => match[1]));
@@ -175,7 +175,7 @@ async function firstExisting(items) {
175
175
  }
176
176
  async function resolveHBuilderXCliInfoFromOptions(options = {}) {
177
177
  const env = options.env ?? process.env;
178
- const channel = resolveHBuilderXChannel(options.channel ?? env.HBUILDERX_CHANNEL);
178
+ const channel = resolveHBuilderXChannel(options.channel ?? env["HBUILDERX_CHANNEL"]);
179
179
  const running = await findRunningHBuilderXCliCandidates();
180
180
  const configured = await resolveConfiguredCli(options);
181
181
  if (configured) return {
@@ -330,37 +330,138 @@ function formatRecentLogs(logs, maxLength = 6e3) {
330
330
  return important.length > 0 ? `关键错误:\n${important.join("\n")}\n\n最近日志:\n${recent}` : recent;
331
331
  }
332
332
  //#endregion
333
- //#region src/process.ts
334
- var HBuilderXCommandError = class extends Error {
335
- result;
336
- constructor(message, result) {
337
- super(message);
338
- this.name = "HBuilderXCommandError";
339
- this.result = result;
340
- }
341
- };
342
- function killProcessTree(child, signal = "SIGTERM") {
343
- const pid = child.pid;
344
- if (!pid || child.exitCode != null) return;
333
+ //#region src/process/termination.ts
334
+ const ownedGroups = /* @__PURE__ */ new WeakMap();
335
+ const closedChildren = /* @__PURE__ */ new WeakSet();
336
+ const shutdownWaitMs = 1e3;
337
+ /** 只记录本次 spawn 创建的独立进程组,不从外部 PID 猜测组归属。 */
338
+ function registerProcessGroup(child, detached) {
339
+ if (process.platform !== "win32" && detached && child.pid) ownedGroups.set(child, child.pid);
340
+ child.once("close", () => {
341
+ closedChildren.add(child);
342
+ ownedGroups.delete(child);
343
+ });
344
+ }
345
+ function signalOwnedTree(child, signal, group) {
346
+ if (!child.pid) return;
345
347
  if (process.platform === "win32") {
346
- spawnSync("taskkill", [
348
+ if (child.exitCode !== null || child.signalCode !== null || closedChildren.has(child)) return;
349
+ const result = spawnSync("taskkill", [
347
350
  "/pid",
348
- String(pid),
351
+ String(child.pid),
349
352
  "/t",
350
353
  "/f"
351
354
  ], {
352
- stdio: "ignore",
355
+ timeout: 5e3,
356
+ killSignal: "SIGKILL",
357
+ maxBuffer: 65536,
358
+ encoding: "utf8",
359
+ stdio: [
360
+ "ignore",
361
+ "pipe",
362
+ "pipe"
363
+ ],
353
364
  windowsHide: true
354
365
  });
366
+ if (result.error || result.status !== 0) throw new Error(`taskkill pid=${child.pid} 失败,exit=${result.status} signal=${result.signal}\n${result.error?.message ?? ""}\n${result.stderr ?? ""}\n${result.stdout ?? ""}`, { cause: result.error });
355
367
  return;
356
368
  }
357
- try {
358
- process.kill(-pid, signal);
359
- } catch {
369
+ if (group) try {
370
+ process.kill(-group, signal);
371
+ return;
372
+ } catch (error) {
373
+ if (error.code !== "ESRCH") throw error;
374
+ }
375
+ if (!closedChildren.has(child) && child.exitCode === null && child.signalCode === null && !child.kill(signal)) throw new Error(`未能向子进程 pid=${child.pid} 发送 ${signal}`);
376
+ }
377
+ /** 同步入口在 close 后失效,避免稍后向复用的 PID 或进程组发送信号。 */
378
+ function signalProcessTree(child, signal) {
379
+ if (!closedChildren.has(child)) signalOwnedTree(child, signal, ownedGroups.get(child));
380
+ }
381
+ function waitForCleanup(closed, isGroupGone) {
382
+ return new Promise((resolve, reject) => {
383
+ let didClose = false;
384
+ let finished = false;
385
+ let lastProbeError;
386
+ const finish = (done, error) => {
387
+ finished = true;
388
+ clearTimeout(deadline);
389
+ clearInterval(poll);
390
+ if (error) reject(error);
391
+ else resolve(done);
392
+ };
393
+ const check = () => {
394
+ if (finished) return;
395
+ try {
396
+ const groupGone = isGroupGone();
397
+ lastProbeError = void 0;
398
+ if (didClose && groupGone) finish(true);
399
+ } catch (error) {
400
+ lastProbeError = error;
401
+ }
402
+ };
403
+ const expire = () => finish(false, lastProbeError);
404
+ const deadline = setTimeout(expire, shutdownWaitMs);
405
+ const poll = setInterval(check, 25);
406
+ closed.then(() => {
407
+ didClose = true;
408
+ check();
409
+ });
410
+ check();
411
+ });
412
+ }
413
+ /** 清理预算独立于业务超时;只持有本轮开始时仍有效的组归属。 */
414
+ async function stopProcessTree(child, closed, signal) {
415
+ let group = ownedGroups.get(child);
416
+ const errors = [];
417
+ const isGroupGone = () => {
418
+ if (!group) return true;
419
+ try {
420
+ process.kill(-group, 0);
421
+ return false;
422
+ } catch (error) {
423
+ if (error.code !== "ESRCH") throw error;
424
+ group = void 0;
425
+ ownedGroups.delete(child);
426
+ return true;
427
+ }
428
+ };
429
+ const signals = process.platform === "win32" || signal === "SIGKILL" ? [signal] : [signal, "SIGKILL"];
430
+ for (const nextSignal of signals) {
431
+ try {
432
+ signalOwnedTree(child, nextSignal, group);
433
+ } catch (error) {
434
+ errors.push(error);
435
+ }
360
436
  try {
361
- child.kill(signal);
362
- } catch {}
437
+ if (await waitForCleanup(closed, isGroupGone)) {
438
+ if (!errors.length) return;
439
+ break;
440
+ }
441
+ } catch (error) {
442
+ errors.push(error);
443
+ }
363
444
  }
445
+ const details = errors.map((error) => error instanceof Error ? error.message : String(error)).join("\n");
446
+ throw new AggregateError(errors, `子进程 pid=${child.pid ?? "unknown"} 的有界清理未成功:需确认 close 和本轮进程组结束\n${details}`.trim());
447
+ }
448
+ //#endregion
449
+ //#region src/process.ts
450
+ var HBuilderXCommandError = class extends Error {
451
+ result;
452
+ cleanupError;
453
+ constructor(message, result, cleanupError) {
454
+ super(message, cleanupError ? { cause: cleanupError } : void 0);
455
+ this.name = "HBuilderXCommandError";
456
+ this.result = result;
457
+ if (cleanupError) this.cleanupError = cleanupError;
458
+ }
459
+ };
460
+ /** 保留同步请求终止的兼容入口;需要确认关闭时必须等待 spawned.stop()。 */
461
+ function killProcessTree(child, signal = "SIGTERM") {
462
+ try {
463
+ signalProcessTree(child, signal);
464
+ } catch {}
364
465
  }
365
466
  function createCommandResult(options, exit, logs, timedOut = false) {
366
467
  const output = formatRecentLogs(logs);
@@ -374,21 +475,27 @@ function createCommandResult(options, exit, logs, timedOut = false) {
374
475
  issue: timedOut ? createTimeoutIssue() : classifyHBuilderXOutput(output)
375
476
  };
376
477
  }
377
- function buildCommandError(prefix, options, exit, logs, timedOut = false) {
478
+ function buildCommandError(prefix, options, exit, logs, timedOut = false, cleanupError) {
378
479
  const result = createCommandResult(options, exit, logs, timedOut);
480
+ if (cleanupError && !timedOut) result.issue = {
481
+ kind: "process-exit",
482
+ message: "子进程清理失败,未确认关闭或进程树终止。"
483
+ };
379
484
  return new HBuilderXCommandError([
380
485
  `${prefix}: ${options.command} ${options.args.join(" ")}`,
381
486
  `cwd=${options.cwd}`,
382
487
  `exit=${exit.signal ?? exit.code}`,
383
488
  `issue=${result.issue.kind}: ${result.issue.message}`,
384
489
  result.issue.hint ? `hint=${result.issue.hint}` : "",
385
- result.output
386
- ].filter(Boolean).join("\n"), result);
490
+ result.output,
491
+ cleanupError ? `cleanup=${cleanupError.message}` : ""
492
+ ].filter(Boolean).join("\n"), result, cleanupError);
387
493
  }
388
494
  function spawnCommand(options) {
495
+ const detached = options.detached ?? process.platform !== "win32";
389
496
  const child = spawn(options.command, options.args, {
390
497
  cwd: options.cwd,
391
- detached: options.detached ?? process.platform !== "win32",
498
+ detached,
392
499
  stdio: options.stdio === "inherit" ? "inherit" : [
393
500
  "ignore",
394
501
  "pipe",
@@ -397,14 +504,16 @@ function spawnCommand(options) {
397
504
  env: {
398
505
  ...process.env,
399
506
  ...options.env,
400
- NODE_OPTIONS: options.env?.NODE_OPTIONS ?? process.env.NODE_OPTIONS ?? "--max-old-space-size=8192"
507
+ NODE_OPTIONS: options.env?.["NODE_OPTIONS"] ?? process.env["NODE_OPTIONS"] ?? "--max-old-space-size=8192"
401
508
  }
402
509
  });
510
+ registerProcessGroup(child, detached);
403
511
  const logs = options.stdio === "inherit" ? [] : collectProcessOutput(child);
404
512
  child.on("error", (error) => logs.push(`${error.message}\n`));
405
513
  let exit;
514
+ let stopping;
406
515
  const closed = new Promise((resolve) => {
407
- child.on("close", (code, signal) => {
516
+ child.once("close", (code, signal) => {
408
517
  exit = {
409
518
  code,
410
519
  signal
@@ -422,9 +531,16 @@ function spawnCommand(options) {
422
531
  ensureRunning() {
423
532
  if (exit && exit.code !== 0) throw buildCommandError("命令提前退出", options, exit, logs);
424
533
  },
425
- async stop(signal = "SIGTERM") {
426
- killProcessTree(child, signal);
427
- await Promise.race([closed, wait(5e3)]);
534
+ stop(signal = "SIGTERM") {
535
+ if (stopping) return stopping;
536
+ if (exit) return Promise.resolve();
537
+ stopping = stopProcessTree(child, closed, signal).catch((error) => {
538
+ throw buildCommandError("命令清理失败", options, {
539
+ code: child.exitCode,
540
+ signal: child.signalCode
541
+ }, logs, false, error);
542
+ });
543
+ return stopping;
428
544
  }
429
545
  };
430
546
  }
@@ -433,19 +549,26 @@ async function runCommand(options) {
433
549
  let timer;
434
550
  let timedOut = false;
435
551
  try {
436
- const exit = await (options.timeoutMs == null ? spawned.closed : Promise.race([spawned.closed, new Promise((resolve) => {
552
+ const deadline = Symbol("deadline");
553
+ const outcome = await (options.timeoutMs == null ? spawned.closed : Promise.race([spawned.closed, new Promise((resolve) => {
437
554
  timer = setTimeout(() => {
438
555
  timedOut = true;
439
- killProcessTree(spawned.child);
440
- resolve({
441
- code: null,
442
- signal: "SIGTERM"
443
- });
556
+ resolve(deadline);
444
557
  }, options.timeoutMs);
445
558
  })]));
559
+ if (outcome === deadline) try {
560
+ await spawned.stop();
561
+ } catch (error) {
562
+ const cleanupError = error instanceof HBuilderXCommandError ? error.cleanupError ?? error : error;
563
+ throw buildCommandError("命令超时且清理失败", options, {
564
+ code: spawned.child.exitCode,
565
+ signal: spawned.child.signalCode
566
+ }, spawned.logs, true, cleanupError);
567
+ }
568
+ const exit = outcome === deadline ? await spawned.closed : outcome;
446
569
  const result = createCommandResult(options, exit, spawned.logs, timedOut);
447
- if (exit.code === 0 || options.allowFailure) return result;
448
- throw buildCommandError(options.timeoutMs != null && exit.code == null ? "命令超时" : "命令失败", options, exit, spawned.logs, timedOut);
570
+ if (!timedOut && exit.code === 0 || options.allowFailure) return result;
571
+ throw buildCommandError(timedOut ? "命令超时" : "命令失败", options, exit, spawned.logs, timedOut);
449
572
  } finally {
450
573
  if (timer) clearTimeout(timer);
451
574
  }
@@ -551,7 +674,7 @@ async function connectHBuilderXHost(options) {
551
674
  };
552
675
  const assertCommand = (result) => {
553
676
  if (result.issue.kind === "cli-instance-mismatch" || result.issue.kind === "cli-host-ambiguous") throw createRunnerError(cliPath, cwd, result.args, result.issue.kind, result.issue.message, result.issue.hint ?? "请检查目标 HBuilderX host。", logs);
554
- if (result.exit.code !== 0) throw new HBuilderXCommandError(`HBuilderX host 命令失败:${cliPath} ${result.args.join(" ")}\ncwd=${cwd}\nexit=${result.exit.signal ?? result.exit.code}\nissue=${result.issue.kind}\n${formatRecentLogs(logs)}`, result);
677
+ if (result.issue.kind === "timeout" || result.exit.code !== 0) throw new HBuilderXCommandError(`HBuilderX host 命令失败:${cliPath} ${result.args.join(" ")}\ncwd=${cwd}\nexit=${result.exit.signal ?? result.exit.code}\nissue=${result.issue.kind}\n${formatRecentLogs(logs)}`, result);
555
678
  };
556
679
  const probe = async () => {
557
680
  const listed = await command(["listhost"]);
@@ -620,11 +743,12 @@ async function createHBuilderXRunner(options = {}) {
620
743
  };
621
744
  const cwd = options.cwd ?? process.cwd();
622
745
  const timeoutMs = options.timeoutMs ?? defaultStartupTimeoutMs;
746
+ const candidates = options.hbuilderxCliPath ? [options.hbuilderxCliPath] : options.candidates;
623
747
  const resolveOptions = {
624
- candidates: options.hbuilderxCliPath ? [options.hbuilderxCliPath] : options.candidates,
625
- channel: options.channel,
748
+ ...candidates !== void 0 ? { candidates } : {},
749
+ ...options.channel !== void 0 ? { channel: options.channel } : {},
626
750
  env,
627
- host: options.host
751
+ ...options.host !== void 0 ? { host: options.host } : {}
628
752
  };
629
753
  const configured = await resolveConfiguredCli(resolveOptions);
630
754
  const resolution = configured ? {
@@ -635,15 +759,15 @@ async function createHBuilderXRunner(options = {}) {
635
759
  ...env,
636
760
  HBUILDERX_CLI_PATH: resolution.path
637
761
  };
638
- const requestedChannel = resolveHBuilderXChannel(options.channel ?? env.HBUILDERX_CHANNEL);
762
+ const requestedChannel = resolveHBuilderXChannel(options.channel ?? env["HBUILDERX_CHANNEL"]);
639
763
  const expectedChannel = resolution.channel !== "unknown" ? resolution.channel : requestedChannel === "auto" ? inferHBuilderXChannel(resolution.path) : requestedChannel;
640
- const explicitHost = options.host ?? env.HBUILDERX_HOST;
764
+ const explicitHost = options.host ?? env["HBUILDERX_HOST"];
641
765
  const selected = await connectHBuilderXHost({
642
766
  cliPath: resolution.path,
643
767
  cwd,
644
768
  env: cliEnv,
645
769
  expectedChannel,
646
- explicitHost,
770
+ ...explicitHost !== void 0 ? { explicitHost } : {},
647
771
  timeoutMs
648
772
  });
649
773
  const boundResolution = {
@@ -732,14 +856,14 @@ async function resolveHBuilderXCliInfo(candidatesOrOptions, env = process.env) {
732
856
  }
733
857
  async function resolveHBuilderXCli(candidatesOrOptions) {
734
858
  const options = Array.isArray(candidatesOrOptions) ? { candidates: candidatesOrOptions } : candidatesOrOptions ?? {};
735
- resolveHBuilderXChannel(options.channel ?? (options.env ?? process.env).HBUILDERX_CHANNEL);
859
+ resolveHBuilderXChannel(options.channel ?? (options.env ?? process.env)["HBUILDERX_CHANNEL"]);
736
860
  return (await resolveConfiguredCli(options))?.path ?? (await resolveHBuilderXCliInfoFromOptions(options)).path;
737
861
  }
738
862
  function createHBuilderXEnv(options = {}) {
739
863
  return {
740
864
  ...options.env,
741
- HBUILDERX_CLI_PATH: options.hbuilderxCliPath ?? options.env?.HBUILDERX_CLI_PATH ?? process.env.HBUILDERX_CLI_PATH ?? getDefaultHBuilderXCliCandidates()[0],
742
- NODE_OPTIONS: options.env?.NODE_OPTIONS ?? process.env.NODE_OPTIONS ?? "--max-old-space-size=8192"
865
+ HBUILDERX_CLI_PATH: options.hbuilderxCliPath ?? options.env?.["HBUILDERX_CLI_PATH"] ?? process.env["HBUILDERX_CLI_PATH"] ?? getDefaultHBuilderXCliCandidates()[0],
866
+ NODE_OPTIONS: options.env?.["NODE_OPTIONS"] ?? process.env["NODE_OPTIONS"] ?? "--max-old-space-size=8192"
743
867
  };
744
868
  }
745
869
  function hbuilderxPnpmArgs(args) {
@@ -754,8 +878,8 @@ async function runPnpmCommand(options) {
754
878
  command: "pnpm",
755
879
  args: options.args,
756
880
  cwd: options.cwd,
757
- timeoutMs: options.timeoutMs,
758
- allowFailure: options.allowFailure,
881
+ ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
882
+ ...options.allowFailure !== void 0 ? { allowFailure: options.allowFailure } : {},
759
883
  env: createHBuilderXEnv(options)
760
884
  });
761
885
  }
@@ -819,9 +943,9 @@ function resolveAdbCommand(env = process.env) {
819
943
  env: {}
820
944
  };
821
945
  const candidates = [
822
- env.ANDROID_HOME,
823
- env.ANDROID_SDK_ROOT,
824
- env.HOME ? path.join(env.HOME, "Library/Android/sdk") : void 0,
946
+ env["ANDROID_HOME"],
947
+ env["ANDROID_SDK_ROOT"],
948
+ env["HOME"] ? path.join(env["HOME"], "Library/Android/sdk") : void 0,
825
949
  "/opt/android-sdk",
826
950
  "/usr/local/share/android-sdk"
827
951
  ].filter((item) => Boolean(item));
@@ -832,9 +956,9 @@ function resolveAdbCommand(env = process.env) {
832
956
  command: adbPath,
833
957
  output: candidate.output,
834
958
  env: {
835
- ANDROID_HOME: env.ANDROID_HOME ?? sdkRoot,
836
- ANDROID_SDK_ROOT: env.ANDROID_SDK_ROOT ?? sdkRoot,
837
- PATH: `${path.dirname(adbPath)}${path.delimiter}${env.PATH ?? ""}`
959
+ ANDROID_HOME: env["ANDROID_HOME"] ?? sdkRoot,
960
+ ANDROID_SDK_ROOT: env["ANDROID_SDK_ROOT"] ?? sdkRoot,
961
+ PATH: `${path.dirname(adbPath)}${path.delimiter}${env["PATH"] ?? ""}`
838
962
  }
839
963
  };
840
964
  }
@@ -863,7 +987,7 @@ function assertIosSimulatorToolchain(env = process.env) {
863
987
  if (!simctl.ok || !xcodebuild.ok || firstLaunchStatus?.ok === false) throw new Error([
864
988
  "当前机器缺少 iOS 模拟器所需的完整 Xcode 工具链,无法运行 HBuilderX app-ios E2E。",
865
989
  `xcode-select: ${xcodeSelect.output || "unknown"}`,
866
- `DEVELOPER_DIR: ${env.DEVELOPER_DIR || "未设置"}`,
990
+ `DEVELOPER_DIR: ${env["DEVELOPER_DIR"] || "未设置"}`,
867
991
  `simctl: ${simctl.output || "not found"}`,
868
992
  `xcodebuild: ${xcodebuild.output || "not found"}`,
869
993
  `firstLaunchStatus: ${firstLaunchStatus?.output || (firstLaunchStatus?.ok === false ? "not ready" : "unknown")}`,
@@ -909,7 +1033,7 @@ function selectPreferredIosSimulatorDevice(devices) {
909
1033
  })[0];
910
1034
  }
911
1035
  function resolveIosSimulatorDeviceId(env = process.env) {
912
- const explicitDeviceId = env.E2E_HBUILDERX_IOS_DEVICE_ID;
1036
+ const explicitDeviceId = env["E2E_HBUILDERX_IOS_DEVICE_ID"];
913
1037
  if (explicitDeviceId) return explicitDeviceId;
914
1038
  const booted = runTool("xcrun", [
915
1039
  "simctl",
@@ -938,9 +1062,9 @@ function resolveIosSimulatorDeviceId(env = process.env) {
938
1062
  }
939
1063
  function resolveHdcCommand(env = process.env) {
940
1064
  const candidates = [
941
- env.DEMO_VISUAL_HARMONY_HDC_PATH,
942
- env.E2E_HBUILDERX_HARMONY_HDC_PATH,
943
- env.HDC_PATH,
1065
+ env["DEMO_VISUAL_HARMONY_HDC_PATH"],
1066
+ env["E2E_HBUILDERX_HARMONY_HDC_PATH"],
1067
+ env["HDC_PATH"],
944
1068
  "hdc",
945
1069
  process.platform === "darwin" ? "/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc" : void 0
946
1070
  ].filter((item) => Boolean(item));
package/package.json CHANGED
@@ -1,18 +1,18 @@
1
1
  {
2
2
  "name": "@weapp-tailwindcss/hbuilderx-runner",
3
3
  "type": "module",
4
- "version": "0.1.6",
4
+ "version": "0.1.7",
5
5
  "description": "HBuilderX runner utilities for cross-platform uni-app Tailwind CSS workflows. 跨端 uni-app Tailwind CSS 工作流的 HBuilderX 运行器工具。",
6
6
  "author": "ice breaker <1324318532@qq.com>",
7
7
  "license": "MIT",
8
8
  "homepage": "https://tw.weapp.dev/docs/quick-start/frameworks/hbuilderx",
9
9
  "repository": {
10
10
  "type": "git",
11
- "url": "git+https://github.com/sonofmagic/weapp-tailwindcss.git",
11
+ "url": "git+https://github.com/weapp-tailwindcss/weapp-tailwindcss.git",
12
12
  "directory": "packages/hbuilderx-runner"
13
13
  },
14
14
  "bugs": {
15
- "url": "https://github.com/sonofmagic/weapp-tailwindcss/issues"
15
+ "url": "https://github.com/weapp-tailwindcss/weapp-tailwindcss/issues"
16
16
  },
17
17
  "keywords": [
18
18
  "hbuilderx",
@@ -52,6 +52,7 @@
52
52
  "dev": "tsdown --watch --sourcemap",
53
53
  "build": "tsdown",
54
54
  "test": "vitest run",
55
+ "typecheck": "tsc -p tsconfig.json --pretty false",
55
56
  "test:dev": "vitest",
56
57
  "release": "pnpm publish",
57
58
  "lint": "eslint .",