@growsober/sdk 1.0.0

package/src/api/queries/offers.ts

@@ -0,0 +1,136 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type { OfferResponse } from '../types';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const offerKeys = {
+  all: ['offers'] as const,
+  lists: () => [...offerKeys.all, 'list'] as const,
+  list: (filters?: OfferFilters) => [...offerKeys.lists(), filters] as const,
+  details: () => [...offerKeys.all, 'detail'] as const,
+  detail: (id: string) => [...offerKeys.details(), id] as const,
+  canRedeem: (id: string) => [...offerKeys.detail(id), 'can-redeem'] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface OfferFilters {
+  page?: number;
+  limit?: number;
+  businessId?: string;
+  isActive?: boolean;
+}
+
+export interface PaginatedOffersResponse {
+  offers: OfferResponse[];
+  total: number;
+  page: number;
+  limit: number;
+  totalPages: number;
+}
+
+export interface CanRedeemOfferResponse {
+  canRedeem: boolean;
+  reason?: string;
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get paginated list of offers with optional filters
+ *
+ * @param filters - Query parameters for filtering and pagination
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useOffers({
+ *   page: 1,
+ *   limit: 20,
+ *   businessId: 'business-123',
+ *   isActive: true
+ * });
+ * ```
+ */
+export function useOffers(
+  filters?: OfferFilters,
+  options?: Omit<UseQueryOptions<PaginatedOffersResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: offerKeys.list(filters),
+    queryFn: async (): Promise<PaginatedOffersResponse> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/offers', {
+        params: filters,
+      });
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get a single offer by ID
+ *
+ * @param id - Offer ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useOffer('offer-123');
+ * ```
+ */
+export function useOffer(
+  id: string,
+  options?: Omit<UseQueryOptions<OfferResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: offerKeys.detail(id),
+    queryFn: async (): Promise<OfferResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/offers/${id}`);
+      return response.data;
+    },
+    enabled: !!id,
+    ...options,
+  });
+}
+
+/**
+ * Check if a user can redeem a specific offer
+ *
+ * @param id - Offer ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useCanRedeemOffer('offer-123');
+ * if (data?.canRedeem) {
+ *   // User can redeem the offer
+ * } else {
+ *   console.log('Cannot redeem:', data?.reason);
+ * }
+ * ```
+ */
+export function useCanRedeemOffer(
+  id: string,
+  options?: Omit<UseQueryOptions<CanRedeemOfferResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: offerKeys.canRedeem(id),
+    queryFn: async (): Promise<CanRedeemOfferResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/offers/${id}/can-redeem`);
+      return response.data;
+    },
+    enabled: !!id,
+    ...options,
+  });
+}

package/src/api/queries/subscriptions.ts

@@ -0,0 +1,91 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type { SubscriptionResponse } from '../types';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const subscriptionKeys = {
+  all: ['subscriptions'] as const,
+  plans: () => [...subscriptionKeys.all, 'plans'] as const,
+  mine: () => [...subscriptionKeys.all, 'me'] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface SubscriptionPlan {
+  id: string;
+  name: string;
+  tier: 'FREE' | 'PREMIUM';
+  price: number;
+  currency: string;
+  interval: 'month' | 'year';
+  features: string[];
+  stripePriceId?: string;
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get available subscription plans
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: plans, isLoading } = useSubscriptionPlans();
+ * ```
+ */
+export function useSubscriptionPlans(
+  options?: Omit<UseQueryOptions<SubscriptionPlan[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: subscriptionKeys.plans(),
+    queryFn: async (): Promise<SubscriptionPlan[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/subscriptions/plans');
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get current user's subscription
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: subscription, isLoading } = useMySubscription();
+ * ```
+ */
+export function useMySubscription(
+  options?: Omit<UseQueryOptions<SubscriptionResponse | null>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: subscriptionKeys.mine(),
+    queryFn: async (): Promise<SubscriptionResponse | null> => {
+      const client = getApiClient();
+      try {
+        const response = await client.get('/api/v1/subscriptions/me');
+        return response.data;
+      } catch (error: unknown) {
+        // 404 means no subscription - return null instead of throwing
+        if (error && typeof error === 'object' && 'response' in error) {
+          const axiosError = error as { response?: { status?: number } };
+          if (axiosError.response?.status === 404) {
+            return null;
+          }
+        }
+        throw error;
+      }
+    },
+    ...options,
+  });
+}

package/src/api/queries/support.ts

@@ -0,0 +1,235 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type {
+  DailyCheckInResponse,
+  MoodLogResponse,
+  WinResponse,
+  HabitResponse,
+  ReflectionResponse,
+  UserStreakResponse,
+} from '../types';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const supportKeys = {
+  all: ['support'] as const,
+  checkIns: () => [...supportKeys.all, 'check-ins'] as const,
+  checkInToday: () => [...supportKeys.checkIns(), 'today'] as const,
+  checkInStreak: () => [...supportKeys.checkIns(), 'streak'] as const,
+  moodLogs: () => [...supportKeys.all, 'mood'] as const,
+  wins: () => [...supportKeys.all, 'wins'] as const,
+  winsByCategory: () => [...supportKeys.wins(), 'by-category'] as const,
+  habits: () => [...supportKeys.all, 'habits'] as const,
+  reflections: () => [...supportKeys.all, 'reflections'] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface WinsByCategory {
+  category: string;
+  wins: WinResponse[];
+  count: number;
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get user's daily check-ins
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useCheckIns();
+ * ```
+ */
+export function useCheckIns(
+  options?: Omit<UseQueryOptions<DailyCheckInResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: supportKeys.checkIns(),
+    queryFn: async (): Promise<DailyCheckInResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/support/check-ins');
+      // API wraps responses in { data: [...], meta: {...} }
+      return response.data?.data || response.data || [];
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get today's check-in
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useTodayCheckIn();
+ * ```
+ */
+export function useTodayCheckIn(
+  options?: Omit<UseQueryOptions<DailyCheckInResponse | null>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: supportKeys.checkInToday(),
+    queryFn: async (): Promise<DailyCheckInResponse | null> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/support/check-ins/today');
+      // API wraps responses in { data: {...}, meta: {...} }
+      return response.data?.data ?? response.data ?? null;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get user's check-in streak
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useCheckInStreak();
+ * ```
+ */
+export function useCheckInStreak(
+  options?: Omit<UseQueryOptions<UserStreakResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: supportKeys.checkInStreak(),
+    queryFn: async (): Promise<UserStreakResponse> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/support/check-ins/streak');
+      // API wraps responses in { data: {...}, meta: {...} }
+      return response.data?.data || response.data || { currentStreak: 0, longestStreak: 0, totalCheckIns: 0 };
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get user's mood logs
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useMoodLogs();
+ * ```
+ */
+export function useMoodLogs(
+  options?: Omit<UseQueryOptions<MoodLogResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: supportKeys.moodLogs(),
+    queryFn: async (): Promise<MoodLogResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/support/mood');
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get user's wins
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useWins();
+ * ```
+ */
+export function useWins(
+  options?: Omit<UseQueryOptions<WinResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: supportKeys.wins(),
+    queryFn: async (): Promise<WinResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/support/wins');
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get user's wins grouped by category
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useWinsByCategory();
+ * ```
+ */
+export function useWinsByCategory(
+  options?: Omit<UseQueryOptions<WinsByCategory[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: supportKeys.winsByCategory(),
+    queryFn: async (): Promise<WinsByCategory[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/support/wins/by-category');
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get user's habits
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useHabits();
+ * ```
+ */
+export function useHabits(
+  options?: Omit<UseQueryOptions<HabitResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: supportKeys.habits(),
+    queryFn: async (): Promise<HabitResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/support/habits');
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get user's reflections
+ *
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useReflections();
+ * ```
+ */
+export function useReflections(
+  options?: Omit<UseQueryOptions<ReflectionResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: supportKeys.reflections(),
+    queryFn: async (): Promise<ReflectionResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/support/reflections');
+      return response.data;
+    },
+    ...options,
+  });
+}