Commit Graph

13 Commits

Author SHA1 Message Date
Pascal Bleser
0cbf4b7287 groupware: refactor responses to a jmap.Response object
* in the JMAP API as well as in several places in the Groupware
   framework, use a single jmap.Response[T] object to return the
   payload, the language, the session state and the etag/state instead
   of individual multi-valued return values
2026-04-30 10:51:45 +02:00
Pascal Bleser
b63b0b3f28 groupware: add support for anchor and anchor offset pagination
* add query parameters 'anchor' and 'offset':
   - anchor is an object identifier
   - offset is a numeric offset relative to the anchor
2026-04-30 10:51:45 +02:00
Pascal Bleser
d88a68d1cb groupware: fix use of ?limit=0
* JMAP query limit of 0 is synonymous with "no limit", but we actually
   want to be able to perform queries without any results, for cases
   where we only want to count the total number of objects, and also
   because it makes more sense semantically

 * introduce query parameter validation checks, in order to only allow
   query parameters that are actually supported, which is going to be
   useful during development of clients
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
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
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
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
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