mockforge-smtp 0.3.129

//! SMTP server mocking for MockForge
//!
//! This crate provides SMTP server functionality for MockForge, allowing you to mock
//! email servers for testing purposes.
//!
//! # Example
//!
//! ```no_run
//! use mockforge_smtp::{SmtpConfig, SmtpServer, SmtpSpecRegistry};
//! use std::sync::Arc;
//!
//! #[tokio::main]
//! async fn main() -> Result<(), Box<dyn std::error::Error>> {
//!     let config = SmtpConfig::default();
//!     let registry = Arc::new(SmtpSpecRegistry::new());
//!
//!     let server = SmtpServer::new(config, registry)?;
//!     server.start().await?;
//!
//!     Ok(())
//! }
//! ```

mod fixtures;
/// Unified protocol server lifecycle implementation
pub mod protocol_server;
mod server;
mod spec_registry;

pub use fixtures::*;
pub use server::*;
pub use spec_registry::*;

use serde::{Deserialize, Serialize};
use std::path::PathBuf;

/// SMTP server configuration
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SmtpConfig {
    /// Server port (default: 1025)
    pub port: u16,
    /// Host address (default: 0.0.0.0)
    pub host: String,
    /// Server hostname for SMTP greeting
    pub hostname: String,
    /// Directory containing fixture files
    pub fixtures_dir: Option<PathBuf>,
    /// Connection timeout in seconds
    pub timeout_secs: u64,
    /// Maximum connections
    pub max_connections: usize,
    /// Enable mailbox storage
    pub enable_mailbox: bool,
    /// Maximum mailbox size
    pub max_mailbox_messages: usize,
    /// Enable STARTTLS support
    pub enable_starttls: bool,
    /// Path to TLS certificate file
    pub tls_cert_path: Option<PathBuf>,
    /// Path to TLS private key file
    pub tls_key_path: Option<PathBuf>,
}

impl Default for SmtpConfig {
    fn default() -> Self {
        Self {
            port: 1025,
            host: "0.0.0.0".to_string(),
            hostname: "mockforge-smtp".to_string(),
            fixtures_dir: Some(PathBuf::from("./fixtures/smtp")),
            timeout_secs: 300,
            max_connections: 10,
            enable_mailbox: true,
            max_mailbox_messages: 1000,
            enable_starttls: false,
            tls_cert_path: None,
            tls_key_path: None,
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use mockforge_core::protocol_abstraction::Protocol;

    #[test]
    fn test_default_config() {
        let config = SmtpConfig::default();
        assert_eq!(config.port, 1025);
        assert_eq!(config.host, "0.0.0.0");
        assert_eq!(config.hostname, "mockforge-smtp");
    }

    #[test]
    fn test_protocol_display() {
        assert_eq!(Protocol::Smtp.to_string(), "SMTP");
    }

    #[test]
    fn test_smtp_config_all_defaults() {
        let config = SmtpConfig::default();
        assert_eq!(config.timeout_secs, 300);
        assert_eq!(config.max_connections, 10);
        assert!(config.enable_mailbox);
        assert_eq!(config.max_mailbox_messages, 1000);
        assert!(!config.enable_starttls);
        assert!(config.tls_cert_path.is_none());
        assert!(config.tls_key_path.is_none());
        assert_eq!(config.fixtures_dir, Some(PathBuf::from("./fixtures/smtp")));
    }

    #[test]
    fn test_smtp_config_serialize() {
        let config = SmtpConfig::default();
        let json = serde_json::to_string(&config).unwrap();
        assert!(json.contains("\"port\":1025"));
        assert!(json.contains("mockforge-smtp"));
    }

    #[test]
    fn test_smtp_config_deserialize() {
        let json = r#"{
            "port": 2025,
            "host": "127.0.0.1",
            "hostname": "test-smtp",
            "timeout_secs": 600,
            "max_connections": 20,
            "enable_mailbox": false,
            "max_mailbox_messages": 500,
            "enable_starttls": true,
            "fixtures_dir": "/tmp/fixtures"
        }"#;
        let config: SmtpConfig = serde_json::from_str(json).unwrap();
        assert_eq!(config.port, 2025);
        assert_eq!(config.host, "127.0.0.1");
        assert_eq!(config.hostname, "test-smtp");
        assert_eq!(config.timeout_secs, 600);
        assert_eq!(config.max_connections, 20);
        assert!(!config.enable_mailbox);
        assert!(config.enable_starttls);
    }

    #[test]
    fn test_smtp_config_clone() {
        let config = SmtpConfig::default();
        let cloned = config.clone();
        assert_eq!(config.port, cloned.port);
        assert_eq!(config.hostname, cloned.hostname);
    }

    #[test]
    fn test_smtp_config_debug() {
        let config = SmtpConfig::default();
        let debug = format!("{:?}", config);
        assert!(debug.contains("SmtpConfig"));
        assert!(debug.contains("1025"));
    }

    #[test]
    fn test_smtp_config_with_tls() {
        let config = SmtpConfig {
            enable_starttls: true,
            tls_cert_path: Some(PathBuf::from("/path/to/cert.pem")),
            tls_key_path: Some(PathBuf::from("/path/to/key.pem")),
            ..SmtpConfig::default()
        };
        assert!(config.enable_starttls);
        assert!(config.tls_cert_path.is_some());
        assert!(config.tls_key_path.is_some());
    }

    #[test]
    fn test_smtp_config_custom_fixtures_dir() {
        let config = SmtpConfig {
            fixtures_dir: Some(PathBuf::from("/custom/fixtures")),
            ..SmtpConfig::default()
        };
        assert_eq!(config.fixtures_dir, Some(PathBuf::from("/custom/fixtures")));
    }
}