Function setup

e2e/setup/selfhost.globalsetup.ts:24–59

()

  : resolve(RUNS_DIR, "selfhost", "server-logs", "boot.log");

export default async function setup(): Promise<(() => Promise<void>) | void> {
  if (process.env.E2E_SELFHOST_URL) {
    await waitForHttp(process.env.E2E_SELFHOST_URL);
    return;
  }

  if (bootLogFile) mkdirSync(resolve(bootLogFile, ".."), { recursive: true });

  // Claim a free port (preferred block first, walk forward past squatters),
  // boot, and retry on EADDRINUSE (a Linux-CI ephemeral socket can grab a
  // claimed port between probe and bind). The claimed port is published via env
  // so the test workers derive the same URL; the imported targets/selfhost
  // constants were computed BEFORE the claim — don't use them for ports here.
  const { teardown } = await claimAndBoot(
    [{ envVar: "E2E_SELFHOST_PORT", offset: 4, label: "selfhost vite dev" }],
    async (ports) => {
      const port = ports.E2E_SELFHOST_PORT!;
      // Shrink the sandbox execution budget and publish the value to the test
      // workers (spawned after this globalsetup, so they inherit the env): the
      // sandbox-deadline scenario reads it to scale its approval delays.
      process.env[SANDBOX_TIMEOUT_ENV] = String(E2E_SANDBOX_TIMEOUT_MS);
      // Fresh data dir per suite run — hermetic; in-suite isolation comes from
      // fresh identities, not resets (bootSelfhost wipes it).
      const procs = await bootSelfhost({
        port,
        webBaseUrl: `http://localhost:${port}`,
        admin: SELFHOST_ADMIN,
        logFile: bootLogFile,
        sandboxTimeoutMs: E2E_SANDBOX_TIMEOUT_MS,
      });
      return { teardown: procs.teardown, value: procs };
    },
    { label: "selfhost", retryWhen: isBootReadinessTimeout },
  );
  return teardown;
}