Skip to content

CaptureHandlerOptions

Defined in: packages/core/src/capture/consumer/capture-handler.ts:20

What the capture handler needs: the same adapters the server’s own capture setup uses.

optional buildState?: BuildStatePublisher

Defined in: packages/core/src/capture/consumer/capture-handler.ts:37

Shows a build’s state on its git channels at every transition. Default: deliver inline through notifiers (a capture always has testing on); the app passes its queue-backed publisher.


optional config?: Pick<ShelfConfig, "publicBaseUrl" | "publishedBaseDomain" | "maxZipEntries" | "maxUnzippedBytes">

Defined in: packages/core/src/capture/consumer/capture-handler.ts:39

Links in statuses are absolute from publicBaseUrl; published Storybooks use publishedBaseDomain.


db: DatabaseAdapter

Defined in: packages/core/src/capture/consumer/capture-handler.ts:22

Database adapter; its own tables are used (never a dialect’s defaults).


optional design?: DesignProvider[]

Defined in: packages/core/src/capture/consumer/capture-handler.ts:49

Design providers validating declared design links during capture.


enqueue: (job) => Promise<void>

Defined in: packages/core/src/capture/consumer/capture-handler.ts:30

Puts a shard job on the queue; sharding needs it. Defaults to the consumed queue’s enqueue.

ShardJob

Promise<void>


logger: Logger

Defined in: packages/core/src/capture/consumer/capture-handler.ts:28


optional maxRetries?: number

Defined in: packages/core/src/capture/consumer/capture-handler.ts:56

Retries assumed for jobs that do not state maxAttempts (default 2).


optional notifiers?: NotifierProvider[]

Defined in: packages/core/src/capture/consumer/capture-handler.ts:32

Notifier providers; state channels (git hosts) get the build statuses.


optional publicOrigin?: () => Promise<string | undefined>

Defined in: packages/core/src/capture/consumer/capture-handler.ts:47

The resolved public origin (ADR 0007, decision 6): status links and URL-reaching targets use it. Default: config.publicBaseUrl, then the platform’s address, then the origin an admin stored.

Promise<string | undefined>


runner: CaptureRunner

Defined in: packages/core/src/capture/consumer/capture-handler.ts:25

Pure renderer; cancel is called when a job’s lease is lost or the job is cancelled.


scratchDir: string

Defined in: packages/core/src/capture/consumer/capture-handler.ts:27

Scratch directory for Storybook extraction.


optional secret?: SecretInput

Defined in: packages/core/src/capture/consumer/capture-handler.ts:51

Server secret for webhook decryption.


optional shardSize?: number

Defined in: packages/core/src/capture/consumer/capture-handler.ts:54

Captures per shard; unset keeps every build in one job.


storage: StorageAdapter

Defined in: packages/core/src/capture/consumer/capture-handler.ts:23


optional viewports?: Viewport[]

Defined in: packages/core/src/capture/consumer/capture-handler.ts:52