@growsober/sdk 1.0.0

package/README.md

@@ -0,0 +1,276 @@
+# @growsober/sdk
+
+TypeScript SDK for the GrowSober API with TanStack Query hooks.
+
+## Installation
+
+```bash
+npm install @growsober/sdk @tanstack/react-query axios
+```
+
+## Quick Start
+
+```tsx
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { configureSDK, useCurrentUser, useHubs, useEvents } from '@growsober/sdk';
+
+// Configure SDK
+configureSDK({
+  baseURL: 'https://api.growsober.app',
+  getAccessToken: () => localStorage.getItem('accessToken'),
+  refreshAccessToken: async () => {
+    // Your token refresh logic
+    const response = await fetch('/refresh');
+    const { accessToken } = await response.json();
+    localStorage.setItem('accessToken', accessToken);
+    return accessToken;
+  },
+  onUnauthorized: () => {
+    window.location.href = '/login';
+  },
+});
+
+// Create query client
+const queryClient = new QueryClient();
+
+// Use in app
+function App() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <MyComponent />
+    </QueryClientProvider>
+  );
+}
+
+function MyComponent() {
+  const { data: user, isLoading } = useCurrentUser();
+  const { data: hubs } = useHubs();
+
+  if (isLoading) return <Loading />;
+
+  return <div>Welcome, {user?.name}</div>;
+}
+```
+
+## Available Hooks
+
+### Auth Hooks
+```typescript
+// Queries
+useMe()                    // Get current auth user
+
+// Mutations
+useRegister()              // Register new user
+useLogin()                 // Login with credentials
+useFirebaseAuth()          // Login with Firebase token
+useRefreshAuthToken()      // Refresh access token
+```
+
+### User Hooks
+```typescript
+// Queries
+useCurrentUser()           // Get current user profile
+useUser(id)                // Get user by ID
+usePublicProfile(id)       // Get public profile
+useMyBookmarks()           // Get bookmarked content
+useMyRedeemedOffers()      // Get redeemed offers
+
+// Mutations
+useUpdateCurrentUser()     // Update profile
+useCompleteOnboarding()    // Complete onboarding
+```
+
+### Hub Hooks
+```typescript
+// Queries
+useHubs(filters?)          // List hubs with filters
+useHub(id)                 // Get hub by ID
+useHubBySlug(slug)         // Get hub by slug
+useMyHubs()                // Get joined hubs
+useHubMembers(id)          // Get hub members
+useHubMembership(id)       // Check membership status
+
+// Mutations
+useCreateHub()             // Create new hub
+useUpdateHub()             // Update hub
+useDeleteHub()             // Delete hub
+useJoinHub()               // Join hub
+useLeaveHub()              // Leave hub
+useApproveMember()         // Approve member
+useUpdateMemberRole()      // Update member role
+useRemoveMember()          // Remove member
+```
+
+### Event Hooks
+```typescript
+// Queries
+useEvents(filters?)        // List events
+useEvent(id)               // Get event by ID
+useEventBySlug(slug)       // Get event by slug
+useUpcomingEvents()        // Get upcoming events
+useFeaturedEvents()        // Get featured events
+useEventBookings(id)       // Get event attendees
+
+// Mutations
+useCreateEvent()           // Create event
+useUpdateEvent()           // Update event
+useDeleteEvent()           // Delete event
+useCancelEvent()           // Cancel event
+usePublishEvent()          // Publish event
+```
+
+### Booking Hooks
+```typescript
+// Queries
+useBooking(id)             // Get booking
+useMyBookings()            // Get my bookings
+useBookingQrCode(id)       // Get QR code
+
+// Mutations
+useCreateBooking()         // Book event (RSVP)
+useCancelBooking()         // Cancel booking
+useCheckInBooking()        // Check in at event
+```
+
+### Library Hooks
+```typescript
+// Queries
+useLibraryContent(filters?) // List content
+useFeaturedContent()        // Featured content
+useLibraryCategories()      // Content categories
+useLibraryItem(id)          // Get content item
+useMyProgress()             // Get reading progress
+
+// Mutations
+useMarkViewed()             // Mark as viewed
+useMarkCompleted()          // Mark as completed
+useToggleLike()             // Like/unlike content
+useAddBookmark()            // Add bookmark
+useRemoveBookmark()         // Remove bookmark
+```
+
+### Business & Offer Hooks
+```typescript
+// Queries
+useBusinesses(filters?)     // List businesses
+useBusiness(id)             // Get business
+useFeaturedBusinesses()     // Featured businesses
+useNearbyBusinesses(lat, lng) // Nearby businesses
+useBusinessOffers(id)       // Get business offers
+useOffers(filters?)         // List offers
+useOffer(id)                // Get offer
+useCanRedeemOffer(id)       // Check redemption
+
+// Mutations
+useRedeemOffer()            // Redeem offer
+```
+
+### Subscription Hooks
+```typescript
+// Queries
+useSubscriptionPlans()      // Available plans
+useMySubscription()         // Current subscription
+
+// Mutations
+useCreateCheckout()         // Create Stripe checkout
+useCustomerPortal()         // Get portal URL
+useCancelSubscription()     // Cancel subscription
+useResumeSubscription()     // Resume subscription
+```
+
+### Notification Hooks
+```typescript
+// Queries
+useNotifications()          // List notifications
+useUnreadNotificationCount() // Unread count
+useNotification(id)         // Get notification
+
+// Mutations
+useMarkNotificationRead()   // Mark as read
+useMarkAllNotificationsRead() // Mark all read
+useDeleteNotification()     // Delete notification
+```
+
+### Support Hooks
+```typescript
+// Queries
+useCheckIns()              // List check-ins
+useTodayCheckIn()          // Today's check-in
+useCheckInStreak()         // Current streak
+useMoodLogs()              // List mood logs
+useWins()                  // List wins
+useWinsByCategory()        // Wins by category
+useHabits()                // List habits
+useReflections()           // List reflections
+
+// Mutations
+useCreateCheckIn()         // Create check-in
+useCreateMoodLog()         // Log mood
+useCreateWin()             // Log win
+useCreateHabit()           // Create habit
+useUpdateHabit()           // Update habit
+useDeleteHabit()           // Delete habit
+useCompleteHabit()         // Complete habit
+useCreateReflection()      // Create reflection
+```
+
+## Query Key Factories
+
+Each module exports query key factories for cache management:
+
+```typescript
+import { userKeys, hubKeys, eventKeys } from '@growsober/sdk';
+
+// Invalidate all user queries
+queryClient.invalidateQueries({ queryKey: userKeys.all });
+
+// Invalidate specific hub
+queryClient.invalidateQueries({ queryKey: hubKeys.detail('hub-id') });
+
+// Prefetch events
+queryClient.prefetchQuery({
+  queryKey: eventKeys.list(),
+  queryFn: () => fetchEvents(),
+});
+```
+
+## Types
+
+All types are re-exported from `@growsober/types`:
+
+```typescript
+import type {
+  UserResponse,
+  HubResponse,
+  EventResponse,
+  BookingResponse,
+  // ... etc
+} from '@growsober/sdk';
+```
+
+## Error Handling
+
+```typescript
+const { mutate: createEvent, error } = useCreateEvent({
+  onError: (error) => {
+    console.error('Failed to create event:', error.message);
+  },
+});
+```
+
+## Development
+
+```bash
+# Type check
+npm run type-check
+
+# Build
+npm run build
+
+# Watch mode
+npm run build:watch
+```
+
+## License
+
+UNLICENSED - Proprietary

package/dist/__tests__/e2e.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * GrowSober API E2E Tests
+ *
+ * Tests all SDK endpoints against the real API.
+ * Run with: npx ts-node src/__tests__/e2e.test.ts
+ */
+export {};