@areumtecnologia/baileys 1.0.0

package/baileys.code-workspace

@@ -0,0 +1,8 @@
+{
+	"folders": [
+		{
+			"path": "."
+		}
+    ],
+    "settings": {}
+}

package/handlers/groups.js

@@ -0,0 +1,94 @@
+
+/**
+ * Manipula operações relacionadas a grupos.
+ * 
+ * @copyright Áreum Tecnologia
+ * @author Áreum Tecnologia
+ * @class GroupHandler
+ * @param {import('../client').default} client - A instância principal do cliente.
+ * 
+ * @method getMetadata Obtém os metadados de um grupo.
+ * @param {string} groupId - O ID do grupo.
+ * @returns {Promise<Object>} Metadados do grupo.
+ * 
+ * @method create Cria um novo grupo.
+ * @param {string} subject - Nome do grupo.
+ * @param {string[]} participantsJids - Lista de JIDs dos participantes.
+ * @returns {Promise<Object>} Dados do grupo criado.
+ * 
+ * @method leave Deixa um grupo.
+ * @param {string} groupId - O ID do grupo.
+ * @returns {Promise<Object>} Resultado da operação.
+ * 
+ * @method updateName Atualiza o nome de um grupo.
+ * @param {string} groupId - O ID do grupo.
+ * @param {string} newName - Novo nome do grupo.
+ * @returns {Promise<Object>} Resultado da operação.
+ * 
+ * @method updateDescription Atualiza a descrição de um grupo.
+ * @param {string} groupId - O ID do grupo.
+ * @param {string} newDescription - Nova descrição do grupo.
+ * @returns {Promise<Object>} Resultado da operação.
+ * 
+ * @method updateParticipants Modifica a lista de participantes de um grupo.
+ * @param {string} groupId - O ID do grupo.
+ * @param {string[]} participantsJids - Lista de JIDs dos participantes.
+ * @param {'add'|'remove'} action - Ação a ser realizada.
+ * @returns {Promise<Object>} Resultado da operação.
+ * 
+ * @method getInviteCode Obtém o código de convite de um grupo.
+ * @param {string} groupId - O ID do grupo.
+ * @returns {Promise<string>} Código de convite do grupo.
+ */
+class GroupHandler {
+    /**
+     * @param {import('../client').default} client - A instância principal do cliente.
+     */
+    constructor(client) {
+        this.client = client;
+    }
+
+    /** Obtém os metadados de um grupo. */
+    async getMetadata(groupId) {
+        this.client._validateConnection();
+        return this.client.sock.groupMetadata(groupId);
+    }
+
+    /** Cria um novo grupo. */
+    async create(subject, participantsJids) {
+        this.client._validateConnection();
+        return this.client.sock.groupCreate(subject, participantsJids);
+    }
+
+    /** Deixa um grupo. */
+    async leave(groupId) {
+        this.client._validateConnection();
+        return this.client.sock.groupLeave(groupId);
+    }
+
+    /** Atualiza o nome de um grupo. */
+    async updateName(groupId, newName) {
+        this.client._validateConnection();
+        return this.client.sock.groupUpdateSubject(groupId, newName);
+    }
+
+    /** Atualiza a descrição de um grupo. */
+    async updateDescription(groupId, newDescription) {
+        this.client._validateConnection();
+        return this.client.sock.groupUpdateDescription(groupId, newDescription);
+    }
+
+    /** Modifica a lista de participantes de um grupo. */
+    async updateParticipants(groupId, participantsJids, action) {
+        this.client._validateConnection();
+        return this.client.sock.groupParticipantsUpdate(groupId, participantsJids, action);
+    }
+
+    /** Obtém o código de convite de um grupo. */
+    async getInviteCode(groupId) {
+        this.client._validateConnection();
+        return this.client.sock.groupInviteCode(groupId);
+    }
+}
+
+module.exports = GroupHandler;

package/handlers/messages.js

@@ -0,0 +1,285 @@
+
+/**
+ * @copyright Áreum Tecnologia
+ * @author Áreum Tecnologia
+ * @license Proprietary
+ * 
+ * Manipula o envio e recebimento de mensagens via WhatsApp utilizando Baileys.
+ * Fornece métodos para envio de texto, mídia, localização, contatos, enquetes, ações de mensagem e interatividade.
+ * 
+ * @class MessageHandler
+ * @classdesc Classe central para manipulação de mensagens no WhatsApp.
+ * 
+ * @property {import('../client').default} client - Instância principal do cliente Baileys.
+ * 
+ * @example
+ * const MessageHandler = require('./handlers/messages');
+ * const handler = new MessageHandler(client);
+ * await handler.sendTextMessage('5511999999999@s.whatsapp.net', 'Olá!');
+ */
+// const { sendButtons, sendInteractiveMessage } = require('baileys_helper');
+const { Utils, MessageNormalizer } = require('../utils');
+
+class MessageHandler {
+    /**
+     * @param {import('../../../client').default} client - A instância principal do cliente.
+     */
+    constructor(client) {
+        this.client = client;
+    }
+
+    /** 
+     * Método central de envio de mensagens. Realiza a normalização do JID antes do envio.
+     * @private
+     */
+    async sendMessage(jid, content, options = {}) {
+        this.client._validateConnection();
+        const verifiedJid = await this.client.users.isOnWhatsApp(jid);
+        if (verifiedJid && verifiedJid.exists) {
+            const msg = await this.client.sock.sendMessage(verifiedJid.jid, content, options);
+            const nmsg = await MessageNormalizer.normalize(msg, this.client);
+            return nmsg;
+        }
+        else {
+            if (verifiedJid) {
+                return verifiedJid;
+            }
+            // Se verifiedJid e undefined ou null cria objeto padrao
+            return { error: { exists: false, message: "WA_NUMBER_NOT_FOUNDED" } };
+        }
+    }
+
+    // =================================================================================================
+    //                                     MÉTODOS DE ENVIO BÁSICOS
+    // =================================================================================================
+
+    /** Envia uma mensagem de texto. */
+    async sendTextMessage(jid, text, options = {}) {
+        return this.sendMessage(jid, { text }, options);
+    }
+
+    /** Responde a uma mensagem específica. */
+    async reply(originalMessage, content) {
+        const jid = originalMessage.key.remoteJid;
+        // Não é necessário normalizar o JID aqui, pois ele vem de uma mensagem existente.
+        return this.client.sock.sendMessage(jid, content, { quoted: originalMessage });
+    }
+
+    // =================================================================================================
+    //                                     MÉTODOS DE ENVIO DE MÍDIA
+    // =================================================================================================
+
+    /** Envia uma imagem. */
+    async sendImage(jid, media, caption = '', options = {}) {
+        const content = {
+            image: typeof media === 'string' ? { url: media } : media,
+            caption,
+            viewOnce: !!options.viewOnce // Adiciona o modificador de visualização única
+        };
+        return this.sendMessage(jid, content, options);
+    }
+
+    /** Envia um vídeo. */
+    async sendVideo(jid, media, caption = '', options = {}) {
+        const content = {
+            video: typeof media === 'string' ? { url: media } : media,
+            caption,
+            viewOnce: !!options.viewOnce // Adiciona o modificador de visualização única
+        };
+        return this.sendMessage(jid, content, options);
+    }
+
+    /** Envia um áudio (como mensagem de voz). */
+    async sendAudio(jid, media, ptt = true, options = {}) {
+        const content = {
+            audio: typeof media === 'string' ? { url: media } : media,
+            ptt
+        };
+        return this.sendMessage(jid, content, options);
+    }
+
+    /** Envia um documento. */
+    async sendDocument(jid, media, mimetype, fileName = 'file', options = {}) {
+        const content = {
+            document: typeof media === 'string' ? { url: media } : media,
+            mimetype,
+            fileName
+        };
+        return this.sendMessage(jid, content, options);
+    }
+
+    // =================================================================================================
+    //                             NOVOS MÉTODOS DE MENSAGENS ESTRUTURADAS
+    // =================================================================================================
+
+    /** Envia uma localização. */
+    async sendLocation(jid, latitude, longitude, name = '', address = '') {
+        const content = {
+            location: {
+                degreesLatitude: latitude,
+                degreesLongitude: longitude,
+                name: name,
+                address: address
+            }
+        };
+        return this.sendMessage(jid, content);
+    }
+
+    /** 
+     * Envia um ou mais contatos.
+     * @param {string} jid - O JID do destinatário.
+     * @param {Array<object>} contacts - Um array de contatos.
+     * @param {string} contacts[].fullName - O nome completo do contato.
+     * @param {string} contacts[].waid - O número de telefone no formato internacional (ex: 5511999999999).
+     * @param {string} [contacts[].organization] - A organização do contato (opcional).
+     */
+    async sendContacts(jid, contacts) {
+        const vcards = contacts.map(c => ({
+            displayName: c.fullName,
+            vcard: `BEGIN:VCARD\nVERSION:3.0\nFN:${c.fullName}\n${c.organization ? `ORG:${c.organization};\n` : ''}TEL;type=CELL;type=VOICE;waid=${c.waid}:+${c.waid.replace(/ /g, '')}\nEND:VCARD`
+        }));
+
+        const content = {
+            contacts: {
+                contacts: vcards
+            }
+        };
+        return this.sendMessage(jid, content);
+    }
+
+    /** 
+     * Envia uma enquete (poll).
+     * @param {string} jid - O JID do destinatário.
+     * @param {string} pollName - A pergunta da enquete.
+     * @param {string[]} pollValues - Um array com as opções da enquete.
+     * @param {object} [options={}] - Opções adicionais.
+     * @param {number} [options.selectableCount=1] - Quantas opções podem ser selecionadas. 1 para escolha única, 0 para múltipla escolha.
+     */
+    async sendPoll(jid, pollName, pollValues, options = {}) {
+        const content = {
+            poll: {
+                name: pollName,
+                values: pollValues,
+                selectableCount: options.selectableCount === 0 ? 0 : 1
+            }
+        };
+        return this.sendMessage(jid, content);
+    }
+
+    /**
+     * Envia uma mensagem de link (preview).
+     * @param {string} jid - O JID do destinatário.
+     * @param {string} url - O link a ser enviado.
+     * @param {string} [caption=''] - Texto opcional para acompanhar o link.
+     * @param {object} [options={}] - Opções adicionais.
+     */
+    async sendLink(jid, url, options = {}) {
+
+        return this.sendMessage(jid, { text: url }, options);
+    }
+
+    // =================================================================================================
+    //                                  MÉTODOS DE AÇÕES DE MENSAGEM
+    // =================================================================================================
+
+    /** Encaminha uma mensagem para um JID. */
+    async forwardMessage(jid, messageToForward) {
+        const content = {
+            forward: messageToForward
+        };
+        return this.sendMessage(jid, content);
+    }
+
+    /** Edita o conteúdo de uma mensagem enviada anteriormente pelo bot. */
+    async editMessage(originalMessageKey, newText) {
+        const jid = originalMessageKey.remoteJid;
+        const content = {
+            text: newText,
+            edit: originalMessageKey
+        };
+        // Não precisa normalizar, pois o JID vem de uma mensagem existente.
+        return this.client.sock.sendMessage(jid, content);
+    }
+
+    /** Reage a uma mensagem com um emoji. */
+    async react(messageKey, emoji) {
+        const reaction = { react: { text: emoji, key: messageKey } };
+        return this.sendMessage(messageKey.remoteJid, reaction);
+    }
+
+    /** Apaga uma mensagem (enviada pelo bot). */
+    async delete(messageKey) {
+        return this.sendMessage(messageKey.remoteJid, { delete: messageKey });
+    }
+
+    // =================================================================================================
+    //                                     MÉTODOS INTERATIVOS E OUTROS
+    // =================================================================================================
+    /** Envia acoes  */
+    async sendTyping(jid) {
+        try {
+            this.client._validateConnection();
+            const verifiedJid = await this.client.users.isOnWhatsApp(jid);
+            if (verifiedJid && verifiedJid.exists) {
+
+                await this.client.sock.presenceSubscribe(jid)
+                await this.client.sock.sendPresenceUpdate('available', jid)
+                await Utils.delay(500);
+
+                await this.client.sock.sendPresenceUpdate('composing', jid)
+                await Utils.delay(5000)
+
+                return await this.client.sock.sendPresenceUpdate('paused', jid)
+            }
+            else {
+                return verifiedJid;
+            }
+
+        } catch (error) {
+            throw error;
+        }
+    }
+    /** Marca mensagens como lidas. */
+    async read(messageKey) {
+        this.client._validateConnection();
+        return this.client.sock.readMessages([messageKey]);
+    }
+
+    async sendInteractiveMessage(jid, interactiveMessage, more) {
+        const verifiedJid = await this.client.users.isOnWhatsApp(jid);
+        if (verifiedJid && verifiedJid.exists) {
+            return await sendInteractiveMessage(this.client.sock, verifiedJid.jid, interactiveMessage, more);
+        }
+        else {
+            return verifiedJid;
+        }
+    }
+
+    /** Envia uma mensagem com botões interativos. */
+    async sendButtons(jid, messageButton) {
+        const verifiedJid = await this.client.users.isOnWhatsApp(jid);
+        if (verifiedJid && verifiedJid.exists) {
+            return await sendButtons(this.client.sock, verifiedJid.jid, messageButton);
+        }
+        else {
+            return verifiedJid;
+        }
+    }
+
+    /** Faz o download de mídia de uma mensagem. */
+    async download(message) {
+        this.client._validateConnection();
+        const type = Object.keys(message.message)[0];
+        const messageContent = message.message[type];
+        if (!messageContent.url) throw new Error('Mensagem não contém mídia para download.');
+
+        const stream = await this.client.downloadContentFromMessage(messageContent, type.replace('Message', ''));
+        let buffer = Buffer.from([]);
+        for await (const chunk of stream) {
+            buffer = Buffer.concat([buffer, chunk]);
+        }
+        return buffer;
+    }
+}
+
+module.exports = MessageHandler;

package/handlers/presence-status.js

@@ -0,0 +1,9 @@
+class PresenceStatus {
+    static COMPOSING = 'composing';      // digitando...
+    static RECORDING = 'recording';      // gravando áudio...
+    static PAUSED = 'paused';            // parou de digitar/gravar
+    static AVAILABLE = 'available';      // online
+    static UNAVAILABLE = 'unavailable';  // offline
+}
+
+module.exports = PresenceStatus;

package/handlers/users.js

@@ -0,0 +1,94 @@
+
+/**
+ * @copyright Áreum Tecnologia
+ * @file Gerenciador de operações de usuário para o cliente WhatsApp.
+ * @module UserHandler
+ * 
+ * @description
+ * Esta classe fornece métodos para manipulação de usuários, incluindo obtenção de status,
+ * foto de perfil, verificação de existência no WhatsApp, atualização de perfil, bloqueio/desbloqueio,
+ * e envio de atualizações de presença.
+ * 
+ * @author Áreum Tecnologia
+ */
+const PresenceStatus = require('./presence-status');
+
+class UserHandler {
+    /**
+     * @param {import('../../../client').default} client - A instância principal do cliente.
+     */
+    constructor(client) {
+        this.client = client;
+    }
+
+    async getStatus(id) {
+        const myStatus = await this.client.sock.fetchStatus(id);
+        return myStatus;
+    }
+
+    async getMyStatus() {
+        const { id } = this.client.sock.user;
+        const myStatus = await this.getStatus(id);
+        return myStatus;
+    }
+
+    /** Obtém a URL da foto de perfil de um usuário ou grupo. */
+    async getProfilePicture(jid) {
+        this.client._validateConnection();
+        return this.client.sock.profilePictureUrl(jid, 'image');
+    }
+
+    /** Verifica se um número está no WhatsApp. Inclusive retorna ID verdadeira para numeros brasileiros com 9 digitos */
+    async isOnWhatsApp(numbers) {
+        this.client._validateConnection();
+
+        // Se for apenas 1 número
+        if (!Array.isArray(numbers)) {
+            const [result] = await this.client.sock.onWhatsApp(numbers);
+            return result;
+        }
+
+        // Se for lista de números
+        const results = await this.client.sock.onWhatsApp(...numbers);
+        return results;
+    }
+
+    /** Atualiza o nome do perfil do bot. */
+    async updateProfileName(newName) {
+        this.client._validateConnection();
+        return this.client.sock.updateProfileName(newName);
+    }
+
+    /** Atualiza o recado/status do perfil do bot. */
+    async updateProfileStatus(newStatus) {
+        this.client._validateConnection();
+        return this.client.sock.updateProfileStatus(newStatus);
+    }
+
+    /** Bloqueia um usuário. */
+    async block(jid) {
+        this.client._validateConnection();
+        return this.client.sock.updateBlockStatus(jid, 'block');
+    }
+
+    /** Desbloqueia um usuário. */
+    async unblock(jid) {
+        this.client._validateConnection();
+        return this.client.sock.updateBlockStatus(jid, 'unblock');
+    }
+
+    /** Obtém a lista de contatos bloqueados. */
+    async getBlocklist() {
+        this.client._validateConnection();
+        return this.client.sock.fetchBlocklist();
+    }
+
+    /** Envia uma atualização de presença. Use PresenceStatus */
+
+    async sendPresence(jid, presenceStatus) {
+        this.client._validateConnection();
+        await this.client.sock.sendPresenceUpdate(presenceStatus, jid);
+    }
+}
+
+module.exports = { UserHandler, PresenceStatus };