fix: align OpenAPI contract and frontend to string-only signatureFlow by vitormattos · Pull Request #7668 · LibreSign/libresign

vitormattos · 2026-05-07T18:57:44Z

Summary

aligns API contract for signatureFlow to string enum values only (none, parallel, ordered_numeric)
fixes OpenAPI source definitions and regenerates OpenAPI JSON/TS artifacts
updates backend serializers/services to emit string values consistently
removes legacy numeric signatureFlow handling from frontend runtime code
updates frontend tests to reflect the new contract and keeps a negative test to reject numeric payloads

Validation

npm run ts:check
npm run test -- src/tests/services/validationDocument.spec.ts src/tests/components/Signers/Signers.spec.ts src/tests/components/Signers/Signer.spec.ts src/tests/components/RightSidebar/RequestSignatureTab.spec.ts src/tests/store/files.spec.ts src/tests/views/Validation.spec.ts

Notes

commits were split one-per-file and signed with DCO (-s)

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

…c.ts Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

…questSignatureTab.spec.ts Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

…spec.ts Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

….spec.ts Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

…mics Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

…ller.php Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

…llerTest.php Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

…oller.php Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

vitormattos added 25 commits May 7, 2026 15:57

fix: update lib/Controller/AdminController.php

ad28545

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update lib/ResponseDefinitions.php

008de5c

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update lib/Service/Crl/CrlService.php

b774479

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update lib/Service/File/FileDataAssembler.php

497b0a2

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update lib/Service/FileService.php

fb389a3

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update openapi-administration.json

01908aa

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update openapi-full.json

6e4ead4

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update openapi.json

77ff49a

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/components/RightSidebar/RequestSignatureTab.vue

bf0b27d

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/components/Signers/Signer.vue

dc5c6cb

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/components/Signers/Signers.vue

4363978

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/services/validationDocument.ts

2575b80

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/store/files.js

9746d21

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/tests/components/RightSidebar/RequestSignatureTab.spe…

ef42fb9

…c.ts Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/tests/components/Signers/Signer.spec.ts

e2c3281

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/tests/components/Signers/Signers.spec.ts

18d53a6

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/tests/components/validation/FileStatusList.spec.ts

b088adf

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/tests/components/validation/FileValidation.spec.ts

efac110

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/tests/services/validationDocument.spec.ts

ee43b23

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/tests/store/files.spec.ts

0622bb7

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/tests/views/Validation.spec.ts

aa82cf7

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/types/index.ts

a95d64f

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/types/openapi/openapi-administration.ts

2c2388d

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/types/openapi/openapi-full.ts

fe16844

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

fix: update src/types/openapi/openapi.ts

de9af0e

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

github-project-automation Bot added this to Roadmap May 7, 2026

github-project-automation Bot moved this to 0. Needs triage in Roadmap May 7, 2026

vitormattos added 3 commits May 7, 2026 15:58

test: clean structural issues in src/tests/components/RightSidebar/Re…

de82b2b

…questSignatureTab.spec.ts Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

test: clean structural issues in src/tests/components/Signers/Signer.…

78854ef

…spec.ts Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

test: clean structural issues in src/tests/components/Signers/Signers…

ea0f177

….spec.ts Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

vitormattos added 27 commits May 7, 2026 17:15

chore(openapi): update SignFileController.php

06da9e8

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): update AdminController.php

576cc46

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): update FileController.php

fdacf1a

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): update FileElementController.php

0fc0a08

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): update index.ts

ad784bf

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): update RequestSignatureTab.vue

f8bf8c5

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): update openapi.json

cafd691

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): update openapi-full.json

3119c89

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): update openapi-administration.json

2f9cfce

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): update openapi.ts

fda9bf8

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): update openapi-full.ts

dc84ccc

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): update openapi-administration.ts

09f1d8c

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): refine IdDocsController.php for sdk ergonomics

0d60f6f

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): refine RequestSignatureController.php for sdk ergonomics

30231e6

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): refine SignFileController.php for sdk ergonomics

f7ad9c1

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): refine SignatureElementsController.php for sdk ergono…

1751def

…mics Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): refine ResponseDefinitions.php for sdk ergonomics

65add64

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): refine SignerElementsService.php for sdk ergonomics

efe2309

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): refine openapi.json for sdk ergonomics

d84700f

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): refine openapi-full.json for sdk ergonomics

e4e324a

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): refine openapi.ts for sdk ergonomics

5755742

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

chore(openapi): refine openapi-full.ts for sdk ergonomics

97a7207

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

refactor(openapi): remove redundant wrapper in RequestSignatureContro…

1f310e2

…ller.php Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

refactor(openapi): remove redundant wrapper in RequestSignatureContro…

e217536

…llerTest.php Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

refactor(openapi): remove redundant wrapper in SignFileController.php

5ea7d99

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

refactor(openapi): remove redundant wrapper in IdDocsController.php

d4ccff4

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

refactor(openapi): remove redundant wrapper in SignatureElementsContr…

91dca6d

…oller.php Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

vitormattos merged commit 740073a into main May 8, 2026
76 checks passed

github-project-automation Bot moved this from 0. Needs triage to 4. to release in Roadmap May 8, 2026

vitormattos deleted the fix/openapi-signatureflow-structure branch May 8, 2026 12:09

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

fix: align OpenAPI contract and frontend to string-only signatureFlow#7668

fix: align OpenAPI contract and frontend to string-only signatureFlow#7668
vitormattos merged 76 commits intomainfrom
fix/openapi-signatureflow-structure

vitormattos commented May 7, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

vitormattos commented May 7, 2026

Summary

Validation

Notes

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant