sagor-fca 0.0.10 → 0.0.11

package/func/checkUpdate.js

@@ -3,7 +3,7 @@ const fs = require("fs");
 const path = require("path");
 const { exec } = require("child_process");
 const https = require("https");
-const pkgName = "sagor-nx-fca";
+const pkgName = "@dongdev/fca-unofficial";
 
 let axios = null;
 try {

package/index.d.ts

@@ -1,4 +1,4 @@
-declare module 'sagor-nx-fca' {
+declare module '@dongdev/fca-unofficial' {
   import type EventEmitter from "events";
   import type { Duplex, Readable, Transform } from "stream";
 

package/module/loginHelper.js

@@ -989,7 +989,7 @@ function loginHelper(appState, Cookie, email, password, globalOptions, callback)
           }
         }
         if (html.includes("/checkpoint/block/?next")) {
-          logger("Appstate die, vui lòng thay cái mới!", "error");
+          logger("App state is dead, please replace it with a new one!", "error");
           throw new Error("Checkpoint");
         }
         
@@ -1087,7 +1087,7 @@ function loginHelper(appState, Cookie, email, password, globalOptions, callback)
               }
             }
           } else if (userID) {
-            logger(`ID người dùng: ${userID}`, "info");
+            logger(`User ID: ${userID}`, "info");
           }
         } catch (userDataErr) {
           // If error is from our validation, rethrow it
@@ -1120,7 +1120,7 @@ function loginHelper(appState, Cookie, email, password, globalOptions, callback)
               logger(`Database connection failed: ${errorMsg}`, "warn");
             }
           });
-        logger("FCA FIXED BY SAGOR 🍒", "info");
+        logger("fca fix/update by SaGor", "info");
         const emitter = new EventEmitter();
         const ctxMain = {
           userID,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sagor-fca",
-  "version": "0.0.10",
-  "description": "Unofficial Facebook Chat API for Node.js - Interact with Facebook Messenger programmatically",
+  "version": "0.0.11",
+  "description": "Unofficial Facebook Chat API for Node.js with Auto-Update System -  modify by SaGor ☄️",
   "main": "index.js",
   "types": "index.d.ts",
   "exports": {
@@ -11,13 +11,24 @@
       "types": "./index.d.ts"
     }
   },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "module/",
+    "func/",
+    "src/",
+    "DOCS.md",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "test": "mocha",
     "lint": "eslint ."
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/SAGOR-KINGx/fca-unofficial.git"
+    "url": "git+https://github.com/SAGOR-KINGx/sagor-fca.git"
   },
   "keywords": [
     "facebook",
@@ -32,7 +43,7 @@
     "facebook-messenger",
     "chatbot",
     "nodejs",
-    "fca"
+    "sagor-fca"
   ],
   "author": {
     "name": "SaGor",
@@ -46,9 +57,9 @@
   ],
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/SAGOR-KINGx/fca-unofficial/issues"
+    "url": "https://github.com/SAGOR-KINGx/sagor-fca/issues"
   },
-  "homepage": "https://github.com/SAGOR-KINGx/fca-unofficial#readme",
+  "homepage": "https://github.com/SAGOR-KINGx/sagor-fca#readme",
   "engines": {
     "node": ">=12.0.0"
   },

package/src/database/models/index.js

@@ -6,7 +6,7 @@ let sequelize = null;
 let models = {};
 
 try {
-  const databasePath = path.join(process.cwd(), "Sagor_Database");
+  const databasePath = path.join(process.cwd(), "SAGOR_DATA");
   if (!fs.existsSync(databasePath)) {
     fs.mkdirSync(databasePath, { recursive: true });
   }

package/.gitattributes

@@ -1,2 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto

package/.github/workflows/SaGor.yml

@@ -1,22 +0,0 @@
-name: "publish npm by SaGor"
-
-on: push
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v2
-        with:
-          node-version: 16
-          registry-url: https://registry.npmjs.org
-
-      - name: Publish to NPM
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-          

package/LICENSE-MIT

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Phạm Minh Đồng (DongDev)
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,524 +0,0 @@
-<div align="center">
-
-#   sagor-nx-fca
-
-**Unofficial Facebook Chat API for Node.js** - Interact with Facebook Messenger programmatically
-
-[Features](#-features) • [Installation](#-installation) • [Quick Start](#-quick-start) • [Documentation](#-documentation) • [Support](#-author--support)
-
-</div>
-
----
-
-## 📋 Table of Contents
-
-- [⚠️ Disclaimer & Support Policy](#️-disclaimer--support-policy)
-- [⚡ Why this fork?](#-why-this-fork)
-- [✨ Features](#-features)
-- [🔍 Introduction](#-introduction)
-- [📦 Installation](#-installation)
-- [🚀 Quick Start](#-quick-start)
-- [📝 Message Types](#-message-types)
-- [💾 AppState Management](#-appstate-management)
-- [🔄 Auto Login](#-auto-login)
-- [👂 Listening for Messages](#-listening-for-messages)
-- [🎯 API Quick Reference](#-api-quick-reference)
-- [📚 Documentation](#-documentation)
-- [🛠️ Projects Using This API](#️-projects-using-this-api)
-- [🤝 Contributing](#-contributing)
-- [📄 License](#-license)
-- [👨‍💻 Author & Support](#-author--support)
-
----
-
-## ⚠️ Disclaimer & Support Policy
-
-<div align="center">
-
-**READ THIS BEFORE USING OR OPENING AN ISSUE.**
-
-</div>
-
-This repository is provided **"AS IS"** and is entirely open-source. By using this project, you explicitly agree to the following terms:
-
-1. **Use at your own risk:** We are NOT responsible if your account gets banned for spammy activities (sending messages too fast, unsolicited mass messaging, suspicious URLs, or rapid login/logout).
-2. **No Spoon-Feeding:** This is a tool for developers. If you cannot read source code, navigate directories, or use basic search tools (`Ctrl + Shift + F`), you should not be using this library.
-3. **No Free Programming Lessons:** I maintain the core updates and security patches for the community for free. I do **not** provide free JavaScript/TypeScript tutorials, nor will I tell you exactly which line of code to edit for your specific bot.
-4. **Custom Features = Paid Service:** Brainpower and time are not free. If you need me to write custom logic, reverse-engineer specific endpoints, or provide 1-on-1 support for your personal project, **that is a paid service**.
-
-If you don't like this policy, feel free to fork the repository and maintain it yourself.
-
-**Recommendations to avoid bans:**
-
-- Use **Firefox** or the [fca.dongdev.id.vn](https://fca.dongdev.id.vn) flow to reduce logout issues (especially on iOS).
-- Prefer **AppState** over email/password when possible.
-- Use strict **rate limiting** in your bots.
-
----
-
-## ⚡ Why this fork?
-
-Unlike other outdated forks, `@sagor/fca-unofficial` is built with a focus on **real-world practicality and performance**:
-
-- **Performance First:** Stripped out legacy, redundant code that causes technical debt.
-- **Modernized Architecture:** Adapted to the latest Facebook backend structure.
-- **Clean Logic:** No messy wrappers. The codebase is straightforward and easy to navigate if you actually open the files.
-
----
-
-## ✨ Features
-
-- ✅ **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
-- ✅ **Active Development** - Regularly updated and maintained
-
----
-
-## 🔍 Introduction
-
-Facebook provides an [official API for chat bots](https://developers.facebook.com/docs/messenger-platform), but it's **only available for Facebook Pages**.
-
-`@sagor/fca-unofficial` is the API that allows you to automate chat functionalities on a **user account** by emulating the browser. This means:
-
-- 🔄 Making the exact same GET/POST requests as a browser
-- 🔐 Does not work with auth tokens
-- 📝 Requires Facebook account credentials (email/password) or AppState
-
-**Perfect for:**
-
-- 🤖 Building chatbots
-- 📱 Automating message responses
-- 🔔 Creating notification systems
-- 🎮 Building interactive games
-- 📊 Analytics and monitoring
-
----
-
-## 📦 Installation
-
-```bash
-npm install @sagor/fca-unofficial@latest
-```
-
-**Requirements:**
-
-- Node.js >= 12.0.0
-- Active Facebook account
-
----
-
-## 🚀 Quick Start
-
-### 1️⃣ Login and Simple Echo Bot
-
-```javascript
-const login = require("@sagor/fca-unofficial");
-
-login({ appState: [] }, (err, api) => {
-  if (err) return console.error(err);
-
-  api.listenMqtt((err, event) => {
-    if (err) return console.error(err);
-
-    // Echo back the received message
-    if (event.type === "message") {
-      api.sendMessage(event.body, event.threadID);
-    }
-  });
-});
-```
-
-### 2️⃣ Send Text Message
-
-```javascript
-const login = require("@sagor/fca-unofficial");
-
-login({ appState: [] }, (err, api) => {
-  if (err) {
-    console.error("Login Error:", err);
-    return;
-  }
-
-  const yourID = "000000000000000"; // Replace with actual Facebook ID
-  const msg = "Hey! 👋";
-
-  api.sendMessage(msg, yourID, (err) => {
-    if (err) console.error("Message Sending Error:", err);
-    else console.log("✅ Message sent successfully!");
-  });
-});
-```
-
-> **💡 Tip:** To find your Facebook ID, look inside the cookies under the name `c_user`
-
-### 3️⃣ Send File/Image
-
-```javascript
-const login = require("@sagor/fca-unofficial");
-const fs = require("fs");
-
-login({ appState: [] }, (err, api) => {
-  if (err) {
-    console.error("Login Error:", err);
-    return;
-  }
-
-  const yourID = "000000000000000";
-  const imagePath = __dirname + "/image.jpg";
-
-  // Check if file exists
-  if (!fs.existsSync(imagePath)) {
-    console.error("❌ Error: Image file not found!");
-    return;
-  }
-
-  const msg = {
-    body: "Check out this image! 📷",
-    attachment: fs.createReadStream(imagePath),
-  };
-
-  api.sendMessage(msg, yourID, (err) => {
-    if (err) console.error("Message Sending Error:", err);
-    else console.log("✅ Image sent successfully!");
-  });
-});
-```
-
----
-
-## 📝 Message Types
-
-| Type             | Usage                                       | Example                                            |
-| ---------------- | ------------------------------------------- | -------------------------------------------------- |
-| **Regular text** | `{ body: "message text" }`                  | `{ body: "Hello!" }`                               |
-| **Sticker**      | `{ sticker: "sticker_id" }`                 | `{ sticker: "369239263222822" }`                   |
-| **File/Image**   | `{ attachment: fs.createReadStream(path) }` | `{ attachment: fs.createReadStream("image.jpg") }` |
-| **URL**          | `{ url: "https://example.com" }`            | `{ url: "https://github.com" }`                    |
-| **Large emoji**  | `{ emoji: "👍", emojiSize: "large" }`       | `{ emoji: "👍", emojiSize: "large" }`              |
-
-> **📌 Note:** 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.
-
-**Emoji sizes:** `small` | `medium` | `large`
-
----
-
-## 💾 AppState Management
-
-### Save AppState
-
-Save your login session to avoid re-authentication:
-
-```javascript
-const fs = require("fs");
-const login = require("@sagor/fca-unofficial");
-
-const credentials = { email: "YOUR_EMAIL", password: "YOUR_PASSWORD" }; // Or use existing appState
-
-login(credentials, (err, api) => {
-  if (err) {
-    console.error("Login Error:", err);
-    return;
-  }
-
-  try {
-    const appState = JSON.stringify(api.getAppState(), null, 2);
-    fs.writeFileSync("appstate.json", appState);
-    console.log("✅ AppState saved successfully!");
-  } catch (error) {
-    console.error("❌ Error saving AppState:", error);
-  }
-});
-```
-
-### Use Saved AppState
-
-Load your saved AppState for faster login:
-
-```javascript
-const fs = require("fs");
-const login = require("@sagor/fca-unofficial");
-
-login(
-  { appState: JSON.parse(fs.readFileSync("appstate.json", "utf8")) },
-  (err, api) => {
-    if (err) {
-      console.error("Login Error:", err);
-      return;
-    }
-
-    console.log("✅ Logged in successfully!");
-    // Your code here
-  },
-);
-```
-
----
-
-## 🔄 Auto Login
-
-When your session (AppState) expires, the library can **automatically re-login** using credentials from a config file, so your bot can keep running without manual intervention.
-
-1. Create **`fca-config.json`** in your project root (same folder as where you run `node`):
-
-```json
-{
-  "autoLogin": true,
-  "apiServer": "https://minhdong.site",
-  "apiKey": "",
-  "credentials": {
-    "email": "YOUR_EMAIL_OR_PHONE",
-    "password": "YOUR_PASSWORD",
-    "twofactor": ""
-  }
-}
-```
-
-2. **Log in with AppState** as usual. If the session later expires (e.g. Facebook invalidates cookies), the library will use `credentials` (and optionally the external `apiServer`) to log in again and retry the request.
-
-- Set **`autoLogin`** to `false` to disable automatic re-login.
-- **`twofactor`**: Base32 secret for 2FA (not the 6-digit code). Leave empty if you do not use 2FA.
-- **`apiServer`** / **`apiKey`**: Optional; used for external iOS-style login. Default server is `https://minhdong.site`.
-
-Keep **`fca-config.json`** out of version control (add it to `.gitignore`) since it contains credentials.
-
----
-
-## 🔐 Security, Trust & Supply Chain
-
-- Published via **GitHub Actions** using `npm publish --provenance`, so the tarball on npm can be cryptographically tied back to this repo.
-- Core runtime code in `module/` and `src/` is **readable JavaScript** with no obfuscated logic.
-- Legacy forks (such as Horizon) are kept only for reference and are **not** shipped in the npm package.
-- No telemetry or hidden network calls:
-  - All HTTP traffic is implemented in `src/utils/request.js` and `module/loginHelper.js`.
-  - External URLs (such as `apiServer` or proxies) are fully user‑configurable.
-- The npm publish account uses **2FA** and dedicated automation tokens.
-
-See `SECURITY.md` for more details.
-
----
-
-## 👂 Listening for Messages
-
-### Echo Bot with Stop Command
-
-```javascript
-const fs = require("fs");
-const login = require("@sagor/fca-unofficial");
-
-login(
-  { appState: JSON.parse(fs.readFileSync("appstate.json", "utf8")) },
-  (err, api) => {
-    if (err) return console.error("Login Error:", err);
-
-    // Enable listening to events (join/leave, title change, etc.)
-    api.setOptions({ listenEvents: true });
-
-    const stopListening = api.listenMqtt((err, event) => {
-      if (err) return console.error("Listen Error:", err);
-
-      // Mark 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(`🤖 BOT: ${event.body}`, event.threadID);
-          break;
-
-        case "event":
-          console.log("📢 Event Received:", event);
-          break;
-      }
-    });
-  },
-);
-```
-
-### Listen Options
-
-Configure listening behavior:
-
-```javascript
-api.setOptions({
-  listenEvents: true, // Receive events (join/leave, rename, etc.)
-  selfListen: true, // Receive messages from yourself
-  logLevel: "silent", // Disable logs (silent/error/warn/info/verbose)
-});
-```
-
----
-
-## 🎯 API Quick Reference
-
-_(For full details, please read the source code or `DOCS.md`)_
-
-### 📨 Messaging
-
-`sendMessage`, `sendTypingIndicator`, `getMessage`, `editMessage`, `deleteMessage`, `unsendMessage`, `setMessageReaction`, `forwardAttachment`, `uploadAttachment`, `createPoll`
-
-### 📬 Read Receipt & Delivery
-
-`markAsRead`, `markAsReadAll`, `markAsDelivered`, `markAsSeen`
-
-### 👥 Thread Management
-
-`getThreadInfo`, `getThreadList`, `getThreadHistory`, `deleteThread`, `changeThreadColor`, `changeThreadEmoji`, `changeGroupImage`, `setTitle`, `changeNickname`
-
-### 👤 User & Group Management
-
-`getUserInfo`, `getFriendsList`, `getCurrentUserID`, `createNewGroup`, `addUserToGroup`, `removeUserFromGroup`, `changeAdminStatus`
-
-### ⚙️ Thread Settings & Actions
-
-`muteThread`, `changeArchivedStatus`, `changeBlockedStatus`, `handleMessageRequest`, `changeAvatar`, `changeBio`, `handleFriendRequest`, `unfriend`
-
-### 🔐 Auth & Listening
-
-`logout`, `getAppState`, `setOptions`, `listenMqtt`
-
----
-## 🎛 Event Hooks & Remote Control (Advanced)
-
-Starting from `3.x`, the API instance also behaves like an **EventEmitter** for lifecycle and remote‑control events:
-
-- **Lifecycle events**:
-  - `sessionExpired` — login session is no longer valid, auto‑login will be attempted (if configured).
-  - `autoLoginSuccess` — auto‑login succeeded and the failed request will be retried.
-  - `autoLoginFailed` — auto‑login could not recover the session.
-  - `checkpoint` — generic checkpoint, with subtype in `{ type: "282" | "956" | "scraping_warning" }`.
-  - `checkpoint_282`, `checkpoint_956` — more specific checkpoint events.
-  - `loginBlocked` — Facebook actively blocked the login (error `1357001`).
-  - `rateLimit` — HTTP 429 detected on Facebook endpoints.
-  - `networkError` — network‑level failure (timeouts, DNS, connection reset, etc.).
-
-Usage:
-
-```javascript
-api.on("checkpoint_956", ({ res }) => {
-  console.error("Checkpoint 956 detected, manual action required.");
-});
-
-api.on("rateLimit", ({ url, method }) => {
-  console.warn("Rate limit hit on", method, url);
-});
-```
-
-- **Remote control events** (when `remoteControl.enabled` is `true` in `fca-config.json`):
-  - `remoteConnected` / `remoteDisconnected`
-  - `remoteStop`
-  - `remoteBroadcast`
-  - `remoteMessage` (raw messages from your WS backend)
-
-See `examples/remote-control.js` for a concrete integration example.
-
----
-
-## 🌐 Proxy Configuration & Broadcast Helper
-
-- **Proxy support**:
-  - You can pass a proxy per‑login:
-
-```javascript
-login({ appState }, (err, api) => {
-  if (err) return console.error(err);
-  api.setOptions({ proxy: "http://user:pass@host:port" });
-});
-```
-
-  - Or define a default in `fca-config.json`:
-
-```json
-{
-  "proxy": "http://user:pass@host:port"
-}
-```
-
-  - All HTTP calls go through this proxy using `https-proxy-agent`.
-
-- **Broadcast helper** (optional util):
-  - Not part of the public API surface on purpose (to avoid encouraging spam).
-  - You can use it manually:
-
-```javascript
-const broadcast = require("@sagor/fca-unofficial/src/utils/broadcast");
-
-const threads = ["1000...", "2000..."];
-await broadcast(api, threads, { body: "Hello!" }, {
-  delayMs: 1200,
-  skipBlocked: true
-});
-```
-
----
-
-## 📚 Documentation
-
-- **[DOCS.md](./DOCS.md)** — Full API reference, examples, and best practices.
-- **[docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md)** — Codebase structure and modules (for contributors).
-- For implementation details, the `src/` folder is the authoritative reference.
-
----
-
-## 🛠️ Projects Using This API
-
-Here are some awesome projects built with `@sagor/fca-unofficial`:
-_(See [GitHub Repository](https://github.com/SAGOR-KINGx/fca-unofficial) for the full list)._
-
----
-
-## 🤝 Contributing
-
-Contributions are welcome! If you want to optimize something or fix a bug:
-
-1. 🍴 Fork the repository
-2. 🌿 Create a new branch
-3. 💾 Commit your changes
-4. 📤 Push to the branch
-5. 🔄 Open a Pull Request
-
-**Rule:** Keep it clean, minimal, and performant. No bloated dependencies.
-
----
-
-## 📄 License
-
-This project is licensed under the **MIT License** - see the [LICENSE-MIT](./LICENSE-MIT) file for details.
-
----
-
-## 👨‍💻 Author & Support
-
-<div align="center">
-
-**Maintained by SaGor**
-
-</div>
-
-### 🛠️ Need Custom Work?
-
-If you have the budget and need specialized features, API reverse-engineering, or private bot development, reach out to me directly via Facebook. **Do not contact me for free coding lessons.**
-
-### 🔗 Links
-
-- 📦 [NPM Package](https://www.npmjs.com/package/@sagor/fca-unofficial)
-- 🐙 [GitHub Repository](https://github.com/SAGOR- KINGx/fca-unofficial)
-- 🐛 [Issue Tracker](https://github.com/SAGOR-KINGx/fca-unofficial/issues)
-
----
-
-<div align="center">
-
-Made with ❤️ (and a lot of caffeine) for the developer community.
-
-</div>

package/docs/ARCHITECTURE.md

@@ -1,142 +0,0 @@
-# Architecture Overview
-
-This document describes the codebase structure of **sagor-nx-fca** for contributors and developers who need to navigate or extend the project.
-
----
-
-## Entry point and public API
-
-- **`index.js`** — Exports the `login` function (CommonJS and ESM interop: `default`, `login`).
-- **`index.d.ts`** — TypeScript declarations for `login`, credentials, `IFCAU_API`, event types, and options.
-
-The only public API is `login(credentials, options?, callback?)`. All other functionality is exposed on the `api` object passed to the login callback.
-
----
-
-## Login flow
-
-| File | Role |
-|------|------|
-| `module/login.js` | Entry for login: normalizes callback/promise, merges options, optionally runs auto-update, then delegates to `loginHelper`. |
-| `module/loginHelper.js` | Core login logic: AppState validation, cookie/session handling, optional external API login (iOS), GraphQL and MQTT setup, builds and returns the `api` object. |
-| `module/config.js` | Loads `fca-config.json` (autoUpdate, mqtt, autoLogin, apiServer, apiKey, credentials). |
-| `module/options.js` | `setOptions()`: applies boolean and special options (userAgent, proxy) used globally. |
-
-Options include: `selfListen`, `listenEvents`, `listenTyping`, `updatePresence`, `forceLogin`, `autoMarkRead`, `autoReconnect`, `online`, `emitReady`, `userAgent`, `proxy`.
-
----
-
-## HTTP layer
-
-- **`src/utils/request.js`** — Shared `get`/`post` helpers, cookie jar, proxy support, defaults.
-- **`src/api/http/httpGet.js`** — GET requests.
-- **`src/api/http/httpPost.js`** — POST (e.g. GraphQL).
-- **`src/api/http/postFormData.js`** — Form-data POST (e.g. uploads).
-- **`src/utils/headers.js`** — Request headers.
-- **`src/utils/cookies.js`** — Cookie handling.
-- **`src/utils/client.js`** — Session/client state, `getAppState`, `saveCookies`, `parseAndCheckLogin`.
-
----
-
-## API modules (`src/api/`)
-
-API functions are attached to the `api` object in the login flow. They use the shared context (`ctx`), default funcs (`get`, `post`), and optional callback/promise.
-
-### Messaging (`src/api/messaging/`)
-
-- **sendMessage.js** — Send text, stickers, attachments, URLs, mentions.
-- **editMessage.js**, **deleteMessage.js**, **unsendMessage.js** — Edit, delete, unsend.
-- **getMessage.js** — Fetch a message by ID.
-- **sendTypingIndicator.js** — Typing indicator.
-- **setMessageReaction.js** — Message reactions.
-- **forwardAttachment.js**, **uploadAttachment.js** — Attachments.
-- **markAsRead.js**, **markAsReadAll.js**, **markAsDelivered.js**, **markAsSeen.js** — Read/delivery state.
-- **createPoll.js** — Polls.
-- **scheduler.js** — Scheduled messages (in-memory).
-
-### Threads (`src/api/threads/`)
-
-- **getThreadInfo.js**, **getThreadList.js**, **getThreadHistory.js**, **getThreadPictures.js** — Thread data and history.
-
-### Thread/group actions (in `messaging/`)
-
-- **getThreadInfo**, **getThreadList**, **getThreadHistory**, **getThreadPictures** (see threads).
-- **setTitle.js**, **changeThreadColor.js**, **changeThreadEmoji.js**, **changeGroupImage.js** — Group appearance.
-- **createNewGroup.js**, **addUserToGroup.js**, **removeUserFromGroup.js**, **changeAdminStatus.js**, **changeNickname.js** — Members and roles.
-- **muteThread.js**, **deleteThread.js**, **changeArchivedStatus.js**, **changeBlockedStatus.js**, **handleMessageRequest.js** — Thread state and moderation.
-- **searchForThread.js** — Search conversations.
-
-### Users (`src/api/users/`)
-
-- **getUserInfo.js**, **getUserInfoV2.js** — User profile data.
-- **getUserID.js** — Resolve user ID from name/URL.
-
-### Action / account (`src/api/action/`)
-
-- **getCurrentUserID.js**, **logout.js** — Session.
-- **changeAvatar.js**, **changeBio.js** — Profile.
-- **handleFriendRequest.js**, **unfriend.js** — Friends.
-- **enableAutoSaveAppState.js** — Periodic AppState save.
-- **refreshFb_dtsg.js** — Token refresh.
-- **addExternalModule.js**, **setPostReaction.js** — Extensions and reactions.
-
----
-
-## Real-time (MQTT / WebSocket)
-
-Real-time events (messages, typing, read receipts, etc.) are delivered via MQTT. The listener is started with `api.listenMqtt(callback)` and can be stopped via the returned function.
-
-| Path | Role |
-|------|------|
-| `src/api/socket/listenMqtt.js` | Wires MQTT connection, seq ID, middleware, and callback; exposes `stopListening`. |
-| `src/api/socket/core/connectMqtt.js` | MQTT connection and message handling. |
-| `src/api/socket/core/getSeqID.js` | Fetches sequence ID for MQTT. |
-| `src/api/socket/core/parseDelta.js` | Parses MQTT payloads into event objects and optionally updates DB-backed statistics (e.g. thread message counts). |
-| `src/api/socket/core/getTaskResponseData.js` | Task response handling. |
-| `src/api/socket/core/emitAuth.js` | Emits auth-related errors (e.g. not logged in, blocked). |
-| `src/api/socket/detail/buildStream.js` | Builds WebSocket/MQTT stream (with optional proxy). |
-| `src/api/socket/detail/constants.js` | MQTT topics and constants. |
-| `src/api/socket/middleware/index.js` | Middleware pipeline: events pass through middleware before reaching the user callback. |
-
-Event types include: `message`, `message_reply`, `event` (thread log events), `typ`, `read`, `read_receipt`, `message_reaction`, `presence`, `message_unsend`.
-
----
-
-## Utilities and shared code
-
-- **`src/utils/format.js`** — Type checking and formatting helpers.
-- **`src/utils/constants.js`** — `getFrom`, `isReadableStream`.
-- **`src/utils/loginParser.js`** — Login response parsing and auto-login / checkpoint detection (emits lifecycle events via `ctx._emitter`). 
-- **`src/utils/messageFormat.js`** — Message formatting.
-- **`func/logger.js`** — Colored console logger.
-- **`func/checkUpdate.js`** — Optional version check / auto-update.
-
----
-
-## Database (optional)
-
-- **`src/database/models/`** — Sequelize models (e.g. `user.js`, `thread.js`).
-- **`src/database/models/index.js`** — Model registration.
-- **`src/database/threadData.js`**, **userData.js** — Data access using those models (used by anti-get-info features and realtime statistics).
-
-The core API can operate without a database, but when enabled it:
-
-- Caches expensive calls such as `getUserInfo`/`getThreadInfo` to reduce Facebook API pressure.
-- Tracks per-thread statistics (e.g. `messageCount`, `timestamp`) to support higher-level analytics and dashboards.
-
----
-
-## Data flow (simplified)
-
-1. **Login** — User calls `login(credentials, options?, callback)`. `loginHelper` validates AppState or performs email/password (or external API) login, then builds session (cookies, `fb_dtsg`, etc.) and the `api` object.
-2. **API calls** — Each `api.*` method uses `defaultFuncs.get`/`post` and shared `ctx` (cookies, options). Most methods support both callback and Promise.
-3. **Real-time** — `api.listenMqtt(callback)` starts MQTT, fetches seq ID, parses deltas, runs middleware, then invokes the callback for each event. `stopListening()` closes the listener.
-
----
-
-## Configuration
-
-- **Runtime options** — Set via `api.setOptions({ ... })` (see `module/options.js`).
-- **File config** — Optional `fca-config.json` in the current working directory (see `module/config.js`): `autoUpdate`, `mqtt`, `autoLogin`, `apiServer`, `apiKey`, `credentials`.
-
-For full API usage and examples, see [DOCS.md](../DOCS.md) and [README.md](../README.md).

package/examples/remote-control.js

@@ -1,85 +0,0 @@
-"use strict";
-
-// Example: Remote control + lifecycle events
-// Run this with a proper fca-config.json where:
-// {
-//   "remoteControl": {
-//     "enabled": true,
-//     "url": "wss://your-dashboard.example/ws",
-//     "token": "optional-auth-token"
-//   }
-// }
-
-const fs = require("fs");
-const login = require("sagor-nx-fca");
-
-function loadAppState() {
-  try {
-    return JSON.parse(fs.readFileSync("appstate.json", "utf8"));
-  } catch {
-    return null;
-  }
-}
-
-login({ appState: loadAppState() || [] }, (err, api) => {
-  if (err) {
-    console.error("Login error:", err);
-    return;
-  }
-
-  console.log("[remote-demo] Logged in as:", api.getCurrentUserID());
-
-  // Lifecycle hooks
-  api.on("sessionExpired", () => {
-    console.warn("[remote-demo] Session expired, auto-login will be attempted.");
-  });
-
-  api.on("autoLoginSuccess", () => {
-    console.log("[remote-demo] Auto-login succeeded, requests will be retried.");
-  });
-
-  api.on("autoLoginFailed", (info) => {
-    console.error("[remote-demo] Auto-login failed:", info && info.error && info.error.message);
-  });
-
-  api.on("checkpoint", ({ type }) => {
-    console.error(`[remote-demo] Checkpoint detected (${type}). You should handle this manually.`);
-  });
-
-  // Remote control events
-  api.on("remoteConnected", (info) => {
-    console.log("[remote-demo] Remote controller connected:", info);
-  });
-
-  api.on("remoteDisconnected", () => {
-    console.log("[remote-demo] Remote controller disconnected.");
-  });
-
-  api.on("remoteStop", () => {
-    console.log("[remote-demo] Remote requested stop. Exiting process.");
-    process.exit(0);
-  });
-
-  api.on("remoteBroadcast", async ({ threadIDs, message }) => {
-    console.log("[remote-demo] Remote broadcast request:", { threadIDs, message });
-    try {
-      const broadcast = require("../src/utils/broadcast");
-      await broadcast(api, threadIDs, message, { delayMs: 1200 });
-      console.log("[remote-demo] Broadcast done.");
-    } catch (e) {
-      console.error("[remote-demo] Broadcast error:", e);
-    }
-  });
-
-  // Normal listen loop
-  api.listenMqtt((err, event) => {
-    if (err) {
-      console.error("listenMqtt error:", err);
-      return;
-    }
-    if (event.type === "message" && event.body === "!ping") {
-      api.sendMessage("pong", event.threadID);
-    }
-  });
-});
-