Struct GuardStoreHandle 

pub struct GuardStoreHandle { /* private fields */ }

Cheap-clone, thread-safe handle to a GuardStore. The App owns one; the dispatcher clones it into each spawned lifecycle task so the task can lock + insert the Guard on completion. Locks are held briefly (single map mutation per activation / deactivation); std::sync::Mutex is correct because no .await happens inside the lock.

Implementations

impl GuardStoreHandle

pub fn new() -> Self

Fresh empty handle.

pub fn insert(&self, buffer: BufferId, mode: ModeId, guard: Box<dyn Any + Send>)

Stash a Guard unconditionally (skipping the epoch check). Used in tests + the rare reload path; the production dispatcher routes through Self::try_insert.

pub fn bump_epoch(&self, buffer: BufferId, mode: ModeId) -> u64

Bump + return the new epoch for (buffer, mode). The dispatcher’s sync prefix calls this when queueing each cascade step; the spawn task captures it and passes back to Self::try_insert.

pub fn try_insert( &self, buffer: BufferId, mode: ModeId, my_epoch: u64, guard: Box<dyn Any + Send>, ) -> Result<(), Box<dyn Any + Send>>

Insert iff my_epoch still matches the current epoch. Returns Err(guard) on stale; the caller drops the Guard outside the lock so the original type’s Drop fires.

pub fn remove( &self, buffer: BufferId, mode: ModeId, ) -> Option<Box<dyn Any + Send>>

Take ownership of the Guard. Bumps the epoch (invalidating any in-flight spawn) then removes; the caller drops the returned Box, firing the Guard’s Drop impl outside the lock.

pub fn purge_buffer(&self, buffer: BufferId)

Drop every Guard for buffer. Used when a buffer is deleted.

pub fn contains(&self, buffer: BufferId, mode: ModeId) -> bool

True iff a Guard is stashed for (buffer, mode).

pub fn len(&self) -> usize

Number of stashed Guards.

pub fn is_empty(&self) -> bool

True when no Guard is stashed (or the lock is poisoned).

Trait Implementations

impl Clone for GuardStoreHandle

fn clone(&self) -> GuardStoreHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GuardStoreHandle

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

Formats the value using the given formatter.

impl Default for GuardStoreHandle

fn default() -> GuardStoreHandle

Returns the “default value” for a type.