believe 0.7.0

data/lib/believe/models/league.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # Football leagues.
+    module League
+      extend ::Believe::Internal::Type::Enum
+
+      PREMIER_LEAGUE = :"Premier League"
+      CHAMPIONSHIP = :Championship
+      LEAGUE_ONE = :"League One"
+      LEAGUE_TWO = :"League Two"
+      LA_LIGA = :"La Liga"
+      SERIE_A = :"Serie A"
+      BUNDESLIGA = :Bundesliga
+      LIGUE_1 = :"Ligue 1"
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/believe/models/match.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @see ::Believe::Resources::Matches#create
+    class Match < ::Believe::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute away_team_id
+      #   Away team ID
+      #
+      #   @return [String]
+      required :away_team_id, String
+
+      # @!attribute date
+      #   Match date and time
+      #
+      #   @return [Time]
+      required :date, Time
+
+      # @!attribute home_team_id
+      #   Home team ID
+      #
+      #   @return [String]
+      required :home_team_id, String
+
+      # @!attribute match_type
+      #   Type of match
+      #
+      #   @return [Symbol, ::Believe::Models::MatchType]
+      required :match_type, enum: -> { ::Believe::MatchType }
+
+      # @!attribute attendance
+      #   Match attendance
+      #
+      #   @return [Integer, nil]
+      optional :attendance, Integer, nil?: true
+
+      # @!attribute away_score
+      #   Away team score
+      #
+      #   @return [Integer, nil]
+      optional :away_score, Integer
+
+      # @!attribute episode_id
+      #   Episode ID where this match is featured
+      #
+      #   @return [String, nil]
+      optional :episode_id, String, nil?: true
+
+      # @!attribute home_score
+      #   Home team score
+      #
+      #   @return [Integer, nil]
+      optional :home_score, Integer
+
+      # @!attribute lesson_learned
+      #   The life lesson learned from this match
+      #
+      #   @return [String, nil]
+      optional :lesson_learned, String, nil?: true
+
+      # @!attribute possession_percentage
+      #   Home team possession percentage
+      #
+      #   @return [Float, nil]
+      optional :possession_percentage, Float, nil?: true
+
+      # @!attribute result
+      #   Match result from home team perspective
+      #
+      #   @return [Symbol, ::Believe::Models::MatchResult, nil]
+      optional :result, enum: -> { ::Believe::MatchResult }
+
+      # @!attribute ted_halftime_speech
+      #   Ted's inspirational halftime speech
+      #
+      #   @return [String, nil]
+      optional :ted_halftime_speech, String, nil?: true
+
+      # @!attribute ticket_revenue_gbp
+      #   Total ticket revenue in GBP
+      #
+      #   @return [String, nil]
+      optional :ticket_revenue_gbp, String, nil?: true
+
+      # @!attribute turning_points
+      #   Key moments that changed the match
+      #
+      #   @return [Array<::Believe::Models::TurningPoint>, nil]
+      optional :turning_points, -> { ::Believe::Internal::Type::ArrayOf[::Believe::TurningPoint] }
+
+      # @!attribute weather_temp_celsius
+      #   Temperature at kickoff in Celsius
+      #
+      #   @return [Float, nil]
+      optional :weather_temp_celsius, Float, nil?: true
+
+      # @!method initialize(id:, away_team_id:, date:, home_team_id:, match_type:, attendance: nil, away_score: nil, episode_id: nil, home_score: nil, lesson_learned: nil, possession_percentage: nil, result: nil, ted_halftime_speech: nil, ticket_revenue_gbp: nil, turning_points: nil, weather_temp_celsius: nil)
+      #   Full match model with ID.
+      #
+      #   @param id [String] Unique identifier
+      #
+      #   @param away_team_id [String] Away team ID
+      #
+      #   @param date [Time] Match date and time
+      #
+      #   @param home_team_id [String] Home team ID
+      #
+      #   @param match_type [Symbol, ::Believe::Models::MatchType] Type of match
+      #
+      #   @param attendance [Integer, nil] Match attendance
+      #
+      #   @param away_score [Integer] Away team score
+      #
+      #   @param episode_id [String, nil] Episode ID where this match is featured
+      #
+      #   @param home_score [Integer] Home team score
+      #
+      #   @param lesson_learned [String, nil] The life lesson learned from this match
+      #
+      #   @param possession_percentage [Float, nil] Home team possession percentage
+      #
+      #   @param result [Symbol, ::Believe::Models::MatchResult] Match result from home team perspective
+      #
+      #   @param ted_halftime_speech [String, nil] Ted's inspirational halftime speech
+      #
+      #   @param ticket_revenue_gbp [String, nil] Total ticket revenue in GBP
+      #
+      #   @param turning_points [Array<::Believe::Models::TurningPoint>] Key moments that changed the match
+      #
+      #   @param weather_temp_celsius [Float, nil] Temperature at kickoff in Celsius
+    end
+  end
+end

data/lib/believe/models/match_completed_webhook_event.rb

@@ -0,0 +1,178 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    class MatchCompletedWebhookEvent < ::Believe::Internal::Type::BaseModel
+      # @!attribute created_at
+      #   When the event was created
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute data
+      #   Data payload for a match completed event.
+      #
+      #   @return [::Believe::Models::MatchCompletedWebhookEvent::Data]
+      required :data, -> { ::Believe::MatchCompletedWebhookEvent::Data }
+
+      # @!attribute event_id
+      #   Unique identifier for this event
+      #
+      #   @return [String]
+      required :event_id, String
+
+      # @!attribute event_type
+      #   The type of webhook event
+      #
+      #   @return [Symbol, ::Believe::Models::MatchCompletedWebhookEvent::EventType]
+      required :event_type, enum: -> { ::Believe::MatchCompletedWebhookEvent::EventType }
+
+      # @!method initialize(created_at:, data:, event_id:, event_type:)
+      #   Webhook event sent when a match completes.
+      #
+      #   @param created_at [Time] When the event was created
+      #
+      #   @param data [::Believe::Models::MatchCompletedWebhookEvent::Data] Data payload for a match completed event.
+      #
+      #   @param event_id [String] Unique identifier for this event
+      #
+      #   @param event_type [Symbol, ::Believe::Models::MatchCompletedWebhookEvent::EventType] The type of webhook event
+
+      # @see ::Believe::Models::MatchCompletedWebhookEvent#data
+      class Data < ::Believe::Internal::Type::BaseModel
+        # @!attribute away_score
+        #   Final away team score
+        #
+        #   @return [Integer]
+        required :away_score, Integer
+
+        # @!attribute away_team_id
+        #   Away team ID
+        #
+        #   @return [String]
+        required :away_team_id, String
+
+        # @!attribute completed_at
+        #   When the match completed
+        #
+        #   @return [Time]
+        required :completed_at, Time
+
+        # @!attribute home_score
+        #   Final home team score
+        #
+        #   @return [Integer]
+        required :home_score, Integer
+
+        # @!attribute home_team_id
+        #   Home team ID
+        #
+        #   @return [String]
+        required :home_team_id, String
+
+        # @!attribute match_id
+        #   Unique match identifier
+        #
+        #   @return [String]
+        required :match_id, String
+
+        # @!attribute match_type
+        #   Type of match
+        #
+        #   @return [Symbol, ::Believe::Models::MatchCompletedWebhookEvent::Data::MatchType]
+        required :match_type, enum: -> { ::Believe::MatchCompletedWebhookEvent::Data::MatchType }
+
+        # @!attribute result
+        #   Match result from home team perspective
+        #
+        #   @return [Symbol, ::Believe::Models::MatchCompletedWebhookEvent::Data::Result]
+        required :result, enum: -> { ::Believe::MatchCompletedWebhookEvent::Data::Result }
+
+        # @!attribute ted_post_match_quote
+        #   Ted's post-match wisdom
+        #
+        #   @return [String]
+        required :ted_post_match_quote, String
+
+        # @!attribute lesson_learned
+        #   Ted's lesson from the match
+        #
+        #   @return [String, nil]
+        optional :lesson_learned, String, nil?: true
+
+        # @!attribute man_of_the_match
+        #   Player of the match (if awarded)
+        #
+        #   @return [String, nil]
+        optional :man_of_the_match, String, nil?: true
+
+        # @!method initialize(away_score:, away_team_id:, completed_at:, home_score:, home_team_id:, match_id:, match_type:, result:, ted_post_match_quote:, lesson_learned: nil, man_of_the_match: nil)
+        #   Data payload for a match completed event.
+        #
+        #   @param away_score [Integer] Final away team score
+        #
+        #   @param away_team_id [String] Away team ID
+        #
+        #   @param completed_at [Time] When the match completed
+        #
+        #   @param home_score [Integer] Final home team score
+        #
+        #   @param home_team_id [String] Home team ID
+        #
+        #   @param match_id [String] Unique match identifier
+        #
+        #   @param match_type [Symbol, ::Believe::Models::MatchCompletedWebhookEvent::Data::MatchType] Type of match
+        #
+        #   @param result [Symbol, ::Believe::Models::MatchCompletedWebhookEvent::Data::Result] Match result from home team perspective
+        #
+        #   @param ted_post_match_quote [String] Ted's post-match wisdom
+        #
+        #   @param lesson_learned [String, nil] Ted's lesson from the match
+        #
+        #   @param man_of_the_match [String, nil] Player of the match (if awarded)
+
+        # Type of match
+        #
+        # @see ::Believe::Models::MatchCompletedWebhookEvent::Data#match_type
+        module MatchType
+          extend ::Believe::Internal::Type::Enum
+
+          LEAGUE = :league
+          CUP = :cup
+          FRIENDLY = :friendly
+          PLAYOFF = :playoff
+          FINAL = :final
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Match result from home team perspective
+        #
+        # @see ::Believe::Models::MatchCompletedWebhookEvent::Data#result
+        module Result
+          extend ::Believe::Internal::Type::Enum
+
+          HOME_WIN = :home_win
+          AWAY_WIN = :away_win
+          DRAW = :draw
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # The type of webhook event
+      #
+      # @see ::Believe::Models::MatchCompletedWebhookEvent#event_type
+      module EventType
+        extend ::Believe::Internal::Type::Enum
+
+        MATCH_COMPLETED = :"match.completed"
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/believe/models/match_create_params.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @see ::Believe::Resources::Matches#create
+    class MatchCreateParams < ::Believe::Internal::Type::BaseModel
+      extend ::Believe::Internal::Type::RequestParameters::Converter
+      include ::Believe::Internal::Type::RequestParameters
+
+      # @!attribute away_team_id
+      #   Away team ID
+      #
+      #   @return [String]
+      required :away_team_id, String
+
+      # @!attribute date
+      #   Match date and time
+      #
+      #   @return [Time]
+      required :date, Time
+
+      # @!attribute home_team_id
+      #   Home team ID
+      #
+      #   @return [String]
+      required :home_team_id, String
+
+      # @!attribute match_type
+      #   Type of match
+      #
+      #   @return [Symbol, ::Believe::Models::MatchType]
+      required :match_type, enum: -> { ::Believe::MatchType }
+
+      # @!attribute attendance
+      #   Match attendance
+      #
+      #   @return [Integer, nil]
+      optional :attendance, Integer, nil?: true
+
+      # @!attribute away_score
+      #   Away team score
+      #
+      #   @return [Integer, nil]
+      optional :away_score, Integer
+
+      # @!attribute episode_id
+      #   Episode ID where this match is featured
+      #
+      #   @return [String, nil]
+      optional :episode_id, String, nil?: true
+
+      # @!attribute home_score
+      #   Home team score
+      #
+      #   @return [Integer, nil]
+      optional :home_score, Integer
+
+      # @!attribute lesson_learned
+      #   The life lesson learned from this match
+      #
+      #   @return [String, nil]
+      optional :lesson_learned, String, nil?: true
+
+      # @!attribute possession_percentage
+      #   Home team possession percentage
+      #
+      #   @return [Float, nil]
+      optional :possession_percentage, Float, nil?: true
+
+      # @!attribute result
+      #   Match result from home team perspective
+      #
+      #   @return [Symbol, ::Believe::Models::MatchResult, nil]
+      optional :result, enum: -> { ::Believe::MatchResult }
+
+      # @!attribute ted_halftime_speech
+      #   Ted's inspirational halftime speech
+      #
+      #   @return [String, nil]
+      optional :ted_halftime_speech, String, nil?: true
+
+      # @!attribute ticket_revenue_gbp
+      #   Total ticket revenue in GBP
+      #
+      #   @return [Float, String, nil]
+      optional :ticket_revenue_gbp, union: -> { ::Believe::MatchCreateParams::TicketRevenueGbp }, nil?: true
+
+      # @!attribute turning_points
+      #   Key moments that changed the match
+      #
+      #   @return [Array<::Believe::Models::TurningPoint>, nil]
+      optional :turning_points, -> { ::Believe::Internal::Type::ArrayOf[::Believe::TurningPoint] }
+
+      # @!attribute weather_temp_celsius
+      #   Temperature at kickoff in Celsius
+      #
+      #   @return [Float, nil]
+      optional :weather_temp_celsius, Float, nil?: true
+
+      # @!method initialize(away_team_id:, date:, home_team_id:, match_type:, attendance: nil, away_score: nil, episode_id: nil, home_score: nil, lesson_learned: nil, possession_percentage: nil, result: nil, ted_halftime_speech: nil, ticket_revenue_gbp: nil, turning_points: nil, weather_temp_celsius: nil, request_options: {})
+      #   @param away_team_id [String] Away team ID
+      #
+      #   @param date [Time] Match date and time
+      #
+      #   @param home_team_id [String] Home team ID
+      #
+      #   @param match_type [Symbol, ::Believe::Models::MatchType] Type of match
+      #
+      #   @param attendance [Integer, nil] Match attendance
+      #
+      #   @param away_score [Integer] Away team score
+      #
+      #   @param episode_id [String, nil] Episode ID where this match is featured
+      #
+      #   @param home_score [Integer] Home team score
+      #
+      #   @param lesson_learned [String, nil] The life lesson learned from this match
+      #
+      #   @param possession_percentage [Float, nil] Home team possession percentage
+      #
+      #   @param result [Symbol, ::Believe::Models::MatchResult] Match result from home team perspective
+      #
+      #   @param ted_halftime_speech [String, nil] Ted's inspirational halftime speech
+      #
+      #   @param ticket_revenue_gbp [Float, String, nil] Total ticket revenue in GBP
+      #
+      #   @param turning_points [Array<::Believe::Models::TurningPoint>] Key moments that changed the match
+      #
+      #   @param weather_temp_celsius [Float, nil] Temperature at kickoff in Celsius
+      #
+      #   @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}]
+
+      # Total ticket revenue in GBP
+      module TicketRevenueGbp
+        extend ::Believe::Internal::Type::Union
+
+        variant Float
+
+        variant String
+
+        # @!method self.variants
+        #   @return [Array(Float, String)]
+      end
+    end
+  end
+end

data/lib/believe/models/match_delete_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @see ::Believe::Resources::Matches#delete
+    class MatchDeleteParams < ::Believe::Internal::Type::BaseModel
+      extend ::Believe::Internal::Type::RequestParameters::Converter
+      include ::Believe::Internal::Type::RequestParameters
+
+      # @!attribute match_id
+      #
+      #   @return [String]
+      required :match_id, String
+
+      # @!method initialize(match_id:, request_options: {})
+      #   @param match_id [String]
+      #   @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/believe/models/match_get_lesson_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @see ::Believe::Resources::Matches#get_lesson
+    class MatchGetLessonParams < ::Believe::Internal::Type::BaseModel
+      extend ::Believe::Internal::Type::RequestParameters::Converter
+      include ::Believe::Internal::Type::RequestParameters
+
+      # @!attribute match_id
+      #
+      #   @return [String]
+      required :match_id, String
+
+      # @!method initialize(match_id:, request_options: {})
+      #   @param match_id [String]
+      #   @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/believe/models/match_get_lesson_response.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @type [::Believe::Internal::Type::Converter]
+    MatchGetLessonResponse = ::Believe::Internal::Type::HashOf[::Believe::Internal::Type::Unknown]
+  end
+end

data/lib/believe/models/match_get_turning_points_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @see ::Believe::Resources::Matches#get_turning_points
+    class MatchGetTurningPointsParams < ::Believe::Internal::Type::BaseModel
+      extend ::Believe::Internal::Type::RequestParameters::Converter
+      include ::Believe::Internal::Type::RequestParameters
+
+      # @!attribute match_id
+      #
+      #   @return [String]
+      required :match_id, String
+
+      # @!method initialize(match_id:, request_options: {})
+      #   @param match_id [String]
+      #   @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/believe/models/match_get_turning_points_response.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @type [::Believe::Internal::Type::Converter]
+    MatchGetTurningPointsResponse =
+      ::Believe::Internal::Type::ArrayOf[::Believe::Internal::Type::HashOf[::Believe::Internal::Type::Unknown]]
+  end
+end

data/lib/believe/models/match_list_params.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @see ::Believe::Resources::Matches#list
+    class MatchListParams < ::Believe::Internal::Type::BaseModel
+      extend ::Believe::Internal::Type::RequestParameters::Converter
+      include ::Believe::Internal::Type::RequestParameters
+
+      # @!attribute limit
+      #   Maximum number of items to return (max: 100)
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute match_type
+      #   Filter by match type
+      #
+      #   @return [Symbol, ::Believe::Models::MatchType, nil]
+      optional :match_type, enum: -> { ::Believe::MatchType }, nil?: true
+
+      # @!attribute result
+      #   Filter by result
+      #
+      #   @return [Symbol, ::Believe::Models::MatchResult, nil]
+      optional :result, enum: -> { ::Believe::MatchResult }, nil?: true
+
+      # @!attribute skip
+      #   Number of items to skip (offset)
+      #
+      #   @return [Integer, nil]
+      optional :skip, Integer
+
+      # @!attribute team_id
+      #   Filter by team (home or away)
+      #
+      #   @return [String, nil]
+      optional :team_id, String, nil?: true
+
+      # @!method initialize(limit: nil, match_type: nil, result: nil, skip: nil, team_id: nil, request_options: {})
+      #   @param limit [Integer] Maximum number of items to return (max: 100)
+      #
+      #   @param match_type [Symbol, ::Believe::Models::MatchType, nil] Filter by match type
+      #
+      #   @param result [Symbol, ::Believe::Models::MatchResult, nil] Filter by result
+      #
+      #   @param skip [Integer] Number of items to skip (offset)
+      #
+      #   @param team_id [String, nil] Filter by team (home or away)
+      #
+      #   @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/believe/models/match_result.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # Match result types.
+    module MatchResult
+      extend ::Believe::Internal::Type::Enum
+
+      WIN = :win
+      LOSS = :loss
+      DRAW = :draw
+      PENDING = :pending
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/believe/models/match_retrieve_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @see ::Believe::Resources::Matches#retrieve
+    class MatchRetrieveParams < ::Believe::Internal::Type::BaseModel
+      extend ::Believe::Internal::Type::RequestParameters::Converter
+      include ::Believe::Internal::Type::RequestParameters
+
+      # @!attribute match_id
+      #
+      #   @return [String]
+      required :match_id, String
+
+      # @!method initialize(match_id:, request_options: {})
+      #   @param match_id [String]
+      #   @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end