@doswiftly/storefront-operations 1.0.6 → 5.4.0

package/fragments.graphql

@@ -20,6 +20,7 @@ fragment UserError on UserError {
   field
 }
 
+# Base Image — no transform (for logos, favicons, branding assets that are already small)
 fragment Image on Image {
   id
   url
@@ -28,6 +29,37 @@ fragment Image on Image {
   height
 }
 
+# Thumbnail — cart items, variant swatches, author avatars (rendered at ~96px, 300px covers 3x DPI)
+# No preferredContentType — imgproxy auto-negotiates AVIF/WEBP from Accept header
+fragment ImageThumbnail on Image {
+  id
+  url(transform: { maxWidth: 300 })
+  altText
+  width
+  height
+  thumbhash
+}
+
+# Card — product cards, collection/category cards, blog posts (rendered at ~400px, 800px covers 2x DPI)
+fragment ImageCard on Image {
+  id
+  url(transform: { maxWidth: 800 })
+  altText
+  width
+  height
+  thumbhash
+}
+
+# Full — product detail gallery, hero images (rendered at ~800px, 1600px covers 2x DPI)
+fragment ImageFull on Image {
+  id
+  url(transform: { maxWidth: 1600 })
+  altText
+  width
+  height
+  thumbhash
+}
+
 # Simple money (for originalPrice fields and non-converted prices)
 fragment Money on Money {
   amount
@@ -79,7 +111,7 @@ fragment ProductVariant on ProductVariant {
   available
   quantityAvailable
   image {
-    ...Image
+    ...ImageThumbnail
   }
   selectedOptions {
     ...SelectedOption
@@ -102,7 +134,7 @@ fragment ProductCard on Product {
   reviewCount
   tags
   featuredImage {
-    ...Image
+    ...ImageCard
   }
   priceRange {
     minVariantPrice {
@@ -146,6 +178,9 @@ fragment ProductBase on Product {
   totalInventory
   type
   collectRecipientInfo
+  # Faza 1.5 (Decision D-A v3 + D-B)
+  visibility
+  attributeSetId
   createdAt
   updatedAt
 }
@@ -153,7 +188,7 @@ fragment ProductBase on Product {
 fragment ProductFull on Product {
   ...ProductBase
   images(first: 20) {
-    ...Image
+    ...ImageFull
   }
   variants(first: 100) {
     ...ProductVariant
@@ -175,7 +210,7 @@ fragment Collection on Collection {
   description
   descriptionHtml
   image {
-    ...Image
+    ...ImageCard
   }
   seo {
     title
@@ -195,7 +230,7 @@ fragment Category on Category {
   slug
   description
   image {
-    ...Image
+    ...ImageCard
   }
   level
   path
@@ -311,6 +346,24 @@ fragment CartLineCost on CartLineCost {
   }
 }
 
+# Typed customer-filled attribute snapshot (Faza 1 R5 + Decision D-A v3 + D-I).
+# Distinct from CartLine.attributes (Shopify raw KV line item properties).
+fragment AttributeSelection on AttributeSelection {
+  attributeDefinitionId
+  attributeName
+  type
+  fillingMode
+  billingMode
+  optionId
+  optionLabel
+  optionIds
+  textValue
+  surchargeAmount
+  surchargeType
+  taxClassId
+  linkedVariantId
+}
+
 fragment CartLine on CartLine {
   id
   quantity
@@ -324,6 +377,9 @@ fragment CartLine on CartLine {
     key
     value
   }
+  attributeSelections {
+    ...AttributeSelection
+  }
   productId
   productTitle
   productHandle
@@ -587,7 +643,7 @@ fragment CheckoutLineItem on CheckoutLineItem {
   productId
   sku
   image {
-    ...Image
+    ...ImageThumbnail
   }
 }
 
@@ -1092,7 +1148,7 @@ fragment LoyaltyReward on LoyaltyReward {
   }
   description
   image {
-    ...Image
+    ...ImageCard
   }
   available
   tierRequired {
@@ -1153,24 +1209,363 @@ fragment GenerateReferralCodePayload on GenerateReferralCodePayload {
 }
 
 # ============================================
-# Inventory Level Fragments (Multi-Warehouse)
+# Review Fragments
+# ============================================
+
+fragment ProductReview on ProductReview {
+  id
+  productId
+  rating
+  title
+  content
+  pros
+  cons
+  images
+  authorName
+  isVerifiedPurchase
+  helpfulCount
+  response
+  responseAt
+  createdAt
+}
+
+fragment ReviewStats on ReviewStats {
+  averageRating
+  totalCount
+  fiveStarCount
+  fourStarCount
+  threeStarCount
+  twoStarCount
+  oneStarCount
+}
+
+# ============================================
+# Wishlist Fragments
 # ============================================
 
-fragment InventoryLevel on InventoryLevel {
-  locationId
-  locationName
-  locationType
+fragment WishlistItem on WishlistItem {
+  id
+  productId
+  variantId
+  product {
+    ...ProductCard
+  }
+  priceAtAdd {
+    ...Money
+  }
+  notifyOnSale
+  notifyOnRestock
+  addedAt
+}
+
+fragment Wishlist on Wishlist {
+  id
+  name
+  isPublic
+  shareToken
+  items {
+    ...WishlistItem
+  }
+  itemCount
+  createdAt
+  updatedAt
+}
+
+# ============================================
+# Blog Fragments
+# ============================================
+
+fragment BlogCategory on BlogCategory {
+  id
+  name
+  slug
+  description
+  postCount
+}
+
+fragment BlogTag on BlogTag {
+  id
+  name
+  slug
+  postCount
+}
+
+fragment BlogPost on BlogPost {
+  id
+  title
+  slug
+  excerpt
+  content
+  contentType
+  featuredImage {
+    ...ImageCard
+  }
+  author {
+    id
+    name
+    bio
+    avatar {
+      ...ImageThumbnail
+    }
+  }
+  category {
+    ...BlogCategory
+  }
+  tags {
+    ...BlogTag
+  }
+  publishedAt
+  readingTime
+  viewCount
+  commentCount
+  allowComments
+  isFeatured
+  status
+  seo {
+    title
+    description
+  }
+  createdAt
+  updatedAt
+}
+
+# ============================================
+# Recommendation Fragments
+# ============================================
+
+fragment ProductRecommendation on ProductRecommendation {
+  product {
+    ...ProductCard
+  }
+  type
+  score
+  reason
+}
+
+fragment CartRecommendation on CartRecommendations {
+  frequentlyBoughtTogether {
+    product {
+      ...ProductCard
+    }
+    type
+    score
+    reason
+  }
+  youMayAlsoLike {
+    product {
+      ...ProductCard
+    }
+    type
+    score
+    reason
+  }
+}
+
+# ============================================
+# Store Availability Fragments (Shopify parity — BOPIS / multi-location)
+# ============================================
+# Field access:
+# - `available: Boolean!` — always public.
+# - `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
+  city
+  country
+  countryCode
+  province
+  provinceCode
+  zip
+  phone
+  latitude
+  longitude
+  formatted
+}
+
+fragment BusinessHoursWindow on BusinessHoursWindow {
+  openHour
+  closeHour
+}
+
+fragment BusinessHours on BusinessHours {
+  monday { ...BusinessHoursWindow }
+  tuesday { ...BusinessHoursWindow }
+  wednesday { ...BusinessHoursWindow }
+  thursday { ...BusinessHoursWindow }
+  friday { ...BusinessHoursWindow }
+  saturday { ...BusinessHoursWindow }
+  sunday { ...BusinessHoursWindow }
+}
+
+fragment Location on Location {
+  id
+  name
+  type
+  pickupEnabled
+  timezone
+  pickupInstructions
+  address {
+    ...LocationAddress
+  }
+  businessHours {
+    ...BusinessHours
+  }
+}
+
+fragment StoreAvailability on StoreAvailability {
   available
-  onHand
+  quantityAvailable
+  pickUpTime
+  location {
+    ...Location
+  }
+}
+
+fragment StoreAvailabilityConnection on StoreAvailabilityConnection {
+  totalCount
+  pageInfo {
+    ...PageInfo
+  }
+  edges {
+    cursor
+    node {
+      ...StoreAvailability
+    }
+  }
 }
 
-fragment VariantInventoryLevels on ProductVariant {
+fragment VariantStoreAvailability on ProductVariant {
   id
   title
   sku
   available
   quantityAvailable
-  inventoryLevels {
-    ...InventoryLevel
+  storeAvailability(first: 10) {
+    ...StoreAvailabilityConnection
+  }
+}
+
+# ============================================
+# Content: Pages
+# ============================================
+
+fragment ShopPage on ShopPage {
+  id
+  handle
+  title
+  body
+  bodySummary
+  seo {
+    title
+    description
+  }
+  publishedAt
+  createdAt
+  updatedAt
+}
+
+# ============================================
+# Content: Navigation Menus
+# ============================================
+
+fragment MenuItem on MenuItem {
+  id
+  title
+  url
+  type
+  resourceId
+  image {
+    ...Image
+  }
+  items {
+    id
+    title
+    url
+    type
+    resourceId
+    items {
+      id
+      title
+      url
+      type
+      resourceId
+    }
+  }
+}
+
+fragment Menu on Menu {
+  id
+  handle
+  title
+  itemsCount
+  items {
+    ...MenuItem
+  }
+}
+
+# ============================================
+# Content: URL Redirects
+# ============================================
+
+fragment UrlRedirect on UrlRedirect {
+  path
+  target
+}
+
+# ============================================
+# Unified Product Configurator (Faza 1 + Faza 1.5 — Decision D-A v3 + D-I)
+# ============================================
+# Hybrid Magento 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
+#   - MERCHANT fillingMode → product metadata (filtering, display)
+#   - BOTH fillingMode → admin default + customer override in cart
+
+fragment LinkedVariantSummary on LinkedVariantSummary {
+  id
+  productId
+  title
+  sku
+  quantityAvailable
+  isAvailable
+  trackQuantity
+}
+
+fragment ProductAttributeOption on ProductAttributeOption {
+  id
+  value
+  label
+  sortOrder
+  colorHex
+  surchargeAmount
+  surchargeType
+  isDefault
+  linkedVariantId
+  linkedVariant {
+    ...LinkedVariantSummary
+  }
+}
+
+fragment ProductAttributeDefinition on ProductAttributeDefinition {
+  id
+  name
+  slug
+  description
+  type
+  fillingMode
+  billingMode
+  taxClassId
+  scopeProductId
+  isRequired
+  isVisible
+  displayOrder
+  minValue
+  maxValue
+  options {
+    ...ProductAttributeOption
   }
 }

package/mutations.graphql

@@ -431,3 +431,84 @@ mutation GenerateReferralCode {
     ...GenerateReferralCodePayload
   }
 }
+
+# ============================================
+# Review Mutations
+# ============================================
+
+mutation ReviewCreate($input: ReviewCreateInput!) {
+  reviewCreate(input: $input) {
+    review {
+      ...ProductReview
+    }
+    userErrors {
+      ...UserError
+    }
+  }
+}
+
+mutation ReviewVote($reviewId: ID!, $isHelpful: Boolean!) {
+  reviewVote(reviewId: $reviewId, isHelpful: $isHelpful) {
+    review {
+      ...ProductReview
+    }
+    userErrors {
+      ...UserError
+    }
+  }
+}
+
+# ============================================
+# Wishlist Mutations
+# ============================================
+
+mutation WishlistCreate($input: WishlistCreateInput!) {
+  wishlistCreate(input: $input) {
+    wishlist {
+      ...Wishlist
+    }
+    userErrors
+  }
+}
+
+mutation WishlistAddItem($wishlistId: ID!, $input: WishlistItemInput!) {
+  wishlistAddItem(wishlistId: $wishlistId, input: $input) {
+    wishlist {
+      ...Wishlist
+    }
+    userErrors
+  }
+}
+
+mutation WishlistRemoveItem($wishlistId: ID!, $itemId: ID!) {
+  wishlistRemoveItem(wishlistId: $wishlistId, itemId: $itemId) {
+    wishlist {
+      ...Wishlist
+    }
+    userErrors
+  }
+}
+
+mutation WishlistDelete($wishlistId: ID!) {
+  wishlistDelete(wishlistId: $wishlistId) {
+    wishlist {
+      ...Wishlist
+    }
+    userErrors
+  }
+}
+
+# ============================================
+# Cart Attributes
+# ============================================
+
+mutation CartAttributesUpdate($cartId: ID!, $attributes: [CartAttributeInput!]!) {
+  cartAttributesUpdate(cartId: $cartId, attributes: $attributes) {
+    cart {
+      ...Cart
+    }
+    userErrors {
+      ...UserError
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doswiftly/storefront-operations",
-  "version": "1.0.6",
+  "version": "5.4.0",
   "description": "GraphQL operations for DoSwiftly Storefront - SSOT from backend",
   "homepage": "https://doswiftly.pl",
   "publishConfig": {
@@ -14,10 +14,6 @@
     "./fragments.graphql": "./fragments.graphql",
     "./*.graphql": "./*.graphql"
   },
-  "scripts": {
-    "sync": "node scripts/sync-operations.js",
-    "build": "npm run sync"
-  },
   "keywords": [
     "graphql",
     "operations",
@@ -33,5 +29,9 @@
     "mutations.graphql",
     "fragments.graphql",
     "README.md"
-  ]
-}
+  ],
+  "scripts": {
+    "sync": "node scripts/sync-operations.js",
+    "build": "npm run sync"
+  }
+}