@salesforce/templates 66.13.9 → 66.15.0

package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/pages/AccountObjectDetailPage.tsx

@@ -1,4 +1,4 @@
-import { useState } from "react";
+import { useEffect, useState } from "react";
 import { useParams, useNavigate } from "react-router";
 import { createDataSDK } from "@salesforce/platform-sdk";
 import { AlertCircle, ChevronDown, ChevronRight, FileQuestion } from "lucide-react";
@@ -6,7 +6,7 @@ import GET_ACCOUNT_DETAIL from "../api/account/query/getAccountDetail.graphql?ra
 import { Alert, AlertTitle, AlertDescription } from "../components/ui/alert";
 import { Button } from "../components/ui/button";
 import { Card, CardContent } from "../components/ui/card";
-import { fieldValue, getAddressFieldLines, formatDateTimeField } from "../utils/accountFields";
+import { fieldValue, getAddressFieldLines } from "../utils/accountFields";
 import {
 	Collapsible,
 	CollapsibleTrigger,
@@ -15,13 +15,8 @@ import {
 import { Separator } from "../components/ui/separator";
 import { Skeleton } from "../components/ui/skeleton";
 import { useAsyncData } from "../hooks/useAsyncData";
-import { ObjectBreadcrumb } from "../components/ObjectBreadcrumb";
 
-/**
- * A uiapi scalar field as returned with `@optional { value displayValue }`.
- * Typed locally so this page no longer depends on the generated
- * `graphql-operations-types` that shipped with feature-react-object-search.
- */
+/** A uiapi scalar field as returned with `@optional { value displayValue }`. Typed locally to avoid a generated-types dependency. */
 type FieldValue = { value?: unknown; displayValue?: string | null } | null;
 type NameHolder = { Name?: FieldValue } | null;
 
@@ -88,23 +83,20 @@ export default function AccountObjectDetail() {
 		error,
 	} = useAsyncData(() => fetchAccountDetail(recordId!), [recordId]);
 
-	return (
-		<div className="max-w-6xl mx-auto px-4 sm:px-6 lg:px-8 py-6">
-			<ObjectBreadcrumb
-				listPath="/accounts"
-				listLabel="Accounts"
-				loading={loading}
-				recordName={
-					account
-						? (fieldValue(account.Name) ?? "")
-						: error
-							? "Error"
-							: loading
-								? undefined
-								: "Not Found"
-				}
-			/>
+	const pageTitle = loading
+		? "Loading Account | MyApp"
+		: error
+			? "Error | MyApp"
+			: account
+				? `${fieldValue(account.Name) ?? "Account"} | MyApp`
+				: "Account Not Found | MyApp";
+
+	useEffect(() => {
+		document.title = pageTitle;
+	}, [pageTitle]);
 
+	return (
+		<main className="max-w-6xl mx-auto px-4 sm:px-6 lg:px-8 py-6">
 			{/* Loading state */}
 			{loading && <AccountDetailSkeleton />}
 
@@ -115,8 +107,8 @@ export default function AccountObjectDetail() {
 			{!loading && !error && !account && <AccountDetailNotFound onBack={() => navigate(-1)} />}
 
 			{/* Content */}
-			{account && <AccountDetailContent account={account} />}
-		</div>
+			{!loading && !error && account && <AccountDetailContent account={account} />}
+		</main>
 	);
 }
 
@@ -137,17 +129,8 @@ function AccountDetailContent({ account }: { account: AccountNode }) {
 		country: fieldValue(account.ShippingCountry),
 	});
 
-	const dateTimeOptions = { dateStyle: "medium", timeStyle: "short" } as const;
-	const createdDate = formatDateTimeField(
-		fieldValue(account.CreatedDate),
-		undefined,
-		dateTimeOptions,
-	);
-	const lastModifiedDate = formatDateTimeField(
-		fieldValue(account.LastModifiedDate),
-		undefined,
-		dateTimeOptions,
-	);
+	const createdDate = fieldValue(account.CreatedDate);
+	const lastModifiedDate = fieldValue(account.LastModifiedDate);
 
 	return (
 		<>
@@ -258,10 +241,16 @@ function Section({ title, children }: { title: string; children: React.ReactNode
 	const [open, setOpen] = useState(true);
 	return (
 		<Collapsible open={open} onOpenChange={setOpen}>
-			<CollapsibleTrigger className="flex items-center gap-2 cursor-pointer text-lg font-semibold py-2">
-				{open ? <ChevronDown className="size-5" /> : <ChevronRight className="size-5" />}
-				{title}
-			</CollapsibleTrigger>
+			<h2>
+				<CollapsibleTrigger className="flex items-center gap-2 cursor-pointer text-lg font-semibold py-2">
+					{open ? (
+						<ChevronDown aria-hidden="true" className="size-5" />
+					) : (
+						<ChevronRight aria-hidden="true" className="size-5" />
+					)}
+					{title}
+				</CollapsibleTrigger>
+			</h2>
 			<CollapsibleContent>
 				<div className="mt-2 space-y-4">{children}</div>
 			</CollapsibleContent>
@@ -273,9 +262,9 @@ function AccountDetailError({ onBack }: { onBack: () => void }) {
 	return (
 		<>
 			<Alert variant="destructive" role="alert">
-				<AlertCircle />
+				<AlertCircle aria-hidden="true" />
 				<AlertTitle>
-					<h2>Failed to load account</h2>
+					<h1>Failed to load account</h1>
 				</AlertTitle>
 				<AlertDescription>
 					Something went wrong while loading this account. Please try again later.
@@ -283,7 +272,7 @@ function AccountDetailError({ onBack }: { onBack: () => void }) {
 			</Alert>
 			<div className="mt-4 flex gap-3">
 				<Button variant="outline" onClick={onBack}>
-					← Back
+					<span aria-hidden="true">←</span> Back
 				</Button>
 				<Button variant="outline" onClick={() => window.location.reload()}>
 					Retry
@@ -295,15 +284,15 @@ function AccountDetailError({ onBack }: { onBack: () => void }) {
 
 function AccountDetailNotFound({ onBack }: { onBack: () => void }) {
 	return (
-		<Card>
+		<Card role="status">
 			<CardContent className="flex flex-col items-center justify-center py-16 text-center">
-				<FileQuestion className="size-12 text-muted-foreground mb-4" />
-				<h2 className="text-lg font-semibold mb-1">Account not found</h2>
+				<FileQuestion aria-hidden="true" className="size-12 text-muted-foreground mb-4" />
+				<h1 className="text-lg font-semibold mb-1">Account not found</h1>
 				<p className="text-sm text-muted-foreground mb-6">
 					The account you're looking for doesn't exist or may have been deleted.
 				</p>
 				<Button variant="outline" onClick={onBack}>
-					← Go back
+					<span aria-hidden="true">←</span> Go back
 				</Button>
 			</CardContent>
 		</Card>
@@ -312,7 +301,8 @@ function AccountDetailNotFound({ onBack }: { onBack: () => void }) {
 
 function AccountDetailSkeleton() {
 	return (
-		<>
+		<div role="status" aria-live="polite">
+			<span className="sr-only">Loading account…</span>
 			<Skeleton className="h-8 w-56 mb-4" />
 
 			<Card>
@@ -361,7 +351,7 @@ function AccountDetailSkeleton() {
 					</div>
 				</CardContent>
 			</Card>
-		</>
+		</div>
 	);
 }
 

package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/pages/Home.tsx

@@ -1,10 +1,15 @@
+import { useEffect } from "react";
 import { GlobalSearchBox } from "../features/search";
 
 export default function HomePage() {
+	useEffect(() => {
+		document.title = "Home | MyApp";
+	}, []);
+
 	return (
-		<div className="max-w-2xl mx-auto px-4 sm:px-6 lg:px-8 py-12">
+		<main className="max-w-2xl mx-auto px-4 sm:px-6 lg:px-8 py-12">
 			<h1 className="text-2xl font-bold mb-6">Home</h1>
 			<GlobalSearchBox placeholder="Search accounts, contacts, opportunities..." />
-		</div>
+		</main>
 	);
 }

package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/utils/accountFields.ts

@@ -1,8 +1,4 @@
-/**
- * Field helpers for reading uiapi GraphQL response nodes on the Account
- * detail page. Previously imported from feature-react-object-search; inlined
- * here so the app no longer depends on that feature.
- */
+/** Field helpers for reading uiapi GraphQL response nodes: values arrive as `{ value, displayValue }` objects, so callers need one place to unwrap them. */
 
 /** Picks the user-facing string for a `{ value, displayValue }` field. */
 export function fieldValue(
@@ -27,12 +23,3 @@ export function getAddressFieldLines(address: {
 	if (lines.length === 0) return null;
 	return lines;
 }
-
-/** Formats an ISO datetime string with `toLocaleString`, or null if absent. */
-export function formatDateTimeField(
-	value?: string | null,
-	...args: Parameters<Date["toLocaleString"]>
-) {
-	if (!value) return null;
-	return new Date(value).toLocaleString(...args);
-}

package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/app.tsx","./src/appLayout.tsx","./src/index.ts","./src/navigationMenu.tsx","./src/router-utils.tsx","./src/routes.tsx","./src/api/graphqlClient.ts","./src/components/AgentforceConversationClient.tsx","./src/components/ObjectBreadcrumb.tsx","./src/components/__inherit_AgentforceConversationClient.tsx","./src/components/alerts/status-alert.tsx","./src/components/layouts/card-layout.tsx","./src/components/ui/alert.tsx","./src/components/ui/avatar.tsx","./src/components/ui/badge.tsx","./src/components/ui/breadcrumb.tsx","./src/components/ui/button.tsx","./src/components/ui/calendar.tsx","./src/components/ui/card.tsx","./src/components/ui/checkbox.tsx","./src/components/ui/collapsible.tsx","./src/components/ui/datePicker.tsx","./src/components/ui/dialog.tsx","./src/components/ui/dropdown-menu.tsx","./src/components/ui/field.tsx","./src/components/ui/index.ts","./src/components/ui/input.tsx","./src/components/ui/label.tsx","./src/components/ui/pagination.tsx","./src/components/ui/popover.tsx","./src/components/ui/select.tsx","./src/components/ui/separator.tsx","./src/components/ui/skeleton.tsx","./src/components/ui/sonner.tsx","./src/components/ui/spinner.tsx","./src/components/ui/table.tsx","./src/components/ui/tabs.tsx","./src/features/search/constants.ts","./src/features/search/index.ts","./src/features/search/loadConfig.ts","./src/features/search/queryBuilder.ts","./src/features/search/types.ts","./src/features/search/__tests__/queryBuilder.test.ts","./src/features/search/adapters/registry.ts","./src/features/search/adapters/types.ts","./src/features/search/adapters/cms/channelResolver.ts","./src/features/search/adapters/cms/cmsQueryFragment.ts","./src/features/search/adapters/cms/contentTypeSessionCache.ts","./src/features/search/adapters/cms/contentTypeUtils.ts","./src/features/search/adapters/cms/index.ts","./src/features/search/adapters/cms/parseResponse.ts","./src/features/search/adapters/cms/searchChannel.ts","./src/features/search/adapters/cms/types.ts","./src/features/search/adapters/cms/__tests__/channelResolver.test.ts","./src/features/search/adapters/cms/__tests__/cmsQueryFragment.test.ts","./src/features/search/adapters/cms/__tests__/contentTypeSessionCache.test.ts","./src/features/search/adapters/cms/__tests__/contentTypeUtils.test.ts","./src/features/search/adapters/cms/__tests__/orgApiVersionService.test.ts","./src/features/search/adapters/cms/__tests__/parseResponse.test.ts","./src/features/search/adapters/cms/__tests__/searchChannel.test.ts","./src/features/search/adapters/cms/__tests__/searchableContentTypesService.test.ts","./src/features/search/adapters/cms/api/apiUtils.ts","./src/features/search/adapters/cms/api/orgApiVersionService.ts","./src/features/search/adapters/cms/api/searchableContentTypesService.ts","./src/features/search/adapters/cms/hooks/useSearchableContentTypes.ts","./src/features/search/adapters/sobject/index.ts","./src/features/search/adapters/sobject/parseResponse.ts","./src/features/search/adapters/sobject/queryFragment.ts","./src/features/search/api/distinctValuesService.ts","./src/features/search/api/searchService.ts","./src/features/search/api/__tests__/searchService.test.ts","./src/features/search/components/GlobalSearchBox.tsx","./src/features/search/components/MergedSearchResults.tsx","./src/features/search/components/Search.tsx","./src/features/search/components/SearchResults.tsx","./src/features/search/components/SourceSection.tsx","./src/features/search/components/__tests__/Search.test.tsx","./src/features/search/components/controls/PaginationControls.tsx","./src/features/search/components/controls/ScopeSelector.tsx","./src/features/search/components/controls/SearchBar.tsx","./src/features/search/components/controls/SortControl.tsx","./src/features/search/components/filters/ActiveFilters.tsx","./src/features/search/components/filters/DefaultFilterPanel.tsx","./src/features/search/components/filters/FilterContext.tsx","./src/features/search/components/filters/inputs/BooleanFilter.tsx","./src/features/search/components/filters/inputs/DateRangeFilter.tsx","./src/features/search/components/filters/inputs/FilterFieldWrapper.tsx","./src/features/search/components/filters/inputs/MultiSelectFilter.tsx","./src/features/search/components/filters/inputs/NumericRangeFilter.tsx","./src/features/search/components/filters/inputs/SelectFilter.tsx","./src/features/search/components/filters/inputs/TextFilter.tsx","./src/features/search/components/results/CmsResultRow.tsx","./src/features/search/components/results/DefaultResultRow.tsx","./src/features/search/components/results/resolveResultRenderer.ts","./src/features/search/components/results/__tests__/CmsResultRow.test.tsx","./src/features/search/components/results/__tests__/resolveResultRenderer.test.ts","./src/features/search/hooks/useAsyncData.ts","./src/features/search/hooks/useDistinctValues.ts","./src/features/search/hooks/useSearch.ts","./src/features/search/utils/debounce.ts","./src/features/search/utils/fieldUtils.ts","./src/features/search/utils/filterUtils.ts","./src/features/search/utils/sortUtils.ts","./src/hooks/useAsyncData.ts","./src/lib/utils.ts","./src/pages/AccountObjectDetailPage.tsx","./src/pages/Home.tsx","./src/pages/NotFound.tsx","./src/types/conversation.ts","./src/types/globals.d.ts","./src/utils/accountFields.ts","./e2e/app.spec.ts","./vite-env.d.ts","./vitest-env.d.ts","./vitest.setup.ts","../../../../../../../../../sdk/platform-sdk/types/env.d.ts"],"version":"5.9.3"}
+{"root":["./src/app.tsx","./src/appLayout.tsx","./src/index.ts","./src/navigationMenu.tsx","./src/router-utils.tsx","./src/routes.tsx","./src/api/graphqlClient.ts","./src/components/AgentforceConversationClient.tsx","./src/components/ObjectBreadcrumb.tsx","./src/components/__inherit_AgentforceConversationClient.tsx","./src/components/alerts/status-alert.tsx","./src/components/layouts/card-layout.tsx","./src/components/ui/alert.tsx","./src/components/ui/avatar.tsx","./src/components/ui/badge.tsx","./src/components/ui/breadcrumb.tsx","./src/components/ui/button.tsx","./src/components/ui/calendar.tsx","./src/components/ui/card.tsx","./src/components/ui/checkbox.tsx","./src/components/ui/collapsible.tsx","./src/components/ui/datePicker.tsx","./src/components/ui/dialog.tsx","./src/components/ui/dropdown-menu.tsx","./src/components/ui/field.tsx","./src/components/ui/index.ts","./src/components/ui/input.tsx","./src/components/ui/label.tsx","./src/components/ui/pagination.tsx","./src/components/ui/popover.tsx","./src/components/ui/select.tsx","./src/components/ui/separator.tsx","./src/components/ui/skeleton.tsx","./src/components/ui/sonner.tsx","./src/components/ui/spinner.tsx","./src/components/ui/table.tsx","./src/components/ui/tabs.tsx","./src/features/search/constants.ts","./src/features/search/index.ts","./src/features/search/loadConfig.ts","./src/features/search/queryBuilder.ts","./src/features/search/types.ts","./src/features/search/__tests__/queryBuilder.test.ts","./src/features/search/adapters/registry.ts","./src/features/search/adapters/types.ts","./src/features/search/adapters/cms/channelResolver.ts","./src/features/search/adapters/cms/cmsQueryFragment.ts","./src/features/search/adapters/cms/contentTypeSessionCache.ts","./src/features/search/adapters/cms/contentTypeUtils.ts","./src/features/search/adapters/cms/index.ts","./src/features/search/adapters/cms/parseResponse.ts","./src/features/search/adapters/cms/searchChannel.ts","./src/features/search/adapters/cms/types.ts","./src/features/search/adapters/cms/__tests__/channelResolver.test.ts","./src/features/search/adapters/cms/__tests__/cmsQueryFragment.test.ts","./src/features/search/adapters/cms/__tests__/contentTypeSessionCache.test.ts","./src/features/search/adapters/cms/__tests__/contentTypeUtils.test.ts","./src/features/search/adapters/cms/__tests__/orgApiVersionService.test.ts","./src/features/search/adapters/cms/__tests__/parseResponse.test.ts","./src/features/search/adapters/cms/__tests__/searchChannel.test.ts","./src/features/search/adapters/cms/__tests__/searchableContentTypesService.test.ts","./src/features/search/adapters/cms/api/apiUtils.ts","./src/features/search/adapters/cms/api/orgApiVersionService.ts","./src/features/search/adapters/cms/api/searchableContentTypesService.ts","./src/features/search/adapters/cms/hooks/useSearchableContentTypes.ts","./src/features/search/adapters/sobject/index.ts","./src/features/search/adapters/sobject/parseResponse.ts","./src/features/search/adapters/sobject/queryFragment.ts","./src/features/search/api/distinctValuesService.ts","./src/features/search/api/searchService.ts","./src/features/search/api/__tests__/searchService.test.ts","./src/features/search/components/GlobalSearchBox.tsx","./src/features/search/components/MergedSearchResults.tsx","./src/features/search/components/Search.tsx","./src/features/search/components/SearchResults.tsx","./src/features/search/components/SourceSection.tsx","./src/features/search/components/__tests__/MergedSearchResults.test.tsx","./src/features/search/components/__tests__/Search.test.tsx","./src/features/search/components/__tests__/SourceSection.test.tsx","./src/features/search/components/controls/PaginationControls.tsx","./src/features/search/components/controls/ScopeSelector.tsx","./src/features/search/components/controls/SearchBar.tsx","./src/features/search/components/controls/SortControl.tsx","./src/features/search/components/filters/ActiveFilters.tsx","./src/features/search/components/filters/DefaultFilterPanel.tsx","./src/features/search/components/filters/FilterContext.tsx","./src/features/search/components/filters/inputs/BooleanFilter.tsx","./src/features/search/components/filters/inputs/DateRangeFilter.tsx","./src/features/search/components/filters/inputs/FilterFieldWrapper.tsx","./src/features/search/components/filters/inputs/MultiSelectFilter.tsx","./src/features/search/components/filters/inputs/NumericRangeFilter.tsx","./src/features/search/components/filters/inputs/SelectFilter.tsx","./src/features/search/components/filters/inputs/TextFilter.tsx","./src/features/search/components/results/CmsResultRow.tsx","./src/features/search/components/results/DefaultResultRow.tsx","./src/features/search/components/results/resolveResultRenderer.ts","./src/features/search/components/results/__tests__/CmsResultRow.test.tsx","./src/features/search/components/results/__tests__/resolveResultRenderer.test.ts","./src/features/search/hooks/useAsyncData.ts","./src/features/search/hooks/useDistinctValues.ts","./src/features/search/hooks/useSearch.ts","./src/features/search/utils/debounce.ts","./src/features/search/utils/fieldUtils.ts","./src/features/search/utils/filterUtils.ts","./src/features/search/utils/sortUtils.ts","./src/features/search/utils/__tests__/filterUtils.test.ts","./src/hooks/useAsyncData.ts","./src/lib/utils.ts","./src/pages/AccountObjectDetailPage.tsx","./src/pages/Home.tsx","./src/pages/NotFound.tsx","./src/types/conversation.ts","./src/types/globals.d.ts","./src/utils/accountFields.ts","./src/utils/__tests__/accountFields.test.ts","./e2e/app.spec.ts","./vite-env.d.ts","./vitest-env.d.ts","./vitest.setup.ts","../../../../../../../../../sdk/platform-sdk/types/env.d.ts"],"version":"5.9.3"}

package/lib/templates/project/reactinternalapp/package.json

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

package/lib/templates/project/reactinternalapp/scripts/org-setup-config-schema.mjs

@@ -72,13 +72,25 @@ export const ConfigSchema = z
         // Required because React (Site Container) sites hide SSO config in Admin UI.
         authProviderNames: z.array(z.string().min(1)).min(1),
         // Permission set to assign to community users created via SSO.
-        // Required because getCurrentUser() calls /chatter/users/me which needs
-        // API access (PermissionsApiEnabled) that the community profile lacks.
+        // Required because getCurrentUser() calls UI API GraphQL (uiapi.currentUser)
+        // which needs API access (PermissionsApiEnabled) that the community profile lacks.
         // Typically the app's "*_Guest_User_Api_Access" permset.
         communityUserPermset: z.string().min(1).optional(),
       })
       .strict()
       .optional(),
+    // URL members are redirected to after logging out, written to the site's
+    // <logoutUrl> network metadata (a post-deploy step). Steers logout back to THIS
+    // site so members aren't dropped on the org default-site login (which, in an
+    // org hosting multiple sites, can be a different community). Prefer a
+    // site-relative path (e.g. "/myapp/"): it is domain-independent, so the same
+    // shipped value is valid on every org. The platform REQUIRES an absolute logout
+    // URL, so org-setup resolves a relative path against the site's Experience Cloud
+    // origin (discovered from the org at deploy time) before writing it; an
+    // already-absolute value is used as-is. Kept a permissive non-empty string (not
+    // z.string().url()) so relative paths are valid; character-safety for raw XML
+    // interpolation is enforced at write time.
+    logoutUrl: z.string().min(1).optional(),
   })
   .strict();
 

package/lib/templates/project/reactinternalapp/scripts/org-setup-dev.mjs

@@ -60,6 +60,31 @@ Options:
   return { targetOrg, uiBundleName };
 }
 
+/**
+ * Print a heads-up about auth surfaces that only work on the deployed Experience
+ * site. In local preview, `sdk.fetch` is proxied to the org outside the site's
+ * guest/community context, so social login and password/MFA login cannot be
+ * exercised on localhost. This mirrors the "Local preview limitations" sections
+ * in the feature-react-authentication / feature-react-mfa READMEs — surfaced here
+ * so it is seen even when the READMEs are not.
+ */
+function printLocalPreviewWarning() {
+  console.log(
+    [
+      '',
+      '⚠️  Local preview limitation — some auth surfaces only work on the DEPLOYED site',
+      '   Local preview proxies sdk.fetch to the org outside the Experience site guest',
+      '   context (Site.getBaseUrl() is blank, no site session), so on localhost:',
+      '     • Social Login buttons do not render (/auth/social-login-config returns no providers)',
+      '     • Password / MFA login fails with "Your login attempt has failed…" (Site.login() cannot',
+      '       establish the site session)',
+      '   This is expected, not a misconfiguration. Test social login and MFA on the published',
+      '   site login page: https://<domain>.site.com/<site-path>/login',
+      '',
+    ].join('\n'),
+  );
+}
+
 async function main() {
   const parsed = parseArgs();
 
@@ -76,6 +101,8 @@ async function main() {
   });
   run('GraphQL codegen', 'npm', ['run', 'graphql:codegen'], { cwd: uiBundleDir });
 
+  printLocalPreviewWarning();
+
   console.log('\n--- Launching dev server (Ctrl+C to stop) ---\n');
   const devResult = run('Dev server', 'npm', ['run', 'dev'], { cwd: uiBundleDir, optional: true });
   process.exit(devResult.status ?? 0);

package/lib/templates/project/reactinternalapp/scripts/org-setup-url.mjs

@@ -0,0 +1,108 @@
+/**
+ * Pure URL helpers for org-setup.mjs logout-URL productization.
+ *
+ * The platform requires an ABSOLUTE logout URL on Network metadata — a relative
+ * value is rejected at deploy time ("The logout page URL must be an absolute
+ * URL."). Apps ship a domain-INDEPENDENT, site-relative path in
+ * org-setup.config.json (so the same value is valid on every org the app deploys
+ * to); these helpers resolve it to an absolute URL at deploy time, against the
+ * site's Experience Cloud origin discovered from the target org's communities.
+ *
+ * Pure (no fs / no process / no network): org-setup.mjs fetches the community list
+ * (Connect API) and owns the fail modes; these helpers only classify + resolve
+ * strings, so they carry automated coverage in the consuming test package
+ * (org-setup-tests/test/org-setup-url.spec.ts). Companion to org-setup-xml.mjs.
+ */
+
+/** True when `value` is an absolute http(s) URL — already deployable as-is. */
+export function isAbsoluteLogoutUrl(value) {
+  return /^https?:\/\//i.test(String(value).trim());
+}
+
+/**
+ * Leading path segment of a URL or path:
+ *   "/propertyrentalapp/"                         -> "propertyrentalapp"
+ *   "https://h.site.com/propertyrentalapp"        -> "propertyrentalapp"
+ *   "/"                                           -> ""
+ */
+export function firstPathSegment(pathOrUrl) {
+  let pathname;
+  try {
+    pathname = new URL(pathOrUrl).pathname; // absolute URL
+  } catch {
+    pathname = String(pathOrUrl).split(/[?#]/)[0]; // relative path
+  }
+  return pathname.replace(/^\/+/, '').split('/')[0];
+}
+
+/**
+ * Choose the Experience Cloud community whose site URL should anchor a relative
+ * logout path, and return its siteUrl (or null when none matches).
+ *
+ * Matches on the community's siteUrl PATH first — robust even when a community's
+ * `urlPathPrefix` differs from its public path (e.g. a React "site container" site
+ * whose companion ChatterNetwork carries a "…vforcesite" prefix), and correct on
+ * custom domains where each site can have its own origin. Falls back to a
+ * community whose `name` equals the derived site name. Does NOT fall back to an
+ * arbitrary community: resolving against the wrong origin would silently produce a
+ * valid-but-wrong absolute URL, so an unmatched relative path is left for the
+ * caller to surface loudly.
+ *
+ * @param {Array<{name?: string, siteUrl?: string}>} communities
+ * @param {string} configLogoutUrl  the site-relative path being resolved
+ * @param {string} [siteName]
+ * @returns {string|null} the matched community siteUrl
+ */
+export function pickCommunityBaseUrl(communities, configLogoutUrl, siteName) {
+  const list = Array.isArray(communities) ? communities.filter((c) => c && c.siteUrl) : [];
+  const seg = firstPathSegment(configLogoutUrl);
+
+  if (seg) {
+    const byPath = list.find((c) => firstPathSegment(c.siteUrl) === seg);
+    if (byPath) return byPath.siteUrl;
+  }
+  if (siteName) {
+    const byName = list.find((c) => c.name === siteName);
+    if (byName) return byName.siteUrl;
+  }
+  return null;
+}
+
+/**
+ * Resolve a shipped logout-URL config value to an absolute URL.
+ *   - already absolute      -> returned unchanged (trimmed).
+ *   - site-relative path     -> resolved against `baseUrl` (a community siteUrl).
+ *     Because the config path is root-relative ("/app/"), only baseUrl's ORIGIN is
+ *     used, so any siteUrl on the same Experience Cloud domain yields the same
+ *     result.
+ *
+ * Throws when a relative value has no baseUrl to resolve against, or when
+ * resolution fails to produce an absolute http(s) URL.
+ *
+ * @param {string} configLogoutUrl
+ * @param {string|null} baseUrl
+ * @returns {string} an absolute URL
+ */
+export function resolveLogoutUrl(configLogoutUrl, baseUrl) {
+  const value = String(configLogoutUrl).trim();
+  if (isAbsoluteLogoutUrl(value)) return value;
+
+  if (!baseUrl) {
+    throw new Error(
+      `logout URL "${configLogoutUrl}" is site-relative but no Experience Cloud ` +
+        `community site URL was found to resolve it into an absolute URL`,
+    );
+  }
+  let resolved;
+  try {
+    resolved = new URL(value, baseUrl).href;
+  } catch (e) {
+    throw new Error(
+      `could not resolve logout URL "${configLogoutUrl}" against "${baseUrl}": ${e.message}`,
+    );
+  }
+  if (!isAbsoluteLogoutUrl(resolved)) {
+    throw new Error(`resolved logout URL "${resolved}" is not an absolute http(s) URL`);
+  }
+  return resolved;
+}

package/lib/templates/project/reactinternalapp/scripts/org-setup-xml.mjs

@@ -180,3 +180,99 @@ export function enableSelfRegInXml(xml, selfRegProfile) {
   );
   return { xml: updated, changed: true };
 }
+
+/**
+ * Indentation of the first indented child element, so an inserted node matches
+ * the file's own formatting — byte-faithful on 2-space and 4-space files alike.
+ * Falls back to 4 spaces when the document has no indented child to sample.
+ */
+function firstChildIndent(xml) {
+  const m = xml.match(/\n([ \t]+)</);
+  return m ? m[1] : '    ';
+}
+
+/**
+ * Assert a logout URL is safe to interpolate into the network metadata as-is.
+ *
+ * Mirrors assertSafeProfileName: the value is developer-authored config, so a
+ * character that would need XML entity-escaping (& < > " ') signals a mistake to
+ * surface loudly rather than silently rewrite. A logout landing URL is a site
+ * home path/URL and legitimately needs none of these. Throws NetworkXmlError
+ * (mapped by callers to their fail mode) otherwise.
+ */
+export function assertSafeLogoutUrl(url) {
+  const s = String(url);
+  if (XML_SPECIAL_CHARS.test(s)) {
+    throw new NetworkXmlError(
+      `logoutUrl "${url}" contains an XML-special character (& < > " '); ` +
+        `use a URL without these characters in org-setup.config.json`,
+    );
+  }
+  return s;
+}
+
+/**
+ * Set <logoutUrl> so members land on THIS site after logging out, instead of the
+ * org's default-site logout — which, in an org hosting multiple Experience Cloud
+ * sites, can drop a member on a different community's login page.
+ *
+ * `url` MUST already be an absolute URL: the platform rejects a relative value at
+ * deploy time ("The logout page URL must be an absolute URL."). A shipped
+ * site-relative config path is resolved to an absolute URL before this is called
+ * (see org-setup-url.mjs, driven by ensureLogoutUrl in org-setup.mjs).
+ *
+ * Asserts this is a Network document (throws NetworkXmlError otherwise). Returns
+ * `{ xml, changed }`:
+ *   - `changed: false` (input returned unchanged) when <logoutUrl> already equals
+ *     `url` — a configured re-run is a true byte-for-byte no-op.
+ *   - present-but-different: the value is replaced in place (position preserved).
+ *   - absent: a <logoutUrl> node is inserted in the CANONICAL position the Metadata
+ *     API emits. Network's top-level elements serialize in alphabetical order, so
+ *     the node is placed immediately before the first existing sibling that sorts
+ *     after "logoutUrl" (or as the last child, before </Network>, when none does).
+ *     Inserting where a later retrieve would place it keeps this org-deployed file
+ *     free of reorder churn. The node adopts the file's own indentation and every
+ *     untouched region is preserved byte-for-byte.
+ *
+ * Assumes an existing <logoutUrl> is a paired, non-empty node (the shipped sparse
+ * network omits it entirely; a deployed org carries a paired value) — the case
+ * this productizes.
+ */
+export function setLogoutUrl(xml, url) {
+  const network = parseNetwork(xml);
+  // Reject XML-special characters rather than escaping them (see
+  // assertSafeLogoutUrl) before interpolating raw.
+  const safeUrl = assertSafeLogoutUrl(url);
+  const current = 'logoutUrl' in network ? String(network.logoutUrl) : null;
+  if (current === safeUrl) {
+    return { xml, changed: false };
+  }
+  const node = `<logoutUrl>${safeUrl}</logoutUrl>`;
+  // Present-but-different — replace the value in place (preserves position).
+  if (/<logoutUrl>[^<]*<\/logoutUrl>/.test(xml)) {
+    return { xml: xml.replace(/<logoutUrl>[^<]*<\/logoutUrl>/, node), changed: true };
+  }
+  // Absent — insert in alphabetical order among the Network's top-level children to
+  // match the canonical Metadata API serialization. parseNetwork's keys are the
+  // direct child element names; drop fast-xml-parser's attribute (@_*) and text
+  // (#*) pseudo-keys.
+  const siblings = Object.keys(network).filter((k) => !k.startsWith('@_') && !k.startsWith('#'));
+  // The first sibling that sorts AFTER "logoutUrl" — the node goes just before it.
+  const successor = siblings.filter((name) => name > 'logoutUrl').sort()[0];
+  if (successor) {
+    const beforeSuccessor = new RegExp(`(\\n[ \\t]*)(<${successor}\\b)`);
+    if (beforeSuccessor.test(xml)) {
+      // Reuse the successor's own leading whitespace so the node adopts its indent.
+      return { xml: xml.replace(beforeSuccessor, `$1${node}$1$2`), changed: true };
+    }
+  }
+  // No later-sorting sibling (or its tag wasn't found) — insert as the last child,
+  // right before </Network>, at the file's own indent.
+  const indent = firstChildIndent(xml);
+  const beforeClose = /(\n)([ \t]*<\/Network>)/;
+  if (beforeClose.test(xml)) {
+    return { xml: xml.replace(beforeClose, `\n${indent}${node}$1$2`), changed: true };
+  }
+  // Degenerate single-line / rootless form — fall back to just after the open tag.
+  return { xml: xml.replace(/(<Network\b[^>]*>)/, `$1\n${indent}${node}`), changed: true };
+}