@apollo-deploy/tesseract 1.9.0 → 2.0.0

package/templates/csharp/errors.hbs

@@ -2,30 +2,19 @@ namespace {{namespace}};
 
 using System;
 
-/// <summary>
-/// Represents an error returned by the API.
-/// </summary>
-public class SdkException : Exception
+/// <summary>Represents a normalized SDK or API error.</summary>
+public sealed class SdkException : Exception
 {
-    /// <summary>
-    /// HTTP status code.
-    /// </summary>
     public int Status { get; }
-
-    /// <summary>
-    /// Machine-readable error code from the API.
-    /// </summary>
     public string? Code { get; }
-
-    /// <summary>
-    /// Unique request identifier for support.
-    /// </summary>
     public string? RequestId { get; }
 
-    /// <summary>
-    /// Creates a new SdkException.
-    /// </summary>
-    public SdkException(int status, string? code, string message, string? requestId, Exception? innerException = null)
+    public SdkException(
+        int status,
+        string? code,
+        string message,
+        string? requestId,
+        Exception? innerException = null)
         : base(message, innerException)
     {
         Status = status;
@@ -33,13 +22,16 @@ public class SdkException : Exception
         RequestId = requestId;
     }
 
-    /// <summary>
-    /// Returns a string representation of the error.
-    /// </summary>
+    public bool IsNetworkError => Status == 0;
+    public bool IsClientError => Status is >= 400 and <= 499;
+    public bool IsServerError => Status is >= 500 and <= 599;
+    public bool IsRetryable => IsNetworkError || Status is 408 or 425 or 429 or 500 or 502 or 503 or 504;
+
     public override string ToString()
     {
-        if (!string.IsNullOrEmpty(Code))
-            return $"[{Status}] {Code}: {Message}";
-        return $"[{Status}] {Message}";
+        var request = string.IsNullOrEmpty(RequestId) ? "" : $" (request {RequestId})";
+        return string.IsNullOrEmpty(Code)
+            ? $"[{Status}] {Message}{request}"
+            : $"[{Status}] {Code}: {Message}{request}";
     }
 }

package/templates/csharp/readme.hbs

@@ -1,8 +1,8 @@
 # {{title}} .NET SDK
 
-[![NuGet](https://img.shields.io/nuget/v/{{packageName}}.svg)](https://www.nuget.org/packages/{{packageName}}/)
+{{#if description}}{{description}}{{else}}.NET client for the {{title}} API.{{/if}}
 
-The official .NET SDK for {{#if description}}{{description}}{{else}}the {{title}} API{{/if}}.
+> Generated by Tesseract. Generated source files should not be edited manually.
 
 ## Installation
 
@@ -10,67 +10,54 @@ The official .NET SDK for {{#if description}}{{description}}{{else}}the {{title}
 dotnet add package {{packageName}}
 ```
 
-## Quick Start
+## Quick start
 
 ```csharp
 using {{namespace}};
 
-{{#each securitySchemes}}
-{{#if (eq type "apiKey")}}
-var config = new {{../clientName}}ClientConfig
+var client = new {{clientName}}Client(new {{clientName}}ClientConfig
 {
-    {{pascalCase configKey}} = "your-api-key"{{#if (and (eq type "apiKey") (eq in "header"))}}{{/if}}
-};
-{{/if}}
-{{#if (and (eq type "http") (eq scheme "bearer"))}}
-var config = new {{../clientName}}ClientConfig
-{
-    {{pascalCase configKey}} = "your-bearer-token"
-};
+    BaseUrl = "{{baseUrl}}",
+    TimeoutMs = 15_000,
+});
+
+{{#if groups.length}}
+var api = client.{{pascalCase groups.[0].name}};
 {{/if}}
-{{/each}}
-{{#unless securitySchemes.length}}
-var config = new {{clientName}}ClientConfig();
-{{/unless}}
+```
 
-var client = new {{clientName}}Client(config);
+## Configuration and reliability
 
-{{#each groups}}
-{{#with operations.[0]}}
-// {{../interfaceName}}.{{pascalCase name}} example
-var result = await client.{{pascalCase ../name}}.{{pascalCase name}}Async({{#each ../pathParams}}"{{this}}"{{#unless @last}}, {{/unless}}{{/each}}{{#if requestBody}}{{#if ../pathParams.length}}, {{/if}}new {{requestBody.type}}(){}{{/if}});
-Console.WriteLine(result);
-{{/with}}
-{{/each}}
+The generated `HttpClient` transport supports cancellation tokens, bounded timeouts, exponential-backoff retries, `Retry-After` handling, default headers, and structured `SdkException` values. Unsafe requests are not retried unless they are explicitly idempotent or unsafe retries are enabled.
+
+```csharp
+var client = new {{clientName}}Client(new {{clientName}}ClientConfig
+{
+    TimeoutMs = 30_000,
+    MaxRetries = 3,
+    DefaultHeaders = new() { ["X-Application"] = "my-service" },
+});
 ```
 
-## API Reference
+## Documentation
+
+- [Documentation index](./docs/README.md)
+- [Generated types](./docs/types.md)
 
 | Domain | Description |
-|--------|-------------|
+|---|---|
 {{#each groups}}
-| `{{interfaceName}}` | {{#if description}}{{description}}{{else}}{{name}} operations{{/if}} |
+| [{{interfaceName}}](./docs/domains/{{fileName}}.md) | {{#if description}}{{description}}{{else}}{{name}} operations{{/if}} |
 {{/each}}
 
-## Error Handling
-
-All async methods throw `SdkException` on API errors. Use try-catch to handle errors:
+## Error handling
 
-```csharp
-try
-{
-    var result = await client.{{#each groups}}{{#if @first}}{{pascalCase name}}{{/if}}{{/each}}.{{#each groups}}{{#if @first}}{{#with operations.[0]}}{{pascalCase name}}Async(){{/with}}{{/if}}{{/each}};
-}
-catch (SdkException ex)
-{
-    Console.WriteLine($"Status: {ex.Status}, Code: {ex.Code}, RequestId: {ex.RequestId}");
-}
-```
+All operations throw `SdkException` on API or transport failures. It exposes `Status`, `Code`, `RequestId`, and the original exception when available.
 
 ## Requirements
 
-- .NET 8.0 or later
+- .NET 8 or later
 
 ## License
 
-{{#if license}}{{license}}{{else}}MIT{{/if}}
+MIT