@rocksky/sdk 0.13.0 → 0.14.1

package/README.md

@@ -109,10 +109,12 @@ SHA-256, identical to the server and every other Rocksky SDK.
 ## Duplicate prevention + real-time sync
 
 An optional local index (embedded [classic-level](https://github.com/Level/classic-level)
-LevelDB) prevents duplicate writes and stays live off the firehose:
+LevelDB) prevents duplicate writes and stays live off the firehose. It is
+Node-only, so it lives on its own subpath — the main `@rocksky/sdk` entry stays
+browser-safe:
 
 ```ts
-import { RockskyIndex } from "@rocksky/sdk";
+import { RockskyIndex } from "@rocksky/sdk/dedup";
 
 const idx = new RockskyIndex("./dedup");
 await idx.open();

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import type { Filter } from "./filter.js";
 import { RockskyLibrary } from "./library.js";
-import type { ActorProfileViewBasic, ActorProfileViewDetailed, AlbumViewBasic, AlbumViewDetailed, ArtistViewBasic, ArtistViewDetailed, ChartsView, FeedGeneratorsView, FeedRecommendationsView, FeedRecommendedAlbumsView, FeedRecommendedArtistsView, FeedSearchResultsView, FeedStoriesView, FeedView, GetActorCompatibilityOutput, GetActorNeighboursOutput, GetActorPlaylistsOutput, GetAlbumShoutsOutput, GetApikeysOutput, GetArtistListenersOutput, GetArtistRecentListenersOutput, GetArtistShoutsOutput, GetFeedGeneratorOutput, GetMirrorSourcesOutput, GetProfileShoutsOutput, GetShoutRepliesOutput, GetSongRecentListenersOutput, GetTrackShoutsOutput, GetUnreadCountOutput, ListNotificationsOutput, PlayerCurrentlyPlayingViewDetailed, PlayerPlaybackQueueViewDetailed, PlaylistGetPlaylistsOutput, PlaylistViewDetailed, RockboxSettingsView, ScrobbleViewBasic, SongViewBasic, SongViewDetailed, StatsGlobalStatsView, StatsView, StatsWrappedView, UpdateSeenOutput } from "./generated/types.js";
+import type { ActorProfileViewBasic, ActorProfileViewDetailed, AlbumViewBasic, AlbumViewDetailed, ArtistViewBasic, ArtistViewDetailed, ChartsView, CreateScrobbleInput, FollowAccountOutput, FeedGeneratorsView, FeedRecommendationsView, FeedRecommendedAlbumsView, FeedRecommendedArtistsView, FeedSearchResultsView, FeedStoriesView, FeedView, GetActorCompatibilityOutput, GetActorNeighboursOutput, GetActorPlaylistsOutput, GetAlbumShoutsOutput, GetApikeysOutput, GetArtistListenersOutput, GetArtistRecentListenersOutput, GetArtistShoutsOutput, GetFeedGeneratorOutput, GetMirrorSourcesOutput, GetProfileShoutsOutput, GetShoutRepliesOutput, GetSongRecentListenersOutput, GetTrackShoutsOutput, GetUnreadCountOutput, ListNotificationsOutput, MirrorSourceView, PlayerCurrentlyPlayingViewDetailed, PlayerPlaybackQueueViewDetailed, PlaylistGetPlaylistsOutput, PlaylistViewDetailed, PutAudioSettingsInput, PutMirrorSourceInput, RockboxSettingsView, ScrobbleViewBasic, SongViewBasic, SongViewDetailed, StatsGlobalStatsView, StatsView, StatsWrappedView, PlaylistCreatePlaylistOutput, PlaylistUpdatePlaylistOutput, AddSongsOutput, UnfollowAccountOutput, UpdateSeenOutput } from "./generated/types.js";
 /**
  * A typed date window for the `top*` charts. Build one with the {@link Interval}
  * factories; `range` bounds are RFC-3339 datetimes.
@@ -51,6 +51,13 @@ export declare class RockskyClient {
     /** Call any AppView read query by nsid; returns the raw JSON response. Every
      * method here is sugar over this — use it for queries without a wrapper. */
     get(nsid: string, params?: Record<string, unknown>): Promise<unknown>;
+    /** Call any AppView procedure by nsid. `params` ride the query string (some
+     * procedures take their arguments there), `body` is the JSON input — omitted
+     * entirely when `undefined`. Escape hatch for procedures without a wrapper. */
+    post<T = unknown>(nsid: string, opts?: {
+        params?: Record<string, unknown>;
+        body?: unknown;
+    }): Promise<T>;
     /** An actor's most-played songs. */
     songs(actor: string, limit?: number, offset?: number): Promise<SongViewBasic[]>;
     /** An actor's loved (liked) songs. */
@@ -165,6 +172,35 @@ export declare class RockskyClient {
     playlists(limit?: number, offset?: number): Promise<PlaylistGetPlaylistsOutput>;
     /** A single playlist with its items. */
     playlist(uri: string): Promise<PlaylistViewDetailed>;
+    /**
+     * 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>;
+    /** Rename or re-describe a playlist (`app.rocksky.playlist.updatePlaylist`). Owner only. */
+    updatePlaylist(input: {
+        uri: string;
+        name?: string;
+        description?: string;
+        pictureUrl?: string;
+    }): Promise<PlaylistUpdatePlaylistOutput>;
+    /**
+     * 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>;
+    /** Delete a playlist and the caller's own entries (`app.rocksky.playlist.removePlaylist`). Owner only. */
+    removePlaylist(uri: string): Promise<void>;
+    /**
+     * 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>;
     /** Shouts on an album. */
     albumShouts(uri: string, limit?: number, offset?: number): Promise<GetAlbumShoutsOutput>;
     /** Shouts on an artist. */
@@ -188,5 +224,17 @@ export declare class RockskyClient {
      * to mark **all** of the viewer's notifications. Returns the number remaining
      * unread. */
     updateSeen(ids?: string[]): Promise<UpdateSeenOutput>;
+    /** Follow an account by DID or handle (`app.rocksky.graph.followAccount`). Auth required. */
+    followAccount(account: string): Promise<FollowAccountOutput>;
+    /** Unfollow an account by DID or handle (`app.rocksky.graph.unfollowAccount`). Auth required. */
+    unfollowAccount(account: string): Promise<UnfollowAccountOutput>;
+    /** Submit a scrobble through the AppView (`app.rocksky.scrobble.createScrobble`).
+     * Auth required. For direct-to-PDS scrobbling use {@link Agent} instead. */
+    createScrobble(input: CreateScrobbleInput): Promise<ScrobbleViewBasic>;
+    /** Create or update a mirror source (`app.rocksky.mirror.putMirrorSource`). Auth required. */
+    putMirrorSource(input: PutMirrorSourceInput): Promise<MirrorSourceView>;
+    /** Patch the viewer's Rockbox audio settings (`app.rocksky.rockbox.putAudioSettings`).
+     * Auth required. */
+    putAudioSettings(input: PutAudioSettingsInput): Promise<RockboxSettingsView>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test.d.ts.map

package/dist/client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../src/client.test.ts"],"names":[],"mappings":""}

package/dist/dedup.js

@@ -0,0 +1,215 @@
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/dedup.ts
+import { fromUint8Array } from "@atcute/car";
+import { decode as cborDecode, fromBytes, isBytes, isCidLink } from "@atcute/cbor";
+import { toString as cidToString } from "@atcute/cid";
+import { ClassicLevel } from "classic-level";
+
+// src/hash.ts
+import { sha256 } from "@noble/hashes/sha2.js";
+import { bytesToHex } from "@noble/hashes/utils.js";
+function sha256Lower(s) {
+  return bytesToHex(sha256(new TextEncoder().encode(s.toLowerCase())));
+}
+function songHash(title, artist, album) {
+  return sha256Lower(`${title} - ${artist} - ${album}`);
+}
+function albumHash(album, albumArtist) {
+  return sha256Lower(`${album} - ${albumArtist}`);
+}
+function artistHash(albumArtist) {
+  return sha256Lower(albumArtist);
+}
+
+// src/dedup.ts
+var C_ARTIST = "app.rocksky.artist";
+var C_ALBUM = "app.rocksky.album";
+var C_SONG = "app.rocksky.song";
+var C_SCROBBLE = "app.rocksky.scrobble";
+var SEP = "\x00";
+function totalIndexed(s) {
+  return s.artists + s.albums + s.songs + s.scrobbles;
+}
+function identKey(did, col, hash) {
+  return `${did}${SEP}${col}${SEP}${hash}`;
+}
+function scrobbleKey(did, songH, secs) {
+  return `${did}${SEP}${C_SCROBBLE}${SEP}${songH}${SEP}${secs}`;
+}
+function primaryFor(did, col, rec) {
+  const s = (k) => typeof rec[k] === "string" ? rec[k] : "";
+  switch (col) {
+    case C_ARTIST:
+      return s("name") ? identKey(did, C_ARTIST, artistHash(s("name"))) : undefined;
+    case C_ALBUM:
+      return s("title") && s("artist") ? identKey(did, C_ALBUM, albumHash(s("title"), s("artist"))) : undefined;
+    case C_SONG:
+      return s("title") && s("artist") && s("album") ? identKey(did, C_SONG, songHash(s("title"), s("artist"), s("album"))) : undefined;
+    case C_SCROBBLE: {
+      if (s("title") && s("artist") && s("album") && s("createdAt")) {
+        const secs = Math.floor(Date.parse(s("createdAt")) / 1000);
+        if (!Number.isNaN(secs))
+          return scrobbleKey(did, songHash(s("title"), s("artist"), s("album")), secs);
+      }
+      return;
+    }
+  }
+  return;
+}
+
+class RockskyIndex {
+  db;
+  constructor(path) {
+    this.db = new ClassicLevel(path, { keyEncoding: "utf8", valueEncoding: "utf8" });
+  }
+  open() {
+    return this.db.open();
+  }
+  close() {
+    return this.db.close();
+  }
+  async get(key) {
+    try {
+      return await this.db.get(key);
+    } catch {
+      return;
+    }
+  }
+  songUri(did, title, artist, album) {
+    return this.get(identKey(did, C_SONG, songHash(title, artist, album)));
+  }
+  albumUri(did, album, albumArtist) {
+    return this.get(identKey(did, C_ALBUM, albumHash(album, albumArtist)));
+  }
+  artistUri(did, albumArtist) {
+    return this.get(identKey(did, C_ARTIST, artistHash(albumArtist)));
+  }
+  scrobbleUri(did, title, artist, album, secs) {
+    return this.get(scrobbleKey(did, songHash(title, artist, album), secs));
+  }
+  async putPrimary(did, col, primary, uri) {
+    const rkey = uri.slice(uri.lastIndexOf("/") + 1);
+    await this.db.batch([
+      { type: "put", key: primary, value: uri },
+      { type: "put", key: `${SEP}rk${SEP}${did}${SEP}${col}${SEP}${rkey}`, value: primary }
+    ]);
+  }
+  recordSong(did, title, artist, album, uri) {
+    return this.putPrimary(did, C_SONG, identKey(did, C_SONG, songHash(title, artist, album)), uri);
+  }
+  recordAlbum(did, album, albumArtist, uri) {
+    return this.putPrimary(did, C_ALBUM, identKey(did, C_ALBUM, albumHash(album, albumArtist)), uri);
+  }
+  recordArtist(did, albumArtist, uri) {
+    return this.putPrimary(did, C_ARTIST, identKey(did, C_ARTIST, artistHash(albumArtist)), uri);
+  }
+  recordScrobble(did, title, artist, album, secs, uri) {
+    return this.putPrimary(did, C_SCROBBLE, scrobbleKey(did, songHash(title, artist, album), secs), uri);
+  }
+  cursor(did) {
+    return this.get(`${SEP}meta${SEP}cursor${SEP}${did}`).then((v) => v ? Number(v) : 0);
+  }
+  async setCursor(did, timeUS) {
+    await this.db.put(`${SEP}meta${SEP}cursor${SEP}${did}`, String(timeUS));
+  }
+  async indexCar(did, car) {
+    const reader = fromUint8Array(car);
+    const blocks = new Map;
+    for (const entry of reader)
+      blocks.set(cidToString(entry.cid), entry.bytes);
+    const root = reader.roots[0];
+    if (!root)
+      throw new Error("CAR has no root");
+    const commit = cborDecode(blocks.get(root.$link));
+    const stats = { artists: 0, albums: 0, songs: 0, scrobbles: 0 };
+    const ops = [];
+    for (const [path, valueLink] of walkMst(blocks, commit.data.$link)) {
+      const slash = path.indexOf("/");
+      if (slash < 0)
+        continue;
+      const col = path.slice(0, slash);
+      const rkey = path.slice(slash + 1);
+      if (col !== C_ARTIST && col !== C_ALBUM && col !== C_SONG && col !== C_SCROBBLE)
+        continue;
+      const recBytes = blocks.get(valueLink);
+      if (!recBytes)
+        continue;
+      const rec = cborDecode(recBytes);
+      const primary = primaryFor(did, col, rec);
+      if (!primary)
+        continue;
+      const uri = `at://${did}/${col}/${rkey}`;
+      ops.push({ type: "put", key: primary, value: uri });
+      ops.push({ type: "put", key: `${SEP}rk${SEP}${did}${SEP}${col}${SEP}${rkey}`, value: primary });
+      if (col === C_ARTIST)
+        stats.artists++;
+      else if (col === C_ALBUM)
+        stats.albums++;
+      else if (col === C_SONG)
+        stats.songs++;
+      else
+        stats.scrobbles++;
+    }
+    if (commit.rev)
+      ops.push({ type: "put", key: `${SEP}meta${SEP}rev${SEP}${did}`, value: commit.rev });
+    await this.db.batch(ops);
+    return stats;
+  }
+  async applyCommit(did, col, operation, rkey, record) {
+    if (operation === "create" || operation === "update") {
+      if (!record)
+        return;
+      const primary = primaryFor(did, col, record);
+      if (!primary)
+        return;
+      await this.putPrimary(did, col, primary, `at://${did}/${col}/${rkey}`);
+    } else if (operation === "delete") {
+      const rk = `${SEP}rk${SEP}${did}${SEP}${col}${SEP}${rkey}`;
+      const primary = await this.get(rk);
+      if (primary) {
+        await this.db.batch([
+          { type: "del", key: primary },
+          { type: "del", key: rk }
+        ]);
+      }
+    }
+  }
+}
+function* walkMst(blocks, cid) {
+  const raw = blocks.get(cid);
+  if (!raw)
+    return;
+  const node = cborDecode(raw);
+  if (node.l && isCidLink(node.l))
+    yield* walkMst(blocks, node.l.$link);
+  let last = new Uint8Array(0);
+  for (const e of node.e) {
+    const suffix = isBytes(e.k) ? fromBytes(e.k) : e.k;
+    const key = new Uint8Array(e.p + suffix.length);
+    key.set(last.subarray(0, e.p), 0);
+    key.set(suffix, e.p);
+    yield [new TextDecoder().decode(key), e.v.$link];
+    last = key;
+    if (e.t && isCidLink(e.t))
+      yield* walkMst(blocks, e.t.$link);
+  }
+}
+export {
+  RockskyIndex,
+  totalIndexed
+};

package/dist/errors.d.ts

@@ -1,6 +1,9 @@
-/** Error thrown when a Rocksky XRPC call returns a non-2xx `{ error, message }`. */
 export declare class RockskyError extends Error {
+    /** The XRPC error code (e.g. "InvalidRequest", "AuthMissing"), when the
+     * server sent one. */
     readonly kind?: string;
-    constructor(payload: unknown);
+    /** The HTTP status of the failed response, when known. */
+    readonly status?: number;
+    constructor(payload: unknown, status?: number);
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBACX,OAAO,EAAE,OAAO;CAM7B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;IACrC;0BACsB;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM;CAO9C"}

package/dist/generated/types.d.ts

@@ -114,6 +114,16 @@ export interface AddItemsToQueueParams {
     /** Whether to shuffle the added items in the queue */
     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;
@@ -677,10 +687,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 {
     scrobbles?: ScrobbleViewBasic[];
@@ -1309,6 +1321,20 @@ export interface LibrarySearchParams {
     /** Song result offset. */
     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;
@@ -1443,15 +1469,25 @@ export interface PlayFileParams {
     playerId?: string;
     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 {
     playlists?: PlaylistViewBasic[];
@@ -1461,14 +1497,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 {
     /** The name of the playlist. */
@@ -1490,6 +1520,42 @@ export interface PlaylistRecord {
     /** The Apple Music link of the playlist. */
     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. */
@@ -1514,6 +1580,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 */
 export interface PlaylistViewDetailed {
@@ -1632,8 +1700,8 @@ 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 from the playlist */
+    songUri: AtUri;
 }
 export interface ReplyShoutInput {
     /** The unique identifier of the shout to reply to */
@@ -2353,20 +2421,6 @@ export interface UpdateNowPlayingInput {
 }
 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[];
@@ -2469,7 +2523,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;
@@ -2490,7 +2544,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;
@@ -2498,6 +2553,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;