@doswiftly/storefront-operations 17.0.0 → 18.0.0

package/fragments.graphql

@@ -510,7 +510,7 @@ fragment Cart on Cart {
   selectedPaymentMethod {
     ...CartSelectedPaymentMethod
   }
-  selectedPaymentInstrumentCode
+  selectedPaymentInstrument
   appliedGiftCards {
     ...CartAppliedGiftCard
   }
@@ -550,13 +550,15 @@ fragment CartAppliedGiftCard on CartAppliedGiftCard {
   }
 }
 
-# Payment method (integration provider) selected on a cart — id, name, provider code, type category (CARD/BLIK/BANK_TRANSFER/etc.), icon, description, isDefault, supportedCurrencies. Storefront UI używa do iconography + selection display.
+# Payment method (integration provider) selected on a cart — id, name, provider code, type category (CARD/BLIK/BANK_TRANSFER/etc.), icon image (transformable), description, isDefault, supportedCurrencies. Storefront UI używa do iconography + selection display.
 fragment CartSelectedPaymentMethod on PaymentMethod {
   id
   name
   provider
   type
-  icon
+  icon {
+    ...ImageThumbnail
+  }
   description
   isDefault
   supportedCurrencies
@@ -701,29 +703,33 @@ fragment ShopConfigFields on Shop {
 # Payment Methods
 # ============================================
 
-# A single concrete instrument exposed by a gateway provider (BLIK code, branded bank, wallet, card brand). Pass `instrumentCode` as `preferredInstrumentCode` in `cartSelectPaymentMethod` for direct deep-link to that instrument screen on the gateway. `displayHint` is a semantic UX hint (`PIN_ENTRY`, `WALLET_TAP`, `BANK_LIST`, `CARD_FORM`) — storefront branches rendering accordingly. `enabled: false` means the gateway reported the instrument as temporarily disabled — gray out, don't hide.
-fragment PaymentMethodInstrument on PaymentMethodInstrument {
-  providerCode
-  instrumentCode
+# A single concrete instrument exposed by a gateway provider (BLIK code, branded bank, wallet, card brand). Pass `code` as `preferredInstrument` in `cartSelectPaymentMethod` for direct deep-link to that instrument screen on the gateway. `displayHint` is a semantic UX hint (`PROMINENT_BUTTON`, `BRANDED_TILE`, `DROPDOWN_OPTION`, `RADIO_OPTION`) — storefront branches rendering accordingly. `enabled: false` means the gateway reported the instrument as temporarily disabled — gray out, don't hide.
+fragment PaymentInstrument on PaymentInstrument {
+  provider
+  code
   type
   displayName
   displayHint
-  brandImageUrl
+  brandImage {
+    ...ImageThumbnail
+  }
   enabled
 }
 
 # Single payment method enabled for the shop — method-centric.
-# `type` is the category (CARD, BLIK, BANK_TRANSFER, CASH_ON_DELIVERY, OTHER) — drive iconography here.
-# `provider`, `providersAvailable`, `preferredProvider` are `ProviderCode` enum (UPPERCASE: `PAYU`, `PRZELEWY24`, ...).
+# `type` is the category (CARD, BLIK, BANK_TRANSFER, INSTALLMENT, WALLET, CASH_ON_DELIVERY, OTHER) — drive iconography here.
+# `provider`, `providersAvailable`, `preferredProvider` are `PaymentProvider` enum (UPPERCASE: `PAYU`, `PRZELEWY24`, ...).
 # `available` is `false` when the resolving gateway is temporarily unavailable or reported the method as disabled — gray-out the tile, don't hide it; `unavailableReason` carries the diagnostic.
-# `instruments` lists concrete gateway-side instruments (BLIK code, branded banks, wallets) when the gateway exposes granular data — pass `instrumentCode` as `preferredInstrumentCode` in `cartSelectPaymentMethod` for direct deep-link to that instrument screen on the gateway.
+# `instruments` lists concrete gateway-side instruments (BLIK code, branded banks, wallets) when the gateway exposes granular data — pass `code` as `preferredInstrument` in `cartSelectPaymentMethod` for direct deep-link to that instrument screen on the gateway.
 # Spread on the checkout payment step.
 fragment PaymentMethod on PaymentMethod {
   id
   name
   provider
   type
-  icon
+  icon {
+    ...ImageThumbnail
+  }
   description
   isDefault
   supportedCurrencies
@@ -733,7 +739,7 @@ fragment PaymentMethod on PaymentMethod {
   available
   unavailableReason
   instruments {
-    ...PaymentMethodInstrument
+    ...PaymentInstrument
   }
 }
 
@@ -798,14 +804,16 @@ fragment ShipmentPackage on ShipmentPackage {
   height
 }
 
-# One item in a shipment — title, variant, sku, quantity, image URL. Spread inside `Shipment.items[]` for the tracking page item list.
+# One item in a shipment — title, variant, sku, quantity, live variant image (transformable). Spread inside `Shipment.items[]` for the tracking page item list. `image` is live from the current variant (snapshot fallback when variant has been deleted since fulfillment — returns null, render a placeholder).
 fragment ShipmentItem on ShipmentItem {
   id
   title
   variantTitle
   sku
   quantity
-  imageUrl
+  image {
+    ...ImageThumbnail
+  }
 }
 
 # Full shipment shape — provider, tracking number + URL, label URL, status, ETA, recipient address, packages, items, full event timeline. Spread on the tracking page.
@@ -879,7 +887,9 @@ fragment ReturnItem on ReturnItem {
   productTitle
   variantTitle
   sku
-  imageUrl
+  image {
+    ...ImageThumbnail
+  }
   quantity
   reason
   condition
@@ -973,11 +983,13 @@ fragment GiftCardValidation on GiftCardValidation {
 # Shipping Methods
 # ============================================
 
-# Carrier offering the shipping method — id, display name, logo URL, internal service code.
+# Carrier offering the shipping method — id, display name, logo image (transformable), internal service code.
 fragment ShippingCarrier on ShippingCarrier {
   id
   name
-  logoUrl
+  logo {
+    ...ImageThumbnail
+  }
   serviceCode
 }
 
@@ -1030,10 +1042,12 @@ fragment AvailableShippingMethod on AvailableShippingMethod {
 # Attribute Filters
 # ============================================
 
-# Visual swatch for an attribute filter value — color hex (for color filters) or image URL (for pattern/material swatches).
+# Visual swatch for an attribute filter value — color hex (for color filters) or image (for pattern/material swatches).
 fragment AttributeSwatch on AttributeSwatch {
   colorHex
-  imageUrl
+  image {
+    ...ImageThumbnail
+  }
 }
 
 # Numeric range bounds for slider-style filters — min, max, currency code (when relevant).
@@ -1136,7 +1150,9 @@ fragment LoyaltyTier on LoyaltyTier {
   customBenefits {
     name
     description
-    icon
+    icon {
+      ...ImageThumbnail
+    }
   }
 }
 
@@ -1293,7 +1309,9 @@ fragment ProductReview on ProductReview {
   content
   pros
   cons
-  images
+  images {
+    ...ImageThumbnail
+  }
   authorName
   isVerifiedPurchase
   helpfulCount
@@ -1541,7 +1559,7 @@ fragment MenuItem on MenuItem {
     ... on Collection { id handle title }
     ... on ShopPage { id handle title }
     ... on Product { id handle title }
-    ... on Brand { id handle name logo }
+    ... on Brand { id handle name logo { ...ImageThumbnail } }
   }
   image {
     ...Image
@@ -1558,7 +1576,7 @@ fragment MenuItem on MenuItem {
       ... on Collection { id handle title }
       ... on ShopPage { id handle title }
       ... on Product { id handle title }
-      ... on Brand { id handle name logo }
+      ... on Brand { id handle name logo { ...ImageThumbnail } }
     }
     items {
       id
@@ -1572,7 +1590,7 @@ fragment MenuItem on MenuItem {
         ... on Collection { id handle title }
         ... on ShopPage { id handle title }
         ... on Product { id handle title }
-        ... on Brand { id handle name logo }
+        ... on Brand { id handle name logo { ...ImageThumbnail } }
       }
     }
   }

package/llms-full.txt

@@ -1,6 +1,6 @@
 # DoSwiftly Storefront Operations — Full Reference
 
-> Schema version: **17.0.0**
+> Schema version: **18.0.0**
 > 52 queries · 41 mutations · 104 fragments
 
 Auto-generated from `.graphql` source files. Do not edit by hand — this file is
@@ -1975,7 +1975,7 @@ mutation CartSelectShippingMethod($input: CartSelectShippingMethodInput!) {
 
 **Section**: Cart Completion Mutations
 
-**Description**: Selects a payment method on the cart by category (`methodType` — BLIK, CARD, BANK_TRANSFER, ...). Optional `preferredProviderId` overrides the merchant priority when the buyer explicitly picks a gateway from `PaymentMethod.providersAvailable`. The backend resolves the gateway routing from `MerchantPaymentConfig` at `cartComplete`; the selection persisted here is the category. Errors: `PAYMENT_METHOD_REQUIRED`, `CART_NOT_FOUND`, `CART_UNAUTHENTICATED`.
+**Description**: Selects a payment method on the cart by category (`methodType` — BLIK, CARD, BANK_TRANSFER, ...). Optional `preferredProvider` overrides the merchant priority when the buyer explicitly picks a gateway from `PaymentMethod.providersAvailable`. The backend resolves the gateway routing from `MerchantPaymentConfig` at `cartComplete`; the selection persisted here is the category. Errors: `PAYMENT_METHOD_REQUIRED`, `CART_NOT_FOUND`, `CART_UNAUTHENTICATED`.
 
 **Variables**:
 - `$input`: `CartSelectPaymentMethodInput!`
@@ -3202,7 +3202,7 @@ fragment Cart on Cart {
   selectedPaymentMethod {
     ...CartSelectedPaymentMethod
   }
-  selectedPaymentInstrumentCode
+  selectedPaymentInstrument
   appliedGiftCards {
     ...CartAppliedGiftCard
   }
@@ -3267,7 +3267,9 @@ fragment CartAppliedGiftCard on CartAppliedGiftCard {
 
 **Section**: Cart
 
-**Description**: Payment method (integration provider) selected on a cart — id, name, provider code, type category (CARD/BLIK/BANK_TRANSFER/etc.), icon, description, isDefault, supportedCurrencies. Storefront UI używa do iconography + selection display.
+**Description**: Payment method (integration provider) selected on a cart — id, name, provider code, type category (CARD/BLIK/BANK_TRANSFER/etc.), icon image (transformable), description, isDefault, supportedCurrencies. Storefront UI używa do iconography + selection display.
+
+**Uses fragments**: `ImageThumbnail`
 
 **GraphQL**:
 ```graphql
@@ -3276,7 +3278,9 @@ fragment CartSelectedPaymentMethod on PaymentMethod {
   name
   provider
   type
-  icon
+  icon {
+    ...ImageThumbnail
+  }
   description
   isDefault
   supportedCurrencies
@@ -3502,21 +3506,25 @@ fragment ShopConfigFields on Shop {
 }
 ```
 
-### Fragment: `PaymentMethodInstrument` on `PaymentMethodInstrument`
+### Fragment: `PaymentInstrument` on `PaymentInstrument`
 
 **Section**: Payment Methods
 
-**Description**: A single concrete instrument exposed by a gateway provider (BLIK code, branded bank, wallet, card brand). Pass `instrumentCode` as `preferredInstrumentCode` in `cartSelectPaymentMethod` for direct deep-link to that instrument screen on the gateway. `displayHint` is a semantic UX hint (`PIN_ENTRY`, `WALLET_TAP`, `BANK_LIST`, `CARD_FORM`) — storefront branches rendering accordingly. `enabled: false` means the gateway reported the instrument as temporarily disabled — gray out, don't hide.
+**Description**: A single concrete instrument exposed by a gateway provider (BLIK code, branded bank, wallet, card brand). Pass `code` as `preferredInstrument` in `cartSelectPaymentMethod` for direct deep-link to that instrument screen on the gateway. `displayHint` is a semantic UX hint (`PROMINENT_BUTTON`, `BRANDED_TILE`, `DROPDOWN_OPTION`, `RADIO_OPTION`) — storefront branches rendering accordingly. `enabled: false` means the gateway reported the instrument as temporarily disabled — gray out, don't hide.
+
+**Uses fragments**: `ImageThumbnail`
 
 **GraphQL**:
 ```graphql
-fragment PaymentMethodInstrument on PaymentMethodInstrument {
-  providerCode
-  instrumentCode
+fragment PaymentInstrument on PaymentInstrument {
+  provider
+  code
   type
   displayName
   displayHint
-  brandImageUrl
+  brandImage {
+    ...ImageThumbnail
+  }
   enabled
 }
 ```
@@ -3525,9 +3533,9 @@ fragment PaymentMethodInstrument on PaymentMethodInstrument {
 
 **Section**: Payment Methods
 
-**Description**: Single payment method enabled for the shop — method-centric. `type` is the category (CARD, BLIK, BANK_TRANSFER, CASH_ON_DELIVERY, OTHER) — drive iconography here. `provider`, `providersAvailable`, `preferredProvider` are `ProviderCode` enum (UPPERCASE: `PAYU`, `PRZELEWY24`, ...). `available` is `false` when the resolving gateway is temporarily unavailable or reported the method as disabled — gray-out the tile, don't hide it; `unavailableReason` carries the diagnostic. `instruments` lists concrete gateway-side instruments (BLIK code, branded banks, wallets) when the gateway exposes granular data — pass `instrumentCode` as `preferredInstrumentCode` in `cartSelectPaymentMethod` for direct deep-link to that instrument screen on the gateway. Spread on the checkout payment step.
+**Description**: Single payment method enabled for the shop — method-centric. `type` is the category (CARD, BLIK, BANK_TRANSFER, INSTALLMENT, WALLET, CASH_ON_DELIVERY, OTHER) — drive iconography here. `provider`, `providersAvailable`, `preferredProvider` are `PaymentProvider` enum (UPPERCASE: `PAYU`, `PRZELEWY24`, ...). `available` is `false` when the resolving gateway is temporarily unavailable or reported the method as disabled — gray-out the tile, don't hide it; `unavailableReason` carries the diagnostic. `instruments` lists concrete gateway-side instruments (BLIK code, branded banks, wallets) when the gateway exposes granular data — pass `code` as `preferredInstrument` in `cartSelectPaymentMethod` for direct deep-link to that instrument screen on the gateway. Spread on the checkout payment step.
 
-**Uses fragments**: `PaymentMethodInstrument`
+**Uses fragments**: `ImageThumbnail`, `PaymentInstrument`
 
 **GraphQL**:
 ```graphql
@@ -3536,7 +3544,9 @@ fragment PaymentMethod on PaymentMethod {
   name
   provider
   type
-  icon
+  icon {
+    ...ImageThumbnail
+  }
   description
   isDefault
   supportedCurrencies
@@ -3546,7 +3556,7 @@ fragment PaymentMethod on PaymentMethod {
   available
   unavailableReason
   instruments {
-    ...PaymentMethodInstrument
+    ...PaymentInstrument
   }
 }
 ```
@@ -3644,7 +3654,9 @@ fragment ShipmentPackage on ShipmentPackage {
 
 **Section**: Shipments / Tracking
 
-**Description**: One item in a shipment — title, variant, sku, quantity, image URL. Spread inside `Shipment.items[]` for the tracking page item list.
+**Description**: One item in a shipment — title, variant, sku, quantity, live variant image (transformable). Spread inside `Shipment.items[]` for the tracking page item list. `image` is live from the current variant (snapshot fallback when variant has been deleted since fulfillment — returns null, render a placeholder).
+
+**Uses fragments**: `ImageThumbnail`
 
 **GraphQL**:
 ```graphql
@@ -3654,7 +3666,9 @@ fragment ShipmentItem on ShipmentItem {
   variantTitle
   sku
   quantity
-  imageUrl
+  image {
+    ...ImageThumbnail
+  }
 }
 ```
 
@@ -3758,7 +3772,7 @@ fragment ReturnItemPhoto on ReturnItemPhoto {
 
 **Description**: Single line in a return request — variant identity, quantity requested, reason, condition, photos, status, approved quantity (set by merchant after review). Spread inside `Return.items[]`.
 
-**Uses fragments**: `Money`, `ReturnItemPhoto`
+**Uses fragments**: `ImageThumbnail`, `Money`, `ReturnItemPhoto`
 
 **GraphQL**:
 ```graphql
@@ -3768,7 +3782,9 @@ fragment ReturnItem on ReturnItem {
   productTitle
   variantTitle
   sku
-  imageUrl
+  image {
+    ...ImageThumbnail
+  }
   quantity
   reason
   condition
@@ -3905,14 +3921,18 @@ fragment GiftCardValidation on GiftCardValidation {
 
 **Section**: Shipping Methods
 
-**Description**: Carrier offering the shipping method — id, display name, logo URL, internal service code.
+**Description**: Carrier offering the shipping method — id, display name, logo image (transformable), internal service code.
+
+**Uses fragments**: `ImageThumbnail`
 
 **GraphQL**:
 ```graphql
 fragment ShippingCarrier on ShippingCarrier {
   id
   name
-  logoUrl
+  logo {
+    ...ImageThumbnail
+  }
   serviceCode
 }
 ```
@@ -3994,13 +4014,17 @@ fragment AvailableShippingMethod on AvailableShippingMethod {
 
 **Section**: Attribute Filters
 
-**Description**: Visual swatch for an attribute filter value — color hex (for color filters) or image URL (for pattern/material swatches).
+**Description**: Visual swatch for an attribute filter value — color hex (for color filters) or image (for pattern/material swatches).
+
+**Uses fragments**: `ImageThumbnail`
 
 **GraphQL**:
 ```graphql
 fragment AttributeSwatch on AttributeSwatch {
   colorHex
-  imageUrl
+  image {
+    ...ImageThumbnail
+  }
 }
 ```
 
@@ -4157,7 +4181,7 @@ fragment LoyaltyPageInfo on LoyaltyPageInfo {
 
 **Description**: Loyalty tier definition — name, type enum (`BRONZE` / `SILVER` / `GOLD` / `PLATINUM` / `DIAMOND`), entry threshold (`minPoints` and/or `minAnnualSpend`), points multiplier, custom benefits list. Returned by `loyaltyTiers` and embedded in member tier data.
 
-**Uses fragments**: `Money`
+**Uses fragments**: `ImageThumbnail`, `Money`
 
 **GraphQL**:
 ```graphql
@@ -4173,7 +4197,9 @@ fragment LoyaltyTier on LoyaltyTier {
   customBenefits {
     name
     description
-    icon
+    icon {
+      ...ImageThumbnail
+    }
   }
 }
 ```
@@ -4424,6 +4450,8 @@ fragment GenerateReferralCodePayload on GenerateReferralCodePayload {
 
 **Description**: Single product review — rating, title, body, optional pros/cons, image attachments, author, verified-purchase flag, helpful/unhelpful counts, optional merchant response. Only `APPROVED` reviews are exposed to the storefront.
 
+**Uses fragments**: `ImageThumbnail`
+
 **GraphQL**:
 ```graphql
 fragment ProductReview on ProductReview {
@@ -4434,7 +4462,9 @@ fragment ProductReview on ProductReview {
   content
   pros
   cons
-  images
+  images {
+    ...ImageThumbnail
+  }
   authorName
   isVerifiedPurchase
   helpfulCount
@@ -4792,7 +4822,7 @@ fragment ShopPage on ShopPage {
 
 **Description**: One menu item with up to 3 levels of nested children — title, URL, type (`HTTP` / `FRONTPAGE` / `SEARCH` / `CATALOG` / `BLOG` / `PRODUCT` / `COLLECTION` / `CATEGORY` / `PAGE` / `BRAND`), `resourceId` for typed items, optional image, and a typed `resource` union (Category / Collection / ShopPage / Product / Brand) carrying the linked resource's handle. Two ways to render the link target: (1) use the pre-resolved `url` if your storefront follows the standard `/categories|/collections|/pages|/products|/brands/<handle>` route convention; (2) read `resource.__typename` + the per-type `handle` and build your own paths if your storefront uses different routing. Switch on `type` to decide which static (FRONTPAGE/SEARCH/CATALOG/BLOG) or dynamic target to render.
 
-**Uses fragments**: `Image`
+**Uses fragments**: `Image`, `ImageThumbnail`
 
 **GraphQL**:
 ```graphql
@@ -4828,7 +4858,9 @@ fragment MenuItem on MenuItem {
       id
       handle
       name
-      logo
+      logo {
+        ...ImageThumbnail
+      }
     }
   }
   image {
@@ -4866,7 +4898,9 @@ fragment MenuItem on MenuItem {
         id
         handle
         name
-        logo
+        logo {
+          ...ImageThumbnail
+        }
       }
     }
     items {
@@ -4901,7 +4935,9 @@ fragment MenuItem on MenuItem {
           id
           handle
           name
-          logo
+          logo {
+            ...ImageThumbnail
+          }
         }
       }
     }

package/mutations.graphql

@@ -330,7 +330,7 @@ mutation CartSelectShippingMethod($input: CartSelectShippingMethodInput!) {
 }
 
 # Selects a payment method on the cart by category (`methodType` — BLIK, CARD, BANK_TRANSFER, ...).
-# Optional `preferredProviderId` overrides the merchant priority when the buyer explicitly picks
+# Optional `preferredProvider` overrides the merchant priority when the buyer explicitly picks
 # a gateway from `PaymentMethod.providersAvailable`. The backend resolves the gateway routing
 # from `MerchantPaymentConfig` at `cartComplete`; the selection persisted here is the category.
 # Errors: `PAYMENT_METHOD_REQUIRED`, `CART_NOT_FOUND`, `CART_UNAUTHENTICATED`.

package/operations.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "17.0.0",
+  "schemaVersion": "18.0.0",
   "queries": [
     {
       "name": "Shop",
@@ -1518,7 +1518,7 @@
       "name": "CartSelectPaymentMethod",
       "kind": "mutation",
       "section": "Cart Completion Mutations",
-      "description": "Selects a payment method on the cart by category (`methodType` — BLIK, CARD, BANK_TRANSFER, ...). Optional `preferredProviderId` overrides the merchant priority when the buyer explicitly picks a gateway from `PaymentMethod.providersAvailable`. The backend resolves the gateway routing from `MerchantPaymentConfig` at `cartComplete`; the selection persisted here is the category. Errors: `PAYMENT_METHOD_REQUIRED`, `CART_NOT_FOUND`, `CART_UNAUTHENTICATED`.",
+      "description": "Selects a payment method on the cart by category (`methodType` — BLIK, CARD, BANK_TRANSFER, ...). Optional `preferredProvider` overrides the merchant priority when the buyer explicitly picks a gateway from `PaymentMethod.providersAvailable`. The backend resolves the gateway routing from `MerchantPaymentConfig` at `cartComplete`; the selection persisted here is the category. Errors: `PAYMENT_METHOD_REQUIRED`, `CART_NOT_FOUND`, `CART_UNAUTHENTICATED`.",
       "variables": [
         {
           "name": "input",
@@ -2197,7 +2197,7 @@
         "MailingAddress",
         "PageInfo"
       ],
-      "body": "fragment Cart on Cart {\n  id\n  checkoutUrl\n  totalQuantity\n  cost {\n    ...CartCost\n  }\n  lines(first: 100) {\n    edges {\n      cursor\n      node {\n        ... on CartLine {\n          ...CartLine\n        }\n      }\n    }\n    nodes {\n      ... on CartLine {\n        ...CartLine\n      }\n    }\n    pageInfo {\n      ...PageInfo\n    }\n    totalCount\n  }\n  buyerIdentity {\n    ...CartBuyerIdentity\n  }\n  discountCodes {\n    ...CartDiscountCode\n  }\n  discountAllocations {\n    ...CartDiscountAllocation\n  }\n  note\n  attributes {\n    key\n    value\n  }\n  email\n  phone\n  shippingAddress {\n    ...MailingAddress\n  }\n  billingAddress {\n    ...MailingAddress\n  }\n  selectedShippingMethod {\n    ...CartShippingMethod\n  }\n  selectedPaymentMethod {\n    ...CartSelectedPaymentMethod\n  }\n  selectedPaymentInstrumentCode\n  appliedGiftCards {\n    ...CartAppliedGiftCard\n  }\n  requiresShipping\n  createdAt\n  updatedAt\n  status\n  completedOrder {\n    id\n    orderNumber\n    accessToken\n    status\n    paymentStatus\n    fulfillmentStatus\n  }\n}",
+      "body": "fragment Cart on Cart {\n  id\n  checkoutUrl\n  totalQuantity\n  cost {\n    ...CartCost\n  }\n  lines(first: 100) {\n    edges {\n      cursor\n      node {\n        ... on CartLine {\n          ...CartLine\n        }\n      }\n    }\n    nodes {\n      ... on CartLine {\n        ...CartLine\n      }\n    }\n    pageInfo {\n      ...PageInfo\n    }\n    totalCount\n  }\n  buyerIdentity {\n    ...CartBuyerIdentity\n  }\n  discountCodes {\n    ...CartDiscountCode\n  }\n  discountAllocations {\n    ...CartDiscountAllocation\n  }\n  note\n  attributes {\n    key\n    value\n  }\n  email\n  phone\n  shippingAddress {\n    ...MailingAddress\n  }\n  billingAddress {\n    ...MailingAddress\n  }\n  selectedShippingMethod {\n    ...CartShippingMethod\n  }\n  selectedPaymentMethod {\n    ...CartSelectedPaymentMethod\n  }\n  selectedPaymentInstrument\n  appliedGiftCards {\n    ...CartAppliedGiftCard\n  }\n  requiresShipping\n  createdAt\n  updatedAt\n  status\n  completedOrder {\n    id\n    orderNumber\n    accessToken\n    status\n    paymentStatus\n    fulfillmentStatus\n  }\n}",
       "onType": "Cart"
     },
     {
@@ -2228,10 +2228,12 @@
       "name": "CartSelectedPaymentMethod",
       "kind": "fragment",
       "section": "Cart",
-      "description": "Payment method (integration provider) selected on a cart — id, name, provider code, type category (CARD/BLIK/BANK_TRANSFER/etc.), icon, description, isDefault, supportedCurrencies. Storefront UI używa do iconography + selection display.",
+      "description": "Payment method (integration provider) selected on a cart — id, name, provider code, type category (CARD/BLIK/BANK_TRANSFER/etc.), icon image (transformable), description, isDefault, supportedCurrencies. Storefront UI używa do iconography + selection display.",
       "variables": [],
-      "fragmentRefs": [],
-      "body": "fragment CartSelectedPaymentMethod on PaymentMethod {\n  id\n  name\n  provider\n  type\n  icon\n  description\n  isDefault\n  supportedCurrencies\n  position\n}",
+      "fragmentRefs": [
+        "ImageThumbnail"
+      ],
+      "body": "fragment CartSelectedPaymentMethod on PaymentMethod {\n  id\n  name\n  provider\n  type\n  icon {\n    ...ImageThumbnail\n  }\n  description\n  isDefault\n  supportedCurrencies\n  position\n}",
       "onType": "PaymentMethod"
     },
     {
@@ -2350,25 +2352,28 @@
       "onType": "Shop"
     },
     {
-      "name": "PaymentMethodInstrument",
+      "name": "PaymentInstrument",
       "kind": "fragment",
       "section": "Payment Methods",
-      "description": "A single concrete instrument exposed by a gateway provider (BLIK code, branded bank, wallet, card brand). Pass `instrumentCode` as `preferredInstrumentCode` in `cartSelectPaymentMethod` for direct deep-link to that instrument screen on the gateway. `displayHint` is a semantic UX hint (`PIN_ENTRY`, `WALLET_TAP`, `BANK_LIST`, `CARD_FORM`) — storefront branches rendering accordingly. `enabled: false` means the gateway reported the instrument as temporarily disabled — gray out, don't hide.",
+      "description": "A single concrete instrument exposed by a gateway provider (BLIK code, branded bank, wallet, card brand). Pass `code` as `preferredInstrument` in `cartSelectPaymentMethod` for direct deep-link to that instrument screen on the gateway. `displayHint` is a semantic UX hint (`PROMINENT_BUTTON`, `BRANDED_TILE`, `DROPDOWN_OPTION`, `RADIO_OPTION`) — storefront branches rendering accordingly. `enabled: false` means the gateway reported the instrument as temporarily disabled — gray out, don't hide.",
       "variables": [],
-      "fragmentRefs": [],
-      "body": "fragment PaymentMethodInstrument on PaymentMethodInstrument {\n  providerCode\n  instrumentCode\n  type\n  displayName\n  displayHint\n  brandImageUrl\n  enabled\n}",
-      "onType": "PaymentMethodInstrument"
+      "fragmentRefs": [
+        "ImageThumbnail"
+      ],
+      "body": "fragment PaymentInstrument on PaymentInstrument {\n  provider\n  code\n  type\n  displayName\n  displayHint\n  brandImage {\n    ...ImageThumbnail\n  }\n  enabled\n}",
+      "onType": "PaymentInstrument"
     },
     {
       "name": "PaymentMethod",
       "kind": "fragment",
       "section": "Payment Methods",
-      "description": "Single payment method enabled for the shop — method-centric. `type` is the category (CARD, BLIK, BANK_TRANSFER, CASH_ON_DELIVERY, OTHER) — drive iconography here. `provider`, `providersAvailable`, `preferredProvider` are `ProviderCode` enum (UPPERCASE: `PAYU`, `PRZELEWY24`, ...). `available` is `false` when the resolving gateway is temporarily unavailable or reported the method as disabled — gray-out the tile, don't hide it; `unavailableReason` carries the diagnostic. `instruments` lists concrete gateway-side instruments (BLIK code, branded banks, wallets) when the gateway exposes granular data — pass `instrumentCode` as `preferredInstrumentCode` in `cartSelectPaymentMethod` for direct deep-link to that instrument screen on the gateway. Spread on the checkout payment step.",
+      "description": "Single payment method enabled for the shop — method-centric. `type` is the category (CARD, BLIK, BANK_TRANSFER, INSTALLMENT, WALLET, CASH_ON_DELIVERY, OTHER) — drive iconography here. `provider`, `providersAvailable`, `preferredProvider` are `PaymentProvider` enum (UPPERCASE: `PAYU`, `PRZELEWY24`, ...). `available` is `false` when the resolving gateway is temporarily unavailable or reported the method as disabled — gray-out the tile, don't hide it; `unavailableReason` carries the diagnostic. `instruments` lists concrete gateway-side instruments (BLIK code, branded banks, wallets) when the gateway exposes granular data — pass `code` as `preferredInstrument` in `cartSelectPaymentMethod` for direct deep-link to that instrument screen on the gateway. Spread on the checkout payment step.",
       "variables": [],
       "fragmentRefs": [
-        "PaymentMethodInstrument"
+        "ImageThumbnail",
+        "PaymentInstrument"
       ],
-      "body": "fragment PaymentMethod on PaymentMethod {\n  id\n  name\n  provider\n  type\n  icon\n  description\n  isDefault\n  supportedCurrencies\n  position\n  providersAvailable\n  preferredProvider\n  available\n  unavailableReason\n  instruments {\n    ...PaymentMethodInstrument\n  }\n}",
+      "body": "fragment PaymentMethod on PaymentMethod {\n  id\n  name\n  provider\n  type\n  icon {\n    ...ImageThumbnail\n  }\n  description\n  isDefault\n  supportedCurrencies\n  position\n  providersAvailable\n  preferredProvider\n  available\n  unavailableReason\n  instruments {\n    ...PaymentInstrument\n  }\n}",
       "onType": "PaymentMethod"
     },
     {
@@ -2427,10 +2432,12 @@
       "name": "ShipmentItem",
       "kind": "fragment",
       "section": "Shipments / Tracking",
-      "description": "One item in a shipment — title, variant, sku, quantity, image URL. Spread inside `Shipment.items[]` for the tracking page item list.",
+      "description": "One item in a shipment — title, variant, sku, quantity, live variant image (transformable). Spread inside `Shipment.items[]` for the tracking page item list. `image` is live from the current variant (snapshot fallback when variant has been deleted since fulfillment — returns null, render a placeholder).",
       "variables": [],
-      "fragmentRefs": [],
-      "body": "fragment ShipmentItem on ShipmentItem {\n  id\n  title\n  variantTitle\n  sku\n  quantity\n  imageUrl\n}",
+      "fragmentRefs": [
+        "ImageThumbnail"
+      ],
+      "body": "fragment ShipmentItem on ShipmentItem {\n  id\n  title\n  variantTitle\n  sku\n  quantity\n  image {\n    ...ImageThumbnail\n  }\n}",
       "onType": "ShipmentItem"
     },
     {
@@ -2485,10 +2492,11 @@
       "description": "Single line in a return request — variant identity, quantity requested, reason, condition, photos, status, approved quantity (set by merchant after review). Spread inside `Return.items[]`.",
       "variables": [],
       "fragmentRefs": [
+        "ImageThumbnail",
         "Money",
         "ReturnItemPhoto"
       ],
-      "body": "fragment ReturnItem on ReturnItem {\n  id\n  variantId\n  productTitle\n  variantTitle\n  sku\n  imageUrl\n  quantity\n  reason\n  condition\n  unitPrice {\n    ...Money\n  }\n  photos {\n    ...ReturnItemPhoto\n  }\n  status\n  approvedQuantity\n}",
+      "body": "fragment ReturnItem on ReturnItem {\n  id\n  variantId\n  productTitle\n  variantTitle\n  sku\n  image {\n    ...ImageThumbnail\n  }\n  quantity\n  reason\n  condition\n  unitPrice {\n    ...Money\n  }\n  photos {\n    ...ReturnItemPhoto\n  }\n  status\n  approvedQuantity\n}",
       "onType": "ReturnItem"
     },
     {
@@ -2555,10 +2563,12 @@
       "name": "ShippingCarrier",
       "kind": "fragment",
       "section": "Shipping Methods",
-      "description": "Carrier offering the shipping method — id, display name, logo URL, internal service code.",
+      "description": "Carrier offering the shipping method — id, display name, logo image (transformable), internal service code.",
       "variables": [],
-      "fragmentRefs": [],
-      "body": "fragment ShippingCarrier on ShippingCarrier {\n  id\n  name\n  logoUrl\n  serviceCode\n}",
+      "fragmentRefs": [
+        "ImageThumbnail"
+      ],
+      "body": "fragment ShippingCarrier on ShippingCarrier {\n  id\n  name\n  logo {\n    ...ImageThumbnail\n  }\n  serviceCode\n}",
       "onType": "ShippingCarrier"
     },
     {
@@ -2602,10 +2612,12 @@
       "name": "AttributeSwatch",
       "kind": "fragment",
       "section": "Attribute Filters",
-      "description": "Visual swatch for an attribute filter value — color hex (for color filters) or image URL (for pattern/material swatches).",
+      "description": "Visual swatch for an attribute filter value — color hex (for color filters) or image (for pattern/material swatches).",
       "variables": [],
-      "fragmentRefs": [],
-      "body": "fragment AttributeSwatch on AttributeSwatch {\n  colorHex\n  imageUrl\n}",
+      "fragmentRefs": [
+        "ImageThumbnail"
+      ],
+      "body": "fragment AttributeSwatch on AttributeSwatch {\n  colorHex\n  image {\n    ...ImageThumbnail\n  }\n}",
       "onType": "AttributeSwatch"
     },
     {
@@ -2697,9 +2709,10 @@
       "description": "Loyalty tier definition — name, type enum (`BRONZE` / `SILVER` / `GOLD` / `PLATINUM` / `DIAMOND`), entry threshold (`minPoints` and/or `minAnnualSpend`), points multiplier, custom benefits list. Returned by `loyaltyTiers` and embedded in member tier data.",
       "variables": [],
       "fragmentRefs": [
+        "ImageThumbnail",
         "Money"
       ],
-      "body": "fragment LoyaltyTier on LoyaltyTier {\n  id\n  name\n  type\n  minPoints\n  minAnnualSpend {\n    ...Money\n  }\n  pointsMultiplier\n  customBenefits {\n    name\n    description\n    icon\n  }\n}",
+      "body": "fragment LoyaltyTier on LoyaltyTier {\n  id\n  name\n  type\n  minPoints\n  minAnnualSpend {\n    ...Money\n  }\n  pointsMultiplier\n  customBenefits {\n    name\n    description\n    icon {\n      ...ImageThumbnail\n    }\n  }\n}",
       "onType": "LoyaltyTier"
     },
     {
@@ -2836,8 +2849,10 @@
       "section": "Reviews",
       "description": "Single product review — rating, title, body, optional pros/cons, image attachments, author, verified-purchase flag, helpful/unhelpful counts, optional merchant response. Only `APPROVED` reviews are exposed to the storefront.",
       "variables": [],
-      "fragmentRefs": [],
-      "body": "fragment ProductReview on ProductReview {\n  id\n  productId\n  rating\n  title\n  content\n  pros\n  cons\n  images\n  authorName\n  isVerifiedPurchase\n  helpfulCount\n  unhelpfulCount\n  response\n  responseAt\n  createdAt\n}",
+      "fragmentRefs": [
+        "ImageThumbnail"
+      ],
+      "body": "fragment ProductReview on ProductReview {\n  id\n  productId\n  rating\n  title\n  content\n  pros\n  cons\n  images {\n    ...ImageThumbnail\n  }\n  authorName\n  isVerifiedPurchase\n  helpfulCount\n  unhelpfulCount\n  response\n  responseAt\n  createdAt\n}",
       "onType": "ProductReview"
     },
     {
@@ -3009,9 +3024,10 @@
       "description": "One menu item with up to 3 levels of nested children — title, URL, type (`HTTP` / `FRONTPAGE` / `SEARCH` / `CATALOG` / `BLOG` / `PRODUCT` / `COLLECTION` / `CATEGORY` / `PAGE` / `BRAND`), `resourceId` for typed items, optional image, and a typed `resource` union (Category / Collection / ShopPage / Product / Brand) carrying the linked resource's handle. Two ways to render the link target: (1) use the pre-resolved `url` if your storefront follows the standard `/categories|/collections|/pages|/products|/brands/<handle>` route convention; (2) read `resource.__typename` + the per-type `handle` and build your own paths if your storefront uses different routing. Switch on `type` to decide which static (FRONTPAGE/SEARCH/CATALOG/BLOG) or dynamic target to render.",
       "variables": [],
       "fragmentRefs": [
-        "Image"
+        "Image",
+        "ImageThumbnail"
       ],
-      "body": "fragment MenuItem on MenuItem {\n  id\n  title\n  url\n  type\n  resourceId\n  resource {\n    __typename\n    ... on Category {\n      id\n      handle\n      name\n    }\n    ... on Collection {\n      id\n      handle\n      title\n    }\n    ... on ShopPage {\n      id\n      handle\n      title\n    }\n    ... on Product {\n      id\n      handle\n      title\n    }\n    ... on Brand {\n      id\n      handle\n      name\n      logo\n    }\n  }\n  image {\n    ...Image\n  }\n  items {\n    id\n    title\n    url\n    type\n    resourceId\n    resource {\n      __typename\n      ... on Category {\n        id\n        handle\n        name\n      }\n      ... on Collection {\n        id\n        handle\n        title\n      }\n      ... on ShopPage {\n        id\n        handle\n        title\n      }\n      ... on Product {\n        id\n        handle\n        title\n      }\n      ... on Brand {\n        id\n        handle\n        name\n        logo\n      }\n    }\n    items {\n      id\n      title\n      url\n      type\n      resourceId\n      resource {\n        __typename\n        ... on Category {\n          id\n          handle\n          name\n        }\n        ... on Collection {\n          id\n          handle\n          title\n        }\n        ... on ShopPage {\n          id\n          handle\n          title\n        }\n        ... on Product {\n          id\n          handle\n          title\n        }\n        ... on Brand {\n          id\n          handle\n          name\n          logo\n        }\n      }\n    }\n  }\n}",
+      "body": "fragment MenuItem on MenuItem {\n  id\n  title\n  url\n  type\n  resourceId\n  resource {\n    __typename\n    ... on Category {\n      id\n      handle\n      name\n    }\n    ... on Collection {\n      id\n      handle\n      title\n    }\n    ... on ShopPage {\n      id\n      handle\n      title\n    }\n    ... on Product {\n      id\n      handle\n      title\n    }\n    ... on Brand {\n      id\n      handle\n      name\n      logo {\n        ...ImageThumbnail\n      }\n    }\n  }\n  image {\n    ...Image\n  }\n  items {\n    id\n    title\n    url\n    type\n    resourceId\n    resource {\n      __typename\n      ... on Category {\n        id\n        handle\n        name\n      }\n      ... on Collection {\n        id\n        handle\n        title\n      }\n      ... on ShopPage {\n        id\n        handle\n        title\n      }\n      ... on Product {\n        id\n        handle\n        title\n      }\n      ... on Brand {\n        id\n        handle\n        name\n        logo {\n          ...ImageThumbnail\n        }\n      }\n    }\n    items {\n      id\n      title\n      url\n      type\n      resourceId\n      resource {\n        __typename\n        ... on Category {\n          id\n          handle\n          name\n        }\n        ... on Collection {\n          id\n          handle\n          title\n        }\n        ... on ShopPage {\n          id\n          handle\n          title\n        }\n        ... on Product {\n          id\n          handle\n          title\n        }\n        ... on Brand {\n          id\n          handle\n          name\n          logo {\n            ...ImageThumbnail\n          }\n        }\n      }\n    }\n  }\n}",
       "onType": "MenuItem"
     },
     {