spotted 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53171d2924e8b65667348df43a8315b13834283411bcc57260a3dee25ed1b5bb
-  data.tar.gz: 4a987cf805446e513e6d977a00aa999f48d64ca881e7adc6f7a3ae9352169348
+  metadata.gz: 696d1201dbd3bfb90b486db93bc6b1b671ed6a977f4aac62a1c7f01049ceb63a
+  data.tar.gz: 14b673555eb41b979bc507f86e417d311fe5b31953fb875146e96b992ae05fb6
 SHA512:
-  metadata.gz: 13b3fab4d5ead1e934399769d8556ba0521e2bebcbe5a0da61fc4cefba97ebd92801afc3d4136bc70f7efea09b7a3ac0689e41e8633968d4f983d11a7f4bc1b2
-  data.tar.gz: 0ce09546710593e818c08530438f4ab6918fd9e103ad54d3376af6362da5bb197298bdec2a931cc6868259aa49eacd08a827108d4375a5075922a1295594667e
+  metadata.gz: ed1cb5ae938ded271bafef35692200963c900a77ce410e4c8c71611a6d45be523f319be8eba55bd926a41fcda4f933786f4adcf768efff0701895e7f26aa4cc0
+  data.tar.gz: f36d877b11ca3b92f0c4ed6658886c242c72a772e7ae23ad242be69e95fa8b5af0e350269b4bf69378dd53630b8f8ed512248b0722d5cb01b2fc07faf028ab96

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.12.0 (2025-11-18)
+
+Full Changelog: [v0.11.0...v0.12.0](https://github.com/cjavdev/spotted/compare/v0.11.0...v0.12.0)
+
+### Features
+
+* **api:** manual updates ([2d46753](https://github.com/cjavdev/spotted/commit/2d467536b14036b59bd83f1ad36a793f283c0ba7))
+* **api:** manual updates ([d50ef2c](https://github.com/cjavdev/spotted/commit/d50ef2cfac3d7ad78c0cdddb6b63e265eee41ce5))
+* **api:** manual updates ([88e978f](https://github.com/cjavdev/spotted/commit/88e978fe47e83e5c3ec1b6e11f61c3e7b0da364a))
+* **api:** manual updates ([1282962](https://github.com/cjavdev/spotted/commit/1282962d4ed287f19e6f85542cd8f1ab2d3dd262))
+* **api:** manual updates ([d5a6316](https://github.com/cjavdev/spotted/commit/d5a6316595fc63e413751042e043d32f02f727e9))
+* **api:** manual updates ([c7e3fcc](https://github.com/cjavdev/spotted/commit/c7e3fcc445d8a027ac3afceeba51b59c6f6882af))
+
 ## 0.11.0 (2025-11-10)
 
 Full Changelog: [v0.10.0...v0.11.0](https://github.com/cjavdev/spotted/compare/v0.10.0...v0.11.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.11.0"
+gem "spotted", "~> 0.12.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/spotted/client.rb

@@ -76,7 +76,15 @@ module Spotted
     #
     # @return [Hash{String=>String}]
     private def auth_headers
-      {**bearer_auth, **oauth_2_0}
+      unless @access_token.nil?
+        return {**bearer_auth}
+      end
+
+      if @client_id && @client_secret
+        return {**oauth_2_0}
+      end
+
+      {}
     end
 
     # @api private
@@ -212,5 +220,56 @@ module Spotted
       query_string = URI.encode_www_form(params)
       "https://accounts.spotify.com/authorize?#{query_string}"
     end
+
+    # Exchanges an authorization code for an access token.
+    #
+    # @param code [String] The authorization code to exchange
+    # @param redirect_uri [String] The redirect URI used to obtain the authorization code
+    #
+    # @return [Object] The access token and refresh token
+    def exchange_authorization_code(code:, redirect_uri:)
+      if @client_id.nil? || @client_secret.nil?
+        raise ArgumentError, "Both client_id and client_secret must be set to exchange an authorization code."
+      end
+      body = URI.encode_www_form(
+        grant_type: "authorization_code",
+        code: code,
+        redirect_uri: redirect_uri
+      )
+      client = Spotted::Client.new(
+        client_id: @client_id,
+        client_secret: @client_secret,
+        base_url: "https://accounts.spotify.com"
+      )
+      client.request(
+        method: :post,
+        headers: {
+          "Content-Type" => "application/x-www-form-urlencoded",
+          "Authorization" => "Basic #{Base64.strict_encode64("#{@client_id}:#{@client_secret}")}"
+        },
+        path: "/api/token",
+        body: body
+      )
+    end
+
+    def refresh_access_token(refresh_token:)
+      if @client_id.nil? || @client_secret.nil?
+        raise ArgumentError, "Both client_id and client_secret must be set to refresh an access token."
+      end
+      body = URI.encode_www_form(
+        grant_type: "refresh_token",
+        refresh_token: refresh_token
+      )
+      client = Spotted::Client.new(client_id: @client_id, client_secret: @client_secret, base_url: "https://accounts.spotify.com")
+      client.request(
+        method: :post,
+        headers: {
+          "Content-Type" => "application/x-www-form-urlencoded",
+          "Authorization" => "Basic #{Base64.strict_encode64("#{@client_id}:#{@client_secret}")}"
+        },
+        path: "/api/token",
+        body: body
+      )
+    end
   end
 end

data/lib/spotted/models/album_bulk_retrieve_response.rb

@@ -83,8 +83,8 @@ module Spotted
         # @!attribute type
         #   The object type.
         #
-        #   @return [Symbol, Spotted::Models::AlbumBulkRetrieveResponse::Album::Type]
-        required :type, enum: -> { Spotted::Models::AlbumBulkRetrieveResponse::Album::Type }
+        #   @return [Symbol, :album]
+        required :type, const: :album
 
         # @!attribute uri
         #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
@@ -145,7 +145,7 @@ module Spotted
         #   @return [Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks, nil]
         optional :tracks, -> { Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks }
 
-        # @!method initialize(id:, album_type:, available_markets:, external_urls:, href:, images:, name:, release_date:, release_date_precision:, total_tracks:, type:, uri:, artists: nil, copyrights: nil, external_ids: nil, genres: nil, label: nil, popularity: nil, restrictions: nil, tracks: nil)
+        # @!method initialize(id:, album_type:, available_markets:, external_urls:, href:, images:, name:, release_date:, release_date_precision:, total_tracks:, uri:, artists: nil, copyrights: nil, external_ids: nil, genres: nil, label: nil, popularity: nil, restrictions: nil, tracks: nil, type: :album)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::AlbumBulkRetrieveResponse::Album} for more details.
         #
@@ -169,8 +169,6 @@ module Spotted
         #
         #   @param total_tracks [Integer] The number of tracks in the album.
         #
-        #   @param type [Symbol, Spotted::Models::AlbumBulkRetrieveResponse::Album::Type] The object type.
-        #
         #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the albu
         #
         #   @param artists [Array<Spotted::Models::SimplifiedArtistObject>] The artists of the album. Each artist object includes a link in `href` to more d
@@ -188,6 +186,8 @@ module Spotted
         #   @param restrictions [Spotted::Models::AlbumRestrictionObject] Included in the response when a content restriction is applied.
         #
         #   @param tracks [Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks] The tracks of the album.
+        #
+        #   @param type [Symbol, :album] The object type.
 
         # The type of the album.
         #
@@ -217,18 +217,6 @@ module Spotted
           #   @return [Array<Symbol>]
         end
 
-        # The object type.
-        #
-        # @see Spotted::Models::AlbumBulkRetrieveResponse::Album#type
-        module Type
-          extend Spotted::Internal::Type::Enum
-
-          ALBUM = :album
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-
         # @see Spotted::Models::AlbumBulkRetrieveResponse::Album#tracks
         class Tracks < Spotted::Internal::Type::BaseModel
           # @!attribute href
@@ -237,11 +225,6 @@ module Spotted
           #   @return [String]
           required :href, String
 
-          # @!attribute items
-          #
-          #   @return [Array<Spotted::Models::SimplifiedTrackObject>]
-          required :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedTrackObject] }
-
           # @!attribute limit
           #   The maximum number of items in the response (as set in the query or by default).
           #
@@ -272,7 +255,12 @@ module Spotted
           #   @return [Integer]
           required :total, Integer
 
-          # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+          # @!attribute items
+          #
+          #   @return [Array<Spotted::Models::SimplifiedTrackObject>, nil]
+          optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedTrackObject] }
+
+          # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
           #   Some parameter documentations has been truncated, see
           #   {Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks} for more details.
           #
@@ -280,8 +268,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::SimplifiedTrackObject>]
-          #
           #   @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)
@@ -291,6 +277,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::SimplifiedTrackObject>]
         end
       end
     end

data/lib/spotted/models/album_retrieve_response.rb

@@ -73,8 +73,8 @@ module Spotted
       # @!attribute type
       #   The object type.
       #
-      #   @return [Symbol, Spotted::Models::AlbumRetrieveResponse::Type]
-      required :type, enum: -> { Spotted::Models::AlbumRetrieveResponse::Type }
+      #   @return [Symbol, :album]
+      required :type, const: :album
 
       # @!attribute uri
       #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
@@ -135,7 +135,7 @@ module Spotted
       #   @return [Spotted::Models::AlbumRetrieveResponse::Tracks, nil]
       optional :tracks, -> { Spotted::Models::AlbumRetrieveResponse::Tracks }
 
-      # @!method initialize(id:, album_type:, available_markets:, external_urls:, href:, images:, name:, release_date:, release_date_precision:, total_tracks:, type:, uri:, artists: nil, copyrights: nil, external_ids: nil, genres: nil, label: nil, popularity: nil, restrictions: nil, tracks: nil)
+      # @!method initialize(id:, album_type:, available_markets:, external_urls:, href:, images:, name:, release_date:, release_date_precision:, total_tracks:, uri:, artists: nil, copyrights: nil, external_ids: nil, genres: nil, label: nil, popularity: nil, restrictions: nil, tracks: nil, type: :album)
       #   Some parameter documentations has been truncated, see
       #   {Spotted::Models::AlbumRetrieveResponse} for more details.
       #
@@ -159,8 +159,6 @@ module Spotted
       #
       #   @param total_tracks [Integer] The number of tracks in the album.
       #
-      #   @param type [Symbol, Spotted::Models::AlbumRetrieveResponse::Type] The object type.
-      #
       #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the albu
       #
       #   @param artists [Array<Spotted::Models::SimplifiedArtistObject>] The artists of the album. Each artist object includes a link in `href` to more d
@@ -178,6 +176,8 @@ module Spotted
       #   @param restrictions [Spotted::Models::AlbumRestrictionObject] Included in the response when a content restriction is applied.
       #
       #   @param tracks [Spotted::Models::AlbumRetrieveResponse::Tracks] The tracks of the album.
+      #
+      #   @param type [Symbol, :album] The object type.
 
       # The type of the album.
       #
@@ -207,18 +207,6 @@ module Spotted
         #   @return [Array<Symbol>]
       end
 
-      # The object type.
-      #
-      # @see Spotted::Models::AlbumRetrieveResponse#type
-      module Type
-        extend Spotted::Internal::Type::Enum
-
-        ALBUM = :album
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
-
       # @see Spotted::Models::AlbumRetrieveResponse#tracks
       class Tracks < Spotted::Internal::Type::BaseModel
         # @!attribute href
@@ -227,11 +215,6 @@ module Spotted
         #   @return [String]
         required :href, String
 
-        # @!attribute items
-        #
-        #   @return [Array<Spotted::Models::SimplifiedTrackObject>]
-        required :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedTrackObject] }
-
         # @!attribute limit
         #   The maximum number of items in the response (as set in the query or by default).
         #
@@ -262,7 +245,12 @@ module Spotted
         #   @return [Integer]
         required :total, Integer
 
-        # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+        # @!attribute items
+        #
+        #   @return [Array<Spotted::Models::SimplifiedTrackObject>, nil]
+        optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedTrackObject] }
+
+        # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::AlbumRetrieveResponse::Tracks} for more details.
         #
@@ -270,8 +258,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::SimplifiedTrackObject>]
-        #
         #   @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)
@@ -281,6 +267,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::SimplifiedTrackObject>]
       end
     end
   end

data/lib/spotted/models/artist_list_albums_response.rb

@@ -86,8 +86,8 @@ module Spotted
       # @!attribute type
       #   The object type.
       #
-      #   @return [Symbol, Spotted::Models::ArtistListAlbumsResponse::Type]
-      required :type, enum: -> { Spotted::Models::ArtistListAlbumsResponse::Type }
+      #   @return [Symbol, :album]
+      required :type, const: :album
 
       # @!attribute uri
       #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
@@ -102,7 +102,7 @@ module Spotted
       #   @return [Spotted::Models::AlbumRestrictionObject, nil]
       optional :restrictions, -> { Spotted::AlbumRestrictionObject }
 
-      # @!method initialize(id:, album_group:, 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_group:, 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::ArtistListAlbumsResponse} for more details.
       #
@@ -130,11 +130,11 @@ module Spotted
       #
       #   @param total_tracks [Integer] The number of tracks in the album.
       #
-      #   @param type [Symbol, Spotted::Models::ArtistListAlbumsResponse::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.
 
       # This field describes the relationship between the artist and the album.
       #
@@ -178,18 +178,6 @@ module Spotted
         # @!method self.values
         #   @return [Array<Symbol>]
       end
-
-      # The object type.
-      #
-      # @see Spotted::Models::ArtistListAlbumsResponse#type
-      module Type
-        extend Spotted::Internal::Type::Enum
-
-        ALBUM = :album
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/spotted/models/audio_analysis_retrieve_response.rb

@@ -262,14 +262,9 @@ module Spotted
         module Mode
           extend Spotted::Internal::Type::Enum
 
-          # No result
-          MINUS_1 = -1
-
-          # Minor
-          MODE_0 = 0
-
-          # Major
-          MODE_1 = 1
+          MODE_NO_RESULT = -1
+          MODE_MINOR = 0
+          MODE_MAJOR = 1
 
           # @!method self.values
           #   @return [Array<Float>]

data/lib/spotted/models/audiobook_base.rb

@@ -108,8 +108,8 @@ module Spotted
       # @!attribute type
       #   The object type.
       #
-      #   @return [Symbol, Spotted::Models::AudiobookBase::Type]
-      required :type, enum: -> { Spotted::AudiobookBase::Type }
+      #   @return [Symbol, :audiobook]
+      required :type, const: :audiobook
 
       # @!attribute uri
       #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
@@ -124,7 +124,7 @@ module Spotted
       #   @return [String, nil]
       optional :edition, String
 
-      # @!method initialize(id:, authors:, available_markets:, copyrights:, description:, explicit:, external_urls:, href:, html_description:, images:, languages:, media_type:, name:, narrators:, publisher:, total_chapters:, type:, uri:, edition: nil)
+      # @!method initialize(id:, authors:, available_markets:, copyrights:, description:, explicit:, external_urls:, href:, html_description:, images:, languages:, media_type:, name:, narrators:, publisher:, total_chapters:, uri:, edition: nil, type: :audiobook)
       #   Some parameter documentations has been truncated, see
       #   {Spotted::Models::AudiobookBase} for more details.
       #
@@ -160,23 +160,11 @@ module Spotted
       #
       #   @param total_chapters [Integer] The number of chapters in this audiobook.
       #
-      #   @param type [Symbol, Spotted::Models::AudiobookBase::Type] The object type.
-      #
       #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the audi
       #
       #   @param edition [String] The edition of the audiobook.
-
-      # The object type.
       #
-      # @see Spotted::Models::AudiobookBase#type
-      module Type
-        extend Spotted::Internal::Type::Enum
-
-        AUDIOBOOK = :audiobook
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
+      #   @param type [Symbol, :audiobook] The object type.
     end
   end
 end

data/lib/spotted/models/audiobook_bulk_retrieve_response.rb

@@ -33,11 +33,6 @@ module Spotted
           #   @return [String]
           required :href, String
 
-          # @!attribute items
-          #
-          #   @return [Array<Spotted::Models::SimplifiedChapterObject>]
-          required :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedChapterObject] }
-
           # @!attribute limit
           #   The maximum number of items in the response (as set in the query or by default).
           #
@@ -68,7 +63,12 @@ module Spotted
           #   @return [Integer]
           required :total, Integer
 
-          # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+          # @!attribute items
+          #
+          #   @return [Array<Spotted::Models::SimplifiedChapterObject>, nil]
+          optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedChapterObject] }
+
+          # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
           #   Some parameter documentations has been truncated, see
           #   {Spotted::Models::AudiobookBulkRetrieveResponse::Audiobook::Chapters} for more
           #   details.
@@ -77,8 +77,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::SimplifiedChapterObject>]
-          #
           #   @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)
@@ -88,6 +86,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::SimplifiedChapterObject>]
         end
       end
     end

data/lib/spotted/models/audiobook_retrieve_response.rb

@@ -23,11 +23,6 @@ module Spotted
         #   @return [String]
         required :href, String
 
-        # @!attribute items
-        #
-        #   @return [Array<Spotted::Models::SimplifiedChapterObject>]
-        required :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedChapterObject] }
-
         # @!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::SimplifiedChapterObject>, nil]
+        optional :items, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedChapterObject] }
+
+        # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::AudiobookRetrieveResponse::Chapters} 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::SimplifiedChapterObject>]
-        #
         #   @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::SimplifiedChapterObject>]
       end
     end
   end

data/lib/spotted/models/browse/category_list_response.rb

@@ -21,12 +21,6 @@ module Spotted
           #   @return [String]
           required :href, String
 
-          # @!attribute items
-          #
-          #   @return [Array<Spotted::Models::Browse::CategoryListResponse::Categories::Item>]
-          required :items,
-                   -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::Browse::CategoryListResponse::Categories::Item] }
-
           # @!attribute limit
           #   The maximum number of items in the response (as set in the query or by default).
           #
@@ -57,14 +51,18 @@ module Spotted
           #   @return [Integer]
           required :total, Integer
 
-          # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+          # @!attribute items
+          #
+          #   @return [Array<Spotted::Models::Browse::CategoryListResponse::Categories::Item>, nil]
+          optional :items,
+                   -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::Browse::CategoryListResponse::Categories::Item] }
+
+          # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
           #   Some parameter documentations has been truncated, see
           #   {Spotted::Models::Browse::CategoryListResponse::Categories} 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::Browse::CategoryListResponse::Categories::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)
@@ -74,6 +72,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::Browse::CategoryListResponse::Categories::Item>]
 
           class Item < Spotted::Internal::Type::BaseModel
             # @!attribute id

data/lib/spotted/models/browse_get_new_releases_response.rb

@@ -20,12 +20,6 @@ module Spotted
         #   @return [String]
         required :href, String
 
-        # @!attribute items
-        #
-        #   @return [Array<Spotted::Models::BrowseGetNewReleasesResponse::Albums::Item>]
-        required :items,
-                 -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::BrowseGetNewReleasesResponse::Albums::Item] }
-
         # @!attribute limit
         #   The maximum number of items in the response (as set in the query or by default).
         #
@@ -56,14 +50,18 @@ module Spotted
         #   @return [Integer]
         required :total, Integer
 
-        # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+        # @!attribute items
+        #
+        #   @return [Array<Spotted::Models::BrowseGetNewReleasesResponse::Albums::Item>, nil]
+        optional :items,
+                 -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::BrowseGetNewReleasesResponse::Albums::Item] }
+
+        # @!method initialize(href:, limit:, next_:, offset:, previous:, total:, items: nil)
         #   Some parameter documentations has been truncated, see
         #   {Spotted::Models::BrowseGetNewReleasesResponse::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::BrowseGetNewReleasesResponse::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)
@@ -73,6 +71,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::BrowseGetNewReleasesResponse::Albums::Item>]
 
         class Item < Spotted::Internal::Type::BaseModel
           # @!attribute id
@@ -151,8 +151,8 @@ module Spotted
           # @!attribute type
           #   The object type.
           #
-          #   @return [Symbol, Spotted::Models::BrowseGetNewReleasesResponse::Albums::Item::Type]
-          required :type, enum: -> { Spotted::Models::BrowseGetNewReleasesResponse::Albums::Item::Type }
+          #   @return [Symbol, :album]
+          required :type, const: :album
 
           # @!attribute uri
           #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
@@ -167,7 +167,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::BrowseGetNewReleasesResponse::Albums::Item} for more details.
           #
@@ -193,11 +193,11 @@ module Spotted
           #
           #   @param total_tracks [Integer] The number of tracks in the album.
           #
-          #   @param type [Symbol, Spotted::Models::BrowseGetNewReleasesResponse::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.
           #
@@ -226,18 +226,6 @@ module Spotted
             # @!method self.values
             #   @return [Array<Symbol>]
           end
-
-          # The object type.
-          #
-          # @see Spotted::Models::BrowseGetNewReleasesResponse::Albums::Item#type
-          module Type
-            extend Spotted::Internal::Type::Enum
-
-            ALBUM = :album
-
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
         end
       end
     end