Interface RegistrySyncConfig

RegistryClient instance to use for API calls.

Feed transport for tailing changes after bootstrap:

• 'auto' (default): try the SSE stream, fall back to polling on an unsupported endpoint (404/406), proxy/network failure, or stream parse failure.
• 'stream': SSE only; reconnect on failure and never fall back to polling.
• 'poll': polling only.

Polling interval in milliseconds. Default: 30000 (30s).

Comma-separated event type filter (glob, e.g. authorization.*) applied to every feed read (bootstrap drain, polling, and SSE).

A persisted cursor is scoped to the logical types subscription it was minted under: a cursor from a broader subscription can skip events that were filtered out previously. This is NOT enforced by the cursor store (the store holds only the cursor string), so if you change types you must reset() before start(). With a persistent FileCursorStore that survives restarts, changing types between deploys against the same store path will silently resume from a foreign cursor — point each subscription at its own store path, or clear the store when the filter changes.

Max events requested per feed page (polling and SSE). Default: 1000.

Server-side caught-up interval hint for the SSE stream, in seconds (5–60, default 15) — maps to the poll_interval_seconds query param. Note the unit: pollIntervalMs and streamIdleTimeoutMs are milliseconds.

Client-side idle watchdog: reconnect the stream if no feed page or heartbeat arrives within this window. Must exceed the server poll interval. Default: 90000 (90s).

Reconnect backoff floor in ms. Default: 1000.

Reconnect backoff ceiling in ms. Default: 30000.

Consecutive stream failures (with no successful message in between) before 'auto' mode falls back to polling. Default: 3. Ignored in 'stream' mode.

Choose which indexes to maintain.

Optional cursor store for persisting the feed cursor between restarts.

Called on errors during polling/bootstrap.