qunitx-cli 0.23.0 → 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.0",
+      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) => {
@@ -3573,19 +3598,26 @@ function setupFileWatchers(testFileLookupPaths, config, onEventFunc, onFinishFun
     const parentDir = path9.dirname(watchPath);
     const watchedBasename = path9.basename(watchPath);
     let parentUnlinkFired = false;
-    const parentWatcher = fs11.watch(parentDir, async (eventType, filename) => {
-      if (!ready || filename !== watchedBasename || eventType !== "rename") return;
-      if (parentUnlinkFired) return;
+    let rescanTimer = null;
+    const tryFireParentUnlink = async () => {
+      if (parentUnlinkFired) return false;
       parentUnlinkFired = true;
       try {
         await stat(watchPath);
         parentUnlinkFired = false;
+        return false;
       } catch {
         handleWatchEvent(config, extensions, "unlinkDir", watchPath, onEventFunc, onFinishFunc);
         childWatcher.close();
         parentWatcher.close();
+        if (rescanTimer) clearInterval(rescanTimer);
         delete fileWatchers[watchPath];
+        return true;
       }
+    };
+    const parentWatcher = fs11.watch(parentDir, async (eventType, filename) => {
+      if (!ready || filename !== watchedBasename || eventType !== "rename") return;
+      await tryFireParentUnlink();
     });
     parentWatchers.push(parentWatcher);
     fileWatchers[watchPath] = childWatcher;
@@ -3598,22 +3630,23 @@ function setupFileWatchers(testFileLookupPaths, config, onEventFunc, onFinishFun
       )
     );
     if (process.platform === "darwin") {
-      rescanTimers.push(
-        setInterval(() => {
-          if (!ready || rescanInProgress) return;
-          rescanInProgress = true;
-          rescanDirectoryForDelta(
-            watchPath,
-            config,
-            extensions,
-            onEventFunc,
-            onFinishFunc,
-            trackSymlink
-          ).finally(() => {
-            rescanInProgress = false;
-          });
-        }, RESCAN_INTERVAL_MS).unref()
-      );
+      rescanTimer = setInterval(async () => {
+        if (!ready || rescanInProgress || parentUnlinkFired) return;
+        if (await tryFireParentUnlink()) return;
+        rescanInProgress = true;
+        rescanDirectoryForDelta(
+          watchPath,
+          config,
+          extensions,
+          onEventFunc,
+          onFinishFunc,
+          trackSymlink
+        ).finally(() => {
+          rescanInProgress = false;
+        });
+      }, RESCAN_INTERVAL_MS);
+      rescanTimer.unref();
+      rescanTimers.push(rescanTimer);
     }
   }
   readyPromises.push(
@@ -4453,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();
 }
@@ -4626,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;
   }
@@ -4682,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",
@@ -4740,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;
@@ -4753,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.0",
+  "version": "0.23.2",
   "description": "Browser runner for QUnitx: run your qunitx tests in google-chrome",
   "author": "Izel Nakri",
   "license": "MIT",