@storyshelf/core 0.6.2 → 0.8.0

package/dist/capture/pipeline.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.mjs","names":[],"sources":["../../src/capture/pipeline.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport type { RenderedSnapshot } from \"../adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { NO_BASELINE } from \"../models/baseline-status.ts\";\nimport { BaselineModel, type BaselineTables } from \"../models/baseline.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport { emitAttemptLog, type AttemptLogRecorder } from \"../models/capture-attempt.ts\";\nimport { SnapshotModel, type SnapshotTables } 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 { BuildStatus, SnapshotStatus } from \"../types.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { diffPath, screenshotPath } from \"../utils/paths.ts\";\nimport type { Viewport } from \"./adapter.ts\";\nimport type { InheritedStory } from \"./affected.ts\";\nimport { diffStoredScreenshots, writeDiffOverlay } from \"./diff-record.ts\";\nimport { assertScreenshotBuffer } from \"./guards.ts\";\nimport { infraHashFor, SIZING_DEFAULTS } from \"./sizing.ts\";\n\n/**\n * Persist a completed capture run: write screenshots, diff against the branch\n * baseline, create snapshots, and finalize the build.\n *\n * Rendering is performed by a pure `CaptureRunner`; this function owns only\n * storage writes and record keeping, so it can run against any renderer.\n *\n * @param ctx - Capture context.\n * @param renderFailedStoryIds - Story ids that the renderer could not capture\n * (blocking failures). They force the build to `failed`.\n * @param flakyFailedStoryIds - Story ids that failed but are marked flaky\n * (non-blocking). They are logged as warnings and do not block the build.\n */\nexport async function persistCapture(\n  ctx: CaptureContext,\n  renderFailedStoryIds: ReadonlySet<string> = new Set(),\n  flakyFailedStoryIds: ReadonlySet<string> = new Set(),\n  a11yFailedStoryIds: ReadonlySet<string> = new Set(),\n): Promise<void> {\n  const failedStoryIds = new Set(renderFailedStoryIds);\n  const flakyIds = new Set(flakyFailedStoryIds);\n  const a11yIds = new Set(a11yFailedStoryIds);\n  await Promise.all(\n    ctx.captures.map(async (capture) => {\n      try {\n        await persistSnapshot(ctx, capture);\n      } catch (error) {\n        // A failure in one story/viewport must not abort the other persists.\n        // Flaky and a11y stories remain non-blocking even on persist failure.\n        if (flakyIds.has(capture.story.id) || a11yIds.has(capture.story.id)) {\n          if (flakyIds.has(capture.story.id)) flakyIds.add(capture.story.id);\n          if (a11yIds.has(capture.story.id)) a11yIds.add(capture.story.id);\n          ctx.logger?.warn(\n            { storyId: capture.story.id, viewport: capture.viewportName, err: error },\n            \"capture failed for flaky/a11y story (non-blocking)\",\n          );\n          await emitAttemptLog(\n            ctx.recordLog,\n            ctx.logger,\n            \"warn\",\n            \"capture failed for flaky/a11y story (non-blocking)\",\n            {\n              storyId: capture.story.id,\n              viewport: capture.viewportName,\n            },\n          );\n        } else {\n          failedStoryIds.add(capture.story.id);\n        }\n        ctx.logger?.error(\n          { storyId: capture.story.id, viewport: capture.viewportName, err: error },\n          \"capture failed for story\",\n        );\n        await emitAttemptLog(ctx.recordLog, ctx.logger, \"error\", \"capture failed for story\", {\n          storyId: capture.story.id,\n          viewport: capture.viewportName,\n        });\n      }\n    }),\n  );\n  // Also log flaky and a11y render failures as warnings\n  for (const id of flakyIds) {\n    if (!failedStoryIds.has(id)) {\n      ctx.logger?.warn({ storyId: id }, \"flaky story failed (non-blocking)\");\n      await emitAttemptLog(ctx.recordLog, ctx.logger, \"warn\", \"flaky story failed (non-blocking)\", {\n        storyId: id,\n      });\n    }\n  }\n  for (const id of a11yIds) {\n    if (!failedStoryIds.has(id) && !flakyIds.has(id)) {\n      ctx.logger?.warn({ storyId: id }, \"a11y violations found (non-blocking)\");\n      await emitAttemptLog(\n        ctx.recordLog,\n        ctx.logger,\n        \"warn\",\n        \"a11y violations found (non-blocking)\",\n        {\n          storyId: id,\n        },\n      );\n    }\n  }\n  for (const id of await persistInherited(ctx)) {\n    failedStoryIds.add(id);\n  }\n  await finalize(ctx, allStoryIds(ctx), failedStoryIds, flakyIds, a11yIds);\n}\n\n/** Persist one inherited snapshot; returns the story id on failure. */\nasync function tryPersistInherited(\n  ctx: CaptureContext,\n  inherited: InheritedStory,\n): Promise<string | null> {\n  try {\n    await persistInheritedSnapshot(ctx, inherited);\n    return null;\n  } catch (error) {\n    ctx.logger?.error(\n      { storyId: inherited.story.id, viewport: inherited.viewport.name, err: error },\n      \"inherit failed for story\",\n    );\n    await emitAttemptLog(ctx.recordLog, ctx.logger, \"error\", \"inherit failed for story\", {\n      storyId: inherited.story.id,\n      viewport: inherited.viewport.name,\n    });\n    return inherited.story.id;\n  }\n}\n\n/** Persist inherited snapshots; a failure marks the story failed. */\nasync function persistInherited(ctx: CaptureContext): Promise<ReadonlySet<string>> {\n  const outcomes = await Promise.all(\n    (ctx.inherited ?? []).map(async (inherited) => await tryPersistInherited(ctx, inherited)),\n  );\n  return new Set(outcomes.filter((id): id is string => id !== null));\n}\n\n/** Create an unchanged snapshot reusing the baseline screenshot. */\nasync function persistInheritedSnapshot(\n  ctx: CaptureContext,\n  inherited: InheritedStory,\n): Promise<void> {\n  const infraHash = infraHashFor(ctx.project.browser ?? \"chromium\", ctx.viewports, SIZING_DEFAULTS);\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    storyId: inherited.story.id,\n    storyName: inherited.story.name,\n    storyTitle: inherited.story.title,\n    storyImportPath: inherited.story.importPath ?? \"\",\n    viewportName: inherited.viewport.name,\n    viewportWidth: inherited.viewport.width,\n    viewportHeight: inherited.viewport.height,\n    screenshotPath: inherited.baseline.screenshotPath,\n    infraHash,\n    inherited: true,\n    baselineId: inherited.baseline.id,\n    baselineVersion: inherited.baseline.updatedAt,\n  });\n  await snapshots.update(snapshot.id, {\n    status: \"unchanged\",\n    diffPixels: 0,\n    diffRatio: 0,\n    diffPassed: true,\n    diffPath: null,\n    infraHash,\n  });\n}\n\n/** Every story covered by a capture run, rendered or inherited. */\nfunction allStoryIds(ctx: CaptureContext): ReadonlySet<string> {\n  const ids = new Set(ctx.captures.map((capture) => capture.story.id));\n  for (const inherited of ctx.inherited ?? []) {\n    ids.add(inherited.story.id);\n  }\n  return ids;\n}\n\n/** Table handles required by the capture pipeline. */\nexport type PipelineTables = BuildTables & BaselineTables & SnapshotTables;\n\n/** Persistence inputs for a completed capture run. */\nexport interface CaptureContext {\n  /** Database adapter. */\n  db: DatabaseAdapter;\n  /** Table handles. */\n  tables: PipelineTables;\n  /** Storage adapter. */\n  storage: StorageAdapter;\n  /** The project being captured. */\n  project: Project;\n  /** The build being captured. */\n  build: Build;\n  /** Viewports at which stories were captured. */\n  viewports: Viewport[];\n  /** Screenshot buffers produced by the capture renderer. */\n  captures: RenderedSnapshot[];\n  /** Stories inheriting their baseline without rendering (affected capture). */\n  inherited?: InheritedStory[];\n  /** Optional logger for capture diagnostics. */\n  logger?: Logger;\n  /** Optional per-attempt log recorder (mirrors logger lines into the DB). */\n  recordLog?: AttemptLogRecorder;\n  /** Server secret for decrypting webhook secrets at send time. */\n  secret?: SecretInput;\n}\n\nfunction viewportByName(ctx: CaptureContext, name: string): Viewport {\n  return ctx.viewports.find((v) => v.name === name) ?? { name, width: 0, height: 0 };\n}\n\nasync function persistSnapshot(ctx: CaptureContext, capture: RenderedSnapshot): Promise<void> {\n  assertScreenshotBuffer(capture.screenshot);\n  const viewport = capture.viewport ?? viewportByName(ctx, capture.viewportName);\n  const screenshot = screenshotPath(\n    ctx.project.id,\n    ctx.build.id,\n    capture.story.id,\n    capture.viewportName,\n  );\n  await ctx.storage.write(screenshot, capture.screenshot);\n\n  const baseline = await resolveBaseline(ctx, capture.story.id, capture.viewportName);\n  if (!baseline) {\n    await createWithoutBaseline(ctx, capture, viewport, screenshot);\n    return;\n  }\n  await createWithBaseline(ctx, capture, viewport, screenshot, baseline);\n}\n\nasync function resolveBaseline(\n  ctx: CaptureContext,\n  storyId: string,\n  viewport: string,\n): Promise<Baseline | null> {\n  const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n  return await baselines.resolve(\n    ctx.project.id,\n    storyId,\n    viewport,\n    ctx.build.gitBranch,\n    ctx.project.gitDefaultBranch,\n  );\n}\n\nasync function createWithoutBaseline(\n  ctx: CaptureContext,\n  capture: RenderedSnapshot,\n  viewport: Viewport,\n  screenshot: string,\n): Promise<void> {\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const status = ctx.build.isDefault ? \"approved\" : \"new\";\n  const infraHash = infraHashFor(ctx.project.browser ?? \"chromium\", ctx.viewports, SIZING_DEFAULTS);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    storyId: capture.story.id,\n    storyName: capture.story.name,\n    storyTitle: capture.story.title,\n    storyImportPath: capture.story.importPath ?? \"\",\n    viewportName: capture.viewportName,\n    viewportWidth: viewport.width,\n    viewportHeight: viewport.height,\n    screenshotPath: screenshot,\n    infraHash,\n    baselineVersion: NO_BASELINE,\n  });\n  await snapshots.setStatus(snapshot.id, status);\n\n  if (ctx.build.isDefault) {\n    const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n    await baselines.upsert(\n      ctx.project.id,\n      capture.story.id,\n      capture.viewportName,\n      ctx.build.gitBranch,\n      snapshot.id,\n      screenshot,\n      infraHash,\n    );\n  }\n}\n\nasync function createWithBaseline(\n  ctx: CaptureContext,\n  capture: RenderedSnapshot,\n  viewport: Viewport,\n  screenshot: string,\n  baseline: Baseline,\n): Promise<void> {\n  const result = await diffStoredScreenshots(\n    ctx.storage,\n    ctx.project,\n    baseline.screenshotPath,\n    screenshot,\n    capture.story.parameters?.diffThreshold,\n  );\n\n  const infraHash = infraHashFor(ctx.project.browser ?? \"chromium\", ctx.viewports, SIZING_DEFAULTS);\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    storyId: capture.story.id,\n    storyName: capture.story.name,\n    storyTitle: capture.story.title,\n    storyImportPath: capture.story.importPath ?? \"\",\n    viewportName: capture.viewportName,\n    viewportWidth: viewport.width,\n    viewportHeight: viewport.height,\n    screenshotPath: screenshot,\n    infraHash,\n    baselineId: baseline.id,\n    baselineVersion: baseline.updatedAt,\n  });\n\n  // Automigrate: infra-induced size change with project.automigrate enabled\n  const shouldAutomigrate =\n    result.sizeChanged &&\n    !result.passed &&\n    (ctx.project as unknown as { automigrate?: boolean }).automigrate &&\n    baseline.infraHash !== null &&\n    baseline.infraHash !== infraHash;\n\n  const status = shouldAutomigrate ? \"unchanged\" : diffStatus(result.passed, ctx.build.isDefault);\n  const diff = diffPath(ctx.project.id, ctx.build.id, capture.story.id, capture.viewportName);\n  const passed = shouldAutomigrate ? true : result.passed;\n  const pixels = shouldAutomigrate ? 0 : result.diffPixels;\n  const ratio = shouldAutomigrate ? 0 : result.diffRatio;\n  const overlay = await writeDiffOverlay(ctx.storage, diff, result, passed);\n  await snapshots.update(snapshot.id, {\n    status,\n    diffPath: overlay,\n    diffPixels: pixels,\n    diffRatio: ratio,\n    diffPassed: passed,\n    infraHash,\n  });\n  if (ctx.build.isDefault && (shouldAutomigrate || !passed)) {\n    await upsertDefaultBaseline(ctx, snapshot.id, capture, screenshot, infraHash);\n  }\n}\n\n/** Default-branch builds are authoritative: the captured screenshot becomes the baseline. */\nasync function upsertDefaultBaseline(\n  ctx: CaptureContext,\n  snapshotId: string,\n  capture: RenderedSnapshot,\n  screenshot: string,\n  infraHash: string,\n): Promise<void> {\n  const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n  await baselines.upsert(\n    ctx.project.id,\n    capture.story.id,\n    capture.viewportName,\n    ctx.build.gitBranch,\n    snapshotId,\n    screenshot,\n    infraHash,\n  );\n}\n\n/** Snapshot status after diffing: default-branch changes are auto-approved, not queued for review. */\nexport function diffStatus(passed: boolean, isDefault: boolean): SnapshotStatus {\n  if (passed) {\n    return \"unchanged\";\n  }\n  return isDefault ? \"approved\" : \"changed\";\n}\n\n/** A failed capture fails the build; default-branch builds otherwise auto-approve. */\nfunction finalBuildStatus(\n  isDefault: boolean,\n  failedCount: number,\n  hasCaptures: boolean,\n  build: { changedCount: number },\n): BuildStatus {\n  if (failedCount > 0) {\n    return \"failed\";\n  }\n  if (isDefault || (hasCaptures && build.changedCount === 0)) {\n    return \"approved\";\n  }\n  return \"reviewing\";\n}\n\nasync function finalize(\n  ctx: CaptureContext,\n  storyIds: ReadonlySet<string>,\n  failedStoryIds: ReadonlySet<string>,\n  flakyFailedStoryIds: ReadonlySet<string> = new Set(),\n  a11yFailedStoryIds: ReadonlySet<string> = new Set(),\n): Promise<void> {\n  const builds = new BuildModel(ctx.db, ctx.tables);\n  const build = await builds.updateCounts(ctx.build.id);\n  const hasCaptures = storyIds.size > 0;\n  const status = finalBuildStatus(ctx.build.isDefault, failedStoryIds.size, hasCaptures, build);\n  // Flaky and a11y failures do not block: log warning if any failed non-blocking\n  if (flakyFailedStoryIds.size > 0 && failedStoryIds.size === 0) {\n    ctx.logger?.warn(\n      { flakyStoryIds: [...flakyFailedStoryIds] },\n      \"flaky stories failed (non-blocking)\",\n    );\n    await emitAttemptLog(ctx.recordLog, ctx.logger, \"warn\", \"flaky stories failed (non-blocking)\", {\n      flakyStoryIds: [...flakyFailedStoryIds],\n    });\n  }\n  if (a11yFailedStoryIds.size > 0 && failedStoryIds.size === 0) {\n    ctx.logger?.warn(\n      { a11yStoryIds: [...a11yFailedStoryIds] },\n      \"a11y violations found (non-blocking)\",\n    );\n    await emitAttemptLog(\n      ctx.recordLog,\n      ctx.logger,\n      \"warn\",\n      \"a11y violations found (non-blocking)\",\n      {\n        a11yStoryIds: [...a11yFailedStoryIds],\n      },\n    );\n  }\n  await builds.setStatus(ctx.build.id, status);\n\n  if (ctx.build.isDefault && hasCaptures) {\n    const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n    await baselines.removeOrphans(ctx.project.id, new Set(storyIds));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"pipeline.mjs","names":[],"sources":["../../src/capture/pipeline.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport { DEFAULT_BROWSER, type RenderedSnapshot } from \"../adapters/capture-runner.ts\";\nimport { ReferenceGenerationConflict, type DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { BaselineWriteConflict } from \"../models/baseline-conflict.ts\";\nimport { NO_BASELINE } from \"../models/baseline-status.ts\";\nimport { BaselineModel, type BaselineTables } from \"../models/baseline.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport { emitAttemptLog, type AttemptLogRecorder } from \"../models/capture-attempt.ts\";\nimport { SnapshotModel, type SnapshotTables } 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 { BuildStatus, SnapshotStatus } from \"../types.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { mapLimit } from \"../utils/map-limit.ts\";\nimport { diffPath } from \"../utils/paths.ts\";\nimport { storeScreenshot } from \"../utils/screenshot-store.ts\";\nimport type { Viewport } from \"./adapter.ts\";\nimport type { InheritedStory } from \"./affected.ts\";\nimport { freezeComparison, sourceSnapshotId } from \"./comparison-reference.ts\";\nimport { diffStoredScreenshots, writeDiffOverlay } from \"./diff-record.ts\";\nimport {\n  buildFingerprint,\n  changedFields,\n  fingerprintHash,\n  mergeFingerprint,\n  parseFingerprint,\n  type EnvironmentChange,\n  type Fingerprint,\n} from \"./fingerprint.ts\";\nimport { assertScreenshotBuffer } from \"./guards.ts\";\nimport type { CaptureProgress } from \"./progress.ts\";\n\n/** Snapshots persisted at once: each decodes two PNGs for the diff, so unbounded fan-out spikes memory. */\nexport const PERSIST_CONCURRENCY = 4;\n\n/**\n * Persist a completed capture run: write screenshots, diff against the branch\n * baseline, create snapshots, and finalize the build.\n *\n * Rendering is performed by a pure `CaptureRunner`; this function owns only\n * storage writes and record keeping, so it can run against any renderer.\n *\n * @param ctx - Capture context.\n * @param renderFailedStoryIds - Story ids that the renderer could not capture\n * (blocking failures). They force the build to `failed`.\n * @param flakyFailedStoryIds - Story ids that failed but are marked flaky\n * (non-blocking). They are logged as warnings and do not block the build.\n */\nexport async function persistCapture(\n  input: CaptureContext,\n  renderFailedStoryIds: ReadonlySet<string> = new Set(),\n  flakyFailedStoryIds: ReadonlySet<string> = new Set(),\n  a11yFailedStoryIds: ReadonlySet<string> = new Set(),\n): Promise<void> {\n  const sets = await persistRendered(\n    input,\n    renderFailedStoryIds,\n    flakyFailedStoryIds,\n    a11yFailedStoryIds,\n  );\n  for (const id of await persistInherited(input)) {\n    sets.failed.add(id);\n  }\n  await finalizeBuild(input, allStoryIds(input), sets.failed, sets.flaky, sets.a11y);\n}\n\n/** Blocking, flaky and a11y story ids a persist run ended with. */\nexport interface PersistedSets {\n  failed: Set<string>;\n  flaky: Set<string>;\n  a11y: Set<string>;\n}\n\n/**\n * Persist the rendered captures only: screenshots, diffs and snapshot rows, without the\n * inherited snapshots or the build finalize. A sharded capture runs this once per shard.\n */\nexport async function persistRendered(\n  input: CaptureContext,\n  renderFailedStoryIds: ReadonlySet<string> = new Set(),\n  flakyFailedStoryIds: ReadonlySet<string> = new Set(),\n  a11yFailedStoryIds: ReadonlySet<string> = new Set(),\n): Promise<PersistedSets> {\n  const ctx = await withFreshBrowsers(input);\n  const failedStoryIds = new Set(renderFailedStoryIds);\n  const flakyIds = new Set(flakyFailedStoryIds);\n  const a11yIds = new Set(a11yFailedStoryIds);\n  // Primary engine first: a newly enabled engine bootstraps from its counterpart.\n  for (const group of capturesByPhase(ctx)) {\n    // oxlint-disable-next-line no-await-in-loop -- phases must run in order\n    await mapLimit(group, PERSIST_CONCURRENCY, async (capture) => {\n      try {\n        await persistSnapshot(ctx, capture);\n        // Each diff is progress: a long, healthy persist phase must not read as a hung job.\n        ctx.progress?.();\n      } catch (error) {\n        // A failure in one story/viewport must not abort the other persists.\n        // Flaky and a11y stories remain non-blocking even on persist failure.\n        if (flakyIds.has(capture.story.id) || a11yIds.has(capture.story.id)) {\n          if (flakyIds.has(capture.story.id)) flakyIds.add(capture.story.id);\n          if (a11yIds.has(capture.story.id)) a11yIds.add(capture.story.id);\n          ctx.logger?.warn(\n            { storyId: capture.story.id, viewport: capture.viewportName, err: error },\n            \"capture failed for flaky/a11y story (non-blocking)\",\n          );\n          await emitAttemptLog(\n            ctx.recordLog,\n            ctx.logger,\n            \"warn\",\n            \"capture failed for flaky/a11y story (non-blocking)\",\n            {\n              storyId: capture.story.id,\n              viewport: capture.viewportName,\n            },\n          );\n        } else {\n          failedStoryIds.add(capture.story.id);\n        }\n        ctx.logger?.error(\n          { storyId: capture.story.id, viewport: capture.viewportName, err: error },\n          \"capture failed for story\",\n        );\n        await emitAttemptLog(ctx.recordLog, ctx.logger, \"error\", \"capture failed for story\", {\n          storyId: capture.story.id,\n          viewport: capture.viewportName,\n        });\n      }\n    });\n  }\n  // Also log flaky and a11y render failures as warnings\n  for (const id of flakyIds) {\n    if (!failedStoryIds.has(id)) {\n      ctx.logger?.warn({ storyId: id }, \"flaky story failed (non-blocking)\");\n      await emitAttemptLog(ctx.recordLog, ctx.logger, \"warn\", \"flaky story failed (non-blocking)\", {\n        storyId: id,\n      });\n    }\n  }\n  for (const id of a11yIds) {\n    if (!failedStoryIds.has(id) && !flakyIds.has(id)) {\n      ctx.logger?.warn({ storyId: id }, \"a11y violations found (non-blocking)\");\n      await emitAttemptLog(\n        ctx.recordLog,\n        ctx.logger,\n        \"warn\",\n        \"a11y violations found (non-blocking)\",\n        {\n          storyId: id,\n        },\n      );\n    }\n  }\n  return { failed: failedStoryIds, flaky: flakyIds, a11y: a11yIds };\n}\n\n/** Engines of this run, primary (first) first. */\nfunction runBrowsers(ctx: CaptureContext): string[] {\n  const listed = ctx.browsers && ctx.browsers.length > 0 ? ctx.browsers : [DEFAULT_BROWSER];\n  return [...new Set(listed)];\n}\n\nfunction primaryBrowser(ctx: CaptureContext): string {\n  return runBrowsers(ctx)[0] ?? DEFAULT_BROWSER;\n}\n\n/** The capture's axe violation texts as the JSON stored on the snapshot; null when there are none. */\nfunction a11yJsonOf(capture: { a11y?: string[] }): string | null {\n  return capture.a11y && capture.a11y.length > 0 ? JSON.stringify(capture.a11y) : null;\n}\n\nfunction browserOf(capture: { browser?: string }): string {\n  return capture.browser ?? DEFAULT_BROWSER;\n}\n\n/** Captures split into the primary engine's, then everyone else's. */\nfunction capturesByPhase(ctx: CaptureContext): RenderedSnapshot[][] {\n  const primary = primaryBrowser(ctx);\n  const first = ctx.captures.filter((capture) => browserOf(capture) === primary);\n  const rest = ctx.captures.filter((capture) => browserOf(capture) !== primary);\n  return rest.length > 0 ? [first, rest] : [first];\n}\n\n/** Secondary engines with no baseline yet (their first snapshots bootstrap from the primary). */\nexport async function freshBrowsersOf(ctx: CaptureContext): Promise<Set<string>> {\n  const primary = primaryBrowser(ctx);\n  const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n  const secondary = runBrowsers(ctx).filter((browser) => browser !== primary);\n  const checks = await Promise.all(\n    secondary.map(async (browser) => ({\n      browser,\n      fresh: !(await baselines.hasAny(ctx.project.id, browser)),\n    })),\n  );\n  return new Set(checks.filter((check) => check.fresh).map((check) => check.browser));\n}\n\n/** Mark secondary engines with no baseline yet: their first snapshots bootstrap. */\nasync function withFreshBrowsers(ctx: CaptureContext): Promise<CaptureContext> {\n  return ctx.freshBrowsers ? ctx : { ...ctx, freshBrowsers: await freshBrowsersOf(ctx) };\n}\n\n/**\n * A newly enabled engine accepts a story/mode's first snapshot when the\n * primary engine's snapshot of it is clean (Chromatic's \"auto-accepted where\n * the primary browser was accepted\"); anything else goes to review as `new`.\n */\nasync function bootstrapAccepts(ctx: CaptureContext, capture: RenderedSnapshot): Promise<boolean> {\n  const browser = browserOf(capture);\n  if (!ctx.freshBrowsers?.has(browser)) return false;\n  const primary = primaryBrowser(ctx);\n  const siblings = await new SnapshotModel(ctx.db, ctx.tables).listByBuild(ctx.build.id);\n  return siblings.some(\n    (snapshot) =>\n      snapshot.storyId === capture.story.id &&\n      snapshot.viewportName === capture.viewportName &&\n      (snapshot.browser ?? DEFAULT_BROWSER) === primary &&\n      (snapshot.status === \"approved\" || snapshot.status === \"unchanged\"),\n  );\n}\n\n/** Persist one inherited snapshot; returns the story id on failure. */\nasync function tryPersistInherited(\n  ctx: CaptureContext,\n  inherited: InheritedStory,\n): Promise<string | null> {\n  try {\n    await persistInheritedSnapshot(ctx, inherited);\n    return null;\n  } catch (error) {\n    ctx.logger?.error(\n      { storyId: inherited.story.id, viewport: inherited.viewport.name, err: error },\n      \"inherit failed for story\",\n    );\n    await emitAttemptLog(ctx.recordLog, ctx.logger, \"error\", \"inherit failed for story\", {\n      storyId: inherited.story.id,\n      viewport: inherited.viewport.name,\n    });\n    return inherited.story.id;\n  }\n}\n\n/** Persist inherited snapshots; a failure marks the story failed. */\n/** Persist the inherited snapshots (stories reusing their baseline); returns the story ids that failed. */\nexport async function persistInherited(ctx: CaptureContext): Promise<ReadonlySet<string>> {\n  const outcomes = await mapLimit(ctx.inherited ?? [], PERSIST_CONCURRENCY, async (inherited) => {\n    const failed = await tryPersistInherited(ctx, inherited);\n    ctx.progress?.();\n    return failed;\n  });\n  return new Set(outcomes.filter((id): id is string => id !== null));\n}\n\n/** Create an unchanged snapshot reusing the baseline screenshot. */\nasync function persistInheritedSnapshot(\n  ctx: CaptureContext,\n  inherited: InheritedStory,\n): Promise<void> {\n  const browser = browserOf(inherited);\n  // Nothing rendered, so there is no new fingerprint: the snapshot carries the baseline's.\n  const infraHash = inherited.baseline.infraHash;\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const comparison = await freezeComparison(\n    ctx.storage,\n    ctx.project.id,\n    ctx.build.id,\n    inherited.baseline,\n    {\n      defaultBranch: ctx.project.gitDefaultBranch,\n      mode: modeJsonOf(inherited.viewport),\n      target: browser,\n      width: inherited.viewport.width,\n      height: inherited.viewport.height,\n      captureFingerprint: inherited.baseline.fingerprint ?? null,\n      sourceSnapshotId: await sourceSnapshotId(ctx.db, inherited.baseline),\n    },\n  );\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    ...comparison,\n    browser,\n    storyId: inherited.story.id,\n    storyName: inherited.story.name,\n    storyTitle: inherited.story.title,\n    storyImportPath: inherited.story.importPath ?? \"\",\n    designUrl: inherited.story.designUrl ?? null,\n    viewportName: inherited.viewport.name,\n    viewportWidth: inherited.viewport.width,\n    viewportHeight: inherited.viewport.height,\n    screenshotPath: inherited.baseline.screenshotPath,\n    infraHash,\n    mode: modeJsonOf(inherited.viewport),\n    inherited: true,\n    sourceBuildId: inherited.baseline.sourceBuildId ?? null,\n    baselineId: inherited.baseline.id,\n    baselineVersion: inherited.baseline.updatedAt,\n  });\n  await snapshots.update(snapshot.id, {\n    status: \"unchanged\",\n    diffPixels: 0,\n    diffRatio: 0,\n    diffPassed: true,\n    diffPath: null,\n    infraHash,\n  });\n}\n\n/** Every story covered by a capture run, rendered or inherited. */\nfunction allStoryIds(ctx: CaptureContext): ReadonlySet<string> {\n  const ids = new Set(ctx.captures.map((capture) => capture.story.id));\n  for (const inherited of ctx.inherited ?? []) {\n    ids.add(inherited.story.id);\n  }\n  return ids;\n}\n\n/** Table handles required by the capture pipeline. */\nexport type PipelineTables = BuildTables & BaselineTables & SnapshotTables;\n\n/** Persistence inputs for a completed capture run. */\nexport interface CaptureContext {\n  /** Database adapter. */\n  db: DatabaseAdapter;\n  /** Table handles. */\n  tables: PipelineTables;\n  /** Storage adapter. */\n  storage: StorageAdapter;\n  /** The project being captured. */\n  project: Project;\n  /** The build being captured. */\n  build: Build;\n  /** Viewports at which stories were captured. */\n  viewports: Viewport[];\n  /** Engines captured this run, primary first (default: chromium only). */\n  browsers?: string[];\n  /** Secondary engines with no baselines yet; worked out by `persistCapture`, or fixed up front by a shard plan. */\n  freshBrowsers?: ReadonlySet<string>;\n  /** Screenshot buffers produced by the capture renderer. */\n  captures: RenderedSnapshot[];\n  /** Stories inheriting their baseline without rendering (affected capture). */\n  inherited?: InheritedStory[];\n  /** Optional logger for capture diagnostics. */\n  logger?: Logger;\n  /** Optional per-attempt log recorder (mirrors logger lines into the DB). */\n  recordLog?: AttemptLogRecorder;\n  /** Called per snapshot persisted, so the job's lease sees a long diff phase making progress. */\n  progress?: CaptureProgress | undefined;\n  /** Server secret for decrypting webhook secrets at send time. */\n  secret?: SecretInput;\n}\n\n/** JSON for the snapshot `mode` column: the globals a mode applied (null for plain viewports). */\nfunction modeJsonOf(viewport: Viewport | undefined): string | null {\n  return viewport?.globals ? JSON.stringify(viewport.globals) : null;\n}\n\nfunction viewportByName(ctx: CaptureContext, name: string): Viewport {\n  return ctx.viewports.find((v) => v.name === name) ?? { name, width: 0, height: 0 };\n}\n\n/** Where the capture's screenshot lives: already stored by the orchestrator, or stored now. */\nasync function screenshotLocation(ctx: CaptureContext, capture: RenderedSnapshot): Promise<string> {\n  if (capture.storedPath) {\n    return capture.storedPath;\n  }\n  assertScreenshotBuffer(capture.screenshot);\n  return await storeScreenshot(ctx.storage, ctx.project.id, capture.screenshot);\n}\n\nasync function persistSnapshot(ctx: CaptureContext, capture: RenderedSnapshot): Promise<void> {\n  const viewport = capture.viewport ?? viewportByName(ctx, capture.viewportName);\n  const browser = browserOf(capture);\n  const screenshot = await screenshotLocation(ctx, capture);\n\n  const baseline = await resolveBaseline(ctx, capture.story.id, capture.viewportName, browser);\n  if (!baseline) {\n    await createWithoutBaseline(ctx, capture, viewport, screenshot);\n    return;\n  }\n  await createWithBaseline(ctx, capture, viewport, screenshot, baseline);\n}\n\nasync function resolveBaseline(\n  ctx: CaptureContext,\n  storyId: string,\n  viewport: string,\n  browser: string,\n): Promise<Baseline | null> {\n  const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n  return await baselines.resolve(\n    ctx.project.id,\n    storyId,\n    viewport,\n    ctx.build.gitBranch,\n    ctx.project.gitDefaultBranch,\n    browser,\n  );\n}\n\nasync function createWithoutBaseline(\n  ctx: CaptureContext,\n  capture: RenderedSnapshot,\n  viewport: Viewport,\n  screenshot: string,\n): Promise<void> {\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const browser = browserOf(capture);\n  const accepted = ctx.build.isDefault || (await bootstrapAccepts(ctx, capture));\n  const status = accepted ? \"approved\" : \"new\";\n  const now = fingerprintOf(capture, viewport);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    browser,\n    durationMs: capture.durationMs ?? null,\n    a11yViolations: a11yJsonOf(capture),\n    storyId: capture.story.id,\n    storyName: capture.story.name,\n    storyTitle: capture.story.title,\n    storyImportPath: capture.story.importPath ?? \"\",\n    designUrl: capture.story.designUrl ?? null,\n    viewportName: capture.viewportName,\n    viewportWidth: viewport.width,\n    viewportHeight: viewport.height,\n    screenshotPath: screenshot,\n    infraHash: now.infraHash,\n    mode: modeJsonOf(viewport),\n    baselineVersion: NO_BASELINE,\n  });\n  await snapshots.setStatus(snapshot.id, status);\n\n  if (accepted) {\n    const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n    await baselines.upsert(\n      ctx.project.id,\n      capture.story.id,\n      capture.viewportName,\n      ctx.build.gitBranch,\n      snapshot.id,\n      screenshot,\n      now.infraHash,\n      { mode: modeJsonOf(viewport), browser, fingerprint: now.json },\n    );\n  }\n}\n\n/** A capture's fingerprint: its components, their hash (stored as `infraHash`), and the stored JSON. */\ninterface CaptureFingerprint {\n  fingerprint: Fingerprint;\n  infraHash: string;\n  json: string;\n}\n\nfunction fingerprintOf(capture: RenderedSnapshot, viewport: Viewport): CaptureFingerprint {\n  return captureFingerprintOf(buildFingerprint(browserOf(capture), viewport, capture.environment));\n}\n\n/** A fingerprint as stored: its hash (the `infraHash`) and JSON. */\nfunction captureFingerprintOf(fingerprint: Fingerprint): CaptureFingerprint {\n  return {\n    fingerprint,\n    infraHash: fingerprintHash(fingerprint),\n    json: JSON.stringify(fingerprint),\n  };\n}\n\n/**\n * What changed in the capture environment since the baseline was recorded, or null when nothing\n * did. Compared component by component, only where both sides report a value: a capture with no\n * environment (spooled before a browser crash) is unknown, not a change. A baseline from before\n * fingerprints cannot be compared, so it is never reported as changed; it is backfilled instead.\n */\nfunction environmentChange(baseline: Baseline, now: CaptureFingerprint): EnvironmentChange | null {\n  const from = parseFingerprint(baseline.fingerprint);\n  if (!from) {\n    return null;\n  }\n  const changed = changedFields(from, now.fingerprint);\n  return changed.length > 0 ? { changed, from, to: now.fingerprint } : null;\n}\n\n/**\n * A changed environment migrates the baseline without a diff only on the default branch, which is\n * authoritative and auto-approves its own changes anyway. A feature branch still diffs: a real\n * change is reported as `changed` with the environment change attached, never auto-accepted.\n */\nasync function createWithBaseline(\n  ctx: CaptureContext,\n  capture: RenderedSnapshot,\n  viewport: Viewport,\n  screenshot: string,\n  baseline: Baseline,\n): Promise<void> {\n  const now = fingerprintOf(capture, viewport);\n  const change = environmentChange(baseline, now);\n  const comparison = await freezeComparison(ctx.storage, ctx.project.id, ctx.build.id, baseline, {\n    defaultBranch: ctx.project.gitDefaultBranch,\n    mode: modeJsonOf(viewport),\n    target: browserOf(capture),\n    width: viewport.width,\n    height: viewport.height,\n    captureFingerprint: now.json,\n    sourceSnapshotId: await sourceSnapshotId(ctx.db, baseline),\n  });\n  const input = { ctx, capture, viewport, screenshot, baseline, now, change, comparison };\n  if (change && ctx.build.isDefault) {\n    await persistMigration(input, change);\n  } else {\n    await persistDiff(input);\n  }\n}\n\ninterface BaselineCapture {\n  ctx: CaptureContext;\n  capture: RenderedSnapshot;\n  viewport: Viewport;\n  screenshot: string;\n  baseline: Baseline;\n  now: CaptureFingerprint;\n  change: EnvironmentChange | null;\n  comparison: { comparisonImagePath: string; comparisonMetadata: string };\n}\n\n/** The fingerprint to write on the baseline: the capture's, keeping components it did not report. */\nfunction baselineFingerprintOf(input: BaselineCapture): CaptureFingerprint {\n  const earlier = parseFingerprint(input.baseline.fingerprint);\n  return captureFingerprintOf(mergeFingerprint(earlier, input.now.fingerprint));\n}\n\nfunction snapshotInput(input: BaselineCapture): Parameters<SnapshotModel[\"create\"]>[2] {\n  const { capture, viewport, screenshot, baseline, now } = input;\n  return {\n    browser: browserOf(capture),\n    durationMs: capture.durationMs ?? null,\n    a11yViolations: a11yJsonOf(capture),\n    storyId: capture.story.id,\n    storyName: capture.story.name,\n    storyTitle: capture.story.title,\n    storyImportPath: capture.story.importPath ?? \"\",\n    designUrl: capture.story.designUrl ?? null,\n    viewportName: capture.viewportName,\n    viewportWidth: viewport.width,\n    viewportHeight: viewport.height,\n    screenshotPath: screenshot,\n    infraHash: now.infraHash,\n    mode: modeJsonOf(viewport),\n    baselineId: baseline.id,\n    baselineVersion: baseline.updatedAt,\n    ...input.comparison,\n  };\n}\n\n/**\n * The default branch's capture environment changed (browser build, fonts, platform, scale): pixels\n * would differ with no code change, so no diff is computed. The snapshot is accepted, records what\n * changed, and the new screenshot becomes the baseline.\n */\nasync function persistMigration(input: BaselineCapture, change: EnvironmentChange): Promise<void> {\n  const { ctx, capture, viewport, screenshot, now } = input;\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    ...snapshotInput(input),\n    envChange: JSON.stringify(change),\n  });\n  await snapshots.update(snapshot.id, {\n    status: \"unchanged\",\n    diffPath: null,\n    diffPixels: 0,\n    diffRatio: 0,\n    diffPassed: true,\n    infraHash: now.infraHash,\n  });\n  await upsertDefaultBaseline(ctx, snapshot.id, capture, screenshot, baselineFingerprintOf(input));\n  ctx.logger?.debug(\n    { storyId: capture.story.id, viewport: viewport.name, changed: change.changed },\n    \"capture environment changed; accepted without a diff\",\n  );\n}\n\n/** Diff against the baseline; a feature-branch environment change rides along as `envChange`. */\nasync function persistDiff(input: BaselineCapture): Promise<void> {\n  const { ctx, capture, screenshot, baseline, now, change } = input;\n  const result = await diffStoredScreenshots(\n    ctx.storage,\n    ctx.project,\n    baseline.screenshotPath === screenshot ? screenshot : input.comparison.comparisonImagePath,\n    screenshot,\n    capture.story.parameters?.diffThreshold,\n  );\n  const snapshots = new SnapshotModel(ctx.db, ctx.tables);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    ...snapshotInput(input),\n    ...(change ? { envChange: JSON.stringify(change) } : {}),\n  });\n  const diff = diffPath(\n    ctx.project.id,\n    ctx.build.id,\n    capture.story.id,\n    capture.viewportName,\n    browserOf(capture),\n  );\n  const overlay = await writeDiffOverlay(ctx.storage, diff, result, result.passed);\n  await snapshots.update(snapshot.id, {\n    status: diffStatus(result.passed, ctx.build.isDefault),\n    diffPath: overlay,\n    diffPixels: result.diffPixels,\n    diffRatio: result.diffRatio,\n    diffPassed: result.passed,\n    infraHash: now.infraHash,\n  });\n  if (ctx.build.isDefault) {\n    await refreshDefaultBaseline(input, snapshot.id, result.passed);\n  }\n}\n\n/**\n * After a default-branch diff: a failed diff moves the baseline to the new screenshot; a passing\n * one backfills the fingerprint when it was missing or had components the capture now reports.\n */\nasync function refreshDefaultBaseline(\n  input: BaselineCapture,\n  snapshotId: string,\n  passed: boolean,\n): Promise<void> {\n  const { ctx, capture, screenshot, baseline } = input;\n  const target = baselineFingerprintOf(input);\n  if (!passed) {\n    await upsertDefaultBaseline(ctx, snapshotId, capture, screenshot, target);\n  } else if (!baseline.fingerprint || baseline.infraHash !== target.infraHash) {\n    try {\n      await new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret).backfillFingerprint(\n        baseline,\n        target.infraHash,\n        target.json,\n      );\n    } catch (error) {\n      if (!(error instanceof BaselineWriteConflict || error instanceof ReferenceGenerationConflict))\n        throw error;\n      ctx.logger?.debug(\n        { err: error, baselineId: baseline.id },\n        \"skipped baseline fingerprint backfill after concurrent write\",\n      );\n    }\n  }\n}\n\n/** Default-branch builds are authoritative: the captured screenshot becomes the baseline. */\nasync function upsertDefaultBaseline(\n  ctx: CaptureContext,\n  snapshotId: string,\n  capture: RenderedSnapshot,\n  screenshot: string,\n  now: CaptureFingerprint,\n): Promise<void> {\n  const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n  await baselines.upsert(\n    ctx.project.id,\n    capture.story.id,\n    capture.viewportName,\n    ctx.build.gitBranch,\n    snapshotId,\n    screenshot,\n    now.infraHash,\n    { mode: modeJsonOf(capture.viewport), browser: browserOf(capture), fingerprint: now.json },\n  );\n}\n\n/** Snapshot status after diffing: default-branch changes are auto-approved, not queued for review. */\nexport function diffStatus(passed: boolean, isDefault: boolean): SnapshotStatus {\n  if (passed) {\n    return \"unchanged\";\n  }\n  return isDefault ? \"approved\" : \"changed\";\n}\n\n/** A failed capture fails the build; default-branch builds otherwise auto-approve. */\nfunction finalBuildStatus(\n  isDefault: boolean,\n  failedCount: number,\n  hasCaptures: boolean,\n  build: { changedCount: number },\n): BuildStatus {\n  if (failedCount > 0) {\n    return \"failed\";\n  }\n  if (isDefault || (hasCaptures && build.changedCount === 0)) {\n    return \"approved\";\n  }\n  return \"reviewing\";\n}\n\n/**\n * Close out a capture: roll the snapshot counts up, set the build's final status from the failed\n * story ids, and (on the default branch) drop baselines of stories that no longer exist.\n */\nexport async function finalizeBuild(\n  ctx: CaptureContext,\n  storyIds: ReadonlySet<string>,\n  failedStoryIds: ReadonlySet<string>,\n  flakyFailedStoryIds: ReadonlySet<string> = new Set(),\n  a11yFailedStoryIds: ReadonlySet<string> = new Set(),\n): Promise<void> {\n  const builds = new BuildModel(ctx.db, ctx.tables, ctx.logger);\n  if ((await builds.get(ctx.build.id))?.status === \"cancelled\") {\n    ctx.logger?.debug({ buildId: ctx.build.id }, \"build is cancelled; finalize skipped\");\n    return;\n  }\n  const build = await builds.updateCounts(ctx.build.id);\n  const hasCaptures = storyIds.size > 0;\n  const status = finalBuildStatus(ctx.build.isDefault, failedStoryIds.size, hasCaptures, build);\n  // Flaky and a11y failures do not block: log warning if any failed non-blocking\n  if (flakyFailedStoryIds.size > 0 && failedStoryIds.size === 0) {\n    ctx.logger?.warn(\n      { flakyStoryIds: [...flakyFailedStoryIds] },\n      \"flaky stories failed (non-blocking)\",\n    );\n    await emitAttemptLog(ctx.recordLog, ctx.logger, \"warn\", \"flaky stories failed (non-blocking)\", {\n      flakyStoryIds: [...flakyFailedStoryIds],\n    });\n  }\n  if (a11yFailedStoryIds.size > 0 && failedStoryIds.size === 0) {\n    ctx.logger?.warn(\n      { a11yStoryIds: [...a11yFailedStoryIds] },\n      \"a11y violations found (non-blocking)\",\n    );\n    await emitAttemptLog(\n      ctx.recordLog,\n      ctx.logger,\n      \"warn\",\n      \"a11y violations found (non-blocking)\",\n      {\n        a11yStoryIds: [...a11yFailedStoryIds],\n      },\n    );\n  }\n  await builds.setStatus(ctx.build.id, status);\n\n  if (ctx.build.isDefault && hasCaptures) {\n    const baselines = new BaselineModel(ctx.db, ctx.tables, ctx.storage, ctx.secret);\n    await baselines.removeOrphans(ctx.project.id, new Set(storyIds));\n  }\n}\n"],"mappings":"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"}

package/dist/capture/progress.d.mts

@@ -0,0 +1,9 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/**
+ * Called by a capture as it moves: a screenshot taken, a snapshot persisted, a stage done. Cheap
+ * and synchronous, so the hot loops of render and persist can call it on every item.
+ */
+type CaptureProgress = () => void;
+export { CaptureProgress };
+//# sourceMappingURL=progress.d.mts.map

package/dist/capture/progress.mjs

@@ -0,0 +1,27 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/capture/progress.ts
+/** Shortest gap between two lease touches: a forked child sends one IPC message per touch. */
+const PROGRESS_THROTTLE_MS = 1e3;
+/**
+* The progress callback for a job: touches its lease, at most once per `everyMs`. The first call
+* always goes through. Undefined without a lease, so callers skip the work entirely.
+*
+* Liveness comes from the job reporting work done rather than from a timer, so a hung render or
+* diff still lets the lease expire (see {@link JobLease}).
+*/
+function leaseProgress(lease, everyMs = PROGRESS_THROTTLE_MS, now = Date.now) {
+	if (!lease) return;
+	let last = Number.NEGATIVE_INFINITY;
+	return () => {
+		const at = now();
+		if (at - last >= everyMs) {
+			last = at;
+			lease.touch();
+		}
+	};
+}
+export { PROGRESS_THROTTLE_MS, leaseProgress };
+
+//# sourceMappingURL=progress.mjs.map

package/dist/capture/progress.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.mjs","names":[],"sources":["../../src/capture/progress.ts"],"sourcesContent":["/** Progress reporting for a running capture job, kept apart from its logging. */\nimport type { JobLease } from \"./job-lease.ts\";\n\n/**\n * Called by a capture as it moves: a screenshot taken, a snapshot persisted, a stage done. Cheap\n * and synchronous, so the hot loops of render and persist can call it on every item.\n */\nexport type CaptureProgress = () => void;\n\n/** Shortest gap between two lease touches: a forked child sends one IPC message per touch. */\nexport const PROGRESS_THROTTLE_MS = 1000;\n\n/**\n * The progress callback for a job: touches its lease, at most once per `everyMs`. The first call\n * always goes through. Undefined without a lease, so callers skip the work entirely.\n *\n * Liveness comes from the job reporting work done rather than from a timer, so a hung render or\n * diff still lets the lease expire (see {@link JobLease}).\n */\nexport function leaseProgress(\n  lease?: JobLease,\n  everyMs: number = PROGRESS_THROTTLE_MS,\n  now: () => number = Date.now,\n): CaptureProgress | undefined {\n  if (!lease) {\n    return undefined;\n  }\n  let last = Number.NEGATIVE_INFINITY;\n  return () => {\n    const at = now();\n    if (at - last >= everyMs) {\n      last = at;\n      lease.touch();\n    }\n  };\n}\n"],"mappings":";;;;;AAUA,MAAa,uBAAuB;;;;;;;;AASpC,SAAgB,cACd,OACA,UAAkB,sBAClB,MAAoB,KAAK,KACI;CAC7B,IAAI,CAAC,OACH;CAEF,IAAI,OAAO,OAAO;CAClB,aAAa;EACX,MAAM,KAAK,IAAI;EACf,IAAI,KAAK,QAAQ,SAAS;GACxB,OAAO;GACP,MAAM,MAAM;EACd;CACF;AACF"}

package/dist/capture/publish/accept.d.mts

@@ -0,0 +1,37 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/**
+ * The one rule for when publishing accepts a build (ADR 0006, decision 2). Pure: callers read the
+ * facts, apply the verdict, and stay free of branching.
+ */
+/** Facts the verdict depends on. */
+interface PublishFacts {
+  /** Whether publishing succeeded. */
+  published: boolean;
+  /** Whether a capture will run for this build (`testing` is on); capture then owns the status. */
+  captureWillRun: boolean;
+  /** Whether the build is on the project's default branch. */
+  defaultBranch: boolean;
+  /** The project's review switch (`projects.review_enabled`, ADR 0013, decision 1). */
+  reviewEnabled: boolean;
+  /** The build's status right now. */
+  status: string;
+}
+/**
+ * What publishing does to the build's status.
+ *
+ * - A capture will run: `unchanged`, the capture sets the status.
+ * - Not `pending` any more (already accepted, failed, cancelled or reviewed): `unchanged`, so a repeated
+ *   publish (job redelivery after a lost lease) changes nothing.
+ * - Publish failed: `failed`.
+ * - Published on the default branch: `approved`, whatever the review switch says.
+ * - Published on another branch with review off: `approved`, nobody will sign it off.
+ * - Published on another branch with review on: `unchanged`, the build waits as `pending` for a
+ *   build-level verdict (ADR 0013, decision 3).
+ *
+ * Accepting here is not an approval: no event, webhook or notification (`build:created` announced
+ * the upload), so nothing is asked of a reviewer and nothing is reported as one.
+ */
+declare function publishVerdict(facts: PublishFacts): "approved" | "failed" | "unchanged";
+export { PublishFacts, publishVerdict };
+//# sourceMappingURL=accept.d.mts.map

package/dist/capture/publish/accept.mjs

@@ -0,0 +1,27 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/capture/publish/accept.ts
+/**
+* What publishing does to the build's status.
+*
+* - A capture will run: `unchanged`, the capture sets the status.
+* - Not `pending` any more (already accepted, failed, cancelled or reviewed): `unchanged`, so a repeated
+*   publish (job redelivery after a lost lease) changes nothing.
+* - Publish failed: `failed`.
+* - Published on the default branch: `approved`, whatever the review switch says.
+* - Published on another branch with review off: `approved`, nobody will sign it off.
+* - Published on another branch with review on: `unchanged`, the build waits as `pending` for a
+*   build-level verdict (ADR 0013, decision 3).
+*
+* Accepting here is not an approval: no event, webhook or notification (`build:created` announced
+* the upload), so nothing is asked of a reviewer and nothing is reported as one.
+*/
+function publishVerdict(facts) {
+	if (facts.captureWillRun || facts.status !== "pending") return "unchanged";
+	if (!facts.published) return "failed";
+	return facts.defaultBranch || !facts.reviewEnabled ? "approved" : "unchanged";
+}
+export { publishVerdict };
+
+//# sourceMappingURL=accept.mjs.map

package/dist/capture/publish/accept.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept.mjs","names":[],"sources":["../../../src/capture/publish/accept.ts"],"sourcesContent":["/**\n * The one rule for when publishing accepts a build (ADR 0006, decision 2). Pure: callers read the\n * facts, apply the verdict, and stay free of branching.\n */\n\n/** Facts the verdict depends on. */\nexport interface PublishFacts {\n  /** Whether publishing succeeded. */\n  published: boolean;\n  /** Whether a capture will run for this build (`testing` is on); capture then owns the status. */\n  captureWillRun: boolean;\n  /** Whether the build is on the project's default branch. */\n  defaultBranch: boolean;\n  /** The project's review switch (`projects.review_enabled`, ADR 0013, decision 1). */\n  reviewEnabled: boolean;\n  /** The build's status right now. */\n  status: string;\n}\n\n/**\n * What publishing does to the build's status.\n *\n * - A capture will run: `unchanged`, the capture sets the status.\n * - Not `pending` any more (already accepted, failed, cancelled or reviewed): `unchanged`, so a repeated\n *   publish (job redelivery after a lost lease) changes nothing.\n * - Publish failed: `failed`.\n * - Published on the default branch: `approved`, whatever the review switch says.\n * - Published on another branch with review off: `approved`, nobody will sign it off.\n * - Published on another branch with review on: `unchanged`, the build waits as `pending` for a\n *   build-level verdict (ADR 0013, decision 3).\n *\n * Accepting here is not an approval: no event, webhook or notification (`build:created` announced\n * the upload), so nothing is asked of a reviewer and nothing is reported as one.\n */\nexport function publishVerdict(facts: PublishFacts): \"approved\" | \"failed\" | \"unchanged\" {\n  if (facts.captureWillRun || facts.status !== \"pending\") {\n    return \"unchanged\";\n  }\n  if (!facts.published) {\n    return \"failed\";\n  }\n  return facts.defaultBranch || !facts.reviewEnabled ? \"approved\" : \"unchanged\";\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,eAAe,OAA0D;CACvF,IAAI,MAAM,kBAAkB,MAAM,WAAW,WAC3C,OAAO;CAET,IAAI,CAAC,MAAM,WACT,OAAO;CAET,OAAO,MAAM,iBAAiB,CAAC,MAAM,gBAAgB,aAAa;AACpE"}

package/dist/capture/publish/complete.d.mts

@@ -0,0 +1,44 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Logger } from "../../logger.mjs";
+import { DatabaseAdapter } from "../../adapter/database.mjs";
+import { Build } from "../../schema/build.mjs";
+import { Project } from "../../schema/project.mjs";
+/** How publishing ended. */
+type PublishOutcome = {
+  ok: true;
+} | {
+  ok: false;
+  error: string;
+};
+/** What an `afterPublish` hook is given. */
+interface AfterPublishContext {
+  /** The build as it is after the verdict was applied. */
+  build: Build;
+  project: Project;
+  outcome: PublishOutcome;
+  logger: Logger;
+}
+/** Runs once per finished publish (extension point of the catalog). Failures are logged, never thrown on. */
+type AfterPublishHook = (context: AfterPublishContext) => Promise<void>;
+/** Finishes a build's publishing. */
+interface PublishCompleter {
+  /**
+   * Record the end of a build's publishing. Resolves to the build, or null when it is gone.
+   * Safe to repeat: a build that left `pending` keeps its status.
+   */
+  complete(buildId: string, outcome: PublishOutcome): Promise<Build | null>;
+}
+/** What {@link createPublishCompleter} needs. */
+interface PublishCompleterOptions {
+  db: DatabaseAdapter;
+  /** Whether a capture runs for uploads (`testing`); capture then owns the build status. */
+  captureWillRun: boolean;
+  /** Hooks, read on every call so later registrations count. */
+  afterPublish: readonly AfterPublishHook[];
+  logger: Logger;
+}
+/** A completer over `options.db`. */
+declare function createPublishCompleter(options: PublishCompleterOptions): PublishCompleter;
+export { AfterPublishContext, AfterPublishHook, PublishCompleter, PublishCompleterOptions, PublishOutcome, createPublishCompleter };
+//# sourceMappingURL=complete.d.mts.map

package/dist/capture/publish/complete.mjs

@@ -0,0 +1,63 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { BuildModel } from "../../models/build.mjs";
+import { ProjectModel } from "../../models/project.mjs";
+import { publishVerdict } from "./accept.mjs";
+// src/capture/publish/complete.ts
+/** A completer over `options.db`. */
+function createPublishCompleter(options) {
+	return { complete: async (buildId, outcome) => {
+		const target = await load(options.db, buildId);
+		if (!target) {
+			options.logger.warn({ buildId }, "build is gone; nothing to complete");
+			return null;
+		}
+		const build = await applyVerdict(options, target.build, target.project, outcome);
+		await runHooks(options, {
+			build,
+			project: target.project,
+			outcome
+		});
+		return build;
+	} };
+}
+async function load(db, buildId) {
+	const build = await new BuildModel(db).get(buildId);
+	const project = build ? await new ProjectModel(db).get(build.projectId) : null;
+	return build && project ? {
+		build,
+		project
+	} : null;
+}
+/** Move the build per the rule. No approval event or webhook: `build:created` announced the upload. */
+async function applyVerdict(options, build, project, outcome) {
+	const verdict = publishVerdict({
+		published: outcome.ok,
+		captureWillRun: options.captureWillRun,
+		defaultBranch: build.gitBranch === project.gitDefaultBranch,
+		reviewEnabled: project.reviewEnabled !== false,
+		status: build.status
+	});
+	if (!outcome.ok) options.logger.error({
+		buildId: build.id,
+		error: outcome.error,
+		verdict
+	}, "publish failed");
+	if (verdict === "unchanged") return build;
+	return await new BuildModel(options.db).setStatus(build.id, verdict);
+}
+async function runHooks(options, context) {
+	const logger = options.logger.child({ buildId: context.build.id });
+	for (const hook of options.afterPublish) try {
+		await hook({
+			...context,
+			logger
+		});
+	} catch (error) {
+		logger.error({ err: error }, "afterPublish hook failed");
+	}
+}
+export { createPublishCompleter };
+
+//# sourceMappingURL=complete.mjs.map

package/dist/capture/publish/complete.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete.mjs","names":[],"sources":["../../../src/capture/publish/complete.ts"],"sourcesContent":["/**\n * Publishing's end: apply {@link publishVerdict} to the build and run the `afterPublish` hooks.\n * Every publish route (inline zip, `publish` job, file-by-file manifest) ends here, so this is the\n * single owner of the acceptance rule.\n */\nimport type { DatabaseAdapter } from \"../../adapters/database.ts\";\nimport type { Logger } from \"../../logger.ts\";\nimport { BuildModel } from \"../../models/build.ts\";\nimport { ProjectModel } from \"../../models/project.ts\";\nimport type { Build } from \"../../schema/build.ts\";\nimport type { Project } from \"../../schema/project.ts\";\nimport { publishVerdict } from \"./accept.ts\";\n\n/** How publishing ended. */\nexport type PublishOutcome = { ok: true } | { ok: false; error: string };\n\n/** What an `afterPublish` hook is given. */\nexport interface AfterPublishContext {\n  /** The build as it is after the verdict was applied. */\n  build: Build;\n  project: Project;\n  outcome: PublishOutcome;\n  logger: Logger;\n}\n\n/** Runs once per finished publish (extension point of the catalog). Failures are logged, never thrown on. */\nexport type AfterPublishHook = (context: AfterPublishContext) => Promise<void>;\n\n/** Finishes a build's publishing. */\nexport interface PublishCompleter {\n  /**\n   * Record the end of a build's publishing. Resolves to the build, or null when it is gone.\n   * Safe to repeat: a build that left `pending` keeps its status.\n   */\n  complete(buildId: string, outcome: PublishOutcome): Promise<Build | null>;\n}\n\n/** What {@link createPublishCompleter} needs. */\nexport interface PublishCompleterOptions {\n  db: DatabaseAdapter;\n  /** Whether a capture runs for uploads (`testing`); capture then owns the build status. */\n  captureWillRun: boolean;\n  /** Hooks, read on every call so later registrations count. */\n  afterPublish: readonly AfterPublishHook[];\n  logger: Logger;\n}\n\n/** A completer over `options.db`. */\nexport function createPublishCompleter(options: PublishCompleterOptions): PublishCompleter {\n  return {\n    complete: async (buildId, outcome) => {\n      const target = await load(options.db, buildId);\n      if (!target) {\n        options.logger.warn({ buildId }, \"build is gone; nothing to complete\");\n        return null;\n      }\n      const build = await applyVerdict(options, target.build, target.project, outcome);\n      await runHooks(options, { build, project: target.project, outcome });\n      return build;\n    },\n  };\n}\n\nasync function load(\n  db: DatabaseAdapter,\n  buildId: string,\n): Promise<{ build: Build; project: Project } | null> {\n  const build = await new BuildModel(db).get(buildId);\n  const project = build ? await new ProjectModel(db).get(build.projectId) : null;\n  return build && project ? { build, project } : null;\n}\n\n/** Move the build per the rule. No approval event or webhook: `build:created` announced the upload. */\nasync function applyVerdict(\n  options: PublishCompleterOptions,\n  build: Build,\n  project: Project,\n  outcome: PublishOutcome,\n): Promise<Build> {\n  const verdict = publishVerdict({\n    published: outcome.ok,\n    captureWillRun: options.captureWillRun,\n    defaultBranch: build.gitBranch === project.gitDefaultBranch,\n    reviewEnabled: project.reviewEnabled !== false,\n    status: build.status,\n  });\n  if (!outcome.ok) {\n    options.logger.error({ buildId: build.id, error: outcome.error, verdict }, \"publish failed\");\n  }\n  if (verdict === \"unchanged\") {\n    return build;\n  }\n  return await new BuildModel(options.db).setStatus(build.id, verdict);\n}\n\nasync function runHooks(\n  options: PublishCompleterOptions,\n  context: Omit<AfterPublishContext, \"logger\">,\n): Promise<void> {\n  const logger = options.logger.child({ buildId: context.build.id });\n  for (const hook of options.afterPublish) {\n    try {\n      // eslint-disable-next-line no-await-in-loop -- hooks run in registration order\n      await hook({ ...context, logger });\n    } catch (error) {\n      logger.error({ err: error }, \"afterPublish hook failed\");\n    }\n  }\n}\n"],"mappings":";;;;;;;;AAgDA,SAAgB,uBAAuB,SAAoD;CACzF,OAAO,EACL,UAAU,OAAO,SAAS,YAAY;EACpC,MAAM,SAAS,MAAM,KAAK,QAAQ,IAAI,OAAO;EAC7C,IAAI,CAAC,QAAQ;GACX,QAAQ,OAAO,KAAK,EAAE,QAAQ,GAAG,oCAAoC;GACrE,OAAO;EACT;EACA,MAAM,QAAQ,MAAM,aAAa,SAAS,OAAO,OAAO,OAAO,SAAS,OAAO;EAC/E,MAAM,SAAS,SAAS;GAAE;GAAO,SAAS,OAAO;GAAS;EAAQ,CAAC;EACnE,OAAO;CACT,EACF;AACF;AAEA,eAAe,KACb,IACA,SACoD;CACpD,MAAM,QAAQ,MAAM,IAAI,WAAW,EAAE,CAAC,CAAC,IAAI,OAAO;CAClD,MAAM,UAAU,QAAQ,MAAM,IAAI,aAAa,EAAE,CAAC,CAAC,IAAI,MAAM,SAAS,IAAI;CAC1E,OAAO,SAAS,UAAU;EAAE;EAAO;CAAQ,IAAI;AACjD;;AAGA,eAAe,aACb,SACA,OACA,SACA,SACgB;CAChB,MAAM,UAAU,eAAe;EAC7B,WAAW,QAAQ;EACnB,gBAAgB,QAAQ;EACxB,eAAe,MAAM,cAAc,QAAQ;EAC3C,eAAe,QAAQ,kBAAkB;EACzC,QAAQ,MAAM;CAChB,CAAC;CACD,IAAI,CAAC,QAAQ,IACX,QAAQ,OAAO,MAAM;EAAE,SAAS,MAAM;EAAI,OAAO,QAAQ;EAAO;CAAQ,GAAG,gBAAgB;CAE7F,IAAI,YAAY,aACd,OAAO;CAET,OAAO,MAAM,IAAI,WAAW,QAAQ,EAAE,CAAC,CAAC,UAAU,MAAM,IAAI,OAAO;AACrE;AAEA,eAAe,SACb,SACA,SACe;CACf,MAAM,SAAS,QAAQ,OAAO,MAAM,EAAE,SAAS,QAAQ,MAAM,GAAG,CAAC;CACjE,KAAK,MAAM,QAAQ,QAAQ,cACzB,IAAI;EAEF,MAAM,KAAK;GAAE,GAAG;GAAS;EAAO,CAAC;CACnC,SAAS,OAAO;EACd,OAAO,MAAM,EAAE,KAAK,MAAM,GAAG,0BAA0B;CACzD;AAEJ"}

package/dist/capture/publish/extract.d.mts

@@ -0,0 +1,18 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ExtractionLimits } from "./limits.mjs";
+import { Readable } from "node:stream";
+/** What an extraction produced. */
+interface ExtractionResult {
+  entries: number;
+  bytes: number;
+}
+/**
+ * Extract `source` (a zip stream) under `root`, which must exist.
+ *
+ * @throws {ZipLimitError} When a cap is exceeded or an entry path escapes `root`; the source is
+ *   destroyed at once, and the files written so far are left for the caller's scratch cleanup.
+ */
+declare function extractZipStream(source: Readable, root: string, limits: ExtractionLimits): Promise<ExtractionResult>;
+export { ExtractionResult, extractZipStream };
+//# sourceMappingURL=extract.d.mts.map

package/dist/capture/publish/extract.mjs

@@ -0,0 +1,120 @@
+import { dirname, isAbsolute, join, resolve, sep } from "node:path";
+import "node:url";
+import.meta.url;
+import { ZipInvalidError } from "./invalid-zip.mjs";
+import { ZipLimitError } from "./limits.mjs";
+import { mkdir } from "node:fs/promises";
+import { createWriteStream } from "node:fs";
+import { Transform } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { Parse } from "unzipper";
+// src/capture/publish/extract.ts
+/**
+* Streaming, capped extraction of an uploaded Storybook zip into a directory. Entry count and
+* uncompressed bytes are counted while the archive streams (never from a header or from
+* `Content-Length`), and a path that leaves the target is refused.
+*/
+/**
+* Extract `source` (a zip stream) under `root`, which must exist.
+*
+* @throws {ZipLimitError} When a cap is exceeded or an entry path escapes `root`; the source is
+*   destroyed at once, and the files written so far are left for the caller's scratch cleanup.
+*/
+async function extractZipStream(source, root, limits) {
+	const run = new Extraction(resolve(root), limits);
+	const failure = await run.parse(source);
+	const outcomes = await Promise.allSettled(run.writes);
+	if (failure) throw failure;
+	const writeError = outcomes.find((outcome) => outcome.status === "rejected");
+	if (writeError) throw writeError.reason;
+	return {
+		entries: run.entries,
+		bytes: run.bytes
+	};
+}
+function ignore() {}
+/** State of one extraction. */
+var Extraction = class {
+	entries = 0;
+	bytes = 0;
+	writes = [];
+	root;
+	limits;
+	#failed = false;
+	#fail = ignore;
+	constructor(root, limits) {
+		this.root = root;
+		this.limits = limits;
+	}
+	/** Resolves with the first failure, or null once the archive was read to its end. */
+	parse(source) {
+		return new Promise((settle) => {
+			const parser = Parse();
+			this.#fail = (error) => {
+				if (!this.#failed) {
+					this.#failed = true;
+					source.destroy();
+					parser.destroy();
+					settle(error);
+				}
+			};
+			parser.on("entry", (entry) => {
+				this.#entry(entry);
+			});
+			parser.on("error", () => {
+				this.#fail(new ZipInvalidError("Invalid Storybook zip"));
+			});
+			parser.on("close", () => {
+				settle(null);
+			});
+			source.on("error", this.#fail);
+			source.pipe(parser);
+		});
+	}
+	#entry(entry) {
+		this.entries += 1;
+		const problem = this.#problemWith(entry);
+		if (problem) this.#fail(problem);
+		if (this.#failed || entry.type === "Directory") {
+			entry.autodrain();
+			return;
+		}
+		this.#write(entry);
+	}
+	#problemWith(entry) {
+		if (this.entries > this.limits.maxEntries) return new ZipLimitError(`Zip holds more than ${this.limits.maxEntries} entries`);
+		if (unsafePath(this.root, entry.path)) return new ZipLimitError(`Blocked path traversal in uploaded Storybook: ${entry.path}`);
+		return null;
+	}
+	#write(entry) {
+		const target = join(this.root, entry.path);
+		const done = (async () => {
+			await mkdir(dirname(target), { recursive: true });
+			await pipeline(entry, this.#counter(), createWriteStream(target));
+		})();
+		this.writes.push(done);
+		done.catch(ignore);
+	}
+	/** Counts the bytes that pass; past the cap the whole extraction fails at once. */
+	#counter() {
+		return new Transform({ transform: (chunk, _encoding, callback) => {
+			this.bytes += chunk.length;
+			if (this.bytes > this.limits.maxBytes) {
+				const error = new ZipLimitError(`Zip expands beyond ${this.limits.maxBytes} bytes`);
+				this.#fail(error);
+				callback(error);
+				return;
+			}
+			callback(null, chunk);
+		} });
+	}
+};
+/** Absolute paths, drive letters and anything resolving outside `root`. */
+function unsafePath(root, entryPath) {
+	if (isAbsolute(entryPath) || /^[a-zA-Z]:/u.test(entryPath)) return true;
+	const candidate = resolve(join(root, entryPath));
+	return candidate !== root && !candidate.startsWith(root + sep);
+}
+export { extractZipStream };
+
+//# sourceMappingURL=extract.mjs.map

package/dist/capture/publish/extract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.mjs","names":[],"sources":["../../../src/capture/publish/extract.ts"],"sourcesContent":["/**\n * Streaming, capped extraction of an uploaded Storybook zip into a directory. Entry count and\n * uncompressed bytes are counted while the archive streams (never from a header or from\n * `Content-Length`), and a path that leaves the target is refused.\n */\nimport { createWriteStream } from \"node:fs\";\nimport { mkdir } from \"node:fs/promises\";\nimport { dirname, isAbsolute, join, resolve, sep } from \"node:path\";\nimport { Transform, type Readable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport { Parse, type Entry } from \"unzipper\";\nimport { ZipInvalidError } from \"./invalid-zip.ts\";\nimport { ZipLimitError, type ExtractionLimits } from \"./limits.ts\";\n\n/** What an extraction produced. */\nexport interface ExtractionResult {\n  entries: number;\n  bytes: number;\n}\n\n/**\n * Extract `source` (a zip stream) under `root`, which must exist.\n *\n * @throws {ZipLimitError} When a cap is exceeded or an entry path escapes `root`; the source is\n *   destroyed at once, and the files written so far are left for the caller's scratch cleanup.\n */\nexport async function extractZipStream(\n  source: Readable,\n  root: string,\n  limits: ExtractionLimits,\n): Promise<ExtractionResult> {\n  const run = new Extraction(resolve(root), limits);\n  const failure = await run.parse(source);\n  // Writes may still be in flight after a failure; settle them before anyone removes the files.\n  const outcomes = await Promise.allSettled(run.writes);\n  if (failure) {\n    throw failure;\n  }\n  const writeError = outcomes.find(\n    (outcome): outcome is PromiseRejectedResult => outcome.status === \"rejected\",\n  );\n  if (writeError) {\n    throw writeError.reason;\n  }\n  return { entries: run.entries, bytes: run.bytes };\n}\n\nfunction ignore(): void {}\n\n/** State of one extraction. */\nclass Extraction {\n  entries = 0;\n  bytes = 0;\n  readonly writes: Promise<void>[] = [];\n  readonly root: string;\n  readonly limits: ExtractionLimits;\n  #failed = false;\n  #fail: (error: unknown) => void = ignore;\n\n  constructor(root: string, limits: ExtractionLimits) {\n    this.root = root;\n    this.limits = limits;\n  }\n\n  /** Resolves with the first failure, or null once the archive was read to its end. */\n  // oxlint-disable-next-line typescript/promise-function-async -- executor-style wrapper around stream events\n  parse(source: Readable): Promise<unknown> {\n    return new Promise((settle) => {\n      const parser = Parse();\n      this.#fail = (error: unknown): void => {\n        if (!this.#failed) {\n          this.#failed = true;\n          source.destroy();\n          parser.destroy();\n          settle(error);\n        }\n      };\n      parser.on(\"entry\", (entry: Entry) => {\n        this.#entry(entry);\n      });\n      parser.on(\"error\", () => {\n        this.#fail(new ZipInvalidError(\"Invalid Storybook zip\"));\n      });\n      parser.on(\"close\", () => {\n        settle(null);\n      });\n      source.on(\"error\", this.#fail);\n      source.pipe(parser);\n    });\n  }\n\n  #entry(entry: Entry): void {\n    this.entries += 1;\n    const problem = this.#problemWith(entry);\n    if (problem) {\n      this.#fail(problem);\n    }\n    if (this.#failed || entry.type === \"Directory\") {\n      entry.autodrain();\n      return;\n    }\n    this.#write(entry);\n  }\n\n  #problemWith(entry: Entry): ZipLimitError | null {\n    if (this.entries > this.limits.maxEntries) {\n      return new ZipLimitError(`Zip holds more than ${this.limits.maxEntries} entries`);\n    }\n    if (unsafePath(this.root, entry.path)) {\n      return new ZipLimitError(`Blocked path traversal in uploaded Storybook: ${entry.path}`);\n    }\n    return null;\n  }\n\n  #write(entry: Entry): void {\n    const target = join(this.root, entry.path);\n    const done = (async (): Promise<void> => {\n      await mkdir(dirname(target), { recursive: true });\n      await pipeline(entry, this.#counter(), createWriteStream(target));\n    })();\n    this.writes.push(done);\n    done.catch(ignore); // Aggregated through allSettled by the caller\n  }\n\n  /** Counts the bytes that pass; past the cap the whole extraction fails at once. */\n  #counter(): Transform {\n    return new Transform({\n      transform: (chunk: Buffer, _encoding, callback) => {\n        this.bytes += chunk.length;\n        if (this.bytes > this.limits.maxBytes) {\n          const error = new ZipLimitError(`Zip expands beyond ${this.limits.maxBytes} bytes`);\n          this.#fail(error);\n          callback(error);\n          return;\n        }\n        callback(null, chunk);\n      },\n    });\n  }\n}\n\n/** Absolute paths, drive letters and anything resolving outside `root`. */\nfunction unsafePath(root: string, entryPath: string): boolean {\n  if (isAbsolute(entryPath) || /^[a-zA-Z]:/u.test(entryPath)) {\n    return true;\n  }\n  const candidate = resolve(join(root, entryPath));\n  return candidate !== root && !candidate.startsWith(root + sep);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA0BA,eAAsB,iBACpB,QACA,MACA,QAC2B;CAC3B,MAAM,MAAM,IAAI,WAAW,QAAQ,IAAI,GAAG,MAAM;CAChD,MAAM,UAAU,MAAM,IAAI,MAAM,MAAM;CAEtC,MAAM,WAAW,MAAM,QAAQ,WAAW,IAAI,MAAM;CACpD,IAAI,SACF,MAAM;CAER,MAAM,aAAa,SAAS,MACzB,YAA8C,QAAQ,WAAW,UACpE;CACA,IAAI,YACF,MAAM,WAAW;CAEnB,OAAO;EAAE,SAAS,IAAI;EAAS,OAAO,IAAI;CAAM;AAClD;AAEA,SAAS,SAAe,CAAC;;AAGzB,IAAM,aAAN,MAAiB;CACf,UAAU;CACV,QAAQ;CACR,SAAmC,CAAC;CACpC;CACA;CACA,UAAU;CACV,QAAkC;CAElC,YAAY,MAAc,QAA0B;EAClD,KAAK,OAAO;EACZ,KAAK,SAAS;CAChB;;CAIA,MAAM,QAAoC;EACxC,OAAO,IAAI,SAAS,WAAW;GAC7B,MAAM,SAAS,MAAM;GACrB,KAAK,SAAS,UAAyB;IACrC,IAAI,CAAC,KAAK,SAAS;KACjB,KAAK,UAAU;KACf,OAAO,QAAQ;KACf,OAAO,QAAQ;KACf,OAAO,KAAK;IACd;GACF;GACA,OAAO,GAAG,UAAU,UAAiB;IACnC,KAAK,OAAO,KAAK;GACnB,CAAC;GACD,OAAO,GAAG,eAAe;IACvB,KAAK,MAAM,IAAI,gBAAgB,uBAAuB,CAAC;GACzD,CAAC;GACD,OAAO,GAAG,eAAe;IACvB,OAAO,IAAI;GACb,CAAC;GACD,OAAO,GAAG,SAAS,KAAK,KAAK;GAC7B,OAAO,KAAK,MAAM;EACpB,CAAC;CACH;CAEA,OAAO,OAAoB;EACzB,KAAK,WAAW;EAChB,MAAM,UAAU,KAAK,aAAa,KAAK;EACvC,IAAI,SACF,KAAK,MAAM,OAAO;EAEpB,IAAI,KAAK,WAAW,MAAM,SAAS,aAAa;GAC9C,MAAM,UAAU;GAChB;EACF;EACA,KAAK,OAAO,KAAK;CACnB;CAEA,aAAa,OAAoC;EAC/C,IAAI,KAAK,UAAU,KAAK,OAAO,YAC7B,OAAO,IAAI,cAAc,uBAAuB,KAAK,OAAO,WAAW,SAAS;EAElF,IAAI,WAAW,KAAK,MAAM,MAAM,IAAI,GAClC,OAAO,IAAI,cAAc,iDAAiD,MAAM,MAAM;EAExF,OAAO;CACT;CAEA,OAAO,OAAoB;EACzB,MAAM,SAAS,KAAK,KAAK,MAAM,MAAM,IAAI;EACzC,MAAM,QAAQ,YAA2B;GACvC,MAAM,MAAM,QAAQ,MAAM,GAAG,EAAE,WAAW,KAAK,CAAC;GAChD,MAAM,SAAS,OAAO,KAAK,SAAS,GAAG,kBAAkB,MAAM,CAAC;EAClE,EAAA,CAAG;EACH,KAAK,OAAO,KAAK,IAAI;EACrB,KAAK,MAAM,MAAM;CACnB;;CAGA,WAAsB;EACpB,OAAO,IAAI,UAAU,EACnB,YAAY,OAAe,WAAW,aAAa;GACjD,KAAK,SAAS,MAAM;GACpB,IAAI,KAAK,QAAQ,KAAK,OAAO,UAAU;IACrC,MAAM,QAAQ,IAAI,cAAc,sBAAsB,KAAK,OAAO,SAAS,OAAO;IAClF,KAAK,MAAM,KAAK;IAChB,SAAS,KAAK;IACd;GACF;GACA,SAAS,MAAM,KAAK;EACtB,EACF,CAAC;CACH;AACF;;AAGA,SAAS,WAAW,MAAc,WAA4B;CAC5D,IAAI,WAAW,SAAS,KAAK,cAAc,KAAK,SAAS,GACvD,OAAO;CAET,MAAM,YAAY,QAAQ,KAAK,MAAM,SAAS,CAAC;CAC/C,OAAO,cAAc,QAAQ,CAAC,UAAU,WAAW,OAAO,GAAG;AAC/D"}

package/dist/capture/publish/handler.d.mts

@@ -0,0 +1,26 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Logger } from "../../logger.mjs";
+import { DatabaseAdapter } from "../../adapter/database.mjs";
+import { StorageAdapter } from "../../adapter/storage.mjs";
+import { ExtractionLimits } from "./limits.mjs";
+import { KindHandler } from "../consumer/types.mjs";
+import { PublishCompleter } from "./complete.mjs";
+/** What {@link createPublishHandler} needs. */
+interface PublishHandlerOptions {
+  db: DatabaseAdapter;
+  storage: StorageAdapter;
+  scratchDir: string;
+  limits: ExtractionLimits;
+  completer: PublishCompleter;
+  logger: Logger;
+}
+/**
+ * The handler. Resolving acks the job. A zip that breaks a cap is a final answer (retrying cannot
+ * help): the build is failed and the job acked. Any other error is retried by the consumer, and
+ * the build is failed on the last attempt. A redelivery after a lost lease repeats the extraction
+ * (same keys) and leaves an already accepted build alone.
+ */
+declare function createPublishHandler(options: PublishHandlerOptions): KindHandler;
+export { PublishHandlerOptions, createPublishHandler };
+//# sourceMappingURL=handler.d.mts.map

package/dist/capture/publish/handler.mjs

@@ -0,0 +1,61 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { BuildModel } from "../../models/build.mjs";
+import { ZipLimitError } from "./limits.mjs";
+import { publishStoredZip } from "./run.mjs";
+// src/capture/publish/handler.ts
+/** A `publish` job needs the build to publish. */
+function hasBuild(job) {
+	return typeof job.buildId === "string" && job.buildId.length > 0;
+}
+/**
+* The handler. Resolving acks the job. A zip that breaks a cap is a final answer (retrying cannot
+* help): the build is failed and the job acked. Any other error is retried by the consumer, and
+* the build is failed on the last attempt. A redelivery after a lost lease repeats the extraction
+* (same keys) and leaves an already accepted build alone.
+*/
+function createPublishHandler(options) {
+	return {
+		accepts: hasBuild,
+		run: async (job, context) => {
+			const build = await new BuildModel(options.db).get(job.buildId);
+			if (!build) {
+				context.logger.warn("build is gone; dropping publish job");
+				return;
+			}
+			await publishOnce(options, job, context, build.projectId);
+		}
+	};
+}
+async function publishOnce(options, job, context, projectId) {
+	const { completer, storage, scratchDir, limits, db } = options;
+	try {
+		await publishStoredZip({
+			storage,
+			scratchDir,
+			limits,
+			db,
+			logger: context.logger,
+			touch: context.touch
+		}, {
+			projectId,
+			buildId: job.buildId
+		});
+	} catch (error) {
+		const permanent = error instanceof ZipLimitError;
+		if (permanent || (job.attempt ?? 1) >= (job.maxAttempts ?? 1)) await completer.complete(job.buildId, {
+			ok: false,
+			error: messageOf(error)
+		});
+		if (permanent) return;
+		throw error;
+	}
+	await completer.complete(job.buildId, { ok: true });
+}
+function messageOf(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+export { createPublishHandler };
+
+//# sourceMappingURL=handler.mjs.map