@areumtecnologia/wasockets 2.3.1 → 2.3.3

package/README.md

@@ -288,22 +288,37 @@ await ctx.unstar();
 ```
 
 #### Utilitários de Mídia (`MediaObject`):
-Se a mensagem contiver imagem, vídeo, áudio ou documento, `ctx.media` fornece métodos instantâneos:
+Se a mensagem contiver imagem, vídeo, áudio, figurinha ou documento, `ctx.media` centraliza todos os metadados e métodos de manipulação em uma única instância:
 
+##### Propriedades de `ctx.media`:
+- `ctx.media.mimetype`: Tipo MIME real (ex: `'image/jpeg'`, `'audio/ogg; codecs=opus'`).
+- `ctx.media.extension`: Extensão inferida do arquivo (ex: `'jpg'`, `'ogg'`, `'pdf'`, `'mp4'`).
+- `ctx.media.fileLength`: Tamanho do arquivo em bytes.
+- `ctx.media.fileName`: Nome original do arquivo (se enviado como documento).
+- `ctx.media.caption`: Legenda de texto anexada à mídia.
+- `ctx.media.seconds` / `duration`: Duração em segundos (para áudios e vídeos).
+- `ctx.media.isVoice` / `isPtt`: Booleano se é áudio gravado no WhatsApp (Push-To-Talk).
+- `ctx.media.isGif`: Booleano se é vídeo reproduzido como GIF animado.
+- `ctx.media.isViewOnce`: Booleano se é mídia de visualização única.
+
+##### Métodos de `ctx.media`:
 ```javascript
 if (ctx.media) {
-    // 1. Salva diretamente em disco
+    // 1. Salva diretamente em disco (cria diretórios se não existirem)
     await ctx.media.save('./pasta/comprovante.pdf');
 
-    // 2. Converte para Base64 (ideal para enviar para APIs de IA ou frontend)
-    const base64 = ctx.media.toBase64();
-    const dataUri = ctx.media.toDataUri(); // 'data:image/jpeg;base64,...'
+    // 2. Obtém como Buffer em memória (com cache automático)
+    const buffer = await ctx.media.toBuffer();
+
+    // 3. Converte para Base64 (ideal para LLMs como Gemini / OpenAI)
+    const base64 = await ctx.media.toBase64();
+    const dataUri = await ctx.media.toDataUri(); // 'data:image/jpeg;base64,...'
 
-    // 3. Obtém como Stream legível (Node Readable)
-    const stream = ctx.media.toStream();
+    // 4. Obtém como Stream legível (Node Readable)
+    const stream = await ctx.media.toStream();
 
-    // 4. Integração nativa com Sharp (se instalado) para redimensionamento/corte
-    const sharpInstance = ctx.media.toSharp();
+    // 5. Integração nativa com Sharp (se instalado) para recorte/redimensionamento
+    const sharpInstance = await ctx.media.toSharp();
 }
 ```
 

package/lib/Client/Context/MediaObject.js

@@ -19,8 +19,14 @@ class MediaObject {
         this.mimetype = this.mediaNode.mimetype || this._defaultMimetype(this.mediaType)
         this.fileLength = Number(this.mediaNode.fileLength || 0)
         this.fileName = this.mediaNode.fileName || ''
+        this.caption = this.mediaNode.caption || ''
         this.seconds = Number(this.mediaNode.seconds || 0)
+        this.duration = this.seconds || null
+
         this.isVoice = Boolean(this.mediaNode.ptt)
+        this.isPtt = this.isVoice
+        this.isGif = Boolean(this.mediaNode.gifPlayback)
+        this.isViewOnce = Boolean(this.mediaNode.viewOnce)
         this.isAnimated = Boolean(this.mediaNode.gifPlayback || this.mediaNode.isAnimated)
         this.extension = this._inferExtension()
 

package/lib/Client/Context/MessageContext.js

@@ -26,11 +26,13 @@ class MessageContext {
 
         const effectiveMessage = editedMsg || rawMessage?.message || null
 
-        // 2. Identity and Routing
+        // 2. Single-pass message unwrapping (eliminates repeated while-loops)
+        const unwrapped = MessageNormalizer.unwrapMessage(effectiveMessage)
+
+        // 3. Identity and Routing
         this.id = effectiveKey.id || rawMessage?.key?.id || ''
         this.chatId = effectiveKey.remoteJid || rawMessage?.key?.remoteJid || ''
         this.fromMe = Boolean(effectiveKey.fromMe)
-        this.isFromMe = this.fromMe
 
         this.isGroup = JidNormalizer.isGroup(this.chatId)
         this.isChannel = JidNormalizer.isNewsletter(this.chatId)
@@ -54,10 +56,7 @@ class MessageContext {
             this.fromPushName = rawMessage?.pushName || JidNormalizer.toPhoneNumber(this.from) || 'Desconhecido'
         }
 
-        this.sender = this.from
         this.fromNumber = JidNormalizer.toPhoneNumber(this.from)
-        this.senderNumber = this.fromNumber
-        this.senderName = this.fromPushName
 
         // Timestamps
         const rawTs = Number(rawMessage?.messageTimestamp || Math.floor(Date.now() / 1000))
@@ -66,25 +65,22 @@ class MessageContext {
             ? new Date(Number(rawMessage.message.protocolMessage.timestampMs || Date.now()))
             : null
 
-        // 3. Content Decoupling & Typed Parsers
-        this.type = MessageNormalizer.extractType(effectiveMessage)
-        this.body = MessageNormalizer.extractBody(effectiveMessage)
-        this.interactiveReply = MessageNormalizer.extractInteractiveReply(effectiveMessage)
-        this.contacts = MessageNormalizer.extractContacts(effectiveMessage)
-        this.location = MessageNormalizer.extractLocation(effectiveMessage)
-        this.reaction = MessageNormalizer.extractReaction(effectiveMessage)
-        this.poll = MessageNormalizer.extractPollCreation(effectiveMessage, rawMessage)
-
-        // 4. Media Normalization
-        this.mediaNode = MessageNormalizer.extractMediaNode(effectiveMessage)
-        this.hasMedia = Boolean(this.mediaNode)
-        this.media = this.hasMedia ? new MediaObject(this.mediaNode, this.type) : null
-        this.mediaDetails = MessageNormalizer.extractMediaDetails(effectiveMessage)
-
-        // 5. Context Info, Mentions & Forwarding
-        this.contextInfo = MessageNormalizer.extractContextInfo(effectiveMessage)
+        // 4. Content Decoupling & Typed Parsers (Single-pass unwrapped nodes)
+        this.type = MessageNormalizer.extractType(unwrapped)
+        this.body = MessageNormalizer.extractBody(unwrapped)
+        this.interactiveReply = MessageNormalizer.extractInteractiveReply(unwrapped)
+        this.contacts = MessageNormalizer.extractContacts(unwrapped)
+        this.location = MessageNormalizer.extractLocation(unwrapped)
+        this.reaction = MessageNormalizer.extractReaction(unwrapped)
+        this.poll = MessageNormalizer.extractPollCreation(unwrapped, rawMessage)
+
+        // 5. Media Normalization (Centralized directly into MediaObject)
+        this.mediaNode = MessageNormalizer.extractMediaNode(unwrapped)
+        this.media = this.mediaNode ? new MediaObject(this.mediaNode, this.type) : null
+
+        // 6. Context Info, Mentions & Forwarding
+        this.contextInfo = MessageNormalizer.extractContextInfo(unwrapped)
         this.mentions = this.contextInfo?.mentionedJid || []
-        this.mentionedJids = this.mentions
         this.isForwarded = Boolean(this.contextInfo?.isForwarded)
         this.forwardingScore = Number(this.contextInfo?.forwardingScore || 0)
 
@@ -94,7 +90,7 @@ class MessageContext {
             (clientLid && this.mentions.includes(clientLid))
         )
 
-        // 6. Quoted Message Parsing (Recursion with depth limit 1)
+        // 7. Quoted Message Parsing (Recursion with depth limit 1)
         this.isReply = Boolean(this.contextInfo?.quotedMessage)
         this.quoted = null
 
@@ -125,6 +121,58 @@ class MessageContext {
         }
     }
 
+    // ==========================================
+    // Zero-Cost Memory Aliases & Compatibility Getters
+    // ==========================================
+
+    /** Alias for this.fromMe */
+    get isFromMe() {
+        return this.fromMe
+    }
+
+    /** Alias for this.from */
+    get sender() {
+        return this.from
+    }
+
+    /** Alias for this.fromNumber */
+    get senderNumber() {
+        return this.fromNumber
+    }
+
+    /** Alias for this.fromPushName */
+    get senderName() {
+        return this.fromPushName
+    }
+
+    /** Alias for this.mentions */
+    get mentionedJids() {
+        return this.mentions
+    }
+
+    /** Boolean check whether message contains media */
+    get hasMedia() {
+        return Boolean(this.media)
+    }
+
+    /** Backward-compatible media details accessor backed by MediaObject */
+    get mediaDetails() {
+        if (!this.media) return null
+        return {
+            mimetype: this.media.mimetype,
+            fileName: this.media.fileName,
+            caption: this.media.caption,
+            duration: this.media.duration,
+            isPtt: this.media.isPtt,
+            isGif: this.media.isGif,
+            isViewOnce: this.media.isViewOnce
+        }
+    }
+
+    // ==========================================
+    // Context Action Methods
+    // ==========================================
+
     /**
      * Responde citando esta mensagem automaticamente
      * @param {string|Object} content - Texto ou payload de mensagem

package/lib/Client/Normalizers/EventNormalizer.js

@@ -23,12 +23,13 @@ class EventNormalizer {
                 // Ignore stub or protocol messages if completely empty
                 if (!rawMsg.message && !rawMsg.messageStubType) continue
 
-                // Handle protocol revoke messages explicitly
+                // Handle protocol revoke messages explicitly (delete for everyone)
                 const isRevoke = rawMsg.message?.protocolMessage?.type === 0
                 if (isRevoke) {
                     client.emit(Events.MESSAGE_DELETE, {
                         keys: [rawMsg.message.protocolMessage.key || rawMsg.key]
                     })
+                    continue // Do not emit as a new received/sent message
                 }
 
                 const ctx = new MessageContext(client, rawMsg)

package/lib/Client/index.d.ts

@@ -58,8 +58,13 @@ export declare class MediaObject {
     mimetype: string
     fileLength: number
     fileName: string
+    caption: string
     seconds: number
+    duration: number | null
     isVoice: boolean
+    isPtt: boolean
+    isGif: boolean
+    isViewOnce: boolean
     isAnimated: boolean
     extension: string
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@areumtecnologia/wasockets",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "whatsappVersion": "2.3000.1053049953",
   "description": "Communication Library By areumtecnologia",
   "keywords": [],