use uqa_storage::{
hnsw_index::{HNSWIndex, HNSWMutation},
KeyValueBatch,
};
use super::{
mutation::{missing_metadata, next_revision},
SQLiteHNSWIndex,
};
use crate::vector_index::native::{publication::VectorPublication, NativeVectorRead};
use crate::Result;
mod cache;
mod loading;
mod records;
mod writing;
#[cfg(test)]
mod tests;
pub(super) use cache::GraphIdentity;
pub(super) use loading::load_meta;
pub(crate) use records::NativeHNSWRecords;
pub(super) use writing::drop_metadata;
impl SQLiteHNSWIndex {
pub(in crate::vector_index::hnsw) fn native_snapshot(&self) -> Result<Option<Self>> {
Ok(self.persistent.native_snapshot()?.map(|view| {
let mut snapshot = self.clone();
snapshot.persistent.retained = Some(view);
snapshot
}))
}
pub(in crate::vector_index::hnsw) fn initialize_native(
&self,
read: &NativeVectorRead<'_>,
batch: &mut dyn KeyValueBatch,
) -> Result<()> {
let expected = load_meta(read)?.map(|(_, _, _, revision)| revision);
if expected.is_none() && self.require_persisted_graph {
return Err(missing_metadata(self).into());
}
let read = read.owned(batch)?;
let entries = read.vectors()?;
let delta = HNSWIndex::prepare_canonical(
self.persistent.dimensions,
self.params,
&entries,
&read.snapshot.control,
)?;
writing::persist_delta(
&read,
batch,
self,
&delta,
next_revision(expected)?,
VectorPublication::Canonical,
)
}
pub(in crate::vector_index::hnsw) fn mutate_native(
&self,
read: &NativeVectorRead<'_>,
batch: &mut dyn KeyValueBatch,
mutation: HNSWMutation<'_>,
canonical: impl FnOnce(&NativeVectorRead<'_>, &mut dyn KeyValueBatch) -> Result<()>,
) -> Result<()> {
let Some((_, _, _, revision)) = load_meta(read)? else {
if self.require_persisted_graph {
return Err(missing_metadata(self).into());
}
return canonical(read, batch);
};
let cached = self
.cached_native_graph(read)?
.ok_or_else(|| missing_metadata(self))?;
let delta = cached.prepare_delta(mutation, &read.snapshot.control)?;
canonical(read, batch)?;
let publication = if matches!(mutation, HNSWMutation::Clear) {
VectorPublication::Canonical
} else {
let key = records::metadata_key(
read.owner.expect("persisted native HNSW owner"),
&read.index.field,
&read.snapshot.control,
)?;
batch.hnsw_mutation(&key, mutation)?;
VectorPublication::HNSWPreview
};
writing::persist_delta(
read,
batch,
self,
&delta,
next_revision(Some(revision))?,
publication,
)
}
}