Commit Graph

95 Commits

Author SHA1 Message Date
Pascal Bleser
0bed356966 groupware: fix typos and minor issues
- fix a bunch of minor issues and typos that were found using GoLand
   and gosec

 - add a gosec Makefile target for Groupware related files, in
   services/groupware/Makefile

 - enable checking JMAP session capabilities for events and contacts,
   and only enable skipping that check for tasks until those are
   implemented in Stalwart as well

 - fix a CWE-190 (integer overflow or wraparound) found by gosec

 - consistently use struct references for methods of Groupware and
   Request, instead of mixing up references and copies

 - always log errors when unable to register a Prometheus metric
2026-06-16 16:51:37 +02:00
Pascal Bleser
a1ac3ebcf3 groupware: upgrade Stalwart image in integration tests from 0.15.0 to 0.15.5 2026-06-16 16:51:36 +02:00
Pascal Bleser
d1aa3025d8 groupware: add UI example of a ContactCard to the documented examples 2026-06-16 16:51:36 +02:00
Pascal Bleser
6b8f7207d6 groupware: add OIDC authentication support between Groupware backend and Stalwart
* re-implement the auth-api service to authenticate Reva tokens
   following the OIDC Userinfo endpoint specification

 * pass the context where necessary and add an authenticator interface
   to the JMAP HTTP driver, in order to select between master
   authentication (which is used when GROUPWARE_JMAP_MASTER_USERNAME and
   GROUPWARE_JMAP_MASTER_PASSWORD are both set) and OIDC token
   forwarding through bearer auth

 * add Stalwart directory configuration "idmoidc" which uses the
   OpenCloud auth-api service API (/auth/) to validate the token it
   received as bearer auth from the Groupware backend's JMAP client,
   using it as an OIDC Userinfo endpoint

 * implement optional additional shared secret to secure the Userinfo
   service, as an additional path parameter
2026-06-16 16:51:35 +02:00
Pascal Bleser
8244e4b22f groupware: remove remnants of go-swagger documentation, since we are switching to using our own tool instead 2026-06-16 16:50:52 +02:00
Pascal Bleser
984a15f379 groupware: add jscontact examples, and move them to jmap/model_examples.go to avoid dependency recursion 2026-06-16 16:50:52 +02:00
Pascal Bleser
124ed20e13 groupware: as suggested in the review PR 1994, remove all filename prefixes that match the package (groupware_xyz.go -> xyz.go), for groupware, jmap, jscontact, jscalendar 2026-06-16 16:50:52 +02:00
Pascal Bleser
6fdc4a830d groupware: convert documentation to proper markdown 2026-06-16 16:50:52 +02:00
Pascal Bleser
48b00db7a7 groupware: more API examples 2026-06-16 16:50:52 +02:00
Pascal Bleser
ef7b1d4a72 API documentation changes for groupware-apidocs
* add example generator infrastructure, with some examples for pkg/jmap
   and pkg/groupware, with more needing to be done

 * alter the apidoc Makefile to stop using go-swagger but, instead, use
   the openapi.yml file that must be dropped into that directory using
   groupware-apidocs (will improve the integration there later)

 * add Makefile target to generate examples

 * bump redocly from 2.4.0 to 2.14.5

 * introduce Request.PathParam() and .PathParamDoc() to improve API
   documentation, as well as future-proofing

 * improve X-Request-ID and Trace-Id header handling in the middleware
   by logging it safely when an error occurs in the middleware
2026-06-16 16:50:11 +02:00
Pascal Bleser
7ee2cc2e91 groupware: update to Stalwart 0.15.0 2026-06-16 16:50:11 +02:00
Pascal Bleser
c5e67d7d6f groupware: improve email submission and testing
* jmap/EmailCreate: add more attributes that were omitted: Headers,
   InReplyTo, References, Sender

 * add jmap GetEmailSubmissionStatus

 * improve email integration tests by adding a thorough test for email
   submission

 * jmap integration tests: provision principals and domains using the
   Stalwart Management API, switching from an in-memory to an internal
   directory
2026-06-16 16:50:11 +02:00
Pascal Bleser
531e913ca4 groupware: add retrieving and adding mailboxIds for drafts and sent if they are missing 2026-06-16 16:50:11 +02:00
Pascal Bleser
f45d2d5a70 groupware: WS push improvements, add getting email changes to WS integration test 2026-06-16 16:50:11 +02:00
Pascal Bleser
135bc066ae groupware: JMAP WS push notifications support 2026-06-16 16:50:11 +02:00
Pascal Bleser
66b86af3c7 groupware: fix email summaries and allow negative offsets
* fix a bug in how email summaries are flattened across multiple
   accounts, which was previous resulting in empty email objects

 * allow negative offset in email pagination

 * make all /emails endpoints return emails without bodies
2026-06-16 16:50:11 +02:00
Pascal Bleser
6eff50009c groupware: feature test improvements and upgrade to Stalwart 0.14.1
* upgrade Stalwart image for devtools/full to 0.14.1

 * re-assert which features are implemented or not in 0.14.1

 * refactor the integration tests yet again to make it clearer and
   easier to see those "features-or-not"

 * get rid of old tests that are now better covered by integration tests

 * rewrite how we compare expected and actual objects in integration
   tests, finally having found a way to ignore the @type attribute
   properly instead of having to mutate all objects to remove it
2026-06-16 16:50:11 +02:00
Pascal Bleser
941ef9358c groupware: finalize JMAP events integration test, with multiple changes to the model to conform with draft-ietf-calext-jscalendarbis-10 and fields that are currently not implemented in Stalwart 2026-06-16 16:50:11 +02:00
Pascal Bleser
1e307d956a groupware: refactor the JMAP integration tests 2026-06-16 16:50:11 +02:00
Pascal Bleser
dc060bb639 groupware: improve JMAP ContactCard integration tests 2026-06-16 16:50:11 +02:00
Pascal Bleser
b06fe2d402 groupware: improve JMAP integration tests for ContactCards 2026-06-16 16:50:11 +02:00
Pascal Bleser
d1d1015d6f groupware: fix recently introduced error with UploadedBlob with and without a sha512 2026-06-16 16:50:11 +02:00
Pascal Bleser
4266a45b4c groupware: fix blob uploading metadata and add 'POST /blobs' route 2026-06-16 16:50:11 +02:00
Pascal Bleser
b4ac0add53 groupware: add getting a contact by ID + add integration tests for contacts 2026-06-16 16:50:11 +02:00
Pascal Bleser
8f935e9fe8 groupware: improved integration test for email, fixed two bugs 2026-06-16 16:50:11 +02:00
Pascal Bleser
2797020ea4 groupware: fix deserialization of Event Alert Trigger types using mapstructure 2026-06-16 16:50:11 +02:00
Pascal Bleser
2e048092d1 groupware: add real calendars and events 2026-06-16 16:50:11 +02:00
Pascal Bleser
96f1f961e3 groupware: implement/fix email submission 2026-06-16 16:50:11 +02:00
Pascal Bleser
41845f299d groupware: implement Mailbox modification endpoints + refactor ETag/state in the framework
* add endpoints for Mailboxes:
   - PATCH mailboxes/{id}
   - DELETE mailboxes/{id}
   - POST mailboxes

 * refactor the pkg/jmap and groupware framework to systematically
   return a jmap.State out-of-band of the per-method payloads, since
   they are almost always present in JMAP responses, which lead to the
   artificial creation of a lot of composed struct types just to also
   return the State; on the downside, it adds yet another return
   parameter
2026-06-16 16:50:11 +02:00
Pascal Bleser
e317c37fdf groupware: add ical blob parsing endpoint 2026-06-16 16:50:11 +02:00
Pascal Bleser
1e0de30c07 groupware: add Mailbox sorting 2026-06-16 16:50:11 +02:00
Pascal Bleser
d1c2f42975 groupware: jmap: fix id -> blobId attribute when uploading a blob 2026-06-16 16:50:11 +02:00
Pascal Bleser
a54858e447 groupware: fix creating contacts 2026-06-16 16:50:10 +02:00
Pascal Bleser
29deb39a3c groupware: actually add total and limit to the email summary endpoint 2026-06-16 16:50:10 +02:00
Pascal Bleser
85ca7d64f9 groupware: fix compilation in tests after recent changes 2026-06-16 16:50:10 +02:00
Pascal Bleser
73293929f1 groupware: add missing total,limit,offset attributes in the QueryEmailsSummaries response 2026-06-16 16:50:10 +02:00
Pascal Bleser
5b52cf5567 groupware: add threadCount to /groupware/accounts/{accountId}/mailboxes/{mailboxId}/emails 2026-06-16 16:50:10 +02:00
Pascal Bleser
ae0e2392f2 groupware: add ContactCard operations 2026-06-16 16:50:10 +02:00
Pascal Bleser
08cbfec5a9 groupware: add threadSize in email-by-id response 2026-06-16 16:50:10 +02:00
Pascal Bleser
e066dd8a6a groupware: introduce constants for Email property names, see EmailSummaryProperties 2026-06-16 16:50:10 +02:00
Pascal Bleser
c4d1a1540f groupware: fix keyword patching syntax for markAsSeen=true 2026-06-16 16:50:10 +02:00
Pascal Bleser
112c49e162 groupware: add threadSize property in the email summary endpoint 2026-06-16 16:50:10 +02:00
Pascal Bleser
79d0c1e1d7 groupware: add markAsSeen=true to mark an email as $seen before it is
retrieved
2026-06-16 16:50:10 +02:00
Pascal Bleser
dea3496275 groupware: add searching emails by their Message-Id + retrieving an email by its ID as message/rfc822 2026-06-16 16:50:10 +02:00
Pascal Bleser
82923c88dd groupware: add identity deletion 2026-06-16 16:49:44 +02:00
Pascal Bleser
92dff35a21 groupware:
* made several email related operations multi-account:
   QueryEmailSnippets, QueryEmails, QueryEmailsWithSnippets

 * add GetIdentitiesForAllAccounts

 * add GetEmailsForAllAccounts

 * jmap: add CreateIdentity, UpdateIdentity; groupware: add
   GetIdentityById, AddIdentity, ModifyIdentity

 * add temporary workaround until Calendars, Tasks, Contacts are
   implemented in Stalwart when determining the default account for
   those: use the mail one in the mean time
2026-06-16 16:49:44 +02:00
Pascal Bleser
601be19976 groupware: jmap: don't collpase threads when searching for emails, and add dumping of JMAP request payloads when trace logging is enabled 2026-06-16 16:49:44 +02:00
Pascal Bleser
8f64806c98 jmap: add GetInboxNameForMultipleAccounts 2026-06-16 16:49:44 +02:00
Pascal Bleser
ff393b7878 jmap: fix Email/set 2026-06-16 16:49:44 +02:00
Pascal Bleser
a0b88c0ad1 groupware: improve jmap integration tests
* use gofakeit instead of loremipsum, as it can also fake images for
   attachments

 * random emails for testing: generate threads, add attachments
2026-06-16 16:49:43 +02:00