sendly 3.30.0

Official Rust SDK for the Sendly SMS 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
102
103
104
105
106
107
108
109
110
111
112

use crate::client::Sendly;
use crate::error::{Error, Result};
use crate::models::{
    CreateDraftRequest, DraftListResponse, ListDraftsOptions, MessageDraft, RejectDraftRequest,
    UpdateDraftRequest,
};

/// Drafts resource for managing message drafts.
#[derive(Debug, Clone)]
pub struct DraftsResource<'a> {
    client: &'a Sendly,
}

impl<'a> DraftsResource<'a> {
    pub(crate) fn new(client: &'a Sendly) -> Self {
        Self { client }
    }

    /// Creates a new message draft.
    pub async fn create(&self, request: CreateDraftRequest) -> Result<MessageDraft> {
        if request.conversation_id.is_empty() {
            return Err(Error::Validation {
                message: "Conversation ID is required".to_string(),
            });
        }
        if request.text.is_empty() {
            return Err(Error::Validation {
                message: "Draft text is required".to_string(),
            });
        }

        let response = self.client.post("/drafts", &request).await?;
        let draft: MessageDraft = response.json().await?;

        Ok(draft)
    }

    /// Lists drafts with optional filtering.
    pub async fn list(&self, options: Option<ListDraftsOptions>) -> Result<DraftListResponse> {
        let query = options.map(|o| o.to_query_params()).unwrap_or_default();

        let response = self.client.get("/drafts", &query).await?;
        let result: DraftListResponse = response.json().await?;

        Ok(result)
    }

    /// Gets a draft by ID.
    pub async fn get(&self, id: &str) -> Result<MessageDraft> {
        if id.is_empty() {
            return Err(Error::Validation {
                message: "Draft ID is required".to_string(),
            });
        }

        let encoded_id = urlencoding::encode(id);
        let path = format!("/drafts/{}", encoded_id);
        let response = self.client.get(&path, &[]).await?;
        let draft: MessageDraft = response.json().await?;

        Ok(draft)
    }

    /// Updates a draft.
    pub async fn update(&self, id: &str, request: UpdateDraftRequest) -> Result<MessageDraft> {
        if id.is_empty() {
            return Err(Error::Validation {
                message: "Draft ID is required".to_string(),
            });
        }

        let encoded_id = urlencoding::encode(id);
        let path = format!("/drafts/{}", encoded_id);
        let response = self.client.patch(&path, &request).await?;
        let draft: MessageDraft = response.json().await?;

        Ok(draft)
    }

    /// Approves a draft for sending.
    pub async fn approve(&self, id: &str) -> Result<MessageDraft> {
        if id.is_empty() {
            return Err(Error::Validation {
                message: "Draft ID is required".to_string(),
            });
        }

        let encoded_id = urlencoding::encode(id);
        let path = format!("/drafts/{}/approve", encoded_id);
        let response = self.client.post(&path, &()).await?;
        let draft: MessageDraft = response.json().await?;

        Ok(draft)
    }

    /// Rejects a draft with an optional reason.
    pub async fn reject(&self, id: &str, reason: Option<String>) -> Result<MessageDraft> {
        if id.is_empty() {
            return Err(Error::Validation {
                message: "Draft ID is required".to_string(),
            });
        }

        let encoded_id = urlencoding::encode(id);
        let path = format!("/drafts/{}/reject", encoded_id);
        let body = RejectDraftRequest { reason };
        let response = self.client.post(&path, &body).await?;
        let draft: MessageDraft = response.json().await?;

        Ok(draft)
    }
}