feat!: replace OpenSubsonic with a native mood-first API
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:
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")
|
||||
Reference in new issue
Block a user