fix(openapi): Change things that don't raise any questions

Signed-off-by: Joas Schilling <coding@schilljs.com>

lib/Capabilities.php

@@ -272,18 +272,18 @@ public function getCapabilities(): array {
 			$capabilities['config']['signaling']['hello-v2-token-key'] = $pubKey;
 		}
 
-		/** @var ?string[] $predefinedBackgrounds */
+		/** @var ?list<string> $predefinedBackgrounds */
 		$predefinedBackgrounds = null;
 		$cachedPredefinedBackgrounds = $this->talkCache->get('predefined_backgrounds');
 		if ($cachedPredefinedBackgrounds !== null) {
 			// Try using cached value
-			/** @var string[]|null $predefinedBackgrounds */
+			/** @var list<string>|null $predefinedBackgrounds */
 			$predefinedBackgrounds = json_decode($cachedPredefinedBackgrounds, true);
 		}
 
 		if (!is_array($predefinedBackgrounds)) {
 			// Cache was empty or invalid, regenerate
-			/** @var string[] $predefinedBackgrounds */
+			/** @var list<string> $predefinedBackgrounds */
 			$predefinedBackgrounds = [];
 			if (file_exists(__DIR__ . '/../img/backgrounds')) {
 				$directoryIterator = new \DirectoryIterator(__DIR__ . '/../img/backgrounds');

lib/Model/BanMapper.php

@@ -39,6 +39,9 @@ public function findForBannedActorAndRoom(string $bannedActorType, string $banne
 		return $this->findEntity($query);
 	}
 
+	/**
+	 * @return list<Ban>
+	 */
 	public function findByRoomId(int $roomId, ?string $bannedActorType = null): array {
 		$query = $this->db->getQueryBuilder();
 		$query->select('*')

lib/ResponseDefinitions.php

@@ -113,7 +113,7 @@
  *     isReplyable: bool,
  *     markdown: bool,
  *     reactions: array<string, integer>|\stdClass,
- *     reactionsSelf?: string[],
+ *     reactionsSelf?: list<string>,
  *     referenceId: string,
  *     timestamp: int,
  *     token: string,
@@ -156,7 +156,7 @@
  *     inviterDisplayName: string,
  * }
  *
- * @psalm-type TalkMatterbridgeConfigFields = array<array<string, mixed>>
+ * @psalm-type TalkMatterbridgeConfigFields = list<array<string, mixed>>
  *
  * @psalm-type TalkMatterbridge = array{
  *     enabled: bool,
@@ -184,7 +184,7 @@
  *     participantType: int,
  *     permissions: int,
  *     roomToken: string,
- *     sessionIds: string[],
+ *     sessionIds: list<string>,
  *     status?: string,
  *     statusClearAt?: ?int,
  *     statusIcon?: ?string,
@@ -321,15 +321,15 @@
  *     server: string,
  *     signalingMode: string,
  *     sipDialinInfo: string,
- *     stunservers: array{urls: string[]}[],
+ *     stunservers: list<array{urls: list<string>}>,
  *     ticket: string,
- *     turnservers: array{urls: string[], username: string, credential: mixed}[],
+ *     turnservers: list<array{urls: list<string>, username: string, credential: mixed}>,
  *     userId: ?string,
  * }
  *
  * @psalm-type TalkCapabilities = array{
- *     features: string[],
- *     features-local: string[],
+ *     features: list<string>,
+ *     features-local: list<string>,
  *     config: array{
  *         attachments: array{
  *             allowed: bool,
@@ -340,8 +340,8 @@
  *             breakout-rooms: bool,
  *             recording: bool,
  *             recording-consent: int,
- *             supported-reactions: string[],
- *             predefined-backgrounds: string[],
+ *             supported-reactions: list<string>,
+ *             predefined-backgrounds: list<string>,
  *             can-upload-background: bool,
  *             sip-enabled: bool,
  *             sip-dialout-enabled: bool,
@@ -374,7 +374,7 @@
  *             hello-v2-token-key?: string,
  *         },
  *     },
- *     config-local: array<string, string[]>,
+ *     config-local: array<string, list<string>>,
  *     version: string,
  * }
  */

lib/Service/PollService.php

@@ -93,7 +93,7 @@ public function createPoll(int $roomId, string $actorType, string $actorId, stri
 
 	/**
 	 * @param int $roomId
-	 * @return Poll[]
+	 * @return list<Poll>
 	 */
 	public function getDraftsForRoom(int $roomId): array {
 		return $this->pollMapper->getDraftsByRoomId($roomId);
@@ -135,7 +135,7 @@ public function updatePoll(Participant $participant, Poll $poll): void {
 	/**
 	 * @param Participant $participant
 	 * @param Poll $poll
-	 * @return Vote[]
+	 * @return list<Vote>
 	 */
 	public function getVotesForActor(Participant $participant, Poll $poll): array {
 		return $this->voteMapper->findByPollIdForActor(
@@ -147,7 +147,7 @@ public function getVotesForActor(Participant $participant, Poll $poll): array {
 
 	/**
 	 * @param Poll $poll
-	 * @return Vote[]
+	 * @return list<Vote>
 	 */
 	public function getVotes(Poll $poll): array {
 		return $this->voteMapper->findByPollId($poll->getId());
@@ -157,7 +157,7 @@ public function getVotes(Poll $poll): array {
 	 * @param Participant $participant
 	 * @param Poll $poll
 	 * @param int[] $optionIds Options the user voted for
-	 * @return Vote[]
+	 * @return list<Vote>
 	 * @throws \RuntimeException
 	 */
 	public function votePoll(Participant $participant, Poll $poll, array $optionIds): array {