sleeper_api 1.4.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c89b9383f35e517efd9ce353f9c14b1463f37375cc7dc4c30310c5c57370cdab
-  data.tar.gz: 336f7a25653bdbad75ec3094d150389fb5abba4244ef80ffbe97ce702e6a7ce9
+  metadata.gz: 0fdd2ef6194210448caf049cdd89a37182bcd13205e45ea9543945c172d36fd4
+  data.tar.gz: 811a0991f5c863956c62c637971571aef98ccd379f9a3bff4b33ad1d28405290
 SHA512:
-  metadata.gz: 49c0c6f2843e597c53cf8c8c548a348f7c03255e6a38306a8e43190523f2ad485125145e9dc844b4f6b1ea326b74286e8a26cffa34c8c8522caeb70822477f0b
-  data.tar.gz: 45c2ebd6bc9b2e9ef3cd4f5f53c6635cd00f8199f9f5da7d0061d740c99f27aa94a1894ac682d072fb542e5c0498996ba799d1ee8c094689281188befdce33f3
+  metadata.gz: 16f575a6d822157d44b7d5aef135626371e0fb03ed8359c70abf82f49bf6d9ae1373ff7a5ee49cbf4c32986593eec23e838b08e70ce5306e29d5fb3df5229be4
+  data.tar.gz: b7b325b17bfd0c9d921ec16dbaa07fdcf6f277d242732db1f414d11f0c5846664ac300c2fc64f2401a3ef54402c112b8a9e89651f986ba3628a5fdcabc38f394

data/CHANGELOG.md

@@ -1,3 +1,27 @@
+## [1.5.0] - 2026-09-25
+
+### Added
+
+- **`Client#scores(season, week = nil)` — games with their kickoff times.** Each
+  game carries `start_time`, epoch milliseconds, which is **the only kickoff
+  time Sleeper publishes**: `#schedule` has a `date` and nothing finer. Measured
+  2026-09-25 against ATL @ GB, the previous night's Thursday game — its
+  `start_time` is 2026-09-25T00:15Z and agrees with `metadata.date_time` on
+  every game of the week.
+
+  ⚠️ **Also on `api.sleeper.com`**, like `#stats_with_context`, and with a
+  different shape: the season type is a **path segment**
+  (`/scores/nfl/regular/2026/3`), and the query-parameter form answers 200 with
+  nothing.
+
+  **Leave the week off for the whole season** — all 272 games of 2026 in one
+  ~610 KB call (~93 KB gzipped), against ~57 KB a week. `metadata` is the live
+  game (`quarter`, `time_remaining`, quarter scores, `is_in_progress`) plus the
+  TV channel, spread and forecast. Its `status` vocabulary (`scheduled`,
+  `closed`) differs from the top level's (`pre_game`, `complete`), and neither
+  value a live game carries has been read yet. Nothing 404s: week 19 and a
+  garbage season type answer `[]`.
+
 ## [1.4.0] - 2026-09-14
 
 ### Added

data/CLAUDE.md

@@ -46,6 +46,11 @@ Four layers, with a deliberate split between HTTP and modeling:
   default**, because `/stats/nfl/2021/16` is a real path on both and they
   return different things; paths on `.app` quote exactly as they did before.
 
+  v1.5.0 added a second `WEB_HOST` endpoint, `#scores`, the only source of a
+  **kickoff time** — and its season type is a path segment where
+  `#stats_with_context` takes a query parameter. The host does not have one
+  convention; each path is measured on its own.
+
   **When an endpoint almost has what you need, try the other host before
   concluding the data does not exist.** Four epics of stats work in the
   consuming app never surfaced the per-week team, because the documented-looking

data/lib/sleeper_api/client.rb

@@ -340,6 +340,43 @@ module SleeperApi
       make_request("/stats/#{segments.join("/")}?season_type=#{query}", host: WEB_HOST)
     end
 
+    # Get games with their kickoff times — undocumented, on the web host.
+    #
+    # **The only kickoff time Sleeper publishes.** #schedule carries a `date`
+    # and nothing finer; each game here has `start_time`, epoch milliseconds —
+    # 2026's Thursday opener of week 3, ATL @ GB, is 1790295300000, which is
+    # 2026-09-25T00:15Z and agrees with `metadata.date_time` on every game.
+    # Measured 2026-09-25, the morning after that game.
+    #
+    # `metadata` is the live game: `quarter`, `time_remaining`, the score by
+    # quarter, `is_in_progress`, `is_over`, plus the TV `channel`, the spread and
+    # a forecast. Its `status` is a different vocabulary from the top level's —
+    # `scheduled`/`closed` against `pre_game`/`complete` — and neither value a
+    # live game carries has been read here yet. Match with a fallback.
+    #
+    # **Leave the week off for the whole season** — all 272 games of 2026 in one
+    # call, ~610 KB (~93 KB gzipped), against ~57 KB a week. Unlike
+    # #stats_with_context, the season form is useful.
+    #
+    # The season type is a **path segment**, not a query parameter —
+    # `/scores/nfl/2026/3?season_type=regular` answers 200 with nothing. Shares
+    # the host's traps: nothing 404s (week 19, a garbage season type all answer
+    # `200` with `[]`), and `pre`/`post` restart week numbering.
+    #
+    # @param season [Integer, String] Season year, e.g. 2026
+    # @param week [Integer, String, nil] Week number; nil for the whole season
+    # @param season_type [String] "regular" (default), "pre", or "post"
+    # @param sport [String] Sport code (default: "nfl")
+    # @return [HTTParty::Response] Array of games, each with `game_id`, `week`,
+    #   `status`, `start_time`, `date` and a nested `metadata`
+    def scores(season, week = nil, season_type: "regular", sport: "nfl")
+      segments = [sport, season_type, season, week].compact.map do |segment|
+        ERB::Util.url_encode(segment.to_s)
+      end
+
+      make_request("/scores/#{segments.join("/")}", host: WEB_HOST)
+    end
+
     # Get a season's game schedule.
     #
     # Undocumented, and served from the host root rather than /v1 — hence the

data/lib/sleeper_api/version.rb

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

metadata

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