Struct SettingsService 

pub struct SettingsService { /* private fields */ }

Settings service - main interface for accessing and managing settings

Implementations

impl SettingsService

pub fn new( registry: Arc<FrozenSettingsRegistry>, meta: Arc<dyn MetaAdapter>, cache_size: usize, ) -> Self

pub async fn get(&self, tn_id: TnId, key: &str) -> ClResult<SettingValue>

Get setting value with full resolution (tenant -> global -> default)

pub async fn set<S: AsRef<str>>( &self, tn_id: TnId, key: &str, value: SettingValue, roles: &[S], ) -> ClResult<Setting>

Set setting value with validation and permission checks The roles parameter should be the authenticated user’s roles

pub async fn delete(&self, tn_id: TnId, key: &str) -> ClResult<bool>

Delete a setting (falls back to next level)

pub async fn validate_required_settings(&self) -> ClResult<()>

Validate that all required settings (no default and not optional) are configured

pub async fn get_string(&self, tn_id: TnId, key: &str) -> ClResult<String>

Type-safe getters (required - returns error if not found)

pub async fn get_int(&self, tn_id: TnId, key: &str) -> ClResult<i64>

pub async fn get_bool(&self, tn_id: TnId, key: &str) -> ClResult<bool>

pub async fn get_json(&self, tn_id: TnId, key: &str) -> ClResult<Value>

pub async fn get_string_opt( &self, tn_id: TnId, key: &str, ) -> ClResult<Option<String>>

Type-safe optional getters (returns None if not found or has no default) Still returns error if setting exists but has wrong type

pub async fn get_int_opt(&self, tn_id: TnId, key: &str) -> ClResult<Option<i64>>

pub async fn get_bool_opt( &self, tn_id: TnId, key: &str, ) -> ClResult<Option<bool>>

pub async fn get_json_opt( &self, tn_id: TnId, key: &str, ) -> ClResult<Option<Value>>

pub fn registry(&self) -> &Arc<FrozenSettingsRegistry>

Get reference to registry (for listing all settings)

pub async fn list_by_prefix( &self, tn_id: TnId, prefix: &str, ) -> ClResult<Vec<(String, SettingValue, &SettingDefinition)>>

List stored settings by prefix with definition metadata

This queries the database for actual stored settings matching the prefix, then resolves each against the registry (supporting wildcard patterns like “ui.*”). Global settings are merged with tenant-specific settings (tenant overrides global).