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

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

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

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?}.

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