spotifyrb 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 345ef99e89558b4a5c11c6a836359de78ff54f8db0bcef8bde85a32b1a936ba3
-  data.tar.gz: 0e679b99c79f66528134becc5cdd6b30c89a0d7e942bf787aedabaf71fcf7e82
+  metadata.gz: bdc175911b05f2c8df36242ceaed1f830b81daa422181f89ce3320fb67cbb572
+  data.tar.gz: d5a2a2e63e88069c8699db2e676cfb8381c2d62e93bf9bf9666e076021fb475f
 SHA512:
-  metadata.gz: c3df60285cca7ec260913ea4fe3f40a5de2902a13b63dabb15e160b9c14b87dcda4f4998884bfc779e1decb14002ae33bdfa7dcd544447dadd9c59025aa9e2bc
-  data.tar.gz: d8851f465644af778387b5f4bf564e6e798cc156367bfcd8866387ab5f6e4178efc75027c82532e51840fbbcaa034040107cc45ec324fc41b2f29aa595fe9e81
+  metadata.gz: db8b783bfd2e15994c690242ae4daae545eb1fe9b432353666a4b336ef5424319c03d0e7300c5313af4ed4b3ddf8dcc3afcfe9ac041d611438254d569a2864ff
+  data.tar.gz: cac9e7127f748a3c9749dd784f59c277651e683691e9052b82a03bc73f23a1d2df99f7ca48d642184aabec54204aa97325f4dde33a17107621516414bf7afd4b

data/.github/workflows/ci.yml

@@ -27,9 +27,9 @@ jobs:
       fail-fast: false
       matrix:
         ruby_version:
-          - '3.1'
           - '3.2'
           - '3.3'
+          - '3.4'
     steps:
       - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1

data/Gemfile.lock

@@ -1,112 +1,117 @@
 PATH
   remote: .
   specs:
-    spotifyrb (0.1.0)
+    spotifyrb (0.1.2)
       faraday (~> 2.11)
       ostruct (~> 0.6.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.1.3.4)
+    activesupport (8.0.2)
       base64
+      benchmark (>= 0.3)
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
       minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
-    ast (2.4.2)
-    base64 (0.2.0)
-    bigdecimal (3.1.8)
-    concurrent-ruby (1.3.3)
-    connection_pool (2.4.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    ast (2.4.3)
+    base64 (0.3.0)
+    benchmark (0.4.1)
+    bigdecimal (3.2.2)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.3)
     date (3.4.1)
-    dotenv (3.1.2)
-    drb (2.2.1)
+    dotenv (3.1.8)
+    drb (2.2.3)
     erb (5.0.1)
     faraday (2.13.1)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger
-    faraday-net_http (3.1.1)
-      net-http
-    i18n (1.14.5)
+    faraday-net_http (3.4.0)
+      net-http (>= 0.5.0)
+    i18n (1.14.7)
       concurrent-ruby (~> 1.0)
     io-console (0.8.0)
     irb (1.15.2)
       pp (>= 0.6.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.7.2)
-    language_server-protocol (3.17.0.3)
-    logger (1.6.0)
-    minitest (5.24.1)
-    mutex_m (0.2.0)
-    net-http (0.4.1)
+    json (2.12.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    minitest (5.25.5)
+    net-http (0.6.0)
       uri
     ostruct (0.6.1)
-    parallel (1.25.1)
-    parser (3.3.4.0)
+    parallel (1.27.0)
+    parser (3.3.8.0)
       ast (~> 2.4.1)
       racc
     pp (0.6.2)
       prettyprint
     prettyprint (0.2.0)
+    prism (1.4.0)
     psych (5.2.6)
       date
       stringio
     racc (1.8.1)
-    rack (3.1.7)
+    rack (3.1.16)
     rainbow (3.1.1)
     rake (12.3.3)
     rdoc (6.14.0)
       erb
       psych (>= 4.0.0)
-    regexp_parser (2.9.2)
+    regexp_parser (2.10.0)
     reline (0.6.1)
       io-console (~> 0.5)
-    rexml (3.3.4)
-      strscan
-    rubocop (1.65.1)
+    rubocop (1.76.1)
       json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
       parallel (~> 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 2.4, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.45.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.31.3)
-      parser (>= 3.3.1.0)
-    rubocop-minitest (0.35.1)
-      rubocop (>= 1.61, < 2.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
-    rubocop-performance (1.21.1)
-      rubocop (>= 1.48.1, < 2.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
-    rubocop-rails (2.25.1)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.45.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.25.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    rubocop-rails (2.32.0)
       activesupport (>= 4.2.0)
+      lint_roller (~> 1.1)
       rack (>= 1.1)
-      rubocop (>= 1.33.0, < 2.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
-    rubocop-rails-omakase (1.0.0)
-      rubocop
-      rubocop-minitest
-      rubocop-performance
-      rubocop-rails
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.44.0, < 2.0)
+    rubocop-rails-omakase (1.1.0)
+      rubocop (>= 1.72)
+      rubocop-performance (>= 1.24)
+      rubocop-rails (>= 2.30)
     ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
     stringio (3.1.7)
-    strscan (3.1.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.5.0)
-    uri (0.13.0)
-    vcr (6.2.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+    uri (1.0.3)
+    vcr (6.3.1)
+      base64
 
 PLATFORMS
   ruby

data/README.md

@@ -14,9 +14,7 @@ gem "spotifyrb"
 
 ### Set Client Details
 
-Firstly you'll need to set a Client ID and an Access Token.
-
-An access token is required because the Spotify API requires authentication.
+Firstly you'll need to set an Access Token, because the Spotify API requires authentication.
 
 ```ruby
 @client = Spotify::Client.new(access_token: "xyz123")
@@ -26,542 +24,97 @@ An access token is required because the Spotify API requires authentication.
 
 The gem maps as closely as we can to the Spotify API so you can easily convert API examples to gem code.
 
-Responses are created as objects like `Spotify::Channel`. Having types like `Spotify::User` is handy for understanding what
+Responses are created as objects like `Spotify::Track`. Having types like `Spotify::User` is handy for understanding what
 type of object you're working with. They're built using OpenStruct so you can easily access data in a Ruby-ish way.
 
-### Pagination
-
-Some of the endpoints return pages of results. The result object will have a `data` key to access the results, as well as metadata like `cursor`
-for retrieving the next and previous pages. This can be used by using `before` and `after` parameters, on API endpoints that support it.
-
-An example of using collections, including pagination:
+### Me
 
 ```ruby
-results = @client.clips.list(broadcaster_id: 123)
-#=> Spotify::Collection
-
-results.total
-#=> 30
-
-results.data
-#=> [#<Spotify::Clip>, #<Spotify::Clip>]
-
-results.each do |result|
-  puts result.id
-end
-
-results.first
-#=> #<Spotify::Clip>
-
-results.last
-#=> #<Spotify::Clip>
-
-results.cursor
-#=> "abc123"
-
-# Retrieve the next page
-@client.clips.list(broadcaster_id: 123, after: results.cursor)
-#=> Spotify::Collection
-```
-
-### OAuth
-
-This library includes the ability to create, refresh and revoke OAuth tokens.
-
-```ruby
-# Firstly, set the client details
-@oauth = Spotify::OAuth.new(client_id: "", client_secret: "")
-
-# Create a Token
-# grant_type can be either "authorization_code" or "client_credentials"
-# scope is a space-delimited list of scopes. This is optional depending on the grant_type
-@oauth.create(grant_type: "", scope: "")
-
-# Refresh a Token
-@oauth.refresh(refresh_token: "")
-
-# Device Code Grant Flow
-# scopes is required and is a space-delimited list of scopes
-# https://dev.spotify.tv/docs/authentication/getting-tokens-oauth/#device-code-grant-flow
-@oauth.device(scopes: "bits:read channel:read:subscriptions")
-
-# Validate an Access Token
-# Returns false if the token is invalid
-@oauth.validate(token: "")
+# Retrieves the currently authenticated user's details
+@client.me.me
 
-# Revoke a Token
-@oauth.revoke(token: "")
+# Retrieves the currently authenticated user's playlists
+@client.me.playlists
+@client.me.playlists(limit: 10)
 ```
 
 ### Users
 
 ```ruby
-# Retrieves a user by their ID
-@client.users.retrieve(id: 141981764)
-
-# Retrieves multiple users by their IDs
-# Requires an array of IDs
-@client.users.retrieve(ids: [141981764, 72938118])
-
-# Retrieves a user by their username
-@client.users.retrieve(username: "spotifydev")
-
-# Retrieves multiple users by their usernames
-# Requires an array of IDs
-@client.users.retrieve(usernames: ["spotifydev", "deanpcmad"])
-
-# Update the currently authenticated user's description
-# Required scope: user:edit
-@client.users.update(description: "New Description")
-
-# Returns Blocked users for a broadcaster
-# Required scope: user:read:blocked_users
-@client.users.blocks(broadcaster_id: 141981764)
-
-# Blocks a user
-# Required scope: user:manage:blocked_users
-@client.users.block_user(target_user_id: 141981764)
-
-# Unblocks a user
-# Required scope: user:manage:blocked_users
-@client.users.unblock_user(target_user_id: 141981764)
-
-# Get a User's Chat Color
-@client.users.get_color(user_id: 123)
-
-# Or get multiple users' chat colors
-# Returns a collection
-@client.users.get_color(user_ids: "123,321")
-
-# Update a User's Chat Color
-# Requires user:manage:chat_color
-# user_id must be the currently authenticated user
-# Current allowed colours: blue, blue_violet, cadet_blue, chocolate, coral, dodger_blue, firebrick, golden_rod, green, hot_pink, orange_red, red, sea_green, spring_green, yellow_green
-# For Turbo and Prime users, a hex colour code is allowed.
-@client.users.update_color(user_id: 123, color: "blue")
-
-# Get Emotes a User has
-# Required scope: user:read:emotes
-@client.users.emotes(user_id: 123)
-@client.users.emotes(user_id: 123, broadcaster_id: 321)
-@client.users.emotes(user_id: 123, after: "abc123")
-```
-
-### Channels
-
-```ruby
-# Retrieve a channel by their ID
-@client.channels.retrieve(id: 141981764)
-
-# Retrieve a list of broadcasters a specified user follows
-# user_id must match the currently authenticated user
-# Required scope: user:read:follows
-@client.channels.followed user_id: 123123
-
-# Retrieve a list of users that follow a specified broadcaster
-# broadcaster_id must match the currently authenticated user or
-# a moderator of the specified broadcaster
-# Required scope: moderator:read:followers
-@client.channels.followers broadcaster_id: 123123
-
-# Retrieve the number of Followers a broadcaster has
-@client.channels.follows_count(broadcaster_id: 141981764)
-
-# Retrieve the number of Subscribers and Subscriber Points a broadcaster has
-# Required scope: channel:read:subscriptions
-@client.channels.subscribers_count(broadcaster_id: 141981764)
-
-# Update the currently authenticated channel details
-# Required scope: channel:manage:broadcast
-# Parameters which are allowed: game_id, title, broadcaster_language, delay
-attributes = {title: "My new title"}
-@client.channels.update(broadcaster_id: 141981764, attributes)
-
-# Retrieves editors for a channel
-@client.channels.editors(broadcaster_id: 141981764)
-```
-
-### Videos
-
-```ruby
-# Retrieves a list of videos
-# Available parameters: user_id or game_id
-@client.videos.list(user_id: 12345)
-@client.videos.list(game_id: 12345)
-
-# Retrieves a video by its ID
-@client.videos.retrieve(id: 12345)
-```
-
-### Clips
+# Get's a user's profile. ID would be their Spotify ID
+@client.users.get(id: "username")
 
-```ruby
-# Retrieves a list of clips
-# Available parameters: broadcaster_id or game_id
-@client.clips.list(user_id: 12345)
-@client.clips.list(game_id: 12345)
-
-# Retrieves a clip by its ID.
-# Clip IDs are alphanumeric. e.g. AwkwardHelplessSalamanderSwiftRage
-@client.clips.retrieve(id: "AwkwardHelplessSalamanderSwiftRage")
-
-# Create a clip of a given Channel
-# Required scope: clips:edit
-@client.clips.create(broadcaster_id: 1234)
+# Gets a list of a user's playlists
+@client.users.playlists(id: "username")
+@client.users.playlists(id: "username", limit: 10)
 ```
 
-### Emotes
+### Playlists
 
 ```ruby
-# Retrieve all global emotes
-@client.emotes.global
+# Get a Playlist
+@client.playlists.get(id: "abc123")
 
-# Retrieve emotes for a channel
-@client.emotes.channel(broadcaster_id: 141981764)
+# Create a Playlist
+@client.playlists.create(user: "userid", name: "My Playlist")
+@client.playlists.create(user: "userid", name: "My Playlist", public: true)
+@client.playlists.create(user: "userid", name: "My Playlist", description: "My Description")
 
-# Retrieve emotes for an emote set
-@client.emotes.sets(emote_set_id: 301590448)
-```
+# Update a Playlist
+@client.playlists.update(id: "abc123", name: "A name change")
 
-### Badges
+# Get the tracks on a Playlist
+@client.playlists.tracks(id: "abc123")
+@client.playlists.tracks(id: "abc123", market: "GB")
 
-```ruby
-# Retrieve all global badges
-@client.badges.global
+# Add a track (or multiple tracks) to a Playlist
+# uris should be in the following format: 'spotify:type:id' e.g. 'spotify:track:1k2pQc5i348DCHwbn5KTdc'
+# to add multiple tracks, uris should be comma separated
+# If successful, returns a Snapshot ID
+@client.playlists.add_tracks(id: "abc123", uris: "spotify:track:1k2pQc5i348DCHwbn5KTdc")
+@client.playlists.add_tracks(id: "abc123", uris: "spotify:track:1k2pQc5i348DCHwbn5KTdc", position: 0)
 
-# Retrieve badges for a channel
-@client.badges.channel(broadcaster_id: 141981764)
+# Remove a track (or multiple tracks) from a Playlist
+@client.playlists.remove_tracks(id: "abc123", uris: "spotify:track:1k2pQc5i348DCHwbn5KTdc")
+@client.playlists.remove_tracks(id: "abc123", snapshot_id: "123abc")
 ```
 
-### Games
+### Player
 
 ```ruby
-# Retrieves a game by ID
-@client.games.retrieve(id: 514974)
+# Get the Player state
+@client.player.state
+@client.player.state(market: "GB")
 
-# Retrieves multiple games by IDs
-# Requires an array of IDs
-@client.games.retrieve(ids: [66402, 514974])
+# Get the Player Devices
+@client.player.devices
 
-# Retrieves a game by name
-@client.games.retrieve(name: "Battlefield 4")
+# Get the current playing song
+@client.player.playing
+@client.player.playing(market: "GB")
 
-# Retrieves multiple games by names
-# Requires an array of IDs
-@client.games.retrieve(names: ["Battlefield 4", "Battlefield 2042"])
-```
+# Start/Resume Playback
+@client.player.play
+@client.player.play(device: "abc123")
 
-### EventSub Subscriptions
+# Pause Playback
+@client.player.pause
+@client.player.pause(device: "abc123")
 
-These require an application OAuth access token.
+# Skip to next
+@client.player.next
+@client.player.next(device: "abc123")
 
-```ruby
-# Retrieves a list of EventSub Subscriptions
-# Available parameters: status, type, after
-@client.eventsub_subscriptions.list
-@client.eventsub_subscriptions.list(status: "enabled")
-@client.eventsub_subscriptions.list(type: "channel.follow")
-
-# Create an EventSub Subscription
-@client.eventsub_subscriptions.create(
-  type: "channel.follow",
-  version: 1,
-  condition: {broadcaster_user_id: 123},
-  transport: {method: "webhook", callback: "webhook_url", secret: "secret"}
-)
-
-# Delete an EventSub Subscription
-# IDs are UUIDs
-@client.eventsub_subscriptions.delete(id: "abc12-abc12-abc12")
-```
+# Skip to previous
+@client.player.previous
+@client.player.previous(device: "abc123")
 
-### Banned Events
+# Get the player queue
+@client.player.queue
 
-```ruby
-# Retrieves all ban and un-ban events for a channel
-# Available parameters: user_id
-@client.banned_events.list(broadcaster_id: 123)
-```
-
-### Banned Users
-
-```ruby
-# Retrieves all banned and timed-out users for a channel
-# Available parameters: user_id
-@client.banned_users.list(broadcaster_id: 123)
-```
-
-```ruby
-# Ban/Timeout a user from a broadcaster's channel
-# Required scope: moderator:manage:banned_users
-# A reason is required
-# To time a user out, a duration is required. If no duration is set, the user will be banned.
-@client.banned_users.create broadcaster_id: 123, moderator_id: 321, user_id: 112233, reason: "testing", duration: 60
-```
-
-```ruby
-# Unban/untimeout a user from a broadcaster's channel
-# Required scope: moderator:manage:banned_users
-@client.banned_users.delete broadcaster_id: 123, moderator_id: 321, user_id: 112233
-```
-
-### Send Chat Announcement
-
-```ruby
-# Sends an announcement to the broadcaster's chat room
-# Requires moderator:manage:announcements
-# moderator_id can be either the currently authenticated moderator or the broadcaster
-# color can be either blue, green, orange, purple, primary. If left blank, primary is default
-@client.announcements.create broadcaster_id: 123, moderator_id: 123, message: "test message", color: "purple"
-```
-
-### Create a Shoutout
-
-```ruby
-# Creates a Shoutout for a broadcaster
-# Requires moderator:manage:shoutouts
-# From: the ID of the Broadcaster creating the Shoutout
-# To: the ID of the Broadcaster the Shoutout will be for
-# moderator_id can be either the currently authenticated moderator or the broadcaster
-@client.shoutouts.create from: 123, to: 321, moderator_id: 123
-```
-
-### Moderators
-
-```ruby
-# List all channels a user has moderator privileges on
-# Required scope: user:read:moderated_channels
-# user_id must be the currently authenticated user
-@client.moderators.channels user_id: 123
-```
-
-```ruby
-# List all moderators for a broadcaster
-# Required scope: moderation:read
-# broadcaster_id must be the currently authenticated user
-@client.moderators.list broadcaster_id: 123
-```
-
-```ruby
-# Add a Moderator
-# Required scope: channel:manage:moderators
-# broadcaster_id must be the currently authenticated user
-@client.moderators.create broadcaster_id: 123, user_id: 321
-```
-
-```ruby
-# Remove a Moderator
-# Required scope: channel:manage:moderators
-# broadcaster_id must be the currently authenticated user
-@client.moderators.delete broadcaster_id: 123, user_id: 321
-```
-
-### VIPs
-
-```ruby
-# List all VIPs for a broadcaster
-# Required scope: channel:read:vips or channel:manage:vips
-# broadcaster_id must be the currently authenticated user
-@client.vips.list broadcaster_id: 123
-```
-
-```ruby
-# Add a VIP
-# Required scope: channel:manage:vips
-# broadcaster_id must be the currently authenticated user
-@client.vips.create broadcaster_id: 123, user_id: 321
-```
-
-```ruby
-# Remove a VIP
-# Required scope: channel:manage:vips
-# broadcaster_id must be the currently authenticated user
-@client.vips.delete broadcaster_id: 123, user_id: 321
-```
-
-### Raids
-
-```ruby
-# Starts a raid
-# Requires channel:manage:raids
-# from_broadcaster_id must be the authenticated user
-@client.raids.create from_broadcaster_id: 123, to_broadcaster_id: 321
-```
-
-```ruby
-# Requires channel:manage:raids
-# broadcaster_id must be the authenticated user
-@client.raids.delete broadcaster_id: 123
-```
-
-### Chat Messages
-
-```ruby
-# Send a chat message to a broadcaster's chat room
-# Requires an app or user access token that includes user:write:chat then either user:bot or channel:bot
-# sender_id must be the currently authenticated user
-# reply_to is optional and is the UUID of the message to reply to
-@client.chat_messages.create broadcaster_id: 123, sender_id: 321, message: "A test message", reply_to: "aabbcc"
-
-# Removes a single chat message from the broadcaster's chat room
-# Requires moderator:manage:chat_messages
-# moderator_id can be either the currently authenticated moderator or the broadcaster
-@client.chat_messages.delete broadcaster_id: 123, moderator_id: 123, message_id: "abc123-abc123"
-```
-
-### Whispers
-
-```ruby
-# Send a Whisper
-# Required scope: user:manage:whispers
-# from_user_id must be the currently authenticated user's ID and have a verified phone number
-@client.whispers.create from_user_id: 123, to_user_id: 321, message: "this is a test"
-```
-
-### AutoMod
-
-```ruby
-# Check if a message meets the channel's AutoMod requirements
-# Required scope: moderation:read
-# id is a developer-generated identifier for mapping messages to results.
-@client.automod.check_status_multiple broadcaster_id: 123, id: "abc123", text: "Is this message allowed?"
-
-#> #<Spotify::AutomodStatus msg_id="abc123", is_permitted=true>
-```
-
-```ruby
-# Check if multiple messages meet the channel's AutoMod requirements
-# messages must be an array of hashes and must include msg_id and msg_text
-# Returns a collection
-messages = [{msg_id: "abc1", msg_text: "is this allowed?"}, {msg_id: "abc2", msg_text: "What about this?"}]
-@client.automod.check_status_multiple broadcaster_id: 123, messages: messages
-```
-
-```ruby
-# Get AutoMod settings
-# Required scope: moderator:read:automod_settings
-# moderator_id can be either the currently authenticated moderator or the broadcaster
-@client.automod.settings broadcaster_id: 123, moderator_id: 321
-```
-
-```ruby
-# Update AutoMod settings
-# Required scope: moderator:manage:automod_settings
-# moderator_id can be either the currently authenticated moderator or the broadcaster
-# As this is a PUT method, it overwrites all options so all fields you want set should be supplied
-@client.automod.update_settings broadcaster_id: 123, moderator_id: 321, swearing: 1
-```
-
-### Creator Goals
-
-```ruby
-# List all active creator goals
-# Required scope: channel:read:goals
-# broadcaster_id must match the currently authenticated user
-@client.goals.list broadcaster_id: 123
-```
-
-### Blocked Terms
-
-```ruby
-# List all blocked terms
-# Required scope: moderator:read:blocked_terms
-# moderator_id can be either the currently authenticated moderator or the broadcaster
-@client.blocked_terms.list broadcaster_id: 123, moderator_id: 321
-```
-
-```ruby
-# Create a blocked term
-# Required scope: moderator:manage:blocked_terms
-# moderator_id can be either the currently authenticated moderator or the broadcaster
-@client.blocked_terms.create broadcaster_id: 123, moderator_id: 321, text: "term to block"
-```
-
-```ruby
-# Delete a blocked term
-# Required scope: moderator:manage:blocked_terms
-# moderator_id can be either the currently authenticated moderator or the broadcaster
-@client.blocked_terms.delete broadcaster_id: 123, moderator_id: 321, id: "abc12-12abc"
-```
-
-### Charity Campaigns
-
-```ruby
-# Gets information about the charity campaign that a broadcaster is running
-# Required scope: channel:read:charity
-# broadcaster_id must match the currently authenticated user
-@client.charity_campaigns.list broadcaster_id: 123
-```
-
-### Chatters
-
-```ruby
-# Gets the list of users that are connected to the specified broadcaster’s chat session
-# Required scope: moderator:read:chatters
-# broadcaster_id must match the currently authenticated user
-@client.chatters.list broadcaster_id: 123, moderator_id: 123
-```
-
-### Channel Points Custom Rewards
-
-```ruby
-# Gets a list of custom rewards for a specific channel
-# Required scope: channel:read:redemptions
-# broadcaster_id must match the currently authenticated user
-@client.custom_rewards.list broadcaster_id: 123
-
-# Create a custom reward
-# Required scope: channel:manage:redemptions
-# broadcaster_id must match the currently authenticated user
-@client.custom_rewards.create broadcaster_id: 123, title: "New Reward", cost: 1000
-
-# Update a custom reward
-# Required scope: channel:manage:redemptions
-# broadcaster_id must match the currently authenticated user
-@client.custom_rewards.update broadcaster_id: 123, reward_id: 321, title: "Updated Reward"
-
-# Delete a custom reward
-# Required scope: channel:manage:redemptions
-# broadcaster_id must match the currently authenticated user
-@client.custom_rewards.delete broadcaster_id: 123, reward_id: 321
-```
-
-### Channel Points Custom Reward Redemptions
-
-```ruby
-# Gets a list of custom reward redemptions for a specific channel
-# Required scope: channel:read:redemptions
-# broadcaster_id must match the currently authenticated user
-@client.custom_reward_redemptions.list broadcaster_id: 123, reward_id: 321, status: "UNFULFILLED"
-
-# Update a custom reward redemption status
-# Required scope: channel:manage:redemptions
-# broadcaster_id must match the currently authenticated user
-# Status can be FULFILLED or CANCELED
-@client.custom_reward_redemptions.update broadcaster_id: 123, reward_id: 321, redemption_id: 123, status: "FULFILLED"
-```
-
-### Unban Requests
-
-```ruby
-# Retrieves a list of Unban Requests for a broadcaster
-# Required scope: moderator:read:unban_requests or moderator:manage:unban_requests
-# moderator_id must match the currently authenticated user
-@client.unban_requests.list broadcaster_id: 123, moderator_id: 123, status: "pending"
-
-# Resolve an Unban Request
-# Required scope: moderator:manage:unban_requests
-# moderator_id must match the currently authenticated user
-@client.unban_requests.resolve broadcaster_id: 123, moderator_id: 123, id: "abc123", status: "approved"
-```
-
-### Warnings
-
-```ruby
-# Sends a warning to a user
-# Required scope: moderator:manage:warnings
-# moderator_id must match the currently authenticated user
-@client.warnings.create broadcaster_id: 123, moderator_id: 123, user_id: 321, reason: "dont do that"
+# Add an item to the queue
+@client.player.add_to_queue(uri: "spotify:track:1k2pQc5i348DCHwbn5KTdc")
+@client.player.add_to_queue(uri: "spotify:track:1k2pQc5i348DCHwbn5KTdc", device: "abc123")
 ```
 
 

data/lib/spotify/client.rb

@@ -37,6 +37,10 @@ module Spotify
       PlaylistsResource.new(self)
     end
 
+    def tracks
+      TracksResource.new(self)
+    end
+
     def connection
       @connection ||= Faraday.new(BASE_URL) do |conn|
         conn.request :authorization, :Bearer, access_token

data/lib/spotify/resources/player.rb

@@ -42,5 +42,15 @@ module Spotify
       response = post_request("me/player/previous", body: { device_id: device }.compact)
       response.success?
     end
+
+    def queue
+      response = get_request("me/player/queue")
+      Collection.from_response(response, type: Track, key: "queue")
+    end
+
+    def add_to_queue(uri:, device: nil)
+      response = post_request("me/player/queue?uri=#{uri}&device=#{device}", body: nil)
+      response.success?
+    end
   end
 end

data/lib/spotify/resources/tracks.rb

@@ -0,0 +1,12 @@
+module Spotify
+  class TracksResource < Resource
+    def list(ids:, **params)
+      response = get_request("tracks", params: { ids: ids }.merge(params))
+      Collection.from_response(response, type: Track, key: "tracks")
+    end
+    def get(id:, **params)
+      response = get_request("tracks/#{id}", params: params)
+      Playlist.new response.body
+    end
+  end
+end

data/lib/spotify/version.rb

@@ -1,3 +1,3 @@
 module Spotify
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

data/lib/spotify.rb

@@ -21,6 +21,7 @@ module Spotify
   autoload :AlbumsResource, "spotify/resources/albums"
   autoload :ArtistsResource, "spotify/resources/artists"
   autoload :PlaylistsResource, "spotify/resources/playlists"
+  autoload :TracksResource, "spotify/resources/tracks"
 
   autoload :User, "spotify/objects/user"
   autoload :Album, "spotify/objects/album"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: spotifyrb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Dean Perry
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -61,7 +61,6 @@ files:
 - lib/spotify/collection.rb
 - lib/spotify/error.rb
 - lib/spotify/error_generator.rb
-- lib/spotify/oauth.rb
 - lib/spotify/object.rb
 - lib/spotify/objects/album.rb
 - lib/spotify/objects/artist.rb
@@ -81,6 +80,7 @@ files:
 - lib/spotify/resources/player.rb
 - lib/spotify/resources/playlists.rb
 - lib/spotify/resources/search.rb
+- lib/spotify/resources/tracks.rb
 - lib/spotify/resources/users.rb
 - lib/spotify/version.rb
 - lib/spotifyrb.rb
@@ -105,7 +105,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.6.2
 specification_version: 4
 summary: A Ruby library for interacting with the Spotify API
 test_files: []

data/lib/spotify/oauth.rb

@@ -1,61 +0,0 @@
-module Spotify
-  class OAuth
-    attr_reader :client_id, :client_secret
-
-    def initialize(client_id:, client_secret:)
-      @client_id = client_id
-      @client_secret = client_secret
-    end
-
-    def create(grant_type:, scope: nil)
-      send_request(url: "https://id.spotify.tv/oauth2/token", body: {
-        client_id: client_id,
-        client_secret: client_secret,
-        grant_type: grant_type,
-        scope: scope
-      })
-    end
-
-    def refresh(refresh_token:)
-      send_request(url: "https://id.spotify.tv/oauth2/token", body: {
-        client_id: client_id,
-        client_secret: client_secret,
-        grant_type: "refresh_token",
-        refresh_token: refresh_token
-      })
-    end
-
-    def device(scopes:)
-      send_request(url: "https://id.spotify.tv/oauth2/device", body: { client_id: client_id, scope: scopes })
-    end
-
-    def validate(token:)
-      response = Faraday.get("https://id.spotify.tv/oauth2/validate", nil, { "Authorization" => "OAuth #{token}" })
-
-      return false if response.status != 200
-
-      JSON.parse(response.body, object_class: OpenStruct)
-    end
-
-    def revoke(token:)
-      response = Faraday.post("https://id.spotify.tv/oauth2/revoke", {
-        client_id: client_id,
-        token: token
-      })
-
-      JSON.parse(response.body, object_class: OpenStruct) if response.status != 200
-
-      true
-    end
-
-    private
-
-    def send_request(url:, body:)
-      response = Faraday.post(url, body)
-
-      return false if response.status != 200
-
-      JSON.parse(response.body, object_class: OpenStruct)
-    end
-  end
-end