Struct Relation 

#[non_exhaustive]
pub struct Relation {
    pub at_type: Option<String>,
    pub relation: Option<HashMap<String, bool>>,
    pub extra: Map<String, Value>,
}

A relationship to another Card (RFC 9553 §2.1.8).

This is the value type for the relatedTo property on a ContactCard. Each map key is the uid of the related Card; each value is a Relation object describing the relationship.

Distinct from the JSCalendar RFC 8984 §1.4.10 type jmap_jscalendar_types::Relation: that type relates JSCalendar entries (events, tasks) via UID and has a different relation enumeration; this Relation relates JSContact Cards.

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.

at_type: Option<String>

Object type discriminator; SHOULD be "Relation" when present per RFC 9553 §1.3.4 (may be omitted in defaultType positions).

relation: Option<HashMap<String, bool>>

Set of relation types (key → true). Initial enumerated values: "acquaintance", "agent", "child", "co-resident", "co-worker", "colleague", "contact", "crush", "date", "emergency", "friend", "kin", "me", "met", "muse", "neighbor", "parent", "sibling", "spouse", "sweetheart".

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).

Trait Implementations

impl Clone for Relation

fn clone(&self) -> Relation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Relation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Relation

fn deserialize<__D>( __deserializer: __D, ) -> Result<Relation, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Relation

impl PartialEq for Relation

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Relation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Relation