@doswiftly/storefront-operations 5.5.0 → 6.0.0

package/fragments.graphql

@@ -20,6 +20,12 @@ fragment UserError on UserError {
   field
 }
 
+fragment CartWarning on CartWarning {
+  message
+  code
+  target
+}
+
 # Base Image — no transform (for logos, favicons, branding assets that are already small)
 fragment Image on Image {
   id
@@ -97,19 +103,13 @@ fragment ProductVariant on ProductVariant {
   title
   sku
   price {
-    ...PriceMoney
-  }
-  originalPrice {
     ...Money
   }
   compareAtPrice {
-    ...PriceMoney
-  }
-  originalCompareAtPrice {
     ...Money
   }
-  available
-  quantityAvailable
+  isAvailable
+  availableStock
   image {
     ...ImageThumbnail
   }
@@ -117,8 +117,11 @@ fragment ProductVariant on ProductVariant {
     ...SelectedOption
   }
   barcode
-  weight
-  position
+  weight {
+    value
+    unit
+  }
+  sortOrder
 }
 
 # Minimal product data for listing views (cards, grids, search results).
@@ -128,8 +131,8 @@ fragment ProductCard on Product {
   handle
   title
   vendor
-  productType
-  availableForSale
+  category
+  isAvailable
   averageRating
   reviewCount
   tags
@@ -138,18 +141,18 @@ fragment ProductCard on Product {
   }
   priceRange {
     minVariantPrice {
-      ...Price
+      ...Money
     }
     maxVariantPrice {
-      ...Price
+      ...Money
     }
   }
   compareAtPriceRange {
     minVariantPrice {
-      ...Price
+      ...Money
     }
     maxVariantPrice {
-      ...Price
+      ...Money
     }
   }
 }
@@ -159,25 +162,9 @@ fragment ProductBase on Product {
   ...ProductCard
   description
   descriptionHtml
-  originalPriceRange {
-    minVariantPrice {
-      ...Money
-    }
-    maxVariantPrice {
-      ...Money
-    }
-  }
-  originalCompareAtPriceRange {
-    minVariantPrice {
-      ...Money
-    }
-    maxVariantPrice {
-      ...Money
-    }
-  }
-  totalInventory
+  stockTotal
   type
-  collectRecipientInfo
+  requiresRecipientInfo
   # Faza 1.5 (Decision D-A v3 + D-B)
   visibility
   attributeSetId
@@ -188,10 +175,34 @@ fragment ProductBase on Product {
 fragment ProductFull on Product {
   ...ProductBase
   images(first: 20) {
-    ...ImageFull
+    edges {
+      cursor
+      node {
+        ...ImageFull
+      }
+    }
+    nodes {
+      ...ImageFull
+    }
+    pageInfo {
+      ...PageInfo
+    }
+    totalCount
   }
   variants(first: 100) {
-    ...ProductVariant
+    edges {
+      cursor
+      node {
+        ...ProductVariant
+      }
+    }
+    nodes {
+      ...ProductVariant
+    }
+    pageInfo {
+      ...PageInfo
+    }
+    totalCount
   }
   seo {
     title
@@ -244,8 +255,8 @@ fragment Category on Category {
 
 fragment MailingAddress on MailingAddress {
   id
-  address1
-  address2
+  streetLine1
+  streetLine2
   city
   company
   country
@@ -253,9 +264,9 @@ fragment MailingAddress on MailingAddress {
   firstName
   lastName
   phone
-  province
-  provinceCode
-  zip
+  state
+  stateCode
+  postalCode
   isDefault
 }
 
@@ -271,12 +282,13 @@ fragment Customer on Customer {
   lastName
   displayName
   phone
-  emailVerified
-  emailMarketingState
+  isEmailVerified
+  emailMarketing
+  tags
   defaultAddress {
     ...MailingAddress
   }
-  ordersCount
+  orderCount
   totalSpent {
     ...Money
   }
@@ -287,20 +299,22 @@ fragment Customer on Customer {
 fragment Order on Order {
   id
   orderNumber
-  totalPrice {
-    ...Money
-  }
-  subtotalPrice {
-    ...Money
-  }
-  totalTax {
-    ...Money
-  }
-  totalShipping {
-    ...Money
+  totals {
+    total {
+      ...Money
+    }
+    subtotal {
+      ...Money
+    }
+    totalTax {
+      ...Money
+    }
+    totalShipping {
+      ...Money
+    }
   }
   status
-  financialStatus
+  paymentStatus
   fulfillmentStatus
   processedAt
   confirmedAt
@@ -309,7 +323,7 @@ fragment Order on Order {
   shippingAddress {
     ...MailingAddress
   }
-  lineItemsCount
+  itemCount
 }
 
 # ============================================
@@ -317,37 +331,40 @@ fragment Order on Order {
 # ============================================
 
 fragment CartCost on CartCost {
-  totalAmount {
-    ...PriceMoney
+  total {
+    ...Money
+  }
+  subtotal {
+    ...Money
   }
-  subtotalAmount {
-    ...PriceMoney
+  totalTax {
+    ...Money
   }
-  totalTaxAmount {
-    ...PriceMoney
+  totalDuty {
+    ...Money
   }
-  totalDutyAmount {
-    ...PriceMoney
+  checkoutCharge {
+    ...Money
   }
 }
 
 fragment CartLineCost on CartLineCost {
-  amountPerQuantity {
-    ...PriceMoney
+  pricePerUnit {
+    ...Money
   }
-  subtotalAmount {
-    ...PriceMoney
+  subtotal {
+    ...Money
   }
-  totalAmount {
-    ...PriceMoney
+  total {
+    ...Money
   }
-  compareAtAmountPerQuantity {
-    ...PriceMoney
+  compareAtPricePerUnit {
+    ...Money
   }
 }
 
 # Typed customer-filled attribute snapshot (Faza 1 R5 + Decision D-A v3 + D-I).
-# Distinct from CartLine.attributes (Shopify raw KV line item properties).
+# Distinct from CartLine.attributes (raw KV line item properties).
 fragment AttributeSelection on AttributeSelection {
   attributeDefinitionId
   attributeName
@@ -367,7 +384,7 @@ fragment AttributeSelection on AttributeSelection {
 fragment CartLine on CartLine {
   id
   quantity
-  merchandise {
+  variant {
     ...ProductVariant
   }
   cost {
@@ -394,7 +411,7 @@ fragment CartBuyerIdentity on CartBuyerIdentity {
 
 fragment CartDiscountCode on CartDiscountCode {
   code
-  applicable
+  isApplicable
 }
 
 fragment CartDiscountAllocation on CartDiscountAllocation {
@@ -412,7 +429,23 @@ fragment Cart on Cart {
     ...CartCost
   }
   lines(first: 100) {
-    ...CartLine
+    edges {
+      cursor
+      node {
+        ... on CartLine {
+          ...CartLine
+        }
+      }
+    }
+    nodes {
+      ... on CartLine {
+        ...CartLine
+      }
+    }
+    pageInfo {
+      ...PageInfo
+    }
+    totalCount
   }
   buyerIdentity {
     ...CartBuyerIdentity
@@ -460,8 +493,8 @@ fragment SocialLinks on SocialLinks {
 }
 
 fragment ShopAddress on ShopAddress {
-  address1
-  address2
+  streetLine1
+  streetLine2
   city
   state
   postalCode
@@ -513,7 +546,11 @@ fragment Shop on Shop {
   id
   name
   description
-  primaryDomain
+  primaryDomain {
+    host
+    url
+    isSslEnabled
+  }
   currencyCode
   supportedCurrencies
   paymentCurrencies
@@ -567,12 +604,6 @@ fragment AvailablePaymentMethods on AvailablePaymentMethods {
 # Checkout Fragments
 # ============================================
 
-fragment CheckoutUserError on CheckoutUserError {
-  field
-  message
-  code
-}
-
 fragment ShippingRate on ShippingRate {
   handle
   title
@@ -608,7 +639,7 @@ fragment DiscountAffectedItem on DiscountAffectedItem {
 
 fragment DiscountApplication on DiscountApplication {
   code
-  applicable
+  isApplicable
   type
   value {
     ...Money
@@ -625,7 +656,7 @@ fragment DiscountApplication on DiscountApplication {
 
 fragment DiscountCode on DiscountCode {
   code
-  applicable
+  isApplicable
 }
 
 fragment CheckoutLineItem on CheckoutLineItem {
@@ -633,10 +664,10 @@ fragment CheckoutLineItem on CheckoutLineItem {
   title
   variantTitle
   quantity
-  unitPrice {
+  pricePerUnit {
     ...Money
   }
-  totalPrice {
+  total {
     ...Money
   }
   variantId
@@ -661,8 +692,8 @@ fragment AppliedGiftCard on AppliedGiftCard {
 
 fragment Checkout on Checkout {
   id
-  ready
-  completed
+  isReady
+  isCompleted
   completedOrderId
   webUrl
   lineItems {
@@ -695,24 +726,16 @@ fragment Checkout on Checkout {
     ...PaymentMethod
   }
   selectedPaymentMethodId
-  subtotalPrice {
-    ...Money
-  }
-  totalShippingPrice {
-    ...Money
-  }
-  totalTax {
-    ...Money
+  cost {
+    subtotal { ...Money }
+    total { ...Money }
+    totalTax { ...Money }
+    totalShipping { ...Money }
+    totalDiscounts { ...Money }
   }
   taxLines {
     ...TaxLine
   }
-  totalDiscounts {
-    ...Money
-  }
-  totalPrice {
-    ...Money
-  }
   # GAP-001: Gift Card Checkout Integration
   appliedGiftCards {
     ...AppliedGiftCard
@@ -767,7 +790,7 @@ fragment Shipment on Shipment {
   trackingUrl
   labelUrl
   status
-  estimatedDeliveryDate
+  estimatedDeliveryAt
   shippedAt
   deliveredAt
   recipientAddress {
@@ -793,7 +816,7 @@ fragment ShipmentBasic on Shipment {
   trackingNumber
   trackingUrl
   status
-  estimatedDeliveryDate
+  estimatedDeliveryAt
   shippedAt
   deliveredAt
   createdAt
@@ -875,23 +898,9 @@ fragment ReturnReasonOption on ReturnReasonOption {
 # Gift Card Fragments (R32 - Gift Cards)
 # ============================================
 
-fragment GiftCardTransaction on GiftCardTransaction {
-  id
-  type
-  amount {
-    ...Money
-  }
-  balanceAfter {
-    ...Money
-  }
-  orderId
-  createdAt
-}
-
 fragment GiftCard on GiftCard {
   id
   maskedCode
-  lastCharacters
   status
   initialAmount {
     ...Money
@@ -902,9 +911,6 @@ fragment GiftCard on GiftCard {
   expiresAt
   recipientName
   message
-  transactions {
-    ...GiftCardTransaction
-  }
   createdAt
 }
 
@@ -914,7 +920,7 @@ fragment GiftCardError on GiftCardError {
 }
 
 fragment GiftCardValidation on GiftCardValidation {
-  valid
+  isValid
   availableBalance {
     ...Money
   }
@@ -1150,11 +1156,11 @@ fragment LoyaltyReward on LoyaltyReward {
   image {
     ...ImageCard
   }
-  available
+  isAvailable
   tierRequired {
     ...LoyaltyTier
   }
-  remainingRedemptions
+  redemptionsRemaining
 }
 
 fragment PointsEstimate on PointsEstimate {
@@ -1166,12 +1172,12 @@ fragment PointsEstimate on PointsEstimate {
 
 fragment LoyaltyAction on LoyaltyAction {
   type
-  enabled
+  isEnabled
   points
 }
 
 fragment LoyaltySettings on LoyaltySettings {
-  enabled
+  isEnabled
   pointsName
   pointsPerCurrency
   pointsExpiryMonths
@@ -1224,6 +1230,7 @@ fragment ProductReview on ProductReview {
   authorName
   isVerifiedPurchase
   helpfulCount
+  unhelpfulCount
   response
   responseAt
   createdAt
@@ -1250,7 +1257,7 @@ fragment WishlistItem on WishlistItem {
   product {
     ...ProductCard
   }
-  priceAtAdd {
+  priceWhenAdded {
     ...Money
   }
   notifyOnSale
@@ -1296,7 +1303,7 @@ fragment BlogPost on BlogPost {
   slug
   excerpt
   content
-  contentType
+  contentFormat
   featuredImage {
     ...ImageCard
   }
@@ -1315,7 +1322,7 @@ fragment BlogPost on BlogPost {
     ...BlogTag
   }
   publishedAt
-  readingTime
+  readingTimeMinutes
   viewCount
   commentCount
   allowComments
@@ -1362,23 +1369,23 @@ fragment CartRecommendation on CartRecommendations {
 }
 
 # ============================================
-# Store Availability Fragments (Shopify parity — BOPIS / multi-location)
+# Store Availability Fragments (BOPIS / multi-location)
 # ============================================
 # Field access:
 # - `available: Boolean!` — always public.
-# - `pickUpTime: String` — public, localized merchant-configured string.
+# - `pickupTime: String` — public, localized merchant-configured string.
 # - `quantityAvailable: Int` — TOKEN-GATED (null for anonymous, Int for authenticated).
 # - `location: Location!` — public, includes coords + businessHours when configured.
 
 fragment LocationAddress on LocationAddress {
-  address1
-  address2
+  streetLine1
+  streetLine2
   city
   country
   countryCode
-  province
-  provinceCode
-  zip
+  state
+  stateCode
+  postalCode
   phone
   latitude
   longitude
@@ -1404,7 +1411,7 @@ fragment Location on Location {
   id
   name
   type
-  pickupEnabled
+  supportsPickup
   timezone
   pickupInstructions
   address {
@@ -1416,9 +1423,9 @@ fragment Location on Location {
 }
 
 fragment StoreAvailability on StoreAvailability {
-  available
-  quantityAvailable
-  pickUpTime
+  isAvailable
+  availableStock
+  pickupTime
   location {
     ...Location
   }
@@ -1441,8 +1448,8 @@ fragment VariantStoreAvailability on ProductVariant {
   id
   title
   sku
-  available
-  quantityAvailable
+  isAvailable
+  availableStock
   storeAvailability(first: 10) {
     ...StoreAvailabilityConnection
   }
@@ -1457,7 +1464,7 @@ fragment ShopPage on ShopPage {
   handle
   title
   body
-  bodySummary
+  excerpt
   seo {
     title
     description
@@ -1500,7 +1507,6 @@ fragment Menu on Menu {
   id
   handle
   title
-  itemsCount
   items {
     ...MenuItem
   }
@@ -1518,7 +1524,7 @@ fragment UrlRedirect on UrlRedirect {
 # ============================================
 # Unified Product Configurator (Faza 1 + Faza 1.5 — Decision D-A v3 + D-I)
 # ============================================
-# Hybrid Magento binding:
+# Hybrid AttributeSet binding:
 #   - Product.attributes returns UNION of set definitions (via Product.attributeSetId)
 #     and per-product scoped definitions (AttributeDefinition.scopeProductId = product.id)
 #   - CUSTOMER fillingMode → rendered in storefront configurator UX
@@ -1530,7 +1536,7 @@ fragment LinkedVariantSummary on LinkedVariantSummary {
   productId
   title
   sku
-  quantityAvailable
+  availableStock
   isAvailable
   trackQuantity
 }