wi-api 0.2.0

Official Rust SDK for the wi-api WhatsApp platform
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

use wi_api::Wi;
use wiremock::{
    matchers::{header, method, path},
    Mock, MockServer, ResponseTemplate,
};

#[test]
fn new_creates_client() {
    // Smoke test: construction and session scoping don't panic
    let wi = Wi::new("test-key");
    let _session = wi.session("my-instance");
}

#[test]
fn builder_accepts_api_key() {
    let wi = Wi::builder("custom-key").build();
    let _session = wi.session("s");
}

#[test]
fn session_clone_is_independent() {
    let wi = Wi::new("k");
    let s1 = wi.session("session-a");
    let s2 = wi.session("session-b");
    // Both sessions are usable; cloning the Wi client is cheap (Arc)
    let _s1b = s1.clone();
    let _s2b = s2.clone();
}

/// Verify that the builder trims a trailing slash on base_url so requests
/// don't produce double slashes like `//sessions/...`.
#[tokio::test]
async fn builder_trims_trailing_slash() {
    let server = MockServer::start().await;

    // MockServer::uri() has no trailing slash — we add one to test trimming
    let url_with_slash = format!("{}/", server.uri());

    Mock::given(method("GET"))
        .and(path("/sessions/s/status"))
        .and(header("x-api-key", "k"))
        .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({
            "connected": false,
            "phone": null
        })))
        .expect(1)
        .mount(&server)
        .await;

    let wi = Wi::builder("k").base_url(url_with_slash).build();
    wi.session("s").status().await.unwrap();

    // If the slash wasn't trimmed, the path would be `//sessions/s/status`
    // and wiremock would not match `/sessions/s/status`, causing expect(1) to fail.
    server.verify().await;
}

/// Verify that builder().base_url() directs requests to the custom server.
#[tokio::test]
async fn builder_custom_base_url_routes_requests() {
    let server = MockServer::start().await;

    Mock::given(method("GET"))
        .and(path("/sessions/x/status"))
        .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({
            "connected": true,
            "phone": "5511999"
        })))
        .expect(1)
        .mount(&server)
        .await;

    let wi = Wi::builder("k").base_url(server.uri()).build();
    let status = wi.session("x").status().await.unwrap();
    assert!(status.connected);
    server.verify().await;
}

/// Verify that x-api-key is sent on every request.
#[tokio::test]
async fn api_key_header_sent_on_every_request() {
    let server = MockServer::start().await;

    // Two different endpoints, same key required
    Mock::given(method("GET"))
        .and(path("/sessions/s/status"))
        .and(header("x-api-key", "my-secret-key"))
        .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({
            "connected": false, "phone": null
        })))
        .mount(&server)
        .await;

    Mock::given(method("GET"))
        .and(path("/sessions/s/qr"))
        .and(header("x-api-key", "my-secret-key"))
        .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({
            "qr": null
        })))
        .mount(&server)
        .await;

    let wi = Wi::builder("my-secret-key").base_url(server.uri()).build();
    let sess = wi.session("s");
    sess.status().await.unwrap();
    sess.qr().await.unwrap();
}