@salesforce/ui-bundle-template-app-react-template-b2x 11.51.0 → 11.52.0

package/dist/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [11.52.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v11.51.0...v11.52.0) (2026-08-09)
+
+**Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project
+
+
+
+
+
 ## [11.51.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v11.50.0...v11.51.0) (2026-08-07)
 
 **Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project

package/dist/PRD.md

@@ -10,7 +10,7 @@ Building a customer-facing portal on Salesforce usually means solving the hard p
 
 ## Solution
 
-A minimal external-facing starter with everything already in place: the app framework, a full sign-in experience with protected private areas, the public site setup, and a single example feature — Account search — that shows how the app displays Salesforce data. The sign-in and site setup are done for you so teams can focus on the customer experience, and the Account example serves as a template for building their own features.
+A minimal external-facing starter with everything already in place: the app framework, a full sign-in experience with protected private areas, a built-in Agentforce chat assistant, the public site setup, and a single example feature — Account search — that shows how the app displays Salesforce data. The sign-in and site setup are done for you so teams can focus on the customer experience, and the Account example serves as a template for building their own features.
 
 ### Core Features
 

package/dist/force-app/main/default/uiBundles/reactexternalapp/package.json

@@ -18,8 +18,8 @@
     "graphql:schema": "node scripts/get-graphql-schema.mjs"
   },
   "dependencies": {
-    "@salesforce/platform-sdk": "^11.51.0",
-    "@salesforce/ui-bundle": "^11.51.0",
+    "@salesforce/platform-sdk": "^11.52.0",
+    "@salesforce/ui-bundle": "^11.52.0",
     "@tailwindcss/vite": "^4.1.17",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -46,8 +46,8 @@
     "@graphql-eslint/eslint-plugin": "^4.1.0",
     "@graphql-tools/utils": "^11.0.0",
     "@playwright/test": "^1.49.0",
-    "@salesforce/graphiti": "^11.51.0",
-    "@salesforce/vite-plugin-ui-bundle": "^11.51.0",
+    "@salesforce/graphiti": "^11.52.0",
+    "@salesforce/vite-plugin-ui-bundle": "^11.52.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.1.0",
     "@testing-library/user-event": "^14.5.2",

package/dist/force-app/main/default/uiBundles/reactexternalapp/src/appLayout.tsx

@@ -3,6 +3,7 @@ import { getAllRoutes } from "./router-utils";
 import { useState } from "react";
 import { AuthMenu } from "./features/authentication/menu/AuthMenu";
 import { Button } from "./components/ui/button";
+import CustomerWebClientChat from "./components/CustomerWebClientChat";
 
 export default function AppLayout() {
 	const [isOpen, setIsOpen] = useState(false);
@@ -83,6 +84,12 @@ export default function AppLayout() {
 				</div>
 			</nav>
 			<Outlet />
+			<CustomerWebClientChat
+				orgId="<ORG_ID_15_OR_18_CHAR_00D...>"
+				deploymentName="<EMBEDDED_SERVICE_DEPLOYMENT_NAME>"
+				siteURL="<SITE_URL>"
+				scrt2URL="<SCRT2_URL>"
+			/>
 		</>
 	);
 }

package/dist/force-app/main/default/uiBundles/reactexternalapp/src/components/CustomerWebClientChat.tsx

@@ -0,0 +1,74 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import { useEffect } from "react";
+import type { CustomerWebClientChatProps, WindowWithCwcProperties } from "../types/chat";
+
+/**
+ * React wrapper that embeds the Customer Web Client (Embedded Messaging) chat
+ * widget into an external site. It dynamically loads the site's
+ * `embeddedservice_bootstrap` script and calls `init` with the org, deployment,
+ * site, and SCRT2 configuration. Renders nothing itself — the chat UI is a
+ * floating widget injected by the bootstrap script.
+ */
+export function CustomerWebClientChat({
+	orgId,
+	deploymentName,
+	siteURL,
+	scrt2URL,
+	language = "en",
+	devMode = false,
+}: CustomerWebClientChatProps) {
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		if (
+			!orgId ||
+			!deploymentName ||
+			!siteURL ||
+			!scrt2URL ||
+			!(orgId.length === 15 || orgId.length === 18)
+		) {
+			console.warn("[CustomerWebClientChat] missing required config; skipping init");
+			return;
+		}
+
+		const win = window as WindowWithCwcProperties;
+		const bootstrapSrc = `${siteURL}/assets/js/bootstrap.js`;
+		const existing = document.querySelector<HTMLScriptElement>(`script[src="${bootstrapSrc}"]`);
+		const script: HTMLScriptElement = existing ?? document.createElement("script");
+
+		const init = () => {
+			try {
+				if (!win.embeddedservice_bootstrap) return;
+				win.embeddedservice_bootstrap.settings.language = language;
+				if (devMode) win.embeddedservice_bootstrap.settings.devMode = true;
+				win.embeddedservice_bootstrap.init(orgId, deploymentName, siteURL, {
+					scrt2URL,
+				});
+			} catch (err) {
+				console.error("Error loading Embedded Messaging: ", err);
+			}
+		};
+
+		if (existing) {
+			if (win.embeddedservice_bootstrap) init();
+			else existing.addEventListener("load", init, { once: true });
+		} else {
+			script.type = "text/javascript";
+			script.src = bootstrapSrc;
+			script.addEventListener("load", init, { once: true });
+			document.body.appendChild(script);
+		}
+
+		return () => {
+			script.removeEventListener("load", init);
+		};
+	}, [orgId, deploymentName, siteURL, scrt2URL, language, devMode]);
+
+	return null;
+}
+
+export default CustomerWebClientChat;

package/dist/force-app/main/default/uiBundles/reactexternalapp/src/index.ts

@@ -0,0 +1,6 @@
+/**
+ * feature-react-customer-web-client-chat – Customer Web Client (Embedded Messaging) chat
+ */
+
+export { CustomerWebClientChat } from "./components/CustomerWebClientChat";
+export type { CustomerWebClientChatProps } from "./types/chat";

package/dist/force-app/main/default/uiBundles/reactexternalapp/src/pages/TestChatPage.tsx

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import CustomerWebClientChat from "../components/CustomerWebClientChat";
+
+export default function TestChatPage() {
+	return (
+		<div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12">
+			<div className="text-center">
+				<h1 className="text-4xl font-bold text-gray-900 mb-4">Chat</h1>
+				<p className="text-lg text-gray-600 mb-8">
+					Welcome to your Customer Web Client chat application.
+				</p>
+			</div>
+			<CustomerWebClientChat
+				orgId="<ORG_ID_15_OR_18_CHAR_00D...>"
+				deploymentName="<EMBEDDED_SERVICE_DEPLOYMENT_NAME>"
+				siteURL="<SITE_URL>"
+				scrt2URL="<SCRT2_URL>"
+			/>
+		</div>
+	);
+}

package/dist/force-app/main/default/uiBundles/reactexternalapp/src/routes.tsx

@@ -9,6 +9,7 @@ import Profile from "./features/authentication/pages/Profile";
 import ChangePassword from "./features/authentication/pages/ChangePassword";
 import PrivateRoute from "./features/authentication/layouts/privateRouteLayout";
 import { ROUTES } from "./features/authentication/authenticationConfig";
+import TestChatPage from "./pages/TestChatPage";
 import AuthAppLayout from "./features/authentication/layouts/AuthAppLayout";
 import AccountSearch from "./pages/AccountSearch";
 import AccountObjectDetail from "./pages/AccountObjectDetailPage";
@@ -58,6 +59,11 @@ export const routes: RouteObject[] = [
           }
         ]
       },
+      {
+        path: "test-chat",
+        element: <TestChatPage />,
+        handle: { showInNavigation: true, label: "Test Chat" }
+      },
       {
         path: "accounts/:recordId",
         element: <AccountObjectDetail />

package/dist/force-app/main/default/uiBundles/reactexternalapp/src/types/chat.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/** Shape of the Embedded Messaging bootstrap global injected by the site's bootstrap.js. */
+export interface WindowWithCwcProperties extends Window {
+	embeddedservice_bootstrap?: {
+		settings: {
+			language: string;
+			devMode?: boolean;
+		};
+		init: (
+			orgId: string,
+			deploymentName: string,
+			siteURL: string,
+			options: { scrt2URL: string },
+		) => void;
+	};
+}
+
+export interface CustomerWebClientChatProps {
+	/** The organization id (15- or 18-char Salesforce id starting with `00D`). */
+	orgId: string;
+	/** The Embedded Service deployment / channel name the agent is connected to. */
+	deploymentName: string;
+	/** The ESW site URL. Usually contains `ESW` and the deployment name. */
+	siteURL: string;
+	/** The SCRT2 (Service Cloud Real-Time) chat service URL. Usually contains `scrt`. */
+	scrt2URL: string;
+	/** Optional chat language. Defaults to `"en"`. */
+	language?: string;
+	/** Optional. Enables Embedded Messaging dev mode. Defaults to `false`. */
+	devMode?: boolean;
+}

package/dist/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@salesforce/ui-bundle-template-base-sfdx-project",
-  "version": "11.51.0",
+  "version": "11.52.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/ui-bundle-template-base-sfdx-project",
-      "version": "11.51.0",
+      "version": "11.52.0",
       "license": "SEE LICENSE IN LICENSE.txt",
       "dependencies": {
         "fast-xml-parser": "^5.9.3",

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/ui-bundle-template-base-sfdx-project",
-  "version": "11.51.0",
+  "version": "11.52.0",
   "description": "Base SFDX project template",
   "license": "SEE LICENSE IN LICENSE.txt",
   "publishConfig": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/ui-bundle-template-app-react-template-b2x",
-  "version": "11.51.0",
+  "version": "11.52.0",
   "description": "Salesforce React external app template",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "",