Commit Graph

4657 Commits

Author SHA1 Message Date
Pascal Bleser
6e2dc1d18d groupware: improve email sanitization by using the mime package to parse the part type, in order to recognize HTML ones that need sanitization 2026-06-16 16:50:10 +02:00
Pascal Bleser
81382655f6 groupware: add headers Unmatched-Path and Unsupported-Method to make
development of the web UI easier
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
a880152912 groupware: add the Retry-After header in responses when the session cannot be 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
b243a38d2c groupware: add email HTML sanitization
* sanitize email text/html body parts using bluemonday

 * deps(groupware):
   - new dependency: github.com/microcosm-cc/bluemonday
   - transitive dependencies:
     - github.com/aymerick/douceur
     - github.com/gorilla/css
2026-06-16 16:50:09 +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
da2743de95 groupware: add instructions for using stalwart-admin 2026-06-16 16:49:44 +02:00
Pascal Bleser
79d9c3af18 groupware: fix NPE when one of the accounts is a group account 2026-06-16 16:49:44 +02:00
Pascal Bleser
bfde4c5926 groupware: DEVELOPER.md: add note explaining LDAPTLS_REQCERT 2026-06-16 16:49:44 +02:00
Pascal Bleser
0d5fce0a36 groupware: accept both '_' and '*' as the 'default account' placeholder 2026-06-16 16:49:44 +02:00
Pascal Bleser
fe78e837ce groupware: DEVELOPER.md: explain how to set a quota on a user using the Stalwart management API 2026-06-16 16:49:44 +02:00
Pascal Bleser
a8fbb38a19 groupware: add Mermaid diagrams to describe the two setup options 2026-06-16 16:49:44 +02:00
Pascal Bleser
54a421449a groupware: implement email updating and email keyword updating endpoints 2026-06-16 16:49:44 +02:00
Pascal Bleser
a4949fc021 docs(groupware): upgrade @redocly/cli 2.3.1 -> 2.4.0 2026-06-16 16:49:44 +02:00
Pascal Bleser
3e3cdbce0f groupware: further updates to make everything work with the builtin LDAP and OIDC 2026-06-16 16:49:44 +02:00
Pascal Bleser
51219c69bf groupware: for /accounts/all/emails/latest/summary, rename the ?unread query parameter into ?seen as that is more intuitive 2026-06-16 16:49:43 +02:00
Pascal Bleser
e9a131a4d7 groupware: make everything also work with the built-in LDAP and IDP 2026-06-16 16:49:43 +02:00
Pascal Bleser
14ab0b861b groupware: update @redocly/cli from 2.3.0 to 2.3.1 2026-06-16 16:49:43 +02:00
Pascal Bleser
e982755cfa docs(groupware): fix basepath in OpenAPI, /groupware instead of /groupware/groupware 2026-06-16 16:49:43 +02:00
Viktor Scharf
067ec169ad fixed connection reset issue. adapted make file to generate swagger docs on mac 2026-06-16 16:49:43 +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
Pascal Bleser
908bf9fc07 groupware: add bootstrapping on / with quotas for all accounts 2026-06-16 16:49:43 +02:00
Pascal Bleser
8a42e20c74 groupware: add /quota for all accounts 2026-06-16 16:49:43 +02:00
Pascal Bleser
08c3f71b12 groupware: improve instructions in DEVELOPER.md 2026-06-16 16:49:43 +02:00
Pascal Bleser
f4aa170af6 groupware: update @redocly/cli: 2.2.2 -> 2.3.0 2026-06-16 16:49:43 +02:00
Pascal Bleser
08f7ec6700 groupware: add quota API + add support for Accept-Language and Content-Language 2026-06-16 16:49:43 +02:00
Pascal Bleser
f582f09121 groupware: minor improvements to the DEVELOPER.md 2026-06-16 16:49:43 +02:00
Pascal Bleser
f64e0799b2 groupware: add flag to currently ignore session capability checks for calendars, contacts and tasks, as those are not implemented in Stalwart yet; will need to remove it in the future 2026-06-16 16:49:43 +02:00
Pascal Bleser
f47d31e4b0 groupware: add JMAP capability checking (in part: for contacts, calendars, tasks) 2026-06-16 16:49:43 +02:00
Pascal Bleser
9e318e898b /auth: add SkipXAccessToken:true 2026-06-16 16:49:43 +02:00
Pascal Bleser
aad36825c8 groupware: add mock endpoints for tasklists and tasks 2026-06-16 16:49:43 +02:00
Pascal Bleser
2a37612230 groupware: implement JMAP Task specification 2026-06-16 16:49:43 +02:00
Pascal Bleser
052de5293f groupware: more mock data, added missing JMAP types 2026-06-16 16:49:43 +02:00
Pascal Bleser
e6cf66aac8 groupware: add mock endpoints for addressbooks and contacts 2026-06-16 16:49:43 +02:00
Pascal Bleser
30742044ad services/groupware/DEVELOPER.md: adapt to new path for the opencloud_full deployment 2026-06-16 16:49:43 +02:00
Pascal Bleser
1ab16c996a Docker Compose Groupware improvements
* made a few changes in order to further simplify the setup for
   developers of the Groupware backend

 * add STALWART_DOMAIN to deployments/examples/opencloud_full/.env

 * adapt the Stalwart configuration file to not set server.hostname and,
   instead, pick it up from /etc/hostname, which is set by Docker
   Compose as we can use default values for STALWART_DOMAIN there, in an
   analogous fashion to the other containers in that project

 * add config/keycloak/clients/groupware.json to avoid requiring manual
   configuration of Keycloak via the admin web UI

 * Stalwart container:
   - listen for SMTPS on :1465
   - remove the stalwart-logs volume, not needed (logs are going to
     stdout)

 * updated services/groupware/DEVELOPER.md:
   - refer to a variable OCDIR to make instructions more copy-pasteable
   - remove manual Keycloak configuration section as it is now obsolete,
     replaced by provisioning a configuration file instead
2026-06-16 16:49:43 +02:00
Pascal Bleser
335b46e502 start websocket implementation, add endpoint for email summaries
* feat(groupware): start implementing JMAP websocket support for push
   notifications (unfinished)

 * groupware: add GetLatestEmailsSummaryForAllAccounts

 * add new vendored dependency: github.com/gorilla/websocket

 * jmap: add QueryEmailSummaries

 * openapi: start adding examples

 * openapi: add new tooling for api-examples.yaml injection

 * apidoc-process.ts: make it more typescript-y

 * bump @redocly/cli from 2.0.8 to latest 2.2.0
2026-06-16 16:49:43 +02:00
Pascal Bleser
44ac15ec16 refactor(groupware): just use a function for the attachment picker
Minor: be more Go idiomatic: just use a function to pick the attachment
from an Email's attachment list instead of using an interface with
multiple iplementation structs.
2026-06-16 16:49:43 +02:00
Pascal Bleser
95c8245c64 groupware: improved attachment APIs
* feat(groupware): add /accounts/{}/emails/{}/attachments

 * feat(groupware): add
   /accounts/{}/emails/{}/attachments?partId=&name=&blobId=
2026-06-16 16:49:43 +02:00
Pascal Bleser
e4602bcc14 fix(groupware): update DEVELOPER.md imap-filler usage since it was updated to use flags instead of environment variables 2026-06-16 16:49:43 +02:00
Pascal Bleser
183549cf09 docs(groupware): more developer instructions 2026-06-16 16:49:43 +02:00
Pascal Bleser
d93b5e963b more updates to the Groupware DEVELOPER.md 2026-06-16 16:49:43 +02:00
Pascal Bleser
379cabe124 docs(groupware): add configuration instructions to DEVELOPER.md 2026-06-16 16:49:43 +02:00
Pascal Bleser
4d66106d43 fix(groupware): fix JMAP error handling
* the JMAP error handling was not working properly, fixed it and added
   error definitions accordingly

 * add operations to retrieve mailbox roles and mailboxes by role for
   all accounts
2026-06-16 16:49:43 +02:00
Pascal Bleser
47125a356d refactor(groupware): rename "Messages" to "Email" everywhere
There was really no reason to go with "Messages" as far as the
vocabulary of the Groupware API goes, since the objects those APIs serve
are "Emails", to stick with the wording of the JMAP specification.
2026-06-16 16:49:43 +02:00
Pascal Bleser
2f3037f6d6 docs(groupware): add services/groupware/DEVELOPER.md 2026-06-16 16:49:43 +02:00
Pascal Bleser
fabfc60f36 groupware: minor typo fixes 2026-06-16 16:49:43 +02:00
Pascal Bleser
4dd7d89d14 feat(groupware): add fetching all mailboxes for all accounts
* add URL to retrieve all the mailboxes for all the accounts of a user,
   as a first use-case for an all-accounts operation, as
   /accounts/all/mailboxes

 * add URL to retrieve mailbox changes for all the mailboxes of all the
   accounts of a user, as a first use-case for an all-accounts
   operation, as /accounts/all/mailboxes/changes

 * change the defaultAccountId from '*' to '_', as '*' rather indicates
   "all" than "default", and we might want to use that for "all
   accounts" operations in the future

 * refactor(groupware): remove the accountId parameter from the logger()
   function, as it is not used anyways, but also confusing for
   operations that support multiple account ids
2026-06-16 16:49:43 +02:00