nexus-fca 3.0.3 → 3.0.5

package/docs/advanced-configuration.md

@@ -14,7 +14,8 @@ NEXUS_PERSISTENT_DEVICE=true    # Enable consistent device fingerprinting (defau
 NEXUS_DEVICE_FILE=./device.json # Custom path to device profile file
 
 # Single-session guard (built-in)
-# Uses SingleSessionGuard with NEXUS_SESSION_LOCK_PATH and NEXUS_FORCE_LOCK
+# Toggle and configure SingleSessionGuard (default OFF)
+NEXUS_SESSION_LOCK_ENABLED=false # Enable with true/1 to turn lock ON
 NEXUS_SESSION_LOCK_PATH=./lock  # Path to session lock file used by SingleSessionGuard
 NEXUS_FORCE_LOCK=false          # Force acquire lock even if lock exists
 
@@ -62,8 +63,8 @@ const api = await login({
   // Session stability options
   persistentDevice: true,           // Use consistent device fingerprinting
   deviceFilePath: './device.json',  // Custom device profile path
-  // Single-session guard is enabled by default internally
-  // Configure via env: NEXUS_SESSION_LOCK_PATH, NEXUS_FORCE_LOCK
+  // Single-session guard (optional toggle)
+  sessionLockEnabled: true,        // default is OFF; set true or env NEXUS_SESSION_LOCK_ENABLED=true
   
   // Connection options
   region: 'NA',                     // Set fixed region

package/index.js

@@ -1371,12 +1371,19 @@ async function login(loginData, options = {}, callback) {
       mainLogger.info('✅ Session generated successfully');
       mainLogger.info('🔄 Starting bot with generated session (old system)');
       
-      // STEP 2: Single session guard before starting bot
+      // STEP 2: Single session guard before starting bot (configurable)
       try {
-        const ssg = new SingleSessionGuard({ dataDir: process.env.NEXUS_DATA_DIR });
-        ssg.acquire();
-        // keep guard reference to release on exit
-        global.__NEXUS_SSG__ = ssg;
+        const envLockFlag = process.env.NEXUS_SESSION_LOCK_ENABLED;
+        const lockEnabled = (typeof options.sessionLockEnabled !== 'undefined')
+          ? !!options.sessionLockEnabled
+          : (envLockFlag === '1' || (envLockFlag || '').toLowerCase() === 'true');
+
+        if (lockEnabled) {
+          const ssg = new SingleSessionGuard({ dataDir: process.env.NEXUS_DATA_DIR });
+          ssg.acquire();
+          // keep guard reference to release on exit
+          global.__NEXUS_SSG__ = ssg;
+        }
       } catch (e) {
         mainLogger.error('⚠️ Single session guard blocked start', e.message);
         if (callback) callback(e);
@@ -1426,9 +1433,16 @@ async function login(loginData, options = {}, callback) {
     
     // Direct session authentication using appstate (with single session guard)
     try {
-      const ssg = new SingleSessionGuard({ dataDir: process.env.NEXUS_DATA_DIR });
-      ssg.acquire();
-      global.__NEXUS_SSG__ = ssg;
+      const envLockFlag = process.env.NEXUS_SESSION_LOCK_ENABLED;
+      const lockEnabled = (typeof options.sessionLockEnabled !== 'undefined')
+        ? !!options.sessionLockEnabled
+        : (envLockFlag === '1' || (envLockFlag || '').toLowerCase() === 'true');
+
+      if (lockEnabled) {
+        const ssg = new SingleSessionGuard({ dataDir: process.env.NEXUS_DATA_DIR });
+        ssg.acquire();
+        global.__NEXUS_SSG__ = ssg;
+      }
     } catch (e) {
       mainLogger.error('⚠️ Single session guard blocked start', e.message);
       if (callback) callback(e);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-fca",
-  "version": "3.0.3",
+  "version": "3.0.5",
   "description": "Nexus-FCA 3.0 – stable, low-risk Facebook Messenger automation API with integrated secure login (ID / Password / 2FA), adaptive MQTT core, safety orchestration, metrics, and TypeScript support.",
   "main": "index.js",
   "repository": {