@storyshelf/core 0.7.0 → 0.9.0-next-d2cc082

package/dist/adapters/notifier/format.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { ChannelToggles, FormattedNotification, NotificationBrand, NotificationEvent, SystemNotification } from "./types.mjs";
-//#region src/adapters/notifier/format.d.ts
 /**
  * Format a project event into subject/text/markdown/html using brand +
  * channel toggles. Pure (no I/O) so settings preview and senders share it.
@@ -9,6 +8,5 @@ import { ChannelToggles, FormattedNotification, NotificationBrand, NotificationE
 declare function formatNotification(event: NotificationEvent, brand?: NotificationBrand, toggles?: ChannelToggles): FormattedNotification;
 /** Format a site-wide admin alert (no project scope, always verbose). */
 declare function formatSystemNotification(event: SystemNotification, brand?: NotificationBrand): FormattedNotification;
-//#endregion
 export { formatNotification, formatSystemNotification };
 //# sourceMappingURL=format.d.mts.map

package/dist/adapters/notifier/format.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/adapters/notifier/format.ts
+// src/adapters/notifier/format.ts
 /** Escape HTML special chars in free-form values (commit messages, names). */
 function esc(value) {
 	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
@@ -90,7 +90,6 @@ function formatSystemNotification(event, brand) {
 		subjectPrefix: "[Shelf sys]"
 	});
 }
-//#endregion
 export { formatNotification, formatSystemNotification };
 
 //# sourceMappingURL=format.mjs.map

package/dist/adapters/notifier/provider.d.mts

@@ -4,7 +4,6 @@ import { FormattedNotification, NotificationChannel, NotifierState, NotifierStat
 import { Adapter, AdapterMetadata } from "../../adapter/metadata.mjs";
 import { z } from "zod";
 import { Logger } from "pino";
-//#region src/adapters/notifier/provider.d.ts
 /** How a provider delivers: `message` sends once, `state` makes a host show a named state. */
 type NotifierDelivery = "message" | "state";
 /** Notifier-specific metadata (adds logo + config validation schema). */
@@ -73,6 +72,5 @@ interface StateNotifierAdapter extends Adapter<StateNotifierMetadata> {
 type NotifierAdapter = MessageNotifierAdapter | StateNotifierAdapter;
 /** True when the provider delivers state (git hosts) rather than messages. */
 declare function isStateProvider(provider: NotifierProvider): provider is StateNotifierProvider;
-//#endregion
 export { MessageNotifierAdapter, MessageNotifierMetadata, MessageNotifierProvider, NotifierAdapter, NotifierDelivery, NotifierMetadata, NotifierProvider, SetStateInput, StateNotifierAdapter, StateNotifierMetadata, StateNotifierProvider, isStateProvider };
 //# sourceMappingURL=provider.d.mts.map

package/dist/adapters/notifier/provider.mjs

@@ -1,12 +1,11 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/adapters/notifier/provider.ts
+// src/adapters/notifier/provider.ts
 /** True when the provider delivers state (git hosts) rather than messages. */
 function isStateProvider(provider) {
 	return provider.metadata.delivery === "state";
 }
-//#endregion
 export { isStateProvider };
 
 //# sourceMappingURL=provider.mjs.map

package/dist/adapters/notifier/state.d.mts

@@ -4,7 +4,6 @@ import { Logger } from "../../logger.mjs";
 import { NotificationChannel } from "./types.mjs";
 import { StateNotifierProvider } from "./provider.mjs";
 import { BuildStateSet } from "./build-state.mjs";
-//#region src/adapters/notifier/state.d.ts
 /** Default status-name prefix of a git channel (`<prefix>/testing`). */
 declare const DEFAULT_STATUS_PREFIX = "storyshelf";
 /** The channel's status-name prefix: its `prefix` config, else {@link DEFAULT_STATUS_PREFIX}. */
@@ -19,6 +18,5 @@ declare function writeBuildState(provider: StateNotifierProvider, channel: Notif
   states: BuildStateSet;
   logger?: Logger | undefined;
 }): Promise<void>;
-//#endregion
 export { DEFAULT_STATUS_PREFIX, channelPrefix, writeBuildState };
 //# sourceMappingURL=state.d.mts.map

package/dist/adapters/notifier/state.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/adapters/notifier/state.ts
+// src/adapters/notifier/state.ts
 /** Default status-name prefix of a git channel (`<prefix>/testing`). */
 const DEFAULT_STATUS_PREFIX = "storyshelf";
 /** The channel's status-name prefix: its `prefix` config, else {@link DEFAULT_STATUS_PREFIX}. */
@@ -60,7 +60,6 @@ async function writeBuildState(provider, channel, write) {
 		});
 	}
 }
-//#endregion
 export { DEFAULT_STATUS_PREFIX, channelPrefix, writeBuildState };
 
 //# sourceMappingURL=state.mjs.map

package/dist/adapters/notifier/types.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/adapters/notifier/types.d.ts
 /** Shared event envelope for human-facing notifications. */
 interface NotificationEvent {
   event: string;
@@ -100,6 +99,5 @@ interface SystemNotification {
 }
 /** Site-wide events for admins (new users, failures, purge). */
 type SystemEventName = "sys:user-created" | "sys:invite-issued" | "sys:auth-failed" | "sys:capture-failed" | "sys:purge-completed" | "sys:notify-failed" | "sys:ai-budget";
-//#endregion
 export { ChannelOutcome, ChannelToggles, FormattedNotification, NotificationBrand, NotificationChannel, NotificationEvent, NotifierState, NotifierStateTarget, StateAnnotation, SystemEventName, SystemNotification };
 //# sourceMappingURL=types.d.mts.map

package/dist/adapters/remote-browser.d.mts

@@ -1,51 +1,138 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { BrowserName, CaptureTarget, TargetReach } from "./capture-target.mjs";
-//#region src/adapters/remote-browser.d.ts
 /** How a runner talks to the service: Playwright's own protocol, or the Chrome DevTools Protocol. */
 type RemoteProtocol = "playwright" | "cdp";
-/** Where and how to connect for one engine. Re-evaluated on every connect, so a token can be fresh. */
+/** Where and how to connect. A function `connect` is called per connection, so a token can be fresh. */
 interface RemoteConnection {
-  protocol: RemoteProtocol;
   /** `ws(s)://…` (CDP also accepts `http(s)://…`). May carry credentials: it is never logged. */
   endpoint: string;
   /** Request headers for the handshake, such as `authorization`. Never logged. */
   headers?: Record<string, string>;
+}
+/** A connection a function `connect` returns, with what `release` needs back. */
+interface RemoteLeasedConnection<TLease = unknown> extends RemoteConnection {
+  /** Opaque to the runner, handed to `release` once and never logged (it may carry credentials). */
+  lease?: TLease | undefined;
+}
+/** What a run is doing when it connects. */
+type RemotePurpose = "render" | "extract" | "tests";
+/** How a leased connection ended, handed to `release`. */
+type RemoteLeaseOutcome = "finished" | "failed" | "cancelled";
+/** What a function `connect` is told about the connection it is asked for. */
+interface RemoteConnectContext {
+  engine: BrowserName;
+  /** The StoryShelf build; the same for every shard of it. */
+  buildId: string;
+  /** The shard's own id; the build id when the render is not sharded. */
+  runId: string;
+  /** The shard's 1-based position in the build's plan; `undefined` (never 0) when not sharded. */
+  shardIndex?: number | undefined;
+  /** `render` for a build or shard, `extract` for the parameter pre-pass, `tests` for `.test()` entries. */
+  purpose: RemotePurpose;
+  /** This connection's attempt, from 1; each retry connects anew. */
+  attempt: number;
   /**
-   * Playwright `connect` only: `"<loopback>"` routes the remote browser's requests for `127.0.0.1`
-   * back through the connection, so the loopback Storybook server works unchanged (decision 5).
+   * Aborts while `connect` is pending: on `timeouts.acquireMs`, a cancel (user, build, render
+   * budget) and shutdown. Spent once `connect` resolves.
    */
-  exposeNetwork?: string;
+  signal: AbortSignal;
+}
+/** What `release` is told about how the connection's render went. */
+interface RemoteReleaseInfo {
+  outcome: RemoteLeaseOutcome;
+  /** Why it failed, for `failed`. Carries no credentials, but may carry provider text. */
+  error?: unknown;
 }
 /** What {@link defineRemote} takes: what `remote()` exposes to operators. */
-interface RemoteOptions {
+interface RemoteOptions<TLease = unknown> {
   /** The target name half (`chromium@<name>`): lowercase letters, digits and hyphens, at most 32. */
   name: string;
   /** The engines to offer (a subset of what the service has). */
   engines: readonly BrowserName[];
-  /** The connection for an engine. Pure: it is called once at creation to validate it. */
-  connect: (engine: BrowserName) => RemoteConnection;
-  /** Parallel sessions the plan allows: the page cap of the target, per process (decision 4). */
-  sessions: number;
+  /** Parallel sessions the plan allows: the page cap of the target, per process (decision 4). A function is read live. */
+  sessions: number | (() => number);
+  /** Maximum concurrent pages on each browser connection; independent of the shared session gate. */
+  maxPagesPerConnection?: number | undefined;
+  /**
+   * Maximum connections this process holds to the service at once (default: no cap). A separate
+   * limit from `sessions` (pages) and `maxPagesPerConnection`: a connection counts from the moment
+   * it is requested until its render has ended, a shared one once. Renders over the cap wait, and a
+   * cancel or shutdown ends the wait. Per process; the deployment-wide cap is another issue.
+   */
+  maxConnections?: number | undefined;
+  /**
+   * Marks a vendor preset as experimental: written against the provider's documentation and not
+   * verified against live infrastructure. Reported in the run's sizing log and the docs; it changes
+   * no behavior.
+   */
+  experimental?: boolean | undefined;
+  /** Declared, never inferred: how the runner talks to the service. */
+  protocol: RemoteProtocol;
+  /**
+   * Declared, never inferred: `loopback` when the remote browser can route back to this host
+   * (Playwright's `exposeNetwork: "<loopback>"`), else `url` (it needs a signed Storybook URL).
+   */
+  reach: TargetReach;
+  /**
+   * The connection: an object for a fixed service (validated at creation), or a function called
+   * for every connection (sync or async) to wake or start something, pick a server per shard, or
+   * mint a token. A throw is retried and ends as a `TargetLaunchError`.
+   */
+  connect: RemoteConnection | ((context: RemoteConnectContext) => RemoteLeasedConnection<TLease> | Promise<RemoteLeasedConnection<TLease>>);
+  /**
+   * Called once for every connection `connect` returned a `lease` for, after the render that used
+   * it finished, failed or was cancelled (and for leases still held at shutdown, `cancelled`).
+   * Only valid with a function `connect`. A throw or a timeout (`timeouts.releaseMs`) is logged and
+   * never fails the render.
+   */
+  release?: ((lease: TLease, info: RemoteReleaseInfo) => Promise<void> | void) | undefined;
   /** OS the service renders on, reported when the page cannot tell (`linux-x64`, `windows`, …). */
   platform?: string | undefined;
-  /** Connect retries before the render fails (default 3). */
-  connectRetries?: number | undefined;
-  /** First backoff between connect attempts in ms, doubling each time (default 500). */
-  connectBackoffMs?: number | undefined;
+  /** Connect retries: `attempts` after the first (default 3), `backoffMs` doubling (default 500). */
+  retry?: {
+    attempts?: number | undefined;
+    backoffMs?: number | undefined;
+  } | undefined;
   /**
-   * How long one connect attempt waits in ms (default 30 000). A farm with a client cap queues
-   * extra connections instead of refusing them, so a busy farm shows up as this timeout.
+   * `acquireMs` bounds the `connect` function, `connectMs` the handshake after it (a farm with a
+   * client cap queues extra connections, so a busy farm shows up as this timeout), `releaseMs`
+   * the `release` hook. All default to 30 000. `probeMs` bounds measuring the browser's
+   * environment once connected (default 15 000): a probe that overruns leaves the environment
+   * unknown with a warning, and a cancel stops it at once.
    */
-  connectTimeoutMs?: number | undefined;
+  timeouts?: {
+    acquireMs?: number | undefined;
+    connectMs?: number | undefined;
+    releaseMs?: number | undefined;
+    probeMs?: number | undefined;
+  } | undefined;
 }
 /** One remote service, validated: an entry of a runner's `browsers`. */
-interface RemoteBrowser extends Required<Pick<RemoteOptions, "name" | "engines" | "connect" | "sessions">> {
+interface RemoteBrowser {
   readonly kind: "remote";
+  readonly name: string;
+  readonly engines: readonly BrowserName[];
+  readonly sessions: number | (() => number);
+  readonly maxPagesPerConnection?: number | undefined;
+  readonly maxConnections?: number | undefined;
+  /** A vendor preset not verified against live infrastructure (see {@link RemoteOptions.experimental}). */
+  readonly experimental?: boolean | undefined;
+  readonly protocol: RemoteProtocol;
+  readonly reach: TargetReach;
+  readonly connect: RemoteOptions["connect"];
+  readonly release: ((lease: never, info: RemoteReleaseInfo) => Promise<void> | void) | undefined;
   readonly platform: string | undefined;
-  readonly connectRetries: number;
-  readonly connectBackoffMs: number;
-  readonly connectTimeoutMs: number;
+  readonly retry: {
+    readonly attempts: number;
+    readonly backoffMs: number;
+  };
+  readonly timeouts: {
+    readonly acquireMs: number;
+    readonly connectMs: number;
+    readonly releaseMs: number;
+    readonly probeMs: number;
+  };
 }
 /** What a runner supports, which {@link defineRemote} checks the service against. */
 interface RemoteSupport {
@@ -67,21 +154,23 @@ interface RemoteTarget {
 }
 /**
  * Validate a remote service eagerly, so a mistake fails when the runner is created and not when the
- * first build runs: the name, the sessions, the engines against what the runner drives, and the
- * connection of every engine (protocol, endpoint scheme, CDP being Chromium only).
+ * first build runs: unknown or moved options, the name, the sessions, the engines against what the
+ * runner drives, the protocol, the reach, and a fixed connection (endpoint scheme).
  */
-declare function defineRemote(options: RemoteOptions, support: RemoteSupport): RemoteBrowser;
+declare function defineRemote<TLease = unknown>(options: RemoteOptions<TLease>, support: RemoteSupport): RemoteBrowser;
 /** The targets a service offers, in the order of its `engines`. */
 declare function remoteTargetsOf(remote: RemoteBrowser): RemoteTarget[];
-/** `loopback` when the remote browser can route back to this host, else it needs a URL (decision 5). */
-declare function reachOf(connection: RemoteConnection): TargetReach;
 /** Whether a value is a remote service entry. */
 declare function isRemoteBrowser(value: unknown): value is RemoteBrowser;
+/** Whether `endpoint` has a scheme `protocol` can open. */
+declare function hasSchemeFor(protocol: RemoteProtocol, endpoint: string): boolean;
 /**
  * Remove what identifies the connection from text surfaced to operators: the endpoint (it can carry
- * a key in its path or query), its host and path, its query values and every header value.
+ * a key in its path or query), its host and path, its query values, every header value and every
+ * value inside the lease (non-strings are stringified).
  */
-declare function scrubConnection(text: string, connection: RemoteConnection): string;
-//#endregion
-export { RemoteBrowser, RemoteConnection, RemoteOptions, RemoteProtocol, RemoteSupport, RemoteTarget, defineRemote, isRemoteBrowser, reachOf, remoteTargetsOf, scrubConnection };
+declare function scrubConnection(text: string, connection: RemoteConnection & {
+  lease?: unknown;
+}): string;
+export { RemoteBrowser, RemoteConnectContext, RemoteConnection, RemoteLeaseOutcome, RemoteLeasedConnection, RemoteOptions, RemoteProtocol, RemotePurpose, RemoteReleaseInfo, RemoteSupport, RemoteTarget, defineRemote, hasSchemeFor, isRemoteBrowser, remoteTargetsOf, scrubConnection };
 //# sourceMappingURL=remote-browser.d.mts.map

package/dist/adapters/remote-browser.mjs

@@ -2,12 +2,14 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { TARGET_NAME_PATTERN, isBrowserName } from "./capture-target.mjs";
-//#region src/adapters/remote-browser.ts
+// src/adapters/remote-browser.ts
 /**
 * Remote browsers (ADR 0007, decisions 1 and 3): one service a runner connects to instead of
 * launching a browser, expanding to one `<engine>@<name>` target per engine. Presets are plain
 * configuration over {@link defineRemote}; the runners add only what they can drive.
 */
+/** Default bound on measuring a connected remote browser's environment (`timeouts.probeMs`). */
+const DEFAULT_PROBE_MS = 15e3;
 const CDP_ENGINES = /* @__PURE__ */ new Set(["chromium", "chrome"]);
 const SCHEMES = {
 	playwright: ["ws:", "wss:"],
@@ -18,27 +20,63 @@ const SCHEMES = {
 		"https:"
 	]
 };
+/** Options 0.7 took that 0.8 renamed or removed, with what replaces them (a loud migration error). */
+const MOVED = {
+	acquire: "merge it into `connect` (a function that receives a context)",
+	exposeNetwork: "declare `reach: \"loopback\"` on the service instead",
+	connectRetries: "use `retry: { attempts }`",
+	connectBackoffMs: "use `retry: { backoffMs }`",
+	connectTimeoutMs: "use `timeouts: { connectMs }`",
+	acquireTimeoutMs: "use `timeouts: { acquireMs }`"
+};
+const KNOWN = /* @__PURE__ */ new Set([
+	"name",
+	"engines",
+	"sessions",
+	"maxPagesPerConnection",
+	"maxConnections",
+	"experimental",
+	"protocol",
+	"reach",
+	"connect",
+	"release",
+	"platform",
+	"retry",
+	"timeouts"
+]);
 /**
 * Validate a remote service eagerly, so a mistake fails when the runner is created and not when the
-* first build runs: the name, the sessions, the engines against what the runner drives, and the
-* connection of every engine (protocol, endpoint scheme, CDP being Chromium only).
+* first build runs: unknown or moved options, the name, the sessions, the engines against what the
+* runner drives, the protocol, the reach, and a fixed connection (endpoint scheme).
 */
 function defineRemote(options, support) {
-	const { label } = support;
-	if (!TARGET_NAME_PATTERN.test(options.name)) throw new Error(`${label}: name "${options.name}" must be lowercase letters, digits and hyphens, start with a letter or digit and be at most 32 characters`);
-	if (!Number.isInteger(options.sessions) || options.sessions < 1) throw new Error(`${label} "${options.name}": sessions must be a positive integer`);
-	checkEngines(options, support);
-	for (const engine of options.engines) checkConnection(label, options, engine, support);
+	const plain = options;
+	checkOptions(plain, support);
+	checkEngines(plain, support);
+	checkProtocol(plain, support);
 	return {
 		kind: "remote",
 		name: options.name,
 		engines: [...options.engines],
-		connect: options.connect,
 		sessions: options.sessions,
+		maxPagesPerConnection: options.maxPagesPerConnection,
+		maxConnections: options.maxConnections,
+		experimental: options.experimental === true,
+		protocol: options.protocol,
+		reach: options.reach,
+		connect: options.connect,
+		release: options.release,
 		platform: options.platform,
-		connectRetries: options.connectRetries ?? 3,
-		connectBackoffMs: options.connectBackoffMs ?? 500,
-		connectTimeoutMs: options.connectTimeoutMs ?? 3e4
+		retry: {
+			attempts: options.retry?.attempts ?? 3,
+			backoffMs: options.retry?.backoffMs ?? 500
+		},
+		timeouts: {
+			acquireMs: options.timeouts?.acquireMs ?? 3e4,
+			connectMs: options.timeouts?.connectMs ?? 3e4,
+			releaseMs: options.timeouts?.releaseMs ?? 3e4,
+			probeMs: options.timeouts?.probeMs ?? 15e3
+		}
 	};
 }
 /** The targets a service offers, in the order of its `engines`. */
@@ -48,23 +86,36 @@ function remoteTargetsOf(remote) {
 		target: `${engine}@${remote.name}`,
 		engine,
 		remote,
-		reach: reachOf(remote.connect(engine))
+		reach: remote.reach
 	}));
 }
-/** `loopback` when the remote browser can route back to this host, else it needs a URL (decision 5). */
-function reachOf(connection) {
-	return connection.protocol === "playwright" && connection.exposeNetwork !== void 0 ? "loopback" : "url";
-}
 /** Whether a value is a remote service entry. */
 function isRemoteBrowser(value) {
 	return typeof value === "object" && value !== null && value.kind === "remote";
 }
+/** Whether `endpoint` has a scheme `protocol` can open. */
+function hasSchemeFor(protocol, endpoint) {
+	try {
+		return SCHEMES[protocol].includes(new URL(endpoint).protocol);
+	} catch {
+		return false;
+	}
+}
+/** The schemes `protocol` accepts, for messages. */
+function schemesOf(protocol) {
+	return SCHEMES[protocol].join(" or ");
+}
 /**
 * Remove what identifies the connection from text surfaced to operators: the endpoint (it can carry
-* a key in its path or query), its host and path, its query values and every header value.
+* a key in its path or query), its host and path, its query values, every header value and every
+* value inside the lease (non-strings are stringified).
 */
 function scrubConnection(text, connection) {
-	const secrets = [connection.endpoint, ...Object.values(connection.headers ?? {})];
+	const secrets = [
+		connection.endpoint,
+		...Object.values(connection.headers ?? {}),
+		...leaseSecrets(connection.lease)
+	];
 	try {
 		const url = new URL(connection.endpoint);
 		secrets.push(url.password, ...url.searchParams.values(), decodeURIComponent(url.search), `${url.protocol}//${url.host}${url.pathname}`, url.host, url.pathname);
@@ -73,6 +124,50 @@ function scrubConnection(text, connection) {
 	for (const secret of secrets.filter((value) => value.length >= 4).toSorted((a, b) => b.length - a.length)) scrubbed = scrubbed.replaceAll(secret, "[redacted]");
 	return scrubbed;
 }
+/** Every value of a lease, as text: a string whole, anything else stringified, objects walked. */
+function leaseSecrets(lease, depth = 0) {
+	if (lease === void 0 || lease === null) return [];
+	if (typeof lease === "object") return depth > 3 ? [] : Object.values(lease).flatMap((value) => leaseSecrets(value, depth + 1));
+	return typeof lease === "string" || typeof lease === "number" || typeof lease === "boolean" ? [String(lease)] : [];
+}
+function checkKnownKeys(options, where) {
+	for (const key of Object.keys(options)) if (!KNOWN.has(key)) {
+		const moved = MOVED[key];
+		throw new Error(moved === void 0 ? `${where}: unknown option "${key}"` : `${where}: option "${key}" is gone in 0.8: ${moved}`);
+	}
+}
+function checkOptions(options, { label }) {
+	const where = `${label} "${options.name}"`;
+	checkKnownKeys(options, where);
+	if (!TARGET_NAME_PATTERN.test(options.name)) throw new Error(`${label}: name "${options.name}" must be lowercase letters, digits and hyphens, start with a letter or digit and be at most 32 characters`);
+	checkSessions(options.sessions, where);
+	checkPositiveInteger("maxPagesPerConnection", options.maxPagesPerConnection, where);
+	checkPositiveInteger("maxConnections", options.maxConnections, where);
+	checkNumbers(options, where);
+	if (options.release !== void 0 && typeof options.connect !== "function") throw new Error(`${where}: release needs a function connect (a fixed connection has no lease)`);
+}
+/** An optional limit: absent, or a whole number of at least 1. */
+function checkPositiveInteger(name, value, where) {
+	if (value !== void 0 && (!Number.isInteger(value) || value < 1)) throw new Error(`${where}: ${name} must be a positive integer`);
+}
+function checkSessions(sessions, where) {
+	const value = typeof sessions === "function" ? sessions() : sessions;
+	if (!Number.isInteger(value) || value < 1) throw new Error(`${where}: sessions must be a positive integer`);
+}
+function checkNumbers(options, where) {
+	const entries = [
+		["retry.attempts", options.retry?.attempts],
+		["timeouts.acquireMs", options.timeouts?.acquireMs],
+		["timeouts.connectMs", options.timeouts?.connectMs],
+		["timeouts.releaseMs", options.timeouts?.releaseMs],
+		["timeouts.probeMs", options.timeouts?.probeMs],
+		["retry.backoffMs", options.retry?.backoffMs]
+	];
+	for (const [name, value] of entries) {
+		const allowed = name === "retry.attempts" || name === "retry.backoffMs" ? 0 : 1;
+		if (value !== void 0 && (!Number.isInteger(value) || value < allowed)) throw new Error(`${where}: ${name} must be an integer of at least ${allowed}`);
+	}
+}
 function checkEngines(options, support) {
 	const where = `${support.label} "${options.name}"`;
 	if (options.engines.length === 0) throw new Error(`${where}: engines must list at least one engine`);
@@ -82,22 +177,27 @@ function checkEngines(options, support) {
 		if (options.engines.indexOf(engine) !== index) throw new Error(`${where}: engine "${engine}" is listed twice`);
 	}
 }
-function checkConnection(label, options, engine, support) {
-	const where = `${label} "${options.name}" (${engine})`;
-	const connection = options.connect(engine);
-	if (!support.protocols.includes(connection.protocol)) throw new Error(`${where}: protocol "${connection.protocol}" is not supported by this runner (it speaks ${support.protocols.join(", ")})`);
-	if (connection.protocol === "cdp" && !CDP_ENGINES.has(engine)) throw new Error(`${where}: the CDP protocol drives Chromium only, not "${engine}"`);
-	if (connection.protocol === "cdp" && connection.exposeNetwork !== void 0) throw new Error(`${where}: exposeNetwork needs the "playwright" protocol`);
-	if (!SCHEMES[connection.protocol].some((scheme) => isScheme(connection.endpoint, scheme))) throw new Error(`${where}: the endpoint must be a ${SCHEMES[connection.protocol].join(" or ")} URL`);
+function checkProtocol(options, support) {
+	const where = `${support.label} "${options.name}"`;
+	checkDeclared(options, support, where);
+	if (options.protocol === "cdp") checkCdp(options, where);
+	if (typeof options.connect !== "function") checkFixedConnection(options.connect, options.protocol, where);
 }
-function isScheme(endpoint, scheme) {
-	try {
-		return new URL(endpoint).protocol === scheme;
-	} catch {
-		return false;
-	}
+function checkDeclared(options, support, where) {
+	if (options.protocol === void 0 || options.reach === void 0) throw new Error(`${where}: "protocol" and "reach" are required in 0.8 (declare how the runner talks to the service and whether its browser can reach this host)`);
+	if (!support.protocols.includes(options.protocol)) throw new Error(`${where}: protocol "${options.protocol}" is not supported by this runner (it speaks ${support.protocols.join(", ")})`);
+	if (options.reach !== "loopback" && options.reach !== "url") throw new Error(`${where}: reach must be "loopback" or "url"`);
+}
+function checkCdp(options, where) {
+	const bad = options.engines.find((engine) => !CDP_ENGINES.has(engine));
+	if (bad !== void 0) throw new Error(`${where}: the CDP protocol drives Chromium only, not "${bad}"`);
+	if (options.reach === "loopback") throw new Error(`${where}: reach "loopback" needs the "playwright" protocol`);
+}
+function checkFixedConnection(connection, protocol, where) {
+	const extra = Object.keys(connection).filter((key) => key !== "endpoint" && key !== "headers");
+	if (extra.length > 0) throw new Error(`${where}: connect has unknown field(s) ${extra.join(", ")}`);
+	if (!hasSchemeFor(protocol, connection.endpoint)) throw new Error(`${where}: the endpoint must be a ${schemesOf(protocol)} URL`);
 }
-//#endregion
-export { defineRemote, isRemoteBrowser, reachOf, remoteTargetsOf, scrubConnection };
+export { DEFAULT_PROBE_MS, defineRemote, hasSchemeFor, isRemoteBrowser, remoteTargetsOf, schemesOf, scrubConnection };
 
 //# sourceMappingURL=remote-browser.mjs.map

package/dist/adapters/remote-browser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"remote-browser.mjs","names":[],"sources":["../../src/adapters/remote-browser.ts"],"sourcesContent":["/**\n * Remote browsers (ADR 0007, decisions 1 and 3): one service a runner connects to instead of\n * launching a browser, expanding to one `<engine>@<name>` target per engine. Presets are plain\n * configuration over {@link defineRemote}; the runners add only what they can drive.\n */\nimport {\n  TARGET_NAME_PATTERN,\n  isBrowserName,\n  type BrowserName,\n  type CaptureTarget,\n  type TargetReach,\n} from \"./capture-target.ts\";\n\n/** How a runner talks to the service: Playwright's own protocol, or the Chrome DevTools Protocol. */\nexport type RemoteProtocol = \"playwright\" | \"cdp\";\n\n/** Where and how to connect for one engine. Re-evaluated on every connect, so a token can be fresh. */\nexport interface RemoteConnection {\n  protocol: RemoteProtocol;\n  /** `ws(s)://…` (CDP also accepts `http(s)://…`). May carry credentials: it is never logged. */\n  endpoint: string;\n  /** Request headers for the handshake, such as `authorization`. Never logged. */\n  headers?: Record<string, string>;\n  /**\n   * Playwright `connect` only: `\"<loopback>\"` routes the remote browser's requests for `127.0.0.1`\n   * back through the connection, so the loopback Storybook server works unchanged (decision 5).\n   */\n  exposeNetwork?: string;\n}\n\n/** What {@link defineRemote} takes: what `remote()` exposes to operators. */\nexport interface RemoteOptions {\n  /** The target name half (`chromium@<name>`): lowercase letters, digits and hyphens, at most 32. */\n  name: string;\n  /** The engines to offer (a subset of what the service has). */\n  engines: readonly BrowserName[];\n  /** The connection for an engine. Pure: it is called once at creation to validate it. */\n  connect: (engine: BrowserName) => RemoteConnection;\n  /** Parallel sessions the plan allows: the page cap of the target, per process (decision 4). */\n  sessions: number;\n  /** OS the service renders on, reported when the page cannot tell (`linux-x64`, `windows`, …). */\n  platform?: string | undefined;\n  /** Connect retries before the render fails (default 3). */\n  connectRetries?: number | undefined;\n  /** First backoff between connect attempts in ms, doubling each time (default 500). */\n  connectBackoffMs?: number | undefined;\n  /**\n   * How long one connect attempt waits in ms (default 30 000). A farm with a client cap queues\n   * extra connections instead of refusing them, so a busy farm shows up as this timeout.\n   */\n  connectTimeoutMs?: number | undefined;\n}\n\n/** One remote service, validated: an entry of a runner's `browsers`. */\nexport interface RemoteBrowser extends Required<\n  Pick<RemoteOptions, \"name\" | \"engines\" | \"connect\" | \"sessions\">\n> {\n  readonly kind: \"remote\";\n  readonly platform: string | undefined;\n  readonly connectRetries: number;\n  readonly connectBackoffMs: number;\n  readonly connectTimeoutMs: number;\n}\n\n/** What a runner supports, which {@link defineRemote} checks the service against. */\nexport interface RemoteSupport {\n  /** Engines the runner can drive. */\n  engines: readonly BrowserName[];\n  /** Protocols the runner can speak. */\n  protocols: readonly RemoteProtocol[];\n  /** Shown in errors, for example `remote()`. */\n  label: string;\n}\n\n/** One target a remote service offers. */\nexport interface RemoteTarget {\n  kind: \"remote\";\n  target: CaptureTarget;\n  engine: BrowserName;\n  remote: RemoteBrowser;\n  /** How the browser reaches the Storybook. */\n  reach: TargetReach;\n}\n\nconst CDP_ENGINES = new Set<BrowserName>([\"chromium\", \"chrome\"]);\nconst SCHEMES: Record<RemoteProtocol, readonly string[]> = {\n  playwright: [\"ws:\", \"wss:\"],\n  cdp: [\"ws:\", \"wss:\", \"http:\", \"https:\"],\n};\n\n/**\n * Validate a remote service eagerly, so a mistake fails when the runner is created and not when the\n * first build runs: the name, the sessions, the engines against what the runner drives, and the\n * connection of every engine (protocol, endpoint scheme, CDP being Chromium only).\n */\nexport function defineRemote(options: RemoteOptions, support: RemoteSupport): RemoteBrowser {\n  const { label } = support;\n  if (!TARGET_NAME_PATTERN.test(options.name)) {\n    throw new Error(\n      `${label}: name \"${options.name}\" must be lowercase letters, digits and hyphens, start with a letter or digit and be at most 32 characters`,\n    );\n  }\n  if (!Number.isInteger(options.sessions) || options.sessions < 1) {\n    throw new Error(`${label} \"${options.name}\": sessions must be a positive integer`);\n  }\n  checkEngines(options, support);\n  for (const engine of options.engines) {\n    checkConnection(label, options, engine, support);\n  }\n  return {\n    kind: \"remote\",\n    name: options.name,\n    engines: [...options.engines],\n    connect: options.connect,\n    sessions: options.sessions,\n    platform: options.platform,\n    connectRetries: options.connectRetries ?? 3,\n    connectBackoffMs: options.connectBackoffMs ?? 500,\n    connectTimeoutMs: options.connectTimeoutMs ?? 30_000,\n  };\n}\n\n/** The targets a service offers, in the order of its `engines`. */\nexport function remoteTargetsOf(remote: RemoteBrowser): RemoteTarget[] {\n  return remote.engines.map((engine) => ({\n    kind: \"remote\",\n    target: `${engine}@${remote.name}`,\n    engine,\n    remote,\n    reach: reachOf(remote.connect(engine)),\n  }));\n}\n\n/** `loopback` when the remote browser can route back to this host, else it needs a URL (decision 5). */\nexport function reachOf(connection: RemoteConnection): TargetReach {\n  return connection.protocol === \"playwright\" && connection.exposeNetwork !== undefined\n    ? \"loopback\"\n    : \"url\";\n}\n\n/** Whether a value is a remote service entry. */\nexport function isRemoteBrowser(value: unknown): value is RemoteBrowser {\n  return typeof value === \"object\" && value !== null && (value as RemoteBrowser).kind === \"remote\";\n}\n\n/**\n * Remove what identifies the connection from text surfaced to operators: the endpoint (it can carry\n * a key in its path or query), its host and path, its query values and every header value.\n */\nexport function scrubConnection(text: string, connection: RemoteConnection): string {\n  const secrets = [connection.endpoint, ...Object.values(connection.headers ?? {})];\n  try {\n    const url = new URL(connection.endpoint);\n    // Drivers echo the endpoint without its query; the host and a path that acts as a key stay hidden.\n    secrets.push(\n      url.password,\n      ...url.searchParams.values(),\n      decodeURIComponent(url.search),\n      `${url.protocol}//${url.host}${url.pathname}`,\n      url.host,\n      url.pathname,\n    );\n  } catch {\n    // An unparsable endpoint is scrubbed whole above.\n  }\n  let scrubbed = text;\n  // Longest first: the endpoint goes before the fragments it contains.\n  for (const secret of secrets\n    .filter((value) => value.length >= 4)\n    .toSorted((a, b) => b.length - a.length)) {\n    scrubbed = scrubbed.replaceAll(secret, \"[redacted]\");\n  }\n  return scrubbed;\n}\n\nfunction checkEngines(options: RemoteOptions, support: RemoteSupport): void {\n  const where = `${support.label} \"${options.name}\"`;\n  if (options.engines.length === 0) {\n    throw new Error(`${where}: engines must list at least one engine`);\n  }\n  for (const [index, engine] of options.engines.entries()) {\n    if (!isBrowserName(engine)) {\n      throw new Error(`${where}: unknown engine \"${String(engine)}\"`);\n    }\n    if (!support.engines.includes(engine)) {\n      throw new Error(\n        `${where}: this runner cannot drive \"${engine}\" (it drives ${support.engines.join(\", \")})`,\n      );\n    }\n    if (options.engines.indexOf(engine) !== index) {\n      throw new Error(`${where}: engine \"${engine}\" is listed twice`);\n    }\n  }\n}\n\nfunction checkConnection(\n  label: string,\n  options: RemoteOptions,\n  engine: BrowserName,\n  support: RemoteSupport,\n): void {\n  const where = `${label} \"${options.name}\" (${engine})`;\n  const connection = options.connect(engine);\n  if (!support.protocols.includes(connection.protocol)) {\n    throw new Error(\n      `${where}: protocol \"${connection.protocol}\" is not supported by this runner (it speaks ${support.protocols.join(\", \")})`,\n    );\n  }\n  if (connection.protocol === \"cdp\" && !CDP_ENGINES.has(engine)) {\n    throw new Error(`${where}: the CDP protocol drives Chromium only, not \"${engine}\"`);\n  }\n  if (connection.protocol === \"cdp\" && connection.exposeNetwork !== undefined) {\n    throw new Error(`${where}: exposeNetwork needs the \"playwright\" protocol`);\n  }\n  if (!SCHEMES[connection.protocol].some((scheme) => isScheme(connection.endpoint, scheme))) {\n    throw new Error(\n      `${where}: the endpoint must be a ${SCHEMES[connection.protocol].join(\" or \")} URL`,\n    );\n  }\n}\n\nfunction isScheme(endpoint: string, scheme: string): boolean {\n  try {\n    return new URL(endpoint).protocol === scheme;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"remote-browser.mjs","names":[],"sources":["../../src/adapters/remote-browser.ts"],"sourcesContent":["/**\n * Remote browsers (ADR 0007, decisions 1 and 3): one service a runner connects to instead of\n * launching a browser, expanding to one `<engine>@<name>` target per engine. Presets are plain\n * configuration over {@link defineRemote}; the runners add only what they can drive.\n */\nimport {\n  TARGET_NAME_PATTERN,\n  isBrowserName,\n  type BrowserName,\n  type CaptureTarget,\n  type TargetReach,\n} from \"./capture-target.ts\";\n\n/** Default bound on measuring a connected remote browser's environment (`timeouts.probeMs`). */\nexport const DEFAULT_PROBE_MS = 15_000;\n\n/** How a runner talks to the service: Playwright's own protocol, or the Chrome DevTools Protocol. */\nexport type RemoteProtocol = \"playwright\" | \"cdp\";\n\n/** Where and how to connect. A function `connect` is called per connection, so a token can be fresh. */\nexport interface RemoteConnection {\n  /** `ws(s)://…` (CDP also accepts `http(s)://…`). May carry credentials: it is never logged. */\n  endpoint: string;\n  /** Request headers for the handshake, such as `authorization`. Never logged. */\n  headers?: Record<string, string>;\n}\n\n/** A connection a function `connect` returns, with what `release` needs back. */\nexport interface RemoteLeasedConnection<TLease = unknown> extends RemoteConnection {\n  /** Opaque to the runner, handed to `release` once and never logged (it may carry credentials). */\n  lease?: TLease | undefined;\n}\n\n/** What a run is doing when it connects. */\nexport type RemotePurpose = \"render\" | \"extract\" | \"tests\";\n\n/** How a leased connection ended, handed to `release`. */\nexport type RemoteLeaseOutcome = \"finished\" | \"failed\" | \"cancelled\";\n\n/** What a function `connect` is told about the connection it is asked for. */\nexport interface RemoteConnectContext {\n  engine: BrowserName;\n  /** The StoryShelf build; the same for every shard of it. */\n  buildId: string;\n  /** The shard's own id; the build id when the render is not sharded. */\n  runId: string;\n  /** The shard's 1-based position in the build's plan; `undefined` (never 0) when not sharded. */\n  shardIndex?: number | undefined;\n  /** `render` for a build or shard, `extract` for the parameter pre-pass, `tests` for `.test()` entries. */\n  purpose: RemotePurpose;\n  /** This connection's attempt, from 1; each retry connects anew. */\n  attempt: number;\n  /**\n   * Aborts while `connect` is pending: on `timeouts.acquireMs`, a cancel (user, build, render\n   * budget) and shutdown. Spent once `connect` resolves.\n   */\n  signal: AbortSignal;\n}\n\n/** What `release` is told about how the connection's render went. */\nexport interface RemoteReleaseInfo {\n  outcome: RemoteLeaseOutcome;\n  /** Why it failed, for `failed`. Carries no credentials, but may carry provider text. */\n  error?: unknown;\n}\n\n/** What {@link defineRemote} takes: what `remote()` exposes to operators. */\nexport interface RemoteOptions<TLease = unknown> {\n  /** The target name half (`chromium@<name>`): lowercase letters, digits and hyphens, at most 32. */\n  name: string;\n  /** The engines to offer (a subset of what the service has). */\n  engines: readonly BrowserName[];\n  /** Parallel sessions the plan allows: the page cap of the target, per process (decision 4). A function is read live. */\n  sessions: number | (() => number);\n  /** Maximum concurrent pages on each browser connection; independent of the shared session gate. */\n  maxPagesPerConnection?: number | undefined;\n  /**\n   * Maximum connections this process holds to the service at once (default: no cap). A separate\n   * limit from `sessions` (pages) and `maxPagesPerConnection`: a connection counts from the moment\n   * it is requested until its render has ended, a shared one once. Renders over the cap wait, and a\n   * cancel or shutdown ends the wait. Per process; the deployment-wide cap is another issue.\n   */\n  maxConnections?: number | undefined;\n  /**\n   * Marks a vendor preset as experimental: written against the provider's documentation and not\n   * verified against live infrastructure. Reported in the run's sizing log and the docs; it changes\n   * no behavior.\n   */\n  experimental?: boolean | undefined;\n  /** Declared, never inferred: how the runner talks to the service. */\n  protocol: RemoteProtocol;\n  /**\n   * Declared, never inferred: `loopback` when the remote browser can route back to this host\n   * (Playwright's `exposeNetwork: \"<loopback>\"`), else `url` (it needs a signed Storybook URL).\n   */\n  reach: TargetReach;\n  /**\n   * The connection: an object for a fixed service (validated at creation), or a function called\n   * for every connection (sync or async) to wake or start something, pick a server per shard, or\n   * mint a token. A throw is retried and ends as a `TargetLaunchError`.\n   */\n  connect:\n    | RemoteConnection\n    | ((\n        context: RemoteConnectContext,\n      ) => RemoteLeasedConnection<TLease> | Promise<RemoteLeasedConnection<TLease>>);\n  /**\n   * Called once for every connection `connect` returned a `lease` for, after the render that used\n   * it finished, failed or was cancelled (and for leases still held at shutdown, `cancelled`).\n   * Only valid with a function `connect`. A throw or a timeout (`timeouts.releaseMs`) is logged and\n   * never fails the render.\n   */\n  release?: ((lease: TLease, info: RemoteReleaseInfo) => Promise<void> | void) | undefined;\n  /** OS the service renders on, reported when the page cannot tell (`linux-x64`, `windows`, …). */\n  platform?: string | undefined;\n  /** Connect retries: `attempts` after the first (default 3), `backoffMs` doubling (default 500). */\n  retry?: { attempts?: number | undefined; backoffMs?: number | undefined } | undefined;\n  /**\n   * `acquireMs` bounds the `connect` function, `connectMs` the handshake after it (a farm with a\n   * client cap queues extra connections, so a busy farm shows up as this timeout), `releaseMs`\n   * the `release` hook. All default to 30 000. `probeMs` bounds measuring the browser's\n   * environment once connected (default 15 000): a probe that overruns leaves the environment\n   * unknown with a warning, and a cancel stops it at once.\n   */\n  timeouts?:\n    | {\n        acquireMs?: number | undefined;\n        connectMs?: number | undefined;\n        releaseMs?: number | undefined;\n        probeMs?: number | undefined;\n      }\n    | undefined;\n}\n\n/** One remote service, validated: an entry of a runner's `browsers`. */\nexport interface RemoteBrowser {\n  readonly kind: \"remote\";\n  readonly name: string;\n  readonly engines: readonly BrowserName[];\n  readonly sessions: number | (() => number);\n  readonly maxPagesPerConnection?: number | undefined;\n  readonly maxConnections?: number | undefined;\n  /** A vendor preset not verified against live infrastructure (see {@link RemoteOptions.experimental}). */\n  readonly experimental?: boolean | undefined;\n  readonly protocol: RemoteProtocol;\n  readonly reach: TargetReach;\n  readonly connect: RemoteOptions[\"connect\"];\n  readonly release: ((lease: never, info: RemoteReleaseInfo) => Promise<void> | void) | undefined;\n  readonly platform: string | undefined;\n  readonly retry: { readonly attempts: number; readonly backoffMs: number };\n  readonly timeouts: {\n    readonly acquireMs: number;\n    readonly connectMs: number;\n    readonly releaseMs: number;\n    readonly probeMs: number;\n  };\n}\n\n/** What a runner supports, which {@link defineRemote} checks the service against. */\nexport interface RemoteSupport {\n  /** Engines the runner can drive. */\n  engines: readonly BrowserName[];\n  /** Protocols the runner can speak. */\n  protocols: readonly RemoteProtocol[];\n  /** Shown in errors, for example `remote()`. */\n  label: string;\n}\n\n/** One target a remote service offers. */\nexport interface RemoteTarget {\n  kind: \"remote\";\n  target: CaptureTarget;\n  engine: BrowserName;\n  remote: RemoteBrowser;\n  /** How the browser reaches the Storybook. */\n  reach: TargetReach;\n}\n\nconst CDP_ENGINES = new Set<BrowserName>([\"chromium\", \"chrome\"]);\nconst SCHEMES: Record<RemoteProtocol, readonly string[]> = {\n  playwright: [\"ws:\", \"wss:\"],\n  cdp: [\"ws:\", \"wss:\", \"http:\", \"https:\"],\n};\n\n/** Options 0.7 took that 0.8 renamed or removed, with what replaces them (a loud migration error). */\nconst MOVED: Record<string, string> = {\n  acquire: \"merge it into `connect` (a function that receives a context)\",\n  exposeNetwork: 'declare `reach: \"loopback\"` on the service instead',\n  connectRetries: \"use `retry: { attempts }`\",\n  connectBackoffMs: \"use `retry: { backoffMs }`\",\n  connectTimeoutMs: \"use `timeouts: { connectMs }`\",\n  acquireTimeoutMs: \"use `timeouts: { acquireMs }`\",\n};\n\nconst KNOWN = new Set([\n  \"name\",\n  \"engines\",\n  \"sessions\",\n  \"maxPagesPerConnection\",\n  \"maxConnections\",\n  \"experimental\",\n  \"protocol\",\n  \"reach\",\n  \"connect\",\n  \"release\",\n  \"platform\",\n  \"retry\",\n  \"timeouts\",\n]);\n\n/**\n * Validate a remote service eagerly, so a mistake fails when the runner is created and not when the\n * first build runs: unknown or moved options, the name, the sessions, the engines against what the\n * runner drives, the protocol, the reach, and a fixed connection (endpoint scheme).\n */\nexport function defineRemote<TLease = unknown>(\n  options: RemoteOptions<TLease>,\n  support: RemoteSupport,\n): RemoteBrowser {\n  const plain = options as unknown as RemoteOptions;\n  checkOptions(plain, support);\n  checkEngines(plain, support);\n  checkProtocol(plain, support);\n  return {\n    kind: \"remote\",\n    name: options.name,\n    engines: [...options.engines],\n    sessions: options.sessions,\n    maxPagesPerConnection: options.maxPagesPerConnection,\n    maxConnections: options.maxConnections,\n    experimental: options.experimental === true,\n    protocol: options.protocol,\n    reach: options.reach,\n    connect: options.connect,\n    release: options.release,\n    platform: options.platform,\n    retry: { attempts: options.retry?.attempts ?? 3, backoffMs: options.retry?.backoffMs ?? 500 },\n    timeouts: {\n      acquireMs: options.timeouts?.acquireMs ?? 30_000,\n      connectMs: options.timeouts?.connectMs ?? 30_000,\n      releaseMs: options.timeouts?.releaseMs ?? 30_000,\n      probeMs: options.timeouts?.probeMs ?? DEFAULT_PROBE_MS,\n    },\n  };\n}\n\n/** The targets a service offers, in the order of its `engines`. */\nexport function remoteTargetsOf(remote: RemoteBrowser): RemoteTarget[] {\n  return remote.engines.map((engine) => ({\n    kind: \"remote\",\n    target: `${engine}@${remote.name}`,\n    engine,\n    remote,\n    reach: remote.reach,\n  }));\n}\n\n/** Whether a value is a remote service entry. */\nexport function isRemoteBrowser(value: unknown): value is RemoteBrowser {\n  return typeof value === \"object\" && value !== null && (value as RemoteBrowser).kind === \"remote\";\n}\n\n/** Whether `endpoint` has a scheme `protocol` can open. */\nexport function hasSchemeFor(protocol: RemoteProtocol, endpoint: string): boolean {\n  try {\n    return SCHEMES[protocol].includes(new URL(endpoint).protocol);\n  } catch {\n    return false;\n  }\n}\n\n/** The schemes `protocol` accepts, for messages. */\nexport function schemesOf(protocol: RemoteProtocol): string {\n  return SCHEMES[protocol].join(\" or \");\n}\n\n/**\n * Remove what identifies the connection from text surfaced to operators: the endpoint (it can carry\n * a key in its path or query), its host and path, its query values, every header value and every\n * value inside the lease (non-strings are stringified).\n */\nexport function scrubConnection(\n  text: string,\n  connection: RemoteConnection & { lease?: unknown },\n): string {\n  const secrets = [\n    connection.endpoint,\n    ...Object.values(connection.headers ?? {}),\n    ...leaseSecrets(connection.lease),\n  ];\n  try {\n    const url = new URL(connection.endpoint);\n    // Drivers echo the endpoint without its query; the host and a path that acts as a key stay hidden.\n    secrets.push(\n      url.password,\n      ...url.searchParams.values(),\n      decodeURIComponent(url.search),\n      `${url.protocol}//${url.host}${url.pathname}`,\n      url.host,\n      url.pathname,\n    );\n  } catch {\n    // An unparsable endpoint is scrubbed whole above.\n  }\n  let scrubbed = text;\n  // Longest first: the endpoint goes before the fragments it contains.\n  for (const secret of secrets\n    .filter((value) => value.length >= 4)\n    .toSorted((a, b) => b.length - a.length)) {\n    scrubbed = scrubbed.replaceAll(secret, \"[redacted]\");\n  }\n  return scrubbed;\n}\n\n/** Every value of a lease, as text: a string whole, anything else stringified, objects walked. */\nfunction leaseSecrets(lease: unknown, depth = 0): string[] {\n  if (lease === undefined || lease === null) {\n    return [];\n  }\n  if (typeof lease === \"object\") {\n    return depth > 3 ? [] : Object.values(lease).flatMap((value) => leaseSecrets(value, depth + 1));\n  }\n  return typeof lease === \"string\" || typeof lease === \"number\" || typeof lease === \"boolean\"\n    ? [String(lease)]\n    : [];\n}\n\nfunction checkKnownKeys(options: RemoteOptions, where: string): void {\n  for (const key of Object.keys(options)) {\n    if (!KNOWN.has(key)) {\n      const moved = MOVED[key];\n      throw new Error(\n        moved === undefined\n          ? `${where}: unknown option \"${key}\"`\n          : `${where}: option \"${key}\" is gone in 0.8: ${moved}`,\n      );\n    }\n  }\n}\n\nfunction checkOptions(options: RemoteOptions, { label }: RemoteSupport): void {\n  const where = `${label} \"${options.name}\"`;\n  checkKnownKeys(options, where);\n  if (!TARGET_NAME_PATTERN.test(options.name)) {\n    throw new Error(\n      `${label}: name \"${options.name}\" must be lowercase letters, digits and hyphens, start with a letter or digit and be at most 32 characters`,\n    );\n  }\n  checkSessions(options.sessions, where);\n  checkPositiveInteger(\"maxPagesPerConnection\", options.maxPagesPerConnection, where);\n  checkPositiveInteger(\"maxConnections\", options.maxConnections, where);\n  checkNumbers(options, where);\n  if (options.release !== undefined && typeof options.connect !== \"function\") {\n    throw new Error(`${where}: release needs a function connect (a fixed connection has no lease)`);\n  }\n}\n\n/** An optional limit: absent, or a whole number of at least 1. */\nfunction checkPositiveInteger(name: string, value: number | undefined, where: string): void {\n  if (value !== undefined && (!Number.isInteger(value) || value < 1)) {\n    throw new Error(`${where}: ${name} must be a positive integer`);\n  }\n}\n\nfunction checkSessions(sessions: RemoteOptions[\"sessions\"], where: string): void {\n  const value = typeof sessions === \"function\" ? sessions() : sessions;\n  if (!Number.isInteger(value) || value < 1) {\n    throw new Error(`${where}: sessions must be a positive integer`);\n  }\n}\n\nfunction checkNumbers(options: RemoteOptions, where: string): void {\n  const entries: [string, number | undefined][] = [\n    [\"retry.attempts\", options.retry?.attempts],\n    [\"timeouts.acquireMs\", options.timeouts?.acquireMs],\n    [\"timeouts.connectMs\", options.timeouts?.connectMs],\n    [\"timeouts.releaseMs\", options.timeouts?.releaseMs],\n    [\"timeouts.probeMs\", options.timeouts?.probeMs],\n    [\"retry.backoffMs\", options.retry?.backoffMs],\n  ];\n  for (const [name, value] of entries) {\n    const allowed = name === \"retry.attempts\" || name === \"retry.backoffMs\" ? 0 : 1;\n    if (value !== undefined && (!Number.isInteger(value) || value < allowed)) {\n      throw new Error(`${where}: ${name} must be an integer of at least ${allowed}`);\n    }\n  }\n}\n\nfunction checkEngines(options: RemoteOptions, support: RemoteSupport): void {\n  const where = `${support.label} \"${options.name}\"`;\n  if (options.engines.length === 0) {\n    throw new Error(`${where}: engines must list at least one engine`);\n  }\n  for (const [index, engine] of options.engines.entries()) {\n    if (!isBrowserName(engine)) {\n      throw new Error(`${where}: unknown engine \"${String(engine)}\"`);\n    }\n    if (!support.engines.includes(engine)) {\n      throw new Error(\n        `${where}: this runner cannot drive \"${engine}\" (it drives ${support.engines.join(\", \")})`,\n      );\n    }\n    if (options.engines.indexOf(engine) !== index) {\n      throw new Error(`${where}: engine \"${engine}\" is listed twice`);\n    }\n  }\n}\n\nfunction checkProtocol(options: RemoteOptions, support: RemoteSupport): void {\n  const where = `${support.label} \"${options.name}\"`;\n  checkDeclared(options, support, where);\n  if (options.protocol === \"cdp\") {\n    checkCdp(options, where);\n  }\n  if (typeof options.connect !== \"function\") {\n    checkFixedConnection(options.connect, options.protocol, where);\n  }\n}\n\nfunction checkDeclared(options: RemoteOptions, support: RemoteSupport, where: string): void {\n  if (options.protocol === undefined || options.reach === undefined) {\n    throw new Error(\n      `${where}: \"protocol\" and \"reach\" are required in 0.8 (declare how the runner talks to the service and whether its browser can reach this host)`,\n    );\n  }\n  if (!support.protocols.includes(options.protocol)) {\n    throw new Error(\n      `${where}: protocol \"${options.protocol}\" is not supported by this runner (it speaks ${support.protocols.join(\", \")})`,\n    );\n  }\n  if (options.reach !== \"loopback\" && options.reach !== \"url\") {\n    throw new Error(`${where}: reach must be \"loopback\" or \"url\"`);\n  }\n}\n\nfunction checkCdp(options: RemoteOptions, where: string): void {\n  const bad = options.engines.find((engine) => !CDP_ENGINES.has(engine));\n  if (bad !== undefined) {\n    throw new Error(`${where}: the CDP protocol drives Chromium only, not \"${bad}\"`);\n  }\n  if (options.reach === \"loopback\") {\n    throw new Error(`${where}: reach \"loopback\" needs the \"playwright\" protocol`);\n  }\n}\n\nfunction checkFixedConnection(\n  connection: RemoteConnection,\n  protocol: RemoteProtocol,\n  where: string,\n): void {\n  const extra = Object.keys(connection).filter((key) => key !== \"endpoint\" && key !== \"headers\");\n  if (extra.length > 0) {\n    throw new Error(`${where}: connect has unknown field(s) ${extra.join(\", \")}`);\n  }\n  if (!hasSchemeFor(protocol, connection.endpoint)) {\n    throw new Error(`${where}: the endpoint must be a ${schemesOf(protocol)} URL`);\n  }\n}\n"],"mappings":"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"}