feat: add pg_trgm indexes and lightweight document title search

- Introduced pg_trgm extension and GIN trigram indexes for efficient document title searches, enhancing performance for mention picker functionality.
- Implemented a new API endpoint for lightweight document title searches, returning only essential fields.
- Updated frontend components to utilize the new title search feature with throttling for improved user experience.
- Added necessary schemas and types for the new search functionality.

surfsense_web/lib/apis/documents-api.service.ts

@@ -22,8 +22,11 @@ import {
 	getSurfsenseDocsRequest,
 	getSurfsenseDocsResponse,
 	type SearchDocumentsRequest,
+	type SearchDocumentTitlesRequest,
 	searchDocumentsRequest,
 	searchDocumentsResponse,
+	searchDocumentTitlesRequest,
+	searchDocumentTitlesResponse,
 	type UpdateDocumentRequest,
 	type UploadDocumentRequest,
 	updateDocumentRequest,
@@ -160,6 +163,35 @@ class DocumentsApiService {
 		return baseApiService.get(`/api/v1/documents/search?${queryParams}`, searchDocumentsResponse);
 	};
 
+	/**
+	 * Search document titles (lightweight, optimized for mention picker)
+	 * Returns only id, title, document_type - no content or metadata
+	 */
+	searchDocumentTitles = async (request: SearchDocumentTitlesRequest) => {
+		const parsedRequest = searchDocumentTitlesRequest.safeParse(request);
+
+		if (!parsedRequest.success) {
+			console.error("Invalid request:", parsedRequest.error);
+
+			const errorMessage = parsedRequest.error.issues.map((issue) => issue.message).join(", ");
+			throw new ValidationError(`Invalid request: ${errorMessage}`);
+		}
+
+		// Transform query params to be string values
+		const transformedQueryParams = Object.fromEntries(
+			Object.entries(parsedRequest.data.queryParams)
+				.filter(([, v]) => v !== undefined)
+				.map(([k, v]) => [k, String(v)])
+		);
+
+		const queryParams = new URLSearchParams(transformedQueryParams).toString();
+
+		return baseApiService.get(
+			`/api/v1/documents/search/titles?${queryParams}`,
+			searchDocumentTitlesResponse
+		);
+	};
+
 	/**
 	 * Get document type counts
 	 */