@storyshelf/core 0.7.0 → 0.8.0

package/dist/models/baseline.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"baseline.mjs","names":[],"sources":["../../src/models/baseline.ts"],"sourcesContent":["/* oxlint-disable typescript/promise-function-async -- map callbacks return promises from async helpers */\n/** Per-branch baseline screenshots with default-branch fallback. */\nimport { and, eq } 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 { StorageAdapter } from \"../adapters/storage.ts\";\nimport { emitWebhookEvent } from \"../adapters/webhook-events.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { isContentPath } from \"../utils/paths.ts\";\nimport { storeScreenshot, withContentClaim } from \"../utils/screenshot-store.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\nimport type { WebhookTables } from \"./webhook.ts\";\n\n/** Extra identity/metadata for {@link BaselineModel.upsert}. */\nexport interface BaselineUpsertOptions {\n  /** Engine the baseline belongs to (default chromium). */\n  browser?: string;\n  /** Resolved mode definition as JSON (display only). */\n  mode?: string | null;\n  /** JSON `Fingerprint` behind the `infraHash` being written. */\n  fingerprint?: string | null;\n}\n\n/** Tables required by {@link BaselineModel}. */\nexport interface BaselineTables {\n  baselines: Table;\n}\n\n/** Data operations for baseline screenshots. */\nexport class BaselineModel {\n  private readonly tables: BaselineTables;\n  private readonly storage: StorageAdapter;\n  private readonly secret?: SecretInput;\n  private readonly webhookTables?: WebhookTables;\n  private readonly db: DatabaseAdapter;\n\n  constructor(\n    db: DatabaseAdapter,\n    tables?: BaselineTables,\n    storage?: StorageAdapter,\n    secret?: SecretInput,\n    webhookTables?: WebhookTables,\n  ) {\n    this.db = db;\n    this.tables = tables ?? { baselines: db.tables.baselines };\n    this.storage = storage as StorageAdapter;\n    this.secret = secret;\n    this.webhookTables = webhookTables;\n  }\n\n  async getFor(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    browser: string = DEFAULT_BROWSER,\n  ): Promise<Baseline | null> {\n    const rows = (await this.db.list(this.tables.baselines, {\n      where: and(\n        eq(col(this.tables.baselines, \"projectId\"), projectId),\n        eq(col(this.tables.baselines, \"storyId\"), storyId),\n        eq(col(this.tables.baselines, \"viewportName\"), viewport),\n        eq(col(this.tables.baselines, \"branch\"), branch),\n        eq(col(this.tables.baselines, \"browser\"), browser),\n      ),\n      limit: 1,\n    })) as unknown as Baseline[];\n    return rows[0] ?? null;\n  }\n\n  async resolve(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    defaultBranch: string,\n    browser: string = DEFAULT_BROWSER,\n  ): Promise<Baseline | null> {\n    if (branch !== defaultBranch) {\n      const own = await this.getFor(projectId, storyId, viewport, branch, browser);\n      if (own) {\n        return own;\n      }\n    }\n    return this.getFor(projectId, storyId, viewport, defaultBranch, browser);\n  }\n\n  /** Whether the project has any baseline captured on this engine. */\n  async hasAny(projectId: string, browser: string): Promise<boolean> {\n    const rows = (await this.db.list(this.tables.baselines, {\n      where: and(\n        eq(col(this.tables.baselines, \"projectId\"), projectId),\n        eq(col(this.tables.baselines, \"browser\"), browser),\n      ),\n      limit: 1,\n    })) as unknown as Baseline[];\n    return rows.length > 0;\n  }\n\n  /**\n   * Record the fingerprint of a baseline that predates fingerprints, without touching its\n   * screenshot. Lets the next environment change be detected instead of diffing as a regression.\n   */\n  async backfillFingerprint(\n    baseline: Baseline,\n    infraHash: string,\n    fingerprint: string,\n  ): Promise<void> {\n    await this.db.update(this.tables.baselines, baseline.id, { infraHash, fingerprint });\n  }\n\n  /**\n   * The content-addressed object a baseline should point at. A source that already is one is\n   * reused as is (no copy); a legacy per-build path is stored once by content.\n   */\n  private async contentFor(projectId: string, sourcePath: string): Promise<string> {\n    if (isContentPath(projectId, sourcePath)) {\n      return sourcePath;\n    }\n    return await storeScreenshot(this.storage, projectId, await this.storage.read(sourcePath));\n  }\n\n  async read(baseline: Baseline): Promise<Buffer> {\n    return await this.storage.read(baseline.screenshotPath);\n  }\n\n  async upsert(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    snapshotId: string,\n    sourcePath: string,\n    infraHash?: string | null,\n    options: BaselineUpsertOptions = {},\n  ): Promise<Baseline> {\n    const write = async (): Promise<Baseline> =>\n      await this.#upsertAt(\n        projectId,\n        storyId,\n        viewport,\n        branch,\n        snapshotId,\n        await this.contentFor(projectId, sourcePath),\n        infraHash,\n        options,\n      );\n    // Storing a legacy source may reuse an object the sweep is about to delete: claim it until the\n    // row points at it. A content source is already referenced by its snapshot row.\n    return isContentPath(projectId, sourcePath)\n      ? await write()\n      : await withContentClaim(this.storage, projectId, write);\n  }\n\n  async #upsertAt(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    snapshotId: string,\n    screenshotPath: string,\n    infraHash: string | null | undefined,\n    options: BaselineUpsertOptions,\n  ): Promise<Baseline> {\n    const browser = options.browser ?? DEFAULT_BROWSER;\n\n    const existing = await this.getFor(projectId, storyId, viewport, branch, browser);\n    let baseline: Baseline;\n    if (existing) {\n      baseline = (await this.db.update(this.tables.baselines, existing.id, {\n        snapshotId,\n        screenshotPath,\n        infraHash: infraHash ?? existing.infraHash ?? null,\n        fingerprint: options.fingerprint ?? existing.fingerprint ?? null,\n        mode: options.mode ?? existing.mode ?? null,\n        updatedAt: new Date().toISOString(),\n      })) as unknown as Baseline;\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          \"baseline:updated\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            browser,\n            mode: options.mode ?? null,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n    } else {\n      const now = new Date().toISOString();\n      baseline = (await this.db.insert(this.tables.baselines, {\n        id: ulid(),\n        projectId,\n        storyId,\n        viewportName: viewport,\n        branch,\n        snapshotId,\n        screenshotPath,\n        infraHash: infraHash ?? null,\n        fingerprint: options.fingerprint ?? null,\n        mode: options.mode ?? null,\n        browser,\n        createdAt: now,\n        updatedAt: now,\n      })) as unknown as Baseline;\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          \"baseline:created\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            browser,\n            mode: options.mode ?? null,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n    }\n    return baseline;\n  }\n\n  async list(projectId: string): Promise<Baseline[]> {\n    return (await this.db.list(this.tables.baselines, {\n      where: eq(col(this.tables.baselines, \"projectId\"), projectId),\n    })) as unknown as Baseline[];\n  }\n\n  /**\n   * Delete a baseline's own file. A content-addressed screenshot is shared with snapshots and other\n   * baselines, so it is left for the retention sweep instead.\n   */\n  private async discardFile(baseline: Baseline): Promise<void> {\n    if (isContentPath(baseline.projectId, baseline.screenshotPath)) {\n      return;\n    }\n    try {\n      await this.storage.delete(baseline.screenshotPath);\n    } catch {\n      // ignore missing file\n    }\n  }\n\n  async removeOrphans(projectId: string, validStoryIds: Set<string>): Promise<number> {\n    const all = await this.list(projectId);\n    const toRemove = all.filter((baseline) => !validStoryIds.has(baseline.storyId));\n    await Promise.all(\n      toRemove.map(async (baseline) => {\n        await this.discardFile(baseline);\n        await this.db.remove(this.tables.baselines, baseline.id);\n      }),\n    );\n    return toRemove.length;\n  }\n\n  async removeForBranch(projectId: string, branch: string): Promise<number> {\n    const all = await this.list(projectId);\n    const toRemove = all.filter((baseline) => baseline.branch === branch);\n    await Promise.all(\n      toRemove.map(async (baseline) => {\n        await this.discardFile(baseline);\n        await this.db.remove(this.tables.baselines, baseline.id);\n      }),\n    );\n    return toRemove.length;\n  }\n\n  // oxlint-disable-next-line eslint/require-await -- delegates to async removeForBranch via Promise.all\n  async removeStaleBranches(\n    projectId: string,\n    staleBranches: ReadonlySet<string>,\n  ): Promise<number> {\n    if (staleBranches.size === 0) {\n      return 0;\n    }\n    const results = await Promise.all(\n      [...staleBranches].map((branch) => this.removeForBranch(projectId, branch)),\n    );\n    return results.reduce((sum, count) => sum + count, 0);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"baseline.mjs","names":[],"sources":["../../src/models/baseline.ts"],"sourcesContent":["/* oxlint-disable typescript/promise-function-async -- map callbacks return promises from async helpers */\n/** Per-branch baseline screenshots with default-branch fallback. */\nimport { and, eq } 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 { StorageAdapter } from \"../adapters/storage.ts\";\nimport { emitWebhookEvent } from \"../adapters/webhook-events.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { Snapshot } from \"../schema/snapshot.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { isContentPath } from \"../utils/paths.ts\";\nimport { storeScreenshot, withContentClaim } from \"../utils/screenshot-store.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { approveInTransaction, type AtomicBaselineApproval } from \"./baseline-approval.ts\";\nimport { upsertAtomicBaseline } from \"./baseline-atomic.ts\";\nimport { BaselineWriteConflict } from \"./baseline-conflict.ts\";\nimport { col } from \"./columns.ts\";\nimport type { WebhookTables } from \"./webhook.ts\";\n\n/** Extra identity/metadata for {@link BaselineModel.upsert}. */\nexport interface BaselineUpsertOptions {\n  approval?: AtomicBaselineApproval;\n  /** Engine the baseline belongs to (default chromium). */\n  browser?: string;\n  /** Resolved mode definition as JSON (display only). */\n  mode?: string | null;\n  /** JSON `Fingerprint` behind the `infraHash` being written. */\n  fingerprint?: string | null;\n}\n\n/** Tables required by {@link BaselineModel}. */\nexport interface BaselineTables {\n  baselines: Table;\n}\n\n/** Data operations for baseline screenshots. */\nexport class BaselineModel {\n  private readonly tables: BaselineTables;\n  private readonly storage: StorageAdapter;\n  private readonly secret?: SecretInput;\n  private readonly webhookTables?: WebhookTables;\n  private readonly db: DatabaseAdapter;\n\n  constructor(\n    db: DatabaseAdapter,\n    tables?: BaselineTables,\n    storage?: StorageAdapter,\n    secret?: SecretInput,\n    webhookTables?: WebhookTables,\n  ) {\n    this.db = db;\n    this.tables = tables ?? { baselines: db.tables.baselines };\n    this.storage = storage as StorageAdapter;\n    this.secret = secret;\n    this.webhookTables = webhookTables;\n  }\n\n  async getFor(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    browser: string = DEFAULT_BROWSER,\n  ): Promise<Baseline | null> {\n    const rows = (await this.db.list(this.tables.baselines, {\n      where: and(\n        eq(col(this.tables.baselines, \"projectId\"), projectId),\n        eq(col(this.tables.baselines, \"storyId\"), storyId),\n        eq(col(this.tables.baselines, \"viewportName\"), viewport),\n        eq(col(this.tables.baselines, \"branch\"), branch),\n        eq(col(this.tables.baselines, \"browser\"), browser),\n      ),\n      limit: 1,\n    })) as unknown as Baseline[];\n    return rows[0] ?? null;\n  }\n\n  async resolve(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    defaultBranch: string,\n    browser: string = DEFAULT_BROWSER,\n  ): Promise<Baseline | null> {\n    if (branch !== defaultBranch) {\n      const own = await this.getFor(projectId, storyId, viewport, branch, browser);\n      if (own) {\n        return own;\n      }\n    }\n    return this.getFor(projectId, storyId, viewport, defaultBranch, browser);\n  }\n\n  /** Whether the project has any baseline captured on this engine. */\n  async hasAny(projectId: string, browser: string): Promise<boolean> {\n    const rows = (await this.db.list(this.tables.baselines, {\n      where: and(\n        eq(col(this.tables.baselines, \"projectId\"), projectId),\n        eq(col(this.tables.baselines, \"browser\"), browser),\n      ),\n      limit: 1,\n    })) as unknown as Baseline[];\n    return rows.length > 0;\n  }\n\n  /**\n   * Record the fingerprint of a baseline that predates fingerprints, without touching its\n   * screenshot. Lets the next environment change be detected instead of diffing as a regression.\n   */\n  async backfillFingerprint(\n    baseline: Baseline,\n    infraHash: string,\n    fingerprint: string,\n  ): Promise<void> {\n    const lifecycle = this.db.buildReferenceLifecycle;\n    if (lifecycle) {\n      const owner = { type: \"baseline\" as const, id: baseline.id, projectId: baseline.projectId };\n      const generation = await lifecycle.referenceGeneration(owner);\n      await lifecycle.replaceFencedReferences(\n        owner,\n        generation,\n        baseline.sourceBuildId ? [baseline.sourceBuildId] : [],\n        async (tx) => {\n          const current = (await tx.get(\n            this.tables.baselines,\n            baseline.id,\n          )) as unknown as Baseline | null;\n          if (\n            !current ||\n            current.projectId !== baseline.projectId ||\n            current.updatedAt !== baseline.updatedAt ||\n            current.sourceBuildId !== baseline.sourceBuildId ||\n            current.screenshotPath !== baseline.screenshotPath ||\n            current.fingerprint !== baseline.fingerprint\n          )\n            throw new BaselineWriteConflict(\"Baseline changed during fingerprint backfill; retry\");\n          await tx.update(this.tables.baselines, baseline.id, { infraHash, fingerprint });\n        },\n      );\n      return;\n    }\n    await this.db.update(this.tables.baselines, baseline.id, { infraHash, fingerprint });\n  }\n\n  /**\n   * The content-addressed object a baseline should point at. A source that already is one is\n   * reused as is (no copy); a legacy per-build path is stored once by content.\n   */\n  private async contentFor(projectId: string, sourcePath: string): Promise<string> {\n    if (isContentPath(projectId, sourcePath)) {\n      return sourcePath;\n    }\n    return await storeScreenshot(this.storage, projectId, await this.storage.read(sourcePath));\n  }\n\n  async read(baseline: Baseline): Promise<Buffer> {\n    return await this.storage.read(baseline.screenshotPath);\n  }\n\n  async upsert(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    snapshotId: string,\n    sourcePath: string,\n    infraHash?: string | null,\n    options: BaselineUpsertOptions = {},\n  ): Promise<Baseline> {\n    const sourceBuildId = await this.sourceBuildId(\n      projectId,\n      storyId,\n      viewport,\n      snapshotId,\n      sourcePath,\n      options.browser,\n    );\n    const write = async (): Promise<Baseline> =>\n      await this.#upsertAt(\n        projectId,\n        storyId,\n        viewport,\n        branch,\n        snapshotId,\n        sourceBuildId,\n        sourcePath,\n        await this.contentFor(projectId, sourcePath),\n        infraHash,\n        options,\n      );\n    // Storing a legacy source may reuse an object the sweep is about to delete: claim it until the\n    // row points at it. A content source is already referenced by its snapshot row.\n    return isContentPath(projectId, sourcePath)\n      ? await write()\n      : await withContentClaim(this.storage, projectId, write);\n  }\n\n  private async sourceBuildId(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    snapshotId: string,\n    sourcePath: string,\n    browser: string = DEFAULT_BROWSER,\n  ): Promise<string | null> {\n    const snapshot = (await this.db.get(\n      this.db.tables.snapshots,\n      snapshotId,\n    )) as unknown as Snapshot | null;\n    if (\n      !snapshot ||\n      snapshot.projectId !== projectId ||\n      snapshot.storyId !== storyId ||\n      snapshot.viewportName !== viewport ||\n      (snapshot.browser ?? DEFAULT_BROWSER) !== browser ||\n      snapshot.screenshotPath !== sourcePath\n    )\n      return null;\n    return snapshot.inherited ? (snapshot.sourceBuildId ?? null) : snapshot.buildId;\n  }\n\n  async #upsertAt(\n    projectId: string,\n    storyId: string,\n    viewport: string,\n    branch: string,\n    snapshotId: string,\n    sourceBuildId: string | null,\n    originalPath: string,\n    screenshotPath: string,\n    infraHash: string | null | undefined,\n    options: BaselineUpsertOptions,\n  ): Promise<Baseline> {\n    const browser = options.browser ?? DEFAULT_BROWSER;\n\n    const existing = await this.getFor(projectId, storyId, viewport, branch, browser);\n    const lifecycle = this.db.buildReferenceLifecycle;\n    if (lifecycle) {\n      const approval = options.approval;\n      const baseline = await upsertAtomicBaseline(\n        lifecycle,\n        { baselines: this.tables.baselines, snapshots: this.db.tables.snapshots },\n        {\n          id: existing?.id ?? ulid(),\n          existingId: existing?.id ?? null,\n          existingVersion: existing?.updatedAt ?? null,\n          projectId,\n          storyId,\n          viewport,\n          branch,\n          browser,\n          snapshotId,\n          sourceBuildId,\n          originalPath,\n          screenshotPath,\n          infraHash,\n          fingerprint: options.fingerprint,\n          mode: options.mode,\n          beforeWrite: approval\n            ? async (tx): Promise<void> => await approveInTransaction(tx, this.db.tables, approval)\n            : undefined,\n        },\n      );\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          existing ? \"baseline:updated\" : \"baseline:created\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            browser,\n            mode: options.mode ?? null,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n      return baseline;\n    }\n    let baseline: Baseline;\n    if (existing) {\n      baseline = (await this.db.update(this.tables.baselines, existing.id, {\n        snapshotId,\n        sourceBuildId,\n        screenshotPath,\n        infraHash: infraHash ?? existing.infraHash ?? null,\n        fingerprint: options.fingerprint ?? existing.fingerprint ?? null,\n        mode: options.mode ?? existing.mode ?? null,\n        updatedAt: new Date().toISOString(),\n      })) as unknown as Baseline;\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          \"baseline:updated\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            browser,\n            mode: options.mode ?? null,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n    } else {\n      const now = new Date().toISOString();\n      baseline = (await this.db.insert(this.tables.baselines, {\n        id: ulid(),\n        projectId,\n        storyId,\n        viewportName: viewport,\n        branch,\n        snapshotId,\n        sourceBuildId,\n        screenshotPath,\n        infraHash: infraHash ?? null,\n        fingerprint: options.fingerprint ?? null,\n        mode: options.mode ?? null,\n        browser,\n        createdAt: now,\n        updatedAt: now,\n      })) as unknown as Baseline;\n      if (this.webhookTables) {\n        await emitWebhookEvent(\n          this.db,\n          this.webhookTables,\n          projectId,\n          \"baseline:created\",\n          {\n            baselineId: baseline.id,\n            storyId,\n            viewport,\n            browser,\n            mode: options.mode ?? null,\n            branch,\n            snapshotId,\n          },\n          this.secret,\n        );\n      }\n    }\n    return baseline;\n  }\n\n  async list(projectId: string): Promise<Baseline[]> {\n    return (await this.db.list(this.tables.baselines, {\n      where: eq(col(this.tables.baselines, \"projectId\"), projectId),\n    })) as unknown as Baseline[];\n  }\n\n  /**\n   * Delete a baseline's own file. A content-addressed screenshot is shared with snapshots and other\n   * baselines, so it is left for the retention sweep instead.\n   */\n  private async discardFile(baseline: Baseline): Promise<void> {\n    if (isContentPath(baseline.projectId, baseline.screenshotPath)) {\n      return;\n    }\n    try {\n      await this.storage.delete(baseline.screenshotPath);\n    } catch {\n      // ignore missing file\n    }\n  }\n\n  /** Drop the reference and row together when the adapter supports lifecycle protection. */\n  private async removeRecord(baseline: Baseline): Promise<void> {\n    const lifecycle = this.db.buildReferenceLifecycle;\n    if (lifecycle) {\n      const owner = { type: \"baseline\" as const, projectId: baseline.projectId, id: baseline.id };\n      const generation = await lifecycle.referenceGeneration(owner);\n      await lifecycle.replaceFencedReferences(owner, generation, [], async (tx) => {\n        const current = (await tx.get(\n          this.tables.baselines,\n          baseline.id,\n        )) as unknown as Baseline | null;\n        if (!current) return;\n        if (\n          current.updatedAt !== baseline.updatedAt ||\n          current.snapshotId !== baseline.snapshotId ||\n          current.sourceBuildId !== baseline.sourceBuildId ||\n          current.screenshotPath !== baseline.screenshotPath\n        ) {\n          throw new BaselineWriteConflict(\"Baseline changed during removal; retry\");\n        }\n        await tx.remove(this.tables.baselines, baseline.id);\n      });\n      await this.discardFile(baseline);\n      return;\n    }\n    await this.discardFile(baseline);\n    await this.db.remove(this.tables.baselines, baseline.id);\n  }\n\n  async removeOrphans(projectId: string, validStoryIds: Set<string>): Promise<number> {\n    const all = await this.list(projectId);\n    const toRemove = all.filter((baseline) => !validStoryIds.has(baseline.storyId));\n    await Promise.all(toRemove.map(async (baseline) => await this.removeRecord(baseline)));\n    return toRemove.length;\n  }\n\n  async removeForBranch(projectId: string, branch: string): Promise<number> {\n    const all = await this.list(projectId);\n    const toRemove = all.filter((baseline) => baseline.branch === branch);\n    await Promise.all(toRemove.map(async (baseline) => await this.removeRecord(baseline)));\n    return toRemove.length;\n  }\n\n  // oxlint-disable-next-line eslint/require-await -- delegates to async removeForBranch via Promise.all\n  async removeStaleBranches(\n    projectId: string,\n    staleBranches: ReadonlySet<string>,\n  ): Promise<number> {\n    if (staleBranches.size === 0) {\n      return 0;\n    }\n    const results = await Promise.all(\n      [...staleBranches].map((branch) => this.removeForBranch(projectId, branch)),\n    );\n    return results.reduce((sum, count) => sum + count, 0);\n  }\n}\n"],"mappings":"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"}

package/dist/models/build-component.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { BuildComponent } from "../schema/build-component.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/build-component.d.ts
 /** Tables required by {@link BuildComponentModel}. */
 interface BuildComponentTables {
   buildComponents: Table;
@@ -23,6 +22,5 @@ declare class BuildComponentModel {
   /** Forget a build's rows (the foreign key cascades too; stub tables have none). */
   removeForBuild(buildId: string): Promise<number>;
 }
-//#endregion
 export { BuildComponentInput, BuildComponentModel, BuildComponentTables };
 //# sourceMappingURL=build-component.d.mts.map

package/dist/models/build-component.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, asc, desc, eq } from "drizzle-orm";
-//#region src/models/build-component.ts
+// src/models/build-component.ts
 /** Component rows of published builds (`build_components`, ADR 0006 decision 9). */
 /** Data operations for the components each published build holds. */
 var BuildComponentModel = class {
@@ -49,7 +49,6 @@ var BuildComponentModel = class {
 		return rows.length;
 	}
 };
-//#endregion
 export { BuildComponentModel };
 
 //# sourceMappingURL=build-component.mjs.map

package/dist/models/build-review-status.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { BuildReview } from "../schema/build-review.mjs";
-//#region src/models/build-review-status.d.ts
 /** What {@link deriveReviewStatus} depends on. */
 interface ReviewStatusInput {
   /** `testing` is on: the snapshot rollup decides and verdicts never gate. */
@@ -24,6 +23,5 @@ interface ReviewStatusInput {
 declare function deriveReviewStatus(input: ReviewStatusInput): "approved" | "rejected" | "pending" | null;
 /** Each reviewer's latest verdict (newest `createdAt`, then newest id), oldest reviewer first. */
 declare function latestVerdicts<T extends Pick<BuildReview, "id" | "userId" | "createdAt">>(reviews: readonly T[]): T[];
-//#endregion
 export { ReviewStatusInput, deriveReviewStatus, latestVerdicts };
 //# sourceMappingURL=build-review-status.d.mts.map

package/dist/models/build-review-status.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/models/build-review-status.ts
+// src/models/build-review-status.ts
 /** Reviewer key standing for verdicts without a user (auth off or an admin token): one reviewer. */
 const ANONYMOUS_REVIEWER = "";
 /**
@@ -31,7 +31,6 @@ function latestVerdicts(reviews) {
 function isNewer(a, b) {
 	return a.createdAt === b.createdAt ? a.id > b.id : a.createdAt > b.createdAt;
 }
-//#endregion
 export { deriveReviewStatus, latestVerdicts };
 
 //# sourceMappingURL=build-review-status.mjs.map

package/dist/models/build-review.d.mts

@@ -4,7 +4,6 @@ import { DatabaseAdapter } from "../adapter/database.mjs";
 import { ReviewVerdict } from "../types.mjs";
 import { BuildReview } from "../schema/build-review.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/build-review.d.ts
 /** Tables required by {@link BuildReviewModel}. */
 interface BuildReviewTables {
   buildReviews: Table;
@@ -23,6 +22,5 @@ declare class BuildReviewModel {
   /** Each reviewer's latest verdict on a build. */
   latestByBuild(buildId: string): Promise<BuildReview[]>;
 }
-//#endregion
 export { BuildReviewModel, BuildReviewTables };
 //# sourceMappingURL=build-review.d.mts.map

package/dist/models/build-review.mjs

@@ -5,7 +5,7 @@ import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { latestVerdicts } from "./build-review-status.mjs";
 import { asc, eq } from "drizzle-orm";
-//#region src/models/build-review.ts
+// src/models/build-review.ts
 /** Build-level review verdicts (ADR 0013, decision 3). */
 /** Data operations for the verdicts reviewers give a build. */
 var BuildReviewModel = class {
@@ -48,7 +48,6 @@ function after(newest) {
 	const floor = newest === void 0 ? Number.NEGATIVE_INFINITY : Date.parse(newest) + 1;
 	return new Date(Math.max(now, floor)).toISOString();
 }
-//#endregion
 export { BuildReviewModel };
 
 //# sourceMappingURL=build-review.mjs.map

package/dist/models/build.d.mts

@@ -1,11 +1,10 @@
 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";
+import { DatabaseAdapter } from "../adapter/database.mjs";
 import { BuildStatus } from "../types.mjs";
 import { Build } from "../schema/build.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/build.d.ts
 /** Tables required by {@link BuildModel}. */
 interface BuildTables {
   builds: Table;
@@ -104,6 +103,5 @@ interface BuildListFilter {
   /** Newest builds to return at most. */
   limit?: number;
 }
-//#endregion
 export { AffectedComputation, BuildCreateInput, BuildListFilter, BuildModel, BuildTables, isPublicBuild };
 //# sourceMappingURL=build.d.mts.map

package/dist/models/build.mjs

@@ -3,8 +3,8 @@ import "node:url";
 import.meta.url;
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
-import { and, desc, eq, inArray } from "drizzle-orm";
-//#region src/models/build.ts
+import { and, desc, eq, inArray, ne } from "drizzle-orm";
+// src/models/build.ts
 /** Build records, status transitions, and publication helpers. */
 /** Data operations for build records. */
 var BuildModel = class {
@@ -79,20 +79,20 @@ var BuildModel = class {
 	* the build. Only {@link BuildModel.resetStatus} leaves `cancelled`.
 	*/
 	async update(id, patch, options = {}) {
-		if (patch.status !== void 0 && patch.status !== "cancelled" && options.reset !== true) {
-			const current = await this.get(id);
-			if (current?.status === "cancelled") {
-				this.logger?.debug({
-					buildId: id,
-					refused: patch.status
-				}, "build is cancelled; status write refused");
-				return current;
-			}
-		}
-		return await this.db.update(this.tables.builds, id, {
+		const values = {
 			...patch,
 			updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-		});
+		};
+		if (patch.status !== void 0 && patch.status !== "cancelled" && options.reset !== true) {
+			const current = await this.db.updateWhere(this.tables.builds, id, values, ne(col(this.tables.builds, "status"), "cancelled"));
+			if (!current) throw new Error("Build not found");
+			if (current.status === "cancelled") this.logger?.debug({
+				buildId: id,
+				refused: patch.status
+			}, "build is cancelled; status write refused");
+			return current;
+		}
+		return await this.db.update(this.tables.builds, id, values);
 	}
 	async setStatus(id, status) {
 		return await this.update(id, { status });
@@ -180,7 +180,6 @@ function parsePaths(raw) {
 		return null;
 	}
 }
-//#endregion
 export { BuildModel, isPublicBuild };
 
 //# sourceMappingURL=build.mjs.map

package/dist/models/build.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build.mjs","names":[],"sources":["../../src/models/build.ts"],"sourcesContent":["/** Build records, status transitions, and publication helpers. */\nimport { and, desc, eq, inArray } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { Logger } from \"../logger.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { BuildStatus } from \"../types.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\n\n/** Tables required by {@link BuildModel}. */\nexport interface BuildTables {\n  builds: Table;\n  buildLabels: Table;\n  snapshots: Table;\n}\n\n/** Data operations for build records. */\nexport class BuildModel {\n  private readonly tables: BuildTables;\n  private readonly db: DatabaseAdapter;\n  private readonly logger: Logger | undefined;\n\n  /** `logger` only reports a status write refused by a `cancelled` build, at debug. */\n  constructor(db: DatabaseAdapter, tables?: BuildTables, logger?: Logger) {\n    this.db = db;\n    this.logger = logger;\n    this.tables = tables ?? {\n      builds: db.tables.builds,\n      buildLabels: db.tables.buildLabels,\n      snapshots: db.tables.snapshots,\n    };\n  }\n\n  async create(projectId: string, input: BuildCreateInput): Promise<Build> {\n    const now = new Date().toISOString();\n    return (await this.db.insert(this.tables.builds, {\n      id: ulid(),\n      projectId,\n      gitSha: input.gitSha,\n      gitBranch: input.gitBranch,\n      isDefault: input.isDefault ?? false,\n      authorEmail: input.authorEmail,\n      authorName: input.authorName,\n      message: input.message,\n      public: input.public ?? false,\n      affectedOnly: input.affectedOnly ?? true,\n      baselineSha: input.baselineSha ?? null,\n      changedFiles: serializePaths(input.changedFiles),\n      affectedImportPaths: serializePaths(input.affectedImportPaths),\n      status: \"pending\",\n      createdAt: now,\n      updatedAt: now,\n    })) as unknown as Build;\n  }\n\n  async get(id: string): Promise<Build | null> {\n    return (await this.db.get(this.tables.builds, id)) as unknown as Build | null;\n  }\n\n  async list(projectId: string, filter: BuildListFilter = {}): Promise<Build[]> {\n    const conditions = [eq(col(this.tables.builds, \"projectId\"), projectId)];\n    if (filter.status) {\n      conditions.push(eq(col(this.tables.builds, \"status\"), filter.status));\n    }\n    if (filter.branch) {\n      conditions.push(eq(col(this.tables.builds, \"gitBranch\"), filter.branch));\n    }\n    if (filter.labelKey && filter.labelValue) {\n      const labels = (await this.db.list(this.tables.buildLabels, {\n        where: and(\n          eq(col(this.tables.buildLabels, \"projectId\"), projectId),\n          eq(col(this.tables.buildLabels, \"typeKey\"), filter.labelKey),\n          eq(col(this.tables.buildLabels, \"value\"), filter.labelValue),\n        ),\n      })) as unknown as { buildId: string }[];\n      const ids = labels.map((l) => l.buildId);\n      if (ids.length === 0) {\n        return [];\n      }\n      conditions.push(inArray(col(this.tables.builds, \"id\"), ids));\n    }\n    return (await this.db.list(this.tables.builds, {\n      where: and(...conditions),\n      orderBy: desc(col(this.tables.builds, \"createdAt\")),\n      ...(filter.limit === undefined ? {} : { limit: filter.limit }),\n    })) as unknown as Build[];\n  }\n\n  /**\n   * Return the build a project-slug Storybook link resolves to: the most recent\n   * `approved` build on the project's default branch. Approved builds on other\n   * branches never qualify (their PR can still be dismissed), and neither do\n   * pending, failed, or unreviewed default-branch builds. Visibility (public or\n   * authenticated) is checked separately by the caller.\n   */\n  async latestApprovedDefault(project: {\n    id: string;\n    gitDefaultBranch: string;\n  }): Promise<Build | null> {\n    const rows = await this.list(project.id, {\n      branch: project.gitDefaultBranch,\n      status: \"approved\",\n    });\n    return rows[0] ?? null;\n  }\n\n  /**\n   * Patch a build. A `cancelled` build is terminal (ADR 0006): a patch that carries another status\n   * is refused, the row is returned as it is, so a capture that ends after a cancel cannot move\n   * the build. Only {@link BuildModel.resetStatus} leaves `cancelled`.\n   */\n  async update(\n    id: string,\n    patch: Partial<Pick<Build, \"status\" | \"public\" | \"message\" | \"authorEmail\" | \"authorName\">>,\n    options: { reset?: boolean } = {},\n  ): Promise<Build> {\n    if (patch.status !== undefined && patch.status !== \"cancelled\" && options.reset !== true) {\n      const current = await this.get(id);\n      if (current?.status === \"cancelled\") {\n        this.logger?.debug(\n          { buildId: id, refused: patch.status },\n          \"build is cancelled; status write refused\",\n        );\n        return current;\n      }\n    }\n    return (await this.db.update(this.tables.builds, id, {\n      ...patch,\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  async setStatus(id: string, status: BuildStatus): Promise<Build> {\n    return await this.update(id, { status });\n  }\n\n  /**\n   * Put a finished build back to `status` for a retry. The one write that leaves `cancelled`\n   * (a user chose it), so it skips the terminal guard of {@link BuildModel.update}.\n   */\n  async resetStatus(id: string, status: BuildStatus): Promise<Build> {\n    return await this.update(id, { status }, { reset: true });\n  }\n\n  /**\n   * Record the affected-capture computation for a build. Idempotent: the CLI\n   * posts this once after creating the build and before uploading the bundle.\n   */\n  async setAffected(id: string, input: AffectedComputation): Promise<Build> {\n    return (await this.db.update(this.tables.builds, id, {\n      baselineSha: input.baselineSha,\n      changedFiles: serializePaths(input.changedFiles),\n      affectedImportPaths: serializePaths(input.affectedImportPaths),\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  /**\n   * Store the results of the build's `.test()` entries (`TestResult[]`, as JSON), or clear them\n   * with null. Written once per capture run, by the run that ran the tests.\n   */\n  async setTestResults(id: string, results: readonly unknown[] | null): Promise<Build> {\n    return (await this.db.update(this.tables.builds, id, {\n      testResults: results === null ? null : JSON.stringify(results),\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  /**\n   * Parse a build's affected import paths. Returns `null` for full capture\n   * (no computation, or an unreadable payload) — callers render everything.\n   */\n  static affectedPaths(build: Pick<Build, \"affectedImportPaths\">): string[] | null {\n    return parsePaths(build.affectedImportPaths);\n  }\n\n  async updateCounts(id: string): Promise<Build> {\n    const rows = (await this.db.list(this.tables.snapshots, {\n      where: eq(col(this.tables.snapshots, \"buildId\"), id),\n    })) as unknown as { status: string; inherited: boolean }[];\n    const snapshotCount = rows.length;\n    const changedCount = rows.filter((s) => s.status === \"changed\" || s.status === \"new\").length;\n    const approvedCount = rows.filter(\n      (s) => s.status === \"approved\" || s.status === \"unchanged\",\n    ).length;\n    const rejectedCount = rows.filter((s) => s.status === \"rejected\").length;\n    const inheritedCount = rows.filter((s) => s.inherited).length;\n    return (await this.db.update(this.tables.builds, id, {\n      snapshotCount,\n      changedCount,\n      approvedCount,\n      rejectedCount,\n      inheritedCount,\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  async remove(id: string): Promise<void> {\n    await this.db.remove(this.tables.builds, id);\n  }\n}\n\n/**\n * Return whether a build is publicly viewable without a session.\n *\n * A build is public iff `builds.public` is set or its branch matches the\n * project's `public_branch_regex` (ADR 0011). Supplying an empty/nonexistent\n * regex makes every build require auth.\n */\nexport function isPublicBuild(\n  project: { publicBranchRegex: string | null },\n  build: Pick<Build, \"public\" | \"gitBranch\">,\n): boolean {\n  if (build.public) {\n    return true;\n  }\n  if (!project.publicBranchRegex) {\n    return false;\n  }\n  return new RegExp(project.publicBranchRegex, \"u\").test(build.gitBranch);\n}\n\n/** Input for creating a build. */\nexport interface BuildCreateInput {\n  gitSha: string;\n  gitBranch: string;\n  isDefault?: boolean;\n  authorEmail?: string;\n  authorName?: string;\n  message?: string;\n  public?: boolean;\n  affectedOnly?: boolean;\n  baselineSha?: string | null;\n  changedFiles?: string[] | null;\n  affectedImportPaths?: string[] | null;\n}\n\n/** Affected-capture computation posted after build creation. */\nexport interface AffectedComputation {\n  baselineSha: string | null;\n  changedFiles: string[];\n  affectedImportPaths: string[] | null;\n}\n\n/** Serialize an optional path list to its JSON text form (or null). */\nfunction serializePaths(paths: string[] | null | undefined): string | null {\n  if (!paths) {\n    return null;\n  }\n  return JSON.stringify(paths);\n}\n\n/** Parse a JSON path list; null (full capture) on missing/invalid input. */\nfunction parsePaths(raw: string | null): string[] | null {\n  if (!raw) {\n    return null;\n  }\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    return Array.isArray(parsed) && parsed.every((entry) => typeof entry === \"string\")\n      ? (parsed as string[])\n      : null;\n  } catch {\n    return null;\n  }\n}\n\n/** Filter options for listing builds. */\nexport interface BuildListFilter {\n  status?: BuildStatus;\n  branch?: string;\n  labelKey?: string;\n  labelValue?: string;\n  /** Newest builds to return at most. */\n  limit?: number;\n}\n"],"mappings":";;;;;;;;;AAkBA,IAAa,aAAb,MAAwB;CACtB;CACA;CACA;;CAGA,YAAY,IAAqB,QAAsB,QAAiB;EACtE,KAAK,KAAK;EACV,KAAK,SAAS;EACd,KAAK,SAAS,UAAU;GACtB,QAAQ,GAAG,OAAO;GAClB,aAAa,GAAG,OAAO;GACvB,WAAW,GAAG,OAAO;EACvB;CACF;CAEA,MAAM,OAAO,WAAmB,OAAyC;EACvE,MAAM,uBAAM,IAAI,KAAK,EAAA,CAAE,YAAY;EACnC,OAAQ,MAAM,KAAK,GAAG,OAAO,KAAK,OAAO,QAAQ;GAC/C,IAAI,KAAK;GACT;GACA,QAAQ,MAAM;GACd,WAAW,MAAM;GACjB,WAAW,MAAM,aAAa;GAC9B,aAAa,MAAM;GACnB,YAAY,MAAM;GAClB,SAAS,MAAM;GACf,QAAQ,MAAM,UAAU;GACxB,cAAc,MAAM,gBAAgB;GACpC,aAAa,MAAM,eAAe;GAClC,cAAc,eAAe,MAAM,YAAY;GAC/C,qBAAqB,eAAe,MAAM,mBAAmB;GAC7D,QAAQ;GACR,WAAW;GACX,WAAW;EACb,CAAC;CACH;CAEA,MAAM,IAAI,IAAmC;EAC3C,OAAQ,MAAM,KAAK,GAAG,IAAI,KAAK,OAAO,QAAQ,EAAE;CAClD;CAEA,MAAM,KAAK,WAAmB,SAA0B,CAAC,GAAqB;EAC5E,MAAM,aAAa,CAAC,GAAG,IAAI,KAAK,OAAO,QAAQ,WAAW,GAAG,SAAS,CAAC;EACvE,IAAI,OAAO,QACT,WAAW,KAAK,GAAG,IAAI,KAAK,OAAO,QAAQ,QAAQ,GAAG,OAAO,MAAM,CAAC;EAEtE,IAAI,OAAO,QACT,WAAW,KAAK,GAAG,IAAI,KAAK,OAAO,QAAQ,WAAW,GAAG,OAAO,MAAM,CAAC;EAEzE,IAAI,OAAO,YAAY,OAAO,YAAY;GAQxC,MAAM,OAAM,MAPU,KAAK,GAAG,KAAK,KAAK,OAAO,aAAa,EAC1D,OAAO,IACL,GAAG,IAAI,KAAK,OAAO,aAAa,WAAW,GAAG,SAAS,GACvD,GAAG,IAAI,KAAK,OAAO,aAAa,SAAS,GAAG,OAAO,QAAQ,GAC3D,GAAG,IAAI,KAAK,OAAO,aAAa,OAAO,GAAG,OAAO,UAAU,CAC7D,EACF,CAAC,EAAA,CACkB,KAAK,MAAM,EAAE,OAAO;GACvC,IAAI,IAAI,WAAW,GACjB,OAAO,CAAC;GAEV,WAAW,KAAK,QAAQ,IAAI,KAAK,OAAO,QAAQ,IAAI,GAAG,GAAG,CAAC;EAC7D;EACA,OAAQ,MAAM,KAAK,GAAG,KAAK,KAAK,OAAO,QAAQ;GAC7C,OAAO,IAAI,GAAG,UAAU;GACxB,SAAS,KAAK,IAAI,KAAK,OAAO,QAAQ,WAAW,CAAC;GAClD,GAAI,OAAO,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,OAAO,MAAM;EAC9D,CAAC;CACH;;;;;;;;CASA,MAAM,sBAAsB,SAGF;EAKxB,QAAO,MAJY,KAAK,KAAK,QAAQ,IAAI;GACvC,QAAQ,QAAQ;GAChB,QAAQ;EACV,CAAC,EAAA,CACW,MAAM;CACpB;;;;;;CAOA,MAAM,OACJ,IACA,OACA,UAA+B,CAAC,GAChB;EAChB,IAAI,MAAM,WAAW,KAAA,KAAa,MAAM,WAAW,eAAe,QAAQ,UAAU,MAAM;GACxF,MAAM,UAAU,MAAM,KAAK,IAAI,EAAE;GACjC,IAAI,SAAS,WAAW,aAAa;IACnC,KAAK,QAAQ,MACX;KAAE,SAAS;KAAI,SAAS,MAAM;IAAO,GACrC,0CACF;IACA,OAAO;GACT;EACF;EACA,OAAQ,MAAM,KAAK,GAAG,OAAO,KAAK,OAAO,QAAQ,IAAI;GACnD,GAAG;GACH,4BAAW,IAAI,KAAK,EAAA,CAAE,YAAY;EACpC,CAAC;CACH;CAEA,MAAM,UAAU,IAAY,QAAqC;EAC/D,OAAO,MAAM,KAAK,OAAO,IAAI,EAAE,OAAO,CAAC;CACzC;;;;;CAMA,MAAM,YAAY,IAAY,QAAqC;EACjE,OAAO,MAAM,KAAK,OAAO,IAAI,EAAE,OAAO,GAAG,EAAE,OAAO,KAAK,CAAC;CAC1D;;;;;CAMA,MAAM,YAAY,IAAY,OAA4C;EACxE,OAAQ,MAAM,KAAK,GAAG,OAAO,KAAK,OAAO,QAAQ,IAAI;GACnD,aAAa,MAAM;GACnB,cAAc,eAAe,MAAM,YAAY;GAC/C,qBAAqB,eAAe,MAAM,mBAAmB;GAC7D,4BAAW,IAAI,KAAK,EAAA,CAAE,YAAY;EACpC,CAAC;CACH;;;;;CAMA,MAAM,eAAe,IAAY,SAAoD;EACnF,OAAQ,MAAM,KAAK,GAAG,OAAO,KAAK,OAAO,QAAQ,IAAI;GACnD,aAAa,YAAY,OAAO,OAAO,KAAK,UAAU,OAAO;GAC7D,4BAAW,IAAI,KAAK,EAAA,CAAE,YAAY;EACpC,CAAC;CACH;;;;;CAMA,OAAO,cAAc,OAA4D;EAC/E,OAAO,WAAW,MAAM,mBAAmB;CAC7C;CAEA,MAAM,aAAa,IAA4B;EAC7C,MAAM,OAAQ,MAAM,KAAK,GAAG,KAAK,KAAK,OAAO,WAAW,EACtD,OAAO,GAAG,IAAI,KAAK,OAAO,WAAW,SAAS,GAAG,EAAE,EACrD,CAAC;EACD,MAAM,gBAAgB,KAAK;EAC3B,MAAM,eAAe,KAAK,QAAQ,MAAM,EAAE,WAAW,aAAa,EAAE,WAAW,KAAK,CAAC,CAAC;EACtF,MAAM,gBAAgB,KAAK,QACxB,MAAM,EAAE,WAAW,cAAc,EAAE,WAAW,WACjD,CAAC,CAAC;EACF,MAAM,gBAAgB,KAAK,QAAQ,MAAM,EAAE,WAAW,UAAU,CAAC,CAAC;EAClE,MAAM,iBAAiB,KAAK,QAAQ,MAAM,EAAE,SAAS,CAAC,CAAC;EACvD,OAAQ,MAAM,KAAK,GAAG,OAAO,KAAK,OAAO,QAAQ,IAAI;GACnD;GACA;GACA;GACA;GACA;GACA,4BAAW,IAAI,KAAK,EAAA,CAAE,YAAY;EACpC,CAAC;CACH;CAEA,MAAM,OAAO,IAA2B;EACtC,MAAM,KAAK,GAAG,OAAO,KAAK,OAAO,QAAQ,EAAE;CAC7C;AACF;;;;;;;;AASA,SAAgB,cACd,SACA,OACS;CACT,IAAI,MAAM,QACR,OAAO;CAET,IAAI,CAAC,QAAQ,mBACX,OAAO;CAET,OAAO,IAAI,OAAO,QAAQ,mBAAmB,GAAG,CAAC,CAAC,KAAK,MAAM,SAAS;AACxE;;AAyBA,SAAS,eAAe,OAAmD;CACzE,IAAI,CAAC,OACH,OAAO;CAET,OAAO,KAAK,UAAU,KAAK;AAC7B;;AAGA,SAAS,WAAW,KAAqC;CACvD,IAAI,CAAC,KACH,OAAO;CAET,IAAI;EACF,MAAM,SAAkB,KAAK,MAAM,GAAG;EACtC,OAAO,MAAM,QAAQ,MAAM,KAAK,OAAO,OAAO,UAAU,OAAO,UAAU,QAAQ,IAC5E,SACD;CACN,QAAQ;EACN,OAAO;CACT;AACF"}
+{"version":3,"file":"build.mjs","names":[],"sources":["../../src/models/build.ts"],"sourcesContent":["/** Build records, status transitions, and publication helpers. */\nimport { and, desc, eq, inArray, ne } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { Logger } from \"../logger.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { BuildStatus } from \"../types.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\n\n/** Tables required by {@link BuildModel}. */\nexport interface BuildTables {\n  builds: Table;\n  buildLabels: Table;\n  snapshots: Table;\n}\n\n/** Data operations for build records. */\nexport class BuildModel {\n  private readonly tables: BuildTables;\n  private readonly db: DatabaseAdapter;\n  private readonly logger: Logger | undefined;\n\n  /** `logger` only reports a status write refused by a `cancelled` build, at debug. */\n  constructor(db: DatabaseAdapter, tables?: BuildTables, logger?: Logger) {\n    this.db = db;\n    this.logger = logger;\n    this.tables = tables ?? {\n      builds: db.tables.builds,\n      buildLabels: db.tables.buildLabels,\n      snapshots: db.tables.snapshots,\n    };\n  }\n\n  async create(projectId: string, input: BuildCreateInput): Promise<Build> {\n    const now = new Date().toISOString();\n    return (await this.db.insert(this.tables.builds, {\n      id: ulid(),\n      projectId,\n      gitSha: input.gitSha,\n      gitBranch: input.gitBranch,\n      isDefault: input.isDefault ?? false,\n      authorEmail: input.authorEmail,\n      authorName: input.authorName,\n      message: input.message,\n      public: input.public ?? false,\n      affectedOnly: input.affectedOnly ?? true,\n      baselineSha: input.baselineSha ?? null,\n      changedFiles: serializePaths(input.changedFiles),\n      affectedImportPaths: serializePaths(input.affectedImportPaths),\n      status: \"pending\",\n      createdAt: now,\n      updatedAt: now,\n    })) as unknown as Build;\n  }\n\n  async get(id: string): Promise<Build | null> {\n    return (await this.db.get(this.tables.builds, id)) as unknown as Build | null;\n  }\n\n  async list(projectId: string, filter: BuildListFilter = {}): Promise<Build[]> {\n    const conditions = [eq(col(this.tables.builds, \"projectId\"), projectId)];\n    if (filter.status) {\n      conditions.push(eq(col(this.tables.builds, \"status\"), filter.status));\n    }\n    if (filter.branch) {\n      conditions.push(eq(col(this.tables.builds, \"gitBranch\"), filter.branch));\n    }\n    if (filter.labelKey && filter.labelValue) {\n      const labels = (await this.db.list(this.tables.buildLabels, {\n        where: and(\n          eq(col(this.tables.buildLabels, \"projectId\"), projectId),\n          eq(col(this.tables.buildLabels, \"typeKey\"), filter.labelKey),\n          eq(col(this.tables.buildLabels, \"value\"), filter.labelValue),\n        ),\n      })) as unknown as { buildId: string }[];\n      const ids = labels.map((l) => l.buildId);\n      if (ids.length === 0) {\n        return [];\n      }\n      conditions.push(inArray(col(this.tables.builds, \"id\"), ids));\n    }\n    return (await this.db.list(this.tables.builds, {\n      where: and(...conditions),\n      orderBy: desc(col(this.tables.builds, \"createdAt\")),\n      ...(filter.limit === undefined ? {} : { limit: filter.limit }),\n    })) as unknown as Build[];\n  }\n\n  /**\n   * Return the build a project-slug Storybook link resolves to: the most recent\n   * `approved` build on the project's default branch. Approved builds on other\n   * branches never qualify (their PR can still be dismissed), and neither do\n   * pending, failed, or unreviewed default-branch builds. Visibility (public or\n   * authenticated) is checked separately by the caller.\n   */\n  async latestApprovedDefault(project: {\n    id: string;\n    gitDefaultBranch: string;\n  }): Promise<Build | null> {\n    const rows = await this.list(project.id, {\n      branch: project.gitDefaultBranch,\n      status: \"approved\",\n    });\n    return rows[0] ?? null;\n  }\n\n  /**\n   * Patch a build. A `cancelled` build is terminal (ADR 0006): a patch that carries another status\n   * is refused, the row is returned as it is, so a capture that ends after a cancel cannot move\n   * the build. Only {@link BuildModel.resetStatus} leaves `cancelled`.\n   */\n  async update(\n    id: string,\n    patch: Partial<Pick<Build, \"status\" | \"public\" | \"message\" | \"authorEmail\" | \"authorName\">>,\n    options: { reset?: boolean } = {},\n  ): Promise<Build> {\n    const values = { ...patch, updatedAt: new Date().toISOString() };\n    if (patch.status !== undefined && patch.status !== \"cancelled\" && options.reset !== true) {\n      const current = (await this.db.updateWhere(\n        this.tables.builds,\n        id,\n        values,\n        ne(col(this.tables.builds, \"status\"), \"cancelled\"),\n      )) as unknown as Build | null;\n      if (!current) throw new Error(\"Build not found\");\n      if (current.status === \"cancelled\") {\n        this.logger?.debug(\n          { buildId: id, refused: patch.status },\n          \"build is cancelled; status write refused\",\n        );\n      }\n      return current;\n    }\n    return (await this.db.update(this.tables.builds, id, values)) as unknown as Build;\n  }\n\n  async setStatus(id: string, status: BuildStatus): Promise<Build> {\n    return await this.update(id, { status });\n  }\n\n  /**\n   * Put a finished build back to `status` for a retry. The one write that leaves `cancelled`\n   * (a user chose it), so it skips the terminal guard of {@link BuildModel.update}.\n   */\n  async resetStatus(id: string, status: BuildStatus): Promise<Build> {\n    return await this.update(id, { status }, { reset: true });\n  }\n\n  /**\n   * Record the affected-capture computation for a build. Idempotent: the CLI\n   * posts this once after creating the build and before uploading the bundle.\n   */\n  async setAffected(id: string, input: AffectedComputation): Promise<Build> {\n    return (await this.db.update(this.tables.builds, id, {\n      baselineSha: input.baselineSha,\n      changedFiles: serializePaths(input.changedFiles),\n      affectedImportPaths: serializePaths(input.affectedImportPaths),\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  /**\n   * Store the results of the build's `.test()` entries (`TestResult[]`, as JSON), or clear them\n   * with null. Written once per capture run, by the run that ran the tests.\n   */\n  async setTestResults(id: string, results: readonly unknown[] | null): Promise<Build> {\n    return (await this.db.update(this.tables.builds, id, {\n      testResults: results === null ? null : JSON.stringify(results),\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  /**\n   * Parse a build's affected import paths. Returns `null` for full capture\n   * (no computation, or an unreadable payload) — callers render everything.\n   */\n  static affectedPaths(build: Pick<Build, \"affectedImportPaths\">): string[] | null {\n    return parsePaths(build.affectedImportPaths);\n  }\n\n  async updateCounts(id: string): Promise<Build> {\n    const rows = (await this.db.list(this.tables.snapshots, {\n      where: eq(col(this.tables.snapshots, \"buildId\"), id),\n    })) as unknown as { status: string; inherited: boolean }[];\n    const snapshotCount = rows.length;\n    const changedCount = rows.filter((s) => s.status === \"changed\" || s.status === \"new\").length;\n    const approvedCount = rows.filter(\n      (s) => s.status === \"approved\" || s.status === \"unchanged\",\n    ).length;\n    const rejectedCount = rows.filter((s) => s.status === \"rejected\").length;\n    const inheritedCount = rows.filter((s) => s.inherited).length;\n    return (await this.db.update(this.tables.builds, id, {\n      snapshotCount,\n      changedCount,\n      approvedCount,\n      rejectedCount,\n      inheritedCount,\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  async remove(id: string): Promise<void> {\n    await this.db.remove(this.tables.builds, id);\n  }\n}\n\n/**\n * Return whether a build is publicly viewable without a session.\n *\n * A build is public iff `builds.public` is set or its branch matches the\n * project's `public_branch_regex` (ADR 0011). Supplying an empty/nonexistent\n * regex makes every build require auth.\n */\nexport function isPublicBuild(\n  project: { publicBranchRegex: string | null },\n  build: Pick<Build, \"public\" | \"gitBranch\">,\n): boolean {\n  if (build.public) {\n    return true;\n  }\n  if (!project.publicBranchRegex) {\n    return false;\n  }\n  return new RegExp(project.publicBranchRegex, \"u\").test(build.gitBranch);\n}\n\n/** Input for creating a build. */\nexport interface BuildCreateInput {\n  gitSha: string;\n  gitBranch: string;\n  isDefault?: boolean;\n  authorEmail?: string;\n  authorName?: string;\n  message?: string;\n  public?: boolean;\n  affectedOnly?: boolean;\n  baselineSha?: string | null;\n  changedFiles?: string[] | null;\n  affectedImportPaths?: string[] | null;\n}\n\n/** Affected-capture computation posted after build creation. */\nexport interface AffectedComputation {\n  baselineSha: string | null;\n  changedFiles: string[];\n  affectedImportPaths: string[] | null;\n}\n\n/** Serialize an optional path list to its JSON text form (or null). */\nfunction serializePaths(paths: string[] | null | undefined): string | null {\n  if (!paths) {\n    return null;\n  }\n  return JSON.stringify(paths);\n}\n\n/** Parse a JSON path list; null (full capture) on missing/invalid input. */\nfunction parsePaths(raw: string | null): string[] | null {\n  if (!raw) {\n    return null;\n  }\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    return Array.isArray(parsed) && parsed.every((entry) => typeof entry === \"string\")\n      ? (parsed as string[])\n      : null;\n  } catch {\n    return null;\n  }\n}\n\n/** Filter options for listing builds. */\nexport interface BuildListFilter {\n  status?: BuildStatus;\n  branch?: string;\n  labelKey?: string;\n  labelValue?: string;\n  /** Newest builds to return at most. */\n  limit?: number;\n}\n"],"mappings":"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"}

package/dist/models/capture-attempt.d.mts

@@ -5,7 +5,6 @@ import { JobStatus } from "../adapter/capture-queue.mjs";
 import { CaptureAttempt, CaptureLogLevel } from "../schema/capture-attempt.mjs";
 import { Logger } from "pino";
 import { Table } from "drizzle-orm";
-//#region src/models/capture-attempt.d.ts
 /** Tables required by {@link CaptureAttemptModel}. */
 interface CaptureAttemptTables {
   captureAttempts: Table;
@@ -41,6 +40,5 @@ type AttemptLogRecorder = (level: CaptureLogLevel, message: string, fields?: unk
  * Log-write failures are reported through pino and never thrown.
  */
 declare function emitAttemptLog(record: AttemptLogRecorder | undefined, logger: Logger | undefined, level: CaptureLogLevel, message: string, fields?: unknown): Promise<void>;
-//#endregion
 export { AttemptLogRecorder, CaptureAttemptModel, CaptureAttemptTables, emitAttemptLog };
 //# sourceMappingURL=capture-attempt.d.mts.map

package/dist/models/capture-attempt.mjs

@@ -5,7 +5,7 @@ import { redactSecrets } from "../utils/redact.mjs";
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, asc, eq } from "drizzle-orm";
-//#region src/models/capture-attempt.ts
+// src/models/capture-attempt.ts
 /** Capture attempts and their log lines: per-run history for a build. */
 /** Data operations for capture attempts (one row per build run). */
 var CaptureAttemptModel = class {
@@ -104,7 +104,6 @@ async function emitAttemptLog(record, logger, level, message, fields) {
 		logger?.warn({ err: error }, "attempt log write failed");
 	}
 }
-//#endregion
 export { CaptureAttemptModel, emitAttemptLog };
 
 //# sourceMappingURL=capture-attempt.mjs.map

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

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { CaptureAttemptStatus, CaptureJobKind, CaptureJobRow, CaptureJobStatus } from "../schema/capture-job.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/capture-job.d.ts
 /** Tables required by {@link CaptureJobModel}. */
 interface CaptureJobTables {
   captureJobs: Table;
@@ -101,6 +100,5 @@ declare function parseAttemptRowId(id: string): {
 } | null;
 /** Whether a job row has ended. */
 declare function isTerminalJob(row: CaptureJobRow): boolean;
-//#endregion
 export { AttemptClaim, CaptureJobModel, CaptureJobTables, NewCaptureJob, TERMINAL_JOB_STATUSES, attemptRowId, isTerminalJob, parseAttemptRowId };
 //# sourceMappingURL=capture-job.d.mts.map

package/dist/models/capture-job.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { col } from "./columns.mjs";
 import { and, asc, desc, eq, inArray, lt, lte } from "drizzle-orm";
-//#region src/models/capture-job.ts
+// src/models/capture-job.ts
 /** Rows of the database queue (`capture_jobs`): job rows, per-attempt claim rows, and their views. */
 /** Job statuses that end a job: nothing claims it again. */
 const TERMINAL_JOB_STATUSES = [
@@ -282,7 +282,6 @@ function blankRow(now) {
 		updatedAt: now
 	};
 }
-//#endregion
 export { CaptureJobModel, TERMINAL_JOB_STATUSES, attemptRowId, isTerminalJob, parseAttemptRowId };
 
 //# sourceMappingURL=capture-job.mjs.map

package/dist/models/capture-log.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { CaptureLog, CaptureLogLevel } from "../schema/capture-attempt.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/capture-log.d.ts
 /** Tables required by {@link CaptureLogModel}. */
 interface CaptureLogTables {
   captureLogs: Table;
@@ -16,6 +15,5 @@ declare class CaptureLogModel {
   listByAttempt(attemptId: string, limit?: number): Promise<CaptureLog[]>;
   append(projectId: string, buildId: string, attemptId: string, level: CaptureLogLevel, message: string, fields?: unknown): Promise<CaptureLog>;
 }
-//#endregion
 export { CaptureLogModel, CaptureLogTables };
 //# sourceMappingURL=capture-log.d.mts.map

package/dist/models/capture-log.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { asc, eq } from "drizzle-orm";
-//#region src/models/capture-log.ts
+// src/models/capture-log.ts
 /** Capture log lines: every stored line of a capture attempt. */
 /** Data operations for capture log lines (every line of an attempt). */
 var CaptureLogModel = class {
@@ -39,7 +39,6 @@ var CaptureLogModel = class {
 function columnsOf(table, column) {
 	return col(table, column);
 }
-//#endregion
 export { CaptureLogModel };
 
 //# sourceMappingURL=capture-log.mjs.map

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

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { CaptureShard } from "../schema/capture-shard.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/capture-shard.d.ts
 /** Tables required by {@link CaptureShardModel}. */
 interface CaptureShardTables {
   captureShards: Table;
@@ -57,6 +56,5 @@ declare class CaptureShardModel {
   /** The finalize failed: drop its claim, so the next run to reduce the build can finalize it. */
   releaseFinalize(buildId: string): Promise<void>;
 }
-//#endregion
 export { CaptureShardModel, CaptureShardTables, NewRenderShard };
 //# sourceMappingURL=capture-shard.d.mts.map

package/dist/models/capture-shard.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { asc, eq } from "drizzle-orm";
-//#region src/models/capture-shard.ts
+// src/models/capture-shard.ts
 /** Shard rows of a sharded capture: the plan, the render slices, and the finalize claim. */
 /** Data operations for the stages of a sharded capture. */
 var CaptureShardModel = class {
@@ -184,7 +184,6 @@ function base(projectId, buildId, kind, ordinal, now) {
 function kindRank(kind) {
 	return kind === "plan" ? 0 : kind === "render" ? 1 : 2;
 }
-//#endregion
 export { CaptureShardModel, FINALIZE_STALE_MS };
 
 //# sourceMappingURL=capture-shard.mjs.map

package/dist/models/changeset.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Build } from "../schema/build.mjs";
 import { BuildComponent } from "../schema/build-component.mjs";
-//#region src/models/changeset.d.ts
 /** What the changeset shows of a component. */
 type ChangesetComponent = Pick<BuildComponent, "importPath" | "title" | "storyCount">;
 /** A component present in both builds whose hash differs. */
@@ -43,6 +42,5 @@ declare function changesetOf(db: DatabaseAdapter, project: {
   id: string;
   gitDefaultBranch: string;
 }, build: Build): Promise<BuildChangeset>;
-//#endregion
 export { BuildChangeset, ChangedComponent, Changeset, ChangesetComponent, changesetOf, computeChangeset, findChangesetBaseline };
 //# sourceMappingURL=changeset.d.mts.map

package/dist/models/changeset.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { BuildModel } from "./build.mjs";
 import { BuildComponentModel } from "./build-component.mjs";
-//#region src/models/changeset.ts
+// src/models/changeset.ts
 /**
 * Compare a build's components with the baseline's. Components match by story file, or by title
 * when the index carries no file. With no baseline (`null`) every component is `added`.
@@ -75,7 +75,6 @@ function summary(row) {
 function byTitle(a, b) {
 	return a.title.localeCompare(b.title) || a.importPath.localeCompare(b.importPath);
 }
-//#endregion
 export { changesetOf, computeChangeset, findChangesetBaseline };
 
 //# sourceMappingURL=changeset.mjs.map

package/dist/models/columns.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { getTableColumns } from "drizzle-orm";
-//#region src/models/columns.ts
+// src/models/columns.ts
 /**
 * Column handle for query builders (`eq`, `inArray`, `desc`, …) from a table
 * handle and a property name. Throws on an unknown name instead of letting
@@ -13,7 +13,6 @@ function col(table, name) {
 	if (!column) throw new Error(`Unknown column "${name}"`);
 	return column;
 }
-//#endregion
 export { col };
 
 //# sourceMappingURL=columns.mjs.map

package/dist/models/comment.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Comment } from "../schema/comment.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/comment.d.ts
 /** Tables required by {@link CommentModel}. */
 interface CommentTables {
   comments: Table;
@@ -27,6 +26,5 @@ interface CommentCreateInput {
   storyId?: string;
   parentId?: string;
 }
-//#endregion
 export { CommentCreateInput, CommentModel, CommentTables };
 //# sourceMappingURL=comment.d.mts.map

package/dist/models/comment.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { eq } from "drizzle-orm";
-//#region src/models/comment.ts
+// src/models/comment.ts
 /** Build and snapshot review comments. */
 /** Data operations for review comments. */
 var CommentModel = class {
@@ -45,7 +45,6 @@ var CommentModel = class {
 		});
 	}
 };
-//#endregion
 export { CommentModel };
 
 //# sourceMappingURL=comment.mjs.map

package/dist/models/component.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { SnapshotStatus } from "../types.mjs";
 import { Build } from "../schema/build.mjs";
 import { Snapshot } from "../schema/snapshot.mjs";
-//#region src/models/component.d.ts
 /** The most attention-worthy status of a set (unchanged when empty). */
 declare function worstStatus(statuses: readonly SnapshotStatus[]): SnapshotStatus;
 /** One build's view of a component. */
@@ -38,6 +37,5 @@ type ComponentPresence = {
  * every file, used to find a moved file by its last-seen title.
  */
 declare function componentPresence(history: readonly ComponentHistoryRow[], latestBuildId: string | null, latest: readonly Pick<Snapshot, "storyTitle" | "storyImportPath">[], lastTitle: string | null): ComponentPresence;
-//#endregion
 export { ComponentHistoryRow, ComponentPresence, componentHistory, componentPresence, worstStatus };
 //# sourceMappingURL=component.d.mts.map

package/dist/models/component.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/models/component.ts
+// src/models/component.ts
 /** Worst-first order used for status roll-ups. */
 const STATUS_PRIORITY = [
 	"rejected",
@@ -54,7 +54,6 @@ function componentPresence(history, latestBuildId, latest, lastTitle) {
 		lastSeen: newest.build
 	};
 }
-//#endregion
 export { componentHistory, componentPresence, worstStatus };
 
 //# sourceMappingURL=component.mjs.map

package/dist/models/connections.d.mts

@@ -5,7 +5,6 @@ import { OAuthClient, OAuthTokens } from "../adapter/oauth.mjs";
 import { SecretInput } from "../utils/encrypt.mjs";
 import { UserConnection } from "../schema/connection.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/connections.d.ts
 /** Tables required by {@link ConnectionModel}. */
 interface ConnectionTables {
   userConnections: Table;
@@ -36,6 +35,5 @@ declare class ConnectionModel {
   accessToken(userId: string, service: string, oauth?: Pick<OAuthClient, "refresh">, now?: Date): Promise<string | null>;
   private refreshOnce;
 }
-//#endregion
 export { ConnectionModel, ConnectionTables };
 //# sourceMappingURL=connections.d.mts.map

package/dist/models/connections.mjs

@@ -5,7 +5,7 @@ import { decryptCredential, encrypt } from "../utils/encrypt.mjs";
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, eq } from "drizzle-orm";
-//#region src/models/connections.ts
+// src/models/connections.ts
 /** A user's own OAuth connections to external services: encrypted tokens, lazy refresh on use. */
 /** Refresh this long before expiry so a call never starts with a token about to lapse. */
 const REFRESH_MARGIN_MS = 6e4;
@@ -106,7 +106,6 @@ var ConnectionModel = class {
 function isExpiring(expiresAt, now) {
 	return expiresAt !== null && Date.parse(expiresAt) - now.getTime() < REFRESH_MARGIN_MS;
 }
-//#endregion
 export { ConnectionModel };
 
 //# sourceMappingURL=connections.mjs.map

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

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { ContentRef } from "../schema/content-ref.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/content-ref.d.ts
 /** Content refs for deduplicated Storybook assets. */
 declare class ContentRefModel {
   private readonly tables;
@@ -16,6 +15,5 @@ declare class ContentRefModel {
   decrement(hash: string): Promise<ContentRef | null>;
   listStale(cutoff: string): Promise<ContentRef[]>;
 }
-//#endregion
 export { ContentRefModel };
 //# sourceMappingURL=content-ref.d.mts.map