wacore 0.7.0

Core WhatsApp protocol implementation without runtime dependencies
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

//! Codes sent as the `error` attribute on protocol rejection acknowledgements.
//! The server stops retransmitting on receipt; use `<receipt type="retry">`
//! instead for recoverable errors.

#[derive(Debug, Clone, Copy, PartialEq, Eq, crate::WireEnum)]
#[wire(kind = "int")]
#[allow(dead_code)]
pub enum NackReason {
    #[wire = 421]
    StaleGroupAddressingMode,
    #[wire = 475]
    NewChatMessagesCapped,
    #[wire = 487]
    ParsingError,
    #[wire = 488]
    UnrecognizedStanza,
    #[wire = 489]
    UnrecognizedStanzaClass,
    #[wire = 490]
    UnrecognizedStanzaType,
    /// WA Web pairs with `<meta failure_reason=N>` child.
    #[wire = 491]
    InvalidProtobuf,
    #[wire = 493]
    InvalidHostedCompanionStanza,
    #[wire = 495]
    MissingMessageSecret,
    #[wire = 496]
    SignalErrorOldCounter,
    #[wire = 499]
    MessageDeletedOnPeer,
    #[wire = 500]
    UnhandledError,
    #[wire = 550]
    UnsupportedAdminRevoke,
    #[wire = 551]
    UnsupportedLIDGroup,
    #[wire = 552]
    DBOperationFailed,
    #[wire_fallback]
    Unknown(i32),
}

#[cfg(test)]
mod tests {
    use super::*;

    /// Pin every code against `Create/NackFromStanza.js` so a renumber
    /// can't silently break server compatibility.
    #[test]
    fn nack_reason_codes_match_wa_web() {
        assert_eq!(NackReason::StaleGroupAddressingMode.code(), 421);
        assert_eq!(NackReason::NewChatMessagesCapped.code(), 475);
        assert_eq!(NackReason::ParsingError.code(), 487);
        assert_eq!(NackReason::UnrecognizedStanza.code(), 488);
        assert_eq!(NackReason::UnrecognizedStanzaClass.code(), 489);
        assert_eq!(NackReason::UnrecognizedStanzaType.code(), 490);
        assert_eq!(NackReason::InvalidProtobuf.code(), 491);
        assert_eq!(NackReason::InvalidHostedCompanionStanza.code(), 493);
        assert_eq!(NackReason::MissingMessageSecret.code(), 495);
        assert_eq!(NackReason::SignalErrorOldCounter.code(), 496);
        assert_eq!(NackReason::MessageDeletedOnPeer.code(), 499);
        assert_eq!(NackReason::UnhandledError.code(), 500);
        assert_eq!(NackReason::UnsupportedAdminRevoke.code(), 550);
        assert_eq!(NackReason::UnsupportedLIDGroup.code(), 551);
        assert_eq!(NackReason::DBOperationFailed.code(), 552);
    }

    #[test]
    fn nack_reason_preserves_unknown_numeric_codes() {
        assert_eq!(NackReason::from(599), NackReason::Unknown(599));
        assert_eq!(NackReason::Unknown(599).code(), 599);
    }
}