​

Cart Contract

Esta página é o contrato canônico para Cart na Corvex Store V2.

​

MUST — hook principal

import { useCorvexCart } from '@corvex/theme-sdk';

const {
  cart,
  items,
  itemCount,
  total,
  subtotal,
  checkoutUrl,
  loading,
  mutating,
  error,
  addItem,
  updateQuantity,
  removeItem,
  clearCart,
  refresh,
  goToCheckout,
} = useCorvexCart();

​

StorefrontCart

​

StorefrontCartItem

​

MUST — adicionar ao carrinho

await addItem(product, quantity, variant);

• product — objeto com pelo menos id (Product ou resumo)
• quantity — OPTIONAL, default 1
• variant — OPTIONAL ProductVariant ou { id }

​

MUST — atualizar / remover

await updateQuantity(itemId, quantity);
await updateQuantity(productId, quantity, variantId);
await removeItem(itemId);
await clearCart();

​

MUST — checkout

const url = await goToCheckout(options);

​

Contexto de página cart

const { cart } = usePage('cart');

​

Sessão (comportamento público)

​

Cliente direto (createStorefront().cart)

• create(), get(), ensure(), addItem(), updateItem(), removeItem(), clearItems(), checkout()

​

Restrições

• MUST NOT implementar fetch manual de carrinho se useCorvexCart atende.
• MUST disable add-to-cart quando variante availableForSale === false.
• MUST NOT usar cart.lines — contrato é items.

​

Veja também

• Data Contract
• Product Contract
• Cart resource
• Cart Drawer Cookbook