@spotsdev/sdk 1.0.0 → 1.1.0

package/src/api/queries/spots.ts

@@ -4,9 +4,62 @@
  * TanStack Query hooks for spot-related operations.
  */
 
-import { useQuery, useInfiniteQuery, UseQueryOptions, UseQueryResult, UseInfiniteQueryOptions, UseInfiniteQueryResult } from '@tanstack/react-query';
-import { getApiClient } from '../client';
-import type { Spot, SpotImage, ApiResponse, PaginatedResponse } from '../types';
+import {
+  useQuery,
+  useInfiniteQuery,
+  type UseQueryOptions,
+  type UseQueryResult,
+  type UseInfiniteQueryOptions,
+  type UseInfiniteQueryResult,
+} from '@tanstack/react-query'
+
+import {getApiClient} from '../client'
+import {type ApiResponse, type PaginatedResponse, type Spot, type SpotImage} from '../types'
+
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+
+/**
+ * Extract array data from API response
+ * API returns { success, data: { data: [...], meta: {...} } } or { success, data: [...] }
+ */
+function extractArrayData<T>(data: unknown): T[] {
+  if (Array.isArray(data)) {
+    return data
+  }
+  if (data && typeof data === 'object' && 'data' in data) {
+    const nested = (data as {data: unknown}).data
+    if (Array.isArray(nested)) {
+      return nested
+    }
+  }
+  return []
+}
+
+/**
+ * Extract single object data from API response
+ */
+function extractObjectData<T>(data: unknown): T {
+  if (
+    data &&
+    typeof data === 'object' &&
+    'data' in data &&
+    !Array.isArray(data)
+  ) {
+    const nested = (data as {data: unknown}).data
+    if (
+      nested &&
+      typeof nested === 'object' &&
+      'data' in nested &&
+      !Array.isArray(nested)
+    ) {
+      return (nested as {data: T}).data
+    }
+    return nested as T
+  }
+  return data as T
+}
 
 // ============================================================================
 // QUERY KEYS
@@ -15,187 +68,265 @@ import type { Spot, SpotImage, ApiResponse, PaginatedResponse } from '../types';
 export const spotKeys = {
   all: ['spots'] as const,
   lists: () => [...spotKeys.all, 'list'] as const,
-  list: (filters?: Record<string, unknown>) => [...spotKeys.lists(), filters] as const,
+  list: (filters?: Record<string, unknown>) =>
+    [...spotKeys.lists(), filters] as const,
   details: () => [...spotKeys.all, 'detail'] as const,
   detail: (id: string) => [...spotKeys.details(), id] as const,
   bySlug: (slug: string) => [...spotKeys.all, 'slug', slug] as const,
   byQR: (qrCode: string) => [...spotKeys.all, 'qr', qrCode] as const,
   images: (spotId: string) => [...spotKeys.detail(spotId), 'images'] as const,
-};
+}
 
 // ============================================================================
 // QUERY HOOKS
 // ============================================================================
 
 /**
- * Get all spots (paginated)
+ * Get all spots
  *
- * @endpoint GET /api/v1/spots
- * @returns PaginatedResponse with spots array and meta
+ * @endpoint GET /spots
  */
 export function useSpots(
   params?: {
-    limit?: number;
-    page?: number;
-    city?: string;
-    type?: string;
-    templateSlugs?: string[];
-    vibeIds?: string[];
-    search?: string;
+    limit?: number
+    city?: string
+    type?: string
+    lat?: number
+    lng?: number
+    radius?: number
+    search?: string
+    vibes?: string
+    cityId?: string
+    page?: number
   },
-  options?: Omit<UseQueryOptions<PaginatedResponse<Spot>>, 'queryKey' | 'queryFn'>
-): UseQueryResult<PaginatedResponse<Spot>> {
+  options?: Omit<UseQueryOptions<Spot[]>, 'queryKey' | 'queryFn'>,
+): UseQueryResult<Spot[]> {
   return useQuery({
     queryKey: spotKeys.list(params),
-    queryFn: async (): Promise<PaginatedResponse<Spot>> => {
-      const client = getApiClient();
-      const queryParams = new URLSearchParams();
-      if (params?.limit) queryParams.set('limit', String(params.limit));
-      if (params?.page) queryParams.set('page', String(params.page));
-      if (params?.city) queryParams.set('city', params.city);
-      if (params?.type) queryParams.set('type', params.type);
-      if (params?.search) queryParams.set('search', params.search);
-      if (params?.templateSlugs) {
-        params.templateSlugs.forEach(slug => queryParams.append('templateSlugs', slug));
-      }
-      if (params?.vibeIds) {
-        params.vibeIds.forEach(id => queryParams.append('vibeIds', id));
-      }
-      const response = await client.get<ApiResponse<PaginatedResponse<Spot>>>(`/api/v1/spots?${queryParams}`);
-      return response.data.data;
+    queryFn: async (): Promise<Spot[]> => {
+      const client = getApiClient()
+      const queryParams = new URLSearchParams()
+      if (params?.limit) queryParams.set('limit', String(params.limit))
+      if (params?.city) queryParams.set('city', params.city)
+      if (params?.type) queryParams.set('type', params.type)
+      if (params?.lat) queryParams.set('lat', String(params.lat))
+      if (params?.lng) queryParams.set('lng', String(params.lng))
+      if (params?.radius) queryParams.set('radius', String(params.radius))
+      if (params?.search) queryParams.set('search', params.search)
+      if (params?.vibes) queryParams.set('vibeIds', params.vibes)
+      if (params?.cityId) queryParams.set('cityId', params.cityId)
+      if (params?.page) queryParams.set('page', String(params.page))
+      const response = await client.get<ApiResponse<unknown>>(
+        `/spots?${queryParams}`,
+      )
+      return extractArrayData<Spot>(response.data.data)
     },
     ...options,
-  });
+  })
 }
 
 /**
  * Get a spot by ID
  *
- * @endpoint GET /api/v1/spots/{spotId}
+ * @endpoint GET /spots/{spotId}
  */
 export function useSpot(
   spotId: string,
-  options?: Omit<UseQueryOptions<Spot>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<Spot>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<Spot> {
   return useQuery({
     queryKey: spotKeys.detail(spotId),
     queryFn: async (): Promise<Spot> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<Spot>>(`/api/v1/spots/${spotId}`);
-      return response.data.data;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<unknown>>(
+        `/spots/${spotId}`,
+      )
+      return extractObjectData<Spot>(response.data.data)
     },
     enabled: !!spotId,
     ...options,
-  });
+  })
 }
 
 /**
  * Get a spot by slug
  *
- * @endpoint GET /api/v1/spots/slug/{slug}
+ * @endpoint GET /spots/slug/{slug}
  */
 export function useSpotBySlug(
   slug: string,
-  options?: Omit<UseQueryOptions<Spot>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<Spot>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<Spot> {
   return useQuery({
     queryKey: spotKeys.bySlug(slug),
     queryFn: async (): Promise<Spot> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<Spot>>(`/api/v1/spots/slug/${slug}`);
-      return response.data.data;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<unknown>>(
+        `/spots/slug/${slug}`,
+      )
+      return extractObjectData<Spot>(response.data.data)
     },
     enabled: !!slug,
     ...options,
-  });
+  })
 }
 
 /**
  * Get a spot by QR code
  *
- * @endpoint GET /api/v1/spots/qr/{qrCode}
+ * @endpoint GET /spots/qr/{qrCode}
  */
 export function useSpotByQR(
   qrCode: string,
-  options?: Omit<UseQueryOptions<Spot>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<Spot>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<Spot> {
   return useQuery({
     queryKey: spotKeys.byQR(qrCode),
     queryFn: async (): Promise<Spot> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<Spot>>(`/api/v1/spots/qr/${qrCode}`);
-      return response.data.data;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<unknown>>(
+        `/spots/qr/${qrCode}`,
+      )
+      return extractObjectData<Spot>(response.data.data)
     },
     enabled: !!qrCode,
     ...options,
-  });
+  })
 }
 
 /**
  * Get images for a spot
  *
- * @endpoint GET /api/v1/spots/{spotId}/images
+ * @endpoint GET /spots/{spotId}/images
  */
 export function useSpotImages(
   spotId: string,
-  options?: Omit<UseQueryOptions<SpotImage[]>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<SpotImage[]>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<SpotImage[]> {
   return useQuery({
     queryKey: spotKeys.images(spotId),
     queryFn: async (): Promise<SpotImage[]> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<SpotImage[]>>(`/api/v1/spots/${spotId}/images`);
-      return response.data.data;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<unknown>>(
+        `/spots/${spotId}/images`,
+      )
+      return extractArrayData<SpotImage>(response.data.data)
     },
     enabled: !!spotId,
     ...options,
-  });
+  })
 }
 
 /**
- * Infinite scroll query for spots
+ * Check if a spot is favorited by the current user
  *
- * @endpoint GET /api/v1/spots (paginated)
- * @returns Infinite query with pages of spots
+ * @endpoint GET /spots/{spotId}/favorite
+ */
+export function useSpotFavoriteStatus(
+  spotId: string,
+  options?: Omit<
+    UseQueryOptions<{isFavorite: boolean}>,
+    'queryKey' | 'queryFn'
+  >,
+): UseQueryResult<{isFavorite: boolean}> {
+  return useQuery({
+    queryKey: [...spotKeys.detail(spotId), 'favorite'] as const,
+    queryFn: async (): Promise<{isFavorite: boolean}> => {
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<{isFavorite: boolean}>>(
+        `/spots/${spotId}/favorite`,
+      )
+      return extractObjectData<{isFavorite: boolean}>(response.data.data)
+    },
+    enabled: !!spotId,
+    ...options,
+  })
+}
+
+// ============================================================================
+// INFINITE QUERY HOOKS
+// ============================================================================
+
+/**
+ * Params for infinite spots query
  */
 export interface InfiniteSpotsParams {
-  limit?: number;
-  city?: string;
-  cityId?: string;
-  type?: string;
-  templateSlugs?: string[];
-  vibeIds?: string[];
-  search?: string;
+  limit?: number
+  city?: string
+  cityId?: string
+  type?: string
+  templateSlugs?: string[]
+  vibeIds?: string[]
+  search?: string
 }
 
+/**
+ * Infinite scroll query for spots
+ *
+ * @endpoint GET /spots (paginated)
+ * @returns Infinite query with pages of spots
+ */
 export function useInfiniteSpots(
   params?: InfiniteSpotsParams,
-  options?: Omit<UseInfiniteQueryOptions<PaginatedResponse<Spot>, Error, { pages: PaginatedResponse<Spot>[]; pageParams: number[] }>, 'queryKey' | 'queryFn' | 'getNextPageParam' | 'initialPageParam'>
-): UseInfiniteQueryResult<{ pages: PaginatedResponse<Spot>[]; pageParams: number[] }, Error> {
+  options?: Omit<
+    UseInfiniteQueryOptions<
+      PaginatedResponse<Spot>,
+      Error,
+      {pages: PaginatedResponse<Spot>[]; pageParams: number[]}
+    >,
+    'queryKey' | 'queryFn' | 'getNextPageParam' | 'initialPageParam'
+  >,
+): UseInfiniteQueryResult<
+  {pages: PaginatedResponse<Spot>[]; pageParams: number[]},
+  Error
+> {
   return useInfiniteQuery({
     queryKey: [...spotKeys.lists(), 'infinite', params] as const,
-    queryFn: async ({ pageParam }): Promise<PaginatedResponse<Spot>> => {
-      const client = getApiClient();
-      const queryParams = new URLSearchParams();
-      queryParams.set('page', String(pageParam));
-      if (params?.limit) queryParams.set('limit', String(params.limit));
-      if (params?.city) queryParams.set('city', params.city);
-      if (params?.cityId) queryParams.set('cityId', params.cityId);
-      if (params?.type && params.type !== 'All') queryParams.set('type', params.type);
-      if (params?.search?.trim()) queryParams.set('search', params.search.trim());
+    queryFn: async ({pageParam = 1}): Promise<PaginatedResponse<Spot>> => {
+      const client = getApiClient()
+      const queryParams = new URLSearchParams()
+      queryParams.set('page', String(pageParam))
+      if (params?.limit) queryParams.set('limit', String(params.limit))
+      if (params?.city) queryParams.set('city', params.city)
+      if (params?.cityId) queryParams.set('cityId', params.cityId)
+      if (params?.type && params.type !== 'All')
+        queryParams.set('type', params.type)
+      if (params?.search?.trim())
+        queryParams.set('search', params.search.trim())
       if (params?.templateSlugs) {
-        params.templateSlugs.forEach(slug => queryParams.append('templateSlugs', slug));
+        params.templateSlugs.forEach((slug) =>
+          queryParams.append('templateSlugs', slug),
+        )
       }
       if (params?.vibeIds) {
-        params.vibeIds.forEach(id => queryParams.append('vibeIds', id));
+        params.vibeIds.forEach((id) => queryParams.append('vibeIds', id))
+      }
+      const response = await client.get<ApiResponse<PaginatedResponse<Spot>>>(
+        `/spots?${queryParams}`,
+      )
+      // Handle nested response structure
+      const data = response.data.data
+      if (data && typeof data === 'object' && 'data' in data) {
+        return data as PaginatedResponse<Spot>
+      }
+      // Fallback for array response
+      const page = pageParam as number
+      return {
+        data: extractArrayData<Spot>(data),
+        meta: {
+          total: 0,
+          page,
+          limit: params?.limit || 20,
+          totalPages: 1,
+          hasNextPage: false,
+          hasPreviousPage: page > 1,
+        },
       }
-      const response = await client.get<ApiResponse<PaginatedResponse<Spot>>>(`/api/v1/spots?${queryParams}`);
-      return response.data.data;
     },
     initialPageParam: 1,
     getNextPageParam: (lastPage) => {
-      return lastPage.meta.hasNextPage ? lastPage.meta.page + 1 : undefined;
+      return lastPage.meta.hasNextPage ? lastPage.meta.page + 1 : undefined
     },
     ...options,
-  });
+  })
 }

package/src/api/queries/templates.ts

@@ -2,13 +2,16 @@
  * Templates Query Hooks
  *
  * TanStack Query hooks for post template operations.
- *
- * Templates are reference data (flat array), not paginated.
  */
 
-import { useQuery, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
-import { getApiClient } from '../client';
-import type { Template, ApiResponse } from '../types';
+import {
+  useQuery,
+  type UseQueryOptions,
+  type UseQueryResult,
+} from '@tanstack/react-query'
+
+import {getApiClient} from '../client'
+import {type ApiResponse, type Template} from '../types'
 
 // ============================================================================
 // QUERY KEYS
@@ -17,79 +20,83 @@ import type { Template, ApiResponse } from '../types';
 export const templateKeys = {
   all: ['templates'] as const,
   lists: () => [...templateKeys.all, 'list'] as const,
-  list: (filters?: { spotType?: string }) => [...templateKeys.lists(), filters] as const,
+  list: (filters?: {spotType?: string}) =>
+    [...templateKeys.lists(), filters] as const,
   details: () => [...templateKeys.all, 'detail'] as const,
   detail: (id: string) => [...templateKeys.details(), id] as const,
   bySlug: (slug: string) => [...templateKeys.all, 'slug', slug] as const,
-};
+}
 
 // ============================================================================
 // QUERY HOOKS
 // ============================================================================
 
 /**
- * Get all templates (flat array - reference data)
+ * Get all templates
  *
- * @endpoint GET /api/v1/templates
- * @returns Flat array of templates (not paginated)
+ * @endpoint GET /templates
  */
 export function useTemplates(
-  params?: { spotType?: string },
-  options?: Omit<UseQueryOptions<Template[]>, 'queryKey' | 'queryFn'>
+  params?: {spotType?: string},
+  options?: Omit<UseQueryOptions<Template[]>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<Template[]> {
   return useQuery({
     queryKey: templateKeys.list(params),
     queryFn: async (): Promise<Template[]> => {
-      const client = getApiClient();
-      const queryParams = new URLSearchParams();
-      if (params?.spotType) queryParams.set('spotType', params.spotType);
-      const response = await client.get<ApiResponse<Template[]>>(`/api/v1/templates?${queryParams}`);
-      // Templates endpoint returns flat array: { data: [] }
-      return response.data.data;
+      const client = getApiClient()
+      const queryParams = new URLSearchParams()
+      if (params?.spotType) queryParams.set('spotType', params.spotType)
+      const response = await client.get<ApiResponse<Template[]>>(
+        `/templates?${queryParams}`,
+      )
+      return response.data.data
     },
-    staleTime: 1000 * 60 * 60, // Cache for 1 hour (reference data)
     ...options,
-  });
+  })
 }
 
 /**
  * Get a template by ID
  *
- * @endpoint GET /api/v1/templates/{templateId}
+ * @endpoint GET /templates/{templateId}
  */
 export function useTemplate(
   templateId: string,
-  options?: Omit<UseQueryOptions<Template>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<Template>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<Template> {
   return useQuery({
     queryKey: templateKeys.detail(templateId),
     queryFn: async (): Promise<Template> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<Template>>(`/api/v1/templates/${templateId}`);
-      return response.data.data;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<Template>>(
+        `/templates/${templateId}`,
+      )
+      return response.data.data
     },
     enabled: !!templateId,
     ...options,
-  });
+  })
 }
 
 /**
  * Get a template by slug
  *
- * @endpoint GET /api/v1/templates/slug/{slug}
+ * @endpoint GET /templates/slug/{slug}
  */
 export function useTemplateBySlug(
   slug: string,
-  options?: Omit<UseQueryOptions<Template>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<Template>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<Template> {
   return useQuery({
     queryKey: templateKeys.bySlug(slug),
     queryFn: async (): Promise<Template> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<Template>>(`/api/v1/templates/slug/${slug}`);
-      return response.data.data;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<Template>>(
+        `/templates/slug/${slug}`,
+      )
+      return response.data.data
     },
     enabled: !!slug,
     ...options,
-  });
+  })
 }