feat: error handling, logging, analytics, OG tags, and sticky sidebar (#44)

## Summary

- Add comprehensive try/catch error handling across all API routes, middleware, and the Hono global error handler, piping every unhandled error to the `@nhcarrigan/logger` service to prevent silent crashes and unhandled Promise rejections
- Add a `logError` utility on the frontend that forwards errors through the overridden `console.error` to the backend telemetry endpoint; apply it to every silent `catch {}` block in the game context, sound, notification, and clipboard utilities, and wrap the React tree in an `ErrorBoundary`
- Add Plausible analytics, Open Graph + Twitter Card meta tags, Tree-Nation widget, and Google Ads to `index.html`
- Make the game sidebar sticky with a `--resource-bar-height` CSS custom property offset so it stays viewport-height without overlapping the resource bar; reset sticky behaviour in the mobile responsive override

## Test plan

- [ ] Lint passes: `pnpm lint`
- [ ] Build passes: `pnpm build`
- [ ] Verify errors thrown in API routes appear in the logger service rather than crashing the process
- [ ] Verify frontend errors appear in the `/api/fe/error` backend log
- [ ] Verify Open Graph tags render correctly when sharing the URL
- [ ] Verify Plausible analytics fires on page load
- [ ] Verify Tree-Nation badge renders in the sidebar
- [ ] Verify sidebar stays fixed while the main content scrolls on desktop
- [ ] Verify mobile layout is unaffected

✨ This issue was created with help from Hikari~ 🌸

Reviewed-on: #44
Co-authored-by: Hikari <hikari@nhcarrigan.com>
Co-committed-by: Hikari <hikari@nhcarrigan.com>

apps/api/src/routes/leaderboards.ts

@@ -9,6 +9,7 @@
 import { Hono } from "hono";
 import { gameTitles } from "../data/titles.js";
 import { prisma } from "../db/client.js";
+import { logger } from "../services/logger.js";
 import type { HonoEnvironment } from "../types/hono.js";
 import type { GameState } from "@elysium/types";
 
@@ -58,70 +59,80 @@ const resolveTitleName = (titleId: string | null): string => {
 };
 
 leaderboardRouter.get("/", async(context) => {
-  const category = context.req.query("category") ?? "totalGold";
-  const limitRaw = Number(context.req.query("limit") ?? "100");
-  const limit = Math.min(Math.max(1, limitRaw), 100);
+  try {
+    const category = context.req.query("category") ?? "totalGold";
+    const limitRaw = Number(context.req.query("limit") ?? "100");
+    const limit = Math.min(Math.max(1, limitRaw), 100);
 
-  if (!validCategories.has(category)) {
-    return context.json({ error: "Invalid category" }, 400);
-  }
+    if (!validCategories.has(category)) {
+      return context.json({ error: "Invalid category" }, 400);
+    }
 
-  const [ players, gameStates ] = await Promise.all([
-    prisma.player.findMany(),
-    gameStateCategories.has(category)
-      ? prisma.gameState.findMany()
-      : Promise.resolve([]),
-  ]);
+    const [ players, gameStates ] = await Promise.all([
+      prisma.player.findMany(),
+      gameStateCategories.has(category)
+        ? prisma.gameState.findMany()
+        : Promise.resolve([]),
+    ]);
 
-  const stateMap = new Map(
-    gameStates.map((gs) => {
-      /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Prisma returns JsonValue */
-      return [ gs.discordId, gs.state as unknown as GameState ];
-    }),
-  );
+    const stateMap = new Map(
+      gameStates.map((gs) => {
+        /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Prisma returns JsonValue */
+        return [ gs.discordId, gs.state as unknown as GameState ];
+      }),
+    );
 
-  const entries = players.
-    filter((player) => {
-      return parseShowOnLeaderboards(player.profileSettings);
-    }).
-    map((player) => {
-      let value = 0;
-      if (category === "totalGold") {
-        value = player.lifetimeGoldEarned;
-      } else if (category === "bossesDefeated") {
-        value = player.lifetimeBossesDefeated;
-      } else if (category === "questsCompleted") {
-        value = player.lifetimeQuestsCompleted;
-      } else if (category === "achievementsUnlocked") {
-        value = player.lifetimeAchievementsUnlocked;
-      } else {
-        const state = stateMap.get(player.discordId);
-        if (category === "prestigeCount") {
-          value = state?.prestige.count ?? 0;
-        } else if (category === "transcendenceCount") {
-          value = state?.transcendence?.count ?? 0;
-        } else if (category === "apotheosisCount") {
-          value = state?.apotheosis?.count ?? 0;
+    const entries = players.
+      filter((player) => {
+        return parseShowOnLeaderboards(player.profileSettings);
+      }).
+      map((player) => {
+        let value = 0;
+        if (category === "totalGold") {
+          value = player.lifetimeGoldEarned;
+        } else if (category === "bossesDefeated") {
+          value = player.lifetimeBossesDefeated;
+        } else if (category === "questsCompleted") {
+          value = player.lifetimeQuestsCompleted;
+        } else if (category === "achievementsUnlocked") {
+          value = player.lifetimeAchievementsUnlocked;
+        } else {
+          const state = stateMap.get(player.discordId);
+          if (category === "prestigeCount") {
+            value = state?.prestige.count ?? 0;
+          } else if (category === "transcendenceCount") {
+            value = state?.transcendence?.count ?? 0;
+          } else if (category === "apotheosisCount") {
+            value = state?.apotheosis?.count ?? 0;
+          }
         }
-      }
-      return {
-        activeTitle:   resolveTitleName(player.activeTitle),
-        avatar:        player.avatar ?? null,
-        characterName: player.characterName,
-        discordId:     player.discordId,
-        username:      player.username,
-        value:         value,
-      };
-    }).
-    sort((a, b) => {
-      return b.value - a.value;
-    }).
-    slice(0, limit).
-    map((entry, index) => {
-      return { ...entry, rank: index + 1 };
-    });
+        return {
+          activeTitle:   resolveTitleName(player.activeTitle),
+          avatar:        player.avatar ?? null,
+          characterName: player.characterName,
+          discordId:     player.discordId,
+          username:      player.username,
+          value:         value,
+        };
+      }).
+      sort((a, b) => {
+        return b.value - a.value;
+      }).
+      slice(0, limit).
+      map((entry, index) => {
+        return { ...entry, rank: index + 1 };
+      });
 
-  return context.json({ category, entries });
+    return context.json({ category, entries });
+  } catch (error) {
+    void logger.error(
+      "leaderboards",
+      error instanceof Error
+        ? error
+        : new Error(String(error)),
+    );
+    return context.json({ error: "Internal server error" }, 500);
+  }
 });
 
 export { leaderboardRouter };