prelude-sdk 0.1.0.pre.alpha.2 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12b02adb152b32c9bd2e7dd2587ddbd3c2cd0852b00af005c6227a938276e997
-  data.tar.gz: 4c62e71aa6241371ba0547bc643d51bb73c5193bac70725f073e3c8b5f3949c1
+  metadata.gz: bdd2764aef5a2905ae9ff686383745a878831c2402b1858f60025c4185f9fce1
+  data.tar.gz: be34c995e5c189bd7bfc38a03f30d0e399376ffdbb70f42c3776f64df56de7e4
 SHA512:
-  metadata.gz: eeb2a335540419f67629c0cfbf9d9dd0cc357cb174f0e5a4c309a6afc681cc1aa088cf3852c20b60b46bed5939a8b4d2af33de1b1e9d17af6f5c42e69911da0f
-  data.tar.gz: 7970fd85651bc993d6a8f9305118e5966c86558a79026a6279a9a9686b023a12dfcb962e12073a8ffc6cc4cd1fbd142398443b084a00bb40421f60df5e43ceed
+  metadata.gz: 953de3f45bdc0854d720388783118e6daff94fcfda5fa3de09bace85598b61e7165f87ac2439f1c275822e80f6811d711c055d2d8b5399824aec74f2dd715208
+  data.tar.gz: c7b590b961d3bcdb03aafbcc97fa3d4c80e0ac59a70a2dd79451000fe300b702c90a1cb30f7a6fa8c0604c73365f4e5fbb0da7a05e0df2aa77a1ee672ce5e008

data/CHANGELOG.md

@@ -1,5 +1,79 @@
 # Changelog
 
+## 0.1.0 (2025-11-17)
+
+Full Changelog: [v0.1.0-alpha.3...v0.1.0](https://github.com/prelude-so/ruby-sdk/compare/v0.1.0-alpha.3...v0.1.0)
+
+### Features
+
+* **api:** api update ([c9e65c1](https://github.com/prelude-so/ruby-sdk/commit/c9e65c116529da3a8e5aa86a562b7fed5cf4a97a))
+* **api:** api update ([bf8dee6](https://github.com/prelude-so/ruby-sdk/commit/bf8dee60be19b83b817ece1f9004cfaec2e85e4f))
+* **api:** api update ([9d565ad](https://github.com/prelude-so/ruby-sdk/commit/9d565ad99b6b46c7d17934bd68273f3d82fe9d85))
+* **api:** api update ([4fd18f8](https://github.com/prelude-so/ruby-sdk/commit/4fd18f8a058510eb8d930d819d31cb6f6173f83a))
+* **api:** api update ([69a221a](https://github.com/prelude-so/ruby-sdk/commit/69a221a42fcaec93f98d63caf9d17766be47fbc6))
+* **api:** api update ([4af700e](https://github.com/prelude-so/ruby-sdk/commit/4af700e93bc5cf28d97ff79885834e81b57da1a4))
+* **api:** api update ([0c33db9](https://github.com/prelude-so/ruby-sdk/commit/0c33db9825b569f3a89e225b154340c4c310479f))
+* **api:** api update ([445cbad](https://github.com/prelude-so/ruby-sdk/commit/445cbadbafa387f8650e669062177e7224105de7))
+* **api:** api update ([595d9ef](https://github.com/prelude-so/ruby-sdk/commit/595d9ef60705cb032562fd76150bb9aacf9626d6))
+* **api:** expose phone numbers management methods ([f941fe5](https://github.com/prelude-so/ruby-sdk/commit/f941fe55ce85520986895f042146e59f192ed48d))
+* **api:** expose verification management methods ([b9b9495](https://github.com/prelude-so/ruby-sdk/commit/b9b94955da54d2d44b0a1592abe73337e4087ec3))
+* expose response headers for both streams and errors ([fc2ae79](https://github.com/prelude-so/ruby-sdk/commit/fc2ae79a34a537cda6aa82b63a0c26b83a393cd2))
+* handle thread interrupts in the core HTTP client ([866b344](https://github.com/prelude-so/ruby-sdk/commit/866b344df136a37851b378b07f228c815ca79636))
+
+
+### Bug Fixes
+
+* absolutely qualified uris should always override the default ([68aaf0e](https://github.com/prelude-so/ruby-sdk/commit/68aaf0eb2327e02d5b031ec0a89e7b732ad420f7))
+* always send `filename=...` for multipart requests where a file is expected ([da05b08](https://github.com/prelude-so/ruby-sdk/commit/da05b084037001a449e416128ccd45467e3c364b))
+* better thread safety via early initializing SSL store during HTTP client creation ([5e8ee30](https://github.com/prelude-so/ruby-sdk/commit/5e8ee30cb5783924438c63e8235ae2b4c58eafcc))
+* coroutine leaks from connection pool ([ed37e6b](https://github.com/prelude-so/ruby-sdk/commit/ed37e6b16456986d82b11232f097721ef8a40638))
+* **internal:** use null byte as file separator in the fast formatting script ([d665d3a](https://github.com/prelude-so/ruby-sdk/commit/d665d3a0675b0b96be78135d06e683f1ec170321))
+* shorten multipart boundary sep to less than RFC specificed max length ([bd7c735](https://github.com/prelude-so/ruby-sdk/commit/bd7c7352f57c8f18669454fe537e0e6a747333c4))
+* should not reuse buffers for `IO.copy_stream` interop ([a81068b](https://github.com/prelude-so/ruby-sdk/commit/a81068b77b064aec1a6dcffa475259b664f6beb9))
+
+
+### Performance Improvements
+
+* faster code formatting ([0b96741](https://github.com/prelude-so/ruby-sdk/commit/0b9674139c6ec176f9778f4fd6ef0c21b260fd10))
+
+
+### Chores
+
+* allow fast-format to use bsd sed as well ([5e8c0c0](https://github.com/prelude-so/ruby-sdk/commit/5e8c0c0a63e8e20622e79102d7e17a59591a9b87))
+* **client:** send user-agent header ([0da478a](https://github.com/prelude-so/ruby-sdk/commit/0da478a2be5493927b58d9f162626ca900d400d8))
+* do not install brew dependencies in ./scripts/bootstrap by default ([4604e34](https://github.com/prelude-so/ruby-sdk/commit/4604e34fa43c84c180974e36ce957ff5e4afe515))
+* ignore linter error for tests having large collections ([b76b678](https://github.com/prelude-so/ruby-sdk/commit/b76b678af0a7bf7de20974c5d6e87ab1cc5ca816))
+* **internal:** codegen related update ([b5d6135](https://github.com/prelude-so/ruby-sdk/commit/b5d61356ba2806cb9d24ee7aeb982dd20485da3a))
+
+## 0.1.0-alpha.3 (2025-09-02)
+
+Full Changelog: [v0.1.0-alpha.2...v0.1.0-alpha.3](https://github.com/prelude-so/ruby-sdk/compare/v0.1.0-alpha.2...v0.1.0-alpha.3)
+
+### Features
+
+* **api:** add Ruby-specific rename transformation ([42dadd3](https://github.com/prelude-so/ruby-sdk/commit/42dadd3bddbb321fc9cf76542b26651807050fc4))
+* **api:** api update ([036b7b2](https://github.com/prelude-so/ruby-sdk/commit/036b7b298dc4de946eeff885f8f2a0e9566e1de0))
+* **api:** update via SDK Studio ([791c53f](https://github.com/prelude-so/ruby-sdk/commit/791c53fdbb730ded753d2eb227f87ff6e86ee1bd))
+
+
+### Bug Fixes
+
+* bump sorbet version and fix new type errors from the breaking change ([18e0dd1](https://github.com/prelude-so/ruby-sdk/commit/18e0dd1e8f90e1e77c74b491490931309a9cdd4b))
+* **internal:** ensure sorbet test always runs serially ([73f6bb9](https://github.com/prelude-so/ruby-sdk/commit/73f6bb9d30db4eb38e746d74da4ff2eb81881080))
+
+
+### Chores
+
+* add json schema comment for rubocop.yml ([c6b0b40](https://github.com/prelude-so/ruby-sdk/commit/c6b0b40955adff0da669b9d6177ef37a4cbdbbcf))
+* collect metadata from type DSL ([7bf4d61](https://github.com/prelude-so/ruby-sdk/commit/7bf4d61d21cbd50bb83986e147a5c29793400ca5))
+* **internal:** allow streams to also be unwrapped on a per-row basis ([8572174](https://github.com/prelude-so/ruby-sdk/commit/8572174e262d9c6b7cc66a0894fd6d09184569f1))
+* **internal:** increase visibility of internal helper method ([f04772f](https://github.com/prelude-so/ruby-sdk/commit/f04772fd6d66ba49a3d2f73d21f4538c7957bd28))
+* **internal:** update comment in script ([a5fe28e](https://github.com/prelude-so/ruby-sdk/commit/a5fe28eacf22acdad6f621a1e6ee4e4dfb077d16))
+* **internal:** update test skipping reason ([55f2205](https://github.com/prelude-so/ruby-sdk/commit/55f220596e6310b2d89fe3b460c02fdfe57b9e78))
+* **internal:** version bump ([eb3405c](https://github.com/prelude-so/ruby-sdk/commit/eb3405ca5ae74eb673b5e0cbafde6943e83314fa))
+* update @stainless-api/prism-cli to v5.15.0 ([58f1de5](https://github.com/prelude-so/ruby-sdk/commit/58f1de5007b309c40d197031aeea1e5574213bbe))
+* update contribute.md ([65b7754](https://github.com/prelude-so/ruby-sdk/commit/65b7754e9bfac05f99efcc9a48200fada3940535))
+
 ## 0.1.0-alpha.2 (2025-06-27)
 
 Full Changelog: [v0.1.0-alpha.1...v0.1.0-alpha.2](https://github.com/prelude-so/ruby-sdk/compare/v0.1.0-alpha.1...v0.1.0-alpha.2)

data/README.md

@@ -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 "prelude-sdk", "~> 0.1.0.pre.alpha.2"
+gem "prelude-sdk", "~> 0.1.0"
 ```
 
 <!-- x-release-please-end -->
@@ -202,6 +202,34 @@ params = PreludeSDK::VerificationCreateParams.new(
 prelude.verification.create(**params)
 ```
 
+### Enums
+
+Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
+
+```ruby
+# :allow
+puts(PreludeSDK::VerificationManagementDeletePhoneNumberParams::Action::ALLOW)
+
+# Revealed type: `T.all(PreludeSDK::VerificationManagementDeletePhoneNumberParams::Action, Symbol)`
+T.reveal_type(PreludeSDK::VerificationManagementDeletePhoneNumberParams::Action::ALLOW)
+```
+
+Enum parameters have a "relaxed" type, so you can either pass in enum constants or their literal value:
+
+```ruby
+# Using the enum constants preserves the tagged type information:
+prelude.verification_management.delete_phone_number(
+  action: PreludeSDK::VerificationManagementDeletePhoneNumberParams::Action::ALLOW,
+  # …
+)
+
+# Literal values are also permissible:
+prelude.verification_management.delete_phone_number(
+  action: :allow,
+  # …
+)
+```
+
 ## Versioning
 
 This package follows [SemVer](https://semver.org/spec/v2.0.0.html) conventions. As the library is in initial development and has a major version of `0`, APIs may change at any time.

data/lib/prelude_sdk/client.rb

@@ -28,6 +28,9 @@ module PreludeSDK
     # @return [PreludeSDK::Resources::Verification]
     attr_reader :verification
 
+    # @return [PreludeSDK::Resources::VerificationManagement]
+    attr_reader :verification_management
+
     # @return [PreludeSDK::Resources::Watch]
     attr_reader :watch
 
@@ -81,6 +84,7 @@ module PreludeSDK
       @lookup = PreludeSDK::Resources::Lookup.new(client: self)
       @transactional = PreludeSDK::Resources::Transactional.new(client: self)
       @verification = PreludeSDK::Resources::Verification.new(client: self)
+      @verification_management = PreludeSDK::Resources::VerificationManagement.new(client: self)
       @watch = PreludeSDK::Resources::Watch.new(client: self)
     end
   end

data/lib/prelude_sdk/errors.rb

@@ -40,6 +40,9 @@ module PreludeSDK
       # @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 PreludeSDK
       #
       # @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 PreludeSDK
       #
       # @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 PreludeSDK
       def initialize(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -95,6 +102,7 @@ module PreludeSDK
       #
       # @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 PreludeSDK
       def initialize(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,21 +125,24 @@ module PreludeSDK
       #
       # @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 PreludeSDK
       #
       # @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/prelude_sdk/file_part.rb

@@ -38,18 +38,21 @@ module PreludeSDK
     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/prelude_sdk/internal/transport/base_client.rb

@@ -47,7 +47,7 @@ module PreludeSDK
           # @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 PreludeSDK
           #
           # @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 PreludeSDK
             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 PreludeSDK
         # @return [Hash{String=>String}]
         private def auth_headers = {}
 
+        # @api private
+        #
+        # @return [String]
+        private def user_agent = "#{self.class.name}/Ruby #{PreludeSDK::VERSION}"
+
         # @api private
         #
         # @return [String]
@@ -365,7 +371,7 @@ module PreludeSDK
         #
         # @raise [PreludeSDK::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: PreludeSDK::Internal::Util.monotonic_secs + timeout}
 
@@ -378,6 +384,7 @@ module PreludeSDK
           rescue PreludeSDK::Errors::APIConnectionError => e
             status = e
           end
+          headers = PreludeSDK::Internal::Util.normalized_headers(response&.each_header&.to_h)
 
           case status
           in ..299
@@ -390,7 +397,7 @@ module PreludeSDK
           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 PreludeSDK
             )
           in PreludeSDK::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
-              PreludeSDK::Internal::Util.decode_content(response, stream: stream, suppress_error: true)
+              PreludeSDK::Internal::Util.decode_content(headers, stream: stream, suppress_error: true)
             ensure
               self.class.reap_connection!(status, stream: stream)
             end
@@ -409,6 +416,7 @@ module PreludeSDK
             raise PreludeSDK::Errors::APIStatusError.for(
               url: url,
               status: status,
+              headers: headers,
               body: decoded,
               request: nil,
               response: response
@@ -471,6 +479,7 @@ module PreludeSDK
           self.class.validate!(req)
           model = req.fetch(:model) { PreludeSDK::Internal::Type::Unknown }
           opts = req[:options].to_h
+          unwrap = req[:unwrap]
           PreludeSDK::RequestOptions.validate!(opts)
           request = build_request(req.except(:options), opts)
           url = request.fetch(:url)
@@ -484,14 +493,23 @@ module PreludeSDK
             send_retry_header: send_retry_header
           )
 
-          decoded = PreludeSDK::Internal::Util.decode_content(response, stream: stream)
+          headers = PreludeSDK::Internal::Util.normalized_headers(response.each_header.to_h)
+          decoded = PreludeSDK::Internal::Util.decode_content(headers, stream: stream)
           case req
           in {stream: Class => st}
-            st.new(model: model, url: url, status: status, response: response, stream: decoded)
+            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 = PreludeSDK::Internal::Util.dig(decoded, req[:unwrap])
+            unwrapped = PreludeSDK::Internal::Util.dig(decoded, unwrap)
             PreludeSDK::Internal::Type::Converter.coerce(model, unwrapped)
           end
         end

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

@@ -16,10 +16,11 @@ module PreludeSDK
         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 PreludeSDK
             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 PreludeSDK
           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 PreludeSDK
           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 PreludeSDK
           end
           # rubocop:enable Metrics/BlockLength
 
-          conn, _, response = enum.next
+          _, response = enum.next
           body = PreludeSDK::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 PreludeSDK
         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/prelude_sdk/internal/type/array_of.rb

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

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

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

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

@@ -39,7 +39,7 @@ module PreludeSDK
         #
         # @param client [PreludeSDK::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/prelude_sdk/internal/type/converter.rb

@@ -98,6 +98,33 @@ module PreludeSDK
             end
           end
 
+          # @api private
+          #
+          # @param type_info [Hash{Symbol=>Object}, Proc, PreludeSDK::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, PreludeSDK::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/prelude_sdk/internal/type/file_input.rb

@@ -82,17 +82,20 @@ module PreludeSDK
           #
           # @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
+              PreludeSDK::FilePart.new(value, filename: "upload")
             in IO
               state[:can_retry] = false
+              value.to_path.nil? ? PreludeSDK::FilePart.new(value, filename: "upload") : value
             in PreludeSDK::FilePart if value.content.is_a?(IO)
               state[:can_retry] = false
+              value
             else
+              value
             end
-            # rubocop:enable Lint/DuplicateBranch
-
-            value
           end
 
           # @api private