beniocord.js 2.1.2 → 2.1.4

package/Client.js

@@ -11,8 +11,8 @@ const Channel = require("./structures/Channel");
 const Emoji = require("./structures/Emoji");
 const Sticker = require("./structures/Sticker");
 
-const { MessageEmbed, MessageAttachment } = require("./structures/Util");
-const { formatUrl } = require("./helpers");
+const { MessageEmbed, MessageAttachment, MessageImageAttachment, MessageAudioAttachment, MessageVideoAttachment } = require("./structures/Util");
+const { formatUrl, stripDomain } = require("./helpers");
 
 let global = {
   token: "",
@@ -61,20 +61,23 @@ class Client extends EventEmitter {
    * @description The main class of BenioCord.js, responsible for managing API communication and bot events.
    * @param {Object} options - Client configuration options
    * @param {string} options.token - Bot token used for authentication
+   * @param {string} options.api_url - Override default API URL
    * @example
    * const Beniocord = require('beniocord.js');
    * const client = new Beniocord({ token: 'YOUR_BOT_TOKEN' });
    * client.login();
    */
-  constructor({ token }) {
+  constructor({ token, api_url } = {}) {
     super();
 
+    const API_URL = api_url ?? global.apiUrl;
+
     if (!token || typeof token !== 'string' || token.trim() === '') {
       throw new ClientError("Valid token is required", "INVALID_TOKEN");
     }
 
-    // Global configuration
     global.token = token.trim();
+    global.apiUrl = API_URL;
 
     // Client state
     this.socket = null;
@@ -86,9 +89,9 @@ class Client extends EventEmitter {
 
     // Configuration options
     this.config = {
-      connectionTimeout: 15000,
-      requestTimeout: 10000,
-      maxRetries: 3,
+      connectionTimeout: 999999,
+      requestTimeout: 999999,
+      maxRetries: 9999,
       reconnectionDelay: 1000,
     };
 
@@ -538,20 +541,16 @@ class Client extends EventEmitter {
 
         // Handle MessageAttachment as opts (backward compatibility)
         if (opts instanceof MessageAttachment) {
-          const uploadedFile = await this.uploadFile(opts);
-          if (uploadedFile) {
-            const mimetype = opts.name.split('.').pop().toLowerCase();
-            const detectedType = ['png', 'jpg', 'jpeg', 'gif', 'webp'].includes(mimetype)
-              ? 'image'
-              : 'file';
-            opts = {
-              fileUrl: uploadedFile.url,
-              fileName: uploadedFile.originalName,
-              fileSize: uploadedFile.size,
-              messageType: detectedType
-            };
-            messageType = detectedType;
-          }
+          const fileData = await this._handleFileUpload(opts.buffer, opts.name);
+          const detectedType = opts.type || fileData.detectedType;
+
+          opts = {
+            fileUrl: fileData.url,
+            fileName: fileData.originalName,
+            fileSize: fileData.size,
+            messageType: detectedType
+          };
+          messageType = detectedType;
         }
 
         // Handle file upload
@@ -638,6 +637,185 @@ class Client extends EventEmitter {
     });
   }
 
+  /**
+ * Sends a sticker to a channel.
+ * Prioriza o cache. Se não tiver, faz fetch.
+ * @param {string|number} channelId
+ * @param {string|number} stickerId
+ * @returns {Promise<Message>}
+ */
+  async sendSticker(channelId, stickerId) {
+    let sticker = this.cache.stickers.get(stickerId);
+
+    if (!sticker) {
+      sticker = await this.fetchSticker(stickerId);
+    }
+
+    if (!sticker) {
+      throw new ClientError(`Sticker ${stickerId} not found`, "INVALID_STICKER");
+    }
+
+    const stickerPath = sticker.url;
+    if (!stickerPath) {
+      throw new ClientError(`Sticker ${stickerId} is missing 'url'`, "INVALID_STICKER_PATH");
+    }
+
+    return this.sendMessage(channelId, "", {
+      messageType: "sticker",
+      stickerId,
+      url: stripDomain(stickerPath),
+    });
+  }
+
+  // ============================================================================
+  // PUBLIC API METHODS - File/Media Sending
+  // ============================================================================
+
+  /**
+   * Sends a file to a channel
+   * @param {string} channelId - Channel ID
+   * @param {Buffer|string} file - Buffer, base64 string, or file path
+   * @param {Object} options - Send options
+   * @param {string} options.fileName - File name (required for Buffer/base64)
+   * @param {string} options.content - Optional text content to send with the file
+   * @param {string} options.replyTo - Optional message ID to reply to
+   * @returns {Promise<Message>} Sent message object
+   * @example
+   * // Send from file path
+   * client.sendFile(channelId, './document.pdf');
+   * 
+   * // Send from buffer
+   * client.sendFile(channelId, buffer, { fileName: 'document.pdf' });
+   * 
+   * // Send with message
+   * client.sendFile(channelId, './photo.png', { content: 'Check this out!' });
+   */
+  async sendFile(channelId, file, options = {}) {
+    const { fileName, content = '', replyTo } = options;
+
+    try {
+      const fileData = await this._handleFileUpload(file, fileName);
+
+      return this.sendMessage(channelId, content, {
+        file: null, // Already uploaded
+        fileUrl: fileData.url,
+        fileName: fileData.originalName,
+        fileSize: fileData.size,
+        messageType: fileData.detectedType,
+        replyTo,
+      });
+    } catch (error) {
+      throw error instanceof ClientError ? error : new ClientError(error.message, "SEND_FILE_ERROR");
+    }
+  }
+
+  /**
+   * Sends an image to a channel
+   * @param {string} channelId - Channel ID
+   * @param {Buffer|string} image - Buffer, base64 string, or file path
+   * @param {Object} options - Send options
+   * @param {string} options.fileName - File name (required for Buffer/base64)
+   * @param {string} options.content - Optional text content to send with the image
+   * @param {string} options.replyTo - Optional message ID to reply to
+   * @returns {Promise<Message>} Sent message object
+   * @example
+   * // Send from file path
+   * client.sendImage(channelId, './photo.png');
+   * 
+   * // Send from buffer
+   * client.sendImage(channelId, imageBuffer, { fileName: 'screenshot.png' });
+   * 
+   * // Send from base64
+   * client.sendImage(channelId, 'data:image/png;base64,...');
+   */
+  async sendImage(channelId, image, options = {}) {
+    const { fileName, content = '', replyTo } = options;
+
+    try {
+      const fileData = await this._handleFileUpload(image, fileName);
+
+      return this.sendMessage(channelId, content, {
+        fileUrl: fileData.url,
+        fileName: fileData.originalName,
+        fileSize: fileData.size,
+        messageType: 'image',
+        replyTo,
+      });
+    } catch (error) {
+      throw error instanceof ClientError ? error : new ClientError(error.message, "SEND_IMAGE_ERROR");
+    }
+  }
+
+  /**
+   * Sends an audio file to a channel
+   * @param {string} channelId - Channel ID
+   * @param {Buffer|string} audio - Buffer, base64 string, or file path
+   * @param {Object} options - Send options
+   * @param {string} options.fileName - File name (required for Buffer/base64)
+   * @param {string} options.content - Optional text content to send with the audio
+   * @param {string} options.replyTo - Optional message ID to reply to
+   * @returns {Promise<Message>} Sent message object
+   * @example
+   * // Send from file path
+   * client.sendAudio(channelId, './song.mp3');
+   * 
+   * // Send from buffer (voice recording for example)
+   * client.sendAudio(channelId, audioBuffer, { fileName: 'voice_message.ogg' });
+   * 
+   * // Send with content
+   * client.sendAudio(channelId, './podcast.mp3', { content: 'New episode!' });
+   */
+  async sendAudio(channelId, audio, options = {}) {
+    const { fileName, content = '', replyTo } = options;
+
+    try {
+      const fileData = await this._handleFileUpload(audio, fileName);
+
+      return this.sendMessage(channelId, content, {
+        fileUrl: fileData.url,
+        fileName: fileData.originalName,
+        fileSize: fileData.size,
+        messageType: 'audio',
+        replyTo,
+      });
+    } catch (error) {
+      throw error instanceof ClientError ? error : new ClientError(error.message, "SEND_AUDIO_ERROR");
+    }
+  }
+
+  /**
+   * Sends a video to a channel
+   * @param {string} channelId - Channel ID
+   * @param {Buffer|string} video - Buffer, base64 string, or file path
+   * @param {Object} options - Send options
+   * @param {string} options.fileName - File name (required for Buffer/base64)
+   * @param {string} options.content - Optional text content to send with the video
+   * @param {string} options.replyTo - Optional message ID to reply to
+   * @returns {Promise<Message>} Sent message object
+   * @example
+   * // Send from file path
+   * client.sendVideo(channelId, './video.mp4');
+   * 
+   * // Send from buffer
+   * client.sendVideo(channelId, videoBuffer, { fileName: 'clip.mp4' });
+   */
+  async sendVideo(channelId, video, options = {}) {
+    const { fileName, content = '', replyTo } = options;
+
+    try {
+      const fileData = await this._handleFileUpload(video, fileName);
+
+      return this.sendMessage(channelId, content, {
+        fileUrl: fileData.url,
+        fileName: fileData.originalName,
+        fileSize: fileData.size,
+        messageType: 'video',
+        replyTo,
+      });
+    } catch (error) {
+      throw error instanceof ClientError ? error : new ClientError(error.message, "SEND_VIDEO_ERROR");
+    }
+  }
 
   /**
    * Deletes a message
@@ -682,7 +860,28 @@ class Client extends EventEmitter {
       }
 
       const res = await this._axios.get(`/api/channels/${channelId}/messages`, { params });
-      const messages = res.data.map(m => new Message(m, this));
+
+      const messages = res.data.map(raw => {
+        let userData = raw.user;
+        if (!userData && raw.user_id) {
+          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 };
+        const msg = new Message(messageData, this);
+        if (msg.author) this.cache.users.set(msg.author.id, msg.author);
+        return msg;
+      });
 
       if (!this.cache.messages.has(channelId)) {
         this.cache.messages.set(channelId, []);
@@ -695,6 +894,24 @@ class Client extends EventEmitter {
         }
       });
 
+      let channel = this.cache.channels.get(channelId);
+      if (!channel) {
+        const id = String(channelId);
+        for (const [key, val] of this.cache.channels) {
+          if (String(key) === id) {
+            channel = val;
+            break;
+          }
+        }
+      }
+
+      if (channel) {
+        messages.forEach(msg => {
+          if (!msg.channel) msg.channel = channel;
+          channel.messages.set(msg.id, msg);
+        });
+      }
+
       return messages;
     } catch (error) {
       throw error instanceof ClientError ? error : new ClientError(error.message, "FETCH_MESSAGES_ERROR");
@@ -900,30 +1117,6 @@ class Client extends EventEmitter {
     }
   }
 
-  // ============================================================================
-  // PUBLIC API METHODS - File Upload
-  // ============================================================================
-
-  /**
-   * Uploads a file to the server
-   * @param {MessageAttachment} file - File attachment to upload
-   * @returns {Promise<Object>} Upload response with file URL
-   */
-  async uploadFile(file) {
-    try {
-      const formData = new FormData();
-      formData.append('file', file.buffer, { filename: file.name });
-      const res = await this._axios.post('/api/upload', formData, {
-        headers: formData.getHeaders(),
-        timeout: 30000
-      });
-
-      return res.data;
-    } catch (error) {
-      throw error instanceof ClientError ? error : new ClientError(error.message, "UPLOAD_ERROR");
-    }
-  }
-
   // ============================================================================
   // PUBLIC API METHODS - Cache Management
   // ============================================================================
@@ -1351,7 +1544,7 @@ class Client extends EventEmitter {
       msg.channel = await this.fetchChannel(data.channel_id);
     }
 
-    if (msg.channel.memberCount !== msg.channel.members.size) {
+    if (msg.channel?.memberCount !== msg.channel?.members?.size) {
       await msg.channel.members.fetch();
     }
 
@@ -1498,6 +1691,16 @@ class Client extends EventEmitter {
           'image/webp': '.webp',
           'video/mp4': '.mp4',
           'video/webm': '.webm',
+          'audio/mpeg': '.mp3',
+          'audio/mp3': '.mp3',
+          'audio/wav': '.wav',
+          'audio/wave': '.wav',
+          'audio/ogg': '.ogg',
+          'audio/webm': '.weba',
+          'audio/aac': '.aac',
+          'audio/flac': '.flac',
+          'audio/m4a': '.m4a',
+          'audio/x-m4a': '.m4a',
         };
 
         const ext = mimeToExt[mimeType] || '.bin';
@@ -1524,11 +1727,14 @@ class Client extends EventEmitter {
     const ext = path.extname(finalFileName).toLowerCase();
     const imageExts = ['.jpg', '.jpeg', '.png', '.gif', '.webp', '.bmp', '.svg'];
     const videoExts = ['.mp4', '.avi', '.mov', '.wmv', '.flv', '.mkv', '.webm'];
+    const audioExts = ['.mp3', '.wav', '.ogg', '.flac', '.aac', '.m4a', '.weba', '.opus', '.wma'];
 
     if (imageExts.includes(ext)) {
       detectedType = 'image';
     } else if (videoExts.includes(ext)) {
       detectedType = 'video';
+    } else if (audioExts.includes(ext)) {
+      detectedType = 'audio';
     } else {
       detectedType = 'file';
     }
@@ -1580,6 +1786,8 @@ class Client extends EventEmitter {
   }
 }
 
+const { parseErrors } = require("./helpers");
+
 /**
  * @internal
  */
@@ -1589,12 +1797,19 @@ class ClientError extends Error {
    * @param {string} code - Error code
   */
   constructor(message, code) {
-    super(message);
+    const parsed = typeof parseErrors === 'function'
+      ? (code ? parseErrors(code) : parseErrors(message))
+      : null;
+    super(parsed || message);
     this.name = 'ClientError';
     this.code = code;
   }
 }
 
 Client.MessageEmbed = MessageEmbed;
+Client.MessageAttachment = MessageAttachment;
+Client.MessageImageAttachment = MessageImageAttachment;
+Client.MessageAudioAttachment = MessageAudioAttachment;
+Client.MessageVideoAttachment = MessageVideoAttachment;
 // Client.ClientError = ClientError;
 module.exports = Client;

package/README.md

@@ -10,7 +10,7 @@ A powerful JavaScript library for building Beniocord bots with ease.
 [![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)
+[![Join Beniocord](https://img.shields.io/badge/Join-Beniocord-5865F2?style=flat-square&logoColor=white)](https://beniocord.site/download)
 [![Better Stack Badge](https://uptime.betterstack.com/status-badges/v2/monitor/284m0.svg)](https://uptime.betterstack.com/?utm_source=status_badge)
 
 ---
@@ -19,21 +19,13 @@ A powerful JavaScript library for building Beniocord bots with ease.
 
 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
+- NPM >= 9 -->
 
----
+<!-- --- -->
 
 ## Installation
 
@@ -84,4 +76,5 @@ client.login();
 
 * [Official Website](https://beniocord.site)
 * [Documentation](https://docs.beniocord.site)
-* [Join Beniocord](https://beniocord.site/register)
+* [Join Beniocord](https://beniocord.site/download)
+* [Uptime monitor](https://uptime.beniocord.site)

package/helpers/index.js

@@ -1,8 +1,78 @@
+const errors = {
+    ALREADY_FRIENDS: "You are already friends with this user.",
+    ALREADY_SENT: "You have already sent a friend request to this user.",
+    USER_BLOCKED: "You cannot send a friend request to this user.",
+    USER_NOT_FOUND: "User not found.",
+    MEMBER_NOT_FOUND: "Member not found.",
+    CHANNEL_NOT_FOUND: "Could not find a channel with this ID.",
+    MESSAGE_NOT_FOUND: "Message not found.",
+    FRIENDSHIP_NOT_FOUND: "Friendship not found.",
+    ID_OR_USERNAME_REQUIRED: "User ID or username is required.",
+    BOTS_CANT_BE_FRIEND: "Cannot send friend request to bots.",
+    CANT_BE_FRIENDS_WITH_YOURSELF: "You cannot add yourself as a friend.",
+    ACCESS_DENIED_CH: "Access denied to this channel.",
+    NOT_CH_MEMBER: "You are not a member of this channel.",
+    CAN_ONLY_INVITE_FRIEND: "You can only invite users who are your friends.",
+    USER_ALREADY_IN_CHANNEL: "User is already a member of the channel.",
+    USER_ADD_SUCCESS: "User added to channel successfully.",
+    NO_INVITE_PERMISSION: "You do not have permission to invite users.",
+    NO_MANAGE_PERMISSION: "You do not have permission to manage members.",
+    NO_REMOVE_PERMISSION: "You do not have permission to remove members.",
+    NO_READ_PERMISSION: "You do not have permission to read messages in this channel.",
+    CH_OR_MSG_ID_INVALID: "Invalid channelId or messageId.",
+    CH_OR_MSG_ID_MUST_BE_INTEGER: "channelId or messageId must be integers.",
+    CH_OR_MSG_ID_OUT_OF_RANGE: "channelId or messageId out of valid range.",
+    ONLY_OWNER_CAN_WTF: "Only the owner can modify another owner.",
+    NO_FIELDS_TO_UPDATE: "No fields to update.",
+    NO_FILES_UPLOADED: "No file uploaded.",
+    INVALID_STATUS: "Invalid status.",
+    ERR_CHANNEL_NAME_EMPTY: "Channel name cannot be empty.",
+    ERR_CHANNEL_NAME_TOO_LONG: "Channel name is too long.",
+    ERR_CHANNEL_NAME_INVALID_CHARS: "Channel name contains invalid characters.",
+    ERR_CHANNEL_DESCRIPTION_EMPTY: "Channel description cannot be empty.",
+    ERR_CHANNEL_DESCRIPTION_TOO_LONG: "Channel description is too long.",
+    ERR_CHANNEL_DESCRIPTION_INVALID_CHARS: "Channel description contains invalid characters.",
+    ERR_PASSWORD_TOO_SHORT: "Password must be at least 8 characters.",
+    ERR_PASSWORD_TOO_LONG: "Password cannot be more than 128 characters.",
+    ERR_PASSWORD_MISMATCH: "Passwords do not match.",
+    ERR_PASSWORD_SAME_AS_CURRENT: "New password cannot be the same as the current one.",
+    ERR_EMAIL_INVALID: "Please enter a valid email address.",
+    ERR_EMAIL_SAME_AS_CURRENT: "New email cannot be the same as the current one.",
+    ERR_PASSWORD_EMPTY: "Password is required.",
+    ERR_DISPLAY_NAME_EMPTY: "Display name is required.",
+    ERR_USERNAME_TOO_SHORT: "Username must be at least 3 characters.",
+    ERR_USERNAME_INVALID_CHARS: "Username can only contain lowercase letters, numbers, and underscores.",
+    INTERNAL_SERVER_ERROR: "Something went wrong. Please contact support.",
+    ERR_USERNAME_EMPTY: "Username cannot be empty.",
+    ERR_USERNAME_TOO_LONG: "Username is too long.",
+    ERR_DISPLAY_NAME_TOO_LONG: "Display name is too long.",
+    ERR_DISPLAY_NAME_INVALID_CHARS: "Display name contains invalid characters.",
+    ERR_EMAIL_EMPTY: "Email cannot be empty.",
+    ERR_EMAIL_TOO_LONG: "Email is too long.",
+    ERR_INVALID_CREDENTIALS: "Invalid credentials.",
+    ERR_PASSWORD_INCORRECT: "Incorrect password.",
+    ERR_STATUS_INVALID: "Invalid status.",
+    ERR_URL_TOO_LONG: "URL is too long.",
+    ERR_URL_INVALID: "URL is invalid.",
+    FILE_TOO_LARGE: "This file is too large.",
+};
+
 function formatUrl(url) {
     const base = 'https://api.beniocord.site';
     if (!url) return null;
     if (url.startsWith(base) || url.startsWith('http')) return url;
     return base + (url.startsWith('/') ? url : '/' + url);
 }
+function stripDomain(url) {
+    try {
+        const u = new URL(url);
+        return u.pathname;
+    } catch {
+        return url;
+    }
+};
+function parseErrors(message) {
+    return errors[message] || message;
+}
 
-module.exports = { formatUrl }
+module.exports = { formatUrl, stripDomain, parseErrors }

package/package.json

@@ -5,7 +5,7 @@
     "socket.io-client": "^4.8.1"
   },
   "name": "beniocord.js",
-  "version": "2.1.2",
+  "version": "2.1.4",
   "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": {

package/structures/Channel.js

@@ -73,7 +73,7 @@ class Channel {
 
     /**
      * Cached messages of the channel.
-     * @type {Collection<string, import('./Message')>}
+     * @type {Collection<string, Message>}
      */
     this.messages = new Collection();
     this.messages.fetch = async (id) => {
@@ -96,7 +96,7 @@ class Channel {
    * Sends a message to the channel.
    * @param {string|Object} content - The content of the message.
    * @param {Object} [opts] - Optional message options.
-   * @returns {Promise<import('./Message')>} The sent message.
+   * @returns {Promise<Message>} The sent message.
    */
   async send(content, opts = {}) {
     return client.sendMessage(this.id, content, opts);

package/structures/Emoji.js

@@ -5,54 +5,78 @@ const { formatUrl } = require("../helpers");
  */
 class Emoji {
     /**
-     * Creates a new Emoji instance.
-     * @param {Object} data - Raw emoji data.
-     * @param {string|number} data.id - The unique ID of the emoji.
-     * @param {string|number} data.user_id - The ID of the user who uploaded the emoji.
-     * @param {string} data.name - The name of the emoji.
-     * @param {string} data.url - The URL of the emoji image.
-     * @param {string|number|Date} data.created_at - Timestamp when the emoji was created.
-     * @returns {Emoji} The created Emoji instance.
-     * @example 
+     * Cria uma nova instância de Emoji.
+     * @param {Object} data - Dados crus do emoji vindos da API.
+     * @param {number} data.id - ID único do emoji.
+     * @param {number} data.owner_id - ID do dono do emoji.
+     * @param {string} data.name - Nome do emoji.
+     * @param {string} data.url - URL da imagem do emoji.
+     * @param {string} data.created_at - Data de criação do emoji.
+     * @param {boolean} data.can_use - Se o emoji pode ser usado.
+     * @param {string} data.username - Username do dono.
+     * @param {string} data.display_name - Nome de exibição do dono.
+     * @returns {Emoji} Instância criada de Emoji.
+     * @example
      * Emoji {
      *   id: 1,
-     *   userId: 1,
+     *   ownerId: 1,
      *   name: 'shitcord',
      *   url: 'https://api.beniocord.site/uploads/emojis/1758982533925-364594757.png',
-     *   createdAt: '2025-09-27T14:15:33.932Z'
+     *   createdAt: '2025-09-27T14:15:33.932Z',
+     *   canUse: true,
+     *   username: 'benio',
+     *   displayName: 'Benio'
      * }
-     * 
      */
     constructor(data) {
         /**
-         * The unique ID of the emoji.
-         * @type {string|number}
+         * ID único do emoji.
+         * @type {number}
          */
         this.id = data.id;
 
         /**
-         * The ID of the user who uploaded the emoji.
-         * @type {string|number}
+         * ID do dono do emoji.
+         * @type {number}
          */
-        this.userId = data.user_id;
+        this.ownerId = data.owner_id;
 
         /**
-         * The name of the emoji.
+         * Nome do emoji.
          * @type {string}
          */
         this.name = data.name;
 
         /**
-         * The URL of the emoji image.
+         * URL formatada da imagem do emoji.
          * @type {string}
          */
         this.url = formatUrl(data.url);
 
         /**
-         * Timestamp when the emoji was created.
-         * @type {string|number|Date}
+         * Data de criação do emoji.
+         * @type {string}
          */
         this.createdAt = data.created_at;
+
+
+        /**
+         * Se o emoji pode ser usado.
+         * @type {boolean}
+         */
+        this.canUse = data.can_use;
+
+        /**
+         * Username do dono do emoji.
+         * @type {string}
+         */
+        this.username = data.username;
+
+        /**
+         * Nome de exibição do dono do emoji.
+         * @type {string}
+         */
+        this.displayName = data.display_name;
     }
 }
 

package/structures/Message.js

@@ -11,88 +11,82 @@ class Message {
   /**
    * Creates a new Message instance.
    * @param {Object} data - Raw message data.
-   * @param {string|number} data.id - The unique ID of the message.
+   * @param {number} data.id - The unique ID of the message.
+   * @param {number} data.channel_id - The channel ID where the message was sent.
+   * @param {number} data.user_id - The user ID of the author.
    * @param {string} data.content - The content of the message.
-   * @param {string} [data.message_type="text"] - The type of the message (text, file, etc.).
-   * @param {string} [data.file_url] - URL of the attached file.
-   * @param {string} [data.file_name] - Name of the attached file.
-   * @param {number} [data.file_size] - Size of the attached file in bytes.
-   * @param {Object} [data.user] - Author user data.
-   * @param {Object} [data.channel] - Channel data where the message was sent.
-   * @param {string|number} [data.reply_to] - ID of the message this is replying to.
-   * @param {Object} [data.sticker] - Sticker object attached to the message.
-   * @param {string|number|Date} [data.edited_at] - Timestamp when the message was edited.
-   * @param {string|number|Date} [data.created_at] - Timestamp when the message was created.
+   * @param {"text"|"image"|"video"|"audio"|"file"|"sticker"|"embed"} data.message_type - The type of the message.
+   * @param {string|null} data.file_url - URL of the attached file.
+   * @param {string|null} data.file_name - Name of the attached file.
+   * @param {number|null} data.file_size - Size of the attached file in bytes.
+   * @param {number|null} data.reply_to - ID of the message this is replying to.
+   * @param {string} [data.reply_content] - Content of the replied message.
+   * @param {string|null} [data.reply_message_type] - Type of the replied message.
+   * @param {string} [data.reply_username] - Username of the replied user.
+   * @param {string|null} [data.reply_display_name] - Display name of the replied user.
+   * @param {string|null} [data.reply_avatar_url] - Avatar URL of the replied user.
+   * @param {string|null} [data.reply_user_id] - User ID of the replied user.
+   * @param {string|null} data.edited_at - Timestamp when the message was edited.
+   * @param {string} data.created_at - Timestamp when the message was created.
+   * @param {number|null} [data.sticker_id] - Sticker ID attached to the message.
+   * @param {string|null} [data.embed_data] - Embed data if present.
    * @param {Object} clientInstance - The client instance.
    * @returns {Message} The created Message instance.
    * @example
    * Message {
-   *   id: 20711,
-   *   content: 'Hello World!',
-   *   messageType: 'text',
-   *   fileUrl: null,
-   *   fileName: null,
+   *   id: 1875,
+   *   channelId: 4,
+   *   userId: 1,
+   *   content: 'Sticker: crazy',
+   *   messageType: 'sticker',
+   *   fileUrl: 'https://api.beniocord.site/uploads/stickers/1765027757156-305382752.png',
+   *   fileName: 'crazy.png',
    *   fileSize: null,
-   *   attachments: [],
-   *   replyTo: 20709,
    *   editedAt: null,
-   *   createdAt: '2025-11-16T14:29:40.598Z',
-   *   sticker: {
-   *     id: 1,
-   *     name: 'carrin',
-   *     url: '/uploads/stickers/1758986081574-510376341.gif',
-   *     tags: [],
-   *     user_id: 2,
-   *     owner: 'kkauabr'
+   *   createdAt: '2025-12-20T20:54:46.247Z',
+   *   stickerId: 3,
+   *   embedData: null,
+   *   replyToId: 1874,
+   *   replyMessage: {
+   *     content: 'Hello world',
+   *     username: 'juniorcanary',
+   *     displayName: 'Junior canary',
+   *     avatarUrl: 'https://api.beniocord.site/uploads/avatars/1764896784903-442484585.png',
+   *     messageType: 'text',
+   *     userId: 1
    *   },
-   *   author: User {
-   *     id: 1,
-   *     username: 'junior9244',
-   *     displayName: 'Junior',
-   *     avatarUrl: 'https://api.beniocord.site/uploads/avatars/1760736025811-629632107.png',
-   *     status: 'online',
-   *     emblems: [],
-   *     isBot: false,
-   *     lastSeen: '2025-11-16T14:29:40.598Z',
-   *     createdAt: '2025-11-16T14:29:40.598Z'
-   *   },
-   *   channel: Channel {
-   *     id: 2,
-   *     name: 'Privado',
-   *     description: 'DM Privada para conversar secretas!\n',
-   *     type: 'text',
-   *     iconUrl: 'https://api.beniocord.site/uploads/1762899895145-938680330.gif',
-   *     ownerId: 1,
-   *     isPrivate: true,
-   *     isLocked: false,
-   *     memberCount: 8,
-   *     createdAt: '2025-09-21T15:28:43.610Z',
-   *     updatedAt: '2025-11-11T23:49:54.906Z',
-   *     members: Collection(0) [Map] { fetch: [AsyncFunction (anonymous)] },
-   *     messages: Collection(0) [Map] { fetch: [AsyncFunction (anonymous)] }
-   *   }
+   *   author: User {...},
+   *   channel: Channel {...},
+   *   sticker: Sticker {...}
    * }
    */
   constructor(data, clientInstance) {
     this.id = data.id;
+    this.channelId = data.channel_id;
+    this.userId = data.user_id;
     this.content = data.content;
-    this.messageType = data.message_type || "text";
-    this.fileUrl = formatUrl(data.file_url);
-    this.fileName = data.file_name;
-    this.fileSize = data.file_size;
-    this.attachments = [];
-    this.replyTo = data.reply_to;
-    this.editedAt = data.edited_at;
+    this.messageType = data.message_type;
+    this.fileUrl = data.file_url ? formatUrl(data.file_url) : null;
+    this.fileName = data.file_name ?? null;
+    this.fileSize = data.file_size ?? null;
+    this.editedAt = data.edited_at ?? null;
     this.createdAt = data.created_at;
-
-    this.sticker = null;
-
-    if (data.file_url) {
-      this.attachments.push({
-        url: this.fileUrl,
-        name: this.fileName,
-        size: this.fileSize,
-      });
+    this.stickerId = data.sticker_id ?? null;
+    this.embedData = data.embed_data ?? null;
+    // Reply fields
+    if (data.reply_to != null) {
+      this.replyToId = data.reply_to;
+      this.replyMessage = {
+        content: data.reply_content ?? '',
+        username: data.reply_username ?? '',
+        displayName: data.reply_display_name ?? null,
+        avatarUrl: data.reply_avatar_url ? formatUrl(data.reply_avatar_url) : null,
+        messageType: data.reply_message_type ?? '',
+        userId: data.reply_user_id ?? ''
+      };
+    } else {
+      this.replyToId = null;
+      this.replyMessage = null;
     }
 
     this.author = data.user ? new User(data.user, clientInstance) : null;

package/structures/Sticker.js

@@ -5,70 +5,93 @@ const { formatUrl } = require("../helpers");
  */
 class Sticker {
   /**
-   * Creates a new Sticker instance.
-   * @param {Object} data - Raw sticker data.
-   * @param {string|number} data.id - The unique ID of the sticker.
-   * @param {string|number} data.user_id - The ID of the user who uploaded the sticker.
-   * @param {string} data.name - The name of the sticker.
-   * @param {string} data.url - The URL of the sticker image.
-   * @param {string[]|null} data.tags - Array of tags associated with the sticker.
-   * @param {string|number|Date} data.created_at - Timestamp when the sticker was created.
-   * @param {string|number|Date} data.updated_at - Timestamp when the sticker was last updated.
-   * @returns {Sticker} The created Sticker instance.
-   * 
+   * Cria uma nova instância de Sticker.
+   * @param {Object} data - Dados crus do sticker vindos da API.
+   * @param {number} data.id - ID único do sticker.
+   * @param {number} data.owner_id - ID do dono do sticker.
+   * @param {string} data.name - Nome do sticker.
+   * @param {string} data.url - URL da imagem do sticker.
+   * @param {string|string[]} data.tags - Tags associadas ao sticker.
+   * @param {string} data.created_at - Data de criação do sticker.
+   * @param {boolean} data.can_use - Se o sticker pode ser usado.
+   * @param {string} data.username - Username do dono.
+   * @param {string} data.display_name - Nome de exibição do dono.
+   * @returns {Sticker} Instância criada de Sticker.
+   *
    * @example
    * Sticker {
-   *   id: 2,
-   *   userId: 1,
-   *   name: 'saboroso',
-   *   url: 'https://api.beniocord.site/uploads/stickers/1758986145335-603013635.png',
-   *   tags: [ 'sabor', 'delicia', 'gostoso' ],
-   *   createdAt: '2025-09-27T15:15:45.555Z',
-   *   updatedAt: '2025-09-27T15:15:45.555Z'
+   *   id: 4,
+   *   ownerId: 7,
+   *   name: 'osuhow',
+   *   tags: [],
+   *   url: 'https://api.beniocord.site/uploads/stickers/1766100944970-73288347.png',
+   *   createdAt: '2025-12-18T23:35:44.985Z',
+   *   canUse: false,
+   *   username: 'joneor',
+   *   displayName: 'Juner'
    * }
    */
   constructor(data) {
     /**
-     * The unique ID of the sticker.
-     * @type {string|number}
+     * ID único do sticker.
+     * @type {number}
      */
     this.id = data.id;
 
     /**
-     * The ID of the user who uploaded the sticker.
-     * @type {string|number}
+     * ID do dono do sticker.
+     * @type {number}
      */
-    this.userId = data.user_id;
+    this.ownerId = data.owner_id;
 
     /**
-     * The name of the sticker.
+     * Nome do sticker.
      * @type {string}
      */
     this.name = data.name;
 
     /**
-     * Array of tags for the sticker.
+     * Tags associadas ao sticker.
      * @type {string[]}
      */
-    this.tags = Array.isArray(data.tags) ? data.tags : [];
+    if (Array.isArray(data.tags)) {
+      this.tags = data.tags;
+    } else if (typeof data.tags === 'string' && data.tags.length > 0) {
+      this.tags = data.tags.split(',').map(t => t.trim()).filter(Boolean);
+    } else {
+      this.tags = [];
+    }
 
     /**
-     * The formatted URL of the sticker image.
+     * URL formatada da imagem do sticker.
      * @type {string}
      */
     this.url = formatUrl(data.url);
 
     /**
-     * Timestamp when the sticker was created.
-     * @type {string|number|Date}
+     * Data de criação do sticker.
+     * @type {string}
      */
     this.createdAt = data.created_at;
 
+
+    /**
+     * Se o sticker pode ser usado.
+     * @type {boolean}
+     */
+    this.canUse = data.can_use;
+
     /**
-     * Timestamp when the sticker was last updated.
-     * @type {string|number|Date}
+     * Username do dono do sticker.
+     * @type {string}
+     */
+    this.username = data.username;
+
+    /**
+     * Nome de exibição do dono do sticker.
+     * @type {string}
      */
-    this.updatedAt = data.updated_at;
+    this.displayName = data.display_name;
   }
 }
 

package/structures/User.js

@@ -12,6 +12,7 @@ class User {
    * @param {string} data.username - The username of the user.
    * @param {string} data.display_name - The display name of the user.
    * @param {string} data.avatar_url - The URL of the user's avatar.
+   * @param {string|null} [data.banner_url] - The URL of the user's banner (optional).
    * @param {string} [data.status='offline'] - The user's status.
    * @param {Array<Object>} [data.emblems=[]] - Array of user emblems.
    * @param {boolean} data.is_bot - Whether the user is a bot.
@@ -25,6 +26,7 @@ class User {
    *   username: 'junior9244',
    *   displayName: 'Junior',
    *   avatarUrl: 'https://api.beniocord.site/uploads/avatars/1760736025811-629632107.png',
+   *   bannerUrl: 'https://api.beniocord.site/uploads/banners/1760736025811-629632107.png',
    *   status: 'online',
    *   emblems: [ [Object], [Object] ],
    *   isBot: false,
@@ -39,11 +41,16 @@ class User {
     this.username = data.username;
     this.displayName = data.display_name;
     this.avatarUrl = formatUrl(data.avatar_url);
+    /**
+     * The URL of the user's banner (or null if not set).
+     * @type {string|null}
+     */
+    this.bannerUrl = data.banner_url ? formatUrl(data.banner_url) : null;
     this.status = data.status || "offline";
     this.emblems = data.emblems || [];
-    this.isBot = data.is_bot;
-    this.lastSeen = data.last_seen;
-    this.createdAt = data.created_at;
+    this.isBot = typeof data.is_bot !== 'undefined' ? data.is_bot : null;
+    this.lastSeen = typeof data.last_seen !== 'undefined' ? data.last_seen : null;
+    this.createdAt = typeof data.created_at !== 'undefined' ? data.created_at : null;
   }
 
   /**

package/structures/Util.js

@@ -586,7 +586,89 @@ class MessageAttachment {
         }
         this.buffer = buffer;
         this.name = name;
+        this.type = this._detectType();
+    }
+
+    /**
+     * Detects the file type based on extension
+     * @private
+     * @returns {string} The detected type
+     */
+    _detectType() {
+        const ext = this.name.split('.').pop().toLowerCase();
+
+        const imageExts = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'bmp', 'svg'];
+        const videoExts = ['mp4', 'avi', 'mov', 'wmv', 'flv', 'mkv', 'webm'];
+        const audioExts = ['mp3', 'wav', 'ogg', 'flac', 'aac', 'm4a', 'weba', 'opus', 'wma'];
+
+        if (imageExts.includes(ext)) return 'image';
+        if (videoExts.includes(ext)) return 'video';
+        if (audioExts.includes(ext)) return 'audio';
+        return 'file';
+    }
+}
+
+/**
+ * @class
+ */
+class MessageImageAttachment extends MessageAttachment {
+    /**
+     * Creates a new MessageImageAttachment instance.
+     *
+     * @param {Buffer|Uint8Array|string} buffer - The image data.
+     * @param {string} name - The name of the image file (e.g., "screenshot.png").
+     *
+     * @example
+     * const image = new MessageImageAttachment(imageBuffer, "screenshot.png");
+     */
+    constructor(buffer, name) {
+        super(buffer, name);
+        this.type = 'image';
+    }
+}
+
+/**
+ * @class
+ */
+class MessageAudioAttachment extends MessageAttachment {
+    /**
+     * Creates a new MessageAudioAttachment instance.
+     *
+     * @param {Buffer|Uint8Array|string} buffer - The audio data.
+     * @param {string} name - The name of the audio file (e.g., "voice_message.mp3").
+     *
+     * @example
+     * const audio = new MessageAudioAttachment(audioBuffer, "song.mp3");
+     */
+    constructor(buffer, name) {
+        super(buffer, name);
+        this.type = 'audio';
+    }
+}
+
+/**
+ * @class
+ */
+class MessageVideoAttachment extends MessageAttachment {
+    /**
+     * Creates a new MessageVideoAttachment instance.
+     *
+     * @param {Buffer|Uint8Array|string} buffer - The video data.
+     * @param {string} name - The name of the video file (e.g., "video.mp4").
+     *
+     * @example
+     * const video = new MessageVideoAttachment(videoBuffer, "clip.mp4");
+     */
+    constructor(buffer, name) {
+        super(buffer, name);
+        this.type = 'video';
     }
 }
 
-module.exports = { MessageEmbed, MessageAttachment };
+module.exports = {
+    MessageEmbed,
+    MessageAttachment,
+    MessageImageAttachment,
+    MessageAudioAttachment,
+    MessageVideoAttachment
+};