@storyshelf/core 0.6.2 → 0.7.0

package/dist/adapter/git-host/comments.mjs

@@ -1,54 +0,0 @@
-import "node:path";
-import "node:url";
-import.meta.url;
-import { commentMarker } from "./helpers.mjs";
-//#region src/adapters/git-host/comments.ts
-/** Resolve the thread number, preferring the explicit value. */
-async function resolveThreadNumber(opts) {
-	return opts.prNumber ?? await opts.resolveNumber();
-}
-/** Update the marked comment if present, else create it. */
-async function findOrCreateComment(thread, marker, body, prNumber, logger) {
-	const existing = (await thread.list()).find((comment) => comment.body.includes(marker));
-	if (existing) {
-		const id = await thread.update(existing.id, body);
-		logger?.info({
-			prNumber,
-			commentId: id
-		}, "review comment updated");
-		return id;
-	}
-	const id = await thread.create(body);
-	logger?.info({
-		prNumber,
-		commentId: id
-	}, "review comment created");
-	return id;
-}
-/**
-* Create or update the single StoryShelf review comment for a build,
-* idempotent via the url marker. Returns the comment id, or `""` when no
-* review thread exists for the commit.
-*/
-async function upsertReviewComment(opts) {
-	const marker = commentMarker(opts.url);
-	const body = `${marker}\n${opts.markdown}`;
-	const number = await resolveThreadNumber(opts);
-	if (number === void 0) {
-		opts.logger?.debug({ sha: opts.sha }, "no review thread found for comment, skipping");
-		return "";
-	}
-	try {
-		return await findOrCreateComment(opts.thread(number), marker, body, number, opts.logger);
-	} catch (error) {
-		opts.logger?.error({
-			err: error,
-			prNumber: number
-		}, "failed to upsert review comment");
-		throw error;
-	}
-}
-//#endregion
-export { upsertReviewComment };
-
-//# sourceMappingURL=comments.mjs.map

package/dist/adapter/git-host/comments.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"comments.mjs","names":[],"sources":["../../../src/adapters/git-host/comments.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport { commentMarker } from \"./helpers.ts\";\n\n/** A review thread (PR or MR) hosting a single StoryShelf comment. */\nexport interface ReviewThread {\n  /** List existing comments as id/body pairs. */\n  list(): Promise<{ id: string | number; body: string }[]>;\n  /** Replace the body of an existing comment, returning its id. */\n  update(id: string | number, body: string): Promise<string>;\n  /** Create a comment, returning its id. */\n  create(body: string): Promise<string>;\n}\n\n/** Dependencies for an idempotent review-comment upsert. */\nexport interface UpsertReviewCommentOptions {\n  /** Canonical build/review URL — anchors the idempotency marker. */\n  url: string;\n  /** Markdown body appended below the marker. */\n  markdown: string;\n  /** Known thread number, skipping the lookup when provided. */\n  prNumber?: number;\n  /** Commit SHA used for the thread lookup and log context. */\n  sha: string;\n  logger?: Logger;\n  /** Resolve the thread number for the commit (PR number or MR iid). */\n  resolveNumber: () => Promise<number | undefined>;\n  /** Open the thread's comment store once the number is known. */\n  thread: (number: number) => ReviewThread;\n}\n\n/** Resolve the thread number, preferring the explicit value. */\nasync function resolveThreadNumber(opts: UpsertReviewCommentOptions): Promise<number | undefined> {\n  return opts.prNumber ?? (await opts.resolveNumber());\n}\n\n/** Update the marked comment if present, else create it. */\nasync function findOrCreateComment(\n  thread: ReviewThread,\n  marker: string,\n  body: string,\n  prNumber: number,\n  logger?: Logger,\n): Promise<string> {\n  const existing = (await thread.list()).find((comment) => comment.body.includes(marker));\n  if (existing) {\n    const id = await thread.update(existing.id, body);\n    logger?.info({ prNumber, commentId: id }, \"review comment updated\");\n    return id;\n  }\n  const id = await thread.create(body);\n  logger?.info({ prNumber, commentId: id }, \"review comment created\");\n  return id;\n}\n\n/**\n * Create or update the single StoryShelf review comment for a build,\n * idempotent via the url marker. Returns the comment id, or `\"\"` when no\n * review thread exists for the commit.\n */\nexport async function upsertReviewComment(opts: UpsertReviewCommentOptions): Promise<string> {\n  const marker = commentMarker(opts.url);\n  const body = `${marker}\\n${opts.markdown}`;\n  const number = await resolveThreadNumber(opts);\n  if (number === undefined) {\n    opts.logger?.debug({ sha: opts.sha }, \"no review thread found for comment, skipping\");\n    return \"\";\n  }\n  try {\n    return await findOrCreateComment(opts.thread(number), marker, body, number, opts.logger);\n  } catch (error) {\n    opts.logger?.error({ err: error, prNumber: number }, \"failed to upsert review comment\");\n    throw error;\n  }\n}\n"],"mappings":";;;;;;AA+BA,eAAe,oBAAoB,MAA+D;CAChG,OAAO,KAAK,YAAa,MAAM,KAAK,cAAc;AACpD;;AAGA,eAAe,oBACb,QACA,QACA,MACA,UACA,QACiB;CACjB,MAAM,YAAY,MAAM,OAAO,KAAK,EAAA,CAAG,MAAM,YAAY,QAAQ,KAAK,SAAS,MAAM,CAAC;CACtF,IAAI,UAAU;EACZ,MAAM,KAAK,MAAM,OAAO,OAAO,SAAS,IAAI,IAAI;EAChD,QAAQ,KAAK;GAAE;GAAU,WAAW;EAAG,GAAG,wBAAwB;EAClE,OAAO;CACT;CACA,MAAM,KAAK,MAAM,OAAO,OAAO,IAAI;CACnC,QAAQ,KAAK;EAAE;EAAU,WAAW;CAAG,GAAG,wBAAwB;CAClE,OAAO;AACT;;;;;;AAOA,eAAsB,oBAAoB,MAAmD;CAC3F,MAAM,SAAS,cAAc,KAAK,GAAG;CACrC,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK;CAChC,MAAM,SAAS,MAAM,oBAAoB,IAAI;CAC7C,IAAI,WAAW,KAAA,GAAW;EACxB,KAAK,QAAQ,MAAM,EAAE,KAAK,KAAK,IAAI,GAAG,8CAA8C;EACpF,OAAO;CACT;CACA,IAAI;EACF,OAAO,MAAM,oBAAoB,KAAK,OAAO,MAAM,GAAG,QAAQ,MAAM,QAAQ,KAAK,MAAM;CACzF,SAAS,OAAO;EACd,KAAK,QAAQ,MAAM;GAAE,KAAK;GAAO,UAAU;EAAO,GAAG,iCAAiC;EACtF,MAAM;CACR;AACF"}

package/dist/adapter/git-host/helpers.d.mts

@@ -1,13 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { CheckStatus } from "../git-host.mjs";
-//#region src/adapters/git-host/helpers.d.ts
-/** Human description for a check status — shared across GitHub/GitLab. */
-declare function describeStatus(status: CheckStatus): string;
-/** Markdown comment body helpers — single comment per build, idempotent via marker. */
-declare function commentMarker(url: string): string;
-/** Build the Markdown body for a StoryShelf status comment. */
-declare function buildCommentMarkdown(status: CheckStatus, url: string, context: string): string;
-//#endregion
-export { buildCommentMarkdown, commentMarker, describeStatus };
-//# sourceMappingURL=helpers.d.mts.map

package/dist/adapter/git-host/helpers.mjs

@@ -1,30 +0,0 @@
-import "node:path";
-import "node:url";
-import.meta.url;
-//#region src/adapters/git-host/helpers.ts
-/** Human description for a check status — shared across GitHub/GitLab. */
-function describeStatus(status) {
-	switch (status) {
-		case "pending": return "Visual tests pending";
-		case "success": return "Visual tests passed";
-		case "failure": return "Visual changes detected or tests failed";
-		default: return "Visual changes detected or tests failed";
-	}
-}
-/** Markdown comment body helpers — single comment per build, idempotent via marker. */
-function commentMarker(url) {
-	return `<!-- storyshelf:${url} -->`;
-}
-/** Build the Markdown body for a StoryShelf status comment. */
-function buildCommentMarkdown(status, url, context) {
-	switch (status) {
-		case "pending": return `Visual tests pending for \`${context}\` — [View build](${url})`;
-		case "success": return `Visual tests passed for \`${context}\` — [View build](${url})`;
-		case "failure": return `Visual changes detected for \`${context}\` — [View build](${url})`;
-		default: return `Visual tests for \`${context}\` — [View build](${url})`;
-	}
-}
-//#endregion
-export { buildCommentMarkdown, commentMarker, describeStatus };
-
-//# sourceMappingURL=helpers.mjs.map

package/dist/adapter/git-host/helpers.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.mjs","names":[],"sources":["../../../src/adapters/git-host/helpers.ts"],"sourcesContent":["import type { CheckStatus } from \"./index.ts\";\n\n/** Human description for a check status — shared across GitHub/GitLab. */\nexport function describeStatus(status: CheckStatus): string {\n  switch (status) {\n    case \"pending\": {\n      return \"Visual tests pending\";\n    }\n    case \"success\": {\n      return \"Visual tests passed\";\n    }\n    case \"failure\": {\n      return \"Visual changes detected or tests failed\";\n    }\n    default: {\n      return \"Visual changes detected or tests failed\";\n    }\n  }\n}\n\n/** Markdown comment body helpers — single comment per build, idempotent via marker. */\nexport function commentMarker(url: string): string {\n  return `<!-- storyshelf:${url} -->`;\n}\n\n/** Build the Markdown body for a StoryShelf status comment. */\nexport function buildCommentMarkdown(status: CheckStatus, url: string, context: string): string {\n  switch (status) {\n    case \"pending\": {\n      return `Visual tests pending for \\`${context}\\` — [View build](${url})`;\n    }\n    case \"success\": {\n      return `Visual tests passed for \\`${context}\\` — [View build](${url})`;\n    }\n    case \"failure\": {\n      return `Visual changes detected for \\`${context}\\` — [View build](${url})`;\n    }\n    default: {\n      return `Visual tests for \\`${context}\\` — [View build](${url})`;\n    }\n  }\n}\n"],"mappings":";;;;;AAGA,SAAgB,eAAe,QAA6B;CAC1D,QAAQ,QAAR;EACE,KAAK,WACH,OAAO;EAET,KAAK,WACH,OAAO;EAET,KAAK,WACH,OAAO;EAET,SACE,OAAO;CAEX;AACF;;AAGA,SAAgB,cAAc,KAAqB;CACjD,OAAO,mBAAmB,IAAI;AAChC;;AAGA,SAAgB,qBAAqB,QAAqB,KAAa,SAAyB;CAC9F,QAAQ,QAAR;EACE,KAAK,WACH,OAAO,8BAA8B,QAAQ,oBAAoB,IAAI;EAEvE,KAAK,WACH,OAAO,6BAA6B,QAAQ,oBAAoB,IAAI;EAEtE,KAAK,WACH,OAAO,iCAAiC,QAAQ,oBAAoB,IAAI;EAE1E,SACE,OAAO,sBAAsB,QAAQ,oBAAoB,IAAI;CAEjE;AACF"}

package/dist/adapter/git-host.d.mts

@@ -1,42 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { Adapter, GitAdapterMetadata } from "./metadata.mjs";
-import { Logger } from "pino";
-//#region src/adapters/git-host/index.d.ts
-/** Status of a git-host provider check. */
-type CheckStatus = "pending" | "success" | "failure";
-/** Descriptor — registered at startup, validates per-project config. */
-interface GitHostProvider extends Adapter<GitAdapterMetadata> {
-  /** Create a configured instance bound to a project config + decrypted token. */
-  create(opts: {
-    config: unknown;
-    token: string;
-    logger?: Logger;
-  }): GitHostAdapter;
-}
-/** Runtime — bound to a project config + token, posts statuses/comments. */
-interface GitHostAdapter extends Adapter<GitAdapterMetadata> {
-  /** Set the status of a commit. */
-  setStatus(opts: {
-    context: string;
-    gitSha: string;
-    status: CheckStatus;
-    url: string;
-  }): Promise<void>;
-  /** Whether the branch/sha is already merged — gate to skip capture. */
-  isMerged?(opts: {
-    sha: string;
-    branch: string;
-  }): Promise<boolean>;
-  /** Create or update a single PR comment per build (idempotent via url marker). */
-  upsertComment?(opts: {
-    prNumber?: number;
-    sha: string;
-    url: string;
-    status: CheckStatus;
-    markdown: string;
-  }): Promise<string>;
-}
-//#endregion
-export { CheckStatus, GitHostAdapter, GitHostProvider };
-//# sourceMappingURL=git-host.d.mts.map

package/dist/capture/queue.d.mts

@@ -1,38 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { CaptureJob, CaptureQueue, QueueEntry } from "../adapter/capture-queue.mjs";
-import { Logger } from "pino";
-//#region src/capture/queue.d.ts
-/** Options for the in-process capture queue. */
-interface InMemoryCaptureQueueOptions {
-  concurrency: number;
-  runJob: (job: CaptureJob) => Promise<void>;
-  logger?: Logger;
-}
-/** In-process capture queue with bounded concurrency. */
-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";
-    readonly category: "capture-queue";
-  };
-  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

@@ -1,98 +0,0 @@
-import "node:path";
-import "node:url";
-import.meta.url;
-//#region src/capture/queue.ts
-/** In-process capture queue with bounded concurrency. */
-var InMemoryCaptureQueue = class {
-	options;
-	metadata = {
-		name: "In-Memory Queue",
-		version: globalThis.__PKG_VERSION__ ?? "0.0.0",
-		description: "In-process capture queue",
-		kind: "memory",
-		category: "capture-queue"
-	};
-	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

@@ -1 +0,0 @@
-{"version":3,"file":"queue.mjs","names":[],"sources":["../../src/capture/queue.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport type { CaptureJob, CaptureQueue, QueueEntry } from \"../adapters/capture-queue.ts\";\n\ndeclare const __PKG_VERSION__: string | undefined;\n\n/** Options for the in-process capture queue. */\nexport interface InMemoryCaptureQueueOptions {\n  concurrency: number;\n  runJob: (job: CaptureJob) => Promise<void>;\n  logger?: Logger;\n}\n/** In-process capture queue with bounded concurrency. */\nexport class InMemoryCaptureQueue implements CaptureQueue {\n  readonly metadata = {\n    name: \"In-Memory Queue\",\n    version: (globalThis as unknown as { __PKG_VERSION__?: string }).__PKG_VERSION__ ?? \"0.0.0\",\n    description: \"In-process capture queue\",\n    kind: \"memory\",\n    category: \"capture-queue\",\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(\n      [...this.entries.values()]\n        .filter((entry) => entry.status === \"queued\" || entry.status === \"running\")\n        .toSorted((a, b) => a.queuedAt.localeCompare(b.queuedAt)),\n    );\n  }\n\n  async recent(limit: number): Promise<QueueEntry[]> {\n    return await Promise.resolve(\n      [...this.entries.values()]\n        .toSorted((a, b) => b.queuedAt.localeCompare(a.queuedAt))\n        .slice(0, limit),\n    );\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}\n"],"mappings":";;;;;AAYA,IAAa,uBAAb,MAA0D;CAc3B;CAb7B,WAAoB;EAClB,MAAM;EACN,SAAU,WAAuD,mBAAmB;EACpF,aAAa;EACb,MAAM;EACN,UAAU;CACZ;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,QACnB,CAAC,GAAG,KAAK,QAAQ,OAAO,CAAC,CAAC,CACvB,QAAQ,UAAU,MAAM,WAAW,YAAY,MAAM,WAAW,SAAS,CAAC,CAC1E,UAAU,GAAG,MAAM,EAAE,SAAS,cAAc,EAAE,QAAQ,CAAC,CAC5D;CACF;CAEA,MAAM,OAAO,OAAsC;EACjD,OAAO,MAAM,QAAQ,QACnB,CAAC,GAAG,KAAK,QAAQ,OAAO,CAAC,CAAC,CACvB,UAAU,GAAG,MAAM,EAAE,SAAS,cAAc,EAAE,QAAQ,CAAC,CAAC,CACxD,MAAM,GAAG,KAAK,CACnB;CACF;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/recovery.d.mts

@@ -1,21 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { DispatchDeps } from "./dispatch.mjs";
-//#region src/capture/recovery.d.ts
-/** Error recorded on attempts that a restart cut short; also the requeue-once marker. */
-declare const INTERRUPTED_ERROR = "Interrupted by server restart";
-/** Outcome of one recovery sweep. */
-interface RecoveryResult {
-  requeued: string[];
-  failed: string[];
-}
-/** Inputs for {@link recoverStuckCaptures}. */
-interface RecoveryDeps {
-  deps: DispatchDeps;
-  enqueue: (buildId: string) => Promise<void>;
-}
-/** Requeue (once) or fail every build still `capturing`; call once at boot, before serving jobs. */
-declare function recoverStuckCaptures(recovery: RecoveryDeps): Promise<RecoveryResult>;
-//#endregion
-export { INTERRUPTED_ERROR, RecoveryDeps, RecoveryResult, recoverStuckCaptures };
-//# sourceMappingURL=recovery.d.mts.map

package/dist/capture/recovery.mjs

@@ -1,83 +0,0 @@
-import "node:path";
-import "node:url";
-import.meta.url;
-import { BuildModel } from "../models/build.mjs";
-import { CaptureAttemptModel } from "../models/capture-attempt.mjs";
-import { ProjectModel } from "../models/project.mjs";
-import { postStatusesForBuild } from "./status-fanout.mjs";
-import { eq, getTableColumns } from "drizzle-orm";
-//#region src/capture/recovery.ts
-/**
-* Boot-time recovery for builds left in `capturing` by a server restart.
-*
-* Policy: requeue once. The interrupted attempt is closed with
-* {@link INTERRUPTED_ERROR}; a build with no earlier interrupted attempt goes back to `pending`
-* and is re-enqueued, otherwise it is marked `failed` for manual retry. A build is failed instead
-* when the run before the interrupted one was itself interrupted, so a crash loop stops after
-* one requeue while manual retries stay unrestricted. In-process queues only: remote queues redeliver on their own.
-*/
-/** Error recorded on attempts that a restart cut short; also the requeue-once marker. */
-const INTERRUPTED_ERROR = "Interrupted by server restart";
-/** Requeue (once) or fail every build still `capturing`; call once at boot, before serving jobs. */
-async function recoverStuckCaptures(recovery) {
-	const { deps } = recovery;
-	const stuck = await deps.db.list(deps.tables.builds, { where: eq(getTableColumns(deps.tables.builds)["status"], "capturing") });
-	const outcomes = await Promise.all(stuck.map(async (build) => await recoverBuild(recovery, build)));
-	const result = {
-		requeued: stuck.filter((_, index) => outcomes[index]).map((build) => build.id),
-		failed: stuck.filter((_, index) => !outcomes[index]).map((build) => build.id)
-	};
-	if (stuck.length > 0) deps.logger.warn({
-		requeued: result.requeued,
-		failed: result.failed
-	}, "recovered builds interrupted by restart");
-	return result;
-}
-/** Recover one build; returns true when it was requeued. */
-async function recoverBuild(recovery, build) {
-	const { deps } = recovery;
-	const attempts = new CaptureAttemptModel(deps.db, deps.tables);
-	const history = await attempts.listByBuild(build.id);
-	const open = history.filter((a) => a.status === "queued" || a.status === "running");
-	const lastClosed = history.findLast((a) => !open.includes(a));
-	await Promise.all(open.map(async (a) => await attempts.markFinished(a.id, "failed", INTERRUPTED_ERROR)));
-	return lastClosed?.error === "Interrupted by server restart" ? await failInterrupted(deps, build) : await requeueInterrupted(recovery, build);
-}
-async function failInterrupted(deps, build) {
-	await new BuildModel(deps.db, deps.tables).setStatus(build.id, "failed");
-	await postFailure(deps, build);
-	deps.logger.error({ buildId: build.id }, "build interrupted by restart again; marked failed for manual retry");
-	return false;
-}
-async function requeueInterrupted(recovery, build) {
-	const { deps } = recovery;
-	await new BuildModel(deps.db, deps.tables).setStatus(build.id, "pending");
-	await recovery.enqueue(build.id);
-	deps.logger.warn({ buildId: build.id }, "build interrupted by restart; requeued once");
-	return true;
-}
-/** Replace the lingering pending git status with a failure. */
-async function postFailure(deps, build) {
-	const project = await new ProjectModel(deps.db, deps.tables).get(build.projectId);
-	if (!project) return;
-	await postStatusesForBuild({
-		db: deps.db,
-		tables: deps.tables,
-		project,
-		sha: build.gitSha,
-		status: "failure",
-		url: `/projects/${project.slug}/builds/${build.id}`,
-		providers: deps.gitHosts,
-		secret: deps.secret,
-		logger: deps.logger
-	}).catch((error) => {
-		deps.logger.error({
-			err: error,
-			buildId: build.id
-		}, "failed to post failure status");
-	});
-}
-//#endregion
-export { INTERRUPTED_ERROR, recoverStuckCaptures };
-
-//# sourceMappingURL=recovery.mjs.map

package/dist/capture/recovery.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"recovery.mjs","names":[],"sources":["../../src/capture/recovery.ts"],"sourcesContent":["/**\n * Boot-time recovery for builds left in `capturing` by a server restart.\n *\n * Policy: requeue once. The interrupted attempt is closed with\n * {@link INTERRUPTED_ERROR}; a build with no earlier interrupted attempt goes back to `pending`\n * and is re-enqueued, otherwise it is marked `failed` for manual retry. A build is failed instead\n * when the run before the interrupted one was itself interrupted, so a crash loop stops after\n * one requeue while manual retries stay unrestricted. In-process queues only: remote queues redeliver on their own.\n */\nimport { eq, getTableColumns } from \"drizzle-orm\";\nimport type { SQLWrapper } from \"drizzle-orm\";\nimport { BuildModel } from \"../models/build.ts\";\nimport { CaptureAttemptModel } from \"../models/capture-attempt.ts\";\nimport { ProjectModel } from \"../models/project.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { DispatchDeps } from \"./dispatch.ts\";\nimport { postStatusesForBuild } from \"./status-fanout.ts\";\n\n/** Error recorded on attempts that a restart cut short; also the requeue-once marker. */\nexport const INTERRUPTED_ERROR = \"Interrupted by server restart\";\n\n/** Outcome of one recovery sweep. */\nexport interface RecoveryResult {\n  requeued: string[];\n  failed: string[];\n}\n\n/** Inputs for {@link recoverStuckCaptures}. */\nexport interface RecoveryDeps {\n  deps: DispatchDeps;\n  enqueue: (buildId: string) => Promise<void>;\n}\n\n/** Requeue (once) or fail every build still `capturing`; call once at boot, before serving jobs. */\nexport async function recoverStuckCaptures(recovery: RecoveryDeps): Promise<RecoveryResult> {\n  const { deps } = recovery;\n  const stuck = (await deps.db.list(deps.tables.builds, {\n    where: eq(getTableColumns(deps.tables.builds)[\"status\"] as unknown as SQLWrapper, \"capturing\"),\n  })) as unknown as Build[];\n  const outcomes = await Promise.all(\n    stuck.map(async (build) => await recoverBuild(recovery, build)),\n  );\n  const result: RecoveryResult = {\n    requeued: stuck.filter((_, index) => outcomes[index]).map((build) => build.id),\n    failed: stuck.filter((_, index) => !outcomes[index]).map((build) => build.id),\n  };\n  if (stuck.length > 0) {\n    deps.logger.warn(\n      { requeued: result.requeued, failed: result.failed },\n      \"recovered builds interrupted by restart\",\n    );\n  }\n  return result;\n}\n\n/** Recover one build; returns true when it was requeued. */\nasync function recoverBuild(recovery: RecoveryDeps, build: Build): Promise<boolean> {\n  const { deps } = recovery;\n  const attempts = new CaptureAttemptModel(deps.db, deps.tables);\n  const history = await attempts.listByBuild(build.id);\n  const open = history.filter((a) => a.status === \"queued\" || a.status === \"running\");\n  // Requeue-once: the run before the interrupted one was itself interrupted => crash loop.\n  const lastClosed = history.findLast((a) => !open.includes(a));\n  await Promise.all(\n    open.map(async (a) => await attempts.markFinished(a.id, \"failed\", INTERRUPTED_ERROR)),\n  );\n  return lastClosed?.error === INTERRUPTED_ERROR\n    ? await failInterrupted(deps, build)\n    : await requeueInterrupted(recovery, build);\n}\n\nasync function failInterrupted(deps: DispatchDeps, build: Build): Promise<false> {\n  await new BuildModel(deps.db, deps.tables).setStatus(build.id, \"failed\");\n  await postFailure(deps, build);\n  deps.logger.error(\n    { buildId: build.id },\n    \"build interrupted by restart again; marked failed for manual retry\",\n  );\n  return false;\n}\n\nasync function requeueInterrupted(recovery: RecoveryDeps, build: Build): Promise<true> {\n  const { deps } = recovery;\n  await new BuildModel(deps.db, deps.tables).setStatus(build.id, \"pending\");\n  await recovery.enqueue(build.id);\n  deps.logger.warn({ buildId: build.id }, \"build interrupted by restart; requeued once\");\n  return true;\n}\n\n/** Replace the lingering pending git status with a failure. */\nasync function postFailure(deps: DispatchDeps, build: Build): Promise<void> {\n  const project = await new ProjectModel(deps.db, deps.tables).get(build.projectId);\n  if (!project) {\n    return;\n  }\n  await postStatusesForBuild({\n    db: deps.db,\n    tables: deps.tables,\n    project,\n    sha: build.gitSha,\n    status: \"failure\",\n    url: `/projects/${project.slug}/builds/${build.id}`,\n    providers: deps.gitHosts,\n    secret: deps.secret,\n    logger: deps.logger,\n  }).catch((error: unknown) => {\n    deps.logger.error({ err: error, buildId: build.id }, \"failed to post failure status\");\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,MAAa,oBAAoB;;AAejC,eAAsB,qBAAqB,UAAiD;CAC1F,MAAM,EAAE,SAAS;CACjB,MAAM,QAAS,MAAM,KAAK,GAAG,KAAK,KAAK,OAAO,QAAQ,EACpD,OAAO,GAAG,gBAAgB,KAAK,OAAO,MAAM,CAAC,CAAC,WAAoC,WAAW,EAC/F,CAAC;CACD,MAAM,WAAW,MAAM,QAAQ,IAC7B,MAAM,IAAI,OAAO,UAAU,MAAM,aAAa,UAAU,KAAK,CAAC,CAChE;CACA,MAAM,SAAyB;EAC7B,UAAU,MAAM,QAAQ,GAAG,UAAU,SAAS,MAAM,CAAC,CAAC,KAAK,UAAU,MAAM,EAAE;EAC7E,QAAQ,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,MAAM,CAAC,CAAC,KAAK,UAAU,MAAM,EAAE;CAC9E;CACA,IAAI,MAAM,SAAS,GACjB,KAAK,OAAO,KACV;EAAE,UAAU,OAAO;EAAU,QAAQ,OAAO;CAAO,GACnD,yCACF;CAEF,OAAO;AACT;;AAGA,eAAe,aAAa,UAAwB,OAAgC;CAClF,MAAM,EAAE,SAAS;CACjB,MAAM,WAAW,IAAI,oBAAoB,KAAK,IAAI,KAAK,MAAM;CAC7D,MAAM,UAAU,MAAM,SAAS,YAAY,MAAM,EAAE;CACnD,MAAM,OAAO,QAAQ,QAAQ,MAAM,EAAE,WAAW,YAAY,EAAE,WAAW,SAAS;CAElF,MAAM,aAAa,QAAQ,UAAU,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC;CAC5D,MAAM,QAAQ,IACZ,KAAK,IAAI,OAAO,MAAM,MAAM,SAAS,aAAa,EAAE,IAAI,UAAU,iBAAiB,CAAC,CACtF;CACA,OAAO,YAAY,UAAA,kCACf,MAAM,gBAAgB,MAAM,KAAK,IACjC,MAAM,mBAAmB,UAAU,KAAK;AAC9C;AAEA,eAAe,gBAAgB,MAAoB,OAA8B;CAC/E,MAAM,IAAI,WAAW,KAAK,IAAI,KAAK,MAAM,CAAC,CAAC,UAAU,MAAM,IAAI,QAAQ;CACvE,MAAM,YAAY,MAAM,KAAK;CAC7B,KAAK,OAAO,MACV,EAAE,SAAS,MAAM,GAAG,GACpB,oEACF;CACA,OAAO;AACT;AAEA,eAAe,mBAAmB,UAAwB,OAA6B;CACrF,MAAM,EAAE,SAAS;CACjB,MAAM,IAAI,WAAW,KAAK,IAAI,KAAK,MAAM,CAAC,CAAC,UAAU,MAAM,IAAI,SAAS;CACxE,MAAM,SAAS,QAAQ,MAAM,EAAE;CAC/B,KAAK,OAAO,KAAK,EAAE,SAAS,MAAM,GAAG,GAAG,6CAA6C;CACrF,OAAO;AACT;;AAGA,eAAe,YAAY,MAAoB,OAA6B;CAC1E,MAAM,UAAU,MAAM,IAAI,aAAa,KAAK,IAAI,KAAK,MAAM,CAAC,CAAC,IAAI,MAAM,SAAS;CAChF,IAAI,CAAC,SACH;CAEF,MAAM,qBAAqB;EACzB,IAAI,KAAK;EACT,QAAQ,KAAK;EACb;EACA,KAAK,MAAM;EACX,QAAQ;EACR,KAAK,aAAa,QAAQ,KAAK,UAAU,MAAM;EAC/C,WAAW,KAAK;EAChB,QAAQ,KAAK;EACb,QAAQ,KAAK;CACf,CAAC,CAAC,CAAC,OAAO,UAAmB;EAC3B,KAAK,OAAO,MAAM;GAAE,KAAK;GAAO,SAAS,MAAM;EAAG,GAAG,+BAA+B;CACtF,CAAC;AACH"}

package/dist/capture/status-fanout.mjs

@@ -1,72 +0,0 @@
-import "node:path";
-import "node:url";
-import.meta.url;
-import { buildCommentMarkdown } from "../adapter/git-host/helpers.mjs";
-import { StatusConfigModel } from "../models/status-config.mjs";
-import { LOCAL_SHA_PREFIX } from "@storyshelf/affected";
-//#region src/capture/status-fanout.ts
-/** Post build check statuses (and review comments) to every configured git provider. */
-async function postStatusesForBuild(opts) {
-	if (opts.providers.length === 0) return;
-	if (opts.sha.startsWith(LOCAL_SHA_PREFIX)) {
-		opts.logger?.info({ sha: opts.sha }, "skipping git provider status for synthetic local identity");
-		return;
-	}
-	const model = new StatusConfigModel(opts.db, opts.tables, 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

@@ -1 +0,0 @@
-{"version":3,"file":"status-fanout.mjs","names":[],"sources":["../../src/capture/status-fanout.ts"],"sourcesContent":["import { LOCAL_SHA_PREFIX } from \"@storyshelf/affected\";\nimport type { Logger } from \"pino\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport { buildCommentMarkdown } from \"../adapters/git-host/helpers.ts\";\nimport type { CheckStatus, GitHostProvider } from \"../adapters/git-host/index.ts\";\nimport { StatusConfigModel, type StatusConfigTables } from \"../models/status-config.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\n\n/** Post build check statuses (and review comments) to every configured git provider. */\nasync function postStatusesForBuild(opts: {\n  db: DatabaseAdapter;\n  tables: StatusConfigTables;\n  project: Project;\n  sha: string;\n  status: CheckStatus;\n  url: string;\n  providers: GitHostProvider[];\n  secret: SecretInput;\n  logger?: Logger;\n}): Promise<void> {\n  if (opts.providers.length === 0) {\n    return;\n  }\n  if (opts.sha.startsWith(LOCAL_SHA_PREFIX)) {\n    opts.logger?.info(\n      { sha: opts.sha },\n      \"skipping git provider status for synthetic local identity\",\n    );\n    return;\n  }\n  const model = new StatusConfigModel(opts.db, opts.tables, 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({\n        context: ctx,\n        gitSha: opts.sha,\n        status: opts.status,\n        url: opts.url,\n      });\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":";;;;;;;;AAUA,eAAe,qBAAqB,MAUlB;CAChB,IAAI,KAAK,UAAU,WAAW,GAC5B;CAEF,IAAI,KAAK,IAAI,WAAW,gBAAgB,GAAG;EACzC,KAAK,QAAQ,KACX,EAAE,KAAK,KAAK,IAAI,GAChB,2DACF;EACA;CACF;CACA,MAAM,QAAQ,IAAI,kBAAkB,KAAK,IAAI,KAAK,QAAQ,KAAK,MAAM;CACrE,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;GACtB,SAAS;GACT,QAAQ,KAAK;GACb,QAAQ,KAAK;GACb,KAAK,KAAK;EACZ,CAAC;EACD,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/diff/engine.d.mts

@@ -1,16 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { DiffOptions, DiffResult } from "./options.mjs";
-//#region src/diff/engine.d.ts
-/**
- * Compare baseline and current screenshots, returning pass/fail and a diff image.
- *
- * @param baseline - Baseline PNG buffer.
- * @param current - Current capture PNG buffer.
- * @param options - Pixel threshold and ratio limits.
- * @returns The diff result with pixel counts and an optional overlay image.
- */
-declare function diffImages(baseline: Buffer, current: Buffer, options: DiffOptions): DiffResult;
-//#endregion
-export { diffImages };
-//# sourceMappingURL=engine.d.mts.map

package/dist/diff/engine.mjs

@@ -1,87 +0,0 @@
-import "node:path";
-import "node:url";
-import.meta.url;
-import pixelmatch from "pixelmatch";
-import { PNG } from "pngjs";
-//#region src/diff/engine.ts
-/**
-* Compare baseline and current screenshots, returning pass/fail and a diff image.
-*
-* @param baseline - Baseline PNG buffer.
-* @param current - Current capture PNG buffer.
-* @param options - Pixel threshold and ratio limits.
-* @returns The diff result with pixel counts and an optional overlay image.
-*/
-function diffImages(baseline, current, options) {
-	const baselinePng = PNG.sync.read(baseline);
-	const currentPng = PNG.sync.read(current);
-	const baselineDimensions = {
-		width: baselinePng.width,
-		height: baselinePng.height
-	};
-	const currentDimensions = {
-		width: currentPng.width,
-		height: currentPng.height
-	};
-	if (baselineDimensions.width !== currentDimensions.width || baselineDimensions.height !== currentDimensions.height) {
-		if (options.failOnSizeChange) return {
-			passed: false,
-			diffPixels: 0,
-			diffRatio: 1,
-			diffImage: null,
-			baselineDimensions,
-			currentDimensions,
-			sizeChanged: true
-		};
-		const width = Math.min(baselineDimensions.width, currentDimensions.width);
-		const height = Math.min(baselineDimensions.height, currentDimensions.height);
-		const overlap = compareRegions(cropRgba(baselinePng.data, baselineDimensions.width, width, height), cropRgba(currentPng.data, currentDimensions.width, width, height), width, height, options);
-		const diffRatio = overlap.diffPixels / (width * height);
-		return {
-			passed: diffRatio <= options.maxDiffRatio,
-			diffPixels: overlap.diffPixels,
-			diffRatio,
-			diffImage: overlap.diffImage,
-			baselineDimensions,
-			currentDimensions,
-			sizeChanged: true
-		};
-	}
-	const { width } = baselineDimensions;
-	const { height } = baselineDimensions;
-	const overlap = compareRegions(baselinePng.data, currentPng.data, width, height, options);
-	const diffRatio = overlap.diffPixels / (width * height);
-	return {
-		passed: diffRatio <= options.maxDiffRatio,
-		diffPixels: overlap.diffPixels,
-		diffRatio,
-		diffImage: overlap.diffImage,
-		baselineDimensions,
-		currentDimensions,
-		sizeChanged: false
-	};
-}
-function cropRgba(source, sourceWidth, width, height) {
-	const cropped = Buffer.alloc(width * height * 4);
-	const rowBytes = width * 4;
-	const sourceRowBytes = sourceWidth * 4;
-	for (let y = 0; y < height; y += 1) source.copy(cropped, y * rowBytes, y * sourceRowBytes, y * sourceRowBytes + rowBytes);
-	return cropped;
-}
-function compareRegions(baselineData, currentData, width, height, options) {
-	const diffPng = new PNG({
-		width,
-		height
-	});
-	return {
-		diffPixels: pixelmatch(baselineData, currentData, diffPng.data, width, height, {
-			threshold: options.pixelThreshold,
-			includeAA: options.includeAntialiasing
-		}),
-		diffImage: PNG.sync.write(diffPng)
-	};
-}
-//#endregion
-export { diffImages };
-
-//# sourceMappingURL=engine.mjs.map

package/dist/diff/engine.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine.mjs","names":[],"sources":["../../src/diff/engine.ts"],"sourcesContent":["import pixelmatch from \"pixelmatch\";\nimport { PNG } from \"pngjs\";\nimport type { DiffOptions, DiffResult } from \"./options.ts\";\n\n/**\n * Compare baseline and current screenshots, returning pass/fail and a diff image.\n *\n * @param baseline - Baseline PNG buffer.\n * @param current - Current capture PNG buffer.\n * @param options - Pixel threshold and ratio limits.\n * @returns The diff result with pixel counts and an optional overlay image.\n */\nexport function diffImages(baseline: Buffer, current: Buffer, options: DiffOptions): DiffResult {\n  const baselinePng = PNG.sync.read(baseline);\n  const currentPng = PNG.sync.read(current);\n\n  const baselineDimensions = { width: baselinePng.width, height: baselinePng.height };\n  const currentDimensions = { width: currentPng.width, height: currentPng.height };\n  const sizeChanged =\n    baselineDimensions.width !== currentDimensions.width ||\n    baselineDimensions.height !== currentDimensions.height;\n\n  if (sizeChanged) {\n    if (options.failOnSizeChange) {\n      return {\n        passed: false,\n        diffPixels: 0,\n        diffRatio: 1,\n        diffImage: null,\n        baselineDimensions,\n        currentDimensions,\n        sizeChanged: true,\n      };\n    }\n\n    // With `failOnSizeChange: false` a size mismatch is not a failure: diff only\n    // The top-left overlapping region, normalised by its area. Pixelmatch needs\n    // Equal-size inputs, so the larger image is cropped first.\n    const width = Math.min(baselineDimensions.width, currentDimensions.width);\n    const height = Math.min(baselineDimensions.height, currentDimensions.height);\n    const overlap = compareRegions(\n      cropRgba(baselinePng.data, baselineDimensions.width, width, height),\n      cropRgba(currentPng.data, currentDimensions.width, width, height),\n      width,\n      height,\n      options,\n    );\n    const diffRatio = overlap.diffPixels / (width * height);\n    return {\n      passed: diffRatio <= options.maxDiffRatio,\n      diffPixels: overlap.diffPixels,\n      diffRatio,\n      diffImage: overlap.diffImage,\n      baselineDimensions,\n      currentDimensions,\n      sizeChanged: true,\n    };\n  }\n\n  const { width } = baselineDimensions;\n  const { height } = baselineDimensions;\n  const overlap = compareRegions(baselinePng.data, currentPng.data, width, height, options);\n  const diffRatio = overlap.diffPixels / (width * height);\n  return {\n    passed: diffRatio <= options.maxDiffRatio,\n    diffPixels: overlap.diffPixels,\n    diffRatio,\n    diffImage: overlap.diffImage,\n    baselineDimensions,\n    currentDimensions,\n    sizeChanged: false,\n  };\n}\n\nfunction cropRgba(source: Buffer, sourceWidth: number, width: number, height: number): Buffer {\n  const cropped = Buffer.alloc(width * height * 4);\n  const rowBytes = width * 4;\n  const sourceRowBytes = sourceWidth * 4;\n  for (let y = 0; y < height; y += 1) {\n    source.copy(cropped, y * rowBytes, y * sourceRowBytes, y * sourceRowBytes + rowBytes);\n  }\n  return cropped;\n}\n\nfunction compareRegions(\n  baselineData: Buffer,\n  currentData: Buffer,\n  width: number,\n  height: number,\n  options: DiffOptions,\n): { diffPixels: number; diffImage: Buffer } {\n  const diffPng = new PNG({ width, height });\n  const diffPixels = pixelmatch(baselineData, currentData, diffPng.data, width, height, {\n    threshold: options.pixelThreshold,\n    includeAA: options.includeAntialiasing,\n  });\n  return { diffPixels, diffImage: PNG.sync.write(diffPng) };\n}\n"],"mappings":";;;;;;;;;;;;;;AAYA,SAAgB,WAAW,UAAkB,SAAiB,SAAkC;CAC9F,MAAM,cAAc,IAAI,KAAK,KAAK,QAAQ;CAC1C,MAAM,aAAa,IAAI,KAAK,KAAK,OAAO;CAExC,MAAM,qBAAqB;EAAE,OAAO,YAAY;EAAO,QAAQ,YAAY;CAAO;CAClF,MAAM,oBAAoB;EAAE,OAAO,WAAW;EAAO,QAAQ,WAAW;CAAO;CAK/E,IAHE,mBAAmB,UAAU,kBAAkB,SAC/C,mBAAmB,WAAW,kBAAkB,QAEjC;EACf,IAAI,QAAQ,kBACV,OAAO;GACL,QAAQ;GACR,YAAY;GACZ,WAAW;GACX,WAAW;GACX;GACA;GACA,aAAa;EACf;EAMF,MAAM,QAAQ,KAAK,IAAI,mBAAmB,OAAO,kBAAkB,KAAK;EACxE,MAAM,SAAS,KAAK,IAAI,mBAAmB,QAAQ,kBAAkB,MAAM;EAC3E,MAAM,UAAU,eACd,SAAS,YAAY,MAAM,mBAAmB,OAAO,OAAO,MAAM,GAClE,SAAS,WAAW,MAAM,kBAAkB,OAAO,OAAO,MAAM,GAChE,OACA,QACA,OACF;EACA,MAAM,YAAY,QAAQ,cAAc,QAAQ;EAChD,OAAO;GACL,QAAQ,aAAa,QAAQ;GAC7B,YAAY,QAAQ;GACpB;GACA,WAAW,QAAQ;GACnB;GACA;GACA,aAAa;EACf;CACF;CAEA,MAAM,EAAE,UAAU;CAClB,MAAM,EAAE,WAAW;CACnB,MAAM,UAAU,eAAe,YAAY,MAAM,WAAW,MAAM,OAAO,QAAQ,OAAO;CACxF,MAAM,YAAY,QAAQ,cAAc,QAAQ;CAChD,OAAO;EACL,QAAQ,aAAa,QAAQ;EAC7B,YAAY,QAAQ;EACpB;EACA,WAAW,QAAQ;EACnB;EACA;EACA,aAAa;CACf;AACF;AAEA,SAAS,SAAS,QAAgB,aAAqB,OAAe,QAAwB;CAC5F,MAAM,UAAU,OAAO,MAAM,QAAQ,SAAS,CAAC;CAC/C,MAAM,WAAW,QAAQ;CACzB,MAAM,iBAAiB,cAAc;CACrC,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,KAAK,GAC/B,OAAO,KAAK,SAAS,IAAI,UAAU,IAAI,gBAAgB,IAAI,iBAAiB,QAAQ;CAEtF,OAAO;AACT;AAEA,SAAS,eACP,cACA,aACA,OACA,QACA,SAC2C;CAC3C,MAAM,UAAU,IAAI,IAAI;EAAE;EAAO;CAAO,CAAC;CAKzC,OAAO;EAAE,YAJU,WAAW,cAAc,aAAa,QAAQ,MAAM,OAAO,QAAQ;GACpF,WAAW,QAAQ;GACnB,WAAW,QAAQ;EACrB,CACkB;EAAG,WAAW,IAAI,KAAK,MAAM,OAAO;CAAE;AAC1D"}