chore(internal): minor type annotation improvements

Author: stainless-app[bot]

Steepfile

@@ -2,7 +2,7 @@
 
 require "yaml"
 
-target :lib do
+target(:lib) do
   configure_code_diagnostics(Steep::Diagnostic::Ruby.strict)
 
   signature("sig")

lib/openai/internal/cursor_page.rb

@@ -28,7 +28,7 @@ def next_page?
       end
 
       # @raise [OpenAI::HTTP::Error]
-      # @return [OpenAI::Internal::CursorPage]
+      # @return [self]
       def next_page
         unless next_page?
           message = "No more pages available. Please check #next_page? before calling ##{__method__}"

lib/openai/internal/page.rb

@@ -28,7 +28,7 @@ def next_page?
       end
 
       # @raise [OpenAI::HTTP::Error]
-      # @return [OpenAI::Internal::Page]
+      # @return [self]
       def next_page
         RuntimeError.new("No more pages available.")
       end

lib/openai/internal/transport/base_client.rb

@@ -216,9 +216,9 @@ def initialize(
         #
         #   @option req [Symbol, nil] :unwrap
         #
-        #   @option req [Class, nil] :page
+        #   @option req [Class<OpenAI::Internal::Type::BasePage>, nil] :page
         #
-        #   @option req [Class, nil] :stream
+        #   @option req [Class<OpenAI::Internal::Type::BaseStream>, nil] :stream
         #
         #   @option req [OpenAI::Internal::Type::Converter, Class, nil] :model
         #
@@ -417,9 +417,9 @@ def initialize(
         #
         # @param unwrap [Symbol, nil]
         #
-        # @param page [Class, nil]
+        # @param page [Class<OpenAI::Internal::Type::BasePage>, nil]
         #
-        # @param stream [Class, nil]
+        # @param stream [Class<OpenAI::Internal::Type::BaseStream>, nil]
         #
         # @param model [OpenAI::Internal::Type::Converter, Class, nil]
         #

lib/openai/internal/type/array_of.rb

@@ -28,6 +28,8 @@ class ArrayOf
         #   @option spec [Proc] :union
         #
         #   @option spec [Boolean] :"nil?"
+        #
+        # @return [OpenAI::Internal::Type::ArrayOf]
         def self.[](...) = new(...)
 
         # @api public

lib/openai/internal/type/base_model.rb

@@ -389,7 +389,7 @@ def to_yaml(*a) = OpenAI::Internal::Type::Converter.dump(self.class, self).to_ya
 
         # Create a new instance of a model.
         #
-        # @param data [Hash{Symbol=>Object}, OpenAI::Internal::Type::BaseModel]
+        # @param data [Hash{Symbol=>Object}, self]
         def initialize(data = {})
           case OpenAI::Internal::Util.coerce_hash(data)
           in Hash => coerced

lib/openai/internal/type/base_page.rb

@@ -19,7 +19,7 @@ def next_page? = (raise NotImplementedError)
         # @api public
         #
         # @raise [OpenAI::Errors::APIError]
-        # @return [OpenAI::Internal::Type::BasePage]
+        # @return [self]
         def next_page = (raise NotImplementedError)
 
         # @api public

lib/openai/internal/type/hash_of.rb

@@ -28,6 +28,8 @@ class HashOf
         #   @option spec [Proc] :union
         #
         #   @option spec [Boolean] :"nil?"
+        #
+        # @return [OpenAI::Internal::Type::HashOf]
         def self.[](...) = new(...)
 
         # @api public