Commit Graph

18 Commits

Author SHA1 Message Date
Pascal Bleser
df98358ddf groupware: swagger API documentation improvements
* add more documentation for properties

 * fixes after a bit of trial-and-error with go-swagger

 * fix email filter marshalling when there are no search criteria

 * introduce an apidoc.yml that contains Swagger data and is merged when
   generating the swagger.yml from sources
2026-02-27 14:46:42 +01:00
Pascal Bleser
ae1ceacbf5 Groupware improvements
* ensure that all the jmap responses contain the SessionState

 * implement missing errors that were marked as TODO

 * moved common functions from pkg/jmap and pkg/services/groupware to
   pkg/log and pkg/structs to commonalize them across both source trees

 * implement error handling for SetError occurences

 * Email: replace anonymous map[string]bool for mailbox rights with a
   MailboxRights struct, as the keys are well-defined, which allows for
   properly documenting them

 * introduce ObjectType as an "enum"

 * fix JSON marshalling and unmarshalling of EmailBodyStructure

 * move the swagger documentation structs from groupware_api.go to
   groupware_docs.go

 * fix: change verb for /groupware/accounts/*/vacation from POST to PUT
2026-02-27 14:46:42 +01:00
Pascal Bleser
bfbd2ce751 groupware: minor email searching response improvements + started implementing vacation response setting API 2026-02-27 14:46:42 +01:00
Pascal Bleser
8fe6d88420 groupware: add identities of all accounts to the index resource 2026-02-27 14:46:42 +01:00
Pascal Bleser
c6b18db02b groupware: fix email search, add variant that includes the full emails 2026-02-27 14:46:42 +01:00
Pascal Bleser
b339f62b33 Groupware: refactor jmap package, implement Email/set, EmailSubmission
* refactor the jmap package to split it into several files as the
   jmap.api.go file was becoming too unwieldy

 * refactor the Groupware handler function response to be a Response
   object, to be more future-proof and avoid adding more and more
   return parameters while handling "no content" response as well

 * more godoc for the JMAP model

 * add Email creation, updating, deleting (Email/set,
   EmailSubmission/set)

 * add endpoints
   - POST /accounts/{accountid}/messages
   - PATCH|PUT /accounts/{accountid}/messages/{messageid}
   - DELETE /accounts/{accountid}/messages/{messageid}
2026-02-27 14:46:42 +01:00
Pascal Bleser
a958ede3cc groupware: implement message search with snippets 2026-02-27 14:46:42 +01:00
Pascal Bleser
8d495c6482 groupware: blob streaming (upload and download) 2026-02-27 14:46:42 +01:00
Pascal Bleser
1cdfeb9209 groupware: more JMAP operations implementation 2026-02-27 14:46:42 +01:00
Pascal Bleser
7f3363d9f7 groupware: further implementation and improvements 2026-02-27 14:46:42 +01:00
Pascal Bleser
b397cd461e refactored the Session object, refactored the services/groupware directory, and started Swagger documentation implementation 2026-02-27 14:46:42 +01:00
Pascal Bleser
0ba962bda1 groupware: refactoring the API mechanisms 2026-02-27 14:46:42 +01:00
Pascal Bleser
1b5932da07 groupware: implement JSON:API's error response format, with a revamped error handling in jmap and services/groupware 2026-02-27 14:46:42 +01:00
Pascal Bleser
1b8f17439e Refactor groupware service after ADR decision on the Groupware API
* after having decided that the Groupware API should be a standalone
   independent custom REST API that is using JMAP data models as much as
   possible,
 * removed Groupware APIs from the Graph service
 * moved Groupware implementation to the Groupware service, and
   refactored a few things accordingly
2026-02-27 14:46:42 +01:00
Pascal Bleser
b830e24239 Groupware and jmap: cleanup and API documentation 2026-02-27 14:46:42 +01:00
Pascal Bleser
eca28fd996 Groupware improvements: refactoring, k6 tests
* refactored the models to be strongly typed with structs and mapstruct
   to decompose the dynamic parts of the JMAP payloads

 * externalized large JSON strings for tests into .json files under
   testdata/

 * added a couple of fantasy Graph groupware APIs to explore further
   options

 * added k6 scripts to test those graph/me/messages APIs, with a setup
   program to set up users in LDAP, fill their IMAP inbox, activate them
   in Stalwart, cleaning things up, etc...
2026-02-27 14:46:42 +01:00
Pascal Bleser
b09161cfcb groupware and jmap improvements and refactoring 2026-02-27 14:46:42 +01:00
Pascal Bleser
de4b154391 move services/groupware/pkg/jmap to pkg/jmap 2026-02-27 14:46:41 +01:00