spotted 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0327511d3f7632182098667902cd5cd228d2470f95bbaec5eb50708cbe1eabc7
-  data.tar.gz: c8e8664a697319f6c2142156c48e2edcf805a65f32d0b780bd7352bebb82fbf0
+  metadata.gz: 8818a6a05b4eb4aa71da008f713547686bf0093e346adfa4cd4ea0f8f8487ca3
+  data.tar.gz: d2da7b3a32ce630751008fa09b9b0f71c3775e3ff0959a3ea5ff1866e8af7cde
 SHA512:
-  metadata.gz: 194ca906ae851592c5c7490dbdde4e6b1b58a960f548666effee77d0c755ba20d48aa0c66473d9abddc775515d2d8120d49acb3c6d3f830e1a0506679eb0cc31
-  data.tar.gz: 9960a452be806304c04a51635fc443a750f20d6a8976a01aedb50272cf57053d74dac68e59f976d148c3de9aeccc017ff2275e8bcb32778b72823517e64c664f
+  metadata.gz: c3f05753115b788948b6c63bd162982de8476175ed556e90a657386b7c83e6c8dc1b7d66f6cbd997960158b2479502958a6f4eb1cec417c8f0641eee3e33d84a
+  data.tar.gz: 2cae676f5ffe7858067f87dba305f0040c7514a064299b1cc1b785fb03f60916131066bd91a3544b9642d67ce97da377ba9b32baf012b295fc6e75ac0bc46f4c

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.5.0 (2025-11-05)
+
+Full Changelog: [v0.4.0...v0.5.0](https://github.com/cjavdev/spotted/compare/v0.4.0...v0.5.0)
+
+### Features
+
+* **api:** manual updates ([5eb8f35](https://github.com/cjavdev/spotted/commit/5eb8f353b335e9f2e862a919b51b9a45b84dfa0a))
+
+
+### Chores
+
+* **internal:** version bump ([81d42c8](https://github.com/cjavdev/spotted/commit/81d42c8c6636dcc91d52a10a94647252b79959a7))
+
 ## 0.4.0 (2025-11-04)
 
 Full Changelog: [v0.3.0...v0.4.0](https://github.com/cjavdev/spotted/compare/v0.3.0...v0.4.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "spotted", "~> 0.4.0"
+gem "spotted", "~> 0.5.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/spotted/models/{album_list_params.rb → album_bulk_retrieve_params.rb}

@@ -2,8 +2,8 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Albums#list
-    class AlbumListParams < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Albums#bulk_retrieve
+    class AlbumBulkRetrieveParams < Spotted::Internal::Type::BaseModel
       extend Spotted::Internal::Type::RequestParameters::Converter
       include Spotted::Internal::Type::RequestParameters
 
@@ -31,7 +31,7 @@ module Spotted
 
       # @!method initialize(ids:, market: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
-      #   {Spotted::Models::AlbumListParams} for more details.
+      #   {Spotted::Models::AlbumBulkRetrieveParams} for more details.
       #
       #   @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
       #

data/lib/spotted/models/{album_list_response.rb → album_bulk_retrieve_response.rb}

@@ -2,15 +2,16 @@
 
 module Spotted
   module Models
-    # @see Spotted::Resources::Albums#list
-    class AlbumListResponse < Spotted::Internal::Type::BaseModel
+    # @see Spotted::Resources::Albums#bulk_retrieve
+    class AlbumBulkRetrieveResponse < Spotted::Internal::Type::BaseModel
       # @!attribute albums
       #
-      #   @return [Array<Spotted::Models::AlbumListResponse::Album>]
-      required :albums, -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::AlbumListResponse::Album] }
+      #   @return [Array<Spotted::Models::AlbumBulkRetrieveResponse::Album>]
+      required :albums,
+               -> { Spotted::Internal::Type::ArrayOf[Spotted::Models::AlbumBulkRetrieveResponse::Album] }
 
       # @!method initialize(albums:)
-      #   @param albums [Array<Spotted::Models::AlbumListResponse::Album>]
+      #   @param albums [Array<Spotted::Models::AlbumBulkRetrieveResponse::Album>]
 
       class Album < Spotted::Internal::Type::BaseModel
         # @!attribute id
@@ -23,8 +24,8 @@ module Spotted
         # @!attribute album_type
         #   The type of the album.
         #
-        #   @return [Symbol, Spotted::Models::AlbumListResponse::Album::AlbumType]
-        required :album_type, enum: -> { Spotted::Models::AlbumListResponse::Album::AlbumType }
+        #   @return [Symbol, Spotted::Models::AlbumBulkRetrieveResponse::Album::AlbumType]
+        required :album_type, enum: -> { Spotted::Models::AlbumBulkRetrieveResponse::Album::AlbumType }
 
         # @!attribute available_markets
         #   The markets in which the album is available:
@@ -69,9 +70,9 @@ module Spotted
         # @!attribute release_date_precision
         #   The precision with which `release_date` value is known.
         #
-        #   @return [Symbol, Spotted::Models::AlbumListResponse::Album::ReleaseDatePrecision]
+        #   @return [Symbol, Spotted::Models::AlbumBulkRetrieveResponse::Album::ReleaseDatePrecision]
         required :release_date_precision,
-                 enum: -> { Spotted::Models::AlbumListResponse::Album::ReleaseDatePrecision }
+                 enum: -> { Spotted::Models::AlbumBulkRetrieveResponse::Album::ReleaseDatePrecision }
 
         # @!attribute total_tracks
         #   The number of tracks in the album.
@@ -82,8 +83,8 @@ module Spotted
         # @!attribute type
         #   The object type.
         #
-        #   @return [Symbol, Spotted::Models::AlbumListResponse::Album::Type]
-        required :type, enum: -> { Spotted::Models::AlbumListResponse::Album::Type }
+        #   @return [Symbol, Spotted::Models::AlbumBulkRetrieveResponse::Album::Type]
+        required :type, enum: -> { Spotted::Models::AlbumBulkRetrieveResponse::Album::Type }
 
         # @!attribute uri
         #   The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
@@ -141,16 +142,16 @@ module Spotted
         # @!attribute tracks
         #   The tracks of the album.
         #
-        #   @return [Spotted::Models::AlbumListResponse::Album::Tracks, nil]
-        optional :tracks, -> { Spotted::Models::AlbumListResponse::Album::Tracks }
+        #   @return [Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks, nil]
+        optional :tracks, -> { Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks }
 
         # @!method initialize(id:, album_type:, available_markets:, external_urls:, href:, images:, name:, release_date:, release_date_precision:, total_tracks:, type:, uri:, artists: nil, copyrights: nil, external_ids: nil, genres: nil, label: nil, popularity: nil, restrictions: nil, tracks: nil)
         #   Some parameter documentations has been truncated, see
-        #   {Spotted::Models::AlbumListResponse::Album} for more details.
+        #   {Spotted::Models::AlbumBulkRetrieveResponse::Album} for more details.
         #
         #   @param id [String] The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the album
         #
-        #   @param album_type [Symbol, Spotted::Models::AlbumListResponse::Album::AlbumType] The type of the album.
+        #   @param album_type [Symbol, Spotted::Models::AlbumBulkRetrieveResponse::Album::AlbumType] The type of the album.
         #
         #   @param available_markets [Array<String>] The markets in which the album is available: [ISO 3166-1 alpha-2 country codes](
         #
@@ -164,11 +165,11 @@ module Spotted
         #
         #   @param release_date [String] The date the album was first released.
         #
-        #   @param release_date_precision [Symbol, Spotted::Models::AlbumListResponse::Album::ReleaseDatePrecision] The precision with which `release_date` value is known.
+        #   @param release_date_precision [Symbol, Spotted::Models::AlbumBulkRetrieveResponse::Album::ReleaseDatePrecision] The precision with which `release_date` value is known.
         #
         #   @param total_tracks [Integer] The number of tracks in the album.
         #
-        #   @param type [Symbol, Spotted::Models::AlbumListResponse::Album::Type] The object type.
+        #   @param type [Symbol, Spotted::Models::AlbumBulkRetrieveResponse::Album::Type] The object type.
         #
         #   @param uri [String] The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the albu
         #
@@ -186,11 +187,11 @@ module Spotted
         #
         #   @param restrictions [Spotted::Models::AlbumRestrictionObject] Included in the response when a content restriction is applied.
         #
-        #   @param tracks [Spotted::Models::AlbumListResponse::Album::Tracks] The tracks of the album.
+        #   @param tracks [Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks] The tracks of the album.
 
         # The type of the album.
         #
-        # @see Spotted::Models::AlbumListResponse::Album#album_type
+        # @see Spotted::Models::AlbumBulkRetrieveResponse::Album#album_type
         module AlbumType
           extend Spotted::Internal::Type::Enum
 
@@ -204,7 +205,7 @@ module Spotted
 
         # The precision with which `release_date` value is known.
         #
-        # @see Spotted::Models::AlbumListResponse::Album#release_date_precision
+        # @see Spotted::Models::AlbumBulkRetrieveResponse::Album#release_date_precision
         module ReleaseDatePrecision
           extend Spotted::Internal::Type::Enum
 
@@ -218,7 +219,7 @@ module Spotted
 
         # The object type.
         #
-        # @see Spotted::Models::AlbumListResponse::Album#type
+        # @see Spotted::Models::AlbumBulkRetrieveResponse::Album#type
         module Type
           extend Spotted::Internal::Type::Enum
 
@@ -228,7 +229,7 @@ module Spotted
           #   @return [Array<Symbol>]
         end
 
-        # @see Spotted::Models::AlbumListResponse::Album#tracks
+        # @see Spotted::Models::AlbumBulkRetrieveResponse::Album#tracks
         class Tracks < Spotted::Internal::Type::BaseModel
           # @!attribute href
           #   A link to the Web API endpoint returning the full result of the request
@@ -273,7 +274,7 @@ module Spotted
 
           # @!method initialize(href:, items:, limit:, next_:, offset:, previous:, total:)
           #   Some parameter documentations has been truncated, see
-          #   {Spotted::Models::AlbumListResponse::Album::Tracks} for more details.
+          #   {Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks} for more details.
           #
           #   The tracks of the album.
           #

data/lib/spotted/models.rb

@@ -39,7 +39,7 @@ module Spotted
     mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
   end
 
-  AlbumListParams = Spotted::Models::AlbumListParams
+  AlbumBulkRetrieveParams = Spotted::Models::AlbumBulkRetrieveParams
 
   AlbumListTracksParams = Spotted::Models::AlbumListTracksParams
 

data/lib/spotted/resources/albums.rb

@@ -31,12 +31,12 @@ module Spotted
       end
 
       # Some parameter documentations has been truncated, see
-      # {Spotted::Models::AlbumListParams} for more details.
+      # {Spotted::Models::AlbumBulkRetrieveParams} for more details.
       #
       # Get Spotify catalog information for multiple albums identified by their Spotify
       # IDs.
       #
-      # @overload list(ids:, market: nil, request_options: {})
+      # @overload bulk_retrieve(ids:, market: nil, request_options: {})
       #
       # @param ids [String] A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spot
       #
@@ -44,16 +44,16 @@ module Spotted
       #
       # @param request_options [Spotted::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Spotted::Models::AlbumListResponse]
+      # @return [Spotted::Models::AlbumBulkRetrieveResponse]
       #
-      # @see Spotted::Models::AlbumListParams
-      def list(params)
-        parsed, options = Spotted::AlbumListParams.dump_request(params)
+      # @see Spotted::Models::AlbumBulkRetrieveParams
+      def bulk_retrieve(params)
+        parsed, options = Spotted::AlbumBulkRetrieveParams.dump_request(params)
         @client.request(
           method: :get,
           path: "albums",
           query: parsed,
-          model: Spotted::Models::AlbumListResponse,
+          model: Spotted::Models::AlbumBulkRetrieveResponse,
           options: options
         )
       end

data/lib/spotted/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Spotted
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/spotted.rb

@@ -57,8 +57,8 @@ require_relative "spotted/internal/cursor_url_page"
 require_relative "spotted/models/audiobook_base"
 require_relative "spotted/models/playlist_user_object"
 require_relative "spotted/models/show_base"
-require_relative "spotted/models/album_list_params"
-require_relative "spotted/models/album_list_response"
+require_relative "spotted/models/album_bulk_retrieve_params"
+require_relative "spotted/models/album_bulk_retrieve_response"
 require_relative "spotted/models/album_list_tracks_params"
 require_relative "spotted/models/album_restriction_object"
 require_relative "spotted/models/album_retrieve_params"

data/rbi/spotted/models/{album_list_params.rbi → album_bulk_retrieve_params.rbi}

@@ -2,13 +2,13 @@
 
 module Spotted
   module Models
-    class AlbumListParams < Spotted::Internal::Type::BaseModel
+    class AlbumBulkRetrieveParams < Spotted::Internal::Type::BaseModel
       extend Spotted::Internal::Type::RequestParameters::Converter
       include Spotted::Internal::Type::RequestParameters
 
       OrHash =
         T.type_alias do
-          T.any(Spotted::AlbumListParams, Spotted::Internal::AnyHash)
+          T.any(Spotted::AlbumBulkRetrieveParams, Spotted::Internal::AnyHash)
         end
 
       # A comma-separated list of the

data/rbi/spotted/models/{album_list_response.rbi → album_bulk_retrieve_response.rbi}

@@ -2,18 +2,24 @@
 
 module Spotted
   module Models
-    class AlbumListResponse < Spotted::Internal::Type::BaseModel
+    class AlbumBulkRetrieveResponse < Spotted::Internal::Type::BaseModel
       OrHash =
         T.type_alias do
-          T.any(Spotted::Models::AlbumListResponse, Spotted::Internal::AnyHash)
+          T.any(
+            Spotted::Models::AlbumBulkRetrieveResponse,
+            Spotted::Internal::AnyHash
+          )
         end
 
-      sig { returns(T::Array[Spotted::Models::AlbumListResponse::Album]) }
+      sig do
+        returns(T::Array[Spotted::Models::AlbumBulkRetrieveResponse::Album])
+      end
       attr_accessor :albums
 
       sig do
         params(
-          albums: T::Array[Spotted::Models::AlbumListResponse::Album::OrHash]
+          albums:
+            T::Array[Spotted::Models::AlbumBulkRetrieveResponse::Album::OrHash]
         ).returns(T.attached_class)
       end
       def self.new(albums:)
@@ -21,7 +27,9 @@ module Spotted
 
       sig do
         override.returns(
-          { albums: T::Array[Spotted::Models::AlbumListResponse::Album] }
+          {
+            albums: T::Array[Spotted::Models::AlbumBulkRetrieveResponse::Album]
+          }
         )
       end
       def to_hash
@@ -31,7 +39,7 @@ module Spotted
         OrHash =
           T.type_alias do
             T.any(
-              Spotted::Models::AlbumListResponse::Album,
+              Spotted::Models::AlbumBulkRetrieveResponse::Album,
               Spotted::Internal::AnyHash
             )
           end
@@ -44,7 +52,7 @@ module Spotted
         # The type of the album.
         sig do
           returns(
-            Spotted::Models::AlbumListResponse::Album::AlbumType::TaggedSymbol
+            Spotted::Models::AlbumBulkRetrieveResponse::Album::AlbumType::TaggedSymbol
           )
         end
         attr_accessor :album_type
@@ -83,7 +91,7 @@ module Spotted
         # The precision with which `release_date` value is known.
         sig do
           returns(
-            Spotted::Models::AlbumListResponse::Album::ReleaseDatePrecision::TaggedSymbol
+            Spotted::Models::AlbumBulkRetrieveResponse::Album::ReleaseDatePrecision::TaggedSymbol
           )
         end
         attr_accessor :release_date_precision
@@ -94,7 +102,9 @@ module Spotted
 
         # The object type.
         sig do
-          returns(Spotted::Models::AlbumListResponse::Album::Type::TaggedSymbol)
+          returns(
+            Spotted::Models::AlbumBulkRetrieveResponse::Album::Type::TaggedSymbol
+          )
         end
         attr_accessor :type
 
@@ -164,13 +174,16 @@ module Spotted
 
         # The tracks of the album.
         sig do
-          returns(T.nilable(Spotted::Models::AlbumListResponse::Album::Tracks))
+          returns(
+            T.nilable(Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks)
+          )
         end
         attr_reader :tracks
 
         sig do
           params(
-            tracks: Spotted::Models::AlbumListResponse::Album::Tracks::OrHash
+            tracks:
+              Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks::OrHash
           ).void
         end
         attr_writer :tracks
@@ -179,7 +192,7 @@ module Spotted
           params(
             id: String,
             album_type:
-              Spotted::Models::AlbumListResponse::Album::AlbumType::OrSymbol,
+              Spotted::Models::AlbumBulkRetrieveResponse::Album::AlbumType::OrSymbol,
             available_markets: T::Array[String],
             external_urls: Spotted::ExternalURLObject::OrHash,
             href: String,
@@ -187,9 +200,10 @@ module Spotted
             name: String,
             release_date: String,
             release_date_precision:
-              Spotted::Models::AlbumListResponse::Album::ReleaseDatePrecision::OrSymbol,
+              Spotted::Models::AlbumBulkRetrieveResponse::Album::ReleaseDatePrecision::OrSymbol,
             total_tracks: Integer,
-            type: Spotted::Models::AlbumListResponse::Album::Type::OrSymbol,
+            type:
+              Spotted::Models::AlbumBulkRetrieveResponse::Album::Type::OrSymbol,
             uri: String,
             artists: T::Array[Spotted::SimplifiedArtistObject::OrHash],
             copyrights: T::Array[Spotted::CopyrightObject::OrHash],
@@ -198,7 +212,8 @@ module Spotted
             label: String,
             popularity: Integer,
             restrictions: Spotted::AlbumRestrictionObject::OrHash,
-            tracks: Spotted::Models::AlbumListResponse::Album::Tracks::OrHash
+            tracks:
+              Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
@@ -258,7 +273,7 @@ module Spotted
             {
               id: String,
               album_type:
-                Spotted::Models::AlbumListResponse::Album::AlbumType::TaggedSymbol,
+                Spotted::Models::AlbumBulkRetrieveResponse::Album::AlbumType::TaggedSymbol,
               available_markets: T::Array[String],
               external_urls: Spotted::ExternalURLObject,
               href: String,
@@ -266,10 +281,10 @@ module Spotted
               name: String,
               release_date: String,
               release_date_precision:
-                Spotted::Models::AlbumListResponse::Album::ReleaseDatePrecision::TaggedSymbol,
+                Spotted::Models::AlbumBulkRetrieveResponse::Album::ReleaseDatePrecision::TaggedSymbol,
               total_tracks: Integer,
               type:
-                Spotted::Models::AlbumListResponse::Album::Type::TaggedSymbol,
+                Spotted::Models::AlbumBulkRetrieveResponse::Album::Type::TaggedSymbol,
               uri: String,
               artists: T::Array[Spotted::SimplifiedArtistObject],
               copyrights: T::Array[Spotted::CopyrightObject],
@@ -278,7 +293,7 @@ module Spotted
               label: String,
               popularity: Integer,
               restrictions: Spotted::AlbumRestrictionObject,
-              tracks: Spotted::Models::AlbumListResponse::Album::Tracks
+              tracks: Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks
             }
           )
         end
@@ -293,7 +308,7 @@ module Spotted
             T.type_alias do
               T.all(
                 Symbol,
-                Spotted::Models::AlbumListResponse::Album::AlbumType
+                Spotted::Models::AlbumBulkRetrieveResponse::Album::AlbumType
               )
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
@@ -301,23 +316,23 @@ module Spotted
           ALBUM =
             T.let(
               :album,
-              Spotted::Models::AlbumListResponse::Album::AlbumType::TaggedSymbol
+              Spotted::Models::AlbumBulkRetrieveResponse::Album::AlbumType::TaggedSymbol
             )
           SINGLE =
             T.let(
               :single,
-              Spotted::Models::AlbumListResponse::Album::AlbumType::TaggedSymbol
+              Spotted::Models::AlbumBulkRetrieveResponse::Album::AlbumType::TaggedSymbol
             )
           COMPILATION =
             T.let(
               :compilation,
-              Spotted::Models::AlbumListResponse::Album::AlbumType::TaggedSymbol
+              Spotted::Models::AlbumBulkRetrieveResponse::Album::AlbumType::TaggedSymbol
             )
 
           sig do
             override.returns(
               T::Array[
-                Spotted::Models::AlbumListResponse::Album::AlbumType::TaggedSymbol
+                Spotted::Models::AlbumBulkRetrieveResponse::Album::AlbumType::TaggedSymbol
               ]
             )
           end
@@ -333,7 +348,7 @@ module Spotted
             T.type_alias do
               T.all(
                 Symbol,
-                Spotted::Models::AlbumListResponse::Album::ReleaseDatePrecision
+                Spotted::Models::AlbumBulkRetrieveResponse::Album::ReleaseDatePrecision
               )
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
@@ -341,23 +356,23 @@ module Spotted
           YEAR =
             T.let(
               :year,
-              Spotted::Models::AlbumListResponse::Album::ReleaseDatePrecision::TaggedSymbol
+              Spotted::Models::AlbumBulkRetrieveResponse::Album::ReleaseDatePrecision::TaggedSymbol
             )
           MONTH =
             T.let(
               :month,
-              Spotted::Models::AlbumListResponse::Album::ReleaseDatePrecision::TaggedSymbol
+              Spotted::Models::AlbumBulkRetrieveResponse::Album::ReleaseDatePrecision::TaggedSymbol
             )
           DAY =
             T.let(
               :day,
-              Spotted::Models::AlbumListResponse::Album::ReleaseDatePrecision::TaggedSymbol
+              Spotted::Models::AlbumBulkRetrieveResponse::Album::ReleaseDatePrecision::TaggedSymbol
             )
 
           sig do
             override.returns(
               T::Array[
-                Spotted::Models::AlbumListResponse::Album::ReleaseDatePrecision::TaggedSymbol
+                Spotted::Models::AlbumBulkRetrieveResponse::Album::ReleaseDatePrecision::TaggedSymbol
               ]
             )
           end
@@ -371,20 +386,23 @@ module Spotted
 
           TaggedSymbol =
             T.type_alias do
-              T.all(Symbol, Spotted::Models::AlbumListResponse::Album::Type)
+              T.all(
+                Symbol,
+                Spotted::Models::AlbumBulkRetrieveResponse::Album::Type
+              )
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           ALBUM =
             T.let(
               :album,
-              Spotted::Models::AlbumListResponse::Album::Type::TaggedSymbol
+              Spotted::Models::AlbumBulkRetrieveResponse::Album::Type::TaggedSymbol
             )
 
           sig do
             override.returns(
               T::Array[
-                Spotted::Models::AlbumListResponse::Album::Type::TaggedSymbol
+                Spotted::Models::AlbumBulkRetrieveResponse::Album::Type::TaggedSymbol
               ]
             )
           end
@@ -396,7 +414,7 @@ module Spotted
           OrHash =
             T.type_alias do
               T.any(
-                Spotted::Models::AlbumListResponse::Album::Tracks,
+                Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks,
                 Spotted::Internal::AnyHash
               )
             end

data/rbi/spotted/models.rbi

@@ -1,7 +1,7 @@
 # typed: strong
 
 module Spotted
-  AlbumListParams = Spotted::Models::AlbumListParams
+  AlbumBulkRetrieveParams = Spotted::Models::AlbumBulkRetrieveParams
 
   AlbumListTracksParams = Spotted::Models::AlbumListTracksParams
 

data/rbi/spotted/resources/albums.rbi

@@ -35,9 +35,9 @@ module Spotted
           ids: String,
           market: String,
           request_options: Spotted::RequestOptions::OrHash
-        ).returns(Spotted::Models::AlbumListResponse)
+        ).returns(Spotted::Models::AlbumBulkRetrieveResponse)
       end
-      def list(
+      def bulk_retrieve(
         # A comma-separated list of the
         # [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the albums.
         # Maximum: 20 IDs.

data/sig/spotted/models/{album_list_params.rbs → album_bulk_retrieve_params.rbs}

@@ -1,10 +1,10 @@
 module Spotted
   module Models
-    type album_list_params =
+    type album_bulk_retrieve_params =
       { ids: String, market: String }
       & Spotted::Internal::Type::request_parameters
 
-    class AlbumListParams < Spotted::Internal::Type::BaseModel
+    class AlbumBulkRetrieveParams < Spotted::Internal::Type::BaseModel
       extend Spotted::Internal::Type::RequestParameters::Converter
       include Spotted::Internal::Type::RequestParameters
 

data/sig/spotted/models/{album_list_response.rbs → album_bulk_retrieve_response.rbs}

@@ -1,32 +1,32 @@
 module Spotted
   module Models
-    type album_list_response =
-      { albums: ::Array[Spotted::Models::AlbumListResponse::Album] }
+    type album_bulk_retrieve_response =
+      { albums: ::Array[Spotted::Models::AlbumBulkRetrieveResponse::Album] }
 
-    class AlbumListResponse < Spotted::Internal::Type::BaseModel
-      attr_accessor albums: ::Array[Spotted::Models::AlbumListResponse::Album]
+    class AlbumBulkRetrieveResponse < Spotted::Internal::Type::BaseModel
+      attr_accessor albums: ::Array[Spotted::Models::AlbumBulkRetrieveResponse::Album]
 
       def initialize: (
-        albums: ::Array[Spotted::Models::AlbumListResponse::Album]
+        albums: ::Array[Spotted::Models::AlbumBulkRetrieveResponse::Album]
       ) -> void
 
       def to_hash: -> {
-        albums: ::Array[Spotted::Models::AlbumListResponse::Album]
+        albums: ::Array[Spotted::Models::AlbumBulkRetrieveResponse::Album]
       }
 
       type album =
         {
           id: String,
-          album_type: Spotted::Models::AlbumListResponse::Album::album_type,
+          album_type: Spotted::Models::AlbumBulkRetrieveResponse::Album::album_type,
           available_markets: ::Array[String],
           external_urls: Spotted::ExternalURLObject,
           href: String,
           images: ::Array[Spotted::ImageObject],
           name: String,
           release_date: String,
-          release_date_precision: Spotted::Models::AlbumListResponse::Album::release_date_precision,
+          release_date_precision: Spotted::Models::AlbumBulkRetrieveResponse::Album::release_date_precision,
           total_tracks: Integer,
-          type: Spotted::Models::AlbumListResponse::Album::type_,
+          type: Spotted::Models::AlbumBulkRetrieveResponse::Album::type_,
           uri: String,
           artists: ::Array[Spotted::SimplifiedArtistObject],
           copyrights: ::Array[Spotted::CopyrightObject],
@@ -35,13 +35,13 @@ module Spotted
           label: String,
           popularity: Integer,
           restrictions: Spotted::AlbumRestrictionObject,
-          tracks: Spotted::Models::AlbumListResponse::Album::Tracks
+          tracks: Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks
         }
 
       class Album < Spotted::Internal::Type::BaseModel
         attr_accessor id: String
 
-        attr_accessor album_type: Spotted::Models::AlbumListResponse::Album::album_type
+        attr_accessor album_type: Spotted::Models::AlbumBulkRetrieveResponse::Album::album_type
 
         attr_accessor available_markets: ::Array[String]
 
@@ -55,11 +55,11 @@ module Spotted
 
         attr_accessor release_date: String
 
-        attr_accessor release_date_precision: Spotted::Models::AlbumListResponse::Album::release_date_precision
+        attr_accessor release_date_precision: Spotted::Models::AlbumBulkRetrieveResponse::Album::release_date_precision
 
         attr_accessor total_tracks: Integer
 
-        attr_accessor type: Spotted::Models::AlbumListResponse::Album::type_
+        attr_accessor type: Spotted::Models::AlbumBulkRetrieveResponse::Album::type_
 
         attr_accessor uri: String
 
@@ -99,24 +99,24 @@ module Spotted
           Spotted::AlbumRestrictionObject
         ) -> Spotted::AlbumRestrictionObject
 
-        attr_reader tracks: Spotted::Models::AlbumListResponse::Album::Tracks?
+        attr_reader tracks: Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks?
 
         def tracks=: (
-          Spotted::Models::AlbumListResponse::Album::Tracks
-        ) -> Spotted::Models::AlbumListResponse::Album::Tracks
+          Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks
+        ) -> Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks
 
         def initialize: (
           id: String,
-          album_type: Spotted::Models::AlbumListResponse::Album::album_type,
+          album_type: Spotted::Models::AlbumBulkRetrieveResponse::Album::album_type,
           available_markets: ::Array[String],
           external_urls: Spotted::ExternalURLObject,
           href: String,
           images: ::Array[Spotted::ImageObject],
           name: String,
           release_date: String,
-          release_date_precision: Spotted::Models::AlbumListResponse::Album::release_date_precision,
+          release_date_precision: Spotted::Models::AlbumBulkRetrieveResponse::Album::release_date_precision,
           total_tracks: Integer,
-          type: Spotted::Models::AlbumListResponse::Album::type_,
+          type: Spotted::Models::AlbumBulkRetrieveResponse::Album::type_,
           uri: String,
           ?artists: ::Array[Spotted::SimplifiedArtistObject],
           ?copyrights: ::Array[Spotted::CopyrightObject],
@@ -125,21 +125,21 @@ module Spotted
           ?label: String,
           ?popularity: Integer,
           ?restrictions: Spotted::AlbumRestrictionObject,
-          ?tracks: Spotted::Models::AlbumListResponse::Album::Tracks
+          ?tracks: Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks
         ) -> void
 
         def to_hash: -> {
           id: String,
-          album_type: Spotted::Models::AlbumListResponse::Album::album_type,
+          album_type: Spotted::Models::AlbumBulkRetrieveResponse::Album::album_type,
           available_markets: ::Array[String],
           external_urls: Spotted::ExternalURLObject,
           href: String,
           images: ::Array[Spotted::ImageObject],
           name: String,
           release_date: String,
-          release_date_precision: Spotted::Models::AlbumListResponse::Album::release_date_precision,
+          release_date_precision: Spotted::Models::AlbumBulkRetrieveResponse::Album::release_date_precision,
           total_tracks: Integer,
-          type: Spotted::Models::AlbumListResponse::Album::type_,
+          type: Spotted::Models::AlbumBulkRetrieveResponse::Album::type_,
           uri: String,
           artists: ::Array[Spotted::SimplifiedArtistObject],
           copyrights: ::Array[Spotted::CopyrightObject],
@@ -148,7 +148,7 @@ module Spotted
           label: String,
           popularity: Integer,
           restrictions: Spotted::AlbumRestrictionObject,
-          tracks: Spotted::Models::AlbumListResponse::Album::Tracks
+          tracks: Spotted::Models::AlbumBulkRetrieveResponse::Album::Tracks
         }
 
         type album_type = :album | :single | :compilation
@@ -160,7 +160,7 @@ module Spotted
           SINGLE: :single
           COMPILATION: :compilation
 
-          def self?.values: -> ::Array[Spotted::Models::AlbumListResponse::Album::album_type]
+          def self?.values: -> ::Array[Spotted::Models::AlbumBulkRetrieveResponse::Album::album_type]
         end
 
         type release_date_precision = :year | :month | :day
@@ -172,7 +172,7 @@ module Spotted
           MONTH: :month
           DAY: :day
 
-          def self?.values: -> ::Array[Spotted::Models::AlbumListResponse::Album::release_date_precision]
+          def self?.values: -> ::Array[Spotted::Models::AlbumBulkRetrieveResponse::Album::release_date_precision]
         end
 
         type type_ = :album
@@ -182,7 +182,7 @@ module Spotted
 
           ALBUM: :album
 
-          def self?.values: -> ::Array[Spotted::Models::AlbumListResponse::Album::type_]
+          def self?.values: -> ::Array[Spotted::Models::AlbumBulkRetrieveResponse::Album::type_]
         end
 
         type tracks =

data/sig/spotted/models.rbs

@@ -1,5 +1,5 @@
 module Spotted
-  class AlbumListParams = Spotted::Models::AlbumListParams
+  class AlbumBulkRetrieveParams = Spotted::Models::AlbumBulkRetrieveParams
 
   class AlbumListTracksParams = Spotted::Models::AlbumListTracksParams
 

data/sig/spotted/resources/albums.rbs

@@ -7,11 +7,11 @@ module Spotted
         ?request_options: Spotted::request_opts
       ) -> Spotted::Models::AlbumRetrieveResponse
 
-      def list: (
+      def bulk_retrieve: (
         ids: String,
         ?market: String,
         ?request_options: Spotted::request_opts
-      ) -> Spotted::Models::AlbumListResponse
+      ) -> Spotted::Models::AlbumBulkRetrieveResponse
 
       def list_tracks: (
         String id,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: spotted
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Spotted
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-04 00:00:00.000000000 Z
+date: 2025-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -57,8 +57,8 @@ files:
 - lib/spotted/internal/type/unknown.rb
 - lib/spotted/internal/util.rb
 - lib/spotted/models.rb
-- lib/spotted/models/album_list_params.rb
-- lib/spotted/models/album_list_response.rb
+- lib/spotted/models/album_bulk_retrieve_params.rb
+- lib/spotted/models/album_bulk_retrieve_response.rb
 - lib/spotted/models/album_list_tracks_params.rb
 - lib/spotted/models/album_restriction_object.rb
 - lib/spotted/models/album_retrieve_params.rb
@@ -286,8 +286,8 @@ files:
 - rbi/spotted/internal/type/unknown.rbi
 - rbi/spotted/internal/util.rbi
 - rbi/spotted/models.rbi
-- rbi/spotted/models/album_list_params.rbi
-- rbi/spotted/models/album_list_response.rbi
+- rbi/spotted/models/album_bulk_retrieve_params.rbi
+- rbi/spotted/models/album_bulk_retrieve_response.rbi
 - rbi/spotted/models/album_list_tracks_params.rbi
 - rbi/spotted/models/album_restriction_object.rbi
 - rbi/spotted/models/album_retrieve_params.rbi
@@ -514,8 +514,8 @@ files:
 - sig/spotted/internal/type/unknown.rbs
 - sig/spotted/internal/util.rbs
 - sig/spotted/models.rbs
-- sig/spotted/models/album_list_params.rbs
-- sig/spotted/models/album_list_response.rbs
+- sig/spotted/models/album_bulk_retrieve_params.rbs
+- sig/spotted/models/album_bulk_retrieve_response.rbs
 - sig/spotted/models/album_list_tracks_params.rbs
 - sig/spotted/models/album_restriction_object.rbs
 - sig/spotted/models/album_retrieve_params.rbs