Skip to main content

coven_database/
database_device.rs

1//! Device-reset notices and committed member lists (ยง19.3, E5).
2
3use super::{DbError, StoreDatabase};
4use crate::{LiveQuery, NewOperation, PendingValue, ProviderAccessChange};
5use coven_foundation::files::DeviceReset;
6use coven_foundation::locks::read_unpoisoned;
7
8impl StoreDatabase {
9    /// Commit carried provider cleanup with the replacement notice before
10    /// publication. A resumed bootstrap cannot import the same work twice.
11    pub async fn record_device_reset<P: PendingValue>(
12        &self,
13        reset: DeviceReset,
14        operations: Vec<NewOperation>,
15        provider_access: Vec<ProviderAccessChange>,
16    ) -> Result<(), DbError> {
17        self.call(move |inner| {
18            inner.access.with_writer(|writer, _| {
19                writer.transaction(|db| {
20                    if crate::device_reset::read(db)? == Some(reset) {
21                        return Ok(());
22                    }
23                    for operation in &operations {
24                        crate::operation::insert(db, operation)?;
25                    }
26                    crate::provider_access::adopt::<P>(db, &provider_access)?;
27                    crate::device_reset::record(db, &reset)
28                })
29            })
30        })
31        .await
32    }
33
34    /// This installation's device id, or `StoreClosed` once closed.
35    pub(crate) fn local_device(&self) -> Result<coven_foundation::id_source::DeviceId, DbError> {
36        let guard = read_unpoisoned(&self.inner);
37        Ok(guard.as_ref().ok_or(DbError::StoreClosed)?.access.device)
38    }
39
40    /// Store members and every device they registered, from the committed
41    /// sequence prefix (E9). `subscribe_members` runs the same query.
42    pub async fn members(&self) -> Result<Vec<crate::MemberInfo>, DbError> {
43        let device = self.local_device()?;
44        self.read_committed(move |db| crate::members::members(db, device)).await
45    }
46
47    /// The same members query, live (E4).
48    pub fn subscribe_members<E>(&self) -> LiveQuery<Vec<crate::MemberInfo>, E>
49    where
50        E: From<DbError> + coven_foundation::task::CarriesBug + Send + 'static,
51    {
52        let device = self.local_device().ok();
53        self.follow(move |db| {
54            crate::members::members(db, device.ok_or(DbError::StoreClosed)?).map_err(E::from)
55        })
56    }
57
58    /// The circles this installation's member belongs to (E12).
59    pub async fn circles(&self) -> Result<Vec<crate::Circle>, DbError> {
60        let device = self.local_device()?;
61        self.read_committed(move |db| crate::members::circles(db, device)).await
62    }
63
64    /// The same circle-list query, live (E4).
65    pub fn subscribe_circles<E>(&self) -> LiveQuery<Vec<crate::Circle>, E>
66    where
67        E: From<DbError> + coven_foundation::task::CarriesBug + Send + 'static,
68    {
69        let device = self.local_device().ok();
70        self.follow(move |db| {
71            crate::members::circles(db, device.ok_or(DbError::StoreClosed)?).map_err(E::from)
72        })
73    }
74
75    /// A circle's members who remain in the store; none for an absent or
76    /// deleted circle (E12).
77    pub async fn circle_members(
78        &self,
79        circle: coven_foundation::id_source::CircleId,
80    ) -> Result<Vec<crate::CircleMemberInfo>, DbError> {
81        let device = self.local_device()?;
82        self.read_committed(move |db| crate::members::circle_members(db, device, circle)).await
83    }
84
85    /// The same circle-members query, live (E4).
86    pub fn subscribe_circle_members<E>(
87        &self,
88        circle: coven_foundation::id_source::CircleId,
89    ) -> LiveQuery<Vec<crate::CircleMemberInfo>, E>
90    where
91        E: From<DbError> + coven_foundation::task::CarriesBug + Send + 'static,
92    {
93        let device = self.local_device().ok();
94        self.follow(move |db| {
95            crate::members::circle_members(db, device.ok_or(DbError::StoreClosed)?, circle)
96                .map_err(E::from)
97        })
98    }
99
100    /// The latest completed replacement of this installation, or None (E5).
101    pub async fn device_reset(&self) -> Result<Option<DeviceReset>, DbError> {
102        self.read_committed(crate::device_reset::read).await
103    }
104
105    /// The same pre-built query, observing committed changes (E4).
106    pub fn subscribe_device_reset<E>(&self) -> LiveQuery<Option<DeviceReset>, E>
107    where
108        E: From<DbError> + coven_foundation::task::CarriesBug + Send + 'static,
109    {
110        self.follow(|db| crate::device_reset::read(db).map_err(E::from))
111    }
112}
113
114#[cfg(test)]
115#[path = "database_device_tests.rs"]
116mod tests;