Method put

nodedb/src/engine/sparse/btree.rs:109–135

Insert or update a document (tenant-scoped). Returns the prior bytes when this write replaced an existing document, or `None` when it was a fresh insert. Callers thread the prior value into Event Plane emission so the `WriteOp` tag (Insert vs Update) reflects the actual mutation — there is no separate probe.

(
        &self,
        tenant_id: u64,
        collection: &str,
        document_id: &str,
        value: &[u8],
    )

    /// into Event Plane emission so the `WriteOp` tag (Insert vs Update)
    /// reflects the actual mutation — there is no separate probe.
    pub fn put(
        &self,
        tenant_id: u64,
        collection: &str,
        document_id: &str,
        value: &[u8],
    ) -> crate::Result<Option<Vec<u8>>> {
        with_tenant_key(tenant_id, collection, document_id, |key| {
            let write_txn = self
                .db
                .begin_write()
                .map_err(|e| redb_err("write txn", e))?;
            let prior = {
                let mut table = write_txn
                    .open_table(DOCUMENTS)
                    .map_err(|e| redb_err("open table", e))?;
                table
                    .insert(key, value)
                    .map_err(|e| redb_err("insert", e))?
                    .map(|g| g.value().to_vec())
            };
            write_txn.commit().map_err(|e| redb_err("commit", e))?;

            debug!(collection, document_id, len = value.len(), "document put");
            Ok(prior)
        })
    }

    /// Insert or update a document within an externally-owned write transaction.
    /// Same prior-bytes semantics as [`SparseEngine::put`].