pidge-client 1.5.0

Microsoft 365 / Graph client and OAuth flows for the pidge CLI
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
110
111
112
113
114
115
116
117
118
119
120
121
122
123

//! GET /me/people: Outlook's ranked "people I interact with" list, used to
//! resolve a display name or partial address to a full e-mail address.

use serde::Deserialize;

use crate::error::ClientError;

/// A person from `/me/people`, with the first scored e-mail address Graph
/// returned (entries without any scored address are skipped entirely).
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Person {
    pub display_name: String,
    pub address: String,
}

#[derive(Deserialize)]
struct GraphPeopleList {
    value: Vec<GraphPerson>,
}

#[derive(Deserialize)]
struct GraphPerson {
    #[serde(rename = "displayName", default)]
    display_name: Option<String>,
    #[serde(rename = "scoredEmailAddresses", default)]
    scored_email_addresses: Vec<GraphScoredEmailAddress>,
}

#[derive(Deserialize)]
struct GraphScoredEmailAddress {
    address: String,
}

/// GET /me/people?$top={top}&$select=displayName,scoredEmailAddresses
pub async fn list_people(
    http: &reqwest::Client,
    base_url: &str,
    access_token: &str,
    top: usize,
) -> Result<Vec<Person>, ClientError> {
    let url = format!("{base_url}/me/people");
    let resp = super::send_with_retry(http.get(&url).bearer_auth(access_token).query(&[
        ("$top", top.to_string()),
        ("$select", "displayName,scoredEmailAddresses".to_string()),
    ]))
    .await?;
    let status = resp.status();
    if !status.is_success() {
        let text = resp.text().await.unwrap_or_default();
        return Err(ClientError::Graph {
            status: status.as_u16(),
            message: text,
        });
    }
    let list: GraphPeopleList = resp.json().await?;
    Ok(list
        .value
        .into_iter()
        .filter_map(|p| {
            let address = p.scored_email_addresses.into_iter().next()?.address;
            Some(Person {
                display_name: super::mail::clean(p.display_name),
                address,
            })
        })
        .collect())
}

#[cfg(test)]
mod tests {
    use super::*;
    use wiremock::matchers::{method, path, query_param};
    use wiremock::{Mock, MockServer, ResponseTemplate};

    #[tokio::test]
    async fn list_people_maps_one_person() {
        let server = MockServer::start().await;
        Mock::given(method("GET"))
            .and(path("/me/people"))
            .and(query_param("$top", "10"))
            .and(query_param("$select", "displayName,scoredEmailAddresses"))
            .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({
                "value": [
                    {
                        "displayName": "Anna",
                        "scoredEmailAddresses": [{"address": "anna@example.com"}]
                    }
                ]
            })))
            .mount(&server)
            .await;
        let http = reqwest::Client::new();
        let people = list_people(&http, &server.uri(), "AT", 10).await.unwrap();
        assert_eq!(people.len(), 1);
        assert_eq!(people[0].display_name, "Anna");
        assert_eq!(people[0].address, "anna@example.com");
    }

    #[tokio::test]
    async fn list_people_skips_entries_without_a_scored_address() {
        let server = MockServer::start().await;
        Mock::given(method("GET"))
            .and(path("/me/people"))
            .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({
                "value": [
                    { "displayName": "No Address", "scoredEmailAddresses": [] },
                    {
                        "displayName": "Anna",
                        "scoredEmailAddresses": [
                            {"address": "anna@example.com"},
                            {"address": "anna.alt@example.com"}
                        ]
                    }
                ]
            })))
            .mount(&server)
            .await;
        let http = reqwest::Client::new();
        let people = list_people(&http, &server.uri(), "AT", 10).await.unwrap();
        assert_eq!(people.len(), 1);
        assert_eq!(people[0].address, "anna@example.com");
    }
}