@instockng/api-client 1.0.0 → 1.0.2

package/dist/hooks/admin/stats.d.ts

@@ -0,0 +1,277 @@
+/**
+ * Type-safe admin RPC hooks for statistics
+ */
+import { UseQueryOptions } from '@tanstack/react-query';
+import { createAdminRpcClients } from '../../rpc-client';
+/**
+ * Hook to get dashboard statistics using admin RPC
+ */
+export declare function useGetStats(params?: {
+    brandId?: string;
+}, options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['stats']['index']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<{
+    overview: {
+        totalOrders: number;
+        pendingOrders: number;
+        shippedOrders: number;
+        deliveredOrders: number;
+        totalRevenue: number;
+    };
+    recentOrders: {
+        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>;

package/dist/hooks/admin/stats.js

@@ -0,0 +1,24 @@
+/**
+ * Type-safe admin RPC hooks for statistics
+ */
+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 dashboard statistics using admin RPC
+ */
+export function useGetStats(params, options) {
+    const { baseURL, authToken } = useApiConfig();
+    return useQueryUnwrapped({
+        queryKey: queryKeys.admin.stats.overview(params?.brandId),
+        queryFn: async () => {
+            const clients = createAdminRpcClients(baseURL);
+            const res = await clients.stats.index.$get({ query: params }, authHeaders(authToken));
+            if (!res.ok)
+                throw new Error(`Failed to fetch statistics: ${res.statusText}`);
+            return res.json();
+        },
+        ...options,
+    });
+}

package/dist/hooks/admin/variants.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Type-safe admin RPC hooks for variant management
+ */
+import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { createAdminRpcClients } from '../../rpc-client';
+/**
+ * Hook to search variants across all products using admin RPC
+ */
+export declare function useSearchVariants(params?: {
+    brandId?: string;
+    search?: string;
+}, options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['variants']['index']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<{
+    createdAt: string;
+    updatedAt: string;
+    price: number;
+    deletedAt: string;
+    name: string | null;
+    id: string;
+    isActive: boolean;
+    thumbnailUrl: string | null;
+    productId: string;
+    sku: string;
+    trackInventory: boolean;
+    lowStockThreshold: number | null;
+}[], Error>;
+/**
+ * Hook to list variants for a specific product using admin RPC
+ */
+export declare function useListProductVariants(productId: string, options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['variants']['products'][':productId']['variants']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<{
+    createdAt: string;
+    updatedAt: string;
+    price: number;
+    deletedAt: string;
+    name: string | null;
+    id: string;
+    isActive: boolean;
+    thumbnailUrl: string | null;
+    productId: string;
+    sku: string;
+    trackInventory: boolean;
+    lowStockThreshold: number | null;
+}[], Error>;
+/**
+ * Hook to create a variant for a product using admin RPC
+ */
+export declare function useCreateVariant(productId: string, options?: UseMutationOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['variants']['products'][':productId']['variants']['$post']>>['json']>>, Error, any>): import("@tanstack/react-query").UseMutationResult<{
+    createdAt: string;
+    updatedAt: string;
+    price: number;
+    deletedAt: string;
+    name: string | null;
+    id: string;
+    isActive: boolean;
+    thumbnailUrl: string | null;
+    productId: string;
+    sku: string;
+    trackInventory: boolean;
+    lowStockThreshold: number | null;
+} | {
+    error: {
+        code: string;
+        message: string;
+    };
+}, Error, any, unknown>;
+/**
+ * Hook to update a variant using admin RPC
+ */
+export declare function useUpdateVariant(variantId: string, options?: UseMutationOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['variants'][':id']['$patch']>>['json']>>, Error, any>): import("@tanstack/react-query").UseMutationResult<{
+    createdAt: string;
+    updatedAt: string;
+    price: number;
+    deletedAt: string;
+    name: string | null;
+    id: string;
+    isActive: boolean;
+    thumbnailUrl: string | null;
+    productId: string;
+    sku: string;
+    trackInventory: boolean;
+    lowStockThreshold: number | null;
+} | {
+    error: {
+        code: string;
+        message: string;
+    };
+}, Error, any, unknown>;
+/**
+ * Hook to get variant inventory across all warehouses using admin RPC
+ */
+export declare function useGetVariantInventory(variantId: string, options?: Omit<UseQueryOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['variants'][':id']['inventory']['$get']>>['json']>>, Error>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<{
+    variant: {
+        createdAt: string;
+        updatedAt: string;
+        price: number;
+        deletedAt: string;
+        name: string | null;
+        id: string;
+        isActive: boolean;
+        thumbnailUrl: string | null;
+        productId: string;
+        sku: string;
+        trackInventory: boolean;
+        lowStockThreshold: number | null;
+    };
+    totalInventory: number;
+    warehouses: {
+        warehouseId: string;
+        warehouseName: string;
+        inventoryCount: number;
+    }[];
+}, Error>;
+/**
+ * Hook to delete a variant using admin RPC
+ */
+export declare function useDeleteVariant(variantId: string, options?: UseMutationOptions<Awaited<ReturnType<Awaited<ReturnType<ReturnType<typeof createAdminRpcClients>['variants'][':id']['$delete']>>['json']>>, Error, void>): import("@tanstack/react-query").UseMutationResult<unknown, Error, void, unknown>;

package/dist/hooks/admin/variants.js

@@ -0,0 +1,121 @@
+/**
+ * Type-safe admin RPC hooks for variant management
+ */
+import { useMutation, useQueryClient } 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 search variants across all products using admin RPC
+ */
+export function useSearchVariants(params, options) {
+    const { baseURL, authToken } = useApiConfig();
+    return useQueryUnwrapped({
+        queryKey: queryKeys.admin.variants.search(params),
+        queryFn: async () => {
+            const clients = createAdminRpcClients(baseURL);
+            const res = await clients.variants.index.$get({ query: params }, authHeaders(authToken));
+            if (!res.ok)
+                throw new Error(`Failed to search variants: ${res.statusText}`);
+            return res.json();
+        },
+        ...options,
+    });
+}
+/**
+ * Hook to list variants for a specific product using admin RPC
+ */
+export function useListProductVariants(productId, options) {
+    const { baseURL, authToken } = useApiConfig();
+    return useQueryUnwrapped({
+        queryKey: queryKeys.admin.variants.byProduct(productId),
+        queryFn: async () => {
+            const clients = createAdminRpcClients(baseURL);
+            const res = await clients.variants.products[':productId'].variants.$get({ param: { productId } }, authHeaders(authToken));
+            if (!res.ok)
+                throw new Error(`Failed to fetch product variants: ${res.statusText}`);
+            return res.json();
+        },
+        ...options,
+    });
+}
+/**
+ * Hook to create a variant for a product using admin RPC
+ */
+export function useCreateVariant(productId, options) {
+    const { baseURL, authToken } = useApiConfig();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (data) => {
+            const clients = createAdminRpcClients(baseURL);
+            const res = await clients.variants.products[':productId'].variants.$post({ json: data, param: { productId } }, authHeaders(authToken));
+            if (!res.ok)
+                throw new Error(`Failed to create variant: ${res.statusText}`);
+            return res.json();
+        },
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: queryKeys.admin.variants.all });
+            queryClient.invalidateQueries({ queryKey: queryKeys.admin.products.detail(productId) });
+        },
+        ...options,
+    });
+}
+/**
+ * Hook to update a variant using admin RPC
+ */
+export function useUpdateVariant(variantId, options) {
+    const { baseURL, authToken } = useApiConfig();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (data) => {
+            const clients = createAdminRpcClients(baseURL);
+            const res = await clients.variants[':id'].$patch({ json: data, param: { id: variantId } }, authHeaders(authToken));
+            if (!res.ok)
+                throw new Error(`Failed to update variant: ${res.statusText}`);
+            return res.json();
+        },
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: queryKeys.admin.variants.detail(variantId) });
+            queryClient.invalidateQueries({ queryKey: queryKeys.admin.variants.all });
+        },
+        ...options,
+    });
+}
+/**
+ * Hook to get variant inventory across all warehouses using admin RPC
+ */
+export function useGetVariantInventory(variantId, options) {
+    const { baseURL, authToken } = useApiConfig();
+    return useQueryUnwrapped({
+        queryKey: queryKeys.admin.variants.inventory(variantId),
+        queryFn: async () => {
+            const clients = createAdminRpcClients(baseURL);
+            const res = await clients.variants[':id'].inventory.$get({ param: { id: variantId } }, authHeaders(authToken));
+            if (!res.ok)
+                throw new Error(`Failed to fetch variant inventory: ${res.statusText}`);
+            return res.json();
+        },
+        ...options,
+    });
+}
+/**
+ * Hook to delete a variant using admin RPC
+ */
+export function useDeleteVariant(variantId, options) {
+    const { baseURL, authToken } = useApiConfig();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async () => {
+            const clients = createAdminRpcClients(baseURL);
+            const res = await clients.variants[':id'].$delete({ param: { id: variantId } }, authHeaders(authToken));
+            if (!res.ok)
+                throw new Error(`Failed to delete variant: ${res.statusText}`);
+            return res.json();
+        },
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: queryKeys.admin.variants.all });
+        },
+        ...options,
+    });
+}