believe 0.7.0

data/lib/believe/resources/ticket_sales.rb

@@ -0,0 +1,179 @@
+# frozen_string_literal: true
+
+module Believe
+  module Resources
+    # Ticket sales with 300 records for practicing pagination, filtering, and
+    # financial data
+    class TicketSales
+      # Record a new ticket sale.
+      #
+      # @overload create(buyer_name:, currency:, discount:, match_id:, purchase_method:, quantity:, subtotal:, tax:, total:, unit_price:, buyer_email: nil, coupon_code: nil, request_options: {})
+      #
+      # @param buyer_name [String] Name of the ticket buyer
+      #
+      # @param currency [String] Currency code (GBP, USD, or EUR)
+      #
+      # @param discount [String] Discount amount applied from coupon
+      #
+      # @param match_id [String] ID of the match
+      #
+      # @param purchase_method [Symbol, ::Believe::Models::PurchaseMethod] How the ticket was purchased
+      #
+      # @param quantity [Integer] Number of tickets purchased
+      #
+      # @param subtotal [String] Subtotal before discount and tax (unit_price \* quantity)
+      #
+      # @param tax [String] Tax amount (20% UK VAT on discounted subtotal)
+      #
+      # @param total [String] Final total (subtotal - discount + tax)
+      #
+      # @param unit_price [String] Price per ticket (decimal string)
+      #
+      # @param buyer_email [String, nil] Email of the ticket buyer
+      #
+      # @param coupon_code [String, nil] Coupon code applied, if any
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::TicketSale]
+      #
+      # @see ::Believe::Models::TicketSaleCreateParams
+      def create(params)
+        parsed, options = ::Believe::TicketSaleCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "ticket-sales",
+          body: parsed,
+          model: ::Believe::TicketSale,
+          options: options
+        )
+      end
+
+      # Retrieve detailed information about a specific ticket sale.
+      #
+      # @overload retrieve(ticket_sale_id, request_options: {})
+      #
+      # @param ticket_sale_id [String]
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::TicketSale]
+      #
+      # @see ::Believe::Models::TicketSaleRetrieveParams
+      def retrieve(ticket_sale_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["ticket-sales/%1$s", ticket_sale_id],
+          model: ::Believe::TicketSale,
+          options: params[:request_options]
+        )
+      end
+
+      # Update specific fields of an existing ticket sale.
+      #
+      # @overload update(ticket_sale_id, buyer_email: nil, buyer_name: nil, coupon_code: nil, currency: nil, discount: nil, match_id: nil, purchase_method: nil, quantity: nil, subtotal: nil, tax: nil, total: nil, unit_price: nil, request_options: {})
+      #
+      # @param ticket_sale_id [String]
+      #
+      # @param buyer_email [String, nil]
+      #
+      # @param buyer_name [String, nil]
+      #
+      # @param coupon_code [String, nil]
+      #
+      # @param currency [String, nil]
+      #
+      # @param discount [String, nil]
+      #
+      # @param match_id [String, nil]
+      #
+      # @param purchase_method [Symbol, ::Believe::Models::PurchaseMethod, nil] How the ticket was purchased.
+      #
+      # @param quantity [Integer, nil]
+      #
+      # @param subtotal [String, nil]
+      #
+      # @param tax [String, nil]
+      #
+      # @param total [String, nil]
+      #
+      # @param unit_price [String, nil]
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::TicketSale]
+      #
+      # @see ::Believe::Models::TicketSaleUpdateParams
+      def update(ticket_sale_id, params = {})
+        parsed, options = ::Believe::TicketSaleUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["ticket-sales/%1$s", ticket_sale_id],
+          body: parsed,
+          model: ::Believe::TicketSale,
+          options: options
+        )
+      end
+
+      # Get a paginated list of all ticket sales with optional filtering. With 300
+      # records, this endpoint is ideal for practicing pagination.
+      #
+      # @overload list(coupon_code: nil, currency: nil, limit: nil, match_id: nil, purchase_method: nil, skip: nil, request_options: {})
+      #
+      # @param coupon_code [String, nil] Filter by coupon code (use 'none' for sales without coupons)
+      #
+      # @param currency [String, nil] Filter by currency (GBP, USD, EUR)
+      #
+      # @param limit [Integer] Maximum number of items to return (max: 100)
+      #
+      # @param match_id [String, nil] Filter by match ID
+      #
+      # @param purchase_method [Symbol, ::Believe::Models::PurchaseMethod, nil] Filter by purchase method
+      #
+      # @param skip [Integer] Number of items to skip (offset)
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Internal::SkipLimitPage<::Believe::Models::TicketSale>]
+      #
+      # @see ::Believe::Models::TicketSaleListParams
+      def list(params = {})
+        parsed, options = ::Believe::TicketSaleListParams.dump_request(params)
+        query = ::Believe::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "ticket-sales",
+          query: query,
+          page: ::Believe::Internal::SkipLimitPage,
+          model: ::Believe::TicketSale,
+          options: options
+        )
+      end
+
+      # Remove a ticket sale from the database.
+      #
+      # @overload delete(ticket_sale_id, request_options: {})
+      #
+      # @param ticket_sale_id [String]
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see ::Believe::Models::TicketSaleDeleteParams
+      def delete(ticket_sale_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["ticket-sales/%1$s", ticket_sale_id],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [::Believe::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/believe/resources/version.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Believe
+  module Resources
+    class Version
+      # Get detailed information about API versioning.
+      #
+      # @overload retrieve(request_options: {})
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Object]
+      #
+      # @see ::Believe::Models::VersionRetrieveParams
+      def retrieve(params = {})
+        @client.request(
+          method: :get,
+          path: "version",
+          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

data/lib/believe/resources/webhooks.rb

@@ -0,0 +1,177 @@
+# frozen_string_literal: true
+
+module Believe
+  module Resources
+    # Register webhook endpoints and trigger events for testing
+    class Webhooks
+      # Register a new webhook endpoint to receive event notifications.
+      #
+      # ## Event Types
+      #
+      # Available event types to subscribe to:
+      #
+      # - `match.completed` - Fired when a football match ends
+      # - `team_member.transferred` - Fired when a player/coach joins or leaves a team
+      #
+      # If no event types are specified, the webhook will receive all event types.
+      #
+      # ## Webhook Signatures
+      #
+      # All webhook deliveries include Standard Webhooks signature headers:
+      #
+      # - `webhook-id` - Unique message identifier
+      # - `webhook-timestamp` - Unix timestamp of when the webhook was sent
+      # - `webhook-signature` - HMAC-SHA256 signature in format `v1,{base64_signature}`
+      #
+      # Store the returned `secret` securely - you'll need it to verify webhook
+      # signatures.
+      #
+      # @overload create(url:, description: nil, event_types: nil, request_options: {})
+      #
+      # @param url [String] The URL to send webhook events to
+      #
+      # @param description [String, nil] Optional description for this webhook
+      #
+      # @param event_types [Array<Symbol, ::Believe::Models::WebhookCreateParams::EventType>, nil] List of event types to subscribe to. If not provided, subscribes to all events.
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::WebhookCreateResponse]
+      #
+      # @see ::Believe::Models::WebhookCreateParams
+      def create(params)
+        parsed, options = ::Believe::WebhookCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "webhooks",
+          body: parsed,
+          model: ::Believe::Models::WebhookCreateResponse,
+          options: options
+        )
+      end
+
+      # Get details of a specific webhook endpoint.
+      #
+      # @overload retrieve(webhook_id, request_options: {})
+      #
+      # @param webhook_id [String]
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::RegisteredWebhook]
+      #
+      # @see ::Believe::Models::WebhookRetrieveParams
+      def retrieve(webhook_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["webhooks/%1$s", webhook_id],
+          model: ::Believe::RegisteredWebhook,
+          options: params[:request_options]
+        )
+      end
+
+      # Get a list of all registered webhook endpoints.
+      #
+      # @overload list(request_options: {})
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Array<::Believe::Models::RegisteredWebhook>]
+      #
+      # @see ::Believe::Models::WebhookListParams
+      def list(params = {})
+        @client.request(
+          method: :get,
+          path: "webhooks",
+          model: ::Believe::Internal::Type::ArrayOf[::Believe::RegisteredWebhook],
+          options: params[:request_options]
+        )
+      end
+
+      # Unregister a webhook endpoint. It will no longer receive events.
+      #
+      # @overload delete(webhook_id, request_options: {})
+      #
+      # @param webhook_id [String]
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Hash{Symbol=>Object}]
+      #
+      # @see ::Believe::Models::WebhookDeleteParams
+      def delete(webhook_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["webhooks/%1$s", webhook_id],
+          model: ::Believe::Internal::Type::HashOf[::Believe::Internal::Type::Unknown],
+          options: params[:request_options]
+        )
+      end
+
+      # Trigger a webhook event and deliver it to all subscribed endpoints.
+      #
+      # This endpoint is useful for testing your webhook integration. It will:
+      #
+      # 1. Generate an event with the specified type and payload
+      # 2. Find all webhooks subscribed to that event type
+      # 3. Send a POST request to each webhook URL with signature headers
+      # 4. Return the delivery results
+      #
+      # ## Event Payload
+      #
+      # You can provide a custom payload, or leave it empty to use a sample payload.
+      #
+      # ## Webhook Signature Headers
+      #
+      # Each webhook delivery includes:
+      #
+      # - `webhook-id` - Unique event identifier (e.g., `evt_abc123...`)
+      # - `webhook-timestamp` - Unix timestamp
+      # - `webhook-signature` - HMAC-SHA256 signature (`v1,{base64}`)
+      #
+      # To verify signatures, compute:
+      #
+      # ```
+      # signature = HMAC-SHA256(
+      #     key = base64_decode(secret_without_prefix),
+      #     message = "{timestamp}.{raw_json_payload}"
+      # )
+      # ```
+      #
+      # @overload trigger_event(event_type:, payload: nil, request_options: {})
+      #
+      # @param event_type [Symbol, ::Believe::Models::WebhookTriggerEventParams::EventType] The type of event to trigger
+      #
+      # @param payload [::Believe::Models::WebhookTriggerEventParams::Payload::MatchCompleted, ::Believe::Models::WebhookTriggerEventParams::Payload::TeamMemberTransferred, nil] Optional event payload. If not provided, a sample payload will be generated.
+      #
+      # @param request_options [::Believe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::Believe::Models::WebhookTriggerEventResponse]
+      #
+      # @see ::Believe::Models::WebhookTriggerEventParams
+      def trigger_event(params)
+        parsed, options = ::Believe::WebhookTriggerEventParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "webhooks/trigger",
+          body: parsed,
+          model: ::Believe::Models::WebhookTriggerEventResponse,
+          options: options
+        )
+      end
+
+      # @param payload [String] The raw webhook payload as a string
+      #
+      # @return [::Believe::Models::MatchCompletedWebhookEvent, ::Believe::Models::TeamMemberTransferredWebhookEvent]
+      def unwrap(payload)
+        parsed = JSON.parse(payload, symbolize_names: true)
+        ::Believe::Internal::Type::Converter.coerce(::Believe::Models::UnwrapWebhookEvent, parsed)
+      end
+
+      # @api private
+      #
+      # @param client [::Believe::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/believe/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Believe
+  VERSION = "0.7.0"
+end

data/lib/believe.rb

@@ -0,0 +1,215 @@
+# frozen_string_literal: true
+
+# Standard libraries.
+# rubocop:disable Lint/RedundantRequireStatement
+require "English"
+require "base64"
+require "cgi"
+require "date"
+require "erb"
+require "etc"
+require "json"
+require "net/http"
+require "openssl"
+require "pathname"
+require "rbconfig"
+require "securerandom"
+require "set"
+require "stringio"
+require "time"
+require "uri"
+# rubocop:enable Lint/RedundantRequireStatement
+
+# We already ship the preferred sorbet manifests in the package itself.
+# `tapioca` currently does not offer us a way to opt out of unnecessary compilation.
+if Object.const_defined?(:Tapioca) &&
+   caller.chain([$PROGRAM_NAME]).chain(ARGV).any?(/tapioca/) &&
+   ARGV.none?(/dsl/)
+  return
+end
+
+# Gems.
+require "connection_pool"
+
+# Package files.
+require_relative "believe/version"
+require_relative "believe/internal/util"
+require_relative "believe/internal/type/converter"
+require_relative "believe/internal/type/unknown"
+require_relative "believe/internal/type/boolean"
+require_relative "believe/internal/type/file_input"
+require_relative "believe/internal/type/enum"
+require_relative "believe/internal/type/union"
+require_relative "believe/internal/type/array_of"
+require_relative "believe/internal/type/hash_of"
+require_relative "believe/internal/type/base_model"
+require_relative "believe/internal/type/base_page"
+require_relative "believe/internal/type/request_parameters"
+require_relative "believe/internal"
+require_relative "believe/request_options"
+require_relative "believe/file_part"
+require_relative "believe/errors"
+require_relative "believe/internal/transport/base_client"
+require_relative "believe/internal/transport/pooled_net_requester"
+require_relative "believe/client"
+require_relative "believe/internal/skip_limit_page"
+require_relative "believe/models/believe_submit_params"
+require_relative "believe/models/believe_submit_response"
+require_relative "believe/models/biscuit"
+require_relative "believe/models/biscuit_get_fresh_params"
+require_relative "believe/models/biscuit_list_params"
+require_relative "believe/models/biscuit_retrieve_params"
+require_relative "believe/models/character"
+require_relative "believe/models/character_create_params"
+require_relative "believe/models/character_delete_params"
+require_relative "believe/models/character_get_quotes_params"
+require_relative "believe/models/character_get_quotes_response"
+require_relative "believe/models/character_list_params"
+require_relative "believe/models/character_retrieve_params"
+require_relative "believe/models/character_role"
+require_relative "believe/models/character_update_params"
+require_relative "believe/models/client/w_test_params"
+require_relative "believe/models/client_get_welcome_params"
+require_relative "believe/models/coach"
+require_relative "believe/models/coaching/coaching_principle"
+require_relative "believe/models/coaching/principle_get_random_params"
+require_relative "believe/models/coaching/principle_list_params"
+require_relative "believe/models/coaching/principle_retrieve_params"
+require_relative "believe/models/coach_specialty"
+require_relative "believe/models/conflict_resolve_params"
+require_relative "believe/models/conflict_resolve_response"
+require_relative "believe/models/emotional_stats"
+require_relative "believe/models/episode"
+require_relative "believe/models/episode_create_params"
+require_relative "believe/models/episode_delete_params"
+require_relative "believe/models/episode_get_wisdom_params"
+require_relative "believe/models/episode_get_wisdom_response"
+require_relative "believe/models/episode_list_params"
+require_relative "believe/models/episode_retrieve_params"
+require_relative "believe/models/episode_update_params"
+require_relative "believe/models/equipment_manager"
+require_relative "believe/models/geo_location"
+require_relative "believe/models/get_welcome_response"
+require_relative "believe/models/growth_arc"
+require_relative "believe/models/health_check_params"
+require_relative "believe/models/health_check_response"
+require_relative "believe/models/league"
+require_relative "believe/models/match"
+require_relative "believe/models/match_completed_webhook_event"
+require_relative "believe/models/match_create_params"
+require_relative "believe/models/match_delete_params"
+require_relative "believe/models/matches/commentary_stream_params"
+require_relative "believe/models/matches/commentary_stream_response"
+require_relative "believe/models/match_get_lesson_params"
+require_relative "believe/models/match_get_lesson_response"
+require_relative "believe/models/match_get_turning_points_params"
+require_relative "believe/models/match_get_turning_points_response"
+require_relative "believe/models/match_list_params"
+require_relative "believe/models/match_result"
+require_relative "believe/models/match_retrieve_params"
+require_relative "believe/models/match_stream_live_params"
+require_relative "believe/models/match_type"
+require_relative "believe/models/match_update_params"
+require_relative "believe/models/medical_specialty"
+require_relative "believe/models/medical_staff"
+require_relative "believe/models/paginated_response"
+require_relative "believe/models/paginated_response_quote"
+require_relative "believe/models/pep_talk_retrieve_params"
+require_relative "believe/models/pep_talk_retrieve_response"
+require_relative "believe/models/player"
+require_relative "believe/models/position"
+require_relative "believe/models/press_simulate_params"
+require_relative "believe/models/press_simulate_response"
+require_relative "believe/models/purchase_method"
+require_relative "believe/models/quote"
+require_relative "believe/models/quote_create_params"
+require_relative "believe/models/quote_delete_params"
+require_relative "believe/models/quote_get_random_params"
+require_relative "believe/models/quote_list_by_character_params"
+require_relative "believe/models/quote_list_by_theme_params"
+require_relative "believe/models/quote_list_params"
+require_relative "believe/models/quote_moment"
+require_relative "believe/models/quote_retrieve_params"
+require_relative "believe/models/quote_theme"
+require_relative "believe/models/quote_update_params"
+require_relative "believe/models/reframe_transform_negative_thoughts_params"
+require_relative "believe/models/reframe_transform_negative_thoughts_response"
+require_relative "believe/models/registered_webhook"
+require_relative "believe/models/stream_test_connection_params"
+require_relative "believe/models/stream_test_connection_response"
+require_relative "believe/models/team"
+require_relative "believe/models/team_create_params"
+require_relative "believe/models/team_delete_params"
+require_relative "believe/models/team_get_culture_params"
+require_relative "believe/models/team_get_culture_response"
+require_relative "believe/models/team_get_rivals_params"
+require_relative "believe/models/team_get_rivals_response"
+require_relative "believe/models/team_list_logos_params"
+require_relative "believe/models/team_list_logos_response"
+require_relative "believe/models/team_list_params"
+require_relative "believe/models/team_member_create_params"
+require_relative "believe/models/team_member_create_response"
+require_relative "believe/models/team_member_delete_params"
+require_relative "believe/models/team_member_list_coaches_params"
+require_relative "believe/models/team_member_list_params"
+require_relative "believe/models/team_member_list_players_params"
+require_relative "believe/models/team_member_list_response"
+require_relative "believe/models/team_member_list_staff_params"
+require_relative "believe/models/team_member_list_staff_response"
+require_relative "believe/models/team_member_retrieve_params"
+require_relative "believe/models/team_member_retrieve_response"
+require_relative "believe/models/team_member_transferred_webhook_event"
+require_relative "believe/models/team_member_update_params"
+require_relative "believe/models/team_member_update_response"
+require_relative "believe/models/team_retrieve_params"
+require_relative "believe/models/teams/file_upload"
+require_relative "believe/models/teams/logo_delete_params"
+require_relative "believe/models/teams/logo_download_params"
+require_relative "believe/models/teams/logo_download_response"
+require_relative "believe/models/teams/logo_upload_params"
+require_relative "believe/models/team_update_params"
+require_relative "believe/models/team_values"
+require_relative "believe/models/ticket_sale"
+require_relative "believe/models/ticket_sale_create_params"
+require_relative "believe/models/ticket_sale_delete_params"
+require_relative "believe/models/ticket_sale_list_params"
+require_relative "believe/models/ticket_sale_retrieve_params"
+require_relative "believe/models/ticket_sale_update_params"
+require_relative "believe/models/turning_point"
+require_relative "believe/models/unwrap_webhook_event"
+require_relative "believe/models/version_retrieve_params"
+require_relative "believe/models/version_retrieve_response"
+require_relative "believe/models/webhook_create_params"
+require_relative "believe/models/webhook_create_response"
+require_relative "believe/models/webhook_delete_params"
+require_relative "believe/models/webhook_delete_response"
+require_relative "believe/models/webhook_list_params"
+require_relative "believe/models/webhook_list_response"
+require_relative "believe/models/webhook_retrieve_params"
+require_relative "believe/models/webhook_trigger_event_params"
+require_relative "believe/models/webhook_trigger_event_response"
+require_relative "believe/models/webhook_unwrap_params"
+require_relative "believe/models"
+require_relative "believe/resources/believe"
+require_relative "believe/resources/biscuits"
+require_relative "believe/resources/characters"
+require_relative "believe/resources/client"
+require_relative "believe/resources/client/ws"
+require_relative "believe/resources/coaching"
+require_relative "believe/resources/coaching/principles"
+require_relative "believe/resources/conflicts"
+require_relative "believe/resources/episodes"
+require_relative "believe/resources/health"
+require_relative "believe/resources/matches"
+require_relative "believe/resources/matches/commentary"
+require_relative "believe/resources/pep_talk"
+require_relative "believe/resources/press"
+require_relative "believe/resources/quotes"
+require_relative "believe/resources/reframe"
+require_relative "believe/resources/stream"
+require_relative "believe/resources/team_members"
+require_relative "believe/resources/teams"
+require_relative "believe/resources/teams/logo"
+require_relative "believe/resources/ticket_sales"
+require_relative "believe/resources/version"
+require_relative "believe/resources/webhooks"

data/manifest.yaml

@@ -0,0 +1,17 @@
+dependencies:
+  - English
+  - base64
+  - cgi
+  - date
+  - erb
+  - etc
+  - json
+  - net/http
+  - openssl
+  - pathname
+  - rbconfig
+  - securerandom
+  - set
+  - stringio
+  - time
+  - uri