3 Commits

Include renames

Author	SHA1	Message	Date
Sansan	080bacae80	Add GET /api/v1/statistics/soundtracks with every soundtrack and its songs ... The other soundtrack statistics are capped at 100, so a client that shows every soundtrack (the MusicPlayer statistics tab) had no way to get them all. This one has no limit and is sorted by name.	2026-10-06 23:14:49 +02:00
Sansan	6da96f79e7	Add a command to write the OpenAPI spec without a server ... `just openapi [dir]` (go run ./cmd/openapi) writes openapi.json (3.1) and openapi-3.0.json without a database or configuration. A test checks it matches the spec the server serves.	2026-10-06 17:01:12 +02:00
Sansan	973ebf224b	Generate the OpenAPI spec with Huma instead of swag ... The spec is now built from the same calls that register the routes, so it can't drift from the router like the swag comments did (all /api/v1 routes were missing). - /api/v1 endpoints are typed Huma operations; the spec is OpenAPI 3.1 at /openapi.json (3.0 at /openapi-3.0.json, YAML too), docs at /docs. /openapi and /swagger/* redirect there - Bearer token security is declared per operation; token creation and the new GET /api/v1/health are public - Legacy routes use the same handlers, are hidden from the spec and keep the Deprecation header - /sync/reset is hidden (debug only); the /sync/new, /sync/quick and /sync/new/full aliases are removed (use /sync and /sync/full) - Invalid parameters return 422 (validation); every error is {"error": "..."}; empty lists are [] instead of null - /sync/progress is documented as progress or result (oneOf) - Tests validate the spec and check real responses of every documented operation against it (kin-openapi) - Removed swag annotations, cmd/docs, echo-swagger and the swag tool	2026-10-06 16:31:06 +02:00