@storyshelf/core 0.3.2 → 0.5.4

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

@@ -0,0 +1 @@
+{"version":3,"file":"fake-tables.mjs","names":[],"sources":["../../src/test-helpers/fake-tables.ts"],"sourcesContent":["/**\n * Dialect-free stub tables for the in-memory test fake.\n *\n * The fake never touches a driver: it only needs table handles whose columns\n * carry the property → column-name mapping (`getTableColumns`) and flow\n * through drizzle's expression builders (`eq`, `and`, `inArray`, `orderBy`)\n * into the `sql-chunks.ts` matcher. Real `Column`/`Table` base classes from\n * the `drizzle-orm` root (already a core dependency) satisfy both without\n * pulling in any dialect package (`sqlite-core`, `pg-core`, …).\n */\nimport { Column, Table } from \"drizzle-orm\";\nimport type { Tables } from \"../adapters/database.ts\";\n\n/** A column handle with driver passthrough mapping (the fake maps nothing). */\nclass FakeColumn extends Column {\n  override getSQLType(): string {\n    return this.columnType;\n  }\n}\n\n// `Table.Symbol` is runtime-only (`@internal`, absent from the public types).\nconst columnsSymbol = (Table as unknown as { Symbol: { Columns: symbol } }).Symbol.Columns;\n\nfunction defineTable(name: string, columns: Record<string, string>): Table {\n  const table = new Table(name, undefined, name);\n  const handles: Record<string, FakeColumn> = {};\n  for (const [property, dbName] of Object.entries(columns)) {\n    handles[property] = new FakeColumn(table, {\n      name: dbName,\n      keyAsName: false,\n      notNull: false,\n      default: undefined,\n      defaultFn: undefined,\n      onUpdateFn: undefined,\n      hasDefault: false,\n      primaryKey: false,\n      isUnique: false,\n      uniqueName: undefined,\n      uniqueType: undefined,\n      dataType: \"string\",\n      columnType: \"FakeColumn\",\n      generated: undefined,\n      generatedIdentity: undefined,\n    });\n  }\n  (table as unknown as Record<symbol, unknown>)[columnsSymbol] = handles;\n  return table;\n}\n\n// Stub tables matching the real schema's property -> column mapping.\n// No constraints or defaults — just names for whereMatches/orderRows.\nconst projects = defineTable(\"projects\", {\n  id: \"id\",\n  name: \"name\",\n  slug: \"slug\",\n  gitRepository: \"git_repository\",\n  gitDefaultBranch: \"git_default_branch\",\n  pixelThreshold: \"pixel_threshold\",\n  maxDiffRatio: \"max_diff_ratio\",\n  publicBranchRegex: \"public_branch_regex\",\n  storybookMeta: \"storybook_meta\",\n  executePlay: \"execute_play\",\n  playTimeoutMs: \"play_timeout_ms\",\n  runA11y: \"run_a11y\",\n  browser: \"browser\",\n  viewports: \"viewports\",\n  automigrate: \"automigrate\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst projectStatusConfigs = defineTable(\"project_status_configs\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  provider: \"provider\",\n  config: \"config\",\n  tokenEncrypted: \"token_encrypted\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst builds = defineTable(\"builds\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  gitSha: \"git_sha\",\n  gitBranch: \"git_branch\",\n  isDefault: \"is_default\",\n  authorEmail: \"author_email\",\n  authorName: \"author_name\",\n  message: \"message\",\n  public: \"public\",\n  status: \"status\",\n  snapshotCount: \"snapshot_count\",\n  changedCount: \"changed_count\",\n  approvedCount: \"approved_count\",\n  rejectedCount: \"rejected_count\",\n  affectedOnly: \"affected_only\",\n  baselineSha: \"baseline_sha\",\n  changedFiles: \"changed_files\",\n  affectedImportPaths: \"affected_import_paths\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst captureAttempts = defineTable(\"capture_attempts\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  attemptNo: \"attempt_no\",\n  status: \"status\",\n  error: \"error\",\n  reqId: \"req_id\",\n  storyCount: \"story_count\",\n  failedCount: \"failed_count\",\n  queuedAt: \"queued_at\",\n  startedAt: \"started_at\",\n  finishedAt: \"finished_at\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst captureLogs = defineTable(\"capture_logs\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  attemptId: \"attempt_id\",\n  seq: \"seq\",\n  level: \"level\",\n  message: \"message\",\n  fields: \"fields\",\n  createdAt: \"created_at\",\n});\n\nconst snapshots = defineTable(\"snapshots\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  storyId: \"story_id\",\n  storyName: \"story_name\",\n  storyTitle: \"story_title\",\n  storyImportPath: \"story_import_path\",\n  viewportName: \"viewport_name\",\n  viewportWidth: \"viewport_width\",\n  viewportHeight: \"viewport_height\",\n  screenshotPath: \"screenshot_path\",\n  diffPath: \"diff_path\",\n  diffPixels: \"diff_pixels\",\n  diffRatio: \"diff_ratio\",\n  diffPassed: \"diff_passed\",\n  status: \"status\",\n  reviewedBy: \"reviewed_by\",\n  reviewedAt: \"reviewed_at\",\n  infraHash: \"infra_hash\",\n  inherited: \"inherited\",\n  baselineId: \"baseline_id\",\n  baselineVersion: \"baseline_version\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst baselines = defineTable(\"baselines\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  storyId: \"story_id\",\n  viewportName: \"viewport_name\",\n  branch: \"branch\",\n  snapshotId: \"snapshot_id\",\n  screenshotPath: \"screenshot_path\",\n  infraHash: \"infra_hash\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst comments = defineTable(\"comments\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  snapshotId: \"snapshot_id\",\n  userId: \"user_id\",\n  body: \"body\",\n  parentId: \"parent_id\",\n  resolved: \"resolved\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst labelTypes = defineTable(\"label_types\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  key: \"key\",\n  name: \"name\",\n  linkTemplate: \"link_template\",\n  color: \"color\",\n  createdAt: \"created_at\",\n});\n\nconst buildLabels = defineTable(\"build_labels\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  typeKey: \"type_key\",\n  value: \"value\",\n  createdAt: \"created_at\",\n});\n\nconst tokens = defineTable(\"tokens\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  name: \"name\",\n  hash: \"hash\",\n  userId: \"user_id\",\n  lastUsedAt: \"last_used_at\",\n  createdAt: \"created_at\",\n});\n\nconst webhooks = defineTable(\"webhooks\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  url: \"url\",\n  secretEncrypted: \"secret_encrypted\",\n  events: \"events\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst users = defineTable(\"users\", {\n  id: \"id\",\n  email: \"email\",\n  name: \"name\",\n  avatarUrl: \"avatar_url\",\n  role: \"role\",\n  lastLoginAt: \"last_login_at\",\n  createdAt: \"created_at\",\n  passwordHash: \"password_hash\",\n  displayNameOverride: \"display_name_override\",\n  authProvider: \"auth_provider\",\n  disabled: \"disabled\",\n});\n\nconst userInviteTokens = defineTable(\"user_invite_tokens\", {\n  id: \"id\",\n  userId: \"user_id\",\n  tokenHash: \"token_hash\",\n  expiresAt: \"expires_at\",\n  usedAt: \"used_at\",\n  createdAt: \"created_at\",\n});\n\nconst projectMembers = defineTable(\"project_members\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  userId: \"user_id\",\n  role: \"role\",\n  source: \"source\",\n  createdAt: \"created_at\",\n});\n\nconst projectGroupMappings = defineTable(\"project_group_mappings\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  groupName: \"group_name\",\n  role: \"role\",\n  createdAt: \"created_at\",\n});\n\nconst notificationChannels = defineTable(\"notification_channels\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  provider: \"provider\",\n  config: \"config\",\n  secretEncrypted: \"secret_encrypted\",\n  events: \"events\",\n  enabled: \"enabled\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst notificationSubscriptions = defineTable(\"notification_subscriptions\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  userId: \"user_id\",\n  events: \"events\",\n  via: \"via\",\n  enabled: \"enabled\",\n  createdAt: \"created_at\",\n});\n\nconst contentRefs = defineTable(\"content_refs\", {\n  hash: \"hash\",\n  refCount: \"ref_count\",\n  lastSeenAt: \"last_seen_at\",\n  createdAt: \"created_at\",\n});\n\n/** Stub schema bundled into the `Tables` map every fake serves. */\nexport const fakeSchema: Tables = {\n  projects,\n  projectStatusConfigs,\n  builds,\n  captureAttempts,\n  captureLogs,\n  snapshots,\n  baselines,\n  comments,\n  labelTypes,\n  buildLabels,\n  tokens,\n  webhooks,\n  users,\n  userInviteTokens,\n  projectMembers,\n  projectGroupMappings,\n  notificationChannels,\n  notificationSubscriptions,\n  contentRefs,\n};\n"],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { GitHostProvider } from "../adapter/git-host.mjs";
+//#region src/test-helpers/git-contract.d.ts
+/** Build the provider under test (sync or async factories both work). */
+type GitFactory = () => GitHostProvider | Promise<GitHostProvider>;
+/** Run the git-host contract against a factory. */
+declare function gitContractSuite(label: string, make: GitFactory): void;
+//#endregion
+export { GitFactory, gitContractSuite };
+//# sourceMappingURL=git-contract.d.mts.map

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

@@ -0,0 +1,34 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { describe, expect, it } from "vitest";
+//#region src/test-helpers/git-contract.ts
+/**
+* Published git-host contract suite for first- and third-party providers.
+*
+* Structural conformance (identity, descriptor, config schema). Status
+* posting stays per-package behind faked transports.
+*/
+/** Run the git-host contract against a factory. */
+function gitContractSuite(label, make) {
+	describe(`git-host contract: ${label}`, () => {
+		it("exposes git-host metadata with a config schema", async () => {
+			const provider = await make();
+			expect(provider.metadata.category).toBe("git-host");
+			expect(provider.metadata.kind.length).toBeGreaterThan(0);
+			expect(typeof provider.metadata.schema.parse).toBe("function");
+		});
+		it("exposes the create descriptor", async () => {
+			const provider = await make();
+			expect(typeof provider.create).toBe("function");
+		});
+		it("validates channel config through a real schema", async () => {
+			const result = (await make()).metadata.schema.safeParse({});
+			expect(typeof result.success).toBe("boolean");
+		});
+	});
+}
+//#endregion
+export { gitContractSuite };
+
+//# sourceMappingURL=git-contract.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-contract.mjs","names":[],"sources":["../../src/test-helpers/git-contract.ts"],"sourcesContent":["/**\n * Published git-host contract suite for first- and third-party providers.\n *\n * Structural conformance (identity, descriptor, config schema). Status\n * posting stays per-package behind faked transports.\n */\nimport { describe, expect, it } from \"vitest\";\nimport type { GitHostProvider } from \"../adapters/git-host/index.ts\";\n\n/** Build the provider under test (sync or async factories both work). */\nexport type GitFactory = () => GitHostProvider | Promise<GitHostProvider>;\n\n/** Run the git-host contract against a factory. */\nexport function gitContractSuite(label: string, make: GitFactory): void {\n  describe(`git-host contract: ${label}`, () => {\n    it(\"exposes git-host metadata with a config schema\", async () => {\n      const provider = await make();\n      expect(provider.metadata.category).toBe(\"git-host\");\n      expect(provider.metadata.kind.length).toBeGreaterThan(0);\n      expect(typeof provider.metadata.schema.parse).toBe(\"function\");\n    });\n\n    it(\"exposes the create descriptor\", async () => {\n      const provider = await make();\n      expect(typeof provider.create).toBe(\"function\");\n    });\n\n    it(\"validates channel config through a real schema\", async () => {\n      const provider = await make();\n      const result = provider.metadata.schema.safeParse({});\n      expect(typeof result.success).toBe(\"boolean\");\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,iBAAiB,OAAe,MAAwB;CACtE,SAAS,sBAAsB,eAAe;EAC5C,GAAG,kDAAkD,YAAY;GAC/D,MAAM,WAAW,MAAM,KAAK;GAC5B,OAAO,SAAS,SAAS,QAAQ,CAAC,CAAC,KAAK,UAAU;GAClD,OAAO,SAAS,SAAS,KAAK,MAAM,CAAC,CAAC,gBAAgB,CAAC;GACvD,OAAO,OAAO,SAAS,SAAS,OAAO,KAAK,CAAC,CAAC,KAAK,UAAU;EAC/D,CAAC;EAED,GAAG,iCAAiC,YAAY;GAC9C,MAAM,WAAW,MAAM,KAAK;GAC5B,OAAO,OAAO,SAAS,MAAM,CAAC,CAAC,KAAK,UAAU;EAChD,CAAC;EAED,GAAG,kDAAkD,YAAY;GAE/D,MAAM,UAAS,MADQ,KAAK,EAAA,CACJ,SAAS,OAAO,UAAU,CAAC,CAAC;GACpD,OAAO,OAAO,OAAO,OAAO,CAAC,CAAC,KAAK,SAAS;EAC9C,CAAC;CACH,CAAC;AACH"}

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

@@ -0,0 +1,11 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { NotifierProvider } from "../adapters/notifier/provider.mjs";
+//#region src/test-helpers/notifier-contract.d.ts
+/** Build the provider under test (sync or async factories both work). */
+type NotifierFactory = () => NotifierProvider | Promise<NotifierProvider>;
+/** Run the notifier contract against a factory. */
+declare function notifierContractSuite(label: string, make: NotifierFactory): void;
+//#endregion
+export { NotifierFactory, notifierContractSuite };
+//# sourceMappingURL=notifier-contract.d.mts.map

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

@@ -0,0 +1,34 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { describe, expect, it } from "vitest";
+//#region src/test-helpers/notifier-contract.ts
+/**
+* Published notifier contract suite for first- and third-party providers.
+*
+* Structural conformance (identity, descriptor, config schema). Message
+* delivery stays per-package behind faked transports.
+*/
+/** Run the notifier contract against a factory. */
+function notifierContractSuite(label, make) {
+	describe(`notifier contract: ${label}`, () => {
+		it("exposes notifier metadata with a config schema", async () => {
+			const provider = await make();
+			expect(provider.metadata.category).toBe("notifier");
+			expect(provider.metadata.kind.length).toBeGreaterThan(0);
+			expect(typeof provider.metadata.schema.parse).toBe("function");
+		});
+		it("exposes the create descriptor", async () => {
+			const provider = await make();
+			expect(typeof provider.create).toBe("function");
+		});
+		it("validates channel config through a real schema", async () => {
+			const result = (await make()).metadata.schema.safeParse({});
+			expect(typeof result.success).toBe("boolean");
+		});
+	});
+}
+//#endregion
+export { notifierContractSuite };
+
+//# sourceMappingURL=notifier-contract.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notifier-contract.mjs","names":[],"sources":["../../src/test-helpers/notifier-contract.ts"],"sourcesContent":["/**\n * Published notifier contract suite for first- and third-party providers.\n *\n * Structural conformance (identity, descriptor, config schema). Message\n * delivery stays per-package behind faked transports.\n */\nimport { describe, expect, it } from \"vitest\";\nimport type { NotifierProvider } from \"../adapters/notifier/provider.ts\";\n\n/** Build the provider under test (sync or async factories both work). */\nexport type NotifierFactory = () => NotifierProvider | Promise<NotifierProvider>;\n\n/** Run the notifier contract against a factory. */\nexport function notifierContractSuite(label: string, make: NotifierFactory): void {\n  describe(`notifier contract: ${label}`, () => {\n    it(\"exposes notifier metadata with a config schema\", async () => {\n      const provider = await make();\n      expect(provider.metadata.category).toBe(\"notifier\");\n      expect(provider.metadata.kind.length).toBeGreaterThan(0);\n      expect(typeof provider.metadata.schema.parse).toBe(\"function\");\n    });\n\n    it(\"exposes the create descriptor\", async () => {\n      const provider = await make();\n      expect(typeof provider.create).toBe(\"function\");\n    });\n\n    it(\"validates channel config through a real schema\", async () => {\n      const provider = await make();\n      const result = provider.metadata.schema.safeParse({});\n      expect(typeof result.success).toBe(\"boolean\");\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,sBAAsB,OAAe,MAA6B;CAChF,SAAS,sBAAsB,eAAe;EAC5C,GAAG,kDAAkD,YAAY;GAC/D,MAAM,WAAW,MAAM,KAAK;GAC5B,OAAO,SAAS,SAAS,QAAQ,CAAC,CAAC,KAAK,UAAU;GAClD,OAAO,SAAS,SAAS,KAAK,MAAM,CAAC,CAAC,gBAAgB,CAAC;GACvD,OAAO,OAAO,SAAS,SAAS,OAAO,KAAK,CAAC,CAAC,KAAK,UAAU;EAC/D,CAAC;EAED,GAAG,iCAAiC,YAAY;GAC9C,MAAM,WAAW,MAAM,KAAK;GAC5B,OAAO,OAAO,SAAS,MAAM,CAAC,CAAC,KAAK,UAAU;EAChD,CAAC;EAED,GAAG,kDAAkD,YAAY;GAE/D,MAAM,UAAS,MADQ,KAAK,EAAA,CACJ,SAAS,OAAO,UAAU,CAAC,CAAC;GACpD,OAAO,OAAO,OAAO,OAAO,CAAC,CAAC,KAAK,SAAS;EAC9C,CAAC;CACH,CAAC;AACH"}

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

@@ -0,0 +1,11 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { CaptureQueue } from "../adapter/capture-queue.mjs";
+//#region src/test-helpers/queue-contract.d.ts
+/** Build the adapter under test (sync or async factories both work). */
+type QueueFactory = () => CaptureQueue | Promise<CaptureQueue>;
+/** Run the queue contract against a factory. */
+declare function queueContractSuite(label: string, make: QueueFactory): void;
+//#endregion
+export { QueueFactory, queueContractSuite };
+//# sourceMappingURL=queue-contract.d.mts.map

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

@@ -0,0 +1,64 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { describe, expect, it } from "vitest";
+//#region src/test-helpers/queue-contract.ts
+/**
+* Published queue contract suite for first- and third-party adapters.
+*
+* A package proves conformance in one line from its own vitest file:
+*
+* ```ts
+* import { queueContractSuite } from "@storyshelf/core/test-helpers";
+* queueContractSuite("sqs", () => createSqsCaptureQueue({ queueUrl, client: fake }));
+* ```
+*
+* Behavioral cases (enqueue/status/active/recent) need a fake transport that
+* answers realistically; structural cases (poll extension rule) run against
+* any factory.
+*/
+/** Run the queue contract against a factory. */
+function queueContractSuite(label, make) {
+	describe(`queue contract: ${label}`, () => {
+		it("exposes capture-queue metadata", async () => {
+			const queue = await make();
+			expect(queue.metadata.category).toBe("capture-queue");
+			expect(queue.metadata.kind.length).toBeGreaterThan(0);
+		});
+		it("keeps the poll extension all-or-nothing", async () => {
+			const record = await make();
+			const present = [
+				"poll",
+				"ack",
+				"nack"
+			].filter((method) => record[method] !== void 0);
+			expect([0, 3]).toContain(present.length);
+			for (const method of present) expect(typeof record[method]).toBe("function");
+		});
+		it("tracks an enqueued build through status/active/recent", async () => {
+			const queue = await make();
+			await queue.enqueue({ buildId: "b-contract-1" });
+			const entry = await queue.status("b-contract-1");
+			expect(entry?.buildId).toBe("b-contract-1");
+			expect(["queued", "running"]).toContain(entry?.status);
+			expect((await queue.active()).map((job) => job.buildId)).toContain("b-contract-1");
+			expect((await queue.recent(10)).map((job) => job.buildId)).toContain("b-contract-1");
+			expect(await queue.status("b-missing")).toBeNull();
+		});
+		it("keeps lifecycle idempotent when present", async () => {
+			const queue = await make();
+			if (queue.lifecycle === void 0) {
+				expect(queue.lifecycle).toBeUndefined();
+				return;
+			}
+			await queue.lifecycle.setup({});
+			await queue.lifecycle.setup({});
+			await queue.lifecycle.teardown();
+			await expect(queue.lifecycle.teardown()).resolves.toBeUndefined();
+		});
+	});
+}
+//#endregion
+export { queueContractSuite };
+
+//# sourceMappingURL=queue-contract.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue-contract.mjs","names":[],"sources":["../../src/test-helpers/queue-contract.ts"],"sourcesContent":["/**\n * Published queue contract suite for first- and third-party adapters.\n *\n * A package proves conformance in one line from its own vitest file:\n *\n * ```ts\n * import { queueContractSuite } from \"@storyshelf/core/test-helpers\";\n * queueContractSuite(\"sqs\", () => createSqsCaptureQueue({ queueUrl, client: fake }));\n * ```\n *\n * Behavioral cases (enqueue/status/active/recent) need a fake transport that\n * answers realistically; structural cases (poll extension rule) run against\n * any factory.\n */\nimport { describe, expect, it } from \"vitest\";\nimport type { CaptureQueue } from \"../adapters/capture-queue.ts\";\n\n/** Build the adapter under test (sync or async factories both work). */\nexport type QueueFactory = () => CaptureQueue | Promise<CaptureQueue>;\n\n/** Run the queue contract against a factory. */\nexport function queueContractSuite(label: string, make: QueueFactory): void {\n  describe(`queue contract: ${label}`, () => {\n    it(\"exposes capture-queue metadata\", async () => {\n      const queue = await make();\n      expect(queue.metadata.category).toBe(\"capture-queue\");\n      expect(queue.metadata.kind.length).toBeGreaterThan(0);\n    });\n\n    it(\"keeps the poll extension all-or-nothing\", async () => {\n      const queue = await make();\n      const record = queue as unknown as Record<string, unknown>;\n      const present = [\"poll\", \"ack\", \"nack\"].filter((method) => record[method] !== undefined);\n      expect([0, 3]).toContain(present.length);\n      for (const method of present) {\n        expect(typeof record[method]).toBe(\"function\");\n      }\n    });\n\n    it(\"tracks an enqueued build through status/active/recent\", async () => {\n      const queue = await make();\n      await queue.enqueue({ buildId: \"b-contract-1\" });\n      const entry = await queue.status(\"b-contract-1\");\n      expect(entry?.buildId).toBe(\"b-contract-1\");\n      // Remote transports report \"queued\" until a worker polls; in-process\n      // queues may already report \"running\".\n      expect([\"queued\", \"running\"]).toContain(entry?.status);\n      expect((await queue.active()).map((job) => job.buildId)).toContain(\"b-contract-1\");\n      expect((await queue.recent(10)).map((job) => job.buildId)).toContain(\"b-contract-1\");\n      expect(await queue.status(\"b-missing\")).toBeNull();\n    });\n\n    it(\"keeps lifecycle idempotent when present\", async () => {\n      const queue = await make();\n      if (queue.lifecycle === undefined) {\n        expect(queue.lifecycle).toBeUndefined();\n        return;\n      }\n      await queue.lifecycle.setup({} as never);\n      await queue.lifecycle.setup({} as never);\n      await queue.lifecycle.teardown();\n      await expect(queue.lifecycle.teardown()).resolves.toBeUndefined();\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,mBAAmB,OAAe,MAA0B;CAC1E,SAAS,mBAAmB,eAAe;EACzC,GAAG,kCAAkC,YAAY;GAC/C,MAAM,QAAQ,MAAM,KAAK;GACzB,OAAO,MAAM,SAAS,QAAQ,CAAC,CAAC,KAAK,eAAe;GACpD,OAAO,MAAM,SAAS,KAAK,MAAM,CAAC,CAAC,gBAAgB,CAAC;EACtD,CAAC;EAED,GAAG,2CAA2C,YAAY;GAExD,MAAM,SAAS,MADK,KAAK;GAEzB,MAAM,UAAU;IAAC;IAAQ;IAAO;GAAM,CAAC,CAAC,QAAQ,WAAW,OAAO,YAAY,KAAA,CAAS;GACvF,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,QAAQ,MAAM;GACvC,KAAK,MAAM,UAAU,SACnB,OAAO,OAAO,OAAO,OAAO,CAAC,CAAC,KAAK,UAAU;EAEjD,CAAC;EAED,GAAG,yDAAyD,YAAY;GACtE,MAAM,QAAQ,MAAM,KAAK;GACzB,MAAM,MAAM,QAAQ,EAAE,SAAS,eAAe,CAAC;GAC/C,MAAM,QAAQ,MAAM,MAAM,OAAO,cAAc;GAC/C,OAAO,OAAO,OAAO,CAAC,CAAC,KAAK,cAAc;GAG1C,OAAO,CAAC,UAAU,SAAS,CAAC,CAAC,CAAC,UAAU,OAAO,MAAM;GACrD,QAAQ,MAAM,MAAM,OAAO,EAAA,CAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,UAAU,cAAc;GACjF,QAAQ,MAAM,MAAM,OAAO,EAAE,EAAA,CAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,UAAU,cAAc;GACnF,OAAO,MAAM,MAAM,OAAO,WAAW,CAAC,CAAC,CAAC,SAAS;EACnD,CAAC;EAED,GAAG,2CAA2C,YAAY;GACxD,MAAM,QAAQ,MAAM,KAAK;GACzB,IAAI,MAAM,cAAc,KAAA,GAAW;IACjC,OAAO,MAAM,SAAS,CAAC,CAAC,cAAc;IACtC;GACF;GACA,MAAM,MAAM,UAAU,MAAM,CAAC,CAAU;GACvC,MAAM,MAAM,UAAU,MAAM,CAAC,CAAU;GACvC,MAAM,MAAM,UAAU,SAAS;GAC/B,MAAM,OAAO,MAAM,UAAU,SAAS,CAAC,CAAC,CAAC,SAAS,cAAc;EAClE,CAAC;CACH,CAAC;AACH"}

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

@@ -0,0 +1,11 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { CaptureRunner } from "../adapter/capture-runner.mjs";
+//#region src/test-helpers/runner-contract.d.ts
+/** Build the adapter under test (sync or async factories both work). */
+type RunnerFactory = () => CaptureRunner | Promise<CaptureRunner>;
+/** Run the runner contract against a factory. */
+declare function runnerContractSuite(label: string, make: RunnerFactory): void;
+//#endregion
+export { RunnerFactory, runnerContractSuite };
+//# sourceMappingURL=runner-contract.d.mts.map

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

@@ -0,0 +1,32 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { describe, expect, it } from "vitest";
+//#region src/test-helpers/runner-contract.ts
+/**
+* Published runner contract suite for first- and third-party adapters.
+*
+* Structural conformance (identity, render/cancel presence). Behavioral
+* rendering stays per-package behind real or mocked browsers — the
+* orchestrator owns timeouts, byte guards, and failure caps, so runners
+* only promise to return PNG buffers and honor `cancel`.
+*/
+/** Run the runner contract against a factory. */
+function runnerContractSuite(label, make) {
+	describe(`runner contract: ${label}`, () => {
+		it("exposes capture-runner metadata", async () => {
+			const runner = await make();
+			expect(runner.metadata.category).toBe("capture-runner");
+			expect(runner.metadata.kind.length).toBeGreaterThan(0);
+		});
+		it("exposes render and cancel", async () => {
+			const runner = await make();
+			expect(typeof runner.render).toBe("function");
+			expect(typeof runner.cancel).toBe("function");
+		});
+	});
+}
+//#endregion
+export { runnerContractSuite };
+
+//# sourceMappingURL=runner-contract.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner-contract.mjs","names":[],"sources":["../../src/test-helpers/runner-contract.ts"],"sourcesContent":["/**\n * Published runner contract suite for first- and third-party adapters.\n *\n * Structural conformance (identity, render/cancel presence). Behavioral\n * rendering stays per-package behind real or mocked browsers — the\n * orchestrator owns timeouts, byte guards, and failure caps, so runners\n * only promise to return PNG buffers and honor `cancel`.\n */\nimport { describe, expect, it } from \"vitest\";\nimport type { CaptureRunner } from \"../adapters/capture-runner.ts\";\n\n/** Build the adapter under test (sync or async factories both work). */\nexport type RunnerFactory = () => CaptureRunner | Promise<CaptureRunner>;\n\n/** Run the runner contract against a factory. */\nexport function runnerContractSuite(label: string, make: RunnerFactory): void {\n  describe(`runner contract: ${label}`, () => {\n    it(\"exposes capture-runner metadata\", async () => {\n      const runner = await make();\n      expect(runner.metadata.category).toBe(\"capture-runner\");\n      expect(runner.metadata.kind.length).toBeGreaterThan(0);\n    });\n\n    it(\"exposes render and cancel\", async () => {\n      const runner = await make();\n      expect(typeof runner.render).toBe(\"function\");\n      expect(typeof runner.cancel).toBe(\"function\");\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,oBAAoB,OAAe,MAA2B;CAC5E,SAAS,oBAAoB,eAAe;EAC1C,GAAG,mCAAmC,YAAY;GAChD,MAAM,SAAS,MAAM,KAAK;GAC1B,OAAO,OAAO,SAAS,QAAQ,CAAC,CAAC,KAAK,gBAAgB;GACtD,OAAO,OAAO,SAAS,KAAK,MAAM,CAAC,CAAC,gBAAgB,CAAC;EACvD,CAAC;EAED,GAAG,6BAA6B,YAAY;GAC1C,MAAM,SAAS,MAAM,KAAK;GAC1B,OAAO,OAAO,OAAO,MAAM,CAAC,CAAC,KAAK,UAAU;GAC5C,OAAO,OAAO,OAAO,MAAM,CAAC,CAAC,KAAK,UAAU;EAC9C,CAAC;CACH,CAAC;AACH"}

package/dist/test-helpers/sql-chunks.mjs

@@ -0,0 +1,138 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { getTableColumns } from "drizzle-orm";
+//#region src/test-helpers/sql-chunks.ts
+/** Flatten the string parts of a drizzle SQL chunk into a single string. */
+function textOf(chunk) {
+	if (chunk === void 0 || !Array.isArray(chunk.value) || !chunk.value.every((part) => typeof part === "string")) return;
+	return chunk.value.join("");
+}
+/** Test whether an in-memory row satisfies a drizzle where-clause. */
+function whereMatches(where, row, table) {
+	let current = where.queryChunks;
+	let wrapped = current[1]?.queryChunks;
+	while (wrapped !== void 0 && textOf(current[0]) === "(" && textOf(current.at(-1)) === ")") {
+		current = wrapped;
+		wrapped = current[1]?.queryChunks;
+	}
+	if (current.length === 1 && current[0]?.queryChunks !== void 0) current = current[0].queryChunks;
+	if (current.some((chunk) => textOf(chunk)?.trim() === "and")) return current.filter((chunk) => textOf(chunk) === void 0).every((chunk) => matchChunk(chunk.queryChunks ?? [], row, table));
+	return matchChunk(current, row, table);
+}
+function matchChunk(chunks, row, table) {
+	const text = chunks.map((c) => textOf(c) ?? "").join("");
+	if (/is not null/iu.test(text)) return isNullMatches(chunks, row, table, true);
+	if (/is null/iu.test(text)) return isNullMatches(chunks, row, table, false);
+	if (text.includes(" in ")) return inArrayMatches(chunks, row, table);
+	if (text.includes(" < ")) return ltMatches(chunks, row, table);
+	return eqMatches(chunks, row, table);
+}
+/** Match `is null` / `is not null` predicates (no value argument). */
+function isNullMatches(chunks, row, table, negated) {
+	let columnName;
+	for (const chunk of chunks) if (typeof chunk.name === "string" && chunk.table !== void 0) columnName = chunk.name;
+	if (columnName === void 0) return false;
+	const cell = row[columnKey(table, columnName)];
+	const missing = cell === null || cell === void 0;
+	return negated ? !missing : missing;
+}
+function eqMatches(chunks, row, table) {
+	let columnName;
+	let argument;
+	for (const chunk of chunks) if (typeof chunk.name === "string" && chunk.table !== void 0) columnName = chunk.name;
+	else if ("brand" in chunk) argument = chunk.value;
+	if (columnName === void 0) return false;
+	return row[columnKey(table, columnName)] === argument;
+}
+function inArrayMatches(chunks, row, table) {
+	let columnName;
+	const values = [];
+	const collect = (nodes) => {
+		for (const raw of nodes) {
+			const chunk = raw;
+			if (Array.isArray(chunk) || chunk && typeof chunk === "object" && Object.keys(chunk).every((k) => /^\d+$/u.test(k))) {
+				collect(Object.values(chunk));
+				continue;
+			}
+			if (typeof chunk.name === "string" && chunk.table !== void 0) columnName = chunk.name;
+			if ("brand" in chunk && chunk["value"] !== void 0) {
+				const val = chunk["value"];
+				if (Array.isArray(val)) values.push(...val);
+				else values.push(val);
+			}
+			if (chunk.queryChunks) collect(chunk.queryChunks);
+			const val = chunk["value"];
+			if (Array.isArray(val)) for (const item of val) {
+				if (item && typeof item === "object" && "queryChunks" in item) collect(item["queryChunks"] ?? []);
+				if (item && typeof item === "object" && "value" in item) {
+					const iv = item["value"];
+					if (iv !== void 0) values.push(iv);
+				}
+				if (typeof item === "string") values.push(item);
+			}
+		}
+	};
+	collect(chunks);
+	if (columnName === void 0) return false;
+	const key = columnKey(table, columnName);
+	return values.includes(row[key]);
+}
+function ltMatches(chunks, row, table) {
+	let columnName;
+	let argument;
+	for (const chunk of chunks) if (typeof chunk.name === "string" && chunk.table !== void 0) columnName = chunk.name;
+	else if ("brand" in chunk) argument = chunk.value;
+	if (columnName === void 0) return false;
+	const cell = row[columnKey(table, columnName)];
+	if (typeof cell === "string" && typeof argument === "string") return cell < argument;
+	if (typeof cell === "number" && typeof argument === "number") return cell < argument;
+	return String(cell) < String(argument);
+}
+function compareCells(left, right) {
+	if (typeof left === "string" && typeof right === "string") {
+		if (left === right) return 0;
+		return left < right ? -1 : 1;
+	}
+	if (typeof left === "number" && typeof right === "number") return left - right;
+	const leftText = String(left);
+	const rightText = String(right);
+	if (leftText === rightText) return 0;
+	return leftText < rightText ? -1 : 1;
+}
+/** Collect every raw string part of a drizzle SQL chunk tree. */
+function sqlText(nodes) {
+	return nodes.map((node) => {
+		return (textOf(node) ?? "") + (node.queryChunks ? sqlText(node.queryChunks) : "");
+	}).join("");
+}
+/** Find the ordered column reference in a drizzle order-by expression. */
+function findOrderColumn(nodes) {
+	for (const node of nodes) {
+		if (typeof node.name === "string" && node.table !== void 0) return node.name;
+		if (node.queryChunks) {
+			const nested = findOrderColumn(node.queryChunks);
+			if (nested !== void 0) return nested;
+		}
+	}
+}
+/** Sort rows per a drizzle order-by expression (single-column asc/desc). */
+function orderRows(rows, orderBy, table) {
+	const chunks = orderBy.queryChunks;
+	const columnName = findOrderColumn(chunks);
+	if (columnName === void 0) return rows;
+	const key = columnKey(table, columnName);
+	const descending = /desc/iu.test(sqlText(chunks));
+	return rows.toSorted((left, right) => {
+		const order = compareCells(left[key], right[key]);
+		return descending ? -order : order;
+	});
+}
+function columnKey(table, dbName) {
+	for (const [property, column] of Object.entries(getTableColumns(table))) if (column.name === dbName) return property;
+	return dbName;
+}
+//#endregion
+export { orderRows, whereMatches };
+
+//# sourceMappingURL=sql-chunks.mjs.map

package/dist/test-helpers/sql-chunks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-chunks.mjs","names":[],"sources":["../../src/test-helpers/sql-chunks.ts"],"sourcesContent":["import { getTableColumns, type SQL, type Table } from \"drizzle-orm\";\n\n/* eslint-disable require-await, no-unnecessary-type-assertion, no-unnecessary-type-parameters, non-nullable-type-assertion-style */\n\n/** A drizzle SQL chunk inspected for matching and ordering. */\nexport interface SqlChunk {\n  value?: unknown;\n  name?: string;\n  table?: unknown;\n  brand?: unknown;\n  queryChunks?: SqlChunk[];\n}\n\n/** Flatten the string parts of a drizzle SQL chunk into a single string. */\nfunction textOf(chunk: SqlChunk | undefined): string | undefined {\n  if (\n    chunk === undefined ||\n    !Array.isArray(chunk.value) ||\n    !chunk.value.every((part) => typeof part === \"string\")\n  ) {\n    return undefined;\n  }\n  return chunk.value.join(\"\");\n}\n\n/** Test whether an in-memory row satisfies a drizzle where-clause. */\nexport function whereMatches(where: SQL, row: Record<string, unknown>, table: Table): boolean {\n  let current = where.queryChunks as unknown as SqlChunk[];\n  let wrapped = current[1]?.queryChunks;\n  while (wrapped !== undefined && textOf(current[0]) === \"(\" && textOf(current.at(-1)) === \")\") {\n    current = wrapped;\n    wrapped = current[1]?.queryChunks;\n  }\n  // Drizzle's `and(singleCondition)` emits the condition directly, without\n  // the enclosing parens produced for two or more clauses, so unwrap it.\n  if (current.length === 1 && current[0]?.queryChunks !== undefined) {\n    current = current[0].queryChunks as unknown as SqlChunk[];\n  }\n  if (current.some((chunk) => textOf(chunk)?.trim() === \"and\")) {\n    return current\n      .filter((chunk) => textOf(chunk) === undefined)\n      .every((chunk) => matchChunk(chunk.queryChunks ?? [], row, table));\n  }\n  return matchChunk(current, row, table);\n}\n\nfunction matchChunk(chunks: SqlChunk[], row: Record<string, unknown>, table: Table): boolean {\n  const text = chunks.map((c) => textOf(c) ?? \"\").join(\"\");\n  if (/is not null/iu.test(text)) {\n    return isNullMatches(chunks, row, table, true);\n  }\n  if (/is null/iu.test(text)) {\n    return isNullMatches(chunks, row, table, false);\n  }\n  if (text.includes(\" in \")) {\n    return inArrayMatches(chunks, row, table);\n  }\n  if (text.includes(\" < \")) {\n    return ltMatches(chunks, row, table);\n  }\n  return eqMatches(chunks, row, table);\n}\n\n/** Match `is null` / `is not null` predicates (no value argument). */\nfunction isNullMatches(\n  chunks: SqlChunk[],\n  row: Record<string, unknown>,\n  table: Table,\n  negated: boolean,\n): boolean {\n  let columnName: string | undefined;\n  for (const chunk of chunks) {\n    if (typeof chunk.name === \"string\" && chunk.table !== undefined) {\n      columnName = chunk.name;\n    }\n  }\n  if (columnName === undefined) {\n    return false;\n  }\n  const cell = row[columnKey(table, columnName)];\n  const missing = cell === null || cell === undefined;\n  return negated ? !missing : missing;\n}\n\nfunction eqMatches(chunks: SqlChunk[], row: Record<string, unknown>, table: Table): boolean {\n  let columnName: string | undefined;\n  let argument: unknown;\n  for (const chunk of chunks) {\n    if (typeof chunk.name === \"string\" && chunk.table !== undefined) {\n      columnName = chunk.name;\n    } else if (\"brand\" in chunk) {\n      argument = chunk.value;\n    }\n  }\n  if (columnName === undefined) {\n    return false;\n  }\n  return row[columnKey(table, columnName)] === argument;\n}\n\n/* eslint-disable complexity, max-depth -- handles drizzle's varied chunk shapes */\nfunction inArrayMatches(chunks: SqlChunk[], row: Record<string, unknown>, table: Table): boolean {\n  let columnName: string | undefined;\n  const values: unknown[] = [];\n  const collect = (nodes: unknown[]): void => {\n    for (const raw of nodes as SqlChunk[]) {\n      const chunk = raw as SqlChunk & Record<string, unknown>;\n      // Handle array-like chunk (inArray values stored as array of chunks)\n      if (\n        Array.isArray(chunk) ||\n        (chunk && typeof chunk === \"object\" && Object.keys(chunk).every((k) => /^\\d+$/u.test(k)))\n      ) {\n        collect(Object.values(chunk as unknown as Record<string, unknown>) as unknown[]);\n        continue;\n      }\n      if (typeof chunk.name === \"string\" && chunk.table !== undefined) {\n        columnName = chunk.name as string;\n      }\n      if (\"brand\" in chunk && (chunk as Record<string, unknown>)[\"value\"] !== undefined) {\n        const val = (chunk as Record<string, unknown>)[\"value\"];\n        if (Array.isArray(val)) {\n          values.push(...(val as unknown[]));\n        } else {\n          values.push(val);\n        }\n      }\n      if (chunk.queryChunks) {\n        collect(chunk.queryChunks as unknown[]);\n      }\n      const val = (chunk as Record<string, unknown>)[\"value\"];\n      if (Array.isArray(val)) {\n        for (const item of val as unknown[]) {\n          if (\n            item &&\n            typeof item === \"object\" &&\n            \"queryChunks\" in (item as Record<string, unknown>)\n          ) {\n            collect(((item as Record<string, unknown>)[\"queryChunks\"] as unknown[]) ?? []);\n          }\n          if (item && typeof item === \"object\" && \"value\" in (item as Record<string, unknown>)) {\n            const iv = (item as Record<string, unknown>)[\"value\"];\n            if (iv !== undefined) {\n              values.push(iv);\n            }\n          }\n          if (typeof item === \"string\") {\n            values.push(item);\n          }\n        }\n      }\n    }\n  };\n  collect(chunks as unknown[]);\n  if (columnName === undefined) {\n    return false;\n  }\n  const key = columnKey(table, columnName);\n  return values.includes(row[key]);\n}\n/* eslint-enable complexity, max-depth */\n\nfunction ltMatches(chunks: SqlChunk[], row: Record<string, unknown>, table: Table): boolean {\n  let columnName: string | undefined;\n  let argument: unknown;\n  for (const chunk of chunks) {\n    if (typeof chunk.name === \"string\" && chunk.table !== undefined) {\n      columnName = chunk.name;\n    } else if (\"brand\" in chunk) {\n      argument = chunk.value;\n    }\n  }\n  if (columnName === undefined) {\n    return false;\n  }\n  const key = columnKey(table, columnName);\n  const cell = row[key];\n  if (typeof cell === \"string\" && typeof argument === \"string\") {\n    return cell < argument;\n  }\n  if (typeof cell === \"number\" && typeof argument === \"number\") {\n    return cell < argument;\n  }\n  return String(cell) < String(argument);\n}\n\nfunction compareCells(left: unknown, right: unknown): number {\n  if (typeof left === \"string\" && typeof right === \"string\") {\n    if (left === right) {\n      return 0;\n    }\n    return left < right ? -1 : 1;\n  }\n  if (typeof left === \"number\" && typeof right === \"number\") {\n    return left - right;\n  }\n  const leftText = String(left);\n  const rightText = String(right);\n  if (leftText === rightText) {\n    return 0;\n  }\n  return leftText < rightText ? -1 : 1;\n}\n\n/** Collect every raw string part of a drizzle SQL chunk tree. */\nfunction sqlText(nodes: SqlChunk[]): string {\n  return nodes\n    .map((node) => {\n      const own = textOf(node) ?? \"\";\n      const nested = node.queryChunks ? sqlText(node.queryChunks as unknown as SqlChunk[]) : \"\";\n      return own + nested;\n    })\n    .join(\"\");\n}\n\n/** Find the ordered column reference in a drizzle order-by expression. */\nfunction findOrderColumn(nodes: SqlChunk[]): string | undefined {\n  for (const node of nodes) {\n    if (typeof node.name === \"string\" && node.table !== undefined) {\n      return node.name;\n    }\n    if (node.queryChunks) {\n      const nested = findOrderColumn(node.queryChunks as unknown as SqlChunk[]);\n      if (nested !== undefined) {\n        return nested;\n      }\n    }\n  }\n  return undefined;\n}\n\n/** Sort rows per a drizzle order-by expression (single-column asc/desc). */\nexport function orderRows(rows: unknown[], orderBy: SQL, table: Table): unknown[] {\n  const chunks = orderBy.queryChunks as unknown as SqlChunk[];\n  const columnName = findOrderColumn(chunks);\n  if (columnName === undefined) {\n    return rows;\n  }\n  const key = columnKey(table, columnName);\n  const descending = /desc/iu.test(sqlText(chunks));\n  return rows.toSorted((left, right) => {\n    const order = compareCells(\n      (left as Record<string, unknown>)[key],\n      (right as Record<string, unknown>)[key],\n    );\n    return descending ? -order : order;\n  });\n}\n\nfunction columnKey(table: Table, dbName: string): string {\n  for (const [property, column] of Object.entries(getTableColumns(table))) {\n    if (column.name === dbName) {\n      return property;\n    }\n  }\n  return dbName;\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/storage-contract.d.mts

@@ -0,0 +1,11 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { StorageAdapter } from "../adapter/storage.mjs";
+//#region src/test-helpers/storage-contract.d.ts
+/** Build the adapter under test (sync or async factories both work). */
+type StorageFactory = () => StorageAdapter | Promise<StorageAdapter>;
+/** Run the full storage contract against a factory. */
+declare function storageContractSuite(label: string, make: StorageFactory): void;
+//#endregion
+export { StorageFactory, storageContractSuite };
+//# sourceMappingURL=storage-contract.d.mts.map

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

@@ -0,0 +1,87 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { describe, expect, it } from "vitest";
+import { Readable } from "node:stream";
+//#region src/test-helpers/storage-contract.ts
+/**
+* Published storage contract suite for first- and third-party adapters.
+*
+* A package proves conformance in one line from its own vitest file:
+*
+* ```ts
+* import { storageContractSuite } from "@storyshelf/core/test-helpers";
+* storageContractSuite("local", () => createLocalStorage(mkdtempSync(...)));
+* ```
+*
+* Every case uses an isolated `__contract__/` prefix so suites can share one
+* adapter instance. Fakes the transport (temp dirs, fake clients) — never
+* the adapter itself.
+*/
+/** Collect a stream into a single buffer. */
+async function collect(stream) {
+	const chunks = [];
+	for await (const chunk of stream) chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : Buffer.from(chunk));
+	return Buffer.concat(chunks);
+}
+/** Run the full storage contract against a factory. */
+function storageContractSuite(label, make) {
+	const prefix = `__contract__/${label}`;
+	describe(`storage contract: ${label}`, () => {
+		it("exposes storage metadata", async () => {
+			const adapter = await make();
+			expect(adapter.metadata.category).toBe("storage");
+			expect(adapter.metadata.kind.length).toBeGreaterThan(0);
+		});
+		it("keeps lifecycle idempotent when present", async () => {
+			const adapter = await make();
+			if (adapter.lifecycle === void 0) {
+				expect(adapter.lifecycle).toBeUndefined();
+				return;
+			}
+			await adapter.lifecycle.setup({});
+			await adapter.lifecycle.setup({});
+			await expect(adapter.lifecycle.health()).resolves.toMatchObject({ ok: true });
+			await adapter.lifecycle.teardown();
+			await expect(adapter.lifecycle.teardown()).resolves.toBeUndefined();
+		});
+		it("round-trips write/read/exists/delete", async () => {
+			const adapter = await make();
+			const path = `${prefix}/roundtrip.txt`;
+			expect(await adapter.exists(path)).toBe(false);
+			await adapter.write(path, Buffer.from("hello"));
+			expect(await adapter.exists(path)).toBe(true);
+			expect((await adapter.read(path)).toString()).toBe("hello");
+			await adapter.delete(path);
+			expect(await adapter.exists(path)).toBe(false);
+		});
+		it("lists recursively and empty for missing prefixes", async () => {
+			const adapter = await make();
+			await adapter.write(`${prefix}/list/a.txt`, Buffer.from("a"));
+			await adapter.write(`${prefix}/list/b.txt`, Buffer.from("b"));
+			expect((await adapter.list(`${prefix}/list`)).toSorted()).toEqual([`${prefix}/list/a.txt`, `${prefix}/list/b.txt`]);
+			expect(await adapter.list(`${prefix}/missing`)).toEqual([]);
+		});
+		it("rejects missing reads", async () => {
+			const adapter = await make();
+			await expect(adapter.read(`${prefix}/nope.bin`)).rejects.toThrow();
+			await expect(adapter.readStream(`${prefix}/nope.bin`)).rejects.toThrow();
+		});
+		it("streams bytes identically and cleans partial writes", async () => {
+			const adapter = await make();
+			const payload = Buffer.from("streamed-".repeat(500));
+			const path = `${prefix}/stream/blob.bin`;
+			await adapter.writeStream(path, Readable.from([payload]));
+			expect(await collect(await adapter.readStream(path))).toEqual(payload);
+			const failing = new Readable({ read() {
+				this.destroy(/* @__PURE__ */ new Error("boom"));
+			} });
+			await expect(adapter.writeStream(`${prefix}/stream/partial.bin`, failing)).rejects.toThrow("boom");
+			expect(await adapter.exists(`${prefix}/stream/partial.bin`)).toBe(false);
+		});
+	});
+}
+//#endregion
+export { storageContractSuite };
+
+//# sourceMappingURL=storage-contract.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-contract.mjs","names":[],"sources":["../../src/test-helpers/storage-contract.ts"],"sourcesContent":["/**\n * Published storage contract suite for first- and third-party adapters.\n *\n * A package proves conformance in one line from its own vitest file:\n *\n * ```ts\n * import { storageContractSuite } from \"@storyshelf/core/test-helpers\";\n * storageContractSuite(\"local\", () => createLocalStorage(mkdtempSync(...)));\n * ```\n *\n * Every case uses an isolated `__contract__/` prefix so suites can share one\n * adapter instance. Fakes the transport (temp dirs, fake clients) — never\n * the adapter itself.\n */\nimport { Readable } from \"node:stream\";\nimport { describe, expect, it } from \"vitest\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\n\n/** Build the adapter under test (sync or async factories both work). */\nexport type StorageFactory = () => StorageAdapter | Promise<StorageAdapter>;\n\n/** Collect a stream into a single buffer. */\nasync function collect(stream: Readable): Promise<Buffer> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of stream) {\n    chunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : Buffer.from(chunk as Uint8Array));\n  }\n  return Buffer.concat(chunks);\n}\n\n/** Run the full storage contract against a factory. */\nexport function storageContractSuite(label: string, make: StorageFactory): void {\n  const prefix = `__contract__/${label}`;\n  describe(`storage contract: ${label}`, () => {\n    it(\"exposes storage metadata\", async () => {\n      const adapter = await make();\n      expect(adapter.metadata.category).toBe(\"storage\");\n      expect(adapter.metadata.kind.length).toBeGreaterThan(0);\n    });\n\n    it(\"keeps lifecycle idempotent when present\", async () => {\n      const adapter = await make();\n      if (adapter.lifecycle === undefined) {\n        expect(adapter.lifecycle).toBeUndefined();\n        return;\n      }\n      await adapter.lifecycle.setup({} as never);\n      await adapter.lifecycle.setup({} as never);\n      await expect(adapter.lifecycle.health()).resolves.toMatchObject({ ok: true });\n      await adapter.lifecycle.teardown();\n      await expect(adapter.lifecycle.teardown()).resolves.toBeUndefined();\n    });\n\n    it(\"round-trips write/read/exists/delete\", async () => {\n      const adapter = await make();\n      const path = `${prefix}/roundtrip.txt`;\n      expect(await adapter.exists(path)).toBe(false);\n      await adapter.write(path, Buffer.from(\"hello\"));\n      expect(await adapter.exists(path)).toBe(true);\n      expect((await adapter.read(path)).toString()).toBe(\"hello\");\n      await adapter.delete(path);\n      expect(await adapter.exists(path)).toBe(false);\n    });\n\n    it(\"lists recursively and empty for missing prefixes\", async () => {\n      const adapter = await make();\n      await adapter.write(`${prefix}/list/a.txt`, Buffer.from(\"a\"));\n      await adapter.write(`${prefix}/list/b.txt`, Buffer.from(\"b\"));\n      expect((await adapter.list(`${prefix}/list`)).toSorted()).toEqual([\n        `${prefix}/list/a.txt`,\n        `${prefix}/list/b.txt`,\n      ]);\n      expect(await adapter.list(`${prefix}/missing`)).toEqual([]);\n    });\n\n    it(\"rejects missing reads\", async () => {\n      const adapter = await make();\n      await expect(adapter.read(`${prefix}/nope.bin`)).rejects.toThrow();\n      await expect(adapter.readStream(`${prefix}/nope.bin`)).rejects.toThrow();\n    });\n\n    it(\"streams bytes identically and cleans partial writes\", async () => {\n      const adapter = await make();\n      const payload = Buffer.from(\"streamed-\".repeat(500));\n      const path = `${prefix}/stream/blob.bin`;\n      await adapter.writeStream(path, Readable.from([payload]));\n      expect(await collect(await adapter.readStream(path))).toEqual(payload);\n      const failing = new Readable({\n        read(): void {\n          this.destroy(new Error(\"boom\"));\n        },\n      });\n      await expect(adapter.writeStream(`${prefix}/stream/partial.bin`, failing)).rejects.toThrow(\n        \"boom\",\n      );\n      expect(await adapter.exists(`${prefix}/stream/partial.bin`)).toBe(false);\n    });\n  });\n}\n"],"mappings":"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"}

package/dist/test-helpers.d.mts

@@ -0,0 +1,13 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { createTestBuild, createTestProject } from "./test-helpers/create-project.mjs";
+import { REQUIRED_TABLES, databaseContractSuite } from "./test-helpers/database-contract.mjs";
+import { gitContractSuite } from "./test-helpers/git-contract.mjs";
+import { makeDatabase } from "./test-helpers/fake-database.mjs";
+import { FakeStorage, makeStorage } from "./test-helpers/fake-storage.mjs";
+import { stubTables } from "./test-helpers/fake-adapters.mjs";
+import { notifierContractSuite } from "./test-helpers/notifier-contract.mjs";
+import { queueContractSuite } from "./test-helpers/queue-contract.mjs";
+import { runnerContractSuite } from "./test-helpers/runner-contract.mjs";
+import { storageContractSuite } from "./test-helpers/storage-contract.mjs";
+export { type FakeStorage, REQUIRED_TABLES, createTestBuild, createTestProject, databaseContractSuite, gitContractSuite, makeDatabase, makeStorage, notifierContractSuite, queueContractSuite, runnerContractSuite, storageContractSuite, stubTables };

package/dist/test-helpers.mjs

@@ -0,0 +1,14 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { createTestBuild, createTestProject } from "./test-helpers/create-project.mjs";
+import { REQUIRED_TABLES, databaseContractSuite } from "./test-helpers/database-contract.mjs";
+import { gitContractSuite } from "./test-helpers/git-contract.mjs";
+import { makeDatabase } from "./test-helpers/fake-database.mjs";
+import { makeStorage } from "./test-helpers/fake-storage.mjs";
+import { stubTables } from "./test-helpers/fake-adapters.mjs";
+import { notifierContractSuite } from "./test-helpers/notifier-contract.mjs";
+import { queueContractSuite } from "./test-helpers/queue-contract.mjs";
+import { runnerContractSuite } from "./test-helpers/runner-contract.mjs";
+import { storageContractSuite } from "./test-helpers/storage-contract.mjs";
+export { REQUIRED_TABLES, createTestBuild, createTestProject, databaseContractSuite, gitContractSuite, makeDatabase, makeStorage, notifierContractSuite, queueContractSuite, runnerContractSuite, storageContractSuite, stubTables };