@rocksky/sdk 0.14.0 → 0.14.1

package/dist/library.d.ts

@@ -1,4 +1,82 @@
 import type { Client } from "@atcute/client";
+/** A song in the library, in the Subsonic `Child` shape. */
+export interface LibrarySong {
+    id: string;
+    title: string;
+    artist: string;
+    album: string;
+    albumArtist?: string;
+    /** Seconds, not milliseconds — Subsonic's unit. */
+    duration: number;
+    coverArt?: string;
+    albumId?: string;
+    artistId?: string;
+    track?: number;
+    discNumber?: number;
+    genre?: string;
+    suffix?: string;
+    contentType?: string;
+    size?: number;
+    musicBrainzId?: string;
+    samplingRate?: number;
+}
+/**
+ * A library playlist. Subsonic's `Playlist` shape plus two Rocksky extensions:
+ * `uri` and `trackArts`.
+ */
+export interface LibraryPlaylist {
+    id: string;
+    name: string;
+    songCount: number;
+    /** Seconds. */
+    duration: number;
+    created: string;
+    changed: string;
+    public: boolean;
+    comment?: string;
+    coverArt?: string;
+    /**
+     * AT-URI of the `app.rocksky.playlist` record this playlist is mirrored to.
+     * Absent while the record has yet to be published.
+     */
+    uri?: string;
+    /**
+     * Album art of up to four of the playlist's tracks, oldest first — enough
+     * for a cover mosaic. Absent when none of them have art.
+     */
+    trackArts?: string[];
+    /** Only present on `getPlaylist`. */
+    entry?: LibrarySong[];
+}
+/** Envelope every navidrome method replies with. */
+interface SubsonicResponse {
+    status: string;
+    version?: string;
+    type?: string;
+}
+/**
+ * Reply to a playlist mutation.
+ *
+ * The playlist is mirrored to the caller's PDS as an `app.rocksky.playlist`
+ * record. That mirror runs after the library has already been updated, so it
+ * can't fail the call: when it does fail, the library change still stands and
+ * the reason lands in `atprotoError` for the caller to surface.
+ */
+export interface LibraryPlaylistMutation extends SubsonicResponse {
+    /** The resulting playlist — `createPlaylist` only. */
+    playlist?: LibraryPlaylist;
+    /** AT-URI of the mirrored record, when one was published or already existed. */
+    uri?: string;
+    atprotoError?: string;
+}
+export interface LibraryPlaylistsResponse extends SubsonicResponse {
+    playlists: {
+        playlist: LibraryPlaylist[];
+    };
+}
+export interface LibraryPlaylistResponse extends SubsonicResponse {
+    playlist: LibraryPlaylist;
+}
 /**
  * Authenticated client for the `app.rocksky.library.*` API — the Subsonic /
  * navidrome-compatible surface over a user's uploaded music.
@@ -98,23 +176,34 @@ export declare class RockskyLibrary {
         artistId?: string;
     }): Promise<unknown>;
     /** `app.rocksky.library.getPlaylists` — requires auth. */
-    getPlaylists(): Promise<unknown>;
+    getPlaylists(): Promise<LibraryPlaylistsResponse>;
     /** `app.rocksky.library.getPlaylist` — requires auth. */
-    getPlaylist(id: string): Promise<unknown>;
-    /** `app.rocksky.library.createPlaylist` — requires auth. */
-    createPlaylist(name: string): Promise<unknown>;
-    /** `app.rocksky.library.updatePlaylist` — requires auth. */
+    getPlaylist(id: string): Promise<LibraryPlaylistResponse>;
+    /**
+     * `app.rocksky.library.createPlaylist` — requires auth.
+     *
+     * Also publishes an `app.rocksky.playlist` record to the caller's PDS; see
+     * {@link LibraryPlaylistMutation} for how a failure there is reported.
+     */
+    createPlaylist(name: string): Promise<LibraryPlaylistMutation>;
+    /**
+     * `app.rocksky.library.updatePlaylist` — requires auth.
+     *
+     * Renames, adds a song or removes the song at a position, and replays the
+     * same change onto the mirrored record.
+     */
     updatePlaylist(playlistId: string, opts?: {
         name?: string;
         comment?: string;
         songIdToAdd?: string;
         songIndexToRemove?: number;
-    }): Promise<unknown>;
-    /** `app.rocksky.library.deletePlaylist` — requires auth. */
-    deletePlaylist(id: string): Promise<{
-        status: string;
-        deleted: number;
-    }>;
+    }): Promise<LibraryPlaylistMutation>;
+    /**
+     * `app.rocksky.library.deletePlaylist` — requires auth.
+     *
+     * Retracts the mirrored record and the caller's entries in it too.
+     */
+    deletePlaylist(id: string): Promise<LibraryPlaylistMutation>;
     /** `app.rocksky.library.deleteSong` — requires auth. */
     deleteSong(id: string): Promise<{
         status: string;
@@ -162,4 +251,5 @@ export declare class RockskyLibrary {
     /** `app.rocksky.library.getInternetRadioStations` — requires auth. */
     getInternetRadioStations(): Promise<unknown>;
 }
+export {};
 //# sourceMappingURL=library.d.ts.map

package/dist/library.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocksky/sdk",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "TypeScript SDK for Rocksky — built on atcute: AppView reads, AT Protocol PDS writes (scrobble, like, follow, shout), a local dedup index, and Jetstream real-time sync.",
   "license": "MIT",
   "repository": {

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

@@ -53,6 +53,9 @@ import type {
   StatsGlobalStatsView,
   StatsView,
   StatsWrappedView,
+  PlaylistCreatePlaylistOutput,
+  PlaylistUpdatePlaylistOutput,
+  AddSongsOutput,
   UnfollowAccountOutput,
   UpdateSeenOutput,
 } from "./generated/types.js";
@@ -113,11 +116,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 });
   }
@@ -516,6 +524,54 @@ export class RockskyClient {
   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/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;
@@ -755,10 +767,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 {
@@ -1565,6 +1579,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;
@@ -1723,16 +1754,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 +1786,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 +1811,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 +1874,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 */
@@ -1929,8 +2005,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 {
@@ -2714,23 +2790,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[];
@@ -2835,7 +2894,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 +2915,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 +2924,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;

package/src/index.ts

@@ -10,7 +10,14 @@
  */
 export { RockskyClient, DEFAULT_APPVIEW, Interval } from "./client.js";
 export type { DateInterval } from "./client.js";
-export { RockskyLibrary } from "./library.js";
+export {
+  RockskyLibrary,
+  type LibrarySong,
+  type LibraryPlaylist,
+  type LibraryPlaylistMutation,
+  type LibraryPlaylistResponse,
+  type LibraryPlaylistsResponse,
+} from "./library.js";
 export {
   Agent,
   MAX_SAFE_WRITES_PER_HOUR,