nexus-fca 3.0.4 → 3.0.5

package/docs/advanced-configuration.md

@@ -14,8 +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)
-# Toggle and configure SingleSessionGuard
-NEXUS_SESSION_LOCK_ENABLED=true # Enable/disable lock globally (default true)
+# 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
 
@@ -64,7 +64,7 @@ const api = await login({
   persistentDevice: true,           // Use consistent device fingerprinting
   deviceFilePath: './device.json',  // Custom device profile path
   // Single-session guard (optional toggle)
-  sessionLockEnabled: true,        // or control via env NEXUS_SESSION_LOCK_ENABLED
+  sessionLockEnabled: true,        // default is OFF; set true or env NEXUS_SESSION_LOCK_ENABLED=true
   
   // Connection options
   region: 'NA',                     // Set fixed region

package/index.js

@@ -1373,9 +1373,10 @@ async function login(loginData, options = {}, callback) {
       
       // STEP 2: Single session guard before starting bot (configurable)
       try {
+        const envLockFlag = process.env.NEXUS_SESSION_LOCK_ENABLED;
         const lockEnabled = (typeof options.sessionLockEnabled !== 'undefined')
           ? !!options.sessionLockEnabled
-          : !(process.env.NEXUS_SESSION_LOCK_ENABLED === '0' || (process.env.NEXUS_SESSION_LOCK_ENABLED || '').toLowerCase() === 'false');
+          : (envLockFlag === '1' || (envLockFlag || '').toLowerCase() === 'true');
 
         if (lockEnabled) {
           const ssg = new SingleSessionGuard({ dataDir: process.env.NEXUS_DATA_DIR });
@@ -1432,9 +1433,10 @@ async function login(loginData, options = {}, callback) {
     
     // Direct session authentication using appstate (with single session guard)
     try {
+      const envLockFlag = process.env.NEXUS_SESSION_LOCK_ENABLED;
       const lockEnabled = (typeof options.sessionLockEnabled !== 'undefined')
         ? !!options.sessionLockEnabled
-        : !(process.env.NEXUS_SESSION_LOCK_ENABLED === '0' || (process.env.NEXUS_SESSION_LOCK_ENABLED || '').toLowerCase() === 'false');
+        : (envLockFlag === '1' || (envLockFlag || '').toLowerCase() === 'true');
 
       if (lockEnabled) {
         const ssg = new SingleSessionGuard({ dataDir: process.env.NEXUS_DATA_DIR });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-fca",
-  "version": "3.0.4",
+  "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": {