@growsober/sdk 1.0.0

package/src/api/mutations/notifications.ts

@@ -0,0 +1,114 @@
+import { useMutation, useQueryClient, UseMutationOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { notificationKeys } from '../queries/notifications';
+import type { NotificationResponse } from '../types';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Mark a notification as read
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate: markAsRead } = useMarkNotificationRead();
+ *
+ * const handleNotificationClick = (notificationId: string) => {
+ *   markAsRead(notificationId);
+ * };
+ * ```
+ */
+export function useMarkNotificationRead(
+  options?: Omit<UseMutationOptions<NotificationResponse, Error, string>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<NotificationResponse> => {
+      const client = getApiClient();
+      const response = await client.patch(`/api/v1/notifications/${id}/read`);
+      return response.data;
+    },
+    onSuccess: (data, id, context) => {
+      // Update notification in cache
+      queryClient.setQueryData(notificationKeys.detail(id), data);
+      // Invalidate lists to refetch
+      queryClient.invalidateQueries({ queryKey: notificationKeys.list() });
+      queryClient.invalidateQueries({ queryKey: notificationKeys.unreadCount() });
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Mark all notifications as read
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate: markAllRead, isPending } = useMarkAllNotificationsRead();
+ *
+ * const handleMarkAllRead = () => {
+ *   markAllRead();
+ * };
+ * ```
+ */
+export function useMarkAllNotificationsRead(
+  options?: Omit<UseMutationOptions<void, Error, void>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (): Promise<void> => {
+      const client = getApiClient();
+      await client.patch('/api/v1/notifications/read-all');
+    },
+    onSuccess: (data, variables, context) => {
+      // Invalidate all notification queries
+      queryClient.invalidateQueries({ queryKey: notificationKeys.all });
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Delete a notification
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate: deleteNotification } = useDeleteNotification();
+ *
+ * const handleDelete = (notificationId: string) => {
+ *   deleteNotification(notificationId);
+ * };
+ * ```
+ */
+export function useDeleteNotification(
+  options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (id: string): Promise<void> => {
+      const client = getApiClient();
+      await client.delete(`/api/v1/notifications/${id}`);
+    },
+    onSuccess: (data, id, context) => {
+      // Remove from cache
+      queryClient.removeQueries({ queryKey: notificationKeys.detail(id) });
+      // Invalidate lists to refetch
+      queryClient.invalidateQueries({ queryKey: notificationKeys.list() });
+      queryClient.invalidateQueries({ queryKey: notificationKeys.unreadCount() });
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}

package/src/api/mutations/offers.ts

@@ -0,0 +1,73 @@
+import {
+  useMutation,
+  useQueryClient,
+  UseMutationOptions,
+  UseMutationResult,
+} from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import type { OfferResponse, RedeemOfferRequest } from '../types';
+import { offerKeys } from '../queries/offers';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Redeem an offer
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending } = useRedeemOffer();
+ *
+ * mutate({
+ *   id: 'offer-123',
+ *   data: {
+ *     // Add any required fields from RedeemOfferRequest
+ *   }
+ * });
+ * ```
+ */
+export function useRedeemOffer(
+  options?: Omit<
+    UseMutationOptions<
+      OfferResponse,
+      Error,
+      { id: string; data?: RedeemOfferRequest }
+    >,
+    'mutationFn'
+  >
+): UseMutationResult<OfferResponse, Error, { id: string; data?: RedeemOfferRequest }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      id,
+      data,
+    }: {
+      id: string;
+      data?: RedeemOfferRequest;
+    }): Promise<OfferResponse> => {
+      const client = getApiClient();
+      const response = await client.post(`/api/v1/offers/${id}/redeem`, data);
+      return response.data;
+    },
+    onSuccess: (redeemedOffer, variables, context) => {
+      // Update the specific offer in cache
+      queryClient.setQueryData(
+        offerKeys.detail(variables.id),
+        redeemedOffer
+      );
+
+      // Invalidate the can-redeem check for this offer
+      queryClient.invalidateQueries({ queryKey: offerKeys.canRedeem(variables.id) });
+
+      // Invalidate offer lists to reflect redemption counts
+      queryClient.invalidateQueries({ queryKey: offerKeys.lists() });
+
+      // Call user's onSuccess if provided
+    },
+    ...options,
+  });
+}

package/src/api/mutations/subscriptions.ts

@@ -0,0 +1,162 @@
+import { useMutation, useQueryClient, UseMutationOptions } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { subscriptionKeys } from '../queries/subscriptions';
+import type { CreateCheckoutRequest, SubscriptionResponse } from '../types';
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface CheckoutSession {
+  sessionId: string;
+  url: string;
+}
+
+export interface CustomerPortalSession {
+  url: string;
+}
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Create a Stripe checkout session for subscription
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate: createCheckout, isPending } = useCreateCheckout();
+ *
+ * const handleUpgrade = () => {
+ *   createCheckout(
+ *     { tier: 'PREMIUM', successUrl: '/success', cancelUrl: '/cancel' },
+ *     {
+ *       onSuccess: (session) => {
+ *         window.location.href = session.url;
+ *       },
+ *     }
+ *   );
+ * };
+ * ```
+ */
+export function useCreateCheckout(
+  options?: Omit<UseMutationOptions<CheckoutSession, Error, CreateCheckoutRequest>, 'mutationFn'>
+) {
+  return useMutation({
+    mutationFn: async (data: CreateCheckoutRequest): Promise<CheckoutSession> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/subscriptions/checkout', data);
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Get Stripe customer portal URL for managing subscription
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate: getPortal, isPending } = useCustomerPortal();
+ *
+ * const handleManageSubscription = () => {
+ *   getPortal(undefined, {
+ *     onSuccess: (session) => {
+ *       window.location.href = session.url;
+ *     },
+ *   });
+ * };
+ * ```
+ */
+export function useCustomerPortal(
+  options?: Omit<UseMutationOptions<CustomerPortalSession, Error, void>, 'mutationFn'>
+) {
+  return useMutation({
+    mutationFn: async (): Promise<CustomerPortalSession> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/subscriptions/portal');
+      return response.data;
+    },
+    ...options,
+  });
+}
+
+/**
+ * Cancel current subscription
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate: cancelSubscription, isPending } = useCancelSubscription();
+ *
+ * const handleCancel = () => {
+ *   cancelSubscription(undefined, {
+ *     onSuccess: () => {
+ *       // Subscription will be cancelled at period end
+ *     },
+ *   });
+ * };
+ * ```
+ */
+export function useCancelSubscription(
+  options?: Omit<UseMutationOptions<SubscriptionResponse, Error, void>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (): Promise<SubscriptionResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/subscriptions/cancel');
+      return response.data;
+    },
+    onSuccess: (data, variables, context) => {
+      // Update subscription in cache
+      queryClient.setQueryData(subscriptionKeys.mine(), data);
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}
+
+/**
+ * Resume a cancelled subscription (before period end)
+ *
+ * @param options - TanStack Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const { mutate: resumeSubscription, isPending } = useResumeSubscription();
+ *
+ * const handleResume = () => {
+ *   resumeSubscription(undefined, {
+ *     onSuccess: () => {
+ *       // Subscription resumed
+ *     },
+ *   });
+ * };
+ * ```
+ */
+export function useResumeSubscription(
+  options?: Omit<UseMutationOptions<SubscriptionResponse, Error, void>, 'mutationFn'>
+) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (): Promise<SubscriptionResponse> => {
+      const client = getApiClient();
+      const response = await client.post('/api/v1/subscriptions/resume');
+      return response.data;
+    },
+    onSuccess: (data, variables, context) => {
+      // Update subscription in cache
+      queryClient.setQueryData(subscriptionKeys.mine(), data);
+      // User's onSuccess is handled by spreading options
+    },
+    ...options,
+  });
+}