rocksky 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5ff00fa4d526c5436fb713d32c4f49f85609263ccf950ea51a2091bec6d8951
-  data.tar.gz: 161fb86cda0ae97b7044a10c9d5a249971143d00d6cf27560500199ebfdcfbfa
+  metadata.gz: 04a23ddf1b0b2c3207cb576fa5809509520ffe2caa5af6edd45c8e8d56f6a873
+  data.tar.gz: e3477fabe8cded03dadb16353781143f9c70722c7e38196154a4c01e47a54583
 SHA512:
-  metadata.gz: 4c279685557ce908beb4d7e763a6b4d3a6fd6e55d51158aa518bdeb70189ecec3b22b2367bd0cdcb61e72439a22f73745159b21d64326a02d49f2f6cec608a26
-  data.tar.gz: 8c09668a64234fc5064e50b53e039cbc9ae2d077290cac0dbeb0769f175ae6f24a65f11a7ae039af34d38793dbbb2897283ff23e7978a87e1ce9453d558c5275
+  metadata.gz: 14b72030dbe0dd39f5b277af0729913f71739c89e62d57c89b46abb8bc23300f991bcb6e8b5ee485197886058d372c57e31a27d92b5fd53d3b2e2d644e50d859
+  data.tar.gz: 83c8ce3c29d4b90f2baa3f9111fe1207099bb89435aa142edbbbd3bef2a13af9ba19ec2d997b4544b72e2e972958ebe98f78083aff6a0d167d8756d76294c1b4

data/README.md

@@ -14,7 +14,7 @@ gem install rocksky
 Or in a Gemfile:
 
 ```ruby
-gem "rocksky", "~> 0.5"
+gem "rocksky", "~> 0.7"
 ```
 
 The gem is pure-Ruby; the native library is fetched from the GitHub release on
@@ -92,11 +92,14 @@ below). Then `scrobble(track)` (fans out to artist/album/song/scrobble),
 `refresh_session`, and `close` (release the native handle).
 
 **Two scrobble paths** — `scrobble(track)` takes full metadata, while
-`scrobble_match(title, artist, album: nil, mb_id: nil, isrc: nil)` matches a bare
+`scrobble_match(params)` takes a single Hash with camelCase string keys —
+required `"title"`/`"artist"`, optional `"album"` (override), `"mbId"`/`"isrc"`
+(match anchors), `"timestamp"` (scrobbled-at Unix seconds) — matching a bare
 title + artist first, then writes.
 
 ```ruby
-agent.scrobble_match("Chaser", "Calibro 35", album: "Jazzploitation")
+agent.scrobble_match("title" => "Chaser", "artist" => "Calibro 35",
+                     "album" => "Jazzploitation")
 ```
 
 **Dedup + realtime** — with `dedup_path:` set at login, `agent.sync_repo`

data/lib/rocksky/library.rb

@@ -0,0 +1,232 @@
+# frozen_string_literal: true
+
+module Rocksky
+  # Authenticated client for the app.rocksky.library.* API — the Subsonic /
+  # navidrome-compatible surface over a user's uploaded music. Every method
+  # requires auth, so a token is mandatory at construction (see Rocksky.library).
+  # Optional params are Ruby keyword args (nil = omitted); wire keys stay
+  # camelCase. Returns the parsed JSON payload.
+  class Library
+    def initialize(token, base: nil)
+      raise Error, "app.rocksky.library.* requires an access token" if token.nil? || token.to_s.empty?
+
+      @token = token.to_s
+      @base = base.to_s
+    end
+
+    # app.rocksky.library.ping
+    def ping()
+      query("app.rocksky.library.ping", {})
+    end
+
+    # app.rocksky.library.getLicense
+    def get_license()
+      query("app.rocksky.library.getLicense", {})
+    end
+
+    # app.rocksky.library.getMusicFolders
+    def get_music_folders()
+      query("app.rocksky.library.getMusicFolders", {})
+    end
+
+    # app.rocksky.library.getScanStatus
+    def get_scan_status()
+      query("app.rocksky.library.getScanStatus", {})
+    end
+
+    # app.rocksky.library.startScan
+    def start_scan()
+      query("app.rocksky.library.startScan", {})
+    end
+
+    # app.rocksky.library.getUser
+    def get_user()
+      query("app.rocksky.library.getUser", {})
+    end
+
+    # app.rocksky.library.getArtists
+    def get_artists()
+      query("app.rocksky.library.getArtists", {})
+    end
+
+    # app.rocksky.library.getIndexes
+    def get_indexes()
+      query("app.rocksky.library.getIndexes", {})
+    end
+
+    # app.rocksky.library.getArtist
+    def get_artist(id)
+      query("app.rocksky.library.getArtist", { id: id })
+    end
+
+    # app.rocksky.library.getArtistInfo
+    def get_artist_info(id)
+      query("app.rocksky.library.getArtistInfo", { id: id })
+    end
+
+    # app.rocksky.library.getAlbum
+    def get_album(id)
+      query("app.rocksky.library.getAlbum", { id: id })
+    end
+
+    # app.rocksky.library.getAlbumList
+    def get_album_list(type, size: nil, offset: nil, from_year: nil, to_year: nil, genre: nil)
+      query("app.rocksky.library.getAlbumList", { type: type, size: size, offset: offset, fromYear: from_year, toYear: to_year, genre: genre })
+    end
+
+    # app.rocksky.library.getAlbumInfo
+    def get_album_info(id)
+      query("app.rocksky.library.getAlbumInfo", { id: id })
+    end
+
+    # app.rocksky.library.getSong
+    def get_song(id)
+      query("app.rocksky.library.getSong", { id: id })
+    end
+
+    # app.rocksky.library.getRandomSongs
+    def get_random_songs(size: nil, genre: nil, from_year: nil, to_year: nil)
+      query("app.rocksky.library.getRandomSongs", { size: size, genre: genre, fromYear: from_year, toYear: to_year })
+    end
+
+    # app.rocksky.library.getSongsByGenre
+    def get_songs_by_genre(genre, count: nil, offset: nil)
+      query("app.rocksky.library.getSongsByGenre", { genre: genre, count: count, offset: offset })
+    end
+
+    # app.rocksky.library.getSimilarSongs
+    def get_similar_songs(id, count: nil)
+      query("app.rocksky.library.getSimilarSongs", { id: id, count: count })
+    end
+
+    # app.rocksky.library.getTopSongs
+    def get_top_songs(artist, count: nil)
+      query("app.rocksky.library.getTopSongs", { artist: artist, count: count })
+    end
+
+    # app.rocksky.library.getLyrics
+    def get_lyrics(artist: nil, title: nil)
+      query("app.rocksky.library.getLyrics", { artist: artist, title: title })
+    end
+
+    # app.rocksky.library.getMusicDirectory
+    def get_music_directory(id)
+      query("app.rocksky.library.getMusicDirectory", { id: id })
+    end
+
+    # app.rocksky.library.getGenres
+    def get_genres()
+      query("app.rocksky.library.getGenres", {})
+    end
+
+    # app.rocksky.library.search
+    def search(query, artist_count: nil, artist_offset: nil, album_count: nil, album_offset: nil, song_count: nil, song_offset: nil)
+      query("app.rocksky.library.search", { query: query, artistCount: artist_count, artistOffset: artist_offset, albumCount: album_count, albumOffset: album_offset, songCount: song_count, songOffset: song_offset })
+    end
+
+    # app.rocksky.library.getStarred
+    def get_starred()
+      query("app.rocksky.library.getStarred", {})
+    end
+
+    # app.rocksky.library.star
+    def star(id, album_id: nil, artist_id: nil)
+      procedure("app.rocksky.library.star", { id: id, albumId: album_id, artistId: artist_id })
+    end
+
+    # app.rocksky.library.unstar
+    def unstar(id, album_id: nil, artist_id: nil)
+      procedure("app.rocksky.library.unstar", { id: id, albumId: album_id, artistId: artist_id })
+    end
+
+    # app.rocksky.library.getPlaylists
+    def get_playlists()
+      query("app.rocksky.library.getPlaylists", {})
+    end
+
+    # app.rocksky.library.getPlaylist
+    def get_playlist(id)
+      query("app.rocksky.library.getPlaylist", { id: id })
+    end
+
+    # app.rocksky.library.createPlaylist
+    def create_playlist(name)
+      procedure("app.rocksky.library.createPlaylist", { name: name })
+    end
+
+    # app.rocksky.library.updatePlaylist
+    def update_playlist(playlist_id, name: nil, comment: nil, song_id_to_add: nil, song_index_to_remove: nil)
+      procedure("app.rocksky.library.updatePlaylist", { playlistId: playlist_id, name: name, comment: comment, songIdToAdd: song_id_to_add, songIndexToRemove: song_index_to_remove })
+    end
+
+    # app.rocksky.library.deletePlaylist
+    def delete_playlist(id)
+      procedure("app.rocksky.library.deletePlaylist", { id: id })
+    end
+
+    # app.rocksky.library.deleteSong
+    def delete_song(id)
+      procedure("app.rocksky.library.deleteSong", { id: id })
+    end
+
+    # app.rocksky.library.deleteAlbum
+    def delete_album(id)
+      procedure("app.rocksky.library.deleteAlbum", { id: id })
+    end
+
+    # app.rocksky.library.scrobble
+    def scrobble(id, time: nil, submission: nil)
+      procedure("app.rocksky.library.scrobble", { id: id, time: time, submission: submission })
+    end
+
+    # app.rocksky.library.updateNowPlaying
+    def update_now_playing(id)
+      procedure("app.rocksky.library.updateNowPlaying", { id: id })
+    end
+
+    # app.rocksky.library.getNowPlaying
+    def get_now_playing()
+      query("app.rocksky.library.getNowPlaying", {})
+    end
+
+    # app.rocksky.library.getPlayQueue
+    def get_play_queue()
+      query("app.rocksky.library.getPlayQueue", {})
+    end
+
+    # app.rocksky.library.savePlayQueue
+    def save_play_queue(id: nil, current: nil, position: nil)
+      procedure("app.rocksky.library.savePlayQueue", { id: id, current: current, position: position })
+    end
+
+    # app.rocksky.library.getStreamUrl
+    def get_stream_url(id, max_bit_rate: nil, format: nil)
+      query("app.rocksky.library.getStreamUrl", { id: id, maxBitRate: max_bit_rate, format: format })
+    end
+
+    # app.rocksky.library.getDownloadUrl
+    def get_download_url(id)
+      query("app.rocksky.library.getDownloadUrl", { id: id })
+    end
+
+    # app.rocksky.library.getCoverArtUrl
+    def get_cover_art_url(id, size: nil)
+      query("app.rocksky.library.getCoverArtUrl", { id: id, size: size })
+    end
+
+    # app.rocksky.library.getInternetRadioStations
+    def get_internet_radio_stations()
+      query("app.rocksky.library.getInternetRadioStations", {})
+    end
+
+    private
+
+    def query(nsid, params = {})
+      Rocksky.unwrap(C.rocksky_library_get(@base, @token, nsid, JSON.generate(params.compact)))
+    end
+
+    def procedure(nsid, body = {})
+      Rocksky.unwrap(C.rocksky_library_post(@base, @token, nsid, JSON.generate(body.compact)))
+    end
+  end
+end

data/lib/rocksky/manifest.json

@@ -1,12 +1,12 @@
 {
   "repo": "tsirysndr/rocksky",
-  "tag": "bindings-v0.2.0",
+  "tag": "bindings-v0.4.0",
   "checksums": {
-    "aarch64-apple-darwin": "3fc61d1194d66f58eaea8b82643bbdcd705ab80a626e38975a3c0d66ea14047d",
-    "aarch64-linux-gnu": "4e6f003fb0c45eba7a675b81cc76b084dc770333b2d8c676b2123d19e78f89a0",
-    "x86_64-apple-darwin": "a90563838920ef3575b1af55062e5f1bddcd124ba0d4b9bd50b5639ab6c4ed4e",
-    "x86_64-linux-gnu": "98c2df9ff416fd3f2f0e50e0e48122751ea829f5208f11002ce9fdd85b0fbe5f",
-    "x86_64-unknown-freebsd": "5ad9efc806706ba51cb7f1fe0e678eb97e03e2dd218fec9fe7e7ab29e0efcb68",
-    "x86_64-unknown-netbsd": "f82db46965ea7872085920d37f4a854f7f882e0efa257df9a11dd3e2f7cebf48"
+    "aarch64-apple-darwin": "cd828960ba30880c121eca655a890625360c8b6f3d7d1e15ecbfeda9934c1496",
+    "aarch64-linux-gnu": "43d52700719ca325a7cc4bf24ae6e8eef8e71bdf532968bcc029f067e09e660f",
+    "x86_64-apple-darwin": "54749d2c37bd2f4f487a24b91ab935a6806f359e2bf8b52ec192d4421524aed0",
+    "x86_64-linux-gnu": "6750513f2a592637c436e28113aaa4e2cc2890829b337a3dcf999b40bbd7d924",
+    "x86_64-unknown-freebsd": "f1fa22d790c30dee2d4418e5a781338d4aeffbd334db48bc5d70bc94b88f23db",
+    "x86_64-unknown-netbsd": "4bb233727e965c45187cfa254206a25756c2c2fdc25e64df39f84f5d5eeb01d5"
   }
 }

data/lib/rocksky/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rocksky
-  VERSION = "0.5.0"
+  VERSION = "0.7.0"
 end

data/lib/rocksky.rb

@@ -27,6 +27,8 @@ module Rocksky
       "char* rocksky_top_tracks(const char*, unsigned int, unsigned int)",
       "char* rocksky_global_stats(const char*)",
       "char* rocksky_get(const char*, const char*, const char*, const char*)",
+      "char* rocksky_library_get(const char*, const char*, const char*, const char*)",
+      "char* rocksky_library_post(const char*, const char*, const char*, const char*)",
       "char* rocksky_match_song(const char*, const char*, const char*, const char*, const char*)",
       "char* rocksky_top_tracks_interval(const char*, unsigned int, unsigned int, const char*, unsigned int, const char*, const char*)",
       "char* rocksky_top_artists_interval(const char*, unsigned int, unsigned int, const char*, unsigned int, const char*, const char*)",
@@ -36,7 +38,7 @@ module Rocksky
       "void* rocksky_agent_login(const char*, const char*, const char*, const char*, const char*)",
       "void rocksky_agent_free(void*)",
       "char* rocksky_agent_scrobble(void*, const char*)",
-      "char* rocksky_agent_scrobble_match(void*, const char*, const char*, const char*, const char*, const char*)",
+      "char* rocksky_agent_scrobble_match(void*, const char*)",
       "char* rocksky_agent_sync_repo(void*)",
       "char* rocksky_agent_hydrate_from_jetstream(void*)",
       "char* rocksky_agent_like(void*, const char*, const char*)",
@@ -166,8 +168,13 @@ module Rocksky
 
     # Scrobble from just a title + artist (album optional, plus optional mb_id /
     # isrc anchors): resolve full metadata via matchSong, then fan out.
-    def scrobble_match(title, artist, album: nil, mb_id: nil, isrc: nil)
-      Rocksky.unwrap(C.rocksky_agent_scrobble_match(@ptr, title, artist, album.to_s, mb_id.to_s, isrc.to_s))
+    # Scrobble from just a title + artist. +input+ is a Hash with camelCase keys:
+    # required "title"/"artist"; optional "album", "mbId", "isrc" (match anchors),
+    # and "timestamp" (scrobbled-at Unix seconds, default now).
+    #
+    #   agent.scrobble_match("title" => "Chaser", "artist" => "Calibro 35")
+    def scrobble_match(input)
+      Rocksky.unwrap(C.rocksky_agent_scrobble_match(@ptr, JSON.generate(input)))
     end
 
     # Download the caller's repo and (re)build the local dedup index (needs a
@@ -205,4 +212,15 @@ module Rocksky
       @ptr = Fiddle::Pointer.new(0)
     end
   end
+
+  # Build an authenticated app.rocksky.library.* (uploaded-music) client. The
+  # token is required — every library method is auth-gated.
+  #
+  #   lib = Rocksky.library(token)
+  #   lib.get_song(song_id)
+  def self.library(token, base: nil)
+    Library.new(token, base: base)
+  end
 end
+
+require_relative "rocksky/library"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rocksky
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Rocksky
@@ -80,6 +80,7 @@ files:
 - README.md
 - exe/rocksky-console
 - lib/rocksky.rb
+- lib/rocksky/library.rb
 - lib/rocksky/manifest.json
 - lib/rocksky/native.rb
 - lib/rocksky/version.rb