​

Data Contract

Esta página é o contrato canônico para dados disponíveis a Themes na Corvex Store V2.

​

MUST — pacote público

import {
  createStorefront,
  usePage,
  useCorvexCart,
  useStorefront,
  defineSection,
  defineSectionData,
  SECTION_DATA_KEYS,
} from '@corvex/theme-sdk';

​

Como uma section recebe dados

schema.data[]  ou  defineSectionData(loader)
        ↓
Runtime resolve (page context + storefront client)
        ↓
Prop data na section (ou useSectionDataByNodeId)

​

1. Declarativo — schema.data

​

2. Loader customizado

export const data = defineSectionData(async ({ storefront, settings, page }) => ({
  products: await storefront.products.list({
    first: settings.limit ?? 4,
    featured: true,
  }),
}));

​

Contexto de página (PageContextMap)

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

const { product } = usePage('product');
const { searchQuery, results } = usePage('search');

​

StorefrontClient (createStorefront)

• products, categories / collections (alias)
• search, reviews, recommendations, leads
• discountRanges, paymentDiscounts, coupons
• cart, shop, menus, blogs, pages
• query() — existe e lança erro: GraphQL ainda não está disponível. Use products.list e as outras APIs do cliente

​

Conexões paginadas

{ nodes: T[]; pageInfo: { hasNextPage, hasPreviousPage, … } }

​

SSR vs CSR (abstração pública)

• Boot da loja pode incluir metadados de shop e revisão publicada no servidor.
• Dados de catálogo e carrinho são obtidos no cliente via Theme SDK (fetch browser).
• Sections MUST tratar loading / listas vazias.

​

MUST NOT

• MUST NOT fazer fetch manual a endpoints não documentados no SDK.
• Não assumir product global em toda section — declare data ou use usePage.
• MUST NOT usar campos de objeto não declarados em Product Contract sem confirmação.

​

Recursos tipados

• Product
• Cart
• Collection (Category)

​

Veja também

• Section Contract
• SDK overview