spotted 0.1.0

data/rbi/spotted/models/me/album_list_response.rbi

@@ -0,0 +1,529 @@
+# typed: strong
+
+module Spotted
+  module Models
+    module Me
+      class AlbumListResponse < Spotted::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Spotted::Models::Me::AlbumListResponse,
+              Spotted::Internal::AnyHash
+            )
+          end
+
+        # The date and time the album was saved Timestamps are returned in ISO 8601 format
+        # as Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ. If
+        # the time is imprecise (for example, the date/time of an album release), an
+        # additional field indicates the precision; see for example, release_date in an
+        # album object.
+        sig { returns(T.nilable(Time)) }
+        attr_reader :added_at
+
+        sig { params(added_at: Time).void }
+        attr_writer :added_at
+
+        # Information about the album.
+        sig do
+          returns(T.nilable(Spotted::Models::Me::AlbumListResponse::Album))
+        end
+        attr_reader :album
+
+        sig do
+          params(
+            album: Spotted::Models::Me::AlbumListResponse::Album::OrHash
+          ).void
+        end
+        attr_writer :album
+
+        sig do
+          params(
+            added_at: Time,
+            album: Spotted::Models::Me::AlbumListResponse::Album::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The date and time the album was saved Timestamps are returned in ISO 8601 format
+          # as Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ. If
+          # the time is imprecise (for example, the date/time of an album release), an
+          # additional field indicates the precision; see for example, release_date in an
+          # album object.
+          added_at: nil,
+          # Information about the album.
+          album: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              added_at: Time,
+              album: Spotted::Models::Me::AlbumListResponse::Album
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Album < Spotted::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Spotted::Models::Me::AlbumListResponse::Album,
+                Spotted::Internal::AnyHash
+              )
+            end
+
+          # The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+          # album.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The type of the album.
+          sig do
+            returns(
+              Spotted::Models::Me::AlbumListResponse::Album::AlbumType::TaggedSymbol
+            )
+          end
+          attr_accessor :album_type
+
+          # 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::Me::AlbumListResponse::Album::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::Me::AlbumListResponse::Album::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
+
+          # The artists of the album. Each artist object includes a link in `href` to more
+          # detailed information about the artist.
+          sig { returns(T.nilable(T::Array[Spotted::SimplifiedArtistObject])) }
+          attr_reader :artists
+
+          sig do
+            params(
+              artists: T::Array[Spotted::SimplifiedArtistObject::OrHash]
+            ).void
+          end
+          attr_writer :artists
+
+          # The copyright statements of the album.
+          sig { returns(T.nilable(T::Array[Spotted::CopyrightObject])) }
+          attr_reader :copyrights
+
+          sig do
+            params(copyrights: T::Array[Spotted::CopyrightObject::OrHash]).void
+          end
+          attr_writer :copyrights
+
+          # Known external IDs for the album.
+          sig { returns(T.nilable(Spotted::ExternalIDObject)) }
+          attr_reader :external_ids
+
+          sig { params(external_ids: Spotted::ExternalIDObject::OrHash).void }
+          attr_writer :external_ids
+
+          # **Deprecated** The array is always empty.
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_reader :genres
+
+          sig { params(genres: T::Array[String]).void }
+          attr_writer :genres
+
+          # The label associated with the album.
+          sig { returns(T.nilable(String)) }
+          attr_reader :label
+
+          sig { params(label: String).void }
+          attr_writer :label
+
+          # The popularity of the album. The value will be between 0 and 100, with 100 being
+          # the most popular.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :popularity
+
+          sig { params(popularity: Integer).void }
+          attr_writer :popularity
+
+          # Included in the response when a content restriction is applied.
+          sig { returns(T.nilable(Spotted::AlbumRestrictionObject)) }
+          attr_reader :restrictions
+
+          sig do
+            params(restrictions: Spotted::AlbumRestrictionObject::OrHash).void
+          end
+          attr_writer :restrictions
+
+          # The tracks of the album.
+          sig do
+            returns(
+              T.nilable(Spotted::Models::Me::AlbumListResponse::Album::Tracks)
+            )
+          end
+          attr_reader :tracks
+
+          sig do
+            params(
+              tracks:
+                Spotted::Models::Me::AlbumListResponse::Album::Tracks::OrHash
+            ).void
+          end
+          attr_writer :tracks
+
+          # Information about the album.
+          sig do
+            params(
+              id: String,
+              album_type:
+                Spotted::Models::Me::AlbumListResponse::Album::AlbumType::OrSymbol,
+              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::Me::AlbumListResponse::Album::ReleaseDatePrecision::OrSymbol,
+              total_tracks: Integer,
+              type:
+                Spotted::Models::Me::AlbumListResponse::Album::Type::OrSymbol,
+              uri: String,
+              artists: T::Array[Spotted::SimplifiedArtistObject::OrHash],
+              copyrights: T::Array[Spotted::CopyrightObject::OrHash],
+              external_ids: Spotted::ExternalIDObject::OrHash,
+              genres: T::Array[String],
+              label: String,
+              popularity: Integer,
+              restrictions: Spotted::AlbumRestrictionObject::OrHash,
+              tracks:
+                Spotted::Models::Me::AlbumListResponse::Album::Tracks::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+            # album.
+            id:,
+            # The type of the album.
+            album_type:,
+            # 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:,
+            # The artists of the album. Each artist object includes a link in `href` to more
+            # detailed information about the artist.
+            artists: nil,
+            # The copyright statements of the album.
+            copyrights: nil,
+            # Known external IDs for the album.
+            external_ids: nil,
+            # **Deprecated** The array is always empty.
+            genres: nil,
+            # The label associated with the album.
+            label: nil,
+            # The popularity of the album. The value will be between 0 and 100, with 100 being
+            # the most popular.
+            popularity: nil,
+            # Included in the response when a content restriction is applied.
+            restrictions: nil,
+            # The tracks of the album.
+            tracks: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                album_type:
+                  Spotted::Models::Me::AlbumListResponse::Album::AlbumType::TaggedSymbol,
+                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::Me::AlbumListResponse::Album::ReleaseDatePrecision::TaggedSymbol,
+                total_tracks: Integer,
+                type:
+                  Spotted::Models::Me::AlbumListResponse::Album::Type::TaggedSymbol,
+                uri: String,
+                artists: T::Array[Spotted::SimplifiedArtistObject],
+                copyrights: T::Array[Spotted::CopyrightObject],
+                external_ids: Spotted::ExternalIDObject,
+                genres: T::Array[String],
+                label: String,
+                popularity: Integer,
+                restrictions: Spotted::AlbumRestrictionObject,
+                tracks: Spotted::Models::Me::AlbumListResponse::Album::Tracks
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The type of the album.
+          module AlbumType
+            extend Spotted::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Spotted::Models::Me::AlbumListResponse::Album::AlbumType
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ALBUM =
+              T.let(
+                :album,
+                Spotted::Models::Me::AlbumListResponse::Album::AlbumType::TaggedSymbol
+              )
+            SINGLE =
+              T.let(
+                :single,
+                Spotted::Models::Me::AlbumListResponse::Album::AlbumType::TaggedSymbol
+              )
+            COMPILATION =
+              T.let(
+                :compilation,
+                Spotted::Models::Me::AlbumListResponse::Album::AlbumType::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Spotted::Models::Me::AlbumListResponse::Album::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::Me::AlbumListResponse::Album::ReleaseDatePrecision
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            YEAR =
+              T.let(
+                :year,
+                Spotted::Models::Me::AlbumListResponse::Album::ReleaseDatePrecision::TaggedSymbol
+              )
+            MONTH =
+              T.let(
+                :month,
+                Spotted::Models::Me::AlbumListResponse::Album::ReleaseDatePrecision::TaggedSymbol
+              )
+            DAY =
+              T.let(
+                :day,
+                Spotted::Models::Me::AlbumListResponse::Album::ReleaseDatePrecision::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Spotted::Models::Me::AlbumListResponse::Album::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::Me::AlbumListResponse::Album::Type
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ALBUM =
+              T.let(
+                :album,
+                Spotted::Models::Me::AlbumListResponse::Album::Type::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Spotted::Models::Me::AlbumListResponse::Album::Type::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          class Tracks < Spotted::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Spotted::Models::Me::AlbumListResponse::Album::Tracks,
+                  Spotted::Internal::AnyHash
+                )
+              end
+
+            # A link to the Web API endpoint returning the full result of the request
+            sig { returns(String) }
+            attr_accessor :href
+
+            sig { returns(T::Array[Spotted::SimplifiedTrackObject]) }
+            attr_accessor :items
+
+            # The maximum number of items in the response (as set in the query or by default).
+            sig { returns(Integer) }
+            attr_accessor :limit
+
+            # URL to the next page of items. ( `null` if none)
+            sig { returns(T.nilable(String)) }
+            attr_accessor :next_
+
+            # The offset of the items returned (as set in the query or by default)
+            sig { returns(Integer) }
+            attr_accessor :offset
+
+            # URL to the previous page of items. ( `null` if none)
+            sig { returns(T.nilable(String)) }
+            attr_accessor :previous
+
+            # The total number of items available to return.
+            sig { returns(Integer) }
+            attr_accessor :total
+
+            # The tracks of the album.
+            sig do
+              params(
+                href: String,
+                items: T::Array[Spotted::SimplifiedTrackObject::OrHash],
+                limit: Integer,
+                next_: T.nilable(String),
+                offset: Integer,
+                previous: T.nilable(String),
+                total: Integer
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # A link to the Web API endpoint returning the full result of the request
+              href:,
+              items:,
+              # The maximum number of items in the response (as set in the query or by default).
+              limit:,
+              # URL to the next page of items. ( `null` if none)
+              next_:,
+              # The offset of the items returned (as set in the query or by default)
+              offset:,
+              # URL to the previous page of items. ( `null` if none)
+              previous:,
+              # The total number of items available to return.
+              total:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  href: String,
+                  items: T::Array[Spotted::SimplifiedTrackObject],
+                  limit: Integer,
+                  next_: T.nilable(String),
+                  offset: Integer,
+                  previous: T.nilable(String),
+                  total: Integer
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/spotted/models/me/album_remove_params.rbi

@@ -0,0 +1,56 @@
+# typed: strong
+
+module Spotted
+  module Models
+    module Me
+      class AlbumRemoveParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(Spotted::Me::AlbumRemoveParams, Spotted::Internal::AnyHash)
+          end
+
+        # A JSON array of the
+        # [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+        # `["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]`<br/>A maximum of 50 items
+        # can be specified in one request. _**Note**: if the `ids` parameter is present in
+        # the query string, any IDs listed here in the body will be ignored._
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :body_ids
+
+        sig { params(body_ids: T::Array[String]).void }
+        attr_writer :body_ids
+
+        sig do
+          params(
+            body_ids: T::Array[String],
+            request_options: Spotted::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # A JSON array of the
+          # [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+          # `["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]`<br/>A maximum of 50 items
+          # can be specified in one request. _**Note**: if the `ids` parameter is present in
+          # the query string, any IDs listed here in the body will be ignored._
+          body_ids: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              body_ids: T::Array[String],
+              request_options: Spotted::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/spotted/models/me/album_save_params.rbi

@@ -0,0 +1,56 @@
+# typed: strong
+
+module Spotted
+  module Models
+    module Me
+      class AlbumSaveParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(Spotted::Me::AlbumSaveParams, Spotted::Internal::AnyHash)
+          end
+
+        # A JSON array of the
+        # [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+        # `["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]`<br/>A maximum of 50 items
+        # can be specified in one request. _**Note**: if the `ids` parameter is present in
+        # the query string, any IDs listed here in the body will be ignored._
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :body_ids
+
+        sig { params(body_ids: T::Array[String]).void }
+        attr_writer :body_ids
+
+        sig do
+          params(
+            body_ids: T::Array[String],
+            request_options: Spotted::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # A JSON array of the
+          # [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+          # `["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]`<br/>A maximum of 50 items
+          # can be specified in one request. _**Note**: if the `ids` parameter is present in
+          # the query string, any IDs listed here in the body will be ignored._
+          body_ids: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              body_ids: T::Array[String],
+              request_options: Spotted::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/spotted/models/me/audiobook_check_params.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Spotted
+  module Models
+    module Me
+      class AudiobookCheckParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(Spotted::Me::AudiobookCheckParams, Spotted::Internal::AnyHash)
+          end
+
+        # A comma-separated list of the
+        # [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+        # `ids=18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ`. 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 example:
+          # `ids=18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ`. 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
+end

data/rbi/spotted/models/me/audiobook_check_response.rbi

@@ -0,0 +1,13 @@
+# typed: strong
+
+module Spotted
+  module Models
+    module Me
+      AudiobookCheckResponse =
+        T.let(
+          Spotted::Internal::Type::ArrayOf[Spotted::Internal::Type::Boolean],
+          Spotted::Internal::Type::Converter
+        )
+    end
+  end
+end