@systemzero/baileys 1.0.3 → 1.0.5

package/README.md

@@ -0,0 +1,1020 @@
+<div align="center">
+
+<img src="https://files.catbox.moe/w1m2q4.jpg" width="120" style="border-radius:16px" />
+
+# @systemzero/baileys
+
+**v1.0.5** · Fork avançado do Baileys com suporte nativo a todos os tipos de mensagens do WhatsApp
+
+[![NPM](https://img.shields.io/npm/v/@systemzero/baileys?color=7c3aed&style=flat-square&label=npm)](https://www.npmjs.com/package/@systemzero/baileys)
+[![License](https://img.shields.io/badge/license-MIT-6366f1?style=flat-square)](LICENSE)
+[![Author](https://img.shields.io/badge/by-Josué%20%3C%2F%3E-ec4899?style=flat-square)](https://t.me/blackhzx)
+
+</div>
+
+---
+
+## Instalação
+
+```bash
+npm i @systemzero/baileys
+```
+
+Dependências opcionais para sticker pack e thumbnail:
+```bash
+npm i sharp
+# ou
+npm i @napi-rs/image
+```
+
+---
+
+## Índice
+
+1. [Conexão](#1-conexão)
+2. [Mensagens de mídia](#2-mensagens-de-mídia)
+3. [Mensagens especiais](#3-mensagens-especiais)
+4. [Botões e interativos](#4-botões-e-interativos)
+5. [Sticker Pack nativo](#5-sticker-pack-nativo)
+6. [Canais Newsletter](#6-canais-newsletter)
+7. [Enquetes com decrypt](#7-enquetes-com-decrypt)
+8. [AI Rich](#8-ai-rich)
+9. [Grupos](#9-grupos)
+10. [Perfil e privacidade](#10-perfil-e-privacidade)
+11. [Eventos do socket](#11-eventos-do-socket)
+12. [Utilitários](#12-utilitários)
+
+---
+
+## 1. Conexão
+
+### Setup básico
+
+```js
+const {
+    default: makeWASocket,
+    useMultiFileAuthState,
+    DisconnectReason,
+    Browsers,
+    fetchLatestWaWebVersion
+} = require('@systemzero/baileys')
+
+const { state, saveCreds } = await useMultiFileAuthState('./session')
+const { version } = await fetchLatestWaWebVersion()
+
+const sock = makeWASocket({
+    version,
+    auth:    state,
+    browser: Browsers.ubuntu('Chrome'),
+    printQRInTerminal: false,
+    logger:  require('pino')({ level: 'silent' }),
+    getMessage: async (key) => {
+        const msg = await store.loadMessage(key.remoteJid, key.id)
+        return msg?.message || undefined
+    }
+})
+
+sock.ev.on('creds.update', saveCreds)
+
+sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
+    if (connection === 'close') {
+        const code = lastDisconnect?.error?.output?.statusCode
+        if (code !== DisconnectReason.loggedOut) startBot()
+    }
+})
+```
+
+### Pairing Code
+
+```js
+// Código gerado automaticamente (ex: ABCD-EFGH)
+const code = await sock.requestPairingCode('5511999999999')
+
+// Código personalizado — exatamente 8 caracteres
+const code = await sock.requestPairingCode('5511999999999', 'MYBOT001')
+```
+
+### Store em memória
+
+```js
+const store = {
+    messages: {},
+    bind: (ev) => {
+        ev.on('messages.upsert', ({ messages }) => {
+            for (const msg of messages) {
+                if (!msg.key?.remoteJid) continue
+                store.messages[msg.key.remoteJid] ??= {}
+                store.messages[msg.key.remoteJid][msg.key.id] = msg
+            }
+        })
+    },
+    loadMessage: async (jid, id) => store.messages[jid]?.[id] || null
+}
+
+store.bind(sock.ev)
+```
+
+---
+
+## 2. Mensagens de mídia
+
+Todos os campos de mídia aceitam `Buffer`, `{ url: 'https://...' }` ou `{ stream: ReadableStream }`.
+
+### Texto
+
+```js
+await sock.sendMessage(jid, { text: 'Olá!' })
+
+// Com menção
+await sock.sendMessage(jid, {
+    text:     '@55119...!',
+    mentions: ['5511999999999@s.whatsapp.net']
+})
+```
+
+### Imagem
+
+```js
+await sock.sendMessage(jid, {
+    image:   { url: 'https://exemplo.com/foto.jpg' },
+    caption: 'Legenda'
+})
+```
+
+### Vídeo
+
+```js
+await sock.sendMessage(jid, {
+    video:       { url: 'https://exemplo.com/video.mp4' },
+    caption:     'Legenda',
+    gifPlayback: false   // true envia como GIF silencioso
+})
+```
+
+### Áudio
+
+```js
+// Música
+await sock.sendMessage(jid, {
+    audio:    buffer,
+    mimetype: 'audio/mpeg',
+    ptt:      false
+})
+
+// Nota de voz (PTT)
+await sock.sendMessage(jid, {
+    audio:    buffer,
+    mimetype: 'audio/ogg; codecs=opus',
+    ptt:      true
+})
+```
+
+### Documento
+
+```js
+await sock.sendMessage(jid, {
+    document: buffer,
+    mimetype: 'application/pdf',
+    fileName: 'relatorio.pdf',
+    caption:  'Segue o relatório'
+})
+```
+
+### Figurinha
+
+```js
+await sock.sendMessage(jid, { sticker: buffer })
+```
+
+### Album (múltiplas mídias agrupadas)
+
+Mínimo 2 itens.
+
+```js
+await sock.sendMessage(jid, {
+    album: [
+        { image: buffer1 },
+        { image: buffer2, caption: 'Segunda foto' },
+        { video: bufferVideo },
+    ]
+})
+```
+
+### Contato
+
+```js
+await sock.sendMessage(jid, {
+    contacts: {
+        displayName: 'João',
+        contacts: [{
+            vcard: `BEGIN:VCARD\nVERSION:3.0\nFN:João Silva\nTEL:+5511999999999\nEND:VCARD`
+        }]
+    }
+})
+```
+
+### Localização
+
+```js
+await sock.sendMessage(jid, {
+    location: {
+        degreesLatitude:  -23.550520,
+        degreesLongitude: -46.633308,
+        name:             'São Paulo',
+        address:          'SP, Brasil'
+    }
+})
+```
+
+---
+
+## 3. Mensagens especiais
+
+### Reação
+
+```js
+await sock.sendMessage(jid, {
+    react: { text: '❤️', key: message.key }
+    // text: '' remove a reação
+})
+```
+
+### Deletar mensagem
+
+```js
+await sock.sendMessage(jid, { delete: message.key })
+```
+
+### Editar mensagem
+
+```js
+await sock.sendMessage(jid, {
+    edit: message.key,
+    text: 'Texto editado'
+})
+```
+
+### Fixar mensagem
+
+```js
+await sock.sendMessage(jid, {
+    pin: {
+        type:       1,           // 1 = fixar, 2 = desfixar
+        time:       86400,       // duração em segundos
+        messageKey: message.key
+    }
+})
+```
+
+### Encaminhar
+
+```js
+const { generateForwardMessageContent, generateWAMessageFromContent } = require('@systemzero/baileys')
+
+const content = generateForwardMessageContent(message, false)
+const msg     = generateWAMessageFromContent(jid, content, { quoted: m })
+await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
+```
+
+### View Once
+
+```js
+await sock.sendMessage(jid, { image: buffer, viewOnce: true })
+
+// V2
+await sock.sendMessage(jid, { image: buffer, viewOnceV2: true })
+
+// V2 Extension
+await sock.sendMessage(jid, { image: buffer, viewOnceV2Extension: true })
+```
+
+### Spoiler
+
+```js
+await sock.sendMessage(jid, {
+    image:   buffer,
+    caption: 'Spoiler!',
+    spoiler: true
+})
+```
+
+### Status de grupo
+
+```js
+await sock.sendMessage(jid, {
+    image:       buffer,
+    caption:     'Status do grupo',
+    groupStatus: true
+})
+```
+
+### Mensagem efêmera
+
+```js
+await sock.sendMessage(jid, {
+    image:    buffer,
+    ephemeral: true
+})
+```
+
+### Lottie (sticker animado especial)
+
+```js
+await sock.sendMessage(jid, {
+    sticker:  buffer,
+    isLottie: true
+})
+```
+
+### Keep (salvar mensagem)
+
+```js
+await sock.sendMessage(jid, {
+    keep: message.key,
+    type: 1   // 1 = salvar, 2 = remover
+})
+```
+
+### Evento
+
+```js
+await sock.sendMessage(jid, {
+    event: {
+        isCanceled:  false,
+        name:        'Reunião',
+        description: 'Alinhamento',
+        location:    { name: 'Sala 3', address: 'Rua X, 100' },
+        startTime:   Math.floor(Date.now() / 1000) + 3600,
+        endTime:     Math.floor(Date.now() / 1000) + 7200,
+    }
+})
+```
+
+### Enquete
+
+```js
+await sock.sendMessage(jid, {
+    poll: {
+        name:            'Qual seu time?',
+        values:          ['Flamengo', 'Corinthians', 'Palmeiras'],
+        selectableCount: 1   // 0 = múltipla escolha
+    }
+})
+```
+
+### Invoice (nota fiscal)
+
+```js
+await sock.sendMessage(jid, {
+    image:       buffer,
+    invoiceNote: 'Pagamento pedido #1234'
+})
+```
+
+### External Ad Reply
+
+```js
+await sock.sendMessage(jid, {
+    text: 'Confira!',
+    externalAdReply: {
+        title:                 'System Zero',
+        body:                  'Descrição do produto',
+        thumbnail:             bufferImagem,
+        mediaType:             1,
+        sourceUrl:             'https://systemzone.store',
+        renderLargerThumbnail: true
+    }
+})
+```
+
+### Mention All
+
+```js
+await sock.sendMessage(jid, {
+    text:       '👋 @all',
+    mentionAll: true
+})
+```
+
+### Convite de pagamento
+
+```js
+await sock.sendMessage(jid, {
+    paymentInviteServiceType: 3
+})
+```
+
+### Resultado de enquete (snapshot)
+
+```js
+await sock.sendMessage(jid, {
+    pollResult: {
+        name:     'Pergunta?',
+        pollType: 0,   // 0 = poll, 1 = quiz
+        votes: [
+            { name: 'Opção A', voteCount: 12 },
+            { name: 'Opção B', voteCount: 7 },
+        ]
+    }
+})
+```
+
+---
+
+## 4. Botões e interativos
+
+### Estrutura base
+
+```js
+const { generateWAMessageFromContent, proto } = require('@systemzero/baileys')
+
+const msg = generateWAMessageFromContent(jid, {
+    viewOnceMessage: {
+        message: {
+            interactiveMessage: proto.Message.InteractiveMessage.create({
+                header: { title: 'Título', hasMediaAttachment: false },
+                body:   { text: 'Texto do corpo' },
+                footer: { text: 'Rodapé' },
+                nativeFlowMessage: {
+                    buttons: [ /* tipos abaixo */ ]
+                }
+            })
+        }
+    }
+}, { quoted: m })
+
+await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
+```
+
+### Tipos de botão
+
+```js
+// Resposta rápida
+{ name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Confirmar', id: 'confirmar' }) }
+
+// Link externo
+{ name: 'cta_url', buttonParamsJson: JSON.stringify({ display_text: 'Abrir', url: 'https://systemzone.store' }) }
+
+// Copiar texto
+{ name: 'cta_copy', buttonParamsJson: JSON.stringify({ display_text: 'Copiar código', copy_code: 'PROMO2025' }) }
+
+// Ligar
+{ name: 'cta_call', buttonParamsJson: JSON.stringify({ display_text: 'Ligar', phone_number: '5511999999999' }) }
+
+// Webview interno
+{ name: 'cta_webview', buttonParamsJson: JSON.stringify({ title: 'Painel', url: 'https://systemzone.store' }) }
+
+// Lista dropdown com seções
+{
+    name: 'single_select',
+    buttonParamsJson: JSON.stringify({
+        title: 'Escolher',
+        sections: [{
+            title: 'Categoria',
+            rows: [
+                { header: 'Op 1', title: 'Opção 1', description: 'Desc', id: 'op1' },
+                { header: 'Op 2', title: 'Opção 2', description: 'Desc', id: 'op2' },
+            ]
+        }]
+    })
+}
+```
+
+### Header com imagem
+
+Upload da imagem antes de usar no header:
+
+```js
+const { generateWAMessage, generateMessageIDV2 } = require('@systemzero/baileys')
+
+const uploaded = await generateWAMessage(jid, { image: buffer }, {
+    upload:    sock.waUploadToServer,
+    userJid:   sock.user.id,
+    messageId: generateMessageIDV2(sock.user.id),
+})
+const img = uploaded.message?.imageMessage
+
+// No header:
+header: {
+    title:              '',
+    hasMediaAttachment: true,
+    imageMessage: {
+        url:               img.url,
+        mimetype:          img.mimetype,
+        fileSha256:        img.fileSha256,
+        fileLength:        img.fileLength,
+        mediaKey:          img.mediaKey,
+        fileEncSha256:     img.fileEncSha256,
+        directPath:        img.directPath,
+        mediaKeyTimestamp: img.mediaKeyTimestamp,
+        jpegThumbnail:     img.jpegThumbnail,
+    }
+}
+```
+
+### Catálogo (product no header)
+
+```js
+header: {
+    title:              'Produto',
+    hasMediaAttachment: true,
+    productMessage:     proto.Message.ProductMessage.create({
+        product: proto.Message.ProductMessage.ProductSnapshot.create({
+            productImage:    proto.Message.ImageMessage.create({ ...img }),
+            productId:       'ID-001',
+            title:           'Nome do Produto',
+            description:     'Descrição completa',
+            currencyCode:    'BRL',
+            priceAmount1000: 29990,   // R$ 29,99
+            retailerId:      'minha-loja',
+            url:             'https://loja.com/produto',
+            productImageCount: 1,
+        }),
+        businessOwnerJid: sock.user.id
+    })
+}
+```
+
+### Carousel
+
+```js
+await sock.sendMessage(jid, {
+    cards: [
+        {
+            image:      buffer1,
+            caption:    'Texto do card 1',
+            title:      'Card 1',
+            nativeFlow: [
+                { text: 'Ver mais', id: 'card1' },
+                { text: 'Site', url: 'https://systemzone.store' }
+            ]
+        },
+        {
+            image:      buffer2,
+            caption:    'Texto do card 2',
+            nativeFlow: [{ text: 'Clique', id: 'card2' }]
+        }
+    ],
+    footer: 'Rodapé'
+})
+```
+
+### Template Buttons
+
+```js
+await sock.sendMessage(jid, {
+    text:            'Escolha:',
+    templateButtons: [
+        { text: 'Resposta', id:   'res1' },
+        { text: 'Site',     url:  'https://systemzone.store' },
+        { text: 'Ligar',    call: '5511999999999' },
+    ]
+})
+```
+
+### Sections (lista clássica)
+
+```js
+await sock.sendMessage(jid, {
+    text:       'Selecione',
+    buttonText: 'Ver opções',
+    sections: [{
+        title: 'Categoria',
+        rows: [
+            { title: 'Item 1', description: 'Desc', id: 'item1' },
+            { title: 'Item 2', description: 'Desc', id: 'item2' },
+        ]
+    }]
+})
+```
+
+### Interactive como Template
+
+```js
+await sock.sendMessage(jid, {
+    nativeFlow: [{ text: 'Clique', id: 'btn' }],
+    text:       'Mensagem',
+    interactiveAsTemplate: true
+})
+```
+
+### Botões com imagem no corpo (não no header)
+
+```js
+await sock.sendMessage(jid, {
+    image:   buffer,
+    caption: 'Escolha:',
+    buttons: [
+        { text: 'Opção 1', id: 'op1' },
+        { text: 'Link', url: 'https://systemzone.store' },
+    ]
+})
+```
+
+### Áudio no rodapé de interativo
+
+```js
+await sock.sendMessage(jid, {
+    text:        'Ouça e escolha:',
+    nativeFlow:  [{ text: 'Opção', id: 'op' }],
+    audioFooter: bufferAudio
+})
+```
+
+---
+
+## 5. Sticker Pack nativo
+
+Envia um pack de figurinhas que aparece na aba de stickers do WhatsApp, igual a um pack real.
+
+```js
+await sock.sendMessage(jid, {
+    cover:    { url: 'https://exemplo.com/capa.webp' },
+    stickers: [
+        { data: buffer1,       emojis: ['😂'] },
+        { data: bufferAnimado, emojis: ['🔥', '💀'] },
+        { data: bufferPng,     emojis: ['🐱'] },    // PNG converte automaticamente
+    ],
+    name:        'Nome do Pack',
+    publisher:   'Autor',
+    description: 'Descrição opcional'
+})
+```
+
+`cover` aceita `Buffer`, `{ url }` ou `{ stream }`. O mesmo vale para cada `sticker.data`.
+
+Limites: máximo **60 figurinhas** por pack, cada uma com até **1MB**.
+
+Requer `sharp` ou `@napi-rs/image` para conversão de PNG e geração de thumbnail. Sem eles, apenas WebP é aceito.
+
+---
+
+## 6. Canais Newsletter
+
+### Enviar texto
+
+```js
+await sock.sendMessage('120363...@newsletter', { text: 'Novidade!' })
+```
+
+### Enviar mídia
+
+`sendMessage` não passa pelo `encodeNewsletterMessage` corretamente para mídia. Use sempre `generateWAMessage` + `relayMessage`:
+
+```js
+const { generateWAMessage, generateMessageIDV2 } = require('@systemzero/baileys')
+
+const canalJid = '120363...@newsletter'
+
+const fullMsg = await generateWAMessage(canalJid, {
+    image:   buffer,
+    caption: 'Legenda'
+}, {
+    upload:    sock.waUploadToServer,
+    userJid:   sock.user.id,
+    messageId: generateMessageIDV2(sock.user.id),
+})
+
+await sock.relayMessage(canalJid, fullMsg.message, {
+    messageId: fullMsg.key.id,
+})
+```
+
+Funciona para `image`, `video`, `audio`, `sticker`, `document`.
+
+### Gerenciar canais
+
+```js
+// Criar
+const canal = await sock.newsletterCreate('Nome do Canal', 'Descrição')
+
+// Seguir / deixar
+await sock.newsletterFollow(jid)
+await sock.newsletterUnfollow(jid)
+
+// Silenciar
+await sock.newsletterMute(jid)
+await sock.newsletterUnmute(jid)
+
+// Metadata
+const meta = await sock.newsletterMetadata('jid', jid)
+const meta = await sock.newsletterMetadata('invite', 'CODIGO')
+
+// Atualizar
+await sock.newsletterUpdateName(jid, 'Novo Nome')
+await sock.newsletterUpdateDescription(jid, 'Nova descrição')
+await sock.newsletterUpdatePicture(jid, buffer)
+await sock.newsletterRemovePicture(jid)
+
+// Reagir a mensagem
+await sock.newsletterReactMessage(jid, serverId, '❤️')
+
+// Listar mensagens
+const msgs = await sock.newsletterFetchMessages(jid, 30, 0, 0)
+
+// Admin
+const count    = await sock.newsletterAdminCount(jid)
+await sock.newsletterChangeOwner(jid, novoDonoJid)
+await sock.newsletterDemote(jid, usuarioJid)
+await sock.newsletterDelete(jid)
+
+// Seguidores
+const { subscribers } = await sock.newsletterSubscribers(jid)
+```
+
+---
+
+## 7. Enquetes com decrypt
+
+### Criar enquete
+
+```js
+await sock.sendMessage(jid, {
+    poll: {
+        name:            'Pergunta?',
+        values:          ['A', 'B', 'C'],
+        selectableCount: 1   // 0 = múltipla escolha
+    }
+})
+```
+
+### Receber e descriptografar votos
+
+No `connect.js`, após `saveCreds`:
+
+```js
+const { getAggregateVotesInPollMessage } = require('@systemzero/baileys/lib/Utils/messages.js')
+
+sock.ev.on('messages.update', async (updates) => {
+    for (const { key, update } of updates) {
+        if (!update.pollUpdates) continue
+
+        const pollMsg = await store.loadMessage(key.remoteJid, key.id)
+        if (!pollMsg?.message) continue
+
+        const result = getAggregateVotesInPollMessage({
+            message:     pollMsg.message,
+            pollUpdates: update.pollUpdates,
+        })
+
+        // [{ name: 'Opção A', voters: ['5511...@s.whatsapp.net'] }]
+        console.log(result)
+
+        if (!global.pollResults) global.pollResults = {}
+        global.pollResults[key.id] = { options: result, jid: key.remoteJid }
+    }
+})
+```
+
+O `getMessage` precisa estar configurado no `makeWASocket` (veja seção 1).
+
+---
+
+## 8. AI Rich
+
+Mensagens com formatação avançada: markdown, código, tabelas, hyperlinks clicáveis no texto.
+
+### Direto pelo socket
+
+```js
+// Texto com hyperlink
+await sock.sendRich(jid, [
+    sock.makeText('Acesse [nosso site](https://systemzone.store).')
+], quotedMsg)
+
+// Código
+await sock.sendRich(jid, [
+    sock.makeCode('bash', 'npm i @systemzero/baileys')
+], null, ['RICH_RESPONSE_CODE'])
+
+// Tabela
+await sock.sendRich(jid, [
+    sock.makeTable([
+        ['Nome',    'Status'],
+        ['Botões',  '✅'],
+        ['Canais',  '✅'],
+    ])
+], null, ['RICH_RESPONSE_TABLE'])
+
+// Lista
+await sock.sendRich(jid, [
+    sock.makeList(['Item 1', 'Item 2', 'Item 3'])
+])
+
+// Tudo junto
+await sock.sendRich(jid, [
+    sock.makeText('# Título\nConteúdo com [link](https://systemzone.store)'),
+    sock.makeCode('javascript', 'const x = require("@systemzero/baileys")'),
+    sock.makeTable([['Col A', 'Col B'], ['val1', 'val2']]),
+], quotedMsg, ['RICH_RESPONSE_CODE', 'RICH_RESPONSE_TABLE'])
+```
+
+### Atalhos
+
+```js
+await sock.sendRichText(jid, 'Texto com [link](https://systemzone.store)', quotedMsg)
+await sock.sendRichCode(jid, 'Título', 'javascript', 'console.log("hi")', quotedMsg)
+await sock.sendRichList(jid, 'Lista', ['A', 'B', 'C'], quotedMsg)
+```
+
+### Usando a classe AIRich
+
+```js
+const { AIRich } = require('@systemzero/baileys/lib/MB.cjs')
+
+const msg = new AIRich(sock)
+msg.addText('Texto com [link](https://systemzone.store)')
+msg.addCode('javascript', 'const x = 1')
+msg.addTable([['Col', 'Valor'], ['linha', 'dado']])
+await msg.send(jid, { quoted: m })
+```
+
+---
+
+## 9. Grupos
+
+```js
+// Criar
+const grupo = await sock.groupCreate('Nome', ['5511...@s.whatsapp.net'])
+
+// Participantes
+await sock.groupParticipantsUpdate(jid, ['5511...@s.whatsapp.net'], 'add')
+await sock.groupParticipantsUpdate(jid, ['5511...@s.whatsapp.net'], 'remove')
+await sock.groupParticipantsUpdate(jid, ['5511...@s.whatsapp.net'], 'promote')
+await sock.groupParticipantsUpdate(jid, ['5511...@s.whatsapp.net'], 'demote')
+
+// Sair
+await sock.groupLeave(jid)
+
+// Nome e descrição
+await sock.groupUpdateSubject(jid, 'Novo Nome')
+await sock.groupUpdateDescription(jid, 'Nova descrição')
+
+// Convite
+const code = await sock.groupInviteCode(jid)
+await sock.groupRevokeInvite(jid)
+await sock.groupAcceptInvite('CODIGO')
+
+// Mensagens efêmeras (0 = desativar)
+await sock.groupToggleEphemeral(jid, 86400)
+
+// Metadata
+const meta   = await sock.groupMetadata(jid)
+const grupos = await sock.groupFetchAllParticipating()
+```
+
+---
+
+## 10. Perfil e privacidade
+
+```js
+// Foto de perfil
+const url = await sock.profilePictureUrl(jid, 'image')
+await sock.updateProfilePicture(jid, buffer)
+
+// Bio
+await sock.updateProfileStatus('🤖 Bot ativo')
+
+// Verificar número
+const [result] = await sock.onWhatsApp('5511999999999')
+// { exists: true, jid: '5511...@s.whatsapp.net' }
+
+// Bloquear / desbloquear
+await sock.updateBlockStatus(jid, 'block')
+await sock.updateBlockStatus(jid, 'unblock')
+
+// Presence
+await sock.sendPresenceUpdate('composing', jid)    // digitando
+await sock.sendPresenceUpdate('recording', jid)    // gravando
+await sock.sendPresenceUpdate('available', jid)    // online
+await sock.sendPresenceUpdate('unavailable')        // offline
+await sock.presenceSubscribe(jid)                   // receber presence de contato
+
+// Marcar como lido
+await sock.readMessages([message.key])
+
+// Privacidade da foto
+await sock.updateProfilePicturePrivacy('all')    // 'all' | 'contacts' | 'none'
+
+// Modificar chat
+await sock.chatModify({ archive: true }, jid)
+await sock.chatModify({ pin: true }, jid)
+await sock.chatModify({ mute: 8 * 60 * 60 * 1000 }, jid)
+await sock.chatModify({ star: { messages: [{ id, fromMe }], star: true } }, jid)
+await sock.chatModify({ clear: { messages: [{ id, fromMe, timestamp }] } }, jid)
+
+// Desconectar
+await sock.logout()
+```
+
+---
+
+## 11. Eventos do socket
+
+```js
+sock.ev.on('messages.upsert',         ({ messages, type }) => {})
+sock.ev.on('messages.update',          (updates) => {})
+sock.ev.on('messages.delete',          (item) => {})
+sock.ev.on('messages.reaction',        (reactions) => {})
+sock.ev.on('presence.update',          ({ id, presences }) => {})
+sock.ev.on('groups.update',            (updates) => {})
+sock.ev.on('group-participants.update', ({ id, participants, action }) => {})
+sock.ev.on('contacts.update',          (contacts) => {})
+sock.ev.on('chats.update',             (chats) => {})
+sock.ev.on('connection.update',        ({ connection, lastDisconnect, qr }) => {})
+sock.ev.on('creds.update',             saveCreds)
+
+// Chamadas
+sock.ev.on('call', (calls) => {
+    for (const call of calls) {
+        if (call.status === 'offer') {
+            sock.rejectCall(call.id, call.from)
+        }
+    }
+})
+```
+
+---
+
+## 12. Utilitários
+
+### Download de mídia
+
+```js
+const { downloadMediaMessage } = require('@systemzero/baileys')
+
+const buffer = await downloadMediaMessage(message, 'buffer', {})
+const stream = await downloadMediaMessage(message, 'stream', {})
+```
+
+### Download manual por stream
+
+```js
+const { downloadContentFromMessage } = require('@systemzero/baileys')
+
+const stream = await downloadContentFromMessage(
+    { mediaKey, directPath, url },
+    'image'   // 'image' | 'video' | 'audio' | 'sticker' | 'document'
+)
+const chunks = []
+for await (const chunk of stream) chunks.push(chunk)
+const buffer = Buffer.concat(chunks)
+```
+
+### Geração de mensagem manual
+
+```js
+const {
+    generateWAMessage,
+    generateWAMessageFromContent,
+    generateMessageIDV2,
+    generateForwardMessageContent
+} = require('@systemzero/baileys')
+
+// Com upload automático de mídia
+const msg = await generateWAMessage(jid, { image: buffer }, {
+    upload:    sock.waUploadToServer,
+    userJid:   sock.user.id,
+    messageId: generateMessageIDV2(sock.user.id),
+})
+
+// Sem upload (proto manual)
+const msg = generateWAMessageFromContent(jid, { ... }, { quoted: m })
+
+// Enviar o proto
+await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
+```
+
+### Detectar dispositivo
+
+```js
+const { getDevice } = require('@systemzero/baileys')
+const device = getDevice(message.key.id)
+// 'android' | 'ios' | 'web' | 'unknown'
+```
+
+### JID utils
+
+```js
+const {
+    jidNormalizedUser,
+    isJidGroup,
+    isJidNewsletter,
+    jidEncode,
+    jidDecode
+} = require('@systemzero/baileys')
+
+jidNormalizedUser('5511999999999@s.whatsapp.net')
+isJidGroup('120363...@g.us')            // true
+isJidNewsletter('120363...@newsletter') // true
+```
+
+---
+
+<div align="center">
+
+**@systemzero/baileys v1.0.5**
+
+Desenvolvido por [Josué </>](https://t.me/blackhzx) · [Canal WhatsApp](https://whatsapp.com/channel/0029VaqUb9aGk1FxqeKKOd2i) · [systemzone.store](https://systemzone.store)
+
+</div>