sagor-fca 0.0.6 → 0.0.7

package/README.md

@@ -2,7 +2,7 @@
 
 <div align="center">
 
-**Unofficial Facebook Chat API for Node.js**
+**Unofficial Facebook Chat API for Node.js - The Ultimate Edition**
 
 </div>
 
@@ -52,67 +52,22 @@ If you do not agree with this policy, you are free to fork the repository and ma
 
 This **sagor-fca** extends the base functionality with advanced features for a more robust and versatile Facebook automation experience:
 
-**Authentication**
-- Cookie array login (`appState`) — the safest method for long-running bots
-- Email/password login with TOTP/2FA support
-- Session fingerprint locking — User-Agent, Sec-Ch-Ua, locale, timezone locked per session to prevent detection
-- AppState auto-backup and restore on restart
-
-**Real-time Messaging**
-- MQTT and HTTP messaging with automatic protocol fallback
-- Send text, attachments, stickers, emoji, mentions, and location
-- Message editing, unsend, forward, and delete
-- Message reactions via HTTP and MQTT
-- Pin/unpin messages, list pinned messages
-
-**Anti-Suspension System**
-- Circuit breaker — halts activity after repeated suspension signals, resumes after cooldown
-- 60+ suspension signal patterns: checkpoints, spam flags, rate limits, identity verification, policy violations, session expiry, and more
-- Adaptive per-thread delay that increases with session volume
-- Hourly and daily message volume limits with automatic warning pauses
-- Warmup mode for fresh sessions — gradually increases allowed message rate
-- Humanized typing simulation before every send
-- Randomized request intervals and jitter to avoid periodicity detection
-- Session fingerprint locking to maintain consistent browser identity
-- PostSafe guard: detects auth failures and checkpoint responses in real-time
-- MQTT watchdog: detects stale connections and forces clean reconnect
-
-**Stability & Reliability**
-- MQTT auto-reconnect with exponential backoff and jitter
-- Auto re-login using refreshed AppState when session expires
-- TokenRefreshManager with randomized intervals to keep sessions alive
-- Sliding-window rate limiter with per-endpoint tracking
-- SQLite-backed thread and user data cache for fast lookups
-
-**Thread & Group Management**
-- Get thread info, history, pictures, and lists
-- Create groups, add/remove members, change admin status
-- Update group image, name, color, emoji
-- Archive, mute, delete threads
-- Create polls, manage notes and rules
-- Search threads by name, handle message requests
-
-**User & Friends**
-- Get user info (basic and extended), resolve user IDs
-- Get full friends list, send/cancel friend requests, unfriend, block/unblock
-
-**Social**
-- Comment on posts, share posts, follow/unfollow users
-
-**Themes & Stickers**
-- Browse 90+ Messenger themes, apply themes via MQTT
-- Generate AI-powered themes with text prompts
-- Search stickers, browse packs, add packs, get AI stickers
-
-**E2EE (Opt-In)**
-- Application-layer end-to-end encryption for DMs using X25519 + HKDF + AES-256-GCM
-
-**Monitoring**
-- `api.getHealthStatus()` — MQTT status, token refresh stats, rate limiter metrics
-- Built-in `ProductionMonitor` for request/error/performance telemetry
-
-**Proxy Support**
-- Full proxy support via the `proxy` login option
+| Category | Feature | Description |
+| :--- | :--- | :--- |
+| **Core Messenger** | Full Messenger API | Send messages, files, stickers, and more. |
+| | Real-time Events | Listen to messages, reactions, and thread events. |
+| | User Account Support | Works with personal Facebook accounts (not just Pages). |
+| | AppState Support | Save login state to avoid re-authentication. |
+| | MQTT Protocol | Real-time messaging via MQTT. |
+| | TypeScript Support | Includes TypeScript definitions. |
+| **Story Interaction** | `getStories`, `reactStory`, `viewStory` | Friends' stories can be viewed, reacted to, and marked as 'Seen'. |
+| **Group Management** | `getGroupJoinRequests`, `handleGroupJoinRequest` | View and manage pending group join requests. |
+| **Feed Interaction** | `getPostInfo`, `commentOnPost` | Retrieve detailed information about a specific post and comment on it. |
+| **Advanced Messaging** | `sendVoiceMessage` | Send audio files as native voice notes. |
+| **Reels Interaction** | `getReels`, `reactReel` | Fetch and react to Facebook Reels. |
+| **Professional Mode** | `getProfessionalInfo`, `toggleProfessionalMode` | View professional profile information and toggle Professional Mode. |
+| **Security & Anti-Ban** | Request Throttling | Configurable delay between requests to avoid detection. |
+| | User-Agent Rotation | Automatic rotation of User-Agents for each request. |
 
 ---
 
@@ -158,7 +113,7 @@ login({ appState: [] }, (err, api) => {
   }
 
   const yourID = "000000000000000"; // Replace with actual Facebook ID
-  const msg = "Hello from Sagor-fca! 👋";
+  const msg = "Hello from sagor-fca! 👋";
 
   api.sendMessage(msg, yourID, (err) => {
     if (err) console.error("Message Sending Error:", err);
@@ -169,170 +124,12 @@ login({ appState: [] }, (err, api) => {
 
 ---
 
-## Anti-Suspension Configuration
-
-The anti-suspension system is active by default. You can tune it through login options:
-
-```js
-login({ appState }, {
-  autoReconnect: true,
-  listenEvents: true,
-  autoMarkRead: true,
-  simulateTyping: true,       // humanized typing delays before send
-  randomUserAgent: true,      // rotate user agent on each session
-  persona: "desktop",         // "desktop" or "android"
-  maxConcurrentRequests: 5,   // max parallel HTTP requests
-  maxRequestsPerMinute: 50,   // sliding-window rate cap
-  requestCooldownMs: 60000,   // per-endpoint cooldown duration
-  errorCacheTtlMs: 300000     // how long to suppress repeated errors
-}, (err, api) => {
-  if (err) throw err;
-
-  console.log(api.getHealthStatus());
-});
-```
+## 📚 API Reference
 
-
-## API Reference
-
-### Authentication
-| Method | Description |
-|---|---|
-| `login(credentials, options, callback)` | Log in and receive the API object |
-| `api.logout()` | End the session |
-| `api.getAppState()` | Get current session cookies |
-| `api.getCurrentUserID()` | Get logged-in user ID |
-
-### Messaging
-| Method | Description |
-|---|---|
-| `api.sendMessage(msg, threadID)` | Send (HTTP + MQTT fallback) |
-| `api.sendMessageMqtt(msg, threadID)` | Send over MQTT |
-| `api.editMessage(text, messageID)` | Edit a message |
-| `api.unsendMessage(messageID, threadID)` | Retract a message |
-| `api.forwardMessage(messageID, threadID)` | Forward a message |
-| `api.deleteMessage(messageIDs)` | Delete locally |
-| `api.shareContact(senderID, threadID)` | Share a contact card |
-
-### Reactions & Status
-| Method | Description |
-|---|---|
-| `api.setMessageReaction(reaction, messageID)` | React via HTTP |
-| `api.setMessageReactionMqtt(reaction, messageID, threadID)` | React via MQTT |
-| `api.sendTypingIndicator(isTyping, threadID)` | Show/hide typing |
-| `api.markAsRead(threadID)` | Mark thread as read |
-| `api.markAsReadAll()` | Mark all threads as read |
-| `api.markAsSeen()` | Mark as seen |
-| `api.markAsDelivered(threadID, messageID)` | Mark as delivered |
-
-### Threads
-| Method | Description |
-|---|---|
-| `api.getThreadInfo(threadID)` | Thread metadata |
-| `api.getThreadList(limit, timestamp, tags)` | List threads |
-| `api.getThreadHistory(threadID, amount, timestamp)` | Message history |
-| `api.getThreadPictures(threadID, offset, limit)` | Thread images |
-| `api.searchForThread(name)` | Search by name |
-| `api.createNewGroup(participantIDs, name?)` | Create group |
-| `api.deleteThread(threadID)` | Delete thread |
-| `api.muteThread(threadID, muteSeconds)` | Mute thread |
-| `api.changeArchivedStatus(threadID, archive)` | Archive/unarchive |
-| `api.pinMessage(action, threadID, messageID?)` | Pin/unpin/list |
-| `api.createPoll(title, threadID, options?)` | Create poll |
-| `api.handleMessageRequest(threadID, accept)` | Accept/decline |
-
-### Group Admin
-| Method | Description |
-|---|---|
-| `api.addUserToGroup(userID, threadID)` | Add member |
-| `api.removeUserFromGroup(userID, threadID)` | Remove member |
-| `api.changeAdminStatus(threadID, userID, isAdmin)` | Promote/demote |
-| `api.changeGroupImage(image, threadID)` | Group photo |
-| `api.gcname(name, threadID)` | Rename group |
-
-### Users
-| Method | Description |
-|---|---|
-| `api.getUserInfo(id)` | Basic user info |
-| `api.getUserInfoV2(id)` | Extended user info |
-| `api.getUserID(name)` | Resolve name to ID |
-| `api.getFriendsList()` | Friends list |
-| `api.getBotInfo()` | Bot account info |
-
-### Themes & Customization
-| Method | Description |
-|---|---|
-| `api.getTheme(threadID)` | List available themes |
-| `api.getThemeInfo(threadID)` | Current theme |
-| `api.setThreadThemeMqtt(threadID, themeID)` | Apply theme |
-| `api.createAITheme(prompt)` | AI theme |
-| `api.changeThreadColor(color, threadID)` | Thread color |
-| `api.changeThreadEmoji(emoji, threadID)` | Thread emoji |
-| `api.nickname(nickname, threadID, participantID)` | Set nickname |
-| `api.emoji(emoji, threadID)` | Thread emoji shorthand |
-
-### Stickers
-| Method | Description |
-|---|---|
-| `api.stickers.search(query)` | Search stickers |
-| `api.stickers.listPacks()` | Installed packs |
-| `api.stickers.getStorePacks()` | Sticker store |
-| `api.stickers.addPack(packID)` | Add pack |
-| `api.stickers.getStickersInPack(packID)` | Stickers in pack |
-| `api.stickers.getAiStickers(options?)` | AI stickers |
-
-### E2EE
-| Method | Description |
-|---|---|
-| `api.e2ee.enable()` | Enable E2EE |
-| `api.e2ee.disable()` | Disable E2EE |
-| `api.e2ee.getPublicKey()` | Get public key |
-| `api.e2ee.setPeerKey(threadID, key)` | Set peer key |
-| `api.e2ee.hasPeer(threadID)` | Has peer key |
-| `api.e2ee.clearPeerKey(threadID)` | Remove peer key |
-
-### Social
-| Method | Description |
-|---|---|
-| `api.comment(msg, postID)` | Comment on post |
-| `api.share(postID)` | Share post |
-| `api.follow(userID, follow)` | Follow/unfollow |
-| `api.unfriend(userID)` | Unfriend |
-| `api.changeBlockedStatus(userID, block)` | Block/unblock |
-
-### Health
-| Method | Description |
-|---|---|
-| `api.getHealthStatus()` | MQTT, token, rate limiter stats |
+Detailed documentation for each API endpoint, including parameters and return types, can be found within the `src/api` directory of this repository. Key modules include `action`, `messaging`, `threads`, `users`, `stories`, `groups`, `feed`, `reels`, and `professional`.
 
 ---
 
-## Login Options
-
-| Option | Type | Default | Description |
-|---|---|---|---|
-| `online` | `boolean` | `true` | Appear online |
-| `selfListen` | `boolean` | `false` | Receive own messages |
-| `listenEvents` | `boolean` | `true` | Receive thread events |
-| `listenTyping` | `boolean` | `false` | Receive typing events |
-| `updatePresence` | `boolean` | `false` | Broadcast presence |
-| `autoMarkDelivery` | `boolean` | `false` | Auto-mark delivered |
-| `autoMarkRead` | `boolean` | `true` | Auto-mark read |
-| `autoReconnect` | `boolean` | `true` | MQTT auto-reconnect |
-| `simulateTyping` | `boolean` | `true` | Humanized typing delays |
-| `randomUserAgent` | `boolean` | `false` | Random User-Agent |
-| `persona` | `"desktop"\|"android"` | `"desktop"` | Browser persona |
-| `proxy` | `string` | — | Proxy URL |
-| `forceLogin` | `boolean` | `false` | Force fresh login |
-| `maxConcurrentRequests` | `number` | `5` | Max parallel requests |
-| `maxRequestsPerMinute` | `number` | `50` | Rate cap per minute |
-| `requestCooldownMs` | `number` | `60000` | Endpoint cooldown |
-| `errorCacheTtlMs` | `number` | `300000` | Error suppression TTL |
-| `stealthMode` | `boolean` | `false` | Extra stealth headers |
-
----
-
-
 ## 💾 AppState Management
 
 AppState is crucial for maintaining login sessions without re-authenticating with email/password. It helps prevent frequent logouts and reduces the risk of account flags.

package/func/checkUpdate.js

@@ -0,0 +1,16 @@
+const logger = require("./logger");
+
+async function _checkAndUpdateVersionImpl() {
+  logger("Auto-update is disabled for fca-unofficial-updated to maintain custom fixes.", "info");
+  return;
+}
+
+function checkAndUpdateVersion(callback) {
+  if (typeof callback === "function") {
+    _checkAndUpdateVersionImpl().then(() => callback(null)).catch(err => callback(err));
+    return;
+  }
+  return _checkAndUpdateVersionImpl();
+}
+
+module.exports = { checkAndUpdateVersion };

package/func/logAdapter.js

@@ -0,0 +1,33 @@
+const logger = require("./logger");
+
+function formatArgs(args) {
+  const [prefix, msg] = args;
+
+  // Single argument: log as-is
+  if (msg === undefined) {
+    if (prefix instanceof Error) {
+      return prefix.stack || prefix.message || String(prefix);
+    }
+    return String(prefix);
+  }
+
+  // Two arguments: mimic npmlog("tag", message)
+  const tag = prefix == null ? "" : String(prefix);
+  if (msg instanceof Error) {
+    const base = msg.message || String(msg);
+    return tag ? `${tag}: ${base}` : base;
+  }
+  const text = msg == null ? "" : String(msg);
+  return tag ? `${tag}: ${text}` : text;
+}
+
+const log = {
+  info: (...args) => logger(formatArgs(args), "info"),
+  warn: (...args) => logger(formatArgs(args), "warn"),
+  error: (...args) => logger(formatArgs(args), "error"),
+  verbose: (...args) => logger(formatArgs(args), "info"),
+  silly: (...args) => logger(formatArgs(args), "info")
+};
+
+module.exports = log;
+

package/func/logger.js

@@ -0,0 +1,48 @@
+const chalk = require("chalk");
+const gradient = require("gradient-string");
+
+const themes = [
+  "blue", "dream2", "dream", "fiery", "rainbow", "pastel", "cristal", "red", "aqua", "pink", "retro", "sunlight", "teen", "summer", "flower", "ghost", "hacker"
+];
+
+function buildGradient(name) {
+  const t = String(name || "").toLowerCase();
+  if (t === "blue") return gradient([{ color: "#1affa3", pos: 0.2 }, { color: "cyan", pos: 0.4 }, { color: "pink", pos: 0.6 }, { color: "cyan", pos: 0.8 }, { color: "#1affa3", pos: 1 }]);
+  if (t === "dream2") return gradient("blue", "pink");
+  if (t === "dream") return gradient([{ color: "blue", pos: 0.2 }, { color: "pink", pos: 0.3 }, { color: "gold", pos: 0.6 }, { color: "pink", pos: 0.8 }, { color: "blue", pos: 1 }]);
+  if (t === "fiery") return gradient("#fc2803", "#fc6f03", "#fcba03");
+  if (t === "rainbow") return gradient.rainbow;
+  if (t === "pastel") return gradient.pastel;
+  if (t === "cristal") return gradient.cristal;
+  if (t === "red") return gradient("red", "orange");
+  if (t === "aqua") return gradient("#0030ff", "#4e6cf2");
+  if (t === "pink") return gradient("#d94fff", "purple");
+  if (t === "retro") return gradient.retro;
+  if (t === "sunlight") return gradient("orange", "#ffff00", "#ffe600");
+  if (t === "teen") return gradient.teen;
+  if (t === "summer") return gradient.summer;
+  if (t === "flower") return gradient("blue", "purple", "yellow", "#81ff6e");
+  if (t === "ghost") return gradient.mind;
+  if (t === "hacker") return gradient("#47a127", "#0eed19", "#27f231");
+  return gradient("#243aff", "#4687f0", "#5800d4");
+}
+
+const themeName = themes[Math.floor(Math.random() * themes.length)];
+const co = buildGradient(themeName);
+
+module.exports = (text, type) => {
+  const s = String(type || "info").toLowerCase();
+  if (s === "warn") {
+    process.stderr.write(co(`\r[ FCA-WARN ] > ${text}`) + "\n");
+    return;
+  }
+  if (s === "error") {
+    process.stderr.write(chalk.bold.hex("#ff0000")(`\r[ FCA-ERROR ]`) + ` > ${text}\n`);
+    return;
+  }
+  if (s === "info") {
+    process.stderr.write(chalk.bold(co(`\r[ FCA-SAGOR ] > ${text}`)) + "\n");
+    return;
+  }
+  process.stderr.write(chalk.bold(co(`\r[ ${s.toUpperCase()} ] > ${text}`)) + "\n");
+};

package/func/utils.js

@@ -0,0 +1,5 @@
+module.exports = {
+  sleep: function(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+  }
+};