rocksky/playlist

app.rocksky.playlist.* — the global, AT-Proto-backed playlists.

Distinct from rocksky/library, whose playlist functions drive the Subsonic/Navidrome library (app.rocksky.library.*).

Writes publish records to the caller’s repo, so they take a token and only appear in reads once the AppView has ingested the commit. Pass "" to omit an optional argument.

Values

add_songs

</>

pub fn add_songs(
  token: String,
  uri: String,
  songs: List(String),
) -> dynamic.Dynamic

Add songs by their app.rocksky.song AT-URIs. Owner only.

add_songs_at

</>

pub fn add_songs_at(
  base: String,
  token: String,
  uri: String,
  songs: List(String),
) -> dynamic.Dynamic

add_songs against a custom AppView endpoint.

create

</>

pub fn create(token: String, name: String) -> dynamic.Dynamic

Create a playlist. Returns the new record’s uri and cid.

create_full

</>

pub fn create_full(
  base: String,
  token: String,
  name: String,
  description: String,
  picture_url: String,
) -> dynamic.Dynamic

create with a description, cover image and custom endpoint.

get

</>

pub fn get(uri: String) -> dynamic.Dynamic

A single playlist with its tracks.

get_at

</>

pub fn get_at(base: String, uri: String) -> dynamic.Dynamic

get against a custom AppView endpoint.

list

</>

pub fn list(limit: Int, offset: Int) -> dynamic.Dynamic

The playlist catalog.

list_at

</>

pub fn list_at(
  base: String,
  limit: Int,
  offset: Int,
) -> dynamic.Dynamic

list against a custom AppView endpoint.

post

</>

pub fn post(
  nsid: String,
  params_json: String,
  token: String,
) -> dynamic.Dynamic

Escape hatch — any app.rocksky.* procedure whose arguments ride the query string. params_json is a pre-encoded JSON object.

remove

</>

pub fn remove(token: String, uri: String) -> dynamic.Dynamic

Delete a playlist and the caller’s own entries. Owner only.

remove_track

</>

pub fn remove_track(
  token: String,
  uri: String,
  song_uri: String,
) -> dynamic.Dynamic

Remove a song. Only the repo that added an entry can retract it.

update

</>

pub fn update(
  base: String,
  token: String,
  uri: String,
  name: String,
  description: String,
  picture_url: String,
) -> dynamic.Dynamic

Rename or re-describe a playlist. Owner only; the AT-URI is unchanged.