@growsober/sdk 1.0.5 → 1.0.8

package/src/api/queries/badges.ts

@@ -0,0 +1,385 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type {
+  BadgeResponse,
+  UserBadgeResponse,
+  BadgeWithProgress,
+  PartnerRewardResponse,
+  PartnerRewardRedemptionResponse,
+  RewardResponse,
+  UserWalletResponse,
+} from '../types';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const badgeKeys = {
+  all: ['badges'] as const,
+  lists: () => [...badgeKeys.all, 'list'] as const,
+  list: (userId?: string) => [...badgeKeys.lists(), userId] as const,
+  detail: (id: string) => [...badgeKeys.all, 'detail', id] as const,
+  user: (userId: string) => [...badgeKeys.all, 'user', userId] as const,
+  next: (userId: string) => [...badgeKeys.all, 'next', userId] as const,
+};
+
+export const rewardKeys = {
+  all: ['rewards'] as const,
+  available: () => [...rewardKeys.all, 'available'] as const,
+  forBadge: (badgeId: string) => [...rewardKeys.all, 'badge', badgeId] as const,
+  forBusiness: (businessId: string) => [...rewardKeys.all, 'business', businessId] as const,
+  forVenue: (venueId: string) => [...rewardKeys.all, 'venue', venueId] as const,
+  forBrand: (brandId: string) => [...rewardKeys.all, 'brand', brandId] as const,
+  redeemed: () => [...rewardKeys.all, 'redeemed'] as const,
+  wallet: () => [...rewardKeys.all, 'wallet'] as const,
+};
+
+// ============================================================================
+// BADGE QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get all available badges
+ *
+ * @example
+ * ```tsx
+ * const { data: badges } = useBadges();
+ * ```
+ */
+export function useBadges(
+  options?: Omit<UseQueryOptions<BadgeResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: badgeKeys.lists(),
+    queryFn: async (): Promise<BadgeResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/badges');
+      return response.data?.data || response.data || [];
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get a single badge by ID
+ *
+ * @param id - Badge ID
+ * @example
+ * ```tsx
+ * const { data: badge } = useBadge('badge-123');
+ * ```
+ */
+export function useBadge(
+  id: string,
+  options?: Omit<UseQueryOptions<BadgeResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: badgeKeys.detail(id),
+    queryFn: async (): Promise<BadgeResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/badges/${id}`);
+      return response.data?.data || response.data;
+    },
+    enabled: !!id,
+    ...options,
+  });
+}
+
+/**
+ * Get current user's earned badges
+ *
+ * @example
+ * ```tsx
+ * const { data: myBadges } = useMyBadges();
+ * ```
+ */
+export function useMyBadges(
+  options?: Omit<UseQueryOptions<UserBadgeResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: badgeKeys.user('me'),
+    queryFn: async (): Promise<UserBadgeResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/badges/me');
+      return response.data?.data || response.data || [];
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get next badges user can earn (with progress)
+ *
+ * @example
+ * ```tsx
+ * const { data: nextBadges } = useNextBadges();
+ * // nextBadges = [{ badge: {...}, currentProgress: 5, requiredProgress: 10, percentComplete: 50 }, ...]
+ * ```
+ */
+export function useNextBadges(
+  options?: Omit<UseQueryOptions<BadgeWithProgress[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: badgeKeys.next('me'),
+    queryFn: async (): Promise<BadgeWithProgress[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/badges/next');
+      return response.data?.data || response.data || [];
+    },
+    ...options,
+  });
+}
+
+// ============================================================================
+// PARTNER REWARD QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get all rewards available to the current user (based on earned badges)
+ *
+ * @example
+ * ```tsx
+ * const { data: rewards } = useAvailableRewards();
+ * ```
+ */
+export function useAvailableRewards(
+  options?: Omit<UseQueryOptions<PartnerRewardResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: rewardKeys.available(),
+    queryFn: async (): Promise<PartnerRewardResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/rewards/available');
+      return response.data?.data || response.data || [];
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get rewards for a specific badge
+ *
+ * @param badgeId - Badge ID
+ * @example
+ * ```tsx
+ * const { data: rewards } = useRewardsForBadge('badge-123');
+ * ```
+ */
+export function useRewardsForBadge(
+  badgeId: string,
+  options?: Omit<UseQueryOptions<PartnerRewardResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: rewardKeys.forBadge(badgeId),
+    queryFn: async (): Promise<PartnerRewardResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/rewards/badge/${badgeId}`);
+      return response.data?.data || response.data || [];
+    },
+    enabled: !!badgeId,
+    ...options,
+  });
+}
+
+/**
+ * Get rewards offered by a specific business
+ *
+ * @param businessId - Business ID
+ * @example
+ * ```tsx
+ * const { data: rewards } = useBusinessRewards('business-123');
+ * ```
+ */
+export function useBusinessRewards(
+  businessId: string,
+  options?: Omit<UseQueryOptions<PartnerRewardResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: rewardKeys.forBusiness(businessId),
+    queryFn: async (): Promise<PartnerRewardResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/rewards/business/${businessId}`);
+      return response.data?.data || response.data || [];
+    },
+    enabled: !!businessId,
+    ...options,
+  });
+}
+
+/**
+ * Get user's redeemed rewards
+ *
+ * @example
+ * ```tsx
+ * const { data: redeemed } = useRedeemedRewards();
+ * ```
+ */
+export function useRedeemedRewards(
+  options?: Omit<UseQueryOptions<PartnerRewardRedemptionResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: rewardKeys.redeemed(),
+    queryFn: async (): Promise<PartnerRewardRedemptionResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/rewards/redeemed');
+      return response.data?.data || response.data || [];
+    },
+    ...options,
+  });
+}
+
+// ============================================================================
+// WALLET (Combined badges + rewards for Rewards tab)
+// ============================================================================
+
+/**
+ * Wallet reward card with QR token for redemption
+ */
+export interface WalletReward {
+  id: string;
+  title: string;
+  description: string | null;
+  code: string | null;
+  validUntil: string | null;
+  badge: {
+    id: string;
+    name: string;
+    slug: string;
+    icon: string | null;
+  };
+  business: {
+    id: string;
+    name: string;
+    profileImage: string | null;
+    address: string | null;
+  };
+}
+
+export interface WalletRedemption {
+  id: string;
+  redeemedAt: string;
+  verifiedAt: string | null;
+  qrToken: string;
+  partnerReward: WalletReward;
+}
+
+export interface WalletBadge {
+  id: string;
+  badgeId: string;
+  userId: string;
+  awardedAt: string;
+  note: string | null;
+  badge: BadgeResponse;
+  availableRewards: WalletReward[];
+  redeemedRewards: WalletRedemption[];
+}
+
+export interface WalletResponse {
+  badges: WalletBadge[];
+  stats: {
+    totalBadges: number;
+    totalAvailableRewards: number;
+    totalRedeemedRewards: number;
+  };
+}
+
+/**
+ * Get user's wallet - all earned badges with available and redeemed rewards
+ * This is the main data source for the Rewards tab
+ *
+ * @example
+ * ```tsx
+ * const { data: wallet } = useRewardsWallet();
+ * // wallet.badges = [{ badge: {...}, availableRewards: [...], redeemedRewards: [...] }, ...]
+ * // wallet.stats = { totalBadges: 5, totalAvailableRewards: 3, totalRedeemedRewards: 2 }
+ * ```
+ */
+export function useRewardsWallet(
+  options?: Omit<UseQueryOptions<WalletResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: rewardKeys.wallet(),
+    queryFn: async (): Promise<WalletResponse> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/rewards/wallet');
+      return response.data?.data || response.data;
+    },
+    ...options,
+  });
+}
+
+// ============================================================================
+// UNIFIED REWARD HOOKS (Venue & Brand)
+// ============================================================================
+
+/**
+ * Get rewards for a specific venue (unified reward model)
+ *
+ * @param venueId - Venue ID
+ * @example
+ * ```tsx
+ * const { data: rewards } = useVenueRewards('venue-123');
+ * ```
+ */
+export function useVenueRewards(
+  venueId: string,
+  options?: Omit<UseQueryOptions<RewardResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: rewardKeys.forVenue(venueId),
+    queryFn: async (): Promise<RewardResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/rewards/venue/${venueId}`);
+      return response.data?.data || response.data || [];
+    },
+    enabled: !!venueId,
+    ...options,
+  });
+}
+
+/**
+ * Get rewards for a specific brand (unified reward model)
+ *
+ * @param brandId - Brand ID
+ * @example
+ * ```tsx
+ * const { data: rewards } = useBrandRewardsQuery('brand-123');
+ * ```
+ */
+export function useBrandRewardsQuery(
+  brandId: string,
+  options?: Omit<UseQueryOptions<RewardResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: rewardKeys.forBrand(brandId),
+    queryFn: async (): Promise<RewardResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/rewards/brand/${brandId}`);
+      return response.data?.data || response.data || [];
+    },
+    enabled: !!brandId,
+    ...options,
+  });
+}
+
+/**
+ * Get unified wallet with venue and brand rewards
+ *
+ * @example
+ * ```tsx
+ * const { data: wallet } = useUnifiedWallet();
+ * ```
+ */
+export function useUnifiedWallet(
+  options?: Omit<UseQueryOptions<UserWalletResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: [...rewardKeys.wallet(), 'unified'],
+    queryFn: async (): Promise<UserWalletResponse> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/rewards/wallet');
+      return response.data?.data || response.data;
+    },
+    ...options,
+  });
+}

package/src/api/queries/brands.ts

@@ -0,0 +1,281 @@
+import { useQuery, UseQueryOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type {
+  BrandResponse,
+  BrandOwnerResponse,
+  BrandCreatorResponse,
+  RewardResponse,
+  EventResponse,
+} from '../types';
+
+// ============================================================================
+// QUERY KEY FACTORY
+// ============================================================================
+
+export const brandKeys = {
+  all: ['brands'] as const,
+  lists: () => [...brandKeys.all, 'list'] as const,
+  list: (filters?: BrandFilters) => [...brandKeys.lists(), filters] as const,
+  details: () => [...brandKeys.all, 'detail'] as const,
+  detail: (id: string) => [...brandKeys.details(), id] as const,
+  slug: (slug: string) => [...brandKeys.all, 'slug', slug] as const,
+  featured: () => [...brandKeys.all, 'featured'] as const,
+  owners: (brandId: string) => [...brandKeys.detail(brandId), 'owners'] as const,
+  creators: (brandId: string) => [...brandKeys.detail(brandId), 'creators'] as const,
+  rewards: (brandId: string) => [...brandKeys.detail(brandId), 'rewards'] as const,
+  events: (brandId: string) => [...brandKeys.detail(brandId), 'events'] as const,
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface BrandFilters {
+  page?: number;
+  limit?: number;
+  search?: string;
+  isVerified?: boolean;
+  isFeatured?: boolean;
+  sortBy?: string;
+  sortOrder?: 'asc' | 'desc';
+}
+
+export interface PaginatedBrandsResponse {
+  brands: BrandResponse[];
+  meta: {
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+  };
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get paginated list of brands with optional filters
+ *
+ * @param filters - Query parameters for filtering and pagination
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBrands({
+ *   page: 1,
+ *   limit: 20,
+ *   isFeatured: true,
+ * });
+ * ```
+ */
+export function useBrands(
+  filters?: BrandFilters,
+  options?: Omit<UseQueryOptions<PaginatedBrandsResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: brandKeys.list(filters),
+    queryFn: async (): Promise<PaginatedBrandsResponse> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/brands', {
+        params: filters,
+      });
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get a single brand by ID
+ *
+ * @param id - Brand ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBrand('brand-123');
+ * ```
+ */
+export function useBrand(
+  id: string,
+  options?: Omit<UseQueryOptions<BrandResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: brandKeys.detail(id),
+    queryFn: async (): Promise<BrandResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/brands/${id}`);
+      return response.data;
+    },
+    enabled: !!id,
+    ...options,
+  });
+}
+
+/**
+ * Get a brand by its slug
+ *
+ * @param slug - Brand slug
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBrandBySlug('wellness-co');
+ * ```
+ */
+export function useBrandBySlug(
+  slug: string,
+  options?: Omit<UseQueryOptions<BrandResponse>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: brandKeys.slug(slug),
+    queryFn: async (): Promise<BrandResponse> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/brands/slug/${slug}`);
+      return response.data;
+    },
+    enabled: !!slug,
+    ...options,
+  });
+}
+
+/**
+ * Get featured brands
+ *
+ * @param limit - Maximum number of brands to return
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useFeaturedBrands(10);
+ * ```
+ */
+export function useFeaturedBrands(
+  limit?: number,
+  options?: Omit<UseQueryOptions<BrandResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: brandKeys.featured(),
+    queryFn: async (): Promise<BrandResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get('/api/v1/brands/featured', {
+        params: { limit },
+      });
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get brand owners
+ *
+ * @param brandId - Brand ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBrandOwners('brand-123');
+ * ```
+ */
+export function useBrandOwners(
+  brandId: string,
+  options?: Omit<UseQueryOptions<BrandOwnerResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: brandKeys.owners(brandId),
+    queryFn: async (): Promise<BrandOwnerResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/brands/${brandId}/owners`);
+      return response.data;
+    },
+    enabled: !!brandId,
+    ...options,
+  });
+}
+
+/**
+ * Get brand creator partnerships
+ *
+ * @param brandId - Brand ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBrandCreators('brand-123');
+ * ```
+ */
+export function useBrandCreators(
+  brandId: string,
+  options?: Omit<UseQueryOptions<BrandCreatorResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: brandKeys.creators(brandId),
+    queryFn: async (): Promise<BrandCreatorResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/brands/${brandId}/creators`);
+      return response.data;
+    },
+    enabled: !!brandId,
+    ...options,
+  });
+}
+
+/**
+ * Get brand rewards
+ *
+ * @param brandId - Brand ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBrandRewards('brand-123');
+ * ```
+ */
+export function useBrandRewards(
+  brandId: string,
+  options?: Omit<UseQueryOptions<RewardResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: brandKeys.rewards(brandId),
+    queryFn: async (): Promise<RewardResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/rewards/brand/${brandId}`);
+      return response.data;
+    },
+    enabled: !!brandId,
+    ...options,
+  });
+}
+
+/**
+ * Get events sponsored by a brand
+ *
+ * @param brandId - Brand ID
+ * @param upcoming - Whether to filter to upcoming events only (default: true)
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBrandSponsoredEvents('brand-123');
+ * ```
+ */
+export function useBrandSponsoredEvents(
+  brandId: string,
+  upcoming = true,
+  options?: Omit<UseQueryOptions<EventResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: brandKeys.events(brandId),
+    queryFn: async (): Promise<EventResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/brands/${brandId}/events`, {
+        params: { upcoming },
+      });
+      return response.data;
+    },
+    enabled: !!brandId,
+    ...options,
+  });
+}

package/src/api/queries/businesses.ts

@@ -1,6 +1,6 @@
 import { useQuery, UseQueryOptions } from '@tanstack/react-query';
 import { getApiClient } from '../client';
-import type { BusinessResponse, OfferResponse } from '../types';
+import type { BusinessResponse, OfferResponse, EventResponse } from '../types';
 
 // ============================================================================
 // QUERY KEY FACTORY
@@ -15,6 +15,7 @@ export const businessKeys = {
   featured: () => [...businessKeys.all, 'featured'] as const,
   nearby: (params?: NearbyBusinessParams) => [...businessKeys.all, 'nearby', params] as const,
   offers: (businessId: string) => [...businessKeys.detail(businessId), 'offers'] as const,
+  events: (businessId: string) => [...businessKeys.detail(businessId), 'events'] as const,
 };
 
 // ============================================================================
@@ -201,3 +202,31 @@ export function useBusinessOffers(
     ...options,
   });
 }
+
+/**
+ * Get all events for a specific business
+ *
+ * @param businessId - Business ID
+ * @param options - TanStack Query options
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useBusinessEvents('business-123');
+ * ```
+ */
+export function useBusinessEvents(
+  businessId: string,
+  options?: Omit<UseQueryOptions<EventResponse[]>, 'queryKey' | 'queryFn'>
+) {
+  return useQuery({
+    queryKey: businessKeys.events(businessId),
+    queryFn: async (): Promise<EventResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get(`/api/v1/businesses/${businessId}/events`);
+      // Handle wrapped response
+      return response.data?.data || response.data || [];
+    },
+    enabled: !!businessId,
+    ...options,
+  });
+}