@salesforce/templates 66.5.5 → 66.6.0

package/lib/templates/project/reactb2x/_p_/_m_/_w_/_a_/src/_f_/_gs_/_c_/search/SearchResultsPanel.tsx

@@ -1,197 +0,0 @@
-/**
- * SearchResultsPanel Component
- *
- * Displays the search results panel with loading, error, and empty states.
- * Renders a list of SearchResultCard components and pagination controls.
- *
- * @param columns - Array of column definitions for displaying result data
- * @param results - Array of search result records to display
- * @param columnsLoading - Whether column metadata is currently loading
- * @param resultsLoading - Whether search results are currently loading
- * @param columnsError - Error message if column fetch failed
- * @param resultsError - Error message if results fetch failed
- * @param currentPageToken - Current pagination token
- * @param pageSize - Number of results per page
- * @param onPageChange - Callback when pagination changes; second arg optional: "next" | "prev" | "first" (cursor-stack pagination)
- * @param onPageSizeChange - Callback when page size changes
- *
- * @example
- * ```tsx
- * <SearchResultsPanel
- *   columns={columns}
- *   results={results}
- *   columnsLoading={false}
- *   resultsLoading={false}
- *   columnsError={null}
- *   resultsError={null}
- *   currentPageToken="0"
- *   pageSize={25}
- *   onPageChange={(token, direction) => handlePageChange(token, direction)}
- *   onPageSizeChange={(size) => setPageSize(size)}
- * />
- * ```
- */
-import { useMemo } from "react";
-import { Alert, AlertDescription, AlertTitle } from "../../../../components/ui/alert";
-import { Skeleton } from "../../../../components/ui/skeleton";
-import { AlertCircle } from "lucide-react";
-import {
-	Select,
-	SelectContent,
-	SelectItem,
-	SelectTrigger,
-	SelectValue,
-} from "../../../../components/ui/select";
-import { Label } from "../../../../components/ui/label";
-import SearchResultCard from "./SearchResultCard";
-import SearchPagination from "./SearchPagination";
-import type { Column, SearchResultRecord } from "../../types/search/searchResults";
-import { getSafeKey } from "../../utils/recordUtils";
-
-interface SearchResultsPanelProps {
-	/** API name of the object being searched (e.g. for detail page navigation). */
-	objectApiName?: string;
-	columns: Column[];
-	results: SearchResultRecord[];
-	columnsLoading: boolean;
-	resultsLoading: boolean;
-	columnsError: string | null;
-	resultsError: string | null;
-	currentPageToken: string;
-	nextPageToken: string | null;
-	previousPageToken: string | null;
-	hasNextPage?: boolean;
-	hasPreviousPage?: boolean;
-	pageSize: number;
-	sortBy: string;
-	onPageChange: (newPageToken: string, direction?: "next" | "prev" | "first") => void;
-	onPageSizeChange: (newPageSize: number) => void;
-	onSortByChange: (newSortBy: string) => void;
-}
-
-export default function SearchResultsPanel({
-	objectApiName,
-	columns,
-	results,
-	columnsLoading,
-	resultsLoading,
-	columnsError,
-	resultsError,
-	currentPageToken,
-	nextPageToken,
-	previousPageToken,
-	hasNextPage = false,
-	hasPreviousPage = false,
-	pageSize,
-	sortBy,
-	onPageChange,
-	onPageSizeChange,
-	onSortByChange,
-}: SearchResultsPanelProps) {
-	const sortableColumns = useMemo(() => columns.filter(({ sortable }) => sortable), [columns]);
-
-	const validResults = useMemo(
-		() => results.filter((record) => record && record.record && record.record.id),
-		[results],
-	);
-	if (columnsError || resultsError) {
-		return (
-			<Alert variant="destructive" role="alert">
-				<AlertCircle className="h-4 w-4" aria-hidden="true" />
-				<AlertTitle>Error</AlertTitle>
-				<AlertDescription>
-					{columnsError || resultsError || "Failed to load search results"}
-				</AlertDescription>
-			</Alert>
-		);
-	}
-
-	if (resultsLoading || columnsLoading) {
-		return (
-			<div
-				className="space-y-4"
-				role="status"
-				aria-live="polite"
-				aria-label="Loading search results"
-			>
-				<span className="sr-only">Loading search results</span>
-				{[1, 2, 3].map((i) => (
-					<div key={i} className="border rounded-lg p-6" aria-hidden="true">
-						<Skeleton className="h-6 w-3/4 mb-4" />
-						<Skeleton className="h-4 w-full mb-2" />
-						<Skeleton className="h-4 w-2/3" />
-					</div>
-				))}
-			</div>
-		);
-	}
-
-	if (results.length === 0) {
-		return (
-			<div className="text-center py-12" role="status" aria-live="polite">
-				<p className="text-lg mb-2">No results found</p>
-				<p className="text-sm">Try adjusting your search query or filters</p>
-			</div>
-		);
-	}
-
-	return (
-		<>
-			{sortableColumns.length > 0 && (
-				<div
-					className="mb-6 flex items-center gap-2 justify-end"
-					role="group"
-					aria-label="Sort options"
-				>
-					<Label htmlFor="sort-by-select" className="text-sm font-normal whitespace-nowrap">
-						Sort by:
-					</Label>
-					<Select value={sortBy || ""} onValueChange={onSortByChange}>
-						<SelectTrigger
-							id="sort-by-select"
-							className="w-[200px]"
-							aria-label="Sort search results by field"
-						>
-							<SelectValue placeholder="Select field..." />
-						</SelectTrigger>
-						<SelectContent>
-							<SelectItem value="relevance">Relevance</SelectItem>
-							{sortableColumns.map((column) => (
-								<SelectItem key={column.fieldApiName} value={column.fieldApiName}>
-									{column.label}
-								</SelectItem>
-							))}
-						</SelectContent>
-					</Select>
-				</div>
-			)}
-
-			<div className="space-y-4 mb-6" role="list" aria-label="Search results list">
-				{validResults.map((record, index) => {
-					const recordId = record.record.id;
-					const safeKey = getSafeKey(recordId, index);
-					return (
-						<div key={safeKey} role="listitem">
-							<SearchResultCard
-								record={record.record}
-								columns={columns}
-								objectApiName={objectApiName}
-							/>
-						</div>
-					);
-				})}
-			</div>
-
-			<SearchPagination
-				currentPageToken={currentPageToken}
-				nextPageToken={nextPageToken}
-				previousPageToken={previousPageToken}
-				hasNextPage={hasNextPage}
-				hasPreviousPage={hasPreviousPage}
-				pageSize={pageSize}
-				onPageChange={onPageChange}
-				onPageSizeChange={onPageSizeChange}
-			/>
-		</>
-	);
-}

package/lib/templates/project/reactb2x/_p_/_m_/_w_/_a_/src/_f_/_gs_/_c_/shared/LoadingFallback.tsx

@@ -1,61 +0,0 @@
-/**
- * LoadingFallback Component
- *
- * Loading fallback component for Suspense boundaries.
- * Displays a centered spinner while lazy-loaded components are being fetched.
- *
- * @remarks
- * - Used with React Suspense for code splitting
- * - Simple centered spinner design
- * - Responsive and accessible
- *
- * @example
- * ```tsx
- * <Suspense fallback={<LoadingFallback />}>
- *   <LazyComponent />
- * </Suspense>
- * ```
- */
-import { cva, type VariantProps } from "class-variance-authority";
-import { Spinner } from "../../../../components/ui/spinner";
-
-/**
- * Spinner size variants based on content width.
- */
-const spinnerVariants = cva("", {
-	variants: {
-		contentMaxWidth: {
-			sm: "size-6",
-			md: "size-8",
-			lg: "size-10",
-		},
-	},
-	defaultVariants: {
-		contentMaxWidth: "sm",
-	},
-});
-
-interface LoadingFallbackProps extends VariantProps<typeof spinnerVariants> {
-	/**
-	 * Maximum width of the content container. Also scales the spinner size.
-	 * @default "sm"
-	 */
-	contentMaxWidth?: "sm" | "md" | "lg";
-	/**
-	 * Accessible label for screen readers.
-	 * @default "Loading…"
-	 */
-	loadingText?: string;
-}
-
-export default function LoadingFallback({
-	contentMaxWidth = "sm",
-	loadingText = "Loading…",
-}: LoadingFallbackProps) {
-	return (
-		<div className="flex justify-center" role="status" aria-live="polite">
-			<Spinner className={spinnerVariants({ contentMaxWidth })} aria-hidden="true" />
-			<span className="sr-only">{loadingText}</span>
-		</div>
-	);
-}

package/lib/templates/project/reactb2x/_p_/_m_/_w_/_a_/src/_f_/_gs_/api/objectDetailService.ts

@@ -1,102 +0,0 @@
-/**
- * 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 "./objectInfoService";
-import type { ObjectInfoResult } from "../types/objectInfo/objectInfo";
-import { getRecordByIdGraphQL, type GraphQLRecordNode } from "./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;
-}
-
-export async function getLayout(
-	objectApiName: string,
-	recordTypeId: string = DEFAULT_RECORD_TYPE_ID,
-): Promise<LayoutResponse> {
-	const params = new URLSearchParams({
-		layoutType: "Full",
-		mode: "View",
-		recordTypeId,
-	});
-	return fetchAndValidate(
-		() => uiApiClient.get(`/layout/${safeEncodePath(objectApiName)}?${params.toString()}`),
-		{
-			schema: LayoutResponseSchema,
-			errorContext: `layout for ${objectApiName}`,
-		},
-	);
-}
-
-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,
-	}));
-}
-
-export async function getRecordDetail(
-	objectApiName: string,
-	recordId: string,
-	recordTypeId: string = DEFAULT_RECORD_TYPE_ID,
-): Promise<RecordDetailResult> {
-	const layout = await getLayout(objectApiName, recordTypeId);
-	const objectMetadata = await objectInfoService.getObjectInfoBatch(objectApiName);
-	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/lib/templates/project/reactb2x/_p_/_m_/_w_/_a_/src/_f_/_gs_/api/objectInfoGraphQLService.ts

@@ -1,137 +0,0 @@
-/**
- * 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, gql } from "@salesforce/sdk-data";
-import type {
-	GetObjectInfosQuery,
-	GetObjectInfosQueryVariables,
-	GetPicklistValuesQuery,
-	GetPicklistValuesQueryVariables,
-	ObjectInfoInput,
-} from "../types/schema";
-
-/**
- * Builds objectInfos query (metadata only). Uses apiNames only — do not pass objectInfoInputs.
- */
-const OBJECT_INFOS_QUERY = gql`
-	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.
- * Optimized to only fetch fields used by extractPicklistValuesFromGraphQLObjectInfo.
- */
-const PICKLIST_VALUES_QUERY = gql`
-	query GetPicklistValues($objectInfoInputs: [ObjectInfoInput!]!) {
-		uiapi {
-			objectInfos(objectInfoInputs: $objectInfoInputs) {
-				ApiName
-				fields {
-					ApiName
-					... on PicklistField {
-						picklistValuesByRecordTypeIDs {
-							recordTypeID
-							defaultValue {
-								value
-							}
-							picklistValues {
-								label
-								value
-								validFor
-							}
-						}
-					}
-				}
-			}
-		}
-	}
-`;
-
-export async function queryForObjectInfos(apiNames: string[]): Promise<GetObjectInfosQuery> {
-	return runQuery<GetObjectInfosQuery, GetObjectInfosQueryVariables>(OBJECT_INFOS_QUERY, {
-		apiNames,
-	});
-}
-
-export async function queryForPicklistValues(
-	objectInfoInputs: ObjectInfoInput[],
-): Promise<GetPicklistValuesQuery> {
-	return runQuery<GetPicklistValuesQuery, GetPicklistValuesQueryVariables>(PICKLIST_VALUES_QUERY, {
-		objectInfoInputs,
-	});
-}
-
-async function runQuery<Q, V>(query: string, variables: V): Promise<Q> {
-	const data = await getDataSDK();
-	const response = await data.graphql?.<Q, V>(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 Q);
-}

package/lib/templates/project/reactb2x/_p_/_m_/_w_/_a_/src/_f_/_gs_/api/objectInfoService.ts

@@ -1,95 +0,0 @@
-import { uiApiClient } from "@salesforce/webapp-experimental/api";
-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 { queryForObjectInfos, queryForPicklistValues } from "./objectInfoGraphQLService";
-import {
-	graphQLObjectInfosToBatchResponse,
-	extractPicklistValuesFromGraphQLObjectInfo,
-} from "../utils/graphQLObjectInfoAdapter";
-
-/**
- * Object info and search service.
- *
- * - getObjectInfoBatch / getPicklistValues: GraphQL (objectInfoGraphQLService).
- * - getObjectListFilters: REST (search-info).
- * 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>>();
-
-export async function getObjectInfoBatch(objectApiNames: string): 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 queryForObjectInfos(names);
-			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;
-}
-
-export async function getObjectListFilters(objectApiName: string): Promise<Filter[]> {
-	return fetchAndValidate(
-		() => uiApiClient.get(`/search-info/${safeEncodePath(objectApiName)}/filters`),
-		{
-			schema: FilterArraySchema,
-			errorContext: `filters for ${objectApiName}`,
-			extractData: (data: unknown) => {
-				if (!data) return [];
-				return Array.isArray(data) ? data : (data as { filters?: unknown }).filters || [];
-			},
-		},
-	);
-}
-
-export async function getPicklistValues(
-	objectApiName: string,
-	fieldName: string,
-	recordTypeId: string = "012000000000000AAA",
-): Promise<PicklistValue[]> {
-	const response = await queryForPicklistValues([
-		{ apiName: objectApiName, fieldNames: [fieldName] },
-	]);
-	const nodes = response?.uiapi?.objectInfos ?? [];
-	const node = nodes[0];
-	if (!node) return [];
-	return extractPicklistValuesFromGraphQLObjectInfo(node, fieldName, recordTypeId);
-}
-
-export const objectInfoService = {
-	getObjectInfoBatch,
-	getObjectListFilters,
-	getPicklistValues,
-};