Merge pull request #2686 from SalesforceCommerceCloud/bendvc/update-pwa-developer-agent-only

[Chore🧹] Update `feature/pwa-developer-agent-only` from `develop`

Author: bendvc

.cursor/rules/testing/unit-tests-generic.mdc

@@ -3,9 +3,26 @@ description: USE WHEN writing unit tests for components in template packages
 globs: ["packages/template-*/*/components/**/*.test.{js,jsx,ts,tsx}"]
 alwaysApply: false
 ---
+USE WHEN writing unit tests for components in template packages
 
 # 🧪 Generic Component Test Rules
 
+# CRITICAL: AI Attribution Requirements
+* **IMPORTANT** All individual test methods generated or modified by Cursor MUST include an AI attribution comment directly above the test stating the following: 
+"DO NOT REMOVE THIS COMMENT! This test was generated by Cursor". The comment should go on the test method and not the test class. Failure to add an AI Attribution Comment will be considered a failure of test generation.
+* The AI attribution comment MUST include a comment declaring the LLM model that was used in writing the test on its own line.
+
+*Sample AI Attribution Comment*
+```
+/*
+ * DO NOT REMOVE THIS COMMENT! This test was generated by Cursor 
+ * This test was generated with the following model: Claude 3.5 Sonnet
+ */
+test('renders component correctly', () => {
+    // test implementation
+})
+```
+
 ## Structure & Best Practices
 - Use `describe` blocks to group tests, `test` for individual cases
 - Use `beforeEach` for setup, clear mocks after each test
@@ -34,3 +51,23 @@ describe('MyComponent', () => {
     })
 })
 ```
+
+## Running Tests
+After creating unit tests, **ALWAYS run the tests** to verify they pass and provide feedback on test results.
+
+### Command Format:
+```bash
+cd packages/<package-name> && npm run test -- '<relative-path-to-test-file> --coverage=false'
+```
+
+### Examples:
+```bash
+# Run specific test file from packages directory
+cd packages/template-retail-react-app && npm run test -- 'app/components/drawer-menu/drawer-menu.test.js --coverage=false'
+```
+
+### After Running Tests:
+- Report if tests **pass** or **fail**
+- If tests fail, provide the error messages and fix any issues
+- Confirm test coverage is appropriate for the component's core functionality
+- Suggest any additional tests if critical functionality is missing

.cursor/rules/testing/unit-tests-template-retail-react-app.mdc

@@ -3,7 +3,6 @@ description: USE WHEN writing unit tests in template-retail-react-app components
 globs: ["packages/template-retail-react-app/app/components/**/*.test.{js,jsx,ts,tsx}"]
 alwaysApply: false
 ---
-
 # 🛍️ Retail React App Test Rules
 
 ## Package-Specific Requirements
@@ -15,6 +14,10 @@ alwaysApply: false
 ## API Mocking
 - Use `prependHandlersToServer` or `msw` for API mocking
 
+## Mock Data Usage
+
+- **Mandatory**: Always use existing mock data from `@salesforce/retail-react-app/app/mocks/` if it is available. This ensures consistency across tests and reduces redundancy. Creating new mock data should only be considered if the required data is not already present in the mocks directory.
+
 ```js
 import {screen} from '@testing-library/react'
 import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'

packages/commerce-sdk-react/CHANGELOG.md

@@ -1,4 +1,6 @@
 ## v3.4.0-dev.0 (May 23, 2025)
+
+- Optionally disable auth init in CommerceApiProvider [#2629](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2629)
 - Now compatible with either React 17 and 18 [#2506](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2506)
 - Gracefully handle missing SDK Clients in CommerceApiProvider [#2539](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2539)
 - Refactor commerce-sdk-react to allow injecting ApiClients [#2519](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2519)

packages/commerce-sdk-react/src/provider.test.tsx

@@ -72,4 +72,20 @@ describe('provider', () => {
         expect(element).toBeInTheDocument()
         expect(element.textContent?.includes('/mobify/slas/private')).toBeTruthy()
     })
+
+    test('does not call Auth.ready() when disableAuthInit is true', () => {
+        renderWithProviders(<h1>Auth not initialized!</h1>, {disableAuthInit: true})
+        expect(screen.getByText('Auth not initialized!')).toBeInTheDocument()
+        expect(Auth).toHaveBeenCalledTimes(1)
+        const authInstance = (Auth as jest.Mock).mock.instances[0]
+        expect(authInstance.ready).toHaveBeenCalledTimes(0)
+    })
+
+    test('calls Auth.ready() when disableAuthInit is false', () => {
+        renderWithProviders(<h1>Auth initialized!</h1>, {disableAuthInit: false})
+        expect(screen.getByText('Auth initialized!')).toBeInTheDocument()
+        expect(Auth).toHaveBeenCalledTimes(1)
+        const authInstance = (Auth as jest.Mock).mock.instances[0]
+        expect(authInstance.ready).toHaveBeenCalledTimes(1)
+    })
 })

packages/commerce-sdk-react/src/provider.tsx

@@ -49,6 +49,7 @@ export interface CommerceApiProviderProps extends ApiClientConfigParams {
     refreshTokenRegisteredCookieTTL?: number
     refreshTokenGuestCookieTTL?: number
     apiClients?: ApiClients
+    disableAuthInit?: boolean
 }
 
 /**
@@ -132,7 +133,8 @@ const CommerceApiProvider = (props: CommerceApiProviderProps): ReactElement => {
         passwordlessLoginCallbackURI,
         refreshTokenRegisteredCookieTTL,
         refreshTokenGuestCookieTTL,
-        apiClients
+        apiClients,
+        disableAuthInit = false
     } = props
 
     // Set the logger based on provided configuration, or default to the console object if no logger is provided
@@ -270,7 +272,11 @@ const CommerceApiProvider = (props: CommerceApiProviderProps): ReactElement => {
     ])
 
     // Initialize the session
-    useEffect(() => void auth.ready(), [auth])
+    useEffect(() => {
+        if (!disableAuthInit) {
+            void auth.ready()
+        }
+    }, [auth, disableAuthInit])
 
     return (
         <ConfigContext.Provider

packages/pwa-kit-create-app/CHANGELOG.md

@@ -1,17 +1,20 @@
 ## v3.11.0-dev.0 (May 23, 2025)
+- Add `program.json` + Support for Agent-Friendly CLI Input via stdio [#2662](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2662)
+- Change the default ECOM instance in the generated application [#2610](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2610)
+- Load active data scripts on demand only [#2623](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2623)
 
 ## v3.10.0 (May 22, 2025)
-- Add Data Cloud API configuration to `default.js`. [#2318] (https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2229)
+- Add Data Cloud API configuration to `default.js`. [#2318](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2318)
 - Fix dependencies vulnerabilities [#2338](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2338)
 
 ## v3.9.1 (Mar 05, 2025)
 - Update PWA-Kit SDKs to v3.9.1 [#2301](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2301)
 
 ## v3.9.0 (Feb 18, 2025)
 
-- Update `default.js` and `ssr.js` template to support new passwordless, social, and reset password flows. [#2263] (https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2263)
+- Update `default.js` and `ssr.js` template to support new passwordless, social, and reset password flows. [#2263](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2263)
 - Support Node 22 [#2218](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2218)
-- Update `default.js` template to include new login configurations [#2079] (https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2079)
+- Update `default.js` template to include new login configurations [#2079](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2079)
 - Handle import error when ssr.js imports from template retail react app [#2270](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2270)
 
 ## v3.8.0 (Oct 28, 2024)

packages/pwa-kit-create-app/assets/bootstrap/js/overrides/app/constants.js.hbs

@@ -16,7 +16,7 @@
 import {
     DEFAULT_LIMIT_VALUES,
     DEFAULT_SEARCH_PARAMS
-} from '{{preset.templateSource.id}}/app/constants'
+} from '{{template.source.name}}/app/constants'
 
 // original value is 25
 DEFAULT_LIMIT_VALUES[0] = 3
@@ -26,4 +26,4 @@ export const CUSTOM_HOME_TITLE = '🎉 Hello Extensible React Template!'
 
 export {DEFAULT_LIMIT_VALUES, DEFAULT_SEARCH_PARAMS}
 
-export * from '{{preset.templateSource.id}}/app/constants'
+export * from '{{template.source.name}}/app/constants'

packages/pwa-kit-create-app/assets/bootstrap/js/overrides/app/pages/home/index.jsx.hbs

@@ -9,19 +9,19 @@ import {useIntl, FormattedMessage} from 'react-intl'
 import {useLocation} from 'react-router-dom'
 
 // Components
-import {Box, Button, Stack, Link} from '{{preset.templateSource.id}}/app/components/shared/ui'
+import {Box, Button, Stack, Link} from '{{template.source.name}}/app/components/shared/ui'
 
 // Project Components
-import Hero from '{{preset.templateSource.id}}/app/components/hero'
-import Seo from '{{preset.templateSource.id}}/app/components/seo'
-import Section from '{{preset.templateSource.id}}/app/components/section'
-import ProductScroller from '{{preset.templateSource.id}}/app/components/product-scroller'
+import Hero from '{{template.source.name}}/app/components/hero'
+import Seo from '{{template.source.name}}/app/components/seo'
+import Section from '{{template.source.name}}/app/components/section'
+import ProductScroller from '{{template.source.name}}/app/components/product-scroller'
 
 // Others
 import {getAssetUrl} from '@salesforce/pwa-kit-react-sdk/ssr/universal/utils'
 
 //Hooks
-import useEinstein from '{{preset.templateSource.id}}/app/hooks/use-einstein'
+import useEinstein from '{{template.source.name}}/app/hooks/use-einstein'
 
 // Constants
 import {

packages/pwa-kit-create-app/assets/bootstrap/js/overrides/app/routes.jsx.hbs

@@ -15,9 +15,9 @@ import loadable from '@loadable/component'
 import {getConfig} from '@salesforce/pwa-kit-runtime/utils/ssr-config'
 
 // Components
-import {Skeleton} from '{{preset.templateSource.id}}/app/components/shared/ui'
-import {configureRoutes} from '{{preset.templateSource.id}}/app/utils/routes-utils'
-import {routes as _routes} from '{{preset.templateSource.id}}/app/routes'
+import {Skeleton} from '{{template.source.name}}/app/components/shared/ui'
+import {configureRoutes} from '{{template.source.name}}/app/utils/routes-utils'
+import {routes as _routes} from '{{template.source.name}}/app/routes'
 
 const fallback = <Skeleton height="75vh" width="100%" />
 

packages/pwa-kit-create-app/assets/bootstrap/js/overrides/app/ssr.js.hbs

@@ -289,7 +289,8 @@ const {handler} = runtime.createHandler(options, (app) => {
                 directives: {
                     'img-src': [
                         // Default source for product images - replace with your CDN
-                        '*.commercecloud.salesforce.com'
+                        '*.commercecloud.salesforce.com',
+                        '*.demandware.net'
                     ],
                     'script-src': [
                         // Used by the service worker in /worker/main.js