@spotsdev/sdk 1.0.0

package/src/api/queries/spots.ts

@@ -0,0 +1,201 @@
+/**
+ * Spots Query Hooks
+ *
+ * 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';
+
+// ============================================================================
+// QUERY KEYS
+// ============================================================================
+
+export const spotKeys = {
+  all: ['spots'] as const,
+  lists: () => [...spotKeys.all, 'list'] 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)
+ *
+ * @endpoint GET /api/v1/spots
+ * @returns PaginatedResponse with spots array and meta
+ */
+export function useSpots(
+  params?: {
+    limit?: number;
+    page?: number;
+    city?: string;
+    type?: string;
+    templateSlugs?: string[];
+    vibeIds?: string[];
+    search?: string;
+  },
+  options?: Omit<UseQueryOptions<PaginatedResponse<Spot>>, 'queryKey' | 'queryFn'>
+): UseQueryResult<PaginatedResponse<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;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get a spot by ID
+ *
+ * @endpoint GET /api/v1/spots/{spotId}
+ */
+export function useSpot(
+  spotId: string,
+  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;
+    },
+    enabled: !!spotId,
+    ...options,
+  });
+}
+
+/**
+ * Get a spot by slug
+ *
+ * @endpoint GET /api/v1/spots/slug/{slug}
+ */
+export function useSpotBySlug(
+  slug: string,
+  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;
+    },
+    enabled: !!slug,
+    ...options,
+  });
+}
+
+/**
+ * Get a spot by QR code
+ *
+ * @endpoint GET /api/v1/spots/qr/{qrCode}
+ */
+export function useSpotByQR(
+  qrCode: string,
+  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;
+    },
+    enabled: !!qrCode,
+    ...options,
+  });
+}
+
+/**
+ * Get images for a spot
+ *
+ * @endpoint GET /api/v1/spots/{spotId}/images
+ */
+export function useSpotImages(
+  spotId: string,
+  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;
+    },
+    enabled: !!spotId,
+    ...options,
+  });
+}
+
+/**
+ * Infinite scroll query for spots
+ *
+ * @endpoint GET /api/v1/spots (paginated)
+ * @returns Infinite query with pages of spots
+ */
+export interface InfiniteSpotsParams {
+  limit?: number;
+  city?: string;
+  cityId?: string;
+  type?: string;
+  templateSlugs?: string[];
+  vibeIds?: string[];
+  search?: string;
+}
+
+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> {
+  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());
+      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;
+    },
+    initialPageParam: 1,
+    getNextPageParam: (lastPage) => {
+      return lastPage.meta.hasNextPage ? lastPage.meta.page + 1 : undefined;
+    },
+    ...options,
+  });
+}

package/src/api/queries/templates.ts

@@ -0,0 +1,95 @@
+/**
+ * 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';
+
+// ============================================================================
+// QUERY KEYS
+// ============================================================================
+
+export const templateKeys = {
+  all: ['templates'] as const,
+  lists: () => [...templateKeys.all, 'list'] 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)
+ *
+ * @endpoint GET /api/v1/templates
+ * @returns Flat array of templates (not paginated)
+ */
+export function useTemplates(
+  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;
+    },
+    staleTime: 1000 * 60 * 60, // Cache for 1 hour (reference data)
+    ...options,
+  });
+}
+
+/**
+ * Get a template by ID
+ *
+ * @endpoint GET /api/v1/templates/{templateId}
+ */
+export function useTemplate(
+  templateId: string,
+  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;
+    },
+    enabled: !!templateId,
+    ...options,
+  });
+}
+
+/**
+ * Get a template by slug
+ *
+ * @endpoint GET /api/v1/templates/slug/{slug}
+ */
+export function useTemplateBySlug(
+  slug: string,
+  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;
+    },
+    enabled: !!slug,
+    ...options,
+  });
+}

package/src/api/queries/users.ts

@@ -0,0 +1,206 @@
+/**
+ * Users Query Hooks
+ *
+ * TanStack Query hooks for user-related operations.
+ */
+
+import { useQuery, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type { User, Post, Club, Spot, SpotSubscription, FavoriteSpot, ApiResponse } from '../types';
+
+// ============================================================================
+// QUERY KEYS
+// ============================================================================
+
+export const userKeys = {
+  all: ['users'] as const,
+  me: () => [...userKeys.all, 'me'] as const,
+  stats: () => [...userKeys.me(), 'stats'] as const,
+  activity: (limit?: number) => [...userKeys.me(), 'activity', limit] as const,
+  posts: (params?: { page?: number; limit?: number }) => [...userKeys.me(), 'posts', params] as const,
+  clubs: () => [...userKeys.me(), 'clubs'] as const,
+  subscriptions: () => [...userKeys.me(), 'subscriptions'] as const,
+  blocked: () => [...userKeys.me(), 'blocked'] as const,
+  ownedSpots: () => [...userKeys.me(), 'owned-spots'] as const,
+  favorites: () => [...userKeys.me(), 'favorites'] as const,
+};
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get current user's profile
+ *
+ * @endpoint GET /api/v1/users/me
+ */
+export function useCurrentUser(
+  options?: Omit<UseQueryOptions<User>, 'queryKey' | 'queryFn'>
+): UseQueryResult<User> {
+  return useQuery({
+    queryKey: userKeys.me(),
+    queryFn: async (): Promise<User> => {
+      const client = getApiClient();
+      const response = await client.get<ApiResponse<User>>('/api/v1/users/me');
+      return response.data.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get current user's stats
+ *
+ * @endpoint GET /api/v1/users/me/stats
+ */
+export function useUserStats(
+  options?: Omit<UseQueryOptions<{ posts: number; responses: number; upvotes: number }>, 'queryKey' | 'queryFn'>
+): UseQueryResult<{ posts: number; responses: number; upvotes: number }> {
+  return useQuery({
+    queryKey: userKeys.stats(),
+    queryFn: async () => {
+      const client = getApiClient();
+      const response = await client.get<ApiResponse<{ posts: number; responses: number; upvotes: number }>>('/api/v1/users/me/stats');
+      return response.data.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get current user's activity
+ *
+ * @endpoint GET /api/v1/users/me/activity
+ */
+export function useUserActivity(
+  limit: number = 10,
+  options?: Omit<UseQueryOptions<unknown[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<unknown[]> {
+  return useQuery({
+    queryKey: userKeys.activity(limit),
+    queryFn: async () => {
+      const client = getApiClient();
+      const response = await client.get<ApiResponse<unknown[]>>(`/api/v1/users/me/activity?limit=${limit}`);
+      return response.data.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get current user's posts
+ *
+ * @endpoint GET /api/v1/user/me/posts
+ */
+export function useUserPosts(
+  params?: { page?: number; limit?: number },
+  options?: Omit<UseQueryOptions<Post[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<Post[]> {
+  return useQuery({
+    queryKey: userKeys.posts(params),
+    queryFn: async () => {
+      const client = getApiClient();
+      const queryParams = new URLSearchParams();
+      if (params?.page) queryParams.set('page', String(params.page));
+      if (params?.limit) queryParams.set('limit', String(params.limit));
+      const response = await client.get<ApiResponse<Post[]>>(`/api/v1/user/me/posts?${queryParams}`);
+      return response.data.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get current user's clubs
+ *
+ * @endpoint GET /api/v1/user/me/clubs
+ */
+export function useUserClubs(
+  options?: Omit<UseQueryOptions<Club[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<Club[]> {
+  return useQuery({
+    queryKey: userKeys.clubs(),
+    queryFn: async () => {
+      const client = getApiClient();
+      const response = await client.get<ApiResponse<Club[]>>('/api/v1/user/me/clubs');
+      return response.data.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get current user's spot subscriptions
+ *
+ * @endpoint GET /api/v1/user/me/subscriptions
+ */
+export function useUserSubscriptions(
+  options?: Omit<UseQueryOptions<SpotSubscription[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<SpotSubscription[]> {
+  return useQuery({
+    queryKey: userKeys.subscriptions(),
+    queryFn: async () => {
+      const client = getApiClient();
+      const response = await client.get<ApiResponse<SpotSubscription[]>>('/api/v1/user/me/subscriptions');
+      return response.data.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get blocked users list
+ *
+ * @endpoint GET /api/v1/user/me/blocked
+ */
+export function useBlockedUsers(
+  options?: Omit<UseQueryOptions<User[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<User[]> {
+  return useQuery({
+    queryKey: userKeys.blocked(),
+    queryFn: async () => {
+      const client = getApiClient();
+      const response = await client.get<ApiResponse<User[]>>('/api/v1/user/me/blocked');
+      return response.data.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get current user's owned spots (for business owners)
+ *
+ * @endpoint GET /api/v1/users/me/owned-spots
+ */
+export function useOwnedSpots(
+  options?: Omit<UseQueryOptions<Spot[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<Spot[]> {
+  return useQuery({
+    queryKey: userKeys.ownedSpots(),
+    queryFn: async () => {
+      const client = getApiClient();
+      const response = await client.get<ApiResponse<Spot[]>>('/api/v1/users/me/owned-spots');
+      return response.data.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get current user's favorite spots
+ *
+ * @endpoint GET /api/v1/users/me/favorites
+ */
+export function useUserFavorites(
+  options?: Omit<UseQueryOptions<FavoriteSpot[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<FavoriteSpot[]> {
+  return useQuery({
+    queryKey: userKeys.favorites(),
+    queryFn: async () => {
+      const client = getApiClient();
+      const response = await client.get<ApiResponse<FavoriteSpot[]>>('/api/v1/users/me/favorites');
+      return response.data.data;
+    },
+    ...options,
+  });
+}

package/src/api/services/index.ts

@@ -0,0 +1,6 @@
+export { productsService, ordersService, paymentsService } from './marketplace';
+export type {
+  CreateProductInput,
+  UpdateProductInput,
+  CreateOrderInput,
+} from './marketplace';