Merge pull request #6242 from LibreSign/feature/envelope-support

feat: envelope support

Author: vitormattos

.github/copilot-instructions.md

@@ -72,15 +72,29 @@ cd tests/integration
 composer i
 chown -R www-data: .
 
+# List available test steps
+cd tests/integration
+runuser -u www-data -- vendor/bin/behat -dl
+
 # Running integration tests (from libresign root directory)
 cd tests/integration
 runuser -u www-data -- vendor/bin/behat features/<path>.feature
 
+# Run with verbose output (shows nextcloud.log entries)
+runuser -u www-data -- vendor/bin/behat features/<path>.feature -v
+
 # Example: Run specific feature file
 cd tests/integration
 runuser -u www-data -- vendor/bin/behat features/auth/login.feature
 ```
 
+**CRITICAL**: Like unit tests, ALWAYS run specific scenarios, NEVER run the entire integration test suite:
+- Always specify which feature file to run and the row of scenario if needed
+- Use `-dl` to list available test steps when writing new tests
+- Use `-v` flag to see nextcloud.log output during test execution
+- **Important**: steps with OCC command outputs (even with `-v`) don't appear in Behat output but are logged to `nextcloud.log`
+- Running all integration tests is extremely slow and resource-intensive
+
 **Frontend Testing**:
 ```bash
 npm test                # Jest tests

appinfo/info.xml

@@ -25,7 +25,7 @@ Developed with ❤️ by [LibreCode](https://librecode.coop). Help us transform
 
 * [Donate with GitHub Sponsor: ![Donate using GitHub Sponsor](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86)](https://github.com/sponsors/libresign)
 	]]></description>
-	<version>13.0.0-dev.3</version>
+	<version>13.0.0-dev.5</version>
 	<licence>agpl</licence>
 	<author mail="contact@librecode.coop" homepage="https://librecode.coop">LibreCode</author>
 	<types>

lib/Capabilities.php

@@ -8,6 +8,7 @@
 
 namespace OCA\Libresign;
 
+use OCA\Libresign\Service\EnvelopeService;
 use OCA\Libresign\Service\SignatureTextService;
 use OCA\Libresign\Service\SignerElementsService;
 use OCP\App\IAppManager;
@@ -25,6 +26,7 @@ public function __construct(
 		protected SignerElementsService $signerElementsService,
 		protected SignatureTextService $signatureTextService,
 		protected IAppManager $appManager,
+		protected EnvelopeService $envelopeService,
 	) {
 	}
 
@@ -46,6 +48,9 @@ public function getCapabilities(): array {
 					'signature-width' => $this->signatureTextService->getSignatureWidth(),
 					'signature-height' => $this->signatureTextService->getSignatureHeight(),
 				],
+				'envelope' => [
+					'is-available' => $this->envelopeService->isEnabled(),
+				],
 			],
 			'version' => $this->appManager->getAppVersion('libresign'),
 		];