rocksky 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 411359937d7cc586384c4b58c7e32f4824cc4cfb1ee0e3ec3f38c0071b0b3b30
-  data.tar.gz: 97525f3e9c77f00c136a9f349f18747965dba4aa02f4e55bb1fb6587d926fc6f
+  metadata.gz: 4eb3afb1cb2e28cecb5bfa007812541ca97645b93c92d6dc3613740b0a30a68e
+  data.tar.gz: d7105f690b1831d6542358be0e218eb520999e083b5e324b0ad7467ac977b411
 SHA512:
-  metadata.gz: 49ce584a23a45ecab4725b82308b6968468e2e3104267d4e5ca6696241d149ce224872d8eb303b8dd7680c2e4bc97e738feac641760dfb05c7d5330ef527d5e8
-  data.tar.gz: 4cc152d4c19bfaa289a7422426abe6878d2fae69fda3f0063846b3ece0080c979f9d2b4077415f650bd34d4e7b466d13d3bac045c4e5c94a5e5495034253eee8
+  metadata.gz: 0c2101925359943adbf140a6854ddcaffe32867a48db8a539fd3c6fc3d631de00c40f2d607bff59536650571f0260eadacb75861accb8f1dad741d0b2873ffa8
+  data.tar.gz: c278a198a98864b9fb94b04f45a510970906a9b13f144ce91e980f25020d6a13ac554d9eeea7622c604d3ae42cae63b5dacebb125c62a6f20672d1ae34a9bf0f

data/lib/rocksky/equalizer.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Rocksky
+  # app.rocksky.equalizer.* — saved EQ presets (app.rocksky.equalizer records
+  # in the caller's repo).
+  #
+  # Units are rockbox's internal ones: band frequency in Hz, gain in tenths of
+  # dB (30 = +3.0 dB), q × 10 (7 = Q 0.7); precut in tenths of dB (-240..0).
+  module Equalizer
+    module_function
+
+    # An actor's presets ({ "presets" => [...] }). Omit +actor+ for the
+    # authenticated viewer's own — that read is auth-gated, so pass +token+.
+    def presets(actor: nil, token: nil, base: nil)
+      params = {}
+      params[:did] = actor if actor
+      Rocksky.get("app.rocksky.equalizer.listPresets", params, base: base, token: token)
+    end
+
+    # Create or update a preset; the rkey is +name+ slugified, so an existing
+    # name overwrites that preset. +bands+ is an array of
+    # { frequency:, gain:, q: } hashes. Returns the saved preset view.
+    def put_preset(name, bands, token:, precut: nil, base: nil)
+      body = { name: name, bands: bands }
+      body[:precut] = precut if precut
+      # putPreset's input is a JSON body, so it rides the body-carrying native
+      # call rather than the query-string Rocksky.post.
+      Rocksky.unwrap(C.rocksky_library_post(base.to_s, token.to_s,
+                                            "app.rocksky.equalizer.putPreset",
+                                            JSON.generate(body)))
+    end
+
+    # Delete a preset by rkey. Empty response.
+    def delete_preset(rkey, token:, base: nil)
+      Rocksky.post("app.rocksky.equalizer.deletePreset", { rkey: rkey }, base: base, token: token)
+    end
+  end
+end

data/lib/rocksky/manifest.json

@@ -1,12 +1,12 @@
 {
   "repo": "tsirysndr/rocksky",
-  "tag": "bindings-v0.8.0",
+  "tag": "bindings-v0.11.0",
   "checksums": {
-    "aarch64-apple-darwin": "31b58deb0f3d627d37b101f06b5b4a952401040f076b4cea7436aa338080a701",
-    "aarch64-linux-gnu": "dca60c186ee83401e9afcdf1e7b31c308594f6dcda4cab25acf77254739d2a49",
-    "x86_64-apple-darwin": "bdf2c98ddc866280712c928d78d4173c1760deac6d8c567417b90ea20fba1bb4",
-    "x86_64-linux-gnu": "74dede20bb5892eff8ad321721a3f4584227bf2c97d78c2febeec095d2df46b6",
-    "x86_64-unknown-freebsd": "e6af79359f73a9d42d6232eade70f5e3938e75b66bc240e1077d76334daa08fe",
-    "x86_64-unknown-netbsd": "d1765e3c66d99a1160ddb3361ff9cfcf9c1335a056e68d089ea1c97ef6ff3f16"
+    "aarch64-apple-darwin": "fde925a15e9973eb509f6c18980c15eab8e168ee699290ffa09d54db0398e3ad",
+    "aarch64-linux-gnu": "f32cbea46108e1991a8676990dc6e2e6d8aadf6f4f7c18333e659c21d0a0a1c6",
+    "x86_64-apple-darwin": "b0608f09d1fee48492bbe093ed07d768f846992089eff0e5748475f06f159ef9",
+    "x86_64-linux-gnu": "17d9fb0c1c41a7d1cff8695063a32f3807d282b15722cc4fd99399c318b724a9",
+    "x86_64-unknown-freebsd": "ba099d9ccd5e23f26032e1cacba69e037c2a371b4b63cb83a7e27d060036eda8",
+    "x86_64-unknown-netbsd": "c9f837cdcc9d2a48b0631e3b8032fd42cc851c84d612c2abf31b08aa303995fe"
   }
 }

data/lib/rocksky/playlist.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Rocksky
+  # app.rocksky.playlist.* — the global, AT-Proto-backed playlists.
+  #
+  # Distinct from Rocksky::Library's playlist methods, which drive the
+  # Subsonic/Navidrome library (app.rocksky.library.*).
+  #
+  # Writes publish records to the caller's repo, so they need a +token+ and only
+  # show up in reads once the AppView has ingested the commit.
+  module Playlist
+    module_function
+
+    # The playlist catalog.
+    def list(limit: 50, offset: 0, filter: nil, base: nil)
+      params = { limit: limit, offset: offset }
+      params[:filter] = filter if filter
+      Rocksky.get("app.rocksky.playlist.getPlaylists", params, base: base)
+    end
+
+    # A single playlist with its tracks. +filter+ is an RSQL expression over the
+    # tracks (e.g. 'artist=="Daft Punk"').
+    def get(uri, filter: nil, base: nil)
+      params = { uri: uri }
+      params[:filter] = filter if filter
+      Rocksky.get("app.rocksky.playlist.getPlaylist", params, base: base)
+    end
+
+    # Create a playlist. Returns { "uri" => ..., "cid" => ... }.
+    def create(name, token:, description: nil, picture_url: nil, base: nil)
+      params = { name: name }
+      params[:description] = description if description
+      params[:pictureUrl] = picture_url if picture_url
+      Rocksky.post("app.rocksky.playlist.createPlaylist", params, base: base, token: token)
+    end
+
+    # Rename or re-describe a playlist. Owner only.
+    def update(uri, token:, name: nil, description: nil, picture_url: nil, base: nil)
+      params = { uri: uri }
+      params[:name] = name if name
+      params[:description] = description if description
+      params[:pictureUrl] = picture_url if picture_url
+      Rocksky.post("app.rocksky.playlist.updatePlaylist", params, base: base, token: token)
+    end
+
+    # Add songs by their app.rocksky.song AT-URIs. Owner only. Returns
+    # { "uris" => [...] } — the created entry records.
+    def add_songs(uri, songs, token:, base: nil)
+      Rocksky.post("app.rocksky.playlist.addSongs", { uri: uri, songs: songs },
+                   base: base, token: token)
+    end
+
+    # Remove a song. An entry lives in the repo that added it, so only that repo
+    # can retract it.
+    def remove_track(uri, song_uri, token:, base: nil)
+      Rocksky.post("app.rocksky.playlist.removeTrack", { uri: uri, songUri: song_uri },
+                   base: base, token: token)
+    end
+
+    # Delete a playlist and the caller's own entries. Owner only.
+    def remove(uri, token:, base: nil)
+      Rocksky.post("app.rocksky.playlist.removePlaylist", { uri: uri }, base: base, token: token)
+    end
+  end
+end

data/lib/rocksky/version.rb

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

data/lib/rocksky.rb

@@ -27,10 +27,11 @@ 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_post(const char*, const char*, const char*, const char*)",
       "char* rocksky_update_seen(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_match_song(const char*, 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*)",
       "char* rocksky_song_hash(const char*, const char*, const char*)",
@@ -183,6 +184,14 @@ module Rocksky
     unwrap(C.rocksky_get(base.to_s, nsid, JSON.generate(params), token.to_s))
   end
 
+  # Universal write escape hatch — call any app.rocksky.* procedure whose
+  # arguments ride the query string. Most are auth-gated, so pass +token+.
+  #
+  #   Rocksky.post("app.rocksky.playlist.removePlaylist", { uri: uri }, token: tok)
+  def self.post(nsid, params = {}, base: nil, token: nil)
+    unwrap(C.rocksky_post(base.to_s, nsid, JSON.generate(params), token.to_s))
+  end
+
   # ---- notifications (auth-gated; +token+ required) ----
 
   # The authenticated viewer's unread-notification count. Returns
@@ -208,8 +217,10 @@ module Rocksky
   end
 
   # Resolve full canonical metadata for a bare title + artist (matchSong).
-  def self.match_song(title, artist, mb_id: nil, isrc: nil, base: nil)
-    unwrap(C.rocksky_match_song(base.to_s, title, artist, mb_id.to_s, isrc.to_s))
+  # +album+ steers the match toward that release (case-insensitive) so a
+  # remaster/live/single edition doesn't shadow the intended album.
+  def self.match_song(title, artist, album: nil, mb_id: nil, isrc: nil, base: nil)
+    unwrap(C.rocksky_match_song(base.to_s, title, artist, album.to_s, mb_id.to_s, isrc.to_s))
   end
 
   # Top tracks chart over a typed date window. +interval+ is +:all+, or a pair
@@ -346,6 +357,8 @@ module Rocksky
   end
 end
 
+require_relative "rocksky/equalizer"
 require_relative "rocksky/filter"
 require_relative "rocksky/library"
+require_relative "rocksky/playlist"
 require_relative "rocksky/remote"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rocksky
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Rocksky
@@ -80,10 +80,12 @@ files:
 - README.md
 - exe/rocksky-console
 - lib/rocksky.rb
+- lib/rocksky/equalizer.rb
 - lib/rocksky/filter.rb
 - lib/rocksky/library.rb
 - lib/rocksky/manifest.json
 - lib/rocksky/native.rb
+- lib/rocksky/playlist.rb
 - lib/rocksky/remote.rb
 - lib/rocksky/version.rb
 - rocksky.gemspec