onebusaway-sdk 0.1.0.pre.alpha.205 → 0.1.0.pre.alpha.207

data/rbi/lib/onebusaway-sdk/base_client.rbi

@@ -1,6 +1,7 @@
 # typed: strong
 
 module OnebusawaySDK
+  # @api private
   class BaseClient
     abstract!
 
@@ -21,7 +22,8 @@ module OnebusawaySDK
         ),
         body: T.nilable(T.anything),
         unwrap: T.nilable(Symbol),
-        page: T.nilable(T::Class[OnebusawaySDK::BaseModel]),
+        page: T.nilable(T::Class[OnebusawaySDK::BasePage[OnebusawaySDK::BaseModel]]),
+        stream: T.nilable(T::Class[T.anything]),
         model: T.nilable(OnebusawaySDK::Converter::Input),
         options: T.nilable(T.any(OnebusawaySDK::RequestOptions, T::Hash[Symbol, T.anything]))
       }
@@ -42,25 +44,41 @@ module OnebusawaySDK
 
     PLATFORM_HEADERS = T::Hash[String, String]
 
-    sig { params(req: OnebusawaySDK::BaseClient::RequestComponentsShape).void }
-    def self.validate!(req)
-    end
-
-    sig do
-      params(status: Integer, headers: T.any(T::Hash[String, String], Net::HTTPHeader)).returns(T::Boolean)
-    end
-    def self.should_retry?(status, headers:)
-    end
-
-    sig do
-      params(
-        request: OnebusawaySDK::BaseClient::RequestInputShape,
-        status: Integer,
-        response_headers: T.any(T::Hash[String, String], Net::HTTPHeader)
-      )
-        .returns(OnebusawaySDK::BaseClient::RequestInputShape)
-    end
-    def self.follow_redirect(request, status:, response_headers:)
+    class << self
+      # @api private
+      sig { params(req: OnebusawaySDK::BaseClient::RequestComponentsShape).void }
+      def validate!(req)
+      end
+
+      # @api private
+      sig do
+        params(status: Integer, headers: T.any(T::Hash[String, String], Net::HTTPHeader)).returns(T::Boolean)
+      end
+      def should_retry?(status, headers:)
+      end
+
+      # @api private
+      sig do
+        params(
+          request: OnebusawaySDK::BaseClient::RequestInputShape,
+          status: Integer,
+          response_headers: T.any(T::Hash[String, String], Net::HTTPHeader)
+        )
+          .returns(OnebusawaySDK::BaseClient::RequestInputShape)
+      end
+      def follow_redirect(request, status:, response_headers:)
+      end
+
+      # @api private
+      sig do
+        params(
+          status: T.any(Integer, OnebusawaySDK::APIConnectionError),
+          stream: T.nilable(T::Enumerable[String])
+        )
+          .void
+      end
+      def reap_connection!(status, stream:)
+      end
     end
 
     sig { returns(T.anything) }
@@ -71,6 +89,7 @@ module OnebusawaySDK
     def requester=(_)
     end
 
+    # @api private
     sig do
       params(
         base_url: String,
@@ -82,9 +101,9 @@ module OnebusawaySDK
                          T.nilable(T.any(String, Integer, T::Array[T.nilable(T.any(String, Integer))]))],
         idempotency_header: T.nilable(String)
       )
-        .void
+        .returns(T.attached_class)
     end
-    def initialize(
+    def self.new(
       base_url:,
       timeout: 0.0,
       max_retries: 0,
@@ -95,14 +114,17 @@ module OnebusawaySDK
     )
     end
 
+    # @api private
     sig { overridable.returns(T::Hash[String, String]) }
     private def auth_query
     end
 
+    # @api private
     sig { returns(String) }
     private def generate_idempotency_key
     end
 
+    # @api private
     sig do
       overridable
         .params(req: OnebusawaySDK::BaseClient::RequestComponentsShape, opts: T::Hash[Symbol, T.anything])
@@ -111,10 +133,12 @@ module OnebusawaySDK
     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
 
+    # @api private
     sig do
       params(
         request: OnebusawaySDK::BaseClient::RequestInputShape,
@@ -122,22 +146,13 @@ module OnebusawaySDK
         retry_count: Integer,
         send_retry_header: T::Boolean
       )
-        .returns([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
 
-    sig do
-      params(
-        req: OnebusawaySDK::BaseClient::RequestComponentsShape,
-        headers: T.any(T::Hash[String, String], Net::HTTPHeader),
-        stream: T::Enumerable[String]
-      )
-        .returns(T.anything)
-    end
-    private def parse_response(req, headers:, stream:)
-    end
-
+    # Execute the request specified by `req`. This is the method that all resource
+    #   methods call into.
     sig do
       params(
         method: Symbol,
@@ -155,7 +170,8 @@ module OnebusawaySDK
         ),
         body: T.nilable(T.anything),
         unwrap: T.nilable(Symbol),
-        page: T.nilable(T::Class[OnebusawaySDK::BaseModel]),
+        page: T.nilable(T::Class[OnebusawaySDK::BasePage[OnebusawaySDK::BaseModel]]),
+        stream: T.nilable(T::Class[T.anything]),
         model: T.nilable(OnebusawaySDK::Converter::Input),
         options: T.nilable(T.any(OnebusawaySDK::RequestOptions, T::Hash[Symbol, T.anything]))
       )
@@ -169,6 +185,7 @@ module OnebusawaySDK
       body: nil,
       unwrap: nil,
       page: nil,
+      stream: nil,
       model: OnebusawaySDK::Unknown,
       options: {}
     )