@storyshelf/core 0.6.2 → 0.8.0

package/dist/models/baseline.d.mts

@@ -5,29 +5,59 @@ import { StorageAdapter } from "../adapter/storage.mjs";
 import { SecretInput } from "../utils/encrypt.mjs";
 import { WebhookTables } from "./webhook.mjs";
 import { Baseline } from "../schema/baseline.mjs";
+import { AtomicBaselineApproval } from "./baseline-approval.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/baseline.d.ts
+/** Extra identity/metadata for {@link BaselineModel.upsert}. */
+interface BaselineUpsertOptions {
+  approval?: AtomicBaselineApproval;
+  /** Engine the baseline belongs to (default chromium). */
+  browser?: string;
+  /** Resolved mode definition as JSON (display only). */
+  mode?: string | null;
+  /** JSON `Fingerprint` behind the `infraHash` being written. */
+  fingerprint?: string | null;
+}
 /** Tables required by {@link BaselineModel}. */
 interface BaselineTables {
   baselines: Table;
 }
 /** Data operations for baseline screenshots. */
 declare class BaselineModel {
-  private readonly db;
+  #private;
   private readonly tables;
   private readonly storage;
   private readonly secret?;
   private readonly webhookTables?;
+  private readonly db;
   constructor(db: DatabaseAdapter, tables?: BaselineTables, storage?: StorageAdapter, secret?: SecretInput, webhookTables?: WebhookTables);
-  getFor(projectId: string, storyId: string, viewport: string, branch: string): Promise<Baseline | null>;
-  resolve(projectId: string, storyId: string, viewport: string, branch: string, defaultBranch: string): Promise<Baseline | null>;
+  getFor(projectId: string, storyId: string, viewport: string, branch: string, browser?: string): Promise<Baseline | null>;
+  resolve(projectId: string, storyId: string, viewport: string, branch: string, defaultBranch: string, browser?: string): Promise<Baseline | null>;
+  /** Whether the project has any baseline captured on this engine. */
+  hasAny(projectId: string, browser: string): Promise<boolean>;
+  /**
+   * Record the fingerprint of a baseline that predates fingerprints, without touching its
+   * screenshot. Lets the next environment change be detected instead of diffing as a regression.
+   */
+  backfillFingerprint(baseline: Baseline, infraHash: string, fingerprint: string): Promise<void>;
+  /**
+   * The content-addressed object a baseline should point at. A source that already is one is
+   * reused as is (no copy); a legacy per-build path is stored once by content.
+   */
+  private contentFor;
   read(baseline: Baseline): Promise<Buffer>;
-  upsert(projectId: string, storyId: string, viewport: string, branch: string, snapshotId: string, sourcePath: string, infraHash?: string | null): Promise<Baseline>;
+  upsert(projectId: string, storyId: string, viewport: string, branch: string, snapshotId: string, sourcePath: string, infraHash?: string | null, options?: BaselineUpsertOptions): Promise<Baseline>;
+  private sourceBuildId;
   list(projectId: string): Promise<Baseline[]>;
+  /**
+   * Delete a baseline's own file. A content-addressed screenshot is shared with snapshots and other
+   * baselines, so it is left for the retention sweep instead.
+   */
+  private discardFile;
+  /** Drop the reference and row together when the adapter supports lifecycle protection. */
+  private removeRecord;
   removeOrphans(projectId: string, validStoryIds: Set<string>): Promise<number>;
   removeForBranch(projectId: string, branch: string): Promise<number>;
   removeStaleBranches(projectId: string, staleBranches: ReadonlySet<string>): Promise<number>;
 }
-//#endregion
-export { BaselineModel, BaselineTables };
+export { BaselineModel, BaselineTables, BaselineUpsertOptions };
 //# sourceMappingURL=baseline.d.mts.map

package/dist/models/baseline.mjs

@@ -1,19 +1,25 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { DEFAULT_BROWSER } from "../adapters/capture-target.mjs";
 import { ulid } from "../utils/ulid.mjs";
+import { col } from "./columns.mjs";
 import { emitWebhookEvent } from "../adapter/webhook-events.mjs";
-import { baselinePath } from "../paths.mjs";
-import { and, eq, getTableColumns } from "drizzle-orm";
-//#region src/models/baseline.ts
+import { isContentPath } from "../paths.mjs";
+import { storeScreenshot, withContentClaim } from "../utils/screenshot-store.mjs";
+import { BaselineWriteConflict } from "./baseline-conflict.mjs";
+import { approveInTransaction } from "./baseline-approval.mjs";
+import { upsertAtomicBaseline } from "./baseline-atomic.mjs";
+import { and, eq } from "drizzle-orm";
+// src/models/baseline.ts
 /** Per-branch baseline screenshots with default-branch fallback. */
 /** Data operations for baseline screenshots. */
 var BaselineModel = class {
-	db;
 	tables;
 	storage;
 	secret;
 	webhookTables;
+	db;
 	constructor(db, tables, storage, secret, webhookTables) {
 		this.db = db;
 		this.tables = tables ?? { baselines: db.tables.baselines };
@@ -21,39 +27,130 @@ var BaselineModel = class {
 		this.secret = secret;
 		this.webhookTables = webhookTables;
 	}
-	async getFor(projectId, storyId, viewport, branch) {
+	async getFor(projectId, storyId, viewport, branch, browser = DEFAULT_BROWSER) {
 		return (await this.db.list(this.tables.baselines, {
-			where: and(eq(getTableColumns(this.tables.baselines)["projectId"], projectId), eq(getTableColumns(this.tables.baselines)["storyId"], storyId), eq(getTableColumns(this.tables.baselines)["viewportName"], viewport), eq(getTableColumns(this.tables.baselines)["branch"], branch)),
+			where: and(eq(col(this.tables.baselines, "projectId"), projectId), eq(col(this.tables.baselines, "storyId"), storyId), eq(col(this.tables.baselines, "viewportName"), viewport), eq(col(this.tables.baselines, "branch"), branch), eq(col(this.tables.baselines, "browser"), browser)),
 			limit: 1
 		}))[0] ?? null;
 	}
-	async resolve(projectId, storyId, viewport, branch, defaultBranch) {
+	async resolve(projectId, storyId, viewport, branch, defaultBranch, browser = DEFAULT_BROWSER) {
 		if (branch !== defaultBranch) {
-			const own = await this.getFor(projectId, storyId, viewport, branch);
+			const own = await this.getFor(projectId, storyId, viewport, branch, browser);
 			if (own) return own;
 		}
-		return this.getFor(projectId, storyId, viewport, defaultBranch);
+		return this.getFor(projectId, storyId, viewport, defaultBranch, browser);
+	}
+	/** Whether the project has any baseline captured on this engine. */
+	async hasAny(projectId, browser) {
+		return (await this.db.list(this.tables.baselines, {
+			where: and(eq(col(this.tables.baselines, "projectId"), projectId), eq(col(this.tables.baselines, "browser"), browser)),
+			limit: 1
+		})).length > 0;
+	}
+	/**
+	* Record the fingerprint of a baseline that predates fingerprints, without touching its
+	* screenshot. Lets the next environment change be detected instead of diffing as a regression.
+	*/
+	async backfillFingerprint(baseline, infraHash, fingerprint) {
+		const lifecycle = this.db.buildReferenceLifecycle;
+		if (lifecycle) {
+			const owner = {
+				type: "baseline",
+				id: baseline.id,
+				projectId: baseline.projectId
+			};
+			const generation = await lifecycle.referenceGeneration(owner);
+			await lifecycle.replaceFencedReferences(owner, generation, baseline.sourceBuildId ? [baseline.sourceBuildId] : [], async (tx) => {
+				const current = await tx.get(this.tables.baselines, baseline.id);
+				if (!current || current.projectId !== baseline.projectId || current.updatedAt !== baseline.updatedAt || current.sourceBuildId !== baseline.sourceBuildId || current.screenshotPath !== baseline.screenshotPath || current.fingerprint !== baseline.fingerprint) throw new BaselineWriteConflict("Baseline changed during fingerprint backfill; retry");
+				await tx.update(this.tables.baselines, baseline.id, {
+					infraHash,
+					fingerprint
+				});
+			});
+			return;
+		}
+		await this.db.update(this.tables.baselines, baseline.id, {
+			infraHash,
+			fingerprint
+		});
+	}
+	/**
+	* The content-addressed object a baseline should point at. A source that already is one is
+	* reused as is (no copy); a legacy per-build path is stored once by content.
+	*/
+	async contentFor(projectId, sourcePath) {
+		if (isContentPath(projectId, sourcePath)) return sourcePath;
+		return await storeScreenshot(this.storage, projectId, await this.storage.read(sourcePath));
 	}
 	async read(baseline) {
 		return await this.storage.read(baseline.screenshotPath);
 	}
-	async upsert(projectId, storyId, viewport, branch, snapshotId, sourcePath, infraHash) {
-		const screenshotPath = baselinePath(projectId, branch, storyId, viewport);
-		const source = await this.storage.read(sourcePath);
-		await this.storage.write(screenshotPath, source);
-		const existing = await this.getFor(projectId, storyId, viewport, branch);
+	async upsert(projectId, storyId, viewport, branch, snapshotId, sourcePath, infraHash, options = {}) {
+		const sourceBuildId = await this.sourceBuildId(projectId, storyId, viewport, snapshotId, sourcePath, options.browser);
+		const write = async () => await this.#upsertAt(projectId, storyId, viewport, branch, snapshotId, sourceBuildId, sourcePath, await this.contentFor(projectId, sourcePath), infraHash, options);
+		return isContentPath(projectId, sourcePath) ? await write() : await withContentClaim(this.storage, projectId, write);
+	}
+	async sourceBuildId(projectId, storyId, viewport, snapshotId, sourcePath, browser = DEFAULT_BROWSER) {
+		const snapshot = await this.db.get(this.db.tables.snapshots, snapshotId);
+		if (!snapshot || snapshot.projectId !== projectId || snapshot.storyId !== storyId || snapshot.viewportName !== viewport || (snapshot.browser ?? "chromium") !== browser || snapshot.screenshotPath !== sourcePath) return null;
+		return snapshot.inherited ? snapshot.sourceBuildId ?? null : snapshot.buildId;
+	}
+	async #upsertAt(projectId, storyId, viewport, branch, snapshotId, sourceBuildId, originalPath, screenshotPath, infraHash, options) {
+		const browser = options.browser ?? "chromium";
+		const existing = await this.getFor(projectId, storyId, viewport, branch, browser);
+		const lifecycle = this.db.buildReferenceLifecycle;
+		if (lifecycle) {
+			const approval = options.approval;
+			const baseline = await upsertAtomicBaseline(lifecycle, {
+				baselines: this.tables.baselines,
+				snapshots: this.db.tables.snapshots
+			}, {
+				id: existing?.id ?? ulid(),
+				existingId: existing?.id ?? null,
+				existingVersion: existing?.updatedAt ?? null,
+				projectId,
+				storyId,
+				viewport,
+				branch,
+				browser,
+				snapshotId,
+				sourceBuildId,
+				originalPath,
+				screenshotPath,
+				infraHash,
+				fingerprint: options.fingerprint,
+				mode: options.mode,
+				beforeWrite: approval ? async (tx) => await approveInTransaction(tx, this.db.tables, approval) : void 0
+			});
+			if (this.webhookTables) await emitWebhookEvent(this.db, this.webhookTables, projectId, existing ? "baseline:updated" : "baseline:created", {
+				baselineId: baseline.id,
+				storyId,
+				viewport,
+				browser,
+				mode: options.mode ?? null,
+				branch,
+				snapshotId
+			}, this.secret);
+			return baseline;
+		}
 		let baseline;
 		if (existing) {
 			baseline = await this.db.update(this.tables.baselines, existing.id, {
 				snapshotId,
+				sourceBuildId,
 				screenshotPath,
 				infraHash: infraHash ?? existing.infraHash ?? null,
+				fingerprint: options.fingerprint ?? existing.fingerprint ?? null,
+				mode: options.mode ?? existing.mode ?? null,
 				updatedAt: (/* @__PURE__ */ new Date()).toISOString()
 			});
 			if (this.webhookTables) await emitWebhookEvent(this.db, this.webhookTables, projectId, "baseline:updated", {
 				baselineId: baseline.id,
 				storyId,
 				viewport,
+				browser,
+				mode: options.mode ?? null,
 				branch,
 				snapshotId
 			}, this.secret);
@@ -66,8 +163,12 @@ var BaselineModel = class {
 				viewportName: viewport,
 				branch,
 				snapshotId,
+				sourceBuildId,
 				screenshotPath,
 				infraHash: infraHash ?? null,
+				fingerprint: options.fingerprint ?? null,
+				mode: options.mode ?? null,
+				browser,
 				createdAt: now,
 				updatedAt: now
 			});
@@ -75,6 +176,8 @@ var BaselineModel = class {
 				baselineId: baseline.id,
 				storyId,
 				viewport,
+				browser,
+				mode: options.mode ?? null,
 				branch,
 				snapshotId
 			}, this.secret);
@@ -82,26 +185,48 @@ var BaselineModel = class {
 		return baseline;
 	}
 	async list(projectId) {
-		return await this.db.list(this.tables.baselines, { where: eq(getTableColumns(this.tables.baselines)["projectId"], projectId) });
+		return await this.db.list(this.tables.baselines, { where: eq(col(this.tables.baselines, "projectId"), projectId) });
+	}
+	/**
+	* Delete a baseline's own file. A content-addressed screenshot is shared with snapshots and other
+	* baselines, so it is left for the retention sweep instead.
+	*/
+	async discardFile(baseline) {
+		if (isContentPath(baseline.projectId, baseline.screenshotPath)) return;
+		try {
+			await this.storage.delete(baseline.screenshotPath);
+		} catch {}
+	}
+	/** Drop the reference and row together when the adapter supports lifecycle protection. */
+	async removeRecord(baseline) {
+		const lifecycle = this.db.buildReferenceLifecycle;
+		if (lifecycle) {
+			const owner = {
+				type: "baseline",
+				projectId: baseline.projectId,
+				id: baseline.id
+			};
+			const generation = await lifecycle.referenceGeneration(owner);
+			await lifecycle.replaceFencedReferences(owner, generation, [], async (tx) => {
+				const current = await tx.get(this.tables.baselines, baseline.id);
+				if (!current) return;
+				if (current.updatedAt !== baseline.updatedAt || current.snapshotId !== baseline.snapshotId || current.sourceBuildId !== baseline.sourceBuildId || current.screenshotPath !== baseline.screenshotPath) throw new BaselineWriteConflict("Baseline changed during removal; retry");
+				await tx.remove(this.tables.baselines, baseline.id);
+			});
+			await this.discardFile(baseline);
+			return;
+		}
+		await this.discardFile(baseline);
+		await this.db.remove(this.tables.baselines, baseline.id);
 	}
 	async removeOrphans(projectId, validStoryIds) {
 		const toRemove = (await this.list(projectId)).filter((baseline) => !validStoryIds.has(baseline.storyId));
-		await Promise.all(toRemove.map(async (baseline) => {
-			try {
-				await this.storage.delete(baseline.screenshotPath);
-			} catch {}
-			await this.db.remove(this.tables.baselines, baseline.id);
-		}));
+		await Promise.all(toRemove.map(async (baseline) => await this.removeRecord(baseline)));
 		return toRemove.length;
 	}
 	async removeForBranch(projectId, branch) {
 		const toRemove = (await this.list(projectId)).filter((baseline) => baseline.branch === branch);
-		await Promise.all(toRemove.map(async (baseline) => {
-			try {
-				await this.storage.delete(baseline.screenshotPath);
-			} catch {}
-			await this.db.remove(this.tables.baselines, baseline.id);
-		}));
+		await Promise.all(toRemove.map(async (baseline) => await this.removeRecord(baseline)));
 		return toRemove.length;
 	}
 	async removeStaleBranches(projectId, staleBranches) {
@@ -109,7 +234,6 @@ var BaselineModel = class {
 		return (await Promise.all([...staleBranches].map((branch) => this.removeForBranch(projectId, branch)))).reduce((sum, count) => sum + count, 0);
 	}
 };
-//#endregion
 export { BaselineModel };
 
 //# sourceMappingURL=baseline.mjs.map

package/dist/models/baseline.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"baseline.mjs","names":[],"sources":["../../src/models/baseline.ts"],"sourcesContent":["/* oxlint-disable typescript/promise-function-async -- map callbacks return promises from async helpers */\n/** Per-branch baseline screenshots with default-branch fallback. */\nimport { and, eq, getTableColumns } from \"drizzle-orm\";\nimport type { SQLWrapper, Table } from \"drizzle-orm\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { emitWebhookEvent } from \"../adapters/webhook-events.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { baselinePath } from \"../utils/paths.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport type { WebhookTables } from \"./webhook.ts\";\n\n/** Tables required by {@link BaselineModel}. */\nexport interface BaselineTables {\n  baselines: Table;\n}\n\n/** Data operations for baseline screenshots. */\nexport class BaselineModel {\n  private readonly tables: BaselineTables;\n  private readonly storage: StorageAdapter;\n  private readonly secret?: SecretInput;\n  private readonly webhookTables?: WebhookTables;\n  constructor(\n    private readonly db: DatabaseAdapter,\n    tables?: BaselineTables,\n    storage?: StorageAdapter,\n    secret?: SecretInput,\n    webhookTables?: WebhookTables,\n  ) {\n    this.tables = tables ?? { baselines: db.tables.baselines };\n    this.storage = storage as StorageAdapter;\n    this.secret = secret;\n    this.webhookTables = webhookTables;\n  }\n\n  async getFor(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n  ): Promise<Baseline | null> {\n    const rows = (await this.db.list(this.tables.baselines, {\n      where: and(\n        eq(getTableColumns(this.tables.baselines)[\"projectId\"] as unknown as SQLWrapper, projectId),\n        eq(getTableColumns(this.tables.baselines)[\"storyId\"] as unknown as SQLWrapper, storyId),\n        eq(\n          getTableColumns(this.tables.baselines)[\"viewportName\"] as unknown as SQLWrapper,\n          viewport,\n        ),\n        eq(getTableColumns(this.tables.baselines)[\"branch\"] as unknown as SQLWrapper, branch),\n      ),\n      limit: 1,\n    })) as unknown as Baseline[];\n    return rows[0] ?? null;\n  }\n\n  async resolve(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    defaultBranch: string,\n  ): Promise<Baseline | null> {\n    if (branch !== defaultBranch) {\n      const own = await this.getFor(projectId, storyId, viewport, branch);\n      if (own) {\n        return own;\n      }\n    }\n    return this.getFor(projectId, storyId, viewport, defaultBranch);\n  }\n\n  async read(baseline: Baseline): Promise<Buffer> {\n    return await this.storage.read(baseline.screenshotPath);\n  }\n\n  async upsert(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    snapshotId: string,\n    sourcePath: string,\n    infraHash?: string | null,\n  ): Promise<Baseline> {\n    const screenshotPath = baselinePath(projectId, branch, storyId, viewport);\n    const source = await this.storage.read(sourcePath);\n    await this.storage.write(screenshotPath, source);\n\n    const existing = await this.getFor(projectId, storyId, viewport, branch);\n    let baseline: Baseline;\n    if (existing) {\n      baseline = (await this.db.update(this.tables.baselines, existing.id, {\n        snapshotId,\n        screenshotPath,\n        infraHash: infraHash ?? existing.infraHash ?? null,\n        updatedAt: new Date().toISOString(),\n      })) as unknown as Baseline;\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          \"baseline:updated\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n    } else {\n      const now = new Date().toISOString();\n      baseline = (await this.db.insert(this.tables.baselines, {\n        id: ulid(),\n        projectId,\n        storyId,\n        viewportName: viewport,\n        branch,\n        snapshotId,\n        screenshotPath,\n        infraHash: infraHash ?? null,\n        createdAt: now,\n        updatedAt: now,\n      })) as unknown as Baseline;\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          \"baseline:created\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n    }\n    return baseline;\n  }\n\n  async list(projectId: string): Promise<Baseline[]> {\n    return (await this.db.list(this.tables.baselines, {\n      where: eq(\n        getTableColumns(this.tables.baselines)[\"projectId\"] as unknown as SQLWrapper,\n        projectId,\n      ),\n    })) as unknown as Baseline[];\n  }\n\n  async removeOrphans(projectId: string, validStoryIds: Set<string>): Promise<number> {\n    const all = await this.list(projectId);\n    const toRemove = all.filter((baseline) => !validStoryIds.has(baseline.storyId));\n    await Promise.all(\n      toRemove.map(async (baseline) => {\n        try {\n          await this.storage.delete(baseline.screenshotPath);\n        } catch {\n          // ignore missing file\n        }\n        await this.db.remove(this.tables.baselines, baseline.id);\n      }),\n    );\n    return toRemove.length;\n  }\n\n  async removeForBranch(projectId: string, branch: string): Promise<number> {\n    const all = await this.list(projectId);\n    const toRemove = all.filter((baseline) => baseline.branch === branch);\n    await Promise.all(\n      toRemove.map(async (baseline) => {\n        try {\n          await this.storage.delete(baseline.screenshotPath);\n        } catch {\n          // ignore missing file\n        }\n        await this.db.remove(this.tables.baselines, baseline.id);\n      }),\n    );\n    return toRemove.length;\n  }\n\n  // oxlint-disable-next-line eslint/require-await -- delegates to async removeForBranch via Promise.all\n  async removeStaleBranches(\n    projectId: string,\n    staleBranches: ReadonlySet<string>,\n  ): Promise<number> {\n    if (staleBranches.size === 0) {\n      return 0;\n    }\n    const results = await Promise.all(\n      [...staleBranches].map((branch) => this.removeForBranch(projectId, branch)),\n    );\n    return results.reduce((sum, count) => sum + count, 0);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"baseline.mjs","names":[],"sources":["../../src/models/baseline.ts"],"sourcesContent":["/* oxlint-disable typescript/promise-function-async -- map callbacks return promises from async helpers */\n/** Per-branch baseline screenshots with default-branch fallback. */\nimport { and, eq } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport { DEFAULT_BROWSER } from \"../adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { emitWebhookEvent } from \"../adapters/webhook-events.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { Snapshot } from \"../schema/snapshot.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { isContentPath } from \"../utils/paths.ts\";\nimport { storeScreenshot, withContentClaim } from \"../utils/screenshot-store.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { approveInTransaction, type AtomicBaselineApproval } from \"./baseline-approval.ts\";\nimport { upsertAtomicBaseline } from \"./baseline-atomic.ts\";\nimport { BaselineWriteConflict } from \"./baseline-conflict.ts\";\nimport { col } from \"./columns.ts\";\nimport type { WebhookTables } from \"./webhook.ts\";\n\n/** Extra identity/metadata for {@link BaselineModel.upsert}. */\nexport interface BaselineUpsertOptions {\n  approval?: AtomicBaselineApproval;\n  /** Engine the baseline belongs to (default chromium). */\n  browser?: string;\n  /** Resolved mode definition as JSON (display only). */\n  mode?: string | null;\n  /** JSON `Fingerprint` behind the `infraHash` being written. */\n  fingerprint?: string | null;\n}\n\n/** Tables required by {@link BaselineModel}. */\nexport interface BaselineTables {\n  baselines: Table;\n}\n\n/** Data operations for baseline screenshots. */\nexport class BaselineModel {\n  private readonly tables: BaselineTables;\n  private readonly storage: StorageAdapter;\n  private readonly secret?: SecretInput;\n  private readonly webhookTables?: WebhookTables;\n  private readonly db: DatabaseAdapter;\n\n  constructor(\n    db: DatabaseAdapter,\n    tables?: BaselineTables,\n    storage?: StorageAdapter,\n    secret?: SecretInput,\n    webhookTables?: WebhookTables,\n  ) {\n    this.db = db;\n    this.tables = tables ?? { baselines: db.tables.baselines };\n    this.storage = storage as StorageAdapter;\n    this.secret = secret;\n    this.webhookTables = webhookTables;\n  }\n\n  async getFor(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    browser: string = DEFAULT_BROWSER,\n  ): Promise<Baseline | null> {\n    const rows = (await this.db.list(this.tables.baselines, {\n      where: and(\n        eq(col(this.tables.baselines, \"projectId\"), projectId),\n        eq(col(this.tables.baselines, \"storyId\"), storyId),\n        eq(col(this.tables.baselines, \"viewportName\"), viewport),\n        eq(col(this.tables.baselines, \"branch\"), branch),\n        eq(col(this.tables.baselines, \"browser\"), browser),\n      ),\n      limit: 1,\n    })) as unknown as Baseline[];\n    return rows[0] ?? null;\n  }\n\n  async resolve(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    defaultBranch: string,\n    browser: string = DEFAULT_BROWSER,\n  ): Promise<Baseline | null> {\n    if (branch !== defaultBranch) {\n      const own = await this.getFor(projectId, storyId, viewport, branch, browser);\n      if (own) {\n        return own;\n      }\n    }\n    return this.getFor(projectId, storyId, viewport, defaultBranch, browser);\n  }\n\n  /** Whether the project has any baseline captured on this engine. */\n  async hasAny(projectId: string, browser: string): Promise<boolean> {\n    const rows = (await this.db.list(this.tables.baselines, {\n      where: and(\n        eq(col(this.tables.baselines, \"projectId\"), projectId),\n        eq(col(this.tables.baselines, \"browser\"), browser),\n      ),\n      limit: 1,\n    })) as unknown as Baseline[];\n    return rows.length > 0;\n  }\n\n  /**\n   * Record the fingerprint of a baseline that predates fingerprints, without touching its\n   * screenshot. Lets the next environment change be detected instead of diffing as a regression.\n   */\n  async backfillFingerprint(\n    baseline: Baseline,\n    infraHash: string,\n    fingerprint: string,\n  ): Promise<void> {\n    const lifecycle = this.db.buildReferenceLifecycle;\n    if (lifecycle) {\n      const owner = { type: \"baseline\" as const, id: baseline.id, projectId: baseline.projectId };\n      const generation = await lifecycle.referenceGeneration(owner);\n      await lifecycle.replaceFencedReferences(\n        owner,\n        generation,\n        baseline.sourceBuildId ? [baseline.sourceBuildId] : [],\n        async (tx) => {\n          const current = (await tx.get(\n            this.tables.baselines,\n            baseline.id,\n          )) as unknown as Baseline | null;\n          if (\n            !current ||\n            current.projectId !== baseline.projectId ||\n            current.updatedAt !== baseline.updatedAt ||\n            current.sourceBuildId !== baseline.sourceBuildId ||\n            current.screenshotPath !== baseline.screenshotPath ||\n            current.fingerprint !== baseline.fingerprint\n          )\n            throw new BaselineWriteConflict(\"Baseline changed during fingerprint backfill; retry\");\n          await tx.update(this.tables.baselines, baseline.id, { infraHash, fingerprint });\n        },\n      );\n      return;\n    }\n    await this.db.update(this.tables.baselines, baseline.id, { infraHash, fingerprint });\n  }\n\n  /**\n   * The content-addressed object a baseline should point at. A source that already is one is\n   * reused as is (no copy); a legacy per-build path is stored once by content.\n   */\n  private async contentFor(projectId: string, sourcePath: string): Promise<string> {\n    if (isContentPath(projectId, sourcePath)) {\n      return sourcePath;\n    }\n    return await storeScreenshot(this.storage, projectId, await this.storage.read(sourcePath));\n  }\n\n  async read(baseline: Baseline): Promise<Buffer> {\n    return await this.storage.read(baseline.screenshotPath);\n  }\n\n  async upsert(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    snapshotId: string,\n    sourcePath: string,\n    infraHash?: string | null,\n    options: BaselineUpsertOptions = {},\n  ): Promise<Baseline> {\n    const sourceBuildId = await this.sourceBuildId(\n      projectId,\n      storyId,\n      viewport,\n      snapshotId,\n      sourcePath,\n      options.browser,\n    );\n    const write = async (): Promise<Baseline> =>\n      await this.#upsertAt(\n        projectId,\n        storyId,\n        viewport,\n        branch,\n        snapshotId,\n        sourceBuildId,\n        sourcePath,\n        await this.contentFor(projectId, sourcePath),\n        infraHash,\n        options,\n      );\n    // Storing a legacy source may reuse an object the sweep is about to delete: claim it until the\n    // row points at it. A content source is already referenced by its snapshot row.\n    return isContentPath(projectId, sourcePath)\n      ? await write()\n      : await withContentClaim(this.storage, projectId, write);\n  }\n\n  private async sourceBuildId(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    snapshotId: string,\n    sourcePath: string,\n    browser: string = DEFAULT_BROWSER,\n  ): Promise<string | null> {\n    const snapshot = (await this.db.get(\n      this.db.tables.snapshots,\n      snapshotId,\n    )) as unknown as Snapshot | null;\n    if (\n      !snapshot ||\n      snapshot.projectId !== projectId ||\n      snapshot.storyId !== storyId ||\n      snapshot.viewportName !== viewport ||\n      (snapshot.browser ?? DEFAULT_BROWSER) !== browser ||\n      snapshot.screenshotPath !== sourcePath\n    )\n      return null;\n    return snapshot.inherited ? (snapshot.sourceBuildId ?? null) : snapshot.buildId;\n  }\n\n  async #upsertAt(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    snapshotId: string,\n    sourceBuildId: string | null,\n    originalPath: string,\n    screenshotPath: string,\n    infraHash: string | null | undefined,\n    options: BaselineUpsertOptions,\n  ): Promise<Baseline> {\n    const browser = options.browser ?? DEFAULT_BROWSER;\n\n    const existing = await this.getFor(projectId, storyId, viewport, branch, browser);\n    const lifecycle = this.db.buildReferenceLifecycle;\n    if (lifecycle) {\n      const approval = options.approval;\n      const baseline = await upsertAtomicBaseline(\n        lifecycle,\n        { baselines: this.tables.baselines, snapshots: this.db.tables.snapshots },\n        {\n          id: existing?.id ?? ulid(),\n          existingId: existing?.id ?? null,\n          existingVersion: existing?.updatedAt ?? null,\n          projectId,\n          storyId,\n          viewport,\n          branch,\n          browser,\n          snapshotId,\n          sourceBuildId,\n          originalPath,\n          screenshotPath,\n          infraHash,\n          fingerprint: options.fingerprint,\n          mode: options.mode,\n          beforeWrite: approval\n            ? async (tx): Promise<void> => await approveInTransaction(tx, this.db.tables, approval)\n            : undefined,\n        },\n      );\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          existing ? \"baseline:updated\" : \"baseline:created\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            browser,\n            mode: options.mode ?? null,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n      return baseline;\n    }\n    let baseline: Baseline;\n    if (existing) {\n      baseline = (await this.db.update(this.tables.baselines, existing.id, {\n        snapshotId,\n        sourceBuildId,\n        screenshotPath,\n        infraHash: infraHash ?? existing.infraHash ?? null,\n        fingerprint: options.fingerprint ?? existing.fingerprint ?? null,\n        mode: options.mode ?? existing.mode ?? null,\n        updatedAt: new Date().toISOString(),\n      })) as unknown as Baseline;\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          \"baseline:updated\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            browser,\n            mode: options.mode ?? null,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n    } else {\n      const now = new Date().toISOString();\n      baseline = (await this.db.insert(this.tables.baselines, {\n        id: ulid(),\n        projectId,\n        storyId,\n        viewportName: viewport,\n        branch,\n        snapshotId,\n        sourceBuildId,\n        screenshotPath,\n        infraHash: infraHash ?? null,\n        fingerprint: options.fingerprint ?? null,\n        mode: options.mode ?? null,\n        browser,\n        createdAt: now,\n        updatedAt: now,\n      })) as unknown as Baseline;\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          \"baseline:created\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            browser,\n            mode: options.mode ?? null,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n    }\n    return baseline;\n  }\n\n  async list(projectId: string): Promise<Baseline[]> {\n    return (await this.db.list(this.tables.baselines, {\n      where: eq(col(this.tables.baselines, \"projectId\"), projectId),\n    })) as unknown as Baseline[];\n  }\n\n  /**\n   * Delete a baseline's own file. A content-addressed screenshot is shared with snapshots and other\n   * baselines, so it is left for the retention sweep instead.\n   */\n  private async discardFile(baseline: Baseline): Promise<void> {\n    if (isContentPath(baseline.projectId, baseline.screenshotPath)) {\n      return;\n    }\n    try {\n      await this.storage.delete(baseline.screenshotPath);\n    } catch {\n      // ignore missing file\n    }\n  }\n\n  /** Drop the reference and row together when the adapter supports lifecycle protection. */\n  private async removeRecord(baseline: Baseline): Promise<void> {\n    const lifecycle = this.db.buildReferenceLifecycle;\n    if (lifecycle) {\n      const owner = { type: \"baseline\" as const, projectId: baseline.projectId, id: baseline.id };\n      const generation = await lifecycle.referenceGeneration(owner);\n      await lifecycle.replaceFencedReferences(owner, generation, [], async (tx) => {\n        const current = (await tx.get(\n          this.tables.baselines,\n          baseline.id,\n        )) as unknown as Baseline | null;\n        if (!current) return;\n        if (\n          current.updatedAt !== baseline.updatedAt ||\n          current.snapshotId !== baseline.snapshotId ||\n          current.sourceBuildId !== baseline.sourceBuildId ||\n          current.screenshotPath !== baseline.screenshotPath\n        ) {\n          throw new BaselineWriteConflict(\"Baseline changed during removal; retry\");\n        }\n        await tx.remove(this.tables.baselines, baseline.id);\n      });\n      await this.discardFile(baseline);\n      return;\n    }\n    await this.discardFile(baseline);\n    await this.db.remove(this.tables.baselines, baseline.id);\n  }\n\n  async removeOrphans(projectId: string, validStoryIds: Set<string>): Promise<number> {\n    const all = await this.list(projectId);\n    const toRemove = all.filter((baseline) => !validStoryIds.has(baseline.storyId));\n    await Promise.all(toRemove.map(async (baseline) => await this.removeRecord(baseline)));\n    return toRemove.length;\n  }\n\n  async removeForBranch(projectId: string, branch: string): Promise<number> {\n    const all = await this.list(projectId);\n    const toRemove = all.filter((baseline) => baseline.branch === branch);\n    await Promise.all(toRemove.map(async (baseline) => await this.removeRecord(baseline)));\n    return toRemove.length;\n  }\n\n  // oxlint-disable-next-line eslint/require-await -- delegates to async removeForBranch via Promise.all\n  async removeStaleBranches(\n    projectId: string,\n    staleBranches: ReadonlySet<string>,\n  ): Promise<number> {\n    if (staleBranches.size === 0) {\n      return 0;\n    }\n    const results = await Promise.all(\n      [...staleBranches].map((branch) => this.removeForBranch(projectId, branch)),\n    );\n    return results.reduce((sum, count) => sum + count, 0);\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,26 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DatabaseAdapter } from "../adapter/database.mjs";
+import { BuildComponent } from "../schema/build-component.mjs";
+import { Table } from "drizzle-orm";
+/** Tables required by {@link BuildComponentModel}. */
+interface BuildComponentTables {
+  buildComponents: Table;
+}
+/** What a build records of one component. */
+type BuildComponentInput = Pick<BuildComponent, "importPath" | "title" | "storyCount" | "hash">;
+/** Data operations for the components each published build holds. */
+declare class BuildComponentModel {
+  #private;
+  constructor(db: DatabaseAdapter, tables?: BuildComponentTables);
+  /** Components of one build, ordered by title then file. */
+  listByBuild(buildId: string): Promise<BuildComponent[]>;
+  /** Rows of one story file across the project's builds, newest first: "which builds contain it". */
+  listByImportPath(projectId: string, importPath: string): Promise<BuildComponent[]>;
+  /** Replace a build's rows with `components`; repeating a publish never duplicates. */
+  replaceForBuild(projectId: string, buildId: string, components: readonly BuildComponentInput[]): Promise<void>;
+  /** Forget a build's rows (the foreign key cascades too; stub tables have none). */
+  removeForBuild(buildId: string): Promise<number>;
+}
+export { BuildComponentInput, BuildComponentModel, BuildComponentTables };
+//# sourceMappingURL=build-component.d.mts.map

package/dist/models/build-component.mjs

@@ -0,0 +1,54 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { ulid } from "../utils/ulid.mjs";
+import { col } from "./columns.mjs";
+import { and, asc, desc, eq } from "drizzle-orm";
+// src/models/build-component.ts
+/** Component rows of published builds (`build_components`, ADR 0006 decision 9). */
+/** Data operations for the components each published build holds. */
+var BuildComponentModel = class {
+	#db;
+	#table;
+	constructor(db, tables) {
+		this.#db = db;
+		this.#table = (tables ?? { buildComponents: db.tables.buildComponents }).buildComponents;
+	}
+	/** Components of one build, ordered by title then file. */
+	async listByBuild(buildId) {
+		return (await this.#db.list(this.#table, {
+			where: eq(col(this.#table, "buildId"), buildId),
+			orderBy: asc(col(this.#table, "title"))
+		})).toSorted((a, b) => a.title.localeCompare(b.title) || a.importPath.localeCompare(b.importPath));
+	}
+	/** Rows of one story file across the project's builds, newest first: "which builds contain it". */
+	async listByImportPath(projectId, importPath) {
+		return await this.#db.list(this.#table, {
+			where: and(eq(col(this.#table, "projectId"), projectId), eq(col(this.#table, "importPath"), importPath)),
+			orderBy: desc(col(this.#table, "createdAt"))
+		});
+	}
+	/** Replace a build's rows with `components`; repeating a publish never duplicates. */
+	async replaceForBuild(projectId, buildId, components) {
+		await this.removeForBuild(buildId);
+		const createdAt = (/* @__PURE__ */ new Date()).toISOString();
+		for (const component of components) await this.#db.insert(this.#table, {
+			id: ulid(),
+			projectId,
+			buildId,
+			createdAt,
+			...component
+		});
+	}
+	/** Forget a build's rows (the foreign key cascades too; stub tables have none). */
+	async removeForBuild(buildId) {
+		const rows = await this.#db.list(this.#table, { where: eq(col(this.#table, "buildId"), buildId) });
+		await Promise.all(rows.map(async (row) => {
+			await this.#db.remove(this.#table, row.id);
+		}));
+		return rows.length;
+	}
+};
+export { BuildComponentModel };
+
+//# sourceMappingURL=build-component.mjs.map

package/dist/models/build-component.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-component.mjs","names":[],"sources":["../../src/models/build-component.ts"],"sourcesContent":["/** Component rows of published builds (`build_components`, ADR 0006 decision 9). */\nimport { and, asc, desc, eq } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { BuildComponent } from \"../schema/build-component.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\n\n/** Tables required by {@link BuildComponentModel}. */\nexport interface BuildComponentTables {\n  buildComponents: Table;\n}\n\n/** What a build records of one component. */\nexport type BuildComponentInput = Pick<\n  BuildComponent,\n  \"importPath\" | \"title\" | \"storyCount\" | \"hash\"\n>;\n\n/** Data operations for the components each published build holds. */\nexport class BuildComponentModel {\n  readonly #db: DatabaseAdapter;\n  readonly #table: Table;\n\n  constructor(db: DatabaseAdapter, tables?: BuildComponentTables) {\n    this.#db = db;\n    this.#table = (tables ?? { buildComponents: db.tables.buildComponents }).buildComponents;\n  }\n\n  /** Components of one build, ordered by title then file. */\n  async listByBuild(buildId: string): Promise<BuildComponent[]> {\n    const rows = (await this.#db.list(this.#table, {\n      where: eq(col(this.#table, \"buildId\"), buildId),\n      orderBy: asc(col(this.#table, \"title\")),\n    })) as unknown as BuildComponent[];\n    return rows.toSorted(\n      (a, b) => a.title.localeCompare(b.title) || a.importPath.localeCompare(b.importPath),\n    );\n  }\n\n  /** Rows of one story file across the project's builds, newest first: \"which builds contain it\". */\n  async listByImportPath(projectId: string, importPath: string): Promise<BuildComponent[]> {\n    const rows = (await this.#db.list(this.#table, {\n      where: and(\n        eq(col(this.#table, \"projectId\"), projectId),\n        eq(col(this.#table, \"importPath\"), importPath),\n      ),\n      orderBy: desc(col(this.#table, \"createdAt\")),\n    })) as unknown as BuildComponent[];\n    return rows;\n  }\n\n  /** Replace a build's rows with `components`; repeating a publish never duplicates. */\n  async replaceForBuild(\n    projectId: string,\n    buildId: string,\n    components: readonly BuildComponentInput[],\n  ): Promise<void> {\n    await this.removeForBuild(buildId);\n    const createdAt = new Date().toISOString();\n    for (const component of components) {\n      // eslint-disable-next-line no-await-in-loop -- rows are few; sequential inserts keep ids ordered\n      await this.#db.insert(this.#table, {\n        id: ulid(),\n        projectId,\n        buildId,\n        createdAt,\n        ...component,\n      });\n    }\n  }\n\n  /** Forget a build's rows (the foreign key cascades too; stub tables have none). */\n  async removeForBuild(buildId: string): Promise<number> {\n    const rows = (await this.#db.list(this.#table, {\n      where: eq(col(this.#table, \"buildId\"), buildId),\n    })) as unknown as BuildComponent[];\n    await Promise.all(\n      rows.map(async (row) => {\n        await this.#db.remove(this.#table, row.id);\n      }),\n    );\n    return rows.length;\n  }\n}\n"],"mappings":";;;;;;;;;AAoBA,IAAa,sBAAb,MAAiC;CAC/B;CACA;CAEA,YAAY,IAAqB,QAA+B;EAC9D,KAAK,MAAM;EACX,KAAK,UAAU,UAAU,EAAE,iBAAiB,GAAG,OAAO,gBAAgB,EAAA,CAAG;CAC3E;;CAGA,MAAM,YAAY,SAA4C;EAK5D,QAAO,MAJa,KAAK,IAAI,KAAK,KAAK,QAAQ;GAC7C,OAAO,GAAG,IAAI,KAAK,QAAQ,SAAS,GAAG,OAAO;GAC9C,SAAS,IAAI,IAAI,KAAK,QAAQ,OAAO,CAAC;EACxC,CAAC,EAAA,CACW,UACT,GAAG,MAAM,EAAE,MAAM,cAAc,EAAE,KAAK,KAAK,EAAE,WAAW,cAAc,EAAE,UAAU,CACrF;CACF;;CAGA,MAAM,iBAAiB,WAAmB,YAA+C;EAQvF,OAAO,MAPa,KAAK,IAAI,KAAK,KAAK,QAAQ;GAC7C,OAAO,IACL,GAAG,IAAI,KAAK,QAAQ,WAAW,GAAG,SAAS,GAC3C,GAAG,IAAI,KAAK,QAAQ,YAAY,GAAG,UAAU,CAC/C;GACA,SAAS,KAAK,IAAI,KAAK,QAAQ,WAAW,CAAC;EAC7C,CAAC;CAEH;;CAGA,MAAM,gBACJ,WACA,SACA,YACe;EACf,MAAM,KAAK,eAAe,OAAO;EACjC,MAAM,6BAAY,IAAI,KAAK,EAAA,CAAE,YAAY;EACzC,KAAK,MAAM,aAAa,YAEtB,MAAM,KAAK,IAAI,OAAO,KAAK,QAAQ;GACjC,IAAI,KAAK;GACT;GACA;GACA;GACA,GAAG;EACL,CAAC;CAEL;;CAGA,MAAM,eAAe,SAAkC;EACrD,MAAM,OAAQ,MAAM,KAAK,IAAI,KAAK,KAAK,QAAQ,EAC7C,OAAO,GAAG,IAAI,KAAK,QAAQ,SAAS,GAAG,OAAO,EAChD,CAAC;EACD,MAAM,QAAQ,IACZ,KAAK,IAAI,OAAO,QAAQ;GACtB,MAAM,KAAK,IAAI,OAAO,KAAK,QAAQ,IAAI,EAAE;EAC3C,CAAC,CACH;EACA,OAAO,KAAK;CACd;AACF"}

package/dist/models/build-review-status.d.mts

@@ -0,0 +1,27 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BuildReview } from "../schema/build-review.mjs";
+/** What {@link deriveReviewStatus} depends on. */
+interface ReviewStatusInput {
+  /** `testing` is on: the snapshot rollup decides and verdicts never gate. */
+  testing: boolean;
+  /** The project's review switch. */
+  review: boolean;
+  /** `projects.review_approvals`: approvals a build needs (at least 1). */
+  approvalsRequired: number;
+  /** Every verdict given to the build, in any order; see {@link latestVerdicts}. */
+  reviews: readonly Pick<BuildReview, "id" | "userId" | "verdict" | "createdAt">[];
+}
+/**
+ * The status the verdicts give the build, or `null` when they do not decide it (`testing` is on,
+ * or review is off and the build was accepted when it was published).
+ *
+ * - `rejected` when any reviewer's latest verdict is `rejected`;
+ * - `approved` once the required approvals are present among the latest verdicts;
+ * - `pending` otherwise.
+ */
+declare function deriveReviewStatus(input: ReviewStatusInput): "approved" | "rejected" | "pending" | null;
+/** Each reviewer's latest verdict (newest `createdAt`, then newest id), oldest reviewer first. */
+declare function latestVerdicts<T extends Pick<BuildReview, "id" | "userId" | "createdAt">>(reviews: readonly T[]): T[];
+export { ReviewStatusInput, deriveReviewStatus, latestVerdicts };
+//# sourceMappingURL=build-review-status.d.mts.map

package/dist/models/build-review-status.mjs

@@ -0,0 +1,36 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/models/build-review-status.ts
+/** Reviewer key standing for verdicts without a user (auth off or an admin token): one reviewer. */
+const ANONYMOUS_REVIEWER = "";
+/**
+* The status the verdicts give the build, or `null` when they do not decide it (`testing` is on,
+* or review is off and the build was accepted when it was published).
+*
+* - `rejected` when any reviewer's latest verdict is `rejected`;
+* - `approved` once the required approvals are present among the latest verdicts;
+* - `pending` otherwise.
+*/
+function deriveReviewStatus(input) {
+	if (input.testing || !input.review) return null;
+	const latest = latestVerdicts(input.reviews);
+	if (latest.some((review) => review.verdict === "rejected")) return "rejected";
+	return latest.filter((review) => review.verdict === "approved").length >= Math.max(1, input.approvalsRequired) ? "approved" : "pending";
+}
+/** Each reviewer's latest verdict (newest `createdAt`, then newest id), oldest reviewer first. */
+function latestVerdicts(reviews) {
+	const latest = /* @__PURE__ */ new Map();
+	for (const review of reviews) {
+		const key = review.userId ?? ANONYMOUS_REVIEWER;
+		const current = latest.get(key);
+		if (current === void 0 || isNewer(review, current)) latest.set(key, review);
+	}
+	return [...latest.values()].toSorted((a, b) => isNewer(b, a) ? -1 : 1);
+}
+function isNewer(a, b) {
+	return a.createdAt === b.createdAt ? a.id > b.id : a.createdAt > b.createdAt;
+}
+export { deriveReviewStatus, latestVerdicts };
+
+//# sourceMappingURL=build-review-status.mjs.map

package/dist/models/build-review-status.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-review-status.mjs","names":[],"sources":["../../src/models/build-review-status.ts"],"sourcesContent":["/**\n * What the build-level verdicts make of a build (ADR 0013, decision 3). Pure: callers read the\n * reviews and the project, apply the result, and stay free of branching.\n */\nimport type { BuildReview } from \"../schema/build-review.ts\";\n\n/** What {@link deriveReviewStatus} depends on. */\nexport interface ReviewStatusInput {\n  /** `testing` is on: the snapshot rollup decides and verdicts never gate. */\n  testing: boolean;\n  /** The project's review switch. */\n  review: boolean;\n  /** `projects.review_approvals`: approvals a build needs (at least 1). */\n  approvalsRequired: number;\n  /** Every verdict given to the build, in any order; see {@link latestVerdicts}. */\n  reviews: readonly Pick<BuildReview, \"id\" | \"userId\" | \"verdict\" | \"createdAt\">[];\n}\n\n/** Reviewer key standing for verdicts without a user (auth off or an admin token): one reviewer. */\nconst ANONYMOUS_REVIEWER = \"\";\n\n/**\n * The status the verdicts give the build, or `null` when they do not decide it (`testing` is on,\n * or review is off and the build was accepted when it was published).\n *\n * - `rejected` when any reviewer's latest verdict is `rejected`;\n * - `approved` once the required approvals are present among the latest verdicts;\n * - `pending` otherwise.\n */\nexport function deriveReviewStatus(\n  input: ReviewStatusInput,\n): \"approved\" | \"rejected\" | \"pending\" | null {\n  if (input.testing || !input.review) {\n    return null;\n  }\n  const latest = latestVerdicts(input.reviews);\n  if (latest.some((review) => review.verdict === \"rejected\")) {\n    return \"rejected\";\n  }\n  const approvals = latest.filter((review) => review.verdict === \"approved\").length;\n  return approvals >= Math.max(1, input.approvalsRequired) ? \"approved\" : \"pending\";\n}\n\n/** Each reviewer's latest verdict (newest `createdAt`, then newest id), oldest reviewer first. */\nexport function latestVerdicts<T extends Pick<BuildReview, \"id\" | \"userId\" | \"createdAt\">>(\n  reviews: readonly T[],\n): T[] {\n  const latest = new Map<string, T>();\n  for (const review of reviews) {\n    const key = review.userId ?? ANONYMOUS_REVIEWER;\n    const current = latest.get(key);\n    if (current === undefined || isNewer(review, current)) {\n      latest.set(key, review);\n    }\n  }\n  return [...latest.values()].toSorted((a, b) => (isNewer(b, a) ? -1 : 1));\n}\n\nfunction isNewer(\n  a: Pick<BuildReview, \"id\" | \"createdAt\">,\n  b: Pick<BuildReview, \"id\" | \"createdAt\">,\n): boolean {\n  return a.createdAt === b.createdAt ? a.id > b.id : a.createdAt > b.createdAt;\n}\n"],"mappings":";;;;;AAmBA,MAAM,qBAAqB;;;;;;;;;AAU3B,SAAgB,mBACd,OAC4C;CAC5C,IAAI,MAAM,WAAW,CAAC,MAAM,QAC1B,OAAO;CAET,MAAM,SAAS,eAAe,MAAM,OAAO;CAC3C,IAAI,OAAO,MAAM,WAAW,OAAO,YAAY,UAAU,GACvD,OAAO;CAGT,OADkB,OAAO,QAAQ,WAAW,OAAO,YAAY,UAAU,CAAC,CAAC,UACvD,KAAK,IAAI,GAAG,MAAM,iBAAiB,IAAI,aAAa;AAC1E;;AAGA,SAAgB,eACd,SACK;CACL,MAAM,yBAAS,IAAI,IAAe;CAClC,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,MAAM,OAAO,UAAU;EAC7B,MAAM,UAAU,OAAO,IAAI,GAAG;EAC9B,IAAI,YAAY,KAAA,KAAa,QAAQ,QAAQ,OAAO,GAClD,OAAO,IAAI,KAAK,MAAM;CAE1B;CACA,OAAO,CAAC,GAAG,OAAO,OAAO,CAAC,CAAC,CAAC,UAAU,GAAG,MAAO,QAAQ,GAAG,CAAC,IAAI,KAAK,CAAE;AACzE;AAEA,SAAS,QACP,GACA,GACS;CACT,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE;AACrE"}

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

@@ -0,0 +1,26 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DatabaseAdapter } from "../adapter/database.mjs";
+import { ReviewVerdict } from "../types.mjs";
+import { BuildReview } from "../schema/build-review.mjs";
+import { Table } from "drizzle-orm";
+/** Tables required by {@link BuildReviewModel}. */
+interface BuildReviewTables {
+  buildReviews: Table;
+}
+/** Data operations for the verdicts reviewers give a build. */
+declare class BuildReviewModel {
+  #private;
+  constructor(db: DatabaseAdapter, tables?: BuildReviewTables);
+  /**
+   * Record a verdict. A reviewer rewrites theirs by adding another row; the newest row counts.
+   * `createdAt` is strictly increasing within a build, so "newest" never ties.
+   */
+  add(buildId: string, userId: string | null, verdict: ReviewVerdict, body?: string): Promise<BuildReview>;
+  /** Every verdict of a build, oldest first. */
+  listByBuild(buildId: string): Promise<BuildReview[]>;
+  /** Each reviewer's latest verdict on a build. */
+  latestByBuild(buildId: string): Promise<BuildReview[]>;
+}
+export { BuildReviewModel, BuildReviewTables };
+//# sourceMappingURL=build-review.d.mts.map