@doswiftly/storefront-operations 7.1.0 → 8.0.0

package/operations.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "7.1.0",
+  "schemaVersion": "8.0.0",
   "queries": [
     {
       "name": "Shop",
@@ -47,15 +47,15 @@
         },
         {
           "name": "fillingMode",
-          "type": "String",
-          "defaultValue": "\"CUSTOMER\""
+          "type": "AttributeFillingMode",
+          "defaultValue": "CUSTOMER"
         }
       ],
       "fragmentRefs": [
         "ProductAttributeDefinition",
         "ProductFull"
       ],
-      "body": "query ProductConfigurator($handle: String!, $fillingMode: String = \"CUSTOMER\") {\n  product(handle: $handle) {\n    ...ProductFull\n    attributes(filter: {fillingMode: $fillingMode}) {\n      ...ProductAttributeDefinition\n    }\n  }\n}"
+      "body": "query ProductConfigurator($handle: String!, $fillingMode: AttributeFillingMode = CUSTOMER) {\n  product(handle: $handle) {\n    ...ProductFull\n    attributes(filter: {fillingMode: $fillingMode}) {\n      ...ProductAttributeDefinition\n    }\n  }\n}"
     },
     {
       "name": "Products",
@@ -134,7 +134,7 @@
       "body": "query ProductSearch($query: String!, $first: Int = 20, $after: String, $filters: [ProductFilter!]) {\n  products(query: $query, first: $first, after: $after, filters: $filters) {\n    edges {\n      node {\n        ...ProductCard\n      }\n      cursor\n    }\n    nodes {\n      ...ProductCard\n    }\n    pageInfo {\n      ...PageInfo\n    }\n    totalCount\n  }\n}"
     },
     {
-      "name": "PredictiveSearch",
+      "name": "SearchSuggestions",
       "kind": "query",
       "section": "Products",
       "description": "Type-ahead suggestions for the storefront search input. Returns up to `$limit` matching products (hard cap 50) plus up to 5 styled query suggestions with `<mark>` tags around matched spans. Polish-language aware (handles morphology in suggestions). Run on each keystroke (debounce 200-300ms). The `$query` is capped at 100 characters server-side.",
@@ -153,7 +153,7 @@
       "fragmentRefs": [
         "ProductCard"
       ],
-      "body": "query PredictiveSearch($query: String!, $limit: Int = 10) {\n  predictiveSearch(query: $query, limit: $limit) {\n    products {\n      ...ProductCard\n    }\n    queries {\n      text\n      styledText\n    }\n  }\n}"
+      "body": "query SearchSuggestions($query: String!, $limit: Int = 10) {\n  searchSuggestions(query: $query, limit: $limit) {\n    products {\n      ...ProductCard\n    }\n    queries {\n      text\n      styledText\n    }\n  }\n}"
     },
     {
       "name": "Collection",
@@ -258,12 +258,12 @@
       "name": "Categories",
       "kind": "query",
       "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": [],
       "fragmentRefs": [
         "Category"
       ],
-      "body": "query Categories {\n  categories {\n    roots {\n      ...Category\n      children {\n        ...Category\n        children {\n          ...Category\n        }\n      }\n    }\n    totalCount\n  }\n}"
+      "body": "query Categories {\n  categories(rootsOnly: true) {\n    nodes {\n      ...Category\n      children {\n        ...Category\n        children {\n          ...Category\n        }\n      }\n    }\n    totalCount\n  }\n}"
     },
     {
       "name": "Cart",
@@ -500,7 +500,7 @@
       "body": "query AvailableShippingMethods($address: ShippingAddressInput!, $cart: CartShippingInput) {\n  availableShippingMethods(address: $address, cart: $cart) {\n    methods {\n      ...AvailableShippingMethod\n    }\n    freeShippingProgress {\n      ...FreeShippingProgress\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "AvailableFilters",
+      "name": "ProductFilters",
       "kind": "query",
       "section": "Attribute Filters",
       "description": "Returns the dynamic facet filters available for a listing context — pass `collectionId`, `categoryId`, or `searchQuery`. For each visible & filterable attribute, returns either discrete value counts (for `SELECT` / `CHECKBOX` types) or numeric range bounds (for `SLIDER` types). Plus `priceRange`, per-category counts, `activeCount` (length of `currentFilters` input), and `matchCount` (total products in the context). Use to render filter sidebars on listing/search pages.",
@@ -514,7 +514,7 @@
       "fragmentRefs": [
         "AvailableFilters"
       ],
-      "body": "query AvailableFilters($input: AvailableFiltersInput) {\n  availableFilters(input: $input) {\n    ...AvailableFilters\n  }\n}"
+      "body": "query ProductFilters($input: AvailableFiltersInput) {\n  productFilters(input: $input) {\n    ...AvailableFilters\n  }\n}"
     },
     {
       "name": "LoyaltyMember",
@@ -944,7 +944,7 @@
       "fragmentRefs": [
         "VariantStoreAvailability"
       ],
-      "body": "query ProductStoreAvailability($handle: String, $id: ID) {\n  product(handle: $handle, id: $id) {\n    id\n    handle\n    title\n    variants {\n      ...VariantStoreAvailability\n    }\n  }\n}"
+      "body": "query ProductStoreAvailability($handle: String, $id: ID) {\n  product(handle: $handle, id: $id) {\n    id\n    handle\n    title\n    variants {\n      nodes {\n        ...VariantStoreAvailability\n      }\n    }\n  }\n}"
     },
     {
       "name": "Locations",
@@ -1404,13 +1404,13 @@
       "body": "mutation CheckoutCreate($input: CheckoutCreateInput!) {\n  checkoutCreate(input: $input) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutShippingAddressUpdate",
+      "name": "CheckoutUpdateShippingAddress",
       "kind": "mutation",
       "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": [
         {
-          "name": "checkoutId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
@@ -1424,16 +1424,16 @@
         "Checkout",
         "UserError"
       ],
-      "body": "mutation CheckoutShippingAddressUpdate($checkoutId: ID!, $shippingAddress: CheckoutAddressInput!) {\n  checkoutShippingAddressUpdate(\n    checkoutId: $checkoutId\n    shippingAddress: $shippingAddress\n  ) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CheckoutUpdateShippingAddress($id: ID!, $shippingAddress: CheckoutAddressInput!) {\n  checkoutUpdateShippingAddress(id: $id, shippingAddress: $shippingAddress) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutBillingAddressUpdate",
+      "name": "CheckoutUpdateBillingAddress",
       "kind": "mutation",
       "section": "Checkout Mutations",
       "description": "Sets the billing address (full replace). Independent of shipping address — pass it explicitly even when \"billing same as shipping\".",
       "variables": [
         {
-          "name": "checkoutId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
@@ -1447,16 +1447,16 @@
         "Checkout",
         "UserError"
       ],
-      "body": "mutation CheckoutBillingAddressUpdate($checkoutId: ID!, $billingAddress: CheckoutAddressInput!) {\n  checkoutBillingAddressUpdate(\n    checkoutId: $checkoutId\n    billingAddress: $billingAddress\n  ) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CheckoutUpdateBillingAddress($id: ID!, $billingAddress: CheckoutAddressInput!) {\n  checkoutUpdateBillingAddress(id: $id, billingAddress: $billingAddress) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutEmailUpdate",
+      "name": "CheckoutUpdateEmail",
       "kind": "mutation",
       "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": [
         {
-          "name": "checkoutId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
@@ -1470,21 +1470,21 @@
         "Checkout",
         "UserError"
       ],
-      "body": "mutation CheckoutEmailUpdate($checkoutId: ID!, $email: String!) {\n  checkoutEmailUpdate(checkoutId: $checkoutId, email: $email) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CheckoutUpdateEmail($id: ID!, $email: String!) {\n  checkoutUpdateEmail(id: $id, email: $email) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutShippingLineUpdate",
+      "name": "CheckoutSelectShippingRate",
       "kind": "mutation",
       "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": [
         {
-          "name": "checkoutId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
         {
-          "name": "shippingRateHandle",
+          "name": "rateId",
           "type": "String!",
           "defaultValue": null
         }
@@ -1493,16 +1493,16 @@
         "Checkout",
         "UserError"
       ],
-      "body": "mutation CheckoutShippingLineUpdate($checkoutId: ID!, $shippingRateHandle: String!) {\n  checkoutShippingLineUpdate(\n    checkoutId: $checkoutId\n    shippingRateHandle: $shippingRateHandle\n  ) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CheckoutSelectShippingRate($id: ID!, $rateId: String!) {\n  checkoutSelectShippingRate(id: $id, rateId: $rateId) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutDiscountCodeApply",
+      "name": "CheckoutApplyDiscountCode",
       "kind": "mutation",
       "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": [
         {
-          "name": "checkoutId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
@@ -1516,16 +1516,16 @@
         "Checkout",
         "UserError"
       ],
-      "body": "mutation CheckoutDiscountCodeApply($checkoutId: ID!, $discountCode: String!) {\n  checkoutDiscountCodeApply(checkoutId: $checkoutId, discountCode: $discountCode) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CheckoutApplyDiscountCode($id: ID!, $discountCode: String!) {\n  checkoutApplyDiscountCode(id: $id, discountCode: $discountCode) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutDiscountCodeRemove",
+      "name": "CheckoutRemoveDiscountCode",
       "kind": "mutation",
       "section": "Checkout Mutations",
       "description": "Removes a code from the cart's `discount_codes` array (filters by exact match). Triggers re-pricing.",
       "variables": [
         {
-          "name": "checkoutId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
@@ -1539,16 +1539,16 @@
         "Checkout",
         "UserError"
       ],
-      "body": "mutation CheckoutDiscountCodeRemove($checkoutId: ID!, $discountCode: String!) {\n  checkoutDiscountCodeRemove(checkoutId: $checkoutId, discountCode: $discountCode) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CheckoutRemoveDiscountCode($id: ID!, $discountCode: String!) {\n  checkoutRemoveDiscountCode(id: $id, discountCode: $discountCode) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutDiscountCodeValidate",
+      "name": "CheckoutValidateDiscountCode",
       "kind": "mutation",
       "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": [
         {
-          "name": "checkoutId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
@@ -1561,16 +1561,16 @@
       "fragmentRefs": [
         "UserError"
       ],
-      "body": "mutation CheckoutDiscountCodeValidate($checkoutId: ID!, $discountCode: String!) {\n  checkoutDiscountCodeValidate(\n    checkoutId: $checkoutId\n    discountCode: $discountCode\n  ) {\n    result {\n      isValid\n      discount {\n        code\n        title\n        type\n        value\n        discountAmount {\n          amount\n          currencyCode\n        }\n      }\n      error {\n        code\n        message\n      }\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CheckoutValidateDiscountCode($id: ID!, $discountCode: String!) {\n  checkoutValidateDiscountCode(id: $id, discountCode: $discountCode) {\n    result {\n      isValid\n      discount {\n        code\n        title\n        type\n        value\n        discountAmount {\n          amount\n          currencyCode\n        }\n      }\n      error {\n        code\n        message\n      }\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutPaymentMethodUpdate",
+      "name": "CheckoutSelectPaymentMethod",
       "kind": "mutation",
       "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": [
         {
-          "name": "checkoutId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
@@ -1584,16 +1584,16 @@
         "Checkout",
         "UserError"
       ],
-      "body": "mutation CheckoutPaymentMethodUpdate($checkoutId: ID!, $paymentMethodId: ID!) {\n  checkoutPaymentMethodUpdate(\n    checkoutId: $checkoutId\n    paymentMethodId: $paymentMethodId\n  ) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CheckoutSelectPaymentMethod($id: ID!, $paymentMethodId: ID!) {\n  checkoutSelectPaymentMethod(id: $id, paymentMethodId: $paymentMethodId) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
       "name": "CheckoutComplete",
       "kind": "mutation",
       "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": [
         {
-          "name": "checkoutId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
@@ -1608,16 +1608,16 @@
         "Order",
         "UserError"
       ],
-      "body": "mutation CheckoutComplete($checkoutId: ID!, $input: CheckoutCompleteInput) {\n  checkoutComplete(checkoutId: $checkoutId, input: $input) {\n    checkout {\n      ...Checkout\n    }\n    order {\n      ...Order\n    }\n    paymentUrl\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CheckoutComplete($id: ID!, $input: CheckoutCompleteInput) {\n  checkoutComplete(id: $id, input: $input) {\n    checkout {\n      ...Checkout\n    }\n    order {\n      ...Order\n    }\n    paymentUrl\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutGiftCardApply",
+      "name": "CheckoutApplyGiftCard",
       "kind": "mutation",
       "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": [
         {
-          "name": "checkoutId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
@@ -1631,16 +1631,16 @@
         "Checkout",
         "UserError"
       ],
-      "body": "mutation CheckoutGiftCardApply($checkoutId: ID!, $giftCardCode: String!) {\n  checkoutGiftCardApply(checkoutId: $checkoutId, giftCardCode: $giftCardCode) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CheckoutApplyGiftCard($id: ID!, $giftCardCode: String!) {\n  checkoutApplyGiftCard(id: $id, giftCardCode: $giftCardCode) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutGiftCardRemove",
+      "name": "CheckoutRemoveGiftCard",
       "kind": "mutation",
       "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": [
         {
-          "name": "checkoutId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
@@ -1654,10 +1654,10 @@
         "Checkout",
         "UserError"
       ],
-      "body": "mutation CheckoutGiftCardRemove($checkoutId: ID!, $giftCardCode: String!) {\n  checkoutGiftCardRemove(checkoutId: $checkoutId, giftCardCode: $giftCardCode) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CheckoutRemoveGiftCard($id: ID!, $giftCardCode: String!) {\n  checkoutRemoveGiftCard(id: $id, giftCardCode: $giftCardCode) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutGiftCardRecipientUpdate",
+      "name": "CheckoutUpdateGiftCardRecipient",
       "kind": "mutation",
       "section": "Gift Card Checkout Mutations",
       "description": "Sets per-line-item recipient details (name, email, message, delivery date) for digital gift card products in the cart (variants with `type: GIFT_CARD`). Required before `checkoutComplete` for any line item with a gift-card variant. Recipient details are associated with each gift-card line item and propagated to the resulting order.",
@@ -1672,7 +1672,7 @@
         "Checkout",
         "UserError"
       ],
-      "body": "mutation CheckoutGiftCardRecipientUpdate($input: CheckoutGiftCardRecipientInput!) {\n  checkoutGiftCardRecipientUpdate(input: $input) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CheckoutUpdateGiftCardRecipient($input: CheckoutGiftCardRecipientInput!) {\n  checkoutUpdateGiftCardRecipient(input: $input) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
       "name": "ReturnCreate",
@@ -1725,7 +1725,7 @@
       "fragmentRefs": [
         "RedeemRewardPayload"
       ],
-      "body": "mutation RedeemLoyaltyReward($input: RedeemRewardInput!) {\n  redeemLoyaltyReward(input: $input) {\n    ...RedeemRewardPayload\n  }\n}"
+      "body": "mutation RedeemLoyaltyReward($input: RedeemRewardInput!) {\n  loyaltyRedeemReward(input: $input) {\n    ...RedeemRewardPayload\n  }\n}"
     },
     {
       "name": "GenerateReferralCode",
@@ -1736,7 +1736,7 @@
       "fragmentRefs": [
         "GenerateReferralCodePayload"
       ],
-      "body": "mutation GenerateReferralCode {\n  generateReferralCode {\n    ...GenerateReferralCodePayload\n  }\n}"
+      "body": "mutation GenerateReferralCode {\n  loyaltyGenerateReferralCode {\n    ...GenerateReferralCodePayload\n  }\n}"
     },
     {
       "name": "ReviewCreate",
@@ -1805,18 +1805,19 @@
         }
       ],
       "fragmentRefs": [
+        "UserError",
         "Wishlist"
       ],
-      "body": "mutation WishlistCreate($input: WishlistCreateInput!) {\n  wishlistCreate(input: $input) {\n    wishlist {\n      ...Wishlist\n    }\n    userErrors\n  }\n}"
+      "body": "mutation WishlistCreate($input: WishlistCreateInput!) {\n  wishlistCreate(input: $input) {\n    wishlist {\n      ...Wishlist\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
       "name": "WishlistAddItem",
       "kind": "mutation",
       "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": [
         {
-          "name": "wishlistId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
@@ -1827,9 +1828,10 @@
         }
       ],
       "fragmentRefs": [
+        "UserError",
         "Wishlist"
       ],
-      "body": "mutation WishlistAddItem($wishlistId: ID!, $input: WishlistItemInput!) {\n  wishlistAddItem(wishlistId: $wishlistId, input: $input) {\n    wishlist {\n      ...Wishlist\n    }\n    userErrors\n  }\n}"
+      "body": "mutation WishlistAddItem($id: ID!, $input: WishlistItemInput!) {\n  wishlistAddItem(id: $id, input: $input) {\n    wishlist {\n      ...Wishlist\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
       "name": "WishlistRemoveItem",
@@ -1838,7 +1840,7 @@
       "description": "Hard-deletes a wishlist item by `itemId` (the `WishlistItem` row id, NOT the product id).",
       "variables": [
         {
-          "name": "wishlistId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         },
@@ -1849,26 +1851,28 @@
         }
       ],
       "fragmentRefs": [
+        "UserError",
         "Wishlist"
       ],
-      "body": "mutation WishlistRemoveItem($wishlistId: ID!, $itemId: ID!) {\n  wishlistRemoveItem(wishlistId: $wishlistId, itemId: $itemId) {\n    wishlist {\n      ...Wishlist\n    }\n    userErrors\n  }\n}"
+      "body": "mutation WishlistRemoveItem($id: ID!, $itemId: ID!) {\n  wishlistRemoveItem(id: $id, itemId: $itemId) {\n    wishlist {\n      ...Wishlist\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
       "name": "WishlistDelete",
       "kind": "mutation",
       "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": [
         {
-          "name": "wishlistId",
+          "name": "id",
           "type": "ID!",
           "defaultValue": null
         }
       ],
       "fragmentRefs": [
+        "UserError",
         "Wishlist"
       ],
-      "body": "mutation WishlistDelete($wishlistId: ID!) {\n  wishlistDelete(wishlistId: $wishlistId) {\n    wishlist {\n      ...Wishlist\n    }\n    userErrors\n  }\n}"
+      "body": "mutation WishlistDelete($id: ID!) {\n  wishlistDelete(id: $id) {\n    wishlist {\n      ...Wishlist\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
       "name": "CartUpdateAttributes",
@@ -1976,28 +1980,6 @@
       "body": "fragment Money on Money {\n  amount\n  currencyCode\n}",
       "onType": "Money"
     },
-    {
-      "name": "Price",
-      "kind": "fragment",
-      "section": "Common",
-      "description": "Lightweight price for listing views (cards, grids, search results) — same shape as `Money`. Spread when full conversion metadata is overkill.",
-      "variables": [],
-      "fragmentRefs": [],
-      "body": "fragment Price on PriceMoney {\n  amount\n  currencyCode\n}",
-      "onType": "PriceMoney"
-    },
-    {
-      "name": "PriceMoney",
-      "kind": "fragment",
-      "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.",
-      "variables": [],
-      "fragmentRefs": [
-        "Price"
-      ],
-      "body": "fragment PriceMoney on PriceMoney {\n  ...Price\n  baseAmount\n  baseCurrencyCode\n  exchangeRate\n  marginApplied\n  rateTimestamp\n  isConverted\n}",
-      "onType": "PriceMoney"
-    },
     {
       "name": "SelectedOption",
       "kind": "fragment",
@@ -2032,7 +2014,7 @@
         "ImageCard",
         "Money"
       ],
-      "body": "fragment ProductCard on Product {\n  id\n  handle\n  title\n  vendor\n  category\n  isAvailable\n  averageRating\n  reviewCount\n  tags\n  featuredImage {\n    ...ImageCard\n  }\n  priceRange {\n    minVariantPrice {\n      ...Money\n    }\n    maxVariantPrice {\n      ...Money\n    }\n  }\n  compareAtPriceRange {\n    minVariantPrice {\n      ...Money\n    }\n    maxVariantPrice {\n      ...Money\n    }\n  }\n}",
+      "body": "fragment ProductCard on Product {\n  id\n  handle\n  title\n  vendor\n  categories {\n    id\n    slug\n    name\n  }\n  isAvailable\n  averageRating\n  reviewCount\n  tags\n  featuredImage {\n    ...ImageCard\n  }\n  priceRange {\n    minVariantPrice {\n      ...Money\n    }\n    maxVariantPrice {\n      ...Money\n    }\n  }\n  compareAtPriceRange {\n    minVariantPrice {\n      ...Money\n    }\n    maxVariantPrice {\n      ...Money\n    }\n  }\n}",
       "onType": "Product"
     },
     {
@@ -2358,7 +2340,7 @@
       "name": "ShippingRate",
       "kind": "fragment",
       "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.",
       "variables": [],
       "fragmentRefs": [
         "Money"
@@ -2725,14 +2707,14 @@
       "name": "AvailableFilters",
       "kind": "fragment",
       "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.",
       "variables": [],
       "fragmentRefs": [
         "AttributeDefinition",
         "CategoryFilterOption",
         "PriceRangeFilter"
       ],
-      "body": "fragment AvailableFilters on AvailableFilters {\n  attributes {\n    ...AttributeDefinition\n  }\n  priceRange {\n    ...PriceRangeFilter\n  }\n  categories {\n    ...CategoryFilterOption\n  }\n  activeFilterCount\n  totalProducts\n}",
+      "body": "fragment AvailableFilters on AvailableFilters {\n  attributes {\n    ...AttributeDefinition\n  }\n  priceRange {\n    ...PriceRangeFilter\n  }\n  categories {\n    ...CategoryFilterOption\n  }\n  activeCount\n  matchCount\n}",
       "onType": "AvailableFilters"
     },
     {
@@ -2865,20 +2847,24 @@
       "name": "RedeemRewardPayload",
       "kind": "fragment",
       "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.",
       "variables": [],
-      "fragmentRefs": [],
-      "body": "fragment RedeemRewardPayload on RedeemRewardPayload {\n  success\n  discountCode\n  productDiscountCode\n  giftCardCode\n  userErrors\n}",
+      "fragmentRefs": [
+        "UserError"
+      ],
+      "body": "fragment RedeemRewardPayload on RedeemRewardPayload {\n  success\n  discountCode\n  productDiscountCode\n  giftCardCode\n  userErrors {\n    ...UserError\n  }\n}",
       "onType": "RedeemRewardPayload"
     },
     {
       "name": "GenerateReferralCodePayload",
       "kind": "fragment",
       "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.",
       "variables": [],
-      "fragmentRefs": [],
-      "body": "fragment GenerateReferralCodePayload on GenerateReferralCodePayload {\n  success\n  referralCode\n  shareUrl\n  userErrors\n}",
+      "fragmentRefs": [
+        "UserError"
+      ],
+      "body": "fragment GenerateReferralCodePayload on GenerateReferralCodePayload {\n  success\n  referralCode\n  shareUrl\n  userErrors {\n    ...UserError\n  }\n}",
       "onType": "GenerateReferralCodePayload"
     },
     {
@@ -2961,30 +2947,6 @@
       "body": "fragment BlogPost on BlogPost {\n  id\n  title\n  slug\n  excerpt\n  content\n  contentFormat\n  featuredImage {\n    ...ImageCard\n  }\n  author {\n    id\n    name\n    bio\n    avatar {\n      ...ImageThumbnail\n    }\n  }\n  category {\n    ...BlogCategory\n  }\n  tags {\n    ...BlogTag\n  }\n  publishedAt\n  readingTimeMinutes\n  viewCount\n  commentCount\n  allowComments\n  isFeatured\n  status\n  seo {\n    title\n    description\n  }\n  createdAt\n  updatedAt\n}",
       "onType": "BlogPost"
     },
-    {
-      "name": "ProductRecommendation",
-      "kind": "fragment",
-      "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.",
-      "variables": [],
-      "fragmentRefs": [
-        "ProductCard"
-      ],
-      "body": "fragment ProductRecommendation on ProductRecommendation {\n  product {\n    ...ProductCard\n  }\n  type\n  score\n  reason\n}",
-      "onType": "ProductRecommendation"
-    },
-    {
-      "name": "CartRecommendation",
-      "kind": "fragment",
-      "section": "Recommendations",
-      "description": "Recommendations bundle for the cart drawer — `frequentlyBoughtTogether` (cross-sell) and `youMayAlsoLike` (related). Each entry has the same shape as `ProductRecommendation`.",
-      "variables": [],
-      "fragmentRefs": [
-        "ProductCard"
-      ],
-      "body": "fragment CartRecommendation on CartRecommendations {\n  frequentlyBoughtTogether {\n    product {\n      ...ProductCard\n    }\n    type\n    score\n    reason\n  }\n  youMayAlsoLike {\n    product {\n      ...ProductCard\n    }\n    type\n    score\n    reason\n  }\n}",
-      "onType": "CartRecommendations"
-    },
     {
       "name": "LocationAddress",
       "kind": "fragment",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doswiftly/storefront-operations",
-  "version": "7.1.0",
+  "version": "8.0.0",
   "description": "GraphQL operations for DoSwiftly Storefront - SSOT from backend",
   "homepage": "https://doswiftly.pl",
   "publishConfig": {
@@ -39,6 +39,7 @@
   ],
   "scripts": {
     "sync": "node scripts/sync-operations.js",
+    "validate": "node scripts/validate-operations.js",
     "build": "npm run sync",
     "test": "node --test scripts/__tests__/*.test.js"
   }

package/queries.graphql

@@ -26,7 +26,7 @@ query Product($id: ID, $handle: String) {
 }
 
 # Fetches a product together with its filtered attribute definitions, optimized for the configurator UI (e.g. customer-facing text fields, finishing options, scoped variants). `fillingMode: "CUSTOMER"` returns only customer-facing attributes; pass `"BOTH"` to also include attributes shared with the merchant admin. Single round-trip — saves a separate `attributes` query.
-query ProductConfigurator($handle: String!, $fillingMode: String = "CUSTOMER") {
+query ProductConfigurator($handle: String!, $fillingMode: AttributeFillingMode = CUSTOMER) {
   product(handle: $handle) {
     ...ProductFull
     attributes(filter: { fillingMode: $fillingMode }) {
@@ -81,8 +81,8 @@ query ProductSearch($query: String!, $first: Int = 20, $after: String, $filters:
 }
 
 # Type-ahead suggestions for the storefront search input. Returns up to `$limit` matching products (hard cap 50) plus up to 5 styled query suggestions with `<mark>` tags around matched spans. Polish-language aware (handles morphology in suggestions). Run on each keystroke (debounce 200-300ms). The `$query` is capped at 100 characters server-side.
-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
     }
@@ -152,10 +152,10 @@ query Category($id: ID, $slug: String) {
   }
 }
 
-# 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.
+# 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.
 query Categories {
-  categories {
-    roots {
+  categories(rootsOnly: true) {
+    nodes {
       ...Category
       children {
         ...Category
@@ -367,8 +367,8 @@ query AvailableShippingMethods($address: ShippingAddressInput!, $cart: CartShipp
 # ============================================
 
 # Returns the dynamic facet filters available for a listing context — pass `collectionId`, `categoryId`, or `searchQuery`. For each visible & filterable attribute, returns either discrete value counts (for `SELECT` / `CHECKBOX` types) or numeric range bounds (for `SLIDER` types). Plus `priceRange`, per-category counts, `activeCount` (length of `currentFilters` input), and `matchCount` (total products in the context). Use to render filter sidebars on listing/search pages.
-query AvailableFilters($input: AvailableFiltersInput) {
-  availableFilters(input: $input) {
+query ProductFilters($input: AvailableFiltersInput) {
+  productFilters(input: $input) {
     ...AvailableFilters
   }
 }
@@ -612,7 +612,9 @@ query ProductStoreAvailability($handle: String, $id: ID) {
     handle
     title
     variants {
-      ...VariantStoreAvailability
+      nodes {
+        ...VariantStoreAvailability
+      }
     }
   }
 }