feat(activity): Add API for applications to register a focused activity selector

This allows applications to register a class to extend the query for
 focused activity. Focused activity events should directly concern the
 logged-in user.

Signed-off-by: Côme Chilliet <come.chilliet@nextcloud.com>

Author: come-nc

lib/composer/composer/autoload_classmap.php

@@ -84,6 +84,7 @@
     'OCP\\Activity\\Exceptions\\InvalidValueException' => $baseDir . '/lib/public/Activity/Exceptions/InvalidValueException.php',
     'OCP\\Activity\\Exceptions\\SettingNotFoundException' => $baseDir . '/lib/public/Activity/Exceptions/SettingNotFoundException.php',
     'OCP\\Activity\\Exceptions\\UnknownActivityException' => $baseDir . '/lib/public/Activity/Exceptions/UnknownActivityException.php',
+    'OCP\\Activity\\IActivityFocusedSelector' => $baseDir . '/lib/public/Activity/IActivityFocusedSelector.php',
     'OCP\\Activity\\IBulkConsumer' => $baseDir . '/lib/public/Activity/IBulkConsumer.php',
     'OCP\\Activity\\IConsumer' => $baseDir . '/lib/public/Activity/IConsumer.php',
     'OCP\\Activity\\IEvent' => $baseDir . '/lib/public/Activity/IEvent.php',

lib/composer/composer/autoload_static.php

@@ -125,6 +125,7 @@ class ComposerStaticInit749170dad3f5e7f9ca158f5a9f04f6a2
         'OCP\\Activity\\Exceptions\\InvalidValueException' => __DIR__ . '/../../..' . '/lib/public/Activity/Exceptions/InvalidValueException.php',
         'OCP\\Activity\\Exceptions\\SettingNotFoundException' => __DIR__ . '/../../..' . '/lib/public/Activity/Exceptions/SettingNotFoundException.php',
         'OCP\\Activity\\Exceptions\\UnknownActivityException' => __DIR__ . '/../../..' . '/lib/public/Activity/Exceptions/UnknownActivityException.php',
+        'OCP\\Activity\\IActivityFocusedSelector' => __DIR__ . '/../../..' . '/lib/public/Activity/IActivityFocusedSelector.php',
         'OCP\\Activity\\IBulkConsumer' => __DIR__ . '/../../..' . '/lib/public/Activity/IBulkConsumer.php',
         'OCP\\Activity\\IConsumer' => __DIR__ . '/../../..' . '/lib/public/Activity/IConsumer.php',
         'OCP\\Activity\\IEvent' => __DIR__ . '/../../..' . '/lib/public/Activity/IEvent.php',

lib/private/Activity/Manager.php

@@ -8,6 +8,7 @@
 
 namespace OC\Activity;
 
+use OC\AppFramework\Bootstrap\Coordinator;
 use OCP\Activity\ActivitySettings;
 use OCP\Activity\Exceptions\FilterNotFoundException;
 use OCP\Activity\Exceptions\IncompleteActivityException;
@@ -30,18 +31,10 @@
 use OCP\Server;
 
 class Manager implements IManager {
-
-	/** @var string */
-	protected $formattingObjectType;
-
-	/** @var int|string */
-	protected $formattingObjectId;
-
-	/** @var bool */
-	protected $requirePNG = false;
-
-	/** @var string */
-	protected $currentUserId;
+	protected ?string $formattingObjectType = null;
+	protected int|string|null $formattingObjectId = null;
+	protected bool $requirePNG = false;
+	protected ?string $currentUserId = null;
 
 	public function __construct(
 		protected IRequest $request,
@@ -51,6 +44,7 @@ public function __construct(
 		protected IRichTextFormatter $richTextFormatter,
 		protected IL10N $l10n,
 		protected ITimeFactory $timeFactory,
+		private Coordinator $coordinator,
 	) {
 	}
 
@@ -396,4 +390,14 @@ protected function getUserFromToken(): string {
 		// Token found login as that user
 		return array_shift($users);
 	}
+
+	#[\Override]
+	public function getActivityFocusedSelectors(): array {
+		$registeredSelectors = $this->coordinator->getRegistrationContext()?->getActivityFocusedSelectors() ?? [];
+		$selectors = [];
+		foreach ($registeredSelectors as $registration) {
+			$selectors[] = Server::get($registration->getService());
+		}
+		return $selectors;
+	}
 }

lib/private/AppFramework/Bootstrap/RegistrationContext.php

@@ -12,6 +12,7 @@
 use Closure;
 use OC\AppFramework\DependencyInjection\DIContainer;
 use OC\Support\CrashReport\Registry;
+use OCP\Activity\IActivityFocusedSelector;
 use OCP\AppFramework\App;
 use OCP\AppFramework\Bootstrap\IRegistrationContext;
 use OCP\AppFramework\Middleware;
@@ -167,6 +168,9 @@ class RegistrationContext {
 	/** @var ServiceRegistration<IMailProvider>[] */
 	private $mailProviders = [];
 
+	/** @var ServiceRegistration<IActivityFocusedSelector>[] */
+	private array $activityFocusedSelectors = [];
+
 	public function __construct(
 		private LoggerInterface $logger,
 	) {
@@ -491,6 +495,14 @@ public function registerConfigLexicon(string $configLexiconClass): void {
 					$configLexiconClass
 				);
 			}
+
+			#[\Override]
+			public function registerActivityFocusedSelector(string $activityFocusedSelectorClass): void {
+				$this->context->registerActivityFocusedSelector(
+					$this->appId,
+					$activityFocusedSelectorClass
+				);
+			}
 		};
 	}
 
@@ -709,6 +721,10 @@ public function registerConfigLexicon(string $appId, string $configLexiconClass)
 		$this->configLexiconClasses[$appId] = $configLexiconClass;
 	}
 
+	public function registerActivityFocusedSelector(string $appId, string $activityFocusedSelectorClass): void {
+		$this->activityFocusedSelectors[] = new ServiceRegistration($appId, $activityFocusedSelectorClass);
+	}
+
 	/**
 	 * @param App[] $apps
 	 */
@@ -1094,4 +1110,11 @@ public function getConfigLexicon(string $appId): ?ILexicon {
 
 		return Server::get($this->configLexiconClasses[$appId]);
 	}
+
+	/**
+	 * @return ServiceRegistration<IActivityFocusedSelector>[]
+	 */
+	public function getActivityFocusedSelectors(): array {
+		return $this->activityFocusedSelectors;
+	}
 }

lib/private/Server.php

@@ -590,6 +590,7 @@ public function __construct(
 				$c->get(IRichTextFormatter::class),
 				$l10n,
 				$c->get(ITimeFactory::class),
+				$c->get(\OC\AppFramework\Bootstrap\Coordinator::class),
 			);
 		});
 

lib/public/Activity/IActivityFocusedSelector.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCP\Activity;
+
+use OCP\AppFramework\Attribute\Implementable;
+use OCP\DB\QueryBuilder\IQueryBuilder;
+
+/**
+ * @since 35.0.0
+ */
+#[Implementable(since: '35.0.0')]
+interface IActivityFocusedSelector {
+	/**
+	 * Extend query with joins if needed, and return an array of conditions to add
+	 * in the OR clause of the WHERE for filtering focused activity events
+	 *
+	 * @return list<string> conditions to add in the where clause
+	 * @since 35.0.0
+	 */
+	public function extendQuery(IQueryBuilder $query, string $userId): array;
+}

lib/public/Activity/IManager.php

@@ -12,6 +12,7 @@
 use OCP\Activity\Exceptions\FilterNotFoundException;
 use OCP\Activity\Exceptions\IncompleteActivityException;
 use OCP\Activity\Exceptions\SettingNotFoundException;
+use OCP\AppFramework\QueryException;
 
 /**
  * Interface IManager
@@ -175,4 +176,13 @@ public function setCurrentUserId(?string $currentUserId = null): void;
 	 * @since 8.1.0
 	 */
 	public function getCurrentUserId(): string;
+
+	/**
+	 * Get "focused activity" selectors declared by booted applications
+	 *
+	 * @throws QueryException If an application registered a class that cannot be instanciated
+	 * @return list<IActivityFocusedSelector>
+	 * @since 35.0.0
+	 */
+	public function getActivityFocusedSelectors(): array;
 }

lib/public/AppFramework/Bootstrap/IRegistrationContext.php

@@ -452,4 +452,13 @@ public function registerMailProvider(string $class): void;
 	 * @since 31.0.0
 	 */
 	public function registerConfigLexicon(string $configLexiconClass): void;
+
+	/**
+	 * Register an implementation of \OCP\Activity\IActivityFocusedSelector that
+	 * will extend the DB query to find focused activity events
+	 *
+	 * @param class-string<\OCP\Activity\IActivityFocusedSelector> $configLexiconClass
+	 * @since 35.0.0
+	 */
+	public function registerActivityFocusedSelector(string $activityFocusedSelectorClass): void;
 }