@salesforce/templates 66.5.5 → 66.6.0

package/lib/templates/project/reactb2e/_p_/_m_/_w_/_a_/src/_f_/_gs_/utils/graphQLRecordAdapter.ts

@@ -1,90 +0,0 @@
-/**
- * Adapts GraphQL UI API node shape to SearchResultRecordData so existing list UI
- * (SearchResultCard, ResultCardFields, getNestedFieldValue) works unchanged.
- *
- * GraphQL node: { Id, Name: { value }, Owner: { Alias: { value } }, ... }
- * SearchResultRecordData: { id, fields: Record<string, FieldValue>, apiName, ... }
- * FieldValue: { displayValue, value }
- */
-
-import type { FieldValue, SearchResultRecordData } from "../types/search/searchResults";
-
-function isValueLeaf(obj: unknown): obj is { value: string | number | boolean | null } {
-	return (
-		typeof obj === "object" &&
-		obj !== null &&
-		"value" in obj &&
-		(Object.keys(obj).length === 1 || (Object.keys(obj).length === 2 && "displayValue" in obj))
-	);
-}
-
-function graphQLValueToFieldValue(val: unknown): FieldValue {
-	if (val === null || val === undefined) {
-		return { displayValue: null, value: null };
-	}
-	if (isValueLeaf(val)) {
-		const v = val.value;
-		const display =
-			typeof v === "string" || typeof v === "number" || typeof v === "boolean" ? v : null;
-		return { displayValue: display as string | null, value: v };
-	}
-	if (typeof val === "object" && val !== null && !Array.isArray(val)) {
-		const nested = graphQLNodeToFields(val as Record<string, unknown>);
-		const firstFv = nested && Object.values(nested)[0];
-		const display =
-			firstFv && typeof (firstFv as FieldValue).value !== "object"
-				? ((firstFv as FieldValue).value as string | null)
-				: null;
-		return { displayValue: display, value: { fields: nested ?? {} } };
-	}
-	return { displayValue: null, value: val };
-}
-
-function graphQLNodeToFields(node: Record<string, unknown>): Record<string, FieldValue> {
-	const fields: Record<string, FieldValue> = {};
-	for (const [key, val] of Object.entries(node)) {
-		if (key === "Id" || val === undefined) continue;
-		fields[key] = graphQLValueToFieldValue(val);
-	}
-	return fields;
-}
-
-/**
- * Converts a GraphQL connection node (from getRecordsGraphQL) to SearchResultRecordData
- * so it can be passed to SearchResultCard and other components that expect the keyword-search record shape.
- */
-export function graphQLNodeToSearchResultRecordData(
-	node: Record<string, unknown> | undefined,
-	objectApiName: string,
-): SearchResultRecordData {
-	if (!node || typeof node !== "object") {
-		return {
-			id: "",
-			apiName: objectApiName,
-			childRelationships: {},
-			eTag: "",
-			fields: {},
-			lastModifiedById: null,
-			lastModifiedDate: null,
-			recordTypeId: null,
-			recordTypeInfo: null,
-			systemModstamp: null,
-			weakEtag: 0,
-		};
-	}
-	const id = (node.Id as string) ?? "";
-	const fields = graphQLNodeToFields(node);
-	return {
-		id,
-		apiName: objectApiName,
-		childRelationships: {},
-		eTag: "",
-		fields,
-		lastModifiedById: null,
-		lastModifiedDate: null,
-		recordTypeId: null,
-		recordTypeInfo: null,
-		systemModstamp: null,
-		weakEtag: 0,
-	};
-}

package/lib/templates/project/reactb2e/_p_/_m_/_w_/_a_/src/_f_/_gs_/utils/layoutTransformUtils.ts

@@ -1,236 +0,0 @@
-/**
- * Transforms Layout API sections into a structure for the detail form: section → rows → items.
- * Uses layout response (sections, layoutRows, layoutItems, layoutComponents) and optional
- * object info for compound field names and dataType. Section merge when useHeading === false.
- */
-
-import type { LayoutSection, LayoutRow, LayoutItem } from "../types/recordDetail/recordDetail";
-
-const HIDE_EMPTY_SECTIONS = true;
-const EMPTY_OPTIONS: PicklistOption[] = [];
-
-export interface ObjectInfoField {
-	compoundFieldName?: string;
-	dataType?: string;
-}
-
-export interface ObjectInfo {
-	apiName?: string;
-	fields?: Record<string, ObjectInfoField>;
-}
-
-/** Picklist/lookup options for a field (e.g. [{ label, value }]). */
-export type PicklistOption = {
-	label: string | null;
-	value: string | number | boolean;
-	validFor?: unknown[];
-};
-
-export interface LayoutTransformContext {
-	recordId: string;
-	objectInfo?: ObjectInfo | null;
-	lookupRecords?: Record<string, PicklistOption[] | null> | null;
-	getSectionCollapsedState: (sectionId: string) => boolean;
-	calculatePicklistValues?: (itemApiName: string, item: LayoutItem) => PicklistOption[] | null;
-	formOverrides?: { fieldVariant?: string } | null;
-}
-
-export interface TransformedLayoutItem {
-	key: string;
-	isField: boolean;
-	label?: string;
-	required?: boolean;
-	readOnly?: boolean;
-	apiName?: string;
-	contextName?: string;
-	options?: PicklistOption[];
-	variant?: string;
-	dataType?: string;
-	layoutComponentApiNames?: string[];
-}
-
-/** Single row in a section. */
-export interface TransformedLayoutRow {
-	key: string;
-	layoutItems: TransformedLayoutItem[];
-}
-
-/** Section ready for Section/SectionRow rendering. */
-export interface TransformedSection {
-	id: string;
-	key: string;
-	heading: string;
-	useHeading: boolean;
-	collapsible: boolean;
-	collapsed: boolean;
-	layoutRows: TransformedLayoutRow[];
-}
-
-export function createSectionKey(index: number): string {
-	return "section-" + index;
-}
-
-export function getTransformedSections(
-	sections: LayoutSection[],
-	transformContext: LayoutTransformContext,
-): TransformedSection[] {
-	const calculatedSections: TransformedSection[] = [];
-	let previousSection: TransformedSection | null = null;
-
-	sections.forEach((section, index) => {
-		if (previousSection !== null && section.useHeading === false) {
-			const sectionKey = createSectionKey(index);
-			const appendedRows = section.layoutRows
-				.map((row, i) => rowTransform(row, i, sectionKey, transformContext))
-				.filter((r): r is TransformedLayoutRow => r !== null);
-			previousSection.layoutRows.push(...appendedRows);
-			return;
-		}
-
-		const newSection = sectionTransform(section, index, transformContext);
-		if (newSection) {
-			calculatedSections.push(newSection);
-			previousSection = newSection;
-		}
-	});
-
-	return calculatedSections;
-}
-
-export function sectionTransform(
-	section: LayoutSection,
-	index: number,
-	transformContext: LayoutTransformContext,
-): TransformedSection | null {
-	const { getSectionCollapsedState } = transformContext;
-	const sectionKey = createSectionKey(index);
-	const layoutRows = section.layoutRows
-		.map((row, i) => rowTransform(row, i, sectionKey, transformContext))
-		.filter((r): r is TransformedLayoutRow => r !== null);
-
-	if (layoutRows.length === 0 && HIDE_EMPTY_SECTIONS) {
-		return null;
-	}
-
-	return {
-		key: sectionKey,
-		collapsible: section.collapsible,
-		collapsed: getSectionCollapsedState(section.id),
-		useHeading: section.useHeading,
-		heading: section.heading,
-		id: section.id,
-		layoutRows,
-	};
-}
-
-export function rowTransform(
-	row: LayoutRow,
-	index: number,
-	sectionKey: string,
-	transformContext: LayoutTransformContext,
-): TransformedLayoutRow | null {
-	const layoutItems = row.layoutItems.map((item, i) => transformItem(item, i, transformContext));
-
-	const allItemsHaveNoComponents = layoutItems.every((item) => !item.apiName || !item.isField);
-	if (allItemsHaveNoComponents) {
-		return null;
-	}
-	return {
-		key: sectionKey + "-" + index,
-		layoutItems,
-	};
-}
-
-export function transformItem(
-	item: LayoutItem,
-	index: number,
-	transformContext: LayoutTransformContext,
-): TransformedLayoutItem {
-	const { recordId, objectInfo, lookupRecords, calculatePicklistValues, formOverrides } =
-		transformContext;
-
-	let itemApiName: string | undefined;
-	let itemComponentType: string | undefined;
-
-	if (item.layoutComponents.length >= 1) {
-		const itemComponent = item.layoutComponents[0];
-		itemComponentType = itemComponent.componentType;
-		const componentApiName = itemComponent.apiName;
-		const topLevelCompoundName =
-			item.layoutComponents.length > 1 &&
-			componentApiName &&
-			objectInfo?.fields?.[componentApiName]?.compoundFieldName;
-		if (topLevelCompoundName) {
-			itemApiName = topLevelCompoundName;
-		} else {
-			itemApiName = componentApiName ?? undefined;
-		}
-	}
-
-	const lookupOptions =
-		itemApiName != null && lookupRecords?.[itemApiName] != null ? lookupRecords[itemApiName] : null;
-
-	const isFieldType = itemComponentType === "Field";
-
-	const options: PicklistOption[] =
-		lookupOptions ??
-		(itemApiName ? (calculatePicklistValues?.(itemApiName, item) ?? null) : null) ??
-		EMPTY_OPTIONS;
-
-	const fieldMeta = itemApiName ? objectInfo?.fields?.[itemApiName] : undefined;
-	const layoutComponentApiNames = item.layoutComponents
-		.filter((c) => c.componentType === "Field" && c.apiName != null)
-		.map((c) => c.apiName as string);
-
-	let newItem: TransformedLayoutItem = {
-		key: "item-" + index,
-		apiName: itemApiName,
-		contextName: recordId,
-		label: item.label,
-		required: item.required,
-		variant: formOverrides?.fieldVariant ?? "label-stacked",
-		readOnly: !item.editableForUpdate,
-		isField: isFieldType,
-		options,
-		dataType: fieldMeta?.dataType,
-		layoutComponentApiNames:
-			layoutComponentApiNames.length > 0 ? layoutComponentApiNames : undefined,
-	};
-
-	if (objectInfo?.apiName?.endsWith("__kav")) {
-		newItem = { ...newItem, readOnly: true };
-	}
-
-	if (newItem.required === true && newItem.readOnly === true) {
-		newItem = { ...newItem, required: false };
-	}
-
-	return newItem;
-}
-
-export function layoutReducer<T>(
-	sections: TransformedSection[],
-	reducer: (
-		acc: T,
-		ctx: {
-			section: TransformedSection;
-			layoutRow: TransformedLayoutRow;
-			layoutItem: TransformedLayoutItem;
-		},
-	) => T,
-	initialValue: T,
-): T {
-	let accumulator = initialValue;
-	sections.forEach((section) =>
-		section.layoutRows.forEach((layoutRow) =>
-			layoutRow.layoutItems.forEach((layoutItem) => {
-				accumulator = reducer(accumulator, {
-					section,
-					layoutRow,
-					layoutItem,
-				});
-			}),
-		),
-	);
-	return accumulator;
-}

package/lib/templates/project/reactb2e/_p_/_m_/_w_/_a_/src/_f_/_gs_/utils/linkUtils.ts

@@ -1,14 +0,0 @@
-/**
- * Shared allowlist for link protocols (e.g. for FormattedUrl, and future mailto/tel if rendered as links).
- * Centralizes protocol checks so new link types can be added in one place.
- */
-export const ALLOWED_LINK_PROTOCOLS = ["http:", "https:"] as const;
-
-export function isAllowedLinkUrl(value: string): boolean {
-	try {
-		const u = new URL(value);
-		return (ALLOWED_LINK_PROTOCOLS as readonly string[]).includes(u.protocol);
-	} catch {
-		return false;
-	}
-}

package/lib/templates/project/reactb2e/_p_/_m_/_w_/_a_/src/_f_/_gs_/utils/paginationUtils.ts

@@ -1,49 +0,0 @@
-/**
- * Pagination Utilities
- *
- * Utility functions for pagination-related operations including page size validation.
- */
-
-/**
- * Default page size options for pagination
- */
-export const PAGE_SIZE_OPTIONS = [
-	{ value: "10", label: "10" },
-	{ value: "20", label: "20" },
-	{ value: "50", label: "50" },
-] as const;
-
-/**
- * Valid page size values extracted from PAGE_SIZE_OPTIONS
- */
-export const VALID_PAGE_SIZES = PAGE_SIZE_OPTIONS.map((opt) => parseInt(opt.value, 10));
-
-/**
- * Validates that a page size is one of the allowed options
- * @param size - The page size to validate
- * @returns true if valid, false otherwise
- *
- * @example
- * ```tsx
- * if (isValidPageSize(userInput)) {
- *   setPageSize(userInput);
- * }
- * ```
- */
-export function isValidPageSize(size: number): boolean {
-	return VALID_PAGE_SIZES.includes(size);
-}
-
-/**
- * Gets a valid page size, defaulting to the first option if invalid
- * @param size - The page size to validate
- * @returns A valid page size
- *
- * @example
- * ```tsx
- * const safePageSize = getValidPageSize(userInput); // Returns valid size or default
- * ```
- */
-export function getValidPageSize(size: number): number {
-	return isValidPageSize(size) ? size : VALID_PAGE_SIZES[0];
-}

package/lib/templates/project/reactb2e/_p_/_m_/_w_/_a_/src/_f_/_gs_/utils/recordUtils.ts

@@ -1,159 +0,0 @@
-/**
- * Record utilities: layout-derived fields for GraphQL fetch, safe keys, ID validation.
- *
- * calculateFieldsToFetch: from layout + object metadata → field names and relation map;
- * used by objectDetailService and list to build columns. findIdFieldForRelationship ensures
- * Id + relationship name are both requested for reference display.
- *
- * @module utils/recordUtils
- */
-
-import type { ObjectInfoResult } from "../types/objectInfo/objectInfo";
-import type {
-	LayoutResponse,
-	LayoutRow,
-	LayoutSection,
-	LayoutItem,
-	LayoutComponent,
-} from "../types/recordDetail/recordDetail";
-
-/**
- * Find the Id field (reference foreign key) whose relationshipName matches the given name,
- * so we can request both Id and relationship in the record query for display.
- */
-function findIdFieldForRelationship(
-	metadata: ObjectInfoResult,
-	relationshipName: string,
-): string | null {
-	if (!metadata.fields || !relationshipName) return null;
-	for (const [apiName, field] of Object.entries(metadata.fields)) {
-		const isReference = field.dataType != null && field.dataType.toLowerCase() === "reference";
-		if (field.relationshipName === relationshipName && (isReference || apiName.endsWith("Id"))) {
-			return apiName;
-		}
-	}
-	return null;
-}
-
-const getFetchableFieldsFromLayoutItem = function (
-	metadata: ObjectInfoResult,
-	layoutItem: LayoutItem,
-	relationFieldMap: Record<string, string>,
-) {
-	const fields: Record<string, string> = {};
-	layoutItem.layoutComponents.forEach((comp: LayoutComponent) => {
-		// check if this is a field to add
-		if (!comp.apiName || comp.componentType !== "Field") {
-			return;
-		}
-
-		// add field: fieldType
-		const fieldMetadata = metadata.fields[comp.apiName];
-		fields[comp.apiName] = fieldMetadata?.dataType ?? "";
-
-		// add relatedField if one exists (Id field -> add relationship name so we request Owner.Name)
-		if (comp.apiName in metadata.fields) {
-			const relationshipName = fieldMetadata?.relationshipName;
-			if (relationshipName) {
-				fields[relationshipName] = fieldMetadata.dataType ?? "";
-
-				relationFieldMap[comp.apiName] = relationshipName;
-			}
-		} else {
-			// layout component is relationship name (e.g. Owner); ensure we also request the Id
-			// so buildSelectionTree sees both OwnerId and Owner and requests Owner { Name { value } }
-			const idField = findIdFieldForRelationship(metadata, comp.apiName);
-			if (idField) {
-				const idMeta = metadata.fields[idField];
-				fields[idField] = idMeta?.dataType ?? "";
-				relationFieldMap[idField] = comp.apiName;
-			}
-		}
-	});
-	return fields;
-};
-
-const getFetchableFieldsFromLayoutRow = function (
-	metadata: ObjectInfoResult,
-	layoutRow: LayoutRow,
-	relationFieldMap: Record<string, string>,
-) {
-	let fieldsFromRow: Record<string, string> = {};
-	layoutRow.layoutItems.forEach((item: LayoutItem) => {
-		Object.assign(
-			fieldsFromRow,
-			getFetchableFieldsFromLayoutItem(metadata, item, relationFieldMap),
-		);
-	});
-	return fieldsFromRow;
-};
-
-const getFetchableFieldsFromSection = function (
-	metadata: ObjectInfoResult,
-	section: LayoutSection,
-	relationFieldMap: Record<string, string>,
-) {
-	let fieldsFromSection: Record<string, string> = {};
-	section.layoutRows.forEach((row: LayoutRow) => {
-		Object.assign(
-			fieldsFromSection,
-			getFetchableFieldsFromLayoutRow(metadata, row, relationFieldMap),
-		);
-	});
-	return fieldsFromSection;
-};
-
-const getFetchableFieldsFromLayout = function (
-	metadata: ObjectInfoResult,
-	layout: LayoutResponse,
-	relationFieldMap: Record<string, string>,
-) {
-	let fieldsFromLayout: Record<string, string> = {};
-	layout.sections.forEach((section) => {
-		Object.assign(
-			fieldsFromLayout,
-			getFetchableFieldsFromSection(metadata, section, relationFieldMap),
-		);
-	});
-	return fieldsFromLayout;
-};
-
-/**
- * Returns field API names to request for records from layout + object metadata.
- * Includes both Id and relationship name for reference fields so GraphQL can fetch display value.
- *
- * @param metadata - Object info (fields with dataType, relationshipName).
- * @param layout - Layout response (sections, layoutItems, layoutComponents).
- * @param shouldPrefixedWithEntityName - If true, prefix names with object (e.g. Account.Name).
- * @returns [fieldNames, fieldTypes, relationFieldMap] for buildSelectionTree / optionalFields.
- */
-export const calculateFieldsToFetch = function (
-	metadata: ObjectInfoResult,
-	layout: LayoutResponse,
-	shouldPrefixedWithEntityName: boolean,
-): [string[], string[], Record<string, string>] {
-	const relationFieldMap: Record<string, string> = {};
-	// populating fields to query for layout
-	const fields = getFetchableFieldsFromLayout(metadata, layout, relationFieldMap);
-	let fieldsToFetch = Object.keys(fields);
-	if (shouldPrefixedWithEntityName) {
-		fieldsToFetch = fieldsToFetch.map((field) => `${metadata.ApiName}.${field}`);
-	}
-	// populate field types for o11y logging
-	const fieldTypes = Object.values(fields).filter((fieldType) => fieldType !== "");
-	return [fieldsToFetch, fieldTypes, relationFieldMap];
-};
-/** Type guard: true if id is a non-empty string matching 15- or 18-char Salesforce ID format. */
-export function isValidSalesforceId(id: string | null | undefined): id is string {
-	if (!id || typeof id !== "string") return false;
-	return /^[a-zA-Z0-9]{15}$|^[a-zA-Z0-9]{18}$/.test(id);
-}
-
-/** Safe React key from record id or fallback to prefix-index. */
-export function getSafeKey(
-	recordId: string | null | undefined,
-	index: number,
-	prefix: string = "result",
-): string {
-	return isValidSalesforceId(recordId) ? recordId : `${prefix}-${index}`;
-}

package/lib/templates/project/reactb2e/_p_/_m_/_w_/_a_/src/_f_/_gs_/utils/sanitizationUtils.ts

@@ -1,49 +0,0 @@
-/**
- * Sanitization Utilities
- *
- * Utility functions for sanitizing user input to prevent injection attacks.
- * These utilities provide basic sanitization for filter values.
- */
-
-/**
- * Sanitizes a string value by removing potentially dangerous characters
- * and trimming whitespace.
- *
- * This is a basic sanitization - for production, consider using a library like DOMPurify for more
- * comprehensive sanitization.
- * Also, note this is NOT an end-to-end security control.
- * Client-side sanitization can be bypassed by any attacker using `curl` or Postman.
- * To prevent injection attacks (SOSL Injection, XSS):
- * 1. The BACKEND (Salesforce API) handles SOSL injection if parameters are passed correctly.
- * 2. React handles XSS automatically when rendering variables in JSX (e.g., <div>{value}</div>).
- * Do not rely on this function for end-to-end security enforcement.
- *
- * @param value - The string value to sanitize
- * @returns Sanitized string value
- *
- * @remarks
- * - Removes control characters (except newlines, tabs, carriage returns)
- * - Trims leading/trailing whitespace
- * - Limits length to prevent DoS attacks (default: 1000 characters)
- * - Preserves alphanumeric, spaces, and common punctuation
- *
- * @example
- * ```tsx
- * const sanitized = sanitizeFilterValue(userInput);
- * ```
- */
-export function sanitizeFilterValue(value: string, maxLength: number = 1000): string {
-	if (typeof value !== "string") {
-		return "";
-	}
-
-	let sanitized = value.trim();
-
-	if (sanitized.length > maxLength) {
-		sanitized = sanitized.substring(0, maxLength);
-	}
-
-	sanitized = sanitized.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, "");
-
-	return sanitized;
-}