@faststore/core 4.7.0-dev.2 → 4.7.0-dev.4

package/.turbo/turbo-generate.log

@@ -1,9 +1,9 @@
 
-> @faststore/core@4.7.0-dev.1 generate /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.7.0-dev.3 generate /home/runner/work/faststore/faststore/packages/core
 > pnpm run gen-types && pnpm run cache-graphql 
 
 
-> @faststore/core@4.7.0-dev.1 gen-types /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.7.0-dev.3 gen-types /home/runner/work/faststore/faststore/packages/core
 > node ../cli/bin/run generate-types .
 
 [STARTED] Parse Configuration
@@ -19,7 +19,7 @@
 [COMPLETED] Generate to /home/runner/work/faststore/faststore/packages/core/@generated/
 [COMPLETED] Generate outputs
 
-> @faststore/core@4.7.0-dev.1 cache-graphql /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.7.0-dev.3 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

package/.turbo/turbo-test.log

@@ -1,24 +1,25 @@
 
-> @faststore/core@4.7.0-dev.1 test /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.7.0-dev.3 test /home/runner/work/faststore/faststore/packages/core
 > vitest run
 
 
  RUN  v4.0.18 /home/runner/work/faststore/faststore/packages/core
 
-Not implemented: navigation to another Document
-Not implemented: navigation to another Document
- ✓  browser  test/sdk/ui/useScrollRestoration.browser.test.ts (43 tests) 943ms
 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) 2342ms
-     ✓ shows an error state when the list fails to load  612ms
-     ✓ requires selecting a contract before Confirm is enabled, then switches (REQ-03)  319ms
-     ✓ keeps Confirm disabled until a different contract is selected  325ms
- ✓  browser  test/components/ui/ProductGallery/GalleryPageHeightLock.browser.test.tsx (8 tests) 277ms
- ✓  browser  test/components/account/cards/MyAccountListCards.browser.test.tsx (14 tests) 1907ms
-     ✓ shows the tab bar and renders Personal cards by default  971ms
- ✓  browser  test/sdk/session/reconcileSessionLocale.browser.test.ts (5 tests) 27ms
+Not implemented: navigation to another Document
+Not implemented: navigation to another Document
+ ✓  browser  test/components/account/ContractSwitcher.browser.test.tsx (13 tests) 3129ms
+     ✓ shows an error state when the list fails to load  876ms
+     ✓ requires selecting a contract before Confirm is enabled, then switches (REQ-03)  533ms
+ ✓  browser  test/sdk/ui/useScrollRestoration.browser.test.ts (43 tests) 1002ms
+ ✓  browser  test/components/account/cards/MyAccountListCards.browser.test.tsx (14 tests) 2391ms
+     ✓ shows the tab bar and renders Personal cards by default  1007ms
+     ✓ paginates when there are more than 25 cards  358ms
+ ✓  browser  test/sdk/session/reconcileSessionLocale.browser.test.ts (5 tests) 30ms
+ ✓  browser  test/components/ui/ProductGallery/GalleryPageHeightLock.browser.test.tsx (8 tests) 162ms
+ ✓  browser  test/sdk/recommendations/useRecommendationShelf.browser.test.tsx (12 tests) 128ms
 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
@@ -48,9 +49,7 @@ Browserslist: browsers data (caniuse-lite) is 6 months old. Please run:
 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/sdk/recommendations/useRecommendationShelf.browser.test.tsx (10 tests) 171ms
- ✓  browser  test/components/RecommendationShelf/RecommendationShelf.browser.test.tsx (8 tests) 223ms
- ✓  browser  test/sdk/session/getInitialSession.browser.test.ts (6 tests) 17ms
+ ✓  browser  test/components/RecommendationShelf/RecommendationShelf.browser.test.tsx (7 tests) 255ms
 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(...).
 
@@ -280,11 +279,13 @@ 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) 1146ms
-     ✓ renders the password protection form  600ms
- ✓  browser  test/sdk/account/changeContractToken.browser.test.ts (9 tests) 52ms
- ✓  browser  test/components/account/OrganizationDrawer.browser.test.tsx (5 tests) 1220ms
-     ✓ renders the menu view with contract details and manage footer  623ms
+ ✓  browser  test/pages/password-protection.browser.test.tsx (6 tests) 1530ms
+     ✓ renders the password protection form  544ms
+ ✓  browser  test/components/account/OrganizationDrawer.browser.test.tsx (5 tests) 1630ms
+     ✓ renders the menu view with contract details and manage footer  917ms
+     ✓ opens the contract switcher and returns to the menu on back  372ms
+ ✓  browser  test/sdk/session/getInitialSession.browser.test.ts (6 tests) 38ms
+ ✓  browser  test/sdk/account/changeContractToken.browser.test.ts (9 tests) 56ms
 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)
@@ -293,10 +294,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)
 
- ✓  browser  test/sdk/localization/store-url.browser.test.ts (3 tests) 6ms
- ✓  browser  test/sdk/account/useAvailableContracts.browser.test.ts (6 tests) 28ms
- ✓  browser  test/components/templates/SearchPage/SearchWrapper.browser.test.tsx (3 tests) 37ms
- ✓  browser  test/sdk/account/useSwitchContract.browser.test.ts (4 tests) 28ms
+ ✓  browser  test/sdk/localization/store-url.browser.test.ts (3 tests) 5ms
+ ✓  browser  test/sdk/account/useAvailableContracts.browser.test.ts (6 tests) 41ms
+ ✓  browser  test/components/templates/SearchPage/SearchWrapper.browser.test.tsx (3 tests) 30ms
+ ✓  browser  test/sdk/recommendations/useRecommendationShelf.sessionFallback.browser.test.tsx (2 tests) 132ms
+ ✓  browser  test/sdk/account/useSwitchContract.browser.test.ts (4 tests) 39ms
 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)
@@ -305,9 +307,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/components/account/doLogout.browser.test.ts (1 test) 23ms
- ✓  browser  test/components/sections/Account/AccountListCards.browser.test.tsx (3 tests) 68ms
- ✓  browser  test/components/account/OrganizationDrawerHeader.browser.test.tsx (3 tests) 242ms
+ ✓  browser  test/components/account/doLogout.browser.test.ts (1 test) 22ms
+ ✓  browser  test/components/sections/Account/AccountListCards.browser.test.tsx (3 tests) 98ms
+ ✓  browser  test/components/account/OrganizationDrawerHeader.browser.test.tsx (3 tests) 301ms
+ ✓  browser  test/components/account/OrganizationDrawerFooter.browser.test.tsx (3 tests) 275ms
 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)
@@ -316,10 +319,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)
 
- ✓  browser  test/components/account/OrganizationDrawerFooter.browser.test.tsx (3 tests) 240ms
  ✓  browser  test/utils/isLocalHost.browser.test.ts (3 tests) 5ms
  ✓  browser  test/sdk/account/clearPersistedSessionState.browser.test.ts (1 test) 8ms
  ✓  browser  test/sdk/session/reconcileSessionLocale.disabled.browser.test.ts (1 test) 3ms
+ ✓  node  test/utils/localization/bindingPaths.test.ts (71 tests) 19ms
+ ✓  node  test/server/password-protection-service.test.ts (22 tests) 34ms
 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)
@@ -328,14 +332,12 @@ 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/refreshToken.browser.test.ts (1 test) 8ms
- ✓  node  test/utils/localization/bindingPaths.test.ts (71 tests) 28ms
- ✓  browser  test/components/skeletons/ProductGridSkeleton.browser.test.tsx (2 tests) 32ms
- ✓  node  test/utils/match-url.test.ts (10 tests) 11ms
- ✓  node  test/server/password-protection-service.test.ts (22 tests) 29ms
- ✓  node  test/pages/api/unlock.test.ts (15 tests) 267ms
- ✓  node  test/sdk/localization/useBindingSelector.test.tsx (22 tests) 10ms
- ✓  node  test/sdk/localization/bindingSelector.test.ts (18 tests) 9ms
+ ✓  browser  test/components/skeletons/ProductGridSkeleton.browser.test.tsx (2 tests) 38ms
+ ✓  browser  test/sdk/account/refreshToken.browser.test.ts (1 test) 3ms
+ ✓  node  test/utils/match-url.test.ts (10 tests) 9ms
+ ✓  node  test/sdk/localization/useBindingSelector.test.tsx (22 tests) 14ms
+ ✓  node  test/pages/api/unlock.test.ts (15 tests) 151ms
+ ✓  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?
 
@@ -399,18 +401,18 @@ 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) 78ms
- ✓  node  test/sdk/search/useSearchHistory.test.ts (13 tests) 44ms
- ✓  node  test/utils/cookieCacheBusting.test.ts (10 tests) 13ms
+ ✓  node  test/components/search/SearchInputComponent.test.tsx (6 tests) 74ms
+ ✓  node  test/sdk/search/useSearchHistory.test.ts (13 tests) 59ms
+ ✓  node  test/utils/cookieCacheBusting.test.ts (10 tests) 12ms
 stderr | test/pages/pvt/account/cards/index.test.ts > Cards page getServerSideProps > redirects to /pvt/account/403 when the query fails with 401/403
 { extensions: { status: 401 } }
 
 stderr | test/pages/pvt/account/cards/index.test.ts > Cards page getServerSideProps > renders the error state (no redirect) when the query fails with a non-auth status
 { extensions: { status: 502 } }
 
- ✓  node  test/pages/pvt/account/cards/index.test.ts (8 tests) 11ms
- ✓  node  test/utils/clearCookies.test.ts (20 tests) 25ms
- ✓  node  test/experimental/myAccountCmsServerSideProps.test.ts (5 tests) 9ms
+ ✓  node  test/pages/pvt/account/cards/index.test.ts (8 tests) 10ms
+ ✓  node  test/experimental/myAccountCmsServerSideProps.test.ts (5 tests) 7ms
+ ✓  node  test/utils/clearCookies.test.ts (20 tests) 30ms
  ✓  node  test/components/quotes/MyAccountListQuotesTable.test.tsx (12 tests) 380ms
 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:  [
@@ -504,65 +506,63 @@ 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) 36ms
+ ✓  node  test/pages/api/graphql.test.ts (17 tests) 29ms
 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) 30ms
- ✓  node  test/components/quotes/MyAccountListQuotes.test.tsx (9 tests) 821ms
-     ✓ navigates with the search term on blur  361ms
+ ✓  node  test/sdk/account/useSetPassword.test.ts (6 tests) 28ms
+ ✓  node  test/components/quotes/MyAccountListQuotes.test.tsx (9 tests) 806ms
+     ✓ navigates with the search term on blur  360ms
      ✓ navigates without a label param when the search is cleared  359ms
- ✓  node  test/sdk/orderEntry/useOrderEntryOperation.test.ts (8 tests) 39ms
- ✓  node  test/components/quotes/quoteFilters.test.ts (23 tests) 34ms
- ✓  node  test/utils/multipleTemplates.test.ts (8 tests) 7ms
- ✓  node  test/utils/localization/localizeRedirectDestination.test.ts (11 tests) 7ms
- ✓  node  test/sdk/account/getMyAccountRoutes.test.ts (12 tests) 6ms
- ✓  node  test/sdk/orderEntry/useOrderEntryUpload.test.ts (8 tests) 48ms
- ✓  node  test/components/quotes/MyAccountQuotesFilterSlider.test.tsx (5 tests) 137ms
- ✓  node  test/sdk/analytics/useStartRecommendationSession.test.ts (6 tests) 39ms
- ✓  node  test/server/index.test.ts (7 tests) 916ms
-       ✓ should handle options and execute  385ms
- ✓  node  test/sdk/orderEntry/useOrderEntry.test.ts (8 tests) 47ms
- ✓  node  test/proxy.localization.test.ts (5 tests) 36ms
- ✓  node  test/sdk/session/syncSalesChannelFromOrderForm.test.ts (6 tests) 8ms
- ✓  node  test/proxy.test.ts (4 tests) 15ms
- ✓  node  test/server/webops-api.test.ts (9 tests) 15ms
+ ✓  node  test/sdk/orderEntry/useOrderEntryOperation.test.ts (8 tests) 30ms
+ ✓  node  test/utils/multipleTemplates.test.ts (8 tests) 5ms
+ ✓  node  test/components/quotes/quoteFilters.test.ts (23 tests) 25ms
+ ✓  node  test/utils/localization/localizeRedirectDestination.test.ts (11 tests) 5ms
+ ✓  node  test/sdk/account/getMyAccountRoutes.test.ts (12 tests) 9ms
+ ✓  node  test/sdk/orderEntry/useOrderEntryUpload.test.ts (8 tests) 56ms
+ ✓  node  test/components/quotes/MyAccountQuotesFilterSlider.test.tsx (5 tests) 136ms
+ ✓  node  test/proxy.localization.test.ts (5 tests) 37ms
+ ✓  node  test/sdk/orderEntry/useOrderEntry.test.ts (8 tests) 30ms
+ ✓  node  test/server/index.test.ts (7 tests) 820ms
+ ✓  node  test/sdk/session/syncSalesChannelFromOrderForm.test.ts (6 tests) 9ms
+ ✓  node  test/components/quotes/MyAccountQuotesSelectedTags.test.tsx (8 tests) 117ms
+ ✓  node  test/sdk/analytics/useStartRecommendationSession.test.ts (6 tests) 57ms
+ ✓  node  test/proxy.test.ts (4 tests) 19ms
+ ✓  node  test/server/webops-api.test.ts (9 tests) 13ms
+ ✓  node  test/sdk/cart/waitForSessionValidated.test.ts (5 tests) 11ms
+ ✓  node  test/sdk/orderEntry/useOrderFormItems.test.ts (7 tests) 35ms
+ ✓  node  test/sdk/account/refreshToken.test.ts (5 tests) 7ms
  ✓  node  test/server/content/service.test.ts (5 tests) 5ms
- ✓  node  test/sdk/orderEntry/useOrderFormItems.test.ts (7 tests) 42ms
- ✓  node  test/components/quotes/MyAccountQuotesSelectedTags.test.tsx (8 tests) 110ms
- ✓  node  test/sdk/account/refreshToken.test.ts (5 tests) 10ms
- ✓  node  test/sdk/cart/waitForSessionValidated.test.ts (5 tests) 10ms
- ✓  node  test/server/cms/global.test.ts (3 tests) 5ms
- ✓  node  test/sdk/localization/store-url.test.ts (1 test) 4ms
- ✓  node  test/sdk/auth/useAuth.test.ts (5 tests) 29ms
- ✓  node  test/components/quotes/MyAccountQuotesStatusSelector.test.tsx (6 tests) 119ms
- ✓  node  test/sdk/analytics/hasEnabledRecommendationShelf.test.ts (6 tests) 5ms
- ✓  node  test/utils/getRequestHostname.test.ts (12 tests) 6ms
+ ✓  node  test/server/cms/global.test.ts (3 tests) 6ms
+ ✓  node  test/sdk/localization/store-url.test.ts (1 test) 3ms
+ ✓  node  test/sdk/auth/useAuth.test.ts (5 tests) 22ms
+ ✓  node  test/components/quotes/MyAccountQuotesStatusSelector.test.tsx (6 tests) 126ms
+ ✓  node  test/utils/getRequestHostname.test.ts (12 tests) 7ms
  ✓  node  test/server/rootSpan.test.ts (4 tests) 39ms
- ✓  node  test/pages/api/preview.test.ts (2 tests) 9ms
- ✓  node  test/components/search/SearchInput.test.ts (6 tests) 7ms
+ ✓  node  test/pages/api/preview.test.ts (2 tests) 8ms
+ ✓  node  test/components/search/SearchInput.test.ts (6 tests) 9ms
+ ✓  node  test/utils/validateSessionRefreshToken.test.ts (6 tests) 10ms
  ✓  node  test/components/account/Layout.test.tsx (6 tests) 63ms
- ✓  node  test/utils/validateSessionRefreshToken.test.ts (6 tests) 5ms
- ✓  node  test/sdk/recommendations/vrn.test.ts (5 tests) 5ms
- ✓  node  test/utils/retry.test.ts (5 tests) 13ms
- ✓  node  test/server/cms/index.test.ts (2 tests) 5ms
- ✓  node  test/sdk/account/getB2BSessionClaims.test.ts (4 tests) 5ms
- ✓  node  test/utils/unlockResponse.test.ts (11 tests) 8ms
+ ✓  node  test/sdk/recommendations/vrn.test.ts (5 tests) 4ms
+ ✓  node  test/utils/retry.test.ts (5 tests) 14ms
+ ✓  node  test/server/cms/index.test.ts (2 tests) 6ms
+ ✓  node  test/sdk/account/getB2BSessionClaims.test.ts (4 tests) 4ms
+ ✓  node  test/utils/unlockResponse.test.ts (11 tests) 4ms
  ✓  node  test/server/cms/myAccountDefaultSections.test.ts (5 tests) 4ms
- ✓  node  test/sdk/recommendations/useRecommendationUserId.test.ts (4 tests) 188ms
- ✓  node  test/sdk/recommendations/useRecommendations.test.ts (2 tests) 4ms
- ✓  node  test/components/account/OrganizationDrawerBody.test.tsx (3 tests) 38ms
+ ✓  node  test/sdk/recommendations/useRecommendationUserId.test.ts (4 tests) 191ms
+ ✓  node  test/sdk/recommendations/useRecommendations.test.ts (2 tests) 5ms
  ✓  node  test/utils/isLocalHost.test.ts (7 tests) 4ms
+ ✓  node  test/components/account/OrganizationDrawerBody.test.tsx (3 tests) 54ms
  ✓  node  test/utils/userOrderStatus.test.ts (3 tests) 3ms
- ✓  node  test/utils/getCookie.test.ts (4 tests) 4ms
+ ✓  node  test/utils/getCookie.test.ts (4 tests) 5ms
  ✓  node  test/sdk/analytics/utils.test.ts (2 tests) 4ms
- ✓  node  test/instrumentation.test.ts (3 tests) 6ms
- ✓  node  test/components/auth/ProfileChallenge.test.tsx (3 tests) 28ms
- ✓  node  test/components/quotes/MyAccountQuoteStatusBadge.test.tsx (2 tests) 31ms
- ✓  node  test/sdk/account/clearPersistedSessionState.test.ts (1 test) 10ms
+ ✓  node  test/components/auth/ProfileChallenge.test.tsx (3 tests) 38ms
+ ✓  node  test/instrumentation.test.ts (3 tests) 7ms
+ ✓  node  test/sdk/account/clearPersistedSessionState.test.ts (1 test) 15ms
+ ✓  node  test/components/quotes/MyAccountQuoteStatusBadge.test.tsx (2 tests) 24ms
 
  Test Files  87 passed (87)
-      Tests  698 passed (698)
-   Start at  20:10:15
-   Duration  41.13s (transform 9.78s, setup 0ms, import 36.14s, tests 13.03s, environment 52.30s)
+      Tests  695 passed (695)
+   Start at  21:11:21
+   Duration  43.29s (transform 10.74s, setup 0ms, import 37.56s, tests 15.12s, environment 54.08s)
 

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [4.7.0-dev.4](https://github.com/vtex/faststore/compare/v4.7.0-dev.3...v4.7.0-dev.4) (2026-08-25)
+
+### Bug Fixes
+
+- **core:** address Sonar and session fallback timing ([c0ad09f](https://github.com/vtex/faststore/commit/c0ad09f4903627ce39b233013af40ab2505b5871))
+- **core:** make session enable flag assignment Sonar-clear ([2fdfe96](https://github.com/vtex/faststore/commit/2fdfe96d6dccb22c33fb9f7f250f5531ef6f6f47))
+- **core:** start shelf session fallback in parallel with userId lookup ([6f5afa5](https://github.com/vtex/faststore/commit/6f5afa587a554ab9a4289c01aa6c6eb57e027680))
+
+### Features
+
+- **core:** gate recommendation session by feature flag with shelf fallback ([901b345](https://github.com/vtex/faststore/commit/901b3456943de25f028d6443f5f62b9de1db6ad3))
+
+# [4.7.0-dev.3](https://github.com/vtex/faststore/compare/v4.7.0-dev.2...v4.7.0-dev.3) (2026-08-25)
+
+**Note:** Version bump only for package @faststore/core
+
 # [4.7.0-dev.2](https://github.com/vtex/faststore/compare/v4.7.0-dev.1...v4.7.0-dev.2) (2026-08-24)
 
 ### Bug Fixes

package/cms/faststore/components/cms_component__recommendationshelf.jsonc

@@ -3,16 +3,10 @@
   "$componentKey": "RecommendationShelf",
   "$componentTitle": "Recommendation Shelf",
   "title": "Recommendation Shelf",
-  "description": "Display a carousel of personalized product recommendations from a VTEX Recommendations campaign. Enable the shelf with the Enable recommendations toggle (off by default).",
+  "description": "Display a carousel of personalized product recommendations from a VTEX Recommendations campaign.",
   "type": "object",
   "required": ["campaignVrn"],
   "properties": {
-    "enableRecommendations": {
-      "title": "Enable recommendations?",
-      "description": "When enabled, starts the VTEX Recommendations personalization session (once per browser session) and fetches personalized products for this shelf. Off by default so stores that do not use Recommendations never hit the Recommendations API.",
-      "type": "boolean",
-      "default": false
-    },
     "title": {
       "title": "Title",
       "description": "Override the shelf title. If not set, the campaign title will be used.",

package/cms/faststore/schema.json

@@ -3872,16 +3872,10 @@
       "$componentKey": "RecommendationShelf",
       "$componentTitle": "Recommendation Shelf",
       "title": "Recommendation Shelf",
-      "description": "Display a carousel of personalized product recommendations from a VTEX Recommendations campaign. Enable the shelf with the Enable recommendations toggle (off by default).",
+      "description": "Display a carousel of personalized product recommendations from a VTEX Recommendations campaign.",
       "type": "object",
       "required": ["campaignVrn"],
       "properties": {
-        "enableRecommendations": {
-          "title": "Enable recommendations?",
-          "description": "When enabled, starts the VTEX Recommendations personalization session (once per browser session) and fetches personalized products for this shelf. Off by default so stores that do not use Recommendations never hit the Recommendations API.",
-          "type": "boolean",
-          "default": false
-        },
         "title": {
           "title": "Title",
           "description": "Override the shelf title. If not set, the campaign title will be used.",

package/discovery.config.default.js

@@ -202,6 +202,11 @@ module.exports = {
     },
     refreshToken: false,
     scrollRestoration: false,
+    // Opt-in flag for VTEX Recommendations. When enabled, Layout starts the
+    // personalization session on every page. When disabled (default), the
+    // session starts only as a RecommendationShelf fallback when userId is
+    // missing.
+    enableRecommendations: false,
     /** Package names to transpile (e.g. ['@vtex/components']). Use a non-empty list to enable Next.js transpilation. */
     transpilePackages: [],
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faststore/core",
-  "version": "4.7.0-dev.2",
+  "version": "4.7.0-dev.4",
   "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/api": "4.7.0-dev.2",
-    "@faststore/diagnostics": "4.7.0-dev.2",
-    "@faststore/lighthouse": "4.7.0-dev.2",
-    "@faststore/sdk": "4.7.0-dev.2",
-    "@faststore/ui": "4.7.0-dev.2"
+    "@faststore/diagnostics": "4.7.0-dev.4",
+    "@faststore/lighthouse": "4.7.0-dev.4",
+    "@faststore/sdk": "4.7.0-dev.4",
+    "@faststore/api": "4.7.0-dev.4",
+    "@faststore/ui": "4.7.0-dev.4"
   },
   "devDependencies": {
     "@cypress/code-coverage": "^3.12.1",

package/src/Layout.tsx

@@ -7,9 +7,9 @@ function Layout({ children }: PropsWithChildren) {
   const props = isValidElement(children) ? children.props : undefined
   usePageViewEvent(props)
 
-  // Starts the personalization session once per browser session when the page
-  // CMS data includes a RecommendationShelf with `enableRecommendations: true`.
-  useStartRecommendationSession(props)
+  // Starts the personalization session once per browser session on every page
+  // when `experimental.enableRecommendations` is true.
+  useStartRecommendationSession()
 
   return <>{children}</>
 }

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

@@ -4,7 +4,7 @@ CMS section that renders a carousel of personalized product recommendations from
 
 - **Data source:** VTEX Recommendations BFF, exposed by `@faststore/api` through the `recommendations` GraphQL query.
 - **Registration:** global CMS component (`$componentKey: "RecommendationShelf"`), available on any page via CMS.
-- **Opt-in via CMS:** enable Recommendations with the **Enable recommendations?** toggle on the shelf (default `false`). No store code changes or feature flags are required.
+- **Session opt-in:** personalization session starts via the `experimental.enableRecommendations` discovery feature flag (Layout, every page). When the flag is off, any mounted Recommendation Shelf starts the session as a fallback if `userId` is missing.
 
 ## Contents
 
@@ -22,7 +22,7 @@ CMS section that renders a carousel of personalized product recommendations from
 
 The shelf renders products only when the following conditions are met:
 
-1. **Enable recommendations on the shelf.** Set **Enable recommendations?** to `true` on the Recommendation Shelf in the CMS. This opts the store into the personalization session (`startRecommendationSession` mutation, owned by Layout) and allows the shelf to fetch recommendations. Without it (default `false`), no session is started and the shelf does not fetch.
+1. **Personalization session.** Prefer enabling `experimental.enableRecommendations` in `discovery.config` so `Layout` starts the session on every page. If the flag is off, any mounted Recommendation Shelf starts the session as a fallback when `userId` is missing (cookie + in-memory lock still limit this to one attempt per browser session).
 
 2. **Active VTEX Recommendations campaign.** Provide a valid campaign **VRN**. Example: `vrn:recommendations:my-account:rec-persona-v2:abc123`.
 
@@ -32,7 +32,19 @@ The shelf renders products only when the following conditions are met:
 
 ## Setup
 
-### 1. Obtain the campaign VRN
+### 1. Opt into the personalization session (recommended)
+
+In the store's `discovery.config.js` (or local override), set:
+
+```js
+experimental: {
+  enableRecommendations: true,
+}
+```
+
+Default is `false`. With the flag on, `Layout` calls `startRecommendationSession` on every page without inspecting CMS data. With the flag off, placing a Recommendation Shelf on a page still starts the session when `userId` is missing.
+
+### 2. Obtain the campaign VRN
 
 In the VTEX Recommendations admin, create or select a campaign and copy its **VRN**. The expected format is:
 
@@ -42,9 +54,9 @@ vrn:recommendations:<account>:<campaign-type>:<campaign-id>
 
 Supported `<campaign-type>` values are listed under [Campaign types (VRN) and context](#campaign-types-vrn-and-context).
 
-### 2. Add Recommendation Shelf via CMS
+### 3. Add Recommendation Shelf via CMS
 
-Add **Recommendation Shelf** to the target page (home, PDP, PLP, cart, and so on), configure at least **Campaign VRN** (required), and turn **Enable recommendations?** on.
+Add **Recommendation Shelf** to the target page (home, PDP, PLP, cart, and so on) and configure at least **Campaign VRN** (required).
 
 ## CMS configuration
 
@@ -52,7 +64,6 @@ Schema: `cms/faststore/components/cms_component__recommendationshelf.jsonc`.
 
 | CMS property | Key | Type | Required | Default | Description |
 | --- | --- | --- | --- | --- | --- |
-| Enable recommendations? | `enableRecommendations` | boolean | No | `false` | Opt-in that starts the personalization session (via Layout) and allows this shelf to fetch recommendations. |
 | Title | `title` | string | No | — | Overrides the shelf title. Falls back to the campaign title. If both are empty, the heading is not rendered. |
 | Campaign VRN | `campaignVrn` | string | **Yes** | — | Recommendation campaign VRN. Validated by regex (see campaign types below). |
 | Items context | `itemsContext` | `PDP` \| `CART` | No | `PDP` | Source of products used as request context. Applies only to context-based campaigns. |
@@ -92,9 +103,9 @@ Context-based campaigns (cross-sell, similar items, visual similarity, next inte
 
 All recommendation work runs client-side after hydration:
 
-1. **Session start (CMS opt-in)** — `Layout` calls `useStartRecommendationSession(pageProps)` once. The hook checks whether any `RecommendationShelf` in the CMS data has `enableRecommendations: true` and no-ops when none do. Multiple enabled shelves on the same page still start the session only once (in-memory lock + session cookie).
+1. **Session start (feature flag + shelf fallback)** — `Layout` calls `useStartRecommendationSession()` once. The hook starts the session when `experimental.enableRecommendations` is `true` (no CMS lookup). When the flag is `false`, `useRecommendationShelf()` (used by every RecommendationShelf) calls the same hook as a fallback while `userId` is missing (`undefined` or `null`), in parallel with cookie retry. Cookie (`vtex-rec-user-start-session`) + in-memory lock ensure at most one attempt per browser session. If `userId` is already available, the shelf does not start the session.
 2. **User id resolution** — `useRecommendationUserId()` reads the `vtex-rec-user-id` cookie, retrying until a value is available or the retry budget is exhausted.
-3. **Request arguments** — when enabled, `getRecommendationArguments()` builds `{ userId, campaignVrn, products }` or returns `null` when the VRN is invalid, the user id is missing, or a context-based campaign has no context products. When disabled, arguments stay `null`.
+3. **Request arguments** — `getRecommendationArguments()` builds `{ userId, campaignVrn, products }` or returns `null` when the VRN is invalid, the user id is missing, or a context-based campaign has no context products.
 4. **Fetch** — `useRecommendations()` runs `ClientRecommendationsQuery` and returns `products`, `correlationId`, and `campaign`.
 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`.
@@ -107,6 +118,7 @@ Related files:
 - Shelf: `src/components/sections/RecommendationShelf/`
 - Hook: `src/sdk/analytics/hooks/useStartRecommendationSession.ts`
 - Layout: `src/Layout.tsx`
+- Flag: `discovery.config.default.js` → `experimental.enableRecommendations`
 
 ## Code-level overrides
 
@@ -116,7 +128,6 @@ In addition to CMS props, the component accepts code-level overrides (not expose
 import { RecommendationShelf } from 'src/components/sections/RecommendationShelf'
 
 <RecommendationShelf
-  enableRecommendations
   campaignVrn="vrn:recommendations:my-account:rec-cross-v2:abc123"
   itemsContext="PDP"
   ProductCard={MyCustomCard}
@@ -143,7 +154,7 @@ As a global component, the shelf can be placed on any CMS page. Suggested placem
 - **Cart:** cross-sell with `itemsContext: CART`.
 - **PLP:** context-agnostic campaigns.
 
-The personalization session runs only when at least one shelf has **Enable recommendations?** turned on.
+Prefer enabling `experimental.enableRecommendations` so the session is ready on every page. Stores without the flag and without a Recommendation Shelf never call `startRecommendationSession`.
 
 ## Privacy and cache
 
@@ -155,11 +166,10 @@ The personalization session runs only when at least one shelf has **Enable recom
 
 **The shelf does not render.** Check, in order:
 
-1. Is **Enable recommendations?** set to `true` on the shelf?
-2. Is `campaignVrn` valid and is the campaign active?
-3. Is the `vtex-rec-user-id` cookie available? Without a user id, the shelf does not fetch.
-4. For context-based campaigns, is product context available (`PDP` on a product page, or a non-empty cart for `CART`)?
-5. Did the campaign return products? An empty response renders nothing by design.
+1. Is `campaignVrn` valid and is the campaign active?
+2. Is the `vtex-rec-user-id` cookie available? Without a user id, the shelf does not fetch. With the discovery flag off, confirm the shelf fallback started the session (`vtex-rec-user-start-session`).
+3. For context-based campaigns, is product context available (`PDP` on a product page, or a non-empty cart for `CART`)?
+4. Did the campaign return products? An empty response renders nothing by design.
 
 **Skeleton never resolves.** Inspect the console and the GraphQL `recommendations` response for pending or failing requests.
 

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

@@ -21,7 +21,6 @@ export function RecommendationShelf<
 >({
   title,
   campaignVrn,
-  enableRecommendations = false,
   itemsContext = 'PDP',
   ProductCard,
   mapProductToProductCard,
@@ -56,7 +55,6 @@ export function RecommendationShelf<
   const { items, isLoading, error, campaign, correlationId } =
     useRecommendationShelf({
       campaignVrn,
-      enableRecommendations,
       itemsContext,
     })
 

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

@@ -25,13 +25,6 @@ export type RecommendationShelfProps<
 > = {
   readonly title?: string
   readonly campaignVrn: string
-  /**
-   * Opt-in for VTEX Recommendations on this shelf. When `true`, Layout starts
-   * the personalization session (`useStartRecommendationSession`) and this
-   * shelf fetches recommendations. When `false` (default), neither happens.
-   * @default false
-   */
-  readonly enableRecommendations?: boolean
   /**
    * Where to read the products used as context for the recommendation request:
    * - `'PDP'`: the current product detail page product.