jumbotron 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48040072e10a2363780b93b40c36c51e00683c247d616ae4cf8e0b245cca1815
-  data.tar.gz: 56fdebbcc73ab653ebf1293d7bc718bece9c24e035552e10a402d3d0cf4a34a2
+  metadata.gz: 71a38ed750f1392e528a1039b2dd5cb33383581951da87f8261602d8fc20618c
+  data.tar.gz: b4d80cc8bbeeb0260f133838dd53d48f92315515be6f7e860e8c0ffb3d8526cd
 SHA512:
-  metadata.gz: 22e5abd65bafd78af1bb38568088c5c7180321e28dc527cd8dec35ea61300d55f789a3e8723d35f3df00ddc3ef3ae7bddd8bbb7e6a4e1aac256eb0665bf24275
-  data.tar.gz: 3deca6bd03bb5f95ddb485306ebd68fb33ced87215df67002a19f84f383ba748182d437d0581fa065043fe44bc60d605f2773af70a85884a596ab44c82a4d9ab
+  metadata.gz: 9b5cdcb6ff223603581417cb047916d47675843b2758305240539dd596be15b20be07bf2c8056d4c46bb683b69bc3554f7b28f29e98f3cf4affbab401eddc6b4
+  data.tar.gz: '09e5f5b8f0edd4eae5c12a6443841193ad669d87736ac360cc63c37e1c5f02b0aa40eeeda25a224f7c1b45884602f721464bfb7b312b65667700a00869c61939'

data/app/adapters/jumbotron/adapters/espn/nfl.rb

@@ -51,7 +51,7 @@ module Jumbotron
 
         policy :live,
                type: :live_game_update,
-               cadence: Cadence.new(every: 1, unit: :minute),
+               cadence: Cadence.new(every: 30, unit: :second),
                eligible: lambda { |game, now:|
                  return false if TERMINAL_LIFECYCLES.include?(game.lifecycle)
                  return false if INTERRUPTED_LIFECYCLES.include?(game.lifecycle)

data/app/adapters/jumbotron/adapters/sandbox/nfl.rb

@@ -48,7 +48,7 @@ module Jumbotron
 
         policy :live,
                type: :live_game_update,
-               cadence: Cadence.new(every: 1, unit: :minute),
+               cadence: Cadence.new(every: 30, unit: :second),
                eligible: lambda { |game, now:|
                  return false if TERMINAL_LIFECYCLES.include?(game.lifecycle)
                  return false if INTERRUPTED_LIFECYCLES.include?(game.lifecycle)

data/app/deserializers/jumbotron/deserializers/public/games.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Jumbotron
+  module Deserializers
+    module Public
+      class Games < CommandTower::Deserializers::ApplicationDeserializer
+        def call(params)
+          raw = unwrap(fetch_param(params, :game_ids))
+          return raw if deserializer_result?(raw)
+          return failure(errors: [{ code: "invalid_request", message: "game_ids is required" }]) if raw.nil?
+          unless raw.is_a?(Array)
+            return failure(errors: [{ code: "invalid_request", message: "game_ids must be an array" }])
+          end
+
+          if raw.size > Jumbotron::Public::MAX_GAMES_IDS
+            return failure(
+              errors: [{
+                code: "invalid_request",
+                message: "game_ids exceeds maximum of #{Jumbotron::Public::MAX_GAMES_IDS}"
+              }]
+            )
+          end
+
+          ids = []
+          raw.each do |item|
+            coerced = unwrap(require_integer(item, field: "game_ids", min: 1))
+            return coerced if deserializer_result?(coerced)
+
+            ids << coerced
+          end
+
+          include_raw = unwrap(fetch_param(params, :include))
+          return include_raw if deserializer_result?(include_raw)
+
+          includes = unwrap(Includes.parse(include_raw))
+          return includes if deserializer_result?(includes)
+
+          success(Jumbotron::Public::GamesRequest.new(game_ids: ids.uniq, includes: includes))
+        end
+      end
+    end
+  end
+end

data/app/models/jumbotron/public.rb

@@ -101,6 +101,10 @@ module Jumbotron
     )
     GameRequest = Data.define(:id, :includes)
     GameIdsRequest = Data.define(:game_ids)
+    # Bulk Game read — game_ids + optional includes (parity with #game / #schedule).
+    # Distinct from GameIdsRequest so consensus/current_lines stay include-free.
+    GamesRequest = Data.define(:game_ids, :includes)
+    MAX_GAMES_IDS = 64
     ScheduleRequest = Data.define(
       :league_id,
       :sport,

data/app/scheduling/jumbotron/scheduling/backends/sidekiq_cron.rb

@@ -10,8 +10,9 @@ module Jumbotron
 
         def materialize(schedules, **)
           klass = job_class
-          remove_stale(klass, schedules)
-          upsert_desired(klass, schedules)
+          applicable = sidekiq_expressible(schedules)
+          remove_stale(klass, applicable)
+          upsert_desired(klass, applicable)
         end
 
         def cron_string(cadence)
@@ -20,6 +21,15 @@ module Jumbotron
 
         private
 
+        # Five-field cron cannot express sub-minute cadences (Solid Queue / fugit can).
+        def sidekiq_expressible(schedules)
+          schedules.reject { |definition| second_unit?(definition.cadence.unit) }
+        end
+
+        def second_unit?(unit)
+          Clock.canonical_unit(unit) == :second
+        end
+
         def remove_stale(klass, schedules)
           desired_ids = schedules.map(&:id)
           Array(klass.all).each do |job|

data/app/workflows/jumbotron/workflows/read_games_workflow.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Jumbotron
+  module Workflows
+    class ReadGamesWorkflow < CommandTower::Workflows::ApplicationWorkflow
+      include PublicRead
+
+      retry_strategy :none
+
+      def call(**kwargs)
+        deserialized = Deserializers::Public::Games.call(kwargs)
+        return map_deserializer_failure(deserialized) unless deserialized.success?
+
+        request = deserialized.input
+        loaded = Services::Public::LoadGamesByIds.call(game_ids: request.game_ids)
+        return map_service_failure(loaded) unless loaded.success?
+
+        games = Array(loaded.data[:games])
+        included = Services::Public::LoadIncludedLines.call(games: games, includes: request.includes)
+        return map_service_failure(included) unless included.success?
+
+        public_games = games.map do |game|
+          assembled = Services::Public::AssemblePublicGame.call(
+            game: game,
+            includes: request.includes,
+            current_lines: included.data[:current_lines],
+            consensus_lines: included.data[:consensus_lines]
+          )
+          return map_service_failure(assembled) unless assembled.success?
+
+          assembled.data[:public_game]
+        end
+
+        success(payload: { games: public_games }, http_status: :ok)
+      end
+    end
+  end
+end

data/docs/upgrades/0.4.0.md

@@ -0,0 +1,31 @@
+# Upgrade: Jumbotron 0.4.0
+
+**From:** `0.3.0`  
+**To:** `0.4.0`
+
+Minor release: adds a bulk public Game read, tightens live-game polling cadence to 30 seconds, and keeps the Sidekiq Cron scheduling backend safe for sub-minute cadences.
+
+## Host-facing change
+
+| Change | Host impact |
+|--------|-------------|
+| `Jumbotron.client.games(game_ids:, include:)` | Bulk public Game read (parity with `#game` / `#schedule`). Accepts up to 64 `game_ids`, dedupes and preserves request order, silently omits unknown ids, and composes `current_lines` / `consensus_lines` through the same `include` contract as other public reads. Requesting more than 64 ids raises `Jumbotron::InvalidRequestError`. |
+| ESPN and Sandbox `:live` adapter cadence | Live-game polling moved from every 1 minute to every 30 seconds. Hosts running the ESPN or Sandbox NFL adapters will see more frequent live-update scheduling. |
+| Sidekiq Cron scheduling backend | Sub-minute (`:second`) cadences are now excluded from the five-field cron materialization (five-field cron cannot express sub-minute schedules). Hosts on the Sidekiq Cron backend for a 30-second-cadence adapter must run the Solid Queue backend (or another cadence-aware backend) for that schedule to actually fire; Sidekiq Cron silently skips it rather than erroring. |
+
+## Upgrade checklist
+
+1. Bump the gem to `0.4.0` (or `>= 0.4.0`).
+2. No new migration. Hosts already on `0.3.0` do not need to copy or run Jumbotron migrations for this release.
+3. Hosts using the Sidekiq Cron scheduling backend with the ESPN or Sandbox NFL adapter should confirm their live-game schedule is served by a backend that supports sub-minute cadence (e.g. Solid Queue), since Sidekiq Cron now omits it rather than materializing an incorrect once-per-minute job.
+4. Hosts may call the new bulk read directly:
+
+   ```ruby
+   games = Jumbotron.client.games(game_ids: [101, 102, 103], include: [:consensus])
+   ```
+
+## What is not in this release
+
+- No sandbox projection or Reset persistence change.
+- No ESPN public Schedule/CurrentLines contract change beyond the `:live` cadence value.
+- No Pick'em administration UI or competitive-domain behavior.

data/lib/jumbotron/client.rb

@@ -44,6 +44,13 @@ module Jumbotron
       )
     end
 
+    def games(**)
+      Public::TranslateOutcome.call(
+        Workflows::ReadGamesWorkflow.call(**),
+        payload_key: :games
+      )
+    end
+
     def consensus(**)
       Public::TranslateOutcome.call(
         Workflows::ReadConsensusWorkflow.call(**),

data/lib/jumbotron/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jumbotron
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - matt-taylor
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-09-09 00:00:00.000000000 Z
+date: 2026-09-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: command_tower
@@ -130,6 +130,7 @@ files:
 - app/deserializers/jumbotron/deserializers/clients/espn/week.rb
 - app/deserializers/jumbotron/deserializers/public/game.rb
 - app/deserializers/jumbotron/deserializers/public/game_ids.rb
+- app/deserializers/jumbotron/deserializers/public/games.rb
 - app/deserializers/jumbotron/deserializers/public/includes.rb
 - app/deserializers/jumbotron/deserializers/public/register_sandbox_projection.rb
 - app/deserializers/jumbotron/deserializers/public/reset_sandbox_projection.rb
@@ -249,6 +250,7 @@ files:
 - app/workflows/jumbotron/workflows/read_consensus_workflow.rb
 - app/workflows/jumbotron/workflows/read_current_lines_workflow.rb
 - app/workflows/jumbotron/workflows/read_game_workflow.rb
+- app/workflows/jumbotron/workflows/read_games_workflow.rb
 - app/workflows/jumbotron/workflows/read_schedule_groups_workflow.rb
 - app/workflows/jumbotron/workflows/read_schedule_workflow.rb
 - app/workflows/jumbotron/workflows/sandbox/read_projection_workflow.rb
@@ -273,6 +275,7 @@ files:
 - docs/upgrades/0.1.4.md
 - docs/upgrades/0.2.0.md
 - docs/upgrades/0.3.0.md
+- docs/upgrades/0.4.0.md
 - lib/jumbotron.rb
 - lib/jumbotron/client.rb
 - lib/jumbotron/engine.rb