@storyshelf/core 0.6.2 → 0.8.0

package/dist/capture.d.mts

@@ -1,14 +1,70 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { DEFAULT_VIEWPORTS, StoryEntry, StoryParameters, StorySourceAdapter, StoryViewportConfig, StoryViewportDefinition, Viewport, isDisabledStory, isFlakyStory } from "./capture/adapter.mjs";
-import { PollableCaptureQueue, PollableJob } from "./adapter/capture-queue.mjs";
+import { DEFAULT_VIEWPORTS, ModeDefinition, ModeMap, ModeViewportValue, StoryEntry, StoryParameters, StorySourceAdapter, StoryViewportConfig, StoryViewportDefinition, Viewport, isDisabledStory, isFlakyStory } from "./capture/adapter.mjs";
+import { LeaseRenewal, PollableCaptureQueue, PollableJob } from "./adapter/capture-queue.mjs";
+import { MAX_BROWSERS, assertBrowserCount, assertSupportedBrowsers, listTargets, parseBrowsers, primaryTargetOf, refusalFor, resolveBrowsers } from "./capture/browsers.mjs";
+import { NO_ORIGIN_REASON, NO_SECRET_REASON, TargetPrerequisites, offeredTargets } from "./capture/targets.mjs";
+import { StorybookUrlSource, storybookUrlSource } from "./capture/storybook-urls.mjs";
+import { DEFAULT_IGNORE_SELECTORS, IgnoreSelectorList, MAX_IGNORE_SELECTORS, cleanIgnoreSelectors, declaredIgnoreSelectors, ignoreStylesheet, isSafeIgnoreSelector } from "./capture/ignore-regions.mjs";
+import { MAX_MODES_PER_STORY, buildGlobalsParam, filterModes, modeSlug, parseModesAllowlist } from "./capture/modes.mjs";
+import { TestResult, TestSummary, parseTestResults, summarizeTests } from "./capture/tests.mjs";
+import { JobLease, ProgressLease } from "./capture/job-lease.mjs";
 import { CaptureContext, persistCapture } from "./capture/pipeline.mjs";
+import { DEFAULT_MAX_INLINE_UNZIP_SIZE, DEFAULT_MAX_UNZIPPED_BYTES, DEFAULT_MAX_ZIP_ENTRIES, ExtractionLimits, FILE_BY_FILE_HINT, PublishLimits, ZipLimitError, extractionLimitsOf, publishRoute, resolvePublishLimits } from "./capture/publish/limits.mjs";
 import { CaptureAttemptRef, CaptureJobInput, CaptureJobOptions, executeCaptureJob } from "./capture/orchestrator.mjs";
-import { REDIFFABLE_BUILD_STATUSES, RediffDeps, RediffResult, rediffBuild } from "./capture/rediff.mjs";
+import { SCRATCH_DIRNAME, SCRATCH_MAX_AGE_MS, ScratchSweepOptions, buildScratchDir, removeBuildScratch, removeJobScratch, sweepOrphanedScratch } from "./capture/scratch.mjs";
+import { BoundingBox, SIZING_DEFAULTS, ScreenshotPlan, SizingOptions, getScreenshotPlan, resolveViewports } from "./capture/sizing.mjs";
+import { EnvironmentChange, Fingerprint, buildFingerprint, changedFields, fingerprintHash, parseFingerprint } from "./capture/fingerprint.mjs";
+import { axeInjectionScript, loadAxeSource } from "./capture/a11y/axe-source.mjs";
+import { MAX_REPORTED_VIOLATIONS, SlimViolation, mapAxeViolations } from "./capture/a11y/map.mjs";
+import { A11Y_ROOT_SELECTOR, A11yRunPlan, resolveA11yRun } from "./capture/a11y/options.mjs";
+import { inPageReadA11yParameters, inPageRunAxe } from "./capture/a11y/in-page.mjs";
+import { BuildStateDeps, BuildStatePublisher, SkipReason, StateTarget } from "./capture/build-state/types.mjs";
+import { deliverBuildState, loadBuild, stateTargets, writeTo } from "./capture/build-state/deliver.mjs";
+import { ACTIVE_POLL_MS, ACTIVE_WINDOW_MS, CANCEL_CHECK_MS, DEFAULT_CADENCE, IDLE_POLL_MS, POLL_JITTER, PollCadence, nextPollDelay } from "./capture/db-queue/cadence.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 { CaptureHandlerOptions, captureDispatchDeps, createCaptureHandler } from "./capture/consumer/capture-handler.mjs";
+import { ConsumerMetrics, DEFAULT_SAMPLE_MS, JobFinishedEvent, JobOutcome, QueueSample, sampleQueue } from "./capture/consumer/metrics.mjs";
+import { DEFAULT_BACKOFF_MS, DEFAULT_MAX_RETRIES, DEFAULT_WAIT_TIME_SECONDS, MAX_BACKOFF_MS, RetryConfig, backoffDelayMs, isFinalAttempt } from "./capture/consumer/retry.mjs";
+import { CaptureConsumer, CaptureConsumerOptions, ConsumerConfig, ConsumerJob, JobHandlers, JobRunContext, KindHandler } from "./capture/consumer/types.mjs";
+import { DEFAULT_LEASE_MS, DEFAULT_RETRIES, DatabaseCaptureQueue, DatabaseCaptureQueueOptions, DatabaseJob, QueueJobInput } from "./capture/db-queue/types.mjs";
+import { NOTIFY_BACKOFF, NOTIFY_MAX_ATTEMPTS, NotifyFailure, NotifyHandlerOptions, NotifyJobQueue, createNotifyEnqueuer, createNotifyHandler, notifyExhausted } from "./capture/build-state/notify-job.mjs";
+import { BuildStatePublisherOptions, PAUSED_MESSAGE, createBuildStatePublisher } from "./capture/build-state/publisher.mjs";
+import { requestOpenBuildStates } from "./capture/build-state/resume.mjs";
+import "./capture/build-state/index.mjs";
+import { REDIFFABLE_BUILD_STATUSES, RediffDeps, RediffResult, rediffBuild } from "./capture/rediff.mjs";
+import { CrashFailureOutcome, failCrashedCapture } from "./capture/crash-failure.mjs";
+import { LEASE_EXHAUSTED_ERROR } from "./capture/db-queue/claim.mjs";
+import { MAX_NACK_DELAY_MS } from "./capture/db-queue/poll.mjs";
+import { DATABASE_QUEUE_METADATA, createDatabaseCaptureQueue } from "./capture/db-queue/index.mjs";
+import { JobLeaseKeeper, LeaseEnd, LeaseKeeperOptions, RENEW_THROTTLE_MS, keepJobLease } from "./capture/db-queue/keeper.mjs";
+import { PollLoop, PollLoopOptions, startPollLoop } from "./capture/db-queue/poll-loop.mjs";
+import { MIN_BLOCKING_POLL_MS, idleDelayMs, isFastEmptyPoll } from "./capture/consumer/idle.mjs";
+import { createCaptureConsumer } from "./capture/consumer/index.mjs";
+import { ChildMessage, ParentMessage } from "./capture/forked/protocol.mjs";
+import { CaptureChildOptions, ChildHost, runCaptureChild } from "./capture/forked/child.mjs";
 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 };
+import { AfterPublishContext, AfterPublishHook, PublishCompleter, PublishCompleterOptions, PublishOutcome, createPublishCompleter } from "./capture/publish/complete.mjs";
+import { PublishHandlerOptions, createPublishHandler } from "./capture/publish/handler.mjs";
+import { PublishFacts, publishVerdict } from "./capture/publish/accept.mjs";
+import { publishingOf } from "./capture/publish/published.mjs";
+import { ExtractionResult, extractZipStream } from "./capture/publish/extract.mjs";
+import { PUBLISH_SCRATCH_ID, PublishZipOptions, publishStoredZip } from "./capture/publish/run.mjs";
+import { ZipInvalidError } from "./capture/publish/invalid-zip.mjs";
+import "./capture/publish/index.mjs";
+import { Catalog, CatalogComponent, CatalogEntry } from "./capture/catalog/types.mjs";
+import { CatalogDeps, catalogueBuild, readCatalog } from "./capture/catalog/catalogue.mjs";
+import { CatalogLoader, CatalogLoaderOptions, DEFAULT_CATALOG_CACHE_SIZE, createCatalogLoader } from "./capture/catalog/load.mjs";
+import { createCatalogHook } from "./capture/catalog/hook.mjs";
+import { EntryChanges, diffEntries, groupComponents, hashEntries, toBuildComponent } from "./capture/catalog/components.mjs";
+import { parseStorybookIndex, parseStorybookIndexText } from "./capture/catalog/parse.mjs";
+import { readPublishedFile, readPublishedFileInfo } from "./capture/catalog/read.mjs";
+import { ComponentBuildRow, ComponentChange, catalogPresence, componentBuildHistory } from "./capture/catalog/history.mjs";
+import "./capture/catalog/index.mjs";
+import { ChildProcessHandle, ParentPort } from "./capture/forked/channel.mjs";
+import { ForkedCaptureHandler, ForkedCaptureOptions, createForkedCaptureHandler } from "./capture/forked/forked-capture.mjs";
+import { CAPTURE_RETRIES_ENV, CAPTURE_SHARD_SIZE_ENV, CAPTURE_WORKER_ROLE, ForkOptions, canForkCaptureChild, forkCaptureChild } from "./capture/forked/fork.mjs";
+import { FORK_MIN_CPUS, FORK_MIN_MEMORY_BYTES, ForkDecision, ForkHost, decideCaptureProcess } from "./capture/forked/decision.mjs";
+import { ComparisonReference, isComparisonImagePath, parseComparisonReference } from "./capture/comparison-reference.mjs";
+export { A11Y_ROOT_SELECTOR, type A11yRunPlan, ACTIVE_POLL_MS, ACTIVE_WINDOW_MS, type AfterPublishContext, type AfterPublishHook, type BoundingBox, type BuildStateDeps, type BuildStatePublisher, type BuildStatePublisherOptions, CANCEL_CHECK_MS, CAPTURE_RETRIES_ENV, CAPTURE_SHARD_SIZE_ENV, CAPTURE_WORKER_ROLE, type CaptureAttemptRef, type CaptureChildOptions, type CaptureConsumer, type CaptureConsumerOptions, type CaptureContext, type CaptureDispatchJob, type CaptureHandlerOptions, type CaptureJobInput, type CaptureJobOptions, type Catalog, type CatalogComponent, type CatalogDeps, type CatalogEntry, type CatalogLoader, type CatalogLoaderOptions, type ChildHost, type ChildMessage, type ChildProcessHandle, type ComparisonReference, type ComponentBuildRow, type ComponentChange, type ConsumerConfig, type ConsumerJob, type ConsumerMetrics, type CrashFailureOutcome, DATABASE_QUEUE_METADATA, DEFAULT_BACKOFF_MS, DEFAULT_CADENCE, DEFAULT_CATALOG_CACHE_SIZE, DEFAULT_IGNORE_SELECTORS, DEFAULT_LEASE_MS, DEFAULT_MAX_INLINE_UNZIP_SIZE, DEFAULT_MAX_RETRIES, DEFAULT_MAX_UNZIPPED_BYTES, DEFAULT_MAX_ZIP_ENTRIES, DEFAULT_RETRIES, DEFAULT_SAMPLE_MS, DEFAULT_VIEWPORTS, DEFAULT_WAIT_TIME_SECONDS, type DatabaseCaptureQueue, type DatabaseCaptureQueueOptions, type DatabaseJob, type DispatchDeps, type EntryChanges, type EnvironmentChange, type ExtractionLimits, type ExtractionResult, FILE_BY_FILE_HINT, FORK_MIN_CPUS, FORK_MIN_MEMORY_BYTES, type Fingerprint, type ForkDecision, type ForkHost, type ForkOptions, type ForkedCaptureHandler, type ForkedCaptureOptions, IDLE_POLL_MS, type IgnoreSelectorList, type JobFinishedEvent, type JobHandlers, type JobLease, type JobLeaseKeeper, type JobOutcome, type JobRunContext, type KindHandler, LEASE_EXHAUSTED_ERROR, type LeaseEnd, type LeaseKeeperOptions, type LeaseRenewal, MAX_BACKOFF_MS, MAX_BROWSERS, MAX_IGNORE_SELECTORS, MAX_MODES_PER_STORY, MAX_NACK_DELAY_MS, MAX_REPORTED_VIOLATIONS, MIN_BLOCKING_POLL_MS, type ModeDefinition, type ModeMap, type ModeViewportValue, NOTIFY_BACKOFF, NOTIFY_MAX_ATTEMPTS, NO_ORIGIN_REASON, NO_SECRET_REASON, type NotifyFailure, type NotifyHandlerOptions, type NotifyJobQueue, PAUSED_MESSAGE, POLL_JITTER, PUBLISH_SCRATCH_ID, type ParentMessage, type ParentPort, type PollCadence, type PollLoop, type PollLoopOptions, type PollableCaptureQueue, type PollableJob, ProgressLease, type PublishCompleter, type PublishCompleterOptions, type PublishFacts, type PublishHandlerOptions, type PublishLimits, type PublishOutcome, type PublishZipOptions, type QueueJobInput, type QueueSample, REDIFFABLE_BUILD_STATUSES, RENEW_THROTTLE_MS, type RediffDeps, type RediffResult, type RetryConfig, SCRATCH_DIRNAME, SCRATCH_MAX_AGE_MS, SIZING_DEFAULTS, STORYBOOK_BUILTIN_VIEWPORTS, type ScratchSweepOptions, type ScreenshotPlan, type SizingOptions, type SkipReason, type SlimViolation, type StateTarget, type StoryEntry, type StoryParameters, type StorySourceAdapter, type StoryViewportConfig, type StoryViewportDefinition, StorybookAdapter, type StorybookUrlSource, type TargetPrerequisites, type TestResult, type TestSummary, type Viewport, ZipInvalidError, ZipLimitError, assertBrowserCount, assertSupportedBrowsers, axeInjectionScript, backoffDelayMs, buildFingerprint, buildGlobalsParam, buildScratchDir, canForkCaptureChild, captureDispatchDeps, catalogPresence, catalogueBuild, changedFields, cleanIgnoreSelectors, componentBuildHistory, createBuildStatePublisher, createCaptureConsumer, createCaptureHandler, createCatalogHook, createCatalogLoader, createDatabaseCaptureQueue, createDispatchJob, createForkedCaptureHandler, createNotifyEnqueuer, createNotifyHandler, createPublishCompleter, createPublishHandler, decideCaptureProcess, declaredIgnoreSelectors, deliverBuildState, diffEntries, executeCaptureJob, extractStorybookToScratch, extractZipStream, extractionLimitsOf, failCrashedCapture, filterModes, fingerprintHash, forkCaptureChild, getScreenshotPlan, groupComponents, hashEntries, idleDelayMs, ignoreStylesheet, inPageReadA11yParameters, inPageRunAxe, isComparisonImagePath, isDisabledStory, isFastEmptyPoll, isFinalAttempt, isFlakyStory, isSafeIgnoreSelector, keepJobLease, listTargets, loadAxeSource, loadBuild, mapAxeViolations, mergeParameters, modeSlug, nextPollDelay, notifyExhausted, offeredTargets, parseBrowsers, parseComparisonReference, parseFingerprint, parseModesAllowlist, parseStorybookIndex, parseStorybookIndexText, parseTestResults, persistCapture, persistStorybookStatics, primaryTargetOf, publishRoute, publishStoredZip, publishVerdict, publishingOf, readCatalog, readPublishedFile, readPublishedFileInfo, rediffBuild, refusalFor, removeBuildScratch, removeJobScratch, requestOpenBuildStates, resolveA11yRun, resolveBrowsers, resolveViewports as resolveCaptureViewports, resolvePublishLimits, resolveStoryViewports, runCaptureChild, sampleQueue, startPollLoop, stateTargets, storybookUrlSource, summarizeTests, sweepOrphanedScratch, toBuildComponent, writeTo };

package/dist/capture.mjs

@@ -1,14 +1,62 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { MAX_BROWSERS, assertBrowserCount, assertSupportedBrowsers, listTargets, parseBrowsers, primaryTargetOf, refusalFor, resolveBrowsers } from "./capture/browsers.mjs";
+import { NO_ORIGIN_REASON, NO_SECRET_REASON, offeredTargets } from "./capture/targets.mjs";
+import { storybookUrlSource } from "./capture/storybook-urls.mjs";
+import { DEFAULT_IGNORE_SELECTORS, MAX_IGNORE_SELECTORS, cleanIgnoreSelectors, declaredIgnoreSelectors, ignoreStylesheet, isSafeIgnoreSelector } from "./capture/ignore-regions.mjs";
+import { MAX_MODES_PER_STORY, buildGlobalsParam, filterModes, modeSlug, parseModesAllowlist } from "./capture/modes.mjs";
 import { DEFAULT_VIEWPORTS, isDisabledStory, isFlakyStory } from "./capture/adapter.mjs";
 import { STORYBOOK_BUILTIN_VIEWPORTS, StorybookAdapter, mergeParameters, resolveStoryViewports } from "./capture/storybook.mjs";
+import { parseTestResults, summarizeTests } from "./capture/tests.mjs";
+import { isComparisonImagePath, parseComparisonReference } from "./capture/comparison-reference.mjs";
 import { SIZING_DEFAULTS, getScreenshotPlan, resolveViewports } from "./capture/sizing.mjs";
+import { buildFingerprint, changedFields, fingerprintHash, parseFingerprint } from "./capture/fingerprint.mjs";
 import { persistCapture } from "./capture/pipeline.mjs";
+import { SCRATCH_DIRNAME, SCRATCH_MAX_AGE_MS, buildScratchDir, removeBuildScratch, removeJobScratch, sweepOrphanedScratch } from "./capture/scratch.mjs";
+import { ZipInvalidError } from "./capture/publish/invalid-zip.mjs";
+import { DEFAULT_MAX_INLINE_UNZIP_SIZE, DEFAULT_MAX_UNZIPPED_BYTES, DEFAULT_MAX_ZIP_ENTRIES, FILE_BY_FILE_HINT, ZipLimitError, extractionLimitsOf, publishRoute, resolvePublishLimits } from "./capture/publish/limits.mjs";
+import { extractZipStream } from "./capture/publish/extract.mjs";
 import { extractStorybookToScratch, persistStorybookStatics } from "./capture/statics.mjs";
 import { executeCaptureJob } from "./capture/orchestrator.mjs";
+import { axeInjectionScript, loadAxeSource } from "./capture/a11y/axe-source.mjs";
+import { inPageReadA11yParameters, inPageRunAxe } from "./capture/a11y/in-page.mjs";
+import { MAX_REPORTED_VIOLATIONS, mapAxeViolations } from "./capture/a11y/map.mjs";
+import { A11Y_ROOT_SELECTOR, resolveA11yRun } from "./capture/a11y/options.mjs";
+import { publishingOf } from "./capture/publish/published.mjs";
+import { deliverBuildState, loadBuild, stateTargets, writeTo } from "./capture/build-state/deliver.mjs";
+import { DEFAULT_BACKOFF_MS, DEFAULT_MAX_RETRIES, DEFAULT_WAIT_TIME_SECONDS, MAX_BACKOFF_MS, backoffDelayMs, isFinalAttempt } from "./capture/consumer/retry.mjs";
+import { NOTIFY_BACKOFF, NOTIFY_MAX_ATTEMPTS, createNotifyEnqueuer, createNotifyHandler, notifyExhausted } from "./capture/build-state/notify-job.mjs";
+import { PAUSED_MESSAGE, createBuildStatePublisher } from "./capture/build-state/publisher.mjs";
+import { requestOpenBuildStates } from "./capture/build-state/resume.mjs";
 import { REDIFFABLE_BUILD_STATUSES, rediffBuild } from "./capture/rediff.mjs";
-import { INTERRUPTED_ERROR, recoverStuckCaptures } from "./capture/recovery.mjs";
-import { InMemoryCaptureQueue } from "./capture/queue.mjs";
+import { failCrashedCapture } from "./capture/crash-failure.mjs";
+import { ProgressLease } from "./capture/job-lease.mjs";
+import { LEASE_EXHAUSTED_ERROR } from "./capture/db-queue/claim.mjs";
+import { MAX_NACK_DELAY_MS } from "./capture/db-queue/poll.mjs";
+import { DEFAULT_LEASE_MS, DEFAULT_RETRIES } from "./capture/db-queue/types.mjs";
+import { DATABASE_QUEUE_METADATA, createDatabaseCaptureQueue } from "./capture/db-queue/index.mjs";
+import { ACTIVE_POLL_MS, ACTIVE_WINDOW_MS, CANCEL_CHECK_MS, DEFAULT_CADENCE, IDLE_POLL_MS, POLL_JITTER, nextPollDelay } from "./capture/db-queue/cadence.mjs";
+import { RENEW_THROTTLE_MS, keepJobLease } from "./capture/db-queue/keeper.mjs";
+import { startPollLoop } from "./capture/db-queue/poll-loop.mjs";
 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 };
+import { captureDispatchDeps, createCaptureHandler } from "./capture/consumer/capture-handler.mjs";
+import { MIN_BLOCKING_POLL_MS, idleDelayMs, isFastEmptyPoll } from "./capture/consumer/idle.mjs";
+import { DEFAULT_SAMPLE_MS, sampleQueue } from "./capture/consumer/metrics.mjs";
+import { createCaptureConsumer } from "./capture/consumer/index.mjs";
+import { CAPTURE_RETRIES_ENV, CAPTURE_SHARD_SIZE_ENV, CAPTURE_WORKER_ROLE, canForkCaptureChild, forkCaptureChild } from "./capture/forked/fork.mjs";
+import { runCaptureChild } from "./capture/forked/child.mjs";
+import { PUBLISH_SCRATCH_ID, publishStoredZip } from "./capture/publish/run.mjs";
+import { createPublishHandler } from "./capture/publish/handler.mjs";
+import { publishVerdict } from "./capture/publish/accept.mjs";
+import { createPublishCompleter } from "./capture/publish/complete.mjs";
+import { createCatalogHook } from "./capture/catalog/hook.mjs";
+import { diffEntries, groupComponents, hashEntries, toBuildComponent } from "./capture/catalog/components.mjs";
+import { parseStorybookIndex, parseStorybookIndexText } from "./capture/catalog/parse.mjs";
+import { readPublishedFile, readPublishedFileInfo } from "./capture/catalog/read.mjs";
+import { catalogueBuild, readCatalog } from "./capture/catalog/catalogue.mjs";
+import { DEFAULT_CATALOG_CACHE_SIZE, createCatalogLoader } from "./capture/catalog/load.mjs";
+import { catalogPresence, componentBuildHistory } from "./capture/catalog/history.mjs";
+import { createForkedCaptureHandler } from "./capture/forked/forked-capture.mjs";
+import { FORK_MIN_CPUS, FORK_MIN_MEMORY_BYTES, decideCaptureProcess } from "./capture/forked/decision.mjs";
+export { A11Y_ROOT_SELECTOR, ACTIVE_POLL_MS, ACTIVE_WINDOW_MS, CANCEL_CHECK_MS, CAPTURE_RETRIES_ENV, CAPTURE_SHARD_SIZE_ENV, CAPTURE_WORKER_ROLE, DATABASE_QUEUE_METADATA, DEFAULT_BACKOFF_MS, DEFAULT_CADENCE, DEFAULT_CATALOG_CACHE_SIZE, DEFAULT_IGNORE_SELECTORS, DEFAULT_LEASE_MS, DEFAULT_MAX_INLINE_UNZIP_SIZE, DEFAULT_MAX_RETRIES, DEFAULT_MAX_UNZIPPED_BYTES, DEFAULT_MAX_ZIP_ENTRIES, DEFAULT_RETRIES, DEFAULT_SAMPLE_MS, DEFAULT_VIEWPORTS, DEFAULT_WAIT_TIME_SECONDS, FILE_BY_FILE_HINT, FORK_MIN_CPUS, FORK_MIN_MEMORY_BYTES, IDLE_POLL_MS, LEASE_EXHAUSTED_ERROR, MAX_BACKOFF_MS, MAX_BROWSERS, MAX_IGNORE_SELECTORS, MAX_MODES_PER_STORY, MAX_NACK_DELAY_MS, MAX_REPORTED_VIOLATIONS, MIN_BLOCKING_POLL_MS, NOTIFY_BACKOFF, NOTIFY_MAX_ATTEMPTS, NO_ORIGIN_REASON, NO_SECRET_REASON, PAUSED_MESSAGE, POLL_JITTER, PUBLISH_SCRATCH_ID, ProgressLease, REDIFFABLE_BUILD_STATUSES, RENEW_THROTTLE_MS, SCRATCH_DIRNAME, SCRATCH_MAX_AGE_MS, SIZING_DEFAULTS, STORYBOOK_BUILTIN_VIEWPORTS, StorybookAdapter, ZipInvalidError, ZipLimitError, assertBrowserCount, assertSupportedBrowsers, axeInjectionScript, backoffDelayMs, buildFingerprint, buildGlobalsParam, buildScratchDir, canForkCaptureChild, captureDispatchDeps, catalogPresence, catalogueBuild, changedFields, cleanIgnoreSelectors, componentBuildHistory, createBuildStatePublisher, createCaptureConsumer, createCaptureHandler, createCatalogHook, createCatalogLoader, createDatabaseCaptureQueue, createDispatchJob, createForkedCaptureHandler, createNotifyEnqueuer, createNotifyHandler, createPublishCompleter, createPublishHandler, decideCaptureProcess, declaredIgnoreSelectors, deliverBuildState, diffEntries, executeCaptureJob, extractStorybookToScratch, extractZipStream, extractionLimitsOf, failCrashedCapture, filterModes, fingerprintHash, forkCaptureChild, getScreenshotPlan, groupComponents, hashEntries, idleDelayMs, ignoreStylesheet, inPageReadA11yParameters, inPageRunAxe, isComparisonImagePath, isDisabledStory, isFastEmptyPoll, isFinalAttempt, isFlakyStory, isSafeIgnoreSelector, keepJobLease, listTargets, loadAxeSource, loadBuild, mapAxeViolations, mergeParameters, modeSlug, nextPollDelay, notifyExhausted, offeredTargets, parseBrowsers, parseComparisonReference, parseFingerprint, parseModesAllowlist, parseStorybookIndex, parseStorybookIndexText, parseTestResults, persistCapture, persistStorybookStatics, primaryTargetOf, publishRoute, publishStoredZip, publishVerdict, publishingOf, readCatalog, readPublishedFile, readPublishedFileInfo, rediffBuild, refusalFor, removeBuildScratch, removeJobScratch, requestOpenBuildStates, resolveA11yRun, resolveBrowsers, resolveViewports as resolveCaptureViewports, resolvePublishLimits, resolveStoryViewports, runCaptureChild, sampleQueue, startPollLoop, stateTargets, storybookUrlSource, summarizeTests, sweepOrphanedScratch, toBuildComponent, writeTo };

package/dist/config.d.mts

@@ -2,16 +2,17 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { CaptureRunner } from "./adapter/capture-runner.mjs";
 import { DatabaseAdapter } from "./adapter/database.mjs";
+import { DesignProvider } from "./adapter/design.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 { Ai } from "./ai.mjs";
 import { Auth } from "./auth.mjs";
+import { DEFAULT_SCRATCH_DIR, resolveShelfOptions } from "./options.mjs";
+import { ALLOW_SERVERLESS_ENV, assertServerless, isServerlessHost } from "./serverless.mjs";
 import { AdapterCategory } from "./adapter/metadata.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;
@@ -99,6 +100,17 @@ interface NotificationsConfig {
   footerText?: string;
   slackUsername?: string;
 }
+/** Longest browser-private freshness a signed capture asset may be given, in seconds (1 hour). */
+declare const MAX_CAPTURE_ASSET_CACHE_SECONDS = 3600;
+/** Signed Storybook asset serving for remote capture browsers (ADR 0007, decision 5). */
+interface CaptureAssetsConfig {
+  /**
+   * Opt-in browser-private freshness of capture-scoped signed assets, in whole seconds from 0 to
+   * {@link MAX_CAPTURE_ASSET_CACHE_SECONDS}. 0 (default) keeps every signed answer `no-store`. A
+   * positive value is a cap: the answer's `max-age` never exceeds the grant's remaining lifetime.
+   */
+  cacheMaxAgeSeconds?: number;
+}
 /** Shelf-level configuration (validated by {@link shelfConfigSchema}). */
 interface ShelfConfig {
   secret?: string;
@@ -127,7 +139,10 @@ interface ShelfConfig {
    * helper document; falls back to the request origin when unset.
    */
   publicBaseUrl?: string;
-  captureConcurrency?: number;
+  /**
+   * Working directory for capture and inline statics extraction. Defaults to
+   * `<os.tmpdir()>/storyshelf`; publishing and capture extract there.
+   */
   scratchDir?: string;
   purgeTtlDays?: number;
   /** Branch baseline TTL, days; null disables branch GC (default 30). */
@@ -140,15 +155,29 @@ interface ShelfConfig {
    * Opt-in, off by default — some deployments prefer no timing headers.
    */
   serverTiming?: boolean;
+  /** Persist gzip variants for published Storybook files (default off). */
+  publishedCompression?: boolean;
+  /** Signed Storybook asset serving for remote capture browsers; see {@link CaptureAssetsConfig}. */
+  captureAssets?: CaptureAssetsConfig;
   /**
-   * Max zip size (bytes) eligible for inline statics extraction at upload.
-   * Unset (or 0) disables inline extraction — statics land via capture.
+   * Largest zip (bytes) extracted inline in the upload request; a larger zip is published by a
+   * `publish` job (or refused with 413 on a host that runs no consumer). The count is taken
+   * while the upload streams, never from `Content-Length`. Default 50 MB; `0` sends every zip to
+   * a `publish` job.
    */
   maxInlineUnzipSize?: number;
+  /** Most entries an uploaded Storybook zip may hold (default 50 000); more fails the publish. */
+  maxZipEntries?: number;
+  /**
+   * Most uncompressed bytes an uploaded Storybook zip may expand to (default 2 GiB), counted while
+   * extracting; more fails the publish. The compressed size is no bound on its own.
+   */
+  maxUnzippedBytes?: number;
   viewports?: ShelfViewport[];
   adapters?: Record<string, AdapterSnapshot>;
-  notifications?: NotificationsConfig;
 }
+/** Zod schema validating `notifications.config`. */
+declare const notificationsConfigSchema: z.ZodType<NotificationsConfig>;
 /** Zod schema validating the shelf-level configuration. */
 declare const shelfConfigSchema: z.ZodType<ShelfConfig>;
 /** Zod schema validating the UI branding configuration. */
@@ -167,16 +196,110 @@ declare function validateConfig(config: Record<string, unknown>): ShelfConfig;
  * @returns The validated UI configuration.
  */
 declare function validateUiConfig(config: Record<string, unknown>): UIConfig;
+/** Testing options: what renders, how many run at once, and how screenshots are compared. */
+interface ShelfTestingOptions {
+  /** Pure renderer. Required: `testing` without a `runner` throws. */
+  runner: CaptureRunner;
+  /** Jobs this instance runs at once; auto-sized from CPU and memory when unset. */
+  concurrency?: number;
+  /**
+   * Retries after a first failed attempt before a capture job fails for good (default 2: three
+   * attempts). One limit covers failed attempts, lost leases and forked-child crashes.
+   */
+  retries?: number;
+  /**
+   * Lease of a job of the database queue, in seconds (default 300: 5 minutes). A running job
+   * renews it on a heartbeat (every `min(30 s, lease / 3)`) and on progress, so a stage that prints
+   * nothing is not redelivered while its process lives; a crashed holder's job is claimed by
+   * another instance once the lease runs out, so a shorter lease recovers crashes sooner.
+   */
+  leaseSeconds?: number;
+  /**
+   * Module run in a forked capture child (it calls `runCaptureChild` from `@storyshelf/core/capture`).
+   * The app consumes the queue and pushes each job to the child over IPC. Needs `runner`, which
+   * serves as the in-process fallback.
+   */
+  workerEntry?: string;
+  /**
+   * Split a big build across the queue: captures (story x viewport x engine) per shard. A build of
+   * up to twice this size still renders in one piece. Unset keeps every build in one job. Needs
+   * `runner`. With `workerEntry` the forked child plans and renders shards and puts them on the
+   * database queue itself.
+   */
+  shardSize?: number;
+  /**
+   * Requests per minute one client IP may make to the signed Storybook URL route, `/_s/<token>/*`
+   * (ADR 0007, decision 5). Default 6000, enough for a render fetching thousands of assets from one
+   * farm IP; a larger farm behind one address raises it. Over the limit the route answers `429`
+   * before it looks at the token, so the answer says nothing about a token's validity.
+   */
+  storybookUrlRateLimit?: number;
+  /**
+   * Where captures run. `auto` (default) forks when `workerEntry` is set and the host can afford
+   * a second process; `in-process` never forks; `fork` forks regardless of the host and fails at
+   * boot if it cannot.
+   */
+  mode?: "auto" | "in-process" | "fork";
+  /** Screenshot comparison, shared by capture and the re-diff endpoint. */
+  compare?: ShelfCompareOptions;
+  /** Image library selection; see {@link ShelfImagesOptions}. */
+  images?: ShelfImagesOptions;
+  /**
+   * Clock and timers of the database job queue. Tests inject a manual clock so lease and poll
+   * transitions do not depend on wall time; production leaves it unset (`Date.now` and the global
+   * timers).
+   */
+  queueClock?: {
+    now: () => number;
+    timers: {
+      setTimeout(callback: () => void, ms: number): unknown;
+      clearTimeout(handle: unknown): void;
+    };
+  };
+}
+/** Notification options: who can deliver, over which transport, with what branding. */
+interface ShelfNotificationsOptions {
+  /** Provider adapters (Slack, Teams, email, ...); a channel's `provider` must name one of these. */
+  notifiers?: NotifierProvider[];
+  /** Email transport. Listed here so its setup/teardown/validation hooks run with the app's. */
+  emailSender?: EmailSender;
+  /** Site-wide brand and sender settings for outgoing notifications. */
+  config?: NotificationsConfig;
+}
+/** Comparison options. */
+interface ShelfCompareOptions {
+  /**
+   * Worker threads for pixel diffs: default CPU count minus one (min 1), `0` diffs on the main
+   * thread. Takes precedence over `STORYSHELF_DIFF_WORKERS`.
+   */
+  threads?: number;
+}
+/** Image-handling options: which library decodes, encodes and resizes the PNGs. */
+interface ShelfImagesOptions {
+  /**
+   * Image library for diffs, diff overlays and AI thumbnails: `"pngjs"` (default, pure JavaScript,
+   * runs anywhere) or `"sharp"` (native, several times faster on large PNGs; needs the optional
+   * `sharp` package installed). Falls back to `STORYSHELF_IMAGE_ENGINE`. The pixel comparison is
+   * pixelmatch either way, so verdicts match.
+   */
+  engine?: "pngjs" | "sharp";
+}
 /** Adapter and configuration options for creating the shelf router. */
 interface ShelfOptions {
   database: DatabaseAdapter;
   storage: StorageAdapter;
-  captureRunner?: CaptureRunner;
-  captureQueue?: CaptureQueue;
+  /**
+   * Testing (render + diff in the background). Absent means Storybook hosting only: no renderer,
+   * no queue, and the tuning below is unreachable rather than silently ignored.
+   */
+  testing?: ShelfTestingOptions;
   auth?: Auth;
-  gitHosts?: GitHostProvider[];
-  notifiers?: NotifierProvider[];
-  emailSender?: EmailSender;
+  /** AI insights surface (ADR 0016). Set ⇒ AI on site-wide; absent ⇒ off. */
+  ai?: Ai;
+  /** Design-tool providers (Figma, …) that resolve links, metadata and previews. */
+  design?: DesignProvider[];
+  /** Notification subsystem: providers, the email transport, and shared brand/sender settings. */
+  notifications?: ShelfNotificationsOptions;
   logger?: Logger;
   ui?: UIConfig;
   config?: ShelfConfig;
@@ -195,6 +318,5 @@ interface ObservabilityHandle {
   /** Flush exporters and release SDK resources. Must be idempotent. */
   shutdown(): Promise<void>;
 }
-//#endregion
-export { AdapterSnapshot, AuthUiConfig, BrandTheme, DEFAULT_MAX_UPLOAD_BYTES, NotificationsConfig, ObservabilityHandle, ShelfConfig, ShelfOptions, ShelfViewport, UIConfig, shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig };
+export { ALLOW_SERVERLESS_ENV, AdapterSnapshot, AuthUiConfig, BrandTheme, CaptureAssetsConfig, DEFAULT_MAX_UPLOAD_BYTES, DEFAULT_SCRATCH_DIR, MAX_CAPTURE_ASSET_CACHE_SECONDS, NotificationsConfig, ObservabilityHandle, ShelfCompareOptions, ShelfConfig, ShelfImagesOptions, ShelfNotificationsOptions, ShelfOptions, ShelfTestingOptions, ShelfViewport, UIConfig, assertServerless, isServerlessHost, notificationsConfigSchema, resolveShelfOptions, shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig };
 //# sourceMappingURL=config.d.mts.map

package/dist/config.mjs

@@ -1,10 +1,14 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { DEFAULT_SCRATCH_DIR, resolveShelfOptions } from "./options.mjs";
+import { ALLOW_SERVERLESS_ENV, assertServerless, isServerlessHost } from "./serverless.mjs";
 import { z } from "zod";
-//#region src/config.ts
+// src/config.ts
 /** Default cap for a single Storybook zip upload (1 GiB). */
 const DEFAULT_MAX_UPLOAD_BYTES = 1073741824;
+/** Longest browser-private freshness a signed capture asset may be given, in seconds (1 hour). */
+const MAX_CAPTURE_ASSET_CACHE_SECONDS = 3600;
 const viewportSchema = z.object({
 	name: z.string().min(1),
 	width: z.number().int().positive(),
@@ -48,7 +52,7 @@ const adapterSnapshotSchema = z.object({
 		"storage",
 		"capture-runner",
 		"capture-queue",
-		"git-host",
+		"design",
 		"notifier"
 	])
 });
@@ -62,6 +66,7 @@ const authUiConfigSchema = z.object({
 	helpText: z.string().optional(),
 	footerText: z.string().optional()
 });
+/** Zod schema validating `notifications.config`. */
 const notificationsConfigSchema = z.object({
 	fromEmail: z.string().min(1).optional(),
 	fromName: z.string().min(1).optional(),
@@ -76,17 +81,19 @@ const shelfConfigSchema = z.object({
 	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(),
+	publishedCompression: z.boolean().optional(),
+	captureAssets: z.object({ cacheMaxAgeSeconds: z.number().int().min(0).max(MAX_CAPTURE_ASSET_CACHE_SECONDS).optional() }).strict().optional(),
+	maxInlineUnzipSize: z.number().int().min(0).optional(),
+	maxZipEntries: z.number().int().positive().optional(),
+	maxUnzippedBytes: z.number().int().positive().optional(),
 	viewports: z.array(viewportSchema).min(1, "at least one viewport required").optional(),
-	adapters: z.record(z.string(), adapterSnapshotSchema).optional(),
-	notifications: notificationsConfigSchema.optional()
+	adapters: z.record(z.string(), adapterSnapshotSchema).optional()
 }).strict().superRefine((config, ctx) => {
 	if (config.previousSecret !== void 0 && config.secret === void 0) ctx.addIssue({
 		code: "custom",
@@ -136,7 +143,6 @@ function validateUiConfig(config) {
 	}
 	return result.data;
 }
-//#endregion
-export { DEFAULT_MAX_UPLOAD_BYTES, shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig };
+export { ALLOW_SERVERLESS_ENV, DEFAULT_MAX_UPLOAD_BYTES, DEFAULT_SCRATCH_DIR, MAX_CAPTURE_ASSET_CACHE_SECONDS, assertServerless, isServerlessHost, notificationsConfigSchema, resolveShelfOptions, 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 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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"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["import type { Logger } from \"pino\";\nimport { z } from \"zod\";\nimport type { CaptureRunner } from \"./adapters/capture-runner.ts\";\nimport type { DatabaseAdapter } from \"./adapters/database.ts\";\nimport type { DesignProvider } from \"./adapters/design.ts\";\nimport type { EmailSender } from \"./adapters/email-sender.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 { Ai } from \"./ai.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/** Longest browser-private freshness a signed capture asset may be given, in seconds (1 hour). */\nexport const MAX_CAPTURE_ASSET_CACHE_SECONDS = 3600;\n\n/** Signed Storybook asset serving for remote capture browsers (ADR 0007, decision 5). */\nexport interface CaptureAssetsConfig {\n  /**\n   * Opt-in browser-private freshness of capture-scoped signed assets, in whole seconds from 0 to\n   * {@link MAX_CAPTURE_ASSET_CACHE_SECONDS}. 0 (default) keeps every signed answer `no-store`. A\n   * positive value is a cap: the answer's `max-age` never exceeds the grant's remaining lifetime.\n   */\n  cacheMaxAgeSeconds?: number;\n}\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  /**\n   * Working directory for capture and inline statics extraction. Defaults to\n   * `<os.tmpdir()>/storyshelf`; publishing and capture extract there.\n   */\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  /** Persist gzip variants for published Storybook files (default off). */\n  publishedCompression?: boolean;\n  /** Signed Storybook asset serving for remote capture browsers; see {@link CaptureAssetsConfig}. */\n  captureAssets?: CaptureAssetsConfig;\n  /**\n   * Largest zip (bytes) extracted inline in the upload request; a larger zip is published by a\n   * `publish` job (or refused with 413 on a host that runs no consumer). The count is taken\n   * while the upload streams, never from `Content-Length`. Default 50 MB; `0` sends every zip to\n   * a `publish` job.\n   */\n  maxInlineUnzipSize?: number;\n  /** Most entries an uploaded Storybook zip may hold (default 50 000); more fails the publish. */\n  maxZipEntries?: number;\n  /**\n   * Most uncompressed bytes an uploaded Storybook zip may expand to (default 2 GiB), counted while\n   * extracting; more fails the publish. The compressed size is no bound on its own.\n   */\n  maxUnzippedBytes?: 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.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    \"design\",\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\n/** Zod schema validating `notifications.config`. */\nexport const 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    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    publishedCompression: z.boolean().optional(),\n    captureAssets: z\n      .object({\n        cacheMaxAgeSeconds: z.number().int().min(0).max(MAX_CAPTURE_ASSET_CACHE_SECONDS).optional(),\n      })\n      .strict()\n      .optional(),\n    maxInlineUnzipSize: z.number().int().min(0).optional(),\n    maxZipEntries: z.number().int().positive().optional(),\n    maxUnzippedBytes: 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  .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/** Testing options: what renders, how many run at once, and how screenshots are compared. */\nexport interface ShelfTestingOptions {\n  /** Pure renderer. Required: `testing` without a `runner` throws. */\n  runner: CaptureRunner;\n  /** Jobs this instance runs at once; auto-sized from CPU and memory when unset. */\n  concurrency?: number;\n  /**\n   * Retries after a first failed attempt before a capture job fails for good (default 2: three\n   * attempts). One limit covers failed attempts, lost leases and forked-child crashes.\n   */\n  retries?: number;\n  /**\n   * Lease of a job of the database queue, in seconds (default 300: 5 minutes). A running job\n   * renews it on a heartbeat (every `min(30 s, lease / 3)`) and on progress, so a stage that prints\n   * nothing is not redelivered while its process lives; a crashed holder's job is claimed by\n   * another instance once the lease runs out, so a shorter lease recovers crashes sooner.\n   */\n  leaseSeconds?: number;\n  /**\n   * Module run in a forked capture child (it calls `runCaptureChild` from `@storyshelf/core/capture`).\n   * The app consumes the queue and pushes each job to the child over IPC. Needs `runner`, which\n   * serves as the in-process fallback.\n   */\n  workerEntry?: string;\n  /**\n   * Split a big build across the queue: captures (story x viewport x engine) per shard. A build of\n   * up to twice this size still renders in one piece. Unset keeps every build in one job. Needs\n   * `runner`. With `workerEntry` the forked child plans and renders shards and puts them on the\n   * database queue itself.\n   */\n  shardSize?: number;\n  /**\n   * Requests per minute one client IP may make to the signed Storybook URL route, `/_s/<token>/*`\n   * (ADR 0007, decision 5). Default 6000, enough for a render fetching thousands of assets from one\n   * farm IP; a larger farm behind one address raises it. Over the limit the route answers `429`\n   * before it looks at the token, so the answer says nothing about a token's validity.\n   */\n  storybookUrlRateLimit?: number;\n  /**\n   * Where captures run. `auto` (default) forks when `workerEntry` is set and the host can afford\n   * a second process; `in-process` never forks; `fork` forks regardless of the host and fails at\n   * boot if it cannot.\n   */\n  mode?: \"auto\" | \"in-process\" | \"fork\";\n  /** Screenshot comparison, shared by capture and the re-diff endpoint. */\n  compare?: ShelfCompareOptions;\n  /** Image library selection; see {@link ShelfImagesOptions}. */\n  images?: ShelfImagesOptions;\n  /**\n   * Clock and timers of the database job queue. Tests inject a manual clock so lease and poll\n   * transitions do not depend on wall time; production leaves it unset (`Date.now` and the global\n   * timers).\n   */\n  queueClock?: {\n    now: () => number;\n    timers: {\n      setTimeout(callback: () => void, ms: number): unknown;\n      clearTimeout(handle: unknown): void;\n    };\n  };\n}\n\n/** Notification options: who can deliver, over which transport, with what branding. */\nexport interface ShelfNotificationsOptions {\n  /** Provider adapters (Slack, Teams, email, ...); a channel's `provider` must name one of these. */\n  notifiers?: NotifierProvider[];\n  /** Email transport. Listed here so its setup/teardown/validation hooks run with the app's. */\n  emailSender?: EmailSender;\n  /** Site-wide brand and sender settings for outgoing notifications. */\n  config?: NotificationsConfig;\n}\n\n/** Comparison options. */\nexport interface ShelfCompareOptions {\n  /**\n   * Worker threads for pixel diffs: default CPU count minus one (min 1), `0` diffs on the main\n   * thread. Takes precedence over `STORYSHELF_DIFF_WORKERS`.\n   */\n  threads?: number;\n}\n\n/** Image-handling options: which library decodes, encodes and resizes the PNGs. */\nexport interface ShelfImagesOptions {\n  /**\n   * Image library for diffs, diff overlays and AI thumbnails: `\"pngjs\"` (default, pure JavaScript,\n   * runs anywhere) or `\"sharp\"` (native, several times faster on large PNGs; needs the optional\n   * `sharp` package installed). Falls back to `STORYSHELF_IMAGE_ENGINE`. The pixel comparison is\n   * pixelmatch either way, so verdicts match.\n   */\n  engine?: \"pngjs\" | \"sharp\";\n}\n\n/** Adapter and configuration options for creating the shelf router. */\nexport interface ShelfOptions {\n  database: DatabaseAdapter;\n  storage: StorageAdapter;\n  /**\n   * Testing (render + diff in the background). Absent means Storybook hosting only: no renderer,\n   * no queue, and the tuning below is unreachable rather than silently ignored.\n   */\n  testing?: ShelfTestingOptions;\n  auth?: Auth;\n  /** AI insights surface (ADR 0016). Set ⇒ AI on site-wide; absent ⇒ off. */\n  ai?: Ai;\n  /** Design-tool providers (Figma, …) that resolve links, metadata and previews. */\n  design?: DesignProvider[];\n  /** Notification subsystem: providers, the email transport, and shared brand/sender settings. */\n  notifications?: ShelfNotificationsOptions;\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}\nexport { DEFAULT_SCRATCH_DIR, resolveShelfOptions } from \"./options.ts\";\nexport { ALLOW_SERVERLESS_ENV, assertServerless, isServerlessHost } from \"./serverless.ts\";\n"],"mappings":"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"}

package/dist/diff.d.mts

@@ -1,5 +1,9 @@
 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 };
+import { DEFAULT_DIFF_OPTIONS, DIFF_WORKERS_ENV, DiffOptions, DiffResult, IMAGE_ENGINE_ENV, ImageEngine, configureImages, diffImages, diffImagesAsync, shutdownDiffPool, verifyImageEngine } from "@storyshelf/image";
+/** @deprecated Use `configureImages`, which also takes the image engine. */
+declare function configureDiffPool(options: {
+  threads?: number;
+}): void;
+export { DEFAULT_DIFF_OPTIONS, DIFF_WORKERS_ENV, type DiffOptions, type DiffResult, IMAGE_ENGINE_ENV, type ImageEngine, configureDiffPool, configureImages, diffImages, diffImagesAsync, shutdownDiffPool, verifyImageEngine };
+//# sourceMappingURL=diff.d.mts.map

package/dist/diff.mjs

@@ -1,6 +1,18 @@
 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 };
+import { DEFAULT_DIFF_OPTIONS, DIFF_WORKERS_ENV, IMAGE_ENGINE_ENV, configureImages, configureImages as configureImages$1, diffImages, diffImagesAsync, shutdownDiffPool, verifyImageEngine } from "@storyshelf/image";
+// src/diff/index.ts
+/**
+* Pixel diff engine (re-exported from `@storyshelf/image`, which owns the codecs and worker pool).
+*
+* `diffImages` compares a baseline buffer against a current screenshot; `diffImagesAsync` does
+* the same on a worker-thread pool; `DiffOptions` tunes thresholds (also settable per-project).
+*/
+/** @deprecated Use `configureImages`, which also takes the image engine. */
+function configureDiffPool(options) {
+	configureImages$1(options);
+}
+export { DEFAULT_DIFF_OPTIONS, DIFF_WORKERS_ENV, IMAGE_ENGINE_ENV, configureDiffPool, configureImages, diffImages, diffImagesAsync, shutdownDiffPool, verifyImageEngine };
+
+//# sourceMappingURL=diff.mjs.map

package/dist/diff.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.mjs","names":[],"sources":["../src/diff/index.ts"],"sourcesContent":["/**\n * Pixel diff engine (re-exported from `@storyshelf/image`, which owns the codecs and worker pool).\n *\n * `diffImages` compares a baseline buffer against a current screenshot; `diffImagesAsync` does\n * the same on a worker-thread pool; `DiffOptions` tunes thresholds (also settable per-project).\n */\nimport { configureImages } from \"@storyshelf/image\";\n\nexport {\n  configureImages,\n  DEFAULT_DIFF_OPTIONS,\n  DIFF_WORKERS_ENV,\n  diffImages,\n  diffImagesAsync,\n  type DiffOptions,\n  type DiffResult,\n  IMAGE_ENGINE_ENV,\n  type ImageEngine,\n  shutdownDiffPool,\n  verifyImageEngine,\n} from \"@storyshelf/image\";\n\n/** @deprecated Use `configureImages`, which also takes the image engine. */\nexport function configureDiffPool(options: { threads?: number }): void {\n  configureImages(options);\n}\n"],"mappings":";;;;;;;;;;;;AAuBA,SAAgB,kBAAkB,SAAqC;CACrE,kBAAgB,OAAO;AACzB"}

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-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 { BUILD_STATUSES, BuildStatus, ProjectRole, SNAPSHOT_STATUSES, SiteRole, SnapshotStatus, TERMINAL_BUILD_STATUSES } from "./types.mjs";
+import { AdapterSnapshot, BrandTheme, CaptureAssetsConfig, DEFAULT_MAX_UPLOAD_BYTES, MAX_CAPTURE_ASSET_CACHE_SECONDS, ShelfConfig, ShelfOptions, ShelfViewport, UIConfig, shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig } from "./config.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 };
+export { type AdapterSnapshot, BUILD_STATUSES, type BrandPack, type BrandTheme, type BuildStatus, type CaptureAssetsConfig, DEFAULT_MAX_UPLOAD_BYTES, type Logger, type LoggerOptions, MAX_CAPTURE_ASSET_CACHE_SECONDS, 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 };

package/dist/index.mjs

@@ -1,8 +1,8 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-import { DEFAULT_MAX_UPLOAD_BYTES, shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig } from "./config.mjs";
+import { DEFAULT_MAX_UPLOAD_BYTES, MAX_CAPTURE_ASSET_CACHE_SECONDS, shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig } from "./config.mjs";
 import { brandPack, brandPacks } from "./brand-packs.mjs";
 import { createShelfLogger } from "./logger.mjs";
 import { BUILD_STATUSES, SNAPSHOT_STATUSES, TERMINAL_BUILD_STATUSES } from "./types.mjs";
-export { BUILD_STATUSES, DEFAULT_MAX_UPLOAD_BYTES, SNAPSHOT_STATUSES, TERMINAL_BUILD_STATUSES, brandPack, brandPacks, createShelfLogger, shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig };
+export { BUILD_STATUSES, DEFAULT_MAX_UPLOAD_BYTES, MAX_CAPTURE_ASSET_CACHE_SECONDS, SNAPSHOT_STATUSES, TERMINAL_BUILD_STATUSES, brandPack, brandPacks, createShelfLogger, shelfConfigSchema, uiConfigSchema, validateConfig, validateUiConfig };