@salesforce/ui-bundle-template-feature-react-global-search 1.117.2

package/src/force-app/main/default/uiBundles/feature-react-global-search/src/index.ts

@@ -0,0 +1,120 @@
+/**
+ * Public API for the Global Search feature package.
+ *
+ * Design goals:
+ * - Export **API services, hooks, types, schemas, and utilities** that customers can import from node_modules.
+ * - Do **not** export UI components or feature constants (customers build their own UI).
+ *
+ * Source implementation lives under `src/features/global-search/**`.
+ */
+
+// ---------------------------------------------------------------------------
+// API layer
+// ---------------------------------------------------------------------------
+
+export { objectInfoService } from "./features/global-search/api/objectInfoService";
+export {
+	objectDetailService,
+	extractFieldsFromLayout,
+} from "./features/global-search/api/objectDetailService";
+export type { RecordDetailResult } from "./features/global-search/api/objectDetailService";
+
+export {
+	getRecordsGraphQL,
+	getRecordByIdGraphQL,
+	buildGetRecordsQuery,
+	buildWhereFromCriteria,
+	buildOrderByFromSort,
+} from "./features/global-search/api/recordListGraphQLService";
+export type {
+	RecordListGraphQLResult,
+	RecordListGraphQLVariables,
+	RecordListGraphQLOptions,
+	GraphQLRecordNode,
+} from "./features/global-search/api/recordListGraphQLService";
+
+// ---------------------------------------------------------------------------
+// Hooks
+// ---------------------------------------------------------------------------
+
+export { useObjectInfoBatch } from "./features/global-search/hooks/useObjectInfoBatch";
+export {
+	useObjectListMetadata,
+	useObjectColumns,
+	useObjectFilters,
+} from "./features/global-search/hooks/useObjectSearchData";
+export { useRecordListGraphQL } from "./features/global-search/hooks/useRecordListGraphQL";
+export { useRecordDetailLayout } from "./features/global-search/hooks/useRecordDetailLayout";
+
+export type { ObjectListMetadata } from "./features/global-search/hooks/useObjectSearchData";
+
+export type {
+	UseRecordListGraphQLOptions,
+	UseRecordListGraphQLReturn,
+} from "./features/global-search/hooks/useRecordListGraphQL";
+
+export type {
+	UseRecordDetailLayoutParams,
+	UseRecordDetailLayoutReturn,
+} from "./features/global-search/hooks/useRecordDetailLayout";
+
+// ---------------------------------------------------------------------------
+// Types + Zod schemas (runtime validation)
+// ---------------------------------------------------------------------------
+
+export {
+	ColumnArraySchema,
+	SearchResultRecordArraySchema,
+	KeywordSearchResultSchema,
+	SearchResultsResponseSchema,
+} from "./features/global-search/types/search/searchResults";
+export type {
+	Column,
+	SearchResultRecord,
+	KeywordSearchResult,
+	SearchResultsResponse,
+} from "./features/global-search/types/search/searchResults";
+
+export {
+	FilterArraySchema,
+	FilterCriteriaArraySchema,
+	FILTER_OPERATORS,
+} from "./features/global-search/types/filters/filters";
+export type {
+	Filter,
+	FilterCriteria,
+	FilterOperator,
+	FiltersResponse,
+} from "./features/global-search/types/filters/filters";
+
+export type { PicklistValue } from "./features/global-search/types/filters/picklist";
+
+export type {
+	ObjectInfoBatchResponse,
+	ObjectInfoResult,
+} from "./features/global-search/types/objectInfo/objectInfo";
+
+export { LayoutResponseSchema } from "./features/global-search/types/recordDetail/recordDetail";
+export type { LayoutResponse } from "./features/global-search/types/recordDetail/recordDetail";
+
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+
+export { fetchAndValidate, safeEncodePath } from "./features/global-search/utils/apiUtils";
+export { debounce } from "./features/global-search/utils/debounce";
+export { createFiltersKey } from "./features/global-search/utils/cacheUtils";
+export {
+	calculateFieldsToFetch,
+	getSafeKey,
+	isValidSalesforceId,
+} from "./features/global-search/utils/recordUtils";
+export { parseFilterValue } from "./features/global-search/utils/filterUtils";
+export { sanitizeFilterValue } from "./features/global-search/utils/sanitizationUtils";
+export {
+	getGraphQLNodeValue,
+	getDisplayValueForDetailFieldFromNode,
+	getDisplayValueForLayoutItemFromNode,
+	getGraphQLRecordDisplayName,
+} from "./features/global-search/utils/graphQLNodeFieldUtils";
+export { graphQLNodeToSearchResultRecordData } from "./features/global-search/utils/graphQLRecordAdapter";

package/src/force-app/main/default/uiBundles/feature-react-global-search/src/lib/__inherit__utils.ts

@@ -0,0 +1,5 @@
+import { type ClassValue } from "clsx";
+
+export function cn(..._ignored: ClassValue[]): string {
+	return "";
+}

package/src/force-app/main/default/uiBundles/feature-react-global-search/src/pages/Home.tsx

@@ -0,0 +1,13 @@
+import { GlobalSearchInput } from "../features/global-search/components/search/GlobalSearchInput";
+
+export default function Home() {
+	return (
+		<div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12">
+			<div className="text-center">
+				<h1 className="text-4xl font-bold text-gray-900 mb-4">Home</h1>
+				<p className="text-lg text-gray-600 mb-8">Welcome to your React application.</p>
+			</div>
+			<GlobalSearchInput />
+		</div>
+	);
+}

package/src/force-app/main/default/uiBundles/feature-react-global-search/src/routes.tsx

@@ -0,0 +1,52 @@
+/**
+ * Application Routes Configuration
+ *
+ * Defines all routes for the global search feature.
+ *
+ * @remarks
+ * - Global search: `/global-search/:query` (use query "browse__all" for browse-all)
+ * - Detail: `/object/:objectApiName/:recordId`
+ * - Uses Suspense for code splitting with LoadingFallback
+ * - Route order matters: more specific routes must come before generic routes
+ *
+ * @example
+ * ```tsx
+ * import { routes } from './routes';
+ * import { createBrowserRouter, RouterProvider } from 'react-router';
+ *
+ * const router = createBrowserRouter(routes);
+ * <RouterProvider router={router} />
+ * ```
+ */
+import type { RouteObject } from "react-router";
+import AppLayout from "./__inherit__appLayout";
+import GlobalSearch from "./features/global-search/pages/GlobalSearch";
+import DetailPage from "./features/global-search/pages/DetailPage";
+import { Suspense } from "react";
+import LoadingFallback from "./features/global-search/components/shared/LoadingFallback";
+export const routes: RouteObject[] = [
+	{
+		path: "/",
+		element: <AppLayout />,
+		children: [
+			{
+				path: "global-search/:query",
+				element: (
+					<Suspense fallback={<LoadingFallback />}>
+						<GlobalSearch />
+					</Suspense>
+				),
+				handle: { showInNavigation: false },
+			},
+			{
+				path: "object/:objectApiName/:recordId",
+				element: (
+					<Suspense fallback={<LoadingFallback />}>
+						<DetailPage />
+					</Suspense>
+				),
+				handle: { showInNavigation: false },
+			},
+		],
+	},
+];