Struct SessionMetadataStore 

pub struct SessionMetadataStore { /* private fields */ }

File-backed session metadata with schema migration.

Implementations

impl SessionMetadataStore

pub fn open(path: impl Into<PathBuf>) -> Self

pub fn path(&self) -> &Path

pub fn read(&self) -> Result<Option<LoadedSessionMetadata>, PersistenceError>

pub fn load(&self) -> Result<Option<LoadedSessionMetadata>, PersistenceError>

pub fn update<F>(&self, edit: F) -> Result<(), PersistenceError>

where F: FnOnce(&mut SessionMetadata),

Read the current snapshot, apply an in-memory edit, and atomically publish the replacement. A missing snapshot is treated as empty metadata; malformed or newer snapshots are left untouched and returned as errors.

pub fn write(&self, metadata: &SessionMetadata) -> Result<(), PersistenceError>

pub fn migrate_in_place(&self) -> Result<MigrationReport, PersistenceError>

pub fn buffered(&self) -> Result<BufferedSessionMetadataStore>

Start a background metadata writer. Runtime event loops should enqueue snapshots through this handle and call BufferedSessionMetadataStore::flush only at lifecycle boundaries; atomic writes and fsync therefore never block terminal input or rendering.

pub fn buffered_with_errors( &self, on_error: impl Fn(String) + Send + 'static, ) -> Result<BufferedSessionMetadataStore>

Trait Implementations

impl Clone for SessionMetadataStore

fn clone(&self) -> SessionMetadataStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionMetadataStore

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

Formats the value using the given formatter.