Composables

const {
  cart,          // Ref<StorefrontCart | null>
  cartLoading,   // Ref<boolean>
  create,
  get,
  previewShared, // POS-shared carts, step 1: read-only proposal
  redeemShared,  // POS-shared carts, step 2: take over the cart
  addItem,
  removeItem,
  setCustomer,
  setCustomerType,
  setShipping,
  applyCode,
  removeCode,
  complete,
} = useCart()

// On /cart/:cartId/shared?t=<token>
const route = useRoute()
const { previewShared, redeemShared } = useCart()

// Step 1: show the proposal. Repeatable, consumes nothing.
const proposal = await previewShared(cartId, route.query.t as string)

// Step 2: on "Go to checkout" — the customer takes over the cart.
await redeemShared(cartId, route.query.t as string)
await navigateTo('/checkout')

const {
  customer,        // Ref<CustomerProfile | null>
  isAuthenticated, // Ref<boolean>
  authLoading,     // Ref<boolean>
  login,
  register,
  sendMagicLink,
  verifyMagicLink,
  verifyMagicLinkCode,
  logout,
  getProfile,
  updateProfile,
} = useAuth()

definePageMeta({ middleware: 'auth' })

// Search with reactive params
const searchParams = ref({ q: '', limit: 24 })
const { data, pending } = useProductSearch(searchParams)

// PDP
const { data: product } = useProductByHandle(route.params.handle)

const { products, facets, total, pending, loadMore } = useProductListing({
  categoryId: category.value?.id,
  limit: 24,
})

// Get a specific category
const { data: category } = useCategories().getByHandle(route.params.handle)

// Full nav tree for header menus
const { tree } = useCategoryNav()

const { init, getConfirmation, loading } = useCheckout()

// On checkout page
const session = await init({ cartId: cart.value.id, provider: 'klarna', ... })

// On confirmation page
const { data: confirmation } = getConfirmation(route.params.reference)

const { options, loading, fetchOptions } = useShipping()
await fetchOptions({ cartId: cart.value.id, countryCode: 'SE', postalCode: '11120' })

const { orders, loadMore } = useOrders()

const { returns, create: createReturn } = useReturns()

const { reviews, statistics } = useReviews()

const { marketId, market, switchMarket } = useMarket()
// market.value → { id, name, locale, currency, ... }

const { customerType, setCustomerType } = useCustomerType()
// customerType: 'private' | 'business'

const client = useStorefrontClient()
const product = await client.products.getBySku('SKU-123')