plugins-nextcloud-mirror/libresign
1
0
Fork 0
mirror of https://github.com/LibreSign/libresign.git synced 2025-12-17 21:12:16 +01:00
Code Projects Releases Activity

feat: add signatureFlow parameter to PATCH endpoint

Browse source 
Add optional signatureFlow parameter to request-signature PATCH
endpoint. Updates OpenAPI specs and TypeScript types.

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
This commit is contained in:
Vitor Mattos 2025-12-17 02:03:37 -03:00
parent a0a58a0d8b
commit 8cf477fcbc
No known key found for this signature in database
GPG key ID: 6FECE2AD4809003A
5 changed files with 25 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
lib/Controller/RequestSignatureController.php
View file

@ -136,6 +136,7 @@ class RequestSignatureController extends AEnvironmentAwareController {
* @param LibresignVisibleElement[]|null $visibleElements Visible elements on document * @param LibresignVisibleElement[]|null $visibleElements Visible elements on document
* @param LibresignNewFile|array<empty>|null $file File object. * @param LibresignNewFile|array<empty>|null $file File object.
* @param integer|null $status Numeric code of status * 0 - no signers * 1 - signed * 2 - pending * @param integer|null $status Numeric code of status * 0 - no signers * 1 - signed * 2 - pending
* @param string|null $signatureFlow Signature flow mode: 'parallel' or 'ordered_numeric'. If not provided, uses global configuration
* @return DataResponse<Http::STATUS_OK, array{message: string, data: LibresignValidateFile}, array{}>|DataResponse<Http::STATUS_UNPROCESSABLE_ENTITY, array{message?: string, action?: integer, errors?: list<array{message: string, title?: string}>}, array{}> * @return DataResponse<Http::STATUS_OK, array{message: string, data: LibresignValidateFile}, array{}>|DataResponse<Http::STATUS_UNPROCESSABLE_ENTITY, array{message?: string, action?: integer, errors?: list<array{message: string, title?: string}>}, array{}>
* *
* 200: OK * 200: OK
@ -145,7 +146,14 @@ class RequestSignatureController extends AEnvironmentAwareController {
#[NoCSRFRequired] #[NoCSRFRequired]
#[RequireManager] #[RequireManager]
#[ApiRoute(verb: 'PATCH', url: '/api/{apiVersion}/request-signature', requirements: ['apiVersion' => '(v1)'])] #[ApiRoute(verb: 'PATCH', url: '/api/{apiVersion}/request-signature', requirements: ['apiVersion' => '(v1)'])]
public function updateSign(?array $users = [], ?string $uuid = null, ?array $visibleElements = null, ?array $file = [], ?int $status = null): DataResponse { public function updateSign(
?array $users = [],
?string $uuid = null,
?array $visibleElements = null,
?array $file = [],
?int $status = null,
?string $signatureFlow = null,
): DataResponse {
$user = $this->userSession->getUser(); $user = $this->userSession->getUser();
$data = [ $data = [
'uuid' => $uuid, 'uuid' => $uuid,
@ -153,7 +161,8 @@ class RequestSignatureController extends AEnvironmentAwareController {
'users' => $users, 'users' => $users,
'userManager' => $user, 'userManager' => $user,
'status' => $status, 'status' => $status,
'visibleElements' => $visibleElements 'visibleElements' => $visibleElements,
'signatureFlow' => $signatureFlow,
]; ];
try { try {
$this->validateHelper->validateExistingFile($data); $this->validateHelper->validateExistingFile($data);

5
openapi-full.json
View file

@ -6679,6 +6679,11 @@
"format": "int64", "format": "int64",
"nullable": true, "nullable": true,
"description": "Numeric code of status * 0 - no signers * 1 - signed * 2 - pending" "description": "Numeric code of status * 0 - no signers * 1 - signed * 2 - pending"
},
"signatureFlow": {
"type": "string",
"nullable": true,
"description": "Signature flow mode: 'parallel' or 'ordered_numeric'. If not provided, uses global configuration"
} }
} }
} }

5
openapi.json
View file

@ -6529,6 +6529,11 @@
"format": "int64", "format": "int64",
"nullable": true, "nullable": true,
"description": "Numeric code of status * 0 - no signers * 1 - signed * 2 - pending" "description": "Numeric code of status * 0 - no signers * 1 - signed * 2 - pending"
},
"signatureFlow": {
"type": "string",
"nullable": true,
"description": "Signature flow mode: 'parallel' or 'ordered_numeric'. If not provided, uses global configuration"
} }
} }
} }

2
src/types/openapi/openapi-full.ts
View file

@ -4106,6 +4106,8 @@ export interface operations {
* @description Numeric code of status * 0 - no signers * 1 - signed * 2 - pending * @description Numeric code of status * 0 - no signers * 1 - signed * 2 - pending
*/ */
status?: number | null; status?: number | null;
/** @description Signature flow mode: 'parallel' or 'ordered_numeric'. If not provided, uses global configuration */
signatureFlow?: string | null;
}; };
}; };
}; };

2
src/types/openapi/openapi.ts
View file

@ -3628,6 +3628,8 @@ export interface operations {
* @description Numeric code of status * 0 - no signers * 1 - signed * 2 - pending * @description Numeric code of status * 0 - no signers * 1 - signed * 2 - pending
*/ */
status?: number | null; status?: number | null;
/** @description Signature flow mode: 'parallel' or 'ordered_numeric'. If not provided, uses global configuration */
signatureFlow?: string | null;
}; };
}; };
}; };