@storyshelf/core 0.6.2 → 0.8.0

package/dist/adapters/render-runs.mjs

@@ -0,0 +1,40 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/adapters/render-runs.ts
+/** In-flight render calls of a capture runner, so `cancel` reaches exactly the runs it names. */
+/**
+* Every render call a runner has in flight, by build and run id.
+*
+* Several renders of one build can run at once in one process (the shards of a sharded build), and
+* even two with the same run id (a redelivered shard). Each call registers its own entry and
+* removes only that entry when it ends, so no render ever drops another's handle.
+*/
+var RenderRuns = class {
+	#byBuild = /* @__PURE__ */ new Map();
+	/**
+	* Register a render call. Returns the function that removes it again (call it in `finally`).
+	*
+	* @param runId - The request's run id; a render without one is keyed by its build id.
+	*/
+	add(buildId, runId, run) {
+		const entry = {
+			runId: runId ?? buildId,
+			run
+		};
+		const runs = this.#byBuild.get(buildId) ?? /* @__PURE__ */ new Set();
+		runs.add(entry);
+		this.#byBuild.set(buildId, runs);
+		return () => {
+			runs.delete(entry);
+			if (runs.size === 0 && this.#byBuild.get(buildId) === runs) this.#byBuild.delete(buildId);
+		};
+	}
+	/** The runs `cancel(buildId, runId)` should stop: every run of the build without a run id. */
+	matching(buildId, runId) {
+		return [...this.#byBuild.get(buildId) ?? []].filter((entry) => runId === void 0 || entry.runId === runId).map((e) => e.run);
+	}
+};
+export { RenderRuns };
+
+//# sourceMappingURL=render-runs.mjs.map

package/dist/adapters/render-runs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-runs.mjs","names":[],"sources":["../../src/adapters/render-runs.ts"],"sourcesContent":["/** In-flight render calls of a capture runner, so `cancel` reaches exactly the runs it names. */\n\n/**\n * Every render call a runner has in flight, by build and run id.\n *\n * Several renders of one build can run at once in one process (the shards of a sharded build), and\n * even two with the same run id (a redelivered shard). Each call registers its own entry and\n * removes only that entry when it ends, so no render ever drops another's handle.\n */\nexport class RenderRuns<T> {\n  readonly #byBuild = new Map<string, Set<{ runId: string; run: T }>>();\n\n  /**\n   * Register a render call. Returns the function that removes it again (call it in `finally`).\n   *\n   * @param runId - The request's run id; a render without one is keyed by its build id.\n   */\n  add(buildId: string, runId: string | undefined, run: T): () => void {\n    const entry = { runId: runId ?? buildId, run };\n    const runs = this.#byBuild.get(buildId) ?? new Set();\n    runs.add(entry);\n    this.#byBuild.set(buildId, runs);\n    return () => {\n      runs.delete(entry);\n      if (runs.size === 0 && this.#byBuild.get(buildId) === runs) {\n        this.#byBuild.delete(buildId);\n      }\n    };\n  }\n\n  /** The runs `cancel(buildId, runId)` should stop: every run of the build without a run id. */\n  matching(buildId: string, runId?: string): T[] {\n    const runs = [...(this.#byBuild.get(buildId) ?? [])];\n    return runs.filter((entry) => runId === undefined || entry.runId === runId).map((e) => e.run);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AASA,IAAa,aAAb,MAA2B;CACzB,2BAAoB,IAAI,IAA4C;;;;;;CAOpE,IAAI,SAAiB,OAA2B,KAAoB;EAClE,MAAM,QAAQ;GAAE,OAAO,SAAS;GAAS;EAAI;EAC7C,MAAM,OAAO,KAAK,SAAS,IAAI,OAAO,qBAAK,IAAI,IAAI;EACnD,KAAK,IAAI,KAAK;EACd,KAAK,SAAS,IAAI,SAAS,IAAI;EAC/B,aAAa;GACX,KAAK,OAAO,KAAK;GACjB,IAAI,KAAK,SAAS,KAAK,KAAK,SAAS,IAAI,OAAO,MAAM,MACpD,KAAK,SAAS,OAAO,OAAO;EAEhC;CACF;;CAGA,SAAS,SAAiB,OAAqB;EAE7C,OAAO,CADO,GAAI,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,CACvC,CAAC,CAAC,QAAQ,UAAU,UAAU,KAAA,KAAa,MAAM,UAAU,KAAK,CAAC,CAAC,KAAK,MAAM,EAAE,GAAG;CAC9F;AACF"}

package/dist/adapters/setup-runner.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { AdapterSetupContext } from "../adapter/metadata.mjs";
 import { AdapterSetupResult, AdapterSetupSources, HookEntry } from "../adapter/setup.mjs";
 import { Logger } from "pino";
-//#region src/adapters/setup-runner.d.ts
 /** Collect every available `setup` hook in deterministic order. */
 declare function collectSetups(sources: AdapterSetupSources): HookEntry[];
 /** Collect every available `teardown` hook in deterministic order. */
@@ -18,6 +17,5 @@ declare function bindAdapterLoggers(sources: AdapterSetupSources, logger: Logger
 declare function runAdapterSetups(entries: HookEntry[], ctx: AdapterSetupContext, logger: Logger): Promise<AdapterSetupResult>;
 /** Run teardown hooks concurrently; failures are collected, never thrown. */
 declare function runAdapterTeardowns(entries: HookEntry[], ctx: AdapterSetupContext, logger: Logger): Promise<AdapterSetupResult>;
-//#endregion
 export { bindAdapterLoggers, collectSetups, collectTeardowns, runAdapterSetups, runAdapterTeardowns };
 //# sourceMappingURL=setup-runner.d.mts.map

package/dist/adapters/setup-runner.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { sanitizeErrorText } from "../utils/redact.mjs";
-//#region src/adapters/setup-runner.ts
+// src/adapters/setup-runner.ts
 function hookEntry(adapter, hook) {
 	const lifecycle = adapter.lifecycle;
 	if (!lifecycle) return null;
@@ -26,8 +26,7 @@ function pushAll(entries, sources, hook) {
 	pushHook(entries, sources.database, hook);
 	pushHook(entries, sources.storage, hook);
 	pushHook(entries, sources.captureRunner, hook);
-	pushHook(entries, sources.captureQueue, hook);
-	for (const provider of sources.gitHosts ?? []) pushHook(entries, provider, hook);
+	for (const provider of sources.design ?? []) pushHook(entries, provider, hook);
 	for (const notifier of sources.notifiers ?? []) pushHook(entries, notifier, hook);
 	pushHook(entries, sources.emailSender, hook);
 }
@@ -53,8 +52,7 @@ function bindAdapterLoggers(sources, logger) {
 		sources.database,
 		sources.storage,
 		sources.captureRunner,
-		sources.captureQueue,
-		...sources.gitHosts ?? [],
+		...sources.design ?? [],
 		...sources.notifiers ?? [],
 		sources.emailSender
 	];
@@ -143,7 +141,6 @@ async function runAdapterSetups(entries, ctx, logger) {
 async function runAdapterTeardowns(entries, ctx, logger) {
 	return await runHooks(entries, ctx, logger, "teardown", SLOW_TEARDOWN_MS);
 }
-//#endregion
 export { bindAdapterLoggers, collectSetups, collectTeardowns, runAdapterSetups, runAdapterTeardowns };
 
 //# sourceMappingURL=setup-runner.mjs.map

package/dist/adapters/setup-runner.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"setup-runner.mjs","names":[],"sources":["../../src/adapters/setup-runner.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport { sanitizeErrorText } from \"../utils/redact.ts\";\nimport type { AdapterLifecycle, AdapterMetadata, AdapterSetupContext } from \"./metadata.ts\";\nimport type {\n  AdapterSetupFailure,\n  AdapterSetupResult,\n  AdapterSetupSources,\n  HookEntry,\n} from \"./setup.ts\";\n\ninterface LifecycleCarrier {\n  readonly metadata: AdapterMetadata;\n  readonly lifecycle?: AdapterLifecycle;\n}\n\nfunction hookEntry(adapter: LifecycleCarrier, hook: \"setup\" | \"teardown\"): HookEntry | null {\n  const lifecycle = adapter.lifecycle;\n  if (!lifecycle) {\n    return null;\n  }\n  const fn = lifecycle[hook];\n  const { category, kind, name } = adapter.metadata;\n  return {\n    category,\n    kind,\n    name,\n    run: async (ctx) => {\n      await fn(ctx);\n    },\n  };\n}\n\nfunction pushHook(\n  entries: HookEntry[],\n  adapter: LifecycleCarrier | undefined,\n  hook: \"setup\" | \"teardown\",\n): void {\n  if (!adapter) {\n    return;\n  }\n  const entry = hookEntry(adapter, hook);\n  if (entry) {\n    entries.push(entry);\n  }\n}\n\nfunction pushAll(\n  entries: HookEntry[],\n  sources: AdapterSetupSources,\n  hook: \"setup\" | \"teardown\",\n): void {\n  pushHook(entries, sources.database, hook);\n  pushHook(entries, sources.storage, hook);\n  pushHook(entries, sources.captureRunner, hook);\n  pushHook(entries, sources.captureQueue, hook);\n  for (const provider of sources.gitHosts ?? []) {\n    pushHook(entries, provider, hook);\n  }\n  for (const notifier of sources.notifiers ?? []) {\n    pushHook(entries, notifier, hook);\n  }\n  pushHook(entries, sources.emailSender, hook);\n}\n\n/** Collect every available `setup` hook in deterministic order. */\nexport function collectSetups(sources: AdapterSetupSources): HookEntry[] {\n  const entries: HookEntry[] = [];\n  pushAll(entries, sources, \"setup\");\n  return entries;\n}\n\n/** Collect every available `teardown` hook in deterministic order. */\nexport function collectTeardowns(sources: AdapterSetupSources): HookEntry[] {\n  const entries: HookEntry[] = [];\n  pushAll(entries, sources, \"teardown\");\n  return entries;\n}\n\ninterface LoggerCarrier {\n  readonly metadata: AdapterMetadata;\n  readonly setLogger?: (logger: Logger) => void;\n}\n\n/**\n * Bind the host logger on every adapter that accepts one, scoped by kind.\n * Adapters without `setLogger` keep today's behavior (silent when no\n * explicit `options.logger` was passed at construction).\n */\nexport function bindAdapterLoggers(sources: AdapterSetupSources, logger: Logger): void {\n  const adapters: ReadonlyArray<LoggerCarrier | undefined> = [\n    sources.database,\n    sources.storage,\n    sources.captureRunner,\n    sources.captureQueue,\n    ...(sources.gitHosts ?? []),\n    ...(sources.notifiers ?? []),\n    sources.emailSender,\n  ];\n  for (const adapter of adapters) {\n    adapter?.setLogger?.(logger.child({ component: adapter.metadata.kind }));\n  }\n}\n\nfunction messageOf(reason: unknown): string {\n  const text = reason instanceof Error ? reason.message : String(reason);\n  return sanitizeErrorText(text, 500);\n}\n\n/** Budgets that trigger slow-hook warnings (observe only, never abort). */\nconst SLOW_SETUP_MS = 10_000;\nconst SLOW_TEARDOWN_MS = 5_000;\n\n/** Run one hook with start/done logging and a slow-hook warning. */\nasync function runHook(\n  entry: HookEntry,\n  ctx: AdapterSetupContext,\n  logger: Logger,\n  slowMs: number,\n): Promise<void> {\n  const { category, kind, name } = entry;\n  const started = Date.now();\n  logger.info({ category, kind, name }, \"adapter hook start\");\n  try {\n    await entry.run(ctx);\n  } finally {\n    const durationMs = Date.now() - started;\n    logger.info({ category, kind, name, durationMs }, \"adapter hook done\");\n    if (durationMs > slowMs) {\n      logger.warn({ category, kind, name, durationMs, slowMs }, \"slow adapter hook\");\n    }\n  }\n}\n\nfunction toFailure(entry: HookEntry, reason: unknown): AdapterSetupFailure {\n  return { category: entry.category, kind: entry.kind, name: entry.name, error: messageOf(reason) };\n}\n\nfunction toResult(\n  entries: HookEntry[],\n  outcomes: PromiseSettledResult<void>[],\n  logger: Logger,\n  verb: string,\n): AdapterSetupResult {\n  const failures: AdapterSetupFailure[] = [];\n  for (const [index, entry] of entries.entries()) {\n    const outcome: PromiseSettledResult<void> | undefined = outcomes[index];\n    if (outcome?.status === \"rejected\") {\n      failures.push(toFailure(entry, outcome.reason));\n    }\n  }\n  if (failures.length > 0) {\n    logger.error({ failures }, `adapter ${verb} failed`);\n  } else {\n    logger.info({ count: entries.length }, `adapters ${verb}d`);\n  }\n  return { ok: failures.length === 0, failures };\n}\n\n/** One run of collected hooks with start/done logging and hung visibility. */\nasync function runHooks(\n  entries: HookEntry[],\n  ctx: AdapterSetupContext,\n  logger: Logger,\n  verb: string,\n  slowMs: number,\n): Promise<AdapterSetupResult> {\n  let settled = false;\n  const timer = setTimeout(() => {\n    if (!settled) {\n      logger.warn({ count: entries.length, slowMs }, `adapters ${verb} still running`);\n    }\n  }, slowMs);\n  timer.unref?.();\n  try {\n    const outcomes = await Promise.allSettled(\n      entries.map(async (entry) => {\n        await runHook(entry, ctx, logger, slowMs);\n      }),\n    );\n    return toResult(entries, outcomes, logger, verb);\n  } finally {\n    settled = true;\n    clearTimeout(timer);\n  }\n}\n\n/** Run setup hooks concurrently; failures are collected, never thrown. */\nexport async function runAdapterSetups(\n  entries: HookEntry[],\n  ctx: AdapterSetupContext,\n  logger: Logger,\n): Promise<AdapterSetupResult> {\n  return await runHooks(entries, ctx, logger, \"setup\", SLOW_SETUP_MS);\n}\n\n/** Run teardown hooks concurrently; failures are collected, never thrown. */\nexport async function runAdapterTeardowns(\n  entries: HookEntry[],\n  ctx: AdapterSetupContext,\n  logger: Logger,\n): Promise<AdapterSetupResult> {\n  return await runHooks(entries, ctx, logger, \"teardown\", SLOW_TEARDOWN_MS);\n}\n"],"mappings":"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"}
+{"version":3,"file":"setup-runner.mjs","names":[],"sources":["../../src/adapters/setup-runner.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport { sanitizeErrorText } from \"../utils/redact.ts\";\nimport type { AdapterLifecycle, AdapterMetadata, AdapterSetupContext } from \"./metadata.ts\";\nimport type {\n  AdapterSetupFailure,\n  AdapterSetupResult,\n  AdapterSetupSources,\n  HookEntry,\n} from \"./setup.ts\";\n\ninterface LifecycleCarrier {\n  readonly metadata: AdapterMetadata;\n  readonly lifecycle?: AdapterLifecycle;\n}\n\nfunction hookEntry(adapter: LifecycleCarrier, hook: \"setup\" | \"teardown\"): HookEntry | null {\n  const lifecycle = adapter.lifecycle;\n  if (!lifecycle) {\n    return null;\n  }\n  const fn = lifecycle[hook];\n  const { category, kind, name } = adapter.metadata;\n  return {\n    category,\n    kind,\n    name,\n    run: async (ctx) => {\n      await fn(ctx);\n    },\n  };\n}\n\nfunction pushHook(\n  entries: HookEntry[],\n  adapter: LifecycleCarrier | undefined,\n  hook: \"setup\" | \"teardown\",\n): void {\n  if (!adapter) {\n    return;\n  }\n  const entry = hookEntry(adapter, hook);\n  if (entry) {\n    entries.push(entry);\n  }\n}\n\nfunction pushAll(\n  entries: HookEntry[],\n  sources: AdapterSetupSources,\n  hook: \"setup\" | \"teardown\",\n): void {\n  pushHook(entries, sources.database, hook);\n  pushHook(entries, sources.storage, hook);\n  pushHook(entries, sources.captureRunner, hook);\n  for (const provider of sources.design ?? []) {\n    pushHook(entries, provider, hook);\n  }\n  for (const notifier of sources.notifiers ?? []) {\n    pushHook(entries, notifier, hook);\n  }\n  pushHook(entries, sources.emailSender, hook);\n}\n\n/** Collect every available `setup` hook in deterministic order. */\nexport function collectSetups(sources: AdapterSetupSources): HookEntry[] {\n  const entries: HookEntry[] = [];\n  pushAll(entries, sources, \"setup\");\n  return entries;\n}\n\n/** Collect every available `teardown` hook in deterministic order. */\nexport function collectTeardowns(sources: AdapterSetupSources): HookEntry[] {\n  const entries: HookEntry[] = [];\n  pushAll(entries, sources, \"teardown\");\n  return entries;\n}\n\ninterface LoggerCarrier {\n  readonly metadata: AdapterMetadata;\n  readonly setLogger?: (logger: Logger) => void;\n}\n\n/**\n * Bind the host logger on every adapter that accepts one, scoped by kind.\n * Adapters without `setLogger` keep today's behavior (silent when no\n * explicit `options.logger` was passed at construction).\n */\nexport function bindAdapterLoggers(sources: AdapterSetupSources, logger: Logger): void {\n  const adapters: ReadonlyArray<LoggerCarrier | undefined> = [\n    sources.database,\n    sources.storage,\n    sources.captureRunner,\n    ...(sources.design ?? []),\n    ...(sources.notifiers ?? []),\n    sources.emailSender,\n  ];\n  for (const adapter of adapters) {\n    adapter?.setLogger?.(logger.child({ component: adapter.metadata.kind }));\n  }\n}\n\nfunction messageOf(reason: unknown): string {\n  const text = reason instanceof Error ? reason.message : String(reason);\n  return sanitizeErrorText(text, 500);\n}\n\n/** Budgets that trigger slow-hook warnings (observe only, never abort). */\nconst SLOW_SETUP_MS = 10_000;\nconst SLOW_TEARDOWN_MS = 5_000;\n\n/** Run one hook with start/done logging and a slow-hook warning. */\nasync function runHook(\n  entry: HookEntry,\n  ctx: AdapterSetupContext,\n  logger: Logger,\n  slowMs: number,\n): Promise<void> {\n  const { category, kind, name } = entry;\n  const started = Date.now();\n  logger.info({ category, kind, name }, \"adapter hook start\");\n  try {\n    await entry.run(ctx);\n  } finally {\n    const durationMs = Date.now() - started;\n    logger.info({ category, kind, name, durationMs }, \"adapter hook done\");\n    if (durationMs > slowMs) {\n      logger.warn({ category, kind, name, durationMs, slowMs }, \"slow adapter hook\");\n    }\n  }\n}\n\nfunction toFailure(entry: HookEntry, reason: unknown): AdapterSetupFailure {\n  return { category: entry.category, kind: entry.kind, name: entry.name, error: messageOf(reason) };\n}\n\nfunction toResult(\n  entries: HookEntry[],\n  outcomes: PromiseSettledResult<void>[],\n  logger: Logger,\n  verb: string,\n): AdapterSetupResult {\n  const failures: AdapterSetupFailure[] = [];\n  for (const [index, entry] of entries.entries()) {\n    const outcome: PromiseSettledResult<void> | undefined = outcomes[index];\n    if (outcome?.status === \"rejected\") {\n      failures.push(toFailure(entry, outcome.reason));\n    }\n  }\n  if (failures.length > 0) {\n    logger.error({ failures }, `adapter ${verb} failed`);\n  } else {\n    logger.info({ count: entries.length }, `adapters ${verb}d`);\n  }\n  return { ok: failures.length === 0, failures };\n}\n\n/** One run of collected hooks with start/done logging and hung visibility. */\nasync function runHooks(\n  entries: HookEntry[],\n  ctx: AdapterSetupContext,\n  logger: Logger,\n  verb: string,\n  slowMs: number,\n): Promise<AdapterSetupResult> {\n  let settled = false;\n  const timer = setTimeout(() => {\n    if (!settled) {\n      logger.warn({ count: entries.length, slowMs }, `adapters ${verb} still running`);\n    }\n  }, slowMs);\n  timer.unref?.();\n  try {\n    const outcomes = await Promise.allSettled(\n      entries.map(async (entry) => {\n        await runHook(entry, ctx, logger, slowMs);\n      }),\n    );\n    return toResult(entries, outcomes, logger, verb);\n  } finally {\n    settled = true;\n    clearTimeout(timer);\n  }\n}\n\n/** Run setup hooks concurrently; failures are collected, never thrown. */\nexport async function runAdapterSetups(\n  entries: HookEntry[],\n  ctx: AdapterSetupContext,\n  logger: Logger,\n): Promise<AdapterSetupResult> {\n  return await runHooks(entries, ctx, logger, \"setup\", SLOW_SETUP_MS);\n}\n\n/** Run teardown hooks concurrently; failures are collected, never thrown. */\nexport async function runAdapterTeardowns(\n  entries: HookEntry[],\n  ctx: AdapterSetupContext,\n  logger: Logger,\n): Promise<AdapterSetupResult> {\n  return await runHooks(entries, ctx, logger, \"teardown\", SLOW_TEARDOWN_MS);\n}\n"],"mappings":"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"}

package/dist/adapters/sources.d.mts

@@ -0,0 +1,10 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ShelfOptions } from "../config.mjs";
+import { AdapterSetupSources } from "../adapter/setup.mjs";
+/** The adapter slots of `options`, with `auth` carried along for boot validation. */
+declare function adapterSourcesOf(options: ShelfOptions): AdapterSetupSources & {
+  auth?: unknown;
+};
+export { adapterSourcesOf };
+//# sourceMappingURL=sources.d.mts.map

package/dist/adapters/sources.mjs

@@ -0,0 +1,19 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/adapters/sources.ts
+/** The adapter slots of `options`, with `auth` carried along for boot validation. */
+function adapterSourcesOf(options) {
+	return {
+		database: options.database,
+		storage: options.storage,
+		captureRunner: options.testing?.runner,
+		design: options.design,
+		notifiers: options.notifications?.notifiers,
+		emailSender: options.notifications?.emailSender,
+		auth: options.auth
+	};
+}
+export { adapterSourcesOf };
+
+//# sourceMappingURL=sources.mjs.map

package/dist/adapters/sources.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.mjs","names":[],"sources":["../../src/adapters/sources.ts"],"sourcesContent":["/** Maps `ShelfOptions` to the flat adapter slots lifecycle, validation and health probing work on. */\nimport type { ShelfOptions } from \"../config.ts\";\nimport type { AdapterSetupSources } from \"./setup.ts\";\n\n/** The adapter slots of `options`, with `auth` carried along for boot validation. */\nexport function adapterSourcesOf(options: ShelfOptions): AdapterSetupSources & { auth?: unknown } {\n  return {\n    database: options.database,\n    storage: options.storage,\n    captureRunner: options.testing?.runner,\n    design: options.design,\n    notifiers: options.notifications?.notifiers,\n    emailSender: options.notifications?.emailSender,\n    auth: options.auth,\n  };\n}\n"],"mappings":";;;;;AAKA,SAAgB,iBAAiB,SAAiE;CAChG,OAAO;EACL,UAAU,QAAQ;EAClB,SAAS,QAAQ;EACjB,eAAe,QAAQ,SAAS;EAChC,QAAQ,QAAQ;EAChB,WAAW,QAAQ,eAAe;EAClC,aAAa,QAAQ,eAAe;EACpC,MAAM,QAAQ;CAChB;AACF"}

package/dist/adapters/validate.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { AdapterSetupFailure, AdapterSetupSources } from "../adapter/setup.mjs";
-//#region src/adapters/validate.d.ts
 /**
  * Validate one adapter against its slot. Returns human-readable reasons
  * (empty when valid). Never throws — callers decide fail-fast vs collect.
@@ -25,6 +24,5 @@ declare function validateAdapterSources(sources: AdapterSetupSources): AdapterSe
 declare function validateBootAssembly(sources: AdapterSetupSources & {
   auth?: unknown;
 }): AdapterSetupFailure[];
-//#endregion
 export { validateAdapter, validateAdapterSources, validateAuth, validateBootAssembly };
 //# sourceMappingURL=validate.d.mts.map

package/dist/adapters/validate.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { REQUIRED_TABLE_KEYS } from "../adapter/database.mjs";
 import { z } from "zod";
-//#region src/adapters/validate.ts
+// src/adapters/validate.ts
 /**
 * Boot-time adapter validation: fail fast on third-party adapters that
 * cannot satisfy their slot contract.
@@ -21,6 +21,7 @@ const metadataSchema = z.object({
 const DATABASE_METHODS = [
 	"insert",
 	"update",
+	"updateWhere",
 	"get",
 	"remove",
 	"list",
@@ -119,13 +120,13 @@ function emailSenderReasons(sender) {
 	if (typeof record["send"] !== "function") reasons.push("missing methods: send");
 	return reasons;
 }
-/** Reasons a git provider lacks its descriptor shape. */
-function gitReasons(provider) {
+/** Reasons a design provider lacks its descriptor shape. */
+function designReasons(provider) {
 	const record = asRecord(provider);
-	if (!record) return ["git provider must be an object"];
-	const reasons = metadataReasons(record, "git-host");
-	if (typeof record["create"] !== "function") reasons.push("missing methods: create");
-	if (!hasSchemaParse(provider)) reasons.push("metadata.schema must be a zod schema");
+	if (!record) return ["design provider must be an object"];
+	const reasons = metadataReasons(record, "design");
+	const missing = ["parseUrl", "create"].filter((name) => typeof record[name] !== "function");
+	if (missing.length > 0) reasons.push(`missing methods: ${missing.join(", ")}`);
 	return reasons;
 }
 /** Required methods for a slot category. */
@@ -213,17 +214,29 @@ function checkAuth(auth) {
 		error: reasons.join("; ")
 	}];
 }
-/** Failures for git-host or notifier provider lists. */
+const PROVIDER_KINDS = {
+	design: {
+		reasons: designReasons,
+		list: "design",
+		category: "design"
+	},
+	notifier: {
+		reasons: notifierReasons,
+		list: "notifiers",
+		category: "notifier"
+	}
+};
+/** Failures for design or notifier provider lists. */
 function checkProviders(checks) {
 	const failures = [];
 	for (const check of checks) {
-		const reasons = check.kinds === "git" ? gitReasons(check.provider) : notifierReasons(check.provider);
+		const kind = PROVIDER_KINDS[check.kinds];
+		const reasons = kind.reasons(check.provider);
 		if (reasons.length === 0) continue;
-		const slot = check.kinds === "git" ? `gitHosts[${check.index}]` : `notifiers[${check.index}]`;
-		const category = check.kinds === "git" ? "git-host" : "notifier";
+		const slot = `${kind.list}[${check.index}]`;
 		const metadata = asRecord(asRecord(check.provider)?.["metadata"]);
 		failures.push({
-			category,
+			category: kind.category,
 			kind: stringField(metadata, "kind") ?? "unknown",
 			name: stringField(metadata, "name") ?? slot,
 			error: reasons.map((reason) => `${slot}: ${reason}`).join("; ")
@@ -279,15 +292,10 @@ function validateAdapterSources(sources) {
 		category: "capture-runner",
 		slot: "captureRunner"
 	});
-	if (sources.captureQueue !== void 0) checks.push({
-		adapter: sources.captureQueue,
-		category: "capture-queue",
-		slot: "captureQueue"
-	});
-	const providers = [...(sources.gitHosts ?? []).map((provider, index) => ({
+	const providers = [...(sources.design ?? []).map((provider, index) => ({
 		provider,
 		index,
-		kinds: "git"
+		kinds: "design"
 	})), ...(sources.notifiers ?? []).map((provider, index) => ({
 		provider,
 		index,
@@ -307,7 +315,6 @@ function validateAdapterSources(sources) {
 function validateBootAssembly(sources) {
 	return [...validateAdapterSources(sources), ...checkAuth(sources.auth)];
 }
-//#endregion
 export { validateAdapter, validateAdapterSources, validateAuth, validateBootAssembly };
 
 //# sourceMappingURL=validate.mjs.map

package/dist/adapters/validate.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validate.mjs","names":[],"sources":["../../src/adapters/validate.ts"],"sourcesContent":["/**\n * Boot-time adapter validation: fail fast on third-party adapters that\n * cannot satisfy their slot contract.\n *\n * Types alone cannot stop a bad adapter — this module checks shape at\n * runtime before any I/O runs. `createShelfApp` throws synchronously;\n * the lifecycle runner returns failures without executing hooks.\n */\nimport { z } from \"zod\";\nimport type { Auth } from \"../auth.ts\";\nimport { REQUIRED_TABLE_KEYS } from \"./database.ts\";\nimport type { AdapterSetupFailure, AdapterSetupSources } from \"./setup.ts\";\n\nconst metadataSchema = z.object({\n  name: z.string().min(1),\n  version: z.string().min(1),\n  kind: z.string().min(1),\n  category: z.string().min(1),\n});\n\nconst DATABASE_METHODS = [\"insert\", \"update\", \"get\", \"remove\", \"list\", \"count\", \"all\"];\n\nconst STORAGE_METHODS = [\"read\", \"write\", \"delete\", \"exists\", \"list\", \"writeStream\", \"readStream\"];\n\nconst RUNNER_METHODS = [\"render\", \"cancel\"];\n\nconst QUEUE_METHODS = [\"enqueue\", \"status\", \"active\", \"recent\"];\n\n/** Unknown value narrowed to a property bag for shape checks. */\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n  return typeof value === \"object\" && value !== null ? (value as Record<string, unknown>) : null;\n}\n\n/** String field of a record, or null when absent/non-string. */\nfunction stringField(record: Record<string, unknown> | null, key: string): string | null {\n  const value = record?.[key];\n  return typeof value === \"string\" ? value : null;\n}\n\n/** Reasons the adapter identity fails for the expected slot. */\nfunction metadataReasons(adapter: Record<string, unknown>, expected: string): string[] {\n  const parsed = metadataSchema.safeParse(adapter[\"metadata\"]);\n  if (!parsed.success) {\n    return [`invalid metadata: ${parsed.error.issues.map((i) => i.path.join(\".\")).join(\",\")}`];\n  }\n  const category = (parsed.data as { category: string }).category;\n  return category === expected ? [] : [`category \"${category}\" does not match slot \"${expected}\"`];\n}\n\n/** Reasons the optional lifecycle violates the all-or-nothing rule. */\nfunction lifecycleReasons(adapter: Record<string, unknown>): string[] {\n  const lifecycle = adapter[\"lifecycle\"];\n  if (lifecycle === undefined) {\n    return [];\n  }\n  const hooks = asRecord(lifecycle);\n  if (!hooks) {\n    return [\"lifecycle must be an object with setup/teardown/health\"];\n  }\n  const missing = [\"setup\", \"teardown\", \"health\"].filter(\n    (hook) => typeof hooks[hook] !== \"function\",\n  );\n  return missing.length > 0 ? [`partial lifecycle (missing: ${missing.join(\",\")})`] : [];\n}\n\n/** Reasons the adapter lacks required slot methods. */\nfunction methodReasons(adapter: Record<string, unknown>, methods: string[]): string[] {\n  const missing = methods.filter((method) => typeof adapter[method] !== \"function\");\n  return missing.length > 0 ? [`missing methods: ${missing.join(\",\")}`] : [];\n}\n\n/** Reasons a database adapter lacks its table map. */\nfunction tableReasons(adapter: Record<string, unknown>): string[] {\n  const tables = asRecord(adapter[\"tables\"]);\n  if (!tables) {\n    return [\"missing tables map\"];\n  }\n  const missing = REQUIRED_TABLE_KEYS.filter((table) => tables[table] === undefined);\n  return missing.length > 0 ? [`missing tables: ${missing.join(\",\")}`] : [];\n}\n\n/** Reasons a queue adapter has a partial poll extension. */\nfunction queuePollReasons(record: Record<string, unknown>): string[] {\n  const present = [\"poll\", \"ack\", \"nack\"].filter((method) => record[method] !== undefined);\n  if (present.length === 0 || present.length === 3) {\n    const mistyped = [\"poll\", \"ack\", \"nack\"].filter(\n      (method) => record[method] !== undefined && typeof record[method] !== \"function\",\n    );\n    return mistyped.map((method) => `queue poll extension \"${method}\" must be a function`);\n  }\n  return [`partial poll extension (present: ${present.join(\",\")}; need poll+ack+nack)`];\n}\n\n/** Whether a metadata schema looks like a zod schema (has parse). */\nfunction hasSchemaParse(provider: unknown): boolean {\n  const schema = asRecord(asRecord(provider)?.[\"metadata\"])?.[\"schema\"];\n  return typeof (schema as { parse?: unknown } | undefined)?.parse === \"function\";\n}\n\n/** Reasons a notifier provider lacks its descriptor shape. */\nfunction notifierReasons(provider: unknown): string[] {\n  const record = asRecord(provider);\n  if (!record) {\n    return [\"notifier provider must be an object\"];\n  }\n  const reasons = metadataReasons(record, \"notifier\");\n  if (typeof record[\"create\"] !== \"function\") {\n    reasons.push(\"missing methods: create\");\n  }\n  if (!hasSchemaParse(provider)) {\n    reasons.push(\"metadata.schema must be a zod schema\");\n  }\n  return reasons;\n}\n\n/** Reasons an email sender lacks its transport shape. */\nfunction emailSenderReasons(sender: unknown): string[] {\n  const record = asRecord(sender);\n  if (!record) {\n    return [\"email sender must be an object\"];\n  }\n  const reasons = metadataReasons(record, \"notifier\");\n  if (typeof record[\"send\"] !== \"function\") {\n    reasons.push(\"missing methods: send\");\n  }\n  return reasons;\n}\n\n/** Reasons a git provider lacks its descriptor shape. */\nfunction gitReasons(provider: unknown): string[] {\n  const record = asRecord(provider);\n  if (!record) {\n    return [\"git provider must be an object\"];\n  }\n  const reasons = metadataReasons(record, \"git-host\");\n  if (typeof record[\"create\"] !== \"function\") {\n    reasons.push(\"missing methods: create\");\n  }\n  if (!hasSchemaParse(provider)) {\n    reasons.push(\"metadata.schema must be a zod schema\");\n  }\n  return reasons;\n}\n\n/** Required methods for a slot category. */\nfunction slotMethods(category: string): string[] {\n  if (category === \"database\") {\n    return DATABASE_METHODS;\n  }\n  if (category === \"storage\") {\n    return STORAGE_METHODS;\n  }\n  if (category === \"capture-runner\") {\n    return RUNNER_METHODS;\n  }\n  return QUEUE_METHODS;\n}\n\n/** Extra per-slot reasons (table map for databases, poll rule for queues). */\nfunction slotExtraReasons(record: Record<string, unknown>, category: string): string[] {\n  if (category === \"database\") {\n    return tableReasons(record);\n  }\n  return category === \"capture-queue\" ? queuePollReasons(record) : [];\n}\n\n/**\n * Validate one adapter against its slot. Returns human-readable reasons\n * (empty when valid). Never throws — callers decide fail-fast vs collect.\n */\nexport function validateAdapter(\n  adapter: unknown,\n  expectedCategory: string,\n  slot: string,\n): string[] {\n  const record = asRecord(adapter);\n  if (!record) {\n    return [`${slot} adapter must be an object`];\n  }\n  const reasons = metadataReasons(record, expectedCategory).map((r) => `${slot}: ${r}`);\n  const extra = [\n    ...lifecycleReasons(record),\n    ...methodReasons(record, slotMethods(expectedCategory)),\n    ...slotExtraReasons(record, expectedCategory),\n  ];\n  for (const reason of extra) {\n    reasons.push(`${slot}: ${reason}`);\n  }\n  return reasons;\n}\n\n/** Auth surface methods every engine must expose. */\nconst AUTH_METHODS = [\n  \"handler\",\n  \"loginMethods\",\n  \"setup\",\n  \"issueInvite\",\n  \"verifyInvite\",\n  \"acceptInvite\",\n  \"passkeysEnabled\",\n  \"listSessions\",\n  \"listPasskeys\",\n  \"hasPassword\",\n  \"setDisabled\",\n  \"check\",\n  \"createSession\",\n  \"destroySession\",\n];\n\n/** Reasons a method-id list is unusable (blank or duplicate ids). */\nfunction methodIdReasons(ids: string[]): string[] {\n  const reasons: string[] = [];\n  if (ids.some((id) => id.length === 0)) {\n    reasons.push(\"login method with blank id\");\n  }\n  if (new Set(ids).size !== ids.length) {\n    reasons.push(\"duplicate login method ids\");\n  }\n  return reasons;\n}\n\n/** Reasons login method descriptors are unusable (duplicate/blank ids). */\nfunction loginMethodReasons(auth: Auth): string[] {\n  let ids: string[];\n  try {\n    ids = auth.loginMethods().map((method) => method.id);\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    return [`loginMethods() threw: ${message}`];\n  }\n  return methodIdReasons(ids);\n}\n\n/**\n * Validate the auth engine shape (auth is optional — undefined is valid).\n * Returns human-readable reasons, empty when sound.\n */\nexport function validateAuth(auth?: unknown): string[] {\n  if (auth === undefined) {\n    return [];\n  }\n  const record = asRecord(auth);\n  if (!record) {\n    return [\"auth must be an object\"];\n  }\n  const reasons = methodReasons(record, AUTH_METHODS).map((reason) => `auth: ${reason}`);\n  if (reasons.length === 0) {\n    for (const reason of loginMethodReasons(auth as Auth)) {\n      reasons.push(`auth: ${reason}`);\n    }\n  }\n  return reasons;\n}\n\n/** Failure entry for an invalid auth engine. */\nfunction checkAuth(auth: unknown): AdapterSetupFailure[] {\n  const reasons = validateAuth(auth);\n  if (reasons.length === 0) {\n    return [];\n  }\n  return [{ category: \"auth\", kind: \"auth\", name: \"auth\", error: reasons.join(\"; \") }];\n}\n\n/** One slot check for source validation. */\ninterface SlotCheck {\n  adapter: unknown;\n  category: string;\n  slot: string;\n}\n\n/** Descriptor check for provider lists (git hosts, notifiers). */\ninterface ProviderCheck {\n  provider: unknown;\n  index: number;\n  kinds: \"git\" | \"notifier\";\n}\n\n/** Failures for git-host or notifier provider lists. */\nfunction checkProviders(checks: ProviderCheck[]): AdapterSetupFailure[] {\n  const failures: AdapterSetupFailure[] = [];\n  for (const check of checks) {\n    const reasons =\n      check.kinds === \"git\" ? gitReasons(check.provider) : notifierReasons(check.provider);\n    if (reasons.length === 0) {\n      continue;\n    }\n    const slot = check.kinds === \"git\" ? `gitHosts[${check.index}]` : `notifiers[${check.index}]`;\n    const category = check.kinds === \"git\" ? \"git-host\" : \"notifier\";\n    const metadata = asRecord(asRecord(check.provider)?.[\"metadata\"]);\n    failures.push({\n      category,\n      kind: stringField(metadata, \"kind\") ?? \"unknown\",\n      name: stringField(metadata, \"name\") ?? slot,\n      error: reasons.map((reason) => `${slot}: ${reason}`).join(\"; \"),\n    });\n  }\n  return failures;\n}\n\n/** Failure for the email sender slot. */\nfunction checkEmailSender(sender: unknown): AdapterSetupFailure[] {\n  if (sender === undefined) {\n    return [];\n  }\n  const reasons = emailSenderReasons(sender);\n  if (reasons.length === 0) {\n    return [];\n  }\n  const metadata = asRecord(asRecord(sender)?.[\"metadata\"]);\n  return [\n    {\n      category: \"notifier\",\n      kind: stringField(metadata, \"kind\") ?? \"unknown\",\n      name: stringField(metadata, \"name\") ?? \"emailSender\",\n      error: reasons.map((reason) => `emailSender: ${reason}`).join(\"; \"),\n    },\n  ];\n}\n\n/** Failures for the core database/storage/runner/queue slots. */\nfunction checkSlots(checks: SlotCheck[]): AdapterSetupFailure[] {\n  const failures: AdapterSetupFailure[] = [];\n  for (const check of checks) {\n    const reasons = validateAdapter(check.adapter, check.category, check.slot);\n    if (reasons.length === 0) {\n      continue;\n    }\n    const metadata = asRecord(asRecord(check.adapter)?.[\"metadata\"]);\n    failures.push({\n      category: check.category,\n      kind: stringField(metadata, \"kind\") ?? \"unknown\",\n      name: stringField(metadata, \"name\") ?? check.slot,\n      error: reasons.join(\"; \"),\n    });\n  }\n  return failures;\n}\n\n/**\n * Validate every adapter in the boot sources. Returns per-adapter failures\n * (empty when the whole assembly is sound).\n */\nexport function validateAdapterSources(sources: AdapterSetupSources): AdapterSetupFailure[] {\n  const checks: SlotCheck[] = [\n    { adapter: sources.database, category: \"database\", slot: \"database\" },\n    { adapter: sources.storage, category: \"storage\", slot: \"storage\" },\n  ];\n  if (sources.captureRunner !== undefined) {\n    checks.push({\n      adapter: sources.captureRunner,\n      category: \"capture-runner\",\n      slot: \"captureRunner\",\n    });\n  }\n  if (sources.captureQueue !== undefined) {\n    checks.push({ adapter: sources.captureQueue, category: \"capture-queue\", slot: \"captureQueue\" });\n  }\n  const providers: ProviderCheck[] = [\n    ...(sources.gitHosts ?? []).map((provider, index) => ({\n      provider,\n      index,\n      kinds: \"git\" as const,\n    })),\n    ...(sources.notifiers ?? []).map((provider, index) => ({\n      provider,\n      index,\n      kinds: \"notifier\" as const,\n    })),\n  ];\n  return [\n    ...checkSlots(checks),\n    ...checkProviders(providers),\n    ...checkEmailSender(sources.emailSender),\n  ];\n}\n\n/**\n * Validate a full boot assembly: adapters plus the optional auth engine.\n * App assembly calls this — `ShelfOptions` carries `auth` alongside the\n * adapter slots, and an invalid engine fails boot like any adapter.\n */\nexport function validateBootAssembly(\n  sources: AdapterSetupSources & { auth?: unknown },\n): AdapterSetupFailure[] {\n  return [...validateAdapterSources(sources), ...checkAuth(sources.auth)];\n}\n"],"mappings":"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"}
+{"version":3,"file":"validate.mjs","names":[],"sources":["../../src/adapters/validate.ts"],"sourcesContent":["/**\n * Boot-time adapter validation: fail fast on third-party adapters that\n * cannot satisfy their slot contract.\n *\n * Types alone cannot stop a bad adapter — this module checks shape at\n * runtime before any I/O runs. `createShelfApp` throws synchronously;\n * the lifecycle runner returns failures without executing hooks.\n */\nimport { z } from \"zod\";\nimport type { Auth } from \"../auth.ts\";\nimport { REQUIRED_TABLE_KEYS } from \"./database.ts\";\nimport type { AdapterSetupFailure, AdapterSetupSources } from \"./setup.ts\";\n\nconst metadataSchema = z.object({\n  name: z.string().min(1),\n  version: z.string().min(1),\n  kind: z.string().min(1),\n  category: z.string().min(1),\n});\n\nconst DATABASE_METHODS = [\n  \"insert\",\n  \"update\",\n  \"updateWhere\",\n  \"get\",\n  \"remove\",\n  \"list\",\n  \"count\",\n  \"all\",\n];\n\nconst STORAGE_METHODS = [\"read\", \"write\", \"delete\", \"exists\", \"list\", \"writeStream\", \"readStream\"];\n\nconst RUNNER_METHODS = [\"render\", \"cancel\"];\n\nconst QUEUE_METHODS = [\"enqueue\", \"status\", \"active\", \"recent\"];\n\n/** Unknown value narrowed to a property bag for shape checks. */\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n  return typeof value === \"object\" && value !== null ? (value as Record<string, unknown>) : null;\n}\n\n/** String field of a record, or null when absent/non-string. */\nfunction stringField(record: Record<string, unknown> | null, key: string): string | null {\n  const value = record?.[key];\n  return typeof value === \"string\" ? value : null;\n}\n\n/** Reasons the adapter identity fails for the expected slot. */\nfunction metadataReasons(adapter: Record<string, unknown>, expected: string): string[] {\n  const parsed = metadataSchema.safeParse(adapter[\"metadata\"]);\n  if (!parsed.success) {\n    return [`invalid metadata: ${parsed.error.issues.map((i) => i.path.join(\".\")).join(\",\")}`];\n  }\n  const category = (parsed.data as { category: string }).category;\n  return category === expected ? [] : [`category \"${category}\" does not match slot \"${expected}\"`];\n}\n\n/** Reasons the optional lifecycle violates the all-or-nothing rule. */\nfunction lifecycleReasons(adapter: Record<string, unknown>): string[] {\n  const lifecycle = adapter[\"lifecycle\"];\n  if (lifecycle === undefined) {\n    return [];\n  }\n  const hooks = asRecord(lifecycle);\n  if (!hooks) {\n    return [\"lifecycle must be an object with setup/teardown/health\"];\n  }\n  const missing = [\"setup\", \"teardown\", \"health\"].filter(\n    (hook) => typeof hooks[hook] !== \"function\",\n  );\n  return missing.length > 0 ? [`partial lifecycle (missing: ${missing.join(\",\")})`] : [];\n}\n\n/** Reasons the adapter lacks required slot methods. */\nfunction methodReasons(adapter: Record<string, unknown>, methods: string[]): string[] {\n  const missing = methods.filter((method) => typeof adapter[method] !== \"function\");\n  return missing.length > 0 ? [`missing methods: ${missing.join(\",\")}`] : [];\n}\n\n/** Reasons a database adapter lacks its table map. */\nfunction tableReasons(adapter: Record<string, unknown>): string[] {\n  const tables = asRecord(adapter[\"tables\"]);\n  if (!tables) {\n    return [\"missing tables map\"];\n  }\n  const missing = REQUIRED_TABLE_KEYS.filter((table) => tables[table] === undefined);\n  return missing.length > 0 ? [`missing tables: ${missing.join(\",\")}`] : [];\n}\n\n/** Reasons a queue adapter has a partial poll extension. */\nfunction queuePollReasons(record: Record<string, unknown>): string[] {\n  const present = [\"poll\", \"ack\", \"nack\"].filter((method) => record[method] !== undefined);\n  if (present.length === 0 || present.length === 3) {\n    const mistyped = [\"poll\", \"ack\", \"nack\"].filter(\n      (method) => record[method] !== undefined && typeof record[method] !== \"function\",\n    );\n    return mistyped.map((method) => `queue poll extension \"${method}\" must be a function`);\n  }\n  return [`partial poll extension (present: ${present.join(\",\")}; need poll+ack+nack)`];\n}\n\n/** Whether a metadata schema looks like a zod schema (has parse). */\nfunction hasSchemaParse(provider: unknown): boolean {\n  const schema = asRecord(asRecord(provider)?.[\"metadata\"])?.[\"schema\"];\n  return typeof (schema as { parse?: unknown } | undefined)?.parse === \"function\";\n}\n\n/** Reasons a notifier provider lacks its descriptor shape. */\nfunction notifierReasons(provider: unknown): string[] {\n  const record = asRecord(provider);\n  if (!record) {\n    return [\"notifier provider must be an object\"];\n  }\n  const reasons = metadataReasons(record, \"notifier\");\n  if (typeof record[\"create\"] !== \"function\") {\n    reasons.push(\"missing methods: create\");\n  }\n  if (!hasSchemaParse(provider)) {\n    reasons.push(\"metadata.schema must be a zod schema\");\n  }\n  return reasons;\n}\n\n/** Reasons an email sender lacks its transport shape. */\nfunction emailSenderReasons(sender: unknown): string[] {\n  const record = asRecord(sender);\n  if (!record) {\n    return [\"email sender must be an object\"];\n  }\n  const reasons = metadataReasons(record, \"notifier\");\n  if (typeof record[\"send\"] !== \"function\") {\n    reasons.push(\"missing methods: send\");\n  }\n  return reasons;\n}\n\n/** Reasons a design provider lacks its descriptor shape. */\nfunction designReasons(provider: unknown): string[] {\n  const record = asRecord(provider);\n  if (!record) {\n    return [\"design provider must be an object\"];\n  }\n  const reasons = metadataReasons(record, \"design\");\n  const missing = [\"parseUrl\", \"create\"].filter((name) => typeof record[name] !== \"function\");\n  if (missing.length > 0) {\n    reasons.push(`missing methods: ${missing.join(\", \")}`);\n  }\n  return reasons;\n}\n\n/** Required methods for a slot category. */\nfunction slotMethods(category: string): string[] {\n  if (category === \"database\") {\n    return DATABASE_METHODS;\n  }\n  if (category === \"storage\") {\n    return STORAGE_METHODS;\n  }\n  if (category === \"capture-runner\") {\n    return RUNNER_METHODS;\n  }\n  return QUEUE_METHODS;\n}\n\n/** Extra per-slot reasons (table map for databases, poll rule for queues). */\nfunction slotExtraReasons(record: Record<string, unknown>, category: string): string[] {\n  if (category === \"database\") {\n    return tableReasons(record);\n  }\n  return category === \"capture-queue\" ? queuePollReasons(record) : [];\n}\n\n/**\n * Validate one adapter against its slot. Returns human-readable reasons\n * (empty when valid). Never throws — callers decide fail-fast vs collect.\n */\nexport function validateAdapter(\n  adapter: unknown,\n  expectedCategory: string,\n  slot: string,\n): string[] {\n  const record = asRecord(adapter);\n  if (!record) {\n    return [`${slot} adapter must be an object`];\n  }\n  const reasons = metadataReasons(record, expectedCategory).map((r) => `${slot}: ${r}`);\n  const extra = [\n    ...lifecycleReasons(record),\n    ...methodReasons(record, slotMethods(expectedCategory)),\n    ...slotExtraReasons(record, expectedCategory),\n  ];\n  for (const reason of extra) {\n    reasons.push(`${slot}: ${reason}`);\n  }\n  return reasons;\n}\n\n/** Auth surface methods every engine must expose. */\nconst AUTH_METHODS = [\n  \"handler\",\n  \"loginMethods\",\n  \"setup\",\n  \"issueInvite\",\n  \"verifyInvite\",\n  \"acceptInvite\",\n  \"passkeysEnabled\",\n  \"listSessions\",\n  \"listPasskeys\",\n  \"hasPassword\",\n  \"setDisabled\",\n  \"check\",\n  \"createSession\",\n  \"destroySession\",\n];\n\n/** Reasons a method-id list is unusable (blank or duplicate ids). */\nfunction methodIdReasons(ids: string[]): string[] {\n  const reasons: string[] = [];\n  if (ids.some((id) => id.length === 0)) {\n    reasons.push(\"login method with blank id\");\n  }\n  if (new Set(ids).size !== ids.length) {\n    reasons.push(\"duplicate login method ids\");\n  }\n  return reasons;\n}\n\n/** Reasons login method descriptors are unusable (duplicate/blank ids). */\nfunction loginMethodReasons(auth: Auth): string[] {\n  let ids: string[];\n  try {\n    ids = auth.loginMethods().map((method) => method.id);\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    return [`loginMethods() threw: ${message}`];\n  }\n  return methodIdReasons(ids);\n}\n\n/**\n * Validate the auth engine shape (auth is optional — undefined is valid).\n * Returns human-readable reasons, empty when sound.\n */\nexport function validateAuth(auth?: unknown): string[] {\n  if (auth === undefined) {\n    return [];\n  }\n  const record = asRecord(auth);\n  if (!record) {\n    return [\"auth must be an object\"];\n  }\n  const reasons = methodReasons(record, AUTH_METHODS).map((reason) => `auth: ${reason}`);\n  if (reasons.length === 0) {\n    for (const reason of loginMethodReasons(auth as Auth)) {\n      reasons.push(`auth: ${reason}`);\n    }\n  }\n  return reasons;\n}\n\n/** Failure entry for an invalid auth engine. */\nfunction checkAuth(auth: unknown): AdapterSetupFailure[] {\n  const reasons = validateAuth(auth);\n  if (reasons.length === 0) {\n    return [];\n  }\n  return [{ category: \"auth\", kind: \"auth\", name: \"auth\", error: reasons.join(\"; \") }];\n}\n\n/** One slot check for source validation. */\ninterface SlotCheck {\n  adapter: unknown;\n  category: string;\n  slot: string;\n}\n\n/** Descriptor check for provider lists (design providers, notifiers). */\ninterface ProviderCheck {\n  provider: unknown;\n  index: number;\n  kinds: \"design\" | \"notifier\";\n}\n\nconst PROVIDER_KINDS = {\n  design: { reasons: designReasons, list: \"design\", category: \"design\" },\n  notifier: { reasons: notifierReasons, list: \"notifiers\", category: \"notifier\" },\n} as const;\n\n/** Failures for design or notifier provider lists. */\nfunction checkProviders(checks: ProviderCheck[]): AdapterSetupFailure[] {\n  const failures: AdapterSetupFailure[] = [];\n  for (const check of checks) {\n    const kind = PROVIDER_KINDS[check.kinds];\n    const reasons = kind.reasons(check.provider);\n    if (reasons.length === 0) {\n      continue;\n    }\n    const slot = `${kind.list}[${check.index}]`;\n    const metadata = asRecord(asRecord(check.provider)?.[\"metadata\"]);\n    failures.push({\n      category: kind.category,\n      kind: stringField(metadata, \"kind\") ?? \"unknown\",\n      name: stringField(metadata, \"name\") ?? slot,\n      error: reasons.map((reason) => `${slot}: ${reason}`).join(\"; \"),\n    });\n  }\n  return failures;\n}\n\n/** Failure for the email sender slot. */\nfunction checkEmailSender(sender: unknown): AdapterSetupFailure[] {\n  if (sender === undefined) {\n    return [];\n  }\n  const reasons = emailSenderReasons(sender);\n  if (reasons.length === 0) {\n    return [];\n  }\n  const metadata = asRecord(asRecord(sender)?.[\"metadata\"]);\n  return [\n    {\n      category: \"notifier\",\n      kind: stringField(metadata, \"kind\") ?? \"unknown\",\n      name: stringField(metadata, \"name\") ?? \"emailSender\",\n      error: reasons.map((reason) => `emailSender: ${reason}`).join(\"; \"),\n    },\n  ];\n}\n\n/** Failures for the core database/storage/runner/queue slots. */\nfunction checkSlots(checks: SlotCheck[]): AdapterSetupFailure[] {\n  const failures: AdapterSetupFailure[] = [];\n  for (const check of checks) {\n    const reasons = validateAdapter(check.adapter, check.category, check.slot);\n    if (reasons.length === 0) {\n      continue;\n    }\n    const metadata = asRecord(asRecord(check.adapter)?.[\"metadata\"]);\n    failures.push({\n      category: check.category,\n      kind: stringField(metadata, \"kind\") ?? \"unknown\",\n      name: stringField(metadata, \"name\") ?? check.slot,\n      error: reasons.join(\"; \"),\n    });\n  }\n  return failures;\n}\n\n/**\n * Validate every adapter in the boot sources. Returns per-adapter failures\n * (empty when the whole assembly is sound).\n */\nexport function validateAdapterSources(sources: AdapterSetupSources): AdapterSetupFailure[] {\n  const checks: SlotCheck[] = [\n    { adapter: sources.database, category: \"database\", slot: \"database\" },\n    { adapter: sources.storage, category: \"storage\", slot: \"storage\" },\n  ];\n  if (sources.captureRunner !== undefined) {\n    checks.push({\n      adapter: sources.captureRunner,\n      category: \"capture-runner\",\n      slot: \"captureRunner\",\n    });\n  }\n  const providers: ProviderCheck[] = [\n    ...(sources.design ?? []).map((provider, index) => ({\n      provider,\n      index,\n      kinds: \"design\" as const,\n    })),\n    ...(sources.notifiers ?? []).map((provider, index) => ({\n      provider,\n      index,\n      kinds: \"notifier\" as const,\n    })),\n  ];\n  return [\n    ...checkSlots(checks),\n    ...checkProviders(providers),\n    ...checkEmailSender(sources.emailSender),\n  ];\n}\n\n/**\n * Validate a full boot assembly: adapters plus the optional auth engine.\n * App assembly calls this — `ShelfOptions` carries `auth` alongside the\n * adapter slots, and an invalid engine fails boot like any adapter.\n */\nexport function validateBootAssembly(\n  sources: AdapterSetupSources & { auth?: unknown },\n): AdapterSetupFailure[] {\n  return [...validateAdapterSources(sources), ...checkAuth(sources.auth)];\n}\n"],"mappings":"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"}

package/dist/ai.d.mts

@@ -0,0 +1,103 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { Logger } from "./logger.mjs";
+import { EvidenceLimits } from "./insights/limits.mjs";
+import { z } from "zod";
+/** Tasks the AI surface routes: build triage and project health. */
+type AiTask = "triage" | "health";
+/** One screenshot sent to a vision-capable model. */
+interface AiImage {
+  mediaType: "image/png";
+  data: Uint8Array;
+  /** Short caption (story, viewport) shown to the model before the image. */
+  label: string;
+}
+/** Evidence handed to the model: delimited text plus optional images. */
+interface AiEvidence {
+  text: string;
+  images: AiImage[];
+}
+/** Provider-reported (or estimated) token usage for one call. */
+interface AiUsageReport {
+  inputTokens: number;
+  outputTokens: number;
+  /** True when the backend reported nothing and a char/4 estimate was used. */
+  estimated: boolean;
+}
+/** Input for {@link Ai.summarize}. */
+interface AiSummarizeInput<T> {
+  task: AiTask;
+  /** Requested profile; falls back to the default profile with a warning. */
+  profile?: string;
+  system: string;
+  evidence: AiEvidence;
+  /** Result schema (the model output is validated against it). */
+  schema: z.ZodType<T>;
+  signal?: AbortSignal;
+}
+/** Result of one successful summarize call. */
+interface AiSummarizeResult<T> {
+  object: T;
+  usage: AiUsageReport;
+  profileRequested: string | null;
+  profileEffective: string;
+  model: string;
+  /** Number of images actually sent to the model. */
+  imagesSent: number;
+  /** True when images were dropped (no vision model, or provider rejected them). */
+  visionSkipped: boolean;
+  warnings: string[];
+}
+/** Instance-level budget options (all optional). */
+interface AiBudget {
+  /** Site-wide daily token cap (UTC day); undefined = no daily cap. */
+  dailyTokens?: number;
+  /** Multiplier applied to tokens counted for calls that sent images. */
+  visionWeight: number;
+  /** Per-project call cap per rolling hour. */
+  perProjectCallsPerHour: number;
+}
+/** Why a summarize call failed. */
+type AiErrorCode = "timeout" | "provider" | "schema" | "aborted" | "unknown";
+/** Failure from {@link Ai.summarize}; carries usage the provider still billed. */
+declare class AiError extends Error {
+  readonly code: AiErrorCode;
+  readonly usage?: AiUsageReport;
+  constructor(code: AiErrorCode, message: string, usage?: AiUsageReport, options?: {
+    cause?: unknown;
+  });
+}
+/** Health probe result. */
+interface AiHealth {
+  ok: boolean;
+  detail?: string;
+}
+/** The AI surface consumed by `ShelfOptions.ai`. */
+interface Ai {
+  /** Run one structured summarize call against a profile's model. */
+  summarize<T>(input: AiSummarizeInput<T>): Promise<AiSummarizeResult<T>>;
+  /** Configured profile names. */
+  profileNames(): string[];
+  /** The profile used when none (or an unknown one) is requested. */
+  defaultProfile(): string;
+  /** Whether the profile has an effective vision model for the task. */
+  hasVision(profile: string | undefined, task: AiTask): boolean;
+  /** Stable identifier of the model a call would use (for hashing/rows). */
+  modelId(profile: string | undefined, task: AiTask, withImages?: boolean): string;
+  /** Budget options (with defaults applied). */
+  budget(): AiBudget;
+  /** Evidence limit overrides configured on the instance. */
+  limits(): Partial<EvidenceLimits>;
+  /** Per-slot timeout in milliseconds. */
+  timeoutMs(profile: string | undefined, task: AiTask, withImages?: boolean): number;
+  /** Host-bound scoped logger. */
+  setLogger?(logger: Logger): void;
+  /** Free boot checks (spec version, wiring); never a billed call. */
+  setup(): Promise<void>;
+  /** Cheap liveness probe; never inference. */
+  health(): Promise<AiHealth>;
+  /** Release resources (unregisters nothing global). */
+  teardown(): Promise<void>;
+}
+export { Ai, AiBudget, AiError, AiErrorCode, AiEvidence, AiHealth, AiImage, AiSummarizeInput, AiSummarizeResult, AiTask, AiUsageReport };
+//# sourceMappingURL=ai.d.mts.map

package/dist/ai.mjs

@@ -0,0 +1,18 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/ai.ts
+/** Failure from {@link Ai.summarize}; carries usage the provider still billed. */
+var AiError = class extends Error {
+	code;
+	usage;
+	constructor(code, message, usage, options) {
+		super(message, options);
+		this.code = code;
+		this.usage = usage;
+		this.name = "AiError";
+	}
+};
+export { AiError };
+
+//# sourceMappingURL=ai.mjs.map

package/dist/ai.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.mjs","names":[],"sources":["../src/ai.ts"],"sourcesContent":["/**\n * AI singleton surface (not an adapter; see ADR 0016).\n *\n * Owned by core so `ShelfOptions.ai` needs no dependency edge into the\n * implementation package (`@storyshelf/ai` already depends on core). The\n * package implements and re-exports {@link Ai}.\n */\nimport type { z } from \"zod\";\nimport type { EvidenceLimits } from \"./insights/limits.ts\";\nimport type { Logger } from \"./logger.ts\";\n\n/** Tasks the AI surface routes: build triage and project health. */\nexport type AiTask = \"triage\" | \"health\";\n\n/** One screenshot sent to a vision-capable model. */\nexport interface AiImage {\n  mediaType: \"image/png\";\n  data: Uint8Array;\n  /** Short caption (story, viewport) shown to the model before the image. */\n  label: string;\n}\n\n/** Evidence handed to the model: delimited text plus optional images. */\nexport interface AiEvidence {\n  text: string;\n  images: AiImage[];\n}\n\n/** Provider-reported (or estimated) token usage for one call. */\nexport interface AiUsageReport {\n  inputTokens: number;\n  outputTokens: number;\n  /** True when the backend reported nothing and a char/4 estimate was used. */\n  estimated: boolean;\n}\n\n/** Input for {@link Ai.summarize}. */\nexport interface AiSummarizeInput<T> {\n  task: AiTask;\n  /** Requested profile; falls back to the default profile with a warning. */\n  profile?: string;\n  system: string;\n  evidence: AiEvidence;\n  /** Result schema (the model output is validated against it). */\n  schema: z.ZodType<T>;\n  signal?: AbortSignal;\n}\n\n/** Result of one successful summarize call. */\nexport interface AiSummarizeResult<T> {\n  object: T;\n  usage: AiUsageReport;\n  profileRequested: string | null;\n  profileEffective: string;\n  model: string;\n  /** Number of images actually sent to the model. */\n  imagesSent: number;\n  /** True when images were dropped (no vision model, or provider rejected them). */\n  visionSkipped: boolean;\n  warnings: string[];\n}\n\n/** Instance-level budget options (all optional). */\nexport interface AiBudget {\n  /** Site-wide daily token cap (UTC day); undefined = no daily cap. */\n  dailyTokens?: number;\n  /** Multiplier applied to tokens counted for calls that sent images. */\n  visionWeight: number;\n  /** Per-project call cap per rolling hour. */\n  perProjectCallsPerHour: number;\n}\n\n/** Why a summarize call failed. */\nexport type AiErrorCode = \"timeout\" | \"provider\" | \"schema\" | \"aborted\" | \"unknown\";\n\n/** Failure from {@link Ai.summarize}; carries usage the provider still billed. */\nexport class AiError extends Error {\n  readonly code: AiErrorCode;\n  readonly usage?: AiUsageReport;\n\n  constructor(\n    code: AiErrorCode,\n    message: string,\n    usage?: AiUsageReport,\n    options?: { cause?: unknown },\n  ) {\n    super(message, options);\n    this.code = code;\n    this.usage = usage;\n    this.name = \"AiError\";\n  }\n}\n\n/** Health probe result. */\nexport interface AiHealth {\n  ok: boolean;\n  detail?: string;\n}\n\n/** The AI surface consumed by `ShelfOptions.ai`. */\nexport interface Ai {\n  /** Run one structured summarize call against a profile's model. */\n  summarize<T>(input: AiSummarizeInput<T>): Promise<AiSummarizeResult<T>>;\n  /** Configured profile names. */\n  profileNames(): string[];\n  /** The profile used when none (or an unknown one) is requested. */\n  defaultProfile(): string;\n  /** Whether the profile has an effective vision model for the task. */\n  hasVision(profile: string | undefined, task: AiTask): boolean;\n  /** Stable identifier of the model a call would use (for hashing/rows). */\n  modelId(profile: string | undefined, task: AiTask, withImages?: boolean): string;\n  /** Budget options (with defaults applied). */\n  budget(): AiBudget;\n  /** Evidence limit overrides configured on the instance. */\n  limits(): Partial<EvidenceLimits>;\n  /** Per-slot timeout in milliseconds. */\n  timeoutMs(profile: string | undefined, task: AiTask, withImages?: boolean): number;\n  /** Host-bound scoped logger. */\n  setLogger?(logger: Logger): void;\n  /** Free boot checks (spec version, wiring); never a billed call. */\n  setup(): Promise<void>;\n  /** Cheap liveness probe; never inference. */\n  health(): Promise<AiHealth>;\n  /** Release resources (unregisters nothing global). */\n  teardown(): Promise<void>;\n}\n"],"mappings":";;;;;AA4EA,IAAa,UAAb,cAA6B,MAAM;CACjC;CACA;CAEA,YACE,MACA,SACA,OACA,SACA;EACA,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;EACZ,KAAK,QAAQ;EACb,KAAK,OAAO;CACd;AACF"}

package/dist/auth.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { AuthUser } from "./types.mjs";
-//#region src/auth.d.ts
 /** Login widget kinds in display order (the shelf plugin contract). */
 type EngineLoginMethodKind = "password" | "oauth" | "passkey" | "sso";
 /**
@@ -96,6 +95,5 @@ declare const MIN_PASSWORD_LENGTH = 12;
  * Single shared parser: cookies, CSRF binding, and table lookups must agree.
  */
 declare function unsignedToken(value: string): string;
-//#endregion
 export { Auth, EngineLoginMethod, EngineLoginMethodKind, EnginePasskeyInfo, EngineSessionInfo, MIN_PASSWORD_LENGTH, unsignedToken };
 //# sourceMappingURL=auth.d.mts.map

package/dist/auth.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/auth.ts
+// src/auth.ts
 /** Minimum password length for local accounts (matches legacy policy). */
 const MIN_PASSWORD_LENGTH = 12;
 /**
@@ -11,7 +11,6 @@ const MIN_PASSWORD_LENGTH = 12;
 function unsignedToken(value) {
 	return value.split(".")[0] ?? "";
 }
-//#endregion
 export { MIN_PASSWORD_LENGTH, unsignedToken };
 
 //# sourceMappingURL=auth.mjs.map

package/dist/brand-packs.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { BrandTheme } from "./config.mjs";
-//#region src/brand-packs.d.ts
 /** One named light/dark theme pair. */
 interface BrandPack {
   light: BrandTheme;
@@ -11,6 +10,5 @@ interface BrandPack {
 declare const brandPacks: Record<string, BrandPack>;
 /** Look up a brand pack by name (undefined for unknown names). */
 declare function brandPack(name: string): BrandPack | undefined;
-//#endregion
 export { BrandPack, brandPack, brandPacks };
 //# sourceMappingURL=brand-packs.d.mts.map

package/dist/brand-packs.mjs

@@ -124,7 +124,6 @@ const brandPacks = {
 function brandPack(name) {
 	return brandPacks[name];
 }
-//#endregion
 export { brandPack, brandPacks };
 
 //# sourceMappingURL=brand-packs.mjs.map

package/dist/capture/a11y/axe-source.d.mts

@@ -0,0 +1,16 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/** Lazy, cached loader for the axe-core browser bundle. */
+/**
+ * Read `axe.min.js` (~550 KB) once per process, on first use. Lazy on purpose: servers that never run
+ * accessibility checks do not touch the file at boot. A failed read is not cached.
+ */
+declare function loadAxeSource(): Promise<string>;
+/**
+ * Wrap the axe source so evaluating it twice in one document is a no-op. Evaluate it as a string
+ * (CDP `Runtime.evaluate`: not bound by the page's CSP and works over remote browsers, since the
+ * source travels over the wire instead of a file path).
+ */
+declare function axeInjectionScript(source: string): string;
+export { axeInjectionScript, loadAxeSource };
+//# sourceMappingURL=axe-source.d.mts.map