Struct TreeManifest 

pub struct TreeManifest { /* private fields */ }

Indexed tree manifest.

Holds file entries as raw CBOR bytes with a sorted offset table for O(log N) single-file lookup. Metadata (shards, totals) is parsed eagerly.

Constructed via TreeManifestBuilder or TreeManifest::open.

Implementations

impl TreeManifest

pub fn builder() -> TreeManifestBuilder

Create a builder for constructing a new manifest.

pub fn from_commit( store: &impl ObjectStoreExt, commit: &Commit, reader: &CommitReader, ) -> Result<Option<Self>>

Load and decrypt the TreeManifest from a commit.

Extracts the manifest CID from the commit, fetches the encrypted blob from the store, decrypts it with the reader’s content key, and parses it.

Returns None if the commit has no manifest_cid.

pub fn as_bytes(&self) -> &[u8]

Returns the serialized CBOR bytes for encryption and storage.

pub fn lookup(&self, path: &str) -> Result<ManifestEntry>

Look up a single file by path. O(log N).

Binary searches the offset table, parsing one entry per probe to compare paths.

pub fn iter(&self) -> ManifestIter<'_>

Iterate all file entries in path-sorted order. O(N).

pub fn shards(&self) -> &[ShardReference]

Returns the shard references.

pub fn total_files(&self) -> u64

Total number of files.

pub fn total_bytes(&self) -> u64

Total bytes across all files.

pub fn paths_hash(&self) -> &[u8; 32]

SHA256 hash of sorted paths.

pub fn entry_count(&self) -> usize

Number of file entries.

pub fn list_dir(&self, path: &str) -> Result<Vec<DirChild>>

List the immediate children of a directory.

Returns files and subdirectories directly under path. Use "" for the root directory.

Entries are sorted by path, so we can efficiently find the range of entries under a prefix and derive the directory listing.

pub fn entries_by_shard(&self) -> Result<Vec<Vec<ManifestEntry>>>

Group file entries by shard index.

Returns a vec indexed by shard position, where each element contains the ManifestEntry items stored in that shard. Callers can iterate shard-by-shard to decrypt each shard once and extract all files from it.