feat: syndicate freeCodeCamp news posts

src/modules/postNews.ts

@@ -0,0 +1,57 @@
+/**
+ * @copyright NHCarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+import { ChannelType } from "discord.js";
+// eslint-disable-next-line @typescript-eslint/naming-convention -- Importing a class.
+import Parser from "rss-parser";
+import { ids } from "../config/ids.js";
+import { logger } from "../utils/logger.js";
+import type { Amari } from "../interfaces/amari.js";
+import type { FreeCodeCampRSS } from "../interfaces/rss.js";
+
+/**
+ * Fetches the RSS feed from freeCodeCamp News and posts the latest updates.
+ * @param amari - Amari's instance.
+ */
+const postFreeCodeCampNews = async(amari: Amari): Promise<void> => {
+  try {
+    const parser = new Parser<FreeCodeCampRSS, FreeCodeCampRSS["items"]>();
+    const { items }
+      = await parser.parseURL("https://www.freecodecamp.org/news/rss");
+    if (amari.lastRssItems.freeCodeCamp === null) {
+      amari.lastRssItems.freeCodeCamp = items[0]?.guid ?? null;
+      return;
+    }
+    const lastIndex = items.findIndex((item) => {
+      return item.guid === amari.lastRssItems.freeCodeCamp;
+    });
+    const latestPosts
+      = lastIndex > -1
+        ? items.slice(0, Math.min(lastIndex, 5))
+        : items.slice(0, 5);
+    const channel
+      = amari.discord.channels.cache.get(ids.channels.news)
+      ?? await amari.discord.channels.fetch(ids.channels.news);
+    if (channel === null) {
+      throw new Error("Cannot find news channel.");
+    }
+    if (!channel.isSendable()) {
+      throw new Error("News channel is not sendable.");
+    }
+    await Promise.all(latestPosts.map(async(post) => {
+      const sent = await channel.send(post.link);
+      if (channel.type === ChannelType.GuildAnnouncement) {
+        await sent.crosspost();
+      }
+    }));
+  } catch (error) {
+    if (error instanceof Error) {
+      await logger.error("post freecodecamp news module", error);
+    }
+  }
+};
+
+export { postFreeCodeCampNews };