bb-fca 2.0.9 → 2.0.11

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/dist/types/deltas/apis/posting/group.d.ts

@@ -65,4 +65,92 @@ export default function (defaultFuncs: any, api: any, ctx: any): {
         cursor: string | null;
         hasNextPage: boolean;
     }>;
+    /**
+     * Resolves a Facebook share URL to the actual group ID.
+     *
+     * Accepts various formats:
+     * - Full URL: `https://www.facebook.com/share/g/14bKqsywAfu/`
+     * - Path only: `/share/g/14bKqsywAfu/`
+     * - Short key: `14bKqsywAfu`
+     *
+     * @param {string} shareUrl The share URL, path, or short key to resolve.
+     * @returns {Promise<{ groupID: string; name: string | null; url: string | null }>}
+     *   The resolved group ID, name (if available), and canonical URL.
+     * @throws {Error} If the shareUrl is missing or the group ID cannot be extracted.
+     *
+     * @example
+     * const result = await api.group.resolveShareUrl('https://www.facebook.com/share/g/14bKqsywAfu/');
+     * console.log(result.groupID); // "1482314963016056"
+     */
+    resolveShareUrl: (shareUrl: string) => Promise<{
+        groupID: string;
+        name: string | null;
+        url: string | null;
+    }>;
+    /**
+     * Uploads a photo to Facebook for use in group posts.
+     *
+     * The photo is uploaded to `upload.facebook.com` with the group discussion
+     * route context (`CometGroupDiscussionRoute`), making it ready to be
+     * attached to a group post via {@link createGroupPost}.
+     *
+     * @param {string | string[]} photoPaths - A single file path or an array of file paths to upload.
+     * @returns {Promise<{ photoID: string; uploadID: string; data: any }[]>}
+     *   Array of upload results, one per photo, each containing:
+     *   - `photoID`  – The Facebook-assigned photo ID (use in `createGroupPost`).
+     *   - `uploadID` – The client-generated upload ID.
+     *   - `data`     – The raw server response payload.
+     * @throws {Error} If any path is missing, not a string, or doesn't exist on disk.
+     *
+     * @example
+     * const [photo] = await api.group.uploadPhoto('/path/to/image.jpg');
+     * const post = await api.group.createGroupPost('123456789', {
+     *   message: 'Check this out!',
+     *   photos: [photo.photoID],
+     * });
+     */
+    uploadPhoto: (photoPaths: string | string[]) => Promise<{
+        photoID: string;
+        uploadID: string;
+        data: any;
+    }[]>;
+    /**
+     * Creates a post in a Facebook group, optionally with photo attachments and a title.
+     *
+     * @param {string} groupID - The ID of the group to post in.
+     * @param {object} options - Post options.
+     * @param {string} [options.message=''] - The text content of the post.
+     * @param {string} [options.title] - Optional post title (for groups that support titled posts).
+     * @param {string[]} [options.photos=[]] - Array of photo IDs from {@link uploadPhoto}.
+     * @returns {Promise<{ success: boolean; postID: string | null; url: string | null; data: any }>}
+     * @throws {Error} If groupID is missing or the API request fails.
+     *
+     * @example
+     * // Text-only post
+     * await api.group.createGroupPost('123456789', { message: 'Hello group!' });
+     *
+     * // Post with photos
+     * const photos = await api.group.uploadPhoto(['/path/a.jpg', '/path/b.jpg']);
+     * await api.group.createGroupPost('123456789', {
+     *   message: 'Check these out!',
+     *   photos: photos.map(p => p.photoID),
+     * });
+     *
+     * // Post with title and photos
+     * await api.group.createGroupPost('123456789', {
+     *   message: 'Post body here',
+     *   title: 'My Post Title',
+     *   photos: photos.map(p => p.photoID),
+     * });
+     */
+    createGroupPost: (groupID: string, options?: {
+        message?: string;
+        title?: string;
+        photos?: string[];
+    }) => Promise<{
+        success: boolean;
+        postID: string | null;
+        url: string | null;
+        data: any;
+    }>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bb-fca",
-  "version": "2.0.9",
+  "version": "2.0.11",
   "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(),
+    };
   };
 }