Forum helper bot

import { Client, ChannelType, CloakActionError } 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: './forum-helper-bot.cloak-keystore.json',
  // Forums add no permission names. Sending inside a post is message_send
  // resolved against the forum; marking someone else's post as answered is
  // post moderation, which is message_manage.
  requiredPermissions: ['view_text', 'message_send', 'message_manage', 'message_read_history'],
  debug: process.env.DEBUG === '1',
});

client.on('ready', () => console.log(`Logged in as bot ${client.user?.id}`));

client.on('messageCreate', async (msg) => {
  if (msg.authorId === client.user?.id) return; // ignore our own messages
  if (msg.isDM || !msg.serverId) return; // forums are server-only
  const serverId = msg.serverId;

  // 1. A new post. The starter never rides the ordinary stream: the SDK emits
  //    it from the post's create event with starter: true, and the frame
  //    carries the parent forum, so forumChannelId is always set here.
  if (msg.starter && msg.postId && msg.forumChannelId) {
    const meta = await client.fetchForumMeta(serverId, msg.forumChannelId);
    const intro = meta.guidelines
      ? `Thanks for posting. This forum's guidelines:\n${meta.guidelines}`
      : 'Thanks for posting. Reply to the message that solves this with !solved to mark it.';
    // Sending into a post: the PARENT forum channel plus { postId }.
    await client.send(serverId, msg.forumChannelId, intro, { postId: msg.postId });
    await client.followForumPost(serverId, msg.forumChannelId, msg.postId, true);
    return;
  }

  // 2. "!solved" as a reply inside a post marks the quoted message as the answer.
  if (msg.postId && msg.forumChannelId && msg.content.trim() === '!solved') {
    if (!msg.repliedTo) {
      await msg.channel.send('Reply to the message that solved it with !solved.');
      return;
    }
    try {
      // A reply pointer carries messageId, authorId and createdAt, which is
      // exactly what 'answered' wants.
      await client.setForumPostState(serverId, msg.forumChannelId, msg.postId, 'answered', msg.repliedTo);
      await msg.channel.send('Marked as the accepted answer.');
    } catch (e) {
      if (e instanceof CloakActionError) {
        // -2: not the post's author, and no message_manage.
        await msg.channel.send(`Could not mark it: ${e.message}`);
        return;
      }
      throw e;
    }
    return;
  }

  // 3. "!unanswered" in a text channel lists open posts with no accepted answer.
  if (!msg.postId && !msg.threadId && msg.content.trim() === '!unanswered') {
    const channels = await client.fetchChannels(serverId);
    const forums = channels.filter((c) => c.type === ChannelType.FORUM);
    if (forums.length === 0) {
      await msg.channel.send('No forum channels here that I can see.');
      return;
    }
    const lines: string[] = [];
    for (const forum of forums) {
      const { posts, hasMore } = await client.fetchForumPosts(serverId, forum.id, {
        solved: false,
        includeArchived: false,
        limit: 10,
      });
      for (const post of posts) {
        lines.push(`${forum.name}: ${post.title || '(untitled)'} (${post.replyCount} replies)`);
      }
      if (hasMore) lines.push(`${forum.name}: and more`);
    }
    await msg.channel.send(lines.length ? lines.join('\n') : 'Everything is answered.');
  }
});

client.on('forumPostUpdate', (post) => {
  if (post.answered) console.log(`post ${post.postId} solved by ${post.answered.authorId}`);
});
client.on('forumPostDelete', ({ postId }) => console.log(`post ${postId} deleted`));

client.on('sendRejected', (r) => console.warn(`send rejected (${r.code}): ${r.message}`));
client.on('error', (e) => console.error('sdk error', e.source, e.context, e.message));
client.on('disconnect', (e) => console.warn('disconnected', e));

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