@storyshelf/core 0.1.0

package/dist/capture/orchestrator.mjs

@@ -0,0 +1,103 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { BuildModel } from "../models/build.mjs";
+import { ProjectModel } from "../models/project.mjs";
+import { storybookZipPath } from "../utils/paths.mjs";
+import { persistCapture } from "./pipeline.mjs";
+import { StorybookAdapter } from "./storybook.mjs";
+import { DEFAULT_VIEWPORTS } from "./adapter.mjs";
+import { mkdir, rm } from "node:fs/promises";
+import { join, resolve, sep } from "node:path";
+import AdmZip from "adm-zip";
+//#region src/capture/orchestrator.ts
+async function executeCaptureJob(input, options) {
+	const builds = new BuildModel(options.db);
+	const { build, project } = await loadTarget(options, input.buildId);
+	const logger = options.logger?.child({
+		buildId: input.buildId,
+		reqId: input.reqId
+	});
+	await builds.setStatus(build.id, "capturing");
+	const startTime = performance.now();
+	let storybookDir;
+	try {
+		const extractStart = performance.now();
+		storybookDir = await extractStorybook(options, project.id, build.id);
+		const extractDuration = performance.now() - extractStart;
+		logger?.info({ durationMs: Math.round(extractDuration) }, "storybook extracted");
+		const stories = await new StorybookAdapter().discover(storybookDir);
+		const viewports = options.viewports ?? DEFAULT_VIEWPORTS;
+		const renderStart = performance.now();
+		const result = await options.runner.render({
+			buildId: build.id,
+			storybookDir,
+			stories,
+			viewports,
+			logger
+		});
+		const renderDuration = performance.now() - renderStart;
+		logger?.info({
+			durationMs: Math.round(renderDuration),
+			storyCount: stories.length
+		}, "stories rendered");
+		const persistStart = performance.now();
+		await persistCapture({
+			db: options.db,
+			storage: options.storage,
+			project,
+			build,
+			viewports,
+			captures: result.captures,
+			logger
+		}, new Set(result.failures.map((failure) => failure.storyId)));
+		const persistDuration = performance.now() - persistStart;
+		logger?.info({ durationMs: Math.round(persistDuration) }, "capture persisted");
+		const totalDuration = performance.now() - startTime;
+		logger?.info({ durationMs: Math.round(totalDuration) }, "capture completed");
+	} catch (error) {
+		const totalDuration = performance.now() - startTime;
+		logger?.error({
+			durationMs: Math.round(totalDuration),
+			err: error
+		}, "capture failed");
+		await builds.setStatus(build.id, "failed").catch((markError) => {
+			logger?.error({ err: markError }, "failed to mark build failed after capture error");
+		});
+		throw error;
+	}
+}
+async function loadTarget(options, buildId) {
+	const build = await new BuildModel(options.db).get(buildId);
+	if (!build) throw new Error(`Build not found: ${buildId}`);
+	const project = await new ProjectModel(options.db).get(build.projectId);
+	if (!project) throw new Error(`Project not found: ${build.projectId}`);
+	return {
+		build,
+		project
+	};
+}
+function blockedTarget(root, entryName) {
+	const candidate = resolve(join(root, entryName));
+	return candidate !== root && !candidate.startsWith(root + sep);
+}
+function assertNoTraversal(zip, root) {
+	for (const entry of zip.getEntries()) if (blockedTarget(root, entry.entryName)) throw new Error(`Blocked path traversal in uploaded Storybook: ${entry.entryName}`);
+}
+async function extractStorybook(options, projectId, buildId) {
+	const targetDir = join(options.scratchDir, projectId, "builds", buildId, "storybook");
+	const root = resolve(targetDir);
+	const zip = new AdmZip(await options.storage.read(storybookZipPath(projectId, buildId)));
+	assertNoTraversal(zip, root);
+	await rm(targetDir, {
+		recursive: true,
+		force: true
+	});
+	await mkdir(targetDir, { recursive: true });
+	zip.extractAllTo(targetDir, true);
+	return targetDir;
+}
+//#endregion
+export { executeCaptureJob };
+
+//# sourceMappingURL=orchestrator.mjs.map

package/dist/capture/orchestrator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.mjs","names":[],"sources":["../../src/capture/orchestrator.ts"],"sourcesContent":["import { mkdir, rm } from \"node:fs/promises\";\nimport { join, resolve, sep } from \"node:path\";\n\nimport AdmZip from \"adm-zip\";\nimport type { Logger } from \"pino\";\n\nimport type { CaptureRunner } from \"../adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { BuildModel } from \"../models/build.ts\";\nimport { ProjectModel } from \"../models/project.ts\";\nimport type { Build, Project } from \"../schema.ts\";\nimport { storybookZipPath } from \"../utils/paths.ts\";\nimport { persistCapture } from \"./pipeline.ts\";\nimport { StorybookAdapter } from \"./storybook.ts\";\nimport { DEFAULT_VIEWPORTS } from \"./adapter.ts\";\nimport type { Viewport } from \"./adapter.ts\";\n\nexport interface CaptureJobOptions {\n  db: DatabaseAdapter;\n  storage: StorageAdapter;\n  runner: CaptureRunner;\n  scratchDir: string;\n  viewports?: Viewport[];\n  logger?: Logger;\n}\nexport async function executeCaptureJob(input: { buildId: string; reqId?: string }, options: CaptureJobOptions): Promise<void> {\n  const builds = new BuildModel(options.db);\n  const { build, project } = await loadTarget(options, input.buildId);\n  const logger = options.logger?.child({ buildId: input.buildId, reqId: input.reqId });\n  await builds.setStatus(build.id, \"capturing\");\n\n  const startTime = performance.now();\n  let storybookDir: string | undefined;\n  try {\n    const extractStart = performance.now();\n    storybookDir = await extractStorybook(options, project.id, build.id);\n    const extractDuration = performance.now() - extractStart;\n    logger?.info({ durationMs: Math.round(extractDuration) }, \"storybook extracted\");\n\n    const adapter = new StorybookAdapter();\n    const stories = await adapter.discover(storybookDir);\n    const viewports = options.viewports ?? DEFAULT_VIEWPORTS;\n\n    const renderStart = performance.now();\n    const result = await options.runner.render({ buildId: build.id, storybookDir, stories, viewports, logger });\n    const renderDuration = performance.now() - renderStart;\n    logger?.info({ durationMs: Math.round(renderDuration), storyCount: stories.length }, \"stories rendered\");\n\n    const persistStart = performance.now();\n    await persistCapture(\n      {\n        db: options.db,\n        storage: options.storage,\n        project,\n        build,\n        viewports,\n        captures: result.captures,\n        logger,\n      },\n      new Set(result.failures.map((failure) => failure.storyId)),\n    );\n    const persistDuration = performance.now() - persistStart;\n    logger?.info({ durationMs: Math.round(persistDuration) }, \"capture persisted\");\n\n    const totalDuration = performance.now() - startTime;\n    logger?.info({ durationMs: Math.round(totalDuration) }, \"capture completed\");\n  } catch (error) {\n    const totalDuration = performance.now() - startTime;\n    logger?.error({ durationMs: Math.round(totalDuration), err: error }, \"capture failed\");\n    await builds.setStatus(build.id, \"failed\").catch((markError: unknown) => {\n      logger?.error({ err: markError }, \"failed to mark build failed after capture error\");\n    });\n    throw error;\n  }\n}\n\nasync function loadTarget(options: CaptureJobOptions, buildId: string): Promise<{ build: Build; project: Project }> {\n  const build = await new BuildModel(options.db).get(buildId);\n  if (!build) {\n    throw new Error(`Build not found: ${buildId}`);\n  }\n  const project = await new ProjectModel(options.db).get(build.projectId);\n  if (!project) {\n    throw new Error(`Project not found: ${build.projectId}`);\n  }\n  return { build, project };\n}\n\nfunction blockedTarget(root: string, entryName: string): boolean {\n  const candidate = resolve(join(root, entryName));\n  return candidate !== root && !candidate.startsWith(root + sep);\n}\n\nfunction assertNoTraversal(zip: AdmZip, root: string): void {\n  for (const entry of zip.getEntries()) {\n    if (blockedTarget(root, entry.entryName)) {\n      throw new Error(`Blocked path traversal in uploaded Storybook: ${entry.entryName}`);\n    }\n  }\n}\n\nasync function extractStorybook(options: CaptureJobOptions, projectId: string, buildId: string): Promise<string> {\n  const targetDir = join(options.scratchDir, projectId, \"builds\", buildId, \"storybook\");\n  const root = resolve(targetDir);\n  const zip = new AdmZip(await options.storage.read(storybookZipPath(projectId, buildId)));\n  assertNoTraversal(zip, root);\n  await rm(targetDir, { recursive: true, force: true });\n  await mkdir(targetDir, { recursive: true });\n  zip.extractAllTo(targetDir, true);\n  return targetDir;\n}\n"],"mappings":"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"}

package/dist/capture/pipeline.d.mts

@@ -0,0 +1,41 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Viewport } from "./adapter.mjs";
+import { RenderedSnapshot } from "../adapter/capture-runner.mjs";
+import { DatabaseAdapter } from "../adapter/database.mjs";
+import { StorageAdapter } from "../adapter/storage.mjs";
+import { Build, Project } from "../schema.mjs";
+import { Logger } from "pino";
+//#region src/capture/pipeline.d.ts
+/** Persistence inputs for a completed capture run. */
+interface CaptureContext {
+  /** Database adapter. */
+  db: DatabaseAdapter;
+  /** Storage adapter. */
+  storage: StorageAdapter;
+  /** The project being captured. */
+  project: Project;
+  /** The build being captured. */
+  build: Build;
+  /** Viewports at which stories were captured. */
+  viewports: Viewport[];
+  /** Screenshot buffers produced by the capture renderer. */
+  captures: RenderedSnapshot[];
+  /** Optional logger for capture diagnostics. */
+  logger?: Logger;
+}
+/**
+ * Persist a completed capture run: write screenshots, diff against the branch
+ * baseline, create snapshots, and finalize the build.
+ *
+ * Rendering is performed by a pure `CaptureRunner`; this function owns only
+ * storage writes and record keeping, so it can run against any renderer.
+ *
+ * @param ctx - Capture context.
+ * @param renderFailedStoryIds - Story ids that the renderer could not capture.
+ * They are excluded from the persisted set and force the build to `failed`.
+ */
+declare function persistCapture(ctx: CaptureContext, renderFailedStoryIds?: ReadonlySet<string>): Promise<void>;
+//#endregion
+export { CaptureContext, persistCapture };
+//# sourceMappingURL=pipeline.d.mts.map

package/dist/capture/pipeline.mjs

@@ -0,0 +1,119 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { BuildModel } from "../models/build.mjs";
+import { diffPath, screenshotPath } from "../utils/paths.mjs";
+import { BaselineModel } from "../models/baseline.mjs";
+import { SnapshotModel } from "../models/snapshot.mjs";
+import { diffImages } from "../diff/engine.mjs";
+import { DEFAULT_DIFF_OPTIONS } from "../diff/options.mjs";
+//#region src/capture/pipeline.ts
+/**
+* Persist a completed capture run: write screenshots, diff against the branch
+* baseline, create snapshots, and finalize the build.
+*
+* Rendering is performed by a pure `CaptureRunner`; this function owns only
+* storage writes and record keeping, so it can run against any renderer.
+*
+* @param ctx - Capture context.
+* @param renderFailedStoryIds - Story ids that the renderer could not capture.
+* They are excluded from the persisted set and force the build to `failed`.
+*/
+async function persistCapture(ctx, renderFailedStoryIds = /* @__PURE__ */ new Set()) {
+	const failedStoryIds = new Set(renderFailedStoryIds);
+	await Promise.all(ctx.captures.map(async (capture) => {
+		try {
+			await persistSnapshot(ctx, capture);
+		} catch (error) {
+			failedStoryIds.add(capture.story.id);
+			ctx.logger?.error({
+				storyId: capture.story.id,
+				viewport: capture.viewportName,
+				err: error
+			}, "capture failed for story");
+		}
+	}));
+	await finalize(ctx, new Set(ctx.captures.map((c) => c.story.id)), failedStoryIds);
+}
+function viewportByName(ctx, name) {
+	return ctx.viewports.find((v) => v.name === name) ?? {
+		name,
+		width: 0,
+		height: 0
+	};
+}
+async function persistSnapshot(ctx, capture) {
+	const viewport = viewportByName(ctx, capture.viewportName);
+	const screenshot = screenshotPath(ctx.project.id, ctx.build.id, capture.story.id, capture.viewportName);
+	await ctx.storage.write(screenshot, capture.screenshot);
+	const baseline = await resolveBaseline(ctx, capture.story.id, capture.viewportName);
+	if (!baseline) {
+		await createWithoutBaseline(ctx, capture, viewport, screenshot);
+		return;
+	}
+	await createWithBaseline(ctx, capture, viewport, screenshot, baseline.screenshotPath);
+}
+async function resolveBaseline(ctx, storyId, viewport) {
+	return await new BaselineModel(ctx.db, ctx.storage).resolve(ctx.project.id, storyId, viewport, ctx.build.gitBranch, ctx.project.gitDefaultBranch);
+}
+async function createWithoutBaseline(ctx, capture, viewport, screenshot) {
+	const snapshots = new SnapshotModel(ctx.db);
+	const status = ctx.build.isDefault ? "approved" : "new";
+	const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {
+		storyId: capture.story.id,
+		storyName: capture.story.name,
+		storyTitle: capture.story.title,
+		storyImportPath: capture.story.importPath ?? "",
+		viewportName: capture.viewportName,
+		viewportWidth: viewport.width,
+		viewportHeight: viewport.height,
+		screenshotPath: screenshot
+	});
+	await snapshots.setStatus(snapshot.id, status);
+	if (ctx.build.isDefault) await new BaselineModel(ctx.db, ctx.storage).upsert(ctx.project.id, capture.story.id, capture.viewportName, ctx.build.gitBranch, snapshot.id, screenshot);
+}
+async function createWithBaseline(ctx, capture, viewport, screenshot, baselinePath) {
+	const current = await ctx.storage.read(screenshot);
+	const previous = await ctx.storage.read(baselinePath);
+	const options = {
+		...DEFAULT_DIFF_OPTIONS,
+		pixelThreshold: ctx.project.pixelThreshold,
+		maxDiffRatio: ctx.project.maxDiffRatio
+	};
+	const result = diffImages(previous, current, options);
+	const snapshots = new SnapshotModel(ctx.db);
+	const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {
+		storyId: capture.story.id,
+		storyName: capture.story.name,
+		storyTitle: capture.story.title,
+		storyImportPath: capture.story.importPath ?? "",
+		viewportName: capture.viewportName,
+		viewportWidth: viewport.width,
+		viewportHeight: viewport.height,
+		screenshotPath: screenshot
+	});
+	const status = result.passed ? "unchanged" : "changed";
+	const diff = diffPath(ctx.project.id, ctx.build.id, capture.story.id, capture.viewportName);
+	if (!result.passed && result.diffImage) await ctx.storage.write(diff, result.diffImage);
+	await snapshots.update(snapshot.id, {
+		status,
+		diffPath: !result.passed && result.diffImage ? diff : null,
+		diffPixels: result.diffPixels,
+		diffRatio: result.diffRatio,
+		diffPassed: result.passed
+	});
+}
+async function finalize(ctx, storyIds, failedStoryIds) {
+	const builds = new BuildModel(ctx.db);
+	const build = await builds.updateCounts(ctx.build.id);
+	const hasCaptures = storyIds.size > 0;
+	let status = "reviewing";
+	if (failedStoryIds.size > 0) status = "failed";
+	else if (hasCaptures && build.changedCount === 0) status = "approved";
+	await builds.setStatus(ctx.build.id, status);
+	if (ctx.build.isDefault && hasCaptures) await new BaselineModel(ctx.db, ctx.storage).removeOrphans(ctx.project.id, new Set(storyIds));
+}
+//#endregion
+export { persistCapture };
+
+//# sourceMappingURL=pipeline.mjs.map

package/dist/capture/pipeline.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.mjs","names":[],"sources":["../../src/capture/pipeline.ts"],"sourcesContent":["import type { Logger } from \"pino\";\n\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { RenderedSnapshot } from \"../adapters/capture-runner.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport { diffImages } from \"../diff/engine.ts\";\nimport { DEFAULT_DIFF_OPTIONS } from \"../diff/options.ts\";\nimport { BaselineModel } from \"../models/baseline.ts\";\nimport { BuildModel } from \"../models/build.ts\";\nimport { SnapshotModel } from \"../models/snapshot.ts\";\nimport type { Baseline, Build, Project } from \"../schema.ts\";\nimport type { BuildStatus } from \"../types.ts\";\nimport { diffPath, screenshotPath } from \"../utils/paths.ts\";\nimport type { Viewport } from \"./adapter.ts\";\n\n/** Persistence inputs for a completed capture run. */\nexport interface CaptureContext {\n  /** Database adapter. */\n  db: DatabaseAdapter;\n  /** Storage adapter. */\n  storage: StorageAdapter;\n  /** The project being captured. */\n  project: Project;\n  /** The build being captured. */\n  build: Build;\n  /** Viewports at which stories were captured. */\n  viewports: Viewport[];\n  /** Screenshot buffers produced by the capture renderer. */\n  captures: RenderedSnapshot[];\n  /** Optional logger for capture diagnostics. */\n  logger?: Logger;\n}\n\n/**\n * Persist a completed capture run: write screenshots, diff against the branch\n * baseline, create snapshots, and finalize the build.\n *\n * Rendering is performed by a pure `CaptureRunner`; this function owns only\n * storage writes and record keeping, so it can run against any renderer.\n *\n * @param ctx - Capture context.\n * @param renderFailedStoryIds - Story ids that the renderer could not capture.\n * They are excluded from the persisted set and force the build to `failed`.\n */\nexport async function persistCapture(ctx: CaptureContext, renderFailedStoryIds: ReadonlySet<string> = new Set()): Promise<void> {\n  const failedStoryIds = new Set(renderFailedStoryIds);\n  await Promise.all(\n    ctx.captures.map(async (capture) => {\n      try {\n        await persistSnapshot(ctx, capture);\n      } catch (error) {\n        // A failure in one story/viewport must not abort the other persists.\n        failedStoryIds.add(capture.story.id);\n        ctx.logger?.error(\n          { storyId: capture.story.id, viewport: capture.viewportName, err: error },\n          \"capture failed for story\",\n        );\n      }\n    }),\n  );\n  await finalize(ctx, new Set(ctx.captures.map((c) => c.story.id)), failedStoryIds);\n}\n\nfunction viewportByName(ctx: CaptureContext, name: string): Viewport {\n  return ctx.viewports.find((v) => v.name === name) ?? { name, width: 0, height: 0 };\n}\n\nasync function persistSnapshot(ctx: CaptureContext, capture: RenderedSnapshot): Promise<void> {\n  const viewport = viewportByName(ctx, capture.viewportName);\n  const screenshot = screenshotPath(ctx.project.id, ctx.build.id, capture.story.id, capture.viewportName);\n  await ctx.storage.write(screenshot, capture.screenshot);\n\n  const baseline = await resolveBaseline(ctx, capture.story.id, capture.viewportName);\n  if (!baseline) {\n    await createWithoutBaseline(ctx, capture, viewport, screenshot);\n    return;\n  }\n  await createWithBaseline(ctx, capture, viewport, screenshot, baseline.screenshotPath);\n}\n\nasync function resolveBaseline(ctx: CaptureContext, storyId: string, viewport: string): Promise<Baseline | null> {\n  const baselines = new BaselineModel(ctx.db, ctx.storage);\n  return await baselines.resolve(ctx.project.id, storyId, viewport, ctx.build.gitBranch, ctx.project.gitDefaultBranch);\n}\n\nasync function createWithoutBaseline(ctx: CaptureContext, capture: RenderedSnapshot, viewport: Viewport, screenshot: string): Promise<void> {\n  const snapshots = new SnapshotModel(ctx.db);\n  const status = ctx.build.isDefault ? \"approved\" : \"new\";\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    storyId: capture.story.id,\n    storyName: capture.story.name,\n    storyTitle: capture.story.title,\n    storyImportPath: capture.story.importPath ?? \"\",\n    viewportName: capture.viewportName,\n    viewportWidth: viewport.width,\n    viewportHeight: viewport.height,\n    screenshotPath: screenshot,\n  });\n  await snapshots.setStatus(snapshot.id, status);\n\n  if (ctx.build.isDefault) {\n    const baselines = new BaselineModel(ctx.db, ctx.storage);\n    await baselines.upsert(ctx.project.id, capture.story.id, capture.viewportName, ctx.build.gitBranch, snapshot.id, screenshot);\n  }\n}\n\nasync function createWithBaseline(ctx: CaptureContext, capture: RenderedSnapshot, viewport: Viewport, screenshot: string, baselinePath: string): Promise<void> {\n  const current = await ctx.storage.read(screenshot);\n  const previous = await ctx.storage.read(baselinePath);\n  const options = { ...DEFAULT_DIFF_OPTIONS, pixelThreshold: ctx.project.pixelThreshold, maxDiffRatio: ctx.project.maxDiffRatio };\n  const result = diffImages(previous, current, options);\n\n  const snapshots = new SnapshotModel(ctx.db);\n  const snapshot = await snapshots.create(ctx.project.id, ctx.build.id, {\n    storyId: capture.story.id,\n    storyName: capture.story.name,\n    storyTitle: capture.story.title,\n    storyImportPath: capture.story.importPath ?? \"\",\n    viewportName: capture.viewportName,\n    viewportWidth: viewport.width,\n    viewportHeight: viewport.height,\n    screenshotPath: screenshot,\n  });\n\n  const status = result.passed ? \"unchanged\" : \"changed\";\n  const diff = diffPath(ctx.project.id, ctx.build.id, capture.story.id, capture.viewportName);\n  if (!result.passed && result.diffImage) {\n    await ctx.storage.write(diff, result.diffImage);\n  }\n  await snapshots.update(snapshot.id, {\n    status,\n    diffPath: !result.passed && result.diffImage ? diff : null,\n    diffPixels: result.diffPixels,\n    diffRatio: result.diffRatio,\n    diffPassed: result.passed,\n  });\n}\n\nasync function finalize(ctx: CaptureContext, storyIds: ReadonlySet<string>, failedStoryIds: ReadonlySet<string>): Promise<void> {\n  const builds = new BuildModel(ctx.db);\n  const build = await builds.updateCounts(ctx.build.id);\n  const hasCaptures = storyIds.size > 0;\n  let status: BuildStatus = \"reviewing\";\n  if (failedStoryIds.size > 0) {\n    status = \"failed\";\n  } else if (hasCaptures && build.changedCount === 0) {\n    status = \"approved\";\n  }\n  await builds.setStatus(ctx.build.id, status);\n\n  if (ctx.build.isDefault && hasCaptures) {\n    const baselines = new BaselineModel(ctx.db, ctx.storage);\n    await baselines.removeOrphans(ctx.project.id, new Set(storyIds));\n  }\n}\n"],"mappings":"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"}

package/dist/capture/queue.d.mts

@@ -0,0 +1,35 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { CaptureJob, CaptureQueue, QueueEntry } from "../adapters/capture-queue.mjs";
+import { Logger } from "pino";
+//#region src/capture/queue.d.ts
+interface InMemoryCaptureQueueOptions {
+  concurrency: number;
+  runJob: (job: CaptureJob) => Promise<void>;
+  logger?: Logger;
+}
+declare class InMemoryCaptureQueue implements CaptureQueue {
+  private readonly options;
+  readonly metadata: {
+    readonly name: "In-Memory Queue";
+    readonly version: string;
+    readonly description: "In-process capture queue";
+    readonly kind: "memory";
+  };
+  private readonly entries;
+  private running;
+  private readonly waiting;
+  private readonly inFlight;
+  constructor(options: InMemoryCaptureQueueOptions);
+  enqueue(job: CaptureJob): Promise<void>;
+  status(buildId: string): Promise<QueueEntry | null>;
+  active(): Promise<QueueEntry[]>;
+  recent(limit: number): Promise<QueueEntry[]>;
+  private process;
+  private log;
+  private track;
+  private acquire;
+}
+//#endregion
+export { InMemoryCaptureQueue, InMemoryCaptureQueueOptions };
+//# sourceMappingURL=queue.d.mts.map

package/dist/capture/queue.mjs

@@ -0,0 +1,96 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/capture/queue.ts
+var InMemoryCaptureQueue = class {
+	options;
+	metadata = {
+		name: "In-Memory Queue",
+		version: "0.1.0",
+		description: "In-process capture queue",
+		kind: "memory"
+	};
+	entries = /* @__PURE__ */ new Map();
+	running = 0;
+	waiting = [];
+	inFlight = /* @__PURE__ */ new Map();
+	constructor(options) {
+		this.options = options;
+	}
+	async enqueue(job) {
+		const entry = this.track(job.buildId);
+		this.log(job)?.info("capture queued");
+		this.inFlight.set(job.buildId, this.process(job, entry));
+		await Promise.resolve();
+	}
+	async status(buildId) {
+		return await Promise.resolve(this.entries.get(buildId) ?? null);
+	}
+	async active() {
+		return await Promise.resolve([...this.entries.values()].filter((entry) => entry.status === "queued" || entry.status === "running").toSorted((a, b) => a.queuedAt.localeCompare(b.queuedAt)));
+	}
+	async recent(limit) {
+		return await Promise.resolve([...this.entries.values()].toSorted((a, b) => b.queuedAt.localeCompare(a.queuedAt)).slice(0, limit));
+	}
+	async process(job, entry) {
+		const log = this.log(job);
+		await this.acquire();
+		entry.status = "running";
+		entry.startedAt = (/* @__PURE__ */ new Date()).toISOString();
+		log?.info("capture started");
+		try {
+			await this.options.runJob(job);
+		} catch (error) {
+			entry.status = "failed";
+			entry.finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+			entry.error = error instanceof Error ? error.message : "Capture failed";
+			log?.error({ err: error }, "capture failed");
+		} finally {
+			this.running -= 1;
+			this.waiting.shift()?.();
+			if (entry.status !== "failed") {
+				entry.status = "completed";
+				entry.finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+				log?.info("capture completed");
+			}
+		}
+	}
+	log(job) {
+		return this.options.logger?.child({
+			buildId: job.buildId,
+			reqId: job.reqId
+		});
+	}
+	track(buildId) {
+		const existing = this.entries.get(buildId);
+		if (existing) {
+			existing.status = "queued";
+			existing.queuedAt = (/* @__PURE__ */ new Date()).toISOString();
+			existing.startedAt = void 0;
+			existing.finishedAt = void 0;
+			existing.error = void 0;
+			return existing;
+		}
+		const entry = {
+			buildId,
+			status: "queued",
+			queuedAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		this.entries.set(buildId, entry);
+		return entry;
+	}
+	async acquire() {
+		if (this.running < this.options.concurrency) {
+			this.running += 1;
+			return;
+		}
+		await new Promise((resolve) => {
+			this.waiting.push(resolve);
+		});
+		await this.acquire();
+	}
+};
+//#endregion
+export { InMemoryCaptureQueue };
+
+//# sourceMappingURL=queue.mjs.map

package/dist/capture/queue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.mjs","names":[],"sources":["../../src/capture/queue.ts"],"sourcesContent":["import type { Logger } from \"pino\";\n\nimport type { CaptureJob, CaptureQueue, QueueEntry } from \"../adapters/capture-queue.ts\";\n\ndeclare const __PKG_VERSION__: string;\n\nexport interface InMemoryCaptureQueueOptions {\n  concurrency: number;\n  runJob: (job: CaptureJob) => Promise<void>;\n  logger?: Logger;\n}\nexport class InMemoryCaptureQueue implements CaptureQueue {\n  readonly metadata = {\n    name: \"In-Memory Queue\",\n    version: typeof __PKG_VERSION__ === \"undefined\" ? \"0.0.0\" : __PKG_VERSION__, // oxlint-disable-line unicorn/no-typeof-undefined\n    description: \"In-process capture queue\",\n    kind: \"memory\",\n  } as const;\n\n  private readonly entries = new Map<string, QueueEntry>();\n  private running = 0;\n  private readonly waiting: (() => void)[] = [];\n  private readonly inFlight = new Map<string, Promise<void>>();\n\n  constructor(private readonly options: InMemoryCaptureQueueOptions) {}\n\n  async enqueue(job: CaptureJob): Promise<void> {\n    const entry = this.track(job.buildId);\n    this.log(job)?.info(\"capture queued\");\n    this.inFlight.set(job.buildId, this.process(job, entry));\n    await Promise.resolve();\n  }\n\n  async status(buildId: string): Promise<QueueEntry | null> {\n    return await Promise.resolve(this.entries.get(buildId) ?? null);\n  }\n\n  async active(): Promise<QueueEntry[]> {\n    return await Promise.resolve([...this.entries.values()]\n      .filter((entry) => entry.status === \"queued\" || entry.status === \"running\")\n      .toSorted((a, b) => a.queuedAt.localeCompare(b.queuedAt)));\n  }\n\n  async recent(limit: number): Promise<QueueEntry[]> {\n    return await Promise.resolve([...this.entries.values()].toSorted((a, b) => b.queuedAt.localeCompare(a.queuedAt)).slice(0, limit));\n  }\n\n  private async process(job: CaptureJob, entry: QueueEntry): Promise<void> {\n    const log = this.log(job);\n    await this.acquire();\n    entry.status = \"running\";\n    entry.startedAt = new Date().toISOString();\n    log?.info(\"capture started\");\n    try {\n      await this.options.runJob(job);\n    } catch (error) {\n      entry.status = \"failed\";\n      entry.finishedAt = new Date().toISOString();\n      entry.error = error instanceof Error ? error.message : \"Capture failed\";\n      log?.error({ err: error }, \"capture failed\");\n    } finally {\n      this.running -= 1;\n      this.waiting.shift()?.();\n      if (entry.status !== \"failed\") {\n        entry.status = \"completed\";\n        entry.finishedAt = new Date().toISOString();\n        log?.info(\"capture completed\");\n      }\n    }\n  }\n\n  private log(job: CaptureJob): Logger | undefined {\n    return this.options.logger?.child({ buildId: job.buildId, reqId: job.reqId });\n  }\n\n  private track(buildId: string): QueueEntry {\n    const existing = this.entries.get(buildId);\n    if (existing) {\n      existing.status = \"queued\";\n      existing.queuedAt = new Date().toISOString();\n      existing.startedAt = undefined;\n      existing.finishedAt = undefined;\n      existing.error = undefined;\n      return existing;\n    }\n    const entry: QueueEntry = { buildId, status: \"queued\", queuedAt: new Date().toISOString() };\n    this.entries.set(buildId, entry);\n    return entry;\n  }\n\n  private async acquire(): Promise<void> {\n    if (this.running < this.options.concurrency) {\n      this.running += 1;\n      return;\n    }\n    await new Promise<void>((resolve) => {\n      this.waiting.push(resolve);\n    });\n    await this.acquire();\n  }\n}"],"mappings":";;;;AAWA,IAAa,uBAAb,MAA0D;CAa3B;CAZ7B,WAAoB;EAClB,MAAM;EACN,SAAA;EACA,aAAa;EACb,MAAM;CACR;CAEA,0BAA2B,IAAI,IAAwB;CACvD,UAAkB;CAClB,UAA2C,CAAC;CAC5C,2BAA4B,IAAI,IAA2B;CAE3D,YAAY,SAAuD;EAAtC,KAAA,UAAA;CAAuC;CAEpE,MAAM,QAAQ,KAAgC;EAC5C,MAAM,QAAQ,KAAK,MAAM,IAAI,OAAO;EACpC,KAAK,IAAI,GAAG,CAAC,EAAE,KAAK,gBAAgB;EACpC,KAAK,SAAS,IAAI,IAAI,SAAS,KAAK,QAAQ,KAAK,KAAK,CAAC;EACvD,MAAM,QAAQ,QAAQ;CACxB;CAEA,MAAM,OAAO,SAA6C;EACxD,OAAO,MAAM,QAAQ,QAAQ,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;CAChE;CAEA,MAAM,SAAgC;EACpC,OAAO,MAAM,QAAQ,QAAQ,CAAC,GAAG,KAAK,QAAQ,OAAO,CAAC,CAAC,CACpD,QAAQ,UAAU,MAAM,WAAW,YAAY,MAAM,WAAW,SAAS,CAAC,CAC1E,UAAU,GAAG,MAAM,EAAE,SAAS,cAAc,EAAE,QAAQ,CAAC,CAAC;CAC7D;CAEA,MAAM,OAAO,OAAsC;EACjD,OAAO,MAAM,QAAQ,QAAQ,CAAC,GAAG,KAAK,QAAQ,OAAO,CAAC,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE,SAAS,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC;CAClI;CAEA,MAAc,QAAQ,KAAiB,OAAkC;EACvE,MAAM,MAAM,KAAK,IAAI,GAAG;EACxB,MAAM,KAAK,QAAQ;EACnB,MAAM,SAAS;EACf,MAAM,6BAAY,IAAI,KAAK,EAAA,CAAE,YAAY;EACzC,KAAK,KAAK,iBAAiB;EAC3B,IAAI;GACF,MAAM,KAAK,QAAQ,OAAO,GAAG;EAC/B,SAAS,OAAO;GACd,MAAM,SAAS;GACf,MAAM,8BAAa,IAAI,KAAK,EAAA,CAAE,YAAY;GAC1C,MAAM,QAAQ,iBAAiB,QAAQ,MAAM,UAAU;GACvD,KAAK,MAAM,EAAE,KAAK,MAAM,GAAG,gBAAgB;EAC7C,UAAU;GACR,KAAK,WAAW;GAChB,KAAK,QAAQ,MAAM,CAAC,GAAG;GACvB,IAAI,MAAM,WAAW,UAAU;IAC7B,MAAM,SAAS;IACf,MAAM,8BAAa,IAAI,KAAK,EAAA,CAAE,YAAY;IAC1C,KAAK,KAAK,mBAAmB;GAC/B;EACF;CACF;CAEA,IAAY,KAAqC;EAC/C,OAAO,KAAK,QAAQ,QAAQ,MAAM;GAAE,SAAS,IAAI;GAAS,OAAO,IAAI;EAAM,CAAC;CAC9E;CAEA,MAAc,SAA6B;EACzC,MAAM,WAAW,KAAK,QAAQ,IAAI,OAAO;EACzC,IAAI,UAAU;GACZ,SAAS,SAAS;GAClB,SAAS,4BAAW,IAAI,KAAK,EAAA,CAAE,YAAY;GAC3C,SAAS,YAAY,KAAA;GACrB,SAAS,aAAa,KAAA;GACtB,SAAS,QAAQ,KAAA;GACjB,OAAO;EACT;EACA,MAAM,QAAoB;GAAE;GAAS,QAAQ;GAAU,2BAAU,IAAI,KAAK,EAAA,CAAE,YAAY;EAAE;EAC1F,KAAK,QAAQ,IAAI,SAAS,KAAK;EAC/B,OAAO;CACT;CAEA,MAAc,UAAyB;EACrC,IAAI,KAAK,UAAU,KAAK,QAAQ,aAAa;GAC3C,KAAK,WAAW;GAChB;EACF;EACA,MAAM,IAAI,SAAe,YAAY;GACnC,KAAK,QAAQ,KAAK,OAAO;EAC3B,CAAC;EACD,MAAM,KAAK,QAAQ;CACrB;AACF"}

package/dist/capture/status-fanout.mjs

@@ -0,0 +1,66 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { StatusConfigModel } from "../models/status-config.mjs";
+import { buildCommentMarkdown } from "../adapter/git-host/helpers.mjs";
+//#region src/capture/status-fanout.ts
+async function postStatusesForBuild(opts) {
+	if (opts.providers.length === 0) return;
+	const model = new StatusConfigModel(opts.db, opts.secret);
+	const rows = await model.list(opts.project.id);
+	const ctx = `storyshelf/${opts.project.slug}`;
+	await Promise.allSettled(rows.map(async (row) => {
+		const provider = opts.providers.find((p) => p.metadata.kind === row.provider);
+		if (!provider) {
+			opts.logger?.warn({ provider: row.provider }, "no provider registered for status config");
+			return;
+		}
+		let parsed;
+		try {
+			parsed = JSON.parse(row.config);
+			provider.metadata.schema.parse(parsed);
+		} catch (error) {
+			opts.logger?.warn({
+				err: error,
+				provider: row.provider
+			}, "invalid status config");
+			return;
+		}
+		let token;
+		try {
+			token = model.decryptToken(row);
+		} catch (error) {
+			opts.logger?.warn({ err: error }, "failed to decrypt status token");
+			return;
+		}
+		const adapter = provider.create({
+			config: parsed,
+			token,
+			logger: opts.logger
+		});
+		await adapter.setStatus({
+			context: ctx,
+			gitSha: opts.sha,
+			status: opts.status,
+			url: opts.url
+		});
+		if (adapter.upsertComment) {
+			const markdown = buildCommentMarkdown(opts.status, opts.url, ctx);
+			await adapter.upsertComment({
+				sha: opts.sha,
+				url: opts.url,
+				status: opts.status,
+				markdown
+			}).catch((error) => {
+				opts.logger?.warn({
+					err: error,
+					provider: row.provider
+				}, "failed to upsert comment");
+			});
+		}
+	}));
+}
+//#endregion
+export { postStatusesForBuild };
+
+//# sourceMappingURL=status-fanout.mjs.map

package/dist/capture/status-fanout.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-fanout.mjs","names":[],"sources":["../../src/capture/status-fanout.ts"],"sourcesContent":["import type { Logger } from \"pino\";\n\nimport { StatusConfigModel } from \"../models/status-config.ts\";\nimport type { CheckStatus, GitHostProvider } from \"../adapters/git-host/index.ts\";\nimport { buildCommentMarkdown } from \"../adapters/git-host/helpers.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { Project } from \"../schema.ts\";\n\nasync function postStatusesForBuild(opts: {\n  db: DatabaseAdapter;\n  project: Project;\n  sha: string;\n  status: CheckStatus;\n  url: string;\n  providers: GitHostProvider[];\n  secret: string | undefined;\n  logger?: Logger;\n}): Promise<void> {\n  if (opts.providers.length === 0) {\n    return;\n  }\n  const model = new StatusConfigModel(opts.db, opts.secret);\n  const rows = await model.list(opts.project.id);\n  const ctx = `storyshelf/${opts.project.slug}`;\n  await Promise.allSettled(\n    rows.map(async (row) => {\n      const provider = opts.providers.find((p) => p.metadata.kind === row.provider);\n      if (!provider) {\n        opts.logger?.warn({ provider: row.provider }, \"no provider registered for status config\");\n        return;\n      }\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(row.config);\n        provider.metadata.schema.parse(parsed);\n      } catch (error: unknown) {\n        opts.logger?.warn({ err: error, provider: row.provider }, \"invalid status config\");\n        return;\n      }\n      let token: string;\n      try {\n        token = model.decryptToken(row);\n      } catch (error: unknown) {\n        opts.logger?.warn({ err: error }, \"failed to decrypt status token\");\n        return;\n      }\n      const adapter = provider.create({ config: parsed, token, logger: opts.logger });\n      await adapter.setStatus({ context: ctx, gitSha: opts.sha, status: opts.status, url: opts.url });\n      if (adapter.upsertComment) {\n        const markdown = buildCommentMarkdown(opts.status, opts.url, ctx);\n        await adapter\n          .upsertComment({ sha: opts.sha, url: opts.url, status: opts.status, markdown })\n          .catch((error: unknown) => {\n            opts.logger?.warn({ err: error, provider: row.provider }, \"failed to upsert comment\");\n          });\n      }\n    }),\n  );\n}\n\nexport { postStatusesForBuild };\n"],"mappings":";;;;;;AAQA,eAAe,qBAAqB,MASlB;CAChB,IAAI,KAAK,UAAU,WAAW,GAC5B;CAEF,MAAM,QAAQ,IAAI,kBAAkB,KAAK,IAAI,KAAK,MAAM;CACxD,MAAM,OAAO,MAAM,MAAM,KAAK,KAAK,QAAQ,EAAE;CAC7C,MAAM,MAAM,cAAc,KAAK,QAAQ;CACvC,MAAM,QAAQ,WACZ,KAAK,IAAI,OAAO,QAAQ;EACtB,MAAM,WAAW,KAAK,UAAU,MAAM,MAAM,EAAE,SAAS,SAAS,IAAI,QAAQ;EAC5E,IAAI,CAAC,UAAU;GACb,KAAK,QAAQ,KAAK,EAAE,UAAU,IAAI,SAAS,GAAG,0CAA0C;GACxF;EACF;EACA,IAAI;EACJ,IAAI;GACF,SAAS,KAAK,MAAM,IAAI,MAAM;GAC9B,SAAS,SAAS,OAAO,MAAM,MAAM;EACvC,SAAS,OAAgB;GACvB,KAAK,QAAQ,KAAK;IAAE,KAAK;IAAO,UAAU,IAAI;GAAS,GAAG,uBAAuB;GACjF;EACF;EACA,IAAI;EACJ,IAAI;GACF,QAAQ,MAAM,aAAa,GAAG;EAChC,SAAS,OAAgB;GACvB,KAAK,QAAQ,KAAK,EAAE,KAAK,MAAM,GAAG,gCAAgC;GAClE;EACF;EACA,MAAM,UAAU,SAAS,OAAO;GAAE,QAAQ;GAAQ;GAAO,QAAQ,KAAK;EAAO,CAAC;EAC9E,MAAM,QAAQ,UAAU;GAAE,SAAS;GAAK,QAAQ,KAAK;GAAK,QAAQ,KAAK;GAAQ,KAAK,KAAK;EAAI,CAAC;EAC9F,IAAI,QAAQ,eAAe;GACzB,MAAM,WAAW,qBAAqB,KAAK,QAAQ,KAAK,KAAK,GAAG;GAChE,MAAM,QACH,cAAc;IAAE,KAAK,KAAK;IAAK,KAAK,KAAK;IAAK,QAAQ,KAAK;IAAQ;GAAS,CAAC,CAAC,CAC9E,OAAO,UAAmB;IACzB,KAAK,QAAQ,KAAK;KAAE,KAAK;KAAO,UAAU,IAAI;IAAS,GAAG,0BAA0B;GACtF,CAAC;EACL;CACF,CAAC,CACH;AACF"}

package/dist/capture/storybook.d.mts

@@ -0,0 +1,14 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { StoryEntry, StorySourceAdapter } from "./adapter.mjs";
+//#region src/capture/storybook.d.ts
+declare class StorybookAdapter implements StorySourceAdapter {
+  readonly name = "storybook";
+  readonly screenshotSelector = "#storybook-root";
+  discover(source: string): Promise<StoryEntry[]>;
+  buildUrl(baseUrl: string, storyId: string): string;
+  private readIndex;
+}
+//#endregion
+export { StorybookAdapter };
+//# sourceMappingURL=storybook.d.mts.map

package/dist/capture/storybook.mjs

@@ -0,0 +1,40 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+//#region src/capture/storybook.ts
+var StorybookAdapter = class {
+	name = "storybook";
+	screenshotSelector = "#storybook-root";
+	async discover(source) {
+		const index = await this.readIndex(source);
+		return Object.values(index.entries).filter((entry) => entry.type !== "docs").map((entry) => ({
+			id: entry.id,
+			title: entry.title,
+			name: entry.name,
+			importPath: entry.importPath,
+			tags: entry.tags,
+			type: entry.type === "docs" ? "docs" : "story"
+		}));
+	}
+	buildUrl(baseUrl, storyId) {
+		return `${baseUrl}/iframe.html?id=${encodeURIComponent(storyId)}&viewMode=story`;
+	}
+	async readIndex(source) {
+		const found = (await Promise.all(["index.json", "stories.json"].map(async (name) => {
+			try {
+				const raw = await readFile(join(source, name), "utf8");
+				return JSON.parse(raw);
+			} catch {
+				return null;
+			}
+		}))).find((index) => index !== null);
+		if (found) return found;
+		throw new Error(`No Storybook index found in ${source}`);
+	}
+};
+//#endregion
+export { StorybookAdapter };
+
+//# sourceMappingURL=storybook.mjs.map

package/dist/capture/storybook.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storybook.mjs","names":[],"sources":["../../src/capture/storybook.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\nimport type { StoryEntry, StorySourceAdapter } from \"./adapter.ts\";\n\ninterface StorybookIndex {\n  v: number;\n  entries: Record<string, { id: string; name: string; title: string; importPath?: string; tags?: string[]; type: string }>;\n}\n\nexport class StorybookAdapter implements StorySourceAdapter {\n  readonly name = \"storybook\";\n  readonly screenshotSelector = \"#storybook-root\";\n\n  async discover(source: string): Promise<StoryEntry[]> {\n    const index = await this.readIndex(source);\n    return Object.values(index.entries)\n      .filter((entry) => entry.type !== \"docs\")\n      .map((entry) => ({\n        id: entry.id,\n        title: entry.title,\n        name: entry.name,\n        importPath: entry.importPath,\n        tags: entry.tags,\n        type: entry.type === \"docs\" ? \"docs\" : \"story\",\n      }));\n  }\n\n  // eslint-disable-next-line class-methods-use-this\n  buildUrl(baseUrl: string, storyId: string): string {\n    return `${baseUrl}/iframe.html?id=${encodeURIComponent(storyId)}&viewMode=story`;\n  }\n\n  // Private helper; invoked via `this` from discover.\n  // eslint-disable-next-line class-methods-use-this\n  private async readIndex(source: string): Promise<StorybookIndex> {\n    const candidates = [\"index.json\", \"stories.json\"];\n    const results = await Promise.all(\n      candidates.map(async (name) => {\n        try {\n          const raw = await readFile(join(source, name), \"utf8\");\n          return JSON.parse(raw) as StorybookIndex;\n        } catch {\n          return null;\n        }\n      }),\n    );\n    const found = results.find((index) => index !== null);\n    if (found) {\n      return found;\n    }\n    throw new Error(`No Storybook index found in ${source}`);\n  }\n}\n"],"mappings":";;;;;;AAUA,IAAa,mBAAb,MAA4D;CAC1D,OAAgB;CAChB,qBAA8B;CAE9B,MAAM,SAAS,QAAuC;EACpD,MAAM,QAAQ,MAAM,KAAK,UAAU,MAAM;EACzC,OAAO,OAAO,OAAO,MAAM,OAAO,CAAC,CAChC,QAAQ,UAAU,MAAM,SAAS,MAAM,CAAC,CACxC,KAAK,WAAW;GACf,IAAI,MAAM;GACV,OAAO,MAAM;GACb,MAAM,MAAM;GACZ,YAAY,MAAM;GAClB,MAAM,MAAM;GACZ,MAAM,MAAM,SAAS,SAAS,SAAS;EACzC,EAAE;CACN;CAGA,SAAS,SAAiB,SAAyB;EACjD,OAAO,GAAG,QAAQ,kBAAkB,mBAAmB,OAAO,EAAE;CAClE;CAIA,MAAc,UAAU,QAAyC;EAY/D,MAAM,SAAQ,MAVQ,QAAQ,IAC5B,CAFkB,cAAc,cAEvB,CAAC,CAAC,IAAI,OAAO,SAAS;GAC7B,IAAI;IACF,MAAM,MAAM,MAAM,SAAS,KAAK,QAAQ,IAAI,GAAG,MAAM;IACrD,OAAO,KAAK,MAAM,GAAG;GACvB,QAAQ;IACN,OAAO;GACT;EACF,CAAC,CACH,EAAA,CACsB,MAAM,UAAU,UAAU,IAAI;EACpD,IAAI,OACF,OAAO;EAET,MAAM,IAAI,MAAM,+BAA+B,QAAQ;CACzD;AACF"}

package/dist/config.d.mts

@@ -0,0 +1,68 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { AuthAdapter } from "./adapter/auth.mjs";
+import { CaptureQueue } from "./adapters/capture-queue.mjs";
+import { CaptureRunner } from "./adapter/capture-runner.mjs";
+import { DatabaseAdapter } from "./adapter/database.mjs";
+import { GitHostProvider } from "./adapter/git-host.mjs";
+import { StorageAdapter } from "./adapter/storage.mjs";
+import { z } from "zod";
+import { Logger } from "pino";
+//#region src/config.d.ts
+interface BrandTheme {
+  accent: string;
+  surface: {
+    base: string;
+    card: string;
+  };
+  text: {
+    primary: string;
+    secondary: string;
+  };
+  border: string;
+  status: {
+    approved: string;
+    new: string;
+    rejected: string;
+  };
+}
+interface UIConfig {
+  name?: string;
+  logo?: string;
+  favicon?: string;
+  lightTheme?: BrandTheme;
+  darkTheme?: BrandTheme;
+}
+declare const shelfConfigSchema: z.ZodObject<{
+  secret: z.ZodOptional<z.ZodString>;
+  publishedBaseDomain: z.ZodOptional<z.ZodString>;
+  captureConcurrency: z.ZodOptional<z.ZodNumber>;
+  scratchDir: z.ZodOptional<z.ZodString>;
+  purgeTtlDays: z.ZodOptional<z.ZodNumber>;
+  viewports: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+  }, z.core.$strip>>>;
+  adapters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    kind: z.ZodString;
+  }, z.core.$strip>>>;
+}, z.core.$strict>;
+type ShelfConfig = z.infer<typeof shelfConfigSchema>;
+interface ShelfOptions {
+  database: DatabaseAdapter;
+  storage: StorageAdapter;
+  captureRunner?: CaptureRunner;
+  captureQueue?: CaptureQueue;
+  auth?: AuthAdapter;
+  gitHosts?: GitHostProvider[];
+  logger?: Logger;
+  ui?: UIConfig;
+  config?: ShelfConfig;
+}
+//#endregion
+export { BrandTheme, ShelfConfig, ShelfOptions, UIConfig, shelfConfigSchema };
+//# sourceMappingURL=config.d.mts.map