Attachment forwarding

DOCS.md

@@ -11,6 +11,7 @@
 * [`api.createPoll`](#createPoll)
 * [`api.deleteMessage`](#deleteMessage)
 * [`api.deleteThread`](#deleteThread)
+* [`api.forwardAttachment`](#forwardAttachment)
 * [`api.getAppState`](#getAppState)
 * [`api.getCurrentUserID`](#getCurrentUserID)
 * [`api.getFriendsList`](#getFriendsList)
@@ -412,6 +413,18 @@ login({appState: JSON.parse(fs.readFileSync('appstate.json', 'utf8'))}, (err, ap
 
 ---------------------------------------
 
+<a name="forwardAttachment"></a>
+### api.forwardAttachment(attachmentID, userOrUsers[, callback])
+
+Takes a userID or an array of userIDs and forward the corresponding attachment.
+
+__Arguments__
+* `attachmentID`: The ID field in the attachment object. Not all attachment have IDs: recorded audio and arbitrary files don't for example.
+* `userOrUsers`: A userID string or usersID string array
+* `callback(err)`: A callback called when the query is done (either with an error or null).
+
+---------------------------------------
+
 <a name="getAppState"></a>
 ### api.getAppState()
 

README.md

@@ -51,6 +51,7 @@ Result:
 * [`api.createPoll`](DOCS.md#createPoll)
 * [`api.deleteMessage`](DOCS.md#deleteMessage)
 * [`api.deleteThread`](DOCS.md#deleteThread)
+* [`api.forwardAttachment`](DOCS.md#forwardAttachment)
 * [`api.getAppState`](DOCS.md#getAppState)
 * [`api.getCurrentUserID`](DOCS.md#getCurrentUserID)
 * [`api.getFriendsList`](DOCS.md#getFriendsList)

index.js

@@ -82,6 +82,7 @@ function buildAPI(globalOptions, html, jar) {
     'createPoll',
     'deleteMessage',
     'deleteThread',
+    'forwardAttachment',
     'getCurrentUserID',
     'getFriendsList',
     'getThreadHistory',

src/forwardAttachment.js

@@ -0,0 +1,43 @@
+"use strict";
+
+var utils = require("../utils");
+var log = require("npmlog");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function forwardAttachment(attachmentID, userOrUsers, callback) {
+    if (!callback) {
+      callback = function() {};
+    }
+
+    var form = {
+      attachment_id: attachmentID,
+    };
+
+    if(utils.getType(userOrUsers) !== "Array") {
+      userOrUsers = [userOrUsers];
+    }
+
+    var timestamp = Math.floor(Date.now() / 1000);
+
+    for (var i = 0; i < userOrUsers.length; i++) {
+      //That's good, the key of the array is really timestmap in seconds + index
+      //Probably time when the attachment will be sent?
+      form['recipient_map[' + (timestamp + i) + ']'] = userOrUsers[i];
+    }
+
+    defaultFuncs
+      .post("https://www.messenger.com/mercury/attachments/forward/", ctx.jar, form)
+      .then(utils.parseAndCheckLogin(ctx.jar, defaultFuncs))
+      .then(function(resData) {
+        if (resData.error) {
+          throw resData;
+        }
+
+        return callback(null);
+      })
+      .catch(function(err) {
+        log.error("forwardAttachment", err);
+        return callback(err);
+      });
+  };
+};