backbone-email 3.10.0

Backbone Framework Email Module - SMTP support
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
124
125
126
127
128
129
130
131
132
133
134

//! Backbone Framework Email Module
//!
//! Provides email functionality with SMTP support.
//!
//! ## Features
//!
//! - **SMTP Provider**: Direct SMTP server support
//! - **Template Support**: Handlebars template rendering
//! - **Async/Await**: Full async support with tokio
//! - **Attachments**: File attachment support
//! - **Bulk Email**: Send to multiple recipients
//! - **Email Tracking**: Track delivery status
//!
//! ## Quick Start
//!
//! ```ignore
//! use backbone_email::{EmailService, SmtpProvider, EmailMessage};
//!
//! // SMTP email service
//! let email_service = SmtpProvider::new("smtp.gmail.com", 587)
//!     .with_credentials("user@example.com", "password")
//!     .build();
//!
//! // Send email
//! let message = EmailMessage::builder()
//!     .from("sender@example.com")
//!     .to("recipient@example.com")
//!     .subject("Hello")
//!     .text("This is a test email")
//!     .build();
//!
//! let result = email_service.send(message).await?;
//! ```

pub mod smtp;
pub mod traits;
pub mod types;

pub use traits::*;
pub use types::*;
pub use smtp::*;

/// Email module version
pub const VERSION: &str = env!("CARGO_PKG_VERSION");

/// Default email port for SMTP
pub const DEFAULT_SMTP_PORT: u16 = 587;

/// Maximum attachment size (25MB)
pub const MAX_ATTACHMENT_SIZE: usize = 25 * 1024 * 1024;

/// Email error types
#[derive(thiserror::Error, Debug)]
pub enum EmailError {
    #[error("SMTP connection error: {0}")]
    SmtpConnection(String),

    #[error("SMTP authentication error: {0}")]
    SmtpAuth(String),

    #[error("SMTP send error: {0}")]
    SmtpSend(String),

    #[error("Template rendering error: {0}")]
    TemplateError(String),

    #[error("Invalid email address: {0}")]
    InvalidEmail(String),

    #[error("Attachment error: {0}")]
    AttachmentError(String),

    #[error("Configuration error: {0}")]
    ConfigError(String),

    #[error("Network error: {0}")]
    NetworkError(String),

    #[error("Email error: {0}")]
    Other(String),
}

/// Result type for email operations
pub type EmailResult<T> = Result<T, EmailError>;

/// Email service configuration
#[derive(Debug, Clone)]
pub struct EmailConfig {
    /// SMTP configuration (optional)
    pub smtp: Option<SmtpConfig>,

    /// Default sender email
    pub default_sender: Option<String>,

    /// Default reply-to email
    pub default_reply_to: Option<String>,

    /// Enable email tracking
    pub enable_tracking: bool,

    /// Maximum retry attempts
    pub max_retries: u32,

    /// Retry delay in seconds
    pub retry_delay: u64,
}

impl Default for EmailConfig {
    fn default() -> Self {
        Self {
            smtp: None,
            default_sender: None,
            default_reply_to: None,
            enable_tracking: false,
            max_retries: 3,
            retry_delay: 5,
        }
    }
}

/// Email provider types
#[derive(Debug, Clone)]
pub enum EmailProvider {
    Smtp,
}

impl EmailProvider {
    /// Get provider name
    pub fn name(&self) -> &'static str {
        match self {
            Self::Smtp => "smtp",
        }
    }
}