Plugin Models

@Serializable
data class Thumbnail(
    val url: String,
    val width: Int,
    val height: Int,
)

@Serializable
data class PaginationResult<T>(
    val items: List<T>,
    val totalCount: Int,
    val nextPagination: PaginationStrategy?,
)

sealed interface PaginationStrategy {
    @Serializable data class Offset(val offset: Int, val limit: Int) : PaginationStrategy
    @Serializable data class Cursor(val cursor: String?, val limit: Int) : PaginationStrategy
    @Serializable data class Page(val page: Int, val pageSize: Int) : PaginationStrategy
    @Serializable data class Continuation(val continuationToken: String?) : PaginationStrategy
}

sealed class MetadataAlbum {
    abstract val id: String
    abstract val title: String
    abstract val description: String?
    abstract val thumbnails: List<Thumbnail>
    abstract val albumType: MetadataAlbumType
    abstract val artists: List<MetadataArtist.Basic>
    abstract val externalUri: String?
}

sealed class MetadataArtist {
    abstract val id: String
    abstract val name: String
    abstract val thumbnails: List<Thumbnail>
    abstract val externalUri: String?
}

@Serializable
data class MetadataArtistOverview(
    val artist: MetadataArtist.Detailed,
    val top10Tracks: List<MetadataTrack>,
    val albums: PaginationResult<MetadataAlbum.Detailed>,
    val relatedArtists: PaginationResult<MetadataArtist.Basic>,
    val featuredPlaylists: PaginationResult<MetadataPlaylist>,
)

sealed class MetadataSearchResult {
    @Serializable data class Track(val data: MetadataTrack) : MetadataSearchResult()
    @Serializable data class Artist(val data: MetadataArtist.Basic) : MetadataSearchResult()
    @Serializable data class Album(val data: MetadataAlbum.Basic) : MetadataSearchResult()
    @Serializable data class Playlist(val data: MetadataPlaylist) : MetadataSearchResult()
    @Serializable data class User(val data: MetadataUser) : MetadataSearchResult()
}

sealed interface MetadataBrowseItem {
    @Serializable data class Track(val data: MetadataTrack) : MetadataBrowseItem
    @Serializable data class Album(val data: MetadataAlbum.Basic) : MetadataBrowseItem
    @Serializable data class Artist(val data: MetadataArtist.Basic) : MetadataBrowseItem
    @Serializable data class Playlist(val data: MetadataPlaylist) : MetadataBrowseItem
    @Serializable data class User(val data: MetadataUser) : MetadataBrowseItem
}

@Serializable
data class MetadataBrowseGenre(
    val id: String,
    val name: String,
)

@Serializable
data class AudioFormat(
    val codec: String,
    val container: String,
    val qualities: List<AudioQuality>,
)

sealed interface AudioQuality {
    @Serializable data class Lossy(val bitrate: Int) : AudioQuality
    @Serializable data class Lossless(val sampleRate: Int, val channels: Int) : AudioQuality
}

sealed class AudioSource(
    abstract val id: String,
    abstract val title: String,
    abstract val artist: String?,
    abstract val album: String?,
    abstract val thumbnails: List<Thumbnail>,
    abstract val externalUri: String?,
    abstract val confidence: Float,
) {
    @Serializable data class Basic(...) : AudioSource()
    @Serializable data class Streamed(
        val streams: List<AudioStream>,
        ...
    ) : AudioSource()
}

sealed interface AudioStream {
    val url: String
    val codec: String
    val container: String
    val protocol: StreamProtocol

    @Serializable data class Lossy(val bitrate: Int, ...) : AudioStream
    @Serializable data class Lossless(val sampleRate: Int, val channels: Int, ...) : AudioStream
}

enum class StreamProtocol { HLS, DASH, PROGRESSIVE }

@Serializable
data class LyricsResponse(
    val syncedLyrics: List<LyricsLine>?,
    val plainLyrics: String?,
)

@Serializable
data class LyricsLine(
    val time: Long,
    val text: String,
)

@Serializable
data class ScrobbleTrack(
    val timestamp: Long,
    val trackId: String,
    val artistId: String,
    val albumId: String?,
    val trackName: String,
    val artistName: String,
    val albumName: String?,
    val streamingProvider: String,
    val durationMs: Long?,
)

@Serializable
data class HttpResponse(
    val statusCode: Int,
    val headers: Map<String, String>,
    val body: String?,
)

enum class HttpMethod(val value: String) {
    Get("GET"),
    Post("POST"),
    Put("PUT"),
    Delete("DELETE"),
    Patch("PATCH"),
    Head("HEAD"),
    Options("OPTIONS"),
}

@Serializable
data class Cookie(
    val name: String,
    val value: String,
    val domain: String,
    val path: String?,
    val expiresAt: Long?,
    val secure: Boolean,
    val httpOnly: Boolean,
)

@Serializable
data class PluginUpdateInfo(
    val latestVersion: SemVer,
    val directDownloadUrl: String,
    val releaseNotes: String,
)