ayman-fca 1.0.0

package/module/options.js

@@ -0,0 +1,37 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Options Handler
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const { getType } = require("../src/utils/format");
+const { setProxy } = require("../src/utils/request");
+const logger = require("../func/logger");
+
+const BOOL_OPTIONS = [
+  "online","selfListen","listenEvents","updatePresence","forceLogin",
+  "autoMarkRead","autoMarkDelivery","listenTyping","autoReconnect",
+  "emitReady","selfListenEvent"
+];
+
+// خيارات قديمة يتم تجاهلها بصمت
+const IGNORED = new Set(["logLevel","pauseLog","logRecordSize","updateSeq"]);
+
+function setOptions(globalOptions, options) {
+  for (const key of Object.keys(options || {})) {
+    if (IGNORED.has(key)) continue;
+    if (BOOL_OPTIONS.includes(key)) { globalOptions[key] = Boolean(options[key]); continue; }
+    switch (key) {
+      case "userAgent": globalOptions.userAgent = options.userAgent; break;
+      case "pageID":    globalOptions.pageID    = String(options.pageID); break;
+      case "proxy":
+        if (typeof options.proxy !== "string") { delete globalOptions.proxy; setProxy(); }
+        else { globalOptions.proxy = options.proxy; setProxy(options.proxy); }
+        break;
+      default:
+        logger(`[ AYMAN ] setOptions: خيار غير معروف "${key}"`, "warn");
+    }
+  }
+}
+
+module.exports = { setOptions, BOOL_OPTIONS };

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "ayman-fca",
+  "version": "1.0.0",
+  "description": "Facebook Chat API for Node.js — مكتبة KIRA بوت | © 2025 Ayman",
+  "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/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "echo \"ayman-fca v1.0 by Ayman\""
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ayman/ayman-fca.git"
+  },
+  "keywords": [
+    "facebook", "messenger", "chat", "api", "bot",
+    "kira", "ayman", "fca", "unofficial", "nodejs",
+    "automation", "facebook-api", "chatbot"
+  ],
+  "author": {
+    "name": "Ayman",
+    "url": "https://www.facebook.com/ayman"
+  },
+  "contributors": [
+    {
+      "name": "Ayman",
+      "url": "https://github.com/ayman"
+    }
+  ],
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/ayman/ayman-fca/issues"
+  },
+  "homepage": "https://github.com/ayman/ayman-fca#readme",
+  "engines": {
+    "node": ">=16.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",
+    "form-data": "^4.0.0",
+    "gradient-string": "^2.0.2",
+    "https-proxy-agent": "^7.0.0",
+    "mqtt": "^5.3.4",
+    "sequelize": "^6.37.6",
+    "sqlite3": "^5.1.7",
+    "tough-cookie": "^4.1.4",
+    "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/addExternalModule.js

@@ -0,0 +1,19 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Add External Module
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const { getType } = require("../../utils/format");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function addExternalModule(moduleObj) {
+    if (getType(moduleObj) !== "Object")
+      throw new Error(`moduleObj يجب أن يكون Object وليس ${getType(moduleObj)}`);
+    for (const name in moduleObj) {
+      if (getType(moduleObj[name]) !== "Function")
+        throw new Error(`"${name}" يجب أن يكون Function`);
+      api[name] = moduleObj[name](defaultFuncs, api, ctx);
+    }
+  };
+};

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,48 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Change Bio
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"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 resolve, reject;
+    const p = new Promise((res, rej) => { resolve = res; reject = rej; });
+
+    if (getType(publish) === "Function" || getType(publish) === "AsyncFunction") {
+      callback = publish; publish = false;
+    }
+    callback = callback || (err => err ? reject(err) : resolve());
+    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,
+          publish_bio_feed_story: publish,
+          actor_id: ctx.i_userID || ctx.userID,
+          client_mutation_id: String(Math.round(Math.random() * 1024))
+        },
+        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(res => { if (res.errors) throw res; callback(); })
+      .catch(err => { log.error("changeBio", err); callback(err); });
+
+    return p;
+  };
+};

package/src/api/action/enableAutoSaveAppState.js

@@ -0,0 +1,72 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Auto Save AppState
+//  © 2025 Ayman. All Rights Reserved.
+//
+//  حفظ ذكي: لا يحفظ إذا لم تتغير البيانات
+//  Atomic write: يحمي الملف من التلف
+//  يحفظ عند SIGINT/SIGTERM
+// ============================================================
+"use strict";
+
+const fs   = require("fs");
+const path = require("path");
+const logger = require("../../../func/logger");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function enableAutoSaveAppState(options = {}) {
+    const filePath   = options.filePath || path.join(process.cwd(), "appstate.json");
+    const intervalMs = options.interval || 8 * 60 * 1000; // 8 دقائق
+    const saveOnLogin= options.saveOnLogin !== false;
+
+    let lastHash = null;
+
+    function hashState(state) {
+      return state.length + "_" + (state[0]?.value?.length || 0);
+    }
+
+    function saveState(force = false) {
+      try {
+        const state = api.getAppState();
+        if (!state || state.length === 0) { logger("[ AYMAN ] AppState فارغ — تخطي", "warn"); return; }
+
+        const h = hashState(state);
+        if (!force && h === lastHash) return; // لا تغيير
+        lastHash = h;
+
+        // Atomic write
+        const tmp = filePath + ".tmp";
+        fs.writeFileSync(tmp, JSON.stringify(state, null, "\t"), "utf8");
+        fs.renameSync(tmp, filePath);
+        logger(`[ AYMAN ] AppState محفوظ ✅ (${filePath})`, "info");
+      } catch (err) {
+        logger(`[ AYMAN ] خطأ حفظ AppState: ${err?.message || err}`, "error");
+      }
+    }
+
+    // حفظ فوري عند اللوجين
+    let initTimer = null;
+    if (saveOnLogin) { initTimer = setTimeout(() => { saveState(true); initTimer = null; }, 2000); }
+
+    // حفظ دوري
+    const intervalId = setInterval(() => saveState(), intervalMs);
+    logger(`[ AYMAN ] حفظ تلقائي كل ${Math.round(intervalMs/60000)} دقيقة ✅`, "info");
+
+    if (!ctx._autoSaveInterval) ctx._autoSaveInterval = [];
+    ctx._autoSaveInterval.push(intervalId);
+
+    // حفظ عند الإيقاف
+    const exitHandler = () => saveState(true);
+    process.once("SIGINT",  exitHandler);
+    process.once("SIGTERM", exitHandler);
+
+    return function disableAutoSaveAppState() {
+      if (initTimer) { clearTimeout(initTimer); initTimer = null; }
+      clearInterval(intervalId);
+      process.removeListener("SIGINT",  exitHandler);
+      process.removeListener("SIGTERM", exitHandler);
+      const idx = ctx._autoSaveInterval?.indexOf(intervalId) ?? -1;
+      if (idx !== -1) ctx._autoSaveInterval.splice(idx, 1);
+      logger("[ AYMAN ] تم إيقاف الحفظ التلقائي", "info");
+    };
+  };
+};

package/src/api/action/getCurrentUserID.js

@@ -0,0 +1,11 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Get Current User ID
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function getCurrentUserID() {
+    return ctx.userID;
+  };
+};

package/src/api/action/handleFriendRequest.js

@@ -0,0 +1,33 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Handle Friend Request
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const log = require("../../../func/logAdapter");
+const { parseAndCheckLogin } = require("../../utils/client");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function handleFriendRequest(userID, accept, callback) {
+    if (typeof accept !== "boolean") throw { error: "accept يجب أن يكون boolean" };
+
+    let resolve, reject;
+    const p = new Promise((res, rej) => { resolve = res; reject = rej; });
+    callback = callback || (err => err ? reject(err) : resolve());
+
+    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(res => { if (res.payload?.err) throw { err: res.payload.err }; callback(); })
+      .catch(err => { log.error("handleFriendRequest", err); callback(err); });
+
+    return p;
+  };
+};

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,62 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Refresh fb_dtsg
+//  © 2025 Ayman. All Rights Reserved.
+//
+//  تجديد تلقائي كل 6 ساعات + retry 3 مرات عند الفشل
+// ============================================================
+"use strict";
+
+const { getFrom } = require("../../utils/constants");
+const { get }     = require("../../utils/request");
+const { getType } = require("../../utils/format");
+const logger      = require("../../../func/logger");
+
+module.exports = function(defaultFuncs, api, ctx) {
+
+  // ✅ تجديد تلقائي كل 6 ساعات
+  if (ctx._fbDtsgInterval) clearInterval(ctx._fbDtsgInterval);
+  ctx._fbDtsgInterval = setInterval(async () => {
+    try {
+      await api.refreshFb_dtsg();
+      logger("[ AYMAN ] fb_dtsg مجدد تلقائياً ✅", "info");
+    } catch (_) {}
+  }, 6 * 60 * 60 * 1000);
+
+  return function refreshFb_dtsg(obj, callback) {
+    if (typeof obj === "function") { callback = obj; obj = {}; }
+    if (!obj || getType(obj) !== "Object") obj = {};
+
+    let resolve, reject;
+    const p = new Promise((res, rej) => { resolve = res; reject = rej; });
+    if (!callback) callback = (err, data) => err ? reject(err) : resolve(data);
+
+    if (Object.keys(obj).length === 0) {
+      // ✅ 3 محاولات عند الفشل
+      const tryRefresh = async (attempt = 0) => {
+        try {
+          const res  = await get("https://www.facebook.com/", ctx.jar, null, ctx.globalOptions, { noRef: true });
+          const html = res?.data || "";
+          const dtsg = getFrom(html, '["DTSGInitData",[],{"token":"', '","');
+          const jaz  = getFrom(html, "jazoest=", '",');
+
+          if (!dtsg) {
+            if (attempt < 2) { await new Promise(r => setTimeout(r, 2000)); return tryRefresh(attempt + 1); }
+            throw new Error("[ AYMAN ] لم يُعثر على fb_dtsg بعد 3 محاولات");
+          }
+
+          Object.assign(ctx, { fb_dtsg: dtsg, ...(jaz ? { jazoest: jaz } : {}) });
+          callback(null, { data: { fb_dtsg: dtsg, jazoest: jaz }, message: "تم تجديد fb_dtsg ✅" });
+        } catch (err) {
+          if (attempt < 2) { await new Promise(r => setTimeout(r, 2000)); return tryRefresh(attempt + 1); }
+          callback(err);
+        }
+      };
+      tryRefresh();
+    } else {
+      Object.assign(ctx, obj);
+      callback(null, { data: obj, message: `تم تجديد: ${Object.keys(obj).join(", ")}` });
+    }
+
+    return p;
+  };
+};

package/src/api/action/setPostReaction.js

@@ -0,0 +1,106 @@
+"use strict";
+
+const log = require("../../../func/logAdapter");
+const { parseAndCheckLogin } = require("../../utils/client");
+const { getType } = require("../../utils/format");
+function formatData(resData) {
+  return {
+    viewer_feedback_reaction_info:
+      resData.feedback_react.feedback.viewer_feedback_reaction_info,
+    supported_reactions: resData.feedback_react.feedback.supported_reactions,
+    top_reactions: resData.feedback_react.feedback.top_reactions.edges,
+    reaction_count: resData.feedback_react.feedback.reaction_count
+  };
+}
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function setPostReaction(postID, type, callback) {
+    let resolveFunc = function() {};
+    let rejectFunc = function() {};
+    const returnPromise = new Promise(function(resolve, reject) {
+      resolveFunc = resolve;
+      rejectFunc = reject;
+    });
+
+    if (!callback) {
+      if (
+        getType(type) === "Function" ||
+        getType(type) === "AsyncFunction"
+      ) {
+        callback = type;
+        type = 0;
+      } else {
+        callback = function(err, data) {
+          if (err) {
+            return rejectFunc(err);
+          }
+          resolveFunc(data);
+        };
+      }
+    }
+
+    const map = {
+      unlike: 0,
+      like: 1,
+      heart: 2,
+      love: 16,
+      haha: 4,
+      wow: 3,
+      sad: 7,
+      angry: 8
+    };
+
+    if (getType(type) !== "Number" && getType(type) === "String") {
+      type = map[type.toLowerCase()];
+    }
+
+    if (getType(type) !== "Number" && getType(type) !== "String") {
+      throw {
+        error: "setPostReaction: Invalid reaction type"
+      };
+    }
+
+    if (type != 0 && !type) {
+      throw {
+        error: "setPostReaction: Invalid reaction type"
+      };
+    }
+
+    const form = {
+      av: ctx.userID,
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "CometUFIFeedbackReactMutation",
+      doc_id: "4769042373179384",
+      variables: JSON.stringify({
+        input: {
+          actor_id: ctx.userID,
+          feedback_id: Buffer.from("feedback:" + postID).toString("base64"),
+          feedback_reaction: type,
+          feedback_source: "OBJECT",
+          is_tracking_encrypted: true,
+          tracking: [],
+          session_id: "f7dd50dd-db6e-4598-8cd9-561d5002b423",
+          client_mutation_id: Math.round(Math.random() * 19).toString()
+        },
+        useDefaultActor: false,
+        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, formatData(resData.data));
+      })
+      .catch(function(err) {
+        log.error("setPostReaction", err);
+        return callback(err);
+      });
+
+    return returnPromise;
+  };
+};