@rocksky/sdk 0.13.0 → 0.14.0

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, 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. */
@@ -188,5 +195,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":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,eAAe,EACf,QAAQ,EAGR,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EAEvB,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,kCAAkC,EAClC,+BAA+B,EAC/B,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAWD,oFAAoF;AACpF,eAAO,MAAM,QAAQ;IACnB,sCAAsC;mBACzB,YAAY;IACzB,oCAAoC;kBACtB,MAAM,KAAG,YAAY;IACnC,qCAAqC;mBACtB,MAAM,KAAG,YAAY;IACpC,sCAAsC;oBACtB,MAAM,KAAG,YAAY;IACrC,qCAAqC;mBACtB,MAAM,KAAG,YAAY;IACpC,gDAAgD;mBACjC,IAAI,OAAO,IAAI,KAAG,YAAY;CAI9C,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,eAAe,4BAA4B,CAAC;AAEzD,wEAAwE;AACxE,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,KAAK,CAAC,CAAS;IAEvB;;;;;OAKG;gBACS,OAAO,GAAE,MAAwB,EAAE,KAAK,CAAC,EAAE,MAAM;IAc7D;;;;OAIG;IACH,OAAO,IAAI,cAAc;YASX,KAAK;IAUnB,+DAA+D;IAC/D,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIzD,0CAA0C;IACpC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IASpF;gFAC4E;IAC5E,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzE;;mFAE+E;IACzE,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAO,GAC9D,OAAO,CAAC,CAAC,CAAC;IAYb,oCAAoC;IAC9B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAS5E,sCAAsC;IAChC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAQjF,qCAAqC;IAC/B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAS9E,sCAAsC;IAChC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAShF,qDAAqD;IACrD,SAAS,CAAC,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAI3D,sDAAsD;IACtD,UAAU,CAAC,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI9D,8DAA8D;IACxD,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IASxG,+DAA+D;IACzD,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAS3G;8DAC0D;IACpD,aAAa,CACjB,KAAK,SAAK,EACV,MAAM,SAAI,EACV,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC;IAU5B;+DAC2D;IACrD,cAAc,CAClB,KAAK,SAAK,EACV,MAAM,SAAI,EACV,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GACvB,OAAO,CAAC,eAAe,EAAE,CAAC;IAU7B;6DACyD;IACnD,YAAY,CAChB,KAAK,SAAK,EACV,MAAM,SAAI,EACV,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GACvB,OAAO,CAAC,aAAa,EAAE,CAAC;IAU3B,+CAA+C;IACzC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAKxD,8CAA8C;IACxC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAK1D,kDAAkD;IAC5C,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IASjF;;iEAE6D;IACvD,YAAY,CAChB,GAAG,CAAC,EAAE,MAAM,EACZ,SAAS,UAAQ,EACjB,KAAK,SAAK,EACV,MAAM,SAAI,EACV,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GACvB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAW/B,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIjD,oCAAoC;IAC9B,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAS3F,wCAAwC;IAClC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAS7F,yDAAyD;IACnD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAQlG,yEAAyE;IACzE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIrD,4BAA4B;IAC5B,WAAW,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAM5C,uDAAuD;IACvD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAGlE,yCAAyC;IACzC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAG9C,mCAAmC;IACnC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAGhD;iFAC6E;IAC7E,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAGjG,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE;QACT,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAG7B,4BAA4B;IAC5B,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAGvF,4CAA4C;IAC5C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAG5D,iEAAiE;IACjE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAGlE,sCAAsC;IACtC,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAGvF,oCAAoC;IACpC,qBAAqB,CACnB,GAAG,EAAE,MAAM,EACX,KAAK,SAAK,EACV,MAAM,SAAI,GACT,OAAO,CAAC,8BAA8B,CAAC;IAG1C,iCAAiC;IACjC,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAG/F;wEACoE;IACpE,cAAc,CAAC,IAAI,EAAE;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,GAAG,OAAO,CAAC,UAAU,CAAC;IAGvB,0CAA0C;IAC1C,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAG1D,wCAAwC;IACxC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAG5D,uBAAuB;IACvB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAGpF,yCAAyC;IACzC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAGhF,0CAA0C;IAC1C,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAGzF,yCAAyC;IACzC,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAGvF,kCAAkC;IAClC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAGxC,iCAAiC;IACjC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAGhE,8DAA8D;IAC9D,aAAa,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAGhD,mCAAmC;IACnC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kCAAkC,CAAC;IAGhG,iCAAiC;IACjC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAGzE,8CAA8C;IAC9C,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kCAAkC,CAAC;IAGnF,4BAA4B;IAC5B,SAAS,CAAC,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAGtE,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAGpD,0BAA0B;IAC1B,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAG/E,2BAA2B;IAC3B,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAGjF,2BAA2B;IAC3B,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAGrF,yBAAyB;IACzB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAGvD,0BAA0B;IAC1B,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAGjF,8CAA8C;IAC9C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAG1D,oCAAoC;IACpC,OAAO,CAAC,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAM1D,4DAA4D;IAC5D,WAAW,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAG5C;4DACwD;IACxD,aAAa,CAAC,KAAK,SAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAG5E;;iBAEa;IACP,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ3D,6FAA6F;IAC7F,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI5D,iGAAiG;IACjG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIhE;gFAC4E;IAC5E,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAItE,8FAA8F;IAC9F,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIvE;wBACoB;IACpB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAG7E"}

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/hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAQA,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtD"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAUA,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/index.d.ts

@@ -12,7 +12,7 @@ export { RockskyClient, DEFAULT_APPVIEW, Interval } from "./client.js";
 export type { DateInterval } from "./client.js";
 export { RockskyLibrary } from "./library.js";
 export { Agent, MAX_SAFE_WRITES_PER_HOUR, DEFAULT_MATCH_SONG_PER_HOUR, type ScrobbleInput, type ScrobbleMatchInput, type SongInput, type AlbumInput, type ArtistInput, type RateLimitOptions, type RateLimitState, } from "./agent.js";
-export { RockskyIndex, totalIndexed, type IndexStats } from "./dedup.js";
+export type { IndexStats, RockskyIndex } from "./dedup.js";
 export { runJetstream, DEFAULT_JETSTREAM_SERVERS, type JetstreamOptions } from "./jetstream.js";
 export { RemotePlayer, DEFAULT_REMOTE_WS, type RemotePlayerOptions, type RemotePlayerHandlers, type RemoteNowPlaying, type RemoteQueueItem, type EnqueueCommand, } from "./remote-player.js";
 export { RemoteController, type RemoteControllerOptions, type RemoteControllerEvents, type RemoteDevice, type RemoteStatus, } from "./remote-controller.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,KAAK,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,MAAM,EACN,UAAU,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,mBAAmB,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,KAAK,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,MAAM,EACN,UAAU,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,mBAAmB,sBAAsB,CAAC"}

package/dist/index.js

@@ -19,11 +19,13 @@ var RockskyError;
 var init_errors = __esm(() => {
   RockskyError = class RockskyError extends Error {
     kind;
-    constructor(payload) {
+    status;
+    constructor(payload, status) {
       const p = payload;
       super(p?.message || p?.error || "rocksky request failed");
       this.name = "RockskyError";
       this.kind = p?.error;
+      this.status = status;
     }
   };
 });
@@ -42,7 +44,7 @@ class RockskyLibrary {
     }
     const res = await this.rpc.get(nsid, { params: clean });
     if (!res.ok)
-      throw new RockskyError(res.data);
+      throw new RockskyError(res.data, res.status);
     return res.data;
   }
   async procedure(nsid, input) {
@@ -53,7 +55,7 @@ class RockskyLibrary {
     }
     const res = await this.rpc.post(nsid, { input: clean });
     if (!res.ok)
-      throw new RockskyError(res.data);
+      throw new RockskyError(res.data, res.status);
     return res.data;
   }
   ping() {
@@ -230,7 +232,7 @@ class RockskyClient {
     }
     const res = await this.rpc.get(nsid, { params: clean });
     if (!res.ok)
-      throw new RockskyError(res.data);
+      throw new RockskyError(res.data, res.status);
     return res.data;
   }
   profile(actor) {
@@ -247,6 +249,20 @@ class RockskyClient {
   get(nsid, params = {}) {
     return this.query(nsid, params);
   }
+  async post(nsid, opts = {}) {
+    const clean = {};
+    for (const [k, v] of Object.entries(opts.params ?? {})) {
+      if (v !== undefined && v !== "")
+        clean[k] = v;
+    }
+    const call = { params: clean };
+    if (opts.body !== undefined)
+      call.input = opts.body;
+    const res = await this.rpc.post(nsid, call);
+    if (!res.ok)
+      throw new RockskyError(res.data, res.status);
+    return res.data;
+  }
   async songs(actor, limit = 50, offset = 0) {
     const out = await this.query("app.rocksky.actor.getActorSongs", {
       did: actor,
@@ -489,9 +505,24 @@ class RockskyClient {
       input: ids && ids.length ? { ids } : {}
     });
     if (!res.ok)
-      throw new RockskyError(res.data);
+      throw new RockskyError(res.data, res.status);
     return res.data;
   }
+  followAccount(account) {
+    return this.post("app.rocksky.graph.followAccount", { params: { account } });
+  }
+  unfollowAccount(account) {
+    return this.post("app.rocksky.graph.unfollowAccount", { params: { account } });
+  }
+  createScrobble(input) {
+    return this.post("app.rocksky.scrobble.createScrobble", { body: input });
+  }
+  putMirrorSource(input) {
+    return this.post("app.rocksky.mirror.putMirrorSource", { body: input });
+  }
+  putAudioSettings(input) {
+    return this.post("app.rocksky.rockbox.putAudioSettings", { body: input });
+  }
 }
 var Interval, DEFAULT_APPVIEW = "https://api.rocksky.app";
 var init_client = __esm(() => {
@@ -745,7 +776,7 @@ class Agent {
       input: { repo: this.did, collection, record: { ...record, $type: collection } }
     });
     if (!res.ok)
-      throw new RockskyError(res.data);
+      throw new RockskyError(res.data, res.status);
     return res.data.uri;
   }
   async putRecord(collection, rkey, record) {
@@ -754,7 +785,7 @@ class Agent {
       input: { repo: this.did, collection, rkey, record: { ...record, $type: collection } }
     });
     if (!res.ok)
-      throw new RockskyError(res.data);
+      throw new RockskyError(res.data, res.status);
     return res.data.uri;
   }
   async delete(collection, rkey) {
@@ -763,7 +794,7 @@ class Agent {
       input: { repo: this.did, collection, rkey }
     });
     if (!res.ok)
-      throw new RockskyError(res.data);
+      throw new RockskyError(res.data, res.status);
   }
   async scrobble(rec) {
     const record = { ...rec, createdAt: rec.createdAt || nowISO() };
@@ -904,200 +935,6 @@ class Agent {
     return this.delete(C_STATUS, "self");
   }
 }
-// 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 { createHash } from "node:crypto";
-function sha256Lower(s) {
-  return createHash("sha256").update(s.toLowerCase()).digest("hex");
-}
-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_ARTIST2 = "app.rocksky.artist";
-var C_ALBUM2 = "app.rocksky.album";
-var C_SONG2 = "app.rocksky.song";
-var C_SCROBBLE2 = "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_SCROBBLE2}${SEP}${songH}${SEP}${secs}`;
-}
-function primaryFor(did, col, rec) {
-  const s = (k) => typeof rec[k] === "string" ? rec[k] : "";
-  switch (col) {
-    case C_ARTIST2:
-      return s("name") ? identKey(did, C_ARTIST2, artistHash(s("name"))) : undefined;
-    case C_ALBUM2:
-      return s("title") && s("artist") ? identKey(did, C_ALBUM2, albumHash(s("title"), s("artist"))) : undefined;
-    case C_SONG2:
-      return s("title") && s("artist") && s("album") ? identKey(did, C_SONG2, songHash(s("title"), s("artist"), s("album"))) : undefined;
-    case C_SCROBBLE2: {
-      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_SONG2, songHash(title, artist, album)));
-  }
-  albumUri(did, album, albumArtist) {
-    return this.get(identKey(did, C_ALBUM2, albumHash(album, albumArtist)));
-  }
-  artistUri(did, albumArtist) {
-    return this.get(identKey(did, C_ARTIST2, 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_SONG2, identKey(did, C_SONG2, songHash(title, artist, album)), uri);
-  }
-  recordAlbum(did, album, albumArtist, uri) {
-    return this.putPrimary(did, C_ALBUM2, identKey(did, C_ALBUM2, albumHash(album, albumArtist)), uri);
-  }
-  recordArtist(did, albumArtist, uri) {
-    return this.putPrimary(did, C_ARTIST2, identKey(did, C_ARTIST2, artistHash(albumArtist)), uri);
-  }
-  recordScrobble(did, title, artist, album, secs, uri) {
-    return this.putPrimary(did, C_SCROBBLE2, 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_ARTIST2 && col !== C_ALBUM2 && col !== C_SONG2 && col !== C_SCROBBLE2)
-        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_ARTIST2)
-        stats.artists++;
-      else if (col === C_ALBUM2)
-        stats.albums++;
-      else if (col === C_SONG2)
-        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);
-  }
-}
 // src/remote-player.ts
 var DEFAULT_REMOTE_WS = "wss://api.rocksky.app/ws";
 
@@ -1742,6 +1579,21 @@ var ScrobbleFields = {
   artistName: "artist.name",
   artistGenres: "artist.genres"
 };
+// 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/index.ts
 init_errors();
@@ -1760,13 +1612,11 @@ export {
   RemotePlayer,
   RockskyClient,
   RockskyError,
-  RockskyIndex,
   RockskyLibrary,
   ScrobbleFields,
   SongFields,
   albumHash,
   artistHash,
   runJetstream,
-  songHash,
-  totalIndexed
+  songHash
 };

package/dist/remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocksky/sdk",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "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": {
@@ -26,6 +26,11 @@
       "types": "./dist/remote.d.ts",
       "import": "./dist/remote.js",
       "default": "./dist/remote.js"
+    },
+    "./dedup": {
+      "types": "./dist/dedup.d.ts",
+      "import": "./dist/dedup.js",
+      "default": "./dist/dedup.js"
     }
   },
   "files": [
@@ -34,7 +39,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "bun build ./src/index.ts ./src/remote.ts --outdir ./dist --target node --format esm --packages external && bun run build:types",
+    "build": "bun build ./src/index.ts ./src/remote.ts ./src/dedup.ts --outdir ./dist --target node --format esm --packages external && bun run build:types",
     "build:types": "tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
@@ -69,6 +74,7 @@
     "@atcute/identity": "^2.0.2",
     "@atcute/identity-resolver": "^2.0.1",
     "@atcute/password-session": "^1.0.2",
+    "@noble/hashes": "^2.3.0",
     "classic-level": "^3.0.0"
   }
 }

package/src/agent.ts

@@ -325,7 +325,7 @@ export class Agent {
     const res = await this.rpc.post("com.atproto.repo.createRecord" as never, {
       input: { repo: this.did, collection, record: { ...record, $type: collection } },
     } as never);
-    if (!res.ok) throw new RockskyError(res.data);
+    if (!res.ok) throw new RockskyError(res.data, res.status);
     return (res.data as { uri: string }).uri;
   }
 
@@ -334,7 +334,7 @@ export class Agent {
     const res = await this.rpc.post("com.atproto.repo.putRecord" as never, {
       input: { repo: this.did, collection, rkey, record: { ...record, $type: collection } },
     } as never);
-    if (!res.ok) throw new RockskyError(res.data);
+    if (!res.ok) throw new RockskyError(res.data, res.status);
     return (res.data as { uri: string }).uri;
   }
 
@@ -344,7 +344,7 @@ export class Agent {
     const res = await this.rpc.post("com.atproto.repo.deleteRecord" as never, {
       input: { repo: this.did, collection, rkey },
     } as never);
-    if (!res.ok) throw new RockskyError(res.data);
+    if (!res.ok) throw new RockskyError(res.data, res.status);
   }
 
   /**

package/src/client.ts

@@ -11,6 +11,8 @@ import type {
   ArtistViewBasic,
   ArtistViewDetailed,
   ChartsView,
+  CreateScrobbleInput,
+  FollowAccountOutput,
   FeedGeneratorsView,
   FeedRecommendationsView,
   FeedRecommendedAlbumsView,
@@ -37,10 +39,13 @@ import type {
   GetTrackShoutsOutput,
   GetUnreadCountOutput,
   ListNotificationsOutput,
+  MirrorSourceView,
   PlayerCurrentlyPlayingViewDetailed,
   PlayerPlaybackQueueViewDetailed,
   PlaylistGetPlaylistsOutput,
   PlaylistViewDetailed,
+  PutAudioSettingsInput,
+  PutMirrorSourceInput,
   RockboxSettingsView,
   ScrobbleViewBasic,
   SongViewBasic,
@@ -48,6 +53,7 @@ import type {
   StatsGlobalStatsView,
   StatsView,
   StatsWrappedView,
+  UnfollowAccountOutput,
   UpdateSeenOutput,
 } from "./generated/types.js";
 
@@ -136,7 +142,7 @@ export class RockskyClient {
       if (v !== undefined && v !== "") clean[k] = v;
     }
     const res = await this.rpc.get(nsid as never, { params: clean } as never);
-    if (!res.ok) throw new RockskyError(res.data);
+    if (!res.ok) throw new RockskyError(res.data, res.status);
     return res.data as T;
   }
 
@@ -161,6 +167,24 @@ export class RockskyClient {
     return this.query(nsid, params);
   }
 
+  /** 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. */
+  async post<T = unknown>(
+    nsid: string,
+    opts: { params?: Record<string, unknown>; body?: unknown } = {},
+  ): Promise<T> {
+    const clean: Record<string, unknown> = {};
+    for (const [k, v] of Object.entries(opts.params ?? {})) {
+      if (v !== undefined && v !== "") clean[k] = v;
+    }
+    const call: Record<string, unknown> = { params: clean };
+    if (opts.body !== undefined) call.input = opts.body;
+    const res = await this.rpc.post(nsid as never, call as never);
+    if (!res.ok) throw new RockskyError(res.data, res.status);
+    return res.data as T;
+  }
+
   /** An actor's most-played songs. */
   async songs(actor: string, limit = 50, offset = 0): Promise<SongViewBasic[]> {
     const out = await this.query<{ tracks?: SongViewBasic[] }>("app.rocksky.actor.getActorSongs", {
@@ -539,7 +563,34 @@ export class RockskyClient {
     const res = await this.rpc.post("app.rocksky.notification.updateSeen" as never, {
       input: (ids && ids.length ? { ids } : {}) as never,
     } as never);
-    if (!res.ok) throw new RockskyError(res.data);
+    if (!res.ok) throw new RockskyError(res.data, res.status);
     return res.data as UpdateSeenOutput;
   }
+
+  /** Follow an account by DID or handle (`app.rocksky.graph.followAccount`). Auth required. */
+  followAccount(account: string): Promise<FollowAccountOutput> {
+    return this.post("app.rocksky.graph.followAccount", { params: { account } });
+  }
+
+  /** Unfollow an account by DID or handle (`app.rocksky.graph.unfollowAccount`). Auth required. */
+  unfollowAccount(account: string): Promise<UnfollowAccountOutput> {
+    return this.post("app.rocksky.graph.unfollowAccount", { params: { account } });
+  }
+
+  /** 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> {
+    return this.post("app.rocksky.scrobble.createScrobble", { body: input });
+  }
+
+  /** Create or update a mirror source (`app.rocksky.mirror.putMirrorSource`). Auth required. */
+  putMirrorSource(input: PutMirrorSourceInput): Promise<MirrorSourceView> {
+    return this.post("app.rocksky.mirror.putMirrorSource", { body: input });
+  }
+
+  /** Patch the viewer's Rockbox audio settings (`app.rocksky.rockbox.putAudioSettings`).
+   * Auth required. */
+  putAudioSettings(input: PutAudioSettingsInput): Promise<RockboxSettingsView> {
+    return this.post("app.rocksky.rockbox.putAudioSettings", { body: input });
+  }
 }

package/src/errors.ts

@@ -1,10 +1,15 @@
-/** Error thrown when a Rocksky XRPC call returns a non-2xx `{ error, message }`. */
 export 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) {
     const p = payload as { error?: string; message?: string } | undefined;
     super(p?.message || p?.error || "rocksky request failed");
     this.name = "RockskyError";
     this.kind = p?.error;
+    this.status = status;
   }
 }

package/src/hash.ts

@@ -1,9 +1,11 @@
-import { createHash } from "node:crypto";
+import { sha256 } from "@noble/hashes/sha2.js";
+import { bytesToHex } from "@noble/hashes/utils.js";
 
 // Lowercase-hex SHA-256 of s.toLowerCase() — the lowercasing is applied to the
 // whole string (not per field), matching Rocksky's server and every other SDK.
+// Pure-JS digest (@noble/hashes) so this module stays browser-safe.
 function sha256Lower(s: string): string {
-  return createHash("sha256").update(s.toLowerCase()).digest("hex");
+  return bytesToHex(sha256(new TextEncoder().encode(s.toLowerCase())));
 }
 
 /** Identity hash of a song: sha256(lower("{title} - {artist} - {album}")). */

package/src/index.ts

@@ -23,7 +23,9 @@ export {
   type RateLimitOptions,
   type RateLimitState,
 } from "./agent.js";
-export { RockskyIndex, totalIndexed, type IndexStats } from "./dedup.js";
+// The dedup index (classic-level, Node-only) lives on the `@rocksky/sdk/dedup`
+// subpath so this root entry stays browser-safe.
+export type { IndexStats, RockskyIndex } from "./dedup.js";
 export { runJetstream, DEFAULT_JETSTREAM_SERVERS, type JetstreamOptions } from "./jetstream.js";
 export {
   RemotePlayer,

package/src/library.ts

@@ -20,7 +20,7 @@ export class RockskyLibrary {
       if (v !== undefined && v !== "") clean[k] = v;
     }
     const res = await this.rpc.get(nsid as never, { params: clean } as never);
-    if (!res.ok) throw new RockskyError(res.data);
+    if (!res.ok) throw new RockskyError(res.data, res.status);
     return res.data as T;
   }
 
@@ -30,7 +30,7 @@ export class RockskyLibrary {
       if (v !== undefined && v !== "") clean[k] = v;
     }
     const res = await this.rpc.post(nsid as never, { input: clean } as never);
-    if (!res.ok) throw new RockskyError(res.data);
+    if (!res.ok) throw new RockskyError(res.data, res.status);
     return res.data as T;
   }
 

package/src/remote.ts

@@ -1,9 +1,8 @@
-// Browser-safe entry: the remote-control player + controller only.
+// Lightweight entry: the remote-control player + controller only.
 //
-// The main entry (`@rocksky/sdk`) bundles the dedup index (classic-level) and
-// the identity hashes (node:crypto), which are Node-only. The remote player /
-// controller are pure WebSocket + JSON with zero Node dependencies, so this
-// subpath (`@rocksky/sdk/remote`) is safe to import from a browser bundle.
+// Since 0.14.0 the main entry (`@rocksky/sdk`) is browser-safe too — the
+// dedup index (classic-level, Node-only) moved to `@rocksky/sdk/dedup`. This
+// subpath remains for consumers that only need the remote player/controller.
 
 export {
   RemotePlayer,