@growsober/sdk 1.0.0

package/src/api/mutations/support.ts

@@ -0,0 +1,390 @@
+import {
+  useMutation,
+  useQueryClient,
+  UseMutationOptions,
+  UseMutationResult,
+} from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type {
+  DailyCheckInResponse,
+  CreateCheckInRequest,
+  UpdateCheckInRequest,
+  MoodLogResponse,
+  CreateMoodLogRequest,
+  WinResponse,
+  CreateWinRequest,
+  HabitResponse,
+  CreateHabitRequest,
+  UpdateHabitRequest,
+  ReflectionResponse,
+  CreateReflectionRequest,
+} from '../types';
+import { supportKeys } from '../queries/support';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Create a daily check-in
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useCreateCheckIn();
+ *
+ * mutate({
+ *   mood: 8,
+ *   notes: 'Feeling great today!',
+ *   triggers: ['stress'],
+ *   gratitude: ['My support group']
+ * });
+ * ```
+ */
+export function useCreateCheckIn(
+  options?: Omit<
+    UseMutationOptions<DailyCheckInResponse, Error, CreateCheckInRequest>,
+    'mutationFn'
+  >
+): UseMutationResult<DailyCheckInResponse, Error, CreateCheckInRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateCheckInRequest): Promise<DailyCheckInResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/support/check-ins', data);
+      return response.data;
+    },
+    onSuccess: (newCheckIn, variables, context) => {
+      // Invalidate check-ins list and today's check-in
+      queryClient.invalidateQueries({ queryKey: supportKeys.checkIns() });
+      queryClient.invalidateQueries({ queryKey: supportKeys.checkInToday() });
+      queryClient.invalidateQueries({ queryKey: supportKeys.checkInStreak() });
+
+      // Call user's onSuccess if provided
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update a daily check-in
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useUpdateCheckIn();
+ *
+ * mutate({
+ *   id: 'checkin-123',
+ *   data: {
+ *     mood: 4,
+ *     notes: 'Updated notes',
+ *   }
+ * });
+ * ```
+ */
+export function useUpdateCheckIn(
+  options?: Omit<
+    UseMutationOptions<DailyCheckInResponse, Error, { id: string; data: UpdateCheckInRequest }>,
+    'mutationFn'
+  >
+): UseMutationResult<DailyCheckInResponse, Error, { id: string; data: UpdateCheckInRequest }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ id, data }: { id: string; data: UpdateCheckInRequest }): Promise<DailyCheckInResponse> => {
+      const client = getApiClient();
+      const response = await client.put(`/api/v1/support/check-ins/${id}`, data);
+      return response.data;
+    },
+    onSuccess: (updatedCheckIn, variables, context) => {
+      // Invalidate check-ins list and today's check-in
+      queryClient.invalidateQueries({ queryKey: supportKeys.checkIns() });
+      queryClient.invalidateQueries({ queryKey: supportKeys.checkInToday() });
+      queryClient.invalidateQueries({ queryKey: supportKeys.checkInStreak() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Create a mood log
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useCreateMoodLog();
+ *
+ * mutate({
+ *   mood: 7,
+ *   notes: 'Feeling optimistic',
+ *   activities: ['exercise', 'meditation']
+ * });
+ * ```
+ */
+export function useCreateMoodLog(
+  options?: Omit<
+    UseMutationOptions<MoodLogResponse, Error, CreateMoodLogRequest>,
+    'mutationFn'
+  >
+): UseMutationResult<MoodLogResponse, Error, CreateMoodLogRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateMoodLogRequest): Promise<MoodLogResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/support/mood', data);
+      return response.data;
+    },
+    onSuccess: (newMoodLog, variables, context) => {
+      // Invalidate mood logs list
+      queryClient.invalidateQueries({ queryKey: supportKeys.moodLogs() });
+
+      // Call user's onSuccess if provided
+    },
+    ...options,
+  });
+}
+
+/**
+ * Create a win
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useCreateWin();
+ *
+ * mutate({
+ *   title: '30 days sober!',
+ *   description: 'Hit my first milestone',
+ *   category: 'sobriety'
+ * });
+ * ```
+ */
+export function useCreateWin(
+  options?: Omit<
+    UseMutationOptions<WinResponse, Error, CreateWinRequest>,
+    'mutationFn'
+  >
+): UseMutationResult<WinResponse, Error, CreateWinRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateWinRequest): Promise<WinResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/support/wins', data);
+      return response.data;
+    },
+    onSuccess: (newWin, variables, context) => {
+      // Invalidate wins lists
+      queryClient.invalidateQueries({ queryKey: supportKeys.wins() });
+      queryClient.invalidateQueries({ queryKey: supportKeys.winsByCategory() });
+
+      // Call user's onSuccess if provided
+    },
+    ...options,
+  });
+}
+
+/**
+ * Create a habit
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useCreateHabit();
+ *
+ * mutate({
+ *   name: 'Morning meditation',
+ *   description: '10 minutes of mindfulness',
+ *   frequency: 'daily',
+ *   targetDays: 7
+ * });
+ * ```
+ */
+export function useCreateHabit(
+  options?: Omit<
+    UseMutationOptions<HabitResponse, Error, CreateHabitRequest>,
+    'mutationFn'
+  >
+): UseMutationResult<HabitResponse, Error, CreateHabitRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateHabitRequest): Promise<HabitResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/support/habits', data);
+      return response.data;
+    },
+    onSuccess: (newHabit, variables, context) => {
+      // Invalidate habits list
+      queryClient.invalidateQueries({ queryKey: supportKeys.habits() });
+
+      // Call user's onSuccess if provided
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update a habit
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useUpdateHabit();
+ *
+ * mutate({
+ *   id: 'habit-123',
+ *   data: {
+ *     name: 'Evening meditation',
+ *     targetDays: 14
+ *   }
+ * });
+ * ```
+ */
+export function useUpdateHabit(
+  options?: Omit<
+    UseMutationOptions<
+      HabitResponse,
+      Error,
+      { id: string; data: UpdateHabitRequest }
+    >,
+    'mutationFn'
+  >
+): UseMutationResult<HabitResponse, Error, { id: string; data: UpdateHabitRequest }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      id,
+      data,
+    }: {
+      id: string;
+      data: UpdateHabitRequest;
+    }): Promise<HabitResponse> => {
+      const client = getApiClient();
+      const response = await client.put(`/api/v1/support/habits/${id}`, data);
+      return response.data;
+    },
+    onSuccess: (updatedHabit, variables, context) => {
+      // Invalidate habits list
+      queryClient.invalidateQueries({ queryKey: supportKeys.habits() });
+
+      // Call user's onSuccess if provided
+    },
+    ...options,
+  });
+}
+
+/**
+ * Delete a habit
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useDeleteHabit();
+ *
+ * mutate('habit-123');
+ * ```
+ */
+export function useDeleteHabit(
+  options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>
+): UseMutationResult<void, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<void> => {
+      const client = getApiClient();
+      await client.delete(`/api/v1/support/habits/${id}`);
+    },
+    onSuccess: (data, habitId, context) => {
+      // Invalidate habits list
+      queryClient.invalidateQueries({ queryKey: supportKeys.habits() });
+
+      // Call user's onSuccess if provided
+    },
+    ...options,
+  });
+}
+
+/**
+ * Complete a habit for today
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useCompleteHabit();
+ *
+ * mutate('habit-123');
+ * ```
+ */
+export function useCompleteHabit(
+  options?: Omit<UseMutationOptions<HabitResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<HabitResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<HabitResponse> => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/support/habits/${id}/complete`);
+      return response.data;
+    },
+    onSuccess: (completedHabit, habitId, context) => {
+      // Invalidate habits list to show updated completion status
+      queryClient.invalidateQueries({ queryKey: supportKeys.habits() });
+
+      // Call user's onSuccess if provided
+    },
+    ...options,
+  });
+}
+
+/**
+ * Create a reflection
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useCreateReflection();
+ *
+ * mutate({
+ *   content: 'Today I learned...',
+ *   category: 'growth',
+ *   mood: 8
+ * });
+ * ```
+ */
+export function useCreateReflection(
+  options?: Omit<
+    UseMutationOptions<ReflectionResponse, Error, CreateReflectionRequest>,
+    'mutationFn'
+  >
+): UseMutationResult<ReflectionResponse, Error, CreateReflectionRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateReflectionRequest): Promise<ReflectionResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/support/reflections', data);
+      return response.data;
+    },
+    onSuccess: (newReflection, variables, context) => {
+      // Invalidate reflections list
+      queryClient.invalidateQueries({ queryKey: supportKeys.reflections() });
+
+      // Call user's onSuccess if provided
+    },
+    ...options,
+  });
+}

package/src/api/mutations/users.ts

@@ -0,0 +1,271 @@
+/**
+ * Users Mutation Hooks
+ *
+ * TanStack Query mutation hooks for user-related write operations.
+ * These hooks handle user profile updates and onboarding completion.
+ *
+ * @module api/mutations/users
+ */
+
+import { useMutation, UseMutationOptions, UseMutationResult, useQueryClient } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { userKeys } from '../queries/users';
+import type { UpdateUserRequest, UserResponse } from '../types';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Update current user's profile
+ *
+ * @description
+ * Updates the authenticated user's profile information.
+ * This can include name, bio, avatar, location, sober date, and other profile fields.
+ * Automatically invalidates relevant user queries to refresh the UI.
+ *
+ * @endpoint PUT /api/v1/users/me
+ *
+ * @example
+ * ```tsx
+ * import { useUpdateCurrentUser } from '@growsober/sdk';
+ *
+ * function EditProfileForm() {
+ *   const { mutate: updateProfile, isPending, error } = useUpdateCurrentUser({
+ *     onSuccess: (data) => {
+ *       toast.success('Profile updated successfully');
+ *       navigation.goBack();
+ *     },
+ *     onError: (error) => {
+ *       toast.error('Failed to update profile: ' + error.message);
+ *     },
+ *   });
+ *
+ *   const handleSubmit = (formData: FormData) => {
+ *     updateProfile({
+ *       name: formData.name,
+ *       bio: formData.bio,
+ *       avatar: formData.avatar,
+ *       city: formData.city,
+ *       soberDate: formData.soberDate,
+ *     });
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input name="name" />
+ *       <textarea name="bio" />
+ *       <button type="submit" disabled={isPending}>
+ *         {isPending ? 'Saving...' : 'Save Profile'}
+ *       </button>
+ *       {error && <p className="error">{error.message}</p>}
+ *     </form>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * Update specific fields:
+ * ```tsx
+ * function AvatarUploader() {
+ *   const { mutateAsync: updateProfile } = useUpdateCurrentUser();
+ *
+ *   const handleAvatarChange = async (file: File) => {
+ *     const uploadedUrl = await uploadImage(file);
+ *     await updateProfile({ avatar: uploadedUrl });
+ *     toast.success('Avatar updated!');
+ *   };
+ *
+ *   return <ImagePicker onSelect={handleAvatarChange} />;
+ * }
+ * ```
+ *
+ * @example
+ * Update sober date:
+ * ```tsx
+ * function SoberDatePicker() {
+ *   const { mutate: updateProfile } = useUpdateCurrentUser();
+ *   const { data: user } = useCurrentUser();
+ *
+ *   const handleDateChange = (date: Date) => {
+ *     updateProfile({
+ *       soberDate: date.toISOString(),
+ *     });
+ *   };
+ *
+ *   return (
+ *     <DatePicker
+ *       value={user?.soberDate}
+ *       onChange={handleDateChange}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @param options - TanStack Query mutation options
+ * @returns TanStack Query mutation result
+ */
+export function useUpdateCurrentUser(
+  options?: Omit<UseMutationOptions<UserResponse, Error, UpdateUserRequest>, 'mutationFn'>
+): UseMutationResult<UserResponse, Error, UpdateUserRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: UpdateUserRequest): Promise<UserResponse> => {
+      const client = getApiClient();
+      const response = await client.put<UserResponse>('/api/v1/users/me', data);
+      return response.data;
+    },
+    onSuccess: (data, variables, context) => {
+      // Invalidate current user query to trigger refetch with updated data
+      queryClient.invalidateQueries({ queryKey: userKeys.me() });
+
+      // Also invalidate the detail query for this user if they've viewed their own profile
+      if (data.id) {
+        queryClient.invalidateQueries({ queryKey: userKeys.detail(data.id) });
+        queryClient.invalidateQueries({ queryKey: userKeys.public(data.id) });
+      }
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Complete user onboarding
+ *
+ * @description
+ * Marks the user's onboarding process as complete.
+ * This is typically called after a user completes all required onboarding steps
+ * (e.g., setting up profile, selecting interests, setting sober date).
+ * Updates the user's onboardingCompleted flag and unlocks full app access.
+ *
+ * @endpoint POST /api/v1/users/me/complete-onboarding
+ *
+ * @example
+ * ```tsx
+ * import { useCompleteOnboarding } from '@growsober/sdk';
+ *
+ * function OnboardingFinalStep() {
+ *   const { mutate: completeOnboarding, isPending } = useCompleteOnboarding({
+ *     onSuccess: () => {
+ *       toast.success('Welcome to GrowSober!');
+ *       navigation.navigate('Home');
+ *     },
+ *     onError: (error) => {
+ *       toast.error('Failed to complete onboarding: ' + error.message);
+ *     },
+ *   });
+ *
+ *   const handleFinish = () => {
+ *     completeOnboarding();
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <h1>You're All Set!</h1>
+ *       <p>Ready to start your sober journey?</p>
+ *       <button onClick={handleFinish} disabled={isPending}>
+ *         {isPending ? 'Setting up...' : 'Get Started'}
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * Multi-step onboarding with validation:
+ * ```tsx
+ * function OnboardingFlow() {
+ *   const [currentStep, setCurrentStep] = useState(1);
+ *   const { mutateAsync: completeOnboarding } = useCompleteOnboarding();
+ *   const { data: user } = useCurrentUser();
+ *
+ *   const handleComplete = async () => {
+ *     // Validate all required fields are filled
+ *     if (!user?.name || !user?.soberDate || !user?.city) {
+ *       toast.error('Please complete all required fields');
+ *       return;
+ *     }
+ *
+ *     try {
+ *       await completeOnboarding();
+ *       // User will be redirected via onSuccess callback
+ *     } catch (error) {
+ *       console.error('Onboarding error:', error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {currentStep === 1 && <ProfileSetup onNext={() => setCurrentStep(2)} />}
+ *       {currentStep === 2 && <InterestSelection onNext={() => setCurrentStep(3)} />}
+ *       {currentStep === 3 && <SoberDateSetup onNext={handleComplete} />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * Check onboarding status:
+ * ```tsx
+ * function AppNavigator() {
+ *   const { data: user, isLoading } = useCurrentUser();
+ *
+ *   if (isLoading) return <SplashScreen />;
+ *
+ *   // Redirect to onboarding if not completed
+ *   if (user && !user.onboardingCompleted) {
+ *     return <OnboardingFlow />;
+ *   }
+ *
+ *   return <MainApp />;
+ * }
+ * ```
+ *
+ * @example
+ * With analytics tracking:
+ * ```tsx
+ * const { mutate: completeOnboarding } = useCompleteOnboarding({
+ *   onSuccess: (data) => {
+ *     analytics.track('Onboarding Completed', {
+ *       userId: data.id,
+ *       completedAt: new Date().toISOString(),
+ *       profileComplete: !!data.bio && !!data.avatar,
+ *     });
+ *     navigation.navigate('Home');
+ *   },
+ * });
+ * ```
+ *
+ * @param options - TanStack Query mutation options
+ * @returns TanStack Query mutation result
+ */
+export function useCompleteOnboarding(
+  options?: Omit<UseMutationOptions<UserResponse, Error, void>, 'mutationFn'>
+): UseMutationResult<UserResponse, Error, void> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (): Promise<UserResponse> => {
+      const client = getApiClient();
+      const response = await client.post<UserResponse>('/api/v1/users/me/complete-onboarding');
+      return response.data;
+    },
+    onSuccess: (data, variables, context) => {
+      // Invalidate current user query to trigger refetch with updated onboarding status
+      queryClient.invalidateQueries({ queryKey: userKeys.me() });
+
+      // Also invalidate the detail query for this user
+      if (data.id) {
+        queryClient.invalidateQueries({ queryKey: userKeys.detail(data.id) });
+      }
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}