@growsober/sdk 1.0.0

package/src/api/types.ts

@@ -0,0 +1,596 @@
+/**
+ * Type extraction utilities for OpenAPI-generated types
+ *
+ * This file provides type-safe helpers to extract request/response types
+ * from the @growsober/types package.
+ */
+
+import type { paths, components } from '@growsober/types';
+
+// ============================================================================
+// TYPE EXTRACTION HELPERS
+// ============================================================================
+
+/**
+ * Extract request body type for a given endpoint and method
+ */
+export type RequestBody<
+  Path extends keyof paths,
+  Method extends keyof paths[Path]
+> = paths[Path][Method] extends { requestBody: { content: { 'application/json': infer T } } }
+  ? T
+  : never;
+
+/**
+ * Extract response type for a given endpoint, method, and status code
+ */
+export type ResponseBody<
+  Path extends keyof paths,
+  Method extends keyof paths[Path],
+  Status extends number = 200
+> = paths[Path][Method] extends { responses: { [K in Status]: { content: { 'application/json': infer T } } } }
+  ? T
+  : never;
+
+/**
+ * Extract query parameters type for a given endpoint and method
+ */
+export type QueryParams<
+  Path extends keyof paths,
+  Method extends keyof paths[Path]
+> = paths[Path][Method] extends { parameters: { query?: infer Q } }
+  ? Q
+  : Record<string, never>;
+
+/**
+ * Extract path parameters type for a given endpoint and method
+ */
+export type PathParams<
+  Path extends keyof paths,
+  Method extends keyof paths[Path]
+> = paths[Path][Method] extends { parameters: { path: infer P } }
+  ? P
+  : Record<string, never>;
+
+// ============================================================================
+// AUTH TYPES
+// ============================================================================
+
+export type RegisterRequest = components['schemas']['RegisterDto'];
+export type AuthResponse = components['schemas']['AuthResponseDto'];
+export type LoginRequest = components['schemas']['LoginDto'];
+export type RefreshTokenRequest = components['schemas']['RefreshTokenDto'];
+export type TokenResponse = components['schemas']['TokenResponseDto'];
+export type FirebaseAuthRequest = components['schemas']['FirebaseAuthDto'];
+
+// ============================================================================
+// USER TYPES
+// ============================================================================
+
+export type UserResponse = components['schemas']['UserResponseDto'];
+export type UserPublicResponse = components['schemas']['UserPublicResponseDto'];
+export type CreateUserRequest = components['schemas']['CreateUserDto'];
+export type UpdateUserRequest = components['schemas']['UpdateUserDto'];
+
+// ============================================================================
+// HUB TYPES
+// ============================================================================
+
+export type HubResponse = components['schemas']['HubResponseDto'];
+export type CreateHubRequest = components['schemas']['CreateHubDto'];
+export type UpdateHubRequest = components['schemas']['UpdateHubDto'];
+
+// HubMemberResponse - will be available when hub membership endpoints are fully implemented
+// For now, define inline type based on API response structure
+export interface HubMemberResponse {
+  id: string;
+  hubId: string;
+  userId: string;
+  role: 'MEMBER' | 'MODERATOR' | 'ADMIN' | 'OWNER';
+  status: 'PENDING' | 'APPROVED' | 'REJECTED';
+  joinedAt: string;
+  user?: UserPublicResponse;
+}
+
+// ============================================================================
+// EVENT TYPES
+// ============================================================================
+
+export type EventResponse = components['schemas']['EventResponseDto'];
+export type CreateEventRequest = components['schemas']['CreateEventDto'];
+export type UpdateEventRequest = components['schemas']['UpdateEventDto'];
+
+// ============================================================================
+// BOOKING TYPES
+// ============================================================================
+
+export type BookingResponse = components['schemas']['BookingResponseDto'];
+export type CreateBookingRequest = components['schemas']['CreateBookingDto'];
+
+// ============================================================================
+// LIBRARY TYPES
+// ============================================================================
+
+export type LibraryContentResponse = components['schemas']['LibraryContentResponseDto'];
+export type LibraryContentDetailResponse = components['schemas']['LibraryContentDetailResponseDto'];
+export type LibraryProgressResponse = components['schemas']['LibraryProgressResponseDto'];
+
+// ============================================================================
+// BUSINESS & OFFER TYPES
+// ============================================================================
+
+export type BusinessResponse = components['schemas']['BusinessResponseDto'];
+export type OfferResponse = components['schemas']['OfferResponseDto'];
+export type RedeemOfferRequest = components['schemas']['RedeemOfferDto'];
+
+// ============================================================================
+// SUBSCRIPTION TYPES
+// ============================================================================
+
+export type SubscriptionResponse = components['schemas']['SubscriptionResponseDto'];
+export type CreateCheckoutRequest = components['schemas']['CreateCheckoutDto'];
+
+// ============================================================================
+// NOTIFICATION TYPES
+// ============================================================================
+
+export type NotificationResponse = components['schemas']['NotificationResponseDto'];
+
+// ============================================================================
+// DEVICE TOKEN TYPES
+// ============================================================================
+
+export type RegisterDeviceTokenRequest = components['schemas']['RegisterDeviceDto'];
+
+// ============================================================================
+// SUPPORT TYPES (Placeholder - will be generated when support module is registered)
+// ============================================================================
+
+// These types will be generated from OpenAPI once the support module endpoints
+// are registered in the API. For now, we define placeholder interfaces.
+
+export interface DailyCheckInResponse {
+  id: string;
+  userId: string;
+  date: string;
+  mood: number | null;
+  energy: number | null;
+  stayedSober: boolean | null;
+  triggers: string[];
+  copingUsed: string[];
+  notes: string | null;
+  gratitude: string[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface CreateCheckInRequest {
+  date: string;
+  mood?: number;
+  energy?: number;
+  stayedSober?: boolean;
+  triggers?: string[];
+  copingUsed?: string[];
+  notes?: string;
+  gratitude?: string[];
+}
+
+export interface UpdateCheckInRequest {
+  mood?: number;
+  energy?: number;
+  stayedSober?: boolean;
+  triggers?: string[];
+  copingUsed?: string[];
+  notes?: string;
+  gratitude?: string[];
+}
+
+export interface CheckInStreakResponse {
+  currentStreak: number;
+  longestStreak: number;
+  totalCheckIns: number;
+}
+
+export interface MoodLogResponse {
+  id: string;
+  userId: string;
+  mood: number;
+  notes?: string;
+  triggers?: string[];
+  createdAt: string;
+}
+
+export interface CreateMoodLogRequest {
+  mood: number;
+  notes?: string;
+  triggers?: string[];
+}
+
+export interface WinResponse {
+  id: string;
+  userId: string;
+  title: string;
+  description?: string;
+  category: string;
+  imageUrl?: string;
+  createdAt: string;
+}
+
+export interface CreateWinRequest {
+  title: string;
+  description?: string;
+  category: string;
+  imageUrl?: string;
+}
+
+export interface HabitResponse {
+  id: string;
+  userId: string;
+  name: string;
+  description?: string;
+  icon?: string;
+  color?: string;
+  frequency: string;
+  targetDays: number[];
+  targetCount: number;
+  currentStreak: number;
+  longestStreak: number;
+  totalCompletions: number;
+  isActive: boolean;
+  isPaused: boolean;
+  reminderTime?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface CreateHabitRequest {
+  name: string;
+  description?: string;
+  icon?: string;
+  color?: string;
+  frequency: string;
+  targetDays?: number[];
+  targetCount?: number;
+  reminderTime?: string;
+}
+
+export interface UpdateHabitRequest {
+  name?: string;
+  description?: string;
+  icon?: string;
+  color?: string;
+  frequency?: string;
+  targetDays?: number[];
+  targetCount?: number;
+  isActive?: boolean;
+  isPaused?: boolean;
+  reminderTime?: string;
+}
+
+export interface ReflectionResponse {
+  id: string;
+  userId: string;
+  prompt: string;
+  content: string;
+  mood?: number;
+  createdAt: string;
+}
+
+export interface CreateReflectionRequest {
+  prompt: string;
+  content: string;
+  mood?: number;
+}
+
+export interface UserStreakResponse {
+  id: string;
+  userId: string;
+  type: string;
+  currentStreak: number;
+  longestStreak: number;
+  totalCheckIns: number;
+  lastActivityDate: string;
+}
+
+// ============================================================================
+// GAMIFICATION TYPES (Placeholder - will be generated when gamification module is registered)
+// ============================================================================
+
+export interface BadgeResponse {
+  id: string;
+  appId: string;
+  name: string;
+  description?: string;
+  iconUrl?: string;
+  type: string;
+  threshold?: number;
+  isSecret: boolean;
+  isActive: boolean;
+  sortOrder: number;
+  createdAt: string;
+}
+
+export interface UserBadgeResponse {
+  id: string;
+  userId: string;
+  badgeId: string;
+  awardedAt: string;
+  badge?: BadgeResponse;
+}
+
+// ============================================================================
+// MAP TYPES (Placeholder - will be generated when map module is registered)
+// ============================================================================
+
+export interface MapUserResponse {
+  id: string;
+  name: string;
+  avatar?: string;
+  locationLat: number;
+  locationLong: number;
+}
+
+export interface MapHubResponse {
+  id: string;
+  name: string;
+  slug: string;
+  locationLat: number;
+  locationLong: number;
+  memberCount: number;
+}
+
+export interface MapEventResponse {
+  id: string;
+  title: string;
+  slug: string;
+  locationLat: number;
+  locationLong: number;
+  startDate: string;
+  attendeeCount: number;
+}
+
+export interface MapBusinessResponse {
+  id: string;
+  name: string;
+  slug?: string;
+  locationLat: number;
+  locationLong: number;
+  type: string;
+  hasAfDrinks: boolean;
+}
+
+// ============================================================================
+// AMBASSADOR TYPES
+// ============================================================================
+
+export type AmbassadorStatus = 'PENDING' | 'ACTIVE' | 'INACTIVE' | 'ALUMNI';
+
+export interface AmbassadorResponse {
+  id: string;
+  userId: string;
+  hubId: string | null;
+  title: string | null;
+  bio: string | null;
+  status: AmbassadorStatus;
+  isVerified: boolean;
+  isFoundingAmbassador: boolean;
+  eventsHosted: number;
+  membersRecruited: number;
+  rewardPoints: number;
+  createdAt: string;
+  approvedAt: string | null;
+  user?: {
+    id: string;
+    name: string | null;
+    profileImage: string | null;
+  };
+  hub?: {
+    id: string;
+    name: string;
+    slug: string;
+    city?: string;
+    whatsappGroupUrl?: string;
+  } | null;
+}
+
+export interface AmbassadorLeaderboardResponse {
+  id: string;
+  userId: string;
+  userName: string | null;
+  profileImage: string | null;
+  hubName: string | null;
+  eventsHosted: number;
+  membersRecruited: number;
+  rewardPoints: number;
+  isFoundingAmbassador: boolean;
+  rank: number;
+}
+
+export interface ApplyAmbassadorRequest {
+  hubId?: string;
+  motivation: string;
+  bio?: string;
+}
+
+export interface UpdateAmbassadorRequest {
+  hubId?: string;
+  title?: string;
+  bio?: string;
+  status?: AmbassadorStatus;
+  isVerified?: boolean;
+  isFoundingAmbassador?: boolean;
+}
+
+// ============================================================================
+// GROW90 TYPES
+// ============================================================================
+
+export type Grow90Status = 'ACTIVE' | 'COMPLETED' | 'PAUSED' | 'ABANDONED';
+
+export interface Grow90EnrollmentResponse {
+  id: string;
+  userId: string;
+  startDate: string;
+  targetEndDate: string;
+  actualEndDate: string | null;
+  currentDay: number;
+  completedDays: number;
+  missedDays: number;
+  status: Grow90Status;
+  completedAt: string | null;
+  dailyReminderTime: string;
+  weeklyCallDay: string | null;
+  createdAt: string;
+  progressPercentage: number;
+  daysRemaining: number;
+}
+
+export interface Grow90ProgressResponse {
+  id: string;
+  dayNumber: number;
+  date: string;
+  isCompleted: boolean;
+  completedAt: string | null;
+  morningCheckIn: boolean;
+  eveningCheckIn: boolean;
+  contentViewed: boolean;
+  journalEntry: string | null;
+  gratitudeList: string[];
+  morningMood: number | null;
+  eveningMood: number | null;
+  createdAt: string;
+}
+
+export interface Grow90TodayResponse {
+  progress: Grow90ProgressResponse | null;
+  dayNumber: number;
+  dailyContent: {
+    title: string;
+    message: string;
+    tip: string;
+    affirmation: string;
+    morningMessage?: string;
+    eveningReflection?: string;
+    journalPrompt?: string;
+    theme?: string;
+  };
+  tasks: {
+    morningCheckIn: boolean;
+    eveningCheckIn: boolean;
+    contentViewed: boolean;
+    journalEntry: boolean;
+    gratitude: boolean;
+  };
+}
+
+export interface Grow90StatsResponse {
+  completedDays: number;
+  currentStreak: number;
+  longestStreak: number;
+  averageMood: number | null;
+  completionRate: number;
+  journalEntriesCount: number;
+}
+
+export interface EnrollGrow90Request {
+  dailyReminderTime?: string;
+  weeklyCallDay?: string;
+  stripePaymentId?: string;
+}
+
+export interface UpdateGrow90ProgressRequest {
+  morningCheckIn?: boolean;
+  eveningCheckIn?: boolean;
+  contentViewed?: boolean;
+  journalEntry?: string;
+  gratitudeList?: string[];
+  morningMood?: number;
+  eveningMood?: number;
+}
+
+export interface UpdateGrow90SettingsRequest {
+  dailyReminderTime?: string;
+  weeklyCallDay?: string;
+}
+
+// ============================================================================
+// EVENT CHAT TYPES
+// ============================================================================
+
+export type EventMessageType = 'TEXT' | 'IMAGE' | 'SYSTEM' | 'ANNOUNCEMENT';
+export type ChatMemberRole = 'MEMBER' | 'MODERATOR' | 'HOST';
+
+export interface EventChatResponse {
+  id: string;
+  eventId: string;
+  messageCount: number;
+  memberCount: number;
+  isActive: boolean;
+  isLocked: boolean;
+  lastMessageAt?: string;
+  createdAt: string;
+  eventTitle?: string;
+  eventStartDate?: string;
+}
+
+export interface ChatMemberResponse {
+  id: string;
+  chatId: string;
+  userId: string;
+  role: ChatMemberRole;
+  nickname?: string;
+  isMuted: boolean;
+  lastReadAt?: string;
+  joinedAt: string;
+  userName?: string;
+  userImage?: string;
+}
+
+export interface MessageResponse {
+  id: string;
+  chatId: string;
+  userId: string;
+  content: string;
+  messageType: EventMessageType;
+  imageUrl?: string;
+  replyToId?: string;
+  isEdited: boolean;
+  isDeleted: boolean;
+  createdAt: string;
+  updatedAt?: string;
+  userName?: string;
+  userImage?: string;
+  replyToContent?: string;
+  replyToUserName?: string;
+}
+
+export interface PaginatedMessagesResponse {
+  messages: MessageResponse[];
+  total: number;
+  hasMore: boolean;
+  nextCursor?: string;
+}
+
+export interface SendMessageRequest {
+  content: string;
+  messageType?: EventMessageType;
+  imageUrl?: string;
+  replyToId?: string;
+}
+
+export interface UpdateMessageRequest {
+  content: string;
+}
+
+export interface UpdateChatSettingsRequest {
+  isLocked?: boolean;
+  isActive?: boolean;
+}
+
+export interface UpdateMemberSettingsRequest {
+  isMuted?: boolean;
+  nickname?: string;
+}
+
+// Re-export paths and components for advanced usage
+export type { paths, components };

package/src/index.ts

@@ -0,0 +1,57 @@
+/**
+ * GrowSober SDK
+ *
+ * TypeScript SDK for the GrowSober API with TanStack Query hooks.
+ *
+ * @example
+ * ```tsx
+ * import { configureSDK, useCurrentUser, useLogin } from '@growsober/sdk';
+ *
+ * // Configure SDK with your API base URL and token management
+ * configureSDK({
+ *   baseURL: 'https://api.growsober.app',
+ *   getAccessToken: () => localStorage.getItem('accessToken'),
+ *   refreshAccessToken: async () => {
+ *     // Your token refresh logic
+ *     return newAccessToken;
+ *   },
+ *   onUnauthorized: () => {
+ *     // Handle unauthorized access
+ *     window.location.href = '/login';
+ *   },
+ * });
+ *
+ * // Use hooks in your components
+ * function App() {
+ *   const { data: user } = useCurrentUser();
+ *   const { mutate: login } = useLogin();
+ *   // ...
+ * }
+ * ```
+ */
+
+// ============================================================================
+// API CLIENT
+// ============================================================================
+
+export { configureSDK, getApiClient } from './api/client';
+export type { SDKConfig } from './api/client';
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export * from './api/types';
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+export * from './api/queries';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+export * from './api/mutations';
+