Struct StorageObjectStore 

pub struct StorageObjectStore {
    pub objects: HashMap<u64, StoredObject>,
    pub name_index: HashMap<(String, String), u64>,
    pub next_object_id: u64,
}

High-level object store providing named object management, versioning, and metadata-rich retrieval on top of raw block storage.

Fields

objects: HashMap<u64, StoredObject>

Objects keyed by their numeric id.

name_index: HashMap<(String, String), u64>

Index from (namespace, name) to object_id.

next_object_id: u64

Counter used to assign the next object id.

Implementations

impl StorageObjectStore

pub fn new() -> Self

Creates a new, empty object store.

pub fn create( &mut self, name: &str, namespace: &str, cid: &str, size_bytes: u64, author: &str, message: &str, created_at_secs: u64, ) -> u64

Creates a new object with version 1 and returns its object_id.

If an object with the same (namespace, name) already exists the existing object id is returned without creating a duplicate entry.

pub fn add_version( &mut self, object_id: u64, cid: &str, size_bytes: u64, author: &str, message: &str, created_at_secs: u64, ) -> bool

Appends a new version to an existing object.

The new version number is previous_max_version + 1. Returns false if the object is not found.

pub fn get_by_name(&self, namespace: &str, name: &str) -> Option<&StoredObject>

Retrieves an object by its (namespace, name) pair.

pub fn get(&self, object_id: u64) -> Option<&StoredObject>

Retrieves an object by its numeric id.

pub fn delete(&mut self, object_id: u64) -> bool

Deletes an object by id.

Returns false when the object is not found or when it is pinned.

pub fn pin(&mut self, object_id: u64) -> bool

Pins an object, preventing it from being deleted.

Returns false if the object is not found.

pub fn unpin(&mut self, object_id: u64) -> bool

Unpins an object, allowing it to be deleted.

Returns false if the object is not found.

pub fn add_tag(&mut self, object_id: u64, tag: &str) -> bool

Adds a tag to an object (idempotent — duplicate tags are silently ignored).

Returns false if the object is not found.

pub fn objects_in_namespace(&self, namespace: &str) -> Vec<&StoredObject>

Returns all objects in the given namespace, sorted ascending by name.

pub fn objects_with_tag(&self, tag: &str) -> Vec<&StoredObject>

Returns all objects that carry the given tag, sorted ascending by object_id.

pub fn stats(&self) -> ObjectStoreStats

Computes aggregate statistics for the entire store.

Trait Implementations

impl Debug for StorageObjectStore

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

Formats the value using the given formatter.

impl Default for StorageObjectStore

fn default() -> StorageObjectStore

Returns the “default value” for a type.