fb-messenger-e2ee 0.1.2 → 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;
@@ -259,6 +290,30 @@ interface SendReactionInput {
     /** Alias for senderJid for callers that prefer explicit target naming. */
     targetSenderJid?: string;
 }
+interface UnsendMessageInput {
+    /** The message ID to revoke/unsend. */
+    messageId: string;
+    /**
+     * The thread ID (or E2EE chat JID) that contains the message.
+     * Required to route the revoke through the correct channel:
+     * - E2EE threads → encrypted revoke via Noise socket.
+     * - Non-E2EE threads → HTTP unsend via fca-unofficial.
+     */
+    threadId: string;
+    /**
+     * Whether the message was sent by the current user.
+     * Defaults to true. Set to false for admin revoke of others' messages.
+     */
+    fromMe?: boolean;
+}
+interface E2EEEditMessageInput {
+    /** The thread ID (or E2EE chat JID) containing the message. */
+    threadId: string;
+    /** The ID of the message to edit. */
+    messageId: string;
+    /** The new text content. */
+    newText: string;
+}
 
 interface ClientOptions {
     appStatePath?: string;
@@ -314,12 +369,22 @@ declare class FBClient {
     sendNoiseKeepAlive(): Promise<void>;
     sendMessage(input: SendMessageInput): Promise<Record<string, unknown>>;
     sendReaction(input: SendReactionInput): Promise<void>;
-    unsendMessage(messageId: string): Promise<void>;
+    unsendMessage(input: UnsendMessageInput): Promise<void>;
+    editMessage(input: E2EEEditMessageInput): Promise<void>;
     sendTyping(input: TypingInput): Promise<void>;
     sendImage(input: SendMediaInput): Promise<Record<string, unknown>>;
     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 {
@@ -882,4 +947,4 @@ interface AuthConfig {
     platform: Platform;
 }
 
-export { type AppEnv, type Attachment, type AuthConfig, type ClientOptions, type E2EEDecryptMediaOptions, type E2EEDownloadOptions, type E2EEDownloadResult, 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 };
+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;
@@ -259,6 +290,30 @@ interface SendReactionInput {
     /** Alias for senderJid for callers that prefer explicit target naming. */
     targetSenderJid?: string;
 }
+interface UnsendMessageInput {
+    /** The message ID to revoke/unsend. */
+    messageId: string;
+    /**
+     * The thread ID (or E2EE chat JID) that contains the message.
+     * Required to route the revoke through the correct channel:
+     * - E2EE threads → encrypted revoke via Noise socket.
+     * - Non-E2EE threads → HTTP unsend via fca-unofficial.
+     */
+    threadId: string;
+    /**
+     * Whether the message was sent by the current user.
+     * Defaults to true. Set to false for admin revoke of others' messages.
+     */
+    fromMe?: boolean;
+}
+interface E2EEEditMessageInput {
+    /** The thread ID (or E2EE chat JID) containing the message. */
+    threadId: string;
+    /** The ID of the message to edit. */
+    messageId: string;
+    /** The new text content. */
+    newText: string;
+}
 
 interface ClientOptions {
     appStatePath?: string;
@@ -314,12 +369,22 @@ declare class FBClient {
     sendNoiseKeepAlive(): Promise<void>;
     sendMessage(input: SendMessageInput): Promise<Record<string, unknown>>;
     sendReaction(input: SendReactionInput): Promise<void>;
-    unsendMessage(messageId: string): Promise<void>;
+    unsendMessage(input: UnsendMessageInput): Promise<void>;
+    editMessage(input: E2EEEditMessageInput): Promise<void>;
     sendTyping(input: TypingInput): Promise<void>;
     sendImage(input: SendMediaInput): Promise<Record<string, unknown>>;
     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 {
@@ -882,4 +947,4 @@ interface AuthConfig {
     platform: Platform;
 }
 
-export { type AppEnv, type Attachment, type AuthConfig, type ClientOptions, type E2EEDecryptMediaOptions, type E2EEDownloadOptions, type E2EEDownloadResult, 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 };
+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,
@@ -8208,12 +8239,13 @@ var ClientController = class {
     const isE2EE = this.isE2EEThreadId(input.threadId);
     const isGroup = input.threadId.includes("@g.us") || input.threadId.includes(".g.");
     if (this.e2eeConnected && isE2EE) {
+      let messageId;
       if (isGroup) {
-        await this.sendE2EEGroupText(input.threadId, input.text, input.replyToMessageId);
+        messageId = await this.sendE2EEGroupText(input.threadId, input.text, input.replyToMessageId);
       } else {
-        await this.sendE2EEText(input.threadId, input.text, input.replyToMessageId);
+        messageId = await this.sendE2EEText(input.threadId, input.text, input.replyToMessageId);
       }
-      return { messageId: `e2ee-${now()}`, timestampMs: now() };
+      return { messageId, timestampMs: now() };
     }
     return this.messagingService.sendText(this.requireApi(), input);
   }
@@ -8273,6 +8305,7 @@ var ClientController = class {
       createdAtMs: now()
     });
     logger.info("ClientController", `E2EE DM message sent to ${toJid} with ${participantNodes.length} devices`);
+    return messageId;
   }
   async sendE2EEGroupText(groupJid, text, replyToMessageId) {
     if (!this.e2eeSocket) throw new Error("E2EE not connected");
@@ -8335,6 +8368,7 @@ var ClientController = class {
       createdAtMs: now()
     });
     logger.info("ClientController", `E2EE Group message sent to ${groupJid} with ${participantNodes.length} devices`);
+    return messageId;
   }
   getSelfE2EEJid() {
     const device = this.activeDeviceStore?.jidDevice ?? 0;
@@ -8346,8 +8380,210 @@ var ClientController = class {
   async sendReaction(input) {
     await this.messagingService.react(this.requireApi(), input);
   }
-  async unsendMessage(messageId) {
-    await this.messagingService.unsend(this.requireApi(), messageId);
+  /**
+   * Unsend/revoke a message.
+   *
+   * - **E2EE threads**: Sends an encrypted `ConsumerApplication { applicationData { revoke } }`
+   *   message over the Noise socket. The `fromMe` flag in the revoke key determines
+   *   whether it is a sender revoke (`true`, default) or an admin revoke (`false`).
+   * - **Non-E2EE threads**: Falls back to `fca-unofficial` HTTP unsend.
+   */
+  async unsendMessage(input) {
+    const isE2EE = this.isE2EEThreadId(input.threadId);
+    if (this.e2eeConnected && isE2EE) {
+      await this.sendE2EERevoke(input.threadId, input.messageId, input.fromMe ?? true);
+      return;
+    }
+    await this.messagingService.unsend(this.requireApi(), input.messageId);
+  }
+  /**
+   * Send an E2EE revoke (unsend) for a DM or group message.
+   *
+   * Builds a `ConsumerApplication { applicationData { revoke { key { id, fromMe } } } }`
+   * payload, wraps it in MessageApplication + MessageTransport, then fans out to all
+   * participant devices exactly like a normal DM or group text — but with the
+   * correct edit attribute on the `<message>` node so the server and
+   * receiving clients apply the correct revoke semantics.
+   */
+  async sendE2EERevoke(threadId, messageId, fromMe) {
+    if (!this.e2eeSocket) throw new Error("E2EE not connected");
+    const e2eeClient = this.e2eeService.getClient();
+    const selfJid = this.getSelfE2EEJid();
+    const isGroup = threadId.includes("@g.us") || threadId.includes(".g.");
+    const editAttr = fromMe ? "7" : "8";
+    const toJid = isGroup ? threadId : normalizeDMThreadToJid(threadId);
+    const consumerApp = e2eeClient.buildRevokeMessage(messageId, { fromMe, remoteJid: toJid });
+    const { messageApp, frankingTag } = e2eeClient.buildMessageApplication(consumerApp);
+    const newMessageId = String(BigInt(Math.floor(Math.random() * 1e15)));
+    if (isGroup) {
+      const memberJids = await this.e2eeHandler.getGroupParticipants(threadId);
+      const deviceUsers = uniqueJids([...memberJids, toBareMessengerJid(selfJid)]);
+      const deviceJids = uniqueJids(await this.e2eeHandler.getDeviceList(deviceUsers)).filter((jid) => !sameMessengerDevice(jid, selfJid));
+      const groupResult = await e2eeClient.encryptGroupMessageApplication(
+        threadId,
+        selfJid,
+        messageApp,
+        newMessageId
+      );
+      const participantNodes = [];
+      for (const deviceJid of deviceJids) {
+        try {
+          if (!await e2eeClient.hasSession(deviceJid)) {
+            const bundle = await this.e2eeHandler.getPreKeyBundle(deviceJid);
+            await e2eeClient.establishSession(deviceJid, bundle);
+          }
+          const payload = sameMessengerUser(deviceJid, selfJid) ? groupResult.selfDevicePayload : groupResult.devicePayload;
+          const skdmEnc = await e2eeClient.encryptDevicePayload(deviceJid, selfJid, payload);
+          participantNodes.push(encodeNode("to", { jid: deviceJid }, [
+            encodeNode("enc", { v: "3", type: skdmEnc.type }, skdmEnc.ciphertext)
+          ]));
+        } catch (err) {
+          logger.error("ClientController", `Failed to distribute revoke SKDM to ${deviceJid}:`, err);
+        }
+      }
+      const phash = buildParticipantListHash(deviceJids);
+      const msgNode = encodeNode("message", { to: threadId, type: "text", id: newMessageId, phash, edit: editAttr }, [
+        encodeNode("participants", {}, participantNodes),
+        encodeNode("franking", {}, [encodeNode("franking_tag", {}, frankingTag)]),
+        encodeNode("trace", {}, [encodeNode("request_id", {}, Buffer.from(randomUUID3().replace(/-/g, ""), "hex"))]),
+        encodeNode("enc", { v: "3", type: "skmsg", "decrypt-fail": "hide" }, groupResult.groupCiphertext)
+      ]);
+      await this.e2eeSocket.sendFrame(marshal(msgNode));
+      logger.info("ClientController", `E2EE group revoke sent for message ${messageId} in ${threadId}`);
+    } else {
+      const devicePayload = e2eeClient.buildMessageTransport({ messageApp });
+      const selfDevicePayload = e2eeClient.buildMessageTransport({
+        messageApp,
+        dsm: { destinationJid: toJid, phash: "" }
+      });
+      const participantNodes = [];
+      const deviceJids = uniqueJids(await this.e2eeHandler.getDeviceList([toJid, toBareMessengerJid(selfJid)]));
+      for (const deviceJid of deviceJids) {
+        if (sameMessengerDevice(deviceJid, selfJid)) continue;
+        try {
+          if (!await e2eeClient.hasSession(deviceJid)) {
+            const bundle = await this.e2eeHandler.getPreKeyBundle(deviceJid);
+            await e2eeClient.establishSession(deviceJid, bundle);
+          }
+          const payload = sameMessengerUser(deviceJid, selfJid) ? selfDevicePayload : devicePayload;
+          const encrypted = await e2eeClient.encryptDevicePayload(deviceJid, selfJid, payload);
+          participantNodes.push(encodeNode("to", { jid: deviceJid }, [
+            encodeNode("enc", { v: "3", type: encrypted.type, "decrypt-fail": "hide" }, encrypted.ciphertext)
+          ]));
+        } catch (err) {
+          logger.error("ClientController", `Failed to encrypt revoke to ${deviceJid}:`, err);
+        }
+      }
+      const msgNode = encodeNode("message", { to: toJid, type: "text", id: newMessageId, edit: editAttr }, [
+        encodeNode("participants", {}, participantNodes),
+        encodeNode("franking", {}, [encodeNode("franking_tag", {}, frankingTag)]),
+        encodeNode("trace", {}, [encodeNode("request_id", {}, Buffer.from(randomUUID3().replace(/-/g, ""), "hex"))])
+      ]);
+      await this.e2eeSocket.sendFrame(marshal(msgNode));
+      logger.info("ClientController", `E2EE DM revoke sent for message ${messageId} to ${toJid}`);
+    }
+  }
+  /**
+   * Edit an E2EE message (change its text).
+   *
+   * - **E2EE threads**: Sends an encrypted `ConsumerApplication { content { editMessage { key, message, timestampMS } } }`
+   *   payload with the edit message attribute set.
+   * - **Non-E2EE threads**: Falls back to `fca-unofficial` HTTP edit.
+   */
+  async editMessage(input) {
+    const isE2EE = this.isE2EEThreadId(input.threadId);
+    if (this.e2eeConnected && isE2EE) {
+      await this.sendE2EEEdit(input.threadId, input.messageId, input.newText);
+      return;
+    }
+    await this.threadService.editMessage(this.requireApi(), {
+      messageId: input.messageId,
+      newText: input.newText
+    });
+  }
+  /**
+   * Send an E2EE message edit for a DM or group message.
+   *
+   * Builds a `ConsumerApplication { payload { content { editMessage { key, message, timestampMS } } } }`
+   * payload, fanned out to all participant devices exactly like a normal message send.
+   */
+  async sendE2EEEdit(threadId, messageId, newText) {
+    if (!this.e2eeSocket) throw new Error("E2EE not connected");
+    const e2eeClient = this.e2eeService.getClient();
+    const selfJid = this.getSelfE2EEJid();
+    const isGroup = threadId.includes("@g.us") || threadId.includes(".g.");
+    const editAttr = "1";
+    const toJid = isGroup ? threadId : normalizeDMThreadToJid(threadId);
+    const consumerApp = e2eeClient.buildEditMessage(messageId, newText);
+    const { messageApp, frankingTag } = e2eeClient.buildMessageApplication(consumerApp);
+    const newMessageId = String(BigInt(Math.floor(Math.random() * 1e15)));
+    if (isGroup) {
+      const memberJids = await this.e2eeHandler.getGroupParticipants(threadId);
+      const deviceUsers = uniqueJids([...memberJids, toBareMessengerJid(selfJid)]);
+      const deviceJids = uniqueJids(await this.e2eeHandler.getDeviceList(deviceUsers)).filter((jid) => !sameMessengerDevice(jid, selfJid));
+      const groupResult = await e2eeClient.encryptGroupMessageApplication(
+        threadId,
+        selfJid,
+        messageApp,
+        newMessageId
+      );
+      const participantNodes = [];
+      for (const deviceJid of deviceJids) {
+        try {
+          if (!await e2eeClient.hasSession(deviceJid)) {
+            const bundle = await this.e2eeHandler.getPreKeyBundle(deviceJid);
+            await e2eeClient.establishSession(deviceJid, bundle);
+          }
+          const payload = sameMessengerUser(deviceJid, selfJid) ? groupResult.selfDevicePayload : groupResult.devicePayload;
+          const skdmEnc = await e2eeClient.encryptDevicePayload(deviceJid, selfJid, payload);
+          participantNodes.push(encodeNode("to", { jid: deviceJid }, [
+            encodeNode("enc", { v: "3", type: skdmEnc.type }, skdmEnc.ciphertext)
+          ]));
+        } catch (err) {
+          logger.error("ClientController", `Failed to distribute edit SKDM to ${deviceJid}:`, err);
+        }
+      }
+      const phash = buildParticipantListHash(deviceJids);
+      const msgNode = encodeNode("message", { to: threadId, type: "text", id: newMessageId, phash, edit: editAttr }, [
+        encodeNode("participants", {}, participantNodes),
+        encodeNode("franking", {}, [encodeNode("franking_tag", {}, frankingTag)]),
+        encodeNode("trace", {}, [encodeNode("request_id", {}, Buffer.from(randomUUID3().replace(/-/g, ""), "hex"))]),
+        encodeNode("enc", { v: "3", type: "skmsg", "decrypt-fail": "hide" }, groupResult.groupCiphertext)
+      ]);
+      await this.e2eeSocket.sendFrame(marshal(msgNode));
+      logger.info("ClientController", `E2EE group edit sent for message ${messageId} in ${threadId}`);
+    } else {
+      const devicePayload = e2eeClient.buildMessageTransport({ messageApp });
+      const selfDevicePayload = e2eeClient.buildMessageTransport({
+        messageApp,
+        dsm: { destinationJid: toJid, phash: "" }
+      });
+      const participantNodes = [];
+      const deviceJids = uniqueJids(await this.e2eeHandler.getDeviceList([toJid, toBareMessengerJid(selfJid)]));
+      for (const deviceJid of deviceJids) {
+        if (sameMessengerDevice(deviceJid, selfJid)) continue;
+        try {
+          if (!await e2eeClient.hasSession(deviceJid)) {
+            const bundle = await this.e2eeHandler.getPreKeyBundle(deviceJid);
+            await e2eeClient.establishSession(deviceJid, bundle);
+          }
+          const payload = sameMessengerUser(deviceJid, selfJid) ? selfDevicePayload : devicePayload;
+          const encrypted = await e2eeClient.encryptDevicePayload(deviceJid, selfJid, payload);
+          participantNodes.push(encodeNode("to", { jid: deviceJid }, [
+            encodeNode("enc", { v: "3", type: encrypted.type, "decrypt-fail": "hide" }, encrypted.ciphertext)
+          ]));
+        } catch (err) {
+          logger.error("ClientController", `Failed to encrypt edit to ${deviceJid}:`, err);
+        }
+      }
+      const msgNode = encodeNode("message", { to: toJid, type: "text", id: newMessageId, edit: editAttr }, [
+        encodeNode("participants", {}, participantNodes),
+        encodeNode("franking", {}, [encodeNode("franking_tag", {}, frankingTag)]),
+        encodeNode("trace", {}, [encodeNode("request_id", {}, Buffer.from(randomUUID3().replace(/-/g, ""), "hex"))])
+      ]);
+      await this.e2eeSocket.sendFrame(marshal(msgNode));
+      logger.info("ClientController", `E2EE DM edit sent for message ${messageId} to ${toJid}`);
+    }
   }
   async sendTyping(input) {
     await this.messagingService.sendTyping(this.requireApi(), input);
@@ -8355,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;
@@ -8502,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);
   }
@@ -8541,9 +8833,6 @@ var ClientController = class {
   async createPoll(input) {
     await this.threadService.createPoll(this.requireApi(), input);
   }
-  async editMessage(input) {
-    return this.threadService.editMessage(this.requireApi(), input);
-  }
   async addGroupMember(input) {
     await this.threadService.addGroupMember(this.requireApi(), input);
   }
@@ -8561,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();
@@ -8800,8 +9100,11 @@ var FBClient = class {
   async sendReaction(input) {
     await this.controller.sendReaction(input);
   }
-  async unsendMessage(messageId) {
-    await this.controller.unsendMessage(messageId);
+  async unsendMessage(input) {
+    await this.controller.unsendMessage(input);
+  }
+  async editMessage(input) {
+    await this.controller.editMessage(input);
   }
   async sendTyping(input) {
     await this.controller.sendTyping(input);
@@ -8819,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,