@instockng/api-client 1.0.0 → 1.0.1

package/dist/fetchers/carts.js

@@ -0,0 +1,167 @@
+/**
+ * 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) {
+    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) {
+    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, data) {
+    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, sku, quantity) {
+    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, itemId, quantity) {
+    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, itemId) {
+    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, code) {
+    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) {
+    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, checkoutData) {
+    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/dist/fetchers/delivery-zones.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Delivery zone 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
+ */
+/**
+ * Fetch delivery zones
+ *
+ * @param brandId - Optional brand UUID to filter brand-specific zones
+ * @returns List of delivery zones with states
+ */
+export declare function fetchDeliveryZones(brandId?: string): Promise<{
+    id: string;
+    name: string;
+    zones: {
+        id: string;
+        name: string;
+        deliveryCost: number;
+        freeShippingThreshold: number;
+        allowCOD: boolean;
+        allowOnline: boolean;
+        waybillOnly: boolean;
+        estimatedDays: number;
+    }[];
+}[]>;

package/{src/fetchers/delivery-zones.ts → dist/fetchers/delivery-zones.js}

@@ -6,24 +6,21 @@
  *
  * API URL is hardcoded to https://oms-api.instock.ng
  */
-
 import { createRpcClients } from '../rpc-client';
-
 const API_URL = 'https://oms-api.instock.ng';
-
 /**
  * Fetch delivery zones
  *
  * @param brandId - Optional brand UUID to filter brand-specific zones
  * @returns List of delivery zones with states
  */
-export async function fetchDeliveryZones(brandId?: string) {
-  const clients = createRpcClients(API_URL);
-  const res = await clients.deliveryZones.index.$get({
-    query: brandId ? { brandId } : {},
-  });
-  if (!res.ok) {
-    throw new Error(`Failed to fetch delivery zones: ${res.statusText}`);
-  }
-  return res.json();
+export async function fetchDeliveryZones(brandId) {
+    const clients = createRpcClients(API_URL);
+    const res = await clients.deliveryZones.index.$get({
+        query: brandId ? { brandId } : {},
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch delivery zones: ${res.statusText}`);
+    }
+    return res.json();
 }

package/{src/fetchers/index.ts → dist/fetchers/index.d.ts}

@@ -15,7 +15,6 @@
  * }
  * ```
  */
-
 export * from './products';
 export * from './carts';
 export * from './orders';

package/dist/fetchers/index.js

@@ -0,0 +1,21 @@
+/**
+ * Data fetcher functions for Server Components
+ *
+ * These functions can be used directly in Next.js Server Components
+ * without needing React hooks. They use the same underlying logic
+ * as the client-side hooks, ensuring no code duplication.
+ *
+ * @example Server Component
+ * ```tsx
+ * import { fetchProductBySlug, fetchCart } from '@oms/api-client/fetchers';
+ *
+ * export default async function ProductPage({ params }) {
+ *   const product = await fetchProductBySlug(params.slug);
+ *   return <div>{product.name}</div>;
+ * }
+ * ```
+ */
+export * from './products';
+export * from './carts';
+export * from './orders';
+export * from './delivery-zones';

package/dist/fetchers/orders.d.ts

@@ -0,0 +1,282 @@
+/**
+ * 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
+ */
+/**
+ * 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 declare function fetchOrder(orderId: string, token: string): Promise<{
+    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;
+    };
+    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;
+}>;
+/**
+ * Confirm a prospect order
+ *
+ * @param orderId - Order UUID
+ * @param token - User action token
+ * @returns Confirmed order
+ */
+export declare function confirmOrder(orderId: string, token: string): Promise<unknown>;

package/dist/fetchers/orders.js

@@ -0,0 +1,44 @@
+/**
+ * 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, token) {
+    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, token) {
+    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();
+}