@storyshelf/core 0.6.1 → 0.7.0

package/dist/schema/design.d.mts

@@ -0,0 +1,58 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/schema/design.d.ts
+/** A design link: a project-level file link (`importPath` null) or a component mapping override. */
+interface DesignLink {
+  id: string;
+  projectId: string;
+  /** Story file the URL is mapped to; null for a project-level design file link. */
+  importPath: string | null;
+  /** Display label of a project-level link. */
+  label: string | null;
+  url: string;
+  createdAt: string;
+  updatedAt: string;
+}
+/** The project-wide token of a design provider (an admin pastes it; encrypted at rest). */
+interface DesignCredential {
+  id: string;
+  projectId: string;
+  /** Provider `metadata.kind`, e.g. `figma`. */
+  provider: string;
+  tokenEncrypted: string;
+  /** Last API outcome: `unknown` | `ok` | `unauthorized` | `forbidden`. */
+  status: string;
+  checkedAt: string | null;
+  /** When the credential was set or replaced; drives the rotation clock. */
+  createdAt: string;
+  updatedAt: string;
+}
+/** Cached design file/node metadata, keyed by project, provider, viewer, file key and node id. */
+interface DesignNode {
+  id: string;
+  projectId: string;
+  /** Provider `metadata.kind`. */
+  provider: string;
+  /** Whose access fetched the entry: `""` for the project credential, else a user id. */
+  viewerId: string;
+  fileKey: string;
+  /** Provider node id; empty string for a whole-file link. */
+  nodeId: string;
+  name: string | null;
+  /** File version at fetch time. */
+  version: string | null;
+  /** File `lastModified` at fetch time. */
+  lastModified: string | null;
+  /** `ok` | `deleted` | `unauthorized` | `forbidden`. */
+  state: string;
+  /** Storage path of the cached PNG render (node links only); null when none was fetched. */
+  renderPath: string | null;
+  /** File `version` the cached render was taken at; a newer file version refetches. */
+  renderVersion: string | null;
+  fetchedAt: string;
+  createdAt: string;
+  updatedAt: string;
+}
+//#endregion
+export { DesignCredential, DesignLink, DesignNode };
+//# sourceMappingURL=design.d.mts.map

package/dist/schema/insight.d.mts

@@ -0,0 +1,54 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/schema/insight.d.ts
+/** Insight kinds: a build triage or a project-health digest. */
+type InsightKind = "triage" | "health";
+/** Lifecycle of an insight run. */
+type InsightStatus = "pending" | "running" | "done" | "failed";
+/** An insight row (result is an opaque, validated JSON string). */
+interface InsightRow {
+  id: string;
+  projectId: string;
+  /** Null for project-health rows. */
+  buildId: string | null;
+  kind: InsightKind;
+  /** Health window key (e.g. `30d`); null for triage rows. */
+  windowKey: string | null;
+  inputHash: string;
+  status: InsightStatus;
+  profile: string;
+  model: string;
+  promptVersion: string;
+  verdict: string | null;
+  summary: string | null;
+  result: string | null;
+  errorCode: string | null;
+  createdAt: string;
+  startedAt: string | null;
+  finishedAt: string | null;
+}
+/** One provider call's usage; survives build purge so budgets stay accurate. */
+interface AiUsageRow {
+  id: string;
+  insightId: string | null;
+  projectId: string;
+  profile: string;
+  task: string;
+  model: string;
+  inputTokens: number;
+  outputTokens: number;
+  estimated: boolean;
+  images: number;
+  status: "ok" | "failed";
+  createdAt: string;
+}
+/** A budget-threshold alert claim (`id` is `${day}:${threshold}`). */
+interface AiBudgetAlertRow {
+  id: string;
+  day: string;
+  threshold: number;
+  createdAt: string;
+}
+//#endregion
+export { AiBudgetAlertRow, AiUsageRow, InsightKind, InsightRow, InsightStatus };
+//# sourceMappingURL=insight.d.mts.map

package/dist/schema/notification.d.mts

@@ -15,6 +15,10 @@ interface NotificationChannelRow {
   /** JSON array of subscribed events, or null for all. */
   events: string | null;
   enabled: boolean;
+  /** Last delivery error (sanitized), null while the channel delivers cleanly. */
+  lastError: string | null;
+  /** ISO-8601 time of {@link lastError}. */
+  lastErrorAt: string | null;
   createdAt: string;
   updatedAt: string;
 }

package/dist/schema/project.d.mts

@@ -14,10 +14,31 @@ interface Project {
   storybookMeta: string | null | undefined;
   executePlay: boolean;
   playTimeoutMs: number;
+  /** Run axe accessibility checks during capture; on by default (annotations never block). */
   runA11y?: boolean;
+  /**
+   * Run the Storybook 10 `.test()` entries as interaction tests during capture (ADR 0004,
+   * decision 11); off by default because it changes what a build contains.
+   */
+  runTests?: boolean;
   browser?: string;
   viewports?: string | null;
+  /** JSON list of browsers to capture (null: legacy single `browser`). */
+  browsers?: string | null;
+  /** JSON list of mode names to capture (null: all declared modes). */
+  modesAllowlist?: string | null;
   automigrate?: boolean;
+  /** AI profile gate: null = AI off for this project; otherwise a profile name. */
+  aiProfile?: string | null;
+  /** Review is on for this project (ADR 0013, decision 1); the column defaults to true. */
+  reviewEnabled?: boolean;
+  /** Approvals a build needs when `testing` is off (ADR 0013, decision 3); default 1. */
+  reviewApprovals?: number;
+  /**
+   * Lifetime in seconds of the signed Storybook URLs of this project's renders (ADR 0007,
+   * decision 5); null derives it from the build's stories.
+   */
+  storybookUrlTtlSeconds?: number | null;
   createdAt: string;
   updatedAt: string;
 }

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

@@ -0,0 +1,21 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/schema/site-setting.d.ts
+/**
+ * Row type of `site_settings`: a small key-value table for facts the app learns while running and
+ * must share between instances (ADR 0007, decision 6: the public origin an admin's browser reported).
+ */
+/** One site-wide setting; `id` is the setting's key. */
+interface SiteSetting {
+  /** Setting key (`public_origin`). */
+  id: string;
+  /** Value, as text (JSON for structured settings). */
+  value: string;
+  /** User that last wrote it, when a person did. */
+  updatedBy: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+//#endregion
+export { SiteSetting };
+//# sourceMappingURL=site-setting.d.mts.map

package/dist/schema/snapshot.d.mts

@@ -11,6 +11,8 @@ interface Snapshot {
   storyName: string;
   storyTitle: string;
   storyImportPath: string | null;
+  /** Figma URL declared by the story at capture time; null when none. */
+  designUrl: string | null;
   viewportName: string;
   viewportWidth: number;
   viewportHeight: number;
@@ -23,12 +25,22 @@ interface Snapshot {
   reviewedBy: string | null;
   reviewedAt: string | null;
   infraHash: string | null;
+  /** JSON `EnvironmentChange` when the capture environment differed from the baseline and the snapshot was accepted as a migration. */
+  envChange: string | null;
   /** True when inherited unchanged from the baseline without rendering. */
   inherited: boolean;
   /** Baseline row the diff was computed against (null: no baseline, or legacy row). */
   baselineId: string | null;
   /** That baseline's `updatedAt` at diff time; compared on approval to detect drift. */
   baselineVersion: string | null;
+  /** Resolved mode definition (JSON) — display/capture only; identity is `viewportName`. */
+  mode?: string | null;
+  /** Engine the image was captured with. */
+  browser?: string;
+  /** Milliseconds the renderer spent on this capture; null when it reported none or nothing rendered. */
+  durationMs: number | null;
+  /** JSON array of the axe violations found on this capture (never blocking); null when none or not checked. */
+  a11yViolations?: string | null;
   createdAt: string;
   updatedAt: string;
 }

package/dist/schema/usage.d.mts

@@ -0,0 +1,30 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/schema/usage.d.ts
+/** A link from a downstream project to the upstream project that publishes a package it consumes. */
+interface ProjectLink {
+  id: string;
+  /** Project that consumes the package (the app). */
+  downstreamId: string;
+  /** Project whose Storybook publishes the package's components (the design system). */
+  upstreamId: string;
+  packageName: string;
+  createdAt: string;
+}
+/** A dependency package a story file reaches in a build. */
+interface BuildPackageUsage {
+  id: string;
+  projectId: string;
+  buildId: string;
+  /** Story import path, joined to `snapshots.storyImportPath` at read time. */
+  storyImportPath: string;
+  packageName: string;
+  /** First module inside the package the story reaches. */
+  modulePath: string;
+  /** Installed package version at upload time; null when it could not be resolved. */
+  version: string | null;
+  createdAt: string;
+}
+//#endregion
+export { BuildPackageUsage, ProjectLink };
+//# sourceMappingURL=usage.d.mts.map

package/dist/schema.d.mts

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

package/dist/serverless.d.mts

@@ -0,0 +1,21 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/serverless.d.ts
+/**
+ * Serverless hosts (ADR 0006, decision 3): `testing` needs a process that keeps running between
+ * requests, so it is refused on AWS Lambda and warned about on the other platforms that freeze or
+ * end the process after each request. Hosting only works everywhere.
+ */
+/** Escape hatch for hosts that look serverless but keep a process alive. */
+declare const ALLOW_SERVERLESS_ENV = "STORYSHELF_ALLOW_SERVERLESS";
+/** Whether the host ends or freezes the process after each request (Lambda, Vercel, Netlify). */
+declare function isServerlessHost(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Boot check for `testing` on a serverless host. Returns a warning to log, or `undefined` when
+ * there is nothing to say; throws on AWS Lambda. Does nothing without `testing`, or when
+ * `STORYSHELF_ALLOW_SERVERLESS=1`.
+ */
+declare function assertServerless(testing: boolean, env?: NodeJS.ProcessEnv): string | undefined;
+//#endregion
+export { ALLOW_SERVERLESS_ENV, assertServerless, isServerlessHost };
+//# sourceMappingURL=serverless.d.mts.map

package/dist/serverless.mjs

@@ -0,0 +1,37 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/serverless.ts
+/**
+* Serverless hosts (ADR 0006, decision 3): `testing` needs a process that keeps running between
+* requests, so it is refused on AWS Lambda and warned about on the other platforms that freeze or
+* end the process after each request. Hosting only works everywhere.
+*/
+/** Set by AWS Lambda; the one host where `testing` is refused outright. */
+const LAMBDA_ENV = "AWS_LAMBDA_FUNCTION_NAME";
+/** Platforms that freeze or end the process after each request. */
+const SERVERLESS_ENV = [
+	LAMBDA_ENV,
+	"VERCEL",
+	"NETLIFY"
+];
+/** Escape hatch for hosts that look serverless but keep a process alive. */
+const ALLOW_SERVERLESS_ENV = "STORYSHELF_ALLOW_SERVERLESS";
+/** Whether the host ends or freezes the process after each request (Lambda, Vercel, Netlify). */
+function isServerlessHost(env = process.env) {
+	return SERVERLESS_ENV.some((name) => Boolean(env[name]));
+}
+/**
+* Boot check for `testing` on a serverless host. Returns a warning to log, or `undefined` when
+* there is nothing to say; throws on AWS Lambda. Does nothing without `testing`, or when
+* `STORYSHELF_ALLOW_SERVERLESS=1`.
+*/
+function assertServerless(testing, env = process.env) {
+	if (!testing || env["STORYSHELF_ALLOW_SERVERLESS"] === "1" || !isServerlessHost(env)) return;
+	if (env[LAMBDA_ENV]) throw new Error(`testing needs a long-running server, and AWS Lambda ends the process after each request. Remove the testing option to host Storybooks only, or run on a container; set ${ALLOW_SERVERLESS_ENV}=1 to override.`);
+	return `testing is configured on a serverless host: capture jobs run in the background and may be cut off when the platform ends the process. Run on a container for testing; set ${ALLOW_SERVERLESS_ENV}=1 to silence this warning.`;
+}
+//#endregion
+export { ALLOW_SERVERLESS_ENV, assertServerless, isServerlessHost };
+
+//# sourceMappingURL=serverless.mjs.map

package/dist/serverless.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverless.mjs","names":[],"sources":["../src/serverless.ts"],"sourcesContent":["/**\n * Serverless hosts (ADR 0006, decision 3): `testing` needs a process that keeps running between\n * requests, so it is refused on AWS Lambda and warned about on the other platforms that freeze or\n * end the process after each request. Hosting only works everywhere.\n */\n\n/** Set by AWS Lambda; the one host where `testing` is refused outright. */\nconst LAMBDA_ENV = \"AWS_LAMBDA_FUNCTION_NAME\";\n\n/** Platforms that freeze or end the process after each request. */\nconst SERVERLESS_ENV = [LAMBDA_ENV, \"VERCEL\", \"NETLIFY\"] as const;\n\n/** Escape hatch for hosts that look serverless but keep a process alive. */\nexport const ALLOW_SERVERLESS_ENV = \"STORYSHELF_ALLOW_SERVERLESS\";\n\n/** Whether the host ends or freezes the process after each request (Lambda, Vercel, Netlify). */\nexport function isServerlessHost(env: NodeJS.ProcessEnv = process.env): boolean {\n  return SERVERLESS_ENV.some((name) => Boolean(env[name]));\n}\n\n/**\n * Boot check for `testing` on a serverless host. Returns a warning to log, or `undefined` when\n * there is nothing to say; throws on AWS Lambda. Does nothing without `testing`, or when\n * `STORYSHELF_ALLOW_SERVERLESS=1`.\n */\nexport function assertServerless(\n  testing: boolean,\n  env: NodeJS.ProcessEnv = process.env,\n): string | undefined {\n  if (!testing || env[ALLOW_SERVERLESS_ENV] === \"1\" || !isServerlessHost(env)) {\n    return undefined;\n  }\n  if (env[LAMBDA_ENV]) {\n    throw new Error(\n      `testing needs a long-running server, and AWS Lambda ends the process after each request. ` +\n        `Remove the testing option to host Storybooks only, or run on a container; set ` +\n        `${ALLOW_SERVERLESS_ENV}=1 to override.`,\n    );\n  }\n  return (\n    `testing is configured on a serverless host: capture jobs run in the background and may be ` +\n    `cut off when the platform ends the process. Run on a container for testing; set ` +\n    `${ALLOW_SERVERLESS_ENV}=1 to silence this warning.`\n  );\n}\n"],"mappings":";;;;;;;;;;AAOA,MAAM,aAAa;;AAGnB,MAAM,iBAAiB;CAAC;CAAY;CAAU;AAAS;;AAGvD,MAAa,uBAAuB;;AAGpC,SAAgB,iBAAiB,MAAyB,QAAQ,KAAc;CAC9E,OAAO,eAAe,MAAM,SAAS,QAAQ,IAAI,KAAK,CAAC;AACzD;;;;;;AAOA,SAAgB,iBACd,SACA,MAAyB,QAAQ,KACb;CACpB,IAAI,CAAC,WAAW,IAAA,mCAA8B,OAAO,CAAC,iBAAiB,GAAG,GACxE;CAEF,IAAI,IAAI,aACN,MAAM,IAAI,MACR,0KAEK,qBAAqB,gBAC5B;CAEF,OACE,6KAEG,qBAAqB;AAE5B"}

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

@@ -2,8 +2,8 @@ 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. */

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

@@ -0,0 +1,39 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/test-helpers/deferred.d.ts
+/**
+ * A promise a test resolves by hand, for asserting concurrency and ordering without sleeping.
+ * Tests wait on `promise` to observe an in-flight state, then call `resolve()` to let it finish.
+ */
+/** 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;
+//#endregion
+export { Deferred, Latch, ReleaseQueue, createLatch, createReleaseQueue, deferred };
+//# sourceMappingURL=deferred.d.mts.map

package/dist/test-helpers/deferred.mjs

@@ -0,0 +1,61 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region 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;
+		}
+	};
+}
+//#endregion
+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,21 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DesignProvider } from "../adapter/design.mjs";
+//#region src/test-helpers/design-contract.d.ts
+/** Build the provider under test (sync or async factories both work). */
+type DesignFactory = () => DesignProvider | Promise<DesignProvider>;
+/** Links the suite uses to probe `parseUrl`. */
+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;
+//#endregion
+export { DesignContractSamples, DesignFactory, designContractSuite };
+//# sourceMappingURL=design-contract.d.mts.map

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

@@ -0,0 +1,40 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { describe, expect, it } from "vitest";
+//#region 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");
+		});
+	});
+}
+//#endregion
+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-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";
+import { getTableName } from "drizzle-orm";
 //#region 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) => {

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    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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"}