@storyshelf/core 0.6.2 → 0.8.0

package/dist/schema/capture-job.d.mts

@@ -0,0 +1,58 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/**
+ * Row types of `capture_jobs`, the database queue (ADR 0006, decision 4).
+ *
+ * One table holds two kinds of row, told apart by `entry`:
+ *
+ * - a **job** row (`id` = job id, `jobId` = its own id) carries delivery state: `status` is
+ *   `queued | running | done | failed | cancelled`, `attempt` counts the attempts started so far,
+ *   and `visibleAt` is when a queued job may next be claimed;
+ * - an **attempt** row (`id` = `<jobId>:<attempt>`) is one claim of a job, created by a unique-key
+ *   insert. It holds the `owner`, the lease expiry (in `visibleAt`) and, once over, its outcome:
+ *   `status` is `running | done | failed | expired`.
+ *
+ * `visibleAt` is non-null only while a row is a poll candidate (a queued job row, a running attempt
+ * row), so the poll is one indexed range query that reads at most one row.
+ */
+/** Which of the two row kinds of `capture_jobs` a row is. */
+type CaptureJobEntry = "job" | "attempt";
+/** What a job does: render a build or shard, publish a zip, or deliver a notification. */
+type CaptureJobKind = "capture" | "publish" | "notify";
+/** Lifecycle of a job row. */
+type CaptureJobStatus = "queued" | "running" | "done" | "failed" | "cancelled";
+/** Lifecycle of an attempt row; `expired` is a lease another instance took over. */
+type CaptureAttemptStatus = "running" | "done" | "failed" | "expired";
+/** One row of `capture_jobs`: a job, or one attempt at it. */
+interface CaptureJobRow {
+  id: string;
+  entry: CaptureJobEntry;
+  /** The job this row belongs to (a job row's own id). */
+  jobId: string;
+  kind: CaptureJobKind;
+  /** Build the job works on; notify jobs may have none. */
+  buildId: string | null;
+  /** `capture_shards` row a shard job renders; null for the build's own job. */
+  shardId: string | null;
+  /** Job row: attempts started so far. Attempt row: its number, from 1. */
+  attempt: number;
+  /** Attempts allowed in total (`testing.retries` + 1); copied onto attempt rows. */
+  maxAttempts: number;
+  status: CaptureJobStatus | CaptureAttemptStatus;
+  /** Queued job: when it may be claimed. Running attempt: its lease expiry. Otherwise null. */
+  visibleAt: string | null;
+  /** Instance holding an attempt; null on job rows. */
+  owner: string | null;
+  /** JSON: request id, traceparent and kind-specific fields. */
+  payload: string | null;
+  /** Set once cancel was asked for; the holder turns it into `runner.cancel`. */
+  cancelRequestedAt: string | null;
+  /** Job row: the last attempt's error. Attempt row: its own. */
+  error: string | null;
+  startedAt: string | null;
+  finishedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+export { CaptureAttemptStatus, CaptureJobEntry, CaptureJobKind, CaptureJobRow, CaptureJobStatus };
+//# sourceMappingURL=capture-job.d.mts.map

package/dist/schema/capture-shard.d.mts

@@ -0,0 +1,33 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/** What a row of `capture_shards` is: a stage of a sharded capture, or the claim that finalizes it. */
+type CaptureShardKind = "plan" | "render" | "finalize";
+/** Lifecycle of one shard row. */
+type CaptureShardStatus = "pending" | "running" | "done" | "failed";
+/**
+ * One row per stage of a sharded capture: the `plan` (ordinal 0) records the build-level plan, each
+ * `render` shard (ordinal 1..n) is a slice of stories, and a `finalize` row (ordinal 0) is the
+ * claim that makes exactly one worker finish the build. `(buildId, kind, ordinal)` is unique, so
+ * inserting a row is an atomic claim on every database.
+ */
+interface CaptureShard {
+  id: string;
+  projectId: string;
+  buildId: string;
+  kind: CaptureShardKind;
+  ordinal: number;
+  status: CaptureShardStatus;
+  /** Attempt row the build's log history and result belong to (plan row only). */
+  attemptId: string | null;
+  /** JSON: the stories and engines of a render shard, or the plan's settings. */
+  payload: string | null;
+  /** JSON outcome once the stage ended (failed, flaky and a11y story ids, counts, duration). */
+  result: string | null;
+  error: string | null;
+  startedAt: string | null;
+  finishedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+export { CaptureShard, CaptureShardKind, CaptureShardStatus };
+//# sourceMappingURL=capture-shard.d.mts.map

package/dist/schema/comment.d.mts

@@ -1,12 +1,13 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/comment.d.ts
 /** A comment row. */
 interface Comment {
   id: string;
   projectId: string;
   buildId: string;
   snapshotId: string | null;
+  /** Storybook story id of a story-anchored comment (ADR 0013, decision 2); null otherwise. */
+  storyId: string | null;
   userId: string | null;
   body: string;
   parentId: string | null;
@@ -14,6 +15,5 @@ interface Comment {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
 export { Comment };
 //# sourceMappingURL=comment.d.mts.map

package/dist/schema/connection.d.mts

@@ -0,0 +1,22 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/**
+ * A user's own OAuth connection to an external service (`design` providers today,
+ * issue trackers later). One per user and service; tokens are encrypted at rest.
+ */
+interface UserConnection {
+  id: string;
+  userId: string;
+  /** Service `metadata.kind`, e.g. `figma`. */
+  service: string;
+  tokenEncrypted: string;
+  refreshTokenEncrypted: string | null;
+  /** When the access token expires; null when it never does. */
+  expiresAt: string | null;
+  /** `ok`, or `expired` once a refresh failed and the user must reconnect. */
+  status: string;
+  createdAt: string;
+  updatedAt: string;
+}
+export { UserConnection };
+//# sourceMappingURL=connection.d.mts.map

package/dist/schema/content-ref.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/schema/content-ref.d.ts
 /** Content ref row for deduplicated assets. */
 interface ContentRef {
   hash: string;
@@ -8,6 +7,5 @@ interface ContentRef {
   lastSeenAt: string;
   createdAt: string;
 }
-//#endregion
 export { ContentRef };
 //# sourceMappingURL=content-ref.d.mts.map

package/dist/schema/design.d.mts

@@ -0,0 +1,56 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/** 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;
+}
+export { DesignCredential, DesignLink, DesignNode };
+//# sourceMappingURL=design.d.mts.map

package/dist/schema/insight.d.mts

@@ -0,0 +1,52 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/** 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;
+}
+export { AiBudgetAlertRow, AiUsageRow, InsightKind, InsightRow, InsightStatus };
+//# sourceMappingURL=insight.d.mts.map

package/dist/schema/label.d.mts

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

package/dist/schema/member.d.mts

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

package/dist/schema/notification.d.mts

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

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

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

package/dist/schema/project.d.mts

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

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

@@ -0,0 +1,19 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/**
+ * 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;
+}
+export { SiteSetting };
+//# sourceMappingURL=site-setting.d.mts.map

package/dist/schema/snapshot.d.mts

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

package/dist/schema/token.d.mts

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

package/dist/schema/usage.d.mts

@@ -0,0 +1,28 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/** 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;
+}
+export { BuildPackageUsage, ProjectLink };
+//# sourceMappingURL=usage.d.mts.map

package/dist/schema/user.d.mts

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

package/dist/schema/webhook.d.mts

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

package/dist/schema.d.mts

@@ -2,21 +2,27 @@ 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 { BuildReview } from "./schema/build-review.mjs";
+import { SiteSetting } from "./schema/site-setting.mjs";
 import { Comment } from "./schema/comment.mjs";
 import { BuildLabel, LabelType } from "./schema/label.mjs";
+import { UserConnection } from "./schema/connection.mjs";
+import { DesignCredential, DesignLink, DesignNode } from "./schema/design.mjs";
+import { BuildPackageUsage, ProjectLink } from "./schema/usage.mjs";
 import { ProjectMember } from "./schema/member.mjs";
-import { NotificationChannelRow, NotificationSubscriptionRow } from "./schema/notification.mjs";
 import { ProjectGroupMapping } from "./schema/project-group-mapping.mjs";
+import { AiBudgetAlertRow, AiUsageRow, InsightKind, InsightRow, InsightStatus } from "./schema/insight.mjs";
+import { NotificationChannelRow, NotificationSubscriptionRow } from "./schema/notification.mjs";
 import { Token } from "./schema/token.mjs";
 import { User } from "./schema/user.mjs";
-//#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,19 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/**
+ * 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;
+export { ALLOW_SERVERLESS_ENV, assertServerless, isServerlessHost };
+//# sourceMappingURL=serverless.d.mts.map

package/dist/serverless.mjs

@@ -0,0 +1,36 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// 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.`;
+}
+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/build-reference-contract.d.mts

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