beniocord.js 2.0.4 → 2.0.5

package/Client.js

@@ -194,11 +194,13 @@ class Client extends EventEmitter {
         this.isConnected = true;
         this.retryCount = 0;
         this._setupSocketHandlers();
+        this._startHeartbeat(); // Inicia o heartbeat
         resolve();
       });
 
       this.socket.on("disconnect", (reason) => {
         this.isConnected = false;
+        this._stopHeartbeat(); // Para o heartbeat
         this.emit("disconnect", reason);
 
         if (reason === "io server disconnect") {
@@ -239,6 +241,7 @@ class Client extends EventEmitter {
 
       this.socket.on("reconnect", (attemptNumber) => {
         this.isConnected = true;
+        this._startHeartbeat(); // Reinicia o heartbeat após reconexão
         this.emit("reconnect", attemptNumber);
       });
 
@@ -247,6 +250,7 @@ class Client extends EventEmitter {
       });
 
       this.socket.on("reconnect_failed", () => {
+        this._stopHeartbeat();
         this.emit("error", new ClientError(
           "Failed to reconnect after maximum attempts",
           "RECONNECT_FAILED"
@@ -255,6 +259,88 @@ class Client extends EventEmitter {
     });
   }
 
+  /**
+   * Inicia o sistema de heartbeat
+   * @private
+   */
+  _startHeartbeat() {
+    // Para qualquer heartbeat existente
+    this._stopHeartbeat();
+
+    // Intervalo de 30 segundos (mesmo do frontend)
+    const HEARTBEAT_INTERVAL = 30000;
+
+    this.heartbeatInterval = setInterval(() => {
+      if (this.socket && this.isConnected) {
+        // Envia heartbeat simples para bots
+        // Bots não precisam de isPageVisible/isAppFocused
+        this.socket.emit("presence:heartbeat", {
+          status: this.status || "online",
+          clientType: "bot" // Identifica como bot
+        });
+      }
+    }, HEARTBEAT_INTERVAL);
+
+    // Envia primeiro heartbeat imediatamente
+    if (this.socket && this.isConnected) {
+      this.socket.emit("presence:heartbeat", {
+        status: this.status || "online",
+        clientType: "bot"
+      });
+    }
+  }
+
+  /**
+   * Para o sistema de heartbeat
+   * @private
+   */
+  _stopHeartbeat() {
+    if (this.heartbeatInterval) {
+      clearInterval(this.heartbeatInterval);
+      this.heartbeatInterval = null;
+    }
+  }
+
+  /**
+   * Define o status do bot (se o servidor suportar)
+   * @param {string} status - Status: "online", "away", "dnd", "offline"
+   */
+  setStatus(status) {
+    if (!["online", "away", "dnd", "offline"].includes(status)) {
+      throw new ClientError("Invalid status", "INVALID_STATUS");
+    }
+
+    this.status = status;
+
+    if (this.socket && this.isConnected) {
+      this.socket.emit("status:update", { status });
+    }
+  }
+
+  /**
+   * Desconecta o cliente e limpa recursos
+   */
+  disconnect() {
+    this._stopHeartbeat();
+
+    if (this.socket) {
+      // Notifica o servidor antes de desconectar
+      if (this.isConnected) {
+        this.socket.emit("presence:update", {
+          isPageVisible: false,
+          isAppFocused: false,
+          status: "offline",
+          clientType: "bot"
+        });
+      }
+
+      this.socket.disconnect();
+      this.socket = null;
+    }
+
+    this.isConnected = false;
+  }
+
   _setupSocketHandlers() {
     this.socket.on("message:new", async (data) => {
       try {

package/helpers/index.js

@@ -0,0 +1,8 @@
+function formatUrl(url) {
+    const base = 'https://api.beniocord.site';
+    if (!url) return undefined;
+    if (url.startsWith(base) || url.startsWith('http')) return url;
+    return base + (url.startsWith('/') ? url : '/' + url);
+}
+
+module.exports = { formatUrl }

package/package.json

@@ -4,7 +4,7 @@
     "socket.io-client": "^4.8.1"
   },
   "name": "beniocord.js",
-  "version": "2.0.4",
+  "version": "2.0.5",
   "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",
   "devDependencies": {},

package/structures/Channel.js

@@ -1,3 +1,4 @@
+const { formatUrl } = require('../helpers');
 const MessageCollector = require('./MessageCollector');
 
 let client;
@@ -11,7 +12,7 @@ class Channel {
     this.type = data.type || "text";
     this.isPrivate = data.is_private;
     this.isDm = data.is_dm;
-    this.iconUrl = data.icon_url ? 'https://api.beniocord.site' + data.icon_url : undefined;
+    this.iconUrl = formatUrl(data.icon_url);
     this.createdBy = data.created_by;
     this.createdAt = data.created_at;
     this.updatedAt = data.updated_at;

package/structures/Emoji.js

@@ -1,9 +1,11 @@
+const { formatUrl } = require("../helpers");
+
 class Emoji {
     constructor(data) {
         this.id = data.id;
         this.userId = data.user_id;
         this.name = data.name;
-        this.url = data.url ? 'https://api.beniocord.site' + data.url : undefined;
+        this.url = formatUrl(data.url);
         this.createdAt = data.created_at;
         this.updatedAt = data.updated_at;
     }

package/structures/Message.js

@@ -1,5 +1,6 @@
 const User = require("./User");
 const Channel = require("./Channel");
+const { formatUrl } = require('../helpers/index');
 
 let client;
 class Message {
@@ -7,7 +8,7 @@ class Message {
     this.id = data.id;
     this.content = data.content;
     this.messageType = data.message_type || "text";
-    this.fileUrl = data.file_url ? 'https://api.beniocord.site' + data.file_url : undefined;
+    this.fileUrl = formatUrl(data.file_url);
     this.fileName = data.file_name;
     this.fileSize = data.file_size;
     this.replyTo = data.reply_to;

package/structures/User.js

@@ -1,9 +1,11 @@
+const { formatUrl } = require("../helpers");
+
 class User {
   constructor(data, client) {
     this.id = data.id;
     this.username = data.username;
     this.displayName = data.display_name;
-    this.avatarUrl = data.avatar_url ? 'https://api.beniocord.site' + data.avatar_url : undefined;
+    this.avatarUrl = formatUrl(data.avatar_url);
     this.status = data.status || "offline";
     this.emblems = data.emblems || [];
     this.lastSeen = data.last_seen;

package/structures/Util.js

@@ -1,6 +1,5 @@
 /**
- * MessageEmbed - Criar embeds com validação ultra rigorosa
- * Mesmas validações do backend para evitar rejeições
+ * MessageEmbed - Criar embeds
  * @class
  */
 class MessageEmbed {
@@ -483,7 +482,6 @@ class MessageEmbed {
     }
 }
 
-// Cores predefinidas para facilitar o uso
 MessageEmbed.Colors = {
     DEFAULT: '#5865F2',
     BLUE: '#3498DB',