SignRequestStatusService.php

<?php

declare(strict_types=1);
/**
 * SPDX-FileCopyrightText: 2025 LibreCode coop and contributors
 * SPDX-License-Identifier: AGPL-3.0-or-later
 */

namespace OCA\Libresign\Service;

use OCA\Libresign\Db\File as FileEntity;
use OCA\Libresign\Db\SignRequest as SignRequestEntity;
use OCA\Libresign\Enum\SignRequestStatus;

class SignRequestStatusService {
	public function __construct(
		private SequentialSigningService $sequentialSigningService,
		private FileStatusService $fileStatusService,
	) {
	}

	public function shouldNotifySignRequest(SignRequestStatus $signRequestStatus, ?int $fileStatus): bool {
		return $this->fileStatusService->canNotifySigners($fileStatus)
			&& $this->canNotifySignRequest($signRequestStatus);
	}

	public function canNotifySignRequest(SignRequestStatus $status): bool {
		return $status === SignRequestStatus::ABLE_TO_SIGN;
	}

	public function updateStatusIfAllowed(
		SignRequestEntity $signRequest,
		SignRequestStatus $currentStatus,
		SignRequestStatus $desiredStatus,
		bool $isNewSignRequest,
	): void {
		if ($isNewSignRequest || $this->sequentialSigningService->isStatusUpgrade($currentStatus, $desiredStatus)) {
			$signRequest->setStatusEnum($desiredStatus);
		}
	}

	public function determineInitialStatus(
		int $signingOrder,
		int $fileId,
		?int $fileStatus = null,
		?int $signerStatus = null,
		?SignRequestStatus $currentStatus = null,
	): SignRequestStatus {
		if ($fileStatus === FileEntity::STATUS_DRAFT) {
			return SignRequestStatus::DRAFT;
		}

		if ($fileStatus === FileEntity::STATUS_ABLE_TO_SIGN) {
			return $this->determineStatusForAbleToSignFile($signingOrder);
		}

		if ($signerStatus !== null) {
			return $this->handleExplicitSignerStatus($signerStatus, $signingOrder, $fileId, $currentStatus);
		}

		return $this->getDefaultStatusByFlow($signingOrder);
	}

	private function determineStatusForAbleToSignFile(int $signingOrder): SignRequestStatus {
		if ($this->sequentialSigningService->isOrderedNumericFlow()) {
			return $signingOrder === 1 ? SignRequestStatus::ABLE_TO_SIGN : SignRequestStatus::DRAFT;
		}
		return SignRequestStatus::ABLE_TO_SIGN;
	}

	private function handleExplicitSignerStatus(
		int $signerStatus,
		int $signingOrder,
		int $fileId,
		?SignRequestStatus $currentStatus,
	): SignRequestStatus {
		$desiredStatus = SignRequestStatus::from($signerStatus);

		if ($currentStatus !== null && !$this->sequentialSigningService->isStatusUpgrade($currentStatus, $desiredStatus)) {
			return $currentStatus;
		}

		return $this->sequentialSigningService->validateStatusByOrder($desiredStatus, $signingOrder, $fileId);
	}

	private function getDefaultStatusByFlow(int $signingOrder): SignRequestStatus {
		if (!$this->sequentialSigningService->isOrderedNumericFlow()) {
			return SignRequestStatus::ABLE_TO_SIGN;
		}

		return $signingOrder === 1 ? SignRequestStatus::ABLE_TO_SIGN : SignRequestStatus::DRAFT;
	}
}