@salesforce/webapp-template-app-react-template-b2x-experimental 1.59.2 → 1.60.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.
 
+# [1.60.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.59.2...v1.60.0) (2026-02-27)
+
+**Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
+
+
+
+
+
 ## [1.59.2](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.59.1...v1.59.2) (2026-02-27)
 
 **Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/package-lock.json

@@ -6071,19 +6071,19 @@
       }
     },
     "node_modules/@salesforce/sdk-core": {
-      "version": "1.59.1",
-      "resolved": "https://registry.npmjs.org/@salesforce/sdk-core/-/sdk-core-1.59.1.tgz",
-      "integrity": "sha512-trEn+yi+2s/2Mf172a0m0gFPsISMyqJKYq8R5/VSoH3VWPGW7WOHmSzYJhhj8/JVNb52iOMg5TXMjgd5aTi+3g==",
+      "version": "1.59.2",
+      "resolved": "https://registry.npmjs.org/@salesforce/sdk-core/-/sdk-core-1.59.2.tgz",
+      "integrity": "sha512-s/7yAygrhMIoedsOm6/9af1Hu6W6Hnfm9E+RBMJ/wwTS8CXJ/Tuqrqod6FTawULqiTJbFhmeeQCjcf8q1pcKZg==",
       "license": "SEE LICENSE IN LICENSE.txt"
     },
     "node_modules/@salesforce/sdk-data": {
-      "version": "1.59.1",
-      "resolved": "https://registry.npmjs.org/@salesforce/sdk-data/-/sdk-data-1.59.1.tgz",
-      "integrity": "sha512-5/GEjazn115maQFHjGvbS56hDIJyR1+LezROpPkrDs1AvrtGqWoJgIYWol+98hrAM7F/Ukx1B5q/kl0ToEsbGQ==",
+      "version": "1.59.2",
+      "resolved": "https://registry.npmjs.org/@salesforce/sdk-data/-/sdk-data-1.59.2.tgz",
+      "integrity": "sha512-3jltn3XRYqHMTfY/X6T5vUY5NVGPAjfzM6+irLr+ih0eYWPsuO3d3iexd6ovgtQZ9Qmnl9ljG9TGoh+dappDFA==",
       "license": "SEE LICENSE IN LICENSE.txt",
       "dependencies": {
         "@conduit-client/salesforce-lightning-service-worker": "^3.7.0",
-        "@salesforce/sdk-core": "^1.59.1"
+        "@salesforce/sdk-core": "^1.59.2"
       }
     },
     "node_modules/@salesforce/ts-types": {
@@ -6096,15 +6096,15 @@
       }
     },
     "node_modules/@salesforce/vite-plugin-webapp-experimental": {
-      "version": "1.59.1",
-      "resolved": "https://registry.npmjs.org/@salesforce/vite-plugin-webapp-experimental/-/vite-plugin-webapp-experimental-1.59.1.tgz",
-      "integrity": "sha512-WuiEIH9WEUwCOs/KsF2bEqYdh4rBSO9Mvt3vKjK5nyM9q2bEJdSjJBonYY7889qMFWW1i+OpN4pKcf1TU6v87w==",
+      "version": "1.59.2",
+      "resolved": "https://registry.npmjs.org/@salesforce/vite-plugin-webapp-experimental/-/vite-plugin-webapp-experimental-1.59.2.tgz",
+      "integrity": "sha512-xRngJFgVlPXcBoImpdPH8+rObCk4r4nH8jkVHP85pcooBAhqRVIl0nYusuQSL+L1jlbfLptPOBBjtTkuouwanQ==",
       "dev": true,
       "license": "SEE LICENSE IN LICENSE.txt",
       "dependencies": {
         "@babel/core": "^7.28.4",
         "@babel/helper-plugin-utils": "^7.28.3",
-        "@salesforce/webapp-experimental": "^1.59.1"
+        "@salesforce/webapp-experimental": "^1.59.2"
       },
       "engines": {
         "node": ">=20.0.0"
@@ -6114,13 +6114,13 @@
       }
     },
     "node_modules/@salesforce/webapp-experimental": {
-      "version": "1.59.1",
-      "resolved": "https://registry.npmjs.org/@salesforce/webapp-experimental/-/webapp-experimental-1.59.1.tgz",
-      "integrity": "sha512-8xWICuXa9XIa+v1svKOzh655lcYmtTuvUGEsMecfxbC+nXWZx36JdJ55pjEwOCuWMcHtdaE4nEsXXIZF+SkAbg==",
+      "version": "1.59.2",
+      "resolved": "https://registry.npmjs.org/@salesforce/webapp-experimental/-/webapp-experimental-1.59.2.tgz",
+      "integrity": "sha512-TOZEI7pQV+j3VE/o5V5UkKUoOo7JRXI1i4C5VmxSHcSUVUd/GSzQYZptf9704Vxbjjsw9uZSM7tPOHTWYfVD9g==",
       "license": "SEE LICENSE IN LICENSE.txt",
       "dependencies": {
         "@salesforce/core": "^8.23.4",
-        "@salesforce/sdk-data": "^1.59.1",
+        "@salesforce/sdk-data": "^1.59.2",
         "axios": "^1.7.7",
         "micromatch": "^4.0.8",
         "path-to-regexp": "^8.3.0"

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/api/index.ts

@@ -0,0 +1,19 @@
+/**
+ * API layer: object metadata (GraphQL), layout + record detail (REST layout + GraphQL record), record list/single (GraphQL).
+ */
+export { objectInfoService } from "./objectInfoService";
+export { objectDetailService, extractFieldsFromLayout } from "./objectDetailService";
+export type { RecordDetailResult } from "./objectDetailService";
+export {
+	getRecordsGraphQL,
+	getRecordByIdGraphQL,
+	buildGetRecordsQuery,
+	buildWhereFromCriteria,
+	buildOrderByFromSort,
+} from "./recordListGraphQLService";
+export type {
+	RecordListGraphQLResult,
+	RecordListGraphQLVariables,
+	RecordListGraphQLOptions,
+	GraphQLRecordNode,
+} from "./recordListGraphQLService";

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/api/objectDetailService.ts

@@ -0,0 +1,125 @@
+/**
+ * Record detail service: layout (REST), object metadata (GraphQL), single record (GraphQL).
+ *
+ * getRecordDetail orchestrates layout + objectInfoBatch + getRecordByIdGraphQL for the detail page.
+ * Layout is still REST (uiApiClient); record and object info are GraphQL-backed.
+ *
+ * @module api/objectDetailService
+ */
+
+import { uiApiClient } from "@salesforce/webapp-experimental/api";
+import type { LayoutResponse } from "../types/recordDetail/recordDetail";
+import { LayoutResponseSchema } from "../types/recordDetail/recordDetail";
+import { fetchAndValidate, safeEncodePath } from "../utils/apiUtils";
+import { objectInfoService } from "../api/objectInfoService";
+import type { ObjectInfoResult } from "../types/objectInfo/objectInfo";
+import { getRecordByIdGraphQL, type GraphQLRecordNode } from "../api/recordListGraphQLService";
+import type { Column } from "../types/search/searchResults";
+import { calculateFieldsToFetch } from "../utils/recordUtils";
+
+/** Fallback when record type is unknown. Prefer recordTypeId from the record (e.g. from search or record response) when available. */
+const DEFAULT_RECORD_TYPE_ID = "012000000000000AAA";
+
+/**
+ * Returns field API names to request for a record from the given layout and object metadata.
+ * Used to derive GraphQL columns from layout (detail view). Delegates to recordUtils.calculateFieldsToFetch.
+ *
+ * @param objectMetadata - Object info (fields, relationshipName, etc.).
+ * @param layout - Layout response (sections, layoutItems, layoutComponents).
+ * @returns Array of field API names (e.g. ["Name", "OwnerId", "Owner", "CreatedDate"]).
+ */
+export function extractFieldsFromLayout(
+	objectMetadata: ObjectInfoResult,
+	layout: LayoutResponse,
+): string[] {
+	const [optionalFields] = calculateFieldsToFetch(objectMetadata, layout, false);
+	return optionalFields;
+}
+
+/**
+ * Fetches the Full/View layout for an object (REST). Used by detail view to render sections/rows/items.
+ *
+ * @param objectApiName - Object API name.
+ * @param recordTypeId - Record type Id (default master).
+ * @param signal - Optional abort signal.
+ */
+export async function getLayout(
+	objectApiName: string,
+	recordTypeId: string = DEFAULT_RECORD_TYPE_ID,
+	signal?: AbortSignal,
+): Promise<LayoutResponse> {
+	const params = new URLSearchParams({
+		layoutType: "Full",
+		mode: "View",
+		recordTypeId,
+	});
+	return fetchAndValidate(
+		(abortSignal) =>
+			uiApiClient.get(`/layout/${safeEncodePath(objectApiName)}?${params.toString()}`, {
+				signal: abortSignal,
+			}),
+		{
+			schema: LayoutResponseSchema,
+			errorContext: `layout for ${objectApiName}`,
+			signal,
+		},
+	);
+}
+
+export interface RecordDetailResult {
+	layout: LayoutResponse;
+	record: GraphQLRecordNode;
+	objectMetadata: ObjectInfoResult;
+}
+
+/**
+ * Converts layout-derived optionalFields (field API names) to Column[] for GraphQL node selection.
+ * Uses unqualified names (no entity prefix) so the GraphQL query matches UI API shape.
+ * Other Column fields (label, searchable, sortable) are only required by the type; GraphQL selection uses fieldApiName only.
+ */
+function optionalFieldsToColumns(optionalFields: string[]): Column[] {
+	return optionalFields.map((fieldApiName) => ({
+		fieldApiName,
+		label: "",
+		searchable: false,
+		sortable: false,
+	}));
+}
+
+/**
+ * Fetches everything needed for the detail page: layout (REST), object metadata (GraphQL), single record (GraphQL).
+ * Layout drives which fields are requested; getRecordByIdGraphQL fetches that field set by Id.
+ *
+ * @param objectApiName - Object API name.
+ * @param recordId - Record Id.
+ * @param recordTypeId - Record type (default master).
+ * @param signal - Optional abort signal.
+ * @returns { layout, record, objectMetadata } for DetailForm / UiApiDetailForm.
+ */
+export async function getRecordDetail(
+	objectApiName: string,
+	recordId: string,
+	recordTypeId: string = DEFAULT_RECORD_TYPE_ID,
+	signal?: AbortSignal,
+): Promise<RecordDetailResult> {
+	const layout = await getLayout(objectApiName, recordTypeId, signal);
+	const objectMetadata = await objectInfoService.getObjectInfoBatch(objectApiName, signal);
+	const firstResult = objectMetadata?.results?.[0]?.result;
+	if (!firstResult) {
+		throw new Error(`Object metadata not found for ${objectApiName}`);
+	}
+	// Layout-driven optionalFields (fields shown on the detail layout), not list columns
+	const [optionalFields] = calculateFieldsToFetch(firstResult, layout, false);
+	const columns = optionalFieldsToColumns(optionalFields);
+	const record = await getRecordByIdGraphQL(objectApiName, recordId, columns);
+	if (!record) {
+		throw new Error(`Record not found: ${recordId}`);
+	}
+	return { layout, record, objectMetadata: firstResult };
+}
+
+export const objectDetailService = {
+	extractFieldsFromLayout,
+	getLayout,
+	getRecordDetail,
+};

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/api/objectInfoGraphQLService.ts

@@ -0,0 +1,194 @@
+/**
+ * Object metadata GraphQL service (uiapi.objectInfos).
+ *
+ * Single endpoint for object describe and picklist values. Used by objectInfoService
+ * to implement getObjectInfoBatch and getPicklistValues. Not used directly by UI.
+ *
+ * @module api/objectInfoGraphQLService
+ */
+
+import { getDataSDK } from "@salesforce/sdk-data";
+
+/** GraphQL objectInfoInputs for requesting picklist values (API v65.0+). Only apiName and fieldNames are sent; record type filtering is done from the response. */
+export interface ObjectInfoInput {
+	apiName: string;
+	fieldNames?: string[] | null;
+}
+
+/** Raw GraphQL response shape for uiapi.objectInfos (flexible for schema casing). */
+export interface ObjectInfosGraphQLResponse {
+	uiapi?: {
+		objectInfos?: Array<Record<string, unknown>>;
+	};
+}
+
+/**
+ * Builds objectInfos query (metadata only). Uses apiNames only — do not pass objectInfoInputs.
+ */
+function buildObjectInfosQuery(): string {
+	return `query GetObjectInfos($apiNames: [String!]!) {
+  uiapi {
+    objectInfos(apiNames: $apiNames) {
+      ApiName
+      label
+      labelPlural
+      nameFields
+      defaultRecordTypeId
+      keyPrefix
+      layoutable
+      queryable
+      searchable
+      updateable
+      deletable
+      createable
+      custom
+      mruEnabled
+      feedEnabled
+      fields {
+        ApiName
+        label
+        dataType
+        relationshipName
+        reference
+        compound
+        compoundFieldName
+        compoundComponentName
+        controllingFields
+        controllerName
+        referenceToInfos {
+          ApiName
+          nameFields
+        }
+      }
+      recordTypeInfos {
+        recordTypeId
+        name
+        master
+        available
+        defaultRecordTypeMapping
+      }
+      themeInfo {
+        color
+        iconUrl
+      }
+      childRelationships {
+        relationshipName
+        fieldName
+        childObjectApiName
+      }
+      dependentFields {
+        controllingField
+      }
+    }
+  }
+}`;
+}
+
+/**
+ * Builds objectInfos query with picklist values (API v65.0+).
+ * Schema requires objectInfos to be called with either apiNames or objectInfoInputs, not both.
+ * This query uses objectInfoInputs only.
+ */
+function buildObjectInfosWithPicklistsQuery(): string {
+	return `query GetPicklistValues($objectInfoInputs: [ObjectInfoInput!]!) {
+  uiapi {
+    objectInfos(objectInfoInputs: $objectInfoInputs) {
+      ApiName
+      label
+      labelPlural
+      nameFields
+      defaultRecordTypeId
+      keyPrefix
+      layoutable
+      queryable
+      searchable
+      updateable
+      deletable
+      createable
+      custom
+      mruEnabled
+      feedEnabled
+      fields {
+        ApiName
+        label
+        dataType
+        relationshipName
+        reference
+        compound
+        compoundFieldName
+        compoundComponentName
+        controllingFields
+        controllerName
+        referenceToInfos {
+          ApiName
+          nameFields
+        }
+        ... on PicklistField {
+          picklistValuesByRecordTypeIDs {
+            recordTypeID
+            defaultValue {
+              value
+            }
+            picklistValues {
+              label
+              value
+              validFor
+            }
+          }
+        }
+      }
+      recordTypeInfos {
+        recordTypeId
+        name
+        master
+        available
+        defaultRecordTypeMapping
+      }
+      themeInfo {
+        color
+        iconUrl
+      }
+      childRelationships {
+        relationshipName
+        fieldName
+        childObjectApiName
+      }
+      dependentFields {
+        controllingField
+      }
+    }
+  }
+}`;
+}
+
+/**
+ * Fetches object metadata for the given objects via GraphQL.
+ *
+ * @param apiNames - Object API names (e.g. ["Account", "Contact"]).
+ * @param options.objectInfoInputs - When set, picklist values for specified fields are included (API v65.0+).
+ * @param options.signal - Optional abort signal.
+ * @returns Raw uiapi.objectInfos response (adapt to REST shape via graphQLObjectInfosToBatchResponse).
+ */
+export async function getObjectInfosGraphQL(
+	apiNames: string[],
+	options?: {
+		objectInfoInputs?: ObjectInfoInput[] | null;
+		signal?: AbortSignal;
+	},
+): Promise<ObjectInfosGraphQLResponse> {
+	const names = apiNames.length ? apiNames : [];
+	const hasInputs = options?.objectInfoInputs != null && options.objectInfoInputs.length > 0;
+	const query = hasInputs ? buildObjectInfosWithPicklistsQuery() : buildObjectInfosQuery();
+	const variables: Record<string, unknown> = hasInputs
+		? { objectInfoInputs: options!.objectInfoInputs }
+		: { apiNames: names };
+	const data = await getDataSDK();
+	const response = await data.graphql?.<ObjectInfosGraphQLResponse>(query, variables);
+
+	if (response?.errors?.length) {
+		const errorMessages = response.errors.map((e) => e.message).join("; ");
+		throw new Error(`GraphQL Error: ${errorMessages}`);
+	}
+
+	return response?.data ?? ({} as ObjectInfosGraphQLResponse);
+}

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/api/objectInfoService.ts

@@ -0,0 +1,199 @@
+import { uiApiClient } from "@salesforce/webapp-experimental/api";
+import { z } from "zod";
+import type { SearchResultsResponse, KeywordSearchResult } from "../types/search/searchResults";
+import { SearchResultsResponseSchema } from "../types/search/searchResults";
+import { FilterCriteriaArraySchema } from "../types/filters/filters";
+import type { Filter } from "../types/filters/filters";
+import { FilterArraySchema } from "../types/filters/filters";
+import type { PicklistValue } from "../types/filters/picklist";
+import type { ObjectInfoBatchResponse } from "../types/objectInfo/objectInfo";
+import { fetchAndValidate, safeEncodePath } from "../utils/apiUtils";
+import { getObjectInfosGraphQL } from "./objectInfoGraphQLService";
+import {
+	graphQLObjectInfosToBatchResponse,
+	extractPicklistValuesFromGraphQLObjectInfo,
+} from "../utils/graphQLObjectInfoAdapter";
+
+/**
+ * Object info and search service.
+ *
+ * - getObjectInfoBatch / getPicklistValues: GraphQL (objectInfoGraphQLService).
+ * - getObjectListFilters, searchResults: REST (search-info, search/results).
+ * Hooks use this service; components do not call it directly.
+ *
+ * @module api/objectInfoService
+ */
+
+/** Cache key: sorted, comma-joined object API names. */
+function getObjectInfoBatchCacheKey(objectApiNames: string): string {
+	const names = objectApiNames
+		.split(",")
+		.map((s) => s.trim())
+		.filter(Boolean);
+	return [...names].sort().join(",");
+}
+
+const objectInfoBatchCache = new Map<string, ObjectInfoBatchResponse>();
+const objectInfoBatchInFlight = new Map<string, Promise<ObjectInfoBatchResponse>>();
+
+/**
+ * Fetches batch object information for the specified objects via GraphQL (uiapi.objectInfos).
+ * Results are cached by object set so List, Home, and Detail views share one request.
+ *
+ * @param objectApiNames - Comma-separated list of object API names (e.g., "Account,AccountBrand")
+ * @param signal - Optional AbortSignal to cancel the request
+ * @returns Promise resolving to the object info batch response (REST-compatible shape)
+ */
+export async function getObjectInfoBatch(
+	objectApiNames: string,
+	signal?: AbortSignal,
+): Promise<ObjectInfoBatchResponse> {
+	const names = objectApiNames
+		.split(",")
+		.map((s) => s.trim())
+		.filter(Boolean);
+	if (names.length === 0) {
+		return { results: [] };
+	}
+	const key = getObjectInfoBatchCacheKey(objectApiNames);
+	const cached = objectInfoBatchCache.get(key);
+	if (cached) return Promise.resolve(cached);
+	const inFlight = objectInfoBatchInFlight.get(key);
+	if (inFlight) return inFlight;
+	const promise = (async () => {
+		try {
+			const response = await getObjectInfosGraphQL(names, { signal });
+			const nodes = response?.uiapi?.objectInfos ?? [];
+			const result = graphQLObjectInfosToBatchResponse(nodes, names);
+			objectInfoBatchCache.set(key, result);
+			return result;
+		} finally {
+			objectInfoBatchInFlight.delete(key);
+		}
+	})();
+	objectInfoBatchInFlight.set(key, promise);
+	return promise;
+}
+
+/**
+ * Fetches list filters for a specific object.
+ * Salesforce Search supports "Search Filters" (refinements) which are configured per object.
+ * This API returns the available filters (e.g., "Close Date", "Stage") that the user
+ * can use to narrow down the search results.
+ * @param objectApiName - The API name of the object (e.g., "Account")
+ * @param signal - Optional AbortSignal to cancel the request
+ * @returns Promise resolving to the search filters array
+ */
+export async function getObjectListFilters(
+	objectApiName: string,
+	signal?: AbortSignal,
+): Promise<Filter[]> {
+	return fetchAndValidate(
+		(abortSignal) =>
+			uiApiClient.get(`/search-info/${safeEncodePath(objectApiName)}/filters`, {
+				signal: abortSignal,
+			}),
+		{
+			schema: FilterArraySchema,
+			errorContext: `filters for ${objectApiName}`,
+			extractData: (data: unknown) => {
+				if (!data) return [];
+				return Array.isArray(data) ? data : (data as { filters?: unknown }).filters || [];
+			},
+			signal,
+		},
+	);
+}
+
+/**
+ * Fetches picklist values for a specific field via GraphQL (uiapi.objectInfos with objectInfoInputs).
+ *
+ * @param objectApiName - The API name of the object (e.g., "Account")
+ * @param fieldName - The API name of the field (e.g., "Type")
+ * @param recordTypeId - Optional record type ID (defaults to "012000000000000AAA" which is the default/master record type)
+ * @param signal - Optional AbortSignal to cancel the request
+ * @returns Promise resolving to an array of picklist values
+ */
+export async function getPicklistValues(
+	objectApiName: string,
+	fieldName: string,
+	recordTypeId: string = "012000000000000AAA",
+	signal?: AbortSignal,
+): Promise<PicklistValue[]> {
+	const response = await getObjectInfosGraphQL([objectApiName], {
+		objectInfoInputs: [
+			{
+				apiName: objectApiName,
+				fieldNames: [fieldName],
+			},
+		],
+		signal,
+	});
+	const nodes = response?.uiapi?.objectInfos ?? [];
+	const node = nodes[0];
+	if (!node) return [];
+	return extractPicklistValuesFromGraphQLObjectInfo(node, fieldName, recordTypeId);
+}
+
+// Zod Schema for Search Parameters
+const SearchParamsSchema = z.object({
+	filters: FilterCriteriaArraySchema.optional(),
+	pageSize: z.number().optional(),
+	pageToken: z.string().optional(),
+	sortBy: z.string().optional(),
+});
+
+/**
+ * Search parameters for keyword search
+ */
+export type SearchParams = z.infer<typeof SearchParamsSchema>;
+
+/**
+ * Performs a keyword search on a specific object.
+ * Returns records that match the text query along with pagination information.
+ *
+ * @param query - The search query string
+ * @param objectApiName - The API name of the object to search (e.g., "Account")
+ * @param params - Optional search parameters (pageSize, pageToken, filters, sortBy)
+ * @param signal - Optional AbortSignal to cancel the request
+ * @returns Promise resolving to the keyword search result with records and pagination tokens
+ */
+export async function searchResults(
+	query: string,
+	objectApiName: string,
+	params?: SearchParams,
+	signal?: AbortSignal,
+): Promise<KeywordSearchResult> {
+	const searchParams = new URLSearchParams({
+		q: query,
+		objectApiName: objectApiName,
+	});
+
+	const body = {
+		filters: params?.filters ?? [],
+		pageSize: params?.pageSize ?? 50,
+		pageToken: params?.pageToken ?? "0",
+		sortBy: params?.sortBy ?? "",
+	};
+
+	const response = await fetchAndValidate<SearchResultsResponse>(
+		(abortSignal) =>
+			uiApiClient.post(`/search/results/keyword?${searchParams.toString()}`, body, {
+				signal: abortSignal,
+			}),
+		{
+			schema: SearchResultsResponseSchema,
+			errorContext: `search results for ${objectApiName} with query "${query}"`,
+			signal,
+		},
+	);
+
+	return response.keywordSearchResult;
+}
+
+export const objectInfoService = {
+	getObjectInfoBatch,
+	getObjectListFilters,
+	getPicklistValues,
+	searchResults,
+};