believe 0.7.0

data/rbi/believe/resources/matches.rbi

@@ -0,0 +1,244 @@
+# typed: strong
+
+module Believe
+  module Resources
+    class Matches
+      # Server-Sent Events (SSE) streaming endpoints
+      sig { returns(::Believe::Resources::Matches::Commentary) }
+      attr_reader :commentary
+
+      # Schedule a new match.
+      sig do
+        params(
+          away_team_id: String,
+          date: Time,
+          home_team_id: String,
+          match_type: ::Believe::MatchType::OrSymbol,
+          attendance: T.nilable(Integer),
+          away_score: Integer,
+          episode_id: T.nilable(String),
+          home_score: Integer,
+          lesson_learned: T.nilable(String),
+          possession_percentage: T.nilable(Float),
+          result: ::Believe::MatchResult::OrSymbol,
+          ted_halftime_speech: T.nilable(String),
+          ticket_revenue_gbp:
+            T.nilable(::Believe::MatchCreateParams::TicketRevenueGbp::Variants),
+          turning_points: T::Array[::Believe::TurningPoint::OrHash],
+          weather_temp_celsius: T.nilable(Float),
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Match)
+      end
+      def create(
+        # Away team ID
+        away_team_id:,
+        # Match date and time
+        date:,
+        # Home team ID
+        home_team_id:,
+        # Type of match
+        match_type:,
+        # Match attendance
+        attendance: nil,
+        # Away team score
+        away_score: nil,
+        # Episode ID where this match is featured
+        episode_id: nil,
+        # Home team score
+        home_score: nil,
+        # The life lesson learned from this match
+        lesson_learned: nil,
+        # Home team possession percentage
+        possession_percentage: nil,
+        # Match result from home team perspective
+        result: nil,
+        # Ted's inspirational halftime speech
+        ted_halftime_speech: nil,
+        # Total ticket revenue in GBP
+        ticket_revenue_gbp: nil,
+        # Key moments that changed the match
+        turning_points: nil,
+        # Temperature at kickoff in Celsius
+        weather_temp_celsius: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieve detailed information about a specific match.
+      sig do
+        params(
+          match_id: String,
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Match)
+      end
+      def retrieve(match_id, request_options: {})
+      end
+
+      # Update specific fields of an existing match (e.g., update score).
+      sig do
+        params(
+          match_id: String,
+          attendance: T.nilable(Integer),
+          away_score: T.nilable(Integer),
+          away_team_id: T.nilable(String),
+          date: T.nilable(Time),
+          episode_id: T.nilable(String),
+          home_score: T.nilable(Integer),
+          home_team_id: T.nilable(String),
+          lesson_learned: T.nilable(String),
+          match_type: T.nilable(::Believe::MatchType::OrSymbol),
+          possession_percentage: T.nilable(Float),
+          result: T.nilable(::Believe::MatchResult::OrSymbol),
+          ted_halftime_speech: T.nilable(String),
+          ticket_revenue_gbp:
+            T.nilable(::Believe::MatchUpdateParams::TicketRevenueGbp::Variants),
+          turning_points: T.nilable(T::Array[::Believe::TurningPoint::OrHash]),
+          weather_temp_celsius: T.nilable(Float),
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Match)
+      end
+      def update(
+        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,
+        # Types of matches.
+        match_type: nil,
+        possession_percentage: nil,
+        # Match result types.
+        result: nil,
+        ted_halftime_speech: nil,
+        ticket_revenue_gbp: nil,
+        turning_points: nil,
+        weather_temp_celsius: nil,
+        request_options: {}
+      )
+      end
+
+      # Get a paginated list of all matches with optional filtering.
+      sig do
+        params(
+          limit: Integer,
+          match_type: T.nilable(::Believe::MatchType::OrSymbol),
+          result: T.nilable(::Believe::MatchResult::OrSymbol),
+          skip: Integer,
+          team_id: T.nilable(String),
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Internal::SkipLimitPage[::Believe::Match])
+      end
+      def list(
+        # Maximum number of items to return (max: 100)
+        limit: nil,
+        # Filter by match type
+        match_type: nil,
+        # Filter by result
+        result: nil,
+        # Number of items to skip (offset)
+        skip: nil,
+        # Filter by team (home or away)
+        team_id: nil,
+        request_options: {}
+      )
+      end
+
+      # Remove a match from the database.
+      sig do
+        params(
+          match_id: String,
+          request_options: ::Believe::RequestOptions::OrHash
+        ).void
+      end
+      def delete(match_id, request_options: {})
+      end
+
+      # Get the life lesson learned from a specific match.
+      sig do
+        params(
+          match_id: String,
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(T::Hash[Symbol, T.anything])
+      end
+      def get_lesson(match_id, request_options: {})
+      end
+
+      # Get all turning points from a specific match.
+      sig do
+        params(
+          match_id: String,
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(T::Array[T::Hash[Symbol, T.anything]])
+      end
+      def get_turning_points(match_id, request_options: {})
+      end
+
+      # WebSocket endpoint for real-time live match simulation.
+      #
+      # Connect to receive a stream of match events as they happen in a simulated
+      # football match.
+      #
+      # ## Connection
+      #
+      # Connect via WebSocket with optional query parameters to customize the
+      # simulation.
+      #
+      # ## Example WebSocket URL
+      #
+      # ```
+      # ws://localhost:8000/matches/live
+      # ```
+      #
+      # Append query parameters from the list above to customize the simulation.
+      #
+      # ## Server Messages
+      #
+      # The server sends JSON messages with these types:
+      #
+      # - `match_start` - When the match begins
+      # - `match_event` - For each match event (goals, fouls, cards, etc.)
+      # - `match_end` - When the match concludes
+      # - `error` - If an error occurs
+      # - `pong` - Response to client ping
+      #
+      # ## Client Messages
+      #
+      # Send JSON to control the simulation:
+      #
+      # - `{"action": "ping"}` - Keep-alive, server responds with `{"type": "pong"}`
+      # - `{"action": "pause"}` - Pause the simulation
+      # - `{"action": "resume"}` - Resume a paused simulation
+      # - `{"action": "set_speed", "speed": 2.0}` - Change playback speed (0.1-10.0)
+      # - `{"action": "get_status"}` - Request current match status
+      sig do
+        params(
+          away_team: String,
+          excitement_level: Integer,
+          home_team: String,
+          speed: Float,
+          request_options: ::Believe::RequestOptions::OrHash
+        ).void
+      end
+      def stream_live(
+        # Away team name
+        away_team: nil,
+        # How eventful the match should be (1=boring, 10=chaos)
+        excitement_level: nil,
+        # Home team name
+        home_team: nil,
+        # Simulation speed multiplier (1.0 = real-time)
+        speed: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: ::Believe::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/believe/resources/pep_talk.rbi

@@ -0,0 +1,29 @@
+# typed: strong
+
+module Believe
+  module Resources
+    # Server-Sent Events (SSE) streaming endpoints
+    class PepTalk
+      # Get a motivational pep talk from Ted Lasso himself. By default returns the
+      # complete pep talk. Add `?stream=true` to get Server-Sent Events (SSE) streaming
+      # the pep talk chunk by chunk.
+      sig do
+        params(
+          stream: T::Boolean,
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Models::PepTalkRetrieveResponse)
+      end
+      def retrieve(
+        # If true, returns SSE stream instead of full response
+        stream: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: ::Believe::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/believe/resources/press.rbi

@@ -0,0 +1,33 @@
+# typed: strong
+
+module Believe
+  module Resources
+    # Interactive endpoints for motivation and guidance
+    class Press
+      # Get Ted's response to press conference questions.
+      sig do
+        params(
+          question: String,
+          hostile: T::Boolean,
+          topic: T.nilable(String),
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Models::PressSimulateResponse)
+      end
+      def simulate(
+        # The press question to answer
+        question:,
+        # Is this a hostile question from Trent Crimm?
+        hostile: nil,
+        # Topic category
+        topic: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: ::Believe::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/believe/resources/quotes.rbi

@@ -0,0 +1,206 @@
+# typed: strong
+
+module Believe
+  module Resources
+    # Memorable quotes from the show
+    class Quotes
+      # Add a new memorable quote to the collection.
+      sig do
+        params(
+          character_id: String,
+          context: String,
+          moment_type: ::Believe::QuoteMoment::OrSymbol,
+          text: String,
+          theme: ::Believe::QuoteTheme::OrSymbol,
+          episode_id: T.nilable(String),
+          is_funny: T::Boolean,
+          is_inspirational: T::Boolean,
+          popularity_score: T.nilable(Float),
+          secondary_themes: T::Array[::Believe::QuoteTheme::OrSymbol],
+          times_shared: T.nilable(Integer),
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Quote)
+      end
+      def create(
+        # ID of the character who said it
+        character_id:,
+        # Context in which the quote was said
+        context:,
+        # Type of moment when the quote was said
+        moment_type:,
+        # The quote text
+        text:,
+        # Primary theme of the quote
+        theme:,
+        # Episode where the quote appears
+        episode_id: nil,
+        # Whether this quote is humorous
+        is_funny: nil,
+        # Whether this quote is inspirational
+        is_inspirational: nil,
+        # Popularity/virality score (0-100)
+        popularity_score: nil,
+        # Additional themes
+        secondary_themes: nil,
+        # Number of times shared on social media
+        times_shared: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieve a specific quote by its ID.
+      sig do
+        params(
+          quote_id: String,
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Quote)
+      end
+      def retrieve(quote_id, request_options: {})
+      end
+
+      # Update specific fields of an existing quote.
+      sig do
+        params(
+          quote_id: String,
+          character_id: T.nilable(String),
+          context: T.nilable(String),
+          episode_id: T.nilable(String),
+          is_funny: T.nilable(T::Boolean),
+          is_inspirational: T.nilable(T::Boolean),
+          moment_type: T.nilable(::Believe::QuoteMoment::OrSymbol),
+          popularity_score: T.nilable(Float),
+          secondary_themes:
+            T.nilable(T::Array[::Believe::QuoteTheme::OrSymbol]),
+          text: T.nilable(String),
+          theme: T.nilable(::Believe::QuoteTheme::OrSymbol),
+          times_shared: T.nilable(Integer),
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Quote)
+      end
+      def update(
+        quote_id,
+        character_id: nil,
+        context: nil,
+        episode_id: nil,
+        is_funny: nil,
+        is_inspirational: nil,
+        # Types of moments when quotes occur.
+        moment_type: nil,
+        popularity_score: nil,
+        secondary_themes: nil,
+        text: nil,
+        # Themes that quotes can be categorized under.
+        theme: nil,
+        times_shared: nil,
+        request_options: {}
+      )
+      end
+
+      # Get a paginated list of all memorable Ted Lasso quotes with optional filtering.
+      sig do
+        params(
+          character_id: T.nilable(String),
+          funny: T.nilable(T::Boolean),
+          inspirational: T.nilable(T::Boolean),
+          limit: Integer,
+          moment_type: T.nilable(::Believe::QuoteMoment::OrSymbol),
+          skip: Integer,
+          theme: T.nilable(::Believe::QuoteTheme::OrSymbol),
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Internal::SkipLimitPage[::Believe::Quote])
+      end
+      def list(
+        # Filter by character
+        character_id: nil,
+        # Filter funny quotes
+        funny: nil,
+        # Filter inspirational quotes
+        inspirational: nil,
+        # Maximum number of items to return (max: 100)
+        limit: nil,
+        # Filter by moment type
+        moment_type: nil,
+        # Number of items to skip (offset)
+        skip: nil,
+        # Filter by theme
+        theme: nil,
+        request_options: {}
+      )
+      end
+
+      # Remove a quote from the collection.
+      sig do
+        params(
+          quote_id: String,
+          request_options: ::Believe::RequestOptions::OrHash
+        ).void
+      end
+      def delete(quote_id, request_options: {})
+      end
+
+      # Get a random Ted Lasso quote, optionally filtered.
+      sig do
+        params(
+          character_id: T.nilable(String),
+          inspirational: T.nilable(T::Boolean),
+          theme: T.nilable(::Believe::QuoteTheme::OrSymbol),
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Quote)
+      end
+      def get_random(
+        # Filter by character
+        character_id: nil,
+        # Filter inspirational quotes
+        inspirational: nil,
+        # Filter by theme
+        theme: nil,
+        request_options: {}
+      )
+      end
+
+      # Get a paginated list of quotes from a specific character.
+      sig do
+        params(
+          character_id: String,
+          limit: Integer,
+          skip: Integer,
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Internal::SkipLimitPage[::Believe::Quote])
+      end
+      def list_by_character(
+        character_id,
+        # Maximum number of items to return (max: 100)
+        limit: nil,
+        # Number of items to skip (offset)
+        skip: nil,
+        request_options: {}
+      )
+      end
+
+      # Get a paginated list of quotes related to a specific theme.
+      sig do
+        params(
+          theme: ::Believe::QuoteTheme::OrSymbol,
+          limit: Integer,
+          skip: Integer,
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Internal::SkipLimitPage[::Believe::Quote])
+      end
+      def list_by_theme(
+        # Themes that quotes can be categorized under.
+        theme,
+        # Maximum number of items to return (max: 100)
+        limit: nil,
+        # Number of items to skip (offset)
+        skip: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: ::Believe::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/believe/resources/reframe.rbi

@@ -0,0 +1,30 @@
+# typed: strong
+
+module Believe
+  module Resources
+    # Interactive endpoints for motivation and guidance
+    class Reframe
+      # Transform negative thoughts into positive perspectives with Ted's help.
+      sig do
+        params(
+          negative_thought: String,
+          recurring: T::Boolean,
+          request_options: ::Believe::RequestOptions::OrHash
+        ).returns(::Believe::Models::ReframeTransformNegativeThoughtsResponse)
+      end
+      def transform_negative_thoughts(
+        # The negative thought to reframe
+        negative_thought:,
+        # Is this a recurring thought?
+        recurring: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: ::Believe::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/believe/resources/stream.rbi

@@ -0,0 +1,22 @@
+# typed: strong
+
+module Believe
+  module Resources
+    # Server-Sent Events (SSE) streaming endpoints
+    class Stream
+      # A simple SSE test endpoint that streams numbers 1-5.
+      sig do
+        params(request_options: ::Believe::RequestOptions::OrHash).returns(
+          T.anything
+        )
+      end
+      def test_connection(request_options: {})
+      end
+
+      # @api private
+      sig { params(client: ::Believe::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end