nexus-fca 1.0.0

package/src/addUserToGroup.js

@@ -0,0 +1,113 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	return function addUserToGroup(userID, threadID, callback) {
+		let resolveFunc = function () { };
+		let rejectFunc = function () { };
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+
+		if (
+			!callback &&
+			(utils.getType(threadID) === "Function" ||
+				utils.getType(threadID) === "AsyncFunction")
+		) {
+			throw new utils.CustomError({ error: "please pass a threadID as a second argument." });
+		}
+
+		if (!callback) {
+			callback = function (err) {
+				if (err) {
+					return rejectFunc(err);
+				}
+				resolveFunc();
+			};
+		}
+
+		if (
+			utils.getType(threadID) !== "Number" &&
+			utils.getType(threadID) !== "String"
+		) {
+			throw new utils.CustomError({
+				error:
+					"ThreadID should be of type Number or String and not " +
+					utils.getType(threadID) +
+					"."
+			});
+		}
+
+		if (utils.getType(userID) !== "Array") {
+			userID = [userID];
+		}
+
+		const messageAndOTID = utils.generateOfflineThreadingID();
+		const form = {
+			client: "mercury",
+			action_type: "ma-type:log-message",
+			author: "fbid:" + (ctx.i_userID || ctx.userID),
+			thread_id: "",
+			timestamp: Date.now(),
+			timestamp_absolute: "Today",
+			timestamp_relative: utils.generateTimestampRelative(),
+			timestamp_time_passed: "0",
+			is_unread: false,
+			is_cleared: false,
+			is_forward: false,
+			is_filtered_content: false,
+			is_filtered_content_bh: false,
+			is_filtered_content_account: false,
+			is_spoof_warning: false,
+			source: "source:chat:web",
+			"source_tags[0]": "source:chat",
+			log_message_type: "log:subscribe",
+			status: "0",
+			offline_threading_id: messageAndOTID,
+			message_id: messageAndOTID,
+			threading_id: utils.generateThreadingID(ctx.clientID),
+			manual_retry_cnt: "0",
+			thread_fbid: threadID
+		};
+
+		for (let i = 0; i < userID.length; i++) {
+			if (
+				utils.getType(userID[i]) !== "Number" &&
+				utils.getType(userID[i]) !== "String"
+			) {
+				throw new utils.CustomError({
+					error:
+						"Elements of userID should be of type Number or String and not " +
+						utils.getType(userID[i]) +
+						"."
+				});
+			}
+
+			form["log_message_data[added_participants][" + i + "]"] =
+				"fbid:" + userID[i];
+		}
+
+		defaultFuncs
+			.post("https://www.facebook.com/messaging/send/", ctx.jar, form)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (!resData) {
+					throw new utils.CustomError({ error: "Add to group failed." });
+				}
+				if (resData.error) {
+					throw new utils.CustomError(resData);
+				}
+
+				return callback();
+			})
+			.catch(function (err) {
+				log.error("addUserToGroup", err);
+				return callback(err);
+			});
+
+		return returnPromise;
+	};
+};

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/changeAvatarV2.js

@@ -0,0 +1,77 @@
+// Nexus-FCA: Advanced and Safe Facebook Chat API
+// changeAvatarV2.js - Change user avatar with advanced options
+
+const { rateLimiter, safeMode, isUserAllowed } = require('../utils');
+
+/**
+ * Change the user's Facebook avatar with advanced safety checks.
+ * @param {Object} defaultFuncs - Default functions from Nexus-FCA context
+ * @param {Object} api - Nexus-FCA API object
+ * @param {Object} ctx - Nexus-FCA context
+ * @returns {Function}
+ */
+module.exports = function changeAvatarV2(defaultFuncs, api, ctx) {
+  /**
+   * Change avatar with file stream or URL, with validation and rate limiting.
+   * @param {Object} options - { stream, url }
+   * @param {Function} callback
+   */
+  const lastChange = { time: 0 };
+  return function(options, callback) {
+    // Extract userID from context (for rate limiting and allow/block list)
+    const userID = ctx.userID || (ctx.globalOptions && ctx.globalOptions.userID) || 'unknown';
+
+    // Safe mode disables avatar change
+    if (safeMode) {
+      return callback(new Error("Avatar change is disabled in Nexus-FCA safe mode."));
+    }
+    // Allow/block list check
+    if (!isUserAllowed(userID)) {
+      return callback(new Error("You are not allowed to change the avatar."));
+    }
+    // Rate limiting (per user)
+    if (!rateLimiter.check(userID, 'changeAvatarV2')) {
+      return callback(new Error("Rate limit exceeded. Please wait before changing avatar again."));
+    }
+
+    // Safety: Only allow change every 5 minutes
+    const now = Date.now();
+    if (now - lastChange.time < 5 * 60 * 1000) {
+      return callback(new Error("Avatar can only be changed every 5 minutes for safety."));
+    }
+    lastChange.time = now;
+
+    // Input validation
+    if (!options || (!options.stream && !options.url)) {
+      return callback(new Error("You must provide a file stream or image URL."));
+    }
+    if (options.url && !/^https?:\/\//.test(options.url)) {
+      return callback(new Error("Invalid image URL."));
+    }
+
+    // Prepare form data
+    const form = {};
+    if (options.stream) {
+      form.file = options.stream;
+    } else if (options.url) {
+      form.url = options.url;
+    }
+
+    // Use the existing postFormData util for upload
+    defaultFuncs.postFormData(
+      "https://www.facebook.com/profile/picture/upload/",
+      ctx.jar,
+      form
+    )
+      .then(res => {
+        if (res.statusCode === 200) {
+          callback(null, { success: true, message: "Avatar changed successfully." });
+        } else {
+          callback(new Error("Failed to change avatar. Status: " + res.statusCode));
+        }
+      })
+      .catch(err => {
+        callback(new Error("Avatar change failed: " + err.message));
+      });
+  };
+};

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/changeBlockedStatusMqtt.js

@@ -0,0 +1,71 @@
+// Nexus-FCA: Advanced and Safe Facebook Chat API
+// changeBlockedStatusMqtt.js - Block/unblock users via MQTT
+
+const { generateOfflineThreadingID, getCurrentTimestamp, getGUID } = require('../utils.js');
+
+function isCallable(func) {
+  try {
+    Reflect.apply(func, null, []);
+    return true;
+  } catch (error) {
+    return false;
+  }
+}
+
+module.exports = function (defaultFuncs, api, ctx) {
+  return function changeBlockedStatusMqtt(userID, status, type, callback) {
+    if (!ctx.mqttClient) {
+      throw new Error('Not connected to MQTT');
+    }
+
+    ctx.wsReqNumber += 1;
+    ctx.wsTaskNumber += 1;
+
+    const label = '334';
+    let userBlockAction = 0;
+
+    switch (type) {
+      case 'messenger':
+        userBlockAction = status ? 1 : 0;
+        break;
+      case 'facebook':
+        userBlockAction = status ? 3 : 2;
+        break;
+      default:
+        throw new Error('Invalid type');
+    }
+
+    const taskPayload = {
+      blockee_id: userID,
+      request_id: getGUID(),
+      user_block_action: userBlockAction,
+    };
+    const payload = JSON.stringify(taskPayload);
+    const version = '25393437286970779';
+
+    const task = {
+      failure_count: null,
+      label: label,
+      payload: payload,
+      queue_name: 'native_sync_block',
+      task_id: ctx.wsTaskNumber,
+    };
+
+    const content = {
+      app_id: '2220391788200892',
+      payload: JSON.stringify({
+        tasks: [task],
+        epoch_id: parseInt(generateOfflineThreadingID()),
+        version_id: version,
+      }),
+      request_id: ctx.wsReqNumber,
+      type: 3,
+    };
+
+    if (isCallable(callback)) {
+      ctx.reqCallbacks[ctx.wsReqNumber] = callback;
+    }
+
+    ctx.mqttClient.publish('/ls_req', JSON.stringify(content), { qos: 1, retain: false });
+  };
+};