Polls, reactions & edits

interface WaMessageKey {
  remoteJid: string     // the chat the target lives in
  id: string            // the target's message (stanza) id
  fromMe: boolean       // was the target sent by you?
  participant?: string  // the author — required in groups when targeting someone else's message
}

client.on('message', async (event) => {
  // Use the event itself as the target — its key is read for you.
  await client.message.send(event.key.remoteJid, {
    type: 'reaction',
    emoji: '👍',
    target: event
  })
})

// Pass the event verbatim, or an explicit WaMessageKey
await client.message.send(jid, {
  type: 'reaction',
  emoji: '👍',
  target: event
})

await client.message.send(jid, { type: 'reaction', emoji: '', target: event })

const result = await client.message.send(jid, {
  type: 'poll',
  name: 'Lunch?',
  options: ['Pizza', 'Sushi', 'Salad'],
  selectableCount: 1,        // how many options a voter may pick
  allowAddOption: false
})

await client.message.send(jid, {
  type: 'poll-vote',
  poll: {
    id: pollStanzaId,                  // the poll's stanza id
    fromMe: false,
    authorJid: pollAuthorJid,
    messageSecret: pollMessageSecret,  // Uint8Array, 32 bytes
    participant: pollAuthorJid         // required outside 1:1 chats
  },
  selectedOptionNames: ['Pizza']       // exactly as they appeared in the poll
})

// Easiest: forward the original event
await client.message.send(jid, 'Corrected text', { editKey: originalEvent })

// Or build one explicitly
await client.message.send(jid, 'Corrected text', {
  editKey: {
    id: originalStanzaId,
    // participant required in groups for lid/pn-addressed originals
    participant: undefined
  }
})

// Easiest: pass the event you want to revoke
await client.message.send(jid, { type: 'revoke', target: event })

// Or build the target explicitly
await client.message.send(jid, {
  type: 'revoke',
  target: {
    remoteJid: jid,
    id: targetStanzaId,
    fromMe: true,
    // participant required when an admin revokes someone else's message in a group
    participant: undefined
  }
})

await client.message.send(jid, { type: 'pin', target: event })   // pin
await client.message.send(jid, { type: 'unpin', target: event }) // unpin

await client.message.send(jid, { type: 'pin', target: event, durationSecs: 604_800 })   // 7 days
await client.message.send(jid, { type: 'pin', target: event, durationSecs: 2_592_000 }) // 30 days

await client.message.send(jid, { type: 'keep', target: event })
await client.message.send(jid, { type: 'unkeep', target: event })

await client.message.send(groupJid, {
  type: 'event',
  name: 'Team sync',
  description: 'Weekly catch-up',
  startTime: Math.floor(Date.now() / 1000) + 3600, // unix seconds
  location: { latitude: -23.5, longitude: -46.6, name: 'HQ' },
  joinLink: 'https://meet.example.com/abc',
  hasReminder: true,
  reminderOffsetSec: 600
})

await client.message.send(jid, {
  type: 'event-response',
  event: {
    id: eventStanzaId,                 // the event's stanza id
    fromMe: false,
    authorJid: eventAuthorJid,
    messageSecret: eventMessageSecret  // 32 bytes
  },
  response: 'going' // 'going' | 'not_going' | 'maybe'
})

await client.message.send(jid, {
  locationMessage: { degreesLatitude: -23.5, degreesLongitude: -46.6 }
})

await client.message.send(jid, {
  contactMessage: { displayName: 'Jane', vcard: 'BEGIN:VCARD\n...\nEND:VCARD' }
})