effect-browser 0.0.0-reserved.0 → 0.2.0-beta.0

package/dist/Chromium.mjs

@@ -0,0 +1,381 @@
+import { Identifier } from "./BrowserData.mjs";
+import { BrowserError, Reasons } from "./Errors.mjs";
+import { i as cleanupStep, n as make, o as reported, s as checked } from "./BrowserRuntime-fZz1b0VI.mjs";
+import { Clock, Context, Duration, Effect, Exit, Layer, Option, Path, Redacted, Schema } from "effect";
+import { spawn } from "node:child_process";
+import { mkdtemp, readFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+//#region src/internal/chromium/Data.ts
+/** Identifies this Chromium ownership lifetime, not a reusable endpoint. */
+var ChromiumReference = class extends Schema.Class("ChromiumReference")({
+	provider: Schema.Literal("chromium"),
+	id: Identifier
+}) {};
+var ChromiumCleanupIssue = class extends Schema.Class("ChromiumCleanupIssue")({
+	step: Schema.Literals([
+		"fence",
+		"capture",
+		"initialization",
+		"disconnect",
+		"terminate",
+		"profile"
+	]),
+	reason: Schema.Literals([
+		"timeout",
+		"failed",
+		"interrupted"
+	])
+}) {};
+/** Connection teardown and observed process exit are separate facts; no provider status exists. */
+var ChromiumCleanupResult = class extends Schema.Class("ChromiumCleanupResult")({
+	reference: ChromiumReference,
+	ownership: Schema.Literals(["owned", "borrowed"]),
+	connection: Schema.Literals([
+		"closed",
+		"failed",
+		"not-connected",
+		"pending"
+	]),
+	process: Schema.Literals([
+		"terminated",
+		"unknown",
+		"not-owned"
+	]),
+	issues: Schema.Array(ChromiumCleanupIssue).check(Schema.isMaxLength(16))
+}) {};
+const Text = Schema.NonEmptyString.check(Schema.isMaxLength(4096), Schema.isPattern(/^[^\u0000\r\n]+$/u));
+const Port = Schema.Int.check(Schema.isBetween({
+	minimum: 1,
+	maximum: 65535
+}));
+/** Only a concrete loopback WebSocket is admitted: no HTTP discovery redirects or remote DNS. */
+const ChromiumEndpoint = Text.check(Schema.makeFilter((value) => {
+	try {
+		const url = new URL(value);
+		return url.protocol === "ws:" && ["127.0.0.1", "[::1]"].includes(url.hostname) && Schema.is(Port)(Number(url.port)) && !url.username && !url.password && !url.search && !url.hash && /^\/devtools\/browser\/[A-Za-z0-9_-]+$/u.test(url.pathname);
+	} catch {
+		return false;
+	}
+}));
+const ProxyServer = Text.check(Schema.makeFilter((value) => {
+	try {
+		const url = new URL(value);
+		return [
+			"http:",
+			"https:",
+			"socks5:"
+		].includes(url.protocol) && url.hostname.length > 0 && !url.username && !url.password && !url.search && !url.hash && ["", "/"].includes(url.pathname);
+	} catch {
+		return false;
+	}
+}));
+/** These arguments belong to the launcher; silently overriding them would change ownership. */
+const Argument = Text.check(Schema.makeFilter((value) => value.startsWith("--") && !/^--(?:user-data-dir|remote-debugging[^=]*|headless|no-sandbox|disable-setuid-sandbox|single-process|proxy-server|proxy-bypass-list)(?:=|$)/u.test(value)));
+const ChromiumLaunch = Schema.Struct({
+	executablePath: Schema.optionalKey(Text),
+	headless: Schema.optionalKey(Schema.Boolean),
+	/** Enabled by default; a trusted host must explicitly choose a sandbox exception. */
+	chromiumSandbox: Schema.optionalKey(Schema.Boolean),
+	args: Schema.optionalKey(Schema.Array(Argument).check(Schema.isMaxLength(64))),
+	proxy: Schema.optionalKey(Schema.Struct({
+		server: ProxyServer,
+		bypass: Schema.optionalKey(Text)
+	})),
+	startupTimeoutMillis: Schema.optionalKey(Schema.Int.check(Schema.isBetween({
+		minimum: 1,
+		maximum: 6e4
+	})))
+});
+//#endregion
+//#region src/internal/chromium/Process.ts
+/** Explicit host sandbox/proxy choices; the owned profile and debugger endpoint cannot be replaced. */
+const launchArguments = (options, directory) => [
+	"--no-first-run",
+	"--no-default-browser-check",
+	"--remote-debugging-address=127.0.0.1",
+	"--remote-debugging-port=0",
+	`--user-data-dir=${directory}`,
+	...options.headless === false ? [] : ["--headless=new"],
+	...options.chromiumSandbox === false ? ["--no-sandbox"] : [],
+	...options.proxy === void 0 ? [] : [`--proxy-server=${options.proxy.server}`, `--proxy-bypass-list=${options.proxy.bypass ?? "<-loopback>"}`],
+	...options.args ?? [],
+	"about:blank"
+];
+const failure = (operation, reason) => BrowserError.make({
+	operation,
+	reason,
+	outcome: operation === "close" ? "unknown" : "undispatched"
+});
+const exited = (child) => child.exitCode !== null || child.signalCode !== null;
+/** POSIX groups keep Chromium's helpers inside the same owned termination boundary. */
+const alive = (pid) => {
+	try {
+		process.kill(-pid, 0);
+		return true;
+	} catch (error) {
+		if (error instanceof Error && "code" in error && error.code === "ESRCH") return false;
+		throw error;
+	}
+};
+const signalGroup = (pid, signal) => {
+	try {
+		process.kill(-pid, signal);
+	} catch (error) {
+		if (!(error instanceof Error && "code" in error && error.code === "ESRCH")) throw error;
+	}
+};
+/** Called once; observes parent and helper exit, rather than treating a sent signal as cleanup. */
+const terminate = Effect.fnUntraced(function* (child, pid, clock) {
+	const stopped = Effect.try({
+		try: () => exited(child) && !alive(pid),
+		catch: () => failure("close", Reasons.Failed.make({}))
+	});
+	const signal = (value) => Effect.try({
+		try: () => signalGroup(pid, value),
+		catch: () => failure("close", Reasons.Failed.make({}))
+	});
+	const pause = clock.sleep(Duration.millis(20));
+	yield* signal("SIGTERM");
+	const graceful = clock.monotonicTimeNanosUnsafe() + 1500000000n;
+	while (!(yield* stopped) && clock.monotonicTimeNanosUnsafe() < graceful) yield* pause;
+	if (yield* stopped) return;
+	yield* signal("SIGKILL");
+	const forced = clock.monotonicTimeNanosUnsafe() + 1000000000n;
+	while (!(yield* stopped) && clock.monotonicTimeNanosUnsafe() < forced) yield* pause;
+	if (!(yield* stopped)) return yield* failure("close", Reasons.Timeout.make({}));
+});
+/** Start only Chromium's process. The shared owner later opens its sole CDP connection. */
+const launch = Effect.fnUntraced(function* (options) {
+	if (process.platform === "win32") return yield* failure("launch", Reasons.Unsupported.make({}));
+	const path = yield* Path.Path.pipe(Effect.provide(Path.layer));
+	const clock = yield* Clock.Clock;
+	const executable = options.executablePath ?? (yield* Effect.tryPromise({
+		try: async () => (await import("playwright-core")).chromium.executablePath(),
+		catch: () => failure("launch", Reasons.Failed.make({}))
+	}));
+	const directory = yield* Effect.tryPromise({
+		try: () => mkdtemp(path.join(tmpdir(), "effect-browser-chromium-")),
+		catch: () => failure("launch", Reasons.Failed.make({}))
+	});
+	const removeProfile = Effect.tryPromise({
+		try: () => rm(directory, {
+			recursive: true,
+			force: true,
+			maxRetries: 5,
+			retryDelay: 50
+		}),
+		catch: () => failure("close", Reasons.Failed.make({}))
+	});
+	let child;
+	return yield* Effect.gen(function* () {
+		const launched = yield* Effect.tryPromise({
+			try: () => {
+				const spawned = spawn(executable, launchArguments(options, directory), {
+					cwd: directory,
+					stdio: [
+						"ignore",
+						"ignore",
+						"ignore"
+					],
+					detached: true
+				});
+				child = spawned;
+				return new Promise((resolve, reject) => {
+					spawned.once("spawn", () => resolve(spawned));
+					spawned.once("error", reject);
+				});
+			},
+			catch: () => failure("launch", Reasons.Failed.make({}))
+		});
+		const pid = launched.pid;
+		if (pid === void 0) return yield* failure("launch", Reasons.Failed.make({}));
+		return {
+			connection: (timeoutMillis) => Effect.gen(function* () {
+				const deadline = clock.monotonicTimeNanosUnsafe() + BigInt(Math.ceil(Math.min(timeoutMillis, options.startupTimeoutMillis ?? 15e3))) * 1000000n;
+				while (clock.monotonicTimeNanosUnsafe() < deadline) {
+					if (exited(launched)) return yield* failure("connect", Reasons.Closed.make({}));
+					const portFile = yield* Effect.tryPromise({
+						try: (signal) => readFile(path.join(directory, "DevToolsActivePort"), {
+							encoding: "utf8",
+							signal
+						}).catch((error) => {
+							if (error instanceof Error && "code" in error && error.code === "ENOENT") return void 0;
+							throw error;
+						}),
+						catch: () => failure("connect", Reasons.Transport.make({}))
+					});
+					const lines = portFile === void 0 ? [] : portFile.trim().split("\n");
+					if (lines.length >= 2) {
+						const endpoint = `ws://127.0.0.1:${lines[0]}${lines[1]}`;
+						if (!Schema.is(ChromiumEndpoint)(endpoint)) return yield* failure("connect", Reasons.Malformed.make({}));
+						return Redacted.make(endpoint);
+					}
+					yield* clock.sleep(Duration.millis(20));
+				}
+				return yield* failure("connect", Reasons.Timeout.make({}));
+			}),
+			terminate: yield* Effect.cached(terminate(launched, pid, clock).pipe(Effect.uninterruptible)),
+			removeProfile
+		};
+	}).pipe(Effect.onExit((exit) => Exit.isSuccess(exit) ? Effect.void : Effect.gen(function* () {
+		if (child?.pid === void 0) {
+			yield* removeProfile.pipe(Effect.ignore);
+			return;
+		}
+		const stopped = yield* terminate(child, child.pid, clock).pipe(Effect.exit);
+		if (Exit.isSuccess(stopped)) yield* removeProfile.pipe(Effect.ignore);
+	})));
+});
+//#endregion
+//#region src/internal/chromium/Session.ts
+/** Each teardown step runs even when a preceding step fails. Only observed exit permits profile removal. */
+const makeChromiumCleanup = Effect.fnUntraced(function* (reference, local, process) {
+	let latest;
+	return {
+		close: yield* Effect.cached(Effect.uninterruptible(Effect.gen(function* () {
+			const issues = [];
+			const step = (name, action) => cleanupStep(action, 3e3).pipe(Effect.tap((result) => Effect.sync(() => {
+				if (result._tag === "Failure") issues.push(ChromiumCleanupIssue.make({
+					step: name,
+					reason: result.reason
+				}));
+			})));
+			yield* step("fence", local.fence);
+			yield* step("capture", local.capture);
+			yield* step("initialization", local.initialization);
+			const disconnected = yield* step("disconnect", local.disconnect);
+			const terminated = process === void 0 ? void 0 : yield* step("terminate", process.terminate);
+			if (process !== void 0 && terminated !== void 0 && terminated._tag === "Success") yield* step("profile", process.removeProfile);
+			const result = ChromiumCleanupResult.make({
+				reference,
+				ownership: process === void 0 ? "borrowed" : "owned",
+				connection: disconnected._tag === "Success" ? disconnected.value : "failed",
+				process: terminated === void 0 ? "not-owned" : terminated._tag === "Success" ? "terminated" : "unknown",
+				issues
+			});
+			Object.freeze(result.issues);
+			latest = Object.freeze(result);
+			return latest;
+		}))),
+		result: Effect.sync(() => Option.fromNullishOr(latest))
+	};
+});
+const acquireChromium = (endpoint, options, onCleanup) => (local) => Effect.uninterruptible(Effect.gen(function* () {
+	const process = endpoint === void 0 ? yield* launch(options) : void 0;
+	const reference = Object.freeze(ChromiumReference.make({
+		provider: "chromium",
+		id: globalThis.crypto.randomUUID()
+	}));
+	const cleanup = yield* makeChromiumCleanup(reference, local, process);
+	let closing = false;
+	const release = yield* Effect.cached(Effect.gen(function* () {
+		closing = true;
+		const result = yield* cleanup.close;
+		if (onCleanup !== void 0) yield* reported(Effect.suspend(() => onCleanup(result)));
+		return result;
+	}).pipe(Effect.uninterruptible));
+	yield* Effect.addFinalizer(() => release.pipe(Effect.asVoid));
+	return {
+		reference,
+		connection: (timeoutMillis) => Effect.suspend(() => {
+			if (closing) return Effect.fail(BrowserError.make({
+				operation: "connect",
+				reason: Reasons.Closed.make({}),
+				outcome: "undispatched"
+			}));
+			if (process !== void 0) return process.connection(timeoutMillis);
+			return endpoint === void 0 ? Effect.fail(BrowserError.make({
+				operation: "connect",
+				reason: Reasons.Configuration.make({}),
+				outcome: "undispatched"
+			})) : checked(ChromiumEndpoint, Redacted.value(endpoint), "connect").pipe(Effect.map(Redacted.make));
+		}),
+		release,
+		closeChecked: release.pipe(Effect.filterOrFail((result) => result.connection === "closed" && result.issues.length === 0 && (result.ownership === "borrowed" ? result.process === "not-owned" : result.process === "terminated"), () => BrowserError.make({
+			operation: "close",
+			reason: Reasons.Failed.make({}),
+			outcome: "unknown"
+		}))),
+		cleanupResult: cleanup.result,
+		controlRetired: cleanup.result.pipe(Effect.map((result) => Option.isSome(result) && result.value.ownership === "owned" && result.value.process === "terminated"))
+	};
+}));
+const ownedChromium = (options, onCleanup) => acquireChromium(void 0, options, onCleanup);
+const borrowedChromium = (endpoint, onCleanup) => acquireChromium(endpoint, {}, onCleanup);
+//#endregion
+//#region src/Chromium.ts
+var Chromium = class Chromium extends Context.Service()("effect-browser/Chromium") {
+	/** Launch through the configured service; compose with Browser.scoped for supervised ownership. */
+	static launch(policy, request) {
+		return Effect.flatMap(Chromium, (browser) => browser.launch(policy, request));
+	}
+	/** Acquire the process lifetime before connecting, using the caller's scope. */
+	static acquire(policy, request) {
+		return Effect.flatMap(Chromium, (browser) => browser.acquire(policy, request));
+	}
+	/** Borrow a concrete loopback endpoint; cleanup never terminates its external process. */
+	static attach(endpoint, request) {
+		return Effect.flatMap(Chromium, (browser) => browser.attach(endpoint, request));
+	}
+	static layer(options = {}) {
+		return Layer.effect(Chromium, Effect.gen(function* () {
+			const launchInput = yield* checked(ChromiumLaunch, options.launch ?? {}, "configure");
+			const launch = Object.freeze({
+				...launchInput,
+				...launchInput.args === void 0 ? {} : { args: Object.freeze([...launchInput.args]) },
+				...launchInput.proxy === void 0 ? {} : { proxy: Object.freeze({ ...launchInput.proxy }) }
+			});
+			if (Object.prototype.hasOwnProperty.call(options, "bootstrap")) return yield* BrowserError.make({
+				operation: "configure",
+				reason: Reasons.Configuration.make({}),
+				outcome: "undispatched"
+			});
+			const runtime = yield* make({
+				implementation: "chromium-playwright-cdp",
+				...options.viewport === void 0 ? {} : { viewport: options.viewport },
+				automation: {
+					...options.actionTimeoutMillis === void 0 ? {} : { actionTimeoutMillis: options.actionTimeoutMillis },
+					...options.maxPages === void 0 ? {} : { maxPages: options.maxPages },
+					...options.maxHostReads === void 0 ? {} : { maxHostReads: options.maxHostReads },
+					...options.initialPage === void 0 ? {} : { initialPage: options.initialPage },
+					...options.popupPolicy === void 0 ? {} : { popupPolicy: options.popupPolicy },
+					...options.dialogPolicy === void 0 ? {} : { dialogPolicy: options.dialogPolicy },
+					...options.pageControl === void 0 ? {} : { pageControl: options.pageControl }
+				}
+			});
+			const acquire = Effect.fnUntraced(function* (policy, request = {}, attachment) {
+				const acquired = yield* runtime.acquire(policy, attachment === void 0 ? ownedChromium(launch, options.onCleanup) : borrowedChromium(attachment.endpoint, options.onCleanup), {
+					...request,
+					...attachment === void 0 ? {} : { existingTarget: attachment.targetId === void 0 ? {} : { targetId: attachment.targetId } }
+				});
+				const connected = yield* Effect.cached(acquired.connect.pipe(Effect.map(({ session }) => Object.assign(session, {
+					reference: acquired.reference,
+					closeChecked: session.closeChecked.pipe(Effect.andThen(acquired.lifetime.closeChecked)),
+					close: acquired.close,
+					cleanupResult: acquired.lifetime.cleanupResult
+				}))));
+				return {
+					reference: acquired.reference,
+					failure: acquired.failure,
+					close: acquired.close,
+					connect: acquired.connect.pipe(Effect.andThen(connected))
+				};
+			});
+			return Chromium.of({
+				acquire,
+				launch: (policy, request) => acquire(policy, request).pipe(Effect.flatMap((acquired) => acquired.connect)),
+				attach: (endpoint, request) => Effect.gen(function* () {
+					const address = yield* checked(ChromiumEndpoint, Redacted.value(endpoint), "connect");
+					return yield* (yield* acquire(request.policy, request, {
+						endpoint: Redacted.make(address),
+						...request.target === void 0 ? {} : { targetId: request.target.targetId }
+					})).connect;
+				})
+			});
+		}));
+	}
+};
+//#endregion
+export { Chromium, ChromiumCleanupIssue, ChromiumCleanupResult, ChromiumLaunch, ChromiumReference };
+
+//# sourceMappingURL=Chromium.mjs.map

package/dist/Chromium.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chromium.mjs","names":["BrowserRuntime.make"],"sources":["../src/internal/chromium/Data.ts","../src/internal/chromium/Process.ts","../src/internal/chromium/Session.ts","../src/Chromium.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\nimport { Identifier } from \"../../BrowserData.ts\";\n\n/** Identifies this Chromium ownership lifetime, not a reusable endpoint. */\nexport class ChromiumReference extends Schema.Class<ChromiumReference>(\"ChromiumReference\")({\n  provider: Schema.Literal(\"chromium\"),\n  id: Identifier,\n}) {}\n\nexport class ChromiumCleanupIssue extends Schema.Class<ChromiumCleanupIssue>(\n  \"ChromiumCleanupIssue\",\n)({\n  step: Schema.Literals([\n    \"fence\",\n    \"capture\",\n    \"initialization\",\n    \"disconnect\",\n    \"terminate\",\n    \"profile\",\n  ]),\n  reason: Schema.Literals([\"timeout\", \"failed\", \"interrupted\"]),\n}) {}\n\n/** Connection teardown and observed process exit are separate facts; no provider status exists. */\nexport class ChromiumCleanupResult extends Schema.Class<ChromiumCleanupResult>(\n  \"ChromiumCleanupResult\",\n)({\n  reference: ChromiumReference,\n  ownership: Schema.Literals([\"owned\", \"borrowed\"]),\n  connection: Schema.Literals([\"closed\", \"failed\", \"not-connected\", \"pending\"]),\n  process: Schema.Literals([\"terminated\", \"unknown\", \"not-owned\"]),\n  issues: Schema.Array(ChromiumCleanupIssue).check(Schema.isMaxLength(16)),\n}) {}\n\nconst Text = Schema.NonEmptyString.check(\n  Schema.isMaxLength(4096),\n  Schema.isPattern(/^[^\\u0000\\r\\n]+$/u),\n);\n\nconst Port = Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 65535 }));\n\n/** Only a concrete loopback WebSocket is admitted: no HTTP discovery redirects or remote DNS. */\nexport const ChromiumEndpoint = Text.check(\n  Schema.makeFilter((value) => {\n    try {\n      const url = new URL(value);\n\n      return (\n        url.protocol === \"ws:\" &&\n        [\"127.0.0.1\", \"[::1]\"].includes(url.hostname) &&\n        Schema.is(Port)(Number(url.port)) &&\n        !url.username &&\n        !url.password &&\n        !url.search &&\n        !url.hash &&\n        /^\\/devtools\\/browser\\/[A-Za-z0-9_-]+$/u.test(url.pathname)\n      );\n    } catch {\n      return false;\n    }\n  }),\n);\n\nconst ProxyServer = Text.check(\n  Schema.makeFilter((value) => {\n    try {\n      const url = new URL(value);\n\n      return (\n        [\"http:\", \"https:\", \"socks5:\"].includes(url.protocol) &&\n        url.hostname.length > 0 &&\n        !url.username &&\n        !url.password &&\n        !url.search &&\n        !url.hash &&\n        [\"\", \"/\"].includes(url.pathname)\n      );\n    } catch {\n      return false;\n    }\n  }),\n);\n\n/** These arguments belong to the launcher; silently overriding them would change ownership. */\nconst Argument = Text.check(\n  Schema.makeFilter(\n    (value) =>\n      value.startsWith(\"--\") &&\n      !/^--(?:user-data-dir|remote-debugging[^=]*|headless|no-sandbox|disable-setuid-sandbox|single-process|proxy-server|proxy-bypass-list)(?:=|$)/u.test(\n        value,\n      ),\n  ),\n);\n\nexport const ChromiumLaunch = Schema.Struct({\n  executablePath: Schema.optionalKey(Text),\n  headless: Schema.optionalKey(Schema.Boolean),\n  /** Enabled by default; a trusted host must explicitly choose a sandbox exception. */\n  chromiumSandbox: Schema.optionalKey(Schema.Boolean),\n  args: Schema.optionalKey(Schema.Array(Argument).check(Schema.isMaxLength(64))),\n  proxy: Schema.optionalKey(\n    Schema.Struct({\n      server: ProxyServer,\n      bypass: Schema.optionalKey(Text),\n    }),\n  ),\n  startupTimeoutMillis: Schema.optionalKey(\n    Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 60000 })),\n  ),\n});\n\nexport type ChromiumLaunch = typeof ChromiumLaunch.Type;\n","// rc.115's NodeChildProcessSpawner exposes leader exit, but its bounded group wait can\n// succeed with surviving members. This boundary must observe the leader AND group gone.\n// @effect-diagnostics-next-line nodeBuiltinImport:off\nimport { spawn, type ChildProcess } from \"node:child_process\";\n// FileSystem.remove exposes recursive/force only, not rm's per-entry OS-error retries.\n// Keep native profile creation/read/removal together; removal follows confirmed group exit.\n// @effect-diagnostics-next-line nodeBuiltinImport:off\nimport { mkdtemp, readFile, rm } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\n\nimport { Clock, Duration, Effect, Exit, Path, Redacted, Schema } from \"effect\";\n\nimport { Reasons, BrowserError } from \"../../Errors.ts\";\nimport { ChromiumEndpoint, type ChromiumLaunch } from \"./Data.ts\";\n\nexport interface ChromiumProcess {\n  readonly connection: (\n    timeoutMillis: number,\n  ) => Effect.Effect<Redacted.Redacted<string>, BrowserError>;\n  readonly terminate: Effect.Effect<void, BrowserError>;\n  readonly removeProfile: Effect.Effect<void, BrowserError>;\n}\n\n/** Explicit host sandbox/proxy choices; the owned profile and debugger endpoint cannot be replaced. */\nexport const launchArguments = (options: ChromiumLaunch, directory: string): string[] => [\n  \"--no-first-run\",\n  \"--no-default-browser-check\",\n  \"--remote-debugging-address=127.0.0.1\",\n  \"--remote-debugging-port=0\",\n  `--user-data-dir=${directory}`,\n  ...(options.headless === false ? [] : [\"--headless=new\"]),\n  ...(options.chromiumSandbox === false ? [\"--no-sandbox\"] : []),\n  ...(options.proxy === undefined\n    ? []\n    : [\n        `--proxy-server=${options.proxy.server}`,\n        // Chromium otherwise bypasses proxies for loopback. The host may deliberately override it.\n        `--proxy-bypass-list=${options.proxy.bypass ?? \"<-loopback>\"}`,\n      ]),\n  ...(options.args ?? []),\n  \"about:blank\",\n];\n\nconst failure = (operation: \"launch\" | \"connect\" | \"close\", reason: BrowserError[\"reason\"]) =>\n  BrowserError.make({\n    operation,\n    reason,\n    outcome: operation === \"close\" ? \"unknown\" : \"undispatched\",\n  });\n\nconst exited = (child: ChildProcess) => child.exitCode !== null || child.signalCode !== null;\n\n/** POSIX groups keep Chromium's helpers inside the same owned termination boundary. */\nconst alive = (pid: number): boolean => {\n  try {\n    process.kill(-pid, 0);\n\n    return true;\n  } catch (error) {\n    if (error instanceof Error && \"code\" in error && error.code === \"ESRCH\") return false;\n    throw error;\n  }\n};\n\nconst signalGroup = (pid: number, signal: NodeJS.Signals) => {\n  try {\n    process.kill(-pid, signal);\n  } catch (error) {\n    if (!(error instanceof Error && \"code\" in error && error.code === \"ESRCH\")) throw error;\n  }\n};\n\n/** Called once; observes parent and helper exit, rather than treating a sent signal as cleanup. */\nconst terminate = Effect.fnUntraced(function* (\n  child: ChildProcess,\n  pid: number,\n  clock: Clock.Clock,\n): Effect.fn.Return<void, BrowserError> {\n  const stopped = Effect.try({\n    try: () => exited(child) && !alive(pid),\n    catch: () => failure(\"close\", Reasons.Failed.make({})),\n  });\n\n  const signal = (value: NodeJS.Signals) =>\n    Effect.try({\n      try: () => signalGroup(pid, value),\n      catch: () => failure(\"close\", Reasons.Failed.make({})),\n    });\n\n  const pause = clock.sleep(Duration.millis(20));\n\n  yield* signal(\"SIGTERM\");\n  const graceful = clock.monotonicTimeNanosUnsafe() + 1_500_000_000n;\n\n  while (!(yield* stopped) && clock.monotonicTimeNanosUnsafe() < graceful) yield* pause;\n  if (yield* stopped) return;\n  yield* signal(\"SIGKILL\");\n  const forced = clock.monotonicTimeNanosUnsafe() + 1_000_000_000n;\n\n  while (!(yield* stopped) && clock.monotonicTimeNanosUnsafe() < forced) yield* pause;\n  if (!(yield* stopped)) return yield* failure(\"close\", Reasons.Timeout.make({}));\n});\n\n/** Start only Chromium's process. The shared owner later opens its sole CDP connection. */\nexport const launch = Effect.fnUntraced(function* (\n  options: ChromiumLaunch,\n): Effect.fn.Return<ChromiumProcess, BrowserError> {\n  if (process.platform === \"win32\") return yield* failure(\"launch\", Reasons.Unsupported.make({}));\n  const path = yield* Path.Path.pipe(Effect.provide(Path.layer));\n  const clock = yield* Clock.Clock;\n\n  const executable =\n    options.executablePath ??\n    (yield* Effect.tryPromise({\n      try: async () => (await import(\"playwright-core\")).chromium.executablePath(),\n      catch: () => failure(\"launch\", Reasons.Failed.make({})),\n    }));\n\n  const directory = yield* Effect.tryPromise({\n    try: () => mkdtemp(path.join(tmpdir(), \"effect-browser-chromium-\")),\n    catch: () => failure(\"launch\", Reasons.Failed.make({})),\n  });\n\n  const removeProfile = Effect.tryPromise({\n    try: () => rm(directory, { recursive: true, force: true, maxRetries: 5, retryDelay: 50 }),\n    catch: () => failure(\"close\", Reasons.Failed.make({})),\n  });\n\n  let child: ChildProcess | undefined;\n\n  return yield* Effect.gen(function* () {\n    const launched = yield* Effect.tryPromise({\n      try: () => {\n        const spawned = spawn(executable, launchArguments(options, directory), {\n          cwd: directory,\n          stdio: [\"ignore\", \"ignore\", \"ignore\"],\n          detached: true,\n        });\n\n        child = spawned;\n\n        return new Promise<ChildProcess>((resolve, reject) => {\n          spawned.once(\"spawn\", () => resolve(spawned));\n          spawned.once(\"error\", reject);\n        });\n      },\n      catch: () => failure(\"launch\", Reasons.Failed.make({})),\n    });\n\n    const pid = launched.pid;\n\n    if (pid === undefined) return yield* failure(\"launch\", Reasons.Failed.make({}));\n\n    // One termination continues to its own bounded group-exit decision even if a waiter cancels.\n    const closing = yield* Effect.cached(\n      terminate(launched, pid, clock).pipe(Effect.uninterruptible),\n    );\n\n    return {\n      connection: (timeoutMillis) =>\n        Effect.gen(function* () {\n          const deadline =\n            clock.monotonicTimeNanosUnsafe() +\n            BigInt(Math.ceil(Math.min(timeoutMillis, options.startupTimeoutMillis ?? 15000))) *\n              1_000_000n;\n\n          while (clock.monotonicTimeNanosUnsafe() < deadline) {\n            if (exited(launched)) return yield* failure(\"connect\", Reasons.Closed.make({}));\n\n            const portFile = yield* Effect.tryPromise({\n              try: (signal) =>\n                readFile(path.join(directory, \"DevToolsActivePort\"), {\n                  encoding: \"utf8\",\n                  signal,\n                }).catch((error: unknown) => {\n                  if (error instanceof Error && \"code\" in error && error.code === \"ENOENT\")\n                    return undefined;\n                  throw error;\n                }),\n              catch: () => failure(\"connect\", Reasons.Transport.make({})),\n            });\n\n            // Chromium creates DevToolsActivePort before it writes the port and path into it. A\n            // file without both lines is startup still in progress, not an endpoint; only a\n            // complete file that is not a loopback DevTools endpoint is malformed.\n            const lines = portFile === undefined ? [] : portFile.trim().split(\"\\n\");\n\n            if (lines.length >= 2) {\n              const endpoint = `ws://127.0.0.1:${lines[0]}${lines[1]}`;\n\n              if (!Schema.is(ChromiumEndpoint)(endpoint))\n                return yield* failure(\"connect\", Reasons.Malformed.make({}));\n\n              return Redacted.make(endpoint);\n            }\n            yield* clock.sleep(Duration.millis(20));\n          }\n\n          return yield* failure(\"connect\", Reasons.Timeout.make({}));\n        }),\n      terminate: closing,\n      removeProfile,\n    } satisfies ChromiumProcess;\n  }).pipe(\n    Effect.onExit((exit) =>\n      Exit.isSuccess(exit)\n        ? Effect.void\n        : Effect.gen(function* () {\n            if (child?.pid === undefined) {\n              yield* removeProfile.pipe(Effect.ignore);\n\n              return;\n            }\n            const stopped = yield* terminate(child, child.pid, clock).pipe(Effect.exit);\n\n            if (Exit.isSuccess(stopped)) yield* removeProfile.pipe(Effect.ignore);\n          }),\n    ),\n  );\n});\n","import { Effect, Option, Redacted } from \"effect\";\n\nimport type { Lifetime, Source } from \"../../BrowserRuntime.ts\";\nimport { BrowserError, Reasons } from \"../../Errors.ts\";\nimport { cleanupStep, reported, type ConnectionCleanup } from \"../browser/ConnectionCleanup.ts\";\nimport { checked } from \"../browser/PublicSession.ts\";\nimport {\n  ChromiumCleanupIssue,\n  ChromiumCleanupResult,\n  ChromiumEndpoint,\n  ChromiumReference,\n  type ChromiumLaunch,\n} from \"./Data.ts\";\nimport { launch, type ChromiumProcess } from \"./Process.ts\";\n\nexport interface ChromiumLease extends Lifetime {\n  readonly reference: ChromiumReference;\n  readonly closeChecked: Effect.Effect<ChromiumCleanupResult, BrowserError>;\n  readonly release: Effect.Effect<ChromiumCleanupResult>;\n  readonly cleanupResult: Effect.Effect<Option.Option<ChromiumCleanupResult>>;\n}\n\n/** Each teardown step runs even when a preceding step fails. Only observed exit permits profile removal. */\nexport const makeChromiumCleanup = Effect.fnUntraced(function* (\n  reference: ChromiumReference,\n  local: ConnectionCleanup,\n  process: ChromiumProcess | undefined,\n) {\n  let latest: ChromiumCleanupResult | undefined;\n\n  const close = yield* Effect.cached(\n    Effect.uninterruptible(\n      Effect.gen(function* () {\n        const issues: ChromiumCleanupIssue[] = [];\n\n        const step = <A, E>(name: ChromiumCleanupIssue[\"step\"], action: Effect.Effect<A, E>) =>\n          cleanupStep(action, 3000).pipe(\n            Effect.tap((result) =>\n              Effect.sync(() => {\n                if (result._tag === \"Failure\")\n                  issues.push(ChromiumCleanupIssue.make({ step: name, reason: result.reason }));\n              }),\n            ),\n          );\n\n        yield* step(\"fence\", local.fence);\n        yield* step(\"capture\", local.capture);\n        yield* step(\"initialization\", local.initialization);\n        const disconnected = yield* step(\"disconnect\", local.disconnect);\n\n        const terminated =\n          process === undefined ? undefined : yield* step(\"terminate\", process.terminate);\n\n        if (process !== undefined && terminated !== undefined && terminated._tag === \"Success\")\n          yield* step(\"profile\", process.removeProfile);\n\n        const result = ChromiumCleanupResult.make({\n          reference,\n          ownership: process === undefined ? \"borrowed\" : \"owned\",\n          connection: disconnected._tag === \"Success\" ? disconnected.value : \"failed\",\n          process:\n            terminated === undefined\n              ? \"not-owned\"\n              : terminated._tag === \"Success\"\n                ? \"terminated\"\n                : \"unknown\",\n          issues,\n        });\n\n        Object.freeze(result.issues);\n        latest = Object.freeze(result);\n\n        return latest;\n      }),\n    ),\n  );\n\n  return { close, result: Effect.sync(() => Option.fromNullishOr(latest)) };\n});\n\nconst acquireChromium =\n  (\n    endpoint: Redacted.Redacted<string> | undefined,\n    options: ChromiumLaunch,\n    onCleanup?: (result: ChromiumCleanupResult) => Effect.Effect<void>,\n  ): Source<ChromiumLease, BrowserError, never> =>\n  (local) =>\n    Effect.uninterruptible(\n      Effect.gen(function* () {\n        // The process cannot escape between spawn and finalizer registration. Startup waiting happens\n        // later in connect, where it is interruptible and the owning finalizer is already installed.\n        const process = endpoint === undefined ? yield* launch(options) : undefined;\n\n        const reference = Object.freeze(\n          ChromiumReference.make({ provider: \"chromium\", id: globalThis.crypto.randomUUID() }),\n        );\n\n        const cleanup = yield* makeChromiumCleanup(reference, local, process);\n        let closing = false;\n\n        const release = yield* Effect.cached(\n          Effect.gen(function* () {\n            closing = true;\n            const result = yield* cleanup.close;\n\n            if (onCleanup !== undefined) yield* reported(Effect.suspend(() => onCleanup(result)));\n\n            return result;\n          }).pipe(Effect.uninterruptible),\n        );\n\n        yield* Effect.addFinalizer(() => release.pipe(Effect.asVoid));\n\n        return {\n          reference,\n          connection: (timeoutMillis) =>\n            Effect.suspend(() => {\n              if (closing)\n                return Effect.fail(\n                  BrowserError.make({\n                    operation: \"connect\",\n                    reason: Reasons.Closed.make({}),\n                    outcome: \"undispatched\",\n                  }),\n                );\n              if (process !== undefined) return process.connection(timeoutMillis);\n\n              return endpoint === undefined\n                ? Effect.fail(\n                    BrowserError.make({\n                      operation: \"connect\",\n                      reason: Reasons.Configuration.make({}),\n                      outcome: \"undispatched\",\n                    }),\n                  )\n                : checked(ChromiumEndpoint, Redacted.value(endpoint), \"connect\").pipe(\n                    Effect.map(Redacted.make),\n                  );\n            }),\n          release,\n          closeChecked: release.pipe(\n            Effect.filterOrFail(\n              (result) =>\n                result.connection === \"closed\" &&\n                result.issues.length === 0 &&\n                (result.ownership === \"borrowed\"\n                  ? result.process === \"not-owned\"\n                  : result.process === \"terminated\"),\n              () =>\n                BrowserError.make({\n                  operation: \"close\",\n                  reason: Reasons.Failed.make({}),\n                  outcome: \"unknown\",\n                }),\n            ),\n          ),\n          cleanupResult: cleanup.result,\n          controlRetired: cleanup.result.pipe(\n            Effect.map(\n              (result) =>\n                Option.isSome(result) &&\n                result.value.ownership === \"owned\" &&\n                result.value.process === \"terminated\",\n            ),\n          ),\n        } satisfies ChromiumLease;\n      }),\n    );\n\nexport const ownedChromium = (\n  options: ChromiumLaunch,\n  onCleanup?: (result: ChromiumCleanupResult) => Effect.Effect<void>,\n) => acquireChromium(undefined, options, onCleanup);\n\nexport const borrowedChromium = (\n  endpoint: Redacted.Redacted<string>,\n  onCleanup?: (result: ChromiumCleanupResult) => Effect.Effect<void>,\n) => acquireChromium(endpoint, {}, onCleanup);\n","import { Context, Effect, Layer, type Option, Redacted, type Scope } from \"effect\";\n\nimport type { BrowserSession, OpenOptions } from \"./Browser.ts\";\nimport type { AutomationOptions, BrowserPolicy, Viewport } from \"./BrowserData.ts\";\nimport * as BrowserRuntime from \"./BrowserRuntime.ts\";\nimport { BrowserError, Reasons, type InitializationError } from \"./Errors.ts\";\nimport { checked } from \"./internal/browser/PublicSession.ts\";\nimport {\n  ChromiumEndpoint,\n  ChromiumLaunch,\n  type ChromiumCleanupResult,\n  type ChromiumReference,\n} from \"./internal/chromium/Data.ts\";\nimport { borrowedChromium, ownedChromium } from \"./internal/chromium/Session.ts\";\n\nexport {\n  ChromiumCleanupIssue,\n  ChromiumCleanupResult,\n  ChromiumLaunch,\n  ChromiumReference,\n} from \"./internal/chromium/Data.ts\";\n\n/** Host-only process configuration. Building this layer neither loads Playwright nor starts Chromium. */\nexport interface ChromiumOptions extends AutomationOptions {\n  readonly launch?: ChromiumLaunch;\n  readonly viewport?: Viewport;\n  readonly onCleanup?: (result: ChromiumCleanupResult) => Effect.Effect<void>;\n}\n\n/** An owned or borrowed Chromium lifetime with one modeled browser connection. */\nexport interface ChromiumSession<E = never> extends BrowserSession<E> {\n  readonly reference: ChromiumReference;\n  readonly closeChecked: Effect.Effect<ChromiumCleanupResult, BrowserError>;\n  readonly close: Effect.Effect<ChromiumCleanupResult>;\n  readonly cleanupResult: Effect.Effect<Option.Option<ChromiumCleanupResult>>;\n}\n\nexport interface ChromiumAcquisition<E = never> {\n  readonly reference: ChromiumReference;\n  readonly failure: Effect.Effect<never, E | InitializationError>;\n  readonly connect: Effect.Effect<ChromiumSession<E>, BrowserError | InitializationError | E>;\n  readonly close: Effect.Effect<ChromiumCleanupResult>;\n}\n\nexport interface ChromiumAttachRequest<E = never, R = never> extends OpenOptions<E, R> {\n  readonly policy: BrowserPolicy;\n  /** Resolve this exact target; without it, multiple open pages are an ambiguity error. */\n  readonly target?: { readonly targetId: string };\n}\n\nexport class Chromium extends Context.Service<\n  Chromium,\n  {\n    readonly acquire: <E = never, R = never>(\n      policy: BrowserPolicy,\n      request?: OpenOptions<E, R>,\n    ) => Effect.Effect<ChromiumAcquisition<E>, BrowserError, Scope.Scope | Exclude<R, Scope.Scope>>;\n    readonly launch: <E = never, R = never>(\n      policy: BrowserPolicy,\n      request?: OpenOptions<E, R>,\n    ) => Effect.Effect<\n      ChromiumSession<E>,\n      BrowserError | InitializationError | E,\n      Scope.Scope | Exclude<R, Scope.Scope>\n    >;\n    /** A concrete loopback ws://.../devtools/browser/... endpoint; this scope owns only its connection. */\n    readonly attach: <E = never, R = never>(\n      endpoint: Redacted.Redacted<string>,\n      request: ChromiumAttachRequest<E, R>,\n    ) => Effect.Effect<\n      ChromiumSession<E>,\n      BrowserError | InitializationError | E,\n      Scope.Scope | Exclude<R, Scope.Scope>\n    >;\n  }\n>()(\"effect-browser/Chromium\") {\n  /** Launch through the configured service; compose with Browser.scoped for supervised ownership. */\n  static launch<E = never, R = never>(policy: BrowserPolicy, request?: OpenOptions<E, R>) {\n    return Effect.flatMap(Chromium, (browser) => browser.launch(policy, request));\n  }\n\n  /** Acquire the process lifetime before connecting, using the caller's scope. */\n  static acquire<E = never, R = never>(policy: BrowserPolicy, request?: OpenOptions<E, R>) {\n    return Effect.flatMap(Chromium, (browser) => browser.acquire(policy, request));\n  }\n\n  /** Borrow a concrete loopback endpoint; cleanup never terminates its external process. */\n  static attach<E = never, R = never>(\n    endpoint: Redacted.Redacted<string>,\n    request: ChromiumAttachRequest<E, R>,\n  ) {\n    return Effect.flatMap(Chromium, (browser) => browser.attach(endpoint, request));\n  }\n\n  static layer(options: ChromiumOptions = {}): Layer.Layer<Chromium, BrowserError> {\n    return Layer.effect(\n      Chromium,\n      Effect.gen(function* () {\n        const launchInput = yield* checked(ChromiumLaunch, options.launch ?? {}, \"configure\");\n\n        const launch = Object.freeze({\n          ...launchInput,\n          ...(launchInput.args === undefined ? {} : { args: Object.freeze([...launchInput.args]) }),\n          ...(launchInput.proxy === undefined\n            ? {}\n            : { proxy: Object.freeze({ ...launchInput.proxy }) }),\n        });\n\n        if (Object.prototype.hasOwnProperty.call(options, \"bootstrap\"))\n          return yield* BrowserError.make({\n            operation: \"configure\",\n            reason: Reasons.Configuration.make({}),\n            outcome: \"undispatched\",\n          });\n\n        const runtime = yield* BrowserRuntime.make({\n          implementation: \"chromium-playwright-cdp\",\n          ...(options.viewport === undefined ? {} : { viewport: options.viewport }),\n          automation: {\n            ...(options.actionTimeoutMillis === undefined\n              ? {}\n              : { actionTimeoutMillis: options.actionTimeoutMillis }),\n            ...(options.maxPages === undefined ? {} : { maxPages: options.maxPages }),\n            ...(options.maxHostReads === undefined ? {} : { maxHostReads: options.maxHostReads }),\n            ...(options.initialPage === undefined ? {} : { initialPage: options.initialPage }),\n            ...(options.popupPolicy === undefined ? {} : { popupPolicy: options.popupPolicy }),\n            ...(options.dialogPolicy === undefined ? {} : { dialogPolicy: options.dialogPolicy }),\n            ...(options.pageControl === undefined ? {} : { pageControl: options.pageControl }),\n          },\n        });\n\n        const acquire = Effect.fnUntraced(function* <E = never, R = never>(\n          policy: BrowserPolicy,\n          request: OpenOptions<E, R> = {},\n          attachment?: { readonly endpoint: Redacted.Redacted<string>; readonly targetId?: string },\n        ) {\n          const acquired = yield* runtime.acquire(\n            policy,\n            attachment === undefined\n              ? ownedChromium(launch, options.onCleanup)\n              : borrowedChromium(attachment.endpoint, options.onCleanup),\n            {\n              ...request,\n              ...(attachment === undefined\n                ? {}\n                : {\n                    existingTarget:\n                      attachment.targetId === undefined ? {} : { targetId: attachment.targetId },\n                  }),\n            },\n          );\n\n          const connected = yield* Effect.cached(\n            acquired.connect.pipe(\n              Effect.map(({ session }): ChromiumSession<E> =>\n                Object.assign(session, {\n                  reference: acquired.reference,\n                  closeChecked: session.closeChecked.pipe(\n                    Effect.andThen(acquired.lifetime.closeChecked),\n                  ),\n                  close: acquired.close,\n                  cleanupResult: acquired.lifetime.cleanupResult,\n                }),\n              ),\n            ),\n          );\n\n          return {\n            reference: acquired.reference,\n            failure: acquired.failure,\n            close: acquired.close,\n            connect: acquired.connect.pipe(Effect.andThen(connected)),\n          } satisfies ChromiumAcquisition<E>;\n        });\n\n        return Chromium.of({\n          acquire,\n          launch: (policy, request) =>\n            acquire(policy, request).pipe(Effect.flatMap((acquired) => acquired.connect)),\n          attach: (endpoint, request) =>\n            Effect.gen(function* () {\n              const address = yield* checked(ChromiumEndpoint, Redacted.value(endpoint), \"connect\");\n\n              return yield* (yield* acquire(request.policy, request, {\n                endpoint: Redacted.make(address),\n                ...(request.target === undefined ? {} : { targetId: request.target.targetId }),\n              })).connect;\n            }),\n        });\n      }),\n    );\n  }\n}\n"],"mappings":";;;;;;;;;AAKA,IAAa,oBAAb,cAAuC,OAAO,MAAyB,mBAAmB,CAAC,CAAC;CAC1F,UAAU,OAAO,QAAQ,UAAU;CACnC,IAAI;AACN,CAAC,CAAC,CAAC,CAAC;AAEJ,IAAa,uBAAb,cAA0C,OAAO,MAC/C,sBACF,CAAC,CAAC;CACA,MAAM,OAAO,SAAS;EACpB;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CACD,QAAQ,OAAO,SAAS;EAAC;EAAW;EAAU;CAAa,CAAC;AAC9D,CAAC,CAAC,CAAC,CAAC;;AAGJ,IAAa,wBAAb,cAA2C,OAAO,MAChD,uBACF,CAAC,CAAC;CACA,WAAW;CACX,WAAW,OAAO,SAAS,CAAC,SAAS,UAAU,CAAC;CAChD,YAAY,OAAO,SAAS;EAAC;EAAU;EAAU;EAAiB;CAAS,CAAC;CAC5E,SAAS,OAAO,SAAS;EAAC;EAAc;EAAW;CAAW,CAAC;CAC/D,QAAQ,OAAO,MAAM,oBAAoB,CAAC,CAAC,MAAM,OAAO,YAAY,EAAE,CAAC;AACzE,CAAC,CAAC,CAAC,CAAC;AAEJ,MAAM,OAAO,OAAO,eAAe,MACjC,OAAO,YAAY,IAAI,GACvB,OAAO,UAAU,mBAAmB,CACtC;AAEA,MAAM,OAAO,OAAO,IAAI,MAAM,OAAO,UAAU;CAAE,SAAS;CAAG,SAAS;AAAM,CAAC,CAAC;;AAG9E,MAAa,mBAAmB,KAAK,MACnC,OAAO,YAAY,UAAU;CAC3B,IAAI;EACF,MAAM,MAAM,IAAI,IAAI,KAAK;EAEzB,OACE,IAAI,aAAa,SACjB,CAAC,aAAa,OAAO,CAAC,CAAC,SAAS,IAAI,QAAQ,KAC5C,OAAO,GAAG,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,KAChC,CAAC,IAAI,YACL,CAAC,IAAI,YACL,CAAC,IAAI,UACL,CAAC,IAAI,QACL,yCAAyC,KAAK,IAAI,QAAQ;CAE9D,QAAQ;EACN,OAAO;CACT;AACF,CAAC,CACH;AAEA,MAAM,cAAc,KAAK,MACvB,OAAO,YAAY,UAAU;CAC3B,IAAI;EACF,MAAM,MAAM,IAAI,IAAI,KAAK;EAEzB,OACE;GAAC;GAAS;GAAU;EAAS,CAAC,CAAC,SAAS,IAAI,QAAQ,KACpD,IAAI,SAAS,SAAS,KACtB,CAAC,IAAI,YACL,CAAC,IAAI,YACL,CAAC,IAAI,UACL,CAAC,IAAI,QACL,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,QAAQ;CAEnC,QAAQ;EACN,OAAO;CACT;AACF,CAAC,CACH;;AAGA,MAAM,WAAW,KAAK,MACpB,OAAO,YACJ,UACC,MAAM,WAAW,IAAI,KACrB,CAAC,8IAA8I,KAC7I,KACF,CACJ,CACF;AAEA,MAAa,iBAAiB,OAAO,OAAO;CAC1C,gBAAgB,OAAO,YAAY,IAAI;CACvC,UAAU,OAAO,YAAY,OAAO,OAAO;;CAE3C,iBAAiB,OAAO,YAAY,OAAO,OAAO;CAClD,MAAM,OAAO,YAAY,OAAO,MAAM,QAAQ,CAAC,CAAC,MAAM,OAAO,YAAY,EAAE,CAAC,CAAC;CAC7E,OAAO,OAAO,YACZ,OAAO,OAAO;EACZ,QAAQ;EACR,QAAQ,OAAO,YAAY,IAAI;CACjC,CAAC,CACH;CACA,sBAAsB,OAAO,YAC3B,OAAO,IAAI,MAAM,OAAO,UAAU;EAAE,SAAS;EAAG,SAAS;CAAM,CAAC,CAAC,CACnE;AACF,CAAC;;;;ACtFD,MAAa,mBAAmB,SAAyB,cAAgC;CACvF;CACA;CACA;CACA;CACA,mBAAmB;CACnB,GAAI,QAAQ,aAAa,QAAQ,CAAC,IAAI,CAAC,gBAAgB;CACvD,GAAI,QAAQ,oBAAoB,QAAQ,CAAC,cAAc,IAAI,CAAC;CAC5D,GAAI,QAAQ,UAAU,KAAA,IAClB,CAAC,IACD,CACE,kBAAkB,QAAQ,MAAM,UAEhC,uBAAuB,QAAQ,MAAM,UAAU,eACjD;CACJ,GAAI,QAAQ,QAAQ,CAAC;CACrB;AACF;AAEA,MAAM,WAAW,WAA2C,WAC1D,aAAa,KAAK;CAChB;CACA;CACA,SAAS,cAAc,UAAU,YAAY;AAC/C,CAAC;AAEH,MAAM,UAAU,UAAwB,MAAM,aAAa,QAAQ,MAAM,eAAe;;AAGxF,MAAM,SAAS,QAAyB;CACtC,IAAI;EACF,QAAQ,KAAK,CAAC,KAAK,CAAC;EAEpB,OAAO;CACT,SAAS,OAAO;EACd,IAAI,iBAAiB,SAAS,UAAU,SAAS,MAAM,SAAS,SAAS,OAAO;EAChF,MAAM;CACR;AACF;AAEA,MAAM,eAAe,KAAa,WAA2B;CAC3D,IAAI;EACF,QAAQ,KAAK,CAAC,KAAK,MAAM;CAC3B,SAAS,OAAO;EACd,IAAI,EAAE,iBAAiB,SAAS,UAAU,SAAS,MAAM,SAAS,UAAU,MAAM;CACpF;AACF;;AAGA,MAAM,YAAY,OAAO,WAAW,WAClC,OACA,KACA,OACsC;CACtC,MAAM,UAAU,OAAO,IAAI;EACzB,WAAW,OAAO,KAAK,KAAK,CAAC,MAAM,GAAG;EACtC,aAAa,QAAQ,SAAS,QAAQ,OAAO,KAAK,CAAC,CAAC,CAAC;CACvD,CAAC;CAED,MAAM,UAAU,UACd,OAAO,IAAI;EACT,WAAW,YAAY,KAAK,KAAK;EACjC,aAAa,QAAQ,SAAS,QAAQ,OAAO,KAAK,CAAC,CAAC,CAAC;CACvD,CAAC;CAEH,MAAM,QAAQ,MAAM,MAAM,SAAS,OAAO,EAAE,CAAC;CAE7C,OAAO,OAAO,SAAS;CACvB,MAAM,WAAW,MAAM,yBAAyB,IAAI;CAEpD,OAAO,EAAE,OAAO,YAAY,MAAM,yBAAyB,IAAI,UAAU,OAAO;CAChF,IAAI,OAAO,SAAS;CACpB,OAAO,OAAO,SAAS;CACvB,MAAM,SAAS,MAAM,yBAAyB,IAAI;CAElD,OAAO,EAAE,OAAO,YAAY,MAAM,yBAAyB,IAAI,QAAQ,OAAO;CAC9E,IAAI,EAAE,OAAO,UAAU,OAAO,OAAO,QAAQ,SAAS,QAAQ,QAAQ,KAAK,CAAC,CAAC,CAAC;AAChF,CAAC;;AAGD,MAAa,SAAS,OAAO,WAAW,WACtC,SACiD;CACjD,IAAI,QAAQ,aAAa,SAAS,OAAO,OAAO,QAAQ,UAAU,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC;CAC9F,MAAM,OAAO,OAAO,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,KAAK,CAAC;CAC7D,MAAM,QAAQ,OAAO,MAAM;CAE3B,MAAM,aACJ,QAAQ,mBACP,OAAO,OAAO,WAAW;EACxB,KAAK,aAAa,MAAM,OAAO,mBAAA,CAAoB,SAAS,eAAe;EAC3E,aAAa,QAAQ,UAAU,QAAQ,OAAO,KAAK,CAAC,CAAC,CAAC;CACxD,CAAC;CAEH,MAAM,YAAY,OAAO,OAAO,WAAW;EACzC,WAAW,QAAQ,KAAK,KAAK,OAAO,GAAG,0BAA0B,CAAC;EAClE,aAAa,QAAQ,UAAU,QAAQ,OAAO,KAAK,CAAC,CAAC,CAAC;CACxD,CAAC;CAED,MAAM,gBAAgB,OAAO,WAAW;EACtC,WAAW,GAAG,WAAW;GAAE,WAAW;GAAM,OAAO;GAAM,YAAY;GAAG,YAAY;EAAG,CAAC;EACxF,aAAa,QAAQ,SAAS,QAAQ,OAAO,KAAK,CAAC,CAAC,CAAC;CACvD,CAAC;CAED,IAAI;CAEJ,OAAO,OAAO,OAAO,IAAI,aAAa;EACpC,MAAM,WAAW,OAAO,OAAO,WAAW;GACxC,WAAW;IACT,MAAM,UAAU,MAAM,YAAY,gBAAgB,SAAS,SAAS,GAAG;KACrE,KAAK;KACL,OAAO;MAAC;MAAU;MAAU;KAAQ;KACpC,UAAU;IACZ,CAAC;IAED,QAAQ;IAER,OAAO,IAAI,SAAuB,SAAS,WAAW;KACpD,QAAQ,KAAK,eAAe,QAAQ,OAAO,CAAC;KAC5C,QAAQ,KAAK,SAAS,MAAM;IAC9B,CAAC;GACH;GACA,aAAa,QAAQ,UAAU,QAAQ,OAAO,KAAK,CAAC,CAAC,CAAC;EACxD,CAAC;EAED,MAAM,MAAM,SAAS;EAErB,IAAI,QAAQ,KAAA,GAAW,OAAO,OAAO,QAAQ,UAAU,QAAQ,OAAO,KAAK,CAAC,CAAC,CAAC;EAO9E,OAAO;GACL,aAAa,kBACX,OAAO,IAAI,aAAa;IACtB,MAAM,WACJ,MAAM,yBAAyB,IAC/B,OAAO,KAAK,KAAK,KAAK,IAAI,eAAe,QAAQ,wBAAwB,IAAK,CAAC,CAAC,IAC9E;IAEJ,OAAO,MAAM,yBAAyB,IAAI,UAAU;KAClD,IAAI,OAAO,QAAQ,GAAG,OAAO,OAAO,QAAQ,WAAW,QAAQ,OAAO,KAAK,CAAC,CAAC,CAAC;KAE9E,MAAM,WAAW,OAAO,OAAO,WAAW;MACxC,MAAM,WACJ,SAAS,KAAK,KAAK,WAAW,oBAAoB,GAAG;OACnD,UAAU;OACV;MACF,CAAC,CAAC,CAAC,OAAO,UAAmB;OAC3B,IAAI,iBAAiB,SAAS,UAAU,SAAS,MAAM,SAAS,UAC9D,OAAO,KAAA;OACT,MAAM;MACR,CAAC;MACH,aAAa,QAAQ,WAAW,QAAQ,UAAU,KAAK,CAAC,CAAC,CAAC;KAC5D,CAAC;KAKD,MAAM,QAAQ,aAAa,KAAA,IAAY,CAAC,IAAI,SAAS,KAAK,CAAC,CAAC,MAAM,IAAI;KAEtE,IAAI,MAAM,UAAU,GAAG;MACrB,MAAM,WAAW,kBAAkB,MAAM,KAAK,MAAM;MAEpD,IAAI,CAAC,OAAO,GAAG,gBAAgB,CAAC,CAAC,QAAQ,GACvC,OAAO,OAAO,QAAQ,WAAW,QAAQ,UAAU,KAAK,CAAC,CAAC,CAAC;MAE7D,OAAO,SAAS,KAAK,QAAQ;KAC/B;KACA,OAAO,MAAM,MAAM,SAAS,OAAO,EAAE,CAAC;IACxC;IAEA,OAAO,OAAO,QAAQ,WAAW,QAAQ,QAAQ,KAAK,CAAC,CAAC,CAAC;GAC3D,CAAC;GACH,WAAW,OA9CU,OAAO,OAC5B,UAAU,UAAU,KAAK,KAAK,CAAC,CAAC,KAAK,OAAO,eAAe,CAC7D;GA6CE;EACF;CACF,CAAC,CAAC,CAAC,KACD,OAAO,QAAQ,SACb,KAAK,UAAU,IAAI,IACf,OAAO,OACP,OAAO,IAAI,aAAa;EACtB,IAAI,OAAO,QAAQ,KAAA,GAAW;GAC5B,OAAO,cAAc,KAAK,OAAO,MAAM;GAEvC;EACF;EACA,MAAM,UAAU,OAAO,UAAU,OAAO,MAAM,KAAK,KAAK,CAAC,CAAC,KAAK,OAAO,IAAI;EAE1E,IAAI,KAAK,UAAU,OAAO,GAAG,OAAO,cAAc,KAAK,OAAO,MAAM;CACtE,CAAC,CACP,CACF;AACF,CAAC;;;;ACpMD,MAAa,sBAAsB,OAAO,WAAW,WACnD,WACA,OACA,SACA;CACA,IAAI;CAiDJ,OAAO;EAAE,OAAA,OA/CY,OAAO,OAC1B,OAAO,gBACL,OAAO,IAAI,aAAa;GACtB,MAAM,SAAiC,CAAC;GAExC,MAAM,QAAc,MAAoC,WACtD,YAAY,QAAQ,GAAI,CAAC,CAAC,KACxB,OAAO,KAAK,WACV,OAAO,WAAW;IAChB,IAAI,OAAO,SAAS,WAClB,OAAO,KAAK,qBAAqB,KAAK;KAAE,MAAM;KAAM,QAAQ,OAAO;IAAO,CAAC,CAAC;GAChF,CAAC,CACH,CACF;GAEF,OAAO,KAAK,SAAS,MAAM,KAAK;GAChC,OAAO,KAAK,WAAW,MAAM,OAAO;GACpC,OAAO,KAAK,kBAAkB,MAAM,cAAc;GAClD,MAAM,eAAe,OAAO,KAAK,cAAc,MAAM,UAAU;GAE/D,MAAM,aACJ,YAAY,KAAA,IAAY,KAAA,IAAY,OAAO,KAAK,aAAa,QAAQ,SAAS;GAEhF,IAAI,YAAY,KAAA,KAAa,eAAe,KAAA,KAAa,WAAW,SAAS,WAC3E,OAAO,KAAK,WAAW,QAAQ,aAAa;GAE9C,MAAM,SAAS,sBAAsB,KAAK;IACxC;IACA,WAAW,YAAY,KAAA,IAAY,aAAa;IAChD,YAAY,aAAa,SAAS,YAAY,aAAa,QAAQ;IACnE,SACE,eAAe,KAAA,IACX,cACA,WAAW,SAAS,YAClB,eACA;IACR;GACF,CAAC;GAED,OAAO,OAAO,OAAO,MAAM;GAC3B,SAAS,OAAO,OAAO,MAAM;GAE7B,OAAO;EACT,CAAC,CACH,CACF;EAEgB,QAAQ,OAAO,WAAW,OAAO,cAAc,MAAM,CAAC;CAAE;AAC1E,CAAC;AAED,MAAM,mBAEF,UACA,SACA,eAED,UACC,OAAO,gBACL,OAAO,IAAI,aAAa;CAGtB,MAAM,UAAU,aAAa,KAAA,IAAY,OAAO,OAAO,OAAO,IAAI,KAAA;CAElE,MAAM,YAAY,OAAO,OACvB,kBAAkB,KAAK;EAAE,UAAU;EAAY,IAAI,WAAW,OAAO,WAAW;CAAE,CAAC,CACrF;CAEA,MAAM,UAAU,OAAO,oBAAoB,WAAW,OAAO,OAAO;CACpE,IAAI,UAAU;CAEd,MAAM,UAAU,OAAO,OAAO,OAC5B,OAAO,IAAI,aAAa;EACtB,UAAU;EACV,MAAM,SAAS,OAAO,QAAQ;EAE9B,IAAI,cAAc,KAAA,GAAW,OAAO,SAAS,OAAO,cAAc,UAAU,MAAM,CAAC,CAAC;EAEpF,OAAO;CACT,CAAC,CAAC,CAAC,KAAK,OAAO,eAAe,CAChC;CAEA,OAAO,OAAO,mBAAmB,QAAQ,KAAK,OAAO,MAAM,CAAC;CAE5D,OAAO;EACL;EACA,aAAa,kBACX,OAAO,cAAc;GACnB,IAAI,SACF,OAAO,OAAO,KACZ,aAAa,KAAK;IAChB,WAAW;IACX,QAAQ,QAAQ,OAAO,KAAK,CAAC,CAAC;IAC9B,SAAS;GACX,CAAC,CACH;GACF,IAAI,YAAY,KAAA,GAAW,OAAO,QAAQ,WAAW,aAAa;GAElE,OAAO,aAAa,KAAA,IAChB,OAAO,KACL,aAAa,KAAK;IAChB,WAAW;IACX,QAAQ,QAAQ,cAAc,KAAK,CAAC,CAAC;IACrC,SAAS;GACX,CAAC,CACH,IACA,QAAQ,kBAAkB,SAAS,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,KAC7D,OAAO,IAAI,SAAS,IAAI,CAC1B;EACN,CAAC;EACH;EACA,cAAc,QAAQ,KACpB,OAAO,cACJ,WACC,OAAO,eAAe,YACtB,OAAO,OAAO,WAAW,MACxB,OAAO,cAAc,aAClB,OAAO,YAAY,cACnB,OAAO,YAAY,qBAEvB,aAAa,KAAK;GAChB,WAAW;GACX,QAAQ,QAAQ,OAAO,KAAK,CAAC,CAAC;GAC9B,SAAS;EACX,CAAC,CACL,CACF;EACA,eAAe,QAAQ;EACvB,gBAAgB,QAAQ,OAAO,KAC7B,OAAO,KACJ,WACC,OAAO,OAAO,MAAM,KACpB,OAAO,MAAM,cAAc,WAC3B,OAAO,MAAM,YAAY,YAC7B,CACF;CACF;AACF,CAAC,CACH;AAEJ,MAAa,iBACX,SACA,cACG,gBAAgB,KAAA,GAAW,SAAS,SAAS;AAElD,MAAa,oBACX,UACA,cACG,gBAAgB,UAAU,CAAC,GAAG,SAAS;;;AC/H5C,IAAa,WAAb,MAAa,iBAAiB,QAAQ,QAyBpC,CAAC,CAAC,yBAAyB,CAAC,CAAC;;CAE7B,OAAO,OAA6B,QAAuB,SAA6B;EACtF,OAAO,OAAO,QAAQ,WAAW,YAAY,QAAQ,OAAO,QAAQ,OAAO,CAAC;CAC9E;;CAGA,OAAO,QAA8B,QAAuB,SAA6B;EACvF,OAAO,OAAO,QAAQ,WAAW,YAAY,QAAQ,QAAQ,QAAQ,OAAO,CAAC;CAC/E;;CAGA,OAAO,OACL,UACA,SACA;EACA,OAAO,OAAO,QAAQ,WAAW,YAAY,QAAQ,OAAO,UAAU,OAAO,CAAC;CAChF;CAEA,OAAO,MAAM,UAA2B,CAAC,GAAwC;EAC/E,OAAO,MAAM,OACX,UACA,OAAO,IAAI,aAAa;GACtB,MAAM,cAAc,OAAO,QAAQ,gBAAgB,QAAQ,UAAU,CAAC,GAAG,WAAW;GAEpF,MAAM,SAAS,OAAO,OAAO;IAC3B,GAAG;IACH,GAAI,YAAY,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,OAAO,OAAO,CAAC,GAAG,YAAY,IAAI,CAAC,EAAE;IACvF,GAAI,YAAY,UAAU,KAAA,IACtB,CAAC,IACD,EAAE,OAAO,OAAO,OAAO,EAAE,GAAG,YAAY,MAAM,CAAC,EAAE;GACvD,CAAC;GAED,IAAI,OAAO,UAAU,eAAe,KAAK,SAAS,WAAW,GAC3D,OAAO,OAAO,aAAa,KAAK;IAC9B,WAAW;IACX,QAAQ,QAAQ,cAAc,KAAK,CAAC,CAAC;IACrC,SAAS;GACX,CAAC;GAEH,MAAM,UAAU,OAAOA,KAAoB;IACzC,gBAAgB;IAChB,GAAI,QAAQ,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,QAAQ,SAAS;IACvE,YAAY;KACV,GAAI,QAAQ,wBAAwB,KAAA,IAChC,CAAC,IACD,EAAE,qBAAqB,QAAQ,oBAAoB;KACvD,GAAI,QAAQ,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,QAAQ,SAAS;KACvE,GAAI,QAAQ,iBAAiB,KAAA,IAAY,CAAC,IAAI,EAAE,cAAc,QAAQ,aAAa;KACnF,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;KAChF,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;KAChF,GAAI,QAAQ,iBAAiB,KAAA,IAAY,CAAC,IAAI,EAAE,cAAc,QAAQ,aAAa;KACnF,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;IAClF;GACF,CAAC;GAED,MAAM,UAAU,OAAO,WAAW,WAChC,QACA,UAA6B,CAAC,GAC9B,YACA;IACA,MAAM,WAAW,OAAO,QAAQ,QAC9B,QACA,eAAe,KAAA,IACX,cAAc,QAAQ,QAAQ,SAAS,IACvC,iBAAiB,WAAW,UAAU,QAAQ,SAAS,GAC3D;KACE,GAAG;KACH,GAAI,eAAe,KAAA,IACf,CAAC,IACD,EACE,gBACE,WAAW,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,WAAW,SAAS,EAC7E;IACN,CACF;IAEA,MAAM,YAAY,OAAO,OAAO,OAC9B,SAAS,QAAQ,KACf,OAAO,KAAK,EAAE,cACZ,OAAO,OAAO,SAAS;KACrB,WAAW,SAAS;KACpB,cAAc,QAAQ,aAAa,KACjC,OAAO,QAAQ,SAAS,SAAS,YAAY,CAC/C;KACA,OAAO,SAAS;KAChB,eAAe,SAAS,SAAS;IACnC,CAAC,CACH,CACF,CACF;IAEA,OAAO;KACL,WAAW,SAAS;KACpB,SAAS,SAAS;KAClB,OAAO,SAAS;KAChB,SAAS,SAAS,QAAQ,KAAK,OAAO,QAAQ,SAAS,CAAC;IAC1D;GACF,CAAC;GAED,OAAO,SAAS,GAAG;IACjB;IACA,SAAS,QAAQ,YACf,QAAQ,QAAQ,OAAO,CAAC,CAAC,KAAK,OAAO,SAAS,aAAa,SAAS,OAAO,CAAC;IAC9E,SAAS,UAAU,YACjB,OAAO,IAAI,aAAa;KACtB,MAAM,UAAU,OAAO,QAAQ,kBAAkB,SAAS,MAAM,QAAQ,GAAG,SAAS;KAEpF,OAAO,QAAQ,OAAO,QAAQ,QAAQ,QAAQ,SAAS;MACrD,UAAU,SAAS,KAAK,OAAO;MAC/B,GAAI,QAAQ,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,QAAQ,OAAO,SAAS;KAC9E,CAAC,EAAA,CAAG;IACN,CAAC;GACL,CAAC;EACH,CAAC,CACH;CACF;AACF"}

package/dist/Errors.d.mts

@@ -0,0 +1,106 @@
+import { Schema } from "effect";
+//#region src/Errors.d.ts
+/**
+ * What a caller asked the owned browser to do. The vocabulary is closed: the owner stamps it
+ * when it admits an operation, so a native step's own name can never become API, and a new
+ * spelling is a deliberate edit here rather than a string that merely compiles.
+ */
+export declare const BrowserOperation: Schema.Literals<readonly ["configure", "launch", "connect", "reconnect", "detach", "disconnect", "close", "handoff", "resume", "live-view", "target", "handle", "list-pages", "list-frames", "select-page", "select-frame", "new-page", "close-page", "resize", "ready", "observe", "checkpoint", "control-facts", "revalidate", "read-text", "screenshot", "wait", "navigate", "navigate-stop", "click", "fill", "select-option", "scroll", "click-and-wait", "download-action", "select-files", "file-chooser", "action-result", "pointer-move", "hover", "wheel", "press", "type", "page-control", "page-state", "page-suspend", "page-resume", "capture", "capture-start", "capture-stop", "capture-consume"]>;
+export type BrowserOperation = typeof BrowserOperation.Type;
+/** Dispatch evidence belongs to the operation, independently of its failure reason. */
+export declare const BrowserOutcome: Schema.Literals<readonly ["undispatched", "rejected", "unknown"]>;
+export type BrowserOutcome = typeof BrowserOutcome.Type;
+/** Limits report measured producer facts; an unavailable measurement is never invented. */
+export declare const LimitDimension: Schema.Literals<readonly ["actions", "elapsed", "returned-bytes", "pages", "frames", "frame-depth", "buffered-frames", "buffered-bytes", "host-reads", "controls", "text", "captures", "frame-bytes", "width", "height", "pixels"]>;
+/** Validated constructors for host reasons. The model receives a separate bounded projection. */
+export declare const Reasons: {
+  readonly Configuration: Schema.TaggedStruct<"Configuration", {
+    readonly path: Schema.optionalKey<Schema.String>;
+  }>;
+  readonly UnregisteredSession: Schema.TaggedStruct<"UnregisteredSession", {}>;
+  readonly Unsupported: Schema.TaggedStruct<"Unsupported", {}>;
+  readonly Busy: Schema.TaggedStruct<"Busy", {}>;
+  readonly Closed: Schema.TaggedStruct<"Closed", {}>;
+  readonly Stale: Schema.TaggedStruct<"Stale", {}>;
+  readonly NotFound: Schema.TaggedStruct<"NotFound", {}>;
+  readonly Ambiguous: Schema.TaggedStruct<"Ambiguous", {}>;
+  readonly Malformed: Schema.TaggedStruct<"Malformed", {
+    readonly path: Schema.optionalKey<Schema.String>;
+  }>;
+  readonly Limit: Schema.TaggedStruct<"Limit", {
+    readonly dimension: Schema.Literals<readonly ["actions", "elapsed", "returned-bytes", "pages", "frames", "frame-depth", "buffered-frames", "buffered-bytes", "host-reads", "controls", "text", "captures", "frame-bytes", "width", "height", "pixels"]>;
+    readonly maximum: Schema.Natural;
+    readonly observed: Schema.Natural;
+  }>;
+  readonly Timeout: Schema.TaggedStruct<"Timeout", {}>;
+  readonly Transport: Schema.TaggedStruct<"Transport", {
+    readonly status: Schema.optionalKey<Schema.Int>;
+  }>;
+  readonly Provider: Schema.TaggedStruct<"Provider", {
+    readonly status: Schema.optionalKey<Schema.Int>;
+  }>;
+  readonly Authorization: Schema.TaggedStruct<"Authorization", {}>;
+  readonly RateLimited: Schema.TaggedStruct<"RateLimited", {
+    readonly retryAfterMillis: Schema.optionalKey<Schema.Natural>;
+  }>;
+  readonly Disconnected: Schema.TaggedStruct<"Disconnected", {}>;
+  readonly Active: Schema.TaggedStruct<"Active", {}>;
+  readonly Disabled: Schema.TaggedStruct<"Disabled", {}>;
+  readonly Expired: Schema.TaggedStruct<"Expired", {}>;
+  readonly Failed: Schema.TaggedStruct<"Failed", {}>;
+  readonly UnsafeUrl: Schema.TaggedStruct<"UnsafeUrl", {}>;
+  readonly ContentType: Schema.TaggedStruct<"ContentType", {}>;
+  readonly Timestamp: Schema.TaggedStruct<"Timestamp", {}>;
+  readonly Resized: Schema.TaggedStruct<"Resized", {}>;
+  readonly TargetChanged: Schema.TaggedStruct<"TargetChanged", {}>;
+  readonly Interrupted: Schema.TaggedStruct<"Interrupted", {}>;
+  readonly ContextLease: Schema.TaggedStruct<"ContextLease", {}>;
+  readonly NotVisible: Schema.TaggedStruct<"NotVisible", {}>;
+  readonly Denied: Schema.TaggedStruct<"Denied", {}>;
+  readonly NotFocused: Schema.TaggedStruct<"NotFocused", {}>;
+};
+export declare const BrowserReason: Schema.Union<(Schema.TaggedStruct<"Active", {}> | Schema.TaggedStruct<"Ambiguous", {}> | Schema.TaggedStruct<"Authorization", {}> | Schema.TaggedStruct<"Busy", {}> | Schema.TaggedStruct<"Closed", {}> | Schema.TaggedStruct<"Configuration", {
+  readonly path: Schema.optionalKey<Schema.String>;
+}> | Schema.TaggedStruct<"ContentType", {}> | Schema.TaggedStruct<"ContextLease", {}> | Schema.TaggedStruct<"Denied", {}> | Schema.TaggedStruct<"Disabled", {}> | Schema.TaggedStruct<"Disconnected", {}> | Schema.TaggedStruct<"Expired", {}> | Schema.TaggedStruct<"Failed", {}> | Schema.TaggedStruct<"Interrupted", {}> | Schema.TaggedStruct<"Limit", {
+  readonly dimension: Schema.Literals<readonly ["actions", "elapsed", "returned-bytes", "pages", "frames", "frame-depth", "buffered-frames", "buffered-bytes", "host-reads", "controls", "text", "captures", "frame-bytes", "width", "height", "pixels"]>;
+  readonly maximum: Schema.Natural;
+  readonly observed: Schema.Natural;
+}> | Schema.TaggedStruct<"Malformed", {
+  readonly path: Schema.optionalKey<Schema.String>;
+}> | Schema.TaggedStruct<"NotFocused", {}> | Schema.TaggedStruct<"NotFound", {}> | Schema.TaggedStruct<"NotVisible", {}> | Schema.TaggedStruct<"Provider", {
+  readonly status: Schema.optionalKey<Schema.Int>;
+}> | Schema.TaggedStruct<"RateLimited", {
+  readonly retryAfterMillis: Schema.optionalKey<Schema.Natural>;
+}> | Schema.TaggedStruct<"Resized", {}> | Schema.TaggedStruct<"Stale", {}> | Schema.TaggedStruct<"TargetChanged", {}> | Schema.TaggedStruct<"Timeout", {}> | Schema.TaggedStruct<"Timestamp", {}> | Schema.TaggedStruct<"Transport", {
+  readonly status: Schema.optionalKey<Schema.Int>;
+}> | Schema.TaggedStruct<"UnregisteredSession", {}> | Schema.TaggedStruct<"UnsafeUrl", {}> | Schema.TaggedStruct<"Unsupported", {}>)[]>;
+export type BrowserReason = typeof BrowserReason.Type;
+declare const BrowserError_base: Schema.Class<BrowserError, Schema.TaggedStruct<"BrowserError", {
+  readonly operation: Schema.Literals<readonly ["configure", "launch", "connect", "reconnect", "detach", "disconnect", "close", "handoff", "resume", "live-view", "target", "handle", "list-pages", "list-frames", "select-page", "select-frame", "new-page", "close-page", "resize", "ready", "observe", "checkpoint", "control-facts", "revalidate", "read-text", "screenshot", "wait", "navigate", "navigate-stop", "click", "fill", "select-option", "scroll", "click-and-wait", "download-action", "select-files", "file-chooser", "action-result", "pointer-move", "hover", "wheel", "press", "type", "page-control", "page-state", "page-suspend", "page-resume", "capture", "capture-start", "capture-stop", "capture-consume"]>;
+  readonly reason: Schema.Union<(Schema.TaggedStruct<"Active", {}> | Schema.TaggedStruct<"Ambiguous", {}> | Schema.TaggedStruct<"Authorization", {}> | Schema.TaggedStruct<"Busy", {}> | Schema.TaggedStruct<"Closed", {}> | Schema.TaggedStruct<"Configuration", {
+    readonly path: Schema.optionalKey<Schema.String>;
+  }> | Schema.TaggedStruct<"ContentType", {}> | Schema.TaggedStruct<"ContextLease", {}> | Schema.TaggedStruct<"Denied", {}> | Schema.TaggedStruct<"Disabled", {}> | Schema.TaggedStruct<"Disconnected", {}> | Schema.TaggedStruct<"Expired", {}> | Schema.TaggedStruct<"Failed", {}> | Schema.TaggedStruct<"Interrupted", {}> | Schema.TaggedStruct<"Limit", {
+    readonly dimension: Schema.Literals<readonly ["actions", "elapsed", "returned-bytes", "pages", "frames", "frame-depth", "buffered-frames", "buffered-bytes", "host-reads", "controls", "text", "captures", "frame-bytes", "width", "height", "pixels"]>;
+    readonly maximum: Schema.Natural;
+    readonly observed: Schema.Natural;
+  }> | Schema.TaggedStruct<"Malformed", {
+    readonly path: Schema.optionalKey<Schema.String>;
+  }> | Schema.TaggedStruct<"NotFocused", {}> | Schema.TaggedStruct<"NotFound", {}> | Schema.TaggedStruct<"NotVisible", {}> | Schema.TaggedStruct<"Provider", {
+    readonly status: Schema.optionalKey<Schema.Int>;
+  }> | Schema.TaggedStruct<"RateLimited", {
+    readonly retryAfterMillis: Schema.optionalKey<Schema.Natural>;
+  }> | Schema.TaggedStruct<"Resized", {}> | Schema.TaggedStruct<"Stale", {}> | Schema.TaggedStruct<"TargetChanged", {}> | Schema.TaggedStruct<"Timeout", {}> | Schema.TaggedStruct<"Timestamp", {}> | Schema.TaggedStruct<"Transport", {
+    readonly status: Schema.optionalKey<Schema.Int>;
+  }> | Schema.TaggedStruct<"UnregisteredSession", {}> | Schema.TaggedStruct<"UnsafeUrl", {}> | Schema.TaggedStruct<"Unsupported", {}>)[]>;
+  readonly outcome: Schema.Literals<readonly ["undispatched", "rejected", "unknown"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class BrowserError extends BrowserError_base {}
+declare const InitializationError_base: Schema.Class<InitializationError, Schema.TaggedStruct<"InitializationError", {
+  readonly operation: Schema.Literals<readonly ["configure", "register", "ready", "callback", "dispose"]>;
+  readonly step: Schema.String;
+  readonly reason: Schema.Literals<readonly ["configuration", "unsupported", "origin", "stale", "busy", "closed", "timeout", "input", "output", "native"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class InitializationError extends InitializationError_base {}
+//#endregion
+export {};
+//# sourceMappingURL=Errors.d.mts.map