@growsober/sdk 1.0.0

package/src/api/queries/grow90.ts

@@ -0,0 +1,98 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type {
+  Grow90EnrollmentResponse,
+  Grow90ProgressResponse,
+  Grow90TodayResponse,
+  Grow90StatsResponse,
+} from '../types';
+
+// ============================================================================
+// QUERY KEYS
+// ============================================================================
+
+export const grow90Keys = {
+  all: ['grow90'] as const,
+  enrollment: () => [...grow90Keys.all, 'enrollment'] as const,
+  today: () => [...grow90Keys.all, 'today'] as const,
+  progress: () => [...grow90Keys.all, 'progress'] as const,
+  progressDay: (day: number) => [...grow90Keys.progress(), day] as const,
+  stats: () => [...grow90Keys.all, 'stats'] as const,
+};
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get current user's GROW90 enrollment
+ */
+export function useGrow90Enrollment(
+  options?: Omit<UseQueryOptions<Grow90EnrollmentResponse | null>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: grow90Keys.enrollment(),
+    queryFn: async (): Promise<Grow90EnrollmentResponse | null> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/grow90/me');
+      // API returns { data: {...}, meta: {...} }, extract the data
+      const enrollment = 'data' in response.data ? response.data.data : response.data;
+      return enrollment;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get today's GROW90 content and progress
+ */
+export function useGrow90Today(
+  options?: Omit<UseQueryOptions<Grow90TodayResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: grow90Keys.today(),
+    queryFn: async (): Promise<Grow90TodayResponse> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/grow90/today');
+      // API returns { data: {...}, meta: {...} }, extract the data
+      return response.data?.data || response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get all GROW90 progress entries
+ */
+export function useGrow90Progress(
+  options?: Omit<UseQueryOptions<Grow90ProgressResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: grow90Keys.progress(),
+    queryFn: async (): Promise<Grow90ProgressResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/grow90/progress');
+      // API returns { data: [...], meta: {...} }, extract the data
+      return response.data?.data || response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get GROW90 statistics
+ */
+export function useGrow90Stats(
+  options?: Omit<UseQueryOptions<Grow90StatsResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: grow90Keys.stats(),
+    queryFn: async (): Promise<Grow90StatsResponse> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/grow90/stats');
+      // API returns { data: {...}, meta: {...} }, extract the data
+      return response.data?.data || response.data;
+    },
+    ...options,
+  });
+}

package/src/api/queries/hubs.ts

@@ -0,0 +1,211 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type { HubResponse, HubMemberResponse } from '../types';
+
+// ============================================================================
+// QUERY KEYS
+// ============================================================================
+
+export const hubKeys = {
+  all: ['hubs'] as const,
+  lists: () => [...hubKeys.all, 'list'] as const,
+  list: (filters?: HubListFilters) => [...hubKeys.lists(), filters] as const,
+  details: () => [...hubKeys.all, 'detail'] as const,
+  detail: (id: string) => [...hubKeys.details(), id] as const,
+  bySlug: (slug: string) => [...hubKeys.all, 'slug', slug] as const,
+  myHubs: () => [...hubKeys.all, 'my-hubs'] as const,
+  members: (id: string, filters?: MemberFilters) =>
+    [...hubKeys.detail(id), 'members', filters] as const,
+  membership: (id: string) => [...hubKeys.detail(id), 'membership'] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface HubListFilters {
+  page?: number;
+  limit?: number;
+  cityId?: string;
+  search?: string;
+  isFeatured?: boolean;
+  visibility?: 'PUBLIC' | 'PRIVATE' | 'INVITE_ONLY';
+}
+
+export interface MemberFilters {
+  page?: number;
+  limit?: number;
+  role?: string;
+  status?: string;
+}
+
+export interface PaginatedHubsResponse {
+  data: HubResponse[];
+  meta: {
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+  };
+}
+
+// HubMemberResponse is imported from '../types'
+
+export interface PaginatedMembersResponse {
+  data: HubMemberResponse[];
+  meta: {
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+  };
+}
+
+export interface MembershipResponse {
+  isMember: boolean;
+  role?: 'OWNER' | 'ADMIN' | 'MEMBER';
+  status?: 'ACTIVE' | 'PENDING' | 'BANNED';
+  joinedAt?: string;
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get all hubs with pagination and filters
+ *
+ * @param filters - Optional filters for hubs list
+ * @param options - React Query options
+ * @returns Query result with paginated hubs
+ */
+export function useHubs(
+  filters?: HubListFilters,
+  options?: Omit<UseQueryOptions<PaginatedHubsResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: hubKeys.list(filters),
+    queryFn: async (): Promise<PaginatedHubsResponse> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/hubs', { params: filters });
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get hub by ID
+ *
+ * @param id - Hub ID
+ * @param options - React Query options
+ * @returns Query result with hub details
+ */
+export function useHub(
+  id: string,
+  options?: Omit<UseQueryOptions<HubResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: hubKeys.detail(id),
+    queryFn: async (): Promise<HubResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/hubs/${id}`);
+      return response.data;
+    },
+    enabled: !!id && (options?.enabled !== false),
+    ...options,
+  });
+}
+
+/**
+ * Get hub by slug
+ *
+ * @param slug - Hub slug
+ * @param options - React Query options
+ * @returns Query result with hub details
+ */
+export function useHubBySlug(
+  slug: string,
+  options?: Omit<UseQueryOptions<HubResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: hubKeys.bySlug(slug),
+    queryFn: async (): Promise<HubResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/hubs/slug/${slug}`);
+      return response.data;
+    },
+    enabled: !!slug && (options?.enabled !== false),
+    ...options,
+  });
+}
+
+/**
+ * Get hubs the current user is a member of
+ *
+ * @param options - React Query options
+ * @returns Query result with user's hubs
+ */
+export function useMyHubs(
+  options?: Omit<UseQueryOptions<HubResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: hubKeys.myHubs(),
+    queryFn: async (): Promise<HubResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/hubs/my-hubs');
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get hub members with pagination and filters
+ *
+ * @param id - Hub ID
+ * @param filters - Optional filters for members list
+ * @param options - React Query options
+ * @returns Query result with paginated members
+ */
+export function useHubMembers(
+  id: string,
+  filters?: MemberFilters,
+  options?: Omit<UseQueryOptions<PaginatedMembersResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: hubKeys.members(id, filters),
+    queryFn: async (): Promise<PaginatedMembersResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/hubs/${id}/members`, {
+        params: filters
+      });
+      return response.data;
+    },
+    enabled: !!id && (options?.enabled !== false),
+    ...options,
+  });
+}
+
+/**
+ * Get current user's membership status for a hub
+ *
+ * @param id - Hub ID
+ * @param options - React Query options
+ * @returns Query result with membership status
+ */
+export function useHubMembership(
+  id: string,
+  options?: Omit<UseQueryOptions<MembershipResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: hubKeys.membership(id),
+    queryFn: async (): Promise<MembershipResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/hubs/${id}/membership`);
+      return response.data;
+    },
+    enabled: !!id && (options?.enabled !== false),
+    ...options,
+  });
+}

package/src/api/queries/index.ts

@@ -0,0 +1,24 @@
+/**
+ * Query Hooks
+ *
+ * Re-exports all query hooks for API endpoints.
+ */
+
+export * from './admin';
+export * from './auth';
+export * from './bookings';
+export * from './businesses';
+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/queries/jack.ts

@@ -0,0 +1,127 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const jackKeys = {
+  all: ['jack'] as const,
+  conversations: () => [...jackKeys.all, 'conversations'] as const,
+  conversation: (id: string) => [...jackKeys.all, 'conversation', id] as const,
+  history: () => [...jackKeys.all, 'history'] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface JackConversation {
+  id: string;
+  title: string;
+  messageCount: number;
+  lastMessageAt: string | null;
+  createdAt: string;
+  isArchived: boolean;
+}
+
+export interface JackMessage {
+  id: string;
+  conversationId: string;
+  role: 'USER' | 'ASSISTANT' | 'SYSTEM';
+  content: string;
+  model?: string;
+  promptTokens?: number;
+  completionTokens?: number;
+  createdAt: string;
+}
+
+export interface JackConversationWithMessages extends JackConversation {
+  messages: JackMessage[];
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get all conversations with Jack
+ *
+ * @param limit - Maximum conversations to return (default: 20)
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: conversations } = useJackConversations();
+ * ```
+ */
+export function useJackConversations(
+  limit = 20,
+  options?: Omit<UseQueryOptions<JackConversation[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: jackKeys.conversations(),
+    queryFn: async (): Promise<JackConversation[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/support/jack/conversations', {
+        params: { limit },
+      });
+      // API wraps response in { data: {...}, meta: {...} }
+      return response.data?.data || response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get a specific conversation with messages
+ *
+ * @param conversationId - The conversation ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: conversation } = useJackConversation('conv-123');
+ * ```
+ */
+export function useJackConversation(
+  conversationId: string,
+  options?: Omit<UseQueryOptions<JackConversationWithMessages | null>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: jackKeys.conversation(conversationId),
+    queryFn: async (): Promise<JackConversationWithMessages | null> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/support/jack/conversations/${conversationId}`);
+      // API wraps response in { data: {...}, meta: {...} }
+      return response.data?.data || response.data;
+    },
+    enabled: !!conversationId,
+    ...options,
+  });
+}
+
+/**
+ * Get the most recent active conversation with Jack
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: history } = useJackHistory();
+ * ```
+ */
+export function useJackHistory(
+  options?: Omit<UseQueryOptions<JackConversationWithMessages | null>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: jackKeys.history(),
+    queryFn: async (): Promise<JackConversationWithMessages | null> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/support/jack/history');
+      // API wraps response in { data: {...}, meta: {...} }
+      return response.data?.data || response.data;
+    },
+    ...options,
+  });
+}

package/src/api/queries/library.ts

@@ -0,0 +1,166 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type {
+  LibraryContentResponse,
+  LibraryContentDetailResponse,
+} from '../types';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const libraryKeys = {
+  all: ['library'] as const,
+  lists: () => [...libraryKeys.all, 'list'] as const,
+  list: (filters?: LibraryFilters) => [...libraryKeys.lists(), filters] as const,
+  featured: () => [...libraryKeys.all, 'featured'] as const,
+  categories: () => [...libraryKeys.all, 'categories'] as const,
+  details: () => [...libraryKeys.all, 'detail'] as const,
+  detail: (id: string) => [...libraryKeys.details(), id] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface LibraryFilters {
+  page?: number;
+  limit?: number;
+  categoryId?: string;
+  type?: 'ARTICLE' | 'VIDEO' | 'PODCAST' | 'MEDITATION' | 'WORKSHEET';
+  search?: string;
+  isFeatured?: boolean;
+  drinkingIdentity?: 'SOBER' | 'SOBER_CURIOUS' | 'MINDFUL';
+  sortBy?: 'createdAt' | 'title' | 'viewCount';
+  sortOrder?: 'asc' | 'desc';
+}
+
+export interface PaginatedLibraryResponse {
+  content: LibraryContentResponse[];
+  total: number;
+  page: number;
+  limit: number;
+  totalPages: number;
+}
+
+export interface LibraryCategoryResponse {
+  id: string;
+  name: string;
+  slug: string;
+  description?: string;
+  icon?: string;
+  contentCount?: number;
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get paginated list of library content with optional filters
+ *
+ * @param filters - Query parameters for filtering and pagination
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useLibraryContent({
+ *   page: 1,
+ *   limit: 20,
+ *   categoryId: 'cat-123',
+ *   type: 'ARTICLE',
+ *   isFeatured: true
+ * });
+ * ```
+ */
+export function useLibraryContent(
+  filters?: LibraryFilters,
+  options?: Omit<UseQueryOptions<PaginatedLibraryResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: libraryKeys.list(filters),
+    queryFn: async (): Promise<PaginatedLibraryResponse> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/library', {
+        params: filters,
+      });
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get featured library content
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useFeaturedContent();
+ * ```
+ */
+export function useFeaturedContent(
+  options?: Omit<UseQueryOptions<LibraryContentResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: libraryKeys.featured(),
+    queryFn: async (): Promise<LibraryContentResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/library/featured');
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get all library categories
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useLibraryCategories();
+ * ```
+ */
+export function useLibraryCategories(
+  options?: Omit<UseQueryOptions<LibraryCategoryResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: libraryKeys.categories(),
+    queryFn: async (): Promise<LibraryCategoryResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/library/categories');
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get a single library item by ID
+ *
+ * @param id - Library content ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useLibraryItem('lib-123');
+ * ```
+ */
+export function useLibraryItem(
+  id: string,
+  options?: Omit<UseQueryOptions<LibraryContentDetailResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: libraryKeys.detail(id),
+    queryFn: async (): Promise<LibraryContentDetailResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/library/${id}`);
+      return response.data;
+    },
+    enabled: !!id,
+    ...options,
+  });
+}