Table of Contents

Namespace Excalibur.Cdc

Classes

CdcBuilderDiscoveryExtensions

Extension methods that bridge ICdcBuilder to ICdcBuilderDiscovery for table discovery features.

CdcDataChange

Represents a change to a specific column in a database row, capturing the old and new values.

CdcDataChangeExtensions

Extension methods for extracting typed values from CDC change data.

CdcFatalClassifier

Decides whether a CDC processing fault requires the loop to stop for review or permits recovery by the existing backoff-reconnect policy. Stopped faults never advance the checkpoint.

CdcFatalErrorOptions<TEvent>

Options for configuring fatal-error handling during CDC processing for a provider whose change events are of type TEvent.

CdcFatalGuard

The single, shared, pure decision point for a CDC consume loop's checkpoint-advance / stop behavior on every iteration. Every provider's StartAsync loop routes its fatal-vs-transient decision through Decide(Exception?, IMessageFailureClassifier?).

CdcLeadershipSupersededException

Thrown when a CDC checkpoint write is rejected because the writing instance presented a fencing token that has been superseded by a newer leadership tenure — i.e. this instance believes it is the leader but was demoted (a split-brain). The checkpoint's non-decreasing compare-and-swap left the stored LSN unchanged, so no position was regressed or skipped; this exception signals the superseded instance to stop advancing.

CdcMappingException

The exception that is thrown when a CDC event mapping operation fails.

CdcOptions

Configuration options for CDC processing.

CdcPositionResetEventArgs

Provides data for a CDC position reset event when a stale position is detected.

CdcReasonCodes

Provides standardized reason codes for CDC stale position scenarios across all providers.

CdcRetryExhaustedException

The exception a CDC processor stops with when a failure it treated as transient did not clear within the configured number of consecutive attempts.

CdcStalePositionException

Base exception for all CDC stale position scenarios across providers.

CdcTableConfig

Bindable configuration for a single CDC-tracked table.

CdcTableTrackingOptions

Configuration options for tracking a specific table, including event mappings and filters.

Structs

CdcFatalDecision

The decision a CDC processor's consume loop must act on after each iteration: whether it may advance its durable checkpoint and whether it must stop.

Interfaces

ICdcBuilder

Fluent builder interface for configuring Excalibur CDC processor.

ICdcBuilderDiscovery

Provides table discovery and configuration-binding capabilities for the CDC builder.

ICdcEventMapper<TEvent>

Maps CDC column data to a typed event instance.

ICdcProcessor<TEvent>

Base contract for CDC processors that support batch (poll-based) processing. All CDC providers implement this interface.

ICdcRecoveryBuilder

Fluent builder interface for configuring CDC recovery settings.

ICdcRelationalStateStoreBuilder

Extends ICdcStateStoreBuilder with relational-specific settings (schema name, connection string) for SQL Server and Postgres CDC state stores.

ICdcStateStoreBuilder

Configures CDC state store persistence settings shared by all providers (table name, configuration binding).

ICdcStreamProcessor<TEvent, TPosition>

Extended contract for CDC processors that support continuous streaming with position tracking.

ICdcTableBuilder

Fluent builder interface for configuring CDC table tracking settings.

ICdcTableProvider

Provider-agnostic interface for types that declare which database tables they handle. Implementations registered in DI are discovered by TrackTablesFromHandlers() at startup.

Enums

CdcChangeType

Specifies the type of change captured by CDC.

StalePositionRecoveryStrategy

Specifies the recovery strategy to use when the saved CDC position is no longer valid.

Delegates

CdcFatalErrorHandler<TEvent>

Handles a fatal error that occurs during CDC processing for a provider whose change events are of type TEvent.

CdcPositionResetHandler

Represents a handler for CDC position reset events.