@growsober/sdk 1.0.0 → 1.0.2

package/src/api/mutations/admin.ts

@@ -15,6 +15,7 @@ import {
   useQueryClient,
 } from '@tanstack/react-query';
 import { getApiClient } from '../client';
+import type { AdminUpdateUserRequest, AdminCreateContentRequest } from '../types';
 import { adminKeys } from '../queries/admin';
 import type {
   UserResponse,
@@ -31,27 +32,7 @@ import type {
 // REQUEST TYPES
 // ============================================================================
 
-export interface AdminUpdateUserRequest {
-  displayName?: string;
-  email?: string;
-  role?: string;
-  isPremium?: boolean;
-  isSuspended?: boolean;
-}
 
-export interface AdminCreateContentRequest {
-  title: string;
-  type: string;
-  category: string;
-  description?: string;
-  content?: string;
-  mediaUrl?: string;
-  thumbnailUrl?: string;
-  duration?: number;
-  isPremium?: boolean;
-  isFeatured?: boolean;
-  sortOrder?: number;
-}
 
 export interface AdminUpdateContentRequest extends Partial<AdminCreateContentRequest> {}
 

package/src/api/mutations/auth.ts

@@ -17,6 +17,9 @@ import type {
   FirebaseAuthRequest,
   AuthResponse,
   TokenResponse,
+  SendOtpRequest,
+  OtpSentResponse,
+  VerifyOtpRequest,
 } from '../types';
 
 // ============================================================================
@@ -348,3 +351,114 @@ export function useFirebaseAuth(
     ...options,
   });
 }
+
+/**
+ * Response type for verify OTP including isNewUser flag
+ */
+export type VerifyOtpResponse = AuthResponse & { isNewUser: boolean };
+
+/**
+ * Send OTP to phone number
+ *
+ * @description
+ * Sends a verification code to the specified phone number via SMS or voice call.
+ * Used for passwordless authentication.
+ *
+ * @endpoint POST /auth/phone/send-otp
+ *
+ * @example
+ * ```tsx
+ * import { useSendOtp } from '@growsober/sdk';
+ *
+ * function PhoneInputScreen() {
+ *   const { mutate: sendOtp, isPending, error } = useSendOtp({
+ *     onSuccess: (data) => {
+ *       console.log('OTP sent to:', data.phone);
+ *       navigation.navigate('VerifyOtp', { phone });
+ *     },
+ *     onError: (error) => {
+ *       Alert.alert('Error', error.message);
+ *     },
+ *   });
+ *
+ *   const handleSend = () => {
+ *     sendOtp({ phone: '+1234567890', channel: 'sms' });
+ *   };
+ *
+ *   return <Button onPress={handleSend} disabled={isPending} />;
+ * }
+ * ```
+ *
+ * @param options - TanStack Query mutation options
+ * @returns TanStack Query mutation result
+ */
+export function useSendOtp(
+  options?: Omit<UseMutationOptions<OtpSentResponse, Error, SendOtpRequest>, 'mutationFn'>
+): UseMutationResult<OtpSentResponse, Error, SendOtpRequest> {
+  return useMutation({
+    mutationFn: async (data: SendOtpRequest): Promise<OtpSentResponse> => {
+      const client = getApiClient();
+      const response = await client.post<OtpSentResponse>('/auth/phone/send-otp', data);
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Verify OTP and authenticate
+ *
+ * @description
+ * Verifies the OTP code sent to the phone number and authenticates the user.
+ * If the user doesn't exist, a new account is created automatically.
+ * Returns authentication tokens and user information.
+ *
+ * @endpoint POST /auth/phone/verify-otp
+ *
+ * @example
+ * ```tsx
+ * import { useVerifyOtp } from '@growsober/sdk';
+ *
+ * function VerifyOtpScreen({ phone }) {
+ *   const { mutate: verifyOtp, isPending, error } = useVerifyOtp({
+ *     onSuccess: async (data) => {
+ *       await SecureStore.setItemAsync('accessToken', data.accessToken);
+ *       await SecureStore.setItemAsync('refreshToken', data.refreshToken);
+ *
+ *       if (data.isNewUser) {
+ *         navigation.navigate('Onboarding');
+ *       } else {
+ *         navigation.navigate('Home');
+ *       }
+ *     },
+ *   });
+ *
+ *   const handleVerify = (code: string) => {
+ *     verifyOtp({ phone, code });
+ *   };
+ *
+ *   return <OtpInput onComplete={handleVerify} disabled={isPending} />;
+ * }
+ * ```
+ *
+ * @param options - TanStack Query mutation options
+ * @returns TanStack Query mutation result
+ */
+export function useVerifyOtp(
+  options?: Omit<UseMutationOptions<VerifyOtpResponse, Error, VerifyOtpRequest>, 'mutationFn'>
+): UseMutationResult<VerifyOtpResponse, Error, VerifyOtpRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: VerifyOtpRequest): Promise<VerifyOtpResponse> => {
+      const client = getApiClient();
+      const response = await client.post<VerifyOtpResponse>('/auth/phone/verify-otp', data);
+      return response.data;
+    },
+    onSuccess: (data, variables, context) => {
+      // Invalidate current user query to trigger refetch with new token
+      queryClient.invalidateQueries({ queryKey: userKeys.me() });
+    },
+    ...options,
+  });
+}

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

@@ -3,10 +3,10 @@ import { getApiClient } from '../client';
 import { eventChatKeys } from '../queries/event-chat';
 import type {
   ChatMemberResponse,
-  MessageResponse,
+  ChatMessageResponse,
   EventChatResponse,
-  SendMessageRequest,
-  UpdateMessageRequest,
+  SendChatMessageRequest,
+  UpdateChatMessageRequest,
   UpdateChatSettingsRequest,
   UpdateMemberSettingsRequest,
 } from '../types';
@@ -123,9 +123,9 @@ export function useSendEventChatMessage(eventId: string) {
   const queryClient = useQueryClient();
 
   return useMutation({
-    mutationFn: async (data: SendMessageRequest) => {
+    mutationFn: async (data: SendChatMessageRequest) => {
       const client = getApiClient();
-      const response = await client.post<MessageResponse>(
+      const response = await client.post<ChatMessageResponse>(
         `/events/${eventId}/chat/messages`,
         data
       );
@@ -145,9 +145,9 @@ export function useUpdateEventChatMessage(eventId: string) {
   const queryClient = useQueryClient();
 
   return useMutation({
-    mutationFn: async ({ messageId, content }: { messageId: string } & UpdateMessageRequest) => {
+    mutationFn: async ({ messageId, content }: { messageId: string } & UpdateChatMessageRequest) => {
       const client = getApiClient();
-      const response = await client.put<MessageResponse>(
+      const response = await client.put<ChatMessageResponse>(
         `/events/${eventId}/chat/messages/${messageId}`,
         { content }
       );

package/src/api/mutations/matching.ts

@@ -6,33 +6,13 @@ import {
 } from '@tanstack/react-query';
 import { getApiClient } from '../client';
 import { matchingKeys, MatchResponse, BuddyResponse } from '../queries/matching';
-
-// ============================================================================
-// REQUEST TYPES
-// ============================================================================
-
-export interface CreateMatchRequest {
-  matchedUserId: string;
-  message?: string;
-}
-
-export interface UpdateMatchRequest {
-  status: 'ACCEPTED' | 'DECLINED' | 'BLOCKED';
-}
-
-export interface CreateBuddyRequest {
-  buddyId: string;
-  message?: string;
-}
-
-export interface UpdateBuddyRequest {
-  status: 'ACCEPTED' | 'DECLINED' | 'ENDED';
-}
-
-export interface LogBuddyActivityRequest {
-  type: 'CHECK_IN' | 'MESSAGE' | 'SUPPORT';
-  note?: string;
-}
+import type {
+  CreateMatchRequest,
+  UpdateMatchRequest,
+  CreateBuddyRequest,
+  UpdateBuddyRequest,
+  LogBuddyActivityRequest,
+} from '../types';
 
 // ============================================================================
 // MUTATION HOOKS
@@ -118,9 +98,9 @@ export function useAcceptMatch(
   return {
     ...updateMatch,
     mutate: (matchId: string, mutateOptions?: any) =>
-      updateMatch.mutate({ matchId, data: { status: 'ACCEPTED' } }, mutateOptions),
+      updateMatch.mutate({ matchId, data: { action: 'ACCEPT' } }, mutateOptions),
     mutateAsync: (matchId: string) =>
-      updateMatch.mutateAsync({ matchId, data: { status: 'ACCEPTED' } }),
+      updateMatch.mutateAsync({ matchId, data: { action: 'ACCEPT' } }),
   } as UseMutationResult<MatchResponse, Error, string>;
 }
 
@@ -141,9 +121,9 @@ export function useDeclineMatch(
   return {
     ...updateMatch,
     mutate: (matchId: string, mutateOptions?: any) =>
-      updateMatch.mutate({ matchId, data: { status: 'DECLINED' } }, mutateOptions),
+      updateMatch.mutate({ matchId, data: { action: 'DECLINE' } }, mutateOptions),
     mutateAsync: (matchId: string) =>
-      updateMatch.mutateAsync({ matchId, data: { status: 'DECLINED' } }),
+      updateMatch.mutateAsync({ matchId, data: { action: 'DECLINE' } }),
   } as UseMutationResult<MatchResponse, Error, string>;
 }
 
@@ -214,7 +194,7 @@ export function useRequestBuddy(
  * @example
  * ```tsx
  * const updateBuddy = useUpdateBuddy();
- * await updateBuddy.mutateAsync({ buddyId: 'buddy-123', data: { status: 'ACCEPTED' } });
+ * await updateBuddy.mutateAsync({ buddyId: 'buddy-123', data: { action: 'ACCEPT' } });
  * ```
  */
 export function useUpdateBuddy(

package/src/api/mutations/support.ts

@@ -6,11 +6,11 @@ import {
 } from '@tanstack/react-query';
 import { getApiClient } from '../client';
 import type {
-  DailyCheckInResponse,
+  CheckInResponse,
   CreateCheckInRequest,
   UpdateCheckInRequest,
   MoodLogResponse,
-  CreateMoodLogRequest,
+  LogMoodRequest,
   WinResponse,
   CreateWinRequest,
   HabitResponse,
@@ -44,14 +44,14 @@ import { supportKeys } from '../queries/support';
  */
 export function useCreateCheckIn(
   options?: Omit<
-    UseMutationOptions<DailyCheckInResponse, Error, CreateCheckInRequest>,
+    UseMutationOptions<CheckInResponse, Error, CreateCheckInRequest>,
     'mutationFn'
   >
-): UseMutationResult<DailyCheckInResponse, Error, CreateCheckInRequest> {
+): UseMutationResult<CheckInResponse, Error, CreateCheckInRequest> {
   const queryClient = useQueryClient();
 
   return useMutation({
-    mutationFn: async (data: CreateCheckInRequest): Promise<DailyCheckInResponse> => {
+    mutationFn: async (data: CreateCheckInRequest): Promise<CheckInResponse> => {
       const client = getApiClient();
       const response = await client.post('/api/v1/support/check-ins', data);
       return response.data;
@@ -88,14 +88,14 @@ export function useCreateCheckIn(
  */
 export function useUpdateCheckIn(
   options?: Omit<
-    UseMutationOptions<DailyCheckInResponse, Error, { id: string; data: UpdateCheckInRequest }>,
+    UseMutationOptions<CheckInResponse, Error, { id: string; data: UpdateCheckInRequest }>,
     'mutationFn'
   >
-): UseMutationResult<DailyCheckInResponse, Error, { id: string; data: UpdateCheckInRequest }> {
+): UseMutationResult<CheckInResponse, Error, { id: string; data: UpdateCheckInRequest }> {
   const queryClient = useQueryClient();
 
   return useMutation({
-    mutationFn: async ({ id, data }: { id: string; data: UpdateCheckInRequest }): Promise<DailyCheckInResponse> => {
+    mutationFn: async ({ id, data }: { id: string; data: UpdateCheckInRequest }): Promise<CheckInResponse> => {
       const client = getApiClient();
       const response = await client.put(`/api/v1/support/check-ins/${id}`, data);
       return response.data;
@@ -128,14 +128,14 @@ export function useUpdateCheckIn(
  */
 export function useCreateMoodLog(
   options?: Omit<
-    UseMutationOptions<MoodLogResponse, Error, CreateMoodLogRequest>,
+    UseMutationOptions<MoodLogResponse, Error, LogMoodRequest>,
     'mutationFn'
   >
-): UseMutationResult<MoodLogResponse, Error, CreateMoodLogRequest> {
+): UseMutationResult<MoodLogResponse, Error, LogMoodRequest> {
   const queryClient = useQueryClient();
 
   return useMutation({
-    mutationFn: async (data: CreateMoodLogRequest): Promise<MoodLogResponse> => {
+    mutationFn: async (data: LogMoodRequest): Promise<MoodLogResponse> => {
       const client = getApiClient();
       const response = await client.post('/api/v1/support/mood', data);
       return response.data;

package/src/api/queries/ambassadors.ts

@@ -1,6 +1,6 @@
 import { useQuery, UseQueryOptions } from '@tanstack/react-query';
 import { getApiClient } from '../client';
-import type { AmbassadorResponse, AmbassadorLeaderboardResponse, AmbassadorStatus } from '../types';
+import type { AmbassadorResponse } from '../types';
 
 // ============================================================================
 // QUERY KEYS
@@ -21,6 +21,9 @@ export const ambassadorKeys = {
 // TYPES
 // ============================================================================
 
+// Extract status type from AmbassadorResponse
+type AmbassadorStatus = AmbassadorResponse['status'];
+
 export interface AmbassadorListFilters {
   page?: number;
   limit?: number;
@@ -108,11 +111,11 @@ export function useMyAmbassador(
  */
 export function useAmbassadorLeaderboard(
   filters?: LeaderboardFilters,
-  options?: Omit<UseQueryOptions<AmbassadorLeaderboardResponse[]>, 'queryKey' | 'queryFn'>
+  options?: Omit<UseQueryOptions<AmbassadorResponse[]>, 'queryKey' | 'queryFn'>
 ) {
   return useQuery({
     queryKey: ambassadorKeys.leaderboard(filters),
-    queryFn: async (): Promise<AmbassadorLeaderboardResponse[]> => {
+    queryFn: async (): Promise<AmbassadorResponse[]> => {
       const client = getApiClient();
       const response = await client.get('/api/v1/ambassadors/leaderboard', { params: filters });
       return response.data;

package/src/api/queries/cities.ts

@@ -0,0 +1,194 @@
+/**
+ * Cities Query Hooks
+ *
+ * TanStack Query hooks for fetching city data.
+ * Cities are used for location-based features and user onboarding.
+ *
+ * @module api/queries/cities
+ */
+
+import { useQuery, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const cityKeys = {
+  all: ['cities'] as const,
+  lists: () => [...cityKeys.all, 'list'] as const,
+  list: (filters?: CityFilters) => [...cityKeys.lists(), filters] as const,
+  details: () => [...cityKeys.all, 'detail'] as const,
+  detail: (id: string) => [...cityKeys.details(), id] as const,
+  featured: () => [...cityKeys.all, 'featured'] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface CityResponse {
+  id: string;
+  name: string;
+  country: string;
+  countryCode: string | null;
+  timezone: string | null;
+  latitude: number | null;
+  longitude: number | null;
+  memberCount: number;
+  isFeatured: boolean;
+  region: string | null;
+}
+
+export interface CityFilters {
+  search?: string;
+  countryCode?: string;
+  isFeatured?: boolean;
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get list of cities with optional filters
+ *
+ * @description
+ * Fetches available cities for location selection.
+ * Can be filtered by name search, country code, or featured status.
+ * Results are ordered by featured status, member count, and name.
+ *
+ * @endpoint GET /api/v1/cities
+ *
+ * @example
+ * ```tsx
+ * import { useCities } from '@growsober/sdk';
+ *
+ * function CityPicker() {
+ *   const { data: cities, isLoading } = useCities();
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   return (
+ *     <select>
+ *       {cities?.map(city => (
+ *         <option key={city.id} value={city.id}>
+ *           {city.name}, {city.country}
+ *         </option>
+ *       ))}
+ *     </select>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * With search filter:
+ * ```tsx
+ * const { data: cities } = useCities({ search: 'London' });
+ * ```
+ *
+ * @example
+ * Filter by country:
+ * ```tsx
+ * const { data: ukCities } = useCities({ countryCode: 'GB' });
+ * ```
+ *
+ * @param filters - Optional filters for city search
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with array of cities
+ */
+interface CitiesApiResponse {
+  data: CityResponse[];
+  meta: {
+    timestamp: string;
+  };
+}
+
+export function useCities(
+  filters?: CityFilters,
+  options?: Omit<UseQueryOptions<CityResponse[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<CityResponse[]> {
+  return useQuery({
+    queryKey: cityKeys.list(filters),
+    queryFn: async (): Promise<CityResponse[]> => {
+      const client = getApiClient();
+      const params = new URLSearchParams();
+
+      if (filters?.search) params.append('search', filters.search);
+      if (filters?.countryCode) params.append('countryCode', filters.countryCode);
+      if (filters?.isFeatured !== undefined) params.append('isFeatured', String(filters.isFeatured));
+
+      const queryString = params.toString();
+      const url = `/api/v1/cities${queryString ? `?${queryString}` : ''}`;
+
+      const response = await client.get<CitiesApiResponse>(url);
+      // Handle both wrapped and unwrapped response formats
+      return Array.isArray(response.data) ? response.data : response.data.data;
+    },
+    staleTime: 5 * 60 * 1000, // Cities don't change often, cache for 5 minutes
+    ...options,
+  });
+}
+
+/**
+ * Get featured cities
+ *
+ * @description
+ * Fetches only cities marked as featured.
+ * Useful for showing popular/recommended cities.
+ *
+ * @example
+ * ```tsx
+ * const { data: featuredCities } = useFeaturedCities();
+ * ```
+ *
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with array of featured cities
+ */
+export function useFeaturedCities(
+  options?: Omit<UseQueryOptions<CityResponse[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<CityResponse[]> {
+  return useCities({ isFeatured: true }, options);
+}
+
+/**
+ * Get a single city by ID
+ *
+ * @description
+ * Fetches details for a specific city.
+ *
+ * @endpoint GET /api/v1/cities/{id}
+ *
+ * @example
+ * ```tsx
+ * const { data: city } = useCity('city-uuid');
+ * ```
+ *
+ * @param id - City ID
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with city data
+ */
+interface CityApiResponse {
+  data: CityResponse;
+  meta: {
+    timestamp: string;
+  };
+}
+
+export function useCity(
+  id: string,
+  options?: Omit<UseQueryOptions<CityResponse>, 'queryKey' | 'queryFn'>
+): UseQueryResult<CityResponse> {
+  return useQuery({
+    queryKey: cityKeys.detail(id),
+    queryFn: async (): Promise<CityResponse> => {
+      const client = getApiClient();
+      const response = await client.get<CityApiResponse>(`/api/v1/cities/${id}`);
+      // Handle both wrapped and unwrapped response formats
+      return (response.data as any).data || response.data;
+    },
+    enabled: !!id,
+    staleTime: 5 * 60 * 1000,
+    ...options,
+  });
+}

package/src/api/queries/hubs.ts

@@ -1,6 +1,6 @@
 import { useQuery, UseQueryOptions } from '@tanstack/react-query';
 import { getApiClient } from '../client';
-import type { HubResponse, HubMemberResponse } from '../types';
+import type { HubResponse, ChatMemberResponse } from '../types';
 
 // ============================================================================
 // QUERY KEYS
@@ -49,10 +49,10 @@ export interface PaginatedHubsResponse {
   };
 }
 
-// HubMemberResponse is imported from '../types'
+// ChatMemberResponse is imported from '../types'
 
 export interface PaginatedMembersResponse {
-  data: HubMemberResponse[];
+  data: ChatMemberResponse[];
   meta: {
     total: number;
     page: number;

package/src/api/queries/index.ts

@@ -8,6 +8,7 @@ export * from './admin';
 export * from './auth';
 export * from './bookings';
 export * from './businesses';
+export * from './cities';
 export * from './events';
 export * from './hubs';
 export * from './library';

package/src/api/queries/map.ts

@@ -11,10 +11,10 @@
 import { useQuery, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
 import { getApiClient } from '../client';
 import type {
-  MapUserResponse,
+  MapMemberResponse,
   MapEventResponse,
   MapHubResponse,
-  MapBusinessResponse,
+  BusinessResponse,
 } from '../types';
 
 // ============================================================================
@@ -115,13 +115,13 @@ export interface MapBusinessesParams {
  */
 export function useMapMembers(
   params: MapMembersParams,
-  options?: Omit<UseQueryOptions<MapUserResponse[]>, 'queryKey' | 'queryFn'>
-): UseQueryResult<MapUserResponse[]> {
+  options?: Omit<UseQueryOptions<MapMemberResponse[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<MapMemberResponse[]> {
   return useQuery({
     queryKey: mapKeys.members(params),
-    queryFn: async (): Promise<MapUserResponse[]> => {
+    queryFn: async (): Promise<MapMemberResponse[]> => {
       const client = getApiClient();
-      const response = await client.get<MapUserResponse[]>('/api/v1/map/members', {
+      const response = await client.get<MapMemberResponse[]>('/api/v1/map/members', {
         params: {
           lat: params.lat,
           lng: params.lng,
@@ -308,13 +308,13 @@ export function useMapHubs(
  */
 export function useMapBusinesses(
   params: MapBusinessesParams,
-  options?: Omit<UseQueryOptions<MapBusinessResponse[]>, 'queryKey' | 'queryFn'>
-): UseQueryResult<MapBusinessResponse[]> {
+  options?: Omit<UseQueryOptions<BusinessResponse[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<BusinessResponse[]> {
   return useQuery({
     queryKey: mapKeys.businesses(params),
-    queryFn: async (): Promise<MapBusinessResponse[]> => {
+    queryFn: async (): Promise<BusinessResponse[]> => {
       const client = getApiClient();
-      const response = await client.get<MapBusinessResponse[]>('/api/v1/map/businesses', {
+      const response = await client.get<BusinessResponse[]>('/api/v1/map/businesses', {
         params: {
           lat: params.lat,
           lng: params.lng,