@lazyneoaz/testfca 1.0.0

package/src/apis/emoji.js

@@ -0,0 +1,124 @@
+"use strict";
+
+const utils = require('../utils');
+
+module.exports = function (defaultFuncs, api, ctx) {
+  /**
+   * Made by Choru Official
+   * 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/apis/fetchThemeData.js

@@ -0,0 +1,82 @@
+"use strict";
+
+const log = require("npmlog");
+const utils = require("../utils");
+
+module.exports = function (defaultFuncs, api, ctx) {
+  return function fetchThemeData(themeID, callback) {
+    let resolveFunc, rejectFunc;
+    const promise = new Promise((resolve, reject) => {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    const done = callback || function (err, data) {
+      if (err) return rejectFunc(err);
+      resolveFunc(data);
+    };
+
+    if (!themeID) {
+      done({ error: "Theme ID is a required parameter" });
+      return promise;
+    }
+
+    const payload = {
+      av: ctx.userID,
+      __user: ctx.userID,
+      __a: 1,
+      __req: utils.getSignatureID(),
+      fb_dtsg: ctx.fb_dtsg,
+      lsd: ctx.fb_dtsg,
+      jazoest: ctx.jazoest,
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "MWPThreadThemeProviderQuery",
+      variables: JSON.stringify({ id: themeID.toString() }),
+      server_timestamps: true,
+      doc_id: "9734829906576883"
+    };
+
+    defaultFuncs
+      .post("https://www.facebook.com/api/graphql/", ctx.jar, payload)
+      .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+      .then(async (res) => {
+        if (res.errors) throw res.errors;
+
+        const data = res?.data?.messenger_thread_theme;
+        if (!data) throw new Error("Theme data could not be located in the response");
+
+        const output = {
+          id: data.id,
+          name: data.accessibility_label,
+          description: data.description,
+          gradient_colors: data.gradient_colors || [data.fallback_color],
+          message_text_color: data.message_text_color || data.fallback_color,
+          title_bar_button_tint_color: data.title_bar_button_tint_color || data.fallback_color,
+          inbound_message_gradient_colors: data.inbound_message_gradient_colors || data.gradient_colors || [data.fallback_color],
+          composer_input_background_color: data.composer_input_background_color || data.fallback_color,
+          background_asset: data.background_asset || null,
+          alternative_themes: data.alternative_themes || [],
+          primary_color: data.gradient_colors?.[0] || data.fallback_color,
+          backgroundImage: data.background_asset?.image?.uri || null
+        };
+
+        // Fetch detailed data for the first alternative theme if available
+        if (output.alternative_themes.length > 0) {
+          try {
+            output.alternative_themes[0] = await api.fetchThemeData(output.alternative_themes[0]);
+          } catch (e) {
+            // If fetching fails, keep as ID
+            log.warn("fetchThemeData", `Failed to fetch alternative theme ${output.alternative_themes[0]}: ${e.message}`);
+          }
+        }
+
+        done(null, output);
+      })
+      .catch((err) => {
+        log.error("fetchThemeData", err);
+        done(err);
+      });
+
+    return promise;
+  };
+};

package/src/apis/follow.js

@@ -0,0 +1,81 @@
+"use strict";
+
+/**
+ * Author @YanMaglinte
+ * https://github.com/YANDEVA
+ * * Example:
+ * api.follow("100090794779367", true);
+ * jsdocs @ChoruOfficial
+ */
+ 
+/**
+ * @param {object} defaultFuncs The default functions for making API requests.
+ * @param {object} api The full API object.
+ * @param {object} ctx The context object.
+ * @returns {function(senderID: string, boolean: boolean, callback?: (err: any, data?: any) => void): void} The follow function.
+ */
+module.exports = function (defaultFuncs, api, ctx) {
+  /**
+   * Follows or unfollows a user on Facebook.
+   * @param {string} senderID The ID of the user to follow or unfollow.
+   * @param {boolean} boolean Set to `true` to follow the user, `false` to unfollow.
+   * @param {(err: any, data?: any) => void} [callback] An optional callback function.
+   */
+  return function follow(senderID, boolean, callback) {
+    let form;
+    if (boolean) {
+      form = {
+        av: ctx.userID,
+        fb_api_req_friendly_name: "CometUserFollowMutation",
+        fb_api_caller_class: "RelayModern",
+        doc_id: "25472099855769847",
+        variables: JSON.stringify({
+          input: {
+            attribution_id_v2:
+              "ProfileCometTimelineListViewRoot.react,comet.profile.timeline.list,via_cold_start,1717249218695,723451,250100865708545,,",
+            is_tracking_encrypted: true,
+            subscribe_location: "PROFILE",
+            subscribee_id: senderID,
+            tracking: null,
+            actor_id: ctx.userID,
+            client_mutation_id: "1",
+          },
+          scale: 1,
+        }),
+      };
+    } else {
+      form = {
+        av: ctx.userID,
+        fb_api_req_friendly_name: "CometUserUnfollowMutation",
+        fb_api_caller_class: "RelayModern",
+        doc_id: "25472099855769847",
+        variables: JSON.stringify({
+          action_render_location: "WWW_COMET_FRIEND_MENU",
+          input: {
+            attribution_id_v2:
+              "ProfileCometTimelineListViewRoot.react,comet.profile.timeline.list,tap_search_bar,1717294006136,602597,250100865708545,,",
+            is_tracking_encrypted: true,
+            subscribe_location: "PROFILE",
+            tracking: null,
+            unsubscribee_id: senderID,
+            actor_id: ctx.userID,
+            client_mutation_id: "10",
+          },
+          scale: 1,
+        }),
+      };
+    }
+
+    api.httpPost("https://www.facebook.com/api/graphql/", form, (err, data) => {
+      if (err) {
+        if (typeof callback === "function") {
+          callback(err);
+        }
+      } else {
+        if (typeof callback === "function") {
+          callback(null, data);
+        }
+      }
+    });
+  };
+};

package/src/apis/forwardMessage.js

@@ -0,0 +1,52 @@
+"use strict";
+
+const utils = require('../utils');
+
+module.exports = (defaultFuncs, api, ctx) => {
+  return async function forwardMessage(messageID, threadIDs, callback) {
+    let resolveFunc = () => {};
+    let rejectFunc = () => {};
+    const returnPromise = new Promise((resolve, reject) => {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!callback) {
+      callback = (err, result) => {
+        if (err) return rejectFunc(err);
+        resolveFunc(result);
+      };
+    }
+
+    try {
+      if (!Array.isArray(threadIDs)) {
+        threadIDs = [threadIDs];
+      }
+
+      const form = {
+        message_id: messageID
+      };
+      
+      threadIDs.forEach(id => {
+        form[`recipient_ids[${id}]`] = id;
+      });
+
+      const res = await defaultFuncs.post(
+        "https://www.facebook.com/ajax/mercury/forward_message.php",
+        ctx.jar,
+        form
+      ).then(utils.parseAndCheckLogin(ctx, defaultFuncs));
+
+      if (res && res.error) {
+        throw res;
+      }
+
+      callback(null, { success: true, forwardedTo: threadIDs });
+    } catch (err) {
+      utils.error("forwardMessage", err);
+      callback(err);
+    }
+
+    return returnPromise;
+  };
+};

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