millionsend 0.1.0

Official Rust SDK for MillionSend — a self-hostable, Resend-compatible email API.
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

use std::sync::Arc;

use crate::error::Result;
use crate::http::Config;
use crate::types::{
    list_query, Contact, ContactAddress, ContactId, ContactListItem, ContactTopicUpdate,
    CreateContactOptions, DeleteContactResponse, List, ListOptions, UpdateContactOptions,
    UpdateContactTopicsResponse,
};

/// Contacts — addressable by id or email (email wins), scoped to an audience or
/// top-level. Mirrors Resend's `contacts` resource, plus a nested `topics`.
#[derive(Clone)]
pub struct Contacts {
    config: Arc<Config>,
    pub topics: ContactTopics,
}

impl Contacts {
    pub(crate) fn new(config: Arc<Config>) -> Self {
        Contacts {
            topics: ContactTopics(config.clone()),
            config,
        }
    }

    /// `POST /audiences/:audienceId/contacts` (or `POST /contacts` when
    /// `audience_id` is unset).
    pub async fn create(&self, contact: &CreateContactOptions) -> Result<ContactId> {
        let segments = match &contact.audience_id {
            Some(audience_id) => vec!["audiences", audience_id.as_str(), "contacts"],
            None => vec!["contacts"],
        };
        self.config.post(&segments, contact, None).await
    }

    /// `GET /contacts/:idOrEmail` (audience-scoped when the address carries one).
    pub async fn get(&self, address: impl Into<ContactAddress>) -> Result<Contact> {
        let address = address.into();
        self.config.get(&contact_segments(&address), &[]).await
    }

    /// `PATCH /contacts/:idOrEmail` — `null` clears a field, omitted leaves it.
    pub async fn update(
        &self,
        address: impl Into<ContactAddress>,
        changes: &UpdateContactOptions,
    ) -> Result<ContactId> {
        let address = address.into();
        self.config
            .patch(&contact_segments(&address), changes)
            .await
    }

    /// `DELETE /contacts/:idOrEmail`
    pub async fn delete(
        &self,
        address: impl Into<ContactAddress>,
    ) -> Result<DeleteContactResponse> {
        let address = address.into();
        self.config.delete(&contact_segments(&address)).await
    }

    /// `GET /audiences/:audienceId/contacts` (or `GET /contacts`).
    pub async fn list(
        &self,
        audience_id: Option<&str>,
        options: Option<&ListOptions>,
    ) -> Result<List<ContactListItem>> {
        let segments = match audience_id {
            Some(audience_id) => vec!["audiences", audience_id, "contacts"],
            None => vec!["contacts"],
        };
        self.config.get(&segments, &list_query(options)).await
    }
}

/// Per-contact topic subscriptions (opt a contact in/out of a topic).
#[derive(Clone)]
pub struct ContactTopics(pub(crate) Arc<Config>);

impl ContactTopics {
    /// `PATCH /contacts/:idOrEmail/topics` with a bare array of updates.
    pub async fn update(
        &self,
        address: impl Into<ContactAddress>,
        topics: &[ContactTopicUpdate],
    ) -> Result<UpdateContactTopicsResponse> {
        let address = address.into();
        self.0
            .patch(&["contacts", address.key(), "topics"], topics)
            .await
    }
}

fn contact_segments(address: &ContactAddress) -> Vec<&str> {
    match &address.audience_id {
        Some(audience_id) => vec!["audiences", audience_id.as_str(), "contacts", address.key()],
        None => vec!["contacts", address.key()],
    }
}