@instockng/api-client 1.0.0 → 1.0.2

package/src/fetchers/carts.ts

@@ -1,202 +0,0 @@
-/**
- * Cart fetcher functions
- *
- * These are the actual data-fetching functions used by hooks.
- * They can also be imported directly in Server Components.
- *
- * API URL is hardcoded to https://oms-api.instock.ng
- */
-
-import { createRpcClients } from '../rpc-client';
-
-const API_URL = 'https://oms-api.instock.ng';
-
-/**
- * Fetch a cart by ID
- *
- * @param cartId - Cart UUID
- * @returns Cart with items, brand, and delivery zone
- */
-export async function fetchCart(cartId: string) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.carts[':id'].$get({
-    param: { id: cartId },
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to fetch cart: ${res.statusText}`);
-  }
-  return res.json();
-}
-
-/**
- * Create a new cart
- *
- * @param brandSlug - Brand slug
- * @returns Newly created cart
- */
-export async function createCart(brandSlug: string) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.carts.index.$post({
-    json: { brandSlug },
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to create cart: ${res.statusText}`);
-  }
-  return res.json();
-}
-
-/**
- * Update a cart
- *
- * @param cartId - Cart UUID
- * @param data - Cart update data (customer info, deliveryZoneId, etc.)
- * @returns Updated cart
- */
-export async function updateCart(
-  cartId: string,
-  data: {
-    customerPhone?: string | null;
-    customerEmail?: string | null;
-    customerFirstName?: string | null;
-    customerLastName?: string | null;
-    deliveryZoneId?: string | null;
-    ifUnmodifiedSince?: string;
-  }
-) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.carts[':id'].$patch({
-    param: { id: cartId },
-    json: data,
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to update cart: ${res.statusText}`);
-  }
-  return res.json();
-}
-
-/**
- * Add an item to cart
- *
- * @param cartId - Cart UUID
- * @param sku - Product variant SKU
- * @param quantity - Quantity to add
- * @returns Updated cart
- */
-export async function addCartItem(cartId: string, sku: string, quantity: number) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.carts[':id'].items.$post({
-    param: { id: cartId },
-    json: { sku, quantity },
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to add item to cart: ${res.statusText}`);
-  }
-  return res.json();
-}
-
-/**
- * Update a cart item quantity
- *
- * @param cartId - Cart UUID
- * @param itemId - Cart item UUID
- * @param quantity - New quantity
- * @returns Updated cart
- */
-export async function updateCartItem(cartId: string, itemId: string, quantity: number) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.carts[':id'].items[':itemId'].$patch({
-    param: { id: cartId, itemId },
-    json: { quantity },
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to update cart item: ${res.statusText}`);
-  }
-  return res.json();
-}
-
-/**
- * Remove an item from cart
- *
- * @param cartId - Cart UUID
- * @param itemId - Cart item UUID
- * @returns Updated cart
- */
-export async function removeCartItem(cartId: string, itemId: string) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.carts[':id'].items[':itemId'].$delete({
-    param: { id: cartId, itemId },
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to remove cart item: ${res.statusText}`);
-  }
-  return res.json();
-}
-
-/**
- * Apply a discount code to cart
- *
- * @param cartId - Cart UUID
- * @param code - Discount code
- * @returns Updated cart
- */
-export async function applyDiscount(cartId: string, code: string) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.carts[':id']['apply-discount'].$post({
-    param: { id: cartId },
-    json: { code },
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to apply discount: ${res.statusText}`);
-  }
-  return res.json();
-}
-
-/**
- * Remove discount from cart
- *
- * @param cartId - Cart UUID
- * @returns Updated cart
- */
-export async function removeDiscount(cartId: string) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.carts[':id']['remove-discount'].$post({
-    param: { id: cartId },
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to remove discount: ${res.statusText}`);
-  }
-  return res.json();
-}
-
-/**
- * Checkout a cart
- *
- * @param cartId - Cart UUID
- * @param checkoutData - Checkout information (customer details, delivery, payment)
- * @returns Created order
- */
-export async function checkoutCart(
-  cartId: string,
-  checkoutData: {
-    firstName: string;
-    lastName: string;
-    phone?: string;
-    email?: string;
-    address: string;
-    city: string;
-    deliveryZoneId: string;
-    paymentMethod: 'cod' | 'online';
-    paystackReference?: string;
-    ifUnmodifiedSince?: string;
-  }
-) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.carts[':id'].checkout.$post({
-    param: { id: cartId },
-    json: checkoutData,
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to checkout cart: ${res.statusText}`);
-  }
-  return res.json();
-}

package/src/fetchers/orders.ts

@@ -1,48 +0,0 @@
-/**
- * Order fetcher functions
- *
- * These are the actual data-fetching functions used by hooks.
- * They can also be imported directly in Server Components.
- *
- * API URL is hardcoded to https://oms-api.instock.ng
- */
-
-import { createRpcClients } from '../rpc-client';
-
-const API_URL = 'https://oms-api.instock.ng';
-
-/**
- * Fetch an order by ID and token
- *
- * @param orderId - Order UUID
- * @param token - User action token
- * @returns Order with items, delivery zone, and brand
- */
-export async function fetchOrder(orderId: string, token: string) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.orders[':id'][':token'].$get({
-    param: { id: orderId, token },
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to fetch order: ${res.statusText}`);
-  }
-  return res.json();
-}
-
-/**
- * Confirm a prospect order
- *
- * @param orderId - Order UUID
- * @param token - User action token
- * @returns Confirmed order
- */
-export async function confirmOrder(orderId: string, token: string) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.orders.confirm.$post({
-    json: { orderId, token },
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to confirm order: ${res.statusText}`);
-  }
-  return res.json();
-}

package/src/fetchers/products.ts

@@ -1,46 +0,0 @@
-/**
- * Product fetcher functions
- *
- * These are the actual data-fetching functions used by hooks.
- * They can also be imported directly in Server Components.
- *
- * API URL is hardcoded to https://oms-api.instock.ng
- */
-
-import { createRpcClients } from '../rpc-client';
-
-const API_URL = 'https://oms-api.instock.ng';
-
-/**
- * Fetch products by brand ID
- *
- * @param brandId - Brand UUID
- * @returns Products for the brand with variants and availability
- */
-export async function fetchProductsByBrand(brandId: string) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.products[':brandId'].$get({
-    param: { brandId },
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to fetch products: ${res.statusText}`);
-  }
-  return res.json();
-}
-
-/**
- * Fetch a single product by slug
- *
- * @param slug - Product slug (e.g., 'cotton-t-shirt')
- * @returns Product with variants and availability
- */
-export async function fetchProductBySlug(slug: string) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.products.product[':slug'].$get({
-    param: { slug },
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to fetch product: ${res.statusText}`);
-  }
-  return res.json();
-}

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

@@ -1,102 +0,0 @@
-/**
- * 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

@@ -1,134 +0,0 @@
-/**
- * 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

@@ -1,31 +0,0 @@
-/**
- * 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,
-  });
-}