feat!: replace OpenSubsonic with a native mood-first API
CI / chart (push) Successful in 3s
CI / chart-push (push) Successful in 3s
CI / test (push) Successful in 1m40s
CI / image (push) Successful in 3m12s

Remove the /rest compatibility layer and the playlist model. Moods are now
first-class private collections, and playback is driven by short-lived radio
sessions whose queues are generated by the server.

- Bearer device tokens (hashed) with revocable sessions.
- Library snapshot/delta sync with tombstones and per-folder scoping.
- Mood CRUD, seeds, preview and recommendations.
- Radio batches weighted by seeds, genres, artists, text and playback affinity.
- Playback events (started/completed/skipped) and explicit add-to-mood.
- Stream, download and cover endpoints with query-token support for browsers.
- V5 migration drops playlists and migrates existing moods; scanner writes
  tombstones and song update timestamps.
- Built-in UI rebuilt on the native API with a radio player.
- Native API integration tests and a rewritten smoke test (49 checks).
- Chart bumped to 0.2.0.

BREAKING CHANGE: the OpenSubsonic API and static playlists are gone.
This commit is contained in:
TapTap committed 2026-11-14 17:54:44 +00:00
1 parent 28bfdd9d00
commit b33eb076c1
46 files changed
+3472 -5823

No files matched your search

@@ -0,0 +1,154 @@
package win.taptap.musicmanager.api
import io.ktor.http.HttpStatusCode
import io.ktor.server.response.respond
import io.ktor.server.routing.Route
import io.ktor.server.routing.delete
import io.ktor.server.routing.get
import io.ktor.server.routing.post
import kotlinx.serialization.Serializable
import win.taptap.musicmanager.api.AddToMoodRequest
import win.taptap.musicmanager.api.AddToMoodResponse
import win.taptap.musicmanager.api.NextTracksRequest
import win.taptap.musicmanager.api.PlaybackEventsRequest
import win.taptap.musicmanager.api.PlaybackEventsResponse
import win.taptap.musicmanager.api.SessionDto
import win.taptap.musicmanager.api.SongDto
import win.taptap.musicmanager.api.StartSessionRequest
import win.taptap.musicmanager.api.toDto
import win.taptap.musicmanager.config.LibraryConfig
import win.taptap.musicmanager.config.UserAccount
import win.taptap.musicmanager.config.UsersConfig
import win.taptap.musicmanager.db.LibraryRepository
import win.taptap.musicmanager.db.MoodRecord
import win.taptap.musicmanager.db.MoodRepository
import win.taptap.musicmanager.db.PlaybackSessionRecord
import win.taptap.musicmanager.db.RadioRepository
import win.taptap.musicmanager.radio.RadioService
@Serializable
data class TracksResponse(val songs: List<SongDto>)
fun Route.sessionRoutes(
users: UsersConfig,
library: LibraryConfig,
radioService: RadioService,
) {
post("/moods/{id}/sessions") {
val user = call.requireApiUser(users)
val mood = ownedMoodFor(call.parameters["id"], user)
val request = runCatching { call.receiveJson<StartSessionRequest>() }
.getOrDefault(StartSessionRequest())
val limit = request.limit ?: DEFAULT_BATCH
val started = radioService.start(mood, user, library, limit)
call.respond(
HttpStatusCode.Created,
SessionDto(
id = started.session.id,
moodId = mood.id,
moodName = mood.name,
startedAt = started.session.createdAt,
queue = started.songs.map { it.toDto() },
),
)
}
get("/sessions/{id}") {
val user = call.requireApiUser(users)
val session = ownedSession(call.parameters["id"], user)
val mood = ownedMoodFor(session.moodId, user)
val folders = user.musicFolderIds(library)
val items = RadioRepository.items(session.id)
val songs = LibraryRepository
.songsByIds(items.map { it.songId }, folders, user.name)
.associateBy { it.id }
call.respond(
SessionDto(
id = session.id,
moodId = session.moodId,
moodName = mood.name,
startedAt = session.createdAt,
closedAt = session.closedAt,
queue = items.mapNotNull { songs[it.songId]?.toDto() },
),
)
}
post("/sessions/{id}/next") {
val user = call.requireApiUser(users)
val session = ownedSession(call.parameters["id"], user)
if (session.closedAt != null) conflict("Session is closed")
val mood = ownedMoodFor(session.moodId, user)
val request = runCatching { call.receiveJson<NextTracksRequest>() }
.getOrDefault(NextTracksRequest())
val songs = radioService.next(
mood = mood,
user = user,
library = library,
sessionId = session.id,
excluded = request.excludeSongIds.toSet(),
limit = request.limit ?: DEFAULT_BATCH,
)
call.respond(TracksResponse(songs.map { it.toDto() }))
}
post("/sessions/{id}/events") {
val user = call.requireApiUser(users)
val session = ownedSession(call.parameters["id"], user)
val request = call.receiveJson<PlaybackEventsRequest>()
val accepted = request.events.count { event ->
event.type in EVENT_TYPES &&
event.songId.isNotBlank() &&
RadioRepository.recordEvent(session.id, user.name, event.songId, event.type)
}
call.respond(PlaybackEventsResponse(accepted))
}
/** Explicitly adds the playing track to the session mood or another chosen mood. */
post("/sessions/{id}/add-to-mood") {
val user = call.requireApiUser(users)
val session = ownedSession(call.parameters["id"], user)
val request = call.receiveJson<AddToMoodRequest>()
val folders = user.musicFolderIds(library)
val song = LibraryRepository.song(request.songId, folders, user.name)
?: notFound("Song")
val target = if (request.moodId.isNullOrBlank()) {
ownedMoodFor(session.moodId, user)
} else {
ownedMoodFor(request.moodId, user)
}
val added = MoodRepository.addSeed(target.id, user.name, song.id, "manual")
val refreshed = MoodRepository.get(target.id, user.name) ?: target
call.respond(
AddToMoodResponse(
mood = refreshed.toDto(),
added = added,
),
)
}
delete("/sessions/{id}") {
val user = call.requireApiUser(users)
val session = ownedSession(call.parameters["id"], user)
RadioRepository.close(session.id, user.name)
call.respond(HttpStatusCode.NoContent)
}
}
private fun ownedMoodFor(id: String?, user: UserAccount): MoodRecord {
if (id.isNullOrBlank()) badRequest("Mood id is required")
return MoodRepository.get(id, user.name) ?: notFound("Mood")
}
private fun ownedSession(id: String?, user: UserAccount): PlaybackSessionRecord {
if (id.isNullOrBlank()) badRequest("Session id is required")
return RadioRepository.get(id, user.name) ?: notFound("Session")
}
private const val DEFAULT_BATCH = 15
private val EVENT_TYPES = setOf("started", "completed", "skipped")