Table of Contents

Namespace Excalibur.Data.Persistence

Classes

ConnectionStringProviderExtensions

Extension methods for IConnectionStringProvider.

DelegatingPersistenceProvider

Abstract base class for IPersistenceProvider decorators. All methods are virtual and forward to the inner provider by default.

PersistenceProviderBuilder

Builds a composed IPersistenceProvider by stacking DelegatingPersistenceProvider decorators around an inner provider. Follows the ChatClientBuilder pattern from Microsoft.Extensions.AI.

TransactionScopeBase

Provides a base implementation for ITransactionScope and ITransactionScopeCallbacks with common state management, callback registration, and disposal logic.

Interfaces

IConnectionStringProvider

Provides connection string management for persistence providers.

IConnectionStringProviderAdmin

Provides administrative connection string operations. Implementations should implement this alongside IConnectionStringProvider.

IDataRequestExecutor

Executes an IDataRequest<TConnection, TModel> over an IDbConnection the provider supplies and owns. Obtain via GetService(Type) with typeof(IDataRequestExecutor).

IDocumentPersistenceProvider

Specialized persistence provider for document stores that handles DocumentDataRequest execution with document-specific capabilities. Implementation-specific services are available via GetService(Type).

IPersistenceOptions

Core interface for persistence provider options. Contains connection fundamentals and extensibility — at most 5 members per ISP gate.

IPersistenceProvider

Defines the contract for persistence providers that manage DataRequest execution and lifecycle. Providers focus on connection management and infrastructure concerns rather than specific CRUD operations.

IPersistenceProviderConnection

Exposes how a persistence provider reaches its store, and how it behaves when reaching it fails. Obtain via GetService(Type) with typeof(IPersistenceProviderConnection).

IPersistenceProviderHealth

Provides health and diagnostics capabilities for persistence providers. Obtain via GetService(Type) with typeof(IPersistenceProviderHealth).

IPersistenceProviderTransaction

Provides transaction coordination capabilities for persistence providers. Obtain via GetService(Type) with typeof(IPersistenceProviderTransaction).

ISqlPersistenceProvider

Specialized persistence provider for SQL databases that handles DataRequest execution with SQL-specific capabilities. Implementation-specific services are available via GetService(Type).

ITransactionScope

Defines a transaction scope for managing distributed transactions across multiple providers.

ITransactionScopeAdvanced

Provides advanced transaction scope capabilities including savepoints and nested scopes.

ITransactionScopeCallbacks

Provides lifecycle callback registration for transaction scopes.

Enums

TransactionStatus

Represents the status of a transaction.