Struct HypermediaStore 

pub struct HypermediaStore { /* private fields */ }

On-disk library store (whole-file JSON, write-temp-then-rename), matching the sibling-store convention.

Implementations

impl HypermediaStore

pub fn open(storage_root: impl AsRef<Path>) -> Result<Self>

pub fn load(&self) -> Result<Vec<LibraryEntry>>

pub fn add(&self, entry: LibraryEntry) -> Result<()>

Add (or replace by asset_uri) an entry.

pub fn replace_all(&self, entries: &[LibraryEntry]) -> Result<()>

Replace the entire library (used by bulk seed paths — one write).

pub fn all(&self) -> Result<Vec<LibraryEntry>>

Everything in the library (newest first).

pub fn by_section(&self, section: LibrarySection) -> Result<Vec<LibraryEntry>>

Entries in one product section (all = everything).

pub fn section_counts(&self) -> Result<BTreeMap<String, usize>>

Counts per section for the section rail UI.

pub fn set_commons_visibility( &self, asset_uri: &str, visibility: CommonsVisibility, ) -> Result<LibraryEntry>

Publish (or revoke) commons visibility — never allowed for Secret / high sensitivity.

pub fn search(&self, facet: &str, value: &str) -> Result<Vec<LibraryEntry>>

Run a graph query over the union of all entries’ quins, returning matching entries. facet is one of topic | depicts | place | project | purpose.

pub fn search_time_range( &self, start: i64, end: i64, ) -> Result<Vec<LibraryEntry>>

The timeline query — entries whose event instant is within [start, end] (unix seconds).

pub fn search_text(&self, query: &str) -> Result<Vec<LibraryEntry>>

Free-text filter over uri, excerpt, topics, projects, purposes, place (case-insensitive).

pub fn query_faceted( &self, filter: &FacetFilter, sort: LibrarySort, ) -> Result<Vec<LibraryEntry>>

Multi-facet filter + sort. Facets are AND across dimensions; within each non-empty list, match is OR (any of the selected values).

Categories match topics containing the slug or projects of form category:{slug}.

pub fn facet_counts(&self, filter: &FacetFilter) -> Result<FacetCounts>

Facet value counts over entries matching filter (for chip UI). Counts are computed after the filter so selecting a category narrows other facet tallies.

pub fn remove(&self, asset_uri: &str) -> Result<bool>

Remove an entry by asset_uri.

pub fn stats(&self) -> Result<LibraryStats>

Library stats for the UI chrome.

pub fn all_quins(&self) -> Result<Vec<NQuin>>

Flatten all library quins for graph export / daemon inject (caller owns the slice).