kmp-adapter-embedded 0.1.2

Embedded edition storage adapters: every KMP kernel port on a single local redb file
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

use kmp_domain::{KmpBundle, PortError, SnapshotSaveOptions, SnapshotStore};

use super::store::{EmbeddedKernelStore, SNAPSHOTS, commit_error, storage_error, table_error};

impl SnapshotStore for EmbeddedKernelStore {
    async fn save_bundle_with_options(
        &self,
        bundle: &KmpBundle,
        options: SnapshotSaveOptions,
    ) -> Result<(), PortError> {
        // The snapshot port is write-only; persist an auditable summary keyed
        // by (root, role) so a stored decision context can be accounted for
        // offline. Full bundle rendering stays above the ports.
        let root_node_id = bundle.root_node().node_id().to_string();
        let role = bundle.role().as_str().to_string();
        let record = serde_json::json!({
            "root_node_id": root_node_id,
            "role": role,
            "neighbor_node_ids": bundle
                .neighbor_nodes()
                .iter()
                .map(|node| node.node_id())
                .collect::<Vec<_>>(),
            "relationship_count": bundle.relationships().len(),
            "node_detail_count": bundle.node_details().len(),
            "ttl_seconds": options.ttl_seconds(),
        });
        let bytes = serde_json::to_vec(&record).map_err(|error| {
            PortError::InvalidState(format!(
                "embedded store could not encode snapshot summary: {error}"
            ))
        })?;

        self.run(move |store| {
            let tx = store.begin_write()?;
            {
                let mut snapshots = tx.open_table(SNAPSHOTS).map_err(table_error)?;
                snapshots
                    .insert((root_node_id.as_str(), role.as_str()), bytes.as_slice())
                    .map_err(storage_error)?;
            }
            tx.commit().map_err(commit_error)
        })
        .await
    }
}