@theophilusdev/conduit 1.0.2 → 1.1.3

package/README.md

@@ -25,8 +25,9 @@ npm install @theophilusdev/conduit
 
 ```ts
 import { ConduitClient } from "@theophilusdev/conduit";
-import appstate from "./appstate.json" assert { type: "json" };
+import fs from "fs";
 
+const appstate = fs.readFileSync("./appstate.json", "utf-8");
 const client = new ConduitClient({ listenEvents: true });
 
 await client.login({ appstate });
@@ -72,12 +73,14 @@ Handlers receive a context object and an optional `next()` function for middlewa
 
 All events include:
 
-- `send(body)`
+- `send(body)` — send a message to the same thread
 
 Message events additionally include:
 
-- `reply(body)`
-- `react(emoji)`
+- `reply(body)` — quoted reply to the triggering message
+- `react(emoji)` — react to the triggering message
+
+Both `send()` and `reply()` accept a plain string or a `ConduitMessageBody` object for rich messages with attachments and mentions.
 
 ### Message Events
 

package/dist/index.cjs

@@ -60,7 +60,24 @@ var ConduitMessagesAPI = class {
    * @param threadID - The target thread ID.
    */
   send(body, threadID) {
-    return this.bot.ctx.api.sendMessage({ body }, threadID);
+    if (typeof body === "string") {
+      return new Promise((resolve, reject) => {
+        this.bot.ctx.api.sendMessage(
+          { body },
+          threadID,
+          (err, data) => {
+            if (err) reject(err);
+            else resolve(data);
+          }
+        );
+      });
+    }
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.sendMessage(body, threadID, (err, data) => {
+        if (err) reject(err);
+        else resolve(data);
+      });
+    });
   }
   /**
    * Sends a quoted reply to a specific message.
@@ -69,12 +86,30 @@ var ConduitMessagesAPI = class {
    * @param messageID - The message ID to reply to.
    */
   reply(body, threadID, messageID) {
-    return this.bot.ctx.api.sendMessage(
-      { body },
-      threadID,
-      void 0,
-      messageID
-    );
+    if (typeof body === "string") {
+      return new Promise((resolve, reject) => {
+        this.bot.ctx.api.sendMessage(
+          { body },
+          threadID,
+          (err, data) => {
+            if (err) reject(err);
+            else resolve(data);
+          },
+          messageID
+        );
+      });
+    }
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.sendMessage(
+        body,
+        threadID,
+        (err, data) => {
+          if (err) reject(err);
+          else resolve(data);
+        },
+        messageID
+      );
+    });
   }
   /**
    * Edits an existing message.
@@ -82,21 +117,36 @@ var ConduitMessagesAPI = class {
    * @param body - The new message text.
    */
   edit(messageID, body) {
-    return this.bot.ctx.api.editMessage(body, messageID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.editMessage(body, messageID, (err, data) => {
+        if (err) reject(err);
+        else resolve(data);
+      });
+    });
   }
   /**
    * Unsends (retracts) a message sent by the bot.
    * @param messageID - The message ID to unsend.
    */
   unsend(messageID) {
-    return this.bot.ctx.api.unsendMessage(messageID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.unsendMessage(messageID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Deletes a message.
    * @param messageID - The message ID to delete.
    */
   delete(messageID) {
-    return this.bot.ctx.api.deleteMessage(messageID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.deleteMessage(messageID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Adds or removes a reaction on a message.
@@ -105,28 +155,53 @@ var ConduitMessagesAPI = class {
    * @param threadID - The thread the message belongs to.
    */
   react(emoji, messageID, threadID) {
-    return this.bot.ctx.api.setMessageReaction(emoji, messageID, threadID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.setMessageReaction(
+        emoji,
+        messageID,
+        (err) => {
+          if (err) reject(err);
+          else resolve(null);
+        },
+        threadID
+      );
+    });
   }
   /**
    * Sends a typing indicator to a thread.
    * @param threadID - The target thread ID.
    */
   sendTypingIndicator(threadID) {
-    return this.bot.ctx.api.sendTypingIndicator(threadID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.sendTypingIndicator(threadID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Marks a message as read.
    * @param messageID - The message ID to mark as read.
    */
   markAsRead(messageID) {
-    return this.bot.ctx.api.markAsRead(messageID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.markAsRead(messageID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Uploads a file attachment and returns an attachment object.
    * @param file - A readable stream or file buffer.
    */
   uploadAttachment(file) {
-    return this.bot.ctx.api.uploadAttachment(file);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.uploadAttachment(file, (err, data) => {
+        if (err) reject(err);
+        else resolve(data);
+      });
+    });
   }
   /**
    * Forwards an existing attachment to another thread.
@@ -134,7 +209,12 @@ var ConduitMessagesAPI = class {
    * @param threadID - The target thread ID.
    */
   forwardAttachment(attachmentID, threadID) {
-    return this.bot.ctx.api.forwardAttachment(attachmentID, threadID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.forwardAttachment(attachmentID, threadID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Shares a contact card to a thread.
@@ -142,7 +222,12 @@ var ConduitMessagesAPI = class {
    * @param threadID - The target thread ID.
    */
   shareContact(userID, threadID) {
-    return this.bot.ctx.api.shareContact(userID, threadID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.shareContact(userID, threadID, (err, data) => {
+        if (err) reject(err);
+        else resolve(data);
+      });
+    });
   }
   /**
    * Changes the color theme of a thread.
@@ -150,7 +235,12 @@ var ConduitMessagesAPI = class {
    * @param threadID - The target thread ID.
    */
   changeThreadColor(color, threadID) {
-    return this.bot.ctx.api.changeThreadColor(color, threadID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.changeThreadColor(color, threadID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Changes the quick-reaction emoji of a thread.
@@ -158,20 +248,35 @@ var ConduitMessagesAPI = class {
    * @param threadID - The target thread ID.
    */
   changeThreadEmoji(emoji, threadID) {
-    return this.bot.ctx.api.changeThreadEmoji(emoji, threadID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.changeThreadEmoji(emoji, threadID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Fetches a specific message by ID.
    * @param messageID - The message ID to fetch.
    */
   getMessage(messageID) {
-    return this.bot.ctx.api.getMessage(messageID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.getMessage(messageID, (err, data) => {
+        if (err) reject(err);
+        else resolve(data);
+      });
+    });
   }
   /**
    * Returns all available thread color themes.
    */
   getThreadColors() {
-    return this.bot.ctx.api.getThreadColors();
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.getThreadColors((err, data) => {
+        if (err) reject(err);
+        else resolve(data);
+      });
+    });
   }
 };
 
@@ -186,7 +291,12 @@ var ConduitThreadsAPI = class {
    * @param threadID - The thread ID to query.
    */
   getInfo(threadID) {
-    return this.bot.ctx.api.getThreadInfo(threadID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.getThreadInfo(threadID, (err, data) => {
+        if (err) reject(err);
+        else resolve(data);
+      });
+    });
   }
   /**
    * Fetches a paginated list of threads.
@@ -195,7 +305,17 @@ var ConduitThreadsAPI = class {
    * @param folders - Folder filters e.g. `["INBOX"]`.
    */
   getList(limit, cursor, folders) {
-    return this.bot.ctx.api.getThreadList(limit, cursor, folders);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.getThreadList(
+        limit,
+        cursor,
+        folders,
+        (err, data) => {
+          if (err) reject(err);
+          else resolve(data);
+        }
+      );
+    });
   }
   /**
    * Fetches message history for a thread.
@@ -203,14 +323,29 @@ var ConduitThreadsAPI = class {
    * @param limit - Number of messages to return.
    */
   getHistory(threadID, limit) {
-    return this.bot.ctx.api.getThreadHistory(threadID, limit);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.getThreadHistory(
+        threadID,
+        limit,
+        void 0,
+        (err, data) => {
+          if (err) reject(err);
+          else resolve(data);
+        }
+      );
+    });
   }
   /**
    * Searches for threads by name or keyword.
    * @param query - The search query string.
    */
   search(query) {
-    return this.bot.ctx.api.searchForThread(query);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.searchForThread(query, (err, data) => {
+        if (err) reject(err);
+        else resolve(data);
+      });
+    });
   }
   /**
    * Creates a new group conversation.
@@ -218,7 +353,12 @@ var ConduitThreadsAPI = class {
    * @param name - Optional group name.
    */
   createGroup(userIDs, name) {
-    return this.bot.ctx.api.createNewGroup(userIDs, name);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.createNewGroup(userIDs, name, (err, data) => {
+        if (err) reject(err);
+        else resolve(data);
+      });
+    });
   }
   /**
    * Adds a user to an existing group thread.
@@ -226,7 +366,12 @@ var ConduitThreadsAPI = class {
    * @param threadID - The target group thread ID.
    */
   addUser(userID, threadID) {
-    return this.bot.ctx.api.addUserToGroup(userID, threadID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.addUserToGroup(userID, threadID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Removes a user from a group thread.
@@ -234,7 +379,12 @@ var ConduitThreadsAPI = class {
    * @param threadID - The target group thread ID.
    */
   removeUser(userID, threadID) {
-    return this.bot.ctx.api.removeUserFromGroup(userID, threadID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.removeUserFromGroup(userID, threadID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Promotes or demotes a user's admin status in a group.
@@ -243,7 +393,17 @@ var ConduitThreadsAPI = class {
    * @param admin - `true` to promote, `false` to demote.
    */
   changeAdminStatus(userID, threadID, admin) {
-    return this.bot.ctx.api.changeAdminStatus(userID, threadID, admin);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.changeAdminStatus(
+        userID,
+        threadID,
+        admin,
+        (err) => {
+          if (err) reject(err);
+          else resolve(null);
+        }
+      );
+    });
   }
   /**
    * Updates the group's profile image.
@@ -251,7 +411,12 @@ var ConduitThreadsAPI = class {
    * @param threadID - The target group thread ID.
    */
   changeGroupImage(image, threadID) {
-    return this.bot.ctx.api.changeGroupImage(image, threadID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.changeGroupImage(image, threadID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Sets a participant's nickname in a thread.
@@ -260,7 +425,17 @@ var ConduitThreadsAPI = class {
    * @param userID - The target user ID.
    */
   changeNickname(nickname, threadID, userID) {
-    return this.bot.ctx.api.changeNickname(nickname, threadID, userID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.changeNickname(
+        nickname,
+        threadID,
+        userID,
+        (err) => {
+          if (err) reject(err);
+          else resolve(null);
+        }
+      );
+    });
   }
   /**
    * Changes the title of a group thread.
@@ -268,7 +443,12 @@ var ConduitThreadsAPI = class {
    * @param threadID - The target group thread ID.
    */
   setTitle(title, threadID) {
-    return this.bot.ctx.api.setTitle(title, threadID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.setTitle(title, threadID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Creates a poll in a thread.
@@ -277,14 +457,29 @@ var ConduitThreadsAPI = class {
    * @param options - Array of answer options.
    */
   createPoll(title, threadID, options) {
-    return this.bot.ctx.api.createPoll(title, threadID, options);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.createPoll(
+        title,
+        threadID,
+        options,
+        (err, data) => {
+          if (err) reject(err);
+          else resolve(data);
+        }
+      );
+    });
   }
   /**
    * Deletes a thread.
    * @param threadID - The thread ID to delete.
    */
   delete(threadID) {
-    return this.bot.ctx.api.deleteThread(threadID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.deleteThread(threadID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Mutes or unmutes notifications for a thread.
@@ -292,7 +487,12 @@ var ConduitThreadsAPI = class {
    * @param muteUntil - Timestamp (ms) to mute until. Pass `-1` to mute indefinitely, `0` to unmute.
    */
   mute(threadID, muteUntil) {
-    return this.bot.ctx.api.muteThread(threadID, muteUntil);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.muteThread(threadID, muteUntil, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Accepts or declines a message request.
@@ -300,7 +500,12 @@ var ConduitThreadsAPI = class {
    * @param accept - `true` to accept, `false` to decline.
    */
   handleMessageRequest(threadID, accept) {
-    return this.bot.ctx.api.handleMessageRequest(threadID, accept);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.handleMessageRequest(threadID, accept, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
 };
 
@@ -315,20 +520,38 @@ var ConduitUsersAPI = class {
    * @param userID - A single user ID or an array of user IDs.
    */
   getInfo(userID) {
-    return this.bot.ctx.api.getUserInfo(userID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.getUserInfo(
+        Array.isArray(userID) ? userID : [userID],
+        (err, data) => {
+          if (err) reject(err);
+          else resolve(data);
+        }
+      );
+    });
   }
   /**
    * Resolves a vanity URL or username to a Facebook user ID.
    * @param vanity - The vanity name or profile URL slug.
    */
   getID(vanity) {
-    return this.bot.ctx.api.getUserID(vanity);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.getUserID(vanity, (err, data) => {
+        if (err) reject(err);
+        else resolve(data);
+      });
+    });
   }
   /**
    * Returns the authenticated user's friends list.
    */
   getFriendsList() {
-    return this.bot.ctx.api.getFriendsList();
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.getFriendsList((err, data) => {
+        if (err) reject(err);
+        else resolve(data);
+      });
+    });
   }
 };
 
@@ -350,7 +573,12 @@ var ConduitAccountAPI = class {
    * @param block - `true` to block, `false` to unblock.
    */
   blockUser(userID, block) {
-    return this.bot.ctx.api.changeBlockedStatus(userID, block);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.changeBlockedStatus(userID, block, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Accepts or declines a friend request.
@@ -358,20 +586,35 @@ var ConduitAccountAPI = class {
    * @param accept - `true` to accept, `false` to decline.
    */
   handleFriendRequest(userID, accept) {
-    return this.bot.ctx.api.handleFriendRequest(userID, accept);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.handleFriendRequest(userID, accept, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Removes a user from the friends list.
    * @param userID - The target user ID.
    */
   unfriend(userID) {
-    return this.bot.ctx.api.unfriend(userID);
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.unfriend(userID, (err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
   /**
    * Ends the current session and invalidates cookies.
    */
   logout() {
-    return this.bot.ctx.api.logout();
+    return new Promise((resolve, reject) => {
+      this.bot.ctx.api.logout((err) => {
+        if (err) reject(err);
+        else resolve(null);
+      });
+    });
   }
 };