feat: add client compatibility endpoints and a smoke test script

- getMusicDirectory for folder/album browsing
- server-side play queues with savePlayQueue/getPlayQueue and index variants
- jukebox status and internet radio compatibility responses
- scripts/smoke.sh generates a tagged MP3 library, runs the server and
  verifies all endpoints clients use, including Range, download and covers
This commit is contained in:
TapTap committed 2026-11-13 12:40:00 +00:00
1 parent 46266d8071
commit 4d313a2846
9 files changed
+474

No files matched your search

+17
View File
@@ -592,6 +592,10 @@ For every `/rest/*` call (except an optional health check):
- `createPlaylist(playlistId, name, songId)`: owner is the caller.
- `updatePlaylist(playlistId, name, comment, public, songIdToAdd, songIndexToRemove)`: owner only; indices are applied in order.
- `deletePlaylist(playlistId)`: owner only.
- `getMusicDirectory(id)`: folder IDs return their albums as directories; album IDs return their songs. Used by folder-browsing clients.
- `savePlayQueue` / `getPlayQueue` (and the `*ByIndex` variants): per-user queue kept in memory.
- `jukeboxControl(action=status)` returns a stopped status; other jukebox actions report that jukebox is unsupported.
- `getInternetRadioStations` returns an empty list; radio mutation endpoints report that radio is unsupported.
No `createUser` / `updateUser` / `deleteUser` endpoints: config/Vault is the source of truth.
@@ -660,8 +664,21 @@ The server fails its readiness probe if a configured root path is missing or unr
- `search3` with Unicode and wildcards
- scrobble/star/rating/bookmark isolation between users
- playlist ownership and public visibility
- music directory browsing and server-side play queues
- transcoding: `maxBitRate` produces MP3, `timeOffset` seeks (skipped when `ffmpeg` is unavailable)
### Compatibility smoke test
`scripts/smoke.sh` generates a tagged MP3 with ffmpeg, starts the real server against a temporary library, and checks every endpoint a Subsonic client uses (browsing, feeds, search, stars, ratings, bookmarks, playlists, queues, stream with Range, download and covers). It prints PASS/FAIL per endpoint and exits non-zero on the first failure summary:
```bash
nix-shell --run scripts/smoke.sh
# or, with ffmpeg/sqlite/curl installed:
scripts/smoke.sh
```
The work directory can be passed as the first argument; the server log is kept there for debugging.
---
## 11. Implementation Order