feat: add sync new content debug tool

Adds a new debug panel button that injects any adventurers, quests,
bosses, equipment, upgrades, achievements, zones, and exploration areas
that exist in the current game data but are missing from an existing
player save (e.g. content added after the save was first created).

apps/web/src/api/client.ts

@@ -28,6 +28,7 @@ import type {
   PublicProfileResponse,
   SaveRequest,
   SaveResponse,
+  SyncNewContentResponse,
   TranscendenceRequest,
   TranscendenceResponse,
   UpdateProfileRequest,
@@ -267,6 +268,16 @@ const forceUnlocks = async(): Promise<ForceUnlocksResponse> => {
   });
 };
 
+/**
+ * Syncs any content added after the player's save was created into their save.
+ * @returns The updated game state and counts of what was added per content type.
+ */
+const syncNewContent = async(): Promise<SyncNewContentResponse> => {
+  return await fetchJson<SyncNewContentResponse>("/debug/sync-new-content", {
+    method: "POST",
+  });
+};
+
 /**
  * Performs a complete hard reset of the player's game state via the debug endpoint.
  * @returns The fresh game state as a LoadResponse.
@@ -309,6 +320,7 @@ export {
   craftRecipe,
   debugHardReset,
   forceUnlocks,
+  syncNewContent,
   getAbout,
   getAuthUrl,
   getPublicProfile,

apps/web/src/components/game/debugPanel.tsx

@@ -10,7 +10,50 @@ import { type JSX, useState } from "react";
 import { useGame } from "../../context/gameContext.js";
 import { ConfirmationModal } from "../ui/confirmationModal.js";
 
-type ActiveModal = "force-unlocks" | "hard-reset" | null;
+type ActiveModal = "force-unlocks" | "hard-reset" | "sync-new-content" | null;
+
+interface SyncNewContentResult {
+  achievementsAdded:    number;
+  adventurersAdded:     number;
+  bossesAdded:          number;
+  equipmentAdded:       number;
+  explorationAreasAdded: number;
+  questsAdded:          number;
+  upgradesAdded:        number;
+  zonesAdded:           number;
+}
+
+/**
+ * Builds a human-readable summary of what the sync-new-content operation added.
+ * @param result - The counts returned by the operation.
+ * @returns A message string describing what was added, or a confirmation nothing was needed.
+ */
+const buildSyncNewContentMessage = (result: SyncNewContentResult): string => {
+  const entries: Array<[ number, string ]> = [
+    [ result.zonesAdded, "zone(s)" ],
+    [ result.questsAdded, "quest(s)" ],
+    [ result.bossesAdded, "boss(es)" ],
+    [ result.explorationAreasAdded, "exploration area(s)" ],
+    [ result.adventurersAdded, "adventurer tier(s)" ],
+    [ result.upgradesAdded, "upgrade(s)" ],
+    [ result.equipmentAdded, "equipment item(s)" ],
+    [ result.achievementsAdded, "achievement(s)" ],
+  ];
+  const parts = entries.
+    filter(([ count ]) => {
+      return count > 0;
+    }).
+    map(([ count, label ]) => {
+      return `${String(count)} ${label}`;
+    });
+  if (parts.length === 0) {
+    return "Your save is already up to date — no new content was found.";
+  }
+  const total = entries.reduce((sum, [ count ]) => {
+    return sum + count;
+  }, 0);
+  return `Added ${String(total)} new item(s) to your save: ${parts.join(", ")}.`;
+};
 
 interface ForceUnlocksResult {
   adventurersUnlocked: number;
@@ -60,15 +103,21 @@ const buildForceUnlocksMessage = (result: ForceUnlocksResult): string => {
  * @returns The JSX element.
  */
 const DebugPanel = (): JSX.Element => {
-  const { forceUnlocks, debugHardReset, isLoading } = useGame();
+  const { forceUnlocks, debugHardReset, syncNewContent, isLoading } = useGame();
   const [ activeModal, setActiveModal ] = useState<ActiveModal>(null);
   const [ forceUnlocksResult, setForceUnlocksResult ] = useState<string | null>(null);
+  const [ syncNewContentResult, setSyncNewContentResult ] = useState<string | null>(null);
 
   function handleOpenForceUnlocks(): void {
     setForceUnlocksResult(null);
     setActiveModal("force-unlocks");
   }
 
+  function handleOpenSyncNewContent(): void {
+    setSyncNewContentResult(null);
+    setActiveModal("sync-new-content");
+  }
+
   function handleOpenHardReset(): void {
     setActiveModal("hard-reset");
   }
@@ -85,6 +134,14 @@ const DebugPanel = (): JSX.Element => {
     })();
   }
 
+  function handleConfirmSyncNewContent(): void {
+    setActiveModal(null);
+    void (async(): Promise<void> => {
+      const result = await syncNewContent();
+      setSyncNewContentResult(buildSyncNewContentMessage(result));
+    })();
+  }
+
   function handleConfirmHardReset(): void {
     setActiveModal(null);
     void debugHardReset();
@@ -120,6 +177,26 @@ const DebugPanel = (): JSX.Element => {
           }
         </div>
 
+        <div className="debug-action-card">
+          <h3>{"🔄 Sync New Content"}</h3>
+          <p>
+            {
+              "If the game has been updated since your save was created, this will add any missing adventurers, quests, bosses, equipment, upgrades, and more to your save without affecting your existing progress."
+            }
+          </p>
+          <button
+            className="action-button"
+            disabled={isLoading}
+            onClick={handleOpenSyncNewContent}
+            type="button"
+          >
+            {"Sync New Content"}
+          </button>
+          {syncNewContentResult !== null
+            && <p className="debug-result-message">{syncNewContentResult}</p>
+          }
+        </div>
+
         <div className="debug-action-card">
           <h3>{"💀 Hard Reset"}</h3>
           <p>
@@ -149,6 +226,17 @@ const DebugPanel = (): JSX.Element => {
         />
       }
 
+      {activeModal === "sync-new-content"
+        && <ConfirmationModal
+          confirmLabel="Yes, Sync New Content"
+          description="This will scan for any adventurers, quests, bosses, equipment, upgrades, achievements, and zones added to the game after your save was created, and add them to your save. This operation is safe and non-destructive — your existing progress will not be affected."
+          isLoading={isLoading}
+          onCancel={handleCancel}
+          onConfirm={handleConfirmSyncNewContent}
+          title="Sync New Content"
+        />
+      }
+
       {activeModal === "hard-reset"
         && <ConfirmationModal
           confirmLabel="Yes, Wipe Everything"

apps/web/src/context/gameContext.tsx

@@ -44,6 +44,7 @@ import {
   craftRecipe as craftRecipeApi,
   debugHardReset as debugHardResetApi,
   forceUnlocks as forceUnlocksApi,
+  syncNewContent as syncNewContentApi,
   loadGame,
   prestige as prestigeApi,
   resetProgress as resetProgressApi,
@@ -574,6 +575,21 @@ interface GameContextValue {
    */
   debugHardReset: ()=> Promise<void>;
 
+  /**
+   * Syncs any content added to the game after the player's save was created.
+   * @returns Counts of what was added per content type.
+   */
+  syncNewContent: ()=> Promise<{
+    achievementsAdded:    number;
+    adventurersAdded:     number;
+    bossesAdded:          number;
+    equipmentAdded:       number;
+    explorationAreasAdded: number;
+    questsAdded:          number;
+    upgradesAdded:        number;
+    zonesAdded:           number;
+  }>;
+
   /**
    * Last auto-boss fight result — null until the first auto fight completes or
    * when auto-boss is toggled off.
@@ -2151,6 +2167,43 @@ export const GameProvider = ({
     }
   }, []);
 
+  const syncNewContent = useCallback(async() => {
+    try {
+      const data = await syncNewContentApi();
+      setState(data.state);
+      if (data.signature !== undefined) {
+        signatureReference.current = data.signature;
+        localStorage.setItem("elysium_save_signature", data.signature);
+      }
+      return {
+        achievementsAdded:    data.achievementsAdded,
+        adventurersAdded:     data.adventurersAdded,
+        bossesAdded:          data.bossesAdded,
+        equipmentAdded:       data.equipmentAdded,
+        explorationAreasAdded: data.explorationAreasAdded,
+        questsAdded:          data.questsAdded,
+        upgradesAdded:        data.upgradesAdded,
+        zonesAdded:           data.zonesAdded,
+      };
+    } catch (error_: unknown) {
+      setError(
+        error_ instanceof Error
+          ? error_.message
+          : "Failed to sync new content",
+      );
+      return {
+        achievementsAdded:    0,
+        adventurersAdded:     0,
+        bossesAdded:          0,
+        equipmentAdded:       0,
+        explorationAreasAdded: 0,
+        questsAdded:          0,
+        upgradesAdded:        0,
+        zonesAdded:           0,
+      };
+    }
+  }, []);
+
   const debugHardReset = useCallback(async() => {
     setIsLoading(true);
     setError(null);
@@ -2260,6 +2313,7 @@ export const GameProvider = ({
       unlockedAchievements,
       unlockedCodexEntryIds,
       unlockedStoryChapterIds,
+      syncNewContent,
     };
   }, [
     apotheosis,
@@ -2323,6 +2377,7 @@ export const GameProvider = ({
     startQuest,
     state,
     syncError,
+    syncNewContent,
     toggleAutoAdventurer,
     toggleAutoBoss,
     toggleAutoPrestige,