@faststore/core 4.9.3-dev.2 → 4.10.0-dev.0

package/.turbo/turbo-generate.log

@@ -1,9 +1,9 @@
 
-> @faststore/core@4.9.3-dev.1 generate /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.9.3-dev.2 generate /home/runner/work/faststore/faststore/packages/core
 > pnpm run gen-types && pnpm run cache-graphql 
 
 
-> @faststore/core@4.9.3-dev.1 gen-types /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.9.3-dev.2 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 @generated/
 [COMPLETED] Generate outputs
 
-> @faststore/core@4.9.3-dev.1 cache-graphql /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.9.3-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

package/.turbo/turbo-test.log

@@ -1,5 +1,5 @@
 
-> @faststore/core@4.9.3-dev.1 test /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.9.3-dev.2 test /home/runner/work/faststore/faststore/packages/core
 > vitest run
 
 
@@ -7,27 +7,32 @@
 
 Not implemented: navigation to another Document
 Not implemented: navigation to another Document
+ ✓  browser  test/sdk/ui/useScrollRestoration.browser.test.ts (43 tests) 1434ms
 Browserslist: browsers data (caniuse-lite) is 8 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) 1011ms
- ✓  browser  test/components/account/ContractSwitcher.browser.test.tsx (22 tests) 2790ms
-     ✓ shows an error state when the list fails to load  760ms
-     ✓ requires selecting a contract before Confirm is enabled, then switches (REQ-03)  308ms
- ✓  browser  test/components/account/cards/MyAccountListCards.browser.test.tsx (16 tests) 3127ms
-     ✓ shows the tab bar and renders Personal cards by default  1504ms
-     ✓ paginates when there are more than 25 cards  504ms
- ✓  browser  test/components/account/orders/BuyingPolicyAlert.browser.test.tsx (13 tests) 2487ms
-     ✓ opens the reject confirmation modal with the default English copy  805ms
-     ✓ opens the reject confirmation modal with CMS-provided labels  387ms
- ✓  browser  test/components/CartRecommendationShelf/CartRecommendationShelf.browser.test.tsx (13 tests) 457ms
- ✓  browser  test/sdk/session/reconcileSessionLocale.browser.test.ts (6 tests) 22ms
- ✓  browser  test/components/account/OrganizationDrawer.browser.test.tsx (10 tests) 1931ms
-     ✓ renders the menu view with contract details and manage footer  1038ms
-     ✓ opens the contract switcher and returns to the menu on back  359ms
- ✓  browser  test/sdk/localization/useBindingSelector.browser.test.tsx (9 tests) 121ms
- ✓  browser  test/components/ui/ProductGallery/GalleryPageHeightLock.browser.test.tsx (8 tests) 83ms
- ✓  browser  test/sdk/recommendations/useRecommendationShelf.browser.test.tsx (12 tests) 92ms
+ ✓  browser  test/components/account/cards/MyAccountListCards.browser.test.tsx (16 tests) 2768ms
+     ✓ shows the tab bar and renders Personal cards by default  1334ms
+     ✓ paginates when there are more than 25 cards  315ms
+ ✓  browser  test/components/account/ContractSwitcher.browser.test.tsx (22 tests) 3857ms
+     ✓ shows an error state when the list fails to load  966ms
+     ✓ requires selecting a contract before Confirm is enabled, then switches (REQ-03)  381ms
+     ✓ keeps Confirm disabled when the selected contract is filtered out  377ms
+     ✓ honors CMS-provided labels for the header, current session, search, footer, and available count  331ms
+ ✓  browser  test/components/account/orders/BuyingPolicyAlert.browser.test.tsx (13 tests) 2749ms
+     ✓ opens the reject confirmation modal with the default English copy  884ms
+     ✓ opens the reject confirmation modal with CMS-provided labels  430ms
+     ✓ shows the default English toast when a policy is rejected  330ms
+ ✓  browser  test/components/CartRecommendationShelf/CartRecommendationShelf.browser.test.tsx (13 tests) 352ms
+ ✓  browser  test/components/ui/RichText/RichText.browser.test.tsx (8 tests) 383ms
+ ✓  browser  test/components/account/OrganizationDrawer.browser.test.tsx (10 tests) 2194ms
+     ✓ renders the menu view with contract details and manage footer  1242ms
+     ✓ opens the contract switcher and returns to the menu on back  388ms
+     ✓ resets to the menu when the drawer closes  314ms
+ ✓  browser  test/sdk/session/reconcileSessionLocale.browser.test.ts (6 tests) 21ms
+ ✓  browser  test/sdk/localization/useBindingSelector.browser.test.tsx (9 tests) 72ms
+ ✓  browser  test/components/ui/ProductGallery/GalleryPageHeightLock.browser.test.tsx (8 tests) 66ms
+ ✓  browser  test/sdk/recommendations/useRecommendationShelf.browser.test.tsx (12 tests) 162ms
 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
@@ -57,10 +62,10 @@ Browserslist: browsers data (caniuse-lite) is 8 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/components/RecommendationShelf/RecommendationShelf.browser.test.tsx (8 tests) 119ms
- ✓  browser  test/sdk/session/getInitialSession.browser.test.ts (7 tests) 9ms
- ✓  browser  test/components/CartSidebar/CartSidebar.browser.test.tsx (5 tests) 83ms
- ✓  browser  test/components/sections/Account/AccountOrderDetails.browser.test.tsx (4 tests) 69ms
+ ✓  browser  test/components/RecommendationShelf/RecommendationShelf.browser.test.tsx (8 tests) 86ms
+ ✓  browser  test/components/CartSidebar/CartSidebar.browser.test.tsx (5 tests) 76ms
+ ✓  browser  test/sdk/session/getInitialSession.browser.test.ts (7 tests) 19ms
+ ✓  browser  test/components/sections/Account/AccountOrderDetails.browser.test.tsx (4 tests) 145ms
 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(...).
 
@@ -146,8 +151,6 @@ 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/components/navigation/Navbar.browser.test.tsx (3 tests) 100ms
- ✓  browser  test/components/account/OrganizationDrawerFooter.browser.test.tsx (8 tests) 508ms
 stderr | test/pages/password-protection.browser.test.tsx > PasswordProtectionLogin > uses the fallback invalid-password message when API omits an error
 Warning: An update to PasswordProtectionLogin inside a test was not wrapped in act(...).
 
@@ -292,8 +295,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) 983ms
-     ✓ renders the password protection form  410ms
+ ✓  browser  test/pages/password-protection.browser.test.tsx (6 tests) 932ms
+     ✓ renders the password protection form  488ms
+ ✓  browser  test/components/navigation/Navbar.browser.test.tsx (3 tests) 70ms
+ ✓  browser  test/components/account/OrganizationDrawerFooter.browser.test.tsx (8 tests) 488ms
+ ✓  browser  test/sdk/account/useSwitchContract.browser.test.ts (5 tests) 45ms
 stderr | test/components/cms/RenderSections.browser.test.tsx
 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)
@@ -302,9 +308,9 @@ 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:357:23)
     at processTicksAndRejections (node:internal/process/task_queues:103:5)
 
- ✓  browser  test/sdk/account/useSwitchContract.browser.test.ts (5 tests) 56ms
- ✓  browser  test/components/navigation/NavbarSlider.browser.test.tsx (2 tests) 42ms
- ✓  browser  test/components/cms/RenderSections.browser.test.tsx (5 tests) 92ms
+ ✓  browser  test/components/navigation/NavbarSlider.browser.test.tsx (2 tests) 31ms
+ ✓  browser  test/components/cms/RenderSections.browser.test.tsx (5 tests) 81ms
+ ✓  browser  test/components/account/Menu.browser.test.tsx (6 tests) 338ms
 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)
@@ -313,15 +319,14 @@ 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:357:23)
     at processTicksAndRejections (node:internal/process/task_queues:103:5)
 
- ✓  browser  test/sdk/localization/store-url.browser.test.ts (3 tests) 6ms
- ✓  browser  test/components/account/Menu.browser.test.tsx (6 tests) 385ms
- ✓  browser  test/sdk/account/useAvailableContracts.browser.test.ts (6 tests) 42ms
- ✓  browser  test/components/templates/SearchPage/SearchWrapper.browser.test.tsx (3 tests) 35ms
- ✓  browser  test/sdk/recommendations/useRecommendationShelf.sessionFallback.browser.test.tsx (2 tests) 128ms
- ✓  browser  test/components/sections/Account/AccountListQuotes.browser.test.tsx (4 tests) 135ms
- ✓  browser  test/components/navigation/NavbarAccountArea.browser.test.tsx (4 tests) 78ms
- ✓  browser  test/sdk/account/changeContractToken.browser.test.ts (9 tests) 22ms
- ✓  browser  test/components/CartRecommendationShelf/CartRecommendationProductCard.browser.test.tsx (3 tests) 54ms
+ ✓  browser  test/sdk/localization/store-url.browser.test.ts (3 tests) 4ms
+ ✓  browser  test/sdk/account/useAvailableContracts.browser.test.ts (6 tests) 37ms
+ ✓  browser  test/components/templates/SearchPage/SearchWrapper.browser.test.tsx (3 tests) 36ms
+ ✓  browser  test/sdk/recommendations/useRecommendationShelf.sessionFallback.browser.test.tsx (2 tests) 83ms
+ ✓  browser  test/components/sections/Account/AccountListQuotes.browser.test.tsx (4 tests) 126ms
+ ✓  browser  test/components/navigation/NavbarAccountArea.browser.test.tsx (4 tests) 72ms
+ ✓  browser  test/components/CartRecommendationShelf/CartRecommendationProductCard.browser.test.tsx (3 tests) 73ms
+ ✓  browser  test/sdk/account/changeContractToken.browser.test.ts (9 tests) 19ms
 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)
@@ -330,9 +335,9 @@ 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:357:23)
     at processTicksAndRejections (node:internal/process/task_queues:103:5)
 
- ✓  browser  test/components/account/doLogout.browser.test.ts (1 test) 39ms
- ✓  browser  test/components/ui/LocalizationButton.browser.test.tsx (3 tests) 48ms
- ✓  browser  test/components/account/OrganizationDrawerHeader.browser.test.tsx (5 tests) 359ms
+ ✓  browser  test/components/account/doLogout.browser.test.ts (1 test) 25ms
+ ✓  browser  test/components/ui/LocalizationButton.browser.test.tsx (3 tests) 56ms
+ ✓  browser  test/components/account/OrganizationDrawerHeader.browser.test.tsx (5 tests) 378ms
 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)
@@ -341,14 +346,15 @@ 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:357:23)
     at processTicksAndRejections (node:internal/process/task_queues:103:5)
 
- ✓  browser  test/sdk/account/clearPersistedSessionState.browser.test.ts (4 tests) 19ms
- ✓  browser  test/components/sections/Account/AccountOrderDelivery.browser.test.tsx (2 tests) 102ms
- ✓  browser  test/components/account/orders/DeliveryOptionAccordion.browser.test.tsx (2 tests) 104ms
- ✓  browser  test/components/sections/Account/AccountOrderStatus.browser.test.tsx (3 tests) 144ms
- ✓  browser  test/components/region/useRegion.browser.test.ts (1 test) 17ms
- ✓  browser  test/components/sections/Account/AccountListCards.browser.test.tsx (3 tests) 92ms
- ✓  browser  test/components/sections/Account/AccountOrdersList.browser.test.tsx (2 tests) 30ms
- ✓  browser  test/components/account/orders/SummaryCard.browser.test.tsx (2 tests) 105ms
+ ✓  browser  test/sdk/account/clearPersistedSessionState.browser.test.ts (4 tests) 13ms
+ ✓  browser  test/components/account/orders/DeliveryOptionAccordion.browser.test.tsx (2 tests) 90ms
+ ✓  browser  test/components/sections/Account/AccountOrderDelivery.browser.test.tsx (2 tests) 87ms
+ ✓  browser  test/components/sections/Account/AccountOrderStatus.browser.test.tsx (3 tests) 96ms
+ ✓  browser  test/components/region/useRegion.browser.test.ts (1 test) 23ms
+ ✓  browser  test/components/sections/Account/AccountListCards.browser.test.tsx (3 tests) 72ms
+ ✓  browser  test/components/sections/Account/AccountOrdersList.browser.test.tsx (2 tests) 29ms
+ ✓  browser  test/components/account/orders/SummaryCard.browser.test.tsx (2 tests) 89ms
+ ✓  browser  test/components/account/OrganizationSignInButton.browser.test.tsx (2 tests) 242ms
 stderr | test/sdk/session/sessionStore.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)
@@ -357,9 +363,7 @@ 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:357:23)
     at processTicksAndRejections (node:internal/process/task_queues:103:5)
 
- ✓  browser  test/sdk/session/sessionStore.browser.test.ts (2 tests) 8ms
- ✓  browser  test/components/account/OrganizationSignInButton.browser.test.tsx (2 tests) 270ms
- ✓  browser  test/components/account/orders/DeliveryOptionAccordionDeliveryInfo.browser.test.tsx (1 test) 31ms
+ ✓  browser  test/sdk/session/sessionStore.browser.test.ts (2 tests) 7ms
 stderr | test/sdk/session/validateSession.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)
@@ -368,14 +372,15 @@ 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:357:23)
     at processTicksAndRejections (node:internal/process/task_queues:103:5)
 
- ✓  browser  test/sdk/session/validateSession.browser.test.ts (1 test) 7ms
- ✓  browser  test/components/account/orders/StatusCard.browser.test.tsx (2 tests) 107ms
- ✓  browser  test/utils/isLocalHost.browser.test.ts (3 tests) 4ms
- ✓  browser  test/sdk/session/reconcileSessionLocale.disabled.browser.test.ts (1 test) 3ms
- ✓  browser  test/components/account/orders/DeliveryCard.browser.test.tsx (1 test) 63ms
- ✓  browser  test/components/account/orders/DeliveryOptionAccordionProducts.browser.test.tsx (1 test) 51ms
- ✓  browser  test/components/skeletons/ProductGridSkeleton.browser.test.tsx (2 tests) 45ms
- ✓  node  test/utils/localization/bindingPaths.test.ts (71 tests) 31ms
+ ✓  browser  test/components/account/orders/DeliveryOptionAccordionDeliveryInfo.browser.test.tsx (1 test) 62ms
+ ✓  browser  test/sdk/session/validateSession.browser.test.ts (1 test) 6ms
+ ✓  browser  test/components/account/orders/StatusCard.browser.test.tsx (2 tests) 106ms
+ ✓  browser  test/utils/isLocalHost.browser.test.ts (3 tests) 5ms
+ ✓  browser  test/sdk/session/reconcileSessionLocale.disabled.browser.test.ts (1 test) 4ms
+ ✓  browser  test/components/account/orders/DeliveryCard.browser.test.tsx (1 test) 42ms
+ ✓  browser  test/components/account/orders/DeliveryOptionAccordionProducts.browser.test.tsx (1 test) 50ms
+ ✓  browser  test/components/skeletons/ProductGridSkeleton.browser.test.tsx (2 tests) 43ms
+ ✓  node  test/utils/localization/bindingPaths.test.ts (71 tests) 32ms
 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)
@@ -384,14 +389,14 @@ 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:357:23)
     at processTicksAndRejections (node:internal/process/task_queues:103:5)
 
- ✓  browser  test/sdk/account/refreshToken.browser.test.ts (1 test) 6ms
- ✓  node  test/server/password-protection-service.test.ts (22 tests) 37ms
- ✓  node  test/pages/api/switch-contract.test.ts (25 tests) 92ms
- ✓  browser  test/components/account/orders/FilterFacetPendingApproval.browser.test.tsx (1 test) 230ms
- ✓  node  test/utils/match-url.test.ts (10 tests) 9ms
+ ✓  browser  test/sdk/account/refreshToken.browser.test.ts (1 test) 5ms
+ ✓  node  test/server/password-protection-service.test.ts (22 tests) 36ms
+ ✓  node  test/pages/api/switch-contract.test.ts (25 tests) 80ms
+ ✓  node  test/utils/match-url.test.ts (10 tests) 12ms
+ ✓  browser  test/components/account/orders/FilterFacetPendingApproval.browser.test.tsx (1 test) 224ms
  ✓  node  test/sdk/localization/useBindingSelector.test.tsx (22 tests) 15ms
- ✓  node  test/pages/api/unlock.test.ts (15 tests) 141ms
- ✓  node  test/sdk/session/syncSalesChannelFromOrderForm.test.ts (14 tests) 12ms
+ ✓  node  test/pages/api/unlock.test.ts (15 tests) 125ms
+ ✓  node  test/sdk/session/syncSalesChannelFromOrderForm.test.ts (14 tests) 16ms
 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?
 
@@ -455,24 +460,23 @@ 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/sdk/localization/bindingSelector.test.ts (18 tests) 12ms
- ✓  node  test/components/search/SearchInputComponent.test.tsx (6 tests) 94ms
- ✓  node  test/components/quotes/MyAccountListQuotesTable.test.tsx (15 tests) 474ms
- ✓  node  test/sdk/search/useSearchHistory.test.ts (13 tests) 48ms
+ ✓  node  test/components/search/SearchInputComponent.test.tsx (6 tests) 86ms
+ ✓  node  test/sdk/localization/bindingSelector.test.ts (18 tests) 11ms
+ ✓  node  test/components/quotes/MyAccountListQuotesTable.test.tsx (15 tests) 440ms
+ ✓  node  test/sdk/search/useSearchHistory.test.ts (13 tests) 43ms
+ ✓  node  test/components/quotes/MyAccountListQuotes.test.tsx (11 tests) 834ms
+     ✓ navigates with the search term on blur  361ms
+     ✓ navigates without a label param when the search is cleared  365ms
 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/components/quotes/MyAccountListQuotes.test.tsx (11 tests) 832ms
-     ✓ navigates with the search term on blur  358ms
-     ✓ navigates without a label param when the search is cleared  360ms
- ✓  node  test/components/quotes/quoteFilters.test.ts (26 tests) 29ms
+ ✓  node  test/pages/pvt/account/cards/index.test.ts (8 tests) 12ms
+ ✓  node  test/components/quotes/quoteFilters.test.ts (26 tests) 38ms
+ ✓  node  test/utils/cookieCacheBusting.test.ts (10 tests) 15ms
  ✓  node  test/utils/productJsonLd.test.ts (36 tests) 14ms
- ✓  node  test/utils/cookieCacheBusting.test.ts (10 tests) 17ms
- ✓  node  test/experimental/myAccountCmsServerSideProps.test.ts (5 tests) 22ms
 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:  [
   {
@@ -582,73 +586,75 @@ Warning: React does not recognize the `providerProps` prop on a DOM element. If
     at trace (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/test.B8ej_ZHS.js:239:21)
     at runTest (file:///home/runner/work/faststore/faststore/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:1653:12)
 
- ✓  node  test/pages/api/graphql.test.ts (19 tests) 31ms
- ✓  node  test/utils/clearCookies.test.ts (20 tests) 28ms
- ✓  node  test/utils/multipleTemplates.test.ts (8 tests) 5ms
+ ✓  node  test/pages/api/graphql.test.ts (19 tests) 33ms
+ ✓  node  test/experimental/myAccountCmsServerSideProps.test.ts (5 tests) 9ms
+ ✓  node  test/utils/clearCookies.test.ts (20 tests) 20ms
+ ✓  node  test/utils/multipleTemplates.test.ts (8 tests) 7ms
 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) 31ms
- ✓  node  test/sdk/orderEntry/useOrderEntryOperation.test.ts (8 tests) 43ms
+ ✓  node  test/sdk/account/useSetPassword.test.ts (6 tests) 32ms
+ ✓  node  test/sdk/orderEntry/useOrderEntryOperation.test.ts (8 tests) 51ms
  ✓  node  test/utils/localization/localizeRedirectDestination.test.ts (11 tests) 7ms
- ✓  node  test/components/quotes/MyAccountQuotesFilterSlider.test.tsx (8 tests) 226ms
- ✓  node  test/components/quotes/MyAccountQuotesStatusSelector.test.tsx (14 tests) 190ms
+ ✓  node  test/components/quotes/MyAccountQuotesFilterSlider.test.tsx (8 tests) 160ms
  ✓  node  test/utils/localization/hreflang.test.ts (8 tests) 7ms
- ✓  node  test/sdk/account/getMyAccountRoutes.test.ts (13 tests) 8ms
- ✓  node  test/components/quotes/MyAccountQuotesSelectedTags.test.tsx (10 tests) 124ms
- ✓  node  test/sdk/redirects/index.test.ts (7 tests) 51ms
- ✓  node  test/sdk/orderEntry/useOrderEntryUpload.test.ts (8 tests) 58ms
- ✓  node  test/proxy.localization.test.ts (5 tests) 35ms
- ✓  node  test/sdk/orderEntry/useOrderEntry.test.ts (8 tests) 49ms
+ ✓  node  test/components/quotes/MyAccountQuotesStatusSelector.test.tsx (14 tests) 209ms
+ ✓  node  test/sdk/account/getMyAccountRoutes.test.ts (13 tests) 9ms
+ ✓  node  test/components/quotes/MyAccountQuotesSelectedTags.test.tsx (10 tests) 106ms
+ ✓  node  test/sdk/redirects/index.test.ts (7 tests) 38ms
+ ✓  node  test/sdk/orderEntry/useOrderEntryUpload.test.ts (8 tests) 53ms
+ ✓  node  test/proxy.localization.test.ts (5 tests) 45ms
+ ✓  node  test/sdk/orderEntry/useOrderEntry.test.ts (8 tests) 50ms
+ ✓  node  test/sdk/graphql/retryPolicy.test.ts (18 tests) 21ms
  ✓  node  test/components/account/orders/getDeliveryOptionLabel.test.ts (21 tests) 7ms
- ✓  node  test/sdk/graphql/retryPolicy.test.ts (18 tests) 23ms
  ✓  node  test/server/cms/myAccountDefaultSections.test.ts (9 tests) 8ms
- ✓  node  test/utils/productJsonLdRendering.test.tsx (5 tests) 12ms
- ✓  node  test/utils/trustedForwardedHost.test.ts (27 tests) 8ms
- ✓  node  test/server/index.test.ts (7 tests) 746ms
- ✓  node  test/proxy.test.ts (4 tests) 23ms
- ✓  node  test/server/webops-api.test.ts (9 tests) 14ms
- ✓  node  test/sdk/localization/store-url.test.ts (4 tests) 5ms
- ✓  node  test/sdk/analytics/useStartRecommendationSession.test.ts (6 tests) 77ms
- ✓  node  test/components/account/orders/StatusCard.test.ts (3 tests) 32ms
- ✓  node  test/sdk/orderEntry/useOrderFormItems.test.ts (7 tests) 41ms
- ✓  node  test/sdk/cart/waitForSessionValidated.test.ts (5 tests) 13ms
- ✓  node  test/sdk/account/refreshToken.test.ts (5 tests) 12ms
+ ✓  node  test/utils/productJsonLdRendering.test.tsx (5 tests) 14ms
+ ✓  node  test/utils/trustedForwardedHost.test.ts (27 tests) 6ms
+ ✓  node  test/sdk/analytics/useStartRecommendationSession.test.ts (6 tests) 37ms
+ ✓  node  test/server/index.test.ts (7 tests) 1350ms
+       ✓ should handle options and execute  765ms
+ ✓  node  test/sdk/orderEntry/useOrderFormItems.test.ts (7 tests) 50ms
+ ✓  node  test/server/webops-api.test.ts (9 tests) 35ms
+ ✓  node  test/proxy.test.ts (4 tests) 19ms
+ ✓  node  test/components/account/orders/StatusCard.test.ts (3 tests) 30ms
+ ✓  node  test/sdk/localization/store-url.test.ts (4 tests) 7ms
+ ✓  node  test/sdk/cart/waitForSessionValidated.test.ts (5 tests) 16ms
  ✓  node  test/server/content/service.test.ts (5 tests) 4ms
+ ✓  node  test/sdk/account/refreshToken.test.ts (5 tests) 7ms
  ✓  node  test/server/cms/global.test.ts (3 tests) 6ms
- ✓  node  test/sdk/auth/useAuth.test.ts (5 tests) 44ms
- ✓  node  test/utils/getRequestHostname.test.ts (12 tests) 5ms
- ✓  node  test/components/account/Layout.test.tsx (6 tests) 77ms
- ✓  node  test/server/rootSpan.test.ts (4 tests) 48ms
+ ✓  node  test/sdk/auth/useAuth.test.ts (5 tests) 29ms
+ ✓  node  test/utils/getRequestHostname.test.ts (12 tests) 7ms
+ ✓  node  test/components/account/Layout.test.tsx (6 tests) 87ms
+ ✓  node  test/server/rootSpan.test.ts (4 tests) 45ms
  ✓  node  test/pages/api/preview.test.ts (2 tests) 9ms
- ✓  node  test/components/search/SearchInput.test.ts (6 tests) 13ms
- ✓  node  test/utils/validateSessionRefreshToken.test.ts (6 tests) 6ms
- ✓  node  test/sdk/recommendations/vrn.test.ts (5 tests) 6ms
- ✓  node  test/components/region/useRegion.test.ts (1 test) 24ms
- ✓  node  test/server/cms/index.test.ts (2 tests) 4ms
- ✓  node  test/utils/retry.test.ts (5 tests) 17ms
- ✓  node  test/sdk/account/getB2BSessionClaims.test.ts (4 tests) 7ms
- ✓  node  test/sdk/recommendations/useRecommendationUserId.test.ts (4 tests) 194ms
- ✓  node  test/utils/userOrderStatus.test.ts (4 tests) 5ms
- ✓  node  test/utils/unlockResponse.test.ts (11 tests) 5ms
- ✓  node  test/sdk/recommendations/useRecommendations.test.ts (2 tests) 6ms
- ✓  node  test/components/account/OrganizationDrawerBody.test.tsx (3 tests) 43ms
+ ✓  node  test/components/search/SearchInput.test.ts (6 tests) 7ms
+ ✓  node  test/utils/validateSessionRefreshToken.test.ts (6 tests) 4ms
+ ✓  node  test/sdk/recommendations/vrn.test.ts (5 tests) 4ms
+ ✓  node  test/server/cms/index.test.ts (2 tests) 6ms
+ ✓  node  test/components/region/useRegion.test.ts (1 test) 22ms
+ ✓  node  test/utils/retry.test.ts (5 tests) 18ms
+ ✓  node  test/sdk/account/getB2BSessionClaims.test.ts (4 tests) 6ms
+ ✓  node  test/utils/userOrderStatus.test.ts (4 tests) 4ms
+ ✓  node  test/sdk/recommendations/useRecommendationUserId.test.ts (4 tests) 198ms
+ ✓  node  test/utils/unlockResponse.test.ts (11 tests) 8ms
+ ✓  node  test/sdk/recommendations/useRecommendations.test.ts (2 tests) 5ms
+ ✓  node  test/components/account/OrganizationDrawerBody.test.tsx (3 tests) 41ms
  ✓  node  test/utils/isLocalHost.test.ts (7 tests) 5ms
  ✓  node  test/sdk/session/toSessionInput.test.ts (3 tests) 5ms
- ✓  node  test/components/quotes/MyAccountQuoteStatusBadge.test.tsx (4 tests) 49ms
- ✓  node  test/components/account/orders/getOrderTotalLabel.test.ts (6 tests) 4ms
- ✓  node  test/components/account/orders/listOrdersLabels.test.ts (2 tests) 3ms
- ✓  node  test/utils/getCookie.test.ts (4 tests) 5ms
+ ✓  node  test/components/quotes/MyAccountQuoteStatusBadge.test.tsx (4 tests) 36ms
+ ✓  node  test/components/account/orders/listOrdersLabels.test.ts (2 tests) 4ms
+ ✓  node  test/components/account/orders/getOrderTotalLabel.test.ts (6 tests) 3ms
  ✓  node  test/sdk/session/isSignInAreaResolved.test.ts (3 tests) 4ms
- ✓  node  test/utils/filterChannel.test.ts (2 tests) 4ms
- ✓  node  test/components/auth/ProfileChallenge.test.tsx (3 tests) 43ms
- ✓  node  test/instrumentation.test.ts (3 tests) 5ms
- ✓  node  test/sdk/analytics/utils.test.ts (2 tests) 3ms
+ ✓  node  test/utils/getCookie.test.ts (4 tests) 5ms
+ ✓  node  test/utils/filterChannel.test.ts (2 tests) 5ms
+ ✓  node  test/components/auth/ProfileChallenge.test.tsx (3 tests) 33ms
+ ✓  node  test/sdk/analytics/utils.test.ts (2 tests) 4ms
+ ✓  node  test/instrumentation.test.ts (3 tests) 6ms
  ✓  node  test/components/account/orders/orderDetailsLabels.test.ts (1 test) 4ms
- ✓  node  test/sdk/account/clearPersistedSessionState.test.ts (1 test) 8ms
+ ✓  node  test/sdk/account/clearPersistedSessionState.test.ts (1 test) 10ms
 
- Test Files  130 passed (130)
-      Tests  1032 passed (1032)
-   Start at  00:35:08
-   Duration  62.92s (transform 13.32s, setup 0ms, import 56.50s, tests 21.42s, environment 78.13s)
+ Test Files  131 passed (131)
+      Tests  1040 passed (1040)
+   Start at  16:50:57
+   Duration  64.14s (transform 16.34s, setup 0ms, import 57.63s, tests 23.46s, environment 79.54s)
 

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [4.10.0-dev.0](https://github.com/vtex/faststore/compare/v4.9.3-dev.2...v4.10.0-dev.0) (2026-10-08)
+
+### Features
+
+- render images in RichText via a custom Lexical image node ([#3448](https://github.com/vtex/faststore/issues/3448)) ([a7c85b8](https://github.com/vtex/faststore/commit/a7c85b8478a64994b123f81ee08add594daa7b2f))
+
 ## [4.9.3-dev.2](https://github.com/vtex/faststore/compare/v4.9.3-dev.1...v4.9.3-dev.2) (2026-10-07)
 
 ### Bug Fixes

package/cms/faststore/components/cms_component__bannernewsletter.jsonc

@@ -92,7 +92,7 @@
           "title": "Privacy Policy Disclaimer",
           "type": "string",
           "widget": {
-            "ui:widget": "draftjs-rich-text"
+            "ui:widget": "draftjs-rich-text-v2"
           }
         },
         "emailInputLabel": {

package/cms/faststore/components/cms_component__newsletter.jsonc

@@ -39,7 +39,7 @@
       "title": "Privacy Policy Disclaimer",
       "type": "string",
       "widget": {
-        "ui:widget": "draftjs-rich-text"
+        "ui:widget": "draftjs-rich-text-v2"
       }
     },
     "emailInputLabel": {

package/index.ts

@@ -12,6 +12,9 @@ export * from './src/typings/overrides'
 export { getOverriddenSection } from './src/sdk/overrides/getOverriddenSection'
 export { getMyAccountRoutes } from './src/sdk/account/getMyAccountRoutes'
 
+export { RichText } from './src/components/ui/RichText'
+export type { RichTextProps } from './src/components/ui/RichText'
+
 // Overridable Sections
 export { default as AlertSection } from './src/components/sections/Alert'
 export { default as BannerTextSection } from './src/components/sections/BannerText'

package/package.json

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

package/src/components/ui/RichText/RichText.tsx

@@ -26,6 +26,7 @@ import {
 } from 'lexical'
 import { RichText as UIRichText } from '@faststore/ui'
 import { isContentPlatformSource } from 'src/server/content/utils'
+import { RichTextImageNode } from './RichTextImageNode'
 
 export interface RichTextProps {
   /**
@@ -124,6 +125,7 @@ function lexicalToHtml(content: string) {
       ListItemNode,
       CodeNode,
       HorizontalRuleNode,
+      RichTextImageNode,
     ],
     onError: (error) => {
       throw error

package/src/components/ui/RichText/RichTextImageNode.ts

@@ -0,0 +1,163 @@
+import {
+  DecoratorNode,
+  type DOMExportOutput,
+  type EditorConfig,
+  type LexicalEditor,
+  type NodeKey,
+  type SerializedLexicalNode,
+  type Spread,
+} from 'lexical'
+
+export type ImageAlignment = 'left' | 'center' | 'right'
+
+export type SerializedRichTextImageNode = Spread<
+  {
+    type: 'image'
+    version: 1
+    src: string
+    altText: string
+    alignment: ImageAlignment
+    widthPercent: number
+  },
+  SerializedLexicalNode
+>
+
+const VALID_ALIGNMENTS = new Set<ImageAlignment>(['left', 'center', 'right'])
+const DEFAULT_ALIGNMENT: ImageAlignment = 'left'
+const DEFAULT_WIDTH_PERCENT = 100
+const RICH_TEXT_CONTENT_MAX_WIDTH = 720
+const DEFAULT_IMAGE_QUALITY = 8
+
+function resolveAlignment(alignment: unknown): ImageAlignment {
+  return VALID_ALIGNMENTS.has(alignment as ImageAlignment)
+    ? (alignment as ImageAlignment)
+    : DEFAULT_ALIGNMENT
+}
+
+function resolveWidthPercent(widthPercent: unknown): number {
+  if (typeof widthPercent !== 'number' || widthPercent <= 0) {
+    return DEFAULT_WIDTH_PERCENT
+  }
+
+  return Math.min(widthPercent, DEFAULT_WIDTH_PERCENT)
+}
+
+function withVtexResizeParams(src: string, widthPercent: number): string {
+  if (!src.includes('vtexassets') || !src.includes('/assets')) {
+    return src
+  }
+
+  try {
+    const url = new URL(src)
+    const targetWidth = Math.max(
+      1,
+      Math.round((RICH_TEXT_CONTENT_MAX_WIDTH * widthPercent) / 100)
+    )
+
+    url.searchParams.set('width', targetWidth.toString())
+    url.searchParams.set('aspect', 'true')
+    url.searchParams.set('quality', DEFAULT_IMAGE_QUALITY.toString())
+
+    return url.toString()
+  } catch {
+    return src
+  }
+}
+
+export class RichTextImageNode extends DecoratorNode<null> {
+  __src: string
+  __altText: string
+  __alignment: ImageAlignment
+  __widthPercent: number
+
+  constructor(
+    src: string,
+    altText: string,
+    alignment: ImageAlignment = DEFAULT_ALIGNMENT,
+    widthPercent: number = DEFAULT_WIDTH_PERCENT,
+    key?: NodeKey
+  ) {
+    super(key)
+    this.__src = src
+    this.__altText = altText
+    this.__alignment = resolveAlignment(alignment)
+    this.__widthPercent = resolveWidthPercent(widthPercent)
+  }
+
+  static getType(): string {
+    return 'image'
+  }
+
+  static clone(node: RichTextImageNode): RichTextImageNode {
+    return new RichTextImageNode(
+      node.__src,
+      node.__altText,
+      node.__alignment,
+      node.__widthPercent,
+      node.__key
+    )
+  }
+
+  static importDOM(): null {
+    return null
+  }
+
+  static importJSON(
+    serializedNode: SerializedRichTextImageNode
+  ): RichTextImageNode {
+    return new RichTextImageNode(
+      typeof serializedNode.src === 'string' ? serializedNode.src : '',
+      typeof serializedNode.altText === 'string' ? serializedNode.altText : '',
+      serializedNode.alignment,
+      serializedNode.widthPercent
+    )
+  }
+
+  exportJSON(): SerializedRichTextImageNode {
+    return {
+      type: 'image',
+      version: 1,
+      src: this.__src,
+      altText: this.__altText,
+      alignment: this.__alignment,
+      widthPercent: this.__widthPercent,
+    }
+  }
+
+  isInline(): boolean {
+    return false
+  }
+
+  createDOM(_config: EditorConfig, _editor: LexicalEditor): HTMLElement {
+    return document.createElement('div')
+  }
+
+  updateDOM(): boolean {
+    return false
+  }
+
+  decorate(): null {
+    return null
+  }
+
+  exportDOM(_editor: LexicalEditor): DOMExportOutput {
+    if (!this.__src) {
+      return { element: null }
+    }
+
+    const wrapper = document.createElement('div')
+    wrapper.dataset.fsRichTextImageWrapper = ''
+    wrapper.dataset.fsRichTextImageAlignment = this.__alignment
+
+    const img = document.createElement('img')
+    img.dataset.fsRichTextImage = ''
+    img.src = withVtexResizeParams(this.__src, this.__widthPercent)
+    img.alt = this.__altText
+    img.setAttribute('loading', 'lazy')
+    img.style.width = `${this.__widthPercent}%`
+
+    wrapper.append(img)
+
+    return { element: wrapper }
+  }
+}

package/test/components/ui/RichText/RichText.browser.test.tsx

@@ -0,0 +1,321 @@
+/**
+ * @vitest-environment jsdom
+ */
+
+import { render } from '@testing-library/react'
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+
+const isContentPlatformSourceMock = vi.hoisted(() => vi.fn(() => true))
+
+vi.mock('src/server/content/utils', () => ({
+  isContentPlatformSource: isContentPlatformSourceMock,
+}))
+
+import { RichText } from '../../../../src/components/ui/RichText/RichText'
+
+function textNode(text: string) {
+  return {
+    detail: 0,
+    format: 0,
+    mode: 'normal',
+    style: '',
+    text,
+    type: 'text',
+    version: 1,
+  }
+}
+
+function paragraphNode(children: unknown[]) {
+  return {
+    children,
+    direction: 'ltr',
+    format: '',
+    indent: 0,
+    type: 'paragraph',
+    version: 1,
+  }
+}
+
+function headingNode(text: string, tag = 'h2') {
+  return {
+    children: [textNode(text)],
+    direction: 'ltr',
+    format: '',
+    indent: 0,
+    type: 'heading',
+    version: 1,
+    tag,
+  }
+}
+
+function linkNode(url: string, text: string) {
+  return {
+    children: [textNode(text)],
+    direction: 'ltr',
+    format: '',
+    indent: 0,
+    type: 'link',
+    version: 1,
+    rel: null,
+    target: null,
+    title: null,
+    url,
+  }
+}
+
+function listNode(itemText: string) {
+  return {
+    children: [
+      {
+        children: [textNode(itemText)],
+        direction: 'ltr',
+        format: '',
+        indent: 0,
+        type: 'listitem',
+        version: 1,
+        value: 1,
+      },
+    ],
+    direction: 'ltr',
+    format: '',
+    indent: 0,
+    type: 'list',
+    version: 1,
+    listType: 'bullet',
+    start: 1,
+    tag: 'ul',
+  }
+}
+
+function imageNode(overrides: Record<string, unknown> = {}) {
+  return {
+    type: 'image',
+    version: 1,
+    src: 'https://storeaccount.vtexassets.com/assets/vtex.file-manager-graphql/images/abc123.png',
+    altText: 'A nice picture',
+    alignment: 'center',
+    widthPercent: 60,
+    ...overrides,
+  }
+}
+
+function lexicalContent(children: unknown[]) {
+  return JSON.stringify({
+    root: {
+      children,
+      direction: 'ltr',
+      format: '',
+      indent: 0,
+      type: 'root',
+      version: 1,
+    },
+  })
+}
+
+function draftJsContent(text: string) {
+  return JSON.stringify({
+    blocks: [
+      {
+        key: '1',
+        text,
+        type: 'unstyled',
+        depth: 0,
+        inlineStyleRanges: [],
+        entityRanges: [],
+        data: {},
+      },
+    ],
+    entityMap: {},
+  })
+}
+
+describe('RichText', () => {
+  beforeEach(() => {
+    isContentPlatformSourceMock.mockReturnValue(true)
+  })
+
+  it('renders an image node with the correct src, alt, alignment and width', () => {
+    const { container } = render(
+      <RichText content={lexicalContent([imageNode()])} />
+    )
+
+    const wrapper = container.querySelector('[data-fs-rich-text-image-wrapper]')
+    const img = container.querySelector<HTMLImageElement>(
+      '[data-fs-rich-text-image]'
+    )
+
+    expect(wrapper?.getAttribute('data-fs-rich-text-image-alignment')).toBe(
+      'center'
+    )
+    expect(img?.getAttribute('alt')).toBe('A nice picture')
+    expect(img?.getAttribute('loading')).toBe('lazy')
+    expect(img?.getAttribute('style')).toBe('width: 60%;')
+
+    const src = img?.getAttribute('src') ?? ''
+    expect(src).toContain('width=432')
+    expect(src).toContain('aspect=true')
+    expect(src).toContain('quality=8')
+  })
+
+  it('renders images together with text, headings, links and lists in document order', () => {
+    const { container } = render(
+      <RichText
+        content={lexicalContent([
+          headingNode('Title'),
+          paragraphNode([
+            textNode('See '),
+            linkNode('https://example.com', 'this link'),
+          ]),
+          listNode('An item'),
+          imageNode(),
+        ])}
+      />
+    )
+
+    const html = container.innerHTML
+
+    expect(container.querySelector('h2')?.textContent).toBe('Title')
+    expect(
+      container.querySelector('a[href="https://example.com"]')
+    ).toBeTruthy()
+    expect(
+      container.querySelector('[data-fs-rich-text-list="true"]')
+    ).toBeTruthy()
+    expect(container.querySelector('[data-fs-rich-text-image]')).toBeTruthy()
+
+    const headingIndex = html.indexOf('<h2')
+    const linkIndex = html.indexOf('href="https://example.com"')
+    const listIndex = html.indexOf('data-fs-rich-text-list')
+    const imageIndex = html.indexOf('data-fs-rich-text-image-wrapper')
+
+    expect(headingIndex).toBeLessThan(linkIndex)
+    expect(linkIndex).toBeLessThan(listIndex)
+    expect(listIndex).toBeLessThan(imageIndex)
+  })
+
+  it('drops an image node with a missing src without breaking the rest of the content', () => {
+    const { container } = render(
+      <RichText
+        content={lexicalContent([
+          paragraphNode([textNode('Before')]),
+          imageNode({ src: '' }),
+          paragraphNode([textNode('After')]),
+        ])}
+      />
+    )
+
+    expect(container.querySelector('[data-fs-rich-text-image]')).toBeNull()
+    expect(
+      container.querySelector('[data-fs-rich-text-image-wrapper]')
+    ).toBeNull()
+    expect(container.textContent).toContain('Before')
+    expect(container.textContent).toContain('After')
+  })
+
+  it('does not throw and skips an image node with an unsupported/unexpected shape', () => {
+    expect(() =>
+      render(
+        <RichText
+          content={lexicalContent([
+            paragraphNode([textNode('Still here')]),
+            {
+              type: 'image',
+              version: 2,
+              imageUrl: 'https://storeaccount.vtexassets.com/assets/x.png',
+            },
+          ])}
+        />
+      )
+    ).not.toThrow()
+
+    const { container } = render(
+      <RichText
+        content={lexicalContent([
+          paragraphNode([textNode('Still here')]),
+          {
+            type: 'image',
+            version: 2,
+            imageUrl: 'https://storeaccount.vtexassets.com/assets/x.png',
+          },
+        ])}
+      />
+    )
+
+    expect(container.querySelector('[data-fs-rich-text-image]')).toBeNull()
+    expect(container.textContent).toContain('Still here')
+  })
+
+  it('renders multiple images, defaulting alignment/width when omitted and passing through non-VTEX URLs unmodified', () => {
+    const { container } = render(
+      <RichText
+        content={lexicalContent([
+          imageNode({ alignment: 'right', widthPercent: 30 }),
+          imageNode({
+            src: 'https://storeaccount.vtexassets.com/assets/vtex.file-manager-graphql/images/no-layout.png',
+            alignment: undefined,
+            widthPercent: undefined,
+          }),
+          imageNode({
+            src: 'https://cdn.example.com/external.png',
+            alignment: 'center',
+            widthPercent: 80,
+          }),
+        ])}
+      />
+    )
+
+    const wrappers = container.querySelectorAll(
+      '[data-fs-rich-text-image-wrapper]'
+    )
+    expect(wrappers).toHaveLength(3)
+
+    expect(wrappers[0].getAttribute('data-fs-rich-text-image-alignment')).toBe(
+      'right'
+    )
+
+    expect(wrappers[1].getAttribute('data-fs-rich-text-image-alignment')).toBe(
+      'left'
+    )
+    expect(
+      wrappers[1]
+        .querySelector('[data-fs-rich-text-image]')
+        ?.getAttribute('style')
+    ).toBe('width: 100%;')
+
+    const externalImg = wrappers[2].querySelector('[data-fs-rich-text-image]')
+    expect(externalImg?.getAttribute('src')).toBe(
+      'https://cdn.example.com/external.png'
+    )
+  })
+
+  it('clamps widthPercent to 100 so the image never overflows its container', () => {
+    const { container } = render(
+      <RichText content={lexicalContent([imageNode({ widthPercent: 150 })])} />
+    )
+
+    const img = container.querySelector('[data-fs-rich-text-image]')
+    expect(img?.getAttribute('style')).toBe('width: 100%;')
+  })
+
+  it('keeps rendering existing hCMS Draft.js content unaffected', () => {
+    isContentPlatformSourceMock.mockReturnValue(false)
+
+    const { container } = render(
+      <RichText content={draftJsContent('Hello legacy content')} />
+    )
+
+    expect(container.textContent).toContain('Hello legacy content')
+    expect(container.querySelector('[data-fs-rich-text-image]')).toBeNull()
+  })
+
+  it('keeps rendering existing Lexical content without images unaffected', () => {
+    const { container } = render(
+      <RichText
+        content={lexicalContent([paragraphNode([textNode('No images here')])])}
+      />
+    )
+
+    expect(container.textContent).toContain('No images here')
+    expect(container.querySelector('[data-fs-rich-text-image]')).toBeNull()
+  })
+})