bb-fca 2.0.9 → 2.0.10

package/dist/types/deltas/apis/messaging/gcname.d.ts

@@ -1 +1,9 @@
-export default function (defaultFuncs: any, api: any, ctx: any): (newName: any, threadID: any, callback: any, initiatorID: any) => any;
+/**
+ * Made by Choru Official
+ * Sets the name of a group chat thread via MQTT.
+ *
+ * @param {Object} defaultFuncs
+ * @param {Object} api
+ * @param {Object} ctx
+ */
+export default function gcname(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/gcrule.d.ts

@@ -1 +1,7 @@
-export default function (defaultFuncs: any, api: any, ctx: any): (action: any, userID: any, threadID: any, callback: any) => Promise<any>;
+/**
+ * @module gcrule
+ * @param {Object} defaultFuncs
+ * @param {Object} api
+ * @param {Object} ctx
+ */
+export default function gcrule(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/markAsDelivered.d.ts

@@ -2,6 +2,5 @@
  * @param {Object} defaultFuncs
  * @param {Object} api
  * @param {Object} ctx
- * @returns {function(threadID: string, messageID: string): Promise<void>}
  */
-export default function (defaultFuncs: any, api: any, ctx: any): (threadID: any, messageID: any) => Promise<void>;
+export default function markAsDelivered(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/markAsRead.d.ts

@@ -3,4 +3,4 @@
  * @param {Object} api
  * @param {Object} ctx
  */
-export default function (defaultFuncs: any, api: any, ctx: any): (threadID: any, read: any, callback: any) => Promise<any>;
+export default function markAsRead(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/markAsReadAll.d.ts

@@ -2,6 +2,5 @@
  * @param {Object} defaultFuncs
  * @param {Object} api
  * @param {Object} ctx
- * @returns {function(): Promise<void>}
  */
-export default function (defaultFuncs: any, api: any, ctx: any): () => Promise<void>;
+export default function markAsReadAll(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/markAsSeen.d.ts

@@ -3,4 +3,4 @@
  * @param {Object} api
  * @param {Object} ctx
  */
-export default function (defaultFuncs: any, api: any, ctx: any): (seen_timestamp: any, callback: any) => Promise<any>;
+export default function markAsSeen(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/nickname.d.ts

@@ -1 +1,7 @@
-export default function (defaultFuncs: any, api: any, ctx: any): (nickname: any, threadID: any, participantID: any, callback: any, initiatorID: any) => any;
+/**
+ * @module nickname
+ * @param {Object} defaultFuncs
+ * @param {Object} api
+ * @param {Object} ctx
+ */
+export default function nickname(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/notes.d.ts

@@ -1,14 +1,16 @@
 /**
- * @ChoruOfficial
- * @description A module for interacting with Facebook Messenger Notes. This is not for creating notes on a user's profile page, but rather the temporary status-like notes in Messenger.
- * @param {Object} defaultFuncs The default functions provided by the API wrapper.
- * @param {Object} api The full API object.
- * @param {Object} ctx The context object containing the user's session state (e.g., userID, jar).
- * @returns {Object} An object containing methods to create, delete, recreate, and check notes.
+ * @module notes
+ * @description Interacts with Facebook Messenger Notes (temporary status-like notes).
+ * @param {Object} defaultFuncs
+ * @param {Object} api
+ * @param {Object} ctx
  */
-export default function (defaultFuncs: any, api: any, ctx: any): {
-    create: (text: any, privacy?: string, callback?: any) => void;
-    delete: (noteID: any, callback: any) => void;
-    recreate: (oldNoteID: any, newText: any, callback: any) => void;
-    check: (callback: any) => void;
+export default function notes(defaultFuncs: any, api: any, ctx: any): {
+    create: (text: string, privacy?: string) => Promise<any>;
+    delete: (noteID: string) => Promise<any>;
+    recreate: (oldNoteID: string, newText: string) => Promise<{
+        deleted: any;
+        created: any;
+    }>;
+    check: () => Promise<any>;
 };

package/dist/types/deltas/apis/messaging/resolvePhotoUrl.d.ts

@@ -1,9 +1,7 @@
 /**
  * @module resolvePhotoUrl
- * @description Fetches the direct URL of a Facebook photo using its photo ID.
- * @param {Object} defaultFuncs - An object containing default request functions.
- * @param {Object} api - Facebook API object (unused here but kept for compatibility).
- * @param {Object} ctx - Context object containing cookies (jar) and other session info.
- * @returns {Function} resolvePhotoUrl - A function that takes a photo ID and optional callback, and returns a Promise resolving to the photo URL.
+ * @param {Object} defaultFuncs
+ * @param {Object} api
+ * @param {Object} ctx
  */
-export default function (defaultFuncs: any, api: any, ctx: any): (photoID: any, callback: any) => Promise<any>;
+export default function resolvePhotoUrl(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/sendMessage.d.ts

@@ -1 +1 @@
-export default function (defaultFuncs: any, api: any, ctx: any): (msg: any, threadID: any, replyToMessage: any, isSingleUser?: boolean) => Promise<any>;
+export default function sendMessage(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/sendTypingIndicator.d.ts

@@ -3,4 +3,4 @@
  * @param {Object} api
  * @param {Object} ctx
  */
-export default function (defaultFuncs: any, api: any, ctx: any): (sendTyping: any, threadID: any, callback: any) => Promise<void>;
+export default function sendTypingIndicator(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/setMessageReaction.d.ts

@@ -1 +1,6 @@
-export default function (defaultFuncs: any, api: any, ctx: any): (reaction: any, messageID: any) => Promise<void>;
+/**
+ * @param {Object} defaultFuncs
+ * @param {Object} api
+ * @param {Object} ctx
+ */
+export default function setMessageReaction(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/shareContact.d.ts

@@ -3,6 +3,5 @@
  * @param {Object} defaultFuncs - The default functions provided by the API.
  * @param {Object} api - The full API object.
  * @param {Object} ctx - The context object.
- * @returns {function(text: string, senderID: string, threadID: string, callback: Function): void} - A function to share a contact.
  */
-export default function (defaultFuncs: any, api: any, ctx: any): (text: any, senderID: any, threadID: any, callback: any) => void;
+export default function shareContact(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/stickers.d.ts

@@ -3,7 +3,7 @@
  * Provides access to Facebook's GraphQL-based sticker endpoints.
  * Made by @ChoruOfficial
  */
-export default function (defaultFuncs: any, api: any, ctx: any): {
+export default function stickers(defaultFuncs: any, api: any, ctx: any): {
     /**
      * Search for stickers by keyword
      * @param {string} query - Search term

package/dist/types/deltas/apis/messaging/theme.d.ts

@@ -1 +1,8 @@
-export default function (defaultFuncs: any, api: any, ctx: any): (themeName: any, threadID: any, callback: any, initiatorID: any) => Promise<any>;
+/**
+ * @module theme
+ * @description Manages or sets the custom theme for a Facebook thread. Made by Choru Official.
+ * @param {Object} defaultFuncs
+ * @param {Object} api
+ * @param {Object} ctx
+ */
+export default function theme(defaultFuncs: any, api: any, ctx: any): Function;

package/dist/types/deltas/apis/messaging/unsendMessage.d.ts

@@ -1 +1,6 @@
-export default function (defaultFuncs: any, api: any, ctx: any): (messageID: any) => Promise<any>;
+/**
+ * @param {Object} defaultFuncs
+ * @param {Object} api
+ * @param {Object} ctx
+ */
+export default function unsendMessage(defaultFuncs: any, api: any, ctx: any): Function;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bb-fca",
-  "version": "2.0.9",
+  "version": "2.0.10",
   "description": "BB-FCA is a powerful and user-friendly Facebook Chat API wrapper for Node.js, designed to simplify the process of creating chatbots and automating interactions on Facebook Messenger. With BB-FCA, developers can easily send messages, manage conversations, and interact with the Facebook Messenger platform using a simple and intuitive API.",
   "main": "dist/core/client.js",
   "types": "dist/index.d.ts",

package/src/deltas/apis/messaging/editMessage.ts

@@ -2,27 +2,25 @@
  * @author RFS-ADRENO
  * @rewrittenBy Isai Ivanov
  */
-//fixed march 30
 import utils = require('../../../utils');
 
-function canBeCalled(func) {
-  try {
-    Reflect.apply(func, null, []);
-    return true;
-  } catch (error) {
-    return false;
-  }
-}
-
 /**
- * A function for editing bot's messages.
- * @param {string} text - The text with which the bot will edit its messages.
- * @param {string} messageID - The message ID of the message the bot will edit.
- * @param {Object} callback - Callback for the function.
+ * @param {Object} defaultFuncs
+ * @param {Object} api
+ * @param {Object} ctx
  */
-
-export default function(defaultFuncs: any, api: any, ctx: any) {
-  return function editMessage(text, messageID, callback) {
+export default function editMessage(
+  defaultFuncs: any,
+  api: any,
+  ctx: any,
+): Function {
+  /**
+   * Edits a message previously sent by the bot via MQTT.
+   * @param {string} text - The new text for the message.
+   * @param {string} messageID - The ID of the message to edit.
+   * @returns {void}
+   */
+  return function editMessage(text: string, messageID: string): void {
     if (!ctx.mqttClient) {
       throw new Error('Not connected to MQTT');
     }
@@ -30,10 +28,7 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
     ctx.wsReqNumber += 1;
     ctx.wsTaskNumber += 1;
 
-    const queryPayload = {
-      message_id: messageID,
-      text,
-    };
+    const queryPayload = { message_id: messageID, text };
 
     const query = {
       failure_count: null,
@@ -54,13 +49,8 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
       request_id: ctx.wsReqNumber,
       type: 3,
     };
-
     context.payload = JSON.stringify(context.payload);
 
-    // if (canBeCalled(callback)) {
-    // 	ctx.reqCallbacks[ctx.wsReqNumber] = callback;
-    // }
-
     ctx.mqttClient.publish('/ls_req', JSON.stringify(context), {
       qos: 1,
       retain: false,

package/src/deltas/apis/messaging/emoji.ts

@@ -1,88 +1,40 @@
 import utils = require('../../../utils');
 
-export default function(defaultFuncs: any, api: any, ctx: any) {
+/**
+ * @module emoji
+ * @param {Object} defaultFuncs
+ * @param {Object} api
+ * @param {Object} ctx
+ */
+export default function emoji(
+  defaultFuncs: any,
+  api: any,
+  ctx: any,
+): Function {
   /**
-   * Made by Choru Official
-   * Mqtt
-   * Sets the custom emoji for a specific Facebook thread via MQTT.
-   *
-   * @param {string} emoji The emoji character to set as the custom emoji (e.g., "👍", "❤️").
-   * @param {string} threadID The ID of the thread where the emoji will be set.
-   * @param {Function} [callback] Optional callback function to be invoked upon completion.
-   * @param {string} [initiatorID] The ID of the user who initiated the emoji change (e.g., from event.senderID).
-   * @returns {Promise<object>} A promise that resolves with a structured event object on success or rejects on error.
+   * Made by Choru Official — sets the custom emoji for a thread via MQTT.
+   * @param {string} emoji - The emoji character to set (e.g., "👍", "❤️").
+   * @param {string} threadID - The ID of the thread.
+   * @param {string} [initiatorID] - The ID of the initiating user.
+   * @returns {Promise<object>}
    */
-  return function emoji(emoji, threadID, callback, initiatorID) {
-    let _callback;
-    let _initiatorID;
+  return async function emoji(
+    emojiChar: string,
+    threadID: string,
+    initiatorID?: string,
+  ): Promise<any> {
+    const _initiatorID = initiatorID || ctx.userID;
 
-    let _resolvePromise;
-    let _rejectPromise;
-    const returnPromise = new Promise<any>((resolve, reject) => {
-      _resolvePromise = resolve;
-      _rejectPromise = reject;
-    });
-
-    if (
-      utils.getType(callback) === 'Function' ||
-      utils.getType(callback) === 'AsyncFunction'
-    ) {
-      _callback = callback;
-      _initiatorID = initiatorID;
-    } else if (
-      utils.getType(threadID) === 'Function' ||
-      utils.getType(threadID) === 'AsyncFunction'
-    ) {
-      _callback = threadID;
-      threadID = null;
-      _initiatorID = callback;
-    } else if (utils.getType(callback) === 'string') {
-      _initiatorID = callback;
-      _callback = undefined;
-    } else {
-      _callback = undefined;
-      _initiatorID = undefined;
-    }
-
-    if (!_callback) {
-      _callback = function(__err, __data) {
-        if (__err) _rejectPromise(__err);
-        else _resolvePromise(__data);
-      };
-    } else {
-      const originalCallback = _callback;
-      _callback = function(__err, __data) {
-        if (__err) {
-          originalCallback(__err);
-          _rejectPromise(__err);
-        } else {
-          originalCallback(null, __data);
-          _resolvePromise(__data);
-        }
-      };
-    }
-
-    _initiatorID = _initiatorID || ctx.userID;
-
-    threadID = threadID || ctx.threadID;
-
-    if (!threadID) {
-      return _callback(new Error('threadID is required to set an emoji.'));
-    }
-    if (!emoji) {
-      return _callback(new Error('An emoji character is required.'));
-    }
-
-    if (!ctx.mqttClient) {
-      return _callback(new Error('Not connected to MQTT'));
-    }
+    if (!threadID) throw new Error('threadID is required to set an emoji.');
+    if (!emojiChar) throw new Error('An emoji character is required.');
+    if (!ctx.mqttClient) throw new Error('Not connected to MQTT');
 
     ctx.wsReqNumber += 1;
     ctx.wsTaskNumber += 1;
 
     const queryPayload = {
       thread_key: threadID.toString(),
-      custom_emoji: emoji,
+      custom_emoji: emojiChar,
       avatar_sticker_instruction_key_id: null,
       sync_group: 1,
     };
@@ -98,7 +50,7 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
     const context: any = {
       app_id: ctx.appID,
       payload: {
-        epoch_id: parseInt(utils.generateOfflineThreadingID()),
+        epoch_id: Number.parseInt(utils.generateOfflineThreadingID()),
         tasks: [query],
         version_id: '24631415369801570',
       },
@@ -107,29 +59,25 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
     };
     context.payload = JSON.stringify(context.payload);
 
-    ctx.mqttClient.publish(
-      '/ls_req',
-      JSON.stringify(context),
-      { qos: 1, retain: false },
-      (err) => {
-        if (err) {
-          return _callback(
-            new Error(`MQTT publish failed for emoji: ${err.message || err}`),
-          );
-        }
-
-        const emojiChangeEvent = {
-          type: 'thread_emoji_update',
-          threadID: threadID,
-          newEmoji: emoji,
-          senderID: _initiatorID,
-          BotID: ctx.userID,
-          timestamp: Date.now(),
-        };
-        _callback(null, emojiChangeEvent);
-      },
+    await new Promise<void>((resolve, reject) =>
+      ctx.mqttClient.publish(
+        '/ls_req',
+        JSON.stringify(context),
+        { qos: 1, retain: false },
+        (err) =>
+          err
+            ? reject(new Error(`MQTT publish failed for emoji: ${err.message || err}`))
+            : resolve(),
+      ),
     );
 
-    return returnPromise;
+    return {
+      type: 'thread_emoji_update',
+      threadID,
+      newEmoji: emojiChar,
+      senderID: _initiatorID,
+      BotID: ctx.userID,
+      timestamp: Date.now(),
+    };
   };
 }

package/src/deltas/apis/messaging/gcmember.ts

@@ -1,106 +1,71 @@
 import utils = require('../../../utils');
 
-export default function(defaultFuncs: any, api: any, ctx: any) {
+/**
+ * @module gcmember
+ * @param {Object} defaultFuncs
+ * @param {Object} api
+ * @param {Object} ctx
+ */
+export default function gcmember(
+  defaultFuncs: any,
+  api: any,
+  ctx: any,
+): Function {
   /**
-   * Made by ChoruOfficial
-   * Mqtt
-   * Adds or removes members from a group chat with pre-checking.
-   *
-   * @param {"add" | "remove"} action The action to perform.
-   * @param {string|string[]} userIDs The user ID or array of user IDs.
-   * @param {string} threadID The ID of the group chat.
-   * @param {Function} [callback] Optional callback function.
-   * @returns {Promise<object>} A promise that resolves with information about the action.
+   * Made by ChoruOfficial — Adds or removes members from a group chat via MQTT.
+   * @param {"add" | "remove"} action - The action to perform.
+   * @param {string | string[]} userIDs - The user ID or array of user IDs.
+   * @param {string} threadID - The ID of the group chat.
+   * @returns {Promise<object>}
    */
-  return async function gcmember(action, userIDs, threadID, callback) {
-    let _callback;
-    if (typeof threadID === 'function') {
-      _callback = threadID;
-      threadID = null;
-    } else if (typeof callback === 'function') {
-      _callback = callback;
-    }
-
-    let resolvePromise, rejectPromise;
-    const returnPromise = new Promise<any>((resolve, reject) => {
-      resolvePromise = resolve;
-      rejectPromise = reject;
-    });
+  return async function gcmember(
+    action: 'add' | 'remove',
+    userIDs: string | string[],
+    threadID: string,
+  ): Promise<any> {
+    const validActions = ['add', 'remove'];
+    const normalizedAction = (action || '').toLowerCase() as 'add' | 'remove';
 
-    if (typeof _callback != 'function') {
-      _callback = (err, data) => {
-        // Note: We will now rarely use the 'err' parameter for validation errors
-        if (err) return rejectPromise(err);
-        resolvePromise(data);
-      };
+    if (!validActions.includes(normalizedAction)) {
+      return { type: 'error_gc', error: `Invalid action. Must be one of: ${validActions.join(', ')}` };
+    }
+    if (!userIDs || (Array.isArray(userIDs) && userIDs.length === 0)) {
+      return { type: 'error_gc', error: 'userIDs is required.' };
+    }
+    if (!threadID) {
+      return { type: 'error_gc', error: 'threadID is required.' };
+    }
+    if (!ctx.mqttClient) {
+      return { type: 'error_gc', error: 'Not connected to MQTT' };
     }
 
     try {
-      const validActions = ['add', 'remove'];
-      action = action ? action.toLowerCase() : '';
-
-      // --- ERROR CHECKS NOW RETURN AN OBJECT INSTEAD OF THROWING ---
-      if (!validActions.includes(action)) {
-        return _callback(null, {
-          type: 'error_gc',
-          error: `Invalid action. Must be one of: ${validActions.join(', ')}`,
-        });
-      }
-      if (!userIDs || userIDs.length === 0) {
-        return _callback(null, {
-          type: 'error_gc',
-          error: 'userIDs is required.',
-        });
-      }
-      if (!threadID) {
-        return _callback(null, {
-          type: 'error_gc',
-          error: 'threadID is required.',
-        });
-      }
-      if (!ctx.mqttClient) {
-        return _callback(null, {
-          type: 'error_gc',
-          error: 'Not connected to MQTT',
-        });
-      }
-
       const threadInfo = await api.getThreadInfo(threadID);
       if (!threadInfo) {
-        return _callback(null, {
-          type: 'error_gc',
-          error: 'Could not retrieve thread information.',
-        });
+        return { type: 'error_gc', error: 'Could not retrieve thread information.' };
       }
       if (threadInfo.isGroup === false) {
-        return _callback(null, {
-          type: 'error_gc',
-          error: 'This feature is only for group chats, not private messages.',
-        });
+        return { type: 'error_gc', error: 'This feature is only for group chats, not private messages.' };
       }
 
-      const currentMembers = threadInfo.participantIDs;
+      const currentMembers: string[] = threadInfo.participantIDs;
       const usersToModify = Array.isArray(userIDs) ? userIDs : [userIDs];
-      let queryPayload, query;
-      let finalUsers = usersToModify;
 
       ctx.wsReqNumber = (ctx.wsReqNumber || 0) + 1;
       ctx.wsTaskNumber = (ctx.wsTaskNumber || 0) + 1;
 
-      if (action === 'add') {
-        const usersToAdd = usersToModify.filter(
-          (id) => !currentMembers.includes(id),
-        );
+      let query: any;
+      let finalUsers: string[];
+
+      if (normalizedAction === 'add') {
+        const usersToAdd = usersToModify.filter((id) => !currentMembers.includes(id));
         if (usersToAdd.length === 0) {
-          return _callback(null, {
-            type: 'error_gc',
-            error: 'All specified users are already in the group.',
-          });
+          return { type: 'error_gc', error: 'All specified users are already in the group.' };
         }
         finalUsers = usersToAdd;
-        queryPayload = {
-          thread_key: parseInt(threadID),
-          contact_ids: finalUsers.map((id) => parseInt(id)),
+        const queryPayload = {
+          thread_key: Number.parseInt(threadID),
+          contact_ids: finalUsers.map((id) => Number.parseInt(id)),
           sync_group: 1,
         };
         query = {
@@ -110,16 +75,12 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
           task_id: ctx.wsTaskNumber,
         };
       } else {
-        // action is 'remove'
         const userToRemove = usersToModify[0];
         if (!currentMembers.includes(userToRemove)) {
-          return _callback(null, {
-            type: 'error_gc',
-            error: `User with ID ${userToRemove} is not in this group chat.`,
-          });
+          return { type: 'error_gc', error: `User with ID ${userToRemove} is not in this group chat.` };
         }
         finalUsers = [userToRemove];
-        queryPayload = {
+        const queryPayload = {
           thread_id: threadID,
           contact_id: userToRemove,
           sync_group: 1,
@@ -135,7 +96,7 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
       const context: any = {
         app_id: ctx.appID,
         payload: {
-          epoch_id: parseInt(utils.generateOfflineThreadingID()),
+          epoch_id: Number.parseInt(utils.generateOfflineThreadingID()),
           tasks: [query],
           version_id: '24631415369801570',
         },
@@ -144,32 +105,26 @@ export default function(defaultFuncs: any, api: any, ctx: any) {
       };
       context.payload = JSON.stringify(context.payload);
 
-      ctx.mqttClient.publish(
-        '/ls_req',
-        JSON.stringify(context),
-        { qos: 1, retain: false },
-        (err) => {
-          if (err) return _callback(err); // For network errors, we still reject
-
-          const gcmemberInfo = {
-            type: 'gc_member_update',
-            threadID: threadID,
-            userIDs: finalUsers,
-            action: action,
-            senderID: ctx.userID,
-            BotID: ctx.userID,
-            timestamp: Date.now(),
-          };
-          return _callback(null, gcmemberInfo);
-        },
+      await new Promise<void>((resolve, reject) =>
+        ctx.mqttClient.publish(
+          '/ls_req',
+          JSON.stringify(context),
+          { qos: 1, retain: false },
+          (err) => (err ? reject(err) : resolve()),
+        ),
       );
-    } catch (err) {
-      return _callback(null, {
-        type: 'error_gc',
-        error: err.message || 'An unknown error occurred.',
-      });
-    }
 
-    return returnPromise;
+      return {
+        type: 'gc_member_update',
+        threadID,
+        userIDs: finalUsers,
+        action: normalizedAction,
+        senderID: ctx.userID,
+        BotID: ctx.userID,
+        timestamp: Date.now(),
+      };
+    } catch (err: any) {
+      return { type: 'error_gc', error: err.message || 'An unknown error occurred.' };
+    }
   };
 }