anypost 1.0.0

Official Rust SDK for the Anypost 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

use std::sync::Arc;

use serde::Serialize;

use crate::error::Result;
use crate::http::HttpClient;
use crate::resources::{enc, to_value};
use crate::response::{Page, Response};
use crate::transport::Method;
use crate::types::params::SuppressionListParams;

/// Operations on the `/suppressions` endpoints. Entries key on `(email, topic)`.
pub struct Suppressions {
    http: Arc<HttpClient>,
}

impl Suppressions {
    pub(crate) fn new(http: Arc<HttpClient>) -> Self {
        Self { http }
    }

    /// List the team's suppressions, newest-first. Expired rows are filtered out.
    pub async fn list(&self, params: SuppressionListParams) -> Result<Page> {
        self.http.list("/suppressions", Self::query(params)).await
    }

    /// List every suppression, walking all pages.
    pub async fn list_all(&self, params: SuppressionListParams) -> Result<Vec<Response>> {
        let mut query = Self::query(params);
        query.retain(|(key, _)| *key != "after");
        self.http.list_all("/suppressions", query).await
    }

    /// Add a manual suppression. Defaults to topic `*` (every topic). Raises
    /// `validation_error` if an active entry for the same `(email, topic)` exists.
    pub async fn create(&self, body: impl Serialize) -> Result<Response> {
        self.http
            .request_object(
                Method::Post,
                "/suppressions",
                Some(to_value(body)?),
                false,
                None,
            )
            .await
    }

    /// Retrieve the suppression for an `(email, topic)` pair. Use `*` as the
    /// topic for the global row.
    pub async fn get(&self, email: &str, topic: &str) -> Result<Response> {
        self.http
            .request_object(
                Method::Get,
                &format!("/suppressions/{}/{}", enc(email), enc(topic)),
                None,
                false,
                None,
            )
            .await
    }

    /// Remove the single `(email, topic)` row. Other topics are untouched.
    pub async fn delete(&self, email: &str, topic: &str) -> Result<()> {
        self.http
            .request_empty(
                Method::Delete,
                &format!("/suppressions/{}/{}", enc(email), enc(topic)),
            )
            .await
    }

    /// List every suppression on file for an address, across all topics. Raises
    /// `not_found` if the address has no active suppressions.
    pub async fn list_for_email(&self, email: &str) -> Result<Vec<Response>> {
        self.http
            .request_data(Method::Get, &format!("/suppressions/{}", enc(email)))
            .await
    }

    /// Remove an address from the suppression list across every topic.
    pub async fn delete_for_email(&self, email: &str) -> Result<()> {
        self.http
            .request_empty(Method::Delete, &format!("/suppressions/{}", enc(email)))
            .await
    }

    fn query(params: SuppressionListParams) -> Vec<(&'static str, Option<String>)> {
        vec![
            ("limit", params.limit.map(|n| n.to_string())),
            ("after", params.after),
            ("email_contains", params.email_contains),
            ("topic", params.topic),
            ("reason", params.reason),
            ("origin", params.origin),
        ]
    }
}