datum_persistence/
snapshot.rs1use crate::{PersistenceId, PersistenceResult, SequenceNr, SerializedPayload};
4
5#[derive(Debug, Clone, PartialEq, Eq)]
7pub struct SnapshotMetadata {
8 pub persistence_id: PersistenceId,
10 pub sequence_nr: SequenceNr,
12 pub timestamp_ms: i64,
14}
15
16#[derive(Debug, Clone, Copy, PartialEq, Eq)]
18pub struct SnapshotCriteria {
19 pub min_sequence_nr: SequenceNr,
21 pub max_sequence_nr: SequenceNr,
23 pub min_timestamp_ms: i64,
25 pub max_timestamp_ms: i64,
27}
28
29impl SnapshotCriteria {
30 #[must_use]
32 pub const fn latest() -> Self {
33 Self {
34 min_sequence_nr: SequenceNr::new(0),
35 max_sequence_nr: SequenceNr::new(u64::MAX),
36 min_timestamp_ms: i64::MIN,
37 max_timestamp_ms: i64::MAX,
38 }
39 }
40
41 #[must_use]
43 pub const fn none() -> Self {
44 Self {
45 min_sequence_nr: SequenceNr::new(1),
46 max_sequence_nr: SequenceNr::new(0),
47 min_timestamp_ms: i64::MIN,
48 max_timestamp_ms: i64::MAX,
49 }
50 }
51
52 #[must_use]
54 pub fn matches(&self, metadata: &SnapshotMetadata) -> bool {
55 self.min_sequence_nr <= metadata.sequence_nr
56 && metadata.sequence_nr <= self.max_sequence_nr
57 && self.min_timestamp_ms <= metadata.timestamp_ms
58 && metadata.timestamp_ms <= self.max_timestamp_ms
59 }
60}
61
62impl Default for SnapshotCriteria {
63 fn default() -> Self {
64 Self::latest()
65 }
66}
67
68#[derive(Debug, Clone, PartialEq, Eq)]
70pub struct SelectedSnapshot {
71 pub metadata: SnapshotMetadata,
73 pub adapter_manifest: String,
75 pub state: SerializedPayload,
77}
78
79#[async_trait::async_trait]
81pub trait SnapshotStore: Send + Sync {
82 async fn load(
88 &self,
89 persistence_id: &PersistenceId,
90 criteria: &SnapshotCriteria,
91 ) -> PersistenceResult<Option<SelectedSnapshot>>;
92
93 async fn save(
96 &self,
97 metadata: SnapshotMetadata,
98 adapter_manifest: String,
99 state: SerializedPayload,
100 ) -> PersistenceResult<()>;
101
102 async fn delete(&self, metadata: SnapshotMetadata) -> PersistenceResult<()>;
104
105 async fn delete_matching(
107 &self,
108 persistence_id: &PersistenceId,
109 criteria: &SnapshotCriteria,
110 ) -> PersistenceResult<()>;
111}