Struct Conversation 

pub struct Conversation { /* private fields */ }

A conversation handle (DM or group).

Implementations

impl Conversation

pub fn id(&self) -> String

Hex-encoded group ID.

pub fn conversation_type(&self) -> Option<ConversationType>

Conversation type (DM, Group, etc.).

pub fn created_at_ns(&self) -> i64

Created-at timestamp in nanoseconds.

pub fn is_active(&self) -> bool

Whether the conversation is active.

pub fn membership_state(&self) -> Option<MembershipState>

Current membership state of this client in the conversation.

pub fn dm_peer_inbox_id(&self) -> Option<String>

DM peer’s inbox ID. Returns None if not a DM.

pub fn added_by_inbox_id(&self) -> Option<String>

Inbox ID of the member who added this client.

pub fn name(&self) -> Option<String>

Get the group name.

pub fn set_name(&self, value: &str) -> Result<()>

Set the group name.

pub fn description(&self) -> Option<String>

Get the group description.

pub fn set_description(&self, value: &str) -> Result<()>

Set the group description.

pub fn image_url(&self) -> Option<String>

Get the group image URL.

pub fn set_image_url(&self, value: &str) -> Result<()>

Set the group image URL.

pub fn app_data(&self) -> Option<String>

Get app data string.

pub fn set_app_data(&self, value: &str) -> Result<()>

Set app data (max 8192 bytes).

pub fn paused_for_version(&self) -> Result<Option<String>>

Check if conversation is paused for a version upgrade.

pub fn metadata(&self) -> Result<ConversationMetadata>

Get the conversation metadata (creator inbox ID + type).

pub fn permissions(&self) -> Result<Permissions>

Get the group permissions (preset + full policy set).

pub fn sync(&self) -> Result<()>

Sync this conversation with the network.

pub fn send(&self, content: &[u8]) -> Result<String>

Send raw encoded content bytes. Returns the hex-encoded message ID.

pub fn send_with(&self, content: &[u8], opts: &SendOptions) -> Result<String>

Send with options. Returns the hex-encoded message ID.

pub fn send_optimistic(&self, content: &[u8]) -> Result<String>

Send optimistically (returns immediately, publishes in background).

pub fn send_optimistic_with( &self, content: &[u8], opts: &SendOptions, ) -> Result<String>

Send optimistically with options.

pub fn publish_messages(&self) -> Result<()>

Publish all queued (unpublished) messages.

pub fn messages(&self) -> Result<Vec<Message>>

List all messages with default options.

pub fn list_messages( &self, options: &ListMessagesOptions, ) -> Result<Vec<Message>>

List messages with filtering options.

pub fn count_messages(&self, options: &ListMessagesOptions) -> i64

Count messages matching filter options.

pub fn members(&self) -> Result<Vec<GroupMember>>

List members of this conversation.

pub fn add_members_by_inbox_id(&self, inbox_ids: &[&str]) -> Result<()>

Add members by inbox IDs.

pub fn remove_members_by_inbox_id(&self, inbox_ids: &[&str]) -> Result<()>

Remove members by inbox IDs.

pub fn add_members_by_identity( &self, identifiers: &[AccountIdentifier], ) -> Result<()>

Add members by external identifiers (address + kind).

pub fn remove_members_by_identity( &self, identifiers: &[AccountIdentifier], ) -> Result<()>

Remove members by external identifiers (address + kind).

pub fn leave(&self) -> Result<()>

Leave this group conversation.

pub fn consent_state(&self) -> Result<ConsentState>

Get the consent state for this conversation.

pub fn set_consent(&self, state: ConsentState) -> Result<()>

Set the consent state for this conversation.

pub fn disappearing_settings(&self) -> Option<DisappearingSettings>

Get the current disappearing message settings.

pub fn set_disappearing(&self, settings: DisappearingSettings) -> Result<()>

Set disappearing message settings.

pub fn clear_disappearing(&self) -> Result<()>

Clear disappearing message settings.

pub fn is_disappearing_enabled(&self) -> bool

Whether disappearing messages are enabled.

pub fn set_permission_policy( &self, update_type: PermissionUpdateType, policy: PermissionPolicy, metadata_field: Option<MetadataField>, ) -> Result<()>

Set a permission policy on this conversation.

The metadata_field is only used when update_type is PermissionUpdateType::UpdateMetadata.

pub fn last_message(&self) -> Result<Option<Message>>

Get the last message in this conversation, if any.

pub fn add_admin(&self, inbox_id: &str) -> Result<()>

Add an admin.

pub fn remove_admin(&self, inbox_id: &str) -> Result<()>

Remove an admin.

pub fn add_super_admin(&self, inbox_id: &str) -> Result<()>

Add a super admin.

pub fn remove_super_admin(&self, inbox_id: &str) -> Result<()>

Remove a super admin.

pub fn admins(&self) -> Vec<String>

Admin inbox IDs.

pub fn super_admins(&self) -> Vec<String>

Super admin inbox IDs.

pub fn is_admin(&self, inbox_id: &str) -> bool

Check if the given inbox ID is an admin.

pub fn is_super_admin(&self, inbox_id: &str) -> bool

Check if the given inbox ID is a super admin.

pub fn duplicate_dms(&self) -> Result<Vec<Self>>

Find duplicate DM conversations for this DM.

pub fn debug_info(&self) -> Result<ConversationDebugInfo>

Get debug information for this conversation.

pub fn last_read_times(&self) -> Result<Vec<LastReadTime>>

Get per-inbox last-read timestamps.

pub fn hmac_keys(&self) -> Result<Vec<HmacKeyEntry>>

Get HMAC keys for this conversation (including duplicate DMs).

impl Conversation

pub fn send_text(&self, text: &str) -> Result<String>

Send a plain text message.

pub fn send_markdown(&self, markdown: &str) -> Result<String>

Send a markdown message.

pub fn send_reaction( &self, message_id: &str, emoji: &str, action: ReactionAction, ) -> Result<String>

Send an emoji reaction to a message.

pub fn send_read_receipt(&self) -> Result<String>

Send a read receipt.

pub fn send_text_reply(&self, reference_id: &str, text: &str) -> Result<String>

Send a text reply to a message.

pub fn send_reply( &self, reference_id: &str, inner_content: &[u8], ) -> Result<String>

Send a reply with arbitrary encoded content.

pub fn send_attachment(&self, attachment: &Attachment) -> Result<String>

Send an inline file attachment.

pub fn send_remote_attachment(&self, ra: &RemoteAttachment) -> Result<String>

Send a remote (URL-hosted) encrypted attachment.

pub fn send_text_optimistic(&self, text: &str) -> Result<String>

Optimistically send a plain text message (returns immediately).

pub fn send_markdown_optimistic(&self, markdown: &str) -> Result<String>

Optimistically send a markdown message.

pub fn send_reaction_optimistic( &self, message_id: &str, emoji: &str, action: ReactionAction, ) -> Result<String>

Optimistically send an emoji reaction.

pub fn send_text_reply_optimistic( &self, reference_id: &str, text: &str, ) -> Result<String>

Optimistically send a text reply.

Trait Implementations

impl Debug for Conversation

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

Formats the value using the given formatter.