@storyshelf/core 0.3.1 → 0.5.3

package/dist/adapter/metadata.d.mts

@@ -11,7 +11,7 @@ import { z } from "zod";
  * `category` tells a reader which slot the adapter fills without knowing
  * which adapter instance supplied the metadata.
  */
-type AdapterCategory = "database" | "storage" | "auth" | "capture-runner" | "capture-queue" | "git-host";
+type AdapterCategory = "database" | "storage" | "capture-runner" | "capture-queue" | "git-host" | "notifier";
 /** Common adapter identity — every adapter instance exposes this. */
 interface AdapterMetadata {
   /** Human label for UI/logs. */
@@ -31,39 +31,39 @@ interface GitAdapterMetadata extends AdapterMetadata {
   readonly logo?: string;
   readonly schema: z.ZodType;
 }
-/** Context passed to an adapter's `init` on server startup. */
-interface AdapterInitContext {
+/** Context passed to an adapter's `setup` on server startup. */
+interface AdapterSetupContext {
   /** Resolved shelf configuration (scratchDir, secret, …). Never log the secret. */
   readonly config: ShelfConfig;
-  /** Scoped logger for init-time diagnostics. */
+  /** Scoped logger for setup-time diagnostics. */
   readonly logger: Logger;
 }
 /** Result of an adapter's ongoing health probe. */
 interface AdapterHealth {
   /** Whether the adapter is currently usable. */
   readonly ok: boolean;
-  /** Probe latency in milliseconds, when measured. */
-  readonly latencyMs?: number;
   /** Short human-readable detail (must not contain secrets). */
   readonly detail?: string;
 }
 /**
- * Optional lifecycle every adapter can expose.
+ * Optional lifecycle every adapter can expose — all or nothing.
  *
- * Grouped in a sub-object (rather than flattened onto each adapter) so
- * future hooks (`drain?`, `reinit?`, …) land in one place. All hooks must
- * be idempotent — the router may run them more than once per process.
+ * An adapter either omits `lifecycle` entirely or implements all three
+ * hooks; partial implementations are not allowed. Grouped in a sub-object
+ * (rather than flattened onto each adapter) so future hooks land in one
+ * place. All hooks must be idempotent — the router may run them more than
+ * once per process.
  */
 interface AdapterLifecycle {
   /**
    * One-shot setup: migrations, directory creation, credential validation.
    * Throw when something required is missing.
    */
-  init?: (ctx: AdapterInitContext) => Promise<void>;
-  /** Teardown: close clients and handles. Must tolerate repeated calls. */
-  close?: () => Promise<void>;
+  setup: (ctx: AdapterSetupContext) => Promise<void>;
+  /** Teardown: destroy clients and handles. Must tolerate repeated calls. */
+  teardown: () => Promise<void>;
   /** Ongoing liveness probe (cheap: SELECT 1, access(), head-bucket). */
-  health?: () => Promise<AdapterHealth>;
+  health: () => Promise<AdapterHealth>;
 }
 /**
  * Shared adapter base.
@@ -77,7 +77,13 @@ interface Adapter<Extra extends object = Record<string, unknown>> {
   readonly metadata: AdapterMetadata & Extra;
   /** Optional lifecycle hooks. */
   readonly lifecycle?: AdapterLifecycle;
+  /**
+   * Bind the host-owned runtime logger. Called by the app/worker when
+   * present; factories must never create their own loggers — they only
+   * store what they are given (explicit `options.logger` wins over bound).
+   */
+  setLogger?(logger: Logger): void;
 }
 //#endregion
-export { Adapter, AdapterCategory, AdapterHealth, AdapterInitContext, AdapterLifecycle, AdapterMetadata, GitAdapterMetadata };
+export { Adapter, AdapterCategory, AdapterHealth, AdapterLifecycle, AdapterMetadata, AdapterSetupContext, GitAdapterMetadata };
 //# sourceMappingURL=metadata.d.mts.map

package/dist/adapter/notifier.d.mts

@@ -0,0 +1,7 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ChannelToggles, FormattedNotification, NotificationBrand, NotificationChannel, NotificationEvent, SystemEventName, SystemNotification } from "../adapters/notifier/types.mjs";
+import { NotifierAdapter, NotifierMetadata, NotifierProvider } from "../adapters/notifier/provider.mjs";
+import { emitNotifications, emitSystemNotification } from "../adapters/notifier/events.mjs";
+import { formatNotification, formatSystemNotification } from "../adapters/notifier/format.mjs";
+export { type ChannelToggles, type FormattedNotification, type NotificationBrand, type NotificationChannel, type NotificationEvent, type NotifierAdapter, type NotifierMetadata, type NotifierProvider, type SystemEventName, type SystemNotification, emitNotifications, emitSystemNotification, formatNotification, formatSystemNotification };

package/dist/adapter/notifier.mjs

@@ -0,0 +1,6 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { formatNotification, formatSystemNotification } from "../adapters/notifier/format.mjs";
+import { emitNotifications, emitSystemNotification } from "../adapters/notifier/events.mjs";
+export { emitNotifications, emitSystemNotification, formatNotification, formatSystemNotification };

package/dist/adapter/setup.d.mts

@@ -0,0 +1,61 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { CaptureRunner } from "./capture-runner.mjs";
+import { DatabaseAdapter } from "./database.mjs";
+import { EmailSender } from "./email-sender.mjs";
+import { GitHostProvider } from "./git-host.mjs";
+import { NotifierProvider } from "../adapters/notifier/provider.mjs";
+import { StorageAdapter } from "./storage.mjs";
+import { AdapterSetupContext } from "./metadata.mjs";
+import { CaptureQueue } from "./capture-queue.mjs";
+import { bindAdapterLoggers, collectSetups, collectTeardowns, runAdapterSetups, runAdapterTeardowns } from "../adapters/setup-runner.mjs";
+import { validateAdapter, validateAdapterSources, validateAuth, validateBootAssembly } from "../adapters/validate.mjs";
+//#region src/adapters/setup.d.ts
+/** Adapters that can take part in lifecycle runs. */
+interface AdapterSetupSources {
+  database: DatabaseAdapter;
+  storage: StorageAdapter;
+  captureRunner?: CaptureRunner;
+  captureQueue?: CaptureQueue;
+  gitHosts?: GitHostProvider[];
+  notifiers?: NotifierProvider[];
+  emailSender?: EmailSender;
+}
+/** One collected hook bound to its adapter identity. */
+interface HookEntry {
+  readonly category: string;
+  readonly kind: string;
+  readonly name: string;
+  readonly run: (ctx: AdapterSetupContext) => Promise<void>;
+}
+/** One failed hook, with its adapter identity attached. */
+interface AdapterSetupFailure {
+  readonly category: string;
+  readonly kind: string;
+  readonly name: string;
+  readonly error: string;
+}
+/** Settled outcome of a lifecycle run (never rejects — use `ok`). */
+interface AdapterSetupResult {
+  readonly ok: boolean;
+  readonly failures: AdapterSetupFailure[];
+}
+/** Lifecycle phase a run covers. */
+type LifecyclePhase = "setup" | "teardown";
+/**
+ * Thrown when an `app.lifecycle.setup()` or `teardown()` run finishes with failures.
+ *
+ * Inspect `phase` to know which hook failed and `failures` for per-adapter
+ * diagnostics. The router converts this into a 500 with structured details
+ * during health checks.
+ */
+declare class AdapterLifecycleError extends Error {
+  /** Which lifecycle phase failed (`setup` or `teardown`). */
+  readonly phase: LifecyclePhase;
+  /** One entry per adapter hook that failed. */
+  readonly failures: AdapterSetupFailure[];
+  constructor(phase: LifecyclePhase, failures: AdapterSetupFailure[]);
+}
+//#endregion
+export { AdapterLifecycleError, AdapterSetupFailure, AdapterSetupResult, AdapterSetupSources, HookEntry, LifecyclePhase, bindAdapterLoggers, collectSetups, collectTeardowns, runAdapterSetups, runAdapterTeardowns, validateAdapter, validateAdapterSources, validateAuth, validateBootAssembly };
+//# sourceMappingURL=setup.d.mts.map

package/dist/adapter/setup.mjs

@@ -0,0 +1,29 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { bindAdapterLoggers, collectSetups, collectTeardowns, runAdapterSetups, runAdapterTeardowns } from "../adapters/setup-runner.mjs";
+import { validateAdapter, validateAdapterSources, validateAuth, validateBootAssembly } from "../adapters/validate.mjs";
+//#region src/adapters/setup.ts
+/**
+* Thrown when an `app.lifecycle.setup()` or `teardown()` run finishes with failures.
+*
+* Inspect `phase` to know which hook failed and `failures` for per-adapter
+* diagnostics. The router converts this into a 500 with structured details
+* during health checks.
+*/
+var AdapterLifecycleError = class extends Error {
+	/** Which lifecycle phase failed (`setup` or `teardown`). */
+	phase;
+	/** One entry per adapter hook that failed. */
+	failures;
+	constructor(phase, failures) {
+		super(`Adapter ${phase} failed: ${failures.map((f) => `${f.category}/${f.kind}`).join(", ")}`);
+		this.name = "AdapterLifecycleError";
+		this.phase = phase;
+		this.failures = failures;
+	}
+};
+//#endregion
+export { AdapterLifecycleError, bindAdapterLoggers, collectSetups, collectTeardowns, runAdapterSetups, runAdapterTeardowns, validateAdapter, validateAdapterSources, validateAuth, validateBootAssembly };
+
+//# sourceMappingURL=setup.mjs.map

package/dist/adapter/setup.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.mjs","names":[],"sources":["../../src/adapters/setup.ts"],"sourcesContent":["/**\n * Adapter lifecycle contract: hooks every adapter can expose, plus the\n * settled-result and error types. The runner (`setup-runner.ts`) collects\n * and executes the hooks; `createShelfApp` kicks `setup` eagerly and\n * gates the first request on the shared result. All hooks must be\n * idempotent.\n */\nimport type { CaptureQueue } from \"./capture-queue.ts\";\nimport type { CaptureRunner } from \"./capture-runner.ts\";\nimport type { DatabaseAdapter } from \"./database.ts\";\nimport type { EmailSender } from \"./email-sender.ts\";\nimport type { GitHostProvider } from \"./git-host/index.ts\";\nimport type { AdapterSetupContext } from \"./metadata.ts\";\nimport type { NotifierProvider } from \"./notifier/provider.ts\";\nimport type { StorageAdapter } from \"./storage.ts\";\n\n/** Adapters that can take part in lifecycle runs. */\nexport interface AdapterSetupSources {\n  database: DatabaseAdapter;\n  storage: StorageAdapter;\n  captureRunner?: CaptureRunner;\n  captureQueue?: CaptureQueue;\n  gitHosts?: GitHostProvider[];\n  notifiers?: NotifierProvider[];\n  emailSender?: EmailSender;\n}\n\n/** One collected hook bound to its adapter identity. */\nexport interface HookEntry {\n  readonly category: string;\n  readonly kind: string;\n  readonly name: string;\n  readonly run: (ctx: AdapterSetupContext) => Promise<void>;\n}\n\n/** One failed hook, with its adapter identity attached. */\nexport interface AdapterSetupFailure {\n  readonly category: string;\n  readonly kind: string;\n  readonly name: string;\n  readonly error: string;\n}\n\n/** Settled outcome of a lifecycle run (never rejects — use `ok`). */\nexport interface AdapterSetupResult {\n  readonly ok: boolean;\n  readonly failures: AdapterSetupFailure[];\n}\n\n/** Lifecycle phase a run covers. */\nexport type LifecyclePhase = \"setup\" | \"teardown\";\n\n/**\n * Thrown when an `app.lifecycle.setup()` or `teardown()` run finishes with failures.\n *\n * Inspect `phase` to know which hook failed and `failures` for per-adapter\n * diagnostics. The router converts this into a 500 with structured details\n * during health checks.\n */\nexport class AdapterLifecycleError extends Error {\n  /** Which lifecycle phase failed (`setup` or `teardown`). */\n  readonly phase: LifecyclePhase;\n  /** One entry per adapter hook that failed. */\n  readonly failures: AdapterSetupFailure[];\n  constructor(phase: LifecyclePhase, failures: AdapterSetupFailure[]) {\n    super(`Adapter ${phase} failed: ${failures.map((f) => `${f.category}/${f.kind}`).join(\", \")}`);\n    this.name = \"AdapterLifecycleError\";\n    this.phase = phase;\n    this.failures = failures;\n  }\n}\n\n/** Collect every `setup` hook from the configured adapters. */\nexport {\n  bindAdapterLoggers,\n  collectSetups,\n  collectTeardowns,\n  runAdapterSetups,\n  runAdapterTeardowns,\n} from \"./setup-runner.ts\";\n\n/** Boot-time shape validation for third-party adapters. */\nexport {\n  validateAdapter,\n  validateAdapterSources,\n  validateAuth,\n  validateBootAssembly,\n} from \"./validate.ts\";\n"],"mappings":";;;;;;;;;;;;;AA2DA,IAAa,wBAAb,cAA2C,MAAM;;CAE/C;;CAEA;CACA,YAAY,OAAuB,UAAiC;EAClE,MAAM,WAAW,MAAM,WAAW,SAAS,KAAK,MAAM,GAAG,EAAE,SAAS,GAAG,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,GAAG;EAC7F,KAAK,OAAO;EACZ,KAAK,QAAQ;EACb,KAAK,WAAW;CAClB;AACF"}

package/dist/adapter/webhook-events.d.mts

@@ -0,0 +1,29 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DatabaseAdapter } from "./database.mjs";
+import { SecretInput } from "../utils/encrypt.mjs";
+import { WebhookTables } from "../models/webhook.mjs";
+import { Logger } from "pino";
+//#region src/adapters/webhook-events.d.ts
+/**
+ * Deliver an event to every subscribed webhook of a project.
+ *
+ * @param db - Database adapter for loading subscriptions.
+ * @param tables - Webhook table handles.
+ * @param projectId - Project whose webhooks receive the event.
+ * @param event - Event name (e.g. "baseline:created").
+ * @param data - Event payload.
+ * @param secret - Server secret for decrypting webhook secrets (in memory only).
+ * @param logger - Optional logger for per-delivery outcomes.
+ */
+declare function emitWebhookEvent(db: DatabaseAdapter, tables: WebhookTables, projectId: string, event: string, data: Record<string, unknown>, secret: SecretInput, logger?: Logger): Promise<void>;
+/** Outbound webhook payload delivered to subscribers. */
+interface WebhookEvent {
+  event: string;
+  projectId: string;
+  data: Record<string, unknown>;
+  timestamp: string;
+}
+//#endregion
+export { WebhookEvent, emitWebhookEvent };
+//# sourceMappingURL=webhook-events.d.mts.map

package/dist/adapter/webhook-events.mjs

@@ -0,0 +1,83 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { WebhookModel } from "../models/webhook.mjs";
+import { hmacSha256 } from "../utils/hash.mjs";
+//#region src/adapters/webhook-events.ts
+/** Per-delivery budget: single attempt, no retries (events already fan out). */
+const WEBHOOK_TIMEOUT_MS = 1e4;
+/**
+* Deliver an event to every subscribed webhook of a project.
+*
+* @param db - Database adapter for loading subscriptions.
+* @param tables - Webhook table handles.
+* @param projectId - Project whose webhooks receive the event.
+* @param event - Event name (e.g. "baseline:created").
+* @param data - Event payload.
+* @param secret - Server secret for decrypting webhook secrets (in memory only).
+* @param logger - Optional logger for per-delivery outcomes.
+*/
+async function emitWebhookEvent(db, tables, projectId, event, data, secret, logger) {
+	const webhookModel = new WebhookModel(db, tables, secret);
+	const webhooks = await webhookModel.list(projectId);
+	const eventPayload = {
+		event,
+		projectId,
+		data,
+		timestamp: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	await Promise.allSettled(webhooks.map(async (webhook) => {
+		const events = WebhookModel.eventsOf(webhook);
+		if (events.length > 0 && !events.includes(event)) return;
+		await deliverToWebhook(webhookModel, webhook, eventPayload, logger);
+	}));
+}
+/** Decrypt, send, and log one webhook delivery (failures stay non-fatal). */
+async function deliverToWebhook(webhookModel, webhook, eventPayload, logger) {
+	let plaintext;
+	try {
+		plaintext = webhookModel.decryptSecret(webhook);
+	} catch {
+		logger?.warn({ webhookId: webhook.id }, "skipping webhook with undecryptable secret");
+		return;
+	}
+	try {
+		await sendWebhook(webhook.url, plaintext, eventPayload);
+		logger?.info({
+			webhookId: webhook.id,
+			host: hostOf(webhook.url)
+		}, "webhook delivered");
+	} catch (error) {
+		logger?.warn({
+			webhookId: webhook.id,
+			host: hostOf(webhook.url),
+			err: error
+		}, "webhook delivery failed");
+	}
+}
+/** Hostname of a webhook URL for logs (never the full URL — may carry secrets). */
+function hostOf(url) {
+	try {
+		return new URL(url).host;
+	} catch {
+		return "[invalid-url]";
+	}
+}
+async function sendWebhook(url, secret, event) {
+	const body = JSON.stringify(event);
+	const signature = hmacSha256(secret, body);
+	await fetch(url, {
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			"X-StoryShelf-Event": event.event,
+			"X-StoryShelf-Signature": signature
+		},
+		body,
+		signal: AbortSignal.timeout(WEBHOOK_TIMEOUT_MS)
+	});
+}
+//#endregion
+export { emitWebhookEvent };
+
+//# sourceMappingURL=webhook-events.mjs.map

package/dist/adapter/webhook-events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-events.mjs","names":[],"sources":["../../src/adapters/webhook-events.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport { WebhookModel, type WebhookTables } from \"../models/webhook.ts\";\nimport type { Webhook } from \"../schema/webhook.ts\";\nimport type { SecretInput } from \"../utils/encrypt.ts\";\nimport { hmacSha256 } from \"../utils/hash.ts\";\nimport type { DatabaseAdapter } from \"./database.ts\";\n\n/** Per-delivery budget: single attempt, no retries (events already fan out). */\nconst WEBHOOK_TIMEOUT_MS = 10_000;\n\n/**\n * Deliver an event to every subscribed webhook of a project.\n *\n * @param db - Database adapter for loading subscriptions.\n * @param tables - Webhook table handles.\n * @param projectId - Project whose webhooks receive the event.\n * @param event - Event name (e.g. \"baseline:created\").\n * @param data - Event payload.\n * @param secret - Server secret for decrypting webhook secrets (in memory only).\n * @param logger - Optional logger for per-delivery outcomes.\n */\nexport async function emitWebhookEvent(\n  db: DatabaseAdapter,\n  tables: WebhookTables,\n  projectId: string,\n  event: string,\n  data: Record<string, unknown>,\n  secret: SecretInput,\n  logger?: Logger,\n): Promise<void> {\n  const webhookModel = new WebhookModel(db, tables, secret);\n  const webhooks = await webhookModel.list(projectId);\n  const eventPayload: WebhookEvent = {\n    event,\n    projectId,\n    data,\n    timestamp: new Date().toISOString(),\n  };\n\n  await Promise.allSettled(\n    webhooks.map(async (webhook) => {\n      const events = WebhookModel.eventsOf(webhook);\n      if (events.length > 0 && !events.includes(event)) {\n        return;\n      }\n      await deliverToWebhook(webhookModel, webhook, eventPayload, logger);\n    }),\n  );\n}\n\n/** Decrypt, send, and log one webhook delivery (failures stay non-fatal). */\nasync function deliverToWebhook(\n  webhookModel: WebhookModel,\n  webhook: Webhook,\n  eventPayload: WebhookEvent,\n  logger: Logger | undefined,\n): Promise<void> {\n  let plaintext: string;\n  try {\n    plaintext = webhookModel.decryptSecret(webhook);\n  } catch {\n    // Undecryptable secret (e.g. rotated server SECRET) — skip, don't leak\n    logger?.warn({ webhookId: webhook.id }, \"skipping webhook with undecryptable secret\");\n    return;\n  }\n  try {\n    await sendWebhook(webhook.url, plaintext, eventPayload);\n    logger?.info({ webhookId: webhook.id, host: hostOf(webhook.url) }, \"webhook delivered\");\n  } catch (error) {\n    // Webhook delivery failures are non-fatal\n    logger?.warn(\n      { webhookId: webhook.id, host: hostOf(webhook.url), err: error },\n      \"webhook delivery failed\",\n    );\n  }\n}\n\n/** Outbound webhook payload delivered to subscribers. */\nexport interface WebhookEvent {\n  event: string;\n  projectId: string;\n  data: Record<string, unknown>;\n  timestamp: string;\n}\n\n/** Hostname of a webhook URL for logs (never the full URL — may carry secrets). */\nfunction hostOf(url: string): string {\n  try {\n    return new URL(url).host;\n  } catch {\n    return \"[invalid-url]\";\n  }\n}\n\nasync function sendWebhook(url: string, secret: string, event: WebhookEvent): Promise<void> {\n  const body = JSON.stringify(event);\n  const signature = hmacSha256(secret, body);\n  await fetch(url, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      \"X-StoryShelf-Event\": event.event,\n      \"X-StoryShelf-Signature\": signature,\n    },\n    body,\n    signal: AbortSignal.timeout(WEBHOOK_TIMEOUT_MS),\n  });\n}\n"],"mappings":";;;;;;;AAQA,MAAM,qBAAqB;;;;;;;;;;;;AAa3B,eAAsB,iBACpB,IACA,QACA,WACA,OACA,MACA,QACA,QACe;CACf,MAAM,eAAe,IAAI,aAAa,IAAI,QAAQ,MAAM;CACxD,MAAM,WAAW,MAAM,aAAa,KAAK,SAAS;CAClD,MAAM,eAA6B;EACjC;EACA;EACA;EACA,4BAAW,IAAI,KAAK,EAAA,CAAE,YAAY;CACpC;CAEA,MAAM,QAAQ,WACZ,SAAS,IAAI,OAAO,YAAY;EAC9B,MAAM,SAAS,aAAa,SAAS,OAAO;EAC5C,IAAI,OAAO,SAAS,KAAK,CAAC,OAAO,SAAS,KAAK,GAC7C;EAEF,MAAM,iBAAiB,cAAc,SAAS,cAAc,MAAM;CACpE,CAAC,CACH;AACF;;AAGA,eAAe,iBACb,cACA,SACA,cACA,QACe;CACf,IAAI;CACJ,IAAI;EACF,YAAY,aAAa,cAAc,OAAO;CAChD,QAAQ;EAEN,QAAQ,KAAK,EAAE,WAAW,QAAQ,GAAG,GAAG,4CAA4C;EACpF;CACF;CACA,IAAI;EACF,MAAM,YAAY,QAAQ,KAAK,WAAW,YAAY;EACtD,QAAQ,KAAK;GAAE,WAAW,QAAQ;GAAI,MAAM,OAAO,QAAQ,GAAG;EAAE,GAAG,mBAAmB;CACxF,SAAS,OAAO;EAEd,QAAQ,KACN;GAAE,WAAW,QAAQ;GAAI,MAAM,OAAO,QAAQ,GAAG;GAAG,KAAK;EAAM,GAC/D,yBACF;CACF;AACF;;AAWA,SAAS,OAAO,KAAqB;CACnC,IAAI;EACF,OAAO,IAAI,IAAI,GAAG,CAAC,CAAC;CACtB,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAe,YAAY,KAAa,QAAgB,OAAoC;CAC1F,MAAM,OAAO,KAAK,UAAU,KAAK;CACjC,MAAM,YAAY,WAAW,QAAQ,IAAI;CACzC,MAAM,MAAM,KAAK;EACf,QAAQ;EACR,SAAS;GACP,gBAAgB;GAChB,sBAAsB,MAAM;GAC5B,0BAA0B;EAC5B;EACA;EACA,QAAQ,YAAY,QAAQ,kBAAkB;CAChD,CAAC;AACH"}

package/dist/adapters/notifier/events.d.mts

@@ -0,0 +1,26 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { NotificationBrand, NotificationChannel, NotificationEvent, SystemNotification } from "./types.mjs";
+import { NotifierProvider } from "./provider.mjs";
+import { Logger } from "../../logger.mjs";
+//#region src/adapters/notifier/events.d.ts
+/** Options for project-event fan-out (inline best-effort, non-fatal). */
+interface EmitNotificationsOptions {
+  notifiers?: NotifierProvider[];
+  channels?: NotificationChannel[];
+  brand?: NotificationBrand;
+  logger?: Logger;
+}
+/**
+ * Deliver a project event to every subscribed channel.
+ * Inline best-effort: `Promise.allSettled`, failures logged and swallowed.
+ */
+declare function emitNotifications(event: NotificationEvent, options?: EmitNotificationsOptions): Promise<void>;
+/**
+ * Deliver a site-wide admin alert to project-less channels
+ * (e.g. `sys:user-created`, `sys:capture-failed`, `sys:purge-completed`).
+ */
+declare function emitSystemNotification(event: SystemNotification, options?: EmitNotificationsOptions): Promise<void>;
+//#endregion
+export { EmitNotificationsOptions, emitNotifications, emitSystemNotification };
+//# sourceMappingURL=events.d.mts.map

package/dist/adapters/notifier/events.mjs

@@ -0,0 +1,66 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { formatNotification, formatSystemNotification } from "./format.mjs";
+//#region src/adapters/notifier/events.ts
+/** Check an event against a channel's allowlist (empty = all). */
+function subscribed(channel, event) {
+	if (!channel.enabled) return false;
+	return channel.events.length === 0 || channel.events.includes(event);
+}
+/** Resolve a provider for a channel kind, or undefined when unwired. */
+function providerFor(notifiers, kind) {
+	return notifiers?.find((candidate) => candidate.metadata.kind === kind);
+}
+/** Send one formatted event through a channel's provider (throws on failure). */
+async function deliver(notifiers, channel, formatted) {
+	const provider = providerFor(notifiers, channel.provider);
+	if (!provider) throw new Error(`notifier missing: ${channel.provider}`);
+	await provider.create({
+		config: channel.config,
+		secret: channel.secret
+	}).send({
+		channel,
+		formatted
+	});
+}
+/**
+* Deliver a project event to every subscribed channel.
+* Inline best-effort: `Promise.allSettled`, failures logged and swallowed.
+*/
+async function emitNotifications(event, options = {}) {
+	const targets = (options.channels ?? []).filter((channel) => subscribed(channel, event.event));
+	if (targets.length === 0) return;
+	await Promise.allSettled(targets.map(async (channel) => {
+		try {
+			await deliver(options.notifiers, channel, formatNotification(event, options.brand));
+		} catch (error) {
+			options.logger?.warn({
+				err: error,
+				channelId: channel.id
+			}, "notification failed");
+		}
+	}));
+}
+/**
+* Deliver a site-wide admin alert to project-less channels
+* (e.g. `sys:user-created`, `sys:capture-failed`, `sys:purge-completed`).
+*/
+async function emitSystemNotification(event, options = {}) {
+	const targets = (options.channels ?? []).filter((channel) => channel.projectId === null && subscribed(channel, event.event));
+	if (targets.length === 0) return;
+	await Promise.allSettled(targets.map(async (channel) => {
+		try {
+			await deliver(options.notifiers, channel, formatSystemNotification(event, options.brand));
+		} catch (error) {
+			options.logger?.warn({
+				err: error,
+				channelId: channel.id
+			}, "system notification failed");
+		}
+	}));
+}
+//#endregion
+export { emitNotifications, emitSystemNotification };
+
+//# sourceMappingURL=events.mjs.map

package/dist/adapters/notifier/events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.mjs","names":[],"sources":["../../../src/adapters/notifier/events.ts"],"sourcesContent":["import type { Logger } from \"../../logger.ts\";\nimport { formatNotification, formatSystemNotification } from \"./format.ts\";\nimport type { NotifierProvider } from \"./provider.ts\";\nimport type {\n  NotificationBrand,\n  NotificationChannel,\n  NotificationEvent,\n  SystemNotification,\n} from \"./types.ts\";\n\n/** Options for project-event fan-out (inline best-effort, non-fatal). */\nexport interface EmitNotificationsOptions {\n  notifiers?: NotifierProvider[];\n  channels?: NotificationChannel[];\n  brand?: NotificationBrand;\n  logger?: Logger;\n}\n\n/** Check an event against a channel's allowlist (empty = all). */\nfunction subscribed(channel: NotificationChannel, event: string): boolean {\n  if (!channel.enabled) {\n    return false;\n  }\n  return channel.events.length === 0 || channel.events.includes(event);\n}\n\n/** Resolve a provider for a channel kind, or undefined when unwired. */\nfunction providerFor(\n  notifiers: NotifierProvider[] | undefined,\n  kind: string,\n): NotifierProvider | undefined {\n  return notifiers?.find((candidate) => candidate.metadata.kind === kind);\n}\n\n/** Send one formatted event through a channel's provider (throws on failure). */\nasync function deliver(\n  notifiers: NotifierProvider[] | undefined,\n  channel: NotificationChannel,\n  formatted: ReturnType<typeof formatNotification>,\n): Promise<void> {\n  const provider = providerFor(notifiers, channel.provider);\n  if (!provider) {\n    throw new Error(`notifier missing: ${channel.provider}`);\n  }\n  const sender = provider.create({ config: channel.config, secret: channel.secret });\n  await sender.send({ channel, formatted });\n}\n\n/**\n * Deliver a project event to every subscribed channel.\n * Inline best-effort: `Promise.allSettled`, failures logged and swallowed.\n */\nexport async function emitNotifications(\n  event: NotificationEvent,\n  options: EmitNotificationsOptions = {},\n): Promise<void> {\n  const targets = (options.channels ?? []).filter((channel) => subscribed(channel, event.event));\n  if (targets.length === 0) {\n    return;\n  }\n  await Promise.allSettled(\n    targets.map(async (channel) => {\n      try {\n        await deliver(options.notifiers, channel, formatNotification(event, options.brand));\n      } catch (error) {\n        options.logger?.warn({ err: error, channelId: channel.id }, \"notification failed\");\n      }\n    }),\n  );\n}\n\n/**\n * Deliver a site-wide admin alert to project-less channels\n * (e.g. `sys:user-created`, `sys:capture-failed`, `sys:purge-completed`).\n */\nexport async function emitSystemNotification(\n  event: SystemNotification,\n  options: EmitNotificationsOptions = {},\n): Promise<void> {\n  const targets = (options.channels ?? []).filter(\n    (channel) => channel.projectId === null && subscribed(channel, event.event),\n  );\n  if (targets.length === 0) {\n    return;\n  }\n  await Promise.allSettled(\n    targets.map(async (channel) => {\n      try {\n        await deliver(options.notifiers, channel, formatSystemNotification(event, options.brand));\n      } catch (error) {\n        options.logger?.warn({ err: error, channelId: channel.id }, \"system notification failed\");\n      }\n    }),\n  );\n}\n"],"mappings":";;;;;;AAmBA,SAAS,WAAW,SAA8B,OAAwB;CACxE,IAAI,CAAC,QAAQ,SACX,OAAO;CAET,OAAO,QAAQ,OAAO,WAAW,KAAK,QAAQ,OAAO,SAAS,KAAK;AACrE;;AAGA,SAAS,YACP,WACA,MAC8B;CAC9B,OAAO,WAAW,MAAM,cAAc,UAAU,SAAS,SAAS,IAAI;AACxE;;AAGA,eAAe,QACb,WACA,SACA,WACe;CACf,MAAM,WAAW,YAAY,WAAW,QAAQ,QAAQ;CACxD,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,qBAAqB,QAAQ,UAAU;CAGzD,MADe,SAAS,OAAO;EAAE,QAAQ,QAAQ;EAAQ,QAAQ,QAAQ;CAAO,CACrE,CAAC,CAAC,KAAK;EAAE;EAAS;CAAU,CAAC;AAC1C;;;;;AAMA,eAAsB,kBACpB,OACA,UAAoC,CAAC,GACtB;CACf,MAAM,WAAW,QAAQ,YAAY,CAAC,EAAA,CAAG,QAAQ,YAAY,WAAW,SAAS,MAAM,KAAK,CAAC;CAC7F,IAAI,QAAQ,WAAW,GACrB;CAEF,MAAM,QAAQ,WACZ,QAAQ,IAAI,OAAO,YAAY;EAC7B,IAAI;GACF,MAAM,QAAQ,QAAQ,WAAW,SAAS,mBAAmB,OAAO,QAAQ,KAAK,CAAC;EACpF,SAAS,OAAO;GACd,QAAQ,QAAQ,KAAK;IAAE,KAAK;IAAO,WAAW,QAAQ;GAAG,GAAG,qBAAqB;EACnF;CACF,CAAC,CACH;AACF;;;;;AAMA,eAAsB,uBACpB,OACA,UAAoC,CAAC,GACtB;CACf,MAAM,WAAW,QAAQ,YAAY,CAAC,EAAA,CAAG,QACtC,YAAY,QAAQ,cAAc,QAAQ,WAAW,SAAS,MAAM,KAAK,CAC5E;CACA,IAAI,QAAQ,WAAW,GACrB;CAEF,MAAM,QAAQ,WACZ,QAAQ,IAAI,OAAO,YAAY;EAC7B,IAAI;GACF,MAAM,QAAQ,QAAQ,WAAW,SAAS,yBAAyB,OAAO,QAAQ,KAAK,CAAC;EAC1F,SAAS,OAAO;GACd,QAAQ,QAAQ,KAAK;IAAE,KAAK;IAAO,WAAW,QAAQ;GAAG,GAAG,4BAA4B;EAC1F;CACF,CAAC,CACH;AACF"}

package/dist/adapters/notifier/format.d.mts

@@ -0,0 +1,14 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ChannelToggles, FormattedNotification, NotificationBrand, NotificationEvent, SystemNotification } from "./types.mjs";
+//#region src/adapters/notifier/format.d.ts
+/**
+ * Format a project event into subject/text/markdown/html using brand +
+ * channel toggles. Pure (no I/O) so settings preview and senders share it.
+ */
+declare function formatNotification(event: NotificationEvent, brand?: NotificationBrand, toggles?: ChannelToggles): FormattedNotification;
+/** Format a site-wide admin alert (no project scope, always verbose). */
+declare function formatSystemNotification(event: SystemNotification, brand?: NotificationBrand): FormattedNotification;
+//#endregion
+export { formatNotification, formatSystemNotification };
+//# sourceMappingURL=format.d.mts.map

package/dist/adapters/notifier/format.mjs

@@ -0,0 +1,96 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/adapters/notifier/format.ts
+/** Escape HTML special chars in free-form values (commit messages, names). */
+function esc(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+/** Read a string field from event data without throwing on shapes. */
+function str(data, key) {
+	const value = data[key];
+	return typeof value === "string" ? value : "";
+}
+/** Resolve toggle defaults (Brand + toggles v1: no custom templates). */
+function togglesOf(toggles) {
+	return {
+		style: toggles?.style ?? "compact",
+		subjectPrefix: toggles?.subjectPrefix ?? "[Shelf]",
+		includeAuthor: toggles?.includeAuthor ?? true,
+		includeMessage: toggles?.includeMessage ?? true,
+		includeCounts: toggles?.includeCounts ?? true
+	};
+}
+/** One-line summary for an event (used in subject + compact bodies). */
+function headline(event) {
+	const branch = str(event.data, "gitBranch") || str(event.data, "branch");
+	const status = str(event.data, "status");
+	const story = str(event.data, "storyId");
+	if (story) return `${event.event} ${story}${branch ? ` on ${branch}` : ""}`;
+	return `${event.event}${branch ? ` on ${branch}` : ""}${status ? ` (${status})` : ""}`;
+}
+/** Append author/message/counts lines for verbose bodies. */
+function appendDetails(lines, event, resolved) {
+	if (resolved.style !== "verbose") return;
+	const author = str(event.data, "authorName") || str(event.data, "authorEmail");
+	if (resolved.includeAuthor && author) lines.push(`by ${author}`);
+	const message = str(event.data, "message");
+	if (resolved.includeMessage && message) lines.push(message);
+	appendCounts(lines, event, resolved);
+}
+/** Append numeric count summary (snapshot/changed/approved/rejected). */
+function appendCounts(lines, event, resolved) {
+	if (!resolved.includeCounts) return;
+	const counts = [
+		"snapshotCount",
+		"changedCount",
+		"approvedCount",
+		"rejectedCount"
+	].map((key) => {
+		const value = event.data[key];
+		return typeof value === "number" ? `${key}=${value}` : "";
+	}).filter((part) => part !== "").join(" ");
+	if (counts) lines.push(counts);
+}
+/** Render text/html envelopes around body lines plus brand footer. */
+function envelope(subject, lines, brand) {
+	const name = brand?.name ?? "StoryShelf";
+	const text = lines.join("\n");
+	const footer = brand?.footerText ?? `Sent by ${name}`;
+	const htmlBody = lines.map((line) => esc(line)).join("<br/>");
+	const logo = brand?.logo ? `<img src="${esc(brand.logo)}" alt="" width="24"/>` : "";
+	return {
+		subject,
+		text: `${text}\n\n${footer}`,
+		markdown: `${text}\n\n_${esc(footer)}_`,
+		html: `${logo}<p>${htmlBody}</p><p><small>${esc(footer)}</small></p>`
+	};
+}
+/**
+* Format a project event into subject/text/markdown/html using brand +
+* channel toggles. Pure (no I/O) so settings preview and senders share it.
+*/
+function formatNotification(event, brand, toggles) {
+	const resolved = togglesOf(toggles);
+	const name = brand?.name ?? "StoryShelf";
+	const subject = `${resolved.subjectPrefix} ${headline(event)}`.trim();
+	const lines = [`${name}: ${headline(event)}`];
+	appendDetails(lines, event, resolved);
+	if (brand?.reviewUrl) lines.push(brand.reviewUrl);
+	return envelope(subject, lines, brand);
+}
+/** Format a site-wide admin alert (no project scope, always verbose). */
+function formatSystemNotification(event, brand) {
+	return formatNotification({
+		event: event.event,
+		data: event.data,
+		timestamp: event.timestamp
+	}, brand, {
+		style: "verbose",
+		subjectPrefix: "[Shelf sys]"
+	});
+}
+//#endregion
+export { formatNotification, formatSystemNotification };
+
+//# sourceMappingURL=format.mjs.map

package/dist/adapters/notifier/format.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.mjs","names":[],"sources":["../../../src/adapters/notifier/format.ts"],"sourcesContent":["import type {\n  ChannelToggles,\n  FormattedNotification,\n  NotificationBrand,\n  NotificationEvent,\n  SystemNotification,\n} from \"./types.ts\";\n\n/** Escape HTML special chars in free-form values (commit messages, names). */\nfunction esc(value: string): string {\n  return value.replaceAll(\"&\", \"&amp;\").replaceAll(\"<\", \"&lt;\").replaceAll(\">\", \"&gt;\");\n}\n\n/** Read a string field from event data without throwing on shapes. */\nfunction str(data: Record<string, unknown>, key: string): string {\n  const value = data[key];\n  return typeof value === \"string\" ? value : \"\";\n}\n\n/** Resolve toggle defaults (Brand + toggles v1: no custom templates). */\nfunction togglesOf(toggles?: ChannelToggles): Required<ChannelToggles> {\n  return {\n    style: toggles?.style ?? \"compact\",\n    subjectPrefix: toggles?.subjectPrefix ?? \"[Shelf]\",\n    includeAuthor: toggles?.includeAuthor ?? true,\n    includeMessage: toggles?.includeMessage ?? true,\n    includeCounts: toggles?.includeCounts ?? true,\n  };\n}\n\n/** One-line summary for an event (used in subject + compact bodies). */\nfunction headline(event: NotificationEvent): string {\n  const branch = str(event.data, \"gitBranch\") || str(event.data, \"branch\");\n  const status = str(event.data, \"status\");\n  const story = str(event.data, \"storyId\");\n  if (story) {\n    return `${event.event} ${story}${branch ? ` on ${branch}` : \"\"}`;\n  }\n  return `${event.event}${branch ? ` on ${branch}` : \"\"}${status ? ` (${status})` : \"\"}`;\n}\n\n/** Append author/message/counts lines for verbose bodies. */\nfunction appendDetails(\n  lines: string[],\n  event: NotificationEvent,\n  resolved: Required<ChannelToggles>,\n): void {\n  if (resolved.style !== \"verbose\") {\n    return;\n  }\n  const author = str(event.data, \"authorName\") || str(event.data, \"authorEmail\");\n  if (resolved.includeAuthor && author) {\n    lines.push(`by ${author}`);\n  }\n  const message = str(event.data, \"message\");\n  if (resolved.includeMessage && message) {\n    lines.push(message);\n  }\n  appendCounts(lines, event, resolved);\n}\n\n/** Append numeric count summary (snapshot/changed/approved/rejected). */\nfunction appendCounts(\n  lines: string[],\n  event: NotificationEvent,\n  resolved: Required<ChannelToggles>,\n): void {\n  if (!resolved.includeCounts) {\n    return;\n  }\n  const counts = [\"snapshotCount\", \"changedCount\", \"approvedCount\", \"rejectedCount\"]\n    .map((key) => {\n      const value = event.data[key];\n      return typeof value === \"number\" ? `${key}=${value}` : \"\";\n    })\n    .filter((part) => part !== \"\")\n    .join(\" \");\n  if (counts) {\n    lines.push(counts);\n  }\n}\n\n/** Render text/html envelopes around body lines plus brand footer. */\nfunction envelope(\n  subject: string,\n  lines: string[],\n  brand?: NotificationBrand,\n): FormattedNotification {\n  const name = brand?.name ?? \"StoryShelf\";\n  const text = lines.join(\"\\n\");\n  const footer = brand?.footerText ?? `Sent by ${name}`;\n  const htmlBody = lines.map((line) => esc(line)).join(\"<br/>\");\n  const logo = brand?.logo ? `<img src=\"${esc(brand.logo)}\" alt=\"\" width=\"24\"/>` : \"\";\n  return {\n    subject,\n    text: `${text}\\n\\n${footer}`,\n    markdown: `${text}\\n\\n_${esc(footer)}_`,\n    html: `${logo}<p>${htmlBody}</p><p><small>${esc(footer)}</small></p>`,\n  };\n}\n\n/**\n * Format a project event into subject/text/markdown/html using brand +\n * channel toggles. Pure (no I/O) so settings preview and senders share it.\n */\nexport function formatNotification(\n  event: NotificationEvent,\n  brand?: NotificationBrand,\n  toggles?: ChannelToggles,\n): FormattedNotification {\n  const resolved = togglesOf(toggles);\n  const name = brand?.name ?? \"StoryShelf\";\n  const subject = `${resolved.subjectPrefix} ${headline(event)}`.trim();\n  const lines = [`${name}: ${headline(event)}`];\n  appendDetails(lines, event, resolved);\n  if (brand?.reviewUrl) {\n    lines.push(brand.reviewUrl);\n  }\n  return envelope(subject, lines, brand);\n}\n\n/** Format a site-wide admin alert (no project scope, always verbose). */\nexport function formatSystemNotification(\n  event: SystemNotification,\n  brand?: NotificationBrand,\n): FormattedNotification {\n  return formatNotification(\n    { event: event.event, data: event.data, timestamp: event.timestamp },\n    brand,\n    { style: \"verbose\", subjectPrefix: \"[Shelf sys]\" },\n  );\n}\n"],"mappings":"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"}

package/dist/adapters/notifier/provider.d.mts

@@ -0,0 +1,32 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { FormattedNotification, NotificationChannel } from "./types.mjs";
+import { Adapter, AdapterMetadata } from "../../adapter/metadata.mjs";
+import { z } from "zod";
+import { Logger } from "pino";
+//#region src/adapters/notifier/provider.d.ts
+/** Notifier-specific metadata (adds logo + config validation schema). */
+interface NotifierMetadata extends AdapterMetadata {
+  readonly category: "notifier";
+  readonly logo?: string;
+  readonly schema: z.ZodType;
+}
+/** Descriptor — registered at startup, validates per-channel config. */
+interface NotifierProvider extends Adapter<NotifierMetadata> {
+  create(opts: {
+    config: unknown;
+    secret?: string;
+    logger?: Logger;
+  }): NotifierAdapter;
+}
+/** Runtime — bound to one channel config + decrypted secret, sends one message. */
+interface NotifierAdapter extends Adapter<NotifierMetadata> {
+  send(input: {
+    channel: NotificationChannel;
+    formatted: FormattedNotification;
+    logger?: Logger;
+  }): Promise<void>;
+}
+//#endregion
+export { NotifierAdapter, NotifierMetadata, NotifierProvider };
+//# sourceMappingURL=provider.d.mts.map

package/dist/adapters/notifier/types.d.mts

@@ -0,0 +1,56 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/adapters/notifier/types.d.ts
+/** Shared event envelope for human-facing notifications. */
+interface NotificationEvent {
+  event: string;
+  projectId?: string;
+  projectSlug?: string;
+  data: Record<string, unknown>;
+  timestamp: string;
+}
+/** Per-channel display toggles (Brand + toggles v1, no custom templates). */
+interface ChannelToggles {
+  style?: "compact" | "verbose";
+  subjectPrefix?: string;
+  includeAuthor?: boolean;
+  includeMessage?: boolean;
+  includeCounts?: boolean;
+}
+/** Brand inputs reused from UIConfig plus the review URL. */
+interface NotificationBrand {
+  name?: string;
+  logo?: string;
+  reviewUrl?: string;
+  fromEmail?: string;
+  fromName?: string;
+  footerText?: string;
+}
+/** Formatted output a provider transports (email body, chat markdown). */
+interface FormattedNotification {
+  subject: string;
+  text: string;
+  markdown: string;
+  html: string;
+}
+/** A configured project-level channel row (storage-agnostic view). */
+interface NotificationChannel {
+  id: string;
+  projectId: string | null;
+  provider: string;
+  config: Record<string, unknown>;
+  secret?: string;
+  events: string[];
+  enabled: boolean;
+}
+/** App-level (site-wide) admin alert — no project scope. */
+interface SystemNotification {
+  event: SystemEventName;
+  data: Record<string, unknown>;
+  timestamp: string;
+}
+/** Site-wide events for admins (new users, failures, purge). */
+type SystemEventName = "sys:user-created" | "sys:invite-issued" | "sys:auth-failed" | "sys:capture-failed" | "sys:purge-completed";
+//#endregion
+export { ChannelToggles, FormattedNotification, NotificationBrand, NotificationChannel, NotificationEvent, SystemEventName, SystemNotification };
+//# sourceMappingURL=types.d.mts.map