Commit Graph

23188 Commits

Author SHA1 Message Date
Pascal Bleser
47f70283f2 groupware: fixes after rebasing and Docker library API changes 2026-04-30 10:51:45 +02:00
Pascal Bleser
8c41e41c9e groupware: documentation changes after API generator updates for the use of template functions 2026-04-30 10:51:45 +02:00
Pascal Bleser
2883f04488 groupware: refactoring using function templates
* adds creating addressbooks, calendars, mailboxes

 * adds deleting mailbox, event, identity

 * adds modifying an email

 * introduce template functions for the Groupware API in templates.go,
   and use those in route function implementations whenever possible

 * add capability checking for mail, quota, blobs

 * adds Changes interface

 * adds JmapResponse interface
2026-04-30 10:51:45 +02:00
Pascal Bleser
4bee5f01f5 structs: add tests and documentation 2026-04-30 10:51:45 +02:00
Pascal Bleser
0eb1d47b43 groupware: add endpoints to patch addressbooks, contacts, calendars, events 2026-04-30 10:51:45 +02:00
Pascal Bleser
c140b19d1e groupware: improve tests
* jmap: add UpdateContactCard and UpdateCalendarEvent funcs
 * use JSON marshalling and unmarshalling into a map for toPatch()
   implementations
 * add updating ContactCards and CalendarEvents to tests
 * add deleting ContactCards and CalendarEvents to tests
 * make query response totals work when the value is 0
 * tests: use CreateContactCard and CreateCalendarEvent funcs to create
   objects in tests instead of using a different JMAP stack that works
   with untyped maps
2026-04-30 10:51:45 +02:00
Pascal Bleser
82b308a5cb groupware: refactoring: pass object type instead of namespaces
* make the JMAP internal API a bit more future-proof by passing
   ObjectType objects instead of the JMAP namespaces

 * remove the new attempt to contain operations even further using the
   Factory objects

 * move CalendarEvent operations to its own file, like everything else

 * fix email tests

 * ignore WS error when closing an already closed connection
2026-04-30 10:51:45 +02:00
Pascal Bleser
ba367aa419 groupware: refactor for conciseness
* introduce jmap.Context to hold multiple parameters and shorten
   function calls

 * introduce SearchResultsTemplate
2026-04-30 10:51:45 +02:00
Pascal Bleser
7de3ec05a4 groupware: model refactoring, introducing typed interfaces and Foo
* move ContactCard from jscontact to jmap, as it is actually a JMAP
   specification item, but also was causing too many issues with
   circular references from jscontact -> jmap

 * introduce Foo, Idable, GetRequest, GetResponse, etc... types and
   generics

 * first attempt at a Foo factory type for Mailboxes, needs to be
   expanded to further minimize repetition

 * add more specialized template functions to avoid repetition

 * introduce ChangesTemplate[T] for *Changes structs
2026-04-30 10:51:45 +02:00
Pascal Bleser
67ec7a5547 groupware: significant refactorings of the JMAP framework, adding methods and more intelligence to the various request and response types to improve the use of template functions, reducing the risks of typos and copy/paste mistakes 2026-04-30 10:51:45 +02:00
Pascal Bleser
7d8e3ef1e8 groupware: add addressbook and calendar creation APIs
* add Groupware APIs for creating and deleting addressbooks

 * add Groupware APIs for creating and deleting calendars

 * add JMAP APIs for creating and deleting addressbooks, calendars

 * add JMAP APIs to retrieve Principals

 * fix API tagging

 * move addressbook JMAP APIs into its own file

 * move addressbook Groupware APIs into its own file
2026-04-30 10:51:45 +02:00
Pascal Bleser
f5a9c2235a groupware: add GetIdentityChanges 2026-04-30 10:51:45 +02:00
Pascal Bleser
995ab9f6cd groupware: bump @redocly/cli 2.24.0 -> 2.25.2 2026-04-30 10:51:45 +02:00
Pascal Bleser
98e1701c0a groupware: add changes support for quotas, identities, submissions 2026-04-30 10:51:45 +02:00
Pascal Bleser
0b984a8e2f groupware: framework refactorings + add support for /changes + add /objects 2026-04-30 10:51:45 +02:00
Pascal Bleser
4d9e402cfd groupware: pollute code with NOSONAR comments, and make a little more use of JMAP API templates 2026-04-30 10:51:45 +02:00
Pascal Bleser
8a9a7aebc6 groupware: docs: add a quick copy-pastable block for running ldapsearch 2026-04-30 10:51:45 +02:00
Pascal Bleser
ca7b42a158 groupware: upgrade redocly to 2.24.0 2026-04-30 10:51:45 +02:00
Pascal Bleser
c1f7bc2261 groupware: refactor contactcard changes, and Request framework
* implement ContactCard retrieval endpoint for syncing

 * re-implement that endpoint for Email too

 * fix the Mailbox changes endpoint to actually return changes about
   Mailboxes, and not about Emails

 * when querying the diff of Mailboxes without any prior state, return
   an error since the result is not what one would expect

 * introduce the 'changes' API tag and group

 * refactor the successful response functions to consistently return an
   object type and object state whenever possible

 * move the syncing endpoints under /accounts/*/changes/ for better
   clarity, e.g. /changes/emails instead of /emails/mailbox/*/changes
2026-04-30 10:51:45 +02:00
Pascal Bleser
aee6fb3a67 groupware: upgrade redocly/cli 2.20.0 -> 2.24.0 2026-04-30 10:51:45 +02:00
Pascal Bleser
95ed35fc2a groupware: add web frontend settings to the vscode launcher 2026-04-30 10:51:45 +02:00
Pascal Bleser
b12345068c groupware: clarify the ContactCard situation 2026-04-30 10:51:45 +02:00
Pascal Bleser
9f0cf5ef4d groupware: add contact sorting query parameter and fix default sorting (must use updated instead of name) 2026-04-30 10:51:45 +02:00
Pascal Bleser
a4dac96fbe groupware: documentation: more calendar examples 2026-04-30 10:51:44 +02:00
Pascal Bleser
a3de949e5e groupware: sort contacts in addressbook by name 2026-04-30 10:51:44 +02:00
Pascal Bleser
900954d5fb (chore) groupware: tests/groupware: upgrade dependencies 2026-04-30 10:51:44 +02:00
Pascal Bleser
549fc4642a 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-04-30 10:51:44 +02:00
Pascal Bleser
9a2d718851 groupware: devtools: add email encryption settings to idmldap.toml 2026-04-30 10:51:44 +02:00
Pascal Bleser
3eb400a204 groupware: upgrade redocly/cli 2.15.1 -> 2.20.2 2026-04-30 10:51:44 +02:00
Pascal Bleser
d645304d76 groupware: use master auth in launcher 2026-04-30 10:51:44 +02:00
Pascal Bleser
7e2e4f4597 groupware: upgrade Stalwart image in integration tests from 0.15.0 to 0.15.5 2026-04-30 10:51:44 +02:00
Pascal Bleser
a77c489ab3 groupware: upgrade Stalwart image in opencloud_full from 0.15.0 to 0.15.5 2026-04-30 10:51:44 +02:00
Pascal Bleser
7b0215e332 groupware: add UI example of a ContactCard to the documented examples 2026-04-30 10:51:44 +02:00
Pascal Bleser
199360ae41 groupware: minor logging improvements to the session cache 2026-04-30 10:51:44 +02:00
Pascal Bleser
c400949718 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-04-30 10:51:44 +02:00
Pascal Bleser
8ad3652ba2 groupware: remove remnants of go-swagger documentation, since we are switching to using our own tool instead 2026-04-30 10:51:44 +02:00
Pascal Bleser
8ba07def4c groupware: add jscontact examples, and move them to jmap/model_examples.go to avoid dependency recursion 2026-04-30 10:51:44 +02:00
Pascal Bleser
75f48fca59 groupware: use the OIDC client ID 'web' instead of 'groupware' 2026-04-30 10:51:44 +02:00
Pascal Bleser
5f17c63916 groupware: add STALWART_AUTH_DIRECTORY variable to .env 2026-04-30 10:51:44 +02:00
Pascal Bleser
700930c3a9 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-04-30 10:51:44 +02:00
Pascal Bleser
7df57c9ef1 groupware: update DEVELOPERS.md based on Jörn's feedback 2026-04-30 10:51:44 +02:00
Pascal Bleser
3e377694b2 auth-api: deal with errors properly in NewService 2026-04-30 10:51:44 +02:00
Pascal Bleser
af9d3418f0 groupware: set GROUPWARE_JMAP_BASE_URL to use the variable STALWART_DOMAIN, in order to make things work correctly when using the non-default value for STALWART_DOMAIN 2026-04-30 10:51:44 +02:00
Pascal Bleser
f57507fa98 groupware: convert documentation to proper markdown 2026-04-30 10:51:44 +02:00
Pascal Bleser
f91b944aca groupware: bump redocly/cli from 2.14.6 to 2.15.1 2026-04-30 10:51:44 +02:00
Pascal Bleser
4de09d2444 groupware: also update DEVELOPER.md with new OpenAPI documentation generation tooling 2026-04-30 10:51:44 +02:00
Pascal Bleser
f21aa4279f groupware: update README to new API documentation generation process, and remove defunct files 2026-04-30 10:51:44 +02:00
Pascal Bleser
8a3a6160f9 groupware: more API examples 2026-04-30 10:51:44 +02:00
Pascal Bleser
9f686657a3 groupware: change Makefile to use groupware-apidocs instead of go-swagger 2026-04-30 10:51:44 +02:00
Pascal Bleser
8444f9e088 update redocly 2.14.5 -> 2.14.6 2026-04-30 10:51:44 +02:00