stfca 1.0.11 → 1.0.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stfca",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "Unofficial Facebook Chat API for Node.js with Auto-Update System - Enhanced by ST | Sheikh Tamim",
   "main": "index.js",
   "files": [

package/src/getThreadTheme.js

@@ -0,0 +1,82 @@
+/**
+ * ===========================================================
+ * 🧑‍💻 Author: Sheikh Tamim (ST | Sheikh Tamim)
+ * 🔰 Owner & Developer
+ * 🌐 GitHub: https://github.com/sheikhtamimlover
+ * 📸 Instagram: https://instagram.com/sheikh.tamim_lover
+ * -----------------------------------------------------------
+ * 🕊️ Respect the creator & give proper credits if reused.
+ * ===========================================================
+ */
+"use strict";
+
+const utils = require("../utils");
+const log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+    /** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Instagram: @sheikh.tamim_lover */
+  return function getThreadTheme(themeID, callback) {
+    let resolveFunc, rejectFunc;
+    const returnPromise = new Promise((resolve, reject) => {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!callback) {
+      callback = function (err, data) {
+        if (err) return rejectFunc(err);
+        resolveFunc(data);
+      };
+    }
+
+    if (!themeID) {
+      return callback({ error: "themeID is required" });
+    }
+
+    const form = {
+      av: ctx.userID,
+      __user: ctx.userID,
+      __a: 1,
+      __req: utils.getSignatureID(),
+      fb_dtsg: ctx.fb_dtsg,
+      jazoest: ctx.ttstamp,
+      lsd: ctx.fb_dtsg,
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "MWPThreadThemeProviderQuery",
+      variables: JSON.stringify({
+        id: themeID.toString() // <-- THEME ID instead of threadID
+      }),
+      server_timestamps: true,
+      doc_id: "9734829906576883"
+    };
+
+    defaultFuncs
+      .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+      .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+      .then(function (resData) {
+        if (resData.errors) throw resData.errors;
+
+        if (resData.data && resData.data.messenger_thread_theme) {
+          const themeData = resData.data.messenger_thread_theme;
+          return callback(null, {
+            id: themeData.id,
+            name: themeData.accessibility_label,
+            description: themeData.description,
+            colors: themeData.gradient_colors || [themeData.fallback_color],
+            backgroundImage: themeData.background_asset
+              ? themeData.background_asset.image.uri
+              : null
+          });
+        } else {
+          throw new Error("No theme data found");
+        }
+      })
+      .catch(function (err) {
+        log.error("getThreadTheme", err);
+        return callback(err);
+      });
+
+    return returnPromise;
+  };
+};
+/** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Please give credits if reused. */

package/src/searchFriends.js

@@ -0,0 +1,139 @@
+/**
+ * ===========================================================
+ * 🧑‍💻 Author: Sheikh Tamim (ST | Sheikh Tamim)
+ * 🔰 Owner & Developer
+ * 🌐 GitHub: https://github.com/sheikhtamimlover
+ * 📸 Instagram: https://instagram.com/sheikh.tamim_lover
+ * -----------------------------------------------------------
+ * 🕊️ Respect the creator & give proper credits if reused.
+ * ===========================================================
+ */
+"use strict";
+
+const utils = require("../utils");
+
+module.exports = function (defaultFuncs, api, ctx) {
+/** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Instagram: @sheikh.tamim_lover */
+  return function searchFriends(searchQuery, callback) {
+    let resolveFunc = function () {};
+    let rejectFunc = function () {};
+    const returnPromise = new Promise(function (resolve, reject) {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!callback) {
+      callback = function (err, result) {
+        if (err) {
+          return rejectFunc(err);
+        }
+        resolveFunc(result);
+      };
+    }
+
+    if (!searchQuery || searchQuery.trim().length === 0) {
+      return callback(new Error("Search query cannot be empty"));
+    }
+
+    // Enhanced form data based on captured API
+    const form = {
+      av: ctx.userID,
+      __aaid: 0,
+      __user: ctx.userID,
+      __a: 1,
+      __req: utils.getSignatureID(),
+      __hs: "20358.HYP:comet_pkg.2.1...0",
+      dpr: 1,
+      __ccg: "EXCELLENT",
+      __rev: "1027694919",
+      __s: utils.getSignatureID(),
+      __hsi: "7554748243252799467",
+      __comet_req: 15,
+      fb_dtsg: ctx.fb_dtsg,
+      jazoest: ctx.ttstamp,
+      lsd: ctx.fb_dtsg,
+      __spin_r: "1027694919",
+      __spin_b: "trunk",
+      __spin_t: Date.now(),
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "ProfileCometAppCollectionSelfFriendsListRendererPaginationQuery",
+      variables: JSON.stringify({
+        count: 20, // Increased count for better results
+        cursor: null,
+        scale: 1,
+        search: searchQuery.trim(),
+        id: "YXBwX2NvbGxlY3Rpb246cGZiaWQwMkJSM3NDeXRjNkJIeVVXem9OeUxNcjNoYnVDclRFZkdCcVlEaXZuSlZYOUNLR2pXVmRyYTQ4U29FalJTVzduMm03NlhDa0xEQXAybVVUenF6RXZraGc3ZHkyaGw="
+      }),
+      server_timestamps: true,
+      doc_id: "31767020089578751"
+    };
+
+    defaultFuncs
+      .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+      .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+      .then(function (resData) {
+        if (!resData || !resData.data) {
+          throw { error: "searchFriends returned empty object." };
+        }
+        if (resData.error) {
+          throw resData;
+        }
+
+        const friendsData = resData.data.node?.pageItems?.edges || [];
+        const formattedFriends = friendsData.map(edge => {
+          const friend = edge.node;
+          const friendUser = friend.node || friend;
+          
+          // Extract mutual friends count from subtitle
+          let mutualFriends = 0;
+          if (friend.subtitle_text?.text) {
+            const mutualMatch = friend.subtitle_text.text.match(/(\d+)\s+mutual\s+friend/i);
+            if (mutualMatch) {
+              mutualFriends = parseInt(mutualMatch[1]);
+            }
+          }
+          
+          return {
+            userID: friendUser.id || friend.id,
+            name: friend.title?.text || friendUser.name || friend.name,
+            profilePicture: friend.image?.uri || null,
+            profileUrl: friend.url || friendUser.url,
+            subtitle: friend.subtitle_text?.text || "",
+            mutualFriends: mutualFriends,
+            // Additional fields from the captured API
+            cursor: edge.cursor,
+            friendshipStatus: friendUser.friendship_status || "UNKNOWN",
+            gender: friendUser.gender || null,
+            shortName: friendUser.short_name || null
+          };
+        }).filter(friend => friend.userID && friend.name);
+
+        // Sort by relevance (exact matches first, then by mutual friends)
+        formattedFriends.sort((a, b) => {
+          const queryLower = searchQuery.toLowerCase();
+          const aNameLower = a.name.toLowerCase();
+          const bNameLower = b.name.toLowerCase();
+          
+          // Exact matches first
+          if (aNameLower === queryLower && bNameLower !== queryLower) return -1;
+          if (bNameLower === queryLower && aNameLower !== queryLower) return 1;
+          
+          // Then by starts with
+          if (aNameLower.startsWith(queryLower) && !bNameLower.startsWith(queryLower)) return -1;
+          if (bNameLower.startsWith(queryLower) && !aNameLower.startsWith(queryLower)) return 1;
+          
+          // Then by mutual friends count
+          return b.mutualFriends - a.mutualFriends;
+        });
+
+        callback(null, formattedFriends);
+      })
+      .catch(function (err) {
+        console.error("searchFriends error:", err);
+        return callback(err);
+      });
+
+    return returnPromise;
+  };
+};
+/** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Please give credits if reused. */

package/src/sendFriendRequest.js

@@ -0,0 +1,113 @@
+/**
+ * ===========================================================
+ * 🧑‍💻 Author: Sheikh Tamim (ST | Sheikh Tamim)
+ * 🔰 Owner & Developer
+ * 🌐 GitHub: https://github.com/sheikhtamimlover
+ * 📸 Instagram: https://instagram.com/sheikh.tamim_lover
+ * -----------------------------------------------------------
+ * 🕊️ Respect the creator & give proper credits if reused.
+ * ===========================================================
+ */
+"use strict";
+
+var utils = require("../utils");
+var log = require("npmlog");
+
+module.exports = function (defaultFuncs, api, ctx) {
+     /** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Instagram: @sheikh.tamim_lover */
+    return function sendFriendRequest(userID, callback) {
+        var resolveFunc = function () { };
+        var rejectFunc = function () { };
+        var returnPromise = new Promise(function (resolve, reject) {
+            resolveFunc = resolve;
+            rejectFunc = reject;
+        });
+
+        if (!callback) {
+            callback = function (err, data) {
+                if (err) return rejectFunc(err);
+                resolveFunc(data);
+            };
+        }
+
+        if (!userID) {
+            return callback({ error: "User ID is required" });
+        }
+
+        var form = {
+            av: ctx.userID,
+            __aaid: 0,
+            __user: ctx.userID,
+            __a: 1,
+            __req: utils.getSignatureID(),
+            __hs: "20353.HYP:comet_pkg.2.1...0",
+            dpr: 1,
+            __ccg: "EXCELLENT",
+            __rev: "1027405870",
+            __s: utils.getSignatureID(),
+            __hsi: "7552782279085106329",
+            __comet_req: 15,
+            fb_dtsg: ctx.fb_dtsg,
+            jazoest: ctx.ttstamp,
+            lsd: ctx.fb_dtsg,
+            __spin_r: "1027405870",
+            __spin_b: "trunk",
+            __spin_t: Date.now(),
+            __crn: "comet.fbweb.CometFriendingRoute",
+            fb_api_caller_class: "RelayModern",
+            fb_api_req_friendly_name: "FriendingCometFriendRequestSendMutation",
+            variables: JSON.stringify({
+                input: {
+                    click_correlation_id: Date.now().toString(),
+                    click_proof_validation_result: '{"validated":true}',
+                    friend_requestee_ids: [userID.toString()],
+                    friending_channel: "FRIENDS_HOME_MAIN",
+                    warn_ack_for_ids: [],
+                    actor_id: ctx.userID,
+                    client_mutation_id: Math.floor(Math.random() * 10).toString()
+                },
+                scale: 1
+            }),
+            server_timestamps: true,
+            doc_id: "24614631718227645"
+        };
+
+        defaultFuncs
+            .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+            .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+            .then(function (resData) {
+                if (resData.error) {
+                    throw resData;
+                }
+
+                if (resData.data && resData.data.friend_request_send) {
+                    var responseData = resData.data.friend_request_send;
+                    if (responseData.friend_requestees && responseData.friend_requestees.length > 0) {
+                        var requestee = responseData.friend_requestees[0];
+                        var result = {
+                            userID: requestee.id,
+                            friendshipStatus: requestee.friendship_status,
+                            success: requestee.friendship_status === "OUTGOING_REQUEST"
+                        };
+
+                        if (requestee.profile_action) {
+                            result.actionTitle = requestee.profile_action.title ? requestee.profile_action.title.text : "";
+                        }
+
+                        return callback(null, result);
+                    } else {
+                        return callback({ error: "No friend request data received" });
+                    }
+                } else {
+                    return callback({ error: "Invalid response format" });
+                }
+            })
+            .catch(function (err) {
+                log.error("sendFriendRequest", err);
+                return callback(err);
+            });
+
+        return returnPromise;
+    };
+};
+/** Developed by Sheikh Tamim | GitHub: sheikhtamimlover | Please give credits if reused. */