fca-riyad 37.0.0

package/README.md

@@ -0,0 +1,410 @@
+<div align="center">
+
+# 💬 fca-riyad
+
+**Unofficial Facebook Messenger Bot API for Node.js**
+NEXCA Engine · Signal Protocol E2EE · sessionGuard · 90+ API Methods · Zero TypeScript
+
+[![npm](https://img.shields.io/npm/v/fca-riyad?color=blue)](https://www.npmjs.com/package/fca-riyad)
+[![license](https://img.shields.io/badge/license-MIT-green)](./LICENSE-MIT)
+[![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
+
+[Features](#-features) • [Installation](#-installation) • [Quick Start](#-quick-start) • [E2EE](#-e2ee--encrypted-conversations) • [sessionGuard](#-sessionguard) • [sendBroadcast](#-sendbroadcast) • [API Reference](#-api-reference)
+
+</div>
+
+---
+
+## ⚡ Why fca-riyad?
+
+- ✅ **NEXCA Engine** — nexca MQTT, E2EE, sessionGuard core integrated
+- ✅ **Signal Protocol E2EE** — Facebook real encrypted conversations support
+- ✅ **sessionGuard** — appstate corruption and silent logout protection, auto-backup
+- ✅ **sendBroadcast** — rate-limited multi-thread broadcast
+- ✅ **Fixed MQTT subscribe race condition** — no more "Connection refused: No subscription existed"
+- ✅ **`isActiveClient()` guard** — stale MQTT client events no longer processed
+- ✅ **`connectTimeout` extended** — no premature logout on slow networks
+- ✅ **autoReconnect** — auto-reconnect on connection drop
+- ✅ **GoatBot compatible** — all API signatures unchanged (`threadID` optional etc.)
+- ✅ **90+ API methods** — sendMessage, editMessage, setMessageReaction, getThreadInfo and more
+
+---
+
+## ✨ Features
+
+- ✅ Full Messenger API — messages, reactions, attachments, stickers, polls, pins
+- ✅ NEXCA MQTT — stable connection, autoReconnect, jitter, isActiveClient guard
+- ✅ E2EE — Signal Protocol encrypted threads (connectE2EE, listenE2EE, e2ee.*)
+- ✅ sessionGuard — appstate auto-save, corruption guard, .bak backup
+- ✅ sendBroadcast — parallel/sequential multi-thread sending with rate limit
+- ✅ MessengerBot — Discord.js/Telegraf style (.command, .hears, .launch)
+- ✅ createFcaClient — namespaced facade (client.messages, client.threads etc.)
+- ✅ GoatBot / Mirai compatible — drop-in replacement
+
+---
+
+## 📦 Installation
+
+```bash
+npm install fca-riyad
+```
+
+Node.js >= 18 required.
+
+---
+
+## 🚀 Quick Start
+
+### Classic (GoatBot compatible)
+
+```javascript
+const login = require("fca-riyad");
+
+login({ appState: require("./account.json") }, { listenEvents: true }, (err, api) => {
+  if (err) throw err;
+
+  api.sessionGuard("./account.json", {
+    interval: 3 * 60 * 1000,
+    debounce: 30 * 1000
+  });
+
+  api.listenMqtt((err, event) => {
+    if (err) throw err;
+    if (event.type === "message") api.sendMessage(event.body, event.threadID);
+  });
+});
+```
+
+### With E2EE (regular + encrypted threads)
+
+```javascript
+login({ appState: require("./account.json") }, { listenEvents: true }, async (err, api) => {
+  if (err) throw err;
+
+  api.sessionGuard("./account.json");
+  await api.connectE2EE();
+
+  api.listenE2EE((err, event) => {
+    if (err) throw err;
+    if (event.type === "message") {
+      if (event.isE2EE) {
+        api.e2ee.sendMessage(event.threadID, "Got your encrypted message!");
+      } else {
+        api.sendMessage("Got it!", event.threadID);
+      }
+    }
+  });
+});
+```
+
+### GoatBot login.js
+
+```javascript
+const login = require("fca-riyad");
+
+login({ appState }, options, async (err, api) => {
+  if (err) return;
+
+  api.sessionGuard(path.join(process.cwd(), "account.txt"), {
+    interval: 3 * 60 * 1000,
+    debounce: 30 * 1000
+  });
+
+  try { await api.connectE2EE(); } catch (e) {}
+
+  api.listenMqtt(callback);
+});
+```
+
+---
+
+## 🔐 E2EE — Encrypted Conversations
+
+Uses Facebook's real Signal Protocol infrastructure — same as the official Messenger app.
+
+### Setup
+
+```javascript
+await api.connectE2EE();
+// Auto-creates .nexca/e2ee_device.json
+
+console.log(api.e2ee.isConnected()); // true
+```
+
+### Listen (regular + E2EE combined)
+
+```javascript
+api.listenE2EE((err, event) => {
+  if (event.type === "message") {
+    if (event.isE2EE) {
+      api.e2ee.sendMessage(event.threadID, "Encrypted reply!");
+    } else {
+      api.sendMessage("Normal reply!", event.threadID);
+    }
+  }
+});
+```
+
+### E2EE Methods
+
+```javascript
+await api.e2ee.sendMessage(threadID, "Hello!");
+await api.e2ee.sendMessage(threadID, { body: "Photo!", attachment: fs.createReadStream("photo.jpg") });
+await api.e2ee.sendReaction(threadID, messageID, "❤️");
+await api.e2ee.sendTyping(threadID, true);
+await api.e2ee.unsendMessage(messageID, threadID);
+await api.e2ee.editMessage(threadID, messageID, "Updated!");
+api.e2ee.isConnected();
+await api.e2ee.disconnect();
+```
+
+---
+
+## 🛡️ sessionGuard
+
+Protects your appstate from corruption and silent logouts.
+
+```javascript
+api.sessionGuard("./account.json");
+
+// Custom timing
+api.sessionGuard("./account.json", {
+  interval: 3 * 60 * 1000,
+  debounce: 30 * 1000
+});
+```
+
+What it does:
+- Auto-saves appstate every N minutes
+- Saves after every successful sendMessage (debounced)
+- Corruption guard — never overwrites a larger appstate with a smaller one
+- Auto-backup — writes `.bak` before every overwrite
+
+```javascript
+api.saveSession();           // force save now
+api.restoreSessionBackup();  // restore from .bak
+api.stopSessionGuard();      // stop the timer
+```
+
+---
+
+## 📡 sendBroadcast
+
+Rate-limited multi-thread broadcast.
+
+```javascript
+const result = await api.sendBroadcast(
+  "Hello everyone!",
+  ["THREAD_1", "THREAD_2", "THREAD_3"],
+  {
+    delay: 2000,
+    parallel: 2,
+    onEach: (err, info, id) => {
+      console.log(err ? "Failed: " + id : "Sent: " + id);
+    }
+  }
+);
+console.log(result.sent.length + "/" + result.total + " delivered");
+```
+
+---
+
+## 🤖 MessengerBot
+
+Discord.js/Telegraf style high-level bot class.
+
+```javascript
+const { createMessengerBot } = require("fca-riyad");
+
+const bot = await createMessengerBot(
+  { appState: require("./account.json") },
+  { commandPrefix: "/", stopOnSignals: true }
+);
+
+bot.command("ping", async ctx => await ctx.replyAsync("pong 🏓"));
+bot.hears(/hello/i, async ctx => await ctx.replyAsync("Hi! 👋"));
+bot.on("messageCreate", event => console.log(event.body));
+
+await bot.launch({ stopOnSignals: true });
+```
+
+---
+
+## 🎯 createFcaClient
+
+Namespaced facade grouping all API methods by domain.
+
+```javascript
+const { createFcaClient } = require("fca-riyad");
+const client = createFcaClient(api);
+
+await client.messages.send("Hello!", threadID);
+await client.messages.react("❤️", messageID, threadID);
+await client.threads.getInfo(threadID);
+await client.users.getInfo(userID);
+await client.account.refreshDtsg();
+```
+
+---
+
+## 📖 API Reference
+
+### Sending Messages
+
+```javascript
+api.sendMessage("Hello!", threadID);
+api.sendMessage({ body: "Photo!", attachment: fs.createReadStream("photo.jpg") }, threadID);
+api.sendMessage({ body: "Hey @John", mentions: [{ id: "uid", tag: "@John", fromIndex: 4 }] }, threadID);
+api.sendMessage({ sticker: "369239263222822" }, threadID);
+api.sendMessage({ location: { latitude: 23.8, longitude: 90.4, current: true } }, threadID);
+api.sendBroadcast("msg", ["tid1", "tid2"], { delay: 2000 });
+api.sendGif("https://media.giphy.com/xyz.gif", threadID);
+api.sendLocation(23.8, 90.4, threadID);
+api.sendImage("./photo.jpg", threadID, "caption");
+api.sendVideo("./video.mp4", threadID);
+api.sendAudio("./voice.ogg", threadID);
+api.sendFile("./doc.pdf", threadID);
+api.shareLink("https://github.com", threadID, "Check this!");
+api.shareContact("Meet my friend!", userID, threadID);
+```
+
+### Message Actions
+
+```javascript
+api.editMessage("Updated text", messageID);
+api.unsendMessage(messageID);
+api.deleteMessage([messageID]);
+api.setMessageReaction("😍", messageID, threadID);  // threadID optional
+api.setMessageReaction("", messageID);               // remove reaction
+api.getMessage(threadID, messageID);
+api.forwardAttachment(attachmentID, [userID]);
+api.uploadAttachment([fs.createReadStream("photo.jpg")]);
+```
+
+### Read Receipts & Typing
+
+```javascript
+api.markAsRead(threadID);
+api.markAsReadAll();
+api.markAsDelivered(threadID, messageID);
+api.markAsSeen();
+api.sendTypingIndicator(threadID, true);
+```
+
+### Thread Management
+
+```javascript
+api.getThreadInfo(threadID);
+api.getThreadList(10, null, ["INBOX"]);
+api.getThreadHistory(threadID, 20);
+api.createGroup("Hey!", ["uid1", "uid2"]);
+api.deleteThread(threadID);
+api.muteThread(threadID, 3600);
+api.changeArchivedStatus(threadID, true);
+api.handleMessageRequest(threadID, true);
+api.searchForThread("query");
+```
+
+### Thread Customization
+
+```javascript
+api.setTitle("New Name", threadID);
+api.changeThreadColor("#0084FF", threadID);
+api.changeThreadEmoji("🔥", threadID);
+api.changeNickname("The Boss", threadID, userID);
+api.changeGroupImage(fs.createReadStream("group.jpg"), threadID);
+api.changeAdminStatus(threadID, userID, true);
+api.addUserToGroup(userID, threadID);
+api.removeUserFromGroup(userID, threadID);
+api.createPoll("Question?", threadID, { "Yes": false, "No": false });
+api.pinMessage(messageID, threadID);
+api.unpinMessage(messageID, threadID);
+```
+
+### User Info
+
+```javascript
+api.getUserInfo(userID);
+api.getUserID("John Doe", callback);
+api.getUID("https://facebook.com/zuck");
+api.getFriendsList();
+api.getAvatarUser(userID);
+api.getProfileInfo(userID);
+api.getPublicData(userID);
+api.sendFriendRequest(userID);
+api.handleFriendRequest(userID, true);
+api.changeBlockedStatus(userID, true);
+api.followUser(userID);
+api.unfollowUser(userID);
+api.unfriend(userID);
+```
+
+### Social
+
+```javascript
+api.reactToPost(postID, "love");
+api.reactToComment(commentID, "haha");
+api.postComment(postID, "Great post!");
+api.sharePost(postID, "Check this!");
+```
+
+### Account & Config
+
+```javascript
+api.getCurrentUserID();
+api.getAppState();
+api.setOptions({ listenTyping: true });
+api.logout();
+api.refreshFb_dtsg();
+api.addExternalModule("myFunc", (defaultFuncs, api, ctx) => {
+  return function(text, threadID) {
+    return api.sendMessage("[BOT] " + text, threadID);
+  };
+});
+```
+
+### HTTP Utilities
+
+```javascript
+api.httpGet(url, params, callback);
+api.httpPost(url, form, callback);
+api.httpPostFormData(url, form, callback);
+api.uploadImageToImgbb(imageUrl);
+```
+
+---
+
+## 📋 Login Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `selfListen` | boolean | false | Receive your own sent messages |
+| `listenEvents` | boolean | true | Receive thread/group events |
+| `listenTyping` | boolean | false | Receive typing indicator events |
+| `updatePresence` | boolean | false | Receive online/offline presence events |
+| `autoMarkDelivery` | boolean | false | Auto-mark incoming messages as delivered |
+| `autoMarkRead` | boolean | false | Auto-mark threads as read |
+| `autoReconnect` | boolean | true | Auto-reconnect MQTT on disconnect |
+| `online` | boolean | false | Appear as online to others |
+| `emitReady` | boolean | false | Emit ready event when MQTT connected |
+| `proxy` | string | — | HTTP proxy URL |
+| `userAgent` | string | Safari UA | Override HTTP User-Agent |
+
+---
+
+## 📄 License
+
+MIT License
+
+**fca-riyad** by [Riyad (Mohammad Akash)](https://github.com/Riyad)
+NEXCA Engine by [Deku](https://github.com/dekuzxc) — MIT License
+
+> Unauthorized copying or redistribution without credit is prohibited.
+
+---
+
+<div align="center">
+
+Made with ❤️ by Riyad
+
+</div>

package/func/checkUpdate.js

@@ -0,0 +1,7 @@
+"use strict";
+// Auto-update disabled in fca-riyad
+function checkAndUpdateVersion(callback) {
+  if (typeof callback === "function") callback(null);
+  return Promise.resolve();
+}
+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-UNO ] > ${text}`)) + "\n");
+    return;
+  }
+  process.stderr.write(chalk.bold(co(`\r[ ${s.toUpperCase()} ] > ${text}`)) + "\n");
+};