Generators.NET

Changelog

December 11, 2025

2.11.3

(fix): Remove blocking .Result calls on async tasks in generated code. Header values now support async resolution via Func<ValueTask<string>> and Func<Task<string>>, and the RawClient uses async methods (CreateHttpRequestAsync, MergeHeadersAsync) to resolve headers without blocking. This improves performance and prevents potential deadlocks in async contexts.

December 5, 2025

2.11.2

(fix): Change core files to fully qualify references to Attribute and related types in case of name collision.

2.11.1

(fix): When include-exception-handler: true is configured:

  • Remove unneeded CaptureException method from Interceptor class, since there’s already an Intercept method.

2.11.0

(feat): Add constructor exception handling infrastructure for SDK authors to capture initialization errors.

When include-exception-handler: true is configured:

  • Adds CaptureException method to ExceptionHandler class for capturing exceptions without re-throwing
  • Wraps all client constructors (root and sub-clients) with try-catch blocks
  • Initializes clientOptions.ExceptionHandler with a custom interceptor in the root client constructor
  • Generates a {PackageName}ExceptionInterceptor stub class that SDK authors can customize

New configuration option:

  • exception-interceptor-class-name: Custom name for the exception interceptor class (optional)

Example generators.yml configuration:

1groups:
2  dotnet-sdk:
3    generators:
4      - name: fernapi/fern-csharp-sdk
5        version: 2.11.0
6        config:
7          include-exception-handler: true
8          exception-interceptor-class-name: MyCustomExceptionInterceptor

SDK authors can implement their exception capturing logic (e.g., application monitoring platform, logging) in the generated interceptor class.

December 3, 2025

2.10.0

(feat): Add support for flexible output-path configuration that allows specifying different paths for the library project, test project, solution file, and other files (README.md, reference.md).

Configuration options:

  • Simple string: output-path: src - all projects go to that path
  • Object with specific paths:
    • library: path for the library project (default: “src”)
    • test: path for the test project (default: “src”)
    • solution: path for the solution file (default: ”.”)
    • other: path for README.md, reference.md, and other files (default: ”.”)

Example generators.yml configuration:

1groups:
2  dotnet-sdk:
3    generators:
4      - name: fernapi/fern-csharp-sdk
5        version: 2.10.0
6        config:
7          output-path:
8            library: src/MyApi
9            test: test/MyApi.Test
10            solution: .
11            other: src/MyApi

The generated CI workflow and project references are automatically updated to use the configured paths. Note: .github, .fern, .editorconfig, .gitignore, and .fernignore are always generated in the root output folder.

2.9.9

(fix): Retries now check Retry-After and X-RateLimit-Reset headers before defaulting to exponential backoff with jitter.

2.9.8

(fix): Restore default behavior for wire tests: tests are now generated by default and controlled via the existing generate-mock-server-tests config option (defaults to true). The enable-wire-tests option is now treated as an alias for backward compatibility.

December 2, 2025

2.9.7

(fix): Wire tests are now controlled entirely by the enable-wire-tests custom config option, no longer using the CLI’s writeUnitTests flag.

2.9.6

(fix): Fix getGitHubConfig to return RawGithubConfig with undefined values instead of throwing errors when publishing config is missing, aligning with TypeScript/Python generator behavior.