yopmail-client 0.4.0

Unofficial async client for YOPmail: list inboxes, fetch (HTML/raw), send, attachments
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

//! Data models returned by YOPmail operations.
//!
//! These types intentionally keep fields as simple strings and `Option<String>` values to reflect
//! the underlying HTML sources. Fields may be absent or change based on YOPmail's markup.
use serde::Serialize;

/// Summary information for a mailbox message.
#[derive(Debug, Clone, Serialize)]
/// A message summary parsed from the inbox HTML.
///
/// This is typically produced by [`YopmailClient::list_messages`](crate::YopmailClient::list_messages).
pub struct Message {
    /// Message identifier as found in the inbox DOM (for example `me_...`).
    ///
    /// This value is suitable for passing to [`YopmailClient::fetch_message_full`](crate::YopmailClient::fetch_message_full).
    pub id: String,
    /// Subject line as displayed in the inbox.
    pub subject: String,
    /// Sender display value as displayed in the inbox (may be missing).
    pub sender: Option<String>,
    /// Time as displayed in the inbox (may be missing).
    pub time: Option<String>,
}

/// Attachment metadata from a message.
#[derive(Debug, Clone, Serialize)]
/// An attachment link extracted from a message view.
pub struct Attachment {
    /// Best-effort attachment name (from link title/text), if available.
    pub name: Option<String>,
    /// Download URL for the attachment (absolute or resolved against the client's base URL).
    pub url: String,
}

/// Full message content including text, HTML, and attachments.
#[derive(Debug, Clone, Serialize)]
/// Full content of a fetched message.
pub struct MessageContent {
    /// Best-effort plain text extracted from the message HTML with whitespace normalized.
    pub text: String,
    /// Best-effort HTML extracted from the message container.
    pub html: String,
    /// Raw HTML response body returned by the server.
    pub raw: String,
    /// Best-effort list of unique attachment links found in the message.
    pub attachments: Vec<Attachment>,
}