@rocksky/sdk 0.14.0 → 0.14.2

package/src/client.test.ts

@@ -0,0 +1,83 @@
+import { afterEach, describe, expect, test } from "bun:test";
+
+import { RockskyClient } from "./client.js";
+
+const TOKEN = "test-token";
+
+/**
+ * Swap in a fetch that records the request instead of making one. The client
+ * builds its fetch handler in the constructor, so install this first.
+ */
+function captureFetch(): {
+	calls: Request[];
+	only: () => Request;
+	restore: () => void;
+} {
+	const calls: Request[] = [];
+	const real = globalThis.fetch;
+	globalThis.fetch = (async (input: RequestInfo | URL, init?: RequestInit) => {
+		calls.push(new Request(input as RequestInfo, init));
+		return new Response(JSON.stringify({ status: "ok" }), {
+			status: 200,
+			headers: { "content-type": "application/json" },
+		});
+	}) as typeof globalThis.fetch;
+	return {
+		calls,
+		/** The single request that was made; fails loudly if there wasn't exactly one. */
+		only: () => {
+			expect(calls).toHaveLength(1);
+			return calls[0] as Request;
+		},
+		restore: () => {
+			globalThis.fetch = real;
+		},
+	};
+}
+
+let restore: (() => void) | null = null;
+afterEach(() => {
+	restore?.();
+	restore = null;
+});
+
+describe("authenticated request headers", () => {
+	test("a JSON procedure keeps its content-type alongside the bearer token", async () => {
+		// Regression: the auth wrapper used to merge headers with an object spread.
+		// atcute passes a Headers instance, which has no own enumerable properties,
+		// so the spread produced `{}` and dropped the `application/json` content-type
+		// atcute sets for a JSON body. The AppView then saw text/plain and replied
+		// `InvalidRequest: Wrong request encoding (Content-Type): text/plain`.
+		const cap = captureFetch();
+		restore = cap.restore;
+
+		const client = new RockskyClient("https://appview.test", TOKEN);
+		await client.library().createPlaylist("Late night drive");
+
+		const req = cap.only();
+		expect(req.method).toBe("POST");
+		expect(req.headers.get("content-type")).toBe("application/json");
+		expect(req.headers.get("authorization")).toBe(`Bearer ${TOKEN}`);
+		expect(await req.json()).toEqual({ name: "Late night drive" });
+	});
+
+	test("a query still carries the bearer token", async () => {
+		const cap = captureFetch();
+		restore = cap.restore;
+
+		const client = new RockskyClient("https://appview.test", TOKEN);
+		await client.library().getPlaylists();
+
+		expect(cap.only().headers.get("authorization")).toBe(`Bearer ${TOKEN}`);
+	});
+
+	test("no token means no authorization header", async () => {
+		const cap = captureFetch();
+		restore = cap.restore;
+
+		const client = new RockskyClient("https://appview.test");
+		await client.get("app.rocksky.actor.getProfile", { did: "did:plc:test" });
+
+		expect(cap.only().headers.get("authorization")).toBeNull();
+	});
+});

package/src/client.ts

@@ -10,6 +10,8 @@ import type {
   AlbumViewDetailed,
   ArtistViewBasic,
   ArtistViewDetailed,
+  ChartsDecadeViewBasic,
+  ChartsScrobblerViewBasic,
   ChartsView,
   CreateScrobbleInput,
   FollowAccountOutput,
@@ -53,6 +55,9 @@ import type {
   StatsGlobalStatsView,
   StatsView,
   StatsWrappedView,
+  PlaylistCreatePlaylistOutput,
+  PlaylistUpdatePlaylistOutput,
+  AddSongsOutput,
   UnfollowAccountOutput,
   UpdateSeenOutput,
 } from "./generated/types.js";
@@ -113,11 +118,16 @@ export class RockskyClient {
     let handler = simpleFetchHandler({ service: appview });
     if (token) {
       const inner = handler;
-      handler = ((pathname: string, init?: RequestInit) =>
-        inner(pathname, {
-          ...init,
-          headers: { ...(init?.headers as Record<string, string>), authorization: `Bearer ${token}` },
-        })) as typeof handler;
+      handler = ((pathname: string, init?: RequestInit) => {
+        // `new Headers(init.headers)`, not a spread: atcute hands us a Headers
+        // instance, and a Headers has no own enumerable properties — spreading
+        // it yields `{}` and silently drops everything already set. That threw
+        // away the `content-type: application/json` atcute adds for a JSON
+        // body, so the AppView saw text/plain and rejected the request.
+        const headers = new Headers(init?.headers);
+        headers.set("authorization", `Bearer ${token}`);
+        return inner(pathname, { ...init, headers });
+      }) as typeof handler;
     }
     this.rpc = new Client({ handler });
   }
@@ -234,26 +244,67 @@ export class RockskyClient {
     return this.topArtistsInterval(limit, offset, Interval.allTime());
   }
 
-  /** The top tracks chart over a typed {@link DateInterval}. */
-  async topTracksInterval(limit: number, offset: number, interval: DateInterval): Promise<SongViewBasic[]> {
+  /** The top tracks chart over a typed {@link DateInterval}. Pass `did` to scope
+   * it to one actor instead of the platform-wide ranking. */
+  async topTracksInterval(
+    limit: number,
+    offset: number,
+    interval: DateInterval,
+    did?: string,
+  ): Promise<SongViewBasic[]> {
     const out = await this.query<{ tracks?: SongViewBasic[] }>("app.rocksky.charts.getTopTracks", {
       limit,
       offset,
+      did,
       ...interval,
     });
     return out.tracks ?? [];
   }
 
-  /** The top artists chart over a typed {@link DateInterval}. */
-  async topArtistsInterval(limit: number, offset: number, interval: DateInterval): Promise<ArtistViewBasic[]> {
+  /** The top artists chart over a typed {@link DateInterval}. Pass `did` to scope
+   * it to one actor instead of the platform-wide ranking. */
+  async topArtistsInterval(
+    limit: number,
+    offset: number,
+    interval: DateInterval,
+    did?: string,
+  ): Promise<ArtistViewBasic[]> {
     const out = await this.query<{ artists?: ArtistViewBasic[] }>("app.rocksky.charts.getTopArtists", {
       limit,
       offset,
+      did,
       ...interval,
     });
     return out.artists ?? [];
   }
 
+  /** Scrobbles grouped by the release decade of the music, over a typed
+   * {@link DateInterval}. Pass `did` to scope it to one actor. */
+  async decades(
+    interval: DateInterval = {},
+    did?: string,
+  ): Promise<ChartsDecadeViewBasic[]> {
+    const out = await this.query<{ decades?: ChartsDecadeViewBasic[] }>(
+      "app.rocksky.charts.getDecades",
+      { did, ...interval },
+    );
+    return out.decades ?? [];
+  }
+
+  /** The listeners who scrobbled the most, over a typed {@link DateInterval}.
+   * Pass `Interval.allTime()` for the all-time leaderboard. */
+  async topScrobblers(
+    limit = 20,
+    offset = 0,
+    interval: DateInterval = {},
+  ): Promise<ChartsScrobblerViewBasic[]> {
+    const out = await this.query<{ scrobblers?: ChartsScrobblerViewBasic[] }>(
+      "app.rocksky.charts.getTopScrobblers",
+      { limit, offset, ...interval },
+    );
+    return out.scrobblers ?? [];
+  }
+
   /** The album catalog, optionally filtered by `genre` and/or an RSQL
    * {@link Filter} expression (see {@link AlbumFields}). */
   async catalogAlbums(
@@ -406,9 +457,11 @@ export class RockskyClient {
     return this.query("app.rocksky.artist.getArtist", { uri });
   }
   /** Resolve full canonical metadata for a bare title + artist
-   * (`app.rocksky.song.matchSong`); optionally anchor with `mbId` / `isrc`. */
-  matchSong(title: string, artist: string, mbId?: string, isrc?: string): Promise<SongViewDetailed> {
-    return this.query("app.rocksky.song.matchSong", { title, artist, mbId, isrc });
+   * (`app.rocksky.song.matchSong`); optionally anchor with `mbId` / `isrc`.
+   * `album` steers the match toward that release (case-insensitive) so a
+   * remaster/live/single edition doesn't shadow the intended album. */
+  matchSong(title: string, artist: string, mbId?: string, isrc?: string, album?: string): Promise<SongViewDetailed> {
+    return this.query("app.rocksky.song.matchSong", { title, artist, mbId, isrc, album });
   }
   /** A single song by at:// `uri` (or by `mbid` / `isrc` / `spotifyId`). */
   song(opts: {
@@ -508,14 +561,71 @@ export class RockskyClient {
   spotifyCurrentlyPlaying(actor: string): Promise<PlayerCurrentlyPlayingViewDetailed> {
     return this.query("app.rocksky.spotify.getCurrentlyPlaying", { actor });
   }
-  /** The playlist catalog. */
-  playlists(limit = 50, offset = 0): Promise<PlaylistGetPlaylistsOutput> {
-    return this.query("app.rocksky.playlist.getPlaylists", { limit, offset });
+  /** The playlist catalog, optionally filtered by an RSQL {@link Filter}
+   * expression (see {@link PlaylistFields}). */
+  playlists(
+    limit = 50,
+    offset = 0,
+    filter?: string | Filter,
+  ): Promise<PlaylistGetPlaylistsOutput> {
+    return this.query("app.rocksky.playlist.getPlaylists", {
+      limit,
+      offset,
+      filter: filter?.toString(),
+    });
   }
   /** A single playlist with its items. */
   playlist(uri: string): Promise<PlaylistViewDetailed> {
     return this.query("app.rocksky.playlist.getPlaylist", { uri });
   }
+
+  /**
+   * Create a playlist (`app.rocksky.playlist.createPlaylist`). Auth required.
+   * Publishes an app.rocksky.playlist record to the caller's repo; the AppView
+   * only lists it once the commit has been ingested.
+   */
+  createPlaylist(input: {
+    name: string;
+    description?: string;
+    pictureUrl?: string;
+  }): Promise<PlaylistCreatePlaylistOutput> {
+    return this.post("app.rocksky.playlist.createPlaylist", { params: input });
+  }
+
+  /** Rename or re-describe a playlist (`app.rocksky.playlist.updatePlaylist`). Owner only. */
+  updatePlaylist(input: {
+    uri: string;
+    name?: string;
+    description?: string;
+    pictureUrl?: string;
+  }): Promise<PlaylistUpdatePlaylistOutput> {
+    return this.post("app.rocksky.playlist.updatePlaylist", { params: input });
+  }
+
+  /**
+   * Add songs to a playlist (`app.rocksky.playlist.addSongs`). Owner only.
+   * `songs` are app.rocksky.song AT-URIs; returns the created entry URIs.
+   */
+  addSongs(uri: string, songs: string[]): Promise<AddSongsOutput> {
+    return this.post("app.rocksky.playlist.addSongs", {
+      params: { uri, songs },
+    });
+  }
+
+  /** Delete a playlist and the caller's own entries (`app.rocksky.playlist.removePlaylist`). Owner only. */
+  removePlaylist(uri: string): Promise<void> {
+    return this.post("app.rocksky.playlist.removePlaylist", { params: { uri } });
+  }
+
+  /**
+   * Remove a song from a playlist (`app.rocksky.playlist.removeTrack`). An
+   * entry can only be retracted by the repo that published it.
+   */
+  removeTrack(uri: string, songUri: string): Promise<void> {
+    return this.post("app.rocksky.playlist.removeTrack", {
+      params: { uri, songUri },
+    });
+  }
   /** Shouts on an album. */
   albumShouts(uri: string, limit = 50, offset = 0): Promise<GetAlbumShoutsOutput> {
     return this.query("app.rocksky.shout.getAlbumShouts", { uri, limit, offset });

package/src/filter.ts

@@ -168,6 +168,26 @@ export const ArtistFields = {
   createdAt: "createdAt",
 } as const;
 
+/** Filterable fields of app.rocksky.playlist.getPlaylists (`track.*` selectors match the playlist's contents). */
+export const PlaylistFields = {
+  name: "name",
+  title: "title",
+  description: "description",
+  uri: "uri",
+  spotifyLink: "spotifyLink",
+  tidalLink: "tidalLink",
+  appleMusicLink: "appleMusicLink",
+  createdAt: "createdAt",
+  updatedAt: "updatedAt",
+  curatorDid: "curatorDid",
+  curatorHandle: "curatorHandle",
+  curatorName: "curatorName",
+  trackTitle: "track.title",
+  trackArtist: "track.artist",
+  trackAlbum: "track.album",
+  trackAlbumArtist: "track.albumArtist",
+} as const;
+
 /** Filterable fields of app.rocksky.scrobble.getScrobbles (dotted selectors reach the joined track/user/artist). */
 export const ScrobbleFields = {
   uri: "uri",

package/src/generated/types.ts

@@ -126,6 +126,18 @@ export interface AddItemsToQueueParams {
   shuffle?: boolean;
 }
 
+export interface AddSongsOutput {
+  /** AT-URIs of the created app.rocksky.playlist.song records */
+  uris: AtUri[];
+}
+
+export interface AddSongsParams {
+  /** The URI of the playlist to add the songs to */
+  uri: AtUri;
+  /** AT-URIs of the app.rocksky.song records to add */
+  songs: AtUri[];
+}
+
 export interface AlbumGetAlbumParams {
   /** The URI of the album to retrieve. */
   uri: AtUri;
@@ -355,6 +367,34 @@ export interface ArtistViewDetailed {
   tags?: string[];
 }
 
+export interface ChartsDecadeViewBasic {
+  /** The first year of the decade, e.g. 1990. */
+  decade?: number;
+  /** The number of scrobbles of music released in this decade. */
+  scrobbles?: number;
+  /** The number of distinct albums scrobbled from this decade. */
+  uniqueAlbums?: number;
+}
+
+export interface ChartsScrobblerViewBasic {
+  /** The unique identifier of the actor. */
+  id?: string;
+  /** The DID of the actor. */
+  did?: string;
+  /** The handle of the actor. */
+  handle?: string;
+  /** The display name of the actor. */
+  displayName?: string;
+  /** The URL of the actor's avatar image. */
+  avatar?: Uri;
+  /** The number of scrobbles in the requested window. */
+  scrobbles?: number;
+  /** The number of distinct artists scrobbled in the window. */
+  uniqueArtists?: number;
+  /** The number of distinct tracks scrobbled in the window. */
+  uniqueTracks?: number;
+}
+
 export interface ChartsScrobbleViewBasic {
   /** The date of the scrobble. */
   date?: DateTime;
@@ -755,10 +795,12 @@ export interface GetActorPlaylistsOutput {
 export interface GetActorPlaylistsParams {
   /** The DID or handle of the actor */
   did: AtIdentifier;
-  /** The maximum number of albums to return */
+  /** The maximum number of playlists to return */
   limit?: number;
   /** The offset for pagination */
   offset?: number;
+  /** RSQL filter expression, e.g. `name=="Road trip*";track.artist=="Daft Punk"`. Supports ==, !=, <, <=, >, >=, =in=, =out=, and `;`/`and`, `,`/`or` combinators, `*` wildcards in string values. Filterable fields: name, title, description, uri, spotifyLink, tidalLink, appleMusicLink, createdAt, updatedAt. The `track.title`, `track.artist`, `track.album` and `track.albumArtist` selectors match the playlist's contents, returning playlists that contain a matching track; several `track.*` terms joined with `;` must all be satisfied by the same track. */
+  filter?: string;
 }
 
 export interface GetActorScrobblesOutput {
@@ -966,6 +1008,19 @@ export interface GetCoverArtUrlParams {
   size?: number;
 }
 
+export interface GetDecadesOutput {
+  decades?: ChartsDecadeViewBasic[];
+}
+
+export interface GetDecadesParams {
+  /** The DID or handle of the actor to scope the chart to */
+  did?: AtIdentifier;
+  /** The start date to count scrobbles from (ISO 8601 format) */
+  startDate?: DateTime;
+  /** The end date to count scrobbles to (ISO 8601 format) */
+  endDate?: DateTime;
+}
+
 export interface GetDownloadUrlOutput {
   /** The resolved media or cover-art URL. */
   url: Uri;
@@ -1368,6 +1423,8 @@ export interface GetTopArtistsOutput {
 }
 
 export interface GetTopArtistsParams {
+  /** The DID or handle of the actor to scope the chart to */
+  did?: AtIdentifier;
   /** The maximum number of artists to return */
   limit?: number;
   /** The offset for pagination */
@@ -1378,6 +1435,21 @@ export interface GetTopArtistsParams {
   endDate?: DateTime;
 }
 
+export interface GetTopScrobblersOutput {
+  scrobblers?: ChartsScrobblerViewBasic[];
+}
+
+export interface GetTopScrobblersParams {
+  /** The maximum number of scrobblers to return */
+  limit?: number;
+  /** The offset for pagination */
+  offset?: number;
+  /** The start date to count scrobbles from (ISO 8601 format) */
+  startDate?: DateTime;
+  /** The end date to count scrobbles to (ISO 8601 format) */
+  endDate?: DateTime;
+}
+
 export interface GetTopSongsOutput {
 
 }
@@ -1394,6 +1466,8 @@ export interface GetTopTracksOutput {
 }
 
 export interface GetTopTracksParams {
+  /** The DID or handle of the actor to scope the chart to */
+  did?: AtIdentifier;
   /** The maximum number of tracks to return */
   limit?: number;
   /** The offset for pagination */
@@ -1565,6 +1639,23 @@ export interface LibrarySearchParams {
   songOffset?: number;
 }
 
+export interface LibraryUpdatePlaylistInput {
+  /** The playlist id to update. */
+  playlistId: string;
+  /** New playlist name. */
+  name?: string;
+  /** New playlist comment. */
+  comment?: string;
+  /** A song id to add to the playlist. */
+  songIdToAdd?: string;
+  /** A track index to remove from the playlist. */
+  songIndexToRemove?: number;
+}
+
+export interface LibraryUpdatePlaylistOutput {
+
+}
+
 export interface LikeRecord {
   /** The date when the like was created. */
   createdAt: DateTime;
@@ -1599,6 +1690,8 @@ export interface MatchSongParams {
   title: string;
   /** The artist of the song to retrieve */
   artist: string;
+  /** Optional album title — candidates whose album matches it (case-insensitive) are preferred, so remaster/live/single editions don't shadow the intended release */
+  album?: string;
   /** Optional MusicBrainz recording ID to anchor the match */
   mbId?: string;
   /** Optional International Standard Recording Code (ISRC) to anchor the match */
@@ -1610,6 +1703,8 @@ export interface MirrorSourceView {
   provider: string;
   /** Whether scrobbles from this source are being mirrored into Rocksky. */
   enabled: boolean;
+  /** Whether Rocksky scrobbles are mirrored out to this source. Enabled unless the user turned it off. teal.fm only. */
+  pushEnabled?: boolean;
   /** Username on the external service (Last.fm / ListenBrainz). Null for Teal.fm. */
   externalUsername?: string;
   /** True when an API key is stored. Last.fm/ListenBrainz only; always false for Teal.fm. */
@@ -1723,16 +1818,27 @@ export interface PlayFileParams {
   fileId: string;
 }
 
+export interface PlaylistCreatePlaylistOutput {
+  /** The AT-URI of the created app.rocksky.playlist record. */
+  uri: AtUri;
+  /** The CID of the created app.rocksky.playlist record. */
+  cid: string;
+}
+
 export interface PlaylistCreatePlaylistParams {
   /** The name of the playlist */
   name: string;
   /** A brief description of the playlist */
   description?: string;
+  /** The URL of the cover image for the playlist */
+  pictureUrl?: Uri;
 }
 
 export interface PlaylistGetPlaylistParams {
   /** The URI of the playlist to retrieve. */
   uri: AtUri;
+  /** RSQL filter expression applied to the playlist's tracks, e.g. `artist=="Daft Punk";duration=gt=200000`. Supports ==, !=, <, <=, >, >=, =in=, =out=, and `;`/`and`, `,`/`or` combinators, `*` wildcards in string values. Filterable fields: title, artist, album, albumArtist, genre, composer, label, duration, trackNumber, discNumber, mbId, isrc, sha256, uri, albumUri, artistUri, addedAt */
+  filter?: string;
 }
 
 export interface PlaylistGetPlaylistsOutput {
@@ -1744,15 +1850,8 @@ export interface PlaylistGetPlaylistsParams {
   limit?: number;
   /** The offset for pagination, used to skip a number of playlists. */
   offset?: number;
-}
-
-export interface PlaylistItemRecord {
-  subject: StrongRef;
-  /** The date the playlist was created. */
-  createdAt: DateTime;
-  track: SongViewBasic;
-  /** The order of the item in the playlist. */
-  order: number;
+  /** RSQL filter expression, e.g. `name=="Road trip*";track.artist=="Daft Punk"`. Supports ==, !=, <, <=, >, >=, =in=, =out=, and `;`/`and`, `,`/`or` combinators, `*` wildcards in string values. Filterable fields: name, title, description, uri, spotifyLink, tidalLink, appleMusicLink, createdAt, updatedAt, curatorDid, curatorHandle, curatorName. The `track.title`, `track.artist`, `track.album` and `track.albumArtist` selectors match the playlist's contents, returning playlists that contain a matching track; several `track.*` terms joined with `;` must all be satisfied by the same track. */
+  filter?: string;
 }
 
 export interface PlaylistRecord {
@@ -1776,6 +1875,45 @@ export interface PlaylistRecord {
   appleMusicLink?: string;
 }
 
+export interface PlaylistSongRecord {
+  /** Strong reference (AT-URI + CID) to the parent app.rocksky.playlist record. */
+  playlist: StrongRef;
+  /** Strong reference (AT-URI + CID) to the app.rocksky.song record this entry points at. */
+  song: StrongRef;
+  /** The title of the song. */
+  title: string;
+  /** The artist of the song. */
+  artist: string;
+  /** The album the song belongs to. */
+  album: string;
+  /** The album artist of the song. */
+  albumArtist: string;
+  /** The duration of the song in milliseconds. */
+  duration: number;
+  /** The URL of the album art of the song. */
+  albumArtUrl?: Uri;
+  /** The date and time the song was added to the playlist. */
+  addedAt: DateTime;
+}
+
+export interface PlaylistUpdatePlaylistOutput {
+  /** The AT-URI of the updated app.rocksky.playlist record. */
+  uri: AtUri;
+  /** The CID of the updated app.rocksky.playlist record. */
+  cid: string;
+}
+
+export interface PlaylistUpdatePlaylistParams {
+  /** The URI of the playlist to update */
+  uri: AtUri;
+  /** The new name of the playlist */
+  name?: string;
+  /** The new description of the playlist */
+  description?: string;
+  /** The new cover image URL for the playlist */
+  pictureUrl?: Uri;
+}
+
 /** Basic view of a playlist, including its metadata */
 export interface PlaylistViewBasic {
   /** The unique identifier of the playlist. */
@@ -1800,6 +1938,8 @@ export interface PlaylistViewBasic {
   createdAt?: DateTime;
   /** The number of tracks in the playlist. */
   trackCount?: number;
+  /** Album-art URLs of up to four of the playlist's tracks, for rendering a cover mosaic when the playlist has no picture of its own. */
+  trackArts?: Uri[];
 }
 
 /** Detailed view of a playlist, including its tracks and metadata */
@@ -1858,6 +1998,8 @@ export interface PutMirrorSourceInput {
   provider: string;
   /** Enable or disable mirroring for this provider. */
   enabled?: boolean;
+  /** Enable or disable mirroring Rocksky scrobbles out to this provider. teal.fm only. */
+  pushEnabled?: boolean;
   /** External username (Last.fm / ListenBrainz). Required when enabling those providers. Ignored for Teal.fm. */
   externalUsername?: string;
   /** API key / token to be encrypted at rest. Omit to leave the existing key unchanged. Pass an empty string to clear it. */
@@ -1929,8 +2071,10 @@ export interface RemoveShoutParams {
 export interface RemoveTrackParams {
   /** The URI of the playlist to remove the track from */
   uri: AtUri;
-  /** The position of the track to remove in the playlist */
-  position: number;
+  /** The URI of the app.rocksky.song record to remove. Removes every copy of it; pass `index` instead to remove one. */
+  songUri?: AtUri;
+  /** 0-based position of the entry to remove, in the order getPlaylist returns. */
+  index?: number;
 }
 
 export interface ReplyShoutInput {
@@ -2166,6 +2310,8 @@ export interface ScrobbleViewDetailed {
   /** The SHA256 hash of the scrobble data. */
   sha256?: string;
   liked?: boolean;
+  /** The URI of the track (song) this scrobble is of. */
+  trackUri?: string;
   likesCount?: number;
   /** The number of listeners */
   listeners?: number;
@@ -2405,6 +2551,10 @@ export interface SongViewBasic {
   discNumber?: number;
   /** The number of times the song has been played. */
   playCount?: number;
+  /** The number of users who have loved this song. */
+  likesCount?: number;
+  /** Whether the authenticated user has loved this song. False when unauthenticated. */
+  liked?: boolean;
   /** The number of unique listeners who have played the song. */
   uniqueListeners?: number;
   /** The URI of the album the song belongs to. */
@@ -2445,6 +2595,10 @@ export interface SongViewDetailed {
   discNumber?: number;
   /** The number of times the song has been played. */
   playCount?: number;
+  /** The number of users who have loved this song. */
+  likesCount?: number;
+  /** Whether the authenticated user has loved this song. False when unauthenticated. */
+  liked?: boolean;
   /** The number of unique listeners who have played the song. */
   uniqueListeners?: number;
   /** The URI of the album the song belongs to. */
@@ -2714,23 +2868,6 @@ export interface UpdateNowPlayingOutput {
 
 }
 
-export interface UpdatePlaylistInput {
-  /** The playlist id to update. */
-  playlistId: string;
-  /** New playlist name. */
-  name?: string;
-  /** New playlist comment. */
-  comment?: string;
-  /** A song id to add to the playlist. */
-  songIdToAdd?: string;
-  /** A track index to remove from the playlist. */
-  songIndexToRemove?: number;
-}
-
-export interface UpdatePlaylistOutput {
-
-}
-
 export interface UpdateSeenInput {
   /** The ids of the notifications to mark as viewed. Omit to mark all. */
   ids?: string[];
@@ -2770,8 +2907,10 @@ export interface Endpoints {
   "app.rocksky.artist.getArtistRecentListeners": GetArtistRecentListenersOutput;
   "app.rocksky.artist.getArtists": ArtistGetArtistsOutput;
   "app.rocksky.artist.getArtistTracks": GetArtistTracksOutput;
+  "app.rocksky.charts.getDecades": GetDecadesOutput;
   "app.rocksky.charts.getScrobblesChart": ChartsView;
   "app.rocksky.charts.getTopArtists": GetTopArtistsOutput;
+  "app.rocksky.charts.getTopScrobblers": GetTopScrobblersOutput;
   "app.rocksky.charts.getTopTracks": GetTopTracksOutput;
   "app.rocksky.dropbox.downloadFile": void;
   "app.rocksky.dropbox.getFiles": DropboxFileListView;
@@ -2835,7 +2974,7 @@ export interface Endpoints {
   "app.rocksky.library.startScan": StartScanOutput;
   "app.rocksky.library.unstar": UnstarOutput;
   "app.rocksky.library.updateNowPlaying": UpdateNowPlayingOutput;
-  "app.rocksky.library.updatePlaylist": UpdatePlaylistOutput;
+  "app.rocksky.library.updatePlaylist": LibraryUpdatePlaylistOutput;
   "app.rocksky.like.dislikeShout": ShoutView;
   "app.rocksky.like.dislikeSong": SongViewDetailed;
   "app.rocksky.like.likeShout": ShoutView;
@@ -2856,7 +2995,8 @@ export interface Endpoints {
   "app.rocksky.player.playFile": void;
   "app.rocksky.player.previous": void;
   "app.rocksky.player.seek": void;
-  "app.rocksky.playlist.createPlaylist": void;
+  "app.rocksky.playlist.addSongs": AddSongsOutput;
+  "app.rocksky.playlist.createPlaylist": PlaylistCreatePlaylistOutput;
   "app.rocksky.playlist.getPlaylist": PlaylistViewDetailed;
   "app.rocksky.playlist.getPlaylists": PlaylistGetPlaylistsOutput;
   "app.rocksky.playlist.insertDirectory": void;
@@ -2864,6 +3004,7 @@ export interface Endpoints {
   "app.rocksky.playlist.removePlaylist": void;
   "app.rocksky.playlist.removeTrack": void;
   "app.rocksky.playlist.startPlaylist": void;
+  "app.rocksky.playlist.updatePlaylist": PlaylistUpdatePlaylistOutput;
   "app.rocksky.rockbox.getAudioSettings": RockboxSettingsView;
   "app.rocksky.rockbox.putAudioSettings": RockboxSettingsView;
   "app.rocksky.scrobble.createScrobble": ScrobbleViewBasic;