@storyshelf/core 0.7.0 → 0.9.0-next-d2cc082

package/dist/schema/design.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/design.d.ts
 /** A design link: a project-level file link (`importPath` null) or a component mapping override. */
 interface DesignLink {
   id: string;
@@ -49,10 +48,11 @@ interface DesignNode {
   renderPath: string | null;
   /** File `version` the cached render was taken at; a newer file version refetches. */
   renderVersion: string | null;
+  /** Claim of the last `design:changed` event sent for this node (see `designChange`); null when none. */
+  notifiedVersion: string | null;
   fetchedAt: string;
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { DesignCredential, DesignLink, DesignNode };
 //# sourceMappingURL=design.d.mts.map

package/dist/schema/insight.d.mts

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

package/dist/schema/label.d.mts

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

package/dist/schema/member.d.mts

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

package/dist/schema/notification.d.mts

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

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

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

package/dist/schema/project.d.mts

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

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

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

package/dist/schema/snapshot.d.mts

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

package/dist/schema/token.d.mts

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

package/dist/schema/usage.d.mts

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

package/dist/schema/user.d.mts

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

package/dist/schema/webhook.d.mts

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

package/dist/schema.d.mts

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

package/dist/serverless.d.mts

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

package/dist/serverless.mjs

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

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

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

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

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

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

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

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

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

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

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

package/dist/test-helpers/database-contract.d.mts

@@ -1,13 +1,11 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
-//#region src/test-helpers/database-contract.d.ts
 /** Tables every adapter must expose (single-sourced from the contract). */
 declare const REQUIRED_TABLES: string[];
 /** Build the adapter under test (sync or async factories both work). */
 type DatabaseFactory = () => DatabaseAdapter | Promise<DatabaseAdapter>;
 /** Run the database contract against a factory. */
 declare function databaseContractSuite(label: string, make: DatabaseFactory): void;
-//#endregion
 export { DatabaseFactory, REQUIRED_TABLES, databaseContractSuite };
 //# sourceMappingURL=database-contract.d.mts.map

package/dist/test-helpers/database-contract.mjs

@@ -1,9 +1,12 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { createShelfLogger } from "../logger.mjs";
 import { REQUIRED_TABLE_KEYS } from "../adapter/database.mjs";
+import { randomUUID } from "node:crypto";
+import { getTableColumns, ne } from "drizzle-orm";
 import { describe, expect, it } from "vitest";
-//#region src/test-helpers/database-contract.ts
+// src/test-helpers/database-contract.ts
 /**
 * Published database contract suite for first- and third-party adapters.
 *
@@ -21,6 +24,7 @@ const REQUIRED_TABLES = REQUIRED_TABLE_KEYS;
 const REQUIRED_METHODS = [
 	"insert",
 	"update",
+	"updateWhere",
 	"get",
 	"remove",
 	"list",
@@ -43,6 +47,38 @@ function databaseContractSuite(label, make) {
 			const adapter = await make();
 			for (const method of REQUIRED_METHODS) expect(typeof adapter[method]).toBe("function");
 		});
+		it("conditionally updates and returns the current row when refused", async () => {
+			const adapter = await make();
+			await adapter.lifecycle?.setup({
+				config: {},
+				logger: createShelfLogger({ level: "silent" })
+			});
+			const table = adapter.tables.projects;
+			const id = `conditional-contract-${randomUUID()}`;
+			try {
+				const now = (/* @__PURE__ */ new Date()).toISOString();
+				await adapter.insert(table, {
+					id,
+					name: "before",
+					slug: id,
+					createdAt: now,
+					updatedAt: now
+				});
+				const condition = ne(getTableColumns(table)["name"], "locked");
+				const first = await adapter.updateWhere(table, id, { name: "locked" }, condition);
+				expect(first?.["name"]).toBe("locked");
+				const refused = await adapter.updateWhere(table, id, { name: "after" }, condition);
+				expect(refused?.["name"]).toBe("locked");
+				expect((await adapter.get(table, id))?.["name"]).toBe("locked");
+				expect(await adapter.updateWhere(table, "missing", { name: "x" }, condition)).toBeNull();
+			} finally {
+				try {
+					await adapter.remove(table, id);
+				} finally {
+					await adapter.lifecycle?.teardown();
+				}
+			}
+		}, 3e4);
 		it("keeps the lifecycle rule (absent or all three hooks)", async () => {
 			const lifecycle = (await make()).lifecycle;
 			if (lifecycle === void 0) return;
@@ -52,7 +88,6 @@ function databaseContractSuite(label, make) {
 		});
 	});
 }
-//#endregion
 export { REQUIRED_TABLES, databaseContractSuite };
 
 //# sourceMappingURL=database-contract.mjs.map

package/dist/test-helpers/database-contract.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-contract.mjs","names":[],"sources":["../../src/test-helpers/database-contract.ts"],"sourcesContent":["/**\n * Published database contract suite for first- and third-party adapters.\n *\n * Structural conformance only (identity, table map, methods, lifecycle\n * rule) — row-level CRUD stays per-package because insert shapes differ per\n * dialect schema. A package proves conformance in one line:\n *\n * ```ts\n * import { databaseContractSuite } from \"@storyshelf/core/test-helpers\";\n * databaseContractSuite(\"sqlite\", () => createSqliteDatabase(\":memory:\"));\n * ```\n */\nimport { describe, expect, it } from \"vitest\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport { REQUIRED_TABLE_KEYS } from \"../adapters/database.ts\";\n\n/** Tables every adapter must expose (single-sourced from the contract). */\nexport const REQUIRED_TABLES = REQUIRED_TABLE_KEYS;\n\nconst REQUIRED_METHODS = [\"insert\", \"update\", \"get\", \"remove\", \"list\", \"count\", \"all\"];\n\n/** Build the adapter under test (sync or async factories both work). */\nexport type DatabaseFactory = () => DatabaseAdapter | Promise<DatabaseAdapter>;\n\n/** Run the database contract against a factory. */\nexport function databaseContractSuite(label: string, make: DatabaseFactory): void {\n  describe(`database contract: ${label}`, () => {\n    it(\"exposes database metadata\", async () => {\n      const adapter = await make();\n      expect(adapter.metadata.category).toBe(\"database\");\n      expect(adapter.metadata.kind.length).toBeGreaterThan(0);\n    });\n\n    it(\"exposes the full table map\", async () => {\n      const adapter = await make();\n      const tables = adapter.tables as unknown as Record<string, unknown>;\n      for (const table of REQUIRED_TABLES) {\n        expect(tables[table], `missing table: ${table}`).toBeDefined();\n      }\n    });\n\n    it(\"exposes every CRUD method\", async () => {\n      const adapter = await make();\n      for (const method of REQUIRED_METHODS) {\n        expect(typeof (adapter as unknown as Record<string, unknown>)[method]).toBe(\"function\");\n      }\n    });\n\n    it(\"keeps the lifecycle rule (absent or all three hooks)\", async () => {\n      const adapter = await make();\n      const lifecycle = adapter.lifecycle as\n        | { setup?: unknown; teardown?: unknown; health?: unknown }\n        | undefined;\n      if (lifecycle === undefined) {\n        return;\n      }\n      expect(typeof lifecycle.setup).toBe(\"function\");\n      expect(typeof lifecycle.teardown).toBe(\"function\");\n      expect(typeof lifecycle.health).toBe(\"function\");\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,MAAa,kBAAkB;AAE/B,MAAM,mBAAmB;CAAC;CAAU;CAAU;CAAO;CAAU;CAAQ;CAAS;AAAK;;AAMrF,SAAgB,sBAAsB,OAAe,MAA6B;CAChF,SAAS,sBAAsB,eAAe;EAC5C,GAAG,6BAA6B,YAAY;GAC1C,MAAM,UAAU,MAAM,KAAK;GAC3B,OAAO,QAAQ,SAAS,QAAQ,CAAC,CAAC,KAAK,UAAU;GACjD,OAAO,QAAQ,SAAS,KAAK,MAAM,CAAC,CAAC,gBAAgB,CAAC;EACxD,CAAC;EAED,GAAG,8BAA8B,YAAY;GAE3C,MAAM,UAAS,MADO,KAAK,EAAA,CACJ;GACvB,KAAK,MAAM,SAAS,iBAClB,OAAO,OAAO,QAAQ,kBAAkB,OAAO,CAAC,CAAC,YAAY;EAEjE,CAAC;EAED,GAAG,6BAA6B,YAAY;GAC1C,MAAM,UAAU,MAAM,KAAK;GAC3B,KAAK,MAAM,UAAU,kBACnB,OAAO,OAAQ,QAA+C,OAAO,CAAC,CAAC,KAAK,UAAU;EAE1F,CAAC;EAED,GAAG,wDAAwD,YAAY;GAErE,MAAM,aAAY,MADI,KAAK,EAAA,CACD;GAG1B,IAAI,cAAc,KAAA,GAChB;GAEF,OAAO,OAAO,UAAU,KAAK,CAAC,CAAC,KAAK,UAAU;GAC9C,OAAO,OAAO,UAAU,QAAQ,CAAC,CAAC,KAAK,UAAU;GACjD,OAAO,OAAO,UAAU,MAAM,CAAC,CAAC,KAAK,UAAU;EACjD,CAAC;CACH,CAAC;AACH"}
+{"version":3,"file":"database-contract.mjs","names":[],"sources":["../../src/test-helpers/database-contract.ts"],"sourcesContent":["/**\n * Published database contract suite for first- and third-party adapters.\n *\n * Structural conformance only (identity, table map, methods, lifecycle\n * rule) — row-level CRUD stays per-package because insert shapes differ per\n * dialect schema. A package proves conformance in one line:\n *\n * ```ts\n * import { databaseContractSuite } from \"@storyshelf/core/test-helpers\";\n * databaseContractSuite(\"sqlite\", () => createSqliteDatabase(\":memory:\"));\n * ```\n */\nimport { getTableColumns, ne } from \"drizzle-orm\";\nimport { randomUUID } from \"node:crypto\";\nimport { describe, expect, it } from \"vitest\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport { REQUIRED_TABLE_KEYS } from \"../adapters/database.ts\";\nimport { createShelfLogger } from \"../logger.ts\";\n\n/** Tables every adapter must expose (single-sourced from the contract). */\nexport const REQUIRED_TABLES = REQUIRED_TABLE_KEYS;\n\nconst REQUIRED_METHODS = [\n  \"insert\",\n  \"update\",\n  \"updateWhere\",\n  \"get\",\n  \"remove\",\n  \"list\",\n  \"count\",\n  \"all\",\n];\n\n/** Build the adapter under test (sync or async factories both work). */\nexport type DatabaseFactory = () => DatabaseAdapter | Promise<DatabaseAdapter>;\n\n/** Run the database contract against a factory. */\nexport function databaseContractSuite(label: string, make: DatabaseFactory): void {\n  describe(`database contract: ${label}`, () => {\n    it(\"exposes database metadata\", async () => {\n      const adapter = await make();\n      expect(adapter.metadata.category).toBe(\"database\");\n      expect(adapter.metadata.kind.length).toBeGreaterThan(0);\n    });\n\n    it(\"exposes the full table map\", async () => {\n      const adapter = await make();\n      const tables = adapter.tables as unknown as Record<string, unknown>;\n      for (const table of REQUIRED_TABLES) {\n        expect(tables[table], `missing table: ${table}`).toBeDefined();\n      }\n    });\n\n    it(\"exposes every CRUD method\", async () => {\n      const adapter = await make();\n      for (const method of REQUIRED_METHODS) {\n        expect(typeof (adapter as unknown as Record<string, unknown>)[method]).toBe(\"function\");\n      }\n    });\n\n    it(\"conditionally updates and returns the current row when refused\", async () => {\n      const adapter = await make();\n      await adapter.lifecycle?.setup({\n        config: {},\n        logger: createShelfLogger({ level: \"silent\" }),\n      });\n      const table = adapter.tables.projects;\n      const id = `conditional-contract-${randomUUID()}`;\n      try {\n        const now = new Date().toISOString();\n        await adapter.insert(table, {\n          id,\n          name: \"before\",\n          slug: id,\n          createdAt: now,\n          updatedAt: now,\n        });\n        const condition = ne(getTableColumns(table)[\"name\"]!, \"locked\");\n        const first = await adapter.updateWhere(table, id, { name: \"locked\" }, condition);\n        expect(first?.[\"name\"]).toBe(\"locked\");\n        const refused = await adapter.updateWhere(table, id, { name: \"after\" }, condition);\n        expect(refused?.[\"name\"]).toBe(\"locked\");\n        expect((await adapter.get(table, id))?.[\"name\"]).toBe(\"locked\");\n        expect(await adapter.updateWhere(table, \"missing\", { name: \"x\" }, condition)).toBeNull();\n      } finally {\n        try {\n          await adapter.remove(table, id);\n        } finally {\n          await adapter.lifecycle?.teardown();\n        }\n      }\n    }, 30_000);\n\n    it(\"keeps the lifecycle rule (absent or all three hooks)\", async () => {\n      const adapter = await make();\n      const lifecycle = adapter.lifecycle as\n        | { setup?: unknown; teardown?: unknown; health?: unknown }\n        | undefined;\n      if (lifecycle === undefined) {\n        return;\n      }\n      expect(typeof lifecycle.setup).toBe(\"function\");\n      expect(typeof lifecycle.teardown).toBe(\"function\");\n      expect(typeof lifecycle.health).toBe(\"function\");\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,kBAAkB;AAE/B,MAAM,mBAAmB;CACvB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;AAMA,SAAgB,sBAAsB,OAAe,MAA6B;CAChF,SAAS,sBAAsB,eAAe;EAC5C,GAAG,6BAA6B,YAAY;GAC1C,MAAM,UAAU,MAAM,KAAK;GAC3B,OAAO,QAAQ,SAAS,QAAQ,CAAC,CAAC,KAAK,UAAU;GACjD,OAAO,QAAQ,SAAS,KAAK,MAAM,CAAC,CAAC,gBAAgB,CAAC;EACxD,CAAC;EAED,GAAG,8BAA8B,YAAY;GAE3C,MAAM,UAAS,MADO,KAAK,EAAA,CACJ;GACvB,KAAK,MAAM,SAAS,iBAClB,OAAO,OAAO,QAAQ,kBAAkB,OAAO,CAAC,CAAC,YAAY;EAEjE,CAAC;EAED,GAAG,6BAA6B,YAAY;GAC1C,MAAM,UAAU,MAAM,KAAK;GAC3B,KAAK,MAAM,UAAU,kBACnB,OAAO,OAAQ,QAA+C,OAAO,CAAC,CAAC,KAAK,UAAU;EAE1F,CAAC;EAED,GAAG,kEAAkE,YAAY;GAC/E,MAAM,UAAU,MAAM,KAAK;GAC3B,MAAM,QAAQ,WAAW,MAAM;IAC7B,QAAQ,CAAC;IACT,QAAQ,kBAAkB,EAAE,OAAO,SAAS,CAAC;GAC/C,CAAC;GACD,MAAM,QAAQ,QAAQ,OAAO;GAC7B,MAAM,KAAK,wBAAwB,WAAW;GAC9C,IAAI;IACF,MAAM,uBAAM,IAAI,KAAK,EAAA,CAAE,YAAY;IACnC,MAAM,QAAQ,OAAO,OAAO;KAC1B;KACA,MAAM;KACN,MAAM;KACN,WAAW;KACX,WAAW;IACb,CAAC;IACD,MAAM,YAAY,GAAG,gBAAgB,KAAK,CAAC,CAAC,SAAU,QAAQ;IAC9D,MAAM,QAAQ,MAAM,QAAQ,YAAY,OAAO,IAAI,EAAE,MAAM,SAAS,GAAG,SAAS;IAChF,OAAO,QAAQ,OAAO,CAAC,CAAC,KAAK,QAAQ;IACrC,MAAM,UAAU,MAAM,QAAQ,YAAY,OAAO,IAAI,EAAE,MAAM,QAAQ,GAAG,SAAS;IACjF,OAAO,UAAU,OAAO,CAAC,CAAC,KAAK,QAAQ;IACvC,QAAQ,MAAM,QAAQ,IAAI,OAAO,EAAE,EAAA,GAAK,OAAO,CAAC,CAAC,KAAK,QAAQ;IAC9D,OAAO,MAAM,QAAQ,YAAY,OAAO,WAAW,EAAE,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS;GACzF,UAAU;IACR,IAAI;KACF,MAAM,QAAQ,OAAO,OAAO,EAAE;IAChC,UAAU;KACR,MAAM,QAAQ,WAAW,SAAS;IACpC;GACF;EACF,GAAG,GAAM;EAET,GAAG,wDAAwD,YAAY;GAErE,MAAM,aAAY,MADI,KAAK,EAAA,CACD;GAG1B,IAAI,cAAc,KAAA,GAChB;GAEF,OAAO,OAAO,UAAU,KAAK,CAAC,CAAC,KAAK,UAAU;GAC9C,OAAO,OAAO,UAAU,QAAQ,CAAC,CAAC,KAAK,UAAU;GACjD,OAAO,OAAO,UAAU,MAAM,CAAC,CAAC,KAAK,UAAU;EACjD,CAAC;CACH,CAAC;AACH"}

package/dist/test-helpers/deferred.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/test-helpers/deferred.d.ts
 /**
  * A promise a test resolves by hand, for asserting concurrency and ordering without sleeping.
  * Tests wait on `promise` to observe an in-flight state, then call `resolve()` to let it finish.
@@ -34,6 +33,5 @@ interface ReleaseQueue {
 }
 /** Create a FIFO release queue. */
 declare function createReleaseQueue(): ReleaseQueue;
-//#endregion
 export { Deferred, Latch, ReleaseQueue, createLatch, createReleaseQueue, deferred };
 //# sourceMappingURL=deferred.d.mts.map

package/dist/test-helpers/deferred.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/test-helpers/deferred.ts
+// src/test-helpers/deferred.ts
 /** Create a promise the test settles explicitly. */
 function deferred() {
 	let resolve;
@@ -55,7 +55,6 @@ function createReleaseQueue() {
 		}
 	};
 }
-//#endregion
 export { createLatch, createReleaseQueue, deferred };
 
 //# sourceMappingURL=deferred.mjs.map

package/dist/test-helpers/design-contract.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DesignProvider } from "../adapter/design.mjs";
-//#region src/test-helpers/design-contract.d.ts
 /** Build the provider under test (sync or async factories both work). */
 type DesignFactory = () => DesignProvider | Promise<DesignProvider>;
 /** Links the suite uses to probe `parseUrl`. */
@@ -16,6 +15,5 @@ interface DesignContractSamples {
 }
 /** Run the design-provider contract against a factory. */
 declare function designContractSuite(label: string, make: DesignFactory, samples: DesignContractSamples): void;
-//#endregion
 export { DesignContractSamples, DesignFactory, designContractSuite };
 //# sourceMappingURL=design-contract.d.mts.map

package/dist/test-helpers/design-contract.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { describe, expect, it } from "vitest";
-//#region src/test-helpers/design-contract.ts
+// src/test-helpers/design-contract.ts
 /**
 * Published design-provider contract suite for first- and third-party providers.
 *
@@ -34,7 +34,6 @@ function designContractSuite(label, make, samples) {
 		});
 	});
 }
-//#endregion
 export { designContractSuite };
 
 //# sourceMappingURL=design-contract.mjs.map

package/dist/test-helpers/fake-adapters.d.mts

@@ -3,12 +3,10 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { makeDatabase } from "./fake-database.mjs";
 import { FakeStorage, makeStorage } from "./fake-storage.mjs";
-//#region src/test-helpers/fake-adapters.d.ts
 /**
  * Empty table map for spec/test doubles whose methods never run (OpenAPI
  * generation, asset serving). Satisfies boot validation without a driver.
  */
 declare function stubTables(): DatabaseAdapter["tables"];
-//#endregion
 export { type FakeStorage, makeDatabase, makeStorage, stubTables };
 //# sourceMappingURL=fake-adapters.d.mts.map

package/dist/test-helpers/fake-adapters.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { REQUIRED_TABLE_KEYS } from "../adapter/database.mjs";
 import { makeDatabase } from "./fake-database.mjs";
 import { makeStorage } from "./fake-storage.mjs";
-//#region src/test-helpers/fake-adapters.ts
+// src/test-helpers/fake-adapters.ts
 /**
 * Empty table map for spec/test doubles whose methods never run (OpenAPI
 * generation, asset serving). Satisfies boot validation without a driver.
@@ -14,7 +14,6 @@ function stubTables() {
 	for (const key of REQUIRED_TABLE_KEYS) tables[key] = {};
 	return tables;
 }
-//#endregion
 export { makeDatabase, makeStorage, stubTables };
 
 //# sourceMappingURL=fake-adapters.mjs.map

package/dist/test-helpers/fake-database.d.mts

@@ -1,11 +1,9 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
-//#region src/test-helpers/fake-database.d.ts
 /** Create an in-memory database adapter for capture pipeline tests. */
 declare function makeDatabase(): {
   db: DatabaseAdapter;
 };
-//#endregion
 export { makeDatabase };
 //# sourceMappingURL=fake-database.d.mts.map