spotted 0.1.0

data/rbi/spotted/models/browse/category_list_response.rbi

@@ -0,0 +1,204 @@
+# typed: strong
+
+module Spotted
+  module Models
+    module Browse
+      class CategoryListResponse < Spotted::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Spotted::Models::Browse::CategoryListResponse,
+              Spotted::Internal::AnyHash
+            )
+          end
+
+        sig do
+          returns(Spotted::Models::Browse::CategoryListResponse::Categories)
+        end
+        attr_reader :categories
+
+        sig do
+          params(
+            categories:
+              Spotted::Models::Browse::CategoryListResponse::Categories::OrHash
+          ).void
+        end
+        attr_writer :categories
+
+        sig do
+          params(
+            categories:
+              Spotted::Models::Browse::CategoryListResponse::Categories::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(categories:)
+        end
+
+        sig do
+          override.returns(
+            {
+              categories:
+                Spotted::Models::Browse::CategoryListResponse::Categories
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Categories < Spotted::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Spotted::Models::Browse::CategoryListResponse::Categories,
+                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 do
+            returns(
+              T::Array[
+                Spotted::Models::Browse::CategoryListResponse::Categories::Item
+              ]
+            )
+          end
+          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
+
+          sig do
+            params(
+              href: String,
+              items:
+                T::Array[
+                  Spotted::Models::Browse::CategoryListResponse::Categories::Item::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::Models::Browse::CategoryListResponse::Categories::Item
+                  ],
+                limit: Integer,
+                next_: T.nilable(String),
+                offset: Integer,
+                previous: T.nilable(String),
+                total: Integer
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Item < Spotted::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Spotted::Models::Browse::CategoryListResponse::Categories::Item,
+                  Spotted::Internal::AnyHash
+                )
+              end
+
+            # The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) of
+            # the category.
+            sig { returns(String) }
+            attr_accessor :id
+
+            # A link to the Web API endpoint returning full details of the category.
+            sig { returns(String) }
+            attr_accessor :href
+
+            # The category icon, in various sizes.
+            sig { returns(T::Array[Spotted::ImageObject]) }
+            attr_accessor :icons
+
+            # The name of the category.
+            sig { returns(String) }
+            attr_accessor :name
+
+            sig do
+              params(
+                id: String,
+                href: String,
+                icons: T::Array[Spotted::ImageObject::OrHash],
+                name: String
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) of
+              # the category.
+              id:,
+              # A link to the Web API endpoint returning full details of the category.
+              href:,
+              # The category icon, in various sizes.
+              icons:,
+              # The name of the category.
+              name:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  id: String,
+                  href: String,
+                  icons: T::Array[Spotted::ImageObject],
+                  name: String
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/spotted/models/browse/category_retrieve_params.rbi

@@ -0,0 +1,62 @@
+# typed: strong
+
+module Spotted
+  module Models
+    module Browse
+      class CategoryRetrieveParams < Spotted::Internal::Type::BaseModel
+        extend Spotted::Internal::Type::RequestParameters::Converter
+        include Spotted::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Spotted::Browse::CategoryRetrieveParams,
+              Spotted::Internal::AnyHash
+            )
+          end
+
+        # The desired language, consisting of an
+        # [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an
+        # [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2),
+        # joined by an underscore. For example: `es_MX`, meaning &quot;Spanish
+        # (Mexico)&quot;. Provide this parameter if you want the category strings returned
+        # in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the
+        # specified language is not available, the category strings returned will be in
+        # the Spotify default language (American English)._
+        sig { returns(T.nilable(String)) }
+        attr_reader :locale
+
+        sig { params(locale: String).void }
+        attr_writer :locale
+
+        sig do
+          params(
+            locale: String,
+            request_options: Spotted::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The desired language, consisting of an
+          # [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an
+          # [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2),
+          # joined by an underscore. For example: `es_MX`, meaning &quot;Spanish
+          # (Mexico)&quot;. Provide this parameter if you want the category strings returned
+          # in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the
+          # specified language is not available, the category strings returned will be in
+          # the Spotify default language (American English)._
+          locale: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            { locale: String, request_options: Spotted::RequestOptions }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/spotted/models/browse/category_retrieve_response.rbi

@@ -0,0 +1,68 @@
+# typed: strong
+
+module Spotted
+  module Models
+    module Browse
+      class CategoryRetrieveResponse < Spotted::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Spotted::Models::Browse::CategoryRetrieveResponse,
+              Spotted::Internal::AnyHash
+            )
+          end
+
+        # The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) of
+        # the category.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # A link to the Web API endpoint returning full details of the category.
+        sig { returns(String) }
+        attr_accessor :href
+
+        # The category icon, in various sizes.
+        sig { returns(T::Array[Spotted::ImageObject]) }
+        attr_accessor :icons
+
+        # The name of the category.
+        sig { returns(String) }
+        attr_accessor :name
+
+        sig do
+          params(
+            id: String,
+            href: String,
+            icons: T::Array[Spotted::ImageObject::OrHash],
+            name: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) of
+          # the category.
+          id:,
+          # A link to the Web API endpoint returning full details of the category.
+          href:,
+          # The category icon, in various sizes.
+          icons:,
+          # The name of the category.
+          name:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              href: String,
+              icons: T::Array[Spotted::ImageObject],
+              name: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/spotted/models/browse_get_featured_playlists_params.rbi

@@ -0,0 +1,87 @@
+# typed: strong
+
+module Spotted
+  module Models
+    class BrowseGetFeaturedPlaylistsParams < Spotted::Internal::Type::BaseModel
+      extend Spotted::Internal::Type::RequestParameters::Converter
+      include Spotted::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Spotted::BrowseGetFeaturedPlaylistsParams,
+            Spotted::Internal::AnyHash
+          )
+        end
+
+      # The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :limit
+
+      sig { params(limit: Integer).void }
+      attr_writer :limit
+
+      # The desired language, consisting of an
+      # [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an
+      # [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2),
+      # joined by an underscore. For example: `es_MX`, meaning &quot;Spanish
+      # (Mexico)&quot;. Provide this parameter if you want the category strings returned
+      # in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the
+      # specified language is not available, the category strings returned will be in
+      # the Spotify default language (American English)._
+      sig { returns(T.nilable(String)) }
+      attr_reader :locale
+
+      sig { params(locale: String).void }
+      attr_writer :locale
+
+      # The index of the first item to return. Default: 0 (the first item). Use with
+      # limit to get the next set of items.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :offset
+
+      sig { params(offset: Integer).void }
+      attr_writer :offset
+
+      sig do
+        params(
+          limit: Integer,
+          locale: String,
+          offset: Integer,
+          request_options: Spotted::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        limit: nil,
+        # The desired language, consisting of an
+        # [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an
+        # [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2),
+        # joined by an underscore. For example: `es_MX`, meaning &quot;Spanish
+        # (Mexico)&quot;. Provide this parameter if you want the category strings returned
+        # in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the
+        # specified language is not available, the category strings returned will be in
+        # the Spotify default language (American English)._
+        locale: nil,
+        # The index of the first item to return. Default: 0 (the first item). Use with
+        # limit to get the next set of items.
+        offset: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            limit: Integer,
+            locale: String,
+            offset: Integer,
+            request_options: Spotted::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/spotted/models/browse_get_featured_playlists_response.rbi

@@ -0,0 +1,49 @@
+# typed: strong
+
+module Spotted
+  module Models
+    class BrowseGetFeaturedPlaylistsResponse < Spotted::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Spotted::Models::BrowseGetFeaturedPlaylistsResponse,
+            Spotted::Internal::AnyHash
+          )
+        end
+
+      # The localized message of a playlist.
+      sig { returns(T.nilable(String)) }
+      attr_reader :message
+
+      sig { params(message: String).void }
+      attr_writer :message
+
+      sig { returns(T.nilable(Spotted::PagingPlaylistObject)) }
+      attr_reader :playlists
+
+      sig { params(playlists: Spotted::PagingPlaylistObject::OrHash).void }
+      attr_writer :playlists
+
+      sig do
+        params(
+          message: String,
+          playlists: Spotted::PagingPlaylistObject::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The localized message of a playlist.
+        message: nil,
+        playlists: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          { message: String, playlists: Spotted::PagingPlaylistObject }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/spotted/models/browse_get_new_releases_params.rbi

@@ -0,0 +1,59 @@
+# typed: strong
+
+module Spotted
+  module Models
+    class BrowseGetNewReleasesParams < Spotted::Internal::Type::BaseModel
+      extend Spotted::Internal::Type::RequestParameters::Converter
+      include Spotted::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Spotted::BrowseGetNewReleasesParams, Spotted::Internal::AnyHash)
+        end
+
+      # The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :limit
+
+      sig { params(limit: Integer).void }
+      attr_writer :limit
+
+      # The index of the first item to return. Default: 0 (the first item). Use with
+      # limit to get the next set of items.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :offset
+
+      sig { params(offset: Integer).void }
+      attr_writer :offset
+
+      sig do
+        params(
+          limit: Integer,
+          offset: Integer,
+          request_options: Spotted::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        limit: nil,
+        # The index of the first item to return. Default: 0 (the first item). Use with
+        # limit to get the next set of items.
+        offset: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            limit: Integer,
+            offset: Integer,
+            request_options: Spotted::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end