Struct ProtonClient 

pub struct ProtonClient<M = ReadOnly> { /* private fields */ }

IMAP client for Proton Mail via Proton Bridge.

The type parameter M controls which operations are available:

M	Read ops	Write ops
ReadOnly	yes	no
ReadWrite	yes	yes

Implementations

impl<M> ProtonClient<M>

pub const fn new(config: ImapConfig) -> Self

impl<M: Send + Sync> ProtonClient<M>

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

List all available IMAP folders.

Errors

Returns an error if the connection or LIST command fails.

pub async fn fetch_uid(&self, folder: &Folder, uid: u32) -> Result<Email>

Fetch a single email by UID from a folder.

Errors

Returns an error if the connection, SELECT, or FETCH fails, or if the message body cannot be parsed.

pub async fn fetch_unseen(&self, folder: &Folder) -> Result<Vec<Email>>

Fetch all unseen emails from a folder.

Errors

Returns an error if the connection, SELECT, or SEARCH fails.

pub async fn fetch_all(&self, folder: &Folder) -> Result<Vec<Email>>

Fetch all emails from a folder.

Errors

Returns an error if the connection, SELECT, or SEARCH fails.

pub async fn fetch_last_n( &self, folder: &Folder, n: usize, ) -> Result<Vec<Email>>

Fetch the N most recent emails from a folder.

Errors

Returns an error if the connection, SELECT, SEARCH, or FETCH fails.

pub async fn fetch_date_range( &self, folder: &Folder, since: NaiveDate, before: NaiveDate, ) -> Result<Vec<Email>>

Fetch emails within a date range from a folder.

IMAP semantics: SINCE >= date, BEFORE < date.

Errors

Returns an error if the connection, SELECT, or SEARCH fails.

pub async fn search(&self, folder: &Folder, query: &str) -> Result<Vec<Email>>

Search emails using an arbitrary IMAP search query.

Errors

Returns an error if the connection, SELECT, or SEARCH fails.

impl ProtonClient<ReadWrite>

pub async fn move_to_folder( &self, uid: u32, from: &Folder, to: &Folder, ) -> Result<()>

Move an email from one folder to another.

Selects from, copies the message to to, marks it \Deleted in the source folder, and expunges.

Errors

Returns an error if any IMAP command fails.

pub async fn add_flag( &self, uid: u32, folder: &Folder, flag: &Flag, ) -> Result<()>

Add a flag to an email.

Errors

Returns an error if the connection, SELECT, or STORE fails.

pub async fn remove_flag( &self, uid: u32, folder: &Folder, flag: &Flag, ) -> Result<()>

Remove a flag from an email.

Errors

Returns an error if the connection, SELECT, or STORE fails.

pub async fn archive(&self, uid: u32, from: &Folder) -> Result<()>

Archive an email by moving it to the Archive folder.

Errors

Returns an error if the move operation fails.

pub async fn unmark_all_read(&self, folder: &Folder) -> Result<()>

Remove the \Seen flag from all messages in a folder.

Errors

Returns an error if the connection, SELECT, SEARCH, or STORE fails.