fix: provision api's status codes

hamza221 · hamza221 · commit 9be2f060f913 · 2024-09-30T17:19:32.000+02:00
Signed-off-by: Hamza Mahjoubi &lt;hamzamahjoubi221@gmail.com&gt;
diff --git a/apps/provisioning_api/lib/Controller/UsersController.php b/apps/provisioning_api/lib/Controller/UsersController.php
@@ -488,7 +488,7 @@ public function addUser(
 				$group = $this->groupManager->get($groupid);
 				// Check if group exists
 				if ($group === null) {
-					throw new OCSException($this->l10n->t('Sub-admin group does not exist'), 102);
+					throw new OCSException($this->l10n->t('Sub-admin group does not exist'), 109);
 				}
 				// Check if trying to make subadmin of admin group
 				if ($group->getGID() === 'admin') {
@@ -508,7 +508,7 @@ public function addUser(
 		}
 		if ($password === '') {
 			if ($email === '') {
-				throw new OCSException($this->l10n->t('To send a password link to the user an email address is required.'), 108);
+				throw new OCSException($this->l10n->t('An email address is required, to send a password link to the user.'), 108);
 			}
 
 			$passwordEvent = new GenerateSecurePasswordEvent();
@@ -1011,7 +1011,7 @@ public function editUser(string $userId, string $key, string $value): DataRespon
 		}
 		// Check if permitted to edit this field
 		if (!in_array($key, $permittedFields)) {
-			throw new OCSException('', 103);
+			throw new OCSException('', 113);
 		}
 		// Process the edit
 		switch ($key) {
@@ -1032,14 +1032,14 @@ public function editUser(string $userId, string $key, string $value): DataRespon
 						$quota = \OCP\Util::computerFileSize($quota);
 					}
 					if ($quota === false) {
-						throw new OCSException($this->l10n->t('Invalid quota value: %1$s', [$value]), 102);
+						throw new OCSException($this->l10n->t('Invalid quota value: %1$s', [$value]), 101);
 					}
 					if ($quota === -1) {
 						$quota = 'none';
 					} else {
 						$maxQuota = (int)$this->config->getAppValue('files', 'max_quota', '-1');
 						if ($maxQuota !== -1 && $quota > $maxQuota) {
-							throw new OCSException($this->l10n->t('Invalid quota value. %1$s is exceeding the maximum quota', [$value]), 102);
+							throw new OCSException($this->l10n->t('Invalid quota value. %1$s is exceeding the maximum quota', [$value]), 101);
 						}
 						$quota = \OCP\Util::humanFileSize($quota);
 					}
@@ -1048,7 +1048,7 @@ public function editUser(string $userId, string $key, string $value): DataRespon
 				if ($quota === 'none') {
 					$allowUnlimitedQuota = $this->config->getAppValue('files', 'allow_unlimited_quota', '1') === '1';
 					if (!$allowUnlimitedQuota) {
-						throw new OCSException($this->l10n->t('Unlimited quota is forbidden on this instance'), 102);
+						throw new OCSException($this->l10n->t('Unlimited quota is forbidden on this instance'), 101);
 					}
 				}
 				$targetUser->setQuota($quota);
@@ -1059,33 +1059,33 @@ public function editUser(string $userId, string $key, string $value): DataRespon
 			case self::USER_FIELD_PASSWORD:
 				try {
 					if (strlen($value) > IUserManager::MAX_PASSWORD_LENGTH) {
-						throw new OCSException($this->l10n->t('Invalid password value'), 102);
+						throw new OCSException($this->l10n->t('Invalid password value'), 101);
 					}
 					if (!$targetUser->canChangePassword()) {
-						throw new OCSException($this->l10n->t('Setting the password is not supported by the users backend'), 103);
+						throw new OCSException($this->l10n->t('Setting the password is not supported by the users backend'), 112);
 					}
 					$targetUser->setPassword($value);
 				} catch (HintException $e) { // password policy error
-					throw new OCSException($e->getMessage(), 103);
+					throw new OCSException($e->getMessage(), 107);
 				}
 				break;
 			case self::USER_FIELD_LANGUAGE:
 				$languagesCodes = $this->l10nFactory->findAvailableLanguages();
 				if (!in_array($value, $languagesCodes, true) && $value !== 'en') {
-					throw new OCSException($this->l10n->t('Invalid language'), 102);
+					throw new OCSException($this->l10n->t('Invalid language'), 101);
 				}
 				$this->config->setUserValue($targetUser->getUID(), 'core', 'lang', $value);
 				break;
 			case self::USER_FIELD_LOCALE:
 				if (!$this->l10nFactory->localeExists($value)) {
-					throw new OCSException($this->l10n->t('Invalid locale'), 102);
+					throw new OCSException($this->l10n->t('Invalid locale'), 101);
 				}
 				$this->config->setUserValue($targetUser->getUID(), 'core', 'locale', $value);
 				break;
 			case self::USER_FIELD_FIRST_DAY_OF_WEEK:
 				$intValue = (int)$value;
 				if ($intValue < -1 || $intValue > 6) {
-					throw new OCSException($this->l10n->t('Invalid first day of week'), 102);
+					throw new OCSException($this->l10n->t('Invalid first day of week'), 101);
 				}
 				if ($intValue === -1) {
 					$this->config->deleteUserValue($targetUser->getUID(), 'core', AUserData::USER_FIELD_FIRST_DAY_OF_WEEK);
@@ -1110,14 +1110,14 @@ public function editUser(string $userId, string $key, string $value): DataRespon
 					}
 				}
 				if (!$success) {
-					throw new OCSException('', 102);
+					throw new OCSException('', 101);
 				}
 				break;
 			case IAccountManager::PROPERTY_EMAIL:
 				if (filter_var($value, FILTER_VALIDATE_EMAIL) || $value === '') {
 					$targetUser->setEMailAddress($value);
 				} else {
-					throw new OCSException('', 102);
+					throw new OCSException('', 101);
 				}
 				break;
 			case IAccountManager::COLLECTION_EMAIL:
@@ -1126,13 +1126,13 @@ public function editUser(string $userId, string $key, string $value): DataRespon
 					$mailCollection = $userAccount->getPropertyCollection(IAccountManager::COLLECTION_EMAIL);
 
 					if ($mailCollection->getPropertyByValue($value)) {
-						throw new OCSException('', 102);
+						throw new OCSException('', 101);
 					}
 
 					$mailCollection->addPropertyWithDefaults($value);
 					$this->accountManager->updateAccount($userAccount);
 				} else {
-					throw new OCSException('', 102);
+					throw new OCSException('', 101);
 				}
 				break;
 			case IAccountManager::PROPERTY_PHONE:
@@ -1156,7 +1156,7 @@ public function editUser(string $userId, string $key, string $value): DataRespon
 								$this->knownUserService->deleteByContactUserId($targetUser->getUID());
 							}
 						} catch (InvalidArgumentException $e) {
-							throw new OCSException('Invalid ' . $e->getMessage(), 102);
+							throw new OCSException('Invalid ' . $e->getMessage(), 101);
 						}
 					}
 				} catch (PropertyDoesNotExistException $e) {
@@ -1165,7 +1165,7 @@ public function editUser(string $userId, string $key, string $value): DataRespon
 				try {
 					$this->accountManager->updateAccount($userAccount);
 				} catch (InvalidArgumentException $e) {
-					throw new OCSException('Invalid ' . $e->getMessage(), 102);
+					throw new OCSException('Invalid ' . $e->getMessage(), 101);
 				}
 				break;
 			case IAccountManager::PROPERTY_PROFILE_ENABLED:
@@ -1203,12 +1203,12 @@ public function editUser(string $userId, string $key, string $value): DataRespon
 						$userProperty->setScope($value);
 						$this->accountManager->updateAccount($userAccount);
 					} catch (InvalidArgumentException $e) {
-						throw new OCSException('Invalid ' . $e->getMessage(), 102);
+						throw new OCSException('Invalid ' . $e->getMessage(), 101);
 					}
 				}
 				break;
 			default:
-				throw new OCSException('', 103);
+				throw new OCSException('', 113);
 		}
 		return new DataResponse();
 	}
diff --git a/apps/provisioning_api/tests/Controller/UsersControllerTest.php b/apps/provisioning_api/tests/Controller/UsersControllerTest.php
@@ -1623,7 +1623,7 @@ public function testEditUserRegularUserSelfEditAddAdditionalEmailMainAddress():
 			->with($userAccount);
 
 		$this->expectException(OCSException::class);
-		$this->expectExceptionCode(102);
+		$this->expectExceptionCode(101);
 		$this->api->editUser('UserToEdit', 'additional_mail', 'demo@nextcloud.com')->getData();
 	}
 
@@ -1682,13 +1682,13 @@ public function testEditUserRegularUserSelfEditAddAdditionalEmailDuplicate(): vo
 			->with($userAccount);
 
 		$this->expectException(OCSException::class);
-		$this->expectExceptionCode(102);
+		$this->expectExceptionCode(101);
 		$this->api->editUser('UserToEdit', 'additional_mail', 'demo1@nextcloud.com')->getData();
 	}
 
 	public function testEditUserRegularUserSelfEditChangeEmailInvalid(): void {
 		$this->expectException(\OCP\AppFramework\OCS\OCSException::class);
-		$this->expectExceptionCode(102);
+		$this->expectExceptionCode(101);
 
 		$loggedInUser = $this->getMockBuilder(IUser::class)
 			->disableOriginalConstructor()
@@ -1922,7 +1922,7 @@ public function testEditUserRegularUserSelfEditChangePassword(): void {
 
 	public function testEditUserRegularUserSelfEditChangeQuota(): void {
 		$this->expectException(\OCP\AppFramework\OCS\OCSException::class);
-		$this->expectExceptionCode(103);
+		$this->expectExceptionCode(113);
 
 		$loggedInUser = $this->getMockBuilder(IUser::class)
 			->disableOriginalConstructor()
@@ -2009,7 +2009,7 @@ public function testEditUserAdminUserSelfEditChangeValidQuota(): void {
 	public function testEditUserAdminUserSelfEditChangeInvalidQuota(): void {
 		$this->expectException(\OCP\AppFramework\OCS\OCSException::class);
 		$this->expectExceptionMessage('Invalid quota value: ABC');
-		$this->expectExceptionCode(102);
+		$this->expectExceptionCode(101);
 
 		$loggedInUser = $this->getMockBuilder(IUser::class)->disableOriginalConstructor()->getMock();
 		$loggedInUser
diff --git a/build/integration/features/provisioning-v1.feature b/build/integration/features/provisioning-v1.feature
@@ -214,7 +214,7 @@ Feature: provisioning
     And sending "PUT" to "/cloud/users/brand-new-user" with
       | key | additional_mail |
       | value | no-reply@nextcloud.com |
-    And the OCS status code should be "102"
+    And the OCS status code should be "101"
     And the HTTP status code should be "200"
     And sending "PUT" to "/cloud/users/brand-new-user" with
       | key | additional_mail |
@@ -225,7 +225,7 @@ Feature: provisioning
     And sending "PUT" to "/cloud/users/brand-new-user" with
       | key | additional_mail |
       | value | no.reply2@nextcloud.com |
-    And the OCS status code should be "102"
+    And the OCS status code should be "101"
     And the HTTP status code should be "200"
     Then user "brand-new-user" has
       | id | brand-new-user |
@@ -270,17 +270,17 @@ Feature: provisioning
     When sending "PUT" to "/cloud/users/brand-new-user" with
       | key | phoneScope |
       | value | invalid |
-    Then the OCS status code should be "102"
+    Then the OCS status code should be "101"
     And the HTTP status code should be "200"
     When sending "PUT" to "/cloud/users/brand-new-user" with
       | key | displaynameScope |
       | value | v2-private |
-    Then the OCS status code should be "102"
+    Then the OCS status code should be "101"
     And the HTTP status code should be "200"
     When sending "PUT" to "/cloud/users/brand-new-user" with
       | key | emailScope |
       | value | v2-private |
-    Then the OCS status code should be "102"
+    Then the OCS status code should be "101"
     And the HTTP status code should be "200"
 
   Scenario: Edit a user account multi-value property scopes with invalid or unsupported value
@@ -326,7 +326,7 @@ Feature: provisioning
     When sending "PUT" to "/cloud/users/brand-new-user" with
       | key | phoneScope |
       | value | v2-private |
-    Then the OCS status code should be "103"
+    Then the OCS status code should be "113"
     And the HTTP status code should be "200"
 
   Scenario: Search by phone number

Original file line number	Diff line number	Diff line change
`@@ -488,7 +488,7 @@ public function addUser(`
`488`	`488`	`$group = $this->groupManager->get($groupid);`
`489`	`489`	`// Check if group exists`
`490`	`490`	`if ($group === null) {`
`491`		`- throw new OCSException($this->l10n->t('Sub-admin group does not exist'), 102);`
	`491`	`+ throw new OCSException($this->l10n->t('Sub-admin group does not exist'), 109);`
`492`	`492`	`}`
`493`	`493`	`// Check if trying to make subadmin of admin group`
`494`	`494`	`if ($group->getGID() === 'admin') {`
`@@ -508,7 +508,7 @@ public function addUser(`
`508`	`508`	`}`
`509`	`509`	`if ($password === '') {`
`510`	`510`	`if ($email === '') {`
`511`		`- throw new OCSException($this->l10n->t('To send a password link to the user an email address is required.'), 108);`
	`511`	`+ throw new OCSException($this->l10n->t('An email address is required, to send a password link to the user.'), 108);`
`512`	`512`	`}`
`513`	`513`
`514`	`514`	`$passwordEvent = new GenerateSecurePasswordEvent();`
`@@ -1011,7 +1011,7 @@ public function editUser(string $userId, string $key, string $value): DataRespon`
`1011`	`1011`	`}`
`1012`	`1012`	`// Check if permitted to edit this field`
`1013`	`1013`	`if (!in_array($key, $permittedFields)) {`
`1014`		`- throw new OCSException('', 103);`
	`1014`	`+ throw new OCSException('', 113);`
`1015`	`1015`	`}`
`1016`	`1016`	`// Process the edit`
`1017`	`1017`	`switch ($key) {`
`@@ -1032,14 +1032,14 @@ public function editUser(string $userId, string $key, string $value): DataRespon`
`1032`	`1032`	`$quota = \OCP\Util::computerFileSize($quota);`
`1033`	`1033`	`}`
`1034`	`1034`	`if ($quota === false) {`
`1035`		`- throw new OCSException($this->l10n->t('Invalid quota value: %1$s', [$value]), 102);`
	`1035`	`+ throw new OCSException($this->l10n->t('Invalid quota value: %1$s', [$value]), 101);`
`1036`	`1036`	`}`
`1037`	`1037`	`if ($quota === -1) {`
`1038`	`1038`	`$quota = 'none';`
`1039`	`1039`	`} else {`
`1040`	`1040`	`$maxQuota = (int)$this->config->getAppValue('files', 'max_quota', '-1');`
`1041`	`1041`	`if ($maxQuota !== -1 && $quota > $maxQuota) {`
`1042`		`- throw new OCSException($this->l10n->t('Invalid quota value. %1$s is exceeding the maximum quota', [$value]), 102);`
	`1042`	`+ throw new OCSException($this->l10n->t('Invalid quota value. %1$s is exceeding the maximum quota', [$value]), 101);`
`1043`	`1043`	`}`
`1044`	`1044`	`$quota = \OCP\Util::humanFileSize($quota);`
`1045`	`1045`	`}`
`@@ -1048,7 +1048,7 @@ public function editUser(string $userId, string $key, string $value): DataRespon`
`1048`	`1048`	`if ($quota === 'none') {`
`1049`	`1049`	`$allowUnlimitedQuota = $this->config->getAppValue('files', 'allow_unlimited_quota', '1') === '1';`
`1050`	`1050`	`if (!$allowUnlimitedQuota) {`
`1051`		`- throw new OCSException($this->l10n->t('Unlimited quota is forbidden on this instance'), 102);`
	`1051`	`+ throw new OCSException($this->l10n->t('Unlimited quota is forbidden on this instance'), 101);`
`1052`	`1052`	`}`
`1053`	`1053`	`}`
`1054`	`1054`	`$targetUser->setQuota($quota);`
`@@ -1059,33 +1059,33 @@ public function editUser(string $userId, string $key, string $value): DataRespon`
`1059`	`1059`	`case self::USER_FIELD_PASSWORD:`
`1060`	`1060`	`try {`
`1061`	`1061`	`if (strlen($value) > IUserManager::MAX_PASSWORD_LENGTH) {`
`1062`		`- throw new OCSException($this->l10n->t('Invalid password value'), 102);`
	`1062`	`+ throw new OCSException($this->l10n->t('Invalid password value'), 101);`
`1063`	`1063`	`}`
`1064`	`1064`	`if (!$targetUser->canChangePassword()) {`
`1065`		`- throw new OCSException($this->l10n->t('Setting the password is not supported by the users backend'), 103);`
	`1065`	`+ throw new OCSException($this->l10n->t('Setting the password is not supported by the users backend'), 112);`
`1066`	`1066`	`}`
`1067`	`1067`	`$targetUser->setPassword($value);`
`1068`	`1068`	`} catch (HintException $e) { // password policy error`
`1069`		`- throw new OCSException($e->getMessage(), 103);`
	`1069`	`+ throw new OCSException($e->getMessage(), 107);`
`1070`	`1070`	`}`
`1071`	`1071`	`break;`
`1072`	`1072`	`case self::USER_FIELD_LANGUAGE:`
`1073`	`1073`	`$languagesCodes = $this->l10nFactory->findAvailableLanguages();`
`1074`	`1074`	`if (!in_array($value, $languagesCodes, true) && $value !== 'en') {`
`1075`		`- throw new OCSException($this->l10n->t('Invalid language'), 102);`
	`1075`	`+ throw new OCSException($this->l10n->t('Invalid language'), 101);`
`1076`	`1076`	`}`
`1077`	`1077`	`$this->config->setUserValue($targetUser->getUID(), 'core', 'lang', $value);`
`1078`	`1078`	`break;`
`1079`	`1079`	`case self::USER_FIELD_LOCALE:`
`1080`	`1080`	`if (!$this->l10nFactory->localeExists($value)) {`
`1081`		`- throw new OCSException($this->l10n->t('Invalid locale'), 102);`
	`1081`	`+ throw new OCSException($this->l10n->t('Invalid locale'), 101);`
`1082`	`1082`	`}`
`1083`	`1083`	`$this->config->setUserValue($targetUser->getUID(), 'core', 'locale', $value);`
`1084`	`1084`	`break;`
`1085`	`1085`	`case self::USER_FIELD_FIRST_DAY_OF_WEEK:`
`1086`	`1086`	`$intValue = (int)$value;`
`1087`	`1087`	`if ($intValue < -1 \|\| $intValue > 6) {`
`1088`		`- throw new OCSException($this->l10n->t('Invalid first day of week'), 102);`
	`1088`	`+ throw new OCSException($this->l10n->t('Invalid first day of week'), 101);`
`1089`	`1089`	`}`
`1090`	`1090`	`if ($intValue === -1) {`
`1091`	`1091`	`$this->config->deleteUserValue($targetUser->getUID(), 'core', AUserData::USER_FIELD_FIRST_DAY_OF_WEEK);`
`@@ -1110,14 +1110,14 @@ public function editUser(string $userId, string $key, string $value): DataRespon`
`1110`	`1110`	`}`
`1111`	`1111`	`}`
`1112`	`1112`	`if (!$success) {`
`1113`		`- throw new OCSException('', 102);`
	`1113`	`+ throw new OCSException('', 101);`
`1114`	`1114`	`}`
`1115`	`1115`	`break;`
`1116`	`1116`	`case IAccountManager::PROPERTY_EMAIL:`
`1117`	`1117`	`if (filter_var($value, FILTER_VALIDATE_EMAIL) \|\| $value === '') {`
`1118`	`1118`	`$targetUser->setEMailAddress($value);`
`1119`	`1119`	`} else {`
`1120`		`- throw new OCSException('', 102);`
	`1120`	`+ throw new OCSException('', 101);`
`1121`	`1121`	`}`
`1122`	`1122`	`break;`
`1123`	`1123`	`case IAccountManager::COLLECTION_EMAIL:`
`@@ -1126,13 +1126,13 @@ public function editUser(string $userId, string $key, string $value): DataRespon`
`1126`	`1126`	`$mailCollection = $userAccount->getPropertyCollection(IAccountManager::COLLECTION_EMAIL);`
`1127`	`1127`
`1128`	`1128`	`if ($mailCollection->getPropertyByValue($value)) {`
`1129`		`- throw new OCSException('', 102);`
	`1129`	`+ throw new OCSException('', 101);`
`1130`	`1130`	`}`
`1131`	`1131`
`1132`	`1132`	`$mailCollection->addPropertyWithDefaults($value);`
`1133`	`1133`	`$this->accountManager->updateAccount($userAccount);`
`1134`	`1134`	`} else {`
`1135`		`- throw new OCSException('', 102);`
	`1135`	`+ throw new OCSException('', 101);`
`1136`	`1136`	`}`
`1137`	`1137`	`break;`
`1138`	`1138`	`case IAccountManager::PROPERTY_PHONE:`
`@@ -1156,7 +1156,7 @@ public function editUser(string $userId, string $key, string $value): DataRespon`
`1156`	`1156`	`$this->knownUserService->deleteByContactUserId($targetUser->getUID());`
`1157`	`1157`	`}`
`1158`	`1158`	`} catch (InvalidArgumentException $e) {`
`1159`		`- throw new OCSException('Invalid ' . $e->getMessage(), 102);`
	`1159`	`+ throw new OCSException('Invalid ' . $e->getMessage(), 101);`
`1160`	`1160`	`}`
`1161`	`1161`	`}`
`1162`	`1162`	`} catch (PropertyDoesNotExistException $e) {`
`@@ -1165,7 +1165,7 @@ public function editUser(string $userId, string $key, string $value): DataRespon`
`1165`	`1165`	`try {`
`1166`	`1166`	`$this->accountManager->updateAccount($userAccount);`
`1167`	`1167`	`} catch (InvalidArgumentException $e) {`
`1168`		`- throw new OCSException('Invalid ' . $e->getMessage(), 102);`
	`1168`	`+ throw new OCSException('Invalid ' . $e->getMessage(), 101);`
`1169`	`1169`	`}`
`1170`	`1170`	`break;`
`1171`	`1171`	`case IAccountManager::PROPERTY_PROFILE_ENABLED:`
`@@ -1203,12 +1203,12 @@ public function editUser(string $userId, string $key, string $value): DataRespon`
`1203`	`1203`	`$userProperty->setScope($value);`
`1204`	`1204`	`$this->accountManager->updateAccount($userAccount);`
`1205`	`1205`	`} catch (InvalidArgumentException $e) {`
`1206`		`- throw new OCSException('Invalid ' . $e->getMessage(), 102);`
	`1206`	`+ throw new OCSException('Invalid ' . $e->getMessage(), 101);`
`1207`	`1207`	`}`
`1208`	`1208`	`}`
`1209`	`1209`	`break;`
`1210`	`1210`	`default:`
`1211`		`- throw new OCSException('', 103);`
	`1211`	`+ throw new OCSException('', 113);`
`1212`	`1212`	`}`
`1213`	`1213`	`return new DataResponse();`
`1214`	`1214`	`}`