@spotsdev/sdk 1.0.0 → 1.1.0

package/src/api/queries/users.ts

@@ -4,9 +4,38 @@
  * 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';
+import {
+  useQuery,
+  type UseQueryOptions,
+  type UseQueryResult,
+} from '@tanstack/react-query'
+
+import {getApiClient} from '../client'
+import {
+  type ApiResponse,
+  type Club,
+  type FavoriteSpot,
+  type Post,
+  type Spot,
+  type SpotsSummaryResponse,
+  type SpotSubscription,
+  type User,
+} from '../types'
+
+// Helper to extract array data from API response
+// API can return either { data: T[] } or { data: { data: T[], meta?: {...} } }
+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
@@ -16,14 +45,16 @@ export const userKeys = {
   all: ['users'] as const,
   me: () => [...userKeys.all, 'me'] as const,
   stats: () => [...userKeys.me(), 'stats'] as const,
+  spotsSummary: () => [...userKeys.me(), 'spots-summary'] as const,
   activity: (limit?: number) => [...userKeys.me(), 'activity', limit] as const,
-  posts: (params?: { page?: number; limit?: number }) => [...userKeys.me(), 'posts', params] 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
@@ -32,175 +63,237 @@ export const userKeys = {
 /**
  * Get current user's profile
  *
- * @endpoint GET /api/v1/users/me
+ * @endpoint GET /users/me
  */
 export function useCurrentUser(
-  options?: Omit<UseQueryOptions<User>, 'queryKey' | 'queryFn'>
+  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;
+      console.log('[SDK-USERS] Fetching /users/me...')
+      const client = getApiClient()
+      try {
+        const response = await client.get<ApiResponse<User>>('/users/me')
+        console.log('[SDK-USERS] Success:', response.status)
+        return response.data.data
+      } catch (error: unknown) {
+        const axiosError = error as {
+          response?: {status: number}
+          config?: {url: string; baseURL?: string}
+        }
+        console.log(
+          '[SDK-USERS] Error:',
+          axiosError.response?.status,
+          'URL:',
+          axiosError.config?.baseURL,
+          axiosError.config?.url,
+        )
+        throw error
+      }
     },
     ...options,
-  });
+  })
 }
 
 /**
  * Get current user's stats
  *
- * @endpoint GET /api/v1/users/me/stats
+ * @endpoint GET /users/me/stats
+ * @deprecated This endpoint doesn't exist in the API. Use useUserSpotsSummary instead.
  */
 export function useUserStats(
-  options?: Omit<UseQueryOptions<{ posts: number; responses: number; upvotes: number }>, 'queryKey' | 'queryFn'>
-): UseQueryResult<{ posts: number; responses: number; upvotes: number }> {
+  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;
+      const client = getApiClient()
+      const response =
+        await client.get<
+          ApiResponse<{posts: number; responses: number; upvotes: number}>
+        >('/users/me/stats')
+      return response.data.data
+    },
+    ...options,
+  })
+}
+
+/**
+ * Get current user's spots summary with activity indicators
+ *
+ * Returns list of spots where user has posted, with:
+ * - Post count per spot
+ * - Unread messages count
+ * - Pending responses count
+ * - Last activity timestamp
+ *
+ * @endpoint GET /users/me/spots-summary
+ */
+export function useUserSpotsSummary(
+  options?: Omit<UseQueryOptions<SpotsSummaryResponse>, 'queryKey' | 'queryFn'>,
+): UseQueryResult<SpotsSummaryResponse> {
+  return useQuery({
+    queryKey: userKeys.spotsSummary(),
+    queryFn: async () => {
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<SpotsSummaryResponse>>(
+        '/users/me/spots-summary',
+      )
+      return response.data.data
     },
     ...options,
-  });
+  })
 }
 
 /**
  * Get current user's activity
  *
- * @endpoint GET /api/v1/users/me/activity
+ * @endpoint GET /users/me/activity
  */
 export function useUserActivity(
   limit: number = 10,
-  options?: Omit<UseQueryOptions<unknown[]>, 'queryKey' | 'queryFn'>
+  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;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<unknown>>(
+        `/users/me/activity?limit=${limit}`,
+      )
+      return extractArrayData<unknown>(response.data.data)
     },
     ...options,
-  });
+  })
 }
 
 /**
  * Get current user's posts
  *
- * @endpoint GET /api/v1/user/me/posts
+ * @endpoint GET /user/me/posts
  */
 export function useUserPosts(
-  params?: { page?: number; limit?: number },
-  options?: Omit<UseQueryOptions<Post[]>, 'queryKey' | 'queryFn'>
+  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;
+      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<unknown>>(
+        `/user/me/posts?${queryParams}`,
+      )
+      return extractArrayData<Post>(response.data.data)
     },
     ...options,
-  });
+  })
 }
 
 /**
  * Get current user's clubs
  *
- * @endpoint GET /api/v1/user/me/clubs
+ * @endpoint GET /user/me/clubs
  */
 export function useUserClubs(
-  options?: Omit<UseQueryOptions<Club[]>, 'queryKey' | 'queryFn'>
+  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;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<unknown>>('/user/me/clubs')
+      return extractArrayData<Club>(response.data.data)
     },
     ...options,
-  });
+  })
 }
 
 /**
  * Get current user's spot subscriptions
  *
- * @endpoint GET /api/v1/user/me/subscriptions
+ * @endpoint GET /user/me/subscriptions
  */
 export function useUserSubscriptions(
-  options?: Omit<UseQueryOptions<SpotSubscription[]>, 'queryKey' | 'queryFn'>
+  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;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<unknown>>(
+        '/user/me/subscriptions',
+      )
+      return extractArrayData<SpotSubscription>(response.data.data)
     },
     ...options,
-  });
+  })
 }
 
 /**
  * Get blocked users list
  *
- * @endpoint GET /api/v1/user/me/blocked
+ * @endpoint GET /user/me/blocked
  */
 export function useBlockedUsers(
-  options?: Omit<UseQueryOptions<User[]>, 'queryKey' | 'queryFn'>
+  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;
+      const client = getApiClient()
+      const response =
+        await client.get<ApiResponse<unknown>>('/user/me/blocked')
+      return extractArrayData<User>(response.data.data)
     },
     ...options,
-  });
+  })
 }
 
 /**
  * Get current user's owned spots (for business owners)
  *
- * @endpoint GET /api/v1/users/me/owned-spots
+ * @endpoint GET /users/me/owned-spots
  */
 export function useOwnedSpots(
-  options?: Omit<UseQueryOptions<Spot[]>, 'queryKey' | 'queryFn'>
+  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;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<unknown>>(
+        '/users/me/owned-spots',
+      )
+      return extractArrayData<Spot>(response.data.data)
     },
     ...options,
-  });
+  })
 }
 
 /**
  * Get current user's favorite spots
  *
- * @endpoint GET /api/v1/users/me/favorites
+ * @endpoint GET /users/me/favorites
  */
 export function useUserFavorites(
-  options?: Omit<UseQueryOptions<FavoriteSpot[]>, 'queryKey' | 'queryFn'>
+  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;
+      const client = getApiClient()
+      const response = await client.get<ApiResponse<unknown>>(
+        '/users/me/favorites',
+      )
+      return extractArrayData<FavoriteSpot>(response.data.data)
     },
     ...options,
-  });
+  })
 }

package/src/api/types.ts

@@ -2,143 +2,97 @@
  * Spots SDK Types
  *
  * Type sources:
- * - Entity types (User, Spot, Post, etc.) → import from @prisma/client
- * - DTO types (CreatePostDto, etc.) → import from @spotsdev/types
+ * - Entity types (User, Spot, Post, etc.) → from ./entities (local definitions)
+ * - DTO types (CreatePostDto, etc.) → import from @spots/types (OpenAPI generated)
  *
- * This file provides type aliases for SDK convenience while maintaining
- * single sources of truth:
- * - Prisma schema for entities
- * - OpenAPI spec for DTOs
+ * This file provides type aliases for SDK convenience.
  */
 
-// ============================================================================
-// API RESPONSE TYPES
-// ============================================================================
-
-/**
- * Standard API response wrapper from ResponseInterceptor
- * All API responses are wrapped in this format
- */
-export interface ApiResponse<T> {
-  success: boolean;
-  data: T;
-  timestamp: string;
-}
-
-/**
- * Paginated response for list endpoints
- * Used inside ApiResponse.data for paginated queries
- */
-export interface PaginatedResponse<T> {
-  data: T[];
-  meta: {
-    total: number;
-    page: number;
-    limit: number;
-    totalPages: number;
-    hasNextPage: boolean;
-    hasPreviousPage: boolean;
-  };
-}
-
 // ============================================================================
 // RE-EXPORTS FROM SOURCES
 // ============================================================================
 
 // Re-export all DTO types from @spotsdev/types (OpenAPI generated)
-export * from '@spotsdev/types';
+export * from '@spotsdev/types'
 
-// Re-export entity types from @prisma/client
-export type {
-  // Models
-  User,
-  Spot,
-  SpotPost,
-  PostReply,
-  PostResponse,
-  PostUpvote,
-  PostReport,
-  Club,
-  ClubMember,
-  Conversation,
-  Message,
-  Notification,
-  PostTemplate,
-  Vibe,
-  Interest,
-  Intention,
-  LifeSituation,
-  FavoriteSpot,
-  SpotImage,
-  SpotVibe,
-  SpotIntention,
-  SpotClaim,
-  SpotSubscription,
-  City,
-  // Marketplace Models
-  Product,
-  Order,
-  OrderItem,
-  Payment,
-  InventoryLog,
-  StripeConnectAccount,
-  // Enums
-  SpotType,
-  SpotPostType,
-  AccountStatus,
-  ClaimStatus,
-  ResponseStatus,
-  ReportReason,
-  ReportStatus,
-  NotificationType,
-  // Marketplace Enums
-  ProductType,
-  ProductStatus,
-  OrderStatus,
-  PaymentProvider,
-  PaymentStatus,
-  FulfillmentType,
-  InventoryChangeReason,
-} from '@prisma/client';
+// Re-export entity types from local entities file (Prisma-compatible but no Prisma dep)
+export * from './entities'
 
 // ============================================================================
 // SDK TYPE ALIASES
 // These provide convenient names that match SDK usage patterns
 // ============================================================================
 
-import type {
-  SendOtpDto,
-  VerifyOtpDto,
-  CreatePostDto,
-  CreateReplyDto,
-  CreateResponseDto,
-  UpdateResponseDto,
-  UpdateUserDto,
-  UpvoteResponseDto,
-  VerifyOtpWrappedResponseDto,
-  CreateConversationDto,
-  CreateMessageDto,
-  ClaimSpotDto,
-} from '@spotsdev/types';
+import {
+  type ClaimSpotDto,
+  type CreateConversationDto,
+  type CreateMessageDto,
+  type CreatePostDto,
+  type CreateReplyDto,
+  type CreateResponseDto,
+  type SendOtpDto,
+  type UpdateResponseDto,
+  type UpdateUserDto,
+  type UpvoteResponseDto,
+  type VerifyOtpDto,
+  type VerifyOtpWrappedResponseDto,
+} from '@spotsdev/types'
 
-import type { SpotPost, PostTemplate } from '@prisma/client';
+import {type PostTemplate, type SpotPost} from './entities'
 
 // Request type aliases (map to DTOs)
-export type SendOtpRequest = SendOtpDto;
-export type VerifyOtpRequest = VerifyOtpDto;
-export type CreatePostRequest = CreatePostDto;
-export type CreateReplyRequest = CreateReplyDto;
-export type RespondToPostRequest = CreateResponseDto;
-export type UpdateResponseRequest = UpdateResponseDto;
-export type UpdateProfileRequest = UpdateUserDto;
-export type CreateConversationRequest = CreateConversationDto;
-export type SendMessageRequest = CreateMessageDto;
-export type ClaimSpotRequest = ClaimSpotDto;
+export type SendOtpRequest = SendOtpDto
+export type VerifyOtpRequest = VerifyOtpDto
+export type CreatePostRequest = CreatePostDto
+export type CreateReplyRequest = CreateReplyDto
+export type RespondToPostRequest = CreateResponseDto
+export type UpdateResponseRequest = UpdateResponseDto
+export type UpdateProfileRequest = UpdateUserDto
+export type CreateConversationRequest = CreateConversationDto
+export type SendMessageRequest = CreateMessageDto
+export type ClaimSpotRequest = ClaimSpotDto
 
 // Response type aliases
-export type UpvoteResponse = UpvoteResponseDto;
-export type AuthResponse = VerifyOtpWrappedResponseDto;
+export type UpvoteResponse = UpvoteResponseDto
+export type AuthResponse = VerifyOtpWrappedResponseDto
 
 // Entity type aliases (for backward compatibility)
-export type Post = SpotPost;
-export type Template = PostTemplate;
+export type Post = SpotPost
+export type Template = PostTemplate
+
+// ============================================================================
+// SDK-SPECIFIC TYPES (not from entities or DTOs)
+// ============================================================================
+
+/**
+ * Spot summary with activity indicators
+ * Returned by /users/me/spots-summary
+ */
+export interface SpotSummary {
+  spotId: string
+  spotName: string
+  spotSlug: string
+  spotType: string
+  postCount: number
+  unreadMessages: number
+  pendingResponses: number
+  lastActivity: string | null
+  hasNewActivity: boolean
+}
+
+/**
+ * Response meta for spots summary
+ */
+export interface SpotsSummaryMeta {
+  totalSpots: number
+  totalUnreadMessages: number
+  totalPendingResponses: number
+}
+
+/**
+ * Full response from /users/me/spots-summary
+ */
+export interface SpotsSummaryResponse {
+  data: SpotSummary[]
+  meta: SpotsSummaryMeta
+}

package/src/index.ts

@@ -35,29 +35,23 @@
 // API CLIENT
 // ============================================================================
 
-export { configureSDK, getApiClient, getConfig } from './api/client';
-export type { SDKConfig } from './api/client';
+export type {SDKConfig} from './api/client'
+export {configureSDK, getApiClient, getConfig} from './api/client'
 
 // ============================================================================
 // TYPES
 // ============================================================================
 
-export * from './api/types';
+export * from './api/types'
 
 // ============================================================================
 // QUERY HOOKS
 // ============================================================================
 
-export * from './api/queries';
+export * from './api/queries'
 
 // ============================================================================
 // MUTATION HOOKS
 // ============================================================================
 
-export * from './api/mutations';
-
-// ============================================================================
-// SERVICES (Plain async functions for testing/non-React)
-// ============================================================================
-
-export * from './api/services';
+export * from './api/mutations'