mailrs-mailbox 1.0.3

Mailbox metadata storage abstraction for Rust IMAP/JMAP servers: MailboxStore trait + PostgreSQL reference impl + in-memory test fixture. CONDSTORE, threading, flag ops, change tracking.
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

#![doc = include_str!("../README.md")]
#![deny(missing_docs)]
#![deny(rustdoc::broken_intra_doc_links)]

pub mod fixtures;
pub mod pg;
/// Portable [`MailboxStore`] trait — the IMAP/JMAP-shaped abstraction
/// backend implementations must satisfy.
pub mod store;
/// Pure-function helpers for message-ID parsing and thread resolution.
/// No I/O; safe to call from hot paths.
pub mod threading;
/// Store-agnostic data types ([`Mailbox`], [`Message`], [`Inserted`]…) and
/// the `FLAG_*` bitmask constants shared across every backend.
pub mod types;

// Public re-exports for the trait surface and its types.
pub use store::{MailboxStore, StoreError};
pub use types::{
    bitmask_to_maildir_flags, maildir_flags_to_bitmask, ConversationSummary, EmailAnalysisRow,
    FlagAction, FlagOp, InsertMessage, Inserted, Mailbox, MailboxStatus, Message, MessageMeta,
    QueryFilter, FLAG_ANSWERED, FLAG_DELETED, FLAG_DRAFT, FLAG_FLAGGED, FLAG_RECENT, FLAG_SEEN,
};

// Public re-exports for the PG reference implementation. Programs that
// want to stay backend-agnostic should depend on the trait via
// `&dyn MailboxStore` and avoid touching the PG-specific re-exports below.
pub use pg::{EmailAnalysisInput, PgMailboxStore};

/// Back-compat alias for the legacy struct name. Prefer [`PgMailboxStore`]
/// in new code. Will be removed in 2.0.
#[deprecated(
    since = "1.0.0",
    note = "renamed to `PgMailboxStore` to make room for the new `MailboxStore` trait"
)]
pub type LegacyMailboxStore = PgMailboxStore;