@storyshelf/core 0.1.2 → 0.3.1

package/dist/config.d.mts

@@ -1,14 +1,16 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { AuthAdapter } from "./adapter/auth.mjs";
-import { CaptureQueue } from "./adapters/capture-queue.mjs";
+import { CaptureQueue } from "./adapter/capture-queue.mjs";
 import { CaptureRunner } from "./adapter/capture-runner.mjs";
 import { DatabaseAdapter } from "./adapter/database.mjs";
 import { GitHostProvider } from "./adapter/git-host.mjs";
 import { StorageAdapter } from "./adapter/storage.mjs";
+import { AdapterCategory } from "./adapter/metadata.mjs";
+import { AuthAdapter } from "./adapter/auth.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;
   surface: {
@@ -26,6 +28,7 @@ interface BrandTheme {
     rejected: string;
   };
 }
+/** Branding overrides for the server-rendered UI. */
 interface UIConfig {
   name?: string;
   logo?: string;
@@ -33,25 +36,37 @@ interface UIConfig {
   lightTheme?: BrandTheme;
   darkTheme?: BrandTheme;
 }
-declare const shelfConfigSchema: z.ZodObject<{
-  secret: z.ZodOptional<z.ZodString>;
-  publishedBaseDomain: z.ZodOptional<z.ZodString>;
-  captureConcurrency: z.ZodOptional<z.ZodNumber>;
-  scratchDir: z.ZodOptional<z.ZodString>;
-  purgeTtlDays: z.ZodOptional<z.ZodNumber>;
-  viewports: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    name: z.ZodString;
-    width: z.ZodNumber;
-    height: z.ZodNumber;
-  }, z.core.$strip>>>;
-  adapters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-    name: z.ZodString;
-    version: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    kind: z.ZodString;
-  }, z.core.$strip>>>;
-}, z.core.$strict>;
-type ShelfConfig = z.infer<typeof shelfConfigSchema>;
+/** A viewport in which stories are captured. */
+interface ShelfViewport {
+  name: string;
+  width: number;
+  height: number;
+}
+/** Metadata snapshot of a configured adapter. */
+interface AdapterSnapshot {
+  name: string;
+  version: string;
+  description?: string;
+  kind: string;
+  category: AdapterCategory;
+}
+/** Shelf-level configuration (validated by {@link shelfConfigSchema}). */
+interface ShelfConfig {
+  secret?: string;
+  publishedBaseDomain?: string;
+  captureConcurrency?: number;
+  scratchDir?: string;
+  purgeTtlDays?: number;
+  maxUploadBytes?: number;
+  /**
+   * Max zip size (bytes) eligible for inline statics extraction at upload.
+   * Unset (or 0) disables inline extraction — statics land via capture.
+   */
+  maxInlineUnzipSize?: number;
+  viewports?: ShelfViewport[];
+  adapters?: Record<string, AdapterSnapshot>;
+}
+/** Adapter and configuration options for creating the shelf router. */
 interface ShelfOptions {
   database: DatabaseAdapter;
   storage: StorageAdapter;
@@ -64,5 +79,5 @@ interface ShelfOptions {
   config?: ShelfConfig;
 }
 //#endregion
-export { BrandTheme, ShelfConfig, ShelfOptions, UIConfig, shelfConfigSchema };
+export { AdapterSnapshot, BrandTheme, ShelfConfig, ShelfOptions, ShelfViewport, UIConfig };
 //# sourceMappingURL=config.d.mts.map

package/dist/config.mjs

@@ -3,6 +3,8 @@ import "node:url";
 import.meta.url;
 import { z } from "zod";
 //#region src/config.ts
+/** Default cap for a single Storybook zip upload (1 GiB). */
+const DEFAULT_MAX_UPLOAD_BYTES = 1073741824;
 const viewportSchema = z.object({
 	name: z.string().min(1),
 	width: z.number().int().positive(),
@@ -29,17 +31,29 @@ const adapterSnapshotSchema = z.object({
 	name: z.string(),
 	version: z.string(),
 	description: z.string().optional(),
-	kind: z.string()
+	kind: z.string(),
+	category: z.enum([
+		"database",
+		"storage",
+		"auth",
+		"capture-runner",
+		"capture-queue",
+		"git-host"
+	])
 });
+/** Zod schema validating the shelf-level configuration. */
 const shelfConfigSchema = z.object({
 	secret: z.string().min(1).optional(),
 	publishedBaseDomain: z.string().optional(),
 	captureConcurrency: z.number().int().positive().optional(),
 	scratchDir: z.string().optional(),
 	purgeTtlDays: z.number().int().positive().optional(),
+	maxUploadBytes: z.number().int().positive().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();
+/** Zod schema validating the UI branding configuration. */
 const uiConfigSchema = z.object({
 	name: z.string().optional(),
 	logo: z.string().url().optional(),
@@ -47,6 +61,12 @@ const uiConfigSchema = z.object({
 	lightTheme: brandThemeSchema.optional(),
 	darkTheme: brandThemeSchema.optional()
 }).strict();
+/**
+* Parse and validate a raw shelf-level configuration object.
+*
+* @param config - Unvalidated configuration record.
+* @returns The validated shelf configuration.
+*/
 function validateConfig(config) {
 	const result = shelfConfigSchema.safeParse(config);
 	if (!result.success) {
@@ -55,6 +75,12 @@ function validateConfig(config) {
 	}
 	return result.data;
 }
+/**
+* Parse and validate a raw UI branding configuration object.
+*
+* @param config - Unvalidated UI configuration record.
+* @returns The validated UI configuration.
+*/
 function validateUiConfig(config) {
 	const result = uiConfigSchema.safeParse(config);
 	if (!result.success) {
@@ -64,6 +90,6 @@ function validateUiConfig(config) {
 	return result.data;
 }
 //#endregion
-export { shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig };
+export { DEFAULT_MAX_UPLOAD_BYTES, shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig };
 
 //# sourceMappingURL=config.mjs.map

package/dist/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["import { z } from \"zod\";\nimport type { Logger } from \"pino\";\n\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 { StorageAdapter } from \"./adapters/storage.ts\";\n\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\nexport interface UIConfig {\n  name?: string;\n  logo?: string;\n  favicon?: string;\n  lightTheme?: BrandTheme;\n  darkTheme?: BrandTheme;\n}\n\nconst viewportSchema = 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.object({\n  name: z.string(),\n  version: z.string(),\n  description: z.string().optional(),\n  kind: z.string(),\n});\n\nexport const shelfConfigSchema = 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    viewports: z.array(viewportSchema).min(1, \"at least one viewport required\").optional(),\n    adapters: z.record(z.string(), adapterSnapshotSchema).optional(),\n  })\n  .strict();\n\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\nexport type ShelfConfig = z.infer<typeof shelfConfigSchema>;\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\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\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":";;;;;AA0BA,MAAM,iBAAiB,EAAE,OAAO;CAC9B,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACtB,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;CACjC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;AACpC,CAAC;AAED,MAAM,mBAAmB,EAAE,OAAO;CAChC,QAAQ,EAAE,OAAO;CACjB,SAAS,EAAE,OAAO;EAAE,MAAM,EAAE,OAAO;EAAG,MAAM,EAAE,OAAO;CAAE,CAAC;CACxD,MAAM,EAAE,OAAO;EAAE,SAAS,EAAE,OAAO;EAAG,WAAW,EAAE,OAAO;CAAE,CAAC;CAC7D,QAAQ,EAAE,OAAO;CACjB,QAAQ,EAAE,OAAO;EAAE,UAAU,EAAE,OAAO;EAAG,KAAK,EAAE,OAAO;EAAG,UAAU,EAAE,OAAO;CAAE,CAAC;AAClF,CAAC;AAED,MAAM,wBAAwB,EAAE,OAAO;CACrC,MAAM,EAAE,OAAO;CACf,SAAS,EAAE,OAAO;CAClB,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;CACjC,MAAM,EAAE,OAAO;AACjB,CAAC;AAED,MAAa,oBAAoB,EAC9B,OAAO;CACN,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CACnC,qBAAqB,EAAE,OAAO,CAAC,CAAC,SAAS;CACzC,oBAAoB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACzD,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS;CAChC,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACnD,WAAW,EAAE,MAAM,cAAc,CAAC,CAAC,IAAI,GAAG,gCAAgC,CAAC,CAAC,SAAS;CACrF,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,qBAAqB,CAAC,CAAC,SAAS;AACjE,CAAC,CAAC,CACD,OAAO;AAEV,MAAa,iBAAiB,EAC3B,OAAO;CACN,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;CAE1B,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;CAEhC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;CACnC,YAAY,iBAAiB,SAAS;CACtC,WAAW,iBAAiB,SAAS;AACvC,CAAC,CAAC,CACD,OAAO;AAIV,SAAgB,eAAe,QAA8C;CAC3E,MAAM,SAAS,kBAAkB,UAAU,MAAM;CACjD,IAAI,CAAC,OAAO,SAAS;EACnB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,IAAI;EAC5F,MAAM,IAAI,MAAM,wBAAwB,QAAQ;CAClD;CACA,OAAO,OAAO;AAChB;AAEA,SAAgB,iBAAiB,QAA2C;CAC1E,MAAM,SAAS,eAAe,UAAU,MAAM;CAC9C,IAAI,CAAC,OAAO,SAAS;EACnB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,IAAI;EAC5F,MAAM,IAAI,MAAM,qBAAqB,QAAQ;CAC/C;CACA,OAAO,OAAO;AAChB"}
+{"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":";;;;;;AA6BA,MAAa,2BAA2B;AAmCxC,MAAM,iBAA2C,EAAE,OAAO;CACxD,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACtB,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;CACjC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;AACpC,CAAC;AAED,MAAM,mBAAmB,EAAE,OAAO;CAChC,QAAQ,EAAE,OAAO;CACjB,SAAS,EAAE,OAAO;EAAE,MAAM,EAAE,OAAO;EAAG,MAAM,EAAE,OAAO;CAAE,CAAC;CACxD,MAAM,EAAE,OAAO;EAAE,SAAS,EAAE,OAAO;EAAG,WAAW,EAAE,OAAO;CAAE,CAAC;CAC7D,QAAQ,EAAE,OAAO;CACjB,QAAQ,EAAE,OAAO;EAAE,UAAU,EAAE,OAAO;EAAG,KAAK,EAAE,OAAO;EAAG,UAAU,EAAE,OAAO;CAAE,CAAC;AAClF,CAAC;AAED,MAAM,wBAAoD,EAAE,OAAO;CACjE,MAAM,EAAE,OAAO;CACf,SAAS,EAAE,OAAO;CAClB,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;CACjC,MAAM,EAAE,OAAO;CACf,UAAU,EAAE,KAAK;EAAC;EAAY;EAAW;EAAQ;EAAkB;EAAiB;CAAU,CAAC;AACjG,CAAC;;AAGD,MAAa,oBAA4C,EACtD,OAAO;CACN,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CACnC,qBAAqB,EAAE,OAAO,CAAC,CAAC,SAAS;CACzC,oBAAoB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACzD,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS;CAChC,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACnD,gBAAgB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACrD,oBAAoB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACzD,WAAW,EAAE,MAAM,cAAc,CAAC,CAAC,IAAI,GAAG,gCAAgC,CAAC,CAAC,SAAS;CACrF,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,qBAAqB,CAAC,CAAC,SAAS;AACjE,CAAC,CAAC,CACD,OAAO;;AAGV,MAAa,iBAAiB,EAC3B,OAAO;CACN,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;CAE1B,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;CAEhC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;CACnC,YAAY,iBAAiB,SAAS;CACtC,WAAW,iBAAiB,SAAS;AACvC,CAAC,CAAC,CACD,OAAO;;;;;;;AAQV,SAAgB,eAAe,QAA8C;CAC3E,MAAM,SAAS,kBAAkB,UAAU,MAAM;CACjD,IAAI,CAAC,OAAO,SAAS;EACnB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,IAAI;EAC5F,MAAM,IAAI,MAAM,wBAAwB,QAAQ;CAClD;CACA,OAAO,OAAO;AAChB;;;;;;;AAQA,SAAgB,iBAAiB,QAA2C;CAC1E,MAAM,SAAS,eAAe,UAAU,MAAM;CAC9C,IAAI,CAAC,OAAO,SAAS;EACnB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,IAAI;EAC5F,MAAM,IAAI,MAAM,qBAAqB,QAAQ;CAC/C;CACA,OAAO,OAAO;AAChB"}

package/dist/ddl.d.mts

@@ -1,7 +1,8 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 //#region src/ddl.d.ts
-declare const DDL = "\nCREATE TABLE IF NOT EXISTS projects (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  slug TEXT NOT NULL UNIQUE,\n  git_repository TEXT,\n  git_default_branch TEXT NOT NULL DEFAULT 'main',\n  pixel_threshold REAL NOT NULL DEFAULT 0.1,\n  max_diff_ratio REAL NOT NULL DEFAULT 0.01,\n  public_branch_regex TEXT,\n  storybook_meta TEXT,\n  execute_play INTEGER NOT NULL DEFAULT 0,\n  play_timeout_ms INTEGER NOT NULL DEFAULT 10000,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS project_status_configs (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  provider TEXT NOT NULL,\n  config TEXT NOT NULL,\n  token_encrypted TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS builds (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  git_sha TEXT NOT NULL,\n  git_branch TEXT NOT NULL,\n  is_default INTEGER NOT NULL DEFAULT 0,\n  author_email TEXT,\n  author_name TEXT,\n  message TEXT,\n  public INTEGER NOT NULL DEFAULT 0,\n  status TEXT NOT NULL DEFAULT 'pending',\n  snapshot_count INTEGER NOT NULL DEFAULT 0,\n  changed_count INTEGER NOT NULL DEFAULT 0,\n  approved_count INTEGER NOT NULL DEFAULT 0,\n  rejected_count INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS builds_project_gitsha_idx ON builds (project_id, git_sha);\nCREATE INDEX IF NOT EXISTS builds_git_branch_idx ON builds (git_branch);\nCREATE TABLE IF NOT EXISTS snapshots (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  story_id TEXT NOT NULL,\n  story_name TEXT NOT NULL,\n  story_title TEXT NOT NULL,\n  story_import_path TEXT,\n  viewport_name TEXT NOT NULL DEFAULT 'desktop',\n  viewport_width INTEGER NOT NULL DEFAULT 1280,\n  viewport_height INTEGER NOT NULL DEFAULT 720,\n  screenshot_path TEXT NOT NULL,\n  diff_path TEXT,\n  diff_pixels INTEGER,\n  diff_ratio REAL,\n  diff_passed INTEGER,\n  status TEXT NOT NULL DEFAULT 'pending',\n  reviewed_by TEXT,\n  reviewed_at TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS snapshots_build_story_viewport_idx ON snapshots (build_id, story_id, viewport_name);\nCREATE INDEX IF NOT EXISTS snapshots_build_id_idx ON snapshots (build_id);\nCREATE TABLE IF NOT EXISTS baselines (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  story_id TEXT NOT NULL,\n  viewport_name TEXT NOT NULL DEFAULT 'desktop',\n  branch TEXT NOT NULL,\n  snapshot_id TEXT,\n  screenshot_path TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS baselines_project_story_viewport_branch_idx ON baselines (project_id, story_id, viewport_name, branch);\nCREATE INDEX IF NOT EXISTS baselines_project_story_idx ON baselines (project_id, story_id);\nCREATE TABLE IF NOT EXISTS comments (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  snapshot_id TEXT REFERENCES snapshots(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  body TEXT NOT NULL,\n  parent_id TEXT,\n  resolved INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS comments_build_id_idx ON comments (build_id);\nCREATE TABLE IF NOT EXISTS label_types (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  key TEXT NOT NULL,\n  name TEXT NOT NULL,\n  link_template TEXT,\n  color TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS label_types_project_key_idx ON label_types (project_id, key);\nCREATE TABLE IF NOT EXISTS build_labels (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  type_key TEXT NOT NULL,\n  value TEXT NOT NULL,\n  created_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS build_labels_build_type_value_idx ON build_labels (build_id, type_key, value);\nCREATE TABLE IF NOT EXISTS tokens (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  name TEXT NOT NULL,\n  hash TEXT NOT NULL UNIQUE,\n  last_used_at TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS webhooks (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  url TEXT NOT NULL,\n  secret TEXT NOT NULL,\n  events TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS users (\n  id TEXT PRIMARY KEY,\n  email TEXT NOT NULL UNIQUE,\n  name TEXT NOT NULL,\n  avatar_url TEXT,\n  role TEXT NOT NULL DEFAULT 'member',\n  last_login_at TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS project_members (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  role TEXT NOT NULL DEFAULT 'viewer',\n  created_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS project_members_project_user_idx ON project_members (project_id, user_id);\n";
+/** Canonical SQLite DDL for all StoryShelf tables and indexes. */
+declare const DDL = "\nCREATE TABLE IF NOT EXISTS projects (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  slug TEXT NOT NULL UNIQUE,\n  git_repository TEXT,\n  git_default_branch TEXT NOT NULL DEFAULT 'main',\n  pixel_threshold REAL NOT NULL DEFAULT 0.1,\n  max_diff_ratio REAL NOT NULL DEFAULT 0.01,\n  public_branch_regex TEXT,\n  storybook_meta TEXT,\n  execute_play INTEGER NOT NULL DEFAULT 0,\n  play_timeout_ms INTEGER NOT NULL DEFAULT 10000,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS project_status_configs (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  provider TEXT NOT NULL,\n  config TEXT NOT NULL,\n  token_encrypted TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS builds (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  git_sha TEXT NOT NULL,\n  git_branch TEXT NOT NULL,\n  is_default INTEGER NOT NULL DEFAULT 0,\n  author_email TEXT,\n  author_name TEXT,\n  message TEXT,\n  public INTEGER NOT NULL DEFAULT 0,\n  status TEXT NOT NULL DEFAULT 'pending',\n  snapshot_count INTEGER NOT NULL DEFAULT 0,\n  changed_count INTEGER NOT NULL DEFAULT 0,\n  approved_count INTEGER NOT NULL DEFAULT 0,\n  rejected_count INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS builds_project_gitsha_idx ON builds (project_id, git_sha);\nCREATE INDEX IF NOT EXISTS builds_git_branch_idx ON builds (git_branch);\nCREATE TABLE IF NOT EXISTS snapshots (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  story_id TEXT NOT NULL,\n  story_name TEXT NOT NULL,\n  story_title TEXT NOT NULL,\n  story_import_path TEXT,\n  viewport_name TEXT NOT NULL DEFAULT 'desktop',\n  viewport_width INTEGER NOT NULL DEFAULT 1280,\n  viewport_height INTEGER NOT NULL DEFAULT 720,\n  screenshot_path TEXT NOT NULL,\n  diff_path TEXT,\n  diff_pixels INTEGER,\n  diff_ratio REAL,\n  diff_passed INTEGER,\n  status TEXT NOT NULL DEFAULT 'pending',\n  reviewed_by TEXT,\n  reviewed_at TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS snapshots_build_story_viewport_idx ON snapshots (build_id, story_id, viewport_name);\nCREATE INDEX IF NOT EXISTS snapshots_build_id_idx ON snapshots (build_id);\nCREATE TABLE IF NOT EXISTS baselines (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  story_id TEXT NOT NULL,\n  viewport_name TEXT NOT NULL DEFAULT 'desktop',\n  branch TEXT NOT NULL,\n  snapshot_id TEXT,\n  screenshot_path TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS baselines_project_story_viewport_branch_idx ON baselines (project_id, story_id, viewport_name, branch);\nCREATE INDEX IF NOT EXISTS baselines_project_story_idx ON baselines (project_id, story_id);\nCREATE TABLE IF NOT EXISTS comments (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  snapshot_id TEXT REFERENCES snapshots(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  body TEXT NOT NULL,\n  parent_id TEXT,\n  resolved INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS comments_build_id_idx ON comments (build_id);\nCREATE TABLE IF NOT EXISTS label_types (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  key TEXT NOT NULL,\n  name TEXT NOT NULL,\n  link_template TEXT,\n  color TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS label_types_project_key_idx ON label_types (project_id, key);\nCREATE TABLE IF NOT EXISTS build_labels (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  type_key TEXT NOT NULL,\n  value TEXT NOT NULL,\n  created_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS build_labels_build_type_value_idx ON build_labels (build_id, type_key, value);\nCREATE TABLE IF NOT EXISTS tokens (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  name TEXT NOT NULL,\n  hash TEXT NOT NULL UNIQUE,\n  last_used_at TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS webhooks (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  url TEXT NOT NULL,\n  secret_encrypted TEXT NOT NULL,\n  events TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS users (\n  id TEXT PRIMARY KEY,\n  email TEXT NOT NULL UNIQUE,\n  name TEXT NOT NULL,\n  avatar_url TEXT,\n  role TEXT NOT NULL DEFAULT 'member',\n  last_login_at TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS project_members (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  role TEXT NOT NULL DEFAULT 'viewer',\n  created_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS project_members_project_user_idx ON project_members (project_id, user_id);\n";
 //#endregion
 export { DDL };
 //# sourceMappingURL=ddl.d.mts.map

package/dist/ddl.mjs

@@ -2,6 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 //#region src/ddl.ts
+/** Canonical SQLite DDL for all StoryShelf tables and indexes. */
 const DDL = `
 CREATE TABLE IF NOT EXISTS projects (
   id TEXT PRIMARY KEY,
@@ -128,7 +129,7 @@ CREATE TABLE IF NOT EXISTS webhooks (
   id TEXT PRIMARY KEY,
   project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
   url TEXT NOT NULL,
-  secret TEXT NOT NULL,
+  secret_encrypted TEXT NOT NULL,
   events TEXT,
   created_at TEXT NOT NULL,
   updated_at TEXT NOT NULL

package/dist/ddl.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ddl.mjs","names":[],"sources":["../src/ddl.ts"],"sourcesContent":["export const DDL = `\nCREATE TABLE IF NOT EXISTS projects (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  slug TEXT NOT NULL UNIQUE,\n  git_repository TEXT,\n  git_default_branch TEXT NOT NULL DEFAULT 'main',\n  pixel_threshold REAL NOT NULL DEFAULT 0.1,\n  max_diff_ratio REAL NOT NULL DEFAULT 0.01,\n  public_branch_regex TEXT,\n  storybook_meta TEXT,\n  execute_play INTEGER NOT NULL DEFAULT 0,\n  play_timeout_ms INTEGER NOT NULL DEFAULT 10000,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS project_status_configs (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  provider TEXT NOT NULL,\n  config TEXT NOT NULL,\n  token_encrypted TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS builds (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  git_sha TEXT NOT NULL,\n  git_branch TEXT NOT NULL,\n  is_default INTEGER NOT NULL DEFAULT 0,\n  author_email TEXT,\n  author_name TEXT,\n  message TEXT,\n  public INTEGER NOT NULL DEFAULT 0,\n  status TEXT NOT NULL DEFAULT 'pending',\n  snapshot_count INTEGER NOT NULL DEFAULT 0,\n  changed_count INTEGER NOT NULL DEFAULT 0,\n  approved_count INTEGER NOT NULL DEFAULT 0,\n  rejected_count INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS builds_project_gitsha_idx ON builds (project_id, git_sha);\nCREATE INDEX IF NOT EXISTS builds_git_branch_idx ON builds (git_branch);\nCREATE TABLE IF NOT EXISTS snapshots (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  story_id TEXT NOT NULL,\n  story_name TEXT NOT NULL,\n  story_title TEXT NOT NULL,\n  story_import_path TEXT,\n  viewport_name TEXT NOT NULL DEFAULT 'desktop',\n  viewport_width INTEGER NOT NULL DEFAULT 1280,\n  viewport_height INTEGER NOT NULL DEFAULT 720,\n  screenshot_path TEXT NOT NULL,\n  diff_path TEXT,\n  diff_pixels INTEGER,\n  diff_ratio REAL,\n  diff_passed INTEGER,\n  status TEXT NOT NULL DEFAULT 'pending',\n  reviewed_by TEXT,\n  reviewed_at TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS snapshots_build_story_viewport_idx ON snapshots (build_id, story_id, viewport_name);\nCREATE INDEX IF NOT EXISTS snapshots_build_id_idx ON snapshots (build_id);\nCREATE TABLE IF NOT EXISTS baselines (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  story_id TEXT NOT NULL,\n  viewport_name TEXT NOT NULL DEFAULT 'desktop',\n  branch TEXT NOT NULL,\n  snapshot_id TEXT,\n  screenshot_path TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS baselines_project_story_viewport_branch_idx ON baselines (project_id, story_id, viewport_name, branch);\nCREATE INDEX IF NOT EXISTS baselines_project_story_idx ON baselines (project_id, story_id);\nCREATE TABLE IF NOT EXISTS comments (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  snapshot_id TEXT REFERENCES snapshots(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  body TEXT NOT NULL,\n  parent_id TEXT,\n  resolved INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS comments_build_id_idx ON comments (build_id);\nCREATE TABLE IF NOT EXISTS label_types (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  key TEXT NOT NULL,\n  name TEXT NOT NULL,\n  link_template TEXT,\n  color TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS label_types_project_key_idx ON label_types (project_id, key);\nCREATE TABLE IF NOT EXISTS build_labels (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  type_key TEXT NOT NULL,\n  value TEXT NOT NULL,\n  created_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS build_labels_build_type_value_idx ON build_labels (build_id, type_key, value);\nCREATE TABLE IF NOT EXISTS tokens (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  name TEXT NOT NULL,\n  hash TEXT NOT NULL UNIQUE,\n  last_used_at TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS webhooks (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  url TEXT NOT NULL,\n  secret TEXT NOT NULL,\n  events TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS users (\n  id TEXT PRIMARY KEY,\n  email TEXT NOT NULL UNIQUE,\n  name TEXT NOT NULL,\n  avatar_url TEXT,\n  role TEXT NOT NULL DEFAULT 'member',\n  last_login_at TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS project_members (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  role TEXT NOT NULL DEFAULT 'viewer',\n  created_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS project_members_project_user_idx ON project_members (project_id, user_id);\n`;\n"],"mappings":";;;;AAAA,MAAa,MAAM"}
+{"version":3,"file":"ddl.mjs","names":[],"sources":["../src/ddl.ts"],"sourcesContent":["/** Canonical SQLite DDL for all StoryShelf tables and indexes. */\nexport const DDL = `\nCREATE TABLE IF NOT EXISTS projects (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  slug TEXT NOT NULL UNIQUE,\n  git_repository TEXT,\n  git_default_branch TEXT NOT NULL DEFAULT 'main',\n  pixel_threshold REAL NOT NULL DEFAULT 0.1,\n  max_diff_ratio REAL NOT NULL DEFAULT 0.01,\n  public_branch_regex TEXT,\n  storybook_meta TEXT,\n  execute_play INTEGER NOT NULL DEFAULT 0,\n  play_timeout_ms INTEGER NOT NULL DEFAULT 10000,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS project_status_configs (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  provider TEXT NOT NULL,\n  config TEXT NOT NULL,\n  token_encrypted TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS builds (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  git_sha TEXT NOT NULL,\n  git_branch TEXT NOT NULL,\n  is_default INTEGER NOT NULL DEFAULT 0,\n  author_email TEXT,\n  author_name TEXT,\n  message TEXT,\n  public INTEGER NOT NULL DEFAULT 0,\n  status TEXT NOT NULL DEFAULT 'pending',\n  snapshot_count INTEGER NOT NULL DEFAULT 0,\n  changed_count INTEGER NOT NULL DEFAULT 0,\n  approved_count INTEGER NOT NULL DEFAULT 0,\n  rejected_count INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS builds_project_gitsha_idx ON builds (project_id, git_sha);\nCREATE INDEX IF NOT EXISTS builds_git_branch_idx ON builds (git_branch);\nCREATE TABLE IF NOT EXISTS snapshots (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  story_id TEXT NOT NULL,\n  story_name TEXT NOT NULL,\n  story_title TEXT NOT NULL,\n  story_import_path TEXT,\n  viewport_name TEXT NOT NULL DEFAULT 'desktop',\n  viewport_width INTEGER NOT NULL DEFAULT 1280,\n  viewport_height INTEGER NOT NULL DEFAULT 720,\n  screenshot_path TEXT NOT NULL,\n  diff_path TEXT,\n  diff_pixels INTEGER,\n  diff_ratio REAL,\n  diff_passed INTEGER,\n  status TEXT NOT NULL DEFAULT 'pending',\n  reviewed_by TEXT,\n  reviewed_at TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS snapshots_build_story_viewport_idx ON snapshots (build_id, story_id, viewport_name);\nCREATE INDEX IF NOT EXISTS snapshots_build_id_idx ON snapshots (build_id);\nCREATE TABLE IF NOT EXISTS baselines (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  story_id TEXT NOT NULL,\n  viewport_name TEXT NOT NULL DEFAULT 'desktop',\n  branch TEXT NOT NULL,\n  snapshot_id TEXT,\n  screenshot_path TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS baselines_project_story_viewport_branch_idx ON baselines (project_id, story_id, viewport_name, branch);\nCREATE INDEX IF NOT EXISTS baselines_project_story_idx ON baselines (project_id, story_id);\nCREATE TABLE IF NOT EXISTS comments (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  snapshot_id TEXT REFERENCES snapshots(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  body TEXT NOT NULL,\n  parent_id TEXT,\n  resolved INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS comments_build_id_idx ON comments (build_id);\nCREATE TABLE IF NOT EXISTS label_types (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  key TEXT NOT NULL,\n  name TEXT NOT NULL,\n  link_template TEXT,\n  color TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS label_types_project_key_idx ON label_types (project_id, key);\nCREATE TABLE IF NOT EXISTS build_labels (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  type_key TEXT NOT NULL,\n  value TEXT NOT NULL,\n  created_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS build_labels_build_type_value_idx ON build_labels (build_id, type_key, value);\nCREATE TABLE IF NOT EXISTS tokens (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  name TEXT NOT NULL,\n  hash TEXT NOT NULL UNIQUE,\n  last_used_at TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS webhooks (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  url TEXT NOT NULL,\n  secret_encrypted TEXT NOT NULL,\n  events TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS users (\n  id TEXT PRIMARY KEY,\n  email TEXT NOT NULL UNIQUE,\n  name TEXT NOT NULL,\n  avatar_url TEXT,\n  role TEXT NOT NULL DEFAULT 'member',\n  last_login_at TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS project_members (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  role TEXT NOT NULL DEFAULT 'viewer',\n  created_at TEXT NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS project_members_project_user_idx ON project_members (project_id, user_id);\n`;\n"],"mappings":";;;;;AACA,MAAa,MAAM"}

package/dist/diff/engine.d.mts

@@ -2,6 +2,14 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DiffOptions, DiffResult } from "./options.mjs";
 //#region src/diff/engine.d.ts
+/**
+ * Compare baseline and current screenshots, returning pass/fail and a diff image.
+ *
+ * @param baseline - Baseline PNG buffer.
+ * @param current - Current capture PNG buffer.
+ * @param options - Pixel threshold and ratio limits.
+ * @returns The diff result with pixel counts and an optional overlay image.
+ */
 declare function diffImages(baseline: Buffer, current: Buffer, options: DiffOptions): DiffResult;
 //#endregion
 export { diffImages };

package/dist/diff/engine.mjs

@@ -4,6 +4,14 @@ import.meta.url;
 import pixelmatch from "pixelmatch";
 import { PNG } from "pngjs";
 //#region src/diff/engine.ts
+/**
+* Compare baseline and current screenshots, returning pass/fail and a diff image.
+*
+* @param baseline - Baseline PNG buffer.
+* @param current - Current capture PNG buffer.
+* @param options - Pixel threshold and ratio limits.
+* @returns The diff result with pixel counts and an optional overlay image.
+*/
 function diffImages(baseline, current, options) {
 	const baselinePng = PNG.sync.read(baseline);
 	const currentPng = PNG.sync.read(current);

package/dist/diff/engine.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"engine.mjs","names":[],"sources":["../../src/diff/engine.ts"],"sourcesContent":["import pixelmatch from \"pixelmatch\";\nimport { PNG } from \"pngjs\";\n\nimport type { DiffOptions, DiffResult } from \"./options.ts\";\n\nexport function diffImages(baseline: Buffer, current: Buffer, options: DiffOptions): DiffResult {\n  const baselinePng = PNG.sync.read(baseline);\n  const currentPng = PNG.sync.read(current);\n\n  const baselineDimensions = { width: baselinePng.width, height: baselinePng.height };\n  const currentDimensions = { width: currentPng.width, height: currentPng.height };\n  const sizeChanged =\n    baselineDimensions.width !== currentDimensions.width || baselineDimensions.height !== currentDimensions.height;\n\n  if (sizeChanged) {\n    if (options.failOnSizeChange) {\n      return {\n        passed: false,\n        diffPixels: 0,\n        diffRatio: 1,\n        diffImage: null,\n        baselineDimensions,\n        currentDimensions,\n        sizeChanged: true,\n      };\n    }\n\n    // With `failOnSizeChange: false` a size mismatch is not a failure: diff only\n    // The top-left overlapping region, normalised by its area. Pixelmatch needs\n    // Equal-size inputs, so the larger image is cropped first.\n    const width = Math.min(baselineDimensions.width, currentDimensions.width);\n    const height = Math.min(baselineDimensions.height, currentDimensions.height);\n    const overlap = compareRegions(\n      cropRgba(baselinePng.data, baselineDimensions.width, width, height),\n      cropRgba(currentPng.data, currentDimensions.width, width, height),\n      width,\n      height,\n      options,\n    );\n    const diffRatio = overlap.diffPixels / (width * height);\n    return {\n      passed: diffRatio <= options.maxDiffRatio,\n      diffPixels: overlap.diffPixels,\n      diffRatio,\n      diffImage: overlap.diffImage,\n      baselineDimensions,\n      currentDimensions,\n      sizeChanged: true,\n    };\n  }\n\n  const {width} = baselineDimensions;\n  const {height} = baselineDimensions;\n  const overlap = compareRegions(baselinePng.data, currentPng.data, width, height, options);\n  const diffRatio = overlap.diffPixels / (width * height);\n  return {\n    passed: diffRatio <= options.maxDiffRatio,\n    diffPixels: overlap.diffPixels,\n    diffRatio,\n    diffImage: overlap.diffImage,\n    baselineDimensions,\n    currentDimensions,\n    sizeChanged: false,\n  };\n}\n\nfunction cropRgba(source: Buffer, sourceWidth: number, width: number, height: number): Buffer {\n  const cropped = Buffer.alloc(width * height * 4);\n  const rowBytes = width * 4;\n  const sourceRowBytes = sourceWidth * 4;\n  for (let y = 0; y < height; y += 1) {\n    source.copy(cropped, y * rowBytes, y * sourceRowBytes, y * sourceRowBytes + rowBytes);\n  }\n  return cropped;\n}\n\nfunction compareRegions(\n  baselineData: Buffer,\n  currentData: Buffer,\n  width: number,\n  height: number,\n  options: DiffOptions,\n): { diffPixels: number; diffImage: Buffer } {\n  const diffPng = new PNG({ width, height });\n  const diffPixels = pixelmatch(baselineData, currentData, diffPng.data, width, height, {\n    threshold: options.pixelThreshold,\n    includeAA: options.includeAntialiasing,\n  });\n  return { diffPixels, diffImage: PNG.sync.write(diffPng) };\n}\n"],"mappings":";;;;;;AAKA,SAAgB,WAAW,UAAkB,SAAiB,SAAkC;CAC9F,MAAM,cAAc,IAAI,KAAK,KAAK,QAAQ;CAC1C,MAAM,aAAa,IAAI,KAAK,KAAK,OAAO;CAExC,MAAM,qBAAqB;EAAE,OAAO,YAAY;EAAO,QAAQ,YAAY;CAAO;CAClF,MAAM,oBAAoB;EAAE,OAAO,WAAW;EAAO,QAAQ,WAAW;CAAO;CAI/E,IAFE,mBAAmB,UAAU,kBAAkB,SAAS,mBAAmB,WAAW,kBAAkB,QAEzF;EACf,IAAI,QAAQ,kBACV,OAAO;GACL,QAAQ;GACR,YAAY;GACZ,WAAW;GACX,WAAW;GACX;GACA;GACA,aAAa;EACf;EAMF,MAAM,QAAQ,KAAK,IAAI,mBAAmB,OAAO,kBAAkB,KAAK;EACxE,MAAM,SAAS,KAAK,IAAI,mBAAmB,QAAQ,kBAAkB,MAAM;EAC3E,MAAM,UAAU,eACd,SAAS,YAAY,MAAM,mBAAmB,OAAO,OAAO,MAAM,GAClE,SAAS,WAAW,MAAM,kBAAkB,OAAO,OAAO,MAAM,GAChE,OACA,QACA,OACF;EACA,MAAM,YAAY,QAAQ,cAAc,QAAQ;EAChD,OAAO;GACL,QAAQ,aAAa,QAAQ;GAC7B,YAAY,QAAQ;GACpB;GACA,WAAW,QAAQ;GACnB;GACA;GACA,aAAa;EACf;CACF;CAEA,MAAM,EAAC,UAAS;CAChB,MAAM,EAAC,WAAU;CACjB,MAAM,UAAU,eAAe,YAAY,MAAM,WAAW,MAAM,OAAO,QAAQ,OAAO;CACxF,MAAM,YAAY,QAAQ,cAAc,QAAQ;CAChD,OAAO;EACL,QAAQ,aAAa,QAAQ;EAC7B,YAAY,QAAQ;EACpB;EACA,WAAW,QAAQ;EACnB;EACA;EACA,aAAa;CACf;AACF;AAEA,SAAS,SAAS,QAAgB,aAAqB,OAAe,QAAwB;CAC5F,MAAM,UAAU,OAAO,MAAM,QAAQ,SAAS,CAAC;CAC/C,MAAM,WAAW,QAAQ;CACzB,MAAM,iBAAiB,cAAc;CACrC,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,KAAK,GAC/B,OAAO,KAAK,SAAS,IAAI,UAAU,IAAI,gBAAgB,IAAI,iBAAiB,QAAQ;CAEtF,OAAO;AACT;AAEA,SAAS,eACP,cACA,aACA,OACA,QACA,SAC2C;CAC3C,MAAM,UAAU,IAAI,IAAI;EAAE;EAAO;CAAO,CAAC;CAKzC,OAAO;EAAE,YAJU,WAAW,cAAc,aAAa,QAAQ,MAAM,OAAO,QAAQ;GACpF,WAAW,QAAQ;GACnB,WAAW,QAAQ;EACrB,CACkB;EAAG,WAAW,IAAI,KAAK,MAAM,OAAO;CAAE;AAC1D"}
+{"version":3,"file":"engine.mjs","names":[],"sources":["../../src/diff/engine.ts"],"sourcesContent":["import pixelmatch from \"pixelmatch\";\nimport { PNG } from \"pngjs\";\nimport type { DiffOptions, DiffResult } from \"./options.ts\";\n\n/**\n * Compare baseline and current screenshots, returning pass/fail and a diff image.\n *\n * @param baseline - Baseline PNG buffer.\n * @param current - Current capture PNG buffer.\n * @param options - Pixel threshold and ratio limits.\n * @returns The diff result with pixel counts and an optional overlay image.\n */\nexport function diffImages(baseline: Buffer, current: Buffer, options: DiffOptions): DiffResult {\n  const baselinePng = PNG.sync.read(baseline);\n  const currentPng = PNG.sync.read(current);\n\n  const baselineDimensions = { width: baselinePng.width, height: baselinePng.height };\n  const currentDimensions = { width: currentPng.width, height: currentPng.height };\n  const sizeChanged =\n    baselineDimensions.width !== currentDimensions.width ||\n    baselineDimensions.height !== currentDimensions.height;\n\n  if (sizeChanged) {\n    if (options.failOnSizeChange) {\n      return {\n        passed: false,\n        diffPixels: 0,\n        diffRatio: 1,\n        diffImage: null,\n        baselineDimensions,\n        currentDimensions,\n        sizeChanged: true,\n      };\n    }\n\n    // With `failOnSizeChange: false` a size mismatch is not a failure: diff only\n    // The top-left overlapping region, normalised by its area. Pixelmatch needs\n    // Equal-size inputs, so the larger image is cropped first.\n    const width = Math.min(baselineDimensions.width, currentDimensions.width);\n    const height = Math.min(baselineDimensions.height, currentDimensions.height);\n    const overlap = compareRegions(\n      cropRgba(baselinePng.data, baselineDimensions.width, width, height),\n      cropRgba(currentPng.data, currentDimensions.width, width, height),\n      width,\n      height,\n      options,\n    );\n    const diffRatio = overlap.diffPixels / (width * height);\n    return {\n      passed: diffRatio <= options.maxDiffRatio,\n      diffPixels: overlap.diffPixels,\n      diffRatio,\n      diffImage: overlap.diffImage,\n      baselineDimensions,\n      currentDimensions,\n      sizeChanged: true,\n    };\n  }\n\n  const { width } = baselineDimensions;\n  const { height } = baselineDimensions;\n  const overlap = compareRegions(baselinePng.data, currentPng.data, width, height, options);\n  const diffRatio = overlap.diffPixels / (width * height);\n  return {\n    passed: diffRatio <= options.maxDiffRatio,\n    diffPixels: overlap.diffPixels,\n    diffRatio,\n    diffImage: overlap.diffImage,\n    baselineDimensions,\n    currentDimensions,\n    sizeChanged: false,\n  };\n}\n\nfunction cropRgba(source: Buffer, sourceWidth: number, width: number, height: number): Buffer {\n  const cropped = Buffer.alloc(width * height * 4);\n  const rowBytes = width * 4;\n  const sourceRowBytes = sourceWidth * 4;\n  for (let y = 0; y < height; y += 1) {\n    source.copy(cropped, y * rowBytes, y * sourceRowBytes, y * sourceRowBytes + rowBytes);\n  }\n  return cropped;\n}\n\nfunction compareRegions(\n  baselineData: Buffer,\n  currentData: Buffer,\n  width: number,\n  height: number,\n  options: DiffOptions,\n): { diffPixels: number; diffImage: Buffer } {\n  const diffPng = new PNG({ width, height });\n  const diffPixels = pixelmatch(baselineData, currentData, diffPng.data, width, height, {\n    threshold: options.pixelThreshold,\n    includeAA: options.includeAntialiasing,\n  });\n  return { diffPixels, diffImage: PNG.sync.write(diffPng) };\n}\n"],"mappings":";;;;;;;;;;;;;;AAYA,SAAgB,WAAW,UAAkB,SAAiB,SAAkC;CAC9F,MAAM,cAAc,IAAI,KAAK,KAAK,QAAQ;CAC1C,MAAM,aAAa,IAAI,KAAK,KAAK,OAAO;CAExC,MAAM,qBAAqB;EAAE,OAAO,YAAY;EAAO,QAAQ,YAAY;CAAO;CAClF,MAAM,oBAAoB;EAAE,OAAO,WAAW;EAAO,QAAQ,WAAW;CAAO;CAK/E,IAHE,mBAAmB,UAAU,kBAAkB,SAC/C,mBAAmB,WAAW,kBAAkB,QAEjC;EACf,IAAI,QAAQ,kBACV,OAAO;GACL,QAAQ;GACR,YAAY;GACZ,WAAW;GACX,WAAW;GACX;GACA;GACA,aAAa;EACf;EAMF,MAAM,QAAQ,KAAK,IAAI,mBAAmB,OAAO,kBAAkB,KAAK;EACxE,MAAM,SAAS,KAAK,IAAI,mBAAmB,QAAQ,kBAAkB,MAAM;EAC3E,MAAM,UAAU,eACd,SAAS,YAAY,MAAM,mBAAmB,OAAO,OAAO,MAAM,GAClE,SAAS,WAAW,MAAM,kBAAkB,OAAO,OAAO,MAAM,GAChE,OACA,QACA,OACF;EACA,MAAM,YAAY,QAAQ,cAAc,QAAQ;EAChD,OAAO;GACL,QAAQ,aAAa,QAAQ;GAC7B,YAAY,QAAQ;GACpB;GACA,WAAW,QAAQ;GACnB;GACA;GACA,aAAa;EACf;CACF;CAEA,MAAM,EAAE,UAAU;CAClB,MAAM,EAAE,WAAW;CACnB,MAAM,UAAU,eAAe,YAAY,MAAM,WAAW,MAAM,OAAO,QAAQ,OAAO;CACxF,MAAM,YAAY,QAAQ,cAAc,QAAQ;CAChD,OAAO;EACL,QAAQ,aAAa,QAAQ;EAC7B,YAAY,QAAQ;EACpB;EACA,WAAW,QAAQ;EACnB;EACA;EACA,aAAa;CACf;AACF;AAEA,SAAS,SAAS,QAAgB,aAAqB,OAAe,QAAwB;CAC5F,MAAM,UAAU,OAAO,MAAM,QAAQ,SAAS,CAAC;CAC/C,MAAM,WAAW,QAAQ;CACzB,MAAM,iBAAiB,cAAc;CACrC,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,KAAK,GAC/B,OAAO,KAAK,SAAS,IAAI,UAAU,IAAI,gBAAgB,IAAI,iBAAiB,QAAQ;CAEtF,OAAO;AACT;AAEA,SAAS,eACP,cACA,aACA,OACA,QACA,SAC2C;CAC3C,MAAM,UAAU,IAAI,IAAI;EAAE;EAAO;CAAO,CAAC;CAKzC,OAAO;EAAE,YAJU,WAAW,cAAc,aAAa,QAAQ,MAAM,OAAO,QAAQ;GACpF,WAAW,QAAQ;GACnB,WAAW,QAAQ;EACrB,CACkB;EAAG,WAAW,IAAI,KAAK,MAAM,OAAO;CAAE;AAC1D"}

package/dist/diff/options.d.mts

@@ -35,6 +35,8 @@ interface DiffResult {
   /** Whether the two images have different dimensions. */
   sizeChanged: boolean;
 }
+/** Default diff settings used when no project overrides are present. */
+declare const DEFAULT_DIFF_OPTIONS: DiffOptions;
 //#endregion
-export { DiffOptions, DiffResult };
+export { DEFAULT_DIFF_OPTIONS, DiffOptions, DiffResult };
 //# sourceMappingURL=options.d.mts.map

package/dist/diff.d.mts

@@ -0,0 +1,5 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DEFAULT_DIFF_OPTIONS, DiffOptions, DiffResult } from "./diff/options.mjs";
+import { diffImages } from "./diff/engine.mjs";
+export { DEFAULT_DIFF_OPTIONS, type DiffOptions, type DiffResult, diffImages };

package/dist/diff.mjs

@@ -0,0 +1,6 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { diffImages } from "./diff/engine.mjs";
+import { DEFAULT_DIFF_OPTIONS } from "./diff/options.mjs";
+export { DEFAULT_DIFF_OPTIONS, diffImages };

package/dist/index.d.mts

@@ -1,31 +1,16 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { AdapterMetadata, GitAdapterMetadata } from "./adapters/metadata.mjs";
-import { Logger, LoggerOptions, PinoTransport, createShelfLogger } from "./logger.mjs";
-import { BUILD_STATUSES, BuildStatus, PERSISTENT_LABEL_KEY, PROJECT_ROLES, ProjectRole, RESERVED_LABEL_KEYS, SEEDED_LABEL_KEYS, SITE_ROLES, SNAPSHOT_STATUSES, SiteRole, SnapshotStatus, TERMINAL_BUILD_STATUSES } from "./types.mjs";
-import { AuthAdapter, AuthCallback, AuthUser } from "./adapter/auth.mjs";
-import { DEFAULT_VIEWPORTS, StoryEntry, StorySourceAdapter, Viewport } from "./capture/adapter.mjs";
-import { CaptureJob, CaptureQueue, JobStatus, QueueEntry } from "./adapters/capture-queue.mjs";
-import { CaptureRunner, RenderFailure, RenderResult, RenderedSnapshot } from "./adapter/capture-runner.mjs";
-import { DatabaseAdapter, ListOptions } from "./adapter/database.mjs";
-import { CheckStatus, GitHostAdapter, GitHostProvider } from "./adapter/git-host.mjs";
-import { buildCommentMarkdown, commentMarker, describeStatus } from "./adapter/git-host/helpers.mjs";
+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 { DiffOptions, DiffResult } from "./diff/options.mjs";
-import { diffImages } from "./diff/engine.mjs";
-import { RenderedContent } from "./ui/document.mjs";
-import { StorybookAdapter } from "./capture/storybook.mjs";
-import { Baseline, Build, BuildLabel, Comment, LabelType, Project, ProjectMember, ProjectStatusConfig, Schema, Snapshot, StorybookMeta, Token, User, Webhook, baselines, buildLabels, builds, comments, labelTypes, projectMembers, projectStatusConfigs, projects, schema, snapshots, tokens, users, webhooks } from "./schema.mjs";
-import { CaptureContext, persistCapture } from "./capture/pipeline.mjs";
-import { CaptureJobOptions, executeCaptureJob } from "./capture/orchestrator.mjs";
-import { InMemoryCaptureQueue, InMemoryCaptureQueueOptions } from "./capture/queue.mjs";
-import { Retention } from "./retention/purge.mjs";
-import { UrlBuilder, createUrlBuilder } from "./urls.mjs";
-import { slugify, ulid } from "./utils/ulid.mjs";
-import { baselinePath, diffPath, screenshotPath, storybookDir, storybookZipPath } from "./utils/paths.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;
@@ -39,10 +24,35 @@ interface ShelfContext {
   captureQueue: CaptureQueue | null;
   gitHosts: GitHostProvider[];
 }
+/** Hono application type carrying the shelf context variables. */
 type ShelfApp = OpenAPIHono<{
   Variables: ShelfContext;
 }>;
-declare function createShelfRouter(options: ShelfOptions): ShelfApp;
+/** 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 AdapterMetadata, type AuthAdapter, type AuthCallback, type AuthUser, BUILD_STATUSES, Baseline, type BrandTheme, Build, BuildLabel, BuildStatus, type CaptureContext, type CaptureJob, type CaptureJobOptions, type CaptureQueue, type CaptureRunner, type CheckStatus, Comment, DEFAULT_VIEWPORTS, type DatabaseAdapter, type DiffOptions, type DiffResult, type GitAdapterMetadata, type GitHostAdapter, type GitHostProvider, InMemoryCaptureQueue, type InMemoryCaptureQueueOptions, type JobStatus, LabelType, type ListOptions, type Logger, type LoggerOptions, PERSISTENT_LABEL_KEY, PROJECT_ROLES, type PinoTransport, Project, ProjectMember, ProjectRole, ProjectStatusConfig, type QueueEntry, RESERVED_LABEL_KEYS, type RenderFailure, type RenderResult, type RenderedContent, type RenderedSnapshot, Retention, SEEDED_LABEL_KEYS, SITE_ROLES, SNAPSHOT_STATUSES, Schema, ShelfApp, type ShelfConfig, ShelfContext, type ShelfOptions, SiteRole, Snapshot, SnapshotStatus, type StorageAdapter, type StoryEntry, type StorySourceAdapter, StorybookAdapter, StorybookMeta, TERMINAL_BUILD_STATUSES, Token, type UIConfig, type UrlBuilder, User, type Viewport, Webhook, baselinePath, baselines, buildCommentMarkdown, buildLabels, builds, commentMarker, comments, createShelfLogger, createShelfRouter, createUrlBuilder, describeStatus, diffImages, diffPath, executeCaptureJob, labelTypes, persistCapture, projectMembers, projectStatusConfigs, projects, schema, screenshotPath, slugify, snapshots, storybookDir, storybookZipPath, tokens, ulid, users, webhooks };
+export { type BrandTheme, ShelfApp, type ShelfConfig, ShelfContext, ShelfLifecycle, type ShelfOptions, ShelfRouter, type UIConfig, createShelfRouter };
 //# sourceMappingURL=index.d.mts.map