aboutsummaryrefslogtreecommitdiff
path: root/src/daemon/spawn.ts
blob: cea832597dc186543fc85c12504e094e446499e0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
import { spawn, type ChildProcess } from "node:child_process";
import { accessSync } from "node:fs";
import { access, unlink } from "node:fs/promises";
import { createRequire } from "node:module";
import { fileURLToPath } from "node:url";
import { dirname, join } from "node:path";
import { createConnection } from "node:net";
import { DAEMON_SOCKET_PATH, serialize, type WireControl } from "./protocol";

const moduleDir = dirname(fileURLToPath(import.meta.url));

const requireFromHere = createRequire(import.meta.url);

const isWindows = process.platform === "win32";

// No-op on Windows: a named pipe is not a filesystem entry and unlinking a pipe path throws.
const cleanupStaleSocket = (): void => {
  if (isWindows) return;
  unlink(DAEMON_SOCKET_PATH).catch(() => {});
};

export const daemonSocketMayExist = async (
  platform: NodeJS.Platform = process.platform,
  socketPath: string = DAEMON_SOCKET_PATH,
): Promise<boolean> => {
  if (platform === "win32") return true;
  try {
    await access(socketPath);
    return true;
  } catch {
    return false;
  }
};

export const isDaemonRunning = async (timeoutMs = 2_000): Promise<boolean> => {
  if (!(await daemonSocketMayExist())) return false;

  return new Promise((resolve) => {
    let settled = false;
    const done = (alive: boolean): void => {
      if (settled) return;
      settled = true;
      resolve(alive);
    };

    const sock = createConnection(DAEMON_SOCKET_PATH);
    const timer = setTimeout(() => {
      sock.destroy();
      cleanupStaleSocket();
      done(false);
    }, timeoutMs);

    sock.on("connect", () => {
      const regMsg: WireControl = { type: "control", action: "register", clientId: "_liveness_probe" };
      sock.write(serialize(regMsg) + "\n");
    });

    sock.on("data", (chunk: Buffer) => {
      const text = chunk.toString();
      if (text.includes('"registered"')) {
        clearTimeout(timer);
        const deregMsg: WireControl = { type: "control", action: "deregister", clientId: "_liveness_probe" };
        try { sock.write(serialize(deregMsg) + "\n"); } catch {}
        sock.destroy();
        done(true);
      }
    });

    sock.on("error", () => {
      clearTimeout(timer);
      sock.destroy();
      cleanupStaleSocket();
      done(false);
    });

    // Closed without a 'registered' ack: the daemon is alive but rejected us, so do NOT unlink its socket.
    sock.on("close", () => {
      clearTimeout(timer);
      done(false);
    });
  });
};

// Walks upward like Node's own node_modules lookup. Exported with an injectable start so the
// hoisted layout pi uses can be exercised against a fixture instead of this checkout.
export const resolveTsxCliFromFilesystem = (startDir: string = moduleDir): string | null => {
  let dir = startDir;

  while (true) {
    const candidate = join(dir, "node_modules", "tsx", "dist", "cli.mjs");
    try {
      accessSync(candidate);
      return candidate;
    } catch {
      // Keep walking toward the filesystem root. This mirrors Node's node_modules lookup
      // without relying on createRequire().resolve(), which is broken for external modules
      // loaded through jiti/static inside a Bun-compiled executable such as pi.exe.
    }

    const parent = dirname(dir);
    if (parent === dir) return null;
    dir = parent;
  }
};

const resolveTsxCli = (): string | null => {
  try {
    const resolved = requireFromHere.resolve("tsx/cli");
    // A compiled runtime may theoretically return a virtual path that a separately spawned
    // Node process cannot read. Only accept a resolver result that exists on the host FS.
    accessSync(resolved);
    return resolved;
  } catch {
    return resolveTsxCliFromFilesystem();
  }
};

export const daemonNodeExecutable = (
  env: NodeJS.ProcessEnv = process.env,
  versions: Readonly<Record<string, string | undefined>> = process.versions,
  platform: NodeJS.Platform = process.platform,
  execPath: string = process.execPath,
): string => {
  const override = env["PI_BROWSER_NODE"];
  if (override) return override;

  // Under normal Node keep the exact executable that launched pi/the extension. Under Bun,
  // process.execPath is bun/pi.exe, not Node, so run the tsx CLI with the required Node runtime.
  if ("bun" in versions) return platform === "win32" ? "node.exe" : "node";

  return execPath;
};

export const daemonSpawnCommand = (): { readonly command: string; readonly args: ReadonlyArray<string> } | null => {
  const daemonScript = join(moduleDir, "index.ts");
  const tsxCli = resolveTsxCli();
  if (!tsxCli) return null;

  return {
    command: daemonNodeExecutable(),
    args: [tsxCli, daemonScript],
  };
};

export const spawnDaemon = (): ChildProcess | null => {
  const spec = daemonSpawnCommand();
  if (!spec) return null;

  const child = spawn(spec.command, [...spec.args], {
    detached: true,
    stdio: "ignore",
    env: { ...process.env },
    windowsHide: true,
  });

  // `spawn` reports a missing executable (a bare `node` that is not on PATH under a Bun host)
  // asynchronously via `error`; without a listener that is an uncaught exception in pi.
  // ensureDaemon's poll loop reports the failure as a timeout, which is what the user sees.
  child.on("error", () => {});

  child.unref();
  return child;
};

export const ensureDaemon = async (timeoutMs = 10_000): Promise<boolean> => {
  if (await isDaemonRunning()) return true;

  const child = spawnDaemon();
  if (!child) return false;

  const deadline = Date.now() + timeoutMs;
  while (Date.now() < deadline) {
    if (await isDaemonRunning()) return true;
    await new Promise((r) => setTimeout(r, 200));
  }

  return false;
};