Struct PrincipalCalendarsCapability 

#[non_exhaustive]
pub struct PrincipalCalendarsCapability {
    pub account_id: Option<Id>,
    pub may_get_availability: bool,
    pub may_share_with: bool,
    pub calendar_address: Option<String>,
}

The value of Principal.capabilities["urn:ietf:params:jmap:calendars"] on a JMAP Principals object (draft-ietf-jmap-calendars-33 §2.1).

This is distinct from the session-level CalendarsCapability. Where CalendarsCapability appears in the JMAP Session capabilities map, PrincipalCalendarsCapability appears inside a Principal object’s own capabilities map and describes that principal’s calendar presence.

Field semantics

• account_id — the JMAP account id that contains this principal’s calendar data, or null if the principal has no calendar account accessible to the requesting user.
• may_get_availability — the requesting user may call Principal/getAvailability for this principal.
• may_share_with — the requesting user may add this principal to the shareWith of their own Calendar objects.
• calendar_address — the iTIP scheduling address for this principal (e.g. "mailto:alice@example.com"), or null if the principal may not be added as a participant to an event.

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.

account_id: Option<Id>

Id of the account containing this principal’s calendar data, or null if no accessible calendar account exists.

Required-and-nullable: always present on the wire, as null or an Id. Do NOT add skip_serializing_if to this field: draft-ietf-jmap-calendars §2.1 types accountId as Id|null, so omitting it on None is a wire-protocol break, not a clean-up. The regression test principal_calendars_capability_account_id_null_serializes (in tests/types_test.rs) pins the current behavior. Precedent: CalendarAlert.recurrence_id, bd:JMAP-1rwf.7.

may_get_availability: bool

The requesting user may call Principal/getAvailability for this principal.

may_share_with: bool

The requesting user may add this principal to the shareWith property of their own Calendar objects.

calendar_address: Option<String>

iTIP scheduling address for this principal, or null when it may not be added as a participant (draft-ietf-jmap-calendars-33 §2.1: “calendarAddress: String|null … otherwise, this is null”).

Required-and-nullable: always present on the wire, as null or a String.

Trait Implementations

impl Clone for PrincipalCalendarsCapability

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 PrincipalCalendarsCapability

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PrincipalCalendarsCapability

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PrincipalCalendarsCapability

impl PartialEq for PrincipalCalendarsCapability

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PrincipalCalendarsCapability

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 PrincipalCalendarsCapability