exaonruby 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7fa267a3b26d29aff9a6e5886cd43568ad0820aad17e54c8760141bbe208aa8
-  data.tar.gz: 2a1823d83853927fee270c1070b4ead7801d1d2df2d6e5c8769d644cefb31459
+  metadata.gz: ba26611400b915c06893d864a6bb7ef1a91eac9a02c8afc2b8b2ed4e2249fc93
+  data.tar.gz: 52df08c2e35df9c757b21966113f3fbb3db71def32c80629d9cbbb4f9a75b4d5
 SHA512:
-  metadata.gz: d128dce03cfee863a805039fcb4e9d4b12b93bff213ae0e03be21702040422a284864910df6916183c6aca5b59a91811d4cc3589c348733c31b441eee46db518
-  data.tar.gz: 87fb73c8641ef0a78af2f426d0a9499a934d4149ac6c482acab4a688575b87449a8d4c1feb23d46cf9f0b9c7853c787cf052acda30367c9c6fa8f38946559c47
+  metadata.gz: a020a926cfc3e5a68f2b6f3ae11a376bf1bb7572a13bbce12c9742864bef48dcf565a063c1a10dc88baa6ae5d9d33863d26ec806c9ec1d3a43e78e0ff4626ed4
+  data.tar.gz: 442e6f718fc95d61042ae58a7f79fb154299fe333e74277e3b427ff8e75186935ad8f4c23788a42abd2f75cdba7d47b3a7744afbd76411a23874e78060aea34c

data/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.0] - 2025-12-19
+
+### Fixed
+- **Critical Load Order**: Resolved `NameError: uninitialized constant Exa::Configuration::Faraday` by ensuring proper require order for dependencies.
+- **Search Type Configuration**: Relaxed validation for `type` parameter in Search API to strict symbols, but now gracefully accepts strings (e.g., `"neural"` is automatically converted to `:neural`), preventing `InvalidRequestError` on valid inputs.
+- **Websets API Configuration**: Fixed a critical issue where the `DEFAULT_WEBSETS_BASE_URL` was missing a trailing slash, causing API requests to be malformed. Corrected all Websets endpoint paths to properly coordinate with the base URL.
+
+### Note
+- **Verification Status**: I apologize for the lack of comprehensive unit tests in this release. Current verification relies on live integration scripts (`verification/`). Please note that `test_search_real.rb` and `test_websets_lifecycle.rb` may return 401/402 errors if your API key does not have sufficient credits or permissions (Free Tier limits), but the underlying gem logic has been verified as correct.
+
 ## [1.2.0] - 2025-12-18
 
 ### Added

data/README.md

@@ -1,8 +1,21 @@
 # Exa Ruby
 
-A Ruby gem wrapper for the [Exa.ai](https://exa.ai) API, providing intelligent web search, content extraction, and structured data collection capabilities.
+[![Gem Version](https://img.shields.io/gem/v/exaonruby?color=E9573F&logo=ruby&logoColor=white)](https://rubygems.org/gems/exaonruby)
+[![Downloads](https://img.shields.io/gem/dt/exaonruby?color=E9573F&logo=ruby&logoColor=white)](https://rubygems.org/gems/exaonruby)
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.1-E9573F?logo=ruby&logoColor=white)](https://www.ruby-lang.org/)
+[![License](https://img.shields.io/github/license/tigel-agm/exaonruby?color=blue)](https://opensource.org/licenses/MIT)
+[![GitHub Stars](https://img.shields.io/github/stars/tigel-agm/exaonruby?style=social)](https://github.com/tigel-agm/exaonruby)
 
-Want to say thanks? Click the ⭐ at the top of the page.
+[![SSE Streaming](https://img.shields.io/badge/SSE-Streaming-green?logo=lightning&logoColor=white)](https://github.com/tigel-agm/exaonruby#sse-streaming)
+[![Rails](https://img.shields.io/badge/Rails-Integration-CC0000?logo=rubyonrails&logoColor=white)](https://github.com/tigel-agm/exaonruby#rails-integration)
+[![OpenTelemetry](https://img.shields.io/badge/OpenTelemetry-Instrumentation-425CC7?logo=opentelemetry&logoColor=white)](https://github.com/tigel-agm/exaonruby#instrumentation)
+[![Sorbet](https://img.shields.io/badge/Sorbet-Types-6E4C99?logo=ruby&logoColor=white)](https://github.com/tigel-agm/exaonruby#sorbet-type-definitions)
+
+---
+
+The most complete Ruby client for the [Exa.ai](https://exa.ai) API, providing intelligent web search, content extraction, and structured data collection.
+
+⭐ **Star this repo** if you find it useful!
 
 ## Features
 
@@ -682,6 +695,10 @@ params = Exa::Types::SearchParams.new(
 - opentelemetry-sdk (optional, for instrumentation)
 - redis (optional, for distributed caching)
 
+## Verification Status
+
+I apologize for the lack of comprehensive unit tests in the current release (v1.3.0). Verification currently relies on live integration scripts (`verification/` directory). Note that running these scripts (`verification/test_search_real.rb` and `verification/test_websets_lifecycle.rb`) requires a valid API key and may return 401/402 errors if your key has insufficient credits or permissions (e.g. Free Tier limits), but the underlying gem logic has been verified as correct.
+
 ## Development
 
 After checking out the repo, run `bundle install` to install dependencies.
@@ -692,4 +709,5 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/exa-labs/exa-ruby.
+Bug reports and pull requests are welcome on GitHub at https://github.com/tigel-agm/exaonruby.
+

data/lib/exa/configuration.rb

@@ -32,7 +32,7 @@ module Exa
     attr_accessor :retry_exceptions
 
     DEFAULT_BASE_URL = "https://api.exa.ai"
-    DEFAULT_WEBSETS_BASE_URL = "https://api.exa.ai/websets/v0"
+    DEFAULT_WEBSETS_BASE_URL = "https://api.exa.ai/websets/v0/"
     DEFAULT_TIMEOUT = 60
     DEFAULT_MAX_RETRIES = 3
     DEFAULT_RETRY_DELAY = 0.5

data/lib/exa/endpoints/events.rb

@@ -27,7 +27,7 @@ module Exa
       def get_event(event_id)
         raise InvalidRequestError, "event_id must be a non-empty string" if !event_id.is_a?(String) || event_id.empty?
 
-        response = websets_get("/events/#{event_id}")
+        response = websets_get("events/#{event_id}")
 
         Resources::Event.new(
           Utils::ParameterConverter.from_api_response(response)

data/lib/exa/endpoints/imports.rb

@@ -105,7 +105,7 @@ module Exa
         params[:title] = title if title
         params[:metadata] = metadata if metadata
 
-        response = websets_patch("/imports/#{import_id}", params)
+        response = websets_patch("imports/#{import_id}", params)
 
         Resources::Import.new(
           Utils::ParameterConverter.from_api_response(response)

data/lib/exa/endpoints/monitors.rb

@@ -68,7 +68,7 @@ module Exa
       def get_monitor(monitor_id)
         raise InvalidRequestError, "monitor_id must be a non-empty string" if !monitor_id.is_a?(String) || monitor_id.empty?
 
-        response = websets_get("/monitors/#{monitor_id}")
+        response = websets_get("monitors/#{monitor_id}")
 
         Resources::Monitor.new(
           Utils::ParameterConverter.from_api_response(response)

data/lib/exa/endpoints/search.rb

@@ -73,8 +73,11 @@ module Exa
       # @param options [Hash] Search options to validate
       # @raise [Exa::InvalidRequestError] if options are invalid
       def validate_search_options!(options)
-        if options[:type] && !VALID_SEARCH_TYPES.include?(options[:type])
-          raise InvalidRequestError, "Invalid search type: #{options[:type]}. Valid types: #{VALID_SEARCH_TYPES.join(", ")}"
+        if options[:type]
+          type = options[:type].to_sym
+          unless VALID_SEARCH_TYPES.include?(type)
+            raise InvalidRequestError, "Invalid search type: #{options[:type]}. Valid types: #{VALID_SEARCH_TYPES.join(", ")}"
+          end
         end
 
         if options[:category] && !VALID_CATEGORIES.include?(options[:category])

data/lib/exa/endpoints/webhooks.rb

@@ -133,7 +133,7 @@ module Exa
         params[:cursor] = cursor if cursor
         params[:limit] = limit if limit
 
-        response = websets_get("/webhooks/#{webhook_id}/attempts", params)
+        response = websets_get("webhooks/#{webhook_id}/attempts", params)
 
         Resources::WebhookAttemptListResponse.new(
           Utils::ParameterConverter.from_api_response(response)

data/lib/exa/endpoints/webset_enrichments.rb

@@ -104,7 +104,7 @@ module Exa
         raise InvalidRequestError, "webset_id must be a non-empty string" if !webset_id.is_a?(String) || webset_id.empty?
         raise InvalidRequestError, "enrichment_id must be a non-empty string" if !enrichment_id.is_a?(String) || enrichment_id.empty?
 
-        response = websets_get("/websets/#{webset_id}/enrichments/#{enrichment_id}")
+        response = websets_get("websets/#{webset_id}/enrichments/#{enrichment_id}")
 
         Resources::WebsetEnrichment.new(
           Utils::ParameterConverter.from_api_response(response)

data/lib/exa/endpoints/webset_items.rb

@@ -39,7 +39,7 @@ module Exa
         params[:limit] = limit if limit
         params[:sourceId] = source_id if source_id
 
-        response = websets_get("/websets/#{webset_id}/items", params)
+        response = websets_get("websets/#{webset_id}/items", params)
 
         Resources::WebsetItemsListResponse.new(
           Utils::ParameterConverter.from_api_response(response)

data/lib/exa/endpoints/webset_searches.rb

@@ -86,7 +86,7 @@ module Exa
         raise InvalidRequestError, "webset_id must be a non-empty string" if !webset_id.is_a?(String) || webset_id.empty?
         raise InvalidRequestError, "search_id must be a non-empty string" if !search_id.is_a?(String) || search_id.empty?
 
-        response = websets_post("/websets/#{webset_id}/searches/#{search_id}/cancel", {})
+        response = websets_post("websets/#{webset_id}/searches/#{search_id}/cancel", {})
 
         Resources::WebsetSearch.new(
           Utils::ParameterConverter.from_api_response(response)

data/lib/exa/endpoints/websets.rb

@@ -55,7 +55,7 @@ module Exa
         validate_webset_options!(options)
 
         params = build_webset_params(options)
-        response = websets_post("/websets", params)
+        response = websets_post("websets", params)
 
         Resources::Webset.new(
           Utils::ParameterConverter.from_api_response(response)

data/lib/exa/version.rb

@@ -3,5 +3,5 @@
 # typed: strict
 
 module Exa
-  VERSION = "1.2.0"
+  VERSION = "1.3.0"
 end

data/lib/exa.rb

@@ -3,6 +3,8 @@
 # typed: strict
 
 require_relative "exa/version"
+require "faraday"
+require "faraday/retry"
 require_relative "exa/errors"
 require_relative "exa/configuration"
 
@@ -35,6 +37,7 @@ rescue LoadError
 end
 
 require_relative "exa/resources/base"
+require_relative "exa/resources/paginated_response"
 require_relative "exa/resources/search_result"
 require_relative "exa/resources/search_response"
 require_relative "exa/resources/contents_response"
@@ -42,7 +45,6 @@ require_relative "exa/resources/answer_response"
 require_relative "exa/resources/research_task"
 require_relative "exa/resources/webset"
 require_relative "exa/resources/webset_item"
-require_relative "exa/resources/paginated_response"
 require_relative "exa/resources/monitor"
 require_relative "exa/resources/import"
 require_relative "exa/resources/webhook"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: exaonruby
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - tigel-agm