ayman-fca 1.0.0

package/src/api/action/story.js

@@ -0,0 +1,118 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Story API
+//  © 2025 Ayman. All Rights Reserved.
+//  مستوحى من: ws3-fca | مطوَّر بواسطة أيمن
+//
+//  api.story.create(text, font, background)
+//  api.story.react(storyID, emoji)
+//  api.story.msg(storyID, message)
+// ============================================================
+"use strict";
+
+module.exports = function(defaultFuncs, api, ctx) {
+
+  const FONTS = {
+    headline: "1919119914775364",
+    classic:  "516266749248495",
+    fancy:    "1790435664339626",
+    casual:   "516266749248495"
+  };
+
+  const BACKGROUNDS = {
+    orange: "2163607613910521",
+    blue:   "401372137331149",
+    green:  "367314917184744",
+    modern: "554617635055752",
+    red:    "1234567890123456"
+  };
+
+  const ALLOWED_REACTIONS = ["❤️","👍","🤗","😆","😡","😢","😮"];
+
+  function getStoryID(urlOrID) {
+    try {
+      const u     = new URL(urlOrID);
+      const parts = u.pathname.split("/");
+      const idx   = parts.indexOf("stories");
+      if (idx !== -1 && parts.length > idx + 2) return parts[idx + 2];
+    } catch (_) {}
+    return urlOrID;
+  }
+
+  // ✅ إنشاء Story نصية
+  async function create(message, fontName = "classic", backgroundName = "blue") {
+    const fontId = FONTS[fontName.toLowerCase()]       || FONTS.classic;
+    const bgId   = BACKGROUNDS[backgroundName.toLowerCase()] || BACKGROUNDS.blue;
+
+    const variables = {
+      input: {
+        audiences: [{ stories: { self: { target_id: ctx.userID } } }],
+        audiences_is_complete: true,
+        logging: { composer_session_id: "ayman-story-" + Date.now() },
+        navigation_data: { attribution_id_v2: "StoriesCreateRoot.react,comet.stories.create" },
+        source: "WWW",
+        message: { ranges: [], text: message },
+        text_format_metadata: { inspirations_custom_font_id: fontId },
+        text_format_preset_id: bgId,
+        tracking: [null],
+        actor_id: ctx.userID,
+        client_mutation_id: "1"
+      }
+    };
+
+    const form = {
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "StoriesCreateMutation",
+      variables: JSON.stringify(variables),
+      doc_id: "24226878183562473"
+    };
+
+    const res     = await defaultFuncs.post("https://www.facebook.com/api/graphql/", ctx.jar, form);
+    const data    = res?.data || res;
+    if (data?.errors) throw new Error(JSON.stringify(data.errors));
+    const storyID = data?.data?.story_create?.viewer?.actor?.story_bucket?.nodes?.[0]?.first_story_to_show?.id;
+    if (!storyID) throw new Error("AYMAN-FCA: لم يُعثر على storyID");
+    return { success: true, storyID };
+  }
+
+  // ✅ رد أو تفاعل مع Story
+  async function sendStoryReply(storyIdOrUrl, message, isReaction) {
+    if (!storyIdOrUrl) throw new Error("AYMAN-FCA: storyID مطلوب");
+    if (!message)      throw new Error("AYMAN-FCA: message مطلوب");
+
+    const storyID   = getStoryID(storyIdOrUrl);
+    const variables = {
+      input: {
+        attribution_id_v2: "StoriesCometSuspenseRoot.react,comet.stories.viewer,via_cold_start",
+        message,
+        story_id:          storyID,
+        story_reply_type:  isReaction ? "LIGHT_WEIGHT" : "TEXT",
+        actor_id:          ctx.userID,
+        client_mutation_id: String(Math.floor(Math.random() * 10 + 1))
+      }
+    };
+
+    if (isReaction) {
+      if (!ALLOWED_REACTIONS.includes(message))
+        throw new Error(`AYMAN-FCA: تفاعل غير صالح. استخدم: ${ALLOWED_REACTIONS.join(" ")}`);
+      variables.input.lightweight_reaction_actions = { offsets: [0], reaction: message };
+    }
+
+    const form = {
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "useStoriesSendReplyMutation",
+      variables: JSON.stringify(variables),
+      doc_id: "9697491553691692"
+    };
+
+    const res  = await defaultFuncs.post("https://www.facebook.com/api/graphql/", ctx.jar, form);
+    const data = res?.data || res;
+    if (data?.errors) throw new Error(JSON.stringify(data.errors));
+    return { success: true, result: data?.data?.direct_message_reply };
+  }
+
+  return {
+    create,
+    react: (storyIdOrUrl, reaction) => sendStoryReply(storyIdOrUrl, reaction, true),
+    msg:   (storyIdOrUrl, message)  => sendStoryReply(storyIdOrUrl, message,  false)
+  };
+};

package/src/api/action/unfriend.js

@@ -0,0 +1,30 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Unfriend
+//  © 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 unfriend(userID, callback) {
+    let resolve, reject;
+    const p = new Promise((res, rej) => { resolve = res; reject = rej; });
+    callback = callback || (err => err ? reject(err) : resolve());
+
+    const form = {
+      uid:           userID,
+      unref:         "bd_friends_tab",
+      floc:          "friends_tab",
+      "nctr[_mod]":  `pagelet_timeline_app_collection_${ctx.userID}:2356318349:2`
+    };
+
+    defaultFuncs.post("https://www.facebook.com/ajax/profile/removefriendconfirm.php", ctx.jar, form)
+      .then(parseAndCheckLogin(ctx, defaultFuncs))
+      .then(res => { if (res.error) throw res; callback(null, true); })
+      .catch(err => { log.error("unfriend", err); callback(err); });
+
+    return p;
+  };
+};

package/src/api/http/httpGet.js

@@ -0,0 +1,28 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — HTTP GET
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const { getType } = require("../../utils/format");
+const { get }     = require("../../utils/request");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function httpGet(url, form, callback, notAPI) {
+    let resolve, reject;
+    const p = new Promise((res, rej) => { resolve = res; reject = rej; });
+
+    if (!callback && (getType(form) === "Function" || getType(form) === "AsyncFunction")) {
+      callback = form; form = {};
+    }
+    form     = form || {};
+    callback = callback || ((err, data) => err ? reject(err) : resolve(data));
+
+    const executor = notAPI ? get : defaultFuncs.get;
+    executor(url, ctx.jar, form)
+      .then(res => callback(null, res?.data ?? res))
+      .catch(err => callback(err));
+
+    return p;
+  };
+};

package/src/api/http/httpPost.js

@@ -0,0 +1,32 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — HTTP POST
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const { post }    = require("../../utils/request");
+const { getType } = require("../../utils/format");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function httpPost(url, form, callback, notAPI) {
+    let resolve, reject;
+    const p = new Promise((res, rej) => { resolve = res; reject = rej; });
+
+    if (!callback && (getType(form) === "Function" || getType(form) === "AsyncFunction")) {
+      callback = form; form = {};
+    }
+    form     = form || {};
+    callback = callback || ((err, data) => err ? reject(err) : resolve(data));
+
+    const executor = notAPI ? post : defaultFuncs.post;
+    executor(url, ctx.jar, form, ctx.globalOptions)
+      .then(res => {
+        let data = res?.data ?? res;
+        if (data && typeof data === "object") data = JSON.stringify(data, null, 2);
+        callback(null, data);
+      })
+      .catch(err => callback(err));
+
+    return p;
+  };
+};

package/src/api/http/postFormData.js

@@ -0,0 +1,23 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — HTTP POST Form Data
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const { postFormData } = require("../../utils/request");
+const { getType }      = require("../../utils/format");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function httpPostFormData(url, form, callback) {
+    let resolve, reject;
+    const p = new Promise((res, rej) => { resolve = res; reject = rej; });
+
+    callback = callback || ((err, data) => err ? reject(err) : resolve(data));
+
+    postFormData(url, ctx.jar, form || {}, {}, ctx.globalOptions, ctx)
+      .then(res => callback(null, res?.data ?? res))
+      .catch(err => callback(err));
+
+    return p;
+  };
+};

package/src/api/messaging/J

@@ -0,0 +1 @@
+

package/src/api/messaging/addUserToGroup.js

@@ -0,0 +1,70 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Add User To Group
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const { generateOfflineThreadingID, getType } = require("../../utils/format");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function addUserToGroup(userID, threadID, callback) {
+    return new Promise((resolve, reject) => {
+      if (!ctx.mqttClient) {
+        const err = new Error("AYMAN-FCA: MQTT غير متصل");
+        callback?.(err); return reject(err);
+      }
+      if (getType(threadID) !== "Number" && getType(threadID) !== "String") {
+        const err = new Error("threadID يجب أن يكون Number أو String");
+        callback?.(err); return reject(err);
+      }
+      if (getType(userID) !== "Array") userID = [userID];
+
+      const reqID  = ++ctx.wsReqNumber;
+      const taskID = ++ctx.wsTaskNumber;
+
+      const content = {
+        app_id:     "772021112871879",
+        payload:    JSON.stringify({
+          epoch_id: generateOfflineThreadingID(),
+          tasks: [{
+            failure_count: null,
+            label:         "23",
+            payload:       JSON.stringify({ thread_key: threadID, contact_ids: userID, sync_group: 1 }),
+            queue_name:    String(threadID),
+            task_id:       taskID
+          }],
+          version_id: "24502707779384158"
+        }),
+        request_id: reqID,
+        type:       3
+      };
+
+      let done = false;
+      const timer = setTimeout(() => {
+        if (done) return; done = true;
+        ctx.mqttClient?.removeListener("message", handleRes);
+        callback?.(null, { success: true }); resolve({ success: true });
+      }, 10000);
+
+      const handleRes = (topic, message) => {
+        if (topic !== "/ls_resp") return;
+        let msg;
+        try { msg = JSON.parse(message.toString()); msg.payload = JSON.parse(msg.payload); } catch { return; }
+        if (msg.request_id !== reqID) return;
+        if (done) return; done = true;
+        clearTimeout(timer);
+        ctx.mqttClient?.removeListener("message", handleRes);
+        callback?.(null, { success: true }); resolve({ success: true });
+      };
+
+      ctx.mqttClient.on("message", handleRes);
+      ctx.mqttClient.publish("/ls_req", JSON.stringify(content), { qos: 1, retain: false }, err => {
+        if (err) {
+          if (done) return; done = true;
+          clearTimeout(timer); ctx.mqttClient?.removeListener("message", handleRes);
+          callback?.(err); reject(err);
+        }
+      });
+    });
+  };
+};

package/src/api/messaging/changeAdminStatus.js

@@ -0,0 +1,72 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Change Admin Status
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const { generateOfflineThreadingID, getType } = require("../../utils/format");
+
+module.exports = function(defaultFuncs, api, ctx) {
+
+  function buildTasks(threadID, adminID, adminStatus) {
+    const ids    = getType(adminID) === "Array" ? adminID : [adminID];
+    const isAdm  = adminStatus ? 1 : 0;
+    return ids.map((id, i) => ({
+      failure_count: null,
+      label:         "25",
+      payload:       JSON.stringify({ thread_key: threadID, contact_id: id, is_admin: isAdm }),
+      queue_name:    "admin_status",
+      task_id:       i + 1
+    }));
+  }
+
+  function viaMqtt(threadID, adminID, adminStatus) {
+    if (!ctx.mqttClient) throw new Error("AYMAN-FCA: MQTT غير متصل");
+    if (typeof ctx.wsReqNumber !== "number") ctx.wsReqNumber = 0;
+    const reqID = ++ctx.wsReqNumber;
+    const form  = JSON.stringify({
+      app_id:     "2220391788200892",
+      payload:    JSON.stringify({
+        epoch_id:   generateOfflineThreadingID(),
+        tasks:      buildTasks(threadID, adminID, adminStatus),
+        version_id: "8798795233522156"
+      }),
+      request_id: reqID,
+      type:       3
+    });
+    return new Promise((resolve, reject) => {
+      ctx.mqttClient.publish("/ls_req", form, { qos: 1, retain: false }, err =>
+        err ? reject(err) : resolve({ success: true })
+      );
+    });
+  }
+
+  function viaHttp(threadID, adminID, adminStatus) {
+    if (typeof ctx.wsReqNumber !== "number") ctx.wsReqNumber = 0;
+    const reqID = ++ctx.wsReqNumber;
+    const form  = JSON.stringify({
+      app_id:     "772021112871879",
+      payload:    JSON.stringify({
+        epoch_id:      generateOfflineThreadingID(),
+        tasks:         buildTasks(threadID, adminID, adminStatus),
+        data_trace_id: null
+      }),
+      request_id: reqID,
+      type:       3
+    });
+    return new Promise((resolve, reject) => {
+      if (!ctx.mqttClient) return reject(new Error("AYMAN-FCA: MQTT غير متصل"));
+      ctx.mqttClient.publish("/ls_req", form, {}, err =>
+        err ? reject(err) : resolve()
+      );
+    });
+  }
+
+  return function changeAdminStatus(threadID, adminID, adminStatus) {
+    if (ctx.mqttClient) {
+      try { return viaMqtt(threadID, adminID, adminStatus); }
+      catch (_) { return viaHttp(threadID, adminID, adminStatus); }
+    }
+    return viaHttp(threadID, adminID, adminStatus);
+  };
+};

package/src/api/messaging/changeArchivedStatus.js

@@ -0,0 +1,31 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Change Archived Status
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const log = require("../../../func/logAdapter");
+const { parseAndCheckLogin } = require("../../utils/client");
+const { formatID } = require("../../utils/format");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function changeArchivedStatus(threadOrThreads, archive, callback) {
+    let resolve, reject;
+    const p = new Promise((res, rej) => { resolve = res; reject = rej; });
+    callback = callback || (err => err ? reject(err) : resolve());
+
+    const form = {};
+    const threads = Array.isArray(threadOrThreads) ? threadOrThreads : [threadOrThreads];
+    threads.forEach(t => { form[`ids[${formatID(t)}]`] = archive; });
+
+    defaultFuncs.post(
+      "https://www.facebook.com/ajax/mercury/change_archived_status.php",
+      ctx.jar, form
+    )
+      .then(parseAndCheckLogin(ctx, defaultFuncs))
+      .then(res => { if (res.error) throw res; callback(); })
+      .catch(err => { log.error("changeArchivedStatus", err); callback(err); });
+
+    return p;
+  };
+};

package/src/api/messaging/changeBlockedStatus.js

@@ -0,0 +1,27 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Change Blocked Status
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const log = require("../../../func/logAdapter");
+const { parseAndCheckLogin, saveCookies } = require("../../utils/client");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function changeBlockedStatus(userID, block, callback) {
+    let resolve, reject;
+    const p = new Promise((res, rej) => { resolve = res; reject = rej; });
+    callback = callback || (err => err ? reject(err) : resolve());
+
+    defaultFuncs.post(
+      `https://www.facebook.com/messaging/${block ? "" : "un"}block_messages/`,
+      ctx.jar, { fbid: userID }
+    )
+      .then(saveCookies(ctx.jar))
+      .then(parseAndCheckLogin(ctx, defaultFuncs))
+      .then(res => { if (res.error) throw res; callback(); })
+      .catch(err => { log.error("changeBlockedStatus", err); callback(err); });
+
+    return p;
+  };
+};

package/src/api/messaging/changeGroupImage.js

@@ -0,0 +1,91 @@
+"use strict";
+
+const { generateOfflineThreadingID } = require("../../utils/format");
+const log = require("../../../func/logAdapter");
+
+module.exports = function (defaultFuncs, api, ctx) {
+  function handleUpload(image) {
+    const form = {
+      images_only: "true",
+      fb_dtsg: ctx.fb_dtsg,
+      "attachment[]": image
+    };
+    return defaultFuncs
+      .postFormData("https://www.facebook.com/ajax/mercury/upload.php", ctx.jar, form, {})
+      .then(parseAndCheckLogin(ctx, defaultFuncs))
+      .then(resData => {
+        if (resData.error) throw resData;
+        return resData.payload.metadata[0];
+      });
+  }
+  return function changeGroupImage(image, threadID, callback) {
+    return new Promise((resolve, reject) => {
+      if (!ctx.mqttClient) {
+        const err = new Error("Not connected to MQTT");
+        callback?.(err);
+        return reject(err);
+      }
+      if (!threadID || typeof threadID !== "string") {
+        const err = new Error("Invalid threadID");
+        callback?.(err);
+        return reject(err);
+      }
+      const reqID = ++ctx.wsReqNumber;
+      const taskID = ++ctx.wsTaskNumber;
+      const onResponse = (topic, message) => {
+        if (topic !== "/ls_resp") return;
+        let jsonMsg;
+        try {
+          jsonMsg = JSON.parse(message.toString());
+          jsonMsg.payload = JSON.parse(jsonMsg.payload);
+        } catch (err) {
+          return;
+        }
+        if (jsonMsg.request_id !== reqID) return;
+        ctx.mqttClient.removeListener("message", onResponse);
+        callback?.(null, { success: true, response: jsonMsg.payload });
+        return resolve({ success: true, response: jsonMsg.payload });
+      };
+      ctx.mqttClient.on("message", onResponse);
+      handleUpload(image)
+        .then(payload => {
+          const imageID = payload.image_id;
+          const taskPayload = {
+            thread_key: threadID,
+            image_id: imageID,
+            sync_group: 1
+          };
+
+          const mqttPayload = {
+            epoch_id: generateOfflineThreadingID(),
+            tasks: [
+              {
+                failure_count: null,
+                label: "37",
+                payload: JSON.stringify(taskPayload),
+                queue_name: "thread_image",
+                task_id: taskID
+              }
+            ],
+            version_id: "8798795233522156"
+          };
+          const request = {
+            app_id: "2220391788200892",
+            payload: JSON.stringify(mqttPayload),
+            request_id: reqID,
+            type: 3
+          };
+          ctx.mqttClient.publish("/ls_req", JSON.stringify(request), {
+            qos: 1,
+            retain: false
+          });
+        })
+        .catch(err => {
+          ctx.mqttClient.removeListener("message", onResponse);
+          log.error("changeGroupImageMqtt", err);
+          callback?.(err);
+          reject(err);
+        });
+    });
+  };
+};

package/src/api/messaging/changeNickname.js

@@ -0,0 +1,70 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Change Nickname
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const { generateOfflineThreadingID } = require("../../utils/format");
+const log = require("../../../func/logAdapter");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function changeNickname(nickname, threadID, participantID, callback) {
+    return new Promise((resolve, reject) => {
+      if (!ctx.mqttClient) {
+        const err = new Error("AYMAN-FCA: MQTT غير متصل");
+        callback?.(err); return reject(err);
+      }
+      if (!threadID || !participantID) {
+        const err = new Error("threadID و participantID مطلوبان");
+        callback?.(err); return reject(err);
+      }
+
+      const reqID  = ++ctx.wsReqNumber;
+      const taskID = ++ctx.wsTaskNumber;
+
+      const content = {
+        app_id:     "2220391788200892",
+        payload:    JSON.stringify({
+          epoch_id: generateOfflineThreadingID(),
+          tasks: [{
+            failure_count: null,
+            label:         "44",
+            payload:       JSON.stringify({ thread_key: threadID, contact_id: participantID, nickname: nickname || "", sync_group: 1 }),
+            queue_name:    "thread_participant_nickname",
+            task_id:       taskID
+          }],
+          version_id: "8798795233522156"
+        }),
+        request_id: reqID,
+        type:       3
+      };
+
+      let done = false;
+      const timer = setTimeout(() => {
+        if (done) return; done = true;
+        ctx.mqttClient?.removeListener("message", handleRes);
+        callback?.(null, { success: true }); resolve({ success: true });
+      }, 10000);
+
+      const handleRes = (topic, message) => {
+        if (topic !== "/ls_resp") return;
+        let msg;
+        try { msg = JSON.parse(message.toString()); msg.payload = JSON.parse(msg.payload); } catch { return; }
+        if (msg.request_id !== reqID) return;
+        if (done) return; done = true;
+        clearTimeout(timer);
+        ctx.mqttClient?.removeListener("message", handleRes);
+        callback?.(null, { success: true }); resolve({ success: true });
+      };
+
+      ctx.mqttClient.on("message", handleRes);
+      ctx.mqttClient.publish("/ls_req", JSON.stringify(content), { qos: 1, retain: false }, err => {
+        if (err) {
+          if (done) return; done = true;
+          clearTimeout(timer); ctx.mqttClient?.removeListener("message", handleRes);
+          log.error("changeNickname", err); callback?.(err); reject(err);
+        }
+      });
+    });
+  };
+};

package/src/api/messaging/changeThreadColor.js

@@ -0,0 +1,44 @@
+// ============================================================
+//  AYMAN-FCA v2.0 — Change Thread Color
+//  © 2025 Ayman. All Rights Reserved.
+// ============================================================
+"use strict";
+
+const { generateOfflineThreadingID } = require("../../utils/format");
+
+module.exports = function(defaultFuncs, api, ctx) {
+  return function changeThreadColor(color, threadID, callback) {
+    let resolve, reject;
+    const p = new Promise((res, rej) => { resolve = res; reject = rej; });
+    callback = callback || ((err, data) => err ? reject(err) : resolve(data));
+
+    if (!ctx.mqttClient) return callback(new Error("AYMAN-FCA: MQTT غير متصل"));
+
+    const reqID = ++ctx.wsReqNumber;
+    const content = {
+      app_id:     "2220391788200892",
+      payload:    JSON.stringify({
+        data_trace_id: null,
+        epoch_id:      parseInt(generateOfflineThreadingID()),
+        tasks: [{
+          failure_count: null,
+          label:         "43",
+          payload:       JSON.stringify({ thread_key: threadID, theme_fbid: color, source: null, sync_group: 1, payload: null }),
+          queue_name:    "thread_theme",
+          task_id:       ++ctx.wsTaskNumber
+        }],
+        version_id: "8798795233522156"
+      }),
+      request_id: reqID,
+      type:       3
+    };
+
+    ctx.mqttClient.publish("/ls_req", JSON.stringify(content), { qos: 1, retain: false }, err => {
+      if (err) return callback(err);
+      callback(null, { success: true, color, threadID });
+      resolve({ success: true });
+    });
+
+    return p;
+  };
+};