@dongdev/fca-unofficial 3.0.31 → 4.0.0

package/index.d.ts

@@ -1,751 +0,0 @@
-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;
-    };
-
-    // 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;
-    };
-
-    // 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;
-      };
-    };
-
-  // ============================================================================
-  // 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;
-  };
-
-  // ============================================================================
-  // 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;
-    };
-
-  // ============================================================================
-  // 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;
-    autoMarkRead: boolean;
-    proxy: string;
-    online: boolean;
-  };
-}