Struct Backend 

pub struct Backend { /* private fields */ }

Backend wrapper for Instance operations

This struct wraps a BackendImpl and provides methods for backend operations. Currently it’s a thin wrapper that delegates all calls to the underlying BackendImpl.

In the future, this will be converted to an enum to support both local and remote (RPC-based) backends, allowing for transparent local/remote dispatch.

Implementations

impl Backend

pub fn new(backend_impl: Arc<dyn BackendImpl>) -> Self

Create a new Backend wrapping a BackendImpl

pub async fn get(&self, id: &ID) -> Result<Entry>

Get an entry from the backend

pub async fn get_verification_status( &self, id: &ID, ) -> Result<VerificationStatus>

Get verification status of an entry

pub async fn put( &self, verification: VerificationStatus, entry: Entry, ) -> Result<()>

Put an entry into the backend with verification status

pub async fn put_verified(&self, entry: Entry) -> Result<()>

Put a verified entry (convenience method)

pub async fn put_unverified(&self, entry: Entry) -> Result<()>

Put an unverified entry (convenience method)

pub async fn update_verification_status( &self, id: &ID, status: VerificationStatus, ) -> Result<()>

Update verification status of an entry

pub async fn get_entries_by_verification_status( &self, status: VerificationStatus, ) -> Result<Vec<ID>>

Get entries by verification status

pub async fn get_tips(&self, tree: &ID) -> Result<Vec<ID>>

Get tips for a tree

pub async fn get_store_tips(&self, tree: &ID, store: &str) -> Result<Vec<ID>>

Get tips for a specific store within a tree

pub async fn get_store_tips_up_to_entries( &self, tree: &ID, store: &str, up_to: &[ID], ) -> Result<Vec<ID>>

Get store tips up to specific entries

pub async fn all_roots(&self) -> Result<Vec<ID>>

Get all root entries

pub async fn find_merge_base( &self, tree: &ID, store: &str, entry_ids: &[ID], ) -> Result<ID>

Find merge base (common dominator) of entries

pub async fn collect_root_to_target( &self, tree: &ID, store: &str, target: &ID, ) -> Result<Vec<ID>>

Collect root to target path

pub async fn get_tree(&self, tree: &ID) -> Result<Vec<Entry>>

Get all entries in a tree

pub async fn get_store(&self, tree: &ID, store: &str) -> Result<Vec<Entry>>

Get all entries in a store

pub async fn get_tree_from_tips( &self, tree: &ID, tips: &[ID], ) -> Result<Vec<Entry>>

Get tree entries from tips

pub async fn get_store_from_tips( &self, tree: &ID, store: &str, tips: &[ID], ) -> Result<Vec<Entry>>

Get store entries from tips

pub async fn get_cached_crdt_state( &self, entry_id: &ID, store: &str, ) -> Result<Option<String>>

Get cached CRDT state

pub async fn cache_crdt_state( &self, entry_id: &ID, store: &str, state: String, ) -> Result<()>

Cache CRDT state

pub async fn clear_crdt_cache(&self) -> Result<()>

Clear CRDT cache

pub async fn get_sorted_store_parents( &self, tree_id: &ID, entry_id: &ID, store: &str, ) -> Result<Vec<ID>>

Get sorted store parents

pub async fn get_path_from_to( &self, tree_id: &ID, store: &str, from_id: &ID, to_ids: &[ID], ) -> Result<Vec<ID>>

Get path from one entry to others

pub async fn get_instance_metadata(&self) -> Result<Option<InstanceMetadata>>

Get instance metadata

pub async fn set_instance_metadata( &self, metadata: &InstanceMetadata, ) -> Result<()>

Set instance metadata

pub fn as_backend_impl(&self) -> &dyn BackendImpl

Get access to the underlying BackendImpl

This is provided for special operations like downcasting to concrete backend types (e.g., for save/load operations on InMemory). Use with caution.

pub fn as_arc_backend_impl(&self) -> &Arc<dyn BackendImpl>

Get access to the underlying Arc<dyn BackendImpl>

This is needed for validation functions and other code that expects the Arc wrapper. Returns a reference to the Arc.

pub fn as_any(&self) -> &dyn Any

Downcast to Any for concrete backend type access

This is primarily used for downcasting to concrete backend types (e.g., InMemory) for save/load operations or testing.

Trait Implementations

impl Clone for Backend

fn clone(&self) -> Backend

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Handle for Backend

fn handle(&self) -> Self

Creates a new handle to the same underlying resource.