Struct StorageBlockIndex 

pub struct StorageBlockIndex {
    pub entries: HashMap<String, IndexEntry>,
    pub index: HashMap<IndexKey, Vec<String>>,
}

Secondary index over stored blocks that accelerates queries by content type, size range, creation time, and custom tags without scanning all blocks.

Indexing strategy

Every IndexEntry inserted into the index is registered under four categories of IndexKey:

• ContentType(content_type) — one key per entry.
• SizeBucket(size_bytes / 1_MiB) — coarse size bucket (1 MiB granularity).
• DayBucket(created_at_secs / 86_400) — coarse day bucket.
• Tag(tag) for each tag string in entry.tags.

The inverted index maps each IndexKey to the list of CID strings that carry that key, enabling fast set-based retrieval without a full scan.

Fields

entries: HashMap<String, IndexEntry>

Primary storage: maps CID to its full IndexEntry.

index: HashMap<IndexKey, Vec<String>>

Inverted index: maps an IndexKey to the CIDs that belong to it.

Implementations

impl StorageBlockIndex

pub fn new() -> Self

Create a new, empty StorageBlockIndex.

pub fn insert(&mut self, entry: IndexEntry)

Insert (or replace) an entry in the index.

If a previous entry exists for the same CID it is removed first so the inverted index does not accumulate stale pointers.

pub fn remove(&mut self, cid: &str) -> bool

Remove an entry by CID from both the primary store and all index buckets.

Returns true when the entry existed and was removed, false otherwise.

pub fn query<'a>(&'a self, q: &IndexQuery) -> Vec<&'a IndexEntry>

Query the index with an IndexQuery filter.

The implementation performs a full scan of the primary entry map and applies each active filter in turn. Results are sorted by created_at_secs descending (newest first).

pub fn entries_for_key<'a>(&'a self, key: &IndexKey) -> Vec<&'a IndexEntry>

Look up all entries that are indexed under the given IndexKey.

Returns entries sorted by CID string for deterministic ordering.

pub fn stats(&self) -> IndexStats

Compute aggregate statistics over all indexed entries.

Trait Implementations

impl Default for StorageBlockIndex

fn default() -> Self

Returns the “default value” for a type.