@storyshelf/core 0.7.0 → 0.8.0

package/dist/models/snapshot.mjs

@@ -5,7 +5,7 @@ import "../adapters/capture-target.mjs";
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, eq, inArray } from "drizzle-orm";
-//#region src/models/snapshot.ts
+// src/models/snapshot.ts
 /** Snapshot records for captured stories within a build. */
 /** Data operations for snapshot records. */
 var SnapshotModel = class {
@@ -45,6 +45,9 @@ var SnapshotModel = class {
 			infraHash: input.infraHash ?? null,
 			envChange: input.envChange ?? null,
 			inherited: input.inherited ?? false,
+			sourceBuildId: input.inherited ? input.sourceBuildId ?? null : buildId,
+			comparisonImagePath: input.comparisonImagePath ?? null,
+			comparisonMetadata: input.comparisonMetadata ?? null,
 			baselineId: input.baselineId ?? null,
 			baselineVersion: input.baselineVersion ?? null,
 			mode: input.mode ?? null,
@@ -123,7 +126,6 @@ var SnapshotModel = class {
 		});
 	}
 };
-//#endregion
 export { SnapshotModel };
 
 //# sourceMappingURL=snapshot.mjs.map

package/dist/models/snapshot.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.mjs","names":[],"sources":["../../src/models/snapshot.ts"],"sourcesContent":["/** Snapshot records for captured stories within a build. */\nimport { and, eq, inArray } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport { DEFAULT_BROWSER } from \"../adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { Snapshot } from \"../schema/snapshot.ts\";\nimport type { SnapshotStatus } from \"../types.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\n\n/** Tables required by {@link SnapshotModel}. */\nexport interface SnapshotTables {\n  snapshots: Table;\n}\n\n/** Data operations for snapshot records. */\nexport class SnapshotModel {\n  private readonly tables: SnapshotTables;\n  private readonly db: DatabaseAdapter;\n\n  /**\n   * @param db - Database adapter.\n   * @param tables - Table handles.\n   */\n  constructor(db: DatabaseAdapter, tables?: SnapshotTables) {\n    this.db = db;\n    this.tables = tables ?? { snapshots: db.tables.snapshots };\n  }\n\n  /**\n   * Create a snapshot for a story within a build.\n   *\n   * @param projectId - Project ID.\n   * @param buildId - Build ID.\n   * @param input - Snapshot creation input.\n   * @returns The created snapshot.\n   */\n  async create(projectId: string, buildId: string, input: SnapshotCreateInput): Promise<Snapshot> {\n    const now = new Date().toISOString();\n    return (await this.db.insert(this.tables.snapshots, {\n      id: ulid(),\n      projectId,\n      buildId,\n      storyId: input.storyId,\n      storyName: input.storyName,\n      storyTitle: input.storyTitle,\n      storyImportPath: input.storyImportPath,\n      designUrl: input.designUrl ?? null,\n      viewportName: input.viewportName,\n      viewportWidth: input.viewportWidth,\n      viewportHeight: input.viewportHeight,\n      screenshotPath: input.screenshotPath,\n      infraHash: input.infraHash ?? null,\n      envChange: input.envChange ?? null,\n      inherited: input.inherited ?? false,\n      baselineId: input.baselineId ?? null,\n      baselineVersion: input.baselineVersion ?? null,\n      mode: input.mode ?? null,\n      browser: input.browser ?? DEFAULT_BROWSER,\n      durationMs: input.durationMs ?? null,\n      a11yViolations: input.a11yViolations ?? null,\n      status: \"pending\",\n      createdAt: now,\n      updatedAt: now,\n    })) as unknown as Snapshot;\n  }\n\n  /**\n   * Delete the rendered snapshots a shard is about to write again: rows of `(story, engine)` pairs\n   * in `work`, so a rerun starts from a clean slate instead of colliding with rows an earlier,\n   * interrupted run left behind. Inherited rows are kept: the plan wrote them, for engines or\n   * viewports this shard does not render.\n   */\n  async removeRendered(\n    buildId: string,\n    work: readonly { browser: string; storyIds: ReadonlySet<string> }[],\n  ): Promise<number> {\n    const doomed = (await this.listByBuild(buildId)).filter(\n      (row) =>\n        !row.inherited &&\n        work.some(\n          (engine) =>\n            engine.browser === (row.browser ?? DEFAULT_BROWSER) && engine.storyIds.has(row.storyId),\n        ),\n    );\n    await this.#removeAll(doomed);\n    return doomed.length;\n  }\n\n  /** Delete every snapshot of a build: a new plan of it starts clean. */\n  async removeForBuild(buildId: string): Promise<number> {\n    const doomed = await this.listByBuild(buildId);\n    await this.#removeAll(doomed);\n    return doomed.length;\n  }\n\n  async #removeAll(rows: readonly Snapshot[]): Promise<void> {\n    await Promise.all(\n      rows.map(async (row) => {\n        await this.db.remove(this.tables.snapshots, row.id);\n      }),\n    );\n  }\n\n  /**\n   * Milliseconds each story cost on one build, summed over its viewports and engines. Stories the\n   * renderer did not time are left out, so an empty map means this build carries no timings.\n   */\n  async durationsByStory(buildId: string): Promise<Map<string, number>> {\n    const totals = new Map<string, number>();\n    for (const row of await this.listByBuild(buildId)) {\n      if (typeof row.durationMs === \"number\") {\n        totals.set(row.storyId, (totals.get(row.storyId) ?? 0) + row.durationMs);\n      }\n    }\n    return totals;\n  }\n\n  /** List all snapshots belonging to a build. */\n  async listByBuild(buildId: string): Promise<Snapshot[]> {\n    return (await this.db.list(this.tables.snapshots, {\n      where: eq(col(this.tables.snapshots, \"buildId\"), buildId),\n    })) as unknown as Snapshot[];\n  }\n\n  /**\n   * Every snapshot of a story file across the project's builds. Index paths are\n   * stored raw (`./src/A.stories.tsx`), so both spellings of `importPath` match.\n   */\n  async listByImportPath(projectId: string, importPath: string): Promise<Snapshot[]> {\n    const bare = importPath.replace(/^(?:\\.\\/)+/u, \"\");\n    return (await this.db.list(this.tables.snapshots, {\n      where: and(\n        eq(col(this.tables.snapshots, \"projectId\"), projectId),\n        inArray(col(this.tables.snapshots, \"storyImportPath\"), [bare, `./${bare}`]),\n      ),\n    })) as unknown as Snapshot[];\n  }\n\n  /** Fetch a snapshot by id, or null if not found. */\n  async get(id: string): Promise<Snapshot | null> {\n    return (await this.db.get(this.tables.snapshots, id)) as unknown as Snapshot | null;\n  }\n\n  /** Update mutable fields of a snapshot. */\n  async update(id: string, patch: Partial<Snapshot>): Promise<Snapshot> {\n    return (await this.db.update(this.tables.snapshots, id, {\n      ...patch,\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Snapshot;\n  }\n\n  /** Set the status of a snapshot. */\n  async setStatus(id: string, status: SnapshotStatus): Promise<Snapshot> {\n    return await this.update(id, { status });\n  }\n\n  /** Record a reviewer's decision on a snapshot. */\n  async review(id: string, status: SnapshotStatus, userId: string | null): Promise<Snapshot> {\n    return await this.update(id, {\n      status,\n      reviewedBy: userId,\n      reviewedAt: new Date().toISOString(),\n    });\n  }\n}\n\n/** Input for creating a snapshot. */\nexport interface SnapshotCreateInput {\n  storyId: string;\n  storyName: string;\n  storyTitle: string;\n  storyImportPath?: string;\n  /** Figma URL declared by the story (`parameters.design` / `storyshelf.figma`). */\n  designUrl?: string | null;\n  viewportName: string;\n  viewportWidth: number;\n  viewportHeight: number;\n  screenshotPath: string;\n  infraHash?: string | null;\n  /** JSON `EnvironmentChange` when accepted as an environment migration. */\n  envChange?: string | null;\n  inherited?: boolean;\n  baselineId?: string | null;\n  baselineVersion?: string | null;\n  /** Resolved mode definition as JSON (display/capture only). */\n  mode?: string | null;\n  /** Engine the screenshot was captured with (default chromium). */\n  browser?: string;\n  /** Milliseconds the renderer spent on this capture, when it reported any. */\n  durationMs?: number | null;\n  /** JSON array of axe violation texts found on this capture; null when none. */\n  a11yViolations?: string | null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"snapshot.mjs","names":[],"sources":["../../src/models/snapshot.ts"],"sourcesContent":["/** Snapshot records for captured stories within a build. */\nimport { and, eq, inArray } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport { DEFAULT_BROWSER } from \"../adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { Snapshot } from \"../schema/snapshot.ts\";\nimport type { SnapshotStatus } from \"../types.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\n\n/** Tables required by {@link SnapshotModel}. */\nexport interface SnapshotTables {\n  snapshots: Table;\n}\n\n/** Data operations for snapshot records. */\nexport class SnapshotModel {\n  private readonly tables: SnapshotTables;\n  private readonly db: DatabaseAdapter;\n\n  /**\n   * @param db - Database adapter.\n   * @param tables - Table handles.\n   */\n  constructor(db: DatabaseAdapter, tables?: SnapshotTables) {\n    this.db = db;\n    this.tables = tables ?? { snapshots: db.tables.snapshots };\n  }\n\n  /**\n   * Create a snapshot for a story within a build.\n   *\n   * @param projectId - Project ID.\n   * @param buildId - Build ID.\n   * @param input - Snapshot creation input.\n   * @returns The created snapshot.\n   */\n  async create(projectId: string, buildId: string, input: SnapshotCreateInput): Promise<Snapshot> {\n    const now = new Date().toISOString();\n    return (await this.db.insert(this.tables.snapshots, {\n      id: ulid(),\n      projectId,\n      buildId,\n      storyId: input.storyId,\n      storyName: input.storyName,\n      storyTitle: input.storyTitle,\n      storyImportPath: input.storyImportPath,\n      designUrl: input.designUrl ?? null,\n      viewportName: input.viewportName,\n      viewportWidth: input.viewportWidth,\n      viewportHeight: input.viewportHeight,\n      screenshotPath: input.screenshotPath,\n      infraHash: input.infraHash ?? null,\n      envChange: input.envChange ?? null,\n      inherited: input.inherited ?? false,\n      sourceBuildId: input.inherited ? (input.sourceBuildId ?? null) : buildId,\n      comparisonImagePath: input.comparisonImagePath ?? null,\n      comparisonMetadata: input.comparisonMetadata ?? null,\n      baselineId: input.baselineId ?? null,\n      baselineVersion: input.baselineVersion ?? null,\n      mode: input.mode ?? null,\n      browser: input.browser ?? DEFAULT_BROWSER,\n      durationMs: input.durationMs ?? null,\n      a11yViolations: input.a11yViolations ?? null,\n      status: \"pending\",\n      createdAt: now,\n      updatedAt: now,\n    })) as unknown as Snapshot;\n  }\n\n  /**\n   * Delete the rendered snapshots a shard is about to write again: rows of `(story, engine)` pairs\n   * in `work`, so a rerun starts from a clean slate instead of colliding with rows an earlier,\n   * interrupted run left behind. Inherited rows are kept: the plan wrote them, for engines or\n   * viewports this shard does not render.\n   */\n  async removeRendered(\n    buildId: string,\n    work: readonly { browser: string; storyIds: ReadonlySet<string> }[],\n  ): Promise<number> {\n    const doomed = (await this.listByBuild(buildId)).filter(\n      (row) =>\n        !row.inherited &&\n        work.some(\n          (engine) =>\n            engine.browser === (row.browser ?? DEFAULT_BROWSER) && engine.storyIds.has(row.storyId),\n        ),\n    );\n    await this.#removeAll(doomed);\n    return doomed.length;\n  }\n\n  /** Delete every snapshot of a build: a new plan of it starts clean. */\n  async removeForBuild(buildId: string): Promise<number> {\n    const doomed = await this.listByBuild(buildId);\n    await this.#removeAll(doomed);\n    return doomed.length;\n  }\n\n  async #removeAll(rows: readonly Snapshot[]): Promise<void> {\n    await Promise.all(\n      rows.map(async (row) => {\n        await this.db.remove(this.tables.snapshots, row.id);\n      }),\n    );\n  }\n\n  /**\n   * Milliseconds each story cost on one build, summed over its viewports and engines. Stories the\n   * renderer did not time are left out, so an empty map means this build carries no timings.\n   */\n  async durationsByStory(buildId: string): Promise<Map<string, number>> {\n    const totals = new Map<string, number>();\n    for (const row of await this.listByBuild(buildId)) {\n      if (typeof row.durationMs === \"number\") {\n        totals.set(row.storyId, (totals.get(row.storyId) ?? 0) + row.durationMs);\n      }\n    }\n    return totals;\n  }\n\n  /** List all snapshots belonging to a build. */\n  async listByBuild(buildId: string): Promise<Snapshot[]> {\n    return (await this.db.list(this.tables.snapshots, {\n      where: eq(col(this.tables.snapshots, \"buildId\"), buildId),\n    })) as unknown as Snapshot[];\n  }\n\n  /**\n   * Every snapshot of a story file across the project's builds. Index paths are\n   * stored raw (`./src/A.stories.tsx`), so both spellings of `importPath` match.\n   */\n  async listByImportPath(projectId: string, importPath: string): Promise<Snapshot[]> {\n    const bare = importPath.replace(/^(?:\\.\\/)+/u, \"\");\n    return (await this.db.list(this.tables.snapshots, {\n      where: and(\n        eq(col(this.tables.snapshots, \"projectId\"), projectId),\n        inArray(col(this.tables.snapshots, \"storyImportPath\"), [bare, `./${bare}`]),\n      ),\n    })) as unknown as Snapshot[];\n  }\n\n  /** Fetch a snapshot by id, or null if not found. */\n  async get(id: string): Promise<Snapshot | null> {\n    return (await this.db.get(this.tables.snapshots, id)) as unknown as Snapshot | null;\n  }\n\n  /** Update mutable fields of a snapshot. */\n  async update(id: string, patch: Partial<Snapshot>): Promise<Snapshot> {\n    return (await this.db.update(this.tables.snapshots, id, {\n      ...patch,\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Snapshot;\n  }\n\n  /** Set the status of a snapshot. */\n  async setStatus(id: string, status: SnapshotStatus): Promise<Snapshot> {\n    return await this.update(id, { status });\n  }\n\n  /** Record a reviewer's decision on a snapshot. */\n  async review(id: string, status: SnapshotStatus, userId: string | null): Promise<Snapshot> {\n    return await this.update(id, {\n      status,\n      reviewedBy: userId,\n      reviewedAt: new Date().toISOString(),\n    });\n  }\n}\n\n/** Input for creating a snapshot. */\nexport interface SnapshotCreateInput {\n  storyId: string;\n  storyName: string;\n  storyTitle: string;\n  storyImportPath?: string;\n  /** Figma URL declared by the story (`parameters.design` / `storyshelf.figma`). */\n  designUrl?: string | null;\n  viewportName: string;\n  viewportWidth: number;\n  viewportHeight: number;\n  screenshotPath: string;\n  infraHash?: string | null;\n  /** JSON `EnvironmentChange` when accepted as an environment migration. */\n  envChange?: string | null;\n  inherited?: boolean;\n  sourceBuildId?: string | null;\n  comparisonImagePath?: string | null;\n  comparisonMetadata?: string | null;\n  baselineId?: string | null;\n  baselineVersion?: string | null;\n  /** Resolved mode definition as JSON (display/capture only). */\n  mode?: string | null;\n  /** Engine the screenshot was captured with (default chromium). */\n  browser?: string;\n  /** Milliseconds the renderer spent on this capture, when it reported any. */\n  durationMs?: number | null;\n  /** JSON array of axe violation texts found on this capture; null when none. */\n  a11yViolations?: string | null;\n}\n"],"mappings":"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"}

package/dist/models/token.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Token } from "../schema/token.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/token.d.ts
 /** Tables required by {@link TokenModel}. */
 interface TokenTables {
   tokens: Table;
@@ -51,6 +50,5 @@ declare class TokenModel {
   /** Delete a token by id. */
   remove(id: string): Promise<void>;
 }
-//#endregion
 export { TokenModel, TokenTables };
 //# sourceMappingURL=token.d.mts.map

package/dist/models/token.mjs

@@ -5,7 +5,7 @@ import { randomToken } from "../utils/hash.mjs";
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, eq } from "drizzle-orm";
-//#region src/models/token.ts
+// src/models/token.ts
 /** CI tokens for project-scoped API access. */
 /** Data operations for CI tokens. */
 var TokenModel = class {
@@ -76,7 +76,6 @@ var TokenModel = class {
 		await this.db.remove(this.tables.tokens, id);
 	}
 };
-//#endregion
 export { TokenModel };
 
 //# sourceMappingURL=token.mjs.map

package/dist/models/usage.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { BuildPackageUsage, ProjectLink } from "../schema/usage.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/usage.d.ts
 /** Tables required by {@link PackageUsageModel}. */
 interface PackageUsageTables {
   buildPackageUsage: Table;
@@ -71,6 +70,5 @@ declare class PackageUsageModel {
   private atomic;
   private buildWhere;
 }
-//#endregion
 export { PackageUsageInput, PackageUsageModel, PackageUsageTables, UpstreamStory, matchUpstreamStory };
 //# sourceMappingURL=usage.d.mts.map

package/dist/models/usage.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, eq } from "drizzle-orm";
-//#region src/models/usage.ts
+// src/models/usage.ts
 /** Per-build package usage and cross-project package links. */
 /** `Button.stories.tsx` / `Button.js` / `Button/index.js` → `Button`. */
 function componentStem(path) {
@@ -143,7 +143,6 @@ async function serialized(key, task) {
 		if (pending.get(key) === tail) pending.delete(key);
 	}
 }
-//#endregion
 export { PackageUsageModel, matchUpstreamStory };
 
 //# sourceMappingURL=usage.mjs.map

package/dist/models/user.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { User } from "../schema/user.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/user.d.ts
 /** Tables required by {@link UserModel}. */
 interface UserTables {
   users: Table;
@@ -37,6 +36,5 @@ declare class UserModel {
   /** Update the display name override for a user (profile edit). */
   setDisplayNameOverride(id: string, displayName: string | null): Promise<User>;
 }
-//#endregion
 export { UserModel, UserTables };
 //# sourceMappingURL=user.d.mts.map

package/dist/models/user.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { col } from "./columns.mjs";
 import { eq } from "drizzle-orm";
-//#region src/models/user.ts
+// src/models/user.ts
 /** User lookups for token and membership resolution. */
 /** Data operations for users. */
 var UserModel = class {
@@ -60,7 +60,6 @@ var UserModel = class {
 		return await this.db.update(this.tables.users, id, { displayNameOverride: displayName?.trim() ? displayName.trim() : null });
 	}
 };
-//#endregion
 export { UserModel };
 
 //# sourceMappingURL=user.mjs.map

package/dist/models/webhook.d.mts

@@ -4,7 +4,6 @@ import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Webhook } from "../schema/webhook.mjs";
 import { SecretInput } from "../utils/encrypt.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/webhook.d.ts
 /** Tables required by {@link WebhookModel}. */
 interface WebhookTables {
   webhooks: Table;
@@ -59,6 +58,5 @@ interface WebhookCreateInput {
   events?: string[];
   secret: string;
 }
-//#endregion
 export { WebhookCreateInput, WebhookModel, WebhookTables };
 //# sourceMappingURL=webhook.d.mts.map

package/dist/models/webhook.mjs

@@ -6,7 +6,7 @@ import { decryptCredential, encrypt } from "../utils/encrypt.mjs";
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { eq } from "drizzle-orm";
-//#region src/models/webhook.ts
+// src/models/webhook.ts
 /** Webhook subscriptions for project events. */
 /** Data operations for webhook subscriptions. */
 var WebhookModel = class {
@@ -101,7 +101,6 @@ var WebhookModel = class {
 		}
 	}
 };
-//#endregion
 export { WebhookModel };
 
 //# sourceMappingURL=webhook.mjs.map

package/dist/models.d.mts

@@ -5,15 +5,18 @@ import { BuildCreateInput, BuildListFilter, BuildModel, isPublicBuild } from "./
 import { AttemptLogRecorder, CaptureAttemptModel, CaptureAttemptTables, emitAttemptLog } from "./models/capture-attempt.mjs";
 import { CaptureLogModel, CaptureLogTables } from "./models/capture-log.mjs";
 import { ProjectCreateInput, ProjectModel } from "./models/project.mjs";
+import { BaselineWriteConflict } from "./models/baseline-conflict.mjs";
+import { BaselineStatus, NO_BASELINE, baselineStatus, isBaselineDrifted } from "./models/baseline-status.mjs";
+import { BaselineApprovalConflict } from "./models/baseline-approval.mjs";
 import { BaselineModel } from "./models/baseline.mjs";
 import { SnapshotCreateInput, SnapshotModel } from "./models/snapshot.mjs";
 import { AttemptClaim, CaptureJobModel, CaptureJobTables, NewCaptureJob, TERMINAL_JOB_STATUSES, attemptRowId, isTerminalJob, parseAttemptRowId } from "./models/capture-job.mjs";
 import { BuildComponentInput, BuildComponentModel, BuildComponentTables } from "./models/build-component.mjs";
 import { ComponentHistoryRow, ComponentPresence, componentHistory, componentPresence, worstStatus } from "./models/component.mjs";
+import { BaselineOriginReader, resolveBaselineOrigin } from "./models/baseline-origin.mjs";
 import { BASELINE_ARCHIVE_FORMAT, BASELINE_ARCHIVE_LIMITS, BASELINE_ARCHIVE_VERSION, BaselineArchiveError, BaselineManifest, BaselineManifestEntry } from "./models/baseline-archive.mjs";
 import { BaselineExportOptions } from "./models/baseline-export.mjs";
 import { BaselineImportResult, BaselineTransferModel } from "./models/baseline-transfer.mjs";
-import { BaselineStatus, NO_BASELINE, baselineStatus, isBaselineDrifted } from "./models/baseline-status.mjs";
 import { CaptureShardModel, CaptureShardTables } from "./models/capture-shard.mjs";
 import { AiBudgetAlertModel, AiBudgetAlertTables } from "./models/ai-budget-alert.mjs";
 import { AiUsageInput, AiUsageModel, AiUsageTables } from "./models/ai-usage.mjs";
@@ -42,4 +45,4 @@ import { ContentRefModel } from "./models/content-ref.mjs";
 import { CredentialProbe, ReencryptResult, UnreadableCredential, probeCredentials, reencryptCredentials } from "./models/credentials.mjs";
 import { SiteSettingsModel, SiteSettingsTables } from "./models/site-settings.mjs";
 import { PUBLIC_ORIGIN_KEY, PublicOriginOptions, PublicOriginResolver, PublicOriginSource, ResolvedPublicOrigin, StoredPublicOrigin, createPublicOriginResolver } from "./models/public-origin.mjs";
-export { AiBudgetAlertModel, type AiBudgetAlertTables, type AiUsageInput, AiUsageModel, type AiUsageTables, type AttemptClaim, type AttemptLogRecorder, BASELINE_ARCHIVE_FORMAT, BASELINE_ARCHIVE_LIMITS, BASELINE_ARCHIVE_VERSION, BaselineArchiveError, type BaselineExportOptions, type BaselineImportResult, type BaselineManifest, type BaselineManifestEntry, BaselineModel, type BaselineStatus, BaselineTransferModel, type BuildChangeset, type BuildComponentInput, BuildComponentModel, type BuildComponentTables, type BuildCreateInput, type BuildListFilter, BuildModel, BuildReviewModel, type BuildReviewTables, CaptureAttemptModel, type CaptureAttemptTables, CaptureJobModel, type CaptureJobTables, CaptureLogModel, type CaptureLogTables, CaptureShardModel, type CaptureShardTables, type ChangedComponent, type Changeset, type ChangesetComponent, type ChannelValidation, type CommentCreateInput, CommentModel, type ComponentHistoryRow, type ComponentPresence, ConnectionModel, type ConnectionTables, ContentRefModel, type CredentialProbe, DESIGN_TTL_MS, DesignCredentialModel, type DesignCredentialStatus, type DesignCredentialTables, DesignModel, DesignNodeModel, type DesignNodeTables, type DesignResolution, type DesignSource, type DesignTables, type InheritedRatio, InsightModel, type InsightResultInput, type InsightStartInput, type InsightStartResult, type InsightTables, LabelModel, MemberModel, NO_BASELINE, type NewCaptureJob, type NotificationChannelCreateInput, NotificationChannelModel, type NotificationChannelTables, type NotificationSubscriptionInput, NotificationSubscriptionModel, type NotificationSubscriptionTables, PROJECT_SCOPE, PUBLIC_ORIGIN_KEY, type PackageUsageInput, PackageUsageModel, type PackageUsageTables, type ProjectCreateInput, ProjectGroupMappingModel, ProjectModel, type PublicOriginOptions, type PublicOriginResolver, type PublicOriginSource, RECENT_BUILDS_FOR_INHERITED_RATIO, type ReencryptResult, type RefreshOptions, type ResolvedPublicOrigin, type ReviewStatusInput, SiteSettingsModel, type SiteSettingsTables, type SnapshotCreateInput, SnapshotModel, type StoredPublicOrigin, TERMINAL_JOB_STATUSES, TokenModel, type UnreadableCredential, type UpstreamStory, UserModel, type WebhookCreateInput, WebhookModel, acceptPendingWithoutWork, attemptRowId, averageInheritedRatio, baselineStatus, changesetOf, componentHistory, componentPresence, computeChangeset, createPublicOriginResolver, credentialDaysLeft, deriveReviewStatus, emitAttemptLog, findChangesetBaseline, isBaselineDrifted, isDesignStale, isPublicBuild, isTerminalJob, latestVerdicts, matchUpstreamStory, normalizeImportPath, parseAttemptRowId, probeCredentials, reencryptCredentials, resolveDesigns, worstStatus };
+export { AiBudgetAlertModel, type AiBudgetAlertTables, type AiUsageInput, AiUsageModel, type AiUsageTables, type AttemptClaim, type AttemptLogRecorder, BASELINE_ARCHIVE_FORMAT, BASELINE_ARCHIVE_LIMITS, BASELINE_ARCHIVE_VERSION, BaselineApprovalConflict, BaselineArchiveError, type BaselineExportOptions, type BaselineImportResult, type BaselineManifest, type BaselineManifestEntry, BaselineModel, type BaselineOriginReader, type BaselineStatus, BaselineTransferModel, BaselineWriteConflict, type BuildChangeset, type BuildComponentInput, BuildComponentModel, type BuildComponentTables, type BuildCreateInput, type BuildListFilter, BuildModel, BuildReviewModel, type BuildReviewTables, CaptureAttemptModel, type CaptureAttemptTables, CaptureJobModel, type CaptureJobTables, CaptureLogModel, type CaptureLogTables, CaptureShardModel, type CaptureShardTables, type ChangedComponent, type Changeset, type ChangesetComponent, type ChannelValidation, type CommentCreateInput, CommentModel, type ComponentHistoryRow, type ComponentPresence, ConnectionModel, type ConnectionTables, ContentRefModel, type CredentialProbe, DESIGN_TTL_MS, DesignCredentialModel, type DesignCredentialStatus, type DesignCredentialTables, DesignModel, DesignNodeModel, type DesignNodeTables, type DesignResolution, type DesignSource, type DesignTables, type InheritedRatio, InsightModel, type InsightResultInput, type InsightStartInput, type InsightStartResult, type InsightTables, LabelModel, MemberModel, NO_BASELINE, type NewCaptureJob, type NotificationChannelCreateInput, NotificationChannelModel, type NotificationChannelTables, type NotificationSubscriptionInput, NotificationSubscriptionModel, type NotificationSubscriptionTables, PROJECT_SCOPE, PUBLIC_ORIGIN_KEY, type PackageUsageInput, PackageUsageModel, type PackageUsageTables, type ProjectCreateInput, ProjectGroupMappingModel, ProjectModel, type PublicOriginOptions, type PublicOriginResolver, type PublicOriginSource, RECENT_BUILDS_FOR_INHERITED_RATIO, type ReencryptResult, type RefreshOptions, type ResolvedPublicOrigin, type ReviewStatusInput, SiteSettingsModel, type SiteSettingsTables, type SnapshotCreateInput, SnapshotModel, type StoredPublicOrigin, TERMINAL_JOB_STATUSES, TokenModel, type UnreadableCredential, type UpstreamStory, UserModel, type WebhookCreateInput, WebhookModel, acceptPendingWithoutWork, attemptRowId, averageInheritedRatio, baselineStatus, changesetOf, componentHistory, componentPresence, computeChangeset, createPublicOriginResolver, credentialDaysLeft, deriveReviewStatus, emitAttemptLog, findChangesetBaseline, isBaselineDrifted, isDesignStale, isPublicBuild, isTerminalJob, latestVerdicts, matchUpstreamStory, normalizeImportPath, parseAttemptRowId, probeCredentials, reencryptCredentials, resolveBaselineOrigin, resolveDesigns, worstStatus };

package/dist/models.mjs

@@ -4,8 +4,10 @@ import.meta.url;
 import { WebhookModel } from "./models/webhook.mjs";
 import { CaptureAttemptModel, emitAttemptLog } from "./models/capture-attempt.mjs";
 import { BuildModel, isPublicBuild } from "./models/build.mjs";
-import { BaselineModel } from "./models/baseline.mjs";
+import { BaselineWriteConflict } from "./models/baseline-conflict.mjs";
 import { NO_BASELINE, baselineStatus, isBaselineDrifted } from "./models/baseline-status.mjs";
+import { BaselineApprovalConflict } from "./models/baseline-approval.mjs";
+import { BaselineModel } from "./models/baseline.mjs";
 import { SnapshotModel } from "./models/snapshot.mjs";
 import { CaptureShardModel } from "./models/capture-shard.mjs";
 import { ProjectModel } from "./models/project.mjs";
@@ -18,6 +20,7 @@ import { PUBLIC_ORIGIN_KEY, createPublicOriginResolver } from "./models/public-o
 import { CaptureLogModel } from "./models/capture-log.mjs";
 import { BuildComponentModel } from "./models/build-component.mjs";
 import { normalizeImportPath, resolveDesigns } from "./models/design-resolve.mjs";
+import { resolveBaselineOrigin } from "./models/baseline-origin.mjs";
 import { BASELINE_ARCHIVE_FORMAT, BASELINE_ARCHIVE_LIMITS, BASELINE_ARCHIVE_VERSION, BaselineArchiveError } from "./models/baseline-archive.mjs";
 import { BaselineTransferModel } from "./models/baseline-transfer.mjs";
 import { AiBudgetAlertModel } from "./models/ai-budget-alert.mjs";
@@ -42,4 +45,4 @@ import { TokenModel } from "./models/token.mjs";
 import { UserModel } from "./models/user.mjs";
 import { ContentRefModel } from "./models/content-ref.mjs";
 import { probeCredentials, reencryptCredentials } from "./models/credentials.mjs";
-export { AiBudgetAlertModel, AiUsageModel, BASELINE_ARCHIVE_FORMAT, BASELINE_ARCHIVE_LIMITS, BASELINE_ARCHIVE_VERSION, BaselineArchiveError, BaselineModel, BaselineTransferModel, BuildComponentModel, BuildModel, BuildReviewModel, CaptureAttemptModel, CaptureJobModel, CaptureLogModel, CaptureShardModel, CommentModel, ConnectionModel, ContentRefModel, DESIGN_TTL_MS, DesignCredentialModel, DesignModel, DesignNodeModel, InsightModel, LabelModel, MemberModel, NO_BASELINE, NotificationChannelModel, NotificationSubscriptionModel, PROJECT_SCOPE, PUBLIC_ORIGIN_KEY, PackageUsageModel, ProjectGroupMappingModel, ProjectModel, RECENT_BUILDS_FOR_INHERITED_RATIO, SiteSettingsModel, SnapshotModel, TERMINAL_JOB_STATUSES, TokenModel, UserModel, WebhookModel, acceptPendingWithoutWork, attemptRowId, averageInheritedRatio, baselineStatus, changesetOf, componentHistory, componentPresence, computeChangeset, createPublicOriginResolver, credentialDaysLeft, deriveReviewStatus, emitAttemptLog, findChangesetBaseline, isBaselineDrifted, isDesignStale, isPublicBuild, isTerminalJob, latestVerdicts, matchUpstreamStory, normalizeImportPath, parseAttemptRowId, probeCredentials, reencryptCredentials, resolveDesigns, worstStatus };
+export { AiBudgetAlertModel, AiUsageModel, BASELINE_ARCHIVE_FORMAT, BASELINE_ARCHIVE_LIMITS, BASELINE_ARCHIVE_VERSION, BaselineApprovalConflict, BaselineArchiveError, BaselineModel, BaselineTransferModel, BaselineWriteConflict, BuildComponentModel, BuildModel, BuildReviewModel, CaptureAttemptModel, CaptureJobModel, CaptureLogModel, CaptureShardModel, CommentModel, ConnectionModel, ContentRefModel, DESIGN_TTL_MS, DesignCredentialModel, DesignModel, DesignNodeModel, InsightModel, LabelModel, MemberModel, NO_BASELINE, NotificationChannelModel, NotificationSubscriptionModel, PROJECT_SCOPE, PUBLIC_ORIGIN_KEY, PackageUsageModel, ProjectGroupMappingModel, ProjectModel, RECENT_BUILDS_FOR_INHERITED_RATIO, SiteSettingsModel, SnapshotModel, TERMINAL_JOB_STATUSES, TokenModel, UserModel, WebhookModel, acceptPendingWithoutWork, attemptRowId, averageInheritedRatio, baselineStatus, changesetOf, componentHistory, componentPresence, computeChangeset, createPublicOriginResolver, credentialDaysLeft, deriveReviewStatus, emitAttemptLog, findChangesetBaseline, isBaselineDrifted, isDesignStale, isPublicBuild, isTerminalJob, latestVerdicts, matchUpstreamStory, normalizeImportPath, parseAttemptRowId, probeCredentials, reencryptCredentials, resolveBaselineOrigin, resolveDesigns, worstStatus };

package/dist/options.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { ShelfOptions } from "./config.mjs";
-//#region src/options.d.ts
 /** Where capture scratch lives when `config.scratchDir` is not set. */
 declare const DEFAULT_SCRATCH_DIR: string;
 /**
@@ -13,6 +12,5 @@ declare const DEFAULT_SCRATCH_DIR: string;
  *   with or without `testing`.
  */
 declare function resolveShelfOptions(options: ShelfOptions): ShelfOptions;
-//#endregion
 export { DEFAULT_SCRATCH_DIR, resolveShelfOptions };
 //# sourceMappingURL=options.d.mts.map

package/dist/options.mjs

@@ -1,10 +1,9 @@
-import "node:path";
+import { join } from "node:path";
 import "node:url";
 import.meta.url;
 import { notificationsConfigSchema } from "./config.mjs";
 import { tmpdir } from "node:os";
-import { join } from "node:path";
-//#region src/options.ts
+// src/options.ts
 /** Resolves `ShelfOptions` once at boot: validates `testing.compare` and fills the scratch default. */
 /** Where capture scratch lives when `config.scratchDir` is not set. */
 const DEFAULT_SCRATCH_DIR = join(tmpdir(), "storyshelf");
@@ -84,7 +83,6 @@ function assertNotificationsConfig(config) {
 		throw new Error(`Invalid notifications.config: ${issues}`);
 	}
 }
-//#endregion
 export { DEFAULT_SCRATCH_DIR, resolveShelfOptions };
 
 //# sourceMappingURL=options.mjs.map

package/dist/options.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options.mjs","names":[],"sources":["../src/options.ts"],"sourcesContent":["/** Resolves `ShelfOptions` once at boot: validates `testing.compare` and fills the scratch default. */\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { notificationsConfigSchema, type ShelfOptions } from \"./config.ts\";\n\n/** Where capture scratch lives when `config.scratchDir` is not set. */\nexport const DEFAULT_SCRATCH_DIR: string = join(tmpdir(), \"storyshelf\");\n\n/**\n * Validate and complete the options.\n *\n * - `testing.compare.threads` must be a non-negative integer.\n * - `notifications.config` must match its schema (it used to live in `ShelfConfig`, which validated it).\n * - `config.scratchDir` defaults to {@link DEFAULT_SCRATCH_DIR}: publishing extracts zips there,\n *   with or without `testing`.\n */\nexport function resolveShelfOptions(options: ShelfOptions): ShelfOptions {\n  assertThreads(options.testing?.compare?.threads);\n  assertTestingProcess(options.testing);\n  assertTestingBackable(options);\n  assertNotificationsConfig(options.notifications?.config);\n  if (options.config?.scratchDir !== undefined) {\n    return options;\n  }\n  return { ...options, config: { ...options.config, scratchDir: DEFAULT_SCRATCH_DIR } };\n}\n\n/**\n * A `testing` instance renders here, so it needs a database a long-running server can keep.\n */\nfunction assertTestingBackable(options: ShelfOptions): void {\n  if (options.testing === undefined) {\n    return;\n  }\n  if (options.database.metadata.supportsTesting === false) {\n    throw new Error(\n      `The ${options.database.metadata.name} database cannot back testing: it is reachable only ` +\n        `from a platform that ends the process after each request, so nothing would run capture ` +\n        `jobs. Remove the testing option to host Storybooks only, or use a network database ` +\n        `(Turso, Postgres, MySQL, SQLite on a volume).`,\n    );\n  }\n}\n\nfunction assertTestingProcess(testing: ShelfOptions[\"testing\"]): void {\n  if (testing !== undefined && testing.runner === undefined) {\n    throw new Error(\"testing requires testing.runner\");\n  }\n  if (testing?.workerEntry !== undefined && testing.runner === undefined) {\n    throw new Error(\"testing.workerEntry requires testing.runner (it is the in-process fallback)\");\n  }\n  if (testing?.mode === \"fork\" && testing.workerEntry === undefined) {\n    throw new Error('testing.mode \"fork\" requires testing.workerEntry');\n  }\n  assertShardSize(testing);\n  assertTestingNumbers(testing);\n}\n\n/** Numeric `testing` options: concurrency, retries and the Storybook URL rate limit. */\nfunction assertTestingNumbers(testing: ShelfOptions[\"testing\"]): void {\n  assertConcurrency(testing?.concurrency);\n  assertRetries(testing?.retries);\n  assertLeaseSeconds(testing?.leaseSeconds);\n  assertStorybookUrlRateLimit(testing?.storybookUrlRateLimit);\n}\n\n/** A whole number of requests per minute; `0` would refuse every render. */\nfunction assertStorybookUrlRateLimit(limit: number | undefined): void {\n  if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) {\n    throw new Error(\n      `testing.storybookUrlRateLimit must be a positive whole number of requests per minute, got ${String(limit)}`,\n    );\n  }\n}\n\n/** Retries are counted after the first attempt: `0` runs a job once. */\nfunction assertRetries(retries: number | undefined): void {\n  if (retries !== undefined && (!Number.isInteger(retries) || retries < 0)) {\n    throw new Error(`testing.retries must be a non-negative integer, got ${String(retries)}`);\n  }\n}\n\n/** A lease must be a positive length: `0` would expire every job at once. */\nfunction assertLeaseSeconds(seconds: number | undefined): void {\n  if (seconds !== undefined && (!Number.isFinite(seconds) || seconds <= 0)) {\n    throw new Error(\n      `testing.leaseSeconds must be a positive number of seconds, got ${String(seconds)}`,\n    );\n  }\n}\n\n/** `0` would deadlock the consumer. */\nfunction assertConcurrency(concurrency: number | undefined): void {\n  if (concurrency !== undefined && (!Number.isInteger(concurrency) || concurrency < 1)) {\n    throw new Error(`testing.concurrency must be a positive integer, got ${String(concurrency)}`);\n  }\n}\n\nfunction assertShardSize(testing: ShelfOptions[\"testing\"]): void {\n  const size = testing?.shardSize;\n  if (size === undefined) {\n    return;\n  }\n  if (!Number.isInteger(size) || size < 1) {\n    throw new Error(`testing.shardSize must be a positive integer, got ${String(size)}`);\n  }\n  if (testing?.runner === undefined) {\n    throw new Error(\"testing.shardSize requires testing.runner (workers set their own shardSize)\");\n  }\n}\n\nfunction assertThreads(threads: number | undefined): void {\n  if (threads !== undefined && (!Number.isInteger(threads) || threads < 0)) {\n    throw new Error(\n      `testing.compare.threads must be a non-negative integer, got ${String(threads)}`,\n    );\n  }\n}\n\nfunction assertNotificationsConfig(config: unknown): void {\n  if (config === undefined) {\n    return;\n  }\n  const result = notificationsConfigSchema.safeParse(config);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `${i.path.join(\".\")}: ${i.message}`).join(\"; \");\n    throw new Error(`Invalid notifications.config: ${issues}`);\n  }\n}\n"],"mappings":";;;;;;;;;AAMA,MAAa,sBAA8B,KAAK,OAAO,GAAG,YAAY;;;;;;;;;AAUtE,SAAgB,oBAAoB,SAAqC;CACvE,cAAc,QAAQ,SAAS,SAAS,OAAO;CAC/C,qBAAqB,QAAQ,OAAO;CACpC,sBAAsB,OAAO;CAC7B,0BAA0B,QAAQ,eAAe,MAAM;CACvD,IAAI,QAAQ,QAAQ,eAAe,KAAA,GACjC,OAAO;CAET,OAAO;EAAE,GAAG;EAAS,QAAQ;GAAE,GAAG,QAAQ;GAAQ,YAAY;EAAoB;CAAE;AACtF;;;;AAKA,SAAS,sBAAsB,SAA6B;CAC1D,IAAI,QAAQ,YAAY,KAAA,GACtB;CAEF,IAAI,QAAQ,SAAS,SAAS,oBAAoB,OAChD,MAAM,IAAI,MACR,OAAO,QAAQ,SAAS,SAAS,KAAK,4QAIxC;AAEJ;AAEA,SAAS,qBAAqB,SAAwC;CACpE,IAAI,YAAY,KAAA,KAAa,QAAQ,WAAW,KAAA,GAC9C,MAAM,IAAI,MAAM,iCAAiC;CAEnD,IAAI,SAAS,gBAAgB,KAAA,KAAa,QAAQ,WAAW,KAAA,GAC3D,MAAM,IAAI,MAAM,6EAA6E;CAE/F,IAAI,SAAS,SAAS,UAAU,QAAQ,gBAAgB,KAAA,GACtD,MAAM,IAAI,MAAM,oDAAkD;CAEpE,gBAAgB,OAAO;CACvB,qBAAqB,OAAO;AAC9B;;AAGA,SAAS,qBAAqB,SAAwC;CACpE,kBAAkB,SAAS,WAAW;CACtC,cAAc,SAAS,OAAO;CAC9B,mBAAmB,SAAS,YAAY;CACxC,4BAA4B,SAAS,qBAAqB;AAC5D;;AAGA,SAAS,4BAA4B,OAAiC;CACpE,IAAI,UAAU,KAAA,MAAc,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,IAC9D,MAAM,IAAI,MACR,6FAA6F,OAAO,KAAK,GAC3G;AAEJ;;AAGA,SAAS,cAAc,SAAmC;CACxD,IAAI,YAAY,KAAA,MAAc,CAAC,OAAO,UAAU,OAAO,KAAK,UAAU,IACpE,MAAM,IAAI,MAAM,uDAAuD,OAAO,OAAO,GAAG;AAE5F;;AAGA,SAAS,mBAAmB,SAAmC;CAC7D,IAAI,YAAY,KAAA,MAAc,CAAC,OAAO,SAAS,OAAO,KAAK,WAAW,IACpE,MAAM,IAAI,MACR,kEAAkE,OAAO,OAAO,GAClF;AAEJ;;AAGA,SAAS,kBAAkB,aAAuC;CAChE,IAAI,gBAAgB,KAAA,MAAc,CAAC,OAAO,UAAU,WAAW,KAAK,cAAc,IAChF,MAAM,IAAI,MAAM,uDAAuD,OAAO,WAAW,GAAG;AAEhG;AAEA,SAAS,gBAAgB,SAAwC;CAC/D,MAAM,OAAO,SAAS;CACtB,IAAI,SAAS,KAAA,GACX;CAEF,IAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,GACpC,MAAM,IAAI,MAAM,qDAAqD,OAAO,IAAI,GAAG;CAErF,IAAI,SAAS,WAAW,KAAA,GACtB,MAAM,IAAI,MAAM,6EAA6E;AAEjG;AAEA,SAAS,cAAc,SAAmC;CACxD,IAAI,YAAY,KAAA,MAAc,CAAC,OAAO,UAAU,OAAO,KAAK,UAAU,IACpE,MAAM,IAAI,MACR,+DAA+D,OAAO,OAAO,GAC/E;AAEJ;AAEA,SAAS,0BAA0B,QAAuB;CACxD,IAAI,WAAW,KAAA,GACb;CAEF,MAAM,SAAS,0BAA0B,UAAU,MAAM;CACzD,IAAI,CAAC,OAAO,SAAS;EACnB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,IAAI;EAC5F,MAAM,IAAI,MAAM,iCAAiC,QAAQ;CAC3D;AACF"}
+{"version":3,"file":"options.mjs","names":[],"sources":["../src/options.ts"],"sourcesContent":["/** Resolves `ShelfOptions` once at boot: validates `testing.compare` and fills the scratch default. */\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { notificationsConfigSchema, type ShelfOptions } from \"./config.ts\";\n\n/** Where capture scratch lives when `config.scratchDir` is not set. */\nexport const DEFAULT_SCRATCH_DIR: string = join(tmpdir(), \"storyshelf\");\n\n/**\n * Validate and complete the options.\n *\n * - `testing.compare.threads` must be a non-negative integer.\n * - `notifications.config` must match its schema (it used to live in `ShelfConfig`, which validated it).\n * - `config.scratchDir` defaults to {@link DEFAULT_SCRATCH_DIR}: publishing extracts zips there,\n *   with or without `testing`.\n */\nexport function resolveShelfOptions(options: ShelfOptions): ShelfOptions {\n  assertThreads(options.testing?.compare?.threads);\n  assertTestingProcess(options.testing);\n  assertTestingBackable(options);\n  assertNotificationsConfig(options.notifications?.config);\n  if (options.config?.scratchDir !== undefined) {\n    return options;\n  }\n  return { ...options, config: { ...options.config, scratchDir: DEFAULT_SCRATCH_DIR } };\n}\n\n/**\n * A `testing` instance renders here, so it needs a database a long-running server can keep.\n */\nfunction assertTestingBackable(options: ShelfOptions): void {\n  if (options.testing === undefined) {\n    return;\n  }\n  if (options.database.metadata.supportsTesting === false) {\n    throw new Error(\n      `The ${options.database.metadata.name} database cannot back testing: it is reachable only ` +\n        `from a platform that ends the process after each request, so nothing would run capture ` +\n        `jobs. Remove the testing option to host Storybooks only, or use a network database ` +\n        `(Turso, Postgres, MySQL, SQLite on a volume).`,\n    );\n  }\n}\n\nfunction assertTestingProcess(testing: ShelfOptions[\"testing\"]): void {\n  if (testing !== undefined && testing.runner === undefined) {\n    throw new Error(\"testing requires testing.runner\");\n  }\n  if (testing?.workerEntry !== undefined && testing.runner === undefined) {\n    throw new Error(\"testing.workerEntry requires testing.runner (it is the in-process fallback)\");\n  }\n  if (testing?.mode === \"fork\" && testing.workerEntry === undefined) {\n    throw new Error('testing.mode \"fork\" requires testing.workerEntry');\n  }\n  assertShardSize(testing);\n  assertTestingNumbers(testing);\n}\n\n/** Numeric `testing` options: concurrency, retries and the Storybook URL rate limit. */\nfunction assertTestingNumbers(testing: ShelfOptions[\"testing\"]): void {\n  assertConcurrency(testing?.concurrency);\n  assertRetries(testing?.retries);\n  assertLeaseSeconds(testing?.leaseSeconds);\n  assertStorybookUrlRateLimit(testing?.storybookUrlRateLimit);\n}\n\n/** A whole number of requests per minute; `0` would refuse every render. */\nfunction assertStorybookUrlRateLimit(limit: number | undefined): void {\n  if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) {\n    throw new Error(\n      `testing.storybookUrlRateLimit must be a positive whole number of requests per minute, got ${String(limit)}`,\n    );\n  }\n}\n\n/** Retries are counted after the first attempt: `0` runs a job once. */\nfunction assertRetries(retries: number | undefined): void {\n  if (retries !== undefined && (!Number.isInteger(retries) || retries < 0)) {\n    throw new Error(`testing.retries must be a non-negative integer, got ${String(retries)}`);\n  }\n}\n\n/** A lease must be a positive length: `0` would expire every job at once. */\nfunction assertLeaseSeconds(seconds: number | undefined): void {\n  if (seconds !== undefined && (!Number.isFinite(seconds) || seconds <= 0)) {\n    throw new Error(\n      `testing.leaseSeconds must be a positive number of seconds, got ${String(seconds)}`,\n    );\n  }\n}\n\n/** `0` would deadlock the consumer. */\nfunction assertConcurrency(concurrency: number | undefined): void {\n  if (concurrency !== undefined && (!Number.isInteger(concurrency) || concurrency < 1)) {\n    throw new Error(`testing.concurrency must be a positive integer, got ${String(concurrency)}`);\n  }\n}\n\nfunction assertShardSize(testing: ShelfOptions[\"testing\"]): void {\n  const size = testing?.shardSize;\n  if (size === undefined) {\n    return;\n  }\n  if (!Number.isInteger(size) || size < 1) {\n    throw new Error(`testing.shardSize must be a positive integer, got ${String(size)}`);\n  }\n  if (testing?.runner === undefined) {\n    throw new Error(\"testing.shardSize requires testing.runner (workers set their own shardSize)\");\n  }\n}\n\nfunction assertThreads(threads: number | undefined): void {\n  if (threads !== undefined && (!Number.isInteger(threads) || threads < 0)) {\n    throw new Error(\n      `testing.compare.threads must be a non-negative integer, got ${String(threads)}`,\n    );\n  }\n}\n\nfunction assertNotificationsConfig(config: unknown): void {\n  if (config === undefined) {\n    return;\n  }\n  const result = notificationsConfigSchema.safeParse(config);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `${i.path.join(\".\")}: ${i.message}`).join(\"; \");\n    throw new Error(`Invalid notifications.config: ${issues}`);\n  }\n}\n"],"mappings":";;;;;;;;AAMA,MAAa,sBAA8B,KAAK,OAAO,GAAG,YAAY;;;;;;;;;AAUtE,SAAgB,oBAAoB,SAAqC;CACvE,cAAc,QAAQ,SAAS,SAAS,OAAO;CAC/C,qBAAqB,QAAQ,OAAO;CACpC,sBAAsB,OAAO;CAC7B,0BAA0B,QAAQ,eAAe,MAAM;CACvD,IAAI,QAAQ,QAAQ,eAAe,KAAA,GACjC,OAAO;CAET,OAAO;EAAE,GAAG;EAAS,QAAQ;GAAE,GAAG,QAAQ;GAAQ,YAAY;EAAoB;CAAE;AACtF;;;;AAKA,SAAS,sBAAsB,SAA6B;CAC1D,IAAI,QAAQ,YAAY,KAAA,GACtB;CAEF,IAAI,QAAQ,SAAS,SAAS,oBAAoB,OAChD,MAAM,IAAI,MACR,OAAO,QAAQ,SAAS,SAAS,KAAK,4QAIxC;AAEJ;AAEA,SAAS,qBAAqB,SAAwC;CACpE,IAAI,YAAY,KAAA,KAAa,QAAQ,WAAW,KAAA,GAC9C,MAAM,IAAI,MAAM,iCAAiC;CAEnD,IAAI,SAAS,gBAAgB,KAAA,KAAa,QAAQ,WAAW,KAAA,GAC3D,MAAM,IAAI,MAAM,6EAA6E;CAE/F,IAAI,SAAS,SAAS,UAAU,QAAQ,gBAAgB,KAAA,GACtD,MAAM,IAAI,MAAM,oDAAkD;CAEpE,gBAAgB,OAAO;CACvB,qBAAqB,OAAO;AAC9B;;AAGA,SAAS,qBAAqB,SAAwC;CACpE,kBAAkB,SAAS,WAAW;CACtC,cAAc,SAAS,OAAO;CAC9B,mBAAmB,SAAS,YAAY;CACxC,4BAA4B,SAAS,qBAAqB;AAC5D;;AAGA,SAAS,4BAA4B,OAAiC;CACpE,IAAI,UAAU,KAAA,MAAc,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,IAC9D,MAAM,IAAI,MACR,6FAA6F,OAAO,KAAK,GAC3G;AAEJ;;AAGA,SAAS,cAAc,SAAmC;CACxD,IAAI,YAAY,KAAA,MAAc,CAAC,OAAO,UAAU,OAAO,KAAK,UAAU,IACpE,MAAM,IAAI,MAAM,uDAAuD,OAAO,OAAO,GAAG;AAE5F;;AAGA,SAAS,mBAAmB,SAAmC;CAC7D,IAAI,YAAY,KAAA,MAAc,CAAC,OAAO,SAAS,OAAO,KAAK,WAAW,IACpE,MAAM,IAAI,MACR,kEAAkE,OAAO,OAAO,GAClF;AAEJ;;AAGA,SAAS,kBAAkB,aAAuC;CAChE,IAAI,gBAAgB,KAAA,MAAc,CAAC,OAAO,UAAU,WAAW,KAAK,cAAc,IAChF,MAAM,IAAI,MAAM,uDAAuD,OAAO,WAAW,GAAG;AAEhG;AAEA,SAAS,gBAAgB,SAAwC;CAC/D,MAAM,OAAO,SAAS;CACtB,IAAI,SAAS,KAAA,GACX;CAEF,IAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,GACpC,MAAM,IAAI,MAAM,qDAAqD,OAAO,IAAI,GAAG;CAErF,IAAI,SAAS,WAAW,KAAA,GACtB,MAAM,IAAI,MAAM,6EAA6E;AAEjG;AAEA,SAAS,cAAc,SAAmC;CACxD,IAAI,YAAY,KAAA,MAAc,CAAC,OAAO,UAAU,OAAO,KAAK,UAAU,IACpE,MAAM,IAAI,MACR,+DAA+D,OAAO,OAAO,GAC/E;AAEJ;AAEA,SAAS,0BAA0B,QAAuB;CACxD,IAAI,WAAW,KAAA,GACb;CAEF,MAAM,SAAS,0BAA0B,UAAU,MAAM;CACzD,IAAI,CAAC,OAAO,SAAS;EACnB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,IAAI;EAC5F,MAAM,IAAI,MAAM,iCAAiC,QAAQ;CAC3D;AACF"}

package/dist/paths.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/utils/paths.d.ts
 /**
  * Path segment for a mode on a given engine. Chromium keeps the bare mode key
  * so pre-multi-browser objects stay addressable; other engines get `~browser`.
@@ -22,10 +21,11 @@ declare function designRenderPath(projectId: string, provider: string, fileKey:
 declare function baselinePath(projectId: string, branch: string, storyId: string, viewport: string, browser?: string): string;
 /** Storage prefix for an extracted published Storybook. */
 declare function storybookDir(projectId: string, buildId: string): string;
+/** Disposable gzip representation of a content-addressed published file. */
+declare function publishedGzipPath(hash: string): string;
 /** Storage path for an uploaded Storybook zip. */
 declare function storybookZipPath(projectId: string, buildId: string): string;
 /** Storage path of a build's persisted catalog (ADR 0006, decision 9), next to its `storybook/` statics. */
 declare function catalogPath(projectId: string, buildId: string): string;
-//#endregion
-export { baselinePath, catalogPath, contentDir, contentPath, designRenderPath, diffPath, isContentPath, modeSegment, screenshotPath, storybookDir, storybookZipPath };
+export { baselinePath, catalogPath, contentDir, contentPath, designRenderPath, diffPath, isContentPath, modeSegment, publishedGzipPath, screenshotPath, storybookDir, storybookZipPath };
 //# sourceMappingURL=paths.d.mts.map

package/dist/paths.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { isSafeSegment } from "./utils/path-security.mjs";
-//#region src/utils/paths.ts
+// src/utils/paths.ts
 /** Storage path builders. Every segment is validated — a third-party
 * capture runner echoing `story.id = "../../x"` must fail here, not in an
 * adapter with its own key-jailing quirks. */
@@ -82,6 +82,11 @@ function storybookDir(projectId, buildId) {
 	assertSegments([projectId, buildId]);
 	return `${projectId}/builds/${buildId}/storybook`;
 }
+/** Disposable gzip representation of a content-addressed published file. */
+function publishedGzipPath(hash) {
+	if (!/^[a-f0-9]{64}$/u.test(hash)) throw new Error("Invalid published content hash");
+	return `derived/published-gzip/${hash}.gz`;
+}
 /** Storage path for an uploaded Storybook zip. */
 function storybookZipPath(projectId, buildId) {
 	assertSegments([projectId, buildId]);
@@ -92,7 +97,6 @@ function catalogPath(projectId, buildId) {
 	assertSegments([projectId, buildId]);
 	return `${projectId}/builds/${buildId}/catalog.json`;
 }
-//#endregion
-export { baselinePath, catalogPath, contentDir, contentPath, designRenderPath, diffPath, isContentPath, modeSegment, screenshotPath, storybookDir, storybookZipPath };
+export { baselinePath, catalogPath, contentDir, contentPath, designRenderPath, diffPath, isContentPath, modeSegment, publishedGzipPath, screenshotPath, storybookDir, storybookZipPath };
 
 //# sourceMappingURL=paths.mjs.map

package/dist/paths.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"paths.mjs","names":[],"sources":["../src/utils/paths.ts"],"sourcesContent":["/** Storage path builders. Every segment is validated — a third-party\n * capture runner echoing `story.id = \"../../x\"` must fail here, not in an\n * adapter with its own key-jailing quirks. */\nimport { isSafeSegment } from \"./path-security.ts\";\n\n/** Throw when any key segment could escape its storage prefix. */\nfunction assertSegments(segments: string[]): void {\n  const bad = segments.filter((segment) => !isSafeSegment(segment) || segment.length === 0);\n  if (bad.length > 0) {\n    throw new Error(`Unsafe storage path segment: ${bad.join(\",\")}`);\n  }\n}\n/**\n * Path segment for a mode on a given engine. Chromium keeps the bare mode key\n * so pre-multi-browser objects stay addressable; other engines get `~browser`.\n */\nexport function modeSegment(viewport: string, browser?: string): string {\n  return browser && browser !== \"chromium\" ? `${viewport}~${browser}` : viewport;\n}\n\n/** Storage path for a captured snapshot screenshot. */\nexport function screenshotPath(\n  projectId: string,\n  buildId: string,\n  storyId: string,\n  viewport: string,\n  browser?: string,\n): string {\n  const segment = modeSegment(viewport, browser);\n  assertSegments([projectId, buildId, storyId, segment]);\n  return `${projectId}/builds/${buildId}/screenshots/${storyId}/${segment}.png`;\n}\n\n/** Storage prefix of a project's content-addressed screenshots. */\nexport function contentDir(projectId: string): string {\n  assertSegments([projectId]);\n  return `${projectId}/content`;\n}\n\n/** Storage path of a screenshot stored by the SHA-256 of its bytes (shared by builds and baselines). */\nexport function contentPath(projectId: string, hash: string): string {\n  assertSegments([projectId, hash]);\n  return `${contentDir(projectId)}/${hash}.png`;\n}\n\n/** Whether `path` is one of `projectId`'s content-addressed screenshots. */\nexport function isContentPath(projectId: string, path: string): boolean {\n  return path.startsWith(`${contentDir(projectId)}/`) && path.endsWith(\".png\");\n}\n\n/** Storage path for a snapshot diff overlay image. */\nexport function diffPath(\n  projectId: string,\n  buildId: string,\n  storyId: string,\n  viewport: string,\n  browser?: string,\n): string {\n  const segment = modeSegment(viewport, browser);\n  assertSegments([projectId, buildId, storyId, segment]);\n  return `${projectId}/builds/${buildId}/diffs/${storyId}/${segment}.png`;\n}\n\n/** Storage path for a cached design node render (overwritten in place when the file version moves). */\nexport function designRenderPath(\n  projectId: string,\n  provider: string,\n  fileKey: string,\n  nodeId: string,\n  viewerId = \"\",\n): string {\n  const node = nodeId.replaceAll(\":\", \"-\");\n  assertSegments([projectId, provider, fileKey, node, ...(viewerId ? [viewerId] : [])]);\n  const owner = viewerId ? `user-${viewerId}/` : \"\";\n  return `${projectId}/design/${provider}/${owner}${fileKey}/${node}.png`;\n}\n\n/** Storage path for a branch baseline screenshot. */\nexport function baselinePath(\n  projectId: string,\n  branch: string,\n  storyId: string,\n  viewport: string,\n  browser?: string,\n): string {\n  const segment = modeSegment(viewport, browser);\n  assertSegments([projectId, branch, storyId, segment]);\n  return `${projectId}/baselines/${branch}/${storyId}/${segment}.png`;\n}\n\n/** Storage prefix for an extracted published Storybook. */\nexport function storybookDir(projectId: string, buildId: string): string {\n  assertSegments([projectId, buildId]);\n  return `${projectId}/builds/${buildId}/storybook`;\n}\n\n/** Storage path for an uploaded Storybook zip. */\nexport function storybookZipPath(projectId: string, buildId: string): string {\n  assertSegments([projectId, buildId]);\n  return `${projectId}/builds/${buildId}/storybook.zip`;\n}\n\n/** Storage path of a build's persisted catalog (ADR 0006, decision 9), next to its `storybook/` statics. */\nexport function catalogPath(projectId: string, buildId: string): string {\n  assertSegments([projectId, buildId]);\n  return `${projectId}/builds/${buildId}/catalog.json`;\n}\n"],"mappings":";;;;;;;;;AAMA,SAAS,eAAe,UAA0B;CAChD,MAAM,MAAM,SAAS,QAAQ,YAAY,CAAC,cAAc,OAAO,KAAK,QAAQ,WAAW,CAAC;CACxF,IAAI,IAAI,SAAS,GACf,MAAM,IAAI,MAAM,gCAAgC,IAAI,KAAK,GAAG,GAAG;AAEnE;;;;;AAKA,SAAgB,YAAY,UAAkB,SAA0B;CACtE,OAAO,WAAW,YAAY,aAAa,GAAG,SAAS,GAAG,YAAY;AACxE;;AAGA,SAAgB,eACd,WACA,SACA,SACA,UACA,SACQ;CACR,MAAM,UAAU,YAAY,UAAU,OAAO;CAC7C,eAAe;EAAC;EAAW;EAAS;EAAS;CAAO,CAAC;CACrD,OAAO,GAAG,UAAU,UAAU,QAAQ,eAAe,QAAQ,GAAG,QAAQ;AAC1E;;AAGA,SAAgB,WAAW,WAA2B;CACpD,eAAe,CAAC,SAAS,CAAC;CAC1B,OAAO,GAAG,UAAU;AACtB;;AAGA,SAAgB,YAAY,WAAmB,MAAsB;CACnE,eAAe,CAAC,WAAW,IAAI,CAAC;CAChC,OAAO,GAAG,WAAW,SAAS,EAAE,GAAG,KAAK;AAC1C;;AAGA,SAAgB,cAAc,WAAmB,MAAuB;CACtE,OAAO,KAAK,WAAW,GAAG,WAAW,SAAS,EAAE,EAAE,KAAK,KAAK,SAAS,MAAM;AAC7E;;AAGA,SAAgB,SACd,WACA,SACA,SACA,UACA,SACQ;CACR,MAAM,UAAU,YAAY,UAAU,OAAO;CAC7C,eAAe;EAAC;EAAW;EAAS;EAAS;CAAO,CAAC;CACrD,OAAO,GAAG,UAAU,UAAU,QAAQ,SAAS,QAAQ,GAAG,QAAQ;AACpE;;AAGA,SAAgB,iBACd,WACA,UACA,SACA,QACA,WAAW,IACH;CACR,MAAM,OAAO,OAAO,WAAW,KAAK,GAAG;CACvC,eAAe;EAAC;EAAW;EAAU;EAAS;EAAM,GAAI,WAAW,CAAC,QAAQ,IAAI,CAAC;CAAE,CAAC;CAEpF,OAAO,GAAG,UAAU,UAAU,SAAS,GADzB,WAAW,QAAQ,SAAS,KAAK,KACG,QAAQ,GAAG,KAAK;AACpE;;AAGA,SAAgB,aACd,WACA,QACA,SACA,UACA,SACQ;CACR,MAAM,UAAU,YAAY,UAAU,OAAO;CAC7C,eAAe;EAAC;EAAW;EAAQ;EAAS;CAAO,CAAC;CACpD,OAAO,GAAG,UAAU,aAAa,OAAO,GAAG,QAAQ,GAAG,QAAQ;AAChE;;AAGA,SAAgB,aAAa,WAAmB,SAAyB;CACvE,eAAe,CAAC,WAAW,OAAO,CAAC;CACnC,OAAO,GAAG,UAAU,UAAU,QAAQ;AACxC;;AAGA,SAAgB,iBAAiB,WAAmB,SAAyB;CAC3E,eAAe,CAAC,WAAW,OAAO,CAAC;CACnC,OAAO,GAAG,UAAU,UAAU,QAAQ;AACxC;;AAGA,SAAgB,YAAY,WAAmB,SAAyB;CACtE,eAAe,CAAC,WAAW,OAAO,CAAC;CACnC,OAAO,GAAG,UAAU,UAAU,QAAQ;AACxC"}
+{"version":3,"file":"paths.mjs","names":[],"sources":["../src/utils/paths.ts"],"sourcesContent":["/** Storage path builders. Every segment is validated — a third-party\n * capture runner echoing `story.id = \"../../x\"` must fail here, not in an\n * adapter with its own key-jailing quirks. */\nimport { isSafeSegment } from \"./path-security.ts\";\n\n/** Throw when any key segment could escape its storage prefix. */\nfunction assertSegments(segments: string[]): void {\n  const bad = segments.filter((segment) => !isSafeSegment(segment) || segment.length === 0);\n  if (bad.length > 0) {\n    throw new Error(`Unsafe storage path segment: ${bad.join(\",\")}`);\n  }\n}\n/**\n * Path segment for a mode on a given engine. Chromium keeps the bare mode key\n * so pre-multi-browser objects stay addressable; other engines get `~browser`.\n */\nexport function modeSegment(viewport: string, browser?: string): string {\n  return browser && browser !== \"chromium\" ? `${viewport}~${browser}` : viewport;\n}\n\n/** Storage path for a captured snapshot screenshot. */\nexport function screenshotPath(\n  projectId: string,\n  buildId: string,\n  storyId: string,\n  viewport: string,\n  browser?: string,\n): string {\n  const segment = modeSegment(viewport, browser);\n  assertSegments([projectId, buildId, storyId, segment]);\n  return `${projectId}/builds/${buildId}/screenshots/${storyId}/${segment}.png`;\n}\n\n/** Storage prefix of a project's content-addressed screenshots. */\nexport function contentDir(projectId: string): string {\n  assertSegments([projectId]);\n  return `${projectId}/content`;\n}\n\n/** Storage path of a screenshot stored by the SHA-256 of its bytes (shared by builds and baselines). */\nexport function contentPath(projectId: string, hash: string): string {\n  assertSegments([projectId, hash]);\n  return `${contentDir(projectId)}/${hash}.png`;\n}\n\n/** Whether `path` is one of `projectId`'s content-addressed screenshots. */\nexport function isContentPath(projectId: string, path: string): boolean {\n  return path.startsWith(`${contentDir(projectId)}/`) && path.endsWith(\".png\");\n}\n\n/** Storage path for a snapshot diff overlay image. */\nexport function diffPath(\n  projectId: string,\n  buildId: string,\n  storyId: string,\n  viewport: string,\n  browser?: string,\n): string {\n  const segment = modeSegment(viewport, browser);\n  assertSegments([projectId, buildId, storyId, segment]);\n  return `${projectId}/builds/${buildId}/diffs/${storyId}/${segment}.png`;\n}\n\n/** Storage path for a cached design node render (overwritten in place when the file version moves). */\nexport function designRenderPath(\n  projectId: string,\n  provider: string,\n  fileKey: string,\n  nodeId: string,\n  viewerId = \"\",\n): string {\n  const node = nodeId.replaceAll(\":\", \"-\");\n  assertSegments([projectId, provider, fileKey, node, ...(viewerId ? [viewerId] : [])]);\n  const owner = viewerId ? `user-${viewerId}/` : \"\";\n  return `${projectId}/design/${provider}/${owner}${fileKey}/${node}.png`;\n}\n\n/** Storage path for a branch baseline screenshot. */\nexport function baselinePath(\n  projectId: string,\n  branch: string,\n  storyId: string,\n  viewport: string,\n  browser?: string,\n): string {\n  const segment = modeSegment(viewport, browser);\n  assertSegments([projectId, branch, storyId, segment]);\n  return `${projectId}/baselines/${branch}/${storyId}/${segment}.png`;\n}\n\n/** Storage prefix for an extracted published Storybook. */\nexport function storybookDir(projectId: string, buildId: string): string {\n  assertSegments([projectId, buildId]);\n  return `${projectId}/builds/${buildId}/storybook`;\n}\n\n/** Disposable gzip representation of a content-addressed published file. */\nexport function publishedGzipPath(hash: string): string {\n  if (!/^[a-f0-9]{64}$/u.test(hash)) throw new Error(\"Invalid published content hash\");\n  return `derived/published-gzip/${hash}.gz`;\n}\n\n/** Storage path for an uploaded Storybook zip. */\nexport function storybookZipPath(projectId: string, buildId: string): string {\n  assertSegments([projectId, buildId]);\n  return `${projectId}/builds/${buildId}/storybook.zip`;\n}\n\n/** Storage path of a build's persisted catalog (ADR 0006, decision 9), next to its `storybook/` statics. */\nexport function catalogPath(projectId: string, buildId: string): string {\n  assertSegments([projectId, buildId]);\n  return `${projectId}/builds/${buildId}/catalog.json`;\n}\n"],"mappings":";;;;;;;;;AAMA,SAAS,eAAe,UAA0B;CAChD,MAAM,MAAM,SAAS,QAAQ,YAAY,CAAC,cAAc,OAAO,KAAK,QAAQ,WAAW,CAAC;CACxF,IAAI,IAAI,SAAS,GACf,MAAM,IAAI,MAAM,gCAAgC,IAAI,KAAK,GAAG,GAAG;AAEnE;;;;;AAKA,SAAgB,YAAY,UAAkB,SAA0B;CACtE,OAAO,WAAW,YAAY,aAAa,GAAG,SAAS,GAAG,YAAY;AACxE;;AAGA,SAAgB,eACd,WACA,SACA,SACA,UACA,SACQ;CACR,MAAM,UAAU,YAAY,UAAU,OAAO;CAC7C,eAAe;EAAC;EAAW;EAAS;EAAS;CAAO,CAAC;CACrD,OAAO,GAAG,UAAU,UAAU,QAAQ,eAAe,QAAQ,GAAG,QAAQ;AAC1E;;AAGA,SAAgB,WAAW,WAA2B;CACpD,eAAe,CAAC,SAAS,CAAC;CAC1B,OAAO,GAAG,UAAU;AACtB;;AAGA,SAAgB,YAAY,WAAmB,MAAsB;CACnE,eAAe,CAAC,WAAW,IAAI,CAAC;CAChC,OAAO,GAAG,WAAW,SAAS,EAAE,GAAG,KAAK;AAC1C;;AAGA,SAAgB,cAAc,WAAmB,MAAuB;CACtE,OAAO,KAAK,WAAW,GAAG,WAAW,SAAS,EAAE,EAAE,KAAK,KAAK,SAAS,MAAM;AAC7E;;AAGA,SAAgB,SACd,WACA,SACA,SACA,UACA,SACQ;CACR,MAAM,UAAU,YAAY,UAAU,OAAO;CAC7C,eAAe;EAAC;EAAW;EAAS;EAAS;CAAO,CAAC;CACrD,OAAO,GAAG,UAAU,UAAU,QAAQ,SAAS,QAAQ,GAAG,QAAQ;AACpE;;AAGA,SAAgB,iBACd,WACA,UACA,SACA,QACA,WAAW,IACH;CACR,MAAM,OAAO,OAAO,WAAW,KAAK,GAAG;CACvC,eAAe;EAAC;EAAW;EAAU;EAAS;EAAM,GAAI,WAAW,CAAC,QAAQ,IAAI,CAAC;CAAE,CAAC;CAEpF,OAAO,GAAG,UAAU,UAAU,SAAS,GADzB,WAAW,QAAQ,SAAS,KAAK,KACG,QAAQ,GAAG,KAAK;AACpE;;AAGA,SAAgB,aACd,WACA,QACA,SACA,UACA,SACQ;CACR,MAAM,UAAU,YAAY,UAAU,OAAO;CAC7C,eAAe;EAAC;EAAW;EAAQ;EAAS;CAAO,CAAC;CACpD,OAAO,GAAG,UAAU,aAAa,OAAO,GAAG,QAAQ,GAAG,QAAQ;AAChE;;AAGA,SAAgB,aAAa,WAAmB,SAAyB;CACvE,eAAe,CAAC,WAAW,OAAO,CAAC;CACnC,OAAO,GAAG,UAAU,UAAU,QAAQ;AACxC;;AAGA,SAAgB,kBAAkB,MAAsB;CACtD,IAAI,CAAC,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,MAAM,gCAAgC;CACnF,OAAO,0BAA0B,KAAK;AACxC;;AAGA,SAAgB,iBAAiB,WAAmB,SAAyB;CAC3E,eAAe,CAAC,WAAW,OAAO,CAAC;CACnC,OAAO,GAAG,UAAU,UAAU,QAAQ;AACxC;;AAGA,SAAgB,YAAY,WAAmB,SAAyB;CACtE,eAAe,CAAC,WAAW,OAAO,CAAC;CACnC,OAAO,GAAG,UAAU,UAAU,QAAQ;AACxC"}

package/dist/retention/ai.d.mts

@@ -1,8 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Logger } from "../logger.mjs";
-//#region src/retention/ai.d.ts
+import { DatabaseAdapter } from "../adapter/database.mjs";
 /** Pending/running rows older than this are marked `interrupted`. */
 declare const STALE_RUN_MS: number;
 /** What one AI retention pass removed. */
@@ -13,6 +12,5 @@ interface AiPurgeResult {
 }
 /** Run one AI retention pass (safe to call from any instance, any time). */
 declare function purgeAiData(db: DatabaseAdapter, now?: Date, logger?: Logger): Promise<AiPurgeResult>;
-//#endregion
 export { AiPurgeResult, STALE_RUN_MS, purgeAiData };
 //# sourceMappingURL=ai.d.mts.map

package/dist/retention/ai.mjs

@@ -17,7 +17,6 @@ async function purgeAiData(db, now = /* @__PURE__ */ new Date(), logger) {
 	if (result.health > 0 || result.usage > 0 || result.interrupted > 0) logger?.info(result, "ai data retention pass complete");
 	return result;
 }
-//#endregion
 export { STALE_RUN_MS, purgeAiData };
 
 //# sourceMappingURL=ai.mjs.map

package/dist/retention/pending.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { BuildModel } from "../models/build.mjs";
 import { BuildReviewModel } from "../models/build-review.mjs";
 import { CommentModel } from "../models/comment.mjs";
-//#region src/retention/pending.ts
+// src/retention/pending.ts
 /**
 * The project's pending builds whose last activity (upload, comment or verdict) is before
 * `cutoff`. `capture_attempts` need no check: a build capture worked on leaves `pending`.
@@ -41,7 +41,6 @@ function stampOf(item) {
 function hasNewerOnBranch(all, build) {
 	return all.some((other) => other.id !== build.id && other.gitBranch === build.gitBranch && other.createdAt > build.createdAt);
 }
-//#endregion
 export { pendingCandidates };
 
 //# sourceMappingURL=pending.mjs.map

package/dist/retention/published-gzip-sweep.mjs

@@ -0,0 +1,28 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/retention/published-gzip-sweep.ts
+const PREFIX = "derived/published-gzip/";
+const MAX_PER_SWEEP = 128;
+const cursors = /* @__PURE__ */ new WeakMap();
+/** Reclaim disposable orphan variants; never delete content or other storage keys. */
+async function sweepPublishedGzip(storage) {
+	const keys = (await storage.list(PREFIX)).filter((key) => /^derived\/published-gzip\/[a-f0-9]{64}\.gz$/u.test(key)).toSorted();
+	if (keys.length === 0) return;
+	const cursor = cursors.get(storage);
+	const next = cursor ? keys.findIndex((key) => key > cursor) : 0;
+	const start = Math.max(0, next);
+	const batch = [...keys.slice(start), ...keys.slice(0, start)].slice(0, MAX_PER_SWEEP);
+	for (const key of batch) await removeOrphan(storage, key);
+	const last = batch.at(-1);
+	if (last) cursors.set(storage, last);
+}
+async function removeOrphan(storage, key) {
+	const hash = key.slice(23, -3);
+	try {
+		if (!await storage.exists(`content/${hash}`)) await storage.delete(key);
+	} catch {}
+}
+export { sweepPublishedGzip };
+
+//# sourceMappingURL=published-gzip-sweep.mjs.map

package/dist/retention/published-gzip-sweep.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"published-gzip-sweep.mjs","names":[],"sources":["../../src/retention/published-gzip-sweep.ts"],"sourcesContent":["import type { StorageAdapter } from \"../adapters/storage.ts\";\n\nconst PREFIX = \"derived/published-gzip/\";\nconst MAX_PER_SWEEP = 128;\nconst cursors = new WeakMap<StorageAdapter, string>();\n\n/** Reclaim disposable orphan variants; never delete content or other storage keys. */\nexport async function sweepPublishedGzip(storage: StorageAdapter): Promise<void> {\n  const keys = (await storage.list(PREFIX))\n    .filter((key) => /^derived\\/published-gzip\\/[a-f0-9]{64}\\.gz$/u.test(key))\n    .toSorted();\n  if (keys.length === 0) return;\n  const cursor = cursors.get(storage);\n  const next = cursor ? keys.findIndex((key) => key > cursor) : 0;\n  const start = Math.max(0, next);\n  const batch = [...keys.slice(start), ...keys.slice(0, start)].slice(0, MAX_PER_SWEEP);\n  for (const key of batch) {\n    // oxlint-disable-next-line eslint/no-await-in-loop -- bounded, sequential storage work\n    await removeOrphan(storage, key);\n  }\n  const last = batch.at(-1);\n  if (last) cursors.set(storage, last);\n}\n\nasync function removeOrphan(storage: StorageAdapter, key: string): Promise<void> {\n  const hash = key.slice(PREFIX.length, -3);\n  try {\n    if (!(await storage.exists(`content/${hash}`))) await storage.delete(key);\n  } catch {\n    // Retention is best effort; a missing variant can always be regenerated.\n  }\n}\n"],"mappings":";;;;AAEA,MAAM,SAAS;AACf,MAAM,gBAAgB;AACtB,MAAM,0BAAU,IAAI,QAAgC;;AAGpD,eAAsB,mBAAmB,SAAwC;CAC/E,MAAM,QAAQ,MAAM,QAAQ,KAAK,MAAM,EAAA,CACpC,QAAQ,QAAQ,+CAA+C,KAAK,GAAG,CAAC,CAAC,CACzE,SAAS;CACZ,IAAI,KAAK,WAAW,GAAG;CACvB,MAAM,SAAS,QAAQ,IAAI,OAAO;CAClC,MAAM,OAAO,SAAS,KAAK,WAAW,QAAQ,MAAM,MAAM,IAAI;CAC9D,MAAM,QAAQ,KAAK,IAAI,GAAG,IAAI;CAC9B,MAAM,QAAQ,CAAC,GAAG,KAAK,MAAM,KAAK,GAAG,GAAG,KAAK,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,aAAa;CACpF,KAAK,MAAM,OAAO,OAEhB,MAAM,aAAa,SAAS,GAAG;CAEjC,MAAM,OAAO,MAAM,GAAG,EAAE;CACxB,IAAI,MAAM,QAAQ,IAAI,SAAS,IAAI;AACrC;AAEA,eAAe,aAAa,SAAyB,KAA4B;CAC/E,MAAM,OAAO,IAAI,MAAM,IAAe,EAAE;CACxC,IAAI;EACF,IAAI,CAAE,MAAM,QAAQ,OAAO,WAAW,MAAM,GAAI,MAAM,QAAQ,OAAO,GAAG;CAC1E,QAAQ,CAER;AACF"}

package/dist/retention/screenshot-sweep.d.mts

@@ -4,7 +4,6 @@ import { DatabaseAdapter } from "../adapter/database.mjs";
 import { StorageAdapter } from "../adapter/storage.mjs";
 import { Logger } from "pino";
 import { Table } from "drizzle-orm";
-//#region src/retention/screenshot-sweep.d.ts
 /** Longest an unreferenced screenshot is kept after the sweep first sees it (default 24 h). */
 declare const SWEEP_GRACE_MS: number;
 /** Tables the sweep reads references and in-flight builds from. */
@@ -46,6 +45,5 @@ declare function sweepScreenshotContent(deps: SweepDeps, projectId: string, opti
   now?: number;
   graceMs?: number;
 }): Promise<SweepResult>;
-//#endregion
 export { SWEEP_GRACE_MS, SweepDeps, SweepResult, SweepTables, sweepScreenshotContent };
 //# sourceMappingURL=screenshot-sweep.d.mts.map

package/dist/retention/screenshot-sweep.mjs

@@ -5,7 +5,7 @@ import { col } from "../models/columns.mjs";
 import { contentDir } from "../paths.mjs";
 import { CLAIMS_DIR } from "../utils/screenshot-store.mjs";
 import { and, eq, gte, inArray, like } from "drizzle-orm";
-//#region src/retention/screenshot-sweep.ts
+// src/retention/screenshot-sweep.ts
 /** Mark-and-sweep for a project's content-addressed screenshots. */
 /** Longest an unreferenced screenshot is kept after the sweep first sees it (default 24 h). */
 const SWEEP_GRACE_MS = 864e5;
@@ -122,7 +122,6 @@ async function readMarker(storage, dir) {
 async function writeMarker(storage, dir, next, previous) {
 	if (JSON.stringify(next) !== JSON.stringify(previous)) await storage.write(`${dir}${MARKER}`, Buffer.from(JSON.stringify(next)));
 }
-//#endregion
 export { SWEEP_GRACE_MS, sweepScreenshotContent };
 
 //# sourceMappingURL=screenshot-sweep.mjs.map

package/dist/retention.d.mts

@@ -7,7 +7,6 @@ import { SWEEP_GRACE_MS, SweepDeps, SweepResult, SweepTables, sweepScreenshotCon
 import { AiPurgeResult, STALE_RUN_MS, purgeAiData } from "./retention/ai.mjs";
 import { Logger } from "pino";
 import { Table } from "drizzle-orm";
-//#region src/retention/purge.d.ts
 /** Table handles for retention queries. */
 interface RetentionTables {
   builds: Table;
@@ -54,6 +53,5 @@ interface BranchGcResult {
   removedBranches: number;
   removedBaselines: number;
 }
-//#endregion
 export { type AiPurgeResult, BranchGcResult, PurgeOptions, PurgeResult, Retention, RetentionTables, STALE_RUN_MS, SWEEP_GRACE_MS, type SweepDeps, type SweepResult, type SweepTables, purgeAiData, sweepScreenshotContent };
 //# sourceMappingURL=retention.d.mts.map

package/dist/retention.mjs

@@ -4,6 +4,7 @@ import.meta.url;
 import { TERMINAL_BUILD_STATUSES } from "./types.mjs";
 import { col } from "./models/columns.mjs";
 import { BuildModel } from "./models/build.mjs";
+import { publishedGzipPath } from "./paths.mjs";
 import { BaselineModel } from "./models/baseline.mjs";
 import { CaptureJobModel } from "./models/capture-job.mjs";
 import { BuildComponentModel } from "./models/build-component.mjs";
@@ -11,10 +12,11 @@ import { InsightModel } from "./models/insight.mjs";
 import { LabelModel } from "./models/label.mjs";
 import { PackageUsageModel } from "./models/usage.mjs";
 import { pendingCandidates } from "./retention/pending.mjs";
+import { sweepPublishedGzip } from "./retention/published-gzip-sweep.mjs";
 import { SWEEP_GRACE_MS, sweepScreenshotContent } from "./retention/screenshot-sweep.mjs";
 import { STALE_RUN_MS, purgeAiData } from "./retention/ai.mjs";
 import { and, desc, eq, inArray, lt } from "drizzle-orm";
-//#region src/retention/purge.ts
+// src/retention/purge.ts
 /** Removes expired transient builds while keeping baselines and persistent builds. */
 var Retention = class {
 	db;
@@ -153,9 +155,11 @@ var Retention = class {
 			const all = await this.db.list(contentRefs);
 			for (const row of all) if (row.refCount === 0 && row.lastSeenAt < cutoff) {
 				await this.storage.delete(`content/${row.hash}`).catch(() => {});
+				if (/^[a-f0-9]{64}$/u.test(row.hash)) await this.storage.delete(publishedGzipPath(row.hash)).catch(() => {});
 				await this.db.remove(contentRefs, row.hash);
 			}
 		} catch {}
+		await sweepPublishedGzip(this.storage).catch(() => {});
 		return files.length;
 	}
 	async purgeStaleBranches(project, ttlDays) {
@@ -196,7 +200,6 @@ function branchLatestAt(rows) {
 	}
 	return latestAt;
 }
-//#endregion
 export { Retention, STALE_RUN_MS, SWEEP_GRACE_MS, purgeAiData, sweepScreenshotContent };
 
 //# sourceMappingURL=retention.mjs.map