@dongdev/fca-unofficial 3.0.30 → 3.0.31

package/CHANGELOG.md

@@ -291,3 +291,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 [3.0.28]: https://github.com/Donix-VN/fca-unofficial/compare/v3.0.27...v3.0.28
 [3.0.27]: https://github.com/Donix-VN/fca-unofficial/compare/v3.0.25...v3.0.27
 [1.0.10]: https://github.com/Donix-VN/fca-unofficial/releases/tag/v1.0.10
+
+## v3.0.30 - 2026-03-07
+- Hotfix / auto bump

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dongdev/fca-unofficial",
-  "version": "3.0.30",
+  "version": "3.0.31",
   "description": "Unofficial Facebook Chat API for Node.js - Interact with Facebook Messenger programmatically",
   "main": "index.js",
   "types": "index.d.ts",
@@ -74,6 +74,7 @@
     "https-proxy-agent": "^4.0.0",
     "mqtt": "^4.3.8",
     "sequelize": "^6.37.6",
+    "sqlite3": "^5.1.7",
     "totp-generator": "^1.0.0",
     "ws": "^8.18.1"
   },

package/src/api/http/httpGet.js

@@ -1,7 +1,7 @@
 "use strict";
 
-const { getType } = require("../../utils/format.js");
-const { get } = require("../../utils/request.js");
+const { getType } = require("../../utils/format");
+const { get } = require("../../utils/request");
 
 const httpGetFactory = function (defaultFuncs, api, ctx) {
   return function httpGet(url, form, callback, notAPI) {

package/src/api/messaging/addUserToGroup.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const { generateOfflineThreadingID, getType } = require("../../utils/format.js");
+const { generateOfflineThreadingID, getType } = require("../../utils/format");
 module.exports = function (defaultFuncs, api, ctx) {
   return function addUserToGroup(userID, threadID, callback) {
     return new Promise((resolve, reject) => {

package/src/api/messaging/changeGroupImage.js

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

package/src/api/messaging/changeNickname.js

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

package/src/api/messaging/changeThreadColor.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const { generateOfflineThreadingID } = require("../../utils/format.js");
+const { generateOfflineThreadingID } = require("../../utils/format");
 module.exports = (defaultFuncs, api, ctx) => {
   return async (color, threadID, callback) => {
     let reqID = ++ctx.wsReqNumber;

package/src/api/messaging/editMessage.js

@@ -1,6 +1,6 @@
 "use_strict";
 
-const { generateOfflineThreadingID } = require("../../utils/format.js");
+const { generateOfflineThreadingID } = require("../../utils/format");
 module.exports = (defaultFuncs, api, ctx) => {
   return (text, messageID, callback) => {
     let reqID = ctx.wsReqNumber + 1;

package/src/api/messaging/searchForThread.js

@@ -1,6 +1,7 @@
 "use strict";
 
 const { parseAndCheckLogin } = require("../../utils/client");
+const { formatThread } = require("../../utils/format");
 module.exports = function(defaultFuncs, api, ctx) {
   return function searchForThread(name, callback) {
     let resolveFunc = function() {};
@@ -43,7 +44,7 @@ module.exports = function(defaultFuncs, api, ctx) {
         }
         return callback(
           null,
-          resData.payload.mercury_payload.threads.map(utils.formatThread)
+          resData.payload.mercury_payload.threads.map(formatThread)
         );
       });
 

package/src/api/messaging/sendTypingIndicator.js

@@ -1,5 +1,5 @@
 "use strict";
-const { getType } = require("../../utils/format.js");
+const { getType } = require("../../utils/format");
 module.exports = function (defaultFuncs, api, ctx) {
   return function sendTyping(threadID, isTyping, options, callback) {
     var resolveFunc = function () { };

package/src/api/messaging/setMessageReaction.js

@@ -49,16 +49,15 @@ module.exports = function (defaultFuncs, api, ctx) {
         failure_count: null,
         label: "29",
         payload: JSON.stringify(taskPayload),
-        queue_name: JSON.stringify(["reaction", messageID]),
+        queue_name: "reaction:" + messageID,
         task_id: taskID,
       };
       const mqttForm = {
-        app_id: "772021112871879",
+        app_id: "2220391788200892",
         payload: JSON.stringify({
-          data_trace_id: null,
           epoch_id: parseInt(generateOfflineThreadingID()),
           tasks: [task],
-          version_id: "25376272951962053"
+          version_id: "24585299697835063"
         }),
         request_id: reqID,
         type: 3

package/src/api/messaging/unsendMessage.js

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

package/src/api/threads/getThreadInfo.js

@@ -137,7 +137,8 @@ module.exports = function (defaultFuncs, api, ctx) {
   const dbFiles = fs.readdirSync(path.join(__dirname, "../../database"))
     .filter(f => path.extname(f) === ".js")
     .reduce((acc, file) => {
-      acc[path.basename(file, ".js")] = require(path.join(__dirname, "../../database", file))(api);
+      const mod = require(path.join(__dirname, "../../database", file));
+      acc[path.basename(file, ".js")] = typeof mod === "function" ? mod(api) : mod;
       return acc;
     }, {});
 

package/src/api/users/getUserInfo.js

@@ -193,10 +193,13 @@ module.exports = function (defaultFuncs, api, ctx) {
   const queuedUsers = new Set();
   const cooldown = new Map();
 
-  const dbFiles = fs.readdirSync(path.join(__dirname, "../../database")).filter(f => path.extname(f) === ".js").reduce((acc, file) => {
-    acc[path.basename(file, ".js")] = require(path.join(__dirname, "../../database", file))(api);
-    return acc;
-  }, {});
+  const dbFiles = fs.readdirSync(path.join(__dirname, "../../database"))
+    .filter(f => path.extname(f) === ".js")
+    .reduce((acc, file) => {
+      const mod = require(path.join(__dirname, "../../database", file));
+      acc[path.basename(file, ".js")] = typeof mod === "function" ? mod(api) : mod;
+      return acc;
+    }, {});
   const { userData } = dbFiles;
   const { create, get, update, getAll } = userData;
 

package/src/database/helpers.js

@@ -0,0 +1,53 @@
+"use strict";
+
+/**
+ * Shared helpers for database layer (userData, threadData).
+ * Keeps validation and payload normalization in one place.
+ */
+
+const DB_NOT_INIT = "Database not initialized";
+
+function validateId(value, fieldName = "id") {
+  if (value == null) {
+    throw new Error(`${fieldName} is required and cannot be undefined`);
+  }
+  if (typeof value !== "string" && typeof value !== "number") {
+    throw new Error(`Invalid ${fieldName}: must be a string or number`);
+  }
+  return String(value);
+}
+
+function validateData(data) {
+  if (!data || typeof data !== "object" || Array.isArray(data)) {
+    throw new Error("Invalid data: must be a non-empty object");
+  }
+}
+
+/**
+ * @param {string|string[]|null} keys - "userID" | ["userID","data"] | null
+ * @returns {string[]|undefined}
+ */
+function normalizeAttributes(keys) {
+  if (keys == null) return undefined;
+  return typeof keys === "string" ? [keys] : Array.isArray(keys) ? keys : undefined;
+}
+
+/**
+ * Normalize payload: accept either { data } or raw object.
+ */
+function normalizePayload(data, key = "data") {
+  return Object.prototype.hasOwnProperty.call(data, key) ? data : { [key]: data };
+}
+
+function wrapError(message, cause) {
+  return new Error(`${message}: ${cause && cause.message ? cause.message : cause}`);
+}
+
+module.exports = {
+  DB_NOT_INIT,
+  validateId,
+  validateData,
+  normalizeAttributes,
+  normalizePayload,
+  wrapError
+};

package/src/database/models/index.js

@@ -63,6 +63,7 @@ try {
 
   models.sequelize = sequelize;
   models.Sequelize = Sequelize;
+  models.isReady = true;
   models.syncAll = async () => {
     try {
       if (!sequelize) {
@@ -75,10 +76,10 @@ try {
     }
   };
 } catch (initError) {
-  // If initialization fails completely, still export a valid structure
   console.error("Database initialization error:", initError && initError.message ? initError.message : String(initError));
   models.sequelize = null;
   models.Sequelize = Sequelize;
+  models.isReady = false;
   models.syncAll = async () => {
     throw new Error("Database not initialized");
   };

package/src/database/threadData.js

@@ -1,97 +1,93 @@
-const { Thread } = require("./models");
+"use strict";
 
-const validateThreadID = threadID => {
-  if (typeof threadID !== "string" && typeof threadID !== "number") {
-    throw new Error("Invalid threadID: must be a string or number.");
-  }
-  return String(threadID);
-};
-const validateData = data => {
-  if (!data || typeof data !== "object" || Array.isArray(data)) {
-    throw new Error("Invalid data: must be a non-empty object.");
-  }
-};
+const models = require("./models");
+const {
+  DB_NOT_INIT,
+  validateId,
+  validateData,
+  normalizeAttributes,
+  wrapError
+} = require("./helpers");
 
-module.exports = function(bot) {
+const Thread = models.Thread;
+const ID_FIELD = "threadID";
+
+module.exports = function (bot) {
   return {
     async create(threadID, data) {
+      if (!Thread) {
+        return { thread: { threadID: validateId(threadID, ID_FIELD), ...(data || {}) }, created: true };
+      }
       try {
+        threadID = validateId(threadID, ID_FIELD);
         let thread = await Thread.findOne({ where: { threadID } });
-        if (thread) {
-          return { thread: thread.get(), created: false };
-        }
-        thread = await Thread.create({ threadID, ...data });
+        if (thread) return { thread: thread.get(), created: false };
+        thread = await Thread.create({ threadID, ...(data || {}) });
         return { thread: thread.get(), created: true };
-      } catch (error) {
-        throw new Error(`Failed to create thread: ${error.message}`);
+      } catch (err) {
+        throw wrapError("Failed to create thread", err);
       }
     },
 
     async get(threadID) {
+      if (!Thread) return null;
       try {
-        threadID = validateThreadID(threadID);
+        threadID = validateId(threadID, ID_FIELD);
         const thread = await Thread.findOne({ where: { threadID } });
         return thread ? thread.get() : null;
-      } catch (error) {
-        throw new Error(`Failed to get thread: ${error.message}`);
+      } catch (err) {
+        throw wrapError("Failed to get thread", err);
       }
     },
 
     async update(threadID, data) {
+      if (!Thread) {
+        return { thread: { threadID: validateId(threadID, ID_FIELD), ...(data || {}) }, created: false };
+      }
       try {
-        threadID = validateThreadID(threadID);
+        threadID = validateId(threadID, ID_FIELD);
         validateData(data);
         const thread = await Thread.findOne({ where: { threadID } });
-
         if (thread) {
           await thread.update(data);
           return { thread: thread.get(), created: false };
-        } else {
-          const newThread = await Thread.create({ ...data, threadID });
-          return { thread: newThread.get(), created: true };
         }
-      } catch (error) {
-        throw new Error(`Failed to update thread: ${error.message}`);
+        const newThread = await Thread.create({ ...data, threadID });
+        return { thread: newThread.get(), created: true };
+      } catch (err) {
+        throw wrapError("Failed to update thread", err);
       }
     },
 
     async del(threadID) {
+      if (!Thread) throw new Error(DB_NOT_INIT);
       try {
-        if (!threadID) {
-          throw new Error("threadID is required and cannot be undefined");
-        }
-        threadID = validateThreadID(threadID);
-        if (!threadID) {
-          throw new Error("Invalid threadID");
-        }
+        threadID = validateId(threadID, ID_FIELD);
         const result = await Thread.destroy({ where: { threadID } });
-        if (result === 0) {
-          throw new Error("No thread found with the specified threadID");
-        }
+        if (result === 0) throw new Error("No thread found with the specified threadID");
         return result;
-      } catch (error) {
-        throw new Error(`Failed to delete thread: ${error.message}`);
+      } catch (err) {
+        throw wrapError("Failed to delete thread", err);
       }
     },
+
     async delAll() {
+      if (!Thread) return 0;
       try {
         return await Thread.destroy({ where: {} });
-      } catch (error) {
-        throw new Error(`Failed to delete all threads: ${error.message}`);
+      } catch (err) {
+        throw wrapError("Failed to delete all threads", err);
       }
     },
+
     async getAll(keys = null) {
+      if (!Thread) return [];
       try {
-        const attributes =
-          typeof keys === "string"
-            ? [keys]
-            : Array.isArray(keys)
-            ? keys
-            : undefined;
-        const threads = await Thread.findAll({ attributes });
-        return threads.map(thread => thread.get());
-      } catch (error) {
-        throw new Error(`Failed to get all threads: ${error.message}`);
+        const attributes = normalizeAttributes(keys);
+        const rows = await Thread.findAll({ attributes });
+        return rows.map((t) => t.get());
+      } catch (err) {
+        throw wrapError("Failed to get all threads", err);
       }
     }
   };

package/src/database/userData.js

@@ -1,88 +1,97 @@
-const { User } = require("./models");
+"use strict";
 
-const validateUserID = userID => {
-  if (typeof userID !== "string" && typeof userID !== "number") {
-    throw new Error("Invalid userID: must be a string or number.");
-  }
-  return String(userID);
-};
-const validateData = data => {
-  if (!data || typeof data !== "object" || Array.isArray(data)) {
-    throw new Error("Invalid data: must be a non-empty object.");
-  }
-};
+const models = require("./models");
+const {
+  DB_NOT_INIT,
+  validateId,
+  validateData,
+  normalizeAttributes,
+  normalizePayload,
+  wrapError
+} = require("./helpers");
+
+const User = models.User;
+const ID_FIELD = "userID";
+
+function stubUser(userID, data) {
+  return { user: { userID, ...normalizePayload(data || {}, "data") }, created: true };
+}
 
 module.exports = function (bot) {
   return {
     async create(userID, data) {
+      if (!User) return stubUser(validateId(userID, ID_FIELD), data);
       try {
-        userID = validateUserID(userID);
+        userID = validateId(userID, ID_FIELD);
         validateData(data);
+        const payload = normalizePayload(data, "data");
         let user = await User.findOne({ where: { userID } });
         if (user) return { user: user.get(), created: false };
-        const payload = Object.prototype.hasOwnProperty.call(data, "data") ? data : { data };
         user = await User.create({ userID, ...payload });
         return { user: user.get(), created: true };
-      } catch (error) {
-        throw new Error(`Failed to create user: ${error.message}`);
+      } catch (err) {
+        throw wrapError("Failed to create user", err);
       }
     },
 
     async get(userID) {
+      if (!User) return null;
       try {
-        userID = validateUserID(userID);
+        userID = validateId(userID, ID_FIELD);
         const user = await User.findOne({ where: { userID } });
         return user ? user.get() : null;
-      } catch (error) {
-        throw new Error(`Failed to get user: ${error.message}`);
+      } catch (err) {
+        throw wrapError("Failed to get user", err);
       }
     },
 
     async update(userID, data) {
+      if (!User) return { user: { userID: validateId(userID, ID_FIELD), ...normalizePayload(data || {}, "data") }, created: false };
       try {
-        userID = validateUserID(userID);
+        userID = validateId(userID, ID_FIELD);
         validateData(data);
-        const payload = Object.prototype.hasOwnProperty.call(data, "data") ? data : { data };
+        const payload = normalizePayload(data, "data");
         const user = await User.findOne({ where: { userID } });
         if (user) {
           await user.update(payload);
           return { user: user.get(), created: false };
-        } else {
-          const newUser = await User.create({ userID, ...payload });
-          return { user: newUser.get(), created: true };
         }
-      } catch (error) {
-        throw new Error(`Failed to update user: ${error.message}`);
+        const newUser = await User.create({ userID, ...payload });
+        return { user: newUser.get(), created: true };
+      } catch (err) {
+        throw wrapError("Failed to update user", err);
       }
     },
 
     async del(userID) {
+      if (!User) throw new Error(DB_NOT_INIT);
       try {
-        if (!userID) throw new Error("userID is required and cannot be undefined");
-        userID = validateUserID(userID);
+        userID = validateId(userID, ID_FIELD);
         const result = await User.destroy({ where: { userID } });
         if (result === 0) throw new Error("No user found with the specified userID");
         return result;
-      } catch (error) {
-        throw new Error(`Failed to delete user: ${error.message}`);
+      } catch (err) {
+        throw wrapError("Failed to delete user", err);
       }
     },
 
     async delAll() {
+      if (!User) return 0;
       try {
         return await User.destroy({ where: {} });
-      } catch (error) {
-        throw new Error(`Failed to delete all users: ${error.message}`);
+      } catch (err) {
+        throw wrapError("Failed to delete all users", err);
       }
     },
 
     async getAll(keys = null) {
+      if (!User) return [];
       try {
-        const attributes = typeof keys === "string" ? [keys] : Array.isArray(keys) ? keys : undefined;
-        const users = await User.findAll({ attributes });
-        return users.map(u => u.get());
-      } catch (error) {
-        throw new Error(`Failed to get all users: ${error.message}`);
+        const attributes = normalizeAttributes(keys);
+        const rows = await User.findAll({ attributes });
+        return rows.map((u) => u.get());
+      } catch (err) {
+        throw wrapError("Failed to get all users", err);
       }
     }
   };