Struct SystemConfigDbBinding 

pub struct SystemConfigDbBinding { /* private fields */ }

Product binding for the shared system config store.

A product normally has one static binding that supplies its registry and deprecated-key list. Repository code can then focus on product error mapping, authorization, and API cursor shape instead of repeatedly passing the same registry values into every call. Binding a registry does not make writes validated; see Self::upsert_prevalidated.

Implementations

impl SystemConfigDbBinding

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

Creates a product binding from a config registry and deprecated key list.

pub async fn find_all<C: ConnectionTrait>(&self, db: &C) -> Result<Vec<Model>>

Lists all rows by stable id order.

Errors

Returns an error when the database operation fails.

pub async fn find_cursor<C: ConnectionTrait>( &self, db: &C, 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<C: ConnectionTrait>( &self, db: &C, 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<C: ConnectionTrait>( &self, db: &C, 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<C: ConnectionTrait>( &self, db: &C, 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<C: ConnectionTrait>( &self, db: &C, 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 before constructing the request, then encode any secret storage envelope. This method writes request.value verbatim without any of those checks. Custom-key validation, authorization, and audit remain product-owned. Pass a transaction for atomic write/audit; update snapshots and notify only after commit. See upsert_prevalidated.

Errors

Returns an error when the database operation fails.

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

Deletes a custom row.

Errors

Returns an error when the database operation fails.

pub async fn ensure_system_value_if_missing<C: ConnectionTrait>( &self, db: &C, 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<C: ConnectionTrait>( &self, db: &C, ) -> Result<u64>

Deletes deprecated system keys configured by the product.

Errors

Returns an error when the database operation fails.

pub async fn ensure_defaults<C: ConnectionTrait>(&self, db: &C) -> 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 SystemConfigDbBinding

fn clone(&self) -> SystemConfigDbBinding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SystemConfigDbBinding