Cart

npm install @86d-store/cart

import cart from "@86d-store/cart";
import { createModuleClient } from "@86d-store/core";

const client = createModuleClient([
  cart({
    guestCartExpiration: 604800000, // 7 days in ms
    maxItemsPerCart: 100,
  }),
]);

{
  cart: Cart;
  items: CartItem[];
  itemCount: number;
  subtotal: number;  // in cents
}

<Cart />

{/* templates/<theme>/layout.mdx */}
<Cart />
<StoreNavbar actions={<CartButton />} ... />

<CartButton />

<StoreNavbar actions={<CartButton />} logo="..." />

<CartDrawerInner />

<CartFloatingPill />

interface Cart {
  id: string;
  customerId?: string;    // set for authenticated customers
  guestId?: string;       // set for guest sessions
  status: "active" | "abandoned" | "converted";
  expiresAt: Date;
  metadata?: Record<string, unknown>;
  createdAt: Date;
  updatedAt: Date;
}

interface CartItem {
  id: string;             // deterministic: `${cartId}_${productId}[_${variantId}]`
  cartId: string;
  productId: string;
  variantId?: string;
  quantity: number;
  price: number;          // price snapshot at add-to-cart time, in cents
  metadata?: Record<string, unknown>;
  createdAt: Date;
  updatedAt: Date;
}