Commit Graph

23004 Commits

Author SHA1 Message Date
Pascal Bleser
50d0cbe807 jmap: minor logging improvements 2026-04-30 10:51:41 +02:00
Pascal Bleser
30fe8e0022 groupware: improve metrics
* implement more metrics, in a more streamlined fashion

 * use concurrent-map to store SSE streams instead of a regular map with
   one big lock that will not scale when it grows, causing too much
   contention on that one lock

 * while testing error metrics, noticed a few bugs with error handling
   when Stalwart is down: fixed
2026-04-30 10:51:41 +02:00
Pascal Bleser
45771e28e1 groupware: jmap: add metrics 2026-04-30 10:51:41 +02:00
Pascal Bleser
a127c7d759 groupware: implement metrics
* implement a framework for metrics, with a few exemplary ones
2026-04-30 10:51:41 +02:00
Pascal Bleser
b83b8d4467 groupware: Etag handling
* implement correct Etag and If-None-Match handling, responding with
   304 Not Modified if they match

 * introduce SessionState and State string type aliases to ensure we are
   using the correct fields for those, respectively

 * extract the SessionState from the JMAP response bodies in the
   groupware framework instead of having to do that in every single
   groupware API

 * use uint instead of int in some places to clarify that the values are
   >= 0

 * trace-log how long a Session was held in cache before being evicted

 * add Trace-Id header handling: add to response when specified in
   request, and implement a custom request logger to include it as a
   field

 * implement a more compact trace-logging of all the methods and URIs
   that are served, to put them into a single log entry instead of
   creating one log entry for every URI
2026-04-30 10:51:41 +02:00
Pascal Bleser
e085c87928 groupware: initial related emails implementation with SSE 2026-04-30 10:51:41 +02:00
Pascal Bleser
0e8bbe7038 groupware: add /bootstrap
* add a GET /accounts/{a}/boostrap URI that delivers the same as GET /
   but also mailboxes for a given account, in case the UI remembers the
   last used account identifier, to avoid an additional roundtrip

 * streamline the use of simpleError()

 * add logging of errors at the calling site

 * add logging of evictions of Sessions from the cache

 * change default Session cache TTL to 5min instead of 30sec
2026-04-30 10:51:41 +02:00
Pascal Bleser
7af4a01de6 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-04-30 10:51:41 +02:00
Pascal Bleser
304bbe2fa6 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-04-30 10:51:41 +02:00
Pascal Bleser
92f35520d4 groupware: minor email searching response improvements + started implementing vacation response setting API 2026-04-30 10:51:41 +02:00
Pascal Bleser
9a5de81313 groupware: add identities of all accounts to the index resource 2026-04-30 10:51:41 +02:00
Pascal Bleser
ea63d75c60 groupware: fix email search, add variant that includes the full emails 2026-04-30 10:51:41 +02:00
Pascal Bleser
b1b60c0124 groupware: fix email search, add variant that includes the full emails 2026-04-30 10:51:40 +02:00
Pascal Bleser
4a0dac0d96 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-04-30 10:51:40 +02:00
Pascal Bleser
b200d7fedc groupware: implement message search with snippets 2026-04-30 10:51:40 +02:00
Pascal Bleser
3794008dc7 groupware: blob streaming (upload and download) 2026-04-30 10:51:40 +02:00
Pascal Bleser
d3354001b5 groupware: more JMAP operations implementation 2026-04-30 10:51:40 +02:00
Pascal Bleser
e65527b5df groupware: further implementation and improvements 2026-04-30 10:51:40 +02:00
Pascal Bleser
f9cf47a875 upgrade Stalwart to 0.13.2 2026-04-30 10:51:40 +02:00
Pascal Bleser
61aed94c50 refactored the Session object, refactored the services/groupware directory, and started Swagger documentation implementation 2026-04-30 10:51:40 +02:00
Pascal Bleser
ea91210c24 groupware: refactoring the API mechanisms 2026-04-30 10:51:40 +02:00
Pascal Bleser
26cbdb8f7e groupware: implement JSON:API's error response format, with a revamped error handling in jmap and services/groupware 2026-04-30 10:51:40 +02:00
Pascal Bleser
fc1994db2d 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-04-30 10:51:40 +02:00
Pascal Bleser
ad73661703 Groupware and jmap: cleanup and API documentation 2026-04-30 10:51:40 +02:00
Pascal Bleser
fabe4c9568 groupware: remove unneeded messages.go that was a remainder from an earlier implementation attempt, which also fixes compilation issues due to changes in main 2026-04-30 10:51:40 +02:00
Pascal Bleser
6c0074eff8 opencloud_full: upgrade Stalwart to 0.12.5, and use the ghcr.io container repository to avoid Hub limits 2026-04-30 10:51:40 +02:00
Pascal Bleser
75e04f8f68 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-04-30 10:51:40 +02:00
Pascal Bleser
3725bb1ee3 fix Stalwart LDAP configuration 2026-04-30 10:51:40 +02:00
Pascal Bleser
a990ef21d5 Use password policy overlay in LDAP and configure Stalwart to use it 2026-04-30 10:51:40 +02:00
Pascal Bleser
a247a362d4 upgrade Stalwart to 0.12.4 2026-04-30 10:51:40 +02:00
Pascal Bleser
1e6574199e groupware: removed debugging logs 2026-04-30 10:51:40 +02:00
Pascal Bleser
2e3896bb62 jwkset: remove debugging printlns 2026-04-30 10:51:40 +02:00
Pascal Bleser
f6603cf4f5 auth-api: fix: was missing newly introduced metrics 2026-04-30 10:51:40 +02:00
Pascal Bleser
0948c50931 groupware and jmap improvements and refactoring 2026-04-30 10:51:40 +02:00
Pascal Bleser
c9428e1cc0 upgrade Stalwart to 0.12 2026-04-30 10:51:40 +02:00
Pascal Bleser
ddf66200a9 minor corrections to the Stalwart configuration 2026-04-30 10:51:40 +02:00
Pascal Bleser
aff1fc87a0 Introduce a the auth-api service
* primitive implementation to demonstrate how it could work, still to
   be considered WIP at best

 * add new dependency: MicahParks/jwkset and MicahParks/keyfunc to
   retrieve the JWK set from KeyCloak to verify the signature of the
   JWTs sent as part of Bearer authentication in the /auth API

 * (minor) opencloud/.../service.go: clean up a logging statement that
   was introduced earlier to hunt down why the auth-api service was not
   being started
2026-04-30 10:51:40 +02:00
Pascal Bleser
de6708faf8 add an auth-api service to make an exemplary implementation of an external authentication API for third party services such as Stalwart 2026-04-30 10:51:40 +02:00
Pascal Bleser
7c1f491344 move services/groupware/pkg/jmap to pkg/jmap 2026-04-30 10:51:40 +02:00
Pascal Bleser
af597ad91d WIP: restructure the Jmap client, and implement the /me/messages Graph API endpoint with it 2026-04-30 10:51:40 +02:00
Pascal Bleser
08bb5a2bfa add an OIDC Directory to Stalwart, requires exposing Keycloak port 8080 directly to access the userinfo endpoint using HTTP since the certificates in traefik are self-signed and end up being rejected by Stalwart with no option to bypass the certificate check 2026-04-30 10:51:40 +02:00
Pascal Bleser
969d44f1bb rename Stalwart fallback admin username from 'admin' to 'mailadmin' since 'admin' exists as a regular user in LDAP and thus won't have access to the administration 2026-04-30 10:51:40 +02:00
Pascal Bleser
da6721f8e0 add missing routing for /groupware (currently unprotected for testing) 2026-04-30 10:51:40 +02:00
Pascal Bleser
a90f792caa WIP: initial implementation of the groupware service 2026-04-30 10:51:40 +02:00
Pascal Bleser
a80795081f Add Stalwart container to the opencloud_full deployment, using the OpenLDAP container as a directory for user authentication 2026-04-30 10:51:40 +02:00
opencloudeu
74eddf8825 [tx] updated from transifex 2026-04-30 00:03:01 +00:00
dependabot[bot]
ae92dd031d build(deps): bump go.opentelemetry.io/contrib/zpages
Bumps [go.opentelemetry.io/contrib/zpages](https://github.com/open-telemetry/opentelemetry-go-contrib) from 0.67.0 to 0.68.0.
- [Release notes](https://github.com/open-telemetry/opentelemetry-go-contrib/releases)
- [Changelog](https://github.com/open-telemetry/opentelemetry-go-contrib/blob/main/CHANGELOG.md)
- [Commits](https://github.com/open-telemetry/opentelemetry-go-contrib/compare/zpages/v0.67.0...zpages/v0.68.0)

---
updated-dependencies:
- dependency-name: go.opentelemetry.io/contrib/zpages
  dependency-version: 0.68.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-04-29 09:15:52 +02:00
dependabot[bot]
ac39d84747 build(deps): bump @types/node from 22.19.17 to 25.6.0 in /services/idp
Bumps [@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node) from 22.19.17 to 25.6.0.
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node)

---
updated-dependencies:
- dependency-name: "@types/node"
  dependency-version: 25.6.0
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-04-29 09:15:25 +02:00
opencloudeu
cd5905d0f8 [tx] updated from transifex 2026-04-29 00:03:00 +00:00
PC Kitty
d97217f22c Update github.com/gookit/goutil to v0.7.4 for FreeBSD compatibility
The goutil that OpenCloud currently uses is one version from the release that adds FreeBSD support, this now compiles successfully on FreeBSD.
2026-04-28 18:03:17 +02:00