@growsober/sdk 1.0.5 → 1.0.8

package/src/api/types.ts

@@ -3,6 +3,11 @@
  *
  * All types are derived from the @growsober/types package which is auto-generated
  * from the API OpenAPI specification. This ensures single source of truth from Prisma.
+ *
+ * To regenerate types:
+ * 1. Start the API: cd ../growsober-api && npm run start:dev
+ * 2. Generate types: cd ../growsober-types && npm run generate && npm run build
+ * 3. Rebuild SDK: npm run build
  */
 
 import type { paths, components } from '@growsober/types';
@@ -52,6 +57,40 @@ export type PathParams<
   ? P
   : Record<string, never>;
 
+// ============================================================================
+// ENUM TYPES (extracted from generated schemas - single source of truth)
+// ============================================================================
+
+// Business/Venue type (used for both Business and Venue models)
+export type BusinessType = components['schemas']['BusinessResponseDto']['type'];
+
+// Ownership roles
+export type VenueOwnerRole = components['schemas']['VenueOwnerResponseDto']['role'];
+export type BrandOwnerRole = components['schemas']['BrandOwnerResponseDto']['role'];
+
+// Event types
+export type GatheringType = NonNullable<components['schemas']['EventResponseDto']['gatheringType']>;
+export type EventVisibility = components['schemas']['EventResponseDto']['visibility'];
+export type EventStatus = components['schemas']['EventResponseDto']['status'];
+
+// Chat roles
+export type ChatMemberRole = components['schemas']['ChatMemberResponseDto']['role'];
+
+// Content status
+export type ContentStatus = components['schemas']['LibraryContentResponseDto']['contentStatus'];
+
+// Badge types
+export type BadgeType = components['schemas']['BadgeResponseDto']['type'];
+
+// Notification types
+export type NotificationType = components['schemas']['NotificationResponseDto']['type'];
+
+// Streak types
+export type StreakType = components['schemas']['StreakResponseDto']['type'];
+
+// Craving triggers
+export type CravingTrigger = NonNullable<components['schemas']['CravingLogResponseDto']['triggerType']>;
+
 // ============================================================================
 // AUTH TYPES
 // ============================================================================
@@ -105,15 +144,120 @@ export type CreateBookingRequest = components['schemas']['CreateBookingDto'];
 export type LibraryContentResponse = components['schemas']['LibraryContentResponseDto'];
 export type LibraryContentDetailResponse = components['schemas']['LibraryContentDetailResponseDto'];
 export type LibraryProgressResponse = components['schemas']['LibraryProgressResponseDto'];
+export type ContentType = components['schemas']['LibraryContentResponseDto']['type'];
 
 // ============================================================================
-// BUSINESS & OFFER TYPES
+// BUSINESS & OFFER TYPES (Legacy)
 // ============================================================================
 
 export type BusinessResponse = components['schemas']['BusinessResponseDto'];
 export type OfferResponse = components['schemas']['OfferResponseDto'];
 export type RedeemOfferRequest = components['schemas']['RedeemOfferDto'];
 
+// ============================================================================
+// VENUE TYPES (from generated OpenAPI types)
+// ============================================================================
+
+export type VenueResponse = components['schemas']['VenueResponseDto'];
+export type VenueOwnerResponse = components['schemas']['VenueOwnerResponseDto'];
+
+// Request types for venue operations
+export interface CreateVenueRequest {
+  name: string;
+  slug: string;
+  description?: string;
+  type: BusinessType;
+  hasAfDrinks?: boolean;
+  isAfVenue?: boolean;
+  afHighlights?: string[];
+  address?: string;
+  cityId?: string;
+  locationLat?: number;
+  locationLong?: number;
+  phone?: string;
+  email?: string;
+  website?: string;
+  instagram?: string;
+  profileImage?: string;
+  bannerImage?: string;
+  photos?: string[];
+  openingHours?: Record<string, string>;
+}
+
+export interface UpdateVenueRequest extends Partial<CreateVenueRequest> {}
+
+export interface AddVenueOwnerRequest {
+  userId: string;
+  role: VenueOwnerRole;
+}
+
+// ============================================================================
+// CREATOR TYPES (from generated OpenAPI types)
+// ============================================================================
+
+export type CreatorResponse = components['schemas']['CreatorResponseDto'];
+export type CreatorAvailabilityResponse = components['schemas']['CreatorAvailabilityResponseDto'];
+
+export interface CreateCreatorRequest {
+  slug: string;
+  displayName: string;
+  bio?: string;
+  avatarUrl?: string;
+  cityIds?: string[];
+  canFacilitate?: boolean;
+  canCreateContent?: boolean;
+  isInfluencer?: boolean;
+  specialties?: string[];
+  certifications?: string[];
+  sessionRate?: number;
+}
+
+export interface UpdateCreatorRequest extends Partial<CreateCreatorRequest> {}
+
+export interface CreateAvailabilityRequest {
+  dayOfWeek?: number;
+  startTime: string;
+  endTime: string;
+  timezone: string;
+  isRecurring?: boolean;
+  specificDate?: string;
+}
+
+// ============================================================================
+// BRAND TYPES (from generated OpenAPI types)
+// ============================================================================
+
+export type BrandResponse = components['schemas']['BrandResponseDto'];
+export type BrandOwnerResponse = components['schemas']['BrandOwnerResponseDto'];
+export type BrandCreatorResponse = components['schemas']['BrandCreatorResponseDto'];
+
+export interface CreateBrandRequest {
+  slug: string;
+  name: string;
+  description?: string;
+  logoUrl?: string;
+  bannerUrl?: string;
+  primaryColor?: string;
+  website?: string;
+  email?: string;
+  instagram?: string;
+}
+
+export interface UpdateBrandRequest extends Partial<CreateBrandRequest> {}
+
+export interface AddBrandOwnerRequest {
+  userId: string;
+  role: BrandOwnerRole;
+}
+
+export interface AddBrandCreatorRequest {
+  creatorId: string;
+  commissionRate?: number;
+  isActive?: boolean;
+  startDate?: string;
+  endDate?: string;
+}
+
 // ============================================================================
 // SUBSCRIPTION TYPES
 // ============================================================================
@@ -172,6 +316,11 @@ export type ReflectionResponse = components['schemas']['ReflectionResponseDto'];
 export type CreateReflectionRequest = components['schemas']['CreateReflectionDto'];
 export type UpdateReflectionRequest = components['schemas']['UpdateReflectionDto'];
 
+// Cravings
+export type CravingLogResponse = components['schemas']['CravingLogResponseDto'];
+export type LogCravingRequest = components['schemas']['LogCravingDto'];
+export type CravingStatsResponse = components['schemas']['CravingStatsDto'];
+
 // ============================================================================
 // MAP TYPES
 // ============================================================================
@@ -236,6 +385,173 @@ export type AdminCreateContentRequest = components['schemas']['AdminCreateConten
 export type AdminCreateBusinessRequest = components['schemas']['AdminCreateBusinessDto'];
 export type AdminOverviewStatsResponse = components['schemas']['AdminOverviewStatsDto'];
 
+// ============================================================================
+// BADGE TYPES (from generated OpenAPI types)
+// ============================================================================
+
+export type BadgeResponse = components['schemas']['BadgeResponseDto'];
+export type UserBadgeResponse = components['schemas']['UserBadgeResponseDto'];
+export type BadgeProgressResponse = components['schemas']['BadgeProgressDto'];
+
+// Alias for SDK consistency
+export interface BadgeWithProgress {
+  badge: BadgeResponse;
+  currentProgress: number;
+  requiredProgress: number;
+  percentComplete: number;
+  isEarned: boolean;
+}
+
+// ============================================================================
+// UNIFIED REWARD TYPES
+// ============================================================================
+
+// RedeemType enum - extracted from Prisma via API
+export type RedeemType = 'IN_PERSON' | 'ONLINE' | 'BOTH';
+
+// Reward response with relations
+export interface RewardResponse {
+  id: string;
+  venueId: string | null;
+  brandId: string | null;
+  badgeId: string;
+  title: string;
+  description: string | null;
+  code: string | null;
+  redeemType: RedeemType;
+  maxRedemptions: number | null;
+  redemptionsUsed: number;
+  perUserLimit: number;
+  validFrom: string | null;
+  validUntil: string | null;
+  isActive: boolean;
+  createdAt: string;
+  badge: {
+    id: string;
+    name: string;
+    slug: string;
+    icon: string | null;
+  };
+  venue?: {
+    id: string;
+    name: string;
+    slug: string;
+    profileImage: string | null;
+    address: string | null;
+  } | null;
+  brand?: {
+    id: string;
+    name: string;
+    slug: string;
+    logoUrl: string | null;
+  } | null;
+}
+
+export interface RewardRedemptionResponse {
+  id: string;
+  userId: string;
+  rewardId: string;
+  redeemedAt: string;
+  verifiedAt: string | null;
+  verifiedBy: string | null;
+  codeUsed: string | null;
+  reward: RewardResponse;
+}
+
+export interface CreateRewardRequest {
+  badgeId: string;
+  title: string;
+  description?: string;
+  code?: string;
+  redeemType?: RedeemType;
+  maxRedemptions?: number;
+  perUserLimit?: number;
+  validFrom?: string;
+  validUntil?: string;
+}
+
+export interface UpdateRewardRequest {
+  title?: string;
+  description?: string;
+  code?: string;
+  redeemType?: RedeemType;
+  maxRedemptions?: number;
+  perUserLimit?: number;
+  validFrom?: string;
+  validUntil?: string;
+  isActive?: boolean;
+}
+
+export interface UserWalletResponse {
+  badges: Array<{
+    id: string;
+    badgeId: string;
+    userId: string;
+    awardedAt: string;
+    badge: BadgeResponse;
+    availableRewards: RewardResponse[];
+    redeemedRewards: Array<RewardRedemptionResponse & { qrToken: string }>;
+  }>;
+  stats: {
+    totalBadges: number;
+    totalAvailableRewards: number;
+    totalRedeemedRewards: number;
+  };
+}
+
+// ============================================================================
+// LEGACY TYPES (deprecated - use unified types)
+// ============================================================================
+
+/** @deprecated Use RewardResponse instead */
+export interface PartnerRewardResponse {
+  id: string;
+  businessId: string;
+  badgeId: string;
+  title: string;
+  description: string | null;
+  code: string | null;
+  maxRedemptions: number | null;
+  redemptionsUsed: number;
+  perUserLimit: number;
+  validFrom: string;
+  validUntil: string | null;
+  isActive: boolean;
+  createdAt: string;
+  badge: {
+    id: string;
+    name: string;
+    slug: string;
+    icon: string | null;
+  };
+  business: {
+    id: string;
+    name: string;
+    profileImage: string | null;
+  };
+}
+
+/** @deprecated Use RewardRedemptionResponse instead */
+export interface PartnerRewardRedemptionResponse {
+  id: string;
+  userId: string;
+  partnerRewardId: string;
+  redeemedAt: string;
+  verifiedAt: string | null;
+  partnerReward: PartnerRewardResponse;
+}
+
+/** @deprecated Use CreateRewardRequest instead */
+export interface CreatePartnerRewardRequest {
+  badgeId: string;
+  title: string;
+  description?: string;
+  code?: string;
+  maxRedemptions?: number;
+  perUserLimit?: number;
+  validUntil?: string;
+}
+
 // ============================================================================
 // RE-EXPORTS
 // ============================================================================

package/src/api/utils/eventGrouping.ts

@@ -0,0 +1,181 @@
+/**
+ * Event Grouping Utilities
+ *
+ * Utilities for organizing events by time of day.
+ * Used in the Gatherings screen to show events grouped by
+ * Morning, Afternoon, and Evening.
+ *
+ * @module api/utils/eventGrouping
+ */
+
+import { EventResponse } from '../types';
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export type TimeOfDay = 'MORNING' | 'AFTERNOON' | 'EVENING';
+
+export interface GroupedEvents {
+  morning: EventResponse[];
+  afternoon: EventResponse[];
+  evening: EventResponse[];
+}
+
+export interface TimeOfDayInfo {
+  key: TimeOfDay;
+  label: string;
+  emoji: string;
+  hours: { start: number; end: number };
+}
+
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+
+export const TIME_OF_DAY_CONFIG: Record<TimeOfDay, TimeOfDayInfo> = {
+  MORNING: {
+    key: 'MORNING',
+    label: 'Morning',
+    emoji: '',
+    hours: { start: 5, end: 11 }, // 5:00 AM - 11:59 AM
+  },
+  AFTERNOON: {
+    key: 'AFTERNOON',
+    label: 'Afternoon',
+    emoji: '',
+    hours: { start: 12, end: 16 }, // 12:00 PM - 4:59 PM
+  },
+  EVENING: {
+    key: 'EVENING',
+    label: 'Evening',
+    emoji: '',
+    hours: { start: 17, end: 4 }, // 5:00 PM - 4:59 AM (next day)
+  },
+};
+
+// ============================================================================
+// FUNCTIONS
+// ============================================================================
+
+/**
+ * Get time of day for a given date
+ *
+ * @param date - Date string or Date object
+ * @returns TimeOfDay - MORNING, AFTERNOON, or EVENING
+ *
+ * @example
+ * ```tsx
+ * const timeOfDay = getTimeOfDay('2024-03-15T10:00:00Z');
+ * console.log(timeOfDay); // 'MORNING'
+ * ```
+ */
+export function getTimeOfDay(date: Date | string): TimeOfDay {
+  const d = typeof date === 'string' ? new Date(date) : date;
+  const hour = d.getHours();
+
+  if (hour >= 5 && hour < 12) return 'MORNING';
+  if (hour >= 12 && hour < 17) return 'AFTERNOON';
+  return 'EVENING';
+}
+
+/**
+ * Get label for time of day
+ *
+ * @param timeOfDay - TimeOfDay enum value
+ * @returns Human-readable label
+ *
+ * @example
+ * ```tsx
+ * const label = getTimeOfDayLabel('MORNING');
+ * console.log(label); // 'Morning'
+ * ```
+ */
+export function getTimeOfDayLabel(timeOfDay: TimeOfDay): string {
+  return TIME_OF_DAY_CONFIG[timeOfDay].label;
+}
+
+/**
+ * Group events by time of day
+ *
+ * @param events - Array of events to group
+ * @returns GroupedEvents object with morning, afternoon, and evening arrays
+ *
+ * @example
+ * ```tsx
+ * import { useUpcomingEvents, groupEventsByTimeOfDay } from '@growsober/sdk';
+ *
+ * function GatheringsList() {
+ *   const { data: events } = useUpcomingEvents(30);
+ *   const grouped = useMemo(() => {
+ *     if (!events) return null;
+ *     return groupEventsByTimeOfDay(events);
+ *   }, [events]);
+ *
+ *   return (
+ *     <SectionList
+ *       sections={[
+ *         { title: 'Morning', data: grouped?.morning || [] },
+ *         { title: 'Afternoon', data: grouped?.afternoon || [] },
+ *         { title: 'Evening', data: grouped?.evening || [] },
+ *       ]}
+ *       ...
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export function groupEventsByTimeOfDay(events: EventResponse[]): GroupedEvents {
+  const grouped: GroupedEvents = {
+    morning: [],
+    afternoon: [],
+    evening: [],
+  };
+
+  for (const event of events) {
+    const timeOfDay = getTimeOfDay(event.startDate);
+    switch (timeOfDay) {
+      case 'MORNING':
+        grouped.morning.push(event);
+        break;
+      case 'AFTERNOON':
+        grouped.afternoon.push(event);
+        break;
+      case 'EVENING':
+        grouped.evening.push(event);
+        break;
+    }
+  }
+
+  return grouped;
+}
+
+/**
+ * Convert grouped events to section list data format
+ *
+ * @param events - Array of events to group
+ * @returns Array of sections with title and data
+ *
+ * @example
+ * ```tsx
+ * const sections = getEventSections(events);
+ * // [
+ * //   { title: 'Morning', data: [...] },
+ * //   { title: 'Afternoon', data: [...] },
+ * //   { title: 'Evening', data: [...] },
+ * // ]
+ * ```
+ */
+export function getEventSections(events: EventResponse[]): Array<{
+  title: string;
+  timeOfDay: TimeOfDay;
+  data: EventResponse[];
+}> {
+  const grouped = groupEventsByTimeOfDay(events);
+
+  return [
+    { title: 'Morning', timeOfDay: 'MORNING' as TimeOfDay, data: grouped.morning },
+    { title: 'Afternoon', timeOfDay: 'AFTERNOON' as TimeOfDay, data: grouped.afternoon },
+    { title: 'Evening', timeOfDay: 'EVENING' as TimeOfDay, data: grouped.evening },
+  ].filter(section => section.data.length > 0);
+}

package/src/index.ts

@@ -55,3 +55,9 @@ export * from './api/queries';
 
 export * from './api/mutations';
 
+// ============================================================================
+// UTILITIES
+// ============================================================================
+
+export * from './api/utils/eventGrouping';
+