docs(client): document max retries

Author: stainless-app[bot]

README.md

@@ -135,6 +135,42 @@ false
 
 ## Network options
 
+### Retries
+
+The SDK automatically retries 2 times by default, with a short exponential backoff between requests.
+
+Only the following error types are retried:
+
+- Connection errors (for example, due to a network connectivity problem)
+- 408 Request Timeout
+- 409 Conflict
+- 429 Rate Limit
+- 5xx Internal
+
+The API may also explicitly instruct the SDK to retry or not retry a request.
+
+To set a custom number of retries, configure the client using the `MaxRetries` method:
+
+```csharp
+using Orb;
+
+OrbClient client = new() { MaxRetries = 3 };
+```
+
+Or configure a single method call using [`WithOptions`](#modifying-configuration):
+
+```csharp
+using System;
+
+var customer = await client
+    .WithOptions(options =>
+        options with { MaxRetries = 3 }
+    )
+    .Customers.Create(parameters);
+
+Console.WriteLine(customer);
+```
+
 ### Timeouts
 
 Requests time out after 1 minute by default.

src/Orb/Core/ClientOptions.cs

@@ -19,10 +19,10 @@ public Uri BaseUrl
 
     public bool ResponseValidation { get; set; } = false;
 
-    public TimeSpan Timeout { get; set; } = TimeSpan.FromMinutes(1);
-
     public int MaxRetries { get; set; } = 2;
 
+    public TimeSpan Timeout { get; set; } = TimeSpan.FromMinutes(1);
+
     Lazy<string> _apiKey = new(() =>
         Environment.GetEnvironmentVariable("ORB_API_KEY")
         ?? throw new OrbInvalidDataException(

src/Orb/IOrbClient.cs

@@ -30,10 +30,10 @@ public interface IOrbClient
 
     bool ResponseValidation { get; init; }
 
-    TimeSpan Timeout { get; init; }
-
     int MaxRetries { get; init; }
 
+    TimeSpan Timeout { get; init; }
+
     string APIKey { get; init; }
 
     string? WebhookSecret { get; init; }

src/Orb/OrbClient.cs

@@ -56,18 +56,18 @@ public bool ResponseValidation
         init { this._options.ResponseValidation = value; }
     }
 
-    public TimeSpan Timeout
-    {
-        get { return this._options.Timeout; }
-        init { this._options.Timeout = value; }
-    }
-
     public int MaxRetries
     {
         get { return this._options.MaxRetries; }
         init { this._options.MaxRetries = value; }
     }
 
+    public TimeSpan Timeout
+    {
+        get { return this._options.Timeout; }
+        init { this._options.Timeout = value; }
+    }
+
     public string APIKey
     {
         get { return this._options.APIKey; }