Merge pull request #32560 from nextcloud/feature/noid/preferences-api

Add API to change preferences

4 files changed, 193 insertions, 0 deletions

diff --git a/apps/provisioning_api/appinfo/routes.php b/apps/provisioning_api/appinfo/routes.php
index 54d550260b8..ab404ff8459 100644
--- a/apps/provisioning_api/appinfo/routes.php
+++ b/apps/provisioning_api/appinfo/routes.php
@@ -73,6 +73,12 @@ return [
 		['name' => 'AppConfig#getValue', 'url' => '/api/v1/config/apps/{app}/{key}', 'verb' => 'GET'],
 		['name' => 'AppConfig#setValue', 'url' => '/api/v1/config/apps/{app}/{key}', 'verb' => 'POST'],
 		['name' => 'AppConfig#deleteKey', 'url' => '/api/v1/config/apps/{app}/{key}', 'verb' => 'DELETE'],
+
+		// Preferences
+		['name' => 'Preferences#setPreference', 'url' => '/api/v1/config/users/{appId}/{configKey}', 'verb' => 'POST'],
+		['name' => 'Preferences#setMultiplePreferences', 'url' => '/api/v1/config/users/{appId}', 'verb' => 'POST'],
+		['name' => 'Preferences#deletePreference', 'url' => '/api/v1/config/users/{appId}/{configKey}', 'verb' => 'DELETE'],
+		['name' => 'Preferences#deleteMultiplePreference', 'url' => '/api/v1/config/users/{appId}', 'verb' => 'DELETE'],
 	],
 	'routes' => [
 		// Verification
diff --git a/apps/provisioning_api/composer/composer/autoload_classmap.php b/apps/provisioning_api/composer/composer/autoload_classmap.php
index 7f840d39729..12c2daf7a14 100644
--- a/apps/provisioning_api/composer/composer/autoload_classmap.php
+++ b/apps/provisioning_api/composer/composer/autoload_classmap.php
@@ -13,6 +13,7 @@ return array(
     'OCA\\Provisioning_API\\Controller\\AppConfigController' => $baseDir . '/../lib/Controller/AppConfigController.php',
     'OCA\\Provisioning_API\\Controller\\AppsController' => $baseDir . '/../lib/Controller/AppsController.php',
     'OCA\\Provisioning_API\\Controller\\GroupsController' => $baseDir . '/../lib/Controller/GroupsController.php',
+    'OCA\\Provisioning_API\\Controller\\PreferencesController' => $baseDir . '/../lib/Controller/PreferencesController.php',
     'OCA\\Provisioning_API\\Controller\\UsersController' => $baseDir . '/../lib/Controller/UsersController.php',
     'OCA\\Provisioning_API\\Controller\\VerificationController' => $baseDir . '/../lib/Controller/VerificationController.php',
     'OCA\\Provisioning_API\\FederatedShareProviderFactory' => $baseDir . '/../lib/FederatedShareProviderFactory.php',
diff --git a/apps/provisioning_api/composer/composer/autoload_static.php b/apps/provisioning_api/composer/composer/autoload_static.php
index 6dbf6b45c79..5aadb1574b3 100644
--- a/apps/provisioning_api/composer/composer/autoload_static.php
+++ b/apps/provisioning_api/composer/composer/autoload_static.php
@@ -28,6 +28,7 @@ class ComposerStaticInitProvisioning_API
         'OCA\\Provisioning_API\\Controller\\AppConfigController' => __DIR__ . '/..' . '/../lib/Controller/AppConfigController.php',
         'OCA\\Provisioning_API\\Controller\\AppsController' => __DIR__ . '/..' . '/../lib/Controller/AppsController.php',
         'OCA\\Provisioning_API\\Controller\\GroupsController' => __DIR__ . '/..' . '/../lib/Controller/GroupsController.php',
+        'OCA\\Provisioning_API\\Controller\\PreferencesController' => __DIR__ . '/..' . '/../lib/Controller/PreferencesController.php',
         'OCA\\Provisioning_API\\Controller\\UsersController' => __DIR__ . '/..' . '/../lib/Controller/UsersController.php',
         'OCA\\Provisioning_API\\Controller\\VerificationController' => __DIR__ . '/..' . '/../lib/Controller/VerificationController.php',
         'OCA\\Provisioning_API\\FederatedShareProviderFactory' => __DIR__ . '/..' . '/../lib/FederatedShareProviderFactory.php',
diff --git a/apps/provisioning_api/lib/Controller/PreferencesController.php b/apps/provisioning_api/lib/Controller/PreferencesController.php
new file mode 100644
index 00000000000..2dba8b86eb6
--- /dev/null
+++ b/apps/provisioning_api/lib/Controller/PreferencesController.php
@@ -0,0 +1,185 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2022 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ *
+ */
+
+namespace OCA\Provisioning_API\Controller;
+
+use OCP\AppFramework\Http;
+use OCP\AppFramework\Http\DataResponse;
+use OCP\AppFramework\OCSController;
+use OCP\Config\BeforePreferenceDeletedEvent;
+use OCP\Config\BeforePreferenceSetEvent;
+use OCP\EventDispatcher\IEventDispatcher;
+use OCP\IConfig;
+use OCP\IRequest;
+use OCP\IUserSession;
+
+class PreferencesController extends OCSController {
+
+	private IConfig $config;
+	private IUserSession $userSession;
+	private IEventDispatcher $eventDispatcher;
+
+	public function __construct(
+		string $appName,
+		IRequest $request,
+		IConfig $config,
+		IUserSession $userSession,
+		IEventDispatcher $eventDispatcher
+	) {
+		parent::__construct($appName, $request);
+		$this->config = $config;
+		$this->userSession = $userSession;
+		$this->eventDispatcher = $eventDispatcher;
+	}
+
+	/**
+	 * @NoAdminRequired
+	 * @NoSubAdminRequired
+	 */
+	public function setMultiplePreferences(string $appId, array $configs): DataResponse {
+		$userId = $this->userSession->getUser()->getUID();
+
+		foreach ($configs as $configKey => $configValue) {
+			$event = new BeforePreferenceSetEvent(
+				$userId,
+				$appId,
+				$configKey,
+				$configValue
+			);
+
+			$this->eventDispatcher->dispatchTyped($event);
+
+			if (!$event->isValid()) {
+				// No listener validated that the preference can be set (to this value)
+				return new DataResponse([], Http::STATUS_BAD_REQUEST);
+			}
+		}
+
+		foreach ($configs as $configKey => $configValue) {
+			$this->config->setUserValue(
+				$userId,
+				$appId,
+				$configKey,
+				$configValue
+			);
+		}
+
+		return new DataResponse();
+	}
+
+	/**
+	 * @NoAdminRequired
+	 * @NoSubAdminRequired
+	 */
+	public function setPreference(string $appId, string $configKey, string $configValue): DataResponse {
+		$userId = $this->userSession->getUser()->getUID();
+
+		$event = new BeforePreferenceSetEvent(
+			$userId,
+			$appId,
+			$configKey,
+			$configValue
+		);
+
+		$this->eventDispatcher->dispatchTyped($event);
+
+		if (!$event->isValid()) {
+			// No listener validated that the preference can be set (to this value)
+			return new DataResponse([], Http::STATUS_BAD_REQUEST);
+		}
+
+		$this->config->setUserValue(
+			$userId,
+			$appId,
+			$configKey,
+			$configValue
+		);
+
+		return new DataResponse();
+	}
+
+	/**
+	 * @NoAdminRequired
+	 * @NoSubAdminRequired
+	 */
+	public function deleteMultiplePreference(string $appId, array $configKeys): DataResponse {
+		$userId = $this->userSession->getUser()->getUID();
+
+		foreach ($configKeys as $configKey) {
+			$event = new BeforePreferenceDeletedEvent(
+				$userId,
+				$appId,
+				$configKey
+			);
+
+			$this->eventDispatcher->dispatchTyped($event);
+
+			if (!$event->isValid()) {
+				// No listener validated that the preference can be deleted
+				return new DataResponse([], Http::STATUS_BAD_REQUEST);
+			}
+		}
+
+		foreach ($configKeys as $configKey) {
+			$this->config->deleteUserValue(
+				$userId,
+				$appId,
+				$configKey
+			);
+		}
+
+		return new DataResponse();
+	}
+
+	/**
+	 * @NoAdminRequired
+	 * @NoSubAdminRequired
+	 */
+	public function deletePreference(string $appId, string $configKey): DataResponse {
+		$userId = $this->userSession->getUser()->getUID();
+
+		$event = new BeforePreferenceDeletedEvent(
+			$userId,
+			$appId,
+			$configKey
+		);
+
+		$this->eventDispatcher->dispatchTyped($event);
+
+		if (!$event->isValid()) {
+			// No listener validated that the preference can be deleted
+			return new DataResponse([], Http::STATUS_BAD_REQUEST);
+		}
+
+		$this->config->deleteUserValue(
+			$userId,
+			$appId,
+			$configKey
+		);
+
+		return new DataResponse();
+	}
+}