@cexy/hoonfca 1.0.4 → 1.0.5

package/index.d.ts

@@ -1,620 +1,746 @@
-// Origin: NOCOM-BOT/mod_fbmsg_legacy
-
-declare module 'dinovn-fca' {
-    import type { Readable, Duplex, Transform } from "stream";
-    import type EventEmitter from "events";
-
-    type ReadableStream = Readable | Duplex | Transform;
-    function login(credentials: Partial<{
-        email: string,
-        password: string,
-        appState: AppstateData
-    }>, options: Partial<IFCAU_Options>, callback: (err: Error | null, api: IFCAU_API) => void): void;
-    function login(credentials: Partial<{
-        email: string,
-        password: string,
-        appState: AppstateData
-    }>, options: Partial<IFCAU_Options>): Promise<IFCAU_API>;
-    function login(credentials: Partial<{
-        email: string,
-        password: string,
-        appState: AppstateData
-    }>, callback: (err: Error | null, api: IFCAU_API) => void): void;
-    function login(credentials: Partial<{
-        email: string,
-        password: string,
-        appState: AppstateData
-    }>): Promise<IFCAU_API>;
-
-    export default login;
-
-    export type Cookie = {
-        key: string,
-        value: string,
-        domain: string,
-        path?: string,
-        hostOnly?: boolean,
-        creation?: string,
-        lastAccessed?: string
-    }
+declare module '@dongdev/fca-unofficial' {
+  import type EventEmitter from "events";
+  import type { Duplex, Readable, Transform } from "stream";
 
-    export type AppstateData = {
-        appState: Cookie[]
-    }
+  // ============================================================================
+  // Type Definitions
+  // ============================================================================
 
-    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
-        }
-    }
+  type ReadableStream = Readable | Duplex | Transform;
 
-    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 }>;
-
-    export type IFCAU_API = {
-        addUserToGroup: (userID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>,
-        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>,
-        changeArchivedStatus: (threadOrThreads: string | string[], archive: boolean, callback?: (err?: Error) => void) => Promise<void>,
-        changeBlockedStatus: (userID: string, blocked: boolean, callback?: (err?: Error) => void) => Promise<void>,
-        changeBlockedStatusMqtt: (userID: string, status: boolean, type: string?, callback?: (err?: Error) => void) => Promise<void>,
-        changeGroupImage: (image: ReadableStream, threadID: string, callback?: (err?: Error) => void) => Promise<void>,
-        changeNickname: (nickname: string, threadID: string, pariticipantID: 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>,
-        createNewGroup: (participantIDs: string[], groupTitle?: string, callback?: (err: Error, threadID: string) => void) => Promise<string>,
-        createPoll: (title: string, threadID: string, options?: { [item: string]: boolean }, callback?: (err?: Error) => void) => Promise<void>,
-        deleteMessage: (messageOrMessages: string | string[], callback?: (err?: Error) => void) => Promise<void>,
-        deleteThread: (threadOrThreads: string | string[], callback?: (err?: Error) => void) => Promise<void>,
-        editMessage: (text: string, messageID: string, callback?: (err?: Error) => void) => Promise<void>,
-        forwardAttachment: (attachmentID: string, userOrUsers: string | string[], callback?: (err?: Error) => void) => Promise<void>,
-        forwardMessage: (messageID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>,
-        getAppState: () => any,
-        getCurrentUserID: () => string,
-        getEmojiUrl: (c: string, size: number, pixelRatio: number) => string,
-        getFriendsList: (callback?: (err: Error | null, friends: IFCAU_Friend[]) => void) => Promise<IFCAU_Friend[]>,
-        getThreadHistory: (threadID: string, amount: number, time?: number, callback?: (err: Error | null, messages: any[]) => void) => Promise<any[]>,
-        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>,
-        getThreadPictures: (threadID: string, offset: number, limit: number, callback?: (err: Error | null, pictures: string[]) => void) => Promise<string[]>,
-        getUserID: (name: string, callback?: (err: Error | null, obj: IFCAU_UserIDResponse) => void) => Promise<IFCAU_UserIDResponse>,
-        getUserInfo: (userOrUsers: string | string[], callback?: (err: Error | null, users: { [id: string]: IFCAU_User }) => void) => Promise<{ [id: string]: IFCAU_User }>,
-        threadColors: {
-            [color: string]: string
-        },
-        handleMessageRequest(threadOrThreads: string | string[], accept: boolean, callback: (err?: Error) => void): Promise<void>;
-        listen(callback?: (err: Error | null, message: IFCAU_ListenMessage) => void): EventEmitter;
-        listenMqtt(callback?: (err: Error | null, message: IFCAU_ListenMessage) => void): EventEmitter & { stopListening: (callback?: () => void) => void };
-        logout: (callback?: (err?: Error) => void) => Promise<void>,
-        markAsDelivered(threadID: string, messageID: string, callback?: (err?: Error) => void): Promise<void>,
-        markAsRead(threadID: string, read?: boolean, callback?: (err?: Error) => void): Promise<void>,
-        markAsReadAll: (callback?: (err?: Error) => void) => Promise<void>,
-        markAsSeen(seenTimestamp?: number, callback?: (err?: Error) => void): Promise<void>,
-        muteThread: (threadID: string, muteSeconds: number, callback?: (err?: Error) => void) => Promise<void>,
-        pinMessage: (pinMode: boolean, messageID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>,
-        removeUserFromGroup: (userID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>,
-        resolvePhotoUrl: (photoID: string, callback?: (err: Error | null, url: string) => void) => Promise<string>,
-        sendMessage: typeof sendMessage,
-        sendComment: (message: string | {
-            body: string,
-            attachment?: ReadableStream,
-        }, postID: string, callback?: (err?: Error) => void) => Promise<void>,
-        sendTypingIndicator: (threadID: string, callback?: (err?: Error) => void | number, delay?: number) => Promise<void>,
-        setMessageReaction: (reaction: string, messageID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>,
-        setOptions: (options: Partial<IFCAU_Options>) => void,
-        setTitle: (newTitle: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>,
-        shareContact: (contactID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>,
-        shareLink: (text: string, link: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>,
-        setTheme: (themeID?: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>,
-        unsendMessage: (messageID: string, threadID: string, callback?: (err?: Error) => void) => Promise<void>,
-    }
+  // ============================================================================
+  // Login Function
+  // ============================================================================
 
-    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,
-            deletionnTimestamp: 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
-            }
-        };
+  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 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
-        }
-
-    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 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 IFCAU_UserIDResponse = {
-        userID: string,
-        photoUrl: string,
-        indexRank: number,
-        name: string,
-        isVerified: boolean,
-        profileUrl: string,
-        category: string,
-        score: number,
-        type: string
+  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, 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>;
 
-    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,
-        autoMarkDelivery: boolean,
-        autoMarkRead: boolean,
-        proxy: string,
-        online: boolean
+    // 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;
+    };
+
+    // 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 };
+
+    // 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;
+    };
+
+    // 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;
+      };
+    };
 
-    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
+  // ============================================================================
+  // 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;
+    };
+
+  // ============================================================================
+  // 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;
+  };
 
-    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 }[]
+  // ============================================================================
+  // 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;
+    };
 
-    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
-        };
+  // ============================================================================
+  // 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;
+    };
+    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;
+    autoMarkDelivery: boolean;
+    autoMarkRead: boolean;
+    proxy: string;
+    online: boolean;
+  };
 }