Hybrid Stability Upgrade for PWA Kit Version 3.8.0

This guide explains how to make and verify code changes in a hybrid storefront to:

  • Update a Progressive Web App (PWA) Kit project from version 3.5.0 or later to version 3.8.0.
  • Upgrade from Plugin Shopper Login and API Access Service (Plugin SLAS) version 7.3.0 or later to version 7.4.0.

We recommend testing the steps in a non-production environment before deploying your changes to production.

This guide applies to hybrid storefronts built in part with PWA Kit version 3.5.0 or later. For the steps that apply to PWA Kit version 2.x, see Hybrid Stability Upgrade for PWA Kit Version 2.x.

Only existing customers can access some of the links on this page. Visit Salesforce Commerce Cloud GitHub Repositories and Access for information about how to get access to the Commerce Cloud repositories.

To improve stability and performance for hybrid storefronts, we:

  • Removed calls to OCAPI /sessions from PWA Kit to eliminate session churn (frequent changes to dwsid). For more information about dwsid, see Understand Session Management between SFRA and PWA Kit.
  • Added a header to Salesforce Commerce API (SCAPI) calls to send the dwsid to SCAPI to ensure that requests from a given shopper session are routed to the same app server.
  • Removed the Open Commerce API (OCAPI) proxy from the PWA Kit configuration, which makes PWA Kit fully SCAPI-based.

If you haven’t already done so, complete these steps.

Open a support case that asks Salesforce Customer Support to enable Session Override for dwsid.

If you're using PWA Kit version 3.5.0 or later:

  1. To upgrade to the latest version of Commerce SDK React, run:

    npm install @salesforce/commerce-sdk-react@latest

  2. To upgrade to the latest version of the Retail React App, run:

    npm install @salesforce/retail-react-app@latest

If you're using Plugin SLAS version 7.3.0 or later, complete these steps.

  1. In cartridges/plugin_slas/cartridge/controllers/Login.js:

    • Remove the access_token cookie after logout in the /Login-Logout controller
    • Add config.ACCESS_TOKEN_COOKIE_NAME to the cookiesToRemove array in the /Login-Logout controller.
  2. In cartridges/plugin_slas/cartridge/scripts/helpers/slasAuthHelper.js, update the removeCookie function to remove any existing chunks of cookies:

    • Change the condition from exact match (==) to .startsWith.
  3. In cartridges/plugin_slas/cartridge/scripts/hooks/request/onSession.js, update the onSession hook implementation for the new guest shopper flow:

    • Extract the dwsid from x-is-session_id header into a variable.
    • Use the variable in the call to getSLASAccessTokenForGuestSessionBridge.
    • Set the dwsid cookie to the response for new guest shoppers.

See the files changed in this pull request.

  1. Confirm that PWA Kit isn’t making calls to OCAPI /sessions.

    • Go to your storefront and clear all site data.

      If you’re using Chrome DevTools, see Delete all cache data.

    • Refresh your storefront or go to any page that’s PWA Kit-based and inspect the Network Tab in Chrome DevTools. Confirm that you don’t see requests being made to dw/shop/<version>/sessions. See this example from Chrome DevTools.

No Sessions

  1. Confirm that dwsid is sent with all SCAPI requests.

    • Go to your storefront. Visit any SFRA/SG-based page then go to a PWA Kit-based page.
    • If you’re using Chrome DevTools:
      • Open Cookie Storage and look for dwsid value in the cookies. See Open the Cookies pane.
      • Open the Network Tab and inspect any SCAPI request (for example, /baskets). In the Request Headers, confirm that you see the sfdc_dwsid header with the value same as the dwsid that you found in the previous step. See this example from Chrome DevTools.

No Sessions