Struct FileAttachment 

pub struct FileAttachment {
    pub id: String,
    pub name: String,
    pub content_type: String,
    pub data: Vec<u8>,
}

Shared attachment model used by API calls and events. Binary attachment carried alongside JSON params or event data.

In protocol v2 the attachment payload is stored as raw bytes in a binary section appended after the JSON metadata, eliminating the 33% overhead of Base64 encoding used in protocol v1.

Fields

id: String

Attachment identifier referenced from JSON using { "$file": "..." }.

name: String

Original file name.

content_type: String

MIME type supplied by the sender.

data: Vec<u8>

Raw attachment payload bytes.

Implementations

impl FileAttachment

pub fn inline_text( id: impl Into<String>, name: impl Into<String>, content_type: impl Into<String>, text: impl AsRef<str>, ) -> FileAttachment

Builds a text attachment from a string.

pub fn inline_bytes( id: impl Into<String>, name: impl Into<String>, content_type: impl Into<String>, bytes: Vec<u8>, ) -> FileAttachment

Builds a binary attachment from raw bytes.

pub fn size(&self) -> usize

Returns the byte length of the attachment payload.

pub fn param_ref(id: impl Into<String>) -> Value

Returns a JSON reference object that points to an attachment by id.

Trait Implementations

impl Clone for FileAttachment

fn clone(&self) -> FileAttachment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileAttachment

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileAttachment

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FileAttachment

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.