@storyshelf/core 0.3.2 → 0.5.4

package/dist/capture/rediff.d.mts

@@ -0,0 +1,35 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DatabaseAdapter } from "../adapter/database.mjs";
+import { StorageAdapter } from "../adapter/storage.mjs";
+import { Logger } from "../logger.mjs";
+import { Build } from "../schema/build.mjs";
+import { Project } from "../schema/project.mjs";
+//#region src/capture/rediff.d.ts
+/** Dependencies for {@link rediffBuild}. */
+interface RediffDeps {
+  db: DatabaseAdapter;
+  storage: StorageAdapter;
+  logger?: Logger;
+}
+/** Outcome of a re-diff run. */
+interface RediffResult {
+  /** Snapshots diffed against their current baseline. */
+  rediffed: number;
+  /** Snapshots whose status changed (for example `changed` to `unchanged`). */
+  statusChanged: number;
+  /** Snapshot ids skipped because their stored screenshot is gone. */
+  missingScreenshots: string[];
+}
+/** Build statuses a re-diff may run in; earlier or failed builds have no complete snapshot set. */
+declare const REDIFFABLE_BUILD_STATUSES: ReadonlySet<string>;
+/**
+ * Re-diff the build's undecided snapshots against the baselines that apply today.
+ *
+ * Approved and rejected snapshots are decisions and stay untouched; inherited snapshots were never
+ * rendered. The caller refreshes the build rollup afterwards.
+ */
+declare function rediffBuild(deps: RediffDeps, project: Project, build: Build): Promise<RediffResult>;
+//#endregion
+export { REDIFFABLE_BUILD_STATUSES, RediffDeps, RediffResult, rediffBuild };
+//# sourceMappingURL=rediff.d.mts.map

package/dist/capture/rediff.mjs

@@ -0,0 +1,77 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { diffPath } from "../paths.mjs";
+import { BaselineModel } from "../models/baseline.mjs";
+import { NO_BASELINE } from "../models/baseline-status.mjs";
+import { SnapshotModel } from "../models/snapshot.mjs";
+import { diffStoredScreenshots, writeDiffOverlay } from "./diff-record.mjs";
+import { diffStatus } from "./pipeline.mjs";
+//#region src/capture/rediff.ts
+/** Build statuses a re-diff may run in; earlier or failed builds have no complete snapshot set. */
+const REDIFFABLE_BUILD_STATUSES = /* @__PURE__ */ new Set([
+	"reviewing",
+	"approved",
+	"rejected"
+]);
+const REDIFFABLE_SNAPSHOT_STATUSES = /* @__PURE__ */ new Set([
+	"new",
+	"changed",
+	"unchanged"
+]);
+/**
+* Re-diff the build's undecided snapshots against the baselines that apply today.
+*
+* Approved and rejected snapshots are decisions and stay untouched; inherited snapshots were never
+* rendered. The caller refreshes the build rollup afterwards.
+*/
+async function rediffBuild(deps, project, build) {
+	const rows = (await new SnapshotModel(deps.db).listByBuild(build.id)).filter((row) => !row.inherited && REDIFFABLE_SNAPSHOT_STATUSES.has(row.status));
+	const outcomes = await Promise.all(rows.map(async (row) => await rediffSnapshot(deps, project, build, row)));
+	const result = {
+		rediffed: outcomes.filter((outcome) => outcome !== "missing").length,
+		statusChanged: outcomes.filter((outcome) => outcome === "changed").length,
+		missingScreenshots: rows.filter((_row, index) => outcomes[index] === "missing").map((row) => row.id)
+	};
+	deps.logger?.info({
+		buildId: build.id,
+		...result
+	}, "build re-diffed against current baselines");
+	return result;
+}
+async function rediffSnapshot(deps, project, build, row) {
+	if (!await deps.storage.exists(row.screenshotPath)) return "missing";
+	const baseline = await new BaselineModel(deps.db).resolve(project.id, row.storyId, row.viewportName, build.gitBranch, project.gitDefaultBranch);
+	const patch = baseline ? await diffPatch(deps, project, build, row, baseline) : noBaselinePatch();
+	await new SnapshotModel(deps.db).update(row.id, patch);
+	return patch.status === row.status ? "same" : "changed";
+}
+function noBaselinePatch() {
+	return {
+		status: "new",
+		diffPath: null,
+		diffPixels: null,
+		diffRatio: null,
+		diffPassed: null,
+		baselineId: null,
+		baselineVersion: NO_BASELINE
+	};
+}
+async function diffPatch(deps, project, build, row, baseline) {
+	const result = await diffStoredScreenshots(deps.storage, project, baseline.screenshotPath, row.screenshotPath);
+	const target = diffPath(project.id, build.id, row.storyId, row.viewportName);
+	const overlay = await writeDiffOverlay(deps.storage, target, result, result.passed);
+	return {
+		status: diffStatus(result.passed, false),
+		diffPath: overlay,
+		diffPixels: result.diffPixels,
+		diffRatio: result.diffRatio,
+		diffPassed: result.passed,
+		baselineId: baseline.id,
+		baselineVersion: baseline.updatedAt
+	};
+}
+//#endregion
+export { REDIFFABLE_BUILD_STATUSES, rediffBuild };
+
+//# sourceMappingURL=rediff.mjs.map

package/dist/capture/rediff.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rediff.mjs","names":[],"sources":["../../src/capture/rediff.ts"],"sourcesContent":["/** Recompute a build's diffs against the baselines that apply now, without re-rendering. */\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport type { Logger } from \"../logger.ts\";\nimport { NO_BASELINE } from \"../models/baseline-status.ts\";\nimport { BaselineModel } from \"../models/baseline.ts\";\nimport { SnapshotModel } from \"../models/snapshot.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport type { Snapshot } from \"../schema/snapshot.ts\";\nimport { diffPath } from \"../utils/paths.ts\";\nimport { diffStoredScreenshots, writeDiffOverlay } from \"./diff-record.ts\";\nimport { diffStatus } from \"./pipeline.ts\";\n\n/** Dependencies for {@link rediffBuild}. */\nexport interface RediffDeps {\n  db: DatabaseAdapter;\n  storage: StorageAdapter;\n  logger?: Logger;\n}\n\n/** Outcome of a re-diff run. */\nexport interface RediffResult {\n  /** Snapshots diffed against their current baseline. */\n  rediffed: number;\n  /** Snapshots whose status changed (for example `changed` to `unchanged`). */\n  statusChanged: number;\n  /** Snapshot ids skipped because their stored screenshot is gone. */\n  missingScreenshots: string[];\n}\n\n/** Build statuses a re-diff may run in; earlier or failed builds have no complete snapshot set. */\nexport const REDIFFABLE_BUILD_STATUSES: ReadonlySet<string> = new Set([\n  \"reviewing\",\n  \"approved\",\n  \"rejected\",\n]);\n\nconst REDIFFABLE_SNAPSHOT_STATUSES: ReadonlySet<string> = new Set([\"new\", \"changed\", \"unchanged\"]);\n\n/**\n * Re-diff the build's undecided snapshots against the baselines that apply today.\n *\n * Approved and rejected snapshots are decisions and stay untouched; inherited snapshots were never\n * rendered. The caller refreshes the build rollup afterwards.\n */\nexport async function rediffBuild(\n  deps: RediffDeps,\n  project: Project,\n  build: Build,\n): Promise<RediffResult> {\n  const snapshots = new SnapshotModel(deps.db);\n  const rows = (await snapshots.listByBuild(build.id)).filter(\n    (row) => !row.inherited && REDIFFABLE_SNAPSHOT_STATUSES.has(row.status),\n  );\n  const outcomes = await Promise.all(\n    rows.map(async (row) => await rediffSnapshot(deps, project, build, row)),\n  );\n  const result: RediffResult = {\n    rediffed: outcomes.filter((outcome) => outcome !== \"missing\").length,\n    statusChanged: outcomes.filter((outcome) => outcome === \"changed\").length,\n    missingScreenshots: rows\n      .filter((_row, index) => outcomes[index] === \"missing\")\n      .map((row) => row.id),\n  };\n  deps.logger?.info({ buildId: build.id, ...result }, \"build re-diffed against current baselines\");\n  return result;\n}\n\ntype Outcome = \"same\" | \"changed\" | \"missing\";\n\nasync function rediffSnapshot(\n  deps: RediffDeps,\n  project: Project,\n  build: Build,\n  row: Snapshot,\n): Promise<Outcome> {\n  if (!(await deps.storage.exists(row.screenshotPath))) {\n    return \"missing\";\n  }\n  const baseline = await new BaselineModel(deps.db).resolve(\n    project.id,\n    row.storyId,\n    row.viewportName,\n    build.gitBranch,\n    project.gitDefaultBranch,\n  );\n  const patch = baseline ? await diffPatch(deps, project, build, row, baseline) : noBaselinePatch();\n  await new SnapshotModel(deps.db).update(row.id, patch);\n  return patch.status === row.status ? \"same\" : \"changed\";\n}\n\nfunction noBaselinePatch(): Partial<Snapshot> {\n  return {\n    status: \"new\",\n    diffPath: null,\n    diffPixels: null,\n    diffRatio: null,\n    diffPassed: null,\n    baselineId: null,\n    baselineVersion: NO_BASELINE,\n  };\n}\n\nasync function diffPatch(\n  deps: RediffDeps,\n  project: Project,\n  build: Build,\n  row: Snapshot,\n  baseline: Baseline,\n): Promise<Partial<Snapshot>> {\n  const result = await diffStoredScreenshots(\n    deps.storage,\n    project,\n    baseline.screenshotPath,\n    row.screenshotPath,\n  );\n  const target = diffPath(project.id, build.id, row.storyId, row.viewportName);\n  const overlay = await writeDiffOverlay(deps.storage, target, result, result.passed);\n  return {\n    status: diffStatus(result.passed, false),\n    diffPath: overlay,\n    diffPixels: result.diffPixels,\n    diffRatio: result.diffRatio,\n    diffPassed: result.passed,\n    baselineId: baseline.id,\n    baselineVersion: baseline.updatedAt,\n  };\n}\n"],"mappings":";;;;;;;;;;;AAiCA,MAAa,4CAAiD,IAAI,IAAI;CACpE;CACA;CACA;AACF,CAAC;AAED,MAAM,+CAAoD,IAAI,IAAI;CAAC;CAAO;CAAW;AAAW,CAAC;;;;;;;AAQjG,eAAsB,YACpB,MACA,SACA,OACuB;CAEvB,MAAM,QAAQ,MAAM,IADE,cAAc,KAAK,EACb,CAAC,CAAC,YAAY,MAAM,EAAE,EAAA,CAAG,QAClD,QAAQ,CAAC,IAAI,aAAa,6BAA6B,IAAI,IAAI,MAAM,CACxE;CACA,MAAM,WAAW,MAAM,QAAQ,IAC7B,KAAK,IAAI,OAAO,QAAQ,MAAM,eAAe,MAAM,SAAS,OAAO,GAAG,CAAC,CACzE;CACA,MAAM,SAAuB;EAC3B,UAAU,SAAS,QAAQ,YAAY,YAAY,SAAS,CAAC,CAAC;EAC9D,eAAe,SAAS,QAAQ,YAAY,YAAY,SAAS,CAAC,CAAC;EACnE,oBAAoB,KACjB,QAAQ,MAAM,UAAU,SAAS,WAAW,SAAS,CAAC,CACtD,KAAK,QAAQ,IAAI,EAAE;CACxB;CACA,KAAK,QAAQ,KAAK;EAAE,SAAS,MAAM;EAAI,GAAG;CAAO,GAAG,2CAA2C;CAC/F,OAAO;AACT;AAIA,eAAe,eACb,MACA,SACA,OACA,KACkB;CAClB,IAAI,CAAE,MAAM,KAAK,QAAQ,OAAO,IAAI,cAAc,GAChD,OAAO;CAET,MAAM,WAAW,MAAM,IAAI,cAAc,KAAK,EAAE,CAAC,CAAC,QAChD,QAAQ,IACR,IAAI,SACJ,IAAI,cACJ,MAAM,WACN,QAAQ,gBACV;CACA,MAAM,QAAQ,WAAW,MAAM,UAAU,MAAM,SAAS,OAAO,KAAK,QAAQ,IAAI,gBAAgB;CAChG,MAAM,IAAI,cAAc,KAAK,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,KAAK;CACrD,OAAO,MAAM,WAAW,IAAI,SAAS,SAAS;AAChD;AAEA,SAAS,kBAAqC;CAC5C,OAAO;EACL,QAAQ;EACR,UAAU;EACV,YAAY;EACZ,WAAW;EACX,YAAY;EACZ,YAAY;EACZ,iBAAiB;CACnB;AACF;AAEA,eAAe,UACb,MACA,SACA,OACA,KACA,UAC4B;CAC5B,MAAM,SAAS,MAAM,sBACnB,KAAK,SACL,SACA,SAAS,gBACT,IAAI,cACN;CACA,MAAM,SAAS,SAAS,QAAQ,IAAI,MAAM,IAAI,IAAI,SAAS,IAAI,YAAY;CAC3E,MAAM,UAAU,MAAM,iBAAiB,KAAK,SAAS,QAAQ,QAAQ,OAAO,MAAM;CAClF,OAAO;EACL,QAAQ,WAAW,OAAO,QAAQ,KAAK;EACvC,UAAU;EACV,YAAY,OAAO;EACnB,WAAW,OAAO;EAClB,YAAY,OAAO;EACnB,YAAY,SAAS;EACrB,iBAAiB,SAAS;CAC5B;AACF"}

package/dist/capture/sizing.d.mts

@@ -0,0 +1,58 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Viewport } from "./adapter.mjs";
+//#region src/capture/sizing.d.ts
+/** Default min/max dimensions for cropped/fullPage screenshots (diff stability). */
+declare const SIZING_DEFAULTS: {
+  readonly minWidth: 100;
+  readonly minHeight: 100;
+  readonly maxWidth: 2000;
+  readonly maxHeight: 4000;
+  readonly whitespaceThreshold: 0.6;
+};
+/** Bounding box of #storybook-root as returned by Playwright/Puppeteer. */
+interface BoundingBox {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+/** Options for computing the screenshot plan. */
+interface SizingOptions {
+  /** Per-story override: false forces full viewport, true forces crop when possible. */
+  autoCrop?: boolean;
+  /** Whitespace fraction (0..1) above which we crop; default 0.6. */
+  whitespaceThreshold?: number;
+  /** Whether overflow should trigger fullPage; default true. */
+  fullPageOnOverflow?: boolean;
+  /** Min dimensions for the final PNG (clamp after padding). */
+  minWidth?: number;
+  minHeight?: number;
+  /** Max dimensions for the final PNG (clamp after padding). */
+  maxWidth?: number;
+  maxHeight?: number;
+}
+/** Result of the sizing decision — what the runner should do. */
+interface ScreenshotPlan {
+  /** Viewport to set on the page before capture. */
+  viewport: Viewport;
+  /** Clip to use for page.screenshot({clip}). Undefined means full viewport. */
+  clip?: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  };
+  /** Whether to use fullPage screenshot (for overflow). */
+  fullPage: boolean;
+}
+/**
+ * Compute the screenshot plan for a single story×viewport.
+ * Single prod owner for sizing logic — runners import this, never duplicate.
+ */
+declare function getScreenshotPlan(viewport: Viewport, box: BoundingBox | null, options?: SizingOptions): ScreenshotPlan;
+/** Resolve viewports from project/server config with fallback to default (not sizing, just list). */
+declare function resolveViewports(rawViewports: string | null | undefined, fallback: Viewport[], serverViewports?: Viewport[]): Viewport[];
+//#endregion
+export { BoundingBox, SIZING_DEFAULTS, ScreenshotPlan, SizingOptions, getScreenshotPlan, resolveViewports };
+//# sourceMappingURL=sizing.d.mts.map

package/dist/capture/sizing.mjs

@@ -0,0 +1,119 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { sha256 } from "../utils/hash.mjs";
+//#region src/capture/sizing.ts
+/** Padding around the cropped component (8px each side). */
+const PAD = 16;
+const HALF_PAD = 8;
+/** Default min/max dimensions for cropped/fullPage screenshots (diff stability). */
+const SIZING_DEFAULTS = {
+	minWidth: 100,
+	minHeight: 100,
+	maxWidth: 2e3,
+	maxHeight: 4e3,
+	whitespaceThreshold: .6
+};
+/** Clamp value between min and max. */
+function clamp(value, min, max) {
+	return Math.max(min, Math.min(max, value));
+}
+function isOverflowing(box, viewport) {
+	return box.width > viewport.width || box.height > viewport.height;
+}
+function whitespaceOf(box, viewport) {
+	const viewportArea = viewport.width * viewport.height;
+	const boxArea = box.width * box.height;
+	const coverage = viewportArea > 0 ? boxArea / viewportArea : 1;
+	return 1 - Math.min(coverage, 1);
+}
+function shouldCrop(box, viewport, opts, threshold) {
+	if (opts.autoCrop === true) return true;
+	return whitespaceOf(box, viewport) > threshold;
+}
+function paddedClip(box, minW, maxW, minH, maxH) {
+	const w = clamp(Math.ceil(box.width + PAD), minW, maxW);
+	const h = clamp(Math.ceil(box.height + PAD), minH, maxH);
+	return {
+		x: Math.max(0, box.x - HALF_PAD),
+		y: Math.max(0, box.y - HALF_PAD),
+		width: w,
+		height: h
+	};
+}
+/**
+* Compute the screenshot plan for a single story×viewport.
+* Single prod owner for sizing logic — runners import this, never duplicate.
+*/
+function getScreenshotPlan(viewport, box, options = {}) {
+	if (options.autoCrop === false) return {
+		viewport,
+		fullPage: false
+	};
+	if (!box) return {
+		viewport,
+		fullPage: false
+	};
+	if (isOverflowing(box, viewport) && (options.fullPageOnOverflow ?? true)) return {
+		viewport,
+		fullPage: true
+	};
+	if (isOverflowing(box, viewport)) return grownViewportPlan(viewport, box, options);
+	return maybeCroppedPlan(viewport, box, options);
+}
+function grownViewportPlan(viewport, box, options) {
+	const maxH = options.maxHeight ?? SIZING_DEFAULTS.maxHeight;
+	const grownHeight = clamp(Math.ceil(box.height + PAD), viewport.height, maxH);
+	return {
+		viewport: {
+			...viewport,
+			height: grownHeight
+		},
+		fullPage: false
+	};
+}
+function maybeCroppedPlan(viewport, box, options) {
+	if (!shouldCrop(box, viewport, options, options.whitespaceThreshold ?? SIZING_DEFAULTS.whitespaceThreshold)) return {
+		viewport,
+		fullPage: false
+	};
+	const minW = options.minWidth ?? SIZING_DEFAULTS.minWidth;
+	const minH = options.minHeight ?? SIZING_DEFAULTS.minHeight;
+	const clip = paddedClip(box, minW, options.maxWidth ?? SIZING_DEFAULTS.maxWidth, minH, options.maxHeight ?? SIZING_DEFAULTS.maxHeight);
+	return {
+		viewport,
+		clip: {
+			x: Math.round(clip.x),
+			y: Math.round(clip.y),
+			width: clip.width,
+			height: clip.height
+		},
+		fullPage: false
+	};
+}
+/** Resolve viewports from project/server config with fallback to default (not sizing, just list). */
+function resolveViewports(rawViewports, fallback, serverViewports) {
+	if (serverViewports && serverViewports.length > 0) return serverViewports;
+	if (rawViewports) return parsedViewports(rawViewports) ?? fallback;
+	return fallback;
+}
+function parsedViewports(raw) {
+	try {
+		const parsed = JSON.parse(raw);
+		if (Array.isArray(parsed) && parsed.length > 0) return parsed;
+	} catch {}
+	return null;
+}
+/** Hash infra determinism: browser + viewports + sizing defaults. */
+function infraHashFor(browser, viewports, defaults = SIZING_DEFAULTS) {
+	const payload = JSON.stringify({
+		browser,
+		viewports,
+		defaults
+	});
+	return sha256(payload);
+}
+//#endregion
+export { SIZING_DEFAULTS, getScreenshotPlan, infraHashFor, resolveViewports };
+
+//# sourceMappingURL=sizing.mjs.map

package/dist/capture/sizing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sizing.mjs","names":[],"sources":["../../src/capture/sizing.ts"],"sourcesContent":["import { sha256 } from \"../utils/hash.ts\";\nimport type { Viewport } from \"./adapter.ts\";\n\n/** Padding around the cropped component (8px each side). */\nconst PAD = 16;\nconst HALF_PAD = 8;\n\n/** Default min/max dimensions for cropped/fullPage screenshots (diff stability). */\nexport const SIZING_DEFAULTS = {\n  minWidth: 100,\n  minHeight: 100,\n  maxWidth: 2000,\n  maxHeight: 4000,\n  whitespaceThreshold: 0.6,\n} as const;\n\n/** Bounding box of #storybook-root as returned by Playwright/Puppeteer. */\nexport interface BoundingBox {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/** Options for computing the screenshot plan. */\nexport interface SizingOptions {\n  /** Per-story override: false forces full viewport, true forces crop when possible. */\n  autoCrop?: boolean;\n  /** Whitespace fraction (0..1) above which we crop; default 0.6. */\n  whitespaceThreshold?: 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  /** Max dimensions for the final PNG (clamp after padding). */\n  maxWidth?: number;\n  maxHeight?: number;\n}\n\n/** Result of the sizing decision — what the runner should do. */\nexport interface ScreenshotPlan {\n  /** Viewport to set on the page before capture. */\n  viewport: Viewport;\n  /** Clip to use for page.screenshot({clip}). Undefined means full viewport. */\n  clip?: { x: number; y: number; width: number; height: number };\n  /** Whether to use fullPage screenshot (for overflow). */\n  fullPage: boolean;\n}\n\n/** Clamp value between min and max. */\nfunction clamp(value: number, min: number, max: number): number {\n  return Math.max(min, Math.min(max, value));\n}\n\nfunction isOverflowing(box: BoundingBox, viewport: Viewport): boolean {\n  return box.width > viewport.width || box.height > viewport.height;\n}\n\nfunction whitespaceOf(box: BoundingBox, viewport: Viewport): number {\n  const viewportArea = viewport.width * viewport.height;\n  const boxArea = box.width * box.height;\n  const coverage = viewportArea > 0 ? boxArea / viewportArea : 1;\n  return 1 - Math.min(coverage, 1);\n}\n\nfunction shouldCrop(\n  box: BoundingBox,\n  viewport: Viewport,\n  opts: SizingOptions,\n  threshold: number,\n): boolean {\n  if (opts.autoCrop === true) return true;\n  return whitespaceOf(box, viewport) > threshold;\n}\n\nfunction paddedClip(\n  box: BoundingBox,\n  minW: number,\n  maxW: number,\n  minH: number,\n  maxH: number,\n): BoundingBox {\n  const w = clamp(Math.ceil(box.width + PAD), minW, maxW);\n  const h = clamp(Math.ceil(box.height + PAD), minH, maxH);\n  return {\n    x: Math.max(0, box.x - HALF_PAD),\n    y: Math.max(0, box.y - HALF_PAD),\n    width: w,\n    height: h,\n  };\n}\n\n/**\n * Compute the screenshot plan for a single story×viewport.\n * Single prod owner for sizing logic — runners import this, never duplicate.\n */\nexport function getScreenshotPlan(\n  viewport: Viewport,\n  box: BoundingBox | null,\n  options: SizingOptions = {},\n): ScreenshotPlan {\n  if (options.autoCrop === false) return { viewport, fullPage: false };\n  if (!box) return { viewport, fullPage: false };\n  if (isOverflowing(box, viewport) && (options.fullPageOnOverflow ?? true)) {\n    return { viewport, fullPage: true };\n  }\n  if (isOverflowing(box, viewport)) {\n    return grownViewportPlan(viewport, box, options);\n  }\n  return maybeCroppedPlan(viewport, box, options);\n}\n\nfunction grownViewportPlan(\n  viewport: Viewport,\n  box: BoundingBox,\n  options: SizingOptions,\n): ScreenshotPlan {\n  const maxH = options.maxHeight ?? SIZING_DEFAULTS.maxHeight;\n  const grownHeight = clamp(Math.ceil(box.height + PAD), viewport.height, maxH);\n  return { viewport: { ...viewport, height: grownHeight }, fullPage: false };\n}\n\nfunction maybeCroppedPlan(\n  viewport: Viewport,\n  box: BoundingBox,\n  options: SizingOptions,\n): ScreenshotPlan {\n  const threshold = options.whitespaceThreshold ?? SIZING_DEFAULTS.whitespaceThreshold;\n  if (!shouldCrop(box, viewport, options, threshold)) return { viewport, fullPage: false };\n  const minW = options.minWidth ?? SIZING_DEFAULTS.minWidth;\n  const minH = options.minHeight ?? SIZING_DEFAULTS.minHeight;\n  const maxW = options.maxWidth ?? SIZING_DEFAULTS.maxWidth;\n  const maxH = options.maxHeight ?? SIZING_DEFAULTS.maxHeight;\n  const clip = paddedClip(box, minW, maxW, minH, maxH);\n  return {\n    viewport,\n    clip: { x: Math.round(clip.x), y: Math.round(clip.y), width: clip.width, height: clip.height },\n    fullPage: false,\n  };\n}\n\n/** Resolve viewports from project/server config with fallback to default (not sizing, just list). */\nexport function resolveViewports(\n  rawViewports: string | null | undefined,\n  fallback: Viewport[],\n  serverViewports?: Viewport[],\n): Viewport[] {\n  if (serverViewports && serverViewports.length > 0) return serverViewports;\n  if (rawViewports) return parsedViewports(rawViewports) ?? fallback;\n  return fallback;\n}\n\nfunction parsedViewports(raw: string): Viewport[] | null {\n  try {\n    const parsed = JSON.parse(raw) as Viewport[];\n    if (Array.isArray(parsed) && parsed.length > 0) return parsed;\n  } catch {\n    // fallback\n  }\n  return null;\n}\n\n/** Hash infra determinism: browser + viewports + sizing defaults. */\nexport function infraHashFor(\n  browser: string,\n  viewports: Viewport[],\n  defaults: typeof SIZING_DEFAULTS = SIZING_DEFAULTS,\n): string {\n  const payload = JSON.stringify({ browser, viewports, defaults });\n  return sha256(payload);\n}\n"],"mappings":"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"}

package/dist/capture/skip-checks.mjs

@@ -5,8 +5,8 @@ import { BuildModel } from "../models/build.mjs";
 import { StatusConfigModel } from "../models/status-config.mjs";
 //#region src/capture/skip-checks.ts
 /** Skip capture when another approved build already covers the same commit. */
-async function hasApprovedBuildForSha(db, projectId, sha, excludeBuildId) {
-	return (await new BuildModel(db).list(projectId)).some((b) => b.gitSha === sha && b.id !== excludeBuildId && b.status === "approved");
+async function hasApprovedBuildForSha(db, tables, projectId, sha, excludeBuildId) {
+	return (await new BuildModel(db, tables).list(projectId)).some((b) => b.gitSha === sha && b.id !== excludeBuildId && b.status === "approved");
 }
 function findRowProvider(providers, row) {
 	return providers.find((p) => p.metadata.kind === row.provider);
@@ -65,7 +65,7 @@ async function checkRow(model, row, providers, sha, branch, logger) {
 /** True when any configured provider reports the commit already merged. */
 async function isAlreadyMerged(opts) {
 	if (opts.providers.length === 0) return false;
-	const model = new StatusConfigModel(opts.db, opts.secret);
+	const model = new StatusConfigModel(opts.db, opts.tables, opts.secret);
 	const rows = await model.list(opts.projectId);
 	for (const row of rows) if (await checkRow(model, row, opts.providers, opts.sha, opts.branch, opts.logger)) return true;
 	return false;

package/dist/capture/skip-checks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"skip-checks.mjs","names":[],"sources":["../../src/capture/skip-checks.ts"],"sourcesContent":["import type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { GitHostProvider } from \"../adapters/git-host/index.ts\";\nimport type { Logger } from \"../logger.ts\";\nimport { BuildModel } from \"../models/build.ts\";\nimport { StatusConfigModel } from \"../models/status-config.ts\";\nimport type { ProjectStatusConfig } from \"../schema/status-config.ts\";\n\n/** Skip capture when another approved build already covers the same commit. */\nexport async function hasApprovedBuildForSha(\n  db: DatabaseAdapter,\n  projectId: string,\n  sha: string,\n  excludeBuildId: string,\n): Promise<boolean> {\n  const builds = await new BuildModel(db).list(projectId);\n  return builds.some((b) => b.gitSha === sha && b.id !== excludeBuildId && b.status === \"approved\");\n}\n\n/** Inputs for checking whether a commit is already merged upstream. */\nexport interface MergeCheck {\n  providers: GitHostProvider[];\n  sha: string;\n  branch: string;\n  secret: string | undefined;\n  db: DatabaseAdapter;\n  projectId: string;\n  logger?: Logger;\n}\n\ninterface ParsedRow {\n  provider: GitHostProvider;\n  config: unknown;\n  token: string;\n}\n\nfunction findRowProvider(\n  providers: GitHostProvider[],\n  row: { provider: string },\n): GitHostProvider | undefined {\n  return providers.find((p) => p.metadata.kind === row.provider);\n}\n\nfunction decodeRowConfig(provider: GitHostProvider, configJson: string): unknown {\n  try {\n    const parsed: unknown = JSON.parse(configJson);\n    provider.metadata.schema.parse(parsed);\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nfunction decodeRowToken(model: StatusConfigModel, row: ProjectStatusConfig): string | null {\n  try {\n    return model.decryptToken(row);\n  } catch {\n    return null;\n  }\n}\n\nfunction parseRow(\n  model: StatusConfigModel,\n  row: ProjectStatusConfig,\n  providers: GitHostProvider[],\n): ParsedRow | null {\n  const provider = findRowProvider(providers, row);\n  if (!provider) {\n    return null;\n  }\n  const parsed = decodeRowConfig(provider, row.config);\n  if (parsed === null) {\n    return null;\n  }\n  const token = decodeRowToken(model, row);\n  if (token === null) {\n    return null;\n  }\n  return { provider, config: parsed, token };\n}\n\nasync function checkRowMerged(\n  parsed: ParsedRow,\n  sha: string,\n  branch: string,\n  logger?: Logger,\n): Promise<boolean> {\n  const adapter = parsed.provider.create({ config: parsed.config, token: parsed.token, logger });\n  if (!adapter.isMerged) {\n    return false;\n  }\n  try {\n    return await adapter.isMerged({ sha, branch });\n  } catch {\n    // Ignore provider errors — do not skip on failure\n    return false;\n  }\n}\n\n/** Check one status-config row for an upstream merge. */\nasync function checkRow(\n  model: StatusConfigModel,\n  row: ProjectStatusConfig,\n  providers: GitHostProvider[],\n  sha: string,\n  branch: string,\n  logger?: Logger,\n): Promise<boolean> {\n  const parsed = parseRow(model, row, providers);\n  if (!parsed) {\n    return false;\n  }\n  return await checkRowMerged(parsed, sha, branch, logger);\n}\n\n/** True when any configured provider reports the commit already merged. */\nexport async function isAlreadyMerged(opts: MergeCheck): Promise<boolean> {\n  if (opts.providers.length === 0) {\n    return false;\n  }\n  const model = new StatusConfigModel(opts.db, opts.secret);\n  const rows = await model.list(opts.projectId);\n  for (const row of rows) {\n    // eslint-disable-next-line no-await-in-loop -- short-circuit on first merged status\n    if (await checkRow(model, row, opts.providers, opts.sha, opts.branch, opts.logger)) {\n      return true;\n    }\n  }\n  return false;\n}\n"],"mappings":";;;;;;;AAQA,eAAsB,uBACpB,IACA,WACA,KACA,gBACkB;CAElB,QAAO,MADc,IAAI,WAAW,EAAE,CAAC,CAAC,KAAK,SAAS,EAAA,CACxC,MAAM,MAAM,EAAE,WAAW,OAAO,EAAE,OAAO,kBAAkB,EAAE,WAAW,UAAU;AAClG;AAmBA,SAAS,gBACP,WACA,KAC6B;CAC7B,OAAO,UAAU,MAAM,MAAM,EAAE,SAAS,SAAS,IAAI,QAAQ;AAC/D;AAEA,SAAS,gBAAgB,UAA2B,YAA6B;CAC/E,IAAI;EACF,MAAM,SAAkB,KAAK,MAAM,UAAU;EAC7C,SAAS,SAAS,OAAO,MAAM,MAAM;EACrC,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,eAAe,OAA0B,KAAyC;CACzF,IAAI;EACF,OAAO,MAAM,aAAa,GAAG;CAC/B,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,SACP,OACA,KACA,WACkB;CAClB,MAAM,WAAW,gBAAgB,WAAW,GAAG;CAC/C,IAAI,CAAC,UACH,OAAO;CAET,MAAM,SAAS,gBAAgB,UAAU,IAAI,MAAM;CACnD,IAAI,WAAW,MACb,OAAO;CAET,MAAM,QAAQ,eAAe,OAAO,GAAG;CACvC,IAAI,UAAU,MACZ,OAAO;CAET,OAAO;EAAE;EAAU,QAAQ;EAAQ;CAAM;AAC3C;AAEA,eAAe,eACb,QACA,KACA,QACA,QACkB;CAClB,MAAM,UAAU,OAAO,SAAS,OAAO;EAAE,QAAQ,OAAO;EAAQ,OAAO,OAAO;EAAO;CAAO,CAAC;CAC7F,IAAI,CAAC,QAAQ,UACX,OAAO;CAET,IAAI;EACF,OAAO,MAAM,QAAQ,SAAS;GAAE;GAAK;EAAO,CAAC;CAC/C,QAAQ;EAEN,OAAO;CACT;AACF;;AAGA,eAAe,SACb,OACA,KACA,WACA,KACA,QACA,QACkB;CAClB,MAAM,SAAS,SAAS,OAAO,KAAK,SAAS;CAC7C,IAAI,CAAC,QACH,OAAO;CAET,OAAO,MAAM,eAAe,QAAQ,KAAK,QAAQ,MAAM;AACzD;;AAGA,eAAsB,gBAAgB,MAAoC;CACxE,IAAI,KAAK,UAAU,WAAW,GAC5B,OAAO;CAET,MAAM,QAAQ,IAAI,kBAAkB,KAAK,IAAI,KAAK,MAAM;CACxD,MAAM,OAAO,MAAM,MAAM,KAAK,KAAK,SAAS;CAC5C,KAAK,MAAM,OAAO,MAEhB,IAAI,MAAM,SAAS,OAAO,KAAK,KAAK,WAAW,KAAK,KAAK,KAAK,QAAQ,KAAK,MAAM,GAC/E,OAAO;CAGX,OAAO;AACT"}
+{"version":3,"file":"skip-checks.mjs","names":[],"sources":["../../src/capture/skip-checks.ts"],"sourcesContent":["import type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { GitHostProvider } from \"../adapters/git-host/index.ts\";\nimport type { Logger } from \"../logger.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport { StatusConfigModel, type StatusConfigTables } from \"../models/status-config.ts\";\nimport type { ProjectStatusConfig } from \"../schema/status-config.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\n\n/** Skip capture when another approved build already covers the same commit. */\nexport async function hasApprovedBuildForSha(\n  db: DatabaseAdapter,\n  tables: BuildTables,\n  projectId: string,\n  sha: string,\n  excludeBuildId: string,\n): Promise<boolean> {\n  const builds = await new BuildModel(db, tables).list(projectId);\n  return builds.some((b) => b.gitSha === sha && b.id !== excludeBuildId && b.status === \"approved\");\n}\n\n/** Inputs for checking whether a commit is already merged upstream. */\nexport interface MergeCheck {\n  providers: GitHostProvider[];\n  sha: string;\n  branch: string;\n  secret: SecretInput;\n  db: DatabaseAdapter;\n  tables: StatusConfigTables;\n  projectId: string;\n  logger?: Logger;\n}\n\ninterface ParsedRow {\n  provider: GitHostProvider;\n  config: unknown;\n  token: string;\n}\n\nfunction findRowProvider(\n  providers: GitHostProvider[],\n  row: { provider: string },\n): GitHostProvider | undefined {\n  return providers.find((p) => p.metadata.kind === row.provider);\n}\n\nfunction decodeRowConfig(provider: GitHostProvider, configJson: string): unknown {\n  try {\n    const parsed: unknown = JSON.parse(configJson);\n    provider.metadata.schema.parse(parsed);\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nfunction decodeRowToken(model: StatusConfigModel, row: ProjectStatusConfig): string | null {\n  try {\n    return model.decryptToken(row);\n  } catch {\n    return null;\n  }\n}\n\nfunction parseRow(\n  model: StatusConfigModel,\n  row: ProjectStatusConfig,\n  providers: GitHostProvider[],\n): ParsedRow | null {\n  const provider = findRowProvider(providers, row);\n  if (!provider) {\n    return null;\n  }\n  const parsed = decodeRowConfig(provider, row.config);\n  if (parsed === null) {\n    return null;\n  }\n  const token = decodeRowToken(model, row);\n  if (token === null) {\n    return null;\n  }\n  return { provider, config: parsed, token };\n}\n\nasync function checkRowMerged(\n  parsed: ParsedRow,\n  sha: string,\n  branch: string,\n  logger?: Logger,\n): Promise<boolean> {\n  const adapter = parsed.provider.create({ config: parsed.config, token: parsed.token, logger });\n  if (!adapter.isMerged) {\n    return false;\n  }\n  try {\n    return await adapter.isMerged({ sha, branch });\n  } catch {\n    // Ignore provider errors — do not skip on failure\n    return false;\n  }\n}\n\n/** Check one status-config row for an upstream merge. */\nasync function checkRow(\n  model: StatusConfigModel,\n  row: ProjectStatusConfig,\n  providers: GitHostProvider[],\n  sha: string,\n  branch: string,\n  logger?: Logger,\n): Promise<boolean> {\n  const parsed = parseRow(model, row, providers);\n  if (!parsed) {\n    return false;\n  }\n  return await checkRowMerged(parsed, sha, branch, logger);\n}\n\n/** True when any configured provider reports the commit already merged. */\nexport async function isAlreadyMerged(opts: MergeCheck): Promise<boolean> {\n  if (opts.providers.length === 0) {\n    return false;\n  }\n  const model = new StatusConfigModel(opts.db, opts.tables, opts.secret);\n  const rows = await model.list(opts.projectId);\n  for (const row of rows) {\n    // eslint-disable-next-line no-await-in-loop -- short-circuit on first merged status\n    if (await checkRow(model, row, opts.providers, opts.sha, opts.branch, opts.logger)) {\n      return true;\n    }\n  }\n  return false;\n}\n"],"mappings":";;;;;;;AASA,eAAsB,uBACpB,IACA,QACA,WACA,KACA,gBACkB;CAElB,QAAO,MADc,IAAI,WAAW,IAAI,MAAM,CAAC,CAAC,KAAK,SAAS,EAAA,CAChD,MAAM,MAAM,EAAE,WAAW,OAAO,EAAE,OAAO,kBAAkB,EAAE,WAAW,UAAU;AAClG;AAoBA,SAAS,gBACP,WACA,KAC6B;CAC7B,OAAO,UAAU,MAAM,MAAM,EAAE,SAAS,SAAS,IAAI,QAAQ;AAC/D;AAEA,SAAS,gBAAgB,UAA2B,YAA6B;CAC/E,IAAI;EACF,MAAM,SAAkB,KAAK,MAAM,UAAU;EAC7C,SAAS,SAAS,OAAO,MAAM,MAAM;EACrC,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,eAAe,OAA0B,KAAyC;CACzF,IAAI;EACF,OAAO,MAAM,aAAa,GAAG;CAC/B,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,SACP,OACA,KACA,WACkB;CAClB,MAAM,WAAW,gBAAgB,WAAW,GAAG;CAC/C,IAAI,CAAC,UACH,OAAO;CAET,MAAM,SAAS,gBAAgB,UAAU,IAAI,MAAM;CACnD,IAAI,WAAW,MACb,OAAO;CAET,MAAM,QAAQ,eAAe,OAAO,GAAG;CACvC,IAAI,UAAU,MACZ,OAAO;CAET,OAAO;EAAE;EAAU,QAAQ;EAAQ;CAAM;AAC3C;AAEA,eAAe,eACb,QACA,KACA,QACA,QACkB;CAClB,MAAM,UAAU,OAAO,SAAS,OAAO;EAAE,QAAQ,OAAO;EAAQ,OAAO,OAAO;EAAO;CAAO,CAAC;CAC7F,IAAI,CAAC,QAAQ,UACX,OAAO;CAET,IAAI;EACF,OAAO,MAAM,QAAQ,SAAS;GAAE;GAAK;EAAO,CAAC;CAC/C,QAAQ;EAEN,OAAO;CACT;AACF;;AAGA,eAAe,SACb,OACA,KACA,WACA,KACA,QACA,QACkB;CAClB,MAAM,SAAS,SAAS,OAAO,KAAK,SAAS;CAC7C,IAAI,CAAC,QACH,OAAO;CAET,OAAO,MAAM,eAAe,QAAQ,KAAK,QAAQ,MAAM;AACzD;;AAGA,eAAsB,gBAAgB,MAAoC;CACxE,IAAI,KAAK,UAAU,WAAW,GAC5B,OAAO;CAET,MAAM,QAAQ,IAAI,kBAAkB,KAAK,IAAI,KAAK,QAAQ,KAAK,MAAM;CACrE,MAAM,OAAO,MAAM,MAAM,KAAK,KAAK,SAAS;CAC5C,KAAK,MAAM,OAAO,MAEhB,IAAI,MAAM,SAAS,OAAO,KAAK,KAAK,WAAW,KAAK,KAAK,KAAK,QAAQ,KAAK,MAAM,GAC/E,OAAO;CAGX,OAAO;AACT"}

package/dist/capture/statics.d.mts

@@ -0,0 +1,38 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DatabaseAdapter } from "../adapter/database.mjs";
+import { StorageAdapter } from "../adapter/storage.mjs";
+//#region src/capture/statics.d.ts
+/**
+ * Shared Storybook statics handling: unzip a stored build into a scratch
+ * directory and persist the extracted files back to storage. Used by the
+ * capture orchestrator and by the upload path for opt-in inline extraction
+ * (`maxInlineUnzipSize`); both write identical keys, so either may run first.
+ */
+/**
+ * Extract a build's stored zip into a dedicated scratch directory.
+ *
+ * @param storage - Storage holding the uploaded zip.
+ * @param scratchDir - Root under which per-build scratch dirs are created.
+ * @param projectId - Owning project id.
+ * @param buildId - Build whose zip to extract.
+ * @returns The extracted Storybook directory.
+ */
+declare function extractStorybookToScratch(storage: StorageAdapter, scratchDir: string, projectId: string, buildId: string): Promise<string>;
+/**
+ * Persist an extracted Storybook directory to storage for published serving.
+ *
+ * Uses content-addressed deduplication: each file is hashed and stored once
+ * under `content/<hash>`, with a per-build manifest at
+ * `${projectId}/builds/${buildId}/storybook/manifest.json`.
+ *
+ * @param storage - Destination storage adapter.
+ * @param sourceDir - Extracted Storybook directory.
+ * @param projectId - Owning project id.
+ * @param buildId - Build the files belong to.
+ * @param db - Optional database for content ref tracking (enables GC).
+ */
+declare function persistStorybookStatics(storage: StorageAdapter, sourceDir: string, projectId: string, buildId: string, db?: DatabaseAdapter): Promise<void>;
+//#endregion
+export { extractStorybookToScratch, persistStorybookStatics };
+//# sourceMappingURL=statics.d.mts.map

package/dist/capture/statics.mjs

@@ -2,9 +2,9 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { storybookDir, storybookZipPath } from "../paths.mjs";
-import { createWriteStream } from "node:fs";
-import { mkdir, readFile, readdir, rm } from "node:fs/promises";
 import { dirname, join, relative, resolve, sep } from "node:path";
+import { mkdir, readFile, readdir, rm } from "node:fs/promises";
+import { createWriteStream } from "node:fs";
 import { pipeline } from "node:stream/promises";
 import { Parse } from "unzipper";
 //#region src/capture/statics.ts
@@ -50,19 +50,53 @@ async function awaitWrites(writes) {
 /**
 * Persist an extracted Storybook directory to storage for published serving.
 *
+* Uses content-addressed deduplication: each file is hashed and stored once
+* under `content/<hash>`, with a per-build manifest at
+* `${projectId}/builds/${buildId}/storybook/manifest.json`.
+*
 * @param storage - Destination storage adapter.
 * @param sourceDir - Extracted Storybook directory.
 * @param projectId - Owning project id.
 * @param buildId - Build the files belong to.
+* @param db - Optional database for content ref tracking (enables GC).
 */
-async function persistStorybookStatics(storage, sourceDir, projectId, buildId) {
+async function persistStorybookStatics(storage, sourceDir, projectId, buildId, db) {
 	const root = resolve(sourceDir);
 	const destinationPrefix = storybookDir(projectId, buildId);
 	const files = await walkFiles(root);
+	const manifest = {};
 	await Promise.all(files.map(async (file) => {
 		const rel = relative(root, file);
-		await storage.write(`${destinationPrefix}/${rel}`, await readFile(file));
+		const buffer = await readFile(file);
+		const hash = await hashBuffer(buffer);
+		const contentPath = `content/${hash}`;
+		manifest[rel] = hash;
+		if (!await storage.exists(contentPath)) await storage.write(contentPath, buffer);
+		await storage.write(`${destinationPrefix}/${rel}`, buffer);
+		if (db) await upsertContentRef(db, hash);
 	}));
+	await storage.write(`${destinationPrefix}/manifest.json`, Buffer.from(JSON.stringify(manifest)));
+}
+async function hashBuffer(buffer) {
+	const { createHash } = await import("node:crypto");
+	return createHash("sha256").update(buffer).digest("hex");
+}
+async function upsertContentRef(db, hash) {
+	try {
+		const contentRefs = db.tables.contentRefs;
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const existing = await db.get(contentRefs, hash);
+		if (existing) await db.update(contentRefs, hash, {
+			refCount: existing.refCount + 1,
+			lastSeenAt: now
+		});
+		else await db.insert(contentRefs, {
+			hash,
+			refCount: 1,
+			lastSeenAt: now,
+			createdAt: now
+		});
+	} catch {}
 }
 function blockedTarget(root, entryName) {
 	const candidate = resolve(join(root, entryName));

package/dist/capture/statics.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"statics.mjs","names":[],"sources":["../../src/capture/statics.ts"],"sourcesContent":["import { createWriteStream } from \"node:fs\";\nimport { mkdir, readdir, readFile, rm } from \"node:fs/promises\";\nimport { dirname, join, relative, resolve, sep } from \"node:path\";\nimport { pipeline } from \"node:stream/promises\";\nimport { Parse, type Entry } from \"unzipper\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { storybookDir, storybookZipPath } from \"../utils/paths.ts\";\n\n/**\n * Shared Storybook statics handling: unzip a stored build into a scratch\n * directory and persist the extracted files back to storage. Used by the\n * capture orchestrator and by the upload path for opt-in inline extraction\n * (`maxInlineUnzipSize`); both write identical keys, so either may run first.\n */\n\n/**\n * Extract a build's stored zip into a dedicated scratch directory.\n *\n * @param storage - Storage holding the uploaded zip.\n * @param scratchDir - Root under which per-build scratch dirs are created.\n * @param projectId - Owning project id.\n * @param buildId - Build whose zip to extract.\n * @returns The extracted Storybook directory.\n */\nexport async function extractStorybookToScratch(\n  storage: StorageAdapter,\n  scratchDir: string,\n  projectId: string,\n  buildId: string,\n): Promise<string> {\n  const targetDir = join(scratchDir, projectId, \"builds\", buildId, \"storybook\");\n  const root = await prepareTargetDir(targetDir);\n  const source = await storage.readStream(storybookZipPath(projectId, buildId));\n  const writes: Promise<void>[] = [];\n  const parseError = await runParser(root, source, writes);\n  if (parseError) {\n    throw parseError;\n  }\n  await awaitWrites(writes);\n  return targetDir;\n}\n\n/** Reset a scratch target directory, returning its resolved root. */\nasync function prepareTargetDir(targetDir: string): Promise<string> {\n  await rm(targetDir, { recursive: true, force: true });\n  await mkdir(targetDir, { recursive: true });\n  return resolve(targetDir);\n}\n\n/** Await streamed zip writes, throwing the first write failure. */\nasync function awaitWrites(writes: Promise<void>[]): Promise<void> {\n  const outcomes = await Promise.allSettled(writes);\n  const writeError = outcomes.find(\n    (outcome): outcome is PromiseRejectedResult => outcome.status === \"rejected\",\n  );\n  if (writeError) {\n    throw writeError.reason;\n  }\n}\n\n/**\n * Persist an extracted Storybook directory to storage for published serving.\n *\n * @param storage - Destination storage adapter.\n * @param sourceDir - Extracted Storybook directory.\n * @param projectId - Owning project id.\n * @param buildId - Build the files belong to.\n */\nexport async function persistStorybookStatics(\n  storage: StorageAdapter,\n  sourceDir: string,\n  projectId: string,\n  buildId: string,\n): Promise<void> {\n  const root = resolve(sourceDir);\n  const destinationPrefix = storybookDir(projectId, buildId);\n  const files = await walkFiles(root);\n  await Promise.all(\n    files.map(async (file) => {\n      const rel = relative(root, file);\n      await storage.write(`${destinationPrefix}/${rel}`, await readFile(file));\n    }),\n  );\n}\n\nfunction blockedTarget(root: string, entryName: string): boolean {\n  const candidate = resolve(join(root, entryName));\n  return candidate !== root && !candidate.startsWith(root + sep);\n}\n\n/** Pipe one zip entry to disk, tracking the write for later aggregation. */\nfunction handleEntry(\n  root: string,\n  entry: Entry,\n  writes: Promise<void>[],\n  fail: (error: unknown) => void,\n): void {\n  if (blockedTarget(root, entry.path)) {\n    entry.autodrain();\n    fail(new Error(`Blocked path traversal in uploaded Storybook: ${entry.path}`));\n    return;\n  }\n  if (entry.type === \"Directory\") {\n    entry.autodrain();\n    return;\n  }\n  writeEntry(root, entry, writes);\n}\n\n/** Stream one zip entry to disk, tracking the write for later aggregation. */\nfunction writeEntry(root: string, entry: Entry, writes: Promise<void>[]): void {\n  const target = join(root, entry.path);\n  const done = (async (): Promise<void> => {\n    await mkdir(dirname(target), { recursive: true });\n    await pipeline(entry, createWriteStream(target));\n  })();\n  writes.push(done);\n  done.catch(() => {}); // Intentionally empty — aggregated via allSettled by the caller\n}\n\n/** Run the unzipper parser, resolving with the first parse error (or null). */\n// oxlint-disable-next-line typescript/promise-function-async -- executor-style promise wrapper around events\nfunction runParser(\n  root: string,\n  source: import(\"node:stream\").Readable,\n  writes: Promise<void>[],\n): Promise<unknown> {\n  return new Promise((settle) => {\n    const parser = Parse();\n    const fail = (error: unknown): void => {\n      source.destroy();\n      settle(error);\n    };\n    parser.on(\"entry\", (entry: Entry) => {\n      handleEntry(root, entry, writes, fail);\n    });\n    parser.on(\"error\", fail);\n    parser.on(\"close\", () => {\n      settle(null);\n    });\n    source.on(\"error\", fail);\n    source.pipe(parser);\n  });\n}\n\nasync function walkFiles(dir: string): Promise<string[]> {\n  const entries = await readdir(dir, { withFileTypes: true });\n  const nested = await Promise.all(\n    entries.map(async (entry) => {\n      const full = join(dir, entry.name);\n      if (entry.isDirectory()) {\n        return await walkFiles(full);\n      }\n      return [full];\n    }),\n  );\n  return nested.flat();\n}\n"],"mappings":"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"}
+{"version":3,"file":"statics.mjs","names":[],"sources":["../../src/capture/statics.ts"],"sourcesContent":["import { createWriteStream } from \"node:fs\";\nimport { mkdir, readdir, readFile, rm } from \"node:fs/promises\";\nimport { dirname, join, relative, resolve, sep } from \"node:path\";\nimport { pipeline } from \"node:stream/promises\";\nimport { Parse, type Entry } from \"unzipper\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { storybookDir, storybookZipPath } from \"../utils/paths.ts\";\n\n/**\n * Shared Storybook statics handling: unzip a stored build into a scratch\n * directory and persist the extracted files back to storage. Used by the\n * capture orchestrator and by the upload path for opt-in inline extraction\n * (`maxInlineUnzipSize`); both write identical keys, so either may run first.\n */\n\n/**\n * Extract a build's stored zip into a dedicated scratch directory.\n *\n * @param storage - Storage holding the uploaded zip.\n * @param scratchDir - Root under which per-build scratch dirs are created.\n * @param projectId - Owning project id.\n * @param buildId - Build whose zip to extract.\n * @returns The extracted Storybook directory.\n */\nexport async function extractStorybookToScratch(\n  storage: StorageAdapter,\n  scratchDir: string,\n  projectId: string,\n  buildId: string,\n): Promise<string> {\n  const targetDir = join(scratchDir, projectId, \"builds\", buildId, \"storybook\");\n  const root = await prepareTargetDir(targetDir);\n  const source = await storage.readStream(storybookZipPath(projectId, buildId));\n  const writes: Promise<void>[] = [];\n  const parseError = await runParser(root, source, writes);\n  if (parseError) {\n    throw parseError;\n  }\n  await awaitWrites(writes);\n  return targetDir;\n}\n\n/** Reset a scratch target directory, returning its resolved root. */\nasync function prepareTargetDir(targetDir: string): Promise<string> {\n  await rm(targetDir, { recursive: true, force: true });\n  await mkdir(targetDir, { recursive: true });\n  return resolve(targetDir);\n}\n\n/** Await streamed zip writes, throwing the first write failure. */\nasync function awaitWrites(writes: Promise<void>[]): Promise<void> {\n  const outcomes = await Promise.allSettled(writes);\n  const writeError = outcomes.find(\n    (outcome): outcome is PromiseRejectedResult => outcome.status === \"rejected\",\n  );\n  if (writeError) {\n    throw writeError.reason;\n  }\n}\n\n/**\n * Persist an extracted Storybook directory to storage for published serving.\n *\n * Uses content-addressed deduplication: each file is hashed and stored once\n * under `content/<hash>`, with a per-build manifest at\n * `${projectId}/builds/${buildId}/storybook/manifest.json`.\n *\n * @param storage - Destination storage adapter.\n * @param sourceDir - Extracted Storybook directory.\n * @param projectId - Owning project id.\n * @param buildId - Build the files belong to.\n * @param db - Optional database for content ref tracking (enables GC).\n */\nexport async function persistStorybookStatics(\n  storage: StorageAdapter,\n  sourceDir: string,\n  projectId: string,\n  buildId: string,\n  db?: DatabaseAdapter,\n): Promise<void> {\n  const root = resolve(sourceDir);\n  const destinationPrefix = storybookDir(projectId, buildId);\n  const files = await walkFiles(root);\n  const manifest: Record<string, string> = {};\n  await Promise.all(\n    files.map(async (file) => {\n      const rel = relative(root, file);\n      const buffer = await readFile(file);\n      const hash = await hashBuffer(buffer);\n      const contentPath = `content/${hash}`;\n      manifest[rel] = hash;\n      // Only write if not already exists (dedup)\n      if (!(await storage.exists(contentPath))) {\n        await storage.write(contentPath, buffer);\n      }\n      // Also write to legacy per-build path for backward compat (can be removed after migration)\n      // and maintain content_refs for GC\n      await storage.write(`${destinationPrefix}/${rel}`, buffer);\n      if (db) {\n        await upsertContentRef(db, hash);\n      }\n    }),\n  );\n  await storage.write(`${destinationPrefix}/manifest.json`, Buffer.from(JSON.stringify(manifest)));\n}\n\nasync function hashBuffer(buffer: Buffer): Promise<string> {\n  const { createHash } = await import(\"node:crypto\");\n  return createHash(\"sha256\").update(buffer).digest(\"hex\");\n}\n\nasync function upsertContentRef(db: DatabaseAdapter, hash: string): Promise<void> {\n  try {\n    const contentRefs = db.tables.contentRefs;\n    const now = new Date().toISOString();\n    const existing = (await db.get(contentRefs, hash)) as unknown as { refCount: number } | null;\n    if (existing) {\n      await db.update(contentRefs, hash, {\n        refCount: existing.refCount + 1,\n        lastSeenAt: now,\n      });\n    } else {\n      await db.insert(contentRefs, { hash, refCount: 1, lastSeenAt: now, createdAt: now });\n    }\n  } catch {\n    // content_refs table may not exist yet (old DB) — ignore\n  }\n}\n\nfunction blockedTarget(root: string, entryName: string): boolean {\n  const candidate = resolve(join(root, entryName));\n  return candidate !== root && !candidate.startsWith(root + sep);\n}\n\n/** Pipe one zip entry to disk, tracking the write for later aggregation. */\nfunction handleEntry(\n  root: string,\n  entry: Entry,\n  writes: Promise<void>[],\n  fail: (error: unknown) => void,\n): void {\n  if (blockedTarget(root, entry.path)) {\n    entry.autodrain();\n    fail(new Error(`Blocked path traversal in uploaded Storybook: ${entry.path}`));\n    return;\n  }\n  if (entry.type === \"Directory\") {\n    entry.autodrain();\n    return;\n  }\n  writeEntry(root, entry, writes);\n}\n\n/** Stream one zip entry to disk, tracking the write for later aggregation. */\nfunction writeEntry(root: string, entry: Entry, writes: Promise<void>[]): void {\n  const target = join(root, entry.path);\n  const done = (async (): Promise<void> => {\n    await mkdir(dirname(target), { recursive: true });\n    await pipeline(entry, createWriteStream(target));\n  })();\n  writes.push(done);\n  done.catch(() => {}); // Intentionally empty — aggregated via allSettled by the caller\n}\n\n/** Run the unzipper parser, resolving with the first parse error (or null). */\n// oxlint-disable-next-line typescript/promise-function-async -- executor-style promise wrapper around events\nfunction runParser(\n  root: string,\n  source: import(\"node:stream\").Readable,\n  writes: Promise<void>[],\n): Promise<unknown> {\n  return new Promise((settle) => {\n    const parser = Parse();\n    const fail = (error: unknown): void => {\n      source.destroy();\n      settle(error);\n    };\n    parser.on(\"entry\", (entry: Entry) => {\n      handleEntry(root, entry, writes, fail);\n    });\n    parser.on(\"error\", fail);\n    parser.on(\"close\", () => {\n      settle(null);\n    });\n    source.on(\"error\", fail);\n    source.pipe(parser);\n  });\n}\n\nasync function walkFiles(dir: string): Promise<string[]> {\n  const entries = await readdir(dir, { withFileTypes: true });\n  const nested = await Promise.all(\n    entries.map(async (entry) => {\n      const full = join(dir, entry.name);\n      if (entry.isDirectory()) {\n        return await walkFiles(full);\n      }\n      return [full];\n    }),\n  );\n  return nested.flat();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,eAAsB,0BACpB,SACA,YACA,WACA,SACiB;CACjB,MAAM,YAAY,KAAK,YAAY,WAAW,UAAU,SAAS,WAAW;CAC5E,MAAM,OAAO,MAAM,iBAAiB,SAAS;CAC7C,MAAM,SAAS,MAAM,QAAQ,WAAW,iBAAiB,WAAW,OAAO,CAAC;CAC5E,MAAM,SAA0B,CAAC;CACjC,MAAM,aAAa,MAAM,UAAU,MAAM,QAAQ,MAAM;CACvD,IAAI,YACF,MAAM;CAER,MAAM,YAAY,MAAM;CACxB,OAAO;AACT;;AAGA,eAAe,iBAAiB,WAAoC;CAClE,MAAM,GAAG,WAAW;EAAE,WAAW;EAAM,OAAO;CAAK,CAAC;CACpD,MAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;CAC1C,OAAO,QAAQ,SAAS;AAC1B;;AAGA,eAAe,YAAY,QAAwC;CAEjE,MAAM,cAAa,MADI,QAAQ,WAAW,MAAM,EAAA,CACpB,MACzB,YAA8C,QAAQ,WAAW,UACpE;CACA,IAAI,YACF,MAAM,WAAW;AAErB;;;;;;;;;;;;;;AAeA,eAAsB,wBACpB,SACA,WACA,WACA,SACA,IACe;CACf,MAAM,OAAO,QAAQ,SAAS;CAC9B,MAAM,oBAAoB,aAAa,WAAW,OAAO;CACzD,MAAM,QAAQ,MAAM,UAAU,IAAI;CAClC,MAAM,WAAmC,CAAC;CAC1C,MAAM,QAAQ,IACZ,MAAM,IAAI,OAAO,SAAS;EACxB,MAAM,MAAM,SAAS,MAAM,IAAI;EAC/B,MAAM,SAAS,MAAM,SAAS,IAAI;EAClC,MAAM,OAAO,MAAM,WAAW,MAAM;EACpC,MAAM,cAAc,WAAW;EAC/B,SAAS,OAAO;EAEhB,IAAI,CAAE,MAAM,QAAQ,OAAO,WAAW,GACpC,MAAM,QAAQ,MAAM,aAAa,MAAM;EAIzC,MAAM,QAAQ,MAAM,GAAG,kBAAkB,GAAG,OAAO,MAAM;EACzD,IAAI,IACF,MAAM,iBAAiB,IAAI,IAAI;CAEnC,CAAC,CACH;CACA,MAAM,QAAQ,MAAM,GAAG,kBAAkB,iBAAiB,OAAO,KAAK,KAAK,UAAU,QAAQ,CAAC,CAAC;AACjG;AAEA,eAAe,WAAW,QAAiC;CACzD,MAAM,EAAE,eAAe,MAAM,OAAO;CACpC,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,OAAO,KAAK;AACzD;AAEA,eAAe,iBAAiB,IAAqB,MAA6B;CAChF,IAAI;EACF,MAAM,cAAc,GAAG,OAAO;EAC9B,MAAM,uBAAM,IAAI,KAAK,EAAA,CAAE,YAAY;EACnC,MAAM,WAAY,MAAM,GAAG,IAAI,aAAa,IAAI;EAChD,IAAI,UACF,MAAM,GAAG,OAAO,aAAa,MAAM;GACjC,UAAU,SAAS,WAAW;GAC9B,YAAY;EACd,CAAC;OAED,MAAM,GAAG,OAAO,aAAa;GAAE;GAAM,UAAU;GAAG,YAAY;GAAK,WAAW;EAAI,CAAC;CAEvF,QAAQ,CAER;AACF;AAEA,SAAS,cAAc,MAAc,WAA4B;CAC/D,MAAM,YAAY,QAAQ,KAAK,MAAM,SAAS,CAAC;CAC/C,OAAO,cAAc,QAAQ,CAAC,UAAU,WAAW,OAAO,GAAG;AAC/D;;AAGA,SAAS,YACP,MACA,OACA,QACA,MACM;CACN,IAAI,cAAc,MAAM,MAAM,IAAI,GAAG;EACnC,MAAM,UAAU;EAChB,qBAAK,IAAI,MAAM,iDAAiD,MAAM,MAAM,CAAC;EAC7E;CACF;CACA,IAAI,MAAM,SAAS,aAAa;EAC9B,MAAM,UAAU;EAChB;CACF;CACA,WAAW,MAAM,OAAO,MAAM;AAChC;;AAGA,SAAS,WAAW,MAAc,OAAc,QAA+B;CAC7E,MAAM,SAAS,KAAK,MAAM,MAAM,IAAI;CACpC,MAAM,QAAQ,YAA2B;EACvC,MAAM,MAAM,QAAQ,MAAM,GAAG,EAAE,WAAW,KAAK,CAAC;EAChD,MAAM,SAAS,OAAO,kBAAkB,MAAM,CAAC;CACjD,EAAA,CAAG;CACH,OAAO,KAAK,IAAI;CAChB,KAAK,YAAY,CAAC,CAAC;AACrB;;AAIA,SAAS,UACP,MACA,QACA,QACkB;CAClB,OAAO,IAAI,SAAS,WAAW;EAC7B,MAAM,SAAS,MAAM;EACrB,MAAM,QAAQ,UAAyB;GACrC,OAAO,QAAQ;GACf,OAAO,KAAK;EACd;EACA,OAAO,GAAG,UAAU,UAAiB;GACnC,YAAY,MAAM,OAAO,QAAQ,IAAI;EACvC,CAAC;EACD,OAAO,GAAG,SAAS,IAAI;EACvB,OAAO,GAAG,eAAe;GACvB,OAAO,IAAI;EACb,CAAC;EACD,OAAO,GAAG,SAAS,IAAI;EACvB,OAAO,KAAK,MAAM;CACpB,CAAC;AACH;AAEA,eAAe,UAAU,KAAgC;CACvD,MAAM,UAAU,MAAM,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC;CAU1D,QAAO,MATc,QAAQ,IAC3B,QAAQ,IAAI,OAAO,UAAU;EAC3B,MAAM,OAAO,KAAK,KAAK,MAAM,IAAI;EACjC,IAAI,MAAM,YAAY,GACpB,OAAO,MAAM,UAAU,IAAI;EAE7B,OAAO,CAAC,IAAI;CACd,CAAC,CACH,EAAA,CACc,KAAK;AACrB"}

package/dist/capture/status-fanout.mjs

@@ -1,13 +1,18 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-import { StatusConfigModel } from "../models/status-config.mjs";
 import { buildCommentMarkdown } from "../adapter/git-host/helpers.mjs";
+import { StatusConfigModel } from "../models/status-config.mjs";
+import { LOCAL_SHA_PREFIX } from "@storyshelf/affected";
 //#region src/capture/status-fanout.ts
 /** Post build check statuses (and review comments) to every configured git provider. */
 async function postStatusesForBuild(opts) {
 	if (opts.providers.length === 0) return;
-	const model = new StatusConfigModel(opts.db, opts.secret);
+	if (opts.sha.startsWith(LOCAL_SHA_PREFIX)) {
+		opts.logger?.info({ sha: opts.sha }, "skipping git provider status for synthetic local identity");
+		return;
+	}
+	const model = new StatusConfigModel(opts.db, opts.tables, opts.secret);
 	const rows = await model.list(opts.project.id);
 	const ctx = `storyshelf/${opts.project.slug}`;
 	await Promise.allSettled(rows.map(async (row) => {

package/dist/capture/status-fanout.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"status-fanout.mjs","names":[],"sources":["../../src/capture/status-fanout.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport { buildCommentMarkdown } from \"../adapters/git-host/helpers.ts\";\nimport type { CheckStatus, GitHostProvider } from \"../adapters/git-host/index.ts\";\nimport { StatusConfigModel } from \"../models/status-config.ts\";\nimport type { Project } from \"../schema/project.ts\";\n\n/** Post build check statuses (and review comments) to every configured git provider. */\nasync function postStatusesForBuild(opts: {\n  db: DatabaseAdapter;\n  project: Project;\n  sha: string;\n  status: CheckStatus;\n  url: string;\n  providers: GitHostProvider[];\n  secret: string | undefined;\n  logger?: Logger;\n}): Promise<void> {\n  if (opts.providers.length === 0) {\n    return;\n  }\n  const model = new StatusConfigModel(opts.db, opts.secret);\n  const rows = await model.list(opts.project.id);\n  const ctx = `storyshelf/${opts.project.slug}`;\n  await Promise.allSettled(\n    rows.map(async (row) => {\n      const provider = opts.providers.find((p) => p.metadata.kind === row.provider);\n      if (!provider) {\n        opts.logger?.warn({ provider: row.provider }, \"no provider registered for status config\");\n        return;\n      }\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(row.config);\n        provider.metadata.schema.parse(parsed);\n      } catch (error: unknown) {\n        opts.logger?.warn({ err: error, provider: row.provider }, \"invalid status config\");\n        return;\n      }\n      let token: string;\n      try {\n        token = model.decryptToken(row);\n      } catch (error: unknown) {\n        opts.logger?.warn({ err: error }, \"failed to decrypt status token\");\n        return;\n      }\n      const adapter = provider.create({ config: parsed, token, logger: opts.logger });\n      await adapter.setStatus({\n        context: ctx,\n        gitSha: opts.sha,\n        status: opts.status,\n        url: opts.url,\n      });\n      if (adapter.upsertComment) {\n        const markdown = buildCommentMarkdown(opts.status, opts.url, ctx);\n        await adapter\n          .upsertComment({ sha: opts.sha, url: opts.url, status: opts.status, markdown })\n          .catch((error: unknown) => {\n            opts.logger?.warn({ err: error, provider: row.provider }, \"failed to upsert comment\");\n          });\n      }\n    }),\n  );\n}\n\nexport { postStatusesForBuild };\n"],"mappings":";;;;;;;AAQA,eAAe,qBAAqB,MASlB;CAChB,IAAI,KAAK,UAAU,WAAW,GAC5B;CAEF,MAAM,QAAQ,IAAI,kBAAkB,KAAK,IAAI,KAAK,MAAM;CACxD,MAAM,OAAO,MAAM,MAAM,KAAK,KAAK,QAAQ,EAAE;CAC7C,MAAM,MAAM,cAAc,KAAK,QAAQ;CACvC,MAAM,QAAQ,WACZ,KAAK,IAAI,OAAO,QAAQ;EACtB,MAAM,WAAW,KAAK,UAAU,MAAM,MAAM,EAAE,SAAS,SAAS,IAAI,QAAQ;EAC5E,IAAI,CAAC,UAAU;GACb,KAAK,QAAQ,KAAK,EAAE,UAAU,IAAI,SAAS,GAAG,0CAA0C;GACxF;EACF;EACA,IAAI;EACJ,IAAI;GACF,SAAS,KAAK,MAAM,IAAI,MAAM;GAC9B,SAAS,SAAS,OAAO,MAAM,MAAM;EACvC,SAAS,OAAgB;GACvB,KAAK,QAAQ,KAAK;IAAE,KAAK;IAAO,UAAU,IAAI;GAAS,GAAG,uBAAuB;GACjF;EACF;EACA,IAAI;EACJ,IAAI;GACF,QAAQ,MAAM,aAAa,GAAG;EAChC,SAAS,OAAgB;GACvB,KAAK,QAAQ,KAAK,EAAE,KAAK,MAAM,GAAG,gCAAgC;GAClE;EACF;EACA,MAAM,UAAU,SAAS,OAAO;GAAE,QAAQ;GAAQ;GAAO,QAAQ,KAAK;EAAO,CAAC;EAC9E,MAAM,QAAQ,UAAU;GACtB,SAAS;GACT,QAAQ,KAAK;GACb,QAAQ,KAAK;GACb,KAAK,KAAK;EACZ,CAAC;EACD,IAAI,QAAQ,eAAe;GACzB,MAAM,WAAW,qBAAqB,KAAK,QAAQ,KAAK,KAAK,GAAG;GAChE,MAAM,QACH,cAAc;IAAE,KAAK,KAAK;IAAK,KAAK,KAAK;IAAK,QAAQ,KAAK;IAAQ;GAAS,CAAC,CAAC,CAC9E,OAAO,UAAmB;IACzB,KAAK,QAAQ,KAAK;KAAE,KAAK;KAAO,UAAU,IAAI;IAAS,GAAG,0BAA0B;GACtF,CAAC;EACL;CACF,CAAC,CACH;AACF"}
+{"version":3,"file":"status-fanout.mjs","names":[],"sources":["../../src/capture/status-fanout.ts"],"sourcesContent":["import { LOCAL_SHA_PREFIX } from \"@storyshelf/affected\";\nimport type { Logger } from \"pino\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport { buildCommentMarkdown } from \"../adapters/git-host/helpers.ts\";\nimport type { CheckStatus, GitHostProvider } from \"../adapters/git-host/index.ts\";\nimport { StatusConfigModel, type StatusConfigTables } from \"../models/status-config.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\n\n/** Post build check statuses (and review comments) to every configured git provider. */\nasync function postStatusesForBuild(opts: {\n  db: DatabaseAdapter;\n  tables: StatusConfigTables;\n  project: Project;\n  sha: string;\n  status: CheckStatus;\n  url: string;\n  providers: GitHostProvider[];\n  secret: SecretInput;\n  logger?: Logger;\n}): Promise<void> {\n  if (opts.providers.length === 0) {\n    return;\n  }\n  if (opts.sha.startsWith(LOCAL_SHA_PREFIX)) {\n    opts.logger?.info(\n      { sha: opts.sha },\n      \"skipping git provider status for synthetic local identity\",\n    );\n    return;\n  }\n  const model = new StatusConfigModel(opts.db, opts.tables, opts.secret);\n  const rows = await model.list(opts.project.id);\n  const ctx = `storyshelf/${opts.project.slug}`;\n  await Promise.allSettled(\n    rows.map(async (row) => {\n      const provider = opts.providers.find((p) => p.metadata.kind === row.provider);\n      if (!provider) {\n        opts.logger?.warn({ provider: row.provider }, \"no provider registered for status config\");\n        return;\n      }\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(row.config);\n        provider.metadata.schema.parse(parsed);\n      } catch (error: unknown) {\n        opts.logger?.warn({ err: error, provider: row.provider }, \"invalid status config\");\n        return;\n      }\n      let token: string;\n      try {\n        token = model.decryptToken(row);\n      } catch (error: unknown) {\n        opts.logger?.warn({ err: error }, \"failed to decrypt status token\");\n        return;\n      }\n      const adapter = provider.create({ config: parsed, token, logger: opts.logger });\n      await adapter.setStatus({\n        context: ctx,\n        gitSha: opts.sha,\n        status: opts.status,\n        url: opts.url,\n      });\n      if (adapter.upsertComment) {\n        const markdown = buildCommentMarkdown(opts.status, opts.url, ctx);\n        await adapter\n          .upsertComment({ sha: opts.sha, url: opts.url, status: opts.status, markdown })\n          .catch((error: unknown) => {\n            opts.logger?.warn({ err: error, provider: row.provider }, \"failed to upsert comment\");\n          });\n      }\n    }),\n  );\n}\n\nexport { postStatusesForBuild };\n"],"mappings":";;;;;;;;AAUA,eAAe,qBAAqB,MAUlB;CAChB,IAAI,KAAK,UAAU,WAAW,GAC5B;CAEF,IAAI,KAAK,IAAI,WAAW,gBAAgB,GAAG;EACzC,KAAK,QAAQ,KACX,EAAE,KAAK,KAAK,IAAI,GAChB,2DACF;EACA;CACF;CACA,MAAM,QAAQ,IAAI,kBAAkB,KAAK,IAAI,KAAK,QAAQ,KAAK,MAAM;CACrE,MAAM,OAAO,MAAM,MAAM,KAAK,KAAK,QAAQ,EAAE;CAC7C,MAAM,MAAM,cAAc,KAAK,QAAQ;CACvC,MAAM,QAAQ,WACZ,KAAK,IAAI,OAAO,QAAQ;EACtB,MAAM,WAAW,KAAK,UAAU,MAAM,MAAM,EAAE,SAAS,SAAS,IAAI,QAAQ;EAC5E,IAAI,CAAC,UAAU;GACb,KAAK,QAAQ,KAAK,EAAE,UAAU,IAAI,SAAS,GAAG,0CAA0C;GACxF;EACF;EACA,IAAI;EACJ,IAAI;GACF,SAAS,KAAK,MAAM,IAAI,MAAM;GAC9B,SAAS,SAAS,OAAO,MAAM,MAAM;EACvC,SAAS,OAAgB;GACvB,KAAK,QAAQ,KAAK;IAAE,KAAK;IAAO,UAAU,IAAI;GAAS,GAAG,uBAAuB;GACjF;EACF;EACA,IAAI;EACJ,IAAI;GACF,QAAQ,MAAM,aAAa,GAAG;EAChC,SAAS,OAAgB;GACvB,KAAK,QAAQ,KAAK,EAAE,KAAK,MAAM,GAAG,gCAAgC;GAClE;EACF;EACA,MAAM,UAAU,SAAS,OAAO;GAAE,QAAQ;GAAQ;GAAO,QAAQ,KAAK;EAAO,CAAC;EAC9E,MAAM,QAAQ,UAAU;GACtB,SAAS;GACT,QAAQ,KAAK;GACb,QAAQ,KAAK;GACb,KAAK,KAAK;EACZ,CAAC;EACD,IAAI,QAAQ,eAAe;GACzB,MAAM,WAAW,qBAAqB,KAAK,QAAQ,KAAK,KAAK,GAAG;GAChE,MAAM,QACH,cAAc;IAAE,KAAK,KAAK;IAAK,KAAK,KAAK;IAAK,QAAQ,KAAK;IAAQ;GAAS,CAAC,CAAC,CAC9E,OAAO,UAAmB;IACzB,KAAK,QAAQ,KAAK;KAAE,KAAK;KAAO,UAAU,IAAI;IAAS,GAAG,0BAA0B;GACtF,CAAC;EACL;CACF,CAAC,CACH;AACF"}

package/dist/capture/storybook.d.mts

@@ -1,15 +1,44 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { StoryEntry, StorySourceAdapter } from "./adapter.mjs";
+import { StoryEntry, StoryParameters, StorySourceAdapter, StoryViewportConfig, Viewport } from "./adapter.mjs";
+import { DepGraph } from "@storyshelf/affected";
 //#region src/capture/storybook.d.ts
+/** Story parameters as serialized by the Storybook index. */
+interface StorybookParameters {
+  chromatic?: StoryParameters;
+  storyshelf?: StoryParameters;
+  viewport?: StoryViewportConfig;
+}
+/** Merge the `chromatic` and `storyshelf` parameter layers (`storyshelf` wins). */
+declare function mergeParameters(entry: {
+  parameters?: StorybookParameters;
+}): StoryParameters | undefined;
+/**
+ * The Storybook `MINIMAL_VIEWPORTS` snapshot used to resolve a story's
+ * `defaultViewport` name at capture time. Dimensions are the documented
+ * stable set; inline `parameters.viewport.viewports` always win over these.
+ */
+declare const STORYBOOK_BUILTIN_VIEWPORTS: Readonly<Record<string, Viewport>>;
+/**
+ * Resolve the viewports a story should be captured at: the project's global
+ * list plus the story's Storybook default viewport (union), deduplicated by
+ * name. An unresolvable or duplicate default contributes nothing extra.
+ */
+declare function resolveStoryViewports(entry: Pick<StoryEntry, "parameters">, globalViewports: Viewport[]): Viewport[];
 /** Discovers stories from a built Storybook via its index file. */
 declare class StorybookAdapter implements StorySourceAdapter {
   readonly name = "storybook";
   readonly screenshotSelector = "#storybook-root";
   discover(source: string): Promise<StoryEntry[]>;
   buildUrl(baseUrl: string, storyId: string): string;
+  /**
+   * Load the Vite stats dependency graph of an extracted build for affected
+   * capture. Resolves `null` when the build ships no usable stats, in which
+   * case the orchestrator renders every story.
+   */
+  loadDependencyGraph(source: string): Promise<DepGraph | null>;
   private readIndex;
 }
 //#endregion
-export { StorybookAdapter };
+export { STORYBOOK_BUILTIN_VIEWPORTS, StorybookAdapter, mergeParameters, resolveStoryViewports };
 //# sourceMappingURL=storybook.d.mts.map