@withvlibe/base-sdk 1.1.0 → 1.1.1

package/README.md

@@ -309,6 +309,290 @@ const products = await db.query<Product>('products', { where: { isActive: true }
 const orders = await db.query<Order>('orders', { where: { userId: user.id } });
 ```
 
+## E-Commerce
+
+The SDK provides specialized e-commerce functionality through `VlibeBaseEcommerce`.
+
+### Setup
+
+```typescript
+import { VlibeBaseEcommerce } from '@withvlibe/base-sdk';
+
+// Initialize with database client
+export const ecommerce = new VlibeBaseEcommerce(db);
+```
+
+### Products
+
+```typescript
+// Create a product
+const product = await ecommerce.createProduct({
+  name: 'Premium T-Shirt',
+  description: 'High-quality cotton t-shirt',
+  price: 2999, // $29.99 in cents
+  currency: 'usd',
+  stock: 100,
+  images: ['https://example.com/tshirt.jpg'],
+  category: 'apparel',
+  isActive: true,
+});
+
+// List products
+const { products, total } = await ecommerce.listProducts({
+  category: 'apparel',
+  isActive: true,
+  sortBy: 'created_at',
+  limit: 20,
+});
+
+// Update inventory
+await ecommerce.updateInventory(productId, 50, 'set');
+await ecommerce.updateInventory(productId, 5, 'increment');
+await ecommerce.updateInventory(productId, 3, 'decrement');
+
+// Get low stock products
+const lowStock = await ecommerce.getLowStockProducts(10); // threshold: 10
+```
+
+### Shopping Cart
+
+```typescript
+// Add to cart
+await ecommerce.addToCart(userId, {
+  productId: 'product-123',
+  quantity: 2,
+});
+
+// Get cart (lightweight - only IDs and quantities)
+const cart = await ecommerce.getCart(userId);
+// Returns: [{ productId: '...', quantity: 2 }]
+
+// Get cart with full product details
+const detailedCart = await ecommerce.getCartWithDetails(userId);
+// Returns: [{ productId: '...', quantity: 2, product: {...}, lineTotal: 5998 }]
+
+// Update quantity
+await ecommerce.updateCartItem(userId, productId, 5);
+
+// Remove item (set quantity to 0)
+await ecommerce.updateCartItem(userId, productId, 0);
+
+// Calculate order totals
+const calculation = await ecommerce.calculateOrderTotal(cart);
+console.log('Subtotal:', calculation.subtotal);
+console.log('Tax:', calculation.tax);
+console.log('Shipping:', calculation.shipping);
+console.log('Total:', calculation.total);
+
+// Checkout (creates order and clears cart)
+const order = await ecommerce.checkout(userId, {
+  line1: '123 Main St',
+  city: 'San Francisco',
+  state: 'CA',
+  postalCode: '94102',
+  country: 'US',
+}, paymentMethodId);
+```
+
+### Orders
+
+```typescript
+// Create an order directly
+const order = await ecommerce.createOrder({
+  userId: 'user-123',
+  items: [
+    { productId: 'product-1', quantity: 2 },
+    { productId: 'product-2', quantity: 1 },
+  ],
+  shippingAddress: {
+    line1: '123 Main St',
+    city: 'San Francisco',
+    state: 'CA',
+    postalCode: '94102',
+    country: 'US',
+  },
+});
+
+// List orders
+const { orders, total } = await ecommerce.listOrders({
+  userId: 'user-123',
+  status: 'pending',
+  limit: 10,
+});
+
+// Update order status
+await ecommerce.updateOrderStatus(orderId, 'shipped');
+
+// Cancel order (optionally restore inventory)
+await ecommerce.cancelOrder(orderId, true);
+```
+
+### Analytics
+
+```typescript
+// Revenue stats
+const stats = await ecommerce.getRevenueStats('month');
+console.log('Revenue:', stats.totalRevenue);
+console.log('Orders:', stats.totalOrders);
+console.log('AOV:', stats.averageOrderValue);
+console.log('Trend:', stats.trend.revenue); // % change
+
+// Top products
+const topProducts = await ecommerce.getTopProducts(10, 'week');
+
+// Order statistics
+const orderStats = await ecommerce.getOrderStats();
+console.log('Pending:', orderStats.pending);
+console.log('Delivered:', orderStats.delivered);
+```
+
+### React Hooks for E-Commerce
+
+```tsx
+import { useProducts, useCart, useOrders } from '@withvlibe/base-sdk/react';
+
+function ProductList() {
+  const { products, loading, createProduct, updateProduct } = useProducts(ecommerce, {
+    category: 'apparel',
+    isActive: true,
+  });
+
+  if (loading) return <div>Loading...</div>;
+
+  return (
+    <div>
+      {products.map(product => (
+        <div key={product.id}>
+          <h3>{product.name}</h3>
+          <p>${(product.price / 100).toFixed(2)}</p>
+          <p>Stock: {product.stock}</p>
+        </div>
+      ))}
+    </div>
+  );
+}
+
+function ShoppingCart({ userId }: { userId: string }) {
+  const { cart, itemCount, addItem, updateItem, removeItem, checkout, getCartWithDetails } = useCart(ecommerce, userId);
+  const [detailedItems, setDetailedItems] = useState([]);
+
+  useEffect(() => {
+    // Load cart with product details
+    const loadDetails = async () => {
+      const items = await getCartWithDetails();
+      setDetailedItems(items);
+    };
+    loadDetails();
+  }, [getCartWithDetails]);
+
+  return (
+    <div>
+      <h2>Cart ({itemCount} items)</h2>
+      {detailedItems.map(item => (
+        <div key={item.productId}>
+          <h3>{item.product.name}</h3>
+          <p>${(item.product.price / 100).toFixed(2)} x {item.quantity}</p>
+          <p>Subtotal: ${(item.lineTotal / 100).toFixed(2)}</p>
+          <button onClick={() => updateItem(item.productId, item.quantity + 1)}>+</button>
+          <button onClick={() => updateItem(item.productId, item.quantity - 1)}>-</button>
+          <button onClick={() => removeItem(item.productId)}>Remove</button>
+        </div>
+      ))}
+      <button onClick={() => checkout(shippingAddress)}>Checkout</button>
+    </div>
+  );
+}
+
+function OrderHistory({ userId }: { userId: string }) {
+  const { orders, loading, updateStatus, cancelOrder } = useOrders(ecommerce, { userId });
+
+  if (loading) return <div>Loading...</div>;
+
+  return (
+    <div>
+      {orders.map(order => (
+        <div key={order.id}>
+          <h3>Order #{order.id}</h3>
+          <p>Status: {order.status}</p>
+          <p>Total: ${(order.total / 100).toFixed(2)}</p>
+          <ul>
+            {order.items.map(item => (
+              <li key={item.productId}>
+                {item.name} x {item.quantity} - ${(item.price / 100).toFixed(2)}
+              </li>
+            ))}
+          </ul>
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
+### Database Schema
+
+Create these tables in your database:
+
+```typescript
+// Products table
+interface ProductRow {
+  id: string;
+  name: string;
+  description?: string;
+  sku?: string;
+  price: number; // cents
+  currency: string;
+  images: string[]; // JSON array
+  stock: number;
+  isActive: boolean;
+  category?: string;
+  metadata?: Record<string, any>; // JSON
+  created_at: string;
+  updated_at: string;
+}
+
+// Orders table
+interface OrderRow {
+  id: string;
+  userId: string;
+  status: 'pending' | 'processing' | 'shipped' | 'delivered' | 'cancelled';
+  items: OrderItem[]; // JSON array
+  subtotal: number;
+  tax: number;
+  shipping: number;
+  total: number;
+  shippingAddress: Address; // JSON
+  billingAddress?: Address; // JSON
+  paymentMethodId?: string;
+  stripePaymentIntentId?: string;
+  notes?: string;
+  created_at: string;
+  updated_at: string;
+}
+
+// Order Items table (for queries)
+interface OrderItemRow {
+  id: string;
+  orderId: string;
+  productId: string;
+  name: string;
+  quantity: number;
+  price: number;
+  lineTotal: number;
+  created_at: string;
+}
+
+// Carts table
+interface CartRow {
+  id: string;
+  userId: string;
+  productId: string;
+  quantity: number;
+  created_at: string;
+  updated_at: string;
+}
+```
+
 ## API Reference
 
 ### VlibeBaseDatabase

package/dist/{VlibeBaseEcommerce-B6l17uup.d.mts → VlibeBaseEcommerce-DXjHdN_L.d.mts}

@@ -280,6 +280,12 @@ interface CartItem {
     productId: string;
     quantity: number;
 }
+interface CartItemWithProduct {
+    productId: string;
+    quantity: number;
+    product: Product;
+    lineTotal: number;
+}
 interface CreateProductInput {
     name: string;
     description?: string;
@@ -730,6 +736,10 @@ declare class VlibeBaseEcommerce {
      * Get user's cart
      */
     getCart(userId: string): Promise<CartItem[]>;
+    /**
+     * Get user's cart with full product details
+     */
+    getCartWithDetails(userId: string): Promise<CartItemWithProduct[]>;
     /**
      * Clear user's cart
      */
@@ -754,4 +764,4 @@ declare class VlibeBaseEcommerce {
     private getPeriodStart;
 }
 
-export { type AppCategory as A, type BasePlan as B, type ConnectStatus as C, type DatabaseConfig as D, type ApiResponse as E, type FeatureFlag as F, type PaginatedResponse as G, type UseCollectionReturn as H, type UseCollectionOptions as I, type UseKVReturn as J, type UseAuthReturn as K, type UsePaymentsReturn as L, type Media as M, type Order as O, type PaymentsConfig as P, type QueryOptions as Q, type RefundOptions as R, type Subscription as S, type Transaction as T, type UsageMetric as U, VlibeBaseDatabase as V, type CheckoutOptions as a, type CheckoutSession as b, VlibeBaseAuth as c, VlibeBaseEcommerce as d, type VlibeBaseConfig as e, type AuthConfig as f, type ColumnType as g, type TableColumn as h, type TableSchema as i, type TableInfo as j, type BaseRecord as k, type RealtimePayload as l, type VlibeUser as m, type VerifyResponse as n, type AuthSession as o, type Page as p, type Product as q, type OrderItem as r, type Address as s, type CartItem as t, type CreateProductInput as u, type CreateOrderInput as v, type OrderCalculation as w, type RevenueStats as x, type ProductStats as y, type OrderStats as z };
+export { type AppCategory as A, type BasePlan as B, type ConnectStatus as C, type DatabaseConfig as D, type OrderStats as E, type FeatureFlag as F, type ApiResponse as G, type PaginatedResponse as H, type UseCollectionReturn as I, type UseCollectionOptions as J, type UseKVReturn as K, type UseAuthReturn as L, type Media as M, type UsePaymentsReturn as N, type Order as O, type PaymentsConfig as P, type QueryOptions as Q, type RefundOptions as R, type Subscription as S, type Transaction as T, type UsageMetric as U, VlibeBaseDatabase as V, type CheckoutOptions as a, type CheckoutSession as b, VlibeBaseAuth as c, VlibeBaseEcommerce as d, type VlibeBaseConfig as e, type AuthConfig as f, type ColumnType as g, type TableColumn as h, type TableSchema as i, type TableInfo as j, type BaseRecord as k, type RealtimePayload as l, type VlibeUser as m, type VerifyResponse as n, type AuthSession as o, type Page as p, type Product as q, type OrderItem as r, type Address as s, type CartItem as t, type CartItemWithProduct as u, type CreateProductInput as v, type CreateOrderInput as w, type OrderCalculation as x, type RevenueStats as y, type ProductStats as z };

package/dist/{VlibeBaseEcommerce-B6l17uup.d.ts → VlibeBaseEcommerce-DXjHdN_L.d.ts}

@@ -280,6 +280,12 @@ interface CartItem {
     productId: string;
     quantity: number;
 }
+interface CartItemWithProduct {
+    productId: string;
+    quantity: number;
+    product: Product;
+    lineTotal: number;
+}
 interface CreateProductInput {
     name: string;
     description?: string;
@@ -730,6 +736,10 @@ declare class VlibeBaseEcommerce {
      * Get user's cart
      */
     getCart(userId: string): Promise<CartItem[]>;
+    /**
+     * Get user's cart with full product details
+     */
+    getCartWithDetails(userId: string): Promise<CartItemWithProduct[]>;
     /**
      * Clear user's cart
      */
@@ -754,4 +764,4 @@ declare class VlibeBaseEcommerce {
     private getPeriodStart;
 }
 
-export { type AppCategory as A, type BasePlan as B, type ConnectStatus as C, type DatabaseConfig as D, type ApiResponse as E, type FeatureFlag as F, type PaginatedResponse as G, type UseCollectionReturn as H, type UseCollectionOptions as I, type UseKVReturn as J, type UseAuthReturn as K, type UsePaymentsReturn as L, type Media as M, type Order as O, type PaymentsConfig as P, type QueryOptions as Q, type RefundOptions as R, type Subscription as S, type Transaction as T, type UsageMetric as U, VlibeBaseDatabase as V, type CheckoutOptions as a, type CheckoutSession as b, VlibeBaseAuth as c, VlibeBaseEcommerce as d, type VlibeBaseConfig as e, type AuthConfig as f, type ColumnType as g, type TableColumn as h, type TableSchema as i, type TableInfo as j, type BaseRecord as k, type RealtimePayload as l, type VlibeUser as m, type VerifyResponse as n, type AuthSession as o, type Page as p, type Product as q, type OrderItem as r, type Address as s, type CartItem as t, type CreateProductInput as u, type CreateOrderInput as v, type OrderCalculation as w, type RevenueStats as x, type ProductStats as y, type OrderStats as z };
+export { type AppCategory as A, type BasePlan as B, type ConnectStatus as C, type DatabaseConfig as D, type OrderStats as E, type FeatureFlag as F, type ApiResponse as G, type PaginatedResponse as H, type UseCollectionReturn as I, type UseCollectionOptions as J, type UseKVReturn as K, type UseAuthReturn as L, type Media as M, type UsePaymentsReturn as N, type Order as O, type PaymentsConfig as P, type QueryOptions as Q, type RefundOptions as R, type Subscription as S, type Transaction as T, type UsageMetric as U, VlibeBaseDatabase as V, type CheckoutOptions as a, type CheckoutSession as b, VlibeBaseAuth as c, VlibeBaseEcommerce as d, type VlibeBaseConfig as e, type AuthConfig as f, type ColumnType as g, type TableColumn as h, type TableSchema as i, type TableInfo as j, type BaseRecord as k, type RealtimePayload as l, type VlibeUser as m, type VerifyResponse as n, type AuthSession as o, type Page as p, type Product as q, type OrderItem as r, type Address as s, type CartItem as t, type CartItemWithProduct as u, type CreateProductInput as v, type CreateOrderInput as w, type OrderCalculation as x, type RevenueStats as y, type ProductStats as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { P as PaymentsConfig, C as ConnectStatus, a as CheckoutOptions, b as CheckoutSession, T as Transaction, R as RefundOptions } from './VlibeBaseEcommerce-B6l17uup.mjs';
-export { s as Address, E as ApiResponse, A as AppCategory, f as AuthConfig, o as AuthSession, B as BasePlan, k as BaseRecord, t as CartItem, g as ColumnType, v as CreateOrderInput, u as CreateProductInput, D as DatabaseConfig, F as FeatureFlag, M as Media, O as Order, w as OrderCalculation, r as OrderItem, z as OrderStats, p as Page, G as PaginatedResponse, q as Product, y as ProductStats, Q as QueryOptions, l as RealtimePayload, x as RevenueStats, S as Subscription, h as TableColumn, j as TableInfo, i as TableSchema, U as UsageMetric, K as UseAuthReturn, I as UseCollectionOptions, H as UseCollectionReturn, J as UseKVReturn, L as UsePaymentsReturn, n as VerifyResponse, c as VlibeBaseAuth, e as VlibeBaseConfig, V as VlibeBaseDatabase, d as VlibeBaseEcommerce, m as VlibeUser } from './VlibeBaseEcommerce-B6l17uup.mjs';
+import { P as PaymentsConfig, C as ConnectStatus, a as CheckoutOptions, b as CheckoutSession, T as Transaction, R as RefundOptions } from './VlibeBaseEcommerce-DXjHdN_L.mjs';
+export { s as Address, G as ApiResponse, A as AppCategory, f as AuthConfig, o as AuthSession, B as BasePlan, k as BaseRecord, t as CartItem, u as CartItemWithProduct, g as ColumnType, w as CreateOrderInput, v as CreateProductInput, D as DatabaseConfig, F as FeatureFlag, M as Media, O as Order, x as OrderCalculation, r as OrderItem, E as OrderStats, p as Page, H as PaginatedResponse, q as Product, z as ProductStats, Q as QueryOptions, l as RealtimePayload, y as RevenueStats, S as Subscription, h as TableColumn, j as TableInfo, i as TableSchema, U as UsageMetric, L as UseAuthReturn, J as UseCollectionOptions, I as UseCollectionReturn, K as UseKVReturn, N as UsePaymentsReturn, n as VerifyResponse, c as VlibeBaseAuth, e as VlibeBaseConfig, V as VlibeBaseDatabase, d as VlibeBaseEcommerce, m as VlibeUser } from './VlibeBaseEcommerce-DXjHdN_L.mjs';
 
 /**
  * VlibeBasePayments - Payment processing for Vlibe Base Apps

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PaymentsConfig, C as ConnectStatus, a as CheckoutOptions, b as CheckoutSession, T as Transaction, R as RefundOptions } from './VlibeBaseEcommerce-B6l17uup.js';
-export { s as Address, E as ApiResponse, A as AppCategory, f as AuthConfig, o as AuthSession, B as BasePlan, k as BaseRecord, t as CartItem, g as ColumnType, v as CreateOrderInput, u as CreateProductInput, D as DatabaseConfig, F as FeatureFlag, M as Media, O as Order, w as OrderCalculation, r as OrderItem, z as OrderStats, p as Page, G as PaginatedResponse, q as Product, y as ProductStats, Q as QueryOptions, l as RealtimePayload, x as RevenueStats, S as Subscription, h as TableColumn, j as TableInfo, i as TableSchema, U as UsageMetric, K as UseAuthReturn, I as UseCollectionOptions, H as UseCollectionReturn, J as UseKVReturn, L as UsePaymentsReturn, n as VerifyResponse, c as VlibeBaseAuth, e as VlibeBaseConfig, V as VlibeBaseDatabase, d as VlibeBaseEcommerce, m as VlibeUser } from './VlibeBaseEcommerce-B6l17uup.js';
+import { P as PaymentsConfig, C as ConnectStatus, a as CheckoutOptions, b as CheckoutSession, T as Transaction, R as RefundOptions } from './VlibeBaseEcommerce-DXjHdN_L.js';
+export { s as Address, G as ApiResponse, A as AppCategory, f as AuthConfig, o as AuthSession, B as BasePlan, k as BaseRecord, t as CartItem, u as CartItemWithProduct, g as ColumnType, w as CreateOrderInput, v as CreateProductInput, D as DatabaseConfig, F as FeatureFlag, M as Media, O as Order, x as OrderCalculation, r as OrderItem, E as OrderStats, p as Page, H as PaginatedResponse, q as Product, z as ProductStats, Q as QueryOptions, l as RealtimePayload, y as RevenueStats, S as Subscription, h as TableColumn, j as TableInfo, i as TableSchema, U as UsageMetric, L as UseAuthReturn, J as UseCollectionOptions, I as UseCollectionReturn, K as UseKVReturn, N as UsePaymentsReturn, n as VerifyResponse, c as VlibeBaseAuth, e as VlibeBaseConfig, V as VlibeBaseDatabase, d as VlibeBaseEcommerce, m as VlibeUser } from './VlibeBaseEcommerce-DXjHdN_L.js';
 
 /**
  * VlibeBasePayments - Payment processing for Vlibe Base Apps

package/dist/index.js

@@ -1082,6 +1082,26 @@ var VlibeBaseEcommerce = class {
       quantity: item.quantity
     }));
   }
+  /**
+   * Get user's cart with full product details
+   */
+  async getCartWithDetails(userId) {
+    const cart = await this.getCart(userId);
+    const enriched = [];
+    for (const item of cart) {
+      const product = await this.getProduct(item.productId);
+      if (!product) {
+        throw new Error(`Product not found: ${item.productId}`);
+      }
+      enriched.push({
+        productId: item.productId,
+        quantity: item.quantity,
+        product,
+        lineTotal: product.price * item.quantity
+      });
+    }
+    return enriched;
+  }
   /**
    * Clear user's cart
    */

package/dist/index.mjs

@@ -1053,6 +1053,26 @@ var VlibeBaseEcommerce = class {
       quantity: item.quantity
     }));
   }
+  /**
+   * Get user's cart with full product details
+   */
+  async getCartWithDetails(userId) {
+    const cart = await this.getCart(userId);
+    const enriched = [];
+    for (const item of cart) {
+      const product = await this.getProduct(item.productId);
+      if (!product) {
+        throw new Error(`Product not found: ${item.productId}`);
+      }
+      enriched.push({
+        productId: item.productId,
+        quantity: item.quantity,
+        product,
+        lineTotal: product.price * item.quantity
+      });
+    }
+    return enriched;
+  }
   /**
    * Clear user's cart
    */

package/dist/react.d.mts

@@ -1,5 +1,5 @@
-import { k as BaseRecord, V as VlibeBaseDatabase, I as UseCollectionOptions, H as UseCollectionReturn, J as UseKVReturn, c as VlibeBaseAuth, K as UseAuthReturn, d as VlibeBaseEcommerce, q as Product, u as CreateProductInput, t as CartItem, s as Address, O as Order } from './VlibeBaseEcommerce-B6l17uup.mjs';
-export { v as CreateOrderInput, L as UsePaymentsReturn, m as VlibeUser } from './VlibeBaseEcommerce-B6l17uup.mjs';
+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.mjs';
+export { w as CreateOrderInput, N as UsePaymentsReturn, m as VlibeUser } from './VlibeBaseEcommerce-DXjHdN_L.mjs';
 
 /**
  * React hook for working with a database collection
@@ -143,6 +143,7 @@ interface UseCartReturn {
     clear: () => Promise<void>;
     checkout: (shippingAddress: Address, paymentMethodId?: string) => Promise<Order>;
     calculateTotal: () => Promise<any>;
+    getCartWithDetails: () => Promise<CartItemWithProduct[]>;
 }
 /**
  * React hook for managing shopping cart
@@ -197,4 +198,4 @@ interface UseOrdersReturn {
  */
 declare function useOrders(ecommerce: VlibeBaseEcommerce, options?: UseOrdersOptions): UseOrdersReturn;
 
-export { BaseRecord, CartItem, CreateProductInput, Order, Product, UseAuthReturn, type UseCartReturn, UseCollectionOptions, UseCollectionReturn, UseKVReturn, type UseOrdersOptions, type UseOrdersReturn, type UseProductsOptions, type UseProductsReturn, useAuth, useCart, useCollection, useKV, useOrders, useProducts };
+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.d.ts

@@ -1,5 +1,5 @@
-import { k as BaseRecord, V as VlibeBaseDatabase, I as UseCollectionOptions, H as UseCollectionReturn, J as UseKVReturn, c as VlibeBaseAuth, K as UseAuthReturn, d as VlibeBaseEcommerce, q as Product, u as CreateProductInput, t as CartItem, s as Address, O as Order } from './VlibeBaseEcommerce-B6l17uup.js';
-export { v as CreateOrderInput, L as UsePaymentsReturn, m as VlibeUser } from './VlibeBaseEcommerce-B6l17uup.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
@@ -143,6 +143,7 @@ interface UseCartReturn {
     clear: () => Promise<void>;
     checkout: (shippingAddress: Address, paymentMethodId?: string) => Promise<Order>;
     calculateTotal: () => Promise<any>;
+    getCartWithDetails: () => Promise<CartItemWithProduct[]>;
 }
 /**
  * React hook for managing shopping cart
@@ -197,4 +198,4 @@ interface UseOrdersReturn {
  */
 declare function useOrders(ecommerce: VlibeBaseEcommerce, options?: UseOrdersOptions): UseOrdersReturn;
 
-export { BaseRecord, CartItem, CreateProductInput, Order, Product, UseAuthReturn, type UseCartReturn, UseCollectionOptions, UseCollectionReturn, UseKVReturn, type UseOrdersOptions, type UseOrdersReturn, type UseProductsOptions, type UseProductsReturn, useAuth, useCart, useCollection, useKV, useOrders, useProducts };
+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

@@ -375,6 +375,9 @@ function useCart(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,
@@ -387,7 +390,8 @@ function useCart(ecommerce, userId) {
     removeItem,
     clear,
     checkout,
-    calculateTotal
+    calculateTotal,
+    getCartWithDetails
   };
 }
 

package/dist/react.mjs

@@ -345,6 +345,9 @@ function useCart(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,
@@ -357,7 +360,8 @@ function useCart(ecommerce, userId) {
     removeItem,
     clear,
     checkout,
-    calculateTotal
+    calculateTotal,
+    getCartWithDetails
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withvlibe/base-sdk",
-  "version": "1.1.0",
+  "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",