aboutsummaryrefslogtreecommitdiffstats
path: root/core/Controller/TeamsApiController.php
diff options
context:
space:
mode:
Diffstat (limited to 'core/Controller/TeamsApiController.php')
-rw-r--r--core/Controller/TeamsApiController.php82
1 files changed, 82 insertions, 0 deletions
diff --git a/core/Controller/TeamsApiController.php b/core/Controller/TeamsApiController.php
new file mode 100644
index 00000000000..2eb33a0c254
--- /dev/null
+++ b/core/Controller/TeamsApiController.php
@@ -0,0 +1,82 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OC\Core\Controller;
+
+use OC\Core\ResponseDefinitions;
+use OCP\AppFramework\Http;
+use OCP\AppFramework\Http\Attribute\ApiRoute;
+use OCP\AppFramework\Http\Attribute\NoAdminRequired;
+use OCP\AppFramework\Http\DataResponse;
+use OCP\AppFramework\OCSController;
+use OCP\IRequest;
+use OCP\Teams\ITeamManager;
+use OCP\Teams\Team;
+
+/**
+ * @psalm-import-type CoreTeamResource from ResponseDefinitions
+ * @psalm-import-type CoreTeam from ResponseDefinitions
+ * @property $userId string
+ */
+class TeamsApiController extends OCSController {
+ public function __construct(
+ string $appName,
+ IRequest $request,
+ private ITeamManager $teamManager,
+ private ?string $userId,
+ ) {
+ parent::__construct($appName, $request);
+ }
+
+ /**
+ * Get all resources of a team
+ *
+ * @param string $teamId Unique id of the team
+ * @return DataResponse<Http::STATUS_OK, array{resources: list<CoreTeamResource>}, array{}>
+ *
+ * 200: Resources returned
+ */
+ #[NoAdminRequired]
+ #[ApiRoute(verb: 'GET', url: '/{teamId}/resources', root: '/teams')]
+ public function resolveOne(string $teamId): DataResponse {
+ /**
+ * @var list<CoreTeamResource> $resolvedResources
+ * @psalm-suppress PossiblyNullArgument The route is limited to logged-in users
+ */
+ $resolvedResources = $this->teamManager->getSharedWith($teamId, $this->userId);
+
+ return new DataResponse(['resources' => $resolvedResources]);
+ }
+
+ /**
+ * Get all teams of a resource
+ *
+ * @param string $providerId Identifier of the provider (e.g. deck, talk, collectives)
+ * @param string $resourceId Unique id of the resource to list teams for (e.g. deck board id)
+ * @return DataResponse<Http::STATUS_OK, array{teams: list<CoreTeam>}, array{}>
+ *
+ * 200: Teams returned
+ */
+ #[NoAdminRequired]
+ #[ApiRoute(verb: 'GET', url: '/resources/{providerId}/{resourceId}', root: '/teams')]
+ public function listTeams(string $providerId, string $resourceId): DataResponse {
+ /** @psalm-suppress PossiblyNullArgument The route is limited to logged-in users */
+ $teams = $this->teamManager->getTeamsForResource($providerId, $resourceId, $this->userId);
+ /** @var list<CoreTeam> $teams */
+ $teams = array_values(array_map(function (Team $team) {
+ $response = $team->jsonSerialize();
+ /** @psalm-suppress PossiblyNullArgument The route is limited to logged in users */
+ $response['resources'] = $this->teamManager->getSharedWith($team->getId(), $this->userId);
+ return $response;
+ }, $teams));
+
+ return new DataResponse([
+ 'teams' => $teams,
+ ]);
+ }
+}