@storyshelf/core 0.3.2 → 0.5.4

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

@@ -0,0 +1,23 @@
+import __tsdown_shims_path from 'node:path';
+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. */
+declare function collectTeardowns(sources: AdapterSetupSources): HookEntry[];
+/**
+ * Bind the host logger on every adapter that accepts one, scoped by kind.
+ * Adapters without `setLogger` keep today's behavior (silent when no
+ * explicit `options.logger` was passed at construction).
+ */
+declare function bindAdapterLoggers(sources: AdapterSetupSources, logger: Logger): void;
+/** Run setup hooks concurrently; failures are collected, never thrown. */
+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

@@ -0,0 +1,149 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { sanitizeErrorText } from "../utils/redact.mjs";
+//#region src/adapters/setup-runner.ts
+function hookEntry(adapter, hook) {
+	const lifecycle = adapter.lifecycle;
+	if (!lifecycle) return null;
+	const fn = lifecycle[hook];
+	const { category, kind, name } = adapter.metadata;
+	return {
+		category,
+		kind,
+		name,
+		run: async (ctx) => {
+			await fn(ctx);
+		}
+	};
+}
+function pushHook(entries, adapter, hook) {
+	if (!adapter) return;
+	const entry = hookEntry(adapter, hook);
+	if (entry) entries.push(entry);
+}
+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 notifier of sources.notifiers ?? []) pushHook(entries, notifier, hook);
+	pushHook(entries, sources.emailSender, hook);
+}
+/** Collect every available `setup` hook in deterministic order. */
+function collectSetups(sources) {
+	const entries = [];
+	pushAll(entries, sources, "setup");
+	return entries;
+}
+/** Collect every available `teardown` hook in deterministic order. */
+function collectTeardowns(sources) {
+	const entries = [];
+	pushAll(entries, sources, "teardown");
+	return entries;
+}
+/**
+* Bind the host logger on every adapter that accepts one, scoped by kind.
+* Adapters without `setLogger` keep today's behavior (silent when no
+* explicit `options.logger` was passed at construction).
+*/
+function bindAdapterLoggers(sources, logger) {
+	const adapters = [
+		sources.database,
+		sources.storage,
+		sources.captureRunner,
+		sources.captureQueue,
+		...sources.gitHosts ?? [],
+		...sources.notifiers ?? [],
+		sources.emailSender
+	];
+	for (const adapter of adapters) adapter?.setLogger?.(logger.child({ component: adapter.metadata.kind }));
+}
+function messageOf(reason) {
+	const text = reason instanceof Error ? reason.message : String(reason);
+	return sanitizeErrorText(text, 500);
+}
+/** Budgets that trigger slow-hook warnings (observe only, never abort). */
+const SLOW_SETUP_MS = 1e4;
+const SLOW_TEARDOWN_MS = 5e3;
+/** Run one hook with start/done logging and a slow-hook warning. */
+async function runHook(entry, ctx, logger, slowMs) {
+	const { category, kind, name } = entry;
+	const started = Date.now();
+	logger.info({
+		category,
+		kind,
+		name
+	}, "adapter hook start");
+	try {
+		await entry.run(ctx);
+	} finally {
+		const durationMs = Date.now() - started;
+		logger.info({
+			category,
+			kind,
+			name,
+			durationMs
+		}, "adapter hook done");
+		if (durationMs > slowMs) logger.warn({
+			category,
+			kind,
+			name,
+			durationMs,
+			slowMs
+		}, "slow adapter hook");
+	}
+}
+function toFailure(entry, reason) {
+	return {
+		category: entry.category,
+		kind: entry.kind,
+		name: entry.name,
+		error: messageOf(reason)
+	};
+}
+function toResult(entries, outcomes, logger, verb) {
+	const failures = [];
+	for (const [index, entry] of entries.entries()) {
+		const outcome = outcomes[index];
+		if (outcome?.status === "rejected") failures.push(toFailure(entry, outcome.reason));
+	}
+	if (failures.length > 0) logger.error({ failures }, `adapter ${verb} failed`);
+	else logger.info({ count: entries.length }, `adapters ${verb}d`);
+	return {
+		ok: failures.length === 0,
+		failures
+	};
+}
+/** One run of collected hooks with start/done logging and hung visibility. */
+async function runHooks(entries, ctx, logger, verb, slowMs) {
+	let settled = false;
+	const timer = setTimeout(() => {
+		if (!settled) logger.warn({
+			count: entries.length,
+			slowMs
+		}, `adapters ${verb} still running`);
+	}, slowMs);
+	timer.unref?.();
+	try {
+		return toResult(entries, await Promise.allSettled(entries.map(async (entry) => {
+			await runHook(entry, ctx, logger, slowMs);
+		})), logger, verb);
+	} finally {
+		settled = true;
+		clearTimeout(timer);
+	}
+}
+/** Run setup hooks concurrently; failures are collected, never thrown. */
+async function runAdapterSetups(entries, ctx, logger) {
+	return await runHooks(entries, ctx, logger, "setup", SLOW_SETUP_MS);
+}
+/** Run teardown hooks concurrently; failures are collected, never thrown. */
+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

@@ -0,0 +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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"}

package/dist/adapters/validate.d.mts

@@ -0,0 +1,30 @@
+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.
+ */
+declare function validateAdapter(adapter: unknown, expectedCategory: string, slot: string): string[];
+/**
+ * Validate the auth engine shape (auth is optional — undefined is valid).
+ * Returns human-readable reasons, empty when sound.
+ */
+declare function validateAuth(auth?: unknown): string[];
+/**
+ * Validate every adapter in the boot sources. Returns per-adapter failures
+ * (empty when the whole assembly is sound).
+ */
+declare function validateAdapterSources(sources: AdapterSetupSources): AdapterSetupFailure[];
+/**
+ * Validate a full boot assembly: adapters plus the optional auth engine.
+ * App assembly calls this — `ShelfOptions` carries `auth` alongside the
+ * adapter slots, and an invalid engine fails boot like any adapter.
+ */
+declare function validateBootAssembly(sources: AdapterSetupSources & {
+  auth?: unknown;
+}): AdapterSetupFailure[];
+//#endregion
+export { validateAdapter, validateAdapterSources, validateAuth, validateBootAssembly };
+//# sourceMappingURL=validate.d.mts.map

package/dist/adapters/validate.mjs

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

@@ -0,0 +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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"}