believe 0.7.0

data/lib/believe/resources/matches.rb

@@ -0,0 +1,288 @@
+# frozen_string_literal: true
+
+module Believe
+  module Resources
+    class Matches
+      # Server-Sent Events (SSE) streaming endpoints
+      # @return [::Believe::Resources::Matches::Commentary]
+      attr_reader :commentary
+
+      # Schedule a new match.
+      #
+      # @overload create(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}, nil]
+      #
+      # @return [::Believe::Models::Match]
+      #
+      # @see ::Believe::Models::MatchCreateParams
+      def create(params)
+        parsed, options = ::Believe::MatchCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "matches",
+          body: parsed,
+          model: ::Believe::Match,
+          options: options
+        )
+      end
+
+      # Retrieve detailed information about a specific match.
+      #
+      # @overload retrieve(match_id, request_options: {})
+      #
+      # @param match_id [String]
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::Match]
+      #
+      # @see ::Believe::Models::MatchRetrieveParams
+      def retrieve(match_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["matches/%1$s", match_id],
+          model: ::Believe::Match,
+          options: params[:request_options]
+        )
+      end
+
+      # Update specific fields of an existing match (e.g., update score).
+      #
+      # @overload 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, 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}, nil]
+      #
+      # @return [::Believe::Models::Match]
+      #
+      # @see ::Believe::Models::MatchUpdateParams
+      def update(match_id, params = {})
+        parsed, options = ::Believe::MatchUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["matches/%1$s", match_id],
+          body: parsed,
+          model: ::Believe::Match,
+          options: options
+        )
+      end
+
+      # Get a paginated list of all matches with optional filtering.
+      #
+      # @overload list(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}, nil]
+      #
+      # @return [::Believe::Internal::SkipLimitPage<::Believe::Models::Match>]
+      #
+      # @see ::Believe::Models::MatchListParams
+      def list(params = {})
+        parsed, options = ::Believe::MatchListParams.dump_request(params)
+        query = ::Believe::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "matches",
+          query: query,
+          page: ::Believe::Internal::SkipLimitPage,
+          model: ::Believe::Match,
+          options: options
+        )
+      end
+
+      # Remove a match from the database.
+      #
+      # @overload delete(match_id, request_options: {})
+      #
+      # @param match_id [String]
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see ::Believe::Models::MatchDeleteParams
+      def delete(match_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["matches/%1$s", match_id],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # Get the life lesson learned from a specific match.
+      #
+      # @overload get_lesson(match_id, request_options: {})
+      #
+      # @param match_id [String]
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Hash{Symbol=>Object}]
+      #
+      # @see ::Believe::Models::MatchGetLessonParams
+      def get_lesson(match_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["matches/%1$s/lesson", match_id],
+          model: ::Believe::Internal::Type::HashOf[::Believe::Internal::Type::Unknown],
+          options: params[:request_options]
+        )
+      end
+
+      # Get all turning points from a specific match.
+      #
+      # @overload get_turning_points(match_id, request_options: {})
+      #
+      # @param match_id [String]
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Array<Hash{Symbol=>Object}>]
+      #
+      # @see ::Believe::Models::MatchGetTurningPointsParams
+      def get_turning_points(match_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["matches/%1$s/turning-points", match_id],
+          model: ::Believe::Internal::Type::ArrayOf[::Believe::Internal::Type::HashOf[::Believe::Internal::Type::Unknown]],
+          options: params[: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
+      #
+      # @overload stream_live(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}, nil]
+      #
+      # @return [nil]
+      #
+      # @see ::Believe::Models::MatchStreamLiveParams
+      def stream_live(params = {})
+        parsed, options = ::Believe::MatchStreamLiveParams.dump_request(params)
+        query = ::Believe::Internal::Util.encode_query_params(parsed)
+        @client.request(method: :get, path: "matches/live", query: query, model: NilClass, options: options)
+      end
+
+      # @api private
+      #
+      # @param client [::Believe::Client]
+      def initialize(client:)
+        @client = client
+        @commentary = ::Believe::Resources::Matches::Commentary.new(client: client)
+      end
+    end
+  end
+end

data/lib/believe/resources/pep_talk.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+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.
+      #
+      # @overload retrieve(stream: nil, request_options: {})
+      #
+      # @param stream [Boolean] If true, returns SSE stream instead of full response
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::PepTalkRetrieveResponse]
+      #
+      # @see ::Believe::Models::PepTalkRetrieveParams
+      def retrieve(params = {})
+        parsed, options = ::Believe::PepTalkRetrieveParams.dump_request(params)
+        query = ::Believe::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "pep-talk",
+          query: query,
+          model: ::Believe::Models::PepTalkRetrieveResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [::Believe::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/believe/resources/press.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Believe
+  module Resources
+    # Interactive endpoints for motivation and guidance
+    class Press
+      # Get Ted's response to press conference questions.
+      #
+      # @overload simulate(question:, hostile: nil, topic: nil, request_options: {})
+      #
+      # @param question [String] The press question to answer
+      #
+      # @param hostile [Boolean] Is this a hostile question from Trent Crimm?
+      #
+      # @param topic [String, nil] Topic category
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::PressSimulateResponse]
+      #
+      # @see ::Believe::Models::PressSimulateParams
+      def simulate(params)
+        parsed, options = ::Believe::PressSimulateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "press",
+          body: parsed,
+          model: ::Believe::Models::PressSimulateResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [::Believe::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/believe/resources/quotes.rb

@@ -0,0 +1,258 @@
+# frozen_string_literal: true
+
+module Believe
+  module Resources
+    # Memorable quotes from the show
+    class Quotes
+      # Add a new memorable quote to the collection.
+      #
+      # @overload create(character_id:, context:, moment_type:, text:, theme:, episode_id: nil, is_funny: nil, is_inspirational: nil, popularity_score: nil, secondary_themes: nil, times_shared: nil, request_options: {})
+      #
+      # @param character_id [String] ID of the character who said it
+      #
+      # @param context [String] Context in which the quote was said
+      #
+      # @param moment_type [Symbol, ::Believe::Models::QuoteMoment] Type of moment when the quote was said
+      #
+      # @param text [String] The quote text
+      #
+      # @param theme [Symbol, ::Believe::Models::QuoteTheme] Primary theme of the quote
+      #
+      # @param episode_id [String, nil] Episode where the quote appears
+      #
+      # @param is_funny [Boolean] Whether this quote is humorous
+      #
+      # @param is_inspirational [Boolean] Whether this quote is inspirational
+      #
+      # @param popularity_score [Float, nil] Popularity/virality score (0-100)
+      #
+      # @param secondary_themes [Array<Symbol, ::Believe::Models::QuoteTheme>] Additional themes
+      #
+      # @param times_shared [Integer, nil] Number of times shared on social media
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::Quote]
+      #
+      # @see ::Believe::Models::QuoteCreateParams
+      def create(params)
+        parsed, options = ::Believe::QuoteCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "quotes",
+          body: parsed,
+          model: ::Believe::Quote,
+          options: options
+        )
+      end
+
+      # Retrieve a specific quote by its ID.
+      #
+      # @overload retrieve(quote_id, request_options: {})
+      #
+      # @param quote_id [String]
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::Quote]
+      #
+      # @see ::Believe::Models::QuoteRetrieveParams
+      def retrieve(quote_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["quotes/%1$s", quote_id],
+          model: ::Believe::Quote,
+          options: params[:request_options]
+        )
+      end
+
+      # Update specific fields of an existing quote.
+      #
+      # @overload update(quote_id, character_id: nil, context: nil, episode_id: nil, is_funny: nil, is_inspirational: nil, moment_type: nil, popularity_score: nil, secondary_themes: nil, text: nil, theme: nil, times_shared: nil, request_options: {})
+      #
+      # @param quote_id [String]
+      #
+      # @param character_id [String, nil]
+      #
+      # @param context [String, nil]
+      #
+      # @param episode_id [String, nil]
+      #
+      # @param is_funny [Boolean, nil]
+      #
+      # @param is_inspirational [Boolean, nil]
+      #
+      # @param moment_type [Symbol, ::Believe::Models::QuoteMoment, nil] Types of moments when quotes occur.
+      #
+      # @param popularity_score [Float, nil]
+      #
+      # @param secondary_themes [Array<Symbol, ::Believe::Models::QuoteTheme>, nil]
+      #
+      # @param text [String, nil]
+      #
+      # @param theme [Symbol, ::Believe::Models::QuoteTheme, nil] Themes that quotes can be categorized under.
+      #
+      # @param times_shared [Integer, nil]
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::Quote]
+      #
+      # @see ::Believe::Models::QuoteUpdateParams
+      def update(quote_id, params = {})
+        parsed, options = ::Believe::QuoteUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["quotes/%1$s", quote_id],
+          body: parsed,
+          model: ::Believe::Quote,
+          options: options
+        )
+      end
+
+      # Get a paginated list of all memorable Ted Lasso quotes with optional filtering.
+      #
+      # @overload list(character_id: nil, funny: nil, inspirational: nil, limit: nil, moment_type: nil, skip: nil, theme: nil, request_options: {})
+      #
+      # @param character_id [String, nil] Filter by character
+      #
+      # @param funny [Boolean, nil] Filter funny quotes
+      #
+      # @param inspirational [Boolean, nil] Filter inspirational quotes
+      #
+      # @param limit [Integer] Maximum number of items to return (max: 100)
+      #
+      # @param moment_type [Symbol, ::Believe::Models::QuoteMoment, nil] Filter by moment type
+      #
+      # @param skip [Integer] Number of items to skip (offset)
+      #
+      # @param theme [Symbol, ::Believe::Models::QuoteTheme, nil] Filter by theme
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Internal::SkipLimitPage<::Believe::Models::Quote>]
+      #
+      # @see ::Believe::Models::QuoteListParams
+      def list(params = {})
+        parsed, options = ::Believe::QuoteListParams.dump_request(params)
+        query = ::Believe::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "quotes",
+          query: query,
+          page: ::Believe::Internal::SkipLimitPage,
+          model: ::Believe::Quote,
+          options: options
+        )
+      end
+
+      # Remove a quote from the collection.
+      #
+      # @overload delete(quote_id, request_options: {})
+      #
+      # @param quote_id [String]
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see ::Believe::Models::QuoteDeleteParams
+      def delete(quote_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["quotes/%1$s", quote_id],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # Get a random Ted Lasso quote, optionally filtered.
+      #
+      # @overload get_random(character_id: nil, inspirational: nil, theme: nil, request_options: {})
+      #
+      # @param character_id [String, nil] Filter by character
+      #
+      # @param inspirational [Boolean, nil] Filter inspirational quotes
+      #
+      # @param theme [Symbol, ::Believe::Models::QuoteTheme, nil] Filter by theme
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::Quote]
+      #
+      # @see ::Believe::Models::QuoteGetRandomParams
+      def get_random(params = {})
+        parsed, options = ::Believe::QuoteGetRandomParams.dump_request(params)
+        query = ::Believe::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "quotes/random",
+          query: query,
+          model: ::Believe::Quote,
+          options: options
+        )
+      end
+
+      # Get a paginated list of quotes from a specific character.
+      #
+      # @overload list_by_character(character_id, limit: nil, skip: nil, request_options: {})
+      #
+      # @param character_id [String]
+      #
+      # @param limit [Integer] Maximum number of items to return (max: 100)
+      #
+      # @param skip [Integer] Number of items to skip (offset)
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Internal::SkipLimitPage<::Believe::Models::Quote>]
+      #
+      # @see ::Believe::Models::QuoteListByCharacterParams
+      def list_by_character(character_id, params = {})
+        parsed, options = ::Believe::QuoteListByCharacterParams.dump_request(params)
+        query = ::Believe::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["quotes/characters/%1$s", character_id],
+          query: query,
+          page: ::Believe::Internal::SkipLimitPage,
+          model: ::Believe::Quote,
+          options: options
+        )
+      end
+
+      # Get a paginated list of quotes related to a specific theme.
+      #
+      # @overload list_by_theme(theme, limit: nil, skip: nil, request_options: {})
+      #
+      # @param theme [Symbol, ::Believe::Models::QuoteTheme] Themes that quotes can be categorized under.
+      #
+      # @param limit [Integer] Maximum number of items to return (max: 100)
+      #
+      # @param skip [Integer] Number of items to skip (offset)
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Internal::SkipLimitPage<::Believe::Models::Quote>]
+      #
+      # @see ::Believe::Models::QuoteListByThemeParams
+      def list_by_theme(theme, params = {})
+        parsed, options = ::Believe::QuoteListByThemeParams.dump_request(params)
+        query = ::Believe::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["quotes/themes/%1$s", theme],
+          query: query,
+          page: ::Believe::Internal::SkipLimitPage,
+          model: ::Believe::Quote,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [::Believe::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/believe/resources/reframe.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Believe
+  module Resources
+    # Interactive endpoints for motivation and guidance
+    class Reframe
+      # Transform negative thoughts into positive perspectives with Ted's help.
+      #
+      # @overload transform_negative_thoughts(negative_thought:, recurring: nil, request_options: {})
+      #
+      # @param negative_thought [String] The negative thought to reframe
+      #
+      # @param recurring [Boolean] Is this a recurring thought?
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::ReframeTransformNegativeThoughtsResponse]
+      #
+      # @see ::Believe::Models::ReframeTransformNegativeThoughtsParams
+      def transform_negative_thoughts(params)
+        parsed, options = ::Believe::ReframeTransformNegativeThoughtsParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "reframe",
+          body: parsed,
+          model: ::Believe::Models::ReframeTransformNegativeThoughtsResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [::Believe::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/believe/resources/stream.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Believe
+  module Resources
+    # Server-Sent Events (SSE) streaming endpoints
+    class Stream
+      # A simple SSE test endpoint that streams numbers 1-5.
+      #
+      # @overload test_connection(request_options: {})
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Object]
+      #
+      # @see ::Believe::Models::StreamTestConnectionParams
+      def test_connection(params = {})
+        @client.request(
+          method: :get,
+          path: "stream/test",
+          model: ::Believe::Internal::Type::Unknown,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [::Believe::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end