Kotlin

dependencies {
    implementation("app.rocksky:rocksky-kotlin:0.2.0")
}

import app.rocksky.RockskyClient
import kotlinx.coroutines.runBlocking

fun main() = runBlocking {
    RockskyClient().use { client ->
        val profile = client.actor.getProfile(did = "did:plc:example")
        println("${profile.handle} — ${profile.displayName}")

        val top = client.charts.topTracks(limit = 10)
        top.forEach { println("${it.title} by ${it.artist}") }
    }
}

// 1. Named arguments (default)
client.scrobble.create(
    title = "Idioteque",
    artist = "Radiohead",
    album = "Kid A",
    duration = 369,
)

// 2. Kotlin DSL
client.scrobble.create {
    title = "Idioteque"
    artist = "Radiohead"
    album = "Kid A"
    duration = 369
}

// 3. Fluent builder (Java-friendly)
client.scrobble.builder()
    .title("Idioteque")
    .artist("Radiohead")
    .album("Kid A")
    .duration(369L)
    .send()

val client = RockskyClient {
    token = System.getenv("ROCKSKY_TOKEN")
    userAgent = "my-app/1.0"
}

import app.rocksky.AuthenticationException
import app.rocksky.NotFoundException
import app.rocksky.RateLimitException
import app.rocksky.ApiException

try {
    client.scrobble.create(title = "…", artist = "…", album = "…")
} catch (e: AuthenticationException) {
    // 401 — refresh token
} catch (e: RateLimitException) {
    // 429 — back off
} catch (e: NotFoundException) {
    // 404
} catch (e: ApiException) {
    // e.statusCode, e.error, e.serverMessage, e.body
}

val client = RockskyClient {
    baseUrl       = "https://api.rocksky.app"  // default
    token         = "…"                         // optional bearer
    userAgent     = "my-app/1.0"
    timeoutMillis = 30_000

    // engine = OkHttp.create()
    // httpClient = myExistingKtorClient
    configureClient { /* install logging, custom retry, … */ }
}