@growsober/sdk 1.0.0

package/src/api/mutations/library.ts

@@ -0,0 +1,212 @@
+import {
+  useMutation,
+  useQueryClient,
+  UseMutationOptions,
+  UseMutationResult,
+} from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type { LibraryProgressResponse } from '../types';
+import { libraryKeys } from '../queries/library';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Mark a library item as viewed
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useMarkViewed();
+ *
+ * mutate('lib-123');
+ * ```
+ */
+export function useMarkViewed(
+  options?: Omit<
+    UseMutationOptions<LibraryProgressResponse, Error, string>,
+    'mutationFn'
+  >
+): UseMutationResult<LibraryProgressResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<LibraryProgressResponse> => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/library/${id}/view`);
+      return response.data;
+    },
+    onSuccess: (data, id, context) => {
+      // Invalidate the specific item to reflect updated view status
+      queryClient.invalidateQueries({ queryKey: libraryKeys.detail(id) });
+
+      // Invalidate lists to update view counts
+      queryClient.invalidateQueries({ queryKey: libraryKeys.lists() });
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Mark a library item as completed
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useMarkCompleted();
+ *
+ * mutate('lib-123');
+ * ```
+ */
+export function useMarkCompleted(
+  options?: Omit<
+    UseMutationOptions<LibraryProgressResponse, Error, string>,
+    'mutationFn'
+  >
+): UseMutationResult<LibraryProgressResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<LibraryProgressResponse> => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/library/${id}/complete`);
+      return response.data;
+    },
+    onSuccess: (data, id, context) => {
+      // Invalidate the specific item to reflect completion status
+      queryClient.invalidateQueries({ queryKey: libraryKeys.detail(id) });
+
+      // Invalidate lists
+      queryClient.invalidateQueries({ queryKey: libraryKeys.lists() });
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Toggle like status for a library item
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useToggleLike();
+ *
+ * mutate('lib-123');
+ * ```
+ */
+export function useToggleLike(
+  options?: Omit<
+    UseMutationOptions<LibraryProgressResponse, Error, string>,
+    'mutationFn'
+  >
+): UseMutationResult<LibraryProgressResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<LibraryProgressResponse> => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/library/${id}/like`);
+      return response.data;
+    },
+    onSuccess: (data, id, context) => {
+      // Invalidate the specific item to reflect like status
+      queryClient.invalidateQueries({ queryKey: libraryKeys.detail(id) });
+
+      // Invalidate lists to update like counts
+      queryClient.invalidateQueries({ queryKey: libraryKeys.lists() });
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Add a bookmark to a library item
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useAddBookmark();
+ *
+ * mutate('lib-123');
+ * ```
+ */
+export function useAddBookmark(
+  options?: Omit<
+    UseMutationOptions<LibraryProgressResponse, Error, string>,
+    'mutationFn'
+  >
+): UseMutationResult<LibraryProgressResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<LibraryProgressResponse> => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/library/${id}/bookmark`);
+      return response.data;
+    },
+    onSuccess: (data, id, context) => {
+      // Invalidate the specific item to reflect bookmark status
+      queryClient.invalidateQueries({ queryKey: libraryKeys.detail(id) });
+
+      // Invalidate lists
+      queryClient.invalidateQueries({ queryKey: libraryKeys.lists() });
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Remove a bookmark from a library item
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useRemoveBookmark();
+ *
+ * mutate('lib-123');
+ * ```
+ */
+export function useRemoveBookmark(
+  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/library/${id}/bookmark`);
+    },
+    onSuccess: (data, id, context) => {
+      // Invalidate the specific item to reflect bookmark removal
+      queryClient.invalidateQueries({ queryKey: libraryKeys.detail(id) });
+
+      // Invalidate lists
+      queryClient.invalidateQueries({ queryKey: libraryKeys.lists() });
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}

package/src/api/mutations/map.ts

@@ -0,0 +1,230 @@
+/**
+ * Map Mutation Hooks
+ *
+ * TanStack Query mutation hooks for map-related write operations.
+ * These hooks handle updating user location and visibility settings.
+ *
+ * @module api/mutations/map
+ */
+
+import {
+  useMutation,
+  UseMutationOptions,
+  UseMutationResult,
+  useQueryClient,
+} from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { mapKeys } from '../queries/map';
+import { userKeys } from '../queries/users';
+
+// ============================================================================
+// REQUEST TYPES
+// ============================================================================
+
+export interface UpdateLocationRequest {
+  lat: number;
+  lng: number;
+}
+
+export interface UpdateOpenToMeetRequest {
+  openToMeet: boolean;
+}
+
+// ============================================================================
+// RESPONSE TYPES
+// ============================================================================
+
+export interface LocationUpdateResponse {
+  success: boolean;
+  message: string;
+}
+
+export interface OpenToMeetResponse {
+  openToMeet: boolean;
+  message: string;
+}
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Update current user's location
+ *
+ * @description
+ * Updates the authenticated user's location for display on the member map.
+ * Location is only visible to other users if the user has enabled "open to meet".
+ *
+ * @endpoint PUT /api/v1/map/location
+ *
+ * @example
+ * ```tsx
+ * import { useUpdateLocation } from '@growsober/sdk';
+ *
+ * function LocationUpdater() {
+ *   const updateLocation = useUpdateLocation();
+ *
+ *   const handleLocationUpdate = async () => {
+ *     // Get current position from device
+ *     navigator.geolocation.getCurrentPosition(
+ *       async (position) => {
+ *         await updateLocation.mutateAsync({
+ *           lat: position.coords.latitude,
+ *           lng: position.coords.longitude,
+ *         });
+ *       },
+ *       (error) => console.error('Location error:', error)
+ *     );
+ *   };
+ *
+ *   return (
+ *     <button onClick={handleLocationUpdate} disabled={updateLocation.isPending}>
+ *       Update My Location
+ *     </button>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * With Expo Location:
+ * ```tsx
+ * import * as Location from 'expo-location';
+ * import { useUpdateLocation } from '@growsober/sdk';
+ *
+ * function App() {
+ *   const updateLocation = useUpdateLocation();
+ *
+ *   useEffect(() => {
+ *     (async () => {
+ *       const { status } = await Location.requestForegroundPermissionsAsync();
+ *       if (status === 'granted') {
+ *         const location = await Location.getCurrentPositionAsync({});
+ *         updateLocation.mutate({
+ *           lat: location.coords.latitude,
+ *           lng: location.coords.longitude,
+ *         });
+ *       }
+ *     })();
+ *   }, []);
+ * }
+ * ```
+ *
+ * @param options - TanStack Query mutation options
+ * @returns TanStack Query mutation result
+ */
+export function useUpdateLocation(
+  options?: Omit<
+    UseMutationOptions<LocationUpdateResponse, Error, UpdateLocationRequest>,
+    'mutationFn'
+  >
+): UseMutationResult<LocationUpdateResponse, Error, UpdateLocationRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: UpdateLocationRequest): Promise<LocationUpdateResponse> => {
+      const client = getApiClient();
+      const response = await client.put<LocationUpdateResponse>(
+        '/api/v1/map/location',
+        data
+      );
+      return response.data;
+    },
+    onSuccess: () => {
+      // Invalidate map queries to reflect new location
+      queryClient.invalidateQueries({ queryKey: mapKeys.members() });
+      // Also invalidate user data as location is stored on user
+      queryClient.invalidateQueries({ queryKey: userKeys.me() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Toggle "open to meet" status
+ *
+ * @description
+ * Updates the user's "open to meet" visibility setting.
+ * When enabled, the user's location will be visible to other premium members on the map.
+ * Premium feature.
+ *
+ * @endpoint PUT /api/v1/map/open-to-meet
+ *
+ * @example
+ * ```tsx
+ * import { useUpdateOpenToMeet } from '@growsober/sdk';
+ *
+ * function OpenToMeetToggle() {
+ *   const updateOpenToMeet = useUpdateOpenToMeet();
+ *   const [isOpen, setIsOpen] = useState(false);
+ *
+ *   const handleToggle = async () => {
+ *     const newValue = !isOpen;
+ *     await updateOpenToMeet.mutateAsync({ openToMeet: newValue });
+ *     setIsOpen(newValue);
+ *   };
+ *
+ *   return (
+ *     <Switch
+ *       checked={isOpen}
+ *       onChange={handleToggle}
+ *       disabled={updateOpenToMeet.isPending}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * With user state:
+ * ```tsx
+ * import { useCurrentUser, useUpdateOpenToMeet } from '@growsober/sdk';
+ *
+ * function OpenToMeetSetting() {
+ *   const { data: user } = useCurrentUser();
+ *   const updateOpenToMeet = useUpdateOpenToMeet({
+ *     onSuccess: (data) => {
+ *       console.log(data.openToMeet ? 'Now visible on map!' : 'Hidden from map');
+ *     },
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       <label>Open to Meet</label>
+ *       <Switch
+ *         checked={user?.openToMeet}
+ *         onChange={(checked) => updateOpenToMeet.mutate({ openToMeet: checked })}
+ *       />
+ *       <p>Show your location to other members</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @param options - TanStack Query mutation options
+ * @returns TanStack Query mutation result
+ */
+export function useUpdateOpenToMeet(
+  options?: Omit<
+    UseMutationOptions<OpenToMeetResponse, Error, UpdateOpenToMeetRequest>,
+    'mutationFn'
+  >
+): UseMutationResult<OpenToMeetResponse, Error, UpdateOpenToMeetRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: UpdateOpenToMeetRequest): Promise<OpenToMeetResponse> => {
+      const client = getApiClient();
+      const response = await client.put<OpenToMeetResponse>(
+        '/api/v1/map/open-to-meet',
+        data
+      );
+      return response.data;
+    },
+    onSuccess: () => {
+      // Invalidate user data to reflect new setting
+      queryClient.invalidateQueries({ queryKey: userKeys.me() });
+      // Invalidate map queries as visibility has changed
+      queryClient.invalidateQueries({ queryKey: mapKeys.members() });
+    },
+    ...options,
+  });
+}

package/src/api/mutations/matching.ts

@@ -0,0 +1,271 @@
+import {
+  useMutation,
+  useQueryClient,
+  UseMutationOptions,
+  UseMutationResult,
+} 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;
+}
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Create a new match request
+ *
+ * @endpoint POST /api/v1/matching/matches
+ *
+ * @example
+ * ```tsx
+ * const createMatch = useCreateMatch();
+ * await createMatch.mutateAsync({ matchedUserId: 'user-123' });
+ * ```
+ */
+export function useCreateMatch(
+  options?: Omit<UseMutationOptions<MatchResponse, Error, CreateMatchRequest>, 'mutationFn'>
+): UseMutationResult<MatchResponse, Error, CreateMatchRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateMatchRequest): Promise<MatchResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/matching/matches', data);
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: matchingKeys.matches() });
+      queryClient.invalidateQueries({ queryKey: matchingKeys.stats() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update match status (accept/decline/block)
+ *
+ * @endpoint PUT /api/v1/matching/matches/:matchId
+ *
+ * @example
+ * ```tsx
+ * const updateMatch = useUpdateMatch();
+ * await updateMatch.mutateAsync({ matchId: 'match-123', status: 'ACCEPTED' });
+ * ```
+ */
+export function useUpdateMatch(
+  options?: Omit<
+    UseMutationOptions<MatchResponse, Error, { matchId: string; data: UpdateMatchRequest }>,
+    'mutationFn'
+  >
+): UseMutationResult<MatchResponse, Error, { matchId: string; data: UpdateMatchRequest }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ matchId, data }): Promise<MatchResponse> => {
+      const client = getApiClient();
+      const response = await client.put(`/api/v1/matching/matches/${matchId}`, data);
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: matchingKeys.matches() });
+      queryClient.invalidateQueries({ queryKey: matchingKeys.stats() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Accept a match (convenience hook)
+ *
+ * @example
+ * ```tsx
+ * const acceptMatch = useAcceptMatch();
+ * await acceptMatch.mutateAsync('match-123');
+ * ```
+ */
+export function useAcceptMatch(
+  options?: Omit<UseMutationOptions<MatchResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<MatchResponse, Error, string> {
+  const updateMatch = useUpdateMatch();
+
+  return {
+    ...updateMatch,
+    mutate: (matchId: string, mutateOptions?: any) =>
+      updateMatch.mutate({ matchId, data: { status: 'ACCEPTED' } }, mutateOptions),
+    mutateAsync: (matchId: string) =>
+      updateMatch.mutateAsync({ matchId, data: { status: 'ACCEPTED' } }),
+  } as UseMutationResult<MatchResponse, Error, string>;
+}
+
+/**
+ * Decline a match (convenience hook)
+ *
+ * @example
+ * ```tsx
+ * const declineMatch = useDeclineMatch();
+ * await declineMatch.mutateAsync('match-123');
+ * ```
+ */
+export function useDeclineMatch(
+  options?: Omit<UseMutationOptions<MatchResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<MatchResponse, Error, string> {
+  const updateMatch = useUpdateMatch();
+
+  return {
+    ...updateMatch,
+    mutate: (matchId: string, mutateOptions?: any) =>
+      updateMatch.mutate({ matchId, data: { status: 'DECLINED' } }, mutateOptions),
+    mutateAsync: (matchId: string) =>
+      updateMatch.mutateAsync({ matchId, data: { status: 'DECLINED' } }),
+  } as UseMutationResult<MatchResponse, Error, string>;
+}
+
+/**
+ * Delete a match
+ *
+ * @endpoint DELETE /api/v1/matching/matches/:matchId
+ *
+ * @example
+ * ```tsx
+ * const deleteMatch = useDeleteMatch();
+ * await deleteMatch.mutateAsync('match-123');
+ * ```
+ */
+export function useDeleteMatch(
+  options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>
+): UseMutationResult<void, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (matchId: string): Promise<void> => {
+      const client = getApiClient();
+      await client.delete(`/api/v1/matching/matches/${matchId}`);
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: matchingKeys.matches() });
+      queryClient.invalidateQueries({ queryKey: matchingKeys.stats() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Request someone as accountability buddy
+ *
+ * @endpoint POST /api/v1/matching/buddies
+ *
+ * @example
+ * ```tsx
+ * const requestBuddy = useRequestBuddy();
+ * await requestBuddy.mutateAsync({ buddyId: 'user-123' });
+ * ```
+ */
+export function useRequestBuddy(
+  options?: Omit<UseMutationOptions<BuddyResponse, Error, CreateBuddyRequest>, 'mutationFn'>
+): UseMutationResult<BuddyResponse, Error, CreateBuddyRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateBuddyRequest): Promise<BuddyResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/matching/buddies', data);
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: matchingKeys.buddies() });
+      queryClient.invalidateQueries({ queryKey: matchingKeys.buddyRequests() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update buddy request (accept/decline/end)
+ *
+ * @endpoint PUT /api/v1/matching/buddies/:buddyId
+ *
+ * @example
+ * ```tsx
+ * const updateBuddy = useUpdateBuddy();
+ * await updateBuddy.mutateAsync({ buddyId: 'buddy-123', data: { status: 'ACCEPTED' } });
+ * ```
+ */
+export function useUpdateBuddy(
+  options?: Omit<
+    UseMutationOptions<BuddyResponse, Error, { buddyId: string; data: UpdateBuddyRequest }>,
+    'mutationFn'
+  >
+): UseMutationResult<BuddyResponse, Error, { buddyId: string; data: UpdateBuddyRequest }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ buddyId, data }): Promise<BuddyResponse> => {
+      const client = getApiClient();
+      const response = await client.put(`/api/v1/matching/buddies/${buddyId}`, data);
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: matchingKeys.buddies() });
+      queryClient.invalidateQueries({ queryKey: matchingKeys.buddyRequests() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Log activity with buddy (check-in, message)
+ *
+ * @endpoint POST /api/v1/matching/buddies/:buddyId/activity
+ *
+ * @example
+ * ```tsx
+ * const logActivity = useLogBuddyActivity();
+ * await logActivity.mutateAsync({ buddyId: 'buddy-123', data: { type: 'CHECK_IN' } });
+ * ```
+ */
+export function useLogBuddyActivity(
+  options?: Omit<
+    UseMutationOptions<void, Error, { buddyId: string; data: LogBuddyActivityRequest }>,
+    'mutationFn'
+  >
+): UseMutationResult<void, Error, { buddyId: string; data: LogBuddyActivityRequest }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ buddyId, data }): Promise<void> => {
+      const client = getApiClient();
+      await client.post(`/api/v1/matching/buddies/${buddyId}/activity`, data);
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: matchingKeys.buddies() });
+    },
+    ...options,
+  });
+}