@storyshelf/core 0.6.2 → 0.8.0

package/dist/adapters/notifier/events.mjs

@@ -1,13 +1,20 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { sanitizeErrorText } from "../../utils/redact.mjs";
 import { formatNotification, formatSystemNotification } from "./format.mjs";
-//#region src/adapters/notifier/events.ts
+import { isStateProvider } from "./provider.mjs";
+// src/adapters/notifier/events.ts
 /** Check an event against a channel's allowlist (empty = all). */
 function subscribed(channel, event) {
 	if (!channel.enabled) return false;
 	return channel.events.length === 0 || channel.events.includes(event);
 }
+/** `state` channels (git hosts) follow build state, never the message fan-out. */
+function isMessageChannel(notifiers, channel) {
+	const provider = providerFor(notifiers, channel.provider);
+	return provider === void 0 || !isStateProvider(provider);
+}
 /** Resolve a provider for a channel kind, or undefined when unwired. */
 function providerFor(notifiers, kind) {
 	return notifiers?.find((candidate) => candidate.metadata.kind === kind);
@@ -16,6 +23,7 @@ function providerFor(notifiers, kind) {
 async function deliver(notifiers, channel, formatted) {
 	const provider = providerFor(notifiers, channel.provider);
 	if (!provider) throw new Error(`notifier missing: ${channel.provider}`);
+	if (isStateProvider(provider)) throw new Error(`notifier ${channel.provider} delivers state, not messages`);
 	await provider.create({
 		config: channel.config,
 		secret: channel.secret
@@ -24,22 +32,33 @@ async function deliver(notifiers, channel, formatted) {
 		formatted
 	});
 }
+/** Deliver to one channel, report the outcome and swallow the failure (logged). */
+async function deliverReported(options, channel, formatted, failure) {
+	let problem;
+	try {
+		await deliver(options.notifiers, channel, formatted);
+	} catch (error) {
+		options.logger?.warn({
+			err: error,
+			channelId: channel.id
+		}, failure);
+		problem = sanitizeErrorText(error instanceof Error ? error.message : String(error), 500);
+	}
+	await options.onOutcome?.({
+		channelId: channel.id,
+		...problem === void 0 ? {} : { error: problem }
+	});
+}
 /**
 * Deliver a project event to every subscribed channel.
 * Inline best-effort: `Promise.allSettled`, failures logged and swallowed.
 */
 async function emitNotifications(event, options = {}) {
-	const targets = (options.channels ?? []).filter((channel) => subscribed(channel, event.event));
+	const targets = (options.channels ?? []).filter((channel) => subscribed(channel, event.event) && isMessageChannel(options.notifiers, channel));
 	if (targets.length === 0) return;
+	const formatted = formatNotification(event, options.brand);
 	await Promise.allSettled(targets.map(async (channel) => {
-		try {
-			await deliver(options.notifiers, channel, formatNotification(event, options.brand));
-		} catch (error) {
-			options.logger?.warn({
-				err: error,
-				channelId: channel.id
-			}, "notification failed");
-		}
+		await deliverReported(options, channel, formatted, "notification failed");
 	}));
 }
 /**
@@ -47,20 +66,13 @@ async function emitNotifications(event, options = {}) {
 * (e.g. `sys:user-created`, `sys:capture-failed`, `sys:purge-completed`).
 */
 async function emitSystemNotification(event, options = {}) {
-	const targets = (options.channels ?? []).filter((channel) => channel.projectId === null && subscribed(channel, event.event));
+	const targets = (options.channels ?? []).filter((channel) => channel.projectId === null && subscribed(channel, event.event) && isMessageChannel(options.notifiers, channel));
 	if (targets.length === 0) return;
+	const formatted = formatSystemNotification(event, options.brand);
 	await Promise.allSettled(targets.map(async (channel) => {
-		try {
-			await deliver(options.notifiers, channel, formatSystemNotification(event, options.brand));
-		} catch (error) {
-			options.logger?.warn({
-				err: error,
-				channelId: channel.id
-			}, "system notification failed");
-		}
+		await deliverReported(options, channel, formatted, "system notification failed");
 	}));
 }
-//#endregion
 export { emitNotifications, emitSystemNotification };
 
 //# sourceMappingURL=events.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"events.mjs","names":[],"sources":["../../../src/adapters/notifier/events.ts"],"sourcesContent":["import type { Logger } from \"../../logger.ts\";\nimport { formatNotification, formatSystemNotification } from \"./format.ts\";\nimport type { NotifierProvider } from \"./provider.ts\";\nimport type {\n  NotificationBrand,\n  NotificationChannel,\n  NotificationEvent,\n  SystemNotification,\n} from \"./types.ts\";\n\n/** Options for project-event fan-out (inline best-effort, non-fatal). */\nexport interface EmitNotificationsOptions {\n  notifiers?: NotifierProvider[];\n  channels?: NotificationChannel[];\n  brand?: NotificationBrand;\n  logger?: Logger;\n}\n\n/** Check an event against a channel's allowlist (empty = all). */\nfunction subscribed(channel: NotificationChannel, event: string): boolean {\n  if (!channel.enabled) {\n    return false;\n  }\n  return channel.events.length === 0 || channel.events.includes(event);\n}\n\n/** Resolve a provider for a channel kind, or undefined when unwired. */\nfunction providerFor(\n  notifiers: NotifierProvider[] | undefined,\n  kind: string,\n): NotifierProvider | undefined {\n  return notifiers?.find((candidate) => candidate.metadata.kind === kind);\n}\n\n/** Send one formatted event through a channel's provider (throws on failure). */\nasync function deliver(\n  notifiers: NotifierProvider[] | undefined,\n  channel: NotificationChannel,\n  formatted: ReturnType<typeof formatNotification>,\n): Promise<void> {\n  const provider = providerFor(notifiers, channel.provider);\n  if (!provider) {\n    throw new Error(`notifier missing: ${channel.provider}`);\n  }\n  const sender = provider.create({ config: channel.config, secret: channel.secret });\n  await sender.send({ channel, formatted });\n}\n\n/**\n * Deliver a project event to every subscribed channel.\n * Inline best-effort: `Promise.allSettled`, failures logged and swallowed.\n */\nexport async function emitNotifications(\n  event: NotificationEvent,\n  options: EmitNotificationsOptions = {},\n): Promise<void> {\n  const targets = (options.channels ?? []).filter((channel) => subscribed(channel, event.event));\n  if (targets.length === 0) {\n    return;\n  }\n  await Promise.allSettled(\n    targets.map(async (channel) => {\n      try {\n        await deliver(options.notifiers, channel, formatNotification(event, options.brand));\n      } catch (error) {\n        options.logger?.warn({ err: error, channelId: channel.id }, \"notification failed\");\n      }\n    }),\n  );\n}\n\n/**\n * Deliver a site-wide admin alert to project-less channels\n * (e.g. `sys:user-created`, `sys:capture-failed`, `sys:purge-completed`).\n */\nexport async function emitSystemNotification(\n  event: SystemNotification,\n  options: EmitNotificationsOptions = {},\n): Promise<void> {\n  const targets = (options.channels ?? []).filter(\n    (channel) => channel.projectId === null && subscribed(channel, event.event),\n  );\n  if (targets.length === 0) {\n    return;\n  }\n  await Promise.allSettled(\n    targets.map(async (channel) => {\n      try {\n        await deliver(options.notifiers, channel, formatSystemNotification(event, options.brand));\n      } catch (error) {\n        options.logger?.warn({ err: error, channelId: channel.id }, \"system notification failed\");\n      }\n    }),\n  );\n}\n"],"mappings":";;;;;;AAmBA,SAAS,WAAW,SAA8B,OAAwB;CACxE,IAAI,CAAC,QAAQ,SACX,OAAO;CAET,OAAO,QAAQ,OAAO,WAAW,KAAK,QAAQ,OAAO,SAAS,KAAK;AACrE;;AAGA,SAAS,YACP,WACA,MAC8B;CAC9B,OAAO,WAAW,MAAM,cAAc,UAAU,SAAS,SAAS,IAAI;AACxE;;AAGA,eAAe,QACb,WACA,SACA,WACe;CACf,MAAM,WAAW,YAAY,WAAW,QAAQ,QAAQ;CACxD,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,qBAAqB,QAAQ,UAAU;CAGzD,MADe,SAAS,OAAO;EAAE,QAAQ,QAAQ;EAAQ,QAAQ,QAAQ;CAAO,CACrE,CAAC,CAAC,KAAK;EAAE;EAAS;CAAU,CAAC;AAC1C;;;;;AAMA,eAAsB,kBACpB,OACA,UAAoC,CAAC,GACtB;CACf,MAAM,WAAW,QAAQ,YAAY,CAAC,EAAA,CAAG,QAAQ,YAAY,WAAW,SAAS,MAAM,KAAK,CAAC;CAC7F,IAAI,QAAQ,WAAW,GACrB;CAEF,MAAM,QAAQ,WACZ,QAAQ,IAAI,OAAO,YAAY;EAC7B,IAAI;GACF,MAAM,QAAQ,QAAQ,WAAW,SAAS,mBAAmB,OAAO,QAAQ,KAAK,CAAC;EACpF,SAAS,OAAO;GACd,QAAQ,QAAQ,KAAK;IAAE,KAAK;IAAO,WAAW,QAAQ;GAAG,GAAG,qBAAqB;EACnF;CACF,CAAC,CACH;AACF;;;;;AAMA,eAAsB,uBACpB,OACA,UAAoC,CAAC,GACtB;CACf,MAAM,WAAW,QAAQ,YAAY,CAAC,EAAA,CAAG,QACtC,YAAY,QAAQ,cAAc,QAAQ,WAAW,SAAS,MAAM,KAAK,CAC5E;CACA,IAAI,QAAQ,WAAW,GACrB;CAEF,MAAM,QAAQ,WACZ,QAAQ,IAAI,OAAO,YAAY;EAC7B,IAAI;GACF,MAAM,QAAQ,QAAQ,WAAW,SAAS,yBAAyB,OAAO,QAAQ,KAAK,CAAC;EAC1F,SAAS,OAAO;GACd,QAAQ,QAAQ,KAAK;IAAE,KAAK;IAAO,WAAW,QAAQ;GAAG,GAAG,4BAA4B;EAC1F;CACF,CAAC,CACH;AACF"}
+{"version":3,"file":"events.mjs","names":[],"sources":["../../../src/adapters/notifier/events.ts"],"sourcesContent":["import type { Logger } from \"../../logger.ts\";\nimport { sanitizeErrorText } from \"../../utils/redact.ts\";\nimport { formatNotification, formatSystemNotification } from \"./format.ts\";\nimport { isStateProvider, type NotifierProvider } from \"./provider.ts\";\nimport type {\n  ChannelOutcome,\n  NotificationBrand,\n  NotificationChannel,\n  NotificationEvent,\n  SystemNotification,\n} from \"./types.ts\";\n\n/** Options for project-event fan-out (inline best-effort, non-fatal). */\nexport interface EmitNotificationsOptions {\n  notifiers?: NotifierProvider[];\n  channels?: NotificationChannel[];\n  brand?: NotificationBrand;\n  logger?: Logger;\n  /** Called once per attempted channel so the host can record or clear its last error. */\n  onOutcome?: (outcome: ChannelOutcome) => Promise<void> | void;\n}\n\n/** Check an event against a channel's allowlist (empty = all). */\nfunction subscribed(channel: NotificationChannel, event: string): boolean {\n  if (!channel.enabled) {\n    return false;\n  }\n  return channel.events.length === 0 || channel.events.includes(event);\n}\n\n/** `state` channels (git hosts) follow build state, never the message fan-out. */\nfunction isMessageChannel(\n  notifiers: NotifierProvider[] | undefined,\n  channel: NotificationChannel,\n): boolean {\n  const provider = providerFor(notifiers, channel.provider);\n  return provider === undefined || !isStateProvider(provider);\n}\n\n/** Resolve a provider for a channel kind, or undefined when unwired. */\nfunction providerFor(\n  notifiers: NotifierProvider[] | undefined,\n  kind: string,\n): NotifierProvider | undefined {\n  return notifiers?.find((candidate) => candidate.metadata.kind === kind);\n}\n\n/** Send one formatted event through a channel's provider (throws on failure). */\nasync function deliver(\n  notifiers: NotifierProvider[] | undefined,\n  channel: NotificationChannel,\n  formatted: ReturnType<typeof formatNotification>,\n): Promise<void> {\n  const provider = providerFor(notifiers, channel.provider);\n  if (!provider) {\n    throw new Error(`notifier missing: ${channel.provider}`);\n  }\n  if (isStateProvider(provider)) {\n    throw new Error(`notifier ${channel.provider} delivers state, not messages`);\n  }\n  const sender = provider.create({ config: channel.config, secret: channel.secret });\n  await sender.send({ channel, formatted });\n}\n\n/** Deliver to one channel, report the outcome and swallow the failure (logged). */\nasync function deliverReported(\n  options: EmitNotificationsOptions,\n  channel: NotificationChannel,\n  formatted: ReturnType<typeof formatNotification>,\n  failure: string,\n): Promise<void> {\n  let problem: string | undefined;\n  try {\n    await deliver(options.notifiers, channel, formatted);\n  } catch (error) {\n    options.logger?.warn({ err: error, channelId: channel.id }, failure);\n    problem = sanitizeErrorText(error instanceof Error ? error.message : String(error), 500);\n  }\n  await options.onOutcome?.({\n    channelId: channel.id,\n    ...(problem === undefined ? {} : { error: problem }),\n  });\n}\n\n/**\n * Deliver a project event to every subscribed channel.\n * Inline best-effort: `Promise.allSettled`, failures logged and swallowed.\n */\nexport async function emitNotifications(\n  event: NotificationEvent,\n  options: EmitNotificationsOptions = {},\n): Promise<void> {\n  const targets = (options.channels ?? []).filter(\n    (channel) => subscribed(channel, event.event) && isMessageChannel(options.notifiers, channel),\n  );\n  if (targets.length === 0) {\n    return;\n  }\n  const formatted = formatNotification(event, options.brand);\n  await Promise.allSettled(\n    targets.map(async (channel) => {\n      await deliverReported(options, channel, formatted, \"notification failed\");\n    }),\n  );\n}\n\n/**\n * Deliver a site-wide admin alert to project-less channels\n * (e.g. `sys:user-created`, `sys:capture-failed`, `sys:purge-completed`).\n */\nexport async function emitSystemNotification(\n  event: SystemNotification,\n  options: EmitNotificationsOptions = {},\n): Promise<void> {\n  const targets = (options.channels ?? []).filter(\n    (channel) =>\n      channel.projectId === null &&\n      subscribed(channel, event.event) &&\n      isMessageChannel(options.notifiers, channel),\n  );\n  if (targets.length === 0) {\n    return;\n  }\n  const formatted = formatSystemNotification(event, options.brand);\n  await Promise.allSettled(\n    targets.map(async (channel) => {\n      await deliverReported(options, channel, formatted, \"system notification failed\");\n    }),\n  );\n}\n"],"mappings":";;;;;;;;AAuBA,SAAS,WAAW,SAA8B,OAAwB;CACxE,IAAI,CAAC,QAAQ,SACX,OAAO;CAET,OAAO,QAAQ,OAAO,WAAW,KAAK,QAAQ,OAAO,SAAS,KAAK;AACrE;;AAGA,SAAS,iBACP,WACA,SACS;CACT,MAAM,WAAW,YAAY,WAAW,QAAQ,QAAQ;CACxD,OAAO,aAAa,KAAA,KAAa,CAAC,gBAAgB,QAAQ;AAC5D;;AAGA,SAAS,YACP,WACA,MAC8B;CAC9B,OAAO,WAAW,MAAM,cAAc,UAAU,SAAS,SAAS,IAAI;AACxE;;AAGA,eAAe,QACb,WACA,SACA,WACe;CACf,MAAM,WAAW,YAAY,WAAW,QAAQ,QAAQ;CACxD,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,qBAAqB,QAAQ,UAAU;CAEzD,IAAI,gBAAgB,QAAQ,GAC1B,MAAM,IAAI,MAAM,YAAY,QAAQ,SAAS,8BAA8B;CAG7E,MADe,SAAS,OAAO;EAAE,QAAQ,QAAQ;EAAQ,QAAQ,QAAQ;CAAO,CACrE,CAAC,CAAC,KAAK;EAAE;EAAS;CAAU,CAAC;AAC1C;;AAGA,eAAe,gBACb,SACA,SACA,WACA,SACe;CACf,IAAI;CACJ,IAAI;EACF,MAAM,QAAQ,QAAQ,WAAW,SAAS,SAAS;CACrD,SAAS,OAAO;EACd,QAAQ,QAAQ,KAAK;GAAE,KAAK;GAAO,WAAW,QAAQ;EAAG,GAAG,OAAO;EACnE,UAAU,kBAAkB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,GAAG;CACzF;CACA,MAAM,QAAQ,YAAY;EACxB,WAAW,QAAQ;EACnB,GAAI,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,QAAQ;CACpD,CAAC;AACH;;;;;AAMA,eAAsB,kBACpB,OACA,UAAoC,CAAC,GACtB;CACf,MAAM,WAAW,QAAQ,YAAY,CAAC,EAAA,CAAG,QACtC,YAAY,WAAW,SAAS,MAAM,KAAK,KAAK,iBAAiB,QAAQ,WAAW,OAAO,CAC9F;CACA,IAAI,QAAQ,WAAW,GACrB;CAEF,MAAM,YAAY,mBAAmB,OAAO,QAAQ,KAAK;CACzD,MAAM,QAAQ,WACZ,QAAQ,IAAI,OAAO,YAAY;EAC7B,MAAM,gBAAgB,SAAS,SAAS,WAAW,qBAAqB;CAC1E,CAAC,CACH;AACF;;;;;AAMA,eAAsB,uBACpB,OACA,UAAoC,CAAC,GACtB;CACf,MAAM,WAAW,QAAQ,YAAY,CAAC,EAAA,CAAG,QACtC,YACC,QAAQ,cAAc,QACtB,WAAW,SAAS,MAAM,KAAK,KAC/B,iBAAiB,QAAQ,WAAW,OAAO,CAC/C;CACA,IAAI,QAAQ,WAAW,GACrB;CAEF,MAAM,YAAY,yBAAyB,OAAO,QAAQ,KAAK;CAC/D,MAAM,QAAQ,WACZ,QAAQ,IAAI,OAAO,YAAY;EAC7B,MAAM,gBAAgB,SAAS,SAAS,WAAW,4BAA4B;CACjF,CAAC,CACH;AACF"}

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

@@ -1,32 +1,76 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { FormattedNotification, NotificationChannel } from "./types.mjs";
+import { FormattedNotification, NotificationChannel, NotifierState, NotifierStateTarget } from "./types.mjs";
 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). */
 interface NotifierMetadata extends AdapterMetadata {
   readonly category: "notifier";
   readonly logo?: string;
   readonly schema: z.ZodType;
+  /** Delivery kind; absent means `message` (chat, email). */
+  readonly delivery?: NotifierDelivery;
 }
-/** Descriptor — registered at startup, validates per-channel config. */
-interface NotifierProvider extends Adapter<NotifierMetadata> {
+/** Metadata of a `message` provider (Slack, Teams, email). */
+interface MessageNotifierMetadata extends NotifierMetadata {
+  readonly delivery?: "message";
+}
+/** Metadata of a `state` provider (GitHub, GitLab): `delivery` is mandatory. */
+interface StateNotifierMetadata extends NotifierMetadata {
+  readonly delivery: "state";
+}
+/** Descriptor of a `message` provider, registered at startup. */
+interface MessageNotifierProvider extends Adapter<MessageNotifierMetadata> {
   create(opts: {
     config: unknown;
     secret?: string;
     logger?: Logger;
-  }): NotifierAdapter;
+  }): MessageNotifierAdapter;
 }
-/** Runtime — bound to one channel config + decrypted secret, sends one message. */
-interface NotifierAdapter extends Adapter<NotifierMetadata> {
+/** Descriptor of a `state` provider, registered at startup. */
+interface StateNotifierProvider extends Adapter<StateNotifierMetadata> {
+  create(opts: {
+    config: unknown;
+    secret?: string;
+    logger?: Logger;
+  }): StateNotifierAdapter;
+}
+/** Descriptor — registered at startup, validates per-channel config. */
+type NotifierProvider = MessageNotifierProvider | StateNotifierProvider;
+/** Runtime of a `message` provider — bound to one channel config + secret, sends one message. */
+interface MessageNotifierAdapter extends Adapter<MessageNotifierMetadata> {
   send(input: {
     channel: NotificationChannel;
     formatted: FormattedNotification;
     logger?: Logger;
   }): Promise<void>;
 }
-//#endregion
-export { NotifierAdapter, NotifierMetadata, NotifierProvider };
+/** Input of one idempotent state write. */
+interface SetStateInput {
+  channel: NotificationChannel;
+  /** What to make the host show: a commit status or a pull-request comment. */
+  target: NotifierStateTarget;
+  state: NotifierState;
+  /**
+   * Link back to the build page; also keys the pull-request comment. Absent while no public origin
+   * is known (ADR 0007): a status then has no link and a comment is not written.
+   */
+  url?: string | undefined;
+  logger?: Logger;
+}
+/**
+ * Runtime of a `state` provider: idempotent, latest call wins. A provider that
+ * cannot show a target kind (no comment support) skips it silently.
+ */
+interface StateNotifierAdapter extends Adapter<StateNotifierMetadata> {
+  setState(input: SetStateInput): Promise<void>;
+}
+/** Runtime — bound to one channel config + decrypted secret. */
+type NotifierAdapter = MessageNotifierAdapter | StateNotifierAdapter;
+/** True when the provider delivers state (git hosts) rather than messages. */
+declare function isStateProvider(provider: NotifierProvider): provider is StateNotifierProvider;
+export { MessageNotifierAdapter, MessageNotifierMetadata, MessageNotifierProvider, NotifierAdapter, NotifierDelivery, NotifierMetadata, NotifierProvider, SetStateInput, StateNotifierAdapter, StateNotifierMetadata, StateNotifierProvider, isStateProvider };
 //# sourceMappingURL=provider.d.mts.map

package/dist/adapters/notifier/provider.mjs

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.mjs","names":[],"sources":["../../../src/adapters/notifier/provider.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport type { z } from \"zod\";\nimport type { Adapter, AdapterMetadata } from \"../metadata.ts\";\nimport type {\n  FormattedNotification,\n  NotificationChannel,\n  NotifierState,\n  NotifierStateTarget,\n} from \"./types.ts\";\n\n/** How a provider delivers: `message` sends once, `state` makes a host show a named state. */\nexport type NotifierDelivery = \"message\" | \"state\";\n\n/** Notifier-specific metadata (adds logo + config validation schema). */\nexport interface NotifierMetadata extends AdapterMetadata {\n  readonly category: \"notifier\";\n  readonly logo?: string;\n  readonly schema: z.ZodType;\n  /** Delivery kind; absent means `message` (chat, email). */\n  readonly delivery?: NotifierDelivery;\n}\n\n/** Metadata of a `message` provider (Slack, Teams, email). */\nexport interface MessageNotifierMetadata extends NotifierMetadata {\n  readonly delivery?: \"message\";\n}\n\n/** Metadata of a `state` provider (GitHub, GitLab): `delivery` is mandatory. */\nexport interface StateNotifierMetadata extends NotifierMetadata {\n  readonly delivery: \"state\";\n}\n\n/** Descriptor of a `message` provider, registered at startup. */\nexport interface MessageNotifierProvider extends Adapter<MessageNotifierMetadata> {\n  create(opts: { config: unknown; secret?: string; logger?: Logger }): MessageNotifierAdapter;\n}\n\n/** Descriptor of a `state` provider, registered at startup. */\nexport interface StateNotifierProvider extends Adapter<StateNotifierMetadata> {\n  create(opts: { config: unknown; secret?: string; logger?: Logger }): StateNotifierAdapter;\n}\n\n/** Descriptor — registered at startup, validates per-channel config. */\nexport type NotifierProvider = MessageNotifierProvider | StateNotifierProvider;\n\n/** Runtime of a `message` provider — bound to one channel config + secret, sends one message. */\nexport interface MessageNotifierAdapter extends Adapter<MessageNotifierMetadata> {\n  send(input: {\n    channel: NotificationChannel;\n    formatted: FormattedNotification;\n    logger?: Logger;\n  }): Promise<void>;\n}\n\n/** Input of one idempotent state write. */\nexport interface SetStateInput {\n  channel: NotificationChannel;\n  /** What to make the host show: a commit status or a pull-request comment. */\n  target: NotifierStateTarget;\n  state: NotifierState;\n  /**\n   * Link back to the build page; also keys the pull-request comment. Absent while no public origin\n   * is known (ADR 0007): a status then has no link and a comment is not written.\n   */\n  url?: string | undefined;\n  logger?: Logger;\n}\n\n/**\n * Runtime of a `state` provider: idempotent, latest call wins. A provider that\n * cannot show a target kind (no comment support) skips it silently.\n */\nexport interface StateNotifierAdapter extends Adapter<StateNotifierMetadata> {\n  setState(input: SetStateInput): Promise<void>;\n}\n\n/** Runtime — bound to one channel config + decrypted secret. */\nexport type NotifierAdapter = MessageNotifierAdapter | StateNotifierAdapter;\n\n/** True when the provider delivers state (git hosts) rather than messages. */\nexport function isStateProvider(provider: NotifierProvider): provider is StateNotifierProvider {\n  return provider.metadata.delivery === \"state\";\n}\n"],"mappings":";;;;;AAgFA,SAAgB,gBAAgB,UAA+D;CAC7F,OAAO,SAAS,SAAS,aAAa;AACxC"}

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

@@ -0,0 +1,22 @@
+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";
+/** 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>;
+export { DEFAULT_STATUS_PREFIX, channelPrefix, writeBuildState };
+//# sourceMappingURL=state.d.mts.map

package/dist/adapters/notifier/state.mjs

@@ -0,0 +1,65 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// 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");
+		});
+	}
+}
+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

@@ -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;
@@ -42,6 +41,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 +98,6 @@ 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";
-//#endregion
-export { ChannelToggles, FormattedNotification, NotificationBrand, NotificationChannel, NotificationEvent, SystemEventName, SystemNotification };
+type SystemEventName = "sys:user-created" | "sys:invite-issued" | "sys:auth-failed" | "sys:capture-failed" | "sys:purge-completed" | "sys:notify-failed" | "sys:ai-budget";
+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,168 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BrowserName, CaptureTarget, TargetReach } from "./capture-target.mjs";
+/** 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. A function `connect` is called per connection, so a token can be fresh. */
+interface RemoteConnection {
+  /** `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;
+  /**
+   * Aborts while `connect` is pending: on `timeouts.acquireMs`, a cancel (user, build, render
+   * budget) and shutdown. Spent once `connect` resolves.
+   */
+  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<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[];
+  /** 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;
+  /** 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: `attempts` after the first (default 3), `backoffMs` doubling (default 500). */
+  retry?: {
+    attempts?: number | undefined;
+    backoffMs?: number | undefined;
+  } | undefined;
+  /**
+   * `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.
+   */
+  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 {
+  readonly kind: "remote";
+  readonly name: string;
+  readonly engines: readonly BrowserName[];
+  readonly sessions: number | (() => number);
+  readonly maxPagesPerConnection?: number | undefined;
+  readonly maxConnections?: number | 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 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 {
+  /** 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: 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<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[];
+/** 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, every header value and every
+ * value inside the lease (non-strings are stringified).
+ */
+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