straddle 0.1.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 070d9a859dd569658ee931097b2a5fd7c34ebe7f58bbac87972c170c2af5cd5e
-  data.tar.gz: be5103223c6a35ed17e6456a17a67c4c084c2dd71b7814ad89682697280881d1
+  metadata.gz: 3e5e80a1c1b53b3a5f149984bc7e7fbb1ae782caee1a4c9683ffcb96559733a7
+  data.tar.gz: 376d8c6d7ee586b2d7e61dad2947fae516565306f9ad6d4754273c38568bfa8d
 SHA512:
-  metadata.gz: 66da28451c8bce1bf74dfa3e58e3ff9fb1736cb9d1610307da3083b49b68090328a5cbaaa3642fe479acc27052922116e53a1412de4bec8568a654ecbe82b8c8
-  data.tar.gz: ebe0b559f5be6ff461a3cfa062d2edb87d8d3b3bed19c21d7e96ed64f54e8a25ce603eec76fcf46b5dcce9a4e7525577e7377ecf1b15b6c9e5b88615cec5297c
+  metadata.gz: 57024a8ac2cbc21595f1d7eb0896f367273cda63b109d206fe0ef5168f8eb9c91bf47550c509c5b74bac8ff745366678acd1a433566d67278cc780c4698f1a24
+  data.tar.gz: 7128242298fe0136fdbaa3b3e87ead934ba990d6bf99aed938229b034cd90e903a8fb51989dd8cd89c1eb53ae9d70411547aad962c7812898e966fde32292bc3

data/CHANGELOG.md

@@ -1,5 +1,71 @@
 # Changelog
 
+## 0.3.0 (2025-11-16)
+
+Full Changelog: [v0.2.0...v0.3.0](https://github.com/straddleio/straddle-ruby/compare/v0.2.0...v0.3.0)
+
+### Features
+
+* **api:** manual updates ([c048e53](https://github.com/straddleio/straddle-ruby/commit/c048e539bb7e3851302e4ddbd166a58fb593a52b))
+* **docs:** Preliminary update to SDK Spec ([8d573e9](https://github.com/straddleio/straddle-ruby/commit/8d573e9c1d39e407dae8a1ec8cc716c0e86a8b46))
+* handle thread interrupts in the core HTTP client ([0e8ff22](https://github.com/straddleio/straddle-ruby/commit/0e8ff229d3f4e5bb905f807338896f8999cc1f44))
+
+
+### Bug Fixes
+
+* absolutely qualified uris should always override the default ([9ec59a0](https://github.com/straddleio/straddle-ruby/commit/9ec59a081f213bbef52a0deb0e05229f047ec4b3))
+* better thread safety via early initializing SSL store during HTTP client creation ([44dd717](https://github.com/straddleio/straddle-ruby/commit/44dd7179fdf7a912e6c0df4016cd7976ceaaa3f9))
+* should not reuse buffers for `IO.copy_stream` interop ([ab1134b](https://github.com/straddleio/straddle-ruby/commit/ab1134bebd96319b18959ef961f303b7fa92cf18))
+
+
+### Chores
+
+* bump dependency version and update sorbet types ([19ed027](https://github.com/straddleio/straddle-ruby/commit/19ed0274aeb5f8303d0170817a1520591c6e484b))
+* ignore linter error for tests having large collections ([bc64eef](https://github.com/straddleio/straddle-ruby/commit/bc64eefa88be0777031542098b605f2677a8c29f))
+
+## 0.2.0 (2025-10-08)
+
+Full Changelog: [v0.1.1...v0.2.0](https://github.com/straddleio/straddle-ruby/compare/v0.1.1...v0.2.0)
+
+### Features
+
+* **api:** manual updates ([057927a](https://github.com/straddleio/straddle-ruby/commit/057927a455631a850c4284ebcfbc4f1bfa7dc5eb))
+* **api:** manual updates ([98aa85e](https://github.com/straddleio/straddle-ruby/commit/98aa85e3b01e330403942184fd986af93253640a))
+* **docs:** Preliminary update to SDK Spec ([dc61e54](https://github.com/straddleio/straddle-ruby/commit/dc61e54a7964ace2e73c99c1844e1c8afd3b6d24))
+* **docs:** Preliminary update to SDK Spec ([a2fbd33](https://github.com/straddleio/straddle-ruby/commit/a2fbd33c6636f827e0edd35f26815b32a24296e6))
+* **docs:** Preliminary update to SDK Spec ([0cde0b4](https://github.com/straddleio/straddle-ruby/commit/0cde0b45a6ac30cd2086eb804f43849bffc734dd))
+* **docs:** Preliminary update to SDK Spec ([20b1183](https://github.com/straddleio/straddle-ruby/commit/20b11834366af2928a97030f939a70c706d50469))
+* **docs:** Release Updates to SDK based on Open API Spec (Final) ([9442214](https://github.com/straddleio/straddle-ruby/commit/94422145d27bf6974a7955eb678ec2bc9c0bb4ef))
+* expose response headers for both streams and errors ([a06e5bb](https://github.com/straddleio/straddle-ruby/commit/a06e5bb80cf4d4a49f515d4bff66d6fa11adeae1))
+
+
+### Bug Fixes
+
+* always send `filename=...` for multipart requests where a file is expected ([d8dcb1b](https://github.com/straddleio/straddle-ruby/commit/d8dcb1b00300a03983cbd67a72af18020822c5c3))
+* **api:** update default API URLs and metadata ([b23e97e](https://github.com/straddleio/straddle-ruby/commit/b23e97ea5c1b0698df3f7f21735a7e0fcf8b6e5a))
+* bump sorbet version and fix new type errors from the breaking change ([c57c7c9](https://github.com/straddleio/straddle-ruby/commit/c57c7c920a948012f18f8e047eb11f9832ce1cb6))
+* coroutine leaks from connection pool ([f2e61b1](https://github.com/straddleio/straddle-ruby/commit/f2e61b1a8cfc85996d03712b753e306368196203))
+* **internal:** ensure sorbet test always runs serially ([9f7f88a](https://github.com/straddleio/straddle-ruby/commit/9f7f88a59fdc8b2723aec681757d170505561202))
+* shorten multipart boundary sep to less than RFC specificed max length ([ffd8ef5](https://github.com/straddleio/straddle-ruby/commit/ffd8ef5e84376bd3bdbdff9d1b6e2c27083cb2aa))
+
+
+### Performance Improvements
+
+* faster code formatting ([8e88904](https://github.com/straddleio/straddle-ruby/commit/8e88904d37df47c41da9b68cc8d9933137f648a0))
+
+
+### Chores
+
+* add json schema comment for rubocop.yml ([0bde048](https://github.com/straddleio/straddle-ruby/commit/0bde0487e0cea64712cf1cac96aba024a16ad5f7))
+* allow fast-format to use bsd sed as well ([95b82e0](https://github.com/straddleio/straddle-ruby/commit/95b82e01dcbfa391aa8d4879f448c574efd39ed2))
+* collect metadata from type DSL ([715a864](https://github.com/straddleio/straddle-ruby/commit/715a864f14ceda15395fb9b9d49f1acc2f338d51))
+* do not install brew dependencies in ./scripts/bootstrap by default ([546b45e](https://github.com/straddleio/straddle-ruby/commit/546b45e0c2a548264407a012fbce0f0197954784))
+* **internal:** codegen related update ([645f5e3](https://github.com/straddleio/straddle-ruby/commit/645f5e3f2d3061c2259c98666745224f04652391))
+* **internal:** increase visibility of internal helper method ([ef8bbee](https://github.com/straddleio/straddle-ruby/commit/ef8bbee699b474dcdb6ea184f35af6c07d4bc0b4))
+* **internal:** update comment in script ([caa575f](https://github.com/straddleio/straddle-ruby/commit/caa575ff8c113eb04eb86d35cdbb559c994cb5f8))
+* update @stainless-api/prism-cli to v5.15.0 ([c881442](https://github.com/straddleio/straddle-ruby/commit/c8814421f86dd430870abc78b29685cca4a7535d))
+* update contribute.md ([1da1122](https://github.com/straddleio/straddle-ruby/commit/1da11228a4e40ad0e4b2a5a750a343f312d5fe16))
+
 ## 0.1.1 (2025-07-08)
 
 Full Changelog: [v0.1.0-alpha.1...v0.1.1](https://github.com/straddleio/straddle-ruby/compare/v0.1.0-alpha.1...v0.1.1)

data/README.md

@@ -8,7 +8,7 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 Documentation for releases of this gem can be found [on RubyDoc](https://gemdocs.org/gems/straddle).
 
-The REST API documentation can be found on [docs.straddle.io](https://docs.straddle.io).
+The REST API documentation can be found on [docs.straddle.com](https://docs.straddle.com).
 
 ## Installation
 
@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "straddle", "~> 0.1.1"
+gem "straddle", "~> 0.3.0"
 ```
 
 <!-- x-release-please-end -->

data/SECURITY.md

@@ -20,7 +20,7 @@ or products provided by Straddle, please follow the respective company's securit
 
 ### Straddle Terms and Policies
 
-Please contact help@straddle.io for any questions or concerns regarding the security of our services.
+Please contact help@straddle.com for any questions or concerns regarding the security of our services.
 
 ---
 

data/lib/straddle/client.rb

@@ -17,7 +17,7 @@ module Straddle
 
     # rubocop:disable Style/MutableConstant
     # @type [Hash{Symbol=>String}]
-    ENVIRONMENTS = {sandbox: "https://sandbox.straddle.io", production: "https://production.straddle.io"}
+    ENVIRONMENTS = {sandbox: "https://sandbox.straddle.com", production: "https://production.straddle.com"}
     # rubocop:enable Style/MutableConstant
 
     # Use your Straddle API Key in the Authorization header as Bearer <token> to
@@ -70,8 +70,8 @@ module Straddle
     #
     # Each environment maps to a different base URL:
     #
-    # - `sandbox` corresponds to `https://sandbox.straddle.io`
-    # - `production` corresponds to `https://production.straddle.io`
+    # - `sandbox` corresponds to `https://sandbox.straddle.com`
+    # - `production` corresponds to `https://production.straddle.com`
     #
     # @param base_url [String, nil] Override the default base URL for the API, e.g.,
     # `"https://api.example.com/v2/"`. Defaults to `ENV["STRADDLE_BASE_URL"]`

data/lib/straddle/errors.rb

@@ -40,6 +40,9 @@ module Straddle
       # @return [Integer, nil]
       attr_accessor :status
 
+      # @return [Hash{String=>String}, nil]
+      attr_accessor :headers
+
       # @return [Object, nil]
       attr_accessor :body
 
@@ -47,13 +50,15 @@ module Straddle
       #
       # @param url [URI::Generic]
       # @param status [Integer, nil]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [Object, nil]
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
-      def initialize(url:, status: nil, body: nil, request: nil, response: nil, message: nil)
+      def initialize(url:, status: nil, headers: nil, body: nil, request: nil, response: nil, message: nil)
         @url = url
         @status = status
+        @headers = headers
         @body = body
         @request = request
         @response = response
@@ -74,6 +79,7 @@ module Straddle
       #
       # @param url [URI::Generic]
       # @param status [nil]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [nil]
       # @param request [nil]
       # @param response [nil]
@@ -81,6 +87,7 @@ module Straddle
       def initialize(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -95,6 +102,7 @@ module Straddle
       #
       # @param url [URI::Generic]
       # @param status [nil]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [nil]
       # @param request [nil]
       # @param response [nil]
@@ -102,6 +110,7 @@ module Straddle
       def initialize(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,21 +125,24 @@ module Straddle
       #
       # @param url [URI::Generic]
       # @param status [Integer]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [Object, nil]
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
       #
       # @return [self]
-      def self.for(url:, status:, body:, request:, response:, message: nil)
-        kwargs = {
-          url: url,
-          status: status,
-          body: body,
-          request: request,
-          response: response,
-          message: message
-        }
+      def self.for(url:, status:, headers:, body:, request:, response:, message: nil)
+        kwargs =
+          {
+            url: url,
+            status: status,
+            headers: headers,
+            body: body,
+            request: request,
+            response: response,
+            message: message
+          }
 
         case status
         in 400
@@ -162,15 +174,17 @@ module Straddle
       #
       # @param url [URI::Generic]
       # @param status [Integer]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [Object, nil]
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
-      def initialize(url:, status:, body:, request:, response:, message: nil)
+      def initialize(url:, status:, headers:, body:, request:, response:, message: nil)
         message ||= {url: url.to_s, status: status, body: body}
         super(
           url: url,
           status: status,
+          headers: headers,
           body: body,
           request: request,
           response: response,

data/lib/straddle/file_part.rb

@@ -38,18 +38,21 @@ module Straddle
     def to_yaml(*a) = read.to_yaml(*a)
 
     # @param content [Pathname, StringIO, IO, String]
-    # @param filename [String, nil]
+    # @param filename [Pathname, String, nil]
     # @param content_type [String, nil]
     def initialize(content, filename: nil, content_type: nil)
-      @content = content
+      @content_type = content_type
       @filename =
-        case content
-        in Pathname
-          filename.nil? ? content.basename.to_path : ::File.basename(filename)
+        case [filename, (@content = content)]
+        in [String | Pathname, _]
+          ::File.basename(filename)
+        in [nil, Pathname]
+          content.basename.to_path
+        in [nil, IO]
+          content.to_path
         else
-          filename.nil? ? nil : ::File.basename(filename)
+          filename
         end
-      @content_type = content_type
     end
   end
 end

data/lib/straddle/internal/page_number_schema.rb

@@ -69,7 +69,7 @@ module Straddle
       #
       # @param client [Straddle::Internal::Transport::BaseClient]
       # @param req [Hash{Symbol=>Object}]
-      # @param headers [Hash{String=>String}, Net::HTTPHeader]
+      # @param headers [Hash{String=>String}]
       # @param page_data [Hash{Symbol=>Object}]
       def initialize(client:, req:, headers:, page_data:)
         super

data/lib/straddle/internal/transport/base_client.rb

@@ -47,7 +47,7 @@ module Straddle
           # @api private
           #
           # @param status [Integer]
-          # @param headers [Hash{String=>String}, Net::HTTPHeader]
+          # @param headers [Hash{String=>String}]
           #
           # @return [Boolean]
           def should_retry?(status, headers:)
@@ -85,7 +85,7 @@ module Straddle
           #
           # @param status [Integer]
           #
-          # @param response_headers [Hash{String=>String}, Net::HTTPHeader]
+          # @param response_headers [Hash{String=>String}]
           #
           # @return [Hash{Symbol=>Object}]
           def follow_redirect(request, status:, response_headers:)
@@ -201,7 +201,8 @@ module Straddle
             self.class::PLATFORM_HEADERS,
             {
               "accept" => "application/json",
-              "content-type" => "application/json"
+              "content-type" => "application/json",
+              "user-agent" => user_agent
             },
             headers
           )
@@ -219,6 +220,11 @@ module Straddle
         # @return [Hash{String=>String}]
         private def auth_headers = {}
 
+        # @api private
+        #
+        # @return [String]
+        private def user_agent = "#{self.class.name}/Ruby #{Straddle::VERSION}"
+
         # @api private
         #
         # @return [String]
@@ -365,7 +371,7 @@ module Straddle
         #
         # @raise [Straddle::Errors::APIError]
         # @return [Array(Integer, Net::HTTPResponse, Enumerable<String>)]
-        private def send_request(request, redirect_count:, retry_count:, send_retry_header:)
+        def send_request(request, redirect_count:, retry_count:, send_retry_header:)
           url, headers, max_retries, timeout = request.fetch_values(:url, :headers, :max_retries, :timeout)
           input = {**request.except(:timeout), deadline: Straddle::Internal::Util.monotonic_secs + timeout}
 
@@ -378,6 +384,7 @@ module Straddle
           rescue Straddle::Errors::APIConnectionError => e
             status = e
           end
+          headers = Straddle::Internal::Util.normalized_headers(response&.each_header&.to_h)
 
           case status
           in ..299
@@ -390,7 +397,7 @@ module Straddle
           in 300..399
             self.class.reap_connection!(status, stream: stream)
 
-            request = self.class.follow_redirect(request, status: status, response_headers: response)
+            request = self.class.follow_redirect(request, status: status, response_headers: headers)
             send_request(
               request,
               redirect_count: redirect_count + 1,
@@ -399,9 +406,9 @@ module Straddle
             )
           in Straddle::Errors::APIConnectionError if retry_count >= max_retries
             raise status
-          in (400..) if retry_count >= max_retries || !self.class.should_retry?(status, headers: response)
+          in (400..) if retry_count >= max_retries || !self.class.should_retry?(status, headers: headers)
             decoded = Kernel.then do
-              Straddle::Internal::Util.decode_content(response, stream: stream, suppress_error: true)
+              Straddle::Internal::Util.decode_content(headers, stream: stream, suppress_error: true)
             ensure
               self.class.reap_connection!(status, stream: stream)
             end
@@ -409,6 +416,7 @@ module Straddle
             raise Straddle::Errors::APIStatusError.for(
               url: url,
               status: status,
+              headers: headers,
               body: decoded,
               request: nil,
               response: response
@@ -485,19 +493,21 @@ module Straddle
             send_retry_header: send_retry_header
           )
 
-          decoded = Straddle::Internal::Util.decode_content(response, stream: stream)
+          headers = Straddle::Internal::Util.normalized_headers(response.each_header.to_h)
+          decoded = Straddle::Internal::Util.decode_content(headers, stream: stream)
           case req
           in {stream: Class => st}
             st.new(
               model: model,
               url: url,
               status: status,
+              headers: headers,
               response: response,
               unwrap: unwrap,
               stream: decoded
             )
           in {page: Class => page}
-            page.new(client: self, req: req, headers: response, page_data: decoded)
+            page.new(client: self, req: req, headers: headers, page_data: decoded)
           else
             unwrapped = Straddle::Internal::Util.dig(decoded, unwrap)
             Straddle::Internal::Type::Converter.coerce(model, unwrapped)

data/lib/straddle/internal/transport/pooled_net_requester.rb

@@ -16,10 +16,11 @@ module Straddle
         class << self
           # @api private
           #
+          # @param cert_store [OpenSSL::X509::Store]
           # @param url [URI::Generic]
           #
           # @return [Net::HTTP]
-          def connect(url)
+          def connect(cert_store:, url:)
             port =
               case [url.port, url.scheme]
               in [Integer, _]
@@ -33,6 +34,8 @@ module Straddle
             Net::HTTP.new(url.host, port).tap do
               _1.use_ssl = %w[https wss].include?(url.scheme)
               _1.max_retries = 0
+
+              (_1.cert_store = cert_store) if _1.use_ssl?
             end
           end
 
@@ -102,7 +105,7 @@ module Straddle
           pool =
             @mutex.synchronize do
               @pools[origin] ||= ConnectionPool.new(size: @size) do
-                self.class.connect(url)
+                self.class.connect(cert_store: @cert_store, url: url)
               end
             end
 
@@ -128,37 +131,47 @@ module Straddle
           url, deadline = request.fetch_values(:url, :deadline)
 
           req = nil
-          eof = false
           finished = false
-          closing = nil
 
           # rubocop:disable Metrics/BlockLength
           enum = Enumerator.new do |y|
-            with_pool(url, deadline: deadline) do |conn|
-              next if finished
-
-              req, closing = self.class.build_request(request) do
-                self.class.calibrate_socket_timeout(conn, deadline)
-              end
-
-              self.class.calibrate_socket_timeout(conn, deadline)
-              unless conn.started?
-                conn.keep_alive_timeout = self.class::KEEP_ALIVE_TIMEOUT
-                conn.start
-              end
+            next if finished
 
-              self.class.calibrate_socket_timeout(conn, deadline)
-              conn.request(req) do |rsp|
-                y << [conn, req, rsp]
-                break if finished
+            with_pool(url, deadline: deadline) do |conn|
+              eof = false
+              closing = nil
+              ::Thread.handle_interrupt(Object => :never) do
+                ::Thread.handle_interrupt(Object => :immediate) do
+                  req, closing = self.class.build_request(request) do
+                    self.class.calibrate_socket_timeout(conn, deadline)
+                  end
 
-                rsp.read_body do |bytes|
-                  y << bytes.force_encoding(Encoding::BINARY)
-                  break if finished
+                  self.class.calibrate_socket_timeout(conn, deadline)
+                  unless conn.started?
+                    conn.keep_alive_timeout = self.class::KEEP_ALIVE_TIMEOUT
+                    conn.start
+                  end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
+                  conn.request(req) do |rsp|
+                    y << [req, rsp]
+                    break if finished
+
+                    rsp.read_body do |bytes|
+                      y << bytes.force_encoding(Encoding::BINARY)
+                      break if finished
+
+                      self.class.calibrate_socket_timeout(conn, deadline)
+                    end
+                    eof = true
+                  end
+                end
+              ensure
+                begin
+                  conn.finish if !eof && conn&.started?
+                ensure
+                  closing&.call
                 end
-                eof = true
               end
             end
           rescue Timeout::Error
@@ -168,17 +181,10 @@ module Straddle
           end
           # rubocop:enable Metrics/BlockLength
 
-          conn, _, response = enum.next
+          _, response = enum.next
           body = Straddle::Internal::Util.fused_enum(enum, external: true) do
             finished = true
-            tap do
-              enum.next
-            rescue StopIteration
-              nil
-            end
-          ensure
-            conn.finish if !eof && conn&.started?
-            closing&.call
+            loop { enum.next }
           end
           [Integer(response.code), response, body]
         end
@@ -189,19 +195,12 @@ module Straddle
         def initialize(size: self.class::DEFAULT_MAX_CONNECTIONS)
           @mutex = Mutex.new
           @size = size
+          @cert_store = OpenSSL::X509::Store.new.tap(&:set_default_paths)
           @pools = {}
         end
 
         define_sorbet_constant!(:Request) do
-          T.type_alias do
-            {
-              method: Symbol,
-              url: URI::Generic,
-              headers: T::Hash[String, String],
-              body: T.anything,
-              deadline: Float
-            }
-          end
+          T.type_alias { {method: Symbol, url: URI::Generic, headers: T::Hash[String, String], body: T.anything, deadline: Float} }
         end
       end
     end

data/lib/straddle/internal/type/array_of.rb

@@ -148,6 +148,7 @@ module Straddle
         #   @option spec [Boolean] :"nil?"
         def initialize(type_info, spec = {})
           @item_type_fn = Straddle::Internal::Type::Converter.type_info(type_info || spec)
+          @meta = Straddle::Internal::Type::Converter.meta_info(type_info, spec)
           @nilable = spec.fetch(:nil?, false)
         end
 

data/lib/straddle/internal/type/base_model.rb

@@ -52,6 +52,7 @@ module Straddle
           #
           #   @option spec [Boolean] :"nil?"
           private def add_field(name_sym, required:, type_info:, spec:)
+            meta = Straddle::Internal::Type::Converter.meta_info(type_info, spec)
             type_fn, info =
               case type_info
               in Proc | Straddle::Internal::Type::Converter | Class
@@ -63,14 +64,7 @@ module Straddle
             setter = :"#{name_sym}="
             api_name = info.fetch(:api_name, name_sym)
             nilable = info.fetch(:nil?, false)
-            const = if required && !nilable
-              info.fetch(
-                :const,
-                Straddle::Internal::OMIT
-              )
-            else
-              Straddle::Internal::OMIT
-            end
+            const = required && !nilable ? info.fetch(:const, Straddle::Internal::OMIT) : Straddle::Internal::OMIT
 
             [name_sym, setter].each { undef_method(_1) } if known_fields.key?(name_sym)
 
@@ -81,7 +75,8 @@ module Straddle
                 required: required,
                 nilable: nilable,
                 const: const,
-                type_fn: type_fn
+                type_fn: type_fn,
+                meta: meta
               }
 
             define_method(setter) do |value|

data/lib/straddle/internal/type/base_page.rb

@@ -39,7 +39,7 @@ module Straddle
         #
         # @param client [Straddle::Internal::Transport::BaseClient]
         # @param req [Hash{Symbol=>Object}]
-        # @param headers [Hash{String=>String}, Net::HTTPHeader]
+        # @param headers [Hash{String=>String}]
         # @param page_data [Object]
         def initialize(client:, req:, headers:, page_data:)
           @client = client

data/lib/straddle/internal/type/converter.rb

@@ -98,6 +98,33 @@ module Straddle
             end
           end
 
+          # @api private
+          #
+          # @param type_info [Hash{Symbol=>Object}, Proc, Straddle::Internal::Type::Converter, Class] .
+          #
+          #   @option type_info [NilClass, TrueClass, FalseClass, Integer, Float, Symbol] :const
+          #
+          #   @option type_info [Proc] :enum
+          #
+          #   @option type_info [Proc] :union
+          #
+          #   @option type_info [Boolean] :"nil?"
+          #
+          # @param spec [Hash{Symbol=>Object}, Proc, Straddle::Internal::Type::Converter, Class] .
+          #
+          #   @option spec [NilClass, TrueClass, FalseClass, Integer, Float, Symbol] :const
+          #
+          #   @option spec [Proc] :enum
+          #
+          #   @option spec [Proc] :union
+          #
+          #   @option spec [Boolean] :"nil?"
+          #
+          # @return [Hash{Symbol=>Object}]
+          def meta_info(type_info, spec)
+            [spec, type_info].grep(Hash).first.to_h.except(:const, :enum, :union, :nil?)
+          end
+
           # @api private
           #
           # @param translate_names [Boolean]

data/lib/straddle/internal/type/file_input.rb

@@ -82,17 +82,20 @@ module Straddle
           #
           # @return [Pathname, StringIO, IO, String, Object]
           def dump(value, state:)
-            # rubocop:disable Lint/DuplicateBranch
             case value
+            in StringIO | String
+              # https://datatracker.ietf.org/doc/html/rfc7578#section-4.2
+              # while not required, a filename is recommended, and in practice many servers do expect this
+              Straddle::FilePart.new(value, filename: "upload")
             in IO
               state[:can_retry] = false
+              value.to_path.nil? ? Straddle::FilePart.new(value, filename: "upload") : value
             in Straddle::FilePart if value.content.is_a?(IO)
               state[:can_retry] = false
+              value
             else
+              value
             end
-            # rubocop:enable Lint/DuplicateBranch
-
-            value
           end
 
           # @api private

data/lib/straddle/internal/type/hash_of.rb

@@ -168,6 +168,7 @@ module Straddle
         #   @option spec [Boolean] :"nil?"
         def initialize(type_info, spec = {})
           @item_type_fn = Straddle::Internal::Type::Converter.type_info(type_info || spec)
+          @meta = Straddle::Internal::Type::Converter.meta_info(type_info, spec)
           @nilable = spec.fetch(:nil?, false)
         end