feat: client and server logic to manage announcements (#3)

### Explanation

_No response_

### Issue

_No response_

### Attestations

- [x] I have read and agree to the [Code of Conduct](https://docs.nhcarrigan.com/community/coc/)
- [x] I have read and agree to the [Community Guidelines](https://docs.nhcarrigan.com/community/guide/).
- [x] My contribution complies with the [Contributor Covenant](https://docs.nhcarrigan.com/dev/covenant/).

### Dependencies

- [x] I have pinned the dependencies to a specific patch version.

### Style

- [x] I have run the linter and resolved any errors.
- [x] My pull request uses an appropriate title, matching the conventional commit standards.
- [x] My scope of feat/fix/chore/etc. correctly matches the nature of changes in my pull request.

### Tests

- [ ] My contribution adds new code, and I have added tests to cover it.
- [ ] My contribution modifies existing code, and I have updated the tests to reflect these changes.
- [ ] All new and existing tests pass locally with my changes.
- [ ] Code coverage remains at or above the configured threshold.

### Documentation

_No response_

### Versioning

_No response_

Reviewed-on: #3
Co-authored-by: Naomi Carrigan <commits@nhcarrigan.com>
Co-committed-by: Naomi Carrigan <commits@nhcarrigan.com>

server/src/routes/announcement.ts

@@ -0,0 +1,110 @@
+/**
+ * @copyright nhcarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+import { blockedIps } from "../cache/blockedIps.js";
+import { database } from "../db/database.js";
+import { announceOnDiscord } from "../modules/announceOnDiscord.js";
+import { announceOnForum } from "../modules/announceOnForum.js";
+import { getIpFromRequest } from "../modules/getIpFromRequest.js";
+import type { FastifyPluginAsync } from "fastify";
+
+const oneDay = 24 * 60 * 60 * 1000;
+
+/**
+ * Mounts the entry routes for the application. These routes
+ * should not require CORS, as they are used by external services
+ * such as our uptime monitor.
+ * @param server - The Fastify server instance.
+ */
+export const announcementRoutes: FastifyPluginAsync = async(server) => {
+  server.get("/announcements", async(_request, reply) => {
+    const announcements = await database.getInstance().announcements.findMany({
+      orderBy: {
+        createdAt: "desc",
+      },
+      take: 10,
+    });
+    return await reply.status(200).type("application/json").
+      send(announcements.map((announcement) => {
+        return {
+          content:   announcement.content,
+          createdAt: announcement.createdAt,
+          title:     announcement.title,
+          type:      announcement.type,
+        };
+      }));
+  });
+
+  // eslint-disable-next-line @typescript-eslint/naming-convention -- Fastify requires Body instead of body.
+  server.post<{ Body: { title: string; content: string; type: string } }>(
+    "/announcement",
+    // eslint-disable-next-line complexity -- This is a complex route, but it is necessary to validate the announcement.
+    async(request, reply) => {
+      const token = request.headers.authorization;
+      if (token === undefined || token !== process.env.ANNOUNCEMENT_TOKEN) {
+        blockedIps.push({
+          ip:  getIpFromRequest(request),
+          ttl: new Date(Date.now() + oneDay),
+        });
+        return await reply.status(401).send({
+          error:
+            // eslint-disable-next-line stylistic/max-len -- Big boi string.
+            "This endpoint requires a special auth token. If you believe you should have access, please contact Naomi. To protect our services, your IP has been blocked from all routes for 24 hours.",
+        });
+      }
+
+      const { title, content, type } = request.body;
+      if (
+        typeof title !== "string"
+        || typeof content !== "string"
+        || typeof type !== "string"
+        || title.length === 0
+        || content.length === 0
+        || type.length === 0
+      ) {
+        return await reply.status(400).send({
+          error: "Missing required fields.",
+        });
+      }
+
+      if (title.length < 20) {
+        return await reply.status(400).send({
+          error:
+            // eslint-disable-next-line stylistic/max-len -- Big boi string.
+            "Title must be at least 20 characters long so that it may be posted on our forum.",
+        });
+      }
+
+      if (content.length < 50) {
+        return await reply.status(400).send({
+          error:
+            // eslint-disable-next-line stylistic/max-len -- Big boi string.
+            "Content must be at least 50 characters long so that it may be posted on our forum.",
+        });
+      }
+
+      if (type !== "products" && type !== "community") {
+        return await reply.status(400).send({
+          error: "Invalid announcement type.",
+        });
+      }
+
+      await database.getInstance().announcements.create({
+        data: {
+          content,
+          title,
+          type,
+        },
+      });
+
+      const discord = await announceOnDiscord(title, content, type);
+      const forum = await announceOnForum(title, content, type);
+      return await reply.status(201).send({
+        message: `Announcement processed. Discord: ${discord}, Forum: ${forum}`,
+      });
+    },
+  );
+};

server/src/routes/base.ts

@@ -0,0 +1,23 @@
+/**
+ * @copyright nhcarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+import type { FastifyPluginAsync } from "fastify";
+
+/**
+ * Mounts the entry routes for the application. These routes
+ * should not require CORS, as they are used by external services
+ * such as our uptime monitor.
+ * @param server - The Fastify server instance.
+ */
+export const baseRoutes: FastifyPluginAsync = async(server) => {
+  server.get("/", async(_request, reply) => {
+    return await reply.redirect("https://hikari.nhcarrigan.com");
+  });
+
+  server.get("/health", async(_request, reply) => {
+    return await reply.status(200).send("OK~!");
+  });
+};