ayman-fca 1.0.7 → 1.0.8

package/index.js

@@ -1,271 +1,751 @@
-// ============================================================
-//  AYMAN-FCA v2.0 — ULTRA MASTER ENGINE
-//  © 2026 Ayman. All Rights Reserved.
-//
-//  يجمع كل الأنظمة:
-//  ① 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 EventEmitter      = require("events");
-const path              = require("path");
-
-// المسار الصحيح داخل حزمة المكتبة
-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 لتجنب الأخطاء
-    if (logger && typeof logger.banner === "function") logger.banner();
-  }
-
-  // ── ربط الأنظمة ببعضها ──────────────────────────────────
-  _wireSystems() {
-    this.watchdog.on(EVENTS.WATCHDOG_RESTART, ({ reasons }) => {
-      this.health.penalize("mqtt_dead");
-      this._restart("watchdog: " + reasons);
-    });
-
-    this.health.on(EVENTS.HEALTH_CRITICAL, ({ score }) => {
-      logger.error(`Health منخفض (${score}) — restart`, "ULTRA");
-      this._restart("health_critical");
-    });
-
-    this.session.on(EVENTS.SESSION_EXPIRED, () => {
-      this.health.penalize("session_expired");
-      this._restart("session_expired");
-    });
-
-    this.memory.on(EVENTS.MEMORY_HIGH, () => {
-      this.health.penalize("memory_high");
-      this.queue.setRiskLevel("high");
-    });
-
-    this.silent.on("silent:enter", () => {
-      this.queue.pause("silent_mode");
-      this.cooldown.recordError();
-    });
-    this.silent.on("silent:exit", () => {
-      this.queue.resume();
-    });
-
-    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");
-    });
-
-    this.geo.on("region:unstable", () => {
-      logger.warn("GeoGuard: عدم استقرار — Silent Mode", "ULTRA");
-      this.silent.enterSilentMode("geo_instability");
-    });
-
-    this.health.on(EVENTS.HEALTH_LOW, () => {
-      this.queue.setRiskLevel("high");
-      this.cooldown.recordError();
-    });
-  }
-
-  _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;
-  }
-
-  _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();
-    });
-
-    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(_) {}
-    });
-  }
-
-  async _restart(reason) {
-    if (this._restarting) return;
-    this._restarting = true;
-    logger.warn(`ULTRA: إعادة تشغيل — ${reason}`, "ULTRA");
-
-    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;
-  }
-
-  buildListenerCallback() {
-    return (error, message) => {
-      if (error) {
-        if (error?.type === "stop_listen") return;
-
-        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;
-
-      this.watchdog.heartbeat();
-      this.health.reward("message_ok");
-      this.cooldown.recordSuccess();
-
-      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);
+declare module '@dongdev/fca-unofficial' {
+  import type EventEmitter from "events";
+  import type { Duplex, Readable, Transform } from "stream";
+
+  // ============================================================================
+  // Type Definitions
+  // ============================================================================
+
+  type ReadableStream = Readable | Duplex | Transform;
+
+  // ============================================================================
+  // Login Function
+  // ============================================================================
+
+  function login(
+    credentials: Partial<{
+      email: string;
+      password: string;
+      appState: AppstateData;
+      Cookie?: string | string[] | Record<string, string>;
+    }>,
+    options: Partial<IFCAU_Options>,
+    callback: (err: Error | null, api: IFCAU_API) => void
+  ): void;
+  function login(
+    credentials: Partial<{
+      email: string;
+      password: string;
+      appState: AppstateData;
+      Cookie?: string | string[] | Record<string, string>;
+    }>,
+    options: Partial<IFCAU_Options>
+  ): Promise<IFCAU_API>;
+  function login(
+    credentials: Partial<{
+      email: string;
+      password: string;
+      appState: AppstateData;
+      Cookie?: string | string[] | Record<string, string>;
+    }>,
+    callback: (err: Error | null, api: IFCAU_API) => void
+  ): void;
+  function login(
+    credentials: Partial<{
+      email: string;
+      password: string;
+      appState: AppstateData;
+      Cookie?: string | string[] | Record<string, string>;
+    }>
+  ): Promise<IFCAU_API>;
+
+  export default login;
+  export { login };
+
+  // ============================================================================
+  // Core Types
+  // ============================================================================
+
+  export type Cookie = {
+    key: string;
+    value: string;
+    domain: string;
+    path?: string;
+    hostOnly?: boolean;
+    creation?: string;
+    lastAccessed?: string;
+  };
+
+  export type AppstateData = {
+    appState: Cookie[];
+  };
+
+  export type MessageObject = {
+    body: string;
+    sticker?: string;
+    attachment?: ReadableStream | ReadableStream[];
+    url?: string;
+    emoji?: string;
+    emojiSize?: string;
+    mentions?: {
+      tag: string;
+      id: string;
+      fromIndex?: number;
+    }[];
+    location?: {
+      latitude: number;
+      longitude: number;
+      current?: boolean;
+    };
+  };
+
+  // ============================================================================
+  // Send Message Function
+  // ============================================================================
+
+  function sendMessage(
+    message: string | MessageObject,
+    threadID: string | string[],
+    callback?: (err?: Error, data?: { threadID: string; messageID: string; timestamp: number }) => void,
+    replyMessageID?: string,
+    isGroup?: boolean
+  ): Promise<{ threadID: string; messageID: string; timestamp: number }>;
+  function sendMessage(
+    message: string | MessageObject,
+    threadID: string | string[],
+    replyMessageID?: string,
+    isGroup?: boolean
+  ): Promise<{ threadID: string; messageID: string; timestamp: number }>;
+
+  // ============================================================================
+  // API Interface
+  // ============================================================================
+
+  export type IFCAU_API = {
+    // Group Management
+    addUserToGroup: (userID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+    removeUserFromGroup: (userID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+    createNewGroup: (participantIDs: string[], groupTitle?: string, callback?: (err: Error, threadID: string) => void) => Promise<string>;
+
+    // Admin & Permissions
+    changeAdminStatus: (threadID: string, adminIDs: string | string[], adminStatus: boolean, callback?: (err?: Error) => void) => Promise<void>;
+    changeApprovalMode: (approvalMode: 0 | 1, threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+
+    // Thread Management
+    changeArchivedStatus: (threadOrThreads: string | string[], archive: boolean, callback?: (err?: Error) => void) => Promise<void>;
+    changeBlockedStatus: (userID: string, blocked: boolean, callback?: (err?: Error) => void) => Promise<void>;
+    changeGroupImage: (image: ReadableStream, threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+    changeNickname: (nickname: string, threadID: string, participantID: string, callback?: (err?: Error) => void) => Promise<void>;
+    changeThreadColor: (color: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+    changeThreadEmoji: (emoji: string | null, threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+    setTitle: (newTitle: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+    deleteThread: (threadOrThreads: string | string[], callback?: (err?: Error) => void) => Promise<void>;
+    muteThread: (threadID: string, muteSeconds: number, callback?: (err?: Error) => void) => Promise<void>;
+
+    // Messages
+    sendMessage: typeof sendMessage;
+    editMessage: (text: string, messageID: string, callback?: (err?: Error) => void) => Promise<void>;
+    deleteMessage: (messageOrMessages: string | string[], callback?: (err?: Error) => void) => Promise<void>;
+    unsendMessage: (messageID: string, callback?: (err?: Error) => void) => Promise<void>;
+    unsendMessageMqtt: (messageID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+    forwardMessage: (messageID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+    forwardAttachment: (attachmentID: string, userOrUsers: string | string[], callback?: (err?: Error) => void) => Promise<void>;
+    pinMessage: (pinMode: boolean, messageID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+
+    // Reactions & Interactions
+    setMessageReaction: (reaction: string, messageID: string, threadID: string, callback?: (err?: Error) => void, forceCustomReaction?: boolean) => Promise<void>;
+    setMessageReactionMqtt: (reaction: string, messageID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+    sendTypingIndicator: (threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+    sendTypingIndicatorMqtt: (isTyping: boolean, threadID: string, callback?: (err?: Error) => void) => Promise<void>;
+
+    // Polls
+    createPoll: (title: string, threadID: string, options?: { [item: string]: boolean }, callback?: (err?: Error) => void) => Promise<void>;
+
+    // Read & Delivery Status
+    markAsRead: (threadID: string, read?: boolean, callback?: (err?: Error) => void) => Promise<void>;
+    markAsReadAll: (callback?: (err?: Error) => void) => Promise<void>;
+    markAsDelivered: (threadID: string, messageID: string, callback?: (err?: Error) => void) => Promise<void>;
+    markAsSeen: (seenTimestamp?: number, callback?: (err?: Error) => void) => Promise<void>;
+
+    // Thread Information
+    getThreadInfo: (threadID: string, callback?: (err: Error | null, thread: IFCAU_Thread) => void) => Promise<IFCAU_Thread>;
+    getThreadList: (limit: number, timestamp: number | null, tags: string[], callback?: (err: Error | null, threads: IFCAU_ThreadList) => void) => Promise<IFCAU_ThreadList>;
+    getThreadHistory: (threadID: string, amount: number, time?: number, callback?: (err: Error | null, messages: any[]) => void) => Promise<any[]>;
+    getThreadPictures: (threadID: string, offset: number, limit: number, callback?: (err: Error | null, pictures: string[]) => void) => Promise<string[]>;
+
+    // User Information
+    getUserInfo: (userOrUsers: string | string[], callback?: (err: Error | null, users: { [id: string]: IFCAU_User }) => void) => Promise<{ [id: string]: IFCAU_User }>;
+    getUserID: (name: string, callback?: (err: Error | null, obj: IFCAU_UserIDResponse) => void) => Promise<IFCAU_UserIDResponse>;
+    getFriendsList: (callback?: (err: Error | null, friends: IFCAU_Friend[]) => void) => Promise<IFCAU_Friend[]>;
+    getCurrentUserID: () => string;
+
+    // Utilities
+    getAppState: () => any;
+    getEmojiUrl: (c: string, size: number, pixelRatio: number) => string;
+    resolvePhotoUrl: (photoID: string, callback?: (err: Error | null, url: string) => void) => Promise<string>;
+    threadColors: {
+      [color: string]: string;
     };
-  }
 
-  async attachToApi(api) {
-    this._api = api;
-    this._ctx = this._extractCtx(api);
+    // Message Requests
+    handleMessageRequest: (threadOrThreads: string | string[], accept: boolean, callback?: (err?: Error) => void) => Promise<void>;
+
+    // Event Listeners
+    listen: (callback?: (err: Error | null, message: IFCAU_ListenMessage) => void) => EventEmitter;
+    listenMqtt: (callback?: (err: Error | null, message: IFCAU_ListenMessage) => void) => EventEmitter & { stopListening: (callback?: () => void) => void };
+
+    // Lifecycle & Remote Events
+    on: (event: string, listener: (...args: any[]) => void) => IFCAU_Api;
+    once: (event: string, listener: (...args: any[]) => void) => IFCAU_Api;
+    off: (event: string, listener: (...args: any[]) => void) => IFCAU_Api;
+    removeAllListeners: (event?: string) => IFCAU_Api;
+
+    // Middleware System
+    useMiddleware: (middleware: IFCAU_Middleware | string, fn?: IFCAU_Middleware) => () => void;
+    removeMiddleware: (identifier: string | IFCAU_Middleware) => boolean;
+    clearMiddleware: () => void;
+    listMiddleware: () => string[];
+    setMiddlewareEnabled: (name: string, enabled: boolean) => boolean;
+    readonly middlewareCount: number;
+
+    // Configuration & Session
+    setOptions: (options: Partial<IFCAU_Options>) => void;
+    logout: (callback?: (err?: Error) => void) => Promise<void>;
+
+    // Message Scheduler
+    scheduler: {
+      scheduleMessage: (message: string | MessageObject, threadID: string | string[], when: Date | number | string, options?: { replyMessageID?: string; isGroup?: boolean; callback?: (err?: Error) => void }) => string;
+      cancelScheduledMessage: (id: string) => boolean;
+      getScheduledMessage: (id: string) => IFCAU_ScheduledMessage | null;
+      listScheduledMessages: () => IFCAU_ScheduledMessage[];
+      cancelAllScheduledMessages: () => number;
+      getScheduledCount: () => number;
+      cleanup: () => void;
+    };
 
-    if (this._ctx) {
-      api.ctx = this._ctx;
-      api.ctxMain = this._ctx;
-      logger.info(`ULTRA مرتبط | UID: ${this._ctx.userID} | Region: ${this._ctx.region || "?"}`, "ULTRA");
+    // Auto-save AppState
+    enableAutoSaveAppState: (options?: { filePath?: string; interval?: number; saveOnLogin?: boolean }) => () => void;
+  };
+
+  // ============================================================================
+  // Listen Message Types
+  // ============================================================================
+
+  export type IFCAU_ListenMessage =
+    | {
+      type: "message";
+      attachments: IFCAU_Attachment[];
+      args: string[];
+      body: string;
+      isGroup: boolean;
+      mentions: { [id: string]: string };
+      messageID: string;
+      senderID: string;
+      threadID: string;
+      isUnread: boolean;
+      participantIDs: string[];
     }
+    | {
+      type: "event";
+      author: string;
+      logMessageBody: string;
+      logMessageData: {
+        image: {
+          attachmentID: string;
+          width: number;
+          height: number;
+          url: string;
+        };
+      };
+      logMessageType: "log:thread-image";
+      threadID: string;
+    }
+    | {
+      type: "event";
+      author: string;
+      logMessageBody: string;
+      logMessageData: {
+        addedParticipants: {
+          fanoutPolicy: string;
+          firstName: string;
+          fullName: string;
+          groupJoinStatus: string;
+          initialFolder: string;
+          initialFolderId: {
+            systemFolderId: string;
+          };
+          lastUnsubscribeTimestampMs: string;
+          userFbId: string;
+          isMessengerUser: boolean;
+        }[];
+      };
+      logMessageType: "log:subscribe";
+      threadID: string;
+      participantIDs: string[];
+    }
+    | {
+      type: "event";
+      author: string;
+      logMessageBody: string;
+      logMessageData: { leftParticipantFbId: string };
+      logMessageType: "log:unsubscribe";
+      threadID: string;
+      participantIDs: string[];
+    }
+    | {
+      type: "event";
+      author: string;
+      logMessageBody: string;
+      logMessageData: { name: string };
+      logMessageType: "log:thread-name";
+      threadID: string;
+      participantIDs: string[];
+    }
+    | {
+      type: "event";
+      author: string;
+      logMessageBody: string;
+      logMessageData: {
+        theme_color: string;
+        gradient?: string;
+        should_show_icon: string;
+        theme_id: string;
+        accessibility_label: string;
+        theme_name_with_subtitle: string;
+        theme_emoji?: string;
+      };
+      logMessageType: "log:thread-color";
+      threadID: string;
+      participantIDs: string[];
+    }
+    | {
+      type: "event";
+      author: string;
+      logMessageBody: string;
+      logMessageData: {
+        thread_quick_reaction_instruction_key_id: string;
+        thread_quick_reaction_emoji: string;
+        thread_quick_reaction_emoji_url: string;
+      };
+      logMessageType: "log:thread-icon";
+      threadID: string;
+      participantIDs: string[];
+    }
+    | {
+      type: "event";
+      author: string;
+      logMessageBody: string;
+      logMessageData: {
+        nickname: string;
+        participant_id: string;
+      };
+      logMessageType: "log:user-nickname";
+      threadID: string;
+      participantIDs: string[];
+    }
+    | {
+      type: "event";
+      author: string;
+      logMessageBody: string;
+      logMessageData: {
+        THREAD_CATEGORY: string;
+        TARGET_ID: string;
+        ADMIN_TYPE: string;
+        ADMIN_EVENT: 'add_admin' | 'remove_admin';
+      };
+      logMessageType: "log:thread-admins";
+      threadID: string;
+      participantIDs: string[];
+    }
+    | {
+      type: "event";
+      author: string;
+      logMessageBody: string;
+      logMessageData: {
+        removed_option_ids: string;
+        question_json: string;
+        event_type: 'question_creation' | 'update_vote' | 'add_unvoted_option' | 'multiple_updates';
+        added_option_ids: string;
+        new_option_texts: string;
+        new_option_ids: string;
+        question_id: string;
+      };
+      logMessageType: "log:thread-poll";
+      threadID: string;
+      participantIDs: string[];
+    }
+    | {
+      type: "event";
+      author: string;
+      logMessageBody: string;
+      logMessageData: { APPROVAL_MODE: '0' | '1'; THREAD_CATEGORY: string };
+      logMessageType: "log:thread-approval-mode";
+      threadID: string;
+      participantIDs: string[];
+    }
+    | {
+      type: "event";
+      author: string;
+      logMessageBody: string;
+      logMessageData: any;
+      logMessageType: "log:thread-call";
+      threadID: string;
+      participantIDs: string[];
+    }
+    | {
+      type: "typ";
+      from: string;
+      fromMobile: boolean;
+      isTyping: boolean;
+      threadID: string;
+    }
+    | {
+      type: "read";
+      threadID: string;
+      time: number;
+    }
+    | {
+      type: "read_receipt";
+      reader: string;
+      threadID: string;
+      time: number;
+    }
+    | {
+      type: "message_reaction";
+      threadID: string;
+      messageID: string;
+      reaction: string;
+      senderID: string;
+      userID: string;
+      reactionTimestamp: number;
+    }
+    | {
+      type: "presence";
+      statuses: number;
+      timestamp: number;
+      userID: string;
+    }
+    | {
+      type: "message_unsend";
+      threadID: string;
+      senderID: string;
+      messageID: string;
+      deletionTimestamp: number;
+    }
+    | {
+      type: "message_reply";
+      attachments: IFCAU_Attachment[];
+      args: string[];
+      body: string;
+      isGroup: boolean;
+      mentions: { [id: string]: string };
+      messageID: string;
+      senderID: string;
+      threadID: string;
+      isUnread: boolean;
+      participantIDs: string[];
+      messageReply: {
+        attachments: IFCAU_Attachment[];
+        body: string;
+        isGroup: boolean;
+        mentions: { [id: string]: string };
+        messageID: string;
+        senderID: string;
+        threadID: string;
+        isUnread: boolean;
+      };
+    };
 
-    await this.behavior.warmUp();
-
-    try { this.session.save(api.getAppState(), true); } catch(_) {}
-
-    this._startSystems(api, this._ctx || {});
-
-    return api;
-  }
+  // ============================================================================
+  // Attachment Types
+  // ============================================================================
+
+  export type IFCAU_Attachment =
+    | {
+      type: "sticker";
+      ID: string;
+      url: string;
+      packID: string;
+      spriteUrl: string;
+      spriteUrl2x: string;
+      width: number;
+      height: number;
+      caption: string;
+      description: string;
+      frameCount: number;
+      frameRate: number;
+      framesPerRow: number;
+      framesPerCol: number;
+    }
+    | {
+      type: "file";
+      ID: string;
+      filename: string;
+      url: string;
+      isMalicious: boolean;
+      contentType: string;
+    }
+    | {
+      type: "photo";
+      ID: string;
+      filename: string;
+      thumbnailUrl: string;
+      previewUrl: string;
+      previewWidth: number;
+      previewHeight: number;
+      largePreviewUrl: string;
+      largePreviewWidth: number;
+      largePreviewHeight: number;
+      url: string;
+      width: number;
+      height: number;
+    }
+    | {
+      type: "animated_image";
+      ID: string;
+      filename: string;
+      previewUrl: string;
+      previewWidth: number;
+      previewHeight: number;
+      url: string;
+      width: number;
+      height: number;
+    }
+    | {
+      type: "video";
+      ID: string;
+      filename: string;
+      previewUrl: string;
+      previewWidth: number;
+      previewHeight: number;
+      url: string;
+      width: number;
+      height: number;
+      duration: number;
+      videoType: string;
+    }
+    | {
+      type: "audio";
+      ID: string;
+      filename: string;
+      audioType: string;
+      duration: number;
+      url: string;
+      isVoiceMail: boolean;
+    }
+    | {
+      type: "location";
+      ID: string;
+      latitude: number;
+      longitude: number;
+      image: string;
+      width: number;
+      height: number;
+      url: string;
+      address: string;
+    }
+    | {
+      type: "share";
+      ID: string;
+      url: string;
+      title: string;
+      description: string;
+      source: string;
+      image: string;
+      width: number;
+      height: number;
+      playable: boolean;
+      duration: number;
+      playableUrl: string;
+      subattachments: any;
+      properties: any;
+    };
 
-  wrapSendMessage(api) {
-    const original = api.sendMessage.bind(api);
-    api.sendMessage = (msg, threadID, callback, messageID) => {
-      this.behavior.antiRepeatDelay("send", typeof msg === "string" ? msg.slice(0, 30) : "obj");
+  // ============================================================================
+  // User Types
+  // ============================================================================
+
+  export type IFCAU_User = {
+    name: string;
+    firstName?: string;
+    vanity?: string;
+    thumbSrc: string;
+    profileUrl: string | null;
+    gender?: number;
+    type: string;
+    isFriend?: boolean;
+    isBirthday: boolean;
+    searchToken: any;
+    alternateName?: string;
+  };
+
+  export type IFCAU_UserIDResponse = {
+    userID: string;
+    photoUrl: string;
+    indexRank: number;
+    name: string;
+    isVerified: boolean;
+    profileUrl: string;
+    category: string;
+    score: number;
+    type: string;
+  }[];
+
+  export type IFCAU_Friend = {
+    alternativeName: string;
+    firstName: string;
+    gender: string;
+    userID: string;
+    isFriend: boolean;
+    fullName: string;
+    profilePicture: string;
+    type: string;
+    profileUrl: string;
+    vanity: string;
+    isBirthday: boolean;
+  };
+
+  // ============================================================================
+  // Thread Types
+  // ============================================================================
+
+  export type IFCAU_Thread = {
+    threadID: string;
+    participantIDs: string[];
+    threadName: string;
+    userInfo: (IFCAU_User & { id: string })[];
+    nicknames: { [id: string]: string } | null;
+    unreadCount: number;
+    messageCount: number;
+    imageSrc: string;
+    timestamp: number;
+    muteUntil: number | null;
+    isGroup: boolean;
+    isSubscribed: boolean;
+    folder: 'INBOX' | 'ARCHIVE' | string;
+    isArchived: boolean;
+    cannotReplyReason: string | null;
+    lastReadTimestamp: number;
+    emoji: string | null;
+    color: string | null;
+    adminIDs: string[];
+    approvalMode: boolean;
+    approvalQueue: { inviterID: string; requesterID: string; timestamp: string }[];
+  };
+
+  export type IFCAU_ThreadList = {
+    threadID: string;
+    name: string;
+    unreadCount: number;
+    messageCount: number;
+    imageSrc: string;
+    emoji: string | null;
+    color: string | null;
+    nicknames: { userid: string; nickname: string }[];
+    muteUntil: number | null;
+    participants: IFCAU_ThreadList_Participants[];
+    adminIDs: string[];
+    folder: "INBOX" | "ARCHIVED" | "PENNDING" | "OTHER" | string;
+    isGroup: boolean;
+    customizationEnabled: boolean;
+    participantAddMode: string;
+    reactionMuteMode: string;
+    isArchived: boolean;
+    isSubscribed: boolean;
+    timestamp: number;
+    snippet: string;
+    snippetAttachments: string;
+    snippetSender: string;
+    lastMessageTimestamp: number;
+    listReadTimestamp: number | null;
+    cannotReplyReason: string | null;
+    approvalMode: string;
+  }[];
+
+  export type IFCAU_ThreadList_Participants =
+    | {
+      accountType: "User";
+      userID: string;
+      name: string;
+      shortName: string;
+      gender: string;
+      url: string;
+      profilePicture: string;
+      username: string | null;
+      isViewerFriend: boolean;
+      isMessengerUser: boolean;
+      isVerified: boolean;
+      isMessageBlockedByViewer: boolean;
+      isViewerCoworker: boolean;
+    }
+    | {
+      accountType: "Page";
+      userID: string;
+      name: string;
+      url: string;
+      profilePicture: string;
+      username: string | null;
+      acceptMessengerUserFeedback: boolean;
+      isMessengerUser: boolean;
+      isVerified: boolean;
+      isMessengerPlatformBot: boolean;
+      isMessageBlockedByViewer: boolean;
+    }
+    | {
+      accountType: "ReducedMessagingActor";
+      userID: string;
+      name: string;
+      url: string;
+      profilePicture: string;
+      username: string | null;
+      acceptMessengerUserFeedback: boolean;
+      isMessageBlockedByViewer: boolean;
+    }
+    | {
+      accountType: "UnavailableMessagingActor";
+      userID: string;
+      name: string;
+      url: null;
+      profilePicture: string;
+      username: null;
+      acceptMessengerUserFeedback: boolean;
+      isMessageBlockedByViewer: boolean;
+    }
+    | {
+      accountType: string;
+      userID: string;
+      name: string;
+    };
 
-      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 });
+  // ============================================================================
+  // Middleware Types
+  // ============================================================================
+
+  export type IFCAU_Middleware = (event: IFCAU_ListenMessage, next: (err?: Error | false | null) => void) => void | Promise<void> | false | null;
+
+  // ============================================================================
+  // Scheduler Types
+  // ============================================================================
+
+  export type IFCAU_ScheduledMessage = {
+    id: string;
+    message: string | MessageObject;
+    threadID: string | string[];
+    timestamp: number;
+    createdAt: number;
+    options: {
+      replyMessageID?: string;
+      isGroup?: boolean;
+      callback?: (err?: Error) => void;
     };
-    logger.info("ULTRA: sendMessage wrapped ✅", "ULTRA");
-  }
-
-  async stop() {
-    this._stopSystems();
-    try { if (this._api?.stopListening) this._api.stopListening(); } catch(_) {}
-    logger.info("ULTRA: موقوف ✅", "ULTRA");
-  }
-
-  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(); }
+    timeUntilSend: number;
+  };
+
+  // ============================================================================
+  // Options Type
+  // ============================================================================
+
+  export type IFCAU_Options = {
+    pauseLog: boolean;
+    logLevel: "silly" | "verbose" | "info" | "http" | "warn" | "error" | "silent";
+    selfListen: boolean;
+    listenEvents: boolean;
+    pageID: string;
+    updatePresence: boolean;
+    forceLogin: boolean;
+    userAgent: string;
+    autoMarkRead: boolean;
+    proxy: string;
+    online: boolean;
+  };
 }
-
-module.exports = AymanFCAUltra;

package/package.json

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