spotted 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69011802cc24ebf07c3e3d147833884b4ed56bb7237c0fd6da89c0206ffd58c3
-  data.tar.gz: 17fb6b912a0ec3914a5ff7f1921a0411eaf5b04d325c45e78f709bf6b1e59d71
+  metadata.gz: af077c728fe204cc5fda22ae070754b27a2e4355184b059bd85a5edf1548885a
+  data.tar.gz: 0f5c5e2ea9e445b2d49b6c71b40f6672dab9d2d89e7e27b9ca9b1b581983c90b
 SHA512:
-  metadata.gz: 546c738d922c2d58202bad6bc2b87f1f0a98ed6bf6b3304dda7bbd824e096fcf50a00ac0261b9eb7b3854c9a62b8eb80f81ba5f31d6a92d52e7afad0e155c35d
-  data.tar.gz: b73b1d99987f83e64182ffbb4a45e5ee9e8abab95ae7973cdeb186ca32850d4e2dc946a9100d99602f784bc6d196aaae9453773c805b744fda85444a7ef9c4f7
+  metadata.gz: 98ec3a3dad684fe4328272169de4863f38ccd305a5fcacee42f12d9934e9e985ae94953281601bf6f9fdc47258b00e566ba8b23f2baf6c4fefa08cee61b3ab19
+  data.tar.gz: 01aec0e6dcc2dd12eb5984094784a80f3b92bf6da95272337191e21bb4faa6b5b1362f1792c4e429f13fe58e556576559742d64820098598e34c1122ad784b4c

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.9.0 (2025-11-10)
+
+Full Changelog: [v0.8.0...v0.9.0](https://github.com/cjavdev/spotted/compare/v0.8.0...v0.9.0)
+
+### Features
+
+* **api:** manual updates ([d7059d0](https://github.com/cjavdev/spotted/commit/d7059d0b67ffd498ea79c2a3322a203759679eef))
+* **api:** manual updates ([08b7c1c](https://github.com/cjavdev/spotted/commit/08b7c1c5f32b6ddee5a19f902578403b574d9057))
+* **api:** manual updates ([bc5c542](https://github.com/cjavdev/spotted/commit/bc5c5426c61c72b5ced96ea90fce4753660b2def))
+* **api:** manual updates ([283529b](https://github.com/cjavdev/spotted/commit/283529b11d5c51164d4387c4c30a642760278bf3))
+
 ## 0.8.0 (2025-11-10)
 
 Full Changelog: [v0.7.0...v0.8.0](https://github.com/cjavdev/spotted/compare/v0.7.0...v0.8.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "spotted", "~> 0.8.0"
+gem "spotted", "~> 0.9.0"
 ```
 
 <!-- x-release-please-end -->
@@ -38,6 +38,34 @@ album = spotted.albums.retrieve("4aawyAB9vmqN3uQ7FjRGTy")
 puts(album.id)
 ```
 
+### Pagination
+
+List methods in the Spotted API are paginated.
+
+This library provides auto-paginating iterators with each list response, so you do not have to request successive pages manually:
+
+```ruby
+page = spotted.shows.list_episodes("showid", limit: 5, offset: 10)
+
+# Fetch single item from page.
+show = page.items[0]
+puts(show.id)
+
+# Automatically fetches more pages as needed.
+page.auto_paging_each do |show|
+  puts(show.id)
+end
+```
+
+Alternatively, you can use the `#next_page?` and `#next_page` methods for more granular control working with pages.
+
+```ruby
+if page.next_page?
+  new_page = page.next_page
+  puts(new_page.items[0].id)
+end
+```
+
 ### Handling errors
 
 When the library is unable to connect to the API, or if the API returns a non-success status code (i.e., 4xx or 5xx response), a subclass of `Spotted::Errors::APIError` will be thrown:

data/lib/spotted/models/{artist_list_params.rb → artist_bulk_retrieve_params.rb}

@@ -2,8 +2,8 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Artists#list
-    class ArtistListParams < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Artists#bulk_retrieve
+    class ArtistBulkRetrieveParams < Spotted::Internal::Type::BaseModel
       extend Spotted::Internal::Type::RequestParameters::Converter
       include Spotted::Internal::Type::RequestParameters
 
@@ -17,7 +17,7 @@ module Spotted
 
       # @!method initialize(ids:, request_options: {})
       #   Some parameter documentations has been truncated, see
-      #   {Spotted::Models::ArtistListParams} for more details.
+      #   {Spotted::Models::ArtistBulkRetrieveParams} for more details.
       #
       #   @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
       #

data/lib/spotted/models/{artist_list_response.rb → artist_bulk_retrieve_response.rb}

@@ -2,8 +2,8 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Artists#list
-    class ArtistListResponse < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Artists#bulk_retrieve
+    class ArtistBulkRetrieveResponse < Spotted::Internal::Type::BaseModel
       # @!attribute artists
       #
       #   @return [Array<Spotted::Models::ArtistObject>]

data/lib/spotted/models/{artist_list_top_tracks_params.rb → artist_top_tracks_params.rb}

@@ -2,8 +2,8 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Artists#list_top_tracks
-    class ArtistListTopTracksParams < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Artists#top_tracks
+    class ArtistTopTracksParams < Spotted::Internal::Type::BaseModel
       extend Spotted::Internal::Type::RequestParameters::Converter
       include Spotted::Internal::Type::RequestParameters
 
@@ -23,7 +23,7 @@ module Spotted
 
       # @!method initialize(market: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
-      #   {Spotted::Models::ArtistListTopTracksParams} for more details.
+      #   {Spotted::Models::ArtistTopTracksParams} for more details.
       #
       #   @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
       #

data/lib/spotted/models/{track_list_response.rb → artist_top_tracks_response.rb}

@@ -2,8 +2,8 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Tracks#list
-    class TrackListResponse < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Artists#top_tracks
+    class ArtistTopTracksResponse < Spotted::Internal::Type::BaseModel
       # @!attribute tracks
       #
       #   @return [Array<Spotted::Models::TrackObject>]

data/lib/spotted/models/{audio_feature_list_params.rb → audio_feature_bulk_retrieve_params.rb}

@@ -2,8 +2,8 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::AudioFeatures#list
-    class AudioFeatureListParams < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::AudioFeatures#bulk_retrieve
+    class AudioFeatureBulkRetrieveParams < Spotted::Internal::Type::BaseModel
       extend Spotted::Internal::Type::RequestParameters::Converter
       include Spotted::Internal::Type::RequestParameters
 
@@ -17,7 +17,7 @@ module Spotted
 
       # @!method initialize(ids:, request_options: {})
       #   Some parameter documentations has been truncated, see
-      #   {Spotted::Models::AudioFeatureListParams} for more details.
+      #   {Spotted::Models::AudioFeatureBulkRetrieveParams} for more details.
       #
       #   @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
       #

data/lib/spotted/models/{audio_feature_list_response.rb → audio_feature_bulk_retrieve_response.rb}

@@ -2,16 +2,16 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::AudioFeatures#list
-    class AudioFeatureListResponse < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::AudioFeatures#bulk_retrieve
+    class AudioFeatureBulkRetrieveResponse < Spotted::Internal::Type::BaseModel
       # @!attribute audio_features
       #
-      #   @return [Array<Spotted::Models::AudioFeatureListResponse::AudioFeature>]
+      #   @return [Array<Spotted::Models::AudioFeatureBulkRetrieveResponse::AudioFeature>]
       required :audio_features,
-               -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::AudioFeatureListResponse::AudioFeature] }
+               -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::AudioFeatureBulkRetrieveResponse::AudioFeature] }
 
       # @!method initialize(audio_features:)
-      #   @param audio_features [Array<Spotted::Models::AudioFeatureListResponse::AudioFeature>]
+      #   @param audio_features [Array<Spotted::Models::AudioFeatureBulkRetrieveResponse::AudioFeature>]
 
       class AudioFeature < Spotted::Internal::Type::BaseModel
         # @!attribute id
@@ -139,8 +139,8 @@ module Spotted
         # @!attribute type
         #   The object type.
         #
-        #   @return [Symbol, Spotted::Models::AudioFeatureListResponse::AudioFeature::Type, nil]
-        optional :type, enum: -> { Spotted::Models::AudioFeatureListResponse::AudioFeature::Type }
+        #   @return [Symbol, Spotted::Models::AudioFeatureBulkRetrieveResponse::AudioFeature::Type, nil]
+        optional :type, enum: -> { Spotted::Models::AudioFeatureBulkRetrieveResponse::AudioFeature::Type }
 
         # @!attribute uri
         #   The Spotify URI for the track.
@@ -159,7 +159,8 @@ module Spotted
 
         # @!method initialize(id: nil, acousticness: nil, analysis_url: nil, danceability: nil, duration_ms: nil, energy: nil, instrumentalness: nil, key: nil, liveness: nil, loudness: nil, mode: nil, speechiness: nil, tempo: nil, time_signature: nil, track_href: nil, type: nil, uri: nil, valence: nil)
         #   Some parameter documentations has been truncated, see
-        #   {Spotted::Models::AudioFeatureListResponse::AudioFeature} for more details.
+        #   {Spotted::Models::AudioFeatureBulkRetrieveResponse::AudioFeature} for more
+        #   details.
         #
         #   @param id [String] The Spotify ID for the track.
         #
@@ -191,7 +192,7 @@ module Spotted
         #
         #   @param track_href [String] A link to the Web API endpoint providing full details of the track.
         #
-        #   @param type [Symbol, Spotted::Models::AudioFeatureListResponse::AudioFeature::Type] The object type.
+        #   @param type [Symbol, Spotted::Models::AudioFeatureBulkRetrieveResponse::AudioFeature::Type] The object type.
         #
         #   @param uri [String] The Spotify URI for the track.
         #
@@ -199,7 +200,7 @@ module Spotted
 
         # The object type.
         #
-        # @see Spotted::Models::AudioFeatureListResponse::AudioFeature#type
+        # @see Spotted::Models::AudioFeatureBulkRetrieveResponse::AudioFeature#type
         module Type
           extend Spotted::Internal::Type::Enum
 

data/lib/spotted/models/{audiobook_list_params.rb → audiobook_bulk_retrieve_params.rb}

@@ -2,8 +2,8 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Audiobooks#list
-    class AudiobookListParams < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Audiobooks#bulk_retrieve
+    class AudiobookBulkRetrieveParams < Spotted::Internal::Type::BaseModel
       extend Spotted::Internal::Type::RequestParameters::Converter
       include Spotted::Internal::Type::RequestParameters
 
@@ -31,7 +31,7 @@ module Spotted
 
       # @!method initialize(ids:, market: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
-      #   {Spotted::Models::AudiobookListParams} for more details.
+      #   {Spotted::Models::AudiobookBulkRetrieveParams} for more details.
       #
       #   @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
       #

data/lib/spotted/models/{audiobook_list_response.rb → audiobook_bulk_retrieve_response.rb}

@@ -2,29 +2,29 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Audiobooks#list
-    class AudiobookListResponse < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Audiobooks#bulk_retrieve
+    class AudiobookBulkRetrieveResponse < Spotted::Internal::Type::BaseModel
       # @!attribute audiobooks
       #
-      #   @return [Array<Spotted::Models::AudiobookListResponse::Audiobook>]
+      #   @return [Array<Spotted::Models::AudiobookBulkRetrieveResponse::Audiobook>]
       required :audiobooks,
-               -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::AudiobookListResponse::Audiobook] }
+               -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::AudiobookBulkRetrieveResponse::Audiobook] }
 
       # @!method initialize(audiobooks:)
-      #   @param audiobooks [Array<Spotted::Models::AudiobookListResponse::Audiobook>]
+      #   @param audiobooks [Array<Spotted::Models::AudiobookBulkRetrieveResponse::Audiobook>]
 
       class Audiobook < Spotted::Models::AudiobookBase
         # @!attribute chapters
         #   The chapters of the audiobook.
         #
-        #   @return [Spotted::Models::AudiobookListResponse::Audiobook::Chapters]
-        required :chapters, -> { Spotted::Models::AudiobookListResponse::Audiobook::Chapters }
+        #   @return [Spotted::Models::AudiobookBulkRetrieveResponse::Audiobook::Chapters]
+        required :chapters, -> { Spotted::Models::AudiobookBulkRetrieveResponse::Audiobook::Chapters }
 
         # @!method initialize(chapters:)
         #   Some parameter documentations has been truncated, see
-        #   {Spotted::Models::AudiobookListResponse::Audiobook} for more details.
+        #   {Spotted::Models::AudiobookBulkRetrieveResponse::Audiobook} for more details.
         #
-        #   @param chapters [Spotted::Models::AudiobookListResponse::Audiobook::Chapters] The chapters of the audiobook.
+        #   @param chapters [Spotted::Models::AudiobookBulkRetrieveResponse::Audiobook::Chapters] The chapters of the audiobook.
 
         class Chapters < Spotted::Internal::Type::BaseModel
           # @!attribute href
@@ -70,7 +70,8 @@ module Spotted
 
           # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
           #   Some parameter documentations has been truncated, see
-          #   {Spotted::Models::AudiobookListResponse::Audiobook::Chapters} for more details.
+          #   {Spotted::Models::AudiobookBulkRetrieveResponse::Audiobook::Chapters} for more
+          #   details.
           #
           #   The chapters of the audiobook.
           #

data/lib/spotted/models/{chapter_list_params.rb → chapter_bulk_retrieve_params.rb}

@@ -2,8 +2,8 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Chapters#list
-    class ChapterListParams < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Chapters#bulk_retrieve
+    class ChapterBulkRetrieveParams < Spotted::Internal::Type::BaseModel
       extend Spotted::Internal::Type::RequestParameters::Converter
       include Spotted::Internal::Type::RequestParameters
 
@@ -31,7 +31,7 @@ module Spotted
 
       # @!method initialize(ids:, market: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
-      #   {Spotted::Models::ChapterListParams} for more details.
+      #   {Spotted::Models::ChapterBulkRetrieveParams} for more details.
       #
       #   @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
       #

data/lib/spotted/models/{chapter_list_response.rb → chapter_bulk_retrieve_response.rb}

@@ -2,15 +2,16 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Chapters#list
-    class ChapterListResponse < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Chapters#bulk_retrieve
+    class ChapterBulkRetrieveResponse < Spotted::Internal::Type::BaseModel
       # @!attribute chapters
       #
-      #   @return [Array<Spotted::Models::ChapterListResponse::Chapter>]
-      required :chapters, -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::ChapterListResponse::Chapter] }
+      #   @return [Array<Spotted::Models::ChapterBulkRetrieveResponse::Chapter>]
+      required :chapters,
+               -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::ChapterBulkRetrieveResponse::Chapter] }
 
       # @!method initialize(chapters:)
-      #   @param chapters [Array<Spotted::Models::ChapterListResponse::Chapter>]
+      #   @param chapters [Array<Spotted::Models::ChapterBulkRetrieveResponse::Chapter>]
 
       class Chapter < Spotted::Internal::Type::BaseModel
         # @!attribute id
@@ -114,15 +115,15 @@ module Spotted
         # @!attribute release_date_precision
         #   The precision with which `release_date` value is known.
         #
-        #   @return [Symbol, Spotted::Models::ChapterListResponse::Chapter::ReleaseDatePrecision]
+        #   @return [Symbol, Spotted::Models::ChapterBulkRetrieveResponse::Chapter::ReleaseDatePrecision]
         required :release_date_precision,
-                 enum: -> { Spotted::Models::ChapterListResponse::Chapter::ReleaseDatePrecision }
+                 enum: -> { Spotted::Models::ChapterBulkRetrieveResponse::Chapter::ReleaseDatePrecision }
 
         # @!attribute type
         #   The object type.
         #
-        #   @return [Symbol, Spotted::Models::ChapterListResponse::Chapter::Type]
-        required :type, enum: -> { Spotted::Models::ChapterListResponse::Chapter::Type }
+        #   @return [Symbol, Spotted::Models::ChapterBulkRetrieveResponse::Chapter::Type]
+        required :type, enum: -> { Spotted::Models::ChapterBulkRetrieveResponse::Chapter::Type }
 
         # @!attribute uri
         #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
@@ -153,7 +154,7 @@ module Spotted
 
         # @!method initialize(id:, audio_preview_url:, audiobook:, chapter_number:, description:, duration_ms:, explicit:, external_urls:, href:, html_description:, images:, is_playable:, languages:, name:, release_date:, release_date_precision:, type:, uri:, available_markets: nil, restrictions: nil, resume_point: nil)
         #   Some parameter documentations has been truncated, see
-        #   {Spotted::Models::ChapterListResponse::Chapter} for more details.
+        #   {Spotted::Models::ChapterBulkRetrieveResponse::Chapter} for more details.
         #
         #   @param id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the chapt
         #
@@ -185,9 +186,9 @@ module Spotted
         #
         #   @param release_date [String] The date the chapter was first released, for example `"1981-12-15"`. Depending o
         #
-        #   @param release_date_precision [Symbol, Spotted::Models::ChapterListResponse::Chapter::ReleaseDatePrecision] The precision with which `release_date` value is known.
+        #   @param release_date_precision [Symbol, Spotted::Models::ChapterBulkRetrieveResponse::Chapter::ReleaseDatePrecision] The precision with which `release_date` value is known.
         #
-        #   @param type [Symbol, Spotted::Models::ChapterListResponse::Chapter::Type] The object type.
+        #   @param type [Symbol, Spotted::Models::ChapterBulkRetrieveResponse::Chapter::Type] The object type.
         #
         #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the chap
         #
@@ -199,7 +200,7 @@ module Spotted
 
         # The precision with which `release_date` value is known.
         #
-        # @see Spotted::Models::ChapterListResponse::Chapter#release_date_precision
+        # @see Spotted::Models::ChapterBulkRetrieveResponse::Chapter#release_date_precision
         module ReleaseDatePrecision
           extend Spotted::Internal::Type::Enum
 
@@ -213,7 +214,7 @@ module Spotted
 
         # The object type.
         #
-        # @see Spotted::Models::ChapterListResponse::Chapter#type
+        # @see Spotted::Models::ChapterBulkRetrieveResponse::Chapter#type
         module Type
           extend Spotted::Internal::Type::Enum
 

data/lib/spotted/models/{episode_list_params.rb → episode_bulk_retrieve_params.rb}

@@ -2,8 +2,8 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Episodes#list
-    class EpisodeListParams < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Episodes#bulk_retrieve
+    class EpisodeBulkRetrieveParams < Spotted::Internal::Type::BaseModel
       extend Spotted::Internal::Type::RequestParameters::Converter
       include Spotted::Internal::Type::RequestParameters
 
@@ -31,7 +31,7 @@ module Spotted
 
       # @!method initialize(ids:, market: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
-      #   {Spotted::Models::EpisodeListParams} for more details.
+      #   {Spotted::Models::EpisodeBulkRetrieveParams} for more details.
       #
       #   @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
       #

data/lib/spotted/models/{episode_list_response.rb → episode_bulk_retrieve_response.rb}

@@ -2,8 +2,8 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Episodes#list
-    class EpisodeListResponse < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Episodes#bulk_retrieve
+    class EpisodeBulkRetrieveResponse < Spotted::Internal::Type::BaseModel
       # @!attribute episodes
       #
       #   @return [Array<Spotted::Models::EpisodeObject>]

data/lib/spotted/models/me/{following_list_params.rb → following_bulk_retrieve_params.rb}

@@ -3,16 +3,16 @@
 module Spotted
   module Models
     module Me
-      # @see Spotted::Resources::Me::Following#list
-      class FollowingListParams < Spotted::Internal::Type::BaseModel
+      # @see Spotted::Resources::Me::Following#bulk_retrieve
+      class FollowingBulkRetrieveParams < Spotted::Internal::Type::BaseModel
         extend Spotted::Internal::Type::RequestParameters::Converter
         include Spotted::Internal::Type::RequestParameters
 
         # @!attribute type
         #   The ID type: currently only `artist` is supported.
         #
-        #   @return [Symbol, Spotted::Models::Me::FollowingListParams::Type]
-        required :type, enum: -> { Spotted::Me::FollowingListParams::Type }
+        #   @return [Symbol, Spotted::Models::Me::FollowingBulkRetrieveParams::Type]
+        required :type, enum: -> { Spotted::Me::FollowingBulkRetrieveParams::Type }
 
         # @!attribute after
         #   The last artist ID retrieved from the previous request.
@@ -28,9 +28,9 @@ module Spotted
 
         # @!method initialize(type:, after: nil, limit: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
-        #   {Spotted::Models::Me::FollowingListParams} for more details.
+        #   {Spotted::Models::Me::FollowingBulkRetrieveParams} for more details.
         #
-        #   @param type [Symbol, Spotted::Models::Me::FollowingListParams::Type] The ID type: currently only `artist` is supported.
+        #   @param type [Symbol, Spotted::Models::Me::FollowingBulkRetrieveParams::Type] The ID type: currently only `artist` is supported.
         #
         #   @param after [String] The last artist ID retrieved from the previous request.
         #

data/lib/spotted/models/me/{following_list_response.rb → following_bulk_retrieve_response.rb}

@@ -3,23 +3,23 @@
 module Spotted
   module Models
     module Me
-      # @see Spotted::Resources::Me::Following#list
-      class FollowingListResponse < Spotted::Internal::Type::BaseModel
+      # @see Spotted::Resources::Me::Following#bulk_retrieve
+      class FollowingBulkRetrieveResponse < Spotted::Internal::Type::BaseModel
         # @!attribute artists
         #
-        #   @return [Spotted::Models::Me::FollowingListResponse::Artists]
-        required :artists, -> { Spotted::Models::Me::FollowingListResponse::Artists }
+        #   @return [Spotted::Models::Me::FollowingBulkRetrieveResponse::Artists]
+        required :artists, -> { Spotted::Models::Me::FollowingBulkRetrieveResponse::Artists }
 
         # @!method initialize(artists:)
-        #   @param artists [Spotted::Models::Me::FollowingListResponse::Artists]
+        #   @param artists [Spotted::Models::Me::FollowingBulkRetrieveResponse::Artists]
 
-        # @see Spotted::Models::Me::FollowingListResponse#artists
+        # @see Spotted::Models::Me::FollowingBulkRetrieveResponse#artists
         class Artists < Spotted::Internal::Type::BaseModel
           # @!attribute cursors
           #   The cursors used to find the next set of items.
           #
-          #   @return [Spotted::Models::Me::FollowingListResponse::Artists::Cursors, nil]
-          optional :cursors, -> { Spotted::Models::Me::FollowingListResponse::Artists::Cursors }
+          #   @return [Spotted::Models::Me::FollowingBulkRetrieveResponse::Artists::Cursors, nil]
+          optional :cursors, -> { Spotted::Models::Me::FollowingBulkRetrieveResponse::Artists::Cursors }
 
           # @!attribute href
           #   A link to the Web API endpoint returning the full result of the request.
@@ -52,9 +52,9 @@ module Spotted
 
           # @!method initialize(cursors: nil, href: nil, items: nil, limit: nil, next_: nil, total: nil)
           #   Some parameter documentations has been truncated, see
-          #   {Spotted::Models::Me::FollowingListResponse::Artists} for more details.
+          #   {Spotted::Models::Me::FollowingBulkRetrieveResponse::Artists} for more details.
           #
-          #   @param cursors [Spotted::Models::Me::FollowingListResponse::Artists::Cursors] The cursors used to find the next set of items.
+          #   @param cursors [Spotted::Models::Me::FollowingBulkRetrieveResponse::Artists::Cursors] The cursors used to find the next set of items.
           #
           #   @param href [String] A link to the Web API endpoint returning the full result of the request.
           #
@@ -66,7 +66,7 @@ module Spotted
           #
           #   @param total [Integer] The total number of items available to return.
 
-          # @see Spotted::Models::Me::FollowingListResponse::Artists#cursors
+          # @see Spotted::Models::Me::FollowingBulkRetrieveResponse::Artists#cursors
           class Cursors < Spotted::Internal::Type::BaseModel
             # @!attribute after
             #   The cursor to use as key to find the next page of items.

data/lib/spotted/models/{search_search_params.rb → search_query_params.rb}

@@ -2,8 +2,8 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Search#search
-    class SearchSearchParams < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Search#query
+    class SearchQueryParams < Spotted::Internal::Type::BaseModel
       extend Spotted::Internal::Type::RequestParameters::Converter
       include Spotted::Internal::Type::RequestParameters
 
@@ -31,8 +31,8 @@ module Spotted
       #   hits from all the specified item types. For example: `q=abacab&type=album,track`
       #   returns both albums and tracks matching "abacab".
       #
-      #   @return [Array<Symbol, Spotted::Models::SearchSearchParams::Type>]
-      required :type, -> { Spotted::Internal::Type::ArrayOf[enum: Spotted::SearchSearchParams::Type] }
+      #   @return [Array<Symbol, Spotted::Models::SearchQueryParams::Type>]
+      required :type, -> { Spotted::Internal::Type::ArrayOf[enum: Spotted::SearchQueryParams::Type] }
 
       # @!attribute include_external
       #   If `include_external=audio` is specified it signals that the client can play
@@ -40,8 +40,8 @@ module Spotted
       #   response. By default externally hosted audio content is marked as unplayable in
       #   the response.
       #
-      #   @return [Symbol, Spotted::Models::SearchSearchParams::IncludeExternal, nil]
-      optional :include_external, enum: -> { Spotted::SearchSearchParams::IncludeExternal }
+      #   @return [Symbol, Spotted::Models::SearchQueryParams::IncludeExternal, nil]
+      optional :include_external, enum: -> { Spotted::SearchQueryParams::IncludeExternal }
 
       # @!attribute limit
       #   The maximum number of results to return in each item type.
@@ -72,13 +72,13 @@ module Spotted
 
       # @!method initialize(q:, type:, include_external: nil, limit: nil, market: nil, offset: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
-      #   {Spotted::Models::SearchSearchParams} for more details.
+      #   {Spotted::Models::SearchQueryParams} for more details.
       #
       #   @param q [String] Your search query.
       #
-      #   @param type [Array<Symbol, Spotted::Models::SearchSearchParams::Type>] A comma-separated list of item types to search across. Search results include hi
+      #   @param type [Array<Symbol, Spotted::Models::SearchQueryParams::Type>] A comma-separated list of item types to search across. Search results include hi
       #
-      #   @param include_external [Symbol, Spotted::Models::SearchSearchParams::IncludeExternal] If `include_external=audio` is specified it signals that the client can play ext
+      #   @param include_external [Symbol, Spotted::Models::SearchQueryParams::IncludeExternal] If `include_external=audio` is specified it signals that the client can play ext
       #
       #   @param limit [Integer] The maximum number of results to return in each item type.
       #