Commit Graph

23446 Commits

Author SHA1 Message Date
Pascal Bleser
a115679f3d 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-06-16 16:51:37 +02:00
Pascal Bleser
38f7e24947 structs: add tests and documentation 2026-06-16 16:51:37 +02:00
Pascal Bleser
dac4a48719 groupware: add endpoints to patch addressbooks, contacts, calendars, events 2026-06-16 16:51:37 +02:00
Pascal Bleser
56e11c3ee4 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-06-16 16:51:37 +02:00
Pascal Bleser
2023cdf444 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-06-16 16:51:37 +02:00
Pascal Bleser
83e9953df6 groupware: refactor for conciseness
* introduce jmap.Context to hold multiple parameters and shorten
   function calls

 * introduce SearchResultsTemplate
2026-06-16 16:51:37 +02:00
Pascal Bleser
6e2eea65b2 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-06-16 16:51:37 +02:00
Pascal Bleser
b77cbe3dbc 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-06-16 16:51:37 +02:00
Pascal Bleser
89fee977c8 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-06-16 16:51:37 +02:00
Pascal Bleser
39e9e6d53b groupware: add GetIdentityChanges 2026-06-16 16:51:37 +02:00
Pascal Bleser
9e391c103d groupware: bump @redocly/cli 2.24.0 -> 2.25.2 2026-06-16 16:51:37 +02:00
Pascal Bleser
6ef5988f30 groupware: add changes support for quotas, identities, submissions 2026-06-16 16:51:37 +02:00
Pascal Bleser
a49b0e239e groupware: framework refactorings + add support for /changes + add /objects 2026-06-16 16:51:37 +02:00
Pascal Bleser
4a2f9463e4 groupware: pollute code with NOSONAR comments, and make a little more use of JMAP API templates 2026-06-16 16:51:37 +02:00
Pascal Bleser
99eb9bfb57 groupware: docs: add a quick copy-pastable block for running ldapsearch 2026-06-16 16:51:37 +02:00
Pascal Bleser
65579abd12 groupware: upgrade redocly to 2.24.0 2026-06-16 16:51:37 +02:00
Pascal Bleser
c87cbf0291 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-06-16 16:51:37 +02:00
Pascal Bleser
b3819eff86 groupware: upgrade redocly/cli 2.20.0 -> 2.24.0 2026-06-16 16:51:37 +02:00
Pascal Bleser
ee502a2395 groupware: add web frontend settings to the vscode launcher 2026-06-16 16:51:37 +02:00
Pascal Bleser
10747d57f9 groupware: clarify the ContactCard situation 2026-06-16 16:51:37 +02:00
Pascal Bleser
4a8182d45d groupware: add contact sorting query parameter and fix default sorting (must use updated instead of name) 2026-06-16 16:51:37 +02:00
Pascal Bleser
f5660fd0a6 groupware: documentation: more calendar examples 2026-06-16 16:51:37 +02:00
Pascal Bleser
cf29107524 groupware: sort contacts in addressbook by name 2026-06-16 16:51:37 +02:00
Pascal Bleser
b3373a85dc (chore) groupware: tests/groupware: upgrade dependencies 2026-06-16 16:51:37 +02:00
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
eec74f95d4 groupware: devtools: add email encryption settings to idmldap.toml 2026-06-16 16:51:36 +02:00
Pascal Bleser
50d6384e4d groupware: upgrade redocly/cli 2.15.1 -> 2.20.2 2026-06-16 16:51:36 +02:00
Pascal Bleser
8adbfebe7f groupware: use master auth in launcher 2026-06-16 16:51:36 +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
33f3f6cfec groupware: upgrade Stalwart image in opencloud_full 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
36931987ec groupware: minor logging improvements to the session cache 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
540f063923 groupware: use the OIDC client ID 'web' instead of 'groupware' 2026-06-16 16:50:52 +02:00
Pascal Bleser
62589d0ca0 groupware: add STALWART_AUTH_DIRECTORY variable to .env 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
e0a0b7d3eb groupware: update DEVELOPERS.md based on Jörn's feedback 2026-06-16 16:50:52 +02:00
Pascal Bleser
5dfc386ed9 auth-api: deal with errors properly in NewService 2026-06-16 16:50:52 +02:00
Pascal Bleser
30e2e9ca36 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-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
c404a58557 groupware: bump redocly/cli from 2.14.6 to 2.15.1 2026-06-16 16:50:52 +02:00
Pascal Bleser
65ec598030 groupware: also update DEVELOPER.md with new OpenAPI documentation generation tooling 2026-06-16 16:50:52 +02:00
Pascal Bleser
29c1e4e8b2 groupware: update README to new API documentation generation process, and remove defunct files 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
f5cbda1a66 groupware: change Makefile to use groupware-apidocs instead of go-swagger 2026-06-16 16:50:52 +02:00
Pascal Bleser
9ea44cb5ce update redocly 2.14.5 -> 2.14.6 2026-06-16 16:50:52 +02:00
Pascal Bleser
6b396ce90b groupware: migrate to cobra instead of urfave 2026-06-16 16:50:52 +02:00
Pascal Bleser
9c57b8dcde groupware: update pnpm 10.28.0 -> 10.28.1 2026-06-16 16:50:52 +02:00