@instockng/api-client 1.0.3 → 1.0.5

package/dist/packages/api-client/src/hooks/public/carts.js

@@ -0,0 +1,213 @@
+/**
+ * Type-safe RPC hooks for cart operations
+ *
+ * These hooks use Hono RPC client with types directly from the backend,
+ * providing end-to-end type safety without code generation.
+ */
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { useQueryUnwrapped } from '../use-query-unwrapped';
+import { queryKeys } from '../../utils/query-keys';
+import { fetchCart, updateCart, createCart, addCartItem, updateCartItem, removeCartItem, applyDiscount, removeDiscount, checkoutCart, } from '../../fetchers/carts';
+/**
+ * Hook to get cart by ID using RPC
+ *
+ * @param cartId - Cart UUID
+ * @param options - React Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: cart, isLoading } = useGetCart('cart-123');
+ * console.log(cart?.cart.brand.name); // Fully typed!
+ * ```
+ */
+export function useGetCart(cartId, options) {
+    return useQueryUnwrapped({
+        queryKey: queryKeys.public.carts.detail(cartId),
+        queryFn: () => fetchCart(cartId),
+        ...options,
+    });
+}
+/**
+ * Hook to update cart using RPC
+ *
+ * @param cartId - Cart UUID
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const updateCart = useUpdateCart('cart-123');
+ * updateCart.mutate({
+ *   customerEmail: 'user@example.com',
+ *   deliveryZoneId: 'zone-123'
+ * });
+ * ```
+ */
+export function useUpdateCart(cartId, options) {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (data) => updateCart(cartId, data),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: queryKeys.public.carts.detail(cartId) });
+        },
+        ...options,
+    });
+}
+/**
+ * Hook to create a new cart using RPC
+ *
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const createCart = useCreateCart();
+ * createCart.mutate('my-brand');
+ * ```
+ */
+export function useCreateCart(options) {
+    return useMutation({
+        mutationFn: (brandSlug) => createCart(brandSlug),
+        ...options,
+    });
+}
+/**
+ * Hook to apply discount code to cart using RPC
+ *
+ * @param cartId - Cart UUID
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const applyDiscount = useApplyDiscount('cart-123');
+ * applyDiscount.mutate({ code: 'SAVE10' });
+ * ```
+ */
+export function useApplyDiscount(cartId, options) {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (data) => applyDiscount(cartId, data.code),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: queryKeys.public.carts.detail(cartId) });
+        },
+        ...options,
+    });
+}
+/**
+ * Hook to remove discount code from cart using RPC
+ *
+ * @param cartId - Cart UUID
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const removeDiscount = useRemoveDiscount('cart-123');
+ * removeDiscount.mutate();
+ * ```
+ */
+export function useRemoveDiscount(cartId, options) {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: () => removeDiscount(cartId),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: queryKeys.public.carts.detail(cartId) });
+        },
+        ...options,
+    });
+}
+/**
+ * Hook to add item to cart using RPC
+ *
+ * @param cartId - Cart UUID
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const addItem = useAddCartItem('cart-123');
+ * addItem.mutate({ sku: 'PROD-001', quantity: 2, fbc: '_fbc_cookie', fbp: '_fbp_cookie' });
+ * ```
+ */
+export function useAddCartItem(cartId, options) {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (data) => addCartItem(cartId, data.sku, data.quantity, data.fbc, data.fbp),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: queryKeys.public.carts.detail(cartId) });
+        },
+        ...options,
+    });
+}
+/**
+ * Hook to update cart item quantity using RPC
+ *
+ * @param cartId - Cart UUID
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const updateItem = useUpdateCartItem('cart-123');
+ * updateItem.mutate({ itemId: 'item-456', quantity: 3 });
+ * ```
+ */
+export function useUpdateCartItem(cartId, options) {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: ({ itemId, quantity }) => updateCartItem(cartId, itemId, quantity),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: queryKeys.public.carts.detail(cartId) });
+        },
+        ...options,
+    });
+}
+/**
+ * Hook to remove item from cart using RPC
+ *
+ * @param cartId - Cart UUID
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const removeItem = useRemoveCartItem('cart-123');
+ * removeItem.mutate('item-456'); // Pass itemId in mutate call
+ * ```
+ */
+export function useRemoveCartItem(cartId, options) {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (itemId) => removeCartItem(cartId, itemId),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: queryKeys.public.carts.detail(cartId) });
+        },
+        ...options,
+    });
+}
+/**
+ * Hook to checkout a cart and create an order using RPC
+ *
+ * @param cartId - Cart UUID
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const checkout = useCheckoutCart('cart-123');
+ * checkout.mutate({
+ *   firstName: 'John',
+ *   lastName: 'Doe',
+ *   email: 'john@example.com',
+ *   phone: '+1234567890',
+ *   address: '123 Main St',
+ *   city: 'New York',
+ *   deliveryZoneId: 'zone-123',
+ *   paymentMethod: 'cod'
+ * });
+ * ```
+ */
+export function useCheckoutCart(cartId, options) {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (data) => checkoutCart(cartId, data),
+        onSuccess: () => {
+            // Invalidate cart query since it's now converted to an order
+            queryClient.invalidateQueries({ queryKey: queryKeys.public.carts.detail(cartId) });
+        },
+        ...options,
+    });
+}

package/dist/packages/api-client/src/hooks/public/delivery-zones.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Type-safe RPC hooks for delivery zone operations
+ *
+ * These hooks use Hono RPC client with types directly from the backend,
+ * providing end-to-end type safety without code generation.
+ */
+import { UseQueryOptions } from '@tanstack/react-query';
+import { fetchDeliveryZones } from '../../fetchers/delivery-zones';
+/**
+ * Hook to get delivery zones using RPC
+ *
+ * @param brandId - Optional brand UUID to filter brand-specific zones
+ * @param options - React Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: zones, isLoading } = useGetDeliveryZones(undefined);
+ * console.log(zones?.data[0].name); // Fully typed!
+ * ```
+ */
+export declare function useGetDeliveryZones(brandId: string | undefined, options?: Omit<UseQueryOptions<Awaited<ReturnType<typeof fetchDeliveryZones>>, Error>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<{
+    id: string;
+    name: string;
+    zones: {
+        id: string;
+        name: string;
+        deliveryCost: number;
+        freeShippingThreshold: number;
+        allowCOD: boolean;
+        allowOnline: boolean;
+        waybillOnly: boolean;
+        estimatedDays: number;
+    }[];
+}[], Error>;

package/dist/packages/api-client/src/hooks/public/delivery-zones.js

@@ -0,0 +1,28 @@
+/**
+ * Type-safe RPC hooks for delivery zone operations
+ *
+ * These hooks use Hono RPC client with types directly from the backend,
+ * providing end-to-end type safety without code generation.
+ */
+import { useQueryUnwrapped } from '../use-query-unwrapped';
+import { queryKeys } from '../../utils/query-keys';
+import { fetchDeliveryZones } from '../../fetchers/delivery-zones';
+/**
+ * Hook to get delivery zones using RPC
+ *
+ * @param brandId - Optional brand UUID to filter brand-specific zones
+ * @param options - React Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: zones, isLoading } = useGetDeliveryZones(undefined);
+ * console.log(zones?.data[0].name); // Fully typed!
+ * ```
+ */
+export function useGetDeliveryZones(brandId, options) {
+    return useQueryUnwrapped({
+        queryKey: queryKeys.public.deliveryZones.list(brandId),
+        queryFn: () => fetchDeliveryZones(brandId),
+        ...options,
+    });
+}

package/dist/packages/api-client/src/hooks/public/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Type-safe RPC hooks
+ *
+ * Export all RPC hooks for use in applications
+ */
+export * from './carts';
+export * from './orders';
+export * from './products';
+export * from './delivery-zones';
+export * from './brands';

package/dist/packages/api-client/src/hooks/public/index.js

@@ -0,0 +1,10 @@
+/**
+ * Type-safe RPC hooks
+ *
+ * Export all RPC hooks for use in applications
+ */
+export * from './carts';
+export * from './orders';
+export * from './products';
+export * from './delivery-zones';
+export * from './brands';

package/dist/packages/api-client/src/hooks/public/orders.d.ts

@@ -0,0 +1,302 @@
+/**
+ * Type-safe RPC hooks for order operations
+ *
+ * These hooks use Hono RPC client with types directly from the backend,
+ * providing end-to-end type safety without code generation.
+ */
+import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { fetchOrder, confirmOrder } from '../../fetchers/orders';
+/**
+ * Hook to get order by ID and token using RPC
+ *
+ * @param orderId - Order UUID
+ * @param token - User action token
+ * @param options - React Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: order, isLoading } = useGetOrder('order-123', 'token-456');
+ * console.log(order?.order.status); // Fully typed!
+ * ```
+ */
+export declare function useGetOrder(orderId: string, token: string, options?: Omit<UseQueryOptions<Awaited<ReturnType<typeof fetchOrder>>, Error>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<{
+    canConfirm: boolean;
+    confirmationMessage: string;
+    subtotal: number;
+    deliveryCharge: number;
+    totalPrice: number;
+    discountAmount: number;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt: string;
+    prospectSince: string;
+    lastRecoveryAttemptAt: string;
+    brand: {
+        createdAt: string;
+        updatedAt: string;
+        deletedAt: string;
+        name: string;
+        id: string;
+        slug: string;
+        logoUrl: string | null;
+        siteUrl: string;
+        domain: string;
+        metaPixelId: string | null;
+    };
+    deliveryZone: {
+        deliveryCost: number;
+        freeShippingThreshold: number;
+        createdAt: string;
+        updatedAt: string;
+        deletedAt: string;
+        state: {
+            createdAt: string;
+            updatedAt: string;
+            deletedAt: string;
+            name: string;
+            id: string;
+            isActive: boolean;
+        };
+        name: string;
+        id: string;
+        brandId: string | null;
+        stateId: string;
+        allowCOD: boolean;
+        allowOnline: boolean;
+        waybillOnly: boolean;
+        estimatedDays: number | null;
+        isActive: boolean;
+    };
+    items: {
+        priceAtPurchase: number;
+        variant: {
+            price: number;
+            createdAt: string;
+            updatedAt: string;
+            deletedAt: string;
+            product: {
+                createdAt: string;
+                updatedAt: string;
+                deletedAt: string;
+                name: string;
+                id: string;
+                slug: string;
+                brandId: string;
+                isActive: boolean;
+                description: string | null;
+                thumbnailUrl: string | null;
+                quantityDiscounts: string | number | boolean | {
+                    [x: string]: string | number | boolean | /*elided*/ any | {
+                        [x: number]: string | number | boolean | /*elided*/ any | /*elided*/ any;
+                        length: number;
+                        toString: never;
+                        toLocaleString: never;
+                        pop: never;
+                        push: never;
+                        concat: never;
+                        join: never;
+                        reverse: never;
+                        shift: never;
+                        slice: never;
+                        sort: never;
+                        splice: never;
+                        unshift: never;
+                        indexOf: never;
+                        lastIndexOf: never;
+                        every: never;
+                        some: never;
+                        forEach: never;
+                        map: never;
+                        filter: never;
+                        reduce: never;
+                        reduceRight: never;
+                        find: never;
+                        findIndex: never;
+                        fill: never;
+                        copyWithin: never;
+                        entries: never;
+                        keys: never;
+                        values: never;
+                        includes: never;
+                        flatMap: never;
+                        flat: never;
+                        [Symbol.iterator]: never;
+                        readonly [Symbol.unscopables]: {
+                            [x: number]: boolean;
+                            length?: boolean;
+                            toString?: boolean;
+                            toLocaleString?: boolean;
+                            pop?: boolean;
+                            push?: boolean;
+                            concat?: boolean;
+                            join?: boolean;
+                            reverse?: boolean;
+                            shift?: boolean;
+                            slice?: boolean;
+                            sort?: boolean;
+                            splice?: boolean;
+                            unshift?: boolean;
+                            indexOf?: boolean;
+                            lastIndexOf?: boolean;
+                            every?: boolean;
+                            some?: boolean;
+                            forEach?: boolean;
+                            map?: boolean;
+                            filter?: boolean;
+                            reduce?: boolean;
+                            reduceRight?: boolean;
+                            find?: boolean;
+                            findIndex?: boolean;
+                            fill?: boolean;
+                            copyWithin?: boolean;
+                            entries?: boolean;
+                            keys?: boolean;
+                            values?: boolean;
+                            includes?: boolean;
+                            flatMap?: boolean;
+                            flat?: boolean;
+                        };
+                    };
+                } | {
+                    [x: number]: string | number | boolean | {
+                        [x: string]: string | number | boolean | /*elided*/ any | /*elided*/ any;
+                    } | /*elided*/ any;
+                    length: number;
+                    toString: never;
+                    toLocaleString: never;
+                    pop: never;
+                    push: never;
+                    concat: never;
+                    join: never;
+                    reverse: never;
+                    shift: never;
+                    slice: never;
+                    sort: never;
+                    splice: never;
+                    unshift: never;
+                    indexOf: never;
+                    lastIndexOf: never;
+                    every: never;
+                    some: never;
+                    forEach: never;
+                    map: never;
+                    filter: never;
+                    reduce: never;
+                    reduceRight: never;
+                    find: never;
+                    findIndex: never;
+                    fill: never;
+                    copyWithin: never;
+                    entries: never;
+                    keys: never;
+                    values: never;
+                    includes: never;
+                    flatMap: never;
+                    flat: never;
+                    [Symbol.iterator]: never;
+                    readonly [Symbol.unscopables]: {
+                        [x: number]: boolean;
+                        length?: boolean;
+                        toString?: boolean;
+                        toLocaleString?: boolean;
+                        pop?: boolean;
+                        push?: boolean;
+                        concat?: boolean;
+                        join?: boolean;
+                        reverse?: boolean;
+                        shift?: boolean;
+                        slice?: boolean;
+                        sort?: boolean;
+                        splice?: boolean;
+                        unshift?: boolean;
+                        indexOf?: boolean;
+                        lastIndexOf?: boolean;
+                        every?: boolean;
+                        some?: boolean;
+                        forEach?: boolean;
+                        map?: boolean;
+                        filter?: boolean;
+                        reduce?: boolean;
+                        reduceRight?: boolean;
+                        find?: boolean;
+                        findIndex?: boolean;
+                        fill?: boolean;
+                        copyWithin?: boolean;
+                        entries?: boolean;
+                        keys?: boolean;
+                        values?: boolean;
+                        includes?: boolean;
+                        flatMap?: boolean;
+                        flat?: boolean;
+                    };
+                };
+            };
+            name: string | null;
+            id: string;
+            isActive: boolean;
+            thumbnailUrl: string | null;
+            productId: string;
+            sku: string;
+            trackInventory: boolean;
+            lowStockThreshold: number | null;
+        };
+        warehouse: {
+            createdAt: string;
+            updatedAt: string;
+            deletedAt: string;
+            name: string;
+            id: string;
+            isActive: boolean;
+            address: string | null;
+            city: string | null;
+            state: string | null;
+        };
+        id: string;
+        orderId: string;
+        variantId: string;
+        warehouseId: string | null;
+        quantity: number;
+    }[];
+    id: string;
+    email: string | null;
+    brandId: string;
+    deliveryZoneId: string;
+    recoveryAttempts: number;
+    recoveryDiscountCodeId: string | null;
+    wasRecovered: boolean;
+    estimatedDays: number | null;
+    orderNumber: number;
+    firstName: string;
+    lastName: string;
+    phone: string;
+    address: string;
+    city: string;
+    discountCodeId: string | null;
+    paymentMethod: import("@prisma/client").$Enums.PaymentMethod;
+    paystackReference: string | null;
+    status: import("@prisma/client").$Enums.OrderStatus;
+    cancellationReason: string | null;
+    prospectReason: import("@prisma/client").$Enums.ProspectReason | null;
+    userActionToken: string;
+}, Error>;
+/**
+ * Hook to confirm a prospect order using RPC
+ *
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const confirmOrder = useConfirmOrder();
+ * confirmOrder.mutate({
+ *   orderId: 'order-123',
+ *   token: 'token-456'
+ * });
+ * ```
+ */
+export declare function useConfirmOrder(options?: UseMutationOptions<Awaited<ReturnType<typeof confirmOrder>>, Error, {
+    orderId: string;
+    token: string;
+}>): import("@tanstack/react-query").UseMutationResult<unknown, Error, {
+    orderId: string;
+    token: string;
+}, unknown>;

package/dist/packages/api-client/src/hooks/public/orders.js

@@ -0,0 +1,50 @@
+/**
+ * Type-safe RPC hooks for order operations
+ *
+ * These hooks use Hono RPC client with types directly from the backend,
+ * providing end-to-end type safety without code generation.
+ */
+import { useMutation } from '@tanstack/react-query';
+import { useQueryUnwrapped } from '../use-query-unwrapped';
+import { queryKeys } from '../../utils/query-keys';
+import { fetchOrder, confirmOrder } from '../../fetchers/orders';
+/**
+ * Hook to get order by ID and token using RPC
+ *
+ * @param orderId - Order UUID
+ * @param token - User action token
+ * @param options - React Query options
+ *
+ * @example
+ * ```tsx
+ * const { data: order, isLoading } = useGetOrder('order-123', 'token-456');
+ * console.log(order?.order.status); // Fully typed!
+ * ```
+ */
+export function useGetOrder(orderId, token, options) {
+    return useQueryUnwrapped({
+        queryKey: queryKeys.public.orders.detail(orderId, token),
+        queryFn: () => fetchOrder(orderId, token),
+        ...options,
+    });
+}
+/**
+ * Hook to confirm a prospect order using RPC
+ *
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const confirmOrder = useConfirmOrder();
+ * confirmOrder.mutate({
+ *   orderId: 'order-123',
+ *   token: 'token-456'
+ * });
+ * ```
+ */
+export function useConfirmOrder(options) {
+    return useMutation({
+        mutationFn: (data) => confirmOrder(data.orderId, data.token),
+        ...options,
+    });
+}