@faststore/core 4.6.0-dev.2 → 4.6.0-dev.3

package/.turbo/turbo-generate.log

@@ -1,9 +1,9 @@
 
-> @faststore/core@4.6.0-dev.1 generate /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.6.0-dev.2 generate /home/runner/work/faststore/faststore/packages/core
 > pnpm run gen-types && pnpm run cache-graphql 
 
 
-> @faststore/core@4.6.0-dev.1 gen-types /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.6.0-dev.2 gen-types /home/runner/work/faststore/faststore/packages/core
 > node ../cli/bin/run generate-types .
 
 [STARTED] Parse Configuration
@@ -19,11 +19,11 @@
 [COMPLETED] Generate to /home/runner/work/faststore/faststore/packages/core/@generated/
 [COMPLETED] Generate outputs
 
-> @faststore/core@4.6.0-dev.1 cache-graphql /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.6.0-dev.2 cache-graphql /home/runner/work/faststore/faststore/packages/core
 > node ../cli/bin/run cache-graphql --config=./discovery.config.default.js --queries=./@generated/persisted-documents.json
 
 [Info] - Config file location: /home/runner/work/faststore/faststore/packages/core/discovery.config.default.js
 [Info] - Persisted documents at: /home/runner/work/faststore/faststore/packages/core/@generated/persisted-documents.json
 [Info] - Cached operations output: /home/runner/work/faststore/faststore/packages/core/@generated/cached-operations.json
 [Success] - GraphQL queries cached with success: 🎉
-      Queries: ClientRecommendationsQuery, ServerAccountPageQuery, ServerCollectionPageQuery, ServerProductQuery, ServerOrderDetailsQuery, ServerListOrdersQuery, ServerProfileQuery, ServerListQuotesQuery, ServerQuotesOrganizationMemberQuery, ServerSecurity, ServerUserDetailsQuery, AvailableContractsQuery, ValidateUser, ClientPickupPointsQuery, OrderEntryOperationQuery, OrderFormItemsQuery, ClientProductCountQuery, ClientAllVariantProductsQuery, ClientManyProductsQueryWithSearchId, ClientProductGalleryQuery, ClientProductQuery, ClientManyProductsQuery, ClientManyProductsSelectedQuery, ClientProfileQuery, ClientSearchSuggestionsQuery, ClientTopSearchSuggestionsQuery, ClientShippingSimulationQuery, ServerManyProductsQuery
+      Queries: ServerAccountPageQuery, ServerCollectionPageQuery, ServerProductQuery, ServerOrderDetailsQuery, ServerListOrdersQuery, ServerProfileQuery, ServerListQuotesQuery, ServerQuotesOrganizationMemberQuery, ServerSecurity, ServerUserDetailsQuery, AvailableContractsQuery, ValidateUser, ClientPickupPointsQuery, OrderEntryOperationQuery, OrderFormItemsQuery, ClientProductCountQuery, ClientAllVariantProductsQuery, ClientManyProductsQueryWithSearchId, ClientProductGalleryQuery, ClientProductQuery, ClientManyProductsQuery, ClientManyProductsSelectedQuery, ClientProfileQuery, ClientRecommendationsQuery, ClientSearchSuggestionsQuery, ClientTopSearchSuggestionsQuery, ClientShippingSimulationQuery, ServerManyProductsQuery

package/.turbo/turbo-test.log

@@ -1,13 +1,18 @@
 
-> @faststore/core@4.6.0-dev.1 test /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.6.0-dev.2 test /home/runner/work/faststore/faststore/packages/core
 > vitest run
 
 
  RUN  v4.0.18 /home/runner/work/faststore/faststore/packages/core
 
+ ✓  browser  test/components/ui/ProductGallery/GalleryPageHeightLock.browser.test.tsx (8 tests) 310ms
 Not implemented: navigation to another Document
 Not implemented: navigation to another Document
- ✓  browser  test/sdk/ui/useScrollRestoration.browser.test.ts (43 tests) 763ms
+ ✓  browser  test/sdk/ui/useScrollRestoration.browser.test.ts (43 tests) 881ms
+ ✓  browser  test/components/account/ContractSwitcher.browser.test.tsx (13 tests) 2268ms
+     ✓ shows an error state when the list fails to load  726ms
+     ✓ requires selecting a contract before Confirm is enabled, then switches (REQ-03)  347ms
+ ✓  browser  test/sdk/session/reconcileSessionLocale.browser.test.ts (5 tests) 27ms
 stderr | test/components/RecommendationShelf/RecommendationShelf.browser.test.tsx
 Error in optimistic validation: TypeError: Failed to parse URL from /api/graphql?operationName=ValidateCartMutation&operationHash=3c71b0d3fc2bade14df68abfa271858beb361b12
     at node:internal/deps/undici/undici:16416:13
@@ -37,14 +42,11 @@ Not implemented: navigation to another Document
 Browserslist: browsers data (caniuse-lite) is 6 months old. Please run:
   npx update-browserslist-db@latest
   Why you should do it regularly: https://github.com/browserslist/update-db#readme
- ✓  browser  test/components/account/ContractSwitcher.browser.test.tsx (13 tests) 1389ms
 stderr | test/components/RecommendationShelf/RecommendationShelf.browser.test.tsx > RecommendationShelf > renders nothing when there is an error
 Error fetching recommendations undefined boom for campaign vrn:recommendations:acc:rec-top-items-v2:campaign-1
 
- ✓  browser  test/components/RecommendationShelf/RecommendationShelf.browser.test.tsx (8 tests) 169ms
- ✓  browser  test/components/ui/ProductGallery/GalleryPageHeightLock.browser.test.tsx (8 tests) 112ms
- ✓  browser  test/sdk/session/reconcileSessionLocale.browser.test.ts (5 tests) 14ms
- ✓  browser  test/sdk/session/getInitialSession.browser.test.ts (6 tests) 19ms
+ ✓  browser  test/components/RecommendationShelf/RecommendationShelf.browser.test.tsx (8 tests) 244ms
+ ✓  browser  test/sdk/recommendations/useRecommendationShelf.browser.test.tsx (10 tests) 104ms
 stderr | test/pages/password-protection.browser.test.tsx > PasswordProtectionLogin > posts the password and redirects to the requested return path
 Warning: An update to PasswordProtectionLogin inside a test was not wrapped in act(...).
 
@@ -274,11 +276,12 @@ act(() => {
 This ensures that you're testing the behavior the user would see in the browser. Learn more at https://reactjs.org/link/wrap-tests-with-act
     at PasswordProtectionLogin (/home/runner/work/faststore/faststore/packages/core/src/pages/password-protection/index.tsx:19:69)
 
- ✓  browser  test/pages/password-protection.browser.test.tsx (6 tests) 1159ms
-     ✓ renders the password protection form  515ms
- ✓  browser  test/sdk/account/changeContractToken.browser.test.ts (9 tests) 31ms
- ✓  browser  test/components/account/OrganizationDrawer.browser.test.tsx (5 tests) 1172ms
-     ✓ renders the menu view with contract details and manage footer  744ms
+ ✓  browser  test/pages/password-protection.browser.test.tsx (6 tests) 844ms
+     ✓ renders the password protection form  351ms
+ ✓  browser  test/sdk/session/getInitialSession.browser.test.ts (6 tests) 13ms
+ ✓  browser  test/sdk/account/changeContractToken.browser.test.ts (9 tests) 26ms
+ ✓  browser  test/components/account/OrganizationDrawer.browser.test.tsx (5 tests) 919ms
+     ✓ renders the menu view with contract details and manage footer  455ms
 stderr | test/sdk/localization/store-url.browser.test.ts
 Error in optimistic validation: TypeError: Cannot read properties of undefined (reading 'read')
     at waitForSessionValidated (/home/runner/work/faststore/faststore/packages/core/src/sdk/cart/waitForSessionValidated.ts:16:32)
@@ -287,10 +290,10 @@ This ensures that you're testing the behavior the user would see in the browser.
     at a (/home/runner/work/faststore/faststore/packages/sdk/dist/es/index.mjs:354:23)
     at processTicksAndRejections (node:internal/process/task_queues:103:5)
 
- ✓  browser  test/sdk/localization/store-url.browser.test.ts (3 tests) 7ms
- ✓  browser  test/sdk/account/useAvailableContracts.browser.test.ts (6 tests) 31ms
- ✓  browser  test/components/templates/SearchPage/SearchWrapper.browser.test.tsx (3 tests) 21ms
- ✓  browser  test/sdk/account/useSwitchContract.browser.test.ts (4 tests) 36ms
+ ✓  browser  test/sdk/localization/store-url.browser.test.ts (3 tests) 11ms
+ ✓  browser  test/sdk/account/useAvailableContracts.browser.test.ts (6 tests) 32ms
+ ✓  browser  test/components/templates/SearchPage/SearchWrapper.browser.test.tsx (3 tests) 27ms
+ ✓  browser  test/sdk/account/useSwitchContract.browser.test.ts (4 tests) 34ms
 stderr | test/components/account/doLogout.browser.test.ts
 Error in optimistic validation: TypeError: Cannot read properties of undefined (reading 'read')
     at waitForSessionValidated (/home/runner/work/faststore/faststore/packages/core/src/sdk/cart/waitForSessionValidated.ts:16:32)
@@ -299,8 +302,8 @@ This ensures that you're testing the behavior the user would see in the browser.
     at a (/home/runner/work/faststore/faststore/packages/sdk/dist/es/index.mjs:354:23)
     at processTicksAndRejections (node:internal/process/task_queues:103:5)
 
- ✓  browser  test/components/account/doLogout.browser.test.ts (1 test) 14ms
- ✓  browser  test/components/account/OrganizationDrawerHeader.browser.test.tsx (3 tests) 186ms
+ ✓  browser  test/components/account/doLogout.browser.test.ts (1 test) 21ms
+ ✓  browser  test/components/account/OrganizationDrawerHeader.browser.test.tsx (3 tests) 191ms
 stderr | test/sdk/account/clearPersistedSessionState.browser.test.ts
 Error in optimistic validation: TypeError: Cannot read properties of undefined (reading 'read')
     at waitForSessionValidated (/home/runner/work/faststore/faststore/packages/core/src/sdk/cart/waitForSessionValidated.ts:16:32)
@@ -309,13 +312,13 @@ This ensures that you're testing the behavior the user would see in the browser.
     at a (/home/runner/work/faststore/faststore/packages/sdk/dist/es/index.mjs:354:23)
     at processTicksAndRejections (node:internal/process/task_queues:103:5)
 
- ✓  browser  test/sdk/account/clearPersistedSessionState.browser.test.ts (1 test) 14ms
- ✓  browser  test/components/account/OrganizationDrawerFooter.browser.test.tsx (3 tests) 239ms
+ ✓  browser  test/sdk/account/clearPersistedSessionState.browser.test.ts (1 test) 4ms
+ ✓  browser  test/components/account/OrganizationDrawerFooter.browser.test.tsx (3 tests) 253ms
  ✓  browser  test/utils/isLocalHost.browser.test.ts (3 tests) 4ms
- ✓  browser  test/sdk/session/reconcileSessionLocale.disabled.browser.test.ts (1 test) 2ms
+ ✓  browser  test/sdk/session/reconcileSessionLocale.disabled.browser.test.ts (1 test) 3ms
+ ✓  browser  test/components/skeletons/ProductGridSkeleton.browser.test.tsx (2 tests) 31ms
  ✓  node  test/utils/localization/bindingPaths.test.ts (71 tests) 21ms
- ✓  browser  test/components/skeletons/ProductGridSkeleton.browser.test.tsx (2 tests) 29ms
- ✓  node  test/server/password-protection-service.test.ts (22 tests) 25ms
+ ✓  node  test/server/password-protection-service.test.ts (22 tests) 26ms
 stderr | test/sdk/account/refreshToken.browser.test.ts
 Error in optimistic validation: TypeError: Cannot read properties of undefined (reading 'read')
     at waitForSessionValidated (/home/runner/work/faststore/faststore/packages/core/src/sdk/cart/waitForSessionValidated.ts:16:32)
@@ -324,11 +327,11 @@ This ensures that you're testing the behavior the user would see in the browser.
     at a (/home/runner/work/faststore/faststore/packages/sdk/dist/es/index.mjs:354:23)
     at processTicksAndRejections (node:internal/process/task_queues:103:5)
 
- ✓  node  test/utils/match-url.test.ts (10 tests) 5ms
+ ✓  node  test/utils/match-url.test.ts (10 tests) 8ms
  ✓  browser  test/sdk/account/refreshToken.browser.test.ts (1 test) 4ms
- ✓  node  test/sdk/localization/useBindingSelector.test.tsx (22 tests) 11ms
- ✓  node  test/pages/api/unlock.test.ts (15 tests) 118ms
- ✓  node  test/sdk/localization/bindingSelector.test.ts (18 tests) 8ms
+ ✓  node  test/sdk/localization/useBindingSelector.test.tsx (22 tests) 12ms
+ ✓  node  test/pages/api/unlock.test.ts (15 tests) 125ms
+ ✓  node  test/sdk/localization/bindingSelector.test.ts (18 tests) 7ms
 stderr | test/components/search/SearchInputComponent.test.tsx
 Warning: forwardRef render functions accept exactly two parameters: props and ref. Did you forget to use the ref parameter?
 
@@ -392,11 +395,11 @@ Warning: React does not recognize the `providerProps` prop on a DOM element. If
     at Suspense
     at Wrapper (/home/runner/work/faststore/faststore/packages/core/test/components/search/SearchInputComponent.test.tsx:106:20)
 
- ✓  node  test/components/search/SearchInputComponent.test.tsx (6 tests) 58ms
- ✓  node  test/utils/cookieCacheBusting.test.ts (10 tests) 10ms
- ✓  node  test/sdk/search/useSearchHistory.test.ts (13 tests) 44ms
- ✓  node  test/experimental/myAccountCmsServerSideProps.test.ts (5 tests) 8ms
- ✓  node  test/utils/clearCookies.test.ts (20 tests) 19ms
+ ✓  node  test/components/search/SearchInputComponent.test.tsx (6 tests) 68ms
+ ✓  node  test/utils/cookieCacheBusting.test.ts (10 tests) 8ms
+ ✓  node  test/sdk/search/useSearchHistory.test.ts (13 tests) 51ms
+ ✓  node  test/experimental/myAccountCmsServerSideProps.test.ts (5 tests) 7ms
+ ✓  node  test/utils/clearCookies.test.ts (20 tests) 17ms
 stderr | test/pages/api/graphql.test.ts > /api/graphql error status propagation > propagates the upstream 400 from a wrapped BadRequestError instead of 500
 Graphql execution returned with error:  [
   {
@@ -489,64 +492,64 @@ Warning: React does not recognize the `providerProps` prop on a DOM element. If
     at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:1653:37
     at Traces.$ (file:///home/runner/work/faststore/faststore/node_modules/.pnpm/vitest@4.0.18_@opentelemetry+api@1.9.0_@types+node@20.19.13_jiti@2.6.1_jsdom@27.4.0_sas_13be941c57d55f08f06eeaf1c180ddfe/node_modules/vitest/dist/chunks/traces.CCmnQaNT.js:142:27)
 
- ✓  node  test/pages/api/graphql.test.ts (17 tests) 24ms
- ✓  node  test/components/quotes/MyAccountListQuotesTable.test.tsx (12 tests) 323ms
+ ✓  node  test/pages/api/graphql.test.ts (17 tests) 30ms
+ ✓  node  test/components/quotes/MyAccountListQuotesTable.test.tsx (12 tests) 302ms
+ ✓  node  test/sdk/orderEntry/useOrderEntryOperation.test.ts (8 tests) 28ms
 stderr | test/sdk/account/useSetPassword.test.ts > useSetPassword > maps wrongcredentials error responses to the existing message
 Set password request failed: Bad Request
 
- ✓  node  test/sdk/account/useSetPassword.test.ts (6 tests) 20ms
- ✓  node  test/sdk/orderEntry/useOrderEntryOperation.test.ts (8 tests) 24ms
- ✓  node  test/components/quotes/MyAccountListQuotes.test.tsx (9 tests) 795ms
-     ✓ navigates with the search term on blur  360ms
-     ✓ navigates without a label param when the search is cleared  358ms
- ✓  node  test/components/quotes/quoteFilters.test.ts (23 tests) 26ms
- ✓  node  test/utils/multipleTemplates.test.ts (8 tests) 6ms
- ✓  node  test/utils/localization/localizeRedirectDestination.test.ts (11 tests) 4ms
- ✓  node  test/sdk/orderEntry/useOrderEntryUpload.test.ts (8 tests) 37ms
- ✓  node  test/components/quotes/MyAccountQuotesFilterSlider.test.tsx (5 tests) 103ms
- ✓  node  test/sdk/analytics/useStartRecommendationSession.test.ts (6 tests) 38ms
- ✓  node  test/sdk/orderEntry/useOrderEntry.test.ts (8 tests) 30ms
- ✓  node  test/proxy.localization.test.ts (5 tests) 28ms
- ✓  node  test/sdk/account/getMyAccountRoutes.test.ts (10 tests) 5ms
+ ✓  node  test/sdk/account/useSetPassword.test.ts (6 tests) 31ms
+ ✓  node  test/components/quotes/MyAccountListQuotes.test.tsx (9 tests) 830ms
+     ✓ navigates with the search term on blur  361ms
+     ✓ navigates without a label param when the search is cleared  361ms
+ ✓  node  test/utils/multipleTemplates.test.ts (8 tests) 5ms
+ ✓  node  test/components/quotes/quoteFilters.test.ts (23 tests) 29ms
+ ✓  node  test/utils/localization/localizeRedirectDestination.test.ts (11 tests) 6ms
+ ✓  node  test/sdk/orderEntry/useOrderEntryUpload.test.ts (8 tests) 42ms
+ ✓  node  test/components/quotes/MyAccountQuotesFilterSlider.test.tsx (5 tests) 121ms
+ ✓  node  test/sdk/analytics/useStartRecommendationSession.test.ts (6 tests) 47ms
+ ✓  node  test/sdk/orderEntry/useOrderEntry.test.ts (8 tests) 28ms
+ ✓  node  test/proxy.localization.test.ts (5 tests) 23ms
+ ✓  node  test/sdk/account/getMyAccountRoutes.test.ts (10 tests) 6ms
  ✓  node  test/sdk/session/syncSalesChannelFromOrderForm.test.ts (6 tests) 5ms
- ✓  node  test/server/index.test.ts (7 tests) 946ms
-       ✓ should handle options and execute  513ms
- ✓  node  test/proxy.test.ts (4 tests) 13ms
- ✓  node  test/server/webops-api.test.ts (9 tests) 13ms
- ✓  node  test/components/quotes/MyAccountQuotesSelectedTags.test.tsx (8 tests) 89ms
- ✓  node  test/sdk/orderEntry/useOrderFormItems.test.ts (7 tests) 29ms
+ ✓  node  test/server/index.test.ts (7 tests) 874ms
+       ✓ should handle options and execute  439ms
+ ✓  node  test/proxy.test.ts (4 tests) 18ms
+ ✓  node  test/server/webops-api.test.ts (9 tests) 11ms
+ ✓  node  test/components/quotes/MyAccountQuotesSelectedTags.test.tsx (8 tests) 81ms
+ ✓  node  test/sdk/orderEntry/useOrderFormItems.test.ts (7 tests) 36ms
  ✓  node  test/server/content/service.test.ts (5 tests) 4ms
- ✓  node  test/sdk/cart/waitForSessionValidated.test.ts (5 tests) 9ms
- ✓  node  test/sdk/account/refreshToken.test.ts (5 tests) 6ms
+ ✓  node  test/sdk/cart/waitForSessionValidated.test.ts (5 tests) 10ms
+ ✓  node  test/sdk/account/refreshToken.test.ts (5 tests) 7ms
  ✓  node  test/server/cms/global.test.ts (3 tests) 4ms
- ✓  node  test/sdk/localization/store-url.test.ts (1 test) 2ms
- ✓  node  test/sdk/auth/useAuth.test.ts (5 tests) 24ms
+ ✓  node  test/sdk/localization/store-url.test.ts (1 test) 3ms
+ ✓  node  test/sdk/auth/useAuth.test.ts (5 tests) 26ms
+ ✓  node  test/components/quotes/MyAccountQuotesStatusSelector.test.tsx (6 tests) 110ms
  ✓  node  test/sdk/analytics/hasEnabledRecommendationShelf.test.ts (6 tests) 4ms
- ✓  node  test/components/quotes/MyAccountQuotesStatusSelector.test.tsx (6 tests) 92ms
- ✓  node  test/utils/getRequestHostname.test.ts (12 tests) 3ms
- ✓  node  test/pages/api/preview.test.ts (2 tests) 5ms
+ ✓  node  test/utils/getRequestHostname.test.ts (12 tests) 5ms
+ ✓  node  test/pages/api/preview.test.ts (2 tests) 6ms
  ✓  node  test/utils/validateSessionRefreshToken.test.ts (6 tests) 4ms
- ✓  node  test/server/rootSpan.test.ts (4 tests) 38ms
- ✓  node  test/components/search/SearchInput.test.ts (6 tests) 6ms
- ✓  node  test/components/RecommendationShelf/vrn.test.ts (5 tests) 4ms
- ✓  node  test/server/cms/index.test.ts (2 tests) 4ms
- ✓  node  test/utils/retry.test.ts (5 tests) 12ms
- ✓  node  test/components/account/Layout.test.tsx (4 tests) 29ms
- ✓  node  test/components/RecommendationShelf/useRecommendationUserId.test.ts (4 tests) 185ms
+ ✓  node  test/components/search/SearchInput.test.ts (6 tests) 5ms
+ ✓  node  test/server/rootSpan.test.ts (4 tests) 30ms
+ ✓  node  test/sdk/recommendations/vrn.test.ts (5 tests) 4ms
+ ✓  node  test/server/cms/index.test.ts (2 tests) 5ms
+ ✓  node  test/utils/retry.test.ts (5 tests) 10ms
+ ✓  node  test/components/account/Layout.test.tsx (4 tests) 34ms
+ ✓  node  test/sdk/recommendations/useRecommendationUserId.test.ts (4 tests) 184ms
  ✓  node  test/utils/unlockResponse.test.ts (11 tests) 3ms
  ✓  node  test/server/cms/myAccountDefaultSections.test.ts (5 tests) 5ms
- ✓  node  test/components/RecommendationShelf/useRecommendations.test.ts (2 tests) 3ms
+ ✓  node  test/sdk/recommendations/useRecommendations.test.ts (2 tests) 3ms
  ✓  node  test/utils/isLocalHost.test.ts (7 tests) 4ms
+ ✓  node  test/components/account/OrganizationDrawerBody.test.tsx (3 tests) 41ms
  ✓  node  test/utils/userOrderStatus.test.ts (3 tests) 3ms
- ✓  node  test/components/account/OrganizationDrawerBody.test.tsx (3 tests) 33ms
  ✓  node  test/sdk/analytics/utils.test.ts (2 tests) 3ms
- ✓  node  test/instrumentation.test.ts (3 tests) 6ms
+ ✓  node  test/instrumentation.test.ts (3 tests) 4ms
  ✓  node  test/components/auth/ProfileChallenge.test.tsx (3 tests) 32ms
- ✓  node  test/sdk/account/clearPersistedSessionState.test.ts (1 test) 13ms
- ✓  node  test/components/quotes/MyAccountQuoteStatusBadge.test.tsx (2 tests) 18ms
+ ✓  node  test/sdk/account/clearPersistedSessionState.test.ts (1 test) 14ms
+ ✓  node  test/components/quotes/MyAccountQuoteStatusBadge.test.tsx (2 tests) 23ms
 
- Test Files  81 passed (81)
-      Tests  651 passed (651)
-   Start at  02:49:36
-   Duration  29.47s (transform 7.03s, setup 0ms, import 25.03s, tests 8.86s, environment 38.42s)
+ Test Files  82 passed (82)
+      Tests  661 passed (661)
+   Start at  15:05:26
+   Duration  29.73s (transform 6.68s, setup 0ms, import 23.96s, tests 9.74s, environment 38.48s)
 

package/@generated/cached-operations.json

@@ -1,5 +1,4 @@
 [
-  "ClientRecommendationsQuery",
   "ServerAccountPageQuery",
   "ServerCollectionPageQuery",
   "ServerProductQuery",
@@ -23,6 +22,7 @@
   "ClientManyProductsQuery",
   "ClientManyProductsSelectedQuery",
   "ClientProfileQuery",
+  "ClientRecommendationsQuery",
   "ClientSearchSuggestionsQuery",
   "ClientTopSearchSuggestionsQuery",
   "ClientShippingSimulationQuery",

package/@generated/gql.ts

@@ -18,7 +18,6 @@ type Documents = {
     "\n  fragment ProductSummary_product on StoreProduct {\n    id: productID\n    slug\n    sku\n    brand {\n      brandName: name\n    }\n    name\n    gtin\n\t\tunitMultiplier\n\n    isVariantOf {\n      productGroupID\n      name\n\t\t\tskuVariants {\n\t\t\t\tallVariantsByName\n\t\t\t\tactiveVariations\n\t\t\t\tslugsMap\n\t\t\t\tavailableVariations\n\t\t\t}\n    }\n\n    image {\n      url\n      alternateName\n    }\n\n    brand {\n      name\n    }\n\n    offers {\n      lowPrice\n      lowPriceWithTaxes\n      offers {\n        availability\n        price\n        listPrice\n        listPriceWithTaxes\n        priceWithTaxes\n        quantity\n        priceToken\n        seller {\n          identifier\n        }\n      }\n    }\n\n    additionalProperty {\n      propertyID\n      name\n      value\n      valueReference\n    }\n\n    hasSpecifications\n\n    unitMultiplier\n\n    isVariantOf {\n      productGroupID\n      name\n      skuVariants {\n        activeVariations\n        slugsMap\n        availableVariations\n        allVariantProducts {\n          name\n          productID\n        }\n      }\n    }\n\n    advertisement {\n      adId\n      adResponseId\n    }\n\n    deliveryPromiseBadges {\n      typeName\n    }\n  }\n": typeof types.ProductSummary_ProductFragmentDoc,
     "\n  fragment Filter_facets on StoreFacet {\n    ... on StoreFacetRange {\n      key\n      label\n\n      min {\n        selected\n        absolute\n      }\n\n      max {\n        selected\n        absolute\n      }\n\n      __typename\n    }\n    ... on StoreFacetBoolean {\n      key\n      label\n      values {\n        label\n        value\n        selected\n        quantity\n      }\n\n      __typename\n    }\n  }\n": typeof types.Filter_FacetsFragmentDoc,
     "\n  fragment ProductDetailsFragment_product on StoreProduct {\n    id: productID\n    sku\n    name\n    gtin\n    description\n    unitMultiplier\n    isVariantOf {\n      name\n      productGroupID\n\t\t\tskuVariants {\n        activeVariations\n        slugsMap\n        availableVariations\n        allVariantProducts {\n          name\n          productID\n        }\n      }\n    }\n\n    image {\n      url\n      alternateName\n    }\n\n    brand {\n      name\n    }\n\n    offers {\n      lowPrice\n      lowPriceWithTaxes\n      offers {\n        availability\n        price\n        priceWithTaxes\n        listPrice\n        listPriceWithTaxes\n        quantity\n        priceToken\n        seller {\n          identifier\n        }\n      }\n    }\n\n    additionalProperty {\n      propertyID\n      name\n      value\n      valueReference\n    }\n\n    # Contains necessary info to add this item to cart\n    ...CartProductItem\n  }\n": typeof types.ProductDetailsFragment_ProductFragmentDoc,
-    "query ClientRecommendationsQuery(\n  $campaignVrn: String!\n  $userId: String\n  $products: [String!]\n) {\n  recommendations(\n    userId: $userId\n    campaignVrn: $campaignVrn\n    products: $products\n  ) {\n    products {\n      ...ProductSummary_product\n    }\n    correlationId\n    campaign {\n      id\n      title\n      type\n    }\n  }\n}\n": typeof types.ClientRecommendationsQueryDocument,
     "\n  fragment ProductComparisonFragment_product on StoreProduct {\n    id: productID\n    sku\n    slug\n    name\n    gtin\n    description\n    unitMultiplier\n    isVariantOf {\n      name\n      productGroupID\n      skuVariants {\n        activeVariations\n        slugsMap\n        availableVariations\n        allVariantProducts {\n          name\n          productID\n        }\n      }\n    }\n\n    image {\n      url\n      alternateName\n    }\n\n    brand {\n      name\n    }\n\n    offers {\n      lowPrice\n      lowPriceWithTaxes\n      offers {\n        availability\n        price\n        priceWithTaxes\n        listPrice\n        quantity\n        listPriceWithTaxes\n        priceToken\n        seller {\n          identifier\n        }\n      }\n    }\n\n    additionalProperty {\n      propertyID\n      name\n      value\n      valueReference\n    }\n\n    advertisement {\n      adId\n      adResponseId\n    }\n\n    hasSpecifications\n\n    skuSpecifications {\n      field {\n        id\n        name\n        originalName\n      }\n      values {\n        name\n        id\n        fieldId\n        originalName\n      }\n    }\n\n    specificationGroups {\n      name\n      originalName\n      specifications {\n        name\n        originalName\n        values\n      }\n    }\n  }\n": typeof types.ProductComparisonFragment_ProductFragmentDoc,
     "\n  fragment ProductSKUMatrixSidebarFragment_product on StoreProduct {\n    id: productID\n    isVariantOf {\n      name\n      productGroupID\n      skuVariants {\n        activeVariations\n        slugsMap\n        availableVariations\n        allVariantProducts {\n\t\t\t\t\tsku\n          name\n          image {\n            url\n            alternateName\n          }\n          offers {\n            highPrice\n            lowPrice\n            lowPriceWithTaxes\n            offerCount\n            priceCurrency\n            offers {\n              listPrice\n              listPriceWithTaxes\n              sellingPrice\n              priceCurrency\n              price\n              priceWithTaxes\n              priceValidUntil\n              itemCondition\n              availability\n              quantity\n              priceToken\n            }\n          }\n          additionalProperty {\n            propertyID\n            value\n            name\n            valueReference\n          }\n        }\n      }\n    }\n  }\n": typeof types.ProductSkuMatrixSidebarFragment_ProductFragmentDoc,
     "\n  fragment ClientManyProducts on Query {\n    search(\n      first: $first\n      after: $after\n      sort: $sort\n      term: $term\n      selectedFacets: $selectedFacets\n      sponsoredCount: $sponsoredCount\n\n    ) {\n      products {\n        pageInfo {\n          totalCount\n        }\n      }\n    }\n  }\n": typeof types.ClientManyProductsFragmentDoc,
@@ -60,6 +59,7 @@ type Documents = {
     "\n  query ClientManyProductsQuery(\n    $first: Int!\n    $after: String\n    $sort: StoreSort!\n    $term: String!\n    $selectedFacets: [IStoreSelectedFacet!]!\n    $sponsoredCount: Int\n  ) {\n    ...ClientManyProducts\n    search(\n      first: $first\n      after: $after\n      sort: $sort\n      term: $term\n      selectedFacets: $selectedFacets\n      sponsoredCount: $sponsoredCount\n    ) {\n      products {\n        pageInfo {\n          totalCount\n        }\n        edges {\n          node {\n            ...ProductSummary_product\n          }\n        }\n      }\n    }\n  }\n": typeof types.ClientManyProductsQueryDocument,
     "\n  query ClientManyProductsSelectedQuery(\n    $productIds: [String!]!\n  ) {\n    products(productIds: $productIds) {\n      ...ProductComparisonFragment_product\n    }\n  }\n": typeof types.ClientManyProductsSelectedQueryDocument,
     "\n  query ClientProfileQuery($id: String!) {\n    profile(id: $id) {\n      addresses {\n        country\n        postalCode\n        geoCoordinate\n        city\n      }\n    }\n  }\n": typeof types.ClientProfileQueryDocument,
+    "query ClientRecommendationsQuery(\n  $campaignVrn: String!\n  $userId: String\n  $products: [String!]\n) {\n  recommendations(\n    userId: $userId\n    campaignVrn: $campaignVrn\n    products: $products\n  ) {\n    products {\n      ...ProductSummary_product\n    }\n    correlationId\n    campaign {\n      id\n      title\n      type\n    }\n  }\n}\n": typeof types.ClientRecommendationsQueryDocument,
     "\n  query ClientSearchSuggestionsQuery(\n    $term: String!\n    $selectedFacets: [IStoreSelectedFacet!]\n  ) {\n    ...ClientSearchSuggestions\n    search(first: 5, term: $term, selectedFacets: $selectedFacets) {\n      suggestions {\n        terms {\n          value\n        }\n        products {\n          ...ProductSummary_product\n        }\n      }\n      products {\n        pageInfo {\n          totalCount\n        }\n      }\n      metadata {\n        ...SearchEvent_metadata\n      }\n      searchId\n    }\n  }\n": typeof types.ClientSearchSuggestionsQueryDocument,
     "\n  query ClientTopSearchSuggestionsQuery(\n    $term: String!\n    $selectedFacets: [IStoreSelectedFacet!]\n  ) {\n    ...ClientTopSearchSuggestions\n    search(first: 5, term: $term, selectedFacets: $selectedFacets) {\n      suggestions {\n        terms {\n          value\n        }\n      }\n    }\n  }\n": typeof types.ClientTopSearchSuggestionsQueryDocument,
     "\n  mutation ValidateSession($session: IStoreSession!, $search: String!) {\n    validateSession(session: $session, search: $search) {\n      locale\n      channel\n      country\n      addressType\n      postalCode\n      city\n      deliveryMode {\n        deliveryChannel\n        deliveryMethod\n        deliveryWindow {\n          startDate\n          endDate\n        }\n      }\n      geoCoordinates {\n        latitude\n        longitude\n      }\n      currency {\n        code\n        symbol\n      }\n      person {\n        id\n        email\n        givenName\n        familyName\n      }\n      b2b {\n        customerId\n        isRepresentative\n        unitName\n        unitId\n        firstName\n        lastName\n        userName\n        userEmail\n        savedPostalCode\n        contractName\n        organizationManager\n      }\n      marketingData {\n        utmCampaign\n        utmMedium\n        utmSource\n        utmiCampaign\n        utmiPage\n        utmiPart\n      }\n      refreshAfter\n    }\n  }\n": typeof types.ValidateSessionDocument,
@@ -70,7 +70,6 @@ const documents: Documents = {
     "\n  fragment ProductSummary_product on StoreProduct {\n    id: productID\n    slug\n    sku\n    brand {\n      brandName: name\n    }\n    name\n    gtin\n\t\tunitMultiplier\n\n    isVariantOf {\n      productGroupID\n      name\n\t\t\tskuVariants {\n\t\t\t\tallVariantsByName\n\t\t\t\tactiveVariations\n\t\t\t\tslugsMap\n\t\t\t\tavailableVariations\n\t\t\t}\n    }\n\n    image {\n      url\n      alternateName\n    }\n\n    brand {\n      name\n    }\n\n    offers {\n      lowPrice\n      lowPriceWithTaxes\n      offers {\n        availability\n        price\n        listPrice\n        listPriceWithTaxes\n        priceWithTaxes\n        quantity\n        priceToken\n        seller {\n          identifier\n        }\n      }\n    }\n\n    additionalProperty {\n      propertyID\n      name\n      value\n      valueReference\n    }\n\n    hasSpecifications\n\n    unitMultiplier\n\n    isVariantOf {\n      productGroupID\n      name\n      skuVariants {\n        activeVariations\n        slugsMap\n        availableVariations\n        allVariantProducts {\n          name\n          productID\n        }\n      }\n    }\n\n    advertisement {\n      adId\n      adResponseId\n    }\n\n    deliveryPromiseBadges {\n      typeName\n    }\n  }\n": types.ProductSummary_ProductFragmentDoc,
     "\n  fragment Filter_facets on StoreFacet {\n    ... on StoreFacetRange {\n      key\n      label\n\n      min {\n        selected\n        absolute\n      }\n\n      max {\n        selected\n        absolute\n      }\n\n      __typename\n    }\n    ... on StoreFacetBoolean {\n      key\n      label\n      values {\n        label\n        value\n        selected\n        quantity\n      }\n\n      __typename\n    }\n  }\n": types.Filter_FacetsFragmentDoc,
     "\n  fragment ProductDetailsFragment_product on StoreProduct {\n    id: productID\n    sku\n    name\n    gtin\n    description\n    unitMultiplier\n    isVariantOf {\n      name\n      productGroupID\n\t\t\tskuVariants {\n        activeVariations\n        slugsMap\n        availableVariations\n        allVariantProducts {\n          name\n          productID\n        }\n      }\n    }\n\n    image {\n      url\n      alternateName\n    }\n\n    brand {\n      name\n    }\n\n    offers {\n      lowPrice\n      lowPriceWithTaxes\n      offers {\n        availability\n        price\n        priceWithTaxes\n        listPrice\n        listPriceWithTaxes\n        quantity\n        priceToken\n        seller {\n          identifier\n        }\n      }\n    }\n\n    additionalProperty {\n      propertyID\n      name\n      value\n      valueReference\n    }\n\n    # Contains necessary info to add this item to cart\n    ...CartProductItem\n  }\n": types.ProductDetailsFragment_ProductFragmentDoc,
-    "query ClientRecommendationsQuery(\n  $campaignVrn: String!\n  $userId: String\n  $products: [String!]\n) {\n  recommendations(\n    userId: $userId\n    campaignVrn: $campaignVrn\n    products: $products\n  ) {\n    products {\n      ...ProductSummary_product\n    }\n    correlationId\n    campaign {\n      id\n      title\n      type\n    }\n  }\n}\n": types.ClientRecommendationsQueryDocument,
     "\n  fragment ProductComparisonFragment_product on StoreProduct {\n    id: productID\n    sku\n    slug\n    name\n    gtin\n    description\n    unitMultiplier\n    isVariantOf {\n      name\n      productGroupID\n      skuVariants {\n        activeVariations\n        slugsMap\n        availableVariations\n        allVariantProducts {\n          name\n          productID\n        }\n      }\n    }\n\n    image {\n      url\n      alternateName\n    }\n\n    brand {\n      name\n    }\n\n    offers {\n      lowPrice\n      lowPriceWithTaxes\n      offers {\n        availability\n        price\n        priceWithTaxes\n        listPrice\n        quantity\n        listPriceWithTaxes\n        priceToken\n        seller {\n          identifier\n        }\n      }\n    }\n\n    additionalProperty {\n      propertyID\n      name\n      value\n      valueReference\n    }\n\n    advertisement {\n      adId\n      adResponseId\n    }\n\n    hasSpecifications\n\n    skuSpecifications {\n      field {\n        id\n        name\n        originalName\n      }\n      values {\n        name\n        id\n        fieldId\n        originalName\n      }\n    }\n\n    specificationGroups {\n      name\n      originalName\n      specifications {\n        name\n        originalName\n        values\n      }\n    }\n  }\n": types.ProductComparisonFragment_ProductFragmentDoc,
     "\n  fragment ProductSKUMatrixSidebarFragment_product on StoreProduct {\n    id: productID\n    isVariantOf {\n      name\n      productGroupID\n      skuVariants {\n        activeVariations\n        slugsMap\n        availableVariations\n        allVariantProducts {\n\t\t\t\t\tsku\n          name\n          image {\n            url\n            alternateName\n          }\n          offers {\n            highPrice\n            lowPrice\n            lowPriceWithTaxes\n            offerCount\n            priceCurrency\n            offers {\n              listPrice\n              listPriceWithTaxes\n              sellingPrice\n              priceCurrency\n              price\n              priceWithTaxes\n              priceValidUntil\n              itemCondition\n              availability\n              quantity\n              priceToken\n            }\n          }\n          additionalProperty {\n            propertyID\n            value\n            name\n            valueReference\n          }\n        }\n      }\n    }\n  }\n": types.ProductSkuMatrixSidebarFragment_ProductFragmentDoc,
     "\n  fragment ClientManyProducts on Query {\n    search(\n      first: $first\n      after: $after\n      sort: $sort\n      term: $term\n      selectedFacets: $selectedFacets\n      sponsoredCount: $sponsoredCount\n\n    ) {\n      products {\n        pageInfo {\n          totalCount\n        }\n      }\n    }\n  }\n": types.ClientManyProductsFragmentDoc,
@@ -112,6 +111,7 @@ const documents: Documents = {
     "\n  query ClientManyProductsQuery(\n    $first: Int!\n    $after: String\n    $sort: StoreSort!\n    $term: String!\n    $selectedFacets: [IStoreSelectedFacet!]!\n    $sponsoredCount: Int\n  ) {\n    ...ClientManyProducts\n    search(\n      first: $first\n      after: $after\n      sort: $sort\n      term: $term\n      selectedFacets: $selectedFacets\n      sponsoredCount: $sponsoredCount\n    ) {\n      products {\n        pageInfo {\n          totalCount\n        }\n        edges {\n          node {\n            ...ProductSummary_product\n          }\n        }\n      }\n    }\n  }\n": types.ClientManyProductsQueryDocument,
     "\n  query ClientManyProductsSelectedQuery(\n    $productIds: [String!]!\n  ) {\n    products(productIds: $productIds) {\n      ...ProductComparisonFragment_product\n    }\n  }\n": types.ClientManyProductsSelectedQueryDocument,
     "\n  query ClientProfileQuery($id: String!) {\n    profile(id: $id) {\n      addresses {\n        country\n        postalCode\n        geoCoordinate\n        city\n      }\n    }\n  }\n": types.ClientProfileQueryDocument,
+    "query ClientRecommendationsQuery(\n  $campaignVrn: String!\n  $userId: String\n  $products: [String!]\n) {\n  recommendations(\n    userId: $userId\n    campaignVrn: $campaignVrn\n    products: $products\n  ) {\n    products {\n      ...ProductSummary_product\n    }\n    correlationId\n    campaign {\n      id\n      title\n      type\n    }\n  }\n}\n": types.ClientRecommendationsQueryDocument,
     "\n  query ClientSearchSuggestionsQuery(\n    $term: String!\n    $selectedFacets: [IStoreSelectedFacet!]\n  ) {\n    ...ClientSearchSuggestions\n    search(first: 5, term: $term, selectedFacets: $selectedFacets) {\n      suggestions {\n        terms {\n          value\n        }\n        products {\n          ...ProductSummary_product\n        }\n      }\n      products {\n        pageInfo {\n          totalCount\n        }\n      }\n      metadata {\n        ...SearchEvent_metadata\n      }\n      searchId\n    }\n  }\n": types.ClientSearchSuggestionsQueryDocument,
     "\n  query ClientTopSearchSuggestionsQuery(\n    $term: String!\n    $selectedFacets: [IStoreSelectedFacet!]\n  ) {\n    ...ClientTopSearchSuggestions\n    search(first: 5, term: $term, selectedFacets: $selectedFacets) {\n      suggestions {\n        terms {\n          value\n        }\n      }\n    }\n  }\n": types.ClientTopSearchSuggestionsQueryDocument,
     "\n  mutation ValidateSession($session: IStoreSession!, $search: String!) {\n    validateSession(session: $session, search: $search) {\n      locale\n      channel\n      country\n      addressType\n      postalCode\n      city\n      deliveryMode {\n        deliveryChannel\n        deliveryMethod\n        deliveryWindow {\n          startDate\n          endDate\n        }\n      }\n      geoCoordinates {\n        latitude\n        longitude\n      }\n      currency {\n        code\n        symbol\n      }\n      person {\n        id\n        email\n        givenName\n        familyName\n      }\n      b2b {\n        customerId\n        isRepresentative\n        unitName\n        unitId\n        firstName\n        lastName\n        userName\n        userEmail\n        savedPostalCode\n        contractName\n        organizationManager\n      }\n      marketingData {\n        utmCampaign\n        utmMedium\n        utmSource\n        utmiCampaign\n        utmiPage\n        utmiPart\n      }\n      refreshAfter\n    }\n  }\n": types.ValidateSessionDocument,
@@ -131,10 +131,6 @@ export function gql(source: "\n  fragment Filter_facets on StoreFacet {\n    ...
  * The gql function is used to parse GraphQL queries into a document that can be used by GraphQL clients.
  */
 export function gql(source: "\n  fragment ProductDetailsFragment_product on StoreProduct {\n    id: productID\n    sku\n    name\n    gtin\n    description\n    unitMultiplier\n    isVariantOf {\n      name\n      productGroupID\n\t\t\tskuVariants {\n        activeVariations\n        slugsMap\n        availableVariations\n        allVariantProducts {\n          name\n          productID\n        }\n      }\n    }\n\n    image {\n      url\n      alternateName\n    }\n\n    brand {\n      name\n    }\n\n    offers {\n      lowPrice\n      lowPriceWithTaxes\n      offers {\n        availability\n        price\n        priceWithTaxes\n        listPrice\n        listPriceWithTaxes\n        quantity\n        priceToken\n        seller {\n          identifier\n        }\n      }\n    }\n\n    additionalProperty {\n      propertyID\n      name\n      value\n      valueReference\n    }\n\n    # Contains necessary info to add this item to cart\n    ...CartProductItem\n  }\n"): typeof import('./graphql').ProductDetailsFragment_ProductFragmentDoc;
-/**
- * The gql function is used to parse GraphQL queries into a document that can be used by GraphQL clients.
- */
-export function gql(source: "query ClientRecommendationsQuery(\n  $campaignVrn: String!\n  $userId: String\n  $products: [String!]\n) {\n  recommendations(\n    userId: $userId\n    campaignVrn: $campaignVrn\n    products: $products\n  ) {\n    products {\n      ...ProductSummary_product\n    }\n    correlationId\n    campaign {\n      id\n      title\n      type\n    }\n  }\n}\n"): typeof import('./graphql').ClientRecommendationsQueryDocument;
 /**
  * The gql function is used to parse GraphQL queries into a document that can be used by GraphQL clients.
  */
@@ -299,6 +295,10 @@ export function gql(source: "\n  query ClientManyProductsSelectedQuery(\n    $pr
  * The gql function is used to parse GraphQL queries into a document that can be used by GraphQL clients.
  */
 export function gql(source: "\n  query ClientProfileQuery($id: String!) {\n    profile(id: $id) {\n      addresses {\n        country\n        postalCode\n        geoCoordinate\n        city\n      }\n    }\n  }\n"): typeof import('./graphql').ClientProfileQueryDocument;
+/**
+ * The gql function is used to parse GraphQL queries into a document that can be used by GraphQL clients.
+ */
+export function gql(source: "query ClientRecommendationsQuery(\n  $campaignVrn: String!\n  $userId: String\n  $products: [String!]\n) {\n  recommendations(\n    userId: $userId\n    campaignVrn: $campaignVrn\n    products: $products\n  ) {\n    products {\n      ...ProductSummary_product\n    }\n    correlationId\n    campaign {\n      id\n      title\n      type\n    }\n  }\n}\n"): typeof import('./graphql').ClientRecommendationsQueryDocument;
 /**
  * The gql function is used to parse GraphQL queries into a document that can be used by GraphQL clients.
  */

package/@generated/graphql.ts

@@ -2727,15 +2727,6 @@ export type Filter_FacetsFragment =
 
 export type ProductDetailsFragment_ProductFragment = { sku: string, name: string, gtin: string, description: string, unitMultiplier: number | null, id: string, isVariantOf: { name: string, productGroupID: string, skuVariants: { activeVariations: any | null, slugsMap: any | null, availableVariations: any | null, allVariantProducts: Array<{ name: string, productID: string }> | null } | null }, image: Array<{ url: string, alternateName: string }>, brand: { name: string }, offers: { lowPrice: number, lowPriceWithTaxes: number, offers: Array<{ availability: string, price: number, priceWithTaxes: number, listPrice: number, listPriceWithTaxes: number, quantity: number, priceToken: string | null, seller: { identifier: string } }> }, additionalProperty: Array<{ propertyID: string, name: string, value: any, valueReference: any }> };
 
-export type ClientRecommendationsQueryQueryVariables = Exact<{
-  campaignVrn: Scalars['String']['input'];
-  userId: InputMaybe<Scalars['String']['input']>;
-  products: InputMaybe<Array<Scalars['String']['input']> | Scalars['String']['input']>;
-}>;
-
-
-export type ClientRecommendationsQueryQuery = { recommendations: { correlationId: string, products: Array<{ slug: string, sku: string, name: string, gtin: string, unitMultiplier: number | null, hasSpecifications: boolean | null, id: string, brand: { name: string, brandName: string }, isVariantOf: { productGroupID: string, name: string, skuVariants: { allVariantsByName: any | null, activeVariations: any | null, slugsMap: any | null, availableVariations: any | null, allVariantProducts: Array<{ name: string, productID: string }> | null } | null }, image: Array<{ url: string, alternateName: string }>, offers: { lowPrice: number, lowPriceWithTaxes: number, offers: Array<{ availability: string, price: number, listPrice: number, listPriceWithTaxes: number, priceWithTaxes: number, quantity: number, priceToken: string | null, seller: { identifier: string } }> }, additionalProperty: Array<{ propertyID: string, name: string, value: any, valueReference: any }>, advertisement: { adId: string, adResponseId: string } | null, deliveryPromiseBadges: Array<{ typeName: string | null } | null> | null }>, campaign: { id: string, title: string | null, type: string } } };
-
 export type ProductComparisonFragment_ProductFragment = { sku: string, slug: string, name: string, gtin: string, description: string, unitMultiplier: number | null, hasSpecifications: boolean | null, id: string, isVariantOf: { name: string, productGroupID: string, skuVariants: { activeVariations: any | null, slugsMap: any | null, availableVariations: any | null, allVariantProducts: Array<{ name: string, productID: string }> | null } | null }, image: Array<{ url: string, alternateName: string }>, brand: { name: string }, offers: { lowPrice: number, lowPriceWithTaxes: number, offers: Array<{ availability: string, price: number, priceWithTaxes: number, listPrice: number, quantity: number, listPriceWithTaxes: number, priceToken: string | null, seller: { identifier: string } }> }, additionalProperty: Array<{ propertyID: string, name: string, value: any, valueReference: any }>, advertisement: { adId: string, adResponseId: string } | null, skuSpecifications: Array<{ field: { id: string | null, name: string, originalName: string | null }, values: Array<{ name: string, id: string | null, fieldId: string | null, originalName: string | null }> }>, specificationGroups: Array<{ name: string, originalName: string, specifications: Array<{ name: string, originalName: string, values: Array<string> }> }> };
 
 export type ProductSkuMatrixSidebarFragment_ProductFragment = { id: string, isVariantOf: { name: string, productGroupID: string, skuVariants: { activeVariations: any | null, slugsMap: any | null, availableVariations: any | null, allVariantProducts: Array<{ sku: string, name: string, image: Array<{ url: string, alternateName: string }>, offers: { highPrice: number, lowPrice: number, lowPriceWithTaxes: number, offerCount: number, priceCurrency: string, offers: Array<{ listPrice: number, listPriceWithTaxes: number, sellingPrice: number, priceCurrency: string, price: number, priceWithTaxes: number, priceValidUntil: string, itemCondition: string, availability: string, quantity: number, priceToken: string | null }> }, additionalProperty: Array<{ propertyID: string, value: any, name: string, valueReference: any }> }> | null } | null } };
@@ -2994,6 +2985,15 @@ export type ClientProfileQueryQueryVariables = Exact<{
 
 export type ClientProfileQueryQuery = { profile: { addresses: Array<{ country: string | null, postalCode: string | null, geoCoordinate: Array<number | null> | null, city: string | null } | null> | null } | null };
 
+export type ClientRecommendationsQueryQueryVariables = Exact<{
+  campaignVrn: Scalars['String']['input'];
+  userId: InputMaybe<Scalars['String']['input']>;
+  products: InputMaybe<Array<Scalars['String']['input']> | Scalars['String']['input']>;
+}>;
+
+
+export type ClientRecommendationsQueryQuery = { recommendations: { correlationId: string, products: Array<{ slug: string, sku: string, name: string, gtin: string, unitMultiplier: number | null, hasSpecifications: boolean | null, id: string, brand: { name: string, brandName: string }, isVariantOf: { productGroupID: string, name: string, skuVariants: { allVariantsByName: any | null, activeVariations: any | null, slugsMap: any | null, availableVariations: any | null, allVariantProducts: Array<{ name: string, productID: string }> | null } | null }, image: Array<{ url: string, alternateName: string }>, offers: { lowPrice: number, lowPriceWithTaxes: number, offers: Array<{ availability: string, price: number, listPrice: number, listPriceWithTaxes: number, priceWithTaxes: number, quantity: number, priceToken: string | null, seller: { identifier: string } }> }, additionalProperty: Array<{ propertyID: string, name: string, value: any, valueReference: any }>, advertisement: { adId: string, adResponseId: string } | null, deliveryPromiseBadges: Array<{ typeName: string | null } | null> | null }>, campaign: { id: string, title: string | null, type: string } } };
+
 export type ClientSearchSuggestionsQueryQueryVariables = Exact<{
   term: Scalars['String']['input'];
   selectedFacets: InputMaybe<Array<IStoreSelectedFacet> | IStoreSelectedFacet>;
@@ -3555,7 +3555,6 @@ export const SearchEvent_MetadataFragmentDoc = new TypedDocumentString(`
   fuzzy
 }
     `, {"fragmentName":"SearchEvent_metadata"}) as unknown as TypedDocumentString<SearchEvent_MetadataFragment, unknown>;
-export const ClientRecommendationsQueryDocument = {"__meta__":{"operationName":"ClientRecommendationsQuery","operationHash":"b227071b0388469d7b90d04cff4cbc11f8f134d4"}} as unknown as TypedDocumentString<ClientRecommendationsQueryQuery, ClientRecommendationsQueryQueryVariables>;
 export const ServerAccountPageQueryDocument = {"__meta__":{"operationName":"ServerAccountPageQuery","operationHash":"9baae331b75848a310fecb457e8c971ae27897ff"}} as unknown as TypedDocumentString<ServerAccountPageQueryQuery, ServerAccountPageQueryQueryVariables>;
 export const ServerCollectionPageQueryDocument = {"__meta__":{"operationName":"ServerCollectionPageQuery","operationHash":"d46841b30ae1f6350021b5cf02f253d56c848664"}} as unknown as TypedDocumentString<ServerCollectionPageQueryQuery, ServerCollectionPageQueryQueryVariables>;
 export const ServerProductQueryDocument = {"__meta__":{"operationName":"ServerProductQuery","operationHash":"b89e93519be01aebc01c402489a0ae640d38675a"}} as unknown as TypedDocumentString<ServerProductQueryQuery, ServerProductQueryQueryVariables>;
@@ -3586,6 +3585,7 @@ export const ClientProductQueryDocument = {"__meta__":{"operationName":"ClientPr
 export const ClientManyProductsQueryDocument = {"__meta__":{"operationName":"ClientManyProductsQuery","operationHash":"ee14fd92b4a04fc3751efcbfcb60b3886d912253"}} as unknown as TypedDocumentString<ClientManyProductsQueryQuery, ClientManyProductsQueryQueryVariables>;
 export const ClientManyProductsSelectedQueryDocument = {"__meta__":{"operationName":"ClientManyProductsSelectedQuery","operationHash":"7e1b06c167e411905ceac9db11c1a6a7892cfdd6"}} as unknown as TypedDocumentString<ClientManyProductsSelectedQueryQuery, ClientManyProductsSelectedQueryQueryVariables>;
 export const ClientProfileQueryDocument = {"__meta__":{"operationName":"ClientProfileQuery","operationHash":"34ea14c0d4a57ddf9bc11e4be0cd2b5a6506d3d4"}} as unknown as TypedDocumentString<ClientProfileQueryQuery, ClientProfileQueryQueryVariables>;
+export const ClientRecommendationsQueryDocument = {"__meta__":{"operationName":"ClientRecommendationsQuery","operationHash":"b227071b0388469d7b90d04cff4cbc11f8f134d4"}} as unknown as TypedDocumentString<ClientRecommendationsQueryQuery, ClientRecommendationsQueryQueryVariables>;
 export const ClientSearchSuggestionsQueryDocument = {"__meta__":{"operationName":"ClientSearchSuggestionsQuery","operationHash":"ee57cd392fdfde90620787c9954e2ecae47881f9"}} as unknown as TypedDocumentString<ClientSearchSuggestionsQueryQuery, ClientSearchSuggestionsQueryQueryVariables>;
 export const ClientTopSearchSuggestionsQueryDocument = {"__meta__":{"operationName":"ClientTopSearchSuggestionsQuery","operationHash":"e2385b0f11726d0068f96548f57a8dd441c064e3"}} as unknown as TypedDocumentString<ClientTopSearchSuggestionsQueryQuery, ClientTopSearchSuggestionsQueryQueryVariables>;
 export const ValidateSessionDocument = {"__meta__":{"operationName":"ValidateSession","operationHash":"8c3a5999496e227f167e9dc79697e6c478d48a9e"}} as unknown as TypedDocumentString<ValidateSessionMutation, ValidateSessionMutationVariables>;

package/@generated/persisted-documents.json

@@ -1,5 +1,4 @@
 {
-  "b227071b0388469d7b90d04cff4cbc11f8f134d4": "fragment ProductSummary_product on StoreProduct { additionalProperty { name propertyID value valueReference } advertisement { adId adResponseId } brand { brandName: name } brand { name } deliveryPromiseBadges { typeName } gtin hasSpecifications image { alternateName url } isVariantOf { name productGroupID skuVariants { activeVariations allVariantsByName availableVariations slugsMap } } isVariantOf { name productGroupID skuVariants { activeVariations allVariantProducts { name productID } availableVariations slugsMap } } name offers { lowPrice lowPriceWithTaxes offers { availability listPrice listPriceWithTaxes price priceToken priceWithTaxes quantity seller { identifier } } } id: productID sku slug unitMultiplier unitMultiplier } query ClientRecommendationsQuery($campaignVrn: String!, $products: [String!], $userId: String) { recommendations(userId: $userId, campaignVrn: $campaignVrn, products: $products) { campaign { id title type } correlationId products { ...ProductSummary_product } } }",
   "9baae331b75848a310fecb457e8c971ae27897ff": "query ServerAccountPageQuery { accountProfile { name } }",
   "d46841b30ae1f6350021b5cf02f253d56c848664": "fragment ServerCollectionPage on Query { collection(slug: $slug) { id } } query ServerCollectionPageQuery($slug: String!) { collection(slug: $slug) { breadcrumbList { itemListElement { item name position } } meta { selectedFacets { key value } } otherLocales { locale slug } seo { description title } } ...ServerCollectionPage }",
   "b89e93519be01aebc01c402489a0ae640d38675a": "fragment CartProductItem on StoreProduct { additionalProperty { name propertyID value valueReference } brand { name } gtin image { alternateName url } isVariantOf { name productGroupID skuVariants { activeVariations availableVariations slugsMap } } name sku unitMultiplier } fragment ProductDetailsFragment_product on StoreProduct { additionalProperty { name propertyID value valueReference } brand { name } description gtin image { alternateName url } isVariantOf { name productGroupID skuVariants { activeVariations allVariantProducts { name productID } availableVariations slugsMap } } name offers { lowPrice lowPriceWithTaxes offers { availability listPrice listPriceWithTaxes price priceToken priceWithTaxes quantity seller { identifier } } } id: productID sku unitMultiplier ...CartProductItem } fragment ServerProduct on Query { product(locator: $locator) { id: productID } } query ServerProductQuery($locator: [IStoreSelectedFacet!]!) { product(locator: $locator) { brand { name } breadcrumbList { itemListElement { item name position } } description gtin image { alternateName url } isVariantOf { productGroupID } mpn name offers { highPrice lowPrice lowPriceWithTaxes offers { availability itemCondition price priceCurrency priceToken priceValidUntil seller { identifier } } priceCurrency } otherLocales { locale slug } id: productID releaseDate seo { canonical description title } sku ...ProductDetailsFragment_product } ...ServerProduct }",
@@ -30,6 +29,7 @@
   "ee14fd92b4a04fc3751efcbfcb60b3886d912253": "fragment ClientManyProducts on Query { search( first: $first after: $after sort: $sort term: $term selectedFacets: $selectedFacets sponsoredCount: $sponsoredCount ) { products { pageInfo { totalCount } } } } fragment ProductSummary_product on StoreProduct { additionalProperty { name propertyID value valueReference } advertisement { adId adResponseId } brand { brandName: name } brand { name } deliveryPromiseBadges { typeName } gtin hasSpecifications image { alternateName url } isVariantOf { name productGroupID skuVariants { activeVariations allVariantsByName availableVariations slugsMap } } isVariantOf { name productGroupID skuVariants { activeVariations allVariantProducts { name productID } availableVariations slugsMap } } name offers { lowPrice lowPriceWithTaxes offers { availability listPrice listPriceWithTaxes price priceToken priceWithTaxes quantity seller { identifier } } } id: productID sku slug unitMultiplier unitMultiplier } query ClientManyProductsQuery($after: String, $first: Int!, $selectedFacets: [IStoreSelectedFacet!]!, $sort: StoreSort!, $sponsoredCount: Int, $term: String!) { search( first: $first after: $after sort: $sort term: $term selectedFacets: $selectedFacets sponsoredCount: $sponsoredCount ) { products { edges { node { ...ProductSummary_product } } pageInfo { totalCount } } } ...ClientManyProducts }",
   "7e1b06c167e411905ceac9db11c1a6a7892cfdd6": "fragment ProductComparisonFragment_product on StoreProduct { additionalProperty { name propertyID value valueReference } advertisement { adId adResponseId } brand { name } description gtin hasSpecifications image { alternateName url } isVariantOf { name productGroupID skuVariants { activeVariations allVariantProducts { name productID } availableVariations slugsMap } } name offers { lowPrice lowPriceWithTaxes offers { availability listPrice listPriceWithTaxes price priceToken priceWithTaxes quantity seller { identifier } } } id: productID sku skuSpecifications { field { id name originalName } values { fieldId id name originalName } } slug specificationGroups { name originalName specifications { name originalName values } } unitMultiplier } query ClientManyProductsSelectedQuery($productIds: [String!]!) { products(productIds: $productIds) { ...ProductComparisonFragment_product } }",
   "34ea14c0d4a57ddf9bc11e4be0cd2b5a6506d3d4": "query ClientProfileQuery($id: String!) { profile(id: $id) { addresses { city country geoCoordinate postalCode } } }",
+  "b227071b0388469d7b90d04cff4cbc11f8f134d4": "fragment ProductSummary_product on StoreProduct { additionalProperty { name propertyID value valueReference } advertisement { adId adResponseId } brand { brandName: name } brand { name } deliveryPromiseBadges { typeName } gtin hasSpecifications image { alternateName url } isVariantOf { name productGroupID skuVariants { activeVariations allVariantsByName availableVariations slugsMap } } isVariantOf { name productGroupID skuVariants { activeVariations allVariantProducts { name productID } availableVariations slugsMap } } name offers { lowPrice lowPriceWithTaxes offers { availability listPrice listPriceWithTaxes price priceToken priceWithTaxes quantity seller { identifier } } } id: productID sku slug unitMultiplier unitMultiplier } query ClientRecommendationsQuery($campaignVrn: String!, $products: [String!], $userId: String) { recommendations(userId: $userId, campaignVrn: $campaignVrn, products: $products) { campaign { id title type } correlationId products { ...ProductSummary_product } } }",
   "ee57cd392fdfde90620787c9954e2ecae47881f9": "fragment ClientSearchSuggestions on Query { search(first: 5, term: $term, selectedFacets: $selectedFacets) { suggestions { terms { value } } } } fragment ProductSummary_product on StoreProduct { additionalProperty { name propertyID value valueReference } advertisement { adId adResponseId } brand { brandName: name } brand { name } deliveryPromiseBadges { typeName } gtin hasSpecifications image { alternateName url } isVariantOf { name productGroupID skuVariants { activeVariations allVariantsByName availableVariations slugsMap } } isVariantOf { name productGroupID skuVariants { activeVariations allVariantProducts { name productID } availableVariations slugsMap } } name offers { lowPrice lowPriceWithTaxes offers { availability listPrice listPriceWithTaxes price priceToken priceWithTaxes quantity seller { identifier } } } id: productID sku slug unitMultiplier unitMultiplier } fragment SearchEvent_metadata on SearchMetadata { fuzzy isTermMisspelled logicalOperator } query ClientSearchSuggestionsQuery($selectedFacets: [IStoreSelectedFacet!], $term: String!) { search(first: 5, term: $term, selectedFacets: $selectedFacets) { metadata { ...SearchEvent_metadata } products { pageInfo { totalCount } } searchId suggestions { products { ...ProductSummary_product } terms { value } } } ...ClientSearchSuggestions }",
   "e2385b0f11726d0068f96548f57a8dd441c064e3": "fragment ClientTopSearchSuggestions on Query { search(first: 5, term: $term, selectedFacets: $selectedFacets) { suggestions { terms { value } } } } query ClientTopSearchSuggestionsQuery($selectedFacets: [IStoreSelectedFacet!], $term: String!) { search(first: 5, term: $term, selectedFacets: $selectedFacets) { suggestions { terms { value } } } ...ClientTopSearchSuggestions }",
   "8c3a5999496e227f167e9dc79697e6c478d48a9e": "mutation ValidateSession($search: String!, $session: IStoreSession!) { validateSession(session: $session, search: $search) { addressType b2b { contractName customerId firstName isRepresentative lastName organizationManager savedPostalCode unitId unitName userEmail userName } channel city country currency { code symbol } deliveryMode { deliveryChannel deliveryMethod deliveryWindow { endDate startDate } } geoCoordinates { latitude longitude } locale marketingData { utmCampaign utmMedium utmSource utmiCampaign utmiPage utmiPart } person { email familyName givenName id } postalCode refreshAfter } }",

package/CHANGELOG.md

@@ -3,6 +3,10 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [4.6.0-dev.3](https://github.com/vtex/faststore/compare/v4.6.0-dev.2...v4.6.0-dev.3) (2026-08-12)
+
+**Note:** Version bump only for package @faststore/core
+
 # [4.6.0-dev.2](https://github.com/vtex/faststore/compare/v4.6.0-dev.1...v4.6.0-dev.2) (2026-08-12)
 
 ### Bug Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faststore/core",
-  "version": "4.6.0-dev.2",
+  "version": "4.6.0-dev.3",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -71,11 +71,11 @@
     "style-loader": "^3.3.1",
     "swr": "^2.2.5",
     "use-sync-external-store": "^1.6.0",
-    "@faststore/diagnostics": "4.6.0-dev.2",
-    "@faststore/api": "4.6.0-dev.2",
-    "@faststore/lighthouse": "4.6.0-dev.2",
-    "@faststore/sdk": "4.6.0-dev.2",
-    "@faststore/ui": "4.6.0-dev.2"
+    "@faststore/diagnostics": "4.6.0-dev.3",
+    "@faststore/lighthouse": "4.6.0-dev.3",
+    "@faststore/sdk": "4.6.0-dev.3",
+    "@faststore/ui": "4.6.0-dev.3",
+    "@faststore/api": "4.6.0-dev.3"
   },
   "devDependencies": {
     "@cypress/code-coverage": "^3.12.1",

package/src/components/sections/RecommendationShelf/README.md

@@ -99,8 +99,11 @@ All recommendation work runs client-side after hydration:
 5. **Render** — shows `ProductShelfSkeleton` while loading; returns `null` on error or empty results; otherwise renders the carousel and optional heading.
 6. **Tracking** — when correlation and campaign identifiers are present, the shelf emits `data-af-*` attributes for Activity Flow. PDP product views use `product:*` meta tags from `pages/[slug]/p.tsx`.
 
+Steps 1 to 4 carry no presentation: they live in `src/sdk/recommendations` and are orchestrated by `useRecommendationShelf()`, which the shelf consumes.
+
 Related files:
 
+- Shared data layer: `src/sdk/recommendations/`
 - Shelf: `src/components/sections/RecommendationShelf/`
 - Hook: `src/sdk/analytics/hooks/useStartRecommendationSession.ts`
 - Layout: `src/Layout.tsx`
@@ -129,7 +132,7 @@ import { RecommendationShelf } from 'src/components/sections/RecommendationShelf
 - **`ProductCard`**: custom card component (defaults to the core `ProductCard`).
 - **`mapProductToProductCard`**: maps each recommended product (normalized `StoreProduct`) into card props. When provided, it fully owns the card props and the default `productCardConfiguration` merge no longer applies.
 
-Campaign types and VRN validation are defined in `vrn.ts` (`VRN_TYPE_TO_RECOMMENDATION`). Updates should be made there and mirrored in the CMS schema `pattern`.
+Campaign types and VRN validation are defined in `src/sdk/recommendations/vrn.ts` (`VRN_TYPE_TO_RECOMMENDATION`). Updates should be made there and mirrored in the CMS schema `pattern`.
 
 ## Placement guidelines
 

package/src/components/sections/RecommendationShelf/RecommendationShelf.tsx

@@ -1,14 +1,13 @@
 import { type ComponentType, useId, useMemo } from 'react'
 
-import { usePDP } from '@faststore/core'
-import { ProductShelf, Carousel } from '@faststore/ui'
+import { Carousel, ProductShelf } from '@faststore/ui'
 import type { ProductSummary_ProductFragment } from '@generated/graphql'
 
 import DefaultProductCard, {
   type ProductCardProps,
 } from 'src/components/product/ProductCard'
 import ProductShelfSkeleton from 'src/components/skeletons/ProductShelfSkeleton'
-import { useCart } from 'src/sdk/cart'
+import { useRecommendationShelf } from 'src/sdk/recommendations'
 import useScreenResize from 'src/sdk/ui/useScreenResize'
 
 import type {
@@ -16,48 +15,6 @@ import type {
   RecommendationShelfProps,
 } from './RecommendationShelf.types'
 import styles from './section.module.scss'
-import {
-  useRecommendations,
-  type RecommendationInput,
-} from './useRecommendations'
-import { useRecommendationUserId } from './useRecommendationUserId'
-import { getTypeFromVrn } from './vrn'
-
-function getRecommendationArguments(
-  campaignVrn: string,
-  context: { userId?: string | null; contextProducts: string[] }
-): RecommendationInput | null {
-  const { userId, contextProducts } = context
-  const type = getTypeFromVrn(campaignVrn)
-
-  // `type` is null for malformed/unknown VRNs; bail out so we never fetch (and
-  // never throw) on an invalid campaign coming from the CMS.
-  if (!type || !userId) return null
-
-  switch (type) {
-    case 'NEXT_INTERACTION':
-    case 'VISUAL_SIMILARITY':
-    case 'CROSS_SELL':
-    case 'SIMILAR_ITEMS':
-      // These campaigns need product context. Without any (e.g. `CART` context
-      // on an empty cart, or `PDP` context outside a product page), skip the
-      // fetch instead of requesting recommendations we can't anchor.
-      if (contextProducts.length === 0) {
-        return null
-      }
-      return {
-        userId,
-        campaignVrn,
-        products: contextProducts,
-      }
-    default:
-      return {
-        userId,
-        campaignVrn,
-        products: [],
-      }
-  }
-}
 
 export function RecommendationShelf<
   TCardProps extends object = ProductCardProps,
@@ -96,43 +53,14 @@ export function RecommendationShelf<
   const itemsPerPage =
     isMobile || isTablet ? itemsPerPageMobile : itemsPerPageDesktop
 
-  const userId = useRecommendationUserId(campaignVrn)
-
-  const { data: productDetailPage } = usePDP()
-  const { items: cartItems } = useCart()
-
-  // Resolve the products used as context for the request from the configured
-  // source: the current PDP product, or the (deduplicated) cart items.
-  const contextProducts = useMemo(() => {
-    if (itemsContext === 'CART') {
-      return Array.from(
-        new Set(
-          cartItems
-            .map((item) => item.itemOffered.isVariantOf.productGroupID)
-            .filter(Boolean)
-        )
-      )
-    }
-
-    const pdpProduct = productDetailPage?.product?.isVariantOf?.productGroupID
-
-    return pdpProduct ? [pdpProduct] : []
-  }, [itemsContext, cartItems, productDetailPage])
-
-  // Gate the whole feature behind the CMS opt-in: when Recommendations is
-  // disabled the shelf never requests recommendations (nor renders).
-  const recommendationArgs = enableRecommendations
-    ? getRecommendationArguments(campaignVrn, {
-        userId,
-        contextProducts,
-      })
-    : null
-
-  const { data, isLoading, error } = useRecommendations(recommendationArgs)
+  const { items, isLoading, error, campaign, correlationId } =
+    useRecommendationShelf({
+      campaignVrn,
+      enableRecommendations,
+      itemsContext,
+    })
 
-  const items = data?.products || []
-  const correlationId = data?.correlationId
-  const campaignId = data?.campaign.id
+  const campaignId = campaign?.id
 
   const productIds = useMemo(
     () => items.map((p) => p.isVariantOf.productGroupID).join(', '),
@@ -147,15 +75,6 @@ export function RecommendationShelf<
   )
 
   if (error) {
-    // Don't log `recommendationArgs`: it carries the userId. Log only
-    // non-identifying context.
-    console.error(
-      'Error fetching recommendations',
-      error.cause,
-      error.message,
-      'for campaign',
-      campaignVrn
-    )
     return null
   }
 
@@ -178,9 +97,9 @@ export function RecommendationShelf<
         : {})}
     >
       <ProductShelfSkeleton loading={isLoading} itemsPerPage={itemsPerPage}>
-        {(title || data?.campaign.title) && (
+        {(title || campaign?.title) && (
           <h2 className="text__title-section layout__content">
-            {title || data?.campaign.title}
+            {title || campaign?.title}
           </h2>
         )}
 

package/src/components/sections/RecommendationShelf/RecommendationShelf.types.ts

@@ -4,6 +4,9 @@ import type { CarouselProps } from '@faststore/ui'
 import type { ProductSummary_ProductFragment } from '@generated/graphql'
 
 import type { ProductCardProps } from 'src/components/product/ProductCard'
+import type { ItemContext } from 'src/sdk/recommendations'
+
+export type { ItemContext, RecommendationType } from 'src/sdk/recommendations'
 
 /**
  * Maps a recommendation product (a normalized `StoreProduct`, identical to the
@@ -17,14 +20,6 @@ export type RecommendationProductCardMapper<TCardProps = ProductCardProps> = (
   index: number
 ) => TCardProps
 
-/**
- * Source of the products used as context for the recommendation request:
- * - `'PDP'`: the current product detail page product.
- * - `'CART'`: the products currently in the cart (useful for cross-sell on the
- *   cart page).
- */
-export type ItemContext = 'PDP' | 'CART'
-
 export type RecommendationShelfProps<
   TCardProps extends object = ProductCardProps,
 > = {
@@ -106,13 +101,3 @@ export type RecommendationShelfProps<
     readonly bordered?: boolean
   }
 }
-
-export type RecommendationType =
-  | 'CROSS_SELL'
-  | 'SIMILAR_ITEMS'
-  | 'PERSONALIZED'
-  | 'TOP_ITEMS'
-  | 'LAST_SEEN'
-  | 'SEARCH_BASED'
-  | 'VISUAL_SIMILARITY'
-  | 'NEXT_INTERACTION'

package/src/sdk/recommendations/index.ts

@@ -0,0 +1,17 @@
+export type { ItemContext, RecommendationType } from './types'
+export type {
+  RecommendationInput,
+  RecommendationProduct,
+  RecommendationResponse,
+} from './useRecommendations'
+export { useRecommendations } from './useRecommendations'
+export { useRecommendationUserId } from './useRecommendationUserId'
+export type {
+  UseRecommendationShelfArgs,
+  UseRecommendationShelfResult,
+} from './useRecommendationShelf'
+export {
+  getRecommendationArguments,
+  useRecommendationShelf,
+} from './useRecommendationShelf'
+export { getTypeFromVrn, isValidVrn } from './vrn'

package/src/sdk/recommendations/types.ts

@@ -0,0 +1,17 @@
+/**
+ * Source of the products used as context for the recommendation request:
+ * - `'PDP'`: the current product detail page product.
+ * - `'CART'`: the products currently in the cart (useful for cross-sell on the
+ *   cart page and inside the cart drawer).
+ */
+export type ItemContext = 'PDP' | 'CART'
+
+export type RecommendationType =
+  | 'CROSS_SELL'
+  | 'SIMILAR_ITEMS'
+  | 'PERSONALIZED'
+  | 'TOP_ITEMS'
+  | 'LAST_SEEN'
+  | 'SEARCH_BASED'
+  | 'VISUAL_SIMILARITY'
+  | 'NEXT_INTERACTION'

package/src/sdk/recommendations/useRecommendationShelf.ts

@@ -0,0 +1,141 @@
+import { usePDP } from '@faststore/core'
+import { useMemo } from 'react'
+
+import { useCart } from 'src/sdk/cart'
+
+import type { ItemContext } from './types'
+import {
+  type RecommendationInput,
+  type RecommendationResponse,
+  useRecommendations,
+} from './useRecommendations'
+import { useRecommendationUserId } from './useRecommendationUserId'
+import { getTypeFromVrn } from './vrn'
+
+export function getRecommendationArguments(
+  campaignVrn: string,
+  context: { userId?: string | null; contextProducts: string[] }
+): RecommendationInput | null {
+  const { userId, contextProducts } = context
+  const type = getTypeFromVrn(campaignVrn)
+
+  // `type` is null for malformed/unknown VRNs; bail out so we never fetch (and
+  // never throw) on an invalid campaign coming from the CMS.
+  if (!type || !userId) return null
+
+  switch (type) {
+    case 'NEXT_INTERACTION':
+    case 'VISUAL_SIMILARITY':
+    case 'CROSS_SELL':
+    case 'SIMILAR_ITEMS':
+      // These campaigns need product context. Without any (e.g. `CART` context
+      // on an empty cart, or `PDP` context outside a product page), skip the
+      // fetch instead of requesting recommendations we can't anchor.
+      if (contextProducts.length === 0) {
+        return null
+      }
+      return {
+        userId,
+        campaignVrn,
+        products: contextProducts,
+      }
+    default:
+      return {
+        userId,
+        campaignVrn,
+        products: [],
+      }
+  }
+}
+
+export type UseRecommendationShelfArgs = {
+  readonly campaignVrn: string
+  /**
+   * Opt-in for VTEX Recommendations. When `false` (default) the campaign is
+   * never requested. The anonymous user id is still resolved, but it goes
+   * unused and never leaves the browser.
+   */
+  readonly enableRecommendations?: boolean
+  /**
+   * Where to read the products used as context for the recommendation request.
+   * @default 'PDP'
+   */
+  readonly itemsContext?: ItemContext
+}
+
+export type UseRecommendationShelfResult = {
+  readonly items: RecommendationResponse['products']
+  readonly isLoading: boolean
+  readonly error: unknown
+  readonly campaign?: RecommendationResponse['campaign']
+  readonly correlationId?: string
+}
+
+const EMPTY_ITEMS: RecommendationResponse['products'] = []
+
+/**
+ * Headless data layer behind every recommendation shelf: resolves the campaign
+ * type, the anonymous user id and the product context, then fetches the
+ * campaign. It renders nothing — presentation lives in the shelf components
+ * that consume it, so a new surface can reuse the campaign rules instead of
+ * reimplementing them.
+ */
+export function useRecommendationShelf({
+  campaignVrn,
+  enableRecommendations = false,
+  itemsContext = 'PDP',
+}: UseRecommendationShelfArgs): UseRecommendationShelfResult {
+  const userId = useRecommendationUserId(campaignVrn)
+
+  const { data: productDetailPage } = usePDP()
+  const { items: cartItems } = useCart()
+
+  // Resolve the products used as context for the request from the configured
+  // source: the current PDP product, or the (deduplicated) cart items.
+  const contextProducts = useMemo(() => {
+    if (itemsContext === 'CART') {
+      return Array.from(
+        new Set(
+          cartItems
+            .map((item) => item.itemOffered.isVariantOf.productGroupID)
+            .filter(Boolean)
+        )
+      )
+    }
+
+    const pdpProduct = productDetailPage?.product?.isVariantOf?.productGroupID
+
+    return pdpProduct ? [pdpProduct] : []
+  }, [itemsContext, cartItems, productDetailPage])
+
+  // Gate the whole feature behind the CMS opt-in: when Recommendations is
+  // disabled the shelf never requests recommendations (nor renders).
+  const recommendationArgs = enableRecommendations
+    ? getRecommendationArguments(campaignVrn, {
+        userId,
+        contextProducts,
+      })
+    : null
+
+  const { data, isLoading, error } = useRecommendations(recommendationArgs)
+
+  if (error) {
+    // Don't log `recommendationArgs`: it carries the userId. Log only
+    // non-identifying context.
+    console.error(
+      'Error fetching recommendations',
+      (error as { cause?: unknown })?.cause,
+      (error as { message?: string })?.message,
+      'for campaign',
+      campaignVrn
+    )
+  }
+
+  return {
+    items: error ? EMPTY_ITEMS : (data?.products ?? EMPTY_ITEMS),
+    isLoading,
+    error,
+    campaign: data?.campaign,
+    correlationId: data?.correlationId,
+  }
+}

package/src/{components/sections/RecommendationShelf → sdk/recommendations}/vrn.ts

@@ -1,4 +1,4 @@
-import type { RecommendationType } from './RecommendationShelf.types'
+import type { RecommendationType } from './types'
 
 // Single source of truth for the campaign taxonomy: maps each Intelligent Search
 // campaign VRN type to its `RecommendationType`. The supported VRN types, the

package/test/components/RecommendationShelf/RecommendationShelf.browser.test.tsx

@@ -29,23 +29,17 @@ vi.mock('src/components/skeletons/ProductShelfSkeleton', () => ({
 }))
 
 const useRecommendations = vi.hoisted(() => vi.fn())
-vi.mock(
-  'src/components/sections/RecommendationShelf/useRecommendations',
-  () => ({
-    useRecommendations,
-  })
-)
+vi.mock('src/sdk/recommendations/useRecommendations', () => ({
+  useRecommendations,
+}))
 
 const useScreenResize = vi.hoisted(() => vi.fn())
 vi.mock('src/sdk/ui/useScreenResize', () => ({ default: useScreenResize }))
 
 const useRecommendationUserId = vi.hoisted(() => vi.fn())
-vi.mock(
-  'src/components/sections/RecommendationShelf/useRecommendationUserId',
-  () => ({
-    useRecommendationUserId,
-  })
-)
+vi.mock('src/sdk/recommendations/useRecommendationUserId', () => ({
+  useRecommendationUserId,
+}))
 
 import { RecommendationShelf } from 'src/components/sections/RecommendationShelf/RecommendationShelf'
 

package/test/sdk/recommendations/useRecommendationShelf.browser.test.tsx

@@ -0,0 +1,199 @@
+import { renderHook } from '@testing-library/react'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+
+const usePDP = vi.hoisted(() => vi.fn())
+vi.mock('@faststore/core', () => ({ usePDP }))
+
+const useCart = vi.hoisted(() => vi.fn())
+vi.mock('src/sdk/cart', () => ({ useCart }))
+
+const useRecommendations = vi.hoisted(() => vi.fn())
+vi.mock('src/sdk/recommendations/useRecommendations', () => ({
+  useRecommendations,
+}))
+
+const useRecommendationUserId = vi.hoisted(() => vi.fn())
+vi.mock('src/sdk/recommendations/useRecommendationUserId', () => ({
+  useRecommendationUserId,
+}))
+
+import { useRecommendationShelf } from 'src/sdk/recommendations/useRecommendationShelf'
+
+const TOP_ITEMS_VRN = 'vrn:recommendations:acc:rec-top-items-v2:campaign-1'
+const CROSS_SELL_VRN = 'vrn:recommendations:acc:rec-cross-v2:campaign-1'
+
+const cartItem = (productGroupID: string) => ({
+  itemOffered: { isVariantOf: { productGroupID } },
+})
+
+const campaignData = {
+  products: [
+    { id: 'p-1', isVariantOf: { productGroupID: 'p-1' } },
+    { id: 'p-2', isVariantOf: { productGroupID: 'p-2' } },
+  ],
+  correlationId: 'corr-1',
+  campaign: { id: 'camp-1', title: 'Recommended for you', type: 'TOP_ITEMS' },
+}
+
+const lastArgs = () => useRecommendations.mock.calls.at(-1)?.[0]
+
+beforeEach(() => {
+  usePDP.mockReturnValue({ data: undefined })
+  useCart.mockReturnValue({ items: [] })
+  useRecommendationUserId.mockReturnValue('user-1')
+  useRecommendations.mockReturnValue({
+    data: campaignData,
+    isLoading: false,
+    error: null,
+  })
+})
+
+afterEach(() => {
+  vi.clearAllMocks()
+})
+
+describe('useRecommendationShelf', () => {
+  it('exposes the campaign payload when enabled', () => {
+    const { result } = renderHook(() =>
+      useRecommendationShelf({
+        campaignVrn: TOP_ITEMS_VRN,
+        enableRecommendations: true,
+      })
+    )
+
+    expect(result.current.items).toHaveLength(2)
+    expect(result.current.campaign?.title).toBe('Recommended for you')
+    expect(result.current.correlationId).toBe('corr-1')
+  })
+
+  it('never fetches while recommendations are disabled', () => {
+    renderHook(() => useRecommendationShelf({ campaignVrn: TOP_ITEMS_VRN }))
+
+    expect(lastArgs()).toBeNull()
+  })
+
+  it('never fetches before a userId resolves', () => {
+    useRecommendationUserId.mockReturnValue(null)
+
+    renderHook(() =>
+      useRecommendationShelf({
+        campaignVrn: TOP_ITEMS_VRN,
+        enableRecommendations: true,
+      })
+    )
+
+    expect(lastArgs()).toBeNull()
+  })
+
+  it('never fetches on a malformed campaign vrn', () => {
+    renderHook(() =>
+      useRecommendationShelf({
+        campaignVrn: 'not-a-vrn',
+        enableRecommendations: true,
+      })
+    )
+
+    expect(lastArgs()).toBeNull()
+  })
+
+  it('anchors cart-context campaigns on the deduplicated cart products', () => {
+    useCart.mockReturnValue({
+      items: [cartItem('pg-1'), cartItem('pg-2'), cartItem('pg-1')],
+    })
+
+    renderHook(() =>
+      useRecommendationShelf({
+        campaignVrn: CROSS_SELL_VRN,
+        enableRecommendations: true,
+        itemsContext: 'CART',
+      })
+    )
+
+    expect(lastArgs()).toEqual({
+      userId: 'user-1',
+      campaignVrn: CROSS_SELL_VRN,
+      products: ['pg-1', 'pg-2'],
+    })
+  })
+
+  it('skips cart-context campaigns while the cart is empty', () => {
+    renderHook(() =>
+      useRecommendationShelf({
+        campaignVrn: CROSS_SELL_VRN,
+        enableRecommendations: true,
+        itemsContext: 'CART',
+      })
+    )
+
+    expect(lastArgs()).toBeNull()
+  })
+
+  it('still fetches context-agnostic campaigns on an empty cart', () => {
+    renderHook(() =>
+      useRecommendationShelf({
+        campaignVrn: TOP_ITEMS_VRN,
+        enableRecommendations: true,
+        itemsContext: 'CART',
+      })
+    )
+
+    expect(lastArgs()).toEqual({
+      userId: 'user-1',
+      campaignVrn: TOP_ITEMS_VRN,
+      products: [],
+    })
+  })
+
+  it('follows the live cart context when not frozen', () => {
+    useCart.mockReturnValue({ items: [cartItem('pg-1')] })
+
+    const { rerender } = renderHook(() =>
+      useRecommendationShelf({
+        campaignVrn: CROSS_SELL_VRN,
+        enableRecommendations: true,
+        itemsContext: 'CART',
+      })
+    )
+
+    useCart.mockReturnValue({ items: [cartItem('pg-1'), cartItem('pg-2')] })
+    rerender()
+
+    expect(lastArgs()?.products).toEqual(['pg-1', 'pg-2'])
+  })
+
+  it('anchors PDP-context campaigns on the current product', () => {
+    usePDP.mockReturnValue({
+      data: { product: { isVariantOf: { productGroupID: 'pg-pdp' } } },
+    })
+
+    renderHook(() =>
+      useRecommendationShelf({
+        campaignVrn: CROSS_SELL_VRN,
+        enableRecommendations: true,
+      })
+    )
+
+    expect(lastArgs()?.products).toEqual(['pg-pdp'])
+  })
+
+  it('returns no items and logs without the userId on error', () => {
+    const consoleError = vi.spyOn(console, 'error').mockImplementation(() => {})
+    useRecommendations.mockReturnValue({
+      data: undefined,
+      isLoading: false,
+      error: new Error('boom'),
+    })
+
+    const { result } = renderHook(() =>
+      useRecommendationShelf({
+        campaignVrn: TOP_ITEMS_VRN,
+        enableRecommendations: true,
+      })
+    )
+
+    expect(result.current.items).toEqual([])
+    expect(result.current.error).toBeInstanceOf(Error)
+    expect(consoleError).toHaveBeenCalled()
+    expect(JSON.stringify(consoleError.mock.calls)).not.toContain('user-1')
+  })
+})

package/test/{components/RecommendationShelf → sdk/recommendations}/useRecommendationUserId.test.ts

@@ -14,7 +14,7 @@ vi.mock('src/utils/retry', () => ({
   retry: (fn: () => unknown) => Promise.resolve().then(fn),
 }))
 
-import { useRecommendationUserId } from 'src/components/sections/RecommendationShelf/useRecommendationUserId'
+import { useRecommendationUserId } from 'src/sdk/recommendations/useRecommendationUserId'
 
 const CAMPAIGN_VRN = 'vrn:recommendations:acc:rec-top-items-v2:campaign-1'
 

package/test/{components/RecommendationShelf → sdk/recommendations}/useRecommendations.test.ts

@@ -7,7 +7,7 @@ vi.mock('src/sdk/graphql/useQuery', () => ({
   useQuery: useQueryMock,
 }))
 
-import { useRecommendations } from 'src/components/sections/RecommendationShelf/useRecommendations'
+import { useRecommendations } from 'src/sdk/recommendations/useRecommendations'
 
 afterEach(() => {
   vi.clearAllMocks()

package/test/{components/RecommendationShelf → sdk/recommendations}/vrn.test.ts

@@ -1,9 +1,6 @@
 import { describe, expect, it } from 'vitest'
 
-import {
-  getTypeFromVrn,
-  isValidVrn,
-} from 'src/components/sections/RecommendationShelf/vrn'
+import { getTypeFromVrn, isValidVrn } from 'src/sdk/recommendations/vrn'
 
 const vrn = (type: string) => `vrn:recommendations:account:${type}:campaign-1`