@growsober/sdk 1.0.0

package/src/api/queries/map.ts

@@ -0,0 +1,331 @@
+/**
+ * Map Query Hooks
+ *
+ * TanStack Query hooks for map-related read operations.
+ * These hooks handle fetching map data including users, events, and businesses
+ * for display on the member map feature.
+ *
+ * @module api/queries/map
+ */
+
+import { useQuery, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type {
+  MapUserResponse,
+  MapEventResponse,
+  MapHubResponse,
+  MapBusinessResponse,
+} from '../types';
+
+// ============================================================================
+// QUERY KEYS
+// ============================================================================
+
+/**
+ * Query key factory for map-related queries
+ */
+export const mapKeys = {
+  all: ['map'] as const,
+  members: (params?: MapMembersParams) => [...mapKeys.all, 'members', params] as const,
+  events: (params?: MapEventsParams) => [...mapKeys.all, 'events', params] as const,
+  hubs: (params?: MapHubsParams) => [...mapKeys.all, 'hubs', params] as const,
+  businesses: (params?: MapBusinessesParams) => [...mapKeys.all, 'businesses', params] as const,
+};
+
+// ============================================================================
+// PARAM TYPES
+// ============================================================================
+
+export interface MapMembersParams {
+  lat: number;
+  lng: number;
+  radius?: number; // km
+  hubId?: string;
+  openToMeetOnly?: boolean;
+}
+
+export interface MapEventsParams {
+  lat: number;
+  lng: number;
+  radius?: number; // km
+  hubId?: string;
+  upcoming?: boolean;
+}
+
+export interface MapHubsParams {
+  lat: number;
+  lng: number;
+  radius?: number; // km
+  city?: string;
+}
+
+export interface MapBusinessesParams {
+  lat: number;
+  lng: number;
+  radius?: number; // km
+  type?: string;
+  afDrinksOnly?: boolean;
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get members for map display
+ *
+ * @description
+ * Retrieves users who have opted to be visible on the member map.
+ * Only shows users who have enabled "open to meet" and shared their location.
+ * Premium feature.
+ *
+ * @endpoint GET /api/v1/map/members
+ *
+ * @example
+ * ```tsx
+ * import { useMapMembers } from '@growsober/sdk';
+ *
+ * function MemberMap() {
+ *   const { data: members, isLoading } = useMapMembers({
+ *     lat: 51.5074,
+ *     lng: -0.1278,
+ *     radius: 50, // 50km radius
+ *   });
+ *
+ *   if (isLoading) return <MapLoader />;
+ *
+ *   return (
+ *     <Map>
+ *       {members?.map(member => (
+ *         <Marker
+ *           key={member.id}
+ *           position={[member.locationLat, member.locationLong]}
+ *         >
+ *           <Avatar src={member.avatar} />
+ *         </Marker>
+ *       ))}
+ *     </Map>
+ *   );
+ * }
+ * ```
+ *
+ * @param params - Location and filter parameters
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with array of map users
+ */
+export function useMapMembers(
+  params: MapMembersParams,
+  options?: Omit<UseQueryOptions<MapUserResponse[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<MapUserResponse[]> {
+  return useQuery({
+    queryKey: mapKeys.members(params),
+    queryFn: async (): Promise<MapUserResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get<MapUserResponse[]>('/api/v1/map/members', {
+        params: {
+          lat: params.lat,
+          lng: params.lng,
+          radius: params.radius,
+          hubId: params.hubId,
+          openToMeetOnly: params.openToMeetOnly,
+        },
+      });
+      return response.data;
+    },
+    enabled: params.lat !== undefined && params.lng !== undefined,
+    ...options,
+  });
+}
+
+/**
+ * Get events for map display
+ *
+ * @description
+ * Retrieves events with location data for display on the map.
+ * Shows upcoming events within the specified radius.
+ *
+ * @endpoint GET /api/v1/map/events
+ *
+ * @example
+ * ```tsx
+ * import { useMapEvents } from '@growsober/sdk';
+ *
+ * function EventMap() {
+ *   const { data: events, isLoading } = useMapEvents({
+ *     lat: 51.5074,
+ *     lng: -0.1278,
+ *     radius: 25,
+ *     upcoming: true,
+ *   });
+ *
+ *   return (
+ *     <Map>
+ *       {events?.map(event => (
+ *         <Marker
+ *           key={event.id}
+ *           position={[event.locationLat, event.locationLong]}
+ *           icon="event"
+ *         >
+ *           <EventPopup event={event} />
+ *         </Marker>
+ *       ))}
+ *     </Map>
+ *   );
+ * }
+ * ```
+ *
+ * @param params - Location and filter parameters
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with array of map events
+ */
+export function useMapEvents(
+  params: MapEventsParams,
+  options?: Omit<UseQueryOptions<MapEventResponse[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<MapEventResponse[]> {
+  return useQuery({
+    queryKey: mapKeys.events(params),
+    queryFn: async (): Promise<MapEventResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get<MapEventResponse[]>('/api/v1/map/events', {
+        params: {
+          lat: params.lat,
+          lng: params.lng,
+          radius: params.radius,
+          hubId: params.hubId,
+          upcoming: params.upcoming,
+        },
+      });
+      return response.data;
+    },
+    enabled: params.lat !== undefined && params.lng !== undefined,
+    ...options,
+  });
+}
+
+/**
+ * Get hubs for map display
+ *
+ * @description
+ * Retrieves hubs with location data for display on the map.
+ * Shows active hubs within the specified radius.
+ *
+ * @endpoint GET /api/v1/map/hubs
+ *
+ * @example
+ * ```tsx
+ * import { useMapHubs } from '@growsober/sdk';
+ *
+ * function HubMap() {
+ *   const { data: hubs, isLoading } = useMapHubs({
+ *     lat: 51.5074,
+ *     lng: -0.1278,
+ *     radius: 50,
+ *   });
+ *
+ *   return (
+ *     <Map>
+ *       {hubs?.map(hub => (
+ *         <Marker
+ *           key={hub.id}
+ *           position={[hub.locationLat, hub.locationLong]}
+ *           icon="hub"
+ *         >
+ *           <HubPopup hub={hub} />
+ *         </Marker>
+ *       ))}
+ *     </Map>
+ *   );
+ * }
+ * ```
+ *
+ * @param params - Location and filter parameters
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with array of map hubs
+ */
+export function useMapHubs(
+  params: MapHubsParams,
+  options?: Omit<UseQueryOptions<MapHubResponse[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<MapHubResponse[]> {
+  return useQuery({
+    queryKey: mapKeys.hubs(params),
+    queryFn: async (): Promise<MapHubResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get<MapHubResponse[]>('/api/v1/map/hubs', {
+        params: {
+          lat: params.lat,
+          lng: params.lng,
+          radius: params.radius,
+          city: params.city,
+        },
+      });
+      return response.data;
+    },
+    enabled: params.lat !== undefined && params.lng !== undefined,
+    ...options,
+  });
+}
+
+/**
+ * Get businesses for map display
+ *
+ * @description
+ * Retrieves partner businesses with location data for display on the map.
+ * Can filter by type and whether they serve alcohol-free drinks.
+ *
+ * @endpoint GET /api/v1/map/businesses
+ *
+ * @example
+ * ```tsx
+ * import { useMapBusinesses } from '@growsober/sdk';
+ *
+ * function BusinessMap() {
+ *   const { data: businesses, isLoading } = useMapBusinesses({
+ *     lat: 51.5074,
+ *     lng: -0.1278,
+ *     radius: 10,
+ *     afDrinksOnly: true, // Only show AF-friendly venues
+ *   });
+ *
+ *   return (
+ *     <Map>
+ *       {businesses?.map(business => (
+ *         <Marker
+ *           key={business.id}
+ *           position={[business.locationLat, business.locationLong]}
+ *           icon={business.hasAfDrinks ? 'af-venue' : 'venue'}
+ *         >
+ *           <BusinessPopup business={business} />
+ *         </Marker>
+ *       ))}
+ *     </Map>
+ *   );
+ * }
+ * ```
+ *
+ * @param params - Location and filter parameters
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with array of map businesses
+ */
+export function useMapBusinesses(
+  params: MapBusinessesParams,
+  options?: Omit<UseQueryOptions<MapBusinessResponse[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<MapBusinessResponse[]> {
+  return useQuery({
+    queryKey: mapKeys.businesses(params),
+    queryFn: async (): Promise<MapBusinessResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get<MapBusinessResponse[]>('/api/v1/map/businesses', {
+        params: {
+          lat: params.lat,
+          lng: params.lng,
+          radius: params.radius,
+          type: params.type,
+          afDrinksOnly: params.afDrinksOnly,
+        },
+      });
+      return response.data;
+    },
+    enabled: params.lat !== undefined && params.lng !== undefined,
+    ...options,
+  });
+}

package/src/api/queries/matching.ts

@@ -0,0 +1,238 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const matchingKeys = {
+  all: ['matching'] as const,
+  discover: (filters?: MatchQueryFilters) => [...matchingKeys.all, 'discover', filters] as const,
+  matches: (filters?: MatchQueryFilters) => [...matchingKeys.all, 'matches', filters] as const,
+  match: (id: string) => [...matchingKeys.all, 'match', id] as const,
+  buddies: () => [...matchingKeys.all, 'buddies'] as const,
+  buddyRequests: () => [...matchingKeys.all, 'buddy-requests'] as const,
+  stats: () => [...matchingKeys.all, 'stats'] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface MatchQueryFilters {
+  status?: 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'BLOCKED';
+  limit?: number;
+  offset?: number;
+}
+
+export interface MatchResponse {
+  id: string;
+  userId: string;
+  matchedUserId: string;
+  status: 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'BLOCKED';
+  matchScore?: number;
+  sharedInterests?: string[];
+  createdAt: string;
+  updatedAt: string;
+  matchedUser?: {
+    id: string;
+    name: string;
+    avatarUrl?: string;
+    bio?: string;
+    city?: string;
+  };
+}
+
+export interface DiscoverMatchResponse {
+  id: string;
+  name: string;
+  avatarUrl?: string;
+  bio?: string;
+  city?: string;
+  matchScore: number;
+  sharedInterests: string[];
+  distance?: number;
+}
+
+export interface BuddyResponse {
+  id: string;
+  userId: string;
+  buddyId: string;
+  status: 'PENDING' | 'ACTIVE' | 'ENDED';
+  startDate?: string;
+  endDate?: string;
+  lastActivity?: string;
+  buddy?: {
+    id: string;
+    name: string;
+    avatarUrl?: string;
+  };
+}
+
+export interface MatchingStatsResponse {
+  totalMatches: number;
+  pendingMatches: number;
+  acceptedMatches: number;
+  activeBuddies: number;
+  matchRate: number;
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Discover potential matches based on shared interests and location
+ *
+ * @endpoint GET /api/v1/matching/discover
+ *
+ * @example
+ * ```tsx
+ * const { data: matches, isLoading } = useDiscoverMatches();
+ * ```
+ */
+export function useDiscoverMatches(
+  filters?: MatchQueryFilters,
+  options?: Omit<UseQueryOptions<DiscoverMatchResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: matchingKeys.discover(filters),
+    queryFn: async (): Promise<DiscoverMatchResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/matching/discover', {
+        params: filters,
+      });
+      return response.data?.data || response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get all my matches
+ *
+ * @endpoint GET /api/v1/matching/matches
+ *
+ * @example
+ * ```tsx
+ * const { data: matches, isLoading } = useMyMatches({ status: 'PENDING' });
+ * ```
+ */
+export function useMyMatches(
+  filters?: MatchQueryFilters,
+  options?: Omit<UseQueryOptions<MatchResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: matchingKeys.matches(filters),
+    queryFn: async (): Promise<MatchResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/matching/matches', {
+        params: filters,
+      });
+      return response.data?.data || response.data;
+    },
+    staleTime: 30 * 1000,
+    ...options,
+  });
+}
+
+/**
+ * Get pending matches (convenience hook)
+ *
+ * @example
+ * ```tsx
+ * const { data: pendingMatches } = usePendingMatches();
+ * ```
+ */
+export function usePendingMatches(
+  options?: Omit<UseQueryOptions<MatchResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useMyMatches({ status: 'PENDING' }, options);
+}
+
+/**
+ * Get accepted matches (convenience hook)
+ *
+ * @example
+ * ```tsx
+ * const { data: acceptedMatches } = useAcceptedMatches();
+ * ```
+ */
+export function useAcceptedMatches(
+  options?: Omit<UseQueryOptions<MatchResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useMyMatches({ status: 'ACCEPTED' }, options);
+}
+
+/**
+ * Get my accountability buddies
+ *
+ * @endpoint GET /api/v1/matching/buddies
+ *
+ * @example
+ * ```tsx
+ * const { data: buddies, isLoading } = useMyBuddies();
+ * ```
+ */
+export function useMyBuddies(
+  options?: Omit<UseQueryOptions<BuddyResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: matchingKeys.buddies(),
+    queryFn: async (): Promise<BuddyResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/matching/buddies');
+      return response.data?.data || response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get pending buddy requests
+ *
+ * @endpoint GET /api/v1/matching/buddies/requests
+ *
+ * @example
+ * ```tsx
+ * const { data: requests } = useBuddyRequests();
+ * ```
+ */
+export function useBuddyRequests(
+  options?: Omit<UseQueryOptions<BuddyResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: matchingKeys.buddyRequests(),
+    queryFn: async (): Promise<BuddyResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/matching/buddies/requests');
+      return response.data?.data || response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get matching statistics
+ *
+ * @endpoint GET /api/v1/matching/stats
+ *
+ * @example
+ * ```tsx
+ * const { data: stats } = useMatchingStats();
+ * ```
+ */
+export function useMatchingStats(
+  options?: Omit<UseQueryOptions<MatchingStatsResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: matchingKeys.stats(),
+    queryFn: async (): Promise<MatchingStatsResponse> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/matching/stats');
+      return response.data?.data || response.data;
+    },
+    staleTime: 5 * 60 * 1000,
+    ...options,
+  });
+}

package/src/api/queries/notifications.ts

@@ -0,0 +1,103 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type { NotificationResponse } from '../types';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const notificationKeys = {
+  all: ['notifications'] as const,
+  list: () => [...notificationKeys.all, 'list'] as const,
+  unreadCount: () => [...notificationKeys.all, 'unread-count'] as const,
+  detail: (id: string) => [...notificationKeys.all, id] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface UnreadCount {
+  count: number;
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get user's notifications
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: notifications, isLoading } = useNotifications();
+ * ```
+ */
+export function useNotifications(
+  options?: Omit<UseQueryOptions<NotificationResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: notificationKeys.list(),
+    queryFn: async (): Promise<NotificationResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/notifications');
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get unread notification count
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data } = useUnreadNotificationCount();
+ * console.log(`You have ${data?.count} unread notifications`);
+ * ```
+ */
+export function useUnreadNotificationCount(
+  options?: Omit<UseQueryOptions<UnreadCount>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: notificationKeys.unreadCount(),
+    queryFn: async (): Promise<UnreadCount> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/notifications/unread-count');
+      return response.data;
+    },
+    refetchInterval: 30000, // Refetch every 30 seconds
+    ...options,
+  });
+}
+
+/**
+ * Get a specific notification by ID
+ *
+ * @param id - Notification ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: notification, isLoading } = useNotification('notification-123');
+ * ```
+ */
+export function useNotification(
+  id: string,
+  options?: Omit<UseQueryOptions<NotificationResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: notificationKeys.detail(id),
+    queryFn: async (): Promise<NotificationResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/notifications/${id}`);
+      return response.data;
+    },
+    enabled: !!id,
+    ...options,
+  });
+}