shadowx-fca 2.4.0 → 2.6.0

package/src/emoji.js

@@ -0,0 +1,124 @@
+"use strict";
+
+const utils = require('../utils');
+
+module.exports = function (defaultFuncs, api, ctx) {
+  /**
+   * Author: S4hiilAns4ri (github.com/S4hiilAns4ri)
+   * Mqtt
+   * Sets the custom emoji for a specific Facebook thread via MQTT.
+   *
+   * @param {string} emoji The emoji character to set as the custom emoji (e.g., "👍", "❤️").
+   * @param {string} threadID The ID of the thread where the emoji will be set.
+   * @param {Function} [callback] Optional callback function to be invoked upon completion.
+   * @param {string} [initiatorID] The ID of the user who initiated the emoji 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 emoji(emoji, 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 set an emoji."));
+    }
+    if (!emoji) {
+      return _callback(new Error("An emoji character is required."));
+    }
+
+    if (!ctx.mqttClient) {
+      return _callback(new Error("Not connected to MQTT"));
+    }
+
+    ctx.wsReqNumber += 1;
+    ctx.wsTaskNumber += 1;
+
+    const queryPayload = {
+      thread_key: threadID.toString(),
+      custom_emoji: emoji,
+      avatar_sticker_instruction_key_id: null,
+      sync_group: 1,
+    };
+
+    const query = {
+      failure_count: null,
+      label: '100003',
+      payload: JSON.stringify(queryPayload),
+      queue_name: 'thread_quick_reaction',
+      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 emoji: ${err.message || err}`));
+      }
+      
+      const emojiChangeEvent = {
+        type: "thread_emoji_update",
+        threadID: threadID,
+        newEmoji: emoji,
+        senderID: _initiatorID,
+        BotID: ctx.userID,
+        timestamp: Date.now(),
+      };
+      _callback(null, emojiChangeEvent);
+    });
+
+    return returnPromise;
+  };
+};

package/src/friend.js

@@ -0,0 +1,243 @@
+"use strict";
+
+const utils = require('../utils');
+
+/**
+ * S4hiilAns4ri
+ * @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 S4hiilAns4ri
+     */
+
+    /**
+     * 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/gcmember.js

@@ -0,0 +1,122 @@
+"use strict";
+
+const utils = require('../utils');
+
+module.exports = function (defaultFuncs, api, ctx) {
+  /**
+   * Author: S4hiilAns4ri (github.com/S4hiilAns4ri) 
+   * 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() : "";
+
+        // --- ERROR CHECKS NOW RETURN AN OBJECT INSTEAD OF THROWING ---
+        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); // For network errors, we still reject
+          
+          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/listenMqtt.js

@@ -114,11 +114,11 @@ function listenMqtt(defaultFuncs, api, ctx, globalCallback) {
 
         // Display connection success message with branding and loading animation
         const messages = [
-            '\n SHADOWX-FCA MQTT Connected',
-            ` Region: ${ctx.region || 'PNB'}`,
+            '\n🖤 SHADOWX-FCA MQTT Connected',
+            `🔰 Region: ${ctx.region || 'PNB'}`,
             `🔄 Auto-reconnect: ${ctx.globalOptions.autoReconnect ? 'Enabled' : 'Disabled'}${ctx.globalOptions.autoReconnect ? ' (reconnects every 3s on disconnect)' : ''}`,
-            `⏱️  MQTT Restart Interval: ${ctx.globalOptions.restartListenMqtt?.enable ? `${ctx.globalOptions.restartListenMqtt.timeRestart / 1000}s` : 'Disabled'}`,
-            'Author: Mueid Mursalin Rifat\n'
+            `🧬 MQTT Restart Interval: ${(ctx.globalOptions.restartListenMqtt && ctx.globalOptions.restartListenMqtt.enable) ? `${ctx.globalOptions.restartListenMqtt.timeRestart / 1000}s` : 'Disabled'}`,
+            '🔖Author: Mueid Mursalin Rifat\n'
         ];
 
         let index = 0;

package/src/nickname.js

@@ -0,0 +1,140 @@
+"use strict";
+
+const utils = require('../utils');
+const log = require('npmlog');
+
+module.exports = function (defaultFuncs, api, ctx) { 
+  /**
+   * Author: S4hiilAns4ri (github.com/S4hiilAns4ri) 
+   * Mqtt
+   * Sets a nickname for a participant in a Facebook thread via MQTT.
+   *
+   * @param {string} nickname The new nickname to set.
+   * @param {string} threadID The ID of the thread.
+   * @param {string} participantID The ID of the participant whose nickname will be changed. Defaults to the current user's ID if not provided.
+   * @param {Function} [callback] Optional callback function to be invoked upon completion.
+   * @returns {Promise<object>} A promise that resolves with a structured event object on success or rejects on error.
+   */
+  return function setNickname(nickname, threadID, participantID, callback) {
+    let _callback;
+    let _resolvePromise;
+    let _rejectPromise;
+    
+    const returnPromise = new Promise((resolve, reject) => {
+        _resolvePromise = resolve;
+        _rejectPromise = reject;
+    });
+
+    // Handle parameter shifting
+    if (typeof threadID === 'function') {
+        callback = threadID;
+        threadID = null;
+        participantID = null;
+    } else if (typeof participantID === 'function') {
+        callback = participantID;
+        participantID = null;
+    }
+
+    // Set defaults
+    threadID = threadID || ctx.threadID;
+    participantID = participantID || ctx.userID;
+
+    // Setup callback
+    if (typeof callback === 'function') {
+        _callback = (err, data) => {
+            if (err) {
+                callback(err);
+                _rejectPromise(err);
+            } else {
+                callback(null, data);
+                _resolvePromise(data);
+            }
+        };
+    } else {
+        _callback = (err, data) => {
+            if (err) _rejectPromise(err);
+            else _resolvePromise(data);
+        };
+    }
+
+    // Validation
+    if (!threadID) {
+        const error = new Error("threadID is required to set a nickname.");
+        log.error("setNickname", error);
+        return _callback(error);
+    }
+    
+    if (typeof nickname !== 'string' || !nickname.trim()) {
+        const error = new Error("nickname must be a non-empty string.");
+        log.error("setNickname", error);
+        return _callback(error);
+    }
+
+    if (!ctx.mqttClient) {
+        const error = new Error("Not connected to MQTT. Make sure listenMqtt is called first.");
+        log.error("setNickname", error);
+        return _callback(error);
+    }
+
+    // Check if appID exists
+    if (!ctx.appID) {
+        log.warn("setNickname", "ctx.appID not found, using default");
+        ctx.appID = "2220391788200892";
+    }
+
+    ctx.wsReqNumber = (ctx.wsReqNumber || 0) + 1;
+    ctx.wsTaskNumber = (ctx.wsTaskNumber || 0) + 1;
+
+    const queryPayload = {
+        thread_key: String(threadID),
+        contact_id: String(participantID),
+        nickname: nickname,
+        sync_group: 1
+    };
+
+    const query = {
+        failure_count: null,
+        label: '44',
+        payload: JSON.stringify(queryPayload),
+        queue_name: String(threadID),
+        task_id: ctx.wsTaskNumber
+    };
+
+    const context = {
+        app_id: ctx.appID,
+        payload: {
+            epoch_id: parseInt(utils.generateOfflineThreadingID()) || Date.now(),
+            tasks: [query],
+            version_id: '24631415369801570'
+        },
+        request_id: ctx.wsReqNumber,
+        type: 3
+    };
+    
+    const payloadString = JSON.stringify(context.payload);
+    context.payload = payloadString;
+    
+    log.info("setNickname", `Setting nickname "${nickname}" for ${participantID} in thread ${threadID}`);
+    
+    ctx.mqttClient.publish('/ls_req', JSON.stringify(context), { qos: 1, retain: false }, (err) => {
+        if (err) {
+            log.error("setNickname", `MQTT publish failed: ${err.message || err}`);
+            return _callback(new Error(`MQTT publish failed: ${err.message || err}`));
+        }
+        
+        const nicknameChangeEvent = {
+            type: "thread_nickname_update",
+            threadID: String(threadID),
+            participantID: String(participantID),
+            newNickname: nickname,
+            author: ctx.userID,
+            timestamp: Date.now()
+        };
+        
+        log.info("setNickname", `Nickname set successfully`);
+        _callback(null, nicknameChangeEvent);
+    });
+
+    return returnPromise;
+  };
+};