jumbotron 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31fa4d11ab93d13b5e6db4ab799f05f69b6153067ceb0894677e07bd785c27a3
-  data.tar.gz: 2f660fdbdf85bb67f9212c6c8c55b6bc9f49a2699c643070a5496946d8894259
+  metadata.gz: 02e887f5ad4260dddda6dde8d391430ffbad31b7b7069dd851e9560cd6f92540
+  data.tar.gz: 1a18545151d81f504bc9bf208316ff2b1cf68086f062cf590d0953f9ca28e546
 SHA512:
-  metadata.gz: ee10748cd68f85baa4c3774ef6f7fbcd4c6376f76927a442a8e4ce1b4e28e34c56f7c6355af29545ba1306f7367e37499a56dbdb00f990e413aea020cf37079e
-  data.tar.gz: 30e89a701a8dc935ac6d0d4aeffc61d982b6a800d97f86ac43035a23d4ac480bd60485c6c8e96093eaef022b128693ccf0b663b63716dab53385bce0e79ea174
+  metadata.gz: c20c23af5c011df7a9ea866a1923e37abf79b3eea2dfe82e47b561051f3ba6bc43dfb519def7288007e71c7a801020e9d5b32f3d2a76be82c6b85061c2f9bbe1
+  data.tar.gz: 5414a02d268f32a257752bc29e47b959c46a0dc9b6d680da58c789ff22bd6d76a56a4c264a0068bc32f91aef79a40827b4568a731807dedfcf975966a452d63c

data/app/adapters/jumbotron/adapters/espn/nfl_helpers/scoreboard.rb

@@ -103,6 +103,7 @@ module Jumbotron
                 Canonical::ProviderIdentityRef.new(provider: "espn", namespace: "team", id: team.id.to_s)
               ],
               team_name: name.to_s,
+              team_nickname: TeamNickname.resolve(team),
               role: competitor.home_away.to_s,
               score: coerce_score(competitor.score),
               result: coerce_result(competitor.winner, lifecycle)

data/app/adapters/jumbotron/adapters/espn/nfl_helpers/team_nickname.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Jumbotron
+  module Adapters
+    module Espn
+      module NflHelpers
+        # Maps ESPN team identity fields into canonical nickname without parsing display_name.
+        # Precedence: nickname → name → short_display_name (provider fields only).
+        module TeamNickname
+          def self.resolve(team)
+            return nil if team.nil?
+
+            team.nickname.presence || team.name.presence || team.short_display_name.presence
+          end
+        end
+      end
+    end
+  end
+end

data/app/adapters/jumbotron/adapters/espn/nfl_helpers/teams.rb

@@ -24,7 +24,8 @@ module Jumbotron
               provider_identities: [
                 Canonical::ProviderIdentityRef.new(provider: "espn", namespace: "team", id: team.id.to_s)
               ],
-              name: name.to_s
+              name: name.to_s,
+              nickname: TeamNickname.resolve(team)
             )
           end
           private_class_method :transform_team

data/app/deserializers/jumbotron/deserializers/clients/espn/team.rb

@@ -12,6 +12,7 @@ module Jumbotron
             field :display_name, type: Support.types.string, required: true
             field :short_display_name, type: Support.types.string, nullable: true
             field :name, type: Support.types.string, nullable: true
+            field :nickname, type: Support.types.string, nullable: true
             field :location, type: Support.types.string, nullable: true
           end
 
@@ -25,6 +26,7 @@ module Jumbotron
               display_name: Support.payload.fetch(payload, "displayName"),
               short_display_name: Support.payload.fetch(payload, "shortDisplayName"),
               name: Support.payload.fetch(payload, "name"),
+              nickname: Support.payload.fetch(payload, "nickname"),
               location: Support.payload.fetch(payload, "location")
             )
           end

data/app/models/jumbotron/canonical.rb

@@ -4,7 +4,11 @@ module Jumbotron
   module Canonical
     ProviderIdentityRef = Data.define(:provider, :namespace, :id)
 
-    TeamInput = Data.define(:provider_identities, :name)
+    TeamInput = Data.define(:provider_identities, :name, :nickname) do
+      def initialize(provider_identities:, name:, nickname: nil)
+        super
+      end
+    end
 
     VenueInput = Data.define(:provider_identities, :name)
 
@@ -13,8 +17,13 @@ module Jumbotron
       :team_name,
       :role,
       :score,
-      :result
-    )
+      :result,
+      :team_nickname
+    ) do
+      def initialize(provider_identities:, team_name:, role:, score:, result:, team_nickname: nil)
+        super
+      end
+    end
 
     ScheduleGroupInput = Data.define(:kind, :number, :name)
 

data/app/models/jumbotron/public.rb

@@ -19,7 +19,11 @@ module Jumbotron
       :season_phase,
       :kind
     )
-    Team = Data.define(:id, :name, :key)
+    Team = Data.define(:id, :name, :nickname, :key) do
+      def initialize(id:, name:, key:, nickname: nil)
+        super(id:, name:, nickname:, key:)
+      end
+    end
     Venue = Data.define(:id, :name)
     Participant = Data.define(:role, :score, :result, :team)
     GameSegment = Data.define(:kind, :number)

data/app/services/jumbotron/services/canonical/upsert_game_participant.rb

@@ -13,7 +13,8 @@ module Jumbotron
           team_result = UpsertTeam.call(
             team_input: Jumbotron::Canonical::TeamInput.new(
               provider_identities: participant_input.provider_identities,
-              name: participant_input.team_name
+              name: participant_input.team_name,
+              nickname: participant_input.team_nickname
             ),
             observed_at: observed_at,
             change_set: change_set

data/app/services/jumbotron/services/canonical/upsert_team.rb

@@ -57,6 +57,7 @@ module Jumbotron
             team.name = team_input.name
             team.changed_at = observed_at
           end
+          apply_nickname!(team)
           # key is immutable after assignment — never regenerate from name or provider id
           team.observed_at = observed_at
           team.save!
@@ -66,15 +67,38 @@ module Jumbotron
         def create_new!
           team = Team.create!(
             name: team_input.name,
+            nickname: team_input.nickname,
             key: allocate_key!(team_input.name),
             observed_at: observed_at,
             changed_at: observed_at
           )
           change_set.record(subject: team, attribute: "name", previous: nil, new_value: team.name)
           change_set.record(subject: team, attribute: "key", previous: nil, new_value: team.key)
+          if team.nickname.present?
+            change_set.record(
+              subject: team,
+              attribute: "nickname",
+              previous: nil,
+              new_value: team.nickname
+            )
+          end
           team
         end
 
+        def apply_nickname!(team)
+          return if team_input.nickname.nil?
+          return if team.nickname == team_input.nickname
+
+          change_set.record(
+            subject: team,
+            attribute: "nickname",
+            previous: team.nickname,
+            new_value: team_input.nickname
+          )
+          team.nickname = team_input.nickname
+          team.changed_at = observed_at
+        end
+
         def allocate_key!(name)
           base = Jumbotron::TeamKey.normalize(name)
           return base unless Team.exists?(key: base)

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

@@ -72,6 +72,7 @@ module Jumbotron
             team: Jumbotron::Public::Team.new(
               id: participant.team.id,
               name: participant.team.name,
+              nickname: participant.team.nickname,
               key: participant.team.key
             )
           )

data/db/migrate/20260828180001_add_nickname_to_jumbotron_teams.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+class AddNicknameToJumbotronTeams < ActiveRecord::Migration[8.0]
+  def change
+    add_column :jumbotron_teams, :nickname, :string
+  end
+end

data/lib/jumbotron/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jumbotron
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors:
 - matt-taylor
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-08-27 00:00:00.000000000 Z
+date: 2026-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: command_tower
@@ -65,6 +65,7 @@ files:
 - app/adapters/jumbotron/adapters/espn/nfl_helpers/progress.rb
 - app/adapters/jumbotron/adapters/espn/nfl_helpers/scoreboard.rb
 - app/adapters/jumbotron/adapters/espn/nfl_helpers/season_phase.rb
+- app/adapters/jumbotron/adapters/espn/nfl_helpers/team_nickname.rb
 - app/adapters/jumbotron/adapters/espn/nfl_helpers/teams.rb
 - app/adapters/jumbotron/adapters/line_acquisition.rb
 - app/adapters/jumbotron/adapters/operation.rb
@@ -206,6 +207,7 @@ files:
 - db/migrate/20260814000001_create_jumbotron_line_observations.rb
 - db/migrate/20260820000001_add_progress_to_jumbotron_games.rb
 - db/migrate/20260827150001_add_key_to_jumbotron_teams.rb
+- db/migrate/20260828180001_add_nickname_to_jumbotron_teams.rb
 - docs/testing.md
 - docs/upgrades/0.1.2.md
 - docs/upgrades/0.1.3.md