@areumtecnologia/wasockets 2.0.0 → 2.3.0

package/lib/Client/Modules/ChatManager.js

@@ -0,0 +1,113 @@
+"use strict"
+
+Object.defineProperty(exports, "__esModule", { value: true })
+
+const { JidNormalizer } = require("../Normalizers/JidNormalizer")
+
+class ChatManager {
+    /**
+     * @param {import('../WaClient').WaClient} client
+     */
+    constructor(client) {
+        this.client = client
+    }
+
+    _getSock() {
+        if (!this.client.sock) {
+            throw new Error('Socket is not connected.')
+        }
+        return this.client.sock
+    }
+
+    /**
+     * Fixa a conversa no topo
+     * @param {string} jid
+     */
+    async pin(jid) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(jid)
+        return sock.chatModify({ pin: true }, targetJid)
+    }
+
+    /**
+     * Desafixa a conversa do topo
+     * @param {string} jid
+     */
+    async unpin(jid) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(jid)
+        return sock.chatModify({ pin: false }, targetJid)
+    }
+
+    /**
+     * Silencia notificações do chat
+     * @param {string} jid
+     * @param {number} [durationMs=86400000] - Duração em ms (padrão: 24h, null para permanente)
+     */
+    async mute(jid, durationMs = 86400000) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(jid)
+        return sock.chatModify({ mute: durationMs }, targetJid)
+    }
+
+    /**
+     * Reativa o som do chat
+     * @param {string} jid
+     */
+    async unmute(jid) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(jid)
+        return sock.chatModify({ mute: null }, targetJid)
+    }
+
+    /**
+     * Arquiva uma conversa
+     * @param {string} jid
+     */
+    async archive(jid) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(jid)
+        return sock.chatModify({ archive: true }, targetJid)
+    }
+
+    /**
+     * Desarquiva uma conversa
+     * @param {string} jid
+     */
+    async unarchive(jid) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(jid)
+        return sock.chatModify({ archive: false }, targetJid)
+    }
+
+    /**
+     * Marca ou desmarca o chat como favorito
+     * @param {string} jid
+     * @param {boolean} [isFavorite=true]
+     */
+    async setFavorite(jid, isFavorite = true) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(jid)
+        if (!sock.updateFavorite) {
+            throw new Error('updateFavorite indisponível no socket.')
+        }
+        return sock.updateFavorite(targetJid, isFavorite)
+    }
+
+    /**
+     * Salva uma anotação interna no contato (recurso exclusivo WaSockets)
+     * @param {string} jid
+     * @param {string} note
+     */
+    async setChatNote(jid, note) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(jid)
+        if (!sock.updateChatNote) {
+            throw new Error('updateChatNote indisponível no socket.')
+        }
+        return sock.updateChatNote(targetJid, note)
+    }
+}
+
+exports.ChatManager = ChatManager
+exports.default = ChatManager

package/lib/Client/Modules/CommunityManager.js

@@ -0,0 +1,136 @@
+"use strict"
+
+Object.defineProperty(exports, "__esModule", { value: true })
+
+const { JidNormalizer } = require("../Normalizers/JidNormalizer")
+
+class CommunityManager {
+    /**
+     * @param {import('../WaClient').WaClient} client
+     */
+    constructor(client) {
+        this.client = client
+    }
+
+    _getSock() {
+        if (!this.client.sock) {
+            throw new Error('Socket is not connected.')
+        }
+        return this.client.sock
+    }
+
+    /**
+     * Cria uma nova comunidade (grupo pai de avisos)
+     * @param {string} subject - Nome da comunidade
+     * @param {string} [description=''] - Descrição da comunidade
+     */
+    async create(subject, description = '') {
+        const sock = this._getSock()
+        if (!sock.communityCreate) {
+            throw new Error('communityCreate indisponível no socket.')
+        }
+        return sock.communityCreate(subject, description)
+    }
+
+    /**
+     * Obtém metadados da comunidade
+     * @param {string} communityJid
+     */
+    async getMetadata(communityJid) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(communityJid)
+        if (!sock.communityMetadata) {
+            throw new Error('communityMetadata indisponível no socket.')
+        }
+        return sock.communityMetadata(targetJid)
+    }
+
+    /**
+     * Cria um novo subgrupo já vinculado à comunidade
+     * @param {string} communityJid
+     * @param {string} subject - Nome do subgrupo
+     * @param {string[]} [participants=[]]
+     */
+    async createSubgroup(communityJid, subject, participants = []) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(communityJid)
+        const jids = participants.map(JidNormalizer.toJid)
+        if (!sock.communityCreateGroup) {
+            throw new Error('communityCreateGroup indisponível no socket.')
+        }
+        return sock.communityCreateGroup(subject, jids, targetJid)
+    }
+
+    /**
+     * Vincula um grupo existente à comunidade
+     * @param {string} communityJid
+     * @param {string} groupJid
+     */
+    async linkSubgroup(communityJid, groupJid) {
+        const sock = this._getSock()
+        const parentJid = JidNormalizer.toJid(communityJid)
+        const childJid = JidNormalizer.toJid(groupJid)
+        if (!sock.communityLinkGroup) {
+            throw new Error('communityLinkGroup indisponível no socket.')
+        }
+        return sock.communityLinkGroup(childJid, parentJid)
+    }
+
+    /**
+     * Desvincula um subgrupo da comunidade
+     * @param {string} communityJid
+     * @param {string} groupJid
+     */
+    async unlinkSubgroup(communityJid, groupJid) {
+        const sock = this._getSock()
+        const parentJid = JidNormalizer.toJid(communityJid)
+        const childJid = JidNormalizer.toJid(groupJid)
+        if (!sock.communityUnlinkGroup) {
+            throw new Error('communityUnlinkGroup indisponível no socket.')
+        }
+        return sock.communityUnlinkGroup(childJid, parentJid)
+    }
+
+    /**
+     * Retorna a lista de subgrupos vinculados à comunidade
+     * @param {string} communityJid
+     */
+    async getSubgroups(communityJid) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(communityJid)
+        if (!sock.communityFetchLinkedGroups) {
+            throw new Error('communityFetchLinkedGroups indisponível no socket.')
+        }
+        return sock.communityFetchLinkedGroups(targetJid)
+    }
+
+    /**
+     * Sai da comunidade
+     * @param {string} communityJid
+     */
+    async leave(communityJid) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(communityJid)
+        if (!sock.communityLeave) {
+            throw new Error('communityLeave indisponível no socket.')
+        }
+        return sock.communityLeave(targetJid)
+    }
+
+    /**
+     * Altera o nome da comunidade
+     * @param {string} communityJid
+     * @param {string} subject
+     */
+    async setName(communityJid, subject) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(communityJid)
+        if (!sock.communityUpdateSubject) {
+            throw new Error('communityUpdateSubject indisponível no socket.')
+        }
+        return sock.communityUpdateSubject(targetJid, subject)
+    }
+}
+
+exports.CommunityManager = CommunityManager
+exports.default = CommunityManager

package/lib/Client/Modules/GroupManager.js

@@ -0,0 +1,194 @@
+"use strict"
+
+Object.defineProperty(exports, "__esModule", { value: true })
+
+const { JidNormalizer } = require("../Normalizers/JidNormalizer")
+
+class GroupManager {
+    /**
+     * @param {import('../WaClient').WaClient} client
+     */
+    constructor(client) {
+        this.client = client
+    }
+
+    _getSock() {
+        if (!this.client.sock) {
+            throw new Error('Socket is not connected.')
+        }
+        return this.client.sock
+    }
+
+    /**
+     * Cria um novo grupo
+     * @param {string} subject - Nome do grupo
+     * @param {string[]} participants - Lista de telefones ou JIDs
+     */
+    async create(subject, participants = []) {
+        const sock = this._getSock()
+        const jids = participants.map(JidNormalizer.toJid)
+        return sock.groupCreate(subject, jids)
+    }
+
+    /**
+     * Retorna os metadados do grupo (usa cache em memória quando disponível)
+     * @param {string} groupJid
+     */
+    async getMetadata(groupJid) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(groupJid)
+        return sock.groupMetadata(targetJid)
+    }
+
+    /**
+     * Adiciona participantes ao grupo
+     * @param {string} groupJid
+     * @param {string[]} participants
+     */
+    async addMembers(groupJid, participants = []) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(groupJid)
+        const jids = participants.map(JidNormalizer.toJid)
+        return sock.groupParticipantsUpdate(targetJid, jids, 'add')
+    }
+
+    /**
+     * Remove participantes do grupo
+     * @param {string} groupJid
+     * @param {string[]} participants
+     */
+    async removeMembers(groupJid, participants = []) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(groupJid)
+        const jids = participants.map(JidNormalizer.toJid)
+        return sock.groupParticipantsUpdate(targetJid, jids, 'remove')
+    }
+
+    /**
+     * Promove membros a administradores do grupo
+     * @param {string} groupJid
+     * @param {string[]} participants
+     */
+    async promote(groupJid, participants = []) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(groupJid)
+        const jids = participants.map(JidNormalizer.toJid)
+        return sock.groupParticipantsUpdate(targetJid, jids, 'promote')
+    }
+
+    /**
+     * Rebaixa administradores a membros normais
+     * @param {string} groupJid
+     * @param {string[]} participants
+     */
+    async demote(groupJid, participants = []) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(groupJid)
+        const jids = participants.map(JidNormalizer.toJid)
+        return sock.groupParticipantsUpdate(targetJid, jids, 'demote')
+    }
+
+    /**
+     * Obtém o código de convite do grupo
+     * @param {string} groupJid
+     * @returns {Promise<string>} Código de convite
+     */
+    async getInviteCode(groupJid) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(groupJid)
+        return sock.groupInviteCode(targetJid)
+    }
+
+    /**
+     * Revoga o código de convite atual e gera um novo
+     * @param {string} groupJid
+     * @returns {Promise<string>} Novo código
+     */
+    async revokeInviteCode(groupJid) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(groupJid)
+        return sock.groupRevokeInvite(targetJid)
+    }
+
+    /**
+     * Entra em um grupo através de um código de convite
+     * @param {string} inviteCode
+     * @returns {Promise<string>} JID do grupo
+     */
+    async joinWithCode(inviteCode) {
+        const sock = this._getSock()
+        const cleanCode = inviteCode.replace('https://chat.whatsapp.com/', '').trim()
+        return sock.groupAcceptInvite(cleanCode)
+    }
+
+    /**
+     * Altera o assunto/nome do grupo
+     * @param {string} groupJid
+     * @param {string} subject
+     */
+    async setSubject(groupJid, subject) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(groupJid)
+        return sock.groupUpdateSubject(targetJid, subject)
+    }
+
+    /**
+     * Altera a descrição do grupo
+     * @param {string} groupJid
+     * @param {string} description
+     */
+    async setDescription(groupJid, description) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(groupJid)
+        return sock.groupUpdateDescription(targetJid, description)
+    }
+
+    /**
+     * Define se apenas administradores podem enviar mensagens
+     * @param {string} groupJid
+     * @param {boolean} announceOnly
+     */
+    async setAnnounceOnly(groupJid, announceOnly = true) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(groupJid)
+        return sock.groupSettingUpdate(targetJid, announceOnly ? 'announcement' : 'not_announcement')
+    }
+
+    /**
+     * Define se apenas administradores podem alterar as configurações do grupo
+     * @param {string} groupJid
+     * @param {boolean} locked
+     */
+    async setLocked(groupJid, locked = true) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(groupJid)
+        return sock.groupSettingUpdate(targetJid, locked ? 'locked' : 'unlocked')
+    }
+
+    /**
+     * Menciona todos os membros do grupo em uma mensagem
+     * @param {string} groupJid
+     * @param {string|Object} textOrContent
+     * @param {Object} [options={}]
+     */
+    async mentionAll(groupJid, textOrContent, options = {}) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(groupJid)
+        const content = typeof textOrContent === 'string' ? { text: textOrContent } : textOrContent
+
+        if (sock.groupSendMentionAll) {
+            return sock.groupSendMentionAll(targetJid, content, options)
+        }
+
+        // Fallback: busca participantes e anexa em mentions
+        const meta = await this.getMetadata(targetJid)
+        const participants = (meta.participants || []).map(p => p.id)
+        return this.client.sendMessage(targetJid, {
+            ...content,
+            mentions: participants
+        }, options)
+    }
+}
+
+exports.GroupManager = GroupManager
+exports.default = GroupManager

package/lib/Client/Modules/LabelManager.js

@@ -0,0 +1,123 @@
+"use strict"
+
+Object.defineProperty(exports, "__esModule", { value: true })
+
+const { JidNormalizer } = require("../Normalizers/JidNormalizer")
+
+class LabelManager {
+    /**
+     * @param {import('../WaClient').WaClient} client
+     */
+    constructor(client) {
+        this.client = client
+    }
+
+    _getSock() {
+        if (!this.client.sock) {
+            throw new Error('Socket is not connected.')
+        }
+        return this.client.sock
+    }
+
+    /**
+     * Cria uma nova etiqueta no WhatsApp Business
+     * @param {string} name - Nome da etiqueta
+     * @param {number} color - Índice numérico da cor (0 a 19)
+     * @param {number} [predefinedId=0]
+     */
+    async create(name, color = 0, predefinedId = 0) {
+        const sock = this._getSock()
+        if (!sock.createLabel) {
+            throw new Error('createLabel indisponível no socket.')
+        }
+        return sock.createLabel(name, color, predefinedId)
+    }
+
+    /**
+     * Atualiza dados de uma etiqueta existente
+     * @param {string} id
+     * @param {string} name
+     * @param {number} color
+     * @param {number} [predefinedId=0]
+     */
+    async update(id, name, color = 0, predefinedId = 0) {
+        const sock = this._getSock()
+        if (!sock.updateLabel) {
+            throw new Error('updateLabel indisponível no socket.')
+        }
+        return sock.updateLabel(id, name, color, predefinedId)
+    }
+
+    /**
+     * Remove uma etiqueta
+     * @param {string} id
+     */
+    async delete(id) {
+        const sock = this._getSock()
+        if (!sock.deleteLabel) {
+            throw new Error('deleteLabel indisponível no socket.')
+        }
+        return sock.deleteLabel(id)
+    }
+
+    /**
+     * Associa uma etiqueta a uma conversa
+     * @param {string} jid
+     * @param {string} labelId
+     */
+    async addChat(jid, labelId) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(jid)
+        if (!sock.addChatLabel) {
+            throw new Error('addChatLabel indisponível no socket.')
+        }
+        return sock.addChatLabel(targetJid, labelId)
+    }
+
+    /**
+     * Remove uma etiqueta de uma conversa
+     * @param {string} jid
+     * @param {string} labelId
+     */
+    async removeChat(jid, labelId) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(jid)
+        if (!sock.removeChatLabel) {
+            throw new Error('removeChatLabel indisponível no socket.')
+        }
+        return sock.removeChatLabel(targetJid, labelId)
+    }
+
+    /**
+     * Associa uma etiqueta a uma mensagem específica
+     * @param {string} jid
+     * @param {string} messageId
+     * @param {string} labelId
+     */
+    async addMessage(jid, messageId, labelId) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(jid)
+        if (!sock.addMessageLabel) {
+            throw new Error('addMessageLabel indisponível no socket.')
+        }
+        return sock.addMessageLabel(targetJid, messageId, labelId)
+    }
+
+    /**
+     * Remove uma etiqueta de uma mensagem
+     * @param {string} jid
+     * @param {string} messageId
+     * @param {string} labelId
+     */
+    async removeMessage(jid, messageId, labelId) {
+        const sock = this._getSock()
+        const targetJid = JidNormalizer.toJid(jid)
+        if (!sock.removeMessageLabel) {
+            throw new Error('removeMessageLabel indisponível no socket.')
+        }
+        return sock.removeMessageLabel(targetJid, messageId, labelId)
+    }
+}
+
+exports.LabelManager = LabelManager
+exports.default = LabelManager