auths-id 0.1.2

Multi-device identity and attestation crate for Auths
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
98
99
100
101
102

use auths_verifier::core::Attestation;

/// Determines the commit message for an attestation export.
///
/// This is a pure function — it compares the new attestation against
/// the previous one (if any) and returns the appropriate human-readable
/// message describing the change.
///
/// Args:
/// * `attestation`: The attestation being exported.
/// * `previous`: The previously stored attestation, if any.
///
/// Usage:
/// ```ignore
/// use auths_id::domain::attestation_message::determine_commit_message;
///
/// let msg = determine_commit_message(&new_att, previous.as_ref());
/// ```
pub fn determine_commit_message(
    attestation: &Attestation,
    previous: Option<&Attestation>,
) -> &'static str {
    if attestation.is_revoked() && !previous.as_ref().is_some_and(|pa| pa.is_revoked()) {
        "Revoked device attestation"
    } else if let Some(prev) = previous {
        if *attestation != *prev {
            "Updated device attestation"
        } else {
            "Updated device attestation record (no change detected)"
        }
    } else {
        "Linked device attestation"
    }
}

#[cfg(test)]
#[allow(clippy::disallowed_methods)]
mod tests {
    use super::*;
    use auths_verifier::AttestationBuilder;
    use auths_verifier::core::ResourceId;
    use chrono::Utc;

    fn make_attestation(subject: &str, revoked: bool) -> Attestation {
        AttestationBuilder::default()
            .rid("test-rid")
            .issuer("did:keri:EIssuer")
            .subject(subject)
            .revoked_at(if revoked { Some(Utc::now()) } else { None })
            .build()
    }

    #[test]
    fn first_attestation_returns_linked() {
        let att = make_attestation("did:key:z1", false);
        assert_eq!(
            determine_commit_message(&att, None),
            "Linked device attestation"
        );
    }

    #[test]
    fn revocation_returns_revoked() {
        let att = make_attestation("did:key:z1", true);
        let prev = make_attestation("did:key:z1", false);
        assert_eq!(
            determine_commit_message(&att, Some(&prev)),
            "Revoked device attestation"
        );
    }

    #[test]
    fn changed_attestation_returns_updated() {
        let att = make_attestation("did:key:z1", false);
        let mut prev = make_attestation("did:key:z1", false);
        prev.rid = ResourceId::new("different-rid");
        assert_eq!(
            determine_commit_message(&att, Some(&prev)),
            "Updated device attestation"
        );
    }

    #[test]
    fn identical_attestation_returns_no_change() {
        let att = make_attestation("did:key:z1", false);
        let prev = att.clone();
        assert_eq!(
            determine_commit_message(&att, Some(&prev)),
            "Updated device attestation record (no change detected)"
        );
    }

    #[test]
    fn already_revoked_stays_revoked_message() {
        let att = make_attestation("did:key:z1", true);
        let prev = att.clone();
        assert_eq!(
            determine_commit_message(&att, Some(&prev)),
            "Updated device attestation record (no change detected)"
        );
    }
}