fb-messenger-e2ee 0.1.3 → 0.1.4

package/dist/index.d.cts

@@ -245,6 +245,37 @@ interface SendMediaInput {
     /** Whether E2EE audio should be sent as push-to-talk/voice. Defaults to true for sendAudio. */
     ptt?: boolean;
 }
+/** A single attachment item inside a multi-attachment message. */
+interface SendAttachmentItem {
+    data: Buffer;
+    fileName: string;
+    /** Optional MIME type; inferred from fileName extension when omitted. */
+    mimeType?: string;
+    /** Optional width/height for image or video payloads. */
+    width?: number;
+    height?: number;
+    /** Optional duration in seconds for video/audio payloads. */
+    seconds?: number;
+    /** Whether audio should be sent as push-to-talk/voice. */
+    ptt?: boolean;
+}
+/**
+ * Send multiple attachments in a single Messenger message.
+ *
+ * - **Non-E2EE threads**: All attachments are bundled into one FCA message,
+ *   delivered as a multi-attachment post.
+ * - **E2EE threads**: Each attachment is sent as a separate encrypted E2EE
+ *   media message (the protocol does not support multi-attachment in one
+ *   encrypted frame), so `results` will contain one entry per attachment.
+ */
+interface SendMultipleMediaInput {
+    threadId: string;
+    /** Array of file attachments to send. At least one entry is required. */
+    attachments: SendAttachmentItem[];
+    /** Optional caption applied to the first attachment (or to the bundled non-E2EE message). */
+    caption?: string;
+    replyToMessageId?: string;
+}
 interface TypingInput {
     threadId: string;
     isTyping: boolean;
@@ -345,6 +376,15 @@ declare class FBClient {
     sendVideo(input: SendMediaInput): Promise<Record<string, unknown>>;
     sendAudio(input: SendMediaInput): Promise<Record<string, unknown>>;
     sendFile(input: SendMediaInput): Promise<Record<string, unknown>>;
+    /**
+     * Send multiple files/attachments in one call.
+     *
+     * - **Non-E2EE threads**: All attachments land in a single Messenger message.
+     * - **E2EE threads**: Each attachment is sent as a separate encrypted message
+     *   (E2EE does not support multi-attachment in one frame). Returns an array
+     *   with one result per attachment.
+     */
+    sendFiles(input: SendMultipleMediaInput): Promise<Record<string, unknown> | Record<string, unknown>[]>;
 }
 
 interface EncryptMediaResult {
@@ -907,4 +947,4 @@ interface AuthConfig {
     platform: Platform;
 }
 
-export { type AppEnv, type Attachment, type AuthConfig, type ClientOptions, type E2EEDecryptMediaOptions, type E2EEDownloadOptions, type E2EEDownloadResult, type E2EEEditMessageInput, type E2EEEncryptMediaOptions, type E2EEEncryptMediaResult, type E2EEMessage, type E2EEMessageKind, type E2EESendTextOptions, type E2EESendTextResult, E2EEService, FBClient, type MediaUploadConfig, type MediaUploadResult, type Mention, type MessengerEvent, type MessengerEventMap, type MmsTypeStr, type Platform, type ReplyTo, type SendMediaInput, type SendMessageInput, type SendReactionInput, type SessionData, type TypingInput, type UnsendMessageInput };
+export { type AppEnv, type Attachment, type AuthConfig, type ClientOptions, type E2EEDecryptMediaOptions, type E2EEDownloadOptions, type E2EEDownloadResult, type E2EEEditMessageInput, type E2EEEncryptMediaOptions, type E2EEEncryptMediaResult, type E2EEMessage, type E2EEMessageKind, type E2EESendTextOptions, type E2EESendTextResult, E2EEService, FBClient, type MediaUploadConfig, type MediaUploadResult, type Mention, type MessengerEvent, type MessengerEventMap, type MmsTypeStr, type Platform, type ReplyTo, type SendAttachmentItem, type SendMediaInput, type SendMessageInput, type SendMultipleMediaInput, type SendReactionInput, type SessionData, type TypingInput, type UnsendMessageInput };

package/dist/index.d.ts

@@ -245,6 +245,37 @@ interface SendMediaInput {
     /** Whether E2EE audio should be sent as push-to-talk/voice. Defaults to true for sendAudio. */
     ptt?: boolean;
 }
+/** A single attachment item inside a multi-attachment message. */
+interface SendAttachmentItem {
+    data: Buffer;
+    fileName: string;
+    /** Optional MIME type; inferred from fileName extension when omitted. */
+    mimeType?: string;
+    /** Optional width/height for image or video payloads. */
+    width?: number;
+    height?: number;
+    /** Optional duration in seconds for video/audio payloads. */
+    seconds?: number;
+    /** Whether audio should be sent as push-to-talk/voice. */
+    ptt?: boolean;
+}
+/**
+ * Send multiple attachments in a single Messenger message.
+ *
+ * - **Non-E2EE threads**: All attachments are bundled into one FCA message,
+ *   delivered as a multi-attachment post.
+ * - **E2EE threads**: Each attachment is sent as a separate encrypted E2EE
+ *   media message (the protocol does not support multi-attachment in one
+ *   encrypted frame), so `results` will contain one entry per attachment.
+ */
+interface SendMultipleMediaInput {
+    threadId: string;
+    /** Array of file attachments to send. At least one entry is required. */
+    attachments: SendAttachmentItem[];
+    /** Optional caption applied to the first attachment (or to the bundled non-E2EE message). */
+    caption?: string;
+    replyToMessageId?: string;
+}
 interface TypingInput {
     threadId: string;
     isTyping: boolean;
@@ -345,6 +376,15 @@ declare class FBClient {
     sendVideo(input: SendMediaInput): Promise<Record<string, unknown>>;
     sendAudio(input: SendMediaInput): Promise<Record<string, unknown>>;
     sendFile(input: SendMediaInput): Promise<Record<string, unknown>>;
+    /**
+     * Send multiple files/attachments in one call.
+     *
+     * - **Non-E2EE threads**: All attachments land in a single Messenger message.
+     * - **E2EE threads**: Each attachment is sent as a separate encrypted message
+     *   (E2EE does not support multi-attachment in one frame). Returns an array
+     *   with one result per attachment.
+     */
+    sendFiles(input: SendMultipleMediaInput): Promise<Record<string, unknown> | Record<string, unknown>[]>;
 }
 
 interface EncryptMediaResult {
@@ -907,4 +947,4 @@ interface AuthConfig {
     platform: Platform;
 }
 
-export { type AppEnv, type Attachment, type AuthConfig, type ClientOptions, type E2EEDecryptMediaOptions, type E2EEDownloadOptions, type E2EEDownloadResult, type E2EEEditMessageInput, type E2EEEncryptMediaOptions, type E2EEEncryptMediaResult, type E2EEMessage, type E2EEMessageKind, type E2EESendTextOptions, type E2EESendTextResult, E2EEService, FBClient, type MediaUploadConfig, type MediaUploadResult, type Mention, type MessengerEvent, type MessengerEventMap, type MmsTypeStr, type Platform, type ReplyTo, type SendMediaInput, type SendMessageInput, type SendReactionInput, type SessionData, type TypingInput, type UnsendMessageInput };
+export { type AppEnv, type Attachment, type AuthConfig, type ClientOptions, type E2EEDecryptMediaOptions, type E2EEDownloadOptions, type E2EEDownloadResult, type E2EEEditMessageInput, type E2EEEncryptMediaOptions, type E2EEEncryptMediaResult, type E2EEMessage, type E2EEMessageKind, type E2EESendTextOptions, type E2EESendTextResult, E2EEService, FBClient, type MediaUploadConfig, type MediaUploadResult, type Mention, type MessengerEvent, type MessengerEventMap, type MmsTypeStr, type Platform, type ReplyTo, type SendAttachmentItem, type SendMediaInput, type SendMessageInput, type SendMultipleMediaInput, type SendReactionInput, type SessionData, type TypingInput, type UnsendMessageInput };

package/dist/index.js

@@ -3465,6 +3465,30 @@ var FacebookGatewayService = class {
     );
     return response ?? {};
   }
+  /**
+   * Send multiple attachments in a single FCA message.
+   * FCA-unofficial accepts an array in `attachment` field, which bundles all
+   * files into one Messenger message on the wire.
+   */
+  async sendMultipleAttachmentsMessage(api, input) {
+    if (input.attachments.length === 0) {
+      throw new Error("sendMultipleAttachmentsMessage requires at least one attachment");
+    }
+    const streams = input.attachments.map(({ data, fileName }) => {
+      const stream = Readable.from(data);
+      Object.assign(stream, { path: fileName });
+      return stream;
+    });
+    const payload = {
+      body: input.caption ?? "",
+      // FCA-unofficial accepts a single Readable or an array of Readables
+      attachment: streams.length === 1 ? streams[0] : streams
+    };
+    const response = await Promise.resolve(
+      api.sendMessage(payload, input.threadId, void 0, input.replyToMessageId)
+    );
+    return response ?? {};
+  }
   async sendReaction(api, messageId, reaction) {
     if (!api.setMessageReaction) {
       throw new Error("setMessageReaction is not available in fca-unofficial");
@@ -3641,6 +3665,13 @@ var MediaService = class {
       replyToMessageId: input.replyToMessageId
     });
   }
+  /**
+   * Send multiple attachments bundled into a single FCA message.
+   * Non-E2EE only — for E2EE threads use the controller which sends them sequentially.
+   */
+  async sendFiles(api, input) {
+    return this.gateway.sendMultipleAttachmentsMessage(api, input);
+  }
   async sendSticker(api, input) {
     return this.gateway.sendStickerMessage(api, {
       threadId: input.threadId,
@@ -8560,7 +8591,7 @@ var ClientController = class {
   async markAsRead(input) {
     await this.messagingService.markAsRead(this.requireApi(), input);
   }
-  // --- E2EE Media Upload Config ---
+  // E2EE Media Upload Config
   async getE2EEMediaUploadConfig() {
     if (this.e2eeUploadConfig && !this.isMediaUploadConfigExpired(this.e2eeUploadConfig)) {
       return this.e2eeUploadConfig;
@@ -8707,6 +8738,62 @@ var ClientController = class {
     }
     return this.mediaService.sendFile(this.requireApi(), input);
   }
+  /**
+   * Send multiple files/attachments.
+   *
+   * - **Non-E2EE threads**: All files are bundled into a single FCA message.
+   * - **E2EE threads**: Files are sent as separate sequential encrypted E2EE
+   *   media messages (the protocol does not support multi-attachment in one
+   *   encrypted frame). Returns an array with one result per attachment.
+   */
+  async sendFiles(input) {
+    if (input.attachments.length === 0) {
+      throw new Error("sendFiles requires at least one attachment");
+    }
+    if (this.e2eeConnected && this.isE2EEThreadId(input.threadId)) {
+      const results = [];
+      for (let i = 0; i < input.attachments.length; i++) {
+        const att = input.attachments[i];
+        const mediaInput = {
+          threadId: input.threadId,
+          data: att.data,
+          fileName: att.fileName,
+          mimeType: att.mimeType,
+          // Caption on first attachment only
+          caption: i === 0 ? input.caption : void 0,
+          replyToMessageId: i === 0 ? input.replyToMessageId : void 0,
+          width: att.width,
+          height: att.height,
+          seconds: att.seconds,
+          ptt: att.ptt
+        };
+        const mediaType = inferMediaType(att.fileName, att.mimeType);
+        let result;
+        switch (mediaType) {
+          case "image":
+            result = await this.sendE2EEImage(mediaInput);
+            break;
+          case "video":
+            result = await this.sendE2EEVideo(mediaInput);
+            break;
+          case "audio":
+            result = await this.sendE2EEAudio(mediaInput);
+            break;
+          default:
+            result = await this.sendE2EEFile(mediaInput);
+            break;
+        }
+        results.push(result);
+      }
+      return results;
+    }
+    return this.mediaService.sendFiles(this.requireApi(), {
+      threadId: input.threadId,
+      attachments: input.attachments.map((a) => ({ data: a.data, fileName: a.fileName })),
+      caption: input.caption,
+      replyToMessageId: input.replyToMessageId
+    });
+  }
   async sendSticker(input) {
     return this.mediaService.sendSticker(this.requireApi(), input);
   }
@@ -8746,7 +8833,6 @@ var ClientController = class {
   async createPoll(input) {
     await this.threadService.createPoll(this.requireApi(), input);
   }
-  // editMessage is now handled by the E2EE-aware method above (routes E2EE → sendE2EEEdit, else → threadService.editMessage).
   async addGroupMember(input) {
     await this.threadService.addGroupMember(this.requireApi(), input);
   }
@@ -8764,6 +8850,17 @@ var ClientController = class {
     return this.api;
   }
 };
+function inferMediaType(fileName, mimeType) {
+  const mime = (mimeType ?? "").toLowerCase();
+  if (mime.startsWith("image/")) return "image";
+  if (mime.startsWith("video/")) return "video";
+  if (mime.startsWith("audio/")) return "audio";
+  const ext = fileName.split(".").pop()?.toLowerCase() ?? "";
+  if (["jpg", "jpeg", "png", "gif", "webp", "heic", "heif", "bmp"].includes(ext)) return "image";
+  if (["mp4", "mov", "avi", "mkv", "webm", "3gp", "m4v"].includes(ext)) return "video";
+  if (["mp3", "ogg", "aac", "flac", "wav", "m4a", "opus"].includes(ext)) return "audio";
+  return "document";
+}
 
 // src/repositories/session.repository.ts
 init_esm_shims();
@@ -9025,6 +9122,17 @@ var FBClient = class {
   async sendFile(input) {
     return this.controller.sendFile(input);
   }
+  /**
+   * Send multiple files/attachments in one call.
+   *
+   * - **Non-E2EE threads**: All attachments land in a single Messenger message.
+   * - **E2EE threads**: Each attachment is sent as a separate encrypted message
+   *   (E2EE does not support multi-attachment in one frame). Returns an array
+   *   with one result per attachment.
+   */
+  async sendFiles(input) {
+    return this.controller.sendFiles(input);
+  }
 };
 export {
   E2EEService,