Struct EmailSubmission 

#[non_exhaustive]
pub struct EmailSubmission {
    pub id: Id,
    pub identity_id: Id,
    pub email_id: Id,
    pub thread_id: Id,
    pub envelope: Option<Envelope>,
    pub send_at: UTCDate,
    pub undo_status: UndoStatus,
    pub delivery_status: Option<BTreeMap<String, DeliveryStatus>>,
    pub dsn_blob_ids: Vec<Id>,
    pub mdn_blob_ids: Vec<Id>,
    pub extra: Map<String, Value>,
}

Represents the submission of an Email for delivery (RFC 8621 §7).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: Id

Server-assigned immutable identifier for this submission.

identity_id: Id

Id of the Identity used to send this submission.

email_id: Id

Id of the Email being submitted.

thread_id: Id

Thread id of the submitted Email (server-set).

envelope: Option<Envelope>

SMTP envelope; server-derived from Email headers when absent on creation.

send_at: UTCDate

UTC timestamp when the submission was / will be released for delivery.

undo_status: UndoStatus

Whether the submission may still be canceled.

delivery_status: Option<BTreeMap<String, DeliveryStatus>>

Per-recipient delivery status, keyed by recipient email address.

None when the server does not support delivery-status tracking.

dsn_blob_ids: Vec<Id>

Blob ids of DSN messages (RFC 3464) received for this submission.

Always present in serialized output (empty array when no DSN has been received); RFC 8621 §7 requires these fields in responses. Do not add skip_serializing_if.

mdn_blob_ids: Vec<Id>

Blob ids of MDN messages (RFC 8098) received for this submission.

Always present in serialized output; same rationale as dsn_blob_ids.

extra: Map<String, Value>

Catch-all for vendor / site / private extension fields not covered by the typed fields above. Preserves unknown fields across deserialize/serialize round-trip per workspace extras-preservation policy (see workspace AGENTS.md).

Implementations

impl EmailSubmission

pub fn new( id: Id, identity_id: Id, email_id: Id, thread_id: Id, send_at: UTCDate, undo_status: UndoStatus, ) -> Self

Construct an EmailSubmission from its required fields.

envelope and delivery_status default to None. dsn_blob_ids and mdn_blob_ids default to empty.

Trait Implementations

impl Clone for EmailSubmission

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmailSubmission

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EmailSubmission

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for EmailSubmission

impl GetObject for EmailSubmission

impl JmapObject for EmailSubmission

const TYPE_NAME: &'static str = "EmailSubmission"

The JMAP type name string (e.g. "Email", "Mailbox", "Chat").

type Property = EmailSubmissionProperty

The property selector enum for this type (server-side only, no serde).

impl PartialEq for EmailSubmission

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl QueryObject for EmailSubmission

type Filter = Filter<EmailSubmissionFilterCondition>

The filter condition type.

type Comparator = EmailSubmissionComparator

The comparator type for sort operations.

impl Serialize for EmailSubmission

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl SetObject for EmailSubmission

RFC 8621 §7 (rfc8621.txt:4134-4417): id, threadId and sendAt are “(immutable; server-set)”; deliveryStatus, dsnBlobIds and mdnBlobIds are “(server-set)”; identityId, emailId and envelope are “(immutable)”; undoStatus carries no attribute.

const SERVER_SET: &'static [&'static str]

Wire names of the properties the spec marks “server-set”: “Only the server can set the value for this property. The client MUST NOT send this property when creating a new object of this type.” (RFC 8620 §1.1). A property the type’s /set method text never accepts from a client, on create or update, is server-set too.

const CLIENT_SETTABLE: &'static [&'static str]

Wire names of every property that is not SERVER_SET: the ones a client may set through /set.

const IMMUTABLE: &'static [&'static str]

The CLIENT_SETTABLE properties the spec marks “immutable”: “The value MUST NOT change after the object is created.” (RFC 8620 §1.1). A property the /set method text accepts on create but not on update is immutable too.

type Patch = PatchObject

The patch type for update operations.

impl StructuralPartialEq for EmailSubmission