@growsober/sdk 1.0.0

package/src/api/client.ts

@@ -0,0 +1,71 @@
+import axios, { AxiosInstance, AxiosError, InternalAxiosRequestConfig } from 'axios';
+
+export interface SDKConfig {
+  baseURL: string;
+  getAccessToken: () => string | null | Promise<string | null>;
+  refreshAccessToken?: () => Promise<string>;
+  onUnauthorized?: () => void;
+}
+
+let config: SDKConfig | null = null;
+let apiClient: AxiosInstance | null = null;
+
+export function configureSDK(sdkConfig: SDKConfig): void {
+  config = sdkConfig;
+  apiClient = createApiClient(sdkConfig);
+}
+
+export function getApiClient(): AxiosInstance {
+  if (!apiClient) {
+    throw new Error('SDK not configured. Call configureSDK() first.');
+  }
+  return apiClient;
+}
+
+function createApiClient(sdkConfig: SDKConfig): AxiosInstance {
+  const client = axios.create({
+    baseURL: sdkConfig.baseURL,
+    headers: {
+      'Content-Type': 'application/json',
+    },
+  });
+
+  // Request interceptor - add auth token
+  client.interceptors.request.use(
+    async (requestConfig: InternalAxiosRequestConfig) => {
+      const token = await sdkConfig.getAccessToken();
+      if (token) {
+        requestConfig.headers.Authorization = `Bearer ${token}`;
+      }
+      return requestConfig;
+    },
+    (error) => Promise.reject(error)
+  );
+
+  // Response interceptor - handle 401
+  client.interceptors.response.use(
+    (response) => response,
+    async (error: AxiosError) => {
+      if (error.response?.status === 401) {
+        if (sdkConfig.refreshAccessToken) {
+          try {
+            const newToken = await sdkConfig.refreshAccessToken();
+            if (newToken && error.config) {
+              error.config.headers.Authorization = `Bearer ${newToken}`;
+              return client.request(error.config);
+            }
+          } catch {
+            sdkConfig.onUnauthorized?.();
+          }
+        } else {
+          sdkConfig.onUnauthorized?.();
+        }
+      }
+      return Promise.reject(error);
+    }
+  );
+
+  return client;
+}
+
+export { apiClient };

package/src/api/mutations/admin.ts

@@ -0,0 +1,531 @@
+/**
+ * Admin Mutation Hooks
+ *
+ * TanStack Query mutation hooks for admin-related write operations.
+ * These hooks handle admin actions like user management, content moderation,
+ * and business verification.
+ *
+ * @module api/mutations/admin
+ */
+
+import {
+  useMutation,
+  UseMutationOptions,
+  UseMutationResult,
+  useQueryClient,
+} from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { adminKeys } from '../queries/admin';
+import type {
+  UserResponse,
+  HubResponse,
+  EventResponse,
+  BusinessResponse,
+  LibraryContentResponse,
+  CreateHubRequest,
+  UpdateHubRequest,
+  UpdateEventRequest,
+} from '../types';
+
+// ============================================================================
+// REQUEST TYPES
+// ============================================================================
+
+export interface AdminUpdateUserRequest {
+  displayName?: string;
+  email?: string;
+  role?: string;
+  isPremium?: boolean;
+  isSuspended?: boolean;
+}
+
+export interface AdminCreateContentRequest {
+  title: string;
+  type: string;
+  category: string;
+  description?: string;
+  content?: string;
+  mediaUrl?: string;
+  thumbnailUrl?: string;
+  duration?: number;
+  isPremium?: boolean;
+  isFeatured?: boolean;
+  sortOrder?: number;
+}
+
+export interface AdminUpdateContentRequest extends Partial<AdminCreateContentRequest> {}
+
+export interface AdminVerifyBusinessRequest {
+  isVerified: boolean;
+  notes?: string;
+}
+
+// ============================================================================
+// RESPONSE TYPES
+// ============================================================================
+
+export interface AdminActionResponse {
+  success: boolean;
+  message: string;
+}
+
+// ============================================================================
+// USER MUTATIONS
+// ============================================================================
+
+/**
+ * Update user (admin)
+ *
+ * @endpoint PUT /api/v1/admin/users/{id}
+ */
+export function useAdminUpdateUser(
+  options?: Omit<
+    UseMutationOptions<UserResponse, Error, { id: string; data: AdminUpdateUserRequest }>,
+    'mutationFn'
+  >
+): UseMutationResult<UserResponse, Error, { id: string; data: AdminUpdateUserRequest }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      id,
+      data,
+    }: {
+      id: string;
+      data: AdminUpdateUserRequest;
+    }): Promise<UserResponse> => {
+      const client = getApiClient();
+      const response = await client.put<UserResponse>(`/api/v1/admin/users/${id}`, data);
+      return response.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.users.detail(variables.id) });
+      queryClient.invalidateQueries({ queryKey: adminKeys.users.list() });
+      queryClient.invalidateQueries({ queryKey: adminKeys.dashboard() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Suspend user (admin)
+ *
+ * @endpoint POST /api/v1/admin/users/{id}/suspend
+ */
+export function useAdminSuspendUser(
+  options?: Omit<
+    UseMutationOptions<AdminActionResponse, Error, { id: string; reason?: string }>,
+    'mutationFn'
+  >
+): UseMutationResult<AdminActionResponse, Error, { id: string; reason?: string }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      id,
+      reason,
+    }: {
+      id: string;
+      reason?: string;
+    }): Promise<AdminActionResponse> => {
+      const client = getApiClient();
+      const response = await client.post<AdminActionResponse>(
+        `/api/v1/admin/users/${id}/suspend`,
+        { reason }
+      );
+      return response.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.users.detail(variables.id) });
+      queryClient.invalidateQueries({ queryKey: adminKeys.users.list() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Activate user (admin)
+ *
+ * @endpoint POST /api/v1/admin/users/{id}/activate
+ */
+export function useAdminActivateUser(
+  options?: Omit<UseMutationOptions<AdminActionResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<AdminActionResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<AdminActionResponse> => {
+      const client = getApiClient();
+      const response = await client.post<AdminActionResponse>(
+        `/api/v1/admin/users/${id}/activate`
+      );
+      return response.data;
+    },
+    onSuccess: (_, id) => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.users.detail(id) });
+      queryClient.invalidateQueries({ queryKey: adminKeys.users.list() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Delete user (admin)
+ *
+ * @endpoint DELETE /api/v1/admin/users/{id}
+ */
+export function useAdminDeleteUser(
+  options?: Omit<UseMutationOptions<AdminActionResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<AdminActionResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<AdminActionResponse> => {
+      const client = getApiClient();
+      const response = await client.delete<AdminActionResponse>(`/api/v1/admin/users/${id}`);
+      return response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.users.list() });
+      queryClient.invalidateQueries({ queryKey: adminKeys.dashboard() });
+    },
+    ...options,
+  });
+}
+
+// ============================================================================
+// HUB MUTATIONS
+// ============================================================================
+
+/**
+ * Create hub (admin)
+ *
+ * @endpoint POST /api/v1/admin/hubs
+ */
+export function useAdminCreateHub(
+  options?: Omit<UseMutationOptions<HubResponse, Error, CreateHubRequest>, 'mutationFn'>
+): UseMutationResult<HubResponse, Error, CreateHubRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateHubRequest): Promise<HubResponse> => {
+      const client = getApiClient();
+      const response = await client.post<HubResponse>('/api/v1/admin/hubs', data);
+      return response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.hubs.list() });
+      queryClient.invalidateQueries({ queryKey: adminKeys.dashboard() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update hub (admin)
+ *
+ * @endpoint PUT /api/v1/admin/hubs/{id}
+ */
+export function useAdminUpdateHub(
+  options?: Omit<
+    UseMutationOptions<HubResponse, Error, { id: string; data: UpdateHubRequest }>,
+    'mutationFn'
+  >
+): UseMutationResult<HubResponse, Error, { id: string; data: UpdateHubRequest }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      id,
+      data,
+    }: {
+      id: string;
+      data: UpdateHubRequest;
+    }): Promise<HubResponse> => {
+      const client = getApiClient();
+      const response = await client.put<HubResponse>(`/api/v1/admin/hubs/${id}`, data);
+      return response.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.hubs.detail(variables.id) });
+      queryClient.invalidateQueries({ queryKey: adminKeys.hubs.list() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Delete hub (admin)
+ *
+ * @endpoint DELETE /api/v1/admin/hubs/{id}
+ */
+export function useAdminDeleteHub(
+  options?: Omit<UseMutationOptions<AdminActionResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<AdminActionResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<AdminActionResponse> => {
+      const client = getApiClient();
+      const response = await client.delete<AdminActionResponse>(`/api/v1/admin/hubs/${id}`);
+      return response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.hubs.list() });
+      queryClient.invalidateQueries({ queryKey: adminKeys.dashboard() });
+    },
+    ...options,
+  });
+}
+
+// ============================================================================
+// EVENT MUTATIONS
+// ============================================================================
+
+/**
+ * Update event (admin)
+ *
+ * @endpoint PUT /api/v1/admin/events/{id}
+ */
+export function useAdminUpdateEvent(
+  options?: Omit<
+    UseMutationOptions<EventResponse, Error, { id: string; data: UpdateEventRequest }>,
+    'mutationFn'
+  >
+): UseMutationResult<EventResponse, Error, { id: string; data: UpdateEventRequest }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      id,
+      data,
+    }: {
+      id: string;
+      data: UpdateEventRequest;
+    }): Promise<EventResponse> => {
+      const client = getApiClient();
+      const response = await client.put<EventResponse>(`/api/v1/admin/events/${id}`, data);
+      return response.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.events.detail(variables.id) });
+      queryClient.invalidateQueries({ queryKey: adminKeys.events.list() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Cancel event (admin)
+ *
+ * @endpoint POST /api/v1/admin/events/{id}/cancel
+ */
+export function useAdminCancelEvent(
+  options?: Omit<
+    UseMutationOptions<AdminActionResponse, Error, { id: string; reason?: string }>,
+    'mutationFn'
+  >
+): UseMutationResult<AdminActionResponse, Error, { id: string; reason?: string }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      id,
+      reason,
+    }: {
+      id: string;
+      reason?: string;
+    }): Promise<AdminActionResponse> => {
+      const client = getApiClient();
+      const response = await client.post<AdminActionResponse>(
+        `/api/v1/admin/events/${id}/cancel`,
+        { reason }
+      );
+      return response.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.events.detail(variables.id) });
+      queryClient.invalidateQueries({ queryKey: adminKeys.events.list() });
+    },
+    ...options,
+  });
+}
+
+// ============================================================================
+// BUSINESS MUTATIONS
+// ============================================================================
+
+/**
+ * Verify business (admin)
+ *
+ * @endpoint POST /api/v1/admin/businesses/{id}/verify
+ */
+export function useAdminVerifyBusiness(
+  options?: Omit<
+    UseMutationOptions<
+      BusinessResponse,
+      Error,
+      { id: string; data: AdminVerifyBusinessRequest }
+    >,
+    'mutationFn'
+  >
+): UseMutationResult<
+  BusinessResponse,
+  Error,
+  { id: string; data: AdminVerifyBusinessRequest }
+> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      id,
+      data,
+    }: {
+      id: string;
+      data: AdminVerifyBusinessRequest;
+    }): Promise<BusinessResponse> => {
+      const client = getApiClient();
+      const response = await client.post<BusinessResponse>(
+        `/api/v1/admin/businesses/${id}/verify`,
+        data
+      );
+      return response.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({
+        queryKey: adminKeys.businesses.detail(variables.id),
+      });
+      queryClient.invalidateQueries({ queryKey: adminKeys.businesses.list() });
+      queryClient.invalidateQueries({ queryKey: adminKeys.dashboard() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Delete business (admin)
+ *
+ * @endpoint DELETE /api/v1/admin/businesses/{id}
+ */
+export function useAdminDeleteBusiness(
+  options?: Omit<UseMutationOptions<AdminActionResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<AdminActionResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<AdminActionResponse> => {
+      const client = getApiClient();
+      const response = await client.delete<AdminActionResponse>(
+        `/api/v1/admin/businesses/${id}`
+      );
+      return response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.businesses.list() });
+      queryClient.invalidateQueries({ queryKey: adminKeys.dashboard() });
+    },
+    ...options,
+  });
+}
+
+// ============================================================================
+// CONTENT MUTATIONS
+// ============================================================================
+
+/**
+ * Create content (admin)
+ *
+ * @endpoint POST /api/v1/admin/content
+ */
+export function useAdminCreateContent(
+  options?: Omit<
+    UseMutationOptions<LibraryContentResponse, Error, AdminCreateContentRequest>,
+    'mutationFn'
+  >
+): UseMutationResult<LibraryContentResponse, Error, AdminCreateContentRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: AdminCreateContentRequest): Promise<LibraryContentResponse> => {
+      const client = getApiClient();
+      const response = await client.post<LibraryContentResponse>(
+        '/api/v1/admin/content',
+        data
+      );
+      return response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.content.list() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update content (admin)
+ *
+ * @endpoint PUT /api/v1/admin/content/{id}
+ */
+export function useAdminUpdateContent(
+  options?: Omit<
+    UseMutationOptions<
+      LibraryContentResponse,
+      Error,
+      { id: string; data: AdminUpdateContentRequest }
+    >,
+    'mutationFn'
+  >
+): UseMutationResult<
+  LibraryContentResponse,
+  Error,
+  { id: string; data: AdminUpdateContentRequest }
+> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      id,
+      data,
+    }: {
+      id: string;
+      data: AdminUpdateContentRequest;
+    }): Promise<LibraryContentResponse> => {
+      const client = getApiClient();
+      const response = await client.put<LibraryContentResponse>(
+        `/api/v1/admin/content/${id}`,
+        data
+      );
+      return response.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.content.detail(variables.id) });
+      queryClient.invalidateQueries({ queryKey: adminKeys.content.list() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Delete content (admin)
+ *
+ * @endpoint DELETE /api/v1/admin/content/{id}
+ */
+export function useAdminDeleteContent(
+  options?: Omit<UseMutationOptions<AdminActionResponse, Error, string>, 'mutationFn'>
+): UseMutationResult<AdminActionResponse, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<AdminActionResponse> => {
+      const client = getApiClient();
+      const response = await client.delete<AdminActionResponse>(
+        `/api/v1/admin/content/${id}`
+      );
+      return response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: adminKeys.content.list() });
+    },
+    ...options,
+  });
+}