@spotsdev/sdk 1.0.0 → 1.1.0

package/src/api/queries/conversations.ts

@@ -4,9 +4,14 @@
  * TanStack Query hooks for conversation/messaging operations.
  */
 
-import { useQuery, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
-import { getApiClient } from '../client';
-import type { Conversation, Message, ApiResponse } from '../types';
+import {
+  useQuery,
+  type UseQueryOptions,
+  type UseQueryResult,
+} from '@tanstack/react-query'
+
+import {getApiClient} from '../client'
+import {type ApiResponse, type Conversation, type Message} from '../types'
 
 // ============================================================================
 // QUERY KEYS
@@ -18,9 +23,9 @@ export const conversationKeys = {
   list: () => [...conversationKeys.lists()] as const,
   details: () => [...conversationKeys.all, 'detail'] as const,
   detail: (id: string) => [...conversationKeys.details(), id] as const,
-  messages: (conversationId: string, params?: { before?: string }) =>
+  messages: (conversationId: string, params?: {before?: string}) =>
     [...conversationKeys.detail(conversationId), 'messages', params] as const,
-};
+}
 
 // ============================================================================
 // QUERY HOOKS
@@ -29,66 +34,79 @@ export const conversationKeys = {
 /**
  * Get all conversations for current user
  *
- * @endpoint GET /api/v1/conversations
+ * @endpoint GET /conversations
  */
 export function useConversations(
-  options?: Omit<UseQueryOptions<Conversation[]>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<Conversation[]>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<Conversation[]> {
   return useQuery({
     queryKey: conversationKeys.list(),
     queryFn: async (): Promise<Conversation[]> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<Conversation[]>>('/api/v1/conversations');
-      return response.data.data;
+      const client = getApiClient()
+      const response =
+        await client.get<ApiResponse<Conversation[]>>('/conversations')
+      return response.data.data
     },
     ...options,
-  });
+  })
 }
 
 /**
  * Get a single conversation with details
  *
- * @endpoint GET /api/v1/conversations/{id}
+ * @endpoint GET /conversations/{id}
  */
 export function useConversation(
   conversationId: string,
-  options?: Omit<UseQueryOptions<Conversation>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<Conversation>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<Conversation> {
   return useQuery({
     queryKey: conversationKeys.detail(conversationId),
     queryFn: async (): Promise<Conversation> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<Conversation>>(`/api/v1/conversations/${conversationId}`);
-      return response.data.data;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<Conversation>>(
+        `/conversations/${conversationId}`,
+      )
+      return response.data.data
     },
     enabled: !!conversationId,
     ...options,
-  });
+  })
 }
 
 /**
  * Get messages for a conversation
  *
- * @endpoint GET /api/v1/conversations/{id}/messages
+ * @endpoint GET /conversations/{id}/messages
  */
 export function useConversationMessages(
   conversationId: string,
-  params?: { limit?: number; before?: string },
-  options?: Omit<UseQueryOptions<{ data: Message[]; meta: { hasMore: boolean; oldestMessageAt: string | null } }>, 'queryKey' | 'queryFn'>
-): UseQueryResult<{ data: Message[]; meta: { hasMore: boolean; oldestMessageAt: string | null } }> {
+  params?: {limit?: number; before?: string},
+  options?: Omit<
+    UseQueryOptions<{
+      data: Message[]
+      meta: {hasMore: boolean; oldestMessageAt: string | null}
+    }>,
+    'queryKey' | 'queryFn'
+  >,
+): UseQueryResult<{
+  data: Message[]
+  meta: {hasMore: boolean; oldestMessageAt: string | null}
+}> {
   return useQuery({
     queryKey: conversationKeys.messages(conversationId, params),
     queryFn: async () => {
-      const client = getApiClient();
-      const queryParams = new URLSearchParams();
-      if (params?.limit) queryParams.set('limit', String(params.limit));
-      if (params?.before) queryParams.set('before', params.before);
-      const response = await client.get<{ data: Message[]; meta: { hasMore: boolean; oldestMessageAt: string | null } }>(
-        `/api/v1/conversations/${conversationId}/messages?${queryParams}`
-      );
-      return response.data;
+      const client = getApiClient()
+      const queryParams = new URLSearchParams()
+      if (params?.limit) queryParams.set('limit', String(params.limit))
+      if (params?.before) queryParams.set('before', params.before)
+      const response = await client.get<{
+        data: Message[]
+        meta: {hasMore: boolean; oldestMessageAt: string | null}
+      }>(`/conversations/${conversationId}/messages?${queryParams}`)
+      return response.data
     },
     enabled: !!conversationId,
     ...options,
-  });
+  })
 }

package/src/api/queries/index.ts

@@ -5,44 +5,44 @@
  */
 
 // Auth (mutations, but grouped with queries for convenience)
-export * from './auth';
+export * from './auth'
 
 // Users
-export * from './users';
-export { userKeys } from './users';
+export * from './users'
+export {userKeys} from './users'
 
 // Spots
-export * from './spots';
-export { spotKeys } from './spots';
+export * from './spots'
+export {spotKeys} from './spots'
 
 // Posts
-export * from './posts';
-export { postKeys } from './posts';
+export * from './posts'
+export {postKeys} from './posts'
 
 // Conversations
-export * from './conversations';
-export { conversationKeys } from './conversations';
+export * from './conversations'
+export {conversationKeys} from './conversations'
 
 // Clubs
-export * from './clubs';
-export { clubKeys } from './clubs';
+export * from './clubs'
+export {clubKeys} from './clubs'
 
 // Templates
-export * from './templates';
-export { templateKeys } from './templates';
+export * from './templates'
+export {templateKeys} from './templates'
 
 // Notifications
-export * from './notifications';
-export { notificationKeys } from './notifications';
+export * from './notifications'
+export {notificationKeys} from './notifications'
 
 // Misc (cities, vibes, events)
-export * from './misc';
-export { miscKeys } from './misc';
+export * from './misc'
+export {miscKeys} from './misc'
 
 // Products (marketplace)
-export * from './products';
-export { productKeys } from './products';
+export * from './products'
+export {productKeys} from './products'
 
 // Orders (marketplace)
-export * from './orders';
-export { orderKeys } from './orders';
+export * from './orders'
+export {orderKeys} from './orders'

package/src/api/queries/misc.ts

@@ -2,16 +2,38 @@
  * Misc Query Hooks
  *
  * TanStack Query hooks for cities, vibes, and other reference data.
- * All types come from @prisma/client (via ../types re-export).
- *
- * API Response Patterns:
- * - Reference data (vibes, templates, interests): { success, data: T[], timestamp }
- * - Large datasets (cities, spots, posts): { success, data: { data: T[], meta }, timestamp }
  */
 
-import { useQuery, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
-import { getApiClient } from '../client';
-import type { City, Vibe, LifeSituation, Interest, Intention, ApiResponse, PaginatedResponse } from '../types';
+import {
+  useQuery,
+  type UseQueryOptions,
+  type UseQueryResult,
+} from '@tanstack/react-query'
+
+import {getApiClient} from '../client'
+import {
+  type ApiResponse,
+  type City,
+  type LifeSituation,
+  type Vibe,
+} from '../types'
+
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+
+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 []
+}
 
 // ============================================================================
 // QUERY KEYS
@@ -21,120 +43,69 @@ export const miscKeys = {
   cities: () => ['cities'] as const,
   vibes: () => ['vibes'] as const,
   lifeSituations: () => ['life-situations'] as const,
-  interests: () => ['interests'] as const,
-  intentions: () => ['intentions'] as const,
-};
+}
 
 // ============================================================================
 // QUERY HOOKS
 // ============================================================================
 
 /**
- * Get all cities (paginated endpoint)
+ * Get all cities
  *
- * @endpoint GET /api/v1/cities
- * @returns PaginatedResponse with cities array
+ * @endpoint GET /cities
  */
 export function useCities(
-  options?: Omit<UseQueryOptions<City[]>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<City[]>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<City[]> {
   return useQuery({
     queryKey: miscKeys.cities(),
     queryFn: async (): Promise<City[]> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<PaginatedResponse<City>>>('/api/v1/cities');
-      // Cities endpoint returns paginated format: { data: { data: [], meta: {} } }
-      return response.data.data.data;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<unknown>>('/cities')
+      return extractArrayData<City>(response.data.data)
     },
     staleTime: 1000 * 60 * 60,
     ...options,
-  });
+  })
 }
 
 /**
- * Get all vibes (flat array - reference data)
+ * Get all vibes
  *
- * @endpoint GET /api/v1/vibes
- * @returns Flat array of vibes (not paginated)
+ * @endpoint GET /vibes
  */
 export function useVibes(
-  options?: Omit<UseQueryOptions<Vibe[]>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<Vibe[]>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<Vibe[]> {
   return useQuery({
     queryKey: miscKeys.vibes(),
     queryFn: async (): Promise<Vibe[]> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<Vibe[]>>('/api/v1/vibes');
-      // Vibes endpoint returns flat array: { data: [] }
-      return response.data.data;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<unknown>>('/vibes')
+      return extractArrayData<Vibe>(response.data.data)
     },
     staleTime: 1000 * 60 * 60,
     ...options,
-  });
+  })
 }
 
 /**
- * Get all life situations (flat array - reference data for onboarding)
+ * Get all life situations (for onboarding)
  *
- * @endpoint GET /api/v1/life-situations
- * @returns Flat array of life situations (not paginated)
+ * @endpoint GET /life-situations
  */
 export function useLifeSituations(
-  options?: Omit<UseQueryOptions<LifeSituation[]>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<LifeSituation[]>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<LifeSituation[]> {
   return useQuery({
     queryKey: miscKeys.lifeSituations(),
     queryFn: async (): Promise<LifeSituation[]> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<LifeSituation[]>>('/api/v1/life-situations');
-      // Life situations endpoint returns flat array: { data: [] }
-      return response.data.data;
-    },
-    staleTime: 1000 * 60 * 60,
-    ...options,
-  });
-}
-
-/**
- * Get all interests (flat array - reference data)
- *
- * @endpoint GET /api/v1/interests
- * @returns Flat array of interests (not paginated)
- */
-export function useInterests(
-  options?: Omit<UseQueryOptions<Interest[]>, 'queryKey' | 'queryFn'>
-): UseQueryResult<Interest[]> {
-  return useQuery({
-    queryKey: miscKeys.interests(),
-    queryFn: async (): Promise<Interest[]> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<Interest[]>>('/api/v1/interests');
-      // Interests endpoint returns flat array: { data: [] }
-      return response.data.data;
-    },
-    staleTime: 1000 * 60 * 60,
-    ...options,
-  });
-}
-
-/**
- * Get all intentions (flat array - reference data)
- *
- * @endpoint GET /api/v1/intentions
- * @returns Flat array of intentions (not paginated)
- */
-export function useIntentions(
-  options?: Omit<UseQueryOptions<Intention[]>, 'queryKey' | 'queryFn'>
-): UseQueryResult<Intention[]> {
-  return useQuery({
-    queryKey: miscKeys.intentions(),
-    queryFn: async (): Promise<Intention[]> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<Intention[]>>('/api/v1/intentions');
-      // Intentions endpoint returns flat array: { data: [] }
-      return response.data.data;
+      const client = getApiClient()
+      const response =
+        await client.get<ApiResponse<unknown>>('/life-situations')
+      return extractArrayData<LifeSituation>(response.data.data)
     },
     staleTime: 1000 * 60 * 60,
     ...options,
-  });
+  })
 }

package/src/api/queries/notifications.ts

@@ -4,9 +4,14 @@
  * TanStack Query hooks for notification operations.
  */
 
-import { useQuery, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
-import { getApiClient } from '../client';
-import type { Notification, ApiResponse } from '../types';
+import {
+  useQuery,
+  type UseQueryOptions,
+  type UseQueryResult,
+} from '@tanstack/react-query'
+
+import {getApiClient} from '../client'
+import {type ApiResponse, type Notification} from '../types'
 
 // ============================================================================
 // QUERY KEYS
@@ -15,9 +20,10 @@ import type { Notification, ApiResponse } from '../types';
 export const notificationKeys = {
   all: ['notifications'] as const,
   lists: () => [...notificationKeys.all, 'list'] as const,
-  list: (params?: { limit?: number; unreadOnly?: boolean }) => [...notificationKeys.lists(), params] as const,
+  list: (params?: {limit?: number; unreadOnly?: boolean}) =>
+    [...notificationKeys.lists(), params] as const,
   unreadCount: () => [...notificationKeys.all, 'unreadCount'] as const,
-};
+}
 
 // ============================================================================
 // QUERY HOOKS
@@ -26,41 +32,46 @@ export const notificationKeys = {
 /**
  * Get notifications for current user
  *
- * @endpoint GET /api/v1/notifications
+ * @endpoint GET /notifications
  */
 export function useNotifications(
-  params?: { limit?: number; unreadOnly?: boolean },
-  options?: Omit<UseQueryOptions<Notification[]>, 'queryKey' | 'queryFn'>
+  params?: {limit?: number; unreadOnly?: boolean},
+  options?: Omit<UseQueryOptions<Notification[]>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<Notification[]> {
   return useQuery({
     queryKey: notificationKeys.list(params),
     queryFn: async (): Promise<Notification[]> => {
-      const client = getApiClient();
-      const queryParams = new URLSearchParams();
-      if (params?.limit) queryParams.set('limit', String(params.limit));
-      if (params?.unreadOnly) queryParams.set('unreadOnly', String(params.unreadOnly));
-      const response = await client.get<ApiResponse<Notification[]>>(`/api/v1/notifications?${queryParams}`);
-      return response.data.data;
+      const client = getApiClient()
+      const queryParams = new URLSearchParams()
+      if (params?.limit) queryParams.set('limit', String(params.limit))
+      if (params?.unreadOnly)
+        queryParams.set('unreadOnly', String(params.unreadOnly))
+      const response = await client.get<ApiResponse<Notification[]>>(
+        `/notifications?${queryParams}`,
+      )
+      return response.data.data
     },
     ...options,
-  });
+  })
 }
 
 /**
  * Get unread notification count
  *
- * @endpoint GET /api/v1/notifications/unread-count
+ * @endpoint GET /notifications/unread-count
  */
 export function useUnreadNotificationCount(
-  options?: Omit<UseQueryOptions<number>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<number>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<number> {
   return useQuery({
     queryKey: notificationKeys.unreadCount(),
     queryFn: async (): Promise<number> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<{ count: number }>>('/api/v1/notifications/unread-count');
-      return response.data.data.count;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<{count: number}>>(
+        '/notifications/unread-count',
+      )
+      return response.data.data.count
     },
     ...options,
-  });
+  })
 }

package/src/api/queries/orders.ts

@@ -4,9 +4,17 @@
  * TanStack Query hooks for order-related operations.
  */
 
-import { useQuery, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
-import { getApiClient } from '../client';
-import type { Order, OrderItem, Product, Spot, OrderStatus, ApiResponse, PaginatedResponse } from '../types';
+import {useQuery, type UseQueryOptions, type UseQueryResult} from '@tanstack/react-query'
+import {getApiClient} from '../client'
+import type {
+  Order,
+  OrderItem,
+  Product,
+  Spot,
+  OrderStatus,
+  ApiResponse,
+  PaginatedResponse,
+} from '../types'
 
 // ============================================================================
 // QUERY KEYS
@@ -15,12 +23,13 @@ import type { Order, OrderItem, Product, Spot, OrderStatus, ApiResponse, Paginat
 export const orderKeys = {
   all: ['orders'] as const,
   lists: () => [...orderKeys.all, 'list'] as const,
-  list: (filters?: Record<string, unknown>) => [...orderKeys.lists(), filters] as const,
+  list: (filters?: Record<string, unknown>) =>
+    [...orderKeys.lists(), filters] as const,
   details: () => [...orderKeys.all, 'detail'] as const,
   detail: (id: string) => [...orderKeys.details(), id] as const,
   myOrders: () => [...orderKeys.all, 'my'] as const,
   spotOrders: (spotId: string) => [...orderKeys.all, 'spot', spotId] as const,
-};
+}
 
 // ============================================================================
 // TYPES
@@ -28,15 +37,15 @@ export const orderKeys = {
 
 export interface OrderWithDetails extends Order {
   items: (OrderItem & {
-    product: Pick<Product, 'id' | 'name' | 'slug' | 'type' | 'imageUrl'>;
-  })[];
-  spot: Pick<Spot, 'id' | 'name' | 'slug'>;
+    product: Pick<Product, 'id' | 'name' | 'slug' | 'type' | 'imageUrl'>
+  })[]
+  spot: Pick<Spot, 'id' | 'name' | 'slug'>
 }
 
 export interface OrderFilters {
-  status?: OrderStatus;
-  limit?: number;
-  page?: number;
+  status?: OrderStatus
+  limit?: number
+  page?: number
 }
 
 // ============================================================================
@@ -46,74 +55,82 @@ export interface OrderFilters {
 /**
  * Get current user's orders (purchases)
  *
- * @endpoint GET /api/v1/users/me/orders
+ * @endpoint GET /users/me/orders
  */
 export function useMyOrders(
   params?: OrderFilters,
-  options?: Omit<UseQueryOptions<PaginatedResponse<OrderWithDetails>>, 'queryKey' | 'queryFn'>
+  options?: Omit<
+    UseQueryOptions<PaginatedResponse<OrderWithDetails>>,
+    'queryKey' | 'queryFn'
+  >,
 ): UseQueryResult<PaginatedResponse<OrderWithDetails>> {
   return useQuery({
-    queryKey: orderKeys.list({ ...params, my: true }),
+    queryKey: orderKeys.list({...params, my: true}),
     queryFn: async (): Promise<PaginatedResponse<OrderWithDetails>> => {
-      const client = getApiClient();
-      const queryParams = new URLSearchParams();
-      if (params?.status) queryParams.set('status', params.status);
-      if (params?.limit) queryParams.set('limit', String(params.limit));
-      if (params?.page) queryParams.set('page', String(params.page));
-      const response = await client.get<ApiResponse<PaginatedResponse<OrderWithDetails>>>(
-        `/api/v1/users/me/orders?${queryParams}`
-      );
-      return response.data.data;
+      const client = getApiClient()
+      const queryParams = new URLSearchParams()
+      if (params?.status) queryParams.set('status', params.status)
+      if (params?.limit) queryParams.set('limit', String(params.limit))
+      if (params?.page) queryParams.set('page', String(params.page))
+      const response = await client.get<
+        ApiResponse<PaginatedResponse<OrderWithDetails>>
+      >(`/users/me/orders?${queryParams}`)
+      return response.data.data
     },
     ...options,
-  });
+  })
 }
 
 /**
  * Get a single order by ID
  *
- * @endpoint GET /api/v1/orders/{orderId}
+ * @endpoint GET /orders/{orderId}
  */
 export function useOrder(
   orderId: string,
-  options?: Omit<UseQueryOptions<OrderWithDetails>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<OrderWithDetails>, 'queryKey' | 'queryFn'>,
 ): UseQueryResult<OrderWithDetails> {
   return useQuery({
     queryKey: orderKeys.detail(orderId),
     queryFn: async (): Promise<OrderWithDetails> => {
-      const client = getApiClient();
-      const response = await client.get<ApiResponse<OrderWithDetails>>(`/api/v1/orders/${orderId}`);
-      return response.data.data;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<OrderWithDetails>>(
+        `/orders/${orderId}`,
+      )
+      return response.data.data
     },
     enabled: !!orderId,
     ...options,
-  });
+  })
 }
 
 /**
  * Get orders for a spot (seller view)
  *
- * @endpoint GET /api/v1/seller/spots/{spotId}/orders
+ * @endpoint GET /seller/spots/{spotId}/orders
  */
 export function useSpotOrders(
   spotId: string,
   params?: OrderFilters,
-  options?: Omit<UseQueryOptions<PaginatedResponse<OrderWithDetails>>, 'queryKey' | 'queryFn'>
+  options?: Omit<
+    UseQueryOptions<PaginatedResponse<OrderWithDetails>>,
+    'queryKey' | 'queryFn'
+  >,
 ): UseQueryResult<PaginatedResponse<OrderWithDetails>> {
   return useQuery({
     queryKey: orderKeys.spotOrders(spotId),
     queryFn: async (): Promise<PaginatedResponse<OrderWithDetails>> => {
-      const client = getApiClient();
-      const queryParams = new URLSearchParams();
-      if (params?.status) queryParams.set('status', params.status);
-      if (params?.limit) queryParams.set('limit', String(params.limit));
-      if (params?.page) queryParams.set('page', String(params.page));
-      const response = await client.get<ApiResponse<PaginatedResponse<OrderWithDetails>>>(
-        `/api/v1/seller/spots/${spotId}/orders?${queryParams}`
-      );
-      return response.data.data;
+      const client = getApiClient()
+      const queryParams = new URLSearchParams()
+      if (params?.status) queryParams.set('status', params.status)
+      if (params?.limit) queryParams.set('limit', String(params.limit))
+      if (params?.page) queryParams.set('page', String(params.page))
+      const response = await client.get<
+        ApiResponse<PaginatedResponse<OrderWithDetails>>
+      >(`/seller/spots/${spotId}/orders?${queryParams}`)
+      return response.data.data
     },
     enabled: !!spotId,
     ...options,
-  });
+  })
 }