chore: order client variables by "importance" (#200)

Author: stainless-app[bot]

lib/orb/client.rb

@@ -71,10 +71,10 @@ class Client < Orb::Transport::BaseClient
 
     # Creates and returns a new client for interacting with the API.
     #
-    # @param base_url [String, nil] Override the default base URL for the API, e.g., `"https://api.example.com/v2/"`
-    #
     # @param api_key [String, nil] Defaults to `ENV["ORB_API_KEY"]`
     #
+    # @param base_url [String, nil] Override the default base URL for the API, e.g., `"https://api.example.com/v2/"`
+    #
     # @param max_retries [Integer] Max number of retries to attempt after a failed retryable request.
     #
     # @param timeout [Float]
@@ -85,8 +85,8 @@ class Client < Orb::Transport::BaseClient
     #
     # @param idempotency_header [String]
     def initialize(
-      base_url: nil,
       api_key: ENV["ORB_API_KEY"],
+      base_url: nil,
       max_retries: DEFAULT_MAX_RETRIES,
       timeout: DEFAULT_TIMEOUT_IN_SECONDS,
       initial_retry_delay: DEFAULT_INITIAL_RETRY_DELAY,
@@ -96,7 +96,7 @@ def initialize(
       base_url ||= "https://api.withorb.com/v1"
 
       if api_key.nil?
-        raise ArgumentError.new("api_key is required")
+        raise ArgumentError.new("api_key is required, and can be set via environ: \"ORB_API_KEY\"")
       end
 
       @api_key = api_key.to_s

rbi/lib/orb/client.rbi

@@ -63,8 +63,8 @@ module Orb
     # Creates and returns a new client for interacting with the API.
     sig do
       params(
-        base_url: T.nilable(String),
         api_key: T.nilable(String),
+        base_url: T.nilable(String),
         max_retries: Integer,
         timeout: Float,
         initial_retry_delay: Float,
@@ -74,10 +74,10 @@ module Orb
         .returns(T.attached_class)
     end
     def self.new(
-      # Override the default base URL for the API, e.g., `"https://api.example.com/v2/"`
-      base_url: nil,
       # Defaults to `ENV["ORB_API_KEY"]`
       api_key: ENV["ORB_API_KEY"],
+      # Override the default base URL for the API, e.g., `"https://api.example.com/v2/"`
+      base_url: nil,
       # Max number of retries to attempt after a failed retryable request.
       max_retries: DEFAULT_MAX_RETRIES,
       timeout: DEFAULT_TIMEOUT_IN_SECONDS,

sig/orb/client.rbs

@@ -41,8 +41,8 @@ module Orb
     private def auth_headers: -> ::Hash[String, String]
 
     def initialize: (
-      ?base_url: String?,
       ?api_key: String?,
+      ?base_url: String?,
       ?max_retries: Integer,
       ?timeout: Float,
       ?initial_retry_delay: Float,