spotted 0.1.0

data/lib/spotted/models/album_retrieve_response.rb

@@ -0,0 +1,287 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    # @see Spotted::Resources::Albums#retrieve
+    class AlbumRetrieveResponse < Spotted::Internal::Type::BaseModel
+      # @!attribute id
+      #   The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+      #   album.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute album_type
+      #   The type of the album.
+      #
+      #   @return [Symbol, Spotted::Models::AlbumRetrieveResponse::AlbumType]
+      required :album_type, enum: -> { Spotted::Models::AlbumRetrieveResponse::AlbumType }
+
+      # @!attribute available_markets
+      #   The markets in which the album is available:
+      #   [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
+      #   _**NOTE**: an album is considered available in a market when at least 1 of its
+      #   tracks is available in that market._
+      #
+      #   @return [Array<String>]
+      required :available_markets, Spotted::Internal::Type::ArrayOf[String]
+
+      # @!attribute external_urls
+      #   Known external URLs for this album.
+      #
+      #   @return [Spotted::Models::ExternalURLObject]
+      required :external_urls, -> { Spotted::ExternalURLObject }
+
+      # @!attribute href
+      #   A link to the Web API endpoint providing full details of the album.
+      #
+      #   @return [String]
+      required :href, String
+
+      # @!attribute images
+      #   The cover art for the album in various sizes, widest first.
+      #
+      #   @return [Array<Spotted::Models::ImageObject>]
+      required :images, -> { Spotted::Internal::Type::ArrayOf[Spotted::ImageObject] }
+
+      # @!attribute name
+      #   The name of the album. In case of an album takedown, the value may be an empty
+      #   string.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute release_date
+      #   The date the album was first released.
+      #
+      #   @return [String]
+      required :release_date, String
+
+      # @!attribute release_date_precision
+      #   The precision with which `release_date` value is known.
+      #
+      #   @return [Symbol, Spotted::Models::AlbumRetrieveResponse::ReleaseDatePrecision]
+      required :release_date_precision,
+               enum: -> { Spotted::Models::AlbumRetrieveResponse::ReleaseDatePrecision }
+
+      # @!attribute total_tracks
+      #   The number of tracks in the album.
+      #
+      #   @return [Integer]
+      required :total_tracks, Integer
+
+      # @!attribute type
+      #   The object type.
+      #
+      #   @return [Symbol, Spotted::Models::AlbumRetrieveResponse::Type]
+      required :type, enum: -> { Spotted::Models::AlbumRetrieveResponse::Type }
+
+      # @!attribute uri
+      #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+      #   album.
+      #
+      #   @return [String]
+      required :uri, String
+
+      # @!attribute artists
+      #   The artists of the album. Each artist object includes a link in `href` to more
+      #   detailed information about the artist.
+      #
+      #   @return [Array<Spotted::Models::SimplifiedArtistObject>, nil]
+      optional :artists, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedArtistObject] }
+
+      # @!attribute copyrights
+      #   The copyright statements of the album.
+      #
+      #   @return [Array<Spotted::Models::CopyrightObject>, nil]
+      optional :copyrights, -> { Spotted::Internal::Type::ArrayOf[Spotted::CopyrightObject] }
+
+      # @!attribute external_ids
+      #   Known external IDs for the album.
+      #
+      #   @return [Spotted::Models::ExternalIDObject, nil]
+      optional :external_ids, -> { Spotted::ExternalIDObject }
+
+      # @!attribute genres
+      #   @deprecated
+      #
+      #   **Deprecated** The array is always empty.
+      #
+      #   @return [Array<String>, nil]
+      optional :genres, Spotted::Internal::Type::ArrayOf[String]
+
+      # @!attribute label
+      #   The label associated with the album.
+      #
+      #   @return [String, nil]
+      optional :label, String
+
+      # @!attribute popularity
+      #   The popularity of the album. The value will be between 0 and 100, with 100 being
+      #   the most popular.
+      #
+      #   @return [Integer, nil]
+      optional :popularity, Integer
+
+      # @!attribute restrictions
+      #   Included in the response when a content restriction is applied.
+      #
+      #   @return [Spotted::Models::AlbumRestrictionObject, nil]
+      optional :restrictions, -> { Spotted::AlbumRestrictionObject }
+
+      # @!attribute tracks
+      #   The tracks of the album.
+      #
+      #   @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)
+      #   Some parameter documentations has been truncated, see
+      #   {Spotted::Models::AlbumRetrieveResponse} for more details.
+      #
+      #   @param id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the album
+      #
+      #   @param album_type [Symbol, Spotted::Models::AlbumRetrieveResponse::AlbumType] The type of the album.
+      #
+      #   @param available_markets [Array<String>] The markets in which the album is available: [ISO 3166-1 alpha-2 country codes](
+      #
+      #   @param external_urls [Spotted::Models::ExternalURLObject] Known external URLs for this album.
+      #
+      #   @param href [String] A link to the Web API endpoint providing full details of the album.
+      #
+      #   @param images [Array<Spotted::Models::ImageObject>] The cover art for the album in various sizes, widest first.
+      #
+      #   @param name [String] The name of the album. In case of an album takedown, the value may be an empty s
+      #
+      #   @param release_date [String] The date the album was first released.
+      #
+      #   @param release_date_precision [Symbol, Spotted::Models::AlbumRetrieveResponse::ReleaseDatePrecision] The precision with which `release_date` value is known.
+      #
+      #   @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
+      #
+      #   @param copyrights [Array<Spotted::Models::CopyrightObject>] The copyright statements of the album.
+      #
+      #   @param external_ids [Spotted::Models::ExternalIDObject] Known external IDs for the album.
+      #
+      #   @param genres [Array<String>] **Deprecated** The array is always empty.
+      #
+      #   @param label [String] The label associated with the album.
+      #
+      #   @param popularity [Integer] The popularity of the album. The value will be between 0 and 100, with 100 being
+      #
+      #   @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.
+
+      # The type of the album.
+      #
+      # @see Spotted::Models::AlbumRetrieveResponse#album_type
+      module AlbumType
+        extend Spotted::Internal::Type::Enum
+
+        ALBUM = :album
+        SINGLE = :single
+        COMPILATION = :compilation
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # The precision with which `release_date` value is known.
+      #
+      # @see Spotted::Models::AlbumRetrieveResponse#release_date_precision
+      module ReleaseDatePrecision
+        extend Spotted::Internal::Type::Enum
+
+        YEAR = :year
+        MONTH = :month
+        DAY = :day
+
+        # @!method self.values
+        #   @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
+        #   A link to the Web API endpoint returning the full result of the request
+        #
+        #   @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).
+        #
+        #   @return [Integer]
+        required :limit, Integer
+
+        # @!attribute next_
+        #   URL to the next page of items. ( `null` if none)
+        #
+        #   @return [String, nil]
+        required :next_, String, api_name: :next, nil?: true
+
+        # @!attribute offset
+        #   The offset of the items returned (as set in the query or by default)
+        #
+        #   @return [Integer]
+        required :offset, Integer
+
+        # @!attribute previous
+        #   URL to the previous page of items. ( `null` if none)
+        #
+        #   @return [String, nil]
+        required :previous, String, nil?: true
+
+        # @!attribute total
+        #   The total number of items available to return.
+        #
+        #   @return [Integer]
+        required :total, Integer
+
+        # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
+        #   Some parameter documentations has been truncated, see
+        #   {Spotted::Models::AlbumRetrieveResponse::Tracks} for more details.
+        #
+        #   The tracks of the album.
+        #
+        #   @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)
+        #
+        #   @param offset [Integer] The offset of the items returned (as set in the query or by default)
+        #
+        #   @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.
+      end
+    end
+  end
+end

data/lib/spotted/models/artist_list_albums_params.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    # @see Spotted::Resources::Artists#list_albums
+    class ArtistListAlbumsParams < Spotted::Internal::Type::BaseModel
+      extend Spotted::Internal::Type::RequestParameters::Converter
+      include Spotted::Internal::Type::RequestParameters
+
+      # @!attribute include_groups
+      #   A comma-separated list of keywords that will be used to filter the response. If
+      #   not supplied, all album types will be returned. <br/> Valid values are:<br/>-
+      #   `album`<br/>- `single`<br/>- `appears_on`<br/>- `compilation`<br/>For example:
+      #   `include_groups=album,single`.
+      #
+      #   @return [String, nil]
+      optional :include_groups, String
+
+      # @!attribute limit
+      #   The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute market
+      #   An
+      #   [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
+      #   If a country code is specified, only content that is available in that market
+      #   will be returned.<br/> If a valid user access token is specified in the request
+      #   header, the country associated with the user account will take priority over
+      #   this parameter.<br/> _**Note**: If neither market or user country are provided,
+      #   the content is considered unavailable for the client._<br/> Users can view the
+      #   country that is associated with their account in the
+      #   [account settings](https://www.spotify.com/account/overview/).
+      #
+      #   @return [String, nil]
+      optional :market, String
+
+      # @!attribute offset
+      #   The index of the first item to return. Default: 0 (the first item). Use with
+      #   limit to get the next set of items.
+      #
+      #   @return [Integer, nil]
+      optional :offset, Integer
+
+      # @!method initialize(include_groups: nil, limit: nil, market: nil, offset: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Spotted::Models::ArtistListAlbumsParams} for more details.
+      #
+      #   @param include_groups [String] A comma-separated list of keywords that will be used to filter the response. If
+      #
+      #   @param limit [Integer] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+      #
+      #   @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
+      #
+      #   @param offset [Integer] The index of the first item to return. Default: 0 (the first item). Use with lim
+      #
+      #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/spotted/models/artist_list_albums_response.rb

@@ -0,0 +1,195 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    # @see Spotted::Resources::Artists#list_albums
+    class ArtistListAlbumsResponse < Spotted::Internal::Type::BaseModel
+      # @!attribute id
+      #   The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+      #   album.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute album_group
+      #   This field describes the relationship between the artist and the album.
+      #
+      #   @return [Symbol, Spotted::Models::ArtistListAlbumsResponse::AlbumGroup]
+      required :album_group, enum: -> { Spotted::Models::ArtistListAlbumsResponse::AlbumGroup }
+
+      # @!attribute album_type
+      #   The type of the album.
+      #
+      #   @return [Symbol, Spotted::Models::ArtistListAlbumsResponse::AlbumType]
+      required :album_type, enum: -> { Spotted::Models::ArtistListAlbumsResponse::AlbumType }
+
+      # @!attribute artists
+      #   The artists of the album. Each artist object includes a link in `href` to more
+      #   detailed information about the artist.
+      #
+      #   @return [Array<Spotted::Models::SimplifiedArtistObject>]
+      required :artists, -> { Spotted::Internal::Type::ArrayOf[Spotted::SimplifiedArtistObject] }
+
+      # @!attribute available_markets
+      #   The markets in which the album is available:
+      #   [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
+      #   _**NOTE**: an album is considered available in a market when at least 1 of its
+      #   tracks is available in that market._
+      #
+      #   @return [Array<String>]
+      required :available_markets, Spotted::Internal::Type::ArrayOf[String]
+
+      # @!attribute external_urls
+      #   Known external URLs for this album.
+      #
+      #   @return [Spotted::Models::ExternalURLObject]
+      required :external_urls, -> { Spotted::ExternalURLObject }
+
+      # @!attribute href
+      #   A link to the Web API endpoint providing full details of the album.
+      #
+      #   @return [String]
+      required :href, String
+
+      # @!attribute images
+      #   The cover art for the album in various sizes, widest first.
+      #
+      #   @return [Array<Spotted::Models::ImageObject>]
+      required :images, -> { Spotted::Internal::Type::ArrayOf[Spotted::ImageObject] }
+
+      # @!attribute name
+      #   The name of the album. In case of an album takedown, the value may be an empty
+      #   string.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute release_date
+      #   The date the album was first released.
+      #
+      #   @return [String]
+      required :release_date, String
+
+      # @!attribute release_date_precision
+      #   The precision with which `release_date` value is known.
+      #
+      #   @return [Symbol, Spotted::Models::ArtistListAlbumsResponse::ReleaseDatePrecision]
+      required :release_date_precision,
+               enum: -> { Spotted::Models::ArtistListAlbumsResponse::ReleaseDatePrecision }
+
+      # @!attribute total_tracks
+      #   The number of tracks in the album.
+      #
+      #   @return [Integer]
+      required :total_tracks, Integer
+
+      # @!attribute type
+      #   The object type.
+      #
+      #   @return [Symbol, Spotted::Models::ArtistListAlbumsResponse::Type]
+      required :type, enum: -> { Spotted::Models::ArtistListAlbumsResponse::Type }
+
+      # @!attribute uri
+      #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+      #   album.
+      #
+      #   @return [String]
+      required :uri, String
+
+      # @!attribute restrictions
+      #   Included in the response when a content restriction is applied.
+      #
+      #   @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)
+      #   Some parameter documentations has been truncated, see
+      #   {Spotted::Models::ArtistListAlbumsResponse} for more details.
+      #
+      #   @param id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the album
+      #
+      #   @param album_group [Symbol, Spotted::Models::ArtistListAlbumsResponse::AlbumGroup] This field describes the relationship between the artist and the album.
+      #
+      #   @param album_type [Symbol, Spotted::Models::ArtistListAlbumsResponse::AlbumType] The type of the album.
+      #
+      #   @param artists [Array<Spotted::Models::SimplifiedArtistObject>] The artists of the album. Each artist object includes a link in `href` to more d
+      #
+      #   @param available_markets [Array<String>] The markets in which the album is available: [ISO 3166-1 alpha-2 country codes](
+      #
+      #   @param external_urls [Spotted::Models::ExternalURLObject] Known external URLs for this album.
+      #
+      #   @param href [String] A link to the Web API endpoint providing full details of the album.
+      #
+      #   @param images [Array<Spotted::Models::ImageObject>] The cover art for the album in various sizes, widest first.
+      #
+      #   @param name [String] The name of the album. In case of an album takedown, the value may be an empty s
+      #
+      #   @param release_date [String] The date the album was first released.
+      #
+      #   @param release_date_precision [Symbol, Spotted::Models::ArtistListAlbumsResponse::ReleaseDatePrecision] The precision with which `release_date` value is known.
+      #
+      #   @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.
+
+      # This field describes the relationship between the artist and the album.
+      #
+      # @see Spotted::Models::ArtistListAlbumsResponse#album_group
+      module AlbumGroup
+        extend Spotted::Internal::Type::Enum
+
+        ALBUM = :album
+        SINGLE = :single
+        COMPILATION = :compilation
+        APPEARS_ON = :appears_on
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # The type of the album.
+      #
+      # @see Spotted::Models::ArtistListAlbumsResponse#album_type
+      module AlbumType
+        extend Spotted::Internal::Type::Enum
+
+        ALBUM = :album
+        SINGLE = :single
+        COMPILATION = :compilation
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # The precision with which `release_date` value is known.
+      #
+      # @see Spotted::Models::ArtistListAlbumsResponse#release_date_precision
+      module ReleaseDatePrecision
+        extend Spotted::Internal::Type::Enum
+
+        YEAR = :year
+        MONTH = :month
+        DAY = :day
+
+        # @!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/artist_list_params.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    # @see Spotted::Resources::Artists#list
+    class ArtistListParams < Spotted::Internal::Type::BaseModel
+      extend Spotted::Internal::Type::RequestParameters::Converter
+      include Spotted::Internal::Type::RequestParameters
+
+      # @!attribute ids
+      #   A comma-separated list of the
+      #   [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the artists.
+      #   Maximum: 50 IDs.
+      #
+      #   @return [String]
+      required :ids, String
+
+      # @!method initialize(ids:, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Spotted::Models::ArtistListParams} for more details.
+      #
+      #   @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
+      #
+      #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/spotted/models/artist_list_related_artists_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    # @see Spotted::Resources::Artists#list_related_artists
+    class ArtistListRelatedArtistsParams < Spotted::Internal::Type::BaseModel
+      extend Spotted::Internal::Type::RequestParameters::Converter
+      include Spotted::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/spotted/models/artist_list_related_artists_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    # @see Spotted::Resources::Artists#list_related_artists
+    class ArtistListRelatedArtistsResponse < Spotted::Internal::Type::BaseModel
+      # @!attribute artists
+      #
+      #   @return [Array<Spotted::Models::ArtistObject>]
+      required :artists, -> { Spotted::Internal::Type::ArrayOf[Spotted::ArtistObject] }
+
+      # @!method initialize(artists:)
+      #   @param artists [Array<Spotted::Models::ArtistObject>]
+    end
+  end
+end

data/lib/spotted/models/artist_list_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    # @see Spotted::Resources::Artists#list
+    class ArtistListResponse < Spotted::Internal::Type::BaseModel
+      # @!attribute artists
+      #
+      #   @return [Array<Spotted::Models::ArtistObject>]
+      required :artists, -> { Spotted::Internal::Type::ArrayOf[Spotted::ArtistObject] }
+
+      # @!method initialize(artists:)
+      #   @param artists [Array<Spotted::Models::ArtistObject>]
+    end
+  end
+end

data/lib/spotted/models/artist_list_top_tracks_params.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    # @see Spotted::Resources::Artists#list_top_tracks
+    class ArtistListTopTracksParams < Spotted::Internal::Type::BaseModel
+      extend Spotted::Internal::Type::RequestParameters::Converter
+      include Spotted::Internal::Type::RequestParameters
+
+      # @!attribute market
+      #   An
+      #   [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
+      #   If a country code is specified, only content that is available in that market
+      #   will be returned.<br/> If a valid user access token is specified in the request
+      #   header, the country associated with the user account will take priority over
+      #   this parameter.<br/> _**Note**: If neither market or user country are provided,
+      #   the content is considered unavailable for the client._<br/> Users can view the
+      #   country that is associated with their account in the
+      #   [account settings](https://www.spotify.com/account/overview/).
+      #
+      #   @return [String, nil]
+      optional :market, String
+
+      # @!method initialize(market: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Spotted::Models::ArtistListTopTracksParams} for more details.
+      #
+      #   @param market [String] An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_al
+      #
+      #   @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/spotted/models/artist_list_top_tracks_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Spotted
+  module Models
+    # @see Spotted::Resources::Artists#list_top_tracks
+    class ArtistListTopTracksResponse < Spotted::Internal::Type::BaseModel
+      # @!attribute tracks
+      #
+      #   @return [Array<Spotted::Models::TrackObject>]
+      required :tracks, -> { Spotted::Internal::Type::ArrayOf[Spotted::TrackObject] }
+
+      # @!method initialize(tracks:)
+      #   @param tracks [Array<Spotted::Models::TrackObject>]
+    end
+  end
+end