@doswiftly/storefront-operations 1.0.5 → 1.0.6

package/schema.graphql

@@ -0,0 +1,4290 @@
+# ------------------------------------------------------
+# THIS FILE WAS AUTOMATICALLY GENERATED (DO NOT MODIFY)
+# ------------------------------------------------------
+
+"""Gift card applied to checkout"""
+type AppliedGiftCard {
+  """Amount applied to this checkout"""
+  appliedAmount: Money!
+
+  """Last 4 characters of the gift card code"""
+  lastCharacters: String!
+
+  """Masked gift card code for display (e.g., "****-****-****-ABCD")"""
+  maskedCode: String!
+
+  """Remaining balance on the gift card after this checkout"""
+  remainingBalance: Money!
+}
+
+"""Generic attribute"""
+type Attribute {
+  """Attribute key"""
+  key: String!
+
+  """Attribute value"""
+  value: String
+}
+
+"""Filterable attribute definition"""
+type AttributeDefinition {
+  """Display order"""
+  displayOrder: Int!
+
+  """Available filter values (for SELECT, CHECKBOX, RADIO, COLOR, BOOLEAN)"""
+  filterValues: [AttributeFilterValue!]
+
+  """URL-friendly identifier"""
+  handle: String!
+
+  """Attribute ID"""
+  id: ID!
+
+  """Whether attribute is filterable"""
+  isFilterable: Boolean!
+
+  """Whether attribute is visible on product pages"""
+  isVisible: Boolean!
+
+  """Attribute name (e.g., "Color", "Size")"""
+  name: String!
+
+  """Range bounds (for NUMBER, CURRENCY)"""
+  rangeBounds: AttributeRangeBounds
+
+  """Attribute data type"""
+  type: AttributeType!
+}
+
+"""Filter by attribute values"""
+input AttributeFilterInput {
+  """Attribute definition ID or handle"""
+  attributeId: ID!
+
+  """Maximum value (for NUMBER, CURRENCY)"""
+  maxValue: Float
+
+  """Minimum value (for NUMBER, CURRENCY)"""
+  minValue: Float
+
+  """Text search (for TEXT, TEXTAREA)"""
+  textSearch: String
+
+  """Selected values (for SELECT, CHECKBOX, RADIO, COLOR, BOOLEAN)"""
+  values: [String!]
+}
+
+"""Attribute filter value with product count"""
+type AttributeFilterValue {
+  """Option ID or value identifier"""
+  id: ID!
+
+  """Display label (e.g., "Red", "Extra Large")"""
+  label: String!
+
+  """Price modifier for this option"""
+  priceModifier: Money
+
+  """Number of products with this value"""
+  productCount: Int!
+
+  """Sort order for display"""
+  sortOrder: Int!
+
+  """Visual swatch for COLOR type"""
+  swatch: AttributeSwatch
+
+  """Internal value (e.g., "red", "xl")"""
+  value: String!
+}
+
+"""Attribute input"""
+input AttributeInput {
+  """Attribute key"""
+  key: String!
+
+  """Attribute value"""
+  value: String
+}
+
+"""Min/max bounds for numeric attributes"""
+type AttributeRangeBounds {
+  """Currency code for CURRENCY type"""
+  currencyCode: String
+
+  """Maximum value in current product set"""
+  max: Float
+
+  """Minimum value in current product set"""
+  min: Float
+}
+
+"""Color or pattern swatch for visual attribute display"""
+type AttributeSwatch {
+  """Hex color code (e.g., #FF5733)"""
+  colorHex: String
+
+  """Image URL for pattern swatches"""
+  imageUrl: String
+}
+
+"""Type of product attribute"""
+enum AttributeType {
+  BOOLEAN
+  CHECKBOX
+  COLOR
+  CURRENCY
+  DATE
+  FILE
+  IMAGE
+  NUMBER
+  RADIO
+  SELECT
+  TEXT
+  TEXTAREA
+}
+
+"""Available filters for product listing"""
+type AvailableFilters {
+  """Number of currently active filters"""
+  activeFilterCount: Int!
+
+  """Filterable attributes with values"""
+  attributes: [AttributeDefinition!]!
+
+  """Categories available for filtering"""
+  categories: [CategoryFilterOption!]
+
+  """Price range for filtering"""
+  priceRange: PriceRange
+
+  """Total products matching current context (before filters)"""
+  totalProducts: Int!
+}
+
+"""Context for available filters query"""
+input AvailableFiltersInput {
+  """Category ID context (supports comma-separated UUIDs)"""
+  categoryId: ID
+
+  """Collection ID context (supports comma-separated UUIDs)"""
+  collectionId: ID
+
+  """Currently applied filters (to update counts)"""
+  currentFilters: [AttributeFilterInput!]
+
+  """Search query context"""
+  searchQuery: String
+}
+
+"""Available payment methods for checkout"""
+type AvailablePaymentMethods {
+  """Default payment method"""
+  defaultMethod: PaymentMethod
+
+  """List of available payment methods"""
+  methods: [PaymentMethod!]!
+}
+
+"""Available shipping method"""
+type AvailableShippingMethod {
+  """Carrier information"""
+  carrier: ShippingCarrier
+
+  """Method description"""
+  description: String
+
+  """Estimated delivery time"""
+  estimatedDelivery: DeliveryEstimate
+
+  """Free shipping progress if threshold exists"""
+  freeShippingProgress: FreeShippingProgress
+
+  """Shipping method ID (used as handle for selection)"""
+  id: ID!
+
+  """Whether shipping is free"""
+  isFree: Boolean!
+
+  """Method name"""
+  name: String!
+
+  """Shipping price"""
+  price: Money!
+
+  """Sort order for display"""
+  sortOrder: Int!
+}
+
+"""Available shipping methods result"""
+type AvailableShippingMethodsPayload {
+  """Best free shipping progress across all methods"""
+  freeShippingProgress: FreeShippingProgress
+
+  """Available shipping methods"""
+  methods: [AvailableShippingMethod!]!
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Live carrier shipping rates payload"""
+type AvailableShippingRatesPayload {
+  """Whether the result was served from cache"""
+  cached: Boolean!
+
+  """Providers that failed to return rates"""
+  errors: [CarrierRateError!]!
+
+  """Available rates sorted by price"""
+  rates: [CarrierShippingRate!]!
+}
+
+"""Complete B2B price display information"""
+type B2BPriceDisplay {
+  """Message for guests (e.g., "Log in for wholesale pricing")"""
+  guestMessage: String
+
+  """Whether user is logged in"""
+  isAuthenticated: Boolean!
+
+  """Primary pricing information"""
+  pricing: B2BVariantPricing!
+
+  """Volume discount tiers"""
+  volumeTiers: [PricingTier!]
+}
+
+"""B2B pricing for a product variant"""
+type B2BVariantPricing {
+  """Applied customer group"""
+  appliedGroup: CustomerGroup
+
+  """Whether this is a group-discounted price"""
+  hasGroupDiscount: Boolean!
+
+  """Regular retail price"""
+  retailPrice: Money!
+
+  """Amount saved"""
+  savings: Money!
+
+  """Savings percentage (0-100)"""
+  savingsPercent: Float!
+
+  """Pricing tier name"""
+  tierName: String
+
+  """Your group price (best available)"""
+  yourPrice: Money!
+}
+
+"""Blog post author"""
+type BlogAuthor {
+  """Author avatar"""
+  avatar: Image
+
+  """Author bio"""
+  bio: String
+
+  """Author ID"""
+  id: ID!
+
+  """Author name"""
+  name: String!
+}
+
+"""Blog category"""
+type BlogCategory {
+  """Category description"""
+  description: String
+
+  """Category ID"""
+  id: ID!
+
+  """Category image"""
+  image: Image
+
+  """Category name"""
+  name: String!
+
+  """Number of posts in category"""
+  postCount: Int!
+
+  """SEO metadata"""
+  seo: SEO
+
+  """URL-friendly slug"""
+  slug: String!
+}
+
+"""Blog post"""
+type BlogPost {
+  """Whether comments are allowed"""
+  allowComments: Boolean!
+
+  """Post author"""
+  author: BlogAuthor!
+
+  """Post category"""
+  category: BlogCategory
+
+  """Comment count"""
+  commentCount: Int!
+
+  """Full content (HTML)"""
+  content: String!
+
+  """Content type (html or markdown)"""
+  contentType: String!
+
+  """Created date (ISO 8601)"""
+  createdAt: String!
+
+  """Short excerpt/summary"""
+  excerpt: String
+
+  """Featured image"""
+  featuredImage: Image
+
+  """Post ID"""
+  id: ID!
+
+  """Whether post is featured"""
+  isFeatured: Boolean!
+
+  """Published date (ISO 8601)"""
+  publishedAt: String
+
+  """Estimated reading time in minutes"""
+  readingTime: Int!
+
+  """SEO metadata"""
+  seo: SEO
+
+  """URL-friendly slug"""
+  slug: String!
+
+  """Post status"""
+  status: BlogPostStatus!
+
+  """Post tags"""
+  tags: [BlogTag!]!
+
+  """Post title"""
+  title: String!
+
+  """Updated date (ISO 8601)"""
+  updatedAt: String!
+
+  """View count"""
+  viewCount: Int!
+}
+
+"""Paginated blog posts"""
+type BlogPostConnection {
+  """Post edges"""
+  edges: [BlogPostEdge!]!
+
+  """Pagination info"""
+  pageInfo: PageInfo!
+
+  """Total count of posts"""
+  totalCount: Int!
+}
+
+"""Blog post edge"""
+type BlogPostEdge {
+  """Cursor for pagination"""
+  cursor: String!
+
+  """Blog post node"""
+  node: BlogPost!
+}
+
+"""Sort keys for blog posts"""
+enum BlogPostSortKey {
+  CREATED_AT
+  PUBLISHED_AT
+  TITLE
+  VIEW_COUNT
+}
+
+"""Status of a blog post"""
+enum BlogPostStatus {
+  ARCHIVED
+  DRAFT
+  PUBLISHED
+  SCHEDULED
+}
+
+"""Blog tag"""
+type BlogTag {
+  """Tag ID"""
+  id: ID!
+
+  """Tag name"""
+  name: String!
+
+  """Number of posts with this tag"""
+  postCount: Int!
+
+  """URL-friendly slug"""
+  slug: String!
+}
+
+"""Bot protection configuration (platform-level)"""
+type BotProtectionInfo {
+  """Fallback provider"""
+  fallback: BotProtectionProviderInfo
+
+  """Primary provider"""
+  primary: BotProtectionProviderInfo!
+
+  """GraphQL operation names requiring verification"""
+  protectedOperations: [String!]!
+}
+
+"""Single bot protection provider config"""
+type BotProtectionProviderInfo {
+  """Provider identifier: eucaptcha | turnstile | recaptcha"""
+  provider: String!
+
+  """Script URL (configurable, region/enterprise overrides)"""
+  scriptUrl: String!
+
+  """Site key for the bot protection widget"""
+  siteKey: String!
+}
+
+"""Business hours for a day"""
+type BusinessHour {
+  """Closing time (HH:MM format)"""
+  closeTime: String
+
+  """Day of week (monday, tuesday, etc.)"""
+  day: String!
+
+  """Whether the shop is closed this day"""
+  isClosed: Boolean!
+
+  """Opening time (HH:MM format)"""
+  openTime: String
+}
+
+"""Provider error when fetching rates"""
+type CarrierRateError {
+  """Error message"""
+  message: String!
+
+  """Provider code"""
+  provider: String!
+}
+
+"""Live shipping rate from a carrier"""
+type CarrierShippingRate {
+  """Whether cash on delivery is available"""
+  cashOnDeliveryAvailable: Boolean!
+
+  """Estimated delivery in business days"""
+  estimatedDeliveryDays: Int!
+
+  """Whether pickup is available for this service"""
+  pickupAvailable: Boolean!
+
+  """Rate price"""
+  price: Money!
+
+  """Provider ID (e.g., furgonetka, inpost)"""
+  providerId: String!
+
+  """Service ID (provider-specific)"""
+  serviceId: String!
+
+  """Service display name"""
+  serviceName: String!
+}
+
+"""Shopping cart"""
+type Cart {
+  """Cart attributes"""
+  attributes: [CartAttribute!]!
+
+  """Buyer identity information"""
+  buyerIdentity: CartBuyerIdentity
+
+  """Checkout URL"""
+  checkoutUrl: String
+
+  """Cost breakdown"""
+  cost: CartCost!
+
+  """Creation timestamp"""
+  createdAt: DateTime!
+
+  """Discount allocations"""
+  discountAllocations: [CartDiscountAllocation!]!
+
+  """Applied discount codes"""
+  discountCodes: [CartDiscountCode!]!
+
+  """Unique cart identifier"""
+  id: ID!
+
+  """Cart line items"""
+  lines(first: Float = 100): [CartLine!]!
+
+  """Cart note"""
+  note: String
+
+  """Product recommendations based on cart contents"""
+  recommendations(first: Int = 4): CartRecommendations
+
+  """Total quantity of all items"""
+  totalQuantity: Int!
+
+  """Last update timestamp"""
+  updatedAt: DateTime!
+}
+
+"""Cart line attribute"""
+type CartAttribute {
+  """Attribute key"""
+  key: String!
+
+  """Attribute value"""
+  value: String
+}
+
+"""Input for cart attribute"""
+input CartAttributeInput {
+  """Attribute key"""
+  key: String!
+
+  """Attribute value"""
+  value: String
+}
+
+"""Buyer identity information"""
+type CartBuyerIdentity {
+  """Country code (ISO 3166-1 alpha-2)"""
+  countryCode: String
+
+  """Customer ID"""
+  customerId: ID
+
+  """Customer email"""
+  email: String
+
+  """Customer phone"""
+  phone: String
+}
+
+"""Input for buyer identity"""
+input CartBuyerIdentityInput {
+  """Country code (ISO 3166-1 alpha-2)"""
+  countryCode: String
+
+  """Customer ID"""
+  customerId: ID
+
+  """Customer email"""
+  email: String
+
+  """Customer phone"""
+  phone: String
+}
+
+"""Result of updating buyer identity"""
+type CartBuyerIdentityUpdatePayload {
+  """Updated cart"""
+  cart: Cart
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Cart cost breakdown"""
+type CartCost {
+  """Checkout charge amount"""
+  checkoutChargeAmount: PriceMoney
+
+  """Subtotal before taxes and shipping (in customer currency)"""
+  subtotalAmount: PriceMoney!
+
+  """Total amount including taxes (in customer currency)"""
+  totalAmount: PriceMoney!
+
+  """Total duty amount"""
+  totalDutyAmount: PriceMoney
+
+  """Total tax amount"""
+  totalTaxAmount: PriceMoney
+}
+
+"""Input for creating a cart"""
+input CartCreateInput {
+  """Cart attributes"""
+  attributes: [CartAttributeInput!]
+
+  """Buyer identity"""
+  buyerIdentity: CartBuyerIdentityInput
+
+  """Discount codes to apply"""
+  discountCodes: [String!]
+
+  """Initial cart lines"""
+  lines: [CartLineInput!]
+
+  """Cart note"""
+  note: String
+}
+
+"""Result of cart creation"""
+type CartCreatePayload {
+  """Created cart"""
+  cart: Cart
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Discount allocation showing how discount is applied"""
+type CartDiscountAllocation {
+  """Discount amount"""
+  amount: Money!
+
+  """Discount code"""
+  discountCode: String!
+}
+
+"""Discount code applied to cart"""
+type CartDiscountCode {
+  """Whether the code is applicable"""
+  applicable: Boolean!
+
+  """Discount code string"""
+  code: String!
+}
+
+"""Result of updating discount codes"""
+type CartDiscountCodesUpdatePayload {
+  """Updated cart"""
+  cart: Cart
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Single line item in the cart"""
+type CartLine {
+  """Custom attributes for this line"""
+  attributes: [Attribute!]!
+
+  """Cost information for this line"""
+  cost: CartLineCost!
+
+  """Unique line identifier"""
+  id: ID!
+
+  """Product variant being purchased"""
+  merchandise: ProductVariant!
+
+  """Parent product handle (slug)"""
+  productHandle: String
+
+  """Parent product ID"""
+  productId: ID
+
+  """Parent product title"""
+  productTitle: String
+
+  """Parent product type"""
+  productType: ProductTypeEnum
+
+  """Quantity of this item"""
+  quantity: Int!
+}
+
+"""Cost information for a single cart line"""
+type CartLineCost {
+  """Amount per quantity (in customer currency)"""
+  amountPerQuantity: PriceMoney!
+
+  """Original price per quantity if discounted"""
+  compareAtAmountPerQuantity: PriceMoney
+
+  """Subtotal before discounts (in customer currency)"""
+  subtotalAmount: PriceMoney!
+
+  """Total after discounts (in customer currency)"""
+  totalAmount: PriceMoney!
+}
+
+"""Input for adding a line to cart"""
+input CartLineInput {
+  """Line attributes"""
+  attributes: [AttributeInput!]
+
+  """Product variant ID"""
+  merchandiseId: ID!
+
+  """Quantity to add"""
+  quantity: Int! = 1
+}
+
+"""Input for updating a cart line"""
+input CartLineUpdateInput {
+  """Updated attributes"""
+  attributes: [AttributeInput!]
+
+  """Cart line ID to update"""
+  id: ID!
+
+  """New quantity"""
+  quantity: Int!
+}
+
+"""Result of adding lines to cart"""
+type CartLinesAddPayload {
+  """Updated cart"""
+  cart: Cart
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Result of removing cart lines"""
+type CartLinesRemovePayload {
+  """Updated cart"""
+  cart: Cart
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Result of updating cart lines"""
+type CartLinesUpdatePayload {
+  """Updated cart"""
+  cart: Cart
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Result of updating cart note"""
+type CartNoteUpdatePayload {
+  """Updated cart"""
+  cart: Cart
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Recommendations based on cart contents"""
+type CartRecommendations {
+  """Products frequently bought together with cart items"""
+  frequentlyBoughtTogether: [ProductRecommendation!]!
+
+  """Products to consider adding"""
+  youMayAlsoLike: [ProductRecommendation!]!
+}
+
+"""Cart data for shipping calculation"""
+input CartShippingInput {
+  """Currency code (ISO 4217)"""
+  currencyCode: String
+
+  """Cart subtotal in cents"""
+  subtotal: Int
+
+  """Total weight in grams"""
+  totalWeight: Int
+}
+
+"""Product category - hierarchical organization"""
+type Category {
+  """Child categories"""
+  children: [Category!]!
+
+  """Category description"""
+  description: String
+
+  """Unique identifier"""
+  id: ID!
+
+  """Category image"""
+  image: Image
+
+  """Depth level in hierarchy (0 = root)"""
+  level: Int!
+
+  """Category name"""
+  name: String!
+
+  """Parent category (null for root)"""
+  parent: Category
+
+  """Full path (e.g., "Electronics/Phones/Smartphones")"""
+  path: String!
+
+  """Number of products in category"""
+  productCount: Int!
+
+  """Products in category"""
+  products(after: String, first: Float! = 20): CategoryConnection!
+
+  """SEO metadata"""
+  seo: SEO
+
+  """URL-friendly slug"""
+  slug: String!
+
+  """Sort order within parent"""
+  sortOrder: Int!
+}
+
+"""Paginated category list"""
+type CategoryConnection {
+  """List of category edges"""
+  edges: [CategoryEdge!]!
+
+  """Pagination info"""
+  pageInfo: PageInfo!
+
+  """Total count of categories"""
+  totalCount: Int!
+}
+
+"""Category edge in connection"""
+type CategoryEdge {
+  """Cursor for pagination"""
+  cursor: String!
+
+  """Category node"""
+  node: Category!
+}
+
+"""Category filter option"""
+type CategoryFilterOption {
+  """Category ID"""
+  id: ID!
+
+  """Nesting level (0 = root)"""
+  level: Int!
+
+  """Category name"""
+  name: String!
+
+  """Parent category ID"""
+  parentId: ID
+
+  """Number of products in this category"""
+  productCount: Int!
+
+  """URL-friendly slug"""
+  slug: String!
+}
+
+"""Category tree structure"""
+type CategoryTree {
+  """Root categories"""
+  roots: [Category!]!
+
+  """Total categories count"""
+  totalCount: Int!
+}
+
+"""Checkout object"""
+type Checkout {
+  """Applied gift cards"""
+  appliedGiftCards: [AppliedGiftCard!]!
+
+  """Available payment methods (Requirements: R23.1, R23.2)"""
+  availablePaymentMethods: [PaymentMethod!]!
+
+  """Available shipping rates"""
+  availableShippingRates: [ShippingRate!]!
+
+  """Billing address"""
+  billingAddress: MailingAddress
+
+  """Whether checkout is completed"""
+  completed: Boolean!
+
+  """Completed order ID"""
+  completedOrderId: String
+
+  """Created at"""
+  createdAt: DateTime!
+
+  """Currency code"""
+  currencyCode: String!
+
+  """Customer ID"""
+  customerId: String
+
+  """Applied discounts with details"""
+  discountApplications: [DiscountApplication!]!
+
+  """Applied discount codes"""
+  discountCodes: [DiscountCode!]!
+
+  """Customer email"""
+  email: String
+
+  """Checkout ID"""
+  id: ID!
+
+  """Line items"""
+  lineItems: [CheckoutLineItem!]!
+
+  """Order note"""
+  note: String
+
+  """Amount due for payment after gift cards applied"""
+  paymentDue: Money!
+
+  """Customer phone"""
+  phone: String
+
+  """Whether checkout is ready for payment"""
+  ready: Boolean!
+
+  """Selected payment method ID (Requirements: R23.5)"""
+  selectedPaymentMethodId: ID
+
+  """Shipping address"""
+  shippingAddress: MailingAddress
+
+  """Selected shipping rate"""
+  shippingLine: ShippingRate
+
+  """Whether shipping rates are ready"""
+  shippingRatesReady: Boolean!
+
+  """Subtotal before discounts and taxes"""
+  subtotalPrice: Money!
+
+  """Tax breakdown"""
+  taxLines: [TaxLine!]!
+
+  """Total discount amount"""
+  totalDiscounts: Money!
+
+  """Total amount covered by gift cards"""
+  totalGiftCardAmount: Money!
+
+  """Total price"""
+  totalPrice: Money!
+
+  """Total quantity"""
+  totalQuantity: Float!
+
+  """Total shipping price"""
+  totalShippingPrice: Money!
+
+  """Total tax amount"""
+  totalTax: Money!
+
+  """Updated at"""
+  updatedAt: DateTime!
+
+  """Checkout URL"""
+  webUrl: String!
+}
+
+"""Mailing address input"""
+input CheckoutAddressInput {
+  """Address line 1"""
+  address1: String!
+
+  """Address line 2"""
+  address2: String
+
+  """City"""
+  city: String!
+
+  """Company name"""
+  company: String
+
+  """Country code (ISO)"""
+  country: String!
+
+  """First name"""
+  firstName: String
+
+  """Last name"""
+  lastName: String
+
+  """Phone number"""
+  phone: String
+
+  """Province/State"""
+  province: String
+
+  """ZIP/Postal code"""
+  zip: String!
+}
+
+"""Checkout billing address update payload"""
+type CheckoutBillingAddressUpdatePayload {
+  """Updated checkout"""
+  checkout: Checkout
+
+  """User errors"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Checkout complete input"""
+input CheckoutCompleteInput {
+  """Idempotency key for duplicate prevention"""
+  idempotencyKey: String
+
+  """Payment method ID"""
+  paymentMethodId: String
+}
+
+"""Checkout complete payload"""
+type CheckoutCompletePayload {
+  """Completed checkout"""
+  checkout: Checkout
+
+  """Created order (if checkout successful)"""
+  order: Order
+
+  """Payment redirect URL (if payment required)"""
+  paymentUrl: String
+
+  """User errors"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Checkout create input"""
+input CheckoutCreateInput {
+  """Existing cart ID to convert to checkout"""
+  cartId: ID
+
+  """Customer access token"""
+  customerAccessToken: String
+
+  """Customer email"""
+  email: String
+
+  """Line items"""
+  lineItems: [CheckoutLineItemInput!]
+
+  """Note"""
+  note: String
+
+  """Shipping address"""
+  shippingAddress: CheckoutAddressInput
+}
+
+"""Checkout create payload"""
+type CheckoutCreatePayload {
+  """Created checkout"""
+  checkout: Checkout
+
+  """User errors"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Checkout discount code apply payload"""
+type CheckoutDiscountCodeApplyPayload {
+  """Updated checkout"""
+  checkout: Checkout
+
+  """User errors"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Checkout discount code remove payload"""
+type CheckoutDiscountCodeRemovePayload {
+  """Updated checkout"""
+  checkout: Checkout
+
+  """User errors"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Checkout discount code validation result"""
+type CheckoutDiscountCodeValidatePayload {
+  """Validation result"""
+  result: DiscountValidationResult!
+
+  """User errors (for checkout-level issues)"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Checkout email update payload"""
+type CheckoutEmailUpdatePayload {
+  """Updated checkout"""
+  checkout: Checkout
+
+  """User errors"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Checkout error codes"""
+enum CheckoutErrorCode {
+  ALREADY_COMPLETED
+  BLANK
+  CART_NOT_FOUND
+  CHECKOUT_NOT_FOUND
+  CUSTOMER_ALREADY_USED_ONCE_PER_CUSTOMER_DISCOUNT_NOTICE
+  DISCOUNT_DISABLED
+  DISCOUNT_LIMIT_REACHED
+  DISCOUNT_NOT_FOUND
+  EMPTY_CART
+  GIFT_CARD_DEPLETED
+  GIFT_CARD_DISABLED
+  GIFT_CARD_EXPIRED
+  GIFT_CARD_NOT_FOUND
+  GIFT_CARD_UNUSABLE
+  INVALID
+  INVALID_PAYMENT_METHOD
+  INVALID_SHIPPING_ADDRESS
+  LINE_ITEM_NOT_FOUND
+  MISSING_SHIPPING_METHOD
+  NOT_ENOUGH_IN_STOCK
+  NO_PAYMENT_METHODS
+  SHIPPING_RATE_EXPIRED
+  TOO_LONG
+}
+
+"""Checkout gift card apply payload"""
+type CheckoutGiftCardApplyPayload {
+  """Updated checkout"""
+  checkout: Checkout
+
+  """User errors"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Gift card recipient input"""
+input CheckoutGiftCardRecipientInput {
+  """Checkout ID"""
+  checkoutId: ID!
+
+  """Line item ID to attach recipient info to"""
+  lineItemId: ID!
+
+  """Personal message to recipient"""
+  message: String
+
+  """Recipient email address"""
+  recipientEmail: String
+
+  """Recipient name"""
+  recipientName: String
+}
+
+"""Checkout gift card recipient update payload"""
+type CheckoutGiftCardRecipientUpdatePayload {
+  """Updated checkout"""
+  checkout: Checkout
+
+  """User errors"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Checkout gift card remove payload"""
+type CheckoutGiftCardRemovePayload {
+  """Updated checkout"""
+  checkout: Checkout
+
+  """User errors"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Checkout line item"""
+type CheckoutLineItem {
+  """Line item ID"""
+  id: ID!
+
+  """Product image"""
+  image: Image
+
+  """Product ID"""
+  productId: String
+
+  """Quantity"""
+  quantity: Int!
+
+  """SKU"""
+  sku: String
+
+  """Product title"""
+  title: String!
+
+  """Total price"""
+  totalPrice: Money!
+
+  """Unit price"""
+  unitPrice: Money!
+
+  """Product variant"""
+  variant: ProductVariant
+
+  """Product variant ID"""
+  variantId: String
+
+  """Variant title"""
+  variantTitle: String
+}
+
+"""Checkout line item input"""
+input CheckoutLineItemInput {
+  """Quantity"""
+  quantity: Float!
+
+  """Product variant ID"""
+  variantId: ID!
+}
+
+"""Checkout payment method update payload"""
+type CheckoutPaymentMethodUpdatePayload {
+  """Updated checkout"""
+  checkout: Checkout
+
+  """User errors"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Checkout shipping address update payload"""
+type CheckoutShippingAddressUpdatePayload {
+  """Updated checkout"""
+  checkout: Checkout
+
+  """User errors"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Checkout shipping line update payload"""
+type CheckoutShippingLineUpdatePayload {
+  """Updated checkout"""
+  checkout: Checkout
+
+  """User errors"""
+  userErrors: [CheckoutUserError!]!
+}
+
+"""Checkout user error"""
+type CheckoutUserError {
+  """Error code"""
+  code: CheckoutErrorCode
+
+  """Path to error field"""
+  field: [String!]!
+
+  """Error message"""
+  message: String!
+}
+
+"""Collection - curated group of products"""
+type Collection {
+  """Creation timestamp"""
+  createdAt: DateTime!
+
+  """Plain text description"""
+  description: String
+
+  """HTML description"""
+  descriptionHtml: String
+
+  """URL-friendly handle (slug)"""
+  handle: String!
+
+  """Unique identifier"""
+  id: ID!
+
+  """Collection image"""
+  image: Image
+
+  """Products in collection"""
+  products(after: String, first: Int = 20, reverse: Boolean = false, sortKey: ProductSortKeys = BEST_SELLING): ProductConnection!
+
+  """SEO metadata"""
+  seo: SEO
+
+  """Collection title"""
+  title: String!
+
+  """Last update timestamp"""
+  updatedAt: DateTime!
+}
+
+"""Paginated collection connection"""
+type CollectionConnection {
+  """Collection edges"""
+  edges: [CollectionEdge!]!
+
+  """Pagination info"""
+  pageInfo: PageInfo!
+
+  """Total count of collections"""
+  totalCount: Int!
+}
+
+"""Collection edge for pagination"""
+type CollectionEdge {
+  """Cursor"""
+  cursor: String!
+
+  """Collection node"""
+  node: Collection!
+}
+
+"""Sort keys for collections"""
+enum CollectionSortKeys {
+  CREATED_AT
+  RELEVANCE
+  TITLE
+  UPDATED_AT
+}
+
+"""Type of compensation for the return"""
+enum CompensationType {
+  REFUND
+  STORE_CREDIT
+}
+
+"""Price range in converted currency"""
+type ConvertedPriceRange {
+  """Maximum variant price (converted)"""
+  maxVariantPrice: PriceMoney!
+
+  """Minimum variant price (converted)"""
+  minVariantPrice: PriceMoney!
+}
+
+"""Region to crop the image"""
+enum CropRegion {
+  BOTTOM
+  CENTER
+  LEFT
+  RIGHT
+  TOP
+}
+
+"""Currency information"""
+type Currency {
+  """ISO 4217 currency code"""
+  code: String!
+
+  """Number of decimal places"""
+  decimalPlaces: Float!
+
+  """Currency full name"""
+  name: String!
+
+  """Currency symbol"""
+  symbol: String!
+
+  """Symbol position relative to amount: before or after"""
+  symbolPosition: String!
+}
+
+"""Currency conversion result"""
+type CurrencyConversion {
+  """Converted amount"""
+  convertedAmount: Float!
+
+  """Target currency code"""
+  convertedCurrency: String!
+
+  """Margin percentage applied"""
+  marginApplied: Float
+
+  """Original amount"""
+  originalAmount: Float!
+
+  """Original currency code"""
+  originalCurrency: String!
+
+  """Exchange rate used"""
+  rate: Float!
+
+  """Rate data source"""
+  rateSource: CurrencyRateSource!
+
+  """Rate timestamp"""
+  rateTimestamp: DateTime!
+
+  """Rate with margin applied"""
+  rateWithMargin: Float
+}
+
+"""Source of exchange rate data"""
+enum CurrencyRateSource {
+  ECB
+  FIXER
+  MANUAL
+}
+
+"""Customer - registered user"""
+type Customer {
+  """Saved addresses"""
+  addresses(first: Int = 10): [MailingAddress!]!
+
+  """Account creation date"""
+  createdAt: DateTime!
+
+  """Default address"""
+  defaultAddress: MailingAddress
+
+  """Display name"""
+  displayName: String!
+
+  """Email address"""
+  email: String!
+
+  """Email marketing consent state"""
+  emailMarketingState: String!
+
+  """Whether email is verified"""
+  emailVerified: Boolean!
+
+  """First name"""
+  firstName: String
+
+  """Unique identifier"""
+  id: ID!
+
+  """Last name"""
+  lastName: String
+
+  """Customer orders"""
+  orders(after: String, first: Int = 10): OrderConnection!
+
+  """Total orders count"""
+  ordersCount: Int!
+
+  """Phone number"""
+  phone: String
+
+  """Total amount spent"""
+  totalSpent: Money!
+
+  """Last update date"""
+  updatedAt: DateTime!
+}
+
+"""Customer access token"""
+type CustomerAccessToken {
+  """Access token string"""
+  accessToken: String!
+
+  """Token expiration"""
+  expiresAt: String!
+}
+
+"""Input for customer login"""
+input CustomerAccessTokenCreateInput {
+  """Email address"""
+  email: String!
+
+  """Password"""
+  password: String!
+}
+
+"""Result of customer login"""
+type CustomerAccessTokenCreatePayload {
+  """Access token"""
+  customerAccessToken: CustomerAccessToken
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Result of token deletion (logout)"""
+type CustomerAccessTokenDeletePayload {
+  """Deleted access token"""
+  deletedAccessToken: String
+
+  """Deleted token ID"""
+  deletedCustomerAccessTokenId: String
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Result of token renewal"""
+type CustomerAccessTokenRenewPayload {
+  """New access token"""
+  customerAccessToken: CustomerAccessToken
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Result of address creation"""
+type CustomerAddressCreatePayload {
+  """Created address"""
+  address: MailingAddress
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Result of address deletion"""
+type CustomerAddressDeletePayload {
+  """Deleted address ID"""
+  deletedAddressId: ID
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Result of address update"""
+type CustomerAddressUpdatePayload {
+  """Updated address"""
+  address: MailingAddress
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Input for customer registration"""
+input CustomerCreateInput {
+  """Email address"""
+  email: String!
+
+  """First name"""
+  firstName: String
+
+  """Last name"""
+  lastName: String
+
+  """Password"""
+  password: String!
+
+  """Phone number"""
+  phone: String
+}
+
+"""Result of customer creation"""
+type CustomerCreatePayload {
+  """Created customer"""
+  customer: Customer
+
+  """Access token for new customer"""
+  customerAccessToken: CustomerAccessToken
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Result of default address update"""
+type CustomerDefaultAddressUpdatePayload {
+  """Updated customer"""
+  customer: Customer
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Customer group for B2B pricing"""
+type CustomerGroup {
+  """Group code"""
+  code: String!
+
+  """Group description"""
+  description: String
+
+  """Default discount percentage (0-100)"""
+  discountPercent: Float!
+
+  """Group ID"""
+  id: ID!
+
+  """Group name (e.g., "Wholesale", "VIP")"""
+  name: String!
+
+  """Whether group is tax exempt"""
+  taxExempt: Boolean!
+}
+
+"""Result of password recovery"""
+type CustomerRecoverPayload {
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Result of password reset"""
+type CustomerResetPayload {
+  """Updated customer"""
+  customer: Customer
+
+  """New access token"""
+  customerAccessToken: CustomerAccessToken
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Input for customer update"""
+input CustomerUpdateInput {
+  """First name"""
+  firstName: String
+
+  """Last name"""
+  lastName: String
+
+  """Phone number"""
+  phone: String
+}
+
+"""Result of customer update"""
+type CustomerUpdatePayload {
+  """Updated customer"""
+  customer: Customer
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""
+A date-time string at UTC, such as 2019-12-03T09:54:33Z, compliant with the date-time format.
+"""
+scalar DateTime
+
+"""Estimated delivery timeframe"""
+type DeliveryEstimate {
+  """Human-readable delivery estimate"""
+  description: String
+
+  """Maximum delivery days"""
+  maxDays: Int
+
+  """Minimum delivery days"""
+  minDays: Int
+}
+
+"""Item affected by a discount (especially BXGY)"""
+type DiscountAffectedItem {
+  """Discounted price per unit"""
+  discountedPrice: Money!
+
+  """Whether this item is "free" in BXGY"""
+  isFreeItem: Boolean!
+
+  """Original price per unit"""
+  originalPrice: Money!
+
+  """Product ID"""
+  productId: ID!
+
+  """Quantity affected by discount"""
+  quantity: Int!
+
+  """Total savings for this item"""
+  savings: Money!
+
+  """Product/variant title"""
+  title: String!
+
+  """Variant ID"""
+  variantId: ID
+}
+
+"""Applied discount"""
+type DiscountApplication {
+  """Items affected by this discount (for BXGY type)"""
+  affectedItems: [DiscountAffectedItem!]
+
+  """Whether discount is applicable"""
+  applicable: Boolean!
+
+  """Buy quantity for BXGY (e.g., 2 in "Buy 2 Get 1")"""
+  buyQuantity: Int
+
+  """Discount code"""
+  code: String!
+
+  """Discount percentage on "get" items (100 = free)"""
+  getDiscountPercent: Float
+
+  """Get quantity for BXGY (e.g., 1 in "Buy 2 Get 1")"""
+  getQuantity: Int
+
+  """Discount title/description"""
+  title: String
+
+  """Type of discount"""
+  type: DiscountApplicationType
+
+  """Discount amount"""
+  value: Money
+}
+
+"""Type of discount being applied"""
+enum DiscountApplicationType {
+  BUY_X_GET_Y
+  FIXED_AMOUNT
+  FREE_SHIPPING
+  PERCENTAGE
+}
+
+"""Discount code applied to checkout"""
+type DiscountCode {
+  """Whether the code is currently applicable"""
+  applicable: Boolean!
+
+  """Discount code string"""
+  code: String!
+}
+
+"""Error codes for discount validation"""
+enum DiscountErrorCode {
+  CUSTOMER_NOT_ELIGIBLE
+  CUSTOMER_USAGE_LIMIT_REACHED
+  DISCOUNT_COMBINATION_NOT_ALLOWED
+  EXPIRED
+  INACTIVE
+  MINIMUM_ORDER_NOT_MET
+  MINIMUM_QUANTITY_NOT_MET
+  NOT_FOUND
+  NOT_STARTED
+  SHOP_NOT_FOUND
+  USAGE_LIMIT_REACHED
+}
+
+"""Information about a valid discount"""
+type DiscountInfo {
+  """Discount code"""
+  code: String!
+
+  """Calculated discount amount"""
+  discountAmount: Money
+
+  """Discount title"""
+  title: String!
+
+  """Type of discount"""
+  type: DiscountApplicationType!
+
+  """Discount value (percentage or amount)"""
+  value: Float!
+}
+
+"""Discount validation error"""
+type DiscountValidationError {
+  """Error code"""
+  code: DiscountErrorCode!
+
+  """Error message"""
+  message: String!
+}
+
+"""Result of validating a discount code"""
+type DiscountValidationResult {
+  """Discount info (if valid)"""
+  discount: DiscountInfo
+
+  """Error details (if invalid)"""
+  error: DiscountValidationError
+
+  """Whether the discount code is valid"""
+  valid: Boolean!
+}
+
+"""Exchange rate between currencies"""
+type ExchangeRate {
+  """Source currency code"""
+  from: String!
+
+  """Exchange rate"""
+  rate: Float!
+
+  """Rate data source"""
+  source: CurrencyRateSource!
+
+  """Target currency code"""
+  to: String!
+
+  """When rate was last updated"""
+  updatedAt: DateTime!
+}
+
+"""Free shipping progress indicator"""
+type FreeShippingProgress {
+  """Current cart subtotal"""
+  currentAmount: Money
+
+  """Human-readable progress message"""
+  message: String
+
+  """Progress percentage (0-100)"""
+  progressPercent: Float
+
+  """Whether free shipping is achieved"""
+  qualifies: Boolean!
+
+  """Amount remaining for free shipping"""
+  remaining: Money
+
+  """Threshold for free shipping"""
+  threshold: Money
+}
+
+"""Result of generating referral code"""
+type GenerateReferralCodePayload {
+  """Generated referral code"""
+  referralCode: String
+
+  """Shareable referral URL"""
+  shareUrl: String
+
+  """Whether generation was successful"""
+  success: Boolean!
+
+  """Error messages if any"""
+  userErrors: [String!]!
+}
+
+"""Gift card information"""
+type GiftCard {
+  """Current balance"""
+  balance: Money!
+
+  """Creation timestamp"""
+  createdAt: DateTime!
+
+  """Expiration date"""
+  expiresAt: DateTime
+
+  """Gift card ID"""
+  id: ID!
+
+  """Initial gift card amount"""
+  initialAmount: Money!
+
+  """Last 4 characters of code"""
+  lastCharacters: String!
+
+  """Gift card code (masked for security)"""
+  maskedCode: String!
+
+  """Personal message"""
+  message: String
+
+  """Recipient name"""
+  recipientName: String
+
+  """Gift card status"""
+  status: GiftCardStatus!
+
+  """Transaction history"""
+  transactions: [GiftCardTransaction!]!
+}
+
+"""Gift card validation error"""
+type GiftCardError {
+  """Error code"""
+  code: GiftCardErrorCode!
+
+  """Human-readable error message"""
+  message: String!
+}
+
+"""Gift card validation error codes"""
+enum GiftCardErrorCode {
+  ALREADY_USED
+  CURRENCY_MISMATCH
+  DISABLED
+  EXPIRED
+  INSUFFICIENT_BALANCE
+  INVALID_CODE_FORMAT
+  NOT_FOUND
+}
+
+"""Result of gift card lookup"""
+type GiftCardPayload {
+  """Gift card if found"""
+  giftCard: GiftCard
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Gift card status"""
+enum GiftCardStatus {
+  ACTIVE
+  DISABLED
+  EXPIRED
+  USED
+}
+
+"""Gift card transaction record"""
+type GiftCardTransaction {
+  """Transaction amount"""
+  amount: Money!
+
+  """Balance after transaction"""
+  balanceAfter: Money!
+
+  """Transaction timestamp"""
+  createdAt: DateTime!
+
+  """Transaction ID"""
+  id: ID!
+
+  """Order ID if related to order"""
+  orderId: ID
+
+  """Transaction type"""
+  type: String!
+}
+
+"""Result of gift card validation"""
+type GiftCardValidatePayload {
+  """User errors"""
+  userErrors: [UserError!]!
+
+  """Validation result"""
+  validation: GiftCardValidation
+}
+
+"""Gift card validation result"""
+type GiftCardValidation {
+  """Available balance if valid"""
+  availableBalance: Money
+
+  """Error details if invalid"""
+  error: GiftCardError
+
+  """Gift card details if valid"""
+  giftCard: GiftCard
+
+  """Whether the gift card is valid for use"""
+  valid: Boolean!
+}
+
+"""Image with URL and metadata"""
+type Image {
+  """Alt text for accessibility"""
+  altText: String
+
+  """Image height in pixels"""
+  height: Int
+
+  """Image ID"""
+  id: ID
+
+  """Image URL. Pass transform argument for resized/cropped CDN URLs."""
+  url(transform: ImageTransformInput): String!
+
+  """Image width in pixels"""
+  width: Int
+}
+
+"""Image content type for output format"""
+enum ImageContentType {
+  AVIF
+  JPG
+  PNG
+  WEBP
+}
+
+"""Image transform options (Shopify-compatible)"""
+input ImageTransformInput {
+  """Crop region"""
+  crop: CropRegion
+
+  """Max height in pixels (1-5760)"""
+  maxHeight: Int
+
+  """Max width in pixels (1-5760)"""
+  maxWidth: Int
+
+  """Preferred output format"""
+  preferredContentType: ImageContentType
+
+  """DPI scale multiplier (1-3)"""
+  scale: Int
+}
+
+"""Inventory level at a specific location"""
+type InventoryLevel {
+  """
+  Available quantity (computed: onHand - committed - reserved - damaged - safetyStock)
+  """
+  available: Int!
+
+  """Location ID"""
+  locationId: ID!
+
+  """Location name"""
+  locationName: String!
+
+  """Location type"""
+  locationType: LocationType!
+
+  """On-hand quantity at this location"""
+  onHand: Int!
+}
+
+"""Language configuration"""
+type Language {
+  """Language code (ISO 639-1)"""
+  code: ID!
+
+  """Text direction"""
+  direction: LanguageDirection!
+
+  """English language name"""
+  englishName: String!
+
+  """Whether this is the default language"""
+  isDefault: Boolean!
+
+  """Locale code (e.g., "pl-PL")"""
+  locale: String
+
+  """Native language name"""
+  nativeName: String!
+}
+
+"""Text direction for the language"""
+enum LanguageDirection {
+  LTR
+  RTL
+}
+
+"""Locale to currency mapping entry"""
+type LocaleCurrencyMapping {
+  """Currency code (e.g., "PLN", "USD")"""
+  currency: String!
+
+  """Browser locale (e.g., "pl-PL", "en-US")"""
+  locale: String!
+}
+
+"""Type of inventory location"""
+enum LocationType {
+  DROPSHIPPER
+  FULFILLMENT_CENTER
+  STORE
+  WAREHOUSE
+}
+
+"""Available point earning action"""
+type LoyaltyAction {
+  """Whether action is enabled"""
+  enabled: Boolean!
+
+  """Points awarded for this action (if fixed)"""
+  points: Int
+
+  """Action type"""
+  type: String!
+}
+
+"""Loyalty program member"""
+type LoyaltyMember {
+  """Annual spend amount"""
+  annualSpend: Money!
+
+  """Customer ID"""
+  customerId: ID!
+
+  """Enrollment date"""
+  enrolledAt: String!
+
+  """Member ID"""
+  id: ID!
+
+  """Last activity date"""
+  lastActivityAt: String
+
+  """Points summary"""
+  points: LoyaltyPointsSummary!
+
+  """Current tier"""
+  tier: LoyaltyTier
+
+  """Progress to next tier"""
+  tierProgress: TierProgress
+}
+
+"""Page info"""
+type LoyaltyPageInfo {
+  """End cursor"""
+  endCursor: String
+
+  """Has next page"""
+  hasNextPage: Boolean!
+
+  """Has previous page"""
+  hasPreviousPage: Boolean!
+
+  """Start cursor"""
+  startCursor: String
+}
+
+"""Loyalty points summary"""
+type LoyaltyPointsSummary {
+  """Currently available points"""
+  currentPoints: Int!
+
+  """Points expired"""
+  expiredPoints: Int!
+
+  """Points expiring soon (next 30 days)"""
+  expiringPoints: Int
+
+  """Next expiry date"""
+  nextExpiryDate: String
+
+  """Points pending (from incomplete orders)"""
+  pendingPoints: Int!
+
+  """Points redeemed"""
+  redeemedPoints: Int!
+
+  """Total points earned all-time"""
+  totalPoints: Int!
+}
+
+"""Redeemable loyalty reward"""
+type LoyaltyReward {
+  """Whether reward is available"""
+  available: Boolean!
+
+  """Description"""
+  description: String
+
+  """Discount amount (if discount type)"""
+  discountAmount: Money
+
+  """Discount percentage (if discount type)"""
+  discountPercent: Float
+
+  """Reward ID"""
+  id: ID!
+
+  """Reward image"""
+  image: Image
+
+  """Reward name"""
+  name: String!
+
+  """Points required to redeem"""
+  pointsCost: Int!
+
+  """Remaining redemptions (null = unlimited)"""
+  remainingRedemptions: Int
+
+  """URL-friendly slug"""
+  slug: String!
+
+  """Minimum tier required"""
+  tierRequired: LoyaltyTier
+
+  """Reward type (discount, product, shipping, gift_card)"""
+  type: String!
+}
+
+"""Public loyalty program settings"""
+type LoyaltySettings {
+  """Available point earning actions"""
+  availableActions: [LoyaltyAction!]!
+
+  """Whether loyalty program is enabled"""
+  enabled: Boolean!
+
+  """Months until points expire (null = no expiry)"""
+  pointsExpiryMonths: Int
+
+  """Custom name for points (e.g., "Points", "Stars", "Coins")"""
+  pointsName: String!
+
+  """Points earned per 1 unit of currency"""
+  pointsPerCurrency: Float!
+
+  """Bonus points for referred customer"""
+  referralBonusPoints: Int
+
+  """Whether referral program is enabled"""
+  referralEnabled: Boolean!
+
+  """Points awarded to referrer"""
+  referralPoints: Int
+}
+
+"""Loyalty program tier"""
+type LoyaltyTier {
+  """Additional custom benefits"""
+  customBenefits: [TierBenefit!]!
+
+  """Tier ID"""
+  id: ID!
+
+  """Minimum annual spend required"""
+  minAnnualSpend: Money
+
+  """Minimum points required for tier"""
+  minPoints: Int!
+
+  """Tier name"""
+  name: String!
+
+  """Points earning multiplier (e.g., 1.5 for 50% bonus)"""
+  pointsMultiplier: Float!
+
+  """Tier type (null for custom tiers)"""
+  type: LoyaltyTierType
+}
+
+"""Loyalty program tier level"""
+enum LoyaltyTierType {
+  BRONZE
+  DIAMOND
+  GOLD
+  PLATINUM
+  SILVER
+}
+
+"""Loyalty points transaction"""
+type LoyaltyTransaction {
+  """Balance after transaction"""
+  balanceAfter: Int!
+
+  """Transaction date"""
+  createdAt: String!
+
+  """Description"""
+  description: String
+
+  """Expiry date for earned points"""
+  expiresAt: String
+
+  """Transaction ID"""
+  id: ID!
+
+  """Related order ID"""
+  orderId: String
+
+  """Points (positive = earn, negative = spend)"""
+  points: Int!
+
+  """Transaction type"""
+  type: LoyaltyTransactionType!
+}
+
+"""Paginated loyalty transactions"""
+type LoyaltyTransactionConnection {
+  """Transaction edges"""
+  edges: [LoyaltyTransactionEdge!]!
+
+  """Pagination info"""
+  pageInfo: LoyaltyPageInfo!
+
+  """Total count of transactions"""
+  totalCount: Int!
+}
+
+"""Loyalty transaction edge"""
+type LoyaltyTransactionEdge {
+  """Cursor for pagination"""
+  cursor: String!
+
+  """The transaction"""
+  node: LoyaltyTransaction!
+}
+
+"""Type of loyalty points transaction"""
+enum LoyaltyTransactionType {
+  ADJUST
+  EARN_BIRTHDAY
+  EARN_BONUS
+  EARN_PURCHASE
+  EARN_REFERRAL
+  EARN_REVIEW
+  EARN_SIGNUP
+  EXPIRE
+  REDEEM
+  REFUND_REVERSAL
+}
+
+"""Customer mailing address"""
+type MailingAddress {
+  """First line of address"""
+  address1: String
+
+  """Second line of address"""
+  address2: String
+
+  """City"""
+  city: String
+
+  """Company name"""
+  company: String
+
+  """Country"""
+  country: String
+
+  """Country code (ISO)"""
+  countryCode: String
+
+  """First name"""
+  firstName: String
+
+  """Unique identifier"""
+  id: ID!
+
+  """Whether this is default address"""
+  isDefault: Boolean!
+
+  """Last name"""
+  lastName: String
+
+  """Phone number"""
+  phone: String
+
+  """Province/State"""
+  province: String
+
+  """Province code"""
+  provinceCode: String
+
+  """ZIP/Postal code"""
+  zip: String
+}
+
+"""Input for mailing address"""
+input MailingAddressInput {
+  """First line of address"""
+  address1: String
+
+  """Second line of address"""
+  address2: String
+
+  """City"""
+  city: String
+
+  """Company"""
+  company: String
+
+  """Country code (ISO)"""
+  country: String
+
+  """First name"""
+  firstName: String
+
+  """Last name"""
+  lastName: String
+
+  """Phone"""
+  phone: String
+
+  """Province/State"""
+  province: String
+
+  """ZIP/Postal code"""
+  zip: String
+}
+
+"""Monetary value with currency"""
+type Money {
+  """Decimal money amount"""
+  amount: String!
+
+  """Currency code (ISO 4217)"""
+  currencyCode: String!
+}
+
+type Mutation {
+  """Update buyer identity"""
+  cartBuyerIdentityUpdate(buyerIdentity: CartBuyerIdentityInput!, cartId: ID!): CartBuyerIdentityUpdatePayload!
+
+  """Create new cart"""
+  cartCreate(input: CartCreateInput): CartCreatePayload!
+
+  """Update discount codes"""
+  cartDiscountCodesUpdate(cartId: ID!, discountCodes: [String!]!): CartDiscountCodesUpdatePayload!
+
+  """Add lines to cart"""
+  cartLinesAdd(cartId: ID!, lines: [CartLineInput!]!): CartLinesAddPayload!
+
+  """Remove lines from cart"""
+  cartLinesRemove(cartId: ID!, lineIds: [ID!]!): CartLinesRemovePayload!
+
+  """Update cart lines"""
+  cartLinesUpdate(cartId: ID!, lines: [CartLineUpdateInput!]!): CartLinesUpdatePayload!
+
+  """Update cart note"""
+  cartNoteUpdate(cartId: ID!, note: String!): CartNoteUpdatePayload!
+
+  """Update checkout billing address"""
+  checkoutBillingAddressUpdate(billingAddress: CheckoutAddressInput!, checkoutId: ID!): CheckoutBillingAddressUpdatePayload!
+
+  """Complete checkout and create order"""
+  checkoutComplete(checkoutId: ID!, input: CheckoutCompleteInput): CheckoutCompletePayload!
+
+  """Create new checkout"""
+  checkoutCreate(input: CheckoutCreateInput!): CheckoutCreatePayload!
+
+  """Apply discount code to checkout"""
+  checkoutDiscountCodeApply(checkoutId: ID!, discountCode: String!): CheckoutDiscountCodeApplyPayload!
+
+  """Remove discount code from checkout"""
+  checkoutDiscountCodeRemove(checkoutId: ID!, discountCode: String!): CheckoutDiscountCodeRemovePayload!
+
+  """Validate discount code without applying"""
+  checkoutDiscountCodeValidate(checkoutId: ID!, discountCode: String!): CheckoutDiscountCodeValidatePayload!
+
+  """Update checkout email"""
+  checkoutEmailUpdate(checkoutId: ID!, email: String!): CheckoutEmailUpdatePayload!
+
+  """Apply gift card to checkout"""
+  checkoutGiftCardApply(checkoutId: ID!, giftCardCode: String!): CheckoutGiftCardApplyPayload!
+
+  """Update gift card recipient info for a line item"""
+  checkoutGiftCardRecipientUpdate(input: CheckoutGiftCardRecipientInput!): CheckoutGiftCardRecipientUpdatePayload!
+
+  """Remove gift card from checkout"""
+  checkoutGiftCardRemove(checkoutId: ID!, giftCardCode: String!): CheckoutGiftCardRemovePayload!
+
+  """Update checkout payment method"""
+  checkoutPaymentMethodUpdate(checkoutId: ID!, paymentMethodId: ID!): CheckoutPaymentMethodUpdatePayload!
+
+  """Update checkout shipping address"""
+  checkoutShippingAddressUpdate(checkoutId: ID!, shippingAddress: CheckoutAddressInput!): CheckoutShippingAddressUpdatePayload!
+
+  """Update checkout shipping method"""
+  checkoutShippingLineUpdate(checkoutId: ID!, shippingRateHandle: String!): CheckoutShippingLineUpdatePayload!
+
+  """Login customer"""
+  customerAccessTokenCreate(input: CustomerAccessTokenCreateInput!): CustomerAccessTokenCreatePayload!
+
+  """Logout customer"""
+  customerAccessTokenDelete(customerAccessToken: String!): CustomerAccessTokenDeletePayload!
+
+  """Refresh access token"""
+  customerAccessTokenRenew(customerAccessToken: String!): CustomerAccessTokenRenewPayload!
+
+  """Create customer address"""
+  customerAddressCreate(address: MailingAddressInput!, customerAccessToken: String!): CustomerAddressCreatePayload!
+
+  """Delete customer address"""
+  customerAddressDelete(customerAccessToken: String!, id: ID!): CustomerAddressDeletePayload!
+
+  """Update customer address"""
+  customerAddressUpdate(address: MailingAddressInput!, customerAccessToken: String!, id: ID!): CustomerAddressUpdatePayload!
+
+  """Register new customer"""
+  customerCreate(input: CustomerCreateInput!): CustomerCreatePayload!
+
+  """Set default address"""
+  customerDefaultAddressUpdate(addressId: ID!, customerAccessToken: String!): CustomerDefaultAddressUpdatePayload!
+
+  """Send password reset email"""
+  customerRecover(email: String!): CustomerRecoverPayload!
+
+  """Reset password"""
+  customerReset(id: ID!, input: String!, password: String!): CustomerResetPayload!
+
+  """Update customer profile"""
+  customerUpdate(customer: CustomerUpdateInput!, customerAccessToken: String!): CustomerUpdatePayload!
+
+  """Generate or retrieve referral code"""
+  generateReferralCode: GenerateReferralCodePayload!
+
+  """Redeem a loyalty reward"""
+  redeemLoyaltyReward(input: RedeemRewardInput!): RedeemRewardPayload!
+
+  """Cancel a return request"""
+  returnCancel(customerAccessToken: String!, id: ID!): ReturnCancelPayload!
+
+  """Create a return request"""
+  returnCreate(customerAccessToken: String!, input: ReturnCreateInput!): ReturnCreatePayload!
+
+  """Create a product review"""
+  reviewCreate(input: ReviewCreateInput!): ReviewPayload!
+
+  """Vote on review helpfulness"""
+  reviewVote(isHelpful: Boolean!, reviewId: ID!): ReviewPayload!
+
+  """Add item to wishlist"""
+  wishlistAddItem(input: WishlistItemInput!, wishlistId: ID!): WishlistPayload!
+
+  """Create a new wishlist"""
+  wishlistCreate(input: WishlistCreateInput!): WishlistPayload!
+
+  """Delete a wishlist"""
+  wishlistDelete(wishlistId: ID!): WishlistPayload!
+
+  """Remove item from wishlist"""
+  wishlistRemoveItem(itemId: ID!, wishlistId: ID!): WishlistPayload!
+}
+
+"""Customer order summary"""
+type Order {
+  """When order was cancelled"""
+  cancelledAt: DateTime
+
+  """When order was confirmed"""
+  confirmedAt: DateTime
+
+  """When order expired"""
+  expiredAt: DateTime
+
+  """Financial status"""
+  financialStatus: OrderFinancialStatus!
+
+  """Fulfillment status"""
+  fulfillmentStatus: OrderFulfillmentStatus!
+
+  """Unique identifier"""
+  id: ID!
+
+  """Line items count"""
+  lineItemsCount: Int!
+
+  """Order number (human-readable)"""
+  orderNumber: String!
+
+  """Order date"""
+  processedAt: String!
+
+  """Order shipments"""
+  shipments: [Shipment!]!
+
+  """Shipping address"""
+  shippingAddress: MailingAddress
+
+  """Order lifecycle status"""
+  status: StorefrontOrderStatus!
+
+  """Order subtotal"""
+  subtotalPrice: Money!
+
+  """Order total"""
+  totalPrice: Money!
+
+  """Total shipping"""
+  totalShipping: Money
+
+  """Total tax"""
+  totalTax: Money
+}
+
+"""Paginated order connection"""
+type OrderConnection {
+  """Order edges"""
+  edges: [OrderEdge!]!
+
+  """Pagination info"""
+  pageInfo: PageInfo!
+
+  """Total orders count"""
+  totalCount: Int!
+}
+
+"""Order edge for pagination"""
+type OrderEdge {
+  """Cursor"""
+  cursor: String!
+
+  """Order node"""
+  node: Order!
+}
+
+"""Financial status of an order"""
+enum OrderFinancialStatus {
+  AUTHORIZED
+  CHARGEBACK
+  FAILED
+  PAID
+  PARTIALLY_PAID
+  PARTIALLY_REFUNDED
+  PENDING
+  REFUNDED
+  REFUND_PENDING
+  UNPAID
+  VOIDED
+}
+
+"""Fulfillment status of an order"""
+enum OrderFulfillmentStatus {
+  DELIVERED
+  FULFILLED
+  IN_TRANSIT
+  LOST
+  PARTIALLY_FULFILLED
+  PARTIALLY_RETURNED
+  RETURNED
+  UNFULFILLED
+}
+
+"""Package dimensions for rate calculation"""
+input PackageDimensionsInput {
+  """Height in cm"""
+  height: Int
+
+  """Length in cm"""
+  length: Int
+
+  """Weight in grams"""
+  weight: Int!
+
+  """Width in cm"""
+  width: Int
+}
+
+"""Pagination information"""
+type PageInfo {
+  """Cursor of last item"""
+  endCursor: String
+
+  """Whether there are more items after"""
+  hasNextPage: Boolean!
+
+  """Whether there are more items before"""
+  hasPreviousPage: Boolean!
+
+  """Cursor of first item"""
+  startCursor: String
+}
+
+"""Payment method available for checkout"""
+type PaymentMethod {
+  """Description for customers"""
+  description: String
+
+  """Icon URL or path"""
+  icon: String
+
+  """Payment method ID"""
+  id: ID!
+
+  """Whether this is the default payment method"""
+  isDefault: Boolean!
+
+  """Display name"""
+  name: String!
+
+  """Display position (lower = higher priority)"""
+  position: Float!
+
+  """Provider code (payu, stripe, p24, etc.)"""
+  provider: String!
+
+  """Supported currency codes"""
+  supportedCurrencies: [String!]
+
+  """Type of payment method"""
+  type: PaymentMethodType!
+}
+
+"""Type of payment method"""
+enum PaymentMethodType {
+  APPLE_PAY
+  BANK_TRANSFER
+  BLIK
+  CARD
+  CASH_ON_DELIVERY
+  GOOGLE_PAY
+  OTHER
+  PAYPAL
+}
+
+"""Points estimate for an order"""
+type PointsEstimate {
+  """Base points to earn"""
+  basePoints: Int!
+
+  """Bonus points from tier multiplier"""
+  bonusPoints: Int!
+
+  """Tier multiplier applied"""
+  multiplier: Float
+
+  """Total points to earn"""
+  totalPoints: Int!
+}
+
+"""Price with full conversion transparency"""
+type PriceMoney {
+  """Price amount in display currency"""
+  amount: String!
+
+  """Original price in shop base currency"""
+  baseAmount: String!
+
+  """Shop base currency code"""
+  baseCurrencyCode: String!
+
+  """Display currency code (ISO 4217)"""
+  currencyCode: String!
+
+  """Exchange rate used (null if same currency)"""
+  exchangeRate: Float
+
+  """Whether price was converted from different currency"""
+  isConverted: Boolean!
+
+  """Margin applied by shop (e.g., 0.02 = 2%)"""
+  marginApplied: Float
+
+  """When the exchange rate was fetched"""
+  rateTimestamp: DateTime
+}
+
+"""Price range for filtering"""
+type PriceRange {
+  """Maximum price in current product set"""
+  max: Money!
+
+  """Minimum price in current product set"""
+  min: Money!
+}
+
+"""Quantity-based pricing tier"""
+type PricingTier {
+  """Discount percentage from retail"""
+  discountPercent: Float!
+
+  """Maximum quantity for this tier"""
+  maxQuantity: Int
+
+  """Minimum quantity for this tier"""
+  minQuantity: Int!
+
+  """Price per unit at this tier"""
+  unitPrice: Money!
+}
+
+"""Product - main catalog item"""
+type Product {
+  """Whether product is available for sale (any variant in stock)"""
+  availableForSale: Boolean!
+
+  """Average rating (1-5)"""
+  averageRating: Float
+
+  """Whether storefront checkout collects recipient data for this product"""
+  collectRecipientInfo: Boolean!
+
+  """Compare-at price range in customer preferred currency (auto-converted)"""
+  compareAtPriceRange: ConvertedPriceRange
+
+  """Creation timestamp"""
+  createdAt: DateTime!
+
+  """Plain text description"""
+  description: String
+
+  """HTML description"""
+  descriptionHtml: String
+
+  """Featured/primary image"""
+  featuredImage: Image
+
+  """URL-friendly handle (slug)"""
+  handle: String!
+
+  """Unique identifier"""
+  id: ID!
+
+  """All product images"""
+  images(first: Float = 10): [Image!]!
+
+  """Original compare-at price range in shop base currency"""
+  originalCompareAtPriceRange: ProductPriceRange
+
+  """Original price range in shop base currency"""
+  originalPriceRange: ProductPriceRange
+
+  """Price range in customer preferred currency (auto-converted)"""
+  priceRange: ConvertedPriceRange!
+
+  """Product type/category (free text)"""
+  productType: String
+
+  """Similar products recommendations"""
+  recommendations(first: Int = 4): ProductRecommendations
+
+  """Number of reviews"""
+  reviewCount: Int
+
+  """SEO metadata"""
+  seo: SEO
+
+  """Product tags"""
+  tags: [String!]!
+
+  """Product title"""
+  title: String!
+
+  """Total inventory across all variants"""
+  totalInventory: Int
+
+  """
+  Product type enum (PHYSICAL, DIGITAL, SERVICE, SUBSCRIPTION, GIFT_CARD)
+  """
+  type: ProductTypeEnum!
+
+  """Last update timestamp"""
+  updatedAt: DateTime!
+
+  """Product variants"""
+  variants(first: Float = 100): [ProductVariant!]!
+
+  """Vendor/brand name"""
+  vendor: String
+}
+
+"""Paginated product list"""
+type ProductConnection {
+  """Product edges"""
+  edges: [ProductEdge!]!
+
+  """Pagination info"""
+  pageInfo: PageInfo!
+
+  """Total count of products"""
+  totalCount: Int!
+}
+
+"""Product edge for pagination"""
+type ProductEdge {
+  """Cursor for pagination"""
+  cursor: String!
+
+  """Product node"""
+  node: Product!
+}
+
+"""Product filter options"""
+input ProductFilterInput {
+  """Dynamic attribute filters (Requirements: R35.12, R35.13, R35.14)"""
+  attributes: [AttributeFilterInput!]
+
+  """Filter by availability"""
+  available: Boolean
+
+  """
+  Filter by category ID (supports comma-separated UUIDs for multi-category)
+  """
+  categoryId: ID
+
+  """
+  Filter by collection ID (supports comma-separated UUIDs for multi-collection)
+  """
+  collectionId: ID
+
+  """Filter by maximum price"""
+  maxPrice: Float
+
+  """Filter by minimum price"""
+  minPrice: Float
+
+  """Filter by product type"""
+  productType: String
+
+  """Filter by product types"""
+  productTypes: [String!]
+
+  """Filter by tag"""
+  tag: String
+
+  """Filter by tags"""
+  tags: [String!]
+
+  """Filter by vendor"""
+  vendor: String
+
+  """Filter by vendor names"""
+  vendors: [String!]
+}
+
+"""Original price range in shop base currency"""
+type ProductPriceRange {
+  """Maximum variant price (shop currency)"""
+  maxVariantPrice: Money!
+
+  """Minimum variant price (shop currency)"""
+  minVariantPrice: Money!
+}
+
+"""Single product recommendation with metadata"""
+type ProductRecommendation {
+  """The recommended product"""
+  product: Product!
+
+  """Reason for recommendation"""
+  reason: String
+
+  """Relevance score (0-100, higher is more relevant)"""
+  score: Int
+
+  """Type of recommendation"""
+  type: RecommendationType!
+}
+
+"""Collection of product recommendations"""
+type ProductRecommendations {
+  """List of product recommendations"""
+  items: [ProductRecommendation!]!
+
+  """Total available recommendations"""
+  totalCount: Int!
+}
+
+"""Product review"""
+type ProductReview {
+  """Author display name"""
+  authorName: String!
+
+  """Cons list"""
+  cons: [String!]!
+
+  """Review content"""
+  content: String!
+
+  """Review date"""
+  createdAt: DateTime!
+
+  """Helpful votes count"""
+  helpfulCount: Int!
+  id: ID!
+
+  """Review images"""
+  images: [String!]!
+
+  """Is verified purchase"""
+  isVerifiedPurchase: Boolean!
+  productId: ID!
+
+  """Pros list"""
+  pros: [String!]!
+
+  """Rating 1-5"""
+  rating: Int!
+
+  """Store response"""
+  response: String
+
+  """Response date"""
+  responseAt: DateTime
+
+  """Review title"""
+  title: String
+}
+
+"""Paginated reviews connection"""
+type ProductReviewConnection {
+  edges: [ProductReviewEdge!]!
+  pageInfo: PageInfo!
+  totalCount: Int!
+}
+
+"""Review edge for pagination"""
+type ProductReviewEdge {
+  cursor: String!
+  node: ProductReview!
+}
+
+"""Sort keys for products"""
+enum ProductSortKeys {
+  BEST_SELLING
+  CREATED_AT
+  PRICE
+  RELEVANCE
+  TITLE
+  UPDATED_AT
+}
+
+"""Product type classification"""
+enum ProductTypeEnum {
+  DIGITAL
+  GIFT_CARD
+  PHYSICAL
+  SERVICE
+  SUBSCRIPTION
+}
+
+"""Product variant - purchasable unit"""
+type ProductVariant {
+  """Whether variant is available for purchase"""
+  available: Boolean!
+
+  """Barcode"""
+  barcode: String
+
+  """Compare at price in customer preferred currency"""
+  compareAtPrice: PriceMoney
+
+  """Unique identifier"""
+  id: ID!
+
+  """Variant image"""
+  image: Image
+
+  """
+  Inventory levels per location. Null for single-location shops. Use locationType filter for BOPIS.
+  """
+  inventoryLevels(locationType: LocationType): [InventoryLevel!]
+
+  """Original compare at price in shop base currency"""
+  originalCompareAtPrice: Money
+
+  """Original price in shop base currency"""
+  originalPrice: Money
+
+  """Position in product variants list"""
+  position: Int
+
+  """Price in customer preferred currency (auto-converted)"""
+  price: PriceMoney!
+
+  """Quantity available in stock"""
+  quantityAvailable: Int
+
+  """Selected options for this variant"""
+  selectedOptions: [SelectedOption!]!
+
+  """SKU code"""
+  sku: String
+
+  """Variant title (e.g., "Large / Red")"""
+  title: String!
+
+  """Weight in grams"""
+  weight: Float
+}
+
+type Query {
+  """List of all currencies supported by the system (ECB rates)"""
+  allSupportedCurrencies: [Currency!]!
+
+  """Get available filters for product listing"""
+  availableFilters(input: AvailableFiltersInput): AvailableFilters!
+
+  """Get available payment methods"""
+  availablePaymentMethods: AvailablePaymentMethods!
+
+  """Get available shipping methods for address"""
+  availableShippingMethods(address: ShippingAddressInput!, cart: CartShippingInput): AvailableShippingMethodsPayload!
+
+  """Get live shipping rates from configured carriers"""
+  availableShippingRates(address: ShippingAddressInput!, packages: [PackageDimensionsInput!], totalWeight: Float): AvailableShippingRatesPayload!
+
+  """Get B2B pricing for a product variant"""
+  b2bPricing(quantity: Float = 1, retailPrice: Float!, variantId: ID!): B2BPriceDisplay
+
+  """List blog categories"""
+  blogCategories: [BlogCategory!]!
+
+  """Get single blog post"""
+  blogPost(
+    """Post ID"""
+    id: ID
+
+    """Post slug"""
+    slug: String
+  ): BlogPost
+
+  """List blog posts"""
+  blogPosts(
+    """Cursor for pagination"""
+    after: String
+
+    """Filter by author ID"""
+    authorId: String
+
+    """Filter by category slug"""
+    categorySlug: String
+
+    """Filter featured posts only"""
+    featured: Boolean
+
+    """Number of posts to fetch"""
+    first: Int! = 10
+
+    """Reverse sort order"""
+    reverse: Boolean! = true
+
+    """Sort key"""
+    sortKey: BlogPostSortKey = PUBLISHED_AT
+
+    """Filter by tag slug"""
+    tagSlug: String
+  ): BlogPostConnection!
+
+  """List blog tags"""
+  blogTags(limit: Int = 50): [BlogTag!]!
+
+  """Get cart by ID"""
+  cart(id: ID!): Cart
+
+  """Get recommendations based on cart contents"""
+  cartRecommendations(
+    """Cart ID to base recommendations on"""
+    cartId: String!
+    first: Int = 4
+  ): CartRecommendations!
+
+  """Get category tree"""
+  categories(
+    """Cursor for pagination"""
+    after: String
+
+    """Number of items to fetch"""
+    first: Int! = 20
+
+    """Filter by parent category ID"""
+    parentId: ID
+
+    """Only root categories"""
+    rootsOnly: Boolean! = false
+  ): CategoryTree!
+
+  """Get category by ID or slug"""
+  category(
+    """Category ID"""
+    id: ID
+
+    """Category slug"""
+    slug: String
+  ): Category
+
+  """Get checkout by ID"""
+  checkout(id: ID!): Checkout
+
+  """Get single collection"""
+  collection(
+    """Collection handle (slug)"""
+    handle: String
+
+    """Collection ID"""
+    id: ID
+  ): Collection
+
+  """List collections with pagination"""
+  collections(
+    """Cursor for pagination"""
+    after: String
+
+    """Number of collections to return"""
+    first: Int! = 20
+
+    """Search query"""
+    query: String
+
+    """Reverse sort order"""
+    reverse: Boolean! = false
+
+    """Sort key"""
+    sortKey: CollectionSortKeys! = TITLE
+  ): CollectionConnection!
+
+  """Convert amount between currencies (applies shop margin)"""
+  convertCurrency(
+    """Amount to convert"""
+    amount: Float!
+
+    """Source currency code"""
+    from: String!
+
+    """Target currency code"""
+    to: String!
+  ): CurrencyConversion!
+
+  """List of currencies available for this shop"""
+  currencies: [Currency!]!
+
+  """Get currency information by ISO 4217 code"""
+  currencyInfo(
+    """ISO 4217 currency code (e.g., PLN, EUR, USD)"""
+    code: String!
+  ): Currency
+
+  """Get authenticated customer"""
+  customer(customerAccessToken: String!): Customer
+
+  """Get available customer groups"""
+  customerGroups: [CustomerGroup!]
+
+  """Get single order for authenticated customer"""
+  customerOrder(customerAccessToken: String!, orderId: ID!): Order
+
+  """Estimate points for an order amount"""
+  estimatePoints(
+    """Order total in major currency units (e.g., PLN)"""
+    orderTotal: Float!
+  ): PointsEstimate!
+
+  """Get exchange rate between two currencies"""
+  exchangeRate(
+    """Source currency code (ISO 4217)"""
+    from: String!
+
+    """Target currency code (ISO 4217)"""
+    to: String!
+  ): ExchangeRate
+
+  """Get gift card by code"""
+  giftCard(code: String!): GiftCardPayload!
+
+  """Validate gift card for use"""
+  giftCardValidate(amount: Float, code: String!): GiftCardValidatePayload!
+
+  """Get available languages for this shop"""
+  languages: [Language!]!
+
+  """Get loyalty member status"""
+  loyaltyMember: LoyaltyMember
+
+  """List available loyalty rewards"""
+  loyaltyRewards: [LoyaltyReward!]!
+
+  """Get public loyalty program settings"""
+  loyaltySettings: LoyaltySettings!
+
+  """List all loyalty tiers"""
+  loyaltyTiers: [LoyaltyTier!]!
+
+  """Get loyalty transaction history"""
+  loyaltyTransactions(after: String, first: Int = 20): LoyaltyTransactionConnection!
+
+  """Get single product by ID or handle"""
+  product(
+    """Product handle (slug)"""
+    handle: String
+
+    """Product ID"""
+    id: ID
+  ): Product
+
+  """Get recommended products similar to the given product"""
+  productRecommendations(
+    """Type of recommendations (SIMILAR, COMPLEMENTARY, UPSELL)"""
+    intent: RecommendationIntent = SIMILAR
+
+    """Maximum number of recommendations"""
+    limit: Int! = 8
+
+    """Source product ID to get recommendations for"""
+    productId: ID!
+  ): [Product!]!
+
+  """Get product reviews"""
+  productReviews(after: String, first: Int = 10, productId: ID!, reverse: Boolean = true, sortKey: ReviewSortKey = CREATED_AT): ProductReviewConnection!
+
+  """Search products"""
+  productSearch(
+    """Cursor for pagination"""
+    after: String
+
+    """Filter options"""
+    filters: ProductFilterInput
+
+    """Number of items to fetch"""
+    first: Int! = 20
+
+    """Search query"""
+    query: String!
+  ): ProductConnection!
+
+  """List products with pagination and filtering"""
+  products(
+    """Cursor for pagination"""
+    after: String
+
+    """Product filters"""
+    filters: ProductFilterInput
+
+    """Number of items to fetch"""
+    first: Int! = 20
+
+    """Search query"""
+    query: String
+
+    """Reverse sort order"""
+    reverse: Boolean! = false
+
+    """Sort key"""
+    sortKey: ProductSortKeys = BEST_SELLING
+  ): ProductConnection!
+
+  """Get personalized product recommendations"""
+  recommendations(first: Int = 10): ProductRecommendations!
+
+  """Get referral program statistics"""
+  referralStats: ReferralStats
+
+  """Get return by ID"""
+  return(customerAccessToken: String!, id: ID!): ReturnPayload!
+
+  """Get available return reasons"""
+  returnReasons: [ReturnReasonOption!]!
+
+  """Get returns for an order"""
+  returnsByOrder(customerAccessToken: String!, orderId: ID!): ReturnConnection!
+
+  """Get product review statistics"""
+  reviewStats(productId: ID!): ReviewStats!
+
+  """Get shipment by ID"""
+  shipment(customerAccessToken: String!, id: ID!): ShipmentPayload!
+
+  """Get shipment by tracking number"""
+  shipmentByTrackingNumber(trackingNumber: String!): ShipmentPayload!
+
+  """Get current shop information"""
+  shop: Shop!
+
+  """Get currency configuration for the current shop"""
+  shopCurrencyConfig: ShopCurrencyConfig!
+
+  """Get products similar to a specific product"""
+  similarProducts(
+    first: Int = 6
+
+    """Product ID to find similar products for"""
+    productId: String!
+  ): ProductRecommendations!
+
+  """Get translations for a language"""
+  translations(input: TranslationsInput!): Translations!
+
+  """Get wishlist by ID"""
+  wishlist(
+    """Wishlist ID"""
+    id: ID
+  ): Wishlist
+
+  """Get customer wishlists (requires customer auth)"""
+  wishlists: [Wishlist!]!
+}
+
+"""Type of product recommendations to return"""
+enum RecommendationIntent {
+  COMPLEMENTARY
+  SIMILAR
+  UPSELL
+}
+
+"""Type of product recommendation"""
+enum RecommendationType {
+  CROSS_SELL
+  FREQUENTLY_BOUGHT_TOGETHER
+  PERSONALIZED
+  RECENTLY_VIEWED
+  SIMILAR
+  TRENDING
+  UPSELL
+}
+
+"""Input for redeeming a loyalty reward"""
+input RedeemRewardInput {
+  """Reward ID to redeem"""
+  rewardId: ID!
+}
+
+"""Result of reward redemption"""
+type RedeemRewardPayload {
+  """Generated discount code for DISCOUNT type rewards"""
+  discountCode: String
+
+  """Generated gift card code for GIFT_CARD type rewards"""
+  giftCardCode: String
+
+  """
+  Generated discount code for PRODUCT type rewards (100% off specific product)
+  """
+  productDiscountCode: String
+
+  """Whether redemption was successful"""
+  success: Boolean!
+
+  """Error messages if any"""
+  userErrors: [String!]!
+}
+
+"""Referral program statistics"""
+type ReferralStats {
+  """Completed referrals (first order placed)"""
+  completedReferrals: Int!
+
+  """Pending referrals (signed up, no order yet)"""
+  pendingReferrals: Int!
+
+  """Customer referral code"""
+  referralCode: String!
+
+  """Shareable referral URL"""
+  shareUrl: String!
+
+  """Total points earned from referrals"""
+  totalPointsEarned: Int!
+
+  """Total customers referred"""
+  totalReferred: Int!
+}
+
+"""Return/RMA request"""
+type Return {
+  """When return was approved"""
+  approvedAt: DateTime
+
+  """Requested compensation type"""
+  compensationType: CompensationType
+
+  """When return was completed"""
+  completedAt: DateTime
+
+  """Creation date"""
+  createdAt: DateTime!
+
+  """Customer notes/explanation"""
+  customerNote: String
+
+  """Return ID"""
+  id: ID!
+
+  """Items being returned"""
+  items: [ReturnItem!]!
+
+  """Order ID"""
+  orderId: ID!
+
+  """Order number"""
+  orderNumber: String!
+
+  """Primary return reason"""
+  reason: ReturnReason!
+
+  """When return was received"""
+  receivedAt: DateTime
+
+  """Total refund amount"""
+  refundAmount: Money
+
+  """When refund was processed"""
+  refundedAt: DateTime
+
+  """When return was requested"""
+  requestedAt: DateTime
+
+  """RMA number (e.g., RMA-2024-0001)"""
+  returnNumber: String!
+
+  """Return shipping label (if generated)"""
+  shippingLabel: ReturnShippingLabel
+
+  """Current return status"""
+  status: ReturnStatus!
+
+  """Last update date"""
+  updatedAt: DateTime!
+}
+
+"""Result of return cancellation"""
+type ReturnCancelPayload {
+  """Cancelled return"""
+  return: Return
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Paginated return connection"""
+type ReturnConnection {
+  """Return edges"""
+  edges: [ReturnEdge!]!
+
+  """Pagination info"""
+  pageInfo: PageInfo!
+
+  """Total returns count"""
+  totalCount: Int!
+}
+
+"""Input for creating a return request"""
+input ReturnCreateInput {
+  """Preferred compensation type (defaults to REFUND)"""
+  compensationType: CompensationType
+
+  """Customer notes/explanation"""
+  customerNote: String
+
+  """Idempotency key to prevent duplicate submissions"""
+  idempotencyKey: String
+
+  """Items to return"""
+  items: [ReturnItemInput!]!
+
+  """Order ID to return items from"""
+  orderId: ID!
+
+  """Primary return reason"""
+  reason: ReturnReason!
+}
+
+"""Result of return creation"""
+type ReturnCreatePayload {
+  """Created return"""
+  return: Return
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Return edge for pagination"""
+type ReturnEdge {
+  """Cursor"""
+  cursor: String!
+
+  """Return node"""
+  node: Return!
+}
+
+"""Item included in a return request"""
+type ReturnItem {
+  """Approved quantity (may differ from requested)"""
+  approvedQuantity: Int
+
+  """Item condition"""
+  condition: String
+
+  """Item ID"""
+  id: ID!
+
+  """Product image URL"""
+  imageUrl: String
+
+  """Evidence photos"""
+  photos: [ReturnItemPhoto!]
+
+  """Product title"""
+  productTitle: String!
+
+  """Quantity being returned"""
+  quantity: Int!
+
+  """Reason for returning this item"""
+  reason: ReturnReason!
+
+  """Product SKU"""
+  sku: String
+
+  """Item-level status"""
+  status: String
+
+  """Unit price of the item"""
+  unitPrice: Money
+
+  """Product variant ID"""
+  variantId: ID!
+
+  """Variant title"""
+  variantTitle: String
+}
+
+"""Input for a return item"""
+input ReturnItemInput {
+  """Item condition"""
+  condition: String
+
+  """Quantity to return"""
+  quantity: Int!
+
+  """Reason for returning this item"""
+  reason: ReturnReason!
+
+  """Product variant ID to return"""
+  variantId: ID!
+}
+
+"""Photo evidence for a return item"""
+type ReturnItemPhoto {
+  """Alt text for accessibility"""
+  alt: String
+
+  """Upload date"""
+  createdAt: DateTime!
+
+  """Photo description"""
+  description: String
+
+  """Photo ID"""
+  id: ID!
+
+  """Photo URL"""
+  url: String!
+}
+
+"""Result of return query"""
+type ReturnPayload {
+  """Return data"""
+  return: Return
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Reason for returning an item"""
+enum ReturnReason {
+  BETTER_PRICE
+  CHANGED_MIND
+  DAMAGED_SHIPPING
+  DEFECTIVE
+  NOT_AS_DESCRIBED
+  OTHER
+  WRONG_ITEM
+}
+
+"""Return reason option for UI"""
+type ReturnReasonOption {
+  """Description/help text"""
+  description: String
+
+  """Human-readable label"""
+  label: String!
+
+  """Reason enum value"""
+  value: ReturnReason!
+}
+
+"""Return shipping label"""
+type ReturnShippingLabel {
+  """Carrier for the return shipment"""
+  carrier: String
+
+  """When the label expires"""
+  expiresAt: DateTime
+
+  """Tracking number for the return"""
+  trackingNumber: String
+
+  """URL to download the shipping label"""
+  url: String!
+}
+
+"""Status of a return request"""
+enum ReturnStatus {
+  APPROVED
+  CANCELLED
+  COMPLETED
+  DRAFT
+  EXCHANGED
+  EXPIRED
+  FAILED
+  INSPECTING
+  IN_TRANSIT
+  LABEL_GENERATED
+  RECEIVED
+  REFUNDED
+  REFUND_PENDING
+  REJECTED
+  REPLACED
+  REQUESTED
+}
+
+"""Input for creating a review"""
+input ReviewCreateInput {
+  authorEmail: String
+  authorName: String!
+  cons: [String!]
+  content: String!
+  images: [String!]
+
+  """Order ID for verified purchase"""
+  orderId: ID
+  productId: ID!
+  pros: [String!]
+  rating: Int!
+  title: String
+}
+
+"""Review mutation payload"""
+type ReviewPayload {
+  review: ProductReview
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+enum ReviewSortKey {
+  CREATED_AT
+  HELPFUL_COUNT
+  RATING
+}
+
+"""Product review statistics"""
+type ReviewStats {
+  """Average rating"""
+  averageRating: Float!
+
+  """5-star count"""
+  fiveStarCount: Int!
+
+  """4-star count"""
+  fourStarCount: Int!
+
+  """1-star count"""
+  oneStarCount: Int!
+
+  """3-star count"""
+  threeStarCount: Int!
+
+  """Total reviews"""
+  totalCount: Int!
+
+  """2-star count"""
+  twoStarCount: Int!
+}
+
+"""SEO metadata"""
+type SEO {
+  """SEO description"""
+  description: String
+
+  """SEO title"""
+  title: String
+}
+
+"""Selected product option"""
+type SelectedOption {
+  """Option name (e.g., "Size", "Color")"""
+  name: String!
+
+  """Option value (e.g., "Large", "Red")"""
+  value: String!
+}
+
+"""Order shipment with tracking information"""
+type Shipment {
+  """Creation date"""
+  createdAt: DateTime!
+
+  """When the shipment was delivered"""
+  deliveredAt: DateTime
+
+  """Estimated delivery date"""
+  estimatedDeliveryDate: DateTime
+
+  """Tracking events timeline"""
+  events: [ShipmentEvent!]
+
+  """Unique identifier"""
+  id: ID!
+
+  """Items included in this shipment"""
+  items: [ShipmentItem!]
+
+  """Shipping label download URL"""
+  labelUrl: String
+
+  """Order ID this shipment belongs to"""
+  orderId: ID!
+
+  """Package dimensions"""
+  packages: [ShipmentPackage!]
+
+  """Shipping provider (e.g., INPOST, DPD, UPS)"""
+  provider: String!
+
+  """Recipient address"""
+  recipientAddress: MailingAddress
+
+  """Provider service code"""
+  serviceCode: String
+
+  """When the shipment was shipped"""
+  shippedAt: DateTime
+
+  """Current shipment status"""
+  status: ShipmentStatus!
+
+  """Tracking number"""
+  trackingNumber: String
+
+  """External tracking URL"""
+  trackingUrl: String
+
+  """Last update date"""
+  updatedAt: DateTime!
+}
+
+"""Shipment edge for pagination"""
+type ShipmentEdge {
+  """Cursor"""
+  cursor: String!
+
+  """Shipment node"""
+  node: Shipment!
+}
+
+"""Shipment tracking event"""
+type ShipmentEvent {
+  """Human-readable description"""
+  description: String
+
+  """Event ID"""
+  id: ID!
+
+  """Location where event occurred"""
+  location: String
+
+  """When the event occurred"""
+  occurredAt: DateTime!
+
+  """Provider-specific event code"""
+  providerEventCode: String
+
+  """Status at this event"""
+  status: ShipmentStatus!
+}
+
+"""Item included in a shipment"""
+type ShipmentItem {
+  """Item ID"""
+  id: ID!
+
+  """Product image URL"""
+  imageUrl: String
+
+  """Quantity shipped"""
+  quantity: Int!
+
+  """Product SKU"""
+  sku: String
+
+  """Product title"""
+  title: String!
+
+  """Variant title"""
+  variantTitle: String
+}
+
+"""Package dimensions and weight"""
+type ShipmentPackage {
+  """Package height in cm"""
+  height: Float
+
+  """Package length in cm"""
+  length: Float
+
+  """Package weight in kg"""
+  weight: Float
+
+  """Package width in cm"""
+  width: Float
+}
+
+"""Result of shipment query"""
+type ShipmentPayload {
+  """Shipment data"""
+  shipment: Shipment
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
+"""Status of a shipment"""
+enum ShipmentStatus {
+  CANCELLED
+  CREATED
+  DELIVERED
+  EXCEPTION
+  IN_TRANSIT
+  LABEL_PRINTED
+  OUT_FOR_DELIVERY
+  PICKED_UP
+  RETURNED
+}
+
+"""Address input for shipping calculation"""
+input ShippingAddressInput {
+  """Street address line 1"""
+  address1: String
+
+  """City"""
+  city: String
+
+  """Country code (ISO 3166-1 alpha-2)"""
+  country: String!
+
+  """Email address"""
+  email: String
+
+  """First name"""
+  firstName: String
+
+  """Last name"""
+  lastName: String
+
+  """Phone number"""
+  phone: String
+
+  """Postal/ZIP code"""
+  postalCode: String
+
+  """Province/State/Region"""
+  province: String
+}
+
+"""Shipping carrier information"""
+type ShippingCarrier {
+  """Carrier provider ID"""
+  id: ID
+
+  """Carrier logo URL"""
+  logoUrl: String
+
+  """Carrier name (e.g., InPost, DPD, DHL)"""
+  name: String!
+
+  """Service code"""
+  serviceCode: String
+}
+
+"""Available shipping rate"""
+type ShippingRate {
+  """Shipping rate ID"""
+  handle: ID!
+
+  """Shipping price"""
+  price: Money!
+
+  """Shipping rate title"""
+  title: String!
+}
+
+"""Shop information"""
+type Shop {
+  """Shop physical address"""
+  address: ShopAddress
+
+  """Bot protection configuration (platform-level)"""
+  botProtection: BotProtectionInfo
+
+  """Complete branding configuration"""
+  branding: ShopBranding
+
+  """Business operating hours"""
+  businessHours: [BusinessHour!]
+
+  """Contact email address"""
+  contactEmail: String
+
+  """Contact phone number"""
+  contactPhone: String
+
+  """Default currency code (ISO 4217)"""
+  currencyCode: String!
+
+  """Default language code"""
+  defaultLanguage: String
+
+  """Shop description"""
+  description: String
+
+  """Shop unique identifier"""
+  id: ID!
+
+  """Locale to currency mapping for auto-detection (SSOT)"""
+  localeToCurrencyMap: [LocaleCurrencyMapping!]!
+
+  """Shop logo"""
+  logo: Image
+
+  """Shop name"""
+  name: String!
+
+  """Supported payment currencies"""
+  paymentCurrencies: [String!]!
+
+  """Primary domain URL"""
+  primaryDomain: String
+
+  """Supported currencies for price display"""
+  supportedCurrencies: [String!]!
+
+  """Supported languages"""
+  supportedLanguages: [String!]
+
+  """Shop timezone"""
+  timezone: String
+}
+
+"""Shop physical address"""
+type ShopAddress {
+  """Street address line 1"""
+  address1: String
+
+  """Street address line 2"""
+  address2: String
+
+  """City"""
+  city: String
+
+  """Country code (ISO 3166-1 alpha-2)"""
+  country: String
+
+  """Postal/ZIP code"""
+  postalCode: String
+
+  """State/Province"""
+  state: String
+}
+
+"""Shop branding configuration"""
+type ShopBranding {
+  """Brand colors"""
+  colors: ShopColors
+
+  """Shop favicon"""
+  favicon: Image
+
+  """Typography configuration"""
+  fonts: ShopFonts
+
+  """Shop logo"""
+  logo: Image
+
+  """Social media links"""
+  socialLinks: SocialLinks
+}
+
+"""Shop brand colors"""
+type ShopColors {
+  """Accent color (hex)"""
+  accent: String
+
+  """Background color (hex)"""
+  background: String
+
+  """Primary brand color (hex)"""
+  primary: String
+
+  """Secondary brand color (hex)"""
+  secondary: String
+
+  """Text color (hex)"""
+  text: String
+}
+
+"""Shop currency configuration"""
+type ShopCurrencyConfig {
+  """Whether prices auto-convert to customer currency"""
+  autoConvertPrices: Boolean!
+
+  """Primary currency for the shop"""
+  primaryCurrency: String!
+
+  """List of currencies available in storefront"""
+  supportedCurrencies: [String!]!
+}
+
+"""Shop typography configuration"""
+type ShopFonts {
+  """Secondary/heading font family"""
+  heading: String
+
+  """Primary font family"""
+  primary: String
+}
+
+"""Shop social media links"""
+type SocialLinks {
+  """Facebook page URL"""
+  facebook: String
+
+  """Instagram profile URL"""
+  instagram: String
+
+  """LinkedIn page URL"""
+  linkedin: String
+
+  """Pinterest profile URL"""
+  pinterest: String
+
+  """TikTok profile URL"""
+  tiktok: String
+
+  """Twitter/X profile URL"""
+  twitter: String
+
+  """YouTube channel URL"""
+  youtube: String
+}
+
+"""Lifecycle status of an order"""
+enum StorefrontOrderStatus {
+  CANCELLED
+  COMPLETED
+  CONFIRMED
+  DRAFT
+  EXPIRED
+  ON_HOLD
+  PENDING
+  PROCESSING
+}
+
+"""Tax line item"""
+type TaxLine {
+  """Tax amount"""
+  price: Money!
+
+  """Tax rate as decimal (e.g., 0.23 for 23%)"""
+  rate: Float!
+
+  """Tax name"""
+  title: String!
+}
+
+"""Custom tier benefit"""
+type TierBenefit {
+  """Benefit description"""
+  description: String
+
+  """Benefit icon"""
+  icon: String
+
+  """Benefit name"""
+  name: String!
+}
+
+"""Progress towards next tier"""
+type TierProgress {
+  """Current tier"""
+  currentTier: LoyaltyTier!
+
+  """Next tier (null if at max)"""
+  nextTier: LoyaltyTier
+
+  """Points needed for next tier"""
+  pointsToNextTier: Int!
+
+  """Progress percentage (0-100)"""
+  progressPercent: Float!
+
+  """Spend needed for next tier"""
+  spendToNextTier: Money
+}
+
+"""Single translation entry"""
+type TranslationEntry {
+  """Translation key"""
+  key: String!
+
+  """Translated value"""
+  value: String!
+}
+
+"""Translation namespace (e.g., common, product, checkout)"""
+type TranslationNamespace {
+  """Translations in this namespace"""
+  entries: [TranslationEntry!]!
+
+  """Namespace identifier"""
+  namespace: String!
+}
+
+"""Complete translation set for a language"""
+type Translations {
+  """Language code (ISO 639-1)"""
+  language: String!
+
+  """Namespaces with translations"""
+  namespaces: [TranslationNamespace!]!
+}
+
+"""Input for fetching translations"""
+input TranslationsInput {
+  """Language code (ISO 639-1)"""
+  language: String!
+
+  """Namespaces to fetch (null = all)"""
+  namespaces: [String!]
+}
+
+"""User-facing error from mutations"""
+type UserError {
+  """Error code"""
+  code: String
+
+  """Path to field that caused error"""
+  field: [String!]
+
+  """Error message"""
+  message: String!
+}
+
+"""Customer wishlist"""
+type Wishlist {
+  """Created date"""
+  createdAt: DateTime!
+  id: ID!
+
+  """Is publicly shareable"""
+  isPublic: Boolean!
+
+  """Total items count"""
+  itemCount: Int!
+
+  """Wishlist items"""
+  items: [WishlistItem!]!
+
+  """Wishlist name"""
+  name: String!
+
+  """Share URL token"""
+  shareToken: String
+
+  """Updated date"""
+  updatedAt: DateTime!
+}
+
+"""Input for creating a wishlist"""
+input WishlistCreateInput {
+  isPublic: Boolean = false
+  name: String = "My Wishlist"
+}
+
+"""Wishlist item"""
+type WishlistItem {
+  """Date added"""
+  addedAt: DateTime!
+  id: ID!
+
+  """Notify on restock"""
+  notifyOnRestock: Boolean!
+
+  """Notify on sale"""
+  notifyOnSale: Boolean!
+
+  """Price when added to wishlist"""
+  priceAtAdd: Money!
+
+  """Product details"""
+  product: Product
+  productId: ID!
+
+  """Variant details"""
+  variant: ProductVariant
+  variantId: ID
+}
+
+"""Input for adding item to wishlist"""
+input WishlistItemInput {
+  notifyOnRestock: Boolean = false
+  notifyOnSale: Boolean = false
+  productId: ID!
+  variantId: ID
+}
+
+"""Wishlist mutation payload"""
+type WishlistPayload {
+  """User errors"""
+  userErrors: [String!]!
+  wishlist: Wishlist
+}