IMessageSDK

IMessageSDK(config?: IMessageConfig, dependencies?: SDKDependencies): IMessageSDK

close(): Promise<void>

getMessages(filter?: MessageFilter): Promise<MessageQueryResult>

getUnreadMessages(): Promise<UnreadMessagesResult>

const unread = await sdk.getUnreadMessages()
console.log(`${unread.total} unread messages from ${unread.senderCount} senders`)
for (const { sender, messages } of unread.groups) {
  console.log(`${sender}: ${messages.length} messages`)
}

listChats(options?: number | ListChatsOptions): Promise<ChatSummary[]>

// Get all chats
const all = await sdk.listChats()

// Get recent group chats with unread messages
const groups = await sdk.listChats({
  type: 'group',
  hasUnread: true,
  limit: 20
})

// Search chats by name
const found = await sdk.listChats({
  search: 'John',
  sortBy: 'name'
})

// Backward compatible: limit only
const recent = await sdk.listChats({ limit: 50 })

message(message: Message): MessageChain

send(to: string, content: string | { files: string[]; images: string[]; text: string }): Promise<SendResult>

// Send to phone number
await sdk.send('+1234567890', 'Hello')

// Send to email
await sdk.send('[email protected]', 'Hello')

// Send to group chat
await sdk.send('chat123...', 'Hello')

// Send with attachments
await sdk.send('+1234567890', { images: ['/img.jpg'] })
await sdk.send('chat123...', { text: 'Hi', files: ['/doc.pdf'] })

sendBatch(messages: { content: string | { files: string[]; images: string[]; text: string }; to: string }[]): Promise<{ error: Error; result: SendResult; success: boolean; to: string }[]>

const results = await sdk.sendBatch([
  { to: '+1234567890', content: 'Hello' },
  { to: '+0987654321', content: 'Hi' },
])

for (const result of results) {
  if (result.success) {
    console.log('Send success:', result.to)
  } else {
    console.error('Send failed:', result.to, result.error)
  }
}

sendFile(to: string, filePath: string, text?: string): Promise<SendResult>

// Send to phone number
await sdk.sendFile('+1234567890', '/path/to/document.pdf')

// Send to group chat
await sdk.sendFile('chat123...', '/path/to/document.pdf', 'Here is the file')

sendFiles(to: string, filePaths: string[], text?: string): Promise<SendResult>

// Send to phone number
await sdk.sendFiles('+1234567890', ['/file1.pdf', '/file2.csv'])

// Send to group chat
await sdk.sendFiles('chat123...', ['/data.xlsx'], 'Check these files')

startWatching(events?: WatcherEvents): Promise<void>

stopWatching(): void

use(plugin: Plugin): this