feat: initial prototype — core game systems (#30)

## Summary This PR represents the full v1 prototype, implementing the core game systems for Elysium. - Full idle/clicker RPG loop: resource collection, crafting, boss fights, exploration, and quests - Adventurer hiring with batch size selector and progressive tier cost scaling - Prestige, transcendence, and apotheosis systems with auto-prestige support - Character sheet, titles, leaderboards, companion system, and daily login bonuses - Auto-quest and auto-boss toggles - Discord webhook notifications on prestige/transcendence/apotheosis - Discord role awarded on apotheosis - Responsive design and overarching story/lore system - In-game sound effects and browser notifications for key events - Support link button in the resource bar - Full test coverage (100% on `apps/api` and `packages/types`) - CI pipeline: lint → build → test ## Closes Closes #1 Closes #2 Closes #3 Closes #4 Closes #5 Closes #6 Closes #7 Closes #8 Closes #9 Closes #10 Closes #11 Closes #12 Closes #13 Closes #14 Closes #16 Closes #19 Closes #20 Closes #21 Closes #22 Closes #23 Closes #24 Closes #25 Closes #26 Closes #27 Closes #29 ✨ This issue was created with help from Hikari~ 🌸 Co-authored-by: Naomi Carrigan <commits@nhcarrigan.com> Reviewed-on: #30 Co-authored-by: Hikari <hikari@nhcarrigan.com> Co-committed-by: Hikari <hikari@nhcarrigan.com>
2026-03-08 15:53:39 -07:00
parent c69e155de3
commit 29c817230d
172 changed files with 50706 additions and 0 deletions
@@ -0,0 +1,266 @@
+/**
+ * @file Profile routes handling player profile retrieval and updates.
+ * @copyright nhcarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+/* eslint-disable max-lines-per-function -- Route handlers require many steps */
+/* eslint-disable complexity -- Route handlers have inherent complexity */
+/* eslint-disable stylistic/key-spacing -- ProfileSettings keys exceed max-len when aligned */
+/* eslint-disable stylistic/max-len -- ProfileSettings key names exceed line length limit */
+/* eslint-disable @typescript-eslint/no-unnecessary-condition -- Defensive checks for runtime nullable fields */
+import {
+  DEFAULT_PROFILE_SETTINGS,
+  type GameState,
+  type ProfileSettings,
+  type UpdateProfileRequest,
+} from "@elysium/types";
+import { Hono } from "hono";
+import { gameTitles } from "../data/titles.js";
+import { prisma } from "../db/client.js";
+import { authMiddleware } from "../middleware/auth.js";
+import { parseUnlockedTitles } from "../services/titles.js";
+import type { HonoEnvironment } from "../types/hono.js";
+
+const profileRouter = new Hono<HonoEnvironment>();
+
+const validNumberFormats = new Set([ "suffix", "scientific", "engineering" ]);
+
+/**
+ * Parses a raw profile settings blob from the database into a typed ProfileSettings object.
+ * @param raw - The raw value from the database.
+ * @returns A valid ProfileSettings object with defaults for missing fields.
+ */
+const parseProfileSettings = (raw: unknown): ProfileSettings => {
+  if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+    return { ...DEFAULT_PROFILE_SETTINGS };
+  }
+  /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Runtime shape check */
+  const rawObject = raw as Record<string, unknown>;
+  /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Runtime shape check */
+  const parsedNumberFormat = rawObject.numberFormat as string;
+  const numberFormat = validNumberFormats.has(parsedNumberFormat)
+    /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Runtime shape check */
+    ? (parsedNumberFormat as ProfileSettings["numberFormat"])
+    : "suffix";
+  return {
+    enableNotifications: rawObject.enableNotifications === true,
+    enableSounds: rawObject.enableSounds === true,
+    numberFormat: numberFormat,
+    showAchievementsUnlocked: rawObject.showAchievementsUnlocked !== false,
+    showAdventurersRecruited: rawObject.showAdventurersRecruited !== false,
+    showApotheosis: rawObject.showApotheosis !== false,
+    showBossesDefeated: rawObject.showBossesDefeated !== false,
+    showCurrentClicks: rawObject.showCurrentClicks !== false,
+    showCurrentGold: rawObject.showCurrentGold !== false,
+    showGuildFounded: rawObject.showGuildFounded !== false,
+    showLifetimeAchievementsUnlocked: rawObject.showLifetimeAchievementsUnlocked !== false,
+    showLifetimeAdventurersRecruited: rawObject.showLifetimeAdventurersRecruited !== false,
+    showLifetimeBossesDefeated: rawObject.showLifetimeBossesDefeated !== false,
+    showLifetimeQuestsCompleted: rawObject.showLifetimeQuestsCompleted !== false,
+    showOnLeaderboards: rawObject.showOnLeaderboards !== false,
+    showPrestige: rawObject.showPrestige !== false,
+    showQuestsCompleted: rawObject.showQuestsCompleted !== false,
+    showTotalClicks: rawObject.showTotalClicks !== false,
+    showTotalGold: rawObject.showTotalGold !== false,
+    showTranscendence: rawObject.showTranscendence !== false,
+  };
+};
+
+/**
+ * Resolves a title ID to its display name.
+ * @param id - The title ID to resolve.
+ * @returns An object with id and name fields.
+ */
+const resolveTitle = (id: string): { id: string; name: string } => {
+  const title = gameTitles.find((gameTitle) => {
+    return gameTitle.id === id;
+  });
+  return { id: id, name: title?.name ?? id };
+};
+
+profileRouter.get("/:discordId", async(context) => {
+  const { discordId } = context.req.param();
+
+  const [ player, gameStateRecord ] = await Promise.all([
+    prisma.player.findUnique({ where: { discordId } }),
+    prisma.gameState.findUnique({ where: { discordId } }),
+  ]);
+
+  if (!player) {
+    return context.json({ error: "Player not found" }, 404);
+  }
+
+  /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Prisma returns JsonValue */
+  const state = gameStateRecord?.state as unknown as GameState | undefined;
+  const prestigeCount = state?.prestige.count ?? 0;
+  const transcendenceCount = state?.transcendence?.count ?? 0;
+  const apotheosisCount = state?.apotheosis?.count ?? 0;
+  const profileSettings = parseProfileSettings(player.profileSettings);
+
+  const bossesDefeated
+    = state?.bosses.filter((boss) => {
+      return boss.status === "defeated";
+    }).length ?? 0;
+  const questsCompleted
+    = state?.quests.filter((quest) => {
+      return quest.status === "completed";
+    }).length ?? 0;
+
+  let adventurersRecruited = 0;
+  if (state) {
+    // eslint-disable-next-line capitalized-comments -- v8 ignore
+    /* v8 ignore next 3 -- @preserve */
+    for (const adventurer of state.adventurers) {
+      adventurersRecruited = adventurersRecruited + adventurer.count;
+    }
+  }
+
+  // eslint-disable-next-line capitalized-comments -- v8 ignore
+  /* v8 ignore next 3 -- @preserve */
+  const achievementsUnlocked = (state?.achievements ?? []).filter((achievement) => {
+    return achievement.unlockedAt !== null;
+  }).length;
+
+  const unlockedTitleIds = parseUnlockedTitles(player.unlockedTitles);
+  const unlockedTitles = unlockedTitleIds.map((id) => {
+    return resolveTitle(id);
+  });
+
+  // eslint-disable-next-line capitalized-comments -- v8 ignore
+  /* v8 ignore next 12 -- @preserve */
+  const equippedItems = (state?.equipment ?? []).
+    filter((item) => {
+      return item.owned && item.equipped;
+    }).
+    map((item) => {
+      return {
+        bonus:  item.bonus,
+        name:   item.name,
+        rarity: item.rarity,
+        type:   item.type,
+      };
+    });
+
+  return context.json({
+    achievementsUnlocked: achievementsUnlocked,
+    activeTitle: player.activeTitle,
+    adventurersRecruited: adventurersRecruited,
+    apotheosisCount: apotheosisCount,
+    avatar: player.avatar,
+    bio: player.bio ?? "",
+    bossesDefeated: bossesDefeated,
+    characterClass: player.characterClass,
+    characterName: player.characterName,
+    characterRace: player.characterRace ?? "",
+    createdAt: player.createdAt,
+    currentRunClicks: state?.player.totalClicks ?? 0,
+    currentRunGold: state?.player.totalGoldEarned ?? 0,
+    equippedItems: equippedItems,
+    guildDescription: player.guildDescription,
+    guildName: player.guildName,
+    lifetimeAchievementsUnlocked: player.lifetimeAchievementsUnlocked,
+    lifetimeAdventurersRecruited: player.lifetimeAdventurersRecruited,
+    lifetimeBossesDefeated: player.lifetimeBossesDefeated,
+    lifetimeQuestsCompleted: player.lifetimeQuestsCompleted,
+    prestigeCount: prestigeCount,
+    profileSettings: profileSettings,
+    pronouns: player.pronouns ?? "",
+    questsCompleted: questsCompleted,
+    totalClicks: player.lifetimeClicks,
+    totalGoldEarned: player.lifetimeGoldEarned,
+    transcendenceCount: transcendenceCount,
+    unlockedTitles: unlockedTitles,
+    username: player.username,
+  });
+});
+
+profileRouter.put("/", authMiddleware, async(context) => {
+  const discordId = context.get("discordId");
+  const body = await context.req.json<UpdateProfileRequest>();
+
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions -- Runtime body validation
+  if (!body.characterName) {
+    return context.json({ error: "Character name cannot be empty" }, 400);
+  }
+
+  const characterName = body.characterName.trim().slice(0, 32);
+
+  if (characterName === "") {
+    return context.json({ error: "Character name cannot be empty" }, 400);
+  }
+
+  const pronouns = (body.pronouns ?? "").trim().slice(0, 20);
+  const characterRace = (body.characterRace ?? "").trim().slice(0, 32);
+  const characterClass = (body.characterClass ?? "").trim().slice(0, 32);
+  const bio = (body.bio ?? "").trim().slice(0, 200);
+  const guildName = (body.guildName ?? "").trim().slice(0, 64);
+  const guildDescription = (body.guildDescription ?? "").trim().slice(0, 500);
+  // eslint-disable-next-line capitalized-comments -- v8 ignore
+  /* v8 ignore next 2 -- @preserve */
+  /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Runtime shape check */
+  const parsedNumberFormat = (body.profileSettings.numberFormat ?? "") as string;
+  const numberFormat = validNumberFormats.has(parsedNumberFormat)
+    /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Runtime shape check */
+    ? (parsedNumberFormat as ProfileSettings["numberFormat"])
+    : "suffix";
+  const profileSettings: ProfileSettings = {
+    enableNotifications: body.profileSettings.enableNotifications ?? false,
+    enableSounds: body.profileSettings.enableSounds ?? false,
+    numberFormat: numberFormat,
+    showAchievementsUnlocked: body.profileSettings.showAchievementsUnlocked ?? true,
+    showAdventurersRecruited: body.profileSettings.showAdventurersRecruited ?? true,
+    showApotheosis: body.profileSettings.showApotheosis ?? true,
+    showBossesDefeated: body.profileSettings.showBossesDefeated ?? true,
+    showCurrentClicks: body.profileSettings.showCurrentClicks ?? true,
+    showCurrentGold: body.profileSettings.showCurrentGold ?? true,
+    showGuildFounded: body.profileSettings.showGuildFounded ?? true,
+    showLifetimeAchievementsUnlocked: body.profileSettings.showLifetimeAchievementsUnlocked ?? true,
+    showLifetimeAdventurersRecruited: body.profileSettings.showLifetimeAdventurersRecruited ?? true,
+    showLifetimeBossesDefeated: body.profileSettings.showLifetimeBossesDefeated ?? true,
+    showLifetimeQuestsCompleted: body.profileSettings.showLifetimeQuestsCompleted ?? true,
+    showOnLeaderboards: body.profileSettings.showOnLeaderboards ?? true,
+    showPrestige: body.profileSettings.showPrestige ?? true,
+    showQuestsCompleted: body.profileSettings.showQuestsCompleted ?? true,
+    showTotalClicks: body.profileSettings.showTotalClicks ?? true,
+    showTotalGold: body.profileSettings.showTotalGold ?? true,
+    showTranscendence: body.profileSettings.showTranscendence ?? true,
+  };
+
+  const activeTitle
+    = typeof body.activeTitle === "string"
+      ? body.activeTitle.slice(0, 64)
+      : undefined;
+
+  const updated = await prisma.player.update({
+    data: {
+      bio: bio,
+      characterClass: characterClass,
+      characterName: characterName,
+      characterRace: characterRace,
+      guildDescription: guildDescription,
+      guildName: guildName,
+      /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Prisma requires object */
+      profileSettings: profileSettings as object,
+      pronouns: pronouns,
+      ...activeTitle === undefined
+        ? {}
+        : { activeTitle },
+    },
+    where: { discordId },
+  });
+
+  return context.json({
+    activeTitle: updated.activeTitle,
+    bio: updated.bio,
+    characterClass: updated.characterClass,
+    characterName: updated.characterName,
+    characterRace: updated.characterRace,
+    guildDescription: updated.guildDescription,
+    guildName: updated.guildName,
+    profileSettings: profileSettings,
+    pronouns: updated.pronouns,
+  });
+});
+
+export { profileRouter };