@instockng/api-client 1.0.25 → 1.0.27

package/dist/fetchers/brands.js

@@ -5,7 +5,7 @@
  * They can also be imported directly in Server Components.
  */
 import { createRpcClients } from '../rpc-client';
-import { API_BASE_URL } from '../provider';
+const API_URL = 'https://oms-api.instock.com.ng';
 /**
  * Fetch brand configuration by slug
  *
@@ -13,7 +13,7 @@ import { API_BASE_URL } from '../provider';
  * @returns Brand with metaPixelId and other configuration
  */
 export async function fetchBrandBySlug(slug) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.brands[':slug'].$get({
         param: { slug },
     });

package/dist/fetchers/carts.d.ts

@@ -1,6 +1,5 @@
 /**
  * Cart fetcher functions
- *
  * These are the actual data-fetching functions used by hooks.
  * They can also be imported directly in Server Components.
  */
@@ -4992,6 +4991,23 @@ export declare function checkoutCart(cartId: string, checkoutData: {
     prospectReason: import("@prisma/client").$Enums.ProspectReason | null;
     userActionToken: string;
 }>;
+/**
+ * Initiate checkout tracking
+ *
+ * @param cartId - Cart UUID
+ * @param data - Checking out user data and attribution cookies
+ * @returns Success status
+ */
+export declare function initiateCheckout(cartId: string, data: {
+    email?: string | null;
+    phone?: string | null;
+    fbc?: string;
+    fbp?: string;
+    ttp?: string;
+    ttclid?: string;
+}): Promise<{
+    success: true;
+}>;
 /**
  * Fetch recommended products for a cart
  *

package/dist/fetchers/carts.js

@@ -1,11 +1,10 @@
 /**
  * Cart fetcher functions
- *
  * These are the actual data-fetching functions used by hooks.
  * They can also be imported directly in Server Components.
  */
 import { createRpcClients } from '../rpc-client';
-import { API_BASE_URL } from '../provider';
+const API_URL = 'https://oms-api.instock.com.ng';
 /**
  * Fetch a cart by ID
  *
@@ -13,7 +12,7 @@ import { API_BASE_URL } from '../provider';
  * @returns Cart with items, brand, and delivery zone
  */
 export async function fetchCart(cartId) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.carts[':id'].$get({
         param: { id: cartId },
     });
@@ -29,7 +28,7 @@ export async function fetchCart(cartId) {
  * @returns Newly created cart
  */
 export async function createCart(brandSlug) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.carts.index.$post({
         json: { brandSlug },
     });
@@ -46,7 +45,7 @@ export async function createCart(brandSlug) {
  * @returns Updated cart
  */
 export async function updateCart(cartId, data) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.carts[':id'].$patch({
         param: { id: cartId },
         // @ts-expect-error - Hono RPC type inference issue
@@ -70,7 +69,7 @@ export async function updateCart(cartId, data) {
  * @returns Updated cart
  */
 export async function addCartItem(cartId, sku, quantity, fbc, fbp, ttp, ttclid) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.carts[':id'].items.$post({
         param: { id: cartId },
         // @ts-expect-error - Hono RPC type inference issue
@@ -90,7 +89,7 @@ export async function addCartItem(cartId, sku, quantity, fbc, fbp, ttp, ttclid)
  * @returns Updated cart
  */
 export async function updateCartItem(cartId, itemId, quantity) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.carts[':id'].items[':itemId'].$patch({
         param: { id: cartId, itemId },
         // @ts-expect-error - Hono RPC type inference issue
@@ -109,7 +108,7 @@ export async function updateCartItem(cartId, itemId, quantity) {
  * @returns Updated cart
  */
 export async function removeCartItem(cartId, itemId) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.carts[':id'].items[':itemId'].$delete({
         param: { id: cartId, itemId },
     });
@@ -126,7 +125,7 @@ export async function removeCartItem(cartId, itemId) {
  * @returns Updated cart
  */
 export async function applyDiscount(cartId, code) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.carts[':id']['apply-discount'].$post({
         param: { id: cartId },
         // @ts-expect-error - Hono RPC type inference issue
@@ -144,7 +143,7 @@ export async function applyDiscount(cartId, code) {
  * @returns Updated cart
  */
 export async function removeDiscount(cartId) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.carts[':id']['remove-discount'].$post({
         param: { id: cartId },
     });
@@ -161,7 +160,7 @@ export async function removeDiscount(cartId) {
  * @returns Created order
  */
 export async function checkoutCart(cartId, checkoutData) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.carts[':id'].checkout.$post({
         param: { id: cartId },
         // @ts-expect-error - Hono RPC type inference issue
@@ -172,6 +171,25 @@ export async function checkoutCart(cartId, checkoutData) {
     }
     return res.json();
 }
+/**
+ * Initiate checkout tracking
+ *
+ * @param cartId - Cart UUID
+ * @param data - Checking out user data and attribution cookies
+ * @returns Success status
+ */
+export async function initiateCheckout(cartId, data) {
+    const clients = createRpcClients(API_URL);
+    const res = await clients.carts[':id']['initiate-checkout'].$post({
+        param: { id: cartId },
+        // @ts-expect-error - Hono RPC type inference issue
+        json: data,
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to initiate checkout intent: ${res.statusText}`);
+    }
+    return res.json();
+}
 /**
  * Fetch recommended products for a cart
  *
@@ -180,7 +198,7 @@ export async function checkoutCart(cartId, checkoutData) {
  * @returns Array of recommended products from the same brand
  */
 export async function fetchCartRecommendations(cartId, limit) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.carts[':id'].recommendations.$get({
         param: { id: cartId },
         // @ts-ignore - Hono RPC type inference issue with query parameters

package/dist/fetchers/delivery-zones.js

@@ -5,7 +5,7 @@
  * They can also be imported directly in Server Components.
  */
 import { createRpcClients } from '../rpc-client';
-import { API_BASE_URL } from '../provider';
+const API_URL = 'https://oms-api.instock.com.ng';
 /**
  * Fetch delivery zones
  *
@@ -13,7 +13,7 @@ import { API_BASE_URL } from '../provider';
  * @returns List of delivery zones with states
  */
 export async function fetchDeliveryZones(brandId) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.deliveryZones.index.$get({
         query: brandId ? { brandId } : {},
     });

package/dist/fetchers/orders.js

@@ -5,7 +5,7 @@
  * They can also be imported directly in Server Components.
  */
 import { createRpcClients } from '../rpc-client';
-import { API_BASE_URL } from '../provider';
+const API_URL = 'https://oms-api.instock.com.ng';
 /**
  * Fetch an order by ID and token
  *
@@ -14,7 +14,7 @@ import { API_BASE_URL } from '../provider';
  * @returns Order with items, delivery zone, and brand
  */
 export async function fetchOrder(orderId, token) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.orders[':id'][':token'].$get({
         param: { id: orderId, token },
     });
@@ -31,7 +31,7 @@ export async function fetchOrder(orderId, token) {
  * @returns Confirmed order
  */
 export async function confirmOrder(orderId, token) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.orders.confirm.$post({
         json: { orderId, token },
     });
@@ -49,7 +49,7 @@ export async function confirmOrder(orderId, token) {
  * @returns Array of recommended products
  */
 export async function fetchOrderRecommendations(orderId, token, limit = 4) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.orders[':id'][':token'].recommendations.$get({
         param: { id: orderId, token },
         // @ts-ignore - Hono RPC type inference issue with query parameters

package/dist/fetchers/products.js

@@ -5,7 +5,7 @@
  * They can also be imported directly in Server Components.
  */
 import { createRpcClients } from '../rpc-client';
-import { API_BASE_URL } from '../provider';
+const API_URL = 'https://oms-api.instock.com.ng';
 /**
  * Fetch products by brand ID
  *
@@ -13,7 +13,7 @@ import { API_BASE_URL } from '../provider';
  * @returns Products for the brand with variants and availability
  */
 export async function fetchProductsByBrand(brandId) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.products[':brandId'].$get({
         param: { brandId },
     });
@@ -29,7 +29,7 @@ export async function fetchProductsByBrand(brandId) {
  * @returns Product with variants and availability
  */
 export async function fetchProductBySlug(slug) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.products.product[':slug'].$get({
         param: { slug },
     });
@@ -46,7 +46,7 @@ export async function fetchProductBySlug(slug) {
  * @returns List of add-on products
  */
 export async function fetchProductAddons(slug, limit) {
-    const clients = createRpcClients(API_BASE_URL);
+    const clients = createRpcClients(API_URL);
     const res = await clients.productAddons[':slug'].$get({
         param: { slug },
         query: limit !== undefined ? { limit: String(limit) } : {},

package/dist/hooks/public/carts.d.ts

@@ -5,7 +5,7 @@
  * providing end-to-end type safety without code generation.
  */
 import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
-import { fetchCart, updateCart, createCart, addCartItem, updateCartItem, removeCartItem, applyDiscount, removeDiscount, checkoutCart, fetchCartRecommendations } from '../../fetchers/carts';
+import { fetchCart, updateCart, createCart, addCartItem, updateCartItem, removeCartItem, applyDiscount, removeDiscount, checkoutCart, initiateCheckout, fetchCartRecommendations } from '../../fetchers/carts';
 /**
  * Hook to get cart by ID using RPC
  *
@@ -5068,6 +5068,28 @@ export declare function useCheckoutCart(cartId: string, options?: UseMutationOpt
     ttp?: string;
     ttclid?: string;
 }, unknown>;
+/**
+ * Hook to initiate checkout tracking using RPC
+ *
+ * @param cartId - Cart UUID
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const initiateCheckout = useInitiateCheckout('cart-123');
+ * initiateCheckout.mutate({ email: 'user@example.com' });
+ * ```
+ */
+export declare function useInitiateCheckout(cartId: string, options?: UseMutationOptions<Awaited<ReturnType<typeof initiateCheckout>>, Error, Parameters<typeof initiateCheckout>[1]>): import("@tanstack/react-query").UseMutationResult<{
+    success: true;
+}, Error, {
+    email?: string | null;
+    phone?: string | null;
+    fbc?: string;
+    fbp?: string;
+    ttp?: string;
+    ttclid?: string;
+}, unknown>;
 /**
  * Hook to get recommended products for a cart using RPC
  *

package/dist/hooks/public/carts.js

@@ -7,7 +7,7 @@
 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, fetchCartRecommendations, } from '../../fetchers/carts';
+import { fetchCart, updateCart, createCart, addCartItem, updateCartItem, removeCartItem, applyDiscount, removeDiscount, checkoutCart, initiateCheckout, fetchCartRecommendations, } from '../../fetchers/carts';
 /**
  * Hook to get cart by ID using RPC
  *
@@ -217,6 +217,24 @@ export function useCheckoutCart(cartId, options) {
         ...options,
     });
 }
+/**
+ * Hook to initiate checkout tracking using RPC
+ *
+ * @param cartId - Cart UUID
+ * @param options - React Query mutation options
+ *
+ * @example
+ * ```tsx
+ * const initiateCheckout = useInitiateCheckout('cart-123');
+ * initiateCheckout.mutate({ email: 'user@example.com' });
+ * ```
+ */
+export function useInitiateCheckout(cartId, options) {
+    return useMutation({
+        mutationFn: (data) => initiateCheckout(cartId, data),
+        ...options,
+    });
+}
 /**
  * Hook to get recommended products for a cart using RPC
  *

package/dist/hooks/public/index.d.ts

@@ -4,7 +4,7 @@
  * Export all RPC hooks for use in applications
  */
 export * from './carts';
-export * from './orders';
+export * from './brands';
 export * from './products';
+export * from './orders';
 export * from './delivery-zones';
-export * from './brands';

package/dist/hooks/public/index.js

@@ -4,7 +4,7 @@
  * Export all RPC hooks for use in applications
  */
 export * from './carts';
-export * from './orders';
+export * from './brands';
 export * from './products';
+export * from './orders';
 export * from './delivery-zones';
-export * from './brands';

package/dist/provider.d.ts

@@ -16,7 +16,6 @@ export interface ApiClientProviderProps {
     onError?: (error: AxiosError) => void;
     queryClient?: QueryClient;
 }
-export declare const API_BASE_URL = "https://oms-api.instock.com.ng";
 /**
  * Provider component that initializes the API client and React Query
  *

package/dist/provider.js

@@ -6,7 +6,6 @@ import { createContext, useContext, useEffect, useMemo } from 'react';
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { initializeApiClient } from './client';
 const ApiClientContext = createContext(null);
-export const API_BASE_URL = 'https://oms-api.instock.com.ng';
 /**
  * Provider component that initializes the API client and React Query
  *
@@ -19,7 +18,7 @@ export const API_BASE_URL = 'https://oms-api.instock.com.ng';
  * </ApiClientProvider>
  * ```
  */
-export function ApiClientProvider({ children, baseURL = API_BASE_URL, getAuthToken, onError, queryClient: externalQueryClient }) {
+export function ApiClientProvider({ children, baseURL = 'https://oms-api.instock.com.ng', getAuthToken, onError, queryClient: externalQueryClient }) {
     // Initialize client synchronously on first render
     const config = {
         baseURL,

package/dist/rpc-client.d.ts

@@ -4696,6 +4696,51 @@ export declare function createRpcClients(baseURL: string): {
                 }>;
             };
         };
+    } & {
+        ":id": {
+            "initiate-checkout": import("hono/client").ClientRequest<{
+                $post: {
+                    input: {
+                        param: {
+                            id: string;
+                        };
+                    };
+                    output: {
+                        error: {
+                            code: string;
+                            message: string;
+                        };
+                    };
+                    outputFormat: "json";
+                    status: 404;
+                } | {
+                    input: {
+                        param: {
+                            id: string;
+                        };
+                    };
+                    output: {
+                        success: true;
+                    };
+                    outputFormat: "json";
+                    status: 200;
+                } | {
+                    input: {
+                        param: {
+                            id: string;
+                        };
+                    };
+                    output: {
+                        error: {
+                            code: string;
+                            message: any;
+                        };
+                    };
+                    outputFormat: "json";
+                    status: 500;
+                };
+            }>;
+        };
     } & {
         ":id": {
             checkout: import("hono/client").ClientRequest<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instockng/api-client",
-  "version": "1.0.25",
+  "version": "1.0.27",
   "description": "React Query hooks for OMS API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",