Struct Annotation 

#[non_exhaustive]
pub struct Annotation {
    pub id: Option<Id>,
    pub related_type: String,
    pub related_id: Id,
    pub is_private: Option<bool>,
    pub extra: Map<String, Value>,
}

General-purpose vendor metadata (draft-ietf-jmap-metadata-01 §2.1.1).

The @type wire value is "Annotation"; it is supplied by the enclosing Metadata tag and does NOT appear as a field on this struct.

Vendor-specific properties (§2.2.1.6)

Annotations are designed to carry arbitrary vendor-defined properties beyond the common fields below. Vendor properties MUST be prefixed with a domain name owned by the vendor, e.g. acme.example.com:color. Those fields are captured in extra and round-trip losslessly per the workspace extras-preservation policy.

id is server-set

On Metadata/set create operations the client omits id; the server assigns it. id is Option<Id> so client-side request construction is natural.

isPrivate default

Per §2.2.1.5 the default is false. The field is Option<bool> so callers can distinguish “explicitly false on the wire” from “absent”. Wire-omitted defaults to shared.

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: Option<Id>

Server-assigned identifier. Absent on create requests.

related_type: String

JMAP type name of the related object (e.g. "Email", "Mailbox"). Mandatory per §2.2.1.3.

related_id: Id

Identifier of the related JMAP object. Mandatory per §2.2.1.4.

is_private: Option<bool>

Whether this annotation is private to the authenticated user. Default false per §2.2.1.5.

extra: Map<String, Value>

Vendor-specific properties (§2.2.1.6) and any other extension fields not covered by the typed fields above.

Captures every JSON key on the wire that is not @type, id, relatedType, relatedId, or isPrivate. Vendor properties are domain-prefixed strings (e.g. acme.example.com:color) per the spec’s naming requirement.

Round-trips losslessly per the workspace extras-preservation policy (see workspace AGENTS.md). Empty-map case serialises to nothing, preserving wire-byte identity with the spec examples.

Trait Implementations

impl Clone for Annotation

fn clone(&self) -> Annotation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Annotation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Annotation

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Annotation

fn eq(&self, other: &Annotation) -> 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 Annotation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Annotation