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,153 @@
+/* eslint-disable max-lines-per-function -- Test suites naturally have many cases */
+/* eslint-disable max-lines -- Test suites naturally have many cases */
+/* eslint-disable @typescript-eslint/consistent-type-assertions -- Tests build minimal state objects */
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { Hono } from "hono";
+import type { GameState } from "@elysium/types";
+
+vi.mock("../../src/db/client.js", () => ({
+  prisma: {
+    player: { update: vi.fn() },
+    gameState: { findUnique: vi.fn(), update: vi.fn() },
+  },
+}));
+
+vi.mock("../../src/middleware/auth.js", () => ({
+  authMiddleware: vi.fn(async (c: { set: (key: string, value: string) => void }, next: () => Promise<void>) => {
+    c.set("discordId", "test_discord_id");
+    await next();
+  }),
+}));
+
+vi.mock("../../src/services/webhook.js", () => ({
+  postMilestoneWebhook: vi.fn().mockResolvedValue(undefined),
+}));
+
+const DISCORD_ID = "test_discord_id";
+
+const makeState = (overrides: Partial<GameState> = {}): GameState => ({
+  player: { discordId: DISCORD_ID, username: "u", discriminator: "0", avatar: null, totalGoldEarned: 0, totalClicks: 0, characterName: "T" },
+  resources: { gold: 0, essence: 0, crystals: 0, runestones: 0 },
+  adventurers: [],
+  upgrades: [],
+  quests: [],
+  bosses: [{ id: "the_absolute_one", status: "defeated" }] as GameState["bosses"],
+  equipment: [],
+  achievements: [],
+  zones: [],
+  exploration: { areas: [], materials: [], craftedRecipeIds: [], craftedGoldMultiplier: 1, craftedEssenceMultiplier: 1, craftedClickMultiplier: 1, craftedCombatMultiplier: 1 },
+  companions: { unlockedCompanionIds: [], activeCompanionId: null },
+  prestige: { count: 0, runestones: 0, productionMultiplier: 1, purchasedUpgradeIds: [] },
+  baseClickPower: 1,
+  lastTickAt: 0,
+  schemaVersion: 1,
+  ...overrides,
+} as GameState);
+
+describe("transcendence route", () => {
+  let app: Hono;
+  let prisma: {
+    player: { update: ReturnType<typeof vi.fn> };
+    gameState: { findUnique: ReturnType<typeof vi.fn>; update: ReturnType<typeof vi.fn> };
+  };
+
+  beforeEach(async () => {
+    vi.clearAllMocks();
+    const { transcendenceRouter } = await import("../../src/routes/transcendence.js");
+    const { prisma: p } = await import("../../src/db/client.js");
+    prisma = p as typeof prisma;
+    app = new Hono();
+    app.route("/transcendence", transcendenceRouter);
+  });
+
+  const post = (path: string, body?: Record<string, unknown>) =>
+    app.fetch(new Request(`http://localhost/transcendence${path}`, {
+      method: "POST",
+      headers: body ? { "Content-Type": "application/json" } : undefined,
+      body: body ? JSON.stringify(body) : undefined,
+    }));
+
+  describe("POST /", () => {
+    it("returns 404 when no save is found", async () => {
+      vi.mocked(prisma.gameState.findUnique).mockResolvedValueOnce(null);
+      const res = await post("");
+      expect(res.status).toBe(404);
+    });
+
+    it("returns 400 when the absolute one is not defeated", async () => {
+      const state = makeState({ bosses: [] });
+      vi.mocked(prisma.gameState.findUnique).mockResolvedValueOnce({ state } as never);
+      const res = await post("");
+      expect(res.status).toBe(400);
+    });
+
+    it("returns echoes and count on successful transcendence", async () => {
+      const state = makeState();
+      vi.mocked(prisma.gameState.findUnique).mockResolvedValueOnce({ state } as never);
+      vi.mocked(prisma.gameState.update).mockResolvedValueOnce({} as never);
+      vi.mocked(prisma.player.update).mockResolvedValueOnce({} as never);
+      const res = await post("");
+      expect(res.status).toBe(200);
+      const body = await res.json() as { echoes: number; newTranscendenceCount: number };
+      expect(body.newTranscendenceCount).toBe(1);
+      expect(body.echoes).toBeGreaterThanOrEqual(0);
+    });
+  });
+
+  describe("POST /buy-upgrade", () => {
+    it("returns 400 when upgradeId is missing", async () => {
+      const res = await post("/buy-upgrade", {});
+      expect(res.status).toBe(400);
+    });
+
+    it("returns 404 for unknown upgrade", async () => {
+      const res = await post("/buy-upgrade", { upgradeId: "nonexistent_echo" });
+      expect(res.status).toBe(404);
+    });
+
+    it("returns 404 when no save is found", async () => {
+      vi.mocked(prisma.gameState.findUnique).mockResolvedValueOnce(null);
+      const res = await post("/buy-upgrade", { upgradeId: "echo_income_1" });
+      expect(res.status).toBe(404);
+    });
+
+    it("returns 400 when transcendence data is missing from state", async () => {
+      const state = makeState({ transcendence: undefined });
+      vi.mocked(prisma.gameState.findUnique).mockResolvedValueOnce({ state } as never);
+      const res = await post("/buy-upgrade", { upgradeId: "echo_income_1" });
+      expect(res.status).toBe(400);
+    });
+
+    it("returns 400 when upgrade is already purchased", async () => {
+      const state = makeState({
+        transcendence: { count: 1, echoes: 100, purchasedUpgradeIds: ["echo_income_1"], echoIncomeMultiplier: 1, echoCombatMultiplier: 1, echoPrestigeThresholdMultiplier: 1, echoPrestigeRunestoneMultiplier: 1, echoMetaMultiplier: 1 },
+      });
+      vi.mocked(prisma.gameState.findUnique).mockResolvedValueOnce({ state } as never);
+      const res = await post("/buy-upgrade", { upgradeId: "echo_income_1" });
+      expect(res.status).toBe(400);
+    });
+
+    it("returns 400 when not enough echoes", async () => {
+      const state = makeState({
+        transcendence: { count: 1, echoes: 0, purchasedUpgradeIds: [], echoIncomeMultiplier: 1, echoCombatMultiplier: 1, echoPrestigeThresholdMultiplier: 1, echoPrestigeRunestoneMultiplier: 1, echoMetaMultiplier: 1 },
+      });
+      vi.mocked(prisma.gameState.findUnique).mockResolvedValueOnce({ state } as never);
+      // echo_income_1 costs 5 echoes but state has 0
+      const res = await post("/buy-upgrade", { upgradeId: "echo_income_1" });
+      expect(res.status).toBe(400);
+    });
+
+    it("returns updated data on successful echo upgrade purchase", async () => {
+      const state = makeState({
+        transcendence: { count: 1, echoes: 100, purchasedUpgradeIds: [], echoIncomeMultiplier: 1, echoCombatMultiplier: 1, echoPrestigeThresholdMultiplier: 1, echoPrestigeRunestoneMultiplier: 1, echoMetaMultiplier: 1 },
+      });
+      vi.mocked(prisma.gameState.findUnique).mockResolvedValueOnce({ state } as never);
+      vi.mocked(prisma.gameState.update).mockResolvedValueOnce({} as never);
+      const res = await post("/buy-upgrade", { upgradeId: "echo_income_1" });
+      expect(res.status).toBe(200);
+      const body = await res.json() as { echoesRemaining: number; purchasedUpgradeIds: string[] };
+      expect(body.echoesRemaining).toBe(95); // 100 - 5
+      expect(body.purchasedUpgradeIds).toContain("echo_income_1");
+    });
+  });
+});