fca-orion-api 1.0.0

package/src/changeAdminStatus.js

@@ -0,0 +1,79 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	return function changeAdminStatus(threadID, adminIDs, adminStatus, callback) {
+		if (utils.getType(threadID) !== "String") {
+			throw new utils.CustomError({ error: "changeAdminStatus: threadID must be a string" });
+		}
+
+		if (utils.getType(adminIDs) === "String") {
+			adminIDs = [adminIDs];
+		}
+
+		if (utils.getType(adminIDs) !== "Array") {
+			throw new utils.CustomError({ error: "changeAdminStatus: adminIDs must be an array or string" });
+		}
+
+		if (utils.getType(adminStatus) !== "Boolean") {
+			throw new utils.CustomError({ error: "changeAdminStatus: adminStatus must be a string" });
+		}
+
+		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();
+			};
+		}
+
+		if (utils.getType(callback) !== "Function" && utils.getType(callback) !== "AsyncFunction") {
+			throw new utils.CustomError({ error: "changeAdminStatus: callback is not a function" });
+		}
+
+		const form = {
+			"thread_fbid": threadID
+		};
+
+		let i = 0;
+		for (const u of adminIDs) {
+			form[`admin_ids[${i++}]`] = u;
+		}
+		form["add"] = adminStatus;
+
+		defaultFuncs
+			.post("https://www.facebook.com/messaging/save_admins/?dpr=1", ctx.jar, form)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData.error) {
+					switch (resData.error) {
+						case 1976004:
+							throw new utils.CustomError({ error: "Cannot alter admin status: you are not an admin.", rawResponse: resData });
+						case 1357031:
+							throw new utils.CustomError({ error: "Cannot alter admin status: this thread is not a group chat.", rawResponse: resData });
+						default:
+							throw new utils.CustomError({ error: "Cannot alter admin status: unknown error.", rawResponse: resData });
+					}
+				}
+
+				callback();
+			})
+			.catch(function (err) {
+				log.error("changeAdminStatus", err);
+				return callback(err);
+			});
+
+		return returnPromise;
+	};
+};
+

package/src/changeArchivedStatus.js

@@ -0,0 +1,55 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	return function changeArchivedStatus(threadOrThreads, archive, 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 = {};
+
+		if (utils.getType(threadOrThreads) === "Array") {
+			for (let i = 0; i < threadOrThreads.length; i++) {
+				form["ids[" + threadOrThreads[i] + "]"] = archive;
+			}
+		} else {
+			form["ids[" + threadOrThreads + "]"] = archive;
+		}
+
+		defaultFuncs
+			.post(
+				"https://www.facebook.com/ajax/mercury/change_archived_status.php",
+				ctx.jar,
+				form
+			)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData.error) {
+					throw resData;
+				}
+
+				return callback();
+			})
+			.catch(function (err) {
+				log.error("changeArchivedStatus", err);
+				return callback(err);
+			});
+
+		return returnPromise;
+	};
+};

package/src/changeAvatar.js

@@ -0,0 +1,126 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	function handleUpload(image, callback) {
+		const uploads = [];
+
+		const form = {
+			profile_id: ctx.i_userID || ctx.userID,
+			photo_source: 57,
+			av: ctx.i_userID || ctx.userID,
+			file: image
+		};
+
+		uploads.push(
+			defaultFuncs
+				.postFormData(
+					"https://www.facebook.com/profile/picture/upload/",
+					ctx.jar,
+					form,
+					{}
+				)
+				.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+				.then(function (resData) {
+					if (resData.error) {
+						throw resData;
+					}
+					return resData;
+				})
+		);
+
+		// resolve all promises
+		Promise
+			.all(uploads)
+			.then(function (resData) {
+				callback(null, resData);
+			})
+			.catch(function (err) {
+				log.error("handleUpload", err);
+				return callback(err);
+			});
+	}
+
+	return function changeAvatar(image, caption = "", timestamp = null, callback) {
+		let resolveFunc = function () { };
+		let rejectFunc = function () { };
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+
+		if (!timestamp && utils.getType(caption) === "Number") {
+			timestamp = caption;
+			caption = "";
+		}
+
+		if (!timestamp && !callback && (utils.getType(caption) == "Function" || utils.getType(caption) == "AsyncFunction")) {
+			callback = caption;
+			caption = "";
+			timestamp = null;
+		}
+
+		if (!callback) callback = function (err, data) {
+			if (err) {
+				return rejectFunc(err);
+			}
+			resolveFunc(data);
+		};
+
+		if (!utils.isReadableStream(image))
+			return callback("Image is not a readable stream");
+
+		handleUpload(image, function (err, payload) {
+			if (err) {
+				return callback(err);
+			}
+
+			const form = {
+				av: ctx.i_userID || ctx.userID,
+				fb_api_req_friendly_name: "ProfileCometProfilePictureSetMutation",
+				fb_api_caller_class: "RelayModern",
+				doc_id: "5066134240065849",
+				variables: JSON.stringify({
+					input: {
+						caption,
+						existing_photo_id: payload[0].payload.fbid,
+						expiration_time: timestamp,
+						profile_id: ctx.i_userID || ctx.userID,
+						profile_pic_method: "EXISTING",
+						profile_pic_source: "TIMELINE",
+						scaled_crop_rect: {
+							height: 1,
+							width: 1,
+							x: 0,
+							y: 0
+						},
+						skip_cropping: true,
+						actor_id: ctx.i_userID || ctx.userID,
+						client_mutation_id: Math.round(Math.random() * 19).toString()
+					},
+					isPage: false,
+					isProfile: true,
+					scale: 3
+				})
+			};
+
+			defaultFuncs
+				.post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+				.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+				.then(function (resData) {
+					if (resData.errors) {
+						throw resData;
+					}
+					return callback(null, resData[0].data.profile_picture_set);
+				})
+				.catch(function (err) {
+					log.error("changeAvatar", err);
+					return callback(err);
+				});
+		});
+
+		return returnPromise;
+	};
+};

package/src/changeBio.js

@@ -0,0 +1,77 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	return function changeBio(bio, publish, callback) {
+		let resolveFunc = function () { };
+		let rejectFunc = function () { };
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+
+		if (!callback) {
+			if (utils.getType(publish) == "Function" || utils.getType(publish) == "AsyncFunction") {
+				callback = publish;
+			} else {
+				callback = function (err) {
+					if (err) {
+						return rejectFunc(err);
+					}
+					resolveFunc();
+				};
+			}
+		}
+
+		if (utils.getType(publish) != "Boolean") {
+			publish = false;
+		}
+
+		if (utils.getType(bio) != "String") {
+			bio = "";
+			publish = false;
+		}
+
+		const form = {
+			fb_api_caller_class: "RelayModern",
+			fb_api_req_friendly_name: "ProfileCometSetBioMutation",
+			// This doc_is is valid as of May 23, 2020
+			doc_id: "2725043627607610",
+			variables: JSON.stringify({
+				input: {
+					bio: bio,
+					publish_bio_feed_story: publish,
+					actor_id: ctx.i_userID || ctx.userID,
+					client_mutation_id: Math.round(Math.random() * 1024).toString()
+				},
+				hasProfileTileViewID: false,
+				profileTileViewID: null,
+				scale: 1
+			}),
+			av: ctx.i_userID || ctx.userID
+		};
+
+		defaultFuncs
+			.post(
+				"https://www.facebook.com/api/graphql/",
+				ctx.jar,
+				form
+			)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData.errors) {
+					throw resData;
+				}
+
+				return callback();
+			})
+			.catch(function (err) {
+				log.error("changeBio", err);
+				return callback(err);
+			});
+
+		return returnPromise;
+	};
+};

package/src/changeBlockedStatus.js

@@ -0,0 +1,47 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	return function changeBlockedStatus(userID, block, 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();
+			};
+		}
+
+		defaultFuncs
+			.post(
+				`https://www.facebook.com/messaging/${block ? "" : "un"}block_messages/`,
+				ctx.jar,
+				{
+					fbid: userID
+				}
+			)
+			.then(utils.saveCookies(ctx.jar))
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData.error) {
+					throw resData;
+				}
+
+				return callback();
+			})
+			.catch(function (err) {
+				log.error("changeBlockedStatus", err);
+				return callback(err);
+			});
+		return returnPromise;
+	};
+};

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/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;
+	};
+};