Files
otunes/apps/mobile/lib/urls.ts
joshuafhigginsandremhelper 3c721d9584 feat: optimize cover image delivery (#16)
- Add sized, resized WebP cover responses
- Request appropriately sized artwork in mobile

---------

Co-authored-by: Rem Helper <remhelper@abunchofknowitalls.com>
Reviewed-on: https://git.abunchofknowitalls.com/joshuafhiggins/otunes/pulls/16
2026-08-19 11:42:31 -04:00

92 lines
2.5 KiB
TypeScript

import type { AudioSource } from "expo-audio"
export type PlaybackQuality = "low" | "medium" | "high" | "lossless"
export const coverImageSizes = [64, 128, 192, 256, 384, 512, 768, 1024] as const
export type CoverImageSize = (typeof coverImageSizes)[number]
export function withCoverImageSize(uri: string, size: CoverImageSize) {
const url = new URL(uri)
url.searchParams.set("size", String(size))
return url.toString()
}
function sizedCoverUrl(uri: string, size?: CoverImageSize) {
return size ? withCoverImageSize(uri, size) : uri
}
export function artistCoverUrl(
serverUrl: string,
artistId: string,
size?: CoverImageSize
) {
return sizedCoverUrl(`${serverUrl}/api/artist/${artistId}/cover`, size)
}
export function albumCoverUrl(
serverUrl: string,
albumId: string,
size?: CoverImageSize
) {
return sizedCoverUrl(`${serverUrl}/api/album/${albumId}/cover`, size)
}
export function playlistCoverUrl(
serverUrl: string,
playlistId: string,
size?: CoverImageSize
) {
return sizedCoverUrl(`${serverUrl}/api/playlist/${playlistId}/cover`, size)
}
export function songPlayUrl(
serverUrl: string,
songId: string,
quality: PlaybackQuality | undefined,
preferAtmos: boolean | undefined
) {
const params = new URLSearchParams()
if (quality) params.set("quality", quality)
if (preferAtmos) params.set("preferAtmos", "true")
const query = params.toString()
return `${serverUrl}/api/song/${songId}/play${query ? `?${query}` : ""}`
}
export function songHlsPlaylistUrl(
serverUrl: string,
songId: string,
quality: PlaybackQuality | undefined,
preferAtmos: boolean | undefined
) {
const params = new URLSearchParams()
if (quality) params.set("quality", quality)
if (preferAtmos) params.set("preferAtmos", "true")
const query = params.toString()
return `${serverUrl}/api/song/${songId}/play/hls${query ? `?${query}` : ""}`
}
export function songAudioSource(
serverUrl: string,
songId: string,
quality: PlaybackQuality | undefined,
preferAtmos: boolean | undefined,
useHls: boolean,
options?: { cookieHeader?: string | null; songTitle?: string }
): AudioSource {
const uri = useHls
? songHlsPlaylistUrl(serverUrl, songId, quality, preferAtmos)
: songPlayUrl(serverUrl, songId, quality, preferAtmos)
const headers = options?.cookieHeader
? { Cookie: options.cookieHeader }
: undefined
const name = options?.songTitle
if (headers || name) {
return { uri, ...(name ? { name } : {}), ...(headers ? { headers } : {}) }
}
return uri
}