rocksky 0.12.1 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c936595ae468fd702c1e78cb1ad3db497ae10bded7672754909c6b014c163bd
-  data.tar.gz: 869b8de2f3e067e3e11cd114bcd40f3cdd6efac0930a477858b009d1b476e608
+  metadata.gz: c9d26267b45f471f9cda322cc761436e434d5282269bbf4849bf9b57a85dce91
+  data.tar.gz: 5c50a5a93410dfd5b1454273d07e1f0ccb121c52a6b32a87e49cc7884f7f8d08
 SHA512:
-  metadata.gz: 7005add14ac829814cef5c34a78feb52878c97bd50218041408e46da223115b0f19c64a2d3710f75f3b389e5ef880cfcee3957047dfe2c181b239414c5cf512a
-  data.tar.gz: 579dbe27c678f7460d13c0f75495afc8ea7216abe262bb0ca8069268232d1452b546e18dce29ea3d3918c8965e7215536c7a31364e55c4ec6247952fb2371b78
+  metadata.gz: ba39252bd1b17f33110c56092574ec14539b7ea40ce5338a576732f9ac7f6def7313d92e1a86a09e55c814b3b88918f08d6f4d76aebac909aaede594538478f5
+  data.tar.gz: ff24eaf530004037f4518d5a26c33ff814bf299bf0bdd815f297c7b8bdcb542c86a11d12f1be3062713320f8aa2671638a2ee82de1c2d50deea9693354fc8aa1

data/CHANGELOG.md

@@ -1,5 +1,30 @@
 # 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.
+  Scrobble and song payloads now carry the catalogue enrichment fields
+  (streaming links, `composer`, `label`, `genre`, `copyright_message`, `isrc`,
+  `mb_id`, `key`, `track_number`, `disc_number`, `duration`, `bpm`), albums
+  carry `discogs_release_id`, and artists carry `biography` / `born` /
+  `born_in` / `died`.
+- Profiles gained `spotify_user`, `spotify_connected`, `googledrive` and
+  `dropbox`; notifications gained an enriched `subject`.
+- Removed `spotify_token` from the profile payload — the API no longer returns
+  it, and `spotify_connected` covers the only part callers used.
+
 ## 0.11.0
 
 - Added `Rocksky::Filter`, a fluent RSQL builder (`eq`, `ne`, `gt`, `ge`,

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.12.0",
+  "tag": "bindings-v0.14.0",
   "checksums": {
-    "aarch64-apple-darwin": "b23d327021f00c260fb0ed2ca8792ef4cf6c98054da36b98ca4175bd1f774450",
-    "aarch64-linux-gnu": "714609a9eedc63f31a651d7eb0d5092f43de229ad4045c1e3fa1725a6734c28a",
-    "x86_64-apple-darwin": "bf86e4404adb3116f36e58f714eb4a6726b9612e3c3703f4c8b3444daa6fc4e5",
-    "x86_64-linux-gnu": "c6c17133b0a734fc9d31a1a793932d9f11476384f103a4dbc193c7b2176ba10e",
-    "x86_64-unknown-freebsd": "80a91622d51272f9c20cd85dd4acde3c95d4001614ad051982f86024266fd9c5",
-    "x86_64-unknown-netbsd": "ffa478d378c39b1ba8381ffd3e7c874022bbda688208c498f048a41221d20daf"
+    "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.12.1"
+  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.12.1
+  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