@growsober/sdk 1.0.0

package/src/api/mutations/grow90.ts

@@ -0,0 +1,169 @@
+import {
+  useMutation,
+  useQueryClient,
+  UseMutationOptions,
+  UseMutationResult,
+} from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type {
+  Grow90EnrollmentResponse,
+  Grow90ProgressResponse,
+  EnrollGrow90Request,
+  UpdateGrow90ProgressRequest,
+  UpdateGrow90SettingsRequest,
+} from '../types';
+import { grow90Keys } from '../queries/grow90';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Enroll in GROW90 program
+ */
+export function useEnrollGrow90(
+  options?: Omit<
+    UseMutationOptions<Grow90EnrollmentResponse, Error, EnrollGrow90Request>,
+    'mutationFn'
+  >
+): UseMutationResult<Grow90EnrollmentResponse, Error, EnrollGrow90Request> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: EnrollGrow90Request): Promise<Grow90EnrollmentResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/grow90/enroll', data);
+      // API returns { data: {...}, meta: {...} }, extract the data
+      const enrollment = 'data' in response.data ? response.data.data : response.data;
+      return enrollment;
+    },
+    onSuccess: (enrollment) => {
+      queryClient.setQueryData(grow90Keys.enrollment(), enrollment);
+      queryClient.invalidateQueries({ queryKey: grow90Keys.today() });
+      queryClient.invalidateQueries({ queryKey: grow90Keys.progress() });
+      queryClient.invalidateQueries({ queryKey: grow90Keys.stats() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update progress for a specific day
+ */
+export function useUpdateGrow90Progress(
+  options?: Omit<
+    UseMutationOptions<Grow90ProgressResponse, Error, { day: number; data: UpdateGrow90ProgressRequest }>,
+    'mutationFn'
+  >
+): UseMutationResult<Grow90ProgressResponse, Error, { day: number; data: UpdateGrow90ProgressRequest }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ day, data }): Promise<Grow90ProgressResponse> => {
+      const client = getApiClient();
+      const response = await client.put(`/api/v1/grow90/progress/${day}`, data);
+      // API returns { data: {...}, meta: {...} }, extract the data
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: grow90Keys.today() });
+      queryClient.invalidateQueries({ queryKey: grow90Keys.progress() });
+      queryClient.invalidateQueries({ queryKey: grow90Keys.stats() });
+      queryClient.invalidateQueries({ queryKey: grow90Keys.enrollment() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update GROW90 settings
+ */
+export function useUpdateGrow90Settings(
+  options?: Omit<
+    UseMutationOptions<Grow90EnrollmentResponse, Error, UpdateGrow90SettingsRequest>,
+    'mutationFn'
+  >
+): UseMutationResult<Grow90EnrollmentResponse, Error, UpdateGrow90SettingsRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: UpdateGrow90SettingsRequest): Promise<Grow90EnrollmentResponse> => {
+      const client = getApiClient();
+      const response = await client.put('/api/v1/grow90/settings', data);
+      // API returns { data: {...}, meta: {...} }, extract the data
+      return response.data?.data || response.data;
+    },
+    onSuccess: (enrollment) => {
+      queryClient.setQueryData(grow90Keys.enrollment(), enrollment);
+    },
+    ...options,
+  });
+}
+
+/**
+ * Pause GROW90 program
+ */
+export function usePauseGrow90(
+  options?: Omit<UseMutationOptions<Grow90EnrollmentResponse, Error, void>, 'mutationFn'>
+): UseMutationResult<Grow90EnrollmentResponse, Error, void> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (): Promise<Grow90EnrollmentResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/grow90/pause');
+      // API returns { data: {...}, meta: {...} }, extract the data
+      return response.data?.data || response.data;
+    },
+    onSuccess: (enrollment) => {
+      queryClient.setQueryData(grow90Keys.enrollment(), enrollment);
+    },
+    ...options,
+  });
+}
+
+/**
+ * Resume GROW90 program
+ */
+export function useResumeGrow90(
+  options?: Omit<UseMutationOptions<Grow90EnrollmentResponse, Error, void>, 'mutationFn'>
+): UseMutationResult<Grow90EnrollmentResponse, Error, void> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (): Promise<Grow90EnrollmentResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/grow90/resume');
+      // API returns { data: {...}, meta: {...} }, extract the data
+      return response.data?.data || response.data;
+    },
+    onSuccess: (enrollment) => {
+      queryClient.setQueryData(grow90Keys.enrollment(), enrollment);
+      queryClient.invalidateQueries({ queryKey: grow90Keys.today() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Abandon GROW90 program
+ */
+export function useAbandonGrow90(
+  options?: Omit<UseMutationOptions<{ success: boolean }, Error, void>, 'mutationFn'>
+): UseMutationResult<{ success: boolean }, Error, void> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (): Promise<{ success: boolean }> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/grow90/abandon');
+      // API returns { data: {...}, meta: {...} }, extract the data
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      queryClient.setQueryData(grow90Keys.enrollment(), null);
+      queryClient.invalidateQueries({ queryKey: grow90Keys.all });
+    },
+    ...options,
+  });
+}

package/src/api/mutations/hubs.ts

@@ -0,0 +1,385 @@
+import {
+  useMutation,
+  useQueryClient,
+  UseMutationOptions,
+  UseMutationResult,
+} from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type { HubResponse, CreateHubRequest, UpdateHubRequest } from '../types';
+import { hubKeys } from '../queries/hubs';
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface UpdateMemberRoleRequest {
+  role: 'OWNER' | 'ADMIN' | 'MEMBER';
+}
+
+export interface JoinHubResponse {
+  message: string;
+  membership: {
+    id: string;
+    hubId: string;
+    userId: string;
+    role: 'MEMBER';
+    status: 'ACTIVE' | 'PENDING';
+    joinedAt: string;
+  };
+}
+
+export interface LeaveHubResponse {
+  message: string;
+}
+
+export interface ApproveMemberResponse {
+  message: string;
+}
+
+export interface UpdateMemberRoleResponse {
+  message: string;
+  role: 'OWNER' | 'ADMIN' | 'MEMBER';
+}
+
+export interface RemoveMemberResponse {
+  message: string;
+}
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Create a new hub
+ *
+ * @param options - React Query mutation options
+ * @returns Mutation result
+ */
+export function useCreateHub(
+  options?: Omit<
+    UseMutationOptions<HubResponse, Error, CreateHubRequest>,
+    'mutationFn'
+  >
+): UseMutationResult<HubResponse, Error, CreateHubRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateHubRequest): Promise<HubResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/hubs', data);
+      return response.data;
+    },
+    onSuccess: (newHub, variables, context) => {
+      // Invalidate all hub lists to refetch with the new hub
+      queryClient.invalidateQueries({ queryKey: hubKeys.lists() });
+      // Invalidate my hubs list
+      queryClient.invalidateQueries({ queryKey: hubKeys.myHubs() });
+      // Set the new hub in the cache
+      queryClient.setQueryData(hubKeys.detail(newHub.id), newHub);
+
+      // Call user's onSuccess if provided
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update an existing hub
+ *
+ * @param options - React Query mutation options
+ * @returns Mutation result
+ */
+export function useUpdateHub(
+  options?: Omit<
+    UseMutationOptions<HubResponse, Error, { id: string; data: UpdateHubRequest }>,
+    'mutationFn'
+  >
+): UseMutationResult<HubResponse, Error, { id: string; data: UpdateHubRequest }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      id,
+      data,
+    }: {
+      id: string;
+      data: UpdateHubRequest;
+    }): Promise<HubResponse> => {
+      const client = getApiClient();
+      const response = await client.put(`/api/v1/hubs/${id}`, data);
+      return response.data;
+    },
+    onSuccess: (updatedHub, variables, context) => {
+      // Update the hub in the cache
+      queryClient.setQueryData(hubKeys.detail(updatedHub.id), updatedHub);
+      // Invalidate hub lists to refetch with updated data
+      queryClient.invalidateQueries({ queryKey: hubKeys.lists() });
+      // Invalidate my hubs list
+      queryClient.invalidateQueries({ queryKey: hubKeys.myHubs() });
+      // Invalidate slug-based query since slug might have changed
+      queryClient.invalidateQueries({
+        queryKey: hubKeys.bySlug(updatedHub.slug)
+      });
+
+      // Call user's onSuccess if provided
+    },
+    ...options,
+  });
+}
+
+/**
+ * Delete a hub
+ *
+ * @param options - React Query mutation options
+ * @returns Mutation result
+ */
+export function useDeleteHub(
+  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/hubs/${id}`);
+    },
+    onSuccess: (data, id, context) => {
+      // Remove the hub from the cache
+      queryClient.removeQueries({ queryKey: hubKeys.detail(id) });
+      // Invalidate all hub lists to refetch without the deleted hub
+      queryClient.invalidateQueries({ queryKey: hubKeys.lists() });
+      // Invalidate my hubs list
+      queryClient.invalidateQueries({ queryKey: hubKeys.myHubs() });
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Join a hub
+ *
+ * @param options - React Query mutation options
+ * @returns Mutation result
+ */
+export function useJoinHub(
+  options?: Omit<UseMutationOptions<JoinHubResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<JoinHubResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<JoinHubResponse> => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/hubs/${id}/join`);
+      return response.data;
+    },
+    onSuccess: (data, id, context) => {
+      // Invalidate membership status for this hub
+      queryClient.invalidateQueries({ queryKey: hubKeys.membership(id) });
+      // Invalidate my hubs list
+      queryClient.invalidateQueries({ queryKey: hubKeys.myHubs() });
+      // Invalidate hub members list
+      queryClient.invalidateQueries({ queryKey: hubKeys.members(id) });
+      // Refetch hub details to update member count
+      queryClient.invalidateQueries({ queryKey: hubKeys.detail(id) });
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Leave a hub
+ *
+ * @param options - React Query mutation options
+ * @returns Mutation result
+ */
+export function useLeaveHub(
+  options?: Omit<UseMutationOptions<LeaveHubResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<LeaveHubResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<LeaveHubResponse> => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/hubs/${id}/leave`);
+      return response.data;
+    },
+    onSuccess: (data, id, context) => {
+      // Invalidate membership status for this hub
+      queryClient.invalidateQueries({ queryKey: hubKeys.membership(id) });
+      // Invalidate my hubs list
+      queryClient.invalidateQueries({ queryKey: hubKeys.myHubs() });
+      // Invalidate hub members list
+      queryClient.invalidateQueries({ queryKey: hubKeys.members(id) });
+      // Refetch hub details to update member count
+      queryClient.invalidateQueries({ queryKey: hubKeys.detail(id) });
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Approve a pending member
+ *
+ * @param options - React Query mutation options
+ * @returns Mutation result
+ */
+export function useApproveMember(
+  options?: Omit<
+    UseMutationOptions<
+      ApproveMemberResponse,
+      Error,
+      { hubId: string; memberId: string }
+    >,
+    'mutationFn'
+  >
+): UseMutationResult<
+  ApproveMemberResponse,
+  Error,
+  { hubId: string; memberId: string }
+> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      hubId,
+      memberId,
+    }: {
+      hubId: string;
+      memberId: string;
+    }): Promise<ApproveMemberResponse> => {
+      const client = getApiClient();
+      const response = await client.post(
+        `/api/v1/hubs/${hubId}/members/${memberId}/approve`
+      );
+      return response.data;
+    },
+    onSuccess: (data, variables, context) => {
+      // Invalidate hub members list to refetch with updated status
+      queryClient.invalidateQueries({
+        queryKey: hubKeys.members(variables.hubId)
+      });
+      // Refetch hub details to update member count
+      queryClient.invalidateQueries({
+        queryKey: hubKeys.detail(variables.hubId)
+      });
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update a member's role
+ *
+ * @param options - React Query mutation options
+ * @returns Mutation result
+ */
+export function useUpdateMemberRole(
+  options?: Omit<
+    UseMutationOptions<
+      UpdateMemberRoleResponse,
+      Error,
+      { hubId: string; memberId: string; data: UpdateMemberRoleRequest }
+    >,
+    'mutationFn'
+  >
+): UseMutationResult<
+  UpdateMemberRoleResponse,
+  Error,
+  { hubId: string; memberId: string; data: UpdateMemberRoleRequest }
+> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      hubId,
+      memberId,
+      data,
+    }: {
+      hubId: string;
+      memberId: string;
+      data: UpdateMemberRoleRequest;
+    }): Promise<UpdateMemberRoleResponse> => {
+      const client = getApiClient();
+      const response = await client.put(
+        `/api/v1/hubs/${hubId}/members/${memberId}/role`,
+        data
+      );
+      return response.data;
+    },
+    onSuccess: (data, variables, context) => {
+      // Invalidate hub members list to refetch with updated role
+      queryClient.invalidateQueries({
+        queryKey: hubKeys.members(variables.hubId)
+      });
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Remove a member from a hub
+ *
+ * @param options - React Query mutation options
+ * @returns Mutation result
+ */
+export function useRemoveMember(
+  options?: Omit<
+    UseMutationOptions<
+      RemoveMemberResponse,
+      Error,
+      { hubId: string; memberId: string }
+    >,
+    'mutationFn'
+  >
+): UseMutationResult<
+  RemoveMemberResponse,
+  Error,
+  { hubId: string; memberId: string }
+> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      hubId,
+      memberId,
+    }: {
+      hubId: string;
+      memberId: string;
+    }): Promise<RemoveMemberResponse> => {
+      const client = getApiClient();
+      const response = await client.delete(
+        `/api/v1/hubs/${hubId}/members/${memberId}`
+      );
+      return response.data;
+    },
+    onSuccess: (data, variables, context) => {
+      // Invalidate hub members list to refetch without removed member
+      queryClient.invalidateQueries({
+        queryKey: hubKeys.members(variables.hubId)
+      });
+      // Refetch hub details to update member count
+      queryClient.invalidateQueries({
+        queryKey: hubKeys.detail(variables.hubId)
+      });
+
+      // Call user's onSuccess if provided
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}

package/src/api/mutations/index.ts

@@ -0,0 +1,23 @@
+/**
+ * Mutation Hooks
+ *
+ * Re-exports all mutation hooks for API endpoints.
+ */
+
+export * from './admin';
+export * from './auth';
+export * from './bookings';
+export * from './events';
+export * from './hubs';
+export * from './library';
+export * from './map';
+export * from './notifications';
+export * from './offers';
+export * from './subscriptions';
+export * from './support';
+export * from './users';
+export * from './jack';
+export * from './ambassadors';
+export * from './grow90';
+export * from './matching';
+export * from './event-chat';

package/src/api/mutations/jack.ts

@@ -0,0 +1,130 @@
+import { useMutation, useQueryClient, UseMutationOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { jackKeys } from '../queries/jack';
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface ChatRequest {
+  message: string;
+  conversationId?: string;
+}
+
+export interface ChatResponse {
+  message: string;
+  conversationId: string;
+  messageId: string;
+}
+
+export interface NewConversationResponse {
+  conversationId: string;
+}
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Send a message to Jack and get a response
+ *
+ * @example
+ * ```tsx
+ * const chatMutation = useChatWithJack();
+ *
+ * const handleSend = async (message: string) => {
+ *   const response = await chatMutation.mutateAsync({
+ *     message,
+ *     conversationId: currentConversationId, // optional
+ *   });
+ *   console.log('Jack says:', response.message);
+ * };
+ * ```
+ */
+export function useChatWithJack(
+  options?: Omit<UseMutationOptions<ChatResponse, Error, ChatRequest>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: ChatRequest): Promise<ChatResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/support/jack/chat', data);
+      // API wraps response in { data: {...}, meta: {...} }
+      return response.data?.data || response.data;
+    },
+    onSuccess: (data) => {
+      // Invalidate conversation queries to refresh the list
+      queryClient.invalidateQueries({ queryKey: jackKeys.conversations() });
+      queryClient.invalidateQueries({ queryKey: jackKeys.history() });
+      if (data.conversationId) {
+        queryClient.invalidateQueries({ queryKey: jackKeys.conversation(data.conversationId) });
+      }
+    },
+    ...options,
+  });
+}
+
+/**
+ * Start a new conversation with Jack
+ *
+ * @example
+ * ```tsx
+ * const newConversation = useStartJackConversation();
+ *
+ * const handleNewChat = async () => {
+ *   const { conversationId } = await newConversation.mutateAsync();
+ *   setCurrentConversationId(conversationId);
+ * };
+ * ```
+ */
+export function useStartJackConversation(
+  options?: Omit<UseMutationOptions<NewConversationResponse, Error, void>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (): Promise<NewConversationResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/support/jack/conversations/new');
+      // API wraps response in { data: {...}, meta: {...} }
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: jackKeys.conversations() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Archive a conversation with Jack
+ *
+ * @example
+ * ```tsx
+ * const archiveConversation = useArchiveJackConversation();
+ *
+ * const handleArchive = async (conversationId: string) => {
+ *   await archiveConversation.mutateAsync(conversationId);
+ * };
+ * ```
+ */
+export function useArchiveJackConversation(
+  options?: Omit<UseMutationOptions<{ success: boolean }, Error, string>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (conversationId: string): Promise<{ success: boolean }> => {
+      const client = getApiClient();
+      const response = await client.delete(`/api/v1/support/jack/conversations/${conversationId}`);
+      // API wraps response in { data: {...}, meta: {...} }
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: jackKeys.conversations() });
+      queryClient.invalidateQueries({ queryKey: jackKeys.history() });
+    },
+    ...options,
+  });
+}