@doswiftly/storefront-operations 16.1.0 → 18.0.0

package/mutations.graphql

@@ -329,7 +329,11 @@ mutation CartSelectShippingMethod($input: CartSelectShippingMethodInput!) {
   }
 }
 
-# Selects a payment method by `paymentMethodId` (UUID from `availablePaymentMethods` query). Validates existence + active status; no pre-authorization performed here. Errors: `PAYMENT_METHOD_REQUIRED`, `INVALID_PAYMENT`, `CART_NOT_FOUND`.
+# 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`.
 mutation CartSelectPaymentMethod($input: CartSelectPaymentMethodInput!) {
   cartSelectPaymentMethod(input: $input) {
     cart {
@@ -404,7 +408,7 @@ mutation CartComplete($input: CartCompleteInput!) {
   }
 }
 
-# Initiates a payment session for an order created by `cartComplete` — call this when `order.canCreatePayment` is `true` (orders with an offline payment method like cash-on-delivery skip this step). `orderId` is required; `returnUrl` / `cancelUrl` are optional and, when supplied, must point to a verified domain of the shop (open-redirect protected). Branch on the returned `payment.flow`: `ONLINE_REDIRECT` → redirect to `payment.redirectUrl`, `ONLINE_EMBEDDED` → render a widget with `payment.clientSecret`, `INSTANT_DIRECT` → already settled, read `payment.status`. Public, but ownership-checked — an authenticated customer cannot pay for another customer's order. **Idempotent** — calling it again for the same order returns the existing still-valid session instead of creating a duplicate (safe to retry). Rate limit: 5 requests/minute. `userErrors[].code`: `ORDER_NOT_FOUND`, `ORDER_ALREADY_PAID`, `ORDER_NOT_PAYABLE`, `PAYMENT_PROVIDER_NOT_CONFIGURED`, `RETURN_URL_INVALID`, `INVALID_ID_FORMAT`, `PAYMENT_FAILED`.
+# Initiates a payment session for an order created by `cartComplete` — call this when `order.canCreatePayment` is `true` (orders with an offline payment method like cash-on-delivery skip this step). `orderId` is required; `returnUrl` / `cancelUrl` are optional and, when supplied, must point to a verified domain of the shop (open-redirect protected). Branch on the returned `payment.flow`: `ONLINE_REDIRECT` → redirect to `payment.redirectUrl`, `ONLINE_EMBEDDED` → render a widget with `payment.clientSecret`, `INSTANT_DIRECT` → already settled, read `payment.status`. Public, but ownership-checked — an authenticated customer cannot pay for another customer's order. **Idempotent** — calling it again for the same order returns the existing still-valid session instead of creating a duplicate (safe to retry). Rate limit: 5 requests/minute. `userErrors[].code`: `ORDER_NOT_FOUND`, `ORDER_ALREADY_PAID`, `ORDER_NOT_PAYABLE`, `PAYMENT_PROVIDER_NOT_CONFIGURED`, `RETURN_URL_INVALID`, `INVALID_ID_FORMAT`, `PAYMENT_FAILED`, `INSTRUMENT_PRESELECTION_FAILED`. `warnings[]` array zawiera `INSTRUMENT_CLEARED_FOR_RETRY` post-auto-clear instrument-specific failure (storefront retry hint: next attempt uses gateway default landing).
 mutation PaymentCreate($input: PaymentCreateInput!) {
   paymentCreate(input: $input) {
     payment {
@@ -413,6 +417,24 @@ mutation PaymentCreate($input: PaymentCreateInput!) {
     userErrors {
       ...UserError
     }
+    warnings {
+      ...PaymentWarning
+    }
+  }
+}
+
+# Clears all payment selection state on the cart in a single atomic operation. Use for accordion "back to method picker" flows w storefront UI. Idempotent — calling twice yields the same end state. Cart MUSI być `ACTIVE` (CONVERTED carts reject z `ALREADY_COMPLETED`). Rate limit: 30 requests/minute per IP+shop.
+mutation CartClearPaymentSelection($input: CartClearPaymentSelectionInput!) {
+  cartClearPaymentSelection(input: $input) {
+    cart {
+      ...Cart
+    }
+    userErrors {
+      ...UserError
+    }
+    warnings {
+      ...CartWarning
+    }
   }
 }
 

package/operations.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "16.1.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 by `paymentMethodId` (UUID from `availablePaymentMethods` query). Validates existence + active status; no pre-authorization performed here. Errors: `PAYMENT_METHOD_REQUIRED`, `INVALID_PAYMENT`, `CART_NOT_FOUND`.",
+      "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",
@@ -1613,7 +1613,7 @@
       "name": "PaymentCreate",
       "kind": "mutation",
       "section": "Cart Completion Mutations",
-      "description": "Initiates a payment session for an order created by `cartComplete` — call this when `order.canCreatePayment` is `true` (orders with an offline payment method like cash-on-delivery skip this step). `orderId` is required; `returnUrl` / `cancelUrl` are optional and, when supplied, must point to a verified domain of the shop (open-redirect protected). Branch on the returned `payment.flow`: `ONLINE_REDIRECT` → redirect to `payment.redirectUrl`, `ONLINE_EMBEDDED` → render a widget with `payment.clientSecret`, `INSTANT_DIRECT` → already settled, read `payment.status`. Public, but ownership-checked — an authenticated customer cannot pay for another customer's order. **Idempotent** — calling it again for the same order returns the existing still-valid session instead of creating a duplicate (safe to retry). Rate limit: 5 requests/minute. `userErrors[].code`: `ORDER_NOT_FOUND`, `ORDER_ALREADY_PAID`, `ORDER_NOT_PAYABLE`, `PAYMENT_PROVIDER_NOT_CONFIGURED`, `RETURN_URL_INVALID`, `INVALID_ID_FORMAT`, `PAYMENT_FAILED`.",
+      "description": "Initiates a payment session for an order created by `cartComplete` — call this when `order.canCreatePayment` is `true` (orders with an offline payment method like cash-on-delivery skip this step). `orderId` is required; `returnUrl` / `cancelUrl` are optional and, when supplied, must point to a verified domain of the shop (open-redirect protected). Branch on the returned `payment.flow`: `ONLINE_REDIRECT` → redirect to `payment.redirectUrl`, `ONLINE_EMBEDDED` → render a widget with `payment.clientSecret`, `INSTANT_DIRECT` → already settled, read `payment.status`. Public, but ownership-checked — an authenticated customer cannot pay for another customer's order. **Idempotent** — calling it again for the same order returns the existing still-valid session instead of creating a duplicate (safe to retry). Rate limit: 5 requests/minute. `userErrors[].code`: `ORDER_NOT_FOUND`, `ORDER_ALREADY_PAID`, `ORDER_NOT_PAYABLE`, `PAYMENT_PROVIDER_NOT_CONFIGURED`, `RETURN_URL_INVALID`, `INVALID_ID_FORMAT`, `PAYMENT_FAILED`, `INSTRUMENT_PRESELECTION_FAILED`. `warnings[]` array zawiera `INSTRUMENT_CLEARED_FOR_RETRY` post-auto-clear instrument-specific failure (storefront retry hint: next attempt uses gateway default landing).",
       "variables": [
         {
           "name": "input",
@@ -1623,9 +1623,29 @@
       ],
       "fragmentRefs": [
         "PaymentSession",
+        "PaymentWarning",
         "UserError"
       ],
-      "body": "mutation PaymentCreate($input: PaymentCreateInput!) {\n  paymentCreate(input: $input) {\n    payment {\n      ...PaymentSession\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation PaymentCreate($input: PaymentCreateInput!) {\n  paymentCreate(input: $input) {\n    payment {\n      ...PaymentSession\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...PaymentWarning\n    }\n  }\n}"
+    },
+    {
+      "name": "CartClearPaymentSelection",
+      "kind": "mutation",
+      "section": "Cart Completion Mutations",
+      "description": "Clears all payment selection state on the cart in a single atomic operation. Use for accordion \"back to method picker\" flows w storefront UI. Idempotent — calling twice yields the same end state. Cart MUSI być `ACTIVE` (CONVERTED carts reject z `ALREADY_COMPLETED`). Rate limit: 30 requests/minute per IP+shop.",
+      "variables": [
+        {
+          "name": "input",
+          "type": "CartClearPaymentSelectionInput!",
+          "defaultValue": null
+        }
+      ],
+      "fragmentRefs": [
+        "Cart",
+        "CartWarning",
+        "UserError"
+      ],
+      "body": "mutation CartClearPaymentSelection($input: CartClearPaymentSelectionInput!) {\n  cartClearPaymentSelection(input: $input) {\n    cart {\n      ...Cart\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...CartWarning\n    }\n  }\n}"
     },
     {
       "name": "ReturnCreate",
@@ -2177,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  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"
     },
     {
@@ -2208,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"
     },
     {
@@ -2329,14 +2351,29 @@
       "body": "fragment ShopConfigFields on Shop {\n  currencyCode\n  supportedCurrencies\n  localeToCurrencyMap {\n    locale\n    currency\n  }\n  defaultLanguage\n  supportedLanguages\n  botProtection {\n    ...BotProtection\n  }\n}",
       "onType": "Shop"
     },
+    {
+      "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 `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": [
+        "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 — type (CARD / BANK_TRANSFER / BLIK / PAYPAL / APPLE_PAY / GOOGLE_PAY / CASH_ON_DELIVERY / OTHER), provider, icon, supported currencies, default flag, sort position. 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": [],
-      "body": "fragment PaymentMethod on PaymentMethod {\n  id\n  name\n  provider\n  type\n  icon\n  description\n  isDefault\n  supportedCurrencies\n  position\n}",
+      "fragmentRefs": [
+        "ImageThumbnail",
+        "PaymentInstrument"
+      ],
+      "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"
     },
     {
@@ -2361,6 +2398,16 @@
       "body": "fragment PaymentSession on PaymentSession {\n  id\n  orderId\n  flow\n  provider\n  redirectUrl\n  clientSecret\n  status\n  expiresAt\n}",
       "onType": "PaymentSession"
     },
+    {
+      "name": "PaymentWarning",
+      "kind": "fragment",
+      "section": "Payment Methods",
+      "description": "Non-blocking signal emitted alongside `userErrors[]` in `paymentCreate` payload — backend state change context (e.g. an auto-clear of preselected instrument after gateway rejection). Pre-translated by backend per shop locale. `code === 'INSTRUMENT_CLEARED_FOR_RETRY'` signals storefront that the next `paymentCreate` will land on the gateway default landing page (server-side cleared `Order.paymentInstrumentCode` after `INSTRUMENT_PRESELECTION_FAILED`). `retryHint` is optional context for UI dispatch — currently unused for `INSTRUMENT_CLEARED_FOR_RETRY`, reserved for future warning codes.",
+      "variables": [],
+      "fragmentRefs": [],
+      "body": "fragment PaymentWarning on PaymentWarning {\n  message\n  code\n  retryHint\n}",
+      "onType": "PaymentWarning"
+    },
     {
       "name": "ShipmentEvent",
       "kind": "fragment",
@@ -2385,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"
     },
     {
@@ -2443,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"
     },
     {
@@ -2513,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"
     },
     {
@@ -2560,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"
     },
     {
@@ -2655,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"
     },
     {
@@ -2794,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"
     },
     {
@@ -2967,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"
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doswiftly/storefront-operations",
-  "version": "16.1.0",
+  "version": "18.0.0",
   "description": "GraphQL operations for DoSwiftly Storefront - SSOT from backend",
   "homepage": "https://doswiftly.pl",
   "publishConfig": {
@@ -12,6 +12,7 @@
     "./queries.graphql": "./queries.graphql",
     "./mutations.graphql": "./mutations.graphql",
     "./fragments.graphql": "./fragments.graphql",
+    "./operations.json": "./operations.json",
     "./*.graphql": "./*.graphql"
   },
   "devDependencies": {
@@ -41,6 +42,7 @@
     "sync": "node scripts/sync-operations.js",
     "validate": "node scripts/validate-operations.js",
     "build": "npm run sync",
-    "test": "node --test scripts/__tests__/*.test.js"
+    "test": "node --test scripts/__tests__/*.test.js",
+    "yalc:push": "yalc publish --push"
   }
 }