@instockng/api-client 1.0.0

package/src/hooks/admin/abandoned-carts.ts

@@ -0,0 +1,102 @@
+/**
+ * Type-safe admin RPC hooks for abandoned cart 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 abandoned carts using admin RPC
+ */
+export function useListAbandonedCarts(
+  params?: { brandId?: string; hoursInactive?: number },
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['abandonedCarts']['index']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.abandonedCarts.list(params),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.abandonedCarts.index.$get({ query: params as any }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to fetch abandoned carts: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to get abandoned cart statistics using admin RPC
+ */
+export function useGetAbandonedCartStats(
+  params?: { brandId?: string },
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['abandonedCarts']['stats']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.abandonedCarts.stats(params?.brandId),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.abandonedCarts.stats.$get({ query: params }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to fetch abandoned cart stats: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to get specific abandoned cart details using admin RPC
+ */
+export function useGetAbandonedCart(
+  cartId: string,
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['abandonedCarts'][':id']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.abandonedCarts.detail(cartId),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.abandonedCarts[':id'].$get(
+        { param: { id: cartId } },
+        authHeaders(authToken)
+      );
+      if (!res.ok) throw new Error(`Failed to fetch abandoned cart: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to clean up expired carts using admin RPC
+ */
+export function useCleanupExpiredCarts(
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['abandonedCarts']['cleanup']['$post']>>['json']>>,
+    Error,
+    void
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.abandonedCarts.cleanup.$post({}, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to cleanup expired carts: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.abandonedCarts.all });
+    },
+    ...options,
+  });
+}

package/src/hooks/admin/brands.ts

@@ -0,0 +1,134 @@
+/**
+ * Type-safe admin RPC hooks for brand 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 all brands using admin RPC
+ */
+export function useListBrands(
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['brands']['index']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.brands.list(),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.brands.index.$get({}, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to fetch brands: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to get brand by ID using admin RPC
+ */
+export function useGetBrand(
+  brandId: string,
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['brands'][':id']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.brands.detail(brandId),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.brands[':id'].$get({ param: { id: brandId } }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to fetch brand: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to create a brand using admin RPC
+ */
+export function useCreateBrand(
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['brands']['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.brands.index.$post({ json: data }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to create brand: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.brands.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to update a brand using admin RPC
+ */
+export function useUpdateBrand(
+  brandId: string,
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['brands'][':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.brands[':id'].$patch({ json: data, param: { id: brandId } }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to update brand: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.brands.detail(brandId) });
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.brands.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to delete a brand using admin RPC
+ */
+export function useDeleteBrand(
+  brandId: string,
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['brands'][':id']['$delete']>>['json']>>,
+    Error,
+    void
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.brands[':id'].$delete({ param: { id: brandId } }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to delete brand: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.brands.all });
+    },
+    ...options,
+  });
+}

package/src/hooks/admin/customers.ts

@@ -0,0 +1,31 @@
+/**
+ * Type-safe admin RPC hooks for customer management
+ */
+
+import { UseQueryOptions } 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 customer order history by phone using admin RPC
+ */
+export function useGetCustomerHistory(
+  phone: string,
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['customers']['history']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.customers.history(phone),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.customers.history.$get({ query: { phone } }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to fetch customer history: ${res.statusText}`);
+      return res.json();
+    },
+    enabled: !!phone,
+    ...options,
+  });
+}

package/src/hooks/admin/delivery-zones.ts

@@ -0,0 +1,236 @@
+/**
+ * Type-safe admin RPC hooks for delivery zone and state 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';
+
+// ============ STATES ============
+
+/**
+ * Hook to list all states using admin RPC
+ */
+export function useListStates(
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['deliveryZones']['states']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.deliveryZones.states.list(),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.deliveryZones.states.$get({}, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to fetch states: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to create a state using admin RPC
+ */
+export function useCreateState(
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['deliveryZones']['states']['$post']>>['json']>>,
+    Error,
+    any
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data) => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.deliveryZones.states.$post({ json: data }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to create state: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.deliveryZones.states.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to update a state using admin RPC
+ */
+export function useUpdateState(
+  stateId: string,
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['deliveryZones']['states'][':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.deliveryZones.states[':id'].$patch(
+        { json: data, param: { id: stateId } },
+        authHeaders(authToken)
+      );
+      if (!res.ok) throw new Error(`Failed to update state: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.deliveryZones.states.detail(stateId) });
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.deliveryZones.states.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to delete a state using admin RPC
+ */
+export function useDeleteState(
+  stateId: string,
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['deliveryZones']['states'][':id']['$delete']>>['json']>>,
+    Error,
+    void
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.deliveryZones.states[':id'].$delete(
+        { param: { id: stateId } },
+        authHeaders(authToken)
+      );
+      if (!res.ok) throw new Error(`Failed to delete state: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.deliveryZones.states.all });
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.deliveryZones.zones.all });
+    },
+    ...options,
+  });
+}
+
+// ============ DELIVERY ZONES ============
+
+/**
+ * Hook to list delivery zones using admin RPC
+ */
+export function useListDeliveryZones(
+  params?: { stateId?: string; brandId?: string },
+  options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['deliveryZones']['zones']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>
+) {
+  const { baseURL, authToken } = useApiConfig();
+
+  return useQueryUnwrapped({
+    queryKey: queryKeys.admin.deliveryZones.zones.list(params),
+    queryFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.deliveryZones.zones.$get({ query: params as any }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to fetch delivery zones: ${res.statusText}`);
+      return res.json();
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to create a delivery zone using admin RPC
+ */
+export function useCreateDeliveryZone(
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['deliveryZones']['zones']['$post']>>['json']>>,
+    Error,
+    any
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data) => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.deliveryZones.zones.$post({ json: data }, authHeaders(authToken));
+      if (!res.ok) throw new Error(`Failed to create delivery zone: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.deliveryZones.zones.all });
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.deliveryZones.states.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to update a delivery zone using admin RPC
+ */
+export function useUpdateDeliveryZone(
+  zoneId: string,
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['deliveryZones']['zones'][':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.deliveryZones.zones[':id'].$patch(
+        { json: data, param: { id: zoneId } },
+        authHeaders(authToken)
+      );
+      if (!res.ok) throw new Error(`Failed to update delivery zone: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.deliveryZones.zones.detail(zoneId) });
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.deliveryZones.zones.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Hook to delete a delivery zone using admin RPC
+ */
+export function useDeleteDeliveryZone(
+  zoneId: string,
+  options?: UseMutationOptions<
+    Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['deliveryZones']['zones'][':id']['$delete']>>['json']>>,
+    Error,
+    void
+  >
+) {
+  const { baseURL, authToken } = useApiConfig();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async () => {
+      const clients = createAdminRpcClients(baseURL);
+      const res = await clients.deliveryZones.zones[':id'].$delete(
+        { param: { id: zoneId } },
+        authHeaders(authToken)
+      );
+      if (!res.ok) throw new Error(`Failed to delete delivery zone: ${res.statusText}`);
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: queryKeys.admin.deliveryZones.zones.all });
+    },
+    ...options,
+  });
+}