Struct EmailApi 

pub struct EmailApi { /* private fields */ }

Email API facade — typed API in [KernelHandle].

Constructed during kernel assembly (only when [email] is configured) and stored in KernelHandle.email.

Implementations

impl EmailApi

pub fn new( smtp: SmtpClient, template_dir: PathBuf, state_store: Arc<StateStore>, event_bus: Option<EventBus>, rate_limit: usize, ) -> Self

Create a new EmailApi.

pub async fn send( &self, subject: &str, html: &str, text: Option<&str>, ) -> Result<SendReceipt>

Send an email (delegated to SmtpClient).

pub async fn test_connection(&self) -> Result<()>

Test the SMTP connection.

pub fn default_to(&self) -> &str

The default recipient address (user’s own email).

pub fn from_addr(&self) -> &str

The sender address.

pub fn load_template(&self, name: &str) -> Result<String>

Load a template by name.

Templates are stored as email_templates/<name>.html.

pub fn save_template(&self, name: &str, html: &str) -> Result<()>

Save a template.

pub fn list_templates(&self) -> Result<Vec<String>>

List all available template names.

pub async fn save_sent_record<T: Serialize>(&self, record: &T) -> Result<()>

Save a sent email record to the state store.

Filename format: {timestamp}_{short_id}.json for rate-limit parsing.

pub async fn count_recent_sent(&self, hours: u64) -> Result<usize>

Count emails sent in the last hours hours (for rate limiting).

Expects filenames: YYYYMMDD_HHMMSS_shortid.json

pub fn notify_sent( &self, subject: String, message_id: String, template_name: Option<String>, )

Publish an EmailSent event to the event bus.

pub fn rate_limit(&self) -> usize

Rate limit (emails per hour).

Trait Implementations

impl Clone for EmailApi

fn clone(&self) -> EmailApi

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EmailApi

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.