@areumtecnologia/wasockets 1.1.5 → 1.1.6

package/README.md

@@ -30,6 +30,12 @@ O **WaSockets** foi criado para resolver problemas crônicos de estabilidade e a
 | **Mídia** | Correções de Miniaturas e Status | Correção de falhas na extração de miniaturas (`extractImageThumb`), na geração de previews de links, no envio de mídias em álbuns/vídeos e na publicação de mídias em status de grupos. |
 | **Newsletters (Canais)** | Consulta de Canais Inscritos | Adicionado o método exclusivo `newsletterSubscribed` que lista todos os canais de transmissão (Newsletters) aos quais o usuário está inscrito. |
 | **Mensagens de Negócios** | Botões Interativos & PIX | Suporte avançado para layouts de botões interativos, botões Cards (com imagem/vídeo), suporte para botões PIX estáticos e fluxos completos de checkout e pagamento (`review_and_pay`). |
+| **Recursos Web (v1.1.6)** | Fixação com Duração | Fixação de mensagens com durações configuráveis (24h, 7d, 30d) usando `pinInChatMessage` e `messageAddOnDurationInSecs`. |
+| **Recursos Web (v1.1.6)** | Reação a Status | Método nativo `reactToStatus` para curtir e reagir diretamente a publicações de Status. |
+| **Recursos Web (v1.1.6)** | Eventos & RSVP | Criação, cancelamento (`cancelEvent`) e confirmação de presença (`sendEventResponse`) em eventos de grupo. |
+| **Recursos Web (v1.1.6)** | Favoritos & Notas de Contato | Sincronização via App State de chats favoritos (`updateFavorite`) e anotações internas de contatos (`updateChatNote`). |
+| **Recursos Web (v1.1.6)** | Chamadas Web (Web Calling) | Sinalização completa de chamadas no navegador (`offerCall`, `acceptCall`, `terminateCall`, `rejectCall`). |
+| **Recursos Web (v1.1.6)** | Resolução Reversa de LID | Consulta reversa USync para obter o número de telefone a partir de um identificador `@lid` (`getPnUser`). |
 
 ---
 
@@ -52,8 +58,14 @@ O **WaSockets** foi criado para resolver problemas crônicos de estabilidade e a
   - [Botões Interativos](#botões-interativos)
   - [Botão de Pagamento PIX](#botão-de-pagamento-pix)
   - [Fluxos de Checkout (PAY)](#fluxos-de-checkout-pay)
-  - [Menção em Status](#menção-em-status)
+  - [Menção em Status e Reações](#menção-em-status-e-reações)
+  - [Comentários em Canais e Comunidades](#comentários-em-canais-e-comunidades)
 - [Modificando Mensagens e Chats](#-modificando-mensagens-e-chats)
+  - [Fixação de Mensagens com Duração](#fixação-de-mensagens-com-duração)
+  - [Favoritos e Anotações de Contato](#favoritos-e-anotações-de-contato)
+- [Eventos em Grupos e RSVP](#-eventos-em-grupos-e-rsvp)
+- [Chamadas Web (Web Calling)](#-chamadas-web-web-calling)
+- [Resolução de Usuários (LID e Telefone)](#-resolução-de-usuários-lid-e-telefone)
 - [Gerenciamento de Grupos](#-gerenciamento-de-grupos)
 - [Newsletters (Canais)](#-newsletters-canais)
 - [Configurações de Privacidade](#-configurações-de-privacidade)
@@ -508,6 +520,22 @@ await sock.sendStatusMentions(
     },
     contatosParaMencionar
 )
+
+// Curtir / Reagir diretamente a uma publicação de Status (Stories)
+await sock.reactToStatus(statusMsgKey, '❤️')
+```
+
+### Comentários em Canais e Comunidades
+
+Envie respostas e comentários estruturados em postagens de canais (Newsletters) ou mensagens de aviso em comunidades:
+
+```javascript
+await sock.sendMessage(jid, {
+    comment: {
+        targetMessageKey: mensagemOriginal.key,
+        message: { text: 'Excelente atualização! 👏' }
+    }
+})
 ```
 
 ---
@@ -537,10 +565,114 @@ await sock.chatModify({ mute: null }, jid)
 // Marcar chat como Não Lido
 await sock.chatModify({ markRead: false, lastMessages: [msg] }, jid)
 
-// Fixar chat na lista
+// Fixar chat na lista de conversas
 await sock.chatModify({ pin: true }, jid)
 ```
 
+### Fixação de Mensagens com Duração
+
+Fixe mensagens em conversas individuais ou grupos escolhendo a duração desejada:
+
+```javascript
+// Fixar mensagem por 7 dias (604800 segundos)
+// Durações padrão: 86400 (24h), 604800 (7 dias), 2592000 (30 dias)
+await sock.sendMessage(jid, {
+    pin: {
+        key: msg.key,
+        type: 1, // 1: Fixar, 2: Desafixar
+        time: 604800
+    }
+})
+
+// Desafixar mensagem
+await sock.sendMessage(jid, {
+    pin: {
+        key: msg.key,
+        type: 2
+    }
+})
+```
+
+### Favoritos e Anotações de Contato
+
+Organize suas conversas sincronizando com o WhatsApp Web e celular:
+
+```javascript
+// Marcar conversa como Favorita
+await sock.updateFavorite(jid, true)
+
+// Desmarcar conversa como Favorita
+await sock.updateFavorite(jid, false)
+
+// Adicionar ou atualizar nota interna no contato (Chat Note)
+await sock.updateChatNote(jid, 'Cliente solicitou proposta para 50 atendentes.')
+
+// Remover nota interna do contato
+await sock.removeChatNote(jid)
+```
+
+---
+
+## 📅 Eventos em Grupos e RSVP
+
+Crie eventos colaborativos, responda confirmações de presença e cancele eventos:
+
+```javascript
+// 1. Criar um novo evento no grupo
+const evento = await sock.sendMessage(grupoJid, {
+    event: {
+        name: 'Reunião de Planejamento de Sprints',
+        description: 'Alinhamento estratégico dos projetos da Áreum Tecnologia.',
+        startTime: Math.floor(Date.now() / 1000) + 86400, // Amanhã
+        extraGuestsAllowed: true
+    }
+})
+
+// 2. Responder ao Evento (RSVP)
+// Tipos de resposta: 'GOING' (1), 'NOT_GOING' (2), 'MAYBE' (3)
+await sock.sendEventResponse(grupoJid, evento.key, 'GOING', 1 /* +1 convidado extra */)
+
+// 3. Cancelar o Evento
+await sock.cancelEvent(grupoJid, evento.key)
+```
+
+---
+
+## 📞 Chamadas Web (Web Calling)
+
+Gerencie o ciclo completo de sinalização de chamadas de voz e vídeo:
+
+```javascript
+// Iniciar uma chamada (áudio ou vídeo)
+const chamada = await sock.offerCall('5511999999999@s.whatsapp.net', false /* isVideo */)
+console.log('ID da chamada:', chamada.id)
+
+// Atender uma chamada recebida
+await sock.acceptCall(callId, callerJid)
+
+// Encerrar uma chamada em andamento
+await sock.terminateCall(callId, callerJid)
+
+// Rejeitar uma chamada recebida
+await sock.rejectCall(callId, callerJid)
+```
+
+---
+
+## 🔍 Resolução de Usuários (LID e Telefone)
+
+Com a evolução da privacidade no WhatsApp, participantes de grupos e canais frequentemente utilizam identificadores `@lid`. O **WaSockets** permite resolução bidirecional:
+
+```javascript
+// Obter o identificador LID a partir de um número de telefone (PN)
+const [lidUser] = await sock.getLidUser('5511999999999@s.whatsapp.net')
+console.log('LID do usuário:', lidUser)
+
+// Obter o número de telefone a partir de um @lid recebido em grupo
+const [pnUser] = await sock.getPnUser('12345678901234@lid')
+console.log('Número de telefone real:', pnUser?.phone_number)
+```
+
 ---
 
 ## 🏷️ Etiquetas de Negócio (Labels - WhatsApp Business)

package/lib/Socket/chats.js

@@ -30,6 +30,7 @@ const {
 const { makeMutex } = require("../Utils/make-mutex")
 const {
   isPnUser, 
+  isLidUser, 
   getBinaryNodeChild, 
   getBinaryNodeChildren, 
   jidDecode, 
@@ -257,6 +258,39 @@ const makeChatsSocket = (config) => {
         }
     }
     
+    const getPnUser = async (jid) => {
+        if (!jid) {
+            throw new Boom('Please input a jid user')
+        }
+        
+        if (!isLidUser(jid)) {
+            throw new Boom('Invalid JID: Not a LID user!')
+        }
+        
+        const targetJid = jidNormalizedUser(jid)
+        
+        const usyncQuery = new USyncQuery()
+        usyncQuery.protocols.push({
+            name: 'phone_number',
+            getQueryElement: () => ({
+                tag: 'phone_number',
+                attrs: {},
+                content: undefined
+            }),
+            getUserElement: () => null,
+            parser: (node) => node.attrs.phone_number || node.attrs.val
+        })
+        usyncQuery.users.push({
+            id: targetJid
+        })
+        
+        const result = await suki.executeUSyncQuery(usyncQuery)
+        
+        if (result) {
+            return result.list
+        }
+    }
+    
     const fetchStatus = async (...jids) => {
         const usyncQuery = new USyncQuery().withStatusProtocol()
         
@@ -914,6 +948,39 @@ const makeChatsSocket = (config) => {
          }, jid) 
      }
     
+    /**
+     * Set or unset a chat as Favorite
+     */
+    const updateFavorite = (jid, favorite = true) => {
+        return chatModify({
+            favorite
+        }, jid)
+    }
+
+    /**
+     * Add or update a note for a chat (contact notes)
+     */
+    const updateChatNote = (jid, text) => {
+        return chatModify({
+            note: {
+                text,
+                deleted: false,
+                createdAt: Date.now()
+            }
+        }, jid)
+    }
+
+    /**
+     * Remove note for a chat
+     */
+    const removeChatNote = (jid) => {
+        return chatModify({
+            note: {
+                deleted: true
+            }
+        }, jid)
+    }
+    
     /**
      * Adds label
      */
@@ -1257,6 +1324,10 @@ const makeChatsSocket = (config) => {
         appStatePatchMutex, 
         notificationMutex, 
         getLidUser, 
+        getPnUser, 
+        updateFavorite, 
+        updateChatNote, 
+        removeChatNote, 
         fetchBlocklist,
         fetchStatus,
         fetchDisappearingDuration,

package/lib/Socket/messages-recv.js

@@ -302,6 +302,46 @@ const makeMessagesRecvSocket = (config) => {
         await query(stanza)
     }
     
+    const acceptCall = async (callId, callFrom) => {
+        const stanza = ({
+            tag: 'call',
+            attrs: {
+                from: authState.creds.me.id,
+                to: callFrom,
+            },
+            content: [{
+                    tag: 'accept',
+                    attrs: {
+                        'call-id': callId,
+                        'call-creator': callFrom,
+                    },
+                    content: undefined,
+                }],
+        })
+        
+        await query(stanza)
+    }
+
+    const terminateCall = async (callId, callFrom) => {
+        const stanza = ({
+            tag: 'call',
+            attrs: {
+                from: authState.creds.me.id,
+                to: callFrom,
+            },
+            content: [{
+                    tag: 'terminate',
+                    attrs: {
+                        'call-id': callId,
+                        'call-creator': callFrom,
+                    },
+                    content: undefined,
+                }],
+        })
+        
+        await query(stanza)
+    }
+    
     const sendRetryRequest = async (node, forceIncludeKeys = false) => {
         const { fullMessage } = decodeMessageNode(node, authState.creds.me.id, authState.creds.me.lid || '')
         const { key: msgKey } = fullMessage
@@ -1633,6 +1673,8 @@ const makeMessagesRecvSocket = (config) => {
         sendRetryRequest,
         offerCall, 
         rejectCall,
+        acceptCall,
+        terminateCall,
         fetchMessageHistory,
         requestPlaceholderResend,
         messageRetryManager

package/lib/Socket/messages-send.js

@@ -736,7 +736,7 @@ const makeMessagesSocket = (config) => {
                 return
             }
 
-            if (messages.pinInChatMessage || messages.keepInChatMessage || message.reactionMessage || message.protocolMessage?.editedMessage) {
+            if (messages.pinInChatMessage || messages.keepInChatMessage || message.reactionMessage || message.protocolMessage?.editedMessage || message.encEventResponseMessage || message.commentMessage) {
                 extraAttrs['decrypt-fail'] = 'hide'
             } 
 
@@ -1140,9 +1140,15 @@ const makeMessagesSocket = (config) => {
         else if (message.reactionMessage) {
             return 'reaction'
         }       
-        else if (message.eventMessage) {
+        else if (message.eventMessage || message.eventResponseMessage || message.encEventResponseMessage) {
             return 'event'
         }        
+        else if (message.pinInChatMessage) {
+            return 'pin'
+        }
+        else if (message.commentMessage) {
+            return 'comment'
+        }
         else if (getMediaType(message)) {
             return 'media'
         }        
@@ -1609,6 +1615,61 @@ const makeMessagesSocket = (config) => {
 
           return msg
         },
+        reactToStatus: async (key, reaction = '❤️') => {
+            const author = key.participant || key.remoteJid
+            const targetJid = STORIES_JID
+            return relayMessage(
+                targetJid,
+                {
+                    reactionMessage: {
+                        key,
+                        text: reaction,
+                        senderTimestampMs: Date.now()
+                    }
+                },
+                {
+                    messageId: generateMessageID(authState.creds.me.id),
+                    statusJidList: [jidNormalizedUser(author)],
+                    additionalNodes: [
+                        {
+                            tag: 'meta',
+                            attrs: {},
+                            content: [
+                                {
+                                    tag: 'target',
+                                    attrs: {
+                                        chat: targetJid,
+                                        author: jidNormalizedUser(author)
+                                    }
+                                }
+                            ]
+                        }
+                    ]
+                }
+            )
+        },
+        sendEventResponse: async (jid, eventCreationMessageKey, response, extraGuestCount = 0) => {
+            const responseType = typeof response === 'string'
+                ? (proto.Message.EventResponseMessage?.EventResponseType?.[response] ?? 1)
+                : response
+
+            return sendMessage(jid, {
+                eventResponse: {
+                    eventKey: eventCreationMessageKey,
+                    response: responseType,
+                    extraGuestCount,
+                    timestampMs: Date.now()
+                }
+            })
+        },
+        cancelEvent: async (jid, eventKey) => {
+            return sendMessage(jid, {
+                event: {
+                    isCanceled: true
+                },
+                edit: eventKey
+            })
+        },
         sendMessage: async (jid, content, options = {}) => {
             const userJid = authState.creds.me.id
             const additionalAttributes = {}

package/lib/Utils/chat-utils.js

@@ -527,6 +527,38 @@ const chatModificationToAppPatch = (mod, jid) => {
     	}
     }
     
+    else if ('favorite' in mod) {
+        patch = {
+            syncAction: {
+                favoritesAction: {
+                    favorites: mod.favorite ? [{ id: jid }] : []
+                }
+            },
+            index: ['favorites', jid],
+            type: 'regular_low',
+            apiVersion: 1,
+            operation: mod.favorite ? OP.SET : OP.REMOVE
+        }
+    }
+    
+    else if ('note' in mod) {
+        patch = {
+            syncAction: {
+                noteEditAction: {
+                    type: 1,
+                    chatJid: jid,
+                    createdAt: mod.note?.createdAt || Date.now(),
+                    deleted: !!mod.note?.deleted,
+                    unstructuredContent: mod.note?.text || ''
+                }
+            },
+            index: ['note_edit', jid],
+            type: 'regular_low',
+            apiVersion: 1,
+            operation: mod.note?.deleted ? OP.REMOVE : OP.SET
+        }
+    }
+    
     else if ('star' in mod) {
         const key = mod.star.messages[0]
         patch = {
@@ -814,6 +846,25 @@ const processSyncAction = (syncAction, ev, me, initialSyncOpts, logger) => {
         }
     }
     
+    else if (action?.favoritesAction || type === 'favorites') {
+        const isFavorite = (action?.favoritesAction?.favorites?.length || 0) > 0
+        ev.emit('chats.update', [{
+            id,
+            favorite: isFavorite,
+            conditional: getChatUpdateConditional(id, undefined)
+        }])
+    }
+    
+    else if (action?.noteEditAction || type === 'note_edit') {
+        ev.emit('chats.update', [{
+            id: action?.noteEditAction?.chatJid || id,
+            notes: action?.noteEditAction?.deleted ? null : {
+                text: action?.noteEditAction?.unstructuredContent,
+                createdAt: toNumber(action?.noteEditAction?.createdAt)
+            }
+        }])
+    }
+    
     else if (action?.labelEditAction) {
         const { name, color, deleted, predefinedId } = action.labelEditAction
         ev.emit('labels.edit', {

package/lib/Utils/messages.js

@@ -622,6 +622,40 @@ const generateWAMessageContent = async (message, options) => {
         m.keepInChatMessage.key = message.keep.key
         m.keepInChatMessage.keepType = message.keep?.type || 1
         m.keepInChatMessage.timestampMs = message.keep?.time || Date.now()
+    } else if (hasNonNullishProperty(message, "pin")) {
+        m.pinInChatMessage = {
+            key: message.pin.key,
+            type: typeof message.pin.type === 'number' ? message.pin.type : 1,
+            senderTimestampMs: message.pin.senderTimestampMs || Date.now()
+        }
+
+        if (message.pin.time || message.pin.duration) {
+            m.messageContextInfo = m.messageContextInfo || {}
+            m.messageContextInfo.messageAddOnDurationInSecs = message.pin.time || message.pin.duration
+        }
+    } else if (hasNonNullishProperty(message, "comment")) {
+        m.commentMessage = {
+            targetMessageKey: message.comment.targetMessageKey,
+            message: await generateWAMessageContent(message.comment.message, options)
+        }
+    } else if (hasNonNullishProperty(message, "eventResponse")) {
+        const responseType = typeof message.eventResponse.response === 'string'
+            ? (WAProto.Message.EventResponseMessage?.EventResponseType?.[message.eventResponse.response] || 1)
+            : (message.eventResponse.response || 1)
+
+        m.eventResponseMessage = {
+            response: responseType,
+            timestampMs: message.eventResponse.timestampMs || Date.now(),
+            extraGuestCount: message.eventResponse.extraGuestCount || 0
+        }
+
+        if (message.eventResponse.eventKey) {
+            m.messageContextInfo = m.messageContextInfo || {}
+            m.messageContextInfo.messageAssociation = {
+                associationType: 1,
+                parentMessageKey: message.eventResponse.eventKey
+            }
+        }
     } else if (hasNonNullishProperty(message, "call")) {
         m.scheduledCallCreationMessage = {}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@areumtecnologia/wasockets",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "description": "WhatsApp API Modification By areumtecnologia",
   "keywords": [
     "whatsapp",