terminal-shop 3.8.9 → 3.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7f5c4f7f56e756435c0a707cc2fcf9255fa738d5cfcd05a1a65763ec528f7cc
-  data.tar.gz: abbe65c733114e77044e9e991ad6f122a52aefd6cf5e6b9d0f93f8993395b56d
+  metadata.gz: 8641a7314cfe99c67112619c269abe92eeb80b2ab8afbf552713b5164c3a1f5c
+  data.tar.gz: 4b040668b4aa5ca2bf01798abed02611a0a932f2a6641881b30a0c15c57995fd
 SHA512:
-  metadata.gz: dfa49b7b447bdf9e4c14767d138f8a78b994dbd03cd33aefb86f420d41a232ad836c18184d8b4cbc097ccc98f1db0ae2beb2e32a3d33932ef056d5c1d89e85c1
-  data.tar.gz: 7162025bcb37db82ca0b4f34150f89fafe2446b2ad5c92b06a0ca53b8a3d84fb64f33a74a21ccffc892067d5b949fce6b41530a4d8554ddfe76b30e4d970825f
+  metadata.gz: 3e5944cb9959d6936ca56ce7aa8f6cee16fe64fc19a5a2a53ab84220dfbb6d94738a534f5200fd8578f1d46d88e4363f7b26d1c1627325fbc99a2f2969ff1165
+  data.tar.gz: 7c5b1d0265e12770da0be79d3bdea8e94932bb400112f58a72b7df96d072f5f6a024a6ce50f29ee42957b50eb1ab280ba52d8c4986fd845dd0f676e66c784f6e

data/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## 3.9.0 (2025-09-27)
+
+Full Changelog: [v3.8.10...v3.9.0](https://github.com/terminaldotshop/terminal-sdk-ruby/compare/v3.8.10...v3.9.0)
+
+### Features
+
+* expose response headers for both streams and errors ([21b1cb6](https://github.com/terminaldotshop/terminal-sdk-ruby/commit/21b1cb61ee1b0264d04fb4ce3c7b12e65b8dace9))
+
+
+### Bug Fixes
+
+* shorten multipart boundary sep to less than RFC specificed max length ([b1cb8d7](https://github.com/terminaldotshop/terminal-sdk-ruby/commit/b1cb8d7f52a4cb1fccb512e82aab97d54c6687fa))
+
+
+### Performance Improvements
+
+* faster code formatting ([c4d7efd](https://github.com/terminaldotshop/terminal-sdk-ruby/commit/c4d7efd87dddd04e7099452f717a5e2becab73c2))
+
+
+### Chores
+
+* add json schema comment for rubocop.yml ([cdd17ee](https://github.com/terminaldotshop/terminal-sdk-ruby/commit/cdd17ee6be620549c47c1656dde4c70c4a76d6cc))
+* **internal:** codegen related update ([5b3d643](https://github.com/terminaldotshop/terminal-sdk-ruby/commit/5b3d643979e95d1bf5084fae10f85fc8e73e648d))
+* **internal:** codegen related update ([2195e2b](https://github.com/terminaldotshop/terminal-sdk-ruby/commit/2195e2b0ea1cbbf360bb5c3373626e538676266f))
+
+## 3.8.10 (2025-08-20)
+
+Full Changelog: [v3.8.9...v3.8.10](https://github.com/terminaldotshop/terminal-sdk-ruby/compare/v3.8.9...v3.8.10)
+
+### Bug Fixes
+
+* bump sorbet version and fix new type errors from the breaking change ([b8a165c](https://github.com/terminaldotshop/terminal-sdk-ruby/commit/b8a165c99dda340d95ee12680ad4a662dae84adb))
+
+
+### Chores
+
+* collect metadata from type DSL ([48d6bd6](https://github.com/terminaldotshop/terminal-sdk-ruby/commit/48d6bd6aef75e097d4fac1e87680a56194a46849))
+* **internal:** update comment in script ([29e8d0e](https://github.com/terminaldotshop/terminal-sdk-ruby/commit/29e8d0ee82f862af88091ce124082f798a73d52f))
+* update @stainless-api/prism-cli to v5.15.0 ([c859658](https://github.com/terminaldotshop/terminal-sdk-ruby/commit/c85965842c1dd5e37ed2f37010a8dfa096f12147))
+
 ## 3.8.9 (2025-08-05)
 
 Full Changelog: [v3.8.8...v3.8.9](https://github.com/terminaldotshop/terminal-sdk-ruby/compare/v3.8.8...v3.8.9)

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 "terminal-shop", "~> 3.8.9"
+gem "terminal-shop", "~> 3.9.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/terminal_shop/errors.rb

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

@@ -47,7 +47,7 @@ module TerminalShop
           # @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 TerminalShop
           #
           # @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:)
@@ -367,10 +367,7 @@ module TerminalShop
         # @return [Array(Integer, Net::HTTPResponse, Enumerable<String>)]
         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: TerminalShop::Internal::Util.monotonic_secs + timeout
-          }
+          input = {**request.except(:timeout), deadline: TerminalShop::Internal::Util.monotonic_secs + timeout}
 
           if send_retry_header
             headers["x-stainless-retry-count"] = retry_count.to_s
@@ -381,6 +378,7 @@ module TerminalShop
           rescue TerminalShop::Errors::APIConnectionError => e
             status = e
           end
+          headers = TerminalShop::Internal::Util.normalized_headers(response&.each_header&.to_h)
 
           case status
           in ..299
@@ -393,7 +391,7 @@ module TerminalShop
           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,
@@ -402,9 +400,9 @@ module TerminalShop
             )
           in TerminalShop::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
-              TerminalShop::Internal::Util.decode_content(response, stream: stream, suppress_error: true)
+              TerminalShop::Internal::Util.decode_content(headers, stream: stream, suppress_error: true)
             ensure
               self.class.reap_connection!(status, stream: stream)
             end
@@ -412,6 +410,7 @@ module TerminalShop
             raise TerminalShop::Errors::APIStatusError.for(
               url: url,
               status: status,
+              headers: headers,
               body: decoded,
               request: nil,
               response: response
@@ -488,19 +487,21 @@ module TerminalShop
             send_retry_header: send_retry_header
           )
 
-          decoded = TerminalShop::Internal::Util.decode_content(response, stream: stream)
+          headers = TerminalShop::Internal::Util.normalized_headers(response.each_header.to_h)
+          decoded = TerminalShop::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 = TerminalShop::Internal::Util.dig(decoded, unwrap)
             TerminalShop::Internal::Type::Converter.coerce(model, unwrapped)

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

@@ -193,15 +193,7 @@ module TerminalShop
         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/terminal_shop/internal/type/array_of.rb

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

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

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

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

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

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

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

data/lib/terminal_shop/internal/type/union.rb

@@ -12,20 +12,20 @@ module TerminalShop
         #
         # All of the specified variant info for this union.
         #
-        # @return [Array<Array(Symbol, Proc)>]
+        # @return [Array<Array(Symbol, Proc, Hash{Symbol=>Object})>]
         private def known_variants = (@known_variants ||= [])
 
         # @api private
         #
-        # @return [Array<Array(Symbol, Object)>]
+        # @return [Array<Array(Symbol, Object, Hash{Symbol=>Object})>]
         protected def derefed_variants
-          known_variants.map { |key, variant_fn| [key, variant_fn.call] }
+          known_variants.map { |key, variant_fn, meta| [key, variant_fn.call, meta] }
         end
 
         # All of the specified variants for this union.
         #
         # @return [Array<Object>]
-        def variants = derefed_variants.map(&:last)
+        def variants = derefed_variants.map { _2 }
 
         # @api private
         #
@@ -51,12 +51,13 @@ module TerminalShop
         #
         #   @option spec [Boolean] :"nil?"
         private def variant(key, spec = nil)
+          meta = TerminalShop::Internal::Type::Converter.meta_info(nil, spec)
           variant_info =
             case key
             in Symbol
-              [key, TerminalShop::Internal::Type::Converter.type_info(spec)]
+              [key, TerminalShop::Internal::Type::Converter.type_info(spec), meta]
             in Proc | TerminalShop::Internal::Type::Converter | Class | Hash
-              [nil, TerminalShop::Internal::Type::Converter.type_info(key)]
+              [nil, TerminalShop::Internal::Type::Converter.type_info(key), meta]
             end
 
           known_variants << variant_info
@@ -79,7 +80,8 @@ module TerminalShop
             return nil if key == TerminalShop::Internal::OMIT
 
             key = key.to_sym if key.is_a?(String)
-            known_variants.find { |k,| k == key }&.last&.call
+            _, found = known_variants.find { |k,| k == key }
+            found&.call
           else
             nil
           end

data/lib/terminal_shop/internal/util.rb

@@ -244,7 +244,7 @@ module TerminalShop
         #
         # @return [String]
         def uri_origin(uri)
-          "#{uri.scheme}://#{uri.host}#{uri.port == uri.default_port ? '' : ":#{uri.port}"}"
+          "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
         # @api private
@@ -566,7 +566,8 @@ module TerminalShop
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
-          boundary = SecureRandom.urlsafe_base64(60)
+          # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
+          boundary = SecureRandom.urlsafe_base64(46)
 
           closing = []
           strio = writable_enum do |y|
@@ -647,7 +648,7 @@ module TerminalShop
         #
         # Assumes each chunk in stream has `Encoding::BINARY`.
         #
-        # @param headers [Hash{String=>String}, Net::HTTPHeader]
+        # @param headers [Hash{String=>String}]
         # @param stream [Enumerable<String>]
         # @param suppress_error [Boolean]
         #

data/lib/terminal_shop/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TerminalShop
-  VERSION = "3.8.9"
+  VERSION = "3.9.0"
 end

data/rbi/terminal_shop/errors.rbi

@@ -33,6 +33,9 @@ module TerminalShop
       sig { returns(T.nilable(Integer)) }
       attr_accessor :status
 
+      sig { returns(T.nilable(T::Hash[String, String])) }
+      attr_accessor :headers
+
       sig { returns(T.nilable(T.anything)) }
       attr_accessor :body
 
@@ -41,6 +44,7 @@ module TerminalShop
         params(
           url: URI::Generic,
           status: T.nilable(Integer),
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
@@ -50,6 +54,7 @@ module TerminalShop
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -59,10 +64,10 @@ module TerminalShop
     end
 
     class APIConnectionError < TerminalShop::Errors::APIError
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :status
 
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :body
 
       # @api private
@@ -70,6 +75,7 @@ module TerminalShop
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -79,6 +85,7 @@ module TerminalShop
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -93,6 +100,7 @@ module TerminalShop
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -102,6 +110,7 @@ module TerminalShop
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,13 +125,22 @@ module TerminalShop
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.for(url:, status:, body:, request:, response:, message: nil)
+      def self.for(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
 
       sig { returns(Integer) }
@@ -133,13 +151,22 @@ module TerminalShop
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.new(url:, status:, body:, request:, response:, message: nil)
+      def self.new(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
     end
 

data/rbi/terminal_shop/internal/transport/base_client.rbi

@@ -85,10 +85,9 @@ module TerminalShop
 
           # @api private
           sig do
-            params(
-              status: Integer,
-              headers: T.any(T::Hash[String, String], Net::HTTPHeader)
-            ).returns(T::Boolean)
+            params(status: Integer, headers: T::Hash[String, String]).returns(
+              T::Boolean
+            )
           end
           def should_retry?(status, headers:)
           end
@@ -99,7 +98,7 @@ module TerminalShop
               request:
                 TerminalShop::Internal::Transport::BaseClient::RequestInput,
               status: Integer,
-              response_headers: T.any(T::Hash[String, String], Net::HTTPHeader)
+              response_headers: T::Hash[String, String]
             ).returns(
               TerminalShop::Internal::Transport::BaseClient::RequestInput
             )

data/rbi/terminal_shop/internal/type/base_page.rbi

@@ -31,7 +31,7 @@ module TerminalShop
             client: TerminalShop::Internal::Transport::BaseClient,
             req:
               TerminalShop::Internal::Transport::BaseClient::RequestComponents,
-            headers: T.any(T::Hash[String, String], Net::HTTPHeader),
+            headers: T::Hash[String, String],
             page_data: T.anything
           ).void
         end

data/rbi/terminal_shop/internal/type/converter.rbi

@@ -92,6 +92,64 @@ module TerminalShop
           def self.type_info(spec)
           end
 
+          # @api private
+          sig do
+            params(
+              type_info:
+                T.any(
+                  {
+                    const:
+                      T.nilable(
+                        T.any(NilClass, T::Boolean, Integer, Float, Symbol)
+                      ),
+                    enum:
+                      T.nilable(
+                        T.proc.returns(
+                          TerminalShop::Internal::Type::Converter::Input
+                        )
+                      ),
+                    union:
+                      T.nilable(
+                        T.proc.returns(
+                          TerminalShop::Internal::Type::Converter::Input
+                        )
+                      )
+                  },
+                  T.proc.returns(
+                    TerminalShop::Internal::Type::Converter::Input
+                  ),
+                  TerminalShop::Internal::Type::Converter::Input
+                ),
+              spec:
+                T.any(
+                  {
+                    const:
+                      T.nilable(
+                        T.any(NilClass, T::Boolean, Integer, Float, Symbol)
+                      ),
+                    enum:
+                      T.nilable(
+                        T.proc.returns(
+                          TerminalShop::Internal::Type::Converter::Input
+                        )
+                      ),
+                    union:
+                      T.nilable(
+                        T.proc.returns(
+                          TerminalShop::Internal::Type::Converter::Input
+                        )
+                      )
+                  },
+                  T.proc.returns(
+                    TerminalShop::Internal::Type::Converter::Input
+                  ),
+                  TerminalShop::Internal::Type::Converter::Input
+                )
+            ).returns(TerminalShop::Internal::AnyHash)
+          end
+          def self.meta_info(type_info, spec)
+          end
+
           # @api private
           sig do
             params(translate_names: T::Boolean).returns(

data/rbi/terminal_shop/internal/type/union.rbi

@@ -16,7 +16,8 @@ module TerminalShop
             T::Array[
               [
                 T.nilable(Symbol),
-                T.proc.returns(TerminalShop::Internal::Type::Converter::Input)
+                T.proc.returns(TerminalShop::Internal::Type::Converter::Input),
+                TerminalShop::Internal::AnyHash
               ]
             ]
           )
@@ -25,7 +26,13 @@ module TerminalShop
         end
 
         # @api private
-        sig { returns(T::Array[[T.nilable(Symbol), T.anything]]) }
+        sig do
+          returns(
+            T::Array[
+              [T.nilable(Symbol), T.anything, TerminalShop::Internal::AnyHash]
+            ]
+          )
+        end
         protected def derefed_variants
         end
 

data/rbi/terminal_shop/internal/util.rbi

@@ -361,7 +361,7 @@ module TerminalShop
         # Assumes each chunk in stream has `Encoding::BINARY`.
         sig do
           params(
-            headers: T.any(T::Hash[String, String], Net::HTTPHeader),
+            headers: T::Hash[String, String],
             stream: T::Enumerable[String],
             suppress_error: T::Boolean
           ).returns(T.anything)

data/sig/terminal_shop/errors.rbs

@@ -21,11 +21,14 @@ module TerminalShop
 
       attr_accessor status: Integer?
 
+      attr_accessor headers: ::Hash[String, String]?
+
       attr_accessor body: top?
 
       def initialize: (
         url: URI::Generic,
         ?status: Integer?,
+        ?headers: ::Hash[String, String]?,
         ?body: Object?,
         ?request: nil,
         ?response: nil,
@@ -37,6 +40,7 @@ module TerminalShop
       def initialize: (
         url: URI::Generic,
         ?status: nil,
+        ?headers: ::Hash[String, String]?,
         ?body: nil,
         ?request: nil,
         ?response: nil,
@@ -48,6 +52,7 @@ module TerminalShop
       def initialize: (
         url: URI::Generic,
         ?status: nil,
+        ?headers: ::Hash[String, String]?,
         ?body: nil,
         ?request: nil,
         ?response: nil,
@@ -59,6 +64,7 @@ module TerminalShop
       def self.for: (
         url: URI::Generic,
         status: Integer,
+        headers: ::Hash[String, String]?,
         body: Object?,
         request: nil,
         response: nil,
@@ -68,6 +74,7 @@ module TerminalShop
       def initialize: (
         url: URI::Generic,
         status: Integer,
+        headers: ::Hash[String, String]?,
         body: Object?,
         request: nil,
         response: nil,

data/sig/terminal_shop/internal/type/converter.rbs

@@ -39,6 +39,23 @@ module TerminalShop
           | TerminalShop::Internal::Type::Converter::input spec
         ) -> (^-> top)
 
+        def self.meta_info: (
+          {
+            const: (nil | bool | Integer | Float | Symbol)?,
+            enum: ^-> TerminalShop::Internal::Type::Converter::input?,
+            union: ^-> TerminalShop::Internal::Type::Converter::input?
+          }
+          | ^-> TerminalShop::Internal::Type::Converter::input
+          | TerminalShop::Internal::Type::Converter::input type_info,
+          {
+            const: (nil | bool | Integer | Float | Symbol)?,
+            enum: ^-> TerminalShop::Internal::Type::Converter::input?,
+            union: ^-> TerminalShop::Internal::Type::Converter::input?
+          }
+          | ^-> TerminalShop::Internal::Type::Converter::input
+          | TerminalShop::Internal::Type::Converter::input spec
+        ) -> ::Hash[Symbol, top]
+
         def self.new_coerce_state: (
           ?translate_names: bool
         ) -> TerminalShop::Internal::Type::Converter::coerce_state

data/sig/terminal_shop/internal/type/union.rbs

@@ -5,9 +5,9 @@ module TerminalShop
         include TerminalShop::Internal::Type::Converter
         include TerminalShop::Internal::Util::SorbetRuntimeSupport
 
-        private def self.known_variants: -> ::Array[[Symbol?, (^-> TerminalShop::Internal::Type::Converter::input)]]
+        private def self.known_variants: -> ::Array[[Symbol?, (^-> TerminalShop::Internal::Type::Converter::input), ::Hash[Symbol, top]]]
 
-        def self.derefed_variants: -> ::Array[[Symbol?, top]]
+        def self.derefed_variants: -> ::Array[[Symbol?, top, ::Hash[Symbol, top]]]
 
         def self.variants: -> ::Array[top]
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: terminal-shop
 version: !ruby/object:Gem::Version
-  version: 3.8.9
+  version: 3.9.0
 platform: ruby
 authors:
 - Terminal
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-05 00:00:00.000000000 Z
+date: 2025-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool