@doswiftly/storefront-operations 1.0.5

package/fragments.graphql

@@ -0,0 +1,1152 @@
+# ============================================
+# DoSwiftly Storefront API - Fragments
+# SSOT: Backend defines all reusable fragments
+# ============================================
+
+# ============================================
+# Common Fragments
+# ============================================
+
+fragment PageInfo on PageInfo {
+  hasNextPage
+  hasPreviousPage
+  startCursor
+  endCursor
+}
+
+fragment UserError on UserError {
+  message
+  code
+  field
+}
+
+fragment Image on Image {
+  id
+  url
+  altText
+  width
+  height
+}
+
+# Simple money (for originalPrice fields and non-converted prices)
+fragment Money on Money {
+  amount
+  currencyCode
+}
+
+# Full price with conversion transparency (for price fields that support currency conversion)
+fragment PriceMoney on PriceMoney {
+  amount
+  currencyCode
+  baseAmount
+  baseCurrencyCode
+  exchangeRate
+  marginApplied
+  rateTimestamp
+  isConverted
+}
+
+fragment SelectedOption on SelectedOption {
+  name
+  value
+}
+
+# ============================================
+# Product Fragments
+# ============================================
+
+fragment ProductVariant on ProductVariant {
+  id
+  title
+  sku
+  price {
+    ...PriceMoney
+  }
+  originalPrice {
+    ...Money
+  }
+  compareAtPrice {
+    ...PriceMoney
+  }
+  originalCompareAtPrice {
+    ...Money
+  }
+  available
+  quantityAvailable
+  image {
+    ...Image
+  }
+  selectedOptions {
+    ...SelectedOption
+  }
+  barcode
+  weight
+  position
+}
+
+fragment ProductBase on Product {
+  id
+  handle
+  title
+  description
+  descriptionHtml
+  featuredImage {
+    ...Image
+  }
+  priceRange {
+    minVariantPrice {
+      ...PriceMoney
+    }
+    maxVariantPrice {
+      ...PriceMoney
+    }
+  }
+  originalPriceRange {
+    minVariantPrice {
+      ...Money
+    }
+    maxVariantPrice {
+      ...Money
+    }
+  }
+  compareAtPriceRange {
+    minVariantPrice {
+      ...PriceMoney
+    }
+    maxVariantPrice {
+      ...PriceMoney
+    }
+  }
+  originalCompareAtPriceRange {
+    minVariantPrice {
+      ...Money
+    }
+    maxVariantPrice {
+      ...Money
+    }
+  }
+  totalInventory
+  vendor
+  productType
+  type
+  collectRecipientInfo
+  tags
+  createdAt
+  updatedAt
+  averageRating
+  reviewCount
+  availableForSale
+}
+
+fragment ProductFull on Product {
+  ...ProductBase
+  images(first: 20) {
+    ...Image
+  }
+  variants(first: 100) {
+    ...ProductVariant
+  }
+  seo {
+    title
+    description
+  }
+}
+
+# ============================================
+# Collection Fragments
+# ============================================
+
+fragment Collection on Collection {
+  id
+  handle
+  title
+  description
+  descriptionHtml
+  image {
+    ...Image
+  }
+  seo {
+    title
+    description
+  }
+  createdAt
+  updatedAt
+}
+
+# ============================================
+# Category Fragments
+# ============================================
+
+fragment Category on Category {
+  id
+  name
+  slug
+  description
+  image {
+    ...Image
+  }
+  level
+  path
+  productCount
+  sortOrder
+}
+
+# ============================================
+# Customer Fragments
+# ============================================
+
+fragment MailingAddress on MailingAddress {
+  id
+  address1
+  address2
+  city
+  company
+  country
+  countryCode
+  firstName
+  lastName
+  phone
+  province
+  provinceCode
+  zip
+  isDefault
+}
+
+fragment CustomerAccessToken on CustomerAccessToken {
+  accessToken
+  expiresAt
+}
+
+fragment Customer on Customer {
+  id
+  email
+  firstName
+  lastName
+  displayName
+  phone
+  emailVerified
+  acceptsMarketing
+  defaultAddress {
+    ...MailingAddress
+  }
+  ordersCount
+  totalSpent {
+    ...Money
+  }
+  createdAt
+  updatedAt
+}
+
+fragment Order on Order {
+  id
+  orderNumber
+  totalPrice {
+    ...Money
+  }
+  subtotalPrice {
+    ...Money
+  }
+  totalTax {
+    ...Money
+  }
+  totalShipping {
+    ...Money
+  }
+  financialStatus
+  fulfillmentStatus
+  processedAt
+  shippingAddress {
+    ...MailingAddress
+  }
+  lineItemsCount
+}
+
+# Order with shipments for tracking pages
+fragment OrderWithShipments on Order {
+  id
+  orderNumber
+  totalPrice {
+    ...Money
+  }
+  subtotalPrice {
+    ...Money
+  }
+  totalTax {
+    ...Money
+  }
+  totalShipping {
+    ...Money
+  }
+  financialStatus
+  fulfillmentStatus
+  processedAt
+  shippingAddress {
+    ...MailingAddress
+  }
+  lineItemsCount
+  shipments {
+    ...Shipment
+  }
+}
+
+# ============================================
+# Cart Fragments
+# ============================================
+
+fragment CartCost on CartCost {
+  totalAmount {
+    ...PriceMoney
+  }
+  subtotalAmount {
+    ...PriceMoney
+  }
+  totalTaxAmount {
+    ...PriceMoney
+  }
+  totalDutyAmount {
+    ...PriceMoney
+  }
+}
+
+fragment CartLineCost on CartLineCost {
+  amountPerQuantity {
+    ...PriceMoney
+  }
+  subtotalAmount {
+    ...PriceMoney
+  }
+  totalAmount {
+    ...PriceMoney
+  }
+  compareAtAmountPerQuantity {
+    ...PriceMoney
+  }
+}
+
+fragment CartLine on CartLine {
+  id
+  quantity
+  merchandise {
+    ...ProductVariant
+  }
+  cost {
+    ...CartLineCost
+  }
+  attributes {
+    key
+    value
+  }
+  productId
+  productTitle
+  productHandle
+  productType
+}
+
+fragment CartBuyerIdentity on CartBuyerIdentity {
+  email
+  phone
+  countryCode
+}
+
+fragment CartDiscountCode on CartDiscountCode {
+  code
+  applicable
+}
+
+fragment CartDiscountAllocation on CartDiscountAllocation {
+  discountCode
+  amount {
+    ...Money
+  }
+}
+
+fragment Cart on Cart {
+  id
+  checkoutUrl
+  totalQuantity
+  cost {
+    ...CartCost
+  }
+  lines(first: 100) {
+    ...CartLine
+  }
+  buyerIdentity {
+    ...CartBuyerIdentity
+  }
+  discountCodes {
+    ...CartDiscountCode
+  }
+  discountAllocations {
+    ...CartDiscountAllocation
+  }
+  note
+  attributes {
+    key
+    value
+  }
+  createdAt
+  updatedAt
+}
+
+# ============================================
+# Shop Fragments
+# ============================================
+
+fragment ShopColors on ShopColors {
+  primary
+  secondary
+  accent
+  background
+  text
+}
+
+fragment ShopFonts on ShopFonts {
+  primary
+  heading
+}
+
+fragment SocialLinks on SocialLinks {
+  facebook
+  instagram
+  twitter
+  youtube
+  tiktok
+  linkedin
+  pinterest
+}
+
+fragment ShopAddress on ShopAddress {
+  address1
+  address2
+  city
+  state
+  postalCode
+  country
+}
+
+fragment BusinessHour on BusinessHour {
+  day
+  openTime
+  closeTime
+  isClosed
+}
+
+fragment ShopBranding on ShopBranding {
+  logo {
+    ...Image
+  }
+  favicon {
+    ...Image
+  }
+  colors {
+    ...ShopColors
+  }
+  fonts {
+    ...ShopFonts
+  }
+  socialLinks {
+    ...SocialLinks
+  }
+}
+
+fragment Shop on Shop {
+  id
+  name
+  description
+  primaryDomain
+  currencyCode
+  supportedCurrencies
+  paymentCurrencies
+  logo {
+    ...Image
+  }
+  contactEmail
+  contactPhone
+  address {
+    ...ShopAddress
+  }
+  businessHours {
+    ...BusinessHour
+  }
+  branding {
+    ...ShopBranding
+  }
+}
+
+# ============================================
+# Payment Method Fragments (R23 - Payment Methods)
+# ============================================
+
+fragment PaymentMethod on PaymentMethod {
+  id
+  name
+  provider
+  type
+  icon
+  description
+  isDefault
+  supportedCurrencies
+  position
+}
+
+fragment AvailablePaymentMethods on AvailablePaymentMethods {
+  methods {
+    ...PaymentMethod
+  }
+  defaultMethod {
+    ...PaymentMethod
+  }
+}
+
+# ============================================
+# Checkout Fragments
+# ============================================
+
+fragment CheckoutUserError on CheckoutUserError {
+  field
+  message
+  code
+}
+
+fragment ShippingRate on ShippingRate {
+  handle
+  title
+  price {
+    ...Money
+  }
+}
+
+fragment TaxLine on TaxLine {
+  title
+  rate
+  price {
+    ...Money
+  }
+}
+
+fragment DiscountAffectedItem on DiscountAffectedItem {
+  productId
+  variantId
+  title
+  quantity
+  originalPrice {
+    ...Money
+  }
+  discountedPrice {
+    ...Money
+  }
+  savings {
+    ...Money
+  }
+  isFreeItem
+}
+
+fragment DiscountApplication on DiscountApplication {
+  code
+  applicable
+  type
+  value {
+    ...Money
+  }
+  title
+  # BXGY (Buy X Get Y) specific fields
+  affectedItems {
+    ...DiscountAffectedItem
+  }
+  buyQuantity
+  getQuantity
+  getDiscountPercent
+}
+
+fragment DiscountCode on DiscountCode {
+  code
+  applicable
+}
+
+fragment CheckoutLineItem on CheckoutLineItem {
+  id
+  title
+  variantTitle
+  quantity
+  unitPrice {
+    ...Money
+  }
+  totalPrice {
+    ...Money
+  }
+  variantId
+  productId
+  sku
+}
+
+# GAP-001: Gift Card Checkout Integration
+fragment AppliedGiftCard on AppliedGiftCard {
+  maskedCode
+  lastCharacters
+  appliedAmount {
+    ...Money
+  }
+  remainingBalance {
+    ...Money
+  }
+}
+
+fragment Checkout on Checkout {
+  id
+  ready
+  completed
+  completedOrderId
+  webUrl
+  lineItems {
+    ...CheckoutLineItem
+  }
+  totalQuantity
+  shippingAddress {
+    ...MailingAddress
+  }
+  billingAddress {
+    ...MailingAddress
+  }
+  shippingLine {
+    ...ShippingRate
+  }
+  availableShippingRates {
+    ...ShippingRate
+  }
+  shippingRatesReady
+  email
+  phone
+  customerId
+  discountCodes {
+    ...DiscountCode
+  }
+  discountApplications {
+    ...DiscountApplication
+  }
+  availablePaymentMethods {
+    ...PaymentMethod
+  }
+  selectedPaymentMethodId
+  subtotalPrice {
+    ...Money
+  }
+  totalShippingPrice {
+    ...Money
+  }
+  totalTax {
+    ...Money
+  }
+  taxLines {
+    ...TaxLine
+  }
+  totalDiscounts {
+    ...Money
+  }
+  totalPrice {
+    ...Money
+  }
+  # GAP-001: Gift Card Checkout Integration
+  appliedGiftCards {
+    ...AppliedGiftCard
+  }
+  totalGiftCardAmount {
+    ...Money
+  }
+  paymentDue {
+    ...Money
+  }
+  currencyCode
+  note
+  createdAt
+  updatedAt
+}
+
+# ============================================
+# Shipment Fragments (R29 - Shipment Tracking)
+# ============================================
+
+fragment ShipmentEvent on ShipmentEvent {
+  id
+  status
+  description
+  location
+  occurredAt
+  providerEventCode
+}
+
+fragment ShipmentPackage on ShipmentPackage {
+  weight
+  length
+  width
+  height
+}
+
+fragment ShipmentItem on ShipmentItem {
+  id
+  title
+  variantTitle
+  sku
+  quantity
+  imageUrl
+}
+
+fragment Shipment on Shipment {
+  id
+  orderId
+  provider
+  serviceCode
+  trackingNumber
+  trackingUrl
+  labelUrl
+  status
+  estimatedDeliveryDate
+  shippedAt
+  deliveredAt
+  recipientAddress {
+    ...MailingAddress
+  }
+  packages {
+    ...ShipmentPackage
+  }
+  items {
+    ...ShipmentItem
+  }
+  events {
+    ...ShipmentEvent
+  }
+  createdAt
+  updatedAt
+}
+
+fragment ShipmentBasic on Shipment {
+  id
+  orderId
+  provider
+  trackingNumber
+  trackingUrl
+  status
+  estimatedDeliveryDate
+  shippedAt
+  deliveredAt
+  createdAt
+}
+
+# ============================================
+# Return Fragments (R30 - Returns/RMA)
+# ============================================
+
+fragment ReturnShippingLabel on ReturnShippingLabel {
+  url
+  carrier
+  trackingNumber
+  expiresAt
+}
+
+fragment ReturnItemPhoto on ReturnItemPhoto {
+  id
+  url
+  alt
+  description
+  createdAt
+}
+
+fragment ReturnItem on ReturnItem {
+  id
+  variantId
+  productTitle
+  variantTitle
+  sku
+  imageUrl
+  quantity
+  reason
+  condition
+  unitPrice {
+    ...Money
+  }
+  photos {
+    ...ReturnItemPhoto
+  }
+  status
+  approvedQuantity
+}
+
+fragment Return on Return {
+  id
+  returnNumber
+  orderId
+  orderNumber
+  status
+  reason
+  customerNote
+  compensationType
+  items {
+    ...ReturnItem
+  }
+  refundAmount {
+    ...Money
+  }
+  shippingLabel {
+    ...ReturnShippingLabel
+  }
+  requestedAt
+  approvedAt
+  receivedAt
+  refundedAt
+  completedAt
+  createdAt
+  updatedAt
+}
+
+fragment ReturnBasic on Return {
+  id
+  returnNumber
+  orderId
+  orderNumber
+  status
+  reason
+  createdAt
+  updatedAt
+}
+
+fragment ReturnReasonOption on ReturnReasonOption {
+  value
+  label
+  description
+}
+
+# ============================================
+# 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
+  }
+  balance {
+    ...Money
+  }
+  expiresAt
+  recipientName
+  message
+  transactions {
+    ...GiftCardTransaction
+  }
+  createdAt
+}
+
+fragment GiftCardError on GiftCardError {
+  code
+  message
+}
+
+fragment GiftCardValidation on GiftCardValidation {
+  valid
+  availableBalance {
+    ...Money
+  }
+  error {
+    ...GiftCardError
+  }
+  giftCard {
+    ...GiftCard
+  }
+}
+
+# ============================================
+# Shipping Method Fragments (R33 - Shipping Methods)
+# ============================================
+
+fragment ShippingCarrier on ShippingCarrier {
+  id
+  name
+  logoUrl
+  serviceCode
+}
+
+fragment DeliveryEstimate on DeliveryEstimate {
+  minDays
+  maxDays
+  description
+}
+
+fragment FreeShippingProgress on FreeShippingProgress {
+  qualifies
+  currentAmount {
+    ...Money
+  }
+  threshold {
+    ...Money
+  }
+  remaining {
+    ...Money
+  }
+  progressPercent
+  message
+}
+
+fragment AvailableShippingMethod on AvailableShippingMethod {
+  id
+  name
+  description
+  carrier {
+    ...ShippingCarrier
+  }
+  price {
+    ...Money
+  }
+  isFree
+  estimatedDelivery {
+    ...DeliveryEstimate
+  }
+  freeShippingProgress {
+    ...FreeShippingProgress
+  }
+  sortOrder
+}
+
+# ============================================
+# Attribute Filter Fragments (R35 - Dynamic Attributes)
+# ============================================
+
+fragment AttributeSwatch on AttributeSwatch {
+  colorHex
+  imageUrl
+}
+
+fragment AttributeRangeBounds on AttributeRangeBounds {
+  min
+  max
+  currencyCode
+}
+
+fragment AttributeFilterValue on AttributeFilterValue {
+  id
+  value
+  label
+  productCount
+  swatch {
+    ...AttributeSwatch
+  }
+  priceModifier {
+    ...Money
+  }
+  sortOrder
+}
+
+fragment AttributeDefinition on AttributeDefinition {
+  id
+  name
+  handle
+  type
+  isFilterable
+  isVisible
+  displayOrder
+  filterValues {
+    ...AttributeFilterValue
+  }
+  rangeBounds {
+    ...AttributeRangeBounds
+  }
+}
+
+fragment PriceRangeFilter on PriceRange {
+  min {
+    ...Money
+  }
+  max {
+    ...Money
+  }
+}
+
+fragment CategoryFilterOption on CategoryFilterOption {
+  id
+  name
+  slug
+  productCount
+  level
+  parentId
+}
+
+fragment AvailableFilters on AvailableFilters {
+  attributes {
+    ...AttributeDefinition
+  }
+  priceRange {
+    ...PriceRangeFilter
+  }
+  categories {
+    ...CategoryFilterOption
+  }
+  activeFilterCount
+  totalProducts
+}
+
+# ============================================
+# Loyalty Program Fragments
+# ============================================
+
+fragment LoyaltyPageInfo on LoyaltyPageInfo {
+  hasNextPage
+  hasPreviousPage
+  startCursor
+  endCursor
+}
+
+fragment LoyaltyTier on LoyaltyTier {
+  id
+  name
+  type
+  minPoints
+  minAnnualSpend {
+    ...Money
+  }
+  pointsMultiplier
+  customBenefits {
+    name
+    description
+    icon
+  }
+}
+
+fragment LoyaltyPointsSummary on LoyaltyPointsSummary {
+  totalPoints
+  currentPoints
+  pendingPoints
+  redeemedPoints
+  expiredPoints
+  expiringPoints
+  nextExpiryDate
+}
+
+fragment TierProgress on TierProgress {
+  currentTier {
+    ...LoyaltyTier
+  }
+  nextTier {
+    ...LoyaltyTier
+  }
+  pointsToNextTier
+  progressPercent
+  spendToNextTier {
+    ...Money
+  }
+}
+
+fragment LoyaltyMember on LoyaltyMember {
+  id
+  customerId
+  points {
+    ...LoyaltyPointsSummary
+  }
+  tier {
+    ...LoyaltyTier
+  }
+  tierProgress {
+    ...TierProgress
+  }
+  annualSpend {
+    ...Money
+  }
+  lastActivityAt
+  enrolledAt
+}
+
+fragment LoyaltyTransaction on LoyaltyTransaction {
+  id
+  type
+  points
+  balanceAfter
+  orderId
+  description
+  expiresAt
+  createdAt
+}
+
+fragment LoyaltyReward on LoyaltyReward {
+  id
+  name
+  slug
+  type
+  pointsCost
+  discountPercent
+  discountAmount {
+    ...Money
+  }
+  description
+  image {
+    ...Image
+  }
+  available
+  tierRequired {
+    ...LoyaltyTier
+  }
+  remainingRedemptions
+}
+
+fragment PointsEstimate on PointsEstimate {
+  basePoints
+  bonusPoints
+  totalPoints
+  multiplier
+}
+
+fragment LoyaltyAction on LoyaltyAction {
+  type
+  enabled
+  points
+}
+
+fragment LoyaltySettings on LoyaltySettings {
+  enabled
+  pointsName
+  pointsPerCurrency
+  pointsExpiryMonths
+  availableActions {
+    ...LoyaltyAction
+  }
+  referralEnabled
+  referralPoints
+  referralBonusPoints
+}
+
+fragment ReferralStats on ReferralStats {
+  referralCode
+  shareUrl
+  totalReferred
+  completedReferrals
+  pendingReferrals
+  totalPointsEarned
+}
+
+# GAP-003: PRODUCT and GIFT_CARD Reward Types
+fragment RedeemRewardPayload on RedeemRewardPayload {
+  success
+  discountCode
+  productDiscountCode
+  giftCardCode
+  userErrors
+}
+
+fragment GenerateReferralCodePayload on GenerateReferralCodePayload {
+  success
+  referralCode
+  shareUrl
+  userErrors
+}