Enum SetErrorType 

#[non_exhaustive]
pub enum SetErrorType {
    Forbidden,
    OverQuota,
    TooLarge,
    RateLimit,
    NotFound,
    InvalidPatch,
    WillDestroy,
    InvalidProperties,
    Singleton,
    AlreadyExists,
    MailboxHasChild,
    MailboxHasEmail,
    TooManyKeywords,
    TooManyMailboxes,
    BlobNotFound,
    ForbiddenFrom,
    InvalidEmail,
    TooManyRecipients,
    NoRecipients,
    InvalidRecipients,
    ForbiddenMailFrom,
    ForbiddenToSend,
    CannotUnsend,
    Custom(String),
}

The machine-readable type for a SetError (RFC 8620 §5.3 and RFC 8621).

Extension crates define their own error strings via SetErrorType::custom rather than adding variants here. This keeps the base crate stable as new JMAP extension crates (calendar, contacts, etc.) are added.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Forbidden

The action would violate an ACL or other access control policy.

OverQuota

Creating or modifying the object would exceed a server quota.

TooLarge

The object is too large to be stored by the server.

RateLimit

The server is rate-limiting this client.

NotFound

The object to be updated or destroyed does not exist.

InvalidPatch

The patch object is not a valid JSON Merge Patch or cannot be applied.

WillDestroy

The client requested destruction of an object that will be destroyed implicitly when another object is destroyed.

InvalidProperties

One or more properties have invalid values.

Singleton

The object type is a singleton and cannot be created or destroyed.

AlreadyExists

An object with the same unique key already exists.

MailboxHasChild

RFC 8621 §2.5 — Mailbox has child mailboxes and cannot be destroyed.

MailboxHasEmail

RFC 8621 §2.5 — Mailbox contains emails and onDestroyRemoveEmails is false.

TooManyKeywords

RFC 8621 §5.5 — Too many keywords on the Email.

TooManyMailboxes

RFC 8621 §5.5 — Email is in too many mailboxes.

BlobNotFound

RFC 8621 §5.5 — A referenced blob was not found.

ForbiddenFrom

RFC 8621 §6.3 — The from address is not permitted for this Identity.

InvalidEmail

RFC 8621 §7.5 — The Email is invalid for submission.

TooManyRecipients

RFC 8621 §7.5 — Too many recipients.

NoRecipients

RFC 8621 §7.5 — No recipients specified.

InvalidRecipients

RFC 8621 §7.5 — One or more recipient addresses are invalid.

ForbiddenMailFrom

RFC 8621 §7.5 — The MAIL FROM address is not permitted.

ForbiddenToSend

RFC 8621 §7.5 — The user does not have send permission.

CannotUnsend

RFC 8621 §7.5 — The submission cannot be undone.

Custom(String)

An extension-defined error type not covered by the variants above. Serializes as the inner string directly (e.g. "mdnAlreadySent").

Implementations

impl SetErrorType

pub fn custom(s: impl Into<String>) -> Self

Construct a SetErrorType::Custom from any string.

Use this in extension crates to emit domain-specific error types without adding variants to this enum.

Trait Implementations

impl Clone for SetErrorType

fn clone(&self) -> SetErrorType

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SetErrorType

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SetErrorType

fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for SetErrorType

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

Formats the value using the given formatter.

impl PartialEq for SetErrorType

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SetErrorType

fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SetErrorType