liminal-sdk 0.3.3

Application-facing SDK traits for liminal messaging clients
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
103
104
105
106
107
108
109

use alloc::sync::Arc;

use spin::Mutex;

use crate::SdkError;

use super::{ConnectionEvent, ConnectionLifecycle, ConnectionState, DisconnectReason};

#[test]
fn disconnected_to_connected_is_rejected() -> Result<(), SdkError> {
    let mut lifecycle = ConnectionLifecycle::default();
    lifecycle.disconnect(DisconnectReason::Normal)?;

    assert!(lifecycle.connected().is_err());
    lifecycle.connect()?;
    lifecycle.connected()?;
    assert_eq!(lifecycle.state(), &ConnectionState::Connected);
    Ok(())
}

#[test]
fn observers_receive_successful_transitions() -> Result<(), SdkError> {
    let events = Arc::new(Mutex::new(Vec::new()));
    let observed = Arc::clone(&events);
    let mut lifecycle = ConnectionLifecycle::default();

    lifecycle.observe(move |event| observed.lock().push(event.clone()));
    lifecycle.connected()?;
    lifecycle.disconnect(DisconnectReason::Timeout)?;

    assert_eq!(events.lock().len(), 2);
    assert_eq!(
        events.lock()[0],
        ConnectionEvent::new(ConnectionState::Connecting, ConnectionState::Connected)
    );
    Ok(())
}

#[test]
fn disconnect_from_connecting_is_observable() -> Result<(), SdkError> {
    let events = Arc::new(Mutex::new(Vec::new()));
    let observed = Arc::clone(&events);
    let mut lifecycle = ConnectionLifecycle::default();

    lifecycle.observe(move |event| observed.lock().push(event.clone()));
    lifecycle.disconnect(DisconnectReason::Error)?;

    let disconnected = ConnectionState::Disconnected {
        reason: DisconnectReason::Error,
    };
    assert_eq!(lifecycle.state(), &disconnected);
    assert_eq!(
        events.lock()[0],
        ConnectionEvent::new(ConnectionState::Connecting, disconnected)
    );
    Ok(())
}

#[test]
fn externally_authorized_reconnect_has_no_delay_or_retry_counter() -> Result<(), SdkError> {
    let mut lifecycle = ConnectionLifecycle::default();
    lifecycle.connected()?;

    lifecycle.reconnect_started()?;
    assert_eq!(lifecycle.state(), &ConnectionState::Reconnecting);
    assert!(lifecycle.reconnect_started().is_err());

    lifecycle.connected()?;
    lifecycle.reconnect_started()?;
    assert_eq!(lifecycle.state(), &ConnectionState::Reconnecting);
    Ok(())
}

#[test]
fn disconnect_from_reconnecting_is_observable() -> Result<(), SdkError> {
    let events = Arc::new(Mutex::new(Vec::new()));
    let observed = Arc::clone(&events);
    let mut lifecycle = ConnectionLifecycle::default();
    lifecycle.connected()?;
    lifecycle.reconnect_started()?;

    lifecycle.observe(move |event| observed.lock().push(event.clone()));
    lifecycle.disconnect(DisconnectReason::Error)?;

    assert_eq!(
        events.lock()[0],
        ConnectionEvent::new(
            ConnectionState::Reconnecting,
            ConnectionState::Disconnected {
                reason: DisconnectReason::Error,
            },
        )
    );
    Ok(())
}

#[test]
fn disconnect_from_disconnected_is_rejected_without_mutation() -> Result<(), SdkError> {
    let mut lifecycle = ConnectionLifecycle::default();
    lifecycle.disconnect(DisconnectReason::Normal)?;
    assert!(lifecycle.disconnect(DisconnectReason::Error).is_err());
    assert_eq!(
        lifecycle.state(),
        &ConnectionState::Disconnected {
            reason: DisconnectReason::Normal,
        }
    );
    Ok(())
}