Feat/253 puzzle api setup

frontend/hooks/usePuzzles.ts

@@ -0,0 +1,30 @@
+// frontend/hooks/usePuzzles.ts
+import { useQuery } from '@tanstack/react-query';
+import {
+  getPuzzles,
+  getPuzzleById,
+  getDailyQuestPuzzles,
+} from '../lib/api/puzzleApi';
+import { PuzzleQueryParams, Puzzle } from '../lib/types/puzzles';
+
+export function usePuzzles(query: PuzzleQueryParams) {
+  return useQuery<Puzzle[]>({
+    queryKey: ['puzzles', query],
+    queryFn: () => getPuzzles(query),
+  });
+}
+
+export function usePuzzle(id: string) {
+  return useQuery<Puzzle>({
+    queryKey: ['puzzle', id],
+    queryFn: () => getPuzzleById(id),
+    enabled: !!id,
+  });
+}
+
+export function useDailyQuestPuzzles() {
+  return useQuery<Puzzle[]>({
+    queryKey: ['dailyQuestPuzzles'],
+    queryFn: getDailyQuestPuzzles,
+  });
+}

frontend/lib/api/puzzleApi.ts

@@ -0,0 +1,22 @@
+// frontend/lib/api/puzzleApi.ts
+import axios from 'axios';
+import { Puzzle, PuzzleQueryParams } from '../types/puzzles';
+
+const api = axios.create({
+  baseURL: process.env.NEXT_PUBLIC_API_URL || 'http://localhost:3000',
+});
+
+export async function getPuzzles(query: PuzzleQueryParams): Promise<Puzzle[]> {
+  const response = await api.get('/puzzles', { params: query });
+  return response.data;
+}
+
+export async function getPuzzleById(id: string): Promise<Puzzle> {
+  const response = await api.get(`/puzzles/${id}`);
+  return response.data;
+}
+
+export async function getDailyQuestPuzzles(): Promise<Puzzle[]> {
+  const response = await api.get('/puzzles/daily-quest');
+  return response.data;
+}

frontend/lib/types/puzzles.ts

@@ -0,0 +1,16 @@
+export interface Puzzle {
+  id: string;
+  title: string;
+  description: string;
+  type: 'logic' | 'coding' | 'blockchain';
+  difficulty: 'easy' | 'medium' | 'hard';
+  categoryId: string;
+  timeLimit?: number;
+}
+
+export interface PuzzleQueryParams {
+  categoryId?: string;
+  difficulty?: string;
+  page?: number;
+  limit?: number;
+}

package.json

@@ -31,6 +31,7 @@
   "dependencies": {
     "@nestjs/common": "^11.1.14",
     "@nestjs/core": "^11.1.14",
+    "@tanstack/react-query": "^5.90.21",
     "minimatch": "^10.1.1",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.2",