20395868261

Committed 20 Dec 2025 02:42PM UTC coverage: 43.246%. First build

Build # 20395868261

Build Type

Pull #6242

github

Committed by

web-flow

Commit Message

Merge b81fd641a into fae2922ee

Pull Request Pull Request #6242: feat: envelope support

Run Details

162 of 510 new or added lines in 13 files covered. (31.76%)

6064 of 14022 relevant lines covered (43.25%)

5.07 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

76.19

/lib/Service/EnvelopeService.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 DateTime;
use OCA\Libresign\AppInfo\Application;
use OCA\Libresign\Db\File as FileEntity;
use OCA\Libresign\Db\FileMapper;
use OCA\Libresign\Enum\NodeType;
use OCA\Libresign\Exception\LibresignException;
use OCP\AppFramework\Db\DoesNotExistException;
use OCP\IAppConfig;
use OCP\IL10N;
use Sabre\DAV\UUIDUtil;

class EnvelopeService {
        public function __construct(
                protected FileMapper $fileMapper,
                protected IL10N $l10n,
                protected IAppConfig $appConfig,
                protected FolderService $folderService,
        ) {
        }

        public function isEnabled(): bool {
                return $this->appConfig->getValueBool(Application::APP_ID, 'envelope_enabled', true);
        }

        /**
         * @throws LibresignException
         */
        public function validateEnvelopeConstraints(int $fileCount): void {
                if (!$this->isEnabled()) {
                        throw new LibresignException($this->l10n->t('Envelope feature is disabled'));
                }

                $maxFiles = $this->getMaxFilesPerEnvelope();
                if ($fileCount > $maxFiles) {
                        throw new LibresignException(
                                $this->l10n->t('Maximum number of files per envelope (%s) exceeded', [$maxFiles])
                        );
                }
        }

        public function createEnvelope(string $name, ?string $userId = null): FileEntity {
                if ($userId) {
                        $this->folderService->setUserId($userId);
                }
                $parentFolder = $this->folderService->getFolder();

                $folderName = $name . '_' . substr(UUIDUtil::getUUID(), 0, 8);
                $envelopeFolder = $parentFolder->newFolder($folderName);

                $envelope = new FileEntity();
                $envelope->setNodeId($envelopeFolder->getId());
                $envelope->setNodeTypeEnum(NodeType::ENVELOPE);
                $envelope->setName($name);
                $envelope->setUuid(UUIDUtil::getUUID());
                $envelope->setCreatedAt(new DateTime());
                $envelope->setStatus(FileEntity::STATUS_DRAFT);

                if ($userId) {
                        $envelope->setUserId($userId);
                }

                return $this->fileMapper->insert($envelope);
        }

        public function addFileToEnvelope(int $envelopeId, FileEntity $file): FileEntity {
                $envelope = $this->fileMapper->getById($envelopeId);

                if (!$envelope->isEnvelope()) {
                        throw new LibresignException($this->l10n->t('The specified ID is not an envelope'));
                }

                if ($envelope->getStatus() > FileEntity::STATUS_DRAFT) {
                        throw new LibresignException($this->l10n->t('Cannot add files to an envelope that is already in signing process'));
                }

                $maxFiles = $this->getMaxFilesPerEnvelope();
                $currentCount = $this->fileMapper->countChildrenFiles($envelopeId);
                if ($currentCount >= $maxFiles) {
                        throw new LibresignException(
                                $this->l10n->t('Maximum number of files per envelope (%s) exceeded', [$maxFiles])
                        );
                }

                $file->setParentFileId($envelopeId);
                $file->setNodeTypeEnum(NodeType::FILE);

                return $this->fileMapper->update($file);
        }

        public function getEnvelopeByFileId(int $fileId): ?FileEntity {
                try {
                        return $this->fileMapper->getParentEnvelope($fileId);
                } catch (DoesNotExistException) {
                        return null;
                }
        }

        private function getMaxFilesPerEnvelope(): int {
                return $this->appConfig->getValueInt(Application::APP_ID, 'envelope_max_files', 50);
        }
}

1	<?php
2
3	declare(strict_types=1);
4	/**
5	* SPDX-FileCopyrightText: 2025 LibreCode coop and contributors
6	* SPDX-License-Identifier: AGPL-3.0-or-later
7	*/
8
9	namespace OCA\Libresign\Service;
10
11	use DateTime;
12	use OCA\Libresign\AppInfo\Application;
13	use OCA\Libresign\Db\File as FileEntity;
14	use OCA\Libresign\Db\FileMapper;
15	use OCA\Libresign\Enum\NodeType;
16	use OCA\Libresign\Exception\LibresignException;
17	use OCP\AppFramework\Db\DoesNotExistException;
18	use OCP\IAppConfig;
19	use OCP\IL10N;
20	use Sabre\DAV\UUIDUtil;
21
22	class EnvelopeService {
23	public function __construct(
24	protected FileMapper $fileMapper,
25	protected IL10N $l10n,
26	protected IAppConfig $appConfig,
27	protected FolderService $folderService,
28	) {
29	}	50✔
30
31	public function isEnabled(): bool {
NEW 32	return $this->appConfig->getValueBool(Application::APP_ID, 'envelope_enabled', true);	×
33	}
34
35	/**
36	* @throws LibresignException
37	*/
38	public function validateEnvelopeConstraints(int $fileCount): void {
NEW 39	if (!$this->isEnabled()) {	×
NEW 40	throw new LibresignException($this->l10n->t('Envelope feature is disabled'));	×
41	}
42
NEW 43	$maxFiles = $this->getMaxFilesPerEnvelope();	×
NEW 44	if ($fileCount > $maxFiles) {	×
NEW 45	throw new LibresignException(	×
NEW 46	$this->l10n->t('Maximum number of files per envelope (%s) exceeded', [$maxFiles])	×
NEW 47	);	×
48	}
49	}
50
51	public function createEnvelope(string $name, ?string $userId = null): FileEntity {
52	if ($userId) {	2✔
NEW 53	$this->folderService->setUserId($userId);	×
54	}
55	$parentFolder = $this->folderService->getFolder();	2✔
56
57	$folderName = $name . '_' . substr(UUIDUtil::getUUID(), 0, 8);	2✔
58	$envelopeFolder = $parentFolder->newFolder($folderName);	2✔
59
60	$envelope = new FileEntity();	2✔
61	$envelope->setNodeId($envelopeFolder->getId());	2✔
62	$envelope->setNodeTypeEnum(NodeType::ENVELOPE);	2✔
63	$envelope->setName($name);	2✔
64	$envelope->setUuid(UUIDUtil::getUUID());	2✔
65	$envelope->setCreatedAt(new DateTime());	2✔
66	$envelope->setStatus(FileEntity::STATUS_DRAFT);	2✔
67
68	if ($userId) {	2✔
NEW 69	$envelope->setUserId($userId);	×
70	}
71
72	return $this->fileMapper->insert($envelope);	2✔
73	}
74
75	public function addFileToEnvelope(int $envelopeId, FileEntity $file): FileEntity {
76	$envelope = $this->fileMapper->getById($envelopeId);	5✔
77
78	if (!$envelope->isEnvelope()) {	5✔
79	throw new LibresignException($this->l10n->t('The specified ID is not an envelope'));	1✔
80	}
81
82	if ($envelope->getStatus() > FileEntity::STATUS_DRAFT) {	4✔
83	throw new LibresignException($this->l10n->t('Cannot add files to an envelope that is already in signing process'));	1✔
84	}
85
86	$maxFiles = $this->getMaxFilesPerEnvelope();	3✔
87	$currentCount = $this->fileMapper->countChildrenFiles($envelopeId);	3✔
88	if ($currentCount >= $maxFiles) {	3✔
89	throw new LibresignException(	1✔
90	$this->l10n->t('Maximum number of files per envelope (%s) exceeded', [$maxFiles])	1✔
91	);	1✔
92	}
93
94	$file->setParentFileId($envelopeId);	2✔
95	$file->setNodeTypeEnum(NodeType::FILE);	2✔
96
97	return $this->fileMapper->update($file);	2✔
98	}
99
100	public function getEnvelopeByFileId(int $fileId): ?FileEntity {
101	try {
102	return $this->fileMapper->getParentEnvelope($fileId);	2✔
103	} catch (DoesNotExistException) {	1✔
104	return null;	1✔
105	}
106	}
107
108	private function getMaxFilesPerEnvelope(): int {
109	return $this->appConfig->getValueInt(Application::APP_ID, 'envelope_max_files', 50);	3✔
110	}
111	}

LibreSign / libresign / 20395868261

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous