Enum ChatCreateInput 

#[non_exhaustive]
pub enum ChatCreateInput<'a> {
    Direct {
        client_id: Option<&'a str>,
        contact_id: &'a Id,
    },
    Group {
        client_id: Option<&'a str>,
        name: &'a str,
        member_ids: &'a [Id],
        description: Option<&'a str>,
        avatar_blob_id: Option<&'a Id>,
        message_expiry_seconds: Option<u64>,
    },
}

Input parameters for Chat/set create.

Discriminates the two user-creatable Chat kinds from the spec. Each variant carries the fields required for that kind plus an optional client_id; when None — or Some("") — a ULID is generated automatically (see the per-variant client_id doc).

Channel Chats are NOT created via Chat/set. Per draft-atwood-jmap-chat-00 §Chat (line 436), Channel Chats are created as part of a Space via the addChannels patch key in Space/set (see SpacePatch::add_channels and SpaceAddChannelInput); the server assigns the channel’s chatId at that time. A spec-compliant server will reject a Chat/set create with kind: "channel".

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.

Direct

Create a direct (one-to-one) chat.

Fields

client_id: Option<&'a str>

Caller-supplied creation key. When None — or Some("") — a ULID is generated automatically. An empty Some("") is treated the same as None, not as a rejection.

contact_id: &'a Id

ChatContact.id of the other participant.

Group

Create a group chat.

Fields

client_id: Option<&'a str>

Caller-supplied creation key. When None — or Some("") — a ULID is generated automatically. An empty Some("") is treated the same as None, not as a rejection.

name: &'a str

Display name for the group.

member_ids: &'a [Id]

ChatContact.ids of initial non-owner members.

description: Option<&'a str>

Optional human-readable description.

avatar_blob_id: Option<&'a Id>

Blob id of an already-uploaded avatar image, if any.

message_expiry_seconds: Option<u64>

Optional auto-expiry interval applied to new messages.

Trait Implementations

impl<'a> Debug for ChatCreateInput<'a>

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

Formats the value using the given formatter.