rocksky.core — app.rocksky/sdk 0.10.1-SNAPSHOT

Native core bindings for Rocksky.

JVM Panama (java.lang.foreign) bindings to the shared Rust core's C ABI (crates/rocksky-uniffi). AT Protocol PDS writes (scrobble fan-out, like, follow, shout), AppView reads, and the identity hashes shared across every Rocksky SDK. This is the write + dedup side; rocksky.client is the read/HTTP side. Requires JDK 22+ (run with --enable-native-access=ALL-UNNAMED).

agent-close clj

(agent-close agent)

Release an agent's native handle.

catalog-albums clj

(catalog-albums)

(catalog-albums {:keys [base] :as opts})

Browse the album catalog (app.rocksky.album.getAlbums). opts may contain :limit (default 50), :offset (default 0), :genre, :filter (an rsql node or RSQL string) and :base.

catalog-artists clj

(catalog-artists)

(catalog-artists {:keys [base] :as opts})

Browse the artist catalog (app.rocksky.artist.getArtists). opts may contain :limit (default 50), :offset (default 0), :genre, :filter (an rsql node or RSQL string) and :base.

catalog-songs clj

(catalog-songs)

(catalog-songs {:keys [base] :as opts})

Browse the song catalog (app.rocksky.song.getSongs). opts may contain :limit (default 50), :offset (default 0), :genre, :filter (an rsql node or RSQL string) and :base.

(catalog-songs {:limit 10 :filter (rsql/eq :artist "Daft Punk")})

follow clj

(follow agent did)

global-stats clj

(global-stats)

(global-stats base)

Platform-wide totals.

hydrate-from-jetstream clj

(hydrate-from-jetstream agent)

Keep the local dedup index hydrated from Jetstream in the background.

library-get clj

(library-get token nsid params)

(library-get token nsid params base)

Authenticated app.rocksky.library.* query escape hatch. token is required — every library call is auth-gated. params is a map (camelCase keyword keys).

library-post clj

(library-post token nsid body)

(library-post token nsid body base)

Authenticated app.rocksky.library.* procedure escape hatch. token is required. body is a map (camelCase keyword keys).

like clj

(like agent uri cid)

login clj

(login session-path identifier password & {:keys [appview dedup-path]})

Log in with an app password, persisting the session at session-path.

match-song clj

(match-song title artist)

(match-song title artist album)

(match-song title artist album mb-id isrc base)

Resolve full canonical metadata for a bare title + artist (matchSong). album steers the match toward that release (case-insensitive) so a remaster/live/single edition doesn't shadow the intended album.

notifications clj

(notifications token)

(notifications token opts)

(notifications token opts base)

The authenticated viewer's notifications, most recent first. token is required; opts may contain :limit (default 30) and :cursor. Returns {"notifications" [...] "unreadCount" n "cursor" c?}.

procedure clj

(procedure nsid params)

(procedure nsid params base)

(procedure nsid params base token)

Universal write escape hatch — call any app.rocksky.* procedure whose arguments ride the query string. Most are auth-gated, so pass token.

(procedure "app.rocksky.playlist.removePlaylist" {:uri uri} nil token)

profile clj

(profile actor)

(profile actor base)

An actor's detailed profile.

query clj

(query nsid params)

(query nsid params base)

(query nsid params base token)

Universal read escape hatch — call any app.rocksky.* query by nsid. params is a map of string params; the whole read-query catalog is reachable here.

(query "app.rocksky.album.getAlbum" {:uri uri}) (query "app.rocksky.charts.getScrobblesChart" {:did did})

refresh-session clj

(refresh-session agent)

reply-shout-with-gif clj

(reply-shout-with-gif agent
                      subject-uri
                      subject-cid
                      parent-uri
                      parent-cid
                      message
                      gif)

Reply to a shout with an optional GIF/sticker/clip (see shout-with-gif), plus a parent strong-ref (parent-uri/parent-cid).

scrobble clj

(scrobble agent track)

Scrobble a play (fans out to artist/album/song/scrobble). Returns the URIs.

scrobble-feed clj

(scrobble-feed)

(scrobble-feed {:keys [base] :as opts})

The global scrobble feed (app.rocksky.scrobble.getScrobbles). opts may contain :did (narrow to one user), :following (boolean), :limit (default 50), :offset (default 0), :filter (an rsql node or RSQL string — dotted selectors like :track.artist reach the joined entities) and :base.

(scrobble-feed {:filter (rsql/eq :track.artist "Daft Punk")})

scrobble-match clj

(scrobble-match agent input)

Scrobble from a title + artist. input is a map with camelCase keys: required :title/:artist; optional :album, :mbId, :isrc (match anchors) and :timestamp (scrobbled-at Unix seconds, default now). Resolves full metadata via matchSong, then fans out.

scrobbles clj

(scrobbles actor limit)

(scrobbles actor limit offset base)

An actor's scrobbles, newest first.

shout clj

(shout agent subject-uri subject-cid message)

shout-with-gif clj

(shout-with-gif agent subject-uri subject-cid message gif)

Post a shout with an optional GIF/sticker/clip. Pass at least one of message / gif (a map: :url required, plus :previewUrl :alt :width :height).

song-hash clj

(song-hash title artist album)

Identity hash of a song — identical across every Rocksky SDK.

sync-repo clj

(sync-repo agent)

Download the caller's repo and (re)build the local dedup index (needs a :dedup-path at login). Returns the per-collection counts.

top-artists-interval clj

(top-artists-interval limit offset interval)

(top-artists-interval limit offset interval base)

Top artists chart over a typed date window (see top-tracks-interval).

top-tracks clj

(top-tracks limit)

(top-tracks limit offset)

(top-tracks limit offset base)

Platform-wide top tracks chart. base overrides the AppView URL.

top-tracks-interval clj

(top-tracks-interval limit offset interval)

(top-tracks-interval limit offset interval base)

Top tracks chart over a typed date window (see interval-parts for the shape).

unread-count clj

(unread-count token)

(unread-count token base)

The authenticated viewer's unread-notification count. Returns {"count" n}. token is required.

update-seen clj

(update-seen token ids)

(update-seen token ids base)

Mark notifications as viewed. ids is a vector of notification ids, or [] to mark all. token is required. Returns {"unreadCount" n}.