Struct PermissionGroupManager 

pub struct PermissionGroupManager {
    updates: AsyncMutex<()>,
    state: SyncRwLock<PermissionGroupManagerState>,
    store: Option<Arc<dyn PermissionGroupStore>>,
}

Runtime permission groups with serialized, persistence-first updates.

Fields

updates: AsyncMutex<()>

state: SyncRwLock<PermissionGroupManagerState>

store: Option<Arc<dyn PermissionGroupStore>>

Implementations

impl PermissionGroupManager

pub fn new( config: PermissionGroupsConfig, store: Option<Arc<dyn PermissionGroupStore>>, ) -> Result<Self, PermissionConfigError>

Builds a manager from typed config and an optional persistence store.

Errors

Returns an error when the initial config does not resolve.

pub fn transient( config: PermissionGroupsConfig, ) -> Result<Self, PermissionConfigError>

Builds a manager without persistence.

Errors

Returns an error when the initial config does not resolve.

pub fn config_snapshot(&self) -> PermissionGroupsConfig

Returns a typed snapshot of the current config.

pub fn contains_group(&self, group: &str) -> bool

Returns whether a configured group exists.

pub fn group_names(&self) -> Vec<String>

Returns configured group names sorted by name.

pub fn effective_permissions( &self, assigned_groups: &[String], subject_permissions: &PermissionSet, ) -> PermissionSet

Builds an effective permission set from the current group snapshot.

pub fn effective_metadata( &self, assigned_groups: &[String], subject_metadata: &PermissionMetadataSet, ) -> PermissionMetadataSet

Builds effective metadata from the current group snapshot.

pub async fn replace_config( &self, config: PermissionGroupsConfig, ) -> Result<(), PermissionGroupManagerError>

Replaces the complete config after validation and optional persistence.

Errors

Returns an error when validation or persistence fails.

pub async fn update_config( &self, update: impl FnOnce(&mut PermissionGroupsConfig) + Send, ) -> Result<(), PermissionGroupManagerError>

Updates the latest config under the manager update lock.

Errors

Returns an error when the updated config is invalid or cannot be persisted.

pub async fn try_update_config<T, E>( &self, update: impl FnOnce(&mut PermissionGroupsConfig) -> Result<T, E> + Send, ) -> Result<T, PermissionGroupUpdateError<E>>

where T: Send, E: Send,

Updates the latest config with a fallible caller-owned edit.

Errors

Returns the edit error, or a validation or persistence error.

async fn replace_config_locked( &self, config: PermissionGroupsConfig, ) -> Result<(), PermissionGroupManagerError>

Trait Implementations

impl Debug for PermissionGroupManager

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

Formats the value using the given formatter.