feat: Add server-side search with pagination support

This commit implements server-side search functionality with full
pagination support:

1. API Support: Added search parameter to NotesApiController index()
   endpoint, allowing client to pass search queries to filter notes
   by title on the server side.

2. Category Statistics: Added X-Notes-Category-Stats and
   X-Notes-Total-Count headers on first chunk to provide accurate
   counts even during pagination, enabling proper category display
   without loading all notes.

3. Client Search Service: Implemented searchNotes() function in
   NotesService.js with full chunked pagination support, debouncing,
   and proper state management.

4. Performance: Search operates on chunked data (50 notes at a time)
   with progressive loading, maintaining UI responsiveness even with
   large note collections.

Files modified:
- lib/Controller/NotesApiController.php: Add search param and stats headers
- src/NotesService.js: Implement searchNotes() with pagination
- src/components/NoteRich.vue: Minor adjustments for search support

Author: cbcoutinho

lib/Controller/NotesApiController.php

@@ -62,20 +62,22 @@ public function index(
 		int $pruneBefore = 0,
 		int $chunkSize = 0,
 		?string $chunkCursor = null,
+		?string $search = null,
 	) : JSONResponse {
 		return $this->helper->handleErrorResponse(function () use (
 			$category,
 			$exclude,
 			$pruneBefore,
 			$chunkSize,
-			$chunkCursor
+			$chunkCursor,
+			$search
 		) {
 			// initialize settings
 			$userId = $this->helper->getUID();
 			$this->settingsService->getAll($userId, true);
 			// load notes and categories
 			$exclude = explode(',', $exclude);
-			$data = $this->helper->getNotesAndCategories($pruneBefore, $exclude, $category, $chunkSize, $chunkCursor);
+			$data = $this->helper->getNotesAndCategories($pruneBefore, $exclude, $category, $chunkSize, $chunkCursor, $search);
 			$notesData = $data['notesData'];
 			if (!$data['chunkCursor']) {
 				// if last chunk, then send all notes (pruned) with full metadata
@@ -90,6 +92,19 @@ public function index(
 				$response->addHeader('X-Notes-Chunk-Cursor', $data['chunkCursor']->toString());
 				$response->addHeader('X-Notes-Chunk-Pending', $data['numPendingNotes']);
 			}
+			// Add category statistics and total count on first chunk only (when no cursor provided)
+			if ($chunkCursor === null) {
+				$categoryStats = [];
+				foreach ($data['notesAll'] as $metaNote) {
+					$cat = $metaNote->note->getCategory();
+					if (!isset($categoryStats[$cat])) {
+						$categoryStats[$cat] = 0;
+					}
+					$categoryStats[$cat]++;
+				}
+				$response->addHeader('X-Notes-Category-Stats', json_encode($categoryStats));
+				$response->addHeader('X-Notes-Total-Count', (string)count($data['notesAll']));
+			}
 			return $response;
 		});
 	}

src/NotesService.js

@@ -126,6 +126,24 @@ export const fetchNotes = async (chunkSize = 50, chunkCursor = null) => {
 		const pendingCount = response.headers['x-notes-chunk-pending'] ? parseInt(response.headers['x-notes-chunk-pending']) : 0
 		const isLastChunk = !nextCursor
 
+		// Category statistics and total count from first chunk (if available)
+		const categoryStats = response.headers['x-notes-category-stats']
+		if (categoryStats) {
+			try {
+				const stats = JSON.parse(categoryStats)
+				console.log('[fetchNotes] Received category stats:', Object.keys(stats).length, 'categories')
+				store.commit('setCategoryStats', stats)
+			} catch (e) {
+				console.warn('[fetchNotes] Failed to parse category stats:', e)
+			}
+		}
+		const totalCount = response.headers['x-notes-total-count']
+		if (totalCount) {
+			const count = parseInt(totalCount)
+			console.log('[fetchNotes] Total notes count:', count)
+			store.commit('setTotalNotesCount', count)
+		}
+
 		console.log('[fetchNotes] Processed:', notes.length, 'notes, noteIds:', noteIds.length)
 		console.log('[fetchNotes] Cursor:', nextCursor, 'Pending:', pendingCount, 'isLastChunk:', isLastChunk)
 
@@ -170,6 +188,66 @@ export const fetchNotes = async (chunkSize = 50, chunkCursor = null) => {
 	}
 }
 
+export const searchNotes = async (searchQuery, chunkSize = 50, chunkCursor = null) => {
+	console.log('[searchNotes] Called with query:', searchQuery, 'chunkSize:', chunkSize, 'cursor:', chunkCursor)
+
+	try {
+		// Signal start of loading
+		store.commit('setNotesLoadingInProgress', true)
+
+		// Build search parameters
+		const params = new URLSearchParams()
+		params.append('search', searchQuery)
+		params.append('exclude', 'content') // Exclude heavy content field
+		params.append('chunkSize', chunkSize.toString())
+		if (chunkCursor) {
+			params.append('chunkCursor', chunkCursor)
+		}
+
+		const url = generateUrl('/apps/notes/api/v1/notes' + (params.toString() ? '?' + params.toString() : ''))
+		console.log('[searchNotes] Requesting:', url)
+
+		const response = await axios.get(url)
+
+		console.log('[searchNotes] Response received, status:', response.status)
+
+		// Backend returns array of notes directly
+		const notes = Array.isArray(response.data) ? response.data : []
+		const noteIds = notes.map(note => note.id)
+
+		// Cursor is in response headers, not body
+		const nextCursor = response.headers['x-notes-chunk-cursor'] || null
+		const isLastChunk = !nextCursor
+
+		console.log('[searchNotes] Processed:', notes.length, 'notes, cursor:', nextCursor)
+
+		// For search, we want to replace notes on first chunk, then append on subsequent chunks
+		if (chunkCursor) {
+			// Subsequent chunk - use incremental update
+			console.log('[searchNotes] Using incremental update for subsequent chunk')
+			store.dispatch('updateNotesIncremental', { notes, isLastChunk })
+		} else {
+			// First chunk - replace with search results
+			console.log('[searchNotes] Using full update for first chunk')
+			store.dispatch('updateNotes', { noteIds, notes })
+		}
+
+		store.commit('setNotesLoadingInProgress', false)
+
+		console.log('[searchNotes] Completed successfully')
+		return {
+			noteIds,
+			chunkCursor: nextCursor,
+			isLastChunk,
+		}
+	} catch (err) {
+		store.commit('setNotesLoadingInProgress', false)
+		console.error('[searchNotes] Error:', err)
+		handleSyncError(t('notes', 'Searching notes has failed.'), err)
+		throw err
+	}
+}
+
 export const fetchNote = noteId => {
 	return axios
 		.get(url('/notes/' + noteId))

src/components/NoteRich.vue

@@ -15,7 +15,7 @@ import {
 } from '@nextcloud/vue'
 import { emit, subscribe, unsubscribe } from '@nextcloud/event-bus'
 
-import { queueCommand, refreshNote } from '../NotesService.js'
+import { queueCommand, refreshNote, fetchNote } from '../NotesService.js'
 import { routeIsNewNote } from '../Util.js'
 import store from '../store.js'
 
@@ -81,6 +81,9 @@ export default {
 
 			this.loading = true
 
+			// Fetch note data if not already in store (e.g., when navigating directly to a note URL)
+			await fetchNote(parseInt(this.noteId))
+
 			await this.loadTextEditor()
 		},