feat: add support for pre-uploaded attachment Facebook IDs in sendMessage

Author: aiko-chan-ai

DOCS.md

@@ -269,6 +269,7 @@ __Parameters__
   * If object:
     * `text`: string - Message content
     * `replyToId?`: string - Message ID to reply to
+    * `attachmentFbIds?`: bigint[] - Pre-uploaded attachment Facebook IDs (from `uploadMedia()`)
     * `mentions?`: Mention[] - List of mentions
       * `userId`: bigint - Mentioned user ID
       * `offset`: number - Start position in text
@@ -301,6 +302,13 @@ await client.sendMessage(threadId, {
         length: 7
     }]
 })
+
+// Send with pre-uploaded attachments
+const upload = await client.uploadMedia(threadId, imageData, 'photo.jpg', 'image/jpeg')
+await client.sendMessage(threadId, {
+    text: 'Check this out!',
+    attachmentFbIds: [upload.fbId]
+})
 ```
 
 ---

DOCS_VI.md

@@ -269,6 +269,7 @@ __Tham số__
   * Nếu là object:
     * `text`: string - Nội dung tin nhắn
     * `replyToId?`: string - ID tin nhắn để reply
+    * `attachmentFbIds?`: bigint[] - Danh sách Facebook ID của media đã upload (từ `uploadMedia()`)
     * `mentions?`: Mention[] - Danh sách mention
       * `userId`: bigint - ID user được mention
       * `offset`: number - Vị trí bắt đầu trong text
@@ -301,6 +302,13 @@ await client.sendMessage(threadId, {
         length: 4
     }]
 })
+
+// Gửi với attachment đã upload trước
+const upload = await client.uploadMedia(threadId, imageData, 'photo.jpg', 'image/jpeg')
+await client.sendMessage(threadId, {
+    text: 'Xem này!',
+    attachmentFbIds: [upload.fbId]
+})
 ```
 
 ---

src/client.ts

@@ -258,6 +258,7 @@ export class Client<
             threadId,
             text: opts.text,
             replyToId: opts.replyToId,
+            attachmentFbIds: opts.attachmentFbIds,
             mentionIds: opts.mentions?.map(m => m.userId),
             mentionOffsets: opts.mentions?.map(m => m.offset),
             mentionLengths: opts.mentions?.map(m => m.length),

src/types.ts

@@ -467,6 +467,8 @@ export interface SendMessageOptions {
     text: string;
     /** Reply to message ID */
     replyToId?: string;
+    /** Pre-uploaded attachment Facebook IDs (from uploadMedia) */
+    attachmentFbIds?: bigint[];
     /** User IDs to mention */
     mentions?: Array<{
         userId: bigint;