qunitx-cli 0.23.1 → 0.23.2

package/README.md

@@ -115,7 +115,7 @@ What it does: cold-start cost dominates a single `qunitx` run — launching Chro
 
 A single one-off run won't get faster from spinning the daemon up; it's an opt-in optimization aimed at two situations:
 
-- **Local TDD loops.** Export `QUNITX_DAEMON=1` in your shell profile (or run `qunitx daemon start` once at the top of your session) and forget about it — subsequent runs reuse the daemon automatically until you `daemon stop` or 30 idle minutes pass.
+- **Local TDD loops.** Export `QUNITX_DAEMON=1` in your shell profile (or run `qunitx daemon start` once at the top of your session) and forget about it — subsequent runs reuse the daemon automatically until you `daemon stop` or 30 idle minutes pass. Override the idle window with `QUNITX_DAEMON_IDLE_TIMEOUT` (`1h`, `45s`, `500ms`; bare numbers are minutes), or set it to `false` to disable auto-shutdown entirely.
 - **Monorepo CI** where each package shells out to `qunitx` separately. Set `QUNITX_DAEMON=1` for the job and a single daemon is auto-spawned and reused across every package's invocation.
 
 ```sh

package/dist/cli.js

@@ -374,7 +374,7 @@ var init_package = __esm({
     package_default = {
       name: "qunitx-cli",
       type: "module",
-      version: "0.23.1",
+      version: "0.23.2",
       description: "Browser runner for QUnitx: run your qunitx tests in google-chrome",
       author: "Izel Nakri",
       license: "MIT",
@@ -748,6 +748,31 @@ var init_init = __esm({
   }
 });
 
+// lib/utils/parse-daemon-idle-timeout.ts
+function parseDaemonIdleTimeout(value) {
+  if (!value) return { ms: DEFAULT_DAEMON_IDLE_TIMEOUT_MS, warning: null };
+  if (/^\s*false\s*$/i.test(value)) return { ms: Infinity, warning: null };
+  const match = /^\s*(\d+(?:\.\d+)?)\s*(ms|s|m|h)?\s*$/i.exec(value);
+  if (!match) return invalid(value);
+  const n = Number(match[1]);
+  if (!(n > 0)) return invalid(value);
+  const unit = (match[2] ?? "m").toLowerCase();
+  return { ms: Math.round(n * UNIT_TO_MS[unit]), warning: null };
+}
+function invalid(value) {
+  return {
+    ms: DEFAULT_DAEMON_IDLE_TIMEOUT_MS,
+    warning: `\u26A0 qunitx: QUNITX_DAEMON_IDLE_TIMEOUT=${JSON.stringify(value)} is not a valid duration; using 30-minute default. Accepted: bare number = minutes, "30m", "1h", "45s", "500ms", "false" (no auto-shutdown).`
+  };
+}
+var UNIT_TO_MS, DEFAULT_DAEMON_IDLE_TIMEOUT_MS;
+var init_parse_daemon_idle_timeout = __esm({
+  "lib/utils/parse-daemon-idle-timeout.ts"() {
+    UNIT_TO_MS = { ms: 1, s: 1e3, m: 6e4, h: 36e5 };
+    DEFAULT_DAEMON_IDLE_TIMEOUT_MS = 30 * 60 * 1e3;
+  }
+});
+
 // lib/utils/close-with-grace.ts
 function closeWithGrace(closes, graceMs = CLEANUP_GRACE_MS) {
   return new Promise((resolve) => {
@@ -4461,6 +4486,7 @@ async function shutdownDaemon2(state, reason) {
 }
 function resetIdleTimer(state) {
   if (state.idleTimer) clearTimeout(state.idleTimer);
+  if (!Number.isFinite(IDLE_TIMEOUT_MS)) return;
   state.idleTimer = setTimeout(() => void shutdownDaemon2(state, "idle timeout"), IDLE_TIMEOUT_MS);
   state.idleTimer.unref();
 }
@@ -4634,12 +4660,13 @@ var IDLE_TIMEOUT_MS, LIVENESS_PROBE_TIMEOUT_MS, MAX_CONSECUTIVE_CRASHES;
 var init_server = __esm({
   "lib/commands/daemon/server.ts"() {
     init_daemon_socket_path();
+    init_parse_daemon_idle_timeout();
     init_socket_utils();
     init_config();
     init_browser();
     init_tests_in_browser();
     init_run();
-    IDLE_TIMEOUT_MS = 30 * 60 * 1e3;
+    IDLE_TIMEOUT_MS = parseDaemonIdleTimeout(process.env.QUNITX_DAEMON_IDLE_TIMEOUT).ms;
     LIVENESS_PROBE_TIMEOUT_MS = 500;
     MAX_CONSECUTIVE_CRASHES = 2;
   }
@@ -4690,6 +4717,8 @@ function waitForFile(filePath, timeoutMs) {
   });
 }
 async function spawnAndWaitForDaemon() {
+  const parsed = parseDaemonIdleTimeout(process.env.QUNITX_DAEMON_IDLE_TIMEOUT);
+  if (parsed.warning) process.stderr.write(parsed.warning + "\n");
   spawn3(process.execPath, [CLI_ENTRY, "daemon", "_serve"], {
     detached: true,
     stdio: "ignore",
@@ -4748,6 +4777,7 @@ var init_daemon = __esm({
   "lib/commands/daemon/index.ts"() {
     init_color();
     init_daemon_socket_path();
+    init_parse_daemon_idle_timeout();
     init_client();
     init_package();
     SPAWN_TIMEOUT_MS = 3e4;
@@ -4761,8 +4791,10 @@ ${color2("$ qunitx daemon stop")}     # Stop the running daemon
 ${color2("$ qunitx daemon status")}   # Print pid, socket, and uptime
 
 ${highlight2("Environment:")}
-${color2("QUNITX_DAEMON=1")}     : auto-spawn the daemon on the first qunitx run; reuse it on every run after (overrides the CI=1 bypass)
-${color2("QUNITX_NO_DAEMON=1")}  : never use the daemon for this run
+${color2("QUNITX_DAEMON=1")}              : auto-spawn the daemon on the first qunitx run; reuse it on every run after (overrides the CI=1 bypass)
+${color2("QUNITX_NO_DAEMON=1")}           : never use the daemon for this run
+${color2("QUNITX_DAEMON_IDLE_TIMEOUT")}   : idle window before self-shutdown (default 30m). Bare number = minutes; ${color2("ms")} / ${color2("s")} / ${color2("m")} / ${color2("h")} suffixes accepted (${color2("1h")}, ${color2("45s")}, ${color2("500ms")}). Set to ${color2("false")} to disable auto-shutdown. Read at daemon spawn; invalid values warn and fall back to the default.
+${color2("QUNITX_DAEMON_LOG=<path>")}     : redirect the daemon's stdout + stderr to a file (otherwise lost to the detached spawn)
 
 ${highlight2("Tip:")} set ${color2("QUNITX_DAEMON=1")} to auto-spawn the daemon on the first qunitx run; ${color2("$ qunitx --help")} for top-level options.
 `;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "qunitx-cli",
   "type": "module",
-  "version": "0.23.1",
+  "version": "0.23.2",
   "description": "Browser runner for QUnitx: run your qunitx tests in google-chrome",
   "author": "Izel Nakri",
   "license": "MIT",