@eryxenx/fca 1.0.0

package/module/options.js

@@ -0,0 +1,44 @@
+const { getType } = require("../src/utils/format");
+const { setProxy } = require("../src/utils/request");
+const logger = require("../func/logger");
+const Boolean_Option = [
+  "online",
+  "selfListen",
+  "listenEvents",
+  "updatePresence",
+  "forceLogin",
+  "autoMarkRead",
+  "listenTyping",
+  "autoReconnect",
+  "emitReady",
+  "selfListenEvent"
+];
+function setOptions(globalOptions, options) {
+  for (const key of Object.keys(options || {})) {
+    if (Boolean_Option.includes(key)) {
+      globalOptions[key] = Boolean(options[key]);
+      continue;
+    }
+    switch (key) {
+      case "userAgent": {
+        globalOptions.userAgent = options.userAgent || "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36";
+        break;
+      }
+      case "proxy": {
+        if (typeof options.proxy !== "string") {
+          delete globalOptions.proxy;
+          setProxy();
+        } else {
+          globalOptions.proxy = options.proxy;
+          setProxy(globalOptions.proxy);
+        }
+        break;
+      }
+      default: {
+        logger("setOptions Unrecognized option given to setOptions: " + key, "warn");
+        break;
+      }
+    }
+  }
+}
+module.exports = { setOptions, Boolean_Option };

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@eryxenx/fca",
+  "version": "1.0.0",
+  "description": "Facebook Chat API by EryXenX | Stable • Auto Re-login • Full E2EE Support — send messages, media, reactions & more in encrypted chats, hassle-free",
+  "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",
+    "src/app/"
+  ],
+  "scripts": {
+    "test": "mocha",
+    "lint": "eslint ."
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EryXenX/fca-eryxenx.git"
+  },
+  "keywords": [
+    "facebook",
+    "chat",
+    "api",
+    "messenger",
+    "bot",
+    "unofficial",
+    "fca",
+    "fca-eryxenx",
+    "eryxenx"
+  ],
+  "author": {
+    "name": "EryXenX",
+    "url": "https://github.com/EryXenX"
+  },
+  "contributors": [
+    {
+      "name": "EryXenX",
+      "url": "https://github.com/EryXenX"
+    },
+    {
+      "name": "DongDev (Original)",
+      "url": "https://github.com/dongp06"
+    }
+  ],
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/EryXenX/fca-eryxenx/issues"
+  },
+  "homepage": "https://github.com/EryXenX/fca-eryxenx#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.12",
+    "duplexify": "^4.1.3",
+    "gradient-string": "^2.0.2",
+    "https-proxy-agent": "^4.0.0",
+    "mqtt": "^5.10.1",
+    "sequelize": "^6.37.6",
+    "sqlite3": "^5.1.7",
+    "totp-generator": "^1.0.0",
+    "ws": "^8.18.0",
+    "@noble/curves": "^2.2.0",
+    "@noble/hashes": "^2.2.0",
+    "@signalapp/libsignal-client": "0.70.0",
+    "mime": "^3.0.0",
+    "protobufjs": "^8.4.0",
+    "koffi": "^3.0.2",
+    "yumi-json-bigint": "^1.0.0",
+    "fca-unofficial": "github:VangBanLaNhat/fca-unofficial"
+  },
+  "devDependencies": {
+    "eslint": "^8.50.0",
+    "mocha": "^10.2.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/src/api/action/addExternalModule.js

@@ -0,0 +1,25 @@
+"use strict";
+
+const { getType } = require("../../utils/format");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function addExternalModule(moduleObj) {
+    if (getType(moduleObj) == "Object") {
+      for (const apiName in moduleObj) {
+        if (getType(moduleObj[apiName]) == "Function") {
+          api[apiName] = moduleObj[apiName](defaultFuncs, api, ctx);
+        } else {
+          throw new Error(
+            `Item "${apiName}" in moduleObj must be a function, not ${getType(
+              moduleObj[apiName]
+            )}!`
+          );
+        }
+      }
+    } else {
+      throw new Error(
+        `moduleObj must be an object, not ${getType(moduleObj)}!`
+      );
+    }
+  };
+};

package/src/api/action/changeAvatar.js

@@ -0,0 +1,137 @@
+"use strict";
+
+const log = require("../../../func/logAdapter");
+const { isReadableStream } = require("../../utils/constants");
+const { parseAndCheckLogin } = require("../../utils/client");
+const { formatID, getType } = require("../../utils/format");
+module.exports = function(defaultFuncs, api, ctx) {
+  function handleUpload(image, callback) {
+    const uploads = [];
+
+    const form = {
+      profile_id: ctx.userID,
+      photo_source: 57,
+      av: ctx.userID,
+      file: image
+    };
+
+    uploads.push(
+      defaultFuncs
+        .postFormData(
+          "https://www.facebook.com/profile/picture/upload/",
+          ctx.jar,
+          form,
+          {}
+        )
+        .then(parseAndCheckLogin(ctx, defaultFuncs))
+        .then(function(resData) {
+          if (resData.error) {
+            throw resData;
+          }
+          return resData;
+        })
+    );
+
+    // resolve all promises
+    Promise.all(uploads)
+      .then(function(resData) {
+        callback(null, resData);
+      })
+      .catch(function(err) {
+        log.error("handleUpload", err);
+        return callback(err);
+      });
+  }
+
+  return function changeAvatar(
+    image,
+    caption = "",
+    timestamp = null,
+    callback
+  ) {
+    let resolveFunc = function() {};
+    let rejectFunc = function() {};
+    const returnPromise = new Promise(function(resolve, reject) {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!timestamp && getType(caption) === "Number") {
+      timestamp = caption;
+      caption = "";
+    }
+
+    if (
+      !timestamp &&
+      !callback &&
+      (getType(caption) == "Function" ||
+        getType(caption) == "AsyncFunction")
+    ) {
+      callback = caption;
+      caption = "";
+      timestamp = null;
+    }
+
+    if (!callback)
+      callback = function(err, data) {
+        if (err) {
+          return rejectFunc(err);
+        }
+        resolveFunc(data);
+      };
+
+    if (!isReadableStream(image))
+      return callback("Image is not a readable stream");
+
+    handleUpload(image, function(err, payload) {
+      if (err) {
+        return callback(err);
+      }
+
+      const form = {
+        av: ctx.i_userID || ctx.userID,
+        fb_api_req_friendly_name: "ProfileCometProfilePictureSetMutation",
+        fb_api_caller_class: "RelayModern",
+        doc_id: "5066134240065849",
+        variables: JSON.stringify({
+          input: {
+            caption,
+            existing_photo_id: payload[0].payload.fbid,
+            expiration_time: timestamp,
+            profile_id: ctx.i_userID || ctx.userID,
+            profile_pic_method: "EXISTING",
+            profile_pic_source: "TIMELINE",
+            scaled_crop_rect: {
+              height: 1,
+              width: 1,
+              x: 0,
+              y: 0
+            },
+            skip_cropping: true,
+            actor_id: ctx.i_userID || ctx.userID,
+            client_mutation_id: Math.round(Math.random() * 19).toString()
+          },
+          isPage: false,
+          isProfile: true,
+          scale: 3
+        })
+      };
+
+      defaultFuncs
+        .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+        .then(parseAndCheckLogin(ctx, defaultFuncs))
+        .then(function(resData) {
+          if (resData.errors) {
+            throw resData;
+          }
+          return callback(null, resData[0].data.profile_picture_set);
+        })
+        .catch(function(err) {
+          log.error("changeAvatar", err);
+          return callback(err);
+        });
+    });
+
+    return returnPromise;
+  };
+};

package/src/api/action/changeBio.js

@@ -0,0 +1,75 @@
+"use strict";
+
+const log = require("../../../func/logAdapter");
+const { parseAndCheckLogin } = require("../../utils/client");
+const { getType } = require("../../utils/format");
+module.exports = function(defaultFuncs, api, ctx) {
+  return function changeBio(bio, publish, callback) {
+    let resolveFunc = function() {};
+    let rejectFunc = function() {};
+    const returnPromise = new Promise(function(resolve, reject) {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!callback) {
+      if (
+        getType(publish) == "Function" ||
+        getType(publish) == "AsyncFunction"
+      ) {
+        callback = publish;
+      } else {
+        callback = function(err) {
+          if (err) {
+            return rejectFunc(err);
+          }
+          resolveFunc();
+        };
+      }
+    }
+
+    if (getType(publish) != "Boolean") {
+      publish = false;
+    }
+
+    if (getType(bio) != "String") {
+      bio = "";
+      publish = false;
+    }
+
+    const form = {
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "ProfileCometSetBioMutation",
+      doc_id: "2725043627607610",
+      variables: JSON.stringify({
+        input: {
+          bio: bio,
+          publish_bio_feed_story: publish,
+          actor_id: ctx.i_userID || ctx.userID,
+          client_mutation_id: Math.round(Math.random() * 1024).toString()
+        },
+        hasProfileTileViewID: false,
+        profileTileViewID: null,
+        scale: 1
+      }),
+      av: ctx.i_userID || ctx.userID
+    };
+
+    defaultFuncs
+      .post("https://www.facebook.com/api/graphql/", ctx.jar, form)
+      .then(parseAndCheckLogin(ctx, defaultFuncs))
+      .then(function(resData) {
+        if (resData.errors) {
+          throw resData;
+        }
+
+        return callback();
+      })
+      .catch(function(err) {
+        log.error("changeBio", err);
+        return callback(err);
+      });
+
+    return returnPromise;
+  };
+};

package/src/api/action/enableAutoSaveAppState.js

@@ -0,0 +1,73 @@
+"use strict";
+const fs = require("fs");
+const path = require("path");
+const logger = require("../../../func/logger");
+
+/**
+ * Enable automatic AppState saving
+ * @param {Object} options - Options for auto-save
+ * @param {string} [options.filePath] - Path to save AppState (default: "appstate.json")
+ * @param {number} [options.interval] - Save interval in milliseconds (default: 10 minutes)
+ * @param {boolean} [options.saveOnLogin] - Save immediately on login (default: true)
+ * @returns {Function} Function to disable auto-save
+ */
+module.exports = function (defaultFuncs, api, ctx) {
+  return function enableAutoSaveAppState(options = {}) {
+    const filePath = options.filePath || path.join(process.cwd(), "appstate.json");
+    const interval = options.interval || 10 * 60 * 1000; // 10 minutes default
+    const saveOnLogin = options.saveOnLogin !== false; // default true
+
+    // Save function
+    function saveAppState() {
+      try {
+        const appState = api.getAppState();
+        if (!appState || !appState.appState || appState.appState.length === 0) {
+          logger("AppState is empty, skipping save", "warn");
+          return;
+        }
+
+        const data = JSON.stringify(appState, null, 2);
+        fs.writeFileSync(filePath, data, "utf8");
+        logger(`AppState saved to ${filePath}`, "info");
+      } catch (error) {
+        logger(`Error saving AppState: ${error && error.message ? error.message : String(error)}`, "error");
+      }
+    }
+
+    // Save immediately if requested
+    let immediateSaveTimer = null;
+    if (saveOnLogin) {
+      // Delay a bit to ensure login is complete
+      immediateSaveTimer = setTimeout(() => {
+        saveAppState();
+        immediateSaveTimer = null;
+      }, 2000);
+    }
+
+    // Set up interval
+    const intervalId = setInterval(saveAppState, interval);
+    logger(`Auto-save AppState enabled: ${filePath} (every ${Math.round(interval / 1000 / 60)} minutes)`, "info");
+
+    // Store interval ID for cleanup
+    if (!ctx._autoSaveInterval) {
+      ctx._autoSaveInterval = [];
+    }
+    ctx._autoSaveInterval.push(intervalId);
+
+    // Return disable function
+    return function disableAutoSaveAppState() {
+      // Clear immediate save timer if still pending
+      if (immediateSaveTimer) {
+        clearTimeout(immediateSaveTimer);
+        immediateSaveTimer = null;
+      }
+      // Clear interval
+      clearInterval(intervalId);
+      const index = ctx._autoSaveInterval ? ctx._autoSaveInterval.indexOf(intervalId) : -1;
+      if (index !== -1) {
+        ctx._autoSaveInterval.splice(index, 1);
+      }
+      logger("Auto-save AppState disabled", "info");
+    };
+  };
+};

package/src/api/action/getCurrentUserID.js

@@ -0,0 +1,7 @@
+"use strict";
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function getCurrentUserID() {
+    return ctx.userID;
+  };
+};

package/src/api/action/handleFriendRequest.js

@@ -0,0 +1,57 @@
+"use strict";
+
+const log = require("../../../func/logAdapter");
+const { parseAndCheckLogin } = require("../../utils/client");
+const { getType } = require("../../utils/format");
+module.exports = function(defaultFuncs, api, ctx) {
+  return function handleFriendRequest(userID, accept, callback) {
+    if (getType(accept) !== "Boolean") {
+      throw {
+        error: "Please pass a boolean as a second argument."
+      };
+    }
+
+    let resolveFunc = function() {};
+    let rejectFunc = function() {};
+    const returnPromise = new Promise(function(resolve, reject) {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!callback) {
+      callback = function(err, friendList) {
+        if (err) {
+          return rejectFunc(err);
+        }
+        resolveFunc(friendList);
+      };
+    }
+
+    const form = {
+      viewer_id: ctx.userID,
+      "frefs[0]": "jwl",
+      floc: "friend_center_requests",
+      ref: "/reqs.php",
+      action: accept ? "confirm" : "reject"
+    };
+
+    defaultFuncs
+      .post("https://www.facebook.com/requests/friends/ajax/", ctx.jar, form)
+      .then(parseAndCheckLogin(ctx, defaultFuncs))
+      .then(function(resData) {
+        if (resData.payload.err) {
+          throw {
+            err: resData.payload.err
+          };
+        }
+
+        return callback();
+      })
+      .catch(function(err) {
+        log.error("handleFriendRequest", err);
+        return callback(err);
+      });
+
+    return returnPromise;
+  };
+};

package/src/api/action/logout.js

@@ -0,0 +1,76 @@
+"use strict";
+
+const log = require("../../../func/logAdapter");
+const { parseAndCheckLogin } = require("../../utils/client");
+const { getFrom } = require("../../utils/constants");
+const { saveCookies } = require("../../utils/client");
+module.exports = function(defaultFuncs, api, ctx) {
+  return function logout(callback) {
+    let resolveFunc = function() {};
+    let rejectFunc = function() {};
+    const returnPromise = new Promise(function(resolve, reject) {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!callback) {
+      callback = function(err, friendList) {
+        if (err) {
+          return rejectFunc(err);
+        }
+        resolveFunc(friendList);
+      };
+    }
+
+    const form = {
+      pmid: "0"
+    };
+
+    defaultFuncs
+      .post(
+        "https://www.facebook.com/bluebar/modern_settings_menu/?help_type=364455653583099&show_contextual_help=1",
+        ctx.jar,
+        form
+      )
+      .then(parseAndCheckLogin(ctx, defaultFuncs))
+      .then(function(resData) {
+        const elem = resData.jsmods.instances[0][2][0].filter(function(v) {
+          return v.value === "logout";
+        })[0];
+
+        const html = resData.jsmods.markup.filter(function(v) {
+          return v[0] === elem.markup.__m;
+        })[0][1].__html;
+
+        const form = {
+          fb_dtsg: getFrom(html, '"fb_dtsg" value="', '"'),
+          ref: getFrom(html, '"ref" value="', '"'),
+          h: getFrom(html, '"h" value="', '"')
+        };
+
+        return defaultFuncs
+          .post("https://www.facebook.com/logout.php", ctx.jar, form)
+          .then(saveCookies(ctx.jar));
+      })
+      .then(function(res) {
+        if (!res.headers) {
+          throw { error: "An error occurred when logging out." };
+        }
+
+        return defaultFuncs
+          .get(res.headers.location, ctx.jar)
+          .then(saveCookies(ctx.jar));
+      })
+      .then(function() {
+        ctx.loggedIn = false;
+        log.info("logout", "Logged out successfully.");
+        callback();
+      })
+      .catch(function(err) {
+        log.error("logout", err);
+        return callback(err);
+      });
+
+    return returnPromise;
+  };
+};

package/src/api/action/refreshFb_dtsg.js

@@ -0,0 +1,48 @@
+"use strict";
+
+const log = require("../../../func/logAdapter");
+const { getFrom } = require("../../utils/constants");
+const { get } = require("../../utils/request")
+const { getType } = require("../../utils/format");
+module.exports = function (defaultFuncs, api, ctx) {
+  return function refreshFb_dtsg(obj, callback) {
+    if (typeof obj === "function") {
+      callback = obj;
+      obj = {};
+    }
+    if (!obj) obj = {};
+    if (getType(obj) !== "Object") {
+      throw new CustomError("The first parameter must be an object or a callback function");
+    }
+    let resolveFunc, rejectFunc;
+    const returnPromise = new Promise((resolve, reject) => {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+    if (!callback) {
+      callback = (err, data) => err ? rejectFunc(err) : resolveFunc(data);
+    }
+    if (Object.keys(obj).length === 0) {
+      get("https://www.facebook.com/", ctx.jar, null, ctx.globalOptions, { noRef: true }).then(({ data }) => {
+        const fb_dtsg = getFrom(data, '["DTSGInitData",[],{"token":"', '","');
+        const jazoest = getFrom(data, "jazoest=", '",');
+        if (!fb_dtsg) throw new Error("Could not find fb_dtsg in HTML after requesting Facebook.");
+        Object.assign(ctx, { fb_dtsg, jazoest });
+        callback(null, {
+          data: { fb_dtsg, jazoest },
+          message: "Refreshed fb_dtsg and jazoest",
+        });
+      }).catch(err => {
+        console.error("refreshFb_dtsg", err);
+        callback(err);
+      });
+    } else {
+      Object.assign(ctx, obj);
+      callback(null, {
+        data: obj,
+        message: `Refreshed ${Object.keys(obj).join(", ")}`,
+      });
+    }
+    return returnPromise;
+  };
+};