Struct UnifiedVolumeBuilder 

pub struct UnifiedVolumeBuilder { /* private fields */ }

Incremental builder for large external-sort merges (one SuperBlock at a time).

Implementations

impl UnifiedVolumeBuilder

pub fn with_lex_map(lex: &HashMap<u64, String>) -> Result<Self, LexError>

pub fn with_lex_entries( lex: &HashMap<u64, LexiconEntry>, ) -> Result<Self, LexError>

Create a builder with a lexicon that supports embedded triples (LexiconEntry).

pub fn with_empty_lex() -> Self

pub fn with_volume_manifest(self, manifest: &Q42VolumeManifest) -> Result<Self>

Embed an immutable logical-volume descriptor in this root Q42 file’s front matter. Child segments remain ordinary self-contained Q42 files.

pub fn with_author_did(self, did: u64) -> Self

Set the author DID for DAG commit nodes (optional; defaults to 0 = system).

pub fn with_permissive_commons(self) -> Self

Affirm this tiny embedded volume is a Permissive Commons catalog.

pub fn with_sanctuary(self) -> Self

Affirm this volume is Sanctuary / Selfhood.

pub fn push_block(&mut self, seq_id: u64, quins: &[NQuin]) -> Result<()>

pub fn block_count(&self) -> u64

pub fn finish(self, path: &Path) -> Result<()>

pub fn finish_to_bytes(self) -> Vec<u8>

Serialise the unified v3 .q42 volume to an in-memory byte buffer.

Byte-for-byte the same volume finish writes to disk, but returned as bytes for callers that embed a .q42 inside another container — e.g. a crate::bundle .hmc pack — or ship it over the wire without touching the filesystem. finish is exactly this plus a file write.