Struct SystemConfigDbStore 

pub struct SystemConfigDbStore { /* private fields */ }

SeaORM-backed system configuration store.

The registry supplies metadata, not write validation. See Self::upsert_prevalidated.

Implementations

impl SystemConfigDbStore

pub const fn new( db: DatabaseConnection, registry: &'static ConfigRegistry, deprecated_keys: &'static [&'static str], ) -> Self

Creates a store from a database connection and product config registry.

pub async fn find_all(&self) -> Result<Vec<Model>>

Lists all rows by stable id order.

Errors

Returns an error when the database operation fails.

pub async fn find_cursor( &self, limit: u64, after_id: Option<i64>, ) -> Result<SystemConfigCursorSlice>

Lists one id-cursor page by stable id order.

Errors

Returns an error when the database operation fails.

pub async fn find_by_key(&self, key: &str) -> Result<Option<Model>>

Finds one row by key.

Errors

Returns an error when the database operation fails.

pub async fn find_visible_custom( &self, include_authenticated: bool, ) -> Result<Vec<Model>>

Lists visible custom rows ordered by key.

Errors

Returns an error when the database operation fails.

pub async fn lock_by_key(&self, key: &str) -> Result<()>

Locks one row by key where the database supports row locks.

Errors

Returns an error when the database operation fails.

pub async fn upsert_prevalidated( &self, request: SystemConfigUpsert<'_>, ) -> Result<Model>

Persists a prevalidated storage string using registry metadata for known system keys.

Preconditions

The caller must complete structure, normalizer, and dependency validation on the logical value, then encode any secret envelope. request.value is written verbatim without those checks; custom-key validation and authorization remain product-owned. This method uses the owned connection and does not coordinate audit, snapshots, or notifications. Use SystemConfigDbBinding::upsert_prevalidated with a transaction for atomic write/audit, then update snapshots and notify after commit.

Errors

Returns an error when the database operation fails.

pub async fn delete_by_key(&self, key: &str) -> Result<()>

Deletes a custom row.

Errors

Returns an error when the database operation fails.

pub async fn ensure_system_value_if_missing( &self, key: &str, value: &str, ) -> Result<bool>

Inserts one system value if no row exists.

The caller must validate the logical value and encode any secret before calling. value is persisted verbatim without structure, normalizer, or dependency validation.

Errors

Returns an error when the database operation fails.

pub async fn delete_deprecated_keys(&self) -> Result<u64>

Deletes deprecated system keys configured by the product.

Errors

Returns an error when the database operation fails.

pub async fn ensure_defaults(&self) -> Result<usize>

Ensures default rows exist and repairs metadata for existing system rows.

Errors

Returns an error when the database operation fails.

Trait Implementations

impl Clone for SystemConfigDbStore

fn clone(&self) -> SystemConfigDbStore

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.