4 Commits

Include renames

Author	SHA1	Message	Date
SansanandClaude Opus 5.5	a7e2280969	Upload new soundtracks through the API ... A client starts an upload with the soundtrack's name, sends one MP3 per request, and finishes it. The server then moves the songs into a new folder in the music folder and syncs only that folder, so the soundtrack is in the library, lists and search right away. - POST /api/v1/soundtracks/uploads, GET/DELETE .../uploads/{id}, PUT .../uploads/{id}/files/{file} and POST .../uploads/{id}/finish. - Names must work as file names on every system and be free, ignoring case. File names are plain: clients flatten disc folders. - Only MP3 files. Size limits from UPLOAD_MAX_FILE_MB (50) and UPLOAD_MAX_TOTAL_MB (2048). - Refused while a sync runs, and a sync cannot start while an upload is finished. Songs equal to an existing soundtrack's are refused, as the sync would take them for that soundtrack renamed. - Unfinished uploads live in MUSIC_PATH/.uploads and are removed after a day. The sync now skips every hidden folder. Closes #33 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-15 21:38:26 +02:00
SansanandClaude Opus 5.5	bb8de5548d	Add alternative names and cover art for soundtracks ... Alternative names (#32): - PUT /api/v1/soundtracks/{uuid}/alternative-names replaces a soundtrack's alternative names (trimmed, deduplicated, without the soundtrack's own name). - alternative_names is in the soundtrack and statistics responses. - /find matches them too and shows which name matched. Covers (#12), stored in COVERS_PATH and off when it is not set: - GET, PUT (upload) and DELETE /api/v1/soundtracks/{uuid}/cover, and PUT .../cover/source to pick a SteamGridDB game or AniList anime by ID. Uploaded and picked covers are never replaced automatically. - With STEAMGRIDDB_API_KEY, a background job searches SteamGridDB, then AniList, by name, alternative names and the name without bracketed parts, at startup, after a sync and after names change. Search results are ranked by matching words, so "Civilization IV" gets "Sid Meier's Civilization IV". - cover_modified (Unix seconds) is in the soundtrack and statistics responses, so clients can cache covers. The new columns are added to migration 000006, which is not released yet. Closes #12, closes #32 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-13 21:57:18 +02:00
Sansan	a705d7b476	Store each client's play queue in the database ... The queue lived in memory and was shared by all clients, so a restart or a finished sync cleared it. Every client now has its own queue in the new queue and queue_song tables (added to the undeployed migration 000006). The music endpoints return the queue ID in the X-Queue-Id header and expect it back. A request without an ID, or with an ended one, starts a new queue. /music/reset ends the queue and returns a new ID, and a sync ends all running queues. Ended queues are kept as history. The deprecated legacy routes without the /api/v1 prefix are removed.	2026-10-07 20:03:03 +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