@parall/parall 1.31.0 → 1.32.0

package/src/wiki-helper.ts

@@ -1,5 +1,5 @@
-import { spawn, spawnSync } from "node:child_process";
-import path from "node:path";
+import { spawn, spawnSync } from 'node:child_process';
+import path from 'node:path';
 
 type Logger = {
   info?: (message: string) => void;
@@ -26,7 +26,7 @@ const DEFAULT_SYNC_TIMEOUT_MS = 90_000; // includes npx cold-start download time
 const DEFAULT_WATCH_INTERVAL_SEC = 30;
 
 function isCommandMissing(error: unknown): boolean {
-  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+  return typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT';
 }
 
 // Prefer bare `parall` (globally installed in hosted images). Fall back to
@@ -34,16 +34,16 @@ function isCommandMissing(error: unknown): boolean {
 let _cli: { cmd: string; prefix: string[] } | undefined;
 function resolveParallCli(): { cmd: string; prefix: string[] } {
   if (!_cli) {
-    const r = spawnSync("parall", ["--version"], { stdio: "ignore", timeout: 5_000 });
+    const r = spawnSync('parall', ['--version'], { stdio: 'ignore', timeout: 5_000 });
     _cli = r.error
-      ? { cmd: "npx", prefix: ["--yes", "@parall/cli@latest"] }
-      : { cmd: "parall", prefix: [] };
+      ? { cmd: 'npx', prefix: ['--yes', '@parall/cli@latest'] }
+      : { cmd: 'parall', prefix: [] };
   }
   return _cli;
 }
 
 function resolveMountRoot(stateDir: string): string {
-  return process.env.PRLL_WIKI_MOUNT_ROOT?.trim() || path.join(stateDir, "workspace");
+  return process.env.PRLL_WIKI_MOUNT_ROOT?.trim() || path.join(stateDir, 'workspace');
 }
 
 function resolveWatchIntervalSec(): number {
@@ -66,18 +66,21 @@ function buildWikiHelperEnv(params: StartWikiHelperParams, mountRoot: string): N
   };
 }
 
-async function runWikiSync(params: StartWikiHelperParams, env: NodeJS.ProcessEnv): Promise<"ok" | "missing" | "failed"> {
+async function runWikiSync(
+  params: StartWikiHelperParams,
+  env: NodeJS.ProcessEnv,
+): Promise<'ok' | 'missing' | 'failed'> {
   return new Promise((resolve) => {
     let timedOut = false;
     let settled = false;
 
     const { cmd, prefix } = resolveParallCli();
-    const child = spawn(cmd, [...prefix, "wiki", "sync"], {
+    const child = spawn(cmd, [...prefix, 'wiki', 'sync'], {
       env,
-      stdio: "ignore",
+      stdio: 'ignore',
     });
 
-    const settle = (value: "ok" | "missing" | "failed") => {
+    const settle = (value: 'ok' | 'missing' | 'failed') => {
       if (settled) return;
       settled = true;
       resolve(value);
@@ -85,38 +88,44 @@ async function runWikiSync(params: StartWikiHelperParams, env: NodeJS.ProcessEnv
 
     const timer = setTimeout(() => {
       timedOut = true;
-      params.log?.warn?.(`parall[${params.accountId}]: parall sync timed out after ${DEFAULT_SYNC_TIMEOUT_MS}ms`);
-      child.kill("SIGTERM");
-      setTimeout(() => child.kill("SIGKILL"), 5_000).unref();
+      params.log?.warn?.(
+        `parall[${params.accountId}]: parall sync timed out after ${DEFAULT_SYNC_TIMEOUT_MS}ms`,
+      );
+      child.kill('SIGTERM');
+      setTimeout(() => child.kill('SIGKILL'), 5_000).unref();
     }, DEFAULT_SYNC_TIMEOUT_MS);
     timer.unref();
 
-    child.on("error", (error) => {
+    child.on('error', (error) => {
       clearTimeout(timer);
       if (isCommandMissing(error)) {
-        params.log?.warn?.(`parall[${params.accountId}]: parall not installed, skipping wiki auto-sync/watch`);
-        settle("missing");
+        params.log?.warn?.(
+          `parall[${params.accountId}]: parall not installed, skipping wiki auto-sync/watch`,
+        );
+        settle('missing');
         return;
       }
-      params.log?.warn?.(`parall[${params.accountId}]: parall sync failed to start: ${String(error)}`);
-      settle("failed");
+      params.log?.warn?.(
+        `parall[${params.accountId}]: parall sync failed to start: ${String(error)}`,
+      );
+      settle('failed');
     });
 
-    child.on("exit", (code, signal) => {
+    child.on('exit', (code, signal) => {
       clearTimeout(timer);
       if (timedOut) {
-        settle("failed");
+        settle('failed');
         return;
       }
       if (code === 0) {
         params.log?.info?.(`parall[${params.accountId}]: parall sync completed`);
-        settle("ok");
+        settle('ok');
         return;
       }
       params.log?.warn?.(
-        `parall[${params.accountId}]: parall sync exited with code=${code ?? "null"} signal=${signal ?? "null"}`,
+        `parall[${params.accountId}]: parall sync exited with code=${code ?? 'null'} signal=${signal ?? 'null'}`,
       );
-      settle("failed");
+      settle('failed');
     });
   });
 }
@@ -126,7 +135,7 @@ export async function startWikiHelper(params: StartWikiHelperParams): Promise<Wi
   const env = buildWikiHelperEnv(params, mountRoot);
 
   const syncResult = await runWikiSync(params, env);
-  if (syncResult === "missing") {
+  if (syncResult === 'missing') {
     return {
       mountRoot,
       stop() {},
@@ -136,36 +145,40 @@ export async function startWikiHelper(params: StartWikiHelperParams): Promise<Wi
   const intervalSec = resolveWatchIntervalSec();
   let stopped = false;
   const { cmd, prefix } = resolveParallCli();
-  const watch = spawn(cmd, [...prefix, "wiki", "watch", "--interval-sec", String(intervalSec)], {
+  const watch = spawn(cmd, [...prefix, 'wiki', 'watch', '--interval-sec', String(intervalSec)], {
     env,
-    stdio: "ignore",
+    stdio: 'ignore',
   });
 
-  watch.on("error", (error) => {
+  watch.on('error', (error) => {
     if (stopped) return;
     if (isCommandMissing(error)) {
-      params.log?.warn?.(`parall[${params.accountId}]: parall disappeared before watch could start`);
+      params.log?.warn?.(
+        `parall[${params.accountId}]: parall disappeared before watch could start`,
+      );
       return;
     }
     params.log?.warn?.(`parall[${params.accountId}]: parall watch failed: ${String(error)}`);
   });
 
-  watch.on("exit", (code, signal) => {
+  watch.on('exit', (code, signal) => {
     if (stopped) return;
     params.log?.warn?.(
-      `parall[${params.accountId}]: parall watch exited with code=${code ?? "null"} signal=${signal ?? "null"}`,
+      `parall[${params.accountId}]: parall watch exited with code=${code ?? 'null'} signal=${signal ?? 'null'}`,
     );
   });
 
-  params.log?.info?.(`parall[${params.accountId}]: parall watch started (interval=${intervalSec}s)`);
+  params.log?.info?.(
+    `parall[${params.accountId}]: parall watch started (interval=${intervalSec}s)`,
+  );
 
   return {
     mountRoot,
     stop() {
       stopped = true;
       if (watch.exitCode === null && watch.signalCode === null) {
-        watch.kill("SIGTERM");
-        setTimeout(() => watch.kill("SIGKILL"), 5_000).unref();
+        watch.kill('SIGTERM');
+        setTimeout(() => watch.kill('SIGKILL'), 5_000).unref();
       }
     },
   };