@storyshelf/core 0.3.1 → 0.5.3

package/dist/capture/storybook.mjs

@@ -1,16 +1,83 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-import { readFile } from "node:fs/promises";
+import { STATS_FILENAME, loadDepGraph } from "@storyshelf/affected";
 import { join } from "node:path";
+import { readFile } from "node:fs/promises";
 //#region src/capture/storybook.ts
+/** Merge the `chromatic` and `storyshelf` parameter layers (`storyshelf` wins). */
 function mergeParameters(entry) {
 	const merged = {
 		...entry.parameters?.chromatic,
 		...entry.parameters?.storyshelf
 	};
+	if (entry.parameters?.viewport) merged.viewport = entry.parameters.viewport;
 	return Object.keys(merged).length > 0 ? merged : void 0;
 }
+/**
+* The Storybook `MINIMAL_VIEWPORTS` snapshot used to resolve a story's
+* `defaultViewport` name at capture time. Dimensions are the documented
+* stable set; inline `parameters.viewport.viewports` always win over these.
+*/
+const STORYBOOK_BUILTIN_VIEWPORTS = {
+	mobile1: {
+		name: "mobile1",
+		width: 320,
+		height: 568
+	},
+	mobile2: {
+		name: "mobile2",
+		width: 414,
+		height: 896
+	},
+	tablet: {
+		name: "tablet",
+		width: 834,
+		height: 1112
+	},
+	desktop: {
+		name: "desktop",
+		width: 1024,
+		height: 1280
+	}
+};
+/**
+* Resolve the viewports a story should be captured at: the project's global
+* list plus the story's Storybook default viewport (union), deduplicated by
+* name. An unresolvable or duplicate default contributes nothing extra.
+*/
+function resolveStoryViewports(entry, globalViewports) {
+	const resolved = storyViewport(entry);
+	if (resolved && !globalViewports.some((v) => v.name === resolved.name)) return [...globalViewports, resolved];
+	return [...globalViewports];
+}
+function storyViewport(entry) {
+	const config = entry.parameters?.viewport;
+	const name = config?.defaultViewport;
+	const inline = name ? config?.viewports?.[name] : void 0;
+	return name && inline ? viewportFromInline(name, inline) : name ? STORYBOOK_BUILTIN_VIEWPORTS[name] : void 0;
+}
+function viewportFromInline(defaultName, inline) {
+	const dims = viewportDims(inline.styles);
+	return dims ? {
+		name: inline.name ?? defaultName,
+		...dims
+	} : void 0;
+}
+function viewportDims(styles) {
+	const width = pxOf(styles?.width);
+	const height = pxOf(styles?.height);
+	return width !== void 0 && height !== void 0 ? {
+		width,
+		height
+	} : void 0;
+}
+function pxOf(value) {
+	if (typeof value === "number") return Math.round(value);
+	const bare = typeof value === "string" ? value.trim() : "";
+	const match = /^(\d+(?:\.\d+)?)px$/u.exec(bare);
+	return match ? Number(match[1]) : void 0;
+}
 /** Discovers stories from a built Storybook via its index file. */
 var StorybookAdapter = class {
 	name = "storybook";
@@ -30,6 +97,14 @@ var StorybookAdapter = class {
 	buildUrl(baseUrl, storyId) {
 		return `${baseUrl}/iframe.html?id=${encodeURIComponent(storyId)}&viewMode=story`;
 	}
+	/**
+	* Load the Vite stats dependency graph of an extracted build for affected
+	* capture. Resolves `null` when the build ships no usable stats, in which
+	* case the orchestrator renders every story.
+	*/
+	async loadDependencyGraph(source) {
+		return await loadDepGraph(join(source, STATS_FILENAME));
+	}
 	async readIndex(source) {
 		const found = (await Promise.all(["stories.json", "index.json"].map(async (name) => {
 			try {
@@ -44,6 +119,6 @@ var StorybookAdapter = class {
 	}
 };
 //#endregion
-export { StorybookAdapter };
+export { STORYBOOK_BUILTIN_VIEWPORTS, StorybookAdapter, mergeParameters, resolveStoryViewports };
 
 //# sourceMappingURL=storybook.mjs.map

package/dist/capture/storybook.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"storybook.mjs","names":[],"sources":["../../src/capture/storybook.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { StoryEntry, StoryParameters, StorySourceAdapter } from \"./adapter.ts\";\n\ninterface StorybookIndex {\n  v: number;\n  entries: Record<\n    string,\n    {\n      id: string;\n      name: string;\n      title: string;\n      importPath?: string;\n      tags?: string[];\n      type: string;\n      subtype?: string;\n      parameters?: { chromatic?: StoryParameters; storyshelf?: StoryParameters };\n    }\n  >;\n}\n\nfunction mergeParameters(entry: {\n  parameters?: { chromatic?: StoryParameters; storyshelf?: StoryParameters };\n}): StoryParameters | undefined {\n  const merged: StoryParameters = {\n    ...entry.parameters?.chromatic,\n    ...entry.parameters?.storyshelf,\n  };\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\n/** Discovers stories from a built Storybook via its index file. */\nexport class StorybookAdapter implements StorySourceAdapter {\n  readonly name = \"storybook\";\n  readonly screenshotSelector = \"#storybook-root\";\n\n  async discover(source: string): Promise<StoryEntry[]> {\n    const index = await this.readIndex(source);\n    return Object.values(index.entries)\n      .filter((entry) => entry.type !== \"docs\" && entry.subtype !== \"test\")\n      .map((entry) => ({\n        id: entry.id,\n        title: entry.title,\n        name: entry.name,\n        importPath: entry.importPath,\n        tags: entry.tags,\n        type: entry.type === \"docs\" ? \"docs\" : \"story\",\n        parameters: mergeParameters(entry),\n      }));\n  }\n\n  // eslint-disable-next-line class-methods-use-this\n  buildUrl(baseUrl: string, storyId: string): string {\n    return `${baseUrl}/iframe.html?id=${encodeURIComponent(storyId)}&viewMode=story`;\n  }\n\n  // eslint-disable-next-line class-methods-use-this\n  private async readIndex(source: string): Promise<StorybookIndex> {\n    const candidates: string[] = [\"stories.json\", \"index.json\"];\n    const results = await Promise.all(\n      candidates.map(async (name) => {\n        try {\n          const raw = await readFile(join(source, name), \"utf8\");\n          return JSON.parse(raw) as StorybookIndex;\n        } catch {\n          return null;\n        }\n      }),\n    );\n    const found = results.find((index) => index !== null);\n    if (found) {\n      return found;\n    }\n    throw new Error(`No Storybook index found in ${source}`);\n  }\n}\n"],"mappings":";;;;;;AAqBA,SAAS,gBAAgB,OAEO;CAC9B,MAAM,SAA0B;EAC9B,GAAG,MAAM,YAAY;EACrB,GAAG,MAAM,YAAY;CACvB;CACA,OAAO,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,IAAI,SAAS,KAAA;AACnD;;AAGA,IAAa,mBAAb,MAA4D;CAC1D,OAAgB;CAChB,qBAA8B;CAE9B,MAAM,SAAS,QAAuC;EACpD,MAAM,QAAQ,MAAM,KAAK,UAAU,MAAM;EACzC,OAAO,OAAO,OAAO,MAAM,OAAO,CAAC,CAChC,QAAQ,UAAU,MAAM,SAAS,UAAU,MAAM,YAAY,MAAM,CAAC,CACpE,KAAK,WAAW;GACf,IAAI,MAAM;GACV,OAAO,MAAM;GACb,MAAM,MAAM;GACZ,YAAY,MAAM;GAClB,MAAM,MAAM;GACZ,MAAM,MAAM,SAAS,SAAS,SAAS;GACvC,YAAY,gBAAgB,KAAK;EACnC,EAAE;CACN;CAGA,SAAS,SAAiB,SAAyB;EACjD,OAAO,GAAG,QAAQ,kBAAkB,mBAAmB,OAAO,EAAE;CAClE;CAGA,MAAc,UAAU,QAAyC;EAY/D,MAAM,SAAQ,MAVQ,QAAQ,IAC5B,CAF4B,gBAAgB,YAEnC,CAAC,CAAC,IAAI,OAAO,SAAS;GAC7B,IAAI;IACF,MAAM,MAAM,MAAM,SAAS,KAAK,QAAQ,IAAI,GAAG,MAAM;IACrD,OAAO,KAAK,MAAM,GAAG;GACvB,QAAQ;IACN,OAAO;GACT;EACF,CAAC,CACH,EAAA,CACsB,MAAM,UAAU,UAAU,IAAI;EACpD,IAAI,OACF,OAAO;EAET,MAAM,IAAI,MAAM,+BAA+B,QAAQ;CACzD;AACF"}
+{"version":3,"file":"storybook.mjs","names":[],"sources":["../../src/capture/storybook.ts"],"sourcesContent":["import { loadDepGraph, STATS_FILENAME, type DepGraph } from \"@storyshelf/affected\";\nimport { readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type {\n  StoryEntry,\n  StoryParameters,\n  StorySourceAdapter,\n  StoryViewportConfig,\n  StoryViewportDefinition,\n  Viewport,\n} from \"./adapter.ts\";\n\ninterface StorybookIndex {\n  v: number;\n  entries: Record<\n    string,\n    {\n      id: string;\n      name: string;\n      title: string;\n      importPath?: string;\n      tags?: string[];\n      type: string;\n      subtype?: string;\n      parameters?: StorybookParameters;\n    }\n  >;\n}\n\n/** Story parameters as serialized by the Storybook index. */\ninterface StorybookParameters {\n  chromatic?: StoryParameters;\n  storyshelf?: StoryParameters;\n  viewport?: StoryViewportConfig;\n}\n\n/** Merge the `chromatic` and `storyshelf` parameter layers (`storyshelf` wins). */\nexport function mergeParameters(entry: {\n  parameters?: StorybookParameters;\n}): StoryParameters | undefined {\n  const merged: StoryParameters = {\n    ...entry.parameters?.chromatic,\n    ...entry.parameters?.storyshelf,\n  };\n  if (entry.parameters?.viewport) merged.viewport = entry.parameters.viewport;\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\n/**\n * The Storybook `MINIMAL_VIEWPORTS` snapshot used to resolve a story's\n * `defaultViewport` name at capture time. Dimensions are the documented\n * stable set; inline `parameters.viewport.viewports` always win over these.\n */\nexport const STORYBOOK_BUILTIN_VIEWPORTS: Readonly<Record<string, Viewport>> = {\n  mobile1: { name: \"mobile1\", width: 320, height: 568 },\n  mobile2: { name: \"mobile2\", width: 414, height: 896 },\n  tablet: { name: \"tablet\", width: 834, height: 1112 },\n  desktop: { name: \"desktop\", width: 1024, height: 1280 },\n};\n\n/**\n * Resolve the viewports a story should be captured at: the project's global\n * list plus the story's Storybook default viewport (union), deduplicated by\n * name. An unresolvable or duplicate default contributes nothing extra.\n */\nexport function resolveStoryViewports(\n  entry: Pick<StoryEntry, \"parameters\">,\n  globalViewports: Viewport[],\n): Viewport[] {\n  const resolved = storyViewport(entry);\n  if (resolved && !globalViewports.some((v) => v.name === resolved.name)) {\n    return [...globalViewports, resolved];\n  }\n  return [...globalViewports];\n}\n\nfunction storyViewport(entry: Pick<StoryEntry, \"parameters\">): Viewport | undefined {\n  const config = entry.parameters?.viewport;\n  const name = config?.defaultViewport;\n  const inline = name ? config?.viewports?.[name] : undefined;\n  const resolved =\n    name && inline\n      ? viewportFromInline(name, inline)\n      : name\n        ? STORYBOOK_BUILTIN_VIEWPORTS[name]\n        : undefined;\n  return resolved;\n}\n\nfunction viewportFromInline(\n  defaultName: string,\n  inline: StoryViewportDefinition,\n): Viewport | undefined {\n  const dims = viewportDims(inline.styles);\n  return dims ? { name: inline.name ?? defaultName, ...dims } : undefined;\n}\n\nfunction viewportDims(\n  styles: StoryViewportDefinition[\"styles\"] | undefined,\n): { width: number; height: number } | undefined {\n  const width = pxOf(styles?.width);\n  const height = pxOf(styles?.height);\n  return width !== undefined && height !== undefined ? { width, height } : undefined;\n}\n\nfunction pxOf(value: string | number | undefined): number | undefined {\n  if (typeof value === \"number\") return Math.round(value);\n  const bare = typeof value === \"string\" ? value.trim() : \"\";\n  const match = /^(\\d+(?:\\.\\d+)?)px$/u.exec(bare);\n  return match ? Number(match[1]) : undefined;\n}\n\n/** Discovers stories from a built Storybook via its index file. */\nexport class StorybookAdapter implements StorySourceAdapter {\n  readonly name = \"storybook\";\n  readonly screenshotSelector = \"#storybook-root\";\n\n  async discover(source: string): Promise<StoryEntry[]> {\n    const index = await this.readIndex(source);\n    return Object.values(index.entries)\n      .filter((entry) => entry.type !== \"docs\" && entry.subtype !== \"test\")\n      .map((entry) => ({\n        id: entry.id,\n        title: entry.title,\n        name: entry.name,\n        importPath: entry.importPath,\n        tags: entry.tags,\n        type: entry.type === \"docs\" ? \"docs\" : \"story\",\n        parameters: mergeParameters(entry),\n      }));\n  }\n\n  // eslint-disable-next-line class-methods-use-this\n  buildUrl(baseUrl: string, storyId: string): string {\n    return `${baseUrl}/iframe.html?id=${encodeURIComponent(storyId)}&viewMode=story`;\n  }\n\n  /**\n   * Load the Vite stats dependency graph of an extracted build for affected\n   * capture. Resolves `null` when the build ships no usable stats, in which\n   * case the orchestrator renders every story.\n   */\n  // eslint-disable-next-line class-methods-use-this\n  async loadDependencyGraph(source: string): Promise<DepGraph | null> {\n    return await loadDepGraph(join(source, STATS_FILENAME));\n  }\n\n  // eslint-disable-next-line class-methods-use-this\n  private async readIndex(source: string): Promise<StorybookIndex> {\n    const candidates: string[] = [\"stories.json\", \"index.json\"];\n    const results = await Promise.all(\n      candidates.map(async (name) => {\n        try {\n          const raw = await readFile(join(source, name), \"utf8\");\n          return JSON.parse(raw) as StorybookIndex;\n        } catch {\n          return null;\n        }\n      }),\n    );\n    const found = results.find((index) => index !== null);\n    if (found) {\n      return found;\n    }\n    throw new Error(`No Storybook index found in ${source}`);\n  }\n}\n"],"mappings":"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"}

package/dist/capture.d.mts

@@ -1,8 +1,14 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { DEFAULT_VIEWPORTS, StoryEntry, StoryParameters, StorySourceAdapter, Viewport, isDisabledStory, isFlakyStory } from "./capture/adapter.mjs";
-import { CaptureJobOptions, executeCaptureJob } from "./capture/orchestrator.mjs";
+import { DEFAULT_VIEWPORTS, StoryEntry, StoryParameters, StorySourceAdapter, StoryViewportConfig, StoryViewportDefinition, Viewport, isDisabledStory, isFlakyStory } from "./capture/adapter.mjs";
+import { PollableCaptureQueue, PollableJob } from "./adapter/capture-queue.mjs";
 import { CaptureContext, persistCapture } from "./capture/pipeline.mjs";
+import { CaptureAttemptRef, CaptureJobInput, CaptureJobOptions, executeCaptureJob } from "./capture/orchestrator.mjs";
+import { REDIFFABLE_BUILD_STATUSES, RediffDeps, RediffResult, rediffBuild } from "./capture/rediff.mjs";
+import { CaptureDispatchJob, DispatchDeps, createDispatchJob } from "./capture/dispatch.mjs";
+import { INTERRUPTED_ERROR, RecoveryDeps, RecoveryResult, recoverStuckCaptures } from "./capture/recovery.mjs";
 import { InMemoryCaptureQueue, InMemoryCaptureQueueOptions } from "./capture/queue.mjs";
-import { StorybookAdapter } from "./capture/storybook.mjs";
-export { type CaptureContext, type CaptureJobOptions, DEFAULT_VIEWPORTS, InMemoryCaptureQueue, type InMemoryCaptureQueueOptions, type StoryEntry, type StoryParameters, type StorySourceAdapter, StorybookAdapter, type Viewport, executeCaptureJob, isDisabledStory, isFlakyStory, persistCapture };
+import { STORYBOOK_BUILTIN_VIEWPORTS, StorybookAdapter, mergeParameters, resolveStoryViewports } from "./capture/storybook.mjs";
+import { extractStorybookToScratch, persistStorybookStatics } from "./capture/statics.mjs";
+import { BoundingBox, SIZING_DEFAULTS, ScreenshotPlan, SizingOptions, getScreenshotPlan, resolveViewports } from "./capture/sizing.mjs";
+export { type BoundingBox, type CaptureAttemptRef, type CaptureContext, type CaptureDispatchJob, type CaptureJobInput, type CaptureJobOptions, DEFAULT_VIEWPORTS, type DispatchDeps, INTERRUPTED_ERROR, InMemoryCaptureQueue, type InMemoryCaptureQueueOptions, type PollableCaptureQueue, type PollableJob, REDIFFABLE_BUILD_STATUSES, type RecoveryDeps, type RecoveryResult, type RediffDeps, type RediffResult, SIZING_DEFAULTS, STORYBOOK_BUILTIN_VIEWPORTS, type ScreenshotPlan, type SizingOptions, type StoryEntry, type StoryParameters, type StorySourceAdapter, type StoryViewportConfig, type StoryViewportDefinition, StorybookAdapter, type Viewport, createDispatchJob, executeCaptureJob, extractStorybookToScratch, getScreenshotPlan, isDisabledStory, isFlakyStory, mergeParameters, persistCapture, persistStorybookStatics, recoverStuckCaptures, rediffBuild, resolveViewports as resolveCaptureViewports, resolveStoryViewports };

package/dist/capture.mjs

@@ -2,8 +2,13 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { DEFAULT_VIEWPORTS, isDisabledStory, isFlakyStory } from "./capture/adapter.mjs";
+import { STORYBOOK_BUILTIN_VIEWPORTS, StorybookAdapter, mergeParameters, resolveStoryViewports } from "./capture/storybook.mjs";
+import { SIZING_DEFAULTS, getScreenshotPlan, resolveViewports } from "./capture/sizing.mjs";
 import { persistCapture } from "./capture/pipeline.mjs";
-import { StorybookAdapter } from "./capture/storybook.mjs";
+import { extractStorybookToScratch, persistStorybookStatics } from "./capture/statics.mjs";
 import { executeCaptureJob } from "./capture/orchestrator.mjs";
+import { REDIFFABLE_BUILD_STATUSES, rediffBuild } from "./capture/rediff.mjs";
+import { INTERRUPTED_ERROR, recoverStuckCaptures } from "./capture/recovery.mjs";
 import { InMemoryCaptureQueue } from "./capture/queue.mjs";
-export { DEFAULT_VIEWPORTS, InMemoryCaptureQueue, StorybookAdapter, executeCaptureJob, isDisabledStory, isFlakyStory, persistCapture };
+import { createDispatchJob } from "./capture/dispatch.mjs";
+export { DEFAULT_VIEWPORTS, INTERRUPTED_ERROR, InMemoryCaptureQueue, REDIFFABLE_BUILD_STATUSES, SIZING_DEFAULTS, STORYBOOK_BUILTIN_VIEWPORTS, StorybookAdapter, createDispatchJob, executeCaptureJob, extractStorybookToScratch, getScreenshotPlan, isDisabledStory, isFlakyStory, mergeParameters, persistCapture, persistStorybookStatics, recoverStuckCaptures, rediffBuild, resolveViewports as resolveCaptureViewports, resolveStoryViewports };

package/dist/config.d.mts

@@ -1,41 +1,83 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { CaptureQueue } from "./adapter/capture-queue.mjs";
 import { CaptureRunner } from "./adapter/capture-runner.mjs";
 import { DatabaseAdapter } from "./adapter/database.mjs";
+import { EmailSender } from "./adapter/email-sender.mjs";
 import { GitHostProvider } from "./adapter/git-host.mjs";
+import { NotifierProvider } from "./adapters/notifier/provider.mjs";
 import { StorageAdapter } from "./adapter/storage.mjs";
+import { Auth } from "./auth.mjs";
 import { AdapterCategory } from "./adapter/metadata.mjs";
-import { AuthAdapter } from "./adapter/auth.mjs";
+import { CaptureQueue } from "./adapter/capture-queue.mjs";
 import { z } from "zod";
 import { Logger } from "pino";
 //#region src/config.d.ts
 /** Brand color theme for the server-rendered UI. */
 interface BrandTheme {
   accent: string;
+  accentContrast?: string;
+  ring?: string;
   surface: {
     base: string;
     card: string;
+    muted?: string;
+    subtle?: string;
   };
   text: {
     primary: string;
     secondary: string;
+    muted?: string;
   };
   border: string;
+  borderSubtle?: string;
   status: {
     approved: string;
     new: string;
     rejected: string;
   };
+  sidebarBg?: string;
+  topbarBg?: string;
+  radius?: string;
+  radiusSm?: string;
+  shadow?: string;
+}
+/** Text overrides for the auth (login) UI. */
+interface AuthUiConfig {
+  /** Page title, default "Sign in". */
+  title?: string;
+  /** Optional subtitle under the title. */
+  subtitle?: string;
+  /** Password field label, default "Password". */
+  passwordLabel?: string;
+  /** Password field placeholder. */
+  passwordPlaceholder?: string;
+  /** Submit button label, default "Sign in". */
+  submitLabel?: string;
+  /**
+   * Template for SSO buttons, default "Sign in with {label}".
+   * Must contain "{label}" which is replaced with the provider label.
+   */
+  ssoLabelTemplate?: string;
+  /** Help text shown under the form. */
+  helpText?: string;
+  /** Footer text shown at the bottom of the card. */
+  footerText?: string;
 }
 /** Branding overrides for the server-rendered UI. */
 interface UIConfig {
   name?: string;
   logo?: string;
+  /**
+   * @deprecated Ignored. The favicon is the product's own mark, served by the
+   * app itself; set `logo` to rebrand the sidebar instead.
+   */
   favicon?: string;
   lightTheme?: BrandTheme;
   darkTheme?: BrandTheme;
+  auth?: AuthUiConfig;
 }
+/** Default cap for a single Storybook zip upload (1 GiB). */
+declare const DEFAULT_MAX_UPLOAD_BYTES: number;
 /** A viewport in which stories are captured. */
 interface ShelfViewport {
   name: string;
@@ -50,14 +92,54 @@ interface AdapterSnapshot {
   kind: string;
   category: AdapterCategory;
 }
+/** Site-wide notification defaults (brand + sender identity for admin alerts). */
+interface NotificationsConfig {
+  fromEmail?: string;
+  fromName?: string;
+  footerText?: string;
+  slackUsername?: string;
+}
 /** Shelf-level configuration (validated by {@link shelfConfigSchema}). */
 interface ShelfConfig {
   secret?: string;
+  /**
+   * The secret `secret` replaced. Used only to decrypt stored credentials
+   * (webhook, git-token, and notification secrets) written before a rotation;
+   * new writes always use `secret`. Remove once credentials are re-encrypted.
+   */
+  previousSecret?: string;
+  /**
+   * Re-encrypt credentials still under `previousSecret` at boot. Default false:
+   * site admins can run it from the System page instead. No effect without
+   * `previousSecret`.
+   */
+  migrateCredentialsOnBoot?: boolean;
+  /**
+   * Bootstrap site-admin bearer token (`STORYSHELF_ADMIN_TOKEN`/`ADMIN_TOKEN`).
+   * Grants site-admin API access when no admin user exists yet; never
+   * mint sessions from it. Distinct from `secret` (session signing).
+   */
+  adminToken?: string;
   publishedBaseDomain?: string;
+  /**
+   * Public base URL of this deployment (e.g. `https://shelf.example.com`).
+   * Used as the issuer in the `/.well-known/openid-configuration` relying-party
+   * helper document; falls back to the request origin when unset.
+   */
+  publicBaseUrl?: string;
   captureConcurrency?: number;
   scratchDir?: string;
   purgeTtlDays?: number;
+  /** Branch baseline TTL, days; null disables branch GC (default 30). */
+  branchTtlDays?: number | null;
+  /** Branch GC interval, ms; daily sweep via interval clock (default 86_400_000). */
+  branchGcIntervalMs?: number;
   maxUploadBytes?: number;
+  /**
+   * Emit `Server-Timing` response headers (total + db/storage roll-ups).
+   * Opt-in, off by default — some deployments prefer no timing headers.
+   */
+  serverTiming?: boolean;
   /**
    * Max zip size (bytes) eligible for inline statics extraction at upload.
    * Unset (or 0) disables inline extraction — statics land via capture.
@@ -65,19 +147,54 @@ interface ShelfConfig {
   maxInlineUnzipSize?: number;
   viewports?: ShelfViewport[];
   adapters?: Record<string, AdapterSnapshot>;
+  notifications?: NotificationsConfig;
 }
+/** Zod schema validating the shelf-level configuration. */
+declare const shelfConfigSchema: z.ZodType<ShelfConfig>;
+/** Zod schema validating the UI branding configuration. */
+declare const uiConfigSchema: z.ZodType<UIConfig>;
+/**
+ * Parse and validate a raw shelf-level configuration object.
+ *
+ * @param config - Unvalidated configuration record.
+ * @returns The validated shelf configuration.
+ */
+declare function validateConfig(config: Record<string, unknown>): ShelfConfig;
+/**
+ * Parse and validate a raw UI branding configuration object.
+ *
+ * @param config - Unvalidated UI configuration record.
+ * @returns The validated UI configuration.
+ */
+declare function validateUiConfig(config: Record<string, unknown>): UIConfig;
 /** Adapter and configuration options for creating the shelf router. */
 interface ShelfOptions {
   database: DatabaseAdapter;
   storage: StorageAdapter;
   captureRunner?: CaptureRunner;
   captureQueue?: CaptureQueue;
-  auth?: AuthAdapter;
+  auth?: Auth;
   gitHosts?: GitHostProvider[];
+  notifiers?: NotifierProvider[];
+  emailSender?: EmailSender;
   logger?: Logger;
   ui?: UIConfig;
   config?: ShelfConfig;
+  /**
+   * Externally-managed observability SDK handle (e.g. from
+   * `initObservabilityFromEnv`). Structural — core never imports the
+   * observability package. Flushed on `app.lifecycle.teardown()`.
+   */
+  observability?: ObservabilityHandle;
+}
+/**
+ * Shutdown hook for an externally-managed observability SDK.
+ * Structural so core stays dependency-free.
+ */
+interface ObservabilityHandle {
+  /** Flush exporters and release SDK resources. Must be idempotent. */
+  shutdown(): Promise<void>;
 }
 //#endregion
-export { AdapterSnapshot, BrandTheme, ShelfConfig, ShelfOptions, ShelfViewport, UIConfig };
+export { AdapterSnapshot, AuthUiConfig, BrandTheme, DEFAULT_MAX_UPLOAD_BYTES, NotificationsConfig, ObservabilityHandle, ShelfConfig, ShelfOptions, ShelfViewport, UIConfig, shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig };
 //# sourceMappingURL=config.d.mts.map

package/dist/config.mjs

@@ -12,20 +12,31 @@ const viewportSchema = z.object({
 });
 const brandThemeSchema = z.object({
 	accent: z.string(),
+	accentContrast: z.string().optional(),
+	ring: z.string().optional(),
 	surface: z.object({
 		base: z.string(),
-		card: z.string()
+		card: z.string(),
+		muted: z.string().optional(),
+		subtle: z.string().optional()
 	}),
 	text: z.object({
 		primary: z.string(),
-		secondary: z.string()
+		secondary: z.string(),
+		muted: z.string().optional()
 	}),
 	border: z.string(),
+	borderSubtle: z.string().optional(),
 	status: z.object({
 		approved: z.string(),
 		new: z.string(),
 		rejected: z.string()
-	})
+	}),
+	sidebarBg: z.string().optional(),
+	topbarBg: z.string().optional(),
+	radius: z.string().optional(),
+	radiusSm: z.string().optional(),
+	shadow: z.string().optional()
 });
 const adapterSnapshotSchema = z.object({
 	name: z.string(),
@@ -35,31 +46,67 @@ const adapterSnapshotSchema = z.object({
 	category: z.enum([
 		"database",
 		"storage",
-		"auth",
 		"capture-runner",
 		"capture-queue",
-		"git-host"
+		"git-host",
+		"notifier"
 	])
 });
+const authUiConfigSchema = z.object({
+	title: z.string().min(1).optional(),
+	subtitle: z.string().optional(),
+	passwordLabel: z.string().min(1).optional(),
+	passwordPlaceholder: z.string().optional(),
+	submitLabel: z.string().min(1).optional(),
+	ssoLabelTemplate: z.string().min(1).optional(),
+	helpText: z.string().optional(),
+	footerText: z.string().optional()
+});
+const notificationsConfigSchema = z.object({
+	fromEmail: z.string().min(1).optional(),
+	fromName: z.string().min(1).optional(),
+	footerText: z.string().min(1).optional(),
+	slackUsername: z.string().min(1).optional()
+});
 /** Zod schema validating the shelf-level configuration. */
 const shelfConfigSchema = z.object({
 	secret: z.string().min(1).optional(),
+	previousSecret: z.string().min(1).optional(),
+	migrateCredentialsOnBoot: z.boolean().optional(),
+	adminToken: z.string().min(1).optional(),
 	publishedBaseDomain: z.string().optional(),
+	publicBaseUrl: z.string().url().optional(),
 	captureConcurrency: z.number().int().positive().optional(),
 	scratchDir: z.string().optional(),
 	purgeTtlDays: z.number().int().positive().optional(),
+	branchTtlDays: z.number().int().positive().nullable().optional(),
+	branchGcIntervalMs: z.number().int().positive().optional(),
 	maxUploadBytes: z.number().int().positive().optional(),
+	serverTiming: z.boolean().optional(),
 	maxInlineUnzipSize: z.number().int().positive().optional(),
 	viewports: z.array(viewportSchema).min(1, "at least one viewport required").optional(),
-	adapters: z.record(z.string(), adapterSnapshotSchema).optional()
-}).strict();
+	adapters: z.record(z.string(), adapterSnapshotSchema).optional(),
+	notifications: notificationsConfigSchema.optional()
+}).strict().superRefine((config, ctx) => {
+	if (config.previousSecret !== void 0 && config.secret === void 0) ctx.addIssue({
+		code: "custom",
+		path: ["previousSecret"],
+		message: "previousSecret requires secret"
+	});
+	if (config.previousSecret !== void 0 && config.previousSecret === config.secret) ctx.addIssue({
+		code: "custom",
+		path: ["previousSecret"],
+		message: "previousSecret must differ from secret"
+	});
+});
 /** Zod schema validating the UI branding configuration. */
 const uiConfigSchema = z.object({
 	name: z.string().optional(),
 	logo: z.string().url().optional(),
 	favicon: z.string().url().optional(),
 	lightTheme: brandThemeSchema.optional(),
-	darkTheme: brandThemeSchema.optional()
+	darkTheme: brandThemeSchema.optional(),
+	auth: authUiConfigSchema.optional()
 }).strict();
 /**
 * Parse and validate a raw shelf-level configuration object.

package/dist/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport { z } from \"zod\";\nimport type { AuthAdapter } from \"./adapters/auth.ts\";\nimport type { CaptureQueue } from \"./adapters/capture-queue.ts\";\nimport type { CaptureRunner } from \"./adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"./adapters/database.ts\";\nimport type { GitHostProvider } from \"./adapters/git-host/index.ts\";\nimport type { AdapterCategory } from \"./adapters/metadata.ts\";\nimport type { StorageAdapter } from \"./adapters/storage.ts\";\n\n/** Brand color theme for the server-rendered UI. */\nexport interface BrandTheme {\n  accent: string;\n  surface: { base: string; card: string };\n  text: { primary: string; secondary: string };\n  border: string;\n  status: { approved: string; new: string; rejected: string };\n}\n\n/** Branding overrides for the server-rendered UI. */\nexport interface UIConfig {\n  name?: string;\n  logo?: string;\n  favicon?: string;\n  lightTheme?: BrandTheme;\n  darkTheme?: BrandTheme;\n}\n\n/** Default cap for a single Storybook zip upload (1 GiB). */\nexport const DEFAULT_MAX_UPLOAD_BYTES = 1024 * 1024 * 1024;\n\n/** A viewport in which stories are captured. */\nexport interface ShelfViewport {\n  name: string;\n  width: number;\n  height: number;\n}\n\n/** Metadata snapshot of a configured adapter. */\nexport interface AdapterSnapshot {\n  name: string;\n  version: string;\n  description?: string;\n  kind: string;\n  category: AdapterCategory;\n}\n\n/** Shelf-level configuration (validated by {@link shelfConfigSchema}). */\nexport interface ShelfConfig {\n  secret?: string;\n  publishedBaseDomain?: string;\n  captureConcurrency?: number;\n  scratchDir?: string;\n  purgeTtlDays?: number;\n  maxUploadBytes?: number;\n  /**\n   * Max zip size (bytes) eligible for inline statics extraction at upload.\n   * Unset (or 0) disables inline extraction — statics land via capture.\n   */\n  maxInlineUnzipSize?: number;\n  viewports?: ShelfViewport[];\n  adapters?: Record<string, AdapterSnapshot>;\n}\n\nconst viewportSchema: z.ZodType<ShelfViewport> = z.object({\n  name: z.string().min(1),\n  width: z.number().int().positive(),\n  height: z.number().int().positive(),\n});\n\nconst brandThemeSchema = z.object({\n  accent: z.string(),\n  surface: z.object({ base: z.string(), card: z.string() }),\n  text: z.object({ primary: z.string(), secondary: z.string() }),\n  border: z.string(),\n  status: z.object({ approved: z.string(), new: z.string(), rejected: z.string() }),\n});\n\nconst adapterSnapshotSchema: z.ZodType<AdapterSnapshot> = z.object({\n  name: z.string(),\n  version: z.string(),\n  description: z.string().optional(),\n  kind: z.string(),\n  category: z.enum([\"database\", \"storage\", \"auth\", \"capture-runner\", \"capture-queue\", \"git-host\"]),\n});\n\n/** Zod schema validating the shelf-level configuration. */\nexport const shelfConfigSchema: z.ZodType<ShelfConfig> = z\n  .object({\n    secret: z.string().min(1).optional(),\n    publishedBaseDomain: z.string().optional(),\n    captureConcurrency: z.number().int().positive().optional(),\n    scratchDir: z.string().optional(),\n    purgeTtlDays: z.number().int().positive().optional(),\n    maxUploadBytes: z.number().int().positive().optional(),\n    maxInlineUnzipSize: z.number().int().positive().optional(),\n    viewports: z.array(viewportSchema).min(1, \"at least one viewport required\").optional(),\n    adapters: z.record(z.string(), adapterSnapshotSchema).optional(),\n  })\n  .strict();\n\n/** Zod schema validating the UI branding configuration. */\nexport const uiConfigSchema = z\n  .object({\n    name: z.string().optional(),\n    // oxlint-disable-next-line typescript/no-deprecated -- z.string().url() kept for zod v3 API compat\n    logo: z.string().url().optional(),\n    // oxlint-disable-next-line typescript/no-deprecated -- z.string().url() kept for zod v3 API compat\n    favicon: z.string().url().optional(),\n    lightTheme: brandThemeSchema.optional(),\n    darkTheme: brandThemeSchema.optional(),\n  })\n  .strict();\n\n/**\n * Parse and validate a raw shelf-level configuration object.\n *\n * @param config - Unvalidated configuration record.\n * @returns The validated shelf configuration.\n */\nexport function validateConfig(config: Record<string, unknown>): ShelfConfig {\n  const result = shelfConfigSchema.safeParse(config);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `${i.path.join(\".\")}: ${i.message}`).join(\"; \");\n    throw new Error(`Invalid ShelfConfig: ${issues}`);\n  }\n  return result.data;\n}\n\n/**\n * Parse and validate a raw UI branding configuration object.\n *\n * @param config - Unvalidated UI configuration record.\n * @returns The validated UI configuration.\n */\nexport function validateUiConfig(config: Record<string, unknown>): UIConfig {\n  const result = uiConfigSchema.safeParse(config);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `${i.path.join(\".\")}: ${i.message}`).join(\"; \");\n    throw new Error(`Invalid UIConfig: ${issues}`);\n  }\n  return result.data;\n}\n\n/** Adapter and configuration options for creating the shelf router. */\nexport interface ShelfOptions {\n  database: DatabaseAdapter;\n  storage: StorageAdapter;\n  captureRunner?: CaptureRunner;\n  captureQueue?: CaptureQueue;\n  auth?: AuthAdapter;\n  gitHosts?: GitHostProvider[];\n  logger?: Logger;\n  ui?: UIConfig;\n  config?: ShelfConfig;\n}\n"],"mappings":"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"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport { z } from \"zod\";\nimport type { CaptureQueue } from \"./adapters/capture-queue.ts\";\nimport type { CaptureRunner } from \"./adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"./adapters/database.ts\";\nimport type { EmailSender } from \"./adapters/email-sender.ts\";\nimport type { GitHostProvider } from \"./adapters/git-host/index.ts\";\nimport type { AdapterCategory } from \"./adapters/metadata.ts\";\nimport type { NotifierProvider } from \"./adapters/notifier/provider.ts\";\nimport type { StorageAdapter } from \"./adapters/storage.ts\";\nimport type { Auth } from \"./auth.ts\";\n\n/** Brand color theme for the server-rendered UI. */\nexport interface BrandTheme {\n  accent: string;\n  accentContrast?: string;\n  ring?: string;\n  surface: { base: string; card: string; muted?: string; subtle?: string };\n  text: { primary: string; secondary: string; muted?: string };\n  border: string;\n  borderSubtle?: string;\n  status: { approved: string; new: string; rejected: string };\n  sidebarBg?: string;\n  topbarBg?: string;\n  radius?: string;\n  radiusSm?: string;\n  shadow?: string;\n}\n\n/** Text overrides for the auth (login) UI. */\nexport interface AuthUiConfig {\n  /** Page title, default \"Sign in\". */\n  title?: string;\n  /** Optional subtitle under the title. */\n  subtitle?: string;\n  /** Password field label, default \"Password\". */\n  passwordLabel?: string;\n  /** Password field placeholder. */\n  passwordPlaceholder?: string;\n  /** Submit button label, default \"Sign in\". */\n  submitLabel?: string;\n  /**\n   * Template for SSO buttons, default \"Sign in with {label}\".\n   * Must contain \"{label}\" which is replaced with the provider label.\n   */\n  ssoLabelTemplate?: string;\n  /** Help text shown under the form. */\n  helpText?: string;\n  /** Footer text shown at the bottom of the card. */\n  footerText?: string;\n}\n\n/** Branding overrides for the server-rendered UI. */\nexport interface UIConfig {\n  name?: string;\n  logo?: string;\n  /**\n   * @deprecated Ignored. The favicon is the product's own mark, served by the\n   * app itself; set `logo` to rebrand the sidebar instead.\n   */\n  favicon?: string;\n  lightTheme?: BrandTheme;\n  darkTheme?: BrandTheme;\n  auth?: AuthUiConfig;\n}\n\n/** Default cap for a single Storybook zip upload (1 GiB). */\nexport const DEFAULT_MAX_UPLOAD_BYTES = 1024 * 1024 * 1024;\n\n/** A viewport in which stories are captured. */\nexport interface ShelfViewport {\n  name: string;\n  width: number;\n  height: number;\n}\n\n/** Metadata snapshot of a configured adapter. */\nexport interface AdapterSnapshot {\n  name: string;\n  version: string;\n  description?: string;\n  kind: string;\n  category: AdapterCategory;\n}\n\n/** Site-wide notification defaults (brand + sender identity for admin alerts). */\nexport interface NotificationsConfig {\n  fromEmail?: string;\n  fromName?: string;\n  footerText?: string;\n  slackUsername?: string;\n}\n/** Shelf-level configuration (validated by {@link shelfConfigSchema}). */\nexport interface ShelfConfig {\n  secret?: string;\n  /**\n   * The secret `secret` replaced. Used only to decrypt stored credentials\n   * (webhook, git-token, and notification secrets) written before a rotation;\n   * new writes always use `secret`. Remove once credentials are re-encrypted.\n   */\n  previousSecret?: string;\n  /**\n   * Re-encrypt credentials still under `previousSecret` at boot. Default false:\n   * site admins can run it from the System page instead. No effect without\n   * `previousSecret`.\n   */\n  migrateCredentialsOnBoot?: boolean;\n  /**\n   * Bootstrap site-admin bearer token (`STORYSHELF_ADMIN_TOKEN`/`ADMIN_TOKEN`).\n   * Grants site-admin API access when no admin user exists yet; never\n   * mint sessions from it. Distinct from `secret` (session signing).\n   */\n  adminToken?: string;\n  publishedBaseDomain?: string;\n  /**\n   * Public base URL of this deployment (e.g. `https://shelf.example.com`).\n   * Used as the issuer in the `/.well-known/openid-configuration` relying-party\n   * helper document; falls back to the request origin when unset.\n   */\n  publicBaseUrl?: string;\n  captureConcurrency?: number;\n  scratchDir?: string;\n  purgeTtlDays?: number;\n  /** Branch baseline TTL, days; null disables branch GC (default 30). */\n  branchTtlDays?: number | null;\n  /** Branch GC interval, ms; daily sweep via interval clock (default 86_400_000). */\n  branchGcIntervalMs?: number;\n  maxUploadBytes?: number;\n  /**\n   * Emit `Server-Timing` response headers (total + db/storage roll-ups).\n   * Opt-in, off by default — some deployments prefer no timing headers.\n   */\n  serverTiming?: boolean;\n  /**\n   * Max zip size (bytes) eligible for inline statics extraction at upload.\n   * Unset (or 0) disables inline extraction — statics land via capture.\n   */\n  maxInlineUnzipSize?: number;\n  viewports?: ShelfViewport[];\n  adapters?: Record<string, AdapterSnapshot>;\n  notifications?: NotificationsConfig;\n}\n\nconst viewportSchema: z.ZodType<ShelfViewport> = z.object({\n  name: z.string().min(1),\n  width: z.number().int().positive(),\n  height: z.number().int().positive(),\n});\n\nconst brandThemeSchema: z.ZodType<BrandTheme> = z.object({\n  accent: z.string(),\n  accentContrast: z.string().optional(),\n  ring: z.string().optional(),\n  surface: z.object({\n    base: z.string(),\n    card: z.string(),\n    muted: z.string().optional(),\n    subtle: z.string().optional(),\n  }),\n  text: z.object({ primary: z.string(), secondary: z.string(), muted: z.string().optional() }),\n  border: z.string(),\n  borderSubtle: z.string().optional(),\n  status: z.object({ approved: z.string(), new: z.string(), rejected: z.string() }),\n  sidebarBg: z.string().optional(),\n  topbarBg: z.string().optional(),\n  radius: z.string().optional(),\n  radiusSm: z.string().optional(),\n  shadow: z.string().optional(),\n});\n\nconst adapterSnapshotSchema: z.ZodType<AdapterSnapshot> = z.object({\n  name: z.string(),\n  version: z.string(),\n  description: z.string().optional(),\n  kind: z.string(),\n  category: z.enum([\n    \"database\",\n    \"storage\",\n    \"capture-runner\",\n    \"capture-queue\",\n    \"git-host\",\n    \"notifier\",\n  ]),\n});\n\nconst authUiConfigSchema: z.ZodType<AuthUiConfig> = z.object({\n  title: z.string().min(1).optional(),\n  subtitle: z.string().optional(),\n  passwordLabel: z.string().min(1).optional(),\n  passwordPlaceholder: z.string().optional(),\n  submitLabel: z.string().min(1).optional(),\n  ssoLabelTemplate: z.string().min(1).optional(),\n  helpText: z.string().optional(),\n  footerText: z.string().optional(),\n});\n\nconst notificationsConfigSchema: z.ZodType<NotificationsConfig> = z.object({\n  fromEmail: z.string().min(1).optional(),\n  fromName: z.string().min(1).optional(),\n  footerText: z.string().min(1).optional(),\n  slackUsername: z.string().min(1).optional(),\n});\n\n/** Zod schema validating the shelf-level configuration. */\nexport const shelfConfigSchema: z.ZodType<ShelfConfig> = z\n  .object({\n    secret: z.string().min(1).optional(),\n    previousSecret: z.string().min(1).optional(),\n    migrateCredentialsOnBoot: z.boolean().optional(),\n    adminToken: z.string().min(1).optional(),\n    publishedBaseDomain: z.string().optional(),\n    // oxlint-disable-next-line typescript/no-deprecated -- z.string().url() kept for zod v3 API compat\n    publicBaseUrl: z.string().url().optional(),\n    captureConcurrency: z.number().int().positive().optional(),\n    scratchDir: z.string().optional(),\n    purgeTtlDays: z.number().int().positive().optional(),\n    branchTtlDays: z.number().int().positive().nullable().optional(),\n    branchGcIntervalMs: z.number().int().positive().optional(),\n    maxUploadBytes: z.number().int().positive().optional(),\n    serverTiming: z.boolean().optional(),\n    maxInlineUnzipSize: z.number().int().positive().optional(),\n    viewports: z.array(viewportSchema).min(1, \"at least one viewport required\").optional(),\n    adapters: z.record(z.string(), adapterSnapshotSchema).optional(),\n    notifications: notificationsConfigSchema.optional(),\n  })\n  .strict()\n  .superRefine((config, ctx) => {\n    if (config.previousSecret !== undefined && config.secret === undefined) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"previousSecret\"],\n        message: \"previousSecret requires secret\",\n      });\n    }\n    if (config.previousSecret !== undefined && config.previousSecret === config.secret) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"previousSecret\"],\n        message: \"previousSecret must differ from secret\",\n      });\n    }\n  });\n\n/** Zod schema validating the UI branding configuration. */\nexport const uiConfigSchema: z.ZodType<UIConfig> = z\n  .object({\n    name: z.string().optional(),\n    // oxlint-disable-next-line typescript/no-deprecated -- z.string().url() kept for zod v3 API compat\n    logo: z.string().url().optional(),\n    // Accepted but ignored (see UIConfig.favicon) so existing configs keep\n    // validating under .strict().\n    // oxlint-disable-next-line typescript/no-deprecated -- z.string().url() kept for zod v3 API compat\n    favicon: z.string().url().optional(),\n    lightTheme: brandThemeSchema.optional(),\n    darkTheme: brandThemeSchema.optional(),\n    auth: authUiConfigSchema.optional(),\n  })\n  .strict();\n\n/**\n * Parse and validate a raw shelf-level configuration object.\n *\n * @param config - Unvalidated configuration record.\n * @returns The validated shelf configuration.\n */\nexport function validateConfig(config: Record<string, unknown>): ShelfConfig {\n  const result = shelfConfigSchema.safeParse(config);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `${i.path.join(\".\")}: ${i.message}`).join(\"; \");\n    throw new Error(`Invalid ShelfConfig: ${issues}`);\n  }\n  return result.data;\n}\n\n/**\n * Parse and validate a raw UI branding configuration object.\n *\n * @param config - Unvalidated UI configuration record.\n * @returns The validated UI configuration.\n */\nexport function validateUiConfig(config: Record<string, unknown>): UIConfig {\n  const result = uiConfigSchema.safeParse(config);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `${i.path.join(\".\")}: ${i.message}`).join(\"; \");\n    throw new Error(`Invalid UIConfig: ${issues}`);\n  }\n  return result.data;\n}\n\n/** Adapter and configuration options for creating the shelf router. */\nexport interface ShelfOptions {\n  database: DatabaseAdapter;\n  storage: StorageAdapter;\n  captureRunner?: CaptureRunner;\n  captureQueue?: CaptureQueue;\n  auth?: Auth;\n  gitHosts?: GitHostProvider[];\n  notifiers?: NotifierProvider[];\n  emailSender?: EmailSender;\n  logger?: Logger;\n  ui?: UIConfig;\n  config?: ShelfConfig;\n  /**\n   * Externally-managed observability SDK handle (e.g. from\n   * `initObservabilityFromEnv`). Structural — core never imports the\n   * observability package. Flushed on `app.lifecycle.teardown()`.\n   */\n  observability?: ObservabilityHandle;\n}\n\n/**\n * Shutdown hook for an externally-managed observability SDK.\n * Structural so core stays dependency-free.\n */\nexport interface ObservabilityHandle {\n  /** Flush exporters and release SDK resources. Must be idempotent. */\n  shutdown(): Promise<void>;\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,58 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { CaptureQueue } from "./adapter/capture-queue.mjs";
-import { DatabaseAdapter } from "./adapter/database.mjs";
-import { GitHostProvider } from "./adapter/git-host.mjs";
-import { StorageAdapter } from "./adapter/storage.mjs";
-import { BrandTheme, ShelfConfig, ShelfOptions, UIConfig } from "./config.mjs";
-import { createShelfLogger } from "./logger.mjs";
-import { AuthUser } from "./adapter/auth.mjs";
-import { AdapterInitResult } from "./adapter/init.mjs";
-import { OpenAPIHono } from "@hono/zod-openapi";
-//#region src/index.d.ts
-/** Per-request shelf context (adapters, config, user, capture queue). */
-interface ShelfContext {
-  requestId?: string;
-  db: DatabaseAdapter;
-  storage: StorageAdapter;
-  config: ShelfConfig;
-  ui: UIConfig;
-  logger: ReturnType<typeof createShelfLogger>;
-  user: AuthUser | null;
-  authEnabled: boolean;
-  enqueueCapture?: (buildId: string, reqId?: string) => Promise<void>;
-  captureQueue: CaptureQueue | null;
-  gitHosts: GitHostProvider[];
-}
-/** Hono application type carrying the shelf context variables. */
-type ShelfApp = OpenAPIHono<{
-  Variables: ShelfContext;
-}>;
-/** App-scoped adapter lifecycle namespace (single `lifecycle` prop avoids Hono collisions). */
-interface ShelfLifecycle {
-  /** Settled summary of the eager background init run; never rejects. */
-  readonly ready: Promise<AdapterInitResult>;
-  /**
-   * Fail-fast await for server startup (`await app.lifecycle.init()`).
-   * Re-runs init so transient failures are retryable; throws AdapterLifecycleError.
-   * Optional — when skipped, the first request gates on `ready` instead.
-   */
-  init(): Promise<void>;
-  /** Graceful teardown for SIGTERM/SIGINT (`await app.lifecycle.close()`). Idempotent. */
-  close(): Promise<void>;
-}
-/** Hono app with the shelf lifecycle namespace attached. */
-type ShelfRouter = ShelfApp & {
-  readonly lifecycle: ShelfLifecycle;
-};
-/**
- * Create the StoryShelf Hono router with all API routes and HTML pages.
- *
- * Adapter `init` hooks kick off eagerly in the background (the constructor
- * stays synchronous). Await `app.lifecycle.init()` before serving for
- * fail-fast startup, or let the first request gate on settlement.
- */
-declare function createShelfRouter(options: ShelfOptions): ShelfRouter;
-//#endregion
-export { type BrandTheme, ShelfApp, type ShelfConfig, ShelfContext, ShelfLifecycle, type ShelfOptions, ShelfRouter, type UIConfig, createShelfRouter };
-//# sourceMappingURL=index.d.mts.map
+import { BUILD_STATUSES, BuildStatus, ProjectRole, SNAPSHOT_STATUSES, SiteRole, SnapshotStatus, TERMINAL_BUILD_STATUSES } from "./types.mjs";
+import { AdapterSnapshot, BrandTheme, DEFAULT_MAX_UPLOAD_BYTES, ShelfConfig, ShelfOptions, ShelfViewport, UIConfig, shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig } from "./config.mjs";
+import { Logger, LoggerOptions, PinoTransport, createShelfLogger } from "./logger.mjs";
+import { BrandPack, brandPack, brandPacks } from "./brand-packs.mjs";
+export { type AdapterSnapshot, BUILD_STATUSES, type BrandPack, type BrandTheme, type BuildStatus, DEFAULT_MAX_UPLOAD_BYTES, type Logger, type LoggerOptions, type PinoTransport, type ProjectRole, SNAPSHOT_STATUSES, type ShelfConfig, type ShelfOptions, type ShelfViewport, type SiteRole, type SnapshotStatus, TERMINAL_BUILD_STATUSES, type UIConfig, brandPack, brandPacks, createShelfLogger, shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig };