@spotsdev/sdk 1.5.3 → 1.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spotsdev/sdk",
-  "version": "1.5.3",
+  "version": "1.7.0",
   "description": "Shared TypeScript SDK for Spots API - TanStack Query hooks, API client, and utilities",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -47,7 +47,7 @@
     "react": ">=18.0.0"
   },
   "dependencies": {
-    "@spotsdev/types": "^1.3.2"
+    "@spotsdev/types": "file:../spots-types"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/src/api/entities.ts

@@ -2,7 +2,7 @@
  * Spots SDK Entity Types
  *
  * ALL entity and enum types are imported from @spotsdev/types (generated from OpenAPI spec).
- * This file re-exports them with SDK-friendly aliases and adds SDK-specific types.
+ * This file re-exports them with SDK-friendly aliases.
  *
  * IMPORTANT: Do NOT define entity types here - they come from spots-types.
  */
@@ -19,6 +19,7 @@ export type {
   PostStatus,
   ResponseStatus,
   ReportReason,
+  ReportStatus,
   ProductType,
   ProductStatus,
   FulfillmentType,
@@ -26,6 +27,9 @@ export type {
   OrderStatus,
   NotificationType,
   MediaType,
+  ClubCategory,
+  ClubStatus,
+  ClubMemberStatus,
 
   // Spot types
   SpotResponseDto,
@@ -57,6 +61,18 @@ export type {
   CreateReportDto,
   PostStatusDto,
 
+  // Post upvotes
+  PostUpvoteDto,
+  PostUpvoterDto,
+  PostUpvotesMetaDto,
+  PostUpvotesResponseDto,
+
+  // Post reports
+  PostReportDto,
+
+  // Post responses (I'm interested)
+  PostResponseEntityDto,
+
   // User types
   UserResponseDto,
   UpdateUserDto,
@@ -74,6 +90,8 @@ export type {
   CreateOrderDto,
   OrderItemDto,
   UpdateOrderStatusDto,
+  OrderResponseDto,
+  OrderItemResponseDto,
 
   // Notification types
   NotificationResponseDto,
@@ -86,10 +104,39 @@ export type {
   SendOtpResponseDto,
   RefreshTokenResponseDto,
 
-  // Other types
-  CreateMediaDto,
+  // Conversation & Message types
+  ConversationDto,
+  ConversationParticipantDto,
+  ConversationLastMessageDto,
+  MessageDto,
+  MessageSenderDto,
   CreateConversationDto,
   CreateMessageDto,
+
+  // Reference data types
+  VibeDto,
+  UserVibeDto,
+  LifeSituationDto,
+  CityDto,
+
+  // Club types
+  ClubDto,
+  ClubMemberDto,
+  ClubMemberWithUserDto,
+
+  // Template types
+  PostTemplateDto,
+
+  // Favorites & Subscriptions
+  FavoriteSpotDto,
+  SpotSubscriptionDto,
+  SpotClaimDto,
+
+  // Pagination
+  PaginationMetaDto,
+
+  // Other types
+  CreateMediaDto,
   CreateInterestDto,
   UpdateInterestDto,
   AddUserInterestDto,
@@ -112,11 +159,22 @@ import type {
   OrderItemDto as OrderItemDtoType,
   NotificationResponseDto,
   SpotOwnerDto,
-  PostUserDto,
-  ResponseStatus,
-  ReportReason,
-  ClaimStatus,
-  OrderStatus,
+  PostUpvoteDto as PostUpvoteDtoType,
+  ConversationDto as ConversationDtoType,
+  MessageDto as MessageDtoType,
+  ClubDto as ClubDtoType,
+  ClubMemberDto as ClubMemberDtoType,
+  PostTemplateDto as PostTemplateDtoType,
+  VibeDto as VibeDtoType,
+  CityDto as CityDtoType,
+  FavoriteSpotDto as FavoriteSpotDtoType,
+  SpotSubscriptionDto as SpotSubscriptionDtoType,
+  SpotClaimDto as SpotClaimDtoType,
+  OrderResponseDto as OrderResponseDtoType,
+  PostReportDto as PostReportDtoType,
+  PostResponseEntityDto as PostResponseEntityDtoType,
+  LifeSituationDto as LifeSituationDtoType,
+  PaginationMetaDto as PaginationMetaDtoType,
 } from '@spotsdev/types'
 
 // ============================================================================
@@ -149,229 +207,28 @@ export type User = SpotOwnerDto & {
   updatedAt?: Date
 }
 
-// ============================================================================
-// SDK-SPECIFIC TYPES (not in OpenAPI spec)
-// ============================================================================
-
-// Enums not yet exposed via API DTOs
-export type ReportStatus = 'PENDING' | 'REVIEWED' | 'RESOLVED' | 'DISMISSED'
-export type ClubMemberRole = 'MEMBER' | 'ADMIN' | 'OWNER'
-
-// PostResponse entity (different from CreateResponseDto/UpdateResponseDto)
-export interface PostResponse {
-  id: string
-  postId: string
-  userId: string
-  note: string | null
-  status: ResponseStatus
-  createdAt: Date
-  updatedAt: Date
-  user?: User
-  post?: SpotPost
-}
-
-// PostUpvote entity
-export interface PostUpvote {
-  id: string
-  postId: string
-  userId: string
-  createdAt: Date
-}
-
-// PostUpvoter for /posts/:id/upvotes endpoint
-export interface PostUpvoter {
-  id: string
-  userId: string
-  name: string | null
-  avatarUrl: string | null
-  createdAt: Date
-}
-
-// PostUpvotesResponse from /posts/:id/upvotes endpoint
-export interface PostUpvotesResponse {
-  data: PostUpvoter[]
-  meta: {
-    total: number
-    limit: number
-    offset: number
-    hasMore: boolean
-    currentUserUpvoted: boolean
-    isPostAuthor: boolean
-  }
-}
-
-// PostReport entity
-export interface PostReport {
-  id: string
-  postId: string
-  userId: string
-  reason: ReportReason
-  details: string | null
-  status: ReportStatus
-  createdAt: Date
-  updatedAt: Date
-}
-
-// Club entities (not yet in API DTOs)
-export interface Club {
-  id: string
-  name: string
-  slug: string
-  description: string | null
-  imageUrl: string | null
-  isPrivate: boolean
-  createdById: string
-  createdAt: Date
-  updatedAt: Date
-}
-
-export interface ClubMember {
-  id: string
-  clubId: string
-  userId: string
-  role: ClubMemberRole
-  joinedAt: Date
-}
-
-// Conversation entities (not yet in API DTOs)
-export interface Conversation {
-  id: string
-  createdAt: Date
-  updatedAt: Date
-  participants?: User[]
-  messages?: Message[]
-}
-
-export interface Message {
-  id: string
-  conversationId: string
-  senderId: string
-  content: string
-  createdAt: Date
-  sender?: User
-}
-
-// Template entity (not yet in API DTOs)
-export interface PostTemplate {
-  id: string
-  postType: SpotPostType
-  emoji: string
-  title: string
-  placeholder: string | null
-  isActive: boolean
-  sortOrder: number
-  createdAt: Date
-  updatedAt: Date
-}
-
-// Reference entities (not yet in API DTOs)
-export interface Vibe {
-  id: string
-  name: string
-  emoji: string | null
-  createdAt: Date
-}
-
-export interface Interest {
-  id: string
-  name: string
-  emoji: string | null
-  category: string | null
-  createdAt: Date
-}
-
-export interface Intention {
-  id: string
-  name: string
-  emoji: string | null
-  createdAt: Date
-}
-
-export interface LifeSituation {
-  id: string
-  name: string
-  emoji: string | null
-  createdAt: Date
-}
-
-// User vibe (simplified vibe attached to user)
-export interface UserVibe {
-  id: string
-  name: string
-  emoji: string | null
-  slug?: string
-  category?: string
-}
-
-// Favorites and subscriptions (not yet in API DTOs)
-export interface FavoriteSpot {
-  id: string
-  userId: string
-  spotId: string
-  createdAt: Date
-  spot?: Spot
-}
-
-export interface SpotSubscription {
-  id: string
-  spotId: string
-  userId: string
-  createdAt: Date
-  spot?: Spot
-}
-
-// SpotClaim entity
-export interface SpotClaim {
-  id: string
-  spotId: string
-  userId: string
-  status: ClaimStatus
-  verificationMethod: string | null
-  createdAt: Date
-  updatedAt: Date
-}
-
-// City entity
-export interface City {
-  id: string
-  name: string
-  country: string
-  latitude: number
-  longitude: number
-  timezone: string | null
-  createdAt: Date
-}
-
-// Order entity (full order, not just OrderItemDto)
-export interface Order {
-  id: string
-  spotId: string
-  userId: string
-  status: OrderStatus
-  subtotal: number
-  tax: number
-  total: number
-  currency: string
-  notes: string | null
-  metadata: Record<string, unknown> | null
-  createdAt: Date
-  updatedAt: Date
-  items?: OrderItem[]
-}
+// Aliases for new types
+export type PostUpvote = PostUpvoteDtoType
+export type Conversation = ConversationDtoType
+export type Message = MessageDtoType
+export type Club = ClubDtoType
+export type ClubMember = ClubMemberDtoType
+export type PostTemplate = PostTemplateDtoType
+export type Vibe = VibeDtoType
+export type City = CityDtoType
+export type FavoriteSpot = FavoriteSpotDtoType
+export type SpotSubscription = SpotSubscriptionDtoType
+export type SpotClaim = SpotClaimDtoType
+export type Order = OrderResponseDtoType
+export type PostReport = PostReportDtoType
+export type PostResponse = PostResponseEntityDtoType
+export type LifeSituation = LifeSituationDtoType
+export type PaginationMeta = PaginationMetaDtoType
 
 // ============================================================================
-// PAGINATION TYPES
+// GENERIC PAGINATION RESPONSE
 // ============================================================================
 
-export interface PaginationMeta {
-  total: number
-  page: number
-  limit: number
-  totalPages: number
-  hasNextPage: boolean
-  hasPreviousPage: boolean
-}
-
 export interface PaginatedResponse<T> {
   data: T[]
   meta: PaginationMeta

package/src/api/mutations/orders.ts

@@ -31,14 +31,23 @@ export interface CreateOrderRequest {
   deliveryAddress?: string
 }
 
-export interface CreateOrderResponse extends Order {
+export interface CreateOrderResponse extends Omit<Order, 'items'> {
   items: Array<{
     id: string
+    orderId: string
     productId: string
     productName: string
+    productType: string
     quantity: number
     unitPrice: number
     totalPrice: number
+    status: string
+    passCode: string | null
+    ticketCode: string | null
+    passExpiresAt: string | null
+    redeemedAt: string | null
+    specialInstructions: string | null
+    createdAt: string
   }>
 }
 

package/src/api/mutations/products.ts

@@ -12,7 +12,7 @@ import {
 } from '@tanstack/react-query'
 import {getApiClient} from '../client'
 import {productKeys} from '../queries/products'
-import type {Product, ProductType, ProductStatus, ApiResponse} from '../types'
+import type {Product, ProductType, ApiResponse} from '../types'
 
 // ============================================================================
 // TYPES
@@ -26,16 +26,11 @@ export interface CreateProductRequest {
   type: ProductType
   price: number
   currency?: string
-  stockQuantity?: number
-  lowStockThreshold?: number
-  validFrom?: string
-  validUntil?: string
-  deliveryRadiusKm?: number
-  prepTimeMinutes?: number
-  maxCapacity?: number
-  eventDate?: string
+  stock?: number // Maps to API's stockQuantity
+  validityDays?: number // For PASS type - number of days valid
+  eventDate?: string // For EVENT_TICKET type
   imageUrl?: string
-  metadata?: Record<string, unknown>
+  isActive?: boolean // true = ACTIVE, false = DRAFT
 }
 
 /**
@@ -51,19 +46,15 @@ function generateSlug(name: string): string {
 
 export interface UpdateProductRequest {
   name?: string
+  slug?: string
   description?: string
   price?: number
-  stockQuantity?: number
-  lowStockThreshold?: number
-  status?: ProductStatus
-  validFrom?: string
-  validUntil?: string
-  deliveryRadiusKm?: number
-  prepTimeMinutes?: number
-  maxCapacity?: number
-  eventDate?: string
+  type?: ProductType
+  stock?: number // Maps to API's stockQuantity
+  validityDays?: number // For PASS type - number of days valid
+  eventDate?: string // For EVENT_TICKET type
   imageUrl?: string
-  metadata?: Record<string, unknown>
+  isActive?: boolean // true = ACTIVE, false = DRAFT (maps to status field)
 }
 
 // ============================================================================

package/src/api/queries/orders.ts

@@ -35,7 +35,7 @@ export const orderKeys = {
 // TYPES
 // ============================================================================
 
-export interface OrderWithDetails extends Order {
+export interface OrderWithDetails extends Omit<Order, 'items'> {
   items: (OrderItem & {
     product: Pick<Product, 'id' | 'name' | 'slug' | 'type' | 'imageUrl'>
   })[]

package/src/api/types.ts

@@ -36,6 +36,7 @@ import {
   type UpvoteResponseDto,
   type VerifyOtpDto,
   type VerifyOtpWrappedResponseDto,
+  type PostUpvotesResponseDto,
 } from '@spotsdev/types'
 
 import {type PostTemplate, type SpotPost} from './entities'
@@ -54,6 +55,7 @@ export type ClaimSpotRequest = ClaimSpotDto
 
 // Response type aliases
 export type UpvoteResponse = UpvoteResponseDto
+export type PostUpvotesResponse = PostUpvotesResponseDto
 export type AuthResponse = VerifyOtpWrappedResponseDto
 
 // Entity type aliases (for backward compatibility)