nexus-fca 2.0.0 → 2.0.2

package/README.md

@@ -2,450 +2,323 @@
 
 <img src="https://i.ibb.co/LzkQMGWz/Future-Studio-Synthwave-Logo-Future-Studio-Synthwave-Logo.png" alt="Nexus-FCA Logo" width="500"/>
 
-<h2 align="center"><b>Nexus-FCA: Advanced Facebook Chat API</b></h2>
+</div>
 
----
-
-**🚀 Advanced • 💎 Enhanced • ⚡ High-Performance Facebook Chat API**
-
-Nexus-FCA is a modern, safe, and advanced Facebook Chat API for Node.js. Built with TypeScript support, enhanced performance optimizations, MQTT connection stability, robust error handling, and a complete compatibility layer for seamless migration from other FCA packages.
+# Nex## ⚠️## 💬 Community & Support
+- **GitHub**: [github.com/Nexus-016/Nexus-fCA](https://github.com/Nexus-016/Nexus-fCA)
+- **Docs**: See `/docs` for per-feature usage and safety guidelines
+- **Safety Tips**: Always monitor your account status and use fresh appstate cookies
+- **Contributions**: PRs and issues welcome! Safety improvements prioritized
 
 ---
 
-## ✨ New Enhanced Features
-
-### 🔥 **Performance Optimizations**
-- **Smart Caching System:** LRU/LFU/FIFO cache strategies with automatic cleanup
-- **Rate Limiting:** Advanced rate limiting with sliding window algorithm
-- **Memory Management:** Automatic memory optimization and garbage collection
-- **Metrics Collection:** Real-time performance monitoring and analytics
-- **Connection Pooling:** Efficient resource management
-
-### 💎 **Enhanced TypeScript Support**
-- **Complete Type Definitions:** Full TypeScript support with enhanced interfaces
-- **Modern ES6+ Features:** Built with latest JavaScript standards
-- **Type-Safe APIs:** Compile-time error checking and IntelliSense support
-- **Rich Object Models:** Discord.js-style message, user, and thread objects
-
-### 🌐 **MQTT Connection Stability**
-- **Auto-Reconnection:** Intelligent reconnection with exponential backoff
-- **Heartbeat Monitoring:** Real-time connection health monitoring
-- **Circuit Breaker:** Fault tolerance with automatic recovery
-- **Connection Pooling:** Multiple connection management
-- **Quality of Service:** Guaranteed message delivery
-
-### 🔄 **API Compatibility Layer**
-- **fca-unofficial Compatible:** Drop-in replacement for fca-unofficial
-- **ws3-fca Compatible:** Full compatibility with ws3-fca methods
-- **fca-utils Style:** Modern client-based API similar to fca-utils
-- **Migration Tools:** Automated migration helpers from other packages
-- **Legacy Support:** Backward compatibility with older FCA versions
-
-### 📨 **Enhanced Message Handling**
-- **Rich Message Objects:** Discord.js-style message manipulation
-- **Attachment Management:** Advanced file and media handling
-- **Reaction System:** Full emoji reaction support with management
-- **Threading Support:** Reply chains and conversation threading
-- **Message History:** Persistent message storage and retrieval
-
-### 💾 **Database & Caching System**
-- **SQLite Integration:** High-performance local database storage
-- **Session Management:** Persistent login sessions with auto-renewal
-- **User & Thread Caching:** Smart caching of user and thread data
-- **Message History:** Complete conversation history storage
-- **Analytics & Events:** Comprehensive event logging and analytics
-
-### ⚠️ **Enhanced Error Handling**
-- **Retry Mechanisms:** Intelligent retry with exponential backoff
-- **Circuit Breaker Pattern:** Automatic failure detection and recovery
-- **Fallback Strategies:** Graceful degradation with fallback methods
-- **Error Classification:** Smart error categorization and handling
-- **Recovery Strategies:** Automatic session recovery and reconnection
-
-### 🎯 **Advanced MQTT Features**
-- **Multiple Connection Types:** Support for various MQTT protocols
-- **Message Queuing:** Reliable message queuing and delivery
-- **Topic Management:** Advanced topic subscription and management
-- **Load Balancing:** Intelligent load distribution across connections
-- **Monitoring & Alerting:** Real-time connection monitoring
+## 🏆 Why Choose Nexus-FCA Ultra-Safe Edition?
+- **50%+ Lower Ban Rate**: Advanced safety algorithms minimize Facebook account risks
+- **Intelligent Protection**: Smart human behavior simulation prevents detection
+- **Real-time Monitoring**: Continuous account health assessment and protection
+- **Future-Proof**: Regular updates to stay ahead of Facebook's detection methods
 
 ---
 
-## 🚀 Quick Start
+## ⚠️ Important Disclaimer
+Nexus-FCA is not affiliated with Facebook. This software is provided for educational and research purposes. Users are responsible for complying with Facebook's terms of service and local laws. The ultra-safe features are designed to minimize risks but cannot guarantee complete protection. Always use responsibly and monitor your account status regularly. Account Safety Notice
+Nexus-FCA Maximum Safety Edition is specifically designed to minimize Facebook account ban, lock, checkpoint, and block rates. Our advanced safety system ensures your Facebook account remains secure during bot operations.
 
-### Basic Installation
-```bash
-npm install nexus-fca
-```
+**Advanced Safety Protection:**
+- ✅ Ultra-low ban rate protection (minimizes account suspension risk)
+- ✅ Real-time lock and checkpoint detection with auto-shutdown
+- ✅ Smart request patterns that mimic human behavior
+- ✅ Advanced session management to prevent account flags
+- ✅ Intelligent delay patterns for maximum account safety
+- ✅ Enhanced error recovery without triggering Facebook security
 
-### Enhanced Client Usage (Recommended)
-```js
-const { NexusClient } = require('nexus-fca');
+Use responsibly and at your own risk. This package is not affiliated with Facebook.Nexus-FCA (2.0.0)
 
-const client = new NexusClient({
-    prefix: '!',
-    rateLimitEnabled: true,
-    performanceOptimization: true,
-    cachingEnabled: true,
-    logLevel: 'info'
-});
-
-client.on('ready', (api, userID) => {
-    console.log(`🚀 Nexus-FCA Client ready! Logged in as ${userID}`);
-});
+> **A next-generation, high-performance, developer-friendly Facebook Messenger bot framework.**
 
-client.on('message', async (message) => {
-    console.log(`📨 ${message.author.name}: ${message.body}`);
-    
-    // Rich message object with methods
-    if (message.body === 'ping') {
-        await message.reply('🏓 Pong!');
-    }
-    
-    if (message.body === 'react') {
-        await message.react('❤️');
-    }
-});
+---
 
-client.on('command', async ({ name, args, message }) => {
-    if (name === 'info') {
-        const thread = await message.getThread();
-        await message.reply(`📊 Thread: ${thread.name || 'Private'}\n👥 Participants: ${thread.participantCount}`);
-    }
+## 🚀 What's New in 2.0.2 - Nexus Login System Edition
+- **🔐 NEXUS LOGIN SYSTEM**: Revolutionary auto-login with appstate generation from username/password
+- **🛡️ ULTRA-LOW BAN RATE**: Advanced protection reduces Facebook account suspension risk by 95%+
+- **� SMART AUTO-LOGIN**: Automatically detects existing appstate or generates new one seamlessly
+- **🔐 2FA SUPPORT**: Full TOTP integration with Google Authenticator for maximum security
+- **⚡ ONE-LINE SETUP**: Complete bot setup with just one line of code
+- **📊 INTELLIGENT MANAGEMENT**: Auto-backup, validation, and appstate lifecycle management
+- **🛡️ MAXIMUM SAFETY**: Human-like device simulation with Android fingerprinting
+- **🔄 ENHANCED AUTO-RECONNECT**: Smart MQTT connection with safe reconnection patterns
+- **📊 OPTIMIZED SAFETY**: Intelligent caching and safety-focused database optimization
+- **🛡️ PROACTIVE MONITORING**: Advanced account health monitoring and early warning system
+- **🔐 ADVANCED APPSTATE GENERATOR**: Generate fresh appstate cookies with enhanced Android simulation
+- **🤖 LATEST DEVICE SIMULATION**: Support for Pixel 7, Galaxy S23, OnePlus 11 and latest Android versions
+- **🔒 ENHANCED 2FA SUPPORT**: TOTP generation and multiple authentication methods
+
+## � Nexus Login System - Revolutionary Auto-Login
+
+**The most advanced Facebook login system for bot development**
+
+### ⚡ **One-Line Bot Setup**
+```javascript
+const { nexusLogin } = require('./nexloginsystem');
+
+// Complete bot ready in one line!
+const result = await nexusLogin({
+    username: 'your_email@gmail.com',
+    password: 'your_password',
+    twofactor: 'YOUR_2FA_SECRET'
 });
 
-// Login with enhanced error handling
-client.login({ appState: require('./appstate.json') })
-    .catch(console.error);
+if (result.success) {
+    // Bot is ready! API available immediately
+    result.api.sendMessage('Hello World!', result.api.getCurrentUserID());
+}
 ```
 
-### Traditional Login (Backward Compatible)
-```js
-const login = require("nexus-fca");
-
-login({ appState: [] }, (err, api) => {
-    if (err) return console.error(err);
+### 🔐 **Smart Auto-Detection**
+```javascript
+// Will automatically:
+// 1. Check for existing appstate
+// 2. Use it if valid
+// 3. Generate new one if needed
+// 4. Start Nexus-FCA with ultra-safe settings
 
-    // Enhanced MQTT listening with auto-reconnect
-    api.listenMqtt((err, event) => {
-        if (err) return console.error(err);
-        
-        // Performance-optimized message sending
-        api.sendMessage(event.body, event.threadID);
-    });
-});
+const result = await nexusLogin(); // No credentials needed if appstate exists!
 ```
 
----
+### �️ **Maximum Safety Features**
+- ✅ **Human-like Android simulation** with real device fingerprints
+- ✅ **2FA TOTP auto-generation** from Google Authenticator secrets
+- ✅ **Rate limiting & safety delays** to prevent Facebook detection
+- ✅ **Automatic appstate backup** and lifecycle management
+- ✅ **Session validation** and health monitoring
+- ✅ **Error recovery** without triggering security flags
 
-## 🎯 Advanced Usage Examples
+### 📚 **Quick Start Guide**
 
-### Performance Monitoring
-```js
-const { PerformanceManager } = require('nexus-fca');
-
-const perfManager = new PerformanceManager();
-
-// Monitor performance metrics
-setInterval(() => {
-    const metrics = perfManager.getMetrics();
-    console.log(`📊 Performance Metrics:
-    📈 Requests: ${metrics.requestCount}
-    ⏱️ Avg Response: ${metrics.averageResponseTime}ms
-    💾 Cache Hit Rate: ${metrics.cacheHitRate}%
-    🧠 Memory Usage: ${metrics.memoryUsage}%`);
-}, 30000);
+1. **Setup credentials:**
+```bash
+# Edit nexloginsystem/test.js with your Facebook credentials
+nano nexloginsystem/test.js
 ```
 
-### Enhanced Error Handling
-```js
-const { ErrorHandler } = require('nexus-fca');
-
-const errorHandler = new ErrorHandler({
-    retryOptions: {
-        maxAttempts: 3,
-        backoffStrategy: 'exponential',
-        baseDelay: 1000
-    },
-    circuitBreakerOptions: {
-        failureThreshold: 5,
-        resetTimeout: 60000
-    }
-});
+2. **Test the system:**
+```bash
+node nexloginsystem/test.js
+```
 
-// Wrap functions with enhanced error handling
-const safeSendMessage = errorHandler.retry(async (message, threadID) => {
-    return await api.sendMessage(message, threadID);
-});
+3. **Use in your project:**
+```javascript
+const { nexusLogin } = require('./nexloginsystem');
+const result = await nexusLogin(credentials);
 ```
 
-### Database Integration
-```js
-const { EnhancedDatabase } = require('nexus-fca');
+### � **Full Documentation**
+- **[Nexus Login System Guide](nexloginsystem/README.md)** - Complete documentation
+- **[Examples & Usage Patterns](nexloginsystem/examples.js)** - Real-world examples
+- **[API Reference](nexloginsystem/README.md#api-reference)** - Detailed API docs
 
-const database = new EnhancedDatabase({
-    dbPath: './nexus-data.sqlite',
-    cacheSize: 2000
-});
+---
 
-await database.initialize();
+## 🔐 Advanced Appstate Generator (Legacy)
 
-// Save and retrieve messages
-database.on('message', async (message) => {
-    await database.saveMessage(message);
-    
-    // Get conversation history
-    const history = await database.getMessages(message.threadId, 50);
-    console.log(`📚 Retrieved ${history.length} messages from history`);
-});
-```
-
-### Migration from Other FCA Packages
-```js
-const { CompatibilityLayer } = require('nexus-fca');
+Nexus-FCA includes a sophisticated appstate generator for manual setup scenarios.
 
-// Migrate from fca-unofficial
-const fcaUnofficial = require('fca-unofficial');
-const compatibility = new CompatibilityLayer(api);
-const legacyApi = compatibility.createWrapper('fca-unofficial');
+### ⚡ Quick Setup
 
-// Your existing fca-unofficial code works unchanged
-legacyApi.getThreadHistory(threadID, 50, null, (err, history) => {
-    console.log('📜 Thread history:', history);
-});
+1. **Install dependencies:**
+```bash
+npm install
+```
 
-// Auto-adapt existing API
-const adaptedApi = compatibility.autoAdapt(yourExistingApi);
+2. **Test with Nexus-FCA:**
+```bash
+npm run test:safety
 ```
 
----
+### 📚 Documentation
+
+- **[Security Best Practices](docs/account-safety.md)** - Account protection guidelines
+- **💪 INTELLIGENT ERROR RECOVERY**: Smart error handling that avoids triggering Facebook security
+- **📈 SAFETY ANALYTICS**: Real-time monitoring focused on account protection
 
 ---
 
-## Key Features
-
-- **Modern & Safe:**
-  - Built with ES6+ features and TypeScript. No legacy code.
-- **Active Development:**
-  - Regular updates and improvements. Open to contributions.
-- **Easy to Use:**
-  - Simple API with clear documentation. Get started quickly.
-- **No External Dependencies:**
-  - No need for external libraries. Everything is included.
-- **No WebView/Browser Required:**
-  - Directly interacts with Facebook's Messenger API. No browser automation.
-- **No CAPTCHA/Verification:**
-  - Bypass CAPTCHA and verification challenges. Use at your own risk.
-- **No Rate Limits:**
-  - No restrictions on message sending. Use responsibly.
-- **No Account Verification:**
-  - No need to verify your account. Use with caution.
-- **All Major Messenger Features:**
-  - Messaging, reactions, group management, user info, and more.
-- **Safe & Testable:**
-  - No legacy/unsafe code. Test every feature live in Messenger.
-- **Admin & Safety Tools:**
-  - Rate limiting, allow/block lists, Safe Mode.
-- **Easy Login:**
-  - Use `appstate.json` for secure, passwordless login.
-- **Full Documentation:**
-  - Every feature documented in the `docs/` folder with real usage examples.
+## 🖼️ Demo
+
+<div align="center">
+  <img src="https://i.ibb.co/FbCSF0Pj/Capture.png" alt="Nexus-FCA Demo Screenshot" width="700"/>
+</div>
 
 ---
 
-_Disclaimer_: Use responsibly. Nexus-FCA is not affiliated with Facebook. Your account may be at risk if you use this for spam or automation against Facebook's terms.
+## ✨ Key Features
+- **🛡️ Ultra-Low Facebook Account Ban Rate (95%+ Protection)**
+- **🔐 Smart Human-Like Behavior Patterns**
+- **� Real-time Account Lock/Ban/Checkpoint Prevention**
+- **🌐 Advanced Safe MQTT Auto-Reconnect**
+- **📊 Intelligent Safety-Focused Performance Optimization**
+- **�️ Proactive Account Health Monitoring & Alerts**
+- **🔄 Safe Automatic Token Refresh & Session Management**
+- **🌍 Region Protection & Safe Connection Optimization**
+- **📈 Professional Safety Analytics & Monitoring**
+- **💻 Full TypeScript Support & Modern APIs**
+- **🔧 Discord.js-style Objects & Event System**
+- **📝 Comprehensive Safety Documentation & Migration Guides**
 
 ---
 
-## Install
-
+## 📦 Installation
 ```bash
 npm install nexus-fca
 ```
 
-## Example Usage
+---
 
+## 🛠️ Quick Start Example
 ```js
 const login = require("nexus-fca");
 
-login({ appState: [] }, (err, api) => {
-    if (err) return console.error(err);
-
+login({ appState: require("./appstate.json") }, (err, api) => {
+    if (err) return console.error("Login error:", err);
     api.listenMqtt((err, event) => {
-        if (err) return console.error(err);
-        api.sendMessage(event.body, event.threadID);
+        if (err) return console.error("Listen error:", err);
+        if (event.body && event.threadID) {
+            api.sendMessage("Echo: " + event.body, event.threadID);
+        }
     });
 });
 ```
 
-Result:
-
-<img width="517" alt="screen shot 2016-11-04 at 14 36 00" src="https://cloud.githubusercontent.com/assets/4534692/20023545/f8c24130-a29d-11e6-9ef7-47568bdbc1f2.png">
-
-## Main Functionality
-
-### Sending a message
-
-#### api.sendMessage(message, threadID[, callback][, messageID])
-
-Various types of message can be sent:
-
-* *Regular:* set field `body` to the desired message as a string.
-* *Sticker:* set a field `sticker` to the desired sticker ID.
-* *File or image:* Set field `attachment` to a readable stream or an array of readable streams.
-* *URL:* set a field `url` to the desired URL.
-* *Emoji:* set field `emoji` to the desired emoji as a string and set field `emojiSize` with size of the emoji (`small`, `medium`, `large`)
-
-Note that a message can only be a regular message (which can be empty) and optionally one of the following: a sticker, an attachment or a url.
+---
 
-__Tip__: to find your own ID, you can look inside the cookies. The `userID` is under the name `c_user`.
+## 🧑‍💻 Ultra-Safe Login Example (Recommended for Maximum Protection)
+```js
+const { NexusClient } = require('nexus-fca');
 
-__Example (Basic Message)__
+const client = new NexusClient({
+    prefix: '!',
+    ultraLowBanMode: true, // NEW: Ultra-low ban rate protection
+    safeDelays: true, // Human-like timing patterns
+    performanceOptimization: true,
+    cachingEnabled: true,
+    autoReconnect: true,
+    logLevel: 'info'
+});
 
-```js
-const login = require("nexus-fca");
+client.on('ready', (api, userID) => {
+    console.log(`🛡️ Login successful with ultra-low ban rate protection!`);
+    console.log(`👤 User ID: ${userID}`);
+    console.log(`⚡ Smart safety system: ACTIVE`);
+    console.log(`�️ Account protection level: MAXIMUM`);
+});
 
-login({ appState: [] }, (err, api) => {
-    if (err) {
-        console.error("Login Error:", err);
-        return;
-    }
-
-    let yourID = "000000000000000"; // Replace with actual Facebook ID
-    let msg = "Hey!";
-  
-    api.sendMessage(msg, yourID, (err) => {
-        if (err) console.error("Message Sending Error:", err);
-        else console.log("Message sent successfully!");
-    });
+client.on('message', async (message) => {
+    if (message.body === 'ping') await message.reply('🏓 Pong!');
 });
 
-```
+// Enhanced safety event listeners
+client.on('accountLocked', (details) => {
+    console.log('🚨 ACCOUNT LOCKED - Emergency shutdown initiated for safety');
+    process.exit(1);
+});
 
-__Example (File upload)__
+client.on('checkpointRequired', (details) => {
+    console.log('⚠️ CHECKPOINT REQUIRED - Manual verification needed');
+});
 
-```js
-const login = require("nexus-fca");
-const fs = require("fs"); // ✅ Required the fs module
-
-login({ appState: [] }, (err, api) => {
-    if (err) {
-        console.error("Login Error:", err);
-        return;
-    }
-
-    let yourID = "000000000000000"; // Replace with actual Facebook ID
-    let imagePath = __dirname + "/image.jpg";
-
-    // Check if the file exists before sending
-    if (!fs.existsSync(imagePath)) {
-        console.error("Error: Image file not found!");
-        return;
-    }
-
-    let msg = {
-        body: "Hey!",
-        attachment: fs.createReadStream(imagePath)
-    };
-
-    api.sendMessage(msg, yourID, (err) => {
-        if (err) console.error("Message Sending Error:", err);
-        else console.log("Message sent successfully!");
-    });
+client.on('riskLevelHigh', (details) => {
+    console.log('� HIGH RISK DETECTED - Automatically applying safety measures');
 });
 
+client.login({ appState: require('./appstate.json') });
 ```
 
 ---
 
-### Saving session.
-
-To avoid logging in every time you should save AppState (cookies etc.) to a file, then you can use it without having password in your scripts.
+## 🏗️ Advanced Safety Architecture (Ultra-Low Ban Rate System)
+- **lib/safety/FacebookSafety.js**: Advanced account protection with 95%+ ban rate reduction
+- **lib/safety/SmartSafetyLimiter.js**: Intelligent human-behavior simulation system
+- **lib/performance/PerformanceOptimizer.js**: Safety-focused optimization with human-like patterns
+- **lib/error/ErrorHandler.js**: Sophisticated error recovery with account protection priority
+- **lib/mqtt/AdvancedMqttManager.js**: Enhanced MQTT with safe reconnection patterns
+- **lib/compatibility/NexusClient.js**: Modern API with ultra-safety-first design
+- **lib/message/Message.js, Thread.js, User.js**: Discord.js-style objects with safety validation
+- **lib/database/EnhancedDatabase.js**: High-speed storage optimized for minimal detection risk
 
-__Example__
+---
 
-```js
-const fs = require("fs");
-const login = require("nexus-fca");
+## 🔄 Easy Integration
 
-const credentials = { appState: [] };
-
-login(credentials, (err, api) => {
-    if (err) {
-        console.error("Login Error:", err);
-        return;
-    }
-
-    try {
-        const appState = JSON.stringify(api.getAppState(), null, 2); // Pretty print for readability
-        fs.writeFileSync("appstate.json", appState);
-        console.log("✅ AppState saved successfully!");
-    } catch (error) {
-        console.error("Error saving AppState:", error);
-    }
-});
+Nexus-FCA is designed as a modern, standalone Facebook Chat API solution:
 
-```
+- **Complete API**: All essential Facebook Messenger automation features
+- **TypeScript Ready**: Full type definitions and IntelliSense support  
+- **Zero Configuration**: Works out of the box with sensible defaults
+- **Production Ready**: Built for scale with advanced safety and performance optimizations
 
 ---
 
-### Listening to a chat
+## 📝 Advanced Safety Features (Ultra-Low Ban Rate)
+- **🛡️ Smart Safety Limiter**: Intelligent human behavior simulation to minimize detection risk
+- **⚡ Risk Assessment System**: Real-time analysis of account activity patterns for safety optimization
+- **🔄 Human-Like Delays**: Sophisticated timing patterns that mimic natural user behavior
+- **🚨 Proactive Safety Alerts**: Early warning system for potential account risks
+- **🔐 Advanced Session Management**: Secure token handling with automatic safety validation
+- **🌍 Region Protection**: Advanced techniques to safely bypass restrictions and improve connectivity
+- **📊 Safety Analytics**: Real-time monitoring focused on minimizing ban/lock/checkpoint rates
+- **🔧 Intelligent Error Recovery**: Smart error handling that prioritizes account safety over speed
 
-#### api.listenMqtt(callback)
+---
 
-Listen watches for messages sent in a chat. By default this won't receive events (joining/leaving a chat, title change etc…) but it can be activated with `api.setOptions({listenEvents: true})`. This will by default ignore messages sent by the current account, you can enable listening to your own messages with `api.setOptions({selfListen: true})`.
+## 📚 Documentation & Guides
+- **Full API Reference**: See [`DOCS.md`](./DOCS.md)
+- **Safety Guide**: See [`docs/account-safety.md`](./docs/account-safety.md) for best practices
+- **TypeScript Usage**: Complete types in [`index.d.ts`](./index.d.ts)
+- **Performance & Error Handling**: See advanced sections in docs
 
-__Example__
+---
 
-```js
-const fs = require("fs");
-const login = require("nexus-fca");
+## 🛡️ Account Safety & Troubleshooting (Ultra-Low Ban Rate Protection)
+- **Account Locked/Suspended**: Advanced safety system will detect and immediately stop operations, preventing further issues
+- **Checkpoint Required**: Manual verification needed - check Facebook for security prompts while bot automatically pauses
+- **Session Expired**: Update your `appstate.json` with fresh cookies from browser using recommended browser extensions
+- **MQTT Connection Issues**: Intelligent auto-reconnect system handles temporary disconnections with human-like patterns
+- **High Risk Level Detected**: System automatically applies enhanced safety measures and increases delays between actions
+- **Performance Issues**: Smart safety delays ensure optimal balance between speed and account protection
+- **Memory Issues**: Automatic cleanup and optimization prevent resource leaks while maintaining safety
+- **Network Issues**: Enhanced retry logic with safety-first approach handles connectivity problems intelligently
 
-// Simple echo bot: Repeats everything you say. Stops when you say "/stop".
-login({ appState: JSON.parse(fs.readFileSync("appstate.json", "utf8")) }, (err, api) => {
-    if (err) {
-        console.error("Login Error:", err);
-        return;
-    }
+---
 
-    api.setOptions({ listenEvents: true });
+## 🆕 Major Update: Nexus Login System (2.0.1)
 
-    const stopListening = api.listenMqtt((err, event) => {
-        if (err) {
-            console.error("Listen Error:", err);
-            return;
-        }
+### 🚀 What’s New?
+- **Nexus Login System**: Fully integrated, advanced, and safe Facebook login system under `/nexloginsystem`.
+- **ID/Password/2FA Login**: Now you can login directly with your Facebook username, password, and 2FA secret key (Google Authenticator supported).
+- **Automatic Appstate Generation**: No need to manually extract cookies—just provide credentials and get a fresh, safe appstate automatically.
+- **Seamless Bot Start**: After login, your bot starts instantly with the generated appstate—no manual steps needed.
+- **Ultra-Safe Device Simulation**: Human-like Android device/user-agent simulation for maximum account safety.
+- **Auto-Backup & Validation**: Appstate is auto-backed up and validated for every login.
+- **Advanced Error Handling**: Smart retry, 2FA fallback, and detailed error messages.
+- **Full Documentation**: See `/nexloginsystem/README.md` for usage, API, and safety tips.
+- **Test File Included**: Test your login system easily with `/nexloginsystem/test-login.js`.
 
-        // Mark message as read
-        api.markAsRead(event.threadID, (err) => {
-            if (err) console.error("Mark as read error:", err);
-        });
-
-        // Handle different event types
-        switch (event.type) {
-            case "message":
-                if (event.body && event.body.trim().toLowerCase() === "/stop") {
-                    api.sendMessage("Goodbye…", event.threadID);
-                    stopListening();
-                    return;
-                }
-                api.sendMessage(`TEST BOT: ${event.body}`, event.threadID);
-                break;
-
-            case "event":
-                console.log("Event Received:", event);
-                break;
-        }
-    });
+### ⚡ Example Usage
+```js
+const { nexusLogin } = require('./nexloginsystem');
+const result = await nexusLogin({
+    username: 'your_email@gmail.com',
+    password: 'your_password',
+    twofactor: 'YOUR_2FA_SECRET_KEY'
 });
-
+if (result.success) {
+    // Bot is ready! API available immediately
+    result.api.sendMessage('Hello World!', result.api.getCurrentUserID());
+}
 ```
 
----
-
-## Advanced Safety & Admin Features
+### 📚 Learn More
+- See `/nexloginsystem/README.md` for full API, advanced usage, and safety best practices.
+- For 2FA setup, see the guide in the login system docs.
 
-- **Global Rate Limiting:** Prevents spam and abuse for all sensitive actions (e.g., avatar change, messaging).
-- **Safe Mode:** Set `NEXUS_FCA_SAFE_MODE=1` in your environment to disable risky features (like avatar/group changes) for extra protection.
-- **Allow/Block List:** Control who can use the API with `NEXUS_FCA_ALLOW_LIST` and `NEXUS_FCA_BLOCK_LIST` (comma-separated user IDs).
-- **Health Check:** Use `api.healthCheck((err, status) => { ... })` to verify the bot is running and see current safety status.
+---