spotted 0.1.0

data/rbi/spotted/models/artist_list_albums_response.rbi

@@ -0,0 +1,338 @@
+# typed: strong
+
+module Spotted
+  module Models
+    class ArtistListAlbumsResponse < Spotted::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Spotted::Models::ArtistListAlbumsResponse,
+            Spotted::Internal::AnyHash
+          )
+        end
+
+      # The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+      # album.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # This field describes the relationship between the artist and the album.
+      sig do
+        returns(
+          Spotted::Models::ArtistListAlbumsResponse::AlbumGroup::TaggedSymbol
+        )
+      end
+      attr_accessor :album_group
+
+      # The type of the album.
+      sig do
+        returns(
+          Spotted::Models::ArtistListAlbumsResponse::AlbumType::TaggedSymbol
+        )
+      end
+      attr_accessor :album_type
+
+      # The artists of the album. Each artist object includes a link in `href` to more
+      # detailed information about the artist.
+      sig { returns(T::Array[Spotted::SimplifiedArtistObject]) }
+      attr_accessor :artists
+
+      # 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._
+      sig { returns(T::Array[String]) }
+      attr_accessor :available_markets
+
+      # Known external URLs for this album.
+      sig { returns(Spotted::ExternalURLObject) }
+      attr_reader :external_urls
+
+      sig { params(external_urls: Spotted::ExternalURLObject::OrHash).void }
+      attr_writer :external_urls
+
+      # A link to the Web API endpoint providing full details of the album.
+      sig { returns(String) }
+      attr_accessor :href
+
+      # The cover art for the album in various sizes, widest first.
+      sig { returns(T::Array[Spotted::ImageObject]) }
+      attr_accessor :images
+
+      # The name of the album. In case of an album takedown, the value may be an empty
+      # string.
+      sig { returns(String) }
+      attr_accessor :name
+
+      # The date the album was first released.
+      sig { returns(String) }
+      attr_accessor :release_date
+
+      # The precision with which `release_date` value is known.
+      sig do
+        returns(
+          Spotted::Models::ArtistListAlbumsResponse::ReleaseDatePrecision::TaggedSymbol
+        )
+      end
+      attr_accessor :release_date_precision
+
+      # The number of tracks in the album.
+      sig { returns(Integer) }
+      attr_accessor :total_tracks
+
+      # The object type.
+      sig do
+        returns(Spotted::Models::ArtistListAlbumsResponse::Type::TaggedSymbol)
+      end
+      attr_accessor :type
+
+      # The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+      # album.
+      sig { returns(String) }
+      attr_accessor :uri
+
+      # Included in the response when a content restriction is applied.
+      sig { returns(T.nilable(Spotted::AlbumRestrictionObject)) }
+      attr_reader :restrictions
+
+      sig { params(restrictions: Spotted::AlbumRestrictionObject::OrHash).void }
+      attr_writer :restrictions
+
+      sig do
+        params(
+          id: String,
+          album_group:
+            Spotted::Models::ArtistListAlbumsResponse::AlbumGroup::OrSymbol,
+          album_type:
+            Spotted::Models::ArtistListAlbumsResponse::AlbumType::OrSymbol,
+          artists: T::Array[Spotted::SimplifiedArtistObject::OrHash],
+          available_markets: T::Array[String],
+          external_urls: Spotted::ExternalURLObject::OrHash,
+          href: String,
+          images: T::Array[Spotted::ImageObject::OrHash],
+          name: String,
+          release_date: String,
+          release_date_precision:
+            Spotted::Models::ArtistListAlbumsResponse::ReleaseDatePrecision::OrSymbol,
+          total_tracks: Integer,
+          type: Spotted::Models::ArtistListAlbumsResponse::Type::OrSymbol,
+          uri: String,
+          restrictions: Spotted::AlbumRestrictionObject::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+        # album.
+        id:,
+        # This field describes the relationship between the artist and the album.
+        album_group:,
+        # The type of the album.
+        album_type:,
+        # The artists of the album. Each artist object includes a link in `href` to more
+        # detailed information about the artist.
+        artists:,
+        # 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._
+        available_markets:,
+        # Known external URLs for this album.
+        external_urls:,
+        # A link to the Web API endpoint providing full details of the album.
+        href:,
+        # The cover art for the album in various sizes, widest first.
+        images:,
+        # The name of the album. In case of an album takedown, the value may be an empty
+        # string.
+        name:,
+        # The date the album was first released.
+        release_date:,
+        # The precision with which `release_date` value is known.
+        release_date_precision:,
+        # The number of tracks in the album.
+        total_tracks:,
+        # The object type.
+        type:,
+        # The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+        # album.
+        uri:,
+        # Included in the response when a content restriction is applied.
+        restrictions: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            album_group:
+              Spotted::Models::ArtistListAlbumsResponse::AlbumGroup::TaggedSymbol,
+            album_type:
+              Spotted::Models::ArtistListAlbumsResponse::AlbumType::TaggedSymbol,
+            artists: T::Array[Spotted::SimplifiedArtistObject],
+            available_markets: T::Array[String],
+            external_urls: Spotted::ExternalURLObject,
+            href: String,
+            images: T::Array[Spotted::ImageObject],
+            name: String,
+            release_date: String,
+            release_date_precision:
+              Spotted::Models::ArtistListAlbumsResponse::ReleaseDatePrecision::TaggedSymbol,
+            total_tracks: Integer,
+            type: Spotted::Models::ArtistListAlbumsResponse::Type::TaggedSymbol,
+            uri: String,
+            restrictions: Spotted::AlbumRestrictionObject
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # This field describes the relationship between the artist and the album.
+      module AlbumGroup
+        extend Spotted::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Spotted::Models::ArtistListAlbumsResponse::AlbumGroup)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ALBUM =
+          T.let(
+            :album,
+            Spotted::Models::ArtistListAlbumsResponse::AlbumGroup::TaggedSymbol
+          )
+        SINGLE =
+          T.let(
+            :single,
+            Spotted::Models::ArtistListAlbumsResponse::AlbumGroup::TaggedSymbol
+          )
+        COMPILATION =
+          T.let(
+            :compilation,
+            Spotted::Models::ArtistListAlbumsResponse::AlbumGroup::TaggedSymbol
+          )
+        APPEARS_ON =
+          T.let(
+            :appears_on,
+            Spotted::Models::ArtistListAlbumsResponse::AlbumGroup::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Spotted::Models::ArtistListAlbumsResponse::AlbumGroup::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The type of the album.
+      module AlbumType
+        extend Spotted::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Spotted::Models::ArtistListAlbumsResponse::AlbumType)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ALBUM =
+          T.let(
+            :album,
+            Spotted::Models::ArtistListAlbumsResponse::AlbumType::TaggedSymbol
+          )
+        SINGLE =
+          T.let(
+            :single,
+            Spotted::Models::ArtistListAlbumsResponse::AlbumType::TaggedSymbol
+          )
+        COMPILATION =
+          T.let(
+            :compilation,
+            Spotted::Models::ArtistListAlbumsResponse::AlbumType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Spotted::Models::ArtistListAlbumsResponse::AlbumType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The precision with which `release_date` value is known.
+      module ReleaseDatePrecision
+        extend Spotted::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Spotted::Models::ArtistListAlbumsResponse::ReleaseDatePrecision
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        YEAR =
+          T.let(
+            :year,
+            Spotted::Models::ArtistListAlbumsResponse::ReleaseDatePrecision::TaggedSymbol
+          )
+        MONTH =
+          T.let(
+            :month,
+            Spotted::Models::ArtistListAlbumsResponse::ReleaseDatePrecision::TaggedSymbol
+          )
+        DAY =
+          T.let(
+            :day,
+            Spotted::Models::ArtistListAlbumsResponse::ReleaseDatePrecision::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Spotted::Models::ArtistListAlbumsResponse::ReleaseDatePrecision::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The object type.
+      module Type
+        extend Spotted::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Spotted::Models::ArtistListAlbumsResponse::Type)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ALBUM =
+          T.let(
+            :album,
+            Spotted::Models::ArtistListAlbumsResponse::Type::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Spotted::Models::ArtistListAlbumsResponse::Type::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/spotted/models/artist_list_params.rbi

@@ -0,0 +1,44 @@
+# typed: strong
+
+module Spotted
+  module Models
+    class ArtistListParams < Spotted::Internal::Type::BaseModel
+      extend Spotted::Internal::Type::RequestParameters::Converter
+      include Spotted::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Spotted::ArtistListParams, Spotted::Internal::AnyHash)
+        end
+
+      # A comma-separated list of the
+      # [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the artists.
+      # Maximum: 50 IDs.
+      sig { returns(String) }
+      attr_accessor :ids
+
+      sig do
+        params(
+          ids: String,
+          request_options: Spotted::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # A comma-separated list of the
+        # [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the artists.
+        # Maximum: 50 IDs.
+        ids:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          { ids: String, request_options: Spotted::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/spotted/models/artist_list_related_artists_params.rbi

@@ -0,0 +1,30 @@
+# typed: strong
+
+module Spotted
+  module Models
+    class ArtistListRelatedArtistsParams < Spotted::Internal::Type::BaseModel
+      extend Spotted::Internal::Type::RequestParameters::Converter
+      include Spotted::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Spotted::ArtistListRelatedArtistsParams,
+            Spotted::Internal::AnyHash
+          )
+        end
+
+      sig do
+        params(request_options: Spotted::RequestOptions::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(request_options: {})
+      end
+
+      sig { override.returns({ request_options: Spotted::RequestOptions }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/spotted/models/artist_list_related_artists_response.rbi

@@ -0,0 +1,30 @@
+# typed: strong
+
+module Spotted
+  module Models
+    class ArtistListRelatedArtistsResponse < Spotted::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Spotted::Models::ArtistListRelatedArtistsResponse,
+            Spotted::Internal::AnyHash
+          )
+        end
+
+      sig { returns(T::Array[Spotted::ArtistObject]) }
+      attr_accessor :artists
+
+      sig do
+        params(artists: T::Array[Spotted::ArtistObject::OrHash]).returns(
+          T.attached_class
+        )
+      end
+      def self.new(artists:)
+      end
+
+      sig { override.returns({ artists: T::Array[Spotted::ArtistObject] }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/spotted/models/artist_list_response.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module Spotted
+  module Models
+    class ArtistListResponse < Spotted::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Spotted::Models::ArtistListResponse, Spotted::Internal::AnyHash)
+        end
+
+      sig { returns(T::Array[Spotted::ArtistObject]) }
+      attr_accessor :artists
+
+      sig do
+        params(artists: T::Array[Spotted::ArtistObject::OrHash]).returns(
+          T.attached_class
+        )
+      end
+      def self.new(artists:)
+      end
+
+      sig { override.returns({ artists: T::Array[Spotted::ArtistObject] }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/spotted/models/artist_list_top_tracks_params.rbi

@@ -0,0 +1,59 @@
+# typed: strong
+
+module Spotted
+  module Models
+    class ArtistListTopTracksParams < Spotted::Internal::Type::BaseModel
+      extend Spotted::Internal::Type::RequestParameters::Converter
+      include Spotted::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Spotted::ArtistListTopTracksParams, Spotted::Internal::AnyHash)
+        end
+
+      # 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/).
+      sig { returns(T.nilable(String)) }
+      attr_reader :market
+
+      sig { params(market: String).void }
+      attr_writer :market
+
+      sig do
+        params(
+          market: String,
+          request_options: Spotted::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # 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/).
+        market: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          { market: String, request_options: Spotted::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/spotted/models/artist_list_top_tracks_response.rbi

@@ -0,0 +1,30 @@
+# typed: strong
+
+module Spotted
+  module Models
+    class ArtistListTopTracksResponse < Spotted::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Spotted::Models::ArtistListTopTracksResponse,
+            Spotted::Internal::AnyHash
+          )
+        end
+
+      sig { returns(T::Array[Spotted::TrackObject]) }
+      attr_accessor :tracks
+
+      sig do
+        params(tracks: T::Array[Spotted::TrackObject::OrHash]).returns(
+          T.attached_class
+        )
+      end
+      def self.new(tracks:)
+      end
+
+      sig { override.returns({ tracks: T::Array[Spotted::TrackObject] }) }
+      def to_hash
+      end
+    end
+  end
+end