ayman-fca 1.0.1 → 1.0.3

package/index.js

@@ -1,15 +1,297 @@
 // ============================================================
-//  AYMAN-FCA v2.0
-//  Facebook Chat API for Node.js
+//  AYMAN-FCA v2.0 — ULTRA MASTER ENGINE
 //  © 2025 Ayman. All Rights Reserved.
-//  جميع الحقوق محفوظة لأيمن
 //
-//  مكتبة مخصصة لبوت KIRA
-//  تدوم بـ AppState واحد شهراً أو أكثر
+//  يجمع كل الأنظمة:
+//  ① SessionManager   — جلسة + backup + validate
+//  ② ReconnectEngine  — Circuit Breaker + backoff
+//  ③ KeepAliveEngine  — نشاط حقيقي كل 4 دقائق
+//  ④ Watchdog         — مراقبة MQTT + صمت
+//  ⑤ HealthMonitor    — Score 0-100
+//  ⑥ MemoryManager    — تنظيف ذاكرة
+//  ⑦ BehaviorEngine   — محاكاة إنسان
+//  ⑧ SmartCooldown    — تحكم ذكي بالسرعة
+//  ⑨ SilentRecovery   — Soft Restart + Silent Mode
+//  ⑩ SmartMessageQueue— Queue ذكي
+//  ⑪ GeoGuard         — حماية الموقع الجغرافي
 // ============================================================
+"use strict";
 
-const login = require("./module/login");
+const EventEmitter      = require("events");
+const path              = require("path");
 
-module.exports         = login;
-module.exports.login   = login;
-module.exports.default = login;
+const logger            = require("../func/logger");
+const SessionManager    = require("./core/sessionManager");
+const ReconnectEngine   = require("./core/reconnectEngine");
+const KeepAliveEngine   = require("./core/keepAliveEngine");
+const Watchdog          = require("./core/watchdog");
+const HealthMonitor     = require("./core/healthMonitor");
+const MemoryManager     = require("./core/memoryManager");
+const BehaviorEngine    = require("./core/behaviorEngine");
+const SmartCooldown     = require("./core/smartCooldown");
+const SilentRecovery    = require("./core/silentRecovery");
+const SmartMessageQueue = require("./core/smartMessageQueue");
+const GeoGuard          = require("./core/geoGuard");
+const { EVENTS }        = require("./system/constants");
+const { isSessionError }= require("./system/errors");
+
+class AymanFCAUltra extends EventEmitter {
+  constructor(options = {}) {
+    super();
+    this._appStatePath = options.appStatePath || path.join(process.cwd(), "appstate.json");
+    this._onMessage    = options.onMessage    || null;
+    this._api          = null;
+    this._ctx          = null;
+    this._restarting   = false;
+    this._startedAt    = Date.now();
+
+    // ── الأنظمة ──────────────────────────────────────────────
+    this.session   = new SessionManager({ primaryPath: this._appStatePath, onSave: options.onSave || null });
+    this.reconnect = new ReconnectEngine();
+    this.keepAlive = new KeepAliveEngine();
+    this.watchdog  = new Watchdog();
+    this.health    = new HealthMonitor();
+    this.memory    = new MemoryManager();
+    this.behavior  = new BehaviorEngine({ sessionStart: this._startedAt });
+    this.cooldown  = new SmartCooldown();
+    this.silent    = new SilentRecovery();
+    this.queue     = new SmartMessageQueue({ noise: true });
+    this.geo       = new GeoGuard({ lockRegion: true });
+
+    this._wireSystems();
+    logger.banner();
+  }
+
+  // ── ربط الأنظمة ببعضها ──────────────────────────────────
+  _wireSystems() {
+    // Watchdog → restart
+    this.watchdog.on(EVENTS.WATCHDOG_RESTART, ({ reasons }) => {
+      this.health.penalize("mqtt_dead");
+      this._restart("watchdog: " + reasons);
+    });
+
+    // Health Critical → restart
+    this.health.on(EVENTS.HEALTH_CRITICAL, ({ score }) => {
+      logger.error(`Health منخفض (${score}) — restart`, "ULTRA");
+      this._restart("health_critical");
+    });
+
+    // Session Expired → restart
+    this.session.on(EVENTS.SESSION_EXPIRED, () => {
+      this.health.penalize("session_expired");
+      this._restart("session_expired");
+    });
+
+    // Memory High → risk up + pause queue
+    this.memory.on(EVENTS.MEMORY_HIGH, () => {
+      this.health.penalize("memory_high");
+      this.queue.setRiskLevel("high");
+    });
+
+    // Silent Mode → pause queue
+    this.silent.on("silent:enter", () => {
+      this.queue.pause("silent_mode");
+      this.cooldown.recordError();
+    });
+    this.silent.on("silent:exit", () => {
+      this.queue.resume();
+    });
+
+    // Reconnect events
+    this.reconnect.on(EVENTS.RECONNECT_DONE, () => {
+      this.health.reward("reconnect_done");
+      this.cooldown.reset();
+      this.queue.setRiskLevel("normal");
+    });
+    this.reconnect.on(EVENTS.RECONNECT_FAIL, () => {
+      this.health.penalize("reconnect_fail");
+    });
+
+    // Geo instability
+    this.geo.on("region:unstable", () => {
+      logger.warn("GeoGuard: عدم استقرار — Silent Mode", "ULTRA");
+      this.silent.enterSilentMode("geo_instability");
+    });
+
+    // Cooldown → Smart Queue speed
+    // health low → risk up
+    this.health.on(EVENTS.HEALTH_LOW, () => {
+      this.queue.setRiskLevel("high");
+      this.cooldown.recordError();
+    });
+  }
+
+  // ── استخراج ctx ─────────────────────────────────────────
+  _extractCtx(api) {
+    for (const k of Object.getOwnPropertyNames(api)) {
+      try {
+        const v = api[k];
+        if (v && typeof v === "object" && v.jar && v.userID && v.userID !== "0") return v;
+      } catch(_) {}
+    }
+    return null;
+  }
+
+  // ── تشغيل كل الأنظمة بعد Login ─────────────────────────
+  _startSystems(api, ctx) {
+    this.session.attach(api);
+    this.keepAlive.attach(api, ctx);
+    this.watchdog.attach(api, ctx);
+    this.memory.registerCleanup(() => {
+      if (ctx?.tasks instanceof Map && ctx.tasks.size > 100) ctx.tasks.clear();
+    });
+
+    // تسجيل region
+    if (ctx?.region) this.geo.recordRegion(ctx.region);
+
+    // تشغيل الأنظمة
+    this.session.start();
+    this.keepAlive.start();
+    this.watchdog.start();
+    this.health.start();
+    this.memory.start();
+    this.queue.start();
+    this.behavior.start(ctx?.mqttClient);
+
+    logger.info("ULTRA: كل الأنظمة تعمل ✅", "ULTRA");
+    this.emit("ready", { uid: ctx?.userID });
+  }
+
+  // ── إيقاف كل الأنظمة ────────────────────────────────────
+  _stopSystems() {
+    ["session","keepAlive","watchdog","health","memory","queue","behavior","silent"].forEach(s => {
+      try { this[s].stop(); } catch(_) {}
+    });
+  }
+
+  // ── إعادة تشغيل ذكية (Soft Restart) ─────────────────────
+  async _restart(reason) {
+    if (this._restarting) return;
+    this._restarting = true;
+    logger.warn(`ULTRA: إعادة تشغيل — ${reason}`, "ULTRA");
+
+    // Soft restart بدل Hard restart
+    const ok = await this.silent.softRestart(async () => {
+      this._stopSystems();
+      try {
+        if (this._ctx?.mqttClient) {
+          this._ctx.mqttClient.removeAllListeners();
+          this._ctx.mqttClient.end(true);
+        }
+      } catch(_) {}
+      await this.reconnect.trigger(async () => {
+        await this.attachToApi(this._api);
+      }, new Error(reason));
+    }, reason);
+
+    if (!ok) logger.error("ULTRA: فشلت إعادة التشغيل", "ULTRA");
+    this._restarting = false;
+  }
+
+  // ── بناء Listener Callback ────────────────────────────────
+  buildListenerCallback() {
+    return (error, message) => {
+      if (error) {
+        if (error?.type === "stop_listen") return;
+
+        // Silent Mode إذا لزم
+        if (this.silent.shouldGoSilent(error)) {
+          this.silent.handleError(error, () => this._restart("silent_recovery"));
+          return;
+        }
+
+        if (error?.type === "account_inactive" || isSessionError(error)) {
+          this.health.penalize("session_expired");
+          this._restart("account_inactive");
+          return;
+        }
+
+        this.health.penalize("error");
+        this.cooldown.recordError();
+        this._restart("listen_error");
+        return;
+      }
+
+      if (!message) return;
+
+      // تحديث Watchdog + Health
+      this.watchdog.heartbeat();
+      this.health.reward("message_ok");
+      this.cooldown.recordSuccess();
+
+      // تحديث Geo إذا تغير
+      if (message.region) this.geo.recordRegion(message.region);
+
+      if (["presence","typ","read_receipt"].includes(message.type)) return;
+
+      if (this._onMessage) {
+        try { this._onMessage(null, message); } catch(e) {}
+      }
+      this.emit("message", message);
+    };
+  }
+
+  // ── ربط بـ API بعد Login ──────────────────────────────────
+  async attachToApi(api) {
+    this._api = api;
+    this._ctx = this._extractCtx(api);
+
+    if (this._ctx) {
+      api.ctx = this._ctx;
+      api.ctxMain = this._ctx;
+      logger.info(`ULTRA مرتبط | UID: ${this._ctx.userID} | Region: ${this._ctx.region || "?"}`, "ULTRA");
+    }
+
+    // Connection Warm-Up قبل أي نشاط
+    await this.behavior.warmUp();
+
+    // حفظ الجلسة فوراً
+    try { this.session.save(api.getAppState(), true); } catch(_) {}
+
+    // تشغيل الأنظمة
+    this._startSystems(api, this._ctx || {});
+
+    return api;
+  }
+
+  // ── wrap sendMessage بـ Queue + Cooldown ─────────────────
+  wrapSendMessage(api) {
+    const original = api.sendMessage.bind(api);
+    api.sendMessage = (msg, threadID, callback, messageID) => {
+      // Anti-Repeat
+      this.behavior.antiRepeatDelay("send", typeof msg === "string" ? msg.slice(0, 30) : "obj");
+
+      // Queue
+      this.queue.enqueue(async () => {
+        await this.cooldown.waitBeforeSend();
+        const start = Date.now();
+        return new Promise((res, rej) => {
+          original(msg, threadID, (err, info) => {
+            this.cooldown.recordLatency(Date.now() - start);
+            if (err) { this.cooldown.recordError(); if (callback) callback(err); rej(err); }
+            else { this.cooldown.recordSuccess(); if (callback) callback(null, info); res(info); }
+          }, messageID);
+        });
+      }, { threadID });
+    };
+    logger.info("ULTRA: sendMessage wrapped ✅", "ULTRA");
+  }
+
+  // ── إيقاف آمن ────────────────────────────────────────────
+  async stop() {
+    this._stopSystems();
+    try { if (this._api?.stopListening) this._api.stopListening(); } catch(_) {}
+    logger.info("ULTRA: موقوف ✅", "ULTRA");
+  }
+
+  // ── Getters ───────────────────────────────────────────────
+  get api()         { return this._api; }
+  get ctx()         { return this._ctx; }
+  getHealth()       { return this.health.getStats(); }
+  getCooldown()     { return this.cooldown.getStats(); }
+  getQueue()        { return this.queue.getStats(); }
+  getGeo()          { return this.geo.getStats(); }
+  getSilent()       { return this.silent.getStats(); }
+}
+
+module.exports = AymanFCAUltra;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ayman-fca",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Facebook Chat API for Node.js — مكتبة KIRA بوت | © 2025 Ayman",
   "main": "index.js",
   "types": "index.d.ts",

package/src/api/pinMessage.js

@@ -0,0 +1,45 @@
+"use strict";
+const utils = require("../utils");
+module.exports = function(defaultFuncs, api, ctx){
+  return function pinMessage(messageID, threadID, callback){
+    let resolveFunc, rejectFunc;
+    const returnPromise = new Promise((res,rej)=>{ resolveFunc=res; rejectFunc=rej; });
+    if (!callback) callback = (err,data)=> err ? rejectFunc(err) : resolveFunc(data);
+    defaultFuncs
+      .post("https://www.facebook.com/api/graphql/", ctx.jar, {
+        doc_id: "2380599842158525",
+        variables: JSON.stringify({ messageID, threadID, isPinnedMessage: true })
+      }, ctx.globalOptions, ctx)
+      .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+      .then(resData=>{ if(resData.error) throw resData; callback(null,{success:true}); })
+      .catch(err=>callback(err));
+    return returnPromise;
+  };
+};
+forwardMessage.js:
+"use strict";
+const utils = require("../utils");
+module.exports = function(defaultFuncs, api, ctx){
+  return function forwardMessage(messageID, threadID, callback){
+    let resolveFunc, rejectFunc;
+    const returnPromise = new Promise((res,rej)=>{ resolveFunc=res; rejectFunc=rej; });
+    if (!callback) callback = (err,data)=> err ? rejectFunc(err) : resolveFunc(data);
+    defaultFuncs
+      .post("https://www.facebook.com/api/graphql/", ctx.jar, {
+        doc_id: "3218892511542012",
+        variables: JSON.stringify({
+          message: { forwarded_message_id: messageID },
+          thread_id: threadID
+        })
+      }, ctx.globalOptions, ctx)
+      .then(utils.parseAndCheckLogin(ctx, defaultFuncs))
+      .then(resData=>{ if(resData.error) throw resData; callback(null,{success:true}); })
+      .catch(err=>callback(err));
+    return returnPromise;
+  };
+};
+getRegion.js:
+"use strict";
+module.exports = function(defaultFuncs, api, ctx){
+  return function getRegion(){ return ctx?.region || null; };
+};

package/src/core/behaviorEngine.js

@@ -0,0 +1,176 @@
+// ============================================================
+//  AYMAN-FCA — BehaviorEngine
+//  الفكرة 1: Dynamic Human Behavior Simulation
+//  الفكرة 14: Idle Simulation
+//  الفكرة 15: Time-of-Day Awareness
+//  الفكرة 19: Behavior Drift
+//  الفكرة 23: Random Heartbeat Pattern
+// ============================================================
+"use strict";
+
+const logger = require("../../func/logger");
+
+// ── أوقات النشاط البشري ──────────────────────────────────────
+const ACTIVITY_PROFILE = {
+  night:   { hours: [0,1,2,3,4,5],       multiplier: 0.2 },  // خامل جداً
+  morning: { hours: [6,7,8,9],           multiplier: 0.7 },  // متوسط
+  day:     { hours: [10,11,12,13,14,15,16,17], multiplier: 1.0 }, // طبيعي
+  evening: { hours: [18,19,20,21,22,23], multiplier: 0.8 }   // أقل قليلاً
+};
+
+// ── Behavior Drift: النشاط يتطور بمرور الوقت ─────────────────
+// الأسبوع الأول بطيء جداً، يزيد تدريجياً
+function getDriftMultiplier(sessionStartMs) {
+  const ageDays = (Date.now() - sessionStartMs) / (1000 * 60 * 60 * 24);
+  if (ageDays < 1)  return 0.3;   // يوم أول: بطيء جداً
+  if (ageDays < 3)  return 0.5;   // 3 أيام: بطيء
+  if (ageDays < 7)  return 0.7;   // أسبوع: متوسط
+  if (ageDays < 14) return 0.9;   // أسبوعين: قريب طبيعي
+  return 1.0;                      // بعدها: طبيعي
+}
+
+// ── الحصول على multiplier الوقت الحالي ──────────────────────
+function getTimeMultiplier() {
+  const h = new Date().getHours();
+  for (const [, profile] of Object.entries(ACTIVITY_PROFILE)) {
+    if (profile.hours.includes(h)) return profile.multiplier;
+  }
+  return 1.0;
+}
+
+class BehaviorEngine {
+  constructor(options = {}) {
+    this._sessionStart = options.sessionStart || Date.now();
+    this._baseDelay    = options.baseDelay    || 2000;
+    this._patternMap   = new Map(); // كشف التكرار
+    this._lastActivity = Date.now();
+    this._idleTimer    = null;
+    this._active       = false;
+  }
+
+  // ① delay بشري عشوائي مع مراعاة الوقت والعمر
+  humanDelay(min = 500, max = 3000) {
+    const timeMul  = getTimeMultiplier();
+    const driftMul = getDriftMultiplier(this._sessionStart);
+    const combined = timeMul * driftMul;
+
+    const adjustedMin = Math.round(min / combined);
+    const adjustedMax = Math.round(max / combined);
+    const base = Math.floor(Math.random() * (adjustedMax - adjustedMin + 1)) + adjustedMin;
+
+    // jitter ±15%
+    const jitter = base * 0.15 * (Math.random() * 2 - 1);
+    const delay  = Math.max(200, Math.round(base + jitter));
+
+    return new Promise(r => setTimeout(r, delay));
+  }
+
+  // ② كشف الأنماط المتكررة (الفكرة 12: Anti-Pattern Detection)
+  trackPattern(key, value) {
+    const k = `${key}:${value}`;
+    const count = (this._patternMap.get(k) || 0) + 1;
+    this._patternMap.set(k, count);
+
+    // تنظيف القديم كل 100 entry
+    if (this._patternMap.size > 100) {
+      const first = this._patternMap.keys().next().value;
+      this._patternMap.delete(first);
+    }
+
+    return count;
+  }
+
+  // إذا نفس الرسالة 3+ مرات → delay إضافي
+  async antiRepeatDelay(key, value) {
+    const count = this.trackPattern(key, value);
+    if (count >= 3) {
+      const extra = Math.min(count * 1000, 10000);
+      logger.warn(`Anti-Pattern: تكرار (${count}x) — delay ${extra}ms`, "BEHAVIOR");
+      await new Promise(r => setTimeout(r, extra));
+    }
+  }
+
+  // ③ Connection Warm-Up (الفكرة 13)
+  async warmUp() {
+    logger.info("Connection Warm-Up بدأ...", "BEHAVIOR");
+    await this.humanDelay(2000, 5000);  // انتظر
+    logger.info("Warm-Up: read phase...", "BEHAVIOR");
+    await this.humanDelay(1000, 3000);  // قراءة
+    logger.info("Warm-Up: idle phase...", "BEHAVIOR");
+    await this.humanDelay(3000, 8000);  // خمول
+    logger.info("Warm-Up مكتمل ✅", "BEHAVIOR");
+  }
+
+  // ④ Idle Simulation - خمول عشوائي
+  scheduleIdleBreak(mqttClient) {
+    if (!this._active) return;
+    // كل 15-45 دقيقة خمول عشوائي من 2-10 دقائق
+    const nextIdleIn = (15 + Math.random() * 30) * 60 * 1000;
+
+    this._idleTimer = setTimeout(async () => {
+      if (!this._active) return;
+      const idleMs = (2 + Math.random() * 8) * 60 * 1000;
+      logger.info(`Idle Simulation: خمول ${Math.round(idleMs/60000)} دقيقة`, "BEHAVIOR");
+
+      // foreground = false أثناء الخمول
+      try {
+        if (mqttClient?.connected) {
+          mqttClient.publish("/foreground_state", JSON.stringify({ foreground: false }), { qos: 0 });
+        }
+      } catch(_) {}
+
+      await new Promise(r => setTimeout(r, idleMs));
+
+      // عودة للنشاط
+      try {
+        if (mqttClient?.connected) {
+          mqttClient.publish("/foreground_state", JSON.stringify({ foreground: true }), { qos: 0 });
+        }
+      } catch(_) {}
+
+      logger.info("Idle Simulation: عادة للنشاط ✅", "BEHAVIOR");
+      this.scheduleIdleBreak(mqttClient); // جدول التالي
+    }, nextIdleIn);
+  }
+
+  // ⑤ Random Heartbeat - نبضة غير ثابتة
+  getHeartbeatDelay() {
+    // بين 20-40 ثانية مع variation حسب الوقت
+    const base    = 25000;
+    const range   = 15000;
+    const timeMul = getTimeMultiplier();
+    return Math.round((base + Math.random() * range) / timeMul);
+  }
+
+  // ⑥ Session Age Awareness (الفكرة 2)
+  getSessionAge() {
+    return Date.now() - this._sessionStart;
+  }
+
+  isSessionAging() {
+    return this.getSessionAge() > 20 * 60 * 60 * 1000; // أكثر من 20 ساعة
+  }
+
+  // تقليل النشاط عند شيخوخة الجلسة
+  getAgedActivityMultiplier() {
+    const agingMs = this.getSessionAge();
+    const agingH  = agingMs / (60 * 60 * 1000);
+    if (agingH < 12) return 1.0;
+    if (agingH < 20) return 0.8;
+    if (agingH < 30) return 0.6;
+    return 0.4; // بعد 30 ساعة: نشاط منخفض جداً
+  }
+
+  start(mqttClient) {
+    this._active = true;
+    this.scheduleIdleBreak(mqttClient);
+    logger.info("BehaviorEngine: مفعّل ✅", "BEHAVIOR");
+  }
+
+  stop() {
+    this._active = false;
+    if (this._idleTimer) { clearTimeout(this._idleTimer); this._idleTimer = null; }
+  }
+}
+
+module.exports = BehaviorEngine;

package/src/core/geoGuard.js

@@ -0,0 +1,87 @@
+// ============================================================
+//  AYMAN-FCA — GeoStabilityGuard
+//  الفكرة 6:  Multi-Region Awareness
+//  الفكرة 24: Geo Stability Guard
+// ============================================================
+"use strict";
+
+const EventEmitter = require("events");
+const logger       = require("../../func/logger");
+
+class GeoStabilityGuard extends EventEmitter {
+  constructor(options = {}) {
+    super();
+    this._lastRegion   = null;
+    this._regionChanges= 0;
+    this._maxChanges   = options.maxChanges || 3;
+    this._history      = [];
+    this._lockRegion   = options.lockRegion || false;
+  }
+
+  // ── تسجيل Region ─────────────────────────────────────────
+  recordRegion(region) {
+    if (!region) return;
+
+    this._history.push({ region, ts: Date.now() });
+    if (this._history.length > 20) this._history.shift();
+
+    if (this._lastRegion && this._lastRegion !== region) {
+      this._regionChanges++;
+      logger.warn(`GeoGuard: Region تغير ${this._lastRegion} → ${region} (#${this._regionChanges})`, "GEO");
+      this.emit("region:changed", { from: this._lastRegion, to: region });
+
+      if (this._regionChanges >= this._maxChanges) {
+        logger.error("GeoGuard: تغييرات كثيرة — خطر logout", "GEO");
+        this.emit("region:unstable", { changes: this._regionChanges });
+      }
+    }
+
+    this._lastRegion = region;
+  }
+
+  // ── هل الموقع مستقر؟ ──────────────────────────────────────
+  isStable() {
+    return this._regionChanges < this._maxChanges;
+  }
+
+  // ── الحصول على Region الموصى به ───────────────────────────
+  getPreferredRegion() {
+    if (!this._history.length) return null;
+    // الـ region الأكثر تكراراً
+    const counts = {};
+    for (const { region } of this._history) {
+      counts[region] = (counts[region] || 0) + 1;
+    }
+    return Object.entries(counts).sort((a, b) => b[1] - a[1])[0]?.[0] || null;
+  }
+
+  // ── تطبيق على ctx ──────────────────────────────────────────
+  applyToCtx(ctx) {
+    if (!ctx) return;
+
+    // تسجيل region الحالي
+    if (ctx.region) this.recordRegion(ctx.region);
+
+    // إذا lock region، أعد تطبيق الـ region المفضل
+    if (this._lockRegion && this._lastRegion && !ctx.region) {
+      ctx.region = this._lastRegion;
+      logger.info(`GeoGuard: تم تثبيت region = ${ctx.region}`, "GEO");
+    }
+  }
+
+  reset() {
+    this._regionChanges = 0;
+    this._history       = [];
+  }
+
+  getStats() {
+    return {
+      currentRegion: this._lastRegion,
+      regionChanges: this._regionChanges,
+      stable:        this.isStable(),
+      preferred:     this.getPreferredRegion()
+    };
+  }
+}
+
+module.exports = GeoStabilityGuard;