sos-protocol 0.17.1

Networking and sync protocol types for the Save Our Secrets SDK.
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

include!(concat!(env!("OUT_DIR"), "/notifications.rs"));

use crate::{Error, ProtoBinding, Result};
use sos_core::{commit::CommitHash, AccountId};
use sos_sync::MergeOutcome;

/// Notification sent by the server when changes were made.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct NetworkChangeEvent {
    /// Account identifier.
    account_id: AccountId,
    /// Connection identifier that made the change.
    connection_id: String,
    /// Root commit for the entire account.
    root: CommitHash,
    /// Merge outcome.
    outcome: MergeOutcome,
}

impl NetworkChangeEvent {
    /// Create a new change notification.
    pub fn new(
        account_id: &AccountId,
        connection_id: String,
        root: CommitHash,
        outcome: MergeOutcome,
    ) -> Self {
        Self {
            account_id: *account_id,
            connection_id,
            root,
            outcome,
        }
    }

    /// AccountId of the account owner.
    pub fn account_id(&self) -> &AccountId {
        &self.account_id
    }

    /// Connection identifier.
    pub fn connection_id(&self) -> &str {
        &self.connection_id
    }

    /// Account root commit hash.
    pub fn root(&self) -> &CommitHash {
        &self.root
    }

    /// Merge outcome.
    pub fn outcome(&self) -> &MergeOutcome {
        &self.outcome
    }
}

impl From<NetworkChangeEvent>
    for (AccountId, String, CommitHash, MergeOutcome)
{
    fn from(value: NetworkChangeEvent) -> Self {
        (
            value.account_id,
            value.connection_id,
            value.root,
            value.outcome,
        )
    }
}

impl ProtoBinding for NetworkChangeEvent {
    type Inner = WireNetworkChangeEvent;
}

impl TryFrom<WireNetworkChangeEvent> for NetworkChangeEvent {
    type Error = Error;

    fn try_from(value: WireNetworkChangeEvent) -> Result<Self> {
        let account_id: [u8; 20] = value.account_id.as_slice().try_into()?;
        Ok(Self {
            account_id: account_id.into(),
            connection_id: value.connection_id,
            root: value.root.unwrap().try_into()?,
            outcome: value.outcome.unwrap().try_into()?,
        })
    }
}

impl From<NetworkChangeEvent> for WireNetworkChangeEvent {
    fn from(value: NetworkChangeEvent) -> WireNetworkChangeEvent {
        Self {
            account_id: value.account_id().as_ref().to_vec(),
            connection_id: value.connection_id,
            root: Some(value.root.into()),
            outcome: Some(value.outcome.into()),
        }
    }
}