Events

client.on('messageCreate', (msg) => {
  // msg is typed as Message
});

client.on('messageCreate', async (msg) => {
  if (msg.authorId === client.user?.id) return; // ignore our own messages

  if (msg.isDM || !msg.serverId) {
    await msg.channel.send('thanks, I got that');
    return;
  }

  // server-scoped work is safe from here on
  if (!client.can('message_send', msg.serverId)) return;
  if (msg.content.trim() === '!ping') await msg.channel.send('pong');
});

client.on('messageUpdate', ({ messageId, content }) => {
  console.log(`message ${messageId} is now: ${content}`);
});

client.on('messageUpdate', (e) => {
  if (e.card === undefined) return; // a plain text edit
  console.log(`card on ${e.messageId} now has ${e.card?.components.length ?? 0} rows`);
});

client.on('messageDelete', ({ messageId, channelId }) => {
  console.log(`message ${messageId} deleted in ${channelId}`);
});

client.on('sendRejected', (r) => {
  console.warn(`send denied (${r.code}): ${r.message}`);
  if (r.permission) console.warn(`missing ${r.permission}`);
  if (r.attribution !== 'exact') console.warn(`route is a hint (${r.attribution})`);
});

client.on('reactionUpdate', ({ messageId, reactionId, count, operation }) => {
  console.log(`${reactionId} on ${messageId} is now ${count} (${operation})`);
});

client.on('pinUpdate', ({ messageId, pinned }) => {
  console.log(`message ${messageId} ${pinned ? 'pinned' : 'unpinned'}`);
});

client.on('pollUpdate', (p) => {
  console.log(`${p.messageId}: ${p.counts?.join(' / ') ?? 'hidden'} (${p.totalVoters ?? '?'} voters)`);
});

client.on('forumPostUpdate', (post) => {
  console.log(`post ${post.postId} in ${post.forumChannelId}: "${post.title}" (${post.replyCount} replies)`);
});

client.on('interaction', async (i) => {
  if (i.kind === 'button' && i.customId === 'approve') {
    await i.ephemeral({ content: 'Approved.' });
  }
});

client.on('typing', ({ userId, isTyping }) => {
  if (userId === client.user?.id) return; // our own sendTyping() echoes back
  console.log(`${userId} is ${isTyping ? 'typing' : 'done'}`);
});

client.on('permissionsUpdate', ({ serverId, effectiveRank, ...perms }) => {
  console.log(`send in ${serverId}: ${perms.message_send}, rank ${effectiveRank}`);
});

client.on('commandError', ({ name, reason, error }) => {
  console.error(`/${name} failed (${reason})`, error);
});

client.on('voiceKeyUpdate', ({ serverId, version, scope }) => {
  console.log(`voice key for ${serverId} is now v${version}, scope ${scope}`);
});

client.on('disconnect', (err) => console.warn('connection dropped', err));

client.on('reconnecting', ({ attempt, delayMs }) =>
  console.log(`reconnecting (attempt ${attempt}) in ${delayMs}ms`),
);

client.on('reconnected', () => console.log('back online'));

import type { CloakClientError } from '@cloak-software/bot-sdk';

client.on('error', (e: CloakClientError) => {
  console.error(e.source, e.context, e.message);
  console.error(e.cause); // the original failure
});

client.on('raw', (frame) => {
  console.log('opcode', frame[0]);
});