@storyshelf/core 0.6.2 → 0.8.0

package/dist/capture/catalog/parse.d.mts

@@ -0,0 +1,13 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { CatalogEntry } from "./types.mjs";
+/**
+ * Entries of a parsed index document, or null when it is not an index. Test entries (Storybook 10
+ * `subtype: "test"`) are left out, as capture leaves them out; entries without an id or title are
+ * skipped, never an error.
+ */
+declare function parseStorybookIndex(document: unknown): CatalogEntry[] | null;
+/** Parse the text of an index file; null when it is not JSON or not an index. */
+declare function parseStorybookIndexText(text: string): CatalogEntry[] | null;
+export { parseStorybookIndex, parseStorybookIndexText };
+//# sourceMappingURL=parse.d.mts.map

package/dist/capture/catalog/parse.mjs

@@ -0,0 +1,55 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { normalizeImportPath } from "../../models/design-resolve.mjs";
+// src/capture/catalog/parse.ts
+/** Storybook index to catalog entries: `index.json` (v4/v5), `stories.json` (v3 and older). */
+/**
+* Entries of a parsed index document, or null when it is not an index. Test entries (Storybook 10
+* `subtype: "test"`) are left out, as capture leaves them out; entries without an id or title are
+* skipped, never an error.
+*/
+function parseStorybookIndex(document) {
+	if (typeof document !== "object" || document === null) return null;
+	const record = document;
+	const table = [record.entries, record.stories].find((value) => isRecord(value));
+	if (!table) return null;
+	return Object.values(table).flatMap((raw) => {
+		const entry = toEntry(raw);
+		return entry ? [entry] : [];
+	});
+}
+/** Parse the text of an index file; null when it is not JSON or not an index. */
+function parseStorybookIndexText(text) {
+	try {
+		return parseStorybookIndex(JSON.parse(text));
+	} catch {
+		return null;
+	}
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function str(value) {
+	return typeof value === "string" && value !== "" ? value : void 0;
+}
+/** One raw entry; every field is optional on old Storybooks, so each is read defensively. */
+function toEntry(raw) {
+	if (!isRecord(raw) || raw["subtype"] === "test") return null;
+	const id = str(raw["id"]);
+	const title = str(raw["title"]) ?? str(raw["kind"]);
+	if (!id || !title) return null;
+	const importPath = str(raw["importPath"]);
+	const tags = raw["tags"];
+	return {
+		id,
+		title,
+		name: str(raw["name"]) ?? str(raw["story"]) ?? id,
+		importPath: importPath ? normalizeImportPath(importPath) : "",
+		type: raw["type"] === "docs" ? "docs" : "story",
+		tags: Array.isArray(tags) ? tags.filter((tag) => typeof tag === "string") : []
+	};
+}
+export { parseStorybookIndex, parseStorybookIndexText };
+
+//# sourceMappingURL=parse.mjs.map

package/dist/capture/catalog/parse.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.mjs","names":[],"sources":["../../../src/capture/catalog/parse.ts"],"sourcesContent":["/** Storybook index to catalog entries: `index.json` (v4/v5), `stories.json` (v3 and older). */\nimport { normalizeImportPath } from \"../../models/design-resolve.ts\";\nimport type { CatalogEntry } from \"./types.ts\";\n\n/**\n * Entries of a parsed index document, or null when it is not an index. Test entries (Storybook 10\n * `subtype: \"test\"`) are left out, as capture leaves them out; entries without an id or title are\n * skipped, never an error.\n */\nexport function parseStorybookIndex(document: unknown): CatalogEntry[] | null {\n  if (typeof document !== \"object\" || document === null) {\n    return null;\n  }\n  const record = document as { entries?: unknown; stories?: unknown };\n  const table = [record.entries, record.stories].find((value) => isRecord(value));\n  if (!table) {\n    return null;\n  }\n  return Object.values(table).flatMap((raw) => {\n    const entry = toEntry(raw);\n    return entry ? [entry] : [];\n  });\n}\n\n/** Parse the text of an index file; null when it is not JSON or not an index. */\nexport function parseStorybookIndexText(text: string): CatalogEntry[] | null {\n  try {\n    return parseStorybookIndex(JSON.parse(text));\n  } catch {\n    return null;\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction str(value: unknown): string | undefined {\n  return typeof value === \"string\" && value !== \"\" ? value : undefined;\n}\n\n/** One raw entry; every field is optional on old Storybooks, so each is read defensively. */\nfunction toEntry(raw: unknown): CatalogEntry | null {\n  if (!isRecord(raw) || raw[\"subtype\"] === \"test\") {\n    return null;\n  }\n  const id = str(raw[\"id\"]);\n  const title = str(raw[\"title\"]) ?? str(raw[\"kind\"]);\n  if (!id || !title) {\n    return null;\n  }\n  const importPath = str(raw[\"importPath\"]);\n  const tags = raw[\"tags\"];\n  return {\n    id,\n    title,\n    name: str(raw[\"name\"]) ?? str(raw[\"story\"]) ?? id,\n    importPath: importPath ? normalizeImportPath(importPath) : \"\",\n    type: raw[\"type\"] === \"docs\" ? \"docs\" : \"story\",\n    tags: Array.isArray(tags) ? tags.filter((tag): tag is string => typeof tag === \"string\") : [],\n  };\n}\n"],"mappings":";;;;;;;;;;;AASA,SAAgB,oBAAoB,UAA0C;CAC5E,IAAI,OAAO,aAAa,YAAY,aAAa,MAC/C,OAAO;CAET,MAAM,SAAS;CACf,MAAM,QAAQ,CAAC,OAAO,SAAS,OAAO,OAAO,CAAC,CAAC,MAAM,UAAU,SAAS,KAAK,CAAC;CAC9E,IAAI,CAAC,OACH,OAAO;CAET,OAAO,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,QAAQ;EAC3C,MAAM,QAAQ,QAAQ,GAAG;EACzB,OAAO,QAAQ,CAAC,KAAK,IAAI,CAAC;CAC5B,CAAC;AACH;;AAGA,SAAgB,wBAAwB,MAAqC;CAC3E,IAAI;EACF,OAAO,oBAAoB,KAAK,MAAM,IAAI,CAAC;CAC7C,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,IAAI,OAAoC;CAC/C,OAAO,OAAO,UAAU,YAAY,UAAU,KAAK,QAAQ,KAAA;AAC7D;;AAGA,SAAS,QAAQ,KAAmC;CAClD,IAAI,CAAC,SAAS,GAAG,KAAK,IAAI,eAAe,QACvC,OAAO;CAET,MAAM,KAAK,IAAI,IAAI,KAAK;CACxB,MAAM,QAAQ,IAAI,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO;CAClD,IAAI,CAAC,MAAM,CAAC,OACV,OAAO;CAET,MAAM,aAAa,IAAI,IAAI,aAAa;CACxC,MAAM,OAAO,IAAI;CACjB,OAAO;EACL;EACA;EACA,MAAM,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,QAAQ,KAAK;EAC/C,YAAY,aAAa,oBAAoB,UAAU,IAAI;EAC3D,MAAM,IAAI,YAAY,SAAS,SAAS;EACxC,MAAM,MAAM,QAAQ,IAAI,IAAI,KAAK,QAAQ,QAAuB,OAAO,QAAQ,QAAQ,IAAI,CAAC;CAC9F;AACF"}

package/dist/capture/catalog/read.d.mts

@@ -0,0 +1,15 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { StorageAdapter } from "../../adapter/storage.mjs";
+/**
+ * A file of a build's published Storybook by its path inside the build, or null when it is gone.
+ * Content-addressed builds answer through their manifest; older ones from the per-build copy.
+ */
+declare function readPublishedFile(storage: StorageAdapter, projectId: string, buildId: string, rel: string): Promise<Buffer | null>;
+/** Published bytes and, for content-addressed files, their manifest identity. */
+declare function readPublishedFileInfo(storage: StorageAdapter, projectId: string, buildId: string, rel: string): Promise<{
+  bytes: Buffer;
+  contentHash?: string;
+} | null>;
+export { readPublishedFile, readPublishedFileInfo };
+//# sourceMappingURL=read.d.mts.map

package/dist/capture/catalog/read.mjs

@@ -0,0 +1,39 @@
+import { posix } from "node:path";
+import "node:url";
+import.meta.url;
+import { storybookDir } from "../../paths.mjs";
+// src/capture/catalog/read.ts
+/** Reading a published build's files from storage. */
+/**
+* A file of a build's published Storybook by its path inside the build, or null when it is gone.
+* Content-addressed builds answer through their manifest; older ones from the per-build copy.
+*/
+async function readPublishedFile(storage, projectId, buildId, rel) {
+	return (await readPublishedFileInfo(storage, projectId, buildId, rel))?.bytes ?? null;
+}
+/** Published bytes and, for content-addressed files, their manifest identity. */
+async function readPublishedFileInfo(storage, projectId, buildId, rel) {
+	const dir = storybookDir(projectId, buildId);
+	const viaManifest = await readViaManifest(storage, dir, rel);
+	if (viaManifest) return viaManifest;
+	const legacy = posix.join(dir, rel);
+	return await storage.exists(legacy) ? { bytes: await storage.read(legacy) } : null;
+}
+async function readViaManifest(storage, dir, rel) {
+	try {
+		const manifestPath = posix.join(dir, "manifest.json");
+		if (!await storage.exists(manifestPath)) return null;
+		const hash = JSON.parse((await storage.read(manifestPath)).toString("utf8"))[rel];
+		if (!hash) return null;
+		const path = `content/${hash}`;
+		return await storage.exists(path) ? {
+			bytes: await storage.read(path),
+			contentHash: hash
+		} : null;
+	} catch {
+		return null;
+	}
+}
+export { readPublishedFile, readPublishedFileInfo };
+
+//# sourceMappingURL=read.mjs.map

package/dist/capture/catalog/read.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.mjs","names":[],"sources":["../../../src/capture/catalog/read.ts"],"sourcesContent":["/** Reading a published build's files from storage. */\nimport { posix } from \"node:path\";\nimport type { StorageAdapter } from \"../../adapters/storage.ts\";\nimport { storybookDir } from \"../../utils/paths.ts\";\n\n/**\n * A file of a build's published Storybook by its path inside the build, or null when it is gone.\n * Content-addressed builds answer through their manifest; older ones from the per-build copy.\n */\nexport async function readPublishedFile(\n  storage: StorageAdapter,\n  projectId: string,\n  buildId: string,\n  rel: string,\n): Promise<Buffer | null> {\n  return (await readPublishedFileInfo(storage, projectId, buildId, rel))?.bytes ?? null;\n}\n\n/** Published bytes and, for content-addressed files, their manifest identity. */\nexport async function readPublishedFileInfo(\n  storage: StorageAdapter,\n  projectId: string,\n  buildId: string,\n  rel: string,\n): Promise<{ bytes: Buffer; contentHash?: string } | null> {\n  const dir = storybookDir(projectId, buildId);\n  const viaManifest = await readViaManifest(storage, dir, rel);\n  if (viaManifest) {\n    return viaManifest;\n  }\n  const legacy = posix.join(dir, rel);\n  return (await storage.exists(legacy)) ? { bytes: await storage.read(legacy) } : null;\n}\n\nasync function readViaManifest(\n  storage: StorageAdapter,\n  dir: string,\n  rel: string,\n): Promise<{ bytes: Buffer; contentHash: string } | null> {\n  try {\n    const manifestPath = posix.join(dir, \"manifest.json\");\n    if (!(await storage.exists(manifestPath))) {\n      return null;\n    }\n    const manifest = JSON.parse((await storage.read(manifestPath)).toString(\"utf8\")) as Record<\n      string,\n      string\n    >;\n    const hash = manifest[rel];\n    if (!hash) return null;\n    const path = `content/${hash}`;\n    return (await storage.exists(path))\n      ? { bytes: await storage.read(path), contentHash: hash }\n      : null;\n  } catch {\n    // an unreadable manifest falls back to the per-build copy\n    return null;\n  }\n}\n"],"mappings":";;;;;;;;;;AASA,eAAsB,kBACpB,SACA,WACA,SACA,KACwB;CACxB,QAAQ,MAAM,sBAAsB,SAAS,WAAW,SAAS,GAAG,EAAA,EAAI,SAAS;AACnF;;AAGA,eAAsB,sBACpB,SACA,WACA,SACA,KACyD;CACzD,MAAM,MAAM,aAAa,WAAW,OAAO;CAC3C,MAAM,cAAc,MAAM,gBAAgB,SAAS,KAAK,GAAG;CAC3D,IAAI,aACF,OAAO;CAET,MAAM,SAAS,MAAM,KAAK,KAAK,GAAG;CAClC,OAAQ,MAAM,QAAQ,OAAO,MAAM,IAAK,EAAE,OAAO,MAAM,QAAQ,KAAK,MAAM,EAAE,IAAI;AAClF;AAEA,eAAe,gBACb,SACA,KACA,KACwD;CACxD,IAAI;EACF,MAAM,eAAe,MAAM,KAAK,KAAK,eAAe;EACpD,IAAI,CAAE,MAAM,QAAQ,OAAO,YAAY,GACrC,OAAO;EAMT,MAAM,OAJW,KAAK,OAAO,MAAM,QAAQ,KAAK,YAAY,EAAA,CAAG,SAAS,MAAM,CAI1D,CAAC,CAAC;EACtB,IAAI,CAAC,MAAM,OAAO;EAClB,MAAM,OAAO,WAAW;EACxB,OAAQ,MAAM,QAAQ,OAAO,IAAI,IAC7B;GAAE,OAAO,MAAM,QAAQ,KAAK,IAAI;GAAG,aAAa;EAAK,IACrD;CACN,QAAQ;EAEN,OAAO;CACT;AACF"}

package/dist/capture/catalog/types.d.mts

@@ -0,0 +1,31 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/** Shapes of the persisted catalog (ADR 0006, decision 9). */
+/** One Storybook index entry, kept compact: story and docs entries, never test entries. */
+interface CatalogEntry {
+  id: string;
+  title: string;
+  name: string;
+  /** Story file without a leading `./`; empty when the index carries none. */
+  importPath: string;
+  type: "story" | "docs";
+  tags: string[];
+}
+/** A build's catalog as stored in `catalog.json`. */
+interface Catalog {
+  /** Format version of the file. */
+  v: 1;
+  entries: CatalogEntry[];
+}
+/** The entries of one story file, with what `build_components` stores of them. */
+interface CatalogComponent {
+  importPath: string;
+  title: string;
+  /** Story entries; docs entries are not counted. */
+  storyCount: number;
+  /** SHA-256 over the component's entries, so two builds compare with one string. */
+  hash: string;
+  entries: CatalogEntry[];
+}
+export { Catalog, CatalogComponent, CatalogEntry };
+//# sourceMappingURL=types.d.mts.map

package/dist/capture/comparison-reference.d.mts

@@ -0,0 +1,27 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import "../adapter/database.mjs";
+import "../adapter/storage.mjs";
+import { z } from "zod";
+declare const referenceSchema: z.ZodObject<{
+  version: z.ZodLiteral<1>;
+  baselineId: z.ZodString;
+  baselineVersion: z.ZodString;
+  branch: z.ZodString;
+  defaultBranch: z.ZodBoolean;
+  sourceBuildId: z.ZodNullable<z.ZodString>;
+  sourceSnapshotId: z.ZodNullable<z.ZodString>;
+  imageSha256: z.ZodString;
+  baselineFingerprint: z.ZodNullable<z.ZodString>;
+  captureFingerprint: z.ZodNullable<z.ZodString>;
+  mode: z.ZodNullable<z.ZodString>;
+  target: z.ZodString;
+  width: z.ZodNullable<z.ZodNumber>;
+  height: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+type ComparisonReference = z.infer<typeof referenceSchema>;
+declare function parseComparisonReference(raw: string | null | undefined): ComparisonReference | null;
+/** Reject paths outside the consuming build's dedicated comparison directory. */
+declare function isComparisonImagePath(path: string, projectId: string, buildId: string): boolean;
+export { ComparisonReference, isComparisonImagePath, parseComparisonReference };
+//# sourceMappingURL=comparison-reference.d.mts.map

package/dist/capture/comparison-reference.mjs

@@ -0,0 +1,75 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import "../adapters/capture-target.mjs";
+import { ulid } from "../utils/ulid.mjs";
+import { SnapshotModel } from "../models/snapshot.mjs";
+import { z } from "zod";
+import { createHash } from "node:crypto";
+// src/capture/comparison-reference.ts
+/** Freeze a baseline image under the consuming build so it survives baseline movement. */
+const referenceSchema = z.object({
+	version: z.literal(1),
+	baselineId: z.string(),
+	baselineVersion: z.string(),
+	branch: z.string(),
+	defaultBranch: z.boolean(),
+	sourceBuildId: z.string().nullable(),
+	sourceSnapshotId: z.string().nullable(),
+	imageSha256: z.string().regex(/^[a-f0-9]{64}$/u),
+	baselineFingerprint: z.string().nullable(),
+	captureFingerprint: z.string().nullable(),
+	mode: z.string().nullable(),
+	target: z.string(),
+	width: z.number().int().positive().nullable(),
+	height: z.number().int().positive().nullable()
+});
+async function freezeComparison(storage, projectId, buildId, baseline, settings) {
+	const image = await storage.read(baseline.screenshotPath);
+	const comparisonImagePath = `${projectId}/builds/${buildId}/comparisons/${ulid()}.png`;
+	const reference = {
+		version: 1,
+		baselineId: baseline.id,
+		baselineVersion: baseline.updatedAt,
+		branch: baseline.branch,
+		defaultBranch: baseline.branch === settings.defaultBranch,
+		sourceBuildId: baseline.sourceBuildId ?? null,
+		sourceSnapshotId: settings.sourceSnapshotId,
+		imageSha256: createHash("sha256").update(image).digest("hex"),
+		baselineFingerprint: baseline.fingerprint ?? null,
+		captureFingerprint: settings.captureFingerprint ?? null,
+		mode: settings.mode,
+		target: settings.target,
+		width: settings.width,
+		height: settings.height
+	};
+	await storage.write(comparisonImagePath, image);
+	return {
+		comparisonImagePath,
+		comparisonMetadata: JSON.stringify(reference)
+	};
+}
+function parseComparisonReference(raw) {
+	if (!raw) return null;
+	try {
+		const parsed = referenceSchema.safeParse(JSON.parse(raw));
+		return parsed.success ? parsed.data : null;
+	} catch {
+		return null;
+	}
+}
+/** Reject paths outside the consuming build's dedicated comparison directory. */
+function isComparisonImagePath(path, projectId, buildId) {
+	const prefix = `${projectId}/builds/${buildId}/comparisons/`;
+	return path.startsWith(prefix) && /^[0-9A-HJKMNP-TV-Z]{26}\.png$/u.test(path.slice(prefix.length));
+}
+/** Identify a rendering snapshot only when its stored identity and image are provable. */
+async function sourceSnapshotId(db, baseline) {
+	if (!baseline.sourceBuildId || !baseline.snapshotId) return null;
+	const snapshot = await new SnapshotModel(db).get(baseline.snapshotId);
+	if (!snapshot || snapshot.inherited || snapshot.buildId !== baseline.sourceBuildId || snapshot.projectId !== baseline.projectId || snapshot.storyId !== baseline.storyId || snapshot.viewportName !== baseline.viewportName || (snapshot.browser ?? "chromium") !== (baseline.browser ?? "chromium") || snapshot.screenshotPath !== baseline.screenshotPath) return null;
+	return snapshot.id;
+}
+export { freezeComparison, isComparisonImagePath, parseComparisonReference, sourceSnapshotId };
+
+//# sourceMappingURL=comparison-reference.mjs.map

package/dist/capture/comparison-reference.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison-reference.mjs","names":[],"sources":["../../src/capture/comparison-reference.ts"],"sourcesContent":["/** Freeze a baseline image under the consuming build so it survives baseline movement. */\nimport { createHash } from \"node:crypto\";\nimport { z } from \"zod\";\nimport { DEFAULT_BROWSER } from \"../adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { SnapshotModel } from \"../models/snapshot.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\n\nconst referenceSchema = z.object({\n  version: z.literal(1),\n  baselineId: z.string(),\n  baselineVersion: z.string(),\n  branch: z.string(),\n  defaultBranch: z.boolean(),\n  sourceBuildId: z.string().nullable(),\n  sourceSnapshotId: z.string().nullable(),\n  imageSha256: z.string().regex(/^[a-f0-9]{64}$/u),\n  baselineFingerprint: z.string().nullable(),\n  captureFingerprint: z.string().nullable(),\n  mode: z.string().nullable(),\n  target: z.string(),\n  width: z.number().int().positive().nullable(),\n  height: z.number().int().positive().nullable(),\n});\nexport type ComparisonReference = z.infer<typeof referenceSchema>;\nexport interface ComparisonSettings {\n  defaultBranch: string;\n  mode: string | null;\n  target: string;\n  width: number | null;\n  height: number | null;\n  captureFingerprint: string | null;\n  sourceSnapshotId: string | null;\n}\n\nexport async function freezeComparison(\n  storage: StorageAdapter,\n  projectId: string,\n  buildId: string,\n  baseline: Baseline,\n  settings: ComparisonSettings,\n): Promise<{ comparisonImagePath: string; comparisonMetadata: string }> {\n  const image = await storage.read(baseline.screenshotPath);\n  const comparisonImagePath = `${projectId}/builds/${buildId}/comparisons/${ulid()}.png`;\n  const reference: ComparisonReference = {\n    version: 1,\n    baselineId: baseline.id,\n    baselineVersion: baseline.updatedAt,\n    branch: baseline.branch,\n    defaultBranch: baseline.branch === settings.defaultBranch,\n    sourceBuildId: baseline.sourceBuildId ?? null,\n    sourceSnapshotId: settings.sourceSnapshotId,\n    imageSha256: createHash(\"sha256\").update(image).digest(\"hex\"),\n    baselineFingerprint: baseline.fingerprint ?? null,\n    captureFingerprint: settings.captureFingerprint ?? null,\n    mode: settings.mode,\n    target: settings.target,\n    width: settings.width,\n    height: settings.height,\n  };\n  await storage.write(comparisonImagePath, image);\n  return { comparisonImagePath, comparisonMetadata: JSON.stringify(reference) };\n}\n\nexport function parseComparisonReference(\n  raw: string | null | undefined,\n): ComparisonReference | null {\n  if (!raw) return null;\n  try {\n    const parsed = referenceSchema.safeParse(JSON.parse(raw));\n    return parsed.success ? parsed.data : null;\n  } catch {\n    return null;\n  }\n}\n\n/** Reject paths outside the consuming build's dedicated comparison directory. */\nexport function isComparisonImagePath(path: string, projectId: string, buildId: string): boolean {\n  const prefix = `${projectId}/builds/${buildId}/comparisons/`;\n  return (\n    path.startsWith(prefix) && /^[0-9A-HJKMNP-TV-Z]{26}\\.png$/u.test(path.slice(prefix.length))\n  );\n}\n\n/** Identify a rendering snapshot only when its stored identity and image are provable. */\nexport async function sourceSnapshotId(\n  db: DatabaseAdapter,\n  baseline: Baseline,\n): Promise<string | null> {\n  if (!baseline.sourceBuildId || !baseline.snapshotId) return null;\n  const snapshot = await new SnapshotModel(db).get(baseline.snapshotId);\n  if (\n    !snapshot ||\n    snapshot.inherited ||\n    snapshot.buildId !== baseline.sourceBuildId ||\n    snapshot.projectId !== baseline.projectId ||\n    snapshot.storyId !== baseline.storyId ||\n    snapshot.viewportName !== baseline.viewportName ||\n    (snapshot.browser ?? DEFAULT_BROWSER) !== (baseline.browser ?? DEFAULT_BROWSER) ||\n    snapshot.screenshotPath !== baseline.screenshotPath\n  )\n    return null;\n  return snapshot.id;\n}\n"],"mappings":";;;;;;;;;;AAUA,MAAM,kBAAkB,EAAE,OAAO;CAC/B,SAAS,EAAE,QAAQ,CAAC;CACpB,YAAY,EAAE,OAAO;CACrB,iBAAiB,EAAE,OAAO;CAC1B,QAAQ,EAAE,OAAO;CACjB,eAAe,EAAE,QAAQ;CACzB,eAAe,EAAE,OAAO,CAAC,CAAC,SAAS;CACnC,kBAAkB,EAAE,OAAO,CAAC,CAAC,SAAS;CACtC,aAAa,EAAE,OAAO,CAAC,CAAC,MAAM,iBAAiB;CAC/C,qBAAqB,EAAE,OAAO,CAAC,CAAC,SAAS;CACzC,oBAAoB,EAAE,OAAO,CAAC,CAAC,SAAS;CACxC,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;CAC1B,QAAQ,EAAE,OAAO;CACjB,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC5C,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;AAC/C,CAAC;AAYD,eAAsB,iBACpB,SACA,WACA,SACA,UACA,UACsE;CACtE,MAAM,QAAQ,MAAM,QAAQ,KAAK,SAAS,cAAc;CACxD,MAAM,sBAAsB,GAAG,UAAU,UAAU,QAAQ,eAAe,KAAK,EAAE;CACjF,MAAM,YAAiC;EACrC,SAAS;EACT,YAAY,SAAS;EACrB,iBAAiB,SAAS;EAC1B,QAAQ,SAAS;EACjB,eAAe,SAAS,WAAW,SAAS;EAC5C,eAAe,SAAS,iBAAiB;EACzC,kBAAkB,SAAS;EAC3B,aAAa,WAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK;EAC5D,qBAAqB,SAAS,eAAe;EAC7C,oBAAoB,SAAS,sBAAsB;EACnD,MAAM,SAAS;EACf,QAAQ,SAAS;EACjB,OAAO,SAAS;EAChB,QAAQ,SAAS;CACnB;CACA,MAAM,QAAQ,MAAM,qBAAqB,KAAK;CAC9C,OAAO;EAAE;EAAqB,oBAAoB,KAAK,UAAU,SAAS;CAAE;AAC9E;AAEA,SAAgB,yBACd,KAC4B;CAC5B,IAAI,CAAC,KAAK,OAAO;CACjB,IAAI;EACF,MAAM,SAAS,gBAAgB,UAAU,KAAK,MAAM,GAAG,CAAC;EACxD,OAAO,OAAO,UAAU,OAAO,OAAO;CACxC,QAAQ;EACN,OAAO;CACT;AACF;;AAGA,SAAgB,sBAAsB,MAAc,WAAmB,SAA0B;CAC/F,MAAM,SAAS,GAAG,UAAU,UAAU,QAAQ;CAC9C,OACE,KAAK,WAAW,MAAM,KAAK,iCAAiC,KAAK,KAAK,MAAM,OAAO,MAAM,CAAC;AAE9F;;AAGA,eAAsB,iBACpB,IACA,UACwB;CACxB,IAAI,CAAC,SAAS,iBAAiB,CAAC,SAAS,YAAY,OAAO;CAC5D,MAAM,WAAW,MAAM,IAAI,cAAc,EAAE,CAAC,CAAC,IAAI,SAAS,UAAU;CACpE,IACE,CAAC,YACD,SAAS,aACT,SAAS,YAAY,SAAS,iBAC9B,SAAS,cAAc,SAAS,aAChC,SAAS,YAAY,SAAS,WAC9B,SAAS,iBAAiB,SAAS,iBAClC,SAAS,WAAA,iBAAiC,SAAS,WAAA,eACpD,SAAS,mBAAmB,SAAS,gBAErC,OAAO;CACT,OAAO,SAAS;AAClB"}

package/dist/capture/consumer/capture-handler.d.mts

@@ -0,0 +1,56 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Logger } from "../../logger.mjs";
+import { CaptureRunner } from "../../adapter/capture-runner.mjs";
+import { DatabaseAdapter } from "../../adapter/database.mjs";
+import { DesignProvider } from "../../adapter/design.mjs";
+import { NotifierProvider } from "../../adapters/notifier/provider.mjs";
+import { StorageAdapter } from "../../adapter/storage.mjs";
+import { ShelfConfig } from "../../config.mjs";
+import { SecretInput } from "../../utils/encrypt.mjs";
+import { CaptureJobOptions, ShardJob } from "../orchestrator.mjs";
+import { BuildStatePublisher } from "../build-state/types.mjs";
+import { DispatchDeps } from "../dispatch.mjs";
+import { KindHandler } from "./types.mjs";
+/** What the capture handler needs: the same adapters the server's own capture setup uses. */
+interface CaptureHandlerOptions {
+  /** Database adapter; its own `tables` are used (never a dialect's defaults). */
+  db: DatabaseAdapter;
+  storage: StorageAdapter;
+  /** Pure renderer; `cancel` is called when a job's lease is lost or the job is cancelled. */
+  runner: CaptureRunner;
+  /** Scratch directory for Storybook extraction. */
+  scratchDir: string;
+  logger: Logger;
+  /** Puts a shard job on the queue; sharding needs it. Defaults to the consumed queue's `enqueue`. */
+  enqueue: (job: ShardJob) => Promise<void>;
+  /** Notifier providers; `state` channels (git hosts) get the build statuses. */
+  notifiers?: NotifierProvider[];
+  /**
+   * Shows a build's state on its git channels at every transition. Default: deliver inline through
+   * `notifiers` (a capture always has `testing` on); the app passes its queue-backed publisher.
+   */
+  buildState?: BuildStatePublisher;
+  /** Links in statuses are absolute from `publicBaseUrl`; published Storybooks use `publishedBaseDomain`. */
+  config?: Pick<ShelfConfig, "publicBaseUrl" | "publishedBaseDomain" | "maxZipEntries" | "maxUnzippedBytes">;
+  /**
+   * The resolved public origin (ADR 0007, decision 6): status links and URL-reaching targets use it.
+   * Default: `config.publicBaseUrl`, then the platform's address, then the origin an admin stored.
+   */
+  publicOrigin?: () => Promise<string | undefined>;
+  /** Design providers validating declared design links during capture. */
+  design?: DesignProvider[];
+  /** Server secret for webhook decryption. */
+  secret?: SecretInput;
+  viewports?: CaptureJobOptions["viewports"];
+  /** Captures per shard; unset keeps every build in one job. */
+  shardSize?: number;
+  /** Retries assumed for jobs that do not state `maxAttempts` (default 2). */
+  maxRetries?: number;
+}
+/** The `capture` handler: runs `createDispatchJob`'s runner, cancels through `runner.cancel`. */
+declare function createCaptureHandler(options: CaptureHandlerOptions): KindHandler;
+/** The dispatch dependencies the handler runs captures with; the host reuses them to write failures the pipeline never got to. */
+declare function captureDispatchDeps(options: CaptureHandlerOptions, maxRetries: number): DispatchDeps;
+export { CaptureHandlerOptions, captureDispatchDeps, createCaptureHandler };
+//# sourceMappingURL=capture-handler.d.mts.map

package/dist/capture/consumer/capture-handler.mjs

@@ -0,0 +1,117 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { extractionLimitsOf, resolvePublishLimits } from "../publish/limits.mjs";
+import { retriesOf } from "./retry.mjs";
+import { createBuildStatePublisher } from "../build-state/publisher.mjs";
+import { createPublicOriginResolver } from "../../models/public-origin.mjs";
+import { createDispatchJob } from "../dispatch.mjs";
+// src/capture/consumer/capture-handler.ts
+/** Whether a polled capture job carries the minimum shape to execute. */
+function isValidCaptureJob(job) {
+	return typeof job.buildId === "string" && job.buildId.length > 0;
+}
+/** The `capture` handler: runs `createDispatchJob`'s runner, cancels through `runner.cancel`. */
+function createCaptureHandler(options) {
+	const fallbackRetries = options.maxRetries ?? 2;
+	const dispatches = /* @__PURE__ */ new Map();
+	const dispatchFor = (retries) => {
+		const existing = dispatches.get(retries);
+		if (existing !== void 0) return existing;
+		const created = createDispatchJob(captureDispatchDeps(options, retries));
+		dispatches.set(retries, created);
+		return created;
+	};
+	dispatchFor(fallbackRetries);
+	return {
+		accepts: isValidCaptureJob,
+		run: async (job, context) => {
+			await dispatchFor(retriesOf(job, fallbackRetries))(toDispatchJob(job), { touch: () => {
+				context.touch();
+			} });
+		},
+		cancel: async (job) => {
+			await options.runner.cancel(job.buildId, job.shard);
+		}
+	};
+}
+function toDispatchJob(job) {
+	return {
+		buildId: job.buildId,
+		shard: job.shard,
+		attempts: job.attempts,
+		...job.reqId === void 0 ? {} : { reqId: job.reqId },
+		...job.traceparent === void 0 ? {} : { traceparent: job.traceparent }
+	};
+}
+/** The dispatch dependencies the handler runs captures with; the host reuses them to write failures the pipeline never got to. */
+function captureDispatchDeps(options, maxRetries) {
+	const t = options.db.tables;
+	const publicOrigin = originOf(options);
+	const jobOptions = {
+		db: options.db,
+		tables: {
+			projects: t.projects,
+			builds: t.builds,
+			buildLabels: t.buildLabels,
+			snapshots: t.snapshots,
+			baselines: t.baselines,
+			captureAttempts: t.captureAttempts,
+			captureLogs: t.captureLogs
+		},
+		storage: options.storage,
+		runner: options.runner,
+		scratchDir: options.scratchDir,
+		limits: extractionLimitsOf(resolvePublishLimits(options.config)),
+		viewports: options.viewports,
+		logger: options.logger,
+		secret: options.secret,
+		design: options.design,
+		publicOrigin,
+		shardSize: options.shardSize,
+		enqueue: options.enqueue
+	};
+	return {
+		db: options.db,
+		tables: {
+			projects: t.projects,
+			builds: t.builds,
+			buildLabels: t.buildLabels,
+			snapshots: t.snapshots,
+			captureAttempts: t.captureAttempts,
+			captureLogs: t.captureLogs
+		},
+		jobOptions,
+		buildState: options.buildState ?? inlineBuildState(options, publicOrigin),
+		logger: options.logger,
+		maxRetries
+	};
+}
+/** Inline delivery of captured builds' states through the handler's own adapters. */
+function inlineBuildState(options, publicOrigin) {
+	return createBuildStatePublisher({ deps: {
+		db: options.db,
+		storage: options.storage,
+		notifiers: options.notifiers ?? [],
+		secret: options.secret,
+		config: options.config ?? {},
+		publicOrigin,
+		flags: () => ({
+			testing: true,
+			review: false
+		}),
+		logger: options.logger
+	} });
+}
+/** The host's origin resolver, else one built from the database and `config.publicBaseUrl`. */
+function originOf(options) {
+	if (options.publicOrigin !== void 0) return options.publicOrigin;
+	const resolver = createPublicOriginResolver({
+		db: options.db,
+		config: options.config
+	});
+	return async () => await resolver.url();
+}
+export { captureDispatchDeps, createCaptureHandler, originOf };
+
+//# sourceMappingURL=capture-handler.mjs.map

package/dist/capture/consumer/capture-handler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-handler.mjs","names":[],"sources":["../../../src/capture/consumer/capture-handler.ts"],"sourcesContent":["/** The `capture` kind's handler: builds the existing core dispatch from the host's adapters. */\nimport type { CaptureRunner } from \"../../adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"../../adapters/database.ts\";\nimport type { DesignProvider } from \"../../adapters/design.ts\";\nimport type { NotifierProvider } from \"../../adapters/notifier/provider.ts\";\nimport type { StorageAdapter } from \"../../adapters/storage.ts\";\nimport type { ShelfConfig } from \"../../config.ts\";\nimport type { Logger } from \"../../logger.ts\";\nimport { createPublicOriginResolver } from \"../../models/public-origin.ts\";\nimport type { SecretInput } from \"../../utils/encrypt.ts\";\nimport { createBuildStatePublisher } from \"../build-state/publisher.ts\";\nimport type { BuildStatePublisher } from \"../build-state/types.ts\";\nimport { createDispatchJob, type CaptureDispatchJob, type DispatchDeps } from \"../dispatch.ts\";\nimport type { CaptureJobOptions, ShardJob } from \"../orchestrator.ts\";\nimport { extractionLimitsOf, resolvePublishLimits } from \"../publish/limits.ts\";\nimport { DEFAULT_MAX_RETRIES, retriesOf } from \"./retry.ts\";\nimport type { ConsumerJob, KindHandler } from \"./types.ts\";\n\n/** What the capture handler needs: the same adapters the server's own capture setup uses. */\nexport interface CaptureHandlerOptions {\n  /** Database adapter; its own `tables` are used (never a dialect's defaults). */\n  db: DatabaseAdapter;\n  storage: StorageAdapter;\n  /** Pure renderer; `cancel` is called when a job's lease is lost or the job is cancelled. */\n  runner: CaptureRunner;\n  /** Scratch directory for Storybook extraction. */\n  scratchDir: string;\n  logger: Logger;\n  /** Puts a shard job on the queue; sharding needs it. Defaults to the consumed queue's `enqueue`. */\n  enqueue: (job: ShardJob) => Promise<void>;\n  /** Notifier providers; `state` channels (git hosts) get the build statuses. */\n  notifiers?: NotifierProvider[];\n  /**\n   * Shows a build's state on its git channels at every transition. Default: deliver inline through\n   * `notifiers` (a capture always has `testing` on); the app passes its queue-backed publisher.\n   */\n  buildState?: BuildStatePublisher;\n  /** Links in statuses are absolute from `publicBaseUrl`; published Storybooks use `publishedBaseDomain`. */\n  config?: Pick<\n    ShelfConfig,\n    \"publicBaseUrl\" | \"publishedBaseDomain\" | \"maxZipEntries\" | \"maxUnzippedBytes\"\n  >;\n  /**\n   * The resolved public origin (ADR 0007, decision 6): status links and URL-reaching targets use it.\n   * Default: `config.publicBaseUrl`, then the platform's address, then the origin an admin stored.\n   */\n  publicOrigin?: () => Promise<string | undefined>;\n  /** Design providers validating declared design links during capture. */\n  design?: DesignProvider[];\n  /** Server secret for webhook decryption. */\n  secret?: SecretInput;\n  viewports?: CaptureJobOptions[\"viewports\"];\n  /** Captures per shard; unset keeps every build in one job. */\n  shardSize?: number;\n  /** Retries assumed for jobs that do not state `maxAttempts` (default 2). */\n  maxRetries?: number;\n}\n\n/** Whether a polled capture job carries the minimum shape to execute. */\nfunction isValidCaptureJob(job: ConsumerJob): boolean {\n  return typeof job.buildId === \"string\" && job.buildId.length > 0;\n}\n\n/** The `capture` handler: runs `createDispatchJob`'s runner, cancels through `runner.cancel`. */\nexport function createCaptureHandler(options: CaptureHandlerOptions): KindHandler {\n  const fallbackRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;\n  // The shard rule (\"a shard's last try is its final word\") depends on the queue's retry limit,\n  // which a database job states itself, so one dispatch exists per distinct limit.\n  const dispatches = new Map<number, ReturnType<typeof createDispatchJob>>();\n  const dispatchFor = (retries: number): ReturnType<typeof createDispatchJob> => {\n    const existing = dispatches.get(retries);\n    if (existing !== undefined) {\n      return existing;\n    }\n    const created = createDispatchJob(captureDispatchDeps(options, retries));\n    dispatches.set(retries, created);\n    return created;\n  };\n  dispatchFor(fallbackRetries);\n  return {\n    accepts: isValidCaptureJob,\n    run: async (job, context) => {\n      await dispatchFor(retriesOf(job, fallbackRetries))(toDispatchJob(job), {\n        touch: () => {\n          context.touch();\n        },\n      });\n    },\n    cancel: async (job) => {\n      await options.runner.cancel(job.buildId, job.shard);\n    },\n  };\n}\n\nfunction toDispatchJob(job: ConsumerJob): CaptureDispatchJob {\n  return {\n    buildId: job.buildId,\n    shard: job.shard,\n    attempts: job.attempts,\n    ...(job.reqId === undefined ? {} : { reqId: job.reqId }),\n    ...(job.traceparent === undefined ? {} : { traceparent: job.traceparent }),\n  };\n}\n\n/** The dispatch dependencies the handler runs captures with; the host reuses them to write failures the pipeline never got to. */\nexport function captureDispatchDeps(\n  options: CaptureHandlerOptions,\n  maxRetries: number,\n): DispatchDeps {\n  const t = options.db.tables;\n  const publicOrigin = originOf(options);\n  const jobOptions: CaptureJobOptions = {\n    db: options.db,\n    tables: {\n      projects: t.projects,\n      builds: t.builds,\n      buildLabels: t.buildLabels,\n      snapshots: t.snapshots,\n      baselines: t.baselines,\n      captureAttempts: t.captureAttempts,\n      captureLogs: t.captureLogs,\n    },\n    storage: options.storage,\n    runner: options.runner,\n    scratchDir: options.scratchDir,\n    limits: extractionLimitsOf(resolvePublishLimits(options.config)),\n    viewports: options.viewports,\n    logger: options.logger,\n    secret: options.secret,\n    design: options.design,\n    publicOrigin,\n    shardSize: options.shardSize,\n    enqueue: options.enqueue,\n  };\n  return {\n    db: options.db,\n    tables: {\n      projects: t.projects,\n      builds: t.builds,\n      buildLabels: t.buildLabels,\n      snapshots: t.snapshots,\n      captureAttempts: t.captureAttempts,\n      captureLogs: t.captureLogs,\n    },\n    jobOptions,\n    buildState: options.buildState ?? inlineBuildState(options, publicOrigin),\n    logger: options.logger,\n    maxRetries,\n  };\n}\n\n/** Inline delivery of captured builds' states through the handler's own adapters. */\nfunction inlineBuildState(\n  options: CaptureHandlerOptions,\n  publicOrigin: () => Promise<string | undefined>,\n): BuildStatePublisher {\n  return createBuildStatePublisher({\n    deps: {\n      db: options.db,\n      storage: options.storage,\n      notifiers: options.notifiers ?? [],\n      secret: options.secret,\n      config: options.config ?? {},\n      publicOrigin,\n      flags: () => ({ testing: true, review: false }),\n      logger: options.logger,\n    },\n  });\n}\n\n/** The host's origin resolver, else one built from the database and `config.publicBaseUrl`. */\nexport function originOf(\n  options: Pick<CaptureHandlerOptions, \"db\" | \"config\" | \"publicOrigin\">,\n): () => Promise<string | undefined> {\n  if (options.publicOrigin !== undefined) {\n    return options.publicOrigin;\n  }\n  const resolver = createPublicOriginResolver({ db: options.db, config: options.config });\n  return async () => await resolver.url();\n}\n"],"mappings":";;;;;;;;;;AA2DA,SAAS,kBAAkB,KAA2B;CACpD,OAAO,OAAO,IAAI,YAAY,YAAY,IAAI,QAAQ,SAAS;AACjE;;AAGA,SAAgB,qBAAqB,SAA6C;CAChF,MAAM,kBAAkB,QAAQ,cAAA;CAGhC,MAAM,6BAAa,IAAI,IAAkD;CACzE,MAAM,eAAe,YAA0D;EAC7E,MAAM,WAAW,WAAW,IAAI,OAAO;EACvC,IAAI,aAAa,KAAA,GACf,OAAO;EAET,MAAM,UAAU,kBAAkB,oBAAoB,SAAS,OAAO,CAAC;EACvE,WAAW,IAAI,SAAS,OAAO;EAC/B,OAAO;CACT;CACA,YAAY,eAAe;CAC3B,OAAO;EACL,SAAS;EACT,KAAK,OAAO,KAAK,YAAY;GAC3B,MAAM,YAAY,UAAU,KAAK,eAAe,CAAC,CAAC,CAAC,cAAc,GAAG,GAAG,EACrE,aAAa;IACX,QAAQ,MAAM;GAChB,EACF,CAAC;EACH;EACA,QAAQ,OAAO,QAAQ;GACrB,MAAM,QAAQ,OAAO,OAAO,IAAI,SAAS,IAAI,KAAK;EACpD;CACF;AACF;AAEA,SAAS,cAAc,KAAsC;CAC3D,OAAO;EACL,SAAS,IAAI;EACb,OAAO,IAAI;EACX,UAAU,IAAI;EACd,GAAI,IAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,IAAI,MAAM;EACtD,GAAI,IAAI,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,IAAI,YAAY;CAC1E;AACF;;AAGA,SAAgB,oBACd,SACA,YACc;CACd,MAAM,IAAI,QAAQ,GAAG;CACrB,MAAM,eAAe,SAAS,OAAO;CACrC,MAAM,aAAgC;EACpC,IAAI,QAAQ;EACZ,QAAQ;GACN,UAAU,EAAE;GACZ,QAAQ,EAAE;GACV,aAAa,EAAE;GACf,WAAW,EAAE;GACb,WAAW,EAAE;GACb,iBAAiB,EAAE;GACnB,aAAa,EAAE;EACjB;EACA,SAAS,QAAQ;EACjB,QAAQ,QAAQ;EAChB,YAAY,QAAQ;EACpB,QAAQ,mBAAmB,qBAAqB,QAAQ,MAAM,CAAC;EAC/D,WAAW,QAAQ;EACnB,QAAQ,QAAQ;EAChB,QAAQ,QAAQ;EAChB,QAAQ,QAAQ;EAChB;EACA,WAAW,QAAQ;EACnB,SAAS,QAAQ;CACnB;CACA,OAAO;EACL,IAAI,QAAQ;EACZ,QAAQ;GACN,UAAU,EAAE;GACZ,QAAQ,EAAE;GACV,aAAa,EAAE;GACf,WAAW,EAAE;GACb,iBAAiB,EAAE;GACnB,aAAa,EAAE;EACjB;EACA;EACA,YAAY,QAAQ,cAAc,iBAAiB,SAAS,YAAY;EACxE,QAAQ,QAAQ;EAChB;CACF;AACF;;AAGA,SAAS,iBACP,SACA,cACqB;CACrB,OAAO,0BAA0B,EAC/B,MAAM;EACJ,IAAI,QAAQ;EACZ,SAAS,QAAQ;EACjB,WAAW,QAAQ,aAAa,CAAC;EACjC,QAAQ,QAAQ;EAChB,QAAQ,QAAQ,UAAU,CAAC;EAC3B;EACA,cAAc;GAAE,SAAS;GAAM,QAAQ;EAAM;EAC7C,QAAQ,QAAQ;CAClB,EACF,CAAC;AACH;;AAGA,SAAgB,SACd,SACmC;CACnC,IAAI,QAAQ,iBAAiB,KAAA,GAC3B,OAAO,QAAQ;CAEjB,MAAM,WAAW,2BAA2B;EAAE,IAAI,QAAQ;EAAI,QAAQ,QAAQ;CAAO,CAAC;CACtF,OAAO,YAAY,MAAM,SAAS,IAAI;AACxC"}

package/dist/capture/consumer/idle.d.mts

@@ -0,0 +1,15 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/**
+ * Idle backoff for queues whose `poll()` returns immediately when empty (GCP Pub/Sub synchronous
+ * pull, Azure Storage Queues). Queues that long-poll (SQS, Redis, Service Bus, the IPC queue) block
+ * inside `poll()` and never trigger it. The database queue paces itself (`db-queue/cadence.ts`).
+ */
+/** An empty poll that returns faster than this did not long-poll. */
+declare const MIN_BLOCKING_POLL_MS = 1000;
+/** Sleep for consecutive fast empty polls: 250ms doubling up to 5s. */
+declare function idleDelayMs(emptyStreak: number): number;
+/** Whether an empty poll came back too fast to have blocked on the queue. */
+declare function isFastEmptyPoll(elapsedMs: number): boolean;
+export { MIN_BLOCKING_POLL_MS, idleDelayMs, isFastEmptyPoll };
+//# sourceMappingURL=idle.d.mts.map

package/dist/capture/consumer/idle.mjs

@@ -0,0 +1,24 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/capture/consumer/idle.ts
+/**
+* Idle backoff for queues whose `poll()` returns immediately when empty (GCP Pub/Sub synchronous
+* pull, Azure Storage Queues). Queues that long-poll (SQS, Redis, Service Bus, the IPC queue) block
+* inside `poll()` and never trigger it. The database queue paces itself (`db-queue/cadence.ts`).
+*/
+/** An empty poll that returns faster than this did not long-poll. */
+const MIN_BLOCKING_POLL_MS = 1e3;
+const BASE_IDLE_MS = 250;
+const MAX_IDLE_MS = 5e3;
+/** Sleep for consecutive fast empty polls: 250ms doubling up to 5s. */
+function idleDelayMs(emptyStreak) {
+	return Math.min(MAX_IDLE_MS, BASE_IDLE_MS * 2 ** Math.max(0, emptyStreak - 1));
+}
+/** Whether an empty poll came back too fast to have blocked on the queue. */
+function isFastEmptyPoll(elapsedMs) {
+	return elapsedMs < MIN_BLOCKING_POLL_MS;
+}
+export { MIN_BLOCKING_POLL_MS, idleDelayMs, isFastEmptyPoll };
+
+//# sourceMappingURL=idle.mjs.map

package/dist/capture/consumer/idle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle.mjs","names":[],"sources":["../../../src/capture/consumer/idle.ts"],"sourcesContent":["/**\n * Idle backoff for queues whose `poll()` returns immediately when empty (GCP Pub/Sub synchronous\n * pull, Azure Storage Queues). Queues that long-poll (SQS, Redis, Service Bus, the IPC queue) block\n * inside `poll()` and never trigger it. The database queue paces itself (`db-queue/cadence.ts`).\n */\n\n/** An empty poll that returns faster than this did not long-poll. */\nexport const MIN_BLOCKING_POLL_MS = 1000;\n\nconst BASE_IDLE_MS = 250;\nconst MAX_IDLE_MS = 5000;\n\n/** Sleep for consecutive fast empty polls: 250ms doubling up to 5s. */\nexport function idleDelayMs(emptyStreak: number): number {\n  return Math.min(MAX_IDLE_MS, BASE_IDLE_MS * 2 ** Math.max(0, emptyStreak - 1));\n}\n\n/** Whether an empty poll came back too fast to have blocked on the queue. */\nexport function isFastEmptyPoll(elapsedMs: number): boolean {\n  return elapsedMs < MIN_BLOCKING_POLL_MS;\n}\n"],"mappings":";;;;;;;;;;AAOA,MAAa,uBAAuB;AAEpC,MAAM,eAAe;AACrB,MAAM,cAAc;;AAGpB,SAAgB,YAAY,aAA6B;CACvD,OAAO,KAAK,IAAI,aAAa,eAAe,KAAK,KAAK,IAAI,GAAG,cAAc,CAAC,CAAC;AAC/E;;AAGA,SAAgB,gBAAgB,WAA4B;CAC1D,OAAO,YAAY;AACrB"}

package/dist/capture/consumer/index.d.mts

@@ -0,0 +1,11 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { CaptureHandlerOptions, captureDispatchDeps, createCaptureHandler } from "./capture-handler.mjs";
+import { ConsumerMetrics, DEFAULT_SAMPLE_MS, JobFinishedEvent, JobOutcome, QueueSample, sampleQueue } from "./metrics.mjs";
+import { DEFAULT_BACKOFF_MS, DEFAULT_MAX_RETRIES, DEFAULT_WAIT_TIME_SECONDS, MAX_BACKOFF_MS, RetryConfig, backoffDelayMs, isFinalAttempt } from "./retry.mjs";
+import { CaptureConsumer, CaptureConsumerOptions, ConsumerConfig, ConsumerJob, JobHandlers, JobRunContext, KindHandler } from "./types.mjs";
+import { MIN_BLOCKING_POLL_MS, idleDelayMs, isFastEmptyPoll } from "./idle.mjs";
+/** Create a consumer of `options.queue`; nothing runs until `start()`. */
+declare function createCaptureConsumer(options: CaptureConsumerOptions): CaptureConsumer;
+export { type CaptureConsumer, type CaptureConsumerOptions, type CaptureHandlerOptions, type ConsumerConfig, type ConsumerJob, type ConsumerMetrics, DEFAULT_BACKOFF_MS, DEFAULT_MAX_RETRIES, DEFAULT_SAMPLE_MS, DEFAULT_WAIT_TIME_SECONDS, type JobFinishedEvent, type JobHandlers, type JobOutcome, type JobRunContext, type KindHandler, MAX_BACKOFF_MS, MIN_BLOCKING_POLL_MS, type QueueSample, type RetryConfig, backoffDelayMs, captureDispatchDeps, createCaptureConsumer, createCaptureHandler, idleDelayMs, isFastEmptyPoll, isFinalAttempt, sampleQueue };
+//# sourceMappingURL=index.d.mts.map