spotted 0.11.0 → 0.12.0

data/lib/spotted/models/search_query_response.rb

@@ -56,12 +56,6 @@ module Spotted
         #   @return [String]
         required :href, String
 
-        # @!attribute items
-        #
-        #   @return [Array<Spotted::Models::SearchQueryResponse::Albums::Item>]
-        required :items,
-                 -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::SearchQueryResponse::Albums::Item] }
-
         # @!attribute limit
         #   The maximum number of items in the response (as set in the query or by default).
         #
@@ -92,14 +86,18 @@ module Spotted
         #   @return [Integer]
         required :total, Integer
 
-        # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+        # @!attribute items
+        #
+        #   @return [Array<Spotted::Models::SearchQueryResponse::Albums::Item>, nil]
+        optional :items,
+                 -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::SearchQueryResponse::Albums::Item] }
+
+        # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::SearchQueryResponse::Albums} for more details.
         #
         #   @param href [String] A link to the Web API endpoint returning the full result of the request
         #
-        #   @param items [Array<Spotted::Models::SearchQueryResponse::Albums::Item>]
-        #
         #   @param limit [Integer] The maximum number of items in the response (as set in the query or by default).
         #
         #   @param next_ [String, nil] URL to the next page of items. ( `null` if none)
@@ -109,6 +107,8 @@ module Spotted
         #   @param previous [String, nil] URL to the previous page of items. ( `null` if none)
         #
         #   @param total [Integer] The total number of items available to return.
+        #
+        #   @param items [Array<Spotted::Models::SearchQueryResponse::Albums::Item>]
 
         class Item < Spotted::Internal::Type::BaseModel
           # @!attribute id
@@ -187,8 +187,8 @@ module Spotted
           # @!attribute type
           #   The object type.
           #
-          #   @return [Symbol, Spotted::Models::SearchQueryResponse::Albums::Item::Type]
-          required :type, enum: -> { Spotted::Models::SearchQueryResponse::Albums::Item::Type }
+          #   @return [Symbol, :album]
+          required :type, const: :album
 
           # @!attribute uri
           #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
@@ -203,7 +203,7 @@ module Spotted
           #   @return [Spotted::Models::AlbumRestrictionObject, nil]
           optional :restrictions, -> { Spotted::AlbumRestrictionObject }
 
-          # @!method initialize(id:, album_type:, artists:, available_markets:, external_urls:, href:, images:, name:, release_date:, release_date_precision:, total_tracks:, type:, uri:, restrictions: nil)
+          # @!method initialize(id:, album_type:, artists:, available_markets:, external_urls:, href:, images:, name:, release_date:, release_date_precision:, total_tracks:, uri:, restrictions: nil, type: :album)
           #   Some parameter documentations has been truncated, see
           #   {Spotted::Models::SearchQueryResponse::Albums::Item} for more details.
           #
@@ -229,11 +229,11 @@ module Spotted
           #
           #   @param total_tracks [Integer] The number of tracks in the album.
           #
-          #   @param type [Symbol, Spotted::Models::SearchQueryResponse::Albums::Item::Type] The object type.
-          #
           #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the albu
           #
           #   @param restrictions [Spotted::Models::AlbumRestrictionObject] Included in the response when a content restriction is applied.
+          #
+          #   @param type [Symbol, :album] The object type.
 
           # The type of the album.
           #
@@ -262,18 +262,6 @@ module Spotted
             # @!method self.values
             #   @return [Array<Symbol>]
           end
-
-          # The object type.
-          #
-          # @see Spotted::Models::SearchQueryResponse::Albums::Item#type
-          module Type
-            extend Spotted::Internal::Type::Enum
-
-            ALBUM = :album
-
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
         end
       end
 
@@ -285,11 +273,6 @@ module Spotted
         #   @return [String]
         required :href, String
 
-        # @!attribute items
-        #
-        #   @return [Array<Spotted::Models::ArtistObject>]
-        required :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::ArtistObject] }
-
         # @!attribute limit
         #   The maximum number of items in the response (as set in the query or by default).
         #
@@ -320,14 +303,17 @@ module Spotted
         #   @return [Integer]
         required :total, Integer
 
-        # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+        # @!attribute items
+        #
+        #   @return [Array<Spotted::Models::ArtistObject>, nil]
+        optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::ArtistObject] }
+
+        # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::SearchQueryResponse::Artists} for more details.
         #
         #   @param href [String] A link to the Web API endpoint returning the full result of the request
         #
-        #   @param items [Array<Spotted::Models::ArtistObject>]
-        #
         #   @param limit [Integer] The maximum number of items in the response (as set in the query or by default).
         #
         #   @param next_ [String, nil] URL to the next page of items. ( `null` if none)
@@ -337,6 +323,8 @@ module Spotted
         #   @param previous [String, nil] URL to the previous page of items. ( `null` if none)
         #
         #   @param total [Integer] The total number of items available to return.
+        #
+        #   @param items [Array<Spotted::Models::ArtistObject>]
       end
 
       # @see Spotted::Models::SearchQueryResponse#audiobooks
@@ -347,11 +335,6 @@ module Spotted
         #   @return [String]
         required :href, String
 
-        # @!attribute items
-        #
-        #   @return [Array<Spotted::Models::AudiobookBase>]
-        required :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::AudiobookBase] }
-
         # @!attribute limit
         #   The maximum number of items in the response (as set in the query or by default).
         #
@@ -382,14 +365,17 @@ module Spotted
         #   @return [Integer]
         required :total, Integer
 
-        # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+        # @!attribute items
+        #
+        #   @return [Array<Spotted::Models::AudiobookBase>, nil]
+        optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::AudiobookBase] }
+
+        # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::SearchQueryResponse::Audiobooks} for more details.
         #
         #   @param href [String] A link to the Web API endpoint returning the full result of the request
         #
-        #   @param items [Array<Spotted::Models::AudiobookBase>]
-        #
         #   @param limit [Integer] The maximum number of items in the response (as set in the query or by default).
         #
         #   @param next_ [String, nil] URL to the next page of items. ( `null` if none)
@@ -399,6 +385,8 @@ module Spotted
         #   @param previous [String, nil] URL to the previous page of items. ( `null` if none)
         #
         #   @param total [Integer] The total number of items available to return.
+        #
+        #   @param items [Array<Spotted::Models::AudiobookBase>]
       end
 
       # @see Spotted::Models::SearchQueryResponse#episodes
@@ -409,11 +397,6 @@ module Spotted
         #   @return [String]
         required :href, String
 
-        # @!attribute items
-        #
-        #   @return [Array<Spotted::Models::SimplifiedEpisodeObject>]
-        required :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedEpisodeObject] }
-
         # @!attribute limit
         #   The maximum number of items in the response (as set in the query or by default).
         #
@@ -444,14 +427,17 @@ module Spotted
         #   @return [Integer]
         required :total, Integer
 
-        # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+        # @!attribute items
+        #
+        #   @return [Array<Spotted::Models::SimplifiedEpisodeObject>, nil]
+        optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedEpisodeObject] }
+
+        # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::SearchQueryResponse::Episodes} for more details.
         #
         #   @param href [String] A link to the Web API endpoint returning the full result of the request
         #
-        #   @param items [Array<Spotted::Models::SimplifiedEpisodeObject>]
-        #
         #   @param limit [Integer] The maximum number of items in the response (as set in the query or by default).
         #
         #   @param next_ [String, nil] URL to the next page of items. ( `null` if none)
@@ -461,6 +447,8 @@ module Spotted
         #   @param previous [String, nil] URL to the previous page of items. ( `null` if none)
         #
         #   @param total [Integer] The total number of items available to return.
+        #
+        #   @param items [Array<Spotted::Models::SimplifiedEpisodeObject>]
       end
 
       # @see Spotted::Models::SearchQueryResponse#shows
@@ -471,11 +459,6 @@ module Spotted
         #   @return [String]
         required :href, String
 
-        # @!attribute items
-        #
-        #   @return [Array<Spotted::Models::ShowBase>]
-        required :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::ShowBase] }
-
         # @!attribute limit
         #   The maximum number of items in the response (as set in the query or by default).
         #
@@ -506,14 +489,17 @@ module Spotted
         #   @return [Integer]
         required :total, Integer
 
-        # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+        # @!attribute items
+        #
+        #   @return [Array<Spotted::Models::ShowBase>, nil]
+        optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::ShowBase] }
+
+        # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::SearchQueryResponse::Shows} for more details.
         #
         #   @param href [String] A link to the Web API endpoint returning the full result of the request
         #
-        #   @param items [Array<Spotted::Models::ShowBase>]
-        #
         #   @param limit [Integer] The maximum number of items in the response (as set in the query or by default).
         #
         #   @param next_ [String, nil] URL to the next page of items. ( `null` if none)
@@ -523,6 +509,8 @@ module Spotted
         #   @param previous [String, nil] URL to the previous page of items. ( `null` if none)
         #
         #   @param total [Integer] The total number of items available to return.
+        #
+        #   @param items [Array<Spotted::Models::ShowBase>]
       end
 
       # @see Spotted::Models::SearchQueryResponse#tracks
@@ -533,11 +521,6 @@ module Spotted
         #   @return [String]
         required :href, String
 
-        # @!attribute items
-        #
-        #   @return [Array<Spotted::Models::TrackObject>]
-        required :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::TrackObject] }
-
         # @!attribute limit
         #   The maximum number of items in the response (as set in the query or by default).
         #
@@ -568,14 +551,17 @@ module Spotted
         #   @return [Integer]
         required :total, Integer
 
-        # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+        # @!attribute items
+        #
+        #   @return [Array<Spotted::Models::TrackObject>, nil]
+        optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::TrackObject] }
+
+        # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::SearchQueryResponse::Tracks} for more details.
         #
         #   @param href [String] A link to the Web API endpoint returning the full result of the request
         #
-        #   @param items [Array<Spotted::Models::TrackObject>]
-        #
         #   @param limit [Integer] The maximum number of items in the response (as set in the query or by default).
         #
         #   @param next_ [String, nil] URL to the next page of items. ( `null` if none)
@@ -585,6 +571,8 @@ module Spotted
         #   @param previous [String, nil] URL to the previous page of items. ( `null` if none)
         #
         #   @param total [Integer] The total number of items available to return.
+        #
+        #   @param items [Array<Spotted::Models::TrackObject>]
       end
     end
   end

data/lib/spotted/models/show_base.rb

@@ -101,8 +101,8 @@ module Spotted
       # @!attribute type
       #   The object type.
       #
-      #   @return [Symbol, Spotted::Models::ShowBase::Type]
-      required :type, enum: -> { Spotted::ShowBase::Type }
+      #   @return [Symbol, :show]
+      required :type, const: :show
 
       # @!attribute uri
       #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
@@ -111,7 +111,7 @@ module Spotted
       #   @return [String]
       required :uri, String
 
-      # @!method initialize(id:, available_markets:, copyrights:, description:, explicit:, external_urls:, href:, html_description:, images:, is_externally_hosted:, languages:, media_type:, name:, publisher:, total_episodes:, type:, uri:)
+      # @!method initialize(id:, available_markets:, copyrights:, description:, explicit:, external_urls:, href:, html_description:, images:, is_externally_hosted:, languages:, media_type:, name:, publisher:, total_episodes:, uri:, type: :show)
       #   Some parameter documentations has been truncated, see
       #   {Spotted::Models::ShowBase} for more details.
       #
@@ -145,21 +145,9 @@ module Spotted
       #
       #   @param total_episodes [Integer] The total number of episodes in the show.
       #
-      #   @param type [Symbol, Spotted::Models::ShowBase::Type] The object type.
-      #
       #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the show
-
-      # The object type.
       #
-      # @see Spotted::Models::ShowBase#type
-      module Type
-        extend Spotted::Internal::Type::Enum
-
-        SHOW = :show
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
+      #   @param type [Symbol, :show] The object type.
     end
   end
 end

data/lib/spotted/models/show_retrieve_response.rb

@@ -23,11 +23,6 @@ module Spotted
         #   @return [String]
         required :href, String
 
-        # @!attribute items
-        #
-        #   @return [Array<Spotted::Models::SimplifiedEpisodeObject>]
-        required :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedEpisodeObject] }
-
         # @!attribute limit
         #   The maximum number of items in the response (as set in the query or by default).
         #
@@ -58,7 +53,12 @@ module Spotted
         #   @return [Integer]
         required :total, Integer
 
-        # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+        # @!attribute items
+        #
+        #   @return [Array<Spotted::Models::SimplifiedEpisodeObject>, nil]
+        optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedEpisodeObject] }
+
+        # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::ShowRetrieveResponse::Episodes} for more details.
         #
@@ -66,8 +66,6 @@ module Spotted
         #
         #   @param href [String] A link to the Web API endpoint returning the full result of the request
         #
-        #   @param items [Array<Spotted::Models::SimplifiedEpisodeObject>]
-        #
         #   @param limit [Integer] The maximum number of items in the response (as set in the query or by default).
         #
         #   @param next_ [String, nil] URL to the next page of items. ( `null` if none)
@@ -77,6 +75,8 @@ module Spotted
         #   @param previous [String, nil] URL to the previous page of items. ( `null` if none)
         #
         #   @param total [Integer] The total number of items available to return.
+        #
+        #   @param items [Array<Spotted::Models::SimplifiedEpisodeObject>]
       end
     end
   end

data/lib/spotted/models/simplified_chapter_object.rb

@@ -105,8 +105,8 @@ module Spotted
       # @!attribute type
       #   The object type.
       #
-      #   @return [Symbol, Spotted::Models::SimplifiedChapterObject::Type]
-      required :type, enum: -> { Spotted::SimplifiedChapterObject::Type }
+      #   @return [Symbol, :episode]
+      required :type, const: :episode
 
       # @!attribute uri
       #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
@@ -135,7 +135,7 @@ module Spotted
       #   @return [Spotted::Models::ResumePointObject, nil]
       optional :resume_point, -> { Spotted::ResumePointObject }
 
-      # @!method initialize(id:, audio_preview_url:, 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)
+      # @!method initialize(id:, audio_preview_url:, chapter_number:, description:, duration_ms:, explicit:, external_urls:, href:, html_description:, images:, is_playable:, languages:, name:, release_date:, release_date_precision:, uri:, available_markets: nil, restrictions: nil, resume_point: nil, type: :episode)
       #   Some parameter documentations has been truncated, see
       #   {Spotted::Models::SimplifiedChapterObject} for more details.
       #
@@ -169,8 +169,6 @@ module Spotted
       #
       #   @param release_date_precision [Symbol, Spotted::Models::SimplifiedChapterObject::ReleaseDatePrecision] The precision with which `release_date` value is known.
       #
-      #   @param type [Symbol, Spotted::Models::SimplifiedChapterObject::Type] The object type.
-      #
       #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the chap
       #
       #   @param available_markets [Array<String>] A list of the countries in which the chapter can be played, identified by their
@@ -178,6 +176,8 @@ module Spotted
       #   @param restrictions [Spotted::Models::ChapterRestrictionObject] Included in the response when a content restriction is applied.
       #
       #   @param resume_point [Spotted::Models::ResumePointObject] The user's most recent position in the chapter. Set if the supplied access token
+      #
+      #   @param type [Symbol, :episode] The object type.
 
       # The precision with which `release_date` value is known.
       #
@@ -192,18 +192,6 @@ module Spotted
         # @!method self.values
         #   @return [Array<Symbol>]
       end
-
-      # The object type.
-      #
-      # @see Spotted::Models::SimplifiedChapterObject#type
-      module Type
-        extend Spotted::Internal::Type::Enum
-
-        EPISODE = :episode
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/spotted/models/simplified_episode_object.rb

@@ -104,8 +104,8 @@ module Spotted
       # @!attribute type
       #   The object type.
       #
-      #   @return [Symbol, Spotted::Models::SimplifiedEpisodeObject::Type]
-      required :type, enum: -> { Spotted::SimplifiedEpisodeObject::Type }
+      #   @return [Symbol, :episode]
+      required :type, const: :episode
 
       # @!attribute uri
       #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
@@ -137,7 +137,7 @@ module Spotted
       #   @return [Spotted::Models::ResumePointObject, nil]
       optional :resume_point, -> { Spotted::ResumePointObject }
 
-      # @!method initialize(id:, audio_preview_url:, description:, duration_ms:, explicit:, external_urls:, href:, html_description:, images:, is_externally_hosted:, is_playable:, languages:, name:, release_date:, release_date_precision:, type:, uri:, language: nil, restrictions: nil, resume_point: nil)
+      # @!method initialize(id:, audio_preview_url:, description:, duration_ms:, explicit:, external_urls:, href:, html_description:, images:, is_externally_hosted:, is_playable:, languages:, name:, release_date:, release_date_precision:, uri:, language: nil, restrictions: nil, resume_point: nil, type: :episode)
       #   Some parameter documentations has been truncated, see
       #   {Spotted::Models::SimplifiedEpisodeObject} for more details.
       #
@@ -171,8 +171,6 @@ module Spotted
       #
       #   @param release_date_precision [Symbol, Spotted::Models::SimplifiedEpisodeObject::ReleaseDatePrecision] The precision with which `release_date` value is known.
       #
-      #   @param type [Symbol, Spotted::Models::SimplifiedEpisodeObject::Type] The object type.
-      #
       #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the epis
       #
       #   @param language [String] The language used in the episode, identified by a [ISO 639](https://en.wikipedia
@@ -180,6 +178,8 @@ module Spotted
       #   @param restrictions [Spotted::Models::EpisodeRestrictionObject] Included in the response when a content restriction is applied.
       #
       #   @param resume_point [Spotted::Models::ResumePointObject] The user's most recent position in the episode. Set if the supplied access token
+      #
+      #   @param type [Symbol, :episode] The object type.
 
       # The precision with which `release_date` value is known.
       #
@@ -194,18 +194,6 @@ module Spotted
         # @!method self.values
         #   @return [Array<Symbol>]
       end
-
-      # The object type.
-      #
-      # @see Spotted::Models::SimplifiedEpisodeObject#type
-      module Type
-        extend Spotted::Internal::Type::Enum
-
-        EPISODE = :episode
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/spotted/models/track_object.rb

@@ -267,8 +267,8 @@ module Spotted
         # @!attribute type
         #   The object type.
         #
-        #   @return [Symbol, Spotted::Models::TrackObject::Album::Type]
-        required :type, enum: -> { Spotted::TrackObject::Album::Type }
+        #   @return [Symbol, :album]
+        required :type, const: :album
 
         # @!attribute uri
         #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
@@ -283,7 +283,7 @@ module Spotted
         #   @return [Spotted::Models::AlbumRestrictionObject, nil]
         optional :restrictions, -> { Spotted::AlbumRestrictionObject }
 
-        # @!method initialize(id:, album_type:, artists:, available_markets:, external_urls:, href:, images:, name:, release_date:, release_date_precision:, total_tracks:, type:, uri:, restrictions: nil)
+        # @!method initialize(id:, album_type:, artists:, available_markets:, external_urls:, href:, images:, name:, release_date:, release_date_precision:, total_tracks:, uri:, restrictions: nil, type: :album)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::TrackObject::Album} for more details.
         #
@@ -312,11 +312,11 @@ module Spotted
         #
         #   @param total_tracks [Integer] The number of tracks in the album.
         #
-        #   @param type [Symbol, Spotted::Models::TrackObject::Album::Type] The object type.
-        #
         #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the albu
         #
         #   @param restrictions [Spotted::Models::AlbumRestrictionObject] Included in the response when a content restriction is applied.
+        #
+        #   @param type [Symbol, :album] The object type.
 
         # The type of the album.
         #
@@ -345,18 +345,6 @@ module Spotted
           # @!method self.values
           #   @return [Array<Symbol>]
         end
-
-        # The object type.
-        #
-        # @see Spotted::Models::TrackObject::Album#type
-        module Type
-          extend Spotted::Internal::Type::Enum
-
-          ALBUM = :album
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
       end
 
       # The object type: "track".

data/lib/spotted/models/users/playlist_create_response.rb

@@ -158,11 +158,6 @@ module Spotted
           #   @return [String]
           required :href, String
 
-          # @!attribute items
-          #
-          #   @return [Array<Spotted::Models::PlaylistTrackObject>]
-          required :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::PlaylistTrackObject] }
-
           # @!attribute limit
           #   The maximum number of items in the response (as set in the query or by default).
           #
@@ -193,7 +188,12 @@ module Spotted
           #   @return [Integer]
           required :total, Integer
 
-          # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+          # @!attribute items
+          #
+          #   @return [Array<Spotted::Models::PlaylistTrackObject>, nil]
+          optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::PlaylistTrackObject] }
+
+          # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
           #   Some parameter documentations has been truncated, see
           #   {Spotted::Models::Users::PlaylistCreateResponse::Tracks} for more details.
           #
@@ -201,8 +201,6 @@ module Spotted
           #
           #   @param href [String] A link to the Web API endpoint returning the full result of the request
           #
-          #   @param items [Array<Spotted::Models::PlaylistTrackObject>]
-          #
           #   @param limit [Integer] The maximum number of items in the response (as set in the query or by default).
           #
           #   @param next_ [String, nil] URL to the next page of items. ( `null` if none)
@@ -212,6 +210,8 @@ module Spotted
           #   @param previous [String, nil] URL to the previous page of items. ( `null` if none)
           #
           #   @param total [Integer] The total number of items available to return.
+          #
+          #   @param items [Array<Spotted::Models::PlaylistTrackObject>]
         end
       end
     end

data/lib/spotted/resources/me/following.rb

@@ -9,14 +9,14 @@ module Spotted
         #
         # Get the current user's followed artists.
         #
-        # @overload bulk_retrieve(type:, after: nil, limit: nil, request_options: {})
-        #
-        # @param type [Symbol, Spotted::Models::Me::FollowingBulkRetrieveParams::Type] The ID type: currently only `artist` is supported.
+        # @overload bulk_retrieve(after: nil, limit: nil, type: :artist, request_options: {})
         #
         # @param after [String] The last artist ID retrieved from the previous request.
         #
         # @param limit [Integer] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
         #
+        # @param type [Symbol, :artist] The ID type: currently only `artist` is supported.
+        #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Spotted::Models::Me::FollowingBulkRetrieveResponse]

data/lib/spotted/resources/playlists/images.rb

@@ -17,7 +17,7 @@ module Spotted
         #
         # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [nil]
+        # @return [StringIO]
         #
         # @see Spotted::Models::Playlists::ImageUpdateParams
         def update(playlist_id, params)
@@ -25,9 +25,9 @@ module Spotted
           @client.request(
             method: :put,
             path: ["playlists/%1$s/images", playlist_id],
-            headers: {"content-type" => "image/jpeg"},
+            headers: {"content-type" => "image/jpeg", "accept" => "application/binary"},
             body: parsed[:body],
-            model: NilClass,
+            model: StringIO,
             options: options
           )
         end

data/lib/spotted/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Spotted
-  VERSION = "0.11.0"
+  VERSION = "0.12.0"
 end