@dongdev/fca-unofficial 3.0.28 → 3.0.30

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/index.d.ts

@@ -184,6 +184,12 @@ declare module '@dongdev/fca-unofficial' {
     listen: (callback?: (err: Error | null, message: IFCAU_ListenMessage) => void) => EventEmitter;
     listenMqtt: (callback?: (err: Error | null, message: IFCAU_ListenMessage) => void) => EventEmitter & { stopListening: (callback?: () => void) => void };
 
+    // Lifecycle & Remote Events
+    on: (event: string, listener: (...args: any[]) => void) => IFCAU_Api;
+    once: (event: string, listener: (...args: any[]) => void) => IFCAU_Api;
+    off: (event: string, listener: (...args: any[]) => void) => IFCAU_Api;
+    removeAllListeners: (event?: string) => IFCAU_Api;
+
     // Middleware System
     useMiddleware: (middleware: IFCAU_Middleware | string, fn?: IFCAU_Middleware) => () => void;
     removeMiddleware: (identifier: string | IFCAU_Middleware) => boolean;

package/module/config.js

@@ -7,7 +7,17 @@ const defaultConfig = {
   autoLogin: true,
   apiServer: "https://minhdong.site",
   apiKey: "",
-  credentials: { email: "", password: "", twofactor: "" }
+  credentials: { email: "", password: "", twofactor: "" },
+  antiGetInfo: {
+    AntiGetThreadInfo: false,
+    AntiGetUserInfo: false
+  },
+  remoteControl: {
+    enabled: false,
+    url: "",
+    token: "",
+    autoReconnect: true
+  }
 };
 
 function loadConfig() {

package/module/loginHelper.js

@@ -1,16 +1,16 @@
 "use strict";
 const fs = require("fs");
 const path = require("path");
+const EventEmitter = require("events");
 const models = require("../src/database/models");
 const logger = require("../func/logger");
 const { get, post, jar, makeDefaults } = require("../src/utils/request");
 const { saveCookies, getAppState } = require("../src/utils/client");
 const { getFrom } = require("../src/utils/constants");
 const { loadConfig } = require("./config");
+const { createRemoteClient } = require("../src/remote/remoteClient");
 const { config } = loadConfig();
 const axiosBase = require("axios");
-const parseUserHtml = require("./parseUseerHtml");
-
 const regions = [
   { code: "PRN", name: "Pacific Northwest Region", location: "Khu vực Tây Bắc Thái Bình Dương" },
   { code: "VLL", name: "Valley Region", location: "Valley" },
@@ -571,7 +571,7 @@ async function tryAutoLoginIfNeeded(currentHtml, currentCookies, globalOptions,
 
   // Check if auto-login is enabled (support both true and "true")
   if (config.autoLogin === false || config.autoLogin === "false") {
-    throw new Error("AppState backup die — Auto-login is disabled");
+    throw new Error("AppState expired — Auto-login is disabled");
   }
 
   // Try API login
@@ -881,7 +881,7 @@ function loginHelper(appState, Cookie, email, password, globalOptions, callback)
         const initial = await get("https://www.facebook.com/", jar, null, globalOptions).then(saveCookies(jar));
         return (await ctx.bypassAutomation(initial, jar)) || initial;
       }
-      logger("AppState backup die — proceeding to email/password login", "warn");
+      logger("AppState expired — proceeding to email/password login", "warn");
       return get("https://www.facebook.com/", null, null, globalOptions)
         .then(saveCookies(jar))
         .then(makeLogin(jar, email, password, globalOptions))
@@ -1056,7 +1056,6 @@ function loginHelper(appState, Cookie, email, password, globalOptions, callback)
         let fb_dtsg;
         let irisSeqID;
         try {
-          parseUserHtml(html);
           const m1 = html.match(/"endpoint":"([^"]+)"/);
           const m2 = m1 ? null : html.match(/endpoint\\":\\"([^\\"]+)\\"/);
           const raw = (m1 && m1[1]) || (m2 && m2[1]);
@@ -1122,6 +1121,7 @@ function loginHelper(appState, Cookie, email, password, globalOptions, callback)
             }
           });
         logger("FCA fix/update by DongDev (Donix-VN)", "info");
+        const emitter = new EventEmitter();
         const ctxMain = {
           userID,
           jar,
@@ -1140,7 +1140,8 @@ function loginHelper(appState, Cookie, email, password, globalOptions, callback)
           clientId: getFrom(html, '["MqttWebDeviceID",[],{"clientID":"', '"}') || "",
           wsReqNumber: 0,
           wsTaskNumber: 0,
-          tasks: new Map()
+          tasks: new Map(),
+          _emitter: emitter
         };
         ctxMain.options = globalOptions;
         ctxMain.bypassAutomation = ctx.bypassAutomation.bind(ctxMain);
@@ -1174,9 +1175,64 @@ function loginHelper(appState, Cookie, email, password, globalOptions, callback)
           },
           getLatestCookieFromDB: async function (uid = userID) {
             return await getLatestBackup(uid, "cookie");
-          }
+          },
+          on: emitter.on.bind(emitter),
+          once: emitter.once.bind(emitter),
+          off: emitter.removeListener.bind(emitter),
+          removeAllListeners: emitter.removeAllListeners.bind(emitter)
         };
         const defaultFuncs = makeDefaults(html, userID, ctxMain);
+
+        // Attach lightweight DB updaters for realtime events (MQTT)
+        try {
+          const Thread = models && models.Thread;
+          if (!Thread) {
+            throw new Error("Thread model not available");
+          }
+
+          ctxMain._updateThreadFromMessage = async msg => {
+            try {
+              if (!msg || !msg.threadID) return;
+              const id = String(msg.threadID);
+              // Fast path: increment messageCount column directly
+              let affected = 0;
+              try {
+                const res = await Thread.increment("messageCount", { by: 1, where: { threadID: id } });
+                if (Array.isArray(res) && typeof res[0] === "number") {
+                  affected = res[0];
+                }
+              } catch {
+                // Ignore increment errors, we'll try to create below
+              }
+              // If no row was updated, ensure a row exists
+              if (!affected) {
+                try {
+                  await Thread.create({ threadID: id, messageCount: 1, data: { threadID: id } });
+                } catch {
+                  // Ignore create races / duplicates
+                }
+              }
+            } catch (e) {
+              const msgText = e && e.message ? e.message : String(e);
+              logger(`updateThreadFromMessage error: ${msgText}`, "warn");
+            }
+          };
+        } catch {
+          // If DB layer is unavailable, skip realtime thread updates
+        }
+
+        // Attach remote control client if enabled in config
+        let remote = null;
+        try {
+          if (config && config.remoteControl && config.remoteControl.enabled) {
+            remote = createRemoteClient(api, ctxMain, config.remoteControl);
+          }
+        } catch (e) {
+          logger(`Remote control initialization failed: ${e && e.message ? e.message : String(e)}`, "warn");
+        }
+        if (remote) {
+          api.remote = remote;
+        }
         const srcRoot = path.join(__dirname, "../src/api");
         let loaded = 0;
         let skipped = 0;

package/package.json

@@ -1,81 +1,88 @@
-{
-  "name": "@dongdev/fca-unofficial",
-  "version": "3.0.28",
-  "description": "Unofficial Facebook Chat API for Node.js - Interact with Facebook Messenger programmatically",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "exports": {
-    ".": {
-      "require": "./index.js",
-      "default": "./index.js",
-      "types": "./index.d.ts"
-    }
-  },
-  "scripts": {
-    "test": "mocha",
-    "lint": "eslint ."
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/dongp06/fca-unofficial.git"
-  },
-  "keywords": [
-    "facebook",
-    "chat",
-    "api",
-    "messenger",
-    "bot",
-    "unofficial",
-    "automation",
-    "facebook-api",
-    "facebook-chat",
-    "facebook-messenger",
-    "chatbot",
-    "nodejs",
-    "fca"
-  ],
-  "author": {
-    "name": "DongDev",
-    "url": "https://www.facebook.com/mdong.dev"
-  },
-  "contributors": [
-    {
-      "name": "DongDev",
-      "url": "https://github.com/dongp06"
-    }
-  ],
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/dongp06/fca-unofficial/issues"
-  },
-  "homepage": "https://github.com/dongp06/fca-unofficial#readme",
-  "engines": {
-    "node": ">=12.0.0"
-  },
-  "dependencies": {
-    "@dongdev/fca-unofficial": "^3.0.25",
-    "axios": "latest",
-    "axios-cookiejar-support": "^5.0.5",
-    "bluebird": "^3.7.2",
-    "chalk": "^4.1.2",
-    "cheerio": "^1.0.0-rc.10",
-    "duplexify": "^4.1.3",
-    "gradient-string": "^2.0.2",
-    "https-proxy-agent": "^4.0.0",
-    "mqtt": "^4.3.8",
-    "npmlog": "^1.2.0",
-    "request": "^2.53.0",
-    "sequelize": "^6.37.6",
-    "sqlite3": "^5.1.7",
-    "totp-generator": "^1.0.0",
-    "ws": "^8.18.1"
-  },
-  "devDependencies": {
-    "eslint": "^8.50.0",
-    "mocha": "^10.2.0"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  }
-}
+{
+  "name": "@dongdev/fca-unofficial",
+  "version": "3.0.30",
+  "description": "Unofficial Facebook Chat API for Node.js - Interact with Facebook Messenger programmatically",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./index.js",
+      "default": "./index.js",
+      "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/dongp06/fca-unofficial.git"
+  },
+  "keywords": [
+    "facebook",
+    "chat",
+    "api",
+    "messenger",
+    "bot",
+    "unofficial",
+    "automation",
+    "facebook-api",
+    "facebook-chat",
+    "facebook-messenger",
+    "chatbot",
+    "nodejs",
+    "fca"
+  ],
+  "author": {
+    "name": "DongDev",
+    "url": "https://www.facebook.com/mdong.dev"
+  },
+  "contributors": [
+    {
+      "name": "DongDev",
+      "url": "https://github.com/dongp06"
+    }
+  ],
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/dongp06/fca-unofficial/issues"
+  },
+  "homepage": "https://github.com/dongp06/fca-unofficial#readme",
+  "engines": {
+    "node": ">=12.0.0"
+  },
+  "dependencies": {
+    "axios": "^1.13.5",
+    "axios-cookiejar-support": "^5.0.5",
+    "bluebird": "^3.7.2",
+    "chalk": "^4.1.2",
+    "cheerio": "^1.0.0-rc.10",
+    "duplexify": "^4.1.3",
+    "gradient-string": "^2.0.2",
+    "https-proxy-agent": "^4.0.0",
+    "mqtt": "^4.3.8",
+    "sequelize": "^6.37.6",
+    "totp-generator": "^1.0.0",
+    "ws": "^8.18.1"
+  },
+  "devDependencies": {
+    "eslint": "^8.50.0",
+    "mocha": "^10.2.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/src/api/action/changeAvatar.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { isReadableStream } = require("../../utils/constants");
 const { parseAndCheckLogin } = require("../../utils/client");
 const { formatID, getType } = require("../../utils/format");

package/src/api/action/changeBio.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin } = require("../../utils/client");
 const { getType } = require("../../utils/format");
 module.exports = function(defaultFuncs, api, ctx) {

package/src/api/action/handleFriendRequest.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin } = require("../../utils/client");
 const { getType } = require("../../utils/format");
 module.exports = function(defaultFuncs, api, ctx) {

package/src/api/action/logout.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin } = require("../../utils/client");
 const { getFrom } = require("../../utils/constants");
 const { saveCookies } = require("../../utils/client");

package/src/api/action/refreshFb_dtsg.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { getFrom } = require("../../utils/constants");
 const { get } = require("../../utils/request")
 const { getType } = require("../../utils/format");

package/src/api/action/setPostReaction.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin } = require("../../utils/client");
 const { getType } = require("../../utils/format");
 function formatData(resData) {

package/src/api/action/unfriend.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin } = require("../../utils/client");
 module.exports = function(defaultFuncs, api, ctx) {
   return function unfriend(userID, callback) {

package/src/api/http/postFormData.js

@@ -1,6 +1,6 @@
 "use strict";
 
-var log = require("npmlog");
+var log = require("../../../func/logAdapter");
 const { getType } = require("../../utils/format");
 const { parseAndCheckLogin } = require("../../utils/client");
 module.exports = function(defaultFuncs, api, ctx) {

package/src/api/messaging/changeArchivedStatus.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { formatID } = require("../../utils/format");
 const { parseAndCheckLogin } = require("../../utils/client");
 module.exports = function(defaultFuncs, api, ctx) {

package/src/api/messaging/changeBlockedStatus.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin, saveCookies } = require("../../utils/client");
 module.exports = function(defaultFuncs, api, ctx) {
   return function changeBlockedStatus(userID, block, callback) {

package/src/api/messaging/changeGroupImage.js

@@ -1,7 +1,7 @@
 "use strict";
 
 const { generateOfflineThreadingID } = require("../../utils/format.js");
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 
 module.exports = function (defaultFuncs, api, ctx) {
   function handleUpload(image) {

package/src/api/messaging/changeNickname.js

@@ -1,7 +1,7 @@
 "use strict";
 
 const { generateOfflineThreadingID } = require("../../utils/format.js");
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 
 module.exports = function (defaultFuncs, api, ctx) {
   return function changeNickname(nickname, threadID, participantID, callback) {

package/src/api/messaging/changeThreadEmoji.js

@@ -1,7 +1,7 @@
 "use strict";
 
 const { generateOfflineThreadingID } = require("../../utils/format");
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin } = require("../../utils/client");
 module.exports = function (defaultFuncs, api, ctx) {
   function changeThreadEmojiNoMqtt(emoji, threadID, callback) {

package/src/api/messaging/createNewGroup.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin } = require("../../utils/client");
 const { getType } = require("../../utils/format");
 module.exports = function(defaultFuncs, api, ctx) {

package/src/api/messaging/createThemeAI.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { getType } = require("../../utils/format");
 const { parseAndCheckLogin } = require("../../utils/client");
 

package/src/api/messaging/deleteMessage.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { getType, generateOfflineThreadingID } = require("../../utils/format");
 
 module.exports = function (defaultFuncs, api, ctx) {

package/src/api/messaging/deleteThread.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin } = require("../../utils/client");
 const { getType } = require("../../utils/format");
 module.exports = function(defaultFuncs, api, ctx) {

package/src/api/messaging/getFriendsList.js

@@ -1,7 +1,7 @@
 "use strict";
 
 const { formatID } = require("../../utils/format");
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin } = require("../../utils/client");
 const GENDERS = {
   0: "unknown",

package/src/api/messaging/getMessage.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { _formatAttachment } = require("../../utils/format");
 const { parseAndCheckLogin } = require("../../utils/client");
 function formatMessage(threadID, data) {

package/src/api/messaging/getThemePictures.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin } = require("../../utils/client");
 const { getType } = require("../../utils/format");
 module.exports = function (defaultFuncs, api, ctx) {

package/src/api/messaging/handleMessageRequest.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin } = require("../../utils/client");
 const { getType } = require("../../utils/format");
 module.exports = function(defaultFuncs, api, ctx) {

package/src/api/messaging/markAsDelivered.js

@@ -1,5 +1,5 @@
 "use strict";
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin, saveCookies } = require("../../utils/client");
 const { getType } = require("../../utils/format");
 module.exports = function(defaultFuncs, api, ctx) {

package/src/api/messaging/markAsRead.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin, saveCookies } = require("../../utils/client");
 const { getType } = require("../../utils/format");
 module.exports = function(defaultFuncs, api, ctx) {

package/src/api/messaging/markAsReadAll.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin, saveCookies } = require("../../utils/client");
 module.exports = function(defaultFuncs, api, ctx) {
   return function markAsReadAll(callback) {

package/src/api/messaging/markAsSeen.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin, saveCookies } = require("../../utils/client");
 const { getType } = require("../../utils/format");
 module.exports = function(defaultFuncs, api, ctx) {

package/src/api/messaging/muteThread.js

@@ -1,5 +1,5 @@
 "use strict";
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin, saveCookies } = require("../../utils/client");
 module.exports = function(defaultFuncs, api, ctx) {
   // muteSecond: -1=permanent mute, 0=unmute, 60=one minute, 3600=one hour, etc.

package/src/api/messaging/resolvePhotoUrl.js

@@ -1,5 +1,5 @@
 "use strict";
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { parseAndCheckLogin, saveCookies } = require("../../utils/client");
 module.exports = function(defaultFuncs, api, ctx) {
   return function resolvePhotoUrl(photoID, callback) {

package/src/api/messaging/sendMessage.js

@@ -11,7 +11,7 @@
  */
 
 "use strict";
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 const { getType } = require("../../utils/format");
 const { isReadableStream } = require("../../utils/constants");
 const { generateOfflineThreadingID } = require("../../utils/format");

package/src/api/messaging/setTitle.js

@@ -2,7 +2,7 @@
 
 const { getType, generateOfflineThreadingID, generateTimestampRelative, generateThreadingID, getCurrentTimestamp } = require("../../utils/format");
 const { parseAndCheckLogin } = require("../../utils/client");
-const log = require("npmlog");
+const log = require("../../../func/logAdapter");
 
 module.exports = function (defaultFuncs, api, ctx) {
   function setTitleNoMqtt(newTitle, threadID, callback) {