beniocord.js 2.1.2 → 2.1.3

package/Client.js

@@ -12,7 +12,7 @@ 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: "",
@@ -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,
     };
 
@@ -638,6 +641,36 @@ 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),
+    });
+  }
+
 
   /**
    * Deletes a message
@@ -1351,7 +1384,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();
     }
 
@@ -1580,6 +1613,8 @@ class Client extends EventEmitter {
   }
 }
 
+const { parseErrors } = require("./helpers");
+
 /**
  * @internal
  */
@@ -1589,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,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.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,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;
   }
 
   /**