commerce-sdk-react v4 - Remove deprecated properties + fix private client proxy endpoint prop name (#3177)

* Clean up useDNT deprecations

* Breaking: remove /mobify path constants from commerce-sdk-react

* Fix private client prop name

* Update changelogs

* Update CHANGELOG.md

* update more places that called updateDNT

Author: vcua-mobify

packages/commerce-sdk-react/CHANGELOG.md

@@ -1,8 +1,8 @@
 ## v3.5.0-dev (Jul 22, 2025)
 - Add support for environment level base paths on /mobify routes [#2892](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2892)
 - Update USID expiry to match SLAS refresh token expiry[#2854](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2854)
-
 - [Bugfix] Skip deleting dwsid on shopper login if hybrid auth is enabled for current site. [#3151](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3151)
+- Remove deprecated properties in commerce-sdk-react [#3177](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3177)
 
 ## v3.4.0 (Jul 22, 2025)
 

packages/commerce-sdk-react/src/auth/index.ts

@@ -25,8 +25,6 @@ import {
     extractCustomParameters
 } from '../utils'
 import {
-    MOBIFY_PATH,
-    SLAS_PRIVATE_PROXY_PATH,
     SLAS_SECRET_WARNING_MSG,
     SLAS_SECRET_PLACEHOLDER,
     SLAS_SECRET_OVERRIDE_MSG,
@@ -250,16 +248,9 @@ class Auth {
     constructor(config: AuthConfig) {
         // Special proxy endpoint for injecting SLAS private client secret.
         // We prioritize config.privateClientProxyEndpoint since that allows us to use the new envBasePath feature
-        // The preexisting hard coded privateClientEndpoint is kept here for now to prevent a breaking change.
-        // TODO: We should remove this in the next major release so we do not have a hard coded proxy path inside commerce-sdk-react
-        const baseUrl = config.proxy.split(MOBIFY_PATH)[0]
-        const privateClientEndpoint = `${baseUrl}${SLAS_PRIVATE_PROXY_PATH}`
-
         this.client = new ShopperLogin({
             proxy: config.enablePWAKitPrivateClient
                 ? config.privateClientProxyEndpoint
-                    ? config.privateClientProxyEndpoint
-                    : privateClientEndpoint
                 : config.proxy,
             parameters: {
                 clientId: config.clientId,
@@ -345,13 +336,7 @@ class Auth {
         this.isPrivate = !!this.clientSecret
 
         const passwordlessLoginCallbackURI = config.passwordlessLoginCallbackURI
-        this.passwordlessLoginCallbackURI = passwordlessLoginCallbackURI
-            ? isAbsoluteUrl(passwordlessLoginCallbackURI)
-                ? passwordlessLoginCallbackURI
-                : // This fallback does not take into account the envBasePath feature
-                  // To set an env base path, config.passwordlessLoginCallbackURI must be an absolute url
-                  `${baseUrl}${passwordlessLoginCallbackURI}`
-            : ''
+        this.passwordlessLoginCallbackURI = passwordlessLoginCallbackURI || ''
 
         this.hybridAuthEnabled = config.hybridAuthEnabled || false
     }

packages/commerce-sdk-react/src/components/StorefrontPreview/utils.ts

@@ -7,7 +7,8 @@
 
 import {ApiClients} from '../../hooks/types'
 import {DEVELOPMENT_ORIGIN, getParentOrigin, isOriginTrusted} from '../../utils'
-import {LOCAL_BUNDLE_PATH} from '../../constant'
+
+const LOCAL_BUNDLE_PATH = `/mobify/bundle/development`
 
 /** Detects whether the storefront is running in an iframe as part of Storefront Preview.
  * @private

packages/commerce-sdk-react/src/constant.ts

@@ -14,25 +14,6 @@ export const IFRAME_HOST_ALLOW_LIST = Object.freeze([
     'https://runtime-admin-preview.mobify-storefront.com'
 ])
 
-/* Deprecating the following path constants since, outside of storefront preview,
- * the paths they are used for can be passed in via the provider. */
-/**
- * @deprecated
- */
-export const MOBIFY_PATH = '/mobify'
-/**
- * @deprecated
- */
-export const PROXY_PATH = `${MOBIFY_PATH}/proxy`
-/**
- * @deprecated
- */
-export const LOCAL_BUNDLE_PATH = `${MOBIFY_PATH}/bundle/development`
-/**
- * @deprecated
- */
-export const SLAS_PRIVATE_PROXY_PATH = `${MOBIFY_PATH}/slas/private`
-
 export const SLAS_SECRET_WARNING_MSG =
     'You are potentially exposing SLAS secret on browser. Make sure to keep it safe and secure!'
 

packages/commerce-sdk-react/src/hooks/useDNT.test.ts

@@ -37,9 +37,9 @@ describe('useDNT tests', () => {
         })
     })
 
-    it('updateDNT should create dw_dnt cookie', async () => {
-        const {updateDNT} = useDNT()
-        await updateDNT(true)
+    it('updateDnt should create dw_dnt cookie', async () => {
+        const {updateDnt} = useDNT()
+        await updateDnt(true)
         expect(mockSetDnt).toHaveBeenCalledWith(true)
     })
 

packages/commerce-sdk-react/src/hooks/useDNT.ts

@@ -8,9 +8,7 @@ import useAuthContext from './useAuthContext'
 
 interface useDntReturn {
     selectedDnt: boolean | undefined
-    dntStatus: boolean | undefined
     effectiveDnt: boolean | undefined
-    updateDNT: (preference: boolean | null) => Promise<void>
     updateDnt: (preference: boolean | null) => Promise<void>
 }
 
@@ -26,8 +24,6 @@ interface useDntReturn {
  *              If defaultDnt is undefined as well, then SDK default is used.
  * @property {function} updateDnt - takes a DNT choice and creates the dw_dnt
  *              cookie and reauthorizes with SLAS
- * @property {function} updateDNT - @deprecated Deprecated since version 3.1.0. Use updateDnt instead.
- * @property {boolean} dntStatus - @deprecated Deprecated since version 3.1.0. Use selectedDnt instead.
  *
  *
  */
@@ -40,14 +36,10 @@ const useDNT = (): useDntReturn => {
     const updateDnt = async (preference: boolean | null) => {
         await auth.setDnt(preference)
     }
-    const updateDNT = updateDnt
-    const dntStatus = selectedDnt
 
     return {
         selectedDnt,
         effectiveDnt,
-        dntStatus,
-        updateDNT,
         updateDnt
     }
 }

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

@@ -65,7 +65,8 @@ describe('provider', () => {
             )
         }
         const config = {
-            enablePWAKitPrivateClient: true
+            enablePWAKitPrivateClient: true,
+            privateClientProxyEndpoint: 'http://localhost:3000/mobify/slas/private'
         }
         renderWithProviders(<Component />, config)
         const element = screen.getByTestId('proxy-value')

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

@@ -8,12 +8,7 @@ import React, {ReactElement, useEffect, useMemo} from 'react'
 import Auth from './auth'
 import {ApiClientConfigParams, ApiClients, SDKClientTransformer} from './hooks/types'
 import {Logger} from './types'
-import {
-    DWSID_COOKIE_NAME,
-    MOBIFY_PATH,
-    SERVER_AFFINITY_HEADER_KEY,
-    SLAS_PRIVATE_PROXY_PATH
-} from './constant'
+import {DWSID_COOKIE_NAME, SERVER_AFFINITY_HEADER_KEY} from './constant'
 import {
     ShopperBaskets,
     ShopperContexts,
@@ -257,14 +252,6 @@ const CommerceApiProvider = (props: CommerceApiProviderProps): ReactElement => {
             fetchOptions
         }
 
-        // Special proxy endpoint for injecting SLAS private client secret.
-        // This is only used by the ShopperLogin API as that is the only one that interacts with SLAS.
-        // We prioritize config.privateClientProxyEndpoint since that allows us to use the new envBasePath feature
-        // The preexisting hard coded privateClientEndpoint is kept here for now to prevent a breaking change.
-        // TODO: We should remove this in the next major release so we do not have a hard coded proxy path inside commerce-sdk-react
-        const baseUrl = config.proxy.split(MOBIFY_PATH)[0]
-        const privateClientEndpoint = `${baseUrl}${SLAS_PRIVATE_PROXY_PATH}`
-
         return {
             shopperBaskets: new ShopperBaskets(config),
             shopperContexts: new ShopperContexts(config),
@@ -273,11 +260,7 @@ const CommerceApiProvider = (props: CommerceApiProviderProps): ReactElement => {
             shopperGiftCertificates: new ShopperGiftCertificates(config),
             shopperLogin: new ShopperLogin({
                 ...config,
-                proxy: enablePWAKitPrivateClient
-                    ? privateClientProxyEndpoint
-                        ? privateClientProxyEndpoint
-                        : privateClientEndpoint
-                    : config.proxy
+                proxy: enablePWAKitPrivateClient ? privateClientProxyEndpoint : config.proxy
             }),
             shopperOrders: new ShopperOrders(config),
             shopperProducts: new ShopperProducts(config),

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

@@ -16,15 +16,14 @@ import {
 import nock from 'nock'
 import CommerceApiProvider, {CommerceApiProviderProps} from './provider'
 import userEvent from '@testing-library/user-event'
-import {PROXY_PATH} from './constant'
 
 // Note: this host does NOT exist
 // it is intentional b/c we can catch those unintercepted requests
 // from log easily. You should always make sure all requests are nocked.
 export const DEFAULT_TEST_HOST = 'http://localhost:8888'
 
 export const DEFAULT_TEST_CONFIG = {
-    proxy: `${DEFAULT_TEST_HOST}${PROXY_PATH}/api`,
+    proxy: `${DEFAULT_TEST_HOST}/mobify/proxy/api`,
     redirectURI: `${DEFAULT_TEST_HOST}/callback`,
     clientId: '12345678-1234-1234-1234-123412341234',
     organizationId: 'f_ecom_zzrmy_orgf_001',

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

@@ -1,6 +1,7 @@
 ## v3.12.0-dev (Jul 22, 2025)
 - This feature introduces an AI-powered shopping assistant that integrates Salesforce Embedded Messaging Service with PWA Kit applications. The shopper agent provides real-time chat support, search assistance, and personalized shopping guidance directly within the e-commerce experience. [#2658](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2658)
 - Add support for environment level base paths on /mobify routes [#2892](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2892)
+- Fix private client endpoint prop name in app config templates [#3177](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3177)
 - Add `--initGit` to automate git repo creation for the generated project [#2817](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2817)