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,89 @@
+/**
+ * @file Discord webhook and role-grant utilities for milestone events.
+ * @copyright nhcarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+/* eslint-disable @typescript-eslint/naming-convention -- Discord API requires snake_case and Pascal-case header names */
+const discordApi = "https://discord.com/api/v10";
+
+/**
+ * Grants the apotheosis Discord role to the given player if configured.
+ * Fails silently so role grant errors do not affect the game action.
+ * @param discordId - The Discord user ID to grant the role to.
+ * @returns A promise that resolves when the role grant attempt completes.
+ */
+const grantApotheosisRole = async(discordId: string): Promise<void> => {
+  const botToken = process.env.DISCORD_BOT_TOKEN;
+  const guildId = process.env.DISCORD_GUILD_ID;
+  const roleId = process.env.DISCORD_APOTHEOSIS_ROLE_ID;
+
+  if (
+    botToken === undefined || botToken === ""
+    || guildId === undefined || guildId === ""
+    || roleId === undefined || roleId === ""
+  ) {
+    return;
+  }
+
+  try {
+    await fetch(
+      `${discordApi}/guilds/${guildId}/members/${discordId}/roles/${roleId}`,
+      {
+        headers: { Authorization: `Bot ${botToken}` },
+        method:  "PUT",
+      },
+    );
+  } catch {
+    // Graceful degradation — role grant failure must not affect the apotheosis
+  }
+};
+
+type MilestoneType = "prestige" | "transcendence" | "apotheosis";
+
+interface MilestoneCounts {
+  prestige:      number;
+  transcendence: number;
+  apotheosis:    number;
+}
+
+const milestoneVerbs: Record<MilestoneType, string> = {
+  apotheosis:    "reached apotheosis",
+  prestige:      "prestiged",
+  transcendence: "transcended",
+};
+
+/**
+ * Posts a milestone announcement to the configured Discord webhook.
+ * Fails silently so webhook errors do not affect the game action.
+ * @param discordId - The Discord user ID of the player.
+ * @param milestone - The type of milestone reached.
+ * @param counts - The current prestige, transcendence, and apotheosis counts.
+ * @returns A promise that resolves when the webhook post attempt completes.
+ */
+const postMilestoneWebhook = async(
+  discordId: string,
+  milestone: MilestoneType,
+  counts: MilestoneCounts,
+): Promise<void> => {
+  const webhookUrl = process.env.DISCORD_MILESTONE_WEBHOOK;
+  if (webhookUrl === undefined || webhookUrl === "") {
+    return;
+  }
+
+  const verb = milestoneVerbs[milestone];
+  /* eslint-disable-next-line @typescript-eslint/restrict-template-expressions -- counts fields are numbers, intentionally stringified */
+  const content = `<@${discordId}> has ${verb}~! They are now on Prestige ${counts.prestige}, Transcendence ${counts.transcendence}, Apotheosis ${counts.apotheosis}!`;
+
+  try {
+    await fetch(webhookUrl, {
+      body:    JSON.stringify({ content }),
+      headers: { "Content-Type": "application/json" },
+      method:  "POST",
+    });
+  } catch {
+    // Graceful degradation — webhook failure must not affect the game action
+  }
+};
+
+export { grantApotheosisRole, postMilestoneWebhook };