believe 0.7.0

data/lib/believe/models/match_stream_live_params.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @see ::Believe::Resources::Matches#stream_live
+    class MatchStreamLiveParams < ::Believe::Internal::Type::BaseModel
+      extend ::Believe::Internal::Type::RequestParameters::Converter
+      include ::Believe::Internal::Type::RequestParameters
+
+      # @!attribute away_team
+      #   Away team name
+      #
+      #   @return [String, nil]
+      optional :away_team, String
+
+      # @!attribute excitement_level
+      #   How eventful the match should be (1=boring, 10=chaos)
+      #
+      #   @return [Integer, nil]
+      optional :excitement_level, Integer
+
+      # @!attribute home_team
+      #   Home team name
+      #
+      #   @return [String, nil]
+      optional :home_team, String
+
+      # @!attribute speed
+      #   Simulation speed multiplier (1.0 = real-time)
+      #
+      #   @return [Float, nil]
+      optional :speed, Float
+
+      # @!method initialize(away_team: nil, excitement_level: nil, home_team: nil, speed: nil, request_options: {})
+      #   @param away_team [String] Away team name
+      #
+      #   @param excitement_level [Integer] How eventful the match should be (1=boring, 10=chaos)
+      #
+      #   @param home_team [String] Home team name
+      #
+      #   @param speed [Float] Simulation speed multiplier (1.0 = real-time)
+      #
+      #   @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/believe/models/match_type.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # Types of matches.
+    module MatchType
+      extend ::Believe::Internal::Type::Enum
+
+      LEAGUE = :league
+      CUP = :cup
+      FRIENDLY = :friendly
+      PLAYOFF = :playoff
+      FINAL = :final
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/believe/models/match_update_params.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @see ::Believe::Resources::Matches#update
+    class MatchUpdateParams < ::Believe::Internal::Type::BaseModel
+      extend ::Believe::Internal::Type::RequestParameters::Converter
+      include ::Believe::Internal::Type::RequestParameters
+
+      # @!attribute match_id
+      #
+      #   @return [String]
+      required :match_id, String
+
+      # @!attribute attendance
+      #
+      #   @return [Integer, nil]
+      optional :attendance, Integer, nil?: true
+
+      # @!attribute away_score
+      #
+      #   @return [Integer, nil]
+      optional :away_score, Integer, nil?: true
+
+      # @!attribute away_team_id
+      #
+      #   @return [String, nil]
+      optional :away_team_id, String, nil?: true
+
+      # @!attribute date
+      #
+      #   @return [Time, nil]
+      optional :date, Time, nil?: true
+
+      # @!attribute episode_id
+      #
+      #   @return [String, nil]
+      optional :episode_id, String, nil?: true
+
+      # @!attribute home_score
+      #
+      #   @return [Integer, nil]
+      optional :home_score, Integer, nil?: true
+
+      # @!attribute home_team_id
+      #
+      #   @return [String, nil]
+      optional :home_team_id, String, nil?: true
+
+      # @!attribute lesson_learned
+      #
+      #   @return [String, nil]
+      optional :lesson_learned, String, nil?: true
+
+      # @!attribute match_type
+      #   Types of matches.
+      #
+      #   @return [Symbol, ::Believe::Models::MatchType, nil]
+      optional :match_type, enum: -> { ::Believe::MatchType }, nil?: true
+
+      # @!attribute possession_percentage
+      #
+      #   @return [Float, nil]
+      optional :possession_percentage, Float, nil?: true
+
+      # @!attribute result
+      #   Match result types.
+      #
+      #   @return [Symbol, ::Believe::Models::MatchResult, nil]
+      optional :result, enum: -> { ::Believe::MatchResult }, nil?: true
+
+      # @!attribute ted_halftime_speech
+      #
+      #   @return [String, nil]
+      optional :ted_halftime_speech, String, nil?: true
+
+      # @!attribute ticket_revenue_gbp
+      #
+      #   @return [Float, String, nil]
+      optional :ticket_revenue_gbp, union: -> { ::Believe::MatchUpdateParams::TicketRevenueGbp }, nil?: true
+
+      # @!attribute turning_points
+      #
+      #   @return [Array<::Believe::Models::TurningPoint>, nil]
+      optional :turning_points, -> { ::Believe::Internal::Type::ArrayOf[::Believe::TurningPoint] }, nil?: true
+
+      # @!attribute weather_temp_celsius
+      #
+      #   @return [Float, nil]
+      optional :weather_temp_celsius, Float, nil?: true
+
+      # @!method initialize(match_id:, attendance: nil, away_score: nil, away_team_id: nil, date: nil, episode_id: nil, home_score: nil, home_team_id: nil, lesson_learned: nil, match_type: nil, possession_percentage: nil, result: nil, ted_halftime_speech: nil, ticket_revenue_gbp: nil, turning_points: nil, weather_temp_celsius: nil, request_options: {})
+      #   @param match_id [String]
+      #
+      #   @param attendance [Integer, nil]
+      #
+      #   @param away_score [Integer, nil]
+      #
+      #   @param away_team_id [String, nil]
+      #
+      #   @param date [Time, nil]
+      #
+      #   @param episode_id [String, nil]
+      #
+      #   @param home_score [Integer, nil]
+      #
+      #   @param home_team_id [String, nil]
+      #
+      #   @param lesson_learned [String, nil]
+      #
+      #   @param match_type [Symbol, ::Believe::Models::MatchType, nil] Types of matches.
+      #
+      #   @param possession_percentage [Float, nil]
+      #
+      #   @param result [Symbol, ::Believe::Models::MatchResult, nil] Match result types.
+      #
+      #   @param ted_halftime_speech [String, nil]
+      #
+      #   @param ticket_revenue_gbp [Float, String, nil]
+      #
+      #   @param turning_points [Array<::Believe::Models::TurningPoint>, nil]
+      #
+      #   @param weather_temp_celsius [Float, nil]
+      #
+      #   @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}]
+
+      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/matches/commentary_stream_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    module Matches
+      # @see ::Believe::Resources::Matches::Commentary#stream
+      class CommentaryStreamParams < ::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
+end

data/lib/believe/models/matches/commentary_stream_response.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    module Matches
+      # @type [::Believe::Internal::Type::Converter]
+      CommentaryStreamResponse = ::Believe::Internal::Type::Unknown
+    end
+  end
+end

data/lib/believe/models/medical_specialty.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # Medical staff specialties.
+    module MedicalSpecialty
+      extend ::Believe::Internal::Type::Enum
+
+      TEAM_DOCTOR = :team_doctor
+      PHYSIOTHERAPIST = :physiotherapist
+      SPORTS_PSYCHOLOGIST = :sports_psychologist
+      NUTRITIONIST = :nutritionist
+      MASSAGE_THERAPIST = :massage_therapist
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/believe/models/medical_staff.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    class MedicalStaff < ::Believe::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for this team membership
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute character_id
+      #   ID of the character (references /characters/{id})
+      #
+      #   @return [String]
+      required :character_id, String
+
+      # @!attribute specialty
+      #   Medical specialty
+      #
+      #   @return [Symbol, ::Believe::Models::MedicalSpecialty]
+      required :specialty, enum: -> { ::Believe::MedicalSpecialty }
+
+      # @!attribute team_id
+      #   ID of the team they belong to
+      #
+      #   @return [String]
+      required :team_id, String
+
+      # @!attribute years_with_team
+      #   Number of years with the current team
+      #
+      #   @return [Integer]
+      required :years_with_team, Integer
+
+      # @!attribute license_number
+      #   Professional license number
+      #
+      #   @return [String, nil]
+      optional :license_number, String, nil?: true
+
+      # @!attribute member_type
+      #   Discriminator field indicating this is medical staff
+      #
+      #   @return [Symbol, ::Believe::Models::MedicalStaff::MemberType, nil]
+      optional :member_type, enum: -> { ::Believe::MedicalStaff::MemberType }
+
+      # @!attribute qualifications
+      #   Medical qualifications and degrees
+      #
+      #   @return [Array<String>, nil]
+      optional :qualifications, ::Believe::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(id:, character_id:, specialty:, team_id:, years_with_team:, license_number: nil, member_type: nil, qualifications: nil)
+      #   Full medical staff model with ID.
+      #
+      #   @param id [String] Unique identifier for this team membership
+      #
+      #   @param character_id [String] ID of the character (references /characters/{id})
+      #
+      #   @param specialty [Symbol, ::Believe::Models::MedicalSpecialty] Medical specialty
+      #
+      #   @param team_id [String] ID of the team they belong to
+      #
+      #   @param years_with_team [Integer] Number of years with the current team
+      #
+      #   @param license_number [String, nil] Professional license number
+      #
+      #   @param member_type [Symbol, ::Believe::Models::MedicalStaff::MemberType] Discriminator field indicating this is medical staff
+      #
+      #   @param qualifications [Array<String>] Medical qualifications and degrees
+
+      # Discriminator field indicating this is medical staff
+      #
+      # @see ::Believe::Models::MedicalStaff#member_type
+      module MemberType
+        extend ::Believe::Internal::Type::Enum
+
+        MEDICAL_STAFF = :medical_staff
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/believe/models/paginated_response.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    class PaginatedResponse < ::Believe::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Array<::Believe::Models::Episode>]
+      required :data, -> { ::Believe::Internal::Type::ArrayOf[::Believe::Episode] }
+
+      # @!attribute limit
+      #
+      #   @return [Integer]
+      required :limit, Integer
+
+      # @!attribute skip
+      #
+      #   @return [Integer]
+      required :skip, Integer
+
+      # @!attribute total
+      #
+      #   @return [Integer]
+      required :total, Integer
+
+      response_only do
+        # @!attribute has_more
+        #   Whether there are more items after this page.
+        #
+        #   @return [Boolean]
+        required :has_more, ::Believe::Internal::Type::Boolean
+
+        # @!attribute page
+        #   Current page number (1-indexed, for display purposes).
+        #
+        #   @return [Integer]
+        required :page, Integer
+
+        # @!attribute pages
+        #   Total number of pages.
+        #
+        #   @return [Integer]
+        required :pages, Integer
+      end
+
+      # @!method initialize(data:, has_more:, limit:, page:, pages:, skip:, total:)
+      #   @param data [Array<::Believe::Models::Episode>]
+      #
+      #   @param has_more [Boolean] Whether there are more items after this page.
+      #
+      #   @param limit [Integer]
+      #
+      #   @param page [Integer] Current page number (1-indexed, for display purposes).
+      #
+      #   @param pages [Integer] Total number of pages.
+      #
+      #   @param skip [Integer]
+      #
+      #   @param total [Integer]
+    end
+  end
+end

data/lib/believe/models/paginated_response_quote.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    class PaginatedResponseQuote < ::Believe::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Array<::Believe::Models::Quote>]
+      required :data, -> { ::Believe::Internal::Type::ArrayOf[::Believe::Quote] }
+
+      # @!attribute limit
+      #
+      #   @return [Integer]
+      required :limit, Integer
+
+      # @!attribute skip
+      #
+      #   @return [Integer]
+      required :skip, Integer
+
+      # @!attribute total
+      #
+      #   @return [Integer]
+      required :total, Integer
+
+      response_only do
+        # @!attribute has_more
+        #   Whether there are more items after this page.
+        #
+        #   @return [Boolean]
+        required :has_more, ::Believe::Internal::Type::Boolean
+
+        # @!attribute page
+        #   Current page number (1-indexed, for display purposes).
+        #
+        #   @return [Integer]
+        required :page, Integer
+
+        # @!attribute pages
+        #   Total number of pages.
+        #
+        #   @return [Integer]
+        required :pages, Integer
+      end
+
+      # @!method initialize(data:, has_more:, limit:, page:, pages:, skip:, total:)
+      #   @param data [Array<::Believe::Models::Quote>]
+      #
+      #   @param has_more [Boolean] Whether there are more items after this page.
+      #
+      #   @param limit [Integer]
+      #
+      #   @param page [Integer] Current page number (1-indexed, for display purposes).
+      #
+      #   @param pages [Integer] Total number of pages.
+      #
+      #   @param skip [Integer]
+      #
+      #   @param total [Integer]
+    end
+  end
+end

data/lib/believe/models/pep_talk_retrieve_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @see ::Believe::Resources::PepTalk#retrieve
+    class PepTalkRetrieveParams < ::Believe::Internal::Type::BaseModel
+      extend ::Believe::Internal::Type::RequestParameters::Converter
+      include ::Believe::Internal::Type::RequestParameters
+
+      # @!attribute stream
+      #   If true, returns SSE stream instead of full response
+      #
+      #   @return [Boolean, nil]
+      optional :stream, ::Believe::Internal::Type::Boolean
+
+      # @!method initialize(stream: nil, request_options: {})
+      #   @param stream [Boolean] If true, returns SSE stream instead of full response
+      #
+      #   @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/believe/models/pep_talk_retrieve_response.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @see ::Believe::Resources::PepTalk#retrieve
+    class PepTalkRetrieveResponse < ::Believe::Internal::Type::BaseModel
+      # @!attribute chunks
+      #   Individual chunks of the pep talk
+      #
+      #   @return [Array<::Believe::Models::PepTalkRetrieveResponse::Chunk>]
+      required :chunks,
+               -> { ::Believe::Internal::Type::ArrayOf[::Believe::Models::PepTalkRetrieveResponse::Chunk] }
+
+      # @!attribute text
+      #   The full pep talk text
+      #
+      #   @return [String]
+      required :text, String
+
+      # @!method initialize(chunks:, text:)
+      #   A complete pep talk response.
+      #
+      #   @param chunks [Array<::Believe::Models::PepTalkRetrieveResponse::Chunk>] Individual chunks of the pep talk
+      #
+      #   @param text [String] The full pep talk text
+
+      class Chunk < ::Believe::Internal::Type::BaseModel
+        # @!attribute chunk_id
+        #   Chunk sequence number
+        #
+        #   @return [Integer]
+        required :chunk_id, Integer
+
+        # @!attribute is_final
+        #   Is this the final chunk
+        #
+        #   @return [Boolean]
+        required :is_final, ::Believe::Internal::Type::Boolean
+
+        # @!attribute text
+        #   The text of this chunk
+        #
+        #   @return [String]
+        required :text, String
+
+        # @!attribute emotional_beat
+        #   The emotional purpose of this chunk (e.g., greeting, acknowledgment, wisdom,
+        #   affirmation, encouragement)
+        #
+        #   @return [String, nil]
+        optional :emotional_beat, String, nil?: true
+
+        # @!method initialize(chunk_id:, is_final:, text:, emotional_beat: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {::Believe::Models::PepTalkRetrieveResponse::Chunk} for more details.
+        #
+        #   A chunk of a streaming pep talk from Ted.
+        #
+        #   @param chunk_id [Integer] Chunk sequence number
+        #
+        #   @param is_final [Boolean] Is this the final chunk
+        #
+        #   @param text [String] The text of this chunk
+        #
+        #   @param emotional_beat [String, nil] The emotional purpose of this chunk (e.g., greeting, acknowledgment, wisdom, aff
+      end
+    end
+  end
+end

data/lib/believe/models/player.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # @see ::Believe::Resources::TeamMembers#list_players
+    class Player < ::Believe::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for this team membership
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute character_id
+      #   ID of the character (references /characters/{id})
+      #
+      #   @return [String]
+      required :character_id, String
+
+      # @!attribute jersey_number
+      #   Jersey/shirt number
+      #
+      #   @return [Integer]
+      required :jersey_number, Integer
+
+      # @!attribute position
+      #   Playing position on the field
+      #
+      #   @return [Symbol, ::Believe::Models::Position]
+      required :position, enum: -> { ::Believe::Position }
+
+      # @!attribute team_id
+      #   ID of the team they belong to
+      #
+      #   @return [String]
+      required :team_id, String
+
+      # @!attribute years_with_team
+      #   Number of years with the current team
+      #
+      #   @return [Integer]
+      required :years_with_team, Integer
+
+      # @!attribute assists
+      #   Total assists for the team
+      #
+      #   @return [Integer, nil]
+      optional :assists, Integer
+
+      # @!attribute goals_scored
+      #   Total goals scored for the team
+      #
+      #   @return [Integer, nil]
+      optional :goals_scored, Integer
+
+      # @!attribute is_captain
+      #   Whether this player is team captain
+      #
+      #   @return [Boolean, nil]
+      optional :is_captain, ::Believe::Internal::Type::Boolean
+
+      # @!attribute member_type
+      #   Discriminator field indicating this is a player
+      #
+      #   @return [Symbol, ::Believe::Models::Player::MemberType, nil]
+      optional :member_type, enum: -> { ::Believe::Player::MemberType }
+
+      # @!method initialize(id:, character_id:, jersey_number:, position:, team_id:, years_with_team:, assists: nil, goals_scored: nil, is_captain: nil, member_type: nil)
+      #   Full player model with ID.
+      #
+      #   @param id [String] Unique identifier for this team membership
+      #
+      #   @param character_id [String] ID of the character (references /characters/{id})
+      #
+      #   @param jersey_number [Integer] Jersey/shirt number
+      #
+      #   @param position [Symbol, ::Believe::Models::Position] Playing position on the field
+      #
+      #   @param team_id [String] ID of the team they belong to
+      #
+      #   @param years_with_team [Integer] Number of years with the current team
+      #
+      #   @param assists [Integer] Total assists for the team
+      #
+      #   @param goals_scored [Integer] Total goals scored for the team
+      #
+      #   @param is_captain [Boolean] Whether this player is team captain
+      #
+      #   @param member_type [Symbol, ::Believe::Models::Player::MemberType] Discriminator field indicating this is a player
+
+      # Discriminator field indicating this is a player
+      #
+      # @see ::Believe::Models::Player#member_type
+      module MemberType
+        extend ::Believe::Internal::Type::Enum
+
+        PLAYER = :player
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/believe/models/position.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Believe
+  module Models
+    # Football positions for players.
+    module Position
+      extend ::Believe::Internal::Type::Enum
+
+      GOALKEEPER = :goalkeeper
+      DEFENDER = :defender
+      MIDFIELDER = :midfielder
+      FORWARD = :forward
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end