sleeper_api 1.8.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da00a42dc3d3fa73feab8e1c2278f0cdcf7a274b12709c540c2f988782828269
-  data.tar.gz: 8b2fc35f6dd3a3b546cafae1679ac0dbca75193d7886fcb12b57c5bf616da667
+  metadata.gz: ea2a84bc8be057968c5822116b20f53d1dac11550c8baf70d437fab4d72b427a
+  data.tar.gz: 3c518c6191fc0e117229a10d9ae5f7d1a04d4f8dc62db53c52e8d6af99e6a635
 SHA512:
-  metadata.gz: c953ad4e95e986db6ef5f6f559a7cf464a9cdeaf98ccf83e4cb25f1e99008152066e5b15ad7b852de444a13fafd81b795d6b338b5ced2cebe3e9710223aa966a
-  data.tar.gz: 4ccdabb09c1bd25a39e7f32ce6cd97c58b5237b8c18f9a030aa3d9307f26b0f736cd63cf6f3f9cfb6381305aa0f9b0b8cc038431f06bd52d37f3c74bb5edb75d
+  metadata.gz: 5e248beba16cf5d2ebba74570ce4856ddcefa4fa95a8c118e685d2e89ca57eea31268c848bcfc59501b25f40d0bb08bfd8c4f65d4f9f2129f799b5f8d829c053
+  data.tar.gz: 060bef1860b827761fdcbfc38e65e0a0a5ec4b1abb6da4e2e52d43416a400e3c574135ed4001363049728cf47f34d64e13465f9cfc00067f1c1ab03cb770e076

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+## [1.9.0] - 2026-10-09
+
+### Added
+
+- **`avatar_url(thumb: true)`** on `User` and `League` returns
+  `sleepercdn.com/avatars/thumbs/{id}`: 19 KB of PNG where the full size was
+  2.2 MB of `application/octet-stream` (measured 2026-10-09). The default is
+  unchanged.
+- **`sport:` on `User#leagues`, `#rosters`, `#drafts` and `#summary`**, default
+  `"nfl"`, passed through to the client, which already took it. Each sport is
+  cached apart. Sleeper answers an unknown sport with `200` and `[]` (measured
+  2026-10-09), so a typo reads as "no leagues"; it is not checked against a list.
+- **`League#traded_picks`**, with `Draft#traded_picks`' three filters
+  (`original_owner_id:`, `previous_owner_id:`, `current_owner_id:`). `season`
+  stays the string Sleeper sends.
+- **`League#drafts`**, as symbol-keyed hashes rather than `Draft` objects, since
+  a `Draft` fetches on construction.
+
 ## [1.8.0] - 2026-10-02
 
 ### Added

data/README.md

@@ -76,6 +76,7 @@ user = SleeperApi.client.user('johndoe')
 user.username                  # => "johndoe"
 user.display_name              # => "John Doe"
 user.avatar_url                # => "https://sleepercdn.com/avatars/abc123"
+user.avatar_url(thumb: true)   # => "https://sleepercdn.com/avatars/thumbs/abc123"
 user.is_bot                    # => false
 
 # All leagues for current season
@@ -89,6 +90,9 @@ end
 old_leagues = user.leagues(2023)
 championships = old_leagues.select { |l| l[:status] == "finished" }
 
+# Another sport (default "nfl"). An unknown sport answers [] rather than an error.
+basketball = user.leagues(2026, sport: "nba")
+
 # Get all my rosters across all leagues
 rosters = user.rosters
 rosters.each do |roster|
@@ -129,6 +133,7 @@ league.season                  # => "2024"
 league.total_rosters           # => 12
 league.status                  # => "regular"
 league.avatar_url              # => "https://sleepercdn.com/avatars/abc123"
+league.avatar_url(thumb: true) # => "https://sleepercdn.com/avatars/thumbs/abc123"
 
 # Formatted rosters (with team names and records)
 rosters = league.rosters
@@ -176,6 +181,13 @@ toilet_bowl_matchups = league.toilet_bowl
 matchup = toilet_bowl_matchups.first
 matchup[:team1_owner]          # => "Team Beta"
 matchup[:winner_owner]         # => "Team Beta"
+
+# Traded picks (only picks that moved), with the same filters as Draft#traded_picks
+picks = league.traded_picks(current_owner_id: 8)
+picks.first                    # => { season: "2027", round: 1, roster_id: 1, previous_owner_id: 1, owner_id: 8 }
+
+# Drafts, as hashes; open one with SleeperApi.client.draft(id)
+league.drafts.map { |d| d[:status] } # => ["complete"]
 ```
 
 ### Drafts

data/lib/sleeper_api/league.rb

@@ -30,6 +30,8 @@ module SleeperApi
       @transactions = nil
       @playoff_bracket = nil
       @toilet_bowl = nil
+      @traded_picks = nil
+      @drafts = nil
 
       fetch_league_data unless no_data
     end
@@ -43,9 +45,15 @@ module SleeperApi
 
     # Generate avatar URL from ID.
     #
-    # @return [String, nil] Full avatar URL or nil if no avatar
-    def avatar_url
-      avatar ? "https://sleepercdn.com/avatars/#{avatar}" : nil
+    # The full size was 2.2 MB of `application/octet-stream` and the thumbnail
+    # 19 KB of PNG, measured 2026-10-09; a list of avatars wants the thumbnail.
+    #
+    # @param thumb [Boolean] The thumbnail instead of the full-size image
+    # @return [String, nil] Avatar URL or nil if no avatar
+    def avatar_url(thumb: false)
+      return nil unless avatar
+
+      thumb ? "https://sleepercdn.com/avatars/thumbs/#{avatar}" : "https://sleepercdn.com/avatars/#{avatar}"
     end
 
     # Get the reigning champion's roster.
@@ -172,8 +180,38 @@ module SleeperApi
       @toilet_bowl
     end
 
+    # Get the league's traded draft picks, as Sleeper sends them.
+    #
+    # `season` is a string ("2027"); every owner is a roster id. A pick that
+    # never moved is not listed.
+    #
+    # @param original_owner_id [Integer, nil] Filter by the roster the pick began with
+    # @param previous_owner_id [Integer, nil] Filter by previous owner
+    # @param current_owner_id [Integer, nil] Filter by current owner
+    # @return [Array<Hash>] Traded picks, symbol-keyed
+    def traded_picks(original_owner_id: nil, previous_owner_id: nil, current_owner_id: nil)
+      fetch_traded_picks unless @traded_picks
+      picks = @traded_picks
+      picks = picks.select { |pick| pick[:roster_id] == original_owner_id } if original_owner_id
+      picks = picks.select { |pick| pick[:previous_owner_id] == previous_owner_id } if previous_owner_id
+      picks = picks.select { |pick| pick[:owner_id] == current_owner_id } if current_owner_id
+      picks
+    end
+
+    # Get the league's drafts. Hashes rather than `Draft` objects, because a
+    # `Draft` fetches on construction: `client.draft(id)` opens one.
+    #
+    # @return [Array<Hash>] Drafts, symbol-keyed
+    def drafts
+      @drafts ||= (@client.get_league_drafts(@league_id) || []).map { |draft| deep_symbolize_keys(draft) }
+    end
+
     private
 
+    def fetch_traded_picks
+      @traded_picks ||= (@client.get_league_traded_picks(@league_id) || []).map { |pick| deep_symbolize_keys(pick) }
+    end
+
     def fetch_league_data
       @league_data ||= @client.get_league(@league_id)
     end

data/lib/sleeper_api/user.rb

@@ -39,31 +39,40 @@ module SleeperApi
 
     # Generate avatar URL from ID.
     #
-    # @return [String, nil] Full avatar URL or nil if no avatar
-    def avatar_url
-      avatar ? "https://sleepercdn.com/avatars/#{avatar}" : nil
+    # The full size was 2.2 MB of `application/octet-stream` and the thumbnail
+    # 19 KB of PNG, measured 2026-10-09; a list of avatars wants the thumbnail.
+    #
+    # @param thumb [Boolean] The thumbnail instead of the full-size image
+    # @return [String, nil] Avatar URL or nil if no avatar
+    def avatar_url(thumb: false)
+      return nil unless avatar
+
+      thumb ? "https://sleepercdn.com/avatars/thumbs/#{avatar}" : "https://sleepercdn.com/avatars/#{avatar}"
     end
 
     # Get all leagues for a specific season.
     #
     # @param season [Integer] Season year (default: current year)
+    # @param sport [String] Sport code (default: "nfl"). An unknown one answers
+    #   200 with [] (measured 2026-10-09), so a typo reads as "no leagues".
     # @return [Array<Hash>] Formatted league objects
     # @raise [ArgumentError] If season is not an integer
-    def leagues(season = Time.now.year)
+    def leagues(season = Time.now.year, sport: "nfl")
       raise ArgumentError, "season must be a valid year" unless season.is_a?(Integer)
 
-      fetch_leagues(season)
+      fetch_leagues(season, sport)
     end
 
     # Get all rosters for this user across all leagues in a season.
     #
     # @param season [Integer] Season year (default: current year)
+    # @param sport [String] Sport code (default: "nfl")
     # @return [Array<Hash>] Formatted roster objects from all leagues
     # @raise [ArgumentError] If season is not an integer
-    def rosters(season = Time.now.year)
+    def rosters(season = Time.now.year, sport: "nfl")
       raise ArgumentError, "season must be a valid year" unless season.is_a?(Integer)
 
-      fetch_leagues(season).flat_map do |league|
+      fetch_leagues(season, sport).flat_map do |league|
         league_instance = League.new(league[:league_id], @client, no_data: true)
         league_instance.rosters(user_id: @user_id)
       end
@@ -72,21 +81,23 @@ module SleeperApi
     # Get all drafts for a specific season with enhanced metadata.
     #
     # @param season [Integer] Season year (default: current year)
+    # @param sport [String] Sport code (default: "nfl")
     # @return [Array<Hash>] Formatted draft objects with league info
     # @raise [ArgumentError] If season is not an integer
-    def drafts(season = Time.now.year)
+    def drafts(season = Time.now.year, sport: "nfl")
       raise ArgumentError, "season must be a valid year" unless season.is_a?(Integer)
 
-      format_drafts(fetch_drafts(season))
+      format_drafts(fetch_drafts(season, sport))
     end
 
     # Get a summary of user's league participation.
     #
     # @param season [Integer] Season year (default: current year)
+    # @param sport [String] Sport code (default: "nfl")
     # @return [Hash] Summary statistics
-    def summary(season = Time.now.year)
-      leagues_data = leagues(season)
-      rosters_data = rosters(season)
+    def summary(season = Time.now.year, sport: "nfl")
+      leagues_data = leagues(season, sport: sport)
+      rosters_data = rosters(season, sport: sport)
 
       {
         season: season,
@@ -113,14 +124,15 @@ module SleeperApi
       @user_data ||= @client.get_user(@identifier)
     end
 
-    def fetch_leagues(season)
-      @leagues[season] ||= (@client.get_user_leagues(@user_id, season: season) || []).map do |league|
+    # Keyed on the sport too, or one sport's answer would serve the other's.
+    def fetch_leagues(season, sport)
+      @leagues[[sport, season]] ||= (@client.get_user_leagues(@user_id, sport: sport, season: season) || []).map do |league|
         deep_symbolize_keys(league)
       end
     end
 
-    def fetch_drafts(season)
-      @drafts[season] ||= (@client.get_user_drafts(@user_id, season: season) || []).map do |draft|
+    def fetch_drafts(season, sport)
+      @drafts[[sport, season]] ||= (@client.get_user_drafts(@user_id, sport: sport, season: season) || []).map do |draft|
         deep_symbolize_keys(draft)
       end
     end

data/lib/sleeper_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SleeperApi
-  VERSION = "1.8.0"
+  VERSION = "1.9.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sleeper_api
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Eruity1