@storyshelf/core 0.6.2 → 0.7.0

package/dist/capture/adapter.d.mts

@@ -15,6 +15,23 @@ interface StoryViewportConfig {
   defaultViewport?: string;
   viewports?: Record<string, StoryViewportDefinition>;
 }
+/** Viewport a mode captures at: a width, a Storybook viewport name, or explicit dimensions. */
+type ModeViewportValue = number | string | {
+  width: number;
+  height: number;
+};
+/**
+ * One entry of `parameters.{chromatic,storyshelf}.modes`. `viewport` sizes the
+ * page, `disable` removes an inherited mode, every other key is a Storybook
+ * global (theme, locale, backgrounds, …) applied through the `globals` URL arg.
+ */
+interface ModeDefinition {
+  viewport?: ModeViewportValue;
+  disable?: boolean;
+  [global: string]: unknown;
+}
+/** Named modes keyed by display name (the slug of the name is the baseline identity). */
+type ModeMap = Record<string, ModeDefinition>;
 /** Per-story capture parameters from the Storybook index. */
 interface StoryParameters {
   disableSnapshot?: boolean;
@@ -39,6 +56,8 @@ interface StoryParameters {
   waitForFonts?: boolean;
   /** Storybook viewport config; adds the story's default viewport to the project list at capture time. */
   viewport?: StoryViewportConfig;
+  /** Named modes: extra captures of this story under different globals/viewports. */
+  modes?: ModeMap;
 }
 /** Return whether a story is marked flaky (failures stay non-blocking). */
 declare function isFlakyStory(entry: Pick<StoryEntry, "tags" | "parameters">): boolean;
@@ -52,18 +71,35 @@ interface StoryEntry {
   importPath?: string;
   tags?: string[];
   type: "story" | "docs";
+  /**
+   * Set on a Storybook 10 `.test()` entry (index `subtype: "test"`): the id of the story it is
+   * written under. Test entries are never captured; a project that runs tests runs them in the
+   * iframe (ADR 0004, decision 10).
+   */
+  parentId?: string;
   parameters?: StoryParameters;
+  /** Figma URL declared via `parameters.design` / `parameters.storyshelf.figma`. */
+  designUrl?: string;
+  /** Declared design value that is not a usable Figma URL (ignored; logged at capture). */
+  designInvalid?: string;
 }
 /** Minimal structural page handle handed to `StorySourceAdapter.waitForReady`. */
 interface CapturePage {
   evaluate(pageFunction: string | ((...args: unknown[]) => unknown), arg?: unknown): Promise<unknown>;
   waitForSelector(selector: string, options?: Record<string, unknown>): Promise<unknown>;
 }
+/** Optional discovery inputs. */
+interface DiscoverOptions {
+  /** Validates declared design links (`design` / `storyshelf.figma`); without it none are extracted. */
+  parseDesignUrl?: (raw: string) => {
+    url: string;
+  } | null;
+}
 /** Adapter that discovers and renders stories from a Storybook build. */
 interface StorySourceAdapter {
   name: string;
-  discover(source: string): Promise<StoryEntry[]>;
-  buildUrl(baseUrl: string, storyId: string): string;
+  discover(source: string, options?: DiscoverOptions): Promise<StoryEntry[]>;
+  buildUrl(baseUrl: string, storyId: string, globals?: Record<string, unknown>): string;
   screenshotSelector?: string;
   /**
    * Optional hook loading the module dependency graph of an extracted build,
@@ -85,9 +121,11 @@ interface Viewport {
   name: string;
   width: number;
   height: number;
+  /** Storybook globals applied for this capture (set for modes only). */
+  globals?: Record<string, unknown>;
 }
 /** Default viewport used when none is configured. */
 declare const DEFAULT_VIEWPORTS: Viewport[];
 //#endregion
-export { CapturePage, DEFAULT_VIEWPORTS, StoryEntry, StoryParameters, StorySourceAdapter, StoryViewportConfig, StoryViewportDefinition, Viewport, isDisabledStory, isFlakyStory };
+export { CapturePage, DEFAULT_VIEWPORTS, DiscoverOptions, ModeDefinition, ModeMap, ModeViewportValue, StoryEntry, StoryParameters, StorySourceAdapter, StoryViewportConfig, StoryViewportDefinition, Viewport, isDisabledStory, isFlakyStory };
 //# sourceMappingURL=adapter.d.mts.map

package/dist/capture/adapter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.mjs","names":[],"sources":["../../src/capture/adapter.ts"],"sourcesContent":["import type { DepGraph } from \"@storyshelf/affected\";\n\n/** A custom viewport registered on a story via `parameters.viewport`. */\nexport interface StoryViewportDefinition {\n  name?: string;\n  styles?: {\n    width?: string | number;\n    height?: string | number;\n  };\n}\n\n/** Storybook `parameters.viewport` config; carried through discovery for per-story viewport capture. */\nexport interface StoryViewportConfig {\n  defaultViewport?: string;\n  viewports?: Record<string, StoryViewportDefinition>;\n}\n\n/** Per-story capture parameters from the Storybook index. */\nexport interface StoryParameters {\n  disableSnapshot?: boolean;\n  delay?: number;\n  diffThreshold?: number;\n  pauseAnimationAtEnd?: boolean;\n  flakyTest?: boolean;\n  /** Force auto-crop (true) or full viewport (false) for this story; undefined uses 60% whitespace rule. */\n  autoCrop?: boolean;\n  /** Whitespace fraction (0..1) above which we crop; default 0.6. */\n  autoCropThreshold?: number;\n  /** Whether overflow should trigger fullPage; default true. */\n  fullPageOnOverflow?: boolean;\n  /** Min dimensions for the final PNG (clamp after padding). */\n  minWidth?: number;\n  minHeight?: number;\n  maxWidth?: number;\n  maxHeight?: number;\n  /** Burst count for steady capture (1 = single shot, 3 = burst 100ms); default 1. */\n  burst?: number;\n  /** Whether to wait for fonts.ready before screenshot; default true when burst >1. */\n  waitForFonts?: boolean;\n  /** Storybook viewport config; adds the story's default viewport to the project list at capture time. */\n  viewport?: StoryViewportConfig;\n}\n\n/** Return whether a story is marked flaky (failures stay non-blocking). */\nexport function isFlakyStory(entry: Pick<StoryEntry, \"tags\" | \"parameters\">): boolean {\n  if (entry.parameters?.flakyTest) return true;\n  const tags = entry.tags ?? [];\n  for (const t of tags) {\n    if (t.toLowerCase() === \"flaky-test\") return true;\n  }\n  return false;\n}\n\n/** Return whether a story is excluded from snapshot capture. */\nexport function isDisabledStory(entry: Pick<StoryEntry, \"tags\" | \"parameters\">): boolean {\n  if (entry.parameters?.disableSnapshot) return true;\n  const tags = entry.tags ?? [];\n  for (const t of tags) {\n    const lower = t.toLowerCase();\n    if (lower === \"skip\" || lower === \"disable\" || lower === \"disable-snapshot\") return true;\n  }\n  return false;\n}\n\n/** A single discoverable story or docs entry within a Storybook. */\nexport interface StoryEntry {\n  id: string;\n  title: string;\n  name: string;\n  importPath?: string;\n  tags?: string[];\n  type: \"story\" | \"docs\";\n  parameters?: StoryParameters;\n}\n\n/** Minimal structural page handle handed to `StorySourceAdapter.waitForReady`. */\nexport interface CapturePage {\n  evaluate(\n    pageFunction: string | ((...args: unknown[]) => unknown),\n    arg?: unknown,\n  ): Promise<unknown>;\n  waitForSelector(selector: string, options?: Record<string, unknown>): Promise<unknown>;\n}\n\n/** Adapter that discovers and renders stories from a Storybook build. */\nexport interface StorySourceAdapter {\n  name: string;\n  discover(source: string): Promise<StoryEntry[]>;\n  buildUrl(baseUrl: string, storyId: string): string;\n  screenshotSelector?: string;\n  /**\n   * Optional hook loading the module dependency graph of an extracted build,\n   * enabling affected capture (render only stories downstream of a change).\n   * Absent (or resolving `null`) means the source cannot be traced, so the\n   * orchestrator renders every story.\n   */\n  loadDependencyGraph?(sourceDir: string): Promise<DepGraph | null>;\n  /**\n   * Optional hook invoked after navigation and before the screenshot sequence,\n   * letting a custom source wait until it is ready to capture. The built-in\n   * Storybook adapter leaves this undefined (rendered via iframe). See\n   * ADR 0005.\n   */\n  waitForReady?(page: CapturePage): Promise<void>;\n}\n\n/** A viewport size at which stories are captured. */\nexport interface Viewport {\n  name: string;\n  width: number;\n  height: number;\n}\n\n/** Default viewport used when none is configured. */\nexport const DEFAULT_VIEWPORTS: Viewport[] = [{ name: \"desktop\", width: 1280, height: 720 }];\n"],"mappings":";;;;;AA4CA,SAAgB,aAAa,OAAyD;CACpF,IAAI,MAAM,YAAY,WAAW,OAAO;CACxC,MAAM,OAAO,MAAM,QAAQ,CAAC;CAC5B,KAAK,MAAM,KAAK,MACd,IAAI,EAAE,YAAY,MAAM,cAAc,OAAO;CAE/C,OAAO;AACT;;AAGA,SAAgB,gBAAgB,OAAyD;CACvF,IAAI,MAAM,YAAY,iBAAiB,OAAO;CAC9C,MAAM,OAAO,MAAM,QAAQ,CAAC;CAC5B,KAAK,MAAM,KAAK,MAAM;EACpB,MAAM,QAAQ,EAAE,YAAY;EAC5B,IAAI,UAAU,UAAU,UAAU,aAAa,UAAU,oBAAoB,OAAO;CACtF;CACA,OAAO;AACT;;AAoDA,MAAa,oBAAgC,CAAC;CAAE,MAAM;CAAW,OAAO;CAAM,QAAQ;AAAI,CAAC"}
+{"version":3,"file":"adapter.mjs","names":[],"sources":["../../src/capture/adapter.ts"],"sourcesContent":["import type { DepGraph } from \"@storyshelf/affected\";\n\n/** A custom viewport registered on a story via `parameters.viewport`. */\nexport interface StoryViewportDefinition {\n  name?: string;\n  styles?: {\n    width?: string | number;\n    height?: string | number;\n  };\n}\n\n/** Storybook `parameters.viewport` config; carried through discovery for per-story viewport capture. */\nexport interface StoryViewportConfig {\n  defaultViewport?: string;\n  viewports?: Record<string, StoryViewportDefinition>;\n}\n\n/** Viewport a mode captures at: a width, a Storybook viewport name, or explicit dimensions. */\nexport type ModeViewportValue = number | string | { width: number; height: number };\n\n/**\n * One entry of `parameters.{chromatic,storyshelf}.modes`. `viewport` sizes the\n * page, `disable` removes an inherited mode, every other key is a Storybook\n * global (theme, locale, backgrounds, …) applied through the `globals` URL arg.\n */\nexport interface ModeDefinition {\n  viewport?: ModeViewportValue;\n  disable?: boolean;\n  [global: string]: unknown;\n}\n\n/** Named modes keyed by display name (the slug of the name is the baseline identity). */\nexport type ModeMap = Record<string, ModeDefinition>;\n\n/** Per-story capture parameters from the Storybook index. */\nexport interface StoryParameters {\n  disableSnapshot?: boolean;\n  delay?: number;\n  diffThreshold?: number;\n  pauseAnimationAtEnd?: boolean;\n  flakyTest?: boolean;\n  /** Force auto-crop (true) or full viewport (false) for this story; undefined uses 60% whitespace rule. */\n  autoCrop?: boolean;\n  /** Whitespace fraction (0..1) above which we crop; default 0.6. */\n  autoCropThreshold?: number;\n  /** Whether overflow should trigger fullPage; default true. */\n  fullPageOnOverflow?: boolean;\n  /** Min dimensions for the final PNG (clamp after padding). */\n  minWidth?: number;\n  minHeight?: number;\n  maxWidth?: number;\n  maxHeight?: number;\n  /** Burst count for steady capture (1 = single shot, 3 = burst 100ms); default 1. */\n  burst?: number;\n  /** Whether to wait for fonts.ready before screenshot; default true when burst >1. */\n  waitForFonts?: boolean;\n  /** Storybook viewport config; adds the story's default viewport to the project list at capture time. */\n  viewport?: StoryViewportConfig;\n  /** Named modes: extra captures of this story under different globals/viewports. */\n  modes?: ModeMap;\n}\n\n/** Return whether a story is marked flaky (failures stay non-blocking). */\nexport function isFlakyStory(entry: Pick<StoryEntry, \"tags\" | \"parameters\">): boolean {\n  if (entry.parameters?.flakyTest) return true;\n  const tags = entry.tags ?? [];\n  for (const t of tags) {\n    if (t.toLowerCase() === \"flaky-test\") return true;\n  }\n  return false;\n}\n\n/** Return whether a story is excluded from snapshot capture. */\nexport function isDisabledStory(entry: Pick<StoryEntry, \"tags\" | \"parameters\">): boolean {\n  if (entry.parameters?.disableSnapshot) return true;\n  const tags = entry.tags ?? [];\n  for (const t of tags) {\n    const lower = t.toLowerCase();\n    if (lower === \"skip\" || lower === \"disable\" || lower === \"disable-snapshot\") return true;\n  }\n  return false;\n}\n\n/** A single discoverable story or docs entry within a Storybook. */\nexport interface StoryEntry {\n  id: string;\n  title: string;\n  name: string;\n  importPath?: string;\n  tags?: string[];\n  type: \"story\" | \"docs\";\n  /**\n   * Set on a Storybook 10 `.test()` entry (index `subtype: \"test\"`): the id of the story it is\n   * written under. Test entries are never captured; a project that runs tests runs them in the\n   * iframe (ADR 0004, decision 10).\n   */\n  parentId?: string;\n  parameters?: StoryParameters;\n  /** Figma URL declared via `parameters.design` / `parameters.storyshelf.figma`. */\n  designUrl?: string;\n  /** Declared design value that is not a usable Figma URL (ignored; logged at capture). */\n  designInvalid?: string;\n}\n\n/** Minimal structural page handle handed to `StorySourceAdapter.waitForReady`. */\nexport interface CapturePage {\n  evaluate(\n    pageFunction: string | ((...args: unknown[]) => unknown),\n    arg?: unknown,\n  ): Promise<unknown>;\n  waitForSelector(selector: string, options?: Record<string, unknown>): Promise<unknown>;\n}\n\n/** Optional discovery inputs. */\nexport interface DiscoverOptions {\n  /** Validates declared design links (`design` / `storyshelf.figma`); without it none are extracted. */\n  parseDesignUrl?: (raw: string) => { url: string } | null;\n}\n\n/** Adapter that discovers and renders stories from a Storybook build. */\nexport interface StorySourceAdapter {\n  name: string;\n  discover(source: string, options?: DiscoverOptions): Promise<StoryEntry[]>;\n  buildUrl(baseUrl: string, storyId: string, globals?: Record<string, unknown>): string;\n  screenshotSelector?: string;\n  /**\n   * Optional hook loading the module dependency graph of an extracted build,\n   * enabling affected capture (render only stories downstream of a change).\n   * Absent (or resolving `null`) means the source cannot be traced, so the\n   * orchestrator renders every story.\n   */\n  loadDependencyGraph?(sourceDir: string): Promise<DepGraph | null>;\n  /**\n   * Optional hook invoked after navigation and before the screenshot sequence,\n   * letting a custom source wait until it is ready to capture. The built-in\n   * Storybook adapter leaves this undefined (rendered via iframe). See\n   * ADR 0005.\n   */\n  waitForReady?(page: CapturePage): Promise<void>;\n}\n\n/** A viewport size at which stories are captured. */\nexport interface Viewport {\n  name: string;\n  width: number;\n  height: number;\n  /** Storybook globals applied for this capture (set for modes only). */\n  globals?: Record<string, unknown>;\n}\n\n/** Default viewport used when none is configured. */\nexport const DEFAULT_VIEWPORTS: Viewport[] = [{ name: \"desktop\", width: 1280, height: 720 }];\n"],"mappings":";;;;;AA+DA,SAAgB,aAAa,OAAyD;CACpF,IAAI,MAAM,YAAY,WAAW,OAAO;CACxC,MAAM,OAAO,MAAM,QAAQ,CAAC;CAC5B,KAAK,MAAM,KAAK,MACd,IAAI,EAAE,YAAY,MAAM,cAAc,OAAO;CAE/C,OAAO;AACT;;AAGA,SAAgB,gBAAgB,OAAyD;CACvF,IAAI,MAAM,YAAY,iBAAiB,OAAO;CAC9C,MAAM,OAAO,MAAM,QAAQ,CAAC;CAC5B,KAAK,MAAM,KAAK,MAAM;EACpB,MAAM,QAAQ,EAAE,YAAY;EAC5B,IAAI,UAAU,UAAU,UAAU,aAAa,UAAU,oBAAoB,OAAO;CACtF;CACA,OAAO;AACT;;AAsEA,MAAa,oBAAgC,CAAC;CAAE,MAAM;CAAW,OAAO;CAAM,QAAQ;AAAI,CAAC"}

package/dist/capture/affected.d.mts

@@ -10,6 +10,8 @@ interface InheritedStory {
   story: StoryEntry;
   viewport: Viewport;
   baseline: Baseline;
+  /** Engine whose baseline is reused (chromium when absent). */
+  browser?: string;
 }
 //#endregion
 export { InheritedStory };

package/dist/capture/affected.mjs

@@ -1,10 +1,18 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-import { BaselineModel } from "../models/baseline.mjs";
 import { resolveStoryViewports } from "./storybook.mjs";
+import { BuildModel } from "../models/build.mjs";
+import { BaselineModel } from "../models/baseline.mjs";
 import { selectAffectedStories } from "@storyshelf/affected";
 //#region src/capture/affected.ts
+/**
+* Resolve the affected import paths for a build, or `null` for full capture (affected capture
+* disabled, or no computation was posted). The one rule for the whole and the sharded path alike.
+*/
+function affectedPathsFor(build) {
+	return build.affectedOnly ? BuildModel.affectedPaths(build) : null;
+}
 /** Split one inherit candidate by per-viewport baseline availability. */
 async function splitStory(baselines, input, story) {
 	const render = [];
@@ -12,12 +20,13 @@ async function splitStory(baselines, input, story) {
 	const viewports = resolveStoryViewports(story, input.viewports);
 	const settled = await Promise.all(viewports.map(async (viewport) => ({
 		viewport,
-		baseline: await baselines.resolve(input.projectId, story.id, viewport.name, input.branch, input.defaultBranch)
+		baseline: await baselines.resolve(input.projectId, story.id, viewport.name, input.branch, input.defaultBranch, input.browser)
 	})));
 	for (const { viewport, baseline } of settled) if (baseline) inherited.push({
 		story,
 		viewport,
-		baseline
+		baseline,
+		...input.browser ? { browser: input.browser } : {}
 	});
 	else if (!render.includes(story)) render.push(story);
 	return {
@@ -59,6 +68,6 @@ async function partitionAffectedStories(input) {
 	};
 }
 //#endregion
-export { partitionAffectedStories };
+export { affectedPathsFor, partitionAffectedStories };
 
 //# sourceMappingURL=affected.mjs.map

package/dist/capture/affected.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"affected.mjs","names":[],"sources":["../../src/capture/affected.ts"],"sourcesContent":["import { selectAffectedStories } from \"@storyshelf/affected\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport { BaselineModel, type BaselineTables } from \"../models/baseline.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { StoryEntry, Viewport } from \"./adapter.ts\";\nimport { resolveStoryViewports } from \"./storybook.ts\";\n\n/** An inherit candidate paired with the baseline it reuses. */\nexport interface InheritedStory {\n  story: StoryEntry;\n  viewport: Viewport;\n  baseline: Baseline;\n}\n\n/** Stories split into capture-now versus inherit-from-baseline sets. */\nexport interface AffectedPartition {\n  render: StoryEntry[];\n  inherited: InheritedStory[];\n}\n\n/** Inputs for partitioning a build's stories by affected status. */\nexport interface PartitionInput {\n  db: DatabaseAdapter;\n  tables: BaselineTables;\n  projectId: string;\n  branch: string;\n  defaultBranch: string;\n  stories: StoryEntry[];\n  viewports: Viewport[];\n  /** Affected import paths, or `null` to render everything. */\n  affectedPaths: string[] | null;\n}\n\n/** Split one inherit candidate by per-viewport baseline availability. */\nasync function splitStory(\n  baselines: BaselineModel,\n  input: PartitionInput,\n  story: StoryEntry,\n): Promise<AffectedPartition> {\n  const render: StoryEntry[] = [];\n  const inherited: InheritedStory[] = [];\n  const viewports = resolveStoryViewports(story, input.viewports);\n  const settled = await Promise.all(\n    viewports.map(async (viewport) => ({\n      viewport,\n      baseline: await baselines.resolve(\n        input.projectId,\n        story.id,\n        viewport.name,\n        input.branch,\n        input.defaultBranch,\n      ),\n    })),\n  );\n  for (const { viewport, baseline } of settled) {\n    if (baseline) {\n      inherited.push({ story, viewport, baseline });\n    } else if (!render.includes(story)) {\n      render.push(story);\n    }\n  }\n  return { render, inherited };\n}\n\n/** Merge per-story partitions into a single render/inherit split. */\nfunction mergePartitions(partitions: AffectedPartition[]): AffectedPartition {\n  const render: StoryEntry[] = [];\n  const inherited: InheritedStory[] = [];\n  for (const partition of partitions) {\n    render.push(...partition.render);\n    inherited.push(...partition.inherited);\n  }\n  return { render, inherited };\n}\n\n/**\n * Partition discovered stories into render versus inherit sets.\n *\n * Stories outside the affected set inherit their baseline without rendering,\n * except when no baseline exists (new stories always render). A `null`\n * affected set renders everything.\n */\nexport async function partitionAffectedStories(input: PartitionInput): Promise<AffectedPartition> {\n  const selected = selectAffectedStories(input.stories, input.affectedPaths);\n  if (selected.inherit.length === 0) {\n    return { render: selected.render, inherited: [] };\n  }\n  const baselines = new BaselineModel(input.db, input.tables);\n  const partitions = await Promise.all(\n    selected.inherit.map(async (story) => await splitStory(baselines, input, story)),\n  );\n  const merged = mergePartitions(partitions);\n  return { render: [...selected.render, ...merged.render], inherited: merged.inherited };\n}\n"],"mappings":";;;;;;;;AAkCA,eAAe,WACb,WACA,OACA,OAC4B;CAC5B,MAAM,SAAuB,CAAC;CAC9B,MAAM,YAA8B,CAAC;CACrC,MAAM,YAAY,sBAAsB,OAAO,MAAM,SAAS;CAC9D,MAAM,UAAU,MAAM,QAAQ,IAC5B,UAAU,IAAI,OAAO,cAAc;EACjC;EACA,UAAU,MAAM,UAAU,QACxB,MAAM,WACN,MAAM,IACN,SAAS,MACT,MAAM,QACN,MAAM,aACR;CACF,EAAE,CACJ;CACA,KAAK,MAAM,EAAE,UAAU,cAAc,SACnC,IAAI,UACF,UAAU,KAAK;EAAE;EAAO;EAAU;CAAS,CAAC;MACvC,IAAI,CAAC,OAAO,SAAS,KAAK,GAC/B,OAAO,KAAK,KAAK;CAGrB,OAAO;EAAE;EAAQ;CAAU;AAC7B;;AAGA,SAAS,gBAAgB,YAAoD;CAC3E,MAAM,SAAuB,CAAC;CAC9B,MAAM,YAA8B,CAAC;CACrC,KAAK,MAAM,aAAa,YAAY;EAClC,OAAO,KAAK,GAAG,UAAU,MAAM;EAC/B,UAAU,KAAK,GAAG,UAAU,SAAS;CACvC;CACA,OAAO;EAAE;EAAQ;CAAU;AAC7B;;;;;;;;AASA,eAAsB,yBAAyB,OAAmD;CAChG,MAAM,WAAW,sBAAsB,MAAM,SAAS,MAAM,aAAa;CACzE,IAAI,SAAS,QAAQ,WAAW,GAC9B,OAAO;EAAE,QAAQ,SAAS;EAAQ,WAAW,CAAC;CAAE;CAElD,MAAM,YAAY,IAAI,cAAc,MAAM,IAAI,MAAM,MAAM;CAI1D,MAAM,SAAS,gBAAgB,MAHN,QAAQ,IAC/B,SAAS,QAAQ,IAAI,OAAO,UAAU,MAAM,WAAW,WAAW,OAAO,KAAK,CAAC,CACjF,CACyC;CACzC,OAAO;EAAE,QAAQ,CAAC,GAAG,SAAS,QAAQ,GAAG,OAAO,MAAM;EAAG,WAAW,OAAO;CAAU;AACvF"}
+{"version":3,"file":"affected.mjs","names":[],"sources":["../../src/capture/affected.ts"],"sourcesContent":["import { selectAffectedStories } from \"@storyshelf/affected\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport { BaselineModel, type BaselineTables } from \"../models/baseline.ts\";\nimport { BuildModel } from \"../models/build.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { StoryEntry, Viewport } from \"./adapter.ts\";\nimport { resolveStoryViewports } from \"./storybook.ts\";\n\n/**\n * Resolve the affected import paths for a build, or `null` for full capture (affected capture\n * disabled, or no computation was posted). The one rule for the whole and the sharded path alike.\n */\nexport function affectedPathsFor(\n  build: Pick<Build, \"affectedOnly\" | \"affectedImportPaths\">,\n): string[] | null {\n  return build.affectedOnly ? BuildModel.affectedPaths(build) : null;\n}\n\n/** An inherit candidate paired with the baseline it reuses. */\nexport interface InheritedStory {\n  story: StoryEntry;\n  viewport: Viewport;\n  baseline: Baseline;\n  /** Engine whose baseline is reused (chromium when absent). */\n  browser?: string;\n}\n\n/** Stories split into capture-now versus inherit-from-baseline sets. */\nexport interface AffectedPartition {\n  render: StoryEntry[];\n  inherited: InheritedStory[];\n}\n\n/** Inputs for partitioning a build's stories by affected status. */\nexport interface PartitionInput {\n  db: DatabaseAdapter;\n  tables: BaselineTables;\n  projectId: string;\n  branch: string;\n  defaultBranch: string;\n  stories: StoryEntry[];\n  viewports: Viewport[];\n  /** Engine to resolve baselines for (default chromium). */\n  browser?: string;\n  /** Affected import paths, or `null` to render everything. */\n  affectedPaths: string[] | null;\n}\n\n/** Split one inherit candidate by per-viewport baseline availability. */\nasync function splitStory(\n  baselines: BaselineModel,\n  input: PartitionInput,\n  story: StoryEntry,\n): Promise<AffectedPartition> {\n  const render: StoryEntry[] = [];\n  const inherited: InheritedStory[] = [];\n  const viewports = resolveStoryViewports(story, input.viewports);\n  const settled = await Promise.all(\n    viewports.map(async (viewport) => ({\n      viewport,\n      baseline: await baselines.resolve(\n        input.projectId,\n        story.id,\n        viewport.name,\n        input.branch,\n        input.defaultBranch,\n        input.browser,\n      ),\n    })),\n  );\n  for (const { viewport, baseline } of settled) {\n    if (baseline) {\n      inherited.push({\n        story,\n        viewport,\n        baseline,\n        ...(input.browser ? { browser: input.browser } : {}),\n      });\n    } else if (!render.includes(story)) {\n      render.push(story);\n    }\n  }\n  return { render, inherited };\n}\n\n/** Merge per-story partitions into a single render/inherit split. */\nfunction mergePartitions(partitions: AffectedPartition[]): AffectedPartition {\n  const render: StoryEntry[] = [];\n  const inherited: InheritedStory[] = [];\n  for (const partition of partitions) {\n    render.push(...partition.render);\n    inherited.push(...partition.inherited);\n  }\n  return { render, inherited };\n}\n\n/**\n * Partition discovered stories into render versus inherit sets.\n *\n * Stories outside the affected set inherit their baseline without rendering,\n * except when no baseline exists (new stories always render). A `null`\n * affected set renders everything.\n */\nexport async function partitionAffectedStories(input: PartitionInput): Promise<AffectedPartition> {\n  const selected = selectAffectedStories(input.stories, input.affectedPaths);\n  if (selected.inherit.length === 0) {\n    return { render: selected.render, inherited: [] };\n  }\n  const baselines = new BaselineModel(input.db, input.tables);\n  const partitions = await Promise.all(\n    selected.inherit.map(async (story) => await splitStory(baselines, input, story)),\n  );\n  const merged = mergePartitions(partitions);\n  return { render: [...selected.render, ...merged.render], inherited: merged.inherited };\n}\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,iBACd,OACiB;CACjB,OAAO,MAAM,eAAe,WAAW,cAAc,KAAK,IAAI;AAChE;;AAiCA,eAAe,WACb,WACA,OACA,OAC4B;CAC5B,MAAM,SAAuB,CAAC;CAC9B,MAAM,YAA8B,CAAC;CACrC,MAAM,YAAY,sBAAsB,OAAO,MAAM,SAAS;CAC9D,MAAM,UAAU,MAAM,QAAQ,IAC5B,UAAU,IAAI,OAAO,cAAc;EACjC;EACA,UAAU,MAAM,UAAU,QACxB,MAAM,WACN,MAAM,IACN,SAAS,MACT,MAAM,QACN,MAAM,eACN,MAAM,OACR;CACF,EAAE,CACJ;CACA,KAAK,MAAM,EAAE,UAAU,cAAc,SACnC,IAAI,UACF,UAAU,KAAK;EACb;EACA;EACA;EACA,GAAI,MAAM,UAAU,EAAE,SAAS,MAAM,QAAQ,IAAI,CAAC;CACpD,CAAC;MACI,IAAI,CAAC,OAAO,SAAS,KAAK,GAC/B,OAAO,KAAK,KAAK;CAGrB,OAAO;EAAE;EAAQ;CAAU;AAC7B;;AAGA,SAAS,gBAAgB,YAAoD;CAC3E,MAAM,SAAuB,CAAC;CAC9B,MAAM,YAA8B,CAAC;CACrC,KAAK,MAAM,aAAa,YAAY;EAClC,OAAO,KAAK,GAAG,UAAU,MAAM;EAC/B,UAAU,KAAK,GAAG,UAAU,SAAS;CACvC;CACA,OAAO;EAAE;EAAQ;CAAU;AAC7B;;;;;;;;AASA,eAAsB,yBAAyB,OAAmD;CAChG,MAAM,WAAW,sBAAsB,MAAM,SAAS,MAAM,aAAa;CACzE,IAAI,SAAS,QAAQ,WAAW,GAC9B,OAAO;EAAE,QAAQ,SAAS;EAAQ,WAAW,CAAC;CAAE;CAElD,MAAM,YAAY,IAAI,cAAc,MAAM,IAAI,MAAM,MAAM;CAI1D,MAAM,SAAS,gBAAgB,MAHN,QAAQ,IAC/B,SAAS,QAAQ,IAAI,OAAO,UAAU,MAAM,WAAW,WAAW,OAAO,KAAK,CAAC,CACjF,CACyC;CACzC,OAAO;EAAE,QAAQ,CAAC,GAAG,SAAS,QAAQ,GAAG,OAAO,MAAM;EAAG,WAAW,OAAO;CAAU;AACvF"}

package/dist/capture/attempt-logger.mjs

@@ -0,0 +1,84 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { redactSecrets } from "../utils/redact.mjs";
+import { emitAttemptLog } from "../models/capture-attempt.mjs";
+//#region src/capture/attempt-logger.ts
+/** Longest error text recorded on an attempt-log line. */
+const ERROR_TEXT_MAX = 500;
+/** Mirrored levels; `debug` stays in pino only so attempt logs keep the signal. */
+const MIRRORED_LEVELS = [
+	"info",
+	"warn",
+	"error"
+];
+/**
+* Mirror a logger's `info`/`warn`/`error` lines onto the attempt log.
+*
+* Writes go through one promise chain: `capture_logs` numbers lines with a
+* read-then-insert, so concurrent appends (parallel pages failing at once)
+* would collide on `seq`. With no recorder the logger is returned unchanged.
+*/
+function mirrorAttemptLog(logger, record, levelFor = (level) => level) {
+	let chain = Promise.resolve();
+	const enqueue = (level, message, fields) => {
+		if (!record) return;
+		const recorded = levelFor(level, fields);
+		chain = chain.then(async () => {
+			await emitAttemptLog(record, logger, recorded, message, fields);
+		});
+	};
+	const base = logger ?? silentLogger();
+	return {
+		logger: new Proxy(base, { get(target, property, receiver) {
+			const level = MIRRORED_LEVELS.find((name) => name === property);
+			if (!level) return Reflect.get(target, property, receiver);
+			return (first, second, ...rest) => {
+				const args = [
+					first,
+					second,
+					...rest
+				];
+				while (args.length > 1 && args.at(-1) === void 0) args.pop();
+				Reflect.apply(target[level], target, args);
+				const [fields, message] = parseArgs(first, second);
+				enqueue(level, message, fields);
+			};
+		} }),
+		log: (level, message, fields) => {
+			base[level](fields ?? {}, message);
+			enqueue(level, message, fields === void 0 ? void 0 : plainFields(fields));
+		},
+		flush: async () => {
+			await chain;
+		}
+	};
+}
+/** pino call shapes: `(fields, message)` or `(message)`. */
+function parseArgs(first, second) {
+	if (typeof first === "string") return [void 0, first];
+	return [first && typeof first === "object" ? plainFields(first) : void 0, typeof second === "string" ? second : ""];
+}
+/** JSON-safe copy: an `Error` under `err` becomes its capped message. */
+function plainFields(fields) {
+	const copy = { ...fields };
+	const err = copy["err"];
+	if (err instanceof Error) copy["err"] = redactSecrets(err.message).slice(0, ERROR_TEXT_MAX);
+	return copy;
+}
+function noop() {}
+/** Stand-in when no logger was configured, so callers can log unconditionally. */
+function silentLogger() {
+	const stub = {
+		info: noop,
+		warn: noop,
+		error: noop,
+		debug: noop
+	};
+	stub["child"] = () => stub;
+	return stub;
+}
+//#endregion
+export { mirrorAttemptLog };
+
+//# sourceMappingURL=attempt-logger.mjs.map

package/dist/capture/attempt-logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt-logger.mjs","names":[],"sources":["../../src/capture/attempt-logger.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport { emitAttemptLog, type AttemptLogRecorder } from \"../models/capture-attempt.ts\";\nimport type { CaptureLogLevel } from \"../schema/capture-attempt.ts\";\nimport { redactSecrets } from \"../utils/redact.ts\";\n\n/** Longest error text recorded on an attempt-log line. */\nconst ERROR_TEXT_MAX = 500;\n\n/** Mirrored levels; `debug` stays in pino only so attempt logs keep the signal. */\nconst MIRRORED_LEVELS = [\"info\", \"warn\", \"error\"] as const;\n\n/** A logger that also records `info`/`warn`/`error` lines on the build attempt. */\nexport interface AttemptMirror {\n  /** Logger to hand to a runner: same as the original, plus attempt-log recording. */\n  logger: Logger;\n  /** Record one line on the attempt (and in pino); serialized with the mirrored lines. */\n  log(level: CaptureLogLevel, message: string, fields?: Record<string, unknown>): void;\n  /** Wait for every recorded line to be written. */\n  flush(): Promise<void>;\n}\n\n/**\n * Mirror a logger's `info`/`warn`/`error` lines onto the attempt log.\n *\n * Writes go through one promise chain: `capture_logs` numbers lines with a\n * read-then-insert, so concurrent appends (parallel pages failing at once)\n * would collide on `seq`. With no recorder the logger is returned unchanged.\n */\nexport function mirrorAttemptLog(\n  logger: Logger | undefined,\n  record: AttemptLogRecorder | undefined,\n  /** Optionally re-level a recorded line (pino keeps the original level). */\n  levelFor: (level: CaptureLogLevel, fields?: Record<string, unknown>) => CaptureLogLevel = (\n    level,\n  ) => level,\n): AttemptMirror {\n  let chain: Promise<void> = Promise.resolve();\n  const enqueue = (level: CaptureLogLevel, message: string, fields?: unknown): void => {\n    if (!record) return;\n    const recorded = levelFor(level, fields as Record<string, unknown> | undefined);\n    chain = chain.then(async () => {\n      await emitAttemptLog(record, logger, recorded, message, fields);\n    });\n  };\n  const base = logger ?? silentLogger();\n  const mirrored = new Proxy(base, {\n    get(target, property, receiver): unknown {\n      const level = MIRRORED_LEVELS.find((name) => name === property);\n      if (!level) return Reflect.get(target, property, receiver);\n      return (first: unknown, second?: unknown, ...rest: unknown[]): void => {\n        const args = [first, second, ...rest];\n        while (args.length > 1 && args.at(-1) === undefined) args.pop();\n        Reflect.apply(target[level], target, args);\n        const [fields, message] = parseArgs(first, second);\n        enqueue(level, message, fields);\n      };\n    },\n  });\n  return {\n    logger: mirrored,\n    log: (level, message, fields) => {\n      base[level](fields ?? {}, message);\n      enqueue(level, message, fields === undefined ? undefined : plainFields(fields));\n    },\n    flush: async () => {\n      await chain;\n    },\n  };\n}\n\n/** pino call shapes: `(fields, message)` or `(message)`. */\nfunction parseArgs(first: unknown, second: unknown): [Record<string, unknown> | undefined, string] {\n  if (typeof first === \"string\") return [undefined, first];\n  const fields = first && typeof first === \"object\" ? plainFields(first) : undefined;\n  return [fields, typeof second === \"string\" ? second : \"\"];\n}\n\n/** JSON-safe copy: an `Error` under `err` becomes its capped message. */\nfunction plainFields(fields: object): Record<string, unknown> {\n  const copy: Record<string, unknown> = { ...fields };\n  const err = copy[\"err\"];\n  if (err instanceof Error) copy[\"err\"] = redactSecrets(err.message).slice(0, ERROR_TEXT_MAX);\n  return copy;\n}\n\nfunction noop(): void {}\n\n/** Stand-in when no logger was configured, so callers can log unconditionally. */\nfunction silentLogger(): Logger {\n  const stub: Record<string, unknown> = { info: noop, warn: noop, error: noop, debug: noop };\n  stub[\"child\"] = (): unknown => stub;\n  return stub as unknown as Logger;\n}\n"],"mappings":";;;;;;;AAMA,MAAM,iBAAiB;;AAGvB,MAAM,kBAAkB;CAAC;CAAQ;CAAQ;AAAO;;;;;;;;AAmBhD,SAAgB,iBACd,QACA,QAEA,YACE,UACG,OACU;CACf,IAAI,QAAuB,QAAQ,QAAQ;CAC3C,MAAM,WAAW,OAAwB,SAAiB,WAA2B;EACnF,IAAI,CAAC,QAAQ;EACb,MAAM,WAAW,SAAS,OAAO,MAA6C;EAC9E,QAAQ,MAAM,KAAK,YAAY;GAC7B,MAAM,eAAe,QAAQ,QAAQ,UAAU,SAAS,MAAM;EAChE,CAAC;CACH;CACA,MAAM,OAAO,UAAU,aAAa;CAcpC,OAAO;EACL,QAAQ,IAdW,MAAM,MAAM,EAC/B,IAAI,QAAQ,UAAU,UAAmB;GACvC,MAAM,QAAQ,gBAAgB,MAAM,SAAS,SAAS,QAAQ;GAC9D,IAAI,CAAC,OAAO,OAAO,QAAQ,IAAI,QAAQ,UAAU,QAAQ;GACzD,QAAQ,OAAgB,QAAkB,GAAG,SAA0B;IACrE,MAAM,OAAO;KAAC;KAAO;KAAQ,GAAG;IAAI;IACpC,OAAO,KAAK,SAAS,KAAK,KAAK,GAAG,EAAE,MAAM,KAAA,GAAW,KAAK,IAAI;IAC9D,QAAQ,MAAM,OAAO,QAAQ,QAAQ,IAAI;IACzC,MAAM,CAAC,QAAQ,WAAW,UAAU,OAAO,MAAM;IACjD,QAAQ,OAAO,SAAS,MAAM;GAChC;EACF,EACF,CAEiB;EACf,MAAM,OAAO,SAAS,WAAW;GAC/B,KAAK,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO;GACjC,QAAQ,OAAO,SAAS,WAAW,KAAA,IAAY,KAAA,IAAY,YAAY,MAAM,CAAC;EAChF;EACA,OAAO,YAAY;GACjB,MAAM;EACR;CACF;AACF;;AAGA,SAAS,UAAU,OAAgB,QAAgE;CACjG,IAAI,OAAO,UAAU,UAAU,OAAO,CAAC,KAAA,GAAW,KAAK;CAEvD,OAAO,CADQ,SAAS,OAAO,UAAU,WAAW,YAAY,KAAK,IAAI,KAAA,GACzD,OAAO,WAAW,WAAW,SAAS,EAAE;AAC1D;;AAGA,SAAS,YAAY,QAAyC;CAC5D,MAAM,OAAgC,EAAE,GAAG,OAAO;CAClD,MAAM,MAAM,KAAK;CACjB,IAAI,eAAe,OAAO,KAAK,SAAS,cAAc,IAAI,OAAO,CAAC,CAAC,MAAM,GAAG,cAAc;CAC1F,OAAO;AACT;AAEA,SAAS,OAAa,CAAC;;AAGvB,SAAS,eAAuB;CAC9B,MAAM,OAAgC;EAAE,MAAM;EAAM,MAAM;EAAM,OAAO;EAAM,OAAO;CAAK;CACzF,KAAK,iBAA0B;CAC/B,OAAO;AACT"}

package/dist/capture/browsers.d.mts

@@ -0,0 +1,35 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { CaptureTarget, RunnerTarget } from "../adapters/capture-target.mjs";
+//#region src/capture/browsers.d.ts
+/** Upper bound on targets per project (each multiplies render time). */
+declare const MAX_BROWSERS = 3;
+/** Parse the project's JSON `browsers` column; `null` when unset or malformed. */
+declare function parseBrowsers(raw: string | null | undefined): CaptureTarget[] | null;
+/**
+ * Targets to capture, primary first: the project's `browsers` list, else its single `browser`.
+ * Throws when the list exceeds {@link MAX_BROWSERS}.
+ */
+declare function resolveBrowsers(project: {
+  browser?: string | undefined;
+  browsers?: string | null | undefined;
+}): CaptureTarget[];
+/**
+ * The primary target of a resolved target list: its first entry. The single owner of "primary":
+ * axe runs only here (ADR 0004, decision 6), so one story is not checked once per target.
+ */
+declare function primaryTargetOf(targets: readonly CaptureTarget[]): CaptureTarget | undefined;
+/** Throw when more than {@link MAX_BROWSERS} targets are requested. */
+declare function assertBrowserCount(browsers: readonly string[]): void;
+/**
+ * Why `target` cannot render on a runner offering `offered`: it is not on the list, or it is and is
+ * unavailable. `null` when it can, and always when the runner publishes no list.
+ */
+declare function refusalFor(target: CaptureTarget, offered?: readonly RunnerTarget[]): string | null;
+/** The targets of `offered`, for messages; `none` for an empty list. */
+declare function listTargets(offered: readonly RunnerTarget[]): string;
+/** Throw, naming every refusal, when the runner cannot render one of `targets`. */
+declare function assertSupportedBrowsers(targets: readonly CaptureTarget[], offered?: readonly RunnerTarget[]): void;
+//#endregion
+export { MAX_BROWSERS, assertBrowserCount, assertSupportedBrowsers, listTargets, parseBrowsers, primaryTargetOf, refusalFor, resolveBrowsers };
+//# sourceMappingURL=browsers.d.mts.map

package/dist/capture/browsers.mjs

@@ -0,0 +1,67 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { DEFAULT_BROWSER, isCaptureTarget, unavailableReason } from "../adapters/capture-target.mjs";
+//#region src/capture/browsers.ts
+/** Which capture targets a project renders on, and the guards around that list (ADR 0007). */
+/** Upper bound on targets per project (each multiplies render time). */
+const MAX_BROWSERS = 3;
+/** Parse the project's JSON `browsers` column; `null` when unset or malformed. */
+function parseBrowsers(raw) {
+	if (!raw) return null;
+	try {
+		const parsed = JSON.parse(raw);
+		return Array.isArray(parsed) && parsed.every((entry) => isCaptureTarget(entry)) ? dedupe(parsed) : null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Targets to capture, primary first: the project's `browsers` list, else its single `browser`.
+* Throws when the list exceeds {@link MAX_BROWSERS}.
+*/
+function resolveBrowsers(project) {
+	const listed = parseBrowsers(project.browsers);
+	const single = isCaptureTarget(project.browser) ? project.browser : DEFAULT_BROWSER;
+	const browsers = listed && listed.length > 0 ? listed : [single];
+	assertBrowserCount(browsers);
+	return browsers;
+}
+/**
+* The primary target of a resolved target list: its first entry. The single owner of "primary":
+* axe runs only here (ADR 0004, decision 6), so one story is not checked once per target.
+*/
+function primaryTargetOf(targets) {
+	return targets[0];
+}
+/** Throw when more than {@link MAX_BROWSERS} targets are requested. */
+function assertBrowserCount(browsers) {
+	if (browsers.length > 3) throw new Error(`At most 3 browsers are supported (got ${browsers.length})`);
+}
+/**
+* Why `target` cannot render on a runner offering `offered`: it is not on the list, or it is and is
+* unavailable. `null` when it can, and always when the runner publishes no list.
+*/
+function refusalFor(target, offered) {
+	if (offered === void 0) return null;
+	const entry = offered.find((candidate) => candidate.target === target);
+	if (entry === void 0) return `${target} is not offered by this capture runner (offered: ${listTargets(offered)})`;
+	const reason = unavailableReason(entry.status);
+	return reason === null ? null : `${target} is unavailable: ${reason}`;
+}
+/** The targets of `offered`, for messages; `none` for an empty list. */
+function listTargets(offered) {
+	return offered.length > 0 ? offered.map((entry) => entry.target).join(", ") : "none";
+}
+/** Throw, naming every refusal, when the runner cannot render one of `targets`. */
+function assertSupportedBrowsers(targets, offered) {
+	const refusals = targets.flatMap((target) => refusalFor(target, offered) ?? []);
+	if (refusals.length > 0) throw new Error(`Capture runner cannot render: ${refusals.join("; ")}`);
+}
+function dedupe(browsers) {
+	return [...new Set(browsers)];
+}
+//#endregion
+export { MAX_BROWSERS, assertBrowserCount, assertSupportedBrowsers, listTargets, parseBrowsers, primaryTargetOf, refusalFor, resolveBrowsers };
+
+//# sourceMappingURL=browsers.mjs.map

package/dist/capture/browsers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"browsers.mjs","names":[],"sources":["../../src/capture/browsers.ts"],"sourcesContent":["/** Which capture targets a project renders on, and the guards around that list (ADR 0007). */\nimport {\n  DEFAULT_BROWSER,\n  isCaptureTarget,\n  unavailableReason,\n  type CaptureTarget,\n  type RunnerTarget,\n} from \"../adapters/capture-target.ts\";\n\n/** Upper bound on targets per project (each multiplies render time). */\nexport const MAX_BROWSERS = 3;\n\n/** Parse the project's JSON `browsers` column; `null` when unset or malformed. */\nexport function parseBrowsers(raw: string | null | undefined): CaptureTarget[] | null {\n  if (!raw) return null;\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    return Array.isArray(parsed) && parsed.every((entry) => isCaptureTarget(entry))\n      ? dedupe(parsed)\n      : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Targets to capture, primary first: the project's `browsers` list, else its single `browser`.\n * Throws when the list exceeds {@link MAX_BROWSERS}.\n */\nexport function resolveBrowsers(project: {\n  browser?: string | undefined;\n  browsers?: string | null | undefined;\n}): CaptureTarget[] {\n  const listed = parseBrowsers(project.browsers);\n  const single = isCaptureTarget(project.browser) ? project.browser : DEFAULT_BROWSER;\n  const browsers = listed && listed.length > 0 ? listed : [single];\n  assertBrowserCount(browsers);\n  return browsers;\n}\n\n/**\n * The primary target of a resolved target list: its first entry. The single owner of \"primary\":\n * axe runs only here (ADR 0004, decision 6), so one story is not checked once per target.\n */\nexport function primaryTargetOf(targets: readonly CaptureTarget[]): CaptureTarget | undefined {\n  return targets[0];\n}\n\n/** Throw when more than {@link MAX_BROWSERS} targets are requested. */\nexport function assertBrowserCount(browsers: readonly string[]): void {\n  if (browsers.length > MAX_BROWSERS) {\n    throw new Error(`At most ${MAX_BROWSERS} browsers are supported (got ${browsers.length})`);\n  }\n}\n\n/**\n * Why `target` cannot render on a runner offering `offered`: it is not on the list, or it is and is\n * unavailable. `null` when it can, and always when the runner publishes no list.\n */\nexport function refusalFor(\n  target: CaptureTarget,\n  offered?: readonly RunnerTarget[],\n): string | null {\n  if (offered === undefined) {\n    return null;\n  }\n  const entry = offered.find((candidate) => candidate.target === target);\n  if (entry === undefined) {\n    return `${target} is not offered by this capture runner (offered: ${listTargets(offered)})`;\n  }\n  const reason = unavailableReason(entry.status);\n  return reason === null ? null : `${target} is unavailable: ${reason}`;\n}\n\n/** The targets of `offered`, for messages; `none` for an empty list. */\nexport function listTargets(offered: readonly RunnerTarget[]): string {\n  return offered.length > 0 ? offered.map((entry) => entry.target).join(\", \") : \"none\";\n}\n\n/** Throw, naming every refusal, when the runner cannot render one of `targets`. */\nexport function assertSupportedBrowsers(\n  targets: readonly CaptureTarget[],\n  offered?: readonly RunnerTarget[],\n): void {\n  const refusals = targets.flatMap((target) => refusalFor(target, offered) ?? []);\n  if (refusals.length > 0) {\n    throw new Error(`Capture runner cannot render: ${refusals.join(\"; \")}`);\n  }\n}\n\nfunction dedupe(browsers: CaptureTarget[]): CaptureTarget[] {\n  return [...new Set(browsers)];\n}\n"],"mappings":";;;;;;;AAUA,MAAa,eAAe;;AAG5B,SAAgB,cAAc,KAAwD;CACpF,IAAI,CAAC,KAAK,OAAO;CACjB,IAAI;EACF,MAAM,SAAkB,KAAK,MAAM,GAAG;EACtC,OAAO,MAAM,QAAQ,MAAM,KAAK,OAAO,OAAO,UAAU,gBAAgB,KAAK,CAAC,IAC1E,OAAO,MAAM,IACb;CACN,QAAQ;EACN,OAAO;CACT;AACF;;;;;AAMA,SAAgB,gBAAgB,SAGZ;CAClB,MAAM,SAAS,cAAc,QAAQ,QAAQ;CAC7C,MAAM,SAAS,gBAAgB,QAAQ,OAAO,IAAI,QAAQ,UAAU;CACpE,MAAM,WAAW,UAAU,OAAO,SAAS,IAAI,SAAS,CAAC,MAAM;CAC/D,mBAAmB,QAAQ;CAC3B,OAAO;AACT;;;;;AAMA,SAAgB,gBAAgB,SAA8D;CAC5F,OAAO,QAAQ;AACjB;;AAGA,SAAgB,mBAAmB,UAAmC;CACpE,IAAI,SAAS,SAAA,GACX,MAAM,IAAI,MAAM,yCAAuD,SAAS,OAAO,EAAE;AAE7F;;;;;AAMA,SAAgB,WACd,QACA,SACe;CACf,IAAI,YAAY,KAAA,GACd,OAAO;CAET,MAAM,QAAQ,QAAQ,MAAM,cAAc,UAAU,WAAW,MAAM;CACrE,IAAI,UAAU,KAAA,GACZ,OAAO,GAAG,OAAO,mDAAmD,YAAY,OAAO,EAAE;CAE3F,MAAM,SAAS,kBAAkB,MAAM,MAAM;CAC7C,OAAO,WAAW,OAAO,OAAO,GAAG,OAAO,mBAAmB;AAC/D;;AAGA,SAAgB,YAAY,SAA0C;CACpE,OAAO,QAAQ,SAAS,IAAI,QAAQ,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC,KAAK,IAAI,IAAI;AAChF;;AAGA,SAAgB,wBACd,SACA,SACM;CACN,MAAM,WAAW,QAAQ,SAAS,WAAW,WAAW,QAAQ,OAAO,KAAK,CAAC,CAAC;CAC9E,IAAI,SAAS,SAAS,GACpB,MAAM,IAAI,MAAM,iCAAiC,SAAS,KAAK,IAAI,GAAG;AAE1E;AAEA,SAAS,OAAO,UAA4C;CAC1D,OAAO,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC;AAC9B"}

package/dist/capture/build-state/deliver.d.mts

@@ -0,0 +1,32 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Build } from "../../schema/build.mjs";
+import { Project } from "../../schema/project.mjs";
+import { BuildStateDeps, SkipReason, StateTarget } from "./types.mjs";
+//#region src/capture/build-state/deliver.d.ts
+/**
+ * Show the build's current state on one channel. Throws when the host refuses a status, so the
+ * caller can retry; resolves to why nothing was written when the build or channel is gone.
+ */
+declare function deliverBuildState(deps: BuildStateDeps, ids: {
+  buildId: string;
+  channelId: string;
+}): Promise<"delivered" | SkipReason>;
+/** The build and its project, or null when either is gone. */
+declare function loadBuild(deps: BuildStateDeps, buildId: string): Promise<{
+  build: Build;
+  project: Project;
+} | null>;
+/** Write `target`'s view of the build, linking to `origin`; throws on a refused status. */
+declare function writeTo(deps: BuildStateDeps, loaded: {
+  build: Build;
+  project: Project;
+}, where: {
+  target: StateTarget;
+  origin: string;
+}): Promise<void>;
+/** The project's enabled channels with a wired `state` provider; unreadable secrets are logged and skipped. */
+declare function stateTargets(deps: BuildStateDeps, projectId: string): Promise<StateTarget[]>;
+//#endregion
+export { deliverBuildState, loadBuild, stateTargets, writeTo };
+//# sourceMappingURL=deliver.d.mts.map

package/dist/capture/build-state/deliver.mjs

@@ -0,0 +1,118 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { isStateProvider } from "../../adapters/notifier/provider.mjs";
+import { statusesForBuild } from "../../adapters/notifier/build-state.mjs";
+import { channelPrefix, writeBuildState } from "../../adapters/notifier/state.mjs";
+import { BuildModel } from "../../models/build.mjs";
+import { SnapshotModel } from "../../models/snapshot.mjs";
+import { ProjectModel } from "../../models/project.mjs";
+import { latestVerdicts } from "../../models/build-review-status.mjs";
+import { BuildReviewModel } from "../../models/build-review.mjs";
+import { NotificationChannelModel } from "../../models/notification-channel.mjs";
+import { createUrlBuilder } from "../../urls.mjs";
+import { publishingOf } from "../publish/published.mjs";
+//#region src/capture/build-state/deliver.ts
+/**
+* Delivering a build's state to git channels: read the build now, compute what each channel shows
+* ({@link statusesForBuild}), write it. Reading at delivery time is what makes a retried, delayed
+* or reordered request harmless (ADR 0014, decision 7).
+*/
+/**
+* Show the build's current state on one channel. Throws when the host refuses a status, so the
+* caller can retry; resolves to why nothing was written when the build or channel is gone.
+*/
+async function deliverBuildState(deps, ids) {
+	const loaded = await loadBuild(deps, ids.buildId);
+	const origin = loaded === null ? void 0 : await deps.publicOrigin();
+	if (loaded === null || !origin) return loaded === null ? "no-build" : "no-origin";
+	const target = await loadTarget(deps, ids.channelId, loaded.project.id);
+	if (typeof target === "string") return target;
+	await writeTo(deps, loaded, {
+		target,
+		origin
+	});
+	return "delivered";
+}
+/** The build and its project, or null when either is gone. */
+async function loadBuild(deps, buildId) {
+	const build = await new BuildModel(deps.db).get(buildId);
+	const project = build ? await new ProjectModel(deps.db).get(build.projectId) : null;
+	return build && project ? {
+		build,
+		project
+	} : null;
+}
+/** Write `target`'s view of the build, linking to `origin`; throws on a refused status. */
+async function writeTo(deps, loaded, where) {
+	const { build, project } = loaded;
+	const { target, origin } = where;
+	const states = statusesForBuild({
+		build,
+		projectSlug: project.slug,
+		prefix: channelPrefix(target.channel),
+		urls: createUrlBuilder(origin, deps.config.publishedBaseDomain),
+		flags: deps.flags(project),
+		publishing: await publishingOf(deps.storage, build),
+		approvals: await approvalsOf(deps, build, project),
+		changes: await changesOf(deps, build, project)
+	});
+	if (states.statuses.length === 0) {
+		deps.logger.info({ buildId: build.id }, "no commit to show a state on");
+		return;
+	}
+	await writeBuildState(target.provider, target.channel, {
+		sha: build.gitSha,
+		states,
+		logger: deps.logger
+	});
+}
+/** The project's enabled channels with a wired `state` provider; unreadable secrets are logged and skipped. */
+async function stateTargets(deps, projectId) {
+	const model = channelModel(deps);
+	return (await model.list(projectId)).flatMap((row) => {
+		const view = row.enabled ? model.toView(row) : null;
+		if (row.enabled && view === null) deps.logger.warn({
+			channelId: row.id,
+			provider: row.provider
+		}, "failed to decrypt channel secret");
+		return view === null ? [] : targetOf(deps, view);
+	});
+}
+/** One channel by id, or why it cannot take part. */
+async function loadTarget(deps, channelId, projectId) {
+	const model = channelModel(deps);
+	const row = await model.get(channelId);
+	if (row === null || row.projectId !== projectId) return "no-channel";
+	if (!row.enabled) return "disabled";
+	const view = model.toView(row);
+	if (view === null) throw new Error("channel secret cannot be decrypted with the configured keys");
+	return targetOf(deps, view)[0] ?? "no-provider";
+}
+function targetOf(deps, channel) {
+	const provider = deps.notifiers.find((candidate) => candidate.metadata.kind === channel.provider);
+	return provider !== void 0 && isStateProvider(provider) ? [{
+		channel,
+		provider
+	}] : [];
+}
+function channelModel(deps) {
+	return new NotificationChannelModel(deps.db, { notificationChannels: deps.db.tables.notificationChannels }, deps.secret);
+}
+/** Approval progress for `<prefix>/review`; only read when that status is the gate. */
+async function approvalsOf(deps, build, project) {
+	const flags = deps.flags(project);
+	if (flags.testing || !flags.review) return;
+	return {
+		given: latestVerdicts(await new BuildReviewModel(deps.db).listByBuild(build.id)).filter((review) => review.verdict === "approved").length,
+		required: Math.max(1, project.reviewApprovals ?? 1)
+	};
+}
+/** The build's snapshots for the annotations; read only when `testing` is on and something changed. */
+async function changesOf(deps, build, project) {
+	return deps.flags(project).testing && build.changedCount > 0 ? await new SnapshotModel(deps.db).listByBuild(build.id) : void 0;
+}
+//#endregion
+export { deliverBuildState, loadBuild, stateTargets, writeTo };
+
+//# sourceMappingURL=deliver.mjs.map

package/dist/capture/build-state/deliver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver.mjs","names":[],"sources":["../../../src/capture/build-state/deliver.ts"],"sourcesContent":["/**\n * Delivering a build's state to git channels: read the build now, compute what each channel shows\n * ({@link statusesForBuild}), write it. Reading at delivery time is what makes a retried, delayed\n * or reordered request harmless (ADR 0014, decision 7).\n */\nimport { channelPrefix, statusesForBuild, writeBuildState } from \"../../adapters/notifier/index.ts\";\nimport { isStateProvider } from \"../../adapters/notifier/provider.ts\";\nimport { latestVerdicts } from \"../../models/build-review-status.ts\";\nimport { BuildReviewModel } from \"../../models/build-review.ts\";\nimport { BuildModel } from \"../../models/build.ts\";\nimport { NotificationChannelModel } from \"../../models/notification-channel.ts\";\nimport { ProjectModel } from \"../../models/project.ts\";\nimport { SnapshotModel } from \"../../models/snapshot.ts\";\nimport type { Build } from \"../../schema/build.ts\";\nimport type { Project } from \"../../schema/project.ts\";\nimport type { Snapshot } from \"../../schema/snapshot.ts\";\nimport { createUrlBuilder } from \"../../urls.ts\";\nimport { publishingOf } from \"../publish/published.ts\";\nimport type { BuildStateDeps, SkipReason, StateTarget } from \"./types.ts\";\n\n/**\n * Show the build's current state on one channel. Throws when the host refuses a status, so the\n * caller can retry; resolves to why nothing was written when the build or channel is gone.\n */\nexport async function deliverBuildState(\n  deps: BuildStateDeps,\n  ids: { buildId: string; channelId: string },\n): Promise<\"delivered\" | SkipReason> {\n  const loaded = await loadBuild(deps, ids.buildId);\n  // The origin can disappear between queueing and running (a cleared setting): nothing is shown.\n  const origin = loaded === null ? undefined : await deps.publicOrigin();\n  if (loaded === null || !origin) {\n    return loaded === null ? \"no-build\" : \"no-origin\";\n  }\n  const target = await loadTarget(deps, ids.channelId, loaded.project.id);\n  if (typeof target === \"string\") {\n    return target;\n  }\n  await writeTo(deps, loaded, { target, origin });\n  return \"delivered\";\n}\n\n/** The build and its project, or null when either is gone. */\nexport async function loadBuild(\n  deps: BuildStateDeps,\n  buildId: string,\n): Promise<{ build: Build; project: Project } | null> {\n  const build = await new BuildModel(deps.db).get(buildId);\n  const project = build ? await new ProjectModel(deps.db).get(build.projectId) : null;\n  return build && project ? { build, project } : null;\n}\n\n/** Write `target`'s view of the build, linking to `origin`; throws on a refused status. */\nexport async function writeTo(\n  deps: BuildStateDeps,\n  loaded: { build: Build; project: Project },\n  where: { target: StateTarget; origin: string },\n): Promise<void> {\n  const { build, project } = loaded;\n  const { target, origin } = where;\n  const states = statusesForBuild({\n    build,\n    projectSlug: project.slug,\n    prefix: channelPrefix(target.channel),\n    urls: createUrlBuilder(origin, deps.config.publishedBaseDomain),\n    flags: deps.flags(project),\n    publishing: await publishingOf(deps.storage, build),\n    approvals: await approvalsOf(deps, build, project),\n    changes: await changesOf(deps, build, project),\n  });\n  if (states.statuses.length === 0) {\n    deps.logger.info({ buildId: build.id }, \"no commit to show a state on\");\n    return;\n  }\n  await writeBuildState(target.provider, target.channel, {\n    sha: build.gitSha,\n    states,\n    logger: deps.logger,\n  });\n}\n\n/** The project's enabled channels with a wired `state` provider; unreadable secrets are logged and skipped. */\nexport async function stateTargets(\n  deps: BuildStateDeps,\n  projectId: string,\n): Promise<StateTarget[]> {\n  const model = channelModel(deps);\n  const rows = await model.list(projectId);\n  return rows.flatMap((row) => {\n    const view = row.enabled ? model.toView(row) : null;\n    if (row.enabled && view === null) {\n      deps.logger.warn(\n        { channelId: row.id, provider: row.provider },\n        \"failed to decrypt channel secret\",\n      );\n    }\n    return view === null ? [] : targetOf(deps, view);\n  });\n}\n\n/** One channel by id, or why it cannot take part. */\nasync function loadTarget(\n  deps: BuildStateDeps,\n  channelId: string,\n  projectId: string,\n): Promise<StateTarget | Extract<SkipReason, \"no-channel\" | \"disabled\" | \"no-provider\">> {\n  const model = channelModel(deps);\n  const row = await model.get(channelId);\n  if (row === null || row.projectId !== projectId) {\n    return \"no-channel\";\n  }\n  if (!row.enabled) {\n    return \"disabled\";\n  }\n  const view = model.toView(row);\n  if (view === null) {\n    throw new Error(\"channel secret cannot be decrypted with the configured keys\");\n  }\n  return targetOf(deps, view)[0] ?? \"no-provider\";\n}\n\nfunction targetOf(deps: BuildStateDeps, channel: StateTarget[\"channel\"]): StateTarget[] {\n  const provider = deps.notifiers.find((candidate) => candidate.metadata.kind === channel.provider);\n  return provider !== undefined && isStateProvider(provider) ? [{ channel, provider }] : [];\n}\n\nfunction channelModel(deps: BuildStateDeps): NotificationChannelModel {\n  return new NotificationChannelModel(\n    deps.db,\n    { notificationChannels: deps.db.tables.notificationChannels },\n    deps.secret,\n  );\n}\n\n/** Approval progress for `<prefix>/review`; only read when that status is the gate. */\nasync function approvalsOf(\n  deps: BuildStateDeps,\n  build: Build,\n  project: Project,\n): Promise<{ given: number; required: number } | undefined> {\n  const flags = deps.flags(project);\n  if (flags.testing || !flags.review) {\n    return undefined;\n  }\n  const reviews = latestVerdicts(await new BuildReviewModel(deps.db).listByBuild(build.id));\n  return {\n    given: reviews.filter((review) => review.verdict === \"approved\").length,\n    required: Math.max(1, project.reviewApprovals ?? 1),\n  };\n}\n\n/** The build's snapshots for the annotations; read only when `testing` is on and something changed. */\nasync function changesOf(\n  deps: BuildStateDeps,\n  build: Build,\n  project: Project,\n): Promise<Snapshot[] | undefined> {\n  const wanted = deps.flags(project).testing && build.changedCount > 0;\n  return wanted ? await new SnapshotModel(deps.db).listByBuild(build.id) : undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAwBA,eAAsB,kBACpB,MACA,KACmC;CACnC,MAAM,SAAS,MAAM,UAAU,MAAM,IAAI,OAAO;CAEhD,MAAM,SAAS,WAAW,OAAO,KAAA,IAAY,MAAM,KAAK,aAAa;CACrE,IAAI,WAAW,QAAQ,CAAC,QACtB,OAAO,WAAW,OAAO,aAAa;CAExC,MAAM,SAAS,MAAM,WAAW,MAAM,IAAI,WAAW,OAAO,QAAQ,EAAE;CACtE,IAAI,OAAO,WAAW,UACpB,OAAO;CAET,MAAM,QAAQ,MAAM,QAAQ;EAAE;EAAQ;CAAO,CAAC;CAC9C,OAAO;AACT;;AAGA,eAAsB,UACpB,MACA,SACoD;CACpD,MAAM,QAAQ,MAAM,IAAI,WAAW,KAAK,EAAE,CAAC,CAAC,IAAI,OAAO;CACvD,MAAM,UAAU,QAAQ,MAAM,IAAI,aAAa,KAAK,EAAE,CAAC,CAAC,IAAI,MAAM,SAAS,IAAI;CAC/E,OAAO,SAAS,UAAU;EAAE;EAAO;CAAQ,IAAI;AACjD;;AAGA,eAAsB,QACpB,MACA,QACA,OACe;CACf,MAAM,EAAE,OAAO,YAAY;CAC3B,MAAM,EAAE,QAAQ,WAAW;CAC3B,MAAM,SAAS,iBAAiB;EAC9B;EACA,aAAa,QAAQ;EACrB,QAAQ,cAAc,OAAO,OAAO;EACpC,MAAM,iBAAiB,QAAQ,KAAK,OAAO,mBAAmB;EAC9D,OAAO,KAAK,MAAM,OAAO;EACzB,YAAY,MAAM,aAAa,KAAK,SAAS,KAAK;EAClD,WAAW,MAAM,YAAY,MAAM,OAAO,OAAO;EACjD,SAAS,MAAM,UAAU,MAAM,OAAO,OAAO;CAC/C,CAAC;CACD,IAAI,OAAO,SAAS,WAAW,GAAG;EAChC,KAAK,OAAO,KAAK,EAAE,SAAS,MAAM,GAAG,GAAG,8BAA8B;EACtE;CACF;CACA,MAAM,gBAAgB,OAAO,UAAU,OAAO,SAAS;EACrD,KAAK,MAAM;EACX;EACA,QAAQ,KAAK;CACf,CAAC;AACH;;AAGA,eAAsB,aACpB,MACA,WACwB;CACxB,MAAM,QAAQ,aAAa,IAAI;CAE/B,QAAO,MADY,MAAM,KAAK,SAAS,EAAA,CAC3B,SAAS,QAAQ;EAC3B,MAAM,OAAO,IAAI,UAAU,MAAM,OAAO,GAAG,IAAI;EAC/C,IAAI,IAAI,WAAW,SAAS,MAC1B,KAAK,OAAO,KACV;GAAE,WAAW,IAAI;GAAI,UAAU,IAAI;EAAS,GAC5C,kCACF;EAEF,OAAO,SAAS,OAAO,CAAC,IAAI,SAAS,MAAM,IAAI;CACjD,CAAC;AACH;;AAGA,eAAe,WACb,MACA,WACA,WACuF;CACvF,MAAM,QAAQ,aAAa,IAAI;CAC/B,MAAM,MAAM,MAAM,MAAM,IAAI,SAAS;CACrC,IAAI,QAAQ,QAAQ,IAAI,cAAc,WACpC,OAAO;CAET,IAAI,CAAC,IAAI,SACP,OAAO;CAET,MAAM,OAAO,MAAM,OAAO,GAAG;CAC7B,IAAI,SAAS,MACX,MAAM,IAAI,MAAM,6DAA6D;CAE/E,OAAO,SAAS,MAAM,IAAI,CAAC,CAAC,MAAM;AACpC;AAEA,SAAS,SAAS,MAAsB,SAAgD;CACtF,MAAM,WAAW,KAAK,UAAU,MAAM,cAAc,UAAU,SAAS,SAAS,QAAQ,QAAQ;CAChG,OAAO,aAAa,KAAA,KAAa,gBAAgB,QAAQ,IAAI,CAAC;EAAE;EAAS;CAAS,CAAC,IAAI,CAAC;AAC1F;AAEA,SAAS,aAAa,MAAgD;CACpE,OAAO,IAAI,yBACT,KAAK,IACL,EAAE,sBAAsB,KAAK,GAAG,OAAO,qBAAqB,GAC5D,KAAK,MACP;AACF;;AAGA,eAAe,YACb,MACA,OACA,SAC0D;CAC1D,MAAM,QAAQ,KAAK,MAAM,OAAO;CAChC,IAAI,MAAM,WAAW,CAAC,MAAM,QAC1B;CAGF,OAAO;EACL,OAFc,eAAe,MAAM,IAAI,iBAAiB,KAAK,EAAE,CAAC,CAAC,YAAY,MAAM,EAAE,CAExE,CAAC,CAAC,QAAQ,WAAW,OAAO,YAAY,UAAU,CAAC,CAAC;EACjE,UAAU,KAAK,IAAI,GAAG,QAAQ,mBAAmB,CAAC;CACpD;AACF;;AAGA,eAAe,UACb,MACA,OACA,SACiC;CAEjC,OADe,KAAK,MAAM,OAAO,CAAC,CAAC,WAAW,MAAM,eAAe,IACnD,MAAM,IAAI,cAAc,KAAK,EAAE,CAAC,CAAC,YAAY,MAAM,EAAE,IAAI,KAAA;AAC3E"}

package/dist/capture/build-state/index.d.mts

@@ -0,0 +1,8 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BuildStateDeps, BuildStatePublisher, SkipReason, StateTarget } from "./types.mjs";
+import { deliverBuildState, loadBuild, stateTargets, writeTo } from "./deliver.mjs";
+import { NOTIFY_BACKOFF, NOTIFY_MAX_ATTEMPTS, NotifyFailure, NotifyHandlerOptions, NotifyJobQueue, createNotifyEnqueuer, createNotifyHandler, notifyExhausted } from "./notify-job.mjs";
+import { BuildStatePublisherOptions, PAUSED_MESSAGE, createBuildStatePublisher } from "./publisher.mjs";
+import { requestOpenBuildStates } from "./resume.mjs";
+export { type BuildStateDeps, type BuildStatePublisher, type BuildStatePublisherOptions, NOTIFY_BACKOFF, NOTIFY_MAX_ATTEMPTS, type NotifyFailure, type NotifyHandlerOptions, type NotifyJobQueue, PAUSED_MESSAGE, type SkipReason, type StateTarget, createBuildStatePublisher, createNotifyEnqueuer, createNotifyHandler, deliverBuildState, loadBuild, notifyExhausted, requestOpenBuildStates, stateTargets, writeTo };