feat(App): Add Capabilities

Signed-off-by: provokateurin <kate@provokateurin.de>

lib/AppInfo/Application.php

@@ -10,6 +10,7 @@
 namespace OCA\Recommendations\AppInfo;
 
 use OCA\Files\Event\LoadAdditionalScriptsEvent;
+use OCA\Recommendations\Capabilities;
 use OCA\Recommendations\Dashboard\RecommendationWidget;
 use OCA\Recommendations\Listeners\FilesLoadAdditionalScriptsListener;
 use OCP\AppFramework\App;
@@ -27,6 +28,7 @@ public function __construct(array $urlParams = []) {
 	public function register(IRegistrationContext $context): void {
 		$context->registerEventListener(LoadAdditionalScriptsEvent::class, FilesLoadAdditionalScriptsListener::class);
 		$context->registerDashboardWidget(RecommendationWidget::class);
+		$context->registerCapability(Capabilities::class);
 	}
 
 	public function boot(IBootContext $context): void {

lib/Capabilities.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Recommendations;
+
+use OCA\Recommendations\AppInfo\Application;
+use OCP\Capabilities\ICapability;
+use OCP\IConfig;
+use OCP\IUserSession;
+
+class Capabilities implements ICapability {
+	/** @psalm-suppress PossiblyUnusedMethod */
+	public function __construct(
+		private IUserSession $userSession,
+		private IConfig $config,
+	) {
+	}
+
+	/**
+	 * @return array{
+	 *     recommendations?: array{
+	 *         enabled: bool,
+	 *     },
+	 * }
+	 */
+	public function getCapabilities(): array {
+		$user = $this->userSession->getUser();
+		if ($user === null) {
+			return [];
+		}
+
+		$enabled = $this->config->getUserValue($user->getUID(), Application::APP_ID, 'enabled', 'true') === 'true';
+		return [
+			'recommendations' => [
+				'enabled' => $enabled,
+			],
+		];
+	}
+}

openapi.json

@@ -20,6 +20,22 @@
             }
         },
         "schemas": {
+            "Capabilities": {
+                "type": "object",
+                "properties": {
+                    "recommendations": {
+                        "type": "object",
+                        "required": [
+                            "enabled"
+                        ],
+                        "properties": {
+                            "enabled": {
+                                "type": "boolean"
+                            }
+                        }
+                    }
+                }
+            },
             "OCSMeta": {
                 "type": "object",
                 "required": [