Merge pull request #4827 from LibreSign/backport/4772/stable31

[stable31] feat: customize signature stamp

Author: vitormattos

.devcontainer/devcontainer.json

@@ -39,7 +39,13 @@
 				],
 				"gitlens.showWelcomeOnInstall": false,
 				"telemetry.telemetryLevel": "off",
-				"intelephense.telemetry.enabled": false
+				"intelephense.telemetry.enabled": false,
+				"intelephense.environment.includePaths": [
+					"apps-extra"
+				],
+				"git.scanRepositories": [
+					"/apps-extra/libresign"
+				]
 			}
 		}
 	},

.devcontainer/docker-compose.yml

@@ -67,7 +67,7 @@ services:
       - nextcloud:/var/www/html:ro
       - ../:/var/www/html/apps-extra/libresign:ro
     ports:
-      - 127.0.0.1:${HTTP_PORT:-80}:80
+      - ${HTTP_PORT:-80}:80
   mailhog:
     image: blueimp/mailhog
     ports:

.devcontainer/setup.sh

@@ -16,6 +16,10 @@ if [[ ! -d "vendor" ]]; then
 	composer install
 fi
 occ app:enable libresign
+occ libresign:install --use-local-cert --java
+occ libresign:install --use-local-cert --pdftk
+occ libresign:install --use-local-cert --jsignpdf
+occ libresign:configure:openssl --cn=CommonName --c=BR --ou=OrganizationUnit --st=RioDeJaneiro --o=LibreSign --l=RioDeJaneiro
 if [[ ! -d "node_modules" ]]; then
 	occ theming:config name "LibreSign"
 	occ theming:config url "https://libresign.coop"

composer.json

@@ -2,13 +2,13 @@
 	"require": {
 		"endroid/qr-code": "^5.0",
 		"jsignpdf/jsignpdf-php": "^1.2",
-		"league/plates": "^3.5",
 		"libresign/whatosami": "^0.0.2",
 		"mikehaertl/php-pdftk": "^0.13.0",
 		"mpdf/mpdf": "^8.2",
 		"pagerfanta/pagerfanta": "^4.5",
 		"phpseclib/phpseclib": "^3.0",
 		"smalot/pdfparser": "^2.4",
+		"twig/twig": "^3.20",
 		"wobeto/email-blur": "^1.0"
 	},
 	"require-dev": {
@@ -30,7 +30,7 @@
 	},
 	"scripts": {
 		"bin": "echo 'bin not installed'",
-		"lint": "find . -name \\*.php -not -path './vendor/*' -not -path './build/*' -print0 | xargs -0 -n1 php -l",
+		"lint": "find . -name \\*.php -not -path './vendor/*' -not -path './build/*' -not -path './tests/integration/vendor/*' -print0 | xargs -0 -n1 php -l",
 		"cs:check": "php-cs-fixer fix --dry-run --diff",
 		"cs:fix": "php-cs-fixer fix",
 		"openapi": "generate-spec --verbose && (npm run typescript:generate || echo 'Please manually regenerate the typescript OpenAPI models')",

composer.lock

@@ -11,6 +11,7 @@
 use OCA\Files\Event\LoadAdditionalScriptsEvent;
 use OCA\Files\Event\LoadSidebar;
 use OCA\Libresign\Activity\Listener as ActivityListener;
+use OCA\Libresign\Capabilities;
 use OCA\Libresign\Events\SendSignNotificationEvent;
 use OCA\Libresign\Events\SignedEvent;
 use OCA\Libresign\Files\TemplateLoader as FilesTemplateLoader;
@@ -55,6 +56,7 @@ public function boot(IBootContext $context): void {
 	public function register(IRegistrationContext $context): void {
 		$context->registerMiddleWare(GlobalInjectionMiddleware::class, true);
 		$context->registerMiddleWare(InjectionMiddleware::class);
+		$context->registerCapability(Capabilities::class);
 
 		$context->registerNotifierService(Notifier::class);
 

lib/AppInfo/Application.php

@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2025 LibreCode coop and contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Libresign;
+
+use OCA\Libresign\Service\SignatureTextService;
+use OCA\Libresign\Service\SignerElementsService;
+use OCP\App\IAppManager;
+use OCP\Capabilities\IPublicCapability;
+
+/**
+ * @psalm-import-type LibresignCapabilities from ResponseDefinitions
+ */
+class Capabilities implements IPublicCapability {
+	public const FEATURES = [
+		'customize-signature'
+	];
+
+	public function __construct(
+		protected SignerElementsService $signerElementsService,
+		protected SignatureTextService $signatureTextService,
+		protected IAppManager $appManager,
+	) {
+	}
+
+	/**
+	 * @return array{
+	 *      libresign?: LibresignCapabilities,
+	 * }
+	 */
+	public function getCapabilities(): array {
+		$capabilities = [
+			'features' => self::FEATURES,
+			'config' => [
+				'sign-elements' => [
+					'is-available' => $this->signerElementsService->isSignElementsAvailable(),
+					'can-create-signature' => $this->signerElementsService->canCreateSignature(),
+					'full-signature-width' => $this->signatureTextService->getFullSignatureWidth(),
+					'full-signature-height' => $this->signatureTextService->getFullSignatureHeight(),
+					'signature-width' => $this->signatureTextService->getSignatureWidth(),
+					'signature-height' => $this->signatureTextService->getSignatureHeight(),
+				],
+			],
+			'version' => $this->appManager->getAppVersion('libresign'),
+		];
+
+		return [
+			'libresign' => $capabilities,
+		];
+	}
+}

lib/Capabilities.php

@@ -14,7 +14,7 @@
 use OCA\Libresign\AppInfo\Application;
 use OCA\Libresign\Db\AccountFileMapper;
 use OCA\Libresign\Exception\LibresignException;
-use OCA\Libresign\Handler\Pkcs12Handler;
+use OCA\Libresign\Handler\SignEngine\Pkcs12Handler;
 use OCA\Libresign\Helper\JSActions;
 use OCA\Libresign\Helper\ValidateHelper;
 use OCA\Libresign\ResponseDefinitions;