@areumtecnologia/baileys 1.0.0

package/types/interactive-messages.js

@@ -0,0 +1,318 @@
+// File: lib/builders/interactive-message.js
+
+/**
+ * Classe base abstrata para todos os botões interativos.
+ * @abstract
+ */
+class InteractiveButtonBase {
+    constructor(name) {
+        if (this.constructor === InteractiveButtonBase) {
+            throw new Error("A classe base abstrata não pode ser instanciada diretamente.");
+        }
+        this.name = name;
+    }
+
+    /**
+     * Formata o botão para o formato final esperado pela API.
+     * @returns {{name: string, buttonParamsJson: string}}
+     */
+    toJSON() {
+        const params = this._buildParams();
+        return {
+            name: this.name,
+            buttonParamsJson: JSON.stringify(params)
+        };
+    }
+
+    /**
+     * Método a ser implementado pelas subclasses para construir seus parâmetros específicos.
+     * @protected
+     * @abstract
+     */
+    _buildParams() {
+        throw new Error("O método '_buildParams' deve ser implementado pela subclasse.");
+    }
+}
+
+// =================================================================================================
+//                                     CLASSES DE BOTÕES SIMPLES
+// =================================================================================================
+
+class QuickReplyButton extends InteractiveButtonBase {
+    /**
+     * @param {string} id - O ID que será retornado quando o botão for clicado.
+     * @param {string} displayText - O texto exibido no botão.
+     */
+    constructor(id, displayText) {
+        super('quick_reply');
+        this.id = id;
+        this.displayText = displayText;
+    }
+
+    _buildParams() {
+        return { display_text: this.displayText, id: this.id };
+    }
+}
+
+class UrlButton extends InteractiveButtonBase {
+    /**
+     * @param {string} displayText - O texto exibido no botão.
+     * @param {string} url - A URL para a qual o usuário será redirecionado.
+     * @param {string} [merchantUrl] - URL do comerciante (opcional).
+     */
+    constructor(displayText, url, merchantUrl = null) {
+        super('cta_url');
+        this.displayText = displayText;
+        this.url = url;
+        this.merchantUrl = merchantUrl;
+    }
+
+    _buildParams() {
+        const params = { display_text: this.displayText, url: this.url };
+        if (this.merchantUrl) {
+            params.merchant_url = this.merchantUrl;
+        }
+        return params;
+    }
+}
+
+class CopyCodeButton extends InteractiveButtonBase {
+    /**
+     * @param {string} displayText - O texto exibido no botão.
+     * @param {string} code - O código a ser copiado para a área de transferência.
+     */
+    constructor(displayText, code) {
+        super('cta_copy');
+        this.displayText = displayText;
+        this.code = code;
+    }
+
+    _buildParams() {
+        return { display_text: this.displayText, copy_code: this.code };
+    }
+}
+
+class CallButton extends InteractiveButtonBase {
+    /**
+     * @param {string} displayText - O texto exibido no botão.
+     * @param {string} phoneNumber - O número de telefone a ser chamado.
+     */
+    constructor(displayText, phoneNumber) {
+        super('cta_call');
+        this.displayText = displayText;
+        this.phoneNumber = phoneNumber;
+    }
+
+    _buildParams() {
+        return { display_text: this.displayText, phone_number: this.phoneNumber };
+    }
+}
+
+class LocationButton extends InteractiveButtonBase {
+    /**
+     * @param {string} displayText - O texto exibido no botão.
+     */
+    constructor(displayText = 'Share Location') {
+        super('send_location');
+        this.displayText = displayText;
+    }
+
+    _buildParams() {
+        return { display_text: this.displayText };
+    }
+}
+
+// =================================================================================================
+//                                CLASSES PARA BOTÃO DE LISTA (SINGLE_SELECT)
+// =================================================================================================
+
+class ListRow {
+    /**
+     * @param {string} id - O ID da linha, retornado na seleção.
+     * @param {string} title - O título principal da linha.
+     * @param {string} [description=''] - A descrição opcional abaixo do título.
+     * @param {string} [header=''] - O cabeçalho opcional da linha.
+     */
+    constructor(id, title, description = '', header = '') {
+        this.id = id;
+        this.title = title;
+        this.description = description;
+        this.header = header;
+    }
+
+    toJSON() {
+        return {
+            id: this.id,
+            title: this.title,
+            description: this.description,
+            header: this.header
+        };
+    }
+}
+
+class ListSection {
+    /**
+     * @param {string} title - O título da seção.
+     * @param {ListRow[]} [rows=[]] - Uma lista inicial de linhas.
+     */
+    constructor(title, rows = []) {
+        this.title = title;
+        this.rows = rows;
+        this.highlightLabel = '';
+    }
+
+    /**
+     * Adiciona uma linha à seção.
+     * @param {ListRow} row - A linha a ser adicionada.
+     * @returns {ListSection}
+     */
+    addRow(row) {
+        this.rows.push(row);
+        return this;
+    }
+
+    /**
+     * Adiciona uma etiqueta de destaque à seção.
+     * @param {string} label - O texto da etiqueta.
+     * @returns {ListSection}
+     */
+    withHighlightLabel(label) {
+        this.highlightLabel = label;
+        return this;
+    }
+
+    toJSON() {
+        return {
+            title: this.title,
+            highlight_label: this.highlightLabel,
+            rows: this.rows.map(row => row.toJSON())
+        };
+    }
+}
+
+class ListButton extends InteractiveButtonBase {
+    /**
+     * @param {string} title - O título do menu da lista.
+     * @param {ListSection[]} [sections=[]] - Uma lista inicial de seções.
+     */
+    constructor(title, sections = []) {
+        super('single_select');
+        this.title = title;
+        this.sections = sections;
+    }
+
+    /**
+     * Adiciona uma seção à lista.
+     * @param {ListSection} section - A seção a ser adicionada.
+     * @returns {ListButton}
+     */
+    addSection(section) {
+        this.sections.push(section);
+        return this;
+    }
+
+    _buildParams() {
+        return {
+            title: this.title,
+            sections: this.sections.map(sec => sec.toJSON())
+        };
+    }
+}
+
+// =================================================================================================
+//                                  CLASSE PRINCIPAL DO CONSTRUTOR
+// =================================================================================================
+
+/**
+ * Construtor para mensagens interativas.
+ */
+class InteractiveMessage {
+    constructor() {
+        this.content = {
+            text: '',
+            title: '',
+            subtitle: '',
+            footer: '',
+            interactiveButtons: []
+        };
+    }
+
+    /**
+     * Define o texto principal da mensagem.
+     * @param {string} text 
+     * @returns {InteractiveMessage}
+     */
+    withText(text) {
+        this.content.text = text;
+        return this;
+    }
+
+    /**
+     * Define o título (cabeçalho) da mensagem.
+     * @param {string} title 
+     * @returns {InteractiveMessage}
+     */
+    withTitle(title) {
+        this.content.title = title;
+        return this;
+    }
+
+    /**
+     * Define o subtítulo da mensagem.
+     * @param {string} subtitle 
+     * @returns {InteractiveMessage}
+     */
+    withSubtitle(subtitle) {
+        this.content.subtitle = subtitle;
+        return this;
+    }
+
+    /**
+     * Define o rodapé da mensagem.
+     * @param {string} footer 
+     * @returns {InteractiveMessage}
+     */
+    withFooter(footer) {
+        this.content.footer = footer;
+        return this;
+    }
+
+    /**
+     * Adiciona um botão à mensagem.
+     * @param {InteractiveButtonBase} button - Uma instância de uma classe de botão (ex: QuickReplyButton).
+     * @returns {InteractiveMessage}
+     */
+    addButton(button) {
+        if (!(button instanceof InteractiveButtonBase)) {
+            throw new Error('O botão deve ser uma instância de uma classe que herda de InteractiveButtonBase.');
+        }
+        this.content.interactiveButtons.push(button.toJSON());
+        return this;
+    }
+
+    /**
+     * Constrói e retorna o objeto final da mensagem interativa.
+     * @returns {object}
+     */
+    build() {
+        // Remove chaves vazias para um payload mais limpo
+        Object.keys(this.content).forEach(key => {
+            if (!this.content[key] || (Array.isArray(this.content[key]) && this.content[key].length === 0)) {
+                delete this.content[key];
+            }
+        });
+        return this.content;
+    }
+}
+
+module.exports = {
+    InteractiveMessage,
+    QuickReplyButton,
+    UrlButton,
+    CopyCodeButton,
+    CallButton,
+    LocationButton,
+    ListButton,
+    ListSection,
+    ListRow
+};

package/utils/generic-utils.js

@@ -0,0 +1,23 @@
+class Utils {
+    /**
+     * Pausa a execução por um determinado número de milissegundos.
+     * @param {number} ms - O tempo em milissegundos para aguardar.
+     * @returns {Promise<void>}
+     */
+    static delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+
+    // Helper function to convert base64 to Uint8Array
+    static base64ToUint8Array(base64) {
+        const binaryString = atob(base64);
+        const len = binaryString.length;
+        const bytes = new Uint8Array(len);
+        for (let i = 0; i < len; i++) {
+            bytes[i] = binaryString.charCodeAt(i);
+        }
+        return bytes;
+    };
+}
+
+module.exports = Utils;

package/utils/index.js

@@ -0,0 +1,4 @@
+const MessageNormalizer = require('./message-normalizer');
+const MessageStore = require('./message-store');
+const Utils = require('./generic-utils');
+module.exports = { MessageNormalizer, MessageStore, Utils };

package/utils/message-normalizer.js

@@ -0,0 +1,323 @@
+const digestSync = require('crypto-digest-sync');
+
+/**
+ * Classe utilitária estática para normalizar o objeto de mensagem do Baileys
+ * em uma estrutura rica, consistente e completa. (Versão 3 - Final)
+ */
+class MessageNormalizer {
+    /**
+     * Ponto de entrada principal. Normaliza uma mensagem bruta do Baileys.
+     * @param {import('baileys').proto.WebMessageInfo} rawMessage - O objeto de mensagem bruto.
+     * @param {import('../client').default} client - A instância do cliente.
+     * @returns {object|null} Um objeto de mensagem normalizado ou null se não for uma mensagem válida.
+     */
+    static async normalize(rawMessage, client) {
+        // if (!rawMessage || (!rawMessage.message && !rawMessage.messageStubType)) {
+        if (!rawMessage || !rawMessage.message) {
+            return null;
+        }
+
+        // Caso especial 1: Mensagem editada. A normalização é feita na mensagem interna.
+        const editedMsgContent = rawMessage.message?.protocolMessage?.editedMessage;
+        if (editedMsgContent) {
+            const originalKey = rawMessage.message.protocolMessage.key;
+            const normalizedEdit = this.normalize({ key: originalKey, message: editedMsgContent, pushName: rawMessage.pushName }, client);
+            if (normalizedEdit) {
+                normalizedEdit.isEdited = true;
+                normalizedEdit.id = originalKey.id; // Garante que o ID é o da mensagem original
+            }
+            return normalizedEdit;
+        }
+        const originalType = Object.keys(rawMessage.message)[0];
+        const type = this._getFriendlyType(rawMessage.message);
+        const messageContent = rawMessage.message[originalType];
+        const contextInfo = messageContent?.contextInfo;
+        const chatId = rawMessage.key.remoteJid.includes('@lid') ? rawMessage.key.remoteJidAlt : rawMessage.key.remoteJid;
+        const isGroup = chatId.endsWith('@g.us');
+        const clientJid = client.jidNormalizedUser(client.sock.user.id);
+
+        const normalized = {
+            id: rawMessage.key.id,
+            from: isGroup ? rawMessage.key.participant : rawMessage.key.fromMe ? clientJid : chatId,
+            to: isGroup ? rawMessage.key.participant : rawMessage.key.fromMe ? chatId : clientJid,
+            chatId: chatId,
+            timestamp: new Date(Number(rawMessage.messageTimestamp) * 1000),
+            fromMe: rawMessage.key.fromMe,
+            isGroup: isGroup,
+            sender: {
+                id: isGroup ? rawMessage.key.participant : rawMessage.key.fromMe ? clientJid : chatId,
+                pushName: rawMessage.pushName || ''
+            },
+            type,
+            body: this._extractBody(rawMessage.message),
+            hasMedia: false,
+            media: null,
+            location: null,
+            contacts: this._extractContacts(rawMessage.message),
+            isReply: !!contextInfo?.quotedMessage,
+            quotedMessage: null,
+            isForwarded: !!contextInfo?.isForwarded,
+            forwardingScore: contextInfo?.forwardingScore || 0,
+            mentions: contextInfo?.mentionedJid || [],
+            isMentioningMe: (contextInfo?.mentionedJid || []).includes(clientJid),
+            isEdited: false,
+            interactiveReply: this._extractInteractiveReply(rawMessage.message),
+            reaction: this._extractReaction(rawMessage.message),
+            pollUpdate: await this._extractPollUpdate(rawMessage, client),
+            poll: this._extractPollCreation(rawMessage),
+            raw: rawMessage // Referência ao objeto original para acesso avançado
+        };
+
+        // Preenche os campos de mídia e localização com detalhes específicos
+        this._enrichWithTypedData(normalized, rawMessage, client);
+
+        // Se for uma resposta, normaliza a mensagem citada recursivamente
+        if (normalized.isReply) {
+            const quotedRaw = {
+                key: {
+                    remoteJid: chatId,
+                    id: contextInfo.stanzaId,
+                    fromMe: client.jidNormalizedUser(contextInfo.participant) === clientJid,
+                    participant: contextInfo.participant
+                },
+                message: contextInfo.quotedMessage
+            };
+            normalized.quotedMessage = this.normalize(quotedRaw, client);
+        }
+
+        return normalized;
+    }
+
+    /** 
+     * @private Retorna um tipo amigável baseado no conteúdo da mensagem. 
+     */
+    static _getFriendlyType(message) {
+        if (!message) return 'unknown'
+
+        if (message.conversation || message.extendedTextMessage) return 'text'
+        if (message.imageMessage) return 'image'
+        if (message.videoMessage) return 'video'
+        if (message.audioMessage) return 'audio'
+        if (message.documentMessage) return 'document'
+        if (message.stickerMessage) return 'sticker'
+        if (message.locationMessage) return 'location'
+        if (message.contactMessage || message.contactsArrayMessage) return 'contact'
+        if (message.buttonsResponseMessage || message.listResponseMessage) return 'interactive_reply'
+        if (message.reactionMessage) return 'reaction'
+        if (message.pollCreationMessage || message.pollCreationMessageV3) return 'poll_creation'
+        if (message.pollUpdateMessage) return 'poll_update'
+
+        return 'unknown'
+    }
+
+
+    /** @private Extrai o conteúdo textual principal de qualquer tipo de mensagem. */
+    static _extractBody(message) {
+        return message?.conversation ||
+            message?.extendedTextMessage?.text ||
+            message?.imageMessage?.caption ||
+            message?.videoMessage?.caption ||
+            message?.buttonsResponseMessage?.selectedDisplayText ||
+            message?.listResponseMessage?.title || '';
+    }
+
+    /** @private Extrai e formata os dados de mídia. */
+    static _enrichWithTypedData(normalized, rawMessage, client) {
+        const type = Object.keys(rawMessage.message)[0];
+        const messageContent = rawMessage.message[type];
+        const mediaTypes = ['imageMessage', 'videoMessage', 'audioMessage', 'documentMessage', 'stickerMessage'];
+        if (mediaTypes.includes(type)) {
+            normalized.hasMedia = true;
+            normalized.media = {
+                mimetype: messageContent.mimetype,
+                fileName: messageContent.fileName || null,
+                duration: messageContent.seconds || null,
+                isPtt: messageContent.ptt || false,
+                isGif: messageContent.gifPlayback || false,
+                isViewOnce: messageContent.viewOnce || false,
+                download: () => client.messages.download(rawMessage)
+            };
+        }
+
+        if (type === 'locationMessage') {
+            normalized.location = {
+                latitude: messageContent.degreesLatitude,
+                longitude: messageContent.degreesLongitude
+            };
+        }
+    }
+
+    /** @private Extrai os dados de uma resposta interativa (botão/lista). */
+    static _extractInteractiveReply(message) {
+        const buttonReply = message?.buttonsResponseMessage;
+        if (buttonReply) return { id: buttonReply.selectedButtonId, text: buttonReply.selectedDisplayText };
+
+        const listReply = message?.listResponseMessage;
+        if (listReply) return { id: listReply.singleSelectReply?.selectedRowId, text: listReply.title };
+
+        return null;
+    }
+
+    /** @private Extrai os dados de uma reação a uma mensagem. */
+    static _extractReaction(message) {
+        const reaction = message?.reactionMessage;
+        if (!reaction) return null;
+        return {
+            emoji: reaction.text,
+            reactedMessageId: reaction.key.id,
+            senderTimestamp: new Date(Number(reaction.senderTimestampMs))
+        };
+    }
+
+    /** @private Extrai os dados de um voto em uma enquete (descriptografado). */
+    static async _extractPollUpdate(msg, client) {
+        const isGroup = msg.key.remoteJid.endsWith('@g.us');
+        const clientJid = client.jidNormalizedUser(client.sock.user.id);
+
+        const message = msg.message;
+        const pollUpdate = message?.pollUpdateMessage;
+        if (!pollUpdate || !pollUpdate.pollCreationMessageKey) return null;
+        let creationMsg = null;
+        let pollEncKeyBuffer = null;
+        let decryptPollVoteParams = null;
+        try {
+            // Recupera a mensagem de criação da enquete diretamente da store 
+            creationMsg = await client.store.getMessage(
+                pollUpdate.pollCreationMessageKey.remoteJid,
+                pollUpdate.pollCreationMessageKey.id
+            );
+            creationMsg.raw.message.pollCreationMessage = creationMsg.raw.message.pollCreationMessage ? creationMsg.raw.message.pollCreationMessage :
+                creationMsg.raw.message.pollCreationMessageV3;
+
+            // Verifica se a mensagem de criação existe e tem a estrutura correta
+            if (!creationMsg) {
+                console.warn("Mensagem de criação da enquete não encontrada na store ou sem estrutura válida");
+                return {
+                    pollCreationMessageId: pollUpdate.pollCreationMessageKey?.id,
+                    voterTimestamp: new Date(Number(pollUpdate.senderTimestampMs)),
+                    selectedOptions: [],
+                    error: "Poll creation message not found"
+                };
+            }
+
+            if (!creationMsg || !creationMsg.raw.message.pollCreationMessage) {
+                console.warn("Mensagem de criação da enquete sem estrutura válida");
+                return {
+                    pollCreationMessageId: pollUpdate.pollCreationMessageKey?.id,
+                    voterTimestamp: new Date(Number(pollUpdate.senderTimestampMs)),
+                    selectedOptions: [],
+                    error: "Mensagem de criação da enquete sem estrutura válida"
+                };
+            }
+
+            // Verifica se temos os dados necessários para descriptografia
+            if (!creationMsg.raw.message.messageContextInfo.messageSecret ||
+                !creationMsg.raw.message.pollCreationMessage.name ||
+                !creationMsg.raw.message.pollCreationMessage.options) {
+                console.warn("Mensagem de criação da enquete não contém dados necessários para descriptografia");
+                return {
+                    pollCreationMessageId: pollUpdate.pollCreationMessageKey?.id,
+                    voterTimestamp: new Date(Number(pollUpdate.senderTimestampMs)),
+                    selectedOptions: [],
+                    error: "Incomplete poll creation data"
+                };
+            }
+
+            pollEncKeyBuffer = Buffer.from(Object.values(creationMsg.raw.message.messageContextInfo.messageSecret));
+            decryptPollVoteParams = {
+                pollCreatorJid: creationMsg.raw.key.remoteJid,
+                pollMsgId: creationMsg.raw.key.id,
+                pollEncKey: pollEncKeyBuffer,
+                voterJid: isGroup ? msg.key.participant : msg.key.fromMe ? clientJid : msg.key.remoteJid,
+            };
+            // Descriptografa os votos usando a mensagem bruta da store
+            const decrypted = await client.decryptPollVote(pollUpdate.vote, decryptPollVoteParams);
+
+            const selectedOptions = [];
+            for (const decryptedHash of decrypted.selectedOptions) {
+                const hashHex = Buffer.from(decryptedHash).toString('hex').toUpperCase();
+                for (const option of creationMsg.raw.message.pollCreationMessage?.options || []) {
+                    const hash = Buffer.from(digestSync("SHA-256", new TextEncoder().encode(Buffer.from(option.optionName).toString())))
+                        .toString("hex")
+                        .toUpperCase();
+                    if (hashHex === hash) {
+                        selectedOptions.push(option.optionName);
+                        break;
+                    }
+                }
+            }
+
+            return {
+                pollCreationMessageId: pollUpdate.pollCreationMessageKey?.id,
+                voterTimestamp: new Date(Number(pollUpdate.senderTimestampMs)),
+                selectedOptions,
+                success: selectedOptions.length > 0
+            };
+        } catch (err) {
+            console.error("Erro ao descriptografar voto:", err.message, {
+                msg,
+                pollUpdateMessage: pollUpdate,
+                decryptPollVoteParams,
+                errorStack: err.stack
+            });
+
+            return {
+                pollCreationMessageId: pollUpdate.pollCreationMessageKey?.id,
+                voterTimestamp: new Date(Number(pollUpdate.senderTimestampMs)),
+                selectedOptions: [],
+                error: err.message,
+                code: err.code
+            };
+        }
+    }
+
+    /** @private Extrai os dados de uma mensagem de criação de enquete. */
+    static _extractPollCreation(raw) {
+        const message = raw.message;
+        const poll = message?.pollCreationMessage || message.pollCreationMessageV3;
+        if (!poll) return null
+
+        return {
+            id: raw.key.id,
+            creator: {
+                jid: raw.key.remoteJid,
+                pushName: raw.pushName,
+                verifiedBizName: raw.verifiedBizName
+            },
+            name: poll.name,
+            selectableOptionsCount: poll.selectableOptionsCount,
+            allowsMultipleAnswers: poll.selectableOptionsCount > 1,
+            options: (poll.options || []).map(opt => ({
+                name: opt.optionName || null,
+                hash: opt.optionHash || null
+            })),
+            messageSecret: message.messageContextInfo?.messageSecret,
+            senderTimestamp: poll.messageTimestamp
+                ? new Date(Number(poll.messageTimestamp) * 1000)
+                : null,
+            raw: poll
+        }
+    }
+
+    /** @private Extrai os dados de contatos enviados. */
+    static _extractContacts(message) {
+        const parseVcard = (vcard = '') => {
+            const nameMatch = vcard.match(/FN:(.+)/);
+            const numberMatch = vcard.match(/waid=(\d+)/);
+            return {
+                name: (nameMatch ? nameMatch[1] : '').replace(/\\/g, ''),
+                number: numberMatch ? numberMatch[1] : ''
+            };
+        };
+
+        const singleContact = message?.contactMessage;
+        if (singleContact) return [parseVcard(singleContact.vcard)];
+
+        const multiContact = message?.contactsArrayMessage?.contacts;
+        if (multiContact) return multiContact.map(c => parseVcard(c.vcard));
+
+        return [];
+    }
+}
+
+module.exports = MessageNormalizer;