Struct StateRegistry 

pub struct StateRegistry {
    sdk_managed: RwLock<Vec<RepositoryItemData>>,
    client_managed: RwLock<HashMap<TypeId, Box<dyn Any + Send + Sync>>>,
    database: OnceLock<SqliteDatabase>,
}

A registry that contains repositories for different types of items. These repositories can be either managed by the client or by the SDK itself.

Fields

sdk_managed: RwLock<Vec<RepositoryItemData>>

client_managed: RwLock<HashMap<TypeId, Box<dyn Any + Send + Sync>>>

database: OnceLock<SqliteDatabase>

Implementations

impl StateRegistry

pub fn new() -> Self

Creates a new empty StateRegistry.

pub async fn initialize_database( &self, configuration: DatabaseConfiguration, migrations: RepositoryMigrations, ) -> Result<(), StateRegistryError>

Initializes the database used for sdk-managed repositories.

pub fn register_client_managed<T: RepositoryItem>( &self, value: Arc<dyn Repository<T>>, )

Registers a client-managed repository into the map, associating it with its type.

fn get_client_managed<T: RepositoryItem>( &self, ) -> Option<Arc<dyn Repository<T>>>

Retrieves a client-managed repository from the map given its type.

fn get_sdk_managed<T: RepositoryItem>( &self, ) -> Result<Arc<dyn Repository<T>>, StateRegistryError>

Retrieves a SDK-managed repository from the database.

pub fn get<T>(&self) -> Result<Arc<dyn Repository<T>>, StateRegistryError>

where T: RepositoryItem,

Get a repository with fallback: prefer client-managed, fall back to SDK-managed.

This method first attempts to retrieve a client-managed repository. If not found, it falls back to an SDK-managed repository. Both are returned as Arc<dyn Repository<T>>.

Type Requirements

• T must implement RepositoryItem (for both types)

Errors

Returns StateRegistryError when:

• Client-managed repository is not registered, AND
• SDK-managed repository cannot be retrieved (e.g., database not initialized)

Trait Implementations

impl Debug for StateRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.