rocksky 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7cd511b8af28e35ec230b14548cef27f7c666d7d6ccb6817ea13fdcc5365fb73
-  data.tar.gz: 22271abcb8181a17cb28e4666e602bd364b58a16208cd617efedd8483311b9bb
+  metadata.gz: c9d26267b45f471f9cda322cc761436e434d5282269bbf4849bf9b57a85dce91
+  data.tar.gz: 5c50a5a93410dfd5b1454273d07e1f0ccb121c52a6b32a87e49cc7884f7f8d08
 SHA512:
-  metadata.gz: 879a3cceac6da21b12d3fe9e4bc25870bcd327a9fd686278f3737e884bcd9fc1e044cee3edb285d7634b0cd136d0110c21a9b593f8abbc075c52b76998e582bf
-  data.tar.gz: 8d19dc4b4614797a4ec6d2ea0da9c9aedddb78f99b734b54771434d8616daa7851e900acb3520f3a9e4c422220ee5f7a487d38d99f3769a8be9ddd34e4af273d
+  metadata.gz: ba39252bd1b17f33110c56092574ec14539b7ea40ce5338a576732f9ac7f6def7313d92e1a86a09e55c814b3b88918f08d6f4d76aebac909aaede594538478f5
+  data.tar.gz: ff24eaf530004037f4518d5a26c33ff814bf299bf0bdd815f297c7b8bdcb542c86a11d12f1be3062713320f8aa2671638a2ee82de1c2d50deea9693354fc8aa1

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.14.0
+
+- Added `Rocksky::Event` (`events`, `event`, `rsvps`, `artist_events`,
+  `put_rsvp`) over the new `app.rocksky.event.*` and
+  `app.rocksky.artist.getArtistEvents` lexicons.
+- `match_song` candidates now carry `source`, `providerId`, `mbId`,
+  `mbReleaseId` and `mbArtists`; `album` is a hard filter and an unmatched
+  lookup returns an empty `matches` array without song fields.
+- Remote player tracks accept `bitrate`, `waveform` (256 peaks) and
+  `waveformStatus`; controllers receive a `:command_error` event when a
+  target player rejects a command.
+
 ## 0.13.0
 
 - Regenerated the native core against the updated `app.rocksky.*` lexicons.

data/lib/rocksky/event.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Rocksky
+  # app.rocksky.event.* — indexed music events (community.lexicon.calendar.event
+  # records annotated by app.rocksky.event.music) and their RSVPs.
+  module Event
+    module_function
+
+    # Indexed music events, soonest first. Without a time window only unexpired
+    # events are returned; +include_past+ lists past events, most recent first.
+    # Filters: +artist+ (AT-URI, id or sha256), +did+ (publisher), +rsvp_by+
+    # (a DID that RSVP'd going/interested), +kind+, +genre+, +from+ / +to+
+    # (RFC-3339). Pass +token+ to get each event's "viewerRsvp". Returns
+    # { "events" => [...] }.
+    def events(artist: nil, did: nil, rsvp_by: nil, kind: nil, genre: nil, from: nil, to: nil,
+               include_past: false, limit: nil, offset: nil, token: nil, base: nil)
+      params = { artist: artist, did: did, rsvpBy: rsvp_by, kind: kind, genre: genre,
+                 from: from, to: to, limit: limit, offset: offset }.compact
+      params[:includePast] = true if include_past
+      Rocksky.get("app.rocksky.event.getEvents", params, base: base, token: token)
+    end
+
+    # One music event by the AT-URI of either its calendar event record or its
+    # app.rocksky.event.music record.
+    def event(uri, token: nil, base: nil)
+      Rocksky.get("app.rocksky.event.getEvent", { uri: uri }, base: base, token: token)
+    end
+
+    # Who responded to an event, most recent first ({ "rsvps" => [...] }).
+    # +status+ narrows to one community.lexicon.calendar.rsvp#… token.
+    def rsvps(uri, status: nil, limit: nil, offset: nil, base: nil)
+      params = { uri: uri, status: status, limit: limit, offset: offset }.compact
+      Rocksky.get("app.rocksky.event.getEventRsvps", params, base: base)
+    end
+
+    # The music events an artist is billed on, soonest first
+    # ({ "events" => [...] }); +include_past+ adds past events, most recent first.
+    def artist_events(uri, include_past: false, limit: nil, offset: nil, base: nil)
+      params = { uri: uri, limit: limit, offset: offset }.compact
+      params[:includePast] = true if include_past
+      Rocksky.get("app.rocksky.artist.getArtistEvents", params, base: base)
+    end
+
+    # Set the viewer's RSVP on an event. +status+ is a
+    # community.lexicon.calendar.rsvp#{going,interested,notgoing} token; an
+    # existing RSVP record is reused. Returns { "uri" => ..., "status" => ... }.
+    def put_rsvp(uri, status, token:, base: nil)
+      # putRsvp'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.event.putRsvp",
+                                            JSON.generate({ uri: uri, status: status })))
+    end
+  end
+end

data/lib/rocksky/manifest.json

@@ -1,12 +1,12 @@
 {
   "repo": "tsirysndr/rocksky",
-  "tag": "bindings-v0.13.0",
+  "tag": "bindings-v0.14.0",
   "checksums": {
-    "aarch64-apple-darwin": "4a4f2862dce139ebdd8e0b50f811085f5aab3fd5a1b6285dd2da0b19300ded15",
-    "aarch64-linux-gnu": "07f4d400b3544c084515b20fad417609c6232f4cf50ad7691b3bd241b088bf01",
-    "x86_64-apple-darwin": "ac633f96d463ccbbab2933b6f3ae25759a4ebf1d979e7b6c864b9787091f72b4",
-    "x86_64-linux-gnu": "7189ce47d56951a8a69e2a4f146423522f918bfa5f7d5d8aad3d918c1296154a",
-    "x86_64-unknown-freebsd": "1406aaf93f66f9dd35a6e04764f2221d6987ac528f7b55aa2cae058cda9d94b0",
-    "x86_64-unknown-netbsd": "cb40009835f668ea00f34e902d2061c751021ca6131059e454b39ed70cbbb893"
+    "aarch64-apple-darwin": "1a7db9b8e3fe9d79ffbc7aa546039636a2bf66e5e18d6fa1b6d2a542a51a063a",
+    "aarch64-linux-gnu": "95fab942c479f712bfbb3b75dc6d3b9bd9d9783cfffd28fe0bfe76ad450bd102",
+    "x86_64-apple-darwin": "68c39d92d3caf4cc167c0c0858a9a56504099f3f0c9dc10287b789b7adf37cf2",
+    "x86_64-linux-gnu": "18bfd64ae27e287b9e7b73b06fb37bad10b1ff4bc91f72cb5b441d906d42e45c",
+    "x86_64-unknown-freebsd": "6ec0f2712cb18537b38622655ab5fbc75638b74df11d18ea46632084030063ab",
+    "x86_64-unknown-netbsd": "00fd064a0ef79773ac495da88b88552dfa17f73a94360b0f528ba055d9849260"
   }
 }

data/lib/rocksky/remote.rb

@@ -82,9 +82,11 @@ module Rocksky
     # Advertise the currently-playing track. Call whenever it changes, and
     # periodically (~every 1–4s) with a fresh +elapsedMs+ so controllers show
     # smooth progress. +track+ is a camelCase Hash. Optional audio info —
-    # +codec+ (audio codec/container, e.g. "mp3", "flac") and +sampleRate+
-    # (sample rate in Hz, e.g. 44100) — is included in the track payload when
-    # set, and omitted otherwise.
+    # +codec+ (audio codec/container, e.g. "mp3", "flac"), +sampleRate+
+    # (sample rate in Hz, e.g. 44100), +bitrate+ (kbit/s), +waveform+ (exactly
+    # 256 amplitude peaks 0..255 in track-time order) and +waveformStatus+
+    # ("pending", "ready" or "unavailable") — is included in the track payload
+    # when set, and omitted otherwise.
     def set_now_playing(track)
       Rocksky.unwrap(C.rocksky_remote_player_set_now_playing(@ptr, JSON.generate(track)))
     end
@@ -168,10 +170,13 @@ module Rocksky
 
     # Register a handler for a server event type, one of +:devices+,
     # +:device_registered+, +:device_unregistered+, +:primary_changed+,
-    # +:now_playing+, +:status+, +:queue+. The block receives the full
-    # symbol-keyed event Hash. A +:now_playing+ event carries the advertised
-    # track under +:track+, including optional +:codec+ / +:sampleRate+ audio
-    # info when the player supplied it. Returns +self+ for chaining.
+    # +:now_playing+, +:status+, +:queue+, +:command_error+. The block receives
+    # the full symbol-keyed event Hash. A +:now_playing+ event carries the
+    # advertised track under +:track+, including optional +:codec+ /
+    # +:sampleRate+ / +:bitrate+ / +:waveform+ / +:waveformStatus+ audio info
+    # when the player supplied it. A +:command_error+ event (+:deviceId+,
+    # +:deviceName+, +:message+) means the target player rejected a command
+    # this controller sent. Returns +self+ for chaining.
     def on(event_type, &block)
       @handlers[event_type.to_sym] = block
       self

data/lib/rocksky/version.rb

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

data/lib/rocksky.rb

@@ -222,8 +222,9 @@ module Rocksky
   end
 
   # Resolve full canonical metadata for a bare title + artist (matchSong).
-  # +album+ steers the match toward that release (case-insensitive) so a
-  # remaster/live/single edition doesn't shadow the intended album.
+  # When +album+ is given only candidates matching that album (after
+  # normalization) are accepted; with no accepted candidate the response has an
+  # empty "matches" array and no song fields.
   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
@@ -363,6 +364,7 @@ module Rocksky
 end
 
 require_relative "rocksky/equalizer"
+require_relative "rocksky/event"
 require_relative "rocksky/filter"
 require_relative "rocksky/library"
 require_relative "rocksky/playlist"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rocksky
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Rocksky
@@ -81,6 +81,7 @@ files:
 - exe/rocksky-console
 - lib/rocksky.rb
 - lib/rocksky/equalizer.rb
+- lib/rocksky/event.rb
 - lib/rocksky/filter.rb
 - lib/rocksky/library.rb
 - lib/rocksky/manifest.json