nexus-fca 3.2.3 → 3.2.4

package/README.md

@@ -187,6 +187,7 @@ const login = require('nexus-fca');
 ## 📚 Documentation Map
 | Resource | Location |
 |----------|----------|
+| **Usage Guide (Examples)** | `USAGE-GUIDE.md` |
 | Full API Reference | `DOCS.md` |
 | Feature Guides | `docs/*.md` |
 | Configuration Reference | `docs/configuration-reference.md` |

package/lib/factory/ApiFactory.js

@@ -183,6 +183,9 @@ class ApiFactory {
                     globalOptions[key] = options[key];
                 });
             },
+            autoTyping: (enable = true) => {
+                globalOptions.autoTyping = !!enable;
+            },
             getAppState: function () {
                 const appState = utils.getAppState(ctx.jar);
                 return appState.filter((item, index, self) =>
@@ -217,6 +220,11 @@ class ApiFactory {
             }
         };
 
+        // Default options
+        if (typeof globalOptions.autoTyping === 'undefined') {
+            globalOptions.autoTyping = true; // Enabled by default for safety
+        }
+
         // Default edit settings
         if (!globalOptions.editSettings) {
             globalOptions.editSettings = {
@@ -293,9 +301,18 @@ class ApiFactory {
         globalOptions.groupQueueIdleMs = 30 * 60 * 1000;
 
         api._sendMessageDirect = DIRECT_FN;
-        api.sendMessage = function (message, threadID, cb) {
+        api.sendMessage = function (message, threadID, cb, replyToMessage) {
+            // New: Auto-Typing support for improved human-like behavior
+            if (globalOptions.autoTyping) {
+                try {
+                    api.sendTypingIndicator(threadID, (err) => {
+                        // Ignore typing errors to avoid blocking the message
+                    });
+                } catch (_) { /* ignore */ }
+            }
+
             if (!globalOptions.groupQueueEnabled || !isGroupThread(threadID)) {
-                return api._sendMessageDirect(message, threadID, cb);
+                return api._sendMessageDirect(message, threadID, cb, replyToMessage);
             }
             let entry = groupQueues.get(threadID);
             if (!entry) { entry = { q: [], sending: false, lastActive: Date.now() }; groupQueues.set(threadID, entry); }
@@ -304,7 +321,7 @@ class ApiFactory {
                 entry.q.shift();
                 if (ctx.health) ctx.health.recordGroupQueuePrune(0, 0, 1);
             }
-            entry.q.push({ message, threadID, cb });
+            entry.q.push({ message, threadID, cb, replyToMessage });
             processQueue(threadID, entry);
         };
 
@@ -312,13 +329,13 @@ class ApiFactory {
             if (entry.sending) return;
             if (!entry.q.length) return;
             entry.sending = true;
-            const { message, threadID: tid, cb } = entry.q.shift();
-            api._sendMessageDirect(message, tid, function (err, res) {
+            const item = entry.q.shift();
+            api._sendMessageDirect(item.message, item.threadID, function (err, res) {
                 try { if (!err && this.globalSafety) this.globalSafety.recordEvent(); } catch (_) { }
-                if (typeof cb === 'function') cb(err, res);
+                if (typeof item.cb === 'function') item.cb(err, res);
                 entry.sending = false;
                 setImmediate(() => processQueue(threadID, entry));
-            }.bind(this));
+            }.bind(this), item.replyToMessage);
         }
 
         api._flushGroupQueue = function (threadID) {

package/lib/safety/FacebookSafety.js

@@ -49,13 +49,13 @@ class FacebookSafety {
         this.regions = ['ASH', 'ATL', 'DFW', 'ORD', 'PHX', 'SJC', 'IAD'];
         this.currentRegion = this.regions[Math.floor(Math.random() * this.regions.length)];
 
-        // ULTRA-SAFE human delay patterns - Relaxed for usability
+        // ULTRA-SAFE human delay patterns - More conservative
         this.humanDelayPatterns = {
-            typing: { min: 500, max: 1500 },         // Normal typing (0.5-1.5s)
-            reading: { min: 1000, max: 3000 },       // Normal reading (1-3s)
-            thinking: { min: 1000, max: 4000 },      // Normal thinking (1-4s)
-            browsing: { min: 500, max: 2000 },       // Normal browsing (0.5-2s)
-            messageDelay: { min: 1000, max: 3000 }   // 1-3s between messages (much faster)
+            typing: { min: 800, max: 2500 },         // Normal typing (0.8-2.5s)
+            reading: { min: 1500, max: 5000 },       // Normal reading (1.5-5s)
+            thinking: { min: 1500, max: 6000 },      // Normal thinking (1.5-6s)
+            browsing: { min: 1000, max: 3000 },      // Normal browsing (1-3s)
+            messageDelay: { min: 1500, max: 4000 }   // 1.5-4s between messages (Conservative)
         };
 
         this.sessionMetrics = {
@@ -800,16 +800,17 @@ class FacebookSafety {
         const risk = this.sessionMetrics.riskLevel;
         const since = Date.now() - this._lastHeavyMaintenanceTs;
         const inWindow = since < this._adaptivePacingWindowMs;
-        let min = 0, max = 0;
-        if (inWindow) {
-            if (risk === 'high') { min = 600; max = 1500; }
-            else if (risk === 'medium') { min = 200; max = 800; }
-            else { min = 0; max = 300; }
-        } else {
-            // outside pacing window only high risk adds mild delay
-            if (risk === 'high') { min = 150; max = 600; }
+
+        let min = 1000, max = 2500; // Default baseline human pace
+
+        if (risk === 'high') {
+            min = 3500; max = 6500;
+        } else if (risk === 'medium') {
+            min = 2000; max = 4500;
+        } else if (inWindow) {
+            min = 1500; max = 3000;
         }
-        if (max <= 0) return 0;
+
         return Math.floor(min + Math.random() * (max - min));
     }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nexus-fca",
-  "version": "3.2.3",
-  "description": "Nexus-FCA 3.2.3 – Advanced, Secure & Stable Facebook Messenger API.",
+  "version": "3.2.4",
+  "description": "Nexus-FCA 3.2.4 – Advanced, Secure & Stable Facebook Messenger API.",
   "main": "index.js",
   "repository": {
     "type": "git",

package/utils.js

@@ -87,23 +87,44 @@ function getJar() {
 }
 
 function getHeaders(url, options, ctx, customHeader) {
+    const ua = (options?.userAgent || "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36");
+    const isWindows = ua.includes("Windows NT");
+    const isAndroid = ua.includes("Android");
+    const isChrome = ua.includes("Chrome") && !ua.includes("Edg");
+
     var headers = {
         Referer: "https://www.facebook.com/",
         Host: url.replace("https://", "").split("/")[0],
         Origin: "https://www.facebook.com",
-        "user-agent": (options?.userAgent || "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"),
+        "user-agent": ua,
         Connection: "keep-alive",
-        "sec-fetch-site": 'same-origin',
-        "sec-fetch-mode": 'cors',
-        "sec-fetch-dest": "empty",
         "accept": "*/*",
         "accept-language": "en-US,en;q=0.9",
-        "sec-ch-ua": '"Google Chrome";v="131", "Chromium";v="131", "Not_A Brand";v="24"',
-        "sec-ch-ua-mobile": "?0",
-        "sec-ch-ua-platform": '"Windows"',
         "dnt": "1",
         "upgrade-insecure-requests": "1"
     };
+
+    // Human-like Fetch headers
+    if (url.includes("/api/graphql/") || url.includes("/messaging/")) {
+        headers["sec-fetch-site"] = 'same-origin';
+        headers["sec-fetch-mode"] = 'cors';
+        headers["sec-fetch-dest"] = "empty";
+    } else {
+        headers["sec-fetch-site"] = 'none';
+        headers["sec-fetch-mode"] = 'navigate';
+        headers["sec-fetch-dest"] = "document";
+    }
+
+    // Dynamic Client Hints - CRITICAL: Must match User-Agent
+    if (isChrome && isWindows) {
+        headers["sec-ch-ua"] = '"Google Chrome";v="131", "Chromium";v="131", "Not_A Brand";v="24"';
+        headers["sec-ch-ua-mobile"] = "?0";
+        headers["sec-ch-ua-platform"] = '"Windows"';
+    } else if (isAndroid) {
+        headers["sec-ch-ua-mobile"] = "?1";
+        // Remove Windows-specific headers for Android UAs
+    }
+
     if (customHeader) Object.assign(headers, customHeader);
     if (ctx && ctx.region) headers["X-MSGR-Region"] = ctx.region;