rocksky 0.11.0 → 0.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 411359937d7cc586384c4b58c7e32f4824cc4cfb1ee0e3ec3f38c0071b0b3b30
-  data.tar.gz: 97525f3e9c77f00c136a9f349f18747965dba4aa02f4e55bb1fb6587d926fc6f
+  metadata.gz: 6285f01e3baa73b2791e6b64a2d4d331aa750abe5f50d1e4cafe6263073bf9ad
+  data.tar.gz: 1668269cb59db82bfaf6455e66e493f7dfd9a1c97c5037d9b3eac959a60dd3cf
 SHA512:
-  metadata.gz: 49ce584a23a45ecab4725b82308b6968468e2e3104267d4e5ca6696241d149ce224872d8eb303b8dd7680c2e4bc97e738feac641760dfb05c7d5330ef527d5e8
-  data.tar.gz: 4cc152d4c19bfaa289a7422426abe6878d2fae69fda3f0063846b3ece0080c979f9d2b4077415f650bd34d4e7b466d13d3bac045c4e5c94a5e5495034253eee8
+  metadata.gz: 50c4b9e1f82ce55ea8b9370946461dc8fd9bc6c87ce108ac304cf2835a66b0e6474c7cd07cd1c5a77c6794800cc7082a63abb1e45cc8395dfb8b7a07e82d3aed
+  data.tar.gz: 57b4fd741109bd4cc218d68520b22fef8f5dc5bfa2f1494ac7439722e892d5e60112eb026bb9cc65f8aaa784a537bbacf9078c939b27b859d646b854b85d1993

data/lib/rocksky/manifest.json

@@ -1,12 +1,12 @@
 {
   "repo": "tsirysndr/rocksky",
-  "tag": "bindings-v0.8.0",
+  "tag": "bindings-v0.10.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": "36607cf75cc05b79f93570efae0047dfe58f4beff38033f59e9c8c9e03c0e62e",
+    "aarch64-linux-gnu": "d5fcf8a3ca7acba5eaf45db0478360ade6ebfcea7f1dab582ff10696ec77c24e",
+    "x86_64-apple-darwin": "a19daa282e01fa68cb279da28bba52198c928c7771770d4e0a5e10e922a51aa9",
+    "x86_64-linux-gnu": "a6751be73f81d32639b85f3a1f2c6420b7a2346acbc59a5fd534156915d2f918",
+    "x86_64-unknown-freebsd": "e811d322e14ce51498928616c02f0c6228ea765a7f67efef00963a1bbe0c172e",
+    "x86_64-unknown-netbsd": "ce8e555d3ef6caee7dd7c7302feb14b73268ae46dcc9c517d8370c57c93624c6"
   }
 }

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.11.1"
 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
@@ -348,4 +359,5 @@ end
 
 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.11.1
 platform: ruby
 authors:
 - Rocksky
@@ -84,6 +84,7 @@ files:
 - 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