rocksky.core — app.rocksky/sdk 0.5.0-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.

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.

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 mb-id isrc base)

Resolve full canonical metadata for a bare title + artist (matchSong).

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)

scrobble clj

(scrobble agent track)

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

scrobble-match clj

(scrobble-match agent title artist)

(scrobble-match agent title artist album)

(scrobble-match agent title artist album mb-id isrc)

Scrobble from just a title + artist (album optional, plus optional mb-id / isrc anchors): resolve full metadata via matchSong, then fan 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)

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).