Welcome bot

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

const client = new Client({
  token: process.env.CLOAK_TOKEN!,
  // Keep this file. The bot's identity is published to the server ONCE, so a
  // bot with no keystore works on its first run and fails on every one after.
  keystorePath: './welcome-bot.cloak-keystore.json',
  // Declare what the bot needs. A human approves a subset per server.
  requiredPermissions: ['message_send'],
  debug: process.env.DEBUG === '1',
});

client.on('ready', () => {
  console.log(`Logged in as bot ${client.user?.id}`);
  console.log('Firehose active: listening in every channel of every server the bot is in.');
});

// A bot is a first-class member, so it can react to being added or removed.
client.on('guildCreate', (guild) => console.log(`in server ${guild.id}`));
client.on('guildDelete', (guild) => console.log(`removed from server ${guild.id}`));

// The server pushes the resolved grant, per server. Declaring is not being granted.
client.on('permissionsUpdate', ({ serverId, effectiveRank, ...perms }) => {
  console.log(`permissions for ${serverId}: send=${perms.message_send} rank=${effectiveRank}`);
});

// Greet new members. A join arrives as a system message.
client.on('systemMessage', (evt) => {
  if (evt.type !== 'member_join') return;
  // Advisory pre-gate: skip the greeting if the server did not grant send here.
  if (!client.can('message_send', evt.serverId)) return;
  client
    .send(evt.serverId, evt.channelId, `Welcome, ${evt.actorName || 'friend'}!`, {
      groupId: evt.groupId,
    })
    .catch((e) => console.error('welcome send failed', e));
});

// Answer !ping anywhere, including in a DM.
client.on('messageCreate', (msg) => {
  if (msg.authorId === client.user?.id) return; // ignore our own messages
  if (msg.content.trim() !== '!ping') return;
  // serverId is null in a DM, and the advisory gate is a server concept, so
  // skip it there. channel.send() routes back into the DM either way.
  if (msg.serverId && !client.can('message_send', msg.serverId)) return;
  msg.channel.send('pong').catch((e) => console.error('send failed', e));
});

// Connection lifecycle, useful while you are getting started.
client.on('disconnect', (e) => console.warn('disconnected', e));
client.on('reconnecting', ({ attempt, delayMs }) =>
  console.log(`reconnecting (attempt ${attempt}) in ${delayMs}ms`),
);
client.on('reconnected', () => console.log('reconnected'));

client.login().catch((e) => {
  console.error('login failed', e);
  process.exit(1);
});