exaonruby 1.0.0

data/lib/exa/resources/search_response.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+# typed: strict
+
+module Exa
+  module Resources
+    class SearchResponse < Base
+      # @return [String] Unique request identifier
+      def request_id
+        get(:request_id)
+      end
+
+      # @return [String, nil] The search type that was resolved/used
+      def resolved_search_type
+        get(:resolved_search_type)
+      end
+
+      # @return [String, nil] The search type (for auto searches)
+      def search_type
+        get(:search_type)
+      end
+
+      # @return [Array<SearchResult>] Search results
+      def results
+        @results ||= (get(:results, []) || []).map { |data| SearchResult.new(data) }
+      end
+
+      # @return [String, nil] Combined context string for LLM consumption
+      def context
+        get(:context)
+      end
+
+      # @return [CostInfo, nil] Cost information for the request
+      def cost
+        cost_data = get(:cost_dollars)
+        return nil unless cost_data
+
+        CostInfo.new(cost_data)
+      end
+
+      # @return [Float] Total cost in dollars
+      def total_cost
+        cost&.total || 0.0
+      end
+
+      # @return [Integer] Number of results
+      def count
+        results.length
+      end
+
+      # @return [Boolean] Whether results are empty
+      def empty?
+        results.empty?
+      end
+
+      # Iterates over each result
+      # @yield [SearchResult] Each result
+      # @return [Enumerator, self]
+      def each(&block)
+        return results.each unless block
+
+        results.each(&block)
+        self
+      end
+
+      # @param index [Integer] Index of result
+      # @return [SearchResult, nil] Result at index
+      def [](index)
+        results[index]
+      end
+
+      # @return [SearchResult, nil] First result
+      def first
+        results.first
+      end
+
+      # @return [SearchResult, nil] Last result
+      def last
+        results.last
+      end
+
+      private
+
+      def inspectable_attributes
+        { request_id: request_id, count: count }
+      end
+    end
+
+    class CostInfo < Base
+      # @return [Float] Total cost in dollars
+      def total
+        get(:total, 0.0)
+      end
+
+      # @return [Array<Hash>] Breakdown of costs
+      def breakdown
+        get(:break_down, [])
+      end
+
+      # @return [Hash] Per-request price information
+      def per_request_prices
+        get(:per_request_prices, {})
+      end
+
+      # @return [Hash] Per-page price information
+      def per_page_prices
+        get(:per_page_prices, {})
+      end
+    end
+  end
+end

data/lib/exa/resources/search_result.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+# typed: strict
+
+module Exa
+  module Resources
+    class SearchResult < Base
+      # @return [String] Unique identifier for the result
+      def id
+        get(:id)
+      end
+
+      # @return [String] Title of the page
+      def title
+        get(:title)
+      end
+
+      # @return [String] URL of the page
+      def url
+        get(:url)
+      end
+
+      # @return [Time, nil] Published date of the content
+      def published_date
+        date_str = get(:published_date)
+        return nil unless date_str
+
+        Time.parse(date_str)
+      rescue ArgumentError
+        nil
+      end
+
+      # @return [String, nil] Author of the content
+      def author
+        get(:author)
+      end
+
+      # @return [String, nil] URL of the page image
+      def image
+        get(:image)
+      end
+
+      # @return [String, nil] URL of the page favicon
+      def favicon
+        get(:favicon)
+      end
+
+      # @return [Float, nil] Relevance score
+      def score
+        get(:score)
+      end
+
+      # @return [String, nil] Full text content of the page
+      def text
+        get(:text)
+      end
+
+      # @return [Array<String>] Highlighted text snippets
+      def highlights
+        get(:highlights, [])
+      end
+
+      # @return [Array<Float>] Scores for each highlight
+      def highlight_scores
+        get(:highlight_scores, [])
+      end
+
+      # @return [String, nil] AI-generated summary
+      def summary
+        get(:summary)
+      end
+
+      # @return [Array<SearchResult>] Related subpages
+      def subpages
+        (get(:subpages, []) || []).map { |data| SearchResult.new(data) }
+      end
+
+      # @return [Hash] Extra metadata
+      def extras
+        get(:extras, {})
+      end
+
+      # @return [Array<String>] Links found on the page
+      def links
+        dig(:extras, :links) || []
+      end
+
+      private
+
+      def inspectable_attributes
+        { id: id, title: title, url: url }
+      end
+    end
+  end
+end

data/lib/exa/resources/webhook.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+# typed: strict
+
+module Exa
+  module Resources
+    class Webhook < Base
+      # @return [String] Unique identifier
+      def id
+        get(:id)
+      end
+
+      # @return [String] Object type
+      def object
+        get(:object)
+      end
+
+      # @return [String] Status: active, inactive
+      def status
+        get(:status)
+      end
+
+      # @return [Array<String>] Subscribed event types
+      def events
+        get(:events, [])
+      end
+
+      # @return [String] Webhook URL
+      def url
+        get(:url)
+      end
+
+      # @return [String, nil] Secret for signature verification (only on creation)
+      def secret
+        get(:secret)
+      end
+
+      # @return [Hash] Custom metadata
+      def metadata
+        get(:metadata, {})
+      end
+
+      # @return [Time, nil] Creation timestamp
+      def created_at
+        parse_time(get(:created_at))
+      end
+
+      # @return [Time, nil] Last update timestamp
+      def updated_at
+        parse_time(get(:updated_at))
+      end
+
+      # @return [Boolean] Whether webhook is active
+      def active?
+        status == "active"
+      end
+
+      # @return [Boolean] Whether webhook is inactive
+      def inactive?
+        status == "inactive"
+      end
+
+      private
+
+      def parse_time(value)
+        return nil unless value
+
+        Time.parse(value)
+      rescue ArgumentError
+        nil
+      end
+
+      def inspectable_attributes
+        { id: id, status: status, url: url }
+      end
+    end
+
+    class WebhookAttempt < Base
+      # @return [String] Unique identifier
+      def id
+        get(:id)
+      end
+
+      # @return [String] Object type
+      def object
+        get(:object)
+      end
+
+      # @return [String] Webhook ID
+      def webhook_id
+        get(:webhook_id)
+      end
+
+      # @return [String] Event ID
+      def event_id
+        get(:event_id)
+      end
+
+      # @return [String] Event type
+      def event_type
+        get(:event_type)
+      end
+
+      # @return [Integer, nil] HTTP response status code
+      def response_status
+        get(:response_status)
+      end
+
+      # @return [String, nil] Response body
+      def response_body
+        get(:response_body)
+      end
+
+      # @return [Boolean] Whether delivery succeeded
+      def success?
+        response_status && response_status >= 200 && response_status < 300
+      end
+
+      # @return [Time, nil] Attempt timestamp
+      def attempted_at
+        parse_time(get(:attempted_at))
+      end
+
+      # @return [Time, nil] Creation timestamp
+      def created_at
+        parse_time(get(:created_at))
+      end
+
+      private
+
+      def parse_time(value)
+        return nil unless value
+
+        Time.parse(value)
+      rescue ArgumentError
+        nil
+      end
+    end
+
+    class WebhookListResponse < PaginatedResponse
+      def data
+        @data ||= (get(:data, []) || []).map { |item| Webhook.new(item) }
+      end
+    end
+
+    class WebhookAttemptListResponse < PaginatedResponse
+      def data
+        @data ||= (get(:data, []) || []).map { |item| WebhookAttempt.new(item) }
+      end
+    end
+  end
+end