rocksky/decoders

Reusable gleam/dynamic/decode decoders for the public types in rocksky/types. These are exposed so callers can also decode raw Dynamic payloads themselves (e.g. embedded in custom responses).

Types

Album

</>

pub type Album =
  types.AlbumViewBasic

Artist

</>

pub type Artist =
  types.ArtistViewBasic

Listener

</>

pub type Listener =
  types.SongRecentListenerView

Profile

</>

pub type Profile =
  types.ActorProfileViewBasic

Scrobble

</>

pub type Scrobble =
  types.ScrobbleViewBasic

Song

</>

pub type Song =
  types.SongViewBasic

Stats

</>

pub type Stats =
  types.StatsView

Values

album

</>

pub fn album() -> decode.Decoder(types.AlbumViewBasic)

api_key

</>

pub fn api_key() -> decode.Decoder(types.ApiKey)

artist

</>

pub fn artist() -> decode.Decoder(types.ArtistViewBasic)

list_in_field

</>

pub fn list_in_field(
  key: String,
  inner: decode.Decoder(a),
) -> decode.Decoder(List(a))

Convenience: decode an object whose key field is a list of inner.

listener

</>

pub fn listener() -> decode.Decoder(types.SongRecentListenerView)

profile

</>

pub fn profile() -> decode.Decoder(types.ActorProfileViewBasic)

scrobble

</>

pub fn scrobble() -> decode.Decoder(types.ScrobbleViewBasic)

shout

</>

pub fn shout() -> decode.Decoder(types.Shout)

song

</>

pub fn song() -> decode.Decoder(types.SongViewBasic)

stats

</>

pub fn stats() -> decode.Decoder(types.StatsView)

unwrap

</>

pub fn unwrap(
  field_name: String,
  inner: decode.Decoder(a),
) -> decode.Decoder(List(a))

Decode { items: [...] }-shaped responses into a list of items. Many Rocksky list endpoints wrap their array in a single object field (e.g. { "scrobbles": [...] }, { "songs": [...] }). This helper hides that detail from callers that just want the list.