Messaging and receipts

sendMessage(params: SendMessageParams): Promise<string>

forwardMessage(params: ForwardMessageParams): Promise<string>

sendConnectionRequest(params: SendConnectionRequestParams): Promise<string>

acceptConnectionRequest(params: AcceptConnectionRequestParams): Promise<string>

rejectConnectionRequest(params: RejectConnectionRequestParams): Promise<string>

cancelConnectionRequest(params: CancelConnectionRequestParams): Promise<string>

getMessageStats(): Promise<MessageDeliveryStats[]>

getDeliverySuccessRate(): Promise<number>

getMedianLatency(): Promise<number | null>

getMedianHops(): Promise<number | null>

receiveMessage(): Promise<MessageReceivedEvent | null>

sendPresenceUpdate(recipient: string, status: 'online' | 'away' | 'offline'): Promise<string>

checkInternetPresence(userId: string, options?: { force?: boolean }): Promise<boolean>

sendTypingIndicator(recipient: string, conversationId: string, isTyping: boolean): Promise<string>

sendReadReceipt(recipient: string, messageIds: string[]): Promise<string>

blockUser(userId: string): Promise<void>

unblockUser(userId: string): Promise<void>

getBlockedUsers(): Promise<string[]>

isUserBlocked(userId: string): Promise<boolean>

export interface SendMessageParams {
  recipient: string;
  content: string;
  priority?: MessagePriority;
  replyToMsg?: string;
  contentType?: ContentType;
  replyContext?: ReplyContext;
  mediaMetadata?: MediaMetadata;
  forwardInfo?: ForwardInfo;
}

export enum MessagePriority {
  Low = 0,
  Medium = 1,
  High = 2,
  Critical = 3,
}

export enum ContentType {
  Text = 'text',
  Image = 'image',
  Video = 'video',
  Audio = 'audio',
  VoiceNote = 'voice_note',
  VideoNote = 'video_note',
  File = 'file',
  FileChunk = 'file_chunk',
  Poll = 'poll',
}

export interface ReplyContext {
  sender: string;
  text: string;
  timestamp?: number;
  reply_media_label?: string;
  reply_content_type?: string;
}

export interface MediaMetadata {
  mimeType: string;
  fileName: string;
  fileSize: number;
  durationMs?: number;
  width?: number;
  height?: number;
  thumbnailBase64?: string;
  mediaId?: string;
  downloadUrl?: string;
  thumbnailUrl?: string;
  encryptionKey?: string;
  iv?: string;
  ciphertextHash?: string;
  stickerProvider?: string;
  stickerRemoteId?: string;
  stickerKind?: string;
}

export interface ForwardInfo {
  original_sender: string;
  original_message_id: string;
  original_timestamp: number;
  forward_count: number;
}

export interface ForwardMessageParams {
  originalMessageJson: string;
  newRecipient: string;
  priority?: MessagePriority;
}

export interface SendConnectionRequestParams {
  recipient: string;
  senderName: string;
  keyPackage?: number[];
  initialMessage?: string;
}

export interface AcceptConnectionRequestParams {
  recipient: string;
  accepterName: string;
  keyPackage?: number[];
}

export interface RejectConnectionRequestParams {
  recipient: string;
}

export interface CancelConnectionRequestParams {
  recipient: string;
}

export interface MessageDeliveryStats {
  message_id: string;
  sender: string;
  recipient: string;
  sent_at: number;
  delivered_at?: number;
  hop_count: number;
  transport?: TransportType;
  retry_count: number;
  latency_ms?: number;
}

export type TransportType = 'ble' | 'internet' | 'wifiDirect' | 'reticulum' | 'nostr';