nexus-fca 1.0.0

package/src/changeCover.js

@@ -0,0 +1,72 @@
+// Nexus-FCA: Advanced and Safe Facebook Chat API
+// changeCover.js - Change Facebook cover photo
+
+const utils = require('../utils');
+
+module.exports = function (defaultFuncs, api, ctx) {
+  return function changeCover(image, callback) {
+    let cb;
+    const rt = new Promise(function (resolve, reject) {
+      cb = (error, url) => error ? reject(error) : resolve(url);
+    });
+
+    if (typeof image == 'function') {
+      callback = image;
+      image = null;
+    }
+    if (typeof callback == 'function') cb = callback;
+    if (!utils.isReadableStream(image)) {
+      const error = 'image should be a readable stream, not ' + utils.getType(image);
+      utils.error('changeCover', error);
+      cb(error);
+    } else {
+      defaultFuncs
+        .postFormData('https://www.facebook.com/profile/picture/upload/', ctx.jar, {
+          profile_id: ctx.userID,
+          photo_source: 57,
+          av: ctx.userID,
+          file: image
+        })
+        .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+        .then(function (res) {
+          if (res.error || res.errors || !res.payload) 
+            throw res;
+
+          const vari = {
+            input: {
+              attribution_id_v2: `ProfileCometCollectionRoot.react,comet.profile.collection.photos_by,unexpected,${Date.now()},770083,,;ProfileCometCollectionRoot.react,comet.profile.collection.photos_albums,unexpected,${Date.now()},470774,,;ProfileCometCollectionRoot.react,comet.profile.collection.photos,unexpected,${Date.now()},94740,,;ProfileCometCollectionRoot.react,comet.profile.collection.saved_reels_on_profile,unexpected,${Date.now()},89669,,;ProfileCometCollectionRoot.react,comet.profile.collection.reels_tab,unexpected,${Date.now()},152201,,`,
+              cover_photo_id: res.payload.fbid,
+              focus: {
+                x: 0.5,
+                y: 1
+              },
+              target_user_id: ctx.userID,
+              actor_id: ctx.userID, 
+              client_mutation_id: Math.round(Math.random() * 19).toString()
+            },
+            scale: 1,
+            contextualProfileContext: null
+          };
+          return defaultFuncs
+            .post('https://www.facebook.com/api/graphql', ctx.jar, {
+              doc_id: 8247793861913071,
+              server_timestamps: true,
+              fb_api_req_friendly_name: 'ProfileCometCoverPhotoUpdateMutation',
+              variables: JSON.stringify(vari)
+            })
+            .then(utils.parseAndCheckLogin(ctx, defaultFuncs));
+        })
+        .then(function (res) {
+          if (res.errors) 
+            throw res;
+          return cb(null, res.data.user_update_cover_photo.user.cover_photo.photo.url);
+        })
+        .catch(function (err) {
+          utils.error('changeCover', err);
+          return cb(err);
+        });
+    }
+
+    return rt;
+  };
+};

package/src/changeGroupImage.js

@@ -0,0 +1,132 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	function handleUpload(image, callback) {
+		const uploads = [];
+
+		const form = {
+			images_only: "true",
+			"attachment[]": image
+		};
+
+		uploads.push(
+			defaultFuncs
+				.postFormData(
+					"https://upload.facebook.com/ajax/mercury/upload.php",
+					ctx.jar,
+					form,
+					{}
+				)
+				.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+				.then(function (resData) {
+					if (resData.error) {
+						throw resData;
+					}
+
+					return resData.payload.metadata[0];
+				})
+		);
+
+		// resolve all promises
+		Promise
+			.all(uploads)
+			.then(function (resData) {
+				callback(null, resData);
+			})
+			.catch(function (err) {
+				log.error("handleUpload", err);
+				return callback(err);
+			});
+	}
+
+	return function changeGroupImage(image, threadID, callback) {
+		if (
+			!callback &&
+			(utils.getType(threadID) === "Function" ||
+				utils.getType(threadID) === "AsyncFunction")
+		) {
+			throw { error: "please pass a threadID as a second argument." };
+		}
+
+		if (!utils.isReadableStream(image)) {
+			throw { error: "please pass a readable stream as a first argument." };
+		}
+
+		let resolveFunc = function () { };
+		let rejectFunc = function () { };
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+
+		if (!callback) {
+			callback = function (err) {
+				if (err) {
+					return rejectFunc(err);
+				}
+				resolveFunc();
+			};
+		}
+
+		const messageAndOTID = utils.generateOfflineThreadingID();
+		const form = {
+			client: "mercury",
+			action_type: "ma-type:log-message",
+			author: "fbid:" + (ctx.i_userID || ctx.userID),
+			author_email: "",
+			ephemeral_ttl_mode: "0",
+			is_filtered_content: false,
+			is_filtered_content_account: false,
+			is_filtered_content_bh: false,
+			is_filtered_content_invalid_app: false,
+			is_filtered_content_quasar: false,
+			is_forward: false,
+			is_spoof_warning: false,
+			is_unread: false,
+			log_message_type: "log:thread-image",
+			manual_retry_cnt: "0",
+			message_id: messageAndOTID,
+			offline_threading_id: messageAndOTID,
+			source: "source:chat:web",
+			"source_tags[0]": "source:chat",
+			status: "0",
+			thread_fbid: threadID,
+			thread_id: "",
+			timestamp: Date.now(),
+			timestamp_absolute: "Today",
+			timestamp_relative: utils.generateTimestampRelative(),
+			timestamp_time_passed: "0"
+		};
+
+		handleUpload(image, function (err, payload) {
+			if (err) {
+				return callback(err);
+			}
+
+			form["thread_image_id"] = payload[0]["image_id"];
+			form["thread_id"] = threadID;
+
+			defaultFuncs
+				.post("https://www.facebook.com/messaging/set_thread_image/", ctx.jar, form)
+				.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+				.then(function (resData) {
+					// check for errors here
+
+					if (resData.error) {
+						throw resData;
+					}
+
+					return callback();
+				})
+				.catch(function (err) {
+					log.error("changeGroupImage", err);
+					return callback(err);
+				});
+		});
+
+		return returnPromise;
+	};
+};

package/src/changeName.js

@@ -0,0 +1,79 @@
+// Nexus-FCA: Advanced and Safe Facebook Chat API
+// changeName.js - Change Facebook profile name
+
+const utils = require('../utils');
+
+module.exports = function (defaultFuncs, api, ctx) {
+  return function changeName(input, format, callback) {
+    let cb;
+    const rt = new Promise(function (resolve, reject) {
+      cb = error => error ? reject(error) : resolve();
+    });
+
+    if (typeof input == 'function') {
+      callback = input;
+      input = null;
+    }
+    if (typeof format == 'function') {
+      callback = format;
+      format = 'complete';
+    }
+    if (typeof callback == 'function') cb = callback;
+    if (utils.getType(input) != 'Object') {
+      const error = 'name must be an object, not ' + utils.getType(input);
+      utils.error('changeName', error);
+      return cb(error);
+    }
+
+    let { first_name, middle_name, last_name } = input;
+    if (!first_name || !last_name) {
+      utils.error('changeName', 'name is not be accepted');
+      return cb('name is not be accepted');
+    }
+
+    middle_name = middle_name || '';
+
+    const full_name =
+      format == 'complete' ? last_name + ' ' + (middle_name != '' ? middle_name + ' ' : '') + first_name :
+      format == 'standard' ? last_name + ' ' + first_name :
+      format == 'reversed' ? first_name + ' ' + (middle_name != '' ? middle_name + ' ' : '') + last_name :
+      last_name + ' ' + (middle_name != '' ? middle_name + ' ' : '') + first_name;
+
+    const form = {
+      fb_api_caller_class: 'RelayModern',
+      fb_api_req_friendly_name: 'useFXIMUpdateNameMutation',
+      variables: JSON.stringify({
+        client_mutation_id: utils.getGUID(),
+        family_device_id: "device_id_fetch_datr",
+        identity_ids: [ctx.userID],
+        full_name,
+        first_name,
+        middle_name,
+        last_name,
+        interface: 'FB_WEB'
+      }),
+      server_timestamps: true,
+      doc_id: '5763510853763960'
+    };
+
+    defaultFuncs
+      .post('https://accountscenter.facebook.com/api/graphql/', ctx.jar, form, null, null, {
+        Origin: 'https://accountscenter.facebook.com',
+        Referer: `https://accountscenter.facebook.com/profiles/${ctx.userID}/name`
+      })
+      .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+      .then(function (res) {
+        if (res.errors)
+          throw res;
+        else if (res.data.fxim_update_identity_name.error)
+          throw res.data.fxim_update_identity_name.error;
+        return cb();
+      })
+      .catch(function (err) {
+        utils.error('changeName', err);
+        return cb(err);
+      });
+
+    return rt;
+  };
+};

package/src/changeNickname.js

@@ -0,0 +1,59 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	return function changeNickname(nickname, threadID, participantID, callback) {
+		let resolveFunc = function () { };
+		let rejectFunc = function () { };
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+		if (!callback) {
+			callback = function (err) {
+				if (err) {
+					return rejectFunc(err);
+				}
+				resolveFunc();
+			};
+		}
+
+		const form = {
+			nickname: nickname,
+			participant_id: participantID,
+			thread_or_other_fbid: threadID
+		};
+
+		defaultFuncs
+			.post(
+				"https://www.facebook.com/messaging/save_thread_nickname/?source=thread_settings&dpr=1",
+				ctx.jar,
+				form
+			)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData.error === 1545014) {
+					throw { error: "Trying to change nickname of user isn't in thread" };
+				}
+				if (resData.error === 1357031) {
+					throw {
+						error:
+							"Trying to change user nickname of a thread that doesn't exist. Have at least one message in the thread before trying to change the user nickname."
+					};
+				}
+				if (resData.error) {
+					throw resData;
+				}
+
+				return callback();
+			})
+			.catch(function (err) {
+				log.error("changeNickname", err);
+				return callback(err);
+			});
+
+		return returnPromise;
+	};
+};

package/src/changeThreadColor.js

@@ -0,0 +1,65 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	return function changeThreadColor(color, threadID, callback) {
+		let resolveFunc = function () { };
+		let rejectFunc = function () { };
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+
+		if (!callback) {
+			callback = function (err) {
+				if (err) {
+					return rejectFunc(err);
+				}
+				resolveFunc(err);
+			};
+		}
+
+		if (!isNaN(color)) {
+			color = color.toString();
+		}
+		const validatedColor = color !== null ? color.toLowerCase() : color; // API only accepts lowercase letters in hex string
+
+		const form = {
+			dpr: 1,
+			queries: JSON.stringify({
+				o0: {
+					//This doc_id is valid as of January 31, 2020
+					doc_id: "1727493033983591",
+					query_params: {
+						data: {
+							actor_id: ctx.i_userID || ctx.userID,
+							client_mutation_id: "0",
+							source: "SETTINGS",
+							theme_id: validatedColor,
+							thread_id: threadID
+						}
+					}
+				}
+			})
+		};
+
+		defaultFuncs
+			.post("https://www.facebook.com/api/graphqlbatch/", ctx.jar, form)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData[resData.length - 1].error_results > 0) {
+					throw new utils.CustomError(resData[0].o0.errors);
+				}
+
+				return callback();
+			})
+			.catch(function (err) {
+				log.error("changeThreadColor", err);
+				return callback(err);
+			});
+
+		return returnPromise;
+	};
+};

package/src/changeThreadEmoji.js

@@ -0,0 +1,55 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	return function changeThreadEmoji(emoji, threadID, callback) {
+		let resolveFunc = function () { };
+		let rejectFunc = function () { };
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+
+		if (!callback) {
+			callback = function (err) {
+				if (err) {
+					return rejectFunc(err);
+				}
+				resolveFunc();
+			};
+		}
+		const form = {
+			emoji_choice: emoji,
+			thread_or_other_fbid: threadID
+		};
+
+		defaultFuncs
+			.post(
+				"https://www.facebook.com/messaging/save_thread_emoji/?source=thread_settings&__pc=EXP1%3Amessengerdotcom_pkg",
+				ctx.jar,
+				form
+			)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData.error === 1357031) {
+					throw {
+						error:
+							"Trying to change emoji of a chat that doesn't exist. Have at least one message in the thread before trying to change the emoji."
+					};
+				}
+				if (resData.error) {
+					throw resData;
+				}
+
+				return callback();
+			})
+			.catch(function (err) {
+				log.error("changeThreadEmoji", err);
+				return callback(err);
+			});
+
+		return returnPromise;
+	};
+};

package/src/changeUsername.js

@@ -0,0 +1,58 @@
+// Nexus-FCA: Advanced and Safe Facebook Chat API
+// changeUsername.js - Change your Facebook username
+
+const utils = require('../utils');
+
+module.exports = function (defaultFuncs, api, ctx) {
+  return function changeUsername(username, callback) {
+    let cb;
+    let rt = new Promise(function (resolve, reject) {
+      cb = (error, info) => info ? resolve(info) : reject(error);
+    });
+
+    if (typeof username == 'function') {
+      let error = 'username must be a string, and not ' + utils.getType(username);
+      utils.error('changeUsername', error);
+      return username(error);
+    }
+    if (typeof callback == 'function') cb = callback;
+    if (typeof username != 'string') {
+      let error = 'username must be a string, and not ' + utils.getType(username);
+      utils.error('changeUsername', error);
+      return cb(error);
+    }
+
+    let form = {
+      fb_api_caller_class: 'RelayModern',
+      fb_api_req_friendly_name: 'useFXIMUpdateUsernameMutation',
+      variables: JSON.stringify({
+        client_mutation_id: utils.getGUID(),
+        family_device_id: "device_id_fetch_datr",
+        identity_ids: [ctx.userID],
+        username,
+        interface: "FB_WEB"
+      }),
+      server_timestamps: true,
+      doc_id: 5737739449613305
+    }
+
+    defaultFuncs
+      .post('https://accountscenter.facebook.com/api/graphql/', ctx.jar, form, null, null, {
+        Origin: 'https://accountscenter.facebook.com',
+        Referer: `https://accountscenter.facebook.com/profiles/${ctx.userID}/username/?entrypoint=fb_account_center`
+      })
+      .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+      .then(function (res) {
+        if (res.errors) 
+          throw res;
+        else if (res.data.fxim_update_identity_username.error) 
+          throw res.data.fxim_update_identity_username.error;
+        return cb();
+      })
+      .catch(function (err) {
+        utils.error('changeUsername', err);
+        return cb(err);
+      });
+    return rt;
+  }
+}