@withvlibe/base-sdk 1.0.1 → 1.1.1

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { j as BaseRecord, V as VlibeBaseDatabase, w as UseCollectionOptions, v as UseCollectionReturn, x as UseKVReturn, c as VlibeBaseAuth, y as UseAuthReturn } from './VlibeBaseAuth-BxS9T0vB.js';
-export { z as UsePaymentsReturn, l as VlibeUser } from './VlibeBaseAuth-BxS9T0vB.js';
+import { k as BaseRecord, V as VlibeBaseDatabase, J as UseCollectionOptions, I as UseCollectionReturn, K as UseKVReturn, c as VlibeBaseAuth, L as UseAuthReturn, d as VlibeBaseEcommerce, q as Product, v as CreateProductInput, t as CartItem, s as Address, O as Order, u as CartItemWithProduct } from './VlibeBaseEcommerce-DXjHdN_L.js';
+export { w as CreateOrderInput, N as UsePaymentsReturn, m as VlibeUser } from './VlibeBaseEcommerce-DXjHdN_L.js';
 
 /**
  * React hook for working with a database collection
@@ -93,4 +93,109 @@ declare function useKV<T = unknown>(db: VlibeBaseDatabase, key: string): UseKVRe
  */
 declare function useAuth(auth: VlibeBaseAuth, initialToken?: string | null): UseAuthReturn;
 
-export { BaseRecord, UseAuthReturn, UseCollectionOptions, UseCollectionReturn, UseKVReturn, useAuth, useCollection, useKV };
+interface UseProductsOptions {
+    category?: string;
+    isActive?: boolean;
+    autoLoad?: boolean;
+}
+interface UseProductsReturn {
+    products: Product[];
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    createProduct: (input: CreateProductInput) => Promise<Product>;
+    updateProduct: (productId: string, updates: Partial<Product>) => Promise<Product>;
+    deleteProduct: (productId: string) => Promise<void>;
+    updateInventory: (productId: string, quantity: number, operation: 'set' | 'increment' | 'decrement') => Promise<Product>;
+}
+/**
+ * React hook for managing products
+ *
+ * @param ecommerce - VlibeBaseEcommerce instance
+ * @param options - Optional filtering and configuration
+ * @returns Product list with CRUD operations
+ *
+ * @example
+ * ```tsx
+ * const { products, loading, createProduct } = useProducts(ecommerce, { isActive: true });
+ *
+ * const handleCreate = async () => {
+ *   await createProduct({
+ *     name: 'T-Shirt',
+ *     price: 2999,
+ *     stock: 50,
+ *     currency: 'usd'
+ *   });
+ * };
+ * ```
+ */
+declare function useProducts(ecommerce: VlibeBaseEcommerce, options?: UseProductsOptions): UseProductsReturn;
+
+interface UseCartReturn {
+    cart: CartItem[];
+    itemCount: number;
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    addItem: (item: CartItem) => Promise<CartItem[]>;
+    updateItem: (productId: string, quantity: number) => Promise<CartItem[]>;
+    removeItem: (productId: string) => Promise<CartItem[]>;
+    clear: () => Promise<void>;
+    checkout: (shippingAddress: Address, paymentMethodId?: string) => Promise<Order>;
+    calculateTotal: () => Promise<any>;
+    getCartWithDetails: () => Promise<CartItemWithProduct[]>;
+}
+/**
+ * React hook for managing shopping cart
+ *
+ * @param ecommerce - VlibeBaseEcommerce instance
+ * @param userId - User ID for cart ownership
+ * @returns Shopping cart with add/update/remove/checkout operations
+ *
+ * @example
+ * ```tsx
+ * const { cart, itemCount, addItem, checkout } = useCart(ecommerce, userId);
+ *
+ * const handleAddToCart = async (productId: string) => {
+ *   await addItem({ productId, quantity: 1 });
+ * };
+ *
+ * const handleCheckout = async () => {
+ *   const order = await checkout(shippingAddress, paymentMethodId);
+ * };
+ * ```
+ */
+declare function useCart(ecommerce: VlibeBaseEcommerce, userId: string): UseCartReturn;
+
+interface UseOrdersOptions {
+    userId?: string;
+    status?: Order['status'];
+    autoLoad?: boolean;
+}
+interface UseOrdersReturn {
+    orders: Order[];
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    updateStatus: (orderId: string, status: Order['status']) => Promise<Order>;
+    cancelOrder: (orderId: string, restoreInventory?: boolean) => Promise<Order>;
+}
+/**
+ * React hook for managing orders
+ *
+ * @param ecommerce - VlibeBaseEcommerce instance
+ * @param options - Optional filtering and configuration
+ * @returns Order list with status management operations
+ *
+ * @example
+ * ```tsx
+ * const { orders, loading, updateStatus } = useOrders(ecommerce, { userId: 'user123' });
+ *
+ * const handleShip = async (orderId: string) => {
+ *   await updateStatus(orderId, 'shipped');
+ * };
+ * ```
+ */
+declare function useOrders(ecommerce: VlibeBaseEcommerce, options?: UseOrdersOptions): UseOrdersReturn;
+
+export { BaseRecord, CartItem, CartItemWithProduct, CreateProductInput, Order, Product, UseAuthReturn, type UseCartReturn, UseCollectionOptions, UseCollectionReturn, UseKVReturn, type UseOrdersOptions, type UseOrdersReturn, type UseProductsOptions, type UseProductsReturn, useAuth, useCart, useCollection, useKV, useOrders, useProducts };

package/dist/react.js

@@ -22,8 +22,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var react_exports = {};
 __export(react_exports, {
   useAuth: () => useAuth,
+  useCart: () => useCart,
   useCollection: () => useCollection,
-  useKV: () => useKV
+  useKV: () => useKV,
+  useOrders: () => useOrders,
+  useProducts: () => useProducts
 });
 module.exports = __toCommonJS(react_exports);
 
@@ -265,9 +268,181 @@ function useAuth(auth, initialToken) {
     hasSubscription
   };
 }
+
+// src/hooks/useProducts.ts
+var import_react4 = require("react");
+function useProducts(ecommerce, options) {
+  const [products, setProducts] = (0, import_react4.useState)([]);
+  const [loading, setLoading] = (0, import_react4.useState)(true);
+  const [error, setError] = (0, import_react4.useState)(null);
+  const loadProducts = (0, import_react4.useCallback)(async () => {
+    try {
+      setLoading(true);
+      setError(null);
+      const result = await ecommerce.listProducts(options);
+      setProducts(result.products);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to load products"));
+    } finally {
+      setLoading(false);
+    }
+  }, [ecommerce, options?.category, options?.isActive]);
+  (0, import_react4.useEffect)(() => {
+    if (options?.autoLoad !== false) {
+      loadProducts();
+    }
+  }, [loadProducts, options?.autoLoad]);
+  const createProduct = (0, import_react4.useCallback)(async (input) => {
+    const product = await ecommerce.createProduct(input);
+    setProducts((prev) => [product, ...prev]);
+    return product;
+  }, [ecommerce]);
+  const updateProduct = (0, import_react4.useCallback)(async (productId, updates) => {
+    const product = await ecommerce.updateProduct(productId, updates);
+    setProducts((prev) => prev.map((p) => p.id === productId ? product : p));
+    return product;
+  }, [ecommerce]);
+  const deleteProduct = (0, import_react4.useCallback)(async (productId) => {
+    await ecommerce.deleteProduct(productId);
+    setProducts((prev) => prev.filter((p) => p.id !== productId));
+  }, [ecommerce]);
+  const updateInventory = (0, import_react4.useCallback)(async (productId, quantity, operation) => {
+    const product = await ecommerce.updateInventory(productId, quantity, operation);
+    setProducts((prev) => prev.map((p) => p.id === productId ? product : p));
+    return product;
+  }, [ecommerce]);
+  return {
+    products,
+    loading,
+    error,
+    refresh: loadProducts,
+    createProduct,
+    updateProduct,
+    deleteProduct,
+    updateInventory
+  };
+}
+
+// src/hooks/useCart.ts
+var import_react5 = require("react");
+function useCart(ecommerce, userId) {
+  const [cart, setCart] = (0, import_react5.useState)([]);
+  const [loading, setLoading] = (0, import_react5.useState)(true);
+  const [error, setError] = (0, import_react5.useState)(null);
+  const loadCart = (0, import_react5.useCallback)(async () => {
+    if (!userId) {
+      setLoading(false);
+      return;
+    }
+    try {
+      setLoading(true);
+      setError(null);
+      const items = await ecommerce.getCart(userId);
+      setCart(items);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to load cart"));
+    } finally {
+      setLoading(false);
+    }
+  }, [ecommerce, userId]);
+  (0, import_react5.useEffect)(() => {
+    if (userId) {
+      loadCart();
+    }
+  }, [loadCart, userId]);
+  const addItem = (0, import_react5.useCallback)(async (item) => {
+    const updated = await ecommerce.addToCart(userId, item);
+    setCart(updated);
+    return updated;
+  }, [ecommerce, userId]);
+  const updateItem = (0, import_react5.useCallback)(async (productId, quantity) => {
+    const updated = await ecommerce.updateCartItem(userId, productId, quantity);
+    setCart(updated);
+    return updated;
+  }, [ecommerce, userId]);
+  const removeItem = (0, import_react5.useCallback)(async (productId) => {
+    return updateItem(productId, 0);
+  }, [updateItem]);
+  const clear = (0, import_react5.useCallback)(async () => {
+    await ecommerce.clearCart(userId);
+    setCart([]);
+  }, [ecommerce, userId]);
+  const checkout = (0, import_react5.useCallback)(async (shippingAddress, paymentMethodId) => {
+    const order = await ecommerce.checkout(userId, shippingAddress, paymentMethodId);
+    setCart([]);
+    return order;
+  }, [ecommerce, userId]);
+  const calculateTotal = (0, import_react5.useCallback)(async () => {
+    return ecommerce.calculateOrderTotal(cart);
+  }, [ecommerce, cart]);
+  const getCartWithDetails = (0, import_react5.useCallback)(async () => {
+    return ecommerce.getCartWithDetails(userId);
+  }, [ecommerce, userId]);
+  const itemCount = cart.reduce((sum, item) => sum + item.quantity, 0);
+  return {
+    cart,
+    itemCount,
+    loading,
+    error,
+    refresh: loadCart,
+    addItem,
+    updateItem,
+    removeItem,
+    clear,
+    checkout,
+    calculateTotal,
+    getCartWithDetails
+  };
+}
+
+// src/hooks/useOrders.ts
+var import_react6 = require("react");
+function useOrders(ecommerce, options) {
+  const [orders, setOrders] = (0, import_react6.useState)([]);
+  const [loading, setLoading] = (0, import_react6.useState)(true);
+  const [error, setError] = (0, import_react6.useState)(null);
+  const loadOrders = (0, import_react6.useCallback)(async () => {
+    try {
+      setLoading(true);
+      setError(null);
+      const result = await ecommerce.listOrders(options);
+      setOrders(result.orders);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to load orders"));
+    } finally {
+      setLoading(false);
+    }
+  }, [ecommerce, options?.userId, options?.status]);
+  (0, import_react6.useEffect)(() => {
+    if (options?.autoLoad !== false) {
+      loadOrders();
+    }
+  }, [loadOrders, options?.autoLoad]);
+  const updateStatus = (0, import_react6.useCallback)(async (orderId, status) => {
+    const order = await ecommerce.updateOrderStatus(orderId, status);
+    setOrders((prev) => prev.map((o) => o.id === orderId ? order : o));
+    return order;
+  }, [ecommerce]);
+  const cancelOrder = (0, import_react6.useCallback)(async (orderId, restoreInventory = true) => {
+    const order = await ecommerce.cancelOrder(orderId, restoreInventory);
+    setOrders((prev) => prev.map((o) => o.id === orderId ? order : o));
+    return order;
+  }, [ecommerce]);
+  return {
+    orders,
+    loading,
+    error,
+    refresh: loadOrders,
+    updateStatus,
+    cancelOrder
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   useAuth,
+  useCart,
   useCollection,
-  useKV
+  useKV,
+  useOrders,
+  useProducts
 });

package/dist/react.mjs

@@ -238,8 +238,180 @@ function useAuth(auth, initialToken) {
     hasSubscription
   };
 }
+
+// src/hooks/useProducts.ts
+import { useState as useState4, useEffect as useEffect4, useCallback as useCallback4 } from "react";
+function useProducts(ecommerce, options) {
+  const [products, setProducts] = useState4([]);
+  const [loading, setLoading] = useState4(true);
+  const [error, setError] = useState4(null);
+  const loadProducts = useCallback4(async () => {
+    try {
+      setLoading(true);
+      setError(null);
+      const result = await ecommerce.listProducts(options);
+      setProducts(result.products);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to load products"));
+    } finally {
+      setLoading(false);
+    }
+  }, [ecommerce, options?.category, options?.isActive]);
+  useEffect4(() => {
+    if (options?.autoLoad !== false) {
+      loadProducts();
+    }
+  }, [loadProducts, options?.autoLoad]);
+  const createProduct = useCallback4(async (input) => {
+    const product = await ecommerce.createProduct(input);
+    setProducts((prev) => [product, ...prev]);
+    return product;
+  }, [ecommerce]);
+  const updateProduct = useCallback4(async (productId, updates) => {
+    const product = await ecommerce.updateProduct(productId, updates);
+    setProducts((prev) => prev.map((p) => p.id === productId ? product : p));
+    return product;
+  }, [ecommerce]);
+  const deleteProduct = useCallback4(async (productId) => {
+    await ecommerce.deleteProduct(productId);
+    setProducts((prev) => prev.filter((p) => p.id !== productId));
+  }, [ecommerce]);
+  const updateInventory = useCallback4(async (productId, quantity, operation) => {
+    const product = await ecommerce.updateInventory(productId, quantity, operation);
+    setProducts((prev) => prev.map((p) => p.id === productId ? product : p));
+    return product;
+  }, [ecommerce]);
+  return {
+    products,
+    loading,
+    error,
+    refresh: loadProducts,
+    createProduct,
+    updateProduct,
+    deleteProduct,
+    updateInventory
+  };
+}
+
+// src/hooks/useCart.ts
+import { useState as useState5, useEffect as useEffect5, useCallback as useCallback5 } from "react";
+function useCart(ecommerce, userId) {
+  const [cart, setCart] = useState5([]);
+  const [loading, setLoading] = useState5(true);
+  const [error, setError] = useState5(null);
+  const loadCart = useCallback5(async () => {
+    if (!userId) {
+      setLoading(false);
+      return;
+    }
+    try {
+      setLoading(true);
+      setError(null);
+      const items = await ecommerce.getCart(userId);
+      setCart(items);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to load cart"));
+    } finally {
+      setLoading(false);
+    }
+  }, [ecommerce, userId]);
+  useEffect5(() => {
+    if (userId) {
+      loadCart();
+    }
+  }, [loadCart, userId]);
+  const addItem = useCallback5(async (item) => {
+    const updated = await ecommerce.addToCart(userId, item);
+    setCart(updated);
+    return updated;
+  }, [ecommerce, userId]);
+  const updateItem = useCallback5(async (productId, quantity) => {
+    const updated = await ecommerce.updateCartItem(userId, productId, quantity);
+    setCart(updated);
+    return updated;
+  }, [ecommerce, userId]);
+  const removeItem = useCallback5(async (productId) => {
+    return updateItem(productId, 0);
+  }, [updateItem]);
+  const clear = useCallback5(async () => {
+    await ecommerce.clearCart(userId);
+    setCart([]);
+  }, [ecommerce, userId]);
+  const checkout = useCallback5(async (shippingAddress, paymentMethodId) => {
+    const order = await ecommerce.checkout(userId, shippingAddress, paymentMethodId);
+    setCart([]);
+    return order;
+  }, [ecommerce, userId]);
+  const calculateTotal = useCallback5(async () => {
+    return ecommerce.calculateOrderTotal(cart);
+  }, [ecommerce, cart]);
+  const getCartWithDetails = useCallback5(async () => {
+    return ecommerce.getCartWithDetails(userId);
+  }, [ecommerce, userId]);
+  const itemCount = cart.reduce((sum, item) => sum + item.quantity, 0);
+  return {
+    cart,
+    itemCount,
+    loading,
+    error,
+    refresh: loadCart,
+    addItem,
+    updateItem,
+    removeItem,
+    clear,
+    checkout,
+    calculateTotal,
+    getCartWithDetails
+  };
+}
+
+// src/hooks/useOrders.ts
+import { useState as useState6, useEffect as useEffect6, useCallback as useCallback6 } from "react";
+function useOrders(ecommerce, options) {
+  const [orders, setOrders] = useState6([]);
+  const [loading, setLoading] = useState6(true);
+  const [error, setError] = useState6(null);
+  const loadOrders = useCallback6(async () => {
+    try {
+      setLoading(true);
+      setError(null);
+      const result = await ecommerce.listOrders(options);
+      setOrders(result.orders);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to load orders"));
+    } finally {
+      setLoading(false);
+    }
+  }, [ecommerce, options?.userId, options?.status]);
+  useEffect6(() => {
+    if (options?.autoLoad !== false) {
+      loadOrders();
+    }
+  }, [loadOrders, options?.autoLoad]);
+  const updateStatus = useCallback6(async (orderId, status) => {
+    const order = await ecommerce.updateOrderStatus(orderId, status);
+    setOrders((prev) => prev.map((o) => o.id === orderId ? order : o));
+    return order;
+  }, [ecommerce]);
+  const cancelOrder = useCallback6(async (orderId, restoreInventory = true) => {
+    const order = await ecommerce.cancelOrder(orderId, restoreInventory);
+    setOrders((prev) => prev.map((o) => o.id === orderId ? order : o));
+    return order;
+  }, [ecommerce]);
+  return {
+    orders,
+    loading,
+    error,
+    refresh: loadOrders,
+    updateStatus,
+    cancelOrder
+  };
+}
 export {
   useAuth,
+  useCart,
   useCollection,
-  useKV
+  useKV,
+  useOrders,
+  useProducts
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withvlibe/base-sdk",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "SDK for Vlibe Base Apps - includes authentication, database, payments with transaction fees, and category-specific helpers for websites, SaaS, and e-commerce",
   "main": "dist/index.js",
   "module": "dist/index.mjs",