fca-neokex-fix 1.0.1

package/src/apis/friend.js

@@ -0,0 +1,243 @@
+"use strict";
+
+const utils = require('../utils');
+
+/**
+ * @ChoruOfficial
+ * @description A module for managing friend-related actions like listing friends, handling requests, and getting suggestions.
+ * @param {Object} defaultFuncs The default functions provided by the API wrapper.
+ * @param {Object} api The full API object.
+ * @param {Object} ctx The context object containing the user's session state (e.g., userID, jar, fb_dtsg).
+ * @returns {Object} A `friendModule` object with methods for friend interactions.
+ */
+module.exports = function (defaultFuncs, api, ctx) {
+
+  /**
+   * A private helper function to standardize friend data from various GraphQL endpoints.
+   * @private
+   * @param {Object} data The raw data object from a GraphQL response.
+   * @param {('requests'|'suggestions'|'list')} type The type of data to format, which determines the path to the user list.
+   * @returns {Array<Object>} An array of formatted friend objects, each containing `userID`, `name`, `profilePicture`, `socialContext`, and `url`.
+   */
+  function formatFriends(data, type) {
+    const viewer = data?.data?.viewer;
+    let edges;
+    if (type === 'requests' && viewer?.friend_requests?.edges) {
+        edges = viewer.friend_requests.edges;
+    } else if (type === 'suggestions' && viewer?.people_you_may_know?.edges) {
+        edges = viewer.people_you_may_know.edges;
+    } else if (type === 'list' && data?.data?.node?.all_collections?.nodes[0]?.style_renderer?.collection?.pageItems?.edges) {
+        edges = data.data.node.all_collections.nodes[0].style_renderer.collection.pageItems.edges;
+    } else {
+        return [];
+    }
+    return edges.map(edge => {
+        const node = edge.node;
+        return {
+            userID: node.id || node.node?.id,
+            name: node.name || node.title?.text,
+            profilePicture: node.profile_picture?.uri || node.image?.uri,
+            socialContext: node.social_context?.text || node.subtitle_text?.text,
+            url: node.url
+        };
+    });
+  }
+
+  const friendModule = {
+    /**
+     * @namespace api.friend
+     * @description A collection of functions for interacting with friends.
+     * @license Ex-it
+     * @author ChoruOfficial
+     */
+
+    /**
+     * Fetches the list of incoming friend requests.
+     * @async
+     * @returns {Promise<Array<Object>>} A promise that resolves to an array of friend request objects.
+     * @throws {Error} If the API request fails or returns an error.
+     */
+    requests: async function() {
+      try {
+        const form = {
+          av: ctx.userID,
+          __user: ctx.userID,
+          __a: "1",
+          fb_dtsg: ctx.fb_dtsg,
+          jazoest: ctx.jazoest,
+          lsd: ctx.lsd,
+          fb_api_caller_class: "RelayModern",
+          fb_api_req_friendly_name: "FriendingCometRootContentQuery",
+          variables: JSON.stringify({ scale: 3 }),
+          doc_id: "9103543533085580"
+        };
+        const res = await defaultFuncs.post("https://www.facebook.com/api/graphql/", ctx.jar, form, {});
+        if (res.data.errors) throw new Error(JSON.stringify(res.data.errors));
+        return formatFriends(res.data, 'requests');
+      } catch (err) {
+        throw err;
+      }
+    },
+
+    /**
+     * Accepts a friend request.
+     * @async
+     * @param {string} identifier The user ID or name of the person whose friend request is to be accepted. If a name is provided, the function will search through pending requests.
+     * @returns {Promise<Object>} A promise that resolves to the API response data upon successful acceptance.
+     * @throws {Error} If the identifier is missing, the user is not found in requests, or the API call fails.
+     */
+    accept: async function(identifier) {
+      try {
+          if (!identifier) throw new Error("A name or user ID is required.");
+          let targetUserID = identifier;
+          if (isNaN(identifier)) {
+              const requests = await friendModule.requests();
+              const found = requests.find(req => req.name.toLowerCase().includes(identifier.toLowerCase()));
+              if (!found) throw new Error(`Could not find any friend request matching "${identifier}".`);
+              targetUserID = found.userID;
+          }
+          const variables = {
+              input: {
+                  friend_requester_id: targetUserID,
+                  friending_channel: "FRIENDS_HOME_MAIN",
+                  actor_id: ctx.userID,
+                  client_mutation_id: Math.floor(Math.random() * 10 + 1).toString()
+              },
+              scale: 3
+          };
+          const form = {
+              av: ctx.userID,
+              __user: ctx.userID,
+              __a: "1",
+              fb_dtsg: ctx.fb_dtsg,
+              jazoest: ctx.jazoest,
+              lsd: ctx.lsd,
+              fb_api_caller_class: "RelayModern",
+              fb_api_req_friendly_name: "FriendingCometFriendRequestConfirmMutation",
+              variables: JSON.stringify(variables),
+              doc_id: "24630768433181357"
+          };
+          const res = await defaultFuncs.post("https://www.facebook.com/api/graphql/", ctx.jar, form, {});
+          if (res.data.errors) throw new Error(JSON.stringify(res.data.errors));
+          return res.data.data;
+      } catch (err) {
+          if (err.message?.includes("1431004")) {
+              throw new Error("I cannot accept this friend request right now. There might be a problem with the account or you need to wait.");
+          }
+          throw err;
+      }
+    },
+
+    /**
+     * Fetches the friend list for a given user ID.
+     * @async
+     * @param {string} [userID=ctx.userID] The ID of the user whose friend list to fetch. Defaults to the logged-in user.
+     * @returns {Promise<Array<Object>>} A promise that resolves to an array of formatted friend objects.
+     * @throws {Error} If the API request fails.
+     */
+    list: async function(userID = ctx.userID) {
+        try {
+            const sectionToken = Buffer.from(`app_section:${userID}:2356318349`).toString('base64');
+            const variables = {
+                collectionToken: null,
+                scale: 2,
+                sectionToken: sectionToken,
+                useDefaultActor: false,
+                userID: userID
+            };
+            const form = {
+                av: ctx.userID,
+                __user: ctx.userID,
+                __a: "1",
+                fb_dtsg: ctx.fb_dtsg,
+                jazoest: ctx.jazoest,
+                lsd: ctx.lsd,
+                fb_api_caller_class: "RelayModern",
+                fb_api_req_friendly_name: "ProfileCometTopAppSectionQuery",
+                variables: JSON.stringify(variables),
+                doc_id: "24492266383698794"
+            };
+            const res = await defaultFuncs.post("https://www.facebook.com/api/graphql/", ctx.jar, form, {});
+            if (res.data.errors) throw new Error(JSON.stringify(res.data.errors));
+            return formatFriends(res.data, 'list');
+        } catch(err) {
+            throw err;
+        }
+    },
+
+    /**
+     * @namespace api.friend.suggest
+     * @description Functions for managing friend suggestions.
+     */
+    suggest: {
+        /**
+         * Fetches a list of suggested friends (People You May Know).
+         * @async
+         * @param {number} [limit=30] The maximum number of suggestions to fetch.
+         * @returns {Promise<Array<Object>>} A promise that resolves to an array of suggested friend objects.
+         * @throws {Error} If the API request fails.
+         */
+        list: async function(limit = 30) {
+          try {
+              const form = {
+                  av: ctx.userID,
+                  __user: ctx.userID,
+                  __a: "1",
+                  fb_dtsg: ctx.fb_dtsg,
+                  jazoest: ctx.jazoest,
+                  lsd: ctx.lsd,
+                  fb_api_caller_class: "RelayModern",
+                  fb_api_req_friendly_name: "FriendingCometPYMKPanelPaginationQuery",
+                  variables: JSON.stringify({ count: limit, cursor: null, scale: 3 }),
+                  doc_id: "9917809191634193"
+              };
+              const res = await defaultFuncs.post("https://www.facebook.com/api/graphql/", ctx.jar, form, {});
+              if (res.data.errors) throw new Error(JSON.stringify(res.data.errors));
+              return formatFriends(res.data, 'suggestions');
+          } catch(err) {
+              throw err;
+          }
+        },
+        /**
+         * Sends a friend request to a user.
+         * @async
+         * @param {string} userID The ID of the user to send the friend request to.
+         * @returns {Promise<Object>} A promise that resolves to the API response data on success.
+         * @throws {Error} If the userID is missing or the API request fails.
+         */
+        request: async function(userID) {
+            try {
+                if (!userID) throw new Error("userID is required.");
+                const variables = {
+                    input: {
+                        friend_requestee_ids: [userID],
+                        friending_channel: "FRIENDS_HOME_MAIN",
+                        actor_id: ctx.userID,
+                        client_mutation_id: Math.floor(Math.random() * 10 + 1).toString()
+                    },
+                    scale: 3
+                };
+                const form = {
+                    av: ctx.userID,
+                    __user: ctx.userID,
+                    __a: "1",
+                    fb_dtsg: ctx.fb_dtsg,
+                    jazoest: ctx.jazoest,
+                    lsd: ctx.lsd,
+                    fb_api_caller_class: "RelayModern",
+                    fb_api_req_friendly_name: "FriendingCometFriendRequestSendMutation",
+                    variables: JSON.stringify(variables),
+                    doc_id: "23982103144788355"
+                };
+                const res = await defaultFuncs.post("https://www.facebook.com/api/graphql/", ctx.jar, form, {});
+                if (res.data.errors) throw new Error(JSON.stringify(res.data.errors));
+                return res.data.data;
+            } catch(err) {
+                throw err;
+            }
+        }
+    }
+  };
+  
+  return friendModule;
+};

package/src/apis/gcmember.js

@@ -0,0 +1,122 @@
+"use strict";
+
+const utils = require('../utils');
+
+module.exports = function (defaultFuncs, api, ctx) {
+  /**
+   * Made by ChoruOfficial 
+   * Mqtt
+   * Adds or removes members from a group chat with pre-checking.
+   *
+   * @param {"add" | "remove"} action The action to perform.
+   * @param {string|string[]} userIDs The user ID or array of user IDs.
+   * @param {string} threadID The ID of the group chat.
+   * @param {Function} [callback] Optional callback function.
+   * @returns {Promise<object>} A promise that resolves with information about the action.
+   */
+  return async function gcmember(action, userIDs, threadID, callback) {
+    let _callback;
+    if (typeof threadID === 'function') {
+        _callback = threadID;
+        threadID = null;
+    } else if (typeof callback === 'function') {
+        _callback = callback;
+    }
+    
+    let resolvePromise, rejectPromise;
+    const returnPromise = new Promise((resolve, reject) => {
+        resolvePromise = resolve;
+        rejectPromise = reject;
+    });
+
+    if (typeof _callback != "function") {
+      _callback = (err, data) => {
+        // Note: We will now rarely use the 'err' parameter for validation errors
+        if (err) return rejectPromise(err);
+        resolvePromise(data);
+      }
+    }
+
+    try {
+        const validActions = ["add", "remove"];
+        action = action ? action.toLowerCase() : "";
+
+
+        if (!validActions.includes(action)) {
+            return _callback(null, { type: "error_gc", error: `Invalid action. Must be one of: ${validActions.join(", ")}` });
+        }
+        if (!userIDs || userIDs.length === 0) {
+            return _callback(null, { type: "error_gc", error: "userIDs is required." });
+        }
+        if (!threadID) {
+            return _callback(null, { type: "error_gc", error: "threadID is required." });
+        }
+        if (!ctx.mqttClient) {
+            return _callback(null, { type: "error_gc", error: "Not connected to MQTT" });
+        }
+
+        const threadInfo = await api.getThreadInfo(threadID);
+        if (!threadInfo) {
+            return _callback(null, { type: "error_gc", error: "Could not retrieve thread information." });
+        }
+        if (threadInfo.isGroup === false) {
+            return _callback(null, { type: "error_gc", error: "This feature is only for group chats, not private messages." });
+        }
+        
+        const currentMembers = threadInfo.participantIDs;
+        const usersToModify = Array.isArray(userIDs) ? userIDs : [userIDs];
+        let queryPayload, query;
+        let finalUsers = usersToModify;
+        
+        ctx.wsReqNumber = (ctx.wsReqNumber || 0) + 1;
+        ctx.wsTaskNumber = (ctx.wsTaskNumber || 0) + 1;
+
+        if (action === 'add') {
+            const usersToAdd = usersToModify.filter(id => !currentMembers.includes(id));
+            if (usersToAdd.length === 0) {
+                return _callback(null, { type: "error_gc", error: "All specified users are already in the group." });
+            }
+            finalUsers = usersToAdd;
+            queryPayload = { thread_key: parseInt(threadID), contact_ids: finalUsers.map(id => parseInt(id)), sync_group: 1 };
+            query = { label: "23", payload: JSON.stringify(queryPayload), queue_name: threadID, task_id: ctx.wsTaskNumber };
+        
+        } else { // action is 'remove'
+            const userToRemove = usersToModify[0];
+            if (!currentMembers.includes(userToRemove)) {
+                return _callback(null, { type: "error_gc", error: `User with ID ${userToRemove} is not in this group chat.` });
+            }
+            finalUsers = [userToRemove];
+            queryPayload = { thread_id: threadID, contact_id: userToRemove, sync_group: 1 };
+            query = { label: "140", payload: JSON.stringify(queryPayload), queue_name: "remove_participant_v2", task_id: ctx.wsTaskNumber };
+        }
+
+        const context = {
+          app_id: ctx.appID,
+          payload: { epoch_id: parseInt(utils.generateOfflineThreadingID()), tasks: [query], version_id: "24631415369801570" },
+          request_id: ctx.wsReqNumber,
+          type: 3
+        };
+        context.payload = JSON.stringify(context.payload);
+
+        ctx.mqttClient.publish('/ls_req', JSON.stringify(context), { qos: 1, retain: false }, (err) => {
+          if (err) return _callback(err);
+          
+          const gcmemberInfo = {
+            type: "gc_member_update",
+            threadID: threadID,
+            userIDs: finalUsers,
+            action: action,
+            senderID: ctx.userID,
+            BotID: ctx.userID,
+            timestamp: Date.now(),
+          };
+          return _callback(null, gcmemberInfo);
+        });
+    } catch (err) {
+      
+        return _callback(null, { type: "error_gc", error: err.message || "An unknown error occurred." });
+    }
+
+    return returnPromise;
+  };
+};

package/src/apis/gcname.js

@@ -0,0 +1,123 @@
+"use strict";
+
+const utils = require('../utils');
+
+module.exports = function (defaultFuncs, api, ctx) {
+  /**
+   * Made by Choru Official
+   * Mqtt
+   * Sets the name of a group chat thread via MQTT.
+   *
+   * @param {string} newName The new name for the group chat.
+   * @param {string} threadID The ID of the group chat thread.
+   * @param {Function} [callback] Optional callback function to be invoked upon completion.
+   * @param {string} [initiatorID] The ID of the user who initiated the group name change (e.g., from event.senderID).
+   * @returns {Promise<object>} A promise that resolves with a structured event object on success or rejects on error.
+   */
+  return function gcname(newName, threadID, callback, initiatorID) {
+    let _callback;
+    let _initiatorID;
+
+    let _resolvePromise;
+    let _rejectPromise;
+    const returnPromise = new Promise((resolve, reject) => {
+        _resolvePromise = resolve;
+        _rejectPromise = reject;
+    });
+
+    if (utils.getType(callback) === "Function" || utils.getType(callback) === "AsyncFunction") {
+        _callback = callback;
+        _initiatorID = initiatorID;
+    } else if (utils.getType(threadID) === "Function" || utils.getType(threadID) === "AsyncFunction") {
+        _callback = threadID;
+        threadID = null;
+        _initiatorID = callback;
+    } else if (utils.getType(callback) === "string") {
+        _initiatorID = callback;
+        _callback = undefined;
+    } else {
+        _callback = undefined;
+        _initiatorID = undefined;
+    }
+
+    if (!_callback) {
+      _callback = function (__err, __data) {
+        if (__err) _rejectPromise(__err);
+        else _resolvePromise(__data);
+      };
+    } else {
+      const originalCallback = _callback;
+      _callback = function(__err, __data) {
+        if (__err) {
+          originalCallback(__err);
+          _rejectPromise(__err);
+        } else {
+          originalCallback(null, __data);
+          _resolvePromise(__data);
+        }
+      };
+    }
+
+    _initiatorID = _initiatorID || ctx.userID;
+
+    threadID = threadID || ctx.threadID;
+
+    if (!threadID) {
+      return _callback(new Error("threadID is required to change the group chat name."));
+    }
+    if (typeof newName !== 'string') {
+      return _callback(new Error("newName must be a string."));
+    }
+
+    if (!ctx.mqttClient) {
+      return _callback(new Error("Not connected to MQTT"));
+    }
+
+    ctx.wsReqNumber += 1;
+    ctx.wsTaskNumber += 1;
+
+    const queryPayload = {
+      thread_key: threadID.toString(),
+      thread_name: newName,
+      sync_group: 1,
+    };
+
+    const query = {
+      failure_count: null,
+      label: '32',
+      payload: JSON.stringify(queryPayload),
+      queue_name: threadID.toString(),
+      task_id: ctx.wsTaskNumber,
+    };
+
+    const context = {
+      app_id: ctx.appID,
+      payload: {
+        epoch_id: parseInt(utils.generateOfflineThreadingID()),
+        tasks: [query],
+        version_id: '24631415369801570',
+      },
+      request_id: ctx.wsReqNumber,
+      type: 3,
+    };
+    context.payload = JSON.stringify(context.payload);
+
+    ctx.mqttClient.publish('/ls_req', JSON.stringify(context), { qos: 1, retain: false }, (err) => {
+      if (err) {
+        return _callback(new Error(`MQTT publish failed for gcname: ${err.message || err}`));
+      }
+      
+      const gcnameChangeEvent = {
+        type: "thread_name_update",
+        threadID: threadID,
+        newName: newName,
+        senderID: _initiatorID,
+        BotID: ctx.userID,
+        timestamp: Date.now(),
+      };
+      _callback(null, gcnameChangeEvent);
+    });
+
+    return returnPromise;
+  };
+};

package/src/apis/gcrule.js

@@ -0,0 +1,119 @@
+"use strict";
+
+const utils = require('../utils');
+
+module.exports = function (defaultFuncs, api, ctx) {
+  /**
+   * Made by ChoruOfficial 
+   * Mqtt
+   * Adds or removes an admin from a group chat with pre-checking.
+   *
+   * @param {"admin" | "unadmin"} action The action to perform.
+   * @param {string} userID The ID of the user to promote or demote.
+   * @param {string} threadID The ID of the group chat.
+   * @param {Function} [callback] Optional callback function.
+   * @returns {Promise<object>} A promise that resolves with information about the action.
+   */
+  return async function gcrule(action, userID, threadID, callback) {
+    let _callback;
+    if (typeof threadID === 'function') {
+        _callback = threadID;
+        threadID = null;
+    } else if (typeof callback === 'function') {
+        _callback = callback;
+    }
+    
+    let resolvePromise, rejectPromise;
+    const returnPromise = new Promise((resolve, reject) => {
+        resolvePromise = resolve;
+        rejectPromise = reject;
+    });
+
+    if (typeof _callback != "function") {
+      _callback = (err, data) => {
+        if (err) return rejectPromise(err);
+        resolvePromise(data);
+      }
+    }
+
+    try {
+        const validActions = ["admin", "unadmin"];
+        action = action ? action.toLowerCase() : "";
+
+        if (!validActions.includes(action)) {
+            return _callback(null, { type: "error_gc_rule", error: `Invalid action. Must be one of: ${validActions.join(", ")}` });
+        }
+        if (!userID) return _callback(null, { type: "error_gc_rule", error: "userID is required." });
+        if (!threadID) return _callback(null, { type: "error_gc_rule", error: "threadID is required." });
+        if (!ctx.mqttClient) return _callback(null, { type: "error_gc_rule", error: "Not connected to MQTT" });
+        
+        const threadInfo = await api.getThreadInfo(threadID);
+        if (!threadInfo) {
+            return _callback(null, { type: "error_gc_rule", error: "Could not retrieve thread information." });
+        }
+        if (threadInfo.isGroup === false) {
+            return _callback(null, { type: "error_gc_rule", error: "This feature is only for group chats." });
+        }
+
+        const adminIDs = threadInfo.adminIDs || [];
+        const isCurrentlyAdmin = adminIDs.some(admin => admin.id === userID);
+
+        if (action === 'admin') {
+            if (isCurrentlyAdmin) {
+                return _callback(null, { type: "error_gc_rule", error: `User is already an admin.` });
+            }
+        } else { // action is 'unadmin'
+            if (!isCurrentlyAdmin) {
+                return _callback(null, { type: "error_gc_rule", error: `User is not an admin.` });
+            }
+        }
+
+        const isAdminStatus = action === 'admin' ? 1 : 0;
+        ctx.wsReqNumber = (ctx.wsReqNumber || 0) + 1;
+        ctx.wsTaskNumber = (ctx.wsTaskNumber || 0) + 1;
+
+        const queryPayload = {
+            thread_key: parseInt(threadID),
+            contact_id: parseInt(userID),
+            is_admin: isAdminStatus
+        };
+        const query = {
+            failure_count: null,
+            label: "25",
+            payload: JSON.stringify(queryPayload),
+            queue_name: "admin_status",
+            task_id: ctx.wsTaskNumber
+        };
+        const context = {
+            app_id: ctx.appID,
+            payload: {
+                epoch_id: parseInt(utils.generateOfflineThreadingID()),
+                tasks: [query],
+                version_id: "24631415369801570"
+            },
+            request_id: ctx.wsReqNumber,
+            type: 3
+        };
+        context.payload = JSON.stringify(context.payload);
+
+        ctx.mqttClient.publish('/ls_req', JSON.stringify(context), { qos: 1, retain: false }, (err) => {
+            if (err) return _callback(err);
+            const gcruleInfo = {
+                type: "gc_rule_update",
+                threadID: threadID,
+                userID: userID,
+                action: action,
+                senderID: ctx.userID,
+                BotID: ctx.userID,
+                timestamp: Date.now(),
+            };
+            return _callback(null, gcruleInfo);
+        });
+
+    } catch (err) {
+        return _callback(null, { type: "error_gc_rule", error: err.message || "An unknown error occurred." });
+    }
+    
+    return returnPromise;
+  };
+};