refactor(atoms): migrate to jotai-tanstack-query from custom reloadable atoms

Replace custom createReloadableAtom/createReloadableAtomFamily with
atomWithSuspenseQuery from jotai-tanstack-query, leveraging TanStack
Query's built-in caching, invalidation, and Suspense support.

- Add @tanstack/query-core and jotai-tanstack-query dependencies
- Create shared QueryClient instance (src/client/queryClient.ts)
- Migrate all data atoms (decks, cards, study, noteTypes) to atomWithSuspenseQuery
- Update page components to use .data destructuring and queryClient.invalidateQueries()
- Update all test files to use QueryClient for data hydration
- Remove src/client/atoms/utils.ts (no longer needed)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

1 files changed, 23 insertions, 16 deletions

diff --git a/src/client/atoms/decks.ts b/src/client/atoms/decks.ts
index e9b0d03..fc68727 100644
--- a/src/client/atoms/decks.ts
+++ b/src/client/atoms/decks.ts
@@ -1,5 +1,6 @@
+import { atomFamily } from "jotai/utils";
+import { atomWithSuspenseQuery } from "jotai-tanstack-query";
 import { apiClient } from "../api/client";
-import { createReloadableAtom, createReloadableAtomFamily } from "./utils";
 
 export interface Deck {
 	id: string;
@@ -15,24 +16,30 @@ export interface Deck {
 // Decks List - Suspense-compatible
 // =====================
 
-export const decksAtom = createReloadableAtom(async () => {
-	const res = await apiClient.rpc.api.decks.$get(undefined, {
-		headers: apiClient.getAuthHeader(),
-	});
-	const data = await apiClient.handleResponse<{ decks: Deck[] }>(res);
-	return data.decks;
-});
+export const decksAtom = atomWithSuspenseQuery(() => ({
+	queryKey: ["decks"],
+	queryFn: async () => {
+		const res = await apiClient.rpc.api.decks.$get(undefined, {
+			headers: apiClient.getAuthHeader(),
+		});
+		const data = await apiClient.handleResponse<{ decks: Deck[] }>(res);
+		return data.decks;
+	},
+}));
 
 // =====================
 // Single Deck by ID - Suspense-compatible
 // =====================
 
-export const deckByIdAtomFamily = createReloadableAtomFamily(
-	async (deckId: string) => {
-		const res = await apiClient.rpc.api.decks[":id"].$get({
-			param: { id: deckId },
-		});
-		const data = await apiClient.handleResponse<{ deck: Deck }>(res);
-		return data.deck;
-	},
+export const deckByIdAtomFamily = atomFamily((deckId: string) =>
+	atomWithSuspenseQuery(() => ({
+		queryKey: ["decks", deckId],
+		queryFn: async () => {
+			const res = await apiClient.rpc.api.decks[":id"].$get({
+				param: { id: deckId },
+			});
+			const data = await apiClient.handleResponse<{ deck: Deck }>(res);
+			return data.deck;
+		},
+	})),
 );