kmp-application 0.18.2

Application services behind KMP's ten memory moves and evidence-backed recall
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

use std::sync::Arc;

#[derive(Debug)]
pub struct QueryApplicationService<G, D, S> {
    pub(crate) graph_reader: Arc<G>,
    pub(crate) detail_reader: Arc<D>,
    pub(crate) snapshot_store: Arc<S>,
    pub(crate) generator_version: &'static str,
    read_snapshot_provider: Option<Arc<dyn kmp_domain::ReadSnapshotProvider<G, D>>>,
}

impl<G, D, S> QueryApplicationService<G, D, S> {
    pub fn new(
        graph_reader: Arc<G>,
        detail_reader: Arc<D>,
        snapshot_store: Arc<S>,
        generator_version: &'static str,
    ) -> Self {
        Self {
            graph_reader,
            detail_reader,
            snapshot_store,
            generator_version,
            read_snapshot_provider: None,
        }
    }
    /// Configure a backend that owns graph and bodies in one store. Without
    /// this provider separate adapters retain their best-effort read semantics.
    /// A configured provider error propagates; it never falls back to live reads.
    pub fn with_read_snapshots(
        mut self,
        provider: Arc<dyn kmp_domain::ReadSnapshotProvider<G, D>>,
    ) -> Self {
        self.read_snapshot_provider = Some(provider);
        self
    }

    pub async fn read_snapshot(&self) -> Result<Option<Self>, crate::ApplicationError> {
        let Some(provider) = &self.read_snapshot_provider else {
            return Ok(None);
        };
        let (graph, detail) = provider.open_snapshot().await?;
        Ok(Some(Self::new(
            Arc::new(graph),
            Arc::new(detail),
            Arc::clone(&self.snapshot_store),
            self.generator_version,
        )))
    }
}

impl<G: kmp_domain::GraphNeighborhoodReader + Send + Sync, D, S> QueryApplicationService<G, D, S> {
    pub(crate) async fn graph_read_revision(
        &self,
    ) -> Result<Option<kmp_domain::GraphReadRevision>, crate::ApplicationError> {
        Ok(self.graph_reader.graph_read_revision().await?)
    }

    pub async fn read_nodes(
        &self,
        request: &kmp_domain::MemoryNodesRequest,
    ) -> Result<kmp_domain::MemoryNodesResult, crate::ApplicationError> {
        Ok(self.graph_reader.load_memory_nodes(request).await?)
    }

    pub async fn evidence_paths(
        &self,
        request: &kmp_domain::EvidencePathRequest,
    ) -> Result<kmp_domain::EvidencePathResult, crate::ApplicationError> {
        request
            .validate()
            .map_err(|e| crate::ApplicationError::Validation(e.to_string()))?;
        Ok(self.graph_reader.load_evidence_paths(request).await?)
    }

    pub async fn trace_search(
        &self,
        request: &kmp_domain::TraceSearchRequest,
    ) -> Result<kmp_domain::TraceSearchResult, crate::ApplicationError> {
        Ok(self.graph_reader.load_bounded_trace(request).await?)
    }
}