@growsober/sdk 1.0.0

package/src/api/queries/bookings.ts

@@ -0,0 +1,135 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type { BookingResponse } from '../types';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const bookingKeys = {
+  all: ['bookings'] as const,
+  lists: () => [...bookingKeys.all, 'list'] as const,
+  list: (filters?: BookingFilters) => [...bookingKeys.lists(), filters] as const,
+  details: () => [...bookingKeys.all, 'detail'] as const,
+  detail: (id: string) => [...bookingKeys.details(), id] as const,
+  mine: (filters?: BookingFilters) => [...bookingKeys.all, 'mine', filters] as const,
+  qrCode: (id: string) => [...bookingKeys.detail(id), 'qr'] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface BookingFilters {
+  page?: number;
+  limit?: number;
+  status?: 'CONFIRMED' | 'WAITLISTED' | 'CANCELLED';
+  eventId?: string;
+}
+
+export interface PaginatedBookingsResponse {
+  bookings: BookingResponse[];
+  total: number;
+  page: number;
+  limit: number;
+  totalPages: number;
+}
+
+export interface QrCodeResponse {
+  qrCode: string;
+  bookingId: string;
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get a single booking by ID
+ *
+ * @param id - Booking ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBooking('booking-123');
+ * ```
+ */
+export function useBooking(
+  id: string,
+  options?: Omit<UseQueryOptions<BookingResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: bookingKeys.detail(id),
+    queryFn: async (): Promise<BookingResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/bookings/${id}`);
+      return response.data;
+    },
+    enabled: !!id,
+    ...options,
+  });
+}
+
+/**
+ * Get current user's bookings with optional filters
+ *
+ * @param filters - Query parameters for filtering and pagination
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useMyBookings({
+ *   page: 1,
+ *   limit: 20,
+ *   status: 'CONFIRMED',
+ *   eventId: 'event-123'
+ * });
+ * ```
+ */
+export function useMyBookings(
+  filters?: BookingFilters,
+  options?: Omit<UseQueryOptions<PaginatedBookingsResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: bookingKeys.mine(filters),
+    queryFn: async (): Promise<PaginatedBookingsResponse> => {
+      const client = getApiClient();
+      // Use /users/me/bookings - the existing API endpoint
+      const response = await client.get('/api/v1/users/me/bookings', {
+        params: filters,
+      });
+      // API returns { data: { bookings: [...] }, meta: {...} }
+      return response.data.data || response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get QR code for a specific booking
+ *
+ * @param id - Booking ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBookingQrCode('booking-123');
+ * // data.qrCode contains the QR code string for display
+ * ```
+ */
+export function useBookingQrCode(
+  id: string,
+  options?: Omit<UseQueryOptions<QrCodeResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: bookingKeys.qrCode(id),
+    queryFn: async (): Promise<QrCodeResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/bookings/${id}/qr`);
+      return response.data;
+    },
+    enabled: !!id,
+    ...options,
+  });
+}

package/src/api/queries/businesses.ts

@@ -0,0 +1,203 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type { BusinessResponse, OfferResponse } from '../types';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const businessKeys = {
+  all: ['businesses'] as const,
+  lists: () => [...businessKeys.all, 'list'] as const,
+  list: (filters?: BusinessFilters) => [...businessKeys.lists(), filters] as const,
+  details: () => [...businessKeys.all, 'detail'] as const,
+  detail: (id: string) => [...businessKeys.details(), id] as const,
+  featured: () => [...businessKeys.all, 'featured'] as const,
+  nearby: (params?: NearbyBusinessParams) => [...businessKeys.all, 'nearby', params] as const,
+  offers: (businessId: string) => [...businessKeys.detail(businessId), 'offers'] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface BusinessFilters {
+  page?: number;
+  limit?: number;
+  search?: string;
+  cityId?: string;
+  type?: string;
+  hasAfDrinks?: boolean;
+  isAfVenue?: boolean;
+  isFeatured?: boolean;
+  isPartner?: boolean;
+  lat?: number;
+  long?: number;
+  radius?: number;
+  sortBy?: string;
+  sortOrder?: 'asc' | 'desc';
+}
+
+export interface NearbyBusinessParams {
+  lat: number;
+  long: number;
+  radius?: number;
+}
+
+export interface PaginatedBusinessesResponse {
+  businesses: BusinessResponse[];
+  total: number;
+  page: number;
+  limit: number;
+  totalPages: number;
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get paginated list of businesses with optional filters
+ *
+ * @param filters - Query parameters for filtering and pagination
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBusinesses({
+ *   page: 1,
+ *   limit: 20,
+ *   cityId: 'city-123',
+ *   hasAfDrinks: true,
+ *   sortBy: 'name',
+ *   sortOrder: 'asc'
+ * });
+ * ```
+ */
+export function useBusinesses(
+  filters?: BusinessFilters,
+  options?: Omit<UseQueryOptions<PaginatedBusinessesResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: businessKeys.list(filters),
+    queryFn: async (): Promise<PaginatedBusinessesResponse> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/businesses', {
+        params: filters,
+      });
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get featured businesses
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useFeaturedBusinesses();
+ * ```
+ */
+export function useFeaturedBusinesses(
+  options?: Omit<UseQueryOptions<BusinessResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: businessKeys.featured(),
+    queryFn: async (): Promise<BusinessResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/businesses/featured');
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get nearby businesses based on location
+ *
+ * @param params - Location parameters (latitude, longitude, radius)
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useNearbyBusinesses({
+ *   lat: 51.5074,
+ *   long: -0.1278,
+ *   radius: 5000 // 5km radius
+ * });
+ * ```
+ */
+export function useNearbyBusinesses(
+  params: NearbyBusinessParams,
+  options?: Omit<UseQueryOptions<BusinessResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: businessKeys.nearby(params),
+    queryFn: async (): Promise<BusinessResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/businesses/nearby', {
+        params,
+      });
+      return response.data;
+    },
+    enabled: !!params.lat && !!params.long,
+    ...options,
+  });
+}
+
+/**
+ * Get a single business by ID
+ *
+ * @param id - Business ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBusiness('business-123');
+ * ```
+ */
+export function useBusiness(
+  id: string,
+  options?: Omit<UseQueryOptions<BusinessResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: businessKeys.detail(id),
+    queryFn: async (): Promise<BusinessResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/businesses/${id}`);
+      return response.data;
+    },
+    enabled: !!id,
+    ...options,
+  });
+}
+
+/**
+ * Get all offers for a specific business
+ *
+ * @param businessId - Business ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBusinessOffers('business-123');
+ * ```
+ */
+export function useBusinessOffers(
+  businessId: string,
+  options?: Omit<UseQueryOptions<OfferResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: businessKeys.offers(businessId),
+    queryFn: async (): Promise<OfferResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/businesses/${businessId}/offers`);
+      return response.data;
+    },
+    enabled: !!businessId,
+    ...options,
+  });
+}

package/src/api/queries/event-chat.ts

@@ -0,0 +1,78 @@
+import { useQuery, useInfiniteQuery } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type {
+  EventChatResponse,
+  ChatMemberResponse,
+  PaginatedMessagesResponse,
+} from '../types';
+
+// ============================================================================
+// QUERY KEYS
+// ============================================================================
+
+export const eventChatKeys = {
+  all: ['event-chat'] as const,
+  chat: (eventId: string) => [...eventChatKeys.all, 'chat', eventId] as const,
+  members: (eventId: string) => [...eventChatKeys.all, 'members', eventId] as const,
+  messages: (eventId: string) => [...eventChatKeys.all, 'messages', eventId] as const,
+};
+
+// ============================================================================
+// HOOKS
+// ============================================================================
+
+/**
+ * Get or create chat for an event
+ */
+export function useEventChat(eventId: string | undefined) {
+  return useQuery({
+    queryKey: eventChatKeys.chat(eventId || ''),
+    queryFn: async () => {
+      if (!eventId) throw new Error('Event ID is required');
+      const client = getApiClient();
+      const response = await client.get<EventChatResponse>(`/events/${eventId}/chat`);
+      return response.data;
+    },
+    enabled: !!eventId,
+  });
+}
+
+/**
+ * Get chat members
+ */
+export function useEventChatMembers(eventId: string | undefined) {
+  return useQuery({
+    queryKey: eventChatKeys.members(eventId || ''),
+    queryFn: async () => {
+      if (!eventId) throw new Error('Event ID is required');
+      const client = getApiClient();
+      const response = await client.get<ChatMemberResponse[]>(`/events/${eventId}/chat/members`);
+      return response.data;
+    },
+    enabled: !!eventId,
+  });
+}
+
+/**
+ * Get chat messages with infinite scroll pagination
+ */
+export function useEventChatMessages(eventId: string | undefined, limit = 50) {
+  return useInfiniteQuery({
+    queryKey: eventChatKeys.messages(eventId || ''),
+    queryFn: async ({ pageParam }) => {
+      if (!eventId) throw new Error('Event ID is required');
+      const client = getApiClient();
+      const params = new URLSearchParams({ limit: String(limit) });
+      if (pageParam) {
+        params.append('cursor', pageParam);
+      }
+      const response = await client.get<PaginatedMessagesResponse>(
+        `/events/${eventId}/chat/messages?${params.toString()}`
+      );
+      return response.data;
+    },
+    initialPageParam: undefined as string | undefined,
+    getNextPageParam: (lastPage) => lastPage.nextCursor,
+    enabled: !!eventId,
+  });
+}

package/src/api/queries/events.ts

@@ -0,0 +1,272 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type { EventResponse } from '../types';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const eventKeys = {
+  all: ['events'] as const,
+  lists: () => [...eventKeys.all, 'list'] as const,
+  list: (filters?: EventFilters) => [...eventKeys.lists(), filters] as const,
+  details: () => [...eventKeys.all, 'detail'] as const,
+  detail: (id: string) => [...eventKeys.details(), id] as const,
+  detailBySlug: (slug: string) => [...eventKeys.details(), 'slug', slug] as const,
+  upcoming: (limit?: number) => [...eventKeys.all, 'upcoming', limit] as const,
+  featured: (limit?: number) => [...eventKeys.all, 'featured', limit] as const,
+  ambient: (filters?: AmbientEventFilters) => [...eventKeys.all, 'ambient', filters] as const,
+  bookings: (eventId: string) => [...eventKeys.detail(eventId), 'bookings'] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface EventFilters {
+  page?: number;
+  limit?: number;
+  hubId?: string;
+  cityId?: string;
+  eventType?: string;
+  status?: 'DRAFT' | 'PUBLISHED' | 'CANCELLED';
+  startAfter?: string;
+  startBefore?: string;
+  isFeatured?: boolean;
+  isAmbient?: boolean;
+}
+
+export interface AmbientEventFilters {
+  limit?: number;
+  cityId?: string;
+}
+
+export interface PaginatedEventsResponse {
+  events: EventResponse[];
+  total: number;
+  page: number;
+  limit: number;
+  totalPages: number;
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get paginated list of events with optional filters
+ *
+ * @param filters - Query parameters for filtering and pagination
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useEvents({
+ *   page: 1,
+ *   limit: 20,
+ *   hubId: 'hub-123',
+ *   isFeatured: true
+ * });
+ * ```
+ */
+export function useEvents(
+  filters?: EventFilters,
+  options?: Omit<UseQueryOptions<PaginatedEventsResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: eventKeys.list(filters),
+    queryFn: async (): Promise<PaginatedEventsResponse> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/events', {
+        params: filters,
+      });
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get a single event by ID
+ *
+ * @param id - Event ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useEvent('event-123');
+ * ```
+ */
+export function useEvent(
+  id: string,
+  options?: Omit<UseQueryOptions<EventResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: eventKeys.detail(id),
+    queryFn: async (): Promise<EventResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/events/${id}`);
+      return response.data;
+    },
+    enabled: !!id,
+    ...options,
+  });
+}
+
+/**
+ * Get a single event by slug
+ *
+ * @param slug - Event slug
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useEventBySlug('yoga-in-the-park');
+ * ```
+ */
+export function useEventBySlug(
+  slug: string,
+  options?: Omit<UseQueryOptions<EventResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: eventKeys.detailBySlug(slug),
+    queryFn: async (): Promise<EventResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/events/slug/${slug}`);
+      return response.data;
+    },
+    enabled: !!slug,
+    ...options,
+  });
+}
+
+/**
+ * Get upcoming events
+ *
+ * @param limit - Maximum number of events to return (default: 10)
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useUpcomingEvents(20);
+ * ```
+ */
+export function useUpcomingEvents(
+  limit?: number,
+  options?: Omit<UseQueryOptions<EventResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: eventKeys.upcoming(limit),
+    queryFn: async (): Promise<EventResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/events/upcoming', {
+        params: { limit },
+      });
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get featured events
+ *
+ * Note: This uses the main events endpoint with isFeatured filter
+ *
+ * @param limit - Maximum number of events to return (default: 10)
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useFeaturedEvents(5);
+ * ```
+ */
+export function useFeaturedEvents(
+  limit: number = 10,
+  options?: Omit<UseQueryOptions<EventResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: eventKeys.featured(limit),
+    queryFn: async (): Promise<EventResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/events', {
+        params: {
+          isFeatured: true,
+          limit,
+          page: 1,
+        },
+      });
+      return response.data.events || response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get ambient events (auto-generated social activities)
+ *
+ * @param filters - Optional filters (limit, cityId)
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useAmbientEvents({ limit: 10 });
+ * ```
+ */
+export function useAmbientEvents(
+  filters?: AmbientEventFilters,
+  options?: Omit<UseQueryOptions<EventResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: eventKeys.ambient(filters),
+    queryFn: async (): Promise<EventResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/events', {
+        params: {
+          isAmbient: true,
+          limit: filters?.limit || 20,
+          cityId: filters?.cityId,
+          startFrom: new Date().toISOString(),
+          sortBy: 'startDate',
+          sortOrder: 'asc',
+        },
+      });
+      // API returns { data: { events: [...], meta: {...} }, meta: {...} }
+      return response.data.data?.events || response.data.events || response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get bookings for a specific event
+ *
+ * Note: This endpoint may not be available in the current API.
+ * Consider using admin endpoints or user bookings endpoints instead.
+ * This hook is provided for future compatibility.
+ *
+ * @param eventId - Event ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useEventBookings('event-123');
+ * ```
+ */
+export function useEventBookings(
+  eventId: string,
+  options?: Omit<UseQueryOptions<any[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: eventKeys.bookings(eventId),
+    queryFn: async (): Promise<any[]> => {
+      const client = getApiClient();
+      // Note: This endpoint may not exist in the current API
+      // Adjust the path based on your actual API implementation
+      const response = await client.get(`/api/v1/events/${eventId}/bookings`);
+      return response.data;
+    },
+    enabled: !!eventId,
+    ...options,
+  });
+}