Skip to main content

Product Contract

Esta página é o contrato canônico para o objeto Product na Corvex Store V2.
Fonte normativa: Product, ProductSummary, ProductVariant, ProductOption em @corvex/theme-sdk types (ApiVersion 2026-08). Campos não listados aqui MUST NOT ser tratados como API estável para terceiros.

Disponibilidade


ProductSummary

Campos comuns em cards e listas (Product extends Summary):

Product (extends ProductSummary)

mapProductSummary também devolve stock, shortDescription e reviewSummary. mapProduct (usado por get e por list) também repassa status, sku, variantCount, physical, logistics e metafields quando a API envia. A interface Product em types/index.d.ts não lista esses campos. Não invente chave que a resposta não trouxe.

ProductOption


ProductVariant

Ver Product Variant.

Image (aninhado)


Money (aninhado)

Usar price.formatted para exibição. Helpers: formatPrice() no SDK.

Helpers públicos


Exemplo mínimo — card


Restrições

  • Use title em tema novo. name existe e o mapper copia title.
  • Confira availableForSale antes do botão de compra.

Veja também