@storyshelf/core 0.7.0 → 0.9.0-next-d2cc082

package/dist/models/insight.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { InsightKind, InsightRow } from "../schema/insight.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/insight.d.ts
 /** Tables required by {@link InsightModel}. */
 interface InsightTables {
   insights: Table;
@@ -65,6 +64,5 @@ declare class InsightModel {
   private restartIfNeeded;
   private col;
 }
-//#endregion
 export { InsightModel, InsightResultInput, InsightStartInput, InsightStartResult, InsightTables };
 //# sourceMappingURL=insight.d.mts.map

package/dist/models/insight.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, asc, desc, eq, inArray, isNull, lt } from "drizzle-orm";
-//#region src/models/insight.ts
+// src/models/insight.ts
 /** Insight rows: pending/running/done/failed runs with dedupe by unique key. */
 /** Data operations for insights. */
 var InsightModel = class {
@@ -156,7 +156,6 @@ function pick(input) {
 		promptVersion: input.promptVersion
 	};
 }
-//#endregion
 export { InsightModel };
 
 //# sourceMappingURL=insight.mjs.map

package/dist/models/label.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { BuildLabel, LabelType } from "../schema/label.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/label.d.ts
 /** Tables required by {@link LabelModel}. */
 interface LabelTables {
   builds: Table;
@@ -55,6 +54,5 @@ declare class LabelModel {
   /** Ids of the project's builds marked persistent (exempt from retention). */
   persistentBuildIds(projectId: string): Promise<Set<string>>;
 }
-//#endregion
 export { LabelModel, LabelTables };
 //# sourceMappingURL=label.d.mts.map

package/dist/models/label.mjs

@@ -5,7 +5,7 @@ import { PERSISTENT_LABEL_KEY, RESERVED_LABEL_KEYS, SEEDED_LABEL_KEYS } from "..
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, desc, eq, inArray } from "drizzle-orm";
-//#region src/models/label.ts
+// src/models/label.ts
 /** Build labels and project label types. */
 /** Data operations for label types and build labels. */
 var LabelModel = class {
@@ -134,7 +134,6 @@ const SEEDED_LINK_TEMPLATES = {
 	pr: "https://github.com/{repo}/pull/{value}",
 	mr: "https://gitlab.com/{repo}/-/merge_requests/{value}"
 };
-//#endregion
 export { LabelModel };
 
 //# sourceMappingURL=label.mjs.map

package/dist/models/member.d.mts

@@ -4,7 +4,6 @@ import { DatabaseAdapter } from "../adapter/database.mjs";
 import { ProjectRole, SiteRole } from "../types.mjs";
 import { ProjectMember } from "../schema/member.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/member.d.ts
 /** Tables required by {@link MemberModel}. */
 interface MemberTables {
   projectMembers: Table;
@@ -29,6 +28,5 @@ declare class MemberModel {
   /** Resolve a user's effective project role, honoring site-wide admins. */
   effectiveRole(siteRole: SiteRole, projectId: string, userId: string): Promise<ProjectRole | null>;
 }
-//#endregion
 export { MemberModel, MemberTables };
 //# sourceMappingURL=member.d.mts.map

package/dist/models/member.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, eq } from "drizzle-orm";
-//#region src/models/member.ts
+// src/models/member.ts
 /** Project membership and role resolution. */
 /** Data operations for project membership and roles. */
 var MemberModel = class {
@@ -59,7 +59,6 @@ var MemberModel = class {
 		return null;
 	}
 };
-//#endregion
 export { MemberModel };
 
 //# sourceMappingURL=member.mjs.map

package/dist/models/notification-channel.d.mts

@@ -6,7 +6,6 @@ import { NotifierProvider } from "../adapters/notifier/provider.mjs";
 import { SecretInput } from "../utils/encrypt.mjs";
 import { NotificationChannelRow } from "../schema/notification.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/notification-channel.d.ts
 /** Tables required by {@link NotificationChannelModel}. */
 interface NotificationChannelTables {
   notificationChannels: Table;
@@ -81,6 +80,5 @@ declare class NotificationChannelModel {
   /** Decode the JSON-serialized config of a channel. */
   static configOf(row: NotificationChannelRow): Record<string, unknown>;
 }
-//#endregion
 export { ChannelValidation, NotificationChannelCreateInput, NotificationChannelModel, NotificationChannelTables };
 //# sourceMappingURL=notification-channel.d.mts.map

package/dist/models/notification-channel.mjs

@@ -6,7 +6,7 @@ import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { isStateProvider } from "../adapters/notifier/provider.mjs";
 import { eq, isNull } from "drizzle-orm";
-//#region src/models/notification-channel.ts
+// src/models/notification-channel.ts
 /** Project and site-wide notification channel subscriptions. */
 /** Data operations for notification channels. */
 var NotificationChannelModel = class NotificationChannelModel {
@@ -166,7 +166,6 @@ function decodeEvents(raw) {
 		return [];
 	}
 }
-//#endregion
 export { NotificationChannelModel };
 
 //# sourceMappingURL=notification-channel.mjs.map

package/dist/models/notification-subscription.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { NotificationSubscriptionRow } from "../schema/notification.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/notification-subscription.d.ts
 /** Tables required by {@link NotificationSubscriptionModel}. */
 interface NotificationSubscriptionTables {
   notificationSubscriptions: Table;
@@ -38,6 +37,5 @@ declare class NotificationSubscriptionModel {
   /** Decode the JSON-serialized channel list of a subscription. */
   static viaOf(row: NotificationSubscriptionRow): string[];
 }
-//#endregion
 export { NotificationSubscriptionInput, NotificationSubscriptionModel, NotificationSubscriptionTables };
 //# sourceMappingURL=notification-subscription.d.mts.map

package/dist/models/notification-subscription.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, eq } from "drizzle-orm";
-//#region src/models/notification-subscription.ts
+// src/models/notification-subscription.ts
 /** Per-user opt-in rows for project notifications. */
 /** Data operations for per-user notification subscriptions. */
 var NotificationSubscriptionModel = class {
@@ -81,7 +81,6 @@ function decodeList(raw) {
 		return [];
 	}
 }
-//#endregion
 export { NotificationSubscriptionModel };
 
 //# sourceMappingURL=notification-subscription.mjs.map

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

@@ -4,7 +4,6 @@ import { DatabaseAdapter } from "../adapter/database.mjs";
 import { ProjectRole } from "../types.mjs";
 import { ProjectGroupMapping } from "../schema/project-group-mapping.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/project-group-mapping.d.ts
 /** Tables required by {@link ProjectGroupMappingModel}. */
 interface ProjectGroupMappingTables {
   projectGroupMappings: Table;
@@ -30,6 +29,5 @@ declare class ProjectGroupMappingModel {
   /** Remove a group mapping by id within a project. */
   remove(projectId: string, id: string): Promise<void>;
 }
-//#endregion
 export { ProjectGroupMappingModel, ProjectGroupMappingTables };
 //# sourceMappingURL=project-group-mapping.d.mts.map

package/dist/models/project-group-mapping.mjs

@@ -5,7 +5,7 @@ import { isProjectRole } from "../types.mjs";
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, eq } from "drizzle-orm";
-//#region src/models/project-group-mapping.ts
+// src/models/project-group-mapping.ts
 /** Project group-to-role mappings for OIDC team sync. */
 /** Data operations for identity-provider group mappings. */
 var ProjectGroupMappingModel = class {
@@ -50,7 +50,6 @@ var ProjectGroupMappingModel = class {
 		if (rows[0]) await this.db.remove(this.tables.projectGroupMappings, rows[0].id);
 	}
 };
-//#endregion
 export { ProjectGroupMappingModel };
 
 //# sourceMappingURL=project-group-mapping.mjs.map

package/dist/models/project.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Project } from "../schema/project.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/project.d.ts
 /** Tables required by {@link ProjectModel}. */
 interface ProjectTables {
   projects: Table;
@@ -57,6 +56,5 @@ interface ProjectCreateInput {
   /** Approvals a build needs with `testing` off (column default 1 when omitted). */
   reviewApprovals?: number;
 }
-//#endregion
 export { ProjectCreateInput, ProjectModel, ProjectTables };
 //# sourceMappingURL=project.d.mts.map

package/dist/models/project.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { slugify, ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { eq } from "drizzle-orm";
-//#region src/models/project.ts
+// src/models/project.ts
 /** Project records and slug management. */
 /** Data operations for project records. */
 var ProjectModel = class {
@@ -82,7 +82,6 @@ var ProjectModel = class {
 		return `${base}-${suffix}`;
 	}
 };
-//#endregion
 export { ProjectModel };
 
 //# sourceMappingURL=project.mjs.map

package/dist/models/public-origin.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { ShelfConfig } from "../config.mjs";
 import { Env } from "../utils/public-origin.mjs";
-//#region src/models/public-origin.d.ts
 /** Key of the stored origin in `site_settings`. */
 declare const PUBLIC_ORIGIN_KEY = "public_origin";
 /** Where the resolved origin came from. */
@@ -58,6 +57,5 @@ interface PublicOriginOptions {
 }
 /** Build the resolver for one app instance. */
 declare function createPublicOriginResolver(options: PublicOriginOptions): PublicOriginResolver;
-//#endregion
 export { PUBLIC_ORIGIN_KEY, PublicOriginOptions, PublicOriginResolver, PublicOriginSource, ResolvedPublicOrigin, StoredPublicOrigin, createPublicOriginResolver };
 //# sourceMappingURL=public-origin.d.mts.map

package/dist/models/public-origin.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { detectPublicBaseUrl, normalizeOrigin } from "../utils/public-origin.mjs";
 import { SiteSettingsModel } from "./site-settings.mjs";
-//#region src/models/public-origin.ts
+// src/models/public-origin.ts
 /** Key of the stored origin in `site_settings`. */
 const PUBLIC_ORIGIN_KEY = "public_origin";
 /** Build the resolver for one app instance. */
@@ -108,7 +108,6 @@ function parseStored(raw) {
 		return null;
 	}
 }
-//#endregion
 export { PUBLIC_ORIGIN_KEY, createPublicOriginResolver };
 
 //# sourceMappingURL=public-origin.mjs.map

package/dist/models/review-switch-off.d.mts

@@ -2,13 +2,11 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Build } from "../schema/build.mjs";
-//#region src/models/review-switch-off.d.ts
 /**
  * Accept the project's `pending` builds that have no capture attempts and no snapshots; resolves
  * to the builds it accepted. Builds a capture touched keep their status (snapshot approval decides
  * them), and a second run finds nothing left to do. No approval event is raised.
  */
 declare function acceptPendingWithoutWork(db: DatabaseAdapter, projectId: string): Promise<Build[]>;
-//#endregion
 export { acceptPendingWithoutWork };
 //# sourceMappingURL=review-switch-off.d.mts.map

package/dist/models/review-switch-off.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { CaptureAttemptModel } from "./capture-attempt.mjs";
 import { BuildModel } from "./build.mjs";
 import { SnapshotModel } from "./snapshot.mjs";
-//#region src/models/review-switch-off.ts
+// src/models/review-switch-off.ts
 /**
 * Accept the project's `pending` builds that have no capture attempts and no snapshots; resolves
 * to the builds it accepted. Builds a capture touched keep their status (snapshot approval decides
@@ -20,7 +20,6 @@ async function hasWork(db, buildId) {
 	const [attempts, snapshots] = await Promise.all([new CaptureAttemptModel(db).listByBuild(buildId), new SnapshotModel(db).listByBuild(buildId)]);
 	return attempts.length > 0 || snapshots.length > 0;
 }
-//#endregion
 export { acceptPendingWithoutWork };
 
 //# sourceMappingURL=review-switch-off.mjs.map

package/dist/models/site-settings.d.mts

@@ -2,7 +2,6 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/site-settings.d.ts
 /** Tables required by {@link SiteSettingsModel}. */
 interface SiteSettingsTables {
   siteSettings: Table;
@@ -18,6 +17,5 @@ declare class SiteSettingsModel {
   /** Delete the setting; a no-op when it is absent. */
   remove(key: string): Promise<void>;
 }
-//#endregion
 export { SiteSettingsModel, SiteSettingsTables };
 //# sourceMappingURL=site-settings.d.mts.map

package/dist/models/site-settings.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/models/site-settings.ts
+// src/models/site-settings.ts
 /** Data operations for `site_settings`, keyed by setting name. */
 var SiteSettingsModel = class {
 	#db;
@@ -42,7 +42,6 @@ var SiteSettingsModel = class {
 		await this.#db.remove(this.#table, key);
 	}
 };
-//#endregion
 export { SiteSettingsModel };
 
 //# sourceMappingURL=site-settings.mjs.map

package/dist/models/snapshot.d.mts

@@ -4,7 +4,6 @@ import { DatabaseAdapter } from "../adapter/database.mjs";
 import { SnapshotStatus } from "../types.mjs";
 import { Snapshot } from "../schema/snapshot.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/snapshot.d.ts
 /** Tables required by {@link SnapshotModel}. */
 interface SnapshotTables {
   snapshots: Table;
@@ -77,6 +76,9 @@ interface SnapshotCreateInput {
   /** JSON `EnvironmentChange` when accepted as an environment migration. */
   envChange?: string | null;
   inherited?: boolean;
+  sourceBuildId?: string | null;
+  comparisonImagePath?: string | null;
+  comparisonMetadata?: string | null;
   baselineId?: string | null;
   baselineVersion?: string | null;
   /** Resolved mode definition as JSON (display/capture only). */
@@ -88,6 +90,5 @@ interface SnapshotCreateInput {
   /** JSON array of axe violation texts found on this capture; null when none. */
   a11yViolations?: string | null;
 }
-//#endregion
 export { SnapshotCreateInput, SnapshotModel, SnapshotTables };
 //# sourceMappingURL=snapshot.d.mts.map

package/dist/models/snapshot.mjs

@@ -5,7 +5,7 @@ import "../adapters/capture-target.mjs";
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, eq, inArray } from "drizzle-orm";
-//#region src/models/snapshot.ts
+// src/models/snapshot.ts
 /** Snapshot records for captured stories within a build. */
 /** Data operations for snapshot records. */
 var SnapshotModel = class {
@@ -45,6 +45,9 @@ var SnapshotModel = class {
 			infraHash: input.infraHash ?? null,
 			envChange: input.envChange ?? null,
 			inherited: input.inherited ?? false,
+			sourceBuildId: input.inherited ? input.sourceBuildId ?? null : buildId,
+			comparisonImagePath: input.comparisonImagePath ?? null,
+			comparisonMetadata: input.comparisonMetadata ?? null,
 			baselineId: input.baselineId ?? null,
 			baselineVersion: input.baselineVersion ?? null,
 			mode: input.mode ?? null,
@@ -123,7 +126,6 @@ var SnapshotModel = class {
 		});
 	}
 };
-//#endregion
 export { SnapshotModel };
 
 //# sourceMappingURL=snapshot.mjs.map

package/dist/models/snapshot.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.mjs","names":[],"sources":["../../src/models/snapshot.ts"],"sourcesContent":["/** Snapshot records for captured stories within a build. */\nimport { and, eq, inArray } 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 { Snapshot } from \"../schema/snapshot.ts\";\nimport type { SnapshotStatus } from \"../types.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\n\n/** Tables required by {@link SnapshotModel}. */\nexport interface SnapshotTables {\n  snapshots: Table;\n}\n\n/** Data operations for snapshot records. */\nexport class SnapshotModel {\n  private readonly tables: SnapshotTables;\n  private readonly db: DatabaseAdapter;\n\n  /**\n   * @param db - Database adapter.\n   * @param tables - Table handles.\n   */\n  constructor(db: DatabaseAdapter, tables?: SnapshotTables) {\n    this.db = db;\n    this.tables = tables ?? { snapshots: db.tables.snapshots };\n  }\n\n  /**\n   * Create a snapshot for a story within a build.\n   *\n   * @param projectId - Project ID.\n   * @param buildId - Build ID.\n   * @param input - Snapshot creation input.\n   * @returns The created snapshot.\n   */\n  async create(projectId: string, buildId: string, input: SnapshotCreateInput): Promise<Snapshot> {\n    const now = new Date().toISOString();\n    return (await this.db.insert(this.tables.snapshots, {\n      id: ulid(),\n      projectId,\n      buildId,\n      storyId: input.storyId,\n      storyName: input.storyName,\n      storyTitle: input.storyTitle,\n      storyImportPath: input.storyImportPath,\n      designUrl: input.designUrl ?? null,\n      viewportName: input.viewportName,\n      viewportWidth: input.viewportWidth,\n      viewportHeight: input.viewportHeight,\n      screenshotPath: input.screenshotPath,\n      infraHash: input.infraHash ?? null,\n      envChange: input.envChange ?? null,\n      inherited: input.inherited ?? false,\n      baselineId: input.baselineId ?? null,\n      baselineVersion: input.baselineVersion ?? null,\n      mode: input.mode ?? null,\n      browser: input.browser ?? DEFAULT_BROWSER,\n      durationMs: input.durationMs ?? null,\n      a11yViolations: input.a11yViolations ?? null,\n      status: \"pending\",\n      createdAt: now,\n      updatedAt: now,\n    })) as unknown as Snapshot;\n  }\n\n  /**\n   * Delete the rendered snapshots a shard is about to write again: rows of `(story, engine)` pairs\n   * in `work`, so a rerun starts from a clean slate instead of colliding with rows an earlier,\n   * interrupted run left behind. Inherited rows are kept: the plan wrote them, for engines or\n   * viewports this shard does not render.\n   */\n  async removeRendered(\n    buildId: string,\n    work: readonly { browser: string; storyIds: ReadonlySet<string> }[],\n  ): Promise<number> {\n    const doomed = (await this.listByBuild(buildId)).filter(\n      (row) =>\n        !row.inherited &&\n        work.some(\n          (engine) =>\n            engine.browser === (row.browser ?? DEFAULT_BROWSER) && engine.storyIds.has(row.storyId),\n        ),\n    );\n    await this.#removeAll(doomed);\n    return doomed.length;\n  }\n\n  /** Delete every snapshot of a build: a new plan of it starts clean. */\n  async removeForBuild(buildId: string): Promise<number> {\n    const doomed = await this.listByBuild(buildId);\n    await this.#removeAll(doomed);\n    return doomed.length;\n  }\n\n  async #removeAll(rows: readonly Snapshot[]): Promise<void> {\n    await Promise.all(\n      rows.map(async (row) => {\n        await this.db.remove(this.tables.snapshots, row.id);\n      }),\n    );\n  }\n\n  /**\n   * Milliseconds each story cost on one build, summed over its viewports and engines. Stories the\n   * renderer did not time are left out, so an empty map means this build carries no timings.\n   */\n  async durationsByStory(buildId: string): Promise<Map<string, number>> {\n    const totals = new Map<string, number>();\n    for (const row of await this.listByBuild(buildId)) {\n      if (typeof row.durationMs === \"number\") {\n        totals.set(row.storyId, (totals.get(row.storyId) ?? 0) + row.durationMs);\n      }\n    }\n    return totals;\n  }\n\n  /** List all snapshots belonging to a build. */\n  async listByBuild(buildId: string): Promise<Snapshot[]> {\n    return (await this.db.list(this.tables.snapshots, {\n      where: eq(col(this.tables.snapshots, \"buildId\"), buildId),\n    })) as unknown as Snapshot[];\n  }\n\n  /**\n   * Every snapshot of a story file across the project's builds. Index paths are\n   * stored raw (`./src/A.stories.tsx`), so both spellings of `importPath` match.\n   */\n  async listByImportPath(projectId: string, importPath: string): Promise<Snapshot[]> {\n    const bare = importPath.replace(/^(?:\\.\\/)+/u, \"\");\n    return (await this.db.list(this.tables.snapshots, {\n      where: and(\n        eq(col(this.tables.snapshots, \"projectId\"), projectId),\n        inArray(col(this.tables.snapshots, \"storyImportPath\"), [bare, `./${bare}`]),\n      ),\n    })) as unknown as Snapshot[];\n  }\n\n  /** Fetch a snapshot by id, or null if not found. */\n  async get(id: string): Promise<Snapshot | null> {\n    return (await this.db.get(this.tables.snapshots, id)) as unknown as Snapshot | null;\n  }\n\n  /** Update mutable fields of a snapshot. */\n  async update(id: string, patch: Partial<Snapshot>): Promise<Snapshot> {\n    return (await this.db.update(this.tables.snapshots, id, {\n      ...patch,\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Snapshot;\n  }\n\n  /** Set the status of a snapshot. */\n  async setStatus(id: string, status: SnapshotStatus): Promise<Snapshot> {\n    return await this.update(id, { status });\n  }\n\n  /** Record a reviewer's decision on a snapshot. */\n  async review(id: string, status: SnapshotStatus, userId: string | null): Promise<Snapshot> {\n    return await this.update(id, {\n      status,\n      reviewedBy: userId,\n      reviewedAt: new Date().toISOString(),\n    });\n  }\n}\n\n/** Input for creating a snapshot. */\nexport interface SnapshotCreateInput {\n  storyId: string;\n  storyName: string;\n  storyTitle: string;\n  storyImportPath?: string;\n  /** Figma URL declared by the story (`parameters.design` / `storyshelf.figma`). */\n  designUrl?: string | null;\n  viewportName: string;\n  viewportWidth: number;\n  viewportHeight: number;\n  screenshotPath: string;\n  infraHash?: string | null;\n  /** JSON `EnvironmentChange` when accepted as an environment migration. */\n  envChange?: string | null;\n  inherited?: boolean;\n  baselineId?: string | null;\n  baselineVersion?: string | null;\n  /** Resolved mode definition as JSON (display/capture only). */\n  mode?: string | null;\n  /** Engine the screenshot was captured with (default chromium). */\n  browser?: string;\n  /** Milliseconds the renderer spent on this capture, when it reported any. */\n  durationMs?: number | null;\n  /** JSON array of axe violation texts found on this capture; null when none. */\n  a11yViolations?: string | null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"snapshot.mjs","names":[],"sources":["../../src/models/snapshot.ts"],"sourcesContent":["/** Snapshot records for captured stories within a build. */\nimport { and, eq, inArray } 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 { Snapshot } from \"../schema/snapshot.ts\";\nimport type { SnapshotStatus } from \"../types.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\n\n/** Tables required by {@link SnapshotModel}. */\nexport interface SnapshotTables {\n  snapshots: Table;\n}\n\n/** Data operations for snapshot records. */\nexport class SnapshotModel {\n  private readonly tables: SnapshotTables;\n  private readonly db: DatabaseAdapter;\n\n  /**\n   * @param db - Database adapter.\n   * @param tables - Table handles.\n   */\n  constructor(db: DatabaseAdapter, tables?: SnapshotTables) {\n    this.db = db;\n    this.tables = tables ?? { snapshots: db.tables.snapshots };\n  }\n\n  /**\n   * Create a snapshot for a story within a build.\n   *\n   * @param projectId - Project ID.\n   * @param buildId - Build ID.\n   * @param input - Snapshot creation input.\n   * @returns The created snapshot.\n   */\n  async create(projectId: string, buildId: string, input: SnapshotCreateInput): Promise<Snapshot> {\n    const now = new Date().toISOString();\n    return (await this.db.insert(this.tables.snapshots, {\n      id: ulid(),\n      projectId,\n      buildId,\n      storyId: input.storyId,\n      storyName: input.storyName,\n      storyTitle: input.storyTitle,\n      storyImportPath: input.storyImportPath,\n      designUrl: input.designUrl ?? null,\n      viewportName: input.viewportName,\n      viewportWidth: input.viewportWidth,\n      viewportHeight: input.viewportHeight,\n      screenshotPath: input.screenshotPath,\n      infraHash: input.infraHash ?? null,\n      envChange: input.envChange ?? null,\n      inherited: input.inherited ?? false,\n      sourceBuildId: input.inherited ? (input.sourceBuildId ?? null) : buildId,\n      comparisonImagePath: input.comparisonImagePath ?? null,\n      comparisonMetadata: input.comparisonMetadata ?? null,\n      baselineId: input.baselineId ?? null,\n      baselineVersion: input.baselineVersion ?? null,\n      mode: input.mode ?? null,\n      browser: input.browser ?? DEFAULT_BROWSER,\n      durationMs: input.durationMs ?? null,\n      a11yViolations: input.a11yViolations ?? null,\n      status: \"pending\",\n      createdAt: now,\n      updatedAt: now,\n    })) as unknown as Snapshot;\n  }\n\n  /**\n   * Delete the rendered snapshots a shard is about to write again: rows of `(story, engine)` pairs\n   * in `work`, so a rerun starts from a clean slate instead of colliding with rows an earlier,\n   * interrupted run left behind. Inherited rows are kept: the plan wrote them, for engines or\n   * viewports this shard does not render.\n   */\n  async removeRendered(\n    buildId: string,\n    work: readonly { browser: string; storyIds: ReadonlySet<string> }[],\n  ): Promise<number> {\n    const doomed = (await this.listByBuild(buildId)).filter(\n      (row) =>\n        !row.inherited &&\n        work.some(\n          (engine) =>\n            engine.browser === (row.browser ?? DEFAULT_BROWSER) && engine.storyIds.has(row.storyId),\n        ),\n    );\n    await this.#removeAll(doomed);\n    return doomed.length;\n  }\n\n  /** Delete every snapshot of a build: a new plan of it starts clean. */\n  async removeForBuild(buildId: string): Promise<number> {\n    const doomed = await this.listByBuild(buildId);\n    await this.#removeAll(doomed);\n    return doomed.length;\n  }\n\n  async #removeAll(rows: readonly Snapshot[]): Promise<void> {\n    await Promise.all(\n      rows.map(async (row) => {\n        await this.db.remove(this.tables.snapshots, row.id);\n      }),\n    );\n  }\n\n  /**\n   * Milliseconds each story cost on one build, summed over its viewports and engines. Stories the\n   * renderer did not time are left out, so an empty map means this build carries no timings.\n   */\n  async durationsByStory(buildId: string): Promise<Map<string, number>> {\n    const totals = new Map<string, number>();\n    for (const row of await this.listByBuild(buildId)) {\n      if (typeof row.durationMs === \"number\") {\n        totals.set(row.storyId, (totals.get(row.storyId) ?? 0) + row.durationMs);\n      }\n    }\n    return totals;\n  }\n\n  /** List all snapshots belonging to a build. */\n  async listByBuild(buildId: string): Promise<Snapshot[]> {\n    return (await this.db.list(this.tables.snapshots, {\n      where: eq(col(this.tables.snapshots, \"buildId\"), buildId),\n    })) as unknown as Snapshot[];\n  }\n\n  /**\n   * Every snapshot of a story file across the project's builds. Index paths are\n   * stored raw (`./src/A.stories.tsx`), so both spellings of `importPath` match.\n   */\n  async listByImportPath(projectId: string, importPath: string): Promise<Snapshot[]> {\n    const bare = importPath.replace(/^(?:\\.\\/)+/u, \"\");\n    return (await this.db.list(this.tables.snapshots, {\n      where: and(\n        eq(col(this.tables.snapshots, \"projectId\"), projectId),\n        inArray(col(this.tables.snapshots, \"storyImportPath\"), [bare, `./${bare}`]),\n      ),\n    })) as unknown as Snapshot[];\n  }\n\n  /** Fetch a snapshot by id, or null if not found. */\n  async get(id: string): Promise<Snapshot | null> {\n    return (await this.db.get(this.tables.snapshots, id)) as unknown as Snapshot | null;\n  }\n\n  /** Update mutable fields of a snapshot. */\n  async update(id: string, patch: Partial<Snapshot>): Promise<Snapshot> {\n    return (await this.db.update(this.tables.snapshots, id, {\n      ...patch,\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Snapshot;\n  }\n\n  /** Set the status of a snapshot. */\n  async setStatus(id: string, status: SnapshotStatus): Promise<Snapshot> {\n    return await this.update(id, { status });\n  }\n\n  /** Record a reviewer's decision on a snapshot. */\n  async review(id: string, status: SnapshotStatus, userId: string | null): Promise<Snapshot> {\n    return await this.update(id, {\n      status,\n      reviewedBy: userId,\n      reviewedAt: new Date().toISOString(),\n    });\n  }\n}\n\n/** Input for creating a snapshot. */\nexport interface SnapshotCreateInput {\n  storyId: string;\n  storyName: string;\n  storyTitle: string;\n  storyImportPath?: string;\n  /** Figma URL declared by the story (`parameters.design` / `storyshelf.figma`). */\n  designUrl?: string | null;\n  viewportName: string;\n  viewportWidth: number;\n  viewportHeight: number;\n  screenshotPath: string;\n  infraHash?: string | null;\n  /** JSON `EnvironmentChange` when accepted as an environment migration. */\n  envChange?: string | null;\n  inherited?: boolean;\n  sourceBuildId?: string | null;\n  comparisonImagePath?: string | null;\n  comparisonMetadata?: string | null;\n  baselineId?: string | null;\n  baselineVersion?: string | null;\n  /** Resolved mode definition as JSON (display/capture only). */\n  mode?: string | null;\n  /** Engine the screenshot was captured with (default chromium). */\n  browser?: string;\n  /** Milliseconds the renderer spent on this capture, when it reported any. */\n  durationMs?: number | null;\n  /** JSON array of axe violation texts found on this capture; null when none. */\n  a11yViolations?: string | null;\n}\n"],"mappings":"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"}

package/dist/models/token.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Token } from "../schema/token.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/token.d.ts
 /** Tables required by {@link TokenModel}. */
 interface TokenTables {
   tokens: Table;
@@ -51,6 +50,5 @@ declare class TokenModel {
   /** Delete a token by id. */
   remove(id: string): Promise<void>;
 }
-//#endregion
 export { TokenModel, TokenTables };
 //# sourceMappingURL=token.d.mts.map

package/dist/models/token.mjs

@@ -5,7 +5,7 @@ import { randomToken } from "../utils/hash.mjs";
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, eq } from "drizzle-orm";
-//#region src/models/token.ts
+// src/models/token.ts
 /** CI tokens for project-scoped API access. */
 /** Data operations for CI tokens. */
 var TokenModel = class {
@@ -76,7 +76,6 @@ var TokenModel = class {
 		await this.db.remove(this.tables.tokens, id);
 	}
 };
-//#endregion
 export { TokenModel };
 
 //# sourceMappingURL=token.mjs.map

package/dist/models/usage.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { BuildPackageUsage, ProjectLink } from "../schema/usage.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/usage.d.ts
 /** Tables required by {@link PackageUsageModel}. */
 interface PackageUsageTables {
   buildPackageUsage: Table;
@@ -71,6 +70,5 @@ declare class PackageUsageModel {
   private atomic;
   private buildWhere;
 }
-//#endregion
 export { PackageUsageInput, PackageUsageModel, PackageUsageTables, UpstreamStory, matchUpstreamStory };
 //# sourceMappingURL=usage.d.mts.map

package/dist/models/usage.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, eq } from "drizzle-orm";
-//#region src/models/usage.ts
+// src/models/usage.ts
 /** Per-build package usage and cross-project package links. */
 /** `Button.stories.tsx` / `Button.js` / `Button/index.js` → `Button`. */
 function componentStem(path) {
@@ -143,7 +143,6 @@ async function serialized(key, task) {
 		if (pending.get(key) === tail) pending.delete(key);
 	}
 }
-//#endregion
 export { PackageUsageModel, matchUpstreamStory };
 
 //# sourceMappingURL=usage.mjs.map

package/dist/models/user.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { User } from "../schema/user.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/user.d.ts
 /** Tables required by {@link UserModel}. */
 interface UserTables {
   users: Table;
@@ -37,6 +36,5 @@ declare class UserModel {
   /** Update the display name override for a user (profile edit). */
   setDisplayNameOverride(id: string, displayName: string | null): Promise<User>;
 }
-//#endregion
 export { UserModel, UserTables };
 //# sourceMappingURL=user.d.mts.map

package/dist/models/user.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { col } from "./columns.mjs";
 import { eq } from "drizzle-orm";
-//#region src/models/user.ts
+// src/models/user.ts
 /** User lookups for token and membership resolution. */
 /** Data operations for users. */
 var UserModel = class {
@@ -60,7 +60,6 @@ var UserModel = class {
 		return await this.db.update(this.tables.users, id, { displayNameOverride: displayName?.trim() ? displayName.trim() : null });
 	}
 };
-//#endregion
 export { UserModel };
 
 //# sourceMappingURL=user.mjs.map

package/dist/models/webhook.d.mts

@@ -4,7 +4,6 @@ import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Webhook } from "../schema/webhook.mjs";
 import { SecretInput } from "../utils/encrypt.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/webhook.d.ts
 /** Tables required by {@link WebhookModel}. */
 interface WebhookTables {
   webhooks: Table;
@@ -59,6 +58,5 @@ interface WebhookCreateInput {
   events?: string[];
   secret: string;
 }
-//#endregion
 export { WebhookCreateInput, WebhookModel, WebhookTables };
 //# sourceMappingURL=webhook.d.mts.map

package/dist/models/webhook.mjs

@@ -6,7 +6,7 @@ import { decryptCredential, encrypt } from "../utils/encrypt.mjs";
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { eq } from "drizzle-orm";
-//#region src/models/webhook.ts
+// src/models/webhook.ts
 /** Webhook subscriptions for project events. */
 /** Data operations for webhook subscriptions. */
 var WebhookModel = class {
@@ -101,7 +101,6 @@ var WebhookModel = class {
 		}
 	}
 };
-//#endregion
 export { WebhookModel };
 
 //# sourceMappingURL=webhook.mjs.map

package/dist/models.d.mts

@@ -5,15 +5,18 @@ import { BuildCreateInput, BuildListFilter, BuildModel, isPublicBuild } from "./
 import { AttemptLogRecorder, CaptureAttemptModel, CaptureAttemptTables, emitAttemptLog } from "./models/capture-attempt.mjs";
 import { CaptureLogModel, CaptureLogTables } from "./models/capture-log.mjs";
 import { ProjectCreateInput, ProjectModel } from "./models/project.mjs";
+import { BaselineWriteConflict } from "./models/baseline-conflict.mjs";
+import { BaselineStatus, NO_BASELINE, baselineStatus, isBaselineDrifted } from "./models/baseline-status.mjs";
+import { BaselineApprovalConflict } from "./models/baseline-approval.mjs";
 import { BaselineModel } from "./models/baseline.mjs";
 import { SnapshotCreateInput, SnapshotModel } from "./models/snapshot.mjs";
 import { AttemptClaim, CaptureJobModel, CaptureJobTables, NewCaptureJob, TERMINAL_JOB_STATUSES, attemptRowId, isTerminalJob, parseAttemptRowId } from "./models/capture-job.mjs";
 import { BuildComponentInput, BuildComponentModel, BuildComponentTables } from "./models/build-component.mjs";
 import { ComponentHistoryRow, ComponentPresence, componentHistory, componentPresence, worstStatus } from "./models/component.mjs";
+import { BaselineOriginReader, resolveBaselineOrigin } from "./models/baseline-origin.mjs";
 import { BASELINE_ARCHIVE_FORMAT, BASELINE_ARCHIVE_LIMITS, BASELINE_ARCHIVE_VERSION, BaselineArchiveError, BaselineManifest, BaselineManifestEntry } from "./models/baseline-archive.mjs";
 import { BaselineExportOptions } from "./models/baseline-export.mjs";
 import { BaselineImportResult, BaselineTransferModel } from "./models/baseline-transfer.mjs";
-import { BaselineStatus, NO_BASELINE, baselineStatus, isBaselineDrifted } from "./models/baseline-status.mjs";
 import { CaptureShardModel, CaptureShardTables } from "./models/capture-shard.mjs";
 import { AiBudgetAlertModel, AiBudgetAlertTables } from "./models/ai-budget-alert.mjs";
 import { AiUsageInput, AiUsageModel, AiUsageTables } from "./models/ai-usage.mjs";
@@ -28,8 +31,8 @@ import { ConnectionModel, ConnectionTables } from "./models/connections.mjs";
 import { DesignModel, DesignTables } from "./models/design.mjs";
 import { DesignCredentialStatus, DesignResolution, DesignSource, normalizeImportPath, resolveDesigns } from "./models/design-resolve.mjs";
 import { DesignCredentialModel, DesignCredentialTables, PROJECT_SCOPE } from "./models/design-credentials.mjs";
+import { DESIGN_TTL_MS, DesignChange, DesignChangeKind, credentialDaysLeft, designChange, isDesignStale } from "./models/design-health.mjs";
 import { DesignNodeModel, DesignNodeTables, RefreshOptions } from "./models/design-nodes.mjs";
-import { DESIGN_TTL_MS, credentialDaysLeft, isDesignStale } from "./models/design-health.mjs";
 import { LabelModel } from "./models/label.mjs";
 import { PackageUsageInput, PackageUsageModel, PackageUsageTables, UpstreamStory, matchUpstreamStory } from "./models/usage.mjs";
 import { MemberModel } from "./models/member.mjs";
@@ -42,4 +45,4 @@ import { ContentRefModel } from "./models/content-ref.mjs";
 import { CredentialProbe, ReencryptResult, UnreadableCredential, probeCredentials, reencryptCredentials } from "./models/credentials.mjs";
 import { SiteSettingsModel, SiteSettingsTables } from "./models/site-settings.mjs";
 import { PUBLIC_ORIGIN_KEY, PublicOriginOptions, PublicOriginResolver, PublicOriginSource, ResolvedPublicOrigin, StoredPublicOrigin, createPublicOriginResolver } from "./models/public-origin.mjs";
-export { AiBudgetAlertModel, type AiBudgetAlertTables, type AiUsageInput, AiUsageModel, type AiUsageTables, type AttemptClaim, type AttemptLogRecorder, BASELINE_ARCHIVE_FORMAT, BASELINE_ARCHIVE_LIMITS, BASELINE_ARCHIVE_VERSION, BaselineArchiveError, type BaselineExportOptions, type BaselineImportResult, type BaselineManifest, type BaselineManifestEntry, BaselineModel, type BaselineStatus, BaselineTransferModel, type BuildChangeset, type BuildComponentInput, BuildComponentModel, type BuildComponentTables, type BuildCreateInput, type BuildListFilter, BuildModel, BuildReviewModel, type BuildReviewTables, CaptureAttemptModel, type CaptureAttemptTables, CaptureJobModel, type CaptureJobTables, CaptureLogModel, type CaptureLogTables, CaptureShardModel, type CaptureShardTables, type ChangedComponent, type Changeset, type ChangesetComponent, type ChannelValidation, type CommentCreateInput, CommentModel, type ComponentHistoryRow, type ComponentPresence, ConnectionModel, type ConnectionTables, ContentRefModel, type CredentialProbe, DESIGN_TTL_MS, DesignCredentialModel, type DesignCredentialStatus, type DesignCredentialTables, DesignModel, DesignNodeModel, type DesignNodeTables, type DesignResolution, type DesignSource, type DesignTables, type InheritedRatio, InsightModel, type InsightResultInput, type InsightStartInput, type InsightStartResult, type InsightTables, LabelModel, MemberModel, NO_BASELINE, type NewCaptureJob, type NotificationChannelCreateInput, NotificationChannelModel, type NotificationChannelTables, type NotificationSubscriptionInput, NotificationSubscriptionModel, type NotificationSubscriptionTables, PROJECT_SCOPE, PUBLIC_ORIGIN_KEY, type PackageUsageInput, PackageUsageModel, type PackageUsageTables, type ProjectCreateInput, ProjectGroupMappingModel, ProjectModel, type PublicOriginOptions, type PublicOriginResolver, type PublicOriginSource, RECENT_BUILDS_FOR_INHERITED_RATIO, type ReencryptResult, type RefreshOptions, type ResolvedPublicOrigin, type ReviewStatusInput, SiteSettingsModel, type SiteSettingsTables, type SnapshotCreateInput, SnapshotModel, type StoredPublicOrigin, TERMINAL_JOB_STATUSES, TokenModel, type UnreadableCredential, type UpstreamStory, UserModel, type WebhookCreateInput, WebhookModel, acceptPendingWithoutWork, attemptRowId, averageInheritedRatio, baselineStatus, changesetOf, componentHistory, componentPresence, computeChangeset, createPublicOriginResolver, credentialDaysLeft, deriveReviewStatus, emitAttemptLog, findChangesetBaseline, isBaselineDrifted, isDesignStale, isPublicBuild, isTerminalJob, latestVerdicts, matchUpstreamStory, normalizeImportPath, parseAttemptRowId, probeCredentials, reencryptCredentials, resolveDesigns, worstStatus };
+export { AiBudgetAlertModel, type AiBudgetAlertTables, type AiUsageInput, AiUsageModel, type AiUsageTables, type AttemptClaim, type AttemptLogRecorder, BASELINE_ARCHIVE_FORMAT, BASELINE_ARCHIVE_LIMITS, BASELINE_ARCHIVE_VERSION, BaselineApprovalConflict, BaselineArchiveError, type BaselineExportOptions, type BaselineImportResult, type BaselineManifest, type BaselineManifestEntry, BaselineModel, type BaselineOriginReader, type BaselineStatus, BaselineTransferModel, BaselineWriteConflict, type BuildChangeset, type BuildComponentInput, BuildComponentModel, type BuildComponentTables, type BuildCreateInput, type BuildListFilter, BuildModel, BuildReviewModel, type BuildReviewTables, CaptureAttemptModel, type CaptureAttemptTables, CaptureJobModel, type CaptureJobTables, CaptureLogModel, type CaptureLogTables, CaptureShardModel, type CaptureShardTables, type ChangedComponent, type Changeset, type ChangesetComponent, type ChannelValidation, type CommentCreateInput, CommentModel, type ComponentHistoryRow, type ComponentPresence, ConnectionModel, type ConnectionTables, ContentRefModel, type CredentialProbe, DESIGN_TTL_MS, type DesignChange, type DesignChangeKind, DesignCredentialModel, type DesignCredentialStatus, type DesignCredentialTables, DesignModel, DesignNodeModel, type DesignNodeTables, type DesignResolution, type DesignSource, type DesignTables, type InheritedRatio, InsightModel, type InsightResultInput, type InsightStartInput, type InsightStartResult, type InsightTables, LabelModel, MemberModel, NO_BASELINE, type NewCaptureJob, type NotificationChannelCreateInput, NotificationChannelModel, type NotificationChannelTables, type NotificationSubscriptionInput, NotificationSubscriptionModel, type NotificationSubscriptionTables, PROJECT_SCOPE, PUBLIC_ORIGIN_KEY, type PackageUsageInput, PackageUsageModel, type PackageUsageTables, type ProjectCreateInput, ProjectGroupMappingModel, ProjectModel, type PublicOriginOptions, type PublicOriginResolver, type PublicOriginSource, RECENT_BUILDS_FOR_INHERITED_RATIO, type ReencryptResult, type RefreshOptions, type ResolvedPublicOrigin, type ReviewStatusInput, SiteSettingsModel, type SiteSettingsTables, type SnapshotCreateInput, SnapshotModel, type StoredPublicOrigin, TERMINAL_JOB_STATUSES, TokenModel, type UnreadableCredential, type UpstreamStory, UserModel, type WebhookCreateInput, WebhookModel, acceptPendingWithoutWork, attemptRowId, averageInheritedRatio, baselineStatus, changesetOf, componentHistory, componentPresence, computeChangeset, createPublicOriginResolver, credentialDaysLeft, deriveReviewStatus, designChange, emitAttemptLog, findChangesetBaseline, isBaselineDrifted, isDesignStale, isPublicBuild, isTerminalJob, latestVerdicts, matchUpstreamStory, normalizeImportPath, parseAttemptRowId, probeCredentials, reencryptCredentials, resolveBaselineOrigin, resolveDesigns, worstStatus };