@salesforce/retail-react-app 9.0.0 → 9.1.0-nightly-20260217081023

package/CHANGELOG.md

@@ -1,3 +1,6 @@
+## v9.1.0-dev
+- Add Node 24 support. Drop Node 16 support [#3652](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3652)
+
 ## v9.0.0 (Feb 12, 2026)
 - [Feature] One Click Checkout (in Developer Preview) [#3552](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3552)
 - [Feature] Add `fuzzyPathMatching` to reduce computational overhead of route generation at time of application load [#3530](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3530)

package/app/components/otp-auth/index.jsx

@@ -302,7 +302,7 @@ const OtpAuth = ({
                             )}
 
                             {/* Buttons */}
-                            <HStack spacing={4} width="100%" justifyContent="flex-end">
+                            <HStack spacing={4} width="100%" justifyContent="center">
                                 {!hideCheckoutAsGuestButton && (
                                     <Button
                                         onClick={handleCheckoutAsGuest}

package/app/components/shopper-agent/index.jsx

@@ -175,7 +175,8 @@ const ShopperAgentWindow = ({commerceAgentConfiguration, domainUrl}) => {
         commerceOrgId,
         siteId,
         enableConversationContext = 'false',
-        conversationContext = []
+        conversationContext = [],
+        enableAgentFromFloatingButton = 'true'
     } = commerceAgentConfiguration
 
     // User session identifier hook
@@ -352,7 +353,8 @@ const ShopperAgentWindow = ({commerceAgentConfiguration, domainUrl}) => {
         embeddedServiceEndpoint,
         scrt2Url,
         locale.id,
-        refreshToken
+        refreshToken,
+        enableAgentFromFloatingButton
     )
 
     // This component doesn't render visible UI, only manages the messaging service

package/app/components/shopper-agent/index.test.js

@@ -509,7 +509,31 @@ describe('ShopperAgent Component', () => {
             'https://test.salesforce.com', // embeddedServiceEndpoint
             'https://test.salesforce.com/scrt2.js', // scrt2Url
             'en-US', // locale.id
-            'test-refresh-token' // refreshToken
+            'test-refresh-token', // refreshToken
+            'true' // enableAgentFromFloatingButton (default)
+        )
+    })
+
+    test('should call useMiaw with enableAgentFromFloatingButton false when configured', () => {
+        const props = {
+            ...defaultProps,
+            commerceAgentConfiguration: {
+                ...commerceAgentSettings,
+                enableAgentFromFloatingButton: 'false'
+            }
+        }
+
+        render(<ShopperAgent {...props} />)
+
+        expect(mockedUseMiaw).toHaveBeenCalledWith(
+            {loaded: true, error: false},
+            'test-org-id',
+            'test-service',
+            'https://test.salesforce.com',
+            'https://test.salesforce.com/scrt2.js',
+            'en-US',
+            'test-refresh-token',
+            'false' // enableAgentFromFloatingButton
         )
     })
 

package/app/hooks/use-miaw.js

@@ -73,13 +73,15 @@ const normalizeLocaleToSalesforce = (locale) => {
  * @param {string} embeddedServiceDeploymentUrl - URL of the embedded service deployment
  * @param {string} scrt2Url - SCRT2 URL for the embedded messaging service
  * @param {string} locale - BCP-47 locale for the embedded messaging service
+ * @param {string} [enableAgentFromFloatingButton='true'] - When 'false', hides the floating chat button on load
  */
 const initEmbeddedMessaging = (
     salesforceOrgId,
     embeddedServiceDeploymentName,
     embeddedServiceDeploymentUrl,
     scrt2Url,
-    locale
+    locale,
+    enableAgentFromFloatingButton = 'true'
 ) => {
     try {
         if (
@@ -93,6 +95,9 @@ const initEmbeddedMessaging = (
             window.embeddedservice_bootstrap.settings.language = salesforceLanguage
             window.embeddedservice_bootstrap.settings.disableStreamingResponses = true
             window.embeddedservice_bootstrap.settings.enableUserInputForConversationWithBot = false
+            // Hide floating chat button when enableAgentFromFloatingButton is 'false'
+            window.embeddedservice_bootstrap.settings.hideChatButtonOnLoad =
+                enableAgentFromFloatingButton !== 'true'
             window.embeddedservice_bootstrap.init(
                 salesforceOrgId,
                 embeddedServiceDeploymentName,
@@ -117,6 +122,7 @@ const initEmbeddedMessaging = (
  * @param {string} scrt2Url - SCRT2 URL for the embedded messaging service
  * @param {string} locale - BCP-47 locale for the embedded messaging service
  * @param {string} refreshToken - Refresh token for the embedded messaging service
+ * @param {string} [enableAgentFromFloatingButton='true'] - When 'false', hides the floating chat button on load
  */
 const useMiaw = (
     scriptLoadStatus,
@@ -125,7 +131,8 @@ const useMiaw = (
     embeddedServiceDeploymentUrl,
     scrt2Url,
     locale,
-    refreshToken
+    refreshToken,
+    enableAgentFromFloatingButton = 'true'
 ) => {
     useEffect(() => {
         if (scriptLoadStatus.loaded && !scriptLoadStatus.error) {
@@ -135,7 +142,7 @@ const useMiaw = (
                 embeddedServiceDeploymentUrl,
                 scrt2Url,
                 locale,
-                refreshToken
+                enableAgentFromFloatingButton
             )
         }
     }, [
@@ -145,7 +152,8 @@ const useMiaw = (
         embeddedServiceDeploymentUrl,
         scrt2Url,
         locale,
-        refreshToken
+        refreshToken,
+        enableAgentFromFloatingButton
     ])
 }
 

package/app/hooks/use-miaw.test.js

@@ -141,6 +141,7 @@ describe('useMiaw hook', () => {
         expect(
             window.embeddedservice_bootstrap.settings.enableUserInputForConversationWithBot
         ).toBe(false)
+        expect(window.embeddedservice_bootstrap.settings.hideChatButtonOnLoad).toBe(false)
         expect(window.embeddedservice_bootstrap.init).toHaveBeenCalledWith(
             'test-org-id',
             'test-deployment',
@@ -167,6 +168,18 @@ describe('useMiaw hook', () => {
         expect(window.embeddedservice_bootstrap.init).not.toHaveBeenCalled()
     })
 
+    test('should hide floating chat button when enableAgentFromFloatingButton is false', () => {
+        renderHook(() =>
+            useMiaw(
+                mockScriptLoadStatus,
+                ...Object.values(mockParams),
+                'false' // enableAgentFromFloatingButton
+            )
+        )
+
+        expect(window.embeddedservice_bootstrap.settings.hideChatButtonOnLoad).toBe(true)
+    })
+
     test('should handle different locale mappings', () => {
         const testCases = [
             {locale: 'en-US', expected: 'en_US'},

package/app/utils/config-utils.js

@@ -20,7 +20,8 @@ export const getCommerceAgentConfig = () => {
         siteId: '',
         enableConversationContext: 'false',
         conversationContext: [],
-        enableAgentFromHeader: 'false'
+        enableAgentFromHeader: 'false',
+        enableAgentFromFloatingButton: 'false'
     }
     return getConfig().app.commerceAgent ?? defaults
 }

package/app/utils/shopper-agent-utils.js

@@ -9,6 +9,10 @@ const onClient = typeof window !== 'undefined'
 /**
  * Launch the chat using the embedded service bootstrap API
  *
+ * When the floating chat button is hidden (hideChatButtonOnLoad=true), this function
+ * first shows the chat button via utilAPI.showChatButton() before launching the chat,
+ * ensuring the chat window opens correctly.
+ *
  * @function launchChat
  * @returns {void}
  */
@@ -16,12 +20,16 @@ export function launchChat() {
     if (!onClient) return
 
     try {
-        // Launch chat using the embedded service bootstrap API
-        if (
-            window.embeddedservice_bootstrap?.utilAPI &&
-            typeof window.embeddedservice_bootstrap.utilAPI.launchChat === 'function'
-        ) {
-            window.embeddedservice_bootstrap.utilAPI.launchChat()
+        const utilAPI = window.embeddedservice_bootstrap?.utilAPI
+        if (!utilAPI) return
+        const hideChatButtonOnLoad =
+            window.embeddedservice_bootstrap?.settings?.hideChatButtonOnLoad === true
+        if (hideChatButtonOnLoad && typeof utilAPI.showChatButton === 'function') {
+            utilAPI.showChatButton()
+        }
+
+        if (typeof utilAPI.launchChat === 'function') {
+            utilAPI.launchChat()
         }
     } catch (error) {
         console.error('Shopper Agent: Error launching chat', error)

package/app/utils/shopper-agent-utils.test.js

@@ -80,6 +80,54 @@ describe('shopper-agent-utils', () => {
             expect(() => launchChat()).not.toThrow()
         })
 
+        test('should call showChatButton before launchChat when hideChatButtonOnLoad is true', () => {
+            const mockShowChatButton = jest.fn()
+            const mockLaunchChat = jest.fn()
+
+            global.window = {
+                embeddedservice_bootstrap: {
+                    settings: {
+                        hideChatButtonOnLoad: true
+                    },
+                    utilAPI: {
+                        showChatButton: mockShowChatButton,
+                        launchChat: mockLaunchChat
+                    }
+                }
+            }
+
+            launchChat()
+
+            expect(mockShowChatButton).toHaveBeenCalledTimes(1)
+            expect(mockLaunchChat).toHaveBeenCalledTimes(1)
+            // showChatButton must be called before launchChat
+            expect(mockShowChatButton.mock.invocationCallOrder[0]).toBeLessThan(
+                mockLaunchChat.mock.invocationCallOrder[0]
+            )
+        })
+
+        test('should not call showChatButton when hideChatButtonOnLoad is false', () => {
+            const mockShowChatButton = jest.fn()
+            const mockLaunchChat = jest.fn()
+
+            global.window = {
+                embeddedservice_bootstrap: {
+                    settings: {
+                        hideChatButtonOnLoad: false
+                    },
+                    utilAPI: {
+                        showChatButton: mockShowChatButton,
+                        launchChat: mockLaunchChat
+                    }
+                }
+            }
+
+            launchChat()
+
+            expect(mockShowChatButton).not.toHaveBeenCalled()
+            expect(mockLaunchChat).toHaveBeenCalledTimes(1)
+        })
+
         test('should handle errors and log error', () => {
             const mockLaunchChat = jest.fn(() => {
                 throw new Error('Launch error')

package/config/default.js

@@ -105,7 +105,7 @@ module.exports = {
         '**/*.json'
     ],
     ssrParameters: {
-        ssrFunctionNodeVersion: '22.x',
+        ssrFunctionNodeVersion: '24.x',
         proxyConfigs: [
             {
                 host: 'kv7kzm78.api.commercecloud.salesforce.com',

package/config/mocks/default.js

@@ -145,7 +145,7 @@ module.exports = {
     ],
     // Additional parameters that configure Express app behavior.
     ssrParameters: {
-        ssrFunctionNodeVersion: '22.x',
+        ssrFunctionNodeVersion: '24.x',
         proxyConfigs: [
             {
                 host: 'localhost:8888',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/retail-react-app",
-  "version": "9.0.0",
+  "version": "9.1.0-nightly-20260217081023",
   "license": "See license in LICENSE",
   "author": "cc-pwa-kit@salesforce.com",
   "ccExtensibility": {
@@ -46,10 +46,10 @@
     "@loadable/component": "^5.15.3",
     "@peculiar/webcrypto": "^1.4.2",
     "@salesforce/cc-datacloud-typescript": "1.1.2",
-    "@salesforce/commerce-sdk-react": "5.0.0",
-    "@salesforce/pwa-kit-dev": "3.16.0",
-    "@salesforce/pwa-kit-react-sdk": "3.16.0",
-    "@salesforce/pwa-kit-runtime": "3.16.0",
+    "@salesforce/commerce-sdk-react": "5.1.0-nightly-20260217081023",
+    "@salesforce/pwa-kit-dev": "3.17.0-nightly-20260217081023",
+    "@salesforce/pwa-kit-react-sdk": "3.17.0-nightly-20260217081023",
+    "@salesforce/pwa-kit-runtime": "3.17.0-nightly-20260217081023",
     "@tanstack/react-query": "^4.28.0",
     "@tanstack/react-query-devtools": "^4.29.1",
     "@testing-library/dom": "^9.0.1",
@@ -95,8 +95,8 @@
     }
   },
   "engines": {
-    "node": "^16.11.0 || ^18.0.0 || ^20.0.0 || ^22.0.0",
-    "npm": "^8.0.0 || ^9.0.0 || ^10.0.0 || ^11.0.0"
+    "node": "^18.0.0 || ^20.0.0 || ^22.0.0 || ^24.0.0",
+    "npm": "^9.0.0 || ^10.0.0 || ^11.0.0"
   },
   "bundlesize": [
     {
@@ -108,5 +108,5 @@
       "maxSize": "366 kB"
     }
   ],
-  "gitHead": "6c5fadd745fbd4f666d0887f45d01719e86b3ead"
+  "gitHead": "e5934d1d14a90adf3438d383d60aac5ca57449ed"
 }