@salesforce/ui-bundle-template-feature-react-agentforce-conversation-client 11.50.0 → 11.51.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.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
+
+
+
+
+
 ## [11.50.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v11.49.4...v11.50.0) (2026-08-07)
 
 **Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project

package/dist/force-app/main/default/uiBundles/feature-react-agentforce-conversation-client/package.json

@@ -18,8 +18,8 @@
     "graphql:schema": "node scripts/get-graphql-schema.mjs"
   },
   "dependencies": {
-    "@salesforce/platform-sdk": "^11.50.0",
-    "@salesforce/ui-bundle": "^11.50.0",
+    "@salesforce/platform-sdk": "^11.51.0",
+    "@salesforce/ui-bundle": "^11.51.0",
     "@tailwindcss/vite": "^4.1.17",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -45,8 +45,8 @@
     "@graphql-eslint/eslint-plugin": "^4.1.0",
     "@graphql-tools/utils": "^11.0.0",
     "@playwright/test": "^1.49.0",
-    "@salesforce/graphiti": "^11.50.0",
-    "@salesforce/vite-plugin-ui-bundle": "^11.50.0",
+    "@salesforce/graphiti": "^11.51.0",
+    "@salesforce/vite-plugin-ui-bundle": "^11.51.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/feature-react-agentforce-conversation-client/src/components/AgentforceConversationClient.tsx

@@ -6,59 +6,21 @@
 
 import { embedAgentforceClient } from "@salesforce/agentforce-conversation-client";
 import type { AgentforceClientConfig } from "@salesforce/agentforce-conversation-client";
+import { createAccEmbedder } from "@salesforce/agentforce-conversation-client/ui-bundle";
 import { useEffect, useMemo, useRef } from "react";
-import type {
-	ResolvedEmbedOptions,
-	AgentforceConversationClientProps,
-} from "../types/conversation";
+import type { AgentforceConversationClientProps } from "../types/conversation";
 
-const GLOBAL_HOST_ID = "agentforce-conversation-client-global-host";
-const SINGLETON_KEY = "__agentforceConversationClientSingleton";
-
-interface AgentforceConversationClientSingleton {
-	initPromise?: Promise<void>;
-	initialized: boolean;
-}
-
-interface WindowWithAgentforceSingleton extends Window {
-	[SINGLETON_KEY]?: AgentforceConversationClientSingleton;
-}
-
-type GlobalWithSfdcEnv = typeof globalThis & {
-	SFDC_ENV?: {
-		orgUrl?: string;
-	};
-};
-
-function getSingleton(): AgentforceConversationClientSingleton {
-	const win = window as WindowWithAgentforceSingleton;
-	if (!win[SINGLETON_KEY]) {
-		win[SINGLETON_KEY] = {
-			initialized: false,
-		};
-	}
-	return win[SINGLETON_KEY]!;
-}
-
-function getOrCreateGlobalHost(): HTMLDivElement {
-	let host = document.getElementById(GLOBAL_HOST_ID) as HTMLDivElement | null;
-	if (!host) {
-		host = document.createElement("div");
-		host.id = GLOBAL_HOST_ID;
-		document.body.appendChild(host);
-	}
-	return host;
-}
-
-function getDefaultEmbedOptions(): ResolvedEmbedOptions {
-	const sfdcEnv = (globalThis as GlobalWithSfdcEnv).SFDC_ENV;
-	return { salesforceOrigin: sfdcEnv?.orgUrl };
-}
+// The embed orchestration (window singleton, global host, dev frontdoor fetch,
+// SFDC_ENV default, partial-embed cleanup) lives in the shared, framework-agnostic
+// @salesforce/agentforce-conversation-client/ui-bundle glue. We hand it the
+// low-level embed function via dependency injection.
+const embedder = createAccEmbedder<AgentforceClientConfig>(embedAgentforceClient);
 
 /**
  * React wrapper that embeds the Agentforce Conversation Client (copilot/agent UI)
  * using Lightning Out. Requires a valid Salesforce session for the given org.
- * Config is passed through from the consumer to the embed client as-is.
+ * Flat props are normalized into an `AgentforceClientConfig` and passed through
+ * to the shared embedder as-is.
  */
 export function AgentforceConversationClient({
 	agentId,
@@ -109,96 +71,18 @@ export function AgentforceConversationClient({
 	const inline = normalizedAgentforceClientConfig?.renderingConfig?.mode === "inline";
 
 	useEffect(() => {
-		if (!normalizedAgentforceClientConfig?.agentId) {
-			throw new Error(
-				"AgentforceConversationClient requires agentId. " +
-					"Pass flat props only (agentId, agentLabel, inline, headerEnabled, showHeaderIcon, width, height, styleTokens).",
-			);
-		}
-
-		const singleton = getSingleton();
-		if (singleton.initialized || singleton.initPromise) {
-			return;
-		}
-
-		if (inline && !containerRef.current) {
-			return;
-		}
-
-		const initialize = (options: ResolvedEmbedOptions) => {
-			if (singleton.initialized) {
-				return;
-			}
-			const existingEmbed = document.querySelector('lightning-out-application[data-lo="acc"]');
-			if (existingEmbed) {
-				singleton.initialized = true;
-				return;
-			}
-			const host = inline ? containerRef.current! : getOrCreateGlobalHost();
-
-			try {
-				embedAgentforceClient({
-					container: host,
-					salesforceOrigin: salesforceOrigin ?? options.salesforceOrigin,
-					frontdoorUrl: frontdoorUrl ?? options.frontdoorUrl,
-					agentforceClientConfig: normalizedAgentforceClientConfig,
-					onReady,
-					onError,
-				});
-				singleton.initialized = true;
-			} catch (err) {
-				// Strip a partially-created LO element so the next mount can retry.
-				const partialEmbed = document.querySelector('lightning-out-application[data-lo="acc"]');
-				partialEmbed?.remove();
-				console.error("AgentforceConversationClient: initialization failed", err);
-			}
-		};
-
-		const safeInitialize = (options: ResolvedEmbedOptions) => {
-			try {
-				initialize(options);
-			} catch (initErr) {
-				console.error("AgentforceConversationClient: initialization failed", initErr);
-				singleton.initialized = false;
-			}
-		};
-
-		const shouldFetchFrontdoor = window.location.hostname === "localhost";
-
-		if (shouldFetchFrontdoor) {
-			singleton.initPromise = fetch("/__lo/frontdoor")
-				.then(async (res) => {
-					if (!res.ok) {
-						console.error("frontdoor fetch failed");
-						return;
-					}
-					const { frontdoorUrl: resolvedFrontdoorUrl } = await res.json();
-					safeInitialize({ frontdoorUrl: resolvedFrontdoorUrl });
-				})
-				.catch((err) => {
-					console.error("AgentforceConversationClient: failed to fetch frontdoor URL", err);
-				})
-				.finally(() => {
-					singleton.initPromise = undefined;
-				});
-		} else {
-			singleton.initPromise = Promise.resolve()
-				.then(() => {
-					safeInitialize(getDefaultEmbedOptions());
-				})
-				.catch((err) => {
-					console.error("AgentforceConversationClient: failed to embed Agentforce client", err);
-				})
-				.finally(() => {
-					singleton.initPromise = undefined;
-				});
-		}
+		embedder.embedAcc(
+			normalizedAgentforceClientConfig,
+			{ salesforceOrigin, frontdoorUrl },
+			containerRef.current,
+			{ onReady, onError },
+		);
 
 		return () => {
 			// Intentionally no cleanup:
 			// This component guarantees a single LO initialization per window.
 		};
-	}, [salesforceOrigin, frontdoorUrl, normalizedAgentforceClientConfig, inline, onReady, onError]);
+	}, [salesforceOrigin, frontdoorUrl, normalizedAgentforceClientConfig, onReady, onError]);
 
 	if (!inline) {
 		return null;

package/dist/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@salesforce/ui-bundle-template-base-sfdx-project",
-  "version": "11.50.0",
+  "version": "11.51.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/ui-bundle-template-base-sfdx-project",
-      "version": "11.50.0",
+      "version": "11.51.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.50.0",
+  "version": "11.51.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-feature-react-agentforce-conversation-client",
-  "version": "11.50.0",
+  "version": "11.51.0",
   "description": "Embedded Agentforce conversation client feature for UI Bundles",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "",
@@ -26,7 +26,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@salesforce/agentforce-conversation-client": "^11.50.0"
+    "@salesforce/agentforce-conversation-client": "^11.51.0"
   },
   "devDependencies": {
     "@types/react": "^19.2.7",

package/src/force-app/main/default/uiBundles/feature-react-agentforce-conversation-client/src/components/AgentforceConversationClient.tsx

@@ -6,59 +6,21 @@
 
 import { embedAgentforceClient } from "@salesforce/agentforce-conversation-client";
 import type { AgentforceClientConfig } from "@salesforce/agentforce-conversation-client";
+import { createAccEmbedder } from "@salesforce/agentforce-conversation-client/ui-bundle";
 import { useEffect, useMemo, useRef } from "react";
-import type {
-	ResolvedEmbedOptions,
-	AgentforceConversationClientProps,
-} from "../types/conversation";
+import type { AgentforceConversationClientProps } from "../types/conversation";
 
-const GLOBAL_HOST_ID = "agentforce-conversation-client-global-host";
-const SINGLETON_KEY = "__agentforceConversationClientSingleton";
-
-interface AgentforceConversationClientSingleton {
-	initPromise?: Promise<void>;
-	initialized: boolean;
-}
-
-interface WindowWithAgentforceSingleton extends Window {
-	[SINGLETON_KEY]?: AgentforceConversationClientSingleton;
-}
-
-type GlobalWithSfdcEnv = typeof globalThis & {
-	SFDC_ENV?: {
-		orgUrl?: string;
-	};
-};
-
-function getSingleton(): AgentforceConversationClientSingleton {
-	const win = window as WindowWithAgentforceSingleton;
-	if (!win[SINGLETON_KEY]) {
-		win[SINGLETON_KEY] = {
-			initialized: false,
-		};
-	}
-	return win[SINGLETON_KEY]!;
-}
-
-function getOrCreateGlobalHost(): HTMLDivElement {
-	let host = document.getElementById(GLOBAL_HOST_ID) as HTMLDivElement | null;
-	if (!host) {
-		host = document.createElement("div");
-		host.id = GLOBAL_HOST_ID;
-		document.body.appendChild(host);
-	}
-	return host;
-}
-
-function getDefaultEmbedOptions(): ResolvedEmbedOptions {
-	const sfdcEnv = (globalThis as GlobalWithSfdcEnv).SFDC_ENV;
-	return { salesforceOrigin: sfdcEnv?.orgUrl };
-}
+// The embed orchestration (window singleton, global host, dev frontdoor fetch,
+// SFDC_ENV default, partial-embed cleanup) lives in the shared, framework-agnostic
+// @salesforce/agentforce-conversation-client/ui-bundle glue. We hand it the
+// low-level embed function via dependency injection.
+const embedder = createAccEmbedder<AgentforceClientConfig>(embedAgentforceClient);
 
 /**
  * React wrapper that embeds the Agentforce Conversation Client (copilot/agent UI)
  * using Lightning Out. Requires a valid Salesforce session for the given org.
- * Config is passed through from the consumer to the embed client as-is.
+ * Flat props are normalized into an `AgentforceClientConfig` and passed through
+ * to the shared embedder as-is.
  */
 export function AgentforceConversationClient({
 	agentId,
@@ -109,96 +71,18 @@ export function AgentforceConversationClient({
 	const inline = normalizedAgentforceClientConfig?.renderingConfig?.mode === "inline";
 
 	useEffect(() => {
-		if (!normalizedAgentforceClientConfig?.agentId) {
-			throw new Error(
-				"AgentforceConversationClient requires agentId. " +
-					"Pass flat props only (agentId, agentLabel, inline, headerEnabled, showHeaderIcon, width, height, styleTokens).",
-			);
-		}
-
-		const singleton = getSingleton();
-		if (singleton.initialized || singleton.initPromise) {
-			return;
-		}
-
-		if (inline && !containerRef.current) {
-			return;
-		}
-
-		const initialize = (options: ResolvedEmbedOptions) => {
-			if (singleton.initialized) {
-				return;
-			}
-			const existingEmbed = document.querySelector('lightning-out-application[data-lo="acc"]');
-			if (existingEmbed) {
-				singleton.initialized = true;
-				return;
-			}
-			const host = inline ? containerRef.current! : getOrCreateGlobalHost();
-
-			try {
-				embedAgentforceClient({
-					container: host,
-					salesforceOrigin: salesforceOrigin ?? options.salesforceOrigin,
-					frontdoorUrl: frontdoorUrl ?? options.frontdoorUrl,
-					agentforceClientConfig: normalizedAgentforceClientConfig,
-					onReady,
-					onError,
-				});
-				singleton.initialized = true;
-			} catch (err) {
-				// Strip a partially-created LO element so the next mount can retry.
-				const partialEmbed = document.querySelector('lightning-out-application[data-lo="acc"]');
-				partialEmbed?.remove();
-				console.error("AgentforceConversationClient: initialization failed", err);
-			}
-		};
-
-		const safeInitialize = (options: ResolvedEmbedOptions) => {
-			try {
-				initialize(options);
-			} catch (initErr) {
-				console.error("AgentforceConversationClient: initialization failed", initErr);
-				singleton.initialized = false;
-			}
-		};
-
-		const shouldFetchFrontdoor = window.location.hostname === "localhost";
-
-		if (shouldFetchFrontdoor) {
-			singleton.initPromise = fetch("/__lo/frontdoor")
-				.then(async (res) => {
-					if (!res.ok) {
-						console.error("frontdoor fetch failed");
-						return;
-					}
-					const { frontdoorUrl: resolvedFrontdoorUrl } = await res.json();
-					safeInitialize({ frontdoorUrl: resolvedFrontdoorUrl });
-				})
-				.catch((err) => {
-					console.error("AgentforceConversationClient: failed to fetch frontdoor URL", err);
-				})
-				.finally(() => {
-					singleton.initPromise = undefined;
-				});
-		} else {
-			singleton.initPromise = Promise.resolve()
-				.then(() => {
-					safeInitialize(getDefaultEmbedOptions());
-				})
-				.catch((err) => {
-					console.error("AgentforceConversationClient: failed to embed Agentforce client", err);
-				})
-				.finally(() => {
-					singleton.initPromise = undefined;
-				});
-		}
+		embedder.embedAcc(
+			normalizedAgentforceClientConfig,
+			{ salesforceOrigin, frontdoorUrl },
+			containerRef.current,
+			{ onReady, onError },
+		);
 
 		return () => {
 			// Intentionally no cleanup:
 			// This component guarantees a single LO initialization per window.
 		};
-	}, [salesforceOrigin, frontdoorUrl, normalizedAgentforceClientConfig, inline, onReady, onError]);
+	}, [salesforceOrigin, frontdoorUrl, normalizedAgentforceClientConfig, onReady, onError]);
 
 	if (!inline) {
 		return null;