Struct VersionedChunk 

pub struct VersionedChunk {
    pub vector: Arc<SparseVec>,
    pub version: u64,
    pub created_at: Instant,
    pub modified_at: Instant,
    pub ref_count: Arc<AtomicU32>,
    pub original_size: usize,
    pub content_hash: [u8; 8],
}

A versioned chunk with metadata

Chunks are immutable once created - the SparseVec is wrapped in Arc for zero-copy sharing across threads. Each update creates a new VersionedChunk with an incremented version number.

Fields

vector: Arc<SparseVec>

The actual VSA-encoded chunk data (immutable, shared)

version: u64

Version number of this chunk (local to the chunk)

created_at: Instant

When this chunk was first created

modified_at: Instant

When this chunk was last modified

ref_count: Arc<AtomicU32>

Reference count - how many files reference this chunk Used for garbage collection and deduplication tracking

original_size: usize

Size of the original data in bytes (before VSA encoding)

content_hash: [u8; 8]

Content hash for deduplication (first 8 bytes of SHA256)

Implementations

impl VersionedChunk

pub fn new( vector: SparseVec, original_size: usize, content_hash: [u8; 8], ) -> Self

Create a new versioned chunk

pub fn update(&self, new_vector: SparseVec, new_hash: [u8; 8]) -> Self

Create a new version of this chunk with updated data

pub fn inc_ref(&self)

Increment the reference count

pub fn dec_ref(&self) -> u32

Decrement the reference count and return the new value

pub fn ref_count(&self) -> u32

Get the current reference count

pub fn is_unreferenced(&self) -> bool

Check if this chunk can be garbage collected

pub fn age(&self) -> Duration

Get the age of this chunk

pub fn time_since_modification(&self) -> Duration

Get time since last modification

Trait Implementations

impl Clone for VersionedChunk

fn clone(&self) -> VersionedChunk

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VersionedChunk

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

Formats the value using the given formatter.