@spotsdev/sdk 1.0.0

package/src/api/mutations/notifications.ts

@@ -0,0 +1,70 @@
+/**
+ * Notifications Mutation Hooks
+ *
+ * TanStack Query hooks for notification mutation operations.
+ */
+
+import { useMutation, useQueryClient, UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { notificationKeys } from '../queries/notifications';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Mark notifications as read
+ *
+ * @endpoint PUT /api/v1/notifications/read
+ */
+export function useMarkNotificationsRead(
+  options?: Omit<UseMutationOptions<void, Error, { notificationIds?: string[] }>, 'mutationFn'>
+): UseMutationResult<void, Error, { notificationIds?: string[] }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: { notificationIds?: string[] }): Promise<void> => {
+      const client = getApiClient();
+      await client.put('/api/v1/notifications/read', data);
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: notificationKeys.lists() });
+      queryClient.invalidateQueries({ queryKey: notificationKeys.unreadCount() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Register device token for push notifications
+ *
+ * @endpoint POST /api/v1/device-tokens
+ */
+export function useRegisterDeviceToken(
+  options?: Omit<UseMutationOptions<void, Error, { token: string; platform: 'ios' | 'android' | 'web' }>, 'mutationFn'>
+): UseMutationResult<void, Error, { token: string; platform: 'ios' | 'android' | 'web' }> {
+  return useMutation({
+    mutationFn: async (data): Promise<void> => {
+      const client = getApiClient();
+      await client.post('/api/v1/device-tokens', data);
+    },
+    ...options,
+  });
+}
+
+/**
+ * Remove device token
+ *
+ * @endpoint DELETE /api/v1/device-tokens
+ */
+export function useRemoveDeviceToken(
+  options?: Omit<UseMutationOptions<void, Error, { token: string }>, 'mutationFn'>
+): UseMutationResult<void, Error, { token: string }> {
+  return useMutation({
+    mutationFn: async (data): Promise<void> => {
+      const client = getApiClient();
+      await client.delete('/api/v1/device-tokens', { data });
+    },
+    ...options,
+  });
+}

package/src/api/mutations/orders.ts

@@ -0,0 +1,174 @@
+/**
+ * Orders Mutation Hooks
+ *
+ * TanStack Query hooks for order mutation operations.
+ */
+
+import { useMutation, useQueryClient, UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { orderKeys, OrderWithDetails } from '../queries/orders';
+import { productKeys } from '../queries/products';
+import type { Order, OrderStatus, ApiResponse } from '../types';
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface CartItem {
+  productId: string;
+  quantity: number;
+}
+
+export interface CreateOrderRequest {
+  spotId: string;
+  items: CartItem[];
+  notes?: string;
+  deliveryAddress?: string;
+}
+
+export interface CreateOrderResponse extends Order {
+  items: Array<{
+    id: string;
+    productId: string;
+    productName: string;
+    quantity: number;
+    unitPrice: number;
+    totalPrice: number;
+  }>;
+}
+
+export interface PaymentIntentResponse {
+  clientSecret: string;
+  paymentIntentId: string;
+}
+
+export interface CoinbaseChargeResponse {
+  chargeId: string;
+  chargeCode: string;
+  hostedUrl: string;
+}
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Create a new order
+ *
+ * @endpoint POST /api/v1/orders
+ */
+export function useCreateOrder(
+  options?: Omit<UseMutationOptions<CreateOrderResponse, Error, CreateOrderRequest>, 'mutationFn'>
+): UseMutationResult<CreateOrderResponse, Error, CreateOrderRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateOrderRequest): Promise<CreateOrderResponse> => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<CreateOrderResponse>>('/api/v1/orders', data);
+      return response.data.data;
+    },
+    onSuccess: (_, variables) => {
+      // Invalidate products to reflect updated stock
+      queryClient.invalidateQueries({ queryKey: productKeys.bySpot(variables.spotId) });
+      // Invalidate my orders list
+      queryClient.invalidateQueries({ queryKey: orderKeys.list({ my: true }) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Create Stripe PaymentIntent for an order
+ *
+ * @endpoint POST /api/v1/payments/stripe/intent/{orderId}
+ */
+export function useCreateStripeIntent(
+  options?: Omit<UseMutationOptions<PaymentIntentResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<PaymentIntentResponse, Error, string> {
+  return useMutation({
+    mutationFn: async (orderId: string): Promise<PaymentIntentResponse> => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<PaymentIntentResponse>>(
+        `/api/v1/payments/stripe/intent/${orderId}`
+      );
+      return response.data.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Create Coinbase Commerce charge for an order
+ *
+ * @endpoint POST /api/v1/payments/coinbase/charge/{orderId}
+ */
+export function useCreateCoinbaseCharge(
+  options?: Omit<UseMutationOptions<CoinbaseChargeResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<CoinbaseChargeResponse, Error, string> {
+  return useMutation({
+    mutationFn: async (orderId: string): Promise<CoinbaseChargeResponse> => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<CoinbaseChargeResponse>>(
+        `/api/v1/payments/coinbase/charge/${orderId}`
+      );
+      return response.data.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update order status (seller action)
+ *
+ * @endpoint PUT /api/v1/orders/{orderId}/status
+ */
+export function useUpdateOrderStatus(
+  options?: Omit<
+    UseMutationOptions<OrderWithDetails, Error, { orderId: string; status: OrderStatus }>,
+    'mutationFn'
+  >
+): UseMutationResult<OrderWithDetails, Error, { orderId: string; status: OrderStatus }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ orderId, status }): Promise<OrderWithDetails> => {
+      const client = getApiClient();
+      const response = await client.put<ApiResponse<OrderWithDetails>>(`/api/v1/orders/${orderId}/status`, {
+        status,
+      });
+      return response.data.data;
+    },
+    onSuccess: (data) => {
+      queryClient.setQueryData(orderKeys.detail(data.id), data);
+      queryClient.invalidateQueries({ queryKey: orderKeys.spotOrders(data.spotId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Cancel an order (buyer action, only for pending orders)
+ *
+ * @endpoint POST /api/v1/orders/{orderId}/cancel
+ */
+export function useCancelOrder(
+  options?: Omit<UseMutationOptions<OrderWithDetails, Error, string>, 'mutationFn'>
+): UseMutationResult<OrderWithDetails, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (orderId: string): Promise<OrderWithDetails> => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<OrderWithDetails>>(`/api/v1/orders/${orderId}/cancel`);
+      return response.data.data;
+    },
+    onSuccess: (data) => {
+      queryClient.setQueryData(orderKeys.detail(data.id), data);
+      queryClient.invalidateQueries({ queryKey: orderKeys.list({ my: true }) });
+      // Restore stock
+      queryClient.invalidateQueries({ queryKey: productKeys.bySpot(data.spotId) });
+    },
+    ...options,
+  });
+}

package/src/api/mutations/posts.ts

@@ -0,0 +1,278 @@
+/**
+ * Posts Mutation Hooks
+ *
+ * TanStack Query hooks for post/board mutation operations.
+ */
+
+import { useMutation, useQueryClient, UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { postKeys } from '../queries/posts';
+import type {
+  Post,
+  PostResponse,
+  CreatePostRequest,
+  CreateReplyRequest,
+  RespondToPostRequest,
+  UpdateResponseRequest,
+  ApiResponse,
+  UpvoteResponse,
+  PostStatusDto,
+} from '../types';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Create a new post
+ *
+ * @endpoint POST /api/v1/spots/{spotId}/posts
+ */
+export function useCreatePost(
+  options?: Omit<UseMutationOptions<Post, Error, { spotId: string } & CreatePostRequest>, 'mutationFn'>
+): UseMutationResult<Post, Error, { spotId: string } & CreatePostRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ spotId, ...data }): Promise<Post> => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<Post>>(`/api/v1/spots/${spotId}/posts`, data);
+      return response.data.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: postKeys.bySpot(variables.spotId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update a post
+ *
+ * @endpoint PUT /api/v1/posts/{postId}
+ */
+export function useUpdatePost(
+  options?: Omit<UseMutationOptions<Post, Error, { postId: string; title?: string; content?: string }>, 'mutationFn'>
+): UseMutationResult<Post, Error, { postId: string; title?: string; content?: string }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ postId, ...data }): Promise<Post> => {
+      const client = getApiClient();
+      const response = await client.put<ApiResponse<Post>>(`/api/v1/posts/${postId}`, data);
+      return response.data.data;
+    },
+    onSuccess: (data, variables) => {
+      queryClient.setQueryData(postKeys.detail(variables.postId), data);
+    },
+    ...options,
+  });
+}
+
+/**
+ * Delete a post
+ *
+ * @endpoint DELETE /api/v1/posts/{postId}
+ */
+export function useDeletePost(
+  options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>
+): UseMutationResult<void, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (postId: string): Promise<void> => {
+      const client = getApiClient();
+      await client.delete(`/api/v1/posts/${postId}`);
+    },
+    onSuccess: (_, postId) => {
+      queryClient.invalidateQueries({ queryKey: postKeys.detail(postId) });
+      queryClient.invalidateQueries({ queryKey: postKeys.lists() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Fulfill a post (mark as fulfilled)
+ *
+ * @endpoint PUT /api/v1/posts/{postId}/fulfill
+ */
+export function useFulfillPost(
+  options?: Omit<UseMutationOptions<Post, Error, string>, 'mutationFn'>
+): UseMutationResult<Post, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (postId: string): Promise<Post> => {
+      const client = getApiClient();
+      const response = await client.put<ApiResponse<Post>>(`/api/v1/posts/${postId}/fulfill`);
+      return response.data.data;
+    },
+    onSuccess: (data, postId) => {
+      queryClient.setQueryData(postKeys.detail(postId), data);
+    },
+    ...options,
+  });
+}
+
+/**
+ * Upvote/unupvote a post
+ *
+ * @endpoint POST /api/v1/posts/{postId}/upvote
+ */
+export function useUpvotePost(
+  options?: Omit<UseMutationOptions<UpvoteResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<UpvoteResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (postId: string): Promise<UpvoteResponse> => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<UpvoteResponse>>(`/api/v1/posts/${postId}/upvote`);
+      return response.data.data;
+    },
+    onSuccess: (_, postId) => {
+      queryClient.invalidateQueries({ queryKey: postKeys.detail(postId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Create a reply to a post
+ *
+ * @endpoint POST /api/v1/posts/{postId}/reply
+ */
+export function useCreateReply(
+  options?: Omit<UseMutationOptions<unknown, Error, { postId: string } & CreateReplyRequest>, 'mutationFn'>
+): UseMutationResult<unknown, Error, { postId: string } & CreateReplyRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ postId, ...data }) => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<unknown>>(`/api/v1/posts/${postId}/reply`, data);
+      return response.data.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: postKeys.detail(variables.postId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Delete a reply
+ *
+ * @endpoint DELETE /api/v1/replies/{replyId}
+ */
+export function useDeleteReply(
+  options?: Omit<UseMutationOptions<void, Error, { replyId: string; postId: string }>, 'mutationFn'>
+): UseMutationResult<void, Error, { replyId: string; postId: string }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ replyId }): Promise<void> => {
+      const client = getApiClient();
+      await client.delete(`/api/v1/replies/${replyId}`);
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: postKeys.detail(variables.postId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Respond to a post (express interest)
+ *
+ * @endpoint POST /api/v1/posts/{postId}/respond
+ */
+export function useRespondToPost(
+  options?: Omit<UseMutationOptions<PostResponse, Error, { postId: string } & RespondToPostRequest>, 'mutationFn'>
+): UseMutationResult<PostResponse, Error, { postId: string } & RespondToPostRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ postId, ...data }): Promise<PostResponse> => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<PostResponse>>(`/api/v1/posts/${postId}/respond`, data);
+      return response.data.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: postKeys.detail(variables.postId) });
+      queryClient.invalidateQueries({ queryKey: postKeys.responses(variables.postId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Accept or decline a response
+ *
+ * @endpoint PUT /api/v1/responses/{responseId}
+ */
+export function useUpdateResponse(
+  options?: Omit<UseMutationOptions<PostResponse, Error, { responseId: string; postId: string } & UpdateResponseRequest>, 'mutationFn'>
+): UseMutationResult<PostResponse, Error, { responseId: string; postId: string } & UpdateResponseRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ responseId, postId: _, ...data }): Promise<PostResponse> => {
+      const client = getApiClient();
+      const response = await client.put<ApiResponse<PostResponse>>(`/api/v1/responses/${responseId}`, data);
+      return response.data.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: postKeys.responses(variables.postId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Report a post
+ *
+ * @endpoint POST /api/v1/posts/{postId}/report
+ */
+export function useReportPost(
+  options?: Omit<UseMutationOptions<void, Error, { postId: string; reason: string; details?: string }>, 'mutationFn'>
+): UseMutationResult<void, Error, { postId: string; reason: string; details?: string }> {
+  return useMutation({
+    mutationFn: async ({ postId, ...data }): Promise<void> => {
+      const client = getApiClient();
+      await client.post(`/api/v1/posts/${postId}/report`, data);
+    },
+    ...options,
+  });
+}
+
+// PostStatusUpdate matches partial PostStatusDto for updates
+interface PostStatusUpdate {
+  isRead?: boolean;
+  isHidden?: boolean;
+  isPinned?: boolean;
+}
+
+/**
+ * Update user's status for a post (read/hidden/pinned)
+ *
+ * @endpoint PUT /api/v1/posts/{postId}/status
+ */
+export function useUpdatePostStatus(
+  options?: Omit<UseMutationOptions<PostStatusDto, Error, { postId: string } & PostStatusUpdate>, 'mutationFn'>
+): UseMutationResult<PostStatusDto, Error, { postId: string } & PostStatusUpdate> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ postId, ...data }): Promise<PostStatusDto> => {
+      const client = getApiClient();
+      const response = await client.put<ApiResponse<PostStatusDto>>(`/api/v1/posts/${postId}/status`, data);
+      return response.data.data;
+    },
+    onSuccess: (data, variables) => {
+      queryClient.setQueryData(postKeys.status(variables.postId), data);
+    },
+    ...options,
+  });
+}

package/src/api/mutations/products.ts

@@ -0,0 +1,160 @@
+/**
+ * Products Mutation Hooks
+ *
+ * TanStack Query hooks for product mutation operations.
+ */
+
+import { useMutation, useQueryClient, UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { productKeys } from '../queries/products';
+import type { Product, ProductType, ProductStatus, ApiResponse } from '../types';
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface CreateProductRequest {
+  spotId: string;
+  name: string;
+  description?: string;
+  type: ProductType;
+  price: number;
+  currency?: string;
+  stockQuantity?: number;
+  lowStockThreshold?: number;
+  validFrom?: string;
+  validUntil?: string;
+  deliveryRadiusKm?: number;
+  prepTimeMinutes?: number;
+  maxCapacity?: number;
+  eventDate?: string;
+  imageUrl?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface UpdateProductRequest {
+  name?: string;
+  description?: string;
+  price?: number;
+  stockQuantity?: number;
+  lowStockThreshold?: number;
+  status?: ProductStatus;
+  validFrom?: string;
+  validUntil?: string;
+  deliveryRadiusKm?: number;
+  prepTimeMinutes?: number;
+  maxCapacity?: number;
+  eventDate?: string;
+  imageUrl?: string;
+  metadata?: Record<string, unknown>;
+}
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Create a new product
+ *
+ * @endpoint POST /api/v1/spots/{spotId}/products
+ */
+export function useCreateProduct(
+  options?: Omit<UseMutationOptions<Product, Error, CreateProductRequest>, 'mutationFn'>
+): UseMutationResult<Product, Error, CreateProductRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateProductRequest): Promise<Product> => {
+      const client = getApiClient();
+      const { spotId, ...productData } = data;
+      const response = await client.post<ApiResponse<Product>>(
+        `/api/v1/spots/${spotId}/products`,
+        productData
+      );
+      return response.data.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: productKeys.bySpot(variables.spotId) });
+      queryClient.invalidateQueries({ queryKey: productKeys.list({ my: true }) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update a product
+ *
+ * @endpoint PUT /api/v1/products/{productId}
+ */
+export function useUpdateProduct(
+  options?: Omit<UseMutationOptions<Product, Error, { productId: string; data: UpdateProductRequest }>, 'mutationFn'>
+): UseMutationResult<Product, Error, { productId: string; data: UpdateProductRequest }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ productId, data }): Promise<Product> => {
+      const client = getApiClient();
+      const response = await client.put<ApiResponse<Product>>(`/api/v1/products/${productId}`, data);
+      return response.data.data;
+    },
+    onSuccess: (data) => {
+      queryClient.setQueryData(productKeys.detail(data.id), data);
+      queryClient.invalidateQueries({ queryKey: productKeys.bySpot(data.spotId) });
+      queryClient.invalidateQueries({ queryKey: productKeys.list({ my: true }) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Delete a product
+ *
+ * @endpoint DELETE /api/v1/products/{productId}
+ */
+export function useDeleteProduct(
+  options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>
+): UseMutationResult<void, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (productId: string): Promise<void> => {
+      const client = getApiClient();
+      await client.delete(`/api/v1/products/${productId}`);
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: productKeys.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Adjust product stock
+ *
+ * @endpoint POST /api/v1/products/{productId}/stock
+ */
+export function useAdjustStock(
+  options?: Omit<
+    UseMutationOptions<Product, Error, { productId: string; quantity: number; reason: 'RESTOCK' | 'ADJUSTMENT'; notes?: string }>,
+    'mutationFn'
+  >
+): UseMutationResult<Product, Error, { productId: string; quantity: number; reason: 'RESTOCK' | 'ADJUSTMENT'; notes?: string }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ productId, quantity, reason, notes }): Promise<Product> => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<Product>>(`/api/v1/products/${productId}/stock`, {
+        quantity,
+        reason,
+        notes,
+      });
+      return response.data.data;
+    },
+    onSuccess: (data) => {
+      queryClient.setQueryData(productKeys.detail(data.id), data);
+      queryClient.invalidateQueries({ queryKey: productKeys.bySpot(data.spotId) });
+    },
+    ...options,
+  });
+}