@storyshelf/core 0.6.2 → 0.7.0

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

@@ -0,0 +1,24 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+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}. */
+declare function channelPrefix(channel: NotificationChannel): string;
+/**
+ * Make the channel's host show `states` for the commit `sha`: every status, then the comment.
+ * Each write is idempotent (latest call wins). A failed status write throws so the caller can
+ * retry; a failed comment write is logged and never fails the statuses.
+ */
+declare function writeBuildState(provider: StateNotifierProvider, channel: NotificationChannel, write: {
+  sha: string;
+  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

@@ -0,0 +1,66 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region 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}. */
+function channelPrefix(channel) {
+	const prefix = channel.config["prefix"];
+	return typeof prefix === "string" && prefix.length > 0 ? prefix : DEFAULT_STATUS_PREFIX;
+}
+/**
+* Make the channel's host show `states` for the commit `sha`: every status, then the comment.
+* Each write is idempotent (latest call wins). A failed status write throws so the caller can
+* retry; a failed comment write is logged and never fails the statuses.
+*/
+async function writeBuildState(provider, channel, write) {
+	const { sha, states, logger } = write;
+	const adapter = provider.create({
+		config: channel.config,
+		secret: channel.secret,
+		logger
+	});
+	const failed = (await Promise.allSettled(states.statuses.map(async (status) => {
+		await adapter.setState({
+			channel,
+			target: {
+				kind: "status",
+				sha,
+				context: status.context,
+				description: status.description,
+				...status.informational === true ? { informational: true } : {},
+				...status.progress === void 0 ? {} : { progress: status.progress },
+				...status.annotations === void 0 ? {} : { annotations: status.annotations },
+				...status.omitted === void 0 ? {} : { omitted: status.omitted }
+			},
+			state: status.state,
+			url: status.url,
+			logger
+		});
+	}))).find((result) => result.status === "rejected");
+	if (failed?.status === "rejected") throw failed.reason;
+	if (states.comment !== null) {
+		const { comment } = states;
+		await adapter.setState({
+			channel,
+			target: {
+				kind: "comment",
+				sha,
+				markdown: comment.markdown
+			},
+			state: comment.state,
+			url: comment.url,
+			logger
+		}).catch((error) => {
+			logger?.warn({
+				err: error,
+				channelId: channel.id
+			}, "failed to upsert comment");
+		});
+	}
+}
+//#endregion
+export { DEFAULT_STATUS_PREFIX, channelPrefix, writeBuildState };
+
+//# sourceMappingURL=state.mjs.map

package/dist/adapters/notifier/state.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.mjs","names":[],"sources":["../../../src/adapters/notifier/state.ts"],"sourcesContent":["/** Writing a build's desired states to one `state` channel (git hosts); see `build-state.ts` for what they are. */\nimport type { Logger } from \"../../logger.ts\";\nimport type { BuildStateSet } from \"./build-state.ts\";\nimport type { StateNotifierProvider } from \"./provider.ts\";\nimport type { NotificationChannel } from \"./types.ts\";\n\n/** Default status-name prefix of a git channel (`<prefix>/testing`). */\nexport const DEFAULT_STATUS_PREFIX = \"storyshelf\";\n\n/** The channel's status-name prefix: its `prefix` config, else {@link DEFAULT_STATUS_PREFIX}. */\nexport function channelPrefix(channel: NotificationChannel): string {\n  const prefix = channel.config[\"prefix\"];\n  return typeof prefix === \"string\" && prefix.length > 0 ? prefix : DEFAULT_STATUS_PREFIX;\n}\n\n/**\n * Make the channel's host show `states` for the commit `sha`: every status, then the comment.\n * Each write is idempotent (latest call wins). A failed status write throws so the caller can\n * retry; a failed comment write is logged and never fails the statuses.\n */\nexport async function writeBuildState(\n  provider: StateNotifierProvider,\n  channel: NotificationChannel,\n  write: { sha: string; states: BuildStateSet; logger?: Logger | undefined },\n): Promise<void> {\n  const { sha, states, logger } = write;\n  const adapter = provider.create({ config: channel.config, secret: channel.secret, logger });\n  const results = await Promise.allSettled(\n    states.statuses.map(async (status) => {\n      await adapter.setState({\n        channel,\n        target: {\n          kind: \"status\",\n          sha,\n          context: status.context,\n          description: status.description,\n          ...(status.informational === true ? { informational: true } : {}),\n          ...(status.progress === undefined ? {} : { progress: status.progress }),\n          ...(status.annotations === undefined ? {} : { annotations: status.annotations }),\n          ...(status.omitted === undefined ? {} : { omitted: status.omitted }),\n        },\n        state: status.state,\n        url: status.url,\n        logger,\n      });\n    }),\n  );\n  const failed = results.find((result) => result.status === \"rejected\");\n  if (failed?.status === \"rejected\") {\n    throw failed.reason;\n  }\n  if (states.comment !== null) {\n    const { comment } = states;\n    await adapter\n      .setState({\n        channel,\n        target: { kind: \"comment\", sha, markdown: comment.markdown },\n        state: comment.state,\n        url: comment.url,\n        logger,\n      })\n      .catch((error: unknown) => {\n        logger?.warn({ err: error, channelId: channel.id }, \"failed to upsert comment\");\n      });\n  }\n}\n"],"mappings":";;;;;AAOA,MAAa,wBAAwB;;AAGrC,SAAgB,cAAc,SAAsC;CAClE,MAAM,SAAS,QAAQ,OAAO;CAC9B,OAAO,OAAO,WAAW,YAAY,OAAO,SAAS,IAAI,SAAS;AACpE;;;;;;AAOA,eAAsB,gBACpB,UACA,SACA,OACe;CACf,MAAM,EAAE,KAAK,QAAQ,WAAW;CAChC,MAAM,UAAU,SAAS,OAAO;EAAE,QAAQ,QAAQ;EAAQ,QAAQ,QAAQ;EAAQ;CAAO,CAAC;CAqB1F,MAAM,UAAS,MApBO,QAAQ,WAC5B,OAAO,SAAS,IAAI,OAAO,WAAW;EACpC,MAAM,QAAQ,SAAS;GACrB;GACA,QAAQ;IACN,MAAM;IACN;IACA,SAAS,OAAO;IAChB,aAAa,OAAO;IACpB,GAAI,OAAO,kBAAkB,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAC/D,GAAI,OAAO,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,OAAO,SAAS;IACrE,GAAI,OAAO,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,OAAO,YAAY;IAC9E,GAAI,OAAO,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,OAAO,QAAQ;GACpE;GACA,OAAO,OAAO;GACd,KAAK,OAAO;GACZ;EACF,CAAC;CACH,CAAC,CACH,EAAA,CACuB,MAAM,WAAW,OAAO,WAAW,UAAU;CACpE,IAAI,QAAQ,WAAW,YACrB,MAAM,OAAO;CAEf,IAAI,OAAO,YAAY,MAAM;EAC3B,MAAM,EAAE,YAAY;EACpB,MAAM,QACH,SAAS;GACR;GACA,QAAQ;IAAE,MAAM;IAAW;IAAK,UAAU,QAAQ;GAAS;GAC3D,OAAO,QAAQ;GACf,KAAK,QAAQ;GACb;EACF,CAAC,CAAC,CACD,OAAO,UAAmB;GACzB,QAAQ,KAAK;IAAE,KAAK;IAAO,WAAW,QAAQ;GAAG,GAAG,0BAA0B;EAChF,CAAC;CACL;AACF"}

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

@@ -42,6 +42,55 @@ interface NotificationChannel {
   secret?: string;
   events: string[];
   enabled: boolean;
+  /** Last delivery error, cleared by the next successful delivery. */
+  lastError?: string;
+}
+/**
+ * What a `state` provider shows for a build: pending, passed, failed, or cancelled by a user
+ * (a host without a cancelled state shows it like the nearest failure-class state).
+ */
+type NotifierState = "pending" | "success" | "failure" | "cancelled";
+/**
+ * One per-story finding a host that supports it (GitHub check runs) shows beside a status: a
+ * changed snapshot that deep-links to its review page.
+ */
+interface StateAnnotation {
+  /** The story file the snapshot belongs to (the host anchors the finding there). */
+  path: string;
+  /** Short heading, e.g. `Button / Primary (chromium)`. */
+  title: string;
+  message: string;
+  /** Absolute link to the snapshot's review page. */
+  url: string;
+  level: "notice" | "warning";
+}
+/** Where a `state` provider writes: a commit status or a pull-request comment. */
+type NotifierStateTarget = {
+  kind: "status";
+  sha: string;
+  /** Full status name on the host, e.g. `storyshelf/testing` (the caller owns the prefix). */
+  context: string;
+  /** Short text beside the status; the provider supplies a default. */
+  description?: string;
+  /** For a `pending` state: not started (`queued`) or under way (`running`; the default). */
+  progress?: "queued" | "running";
+  /** Never a merge gate (the Storybook status): a failure is shown as neutral where the host has it. */
+  informational?: boolean;
+  /** Per-snapshot findings of the build; only a host with annotations shows them. */
+  annotations?: StateAnnotation[];
+  /** Changed snapshots beyond `annotations` (cut at the cap); the host says "and N more". */
+  omitted?: number;
+} | {
+  kind: "comment";
+  sha: string;
+  /** Comment body below the idempotency marker. */
+  markdown: string;
+};
+/** Result of one delivery attempt to a channel, reported to the host for health display. */
+interface ChannelOutcome {
+  channelId: string;
+  /** Sanitized error text, absent on success. */
+  error?: string;
 }
 /** App-level (site-wide) admin alert — no project scope. */
 interface SystemNotification {
@@ -50,7 +99,7 @@ interface SystemNotification {
   timestamp: string;
 }
 /** 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";
+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 { ChannelToggles, FormattedNotification, NotificationBrand, NotificationChannel, NotificationEvent, SystemEventName, SystemNotification };
+export { ChannelOutcome, ChannelToggles, FormattedNotification, NotificationBrand, NotificationChannel, NotificationEvent, NotifierState, NotifierStateTarget, StateAnnotation, SystemEventName, SystemNotification };
 //# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1,87 @@
+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. */
+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>;
+  /**
+   * 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).
+   */
+  exposeNetwork?: string;
+}
+/** What {@link defineRemote} takes: what `remote()` exposes to operators. */
+interface RemoteOptions {
+  /** 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;
+  /** 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;
+  /**
+   * 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.
+   */
+  connectTimeoutMs?: number | undefined;
+}
+/** One remote service, validated: an entry of a runner's `browsers`. */
+interface RemoteBrowser extends Required<Pick<RemoteOptions, "name" | "engines" | "connect" | "sessions">> {
+  readonly kind: "remote";
+  readonly platform: string | undefined;
+  readonly connectRetries: number;
+  readonly connectBackoffMs: number;
+  readonly connectTimeoutMs: number;
+}
+/** What a runner supports, which {@link defineRemote} checks the service against. */
+interface RemoteSupport {
+  /** Engines the runner can drive. */
+  engines: readonly BrowserName[];
+  /** Protocols the runner can speak. */
+  protocols: readonly RemoteProtocol[];
+  /** Shown in errors, for example `remote()`. */
+  label: string;
+}
+/** One target a remote service offers. */
+interface RemoteTarget {
+  kind: "remote";
+  target: CaptureTarget;
+  engine: BrowserName;
+  remote: RemoteBrowser;
+  /** How the browser reaches the Storybook. */
+  reach: TargetReach;
+}
+/**
+ * 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).
+ */
+declare function defineRemote(options: RemoteOptions, 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;
+/**
+ * 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.
+ */
+declare function scrubConnection(text: string, connection: RemoteConnection): string;
+//#endregion
+export { RemoteBrowser, RemoteConnection, RemoteOptions, RemoteProtocol, RemoteSupport, RemoteTarget, defineRemote, isRemoteBrowser, reachOf, remoteTargetsOf, scrubConnection };
+//# sourceMappingURL=remote-browser.d.mts.map

package/dist/adapters/remote-browser.mjs

@@ -0,0 +1,103 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { TARGET_NAME_PATTERN, isBrowserName } from "./capture-target.mjs";
+//#region 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.
+*/
+const CDP_ENGINES = /* @__PURE__ */ new Set(["chromium", "chrome"]);
+const SCHEMES = {
+	playwright: ["ws:", "wss:"],
+	cdp: [
+		"ws:",
+		"wss:",
+		"http:",
+		"https:"
+	]
+};
+/**
+* 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).
+*/
+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);
+	return {
+		kind: "remote",
+		name: options.name,
+		engines: [...options.engines],
+		connect: options.connect,
+		sessions: options.sessions,
+		platform: options.platform,
+		connectRetries: options.connectRetries ?? 3,
+		connectBackoffMs: options.connectBackoffMs ?? 500,
+		connectTimeoutMs: options.connectTimeoutMs ?? 3e4
+	};
+}
+/** The targets a service offers, in the order of its `engines`. */
+function remoteTargetsOf(remote) {
+	return remote.engines.map((engine) => ({
+		kind: "remote",
+		target: `${engine}@${remote.name}`,
+		engine,
+		remote,
+		reach: reachOf(remote.connect(engine))
+	}));
+}
+/** `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";
+}
+/**
+* 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.
+*/
+function scrubConnection(text, connection) {
+	const secrets = [connection.endpoint, ...Object.values(connection.headers ?? {})];
+	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);
+	} catch {}
+	let scrubbed = text;
+	for (const secret of secrets.filter((value) => value.length >= 4).toSorted((a, b) => b.length - a.length)) scrubbed = scrubbed.replaceAll(secret, "[redacted]");
+	return scrubbed;
+}
+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`);
+	for (const [index, engine] of options.engines.entries()) {
+		if (!isBrowserName(engine)) throw new Error(`${where}: unknown engine "${String(engine)}"`);
+		if (!support.engines.includes(engine)) throw new Error(`${where}: this runner cannot drive "${engine}" (it drives ${support.engines.join(", ")})`);
+		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 isScheme(endpoint, scheme) {
+	try {
+		return new URL(endpoint).protocol === scheme;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { defineRemote, isRemoteBrowser, reachOf, remoteTargetsOf, scrubConnection };
+
+//# sourceMappingURL=remote-browser.mjs.map

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

@@ -0,0 +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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"}

package/dist/adapters/render-runs.d.mts

@@ -0,0 +1,25 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/adapters/render-runs.d.ts
+/** In-flight render calls of a capture runner, so `cancel` reaches exactly the runs it names. */
+/**
+ * Every render call a runner has in flight, by build and run id.
+ *
+ * Several renders of one build can run at once in one process (the shards of a sharded build), and
+ * even two with the same run id (a redelivered shard). Each call registers its own entry and
+ * removes only that entry when it ends, so no render ever drops another's handle.
+ */
+declare class RenderRuns<T> {
+  #private;
+  /**
+   * Register a render call. Returns the function that removes it again (call it in `finally`).
+   *
+   * @param runId - The request's run id; a render without one is keyed by its build id.
+   */
+  add(buildId: string, runId: string | undefined, run: T): () => void;
+  /** The runs `cancel(buildId, runId)` should stop: every run of the build without a run id. */
+  matching(buildId: string, runId?: string): T[];
+}
+//#endregion
+export { RenderRuns };
+//# sourceMappingURL=render-runs.d.mts.map

package/dist/adapters/render-runs.mjs

@@ -0,0 +1,41 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/adapters/render-runs.ts
+/** In-flight render calls of a capture runner, so `cancel` reaches exactly the runs it names. */
+/**
+* Every render call a runner has in flight, by build and run id.
+*
+* Several renders of one build can run at once in one process (the shards of a sharded build), and
+* even two with the same run id (a redelivered shard). Each call registers its own entry and
+* removes only that entry when it ends, so no render ever drops another's handle.
+*/
+var RenderRuns = class {
+	#byBuild = /* @__PURE__ */ new Map();
+	/**
+	* Register a render call. Returns the function that removes it again (call it in `finally`).
+	*
+	* @param runId - The request's run id; a render without one is keyed by its build id.
+	*/
+	add(buildId, runId, run) {
+		const entry = {
+			runId: runId ?? buildId,
+			run
+		};
+		const runs = this.#byBuild.get(buildId) ?? /* @__PURE__ */ new Set();
+		runs.add(entry);
+		this.#byBuild.set(buildId, runs);
+		return () => {
+			runs.delete(entry);
+			if (runs.size === 0 && this.#byBuild.get(buildId) === runs) this.#byBuild.delete(buildId);
+		};
+	}
+	/** The runs `cancel(buildId, runId)` should stop: every run of the build without a run id. */
+	matching(buildId, runId) {
+		return [...this.#byBuild.get(buildId) ?? []].filter((entry) => runId === void 0 || entry.runId === runId).map((e) => e.run);
+	}
+};
+//#endregion
+export { RenderRuns };
+
+//# sourceMappingURL=render-runs.mjs.map

package/dist/adapters/render-runs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-runs.mjs","names":[],"sources":["../../src/adapters/render-runs.ts"],"sourcesContent":["/** In-flight render calls of a capture runner, so `cancel` reaches exactly the runs it names. */\n\n/**\n * Every render call a runner has in flight, by build and run id.\n *\n * Several renders of one build can run at once in one process (the shards of a sharded build), and\n * even two with the same run id (a redelivered shard). Each call registers its own entry and\n * removes only that entry when it ends, so no render ever drops another's handle.\n */\nexport class RenderRuns<T> {\n  readonly #byBuild = new Map<string, Set<{ runId: string; run: T }>>();\n\n  /**\n   * Register a render call. Returns the function that removes it again (call it in `finally`).\n   *\n   * @param runId - The request's run id; a render without one is keyed by its build id.\n   */\n  add(buildId: string, runId: string | undefined, run: T): () => void {\n    const entry = { runId: runId ?? buildId, run };\n    const runs = this.#byBuild.get(buildId) ?? new Set();\n    runs.add(entry);\n    this.#byBuild.set(buildId, runs);\n    return () => {\n      runs.delete(entry);\n      if (runs.size === 0 && this.#byBuild.get(buildId) === runs) {\n        this.#byBuild.delete(buildId);\n      }\n    };\n  }\n\n  /** The runs `cancel(buildId, runId)` should stop: every run of the build without a run id. */\n  matching(buildId: string, runId?: string): T[] {\n    const runs = [...(this.#byBuild.get(buildId) ?? [])];\n    return runs.filter((entry) => runId === undefined || entry.runId === runId).map((e) => e.run);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AASA,IAAa,aAAb,MAA2B;CACzB,2BAAoB,IAAI,IAA4C;;;;;;CAOpE,IAAI,SAAiB,OAA2B,KAAoB;EAClE,MAAM,QAAQ;GAAE,OAAO,SAAS;GAAS;EAAI;EAC7C,MAAM,OAAO,KAAK,SAAS,IAAI,OAAO,qBAAK,IAAI,IAAI;EACnD,KAAK,IAAI,KAAK;EACd,KAAK,SAAS,IAAI,SAAS,IAAI;EAC/B,aAAa;GACX,KAAK,OAAO,KAAK;GACjB,IAAI,KAAK,SAAS,KAAK,KAAK,SAAS,IAAI,OAAO,MAAM,MACpD,KAAK,SAAS,OAAO,OAAO;EAEhC;CACF;;CAGA,SAAS,SAAiB,OAAqB;EAE7C,OAAO,CADO,GAAI,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,CACvC,CAAC,CAAC,QAAQ,UAAU,UAAU,KAAA,KAAa,MAAM,UAAU,KAAK,CAAC,CAAC,KAAK,MAAM,EAAE,GAAG;CAC9F;AACF"}

package/dist/adapters/setup-runner.mjs

@@ -26,8 +26,7 @@ function pushAll(entries, sources, hook) {
 	pushHook(entries, sources.database, hook);
 	pushHook(entries, sources.storage, hook);
 	pushHook(entries, sources.captureRunner, hook);
-	pushHook(entries, sources.captureQueue, hook);
-	for (const provider of sources.gitHosts ?? []) pushHook(entries, provider, hook);
+	for (const provider of sources.design ?? []) pushHook(entries, provider, hook);
 	for (const notifier of sources.notifiers ?? []) pushHook(entries, notifier, hook);
 	pushHook(entries, sources.emailSender, hook);
 }
@@ -53,8 +52,7 @@ function bindAdapterLoggers(sources, logger) {
 		sources.database,
 		sources.storage,
 		sources.captureRunner,
-		sources.captureQueue,
-		...sources.gitHosts ?? [],
+		...sources.design ?? [],
 		...sources.notifiers ?? [],
 		sources.emailSender
 	];

package/dist/adapters/setup-runner.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"setup-runner.mjs","names":[],"sources":["../../src/adapters/setup-runner.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport { sanitizeErrorText } from \"../utils/redact.ts\";\nimport type { AdapterLifecycle, AdapterMetadata, AdapterSetupContext } from \"./metadata.ts\";\nimport type {\n  AdapterSetupFailure,\n  AdapterSetupResult,\n  AdapterSetupSources,\n  HookEntry,\n} from \"./setup.ts\";\n\ninterface LifecycleCarrier {\n  readonly metadata: AdapterMetadata;\n  readonly lifecycle?: AdapterLifecycle;\n}\n\nfunction hookEntry(adapter: LifecycleCarrier, hook: \"setup\" | \"teardown\"): HookEntry | null {\n  const lifecycle = adapter.lifecycle;\n  if (!lifecycle) {\n    return null;\n  }\n  const fn = lifecycle[hook];\n  const { category, kind, name } = adapter.metadata;\n  return {\n    category,\n    kind,\n    name,\n    run: async (ctx) => {\n      await fn(ctx);\n    },\n  };\n}\n\nfunction pushHook(\n  entries: HookEntry[],\n  adapter: LifecycleCarrier | undefined,\n  hook: \"setup\" | \"teardown\",\n): void {\n  if (!adapter) {\n    return;\n  }\n  const entry = hookEntry(adapter, hook);\n  if (entry) {\n    entries.push(entry);\n  }\n}\n\nfunction pushAll(\n  entries: HookEntry[],\n  sources: AdapterSetupSources,\n  hook: \"setup\" | \"teardown\",\n): void {\n  pushHook(entries, sources.database, hook);\n  pushHook(entries, sources.storage, hook);\n  pushHook(entries, sources.captureRunner, hook);\n  pushHook(entries, sources.captureQueue, hook);\n  for (const provider of sources.gitHosts ?? []) {\n    pushHook(entries, provider, hook);\n  }\n  for (const notifier of sources.notifiers ?? []) {\n    pushHook(entries, notifier, hook);\n  }\n  pushHook(entries, sources.emailSender, hook);\n}\n\n/** Collect every available `setup` hook in deterministic order. */\nexport function collectSetups(sources: AdapterSetupSources): HookEntry[] {\n  const entries: HookEntry[] = [];\n  pushAll(entries, sources, \"setup\");\n  return entries;\n}\n\n/** Collect every available `teardown` hook in deterministic order. */\nexport function collectTeardowns(sources: AdapterSetupSources): HookEntry[] {\n  const entries: HookEntry[] = [];\n  pushAll(entries, sources, \"teardown\");\n  return entries;\n}\n\ninterface LoggerCarrier {\n  readonly metadata: AdapterMetadata;\n  readonly setLogger?: (logger: Logger) => void;\n}\n\n/**\n * Bind the host logger on every adapter that accepts one, scoped by kind.\n * Adapters without `setLogger` keep today's behavior (silent when no\n * explicit `options.logger` was passed at construction).\n */\nexport function bindAdapterLoggers(sources: AdapterSetupSources, logger: Logger): void {\n  const adapters: ReadonlyArray<LoggerCarrier | undefined> = [\n    sources.database,\n    sources.storage,\n    sources.captureRunner,\n    sources.captureQueue,\n    ...(sources.gitHosts ?? []),\n    ...(sources.notifiers ?? []),\n    sources.emailSender,\n  ];\n  for (const adapter of adapters) {\n    adapter?.setLogger?.(logger.child({ component: adapter.metadata.kind }));\n  }\n}\n\nfunction messageOf(reason: unknown): string {\n  const text = reason instanceof Error ? reason.message : String(reason);\n  return sanitizeErrorText(text, 500);\n}\n\n/** Budgets that trigger slow-hook warnings (observe only, never abort). */\nconst SLOW_SETUP_MS = 10_000;\nconst SLOW_TEARDOWN_MS = 5_000;\n\n/** Run one hook with start/done logging and a slow-hook warning. */\nasync function runHook(\n  entry: HookEntry,\n  ctx: AdapterSetupContext,\n  logger: Logger,\n  slowMs: number,\n): Promise<void> {\n  const { category, kind, name } = entry;\n  const started = Date.now();\n  logger.info({ category, kind, name }, \"adapter hook start\");\n  try {\n    await entry.run(ctx);\n  } finally {\n    const durationMs = Date.now() - started;\n    logger.info({ category, kind, name, durationMs }, \"adapter hook done\");\n    if (durationMs > slowMs) {\n      logger.warn({ category, kind, name, durationMs, slowMs }, \"slow adapter hook\");\n    }\n  }\n}\n\nfunction toFailure(entry: HookEntry, reason: unknown): AdapterSetupFailure {\n  return { category: entry.category, kind: entry.kind, name: entry.name, error: messageOf(reason) };\n}\n\nfunction toResult(\n  entries: HookEntry[],\n  outcomes: PromiseSettledResult<void>[],\n  logger: Logger,\n  verb: string,\n): AdapterSetupResult {\n  const failures: AdapterSetupFailure[] = [];\n  for (const [index, entry] of entries.entries()) {\n    const outcome: PromiseSettledResult<void> | undefined = outcomes[index];\n    if (outcome?.status === \"rejected\") {\n      failures.push(toFailure(entry, outcome.reason));\n    }\n  }\n  if (failures.length > 0) {\n    logger.error({ failures }, `adapter ${verb} failed`);\n  } else {\n    logger.info({ count: entries.length }, `adapters ${verb}d`);\n  }\n  return { ok: failures.length === 0, failures };\n}\n\n/** One run of collected hooks with start/done logging and hung visibility. */\nasync function runHooks(\n  entries: HookEntry[],\n  ctx: AdapterSetupContext,\n  logger: Logger,\n  verb: string,\n  slowMs: number,\n): Promise<AdapterSetupResult> {\n  let settled = false;\n  const timer = setTimeout(() => {\n    if (!settled) {\n      logger.warn({ count: entries.length, slowMs }, `adapters ${verb} still running`);\n    }\n  }, slowMs);\n  timer.unref?.();\n  try {\n    const outcomes = await Promise.allSettled(\n      entries.map(async (entry) => {\n        await runHook(entry, ctx, logger, slowMs);\n      }),\n    );\n    return toResult(entries, outcomes, logger, verb);\n  } finally {\n    settled = true;\n    clearTimeout(timer);\n  }\n}\n\n/** Run setup hooks concurrently; failures are collected, never thrown. */\nexport async function runAdapterSetups(\n  entries: HookEntry[],\n  ctx: AdapterSetupContext,\n  logger: Logger,\n): Promise<AdapterSetupResult> {\n  return await runHooks(entries, ctx, logger, \"setup\", SLOW_SETUP_MS);\n}\n\n/** Run teardown hooks concurrently; failures are collected, never thrown. */\nexport async function runAdapterTeardowns(\n  entries: HookEntry[],\n  ctx: AdapterSetupContext,\n  logger: Logger,\n): Promise<AdapterSetupResult> {\n  return await runHooks(entries, ctx, logger, \"teardown\", SLOW_TEARDOWN_MS);\n}\n"],"mappings":"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"}
+{"version":3,"file":"setup-runner.mjs","names":[],"sources":["../../src/adapters/setup-runner.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport { sanitizeErrorText } from \"../utils/redact.ts\";\nimport type { AdapterLifecycle, AdapterMetadata, AdapterSetupContext } from \"./metadata.ts\";\nimport type {\n  AdapterSetupFailure,\n  AdapterSetupResult,\n  AdapterSetupSources,\n  HookEntry,\n} from \"./setup.ts\";\n\ninterface LifecycleCarrier {\n  readonly metadata: AdapterMetadata;\n  readonly lifecycle?: AdapterLifecycle;\n}\n\nfunction hookEntry(adapter: LifecycleCarrier, hook: \"setup\" | \"teardown\"): HookEntry | null {\n  const lifecycle = adapter.lifecycle;\n  if (!lifecycle) {\n    return null;\n  }\n  const fn = lifecycle[hook];\n  const { category, kind, name } = adapter.metadata;\n  return {\n    category,\n    kind,\n    name,\n    run: async (ctx) => {\n      await fn(ctx);\n    },\n  };\n}\n\nfunction pushHook(\n  entries: HookEntry[],\n  adapter: LifecycleCarrier | undefined,\n  hook: \"setup\" | \"teardown\",\n): void {\n  if (!adapter) {\n    return;\n  }\n  const entry = hookEntry(adapter, hook);\n  if (entry) {\n    entries.push(entry);\n  }\n}\n\nfunction pushAll(\n  entries: HookEntry[],\n  sources: AdapterSetupSources,\n  hook: \"setup\" | \"teardown\",\n): void {\n  pushHook(entries, sources.database, hook);\n  pushHook(entries, sources.storage, hook);\n  pushHook(entries, sources.captureRunner, hook);\n  for (const provider of sources.design ?? []) {\n    pushHook(entries, provider, hook);\n  }\n  for (const notifier of sources.notifiers ?? []) {\n    pushHook(entries, notifier, hook);\n  }\n  pushHook(entries, sources.emailSender, hook);\n}\n\n/** Collect every available `setup` hook in deterministic order. */\nexport function collectSetups(sources: AdapterSetupSources): HookEntry[] {\n  const entries: HookEntry[] = [];\n  pushAll(entries, sources, \"setup\");\n  return entries;\n}\n\n/** Collect every available `teardown` hook in deterministic order. */\nexport function collectTeardowns(sources: AdapterSetupSources): HookEntry[] {\n  const entries: HookEntry[] = [];\n  pushAll(entries, sources, \"teardown\");\n  return entries;\n}\n\ninterface LoggerCarrier {\n  readonly metadata: AdapterMetadata;\n  readonly setLogger?: (logger: Logger) => void;\n}\n\n/**\n * Bind the host logger on every adapter that accepts one, scoped by kind.\n * Adapters without `setLogger` keep today's behavior (silent when no\n * explicit `options.logger` was passed at construction).\n */\nexport function bindAdapterLoggers(sources: AdapterSetupSources, logger: Logger): void {\n  const adapters: ReadonlyArray<LoggerCarrier | undefined> = [\n    sources.database,\n    sources.storage,\n    sources.captureRunner,\n    ...(sources.design ?? []),\n    ...(sources.notifiers ?? []),\n    sources.emailSender,\n  ];\n  for (const adapter of adapters) {\n    adapter?.setLogger?.(logger.child({ component: adapter.metadata.kind }));\n  }\n}\n\nfunction messageOf(reason: unknown): string {\n  const text = reason instanceof Error ? reason.message : String(reason);\n  return sanitizeErrorText(text, 500);\n}\n\n/** Budgets that trigger slow-hook warnings (observe only, never abort). */\nconst SLOW_SETUP_MS = 10_000;\nconst SLOW_TEARDOWN_MS = 5_000;\n\n/** Run one hook with start/done logging and a slow-hook warning. */\nasync function runHook(\n  entry: HookEntry,\n  ctx: AdapterSetupContext,\n  logger: Logger,\n  slowMs: number,\n): Promise<void> {\n  const { category, kind, name } = entry;\n  const started = Date.now();\n  logger.info({ category, kind, name }, \"adapter hook start\");\n  try {\n    await entry.run(ctx);\n  } finally {\n    const durationMs = Date.now() - started;\n    logger.info({ category, kind, name, durationMs }, \"adapter hook done\");\n    if (durationMs > slowMs) {\n      logger.warn({ category, kind, name, durationMs, slowMs }, \"slow adapter hook\");\n    }\n  }\n}\n\nfunction toFailure(entry: HookEntry, reason: unknown): AdapterSetupFailure {\n  return { category: entry.category, kind: entry.kind, name: entry.name, error: messageOf(reason) };\n}\n\nfunction toResult(\n  entries: HookEntry[],\n  outcomes: PromiseSettledResult<void>[],\n  logger: Logger,\n  verb: string,\n): AdapterSetupResult {\n  const failures: AdapterSetupFailure[] = [];\n  for (const [index, entry] of entries.entries()) {\n    const outcome: PromiseSettledResult<void> | undefined = outcomes[index];\n    if (outcome?.status === \"rejected\") {\n      failures.push(toFailure(entry, outcome.reason));\n    }\n  }\n  if (failures.length > 0) {\n    logger.error({ failures }, `adapter ${verb} failed`);\n  } else {\n    logger.info({ count: entries.length }, `adapters ${verb}d`);\n  }\n  return { ok: failures.length === 0, failures };\n}\n\n/** One run of collected hooks with start/done logging and hung visibility. */\nasync function runHooks(\n  entries: HookEntry[],\n  ctx: AdapterSetupContext,\n  logger: Logger,\n  verb: string,\n  slowMs: number,\n): Promise<AdapterSetupResult> {\n  let settled = false;\n  const timer = setTimeout(() => {\n    if (!settled) {\n      logger.warn({ count: entries.length, slowMs }, `adapters ${verb} still running`);\n    }\n  }, slowMs);\n  timer.unref?.();\n  try {\n    const outcomes = await Promise.allSettled(\n      entries.map(async (entry) => {\n        await runHook(entry, ctx, logger, slowMs);\n      }),\n    );\n    return toResult(entries, outcomes, logger, verb);\n  } finally {\n    settled = true;\n    clearTimeout(timer);\n  }\n}\n\n/** Run setup hooks concurrently; failures are collected, never thrown. */\nexport async function runAdapterSetups(\n  entries: HookEntry[],\n  ctx: AdapterSetupContext,\n  logger: Logger,\n): Promise<AdapterSetupResult> {\n  return await runHooks(entries, ctx, logger, \"setup\", SLOW_SETUP_MS);\n}\n\n/** Run teardown hooks concurrently; failures are collected, never thrown. */\nexport async function runAdapterTeardowns(\n  entries: HookEntry[],\n  ctx: AdapterSetupContext,\n  logger: Logger,\n): Promise<AdapterSetupResult> {\n  return await runHooks(entries, ctx, logger, \"teardown\", SLOW_TEARDOWN_MS);\n}\n"],"mappings":"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"}

package/dist/adapters/sources.d.mts

@@ -0,0 +1,12 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ShelfOptions } from "../config.mjs";
+import { AdapterSetupSources } from "../adapter/setup.mjs";
+//#region src/adapters/sources.d.ts
+/** The adapter slots of `options`, with `auth` carried along for boot validation. */
+declare function adapterSourcesOf(options: ShelfOptions): AdapterSetupSources & {
+  auth?: unknown;
+};
+//#endregion
+export { adapterSourcesOf };
+//# sourceMappingURL=sources.d.mts.map

package/dist/adapters/sources.mjs

@@ -0,0 +1,20 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/adapters/sources.ts
+/** The adapter slots of `options`, with `auth` carried along for boot validation. */
+function adapterSourcesOf(options) {
+	return {
+		database: options.database,
+		storage: options.storage,
+		captureRunner: options.testing?.runner,
+		design: options.design,
+		notifiers: options.notifications?.notifiers,
+		emailSender: options.notifications?.emailSender,
+		auth: options.auth
+	};
+}
+//#endregion
+export { adapterSourcesOf };
+
+//# sourceMappingURL=sources.mjs.map

package/dist/adapters/sources.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.mjs","names":[],"sources":["../../src/adapters/sources.ts"],"sourcesContent":["/** Maps `ShelfOptions` to the flat adapter slots lifecycle, validation and health probing work on. */\nimport type { ShelfOptions } from \"../config.ts\";\nimport type { AdapterSetupSources } from \"./setup.ts\";\n\n/** The adapter slots of `options`, with `auth` carried along for boot validation. */\nexport function adapterSourcesOf(options: ShelfOptions): AdapterSetupSources & { auth?: unknown } {\n  return {\n    database: options.database,\n    storage: options.storage,\n    captureRunner: options.testing?.runner,\n    design: options.design,\n    notifiers: options.notifications?.notifiers,\n    emailSender: options.notifications?.emailSender,\n    auth: options.auth,\n  };\n}\n"],"mappings":";;;;;AAKA,SAAgB,iBAAiB,SAAiE;CAChG,OAAO;EACL,UAAU,QAAQ;EAClB,SAAS,QAAQ;EACjB,eAAe,QAAQ,SAAS;EAChC,QAAQ,QAAQ;EAChB,WAAW,QAAQ,eAAe;EAClC,aAAa,QAAQ,eAAe;EACpC,MAAM,QAAQ;CAChB;AACF"}

package/dist/adapters/validate.mjs

@@ -119,13 +119,13 @@ function emailSenderReasons(sender) {
 	if (typeof record["send"] !== "function") reasons.push("missing methods: send");
 	return reasons;
 }
-/** Reasons a git provider lacks its descriptor shape. */
-function gitReasons(provider) {
+/** Reasons a design provider lacks its descriptor shape. */
+function designReasons(provider) {
 	const record = asRecord(provider);
-	if (!record) return ["git provider must be an object"];
-	const reasons = metadataReasons(record, "git-host");
-	if (typeof record["create"] !== "function") reasons.push("missing methods: create");
-	if (!hasSchemaParse(provider)) reasons.push("metadata.schema must be a zod schema");
+	if (!record) return ["design provider must be an object"];
+	const reasons = metadataReasons(record, "design");
+	const missing = ["parseUrl", "create"].filter((name) => typeof record[name] !== "function");
+	if (missing.length > 0) reasons.push(`missing methods: ${missing.join(", ")}`);
 	return reasons;
 }
 /** Required methods for a slot category. */
@@ -213,17 +213,29 @@ function checkAuth(auth) {
 		error: reasons.join("; ")
 	}];
 }
-/** Failures for git-host or notifier provider lists. */
+const PROVIDER_KINDS = {
+	design: {
+		reasons: designReasons,
+		list: "design",
+		category: "design"
+	},
+	notifier: {
+		reasons: notifierReasons,
+		list: "notifiers",
+		category: "notifier"
+	}
+};
+/** Failures for design or notifier provider lists. */
 function checkProviders(checks) {
 	const failures = [];
 	for (const check of checks) {
-		const reasons = check.kinds === "git" ? gitReasons(check.provider) : notifierReasons(check.provider);
+		const kind = PROVIDER_KINDS[check.kinds];
+		const reasons = kind.reasons(check.provider);
 		if (reasons.length === 0) continue;
-		const slot = check.kinds === "git" ? `gitHosts[${check.index}]` : `notifiers[${check.index}]`;
-		const category = check.kinds === "git" ? "git-host" : "notifier";
+		const slot = `${kind.list}[${check.index}]`;
 		const metadata = asRecord(asRecord(check.provider)?.["metadata"]);
 		failures.push({
-			category,
+			category: kind.category,
 			kind: stringField(metadata, "kind") ?? "unknown",
 			name: stringField(metadata, "name") ?? slot,
 			error: reasons.map((reason) => `${slot}: ${reason}`).join("; ")
@@ -279,15 +291,10 @@ function validateAdapterSources(sources) {
 		category: "capture-runner",
 		slot: "captureRunner"
 	});
-	if (sources.captureQueue !== void 0) checks.push({
-		adapter: sources.captureQueue,
-		category: "capture-queue",
-		slot: "captureQueue"
-	});
-	const providers = [...(sources.gitHosts ?? []).map((provider, index) => ({
+	const providers = [...(sources.design ?? []).map((provider, index) => ({
 		provider,
 		index,
-		kinds: "git"
+		kinds: "design"
 	})), ...(sources.notifiers ?? []).map((provider, index) => ({
 		provider,
 		index,