@faststore/core 4.5.1 → 4.6.0-dev.1

package/.turbo/turbo-generate.log

@@ -1,9 +1,9 @@
 
-> @faststore/core@4.5.1-dev.2 generate /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.6.0-dev.0 generate /home/runner/work/faststore/faststore/packages/core
 > pnpm run gen-types && pnpm run cache-graphql 
 
 
-> @faststore/core@4.5.1-dev.2 gen-types /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.6.0-dev.0 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.5.1-dev.2 cache-graphql /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.6.0-dev.0 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,9 +1,9 @@
 
-> @faststore/core@4.5.1-dev.2 test /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.6.0-dev.0 test /home/runner/work/faststore/faststore/packages/core
 > vitest run
 
 
- RUN  v4.0.7 /home/runner/work/faststore/faststore/packages/core
+ RUN  v4.0.18 /home/runner/work/faststore/faststore/packages/core
 
 Not implemented: navigation to another Document
 Not implemented: navigation to another Document
@@ -19,7 +19,7 @@ Not implemented: navigation to another Document
     at a (/home/runner/work/faststore/faststore/packages/sdk/dist/es/index.mjs:354:17) {
   [cause]: TypeError: Invalid URL
       at new URL (node:internal/url:828:25)
-      at new URL$1 (file:///home/runner/work/faststore/faststore/node_modules/.pnpm/vitest@4.0.7_@types+node@20.19.13_jiti@2.6.1_jsdom@27.4.0_sass@1.97.3_terser@5.46.0_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/chunks/index.CWIFvlX5.js:469:9)
+      at new URL$1 (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/index.CyBMJtT7.js:556:9)
       at new Request (node:internal/deps/undici/undici:10971:25)
       at fetch (node:internal/deps/undici/undici:11891:25)
       at fetch (node:internal/deps/undici/undici:16414:10)
@@ -36,16 +36,18 @@ 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/sdk/ui/useScrollRestoration.browser.test.ts (43 tests) 1024ms
+ ✓  browser  test/sdk/ui/useScrollRestoration.browser.test.ts (43 tests) 1055ms
 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) 161ms
- ✓  browser  test/components/account/ContractSwitcher.browser.test.tsx (13 tests) 2109ms
-     ✓ shows an error state when the list fails to load  511ms
-     ✓ requires selecting a contract before Confirm is enabled, then switches (REQ-03)  334ms
- ✓  browser  test/components/ui/ProductGallery/GalleryPageHeightLock.browser.test.tsx (8 tests) 148ms
- ✓  browser  test/sdk/session/reconcileSessionLocale.browser.test.ts (5 tests) 32ms
+ ✓  browser  test/components/RecommendationShelf/RecommendationShelf.browser.test.tsx (8 tests) 209ms
+ ✓  browser  test/components/account/ContractSwitcher.browser.test.tsx (13 tests) 2760ms
+     ✓ shows an error state when the list fails to load  743ms
+     ✓ requires selecting a contract before Confirm is enabled, then switches (REQ-03)  391ms
+     ✓ does not reload when the switch returns false  308ms
+ ✓  browser  test/sdk/session/reconcileSessionLocale.browser.test.ts (5 tests) 63ms
+ ✓  browser  test/components/ui/ProductGallery/GalleryPageHeightLock.browser.test.tsx (8 tests) 252ms
+ ✓  browser  test/sdk/session/getInitialSession.browser.test.ts (6 tests) 26ms
 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(...).
 
@@ -275,13 +277,11 @@ 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) 1545ms
-     ✓ renders the password protection form  594ms
- ✓  browser  test/sdk/session/getInitialSession.browser.test.ts (6 tests) 27ms
- ✓  browser  test/components/account/OrganizationDrawer.browser.test.tsx (5 tests) 1942ms
-     ✓ renders the menu view with contract details and manage footer  936ms
-     ✓ opens the contract switcher and returns to the menu on back  452ms
- ✓  browser  test/sdk/account/changeContractToken.browser.test.ts (9 tests) 55ms
+ ✓  browser  test/pages/password-protection.browser.test.tsx (6 tests) 1700ms
+     ✓ renders the password protection form  845ms
+ ✓  browser  test/components/account/OrganizationDrawer.browser.test.tsx (5 tests) 1546ms
+     ✓ renders the menu view with contract details and manage footer  853ms
+ ✓  browser  test/sdk/account/changeContractToken.browser.test.ts (9 tests) 112ms
 stderr | test/sdk/localization/store-url.browser.test.ts
 Error in optimistic validation: TypeError: Cannot read properties of undefined (reading 'read')
     at validateCart (/home/runner/work/faststore/faststore/packages/core/src/sdk/cart/index.ts:121:27)
@@ -289,10 +289,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) 8ms
- ✓  browser  test/sdk/account/useAvailableContracts.browser.test.ts (6 tests) 40ms
- ✓  browser  test/components/templates/SearchPage/SearchWrapper.browser.test.tsx (3 tests) 35ms
- ✓  browser  test/sdk/account/useSwitchContract.browser.test.ts (4 tests) 39ms
+ ✓  browser  test/sdk/localization/store-url.browser.test.ts (3 tests) 10ms
+ ✓  browser  test/sdk/account/useAvailableContracts.browser.test.ts (6 tests) 41ms
+ ✓  browser  test/components/templates/SearchPage/SearchWrapper.browser.test.tsx (3 tests) 38ms
+ ✓  browser  test/sdk/account/useSwitchContract.browser.test.ts (4 tests) 43ms
 stderr | test/components/account/doLogout.browser.test.ts
 Error in optimistic validation: TypeError: Cannot read properties of undefined (reading 'read')
     at validateCart (/home/runner/work/faststore/faststore/packages/core/src/sdk/cart/index.ts:121:27)
@@ -300,8 +300,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) 20ms
- ✓  browser  test/components/account/OrganizationDrawerHeader.browser.test.tsx (3 tests) 265ms
+ ✓  browser  test/components/account/doLogout.browser.test.ts (1 test) 18ms
+ ✓  browser  test/components/account/OrganizationDrawerHeader.browser.test.tsx (3 tests) 295ms
 stderr | test/sdk/account/clearPersistedSessionState.browser.test.ts
 Error in optimistic validation: TypeError: Cannot read properties of undefined (reading 'read')
     at validateCart (/home/runner/work/faststore/faststore/packages/core/src/sdk/cart/index.ts:121:27)
@@ -309,13 +309,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/account/clearPersistedSessionState.browser.test.ts (1 test) 12ms
- ✓  browser  test/components/account/OrganizationDrawerFooter.browser.test.tsx (3 tests) 248ms
- ✓  browser  test/utils/isLocalHost.browser.test.ts (3 tests) 3ms
- ✓  browser  test/sdk/session/reconcileSessionLocale.disabled.browser.test.ts (1 test) 2ms
- ✓  node  test/utils/localization/bindingPaths.test.ts (71 tests) 27ms
- ✓  browser  test/components/skeletons/ProductGridSkeleton.browser.test.tsx (2 tests) 38ms
- ✓  node  test/server/password-protection-service.test.ts (22 tests) 30ms
+ ✓  browser  test/sdk/account/clearPersistedSessionState.browser.test.ts (1 test) 8ms
+ ✓  browser  test/components/account/OrganizationDrawerFooter.browser.test.tsx (3 tests) 255ms
+ ✓  browser  test/utils/isLocalHost.browser.test.ts (3 tests) 5ms
+ ✓  browser  test/sdk/session/reconcileSessionLocale.disabled.browser.test.ts (1 test) 3ms
+ ✓  node  test/utils/localization/bindingPaths.test.ts (71 tests) 29ms
 stderr | test/sdk/account/refreshToken.browser.test.ts
 Error in optimistic validation: TypeError: Cannot read properties of undefined (reading 'read')
     at validateCart (/home/runner/work/faststore/faststore/packages/core/src/sdk/cart/index.ts:121:27)
@@ -323,11 +321,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/refreshToken.browser.test.ts (1 test) 4ms
+ ✓  browser  test/components/skeletons/ProductGridSkeleton.browser.test.tsx (2 tests) 48ms
+ ✓  node  test/server/password-protection-service.test.ts (22 tests) 38ms
  ✓  node  test/utils/match-url.test.ts (10 tests) 10ms
- ✓  browser  test/sdk/account/refreshToken.browser.test.ts (1 test) 5ms
  ✓  node  test/sdk/localization/useBindingSelector.test.tsx (22 tests) 14ms
- ✓  node  test/pages/api/unlock.test.ts (15 tests) 206ms
- ✓  node  test/sdk/localization/bindingSelector.test.ts (18 tests) 9ms
+ ✓  node  test/pages/api/unlock.test.ts (15 tests) 284ms
+ ✓  node  test/sdk/localization/bindingSelector.test.ts (18 tests) 11ms
 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?
 
@@ -391,24 +391,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) 71ms
- ✓  node  test/utils/cookieCacheBusting.test.ts (10 tests) 12ms
- ✓  node  test/sdk/search/useSearchHistory.test.ts (13 tests) 58ms
- ✓  node  test/experimental/myAccountCmsServerSideProps.test.ts (5 tests) 9ms
- ✓  node  test/utils/clearCookies.test.ts (20 tests) 27ms
- ✓  node  test/components/quotes/MyAccountListQuotesTable.test.tsx (12 tests) 419ms
-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) 34ms
- ✓  node  test/components/quotes/quoteFilters.test.ts (23 tests) 24ms
- ✓  node  test/utils/multipleTemplates.test.ts (8 tests) 5ms
- ✓  node  test/utils/localization/localizeRedirectDestination.test.ts (11 tests) 5ms
- ✓  node  test/components/quotes/MyAccountListQuotes.test.tsx (9 tests) 804ms
-     ✓ navigates with the search term on blur  359ms
-     ✓ navigates without a label param when the search is cleared  358ms
- ✓  node  test/sdk/orderEntry/useOrderEntryOperation.test.ts (8 tests) 42ms
- ✓  node  test/sdk/orderEntry/useOrderEntryUpload.test.ts (8 tests) 56ms
+ ✓  node  test/components/search/SearchInputComponent.test.tsx (6 tests) 63ms
+ ✓  node  test/utils/cookieCacheBusting.test.ts (10 tests) 11ms
+ ✓  node  test/sdk/search/useSearchHistory.test.ts (13 tests) 63ms
+ ✓  node  test/experimental/myAccountCmsServerSideProps.test.ts (5 tests) 11ms
+ ✓  node  test/utils/clearCookies.test.ts (20 tests) 23ms
 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:  [
   {
@@ -455,47 +442,108 @@ Warning: React does not recognize the `providerProps` prop on a DOM element. If
   { message: 'bad', status: 400, type: 'BadRequestError' }
 ]
 
- ✓  node  test/pages/api/graphql.test.ts (10 tests) 25ms
- ✓  node  test/sdk/analytics/useStartRecommendationSession.test.ts (6 tests) 59ms
- ✓  node  test/components/quotes/MyAccountQuotesFilterSlider.test.tsx (5 tests) 131ms
- ✓  node  test/server/index.test.ts (7 tests) 799ms
-       ✓ should return a valid merged GraphQL schema  301ms
- ✓  node  test/proxy.localization.test.ts (5 tests) 71ms
- ✓  node  test/sdk/account/getMyAccountRoutes.test.ts (10 tests) 8ms
- ✓  node  test/sdk/orderEntry/useOrderEntry.test.ts (8 tests) 47ms
+stderr | test/pages/api/graphql.test.ts > /api/graphql request handling > maps BadRequestError thrown by execute to its status
+Something unexpected occurred querying Graphql endpoint: 
+ _ [FastStoreError]: malformed
+    at /home/runner/work/faststore/faststore/packages/core/test/pages/api/graphql.test.ts:190:31
+    at /home/runner/work/faststore/faststore/packages/core/test/pages/api/graphql.test.ts:196:39
+    at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:1024:60
+    at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:145:11
+    at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:915:26
+    at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:1243:20
+    at new Promise (<anonymous>)
+    at runWithTimeout (file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:1209:10)
+    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) {
+  extensions: { status: 400, type: 'BadRequestError' }
+}
+
+stderr | test/pages/api/graphql.test.ts > /api/graphql request handling > maps UnauthorizedError thrown by execute to its status
+Something unexpected occurred querying Graphql endpoint: 
+ te [FastStoreError]: expired
+    at /home/runner/work/faststore/faststore/packages/core/test/pages/api/graphql.test.ts:191:33
+    at /home/runner/work/faststore/faststore/packages/core/test/pages/api/graphql.test.ts:196:39
+    at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:1024:60
+    at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:145:11
+    at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:915:26
+    at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:1243:20
+    at new Promise (<anonymous>)
+    at runWithTimeout (file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:1209:10)
+    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) {
+  extensions: { status: 401, type: 'UnauthorizedError' }
+}
+
+stderr | test/pages/api/graphql.test.ts > /api/graphql request handling > maps an unexpected failure thrown by execute to its status
+Something unexpected occurred querying Graphql endpoint: 
+ Error: socket hang up
+    at /home/runner/work/faststore/faststore/packages/core/test/pages/api/graphql.test.ts:192:37
+    at /home/runner/work/faststore/faststore/packages/core/test/pages/api/graphql.test.ts:196:39
+    at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:1024:60
+    at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:145:11
+    at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:915:26
+    at file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:1243:20
+    at new Promise (<anonymous>)
+    at runWithTimeout (file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:1209:10)
+    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) 39ms
+ ✓  node  test/components/quotes/MyAccountListQuotesTable.test.tsx (12 tests) 424ms
+ ✓  node  test/components/quotes/MyAccountListQuotes.test.tsx (9 tests) 847ms
+     ✓ navigates with the search term on blur  363ms
+     ✓ navigates without a label param when the search is cleared  357ms
+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) 32ms
+ ✓  node  test/sdk/orderEntry/useOrderEntryOperation.test.ts (8 tests) 41ms
+ ✓  node  test/utils/multipleTemplates.test.ts (8 tests) 7ms
+ ✓  node  test/components/quotes/quoteFilters.test.ts (23 tests) 28ms
+ ✓  node  test/utils/localization/localizeRedirectDestination.test.ts (11 tests) 6ms
+ ✓  node  test/sdk/orderEntry/useOrderEntryUpload.test.ts (8 tests) 54ms
+ ✓  node  test/components/quotes/MyAccountQuotesFilterSlider.test.tsx (5 tests) 198ms
+ ✓  node  test/sdk/analytics/useStartRecommendationSession.test.ts (6 tests) 51ms
+ ✓  node  test/server/index.test.ts (7 tests) 809ms
+       ✓ should return a valid merged GraphQL schema  315ms
+ ✓  node  test/sdk/orderEntry/useOrderEntry.test.ts (8 tests) 42ms
+ ✓  node  test/sdk/account/getMyAccountRoutes.test.ts (10 tests) 7ms
+ ✓  node  test/proxy.localization.test.ts (5 tests) 49ms
  ✓  node  test/proxy.test.ts (4 tests) 21ms
- ✓  node  test/components/quotes/MyAccountQuotesSelectedTags.test.tsx (8 tests) 107ms
- ✓  node  test/server/webops-api.test.ts (9 tests) 23ms
- ✓  node  test/sdk/orderEntry/useOrderFormItems.test.ts (7 tests) 40ms
- ✓  node  test/sdk/account/refreshToken.test.ts (5 tests) 7ms
- ✓  node  test/server/cms/global.test.ts (3 tests) 5ms
- ✓  node  test/server/content/service.test.ts (5 tests) 4ms
+ ✓  node  test/server/webops-api.test.ts (9 tests) 14ms
+ ✓  node  test/server/content/service.test.ts (5 tests) 5ms
+ ✓  node  test/sdk/orderEntry/useOrderFormItems.test.ts (7 tests) 46ms
+ ✓  node  test/components/quotes/MyAccountQuotesSelectedTags.test.tsx (8 tests) 112ms
+ ✓  node  test/sdk/account/refreshToken.test.ts (5 tests) 9ms
+ ✓  node  test/server/cms/global.test.ts (3 tests) 6ms
  ✓  node  test/sdk/localization/store-url.test.ts (1 test) 4ms
+ ✓  node  test/sdk/auth/useAuth.test.ts (5 tests) 29ms
  ✓  node  test/sdk/analytics/hasEnabledRecommendationShelf.test.ts (6 tests) 4ms
- ✓  node  test/utils/getRequestHostname.test.ts (12 tests) 6ms
- ✓  node  test/sdk/auth/useAuth.test.ts (5 tests) 20ms
- ✓  node  test/components/quotes/MyAccountQuotesStatusSelector.test.tsx (6 tests) 144ms
- ✓  node  test/utils/validateSessionRefreshToken.test.ts (6 tests) 5ms
- ✓  node  test/pages/api/preview.test.ts (2 tests) 7ms
+ ✓  node  test/components/quotes/MyAccountQuotesStatusSelector.test.tsx (6 tests) 143ms
+ ✓  node  test/utils/getRequestHostname.test.ts (12 tests) 8ms
+ ✓  node  test/pages/api/preview.test.ts (2 tests) 11ms
  ✓  node  test/components/search/SearchInput.test.ts (6 tests) 6ms
- ✓  node  test/components/RecommendationShelf/vrn.test.ts (5 tests) 6ms
- ✓  node  test/server/cms/index.test.ts (2 tests) 7ms
- ✓  node  test/utils/retry.test.ts (5 tests) 14ms
- ✓  node  test/components/account/Layout.test.tsx (4 tests) 47ms
- ✓  node  test/components/RecommendationShelf/useRecommendationUserId.test.ts (4 tests) 191ms
+ ✓  node  test/utils/validateSessionRefreshToken.test.ts (6 tests) 6ms
+ ✓  node  test/server/rootSpan.test.ts (4 tests) 39ms
+ ✓  node  test/components/RecommendationShelf/vrn.test.ts (5 tests) 7ms
+ ✓  node  test/server/cms/index.test.ts (2 tests) 6ms
+ ✓  node  test/utils/retry.test.ts (5 tests) 19ms
+ ✓  node  test/components/account/Layout.test.tsx (4 tests) 42ms
+ ✓  node  test/components/RecommendationShelf/useRecommendationUserId.test.ts (4 tests) 183ms
  ✓  node  test/utils/unlockResponse.test.ts (11 tests) 6ms
- ✓  node  test/server/cms/myAccountDefaultSections.test.ts (5 tests) 6ms
- ✓  node  test/components/RecommendationShelf/useRecommendations.test.ts (2 tests) 3ms
- ✓  node  test/utils/isLocalHost.test.ts (7 tests) 5ms
+ ✓  node  test/server/cms/myAccountDefaultSections.test.ts (5 tests) 4ms
+ ✓  node  test/components/RecommendationShelf/useRecommendations.test.ts (2 tests) 4ms
+ ✓  node  test/utils/isLocalHost.test.ts (7 tests) 6ms
+ ✓  node  test/components/account/OrganizationDrawerBody.test.tsx (3 tests) 42ms
  ✓  node  test/utils/userOrderStatus.test.ts (3 tests) 4ms
- ✓  node  test/components/account/OrganizationDrawerBody.test.tsx (3 tests) 49ms
  ✓  node  test/sdk/analytics/utils.test.ts (2 tests) 4ms
- ✓  node  test/components/auth/ProfileChallenge.test.tsx (3 tests) 27ms
- ✓  node  test/sdk/account/clearPersistedSessionState.test.ts (1 test) 11ms
- ✓  node  test/components/quotes/MyAccountQuoteStatusBadge.test.tsx (2 tests) 24ms
-
- Test Files  77 passed (77)
-      Tests  626 passed (626)
-   Start at  14:30:25
-   Duration  37.93s (transform 8.83s, setup 0ms, collect 30.97s, tests 11.57s, environment 49.14s, prepare 1.21s)
+ ✓  node  test/instrumentation.test.ts (3 tests) 7ms
+ ✓  node  test/components/auth/ProfileChallenge.test.tsx (3 tests) 33ms
+ ✓  node  test/sdk/account/clearPersistedSessionState.test.ts (1 test) 12ms
+ ✓  node  test/components/quotes/MyAccountQuoteStatusBadge.test.tsx (2 tests) 25ms
+
+ Test Files  79 passed (79)
+      Tests  640 passed (640)
+   Start at  23:16:25
+   Duration  41.03s (transform 8.89s, setup 0ms, import 34.03s, tests 12.55s, environment 53.93s)
 

package/CHANGELOG.md

@@ -3,7 +3,9 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [4.5.1](https://github.com/vtex/faststore/compare/v4.5.1-dev.2...v4.5.1) (2026-08-11)
+# [4.6.0-dev.1](https://github.com/vtex/faststore/compare/v4.6.0-dev.0...v4.6.0-dev.1) (2026-08-11)
+
+## [4.5.1](https://github.com/vtex/faststore/compare/v4.5.1-dev.4...v4.5.1) (2026-08-11)
 
 ### Bug Fixes
 
@@ -21,6 +23,42 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 - **core:** type scroll restore paint timer for DOM/Node setTimeout ([940c903](https://github.com/vtex/faststore/commit/940c90376f8d2eb77665e73a6fb0ea53c9786c8e))
 - **core:** use replaceAll for infinite-scroll session key ([4f52048](https://github.com/vtex/faststore/commit/4f520482a9ba9661782fcf25a286b8f2e6c6b922))
 
+# [4.6.0-dev.0](https://github.com/vtex/faststore/compare/v4.5.1-dev.4...v4.6.0-dev.0) (2026-08-11)
+
+### Features
+
+- removing vtex/diagnostics-nodejs ([#3389](https://github.com/vtex/faststore/issues/3389)) ([74e2d50](https://github.com/vtex/faststore/commit/74e2d503a44903929b90af7701956536690d4e41))
+
+## [4.5.1-dev.4](https://github.com/vtex/faststore/compare/v4.5.1-dev.3...v4.5.1-dev.4) (2026-08-10)
+
+**Note:** Version bump only for package @faststore/core
+
+## [4.5.1-dev.3](https://github.com/vtex/faststore/compare/v4.5.1-dev.2...v4.5.1-dev.3) (2026-08-10)
+
+### Bug Fixes
+
+- **core:** add twitter card meta tag to default next seo config ([720f3e6](https://github.com/vtex/faststore/commit/720f3e6d04ef523f2fcf0e146c3741b7e5af70fa))
+- **core:** add twittermeta tags validaton for tests ([c8f5872](https://github.com/vtex/faststore/commit/c8f5872e42b69ddae5b2abfa0e8d3140e2bc7163))
+- **core:** lint error ([d07460f](https://github.com/vtex/faststore/commit/d07460f890ba712c9aecbec25bda5de96bf3e4ef))
+- **core:** remove duplicated twitter meta tag ([f388288](https://github.com/vtex/faststore/commit/f388288731ff75fceedba3cd7449ef1088b0b0c2))
+- **metaTags:** add twitter meta tags to nextSeo ([9c2439b](https://github.com/vtex/faststore/commit/9c2439b4a668dd81b7bfe5bdc44df575725067ec))
+
+## [4.5.1](https://github.com/vtex/faststore/compare/v4.5.1-dev.2...v4.5.1) (2026-08-11)
+
+- **core:** address scroll restoration review feedback ([a5fe6a3](https://github.com/vtex/faststore/commit/a5fe6a35c54e6095f81c7995a815ce6ef3b4dd4e))
+- **core:** align beforePopState callback with NextHistoryState ([10719e5](https://github.com/vtex/faststore/commit/10719e5eca199385d9fe18bdd6d7da290716a1d5))
+- **core:** compare window to undefined directly for Sonar ([bf05a54](https://github.com/vtex/faststore/commit/bf05a54bb014d120b7bdc95ff7c01a4e9b35b485))
+- **core:** harden scroll restore path matching and hydration-safe heights ([34efa6b](https://github.com/vtex/faststore/commit/34efa6bda7549895a4531277c2fe55bd6bbe98a7))
+- **core:** hash gallery height keys to avoid truncation collisions ([9e98043](https://github.com/vtex/faststore/commit/9e980438d74e457fa33aa77900438339463a078c))
+- **core:** prevent IS redirect hang and improve scroll restoration ([5f30778](https://github.com/vtex/faststore/commit/5f30778161eec2e4381b3fe971479dd7cbe53b08))
+- **core:** reset infinite scroll on forward listing navigations ([249226a](https://github.com/vtex/faststore/commit/249226a3acbe4cb26d687cf962125b2593d5949e))
+- **core:** resolve Sonar new-code smells for scroll restoration ([59b41ed](https://github.com/vtex/faststore/commit/59b41ed1d2a30ba693726b19895a0279eb1ba464))
+- **core:** restore PLP infinite-scroll pages on back navigation ([92b2efa](https://github.com/vtex/faststore/commit/92b2efa1d4d0895a10b5a0e71a4d9bf37cae1686))
+- **core:** resync gallery height lock when children change ([5058089](https://github.com/vtex/faststore/commit/50580898d97baf800b97c8a876f7967529859c61))
+- **core:** satisfy Sonar on gallery height key hash ([3a6ce47](https://github.com/vtex/faststore/commit/3a6ce47485c26be75d6d76906df3af64c9e34fd6))
+- **core:** type scroll restore paint timer for DOM/Node setTimeout ([940c903](https://github.com/vtex/faststore/commit/940c90376f8d2eb77665e73a6fb0ea53c9786c8e))
+- **core:** use replaceAll for infinite-scroll session key ([4f52048](https://github.com/vtex/faststore/commit/4f520482a9ba9661782fcf25a286b8f2e6c6b922))
+
 ## [4.5.1-dev.2](https://github.com/vtex/faststore/compare/v4.5.1-dev.1...v4.5.1-dev.2) (2026-08-04)
 
 **Note:** Version bump only for package @faststore/core

package/README.md

@@ -31,7 +31,7 @@ packages/core/
 │   ├── server/           # Server-side utilities (CMS content fetching)
 │   ├── customizations/   # Store-level overrides: styles, fonts, components, fragments
 │   ├── styles/           # Global SCSS styles
-│   └── instrumentation.ts  # Next.js instrumentation hook (boots @faststore/diagnostics when otelEnabled)
+│   └── instrumentation.ts  # Next.js instrumentation hook (boots @faststore/diagnostics — see docs/observability.md)
 ├── cms/faststore/        # CMS configuration: sections.json, content-types.json, schemas
 ├── @generated/           # Auto-generated GraphQL types — do not edit
 ├── discovery.config.default.js  # Committed base store configuration (platform, sales channel, locale)

package/cypress/integration/seo.test.js

@@ -47,7 +47,7 @@ describe('Home Page Seo', () => {
       })
   })
 
-  it('has OpenGraph tags', () => {
+  it('has OpenGraph and Twitter tags', () => {
     cy.visit(pages.home, options)
     cy.waitForHydration()
 
@@ -68,6 +68,12 @@ describe('Home Page Seo', () => {
       .should(($el) => {
         expect($el.attr('content')).to.be.a('string')
       })
+
+    cy.get('meta[name="twitter:card"]')
+      .should('exist')
+      .should(($el) => {
+        expect($el.attr('content')).to.eq('summary_large_image')
+      })
   })
 })
 
@@ -117,7 +123,7 @@ describe('Product Page Seo', () => {
       })
   })
 
-  it('has OpenGraph tags', () => {
+  it('has OpenGraph and Twitter tags', () => {
     cy.visit(pages.pdp, options)
     cy.waitForHydration()
 
@@ -156,6 +162,12 @@ describe('Product Page Seo', () => {
       .should(($el) => {
         expect($el.attr('content')).to.be.a('string')
       })
+
+    cy.get('meta[name="twitter:card"]')
+      .should('exist')
+      .should(($el) => {
+        expect($el.attr('content')).to.eq('summary_large_image')
+      })
   })
 })
 
@@ -201,7 +213,7 @@ describe('Collection Page Seo', () => {
       })
   })
 
-  it('has OpenGraph tags', () => {
+  it('has OpenGraph and Twitter tags', () => {
     cy.visit(pages.collection, options)
     cy.waitForHydration()
 
@@ -222,6 +234,12 @@ describe('Collection Page Seo', () => {
       .should(($el) => {
         expect($el.attr('content')).to.be.a('string')
       })
+
+    cy.get('meta[name="twitter:card"]')
+      .should('exist')
+      .should(($el) => {
+        expect($el.attr('content')).to.eq('summary_large_image')
+      })
   })
 })
 
@@ -256,7 +274,7 @@ describe('Filtered Collection Page Seo', () => {
       })
   })
 
-  it('has OpenGraph tags', () => {
+  it('has OpenGraph and Twitter tags', () => {
     cy.visit(pages.collection_filtered, options)
     cy.waitForHydration()
 
@@ -277,6 +295,12 @@ describe('Filtered Collection Page Seo', () => {
       .should(($el) => {
         expect($el.attr('content')).to.be.a('string')
       })
+
+    cy.get('meta[name="twitter:card"]')
+      .should('exist')
+      .should(($el) => {
+        expect($el.attr('content')).to.eq('summary_large_image')
+      })
   })
 })
 
@@ -295,7 +319,7 @@ describe('Search Page Seo', () => {
     cy.get('link[rel="canonical"]').should('not.exist')
   })
 
-  it('has OpenGraph tags', () => {
+  it('has OpenGraph and Twitter tags', () => {
     cy.visit(pages.search, options)
     cy.waitForHydration()
 
@@ -316,5 +340,11 @@ describe('Search Page Seo', () => {
       .should(($el) => {
         expect($el.attr('content')).to.be.a('string')
       })
+
+    cy.get('meta[name="twitter:card"]')
+      .should('exist')
+      .should(($el) => {
+        expect($el.attr('content')).to.eq('summary_large_image')
+      })
   })
 })

package/discovery.config.default.js

@@ -166,8 +166,7 @@ module.exports = {
   analytics: {
     // https://developers.google.com/tag-platform/tag-manager/web#standard_web_page_installation,
     gtmContainerId: 'GTM-PGHZ95N',
-    serviceName: 'faststore-proxy',
-    otelEnabled: true,
+    serviceName: 'faststore',
   },
 
   cms: {

package/next-seo.config.ts

@@ -8,6 +8,9 @@ const config: DefaultSeoProps = {
   norobots: storeConfig.experimental.noRobots,
   dangerouslySetAllPagesToNoFollow: storeConfig.experimental.nofollow,
   dangerouslySetAllPagesToNoIndex: storeConfig.experimental.noindex,
+  twitter: {
+    cardType: 'summary_large_image',
+  },
   additionalMetaTags: [
     {
       name: 'generated-at',

package/next.config.js

@@ -14,7 +14,6 @@ const getRootFolder = () => {
 console.log(`
   Root folder at: ${getRootFolder()}
   AccountID: ${storeConfig.api?.storeId ?? 'Unknown'}
-  Analytics Enabled: ${storeConfig.analytics?.otelEnabled ?? false}
 `)
 
 /**
@@ -22,8 +21,6 @@ console.log(`
  * */
 const nextConfig = {
   /* config options here */
-  /* Replaces terser by swc for minifying. It's the default in NextJS 13 */
-  swcMinify: true,
   ...(Array.isArray(storeConfig.experimental?.transpilePackages) &&
     storeConfig.experimental.transpilePackages.length > 0 && {
       transpilePackages: storeConfig.experimental.transpilePackages,
@@ -55,9 +52,7 @@ const nextConfig = {
   sassOptions: {
     silenceDeprecations: ['if-function', 'legacy-js-api'],
   },
-  // TODO: We won't need to enable this experimental feature when migrating to Next.js 13
   experimental: {
-    instrumentationHook: true,
     scrollRestoration: !storeConfig.experimental.scrollRestoration,
   },
   /*
@@ -68,6 +63,27 @@ const nextConfig = {
    * */
   outputFileTracingRoot: getRootFolder(),
   webpack: (config, { isServer, dev }) => {
+    // `@opentelemetry/sdk-node` (pulled in by @faststore/diagnostics) does an
+    // optional `require('@opentelemetry/shim-opencensus')` guarded by a try/catch.
+    // The module is an optional peer that isn't installed, so webpack reports a
+    // "Module not found" error it can't see is intentional. Aliasing it to `false`
+    // resolves it to an empty module, matching the graceful degradation the SDK
+    // already expects at runtime (Turbopack handles this case on its own).
+    config.resolve.alias = {
+      ...config.resolve.alias,
+      '@opentelemetry/shim-opencensus': false,
+    }
+
+    // `require-in-the-middle` (used by OpenTelemetry instrumentation) patches
+    // modules through a dynamic `require` that webpack can't statically analyze,
+    // emitting a benign "Critical dependency" warning. `serverExternalPackages`
+    // handles this for Turbopack, but the webpack builder still traces into it,
+    // so we silence the warning for this module specifically.
+    config.ignoreWarnings = [
+      ...(config.ignoreWarnings ?? []),
+      { module: /require-in-the-middle/ },
+    ]
+
     // https://github.com/vercel/next.js/discussions/11267#discussioncomment-2479112
     // camel-case style names from css modules
     config.module.rules

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faststore/core",
-  "version": "4.5.1",
+  "version": "4.6.0-dev.1",
   "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/lighthouse": "4.5.1",
-    "@faststore/ui": "4.5.1",
-    "@faststore/diagnostics": "4.5.1",
-    "@faststore/sdk": "4.5.1",
-    "@faststore/api": "4.5.1"
+    "@faststore/api": "4.6.0-dev.1",
+    "@faststore/ui": "4.6.0-dev.1",
+    "@faststore/lighthouse": "4.6.0-dev.1",
+    "@faststore/diagnostics": "4.6.0-dev.1",
+    "@faststore/sdk": "4.6.0-dev.1"
   },
   "devDependencies": {
     "@cypress/code-coverage": "^3.12.1",
@@ -88,7 +88,7 @@
     "@types/fs-extra": "^9.0.13",
     "@types/node": "20.19.13",
     "@vitejs/plugin-react": "^5.1.2",
-    "@vitest/coverage-v8": "4.0.7",
+    "@vitest/coverage-v8": "4.0.18",
     "@vtex/prettier-config": "1.0.0",
     "axe-core": "^4.8.1",
     "cypress": "12.17.4",
@@ -99,7 +99,7 @@
     "is-ci": "^3.0.0",
     "jsdom": "^27.4.0",
     "typescript": "5.9.3",
-    "vitest": "4.0.7"
+    "vitest": "4.0.18"
   },
   "peerDependencies": {
     "graphql": "16.11.0",

package/src/instrumentation.ts

@@ -1,17 +1,25 @@
 import config from '../discovery.config'
 import pkgJSON from '../package.json'
 
+/**
+ * Next.js instrumentation hook. This is the only place telemetry is booted, so
+ * the OTel SDK is registered before any request is served.
+ */
 export async function register() {
-  if (
-    process.env.NEXT_RUNTIME === 'nodejs' &&
-    config.analytics.otelEnabled === true
-  ) {
+  // Disabled feature until release date
+  const instrumentationEnabled = false
+
+  // The runtime check must wrap the import instead of guarding with an early
+  // return: bundlers replace `process.env.NEXT_RUNTIME` with a literal, so only
+  // a positive branch gets dropped from the edge bundle. Left reachable, the
+  // OTel SDK pulls in Node builtins (`fs`, `zlib`, `stream`) that fail to resolve.
+  if (process.env.NEXT_RUNTIME === 'nodejs' && instrumentationEnabled) {
     const { name, version } = pkgJSON
+
     try {
       const { getTelemetryClient } = await import('@faststore/diagnostics')
-      console.log('Instrumemtation.ts: Getting telemetry client')
 
-      return getTelemetryClient({
+      return await getTelemetryClient({
         serviceName: config.analytics?.serviceName ?? name,
         version,
         account: config.api.storeId,
@@ -19,7 +27,7 @@ export async function register() {
         packageName: name,
       })
     } catch (error) {
-      console.error('Failed to initialize OTEL Instrumentation')
+      console.error('Failed to initialize OTEL Instrumentation', error)
     }
   }
 }

package/src/pages/api/graphql.ts

@@ -13,6 +13,9 @@ import { getRequestHostname } from 'src/utils/getRequestHostname'
 import { isLocalHost } from 'src/utils/isLocalHost'
 import { shouldForceRefreshTokenForValidateSession } from 'src/utils/validateSessionRefreshToken'
 import { execute } from '../../server'
+import { logger } from '@faststore/diagnostics'
+
+const OTELLogger = logger('@faststore/core')
 
 const DEFAULT_MAX_AGE = 5 * 60 // 5 minutes
 const DEFAULT_STALE_WHILE_REVALIDATE = 60 * 60 // 1 hour
@@ -150,6 +153,12 @@ const hasVtexIdclientAutCookie = (request: NextApiRequest): boolean => {
 const handler: NextApiHandler = async (request, response) => {
   if (request.method !== 'POST' && request.method !== 'GET') {
     response.status(405).end()
+    OTELLogger(
+      'info',
+      'Invalid request method: %s %s',
+      request.method,
+      request.url
+    )
 
     return
   }
@@ -158,6 +167,15 @@ const handler: NextApiHandler = async (request, response) => {
     // value is used to cache bust the request if there is a VtexIdclientAutCookie
     const { operation, variables, query, v: value } = parseRequest(request)
 
+    // Variables and the query body are deliberately not logged: they carry
+    // session and customer data.
+    OTELLogger(
+      'debug',
+      'operation: %s hash: %s',
+      operation?.__meta__?.operationName,
+      operation?.__meta__?.operationHash
+    )
+
     const isLocal = isLocalHost(getRequestHostname(request.headers.host))
 
     if (
@@ -209,18 +227,21 @@ const handler: NextApiHandler = async (request, response) => {
       // upstream status) is nested in `originalError`. Recover it so the BFF
       // propagates the real status instead of collapsing everything to 500.
       const fastStoreError = errors.map(recoverFastStoreError).find(Boolean)
+      const reportedErrors = errors.map((graphqlError) => {
+        const fsError = recoverFastStoreError(graphqlError)
+
+        return {
+          message: (graphqlError as { message?: string })?.message,
+          status: fsError?.extensions.status,
+          type: fsError?.extensions.type,
+        }
+      })
 
-      console.error(
-        'Graphql execution returned with error: ',
-        errors.map((graphqlError) => {
-          const fsError = recoverFastStoreError(graphqlError)
-
-          return {
-            message: (graphqlError as { message?: string })?.message,
-            status: fsError?.extensions.status,
-            type: fsError?.extensions.type,
-          }
-        })
+      console.error('Graphql execution returned with error: ', reportedErrors)
+      OTELLogger(
+        'error',
+        'Graphql execution returned with error: %o',
+        reportedErrors
       )
 
       const status = fastStoreError?.extensions.status ?? 500
@@ -304,6 +325,11 @@ const handler: NextApiHandler = async (request, response) => {
       'Something unexpected occurred querying Graphql endpoint: \n',
       err
     )
+    OTELLogger(
+      'error',
+      'Something unexpected occurred querying Graphql endpoint: %o',
+      err
+    )
 
     if (err instanceof BadRequestError) {
       response.status(400).end()

package/src/server/index.ts

@@ -16,6 +16,7 @@ import {
   GraphqlVtexSchema,
   isFastStoreError,
 } from '@faststore/api'
+import { OTELAPI } from '@faststore/diagnostics'
 import { loadFilesSync } from '@graphql-tools/load-files'
 import { mergeTypeDefs } from '@graphql-tools/merge'
 import { makeExecutableSchema } from '@graphql-tools/schema'
@@ -28,7 +29,7 @@ import thirdPartyResolvers from '../customizations/src/graphql/thirdParty/resolv
 import vtexExtensionsResolvers from '../customizations/src/graphql/vtex/resolvers'
 
 import type { Operation } from '../sdk/graphql/request'
-import { apiOptions, withTraceClient } from './options'
+import { apiOptions } from './options'
 
 interface ExecuteOptions<V = Record<string, unknown>> {
   operation: Operation
@@ -70,8 +71,7 @@ export function getFinalAPISchema() {
 }
 
 export const getEnvelop = async () => {
-  const options = await withTraceClient(apiOptions)
-  const apiContextFactory = await GraphqlVtexContextFactory(options)
+  const apiContextFactory = await GraphqlVtexContextFactory(apiOptions)
 
   return envelop({
     plugins: [
@@ -136,13 +136,17 @@ export const execute = async <V extends Maybe<{ [key: string]: unknown }>, D>(
     contextValue.storage.locale = locale
   }
 
-  const { data, errors } = (await run({
-    schema,
-    document: parse(query),
-    variableValues: variables,
-    contextValue,
-    operationName,
-  })) as { data: D; errors: unknown[] }
+  const { data, errors } = await withRootSpan(
+    `graphql ${operationName ?? 'operation'}`,
+    () =>
+      run({
+        schema,
+        document: parse(query),
+        variableValues: variables,
+        contextValue,
+        operationName,
+      }) as Promise<{ data: D; errors: unknown[] }>
+  )
 
   return {
     data,
@@ -153,3 +157,27 @@ export const execute = async <V extends Maybe<{ [key: string]: unknown }>, D>(
     },
   }
 }
+
+/**
+ * Runs an operation inside a per-request root span, made the active context so
+ * the resolver spans emitted by `@faststore/api` parent to it. Resolves to a
+ * plain call when telemetry is disabled.
+ */
+async function withRootSpan<T>(name: string, run: () => Promise<T>) {
+  if (!apiOptions.OTEL_ENABLED) {
+    return run()
+  }
+
+  const span = OTELAPI.trace.getTracer('@faststore/core').startSpan(name)
+  const otelContext = OTELAPI.trace.setSpan(OTELAPI.context.active(), span)
+
+  try {
+    return await OTELAPI.context.with(otelContext, run)
+  } catch (error) {
+    span.setStatus({ code: OTELAPI.SpanStatusCode.ERROR })
+    span.recordException(error as Error)
+    throw error
+  } finally {
+    span.end()
+  }
+}

package/src/server/options.ts

@@ -1,9 +1,8 @@
 import type { APIOptions } from '@faststore/api'
-import { getTraceClient } from '@faststore/diagnostics'
 import storeConfig from '../../discovery.config'
 import pkgJSON from '../../package.json'
 
-const { name, version } = pkgJSON
+const { version } = pkgJSON
 
 export const apiOptions: APIOptions = {
   platform: storeConfig.platform as APIOptions['platform'],
@@ -23,25 +22,7 @@ export const apiOptions: APIOptions = {
       storeConfig.api?.enableUnavailableItemsOnCart ?? false,
   },
   version,
-  OTEL: {
-    enabled: storeConfig.analytics.otelEnabled,
-  },
+  // feature flag default to false as it should not emit traces/logs yet
+  OTEL_ENABLED: false,
   discoveryConfig: storeConfig,
 }
-
-export async function withTraceClient<T extends APIOptions = typeof apiOptions>(
-  apiOptions: T
-): Promise<T> {
-  const OTEL = {}
-  getTraceClient(
-    apiOptions?.discoveryConfig?.analytics?.serviceName ?? name
-  )?.inject(OTEL)
-
-  return {
-    ...apiOptions,
-    OTEL: {
-      ...OTEL,
-      enabled: storeConfig.analytics?.otelEnabled?.toString() === 'true',
-    },
-  } as T
-}

package/test/instrumentation.test.ts

@@ -0,0 +1,27 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+
+import { register } from '../src/instrumentation'
+
+const getTelemetryClient = vi.hoisted(() => vi.fn())
+
+vi.mock('@faststore/diagnostics', () => ({ getTelemetryClient }))
+
+beforeEach(() => {
+  vi.clearAllMocks()
+})
+
+afterEach(() => {
+  vi.unstubAllEnvs()
+})
+
+describe('register', () => {
+  it.each(['nodejs', 'edge', undefined])(
+    'does not boot telemetry on the %s runtime while the feature is off',
+    async (runtime) => {
+      vi.stubEnv('NEXT_RUNTIME', runtime)
+
+      await expect(register()).resolves.toBeUndefined()
+      expect(getTelemetryClient).not.toHaveBeenCalled()
+    }
+  )
+})

package/test/pages/api/graphql.test.ts

@@ -29,9 +29,13 @@ const createResponse = () => {
   return res as unknown as NextApiResponse & typeof res
 }
 
-const createRequest = (operationName = 'ClientShippingSimulationQuery') =>
+const createRequest = (
+  operationName = 'ClientShippingSimulationQuery',
+  method = 'GET'
+) =>
   ({
-    method: 'GET',
+    method,
+    url: '/api/graphql',
     headers: { host: 'localhost:3000' },
     query: {
       operationName,
@@ -165,3 +169,37 @@ describe('/api/graphql error status propagation', () => {
     expect(res.status).toHaveBeenCalledWith(404)
   })
 })
+
+describe('/api/graphql request handling', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+  })
+
+  it.each(['PUT', 'DELETE', 'PATCH', 'OPTIONS'])(
+    'rejects %s with 405 without reaching the GraphQL layer',
+    async (method) => {
+      const res = createResponse()
+      await handler(createRequest(undefined, method), res)
+
+      expect(res.status).toHaveBeenCalledWith(405)
+      expect(mockedExecute).not.toHaveBeenCalled()
+    }
+  )
+
+  it.each([
+    ['BadRequestError', () => new BadRequestError('malformed'), 400],
+    ['UnauthorizedError', () => new UnauthorizedError('expired'), 401],
+    ['an unexpected failure', () => new Error('socket hang up'), 500],
+  ])(
+    'maps %s thrown by execute to its status',
+    async (_name, makeError, status) => {
+      mockedExecute.mockRejectedValue(makeError())
+
+      const res = createResponse()
+      await handler(createRequest(), res)
+
+      expect(res.status).toHaveBeenCalledWith(status)
+      expect(res.end).toHaveBeenCalled()
+    }
+  )
+})

package/test/server/rootSpan.test.ts

@@ -0,0 +1,90 @@
+import { OTELAPI } from '@faststore/diagnostics'
+import {
+  afterAll,
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  it,
+  vi,
+} from 'vitest'
+
+import { execute } from '../../src/server'
+import { apiOptions } from '../../src/server/options'
+
+const span = {
+  end: vi.fn(),
+  setStatus: vi.fn(),
+  recordException: vi.fn(),
+}
+
+const startSpan = vi.fn(() => span)
+
+const otelEnabledByDefault = apiOptions.OTEL_ENABLED
+
+// `__typename` resolves inside GraphQL itself, so these run the whole envelop
+// pipeline without reaching the VTEX platform.
+const runOperation = (query: string, operationName?: string) =>
+  execute({
+    operation: { __meta__: { operationName, operationHash: 'not-persisted' } },
+    variables: {},
+    query,
+  })
+
+beforeEach(() => {
+  vi.clearAllMocks()
+  vi.spyOn(OTELAPI.trace, 'getTracer').mockReturnValue({ startSpan } as never)
+  apiOptions.OTEL_ENABLED = true
+})
+
+afterEach(() => {
+  vi.restoreAllMocks()
+})
+
+afterAll(() => {
+  apiOptions.OTEL_ENABLED = otelEnabledByDefault
+})
+
+describe('execute root span', () => {
+  it('wraps the operation in a span named after it', async () => {
+    const { data } = await runOperation(
+      'query RootSpanQuery { __typename }',
+      'RootSpanQuery'
+    )
+
+    expect(data).toEqual({ __typename: 'Query' })
+    expect(startSpan).toHaveBeenCalledWith('graphql RootSpanQuery')
+    expect(span.end).toHaveBeenCalledTimes(1)
+    expect(span.setStatus).not.toHaveBeenCalled()
+  })
+
+  it('names the span generically when the operation is anonymous', async () => {
+    await runOperation('{ __typename }')
+
+    expect(startSpan).toHaveBeenCalledWith('graphql operation')
+  })
+
+  it('marks the span as failed and ends it when the operation throws', async () => {
+    await expect(
+      runOperation('this is not graphql', 'BrokenQuery')
+    ).rejects.toThrow(/Syntax Error/)
+
+    expect(span.setStatus).toHaveBeenCalledWith({
+      code: OTELAPI.SpanStatusCode.ERROR,
+    })
+    expect(span.recordException).toHaveBeenCalledWith(expect.any(Error))
+    expect(span.end).toHaveBeenCalledTimes(1)
+  })
+
+  it('skips instrumentation entirely when telemetry is disabled', async () => {
+    apiOptions.OTEL_ENABLED = false
+
+    const { data } = await runOperation(
+      'query RootSpanQuery { __typename }',
+      'RootSpanQuery'
+    )
+
+    expect(data).toEqual({ __typename: 'Query' })
+    expect(startSpan).not.toHaveBeenCalled()
+  })
+})