minato_ruby_api_client 0.2.8 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 02fb9f5aacc6d902765edab876eaf8683524cf4e316c0904942cbc264e0752f4
-  data.tar.gz: ef183cfd8211a90cbce9a0a0ad289f3ffb14bdc3d265ed3e3ce1db6e6232a5dd
+  metadata.gz: 430a3104ab0c69e3c62ba990f3fb91029a85f257525c56e6a35f58b88a9a94bd
+  data.tar.gz: eec830c93eab4c0f5b395adf4f1b65a93c8b92add998c7d095b9adb10f0c0249
 SHA512:
-  metadata.gz: 4ac4f87be5a401c6cb4cb69eae9e77119883304eb9bea5cc6a66966bc3906d63d11d1b1f1338c37d5d879ee8b5b58ac63aa8c931bda6ed16d51408f9f8823165
-  data.tar.gz: d45d5bdfc88e0ac4d53845f1c8afc2eba032a6255b10545253e4555cb53a153c617a0bdbcb5c2dc7b9dd9681b07f980639dd9af86a3e24bcdc97d519b164307d
+  metadata.gz: '0119f09dc1d07e5901b65979adfcc4025f269fbdc321861790fa78562dd18bf49ef093d76473ae160e92982c8e585eb0ef4972e77ea02eaa11935e668feadb19'
+  data.tar.gz: f5040c62fb32554a3fa83c14b9368a6d7e0647d629dca7aafd125442b0e3816c38eb580977f12479d501093cee7561d8a9383023d18d5719a3e9ddad48ae8d80

data/CHANGELOG.md

@@ -5,6 +5,17 @@ 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.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0]
+
+### Changed
+
+- Switch the Faraday adapter from `net_http` to `async_http` (`async-http-faraday`) so requests no longer block the underlying thread inside Falcon's fiber scheduler.
+- Require Faraday `>= 2.0` (needed by `async-http-faraday`).
+
+### Fixed
+
+- `ApiError#caused_by` now falls back to the standard HTTP status text when the adapter does not expose a custom reason phrase (the `async_http` adapter does not preserve it, unlike `net_http`).
+
 ## [0.2.0]
 
 ### Added

data/Gemfile.lock

@@ -1,10 +1,12 @@
 PATH
   remote: .
   specs:
-    minato_ruby_api_client (0.2.8)
-      faraday (>= 1.0, < 3.0)
+    minato_ruby_api_client (0.3.0)
+      async-http-faraday (>= 0.19)
+      faraday (>= 2.0, < 3.0)
       minato-trace (>= 0.2.0)
       minato_error_handler (>= 0.1.13)
+      rack (>= 2.0)
 
 GEM
   remote: https://rubygems.org/
@@ -86,6 +88,28 @@ GEM
     addressable (2.8.7)
       public_suffix (>= 2.0.2, < 7.0)
     ast (2.4.3)
+    async (2.37.0)
+      console (~> 1.29)
+      fiber-annotation
+      io-event (~> 1.11)
+      metrics (~> 0.12)
+      traces (~> 0.18)
+    async-http (0.94.2)
+      async (>= 2.10.2)
+      async-pool (~> 0.11)
+      io-endpoint (~> 0.14)
+      io-stream (~> 0.6)
+      metrics (~> 0.12)
+      protocol-http (~> 0.58)
+      protocol-http1 (~> 0.36)
+      protocol-http2 (~> 0.22)
+      protocol-url (~> 0.2)
+      traces (~> 0.10)
+    async-http-faraday (0.22.1)
+      async-http (~> 0.42)
+      faraday
+    async-pool (0.11.2)
+      async (>= 2.0)
     base64 (0.3.0)
     bigdecimal (3.3.1)
     builder (3.3.0)
@@ -93,6 +117,10 @@ GEM
     coderay (1.1.3)
     concurrent-ruby (1.3.5)
     connection_pool (2.5.4)
+    console (1.34.3)
+      fiber-annotation
+      fiber-local (~> 1.1)
+      json
     crack (1.0.1)
       bigdecimal
       rexml
@@ -103,29 +131,18 @@ GEM
     drb (2.2.3)
     erb (6.0.0)
     erubi (1.13.1)
-    faraday (1.10.4)
-      faraday-em_http (~> 1.0)
-      faraday-em_synchrony (~> 1.0)
-      faraday-excon (~> 1.1)
-      faraday-httpclient (~> 1.0)
-      faraday-multipart (~> 1.0)
-      faraday-net_http (~> 1.0)
-      faraday-net_http_persistent (~> 1.0)
-      faraday-patron (~> 1.0)
-      faraday-rack (~> 1.0)
-      faraday-retry (~> 1.0)
-      ruby2_keywords (>= 0.0.4)
-    faraday-em_http (1.0.0)
-    faraday-em_synchrony (1.0.1)
-    faraday-excon (1.1.0)
-    faraday-httpclient (1.0.1)
-    faraday-multipart (1.1.1)
-      multipart-post (~> 2.0)
-    faraday-net_http (1.0.2)
-    faraday-net_http_persistent (1.2.0)
-    faraday-patron (1.0.0)
-    faraday-rack (1.0.0)
-    faraday-retry (1.0.3)
+    faraday (2.14.3)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.4)
+      net-http (~> 0.5)
+    faraday-retry (2.4.0)
+      faraday (~> 2.0)
+    fiber-annotation (0.2.0)
+    fiber-local (1.1.0)
+      fiber-storage
+    fiber-storage (1.0.1)
     gapic-common (1.2.0)
       faraday (>= 1.9, < 3.a)
       faraday-retry (>= 1.0, < 3.a)
@@ -218,11 +235,14 @@ GEM
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
     io-console (0.8.1)
+    io-endpoint (0.17.2)
+    io-event (1.11.2)
+    io-stream (0.11.1)
     irb (1.15.3)
       pp (>= 0.6.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.16.0)
+    json (2.21.2)
     jwt (3.1.2)
       base64
     language_server-protocol (3.17.0.5)
@@ -238,6 +258,7 @@ GEM
       net-smtp
     marcel (1.1.0)
     method_source (1.1.0)
+    metrics (0.15.0)
     minato-trace (0.2.0)
       google-cloud-trace (~> 0.42.2)
       rails (>= 7.0.0)
@@ -246,7 +267,8 @@ GEM
     mini_mime (1.1.5)
     minitest (5.26.2)
     multi_json (1.17.0)
-    multipart-post (2.4.1)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
     net-imap (0.5.12)
       date
       net-protocol
@@ -282,6 +304,14 @@ GEM
       prettyprint
     prettyprint (0.2.0)
     prism (1.6.0)
+    protocol-hpack (1.5.1)
+    protocol-http (0.59.0)
+    protocol-http1 (0.37.0)
+      protocol-http (~> 0.58)
+    protocol-http2 (0.24.0)
+      protocol-hpack (~> 1.4)
+      protocol-http (~> 0.47)
+    protocol-url (0.10.0)
     pry (0.15.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
@@ -371,7 +401,6 @@ GEM
     rubocop-rspec (3.0.5)
       rubocop (~> 1.61)
     ruby-progressbar (1.13.0)
-    ruby2_keywords (0.0.5)
     securerandom (0.4.1)
     signet (0.21.0)
       addressable (~> 2.8)
@@ -389,6 +418,7 @@ GEM
     stringio (3.1.8)
     thor (1.4.0)
     timeout (0.4.4)
+    traces (0.18.2)
     tsort (0.2.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
@@ -426,4 +456,4 @@ DEPENDENCIES
   webmock
 
 BUNDLED WITH
-   2.7.2
+   2.5.5

data/lib/minato_ruby_api_client/api_client.rb

@@ -4,6 +4,8 @@ require 'logger'
 require 'tempfile'
 require 'time'
 require 'faraday'
+require 'async/http/faraday'
+require 'rack/utils'
 require 'minato/trace'
 require 'ostruct'
 
@@ -56,7 +58,7 @@ module MinatoRubyApiClient
           conn.request :multipart
           conn.request :url_encoded
         end
-        conn.adapter(Faraday.default_adapter)
+        conn.adapter(:async_http)
       end
 
       request = nil
@@ -72,7 +74,8 @@ module MinatoRubyApiClient
         unless response.success?
           error = self.class.module_parent::ApiError.new(:status_code => response.status,
                               :res => response, :req => request)
-          error.caused_by = response.reason_phrase
+          reason = response.reason_phrase.to_s.empty? ? Rack::Utils::HTTP_STATUS_CODES[response.status] : response.reason_phrase
+          error.caused_by = reason unless error.upstream_error?
 
           fail error
         end

data/lib/minato_ruby_api_client/api_error.rb

@@ -1,4 +1,5 @@
 require 'minato_error_handler'
+require 'json'
 
 module MinatoRubyApiClient
   class ApiError < MinatoErrorHandler::Errors::ExternalError
@@ -6,11 +7,54 @@ module MinatoRubyApiClient
 
     def initialize(res: nil, req: nil, status_code: 500)
       super(req: req, res: res)
+      @upstream_error = nil
       @status_code = status_code
+      extracted_error, extracted_status = extract_upstream_error(res)
+      @upstream_error = extracted_error
+      @status_code = extracted_status || status_code
     end
 
     def message
-      "An error occurred while communicating with the API."
+      upstream_field("message") || "An error occurred while communicating with the API."
     end
+
+    def code
+      upstream_field("code") || super
+    end
+
+    def details
+      upstream_field("details") || super
+    end
+
+    def caused_by
+      upstream_field("caused_by") || super
+    end
+
+    def upstream_error?
+      !@upstream_error.nil? && !@upstream_error.empty?
+    end
+
+    private
+
+      def extract_upstream_error(res)
+        return [nil, nil] unless res.respond_to?(:body)
+
+        body = res.body
+        return [nil, nil] if body.nil? || body.empty?
+
+        parsed = JSON.parse(body)
+        return [nil, nil] unless parsed.is_a?(Hash)
+
+        upstream = parsed["error"] || parsed
+        return [nil, nil] unless upstream.is_a?(Hash) && upstream["code"]
+
+        [upstream, upstream["status_code"]&.to_i]
+      rescue JSON::ParserError
+        [nil, nil]
+      end
+
+      def upstream_field(key)
+        @upstream_error&.[](key)
+      end
   end
 end

data/lib/minato_ruby_api_client/version.rb

@@ -1,3 +1,3 @@
 module MinatoRubyApiClient
-  VERSION = '0.2.8'
+  VERSION = '0.3.0'
 end

data/minato_ruby_api_client.gemspec

@@ -22,7 +22,9 @@ Gem::Specification.new do |s|
   s.license     = "unlicense"
   s.required_ruby_version = ">= 3.2"
 
-  s.add_runtime_dependency 'faraday', '>= 1.0', '< 3.0'
+  s.add_runtime_dependency 'faraday', '>= 2.0', '< 3.0'
+  s.add_runtime_dependency 'async-http-faraday', '>= 0.19'
+  s.add_runtime_dependency 'rack', '>= 2.0'
   s.add_runtime_dependency 'minato_error_handler', '>= 0.1.13'
   s.add_runtime_dependency 'minato-trace', '>= 0.2.0'
 

data/spec/api_error_spec.rb

@@ -0,0 +1,97 @@
+require 'spec_helper'
+
+describe MinatoRubyApiClient::ApiError do
+  def fake_response(body:, status: 422)
+    double("Faraday::Response", body: body, status: status)
+  end
+
+  let(:upstream_error_body) do
+    JSON.generate({
+      "error" => {
+        "code"        => "AccountSvc::Errors::AccountNotFound",
+        "message"     => "Account not found",
+        "status_code" => 404,
+        "details"     => { "account_id" => "abc-123" },
+        "caused_by"   => "Couldn't find Account with id=abc-123"
+      }
+    })
+  end
+
+  context "when the upstream response contains a Minato error payload" do
+    subject(:error) do
+      described_class.new(res: fake_response(body: upstream_error_body, status: 404))
+    end
+
+    it "propagates the upstream code" do
+      expect(error.code).to eq("AccountSvc::Errors::AccountNotFound")
+    end
+
+    it "propagates the upstream message" do
+      expect(error.message).to eq("Account not found")
+    end
+
+    it "propagates the upstream status_code" do
+      expect(error.status_code).to eq(404)
+    end
+
+    it "propagates the upstream details" do
+      expect(error.details).to eq({ "account_id" => "abc-123" })
+    end
+
+    it "propagates the upstream caused_by" do
+      expect(error.caused_by).to eq("Couldn't find Account with id=abc-123")
+    end
+  end
+
+  context "when the upstream response has no Minato error payload" do
+    subject(:error) do
+      described_class.new(res: fake_response(body: "Service Unavailable", status: 503), status_code: 503)
+    end
+
+    it "falls back to the default code (class name)" do
+      expect(error.code).to eq("MinatoRubyApiClient::ApiError")
+    end
+
+    it "falls back to the default message" do
+      expect(error.message).to eq("An error occurred while communicating with the API.")
+    end
+
+    it "uses the provided status_code" do
+      expect(error.status_code).to eq(503)
+    end
+  end
+
+  context "when the upstream response body is empty" do
+    subject(:error) do
+      described_class.new(res: fake_response(body: "", status: 500), status_code: 500)
+    end
+
+    it "falls back to default behavior" do
+      expect(error.code).to eq("MinatoRubyApiClient::ApiError")
+      expect(error.message).to eq("An error occurred while communicating with the API.")
+    end
+  end
+
+  context "when the upstream response body is invalid JSON" do
+    subject(:error) do
+      described_class.new(res: fake_response(body: "<html>error</html>", status: 500), status_code: 500)
+    end
+
+    it "falls back to default behavior without raising" do
+      expect(error.code).to eq("MinatoRubyApiClient::ApiError")
+      expect(error.message).to eq("An error occurred while communicating with the API.")
+    end
+  end
+
+  describe "#upstream_error?" do
+    it "returns true when the response contains a Minato error payload" do
+      error = described_class.new(res: fake_response(body: upstream_error_body, status: 404))
+      expect(error.upstream_error?).to be true
+    end
+
+    it "returns false when the response has no Minato error payload" do
+      error = described_class.new(res: fake_response(body: "", status: 503), status_code: 503)
+      expect(error.upstream_error?).to be false
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: minato_ruby_api_client
 version: !ruby/object:Gem::Version
-  version: 0.2.8
+  version: 0.3.0
 platform: ruby
 authors:
 - Ferreri
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-18 00:00:00.000000000 Z
+date: 2026-08-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.0'
@@ -26,10 +26,38 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: async-http-faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: minato_error_handler
   requirement: !ruby/object:Gem::Requirement
@@ -99,6 +127,7 @@ files:
 - lib/minato_ruby_api_client/version.rb
 - minato_ruby_api_client.gemspec
 - spec/api_client_spec.rb
+- spec/api_error_spec.rb
 - spec/configuration_spec.rb
 - spec/minato_ruby_api_client_spec.rb
 - spec/spec_helper.rb
@@ -127,6 +156,7 @@ specification_version: 4
 summary: A Minato ruby HTTP Client
 test_files:
 - spec/api_client_spec.rb
+- spec/api_error_spec.rb
 - spec/configuration_spec.rb
 - spec/minato_ruby_api_client_spec.rb
 - spec/spec_helper.rb