feat: setup check implementation

lib/AppInfo/Application.php

@@ -94,5 +94,14 @@ public function register(IRegistrationContext $context): void {
 		$context->registerEventListener(UserDeletedEvent::class, UserDeletedListener::class);
 
 		$context->registerDashboardWidget(PendingSignaturesWidget::class);
+
+		$context->registerSetupCheck(\OCA\Libresign\SetupCheck\JavaSetupCheck::class);
+		$context->registerSetupCheck(\OCA\Libresign\SetupCheck\JSignPdfSetupCheck::class);
+		$context->registerSetupCheck(\OCA\Libresign\SetupCheck\PDFtkSetupCheck::class);
+
+		$context->registerSetupCheck(\OCA\Libresign\SetupCheck\PopplerSetupCheck::class);
+		$context->registerSetupCheck(\OCA\Libresign\SetupCheck\ImagickSetupCheck::class);
+
+		$context->registerSetupCheck(\OCA\Libresign\SetupCheck\CertificateEngineSetupCheck::class);
 	}
 }

lib/Service/Install/ConfigureCheckService.php

@@ -20,6 +20,10 @@
 use OCP\IURLGenerator;
 use Psr\Log\LoggerInterface;
 
+/**
+* @deprecated 13.0.4 Use the individual SetupCheck classes instead
+*             (JavaSetupCheck, JSignPdfSetupCheck, etc.).
+*/
 class ConfigureCheckService {
 	private string $architecture;
 	private bool $isCacheDisabled = false;

lib/SetupCheck/CertificateEngineSetupCheck.php

@@ -0,0 +1,94 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2026 LibreCode coop and contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Libresign\SetupCheck;
+
+use OCA\Libresign\Handler\CertificateEngine\CertificateEngineFactory;
+use OCA\Libresign\Helper\ConfigureCheckHelper;
+use OCP\IL10N;
+use OCP\SetupCheck\ISetupCheck;
+use OCP\SetupCheck\SetupResult;
+
+class CertificateEngineSetupCheck implements ISetupCheck
+{
+  private IL10N $l10n;
+  private CertificateEngineFactory $certificateEngineFactory;
+
+  public function __construct(
+    IL10N $l10n,
+    CertificateEngineFactory $certificateEngineFactory
+  ) {
+    $this->l10n = $l10n;
+    $this->certificateEngineFactory = $certificateEngineFactory;
+  }
+
+  public function getName(): string
+  {
+    return $this->l10n->t('Certificate engine');
+  }
+
+  public function getCategory(): string
+  {
+    return 'security';
+  }
+
+  public function run(): SetupResult
+  {
+    try {
+      $engine = $this->certificateEngineFactory->getEngine();
+      $checkResults = $engine->configureCheck();
+    } catch (\Throwable $e) {
+      $engineName = $this->certificateEngineFactory->getEngine()->getName() ?? 'unknown';
+      return SetupResult::error(
+        $this->l10n->t('Define the certificate engine to use'),
+        $this->l10n->t('Run occ libresign:configure:%s --help', [$engineName])
+      );
+    }
+
+    // Process results: if any error, return error; else if any warning, return warning; else success
+    $hasError = false;
+    $hasWarning = false;
+    $messages = [];
+    $tips = [];
+
+    foreach ($checkResults as $result) {
+      if ($result instanceof ConfigureCheckHelper) {
+        $status = $result->getStatus();
+        $msg = $result->getMessage();
+        $tip = $result->getTip();
+
+        if ($status === 'error') {
+          $hasError = true;
+          $messages[] = "[ERROR] $msg";
+        } elseif ($status === 'warning') {
+          $hasWarning = true;
+          $messages[] = "[WARNING] $msg";
+        } else {
+          $messages[] = $msg;
+        }
+
+        if (!empty($tip)) {
+          $tips[] = $tip;
+        }
+      }
+    }
+
+    $tip = '';
+    if (!empty($tips)) {
+      $tip = implode("\n", array_unique($tips));
+    }
+
+    if ($hasError) {
+      return SetupResult::error(implode("\n", $messages), $tip);
+    } elseif ($hasWarning) {
+      return SetupResult::warning(implode("\n", $messages), $tip);
+    } else {
+      return SetupResult::success(implode("\n", $messages) ?: $this->l10n->t('Certificate engine is configured correctly'));
+    }
+  }
+}

lib/SetupCheck/ImagickSetupCheck.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2026 LibreCode coop and contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Libresign\SetupCheck;
+
+use OCP\IL10N;
+use OCP\SetupCheck\ISetupCheck;
+use OCP\SetupCheck\SetupResult;
+
+class ImagickSetupCheck implements ISetupCheck {
+	private IL10N $l10n;
+
+	public function __construct(IL10N $l10n) {
+		$this->l10n = $l10n;
+	}
+
+	public function getName(): string {
+		return $this->l10n->t('Imagick PHP extension');
+	}
+
+	public function getCategory(): string {
+		return 'system';
+	}
+
+	public function run(): SetupResult {
+		if (!extension_loaded('imagick')) {
+			return SetupResult::info(
+				$this->l10n->t('Imagick extension is not loaded'),
+				$this->l10n->t('Install php-imagick to enable visible signatures, background images, and signature element rendering.')
+			);
+		}
+		return SetupResult::success($this->l10n->t('Imagick extension is loaded'));
+	}
+}

lib/SetupCheck/JSignPdfSetupCheck.php

@@ -0,0 +1,133 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2026 LibreCode coop and contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Libresign\SetupCheck;
+
+use OCA\Libresign\Helper\JavaHelper;
+use OCA\Libresign\AppInfo\Application;
+use OCA\Libresign\Handler\SignEngine\JSignPdfHandler;
+use OCA\Libresign\Service\Install\SignSetupService;
+use OCA\Libresign\Service\Install\InstallService;
+use OCP\IL10N;
+use OCP\IAppConfig;
+use OCP\IURLGenerator;
+use OCP\App\IAppManager;
+use OCP\SetupCheck\ISetupCheck;
+use OCP\SetupCheck\SetupResult;
+use OCP\IConfig;
+use Psr\Log\LoggerInterface;
+
+class JSignPdfSetupCheck implements ISetupCheck
+{
+  use SetupCheckUtils;
+
+  private IL10N $l10n;
+  private IAppConfig $appConfig;
+  private JSignPdfHandler $jSignPdfHandler;
+  private IConfig $systemConfig;
+  private JavaHelper $javaHelper;
+
+  private SignSetupService $signSetupService;
+  private IURLGenerator $urlGenerator;
+  private IAppManager $appManager;
+  private LoggerInterface $logger;
+
+  public function __construct(
+    IL10N $l10n,
+    IAppConfig $appConfig,
+    JSignPdfHandler $jSignPdfHandler,
+    SignSetupService $signSetupService,
+    IURLGenerator $urlGenerator,
+    IAppManager $appManager,
+    LoggerInterface $logger,
+    IConfig $systemConfig,
+    JavaHelper $javaHelper
+  ) {
+    $this->l10n = $l10n;
+    $this->appConfig = $appConfig;
+    $this->jSignPdfHandler = $jSignPdfHandler;
+    $this->signSetupService = $signSetupService;
+    $this->urlGenerator = $urlGenerator;
+    $this->appManager = $appManager;
+    $this->logger = $logger;
+    $this->systemConfig = $systemConfig;
+    $this->javaHelper = $javaHelper;
+  }
+
+  public function getName(): string
+  {
+    return $this->l10n->t('JSignPdf');
+  }
+
+  public function getCategory(): string
+  {
+    return 'system';
+  }
+
+  public function run(): SetupResult
+  {
+    $debugEnabled = $this->systemConfig->getSystemValueBool('debug', false);
+    $jsignpdfJarPath = $this->appConfig->getValueString(Application::APP_ID, 'jsignpdf_jar_path');
+
+    if (!$jsignpdfJarPath) {
+      return SetupResult::error(
+        $this->l10n->t('JSignPdf not found'),
+        $this->l10n->t('Run occ libresign:install --jsignpdf')
+      );
+    }
+
+    $verifyResult = $this->verifyResourceIntegrity('jsignpdf', $debugEnabled);
+    if (!empty($verifyResult)) {
+      [$errorMsg, $tip] = $this->getErrorAndTipFromVerify($verifyResult, 'jsignpdf', $debugEnabled, $this->l10n);
+      return SetupResult::error($errorMsg, $tip);
+    }
+
+    if (!file_exists($jsignpdfJarPath)) {
+      return SetupResult::error(
+        $this->l10n->t('JSignPdf binary not found: %s', [$jsignpdfJarPath]),
+        $this->l10n->t('Run occ libresign:install --jsignpdf')
+      );
+    }
+
+    $javaPath = $this->javaHelper->getJavaPath();
+    if (!$javaPath || !file_exists($javaPath)) {
+      return SetupResult::error(
+        $this->l10n->t('Necessary Java to run JSignPdf'),
+        $this->l10n->t('Run occ libresign:install --java')
+      );
+    }
+
+    $jsignPdf = $this->jSignPdfHandler->getJSignPdf();
+    $jsignPdf->setParam($this->jSignPdfHandler->getJSignParam());
+    $currentVersion = $jsignPdf->getVersion();
+
+    if (!$currentVersion) {
+      $msg = $this->l10n->t('Necessary install the version %s', [InstallService::JSIGNPDF_VERSION]);
+      return SetupResult::error($msg, $this->l10n->t('Run occ libresign:install --jsignpdf'));
+    }
+
+    if (version_compare($currentVersion, InstallService::JSIGNPDF_VERSION, '<')) {
+      $msg = $this->l10n->t('Necessary bump JSignPdf version from %s to %s', [$currentVersion, InstallService::JSIGNPDF_VERSION]);
+      return SetupResult::error($msg, $this->l10n->t('Run occ libresign:install --jsignpdf'));
+    }
+
+    if (version_compare($currentVersion, InstallService::JSIGNPDF_VERSION, '>')) {
+      return SetupResult::error(
+        $this->l10n->t('Necessary downgrade JSignPdf version from %s to %s', [$currentVersion, InstallService::JSIGNPDF_VERSION]),
+        $this->l10n->t('Run occ libresign:install --jsignpdf')
+      );
+    }
+
+    $messages = [
+      $this->l10n->t('JSignPdf version: %s', [$currentVersion]),
+      $this->l10n->t('JSignPdf path: %s', [$jsignpdfJarPath])
+    ];
+
+    return SetupResult::success(implode("\n", $messages));
+  }
+}