Struct MessageCreateInput 

#[non_exhaustive]
pub struct MessageCreateInput<'a> {
    pub client_id: Option<&'a str>,
    pub chat_id: &'a Id,
    pub body: &'a str,
    pub body_type: BodyType,
    pub sent_at: &'a UTCDate,
    pub reply_to: Option<&'a Id>,
}

Input parameters for Message/set create.

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.

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; callers must not assume the wire echoes a caller-supplied empty string.

chat_id: &'a Id

The Chat this message belongs to.

body: &'a str

Message body text (interpreted per body_type).

Length is not checked on the client. The server enforces ChatCapability::max_body_bytes (UTF-8 byte count for text/* body types, raw byte count otherwise); oversize bodies surface as a server-side tooLarge SetError on the created entry, not as a client-side rejection.

body_type: BodyType

MIME type for the message body.

sent_at: &'a UTCDate

RFC 3339 timestamp.

UTCDate is a transparent newtype around String and does not validate the RFC 3339 format at construction time. A malformed value forwards to the server, which rejects it with invalidArguments. Construct values via a validating helper (e.g. chrono::DateTime::<Utc>::to_rfc3339) rather than from arbitrary strings.

reply_to: Option<&'a Id>

When Some, marks this message as a reply to the given message id.

Implementations

impl<'a> MessageCreateInput<'a>

pub fn new( chat_id: &'a Id, body: &'a str, body_type: BodyType, sent_at: &'a UTCDate, ) -> Self

Create a MessageCreateInput with required fields; optional fields default to None.

pub fn with_client_id(self, id: &'a str) -> Self

Set the caller-supplied creation key (overrides the auto-generated ULID).

pub fn with_reply_to(self, id: &'a Id) -> Self

Set the message this one replies to.

Trait Implementations

impl<'a> Clone for MessageCreateInput<'a>

fn clone(&self) -> MessageCreateInput<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for MessageCreateInput<'a>

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

Formats the value using the given formatter.