feat: add signingOrder field to API responses and sort signers

Include signingOrder field in signer data returned by FileService.
Sort signers by signingOrder (ascending) and displayName as secondary
sort to maintain consistent ordering in the UI.

Signed-off-by: Vitor Mattos <[email protected]>

Author: vitormattos

lib/Service/FileService.php

@@ -387,6 +387,7 @@ private function loadLibreSignSigners(): void {
 			$this->fileData->signers[$index]['me'] = false;
 			$this->fileData->signers[$index]['signRequestId'] = $signer->getId();
 			$this->fileData->signers[$index]['description'] = $signer->getDescription();
+			$this->fileData->signers[$index]['signingOrder'] = $signer->getSigningOrder();
 			$this->fileData->signers[$index]['visibleElements'] = $this->getVisibleElements($signer->getId());
 			$this->fileData->signers[$index]['request_sign_date'] = $signer->getCreatedAt()->format(DateTimeInterface::ATOM);
 			if (empty($this->fileData->signers[$index]['signed'])) {
@@ -468,6 +469,18 @@ private function loadLibreSignSigners(): void {
 			}, []);
 			ksort($this->fileData->signers[$index]);
 		}
+
+		usort($this->fileData->signers, function ($a, $b) {
+			$orderA = $a['signingOrder'] ?? PHP_INT_MAX;
+			$orderB = $b['signingOrder'] ?? PHP_INT_MAX;
+
+			if ($orderA !== $orderB) {
+				return $orderA <=> $orderB;
+			}
+
+			return strcasecmp($a['displayName'], $b['displayName']);
+		});
+
 		$this->signersLibreSignLoaded = true;
 	}
 
@@ -821,6 +834,7 @@ private function associateAllAndFormat(IUser $user, array $files, array $signers
 						'request_sign_date' => $signer->getCreatedAt()->format(DateTimeInterface::ATOM),
 						'signed' => null,
 						'signRequestId' => $signer->getId(),
+						'signingOrder' => $signer->getSigningOrder(),
 						'me' => array_reduce($identifyMethodsOfSigner, function (bool $carry, IdentifyMethod $identifyMethod) use ($user): bool {
 							if ($identifyMethod->getIdentifierKey() === IdentifyMethodService::IDENTIFY_ACCOUNT) {
 								if ($user->getUID() === $identifyMethod->getIdentifierValue()) {
@@ -888,6 +902,17 @@ private function associateAllAndFormat(IUser $user, array $files, array $signers
 				$files[$key]['signers'] = [];
 				$files[$key]['statusText'] = $this->l10n->t('no signers');
 			} else {
+				usort($files[$key]['signers'], function ($a, $b) {
+					$orderA = $a['signingOrder'] ?? PHP_INT_MAX;
+					$orderB = $b['signingOrder'] ?? PHP_INT_MAX;
+
+					if ($orderA !== $orderB) {
+						return $orderA <=> $orderB;
+					}
+
+					return strcasecmp($a['displayName'], $b['displayName']);
+				});
+
 				$files[$key]['statusText'] = $this->fileMapper->getTextOfStatus((int)$files[$key]['status']);
 			}
 			unset($files[$key]['id']);