Struct SessionStash 

pub struct SessionStash { /* private fields */ }

Per-session key/value store with TTL-based expiry and group isolation.

Implementations

impl SessionStash

pub fn new(config: StashConfig) -> Self

Create a new stash with the given configuration.

pub fn put( &mut self, key: &str, value: Value, ttl: Option<Duration>, current_group: Option<&str>, ) -> Result<(), StashError>

Store a value under key.

If the key already exists its value is replaced and size accounting is updated accordingly. The current_group is recorded as the entry’s owner — future reads from other groups will be denied.

Errors

Returns StashError if any limit is exceeded or the key is invalid.

pub fn get( &self, key: &str, current_group: Option<&str>, ) -> Result<Option<&Value>, StashError>

Retrieve the value stored under key.

Returns Ok(None) if the key does not exist or has expired.

Errors

Returns StashError::CrossGroupAccess if the entry is owned by a different group than current_group.

pub fn delete( &mut self, key: &str, current_group: Option<&str>, ) -> Result<bool, StashError>

Remove the entry stored under key.

Returns Ok(true) if the entry was present and removed, Ok(false) if the key did not exist.

Errors

Returns StashError::CrossGroupAccess if the entry is owned by a different group.

pub fn keys(&self, current_group: Option<&str>) -> Vec<&str>

Return the keys currently visible to current_group.

Expired entries and entries belonging to a different strict group are excluded.

pub fn reap_expired(&mut self) -> usize

Remove all expired entries and return how many were removed.