@areumtecnologia/wasockets 2.2.3 → 2.3.0

package/lib/Client/Normalizers/EventNormalizer.js

@@ -0,0 +1,82 @@
+"use strict"
+
+Object.defineProperty(exports, "__esModule", { value: true })
+
+const { Events } = require("../Constants")
+const { MessageContext } = require("../Context/MessageContext")
+const { CallContext } = require("../Context/CallContext")
+
+class EventNormalizer {
+    /**
+     * Binds low-level socket events and maps them to semantic WaClient events
+     * @param {import('../WaClient').WaClient} client
+     */
+    static bindSocketEvents(client) {
+        const sock = client.sock
+        if (!sock || !sock.ev) return
+
+        // 1. Message reception and outgoing events
+        sock.ev.on('messages.upsert', async ({ messages, type }) => {
+            if (!Array.isArray(messages)) return
+
+            for (const rawMsg of messages) {
+                // Ignore stub or protocol messages if empty
+                if (!rawMsg.message && !rawMsg.messageStubType) continue
+
+                const ctx = new MessageContext(client, rawMsg)
+
+                if (ctx.isFromMe) {
+                    client.emit(Events.MESSAGE_SENT, ctx, rawMsg)
+                } else {
+                    client.emit(Events.MESSAGE_RECEIVED, ctx, rawMsg)
+                }
+            }
+        })
+
+        // 2. Message updates (reactions, poll updates, edits, delivery/read receipts)
+        sock.ev.on('messages.update', (updates) => {
+            client.emit(Events.MESSAGE_UPDATE, updates)
+        })
+
+        // 3. Message deletion (revoke)
+        sock.ev.on('messages.delete', (item) => {
+            client.emit(Events.MESSAGE_DELETE, item)
+        })
+
+        // 4. Presence updates (typing, online, offline)
+        sock.ev.on('presence.update', (presence) => {
+            client.emit(Events.PRESENCE_UPDATE, presence)
+        })
+
+        // 5. Contacts upsert
+        sock.ev.on('contacts.upsert', (contacts) => {
+            client.emit(Events.CONTACTS_UPSERT, contacts)
+        })
+
+        // 6. Group participants updates (join, leave, promote, demote)
+        sock.ev.on('group-participants.update', (update) => {
+            client.emit(Events.GROUP_PARTICIPANTS_UPDATE, update)
+        })
+
+        // 7. VoIP incoming calls & status
+        sock.ev.on('call.received', (incomingCall) => {
+            const callCtx = new CallContext(client, incomingCall)
+            client.emit(Events.CALL_INCOMING, callCtx)
+        })
+
+        sock.ev.on('call', (calls) => {
+            client.emit(Events.CALL_STATUS, calls)
+            if (Array.isArray(calls)) {
+                for (const call of calls) {
+                    if (call.status === 'offer') {
+                        const callCtx = new CallContext(client, call)
+                        client.emit(Events.CALL_INCOMING, callCtx)
+                    }
+                }
+            }
+        })
+    }
+}
+
+exports.EventNormalizer = EventNormalizer
+exports.default = EventNormalizer

package/lib/Client/Normalizers/JidNormalizer.js

@@ -0,0 +1,93 @@
+"use strict"
+
+Object.defineProperty(exports, "__esModule", { value: true })
+
+class JidNormalizer {
+    /**
+     * Sanitizes and normalizes any phone number or JID string into a canonical JID
+     * @param {string} input - Phone number (e.g., "+55 (11) 99999-9999") or existing JID
+     * @returns {string} Normalized JID (e.g., "5511999999999@s.whatsapp.net")
+     */
+    static toJid(input) {
+        if (!input || typeof input !== 'string') return ''
+        const cleaned = input.trim()
+
+        if (cleaned.includes('@')) {
+            return cleaned
+        }
+
+        const digits = cleaned.replace(/\D/g, '')
+        if (!digits) return ''
+
+        return `${digits}@s.whatsapp.net`
+    }
+
+    /**
+     * Extracts pure numeric phone number from a JID
+     * @param {string} jid - WhatsApp JID
+     * @returns {string} Extracted phone number or empty string
+     */
+    static toPhoneNumber(jid) {
+        if (!jid || typeof jid !== 'string') return ''
+        const base = jid.split('@')[0]
+        const withoutDevice = base.split(':')[0]
+        return withoutDevice.replace(/\D/g, '')
+    }
+
+    /**
+     * Checks if JID represents a WhatsApp Group
+     * @param {string} jid
+     * @returns {boolean}
+     */
+    static isGroup(jid) {
+        return typeof jid === 'string' && jid.endsWith('@g.us')
+    }
+
+    /**
+     * Checks if JID represents a WhatsApp Channel / Newsletter
+     * @param {string} jid
+     * @returns {boolean}
+     */
+    static isNewsletter(jid) {
+        return typeof jid === 'string' && jid.endsWith('@newsletter')
+    }
+
+    /**
+     * Checks if JID is an internal LID (Linked Identity)
+     * @param {string} jid
+     * @returns {boolean}
+     */
+    static isLid(jid) {
+        return typeof jid === 'string' && jid.endsWith('@lid')
+    }
+
+    /**
+     * Checks if JID is a regular user chat (Phone Number based)
+     * @param {string} jid
+     * @returns {boolean}
+     */
+    static isUser(jid) {
+        return typeof jid === 'string' && jid.endsWith('@s.whatsapp.net')
+    }
+
+    /**
+     * Checks if JID represents WhatsApp Status Broadcast
+     * @param {string} jid
+     * @returns {boolean}
+     */
+    static isStatusBroadcast(jid) {
+        return typeof jid === 'string' && jid === 'status@broadcast'
+    }
+
+    /**
+     * Checks if JID represents any Broadcast list
+     * @param {string} jid
+     * @returns {boolean}
+     */
+    static isBroadcast(jid) {
+        return typeof jid === 'string' && jid.endsWith('@broadcast')
+    }
+}
+
+exports.JidNormalizer = JidNormalizer
+exports.default = JidNormalizer

package/lib/Client/Normalizers/MessageNormalizer.js

@@ -0,0 +1,134 @@
+"use strict"
+
+Object.defineProperty(exports, "__esModule", { value: true })
+
+class MessageNormalizer {
+    /**
+     * Unwraps container wrappers (ephemeral, viewOnce, documentWithCaption, etc.)
+     * @param {Object} rawMessageContent - raw message node from proto
+     * @returns {Object} Unwrapped message object
+     */
+    static unwrapMessage(rawMessageContent) {
+        if (!rawMessageContent) return null
+
+        let msg = rawMessageContent
+        while (
+            msg.ephemeralMessage ||
+            msg.viewOnceMessage ||
+            msg.viewOnceMessageV2 ||
+            msg.viewOnceMessageV2Extension ||
+            msg.documentWithCaptionMessage
+        ) {
+            msg =
+                msg.ephemeralMessage?.message ||
+                msg.viewOnceMessage?.message ||
+                msg.viewOnceMessageV2?.message ||
+                msg.viewOnceMessageV2Extension?.message ||
+                msg.documentWithCaptionMessage?.message ||
+                msg
+        }
+
+        return msg
+    }
+
+    /**
+     * Identifies the primary content type of the message
+     * @param {Object} messageContent - Unwrapped message content
+     * @returns {string} Normalized type (e.g., 'text', 'image', 'video', 'audio', etc.)
+     */
+    static extractType(messageContent) {
+        const msg = this.unwrapMessage(messageContent)
+        if (!msg) return 'unknown'
+
+        if (msg.conversation || msg.extendedTextMessage) return 'text'
+        if (msg.imageMessage) return 'image'
+        if (msg.videoMessage) return msg.videoMessage.gifPlayback ? 'gif' : 'video'
+        if (msg.audioMessage) return msg.audioMessage.ptt ? 'voice' : 'audio'
+        if (msg.documentMessage) return 'document'
+        if (msg.stickerMessage) return 'sticker'
+        if (msg.contactMessage || msg.contactsArrayMessage) return 'contact'
+        if (msg.locationMessage || msg.liveLocationMessage) return 'location'
+        if (msg.pollCreationMessage || msg.pollCreationMessageV2 || msg.pollCreationMessageV3) return 'poll'
+        if (msg.reactionMessage) return 'reaction'
+        if (msg.interactiveMessage || msg.interactiveResponseMessage) return 'interactive'
+        if (msg.buttonsResponseMessage || msg.templateButtonReplyMessage) return 'button_reply'
+        if (msg.listResponseMessage) return 'list_reply'
+        if (msg.protocolMessage) return 'protocol'
+
+        const keys = Object.keys(msg).filter(k => k !== 'messageContextInfo' && k !== 'senderKeyDistributionMessage')
+        return keys[0] ? keys[0].replace('Message', '').toLowerCase() : 'unknown'
+    }
+
+    /**
+     * Extracts readable text content across diverse message structures
+     * @param {Object} messageContent - Unwrapped message content
+     * @returns {string} Text body
+     */
+    static extractBody(messageContent) {
+        const msg = this.unwrapMessage(messageContent)
+        if (!msg) return ''
+
+        if (msg.conversation) return msg.conversation
+        if (msg.extendedTextMessage?.text) return msg.extendedTextMessage.text
+        if (msg.imageMessage?.caption) return msg.imageMessage.caption
+        if (msg.videoMessage?.caption) return msg.videoMessage.caption
+        if (msg.documentMessage?.caption) return msg.documentMessage.caption
+        if (msg.buttonsResponseMessage?.selectedDisplayText) return msg.buttonsResponseMessage.selectedDisplayText
+        if (msg.listResponseMessage?.title) return msg.listResponseMessage.title
+        if (msg.templateButtonReplyMessage?.selectedId) return msg.templateButtonReplyMessage.selectedId
+        if (msg.interactiveResponseMessage?.nativeFlowResponseMessage?.paramsJson) {
+            return msg.interactiveResponseMessage.nativeFlowResponseMessage.paramsJson
+        }
+        if (msg.pollCreationMessage?.name) return msg.pollCreationMessage.name
+        if (msg.pollCreationMessageV2?.name) return msg.pollCreationMessageV2.name
+        if (msg.pollCreationMessageV3?.name) return msg.pollCreationMessageV3.name
+        if (msg.reactionMessage?.text) return msg.reactionMessage.text
+
+        return ''
+    }
+
+    /**
+     * Extracts media node if present
+     * @param {Object} messageContent - Unwrapped message content
+     * @returns {Object|null}
+     */
+    static extractMediaNode(messageContent) {
+        const msg = this.unwrapMessage(messageContent)
+        if (!msg) return null
+
+        return (
+            msg.imageMessage ||
+            msg.videoMessage ||
+            msg.audioMessage ||
+            msg.documentMessage ||
+            msg.stickerMessage ||
+            null
+        )
+    }
+
+    /**
+     * Extracts quoted message context info
+     * @param {Object} messageContent - Unwrapped message content
+     * @returns {Object|null}
+     */
+    static extractContextInfo(messageContent) {
+        const msg = this.unwrapMessage(messageContent)
+        if (!msg) return null
+
+        return (
+            msg.extendedTextMessage?.contextInfo ||
+            msg.imageMessage?.contextInfo ||
+            msg.videoMessage?.contextInfo ||
+            msg.audioMessage?.contextInfo ||
+            msg.documentMessage?.contextInfo ||
+            msg.stickerMessage?.contextInfo ||
+            msg.buttonsResponseMessage?.contextInfo ||
+            msg.listResponseMessage?.contextInfo ||
+            msg.interactiveResponseMessage?.contextInfo ||
+            null
+        )
+    }
+}
+
+exports.MessageNormalizer = MessageNormalizer
+exports.default = MessageNormalizer