From 756d2e033ae5cd095a9f6b79667b03b249d10bba Mon Sep 17 00:00:00 2001
From: Roberto Guido <info@madbob.org>
Date: Tue, 4 Aug 2026 18:50:57 +0200
Subject: [PATCH] feat: FullTextSearch request includes portion of data to be
 retrieved from indexer

Signed-off-by: Roberto Guido <info@madbob.org>
---
 .../FullTextSearch/Model/BodyPortion.php      | 52 +++++++++++++++++++
 .../FullTextSearch/Model/ISearchRequest.php   | 16 ++++++
 2 files changed, 68 insertions(+)
 create mode 100644 lib/public/FullTextSearch/Model/BodyPortion.php

diff --git a/lib/public/FullTextSearch/Model/BodyPortion.php b/lib/public/FullTextSearch/Model/BodyPortion.php
new file mode 100644
index 0000000000000..031e7c047bfe1
--- /dev/null
+++ b/lib/public/FullTextSearch/Model/BodyPortion.php
@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCP\FullTextSearch\Model;
+
+/**
+ * Body portion to be retrieved from the index.
+ *
+ * @since 35.0.0
+ */
+enum BodyPortion: string {
+	/**
+	 * @since 35.0.0
+	 */
+	case TITLE = 'title';
+
+	/**
+	 * @since 35.0.0
+	 */
+	case LINKS = 'links';
+
+	/**
+	 * @since 35.0.0
+	 */
+	case TAGS = 'tags';
+
+	/**
+	 * @since 35.0.0
+	 */
+	case SUBTAGS = 'subtags';
+
+	/**
+	 * @since 35.0.0
+	 */
+	case METATAGS = 'metatags';
+
+	/**
+	 * @since 35.0.0
+	 */
+	case PARTS = 'parts';
+
+	/**
+	 * @since 35.0.0
+	 */
+	case MORE = 'more';
+}
diff --git a/lib/public/FullTextSearch/Model/ISearchRequest.php b/lib/public/FullTextSearch/Model/ISearchRequest.php
index 16c30d8279cbe..d22c7a3a3e7fb 100644
--- a/lib/public/FullTextSearch/Model/ISearchRequest.php
+++ b/lib/public/FullTextSearch/Model/ISearchRequest.php
@@ -205,6 +205,22 @@ public function getSubTags(bool $formatted): array;
 	 */
 	public function setSubTags(array $tags): ISearchRequest;
 
+	/**
+	 * Add a portion of data to be retrieved from the index.
+	 *
+	 * @since 35.0.0
+	 */
+	public function addPortion(BodyPortion $portion): ISearchRequest;
+
+	/**
+	 * Get the portions of data to be retrieved from the index.
+	 *
+	 * @since 35.0.0
+	 *
+	 * @return list<string>
+	 */
+	public function getPortions(): array;
+
 	/**
 	 * Limit the search to a specific field of the mapping, using a full string.
 	 *