Method insert

nodedb/src/engine/vector/sparse/index.rs:58–85

Insert a sparse vector for a document. Returns the internal doc ID. If the doc_id already exists, the old entries are removed first (upsert).

(&mut self, doc_id: &str, vector: &SparseVector)

    ///
    /// If the doc_id already exists, the old entries are removed first (upsert).
    pub fn insert(&mut self, doc_id: &str, vector: &SparseVector) -> u32 {
        // Upsert: remove old entries if doc already exists.
        if let Some(&existing_id) = self.doc_id_forward.get(doc_id) {
            self.remove_internal(existing_id);
            self.doc_id_forward.remove(doc_id);
            self.doc_id_reverse.remove(&existing_id);
            self.doc_count -= 1;
        }

        let internal_id = self.next_id;
        self.next_id += 1;

        self.doc_id_forward.insert(doc_id.to_string(), internal_id);
        self.doc_id_reverse.insert(internal_id, doc_id.to_string());

        let mut dims = Vec::with_capacity(vector.nnz());
        for &(dim, weight) in vector.entries() {
            self.postings
                .entry(dim)
                .or_default()
                .push((internal_id, weight));
            dims.push(dim);
        }
        self.doc_dims.insert(internal_id, dims);
        self.doc_count += 1;

        internal_id
    }

    /// Delete a document by string ID. Returns true if found and removed.
    pub fn delete(&mut self, doc_id: &str) -> bool {