jumbotron 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 727d9ee2cecff54934b335484762a677ebfa7ee2bfe4a7f7dc408e04b0f7f6b0
-  data.tar.gz: 3c16c45a725c58a7fc654172819752a9c4e69fd06f554353f51c8e127feb7eca
+  metadata.gz: 48040072e10a2363780b93b40c36c51e00683c247d616ae4cf8e0b245cca1815
+  data.tar.gz: 56fdebbcc73ab653ebf1293d7bc718bece9c24e035552e10a402d3d0cf4a34a2
 SHA512:
-  metadata.gz: c7334f554705bccc4937c73975a77defce7bf08f0aeb23d984652eaa05cc4e43ddcecb0d1f3414a25f0e970f0dc34573e0adbbfdbc489252aeee6156b2e69a78
-  data.tar.gz: a02bd5b23d138019d874124ac178652a8a8a936e238a1d1d9f2d54939903d03ea26accda1e72c90ba6899652f0fe41c73fd9593377b8b01ed0a8ef9889fb3654
+  metadata.gz: 22e5abd65bafd78af1bb38568088c5c7180321e28dc527cd8dec35ea61300d55f789a3e8723d35f3df00ddc3ef3ae7bddd8bbb7e6a4e1aac256eb0665bf24275
+  data.tar.gz: 3deca6bd03bb5f95ddb485306ebd68fb33ced87215df67002a19f84f383ba748182d437d0581fa065043fe44bc60d605f2773af70a85884a596ab44c82a4d9ab

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Jumbotron
+  module Deserializers
+    module Public
+      class SandboxProjection < CommandTower::Deserializers::ApplicationDeserializer
+        def call(params)
+          name = unwrap(fetch_param(params, :name))
+          return name if deserializer_result?(name)
+          return failure(errors: [{ code: "invalid_request", message: "name is required" }]) if name.blank?
+
+          success(Jumbotron::Public::SandboxProjectionRequest.new(name: name.to_s))
+        end
+      end
+    end
+  end
+end

data/app/models/jumbotron/public.rb

@@ -13,7 +13,8 @@ module Jumbotron
     SandboxScheduleSelector = Data.define(:sport, :league, :season, :season_phase)
     RegisterSandboxProjectionRequest = Data.define(:name, :source)
     ResetSandboxProjectionRequest = Data.define(:sandbox, :start_week, :anchor_day, :now)
-    SandboxProjection = Data.define(:name, :source, :sandbox)
+    SandboxProjectionRequest = Data.define(:name)
+    SandboxProjection = Data.define(:name, :source_label, :source, :sandbox)
     SandboxProjectionReset = Data.define(
       :projection,
       :source_anchor_date,

data/app/services/jumbotron/services/public/assemble_sandbox_projection.rb

@@ -9,6 +9,7 @@ module Jumbotron
         def call
           context.public_projection = Jumbotron::Public::SandboxProjection.new(
             name: projection.name,
+            source_label: source_label,
             source: selector(projection.source_season, projection.source_anchor_phase.name),
             sandbox: selector(projection.sandbox_season, projection.source_anchor_phase.name)
           )
@@ -16,6 +17,14 @@ module Jumbotron
 
         private
 
+        def source_label
+          [
+            projection.source_season.league.name.upcase,
+            projection.source_season.name,
+            projection.source_anchor_phase.name.titleize
+          ].join(" ")
+        end
+
         def selector(season, phase_name)
           Jumbotron::Public::SandboxScheduleSelector.new(
             sport: season.league.sport.name,

data/app/services/jumbotron/services/public/assemble_sandbox_projection_reset.rb

@@ -30,11 +30,20 @@ module Jumbotron
         def projection_identity
           Jumbotron::Public::SandboxProjection.new(
             name: projection.name,
+            source_label: source_label,
             source: selector(projection.source_season, projection.source_anchor_phase.name),
             sandbox: selector(projection.sandbox_season, projection.source_anchor_phase.name)
           )
         end
 
+        def source_label
+          [
+            projection.source_season.league.name.upcase,
+            projection.source_season.name,
+            projection.source_anchor_phase.name.titleize
+          ].join(" ")
+        end
+
         def selector(season, phase_name)
           Jumbotron::Public::SandboxScheduleSelector.new(
             sport: season.league.sport.name,

data/app/services/jumbotron/services/public/read_sandbox_projection.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Jumbotron
+  module Services
+    module Public
+      class ReadSandboxProjection < CommandTower::Services::ApplicationService
+        validate :name, required: true
+
+        def call
+          projection = Jumbotron::SandboxProjection.includes(
+            :source_anchor_phase,
+            source_season: { league: :sport },
+            sandbox_season: { league: :sport }
+          ).find_by(name:)
+          return reject if projection.nil?
+
+          context.projection = projection
+        end
+
+        private
+
+        def reject
+          context.fail!(
+            application_error: Jumbotron::Errors::Public::NotFoundError.new(
+              details: { code: "sandbox_not_found", message: "sandbox projection was not found" }
+            )
+          )
+        end
+      end
+    end
+  end
+end

data/app/workflows/jumbotron/workflows/sandbox/read_projection_workflow.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Jumbotron
+  module Workflows
+    module Sandbox
+      class ReadProjectionWorkflow < CommandTower::Workflows::ApplicationWorkflow
+        include Jumbotron::Workflows::PublicRead
+
+        retry_strategy :none
+
+        def call(**kwargs)
+          deserialized = Jumbotron::Deserializers::Public::SandboxProjection.call(kwargs)
+          return map_deserializer_failure(deserialized) unless deserialized.success?
+
+          read = Jumbotron::Services::Public::ReadSandboxProjection.call(name: deserialized.input.name)
+          return map_service_failure(read) unless read.success?
+
+          assembled = Jumbotron::Services::Public::AssembleSandboxProjection.call(
+            projection: read.data[:projection]
+          )
+          return map_service_failure(assembled) unless assembled.success?
+
+          success(payload: { sandbox_projection: assembled.data[:public_projection] }, http_status: :ok)
+        end
+      end
+    end
+  end
+end

data/docs/upgrades/0.3.0.md

@@ -0,0 +1,31 @@
+# Upgrade: Jumbotron 0.3.0
+
+**From:** `0.2.0`  
+**To:** `0.3.0`
+
+Minor release: additive public read access for named sandbox projections and stable source labeling for host administration.
+
+## Host-facing change
+
+| Change | Host impact |
+|--------|-------------|
+| `Jumbotron.client.sandbox_projection` | Reads a named sandbox projection through the public workflow/client boundary without exposing persistence. Unknown names return the existing structured public failure contract. |
+| `SandboxProjection#source_label` | Public projection DTOs, including register/Reset results, now include a host-ready source label such as `NFL 2026 Regular Season`. |
+| Public read validation | Named projection reads use the same deserializer/service/workflow architecture as existing public operations. |
+
+## Upgrade checklist
+
+1. Bump the gem to `0.3.0` (or `>= 0.3.0`).
+2. No new migration. Hosts already on `0.2.0` do not need to copy or run Jumbotron migrations for this release.
+3. Hosts may read the configured source before offering a destructive Reset:
+
+   ```ruby
+   projection = Jumbotron.client.sandbox_projection(name: "nfl-sandbox")
+   projection.source_label
+   ```
+
+## What is not in this release
+
+- No sandbox projection or Reset persistence change.
+- No ESPN public Game/Schedule/Consensus/CurrentLines contract change.
+- No Pick'em administration UI or competitive-domain behavior.

data/lib/jumbotron/client.rb

@@ -2,6 +2,13 @@
 
 module Jumbotron
   class Client
+    def sandbox_projection(**)
+      Public::TranslateOutcome.call(
+        Workflows::Sandbox::ReadProjectionWorkflow.call(**),
+        payload_key: :sandbox_projection
+      )
+    end
+
     def register_sandbox_projection(**)
       Public::TranslateOutcome.call(
         Workflows::Sandbox::RegisterProjectionWorkflow.call(**),

data/lib/jumbotron/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jumbotron
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - matt-taylor
@@ -133,6 +133,7 @@ files:
 - 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
+- app/deserializers/jumbotron/deserializers/public/sandbox_projection.rb
 - app/deserializers/jumbotron/deserializers/public/schedule.rb
 - app/deserializers/jumbotron/deserializers/public/schedule_groups.rb
 - app/errors/jumbotron/error.rb
@@ -227,6 +228,7 @@ files:
 - app/services/jumbotron/services/public/map_public_consensus_lines.rb
 - app/services/jumbotron/services/public/map_public_current_lines.rb
 - app/services/jumbotron/services/public/read_game.rb
+- app/services/jumbotron/services/public/read_sandbox_projection.rb
 - app/services/jumbotron/services/public/read_schedule.rb
 - app/services/jumbotron/services/public/read_schedule_groups.rb
 - app/services/jumbotron/services/public/resolve_current_lines_for_games.rb
@@ -249,6 +251,7 @@ files:
 - app/workflows/jumbotron/workflows/read_game_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
 - app/workflows/jumbotron/workflows/sandbox/register_projection_workflow.rb
 - app/workflows/jumbotron/workflows/sandbox/reset_projection_workflow.rb
 - app/workflows/jumbotron/workflows/synchronize_adapter_workflow.rb
@@ -269,6 +272,7 @@ files:
 - docs/upgrades/0.1.3.md
 - docs/upgrades/0.1.4.md
 - docs/upgrades/0.2.0.md
+- docs/upgrades/0.3.0.md
 - lib/jumbotron.rb
 - lib/jumbotron/client.rb
 - lib/jumbotron/engine.rb