spotted 0.1.0

data/rbi/spotted/resources/recommendations.rbi

@@ -0,0 +1,336 @@
+# typed: strong
+
+module Spotted
+  module Resources
+    class Recommendations
+      # Recommendations are generated based on the available information for a given
+      # seed entity and matched against similar artists and tracks. If there is
+      # sufficient information about the provided seeds, a list of tracks will be
+      # returned together with pool size details.
+      #
+      # For artists and tracks that are very new or obscure there might not be enough
+      # data to generate a list of tracks.
+      sig do
+        params(
+          limit: Integer,
+          market: String,
+          max_acousticness: Float,
+          max_danceability: Float,
+          max_duration_ms: Integer,
+          max_energy: Float,
+          max_instrumentalness: Float,
+          max_key: Integer,
+          max_liveness: Float,
+          max_loudness: Float,
+          max_mode: Integer,
+          max_popularity: Integer,
+          max_speechiness: Float,
+          max_tempo: Float,
+          max_time_signature: Integer,
+          max_valence: Float,
+          min_acousticness: Float,
+          min_danceability: Float,
+          min_duration_ms: Integer,
+          min_energy: Float,
+          min_instrumentalness: Float,
+          min_key: Integer,
+          min_liveness: Float,
+          min_loudness: Float,
+          min_mode: Integer,
+          min_popularity: Integer,
+          min_speechiness: Float,
+          min_tempo: Float,
+          min_time_signature: Integer,
+          min_valence: Float,
+          seed_artists: String,
+          seed_genres: String,
+          seed_tracks: String,
+          target_acousticness: Float,
+          target_danceability: Float,
+          target_duration_ms: Integer,
+          target_energy: Float,
+          target_instrumentalness: Float,
+          target_key: Integer,
+          target_liveness: Float,
+          target_loudness: Float,
+          target_mode: Integer,
+          target_popularity: Integer,
+          target_speechiness: Float,
+          target_tempo: Float,
+          target_time_signature: Integer,
+          target_valence: Float,
+          request_options: Spotted::RequestOptions::OrHash
+        ).returns(Spotted::Models::RecommendationGetResponse)
+      end
+      def get(
+        # The target size of the list of recommended tracks. For seeds with unusually
+        # small pools or when highly restrictive filtering is applied, it may be
+        # impossible to generate the requested number of recommended tracks. Debugging
+        # information for such cases is available in the response. Default: 20\. Minimum:
+        # 1\. Maximum: 100.
+        limit: nil,
+        # 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,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_acousticness: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_danceability: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_duration_ms: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_energy: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_instrumentalness: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_key: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_liveness: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_loudness: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_mode: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_popularity: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_speechiness: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_tempo: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_time_signature: nil,
+        # For each tunable track attribute, a hard ceiling on the selected track
+        # attribute’s value can be provided. See tunable track attributes below for the
+        # list of available options. For example, `max_instrumentalness=0.35` would filter
+        # out most tracks that are likely to be instrumental.
+        max_valence: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_acousticness: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_danceability: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_duration_ms: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_energy: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_instrumentalness: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_key: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_liveness: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_loudness: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_mode: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_popularity: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_speechiness: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_tempo: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_time_signature: nil,
+        # For each tunable track attribute, a hard floor on the selected track attribute’s
+        # value can be provided. See tunable track attributes below for the list of
+        # available options. For example, `min_tempo=140` would restrict results to only
+        # those tracks with a tempo of greater than 140 beats per minute.
+        min_valence: nil,
+        # A comma separated list of
+        # [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for seed
+        # artists. Up to 5 seed values may be provided in any combination of
+        # `seed_artists`, `seed_tracks` and `seed_genres`.<br/> _**Note**: only required
+        # if `seed_genres` and `seed_tracks` are not set_.
+        seed_artists: nil,
+        # A comma separated list of any genres in the set of
+        # [available genre seeds](/documentation/web-api/reference/get-recommendation-genres).
+        # Up to 5 seed values may be provided in any combination of `seed_artists`,
+        # `seed_tracks` and `seed_genres`.<br/> _**Note**: only required if `seed_artists`
+        # and `seed_tracks` are not set_.
+        seed_genres: nil,
+        # A comma separated list of
+        # [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for a seed
+        # track. Up to 5 seed values may be provided in any combination of `seed_artists`,
+        # `seed_tracks` and `seed_genres`.<br/> _**Note**: only required if `seed_artists`
+        # and `seed_genres` are not set_.
+        seed_tracks: nil,
+        # For each of the tunable track attributes (below) a target value may be provided.
+        # Tracks with the attribute values nearest to the target values will be preferred.
+        # For example, you might request `target_energy=0.6` and
+        # `target_danceability=0.8`. All target values will be weighed equally in ranking
+        # results.
+        target_acousticness: nil,
+        # For each of the tunable track attributes (below) a target value may be provided.
+        # Tracks with the attribute values nearest to the target values will be preferred.
+        # For example, you might request `target_energy=0.6` and
+        # `target_danceability=0.8`. All target values will be weighed equally in ranking
+        # results.
+        target_danceability: nil,
+        # Target duration of the track (ms)
+        target_duration_ms: nil,
+        # For each of the tunable track attributes (below) a target value may be provided.
+        # Tracks with the attribute values nearest to the target values will be preferred.
+        # For example, you might request `target_energy=0.6` and
+        # `target_danceability=0.8`. All target values will be weighed equally in ranking
+        # results.
+        target_energy: nil,
+        # For each of the tunable track attributes (below) a target value may be provided.
+        # Tracks with the attribute values nearest to the target values will be preferred.
+        # For example, you might request `target_energy=0.6` and
+        # `target_danceability=0.8`. All target values will be weighed equally in ranking
+        # results.
+        target_instrumentalness: nil,
+        # For each of the tunable track attributes (below) a target value may be provided.
+        # Tracks with the attribute values nearest to the target values will be preferred.
+        # For example, you might request `target_energy=0.6` and
+        # `target_danceability=0.8`. All target values will be weighed equally in ranking
+        # results.
+        target_key: nil,
+        # For each of the tunable track attributes (below) a target value may be provided.
+        # Tracks with the attribute values nearest to the target values will be preferred.
+        # For example, you might request `target_energy=0.6` and
+        # `target_danceability=0.8`. All target values will be weighed equally in ranking
+        # results.
+        target_liveness: nil,
+        # For each of the tunable track attributes (below) a target value may be provided.
+        # Tracks with the attribute values nearest to the target values will be preferred.
+        # For example, you might request `target_energy=0.6` and
+        # `target_danceability=0.8`. All target values will be weighed equally in ranking
+        # results.
+        target_loudness: nil,
+        # For each of the tunable track attributes (below) a target value may be provided.
+        # Tracks with the attribute values nearest to the target values will be preferred.
+        # For example, you might request `target_energy=0.6` and
+        # `target_danceability=0.8`. All target values will be weighed equally in ranking
+        # results.
+        target_mode: nil,
+        # For each of the tunable track attributes (below) a target value may be provided.
+        # Tracks with the attribute values nearest to the target values will be preferred.
+        # For example, you might request `target_energy=0.6` and
+        # `target_danceability=0.8`. All target values will be weighed equally in ranking
+        # results.
+        target_popularity: nil,
+        # For each of the tunable track attributes (below) a target value may be provided.
+        # Tracks with the attribute values nearest to the target values will be preferred.
+        # For example, you might request `target_energy=0.6` and
+        # `target_danceability=0.8`. All target values will be weighed equally in ranking
+        # results.
+        target_speechiness: nil,
+        # Target tempo (BPM)
+        target_tempo: nil,
+        # For each of the tunable track attributes (below) a target value may be provided.
+        # Tracks with the attribute values nearest to the target values will be preferred.
+        # For example, you might request `target_energy=0.6` and
+        # `target_danceability=0.8`. All target values will be weighed equally in ranking
+        # results.
+        target_time_signature: nil,
+        # For each of the tunable track attributes (below) a target value may be provided.
+        # Tracks with the attribute values nearest to the target values will be preferred.
+        # For example, you might request `target_energy=0.6` and
+        # `target_danceability=0.8`. All target values will be weighed equally in ranking
+        # results.
+        target_valence: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieve a list of available genres seed parameter values for
+      # [recommendations](/documentation/web-api/reference/get-recommendations).
+      sig do
+        params(request_options: Spotted::RequestOptions::OrHash).returns(
+          Spotted::Models::RecommendationListAvailableGenreSeedsResponse
+        )
+      end
+      def list_available_genre_seeds(request_options: {})
+      end
+
+      # @api private
+      sig { params(client: Spotted::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/spotted/resources/search.rbi

@@ -0,0 +1,71 @@
+# typed: strong
+
+module Spotted
+  module Resources
+    class Search
+      # Get Spotify catalog information about albums, artists, playlists, tracks, shows,
+      # episodes or audiobooks that match a keyword string. Audiobooks are only
+      # available within the US, UK, Canada, Ireland, New Zealand and Australia markets.
+      sig do
+        params(
+          q: String,
+          type: T::Array[Spotted::SearchRetrieveParams::Type::OrSymbol],
+          include_external:
+            Spotted::SearchRetrieveParams::IncludeExternal::OrSymbol,
+          limit: Integer,
+          market: String,
+          offset: Integer,
+          request_options: Spotted::RequestOptions::OrHash
+        ).returns(Spotted::Models::SearchRetrieveResponse)
+      end
+      def retrieve(
+        # Your search query.
+        #
+        # You can narrow down your search using field filters. The available filters are
+        # `album`, `artist`, `track`, `year`, `upc`, `tag:hipster`, `tag:new`, `isrc`, and
+        # `genre`. Each field filter only applies to certain result types.
+        #
+        # The `artist` and `year` filters can be used while searching albums, artists and
+        # tracks. You can filter on a single `year` or a range (e.g. 1955-1960).<br /> The
+        # `album` filter can be used while searching albums and tracks.<br /> The `genre`
+        # filter can be used while searching artists and tracks.<br /> The `isrc` and
+        # `track` filters can be used while searching tracks.<br /> The `upc`, `tag:new`
+        # and `tag:hipster` filters can only be used while searching albums. The `tag:new`
+        # filter will return albums released in the past two weeks and `tag:hipster` can
+        # be used to return only albums with the lowest 10% popularity.<br />
+        q:,
+        # A comma-separated list of item types to search across. Search results include
+        # hits from all the specified item types. For example: `q=abacab&type=album,track`
+        # returns both albums and tracks matching "abacab".
+        type:,
+        # If `include_external=audio` is specified it signals that the client can play
+        # externally hosted audio content, and marks the content as playable in the
+        # response. By default externally hosted audio content is marked as unplayable in
+        # the response.
+        include_external: nil,
+        # The maximum number of results to return in each item type.
+        limit: nil,
+        # 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,
+        # The index of the first result to return. Use with limit to get the next page of
+        # search results.
+        offset: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Spotted::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/spotted/resources/shows.rbi

@@ -0,0 +1,100 @@
+# typed: strong
+
+module Spotted
+  module Resources
+    class Shows
+      # Get Spotify catalog information for a single show identified by its unique
+      # Spotify ID.
+      sig do
+        params(
+          id: String,
+          market: String,
+          request_options: Spotted::RequestOptions::OrHash
+        ).returns(Spotted::Models::ShowRetrieveResponse)
+      end
+      def retrieve(
+        # The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the show.
+        id,
+        # 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
+
+      # Get Spotify catalog information for several shows based on their Spotify IDs.
+      sig do
+        params(
+          ids: String,
+          market: String,
+          request_options: Spotted::RequestOptions::OrHash
+        ).returns(Spotted::Models::ShowListResponse)
+      end
+      def list(
+        # A comma-separated list of the
+        # [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the shows.
+        # Maximum: 50 IDs.
+        ids:,
+        # 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
+
+      # Get Spotify catalog information about an show’s episodes. Optional parameters
+      # can be used to limit the number of episodes returned.
+      sig do
+        params(
+          id: String,
+          limit: Integer,
+          market: String,
+          offset: Integer,
+          request_options: Spotted::RequestOptions::OrHash
+        ).returns(
+          Spotted::Internal::CursorURLPage[Spotted::SimplifiedEpisodeObject]
+        )
+      end
+      def list_episodes(
+        # The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the show.
+        id,
+        # The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+        limit: nil,
+        # 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,
+        # 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
+
+      # @api private
+      sig { params(client: Spotted::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/spotted/resources/tracks.rbi

@@ -0,0 +1,66 @@
+# typed: strong
+
+module Spotted
+  module Resources
+    class Tracks
+      # Get Spotify catalog information for a single track identified by its unique
+      # Spotify ID.
+      sig do
+        params(
+          id: String,
+          market: String,
+          request_options: Spotted::RequestOptions::OrHash
+        ).returns(Spotted::TrackObject)
+      end
+      def retrieve(
+        # The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+        # track.
+        id,
+        # 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
+
+      # Get Spotify catalog information for multiple tracks based on their Spotify IDs.
+      sig do
+        params(
+          ids: String,
+          market: String,
+          request_options: Spotted::RequestOptions::OrHash
+        ).returns(Spotted::Models::TrackListResponse)
+      end
+      def list(
+        # A comma-separated list of the
+        # [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+        # `ids=4iV5W9uYEdYUVa79Axb7Rh,1301WleyT98MSxVHPZCA6M`. Maximum: 50 IDs.
+        ids:,
+        # 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
+
+      # @api private
+      sig { params(client: Spotted::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/spotted/resources/users/playlists.rbi

@@ -0,0 +1,78 @@
+# typed: strong
+
+module Spotted
+  module Resources
+    class Users
+      class Playlists
+        # Create a playlist for a Spotify user. (The playlist will be empty until you
+        # [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each
+        # user is generally limited to a maximum of 11000 playlists.
+        sig do
+          params(
+            user_id: String,
+            name: String,
+            collaborative: T::Boolean,
+            description: String,
+            public: T::Boolean,
+            request_options: Spotted::RequestOptions::OrHash
+          ).returns(Spotted::Models::Users::PlaylistCreateResponse)
+        end
+        def create(
+          # The user's [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids).
+          user_id,
+          # The name for the new playlist, for example `"Your Coolest Playlist"`. This name
+          # does not need to be unique; a user may have several playlists with the same
+          # name.
+          name:,
+          # Defaults to `false`. If `true` the playlist will be collaborative. _**Note**: to
+          # create a collaborative playlist you must also set `public` to `false`. To create
+          # collaborative playlists you must have granted `playlist-modify-private` and
+          # `playlist-modify-public`
+          # [scopes](/documentation/web-api/concepts/scopes/#list-of-scopes)._
+          collaborative: nil,
+          # value for playlist description as displayed in Spotify Clients and in the Web
+          # API.
+          description: nil,
+          # Defaults to `true`. The playlist's public/private status (if it should be added
+          # to the user's profile or not): `true` the playlist will be public, `false` the
+          # playlist will be private. To be able to create private playlists, the user must
+          # have granted the `playlist-modify-private`
+          # [scope](/documentation/web-api/concepts/scopes/#list-of-scopes). For more about
+          # public/private status, see
+          # [Working with Playlists](/documentation/web-api/concepts/playlists)
+          public: nil,
+          request_options: {}
+        )
+        end
+
+        # Get a list of the playlists owned or followed by a Spotify user.
+        sig do
+          params(
+            user_id: String,
+            limit: Integer,
+            offset: Integer,
+            request_options: Spotted::RequestOptions::OrHash
+          ).returns(
+            Spotted::Internal::CursorURLPage[Spotted::SimplifiedPlaylistObject]
+          )
+        end
+        def list(
+          # The user's [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids).
+          user_id,
+          # The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+          limit: nil,
+          # The index of the first playlist to return. Default: 0 (the first object).
+          # Maximum offset: 100.000\. Use with `limit` to get the next set of playlists.
+          offset: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Spotted::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end