@growsober/sdk 1.0.5 → 1.0.8

package/src/api/mutations/badges.ts

@@ -0,0 +1,228 @@
+import { useMutation, useQueryClient, UseMutationOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { badgeKeys, rewardKeys } from '../queries/badges';
+import type {
+  PartnerRewardResponse,
+  PartnerRewardRedemptionResponse,
+  CreatePartnerRewardRequest,
+} from '../types';
+
+// ============================================================================
+// REWARD MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Redeem a partner reward
+ *
+ * @example
+ * ```tsx
+ * const redeemReward = useRedeemReward();
+ *
+ * const handleRedeem = async (rewardId: string) => {
+ *   await redeemReward.mutateAsync(rewardId);
+ *   // Show success message
+ * };
+ * ```
+ */
+export function useRedeemReward(
+  options?: Omit<UseMutationOptions<PartnerRewardRedemptionResponse, Error, string>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (rewardId: string): Promise<PartnerRewardRedemptionResponse> => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/rewards/${rewardId}/redeem`);
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      // Invalidate wallet, available and redeemed rewards
+      queryClient.invalidateQueries({ queryKey: rewardKeys.wallet() });
+      queryClient.invalidateQueries({ queryKey: rewardKeys.available() });
+      queryClient.invalidateQueries({ queryKey: rewardKeys.redeemed() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Create a partner reward (for business dashboard)
+ *
+ * @param businessId - Business ID creating the reward
+ *
+ * @example
+ * ```tsx
+ * const createReward = useCreatePartnerReward('business-123');
+ *
+ * const handleCreate = async () => {
+ *   await createReward.mutateAsync({
+ *     badgeId: 'badge-week-warrior',
+ *     title: 'Free Coffee',
+ *     description: 'Show your badge for a free coffee',
+ *   });
+ * };
+ * ```
+ */
+export function useCreatePartnerReward(
+  businessId: string,
+  options?: Omit<UseMutationOptions<PartnerRewardResponse, Error, CreatePartnerRewardRequest>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreatePartnerRewardRequest): Promise<PartnerRewardResponse> => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/businesses/${businessId}/rewards`, data);
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: rewardKeys.forBusiness(businessId) });
+    },
+    ...options,
+  });
+}
+
+// ============================================================================
+// UNIFIED REWARD MUTATIONS (Venue & Brand)
+// ============================================================================
+
+interface CreateRewardRequest {
+  badgeId: string;
+  title: string;
+  description?: string;
+  code?: string;
+  redeemType?: 'IN_PERSON' | 'ONLINE' | 'BOTH';
+  maxRedemptions?: number;
+  perUserLimit?: number;
+  validFrom?: string;
+  validUntil?: string;
+}
+
+/**
+ * Create a reward for a venue
+ *
+ * @param venueId - Venue ID
+ *
+ * @example
+ * ```tsx
+ * const createReward = useCreateVenueReward('venue-123');
+ *
+ * const handleCreate = async () => {
+ *   await createReward.mutateAsync({
+ *     badgeId: 'badge-week-warrior',
+ *     title: 'Free Coffee',
+ *     description: 'Show your badge for a free coffee',
+ *     redeemType: 'IN_PERSON',
+ *   });
+ * };
+ * ```
+ */
+export function useCreateVenueReward(
+  venueId: string,
+  options?: Omit<UseMutationOptions<unknown, Error, CreateRewardRequest>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateRewardRequest) => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/venues/${venueId}/rewards`, data);
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: rewardKeys.forVenue(venueId) });
+      queryClient.invalidateQueries({ queryKey: rewardKeys.available() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Create a reward for a brand
+ *
+ * @param brandId - Brand ID
+ *
+ * @example
+ * ```tsx
+ * const createReward = useCreateBrandReward('brand-123');
+ *
+ * const handleCreate = async () => {
+ *   await createReward.mutateAsync({
+ *     badgeId: 'badge-week-warrior',
+ *     title: '10% Off',
+ *     description: 'Use code at checkout',
+ *     code: 'SOBER10',
+ *     redeemType: 'ONLINE',
+ *   });
+ * };
+ * ```
+ */
+export function useCreateBrandReward(
+  brandId: string,
+  options?: Omit<UseMutationOptions<unknown, Error, CreateRewardRequest>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateRewardRequest) => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/brands/${brandId}/rewards`, data);
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: rewardKeys.forBrand(brandId) });
+      queryClient.invalidateQueries({ queryKey: rewardKeys.available() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update a partner reward (for business dashboard)
+ *
+ * @param businessId - Business ID
+ *
+ * @example
+ * ```tsx
+ * const updateReward = useUpdatePartnerReward('business-123');
+ *
+ * const handleUpdate = async (rewardId: string) => {
+ *   await updateReward.mutateAsync({
+ *     id: rewardId,
+ *     data: { title: 'Updated Title', isActive: false },
+ *   });
+ * };
+ * ```
+ */
+export function useUpdatePartnerReward(
+  businessId: string,
+  options?: Omit<
+    UseMutationOptions<
+      PartnerRewardResponse,
+      Error,
+      { id: string; data: Partial<CreatePartnerRewardRequest & { isActive: boolean }> }
+    >,
+    'mutationFn'
+  >
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      id,
+      data,
+    }: {
+      id: string;
+      data: Partial<CreatePartnerRewardRequest & { isActive: boolean }>;
+    }): Promise<PartnerRewardResponse> => {
+      const client = getApiClient();
+      const response = await client.patch(`/api/v1/businesses/${businessId}/rewards/${id}`, data);
+      return response.data?.data || response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: rewardKeys.forBusiness(businessId) });
+      queryClient.invalidateQueries({ queryKey: rewardKeys.available() });
+    },
+    ...options,
+  });
+}

package/src/api/mutations/brands.ts

@@ -0,0 +1,376 @@
+import { useMutation, useQueryClient, UseMutationOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { brandKeys } from '../queries/brands';
+import type {
+  BrandResponse,
+  BrandOwnerResponse,
+  BrandCreatorResponse,
+  BrandOwnerRole,
+  CreateBrandRequest,
+  UpdateBrandRequest,
+} from '../types';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Create a new brand
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync: createBrand } = useCreateBrand();
+ *
+ * await createBrand({
+ *   slug: 'wellness-co',
+ *   name: 'Wellness Co',
+ *   description: 'A wellness brand',
+ * });
+ * ```
+ */
+export function useCreateBrand(
+  options?: Omit<UseMutationOptions<BrandResponse, Error, CreateBrandRequest>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateBrandRequest): Promise<BrandResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/brands', data);
+      return response.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: brandKeys.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update a brand
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync: updateBrand } = useUpdateBrand();
+ *
+ * await updateBrand({
+ *   id: 'brand-123',
+ *   data: { description: 'Updated description' },
+ * });
+ * ```
+ */
+export function useUpdateBrand(
+  options?: Omit<
+    UseMutationOptions<BrandResponse, Error, { id: string; data: UpdateBrandRequest }>,
+    'mutationFn'
+  >
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ id, data }: { id: string; data: UpdateBrandRequest }): Promise<BrandResponse> => {
+      const client = getApiClient();
+      const response = await client.patch(`/api/v1/brands/${id}`, data);
+      return response.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: brandKeys.detail(variables.id) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Add a brand owner
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync: addOwner } = useAddBrandOwner();
+ *
+ * await addOwner({
+ *   brandId: 'brand-123',
+ *   userId: 'user-456',
+ *   role: 'MANAGER',
+ * });
+ * ```
+ */
+export function useAddBrandOwner(
+  options?: Omit<
+    UseMutationOptions<
+      BrandOwnerResponse,
+      Error,
+      { brandId: string; userId: string; role: BrandOwnerRole }
+    >,
+    'mutationFn'
+  >
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      brandId,
+      userId,
+      role,
+    }: {
+      brandId: string;
+      userId: string;
+      role: BrandOwnerRole;
+    }): Promise<BrandOwnerResponse> => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/brands/${brandId}/owners`, { userId, role });
+      return response.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: brandKeys.owners(variables.brandId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update a brand owner's role
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync: updateOwnerRole } = useUpdateBrandOwnerRole();
+ *
+ * await updateOwnerRole({
+ *   brandId: 'brand-123',
+ *   userId: 'user-456',
+ *   role: 'OWNER',
+ * });
+ * ```
+ */
+export function useUpdateBrandOwnerRole(
+  options?: Omit<
+    UseMutationOptions<
+      BrandOwnerResponse,
+      Error,
+      { brandId: string; userId: string; role: BrandOwnerRole }
+    >,
+    'mutationFn'
+  >
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      brandId,
+      userId,
+      role,
+    }: {
+      brandId: string;
+      userId: string;
+      role: BrandOwnerRole;
+    }): Promise<BrandOwnerResponse> => {
+      const client = getApiClient();
+      const response = await client.patch(`/api/v1/brands/${brandId}/owners/${userId}`, { role });
+      return response.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: brandKeys.owners(variables.brandId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Remove a brand owner
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync: removeOwner } = useRemoveBrandOwner();
+ *
+ * await removeOwner({
+ *   brandId: 'brand-123',
+ *   userId: 'user-456',
+ * });
+ * ```
+ */
+export function useRemoveBrandOwner(
+  options?: Omit<
+    UseMutationOptions<void, Error, { brandId: string; userId: string }>,
+    'mutationFn'
+  >
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      brandId,
+      userId,
+    }: {
+      brandId: string;
+      userId: string;
+    }): Promise<void> => {
+      const client = getApiClient();
+      await client.delete(`/api/v1/brands/${brandId}/owners/${userId}`);
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: brandKeys.owners(variables.brandId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Add a creator partnership to a brand
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync: addCreator } = useAddBrandCreator();
+ *
+ * await addCreator({
+ *   brandId: 'brand-123',
+ *   creatorId: 'creator-456',
+ *   commissionRate: 0.15,
+ * });
+ * ```
+ */
+export function useAddBrandCreator(
+  options?: Omit<
+    UseMutationOptions<
+      BrandCreatorResponse,
+      Error,
+      {
+        brandId: string;
+        creatorId: string;
+        startDate?: string;
+        endDate?: string;
+        commissionRate?: number;
+        isActive?: boolean;
+      }
+    >,
+    'mutationFn'
+  >
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      brandId,
+      creatorId,
+      startDate,
+      endDate,
+      commissionRate,
+      isActive,
+    }: {
+      brandId: string;
+      creatorId: string;
+      startDate?: string;
+      endDate?: string;
+      commissionRate?: number;
+      isActive?: boolean;
+    }): Promise<BrandCreatorResponse> => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/brands/${brandId}/creators`, {
+        creatorId,
+        startDate,
+        endDate,
+        commissionRate,
+        isActive,
+      });
+      return response.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: brandKeys.creators(variables.brandId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update a creator partnership
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync: updateCreator } = useUpdateBrandCreator();
+ *
+ * await updateCreator({
+ *   brandId: 'brand-123',
+ *   creatorId: 'creator-456',
+ *   isActive: false,
+ * });
+ * ```
+ */
+export function useUpdateBrandCreator(
+  options?: Omit<
+    UseMutationOptions<
+      BrandCreatorResponse,
+      Error,
+      {
+        brandId: string;
+        creatorId: string;
+        startDate?: string;
+        endDate?: string;
+        commissionRate?: number;
+        isActive?: boolean;
+      }
+    >,
+    'mutationFn'
+  >
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      brandId,
+      creatorId,
+      ...data
+    }: {
+      brandId: string;
+      creatorId: string;
+      startDate?: string;
+      endDate?: string;
+      commissionRate?: number;
+      isActive?: boolean;
+    }): Promise<BrandCreatorResponse> => {
+      const client = getApiClient();
+      const response = await client.patch(`/api/v1/brands/${brandId}/creators/${creatorId}`, data);
+      return response.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: brandKeys.creators(variables.brandId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Remove a creator partnership from a brand
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync: removeCreator } = useRemoveBrandCreator();
+ *
+ * await removeCreator({
+ *   brandId: 'brand-123',
+ *   creatorId: 'creator-456',
+ * });
+ * ```
+ */
+export function useRemoveBrandCreator(
+  options?: Omit<
+    UseMutationOptions<void, Error, { brandId: string; creatorId: string }>,
+    'mutationFn'
+  >
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      brandId,
+      creatorId,
+    }: {
+      brandId: string;
+      creatorId: string;
+    }): Promise<void> => {
+      const client = getApiClient();
+      await client.delete(`/api/v1/brands/${brandId}/creators/${creatorId}`);
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: brandKeys.creators(variables.brandId) });
+    },
+    ...options,
+  });
+}