@storyshelf/core 0.7.0 → 0.8.0

package/dist/retention.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"retention.mjs","names":[],"sources":["../src/retention/purge.ts"],"sourcesContent":["import { and, desc, eq, inArray, lt } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { Logger } from \"pino\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { BaselineModel } from \"../models/baseline.ts\";\nimport { BuildComponentModel } from \"../models/build-component.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport { CaptureJobModel } from \"../models/capture-job.ts\";\nimport { InsightModel } from \"../models/insight.ts\";\nimport { LabelModel, type LabelTables } from \"../models/label.ts\";\nimport { PackageUsageModel } from \"../models/usage.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport { TERMINAL_BUILD_STATUSES } from \"../types.ts\";\nimport { pendingCandidates } from \"./pending.ts\";\nimport { sweepScreenshotContent } from \"./screenshot-sweep.ts\";\n\nexport {\n  sweepScreenshotContent,\n  SWEEP_GRACE_MS,\n  type SweepDeps,\n  type SweepResult,\n  type SweepTables,\n} from \"./screenshot-sweep.ts\";\nimport { col } from \"../models/columns.ts\";\nexport { purgeAiData, STALE_RUN_MS, type AiPurgeResult } from \"./ai.ts\";\n\n/** Table handles for retention queries. */\nexport interface RetentionTables {\n  builds: Table;\n  buildLabels: Table;\n  baselines: Table;\n}\n\n/** Removes expired transient builds while keeping baselines and persistent builds. */\nexport class Retention {\n  private readonly db: DatabaseAdapter;\n  private readonly storage: StorageAdapter;\n  private readonly tables: RetentionTables;\n  private readonly logger?: Logger;\n\n  constructor(\n    db: DatabaseAdapter,\n    storage: StorageAdapter,\n    tables: RetentionTables,\n    logger?: Logger,\n  ) {\n    this.db = db;\n    this.storage = storage;\n    this.tables = tables;\n    this.logger = logger;\n  }\n\n  async purge(project: Project, options: PurgeOptions): Promise<PurgeResult> {\n    const cutoff = new Date(Date.now() - options.ttlDays * 86_400_000).toISOString();\n    const { buildIds, pending } = await this.selectBuilds(project, options, cutoff);\n    const results = await Promise.all(\n      buildIds.map(async (buildId) => ({\n        files: await this.deleteBuildFiles(project.id, buildId),\n        removed: await this.removeBuild(buildId),\n      })),\n    );\n    const removedBuilds = results.filter((r: { removed: boolean }) => r.removed).length;\n    const removedFiles = results.reduce((sum: number, r: { files: number }) => sum + r.files, 0);\n    await this.sweepScreenshots(project);\n    const removedJobs = await this.purgeFinishedJobs(cutoff);\n    this.logger?.info(\n      { projectId: project.id, removedBuilds, removedFiles, removedJobs, removedPending: pending },\n      \"build retention purge complete\",\n    );\n    return { removedBuilds, removedFiles };\n  }\n\n  /**\n   * The builds a purge removes: terminal builds past the window (minus the latest per branch when\n   * asked), and pending builds idle past it (ADR 0013, decision 9). Persistent builds stay.\n   */\n  private async selectBuilds(\n    project: Project,\n    options: PurgeOptions,\n    cutoff: string,\n  ): Promise<{ buildIds: string[]; pending: number }> {\n    const candidates = await this.db.list(this.tables.builds, {\n      where: and(\n        eq(col(this.tables.builds, \"projectId\"), project.id),\n        inArray(col(this.tables.builds, \"status\"), [...TERMINAL_BUILD_STATUSES]),\n        lt(col(this.tables.builds, \"updatedAt\"), cutoff),\n      ),\n    });\n    const keep = options.keepLatestPerBranch\n      ? await this.latestPerBranch(project.id)\n      : new Set<string>();\n    const persistent = await new LabelModel(\n      this.db,\n      this.tables as unknown as LabelTables,\n    ).persistentBuildIds(project.id);\n    const terminal = candidates\n      .map((build) => (build as { id: string }).id)\n      .filter((buildId) => !keep.has(buildId));\n    // Pending builds leave on their own clock; \"the latest on a branch\" does not shield them.\n    const pending = (await pendingCandidates(this.db, project.id, cutoff)).map(\n      (candidate) => candidate.buildId,\n    );\n    return {\n      buildIds: [...terminal, ...pending].filter((buildId) => !persistent.has(buildId)),\n      pending: pending.length,\n    };\n  }\n\n  /** Reclaim screenshots no snapshot or baseline references any more; never blocks the purge. */\n  private async sweepScreenshots(project: Project): Promise<void> {\n    try {\n      await sweepScreenshotContent(\n        {\n          db: this.db,\n          storage: this.storage,\n          tables: {\n            snapshots: this.db.tables.snapshots,\n            baselines: this.tables.baselines,\n            builds: this.tables.builds,\n          },\n          logger: this.logger,\n        },\n        project.id,\n      );\n    } catch (error) {\n      this.logger?.warn({ err: error, projectId: project.id }, \"screenshot sweep failed\");\n    }\n  }\n\n  /**\n   * Drop finished queue jobs older than the build cutoff (they have no foreign key to a build, and\n   * a finished job is only history); never blocks the purge. Queued and running jobs are kept.\n   */\n  private async purgeFinishedJobs(cutoff: string): Promise<number> {\n    try {\n      return await new CaptureJobModel(this.db).purgeFinished(cutoff);\n    } catch (error) {\n      this.logger?.warn({ err: error }, \"capture job purge failed\");\n      return 0;\n    }\n  }\n\n  private async removeBuild(buildId: string): Promise<boolean> {\n    await new InsightModel(this.db).removeForBuild(buildId);\n    await new CaptureJobModel(this.db).removeForBuild(buildId);\n    await new BuildComponentModel(this.db).removeForBuild(buildId);\n    await new PackageUsageModel(this.db).removeForBuild(buildId);\n    await new BuildModel(this.db, this.tables as unknown as BuildTables).remove(buildId);\n    return true;\n  }\n\n  private async latestPerBranch(projectId: string): Promise<Set<string>> {\n    const rows = (await this.db.list(this.tables.builds, {\n      where: eq(col(this.tables.builds, \"projectId\"), projectId),\n      orderBy: desc(col(this.tables.builds, \"updatedAt\")),\n    })) as unknown as { gitBranch: string; id: string }[];\n    const latest = new Map<string, string>();\n    for (const row of rows) {\n      const branch = row.gitBranch;\n      const current = latest.get(branch);\n      if (!current) {\n        latest.set(branch, row.id);\n      }\n    }\n    return new Set(latest.values());\n  }\n\n  private async deleteBuildFiles(projectId: string, buildId: string): Promise<number> {\n    const prefix = `${projectId}/builds/${buildId}/`;\n    const manifestPath = `${prefix}storybook/manifest.json`;\n    let manifestFiles: string[] = [];\n    try {\n      if (await this.storage.exists(manifestPath)) {\n        const raw = await this.storage.read(manifestPath);\n        const manifest = JSON.parse(raw.toString(\"utf8\")) as Record<string, string>;\n        manifestFiles = Object.values(manifest);\n      }\n    } catch {\n      // ignore — manifest may not exist for old builds\n    }\n    const files = await this.storage.list(prefix);\n    await Promise.all(\n      files.map(async (file) => {\n        await this.storage.delete(file);\n      }),\n    );\n    // Decrement content refs for this build's manifest\n    for (const hash of manifestFiles) {\n      try {\n        const contentRefs = this.db.tables.contentRefs;\n        const existing = (await this.db.get(contentRefs, hash)) as unknown as {\n          refCount: number;\n        } | null;\n        // oxlint-disable-next-line unicorn/prefer-ternary -- refCount check is clearer as if/else\n        if (existing) {\n          const refCount = existing.refCount;\n          // oxlint-disable-next-line unicorn/prefer-ternary -- grace logic is clearer as if/else\n          if (refCount <= 1) {\n            // Keep for 7-day grace: set refCount 0 and update lastSeenAt, don't delete yet\n            await this.db.update(contentRefs, hash, {\n              refCount: 0,\n              lastSeenAt: new Date().toISOString(),\n            });\n          } else {\n            await this.db.update(contentRefs, hash, {\n              refCount: refCount - 1,\n              lastSeenAt: new Date().toISOString(),\n            });\n          }\n        }\n      } catch {\n        // ignore — content_refs may not exist\n      }\n    }\n    // GC stale content_refs with 7-day grace\n    try {\n      const contentRefs = this.db.tables.contentRefs;\n      const cutoff = new Date(Date.now() - 7 * 86_400_000).toISOString();\n      const all = (await this.db.list(contentRefs)) as unknown as {\n        hash: string;\n        refCount: number;\n        lastSeenAt: string;\n      }[];\n      for (const row of all) {\n        if (row.refCount === 0 && row.lastSeenAt < cutoff) {\n          await this.storage.delete(`content/${row.hash}`).catch(() => {\n            // ignore storage delete failure\n          });\n          await this.db.remove(contentRefs, row.hash);\n        }\n      }\n    } catch {\n      // ignore — content_refs may not exist\n    }\n    return files.length;\n  }\n\n  async purgeStaleBranches(project: Project, ttlDays: number): Promise<BranchGcResult> {\n    if (ttlDays <= 0) {\n      return { removedBranches: 0, removedBaselines: 0 };\n    }\n    const cutoff = new Date(Date.now() - ttlDays * 86_400_000).toISOString();\n    const rows = (await this.db.list(this.tables.builds, {\n      where: eq(col(this.tables.builds, \"projectId\"), project.id),\n    })) as unknown as { gitBranch: string; updatedAt: string }[];\n    const stale = collectStaleBranches(rows, project.gitDefaultBranch, cutoff);\n    if (stale.size === 0) {\n      return { removedBranches: 0, removedBaselines: 0 };\n    }\n    const baselines = new BaselineModel(this.db, this.tables, this.storage);\n    const removedBaselines = await baselines.removeStaleBranches(project.id, stale);\n    await this.sweepScreenshots(project);\n    this.logger?.info(\n      { projectId: project.id, removedBranches: stale.size, removedBaselines },\n      \"branch GC complete\",\n    );\n    return { removedBranches: stale.size, removedBaselines };\n  }\n}\n\n/** Options controlling which builds a retention purge removes. */\nexport interface PurgeOptions {\n  ttlDays: number;\n  keepLatestPerBranch: boolean;\n}\n\n/** Counts of builds and files removed by a retention purge. */\nexport interface PurgeResult {\n  removedBuilds: number;\n  removedFiles: number;\n}\n\n/** Counts of stale branches and baselines removed. */\nexport interface BranchGcResult {\n  removedBranches: number;\n  removedBaselines: number;\n}\n\nfunction collectStaleBranches(\n  rows: { gitBranch: string; updatedAt: string }[],\n  defaultBranch: string,\n  cutoff: string,\n): Set<string> {\n  const latestAt = branchLatestAt(rows);\n  const stale = new Set<string>();\n  for (const [branch, updatedAt] of latestAt) {\n    if (branch !== defaultBranch && updatedAt < cutoff) {\n      stale.add(branch);\n    }\n  }\n  return stale;\n}\n\nfunction branchLatestAt(rows: { gitBranch: string; updatedAt: string }[]): Map<string, string> {\n  const latestAt = new Map<string, string>();\n  for (const row of rows) {\n    const current = latestAt.get(row.gitBranch);\n    if (!current || row.updatedAt > current) {\n      latestAt.set(row.gitBranch, row.updatedAt);\n    }\n  }\n  return latestAt;\n}\n"],"mappings":"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"}
+{"version":3,"file":"retention.mjs","names":[],"sources":["../src/retention/purge.ts"],"sourcesContent":["import { and, desc, eq, inArray, lt } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { Logger } from \"pino\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { BaselineModel } from \"../models/baseline.ts\";\nimport { BuildComponentModel } from \"../models/build-component.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport { CaptureJobModel } from \"../models/capture-job.ts\";\nimport { InsightModel } from \"../models/insight.ts\";\nimport { LabelModel, type LabelTables } from \"../models/label.ts\";\nimport { PackageUsageModel } from \"../models/usage.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport { TERMINAL_BUILD_STATUSES } from \"../types.ts\";\nimport { pendingCandidates } from \"./pending.ts\";\nimport { sweepPublishedGzip } from \"./published-gzip-sweep.ts\";\nimport { sweepScreenshotContent } from \"./screenshot-sweep.ts\";\n\nexport {\n  sweepScreenshotContent,\n  SWEEP_GRACE_MS,\n  type SweepDeps,\n  type SweepResult,\n  type SweepTables,\n} from \"./screenshot-sweep.ts\";\nimport { col } from \"../models/columns.ts\";\nimport { publishedGzipPath } from \"../utils/paths.ts\";\nexport { purgeAiData, STALE_RUN_MS, type AiPurgeResult } from \"./ai.ts\";\n\n/** Table handles for retention queries. */\nexport interface RetentionTables {\n  builds: Table;\n  buildLabels: Table;\n  baselines: Table;\n}\n\n/** Removes expired transient builds while keeping baselines and persistent builds. */\nexport class Retention {\n  private readonly db: DatabaseAdapter;\n  private readonly storage: StorageAdapter;\n  private readonly tables: RetentionTables;\n  private readonly logger?: Logger;\n\n  constructor(\n    db: DatabaseAdapter,\n    storage: StorageAdapter,\n    tables: RetentionTables,\n    logger?: Logger,\n  ) {\n    this.db = db;\n    this.storage = storage;\n    this.tables = tables;\n    this.logger = logger;\n  }\n\n  async purge(project: Project, options: PurgeOptions): Promise<PurgeResult> {\n    const cutoff = new Date(Date.now() - options.ttlDays * 86_400_000).toISOString();\n    const { buildIds, pending } = await this.selectBuilds(project, options, cutoff);\n    const results = await Promise.all(\n      buildIds.map(async (buildId) => ({\n        files: await this.deleteBuildFiles(project.id, buildId),\n        removed: await this.removeBuild(buildId),\n      })),\n    );\n    const removedBuilds = results.filter((r: { removed: boolean }) => r.removed).length;\n    const removedFiles = results.reduce((sum: number, r: { files: number }) => sum + r.files, 0);\n    await this.sweepScreenshots(project);\n    const removedJobs = await this.purgeFinishedJobs(cutoff);\n    this.logger?.info(\n      { projectId: project.id, removedBuilds, removedFiles, removedJobs, removedPending: pending },\n      \"build retention purge complete\",\n    );\n    return { removedBuilds, removedFiles };\n  }\n\n  /**\n   * The builds a purge removes: terminal builds past the window (minus the latest per branch when\n   * asked), and pending builds idle past it (ADR 0013, decision 9). Persistent builds stay.\n   */\n  private async selectBuilds(\n    project: Project,\n    options: PurgeOptions,\n    cutoff: string,\n  ): Promise<{ buildIds: string[]; pending: number }> {\n    const candidates = await this.db.list(this.tables.builds, {\n      where: and(\n        eq(col(this.tables.builds, \"projectId\"), project.id),\n        inArray(col(this.tables.builds, \"status\"), [...TERMINAL_BUILD_STATUSES]),\n        lt(col(this.tables.builds, \"updatedAt\"), cutoff),\n      ),\n    });\n    const keep = options.keepLatestPerBranch\n      ? await this.latestPerBranch(project.id)\n      : new Set<string>();\n    const persistent = await new LabelModel(\n      this.db,\n      this.tables as unknown as LabelTables,\n    ).persistentBuildIds(project.id);\n    const terminal = candidates\n      .map((build) => (build as { id: string }).id)\n      .filter((buildId) => !keep.has(buildId));\n    // Pending builds leave on their own clock; \"the latest on a branch\" does not shield them.\n    const pending = (await pendingCandidates(this.db, project.id, cutoff)).map(\n      (candidate) => candidate.buildId,\n    );\n    return {\n      buildIds: [...terminal, ...pending].filter((buildId) => !persistent.has(buildId)),\n      pending: pending.length,\n    };\n  }\n\n  /** Reclaim screenshots no snapshot or baseline references any more; never blocks the purge. */\n  private async sweepScreenshots(project: Project): Promise<void> {\n    try {\n      await sweepScreenshotContent(\n        {\n          db: this.db,\n          storage: this.storage,\n          tables: {\n            snapshots: this.db.tables.snapshots,\n            baselines: this.tables.baselines,\n            builds: this.tables.builds,\n          },\n          logger: this.logger,\n        },\n        project.id,\n      );\n    } catch (error) {\n      this.logger?.warn({ err: error, projectId: project.id }, \"screenshot sweep failed\");\n    }\n  }\n\n  /**\n   * Drop finished queue jobs older than the build cutoff (they have no foreign key to a build, and\n   * a finished job is only history); never blocks the purge. Queued and running jobs are kept.\n   */\n  private async purgeFinishedJobs(cutoff: string): Promise<number> {\n    try {\n      return await new CaptureJobModel(this.db).purgeFinished(cutoff);\n    } catch (error) {\n      this.logger?.warn({ err: error }, \"capture job purge failed\");\n      return 0;\n    }\n  }\n\n  private async removeBuild(buildId: string): Promise<boolean> {\n    await new InsightModel(this.db).removeForBuild(buildId);\n    await new CaptureJobModel(this.db).removeForBuild(buildId);\n    await new BuildComponentModel(this.db).removeForBuild(buildId);\n    await new PackageUsageModel(this.db).removeForBuild(buildId);\n    await new BuildModel(this.db, this.tables as unknown as BuildTables).remove(buildId);\n    return true;\n  }\n\n  private async latestPerBranch(projectId: string): Promise<Set<string>> {\n    const rows = (await this.db.list(this.tables.builds, {\n      where: eq(col(this.tables.builds, \"projectId\"), projectId),\n      orderBy: desc(col(this.tables.builds, \"updatedAt\")),\n    })) as unknown as { gitBranch: string; id: string }[];\n    const latest = new Map<string, string>();\n    for (const row of rows) {\n      const branch = row.gitBranch;\n      const current = latest.get(branch);\n      if (!current) {\n        latest.set(branch, row.id);\n      }\n    }\n    return new Set(latest.values());\n  }\n\n  private async deleteBuildFiles(projectId: string, buildId: string): Promise<number> {\n    const prefix = `${projectId}/builds/${buildId}/`;\n    const manifestPath = `${prefix}storybook/manifest.json`;\n    let manifestFiles: string[] = [];\n    try {\n      if (await this.storage.exists(manifestPath)) {\n        const raw = await this.storage.read(manifestPath);\n        const manifest = JSON.parse(raw.toString(\"utf8\")) as Record<string, string>;\n        manifestFiles = Object.values(manifest);\n      }\n    } catch {\n      // ignore — manifest may not exist for old builds\n    }\n    const files = await this.storage.list(prefix);\n    await Promise.all(\n      files.map(async (file) => {\n        await this.storage.delete(file);\n      }),\n    );\n    // Decrement content refs for this build's manifest\n    for (const hash of manifestFiles) {\n      try {\n        const contentRefs = this.db.tables.contentRefs;\n        const existing = (await this.db.get(contentRefs, hash)) as unknown as {\n          refCount: number;\n        } | null;\n        // oxlint-disable-next-line unicorn/prefer-ternary -- refCount check is clearer as if/else\n        if (existing) {\n          const refCount = existing.refCount;\n          // oxlint-disable-next-line unicorn/prefer-ternary -- grace logic is clearer as if/else\n          if (refCount <= 1) {\n            // Keep for 7-day grace: set refCount 0 and update lastSeenAt, don't delete yet\n            await this.db.update(contentRefs, hash, {\n              refCount: 0,\n              lastSeenAt: new Date().toISOString(),\n            });\n          } else {\n            await this.db.update(contentRefs, hash, {\n              refCount: refCount - 1,\n              lastSeenAt: new Date().toISOString(),\n            });\n          }\n        }\n      } catch {\n        // ignore — content_refs may not exist\n      }\n    }\n    // GC stale content_refs with 7-day grace\n    try {\n      const contentRefs = this.db.tables.contentRefs;\n      const cutoff = new Date(Date.now() - 7 * 86_400_000).toISOString();\n      const all = (await this.db.list(contentRefs)) as unknown as {\n        hash: string;\n        refCount: number;\n        lastSeenAt: string;\n      }[];\n      for (const row of all) {\n        if (row.refCount === 0 && row.lastSeenAt < cutoff) {\n          await this.storage.delete(`content/${row.hash}`).catch(() => {\n            // ignore storage delete failure\n          });\n          // Variants are disposable; never let their deletion affect authoritative data.\n          if (/^[a-f0-9]{64}$/u.test(row.hash)) {\n            await this.storage.delete(publishedGzipPath(row.hash)).catch(() => {});\n          }\n          await this.db.remove(contentRefs, row.hash);\n        }\n      }\n    } catch {\n      // ignore — content_refs may not exist\n    }\n    await sweepPublishedGzip(this.storage).catch(() => {});\n    return files.length;\n  }\n\n  async purgeStaleBranches(project: Project, ttlDays: number): Promise<BranchGcResult> {\n    if (ttlDays <= 0) {\n      return { removedBranches: 0, removedBaselines: 0 };\n    }\n    const cutoff = new Date(Date.now() - ttlDays * 86_400_000).toISOString();\n    const rows = (await this.db.list(this.tables.builds, {\n      where: eq(col(this.tables.builds, \"projectId\"), project.id),\n    })) as unknown as { gitBranch: string; updatedAt: string }[];\n    const stale = collectStaleBranches(rows, project.gitDefaultBranch, cutoff);\n    if (stale.size === 0) {\n      return { removedBranches: 0, removedBaselines: 0 };\n    }\n    const baselines = new BaselineModel(this.db, this.tables, this.storage);\n    const removedBaselines = await baselines.removeStaleBranches(project.id, stale);\n    await this.sweepScreenshots(project);\n    this.logger?.info(\n      { projectId: project.id, removedBranches: stale.size, removedBaselines },\n      \"branch GC complete\",\n    );\n    return { removedBranches: stale.size, removedBaselines };\n  }\n}\n\n/** Options controlling which builds a retention purge removes. */\nexport interface PurgeOptions {\n  ttlDays: number;\n  keepLatestPerBranch: boolean;\n}\n\n/** Counts of builds and files removed by a retention purge. */\nexport interface PurgeResult {\n  removedBuilds: number;\n  removedFiles: number;\n}\n\n/** Counts of stale branches and baselines removed. */\nexport interface BranchGcResult {\n  removedBranches: number;\n  removedBaselines: number;\n}\n\nfunction collectStaleBranches(\n  rows: { gitBranch: string; updatedAt: string }[],\n  defaultBranch: string,\n  cutoff: string,\n): Set<string> {\n  const latestAt = branchLatestAt(rows);\n  const stale = new Set<string>();\n  for (const [branch, updatedAt] of latestAt) {\n    if (branch !== defaultBranch && updatedAt < cutoff) {\n      stale.add(branch);\n    }\n  }\n  return stale;\n}\n\nfunction branchLatestAt(rows: { gitBranch: string; updatedAt: string }[]): Map<string, string> {\n  const latestAt = new Map<string, string>();\n  for (const row of rows) {\n    const current = latestAt.get(row.gitBranch);\n    if (!current || row.updatedAt > current) {\n      latestAt.set(row.gitBranch, row.updatedAt);\n    }\n  }\n  return latestAt;\n}\n"],"mappings":"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"}

package/dist/schema/baseline.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/baseline.d.ts
 /** A baseline row. */
 interface Baseline {
   id: string;
@@ -9,6 +8,8 @@ interface Baseline {
   viewportName: string;
   branch: string;
   snapshotId: string | null;
+  /** Build that actually rendered this image; null for unknown or imported origins. */
+  sourceBuildId?: string | null;
   screenshotPath: string;
   infraHash: string | null;
   /** JSON `Fingerprint` behind `infraHash`; null on baselines recorded before fingerprints. */
@@ -20,6 +21,5 @@ interface Baseline {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { Baseline };
 //# sourceMappingURL=baseline.d.mts.map

package/dist/schema/build-component.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/build-component.d.ts
 /**
  * Row type of `build_components` (ADR 0006, decision 9): one row per component of a published
  * build, written from the build's Storybook index when publishing ends. A component is the
@@ -20,6 +19,5 @@ interface BuildComponent {
   hash: string;
   createdAt: string;
 }
-//#endregion
 export { BuildComponent };
 //# sourceMappingURL=build-component.d.mts.map

package/dist/schema/build-review.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { ReviewVerdict } from "../types.mjs";
-//#region src/schema/build-review.d.ts
 /** One verdict on one build. */
 interface BuildReview {
   id: string;
@@ -12,6 +11,5 @@ interface BuildReview {
   body: string | null;
   createdAt: string;
 }
-//#endregion
 export { BuildReview };
 //# sourceMappingURL=build-review.d.mts.map

package/dist/schema/build.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { BuildStatus } from "../types.mjs";
-//#region src/schema/build.d.ts
 /** A build row. */
 interface Build {
   id: string;
@@ -36,6 +35,5 @@ interface Build {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { Build };
 //# sourceMappingURL=build.d.mts.map

package/dist/schema/capture-attempt.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { JobStatus } from "../adapter/capture-queue.mjs";
-//#region src/schema/capture-attempt.d.ts
 /** A capture attempt row: one queued run of a build's capture pipeline. */
 interface CaptureAttempt {
   id: string;
@@ -33,6 +32,5 @@ interface CaptureLog {
   fields: string | null;
   createdAt: string;
 }
-//#endregion
 export { CaptureAttempt, CaptureLog, CaptureLogLevel };
 //# sourceMappingURL=capture-attempt.d.mts.map

package/dist/schema/capture-job.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/capture-job.d.ts
 /**
  * Row types of `capture_jobs`, the database queue (ADR 0006, decision 4).
  *
@@ -55,6 +54,5 @@ interface CaptureJobRow {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { CaptureAttemptStatus, CaptureJobEntry, CaptureJobKind, CaptureJobRow, CaptureJobStatus };
 //# sourceMappingURL=capture-job.d.mts.map

package/dist/schema/capture-shard.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/capture-shard.d.ts
 /** What a row of `capture_shards` is: a stage of a sharded capture, or the claim that finalizes it. */
 type CaptureShardKind = "plan" | "render" | "finalize";
 /** Lifecycle of one shard row. */
@@ -30,6 +29,5 @@ interface CaptureShard {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { CaptureShard, CaptureShardKind, CaptureShardStatus };
 //# sourceMappingURL=capture-shard.d.mts.map

package/dist/schema/comment.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/comment.d.ts
 /** A comment row. */
 interface Comment {
   id: string;
@@ -16,6 +15,5 @@ interface Comment {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { Comment };
 //# sourceMappingURL=comment.d.mts.map

package/dist/schema/connection.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/connection.d.ts
 /**
  * A user's own OAuth connection to an external service (`design` providers today,
  * issue trackers later). One per user and service; tokens are encrypted at rest.
@@ -19,6 +18,5 @@ interface UserConnection {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { UserConnection };
 //# sourceMappingURL=connection.d.mts.map

package/dist/schema/content-ref.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/content-ref.d.ts
 /** Content ref row for deduplicated assets. */
 interface ContentRef {
   hash: string;
@@ -8,6 +7,5 @@ interface ContentRef {
   lastSeenAt: string;
   createdAt: string;
 }
-//#endregion
 export { ContentRef };
 //# sourceMappingURL=content-ref.d.mts.map

package/dist/schema/design.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/design.d.ts
 /** A design link: a project-level file link (`importPath` null) or a component mapping override. */
 interface DesignLink {
   id: string;
@@ -53,6 +52,5 @@ interface DesignNode {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { DesignCredential, DesignLink, DesignNode };
 //# sourceMappingURL=design.d.mts.map

package/dist/schema/insight.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/insight.d.ts
 /** Insight kinds: a build triage or a project-health digest. */
 type InsightKind = "triage" | "health";
 /** Lifecycle of an insight run. */
@@ -49,6 +48,5 @@ interface AiBudgetAlertRow {
   threshold: number;
   createdAt: string;
 }
-//#endregion
 export { AiBudgetAlertRow, AiUsageRow, InsightKind, InsightRow, InsightStatus };
 //# sourceMappingURL=insight.d.mts.map

package/dist/schema/label.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/label.d.ts
 /** A label-type row. */
 interface LabelType {
   id: string;
@@ -20,6 +19,5 @@ interface BuildLabel {
   value: string;
   createdAt: string;
 }
-//#endregion
 export { BuildLabel, LabelType };
 //# sourceMappingURL=label.d.mts.map

package/dist/schema/member.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { ProjectRole } from "../types.mjs";
-//#region src/schema/member.d.ts
 /** A project-membership row. */
 interface ProjectMember {
   id: string;
@@ -12,6 +11,5 @@ interface ProjectMember {
   source: string;
   createdAt: string;
 }
-//#endregion
 export { ProjectMember };
 //# sourceMappingURL=member.d.mts.map

package/dist/schema/notification.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/notification.d.ts
 /** A project (or site-wide) notification channel row. */
 interface NotificationChannelRow {
   id: string;
@@ -34,6 +33,5 @@ interface NotificationSubscriptionRow {
   enabled: boolean;
   createdAt: string;
 }
-//#endregion
 export { NotificationChannelRow, NotificationSubscriptionRow };
 //# sourceMappingURL=notification.d.mts.map

package/dist/schema/project-group-mapping.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { ProjectRole } from "../types.mjs";
-//#region src/schema/project-group-mapping.d.ts
 /** An identity-provider group to project-role mapping row. */
 interface ProjectGroupMapping {
   id: string;
@@ -10,6 +9,5 @@ interface ProjectGroupMapping {
   role: ProjectRole;
   createdAt: string;
 }
-//#endregion
 export { ProjectGroupMapping };
 //# sourceMappingURL=project-group-mapping.d.mts.map

package/dist/schema/project.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/project.d.ts
 /** A project row. */
 interface Project {
   id: string;
@@ -54,6 +53,5 @@ interface StorybookMeta {
   packagePath?: string;
   previewParameters?: Record<string, unknown>;
 }
-//#endregion
 export { Project, StorybookMeta };
 //# sourceMappingURL=project.d.mts.map

package/dist/schema/site-setting.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/site-setting.d.ts
 /**
  * Row type of `site_settings`: a small key-value table for facts the app learns while running and
  * must share between instances (ADR 0007, decision 6: the public origin an admin's browser reported).
@@ -16,6 +15,5 @@ interface SiteSetting {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { SiteSetting };
 //# sourceMappingURL=site-setting.d.mts.map

package/dist/schema/snapshot.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { SnapshotStatus } from "../types.mjs";
-//#region src/schema/snapshot.d.ts
 /** A snapshot row. */
 interface Snapshot {
   id: string;
@@ -29,6 +28,11 @@ interface Snapshot {
   envChange: string | null;
   /** True when inherited unchanged from the baseline without rendering. */
   inherited: boolean;
+  /** Build that rendered the screenshot; inherited captures carry the original source. */
+  sourceBuildId?: string | null;
+  /** Frozen comparison image and metadata, owned by this snapshot’s build. */
+  comparisonImagePath?: string | null;
+  comparisonMetadata?: string | null;
   /** Baseline row the diff was computed against (null: no baseline, or legacy row). */
   baselineId: string | null;
   /** That baseline's `updatedAt` at diff time; compared on approval to detect drift. */
@@ -44,6 +48,5 @@ interface Snapshot {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { Snapshot };
 //# sourceMappingURL=snapshot.d.mts.map

package/dist/schema/token.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/token.d.ts
 /** A CI token row (hash only; the secret itself is never stored). */
 interface Token {
   id: string;
@@ -12,6 +11,5 @@ interface Token {
   lastUsedAt: string | null;
   createdAt: string;
 }
-//#endregion
 export { Token };
 //# sourceMappingURL=token.d.mts.map

package/dist/schema/usage.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/usage.d.ts
 /** A link from a downstream project to the upstream project that publishes a package it consumes. */
 interface ProjectLink {
   id: string;
@@ -25,6 +24,5 @@ interface BuildPackageUsage {
   version: string | null;
   createdAt: string;
 }
-//#endregion
 export { BuildPackageUsage, ProjectLink };
 //# sourceMappingURL=usage.d.mts.map

package/dist/schema/user.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { SiteRole } from "../types.mjs";
-//#region src/schema/user.d.ts
 /** How a user authenticates. */
 type AuthProvider = "local" | "oidc" | "shared";
 /** A user row. */
@@ -22,6 +21,5 @@ interface User {
   /** Whether the account is disabled (login rejected). */
   disabled?: boolean;
 }
-//#endregion
 export { AuthProvider, User };
 //# sourceMappingURL=user.d.mts.map

package/dist/schema/webhook.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/webhook.d.ts
 /** A webhook subscription row. */
 interface Webhook {
   id: string;
@@ -11,6 +10,5 @@ interface Webhook {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { Webhook };
 //# sourceMappingURL=webhook.d.mts.map

package/dist/schema.d.mts

@@ -9,22 +9,20 @@ import { Snapshot } from "./schema/snapshot.mjs";
 import { CaptureAttemptStatus, CaptureJobEntry, CaptureJobKind, CaptureJobRow, CaptureJobStatus } from "./schema/capture-job.mjs";
 import { BuildComponent } from "./schema/build-component.mjs";
 import { CaptureShard, CaptureShardKind, CaptureShardStatus } from "./schema/capture-shard.mjs";
-import { AiBudgetAlertRow, AiUsageRow, InsightKind, InsightRow, InsightStatus } from "./schema/insight.mjs";
 import { BuildReview } from "./schema/build-review.mjs";
+import { SiteSetting } from "./schema/site-setting.mjs";
 import { Comment } from "./schema/comment.mjs";
+import { BuildLabel, LabelType } from "./schema/label.mjs";
 import { UserConnection } from "./schema/connection.mjs";
 import { DesignCredential, DesignLink, DesignNode } from "./schema/design.mjs";
-import { BuildLabel, LabelType } from "./schema/label.mjs";
 import { BuildPackageUsage, ProjectLink } from "./schema/usage.mjs";
 import { ProjectMember } from "./schema/member.mjs";
-import { NotificationChannelRow, NotificationSubscriptionRow } from "./schema/notification.mjs";
 import { ProjectGroupMapping } from "./schema/project-group-mapping.mjs";
+import { AiBudgetAlertRow, AiUsageRow, InsightKind, InsightRow, InsightStatus } from "./schema/insight.mjs";
+import { NotificationChannelRow, NotificationSubscriptionRow } from "./schema/notification.mjs";
 import { Token } from "./schema/token.mjs";
 import { User } from "./schema/user.mjs";
-import { SiteSetting } from "./schema/site-setting.mjs";
-//#region src/schema/index.d.ts
 /** Placeholder schema type — Drizzle schema lives in the db adapters. */
 type Schema = Record<string, unknown>;
-//#endregion
 export { type AiBudgetAlertRow, type AiUsageRow, type Baseline, type Build, type BuildComponent, type BuildLabel, type BuildPackageUsage, type BuildReview, type CaptureAttempt, type CaptureAttemptStatus, type CaptureJobEntry, type CaptureJobKind, type CaptureJobRow, type CaptureJobStatus, type CaptureLog, type CaptureLogLevel, type CaptureShard, type CaptureShardKind, type CaptureShardStatus, type Comment, type DesignCredential, type DesignLink, type DesignNode, type InsightKind, type InsightRow, type InsightStatus, type LabelType, type NotificationChannelRow, type NotificationSubscriptionRow, type Project, type ProjectGroupMapping, type ProjectLink, type ProjectMember, Schema, type SiteSetting, type Snapshot, type StorybookMeta, type Token, type User, type UserConnection, type Webhook };
 //# sourceMappingURL=schema.d.mts.map

package/dist/serverless.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/serverless.d.ts
 /**
  * Serverless hosts (ADR 0006, decision 3): `testing` needs a process that keeps running between
  * requests, so it is refused on AWS Lambda and warned about on the other platforms that freeze or
@@ -16,6 +15,5 @@ declare function isServerlessHost(env?: NodeJS.ProcessEnv): boolean;
  * `STORYSHELF_ALLOW_SERVERLESS=1`.
  */
 declare function assertServerless(testing: boolean, env?: NodeJS.ProcessEnv): string | undefined;
-//#endregion
 export { ALLOW_SERVERLESS_ENV, assertServerless, isServerlessHost };
 //# sourceMappingURL=serverless.d.mts.map

package/dist/serverless.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/serverless.ts
+// src/serverless.ts
 /**
 * Serverless hosts (ADR 0006, decision 3): `testing` needs a process that keeps running between
 * requests, so it is refused on AWS Lambda and warned about on the other platforms that freeze or
@@ -31,7 +31,6 @@ function assertServerless(testing, env = process.env) {
 	if (env[LAMBDA_ENV]) throw new Error(`testing needs a long-running server, and AWS Lambda ends the process after each request. Remove the testing option to host Storybooks only, or run on a container; set ${ALLOW_SERVERLESS_ENV}=1 to override.`);
 	return `testing is configured on a serverless host: capture jobs run in the background and may be cut off when the platform ends the process. Run on a container for testing; set ${ALLOW_SERVERLESS_ENV}=1 to silence this warning.`;
 }
-//#endregion
 export { ALLOW_SERVERLESS_ENV, assertServerless, isServerlessHost };
 
 //# sourceMappingURL=serverless.mjs.map

package/dist/test-helpers/build-reference-contract.d.mts

@@ -0,0 +1,14 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BuildReferenceLifecycle, BuildReferenceOwner } from "../adapter/database.mjs";
+interface BuildReferenceContractFixture {
+  first: BuildReferenceLifecycle;
+  second: BuildReferenceLifecycle;
+  owner: BuildReferenceOwner;
+  buildIds: readonly [string, string];
+}
+type BuildReferenceContractFixtureRunner = (run: (fixture: BuildReferenceContractFixture) => Promise<void>) => Promise<void>;
+/** Exercise atomic owner replacement and deletion using separate adapter connections. */
+declare function buildReferenceContractSuite(label: string, withFixture: BuildReferenceContractFixtureRunner): void;
+export { BuildReferenceContractFixture, BuildReferenceContractFixtureRunner, buildReferenceContractSuite };
+//# sourceMappingURL=build-reference-contract.d.mts.map

package/dist/test-helpers/build-reference-contract.mjs

@@ -0,0 +1,66 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { describe, expect, it } from "vitest";
+// src/test-helpers/build-reference-contract.ts
+/** Shared lifecycle conformance tests. Each fixture must use independent connections. */
+/** Exercise atomic owner replacement and deletion using separate adapter connections. */
+function buildReferenceContractSuite(label, withFixture) {
+	describe(`build reference lifecycle contract: ${label}`, () => {
+		it("serializes replacement against deletion of the newly referenced build", async () => {
+			await withFixture(async ({ first, second, owner, buildIds }) => {
+				await first.replaceFencedReferences(owner, 0, [buildIds[0]], async () => null);
+				const [replacement, deletion] = await Promise.allSettled([first.replaceFencedReferences(owner, 1, [buildIds[1]], async () => null), second.claimDeletion(owner.projectId, buildIds[1])]);
+				expect(deletion.status).toBe("fulfilled");
+				if (deletion.status !== "fulfilled") throw new Error("deletion failed");
+				if (replacement.status === "fulfilled") {
+					expect(deletion.value).toBe("protected");
+					expect(await first.claimDeletion(owner.projectId, buildIds[0])).toBe("claimed");
+				} else {
+					expect(deletion.value).toBe("claimed");
+					expect(await first.claimDeletion(owner.projectId, buildIds[0])).toBe("protected");
+				}
+			});
+		});
+		it("serializes an admission against deletion", async () => {
+			await withFixture(async ({ first, second, owner, buildIds }) => {
+				const [admission, deletion] = await Promise.allSettled([first.replaceFencedReferences(owner, 0, [buildIds[0]], async () => null), second.claimDeletion(owner.projectId, buildIds[0])]);
+				expect(deletion.status).toBe("fulfilled");
+				if (deletion.status !== "fulfilled") throw new Error("deletion failed");
+				if (admission.status === "fulfilled") expect(deletion.value).toBe("protected");
+				else expect(deletion.value).toBe("claimed");
+			});
+		});
+		it("rolls back domain failure and rejects stale generation after release", async () => {
+			await withFixture(async ({ first, second, owner, buildIds }) => {
+				await expect(first.replaceFencedReferences(owner, 0, [buildIds[0]], async () => {
+					throw new Error("rollback");
+				})).rejects.toThrow("rollback");
+				expect(await second.referenceGeneration(owner)).toBe(0);
+				expect((await second.replaceFencedReferences(owner, 0, [buildIds[0], buildIds[0]], async () => null)).generation).toBe(1);
+				expect(await first.claimDeletion(owner.projectId, buildIds[0])).toBe("protected");
+				expect((await first.replaceFencedReferences(owner, 1, [], async () => null)).generation).toBe(2);
+				await expect(second.replaceFencedReferences(owner, 1, [buildIds[1]], async () => null)).rejects.toThrow();
+				expect(await second.referenceGeneration(owner)).toBe(2);
+				expect(await first.claimDeletion(owner.projectId, buildIds[1])).toBe("claimed");
+				expect(await second.claimDeletion(owner.projectId, buildIds[0])).toBe("claimed");
+				await expect(first.replaceFencedReferences(owner, 2, [buildIds[0]], async () => null)).rejects.toThrow();
+			});
+		});
+		it("rejects a duplicate owner in a multi-owner update", async () => {
+			await withFixture(async ({ first, owner, buildIds }) => {
+				const change = {
+					owner,
+					expectedGeneration: 0,
+					buildIds: [buildIds[0]]
+				};
+				await expect(first.replaceManyFencedReferences([change, change], async () => null)).rejects.toThrow();
+				expect(await first.referenceGeneration(owner)).toBe(0);
+				expect(await first.claimDeletion(owner.projectId, buildIds[0])).toBe("claimed");
+			});
+		});
+	});
+}
+export { buildReferenceContractSuite };
+
+//# sourceMappingURL=build-reference-contract.mjs.map

package/dist/test-helpers/build-reference-contract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-reference-contract.mjs","names":[],"sources":["../../src/test-helpers/build-reference-contract.ts"],"sourcesContent":["/** Shared lifecycle conformance tests. Each fixture must use independent connections. */\nimport { describe, expect, it } from \"vitest\";\nimport type { BuildReferenceLifecycle, BuildReferenceOwner } from \"../adapters/database.ts\";\n\nexport interface BuildReferenceContractFixture {\n  first: BuildReferenceLifecycle;\n  second: BuildReferenceLifecycle;\n  owner: BuildReferenceOwner;\n  buildIds: readonly [string, string];\n}\nexport type BuildReferenceContractFixtureRunner = (\n  run: (fixture: BuildReferenceContractFixture) => Promise<void>,\n) => Promise<void>;\n\n/** Exercise atomic owner replacement and deletion using separate adapter connections. */\nexport function buildReferenceContractSuite(\n  label: string,\n  withFixture: BuildReferenceContractFixtureRunner,\n): void {\n  describe(`build reference lifecycle contract: ${label}`, () => {\n    it(\"serializes replacement against deletion of the newly referenced build\", async () => {\n      await withFixture(async ({ first, second, owner, buildIds }) => {\n        await first.replaceFencedReferences(owner, 0, [buildIds[0]], async () => null);\n        const [replacement, deletion] = await Promise.allSettled([\n          first.replaceFencedReferences(owner, 1, [buildIds[1]], async () => null),\n          second.claimDeletion(owner.projectId, buildIds[1]),\n        ]);\n        expect(deletion.status).toBe(\"fulfilled\");\n        if (deletion.status !== \"fulfilled\") throw new Error(\"deletion failed\");\n        if (replacement.status === \"fulfilled\") {\n          expect(deletion.value).toBe(\"protected\");\n          expect(await first.claimDeletion(owner.projectId, buildIds[0])).toBe(\"claimed\");\n        } else {\n          expect(deletion.value).toBe(\"claimed\");\n          expect(await first.claimDeletion(owner.projectId, buildIds[0])).toBe(\"protected\");\n        }\n      });\n    });\n    it(\"serializes an admission against deletion\", async () => {\n      await withFixture(async ({ first, second, owner, buildIds }) => {\n        const [admission, deletion] = await Promise.allSettled([\n          first.replaceFencedReferences(owner, 0, [buildIds[0]], async () => null),\n          second.claimDeletion(owner.projectId, buildIds[0]),\n        ]);\n        expect(deletion.status).toBe(\"fulfilled\");\n        if (deletion.status !== \"fulfilled\") throw new Error(\"deletion failed\");\n        if (admission.status === \"fulfilled\") expect(deletion.value).toBe(\"protected\");\n        else expect(deletion.value).toBe(\"claimed\");\n      });\n    });\n    it(\"rolls back domain failure and rejects stale generation after release\", async () => {\n      await withFixture(async ({ first, second, owner, buildIds }) => {\n        await expect(\n          first.replaceFencedReferences(owner, 0, [buildIds[0]], async () => {\n            throw new Error(\"rollback\");\n          }),\n        ).rejects.toThrow(\"rollback\");\n        expect(await second.referenceGeneration(owner)).toBe(0);\n        expect(\n          (\n            await second.replaceFencedReferences(\n              owner,\n              0,\n              [buildIds[0], buildIds[0]],\n              async () => null,\n            )\n          ).generation,\n        ).toBe(1);\n        expect(await first.claimDeletion(owner.projectId, buildIds[0])).toBe(\"protected\");\n        expect(\n          (await first.replaceFencedReferences(owner, 1, [], async () => null)).generation,\n        ).toBe(2);\n        await expect(\n          second.replaceFencedReferences(owner, 1, [buildIds[1]], async () => null),\n        ).rejects.toThrow();\n        expect(await second.referenceGeneration(owner)).toBe(2);\n        expect(await first.claimDeletion(owner.projectId, buildIds[1])).toBe(\"claimed\");\n        expect(await second.claimDeletion(owner.projectId, buildIds[0])).toBe(\"claimed\");\n        await expect(\n          first.replaceFencedReferences(owner, 2, [buildIds[0]], async () => null),\n        ).rejects.toThrow();\n      });\n    });\n    it(\"rejects a duplicate owner in a multi-owner update\", async () => {\n      await withFixture(async ({ first, owner, buildIds }) => {\n        const change = { owner, expectedGeneration: 0, buildIds: [buildIds[0]] };\n        await expect(\n          first.replaceManyFencedReferences([change, change], async () => null),\n        ).rejects.toThrow();\n        expect(await first.referenceGeneration(owner)).toBe(0);\n        expect(await first.claimDeletion(owner.projectId, buildIds[0])).toBe(\"claimed\");\n      });\n    });\n  });\n}\n"],"mappings":"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"}

package/dist/test-helpers/create-project.d.mts

@@ -5,11 +5,9 @@ import { Build } from "../schema/build.mjs";
 import { Project } from "../schema/project.mjs";
 import { BuildTables } from "../models/build.mjs";
 import { ProjectTables } from "../models/project.mjs";
-//#region src/test-helpers/create-project.d.ts
 /** Create a test project with owner/repo defaults. */
 declare function createTestProject(db: DatabaseAdapter, tables: ProjectTables, overrides?: Partial<Project>): Promise<Project>;
 /** Create a test build on main with sha-1 defaults. */
 declare function createTestBuild(db: DatabaseAdapter, tables: BuildTables, projectId: string, overrides?: Partial<Build>): Promise<Build>;
-//#endregion
 export { createTestBuild, createTestProject };
 //# sourceMappingURL=create-project.d.mts.map

package/dist/test-helpers/create-project.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { BuildModel } from "../models/build.mjs";
 import { ProjectModel } from "../models/project.mjs";
-//#region src/test-helpers/create-project.ts
+// src/test-helpers/create-project.ts
 /** Create a test project with owner/repo defaults. */
 async function createTestProject(db, tables, overrides) {
 	const { gitRepository: repo, ...rest } = overrides ?? {};
@@ -22,7 +22,6 @@ async function createTestBuild(db, tables, projectId, overrides) {
 		...overrides
 	});
 }
-//#endregion
 export { createTestBuild, createTestProject };
 
 //# sourceMappingURL=create-project.mjs.map