Function bootProcesses

e2e/setup/boot.ts:68–161

(
  procs: ReadonlyArray<{
    readonly cmd: string;
    readonly args: ReadonlyArray<string>;
    readonly cwd: string;
    readonly env?: Record<string, string | undefined>;
    /** Append stdout+stderr here (long-lived boots need inspectable logs). */
    readonly logFile?: string;
  }>,
  options: { readonly label: string },
)

};

export const bootProcesses = (
  procs: ReadonlyArray<{
    readonly cmd: string;
    readonly args: ReadonlyArray<string>;
    readonly cwd: string;
    readonly env?: Record<string, string | undefined>;
    /** Append stdout+stderr here (long-lived boots need inspectable logs). */
    readonly logFile?: string;
  }>,
  options: { readonly label: string },
): MonitoredBootedProcesses => {
  const children: ChildProcess[] = [];
  let tearingDown = false;
  const unexpectedExits: Array<Promise<never>> = [];
  for (const proc of procs) {
    const log = proc.logFile ? openSync(proc.logFile, "a") : undefined;
    const child = spawn(proc.cmd, [...proc.args], {
      cwd: proc.cwd,
      env: { ...process.env, ...proc.env },
      stdio:
        log !== undefined ? ["ignore", log, log] : process.env.E2E_VERBOSE ? "inherit" : "ignore",
      // Own process group, so teardown can signal the whole tree — `bunx vite`
      // is a wrapper whose actual server child would otherwise outlive the
      // kill and squat the port into the NEXT invocation's waitForHttp.
      detached: true,
    });
    if (log !== undefined) closeSync(log);
    unexpectedExits.push(
      new Promise<never>((_resolve, reject) => {
        child.once("error", (cause) => {
          if (tearingDown) return;
          // oxlint-disable-next-line executor/no-promise-reject -- boundary: adapt the child-process error event to the startup race
          reject(
            new BootProcessExitError(
              [proc.cmd, ...proc.args].join(" "),
              child.exitCode,
              child.signalCode,
              `${readLogTail(proc.logFile)}\n${String(cause)}`.trim(),
            ),
          );
        });
        child.once("exit", (code, signal) => {
          if (tearingDown) return;
          const error = new BootProcessExitError(
            [proc.cmd, ...proc.args].join(" "),
            code,
            signal,
            readLogTail(proc.logFile),
          );
          console.error(`[e2e:${options.label}] ${error.message}`);
          // oxlint-disable-next-line executor/no-promise-reject -- boundary: adapt the child-process exit event to the startup race
          reject(error);
        });
      }),
    );
    children.push(child);
  }