@storyshelf/core 0.7.0 → 0.8.0

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

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { describe, expect, it } from "vitest";
-//#region src/test-helpers/queue-contract.ts
+// src/test-helpers/queue-contract.ts
 /**
 * Published queue contract suite for first- and third-party adapters.
 *
@@ -252,7 +252,6 @@ function cancelCases(make) {
 		expect(await queue.cancel("b-contract-unknown")).toBe(false);
 	});
 }
-//#endregion
 export { queueContractSuite };
 
 //# sourceMappingURL=queue-contract.mjs.map

package/dist/test-helpers/queue-multi-instance.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
-//#region src/test-helpers/queue-multi-instance.d.ts
 /** A set-up database the instances of one case share. */
 type SharedDatabaseFactory = () => DatabaseAdapter | Promise<DatabaseAdapter>;
 /** Options of {@link databaseQueueMultiInstanceSuite}. */
@@ -15,6 +14,5 @@ interface MultiInstanceOptions {
 }
 /** Run the multi-instance suite against databases from `makeDb`. */
 declare function databaseQueueMultiInstanceSuite(label: string, makeDb: SharedDatabaseFactory, options?: MultiInstanceOptions): void;
-//#endregion
 export { MultiInstanceOptions, SharedDatabaseFactory, databaseQueueMultiInstanceSuite };
 //# sourceMappingURL=queue-multi-instance.d.mts.map

package/dist/test-helpers/queue-multi-instance.mjs

@@ -5,7 +5,7 @@ import { CaptureJobModel, attemptRowId } from "../models/capture-job.mjs";
 import { LEASE_EXHAUSTED_ERROR } from "../capture/db-queue/claim.mjs";
 import { createDatabaseCaptureQueue } from "../capture/db-queue/index.mjs";
 import { describe, expect, it } from "vitest";
-//#region src/test-helpers/queue-multi-instance.ts
+// src/test-helpers/queue-multi-instance.ts
 /**
 * Multi-instance suite for the database capture queue: several queue instances (one per simulated
 * app instance) share ONE database, the way horizontally scaled app instances do. Database packages
@@ -200,7 +200,6 @@ function cancelAndKindCases(makeDb, size, timeoutMs) {
 		expect((await capture.queues[0].status(buildId))?.status).toBe("completed");
 	}, timeoutMs);
 }
-//#endregion
 export { databaseQueueMultiInstanceSuite };
 
 //# sourceMappingURL=queue-multi-instance.mjs.map

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

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

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

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { isCaptureTarget } from "../adapters/capture-target.mjs";
 import { describe, expect, it } from "vitest";
-//#region src/test-helpers/runner-contract.ts
+// src/test-helpers/runner-contract.ts
 /**
 * Published runner contract suite for first- and third-party adapters.
 *
@@ -37,7 +37,6 @@ function runnerContractSuite(label, make) {
 		});
 	});
 }
-//#endregion
 export { runnerContractSuite };
 
 //# sourceMappingURL=runner-contract.mjs.map

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

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { getTableColumns } from "drizzle-orm";
-//#region src/test-helpers/sql-chunks.ts
+// src/test-helpers/sql-chunks.ts
 /** Flatten the string parts of a drizzle SQL chunk into a single string. */
 function textOf(chunk) {
 	if (chunk === void 0 || !Array.isArray(chunk.value) || !chunk.value.every((part) => typeof part === "string")) return;
@@ -24,6 +24,7 @@ function matchChunk(chunks, row, table) {
 	const text = chunks.map((c) => textOf(c) ?? "").join("");
 	if (/is not null/iu.test(text)) return isNullMatches(chunks, row, table, true);
 	if (/is null/iu.test(text)) return isNullMatches(chunks, row, table, false);
+	if (text.includes(" <> ")) return !eqMatches(chunks, row, table);
 	if (text.includes(" like ")) return likeMatches(chunks, row, table);
 	if (text.includes(" in ")) return inArrayMatches(chunks, row, table);
 	if (text.includes(" >= ")) return !ltMatches(chunks, row, table);
@@ -155,7 +156,6 @@ function columnKey(table, dbName) {
 	for (const [property, column] of Object.entries(getTableColumns(table))) if (column.name === dbName) return property;
 	return dbName;
 }
-//#endregion
 export { orderRows, whereMatches };
 
 //# sourceMappingURL=sql-chunks.mjs.map

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

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

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

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

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

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { Readable } from "node:stream";
 import { describe, expect, it } from "vitest";
-//#region src/test-helpers/storage-contract.ts
+// src/test-helpers/storage-contract.ts
 /**
 * Published storage contract suite for first- and third-party adapters.
 *
@@ -81,7 +81,6 @@ function storageContractSuite(label, make) {
 		});
 	});
 }
-//#endregion
 export { storageContractSuite };
 
 //# sourceMappingURL=storage-contract.mjs.map

package/dist/test-helpers.d.mts

@@ -15,4 +15,5 @@ import { ManualClock, createManualClock } from "./test-helpers/manual-clock.mjs"
 import { runnerContractSuite } from "./test-helpers/runner-contract.mjs";
 import { storageContractSuite } from "./test-helpers/storage-contract.mjs";
 import { FakeStateNotifier, makeFakeStateNotifier } from "./test-helpers/fake-notifier.mjs";
-export { type Deferred, type DesignContractSamples, FAKE_PNG, type FakeDesign, type FakeStateNotifier, type FakeStorage, type Latch, type ManualClock, type MultiInstanceOptions, type PollableContractOptions, type QueueContractOptions, type QueueFactory, REQUIRED_TABLES, type ReleaseQueue, type SharedDatabaseFactory, createLatch, createManualClock, createReleaseQueue, createTestBuild, createTestProject, databaseContractSuite, databaseQueueMultiInstanceSuite, deferred, designContractSuite, fakeUrl, makeDatabase, makeFakeDesign, makeFakeStateNotifier, makeStorage, notifierContractSuite, queueContractSuite, runnerContractSuite, stateNotifierContractSuite, storageContractSuite, stubTables };
+import { BuildReferenceContractFixture, BuildReferenceContractFixtureRunner, buildReferenceContractSuite } from "./test-helpers/build-reference-contract.mjs";
+export { type BuildReferenceContractFixture, type BuildReferenceContractFixtureRunner, type Deferred, type DesignContractSamples, FAKE_PNG, type FakeDesign, type FakeStateNotifier, type FakeStorage, type Latch, type ManualClock, type MultiInstanceOptions, type PollableContractOptions, type QueueContractOptions, type QueueFactory, REQUIRED_TABLES, type ReleaseQueue, type SharedDatabaseFactory, buildReferenceContractSuite, createLatch, createManualClock, createReleaseQueue, createTestBuild, createTestProject, databaseContractSuite, databaseQueueMultiInstanceSuite, deferred, designContractSuite, fakeUrl, makeDatabase, makeFakeDesign, makeFakeStateNotifier, makeStorage, notifierContractSuite, queueContractSuite, runnerContractSuite, stateNotifierContractSuite, storageContractSuite, stubTables };

package/dist/test-helpers.mjs

@@ -16,4 +16,5 @@ import { createManualClock } from "./test-helpers/manual-clock.mjs";
 import { runnerContractSuite } from "./test-helpers/runner-contract.mjs";
 import { storageContractSuite } from "./test-helpers/storage-contract.mjs";
 import { makeFakeStateNotifier } from "./test-helpers/fake-notifier.mjs";
-export { FAKE_PNG, REQUIRED_TABLES, createLatch, createManualClock, createReleaseQueue, createTestBuild, createTestProject, databaseContractSuite, databaseQueueMultiInstanceSuite, deferred, designContractSuite, fakeUrl, makeDatabase, makeFakeDesign, makeFakeStateNotifier, makeStorage, notifierContractSuite, queueContractSuite, runnerContractSuite, stateNotifierContractSuite, storageContractSuite, stubTables };
+import { buildReferenceContractSuite } from "./test-helpers/build-reference-contract.mjs";
+export { FAKE_PNG, REQUIRED_TABLES, buildReferenceContractSuite, createLatch, createManualClock, createReleaseQueue, createTestBuild, createTestProject, databaseContractSuite, databaseQueueMultiInstanceSuite, deferred, designContractSuite, fakeUrl, makeDatabase, makeFakeDesign, makeFakeStateNotifier, makeStorage, notifierContractSuite, queueContractSuite, runnerContractSuite, stateNotifierContractSuite, storageContractSuite, stubTables };

package/dist/tracing.mjs

@@ -1,8 +1,9 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { redactSecrets } from "./utils/redact.mjs";
 import { SpanKind, SpanStatusCode, context, propagation, trace } from "@opentelemetry/api";
-//#region src/tracing.ts
+// src/tracing.ts
 /**
 * Internal span and propagation helpers over `@opentelemetry/api`.
 *
@@ -15,11 +16,41 @@ import { SpanKind, SpanStatusCode, context, propagation, trace } from "@opentele
 const SCOPE = "storyshelf.core";
 /** W3C traceparent header name. */
 const TRACEPARENT_HEADER = "traceparent";
+/** What a span records of an error instead of its message, set by the code that knows the error. */
+const spanMessages = /* @__PURE__ */ new WeakMap();
+/**
+* State what spans record as the message of `error`, instead of its own: an outbound HTTP failure
+* is recorded as its status, never the response body it carries. The error itself is not touched,
+* so what a caller catches is unchanged.
+*/
+function setSpanMessage(error, message) {
+	if (typeof error === "object" && error !== null) spanMessages.set(error, message);
+}
+/**
+* The form of a failure that may be recorded on a span: a new error of the same name whose message
+* (the one given to {@link setSpanMessage}, else the error's own) has gone through
+* `redactSecrets`, with the original's stack frames. Never the original, whose message, stack
+* header or `cause` can repeat a URL, a token or a response body. A thrown non-error is stringified
+* and redacted. This is the one way core records an exception on a span.
+*/
+function spanException(error) {
+	if (!(error instanceof Error)) return redactSecrets(String(error));
+	const message = redactSecrets(spanMessages.get(error) ?? error.message);
+	const copy = new Error(message);
+	copy.name = error.name;
+	copy.stack = `${error.name}: ${message}${redactSecrets(framesOf(error))}`;
+	return copy;
+}
+/** The stack after its `Name: message` header, which may hold what the span must not record. */
+function framesOf(error) {
+	const header = `${error.name}: ${error.message}`;
+	return error.stack?.startsWith(header) ? error.stack.slice(header.length) : "";
+}
 /**
 * Run `fn` inside an internal span.
 *
-* On throw the span records the exception, is marked ERROR, and the error
-* is rethrown — mirroring the pino `{ err }` convention.
+* On throw the span records a redacted copy of the exception ({@link spanException}), is marked
+* ERROR, and the original error is rethrown untouched — mirroring the pino `{ err }` convention.
 *
 * @param name - Span name (`domain.operation`, never a high-cardinality value).
 * @param fn - Work to run with the span active.
@@ -35,7 +66,7 @@ async function withSpan(name, fn, attributes, parent) {
 		try {
 			return await fn(span);
 		} catch (error) {
-			span.recordException(error instanceof Error ? error : String(error));
+			span.recordException(spanException(error));
 			span.setStatus({ code: SpanStatusCode.ERROR });
 			throw error;
 		} finally {
@@ -57,7 +88,6 @@ function parentContext(traceparent) {
 function injectTraceContext(headers) {
 	propagation.inject(context.active(), headers);
 }
-//#endregion
-export { injectTraceContext, parentContext, withSpan };
+export { injectTraceContext, parentContext, setSpanMessage, spanException, withSpan };
 
 //# sourceMappingURL=tracing.mjs.map

package/dist/tracing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.mjs","names":[],"sources":["../src/tracing.ts"],"sourcesContent":["/**\n * Internal span and propagation helpers over `@opentelemetry/api`.\n *\n * Not exported from the package surface (see `package.json` exports): other\n * packages use `@storyshelf/observability`. Without a configured provider\n * every helper is a cheap noop, so call sites need no enabled-checks and\n * the hermetic vitest suite stays network-free.\n */\nimport {\n  SpanKind,\n  SpanStatusCode,\n  context,\n  propagation,\n  trace,\n  type Attributes,\n  type Context,\n  type Span,\n} from \"@opentelemetry/api\";\n\n/** Instrumentation scope for core spans. */\nconst SCOPE = \"storyshelf.core\";\n\n/** W3C traceparent header name. */\nconst TRACEPARENT_HEADER = \"traceparent\";\n\n/**\n * Run `fn` inside an internal span.\n *\n * On throw the span records the exception, is marked ERROR, and the error\n * is rethrown — mirroring the pino `{ err }` convention.\n *\n * @param name - Span name (`domain.operation`, never a high-cardinality value).\n * @param fn - Work to run with the span active.\n * @param attributes - Fixed span attributes.\n * @param parent - Parent context (defaults to the active context).\n * @returns Whatever `fn` returns.\n */\nexport async function withSpan<T>(\n  name: string,\n  fn: (span: Span) => Promise<T>,\n  attributes?: Attributes,\n  parent?: Context,\n): Promise<T> {\n  const tracer = trace.getTracer(SCOPE);\n  return await tracer.startActiveSpan(\n    name,\n    { kind: SpanKind.INTERNAL, attributes },\n    parent ?? context.active(),\n    async (span) => {\n      try {\n        return await fn(span);\n      } catch (error) {\n        span.recordException(error instanceof Error ? error : String(error));\n        span.setStatus({ code: SpanStatusCode.ERROR });\n        throw error;\n      } finally {\n        span.end();\n      }\n    },\n  );\n}\n\n/**\n * Resolve the parent context from an inbound `traceparent` value.\n *\n * @param traceparent - W3C value from a queue payload; absent keeps context.\n * @returns The extracted remote context, or the active context when absent.\n */\nexport function parentContext(traceparent?: string): Context {\n  if (!traceparent) {\n    return context.active();\n  }\n  return propagation.extract(context.active(), { [TRACEPARENT_HEADER]: traceparent });\n}\n\n/** Inject the active span context into a mutable header record. */\nexport function injectTraceContext(headers: Record<string, string>): void {\n  propagation.inject(context.active(), headers);\n}\n\n/**\n * Read the current W3C `traceparent` value for queue payloads.\n *\n * @returns The header value, or undefined when no span is active.\n */\nexport function currentTraceparent(): string | undefined {\n  const carrier: Record<string, string> = {};\n  propagation.inject(context.active(), carrier);\n  return carrier[TRACEPARENT_HEADER];\n}\n"],"mappings":";;;;;;;;;;;;;;AAoBA,MAAM,QAAQ;;AAGd,MAAM,qBAAqB;;;;;;;;;;;;;AAc3B,eAAsB,SACpB,MACA,IACA,YACA,QACY;CAEZ,OAAO,MADQ,MAAM,UAAU,KACb,CAAC,CAAC,gBAClB,MACA;EAAE,MAAM,SAAS;EAAU;CAAW,GACtC,UAAU,QAAQ,OAAO,GACzB,OAAO,SAAS;EACd,IAAI;GACF,OAAO,MAAM,GAAG,IAAI;EACtB,SAAS,OAAO;GACd,KAAK,gBAAgB,iBAAiB,QAAQ,QAAQ,OAAO,KAAK,CAAC;GACnE,KAAK,UAAU,EAAE,MAAM,eAAe,MAAM,CAAC;GAC7C,MAAM;EACR,UAAU;GACR,KAAK,IAAI;EACX;CACF,CACF;AACF;;;;;;;AAQA,SAAgB,cAAc,aAA+B;CAC3D,IAAI,CAAC,aACH,OAAO,QAAQ,OAAO;CAExB,OAAO,YAAY,QAAQ,QAAQ,OAAO,GAAG,GAAG,qBAAqB,YAAY,CAAC;AACpF;;AAGA,SAAgB,mBAAmB,SAAuC;CACxE,YAAY,OAAO,QAAQ,OAAO,GAAG,OAAO;AAC9C"}
+{"version":3,"file":"tracing.mjs","names":[],"sources":["../src/tracing.ts"],"sourcesContent":["/**\n * Internal span and propagation helpers over `@opentelemetry/api`.\n *\n * Not exported from the package surface (see `package.json` exports): other\n * packages use `@storyshelf/observability`. Without a configured provider\n * every helper is a cheap noop, so call sites need no enabled-checks and\n * the hermetic vitest suite stays network-free.\n */\nimport {\n  SpanKind,\n  SpanStatusCode,\n  context,\n  propagation,\n  trace,\n  type Attributes,\n  type Context,\n  type Span,\n} from \"@opentelemetry/api\";\nimport { redactSecrets } from \"./utils/redact.ts\";\n\n/** Instrumentation scope for core spans. */\nconst SCOPE = \"storyshelf.core\";\n\n/** W3C traceparent header name. */\nconst TRACEPARENT_HEADER = \"traceparent\";\n\n/** What a span records of an error instead of its message, set by the code that knows the error. */\nconst spanMessages = new WeakMap<object, string>();\n\n/**\n * State what spans record as the message of `error`, instead of its own: an outbound HTTP failure\n * is recorded as its status, never the response body it carries. The error itself is not touched,\n * so what a caller catches is unchanged.\n */\nexport function setSpanMessage(error: unknown, message: string): void {\n  if (typeof error === \"object\" && error !== null) {\n    spanMessages.set(error, message);\n  }\n}\n\n/**\n * The form of a failure that may be recorded on a span: a new error of the same name whose message\n * (the one given to {@link setSpanMessage}, else the error's own) has gone through\n * `redactSecrets`, with the original's stack frames. Never the original, whose message, stack\n * header or `cause` can repeat a URL, a token or a response body. A thrown non-error is stringified\n * and redacted. This is the one way core records an exception on a span.\n */\nexport function spanException(error: unknown): Error | string {\n  if (!(error instanceof Error)) {\n    return redactSecrets(String(error));\n  }\n  const message = redactSecrets(spanMessages.get(error) ?? error.message);\n  const copy = new Error(message);\n  copy.name = error.name;\n  copy.stack = `${error.name}: ${message}${redactSecrets(framesOf(error))}`;\n  return copy;\n}\n\n/** The stack after its `Name: message` header, which may hold what the span must not record. */\nfunction framesOf(error: Error): string {\n  const header = `${error.name}: ${error.message}`;\n  return error.stack?.startsWith(header) ? error.stack.slice(header.length) : \"\";\n}\n\n/**\n * Run `fn` inside an internal span.\n *\n * On throw the span records a redacted copy of the exception ({@link spanException}), is marked\n * ERROR, and the original error is rethrown untouched — mirroring the pino `{ err }` convention.\n *\n * @param name - Span name (`domain.operation`, never a high-cardinality value).\n * @param fn - Work to run with the span active.\n * @param attributes - Fixed span attributes.\n * @param parent - Parent context (defaults to the active context).\n * @returns Whatever `fn` returns.\n */\nexport async function withSpan<T>(\n  name: string,\n  fn: (span: Span) => Promise<T>,\n  attributes?: Attributes,\n  parent?: Context,\n): Promise<T> {\n  const tracer = trace.getTracer(SCOPE);\n  return await tracer.startActiveSpan(\n    name,\n    { kind: SpanKind.INTERNAL, attributes },\n    parent ?? context.active(),\n    async (span) => {\n      try {\n        return await fn(span);\n      } catch (error) {\n        span.recordException(spanException(error));\n        span.setStatus({ code: SpanStatusCode.ERROR });\n        throw error;\n      } finally {\n        span.end();\n      }\n    },\n  );\n}\n\n/**\n * Resolve the parent context from an inbound `traceparent` value.\n *\n * @param traceparent - W3C value from a queue payload; absent keeps context.\n * @returns The extracted remote context, or the active context when absent.\n */\nexport function parentContext(traceparent?: string): Context {\n  if (!traceparent) {\n    return context.active();\n  }\n  return propagation.extract(context.active(), { [TRACEPARENT_HEADER]: traceparent });\n}\n\n/** Inject the active span context into a mutable header record. */\nexport function injectTraceContext(headers: Record<string, string>): void {\n  propagation.inject(context.active(), headers);\n}\n\n/**\n * Read the current W3C `traceparent` value for queue payloads.\n *\n * @returns The header value, or undefined when no span is active.\n */\nexport function currentTraceparent(): string | undefined {\n  const carrier: Record<string, string> = {};\n  propagation.inject(context.active(), carrier);\n  return carrier[TRACEPARENT_HEADER];\n}\n"],"mappings":";;;;;;;;;;;;;;;AAqBA,MAAM,QAAQ;;AAGd,MAAM,qBAAqB;;AAG3B,MAAM,+BAAe,IAAI,QAAwB;;;;;;AAOjD,SAAgB,eAAe,OAAgB,SAAuB;CACpE,IAAI,OAAO,UAAU,YAAY,UAAU,MACzC,aAAa,IAAI,OAAO,OAAO;AAEnC;;;;;;;;AASA,SAAgB,cAAc,OAAgC;CAC5D,IAAI,EAAE,iBAAiB,QACrB,OAAO,cAAc,OAAO,KAAK,CAAC;CAEpC,MAAM,UAAU,cAAc,aAAa,IAAI,KAAK,KAAK,MAAM,OAAO;CACtE,MAAM,OAAO,IAAI,MAAM,OAAO;CAC9B,KAAK,OAAO,MAAM;CAClB,KAAK,QAAQ,GAAG,MAAM,KAAK,IAAI,UAAU,cAAc,SAAS,KAAK,CAAC;CACtE,OAAO;AACT;;AAGA,SAAS,SAAS,OAAsB;CACtC,MAAM,SAAS,GAAG,MAAM,KAAK,IAAI,MAAM;CACvC,OAAO,MAAM,OAAO,WAAW,MAAM,IAAI,MAAM,MAAM,MAAM,OAAO,MAAM,IAAI;AAC9E;;;;;;;;;;;;;AAcA,eAAsB,SACpB,MACA,IACA,YACA,QACY;CAEZ,OAAO,MADQ,MAAM,UAAU,KACb,CAAC,CAAC,gBAClB,MACA;EAAE,MAAM,SAAS;EAAU;CAAW,GACtC,UAAU,QAAQ,OAAO,GACzB,OAAO,SAAS;EACd,IAAI;GACF,OAAO,MAAM,GAAG,IAAI;EACtB,SAAS,OAAO;GACd,KAAK,gBAAgB,cAAc,KAAK,CAAC;GACzC,KAAK,UAAU,EAAE,MAAM,eAAe,MAAM,CAAC;GAC7C,MAAM;EACR,UAAU;GACR,KAAK,IAAI;EACX;CACF,CACF;AACF;;;;;;;AAQA,SAAgB,cAAc,aAA+B;CAC3D,IAAI,CAAC,aACH,OAAO,QAAQ,OAAO;CAExB,OAAO,YAAY,QAAQ,QAAQ,OAAO,GAAG,GAAG,qBAAqB,YAAY,CAAC;AACpF;;AAGA,SAAgB,mBAAmB,SAAuC;CACxE,YAAY,OAAO,QAAQ,OAAO,GAAG,OAAO;AAC9C"}

package/dist/types.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/types.d.ts
 /** All lifecycle statuses a build can carry. */
 declare const BUILD_STATUSES: readonly ["pending", "capturing", "comparing", "reviewing", "approved", "rejected", "failed", "cancelled"];
 /** Lifecycle status of a build. */
@@ -69,6 +68,5 @@ declare const RESERVED_LABEL_KEYS: readonly ["build"];
  * Attach `persistent=true` to keep a build indefinitely, even after its TTL expires.
  */
 declare const PERSISTENT_LABEL_KEY = "persistent";
-//#endregion
 export { AuthUser, BUILD_STATUSES, BuildStatus, CANCELLABLE_BUILD_STATUSES, PERSISTENT_LABEL_KEY, PROJECT_ROLES, ProjectRole, RESERVED_LABEL_KEYS, REVIEW_VERDICTS, ReviewVerdict, SEEDED_LABEL_KEYS, SESSION_COOKIE, SITE_ROLES, SNAPSHOT_STATUSES, SiteRole, SnapshotStatus, TERMINAL_BUILD_STATUSES, isProjectRole };
 //# sourceMappingURL=types.d.mts.map

package/dist/types.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/types.ts
+// src/types.ts
 /** All lifecycle statuses a build can carry. */
 const BUILD_STATUSES = [
 	"pending",
@@ -81,7 +81,6 @@ const RESERVED_LABEL_KEYS = ["build"];
 * Attach `persistent=true` to keep a build indefinitely, even after its TTL expires.
 */
 const PERSISTENT_LABEL_KEY = "persistent";
-//#endregion
 export { BUILD_STATUSES, CANCELLABLE_BUILD_STATUSES, PERSISTENT_LABEL_KEY, PROJECT_ROLES, RESERVED_LABEL_KEYS, REVIEW_VERDICTS, SEEDED_LABEL_KEYS, SESSION_COOKIE, SITE_ROLES, SNAPSHOT_STATUSES, TERMINAL_BUILD_STATUSES, isProjectRole };
 
 //# sourceMappingURL=types.mjs.map

package/dist/urls.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/urls.d.ts
 /** Type-safe URL builder for project pages and published Storybooks. */
 interface UrlBuilder {
   projectsList(): string;
@@ -37,6 +36,5 @@ declare function createUrlBuilder(baseUrl: string, publishedBaseDomain?: string)
  * app-relative paths only, so `javascript:`/`data:` payloads fall back.
  */
 declare function safeImageUrl(value: string | undefined): string | null;
-//#endregion
 export { UrlBuilder, createUrlBuilder, safeImageUrl };
 //# sourceMappingURL=urls.d.mts.map

package/dist/urls.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/urls.ts
+// src/urls.ts
 /**
 * Create a URL builder rooted at the given base URL.
 *
@@ -52,7 +52,6 @@ function safeImageUrl(value) {
 function encodePath(value) {
 	return value.split("/").map((segment) => encodeURIComponent(segment)).join("/");
 }
-//#endregion
 export { createUrlBuilder, safeImageUrl };
 
 //# sourceMappingURL=urls.mjs.map

package/dist/utils/adaptive-concurrency.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { Logger } from "../logger.mjs";
-//#region src/utils/adaptive-concurrency.d.ts
 /** Tuning for {@link AdaptiveConcurrency}. */
 interface AdaptiveOptions {
   /** Starting in-flight limit. */
@@ -61,6 +60,5 @@ declare class AdaptiveConcurrency {
 }
 /** Whether an error is a navigation/action timeout (Playwright and Puppeteer both name it `TimeoutError`). */
 declare function isTimeoutError(error: unknown): boolean;
-//#endregion
 export { AdaptiveConcurrency, AdaptiveOptions, Observation, isTimeoutError };
 //# sourceMappingURL=adaptive-concurrency.d.mts.map

package/dist/utils/adaptive-concurrency.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { monitorEventLoopDelay } from "node:perf_hooks";
-//#region src/utils/adaptive-concurrency.ts
+// src/utils/adaptive-concurrency.ts
 /** Adaptive page concurrency: raise while capture stays healthy, back off when it does not. */
 const MIN_WINDOW = 8;
 /**
@@ -143,7 +143,6 @@ function eventLoopLagReader() {
 		}
 	};
 }
-//#endregion
 export { AdaptiveConcurrency, isTimeoutError };
 
 //# sourceMappingURL=adaptive-concurrency.mjs.map

package/dist/utils/connect-retry.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/utils/connect-retry.d.ts
 /** Retrying a connection to a remote browser service (ADR 0007, decision 4). */
 /** Options of {@link retryConnect}. */
 interface RetryConnectOptions {
@@ -8,6 +7,8 @@ interface RetryConnectOptions {
   retries: number;
   /** Delay before the first retry in ms; doubles each time, with jitter, capped at 10 s. */
   backoffMs: number;
+  /** Whether an error is worth another attempt; defaults to {@link isRetryableConnectError}. */
+  retryable?: (error: unknown) => boolean;
   /** Called before each retry with the error, the retry's number (from 1) and its delay. */
   onRetry?: (error: unknown, retry: number, delayMs: number) => void;
   /** Injectable for tests. */
@@ -21,6 +22,5 @@ declare function isRetryableConnectError(error: unknown): boolean;
  * while rendering. The last error is thrown once the retries are spent.
  */
 declare function retryConnect<T>(connect: () => Promise<T>, options: RetryConnectOptions): Promise<T>;
-//#endregion
 export { RetryConnectOptions, isRetryableConnectError, retryConnect };
 //# sourceMappingURL=connect-retry.d.mts.map

package/dist/utils/connect-retry.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/utils/connect-retry.ts
+// src/utils/connect-retry.ts
 const MAX_DELAY_MS = 1e4;
 /** Errors that no retry fixes: a refused credential, a missing endpoint, mismatched versions. */
 const PERMANENT = /\b(?:401|403|404|428|unauthorized|forbidden|version mismatch|invalid (?:token|credentials)|not found)\b/iu;
@@ -22,7 +22,7 @@ async function retryConnect(connect, options) {
 	for (let retry = 0;; retry += 1) try {
 		return await connect();
 	} catch (error) {
-		if (retry >= options.retries || !isRetryableConnectError(error)) throw error;
+		if (retry >= options.retries || !(options.retryable ?? isRetryableConnectError)(error)) throw error;
 		const delayMs = Math.min(MAX_DELAY_MS, options.backoffMs * 2 ** retry) * jitter();
 		options.onRetry?.(error, retry + 1, Math.round(delayMs));
 		await sleep(delayMs);
@@ -37,7 +37,6 @@ async function sleepFor(ms) {
 		setTimeout(resolve, ms);
 	});
 }
-//#endregion
 export { isRetryableConnectError, retryConnect };
 
 //# sourceMappingURL=connect-retry.mjs.map

package/dist/utils/connect-retry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"connect-retry.mjs","names":[],"sources":["../../src/utils/connect-retry.ts"],"sourcesContent":["/** Retrying a connection to a remote browser service (ADR 0007, decision 4). */\n\n/** Options of {@link retryConnect}. */\nexport interface RetryConnectOptions {\n  /** Retries after the first attempt. */\n  retries: number;\n  /** Delay before the first retry in ms; doubles each time, with jitter, capped at 10 s. */\n  backoffMs: number;\n  /** Called before each retry with the error, the retry's number (from 1) and its delay. */\n  onRetry?: (error: unknown, retry: number, delayMs: number) => void;\n  /** Injectable for tests. */\n  sleep?: (ms: number) => Promise<void>;\n}\n\nconst MAX_DELAY_MS = 10_000;\n\n/** Errors that no retry fixes: a refused credential, a missing endpoint, mismatched versions. */\nconst PERMANENT =\n  /\\b(?:401|403|404|428|unauthorized|forbidden|version mismatch|invalid (?:token|credentials)|not found)\\b/iu;\n\n/** Errors of the connection itself: refused, dropped, timed out, or a service with no free session. */\nconst CONNECTION =\n  /(?:ECONNREFUSED|ECONNRESET|EPIPE|ETIMEDOUT|ENOTFOUND|EAI_AGAIN|EHOSTUNREACH|socket hang up|websocket error|connection (?:closed|refused|reset)|timeout|timed out|capacity|too many|queue(?:d)? full|no (?:free )?(?:session|browser)|\\b(?:408|425|429|500|502|503|504)\\b)/iu;\n\n/** Whether a connect error is worth retrying: connection-level, not a configuration mistake. */\nexport function isRetryableConnectError(error: unknown): boolean {\n  const text = error instanceof Error ? error.message : String(error);\n  return !PERMANENT.test(text) && CONNECTION.test(text);\n}\n\n/**\n * Run `connect`, retrying a connection-level failure with exponential backoff, so a provider\n * outage or a full plan is absorbed here and crash isolation only ever sees a browser that died\n * while rendering. The last error is thrown once the retries are spent.\n */\nexport async function retryConnect<T>(\n  connect: () => Promise<T>,\n  options: RetryConnectOptions,\n): Promise<T> {\n  const sleep = options.sleep ?? sleepFor;\n  for (let retry = 0; ; retry += 1) {\n    try {\n      // oxlint-disable-next-line eslint/no-await-in-loop -- attempts are sequential by design\n      return await connect();\n    } catch (error) {\n      if (retry >= options.retries || !isRetryableConnectError(error)) {\n        throw error;\n      }\n      const delayMs = Math.min(MAX_DELAY_MS, options.backoffMs * 2 ** retry) * jitter();\n      options.onRetry?.(error, retry + 1, Math.round(delayMs));\n      // oxlint-disable-next-line eslint/no-await-in-loop -- backoff between sequential attempts\n      await sleep(delayMs);\n    }\n  }\n}\n\n/** 0.75 to 1.25: providers refusing for capacity should not see every shard retry in step. */\nfunction jitter(): number {\n  return 0.75 + Math.random() * 0.5;\n}\n\nasync function sleepFor(ms: number): Promise<void> {\n  await new Promise<void>((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n"],"mappings":";;;;AAcA,MAAM,eAAe;;AAGrB,MAAM,YACJ;;AAGF,MAAM,aACJ;;AAGF,SAAgB,wBAAwB,OAAyB;CAC/D,MAAM,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;CAClE,OAAO,CAAC,UAAU,KAAK,IAAI,KAAK,WAAW,KAAK,IAAI;AACtD;;;;;;AAOA,eAAsB,aACpB,SACA,SACY;CACZ,MAAM,QAAQ,QAAQ,SAAS;CAC/B,KAAK,IAAI,QAAQ,IAAK,SAAS,GAC7B,IAAI;EAEF,OAAO,MAAM,QAAQ;CACvB,SAAS,OAAO;EACd,IAAI,SAAS,QAAQ,WAAW,CAAC,wBAAwB,KAAK,GAC5D,MAAM;EAER,MAAM,UAAU,KAAK,IAAI,cAAc,QAAQ,YAAY,KAAK,KAAK,IAAI,OAAO;EAChF,QAAQ,UAAU,OAAO,QAAQ,GAAG,KAAK,MAAM,OAAO,CAAC;EAEvD,MAAM,MAAM,OAAO;CACrB;AAEJ;;AAGA,SAAS,SAAiB;CACxB,OAAO,MAAO,KAAK,OAAO,IAAI;AAChC;AAEA,eAAe,SAAS,IAA2B;CACjD,MAAM,IAAI,SAAe,YAAY;EACnC,WAAW,SAAS,EAAE;CACxB,CAAC;AACH"}
+{"version":3,"file":"connect-retry.mjs","names":[],"sources":["../../src/utils/connect-retry.ts"],"sourcesContent":["/** Retrying a connection to a remote browser service (ADR 0007, decision 4). */\n\n/** Options of {@link retryConnect}. */\nexport interface RetryConnectOptions {\n  /** Retries after the first attempt. */\n  retries: number;\n  /** Delay before the first retry in ms; doubles each time, with jitter, capped at 10 s. */\n  backoffMs: number;\n  /** Whether an error is worth another attempt; defaults to {@link isRetryableConnectError}. */\n  retryable?: (error: unknown) => boolean;\n  /** Called before each retry with the error, the retry's number (from 1) and its delay. */\n  onRetry?: (error: unknown, retry: number, delayMs: number) => void;\n  /** Injectable for tests. */\n  sleep?: (ms: number) => Promise<void>;\n}\n\nconst MAX_DELAY_MS = 10_000;\n\n/** Errors that no retry fixes: a refused credential, a missing endpoint, mismatched versions. */\nconst PERMANENT =\n  /\\b(?:401|403|404|428|unauthorized|forbidden|version mismatch|invalid (?:token|credentials)|not found)\\b/iu;\n\n/** Errors of the connection itself: refused, dropped, timed out, or a service with no free session. */\nconst CONNECTION =\n  /(?:ECONNREFUSED|ECONNRESET|EPIPE|ETIMEDOUT|ENOTFOUND|EAI_AGAIN|EHOSTUNREACH|socket hang up|websocket error|connection (?:closed|refused|reset)|timeout|timed out|capacity|too many|queue(?:d)? full|no (?:free )?(?:session|browser)|\\b(?:408|425|429|500|502|503|504)\\b)/iu;\n\n/** Whether a connect error is worth retrying: connection-level, not a configuration mistake. */\nexport function isRetryableConnectError(error: unknown): boolean {\n  const text = error instanceof Error ? error.message : String(error);\n  return !PERMANENT.test(text) && CONNECTION.test(text);\n}\n\n/**\n * Run `connect`, retrying a connection-level failure with exponential backoff, so a provider\n * outage or a full plan is absorbed here and crash isolation only ever sees a browser that died\n * while rendering. The last error is thrown once the retries are spent.\n */\nexport async function retryConnect<T>(\n  connect: () => Promise<T>,\n  options: RetryConnectOptions,\n): Promise<T> {\n  const sleep = options.sleep ?? sleepFor;\n  for (let retry = 0; ; retry += 1) {\n    try {\n      // oxlint-disable-next-line eslint/no-await-in-loop -- attempts are sequential by design\n      return await connect();\n    } catch (error) {\n      if (retry >= options.retries || !(options.retryable ?? isRetryableConnectError)(error)) {\n        throw error;\n      }\n      const delayMs = Math.min(MAX_DELAY_MS, options.backoffMs * 2 ** retry) * jitter();\n      options.onRetry?.(error, retry + 1, Math.round(delayMs));\n      // oxlint-disable-next-line eslint/no-await-in-loop -- backoff between sequential attempts\n      await sleep(delayMs);\n    }\n  }\n}\n\n/** 0.75 to 1.25: providers refusing for capacity should not see every shard retry in step. */\nfunction jitter(): number {\n  return 0.75 + Math.random() * 0.5;\n}\n\nasync function sleepFor(ms: number): Promise<void> {\n  await new Promise<void>((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n"],"mappings":";;;;AAgBA,MAAM,eAAe;;AAGrB,MAAM,YACJ;;AAGF,MAAM,aACJ;;AAGF,SAAgB,wBAAwB,OAAyB;CAC/D,MAAM,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;CAClE,OAAO,CAAC,UAAU,KAAK,IAAI,KAAK,WAAW,KAAK,IAAI;AACtD;;;;;;AAOA,eAAsB,aACpB,SACA,SACY;CACZ,MAAM,QAAQ,QAAQ,SAAS;CAC/B,KAAK,IAAI,QAAQ,IAAK,SAAS,GAC7B,IAAI;EAEF,OAAO,MAAM,QAAQ;CACvB,SAAS,OAAO;EACd,IAAI,SAAS,QAAQ,WAAW,EAAE,QAAQ,aAAa,wBAAA,CAAyB,KAAK,GACnF,MAAM;EAER,MAAM,UAAU,KAAK,IAAI,cAAc,QAAQ,YAAY,KAAK,KAAK,IAAI,OAAO;EAChF,QAAQ,UAAU,OAAO,QAAQ,GAAG,KAAK,MAAM,OAAO,CAAC;EAEvD,MAAM,MAAM,OAAO;CACrB;AAEJ;;AAGA,SAAS,SAAiB;CACxB,OAAO,MAAO,KAAK,OAAO,IAAI;AAChC;AAEA,eAAe,SAAS,IAA2B;CACjD,MAAM,IAAI,SAAe,YAAY;EACnC,WAAW,SAAS,EAAE;CACxB,CAAC;AACH"}

package/dist/utils/encrypt.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/utils/encrypt.d.ts
 /** Current server secret plus the one it replaced, kept only to decrypt older rows. */
 interface SecretKeys {
   current: string;
@@ -43,6 +42,5 @@ declare function decryptWithKey(input: SecretInput, ciphertext: string): {
  * rotation hint. A missing secret keeps its own configuration error.
  */
 declare function decryptCredential(input: SecretInput, ciphertext: string): string;
-//#endregion
 export { KeyUsed, SecretInput, SecretKeys, UndecryptableCredentialError, decrypt, decryptCredential, decryptWithKey, encrypt };
 //# sourceMappingURL=encrypt.d.mts.map

package/dist/utils/encrypt.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { createCipheriv, createDecipheriv, createHash, randomBytes } from "node:crypto";
-//#region src/utils/encrypt.ts
+// src/utils/encrypt.ts
 /** Thrown when a stored credential cannot be decrypted with any configured key. */
 var UndecryptableCredentialError = class extends Error {
 	constructor(cause) {
@@ -97,7 +97,6 @@ function decryptWith(secret, ciphertext) {
 function deriveKey(secret) {
 	return createHash("sha256").update(secret).digest();
 }
-//#endregion
 export { UndecryptableCredentialError, decrypt, decryptCredential, decryptWithKey, encrypt };
 
 //# sourceMappingURL=encrypt.mjs.map

package/dist/utils/environment.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { CaptureEnvironment } from "../adapter/capture-runner.mjs";
-//#region src/utils/environment.d.ts
 /**
  * Digest of the installed system font families (`fc-list`), or undefined where fontconfig is not
  * available. Cached for the process (fonts do not change under a running server), except a failed
@@ -14,6 +13,5 @@ declare function systemFontsHash(): Promise<string | undefined>;
  * font digest. Runners call this once per render with the version their driver reports.
  */
 declare function detectCaptureEnvironment(browserVersion?: string, deviceScaleFactor?: number): Promise<CaptureEnvironment>;
-//#endregion
 export { detectCaptureEnvironment, systemFontsHash };
 //# sourceMappingURL=environment.d.mts.map

package/dist/utils/environment.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { sha256 } from "./hash.mjs";
-//#region src/utils/environment.ts
+// src/utils/environment.ts
 let fonts;
 /**
 * Digest of the installed system font families (`fc-list`), or undefined where fontconfig is not
@@ -53,7 +53,6 @@ function digestOf(stdout) {
 	const families = [...new Set(stdout.split("\n").map((line) => line.trim()))].filter(Boolean);
 	return families.length > 0 ? sha256(families.toSorted().join("\n")).slice(0, 16) : void 0;
 }
-//#endregion
 export { detectCaptureEnvironment, systemFontsHash };
 
 //# sourceMappingURL=environment.mjs.map

package/dist/utils/hash.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/utils/hash.d.ts
 /** Hash a value with SHA-256, returning lowercase hex. */
 declare function sha256(value: string): string;
 /** Sign a value with HMAC-SHA-256, returning lowercase hex. */
@@ -12,6 +11,5 @@ declare function randomToken(prefix: string): {
 };
 /** Compare two strings in constant time to avoid timing leaks. */
 declare function timingSafeEqualString(a: string, b: string): boolean;
-//#endregion
 export { hmacSha256, randomToken, sha256, timingSafeEqualString };
 //# sourceMappingURL=hash.d.mts.map

package/dist/utils/hash.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { createHash, createHmac, randomBytes, timingSafeEqual } from "node:crypto";
-//#region src/utils/hash.ts
+// src/utils/hash.ts
 /** Hash a value with SHA-256, returning lowercase hex. */
 function sha256(value) {
 	return createHash("sha256").update(value).digest("hex");
@@ -25,7 +25,6 @@ function timingSafeEqualString(a, b) {
 	const bb = Buffer.from(b);
 	return ab.length === bb.length && timingSafeEqual(ab, bb);
 }
-//#endregion
 export { hmacSha256, randomToken, sha256, timingSafeEqualString };
 
 //# sourceMappingURL=hash.mjs.map