feat(admin): add team folder management endpoints and UI integration

appinfo/routes.php

@@ -48,13 +48,16 @@
 		['name' => 'TeamFolder#getTeamFolder', 'url' => '/teams/{circleId}/folder', 'verb' => 'GET'],
 		['name' => 'TeamFolder#unlinkTeamFolder', 'url' => '/teams/{circleId}/folder', 'verb' => 'DELETE'],
 		['name' => 'TeamFolder#upgradeTeamFolder', 'url' => '/teams/{circleId}/folder', 'verb' => 'POST'],
+		['name' => 'TeamFolder#getLinkableTeamFolders', 'url' => '/teams/{circleId}/folder/linkable', 'verb' => 'GET'],
+		['name' => 'TeamFolder#linkTeamFolder', 'url' => '/teams/{circleId}/folder/link', 'verb' => 'POST'],
 
 		// Teams Dashboard widget endpoint
 		['name' => 'TeamsDashboard#getCompleteTeamsData', 'url' => '/teams/dashboard/widget', 'verb' => 'GET'],
 
 		// AdminController
 		['name' => 'Admin#circles', 'url' => '/admin/{emulated}/circles', 'verb' => 'GET'],
 		['name' => 'Admin#circlesAll', 'url' => '/admin/circlesall', 'verb' => 'GET'],
+		['name' => 'Admin#teamFolders', 'url' => '/admin/teamfolders', 'verb' => 'GET'],
 		['name' => 'Admin#create', 'url' => '/admin/{emulated}/circles', 'verb' => 'POST'],
 		['name' => 'Admin#destroy', 'url' => '/admin/{emulated}/circles/{circleId}', 'verb' => 'DELETE'],
 		[

lib/Controller/AdminController.php

@@ -35,6 +35,7 @@
 use OCP\AppFramework\OCSController;
 use OCP\IRequest;
 use OCP\IUserSession;
+use OCP\Teams\ITeamManager;
 
 /**
  * Class AdminController
@@ -70,6 +71,7 @@ public function __construct(
 		private MemberService $memberService,
 		private MembershipService $membershipService,
 		private SearchService $searchService,
+		private ITeamManager $teamManager,
 		ConfigService $configService,
 	) {
 		parent::__construct($appName, $request);
@@ -263,6 +265,48 @@ public function circlesAll(
 		}
 	}
 
+	/**
+	 * Return teams and their optionally linked team folders.
+	 *
+	 * @return DataResponse
+	 * @throws OCSException
+	 */
+	public function teamFolders(): DataResponse {
+		try {
+			$this->setLocalFederatedUser($this->userSession->getUser()->getUID());
+			$provider = $this->teamManager->getTeamFolderProvider();
+			if ($provider === null) {
+				return new DataResponse([]);
+			}
+
+			$probe = new CircleProbe();
+			$probe->filterPersonalCircles()
+				->filterSingleCircles()
+				->filterSystemCircles()
+				->filterHiddenCircles()
+				->filterBackendCircles();
+
+			$teamFolders = [];
+			foreach ($this->circleService->getAllCircles($probe) as $circle) {
+				$folder = $provider->getTeamFolder($circle->getSingleId());
+
+				$quota = null;
+
+				$teamFolders[] = [
+					'teamId' => $circle->getSingleId(),
+					'teamName' => $circle->getDisplayName(),
+					'folder' => $folder?->jsonSerialize(),
+					'quota' => $quota,
+				];
+			}
+
+			return new DataResponse($teamFolders);
+		} catch (Exception $e) {
+			$this->e($e);
+			throw new OCSException($e->getMessage(), (int)$e->getCode());
+		}
+	}
+
 	/**
 	 * @param string $emulated
 	 * @param string $circleId

lib/Controller/TeamFolderController.php

@@ -51,13 +51,13 @@
 	}
 
 	#[NoAdminRequired]
-	public function upgradeTeamFolder(string $circleId): DataResponse {
+	public function upgradeTeamFolder(string $circleId, string $name = ''): DataResponse {
 		$circle = $this->getCircle($circleId);
 		$this->assertAuthenticatedUserIsTeamOwnerOrServerAdmin($circleId);
 		$folder = $this->getProvider()->createTeamFolder(
 			new Team(
 				teamId: $circle->getSingleId(),
-				displayName: $circle->getDisplayName(),
+				displayName: trim($name) ?: $circle->getDisplayName(),
 				link: null,
 			),
 			$this->policy->getDefaultQuota(),
@@ -70,6 +70,28 @@
 		]);
 	}
 
+	#[NoAdminRequired]
+	public function getLinkableTeamFolders(string $circleId): DataResponse {
+		$this->assertAuthenticatedUserIsTeamOwnerOrServerAdmin($circleId);
+
+		return new DataResponse(array_map(
+			static fn (\OCP\Teams\TeamFolder $folder): array => $folder->jsonSerialize(),
+			$this->getProvider()->getLinkableTeamFolders($circleId),
+		));
+	}
+
+	#[NoAdminRequired]
+	public function linkTeamFolder(string $circleId, int $folderId): DataResponse {
+		$this->assertAuthenticatedUserIsTeamOwnerOrServerAdmin($circleId);
+		$folder = $this->getProvider()->linkTeamFolder($circleId, $folderId);
+
+		return new DataResponse([
+			'success' => true,
+			'folderId' => $folder->getId(),
+			'folder' => $folder->jsonSerialize(),
+		]);
+	}
+
 	#[NoAdminRequired]
 	public function unlinkTeamFolder(string $circleId, bool $deleteFolder = false): DataResponse {
 		$this->assertAuthenticatedUserIsTeamOwnerOrServerAdmin($circleId);