@warlock.js/core 5.32.0 → 5.34.0

package/esm/e2e/fixture.mjs

@@ -0,0 +1,195 @@
+import { OwnedProcess } from "./owned-process.mjs";
+import { delimiter, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { createServer } from "node:net";
+import { cp, lstat, mkdir, mkdtemp, readFile, realpath, rm, stat, symlink, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { setTimeout } from "node:timers/promises";
+
+//#region ../../packages/core/src/e2e/fixture.ts
+/** Deliberately does not inherit app secrets, NODE_OPTIONS, or service endpoints. */
+function isolatedEnvironment(directory, additions, paths = []) {
+	const env = {};
+	for (const key of [
+		"PATH",
+		"SystemRoot",
+		"WINDIR",
+		"COMSPEC",
+		"PATHEXT",
+		"LANG",
+		"LC_ALL",
+		"TZ"
+	]) if (process.env[key]) env[key] = process.env[key];
+	return {
+		...env,
+		...additions,
+		HOME: join(directory, "home"),
+		USERPROFILE: join(directory, "home"),
+		XDG_CONFIG_HOME: join(directory, "config"),
+		XDG_CACHE_HOME: join(directory, "cache"),
+		TMPDIR: join(directory, "tmp"),
+		TEMP: join(directory, "tmp"),
+		TMP: join(directory, "tmp"),
+		PATH: [...paths, env.PATH ?? ""].join(delimiter)
+	};
+}
+async function reservePort() {
+	const server = createServer();
+	await new Promise((accept, reject) => {
+		server.once("error", reject);
+		server.listen(0, "127.0.0.1", accept);
+	});
+	const address = server.address();
+	if (!address || typeof address === "string") throw new Error("Could not reserve an ephemeral fixture port");
+	return {
+		port: address.port,
+		release: () => new Promise((accept, reject) => server.close((error) => error ? reject(error) : accept()))
+	};
+}
+async function linkDependencies(source, target) {
+	let current = source;
+	while (true) {
+		const modules = join(current, "node_modules");
+		try {
+			if ((await stat(modules)).isDirectory()) {
+				await symlink(await realpath(modules), join(target, "node_modules"), process.platform === "win32" ? "junction" : "dir");
+				return;
+			}
+		} catch (error) {
+			if (!(error instanceof Error && "code" in error && error.code === "ENOENT")) throw error;
+		}
+		const parent = dirname(current);
+		if (parent === current) return;
+		current = parent;
+	}
+}
+var AppFixture = class AppFixture {
+	constructor(root, evidence) {
+		this.root = root;
+		this.evidence = evidence;
+		this.processes = [];
+	}
+	static async create(evidence) {
+		return new AppFixture(await mkdtemp(join(tmpdir(), "warlock-e2e-")), evidence);
+	}
+	async start(options, runOptions) {
+		runOptions.signal?.throwIfAborted();
+		const source = await realpath(resolve(options.directory ?? process.cwd()));
+		const directory = join(this.root, "app");
+		const dataRoot = join(this.root, "data");
+		const portFile = join(this.root, "port");
+		const output = relative(source, resolve(runOptions.outputDirectory ?? ".warlock/e2e"));
+		const excluded = [
+			"node_modules",
+			".git",
+			".warlock",
+			...output && !output.startsWith("..") && !isAbsolute(output) ? [output] : [],
+			...options.exclude ?? []
+		];
+		if (excluded.some((entry) => isAbsolute(entry) || entry.split(/[\\/]/).includes(".."))) throw new Error("Fixture exclusions must be relative paths without '..'");
+		await cp(source, directory, {
+			recursive: true,
+			dereference: false,
+			filter: async (file) => {
+				const path = relative(source, file);
+				if (!path) return true;
+				if (file === this.root || this.root.startsWith(`${file}${sep}`)) return false;
+				const segments = path.split(sep);
+				if (segments.some((entry) => entry === ".env" || entry.startsWith(".env."))) return false;
+				if (excluded.some((entry) => path === entry || path.startsWith(`${entry}${sep}`) || entry === "node_modules" && segments.includes(entry))) return false;
+				return !(await lstat(file).catch(() => void 0))?.isSymbolicLink();
+			}
+		});
+		await linkDependencies(source, directory);
+		for (const path of [
+			dataRoot,
+			"home",
+			"config",
+			"cache",
+			"tmp"
+		].map((path) => isAbsolute(path) ? path : join(this.root, path))) await mkdir(path, { recursive: true });
+		const reservation = await reservePort();
+		const context = {
+			directory,
+			dataRoot,
+			port: reservation.port,
+			url: `http://127.0.0.1:${reservation.port}`,
+			portFile
+		};
+		this.context = context;
+		try {
+			await options.prepare?.(context);
+			runOptions.signal?.throwIfAborted();
+			const additions = typeof options.env === "function" ? options.env(context) : options.env ?? {};
+			const env = isolatedEnvironment(this.root, {
+				NODE_ENV: "production",
+				...additions,
+				HOST: "127.0.0.1",
+				HTTP_HOST: "127.0.0.1",
+				PORT: String(options.portFromFile ? 0 : context.port),
+				HTTP_PORT: String(options.portFromFile ? 0 : context.port),
+				WARLOCK_E2E_DATA_ROOT: dataRoot,
+				WARLOCK_E2E_PORT_FILE: portFile
+			}, [...runOptions.path ?? [], ...options.path ?? []].map((path) => resolve(directory, path)));
+			await writeFile(join(directory, ".env"), Object.entries(env).map(([key, value]) => `${key}=${JSON.stringify(value ?? "")}`).join("\n") + "\n", { mode: 384 });
+			const timeoutMs = options.startupTimeoutMs ?? 3e4;
+			if (options.build) {
+				const command = typeof options.build === "function" ? options.build(context) : options.build;
+				const build = await OwnedProcess.start("build", command, directory, env, this.root, this.evidence.processes, (owned) => this.processes.push(owned));
+				await build.wait(timeoutMs, runOptions.signal);
+				await build.stop();
+			}
+			await reservation.release();
+			runOptions.signal?.throwIfAborted();
+			const command = typeof options.start === "function" ? options.start(context) : options.start ?? [process.execPath, "dist/app.js"];
+			const app = await OwnedProcess.start("app", command, directory, env, this.root, this.evidence.processes, (owned) => this.processes.push(owned));
+			const deadline = Date.now() + timeoutMs;
+			let reason = "No successful readiness response";
+			while (Date.now() < deadline) {
+				runOptions.signal?.throwIfAborted();
+				app.assertRunning();
+				try {
+					if (options.portFromFile) {
+						const port = Number((await readFile(portFile, "utf8")).trim());
+						if (!Number.isInteger(port) || port <= 0 || port > 65535) throw new Error("Port file must contain a bound TCP port between 1 and 65535");
+						context.port = port;
+						context.url = `http://127.0.0.1:${port}`;
+					}
+					const ready = new URL(options.readyPath ?? "/", context.url);
+					if (ready.origin !== context.url) throw new Error("Readiness URL must stay on the fixture origin");
+					const response = await fetch(ready, {
+						redirect: "manual",
+						signal: AbortSignal.timeout(Math.min(1e3, Math.max(1, deadline - Date.now())))
+					});
+					await response.body?.cancel();
+					if (response.status >= 200 && response.status < 400) {
+						await setTimeout(100);
+						app.assertRunning();
+						this.evidence.url = context.url;
+						return context;
+					}
+					reason = `Readiness HTTP ${response.status}`;
+				} catch (error) {
+					reason = String(error);
+				}
+				await setTimeout(50);
+			}
+			throw new Error(`App readiness timed out: ${reason}\n${app.logs().slice(-8e3)}`);
+		} finally {
+			await reservation.release().catch(() => {});
+		}
+	}
+	async stop() {
+		const errors = (await Promise.allSettled(this.processes.map((process) => process.stop()))).flatMap((result) => result.status === "rejected" ? [result.reason] : []);
+		if (errors.length) throw new AggregateError(errors, "Owned fixture teardown failed; disposable files retained for inspection: " + errors.map(String).join("; "));
+		await rm(this.root, {
+			recursive: true,
+			force: true,
+			maxRetries: 8,
+			retryDelay: 100
+		});
+	}
+};
+
+//#endregion
+export { AppFixture, isolatedEnvironment };
+//# sourceMappingURL=fixture.mjs.map

package/esm/e2e/fixture.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.mjs","names":["delay"],"sources":["../../../../../../../../packages/core/src/e2e/fixture.ts"],"sourcesContent":["import {\n  cp,\n  mkdir,\n  mkdtemp,\n  readFile,\n  realpath,\n  rm,\n  lstat,\n  stat,\n  symlink,\n  writeFile,\n} from \"node:fs/promises\";\nimport { createServer } from \"node:net\";\nimport { tmpdir } from \"node:os\";\nimport { delimiter, dirname, isAbsolute, join, relative, resolve, sep } from \"node:path\";\nimport { setTimeout as delay } from \"node:timers/promises\";\nimport { OwnedProcess } from \"./owned-process\";\nimport type {\n  AppFixtureOptions,\n  Command,\n  E2EEvidence,\n  FixtureContext,\n  RunE2EOptions,\n} from \"./types\";\n\n/** Deliberately does not inherit app secrets, NODE_OPTIONS, or service endpoints. */\nexport function isolatedEnvironment(\n  directory: string,\n  additions: Record<string, string>,\n  paths: string[] = [],\n): NodeJS.ProcessEnv {\n  const env: NodeJS.ProcessEnv = {};\n  for (const key of [\"PATH\", \"SystemRoot\", \"WINDIR\", \"COMSPEC\", \"PATHEXT\", \"LANG\", \"LC_ALL\", \"TZ\"])\n    if (process.env[key]) env[key] = process.env[key];\n  return {\n    ...env,\n    ...additions,\n    HOME: join(directory, \"home\"),\n    USERPROFILE: join(directory, \"home\"),\n    XDG_CONFIG_HOME: join(directory, \"config\"),\n    XDG_CACHE_HOME: join(directory, \"cache\"),\n    TMPDIR: join(directory, \"tmp\"),\n    TEMP: join(directory, \"tmp\"),\n    TMP: join(directory, \"tmp\"),\n    PATH: [...paths, env.PATH ?? \"\"].join(delimiter),\n  };\n}\n\nasync function reservePort(): Promise<{ port: number; release: () => Promise<void> }> {\n  const server = createServer();\n  await new Promise<void>((accept, reject) => {\n    server.once(\"error\", reject);\n    server.listen(0, \"127.0.0.1\", accept);\n  });\n  const address = server.address();\n  if (!address || typeof address === \"string\")\n    throw new Error(\"Could not reserve an ephemeral fixture port\");\n  return {\n    port: address.port,\n    release: () =>\n      new Promise<void>((accept, reject) =>\n        server.close((error) => (error ? reject(error) : accept())),\n      ),\n  };\n}\n\nasync function linkDependencies(source: string, target: string): Promise<void> {\n  // A workspace app may resolve dependencies from a parent node_modules.\n  let current = source;\n  while (true) {\n    const modules = join(current, \"node_modules\");\n    try {\n      if ((await stat(modules)).isDirectory()) {\n        await symlink(\n          await realpath(modules),\n          join(target, \"node_modules\"),\n          process.platform === \"win32\" ? \"junction\" : \"dir\",\n        );\n        return;\n      }\n    } catch (error) {\n      if (!(error instanceof Error && \"code\" in error && error.code === \"ENOENT\")) throw error;\n    }\n    const parent = dirname(current);\n    if (parent === current) return;\n    current = parent;\n  }\n}\n\nexport class AppFixture {\n  readonly processes: OwnedProcess[] = [];\n  context?: FixtureContext;\n  private constructor(\n    readonly root: string,\n    private evidence: E2EEvidence,\n  ) {}\n\n  static async create(evidence: E2EEvidence): Promise<AppFixture> {\n    return new AppFixture(await mkdtemp(join(tmpdir(), \"warlock-e2e-\")), evidence);\n  }\n\n  async start(options: AppFixtureOptions, runOptions: RunE2EOptions): Promise<FixtureContext> {\n    runOptions.signal?.throwIfAborted();\n    const source = await realpath(resolve(options.directory ?? process.cwd()));\n    const directory = join(this.root, \"app\");\n    const dataRoot = join(this.root, \"data\");\n    const portFile = join(this.root, \"port\");\n    const output = relative(source, resolve(runOptions.outputDirectory ?? \".warlock/e2e\"));\n    const excluded = [\n      \"node_modules\",\n      \".git\",\n      \".warlock\",\n      ...(output && !output.startsWith(\"..\") && !isAbsolute(output) ? [output] : []),\n      ...(options.exclude ?? []),\n    ];\n    if (excluded.some((entry) => isAbsolute(entry) || entry.split(/[\\\\/]/).includes(\"..\")))\n      throw new Error(\"Fixture exclusions must be relative paths without '..'\");\n    await cp(source, directory, {\n      recursive: true,\n      // Never copy dotenv files or follow symlinks into shared app data.\n      dereference: false,\n      filter: async (file) => {\n        const path = relative(source, file);\n        if (!path) return true;\n        if (file === this.root || this.root.startsWith(`${file}${sep}`)) return false;\n        const segments = path.split(sep);\n        if (segments.some((entry) => entry === \".env\" || entry.startsWith(\".env.\"))) return false;\n        if (\n          excluded.some(\n            (entry) =>\n              path === entry ||\n              path.startsWith(`${entry}${sep}`) ||\n              (entry === \"node_modules\" && segments.includes(entry)),\n          )\n        )\n          return false;\n        return !(await lstat(file).catch(() => undefined))?.isSymbolicLink();\n      },\n    });\n    // cp preserves links by default; reject app links to keep writes disposable.\n    // Dependencies are the sole explicit read-only-by-contract shared link.\n    await linkDependencies(source, directory);\n    for (const path of [dataRoot, \"home\", \"config\", \"cache\", \"tmp\"].map((path) =>\n      isAbsolute(path) ? path : join(this.root, path),\n    ))\n      await mkdir(path, { recursive: true });\n    const reservation = await reservePort();\n    const context: FixtureContext = {\n      directory,\n      dataRoot,\n      port: reservation.port,\n      url: `http://127.0.0.1:${reservation.port}`,\n      portFile,\n    };\n    this.context = context;\n    try {\n      await options.prepare?.(context);\n      runOptions.signal?.throwIfAborted();\n      const additions =\n        typeof options.env === \"function\" ? options.env(context) : (options.env ?? {});\n      const env = isolatedEnvironment(\n        this.root,\n        {\n          NODE_ENV: \"production\",\n          ...additions,\n          HOST: \"127.0.0.1\",\n          HTTP_HOST: \"127.0.0.1\",\n          PORT: String(options.portFromFile ? 0 : context.port),\n          HTTP_PORT: String(options.portFromFile ? 0 : context.port),\n          WARLOCK_E2E_DATA_ROOT: dataRoot,\n          WARLOCK_E2E_PORT_FILE: portFile,\n        },\n        [...(runOptions.path ?? []), ...(options.path ?? [])].map((path) =>\n          resolve(directory, path),\n        ),\n      );\n      // A framework env() consumer sees the same owned variables as process.env.\n      await writeFile(\n        join(directory, \".env\"),\n        Object.entries(env)\n          .map(([key, value]) => `${key}=${JSON.stringify(value ?? \"\")}`)\n          .join(\"\\n\") + \"\\n\",\n        { mode: 0o600 },\n      );\n      const timeoutMs = options.startupTimeoutMs ?? 30_000;\n      if (options.build) {\n        const command =\n          typeof options.build === \"function\" ? options.build(context) : options.build;\n        const build = await OwnedProcess.start(\n          \"build\",\n          command,\n          directory,\n          env,\n          this.root,\n          this.evidence.processes,\n          (owned) => this.processes.push(owned),\n        );\n        await build.wait(timeoutMs, runOptions.signal);\n        await build.stop();\n      }\n      await reservation.release();\n      runOptions.signal?.throwIfAborted();\n      const command: Command =\n        typeof options.start === \"function\"\n          ? options.start(context)\n          : (options.start ?? [process.execPath, \"dist/app.js\"]);\n      const app = await OwnedProcess.start(\n        \"app\",\n        command,\n        directory,\n        env,\n        this.root,\n        this.evidence.processes,\n        (owned) => this.processes.push(owned),\n      );\n      const deadline = Date.now() + timeoutMs;\n      let reason = \"No successful readiness response\";\n      while (Date.now() < deadline) {\n        runOptions.signal?.throwIfAborted();\n        app.assertRunning();\n        try {\n          if (options.portFromFile) {\n            const port = Number((await readFile(portFile, \"utf8\")).trim());\n            if (!Number.isInteger(port) || port <= 0 || port > 65535)\n              throw new Error(\"Port file must contain a bound TCP port between 1 and 65535\");\n            context.port = port;\n            context.url = `http://127.0.0.1:${port}`;\n          }\n          const ready = new URL(options.readyPath ?? \"/\", context.url);\n          if (ready.origin !== context.url)\n            throw new Error(\"Readiness URL must stay on the fixture origin\");\n          const response = await fetch(ready, {\n            redirect: \"manual\",\n            signal: AbortSignal.timeout(Math.min(1000, Math.max(1, deadline - Date.now()))),\n          });\n          await response.body?.cancel();\n          if (response.status >= 200 && response.status < 400) {\n            // Give foreground startup failures a chance to arrive over IPC.\n            await delay(100);\n            app.assertRunning();\n            this.evidence.url = context.url;\n            return context;\n          }\n          reason = `Readiness HTTP ${response.status}`;\n        } catch (error) {\n          reason = String(error);\n        }\n        await delay(50);\n      }\n      throw new Error(`App readiness timed out: ${reason}\\n${app.logs().slice(-8000)}`);\n    } finally {\n      await reservation.release().catch(() => {});\n    }\n  }\n\n  async stop(): Promise<void> {\n    const results = await Promise.allSettled(this.processes.map((process) => process.stop()));\n    const errors = results.flatMap((result) =>\n      result.status === \"rejected\" ? [result.reason] : [],\n    );\n    if (errors.length)\n      throw new AggregateError(\n        errors,\n        \"Owned fixture teardown failed; disposable files retained for inspection: \" +\n          errors.map(String).join(\"; \"),\n      );\n    await rm(this.root, { recursive: true, force: true, maxRetries: 8, retryDelay: 100 });\n  }\n}\n"],"mappings":"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"}

package/esm/e2e/index.d.mts

@@ -0,0 +1,5 @@
+import { BrowserPage } from "./page.mjs";
+import { AppFixtureOptions, BrowserOptions, Command, ConsoleEntry, E2EContext, E2EEvidence, E2ESpec, FixtureContext, NetworkAllowance, NetworkFailure, Pattern, ProcessEvidence, RunE2EOptions, StepEvidence, Viewport, defaultViewports, defineE2E } from "./types.mjs";
+import { findBrowserBinary } from "./browser.mjs";
+import { E2EResult, E2ERunError, runE2E } from "./run-e2e.mjs";
+export { type AppFixtureOptions, type BrowserOptions, BrowserPage, type Command, type ConsoleEntry, type E2EContext, type E2EEvidence, type E2EResult, E2ERunError, type E2ESpec, type FixtureContext, type NetworkAllowance, type NetworkFailure, type Pattern, type ProcessEvidence, type RunE2EOptions, type StepEvidence, type Viewport, defaultViewports, defineE2E, findBrowserBinary, runE2E };

package/esm/e2e/index.mjs

@@ -0,0 +1,6 @@
+import { findBrowserBinary } from "./browser.mjs";
+import { defaultViewports, defineE2E } from "./types.mjs";
+import { BrowserPage } from "./page.mjs";
+import { E2ERunError, runE2E } from "./run-e2e.mjs";
+
+export { BrowserPage, E2ERunError, defaultViewports, defineE2E, findBrowserBinary, runE2E };

package/esm/e2e/owned-process.mjs

@@ -0,0 +1,193 @@
+import { randomUUID } from "node:crypto";
+import { join } from "node:path";
+import { readFile, writeFile } from "node:fs/promises";
+import { execFile, spawn } from "node:child_process";
+import { setTimeout as setTimeout$1 } from "node:timers/promises";
+
+//#region ../../packages/core/src/e2e/owned-process.ts
+const supervisorSource = `
+import { spawn } from 'node:child_process';
+process.on('SIGTERM', () => {});
+process.on('SIGINT', () => {});
+process.on('message', ({command}) => {
+  const child = spawn(command[0], command.slice(1), {cwd:process.cwd(),env:process.env,stdio:'inherit'});
+  child.once('spawn', () => process.send?.({type:'started',pid:child.pid}));
+  child.once('error', error => process.send?.({type:'failure',message:error.message}));
+  child.once('exit', (code,signal) => process.send?.({type:'exit',code,signal}));
+});
+`;
+/** Small OS identity queries; every helper PID is retained as evidence too. */
+function utility(command, args, records) {
+	return new Promise((resolve, reject) => {
+		const child = execFile(command, args, { encoding: "utf8" }, (error, stdout) => {
+			if (record) record.stopped = true;
+			if (error) reject(error);
+			else resolve(stdout);
+		});
+		const record = child.pid ? {
+			role: "process-identity",
+			pid: child.pid,
+			command: [command, ...args],
+			ownerFile: ""
+		} : void 0;
+		if (record) records.push(record);
+	});
+}
+function commandLineOwns(commandLine, ownerFile) {
+	if (commandLine.includes("\0")) return commandLine.split("\0").includes(ownerFile);
+	return commandLine.includes(ownerFile);
+}
+var OwnedProcess = class OwnedProcess {
+	constructor(child, record, records) {
+		this.child = child;
+		this.records = records;
+		this.output = "";
+		this.record = record;
+		records.push(record);
+		const append = (chunk) => {
+			this.output = (this.output + chunk.toString()).slice(-1e6);
+		};
+		child.stdout?.on("data", append);
+		child.stderr?.on("data", append);
+		child.on("message", (message) => {
+			const data = message;
+			if (data.type === "exit") this.finished = {
+				code: data.code ?? null,
+				signal: data.signal ?? null
+			};
+		});
+	}
+	static async start(role, command, directory, env, ownerDirectory, records, onCreated) {
+		const ownerFile = join(ownerDirectory, `owner-${randomUUID()}.mjs`);
+		await writeFile(ownerFile, supervisorSource, { mode: 384 });
+		const child = spawn(process.execPath, [ownerFile], {
+			cwd: directory,
+			env,
+			detached: process.platform !== "win32",
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe",
+				"ipc"
+			]
+		});
+		if (!child.pid) {
+			await new Promise((_resolve, reject) => child.once("error", reject));
+			throw new Error(`Could not start ${role}`);
+		}
+		const owned = new OwnedProcess(child, {
+			role,
+			pid: child.pid,
+			command: [...command],
+			ownerFile
+		}, records);
+		onCreated?.(owned);
+		try {
+			await new Promise((resolve, reject) => {
+				const cleanup = () => {
+					clearTimeout(timer);
+					child.removeListener("message", message);
+					child.removeListener("error", failed);
+					child.removeListener("exit", exited);
+				};
+				const failed = (error) => {
+					cleanup();
+					reject(error);
+				};
+				const exited = () => failed(/* @__PURE__ */ new Error(`${role} supervisor exited before startup`));
+				const message = (value) => {
+					const data = value;
+					if (data.type === "started" && typeof data.pid === "number") {
+						owned.record.childPid = data.pid;
+						cleanup();
+						resolve();
+					}
+					if (data.type === "failure") failed(/* @__PURE__ */ new Error(`${role}: ${data.message}`));
+				};
+				const timer = setTimeout(() => failed(/* @__PURE__ */ new Error(`${role} process startup timed out`)), 1e4);
+				child.on("message", message);
+				child.once("error", failed);
+				child.once("exit", exited);
+				child.send({ command }, (error) => {
+					if (error) failed(error);
+				});
+			});
+			return owned;
+		} catch (error) {
+			try {
+				await owned.stop();
+			} catch (cleanup) {
+				throw new AggregateError([error, cleanup], `Process startup and verified cleanup failed: ${String(error)}; ${String(cleanup)}`);
+			}
+			throw error;
+		}
+	}
+	logs() {
+		return this.output;
+	}
+	assertRunning() {
+		if (this.finished || this.child.exitCode !== null || this.child.signalCode !== null) throw new Error(`${this.record.role} exited: ${JSON.stringify(this.finished)}\n${this.output.slice(-8e3)}`);
+	}
+	async wait(timeoutMs, signal) {
+		const deadline = Date.now() + timeoutMs;
+		while (!this.finished && Date.now() < deadline) {
+			signal?.throwIfAborted();
+			await setTimeout$1(25);
+		}
+		if (!this.finished) throw new Error(`${this.record.role} timed out after ${timeoutMs}ms\n${this.output.slice(-8e3)}`);
+		if (this.finished.code !== 0) throw new Error(`${this.record.role} failed: ${JSON.stringify(this.finished)}\n${this.output.slice(-8e3)}`);
+	}
+	async verify() {
+		if (this.child.exitCode !== null || this.child.signalCode !== null) throw new Error(`Refusing cleanup: ${this.record.role} group anchor ${this.record.pid} exited unexpectedly`);
+		let commandLine;
+		if (process.platform === "linux") commandLine = await readFile(`/proc/${this.record.pid}/cmdline`, "utf8");
+		else if (process.platform === "win32") commandLine = await utility("powershell.exe", [
+			"-NoProfile",
+			"-NonInteractive",
+			"-Command",
+			`(Get-CimInstance Win32_Process -Filter 'ProcessId = ${this.record.pid}').CommandLine`
+		], this.records);
+		else commandLine = await utility("/bin/ps", [
+			"-p",
+			String(this.record.pid),
+			"-o",
+			"command="
+		], this.records);
+		if (!commandLineOwns(commandLine, this.record.ownerFile)) throw new Error(`Refusing cleanup: PID ${this.record.pid} command line does not contain its recorded owner file`);
+	}
+	stop() {
+		this.stopping ??= this.stopOwnedGroup().catch((error) => {
+			this.stopping = void 0;
+			throw error;
+		});
+		return this.stopping;
+	}
+	async stopOwnedGroup() {
+		await this.verify();
+		const exited = new Promise((resolve) => this.child.once("exit", () => resolve()));
+		if (process.platform === "win32") await utility("taskkill.exe", [
+			"/PID",
+			String(this.record.pid),
+			"/T",
+			"/F"
+		], this.records);
+		else {
+			process.kill(-this.record.pid, "SIGTERM");
+			await setTimeout$1(250);
+			await this.verify();
+			process.kill(-this.record.pid, "SIGKILL");
+		}
+		await new Promise((resolve, reject) => {
+			const timer = setTimeout(() => reject(/* @__PURE__ */ new Error(`Owned ${this.record.role} PID ${this.record.pid} did not exit`)), 5e3);
+			exited.then(() => {
+				clearTimeout(timer);
+				resolve();
+			});
+		});
+		this.record.stopped = true;
+	}
+};
+
+//#endregion
+export { OwnedProcess, commandLineOwns };
+//# sourceMappingURL=owned-process.mjs.map

package/esm/e2e/owned-process.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-process.mjs","names":["delay"],"sources":["../../../../../../../../packages/core/src/e2e/owned-process.ts"],"sourcesContent":["import { execFile, spawn, type ChildProcess } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { readFile, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { setTimeout as delay } from \"node:timers/promises\";\nimport type { Command, ProcessEvidence } from \"./types\";\n\n// A group anchor stays alive after the foreground command exits. This lets\n// teardown verify a live, unique command line before BOTH TERM and KILL,\n// including when the app crashed but left descendants behind.\nconst supervisorSource = `\nimport { spawn } from 'node:child_process';\nprocess.on('SIGTERM', () => {});\nprocess.on('SIGINT', () => {});\nprocess.on('message', ({command}) => {\n  const child = spawn(command[0], command.slice(1), {cwd:process.cwd(),env:process.env,stdio:'inherit'});\n  child.once('spawn', () => process.send?.({type:'started',pid:child.pid}));\n  child.once('error', error => process.send?.({type:'failure',message:error.message}));\n  child.once('exit', (code,signal) => process.send?.({type:'exit',code,signal}));\n});\n`;\n\n/** Small OS identity queries; every helper PID is retained as evidence too. */\nfunction utility(command: string, args: string[], records: ProcessEvidence[]): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const child = execFile(command, args, { encoding: \"utf8\" }, (error, stdout) => {\n      if (record) record.stopped = true;\n      if (error) reject(error);\n      else resolve(stdout);\n    });\n    const record: ProcessEvidence | undefined = child.pid\n      ? { role: \"process-identity\", pid: child.pid, command: [command, ...args], ownerFile: \"\" }\n      : undefined;\n    if (record) records.push(record);\n  });\n}\n\nexport function commandLineOwns(commandLine: string, ownerFile: string): boolean {\n  if (commandLine.includes(\"\\0\")) return commandLine.split(\"\\0\").includes(ownerFile);\n  // ps/CIM expose a rendered command line; the random owner path is unique\n  // to this child, never an app name, binary name, PID search, or a port.\n  return commandLine.includes(ownerFile);\n}\n\nexport class OwnedProcess {\n  readonly record: ProcessEvidence;\n  private output = \"\";\n  private finished?: { code: number | null; signal: string | null };\n  private stopping?: Promise<void>;\n  private constructor(\n    private child: ChildProcess,\n    record: ProcessEvidence,\n    private records: ProcessEvidence[],\n  ) {\n    this.record = record;\n    records.push(record);\n    const append = (chunk: Buffer) => {\n      this.output = (this.output + chunk.toString()).slice(-1_000_000);\n    };\n    child.stdout?.on(\"data\", append);\n    child.stderr?.on(\"data\", append);\n    child.on(\"message\", (message: unknown) => {\n      const data = message as { type?: string; code?: number | null; signal?: string | null };\n      if (data.type === \"exit\")\n        this.finished = { code: data.code ?? null, signal: data.signal ?? null };\n    });\n  }\n\n  static async start(\n    role: string,\n    command: Command,\n    directory: string,\n    env: NodeJS.ProcessEnv,\n    ownerDirectory: string,\n    records: ProcessEvidence[],\n    onCreated?: (owned: OwnedProcess) => void,\n  ): Promise<OwnedProcess> {\n    const ownerFile = join(ownerDirectory, `owner-${randomUUID()}.mjs`);\n    await writeFile(ownerFile, supervisorSource, { mode: 0o600 });\n    // detached makes the recorded supervisor PID its process-group ID on POSIX.\n    // https://nodejs.org/download/release/v22.15.0/docs/api/child_process.html#optionsdetached\n    const child = spawn(process.execPath, [ownerFile], {\n      cwd: directory,\n      env,\n      detached: process.platform !== \"win32\",\n      stdio: [\"ignore\", \"pipe\", \"pipe\", \"ipc\"],\n    });\n    if (!child.pid) {\n      await new Promise<never>((_resolve, reject) => child.once(\"error\", reject));\n      throw new Error(`Could not start ${role}`);\n    }\n    const owned = new OwnedProcess(\n      child,\n      { role, pid: child.pid, command: [...command], ownerFile },\n      records,\n    );\n    onCreated?.(owned);\n    try {\n      await new Promise<void>((resolve, reject) => {\n        const cleanup = () => {\n          clearTimeout(timer);\n          child.removeListener(\"message\", message);\n          child.removeListener(\"error\", failed);\n          child.removeListener(\"exit\", exited);\n        };\n        const failed = (error: Error) => {\n          cleanup();\n          reject(error);\n        };\n        const exited = () => failed(new Error(`${role} supervisor exited before startup`));\n        const message = (value: unknown) => {\n          const data = value as { type?: string; pid?: number; message?: string };\n          if (data.type === \"started\" && typeof data.pid === \"number\") {\n            owned.record.childPid = data.pid;\n            cleanup();\n            resolve();\n          }\n          if (data.type === \"failure\") failed(new Error(`${role}: ${data.message}`));\n        };\n        const timer = setTimeout(\n          () => failed(new Error(`${role} process startup timed out`)),\n          10_000,\n        );\n        child.on(\"message\", message);\n        child.once(\"error\", failed);\n        child.once(\"exit\", exited);\n        child.send({ command }, (error) => {\n          if (error) failed(error);\n        });\n      });\n      return owned;\n    } catch (error) {\n      try {\n        await owned.stop();\n      } catch (cleanup) {\n        throw new AggregateError(\n          [error, cleanup],\n          `Process startup and verified cleanup failed: ${String(error)}; ${String(cleanup)}`,\n        );\n      }\n      throw error;\n    }\n  }\n\n  logs(): string {\n    return this.output;\n  }\n\n  assertRunning(): void {\n    if (this.finished || this.child.exitCode !== null || this.child.signalCode !== null) {\n      throw new Error(\n        `${this.record.role} exited: ${JSON.stringify(this.finished)}\\n${this.output.slice(-8000)}`,\n      );\n    }\n  }\n\n  async wait(timeoutMs: number, signal?: AbortSignal): Promise<void> {\n    const deadline = Date.now() + timeoutMs;\n    while (!this.finished && Date.now() < deadline) {\n      signal?.throwIfAborted();\n      await delay(25);\n    }\n    if (!this.finished)\n      throw new Error(\n        `${this.record.role} timed out after ${timeoutMs}ms\\n${this.output.slice(-8000)}`,\n      );\n    if (this.finished.code !== 0)\n      throw new Error(\n        `${this.record.role} failed: ${JSON.stringify(this.finished)}\\n${this.output.slice(-8000)}`,\n      );\n  }\n\n  private async verify(): Promise<void> {\n    if (this.child.exitCode !== null || this.child.signalCode !== null)\n      throw new Error(\n        `Refusing cleanup: ${this.record.role} group anchor ${this.record.pid} exited unexpectedly`,\n      );\n    let commandLine: string;\n    if (process.platform === \"linux\")\n      commandLine = await readFile(`/proc/${this.record.pid}/cmdline`, \"utf8\");\n    else if (process.platform === \"win32\") {\n      // PID is from spawn, interpolated as a number; no user text enters PowerShell.\n      // https://learn.microsoft.com/en-us/windows/win32/cimwin32prov/win32-process\n      commandLine = await utility(\n        \"powershell.exe\",\n        [\n          \"-NoProfile\",\n          \"-NonInteractive\",\n          \"-Command\",\n          `(Get-CimInstance Win32_Process -Filter 'ProcessId = ${this.record.pid}').CommandLine`,\n        ],\n        this.records,\n      );\n    } else\n      commandLine = await utility(\n        \"/bin/ps\",\n        [\"-p\", String(this.record.pid), \"-o\", \"command=\"],\n        this.records,\n      );\n    if (!commandLineOwns(commandLine, this.record.ownerFile))\n      throw new Error(\n        `Refusing cleanup: PID ${this.record.pid} command line does not contain its recorded owner file`,\n      );\n  }\n\n  stop(): Promise<void> {\n    this.stopping ??= this.stopOwnedGroup().catch((error: unknown) => {\n      this.stopping = undefined;\n      throw error;\n    });\n    return this.stopping;\n  }\n\n  private async stopOwnedGroup(): Promise<void> {\n    await this.verify();\n    const exited = new Promise<void>((resolve) => this.child.once(\"exit\", () => resolve()));\n    if (process.platform === \"win32\") {\n      // Windows has no POSIX process groups. /T targets this verified PID's tree.\n      // https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/taskkill\n      await utility(\"taskkill.exe\", [\"/PID\", String(this.record.pid), \"/T\", \"/F\"], this.records);\n    } else {\n      process.kill(-this.record.pid, \"SIGTERM\");\n      await delay(250);\n      await this.verify();\n      process.kill(-this.record.pid, \"SIGKILL\");\n    }\n    await new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(\n        () => reject(new Error(`Owned ${this.record.role} PID ${this.record.pid} did not exit`)),\n        5000,\n      );\n      void exited.then(() => {\n        clearTimeout(timer);\n        resolve();\n      });\n    });\n    this.record.stopped = true;\n  }\n}\n"],"mappings":"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"}

package/esm/e2e/page.d.mts

@@ -0,0 +1,64 @@
+import { CdpConnection } from "./cdp.mjs";
+import { E2EEvidence, E2ESpec, Viewport } from "./types.mjs";
+//#region ../../packages/core/src/e2e/page.d.ts
+type WaitOptions = {
+  selector?: string;
+  text?: string;
+  url?: string;
+  timeoutMs?: number;
+};
+type ViewportReport = {
+  requestedWidth: number;
+  innerWidth: number;
+  documentWidth: number;
+  bodyWidth: number;
+  offenders: {
+    tag: string;
+    id: string;
+    className: string;
+    width: number;
+    scrollWidth: number;
+    right: number;
+    left: number;
+  }[];
+};
+export declare class BrowserPage {
+  private cdp;
+  private origin;
+  private outputDirectory;
+  private evidence;
+  private spec;
+  private viewport;
+  private loads;
+  private pendingRequests;
+  private requestUrls;
+  private lastNetworkActivity;
+  constructor(cdp: CdpConnection, origin: string, outputDirectory: string, evidence: E2EEvidence, spec: E2ESpec);
+  private completeRequest;
+  initialize(): Promise<void>;
+  step<T>(name: string, action: () => Promise<T>): Promise<T>;
+  evaluate<T = unknown>(expression: string, timeoutMs?: number): Promise<T>;
+  private poll;
+  goto(path: string, timeoutMs?: number): Promise<void>;
+  waitFor(options: WaitOptions): Promise<void>;
+  /** Arms the document/URL comparison BEFORE invoking the navigation action,
+   * covering full loads, reloads, hash changes and client-side routing.
+   */
+  waitForNavigation(action: () => Promise<unknown>, options?: {
+    url?: string;
+    timeoutMs?: number;
+  }): Promise<void>;
+  click(selector: string, timeoutMs?: number): Promise<void>;
+  fill(selector: string, value: string): Promise<void>;
+  /** Appends Unicode text through the browser's text-input path. */
+  type(selector: string, text: string): Promise<void>;
+  setViewport(viewport: Viewport): Promise<void>;
+  assertViewport(): Promise<ViewportReport>;
+  screenshot(name: string): Promise<string>;
+  captureViewports(name: string, viewports?: readonly Viewport[]): Promise<void>;
+  waitForNetworkIdle(timeoutMs?: number): Promise<void>;
+  assertHealthy(): void;
+}
+//#endregion
+export {};
+//# sourceMappingURL=page.d.mts.map

package/esm/e2e/page.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/e2e/page.ts"],"mappings":";;;KAaK;EAAgB;EAAmB;EAAe;EAAc;;KAEhE;EACH;EACA;EACA;EACA;EACA;IACE;IACA;IACA;IACA;IACA;IACA;IACA;;;qBAuDS;UAQD;UACA;UACA;UACA;UACA;UAXF;UACA;UACA;UACA;UACA;EAER,YACU,KAAK,eACL,gBACA,yBACA,UAAU,aACV,MAAM;UAgDR;EAMF,cAAc;EAQd,KAAK,GAAG,cAAc,cAAc,QAAQ,KAAK,QAAQ;EAqBzD,SAAS,aAAa,oBAAoB,qBAAqB,QAAQ;UAa/D;EAkBR,KAAK,cAAc,qBAAqB;EAkBxC,QAAQ,SAAS,cAAc;;;;EA0B/B,kBACJ,cAAc,kBACd;IAAW;IAAc;MACxB;EAkBG,MAAM,kBAAkB,qBAAqB;EA2E7C,KAAK,kBAAkB,gBAAgB;;EA4BvC,KAAK,kBAAkB,eAAe;EA0BtC,YAAY,UAAU,WAAW;EAuBjC,kBAAkB,QAAQ;EAoB1B,WAAW,eAAe;EAY1B,iBACJ,cACA,qBAAS,aACR;EAuBG,mBAAmB,qBAAqB;EAgB9C"}