@storyshelf/core 0.6.2 → 0.8.0

package/dist/capture/build-state/publisher.mjs

@@ -0,0 +1,106 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { sanitizeErrorText } from "../../utils/redact.mjs";
+import { NotificationChannelModel } from "../../models/notification-channel.mjs";
+import { loadBuild, stateTargets, writeTo } from "./deliver.mjs";
+// src/capture/build-state/publisher.ts
+/**
+* The one entry point for "this build changed, show it" (ADR 0014, decisions 5 and 7). Every build
+* transition and the end of publishing call `request`; it hands each git channel of the project a
+* durable `notify` job, or, on a host with no queue consumer, delivers inline. While no public
+* origin is resolved it does neither (ADR 0014, decision 11): every link would be empty.
+*/
+/** Logged once when the first request finds no public origin, and again after one came back and went. */
+const PAUSED_MESSAGE = "notifications are paused until a public URL is set (PUBLIC_BASE_URL or a confirmed detected origin)";
+/** A publisher over `options.deps`. */
+function createBuildStatePublisher(options) {
+	const { deps } = options;
+	const pause = { logged: false };
+	return { request: async (buildId) => {
+		try {
+			const origin = await deps.publicOrigin();
+			if (!origin) {
+				logPaused(deps, pause, buildId);
+				return;
+			}
+			pause.logged = false;
+			await requestAll(options, {
+				buildId,
+				origin
+			});
+		} catch (error) {
+			deps.logger.warn({
+				err: error,
+				buildId
+			}, "failed to request the build state");
+		}
+	} };
+}
+/** Warn on the first request of a pause only. */
+function logPaused(deps, pause, buildId) {
+	if (!pause.logged) deps.logger.warn({ buildId }, PAUSED_MESSAGE);
+	pause.logged = true;
+}
+/** Ask every state channel of the build's project to show it. */
+async function requestAll(options, where) {
+	const { deps } = options;
+	const { buildId, origin } = where;
+	const loaded = await loadBuild(deps, buildId);
+	if (loaded === null) return;
+	const targets = await stateTargets(deps, loaded.project.id);
+	await Promise.allSettled(targets.map(async (target) => {
+		await requestOne(options, {
+			buildId,
+			loaded,
+			target,
+			origin
+		});
+	}));
+}
+/** Queue the delivery; inline when there is no queue, or when queueing itself failed. */
+async function requestOne(options, request) {
+	const { enqueue, deps } = options;
+	const { buildId, loaded, target, origin } = request;
+	if (enqueue !== void 0) try {
+		await enqueue({
+			channelId: target.channel.id,
+			buildId
+		});
+		return;
+	} catch (error) {
+		deps.logger.warn({
+			err: error,
+			channelId: target.channel.id,
+			buildId
+		}, "failed to queue the state delivery; delivering inline");
+	}
+	await deliverInline(deps, loaded, {
+		target,
+		origin
+	});
+}
+/** Deliver now and record the outcome on the channel; never throws. */
+async function deliverInline(deps, loaded, where) {
+	const { target } = where;
+	const channels = new NotificationChannelModel(deps.db, { notificationChannels: deps.db.tables.notificationChannels }, deps.secret);
+	let error;
+	try {
+		await writeTo(deps, loaded, where);
+	} catch (writeError) {
+		deps.logger.warn({
+			err: writeError,
+			channelId: target.channel.id
+		}, "state delivery failed");
+		error = sanitizeErrorText(writeError instanceof Error ? writeError.message : String(writeError), 500);
+	}
+	await channels.recordOutcome(target.channel.id, error).catch((recordError) => {
+		deps.logger.warn({
+			err: recordError,
+			channelId: target.channel.id
+		}, "failed to record outcome");
+	});
+}
+export { PAUSED_MESSAGE, createBuildStatePublisher };
+
+//# sourceMappingURL=publisher.mjs.map

package/dist/capture/build-state/publisher.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.mjs","names":[],"sources":["../../../src/capture/build-state/publisher.ts"],"sourcesContent":["/**\n * The one entry point for \"this build changed, show it\" (ADR 0014, decisions 5 and 7). Every build\n * transition and the end of publishing call `request`; it hands each git channel of the project a\n * durable `notify` job, or, on a host with no queue consumer, delivers inline. While no public\n * origin is resolved it does neither (ADR 0014, decision 11): every link would be empty.\n */\nimport { NotificationChannelModel } from \"../../models/notification-channel.ts\";\nimport { sanitizeErrorText } from \"../../utils/redact.ts\";\nimport { loadBuild, stateTargets, writeTo } from \"./deliver.ts\";\nimport type { BuildStateDeps, BuildStatePublisher, StateTarget } from \"./types.ts\";\n\n/** What {@link createBuildStatePublisher} needs. */\nexport interface BuildStatePublisherOptions {\n  deps: BuildStateDeps;\n  /**\n   * Queues a `notify` job. Set when this instance (or another one) consumes the queue; absent, the\n   * state is delivered inline in the caller's request, without durability.\n   */\n  enqueue?: ((job: { channelId: string; buildId: string }) => Promise<void>) | undefined;\n}\n\n/** Logged once when the first request finds no public origin, and again after one came back and went. */\nexport const PAUSED_MESSAGE =\n  \"notifications are paused until a public URL is set (PUBLIC_BASE_URL or a confirmed detected origin)\";\n\n/** A publisher over `options.deps`. */\nexport function createBuildStatePublisher(\n  options: BuildStatePublisherOptions,\n): BuildStatePublisher {\n  const { deps } = options;\n  const pause = { logged: false };\n  return {\n    request: async (buildId) => {\n      try {\n        const origin = await deps.publicOrigin();\n        if (!origin) {\n          logPaused(deps, pause, buildId);\n          return;\n        }\n        pause.logged = false;\n        await requestAll(options, { buildId, origin });\n      } catch (error) {\n        deps.logger.warn({ err: error, buildId }, \"failed to request the build state\");\n      }\n    },\n  };\n}\n\n/** Warn on the first request of a pause only. */\nfunction logPaused(deps: BuildStateDeps, pause: { logged: boolean }, buildId: string): void {\n  if (!pause.logged) {\n    deps.logger.warn({ buildId }, PAUSED_MESSAGE);\n  }\n  pause.logged = true;\n}\n\n/** Ask every state channel of the build's project to show it. */\nasync function requestAll(\n  options: BuildStatePublisherOptions,\n  where: { buildId: string; origin: string },\n): Promise<void> {\n  const { deps } = options;\n  const { buildId, origin } = where;\n  const loaded = await loadBuild(deps, buildId);\n  if (loaded === null) {\n    return;\n  }\n  const targets = await stateTargets(deps, loaded.project.id);\n  await Promise.allSettled(\n    targets.map(async (target) => {\n      await requestOne(options, { buildId, loaded, target, origin });\n    }),\n  );\n}\n\n/** Queue the delivery; inline when there is no queue, or when queueing itself failed. */\nasync function requestOne(\n  options: BuildStatePublisherOptions,\n  request: {\n    buildId: string;\n    loaded: NonNullable<Awaited<ReturnType<typeof loadBuild>>>;\n    target: StateTarget;\n    origin: string;\n  },\n): Promise<void> {\n  const { enqueue, deps } = options;\n  const { buildId, loaded, target, origin } = request;\n  if (enqueue !== undefined) {\n    try {\n      await enqueue({ channelId: target.channel.id, buildId });\n      return;\n    } catch (error) {\n      deps.logger.warn(\n        { err: error, channelId: target.channel.id, buildId },\n        \"failed to queue the state delivery; delivering inline\",\n      );\n    }\n  }\n  await deliverInline(deps, loaded, { target, origin });\n}\n\n/** Deliver now and record the outcome on the channel; never throws. */\nasync function deliverInline(\n  deps: BuildStateDeps,\n  loaded: Parameters<typeof writeTo>[1],\n  where: Parameters<typeof writeTo>[2],\n): Promise<void> {\n  const { target } = where;\n  const channels = new NotificationChannelModel(\n    deps.db,\n    { notificationChannels: deps.db.tables.notificationChannels },\n    deps.secret,\n  );\n  let error: string | undefined;\n  try {\n    await writeTo(deps, loaded, where);\n  } catch (writeError) {\n    deps.logger.warn({ err: writeError, channelId: target.channel.id }, \"state delivery failed\");\n    error = sanitizeErrorText(\n      writeError instanceof Error ? writeError.message : String(writeError),\n      500,\n    );\n  }\n  await channels.recordOutcome(target.channel.id, error).catch((recordError: unknown) => {\n    deps.logger.warn(\n      { err: recordError, channelId: target.channel.id },\n      \"failed to record outcome\",\n    );\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;AAsBA,MAAa,iBACX;;AAGF,SAAgB,0BACd,SACqB;CACrB,MAAM,EAAE,SAAS;CACjB,MAAM,QAAQ,EAAE,QAAQ,MAAM;CAC9B,OAAO,EACL,SAAS,OAAO,YAAY;EAC1B,IAAI;GACF,MAAM,SAAS,MAAM,KAAK,aAAa;GACvC,IAAI,CAAC,QAAQ;IACX,UAAU,MAAM,OAAO,OAAO;IAC9B;GACF;GACA,MAAM,SAAS;GACf,MAAM,WAAW,SAAS;IAAE;IAAS;GAAO,CAAC;EAC/C,SAAS,OAAO;GACd,KAAK,OAAO,KAAK;IAAE,KAAK;IAAO;GAAQ,GAAG,mCAAmC;EAC/E;CACF,EACF;AACF;;AAGA,SAAS,UAAU,MAAsB,OAA4B,SAAuB;CAC1F,IAAI,CAAC,MAAM,QACT,KAAK,OAAO,KAAK,EAAE,QAAQ,GAAG,cAAc;CAE9C,MAAM,SAAS;AACjB;;AAGA,eAAe,WACb,SACA,OACe;CACf,MAAM,EAAE,SAAS;CACjB,MAAM,EAAE,SAAS,WAAW;CAC5B,MAAM,SAAS,MAAM,UAAU,MAAM,OAAO;CAC5C,IAAI,WAAW,MACb;CAEF,MAAM,UAAU,MAAM,aAAa,MAAM,OAAO,QAAQ,EAAE;CAC1D,MAAM,QAAQ,WACZ,QAAQ,IAAI,OAAO,WAAW;EAC5B,MAAM,WAAW,SAAS;GAAE;GAAS;GAAQ;GAAQ;EAAO,CAAC;CAC/D,CAAC,CACH;AACF;;AAGA,eAAe,WACb,SACA,SAMe;CACf,MAAM,EAAE,SAAS,SAAS;CAC1B,MAAM,EAAE,SAAS,QAAQ,QAAQ,WAAW;CAC5C,IAAI,YAAY,KAAA,GACd,IAAI;EACF,MAAM,QAAQ;GAAE,WAAW,OAAO,QAAQ;GAAI;EAAQ,CAAC;EACvD;CACF,SAAS,OAAO;EACd,KAAK,OAAO,KACV;GAAE,KAAK;GAAO,WAAW,OAAO,QAAQ;GAAI;EAAQ,GACpD,uDACF;CACF;CAEF,MAAM,cAAc,MAAM,QAAQ;EAAE;EAAQ;CAAO,CAAC;AACtD;;AAGA,eAAe,cACb,MACA,QACA,OACe;CACf,MAAM,EAAE,WAAW;CACnB,MAAM,WAAW,IAAI,yBACnB,KAAK,IACL,EAAE,sBAAsB,KAAK,GAAG,OAAO,qBAAqB,GAC5D,KAAK,MACP;CACA,IAAI;CACJ,IAAI;EACF,MAAM,QAAQ,MAAM,QAAQ,KAAK;CACnC,SAAS,YAAY;EACnB,KAAK,OAAO,KAAK;GAAE,KAAK;GAAY,WAAW,OAAO,QAAQ;EAAG,GAAG,uBAAuB;EAC3F,QAAQ,kBACN,sBAAsB,QAAQ,WAAW,UAAU,OAAO,UAAU,GACpE,GACF;CACF;CACA,MAAM,SAAS,cAAc,OAAO,QAAQ,IAAI,KAAK,CAAC,CAAC,OAAO,gBAAyB;EACrF,KAAK,OAAO,KACV;GAAE,KAAK;GAAa,WAAW,OAAO,QAAQ;EAAG,GACjD,0BACF;CACF,CAAC;AACH"}

package/dist/capture/build-state/resume.d.mts

@@ -0,0 +1,7 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BuildStateDeps, BuildStatePublisher } from "./types.mjs";
+/** Ask `publisher` for the state of every open recent build; resolves to how many were asked. Never rejects. */
+declare function requestOpenBuildStates(deps: Pick<BuildStateDeps, "db" | "logger">, publisher: BuildStatePublisher): Promise<number>;
+export { requestOpenBuildStates };
+//# sourceMappingURL=resume.d.mts.map

package/dist/capture/build-state/resume.mjs

@@ -0,0 +1,46 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { BuildModel } from "../../models/build.mjs";
+import { ProjectModel } from "../../models/project.mjs";
+import { LOCAL_SHA_PREFIX } from "@storyshelf/affected";
+// src/capture/build-state/resume.ts
+/**
+* Re-requesting the state of builds still open. Requests made while no public origin was resolved
+* were dropped (ADR 0014, decision 11), so once one is, the builds that can still change are asked
+* again; settled builds keep what they last showed until their next transition.
+*/
+/** Builds that have not reached a verdict. */
+const OPEN = /* @__PURE__ */ new Set([
+	"pending",
+	"capturing",
+	"comparing",
+	"reviewing"
+]);
+/** Newest builds looked at per project. */
+const PER_PROJECT = 25;
+/** Ask `publisher` for the state of every open recent build; resolves to how many were asked. Never rejects. */
+async function requestOpenBuildStates(deps, publisher) {
+	try {
+		const projects = await new ProjectModel(deps.db).list();
+		const ids = (await Promise.all(projects.map(async (project) => await openBuildIds(deps, project.id)))).flat();
+		await Promise.all(ids.map(async (id) => {
+			await publisher.request(id);
+		}));
+		return ids.length;
+	} catch (error) {
+		deps.logger.warn({ err: error }, "failed to re-request the state of open builds");
+		return 0;
+	}
+}
+/** The newest builds of a project that have not reached a verdict. */
+async function openBuildIds(deps, projectId) {
+	return (await new BuildModel(deps.db).list(projectId, { limit: PER_PROJECT })).filter((build) => OPEN.has(build.status) && hasGitCommit(build.gitSha)).map((build) => build.id);
+}
+/** A build with no commit, or a local upload, has no git state to show (see `statusesForBuild`). */
+function hasGitCommit(gitSha) {
+	return gitSha.length > 0 && !gitSha.startsWith(LOCAL_SHA_PREFIX);
+}
+export { requestOpenBuildStates };
+
+//# sourceMappingURL=resume.mjs.map

package/dist/capture/build-state/resume.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.mjs","names":[],"sources":["../../../src/capture/build-state/resume.ts"],"sourcesContent":["/**\n * Re-requesting the state of builds still open. Requests made while no public origin was resolved\n * were dropped (ADR 0014, decision 11), so once one is, the builds that can still change are asked\n * again; settled builds keep what they last showed until their next transition.\n */\nimport { LOCAL_SHA_PREFIX } from \"@storyshelf/affected\";\nimport { BuildModel } from \"../../models/build.ts\";\nimport { ProjectModel } from \"../../models/project.ts\";\nimport type { BuildStatus } from \"../../types.ts\";\nimport type { BuildStateDeps, BuildStatePublisher } from \"./types.ts\";\n\n/** Builds that have not reached a verdict. */\nconst OPEN: ReadonlySet<BuildStatus> = new Set([\"pending\", \"capturing\", \"comparing\", \"reviewing\"]);\n\n/** Newest builds looked at per project. */\nconst PER_PROJECT = 25;\n\n/** Ask `publisher` for the state of every open recent build; resolves to how many were asked. Never rejects. */\nexport async function requestOpenBuildStates(\n  deps: Pick<BuildStateDeps, \"db\" | \"logger\">,\n  publisher: BuildStatePublisher,\n): Promise<number> {\n  try {\n    const projects = await new ProjectModel(deps.db).list();\n    const lists = await Promise.all(\n      projects.map(async (project) => await openBuildIds(deps, project.id)),\n    );\n    const ids = lists.flat();\n    await Promise.all(\n      ids.map(async (id) => {\n        await publisher.request(id);\n      }),\n    );\n    return ids.length;\n  } catch (error) {\n    deps.logger.warn({ err: error }, \"failed to re-request the state of open builds\");\n    return 0;\n  }\n}\n\n/** The newest builds of a project that have not reached a verdict. */\nasync function openBuildIds(\n  deps: Pick<BuildStateDeps, \"db\">,\n  projectId: string,\n): Promise<string[]> {\n  const recent = await new BuildModel(deps.db).list(projectId, { limit: PER_PROJECT });\n  return recent\n    .filter((build) => OPEN.has(build.status) && hasGitCommit(build.gitSha))\n    .map((build) => build.id);\n}\n\n/** A build with no commit, or a local upload, has no git state to show (see `statusesForBuild`). */\nfunction hasGitCommit(gitSha: string): boolean {\n  return gitSha.length > 0 && !gitSha.startsWith(LOCAL_SHA_PREFIX);\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,MAAM,uBAAiC,IAAI,IAAI;CAAC;CAAW;CAAa;CAAa;AAAW,CAAC;;AAGjG,MAAM,cAAc;;AAGpB,eAAsB,uBACpB,MACA,WACiB;CACjB,IAAI;EACF,MAAM,WAAW,MAAM,IAAI,aAAa,KAAK,EAAE,CAAC,CAAC,KAAK;EAItD,MAAM,OAAM,MAHQ,QAAQ,IAC1B,SAAS,IAAI,OAAO,YAAY,MAAM,aAAa,MAAM,QAAQ,EAAE,CAAC,CACtE,EAAA,CACkB,KAAK;EACvB,MAAM,QAAQ,IACZ,IAAI,IAAI,OAAO,OAAO;GACpB,MAAM,UAAU,QAAQ,EAAE;EAC5B,CAAC,CACH;EACA,OAAO,IAAI;CACb,SAAS,OAAO;EACd,KAAK,OAAO,KAAK,EAAE,KAAK,MAAM,GAAG,+CAA+C;EAChF,OAAO;CACT;AACF;;AAGA,eAAe,aACb,MACA,WACmB;CAEnB,QAAO,MADc,IAAI,WAAW,KAAK,EAAE,CAAC,CAAC,KAAK,WAAW,EAAE,OAAO,YAAY,CAAC,EAAA,CAEhF,QAAQ,UAAU,KAAK,IAAI,MAAM,MAAM,KAAK,aAAa,MAAM,MAAM,CAAC,CAAC,CACvE,KAAK,UAAU,MAAM,EAAE;AAC5B;;AAGA,SAAS,aAAa,QAAyB;CAC7C,OAAO,OAAO,SAAS,KAAK,CAAC,OAAO,WAAW,gBAAgB;AACjE"}

package/dist/capture/build-state/types.d.mts

@@ -0,0 +1,47 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Logger } from "../../logger.mjs";
+import { DatabaseAdapter } from "../../adapter/database.mjs";
+import { NotificationChannel } from "../../adapters/notifier/types.mjs";
+import { NotifierProvider, StateNotifierProvider } from "../../adapters/notifier/provider.mjs";
+import { StorageAdapter } from "../../adapter/storage.mjs";
+import { ShelfConfig } from "../../config.mjs";
+import { BuildStateFlags } from "../../adapters/notifier/build-state.mjs";
+import { SecretInput } from "../../utils/encrypt.mjs";
+import { Project } from "../../schema/project.mjs";
+/** What delivering a build's state needs. */
+interface BuildStateDeps {
+  db: DatabaseAdapter;
+  /** Read to tell whether the build's Storybook is published; without it publishing reads as pending. */
+  storage?: StorageAdapter | undefined;
+  /** Notifier providers; only the `state` ones (git hosts) take part. */
+  notifiers: readonly NotifierProvider[];
+  /** Server secret that decrypts channel tokens. */
+  secret: SecretInput;
+  /** The published-Storybook domain for Storybook links. */
+  config: Pick<ShelfConfig, "publishedBaseDomain">;
+  /**
+   * The resolved public origin (ADR 0007, decision 6): the origin every link starts with. While it
+   * resolves to nothing, no state is requested or delivered (ADR 0014, decision 11).
+   */
+  publicOrigin: () => Promise<string | undefined>;
+  /** Which statuses a project's builds show: `testing` from the server options, review from the project. */
+  flags: (project: Project) => BuildStateFlags;
+  logger: Logger;
+}
+/** A channel with the provider that delivers to it. */
+interface StateTarget {
+  channel: NotificationChannel;
+  provider: StateNotifierProvider;
+}
+/** Why a delivery wrote nothing. */
+type SkipReason = "no-build" | "no-channel" | "disabled" | "no-provider" | "no-origin";
+/**
+ * Asks for a build's current state to be shown on its project's git channels. Never rejects: the
+ * request that triggered it must not fail because a git host did.
+ */
+interface BuildStatePublisher {
+  request(buildId: string): Promise<void>;
+}
+export { BuildStateDeps, BuildStatePublisher, SkipReason, StateTarget };
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1,20 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DatabaseAdapter } from "../../adapter/database.mjs";
+import { StorageAdapter } from "../../adapter/storage.mjs";
+import { Catalog } from "./types.mjs";
+/** What cataloguing reads and writes. */
+interface CatalogDeps {
+  db: DatabaseAdapter;
+  storage: StorageAdapter;
+}
+/**
+ * Catalogue a build from its published statics: replace its `build_components` rows, then persist
+ * `catalog.json`. Resolves to the catalog, or null when the build has no readable index
+ * (statics purged, or not a Storybook), in which case nothing is written.
+ */
+declare function catalogueBuild(deps: CatalogDeps, projectId: string, buildId: string): Promise<Catalog | null>;
+/** A build's persisted catalog, or null when it has none (or an unreadable one). */
+declare function readCatalog(storage: StorageAdapter, projectId: string, buildId: string): Promise<Catalog | null>;
+export { CatalogDeps, catalogueBuild, readCatalog };
+//# sourceMappingURL=catalogue.d.mts.map

package/dist/capture/catalog/catalogue.mjs

@@ -0,0 +1,52 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { catalogPath } from "../../paths.mjs";
+import { BuildComponentModel } from "../../models/build-component.mjs";
+import { groupComponents, toBuildComponent } from "./components.mjs";
+import { parseStorybookIndexText } from "./parse.mjs";
+import { readPublishedFile } from "./read.mjs";
+// src/capture/catalog/catalogue.ts
+/** Index files a Storybook may publish, newest format first. */
+const INDEX_FILES = ["index.json", "stories.json"];
+/**
+* Catalogue a build from its published statics: replace its `build_components` rows, then persist
+* `catalog.json`. Resolves to the catalog, or null when the build has no readable index
+* (statics purged, or not a Storybook), in which case nothing is written.
+*/
+async function catalogueBuild(deps, projectId, buildId) {
+	const entries = await readIndexEntries(deps.storage, projectId, buildId);
+	if (!entries) return null;
+	const catalog = {
+		v: 1,
+		entries
+	};
+	await new BuildComponentModel(deps.db).replaceForBuild(projectId, buildId, groupComponents(entries).map((component) => toBuildComponent(component)));
+	await deps.storage.write(catalogPath(projectId, buildId), Buffer.from(JSON.stringify(catalog)));
+	return catalog;
+}
+/** A build's persisted catalog, or null when it has none (or an unreadable one). */
+async function readCatalog(storage, projectId, buildId) {
+	const path = catalogPath(projectId, buildId);
+	try {
+		if (!await storage.exists(path)) return null;
+		const parsed = JSON.parse((await storage.read(path)).toString("utf8"));
+		return parsed.v === 1 && Array.isArray(parsed.entries) ? {
+			v: 1,
+			entries: parsed.entries
+		} : null;
+	} catch {
+		return null;
+	}
+}
+async function readIndexEntries(storage, projectId, buildId) {
+	for (const name of INDEX_FILES) {
+		const file = await readPublishedFile(storage, projectId, buildId, name).catch(() => null);
+		const entries = file ? parseStorybookIndexText(file.toString("utf8")) : null;
+		if (entries) return entries;
+	}
+	return null;
+}
+export { catalogueBuild, readCatalog };
+
+//# sourceMappingURL=catalogue.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue.mjs","names":[],"sources":["../../../src/capture/catalog/catalogue.ts"],"sourcesContent":["/** Cataloguing a published build: read its Storybook index, persist `catalog.json` and component rows. */\nimport type { DatabaseAdapter } from \"../../adapters/database.ts\";\nimport type { StorageAdapter } from \"../../adapters/storage.ts\";\nimport { BuildComponentModel } from \"../../models/build-component.ts\";\nimport { catalogPath } from \"../../utils/paths.ts\";\nimport { groupComponents, toBuildComponent } from \"./components.ts\";\nimport { parseStorybookIndexText } from \"./parse.ts\";\nimport { readPublishedFile } from \"./read.ts\";\nimport type { Catalog, CatalogEntry } from \"./types.ts\";\n\n/** What cataloguing reads and writes. */\nexport interface CatalogDeps {\n  db: DatabaseAdapter;\n  storage: StorageAdapter;\n}\n\n/** Index files a Storybook may publish, newest format first. */\nconst INDEX_FILES = [\"index.json\", \"stories.json\"] as const;\n\n/**\n * Catalogue a build from its published statics: replace its `build_components` rows, then persist\n * `catalog.json`. Resolves to the catalog, or null when the build has no readable index\n * (statics purged, or not a Storybook), in which case nothing is written.\n */\nexport async function catalogueBuild(\n  deps: CatalogDeps,\n  projectId: string,\n  buildId: string,\n): Promise<Catalog | null> {\n  const entries = await readIndexEntries(deps.storage, projectId, buildId);\n  if (!entries) {\n    return null;\n  }\n  const catalog: Catalog = { v: 1, entries };\n  // The rows go first: catalog.json is the marker that cataloguing finished, so a crash between the\n  // two leaves a build the lazy loader catalogues again, never one with a catalog and no rows.\n  await new BuildComponentModel(deps.db).replaceForBuild(\n    projectId,\n    buildId,\n    groupComponents(entries).map((component) => toBuildComponent(component)),\n  );\n  await deps.storage.write(catalogPath(projectId, buildId), Buffer.from(JSON.stringify(catalog)));\n  return catalog;\n}\n\n/** A build's persisted catalog, or null when it has none (or an unreadable one). */\nexport async function readCatalog(\n  storage: StorageAdapter,\n  projectId: string,\n  buildId: string,\n): Promise<Catalog | null> {\n  const path = catalogPath(projectId, buildId);\n  try {\n    if (!(await storage.exists(path))) {\n      return null;\n    }\n    const parsed = JSON.parse((await storage.read(path)).toString(\"utf8\")) as Partial<Catalog>;\n    return parsed.v === 1 && Array.isArray(parsed.entries)\n      ? { v: 1, entries: parsed.entries }\n      : null;\n  } catch {\n    return null;\n  }\n}\n\nasync function readIndexEntries(\n  storage: StorageAdapter,\n  projectId: string,\n  buildId: string,\n): Promise<CatalogEntry[] | null> {\n  for (const name of INDEX_FILES) {\n    // eslint-disable-next-line no-await-in-loop -- stop at the first index that parses\n    const file = await readPublishedFile(storage, projectId, buildId, name).catch(() => null);\n    const entries = file ? parseStorybookIndexText(file.toString(\"utf8\")) : null;\n    if (entries) {\n      return entries;\n    }\n  }\n  return null;\n}\n"],"mappings":";;;;;;;;;;AAiBA,MAAM,cAAc,CAAC,cAAc,cAAc;;;;;;AAOjD,eAAsB,eACpB,MACA,WACA,SACyB;CACzB,MAAM,UAAU,MAAM,iBAAiB,KAAK,SAAS,WAAW,OAAO;CACvE,IAAI,CAAC,SACH,OAAO;CAET,MAAM,UAAmB;EAAE,GAAG;EAAG;CAAQ;CAGzC,MAAM,IAAI,oBAAoB,KAAK,EAAE,CAAC,CAAC,gBACrC,WACA,SACA,gBAAgB,OAAO,CAAC,CAAC,KAAK,cAAc,iBAAiB,SAAS,CAAC,CACzE;CACA,MAAM,KAAK,QAAQ,MAAM,YAAY,WAAW,OAAO,GAAG,OAAO,KAAK,KAAK,UAAU,OAAO,CAAC,CAAC;CAC9F,OAAO;AACT;;AAGA,eAAsB,YACpB,SACA,WACA,SACyB;CACzB,MAAM,OAAO,YAAY,WAAW,OAAO;CAC3C,IAAI;EACF,IAAI,CAAE,MAAM,QAAQ,OAAO,IAAI,GAC7B,OAAO;EAET,MAAM,SAAS,KAAK,OAAO,MAAM,QAAQ,KAAK,IAAI,EAAA,CAAG,SAAS,MAAM,CAAC;EACrE,OAAO,OAAO,MAAM,KAAK,MAAM,QAAQ,OAAO,OAAO,IACjD;GAAE,GAAG;GAAG,SAAS,OAAO;EAAQ,IAChC;CACN,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAe,iBACb,SACA,WACA,SACgC;CAChC,KAAK,MAAM,QAAQ,aAAa;EAE9B,MAAM,OAAO,MAAM,kBAAkB,SAAS,WAAW,SAAS,IAAI,CAAC,CAAC,YAAY,IAAI;EACxF,MAAM,UAAU,OAAO,wBAAwB,KAAK,SAAS,MAAM,CAAC,IAAI;EACxE,IAAI,SACF,OAAO;CAEX;CACA,OAAO;AACT"}

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

@@ -0,0 +1,21 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { CatalogComponent, CatalogEntry } from "./types.mjs";
+import { BuildComponentInput } from "../../models/build-component.mjs";
+/** Group entries by story file (entries without one by title), ordered by title then file. */
+declare function groupComponents(entries: readonly CatalogEntry[]): CatalogComponent[];
+/** What `build_components` stores of a component. */
+declare function toBuildComponent(component: CatalogComponent): BuildComponentInput;
+/** SHA-256 over the entries' id, name, type and title, in id order: equal sets hash equal. */
+declare function hashEntries(entries: readonly CatalogEntry[]): string;
+/** How one component's entries differ between two builds. */
+interface EntryChanges {
+  added: number;
+  removed: number;
+  /** Same id, new display name. */
+  renamed: number;
+}
+/** Entries added, removed and renamed from `before` to `after` (matched by entry id). */
+declare function diffEntries(before: readonly CatalogEntry[], after: readonly CatalogEntry[]): EntryChanges;
+export { EntryChanges, diffEntries, groupComponents, hashEntries, toBuildComponent };
+//# sourceMappingURL=components.d.mts.map

package/dist/capture/catalog/components.mjs

@@ -0,0 +1,54 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { createHash } from "node:crypto";
+// src/capture/catalog/components.ts
+/** Catalog entries grouped into components, hashed, and compared between builds. */
+/** Group entries by story file (entries without one by title), ordered by title then file. */
+function groupComponents(entries) {
+	return [...Map.groupBy(entries, (entry) => entry.importPath || `title:${entry.title}`).values()].map((group) => {
+		const [first] = group;
+		return {
+			importPath: first?.importPath ?? "",
+			title: first?.title ?? "",
+			storyCount: group.filter((entry) => entry.type === "story").length,
+			hash: hashEntries(group),
+			entries: group
+		};
+	}).toSorted((a, b) => a.title.localeCompare(b.title) || a.importPath.localeCompare(b.importPath));
+}
+/** What `build_components` stores of a component. */
+function toBuildComponent(component) {
+	const { importPath, title, storyCount, hash } = component;
+	return {
+		importPath,
+		title,
+		storyCount,
+		hash
+	};
+}
+/** SHA-256 over the entries' id, name, type and title, in id order: equal sets hash equal. */
+function hashEntries(entries) {
+	const lines = entries.map((entry) => [
+		entry.id,
+		entry.name,
+		entry.type,
+		entry.title
+	].join("	")).toSorted();
+	return createHash("sha256").update(lines.join("\n")).digest("hex");
+}
+/** Entries added, removed and renamed from `before` to `after` (matched by entry id). */
+function diffEntries(before, after) {
+	const was = new Map(before.map((entry) => [entry.id, entry]));
+	const now = new Map(after.map((entry) => [entry.id, entry]));
+	let renamed = 0;
+	for (const [id, entry] of now) if (was.has(id) && was.get(id)?.name !== entry.name) renamed += 1;
+	return {
+		added: [...now.keys()].filter((id) => !was.has(id)).length,
+		removed: [...was.keys()].filter((id) => !now.has(id)).length,
+		renamed
+	};
+}
+export { diffEntries, groupComponents, hashEntries, toBuildComponent };
+
+//# sourceMappingURL=components.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"components.mjs","names":[],"sources":["../../../src/capture/catalog/components.ts"],"sourcesContent":["/** Catalog entries grouped into components, hashed, and compared between builds. */\nimport { createHash } from \"node:crypto\";\nimport type { BuildComponentInput } from \"../../models/build-component.ts\";\nimport type { CatalogComponent, CatalogEntry } from \"./types.ts\";\n\n/** Group entries by story file (entries without one by title), ordered by title then file. */\nexport function groupComponents(entries: readonly CatalogEntry[]): CatalogComponent[] {\n  const groups = Map.groupBy(entries, (entry) => entry.importPath || `title:${entry.title}`);\n  return [...groups.values()]\n    .map((group): CatalogComponent => {\n      const [first] = group;\n      return {\n        importPath: first?.importPath ?? \"\",\n        title: first?.title ?? \"\",\n        storyCount: group.filter((entry) => entry.type === \"story\").length,\n        hash: hashEntries(group),\n        entries: group,\n      };\n    })\n    .toSorted((a, b) => a.title.localeCompare(b.title) || a.importPath.localeCompare(b.importPath));\n}\n\n/** What `build_components` stores of a component. */\nexport function toBuildComponent(component: CatalogComponent): BuildComponentInput {\n  const { importPath, title, storyCount, hash } = component;\n  return { importPath, title, storyCount, hash };\n}\n\n/** SHA-256 over the entries' id, name, type and title, in id order: equal sets hash equal. */\nexport function hashEntries(entries: readonly CatalogEntry[]): string {\n  const lines = entries\n    .map((entry) => [entry.id, entry.name, entry.type, entry.title].join(\"\\t\"))\n    .toSorted();\n  return createHash(\"sha256\").update(lines.join(\"\\n\")).digest(\"hex\");\n}\n\n/** How one component's entries differ between two builds. */\nexport interface EntryChanges {\n  added: number;\n  removed: number;\n  /** Same id, new display name. */\n  renamed: number;\n}\n\n/** Entries added, removed and renamed from `before` to `after` (matched by entry id). */\nexport function diffEntries(\n  before: readonly CatalogEntry[],\n  after: readonly CatalogEntry[],\n): EntryChanges {\n  const was = new Map(before.map((entry) => [entry.id, entry] as const));\n  const now = new Map(after.map((entry) => [entry.id, entry] as const));\n  let renamed = 0;\n  for (const [id, entry] of now) {\n    if (was.has(id) && was.get(id)?.name !== entry.name) {\n      renamed += 1;\n    }\n  }\n  return {\n    added: [...now.keys()].filter((id) => !was.has(id)).length,\n    removed: [...was.keys()].filter((id) => !now.has(id)).length,\n    renamed,\n  };\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,gBAAgB,SAAsD;CAEpF,OAAO,CAAC,GADO,IAAI,QAAQ,UAAU,UAAU,MAAM,cAAc,SAAS,MAAM,OAClE,CAAC,CAAC,OAAO,CAAC,CAAC,CACxB,KAAK,UAA4B;EAChC,MAAM,CAAC,SAAS;EAChB,OAAO;GACL,YAAY,OAAO,cAAc;GACjC,OAAO,OAAO,SAAS;GACvB,YAAY,MAAM,QAAQ,UAAU,MAAM,SAAS,OAAO,CAAC,CAAC;GAC5D,MAAM,YAAY,KAAK;GACvB,SAAS;EACX;CACF,CAAC,CAAC,CACD,UAAU,GAAG,MAAM,EAAE,MAAM,cAAc,EAAE,KAAK,KAAK,EAAE,WAAW,cAAc,EAAE,UAAU,CAAC;AAClG;;AAGA,SAAgB,iBAAiB,WAAkD;CACjF,MAAM,EAAE,YAAY,OAAO,YAAY,SAAS;CAChD,OAAO;EAAE;EAAY;EAAO;EAAY;CAAK;AAC/C;;AAGA,SAAgB,YAAY,SAA0C;CACpE,MAAM,QAAQ,QACX,KAAK,UAAU;EAAC,MAAM;EAAI,MAAM;EAAM,MAAM;EAAM,MAAM;CAAK,CAAC,CAAC,KAAK,GAAI,CAAC,CAAC,CAC1E,SAAS;CACZ,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK;AACnE;;AAWA,SAAgB,YACd,QACA,OACc;CACd,MAAM,MAAM,IAAI,IAAI,OAAO,KAAK,UAAU,CAAC,MAAM,IAAI,KAAK,CAAU,CAAC;CACrE,MAAM,MAAM,IAAI,IAAI,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,KAAK,CAAU,CAAC;CACpE,IAAI,UAAU;CACd,KAAK,MAAM,CAAC,IAAI,UAAU,KACxB,IAAI,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC,EAAE,SAAS,MAAM,MAC7C,WAAW;CAGf,OAAO;EACL,OAAO,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;EACpD,SAAS,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;EACtD;CACF;AACF"}

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

@@ -0,0 +1,28 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Build } from "../../schema/build.mjs";
+import { BuildComponent } from "../../schema/build-component.mjs";
+import { ComponentPresence } from "../../models/component.mjs";
+/** How a build's version of a component compares with the build before it on the same branch. */
+type ComponentChange = "new" | "changed" | "unchanged";
+/** One build's row of a component's history. */
+interface ComponentBuildRow {
+  build: Build;
+  component: BuildComponent;
+  change: ComponentChange;
+  /** The same component in the build before on the branch; null when this is its first. */
+  previous: BuildComponent | null;
+}
+/**
+ * Component history, newest build first. `rows` are the component's `build_components` rows;
+ * a row whose build is missing is skipped. The build before is the next older one on the same
+ * branch, so a feature branch compares with itself rather than with an unrelated default build.
+ */
+declare function componentBuildHistory(rows: readonly BuildComponent[], builds: readonly Build[]): ComponentBuildRow[];
+/**
+ * Where a component stands against the project's latest build. `latest` holds that build's
+ * component rows, or null when it has no catalog (the answer is then unknown, never "deleted").
+ */
+declare function catalogPresence(history: readonly ComponentBuildRow[], importPath: string, latest: readonly BuildComponent[] | null): ComponentPresence;
+export { ComponentBuildRow, ComponentChange, catalogPresence, componentBuildHistory };
+//# sourceMappingURL=history.d.mts.map

package/dist/capture/catalog/history.mjs

@@ -0,0 +1,50 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/capture/catalog/history.ts
+/**
+* Component history, newest build first. `rows` are the component's `build_components` rows;
+* a row whose build is missing is skipped. The build before is the next older one on the same
+* branch, so a feature branch compares with itself rather than with an unrelated default build.
+*/
+function componentBuildHistory(rows, builds) {
+	const byId = new Map(builds.map((build) => [build.id, build]));
+	const known = rows.flatMap((component) => {
+		const build = byId.get(component.buildId);
+		return build ? [{
+			build,
+			component
+		}] : [];
+	}).toSorted((a, b) => b.build.createdAt.localeCompare(a.build.createdAt));
+	return known.map((entry, index) => {
+		const previous = known.slice(index + 1).find((older) => older.build.gitBranch === entry.build.gitBranch)?.component ?? null;
+		const change = previous ? previous.hash === entry.component.hash ? "unchanged" : "changed" : "new";
+		return {
+			build: entry.build,
+			component: entry.component,
+			change,
+			previous
+		};
+	});
+}
+/**
+* Where a component stands against the project's latest build. `latest` holds that build's
+* component rows, or null when it has no catalog (the answer is then unknown, never "deleted").
+*/
+function catalogPresence(history, importPath, latest) {
+	const newest = history[0];
+	if (!latest || !newest) return { kind: "unknown" };
+	if (latest.some((row) => row.importPath === importPath)) return { kind: "present" };
+	const moved = latest.find((row) => row.title === newest.component.title && row.importPath !== "");
+	return moved ? {
+		kind: "moved",
+		to: moved.importPath,
+		title: moved.title
+	} : {
+		kind: "deleted",
+		lastSeen: newest.build
+	};
+}
+export { catalogPresence, componentBuildHistory };
+
+//# sourceMappingURL=history.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.mjs","names":[],"sources":["../../../src/capture/catalog/history.ts"],"sourcesContent":["/** A component across builds: which builds hold it, whether its stories changed, and where it went. */\nimport type { ComponentPresence } from \"../../models/component.ts\";\nimport type { BuildComponent } from \"../../schema/build-component.ts\";\nimport type { Build } from \"../../schema/build.ts\";\n\n/** How a build's version of a component compares with the build before it on the same branch. */\nexport type ComponentChange = \"new\" | \"changed\" | \"unchanged\";\n\n/** One build's row of a component's history. */\nexport interface ComponentBuildRow {\n  build: Build;\n  component: BuildComponent;\n  change: ComponentChange;\n  /** The same component in the build before on the branch; null when this is its first. */\n  previous: BuildComponent | null;\n}\n\n/**\n * Component history, newest build first. `rows` are the component's `build_components` rows;\n * a row whose build is missing is skipped. The build before is the next older one on the same\n * branch, so a feature branch compares with itself rather than with an unrelated default build.\n */\nexport function componentBuildHistory(\n  rows: readonly BuildComponent[],\n  builds: readonly Build[],\n): ComponentBuildRow[] {\n  const byId = new Map(builds.map((build) => [build.id, build] as const));\n  const known = rows\n    .flatMap((component) => {\n      const build = byId.get(component.buildId);\n      return build ? [{ build, component }] : [];\n    })\n    .toSorted((a, b) => b.build.createdAt.localeCompare(a.build.createdAt));\n  return known.map((entry, index) => {\n    const previous =\n      known.slice(index + 1).find((older) => older.build.gitBranch === entry.build.gitBranch)\n        ?.component ?? null;\n    const change: ComponentChange = previous\n      ? previous.hash === entry.component.hash\n        ? \"unchanged\"\n        : \"changed\"\n      : \"new\";\n    return { build: entry.build, component: entry.component, change, previous };\n  });\n}\n\n/**\n * Where a component stands against the project's latest build. `latest` holds that build's\n * component rows, or null when it has no catalog (the answer is then unknown, never \"deleted\").\n */\nexport function catalogPresence(\n  history: readonly ComponentBuildRow[],\n  importPath: string,\n  latest: readonly BuildComponent[] | null,\n): ComponentPresence {\n  const newest = history[0];\n  if (!latest || !newest) {\n    return { kind: \"unknown\" };\n  }\n  if (latest.some((row) => row.importPath === importPath)) {\n    return { kind: \"present\" };\n  }\n  const moved = latest.find((row) => row.title === newest.component.title && row.importPath !== \"\");\n  return moved\n    ? { kind: \"moved\", to: moved.importPath, title: moved.title }\n    : { kind: \"deleted\", lastSeen: newest.build };\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,sBACd,MACA,QACqB;CACrB,MAAM,OAAO,IAAI,IAAI,OAAO,KAAK,UAAU,CAAC,MAAM,IAAI,KAAK,CAAU,CAAC;CACtE,MAAM,QAAQ,KACX,SAAS,cAAc;EACtB,MAAM,QAAQ,KAAK,IAAI,UAAU,OAAO;EACxC,OAAO,QAAQ,CAAC;GAAE;GAAO;EAAU,CAAC,IAAI,CAAC;CAC3C,CAAC,CAAC,CACD,UAAU,GAAG,MAAM,EAAE,MAAM,UAAU,cAAc,EAAE,MAAM,SAAS,CAAC;CACxE,OAAO,MAAM,KAAK,OAAO,UAAU;EACjC,MAAM,WACJ,MAAM,MAAM,QAAQ,CAAC,CAAC,CAAC,MAAM,UAAU,MAAM,MAAM,cAAc,MAAM,MAAM,SAAS,CAAC,EACnF,aAAa;EACnB,MAAM,SAA0B,WAC5B,SAAS,SAAS,MAAM,UAAU,OAChC,cACA,YACF;EACJ,OAAO;GAAE,OAAO,MAAM;GAAO,WAAW,MAAM;GAAW;GAAQ;EAAS;CAC5E,CAAC;AACH;;;;;AAMA,SAAgB,gBACd,SACA,YACA,QACmB;CACnB,MAAM,SAAS,QAAQ;CACvB,IAAI,CAAC,UAAU,CAAC,QACd,OAAO,EAAE,MAAM,UAAU;CAE3B,IAAI,OAAO,MAAM,QAAQ,IAAI,eAAe,UAAU,GACpD,OAAO,EAAE,MAAM,UAAU;CAE3B,MAAM,QAAQ,OAAO,MAAM,QAAQ,IAAI,UAAU,OAAO,UAAU,SAAS,IAAI,eAAe,EAAE;CAChG,OAAO,QACH;EAAE,MAAM;EAAS,IAAI,MAAM;EAAY,OAAO,MAAM;CAAM,IAC1D;EAAE,MAAM;EAAW,UAAU,OAAO;CAAM;AAChD"}

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

@@ -0,0 +1,12 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { AfterPublishHook } from "../publish/complete.mjs";
+import { CatalogLoader } from "./load.mjs";
+/**
+ * Catalogue every build that published successfully, whatever its verdict and with `testing` on or
+ * off. A failed publish writes nothing. A build with no readable index is logged and left for the
+ * lazy loader, which tries again on first view.
+ */
+declare function createCatalogHook(loader: CatalogLoader): AfterPublishHook;
+export { createCatalogHook };
+//# sourceMappingURL=hook.d.mts.map

package/dist/capture/catalog/hook.mjs

@@ -0,0 +1,18 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/capture/catalog/hook.ts
+/**
+* Catalogue every build that published successfully, whatever its verdict and with `testing` on or
+* off. A failed publish writes nothing. A build with no readable index is logged and left for the
+* lazy loader, which tries again on first view.
+*/
+function createCatalogHook(loader) {
+	return async ({ build, project, outcome, logger }) => {
+		if (!outcome.ok) return;
+		if (!await loader.refresh(project.id, build.id)) logger.warn("published build has no readable Storybook index; no catalog written");
+	};
+}
+export { createCatalogHook };
+
+//# sourceMappingURL=hook.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook.mjs","names":[],"sources":["../../../src/capture/catalog/hook.ts"],"sourcesContent":["/** The `afterPublish` hook that catalogues a build the moment its publishing succeeds. */\nimport type { AfterPublishHook } from \"../publish/complete.ts\";\nimport type { CatalogLoader } from \"./load.ts\";\n\n/**\n * Catalogue every build that published successfully, whatever its verdict and with `testing` on or\n * off. A failed publish writes nothing. A build with no readable index is logged and left for the\n * lazy loader, which tries again on first view.\n */\nexport function createCatalogHook(loader: CatalogLoader): AfterPublishHook {\n  return async ({ build, project, outcome, logger }) => {\n    if (!outcome.ok) {\n      return;\n    }\n    const catalog = await loader.refresh(project.id, build.id);\n    if (!catalog) {\n      logger.warn(\"published build has no readable Storybook index; no catalog written\");\n    }\n  };\n}\n"],"mappings":";;;;;;;;;AASA,SAAgB,kBAAkB,QAAyC;CACzE,OAAO,OAAO,EAAE,OAAO,SAAS,SAAS,aAAa;EACpD,IAAI,CAAC,QAAQ,IACX;EAGF,IAAI,CAAC,MADiB,OAAO,QAAQ,QAAQ,IAAI,MAAM,EAAE,GAEvD,OAAO,KAAK,qEAAqE;CAErF;AACF"}

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

@@ -0,0 +1,11 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Catalog, CatalogComponent, CatalogEntry } from "./types.mjs";
+import { CatalogDeps, catalogueBuild, readCatalog } from "./catalogue.mjs";
+import { CatalogLoader, CatalogLoaderOptions, DEFAULT_CATALOG_CACHE_SIZE, createCatalogLoader } from "./load.mjs";
+import { createCatalogHook } from "./hook.mjs";
+import { EntryChanges, diffEntries, groupComponents, hashEntries, toBuildComponent } from "./components.mjs";
+import { parseStorybookIndex, parseStorybookIndexText } from "./parse.mjs";
+import { readPublishedFile, readPublishedFileInfo } from "./read.mjs";
+import { ComponentBuildRow, ComponentChange, catalogPresence, componentBuildHistory } from "./history.mjs";
+export { type Catalog, type CatalogComponent, type CatalogDeps, type CatalogEntry, type CatalogLoader, type CatalogLoaderOptions, type ComponentBuildRow, type ComponentChange, DEFAULT_CATALOG_CACHE_SIZE, type EntryChanges, catalogPresence, catalogueBuild, componentBuildHistory, createCatalogHook, createCatalogLoader, diffEntries, groupComponents, hashEntries, parseStorybookIndex, parseStorybookIndexText, readCatalog, readPublishedFile, readPublishedFileInfo, toBuildComponent };

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

@@ -0,0 +1,24 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Logger } from "../../logger.mjs";
+import { Catalog } from "./types.mjs";
+import { CatalogDeps } from "./catalogue.mjs";
+/** Reads catalogs; one per app, so the cache is shared by every request. */
+interface CatalogLoader {
+  /** The build's catalog, or null when it has no catalog and no readable index. */
+  load(projectId: string, buildId: string): Promise<Catalog | null>;
+  /** Catalogue the build again from its statics (a publish ended) and cache the result. */
+  refresh(projectId: string, buildId: string): Promise<Catalog | null>;
+}
+/** Catalogs kept in memory by default. */
+declare const DEFAULT_CATALOG_CACHE_SIZE = 32;
+/** What {@link createCatalogLoader} needs. */
+interface CatalogLoaderOptions extends CatalogDeps {
+  /** Catalogs kept in memory (least recently used leave first). */
+  cacheSize?: number;
+  logger?: Logger;
+}
+/** A loader over `options.db` and `options.storage`. */
+declare function createCatalogLoader(options: CatalogLoaderOptions): CatalogLoader;
+export { CatalogLoader, CatalogLoaderOptions, DEFAULT_CATALOG_CACHE_SIZE, createCatalogLoader };
+//# sourceMappingURL=load.d.mts.map

package/dist/capture/catalog/load.mjs

@@ -0,0 +1,48 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { catalogueBuild, readCatalog } from "./catalogue.mjs";
+// src/capture/catalog/load.ts
+/** Catalogs kept in memory by default. */
+const DEFAULT_CATALOG_CACHE_SIZE = 32;
+/** A loader over `options.db` and `options.storage`. */
+function createCatalogLoader(options) {
+	const limit = Math.max(1, options.cacheSize ?? 32);
+	const cache = /* @__PURE__ */ new Map();
+	const inflight = /* @__PURE__ */ new Map();
+	const remember = (buildId, catalog) => {
+		cache.delete(buildId);
+		cache.set(buildId, catalog);
+		const oldest = cache.keys().next().value;
+		if (cache.size > limit && oldest !== void 0) cache.delete(oldest);
+		return catalog;
+	};
+	const fetchCatalog = async (projectId, buildId) => {
+		const stored = await readCatalog(options.storage, projectId, buildId);
+		if (stored) return stored;
+		options.logger?.info({ buildId }, "cataloguing a build published before the catalog");
+		return await catalogueBuild(options, projectId, buildId);
+	};
+	return {
+		load: async (projectId, buildId) => {
+			const hit = cache.get(buildId);
+			if (hit) return remember(buildId, hit);
+			const pending = inflight.get(buildId) ?? fetchCatalog(projectId, buildId);
+			inflight.set(buildId, pending);
+			try {
+				const catalog = await pending;
+				return catalog ? remember(buildId, catalog) : null;
+			} finally {
+				inflight.delete(buildId);
+			}
+		},
+		refresh: async (projectId, buildId) => {
+			cache.delete(buildId);
+			const catalog = await catalogueBuild(options, projectId, buildId);
+			return catalog ? remember(buildId, catalog) : null;
+		}
+	};
+}
+export { DEFAULT_CATALOG_CACHE_SIZE, createCatalogLoader };
+
+//# sourceMappingURL=load.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load.mjs","names":[],"sources":["../../../src/capture/catalog/load.ts"],"sourcesContent":["/**\n * The catalog loader: a build's catalog from `catalog.json`, kept in a small in-process LRU cache\n * by build id; a build that has none (published before the catalog existed) is catalogued on first\n * view from its persisted statics (ADR 0006, decision 9).\n */\nimport type { Logger } from \"../../logger.ts\";\nimport { catalogueBuild, readCatalog, type CatalogDeps } from \"./catalogue.ts\";\nimport type { Catalog } from \"./types.ts\";\n\n/** Reads catalogs; one per app, so the cache is shared by every request. */\nexport interface CatalogLoader {\n  /** The build's catalog, or null when it has no catalog and no readable index. */\n  load(projectId: string, buildId: string): Promise<Catalog | null>;\n  /** Catalogue the build again from its statics (a publish ended) and cache the result. */\n  refresh(projectId: string, buildId: string): Promise<Catalog | null>;\n}\n\n/** Catalogs kept in memory by default. */\nexport const DEFAULT_CATALOG_CACHE_SIZE = 32;\n\n/** What {@link createCatalogLoader} needs. */\nexport interface CatalogLoaderOptions extends CatalogDeps {\n  /** Catalogs kept in memory (least recently used leave first). */\n  cacheSize?: number;\n  logger?: Logger;\n}\n\n/** A loader over `options.db` and `options.storage`. */\nexport function createCatalogLoader(options: CatalogLoaderOptions): CatalogLoader {\n  const limit = Math.max(1, options.cacheSize ?? DEFAULT_CATALOG_CACHE_SIZE);\n  const cache = new Map<string, Catalog>();\n  const inflight = new Map<string, Promise<Catalog | null>>();\n  const remember = (buildId: string, catalog: Catalog): Catalog => {\n    cache.delete(buildId);\n    cache.set(buildId, catalog);\n    const oldest = cache.keys().next().value;\n    if (cache.size > limit && oldest !== undefined) {\n      cache.delete(oldest);\n    }\n    return catalog;\n  };\n  const fetchCatalog = async (projectId: string, buildId: string): Promise<Catalog | null> => {\n    const stored = await readCatalog(options.storage, projectId, buildId);\n    if (stored) {\n      return stored;\n    }\n    options.logger?.info({ buildId }, \"cataloguing a build published before the catalog\");\n    return await catalogueBuild(options, projectId, buildId);\n  };\n  return {\n    load: async (projectId, buildId) => {\n      const hit = cache.get(buildId);\n      if (hit) {\n        return remember(buildId, hit);\n      }\n      const pending = inflight.get(buildId) ?? fetchCatalog(projectId, buildId);\n      inflight.set(buildId, pending);\n      try {\n        const catalog = await pending;\n        return catalog ? remember(buildId, catalog) : null;\n      } finally {\n        inflight.delete(buildId);\n      }\n    },\n    refresh: async (projectId, buildId) => {\n      cache.delete(buildId);\n      const catalog = await catalogueBuild(options, projectId, buildId);\n      return catalog ? remember(buildId, catalog) : null;\n    },\n  };\n}\n"],"mappings":";;;;;;AAkBA,MAAa,6BAA6B;;AAU1C,SAAgB,oBAAoB,SAA8C;CAChF,MAAM,QAAQ,KAAK,IAAI,GAAG,QAAQ,aAAA,EAAuC;CACzE,MAAM,wBAAQ,IAAI,IAAqB;CACvC,MAAM,2BAAW,IAAI,IAAqC;CAC1D,MAAM,YAAY,SAAiB,YAA8B;EAC/D,MAAM,OAAO,OAAO;EACpB,MAAM,IAAI,SAAS,OAAO;EAC1B,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;EACnC,IAAI,MAAM,OAAO,SAAS,WAAW,KAAA,GACnC,MAAM,OAAO,MAAM;EAErB,OAAO;CACT;CACA,MAAM,eAAe,OAAO,WAAmB,YAA6C;EAC1F,MAAM,SAAS,MAAM,YAAY,QAAQ,SAAS,WAAW,OAAO;EACpE,IAAI,QACF,OAAO;EAET,QAAQ,QAAQ,KAAK,EAAE,QAAQ,GAAG,kDAAkD;EACpF,OAAO,MAAM,eAAe,SAAS,WAAW,OAAO;CACzD;CACA,OAAO;EACL,MAAM,OAAO,WAAW,YAAY;GAClC,MAAM,MAAM,MAAM,IAAI,OAAO;GAC7B,IAAI,KACF,OAAO,SAAS,SAAS,GAAG;GAE9B,MAAM,UAAU,SAAS,IAAI,OAAO,KAAK,aAAa,WAAW,OAAO;GACxE,SAAS,IAAI,SAAS,OAAO;GAC7B,IAAI;IACF,MAAM,UAAU,MAAM;IACtB,OAAO,UAAU,SAAS,SAAS,OAAO,IAAI;GAChD,UAAU;IACR,SAAS,OAAO,OAAO;GACzB;EACF;EACA,SAAS,OAAO,WAAW,YAAY;GACrC,MAAM,OAAO,OAAO;GACpB,MAAM,UAAU,MAAM,eAAe,SAAS,WAAW,OAAO;GAChE,OAAO,UAAU,SAAS,SAAS,OAAO,IAAI;EAChD;CACF;AACF"}