@spotsdev/sdk 1.0.0

package/src/api/services/marketplace.ts

@@ -0,0 +1,265 @@
+/**
+ * Marketplace API Service
+ *
+ * Plain async functions for products and orders.
+ * Can be used in tests or non-React environments.
+ */
+
+import { getApiClient } from '../client';
+import type {
+  Product,
+  ProductType,
+  ProductStatus,
+  OrderStatus,
+  ApiResponse,
+  PaginatedResponse,
+} from '../types';
+import type { ProductWithSpot } from '../queries/products';
+import type { OrderWithDetails } from '../queries/orders';
+
+// Re-export for convenience
+export type { ProductWithSpot, OrderWithDetails };
+
+export interface CreateProductInput {
+  name: string;
+  description?: string;
+  type: ProductType;
+  price: number;
+  currency?: string;
+  stockQuantity?: number;
+  lowStockAlert?: number;
+  deliveryRadius?: number;
+  prepTimeMinutes?: number;
+  eventDate?: string;
+  imageUrl?: string;
+}
+
+export interface UpdateProductInput {
+  name?: string;
+  description?: string;
+  price?: number;
+  stockQuantity?: number;
+  lowStockAlert?: number;
+  status?: ProductStatus;
+  deliveryRadius?: number;
+  prepTimeMinutes?: number;
+  eventDate?: string;
+  imageUrl?: string;
+}
+
+export interface CreateOrderInput {
+  spotId: string;
+  items: Array<{ productId: string; quantity: number }>;
+  notes?: string;
+}
+
+// ============================================================================
+// PRODUCTS SERVICE
+// ============================================================================
+
+export const productsService = {
+  /**
+   * List products for a spot
+   */
+  async listBySpot(
+    spotId: string,
+    params?: { type?: ProductType; status?: ProductStatus; limit?: number; page?: number }
+  ): Promise<PaginatedResponse<Product>> {
+    const client = getApiClient();
+    const queryParams = new URLSearchParams();
+    if (params?.type) queryParams.set('type', params.type);
+    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<Product>>>(
+      `/api/v1/spots/${spotId}/products?${queryParams}`
+    );
+    return response.data.data;
+  },
+
+  /**
+   * Get product by ID
+   */
+  async getById(productId: string): Promise<ProductWithSpot> {
+    const client = getApiClient();
+    const response = await client.get<ApiResponse<ProductWithSpot>>(
+      `/api/v1/products/${productId}`
+    );
+    return response.data.data;
+  },
+
+  /**
+   * Get product by slug
+   */
+  async getBySlug(spotId: string, slug: string): Promise<ProductWithSpot> {
+    const client = getApiClient();
+    const response = await client.get<ApiResponse<ProductWithSpot>>(
+      `/api/v1/spots/${spotId}/products/slug/${slug}`
+    );
+    return response.data.data;
+  },
+
+  /**
+   * Create a product (requires owner auth)
+   */
+  async create(spotId: string, data: CreateProductInput): Promise<Product> {
+    const client = getApiClient();
+    const response = await client.post<ApiResponse<Product>>(
+      `/api/v1/spots/${spotId}/products`,
+      data
+    );
+    return response.data.data;
+  },
+
+  /**
+   * Update a product (requires owner auth)
+   */
+  async update(productId: string, data: UpdateProductInput): Promise<Product> {
+    const client = getApiClient();
+    const response = await client.put<ApiResponse<Product>>(
+      `/api/v1/products/${productId}`,
+      data
+    );
+    return response.data.data;
+  },
+
+  /**
+   * Delete a product (requires owner auth)
+   */
+  async delete(productId: string): Promise<void> {
+    const client = getApiClient();
+    await client.delete(`/api/v1/products/${productId}`);
+  },
+
+  /**
+   * Adjust stock (requires owner auth)
+   */
+  async adjustStock(
+    productId: string,
+    quantity: number,
+    reason: 'RESTOCK' | 'ADJUSTMENT',
+    notes?: string
+  ): Promise<Product> {
+    const client = getApiClient();
+    const response = await client.post<ApiResponse<Product>>(
+      `/api/v1/products/${productId}/stock`,
+      { quantity, reason, notes }
+    );
+    return response.data.data;
+  },
+};
+
+// ============================================================================
+// ORDERS SERVICE
+// ============================================================================
+
+export const ordersService = {
+  /**
+   * Create an order
+   */
+  async create(data: CreateOrderInput): Promise<OrderWithDetails> {
+    const client = getApiClient();
+    const response = await client.post<ApiResponse<OrderWithDetails>>(
+      '/api/v1/orders',
+      data
+    );
+    return response.data.data;
+  },
+
+  /**
+   * Get order by ID
+   */
+  async getById(orderId: string): Promise<OrderWithDetails> {
+    const client = getApiClient();
+    const response = await client.get<ApiResponse<OrderWithDetails>>(
+      `/api/v1/orders/${orderId}`
+    );
+    return response.data.data;
+  },
+
+  /**
+   * List my orders (as buyer)
+   */
+  async listMyOrders(
+    params?: { status?: OrderStatus; limit?: number; page?: number }
+  ): 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;
+  },
+
+  /**
+   * List spot orders (as seller)
+   */
+  async listSpotOrders(
+    spotId: string,
+    params?: { status?: OrderStatus; limit?: number; page?: number }
+  ): 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;
+  },
+
+  /**
+   * Update order status (as seller)
+   */
+  async updateStatus(orderId: string, status: OrderStatus): Promise<OrderWithDetails> {
+    const client = getApiClient();
+    const response = await client.put<ApiResponse<OrderWithDetails>>(
+      `/api/v1/orders/${orderId}/status`,
+      { status }
+    );
+    return response.data.data;
+  },
+
+  /**
+   * Cancel order (as buyer)
+   */
+  async cancel(orderId: string): Promise<OrderWithDetails> {
+    const client = getApiClient();
+    const response = await client.post<ApiResponse<OrderWithDetails>>(
+      `/api/v1/orders/${orderId}/cancel`
+    );
+    return response.data.data;
+  },
+};
+
+// ============================================================================
+// PAYMENTS SERVICE
+// ============================================================================
+
+export const paymentsService = {
+  /**
+   * Create Stripe PaymentIntent
+   */
+  async createStripeIntent(orderId: string): Promise<{ clientSecret: string; paymentIntentId: string }> {
+    const client = getApiClient();
+    const response = await client.post<ApiResponse<{ clientSecret: string; paymentIntentId: string }>>(
+      `/api/v1/payments/stripe/intent/${orderId}`
+    );
+    return response.data.data;
+  },
+
+  /**
+   * Create Coinbase charge
+   */
+  async createCoinbaseCharge(orderId: string): Promise<{ chargeId: string; chargeCode: string; hostedUrl: string }> {
+    const client = getApiClient();
+    const response = await client.post<ApiResponse<{ chargeId: string; chargeCode: string; hostedUrl: string }>>(
+      `/api/v1/payments/coinbase/charge/${orderId}`
+    );
+    return response.data.data;
+  },
+};

package/src/api/types.ts

@@ -0,0 +1,144 @@
+/**
+ * Spots SDK Types
+ *
+ * Type sources:
+ * - Entity types (User, Spot, Post, etc.) → import from @prisma/client
+ * - DTO types (CreatePostDto, etc.) → import from @spotsdev/types
+ *
+ * This file provides type aliases for SDK convenience while maintaining
+ * single sources of truth:
+ * - Prisma schema for entities
+ * - OpenAPI spec for DTOs
+ */
+
+// ============================================================================
+// 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';
+
+// 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';
+
+// ============================================================================
+// 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 { SpotPost, PostTemplate } from '@prisma/client';
+
+// 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;
+
+// Response type aliases
+export type UpvoteResponse = UpvoteResponseDto;
+export type AuthResponse = VerifyOtpWrappedResponseDto;
+
+// Entity type aliases (for backward compatibility)
+export type Post = SpotPost;
+export type Template = PostTemplate;

package/src/index.ts

@@ -0,0 +1,63 @@
+/**
+ * Spots SDK
+ *
+ * TypeScript SDK for the Spots API with TanStack Query hooks.
+ *
+ * @example
+ * ```tsx
+ * import { configureSDK, useCurrentUser, useSpots, useCreatePost } from '@spots/sdk';
+ *
+ * // Configure SDK with your API base URL and token management
+ * configureSDK({
+ *   baseURL: 'https://spots-api-psi.vercel.app',
+ *   getAccessToken: () => localStorage.getItem('accessToken'),
+ *   refreshAccessToken: async () => {
+ *     // Your token refresh logic
+ *     return newAccessToken;
+ *   },
+ *   onUnauthorized: () => {
+ *     // Handle unauthorized access
+ *     window.location.href = '/login';
+ *   },
+ * });
+ *
+ * // Use hooks in your components
+ * function App() {
+ *   const { data: user } = useCurrentUser();
+ *   const { data: spots } = useSpots();
+ *   const { mutate: createPost } = useCreatePost();
+ *   // ...
+ * }
+ * ```
+ */
+
+// ============================================================================
+// API CLIENT
+// ============================================================================
+
+export { configureSDK, getApiClient, getConfig } from './api/client';
+export type { SDKConfig } from './api/client';
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export * from './api/types';
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+export * from './api/queries';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+export * from './api/mutations';
+
+// ============================================================================
+// SERVICES (Plain async functions for testing/non-React)
+// ============================================================================
+
+export * from './api/services';