@areumtecnologia/unitychat 1.0.0

package/handlers/newsletters.js

@@ -0,0 +1,184 @@
+
+/**
+ * @copyright Áreum Tecnologia
+ * @author Áreum Tecnologia
+ * @license Proprietary
+ * 
+ * Manipula o gerenciamento de newsletters via WhatsApp utilizando Baileys.
+ * 
+ * @class NewsletterHandler
+ * @classdesc Classe central para manipulação de newsletters no WhatsApp.
+ * 
+ * @property {import('../client').default} client - Instância principal do cliente Baileys.
+ * 
+ * @example
+ * const NewsletterHandler = require('./handlers/newsletters');
+ * const handler = new NewsletterHandler(client);
+ * await handler.sendNewsletter('5511999999999@s.whatsapp.net');
+ */
+// const { sendButtons, sendInteractiveMessage } = require('baileys_helper');
+const { Utils, MessageNormalizer } = require('../utils');
+
+class NewsletterHandler {
+    /**
+     * @param {import('../../../client').default} client - A instância principal do cliente.
+     */
+    constructor(client) {
+        this.client = client;
+        this.newsletters = new Map();
+    }
+
+    /**
+     * Obtém os metadados de uma newsletter.
+     * @param {string} id - O ID da newsletter.
+     * @returns {Promise<object>} Os metadados da newsletter.
+     */
+    async getMetadata(id) {
+        this.client._validateConnection();
+        if (this.newsletters.has(id)) {
+            return this.newsletters.get(id);
+        }
+        let newsletterMetadata;
+        if (id.endsWith("@newsletter")) {
+            newsletterMetadata = await this.client.sock.newsletterMetadata("jid", id);
+        } else {
+            newsletterMetadata = await this.client.sock.newsletterMetadata("invite", id);
+        }
+        this.newsletters.set(id, newsletterMetadata);
+        return newsletterMetadata;
+    }
+
+    /**
+     * Segue uma newsletter.
+     * @param {string} id - O ID da newsletter.
+     * @returns {Promise<object>} O resultado da operação.
+     */
+    async follow(id) {
+        this.client._validateConnection();
+        return this.client.sock.newsletterFollow(id);
+    }
+
+    /**
+     * Deixa de seguir uma newsletter.
+     * @param {string} id - O ID da newsletter.
+     * @returns {Promise<object>} O resultado da operação.
+     */
+    async unfollow(id) {
+        this.client._validateConnection();
+        return this.client.sock.newsletterUnfollow(id);
+    }
+
+    /**
+     * Silencia uma newsletter.
+     * @param {string} jid - O JID da newsletter.
+     * @param {number} duration - A duração do silenciamento em segundos.
+     * @returns {Promise<object>} O resultado da operação.
+     */
+    async mute(jid, duration) {
+        this.client._validateConnection();
+        return this.client.sock.newsletterMute(jid, duration);
+    }
+
+    /**
+     * Remove o silenciamento de uma newsletter.
+     * @param {string} jid - O JID da newsletter.
+     * @returns {Promise<object>} O resultado da operação.
+     */
+    async unmute(jid) {
+        this.client._validateConnection();
+        return this.client.sock.newsletterUnmute(jid);
+    }
+
+    /**
+     * Cria uma newsletter.
+     * @param {string} name - O nome da newsletter.
+     * @param {string} description - A descrição da newsletter.
+     * @param {string} picture - A URL da imagem da newsletter.
+     * @returns {Promise<object>} O resultado da operação.
+     */
+    async create(name, description, picture) {
+        this.client._validateConnection();
+        return this.client.sock.newsletterCreate(name, description, picture);
+    }
+
+    /**
+     * Deleta uma newsletter.
+     * @param {string} jid - O JID da newsletter.
+     * @returns {Promise<object>} O resultado da operação.
+     */
+    async delete(jid) {
+        this.client._validateConnection();
+        return this.client.sock.newsletterDelete(jid);
+    }
+
+    /**
+     * Atualiza o nome de uma newsletter.
+     * @param {string} jid - O JID da newsletter.
+     * @param {string} name - O novo nome da newsletter.
+     * @returns {Promise<object>} O resultado da operação.
+     */
+    async updateName(jid, name) {
+        this.client._validateConnection();
+        return this.client.sock.newsletterUpdateName(jid, name);
+    }
+
+    /**
+     * Atualiza a descrição de uma newsletter.
+     * @param {string} jid - O JID da newsletter.
+     * @param {string} description - A nova descrição da newsletter.
+     * @returns {Promise<object>} O resultado da operação.
+     */
+    async updateDescription(jid, description) {
+        this.client._validateConnection();
+        return this.client.sock.newsletterUpdateDescription(jid, description);
+    }
+
+    /**
+     * Atualiza a imagem de uma newsletter.
+     * @param {string} jid - O JID da newsletter.
+     * @param {string} picture - A nova URL da imagem da newsletter.
+     * @returns {Promise<object>} O resultado da operação.
+     */
+    async updatePicture(jid, picture) {
+        this.client._validateConnection();
+        return this.client.sock.newsletterUpdatePicture(jid, picture);
+    }
+    /**
+     * Atualiza uma newsletter.
+     * @param {string} jid - O JID da newsletter.
+     * @param {string} name - O novo nome da newsletter.
+     * @param {string} description - A nova descrição da newsletter.
+     * @param {string} picture - A nova URL da imagem da newsletter.
+     * @returns {Promise<object>} O resultado da operação.
+     */
+    async update(jid, { name, description, picture }) {
+        this.client._validateConnection();
+        return Promise.all([
+            name ? this.client.sock.newsletterUpdateName(jid, name) : Promise.resolve(),
+            description ? this.client.sock.newsletterUpdateDescription(jid, description) : Promise.resolve(),
+            picture ? this.client.sock.newsletterUpdatePicture(jid, picture) : Promise.resolve()
+        ]);
+    }
+    /**
+     * Atualiza o modo de reação de uma newsletter.
+     * @param {string} jid - O JID da newsletter.
+     * @param {string} mode - O modo de reação da newsletter. ALL, BASIC, NONE
+     * @returns {Promise<object>} O resultado da operação.
+     */
+    async updateReactionMode(jid, mode = "ALL") {
+        this.client._validateConnection();
+        return this.client.sock.newsletterReactionMode(jid, mode);
+    }
+
+    /**
+     * Obtém todas as newsletters que o cliente participa.
+     * @returns {Promise<object>} O resultado da operação.
+     */
+    async getAllNewsletters() {
+        this.client._validateConnection();
+        const result = await this.client.sock.newsletterSubscribed();
+        return result?.xwa2_newsletter_subscribed || [];
+    }
+}
+
+module.exports = NewsletterHandler;

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/stories.js

@@ -0,0 +1,37 @@
+// Classe para manipular envio e gerenciamento de stories seguindo padrao de handlers
+
+class StoriesHandler {
+    constructor(client) {
+        this.client = client;
+    }
+
+    async send(jids, content, options = { sendMentions: false }) {
+        this.client._validateConnection();
+        if (!Array.isArray(jids)) {
+            throw new Error('jids must be an array of JIDs');
+        }
+        let result = null;
+        if (options.sendMentions) {
+            // limitar o numero de jids do array até 5 por mensagem (limite imposto pelo WhatsApp)
+            jids = jids.slice(0, 5);
+            result = await this.client.sock.sendStatusMentions(content, jids, options);
+        } else {
+            result = await this.client.sock.sendMessage('status@broadcast', content, {
+                broadcast: true,
+                backgroundColor: options.backgroundColor || '#288d7c85',
+                font: options.font || 1,
+                statusJidList: jids
+            });
+        }
+        return await this.client.messages.normalize(result);
+    }
+
+    // Remover uma mensagem de stories
+    async delete(msg) {
+        this.client._validateConnection();
+        return await this.client.sock.sendMessage('status@broadcast', { delete: msg });
+    }
+
+}
+
+module.exports = StoriesHandler;

package/handlers/users.js

@@ -0,0 +1,119 @@
+
+/**
+ * @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;
+    }
+    /**
+     * @param {string} jid - O JID do contato.
+     * @returns {Promise<object>} - Um objeto contendo as informações do contato.
+     */
+    async getMetadata(jid) {
+        const contact = this.client.contacts.get(jid);
+        if (contact) {
+            return contact;
+        }
+        return await this.client.contacts.normalize({ key: { remoteJid: jid } });
+    }
+
+    /**
+     * @param {string} id - O ID do contato.
+     * @returns {Promise<object>} - Um objeto contendo as informações de recado do contato.
+     */
+    async getStatus(id) {
+        const myStatus = await this.client.sock.fetchStatus(id);
+        return myStatus;
+    }
+
+    /**
+     * @param {string} lid - O LID do contato.
+     * @returns {Promise<string>} - O JID do contato.
+     */
+    async getPnForLid(lid) {
+        if (!lid.endsWith('@lid')) {
+            throw new Error('LID inválido');
+        }
+        const jid = await this.client.sock.signalRepository.lidMapping.getPNForLID(lid);
+        return jid?.replace(/:.*?@/, "@")
+    }
+
+    /**
+     * @returns {Promise<object>} - Um objeto contendo as informações de recado do bot.
+     */
+    async getMyStatus() {
+        const { id } = this.client.sock.user;
+        const myStatus = await this.getStatus(id);
+        return myStatus;
+    }
+    /**
+     * @param {string} jid - O JID do contato.
+     * @returns {Promise<object>} - Um objeto contendo as informações do contato.
+     */
+    async getBusinessProfile(jid) {
+        return await this.client.sock.getBusinessProfile(jid);
+    }
+
+    /** Obtém a URL da foto de perfil de um usuário ou grupo. */
+    async getProfilePicture(jid) {
+        try {
+            return await this.client.sock.profilePictureUrl(jid, 'image');
+        } catch (error) {
+            return null;
+        }
+    }
+
+    /** Verifica se um número está no WhatsApp. Inclusive retorna ID verdadeira para numeros brasileiros com 9 digitos */
+    async isOnWhatsApp(number) {
+        const [result] = await this.client.sock.onWhatsApp(number);
+        return result;
+    }
+
+    /** Atualiza o nome do perfil do bot. */
+    async updateProfileName(newName) {
+        return await this.client.sock.updateProfileName(newName);
+    }
+
+    /** Atualiza o recado/status do perfil do bot. */
+    async updateProfileStatus(newStatus) {
+        return await this.client.sock.updateProfileStatus(newStatus);
+    }
+
+    /** Bloqueia um usuário. */
+    async block(jid) {
+        return await this.client.sock.updateBlockStatus(jid, 'block');
+    }
+
+    /** Desbloqueia um usuário. */
+    async unblock(jid) {
+        return await this.client.sock.updateBlockStatus(jid, 'unblock');
+    }
+
+    /** Obtém a lista de contatos bloqueados. */
+    async getBlocklist() {
+        return await this.client.sock.fetchBlocklist();
+    }
+
+    /** Envia uma atualização de presença. Use PresenceStatus */
+    async sendPresence(jid, presenceStatus) {
+        return await this.client.sock.sendPresenceUpdate(presenceStatus, jid);
+    }
+
+}
+
+module.exports = { UserHandler, PresenceStatus };