Commit Graph

4 Commits

Author SHA1 Message Date
Pascal Bleser
b11ac4b90a groupware: update @redocly/cli: 2.2.2 -> 2.3.0 2026-01-22 09:42:22 +01:00
Pascal Bleser
d9878b38eb groupware: add mock endpoints for addressbooks and contacts 2026-01-22 09:42:22 +01:00
Pascal Bleser
6db8dd3956 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-01-22 09:42:22 +01:00
Pascal Bleser
0cce8f5df3 docs(groupware): OpenAPI improvements
* refactor some pkg/jmap and groupware methods to make more sense from
   an API point-of-view

 * add path parameter documentation, but automate it by injecting their
   definition into the OpenAPI YAML tree that is extracted from the
   source code using go-swagger as it is too cumbersome, repetitive and
   error-prine to document them in the source code; wrote a TypeScript
   file apidoc-process.ts to do so

 * add generating an offline HTML file for the OpenAPI documentation
   using redocly, and injecting a favicon into the resulting HTML; wrote
   a TypeScript file apidoc-postprocess-html.ts to do so
2026-01-22 09:42:22 +01:00