@growsober/sdk 1.0.22 → 1.0.24

package/src/api/mutations/products.ts

@@ -1,40 +1,14 @@
 import { useMutation, useQueryClient } from '@tanstack/react-query';
 import { getApiClient } from '../client';
-import { productKeys, CreatorProductResponse, ProductBookingResponse, ProductType, DeliveryMethod } from '../queries/products';
+import { productKeys, CreatorProductResponse, ProductBookingResponse, CreateProductDto, UpdateProductDto } from '../queries/products';
 import { creatorKeys } from '../queries/creators';
 
 // ============================================================================
-// TYPES
+// TYPES — request types derived from auto-generated OpenAPI DTOs
 // ============================================================================
 
-export interface CreateProductRequest {
-  title: string;
-  description?: string;
-  imageUrl?: string;
-  type?: ProductType;
-  price: number;
-  currency?: string;
-  durationMinutes?: number;
-  maxParticipants?: number;
-  deliveryMethod?: DeliveryMethod;
-  locationDetails?: string;
-  slug?: string;
-}
-
-export interface UpdateProductRequest {
-  title?: string;
-  description?: string;
-  imageUrl?: string;
-  type?: ProductType;
-  price?: number;
-  currency?: string;
-  durationMinutes?: number;
-  maxParticipants?: number;
-  deliveryMethod?: DeliveryMethod;
-  locationDetails?: string;
-  isActive?: boolean;
-  isFeatured?: boolean;
-}
+export type CreateProductRequest = CreateProductDto;
+export type UpdateProductRequest = UpdateProductDto;
 
 export interface BookProductRequest {
   scheduledAt: string;
@@ -57,25 +31,6 @@ export interface CancelBookingRequest {
 // MUTATION HOOKS - PRODUCTS
 // ============================================================================
 
-/**
- * Create a new product for a creator
- *
- * @example
- * ```tsx
- * const { mutate: createProduct, isLoading } = useCreateProduct();
- *
- * createProduct({
- *   creatorId: 'creator-123',
- *   data: {
- *     title: '1-on-1 Coaching Session',
- *     description: 'Personal coaching session',
- *     type: 'SESSION_1ON1',
- *     price: 5000,
- *     durationMinutes: 60,
- *   },
- * });
- * ```
- */
 export function useCreateProduct() {
   const queryClient = useQueryClient();
 
@@ -98,23 +53,6 @@ export function useCreateProduct() {
   });
 }
 
-/**
- * Update an existing product
- *
- * @example
- * ```tsx
- * const { mutate: updateProduct, isLoading } = useUpdateProduct();
- *
- * updateProduct({
- *   creatorId: 'creator-123',
- *   productId: 'product-456',
- *   data: {
- *     price: 6000,
- *     isActive: true,
- *   },
- * });
- * ```
- */
 export function useUpdateProduct() {
   const queryClient = useQueryClient();
 
@@ -143,19 +81,6 @@ export function useUpdateProduct() {
   });
 }
 
-/**
- * Delete a product
- *
- * @example
- * ```tsx
- * const { mutate: deleteProduct, isLoading } = useDeleteProduct();
- *
- * deleteProduct({
- *   creatorId: 'creator-123',
- *   productId: 'product-456',
- * });
- * ```
- */
 export function useDeleteProduct() {
   const queryClient = useQueryClient();
 
@@ -182,23 +107,6 @@ export function useDeleteProduct() {
 // MUTATION HOOKS - BOOKINGS
 // ============================================================================
 
-/**
- * Book a product/session
- *
- * @example
- * ```tsx
- * const { mutate: bookProduct, isLoading } = useBookProduct();
- *
- * bookProduct({
- *   productId: 'product-123',
- *   data: {
- *     scheduledAt: '2024-03-15T10:00:00Z',
- *     timezone: 'Europe/London',
- *     clientNotes: 'Looking forward to the session!',
- *   },
- * });
- * ```
- */
 export function useBookProduct() {
   const queryClient = useQueryClient();
 
@@ -220,22 +128,6 @@ export function useBookProduct() {
   });
 }
 
-/**
- * Update a product booking
- *
- * @example
- * ```tsx
- * const { mutate: updateBooking, isLoading } = useUpdateProductBooking();
- *
- * updateBooking({
- *   bookingId: 'booking-123',
- *   data: {
- *     scheduledAt: '2024-03-16T14:00:00Z',
- *     clientNotes: 'Rescheduled due to conflict',
- *   },
- * });
- * ```
- */
 export function useUpdateProductBooking() {
   const queryClient = useQueryClient();
 
@@ -257,25 +149,11 @@ export function useUpdateProductBooking() {
     onSuccess: (_, { bookingId }) => {
       queryClient.invalidateQueries({ queryKey: productKeys.bookingDetail(bookingId) });
       queryClient.invalidateQueries({ queryKey: productKeys.myBookings() });
-      // Also invalidate creator bookings as they see this
       queryClient.invalidateQueries({ queryKey: productKeys.bookings() });
     },
   });
 }
 
-/**
- * Cancel a product booking
- *
- * @example
- * ```tsx
- * const { mutate: cancelBooking, isLoading } = useCancelProductBooking();
- *
- * cancelBooking({
- *   bookingId: 'booking-123',
- *   data: { reason: 'Schedule conflict' },
- * });
- * ```
- */
 export function useCancelProductBooking() {
   const queryClient = useQueryClient();
 
@@ -302,16 +180,6 @@ export function useCancelProductBooking() {
   });
 }
 
-/**
- * Mark a booking as completed (creator only)
- *
- * @example
- * ```tsx
- * const { mutate: completeBooking, isLoading } = useCompleteProductBooking();
- *
- * completeBooking({ bookingId: 'booking-123' });
- * ```
- */
 export function useCompleteProductBooking() {
   const queryClient = useQueryClient();
 
@@ -344,23 +212,6 @@ export interface PaymentIntentResponse {
   paymentIntentId: string;
 }
 
-/**
- * Create a payment intent for a product booking
- * Use this with Stripe Elements to process payment
- *
- * @example
- * ```tsx
- * const { mutate: createPaymentIntent, data, isLoading } = useCreateProductPaymentIntent();
- *
- * // Create payment intent
- * createPaymentIntent({ bookingId: 'booking-123' });
- *
- * // Use clientSecret with Stripe Elements
- * if (data?.clientSecret) {
- *   // Pass to Stripe PaymentElement
- * }
- * ```
- */
 export function useCreateProductPaymentIntent() {
   return useMutation({
     mutationFn: async ({

package/src/api/queries/creators.ts

@@ -23,6 +23,8 @@ export const creatorKeys = {
   byUser: (userId: string) => [...creatorKeys.all, 'user', userId] as const,
   me: () => [...creatorKeys.all, 'me'] as const,
   availability: (creatorId: string) => [...creatorKeys.detail(creatorId), 'availability'] as const,
+  availableDates: (creatorId: string, from: string, to: string) => [...creatorKeys.detail(creatorId), 'available-dates', from, to] as const,
+  availableSlots: (creatorId: string, date: string, durationMinutes: number) => [...creatorKeys.detail(creatorId), 'available-slots', date, durationMinutes] as const,
   content: (creatorId: string) => [...creatorKeys.detail(creatorId), 'content'] as const,
   allContent: (creatorId: string) => [...creatorKeys.detail(creatorId), 'content', 'all'] as const,
   events: (creatorId: string) => [...creatorKeys.detail(creatorId), 'events'] as const,
@@ -229,6 +231,74 @@ export function useCreatorAvailability(
   });
 }
 
+// ============================================================================
+// AVAILABILITY-AWARE SCHEDULING
+// ============================================================================
+
+export interface AvailableDateEntry {
+  date: string;
+  hasAvailability: boolean;
+}
+
+export interface AvailableDatesResponse {
+  dates: AvailableDateEntry[];
+}
+
+export interface AvailableSlotEntry {
+  startTime: string;
+  endTime: string;
+  available: boolean;
+}
+
+export interface AvailableSlotsResponse {
+  date: string;
+  slots: AvailableSlotEntry[];
+}
+
+/**
+ * Get dates with availability for a creator in a date range
+ */
+export function useCreatorAvailableDates(
+  creatorId: string,
+  params: { from: string; to: string },
+  options?: Omit<UseQueryOptions<AvailableDatesResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: creatorKeys.availableDates(creatorId, params.from, params.to),
+    queryFn: async (): Promise<AvailableDatesResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/creators/${creatorId}/available-dates`, {
+        params,
+      });
+      return response.data;
+    },
+    enabled: !!creatorId && !!params.from && !!params.to,
+    ...options,
+  });
+}
+
+/**
+ * Get available time slots for a creator on a specific date
+ */
+export function useCreatorAvailableSlots(
+  creatorId: string,
+  params: { date: string; durationMinutes?: number },
+  options?: Omit<UseQueryOptions<AvailableSlotsResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: creatorKeys.availableSlots(creatorId, params.date, params.durationMinutes || 60),
+    queryFn: async (): Promise<AvailableSlotsResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/creators/${creatorId}/available-slots`, {
+        params,
+      });
+      return response.data;
+    },
+    enabled: !!creatorId && !!params.date,
+    ...options,
+  });
+}
+
 /**
  * Get a creator's published library content
  *

package/src/api/queries/products.ts

@@ -1,12 +1,16 @@
 import { useQuery, UseQueryOptions } from '@tanstack/react-query';
 import { getApiClient } from '../client';
+import type { components } from '@growsober/types';
 
 // ============================================================================
-// TYPES
+// TYPES — derived from auto-generated OpenAPI types
 // ============================================================================
 
-export type ProductType = 'SESSION_1ON1' | 'SESSION_GROUP' | 'PACKAGE' | 'WORKSHOP' | 'CONSULTATION';
-export type DeliveryMethod = 'VIDEO_CALL' | 'PHONE_CALL' | 'IN_PERSON' | 'HYBRID';
+export type CreateProductDto = components['schemas']['CreateProductDto'];
+export type UpdateProductDto = components['schemas']['UpdateProductDto'];
+
+export type ProductType = CreateProductDto['type'];
+export type DeliveryMethod = CreateProductDto['deliveryMethod'];
 export type BookingStatus = 'PENDING' | 'CONFIRMED' | 'CANCELLED' | 'COMPLETED';
 export type PaymentStatus = 'PENDING' | 'PAID' | 'REFUNDED' | 'FAILED';
 
@@ -17,6 +21,8 @@ export interface CreatorProductResponse {
   slug: string;
   description: string | null;
   imageUrl: string | null;
+  category: string | null;
+  tags: string[];
   type: ProductType;
   price: number;
   currency: string;
@@ -26,6 +32,8 @@ export interface CreatorProductResponse {
   locationDetails: string | null;
   isActive: boolean;
   isFeatured: boolean;
+  stripeProductId?: string | null;
+  stripePriceId?: string | null;
   createdAt: string;
   updatedAt: string;
   creator?: {
@@ -112,21 +120,6 @@ export const productKeys = {
 // QUERY HOOKS
 // ============================================================================
 
-/**
- * Get paginated list of all active products
- *
- * @param filters - Query parameters for filtering and pagination
- * @param options - TanStack Query options
- *
- * @example
- * ```tsx
- * const { data, isLoading } = useProducts({
- *   page: 1,
- *   limit: 20,
- *   type: 'SESSION_1ON1',
- * });
- * ```
- */
 export function useProducts(
   filters?: ProductFilters,
   options?: Omit<UseQueryOptions<PaginatedProductsResponse>, 'queryKey' | 'queryFn'>
@@ -144,17 +137,6 @@ export function useProducts(
   });
 }
 
-/**
- * Get a single product by ID
- *
- * @param id - Product ID
- * @param options - TanStack Query options
- *
- * @example
- * ```tsx
- * const { data, isLoading } = useProduct('product-123');
- * ```
- */
 export function useProduct(
   id: string,
   options?: Omit<UseQueryOptions<CreatorProductResponse>, 'queryKey' | 'queryFn'>
@@ -171,17 +153,6 @@ export function useProduct(
   });
 }
 
-/**
- * Get a product by its slug
- *
- * @param slug - Product slug
- * @param options - TanStack Query options
- *
- * @example
- * ```tsx
- * const { data, isLoading } = useProductBySlug('1-on-1-coaching-abc123');
- * ```
- */
 export function useProductBySlug(
   slug: string,
   options?: Omit<UseQueryOptions<CreatorProductResponse>, 'queryKey' | 'queryFn'>
@@ -198,21 +169,6 @@ export function useProductBySlug(
   });
 }
 
-/**
- * Get products for a specific creator
- *
- * @param creatorId - Creator ID
- * @param filters - Query parameters for filtering
- * @param options - TanStack Query options
- *
- * @example
- * ```tsx
- * const { data, isLoading } = useCreatorProducts('creator-123', {
- *   type: 'SESSION_1ON1',
- *   isActive: true,
- * });
- * ```
- */
 export function useCreatorProducts(
   creatorId: string,
   filters?: ProductFilters,
@@ -232,16 +188,6 @@ export function useCreatorProducts(
   });
 }
 
-/**
- * Get current user's product bookings
- *
- * @param options - TanStack Query options
- *
- * @example
- * ```tsx
- * const { data, isLoading } = useMyProductBookings();
- * ```
- */
 export function useMyProductBookings(
   options?: Omit<UseQueryOptions<ProductBookingResponse[]>, 'queryKey' | 'queryFn'>
 ) {
@@ -256,17 +202,6 @@ export function useMyProductBookings(
   });
 }
 
-/**
- * Get a single product booking by ID
- *
- * @param bookingId - Booking ID
- * @param options - TanStack Query options
- *
- * @example
- * ```tsx
- * const { data, isLoading } = useProductBooking('booking-123');
- * ```
- */
 export function useProductBooking(
   bookingId: string,
   options?: Omit<UseQueryOptions<ProductBookingResponse>, 'queryKey' | 'queryFn'>
@@ -283,18 +218,6 @@ export function useProductBooking(
   });
 }
 
-/**
- * Get bookings for a creator's products (creator dashboard)
- *
- * @param creatorId - Creator ID
- * @param options - TanStack Query options
- *
- * @example
- * ```tsx
- * // For creator dashboard - see all bookings for their products
- * const { data, isLoading } = useCreatorBookings('creator-123');
- * ```
- */
 export function useCreatorBookings(
   creatorId: string,
   options?: Omit<UseQueryOptions<ProductBookingResponse[]>, 'queryKey' | 'queryFn'>