nexus-fca 1.0.0

package/src/getThreadList.js

@@ -0,0 +1,192 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+function createProfileUrl(url, username, id) {
+  if (url) return url;
+  return "https://www.facebook.com/" + (username || utils.formatID(id.toString()));
+}
+
+function formatParticipants(participants) {
+  return participants.edges.map((p) => {
+    p = p.node.messaging_actor;
+    switch (p["__typename"]) {
+      case "User":
+        return {
+          accountType: p["__typename"],
+          userID: utils.formatID(p.id.toString()), // do we need .toString()? when it is not a string?
+          name: p.name,
+          shortName: p.short_name,
+          gender: p.gender,
+          url: p.url, // how about making it profileURL
+          profilePicture: p.big_image_src.uri,
+          username: (p.username || null),
+          // TODO: maybe better names for these?
+          isViewerFriend: p.is_viewer_friend, // true/false
+          isMessengerUser: p.is_messenger_user, // true/false
+          isVerified: p.is_verified, // true/false
+          isMessageBlockedByViewer: p.is_message_blocked_by_viewer, // true/false
+          isViewerCoworker: p.is_viewer_coworker, // true/false
+          isEmployee: p.is_employee // null? when it is something other? can someone check?
+        };
+      case "Page":
+        return {
+          accountType: p["__typename"],
+          userID: utils.formatID(p.id.toString()), // or maybe... pageID?
+          name: p.name,
+          url: p.url,
+          profilePicture: p.big_image_src.uri,
+          username: (p.username || null),
+          // uhm... better names maybe?
+          acceptsMessengerUserFeedback: p.accepts_messenger_user_feedback, // true/false
+          isMessengerUser: p.is_messenger_user, // true/false
+          isVerified: p.is_verified, // true/false
+          isMessengerPlatformBot: p.is_messenger_platform_bot, // true/false
+          isMessageBlockedByViewer: p.is_message_blocked_by_viewer, // true/false
+        };
+      case "ReducedMessagingActor":
+      case "UnavailableMessagingActor":
+        return {
+          accountType: p["__typename"],
+          userID: utils.formatID(p.id.toString()),
+          name: p.name,
+          url: createProfileUrl(p.url, p.username, p.id), // in this case p.url is null all the time
+          profilePicture: p.big_image_src.uri, // in this case it is default facebook photo, we could determine gender using it
+          username: (p.username || null), // maybe we could use it to generate profile URL?
+          isMessageBlockedByViewer: p.is_message_blocked_by_viewer, // true/false
+        };
+      default:
+        log.warn("getThreadList", "Found participant with unsupported typename. Please open an issue at https://github.com/Schmavery/facebook-chat-api/issues\n" + JSON.stringify(p, null, 2));
+        return {
+          accountType: p["__typename"],
+          userID: utils.formatID(p.id.toString()),
+          name: p.name || `[unknown ${p["__typename"]}]`, // probably it will always be something... but fallback to [unknown], just in case
+        };
+    }
+  });
+}
+
+// "FF8C0077" -> "8C0077"
+function formatColor(color) {
+  if (color && color.match(/^(?:[0-9a-fA-F]{8})$/g)) return color.slice(2);
+  return color;
+}
+
+function getThreadName(t) {
+  if (t.name || t.thread_key.thread_fbid) return t.name;
+
+  for (let po of t.all_participants.edges) {
+    let p = po.node;
+    if (p.messaging_actor.id === t.thread_key.other_user_id) return p.messaging_actor.name;
+  }
+}
+
+function mapNicknames(customizationInfo) {
+  return (customizationInfo && customizationInfo.participant_customizations) ? customizationInfo.participant_customizations.map(u => {
+    return {
+      "userID": u.participant_id,
+      "nickname": u.nickname
+    };
+  }) : [];
+}
+
+function formatThreadList(data) {
+  return data.map(t => {
+    let lastMessageNode = (t.last_message && t.last_message.nodes && t.last_message.nodes.length > 0) ? t.last_message.nodes[0] : null;
+    return {
+      threadID: t.thread_key ? utils.formatID(t.thread_key.thread_fbid || t.thread_key.other_user_id) : null, // shall never be null
+      name: getThreadName(t),
+      unreadCount: t.unread_count,
+      messageCount: t.messages_count,
+      imageSrc: t.image ? t.image.uri : null,
+      emoji: t.customization_info ? t.customization_info.emoji : null,
+      color: formatColor(t.customization_info ? t.customization_info.outgoing_bubble_color : null),
+      threadTheme: t.thread_theme,
+      nicknames: mapNicknames(t.customization_info),
+      muteUntil: t.mute_until,
+      participants: formatParticipants(t.all_participants),
+      adminIDs: t.thread_admins.map(a => a.id),
+      folder: t.folder,
+      isGroup: t.thread_type === "GROUP",
+      customizationEnabled: t.customization_enabled, // false for ONE_TO_ONE with Page or ReducedMessagingActor
+      participantAddMode: t.participant_add_mode_as_string, // "ADD" if "GROUP" and null if "ONE_TO_ONE"
+      montageThread: t.montage_thread ? Buffer.from(t.montage_thread.id, "base64").toString() : null, // base64 encoded string "message_thread:0000000000000000"
+      reactionsMuteMode: t.reactions_mute_mode,
+      mentionsMuteMode: t.mentions_mute_mode,
+      isArchived: t.has_viewer_archived,
+      isSubscribed: t.is_viewer_subscribed,
+      timestamp: t.updated_time_precise, // in miliseconds
+      snippet: lastMessageNode ? lastMessageNode.snippet : null,
+      snippetAttachments: lastMessageNode ? lastMessageNode.extensible_attachment : null, // TODO: not sure if it works
+      snippetSender: lastMessageNode ? utils.formatID((lastMessageNode.message_sender.messaging_actor.id || "").toString()) : null,
+      lastMessageTimestamp: lastMessageNode ? lastMessageNode.timestamp_precise : null, // timestamp in miliseconds
+      lastReadTimestamp: (t.last_read_receipt && t.last_read_receipt.nodes.length > 0)
+        ? (t.last_read_receipt.nodes[0] ? t.last_read_receipt.nodes[0].timestamp_precise : null)
+        : null,
+      cannotReplyReason: t.cannot_reply_reason,
+      approvalMode: Boolean(t.approval_mode),
+      participantIDs: formatParticipants(t.all_participants).map(participant => participant.userID),
+      threadType: t.thread_type === "GROUP" ? 2 : 1, // "GROUP" or "ONE_TO_ONE"
+      inviteLink: {
+        enable: t.joinable_mode ? t.joinable_mode.mode == 1 : false,
+        link: t.joinable_mode ? t.joinable_mode.link : null
+      }
+    };
+  });
+}
+
+module.exports = function (defaultFuncs, api, ctx) {
+  return function getThreadList(limit, timestamp, tags, callback) {
+    if (!callback && (utils.getType(tags) === "Function" || utils.getType(tags) === "AsyncFunction")) {
+      callback = tags;
+      tags = [""];
+    }
+    if (utils.getType(limit) !== "Number" || !Number.isInteger(limit) || limit <= 0) throw { error: "getThreadList: limit must be a positive integer" };
+    if (utils.getType(timestamp) !== "Null" && (utils.getType(timestamp) !== "Number" || !Number.isInteger(timestamp))) throw { error: "getThreadList: timestamp must be an integer or null" };
+    if (utils.getType(tags) === "String") tags = [tags];
+    if (utils.getType(tags) !== "Array") throw { error: "getThreadList: tags must be an array" };
+    var resolveFunc = function () { };
+    var rejectFunc = function () { };
+    var returnPromise = new Promise(function (resolve, reject) {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+    if (utils.getType(callback) !== "Function" && utils.getType(callback) !== "AsyncFunction") {
+      callback = function (err, data) {
+        if (err) return rejectFunc(err);
+        resolveFunc(data);
+      };
+    }
+    const form = {
+      "av": ctx.globalOptions.pageID,
+      "queries": JSON.stringify({
+        "o0": {
+          "doc_id": "3336396659757871",
+          "query_params": {
+            "limit": limit + (timestamp ? 1 : 0),
+            "before": timestamp,
+            "tags": tags,
+            "includeDeliveryReceipts": true,
+            "includeSeqID": false
+          }
+        }
+      }),
+      "batch_name": "MessengerGraphQLThreadlistFetcher"
+    };
+    defaultFuncs
+      .post("https://www.facebook.com/api/graphqlbatch/", ctx.jar, form)
+      .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+      .then((resData) => {
+        if (resData[resData.length - 1].error_results > 0) throw resData[0].o0.errors;
+        if (resData[resData.length - 1].successful_results === 0) throw { error: "getThreadList: there was no successful_results", res: resData };
+        if (timestamp) resData[0].o0.data.viewer.message_threads.nodes.shift();
+        callback(null, formatThreadList(resData[0].o0.data.viewer.message_threads.nodes));
+      })
+      .catch((err) => {
+        log.error("getThreadList", err);
+        return callback(err);
+      });
+    return returnPromise;
+  };
+};

package/src/getThreadListDeprecated.js

@@ -0,0 +1,54 @@
+// Nexus-FCA: Advanced and Safe Facebook Chat API
+// getThreadListDeprecated.js - Deprecated thread list fetch
+
+const utils = require("../utils");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function getThreadList(start, end, type, callback) {
+    if (utils.getType(callback) === "Undefined") {
+      if (utils.getType(end) !== "Number") {
+        throw {
+          error: "Please pass a number as a second argument."
+        };
+      } else if (
+        utils.getType(type) === "Function" ||
+        utils.getType(type) === "AsyncFunction"
+      ) {
+        callback = type;
+        type = "inbox"; //default to inbox
+      } else if (utils.getType(type) !== "String") {
+        throw {
+          error:
+            "Please pass a String as a third argument. Your options are: inbox, pending, and archived"
+        };
+      } else {
+        throw {
+          error: "getThreadList: need callback"
+        };
+      }
+    }
+
+    if (type === "archived") {
+      type = "action:archived";
+    } else if (type !== "inbox" && type !== "pending" && type !== "other") {
+      throw {
+        error:
+          "type can only be one of the following: inbox, pending, archived, other"
+      };
+    }
+
+    if (end <= start) end = start + 20;
+
+    const form = {
+      client: "mercury"
+    };
+
+    form[type + "[offset]"] = start;
+    form[type + "[limit]"] = end - start;
+
+    if (ctx.globalOptions.pageID) {
+      form.request_user_id = ctx.globalOptions.pageID;
+    }
+    // ...existing code...
+  };
+};

package/src/getThreadPictures.js

@@ -0,0 +1,79 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	return function getThreadPictures(threadID, offset, limit, callback) {
+		let resolveFunc = function () { };
+		let rejectFunc = function () { };
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+
+		if (!callback) {
+			callback = function (err, friendList) {
+				if (err) {
+					return rejectFunc(err);
+				}
+				resolveFunc(friendList);
+			};
+		}
+
+		let form = {
+			thread_id: threadID,
+			offset: offset,
+			limit: limit
+		};
+
+		defaultFuncs
+			.post(
+				"https://www.facebook.com/ajax/messaging/attachments/sharedphotos.php",
+				ctx.jar,
+				form
+			)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData.error) {
+					throw resData;
+				}
+				return Promise.all(
+					resData.payload.imagesData.map(function (image) {
+						form = {
+							thread_id: threadID,
+							image_id: image.fbid
+						};
+						return defaultFuncs
+							.post(
+								"https://www.facebook.com/ajax/messaging/attachments/sharedphotos.php",
+								ctx.jar,
+								form
+							)
+							.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+							.then(function (resData) {
+								if (resData.error) {
+									throw resData;
+								}
+								// the response is pretty messy
+								const queryThreadID =
+									resData.jsmods.require[0][3][1].query_metadata.query_path[0]
+										.message_thread;
+								const imageData =
+									resData.jsmods.require[0][3][1].query_results[queryThreadID]
+										.message_images.edges[0].node.image2;
+								return imageData;
+							});
+					})
+				);
+			})
+			.then(function (resData) {
+				callback(null, resData);
+			})
+			.catch(function (err) {
+				log.error("Error in getThreadPictures", err);
+				callback(err);
+			});
+		return returnPromise;
+	};
+};

package/src/getUID.js

@@ -0,0 +1,67 @@
+// Nexus-FCA: Advanced and Safe Facebook Chat API
+// getUID.js - Get Facebook user ID from profile link
+
+const axios = require('axios');
+const FormData = require('form-data');
+const { URL } = require('url');
+const log = require('npmlog');
+const utils = require('../utils');
+
+module.exports = function (defaultFuncs, api, ctx) {
+  return function getUID(link, callback) {
+    let resolveFunc = function () { };
+    let rejectFunc = function () { };
+    let returnPromise = new Promise(function (resolve, reject) {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!callback) {
+      callback = function (err, uid) {
+        if (err) return rejectFunc(err);
+        resolveFunc(uid);
+      };
+    }
+
+    async function getUIDFast(url) {
+      let Form = new FormData();
+      let Url = new URL(url);
+      Form.append('link', Url.href);
+      try {
+        let { data } = await axios.post('https://id.traodoisub.com/api.php', Form, {
+          headers: Form.getHeaders()
+        });
+        if (data.error) throw new Error(data.error);
+        return data.id || "Not found";
+      } catch (e) {
+        utils.error('getUID', "Error: " + e.message);
+        throw new Error(e.message);
+      }
+    }
+
+    async function getUIDSlow(url) {
+      let Form = new FormData();
+      let Url = new URL(url);
+      Form.append('username', Url.pathname.replace(/\//g, ""));
+      try {
+        const userAgentArray = [
+          "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3",
+          "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.1 Safari/605.1.15",
+          "Mozilla/5.0 (Linux; Android 10; SM-G977N) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.106 Mobile Safari/537.36",
+          "Mozilla/5.0 (Windows NT 6.1; WOW64; rv:54.0) Gecko/20100101 Firefox/54.0",
+        ];
+        // ...additional logic for slow fallback...
+      } catch (e) {
+        utils.error('getUID', "Error: " + e.message);
+        throw new Error(e.message);
+      }
+    }
+
+    // Try fast method first, fallback to slow
+    getUIDFast(link)
+      .then(uid => callback(null, uid))
+      .catch(() => getUIDSlow(link).then(uid => callback(null, uid)).catch(callback));
+
+    return returnPromise;
+  };
+};

package/src/getUserID.js

@@ -0,0 +1,66 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+function formatData(data) {
+	return {
+		userID: utils.formatID(data.uid.toString()),
+		photoUrl: data.photo,
+		indexRank: data.index_rank,
+		name: data.text,
+		isVerified: data.is_verified,
+		profileUrl: data.path,
+		category: data.category,
+		score: data.score,
+		type: data.type
+	};
+}
+
+module.exports = function (defaultFuncs, api, ctx) {
+	return function getUserID(name, callback) {
+		let resolveFunc = function () { };
+		let rejectFunc = function () { };
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+
+		if (!callback) {
+			callback = function (err, friendList) {
+				if (err) {
+					return rejectFunc(err);
+				}
+				resolveFunc(friendList);
+			};
+		}
+
+		const form = {
+			value: name.toLowerCase(),
+			viewer: ctx.i_userID || ctx.userID,
+			rsp: "search",
+			context: "search",
+			path: "/home.php",
+			request_id: utils.getGUID()
+		};
+
+		defaultFuncs
+			.get("https://www.facebook.com/ajax/typeahead/search.php", ctx.jar, form)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData.error) {
+					throw resData;
+				}
+
+				const data = resData.payload.entries;
+
+				callback(null, data.map(formatData));
+			})
+			.catch(function (err) {
+				log.error("getUserID", err);
+				return callback(err);
+			});
+
+		return returnPromise;
+	};
+};

package/src/getUserInfo.js

@@ -0,0 +1,80 @@
+"use strict";
+var utils = require("../utils");
+var log = require("npmlog");
+module.exports = function (defaultFuncs, api, ctx) {
+	function formatData(data) {
+		const retObj = {};
+		for (const actor of data.messaging_actors || []) {
+			retObj[actor.id] = {
+				name: actor.name,
+				firstName: actor.short_name || null,
+				vanity: actor.username || null,
+				thumbSrc: actor.big_image_src?.uri || null,
+				profileUrl: actor.url || null,
+				gender: actor.gender || null,
+				type: actor.__typename || null,
+				isFriend: actor.is_viewer_friend || false,
+				isMessengerUser: actor.is_messenger_user || false,
+				isMessageBlockedByViewer: actor.is_message_blocked_by_viewer || false,
+				workInfo: actor.work_info || null,
+				messengerStatus: actor.messenger_account_status_category || null
+			};
+		}
+		return retObj;
+	}
+	return function getUserInfoGraphQL(id, callback) {
+		let resolveFunc, rejectFunc;
+		const returnPromise = new Promise((resolve, reject) => {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+		if (typeof callback !== "function") {
+			callback = (err, data) => {
+				if (err) return rejectFunc(err);
+				resolveFunc(data);
+			};
+		}
+		const ids = Array.isArray(id) ? id : [id];
+		var form = {
+			queries: JSON.stringify({
+				o0: {
+					doc_id: "5009315269112105",
+					query_params: {
+						ids: ids
+					}
+				}
+			}),
+			batch_name: "MessengerParticipantsFetcher"
+		};
+		defaultFuncs
+			.post("https://www.facebook.com/api/graphqlbatch/", ctx.jar, form)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function(resData) {
+				if (!resData || resData.length === 0) {
+					throw new Error("Empty response from server");
+				}
+				if (resData.error) {
+					throw resData.error;
+				}
+				const response = resData[0];
+				if (!response || !response.o0) {
+					throw new Error("Invalid response format");
+				}
+				if (response.o0.errors && response.o0.errors.length > 0) {
+					throw new Error(response.o0.errors[0].message || "GraphQL error");
+				}
+				const result = response.o0.data;
+				if (!result || !result.messaging_actors || result.messaging_actors.length === 0) {
+					log.warn("getUserInfo", "No user data found for the provided ID(s)");
+					return callback(null, {});
+				}
+				const formattedData = formatData(result);
+				return callback(null, formattedData);
+			})
+			.catch(err => {
+				log.error("getUserInfoGraphQL", "Error: " + (err.message || "Unknown error occurred"));
+				callback(err);
+			});	
+		return returnPromise;
+	};
+};

package/src/handleFriendRequest.js

@@ -0,0 +1,61 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	return function handleFriendRequest(userID, accept, callback) {
+		if (utils.getType(accept) !== "Boolean") {
+			throw {
+				error: "Please pass a boolean as a second argument."
+			};
+		}
+
+		let resolveFunc = function () { };
+		let rejectFunc = function () { };
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+
+		if (!callback) {
+			callback = function (err, friendList) {
+				if (err) {
+					return rejectFunc(err);
+				}
+				resolveFunc(friendList);
+			};
+		}
+
+		const form = {
+			viewer_id: ctx.i_userID || ctx.userID,
+			"frefs[0]": "jwl",
+			floc: "friend_center_requests",
+			ref: "/reqs.php",
+			action: (accept ? "confirm" : "reject")
+		};
+
+		defaultFuncs
+			.post(
+				"https://www.facebook.com/requests/friends/ajax/",
+				ctx.jar,
+				form
+			)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData.payload.err) {
+					throw {
+						err: resData.payload.err
+					};
+				}
+
+				return callback();
+			})
+			.catch(function (err) {
+				log.error("handleFriendRequest", err);
+				return callback(err);
+			});
+
+		return returnPromise;
+	};
+};

package/src/handleMessageRequest.js

@@ -0,0 +1,65 @@
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+	return function handleMessageRequest(threadID, accept, callback) {
+		if (utils.getType(accept) !== "Boolean") {
+			throw {
+				error: "Please pass a boolean as a second argument."
+			};
+		}
+
+		let resolveFunc = function () { };
+		let rejectFunc = function () { };
+		const returnPromise = new Promise(function (resolve, reject) {
+			resolveFunc = resolve;
+			rejectFunc = reject;
+		});
+
+		if (!callback) {
+			callback = function (err, friendList) {
+				if (err) {
+					return rejectFunc(err);
+				}
+				resolveFunc(friendList);
+			};
+		}
+
+		const form = {
+			client: "mercury"
+		};
+
+		if (utils.getType(threadID) !== "Array") {
+			threadID = [threadID];
+		}
+
+		const messageBox = accept ? "inbox" : "other";
+
+		for (let i = 0; i < threadID.length; i++) {
+			form[messageBox + "[" + i + "]"] = threadID[i];
+		}
+
+		defaultFuncs
+			.post(
+				"https://www.facebook.com/ajax/mercury/move_thread.php",
+				ctx.jar,
+				form
+			)
+			.then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+			.then(function (resData) {
+				if (resData.error) {
+					throw resData;
+				}
+
+				return callback();
+			})
+			.catch(function (err) {
+				log.error("handleMessageRequest", err);
+				return callback(err);
+			});
+
+		return returnPromise;
+	};
+};