@storyshelf/app 0.8.0 → 0.9.0-next-588f070

package/dist/design-events.mjs

@@ -0,0 +1,71 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { credentialKeys } from "./credential-keys.mjs";
+import { clearPaused, notificationOrigin, warnPaused } from "./notifications-pause.mjs";
+import { notifyProjectWith } from "./notify.mjs";
+import { designChange } from "@storyshelf/core/models";
+import { emitWebhookEvent } from "@storyshelf/core/adapter/webhook-events";
+import { createUrlBuilder } from "@storyshelf/core/urls";
+// src/design-events.ts
+/**
+* `design:changed`: a design moved after its baseline was approved, or no longer exists. It rides
+* the existing paths (signed webhooks and the notification fan-out) and is a normal subscribable
+* topic: it is not default-on (see `notify.ts`), so only people who opted in hear about it.
+*
+* Sent once per (project, design node, design version) from the first health check that sees the
+* change. The durable claim is `DesignNodeModel.claimChange`; with no confirmed public origin
+* nothing is sent and nothing is claimed, so the change is still announced once an origin exists.
+* There is no boot replay: an unannounced change waits for the next health check.
+*/
+/** Event name of a design change. */
+const DESIGN_CHANGED_EVENT = "design:changed";
+/**
+* Announce every observed design change not announced before. Never throws: a failure is logged
+* and the next health check tries again.
+*/
+async function announceDesignChangesWith(deps, nodes, project, observations) {
+	const changes = observations.flatMap((observation) => {
+		const change = observation.componentPath ? designChange(observation.node, observation.baselineVersion) : null;
+		return observation.node && observation.componentPath && change ? [{
+			...observation,
+			node: observation.node,
+			componentPath: observation.componentPath,
+			change
+		}] : [];
+	});
+	if (changes.length === 0 || !await originConfirmed(deps)) return;
+	await Promise.all(changes.map(async (item) => {
+		try {
+			if (await nodes.claimChange(item.node, item.change)) await announce(deps, project, item);
+		} catch (error) {
+			deps.logger.warn({
+				err: error,
+				projectId: project.id
+			}, "design change not announced");
+		}
+	}));
+}
+async function originConfirmed(deps) {
+	if (await notificationOrigin(deps) === void 0) {
+		warnPaused(deps.logger, DESIGN_CHANGED_EVENT);
+		return false;
+	}
+	clearPaused(deps.logger);
+	return true;
+}
+async function announce(deps, project, item) {
+	const data = {
+		projectId: project.id,
+		componentPath: item.componentPath,
+		figmaUrl: item.url,
+		change: item.change.change,
+		designVersion: item.change.designVersion
+	};
+	await emitWebhookEvent(deps.db, { webhooks: deps.db.tables.webhooks }, project.id, DESIGN_CHANGED_EVENT, data, credentialKeys(deps.config), deps.logger);
+	const component = createUrlBuilder("").component(project.slug, item.componentPath);
+	await notifyProjectWith(deps, project, DESIGN_CHANGED_EVENT, data, component.slice(`/projects/${project.slug}`.length));
+}
+export { DESIGN_CHANGED_EVENT, announceDesignChangesWith };
+
+//# sourceMappingURL=design-events.mjs.map

package/dist/design-events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-events.mjs","names":[],"sources":["../src/design-events.ts"],"sourcesContent":["/**\n * `design:changed`: a design moved after its baseline was approved, or no longer exists. It rides\n * the existing paths (signed webhooks and the notification fan-out) and is a normal subscribable\n * topic: it is not default-on (see `notify.ts`), so only people who opted in hear about it.\n *\n * Sent once per (project, design node, design version) from the first health check that sees the\n * change. The durable claim is `DesignNodeModel.claimChange`; with no confirmed public origin\n * nothing is sent and nothing is claimed, so the change is still announced once an origin exists.\n * There is no boot replay: an unannounced change waits for the next health check.\n */\nimport { emitWebhookEvent } from \"@storyshelf/core/adapter/webhook-events\";\nimport { designChange, type DesignChange, type DesignNodeModel } from \"@storyshelf/core/models\";\nimport type { DesignNode, Project } from \"@storyshelf/core/schema\";\nimport { createUrlBuilder } from \"@storyshelf/core/urls\";\nimport { credentialKeys } from \"./credential-keys.ts\";\nimport { clearPaused, notificationOrigin, warnPaused } from \"./notifications-pause.ts\";\nimport { notifyProjectWith, type NotifyDeps } from \"./notify.ts\";\n\n/** Event name of a design change. */\nexport const DESIGN_CHANGED_EVENT = \"design:changed\";\n\n/** What `design:changed` carries. */\nexport interface DesignChangedData extends Record<string, unknown> {\n  projectId: string;\n  /** Story file (the component) whose design changed. */\n  componentPath: string;\n  figmaUrl: string;\n  change: DesignChange[\"change\"];\n  designVersion: string | null;\n}\n\n/** One design a health check looked at. */\nexport interface DesignObservation {\n  url: string;\n  node: DesignNode | undefined;\n  /** The component (story file) the design belongs to. */\n  componentPath: string | null;\n  /** Version of the baseline the component was approved at. */\n  baselineVersion: string | null;\n}\n\n/**\n * Announce every observed design change not announced before. Never throws: a failure is logged\n * and the next health check tries again.\n */\nexport async function announceDesignChangesWith(\n  deps: NotifyDeps,\n  nodes: Pick<DesignNodeModel, \"claimChange\">,\n  project: Pick<Project, \"id\" | \"slug\">,\n  observations: readonly DesignObservation[],\n): Promise<void> {\n  const changes = observations.flatMap((observation) => {\n    const change = observation.componentPath\n      ? designChange(observation.node, observation.baselineVersion)\n      : null;\n    return observation.node && observation.componentPath && change\n      ? [\n          {\n            ...observation,\n            node: observation.node,\n            componentPath: observation.componentPath,\n            change,\n          },\n        ]\n      : [];\n  });\n  if (changes.length === 0 || !(await originConfirmed(deps))) return;\n  await Promise.all(\n    changes.map(async (item) => {\n      try {\n        if (await nodes.claimChange(item.node, item.change)) await announce(deps, project, item);\n      } catch (error) {\n        deps.logger.warn({ err: error, projectId: project.id }, \"design change not announced\");\n      }\n    }),\n  );\n}\n\nasync function originConfirmed(deps: NotifyDeps): Promise<boolean> {\n  const origin = await notificationOrigin(deps);\n  if (origin === undefined) {\n    warnPaused(deps.logger, DESIGN_CHANGED_EVENT);\n    return false;\n  }\n  clearPaused(deps.logger);\n  return true;\n}\n\nasync function announce(\n  deps: NotifyDeps,\n  project: Pick<Project, \"id\" | \"slug\">,\n  item: { url: string; componentPath: string; change: DesignChange },\n): Promise<void> {\n  const data: DesignChangedData = {\n    projectId: project.id,\n    componentPath: item.componentPath,\n    figmaUrl: item.url,\n    change: item.change.change,\n    designVersion: item.change.designVersion,\n  };\n  await emitWebhookEvent(\n    deps.db,\n    { webhooks: deps.db.tables.webhooks },\n    project.id,\n    DESIGN_CHANGED_EVENT,\n    data,\n    credentialKeys(deps.config),\n    deps.logger,\n  );\n  const component = createUrlBuilder(\"\").component(project.slug, item.componentPath);\n  await notifyProjectWith(\n    deps,\n    project,\n    DESIGN_CHANGED_EVENT,\n    data,\n    component.slice(`/projects/${project.slug}`.length),\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAmBA,MAAa,uBAAuB;;;;;AA0BpC,eAAsB,0BACpB,MACA,OACA,SACA,cACe;CACf,MAAM,UAAU,aAAa,SAAS,gBAAgB;EACpD,MAAM,SAAS,YAAY,gBACvB,aAAa,YAAY,MAAM,YAAY,eAAe,IAC1D;EACJ,OAAO,YAAY,QAAQ,YAAY,iBAAiB,SACpD,CACE;GACE,GAAG;GACH,MAAM,YAAY;GAClB,eAAe,YAAY;GAC3B;EACF,CACF,IACA,CAAC;CACP,CAAC;CACD,IAAI,QAAQ,WAAW,KAAK,CAAE,MAAM,gBAAgB,IAAI,GAAI;CAC5D,MAAM,QAAQ,IACZ,QAAQ,IAAI,OAAO,SAAS;EAC1B,IAAI;GACF,IAAI,MAAM,MAAM,YAAY,KAAK,MAAM,KAAK,MAAM,GAAG,MAAM,SAAS,MAAM,SAAS,IAAI;EACzF,SAAS,OAAO;GACd,KAAK,OAAO,KAAK;IAAE,KAAK;IAAO,WAAW,QAAQ;GAAG,GAAG,6BAA6B;EACvF;CACF,CAAC,CACH;AACF;AAEA,eAAe,gBAAgB,MAAoC;CAEjE,IAAI,MADiB,mBAAmB,IAAI,MAC7B,KAAA,GAAW;EACxB,WAAW,KAAK,QAAQ,oBAAoB;EAC5C,OAAO;CACT;CACA,YAAY,KAAK,MAAM;CACvB,OAAO;AACT;AAEA,eAAe,SACb,MACA,SACA,MACe;CACf,MAAM,OAA0B;EAC9B,WAAW,QAAQ;EACnB,eAAe,KAAK;EACpB,UAAU,KAAK;EACf,QAAQ,KAAK,OAAO;EACpB,eAAe,KAAK,OAAO;CAC7B;CACA,MAAM,iBACJ,KAAK,IACL,EAAE,UAAU,KAAK,GAAG,OAAO,SAAS,GACpC,QAAQ,IACR,sBACA,MACA,eAAe,KAAK,MAAM,GAC1B,KAAK,MACP;CACA,MAAM,YAAY,iBAAiB,EAAE,CAAC,CAAC,UAAU,QAAQ,MAAM,KAAK,aAAa;CACjF,MAAM,kBACJ,MACA,SACA,sBACA,MACA,UAAU,MAAM,aAAa,QAAQ,OAAO,MAAM,CACpD;AACF"}

package/dist/index.mjs

@@ -380,7 +380,7 @@ function registerDocs(app) {
 * from source (dev server, tests).
 */
 function packageVersion() {
-	return "0.8.0";
+	return "0.9.0-next-588f070";
 }
 export { createAuthSystemHook, createShelfApp, createShelfLogger };
 

package/dist/notify.mjs

@@ -76,7 +76,10 @@ async function targetsForSub(db, sub, wired) {
 		enabled: true
 	}));
 }
-/** Topics that reach a project's approvers and admins unless they opted out (ADR 0013, decision 4). */
+/**
+* Topics that reach a project's approvers and admins unless they opted out (ADR 0013, decision 4).
+* Every other topic (`design:changed` included) reaches only people who subscribed to it.
+*/
 const DEFAULT_ON_EVENTS = /* @__PURE__ */ new Set(["review:requested"]);
 /** Roles that review builds: the default recipients of {@link DEFAULT_ON_EVENTS}. */
 const REVIEWER_ROLES = /* @__PURE__ */ new Set(["approver", "admin"]);

package/dist/notify.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"notify.mjs","names":[],"sources":["../src/notify.ts"],"sourcesContent":["/**\n * Notification fan-out for routers: loads stored channels and subscriber\n * emails, then delegates to the wired notifier providers. Best-effort and\n * non-fatal — failures are logged inside the emitters, never thrown here.\n */\nimport type { DatabaseAdapter } from \"@storyshelf/core/adapter/database\";\nimport type { NotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport {\n  emitNotifications,\n  emitSystemNotification,\n  type ChannelOutcome,\n  type NotificationBrand,\n  type NotificationChannel,\n  type SystemEventName,\n} from \"@storyshelf/core/adapter/notifier\";\nimport type { NotificationsConfig, ShelfConfig, UIConfig } from \"@storyshelf/core/config\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport {\n  MemberModel,\n  NotificationChannelModel,\n  NotificationSubscriptionModel,\n  UserModel,\n  type PublicOriginResolver,\n} from \"@storyshelf/core/models\";\nimport type { NotificationSubscriptionRow } from \"@storyshelf/core/schema\";\nimport type { Project } from \"@storyshelf/core/schema\";\nimport { credentialKeys } from \"./credential-keys.ts\";\nimport { clearPaused, notificationOrigin, warnPaused } from \"./notifications-pause.ts\";\nimport { getStore } from \"./store.ts\";\n\n/** Explicit dependencies for background fan-out (no request scope). */\nexport interface NotifyDeps {\n  db: DatabaseAdapter;\n  config: ShelfConfig;\n  ui: UIConfig;\n  logger: Logger;\n  notifiers: NotifierProvider[];\n  /** Brand/sender settings (`notifications.config`). */\n  notificationsConfig?: NotificationsConfig;\n  /** The public origin resolver; absent ⇒ `config.publicBaseUrl` only. */\n  publicOrigin?: Pick<PublicOriginResolver, \"url\"> | undefined;\n}\n\n/** Absolute review URL for a project page under the resolved public origin. */\nfunction reviewUrlFor(origin: string, slug: string, suffix: string): string {\n  return `${origin}/projects/${slug}${suffix}`;\n}\n\n/**\n * The origin notifications link to; `undefined` (after one log line per pause) while none is\n * resolved, which pauses every notification (ADR 0014, decision 11).\n */\nasync function originOrPause(\n  deps: Pick<NotifyDeps, \"config\" | \"publicOrigin\" | \"logger\">,\n  event: string,\n): Promise<string | undefined> {\n  const origin = await notificationOrigin(deps);\n  if (origin === undefined) {\n    warnPaused(deps.logger, event);\n  } else {\n    clearPaused(deps.logger);\n  }\n  return origin;\n}\n\n/** Brand inputs from UI config plus the notification sender settings. */\nfunction brandFor(\n  ui: UIConfig,\n  settings: NotificationsConfig | undefined,\n  reviewUrl?: string,\n): NotificationBrand {\n  return {\n    name: ui.name,\n    logo: ui.logo,\n    reviewUrl,\n    fromEmail: settings?.fromEmail,\n    fromName: settings?.fromName ?? ui.name,\n    footerText: settings?.footerText,\n  };\n}\n\n/** Load stored channels as send-ready views (skips undecryptable secrets). */\nasync function loadChannels(\n  deps: Pick<NotifyDeps, \"db\" | \"config\">,\n  projectId: string | null,\n): Promise<NotificationChannel[]> {\n  const model = channelModel(deps);\n  const rows = projectId === null ? await model.listSystem() : await model.list(projectId);\n  return rows.filter((row) => row.enabled).flatMap((row) => model.toView(row) ?? []);\n}\n\n/** The channel model bound to the server secret. */\nfunction channelModel(deps: Pick<NotifyDeps, \"db\" | \"config\">): NotificationChannelModel {\n  return new NotificationChannelModel(deps.db, undefined, credentialKeys(deps.config));\n}\n\n/** Record each delivery outcome on its channel row (the last error shown in settings). */\nfunction recordOutcomes(\n  deps: Pick<NotifyDeps, \"db\" | \"config\" | \"logger\">,\n): (outcome: ChannelOutcome) => Promise<void> {\n  const model = channelModel(deps);\n  return async (outcome) => {\n    if (outcome.channelId.startsWith(\"sub:\") || outcome.channelId.startsWith(\"default:\")) {\n      return;\n    }\n    await model.recordOutcome(outcome.channelId, outcome.error).catch((error: unknown) => {\n      deps.logger.warn({ err: error, channelId: outcome.channelId }, \"failed to record outcome\");\n    });\n  };\n}\n\n/** Subscriptions matching an event (enabled + allowlist). */\nfunction matchingSubs(\n  rows: NotificationSubscriptionRow[],\n  event: string,\n): NotificationSubscriptionRow[] {\n  return rows.filter((row) => {\n    if (!row.enabled) {\n      return false;\n    }\n    const events = NotificationSubscriptionModel.eventsOf(row);\n    return events.length === 0 || events.includes(event);\n  });\n}\n\n/** Per-subscriber targets for one subscription (wired kinds only). */\nasync function targetsForSub(\n  db: DatabaseAdapter,\n  sub: NotificationSubscriptionRow,\n  wired: ReadonlySet<string>,\n): Promise<NotificationChannel[]> {\n  const user = await new UserModel(db).get(sub.userId);\n  if (!user || user.disabled) {\n    return [];\n  }\n  const kinds = NotificationSubscriptionModel.viaOf(sub);\n  const wants = kinds.length > 0 ? kinds : [\"email\"];\n  return wants\n    .filter((kind) => wired.has(kind))\n    .map((kind) => ({\n      id: `sub:${sub.id}:${kind}`,\n      projectId: sub.projectId,\n      provider: kind,\n      config: { to: user.email },\n      events: [],\n      enabled: true,\n    }));\n}\n\n/** Topics that reach a project's approvers and admins unless they opted out (ADR 0013, decision 4). */\nconst DEFAULT_ON_EVENTS: ReadonlySet<string> = new Set([\"review:requested\"]);\n\n/** Roles that review builds: the default recipients of {@link DEFAULT_ON_EVENTS}. */\nconst REVIEWER_ROLES: ReadonlySet<string> = new Set([\"approver\", \"admin\"]);\n\n/**\n * Reviewers with no subscription row for the project: a default-on topic reaches them by email.\n * Anyone with a row decides for themselves (`enabled` off or a topic list without the event opts\n * out), so a row never adds a second message here.\n */\nasync function defaultTargets(\n  db: DatabaseAdapter,\n  projectId: string,\n  rows: NotificationSubscriptionRow[],\n  wired: ReadonlySet<string>,\n): Promise<NotificationChannel[]> {\n  if (!wired.has(\"email\")) {\n    return [];\n  }\n  const subscribed = new Set(rows.map((row) => row.userId));\n  const members = (await new MemberModel(db).list(projectId)).filter(\n    (member) => REVIEWER_ROLES.has(member.role) && !subscribed.has(member.userId),\n  );\n  const targets = await Promise.all(\n    members.map(async (member): Promise<NotificationChannel[]> => {\n      const user = await new UserModel(db).get(member.userId);\n      return !user || user.disabled\n        ? []\n        : [\n            {\n              id: `default:${projectId}:${member.userId}`,\n              projectId,\n              provider: \"email\",\n              config: { to: user.email },\n              events: [],\n              enabled: true,\n            },\n          ];\n    }),\n  );\n  return targets.flat();\n}\n\n/** Per-subscriber targets for an event (only kinds that are wired). */\nasync function subscriberTargets(\n  db: DatabaseAdapter,\n  projectId: string,\n  event: string,\n  wired: ReadonlySet<string>,\n): Promise<NotificationChannel[]> {\n  const rows = await new NotificationSubscriptionModel(db).list(projectId);\n  const nested = await Promise.all(\n    matchingSubs(rows, event).map(async (sub) => await targetsForSub(db, sub, wired)),\n  );\n  const defaults = DEFAULT_ON_EVENTS.has(event)\n    ? await defaultTargets(db, projectId, rows, wired)\n    : [];\n  return [...nested.flat(), ...defaults];\n}\n\n/**\n * Fan out a project event to stored channels plus opted-in subscribers.\n * Runs alongside (never instead of) webhook delivery.\n */\nexport async function notifyProjectWith(\n  deps: NotifyDeps,\n  project: Pick<Project, \"id\" | \"slug\">,\n  event: string,\n  data: Record<string, unknown>,\n  reviewSuffix?: string,\n): Promise<void> {\n  if (deps.notifiers.length === 0) {\n    return;\n  }\n  const origin = await originOrPause(deps, event);\n  if (origin === undefined) {\n    return;\n  }\n  const reviewUrl = reviewSuffix ? reviewUrlFor(origin, project.slug, reviewSuffix) : undefined;\n  const wired = new Set(deps.notifiers.map((candidate) => candidate.metadata.kind));\n  const channels = await loadChannels(deps, project.id);\n  const targets = await subscriberTargets(deps.db, project.id, event, wired);\n  await emitNotifications(\n    { event, projectId: project.id, projectSlug: project.slug, data, timestamp: now() },\n    {\n      notifiers: deps.notifiers,\n      channels: [...channels, ...targets],\n      brand: brandFor(deps.ui, deps.notificationsConfig, reviewUrl),\n      logger: deps.logger,\n      onOutcome: recordOutcomes(deps),\n    },\n  );\n}\n\n/**\n * Fan out a project event to stored channels plus opted-in subscribers.\n * Runs alongside (never instead of) webhook delivery.\n */\nexport async function notifyProject(\n  project: Pick<Project, \"id\" | \"slug\">,\n  event: string,\n  data: Record<string, unknown>,\n  reviewSuffix?: string,\n): Promise<void> {\n  await notifyProjectWith(getStore(), project, event, data, reviewSuffix);\n}\n\n/** Fan out a site-wide admin alert to project-less channels. */\nexport async function notifySystemWith(\n  deps: NotifyDeps,\n  event: SystemEventName,\n  data: Record<string, unknown>,\n): Promise<void> {\n  if (deps.notifiers.length === 0 || (await originOrPause(deps, event)) === undefined) {\n    return;\n  }\n  await emitSystemNotification(\n    { event, data, timestamp: now() },\n    {\n      notifiers: deps.notifiers,\n      channels: await loadChannels(deps, null),\n      brand: brandFor(deps.ui, deps.notificationsConfig),\n      logger: deps.logger,\n      onOutcome: recordOutcomes(deps),\n    },\n  );\n}\n\n/** Fan out a site-wide admin alert to project-less channels. */\nexport async function notifySystem(\n  event: SystemEventName,\n  data: Record<string, unknown>,\n): Promise<void> {\n  await notifySystemWith(getStore(), event, data);\n}\n\n/**\n * Host hook for the auth engine (`onAuthSystemEvent`): fans `sys:*` auth\n * events out to admin channels. Safe to call anywhere — outside a request\n * scope (e.g. boot) it resolves to a no-op instead of throwing.\n */\nexport function createAuthSystemHook(): (\n  event: \"sys:user-created\" | \"sys:invite-issued\",\n  data: Record<string, unknown>,\n) => Promise<void> {\n  return async (event, data): Promise<void> => {\n    await notifySystem(event, data).catch(() => {\n      // Intentionally empty — best-effort fan-out must never break auth\n    });\n  };\n}\n\n/** Current timestamp for notification envelopes. */\nfunction now(): string {\n  return new Date().toISOString();\n}\n"],"mappings":"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"}
+{"version":3,"file":"notify.mjs","names":[],"sources":["../src/notify.ts"],"sourcesContent":["/**\n * Notification fan-out for routers: loads stored channels and subscriber\n * emails, then delegates to the wired notifier providers. Best-effort and\n * non-fatal — failures are logged inside the emitters, never thrown here.\n */\nimport type { DatabaseAdapter } from \"@storyshelf/core/adapter/database\";\nimport type { NotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport {\n  emitNotifications,\n  emitSystemNotification,\n  type ChannelOutcome,\n  type NotificationBrand,\n  type NotificationChannel,\n  type SystemEventName,\n} from \"@storyshelf/core/adapter/notifier\";\nimport type { NotificationsConfig, ShelfConfig, UIConfig } from \"@storyshelf/core/config\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport {\n  MemberModel,\n  NotificationChannelModel,\n  NotificationSubscriptionModel,\n  UserModel,\n  type PublicOriginResolver,\n} from \"@storyshelf/core/models\";\nimport type { NotificationSubscriptionRow } from \"@storyshelf/core/schema\";\nimport type { Project } from \"@storyshelf/core/schema\";\nimport { credentialKeys } from \"./credential-keys.ts\";\nimport { clearPaused, notificationOrigin, warnPaused } from \"./notifications-pause.ts\";\nimport { getStore } from \"./store.ts\";\n\n/** Explicit dependencies for background fan-out (no request scope). */\nexport interface NotifyDeps {\n  db: DatabaseAdapter;\n  config: ShelfConfig;\n  ui: UIConfig;\n  logger: Logger;\n  notifiers: NotifierProvider[];\n  /** Brand/sender settings (`notifications.config`). */\n  notificationsConfig?: NotificationsConfig;\n  /** The public origin resolver; absent ⇒ `config.publicBaseUrl` only. */\n  publicOrigin?: Pick<PublicOriginResolver, \"url\"> | undefined;\n}\n\n/** Absolute review URL for a project page under the resolved public origin. */\nfunction reviewUrlFor(origin: string, slug: string, suffix: string): string {\n  return `${origin}/projects/${slug}${suffix}`;\n}\n\n/**\n * The origin notifications link to; `undefined` (after one log line per pause) while none is\n * resolved, which pauses every notification (ADR 0014, decision 11).\n */\nasync function originOrPause(\n  deps: Pick<NotifyDeps, \"config\" | \"publicOrigin\" | \"logger\">,\n  event: string,\n): Promise<string | undefined> {\n  const origin = await notificationOrigin(deps);\n  if (origin === undefined) {\n    warnPaused(deps.logger, event);\n  } else {\n    clearPaused(deps.logger);\n  }\n  return origin;\n}\n\n/** Brand inputs from UI config plus the notification sender settings. */\nfunction brandFor(\n  ui: UIConfig,\n  settings: NotificationsConfig | undefined,\n  reviewUrl?: string,\n): NotificationBrand {\n  return {\n    name: ui.name,\n    logo: ui.logo,\n    reviewUrl,\n    fromEmail: settings?.fromEmail,\n    fromName: settings?.fromName ?? ui.name,\n    footerText: settings?.footerText,\n  };\n}\n\n/** Load stored channels as send-ready views (skips undecryptable secrets). */\nasync function loadChannels(\n  deps: Pick<NotifyDeps, \"db\" | \"config\">,\n  projectId: string | null,\n): Promise<NotificationChannel[]> {\n  const model = channelModel(deps);\n  const rows = projectId === null ? await model.listSystem() : await model.list(projectId);\n  return rows.filter((row) => row.enabled).flatMap((row) => model.toView(row) ?? []);\n}\n\n/** The channel model bound to the server secret. */\nfunction channelModel(deps: Pick<NotifyDeps, \"db\" | \"config\">): NotificationChannelModel {\n  return new NotificationChannelModel(deps.db, undefined, credentialKeys(deps.config));\n}\n\n/** Record each delivery outcome on its channel row (the last error shown in settings). */\nfunction recordOutcomes(\n  deps: Pick<NotifyDeps, \"db\" | \"config\" | \"logger\">,\n): (outcome: ChannelOutcome) => Promise<void> {\n  const model = channelModel(deps);\n  return async (outcome) => {\n    if (outcome.channelId.startsWith(\"sub:\") || outcome.channelId.startsWith(\"default:\")) {\n      return;\n    }\n    await model.recordOutcome(outcome.channelId, outcome.error).catch((error: unknown) => {\n      deps.logger.warn({ err: error, channelId: outcome.channelId }, \"failed to record outcome\");\n    });\n  };\n}\n\n/** Subscriptions matching an event (enabled + allowlist). */\nfunction matchingSubs(\n  rows: NotificationSubscriptionRow[],\n  event: string,\n): NotificationSubscriptionRow[] {\n  return rows.filter((row) => {\n    if (!row.enabled) {\n      return false;\n    }\n    const events = NotificationSubscriptionModel.eventsOf(row);\n    return events.length === 0 || events.includes(event);\n  });\n}\n\n/** Per-subscriber targets for one subscription (wired kinds only). */\nasync function targetsForSub(\n  db: DatabaseAdapter,\n  sub: NotificationSubscriptionRow,\n  wired: ReadonlySet<string>,\n): Promise<NotificationChannel[]> {\n  const user = await new UserModel(db).get(sub.userId);\n  if (!user || user.disabled) {\n    return [];\n  }\n  const kinds = NotificationSubscriptionModel.viaOf(sub);\n  const wants = kinds.length > 0 ? kinds : [\"email\"];\n  return wants\n    .filter((kind) => wired.has(kind))\n    .map((kind) => ({\n      id: `sub:${sub.id}:${kind}`,\n      projectId: sub.projectId,\n      provider: kind,\n      config: { to: user.email },\n      events: [],\n      enabled: true,\n    }));\n}\n\n/**\n * Topics that reach a project's approvers and admins unless they opted out (ADR 0013, decision 4).\n * Every other topic (`design:changed` included) reaches only people who subscribed to it.\n */\nconst DEFAULT_ON_EVENTS: ReadonlySet<string> = new Set([\"review:requested\"]);\n\n/** Roles that review builds: the default recipients of {@link DEFAULT_ON_EVENTS}. */\nconst REVIEWER_ROLES: ReadonlySet<string> = new Set([\"approver\", \"admin\"]);\n\n/**\n * Reviewers with no subscription row for the project: a default-on topic reaches them by email.\n * Anyone with a row decides for themselves (`enabled` off or a topic list without the event opts\n * out), so a row never adds a second message here.\n */\nasync function defaultTargets(\n  db: DatabaseAdapter,\n  projectId: string,\n  rows: NotificationSubscriptionRow[],\n  wired: ReadonlySet<string>,\n): Promise<NotificationChannel[]> {\n  if (!wired.has(\"email\")) {\n    return [];\n  }\n  const subscribed = new Set(rows.map((row) => row.userId));\n  const members = (await new MemberModel(db).list(projectId)).filter(\n    (member) => REVIEWER_ROLES.has(member.role) && !subscribed.has(member.userId),\n  );\n  const targets = await Promise.all(\n    members.map(async (member): Promise<NotificationChannel[]> => {\n      const user = await new UserModel(db).get(member.userId);\n      return !user || user.disabled\n        ? []\n        : [\n            {\n              id: `default:${projectId}:${member.userId}`,\n              projectId,\n              provider: \"email\",\n              config: { to: user.email },\n              events: [],\n              enabled: true,\n            },\n          ];\n    }),\n  );\n  return targets.flat();\n}\n\n/** Per-subscriber targets for an event (only kinds that are wired). */\nasync function subscriberTargets(\n  db: DatabaseAdapter,\n  projectId: string,\n  event: string,\n  wired: ReadonlySet<string>,\n): Promise<NotificationChannel[]> {\n  const rows = await new NotificationSubscriptionModel(db).list(projectId);\n  const nested = await Promise.all(\n    matchingSubs(rows, event).map(async (sub) => await targetsForSub(db, sub, wired)),\n  );\n  const defaults = DEFAULT_ON_EVENTS.has(event)\n    ? await defaultTargets(db, projectId, rows, wired)\n    : [];\n  return [...nested.flat(), ...defaults];\n}\n\n/**\n * Fan out a project event to stored channels plus opted-in subscribers.\n * Runs alongside (never instead of) webhook delivery.\n */\nexport async function notifyProjectWith(\n  deps: NotifyDeps,\n  project: Pick<Project, \"id\" | \"slug\">,\n  event: string,\n  data: Record<string, unknown>,\n  reviewSuffix?: string,\n): Promise<void> {\n  if (deps.notifiers.length === 0) {\n    return;\n  }\n  const origin = await originOrPause(deps, event);\n  if (origin === undefined) {\n    return;\n  }\n  const reviewUrl = reviewSuffix ? reviewUrlFor(origin, project.slug, reviewSuffix) : undefined;\n  const wired = new Set(deps.notifiers.map((candidate) => candidate.metadata.kind));\n  const channels = await loadChannels(deps, project.id);\n  const targets = await subscriberTargets(deps.db, project.id, event, wired);\n  await emitNotifications(\n    { event, projectId: project.id, projectSlug: project.slug, data, timestamp: now() },\n    {\n      notifiers: deps.notifiers,\n      channels: [...channels, ...targets],\n      brand: brandFor(deps.ui, deps.notificationsConfig, reviewUrl),\n      logger: deps.logger,\n      onOutcome: recordOutcomes(deps),\n    },\n  );\n}\n\n/**\n * Fan out a project event to stored channels plus opted-in subscribers.\n * Runs alongside (never instead of) webhook delivery.\n */\nexport async function notifyProject(\n  project: Pick<Project, \"id\" | \"slug\">,\n  event: string,\n  data: Record<string, unknown>,\n  reviewSuffix?: string,\n): Promise<void> {\n  await notifyProjectWith(getStore(), project, event, data, reviewSuffix);\n}\n\n/** Fan out a site-wide admin alert to project-less channels. */\nexport async function notifySystemWith(\n  deps: NotifyDeps,\n  event: SystemEventName,\n  data: Record<string, unknown>,\n): Promise<void> {\n  if (deps.notifiers.length === 0 || (await originOrPause(deps, event)) === undefined) {\n    return;\n  }\n  await emitSystemNotification(\n    { event, data, timestamp: now() },\n    {\n      notifiers: deps.notifiers,\n      channels: await loadChannels(deps, null),\n      brand: brandFor(deps.ui, deps.notificationsConfig),\n      logger: deps.logger,\n      onOutcome: recordOutcomes(deps),\n    },\n  );\n}\n\n/** Fan out a site-wide admin alert to project-less channels. */\nexport async function notifySystem(\n  event: SystemEventName,\n  data: Record<string, unknown>,\n): Promise<void> {\n  await notifySystemWith(getStore(), event, data);\n}\n\n/**\n * Host hook for the auth engine (`onAuthSystemEvent`): fans `sys:*` auth\n * events out to admin channels. Safe to call anywhere — outside a request\n * scope (e.g. boot) it resolves to a no-op instead of throwing.\n */\nexport function createAuthSystemHook(): (\n  event: \"sys:user-created\" | \"sys:invite-issued\",\n  data: Record<string, unknown>,\n) => Promise<void> {\n  return async (event, data): Promise<void> => {\n    await notifySystem(event, data).catch(() => {\n      // Intentionally empty — best-effort fan-out must never break auth\n    });\n  };\n}\n\n/** Current timestamp for notification envelopes. */\nfunction now(): string {\n  return new Date().toISOString();\n}\n"],"mappings":"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"}

package/dist/pages/build-diff-environment.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { Alert } from "../ui/feedback.mjs";
 import { StaleBaselineNotice } from "./build-diff-stale.mjs";
-import { environmentChangeOf, labelOf, summariseEnvironmentChanges } from "./environment-change.mjs";
+import { environmentChangeOf, labelOf, summariseEnvironmentChanges, summarisePartlyUnknown } from "./environment-change.mjs";
 import { Fragment, jsx, jsxs } from "hono/jsx/jsx-runtime";
 // src/pages/build-diff-environment.tsx
 /**
@@ -11,6 +11,30 @@ import { Fragment, jsx, jsxs } from "hono/jsx/jsx-runtime";
 * The default branch migrates them without a diff; a feature branch still diffs them (ADR 0005).
 */
 function EnvironmentChangeNotice(props) {
+	const unknown = summarisePartlyUnknown(props.snapshots);
+	const changed = /* @__PURE__ */ jsx(EnvironmentMigrationNotice, { ...props });
+	return unknown ? /* @__PURE__ */ jsxs(Fragment, { children: [changed, /* @__PURE__ */ jsx(PartlyUnknownNotice, {
+		count: unknown.count,
+		fields: unknown.fields
+	})] }) : changed;
+}
+/** The measurement version changed: some components were compared as unknown, not as different. */
+function PartlyUnknownNotice(props) {
+	const { count, fields } = props;
+	return /* @__PURE__ */ jsxs(Alert, {
+		tone: "info",
+		title: "Environment partly unknown (measurement updated)",
+		children: [
+			count,
+			" ",
+			count === 1 ? "snapshot has" : "snapshots have",
+			" a baseline whose environment was measured an older way, so the ",
+			fields.join(", "),
+			" could not be compared. They are not treated as a change, and nothing was migrated because of them."
+		]
+	});
+}
+function EnvironmentMigrationNotice(props) {
 	const summary = summariseEnvironmentChanges(props.snapshots);
 	if (!summary) return null;
 	const { count, fields, browserVersion } = summary;
@@ -43,8 +67,14 @@ function EnvironmentChangeNotice(props) {
 function EnvironmentChangeSnapshotNotice(props) {
 	const change = environmentChangeOf(props.snapshot);
 	if (!change) return null;
+	const unknown = (change.unknown ?? []).map((field) => labelOf(field));
+	const note = unknown.length > 0 ? /* @__PURE__ */ jsx(PartlyUnknownNotice, {
+		count: 1,
+		fields: unknown
+	}) : null;
+	if (change.changed.length === 0) return note;
 	const what = change.changed.map((field) => labelOf(field)).join(", ");
-	return props.migrated ? /* @__PURE__ */ jsxs(Alert, {
+	return /* @__PURE__ */ jsxs(Fragment, { children: [props.migrated ? /* @__PURE__ */ jsxs(Alert, {
 		tone: "info",
 		title: "No diff: capture environment changed",
 		children: [
@@ -60,7 +90,7 @@ function EnvironmentChangeSnapshotNotice(props) {
 			what,
 			"), so a difference may come from the environment rather than the code."
 		]
-	});
+	}), note] });
 }
 /** Build-level notices above the review grid: stale baselines and environment migrations. */
 function ReviewNotices(props) {

package/dist/pages/build-diff-environment.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-diff-environment.mjs","names":[],"sources":["../../src/pages/build-diff-environment.tsx"],"sourcesContent":["import type { Build, Project, Snapshot } from \"@storyshelf/core/schema\";\nimport type { HtmlEscapedString } from \"hono/utils/html\";\nimport { Alert } from \"../ui/components.tsx\";\nimport { StaleBaselineNotice } from \"./build-diff-stale.tsx\";\nimport { environmentChangeOf, labelOf, summariseEnvironmentChanges } from \"./environment-change.ts\";\n\n/* eslint-disable promise-function-async -- Hono JSX components return HtmlEscapedString | Promise<HtmlEscapedString> */\n\n/**\n * Build-level note: some snapshots were captured in a different environment than their baseline.\n * The default branch migrates them without a diff; a feature branch still diffs them (ADR 0005).\n */\nexport function EnvironmentChangeNotice(props: {\n  snapshots: readonly Snapshot[];\n  migrated: boolean;\n}): HtmlEscapedString | Promise<HtmlEscapedString> | null {\n  const summary = summariseEnvironmentChanges(props.snapshots);\n  if (!summary) {\n    return null;\n  }\n  const { count, fields, browserVersion } = summary;\n  const what = `the ${fields.join(\", \")} changed${\n    browserVersion ? ` (${browserVersion.from} → ${browserVersion.to})` : \"\"\n  }`;\n  return props.migrated ? (\n    <Alert tone=\"info\" title=\"Capture environment changed\">\n      {count} {count === 1 ? \"snapshot was\" : \"snapshots were\"} accepted without a pixel diff\n      because {what}. The same code renders differently here, so a diff would only show the\n      environment. The baselines were updated to match.\n    </Alert>\n  ) : (\n    <Alert tone=\"info\" title=\"Capture environment changed\">\n      {count} {count === 1 ? \"snapshot was\" : \"snapshots were\"} compared against a baseline from a\n      different capture environment: {what}. A difference may come from the environment rather than\n      the code; once the default branch captures in the new environment, a rebuild compares like\n      with like.\n    </Alert>\n  );\n}\n\n/** Per-snapshot note shown above the viewer for a snapshot whose capture environment changed. */\nexport function EnvironmentChangeSnapshotNotice(props: {\n  snapshot: Pick<Snapshot, \"envChange\">;\n  migrated: boolean;\n}): HtmlEscapedString | Promise<HtmlEscapedString> | null {\n  const change = environmentChangeOf(props.snapshot);\n  if (!change) {\n    return null;\n  }\n  const what = change.changed.map((field) => labelOf(field)).join(\", \");\n  return props.migrated ? (\n    <Alert tone=\"info\" title=\"No diff: capture environment changed\">\n      This snapshot was not compared pixel by pixel. What changed: {what}.\n    </Alert>\n  ) : (\n    <Alert tone=\"info\" title=\"Capture environment changed\">\n      The baseline was captured in a different environment ({what}), so a difference may come from\n      the environment rather than the code.\n    </Alert>\n  );\n}\n\n/** Build-level notices above the review grid: stale baselines and environment migrations. */\nexport function ReviewNotices(props: {\n  project: Project;\n  build: Build;\n  snapshots: readonly Snapshot[];\n  drifted: Record<string, unknown>;\n  canReview: boolean;\n}): HtmlEscapedString | Promise<HtmlEscapedString> {\n  const { project, build, snapshots, drifted, canReview } = props;\n  const staleCount = Object.keys(drifted).length;\n  return (\n    <>\n      {staleCount > 0 ? (\n        <StaleBaselineNotice\n          project={project}\n          build={build}\n          staleCount={staleCount}\n          canReview={canReview}\n        />\n      ) : null}\n      <EnvironmentChangeNotice snapshots={snapshots} migrated={build.isDefault} />\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,wBAAwB,OAGkB;CACxD,MAAM,UAAU,4BAA4B,MAAM,SAAS;CAC3D,IAAI,CAAC,SACH,OAAO;CAET,MAAM,EAAE,OAAO,QAAQ,mBAAmB;CAC1C,MAAM,OAAO,OAAO,OAAO,KAAK,IAAI,EAAE,UACpC,iBAAiB,KAAK,eAAe,KAAK,KAAK,eAAe,GAAG,KAAK;CAExE,OAAO,MAAM,WACX,qBAAC,OAAD;EAAO,MAAK;EAAO,OAAM;EAAzB,UAAA;GACG;GAAM;GAAE,UAAU,IAAI,iBAAiB;GAAiB;GAChD;GAAK;EAET;CAEP,CAAA,IAAA,qBAAC,OAAD;EAAO,MAAK;EAAO,OAAM;EAAzB,UAAA;GACG;GAAM;GAAE,UAAU,IAAI,iBAAiB;GAAiB;GACzB;GAAK;EAGhC;;AAEX;;AAGA,SAAgB,gCAAgC,OAGU;CACxD,MAAM,SAAS,oBAAoB,MAAM,QAAQ;CACjD,IAAI,CAAC,QACH,OAAO;CAET,MAAM,OAAO,OAAO,QAAQ,KAAK,UAAU,QAAQ,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;CACpE,OAAO,MAAM,WACX,qBAAC,OAAD;EAAO,MAAK;EAAO,OAAM;EAAzB,UAAA;GAAgE;GACA;GAAK;EAC9D;CAEP,CAAA,IAAA,qBAAC,OAAD;EAAO,MAAK;EAAO,OAAM;EAAzB,UAAA;GAAuD;GACE;GAAK;EAEvD;;AAEX;;AAGA,SAAgB,cAAc,OAMqB;CACjD,MAAM,EAAE,SAAS,OAAO,WAAW,SAAS,cAAc;CAC1D,MAAM,aAAa,OAAO,KAAK,OAAO,CAAC,CAAC;CACxC,OACE,qBAAA,UAAA,EAAA,UAAA,CACG,aAAa,IACZ,oBAAC,qBAAD;EACW;EACF;EACK;EACD;CACZ,CAAA,IACC,MACJ,oBAAC,yBAAD;EAAoC;EAAW,UAAU,MAAM;CAAY,CAAA,CAC3E,EAAA,CAAA;AAEN"}
+{"version":3,"file":"build-diff-environment.mjs","names":[],"sources":["../../src/pages/build-diff-environment.tsx"],"sourcesContent":["import type { Build, Project, Snapshot } from \"@storyshelf/core/schema\";\nimport type { HtmlEscapedString } from \"hono/utils/html\";\nimport { Alert } from \"../ui/components.tsx\";\nimport { StaleBaselineNotice } from \"./build-diff-stale.tsx\";\nimport {\n  environmentChangeOf,\n  labelOf,\n  summariseEnvironmentChanges,\n  summarisePartlyUnknown,\n} from \"./environment-change.ts\";\n\n/* eslint-disable promise-function-async -- Hono JSX components return HtmlEscapedString | Promise<HtmlEscapedString> */\n\n/**\n * Build-level note: some snapshots were captured in a different environment than their baseline.\n * The default branch migrates them without a diff; a feature branch still diffs them (ADR 0005).\n */\nexport function EnvironmentChangeNotice(props: {\n  snapshots: readonly Snapshot[];\n  migrated: boolean;\n}): HtmlEscapedString | Promise<HtmlEscapedString> | null {\n  const unknown = summarisePartlyUnknown(props.snapshots);\n  const changed = <EnvironmentMigrationNotice {...props} />;\n  return unknown ? (\n    <>\n      {changed}\n      <PartlyUnknownNotice count={unknown.count} fields={unknown.fields} />\n    </>\n  ) : (\n    changed\n  );\n}\n\n/** The measurement version changed: some components were compared as unknown, not as different. */\nfunction PartlyUnknownNotice(props: {\n  count: number;\n  fields: string[];\n}): HtmlEscapedString | Promise<HtmlEscapedString> {\n  const { count, fields } = props;\n  return (\n    <Alert tone=\"info\" title=\"Environment partly unknown (measurement updated)\">\n      {count} {count === 1 ? \"snapshot has\" : \"snapshots have\"} a baseline whose environment was\n      measured an older way, so the {fields.join(\", \")} could not be compared. They are not treated\n      as a change, and nothing was migrated because of them.\n    </Alert>\n  );\n}\n\nfunction EnvironmentMigrationNotice(props: {\n  snapshots: readonly Snapshot[];\n  migrated: boolean;\n}): HtmlEscapedString | Promise<HtmlEscapedString> | null {\n  const summary = summariseEnvironmentChanges(props.snapshots);\n  if (!summary) {\n    return null;\n  }\n  const { count, fields, browserVersion } = summary;\n  const what = `the ${fields.join(\", \")} changed${\n    browserVersion ? ` (${browserVersion.from} → ${browserVersion.to})` : \"\"\n  }`;\n  return props.migrated ? (\n    <Alert tone=\"info\" title=\"Capture environment changed\">\n      {count} {count === 1 ? \"snapshot was\" : \"snapshots were\"} accepted without a pixel diff\n      because {what}. The same code renders differently here, so a diff would only show the\n      environment. The baselines were updated to match.\n    </Alert>\n  ) : (\n    <Alert tone=\"info\" title=\"Capture environment changed\">\n      {count} {count === 1 ? \"snapshot was\" : \"snapshots were\"} compared against a baseline from a\n      different capture environment: {what}. A difference may come from the environment rather than\n      the code; once the default branch captures in the new environment, a rebuild compares like\n      with like.\n    </Alert>\n  );\n}\n\n/** Per-snapshot note shown above the viewer for a snapshot whose capture environment changed. */\nexport function EnvironmentChangeSnapshotNotice(props: {\n  snapshot: Pick<Snapshot, \"envChange\">;\n  migrated: boolean;\n}): HtmlEscapedString | Promise<HtmlEscapedString> | null {\n  const change = environmentChangeOf(props.snapshot);\n  if (!change) {\n    return null;\n  }\n  const unknown = (change.unknown ?? []).map((field) => labelOf(field));\n  const note = unknown.length > 0 ? <PartlyUnknownNotice count={1} fields={unknown} /> : null;\n  if (change.changed.length === 0) {\n    return note;\n  }\n  const what = change.changed.map((field) => labelOf(field)).join(\", \");\n  return (\n    <>\n      {props.migrated ? (\n        <Alert tone=\"info\" title=\"No diff: capture environment changed\">\n          This snapshot was not compared pixel by pixel. What changed: {what}.\n        </Alert>\n      ) : (\n        <Alert tone=\"info\" title=\"Capture environment changed\">\n          The baseline was captured in a different environment ({what}), so a difference may come\n          from the environment rather than the code.\n        </Alert>\n      )}\n      {note}\n    </>\n  );\n}\n\n/** Build-level notices above the review grid: stale baselines and environment migrations. */\nexport function ReviewNotices(props: {\n  project: Project;\n  build: Build;\n  snapshots: readonly Snapshot[];\n  drifted: Record<string, unknown>;\n  canReview: boolean;\n}): HtmlEscapedString | Promise<HtmlEscapedString> {\n  const { project, build, snapshots, drifted, canReview } = props;\n  const staleCount = Object.keys(drifted).length;\n  return (\n    <>\n      {staleCount > 0 ? (\n        <StaleBaselineNotice\n          project={project}\n          build={build}\n          staleCount={staleCount}\n          canReview={canReview}\n        />\n      ) : null}\n      <EnvironmentChangeNotice snapshots={snapshots} migrated={build.isDefault} />\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAiBA,SAAgB,wBAAwB,OAGkB;CACxD,MAAM,UAAU,uBAAuB,MAAM,SAAS;CACtD,MAAM,UAAU,oBAAC,4BAAD,EAA4B,GAAI,MAAQ,CAAA;CACxD,OAAO,UACL,qBAAA,UAAA,EAAA,UAAA,CACG,SACD,oBAAC,qBAAD;EAAqB,OAAO,QAAQ;EAAO,QAAQ,QAAQ;CAAS,CAAA,CACpE,EAAA,CAAA,IAEF;AAEJ;;AAGA,SAAS,oBAAoB,OAGsB;CACjD,MAAM,EAAE,OAAO,WAAW;CAC1B,OACE,qBAAC,OAAD;EAAO,MAAK;EAAO,OAAM;EAAzB,UAAA;GACG;GAAM;GAAE,UAAU,IAAI,iBAAiB;GAAiB;GAC1B,OAAO,KAAK,IAAI;GAAE;EAE5C;;AAEX;AAEA,SAAS,2BAA2B,OAGsB;CACxD,MAAM,UAAU,4BAA4B,MAAM,SAAS;CAC3D,IAAI,CAAC,SACH,OAAO;CAET,MAAM,EAAE,OAAO,QAAQ,mBAAmB;CAC1C,MAAM,OAAO,OAAO,OAAO,KAAK,IAAI,EAAE,UACpC,iBAAiB,KAAK,eAAe,KAAK,KAAK,eAAe,GAAG,KAAK;CAExE,OAAO,MAAM,WACX,qBAAC,OAAD;EAAO,MAAK;EAAO,OAAM;EAAzB,UAAA;GACG;GAAM;GAAE,UAAU,IAAI,iBAAiB;GAAiB;GAChD;GAAK;EAET;CAEP,CAAA,IAAA,qBAAC,OAAD;EAAO,MAAK;EAAO,OAAM;EAAzB,UAAA;GACG;GAAM;GAAE,UAAU,IAAI,iBAAiB;GAAiB;GACzB;GAAK;EAGhC;;AAEX;;AAGA,SAAgB,gCAAgC,OAGU;CACxD,MAAM,SAAS,oBAAoB,MAAM,QAAQ;CACjD,IAAI,CAAC,QACH,OAAO;CAET,MAAM,WAAW,OAAO,WAAW,CAAC,EAAA,CAAG,KAAK,UAAU,QAAQ,KAAK,CAAC;CACpE,MAAM,OAAO,QAAQ,SAAS,IAAI,oBAAC,qBAAD;EAAqB,OAAO;EAAG,QAAQ;CAAU,CAAA,IAAI;CACvF,IAAI,OAAO,QAAQ,WAAW,GAC5B,OAAO;CAET,MAAM,OAAO,OAAO,QAAQ,KAAK,UAAU,QAAQ,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;CACpE,OACE,qBAAA,UAAA,EAAA,UAAA,CACG,MAAM,WACL,qBAAC,OAAD;EAAO,MAAK;EAAO,OAAM;EAAzB,UAAA;GAAgE;GACA;GAAK;EAC9D;CAEP,CAAA,IAAA,qBAAC,OAAD;EAAO,MAAK;EAAO,OAAM;EAAzB,UAAA;GAAuD;GACE;GAAK;EAEvD;CAER,CAAA,GAAA,IACD,EAAA,CAAA;AAEN;;AAGA,SAAgB,cAAc,OAMqB;CACjD,MAAM,EAAE,SAAS,OAAO,WAAW,SAAS,cAAc;CAC1D,MAAM,aAAa,OAAO,KAAK,OAAO,CAAC,CAAC;CACxC,OACE,qBAAA,UAAA,EAAA,UAAA,CACG,aAAa,IACZ,oBAAC,qBAAD;EACW;EACF;EACK;EACD;CACZ,CAAA,IACC,MACJ,oBAAC,yBAAD;EAAoC;EAAW,UAAU,MAAM;CAAY,CAAA,CAC3E,EAAA,CAAA;AAEN"}

package/dist/pages/design-coverage.mjs

@@ -0,0 +1,333 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { getStore } from "../store.mjs";
+import { css } from "../ui/css.mjs";
+import { Button } from "../ui/buttons.mjs";
+import { Alert, Badge, EmptyState, Meta, Stat } from "../ui/feedback.mjs";
+import { Card, PageHeader, SectionTitle } from "../ui/layout.mjs";
+import { HStack, VStack } from "../ui/stacks.mjs";
+import { Table } from "../ui/table.mjs";
+import { RelativeTime } from "../ui/time.mjs";
+import { DocumentLayout } from "../ui/document.mjs";
+import { Fragment, jsx, jsxs } from "hono/jsx/jsx-runtime";
+import { createUrlBuilder } from "@storyshelf/core/urls";
+// src/pages/design-coverage.tsx
+const wideOnly = css`
+  /* coverage-wide-only */
+  @media (max-width: 640px) {
+    & {
+      display: none;
+    }
+  }
+`;
+const narrowOnly = css`
+  /* coverage-narrow-only */
+  display: none;
+  @media (max-width: 640px) {
+    & {
+      display: block;
+    }
+  }
+`;
+const statLink = css`
+  /* coverage-stat-link */
+  display: block;
+  color: inherit;
+  text-decoration: none;
+  &:hover,
+  &:focus-visible {
+    text-decoration: none;
+  }
+`;
+const widePath = css`
+  /* coverage-wide-path */
+  ${wideOnly}
+  overflow-wrap: anywhere;
+`;
+/** The design coverage page: what lacks a design, what drifted, and how much is in sync. */
+function renderDesignCoveragePage(data) {
+	const { project, build } = data;
+	const urls = createUrlBuilder("/", getStore().config.publishedBaseDomain);
+	return /* @__PURE__ */ jsxs(DocumentLayout, {
+		title: "Design coverage",
+		nav: {
+			active: "library",
+			projectSlug: project.slug,
+			projectName: project.name,
+			trail: [{
+				label: "Library",
+				href: urls.library(project.slug)
+			}, { label: "Design coverage" }]
+		},
+		children: [/* @__PURE__ */ jsx(PageHeader, {
+			title: "Design coverage",
+			description: "Which components have a design file, and which have drifted from it.",
+			meta: build ? `Latest accepted build: ${build.gitBranch} · ${build.gitSha.slice(0, 7)}` : void 0
+		}), build ? /* @__PURE__ */ jsx(CoverageBody, { data }) : /* @__PURE__ */ jsx(EmptyState, {
+			title: "No build to check yet",
+			description: "Design coverage is read from the latest accepted build. Upload a Storybook and accept a build first.",
+			action: /* @__PURE__ */ jsx(Button, {
+				variant: "secondary",
+				size: "sm",
+				href: urls.buildsList(project.slug),
+				children: "Go to builds"
+			})
+		})]
+	});
+}
+/** Drift cannot be told for the linked designs: some provider has no token and nothing is known to have drifted. */
+function driftUnavailable(data) {
+	return data.withoutToken.length > 0 && data.drifted.length === 0;
+}
+function CoverageBody(props) {
+	const { data } = props;
+	const unavailable = driftUnavailable(data);
+	return /* @__PURE__ */ jsxs(VStack, { children: [
+		data.storyLinksRead ? null : /* @__PURE__ */ jsx(Alert, {
+			tone: "info",
+			title: "Only mapped design links are counted",
+			children: "Links declared in stories are read from captured builds, so they are not counted without testing. Components linked under Settings → Design are."
+		}),
+		/* @__PURE__ */ jsxs("div", {
+			class: "grid grid--3",
+			children: [
+				/* @__PURE__ */ jsx("a", {
+					href: "#no-link",
+					class: statLink,
+					children: /* @__PURE__ */ jsx(Stat, {
+						label: "No design link",
+						value: data.unlinked.length,
+						tone: data.unlinked.length > 0 ? "warning" : "success"
+					})
+				}),
+				/* @__PURE__ */ jsx("a", {
+					href: "#drift",
+					class: statLink,
+					children: /* @__PURE__ */ jsx(Stat, {
+						label: unavailable ? "Needs attention · Unavailable" : "Needs attention",
+						value: unavailable ? "–" : data.drifted.length,
+						tone: unavailable ? "neutral" : data.drifted.length > 0 ? "warning" : "success"
+					})
+				}),
+				/* @__PURE__ */ jsx("a", {
+					href: "#current",
+					class: statLink,
+					children: /* @__PURE__ */ jsx(Stat, {
+						label: "Up to date",
+						value: data.current,
+						tone: data.current > 0 ? "success" : "neutral"
+					})
+				})
+			]
+		}),
+		/* @__PURE__ */ jsx(UnlinkedSection, { data }),
+		/* @__PURE__ */ jsx(DriftSection, { data }),
+		/* @__PURE__ */ jsx(CurrentSection, { data })
+	] });
+}
+/** Where a component's design links are managed: its Design tab with testing, else the project's design settings. */
+function linkTarget(data, component) {
+	const urls = createUrlBuilder("/", getStore().config.publishedBaseDomain);
+	return data.storyLinksRead ? urls.component(data.project.slug, component.importPath, "design") : `${urls.settings(data.project.slug)}/design`;
+}
+function ComponentLink(props) {
+	const { data, component } = props;
+	const urls = createUrlBuilder("/", getStore().config.publishedBaseDomain);
+	const href = data.storyLinksRead ? urls.component(data.project.slug, component.importPath, "design") : urls.component(data.project.slug, component.importPath);
+	return /* @__PURE__ */ jsx("a", {
+		href,
+		children: component.title
+	});
+}
+function UnlinkedRow(props) {
+	const { data, component } = props;
+	return /* @__PURE__ */ jsxs("tr", { children: [
+		/* @__PURE__ */ jsxs("td", { children: [/* @__PURE__ */ jsx(ComponentLink, {
+			data,
+			component
+		}), /* @__PURE__ */ jsx("div", {
+			class: narrowOnly,
+			children: /* @__PURE__ */ jsx(Meta, {
+				as: "span",
+				mono: true,
+				children: component.importPath
+			})
+		})] }),
+		/* @__PURE__ */ jsx("td", {
+			class: widePath,
+			children: /* @__PURE__ */ jsx("span", {
+				class: "mono",
+				children: component.importPath
+			})
+		}),
+		/* @__PURE__ */ jsx("td", {
+			class: wideOnly,
+			children: component.stories
+		}),
+		/* @__PURE__ */ jsx("td", { children: /* @__PURE__ */ jsx(Button, {
+			variant: "ghost",
+			size: "sm",
+			href: linkTarget(data, component),
+			"aria-label": `Link a design to ${component.title}`,
+			children: "Link a design"
+		}) })
+	] });
+}
+function UnlinkedSection(props) {
+	const { data } = props;
+	const { unlinked } = data;
+	return /* @__PURE__ */ jsx(Card, {
+		id: "no-link",
+		children: /* @__PURE__ */ jsxs(VStack, { children: [/* @__PURE__ */ jsxs(SectionTitle, { children: [
+			"No design link (",
+			unlinked.length,
+			")"
+		] }), unlinked.length === 0 ? /* @__PURE__ */ jsx(EmptyState, { title: "Every component has a design link" }) : /* @__PURE__ */ jsx(Table, { children: /* @__PURE__ */ jsxs("table", { children: [/* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { children: [
+			/* @__PURE__ */ jsx("th", { children: "Component" }),
+			/* @__PURE__ */ jsx("th", {
+				class: wideOnly,
+				children: "Path"
+			}),
+			/* @__PURE__ */ jsx("th", {
+				class: wideOnly,
+				children: "Stories"
+			}),
+			/* @__PURE__ */ jsx("th", { children: /* @__PURE__ */ jsx("span", {
+				class: "visually-hidden",
+				children: "Action"
+			}) })
+		] }) }), /* @__PURE__ */ jsx("tbody", { children: unlinked.map((component) => /* @__PURE__ */ jsx(UnlinkedRow, {
+			data,
+			component
+		}, component.importPath)) })] }) })] })
+	});
+}
+const REASONS = {
+	stale: {
+		badge: "Design changed",
+		title: "Design changed after approval"
+	},
+	deleted: {
+		badge: "Deleted",
+		title: "Design file deleted"
+	}
+};
+function DriftBadge(props) {
+	const reason = props.drift === "deleted" ? REASONS.deleted : REASONS.stale;
+	return /* @__PURE__ */ jsx("span", {
+		title: reason.title,
+		children: /* @__PURE__ */ jsx(Badge, {
+			tone: props.drift === "deleted" ? "danger" : "warning",
+			icon: true,
+			children: reason.badge
+		})
+	});
+}
+function ChangedAt(props) {
+	return props.value ? /* @__PURE__ */ jsx(RelativeTime, { value: props.value }) : /* @__PURE__ */ jsx(Meta, {
+		as: "span",
+		children: "unknown"
+	});
+}
+/** One row per drifted design link of a component. */
+function DriftRows(props) {
+	const { data, component } = props;
+	return /* @__PURE__ */ jsx(Fragment, { children: component.links.filter((link) => link.drift === "stale" || link.drift === "deleted").map((link) => /* @__PURE__ */ jsxs("tr", { children: [
+		/* @__PURE__ */ jsx("td", { children: /* @__PURE__ */ jsxs(VStack, { children: [
+			/* @__PURE__ */ jsx(ComponentLink, {
+				data,
+				component
+			}),
+			/* @__PURE__ */ jsx(HStack, {
+				wrap: false,
+				children: /* @__PURE__ */ jsxs(Button, {
+					variant: "ghost",
+					size: "sm",
+					icon: "external-link",
+					href: link.url,
+					target: "_blank",
+					rel: "noopener noreferrer",
+					children: ["Open in ", link.providerName]
+				})
+			}),
+			link.name ? /* @__PURE__ */ jsx(Meta, {
+				as: "span",
+				children: link.name
+			}) : null
+		] }) }),
+		/* @__PURE__ */ jsxs("td", { children: [/* @__PURE__ */ jsx(DriftBadge, { drift: link.drift }), /* @__PURE__ */ jsx("div", {
+			class: narrowOnly,
+			children: /* @__PURE__ */ jsx(Meta, {
+				as: "span",
+				children: /* @__PURE__ */ jsx(ChangedAt, { value: link.changedAt })
+			})
+		})] }),
+		/* @__PURE__ */ jsx("td", {
+			class: wideOnly,
+			children: /* @__PURE__ */ jsx(ChangedAt, { value: link.changedAt })
+		})
+	] }, `${component.importPath}|${link.url}`)) });
+}
+/** Says which providers cannot be checked and where to add a token. */
+function DriftAlert(props) {
+	const { project, withoutToken } = props.data;
+	const urls = createUrlBuilder("/", getStore().config.publishedBaseDomain);
+	return /* @__PURE__ */ jsxs(Alert, {
+		tone: "info",
+		title: "Drift can't be checked",
+		children: [
+			withoutToken.join(", "),
+			" has no access token for this project, so StoryShelf cannot see which designs changed. Add one in Settings → Design.",
+			/* @__PURE__ */ jsx("div", {
+				class: "mt-1",
+				children: /* @__PURE__ */ jsx(Button, {
+					variant: "secondary",
+					size: "sm",
+					href: `${urls.settings(project.slug)}/design`,
+					children: "Open design settings"
+				})
+			})
+		]
+	});
+}
+function DriftTable(props) {
+	const { data } = props;
+	return /* @__PURE__ */ jsx(Table, { children: /* @__PURE__ */ jsxs("table", { children: [/* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { children: [
+		/* @__PURE__ */ jsx("th", { children: "Component" }),
+		/* @__PURE__ */ jsx("th", { children: "Reason" }),
+		/* @__PURE__ */ jsx("th", {
+			class: wideOnly,
+			children: "Design changed"
+		})
+	] }) }), /* @__PURE__ */ jsx("tbody", { children: data.drifted.map((component) => /* @__PURE__ */ jsx(DriftRows, {
+		data,
+		component
+	}, component.importPath)) })] }) });
+}
+function DriftSection(props) {
+	const { data } = props;
+	const { drifted, withoutToken, lastChecked } = data;
+	const unavailable = driftUnavailable(data);
+	return /* @__PURE__ */ jsx(Card, {
+		id: "drift",
+		children: /* @__PURE__ */ jsxs(VStack, { children: [
+			/* @__PURE__ */ jsx(SectionTitle, { children: unavailable ? "Needs attention" : `Needs attention (${drifted.length})` }),
+			unavailable ? null : /* @__PURE__ */ jsx(Meta, { children: lastChecked ? /* @__PURE__ */ jsxs(Fragment, { children: ["Last checked ", /* @__PURE__ */ jsx(RelativeTime, { value: lastChecked })] }) : "Not checked yet" }),
+			withoutToken.length > 0 ? /* @__PURE__ */ jsx(DriftAlert, { data }) : null,
+			drifted.length > 0 ? /* @__PURE__ */ jsx(DriftTable, { data }) : null,
+			drifted.length === 0 && !unavailable ? /* @__PURE__ */ jsx(EmptyState, { title: "No drift found" }) : null
+		] })
+	});
+}
+function CurrentSection(props) {
+	const { current, unknown } = props.data;
+	const unknownText = `${unknown} more ${unknown === 1 ? "has" : "have"} a link but nothing stored says whether the design changed.`;
+	return /* @__PURE__ */ jsx(Card, {
+		id: "current",
+		children: /* @__PURE__ */ jsxs(VStack, { children: [/* @__PURE__ */ jsx(SectionTitle, { children: "Up to date" }), /* @__PURE__ */ jsxs(Meta, { children: [current > 0 ? `${current} ${current === 1 ? "component is" : "components are"} linked and ${current === 1 ? "matches" : "match"} their approved design.` : unknown === 0 ? "No linked components yet." : "", unknown > 0 ? ` ${unknownText}` : ""] })] })
+	});
+}
+export { renderDesignCoveragePage };
+
+//# sourceMappingURL=design-coverage.mjs.map