Struct SessionHandle 

pub struct SessionHandle {
    pub session_id: String,
    /* private fields */
}

Handle for interacting with a single persistent session.

Fields

session_id: String

Implementations

impl SessionHandle

pub fn dir(&self) -> &Path

pub fn base_path(&self) -> PathBuf

pub fn binlog_path(&self) -> PathBuf

pub fn head_path(&self) -> PathBuf

pub fn current_branch_path(&self) -> PathBuf

pub fn branches_path(&self) -> PathBuf

pub fn snapshot_manifest_path(&self) -> PathBuf

pub fn snapshot_file_path(&self, op_id: &str) -> PathBuf

pub fn staged_dir(&self) -> PathBuf

pub fn lock_path(&self) -> PathBuf

pub fn read_head(&self) -> Result<Option<String>>

Read the current HEAD op_id. Returns None if HEAD is empty (at base).

pub fn write_head(&self, op_id: &str) -> Result<()>

Set the HEAD op_id.

pub fn clear_head(&self) -> Result<()>

Clear HEAD back to base state.

pub fn current_branch(&self) -> Result<String>

Read the current branch name.

pub fn switch_branch(&self, branch_name: &str) -> Result<()>

Switch to a different branch.

pub fn create_branch( &self, name: &str, fork_point: Option<&str>, label: Option<&str>, ) -> Result<()>

Create a new branch forking from the given op_id.

pub fn list_branches(&self) -> Result<Vec<BranchInfo>>

List all branches.

pub fn append_event(&self, event: OpEvent) -> Result<()>

Append an event to the binlog and advance HEAD + branch tip. This is the atomic apply operation.

pub fn read_events(&self) -> Result<Vec<OpEvent>>

Read all events in the binlog.

pub fn read_events_after(&self, after_op_id: &str) -> Result<Vec<OpEvent>>

Read events after a given op_id.

pub fn log(&self) -> Result<Vec<OpEvent>>

Get the event log for display (session log).

pub fn undo(&self) -> Result<Option<String>>

Move HEAD back one event (branch-local undo).

pub fn redo(&self) -> Result<Option<String>>

Move HEAD forward one event (branch-local redo).

pub fn checkout(&self, op_id: &str) -> Result<()>

Set HEAD to a specific op_id (checkout).

pub fn materialize(&self) -> Result<Vec<u8>>

Materialize the workbook at the current HEAD by loading base + replaying events.

pub fn materialize_at(&self, target_op_id: &str) -> Result<Vec<u8>>

Materialize the workbook at a specific op_id.

pub fn meta(&self) -> Result<SessionMeta>

Read session metadata.