@doswiftly/storefront-operations 7.1.0 → 9.1.0

package/llms-full.txt

@@ -1,7 +1,7 @@
 # DoSwiftly Storefront Operations — Full Reference
 
-> Schema version: **7.1.0**
-> 48 queries · 44 mutations · 108 fragments
+> Schema version: **9.1.0**
+> 48 queries · 44 mutations · 104 fragments
 
 Auto-generated from `.graphql` source files. Do not edit by hand — this file is
 regenerated on every release to match the published schema.
@@ -66,13 +66,13 @@ query Product($id: ID, $handle: String) {
 
 **Variables**:
 - `$handle`: `String!`
-- `$fillingMode`: `String` *(default: `"CUSTOMER"`)*
+- `$fillingMode`: `AttributeFillingMode` *(default: `CUSTOMER`)*
 
 **Fragments used**: `ProductAttributeDefinition`, `ProductFull`
 
 **GraphQL**:
 ```graphql
-query ProductConfigurator($handle: String!, $fillingMode: String = "CUSTOMER") {
+query ProductConfigurator($handle: String!, $fillingMode: AttributeFillingMode = CUSTOMER) {
   product(handle: $handle) {
     ...ProductFull
     attributes(filter: {fillingMode: $fillingMode}) {
@@ -161,7 +161,7 @@ query ProductSearch($query: String!, $first: Int = 20, $after: String, $filters:
 }
 ```
 
-### Query: `PredictiveSearch`
+### Query: `SearchSuggestions`
 
 **Section**: Products
 
@@ -175,8 +175,8 @@ query ProductSearch($query: String!, $first: Int = 20, $after: String, $filters:
 
 **GraphQL**:
 ```graphql
-query PredictiveSearch($query: String!, $limit: Int = 10) {
-  predictiveSearch(query: $query, limit: $limit) {
+query SearchSuggestions($query: String!, $limit: Int = 10) {
+  searchSuggestions(query: $query, limit: $limit) {
     products {
       ...ProductCard
     }
@@ -301,7 +301,7 @@ query Category($id: ID, $slug: String) {
 
 **Section**: Categories
 
-**Description**: Returns active categories for the shop. Each category exposes its `parent` and `children` — build the tree client-side by walking those fields (server batches the lookups, no N+1). The hierarchy is not depth-capped server-side. Use for nav mega-menus and category pages.
+**Description**: Returns active root categories for the shop. Each root exposes its `children` — build the tree client-side by walking those fields (server batches the lookups, no N+1). The hierarchy is not depth-capped server-side. Use for nav mega-menus and category pages.
 
 **Variables**: none
 
@@ -310,8 +310,8 @@ query Category($id: ID, $slug: String) {
 **GraphQL**:
 ```graphql
 query Categories {
-  categories {
-    roots {
+  categories(rootsOnly: true) {
+    nodes {
       ...Category
       children {
         ...Category
@@ -667,7 +667,7 @@ query AvailableShippingMethods($address: ShippingAddressInput!, $cart: CartShipp
 }
 ```
 
-### Query: `AvailableFilters`
+### Query: `ProductFilters`
 
 **Section**: Attribute Filters
 
@@ -680,8 +680,8 @@ query AvailableShippingMethods($address: ShippingAddressInput!, $cart: CartShipp
 
 **GraphQL**:
 ```graphql
-query AvailableFilters($input: AvailableFiltersInput) {
-  availableFilters(input: $input) {
+query ProductFilters($input: AvailableFiltersInput) {
+  productFilters(input: $input) {
     ...AvailableFilters
   }
 }
@@ -1197,7 +1197,9 @@ query ProductStoreAvailability($handle: String, $id: ID) {
     handle
     title
     variants {
-      ...VariantStoreAvailability
+      nodes {
+        ...VariantStoreAvailability
+      }
     }
   }
 }
@@ -1797,25 +1799,22 @@ mutation CheckoutCreate($input: CheckoutCreateInput!) {
 }
 ```
 
-### Mutation: `CheckoutShippingAddressUpdate`
+### Mutation: `CheckoutUpdateShippingAddress`
 
 **Section**: Checkout Mutations
 
-**Description**: Sets the shipping address (full replace, not patch). Triggers cart re-pricing. Address format is NOT validated here — full validation runs at `checkoutComplete` (`validateOrderReadiness`).
+**Description**: Sets the shipping address (full replace, not patch). Triggers cart re-pricing. Address format is NOT validated here — full validation runs at `checkoutComplete`.
 
 **Variables**:
-- `$checkoutId`: `ID!`
+- `$id`: `ID!`
 - `$shippingAddress`: `CheckoutAddressInput!`
 
 **Fragments used**: `Checkout`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutShippingAddressUpdate($checkoutId: ID!, $shippingAddress: CheckoutAddressInput!) {
-  checkoutShippingAddressUpdate(
-    checkoutId: $checkoutId
-    shippingAddress: $shippingAddress
-  ) {
+mutation CheckoutUpdateShippingAddress($id: ID!, $shippingAddress: CheckoutAddressInput!) {
+  checkoutUpdateShippingAddress(id: $id, shippingAddress: $shippingAddress) {
     checkout {
       ...Checkout
     }
@@ -1826,25 +1825,22 @@ mutation CheckoutShippingAddressUpdate($checkoutId: ID!, $shippingAddress: Check
 }
 ```
 
-### Mutation: `CheckoutBillingAddressUpdate`
+### Mutation: `CheckoutUpdateBillingAddress`
 
 **Section**: Checkout Mutations
 
 **Description**: Sets the billing address (full replace). Independent of shipping address — pass it explicitly even when "billing same as shipping".
 
 **Variables**:
-- `$checkoutId`: `ID!`
+- `$id`: `ID!`
 - `$billingAddress`: `CheckoutAddressInput!`
 
 **Fragments used**: `Checkout`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutBillingAddressUpdate($checkoutId: ID!, $billingAddress: CheckoutAddressInput!) {
-  checkoutBillingAddressUpdate(
-    checkoutId: $checkoutId
-    billingAddress: $billingAddress
-  ) {
+mutation CheckoutUpdateBillingAddress($id: ID!, $billingAddress: CheckoutAddressInput!) {
+  checkoutUpdateBillingAddress(id: $id, billingAddress: $billingAddress) {
     checkout {
       ...Checkout
     }
@@ -1855,22 +1851,22 @@ mutation CheckoutBillingAddressUpdate($checkoutId: ID!, $billingAddress: Checkou
 }
 ```
 
-### Mutation: `CheckoutEmailUpdate`
+### Mutation: `CheckoutUpdateEmail`
 
 **Section**: Checkout Mutations
 
 **Description**: Sets or updates the contact email on the checkout (used for guest checkout, order confirmation, and tracking emails). Validated against a regex; returns `INVALID` for malformed format.
 
 **Variables**:
-- `$checkoutId`: `ID!`
+- `$id`: `ID!`
 - `$email`: `String!`
 
 **Fragments used**: `Checkout`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutEmailUpdate($checkoutId: ID!, $email: String!) {
-  checkoutEmailUpdate(checkoutId: $checkoutId, email: $email) {
+mutation CheckoutUpdateEmail($id: ID!, $email: String!) {
+  checkoutUpdateEmail(id: $id, email: $email) {
     checkout {
       ...Checkout
     }
@@ -1881,25 +1877,22 @@ mutation CheckoutEmailUpdate($checkoutId: ID!, $email: String!) {
 }
 ```
 
-### Mutation: `CheckoutShippingLineUpdate`
+### Mutation: `CheckoutSelectShippingRate`
 
 **Section**: Checkout Mutations
 
-**Description**: Selects a shipping method by `shippingRateHandle` (a stable shipping-method UUID, NOT an opaque per-request token). The id comes from `availableShippingMethods` query, computed for the current address + cart subtotal at request time.
+**Description**: Selects a shipping method by `rateId` (a stable shipping-method UUID, NOT an opaque per-request token). The id comes from `availableShippingMethods` query, computed for the current address + cart subtotal at request time.
 
 **Variables**:
-- `$checkoutId`: `ID!`
-- `$shippingRateHandle`: `String!`
+- `$id`: `ID!`
+- `$rateId`: `String!`
 
 **Fragments used**: `Checkout`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutShippingLineUpdate($checkoutId: ID!, $shippingRateHandle: String!) {
-  checkoutShippingLineUpdate(
-    checkoutId: $checkoutId
-    shippingRateHandle: $shippingRateHandle
-  ) {
+mutation CheckoutSelectShippingRate($id: ID!, $rateId: String!) {
+  checkoutSelectShippingRate(id: $id, rateId: $rateId) {
     checkout {
       ...Checkout
     }
@@ -1910,22 +1903,22 @@ mutation CheckoutShippingLineUpdate($checkoutId: ID!, $shippingRateHandle: Strin
 }
 ```
 
-### Mutation: `CheckoutDiscountCodeApply`
+### Mutation: `CheckoutApplyDiscountCode`
 
 **Section**: Checkout Mutations
 
-**Description**: Appends a discount code to the cart's `discount_codes` array. Note: while multiple codes can be stored, the pricing engine currently uses **only the first applied code** — codes do not stack. Validated for existence, active status, and customer usage limits via `discountService.validateDiscount`.
+**Description**: Appends a discount code to the cart's `discount_codes` array. Note: while multiple codes can be stored, the pricing engine currently uses **only the first applied code** — codes do not stack. Validated for existence, active status, and customer usage limits.
 
 **Variables**:
-- `$checkoutId`: `ID!`
+- `$id`: `ID!`
 - `$discountCode`: `String!`
 
 **Fragments used**: `Checkout`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutDiscountCodeApply($checkoutId: ID!, $discountCode: String!) {
-  checkoutDiscountCodeApply(checkoutId: $checkoutId, discountCode: $discountCode) {
+mutation CheckoutApplyDiscountCode($id: ID!, $discountCode: String!) {
+  checkoutApplyDiscountCode(id: $id, discountCode: $discountCode) {
     checkout {
       ...Checkout
     }
@@ -1936,22 +1929,22 @@ mutation CheckoutDiscountCodeApply($checkoutId: ID!, $discountCode: String!) {
 }
 ```
 
-### Mutation: `CheckoutDiscountCodeRemove`
+### Mutation: `CheckoutRemoveDiscountCode`
 
 **Section**: Checkout Mutations
 
 **Description**: Removes a code from the cart's `discount_codes` array (filters by exact match). Triggers re-pricing.
 
 **Variables**:
-- `$checkoutId`: `ID!`
+- `$id`: `ID!`
 - `$discountCode`: `String!`
 
 **Fragments used**: `Checkout`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutDiscountCodeRemove($checkoutId: ID!, $discountCode: String!) {
-  checkoutDiscountCodeRemove(checkoutId: $checkoutId, discountCode: $discountCode) {
+mutation CheckoutRemoveDiscountCode($id: ID!, $discountCode: String!) {
+  checkoutRemoveDiscountCode(id: $id, discountCode: $discountCode) {
     checkout {
       ...Checkout
     }
@@ -1962,25 +1955,22 @@ mutation CheckoutDiscountCodeRemove($checkoutId: ID!, $discountCode: String!) {
 }
 ```
 
-### Mutation: `CheckoutDiscountCodeValidate`
+### Mutation: `CheckoutValidateDiscountCode`
 
 **Section**: Checkout Mutations
 
 **Description**: READ-ONLY validation of a discount code against the current checkout — does NOT modify state. Returns `{ isValid, discount, error }` for previewing the effect (e.g. inline UI feedback as the user types).
 
 **Variables**:
-- `$checkoutId`: `ID!`
+- `$id`: `ID!`
 - `$discountCode`: `String!`
 
 **Fragments used**: `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutDiscountCodeValidate($checkoutId: ID!, $discountCode: String!) {
-  checkoutDiscountCodeValidate(
-    checkoutId: $checkoutId
-    discountCode: $discountCode
-  ) {
+mutation CheckoutValidateDiscountCode($id: ID!, $discountCode: String!) {
+  checkoutValidateDiscountCode(id: $id, discountCode: $discountCode) {
     result {
       isValid
       discount {
@@ -2005,25 +1995,22 @@ mutation CheckoutDiscountCodeValidate($checkoutId: ID!, $discountCode: String!)
 }
 ```
 
-### Mutation: `CheckoutPaymentMethodUpdate`
+### Mutation: `CheckoutSelectPaymentMethod`
 
 **Section**: Checkout Mutations
 
 **Description**: Selects a payment method by `paymentMethodId` (UUID from `availablePaymentMethods` query). Validates existence and active status; no pre-authorization is performed here.
 
 **Variables**:
-- `$checkoutId`: `ID!`
+- `$id`: `ID!`
 - `$paymentMethodId`: `ID!`
 
 **Fragments used**: `Checkout`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutPaymentMethodUpdate($checkoutId: ID!, $paymentMethodId: ID!) {
-  checkoutPaymentMethodUpdate(
-    checkoutId: $checkoutId
-    paymentMethodId: $paymentMethodId
-  ) {
+mutation CheckoutSelectPaymentMethod($id: ID!, $paymentMethodId: ID!) {
+  checkoutSelectPaymentMethod(id: $id, paymentMethodId: $paymentMethodId) {
     checkout {
       ...Checkout
     }
@@ -2038,18 +2025,18 @@ mutation CheckoutPaymentMethodUpdate($checkoutId: ID!, $paymentMethodId: ID!) {
 
 **Section**: Checkout Mutations
 
-**Description**: Finalizes the checkout: creates the `Order`, marks the cart `CONVERTED`, deducts gift cards, emits `ORDER_CREATED` (and `ORDER_CONFIRMED` for COD) — all in a single serializable transaction. **Idempotent on `idempotencyKey`** (NOT on `checkoutId`); auto-generated from `cartId + timestamp` if the caller omits it. The `paymentUrl` field is reserved but is NOT populated here — for hosted gateways (PayU, P24) the storefront calls a separate `paymentCreate` mutation after this returns.
+**Description**: Finalizes the checkout: creates the `Order`, deducts gift cards, sends order-created confirmation — all atomically. **Idempotent on `idempotencyKey`** (NOT on the checkout `id`); auto-generated if the caller omits it. The `paymentUrl` field is reserved but is NOT populated here — for hosted gateways (PayU, P24) the storefront calls a separate `paymentCreate` mutation after this returns.
 
 **Variables**:
-- `$checkoutId`: `ID!`
+- `$id`: `ID!`
 - `$input`: `CheckoutCompleteInput`
 
 **Fragments used**: `Checkout`, `Order`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutComplete($checkoutId: ID!, $input: CheckoutCompleteInput) {
-  checkoutComplete(checkoutId: $checkoutId, input: $input) {
+mutation CheckoutComplete($id: ID!, $input: CheckoutCompleteInput) {
+  checkoutComplete(id: $id, input: $input) {
     checkout {
       ...Checkout
     }
@@ -2064,22 +2051,22 @@ mutation CheckoutComplete($checkoutId: ID!, $input: CheckoutCompleteInput) {
 }
 ```
 
-### Mutation: `CheckoutGiftCardApply`
+### Mutation: `CheckoutApplyGiftCard`
 
 **Section**: Gift Card Checkout Mutations
 
-**Description**: Applies a gift card to the cart, stackable with discount codes. Consumption is FIFO: each card consumes `min(remainingBalance, paymentDue)` against the current cart total in the order they were applied. The gift card balance is NOT debited yet — actual deduction happens atomically inside the `checkoutComplete` transaction. Errors: `GIFT_CARD_NOT_FOUND`, `GIFT_CARD_DEPLETED`, `GIFT_CARD_UNUSABLE`, `GIFT_CARD_ALREADY_APPLIED`.
+**Description**: Applies a gift card to the cart, stackable with discount codes. Consumption is FIFO: each card consumes `min(remainingBalance, paymentDue)` against the current cart total in the order they were applied. The gift card balance is NOT debited yet — actual deduction happens atomically at `checkoutComplete`. Errors: `GIFT_CARD_NOT_FOUND`, `GIFT_CARD_DEPLETED`, `GIFT_CARD_UNUSABLE`, `GIFT_CARD_ALREADY_APPLIED`.
 
 **Variables**:
-- `$checkoutId`: `ID!`
+- `$id`: `ID!`
 - `$giftCardCode`: `String!`
 
 **Fragments used**: `Checkout`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutGiftCardApply($checkoutId: ID!, $giftCardCode: String!) {
-  checkoutGiftCardApply(checkoutId: $checkoutId, giftCardCode: $giftCardCode) {
+mutation CheckoutApplyGiftCard($id: ID!, $giftCardCode: String!) {
+  checkoutApplyGiftCard(id: $id, giftCardCode: $giftCardCode) {
     checkout {
       ...Checkout
     }
@@ -2090,22 +2077,22 @@ mutation CheckoutGiftCardApply($checkoutId: ID!, $giftCardCode: String!) {
 }
 ```
 
-### Mutation: `CheckoutGiftCardRemove`
+### Mutation: `CheckoutRemoveGiftCard`
 
 **Section**: Gift Card Checkout Mutations
 
 **Description**: Removes a gift card from the applied list and recalculates FIFO `appliedAmount` for the remaining cards. Since gift card balances are only debited at `checkoutComplete`, removing before completion has no effect on the underlying gift card balance.
 
 **Variables**:
-- `$checkoutId`: `ID!`
+- `$id`: `ID!`
 - `$giftCardCode`: `String!`
 
 **Fragments used**: `Checkout`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutGiftCardRemove($checkoutId: ID!, $giftCardCode: String!) {
-  checkoutGiftCardRemove(checkoutId: $checkoutId, giftCardCode: $giftCardCode) {
+mutation CheckoutRemoveGiftCard($id: ID!, $giftCardCode: String!) {
+  checkoutRemoveGiftCard(id: $id, giftCardCode: $giftCardCode) {
     checkout {
       ...Checkout
     }
@@ -2116,7 +2103,7 @@ mutation CheckoutGiftCardRemove($checkoutId: ID!, $giftCardCode: String!) {
 }
 ```
 
-### Mutation: `CheckoutGiftCardRecipientUpdate`
+### Mutation: `CheckoutUpdateGiftCardRecipient`
 
 **Section**: Gift Card Checkout Mutations
 
@@ -2129,8 +2116,8 @@ mutation CheckoutGiftCardRemove($checkoutId: ID!, $giftCardCode: String!) {
 
 **GraphQL**:
 ```graphql
-mutation CheckoutGiftCardRecipientUpdate($input: CheckoutGiftCardRecipientInput!) {
-  checkoutGiftCardRecipientUpdate(input: $input) {
+mutation CheckoutUpdateGiftCardRecipient($input: CheckoutGiftCardRecipientInput!) {
+  checkoutUpdateGiftCardRecipient(input: $input) {
     checkout {
       ...Checkout
     }
@@ -2205,7 +2192,7 @@ mutation ReturnCancel($id: ID!) {
 **GraphQL**:
 ```graphql
 mutation RedeemLoyaltyReward($input: RedeemRewardInput!) {
-  redeemLoyaltyReward(input: $input) {
+  loyaltyRedeemReward(input: $input) {
     ...RedeemRewardPayload
   }
 }
@@ -2224,7 +2211,7 @@ mutation RedeemLoyaltyReward($input: RedeemRewardInput!) {
 **GraphQL**:
 ```graphql
 mutation GenerateReferralCode {
-  generateReferralCode {
+  loyaltyGenerateReferralCode {
     ...GenerateReferralCodePayload
   }
 }
@@ -2314,7 +2301,7 @@ mutation ReviewDownvote($reviewId: ID!) {
 **Variables**:
 - `$input`: `WishlistCreateInput!`
 
-**Fragments used**: `Wishlist`
+**Fragments used**: `UserError`, `Wishlist`
 
 **GraphQL**:
 ```graphql
@@ -2323,7 +2310,9 @@ mutation WishlistCreate($input: WishlistCreateInput!) {
     wishlist {
       ...Wishlist
     }
-    userErrors
+    userErrors {
+      ...UserError
+    }
   }
 }
 ```
@@ -2332,22 +2321,24 @@ mutation WishlistCreate($input: WishlistCreateInput!) {
 
 **Section**: Wishlist Mutations
 
-**Description**: Adds an item by `productId` (and optional `variantId`) to a wishlist. Idempotent on the `(wishlist_id, product_id, variant_id)` unique constraint — adding an already-present item is a silent no-op (`ON CONFLICT DO NOTHING`). Captures `priceAtAdd` for price-drop notifications.
+**Description**: Adds an item by `productId` (and optional `variantId`) to a wishlist. Idempotent on the `(wishlist_id, product_id, variant_id)` unique constraint — adding an already-present item is a silent no-op. Captures `priceAtAdd` for price-drop notifications.
 
 **Variables**:
-- `$wishlistId`: `ID!`
+- `$id`: `ID!`
 - `$input`: `WishlistItemInput!`
 
-**Fragments used**: `Wishlist`
+**Fragments used**: `UserError`, `Wishlist`
 
 **GraphQL**:
 ```graphql
-mutation WishlistAddItem($wishlistId: ID!, $input: WishlistItemInput!) {
-  wishlistAddItem(wishlistId: $wishlistId, input: $input) {
+mutation WishlistAddItem($id: ID!, $input: WishlistItemInput!) {
+  wishlistAddItem(id: $id, input: $input) {
     wishlist {
       ...Wishlist
     }
-    userErrors
+    userErrors {
+      ...UserError
+    }
   }
 }
 ```
@@ -2359,19 +2350,21 @@ mutation WishlistAddItem($wishlistId: ID!, $input: WishlistItemInput!) {
 **Description**: Hard-deletes a wishlist item by `itemId` (the `WishlistItem` row id, NOT the product id).
 
 **Variables**:
-- `$wishlistId`: `ID!`
+- `$id`: `ID!`
 - `$itemId`: `ID!`
 
-**Fragments used**: `Wishlist`
+**Fragments used**: `UserError`, `Wishlist`
 
 **GraphQL**:
 ```graphql
-mutation WishlistRemoveItem($wishlistId: ID!, $itemId: ID!) {
-  wishlistRemoveItem(wishlistId: $wishlistId, itemId: $itemId) {
+mutation WishlistRemoveItem($id: ID!, $itemId: ID!) {
+  wishlistRemoveItem(id: $id, itemId: $itemId) {
     wishlist {
       ...Wishlist
     }
-    userErrors
+    userErrors {
+      ...UserError
+    }
   }
 }
 ```
@@ -2380,21 +2373,23 @@ mutation WishlistRemoveItem($wishlistId: ID!, $itemId: ID!) {
 
 **Section**: Wishlist Mutations
 
-**Description**: Hard-deletes the wishlist row. All `WishlistItem` rows are removed via FK cascade. No soft-delete; cannot be undone.
+**Description**: Hard-deletes the wishlist row. All wishlist items are removed via cascade. No soft-delete; cannot be undone.
 
 **Variables**:
-- `$wishlistId`: `ID!`
+- `$id`: `ID!`
 
-**Fragments used**: `Wishlist`
+**Fragments used**: `UserError`, `Wishlist`
 
 **GraphQL**:
 ```graphql
-mutation WishlistDelete($wishlistId: ID!) {
-  wishlistDelete(wishlistId: $wishlistId) {
+mutation WishlistDelete($id: ID!) {
+  wishlistDelete(id: $id) {
     wishlist {
       ...Wishlist
     }
-    userErrors
+    userErrors {
+      ...UserError
+    }
   }
 }
 ```
@@ -2565,41 +2560,6 @@ fragment Money on Money {
 }
 ```
 
-### Fragment: `Price` on `PriceMoney`
-
-**Section**: Common
-
-**Description**: Lightweight price for listing views (cards, grids, search results) — same shape as `Money`. Spread when full conversion metadata is overkill.
-
-**GraphQL**:
-```graphql
-fragment Price on PriceMoney {
-  amount
-  currencyCode
-}
-```
-
-### Fragment: `PriceMoney` on `PriceMoney`
-
-**Section**: Common
-
-**Description**: Full price with currency-conversion transparency — adds `baseAmount`, `baseCurrencyCode`, `exchangeRate`, `marginApplied`, `rateTimestamp`, `isConverted`. Spread on PDP / cart / checkout where the customer needs to see the original price + applied conversion.
-
-**Uses fragments**: `Price`
-
-**GraphQL**:
-```graphql
-fragment PriceMoney on PriceMoney {
-  ...Price
-  baseAmount
-  baseCurrencyCode
-  exchangeRate
-  marginApplied
-  rateTimestamp
-  isConverted
-}
-```
-
 ### Fragment: `SelectedOption` on `SelectedOption`
 
 **Section**: Common
@@ -2666,7 +2626,11 @@ fragment ProductCard on Product {
   handle
   title
   vendor
-  category
+  categories {
+    id
+    slug
+    name
+  }
   isAvailable
   averageRating
   reviewCount
@@ -3390,7 +3354,7 @@ fragment AvailablePaymentMethods on AvailablePaymentMethods {
 
 **Section**: Checkout
 
-**Description**: Single shipping rate option — `handle` is the stable id you pass to `checkoutShippingLineUpdate`, plus title and price.
+**Description**: Single shipping rate option — `handle` is the stable id you pass to `checkoutSelectShippingRate` as `rateId`, plus title and price.
 
 **Uses fragments**: `Money`
 
@@ -4133,7 +4097,7 @@ fragment CategoryFilterOption on CategoryFilterOption {
 
 **Section**: Attribute Filters
 
-**Description**: Full result of the `availableFilters($input)` query — attribute filters, price range, category filters, count of currently active filters, total products matching the context. Spread on listing pages to render filter sidebars.
+**Description**: Full result of the `productFilters($input)` query — attribute filters, price range, category filters, count of currently active filters, total products matching the context. Spread on listing pages to render filter sidebars.
 
 **Uses fragments**: `AttributeDefinition`, `CategoryFilterOption`, `PriceRangeFilter`
 
@@ -4149,8 +4113,8 @@ fragment AvailableFilters on AvailableFilters {
   categories {
     ...CategoryFilterOption
   }
-  activeFilterCount
-  totalProducts
+  activeCount
+  matchCount
 }
 ```
 
@@ -4400,7 +4364,9 @@ fragment ReferralStats on ReferralStats {
 
 **Section**: Loyalty Program
 
-**Description**: Result of `redeemLoyaltyReward` — depending on the reward type, exactly one of `discountCode`, `productDiscountCode`, `giftCardCode` is populated. Apply the returned code on cart/checkout.
+**Description**: Result of `loyaltyRedeemReward` — depending on the reward type, exactly one of `discountCode`, `productDiscountCode`, `giftCardCode` is populated. Apply the returned code on cart/checkout.
+
+**Uses fragments**: `UserError`
 
 **GraphQL**:
 ```graphql
@@ -4409,7 +4375,9 @@ fragment RedeemRewardPayload on RedeemRewardPayload {
   discountCode
   productDiscountCode
   giftCardCode
-  userErrors
+  userErrors {
+    ...UserError
+  }
 }
 ```
 
@@ -4417,7 +4385,9 @@ fragment RedeemRewardPayload on RedeemRewardPayload {
 
 **Section**: Loyalty Program
 
-**Description**: Result of `generateReferralCode` — the customer's referral code and shareable URL.
+**Description**: Result of `loyaltyGenerateReferralCode` — the customer's referral code and shareable URL.
+
+**Uses fragments**: `UserError`
 
 **GraphQL**:
 ```graphql
@@ -4425,7 +4395,9 @@ fragment GenerateReferralCodePayload on GenerateReferralCodePayload {
   success
   referralCode
   shareUrl
-  userErrors
+  userErrors {
+    ...UserError
+  }
 }
 ```
 
@@ -4608,56 +4580,6 @@ fragment BlogPost on BlogPost {
 }
 ```
 
-### Fragment: `ProductRecommendation` on `ProductRecommendation`
-
-**Section**: Recommendations
-
-**Description**: One recommended product — the product itself (card-level), recommendation type (e.g. SIMILAR / FREQUENTLY_BOUGHT_TOGETHER), score (0-100), human reason text. Spread on PDP "You may also like" sections.
-
-**Uses fragments**: `ProductCard`
-
-**GraphQL**:
-```graphql
-fragment ProductRecommendation on ProductRecommendation {
-  product {
-    ...ProductCard
-  }
-  type
-  score
-  reason
-}
-```
-
-### Fragment: `CartRecommendation` on `CartRecommendations`
-
-**Section**: Recommendations
-
-**Description**: Recommendations bundle for the cart drawer — `frequentlyBoughtTogether` (cross-sell) and `youMayAlsoLike` (related). Each entry has the same shape as `ProductRecommendation`.
-
-**Uses fragments**: `ProductCard`
-
-**GraphQL**:
-```graphql
-fragment CartRecommendation on CartRecommendations {
-  frequentlyBoughtTogether {
-    product {
-      ...ProductCard
-    }
-    type
-    score
-    reason
-  }
-  youMayAlsoLike {
-    product {
-      ...ProductCard
-    }
-    type
-    score
-    reason
-  }
-}
-```
-
 ### Fragment: `LocationAddress` on `LocationAddress`
 
 **Section**: Store Availability (BOPIS / multi-location)