beniocord.js 2.0.9 → 2.1.1

package/Client.js

@@ -10,30 +10,60 @@ const User = require("./structures/User");
 const Channel = require("./structures/Channel");
 const Emoji = require("./structures/Emoji");
 const { MessageEmbed, MessageAttachment } = require("./structures/Util");
-
-class ClientError extends Error {
-  constructor(message, code) {
-    super(message);
-    this.name = 'ClientError';
-    this.code = code;
-  }
-}
+const { formatUrl } = require("./helpers");
 
 let global = {
   token: "",
   apiUrl: "https://api-bots.beniocord.site"
 };
 
-/**
- * @fires Client#ready
- * @fires Client#messageCreate
- * @fires Client#messageDelete
- * @fires Client#messageEdit
- * @fires Client#error
- * @fires Client#disconnect
- * @fires Client#reconnect
- */
 class Client extends EventEmitter {
+  /**
+   * @typedef {Object} ClientEvents
+   * @property {User} ready - Fired when the client finishes connecting
+   * @property {Message} messageCreate - Fired when a new message is created
+   * @property {Message} messageUpdate - Fired when a message is updated
+   * @property {Message} messageDelete - Fired when a message is deleted
+   * @property {Channel} channelCreate - Fired when a new channel is created
+   * @property {Channel} channelDelete - Fired when a channel is deleted
+   * @property {Channel} channelUpdate - Fired when a channel is updated
+   * @property {{channel: Channel, member: User}} channelMemberAdd - Fired when a member joins a channel
+   * @property {{channel: Channel, member: User}} channelMemberRemove - Fired when a member leaves a channel
+   * @property {User} channelMemberUpdate - Fired when a member updates their info in a channel
+   * @property {Emoji} emojiCreate - Fired when a new emoji is created
+   * @property {Emoji} emojiDelete - Fired when an emoji is deleted
+   * @property {Error} error - Fired when an error occurs
+   * @property {void} disconnect - Fired when disconnected from the gateway
+   * @property {void} reconnect - Fired when reconnecting to the gateway
+   * 
+   * @fires Client#ready
+   * @fires Client#messageCreate
+   * @fires Client#messageDelete
+   * @fires Client#messageEdit
+   * @fires Client#error
+   * @fires Client#disconnect
+   * @fires Client#reconnect
+   * @fires Client#emojiCreate
+   * @fires Client#emojiDelete
+   * @fires Client#stickerCreate
+   * @fires Client#stickerDelete
+   * @fires Client#channelCreate
+   * @fires Client#channelDelete
+   * @fires Client#channelUpdate
+   * @fires Client#channelMemberAdd
+   * @fires Client#channelMemberRemove
+   * @fires Client#channelMemberUpdate
+   * @fires Client#typingStart
+   * @fires Client#typingStop
+   * @class Client
+   * @description The main class of BenioCord.js, responsible for managing API communication and bot events.
+   * @param {Object} options - Opções de configuração do cliente
+   * @param {string} options.token - Token do bot para autenticação
+   * @example
+   * const Beniocord = require('beniocord.js');
+   * const client = new Beniocord({ token: 'YOUR_BOT_TOKEN' });
+   * client.login();
+   */
   constructor({ token }) {
     super();
 
@@ -50,6 +80,7 @@ class Client extends EventEmitter {
     this.isConnected = false;
     this.isReady = false;
     this.status = 'online';
+    this.version = require('./package.json').version;
 
     // Configuration options
     this.config = {
@@ -141,6 +172,10 @@ class Client extends EventEmitter {
       await this._joinAllChannelRooms();
 
       this.isReady = true;
+
+      /**
+       * @event Client#ready
+       */
       this.emit("ready", this.user);
 
       return this.user;
@@ -159,7 +194,8 @@ class Client extends EventEmitter {
   }
 
   /**
-   * Disconnects the bot from the server
+   * Kills the connection to the server
+   * @returns {void}
    */
   disconnect() {
     this._stopHeartbeat();
@@ -198,10 +234,14 @@ class Client extends EventEmitter {
   /**
    * Sets the bot's status
    * @param {string} status - Status: "online", "away", "dnd", "offline"
+   * @returns {Promise<Object>}
+   * @example
+   * client.setStatus("dnd").then((data) => {
+   *  console.log("Status updated:", data);
+   * });
    */
   async setStatus(status) {
     const validStatuses = ["online", "offline", "away", "dnd"];
-
     if (!validStatuses.includes(status)) {
       throw new ClientError(
         `Invalid status. Valid statuses are: ${validStatuses.join(", ")}`,
@@ -211,12 +251,19 @@ class Client extends EventEmitter {
 
     this._ensureConnected();
     this.status = status;
-    this.socket.emit('status:update', { status });
+
+    return new Promise((resolve) => {
+      this.socket.once('user:status-update', (data) => {
+        resolve(data);
+      });
+
+      this.socket.emit('status:update', { status });
+    });
   }
 
   /**
    * Fetches information about the bot user
-   * @param {boolean} force - Force fetch from API instead of cache
+   * @param {boolean} [force=false] - Force fetch from API instead of cache
    * @returns {Promise<User>} Bot user object
    */
   async fetchMe(force = false) {
@@ -240,7 +287,7 @@ class Client extends EventEmitter {
   /**
    * Fetches a user by ID
    * @param {string} id - User ID
-   * @param {boolean} force - Force fetch from API instead of cache
+   * @param {boolean} [force=false] - Force fetch from API instead of cache
    * @returns {Promise<User>} User object
    */
   async fetchUser(id, force = false) {
@@ -286,7 +333,7 @@ class Client extends EventEmitter {
   /**
    * Fetches a specific channel by ID
    * @param {string} id - Channel ID
-   * @param {boolean} force - Force fetch from API instead of cache
+   * @param {boolean} [force=false] - Force fetch from API instead of cache
    * @returns {Promise<Channel>} Channel object
    */
   async fetchChannel(id, force = false) {
@@ -409,7 +456,7 @@ class Client extends EventEmitter {
    * Adds a member to a channel
    * @param {string} channelId - Channel ID
    * @param {string} userId - User ID to add
-   * @param {string} role - Member role (default: 'member')
+   * @param {string} [role] - Member role (default: 'member')
    * @returns {Promise<Object>} Response data
    */
   async addChannelMember(channelId, userId, role = 'member') {
@@ -665,9 +712,43 @@ class Client extends EventEmitter {
   async fetchMessage(channelId, messageId) {
     try {
       const res = await this._axios.get(`/api/channels/${channelId}/messages/${messageId}`);
-      return new Message(res.data, this);
+      const raw = res.data;
+
+      // --- USER ---
+      const userData = {
+        id: raw.user_id,
+        username: raw.username,
+        display_name: raw.display_name,
+        avatar_url: raw.avatar_url,
+        status: raw.status || 'online',
+        emblems: raw.emblems || [],
+        is_bot: raw.is_bot ?? false,
+        last_seen: raw.last_seen ?? raw.created_at,
+        created_at: raw.created_at,
+      };
+      const messageData = { ...raw, user: userData };
+
+      // Cria a mensagem
+      const message = new Message(messageData, this);
+
+      // Cache do author
+      if (message.author) this.cache.users.set(message.author.id, message.author);
+
+      // --- CHANNEL ---
+      if (!message.channel && raw.channel_id) {
+        // Tenta pegar da cache
+        let channel = this.cache.channels.get(raw.channel_id);
+        if (!channel) {
+          channel = await this.fetchChannel(raw.channel_id);
+        }
+        message.channel = channel;
+      }
+
+      return message;
     } catch (error) {
-      throw error instanceof ClientError ? error : new ClientError(error.message, "FETCH_MESSAGE_ERROR");
+      throw error instanceof ClientError
+        ? error
+        : new ClientError(error.message, "FETCH_MESSAGE_ERROR");
     }
   }
 
@@ -678,6 +759,7 @@ class Client extends EventEmitter {
   /**
    * Starts typing indicator in a channel
    * @param {string} channelId - Channel ID
+   * @returns {void}
    */
   startTyping(channelId) {
     try {
@@ -691,6 +773,7 @@ class Client extends EventEmitter {
   /**
    * Stops typing indicator in a channel
    * @param {string} channelId - Channel ID
+   * @returns {void}
    */
   stopTyping(channelId) {
     try {
@@ -708,7 +791,7 @@ class Client extends EventEmitter {
   /**
    * Fetches an emoji by ID
    * @param {string} id - Emoji ID
-   * @param {boolean} force - Force fetch from API instead of cache
+   * @param {boolean} [force=false] - Force fetch from API instead of cache
    * @returns {Promise<Emoji>} Emoji object
    */
   async fetchEmoji(id, force = false) {
@@ -731,13 +814,12 @@ class Client extends EventEmitter {
   /**
    * Fetches all available emojis
    * @param {Object} options - Fetch options
-   * @param {boolean} options.includeOthers - Include emojis from other users
    * @param {string} options.search - Search query
    * @returns {Promise<Emoji[]>} Array of emoji objects
    */
   async fetchAllEmojis(options = {}) {
     try {
-      const endpoint = options.includeOthers ? '/api/emojis/all' : '/api/emojis';
+      const endpoint = '/api/emojis/all';
       const params = {};
 
       if (options.search) {
@@ -745,7 +827,9 @@ class Client extends EventEmitter {
       }
 
       const res = await this._axios.get(endpoint, { params });
+
       const emojis = res.data.map(e => {
+        if (!e.user_id) e.user_id = this.user.id;
         const emoji = new Emoji(e);
         this.cache.emojis.set(emoji.id, emoji);
         return emoji;
@@ -753,14 +837,16 @@ class Client extends EventEmitter {
 
       return emojis;
     } catch (error) {
-      throw error instanceof ClientError ? error : new ClientError(error.message, "FETCH_EMOJIS_ERROR");
+      throw error instanceof ClientError
+        ? error
+        : new ClientError(error.message, "FETCH_EMOJIS_ERROR");
     }
   }
 
   /**
    * Fetches a sticker by ID
    * @param {string} id - Sticker ID
-   * @param {boolean} force - Force fetch from API instead of cache
+   * @param {boolean} [force=false] - Force fetch from API instead of cache
    * @returns {Promise<Object>} Sticker data
    */
   async fetchSticker(id, force = false) {
@@ -834,6 +920,7 @@ class Client extends EventEmitter {
 
   /**
    * Clears all cached data
+   * @returns {void}
    */
   clearCache() {
     this.cache.users.clear();
@@ -930,7 +1017,7 @@ class Client extends EventEmitter {
       });
 
       this.socket.on("reconnect_error", (error) => {
-        this.emit("reconnectError", error);
+        this.emit("error", error);
       });
 
       this.socket.on("reconnect_failed", () => {
@@ -968,6 +1055,9 @@ class Client extends EventEmitter {
   _setupSocketHandlers() {
     this._removeSocketHandlers();
 
+    /**
+     * @event Client#messageCreate
+     */
     this.socket.on('message:new', async (data) => {
       try {
         if (this._sentMessages.has(data.id)) {
@@ -983,31 +1073,49 @@ class Client extends EventEmitter {
       }
     });
 
+    /**
+     * @event Client#messageDelete
+     */
     this.socket.on('message:deleted', (data) => {
       const { messageId } = data;
       this._markMessageDeleted(messageId);
       this.emit('messageDelete', data);
     });
 
+    /**
+     * @event Client#messageEdit
+     */
     this.socket.on('message:edited', (data) => {
       const { messageId, content, editedAt } = data;
       this._updateMessageContent(messageId, content, editedAt);
       this.emit('messageEdit', data);
     });
 
+    /**
+     * @event Client#typingStart
+     */
     this.socket.on('typing:user-start', (data) => {
       this.emit('typingStart', data);
     });
 
+    /**
+     * @event Client#typingStop
+     */
     this.socket.on('typing:user-stop', (data) => {
       this.emit('typingStop', data);
     });
 
+    /**
+     * @event Client#userStatusUpdate
+     */
     this.socket.on('user:status-update', (data) => {
       this._updateUserStatus(data);
       this.emit('userStatusUpdate', data);
     });
 
+    /**
+     * @event Client#memberJoin
+     */
     this.socket.on('member:join', async (data) => {
       const member = await this.fetchUser(data.memberId).catch(() => null);
       const channel = this.cache.channels.get(data.channelId);
@@ -1017,6 +1125,9 @@ class Client extends EventEmitter {
       this.emit('memberJoin', { channel, member });
     });
 
+    /**
+     * @event Client#memberLeave
+     */
     this.socket.on('member:leave', async (data) => {
       const channel = this.cache.channels.get(data.channelId);
       const member = this.cache.users.get(data.memberId);
@@ -1032,16 +1143,25 @@ class Client extends EventEmitter {
       this.emit('memberLeave', { channel, member });
     });
 
+    /**
+     * @event Client#channelUpdate
+     */
     this.socket.on('channel:update', (data) => {
       this._updateChannel(data);
       this.emit('channelUpdate', data);
     });
 
+    /**
+     * @event Client#channelDelete
+     */
     this.socket.on('channel:delete', (data) => {
       this.cache.channels.delete(data.channelId);
       this.emit('channelDelete', data);
     });
 
+    /**
+     * @event Client#rateLimited
+     */
     this.socket.on('rate:limited', (data) => {
       this.emit('rateLimited', data);
     });
@@ -1183,12 +1303,21 @@ class Client extends EventEmitter {
     const msg = new Message(data, this);
 
     if (!msg.author && data.user_id) {
-      msg.author = new User({
-        id: data.user_id,
-        username: data.username,
-        display_name: data.display_name,
-        avatar_url: data.avatar_url
-      }, this);
+      const cachedUser = this.cache.users.get(data.user_id);
+      if (cachedUser) {
+        cachedUser.username = data.username || cachedUser.username;
+        cachedUser.displayName = data.display_name || cachedUser.displayName;
+        cachedUser.avatarUrl = formatUrl(data.avatar_url) || cachedUser.avatarUrl;
+        msg.author = cachedUser;
+      } else {
+        msg.author = new User({
+          id: data.user_id,
+          username: data.username,
+          display_name: data.display_name,
+          avatar_url: data.avatar_url,
+        }, this);
+        this.cache.users.set(msg.author.id, msg.author);
+      }
     }
 
     if (!msg.channel && data.channel_id) {
@@ -1387,8 +1516,51 @@ class Client extends EventEmitter {
       throw new ClientError(`File upload error: ${error.message}`, 'UPLOAD_FAILED');
     }
   }
+
+  // ============================================================================
+  // EVENT EMITTER OVERRIDES
+  // ============================================================================
+
+  /**
+   * Attaches an event listener.
+   * @superInternal
+   * @template {keyof ClientEvents} K
+   * @param {K} event The event name.
+   * @param {(arg: ClientEvents[K]) => void} listener
+   * @returns {this}
+   */
+  on(event, listener) {
+    return super.on(event, listener);
+  }
+
+  /**
+   * Emits an event with typed arguments.
+   * @internal
+   * @template {keyof ClientEvents} K
+   * @param {K} event
+   * @param {ClientEvents[K]} payload
+   * @returns {this}
+   */
+  emit(event, payload) {
+    return super.emit(event, payload);
+  }
+}
+
+/**
+ * @internal
+ */
+class ClientError extends Error {
+  /**
+   * @param {string} message - Error message
+   * @param {string} code - Error code
+  */
+  constructor(message, code) {
+    super(message);
+    this.name = 'ClientError';
+    this.code = code;
+  }
 }
 
 Client.MessageEmbed = MessageEmbed;
-Client.ClientError = ClientError;
+// Client.ClientError = ClientError;
 module.exports = Client;

package/README.md

@@ -1,29 +1,54 @@
-# Beniocord.js
+# Getting Started
 
-**Beniocord.js** is a Node.js library for creating bots easily, with basic moderation features, automatic responses, and event handling.
+## Introduction <span style="font-size:0.8em;">Intro</span>
 
-> ⚠️ This is an early version — meant to give you a starting point for building your bot.
+### Beniocord.js
+
+A powerful JavaScript library for building Beniocord bots with ease.
+
+[![npm version](https://img.shields.io/npm/v/beniocord.js?color=crimson&logo=npm&style=flat-square)](https://www.npmjs.com/package/beniocord.js)
+[![npm downloads](https://img.shields.io/npm/dt/beniocord.js?color=crimson&logo=npm&style=flat-square)](https://www.npmjs.com/package/beniocord.js)
+[![GitHub stars](https://img.shields.io/github/stars/Junior37534/beniocord.js?color=yellow&logo=github&style=flat-square)](https://github.com/Junior37534/beniocord.js)
+[![GitHub issues](https://img.shields.io/github/issues/Junior37534/beniocord.js?color=green&logo=github&style=flat-square)](https://github.com/Junior37534/beniocord.js/issues)
+[![Join Beniocord](https://img.shields.io/badge/Join-Beniocord-5865F2?style=flat-square&logoColor=white)](https://beniocord.site/register)
+
+---
+
+### About
+
+Beniocord.js is a powerful Node.js module that allows you to easily interact with the Beniocord API. It provides an intuitive and modern approach to bot development.
+
+### Features
+
+- 🚀 Easy to use and beginner-friendly
+- ⚡ Fast and efficient
+- 📦 Object-oriented design
+- 🔄 Promise-based architecture
+- 🎯 Full Beniocord API coverage
+- 💪 TypeScript support
+
+### Requirements
+
+- Node.js >= 18
+- NPM >= 9
 
 ---
 
 ## Installation
 
+Install via NPM:
+
 ```bash
 npm install beniocord.js
-```
-
-> Make sure you have Node.js >= 18 installed.
+````
 
 ---
 
-## Basic Example
+## Quick Example
 
 ```js
-const Client = require("beniocord.js");
-const { MessageEmbed } = Client;
-require('dotenv').config();
-
-const client = new Client({ token: process.env.BOT_TOKEN });
+const Beniocord = require("beniocord.js");
+const client = new Beniocord({ token: 'YOUR_BOT_TOKEN' });
 
 client.on("ready", () => {
   console.log("🤖 Bot connected!");
@@ -31,20 +56,21 @@ client.on("ready", () => {
 
 client.on("messageCreate", async (msg) => {
   if (msg.author?.id === client.user?.id) return;
-  if (!msg.content) return;
+  if (!msg.content.startsWith('!')) return;
 
-  if (msg.content.toLowerCase() === "!ping") {
-    await client.sendMessage(msg.channel.id, "🏓 Pong!");
-  }
-  
-  if (msg.content.toLowerCase() === "!embed") {
-    const embed = new MessageEmbed()
-      .setTitle("Hello from Beniocord!")
-      .setDescription("This is an example embed")
-      .setColor("#147bba")
-      .setFooter(msg.author.displayName, msg.author.avatarURL());
-    
-    await msg.reply(embed);
+  const comando = msg.content.slice('!'.length).split(' ')[0];
+  const args = msg.content.slice(comando.length + '!'.length + 1).trim().split(' ');
+
+  if (comando === "ping") {
+    const msgTimestamp = Date.now() - Date.parse(msg.createdAt);
+    const sent = await msg.channel.send("🏓 Pinging...");
+    const editTimestamp = Date.now() - Date.parse(sent.createdAt);
+
+    await sent.edit(
+        `🏓 **Pong!**\n` +
+        `📨 **Message → Bot:** ${msgTimestamp}ms\n` +
+        `✏️ **Send → Edit:** ${editTimestamp}ms`
+    );
   }
 });
 
@@ -53,24 +79,8 @@ client.login();
 
 ---
 
-## Features
-
-* **Basic events**: `messageCreate`, `messageEdit`, `messageDelete`, `memberJoin`, `memberLeave`, `presenceUpdate`, `channelUpdate`, and more.
-* **Basic moderation**: delete messages, edit messages, etc.
-* **Embeds support**: create rich messages with `MessageEmbed`.
-* **Event-driven**: easy to handle events in real-time.
-
----
-
-## Events
-
-```js
-client.on("messageCreate", msg => {...});
-client.on("memberJoin", data => {...});
-client.on("channelUpdate", data => {...});
-// and many more...
-```
-
-You can add custom events and interact with your bot in real-time.
+## Useful Links
 
----
+* [Official Website](https://beniocord.site)
+* [Documentation](https://docs.beniocord.site)
+* [Join Beniocord](https://beniocord.site/register)

package/package.json

@@ -5,7 +5,7 @@
     "socket.io-client": "^4.8.1"
   },
   "name": "beniocord.js",
-  "version": "2.0.9",
+  "version": "2.1.1",
   "description": "Uma biblioteca leve e intuitiva para integração com APIs de bots em plataformas de mensagens, como Discord. Facilita o envio de mensagens, gerenciamento de canais e interação com usuários, proporcionando uma experiência de desenvolvimento ágil e eficiente.",
   "main": "Client.js",
   "scripts": {