nexus-fca 2.0.0 → 2.0.1

package/README.md

@@ -2,450 +2,147 @@
 
 <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 (2.0.0)
 
-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.
+> **A next-generation, high-performance, developer-friendly Facebook Messenger bot framework.**
 
 ---
 
-## ✨ 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
+## 🚀 What's New in 2.0.0
+- **PerformanceManager**: Smart caching, metrics, and rate limiting for blazing speed.
+- **Advanced ErrorHandler**: Retry logic, circuit breaker, and fallback strategies for robust bots.
+- **AdvancedMqttManager**: Auto-reconnect, heartbeat, and stable MQTT event handling.
+- **API Compatibility Layer**: Drop-in support for fca-unofficial, ws3-fca, and fca-utils codebases.
+- **Rich Message, Thread, User Classes**: Discord.js-style objects for easy, powerful bot logic.
+- **EnhancedDatabase**: Persistent, high-speed storage for sessions, users, threads, and history.
+- **Full TypeScript Support**: Modern, type-safe APIs and definitions.
+- **Modern Command & Middleware System**: Event-driven, modular, and extensible.
+- **Advanced MQTT Features**: Topic management, load balancing, and real-time monitoring.
+- **Professional Logging**: Clean, colorized, and filterable logs for all environments.
 
 ---
 
-## 🚀 Quick Start
-
-### Basic Installation
-```bash
-npm install nexus-fca
-```
-
-### Enhanced Client Usage (Recommended)
-```js
-const { NexusClient } = require('nexus-fca');
-
-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}`);
-});
-
-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}`);
-    }
-});
-
-// Login with enhanced error handling
-client.login({ appState: require('./appstate.json') })
-    .catch(console.error);
-```
-
-### Traditional Login (Backward Compatible)
-```js
-const login = require("nexus-fca");
-
-login({ appState: [] }, (err, api) => {
-    if (err) return console.error(err);
-
-    // 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);
-    });
-});
-```
-
----
-
-## 🎯 Advanced Usage Examples
-
-### 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);
-```
-
-### 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
-    }
-});
-
-// Wrap functions with enhanced error handling
-const safeSendMessage = errorHandler.retry(async (message, threadID) => {
-    return await api.sendMessage(message, threadID);
-});
-```
-
-### Database Integration
-```js
-const { EnhancedDatabase } = require('nexus-fca');
-
-const database = new EnhancedDatabase({
-    dbPath: './nexus-data.sqlite',
-    cacheSize: 2000
-});
-
-await database.initialize();
-
-// 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');
-
-// Migrate from fca-unofficial
-const fcaUnofficial = require('fca-unofficial');
-const compatibility = new CompatibilityLayer(api);
-const legacyApi = compatibility.createWrapper('fca-unofficial');
-
-// Your existing fca-unofficial code works unchanged
-legacyApi.getThreadHistory(threadID, 50, null, (err, history) => {
-    console.log('📜 Thread history:', history);
-});
+## 🖼️ Demo
 
-// Auto-adapt existing API
-const adaptedApi = compatibility.autoAdapt(yourExistingApi);
-```
-
----
-
----
-
-## 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.
+<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
+- **Modern, Safe, and Actively Maintained**
+- **No WebView/Browser Automation**
+- **No CAPTCHA/Verification Required**
+- **All Major Messenger Features**
+- **Admin & Safety Tools**
+- **Easy Login with `appstate.json`**
+- **Full 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`.
-
-__Example (Basic Message)__
+---
 
+## 🧑‍💻 Modern Client Example (Recommended)
 ```js
-const login = require("nexus-fca");
+const { NexusClient } = require('nexus-fca');
 
-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!");
-    });
+const client = new NexusClient({
+    prefix: '!',
+    rateLimitEnabled: true,
+    performanceOptimization: true,
+    cachingEnabled: true,
+    logLevel: 'info'
 });
 
-```
-
-__Example (File upload)__
+client.on('ready', (api, userID) => {
+    console.log(`✅ Ready as ${userID}`);
+});
 
-```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('message', async (message) => {
+    if (message.body === 'ping') await message.reply('🏓 Pong!');
 });
 
+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.
-
-__Example__
-
-```js
-const fs = require("fs");
-const login = require("nexus-fca");
-
-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);
-    }
-});
-
-```
+## 🏗️ Architecture Overview
+- **lib/performance/PerformanceManager.js**: Caching, metrics, rate limiting
+- **lib/error/ErrorHandler.js**: Retry, circuit breaker, fallback
+- **lib/mqtt/AdvancedMqttManager.js**: Robust MQTT connection
+- **lib/compatibility/NexusClient.js**: Modern API, command system, middleware
+- **lib/message/Message.js, Thread.js, User.js**: Rich object models
+- **lib/database/EnhancedDatabase.js**: Persistent, high-speed storage
+- **lib/compatibility/CompatibilityLayer.js**: API migration and compatibility
 
 ---
 
-### Listening to a chat
+## 🔄 Migration & Compatibility
+- **fca-unofficial**: Drop-in replacement, all methods supported
+- **ws3-fca**: Compatible method names and event system
+- **fca-utils**: Modern client API, command/middleware system
+- **Migration helpers**: See `docs/Migration-fca-unofficial.md` for step-by-step guides
 
-#### 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})`.
+## 📝 Advanced Features
+- **PerformanceManager**: `getMetrics()`, `setCache()`, `checkRateLimit()`
+- **ErrorHandler**: `retry()`, `setFallback()`, `getErrorStats()`
+- **AdvancedMqttManager**: `connect()`, `on('connected')`, `startHeartbeat()`
+- **EnhancedDatabase**: `saveUser()`, `getMessages()`, `saveSession()`, `logEvent()`
+- **CompatibilityLayer**: `createWrapper()`, `autoAdapt()`, `createLegacyApi()`
+- **Rich Message Objects**: `reply()`, `react()`, `edit()`, `forward()`, `pin()`, `markAsRead()`
+- **Thread/User Objects**: `addUser()`, `removeUser()`, `changeName()`, `getAdmins()`, `makeAdmin()`
 
-__Example__
+---
 
-```js
-const fs = require("fs");
-const login = require("nexus-fca");
+## 📚 Documentation & Guides
+- **Full API Reference**: See [`DOCS.md`](./DOCS.md)
+- **Migration Guides**: See [`docs/`](./docs/) for fca-unofficial, ws3-fca, fca-utils
+- **TypeScript Usage**: Complete types in [`index.d.ts`](./index.d.ts)
+- **Performance & Error Handling**: See advanced sections in docs
 
-// 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 });
+## 🛡️ Troubleshooting
+- **MQTT Connection Refused**: Check your `appstate.json`, resolve Facebook checkpoints, or try a new account.
+- **TypeScript Errors**: Ensure you are using the latest `index.d.ts` and TypeScript version.
+- **Other Issues**: See logs, check for updates, or open an issue on GitHub.
 
-    const stopListening = api.listenMqtt((err, event) => {
-        if (err) {
-            console.error("Listen Error:", err);
-            return;
-        }
-
-        // 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;
-        }
-    });
-});
+---
 
-```
+## 💬 Community & Support
+- **GitHub**: [github.com/Nexus-016/Nexus-fCA](https://github.com/Nexus-016/Nexus-fCA)
+- **Docs**: See `/docs` for per-feature usage and migration
+- **Contributions**: PRs and issues welcome!
 
 ---
 
-## Advanced Safety & Admin Features
-
-- **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.
+## ⚠️ Disclaimer
+Nexus-FCA is not affiliated with Facebook. Use responsibly and at your own risk. Automation may violate Facebook’s terms of service.

package/index.js

@@ -24,8 +24,8 @@ const { User } = require('./lib/message/User');
 
 // Legacy imports for backward compatibility
 const MqttManager = require('./lib/mqtt/MqttManager');
-const { DatabaseManager } = require('./lib/database/DatabaseManager');
-const { PerformanceOptimizer } = require('./lib/performance/PerformanceOptimizer');
+const { DatabaseManager, getInstance } = require('./lib/database/DatabaseManager');
+const { PerformanceOptimizer, getInstance: getPerformanceOptimizerInstance } = require('./lib/performance/PerformanceOptimizer');
 
 let checkVerified = null;
 const defaultLogRecordSize = 100;
@@ -150,7 +150,6 @@ function buildAPI(globalOptions, html, jar) {
       const url = new URL(mqttEndpoint);
       region = url.searchParams.get("region")?.toUpperCase() || "PRN";
     }
-    logger(`Server region ${region}`, 'info');
   } catch (e) {
     log.warning("login", "Not MQTT endpoint");
   }
@@ -161,8 +160,8 @@ function buildAPI(globalOptions, html, jar) {
 
 
   // Initialize enhanced systems
-  const dbManager = DatabaseManager.getInstance();
-  const performanceOptimizer = PerformanceOptimizer.getInstance();
+  const dbManager = getInstance();
+  const performanceOptimizer = getPerformanceOptimizerInstance();
   (async () => {
     try {
       await models.sequelize.authenticate();
@@ -174,7 +173,7 @@ function buildAPI(globalOptions, html, jar) {
   })();
   // Professional gradient banner for Nexus-FCA
   logger('═══════════════════════════════════════════════════════════════════════════════', 'info');
-  logger('        Welcome to Nexus-FCA - Advanced & Safe Facebook Chat API', 'info');
+  logger('             Nexus-FCA - Advanced & Safe Facebook Chat API', 'info');
   logger('═══════════════════════════════════════════════════════════════════════════════', 'info');
   logger(`Nexus-FCA`, 'info');
   const ctx = {
@@ -386,6 +385,8 @@ function login(loginData, options, callback) {
   return returnPromise;
 }
 
+const enhancedDatabase = new EnhancedDatabase();
+
 // Enhanced exports
 module.exports = login;
 module.exports.NexusClient = NexusClient;

package/lib/error/ErrorHandler.js

@@ -270,375 +270,8 @@ class RateLimitError extends NexusError {
 }
 
 /**
- * Enhanced Error Handler Class
+ * Create singleton instance
  */
-class ErrorHandler {
-    constructor() {
-        this.errorLog = [];
-        this.maxLogSize = 1000;
-        this.errorCounts = new Map();
-        this.recoveryStrategies = new Map();
-        this.userFriendlyMessages = new Map();
-        
-        this._setupErrorMappings();
-        this._setupRecoveryStrategies();
-        this._setupUserFriendlyMessages();
-    }
-
-    /**
-     * Setup error code mappings
-     * @private
-     */
-    _setupErrorMappings() {
-        this.errorMappings = {
-            // Login errors
-            'ECONNREFUSED': 'LOGIN_NETWORK_ERROR',
-            'ETIMEDOUT': 'LOGIN_TIMEOUT',
-            'ENOTFOUND': 'LOGIN_DNS_ERROR',
-            
-            // Session errors
-            'Session expired': 'SESSION_EXPIRED',
-            'Not logged in': 'SESSION_INVALID',
-            'Invalid session': 'SESSION_INVALID',
-            
-            // Rate limiting
-            'Rate limit exceeded': 'RATE_LIMITED',
-            'Too many requests': 'RATE_LIMITED',
-            
-            // Network errors
-            'ECONNRESET': 'NETWORK_CONNECTION_RESET',
-            'ECONNABORTED': 'NETWORK_CONNECTION_ABORTED',
-            
-            // Facebook-specific errors
-            'GraphMethodException': 'FB_GRAPH_ERROR',
-            'OAuthException': 'FB_AUTH_ERROR',
-            'MQTT connection failed': 'MQTT_CONNECTION_ERROR',
-            
-            // Validation errors
-            'Invalid threadID': 'INVALID_THREAD_ID',
-            'Invalid userID': 'INVALID_USER_ID',
-            'Invalid message format': 'INVALID_MESSAGE_FORMAT'
-        };
-    }
-
-    /**
-     * Setup recovery strategies
-     * @private
-     */
-    _setupRecoveryStrategies() {
-        this.recoveryStrategies.set('SESSION_EXPIRED', async (error, context) => {
-            logger('🔄 Attempting session recovery...', 'warn');
-            // Try to refresh tokens
-            if (context.api && context.api.refreshFb_dtsg) {
-                try {
-                    await context.api.refreshFb_dtsg();
-                    return { success: true, message: 'Session refreshed successfully' };
-                } catch (refreshError) {
-                    return { success: false, message: 'Session refresh failed', requiresReLogin: true };
-                }
-            }
-            return { success: false, message: 'No refresh method available', requiresReLogin: true };
-        });
-
-        this.recoveryStrategies.set('NETWORK_ERROR', async (error, context) => {
-            logger('🔄 Attempting network recovery...', 'warn');
-            // Implement exponential backoff
-            const retryDelay = Math.min(1000 * Math.pow(2, error.retryCount || 0), 30000);
-            await this._delay(retryDelay);
-            return { success: true, message: `Retrying after ${retryDelay}ms`, retry: true };
-        });
-
-        this.recoveryStrategies.set('MQTT_CONNECTION_ERROR', async (error, context) => {
-            logger('🔄 Attempting MQTT recovery...', 'warn');
-            if (context.mqttManager) {
-                try {
-                    await context.mqttManager.connect();
-                    return { success: true, message: 'MQTT reconnected successfully' };
-                } catch (mqttError) {
-                    return { success: false, message: 'MQTT recovery failed', retry: true };
-                }
-            }
-            return { success: false, message: 'No MQTT manager available' };
-        });
-
-        this.recoveryStrategies.set('RATE_LIMITED', async (error, context) => {
-            logger('⏳ Rate limit detected, implementing backoff...', 'warn');
-            const backoffTime = error.retryAfter ? error.retryAfter * 1000 : 60000;
-            await this._delay(backoffTime);
-            return { success: true, message: `Rate limit backoff completed`, retry: true };
-        });
-    }
-
-    /**
-     * Setup user-friendly error messages
-     * @private
-     */
-    _setupUserFriendlyMessages() {
-        this.userFriendlyMessages.set('LOGIN_FAILED', 'Failed to login. Please check your credentials and try again.');
-        this.userFriendlyMessages.set('SESSION_EXPIRED', 'Your session has expired. Please login again.');
-        this.userFriendlyMessages.set('NETWORK_ERROR', 'Network connection issue. Please check your internet connection.');
-        this.userFriendlyMessages.set('RATE_LIMITED', 'You are sending messages too quickly. Please slow down.');
-        this.userFriendlyMessages.set('INVALID_THREAD_ID', 'Invalid chat/group ID provided.');
-        this.userFriendlyMessages.set('INVALID_USER_ID', 'Invalid user ID provided.');
-        this.userFriendlyMessages.set('MQTT_CONNECTION_ERROR', 'Real-time connection issue. Attempting to reconnect...');
-        this.userFriendlyMessages.set('FB_AUTH_ERROR', 'Facebook authentication error. Please re-login.');
-        this.userFriendlyMessages.set('UNKNOWN_ERROR', 'An unexpected error occurred. Please try again.');
-    }
-
-    /**
-     * Enhanced error processing
-     */
-    async handleError(error, context = {}) {
-        const processedError = this._processError(error);
-        
-        // Log the error
-        this._logError(processedError, context);
-        
-        // Attempt recovery if possible
-        let recoveryResult = null;
-        if (processedError.recoverable) {
-            recoveryResult = await this._attemptRecovery(processedError, context);
-        }
-
-        // Return processed error with recovery info
-        return {
-            error: processedError,
-            recovery: recoveryResult,
-            userMessage: this._getUserFriendlyMessage(processedError.code),
-            timestamp: new Date().toISOString()
-        };
-    }
-
-    /**
-     * Process raw error into structured format
-     * @private
-     */
-    _processError(error) {
-        let processedError;
-
-        if (error instanceof NexusError) {
-            processedError = error;
-        } else {
-            // Map common errors to structured format
-            const errorCode = this._mapErrorCode(error);
-            const isRecoverable = this._isRecoverable(errorCode);
-            
-            processedError = new NexusError(
-                error.message || 'Unknown error',
-                errorCode,
-                isRecoverable
-            );
-            processedError.originalError = error;
-        }
-
-        // Add additional context
-        processedError.stack = error.stack;
-        processedError.retryCount = (processedError.retryCount || 0);
-        
-        return processedError;
-    }
-
-    /**
-     * Map error message/code to structured code
-     * @private
-     */
-    _mapErrorCode(error) {
-        const message = error.message || '';
-        const code = error.code || '';
-        
-        // Check direct code mapping
-        if (this.errorMappings[code]) {
-            return this.errorMappings[code];
-        }
-        
-        // Check message content mapping
-        for (const [pattern, mappedCode] of Object.entries(this.errorMappings)) {
-            if (message.includes(pattern)) {
-                return mappedCode;
-            }
-        }
-        
-        // Check error type
-        if (error.name === 'ValidationError') return 'VALIDATION_ERROR';
-        if (error.name === 'TypeError') return 'TYPE_ERROR';
-        if (error.name === 'ReferenceError') return 'REFERENCE_ERROR';
-        
-        return 'UNKNOWN_ERROR';
-    }
-
-    /**
-     * Determine if error is recoverable
-     * @private
-     */
-    _isRecoverable(errorCode) {
-        const recoverableErrors = [
-            'NETWORK_ERROR',
-            'NETWORK_CONNECTION_RESET',
-            'NETWORK_CONNECTION_ABORTED',
-            'LOGIN_TIMEOUT',
-            'LOGIN_NETWORK_ERROR',
-            'MQTT_CONNECTION_ERROR',
-            'SESSION_EXPIRED',
-            'RATE_LIMITED'
-        ];
-        
-        return recoverableErrors.includes(errorCode);
-    }
-
-    /**
-     * Attempt error recovery
-     * @private
-     */
-    async _attemptRecovery(error, context) {
-        const strategy = this.recoveryStrategies.get(error.code);
-        
-        if (!strategy) {
-            return { success: false, message: 'No recovery strategy available' };
-        }
-
-        try {
-            logger(`🔄 Attempting recovery for ${error.code}...`, 'info');
-            const result = await strategy(error, context);
-            
-            if (result.success) {
-                logger(`✅ Recovery successful for ${error.code}`, 'info');
-            } else {
-                logger(`❌ Recovery failed for ${error.code}: ${result.message}`, 'warn');
-            }
-            
-            return result;
-        } catch (recoveryError) {
-            logger(`❌ Recovery strategy failed: ${recoveryError.message}`, 'error');
-            return { 
-                success: false, 
-                message: `Recovery strategy failed: ${recoveryError.message}` 
-            };
-        }
-    }
-
-    /**
-     * Log error with context
-     * @private
-     */
-    _logError(error, context) {
-        const errorEntry = {
-            timestamp: new Date().toISOString(),
-            code: error.code,
-            message: error.message,
-            recoverable: error.recoverable,
-            context: {
-                userID: context.userID,
-                threadID: context.threadID,
-                action: context.action,
-                retryCount: error.retryCount
-            },
-            stack: error.stack
-        };
-
-        // Add to memory log
-        this.errorLog.push(errorEntry);
-        if (this.errorLog.length > this.maxLogSize) {
-            this.errorLog.shift();
-        }
-
-        // Update error counts
-        const count = this.errorCounts.get(error.code) || 0;
-        this.errorCounts.set(error.code, count + 1);
-
-        // Log to console with appropriate level
-        const logLevel = error.recoverable ? 'warn' : 'error';
-        logger(`[${error.code}] ${error.message}`, logLevel);
-
-        // Save to file if critical
-        if (!error.recoverable) {
-            this._saveErrorToFile(errorEntry);
-        }
-    }
-
-    /**
-     * Save critical errors to file
-     * @private
-     */
-    _saveErrorToFile(errorEntry) {
-        try {
-            const logDir = path.join(__dirname, '../../logs');
-            if (!fs.existsSync(logDir)) {
-                fs.mkdirSync(logDir, { recursive: true });
-            }
-
-            const logFile = path.join(logDir, 'errors.log');
-            const logLine = `${errorEntry.timestamp} [${errorEntry.code}] ${errorEntry.message}\n`;
-            
-            fs.appendFileSync(logFile, logLine, 'utf8');
-        } catch (fileError) {
-            logger(`Failed to save error to file: ${fileError.message}`, 'warn');
-        }
-    }
-
-    /**
-     * Get user-friendly error message
-     * @private
-     */
-    _getUserFriendlyMessage(errorCode) {
-        return this.userFriendlyMessages.get(errorCode) || 
-               this.userFriendlyMessages.get('UNKNOWN_ERROR');
-    }
-
-    /**
-     * Utility delay function
-     * @private
-     */
-    _delay(ms) {
-        return new Promise(resolve => setTimeout(resolve, ms));
-    }
-
-    /**
-     * Get error statistics
-     */
-    getErrorStats() {
-        const totalErrors = this.errorLog.length;
-        const errorsByCode = Object.fromEntries(this.errorCounts);
-        const recentErrors = this.errorLog.slice(-10);
-        
-        return {
-            totalErrors,
-            errorsByCode,
-            recentErrors,
-            memoryLogSize: this.errorLog.length
-        };
-    }
-
-    /**
-     * Clear error log
-     */
-    clearErrorLog() {
-        this.errorLog = [];
-        this.errorCounts.clear();
-        logger('🧹 Error log cleared', 'info');
-    }
-
-    /**
-     * Add custom recovery strategy
-     */
-    addRecoveryStrategy(errorCode, strategy) {
-        if (typeof strategy !== 'function') {
-            throw new ValidationError('Recovery strategy must be a function');
-        }
-        
-        this.recoveryStrategies.set(errorCode, strategy);
-        logger(`✅ Added recovery strategy for ${errorCode}`, 'info');
-    }
-
-    /**
-     * Add custom user-friendly message
-     */
-    addUserFriendlyMessage(errorCode, message) {
-        this.userFriendlyMessages.set(errorCode, message);
-        logger(`✅ Added user-friendly message for ${errorCode}`, 'info');
-    }
-}
-
-// Create singleton instance
 const errorHandler = new ErrorHandler();
 
 /**
@@ -671,11 +304,6 @@ function wrapWithErrorHandling(fn, context = {}) {
 }
 
 module.exports = {
-    NexusError,
-    LoginError,
-    NetworkError,
-    ValidationError,
-    RateLimitError,
     ErrorHandler,
     errorHandler,
     wrapWithErrorHandling

package/lib/performance/PerformanceOptimizer.js

@@ -70,8 +70,6 @@ class PerformanceOptimizer {
         this.metricsInterval = setInterval(() => {
             this._collectMetrics();
         }, 60 * 1000);
-
-        logger('📊 Performance monitoring started', 'info');
     }
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-fca",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "A modern, safe, and advanced Facebook Chat API for Node.js with enhanced performance, smart caching, and TypeScript support. Messenger automation, bots, and integrations made easy.",
   "main": "index.js",
   "repository": {

package/src/listenMqtt.js

@@ -234,7 +234,7 @@ function listenMqtt(defaultFuncs, api, ctx, globalCallback) {
   });
   mqttClient.on("connect", function () {
     if (process.env.OnStatus === undefined) {
-      logger("Nexus-FCA premium features loaded", "info");
+      logger("Nexus-FCA premium features works only with Nexus-Bot framework(Kidding)", "info");
       process.env.OnStatus = true;
     }
     topics.forEach((topicsub) => mqttClient.subscribe(topicsub));