terminal-shop 3.6.1 → 3.7.0

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

@@ -5,41 +5,57 @@ module TerminalShop
     module Transport
       # @api private
       class BaseClient
+        extend TerminalShop::Internal::Util::SorbetRuntimeSupport
+
         abstract!
 
-        RequestComponentsShape =
+        RequestComponents =
           T.type_alias do
             {
               method: Symbol,
               path: T.any(String, T::Array[String]),
-              query: T.nilable(T::Hash[String, T.nilable(T.any(T::Array[String], String))]),
-              headers: T.nilable(
-                T::Hash[String,
-                        T.nilable(
-                          T.any(
-                            String,
-                            Integer,
-                            T::Array[T.nilable(T.any(String, Integer))]
-                          )
-                        )]
-              ),
+              query:
+                T.nilable(
+                  T::Hash[String, T.nilable(T.any(T::Array[String], String))]
+                ),
+              headers:
+                T.nilable(
+                  T::Hash[
+                    String,
+                    T.nilable(
+                      T.any(
+                        String,
+                        Integer,
+                        T::Array[T.nilable(T.any(String, Integer))]
+                      )
+                    )
+                  ]
+                ),
               body: T.nilable(T.anything),
-              unwrap: T.nilable(
-                T.any(
-                  Symbol,
-                  Integer,
-                  T::Array[T.any(Symbol, Integer)],
-                  T.proc.params(arg0: T.anything).returns(T.anything)
-                )
-              ),
-              page: T.nilable(T::Class[TerminalShop::Internal::Type::BasePage[TerminalShop::Internal::Type::BaseModel]]),
+              unwrap:
+                T.nilable(
+                  T.any(
+                    Symbol,
+                    Integer,
+                    T::Array[T.any(Symbol, Integer)],
+                    T.proc.params(arg0: T.anything).returns(T.anything)
+                  )
+                ),
+              page:
+                T.nilable(
+                  T::Class[
+                    TerminalShop::Internal::Type::BasePage[
+                      TerminalShop::Internal::Type::BaseModel
+                    ]
+                  ]
+                ),
               stream: T.nilable(T::Class[T.anything]),
               model: T.nilable(TerminalShop::Internal::Type::Converter::Input),
-              options: T.nilable(TerminalShop::RequestOpts)
+              options: T.nilable(TerminalShop::RequestOptions::OrHash)
             }
           end
 
-        RequestInputShape =
+        RequestInput =
           T.type_alias do
             {
               method: Symbol,
@@ -58,43 +74,71 @@ module TerminalShop
 
         class << self
           # @api private
-          sig { params(req: TerminalShop::Internal::Transport::BaseClient::RequestComponentsShape).void }
-          def validate!(req); end
+          sig do
+            params(
+              req:
+                TerminalShop::Internal::Transport::BaseClient::RequestComponents
+            ).void
+          end
+          def validate!(req)
+          end
 
           # @api private
           sig do
             params(
               status: Integer,
-              headers: T.any(
-                T::Hash[String, String],
-                Net::HTTPHeader
-              )
+              headers: T.any(T::Hash[String, String], Net::HTTPHeader)
             ).returns(T::Boolean)
           end
-          def should_retry?(status, headers:); end
+          def should_retry?(status, headers:)
+          end
 
           # @api private
           sig do
             params(
-              request: TerminalShop::Internal::Transport::BaseClient::RequestInputShape,
+              request:
+                TerminalShop::Internal::Transport::BaseClient::RequestInput,
               status: Integer,
               response_headers: T.any(T::Hash[String, String], Net::HTTPHeader)
+            ).returns(
+              TerminalShop::Internal::Transport::BaseClient::RequestInput
             )
-              .returns(TerminalShop::Internal::Transport::BaseClient::RequestInputShape)
           end
-          def follow_redirect(request, status:, response_headers:); end
+          def follow_redirect(request, status:, response_headers:)
+          end
 
           # @api private
           sig do
             params(
               status: T.any(Integer, TerminalShop::Errors::APIConnectionError),
               stream: T.nilable(T::Enumerable[String])
-            )
-              .void
+            ).void
+          end
+          def reap_connection!(status, stream:)
           end
-          def reap_connection!(status, stream:); end
         end
 
+        sig { returns(URI::Generic) }
+        attr_reader :base_url
+
+        sig { returns(Float) }
+        attr_reader :timeout
+
+        sig { returns(Integer) }
+        attr_reader :max_retries
+
+        sig { returns(Float) }
+        attr_reader :initial_retry_delay
+
+        sig { returns(Float) }
+        attr_reader :max_retry_delay
+
+        sig { returns(T::Hash[String, String]) }
+        attr_reader :headers
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :idempotency_header
+
         # @api private
         sig { returns(TerminalShop::Internal::Transport::PooledNetRequester) }
         attr_reader :requester
@@ -107,11 +151,19 @@ module TerminalShop
             max_retries: Integer,
             initial_retry_delay: Float,
             max_retry_delay: Float,
-            headers: T::Hash[String,
-                             T.nilable(T.any(String, Integer, T::Array[T.nilable(T.any(String, Integer))]))],
+            headers:
+              T::Hash[
+                String,
+                T.nilable(
+                  T.any(
+                    String,
+                    Integer,
+                    T::Array[T.nilable(T.any(String, Integer))]
+                  )
+                )
+              ],
             idempotency_header: T.nilable(String)
-          )
-            .returns(T.attached_class)
+          ).returns(T.attached_class)
         end
         def self.new(
           base_url:,
@@ -121,41 +173,61 @@ module TerminalShop
           max_retry_delay: 0.0,
           headers: {},
           idempotency_header: nil
-        ); end
+        )
+        end
+
         # @api private
         sig { overridable.returns(T::Hash[String, String]) }
-        private def auth_headers; end
+        private def auth_headers
+        end
 
         # @api private
         sig { returns(String) }
-        private def generate_idempotency_key; end
+        private def generate_idempotency_key
+        end
 
         # @api private
         sig do
           overridable
             .params(
-              req: TerminalShop::Internal::Transport::BaseClient::RequestComponentsShape,
+              req:
+                TerminalShop::Internal::Transport::BaseClient::RequestComponents,
               opts: TerminalShop::Internal::AnyHash
             )
-            .returns(TerminalShop::Internal::Transport::BaseClient::RequestInputShape)
+            .returns(
+              TerminalShop::Internal::Transport::BaseClient::RequestInput
+            )
+        end
+        private def build_request(req, opts)
         end
-        private def build_request(req, opts); end
 
         # @api private
-        sig { params(headers: T::Hash[String, String], retry_count: Integer).returns(Float) }
-        private def retry_delay(headers, retry_count:); end
+        sig do
+          params(
+            headers: T::Hash[String, String],
+            retry_count: Integer
+          ).returns(Float)
+        end
+        private def retry_delay(headers, retry_count:)
+        end
 
         # @api private
         sig do
           params(
-            request: TerminalShop::Internal::Transport::BaseClient::RequestInputShape,
+            request:
+              TerminalShop::Internal::Transport::BaseClient::RequestInput,
             redirect_count: Integer,
             retry_count: Integer,
             send_retry_header: T::Boolean
-          )
-            .returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
+          ).returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
+        end
+        private def send_request(
+          request,
+          redirect_count:,
+          retry_count:,
+          send_retry_header:
+        )
         end
-        private def send_request(request, redirect_count:, retry_count:, send_retry_header:); end
 
         # Execute the request specified by `req`. This is the method that all resource
         # methods call into.
@@ -165,32 +237,45 @@ module TerminalShop
           params(
             method: Symbol,
             path: T.any(String, T::Array[String]),
-            query: T.nilable(T::Hash[String, T.nilable(T.any(T::Array[String], String))]),
-            headers: T.nilable(
-              T::Hash[String,
-                      T.nilable(
-                        T.any(
-                          String,
-                          Integer,
-                          T::Array[T.nilable(T.any(String, Integer))]
-                        )
-                      )]
-            ),
+            query:
+              T.nilable(
+                T::Hash[String, T.nilable(T.any(T::Array[String], String))]
+              ),
+            headers:
+              T.nilable(
+                T::Hash[
+                  String,
+                  T.nilable(
+                    T.any(
+                      String,
+                      Integer,
+                      T::Array[T.nilable(T.any(String, Integer))]
+                    )
+                  )
+                ]
+              ),
             body: T.nilable(T.anything),
-            unwrap: T.nilable(
-              T.any(
-                Symbol,
-                Integer,
-                T::Array[T.any(Symbol, Integer)],
-                T.proc.params(arg0: T.anything).returns(T.anything)
-              )
-            ),
-            page: T.nilable(T::Class[TerminalShop::Internal::Type::BasePage[TerminalShop::Internal::Type::BaseModel]]),
+            unwrap:
+              T.nilable(
+                T.any(
+                  Symbol,
+                  Integer,
+                  T::Array[T.any(Symbol, Integer)],
+                  T.proc.params(arg0: T.anything).returns(T.anything)
+                )
+              ),
+            page:
+              T.nilable(
+                T::Class[
+                  TerminalShop::Internal::Type::BasePage[
+                    TerminalShop::Internal::Type::BaseModel
+                  ]
+                ]
+              ),
             stream: T.nilable(T::Class[T.anything]),
             model: T.nilable(TerminalShop::Internal::Type::Converter::Input),
-            options: T.nilable(TerminalShop::RequestOpts)
-          )
-            .returns(T.anything)
+            options: T.nilable(TerminalShop::RequestOptions::OrHash)
+          ).returns(T.anything)
         end
         def request(
           method,
@@ -203,10 +288,13 @@ module TerminalShop
           stream: nil,
           model: TerminalShop::Internal::Type::Unknown,
           options: {}
-        ); end
+        )
+        end
+
         # @api private
         sig { returns(String) }
-        def inspect; end
+        def inspect
+        end
       end
     end
   end

data/rbi/terminal_shop/internal/transport/pooled_net_requester.rbi

@@ -5,7 +5,9 @@ module TerminalShop
     module Transport
       # @api private
       class PooledNetRequester
-        RequestShape =
+        extend TerminalShop::Internal::Util::SorbetRuntimeSupport
+
+        Request =
           T.type_alias do
             {
               method: Symbol,
@@ -23,37 +25,51 @@ module TerminalShop
         class << self
           # @api private
           sig { params(url: URI::Generic).returns(Net::HTTP) }
-          def connect(url); end
+          def connect(url)
+          end
 
           # @api private
           sig { params(conn: Net::HTTP, deadline: Float).void }
-          def calibrate_socket_timeout(conn, deadline); end
+          def calibrate_socket_timeout(conn, deadline)
+          end
 
           # @api private
           sig do
             params(
-              request: TerminalShop::Internal::Transport::PooledNetRequester::RequestShape,
+              request:
+                TerminalShop::Internal::Transport::PooledNetRequester::Request,
               blk: T.proc.params(arg0: String).void
-            )
-              .returns([Net::HTTPGenericRequest, T.proc.void])
+            ).returns([Net::HTTPGenericRequest, T.proc.void])
+          end
+          def build_request(request, &blk)
           end
-          def build_request(request, &blk); end
         end
 
         # @api private
-        sig { params(url: URI::Generic, deadline: Float, blk: T.proc.params(arg0: Net::HTTP).void).void }
-        private def with_pool(url, deadline:, &blk); end
+        sig do
+          params(
+            url: URI::Generic,
+            deadline: Float,
+            blk: T.proc.params(arg0: Net::HTTP).void
+          ).void
+        end
+        private def with_pool(url, deadline:, &blk)
+        end
 
         # @api private
         sig do
-          params(request: TerminalShop::Internal::Transport::PooledNetRequester::RequestShape)
-            .returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
+          params(
+            request:
+              TerminalShop::Internal::Transport::PooledNetRequester::Request
+          ).returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
+        end
+        def execute(request)
         end
-        def execute(request); end
 
         # @api private
         sig { params(size: Integer).returns(T.attached_class) }
-        def self.new(size: Etc.nprocessors); end
+        def self.new(size: Etc.nprocessors)
+        end
       end
     end
   end

data/rbi/terminal_shop/internal/type/array_of.rbi

@@ -15,25 +15,29 @@ module TerminalShop
 
         sig do
           params(
-            type_info: T.any(
-              TerminalShop::Internal::AnyHash,
-              T.proc.returns(TerminalShop::Internal::Type::Converter::Input),
-              TerminalShop::Internal::Type::Converter::Input
-            ),
+            type_info:
+              T.any(
+                TerminalShop::Internal::AnyHash,
+                T.proc.returns(TerminalShop::Internal::Type::Converter::Input),
+                TerminalShop::Internal::Type::Converter::Input
+              ),
             spec: TerminalShop::Internal::AnyHash
-          )
-            .returns(T.attached_class)
+          ).returns(T.attached_class)
+        end
+        def self.[](type_info, spec = {})
         end
-        def self.[](type_info, spec = {}); end
 
         sig { params(other: T.anything).returns(T::Boolean) }
-        def ===(other); end
+        def ===(other)
+        end
 
         sig { params(other: T.anything).returns(T::Boolean) }
-        def ==(other); end
+        def ==(other)
+        end
 
         sig { returns(Integer) }
-        def hash; end
+        def hash
+        end
 
         # @api private
         sig do
@@ -44,7 +48,8 @@ module TerminalShop
             )
             .returns(T.any(T::Array[T.anything], T.anything))
         end
-        def coerce(value, state:); end
+        def coerce(value, state:)
+        end
 
         # @api private
         sig do
@@ -55,33 +60,38 @@ module TerminalShop
             )
             .returns(T.any(T::Array[T.anything], T.anything))
         end
-        def dump(value, state:); end
+        def dump(value, state:)
+        end
 
         # @api private
         sig { returns(Elem) }
-        protected def item_type; end
+        protected def item_type
+        end
 
         # @api private
         sig { returns(T::Boolean) }
-        protected def nilable?; end
+        protected def nilable?
+        end
 
         # @api private
         sig do
           params(
-            type_info: T.any(
-              TerminalShop::Internal::AnyHash,
-              T.proc.returns(TerminalShop::Internal::Type::Converter::Input),
-              TerminalShop::Internal::Type::Converter::Input
-            ),
+            type_info:
+              T.any(
+                TerminalShop::Internal::AnyHash,
+                T.proc.returns(TerminalShop::Internal::Type::Converter::Input),
+                TerminalShop::Internal::Type::Converter::Input
+              ),
             spec: TerminalShop::Internal::AnyHash
-          )
-            .void
+          ).void
+        end
+        def initialize(type_info, spec = {})
         end
-        def initialize(type_info, spec = {}); end
 
         # @api private
         sig { params(depth: Integer).returns(String) }
-        def inspect(depth: 0); end
+        def inspect(depth: 0)
+        end
       end
     end
   end