feat: update with latest opensubsonic changes

explodingcamera · explodingcamera · commit b1d296d08fa1 · 2025-04-13T00:40:19.000+02:00
Signed-off-by: Henry Gressmann &lt;mail@henrygressmann.de&gt;
diff --git a/bun.lock b/bun.lock
diff --git a/package.json b/package.json
@@ -28,8 +28,8 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^1.9.4",
-		"bun-types": "^1.2.4",
-		"esbuild": "^0.25.0",
+		"bun-types": "^1.2.9",
+		"esbuild": "^0.25.2",
 		"release-it": "^18.1.2"
 	},
 	"release-it": {
@@ -46,6 +46,6 @@
 	"engineStrict": false,
 	"trustedDependencies": ["@biomejs/biome", "esbuild"],
 	"dependencies": {
-		"typescript": "^5.8.2"
+		"typescript": "^5.8.3"
 	}
 }
diff --git a/src/index.ts b/src/index.ts
@@ -2,7 +2,7 @@ import { md5 } from "./md5.js";
 import { arrayBufferToBase64 } from "./utils.js";
 
 // biome-ignore format:
-import type { AlbumInfo, AlbumList, AlbumList2, AlbumWithSongsID3, ArtistInfo, ArtistInfo2, ArtistWithAlbumsID3, ArtistsID3, Bookmarks, ChatMessages, Child, Directory, Genres, Indexes, InternetRadioStations, JukeboxPlaylist, JukeboxStatus, License, Lyrics, MusicFolders, NewestPodcasts, NowPlaying, OpenSubsonicExtensions, PlayQueue, Playlist, PlaylistWithSongs, Playlists, Podcasts, ScanStatus, SearchResult2, SearchResult3, Shares, SimilarSongs, SimilarSongs2, Songs, Starred, Starred2, StructuredLyrics, TopSongs, User, Users, VideoInfo, Videos } from "./types.js";
+import type { AlbumInfo, AlbumList, AlbumList2, AlbumWithSongsID3, ArtistInfo, ArtistInfo2, ArtistWithAlbumsID3, ArtistsID3, Bookmarks, ChatMessages, Child, Directory, Genres, Indexes, InternetRadioStations, JukeboxPlaylist, JukeboxStatus, License, Lyrics, MusicFolders, NewestPodcasts, NowPlaying, OpenSubsonicExtensions, PlayQueue, Playlist, PlaylistWithSongs, Playlists, PodcastEpisode, Podcasts, ScanStatus, SearchResult2, SearchResult3, Shares, SimilarSongs, SimilarSongs2, Songs, Starred, Starred2, StructuredLyrics, TopSongs, User, Users, VideoInfo, Videos } from "./types.js";
 export * from "./types.js";
 
 interface SubsonicConfig {
@@ -737,6 +737,20 @@ export default class SubsonicAPI {
 		return this.#request("downloadPodcastEpisode", args);
 	}
 
+	/**
+	 * Returns details for a podcast episode.
+	 * Only supported by OpenSubsonic compatible servers with the `getPodcastEpisode` extension.
+	 *
+	 * https://opensubsonic.netlify.app/docs/endpoints/getPodcastEpisode/
+	 */
+	async getPodcastEpisode(args: { id: string }) {
+		return this.#requestJSON<
+			SubsonicBaseResponse & {
+				podcastEpisode: PodcastEpisode;
+			}
+		>("getPodcastEpisode", args);
+	}
+
 	async jukeboxControl(args: {
 		action:
 			| "start"
diff --git a/src/types.ts b/src/types.ts
@@ -11,6 +11,37 @@ export interface AlbumID3 {
 	songCount: number;
 	starred?: Date;
 	year?: number;
+	version?: string;
+	played?: string;
+	userRating?: number;
+	recordLabels?: RecordLabel[];
+	musicBrainzId?: string;
+	genres?: string[];
+	artists?: ArtistID3[];
+	displayArtist?: string;
+	releaseTypes?: string[];
+	moods?: string[];
+	sortName?: string;
+	originalReleaseDate?: ItemDate;
+	releaseDate?: ItemDate;
+	isCompilation?: boolean;
+	explicitStatus?: string;
+	discTitles?: DiscTitle[];
+}
+
+export interface DiscTitle {
+	disc: number;
+	title: string;
+}
+
+export interface ItemDate {
+	year?: number;
+	month?: number;
+	day?: number;
+}
+
+export interface RecordLabel {
+	name: string;
 }
 
 export interface AlbumInfo {
@@ -50,6 +81,9 @@ export interface ArtistID3 {
 	id: string;
 	name: string;
 	starred?: Date;
+	musicBrainzId?: string;
+	sortName?: string;
+	roles?: string[];
 }
 
 export interface ArtistInfo extends ArtistInfoBase {
@@ -146,6 +180,36 @@ export interface Child {
 	type?: MediaType;
 	userRating?: number;
 	year?: number;
+	played?: string;
+	bpm?: number;
+	comment?: string;
+	sortName?: string;
+	musicBrainzId?: string;
+	genres?: string[];
+	artists?: ArtistID3[];
+	displayArtist?: string;
+	albumArtists?: ArtistID3[];
+	displayAlbumArtist?: string;
+	contributors?: Contributor[];
+	displayComposer?: string;
+	moods?: string[];
+	replayGain?: ReplayGain;
+	explicitStatus?: string;
+}
+
+export interface Contributor {
+	role: string;
+	subRole?: string;
+	artist?: ArtistID3;
+}
+
+export interface ReplayGain {
+	trackGain: number;
+	albumGain: number;
+	trackPeak: number;
+	albumPeak: number;
+	baseGain: number;
+	fallbackGain: number;
 }
 
 export interface Directory {
@@ -162,6 +226,7 @@ export interface Directory {
 export interface Error {
 	code: number;
 	message?: string;
+	helpUrl?: string;
 }
 
 export interface Genre {
