@instockng/api-client 1.0.0

package/src/hooks/admin/discount-codes.ts

@@ -0,0 +1,222 @@
+/**
+ * Type-safe admin RPC hooks for discount code management
+ */
+
+import { useMutation, useQueryClient, UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { useQueryUnwrapped } from '../use-query-unwrapped';
+import { createAdminRpcClients, authHeaders } from '../../rpc-client';
+import { queryKeys } from '../../utils/query-keys';
+import { useApiConfig } from '../useApiConfig';
+
+/**
+ * Hook to list discount codes using admin RPC
+ */
+export function useListDiscountCodes(
+  params?: {
+    page?: number;
+    limit?: number;
+    category?: string;
+    brandId?: string;
+    isActive?: string;
+    search?: string;
+  },
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['discountCodes']['index']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.discountCodes.list(params),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.discountCodes.index.$get({ query: params as any }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to fetch discount codes: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to get discount code by ID using admin RPC
+ */
+export function useGetDiscountCode(
+  codeId: string,
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['discountCodes'][':id']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.discountCodes.detail(codeId),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.discountCodes[':id'].$get(
+        { param: { id: codeId } },
+        authHeaders(authToken)
+      );
+      if (!res.ok) throw new Error(`Failed to fetch discount code: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to create a discount code using admin RPC
+ */
+export function useCreateDiscountCode(
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['discountCodes']['index']['$post']>>['json']>>,
+    Error,
+    any
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data) => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.discountCodes.index.$post({ json: data }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to create discount code: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.discountCodes.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to update a discount code using admin RPC
+ */
+export function useUpdateDiscountCode(
+  codeId: string,
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['discountCodes'][':id']['$patch']>>['json']>>,
+    Error,
+    any
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data) => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.discountCodes[':id'].$patch(
+        { json: data, param: { id: codeId } },
+        authHeaders(authToken)
+      );
+      if (!res.ok) throw new Error(`Failed to update discount code: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.discountCodes.detail(codeId) });
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.discountCodes.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to delete a discount code using admin RPC
+ */
+export function useDeleteDiscountCode(
+  codeId: string,
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['discountCodes'][':id']['$delete']>>['json']>>,
+    Error,
+    void
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.discountCodes[':id'].$delete(
+        { param: { id: codeId } },
+        authHeaders(authToken)
+      );
+      if (!res.ok) throw new Error(`Failed to delete discount code: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.discountCodes.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to get discount code analytics using admin RPC
+ */
+export function useGetDiscountCodeAnalytics(
+  codeId: string,
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['discountCodes'][':id']['analytics']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.discountCodes.analytics(codeId),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.discountCodes[':id'].analytics.$get(
+        { param: { id: codeId } },
+        authHeaders(authToken)
+      );
+      if (!res.ok) throw new Error(`Failed to fetch discount code analytics: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to bulk generate discount codes using admin RPC
+ */
+export function useBulkGenerateDiscountCodes(
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['discountCodes']['bulk-generate']['$post']>>['json']>>,
+    Error,
+    any
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data) => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.discountCodes['bulk-generate'].$post({ json: data }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to bulk generate discount codes: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.discountCodes.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to get discount code overview stats using admin RPC
+ */
+export function useGetDiscountCodeOverviewStats(
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['discountCodes']['stats']['overview']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.discountCodes.overviewStats(),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.discountCodes.stats.overview.$get({}, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to fetch discount code overview stats: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}

package/src/hooks/admin/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Type-safe admin RPC hooks
+ *
+ * Export all admin RPC hooks for use in admin dashboards
+ */
+
+export * from './orders';
+export * from './brands';
+export * from './products';
+export * from './variants';
+export * from './warehouses';
+export * from './inventory';
+export * from './customers';
+export * from './stats';
+export * from './abandoned-carts';
+export * from './discount-codes';
+export * from './delivery-zones';

package/src/hooks/admin/inventory.ts

@@ -0,0 +1,137 @@
+/**
+ * Type-safe admin RPC hooks for inventory management
+ */
+
+import { useMutation, useQueryClient, UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { useQueryUnwrapped } from '../use-query-unwrapped';
+import { createAdminRpcClients, authHeaders } from '../../rpc-client';
+import { queryKeys } from '../../utils/query-keys';
+import { useApiConfig } from '../useApiConfig';
+
+/**
+ * Hook to get inventory overview using admin RPC
+ */
+export function useListInventory(
+  params?: { brandId?: string; warehouseId?: string; productId?: string },
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['inventory']['index']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.inventory.list(params),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.inventory.index.$get({ query: params as any }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to fetch inventory: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to adjust inventory using admin RPC
+ */
+export function useAdjustInventory(
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['inventory']['adjust']['$post']>>['json']>>,
+    Error,
+    any
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data) => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.inventory.adjust.$post({ json: data }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to adjust inventory: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.inventory.all });
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.variants.all });
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.warehouses.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to transfer inventory between warehouses using admin RPC
+ */
+export function useTransferInventory(
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['inventory']['transfer']['$post']>>['json']>>,
+    Error,
+    any
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data) => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.inventory.transfer.$post({ json: data }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to transfer inventory: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.inventory.all });
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.warehouses.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to get inventory transaction history using admin RPC
+ */
+export function useGetInventoryTransactions(
+  params?: {
+    variantId?: string;
+    warehouseId?: string;
+    type?: string;
+    startDate?: string;
+    endDate?: string;
+    page?: number;
+    limit?: number;
+  },
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['inventory']['transactions']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.inventory.transactions(params),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.inventory.transactions.$get({ query: params as any }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to fetch inventory transactions: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to get low stock alerts using admin RPC
+ */
+export function useGetLowStockVariants(
+  params?: { brandId?: string },
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['inventory']['low-stock']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.inventory.lowStock(params?.brandId),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.inventory['low-stock'].$get({ query: params as any }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to fetch low stock alerts: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}

package/src/hooks/admin/orders.ts

@@ -0,0 +1,229 @@
+/**
+ * Type-safe admin RPC hooks for order management
+ *
+ * These hooks use Hono RPC client with types directly from the backend,
+ * providing end-to-end type safety without code generation.
+ */
+
+import { useMutation, useQueryClient, UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { useQueryUnwrapped } from '../use-query-unwrapped';
+import { createAdminRpcClients, authHeaders } from '../../rpc-client';
+import { queryKeys } from '../../utils/query-keys';
+import { useApiConfig } from '../useApiConfig';
+
+/**
+ * Hook to list all orders with pagination using admin RPC
+ *
+ * @param options - React Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: orders, isLoading } = useListOrders();
+ * ```
+ */
+export function useListOrders(
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['orders']['index']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.orders.list(),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.orders.index.$get({}, authHeaders(authToken));
+      if (!res.ok) {
+        throw new Error(`Failed to fetch orders: ${res.statusText}`);
+      }
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to get order by ID using admin RPC
+ *
+ * @param orderId - Order UUID
+ * @param options - React Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: order } = useGetOrder('order-123');
+ * ```
+ */
+export function useGetOrder(
+  orderId: string,
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['orders'][':id']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.orders.detail(orderId),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.orders[':id'].$get(
+        { param: { id: orderId } },
+        authHeaders(authToken)
+      );
+      if (!res.ok) {
+        throw new Error(`Failed to fetch order: ${res.statusText}`);
+      }
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to create a new order using admin RPC
+ *
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const createOrder = useCreateOrder();
+ * createOrder.mutate({
+ *   brandSlug: 'my-brand',
+ *   items: [{ sku: 'SKU-001', quantity: 2 }],
+ *   // ... other order fields
+ * });
+ * ```
+ */
+export function useCreateOrder(
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['orders']['index']['$post']>>['json']>>,
+    Error,
+    any // Type will be inferred from backend
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data) => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.orders.index.$post(
+        { json: data },
+        authHeaders(authToken)
+      );
+      if (!res.ok) {
+        throw new Error(`Failed to create order: ${res.statusText}`);
+      }
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.orders.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to update an order using admin RPC
+ *
+ * @param orderId - Order UUID
+ * @param options - React Query mutation options
+ */
+export function useUpdateOrder(
+  orderId: string,
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['orders'][':id']['$patch']>>['json']>>,
+    Error,
+    any
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data) => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.orders[':id'].$patch(
+        { param: { id: orderId }, json: data },
+        authHeaders(authToken)
+      );
+      if (!res.ok) {
+        throw new Error(`Failed to update order: ${res.statusText}`);
+      }
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.orders.detail(orderId) });
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.orders.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to update order status using admin RPC
+ *
+ * @param orderId - Order UUID
+ * @param options - React Query mutation options
+ */
+export function useUpdateOrderStatus(
+  orderId: string,
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['orders'][':id']['status']['$patch']>>['json']>>,
+    Error,
+    any
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data) => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.orders[':id'].status.$patch(
+        { param: { id: orderId }, json: data },
+        authHeaders(authToken)
+      );
+      if (!res.ok) {
+        throw new Error(`Failed to update order status: ${res.statusText}`);
+      }
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.orders.detail(orderId) });
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.orders.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to delete an order using admin RPC
+ *
+ * @param orderId - Order UUID
+ * @param options - React Query mutation options
+ */
+export function useDeleteOrder(
+  orderId: string,
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['orders'][':id']['$delete']>>['json']>>,
+    Error,
+    void
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.orders[':id'].$delete(
+        { param: { id: orderId } },
+        authHeaders(authToken)
+      );
+      if (!res.ok) {
+        throw new Error(`Failed to delete order: ${res.statusText}`);
+      }
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.orders.all });
+    },
+    ...options,
+  });
+}