beniocord.js 2.1.1 → 2.1.3

package/Client.js

@@ -9,8 +9,10 @@ const Message = require("./structures/Message");
 const User = require("./structures/User");
 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 { formatUrl, stripDomain } = require("./helpers");
 
 let global = {
   token: "",
@@ -57,22 +59,25 @@ class Client extends EventEmitter {
    * @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
+   * @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;
@@ -84,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,
     };
 
@@ -616,31 +621,57 @@ class Client extends EventEmitter {
    * Edits a message
    * @param {string} messageId - Message ID
    * @param {string} newContent - New message content
-   * @returns {Promise<Object>} Response data
+   * @returns {Promise<Message>} Response data
    */
   async editMessage(messageId, newContent) {
     return new Promise((resolve, reject) => {
-      try {
-        this._ensureConnected();
-      } catch (error) {
-        return reject(error);
-      }
-
       this.socket.emit(
         'message:edit',
         { messageId, content: newContent },
-        (response) => {
+        async (response) => {
           if (response && response.error) {
             reject(new ClientError(response.error, "EDIT_ERROR"));
           } else {
             this._updateMessageContent(messageId, newContent, new Date().toISOString());
-            resolve(response);
+            const msg = await this._processSocketMessage(response); // transforma response em Message
+            resolve(msg);
           }
         }
       );
     });
   }
 
+  /**
+ * 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),
+    });
+  }
+
+
   /**
    * Deletes a message
    * @param {string} messageId - Message ID
@@ -727,11 +758,7 @@ class Client extends EventEmitter {
         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 ---
@@ -744,6 +771,21 @@ class Client extends EventEmitter {
         message.channel = channel;
       }
 
+      // --- STICKER ---
+      if (!message.sticker && raw.sticker_id) {
+        let sticker = this.cache.stickers.get(raw.sticker_id);
+
+        if (!sticker) {
+          try {
+            sticker = await this.fetchSticker(raw.sticker_id);
+          } catch (_) {
+            sticker = null;
+          }
+        }
+
+        message.sticker = sticker;
+      }
+
       return message;
     } catch (error) {
       throw error instanceof ClientError
@@ -856,8 +898,9 @@ class Client extends EventEmitter {
 
     try {
       const res = await this._axios.get(`/api/stickers/${id}`);
-      this.cache.stickers.set(res.data.id, res.data);
-      return res.data;
+      const sticker = new Sticker(res.data);
+      this.cache.stickers.set(sticker.id, sticker);
+      return sticker;
     } catch (error) {
       throw error instanceof ClientError
         ? error
@@ -1085,10 +1128,27 @@ class Client extends EventEmitter {
     /**
      * @event Client#messageEdit
      */
-    this.socket.on('message:edited', (data) => {
-      const { messageId, content, editedAt } = data;
-      this._updateMessageContent(messageId, content, editedAt);
-      this.emit('messageEdit', data);
+    this.socket.on('message:edited', async (data) => {
+      const { messageId: id, content, editedAt } = data;
+
+      let msg;
+      for (const [channelId, messages] of this.cache.channels) {
+        const channel = messages;
+        if (channel.messages.has(id)) {
+          msg = channel.messages.get(id);
+          msg.content = content;
+          msg.editedAt = editedAt;
+          msg.edited = true;
+          break;
+        }
+      }
+
+      if (!msg) {
+        msg = await this._processSocketMessage(data);
+        this._cacheMessage(msg);
+      }
+
+      this.emit('messageEdit', msg);
     });
 
     /**
@@ -1324,10 +1384,19 @@ 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();
     }
 
+    if (!msg.sticker && data.sticker_id) {
+      let sticker = this.cache.stickers.get(data.sticker_id);
+
+      if (!sticker) {
+        sticker = await this.fetchSticker(data.sticker_id).catch(() => null);
+      }
+
+      msg.sticker = sticker;
+    }
     return msg;
   }
 
@@ -1344,10 +1413,8 @@ class Client extends EventEmitter {
       const channel = msg.channel;
       this._ensureCached(this.cache.channels, channel.id, channel);
 
-      // guarda a mensagem no canal
       channel.messages.set(msg.id, msg);
 
-      // limita a 50 mensagens
       if (channel.messages.size > 50) {
         const firstKey = channel.messages.firstKey(); // método do Collection
         channel.messages.delete(firstKey);
@@ -1546,6 +1613,8 @@ class Client extends EventEmitter {
   }
 }
 
+const { parseErrors } = require("./helpers");
+
 /**
  * @internal
  */
@@ -1555,7 +1624,10 @@ 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;
   }

package/README.md

@@ -10,7 +10,8 @@ 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)
 
 ---
 
@@ -18,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
 
@@ -83,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.1",
+  "version": "2.1.3",
   "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,80 +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 {string|number} [data.sticker_id] - ID of a sticker 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,
-   *   stickerId: null,
    *   editedAt: null,
-   *   createdAt: '2025-11-16T14:29:40.598Z',
-   *   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'
+   *   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
    *   },
-   *   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.stickerId = data.sticker_id;
-    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;
-
-    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

@@ -0,0 +1,98 @@
+const { formatUrl } = require("../helpers");
+
+/**
+ * @internal
+ */
+class Sticker {
+  /**
+   * 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: 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) {
+    /**
+     * ID único do sticker.
+     * @type {number}
+     */
+    this.id = data.id;
+
+    /**
+     * ID do dono do sticker.
+     * @type {number}
+     */
+    this.ownerId = data.owner_id;
+
+    /**
+     * Nome do sticker.
+     * @type {string}
+     */
+    this.name = data.name;
+
+    /**
+     * Tags associadas ao sticker.
+     * @type {string[]}
+     */
+    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 = [];
+    }
+
+    /**
+     * URL formatada da imagem do sticker.
+     * @type {string}
+     */
+    this.url = formatUrl(data.url);
+
+    /**
+     * 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;
+
+    /**
+     * Username do dono do sticker.
+     * @type {string}
+     */
+    this.username = data.username;
+
+    /**
+     * Nome de exibição do dono do sticker.
+     * @type {string}
+     */
+    this.displayName = data.display_name;
+  }
+}
+
+module.exports = Sticker;

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;
   }
 
   /**