@storyshelf/core 0.6.2 → 0.8.0

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

@@ -2,14 +2,12 @@ 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";
-import { BuildTables } from "../models/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

@@ -0,0 +1,37 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/**
+ * 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.
+ */
+/** A manually settled promise. */
+interface Deferred<T = void> {
+  readonly promise: Promise<T>;
+  resolve(value: T): void;
+  reject(reason?: unknown): void;
+}
+/** Create a promise the test settles explicitly. */
+declare function deferred<T = void>(): Deferred<T>;
+/** A gate that holds every waiter until opened, then lets all future calls through. */
+interface Latch {
+  wait(): Promise<void>;
+  open(): void;
+  readonly opened: boolean;
+}
+/** Create a latch that stays open once opened. */
+declare function createLatch(): Latch;
+/** A set of deferreds a test can release one at a time, in order. */
+interface ReleaseQueue {
+  /** The next deferred to hand to a task. */
+  next(): Promise<void>;
+  /** Release the oldest waiter. */
+  release(): void;
+  /** Release every waiter created so far. */
+  releaseAll(): void;
+  /** Waiters created but not released yet. */
+  readonly pending: number;
+}
+/** Create a FIFO release queue. */
+declare function createReleaseQueue(): ReleaseQueue;
+export { Deferred, Latch, ReleaseQueue, createLatch, createReleaseQueue, deferred };
+//# sourceMappingURL=deferred.d.mts.map

package/dist/test-helpers/deferred.mjs

@@ -0,0 +1,60 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/test-helpers/deferred.ts
+/** Create a promise the test settles explicitly. */
+function deferred() {
+	let resolve;
+	let reject;
+	return {
+		promise: new Promise((promiseResolve, promiseReject) => {
+			resolve = promiseResolve;
+			reject = promiseReject;
+		}),
+		resolve,
+		reject
+	};
+}
+/** Create a latch that stays open once opened. */
+function createLatch() {
+	let opened = false;
+	const waiters = [];
+	return {
+		wait: () => {
+			if (opened) return Promise.resolve();
+			const waiter = deferred();
+			waiters.push(waiter);
+			return waiter.promise;
+		},
+		open: () => {
+			opened = true;
+			for (const waiter of waiters.splice(0)) waiter.resolve();
+		},
+		get opened() {
+			return opened;
+		}
+	};
+}
+/** Create a FIFO release queue. */
+function createReleaseQueue() {
+	const waiters = [];
+	return {
+		next: () => {
+			const waiter = deferred();
+			waiters.push(waiter);
+			return waiter.promise;
+		},
+		release: () => {
+			waiters.shift()?.resolve();
+		},
+		releaseAll: () => {
+			for (const waiter of waiters.splice(0)) waiter.resolve();
+		},
+		get pending() {
+			return waiters.length;
+		}
+	};
+}
+export { createLatch, createReleaseQueue, deferred };
+
+//# sourceMappingURL=deferred.mjs.map

package/dist/test-helpers/deferred.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred.mjs","names":[],"sources":["../../src/test-helpers/deferred.ts"],"sourcesContent":["/**\n * A promise a test resolves by hand, for asserting concurrency and ordering without sleeping.\n * Tests wait on `promise` to observe an in-flight state, then call `resolve()` to let it finish.\n */\n\n/** A manually settled promise. */\nexport interface Deferred<T = void> {\n  readonly promise: Promise<T>;\n  resolve(value: T): void;\n  reject(reason?: unknown): void;\n}\n\n/** Create a promise the test settles explicitly. */\nexport function deferred<T = void>(): Deferred<T> {\n  let resolve!: (value: T) => void;\n  let reject!: (reason?: unknown) => void;\n  const promise = new Promise<T>((promiseResolve, promiseReject) => {\n    resolve = promiseResolve;\n    reject = promiseReject;\n  });\n  return { promise, resolve, reject };\n}\n\n/** A gate that holds every waiter until opened, then lets all future calls through. */\nexport interface Latch {\n  wait(): Promise<void>;\n  open(): void;\n  readonly opened: boolean;\n}\n\n/** Create a latch that stays open once opened. */\nexport function createLatch(): Latch {\n  let opened = false;\n  const waiters: Deferred[] = [];\n  return {\n    wait: () => {\n      if (opened) return Promise.resolve();\n      const waiter = deferred();\n      waiters.push(waiter);\n      return waiter.promise;\n    },\n    open: () => {\n      opened = true;\n      for (const waiter of waiters.splice(0)) waiter.resolve();\n    },\n    get opened() {\n      return opened;\n    },\n  };\n}\n\n/** A set of deferreds a test can release one at a time, in order. */\nexport interface ReleaseQueue {\n  /** The next deferred to hand to a task. */\n  next(): Promise<void>;\n  /** Release the oldest waiter. */\n  release(): void;\n  /** Release every waiter created so far. */\n  releaseAll(): void;\n  /** Waiters created but not released yet. */\n  readonly pending: number;\n}\n\n/** Create a FIFO release queue. */\nexport function createReleaseQueue(): ReleaseQueue {\n  const waiters: Deferred[] = [];\n  return {\n    next: () => {\n      const waiter = deferred();\n      waiters.push(waiter);\n      return waiter.promise;\n    },\n    release: () => {\n      waiters.shift()?.resolve();\n    },\n    releaseAll: () => {\n      for (const waiter of waiters.splice(0)) waiter.resolve();\n    },\n    get pending() {\n      return waiters.length;\n    },\n  };\n}\n"],"mappings":";;;;;AAaA,SAAgB,WAAkC;CAChD,IAAI;CACJ,IAAI;CAKJ,OAAO;EAAE,SAAA,IAJW,SAAY,gBAAgB,kBAAkB;GAChE,UAAU;GACV,SAAS;EACX,CACe;EAAG;EAAS;CAAO;AACpC;;AAUA,SAAgB,cAAqB;CACnC,IAAI,SAAS;CACb,MAAM,UAAsB,CAAC;CAC7B,OAAO;EACL,YAAY;GACV,IAAI,QAAQ,OAAO,QAAQ,QAAQ;GACnC,MAAM,SAAS,SAAS;GACxB,QAAQ,KAAK,MAAM;GACnB,OAAO,OAAO;EAChB;EACA,YAAY;GACV,SAAS;GACT,KAAK,MAAM,UAAU,QAAQ,OAAO,CAAC,GAAG,OAAO,QAAQ;EACzD;EACA,IAAI,SAAS;GACX,OAAO;EACT;CACF;AACF;;AAeA,SAAgB,qBAAmC;CACjD,MAAM,UAAsB,CAAC;CAC7B,OAAO;EACL,YAAY;GACV,MAAM,SAAS,SAAS;GACxB,QAAQ,KAAK,MAAM;GACnB,OAAO,OAAO;EAChB;EACA,eAAe;GACb,QAAQ,MAAM,CAAC,EAAE,QAAQ;EAC3B;EACA,kBAAkB;GAChB,KAAK,MAAM,UAAU,QAAQ,OAAO,CAAC,GAAG,OAAO,QAAQ;EACzD;EACA,IAAI,UAAU;GACZ,OAAO,QAAQ;EACjB;CACF;AACF"}

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

@@ -0,0 +1,19 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DesignProvider } from "../adapter/design.mjs";
+/** Build the provider under test (sync or async factories both work). */
+type DesignFactory = () => DesignProvider | Promise<DesignProvider>;
+/** Links the suite uses to probe `parseUrl`. */
+interface DesignContractSamples {
+  /** A link the provider must accept, with the file key it must yield. */
+  valid: {
+    url: string;
+    fileKey: string;
+  };
+  /** A link the provider must reject. */
+  invalid: string;
+}
+/** Run the design-provider contract against a factory. */
+declare function designContractSuite(label: string, make: DesignFactory, samples: DesignContractSamples): void;
+export { DesignContractSamples, DesignFactory, designContractSuite };
+//# sourceMappingURL=design-contract.d.mts.map

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

@@ -0,0 +1,39 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { describe, expect, it } from "vitest";
+// src/test-helpers/design-contract.ts
+/**
+* Published design-provider contract suite for first- and third-party providers.
+*
+* Structural conformance (identity, descriptor, link parsing). Vendor API calls
+* stay per-package behind faked transports.
+*/
+/** Run the design-provider contract against a factory. */
+function designContractSuite(label, make, samples) {
+	describe(`design contract: ${label}`, () => {
+		it("exposes design metadata with credential copy", async () => {
+			const { metadata } = await make();
+			expect(metadata.category).toBe("design");
+			expect(metadata.kind.length).toBeGreaterThan(0);
+			expect(metadata.credentialLabel.length).toBeGreaterThan(0);
+			expect(metadata.credentialHelp.length).toBeGreaterThan(0);
+			expect(metadata.urlHint.length).toBeGreaterThan(0);
+		});
+		it("parses its own links and rejects foreign ones", async () => {
+			const provider = await make();
+			expect(provider.parseUrl(samples.valid.url)?.fileKey).toBe(samples.valid.fileKey);
+			expect(provider.parseUrl(samples.invalid)).toBeNull();
+			expect(provider.parseUrl("not a url")).toBeNull();
+			expect(provider.parseUrl("")).toBeNull();
+		});
+		it("creates a client with both fetch methods", async () => {
+			const client = (await make()).create({ credential: "test-credential" });
+			expect(typeof client.fetchMetas).toBe("function");
+			expect(typeof client.fetchRenders).toBe("function");
+		});
+	});
+}
+export { designContractSuite };
+
+//# sourceMappingURL=design-contract.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"design-contract.mjs","names":[],"sources":["../../src/test-helpers/design-contract.ts"],"sourcesContent":["/**\n * Published design-provider contract suite for first- and third-party providers.\n *\n * Structural conformance (identity, descriptor, link parsing). Vendor API calls\n * stay per-package behind faked transports.\n */\nimport { describe, expect, it } from \"vitest\";\nimport type { DesignProvider } from \"../adapters/design.ts\";\n\n/** Build the provider under test (sync or async factories both work). */\nexport type DesignFactory = () => DesignProvider | Promise<DesignProvider>;\n\n/** Links the suite uses to probe `parseUrl`. */\nexport interface DesignContractSamples {\n  /** A link the provider must accept, with the file key it must yield. */\n  valid: { url: string; fileKey: string };\n  /** A link the provider must reject. */\n  invalid: string;\n}\n\n/** Run the design-provider contract against a factory. */\nexport function designContractSuite(\n  label: string,\n  make: DesignFactory,\n  samples: DesignContractSamples,\n): void {\n  describe(`design contract: ${label}`, () => {\n    it(\"exposes design metadata with credential copy\", async () => {\n      const { metadata } = await make();\n      expect(metadata.category).toBe(\"design\");\n      expect(metadata.kind.length).toBeGreaterThan(0);\n      expect(metadata.credentialLabel.length).toBeGreaterThan(0);\n      expect(metadata.credentialHelp.length).toBeGreaterThan(0);\n      expect(metadata.urlHint.length).toBeGreaterThan(0);\n    });\n\n    it(\"parses its own links and rejects foreign ones\", async () => {\n      const provider = await make();\n      expect(provider.parseUrl(samples.valid.url)?.fileKey).toBe(samples.valid.fileKey);\n      expect(provider.parseUrl(samples.invalid)).toBeNull();\n      expect(provider.parseUrl(\"not a url\")).toBeNull();\n      expect(provider.parseUrl(\"\")).toBeNull();\n    });\n\n    it(\"creates a client with both fetch methods\", async () => {\n      const client = (await make()).create({ credential: \"test-credential\" });\n      expect(typeof client.fetchMetas).toBe(\"function\");\n      expect(typeof client.fetchRenders).toBe(\"function\");\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;AAqBA,SAAgB,oBACd,OACA,MACA,SACM;CACN,SAAS,oBAAoB,eAAe;EAC1C,GAAG,gDAAgD,YAAY;GAC7D,MAAM,EAAE,aAAa,MAAM,KAAK;GAChC,OAAO,SAAS,QAAQ,CAAC,CAAC,KAAK,QAAQ;GACvC,OAAO,SAAS,KAAK,MAAM,CAAC,CAAC,gBAAgB,CAAC;GAC9C,OAAO,SAAS,gBAAgB,MAAM,CAAC,CAAC,gBAAgB,CAAC;GACzD,OAAO,SAAS,eAAe,MAAM,CAAC,CAAC,gBAAgB,CAAC;GACxD,OAAO,SAAS,QAAQ,MAAM,CAAC,CAAC,gBAAgB,CAAC;EACnD,CAAC;EAED,GAAG,iDAAiD,YAAY;GAC9D,MAAM,WAAW,MAAM,KAAK;GAC5B,OAAO,SAAS,SAAS,QAAQ,MAAM,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,QAAQ,MAAM,OAAO;GAChF,OAAO,SAAS,SAAS,QAAQ,OAAO,CAAC,CAAC,CAAC,SAAS;GACpD,OAAO,SAAS,SAAS,WAAW,CAAC,CAAC,CAAC,SAAS;GAChD,OAAO,SAAS,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;EACzC,CAAC;EAED,GAAG,4CAA4C,YAAY;GACzD,MAAM,UAAU,MAAM,KAAK,EAAA,CAAG,OAAO,EAAE,YAAY,kBAAkB,CAAC;GACtE,OAAO,OAAO,OAAO,UAAU,CAAC,CAAC,KAAK,UAAU;GAChD,OAAO,OAAO,OAAO,YAAY,CAAC,CAAC,KAAK,UAAU;EACpD,CAAC;CACH,CAAC;AACH"}

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

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

@@ -4,10 +4,16 @@ import.meta.url;
 import { clampListLimit } from "../adapter/database.mjs";
 import { fakeSchema } from "./fake-tables.mjs";
 import { orderRows, whereMatches } from "./sql-chunks.mjs";
-//#region src/test-helpers/fake-database.ts
+import { getTableName } from "drizzle-orm";
+// src/test-helpers/fake-database.ts
 function withoutUndefined(values) {
 	return Object.fromEntries(Object.entries(values).filter((pair) => pair[1] !== void 0));
 }
+/** Column defaults real drivers apply on insert (the fake has no DDL). */
+const INSERT_DEFAULTS = {
+	snapshots: { browser: "chromium" },
+	baselines: { browser: "chromium" }
+};
 /** Create an in-memory database adapter for capture pipeline tests. */
 function makeDatabase() {
 	const store = /* @__PURE__ */ new Map();
@@ -20,8 +26,12 @@ function makeDatabase() {
 		return rowMap;
 	};
 	const insertRow = async (table, values) => {
-		const row = withoutUndefined(values);
+		const row = {
+			...INSERT_DEFAULTS[getTableName(table)],
+			...withoutUndefined(values)
+		};
 		const key = row["id"] ?? row["hash"];
+		if (rowsOf(table).has(key)) throw new Error(`UNIQUE constraint failed: duplicate key ${key}`);
 		rowsOf(table).set(key, row);
 		return row;
 	};
@@ -47,7 +57,9 @@ function makeDatabase() {
 			current = current.filter((row) => whereMatches(where, row, table));
 		}
 		if (opts.orderBy) current = orderRows(current, opts.orderBy, table);
-		if (opts.limit !== void 0) current = current.slice(0, clampListLimit(opts.limit));
+		const start = opts.offset ?? 0;
+		if (opts.limit !== void 0) current = current.slice(start, start + (clampListLimit(opts.limit) ?? 0));
+		else if (start > 0) current = current.slice(start);
 		return current;
 	};
 	const countRows = async (table, where) => {
@@ -84,6 +96,12 @@ function makeDatabase() {
 		tables: fakeSchema,
 		insert: insertRow,
 		update: updateRow,
+		updateWhere: async (table, id, values, where) => {
+			const current = rowsOf(table).get(id);
+			if (!current) return null;
+			if (whereMatches(where, current, table)) return await updateRow(table, id, values);
+			return current;
+		},
 		get: getRow,
 		remove: async (table, id) => {
 			rowsOf(table).delete(id);
@@ -98,7 +116,6 @@ function makeDatabase() {
 		}
 	} };
 }
-//#endregion
 export { makeDatabase };
 
 //# sourceMappingURL=fake-database.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"fake-database.mjs","names":[],"sources":["../../src/test-helpers/fake-database.ts"],"sourcesContent":["import type { SQL, Table } from \"drizzle-orm\";\nimport type { DatabaseAdapter, ListOptions, TxStore } from \"../adapters/database.ts\";\nimport { clampListLimit } from \"../adapters/database.ts\";\nimport { fakeSchema } from \"./fake-tables.ts\";\nimport { orderRows, whereMatches } from \"./sql-chunks.ts\";\n\nfunction withoutUndefined(values: unknown): Record<string, unknown> {\n  return Object.fromEntries(\n    Object.entries(values as Record<string, unknown>).filter((pair) => pair[1] !== undefined),\n  );\n}\n\n// The in-memory fake back-fills Drizzle's inferred row types from raw maps\n// Without a driver, so the casts and await-free `async` methods are unavoidable.\n/* eslint-disable require-await, no-unnecessary-type-assertion, no-unnecessary-type-parameters, non-nullable-type-assertion-style */\n/** Create an in-memory database adapter for capture pipeline tests. */\nexport function makeDatabase(): { db: DatabaseAdapter } {\n  const store = new Map<Table, Map<string, unknown>>();\n\n  const rowsOf = (table: Table): Map<string, unknown> => {\n    let rowMap = store.get(table);\n    if (!rowMap) {\n      rowMap = new Map();\n      store.set(table, rowMap);\n    }\n    return rowMap;\n  };\n\n  const insertRow = async <T extends Table>(\n    table: T,\n    values: T[\"$inferInsert\"],\n  ): Promise<T[\"$inferSelect\"]> => {\n    const row = withoutUndefined(values);\n    const key = (row[\"id\"] ?? row[\"hash\"]) as string;\n    rowsOf(table).set(key, row);\n    return row as T[\"$inferSelect\"];\n  };\n\n  const updateRow = async <T extends Table>(\n    table: T,\n    id: string,\n    values: Partial<T[\"$inferInsert\"]>,\n  ): Promise<T[\"$inferSelect\"]> => {\n    const current = rowsOf(table).get(id) as Record<string, unknown> | undefined;\n    if (current === undefined) {\n      throw new Error(\"row not found\");\n    }\n    const merged = withoutUndefined({ ...current, ...values });\n    rowsOf(table).set(id, merged);\n    return merged as T[\"$inferSelect\"];\n  };\n\n  const getRow = async <T extends Table>(\n    table: T,\n    id: string,\n  ): Promise<T[\"$inferSelect\"] | null> => {\n    const found = rowsOf(table).get(id);\n    if (found === undefined) {\n      return null;\n    }\n    return found as T[\"$inferSelect\"];\n  };\n\n  const listRows = async <T extends Table>(\n    table: T,\n    opts: ListOptions = {},\n  ): Promise<T[\"$inferSelect\"][]> => {\n    let current = [...rowsOf(table).values()];\n    if (opts.where) {\n      const { where } = opts;\n      current = current.filter((row) => whereMatches(where, row as Record<string, unknown>, table));\n    }\n    if (opts.orderBy) {\n      current = orderRows(current, opts.orderBy, table);\n    }\n    if (opts.limit !== undefined) {\n      current = current.slice(0, clampListLimit(opts.limit));\n    }\n    return current as T[\"$inferSelect\"][];\n  };\n\n  const countRows = async (table: Table, where?: SQL): Promise<number> => {\n    const matching = await listRows(table, where ? { where } : {});\n    return matching.length;\n  };\n\n  const transactRows = async <R>(fn: (tx: TxStore) => Promise<R>): Promise<R> => {\n    const snapshot = new Map<Table, Map<string, unknown>>();\n    for (const [table, rows] of store) {\n      snapshot.set(\n        table,\n        new Map([...rows].map(([id, row]) => [id, { ...(row as Record<string, unknown>) }])),\n      );\n    }\n    const tx: TxStore = {\n      insert: insertRow,\n      update: updateRow,\n      get: getRow,\n      remove: async (table, id) => {\n        rowsOf(table).delete(id);\n      },\n      list: listRows,\n      count: countRows,\n    };\n    try {\n      return await fn(tx);\n    } catch (error) {\n      store.clear();\n      for (const [table, rows] of snapshot) {\n        store.set(table, rows);\n      }\n      throw error;\n    }\n  };\n\n  const db: DatabaseAdapter = {\n    metadata: { name: \"Fake Database\", version: \"0.0.0\", kind: \"memory\", category: \"database\" },\n    tables: fakeSchema,\n    insert: insertRow,\n    update: updateRow,\n    get: getRow,\n    remove: async (table, id) => {\n      rowsOf(table).delete(id);\n    },\n    list: listRows,\n    count: countRows,\n    transact: transactRows,\n    all: async (_query: SQL) => {\n      const results: Record<string, unknown>[] = [];\n      for (const rows of store.values()) {\n        for (const row of rows.values()) {\n          results.push(row as Record<string, unknown>);\n        }\n      }\n      return results as never[];\n    },\n  };\n  return { db };\n}\n/* eslint-enable require-await, no-unnecessary-type-assertion, no-unnecessary-type-parameters, non-nullable-type-assertion-style */\n"],"mappings":"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"}
+{"version":3,"file":"fake-database.mjs","names":[],"sources":["../../src/test-helpers/fake-database.ts"],"sourcesContent":["import { getTableName } from \"drizzle-orm\";\nimport type { SQL, Table } from \"drizzle-orm\";\nimport type { DatabaseAdapter, ListOptions, TxStore } from \"../adapters/database.ts\";\nimport { clampListLimit } from \"../adapters/database.ts\";\nimport { fakeSchema } from \"./fake-tables.ts\";\nimport { orderRows, whereMatches } from \"./sql-chunks.ts\";\n\nfunction withoutUndefined(values: unknown): Record<string, unknown> {\n  return Object.fromEntries(\n    Object.entries(values as Record<string, unknown>).filter((pair) => pair[1] !== undefined),\n  );\n}\n\n/** Column defaults real drivers apply on insert (the fake has no DDL). */\nconst INSERT_DEFAULTS: Record<string, Record<string, unknown>> = {\n  snapshots: { browser: \"chromium\" },\n  baselines: { browser: \"chromium\" },\n};\n\n// The in-memory fake back-fills Drizzle's inferred row types from raw maps\n// Without a driver, so the casts and await-free `async` methods are unavoidable.\n/* eslint-disable require-await, no-unnecessary-type-assertion, no-unnecessary-type-parameters, non-nullable-type-assertion-style */\n/** Create an in-memory database adapter for capture pipeline tests. */\nexport function makeDatabase(): { db: DatabaseAdapter } {\n  const store = new Map<Table, Map<string, unknown>>();\n\n  const rowsOf = (table: Table): Map<string, unknown> => {\n    let rowMap = store.get(table);\n    if (!rowMap) {\n      rowMap = new Map();\n      store.set(table, rowMap);\n    }\n    return rowMap;\n  };\n\n  const insertRow = async <T extends Table>(\n    table: T,\n    values: T[\"$inferInsert\"],\n  ): Promise<T[\"$inferSelect\"]> => {\n    const row = { ...INSERT_DEFAULTS[getTableName(table)], ...withoutUndefined(values) };\n    const key = (row[\"id\"] ?? row[\"hash\"]) as string;\n    if (rowsOf(table).has(key)) {\n      throw new Error(`UNIQUE constraint failed: duplicate key ${key}`);\n    }\n    rowsOf(table).set(key, row);\n    return row as T[\"$inferSelect\"];\n  };\n\n  const updateRow = async <T extends Table>(\n    table: T,\n    id: string,\n    values: Partial<T[\"$inferInsert\"]>,\n  ): Promise<T[\"$inferSelect\"]> => {\n    const current = rowsOf(table).get(id) as Record<string, unknown> | undefined;\n    if (current === undefined) {\n      throw new Error(\"row not found\");\n    }\n    const merged = withoutUndefined({ ...current, ...values });\n    rowsOf(table).set(id, merged);\n    return merged as T[\"$inferSelect\"];\n  };\n\n  const getRow = async <T extends Table>(\n    table: T,\n    id: string,\n  ): Promise<T[\"$inferSelect\"] | null> => {\n    const found = rowsOf(table).get(id);\n    if (found === undefined) {\n      return null;\n    }\n    return found as T[\"$inferSelect\"];\n  };\n\n  const listRows = async <T extends Table>(\n    table: T,\n    opts: ListOptions = {},\n  ): Promise<T[\"$inferSelect\"][]> => {\n    let current = [...rowsOf(table).values()];\n    if (opts.where) {\n      const { where } = opts;\n      current = current.filter((row) => whereMatches(where, row as Record<string, unknown>, table));\n    }\n    if (opts.orderBy) {\n      current = orderRows(current, opts.orderBy, table);\n    }\n    const start = opts.offset ?? 0;\n    if (opts.limit !== undefined) {\n      current = current.slice(start, start + (clampListLimit(opts.limit) ?? 0));\n    } else if (start > 0) {\n      current = current.slice(start);\n    }\n    return current as T[\"$inferSelect\"][];\n  };\n\n  const countRows = async (table: Table, where?: SQL): Promise<number> => {\n    const matching = await listRows(table, where ? { where } : {});\n    return matching.length;\n  };\n\n  const transactRows = async <R>(fn: (tx: TxStore) => Promise<R>): Promise<R> => {\n    const snapshot = new Map<Table, Map<string, unknown>>();\n    for (const [table, rows] of store) {\n      snapshot.set(\n        table,\n        new Map([...rows].map(([id, row]) => [id, { ...(row as Record<string, unknown>) }])),\n      );\n    }\n    const tx: TxStore = {\n      insert: insertRow,\n      update: updateRow,\n      get: getRow,\n      remove: async (table, id) => {\n        rowsOf(table).delete(id);\n      },\n      list: listRows,\n      count: countRows,\n    };\n    try {\n      return await fn(tx);\n    } catch (error) {\n      store.clear();\n      for (const [table, rows] of snapshot) {\n        store.set(table, rows);\n      }\n      throw error;\n    }\n  };\n\n  const db: DatabaseAdapter = {\n    metadata: { name: \"Fake Database\", version: \"0.0.0\", kind: \"memory\", category: \"database\" },\n    tables: fakeSchema,\n    insert: insertRow,\n    update: updateRow,\n    updateWhere: async (table, id, values, where) => {\n      const current = rowsOf(table).get(id) as Record<string, unknown> | undefined;\n      if (!current) return null;\n      if (whereMatches(where, current, table)) return await updateRow(table, id, values);\n      return current as never;\n    },\n    get: getRow,\n    remove: async (table, id) => {\n      rowsOf(table).delete(id);\n    },\n    list: listRows,\n    count: countRows,\n    transact: transactRows,\n    all: async (_query: SQL) => {\n      const results: Record<string, unknown>[] = [];\n      for (const rows of store.values()) {\n        for (const row of rows.values()) {\n          results.push(row as Record<string, unknown>);\n        }\n      }\n      return results as never[];\n    },\n  };\n  return { db };\n}\n/* eslint-enable require-await, no-unnecessary-type-assertion, no-unnecessary-type-parameters, non-nullable-type-assertion-style */\n"],"mappings":"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"}

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

@@ -0,0 +1,41 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DesignProvider, DesignState } from "../adapter/design.mjs";
+import { Buffer } from "node:buffer";
+declare const FAKE_PNG: Buffer<ArrayBuffer>;
+/** Mutable behavior and call log of a {@link makeFakeDesign} provider. */
+interface FakeDesign {
+  provider: DesignProvider;
+  /** File version served; bump it to simulate an edit. */
+  version: string;
+  lastModified: string;
+  /** Per node id (`""` = whole file) state override; defaults to `ok`. */
+  states: Map<string, DesignState>;
+  /** Node ids the vendor cannot render. */
+  unrenderable: Set<string>;
+  /** Make every render call throw. */
+  failRenders: boolean;
+  /** Artificial latency per call, to observe concurrency. */
+  delayMs: number;
+  /** Credentials the provider was created with, in order. */
+  credentials: string[];
+  /** How each of those credentials authenticates, in the same order. */
+  authTypes: string[];
+  metaCalls: {
+    fileKey: string;
+    nodeIds: string[];
+  }[];
+  renderCalls: {
+    fileKey: string;
+    nodeIds: string[];
+  }[];
+  /** Calls currently in flight and the highest value seen. */
+  inFlight: number;
+  peak: number;
+}
+/** Link to a fake file, optionally a node of it. */
+declare const fakeUrl: (fileKey: string, nodeId?: string) => string;
+/** Create a fake provider whose behavior the test mutates through the returned object. */
+declare function makeFakeDesign(kind?: string): FakeDesign;
+export { FAKE_PNG, FakeDesign, fakeUrl, makeFakeDesign };
+//# sourceMappingURL=fake-design.d.mts.map