nexus-fca 2.1.1 → 2.1.2

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [2.1.2] - Unreleased - CONTINUOUS IDLE RECOVERY
+### Added
+- Soft-stale probing at 2 minutes idle (ping + conditional forced reconnect if no events within 5-8s)
+- Wrapper around `listenMqtt` to automatically feed events into safety heartbeat (`recordEvent`) for precise idle detection
+
+### Improved
+- Faster recovery from silent idle states (previously required >5 min or external trigger)
+- Reduced chance of appearing online but unresponsive after short inactivity
+
+---
+
 ## [2.1.1] - 2025-08-27 - ADVANCED SESSION STABILITY
 ### 🛠 Added
 - Adaptive safe session refresh interval (dynamic based on risk level)

package/index.js

@@ -239,6 +239,26 @@ function buildAPI(globalOptions, html, jar) {
       api[v.replace(".js", "")] = require("./src/" + v)(defaultFuncs, api, ctx);
     });
   api.listen = api.listenMqtt;
+  // Safety wrapper: ensure every inbound MQTT event updates safety lastEvent timestamp
+  if (!api._safetyWrappedListen) {
+    const _origListen = api.listenMqtt;
+    api.listenMqtt = function(callback) {
+      const wrapped = (err, evt) => {
+        if (!err && evt) {
+          try { globalSafety.recordEvent(); } catch(_) {}
+        }
+        if (typeof callback === 'function') callback(err, evt);
+      };
+      const emitter = _origListen(wrapped);
+      // Redundant defensive hooks
+      try {
+        emitter.on('message', () => globalSafety.recordEvent());
+        emitter.on('error', () => globalSafety.recordEvent());
+      } catch(_) {}
+      return emitter;
+    };
+    api._safetyWrappedListen = true;
+  }
   setInterval(async () => {
     api
       .refreshFb_dtsg()

package/lib/safety/FacebookSafety.js

@@ -66,6 +66,8 @@ class FacebookSafety {
         this._destroyed = false;
         this._postRefreshChecks = [];
         this._inFlightRefreshId = 0;
+        // New: probing guard to avoid overlapping soft-stale probes
+        this._probing = false;
 
         this.initSafety();
     }
@@ -306,10 +308,41 @@ class FacebookSafety {
     async _ensureMqttAlive() {
         if (!this.api || this._destroyed) return;
         try {
+            const now = Date.now();
             const disconnected = !this.ctx || !this.ctx.mqttClient || !this.ctx.mqttClient.connected;
-            const stale = Date.now() - this._lastEventTs > 5 * 60 * 1000; // >5 min no events
+            const idle = now - this._lastEventTs;
+            const softStale = idle > 2 * 60 * 1000; // >2 min no events
+            const hardStale = idle > 5 * 60 * 1000; // >5 min no events (legacy threshold)
+            const stale = hardStale; // backwards compat naming
+
+            // If totally disconnected or hard stale -> reconnect immediately
             if (disconnected || stale) {
-                await this._reconnectMqttWithBackoff(disconnected ? 'disconnected' : 'stale');
+                await this._reconnectMqttWithBackoff(disconnected ? 'disconnected' : 'hard-stale');
+                return;
+            }
+
+            // Soft-stale probing: connection claims to be open but no events for 2-5 minutes.
+            // We issue a ping and if still no events after probe window, we force a reconnect.
+            if (softStale && !this._probing) {
+                this._probing = true;
+                const prevTs = this._lastEventTs;
+                try {
+                    if (this.ctx && this.ctx.mqttClient && this.ctx.mqttClient.connected) {
+                        if (typeof this.ctx.mqttClient.ping === 'function') {
+                            try { this.ctx.mqttClient.ping(); } catch(_) {}
+                        }
+                    }
+                } catch(_) {}
+                setTimeout(() => {
+                    if (this._destroyed) return;
+                    // If no new events arrived since probe start, treat as latent-dead connection
+                    if (this._lastEventTs <= prevTs) {
+                        // Reset backoff to allow immediate reconnect (latency sensitive)
+                        this._backoff.attempt = 0;
+                        this._reconnectMqttWithBackoff('soft-stale');
+                    }
+                    this._probing = false;
+                }, 5000 + Math.random() * 3000); // 5-8s probe window
             }
         } catch (_) { /* swallow */ }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-fca",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "description": "A modern, safe, and advanced Facebook Chat API for Node.js with fully integrated Nexus Login System. NPM-ready with ID/password/2FA support, ultra-low ban rate protection, and zero external dependencies.",
   "main": "index.js",
   "repository": {