versions.yml

# yaml-language-server: $schema=../../../fern-versions-yml.schema.json
- version: 3.44.2
  changelogEntry:
    - summary: |
        Generate named Java wrapper classes for unknown type aliases. Previously,
        when an API schema had no `type` and no `properties` (representing an
        "any" type), the generator dropped the named type definition and inlined
        `Object` wherever it was referenced. Unknown type aliases now generate a
        proper wrapper class (e.g. `DocumentedUnknownType`) based on
        `java.lang.Object`, consistent with how other alias types are handled.
      type: fix
  createdAt: "2026-03-16"
  irVersion: 65

- version: 3.44.1
  changelogEntry:
    - summary: |
        Fix `enable-forward-compatible-enums` config flag being ignored in
        download files mode. The flag was missing from
        `JavaSdkDownloadFilesCustomConfig`, so `enable-forward-compatible-enums: false`
        in generators.yml had no effect when using `--local` generation.
      type: fix
  createdAt: "2026-03-14"
  irVersion: 65

- version: 3.44.0
  changelogEntry:
    - summary: |
        Add `omit-fern-headers` configuration option. When enabled, Fern platform headers
        (X-Fern-Language, X-Fern-SDK-Name, X-Fern-SDK-Version, User-Agent) are omitted
        from generated SDK requests.
      type: feat
  createdAt: "2026-03-12"
  irVersion: 65

- version: 3.43.0
  changelogEntry:
    - summary: |
        Fix WebSocket client compilation error when a server message type
        produces the same method name as a lifecycle handler. For example,
        a message type `error` generated `onError(Consumer<Error>)` which
        clashed with the lifecycle `onError(Consumer<Exception>)` due to
        Java generics type erasure. Colliding message handler methods are
        now suffixed with `Message` (e.g. `onErrorMessage`).
      type: fix
  createdAt: "2026-03-13"
  irVersion: 65

- version: 3.42.9
  changelogEntry:
    - summary: |
        Update bundled npm tar package from 7.5.10 to 7.5.11.
      type: chore
  createdAt: "2026-03-12"
  irVersion: 65

- version: 3.42.8
  changelogEntry:
    - summary: |
        Add `equals()`, `hashCode()`, and `toString()` methods to
        interface-based discriminated union wrapper classes. Previously,
        the outer wrapper class fell back to `Object.equals()` (reference
        identity), breaking equality for any type that transitively
        contained the union. The methods now delegate to the inner `Value`
        field.
      type: fix
  createdAt: "2026-03-11"
  irVersion: 65

- version: 3.42.7
  changelogEntry:
    - summary: |
        Add concurrency configuration to generated CI workflow with cancel-in-progress: false
        to prevent stacked runs from being cancelled when a newer run starts.
      type: chore
  createdAt: "2026-03-11"
  irVersion: 65

- version: 3.42.6
  changelogEntry:
    - summary: |
        Fix dynamic snippets to include global headers in generated code examples.
        Previously, required global headers (e.g., `X-Organization-ID`) configured via
        `x-fern-global-headers` were missing from dynamic snippet output. Also fixes
        header value lookup to use wire values instead of a non-existent property.
      type: fix
  createdAt: "2026-03-10"
  irVersion: 65

- version: 3.42.5
  changelogEntry:
    - summary: |
        Fix `custom-interceptors` support for OAuth staged builders. When
        `custom-interceptors: true` is enabled, the `_Builder` inner class now
        generates an `interceptors` field, `addInterceptor(Interceptor)` method,
        and forwards interceptors to `_TokenAuth` and `_CredentialsAuth` via
        `token()` and `credentials()` methods. Previously, only the root builder
        received interceptor support, causing OAuth staged builders to lose
        interceptor configuration.
      type: fix
  createdAt: "2026-03-10"
  irVersion: 65
- version: 3.42.4
  changelogEntry:
    - summary: |
        Parallelize endpoint snippet generation in `populateSnippetsCache()`. All
        endpoints are now processed concurrently via `Promise.all` instead of
        sequentially, reducing snippet generation time for large APIs.
      type: chore
  createdAt: "2026-03-07"
  irVersion: 65

- version: 3.42.3
  changelogEntry:
    - summary: |
        Update bundled npm tar package from 7.5.8 to 7.5.10 to fix
        GHSA-qffp-2rhf-9h96 (Hardlink Path Traversal via Drive-Relative
        Linkpath).
      type: chore
  createdAt: "2026-03-06"
  irVersion: 65

- version: 3.42.2
  changelogEntry:
    - summary: |
        Fix `custom-plugins` configuration not being applied when running in
        local/download-files mode (`fern generate --local`). The download-files
        config class was missing the `customPlugins` field, causing the values
        to be silently dropped during deserialization.
      type: fix
  createdAt: "2026-03-05"
  irVersion: 65

- version: 3.42.1
  changelogEntry:
    - summary: |
        Fix compilation error for objects with many properties that exceed the
        JVM 255-parameter-slot limit. Types like CMS-1500 claim forms caused
        `too many parameters` javac errors. The generator now computes precise
        JVM slot counts (`long`/`double` consume two slots, all other types one)
        and, when the threshold is exceeded, generates a constructor that accepts
        the Builder as a single parameter, keeping the public API unchanged.
      type: fix
  createdAt: "2026-03-04"
  irVersion: 65

- version: 3.42.0
  changelogEntry:
    - summary: |
        Add support for custom Gradle plugins via the `custom-plugins` configuration
        option. Users can now specify custom Gradle plugins (with optional versions)
        that will be added to the generated build.gradle file. Format:
        `["plugin-id:version", "plugin-id"]`. Plugins are applied after built-in
        plugins (java-library, maven-publish, spotless).
      type: feat
  createdAt: "2026-03-03"
  irVersion: 65
- version: 3.41.0
  changelogEntry:
    - summary: |
        Add `custom-interceptors` configuration option for the Java SDK generator.
        When enabled (`custom-interceptors: true` in `generators.yml`), the generated
        client builder exposes an `addInterceptor(Interceptor)` method that allows SDK
        users to add custom OkHttp interceptors. Interceptors are applied to the
        OkHttpClient when the client is built. This enables use cases like PKCV (Public
        Key Client Validation), custom request signing, and other HTTP-level
        customizations via custom code protected by `.fernignore`.
      type: feat
  createdAt: "2026-03-03"
  irVersion: 65

- version: 3.40.9
  changelogEntry:
    - summary: |
        Fix wire test generation for form-urlencoded request bodies: objects
        now serialize as Java's `Map.toString()` format (`{key=value}`) instead
        of JSON (`{"key":"value"}`), and ISO 8601 dates with zero seconds drop
        the `:00` to match Java's `OffsetDateTime.toString()` output (e.g.
        `2015-07-30T20:00Z` instead of `2015-07-30T20:00:00Z`).
      type: fix
  createdAt: "2026-03-03"
  irVersion: 65

- version: 3.40.8
  changelogEntry:
    - summary: |
        Fix wire test generation to convert RFC 2822 dates to ISO 8601 in both
        the mock response body (served by MockWebServer) and the expected response
        assertion. Previously, only the expected response was converted, leaving
        RFC 2822 dates in the mock response which caused `DateTimeParseException`
        during Jackson deserialization for fields typed as `dateTime` (not
        `dateTimeRfc2822`). The conversion now happens upfront so a single
        normalized resource file is shared by both mock setup and validation.
      type: fix
  createdAt: "2026-03-03"
  irVersion: 65

- version: 3.40.7
  changelogEntry:
    - summary: |
        Fix wire test generation for URI and path paginated endpoints returning
        wrong type. The published `@fern-fern/ir-sdk` doesn't include `uri`/`path`
        as `Pagination` union members, so the raw IR JSON passes through
        undeserialized with `_type` discriminant fields instead of `type`. The
        generator now normalizes raw IR JSON (`_type` → `type`) before extracting
        the pagination item type, so wire tests correctly use
        `SyncPagingIterable<T>` instead of the raw response type.
      type: fix
  createdAt: "2026-03-03"
  irVersion: 65

- version: 3.40.6
  changelogEntry:
    - summary: |
        Fix wire test generation for form-urlencoded request body encoding.
        The generator now uses `+` for spaces (matching Java's `URLEncoder.encode()`)
        instead of `%20` (from `encodeURIComponent`), serializes arrays as
        `[val1, val2]` (matching Java's `List.toString()`), and serializes objects
        as JSON strings.
      type: fix
    - summary: |
        Fix wire test generation for RFC 2822 date fields. The expected response
        body in wire tests now converts RFC 2822 dates (e.g.
        `Thu, 30 Jul 2015 20:00:00 +0000`) to ISO 8601 with Z suffix (e.g.
        `2015-07-30T20:00:00Z`) to match Jackson's `JavaTimeModule` serialization
        of `OffsetDateTime`. The mock response body retains RFC 2822 dates since
        the SDK's `Rfc2822DateTimeDeserializer` handles them correctly.
      type: fix
  createdAt: "2026-03-03"
  irVersion: 65

- version: 3.40.5
  changelogEntry:
    - summary: |
        Fix wire test generation for URI and path paginated endpoints. The generated
        wire tests incorrectly used the raw response type (e.g. `ListMessagesResponse`)
        instead of the paginated return type (`SyncPagingIterable<T>`) for endpoints
        using URI or path-based pagination, causing compilation failures.
      type: fix
  createdAt: "2026-03-03"
  irVersion: 65

- version: 3.40.4
  changelogEntry:
    - summary: |
        Bump Jackson from 2.18.2 to 2.18.6 to fix GHSA-72hv-8253-57qq
        (Number Length Constraint Bypass in Async Parser leading to potential DoS).
      type: fix
  createdAt: "2026-03-02"
  irVersion: 65

- version: 3.40.3
  changelogEntry:
    - summary: |
        Make OAuth authentication section a stable feature block in generated READMEs.
        Previously, the authentication documentation was injected as an addendum to the
        Usage block with a `## Authentication` heading, which the BlockMerger parsed as
        a separate top-level block on subsequent merges. The authentication content is
        now registered as a proper AUTHENTICATION feature with a stable block ID, making
        README merges deterministic.
      type: fix
  createdAt: "2026-02-27"
  irVersion: 65

- version: 3.40.2
  changelogEntry:
    - summary: |
        Patch minimatch to 10.2.3 in container to fix GHSA-7r86-cg39-jmmj (ReDoS via
        combinatorial backtracking in matchOne()) and GHSA-23c5-xmqv-rm74 (ReDoS via
        nested *() extglobs).
      type: fix
  createdAt: "2026-02-27"
  irVersion: 65

- version: 3.40.1
  changelogEntry:
    - summary: |
        Fix `Rfc2822DateTimeDeserializer` visibility. The class was generated
        with package-private access, causing compilation errors when types in
        other packages referenced it via `@JsonDeserialize(using = ...)`.
        The class is now `public`.
      type: fix
    - summary: |
        Fix URI/path pagination generating `String` instead of `Optional<String>`
        for the next page token. `UriPage.create` and `PathPage.create` expect
        `Optional<String>`, but `getNestedPropertySnippet` was unwrapping the
        optional via `.orElse(null)`. The generator now builds the getter chain
        directly to preserve the `Optional<String>` type.
      type: fix
  createdAt: "2026-02-26"
  irVersion: 65

- version: 3.40.0
  changelogEntry:
    - summary: |
        Add `DATE_TIME_RFC_2822` primitive type support. Fields with
        `format: date-time-rfc-2822` (e.g. Twilio's `dateCreated`, `dateSent`,
        `dateUpdated`) now generate as `OffsetDateTime` with a per-field
        `@JsonDeserialize(using = Rfc2822DateTimeDeserializer.class)` annotation
        that parses RFC 2822 dates via `DateTimeFormatter.RFC_1123_DATE_TIME`.
      type: feat
  createdAt: "2026-02-26"
  irVersion: 65

- version: 3.39.1
  changelogEntry:
    - summary: |
        Use generator-cli JS API directly instead of subprocess spawning.
        Remove generator-cli from Docker image since it is now bundled via esbuild.
      type: chore
  createdAt: "2026-02-26"
  irVersion: 65

- version: 3.39.0
  changelogEntry:
    - summary: |
        Add support for logging to the generated SDK.
        Users can configure logging by passing a `LogConfig` to the client builder's `.logging()` method.

        ```java
        import com.example.api.AcmeApiClient;
        import com.example.api.core.LogConfig;
        import com.example.api.core.LogLevel;
        import com.example.api.core.ConsoleLogger;

        AcmeApiClient client = AcmeApiClient.builder()
            .token("YOUR_TOKEN")
            .logging(LogConfig.builder()
                .level(LogLevel.DEBUG)        // INFO is the default
                .logger(new ConsoleLogger())  // ConsoleLogger is the default
                .silent(false)                // true is the default, set to false to enable logging
                .build())
            .build();
        ```

        The `LogConfig` builder accepts the following properties:
        - `level(LogLevel)`: The log level to use. Defaults to `LogLevel.INFO`.
        - `logger(ILogger)`: The logger implementation to use. Defaults to `ConsoleLogger`.
        - `silent(boolean)`: Whether to silence the logger. Defaults to `true`.

        The `LogLevel` enum supports the following values:
        - `DEBUG`
        - `INFO`
        - `WARN`
        - `ERROR`

        To provide a custom logger, implement the `ILogger` interface
        with `debug`, `info`, `warn`, and `error` methods.

        HTTP request and response details (method, URL, status code, headers, body) are
        logged via a `LoggingInterceptor` added to the OkHttp client. Sensitive headers
        (`authorization`, `x-api-key`, `cookie`, `x-csrf-token`, etc.) are automatically
        redacted in logs.
      type: feat
  createdAt: "2026-02-25"
  irVersion: 65

- version: 3.38.1
  changelogEntry:
    - summary: |
        Preserve existing README.md when the generator does not produce one. Previously,
        `overwriteLocalContents` deleted all files before copying generator output, so if
        README generation failed silently the file was removed from the target repository.
        The method now skips deleting README.md when the source directory does not include it.
      type: fix
  createdAt: "2026-02-23"
  irVersion: 65

- version: 3.38.0
  changelogEntry:
    - summary: |
        Add support for URI and path-based pagination. Endpoints using `uri` or `path`
        pagination now generate correct paging iterables that follow next page links
        from the response body.
      type: feat
  createdAt: "2026-02-12"
  irVersion: 65

- version: 3.37.1
  changelogEntry:
    - summary: |
        Update container packages to fix 8 security vulnerabilities: gnupg2-minimal (CVE-2026-24882),
        curl-minimal and libcurl-minimal (CVE-2025-13034, CVE-2025-14017, CVE-2025-14524, CVE-2025-14819,
        CVE-2025-15079, CVE-2025-15224), alsa-lib (CVE-2026-25068), expat (CVE-2026-25210),
        openssh and openssh-clients (CVE-2025-61984, CVE-2025-61985), and npm tar (GHSA-83g3-92jg-28cx).
      type: fix
  createdAt: "2026-02-20"
  irVersion: 63

- version: 3.37.0
  changelogEntry:
    - summary: |
        Add `additionalProperty(String key, Object value)` and `additionalProperties(Map<String, Object>)`
        methods to generated builders, allowing users to set arbitrary extra fields programmatically.
        Previously, additional properties were only populated during JSON deserialization.
      type: feat
  createdAt: "2026-02-18"
  irVersion: 63

- version: 3.36.3
  changelogEntry:
    - summary: Use correct Long literals (3600L) instead of int literals (3600) for `Optional<Long>` expires_in fields in OAuth token suppliers
      type: fix
  createdAt: "2026-02-17"
  irVersion: 63

- version: 3.36.2
  changelogEntry:
    - summary: |
        Disable OkHttp callTimeout for streaming (SSE) endpoints. The default 60-second
        callTimeout was terminating SSE connections after ~1 minute instead of allowing
        them to stream indefinitely. Streaming endpoints now set callTimeout to 0 (disabled)
        so the iterator blocks on each next() call waiting for new events until the connection
        is closed or an error occurs.
      type: fix
  createdAt: "2026-02-17"
  irVersion: 63

- version: 3.36.1
  changelogEntry:
    - summary: |
        Handle Optional access tokens and Long type compatibility in OAuth token supplier.
        The generator now unwraps `Optional<String>` access tokens with `orElseThrow` and
        uses `Long` literals for the default `expires_in` fallback value.
      type: fix
  createdAt: "2026-02-13"
  irVersion: 63

- version: 3.36.0
  changelogEntry:
    - summary: |
        Add server URL templating support. When an OpenAPI spec uses server variables
        (e.g., `https://api.{region}.{environment}.example.com`), the generated SDK now
        exposes those variables as builder methods (e.g., `.region("us-east-1")`). The
        `x-fern-default-url` extension provides a clean fallback URL when no variables
        are provided. Supports both single and multiple base URL environments.
      type: feat
  createdAt: "2026-02-13"
  irVersion: 63

- version: 3.35.2
  changelogEntry:
    - summary: |
        Fix PATCH requests with no explicit body fields failing at runtime with OkHttp's
        `IllegalArgumentException: method PATCH must have a request body`. The generator now
        provides a non-null empty request body for PATCH endpoints, matching the existing
        handling for POST and PUT.
      type: fix
  createdAt: "2026-02-12"
  irVersion: 63

- version: 3.35.1
  changelogEntry:
    - summary: |
        Preserve valid HTML tags in Javadoc comments instead of escaping them. Tags like
        `<a>`, `<code>`, `<p>`, `<pre>`, and other standard HTML tags from API descriptions
        are now rendered as proper HTML in Javadoc, while standalone angle brackets (e.g.
        comparisons, generics) remain escaped.
      type: fix
  createdAt: "2026-02-12"
  irVersion: 63

- version: 3.35.0
  changelogEntry:
    - summary: |
        Add SSE event-level discrimination support. When an SSE payload is a discriminated union
        with the discriminator at the SSE envelope level (e.g., `event` field), the SDK now
        correctly parses the full SSE envelope instead of just the data payload.
      type: feat
  createdAt: "2026-02-10"
  irVersion: 63

- version: 3.34.9
  changelogEntry:
    - summary: |
        Update container packages to fix 9 security vulnerabilities: openssl-fips-provider-latest
        and openssl-libs (CVE-2025-15467), libtasn1 (CVE-2025-13151), libcap (CVE-2025-61726,
        CVE-2025-61728, CVE-2025-61730, CVE-2025-61731, CVE-2025-68119, CVE-2025-68121),
        python3-pip-wheel (CVE-2026-21441), libxml2 (CVE-2026-0989, CVE-2026-0990, CVE-2026-0992),
        libpng (CVE-2026-22695, CVE-2026-22801), and unzip (CVE-2019-13232).
      type: fix
  createdAt: "2026-02-09"
  irVersion: 63

- version: 3.34.8
  changelogEntry:
    - summary: |
        Switch base image from gradle:jdk11-jammy to gradle:jdk11-corretto to fix January 2026
        Oracle CPU CVEs: CVE-2026-21945, CVE-2026-21932, CVE-2026-21925, CVE-2026-21933.
        Amazon Corretto 11.0.30 includes the security patches while Eclipse Temurin 11.0.30
        Docker images are not yet available.
      type: fix
  createdAt: "2026-02-03"
  irVersion: 63

- version: 3.34.7
  changelogEntry:
    - summary: |
        Add pre-flight check for git availability when using self-hosted GitHub mode. The CLI now
        verifies git is installed before attempting to clone, providing a clear error message if
        git is not found. Also adds improved error logging with diagnostics when git clone fails.
      type: fix
  createdAt: "2026-02-02"
  irVersion: 63

- version: 3.34.6
  changelogEntry:
    - summary: |
        Fix wire test generation importing types from the wrong package when multiple services have
        endpoints with the same HTTP method and path. The generator now uses endpoint IDs to resolve
        the correct endpoint instead of relying solely on method and path matching.
      type: fix
  createdAt: "2026-01-29"
  irVersion: 63

- version: 3.34.5
  changelogEntry:
    - summary: |
        Fix streaming endpoints incorrectly setting `Accept: application/json` header. Streaming
        endpoints (SSE, NDJSON, etc.) now omit the Accept header entirely, allowing the server to
        negotiate the appropriate streaming format.
      type: fix
  createdAt: "2026-01-26"
  irVersion: 63

- version: 3.34.4
  changelogEntry:
    - summary: |
        Fix Java SDK compilation error when a path parameter is named `key`. The lambda variable
        in `requestOptions.getQueryParameters().forEach((key, value) -> {...})` was shadowing
        the path parameter, causing a "variable key is already defined" compilation error.
        Lambda variables are now prefixed with underscore to avoid conflicts.
      type: fix
  createdAt: "2026-01-26"
  irVersion: 63

- version: 3.34.3
  changelogEntry:
    - summary: |
        Fix Java SDK generation failure when an environment name is a Java reserved keyword
        (e.g., "default") for multi-environment APIs.
      type: fix
  createdAt: "2026-01-23"
  irVersion: 63

- version: 3.34.2
  changelogEntry:
    - summary: |
        Change wire tests to use resource files for JSON strings above a certain length
        to prevent undue stress to :spotlessJava and cut down on code duplication.
      type: fix
  createdAt: "2026-01-23"
  irVersion: 63

- version: 3.34.1
  changelogEntry:
    - summary: |
        Fix `output-directory` config option to also apply to test files. When using `source-root` mode,
        test files are now written directly to the output path instead of always using `src/test/java/`.
      type: fix
  createdAt: "2026-01-22"
  irVersion: 63

- version: 3.34.0
  changelogEntry:
    - summary: |
        Add `output-directory` config option to control where Java files are written during local generation.
        - `project-root` (default): Files written to `<path>/src/main/java/` (current behavior)
        - `source-root`: Files written directly to `<path>/` (pre-v3.8.2 behavior for embedding SDKs into existing projects)

        This allows customers embedding SDKs into existing projects to avoid double `src/main/java` paths.
      type: feat
  createdAt: "2026-01-21"
  irVersion: 63

- version: 3.33.2
  changelogEntry:
    - summary: |
        Re-publish to verify Docker Hub and generator registry sync.
      type: chore
  createdAt: "2026-01-21"
  irVersion: 63

- version: 3.33.1
  changelogEntry:
    - summary: |
        Fix compilation error in generated InputStream overloads for file upload endpoints. The
        `requestOptions.getQueryParameters()` code block is now only emitted in methods that have
        `RequestOptions` as a parameter.
      type: fix
  createdAt: "2026-01-21"
  irVersion: 63

- version: 3.33.0
  changelogEntry:
    - summary: |
        Generate body-only method overloads for endpoints with required body and optional headers/query params.
        This prevents breaking changes when optional headers or query params are added to existing endpoints.
      type: feat
  createdAt: "2026-01-20"
  irVersion: 63

- version: 3.32.1
  changelogEntry:
    - summary: |
        Update container to fix CVE-2026-23745 (node-tar path traversal via hardlinks/symlinks) and
        CVE-2025-66293 (libpng out-of-bounds read). Patches npm's bundled tar to 7.5.3 and updates
        libpng16-16 to the latest available version.
      type: fix
  createdAt: "2026-01-20"
  irVersion: 63

- version: 3.32.0
  changelogEntry:
    - summary: |
        Add endpoint-level security support with routing auth providers. APIs can now define different
        authentication requirements per endpoint using the ENDPOINT_SECURITY auth mode. The SDK generates
        individual auth providers (Bearer, Basic, ApiKey, OAuth, InferredAuth) and a RoutingAuthProvider
        that routes requests to the appropriate provider based on each endpoint's security requirements.
        Supports OR (any of) and AND (all of) auth requirement combinations.

        To enable, add `auth: endpoint-security: {}` to your api.yml and define per-endpoint auth in your
        service definitions using the `auth` field on each endpoint.
      type: feat
  createdAt: "2026-01-15"
  irVersion: 63

- version: 3.31.0
  changelogEntry:
    - summary: |
        Add `additionalQueryParameters` support to `RequestOptions`, allowing users to add query parameters
        to API requests at runtime. Query parameters added via RequestOptions override any request-defined
        parameters with the same key. This mirrors the existing `addHeader` pattern.

        Usage example:
        ```java
        client.endpoint(
            Request.builder().build(),
            RequestOptions.builder()
                .addQueryParameter("key", "value")
                .build()
        );
        ```
      type: feat
  createdAt: "2026-01-15"
  irVersion: 63

- version: 3.30.0
  changelogEntry:
    - summary: |
        Add `enable-gradle-profiling` configuration option for profiling Gradle commands during generation.
      type: feat
  createdAt: "2026-01-15"
  irVersion: 63

- version: 3.29.2
  changelogEntry:
    - summary: |
        Add `notify`, `notifyAll`, and `wait` to reserved method names to prevent generated SDK
        methods from conflicting with final methods in Java's Object class. This fixes compilation
        errors when an API has a subpackage named "notify" (e.g., Twilio's Notify API).
      type: fix
  createdAt: "2026-01-15"
  irVersion: 63

- version: 3.29.1
  changelogEntry:
    - summary: |
        Fix `_Builder` class to support all builder methods (url, timeout, environment, maxRetries,
        httpClient, addHeader) so method chaining works in any order. This allows customers upgrading
        from 3.18.x who wrote `builder().url().token()` to continue working without compile errors.
        Configuration values set on `_Builder` are now properly passed through to `_TokenAuth` and
        `_CredentialsAuth` when `token()` or `credentials()` is called.
      type: fix
  createdAt: "2026-01-15"
  irVersion: 63

- version: 3.29.0
  changelogEntry:
    - summary: |
        Add backward-compatible `builder()` method for OAuth client credentials authentication.
        This restores support for the classic builder pattern `Client.builder().token("...")` and
        `Client.builder().credentials("...", "...")` alongside the existing `withToken()` and
        `withCredentials()` shortcuts. This prevents breaking changes for customers who upgraded.
      type: feat
  createdAt: "2026-01-14"
  irVersion: 63

- version: 3.28.2
  changelogEntry:
    - summary: Update Dockerfile to use the latest generator-cli with improve reference.md generation.
      type: chore
  createdAt: "2026-01-13"
  irVersion: 63

- version: 3.28.1
  changelogEntry:
    - summary: |
        Update libtasn1-6 and gnupg packages in container to fix CVE-2021-46848, CVE-2025-13151, CVE-2025-68973.
      type: fix
  createdAt: "2026-01-13"
  irVersion: 63

- version: 3.28.0
  changelogEntry:
    - summary: |
        Upgrade IR version to 63.
      type: chore
  createdAt: "2026-01-12"
  irVersion: 63

- version: 3.27.6
  changelogEntry:
    - summary: |
        Generate overloads without request wrapper when all query parameters are optional.
        This prevents compile breaks when optional query parameters are added to endpoints.
        For example, `getLatestInsurance(String userId)` and `getLatestInsurance(String userId, RequestOptions requestOptions)`
        overloads are now generated in addition to the request wrapper variants.
      type: feat
  createdAt: "2026-01-06"
  irVersion: 61

- version: 3.27.5-rc4
  changelogEntry:
    - summary: |
        Add fallback SDK name generation for X-Fern-SDK-Name header when no explicit maven config is provided.
        This ensures local generation matches remote generation for GitHub output mode.
      type: fix
  createdAt: "2026-01-05"
  irVersion: 61

- version: 3.27.5-rc3
  changelogEntry:
    - summary: Retry Publishing of rc2
      type: fix
  createdAt: "2025-12-24"
  irVersion: 61

- version: 3.27.5-rc2
  changelogEntry:
    - summary: Install fast-content-type-parse dependency required by @octokit/request@10.0.7 CVE patch.
      type: fix
  createdAt: "2025-12-23"
  irVersion: 61

- version: 3.27.5-rc1
  changelogEntry:
    - summary: Add debug logging to generator agent methods to help diagnose issues with README and reference generation.
      type: chore
  createdAt: "2025-12-23"
  irVersion: 61

- version: 3.27.5-rc0
  changelogEntry:
    - summary: Skip installation of generator-cli in Java V2 generator as it is already installed in the base image.
      type: chore
  createdAt: "2025-12-23"
  irVersion: 61

- version: 3.27.4
  changelogEntry:
    - summary: |
        Fix OAuth client credentials flow to include custom headers, timeouts, and retries in token requests by using ClientOptions.Builder.from() pattern.
      type: fix
  createdAt: "2025-12-18"
  irVersion: 61

- version: 3.27.3
  changelogEntry:
    - summary: |
        Fix streaming endpoint return types to use Iterable instead of Optional, fix missing ArrayList import for empty list literals, and fix OAuth wire tests to use withCredentials() pattern.
      type: fix
  createdAt: "2025-12-18"
  irVersion: 61

- version: 3.27.2
  changelogEntry:
    - summary: |
        Support configurable Node.js and Java V2 executable paths via NODE_PATH and JAVA_V2_PATH environment variables for local seed testing.
      type: chore
  createdAt: "2025-12-18"
  irVersion: 61

- version: 3.27.1
  changelogEntry:
    - summary: |
        Add sdkVersion as a top-level field in the generated metadata.json file.
      type: chore
  createdAt: "2025-12-18"
  irVersion: 61

- version: 3.27.0
  changelogEntry:
    - summary: |
        Add `gradle-central-dependency-management` configuration option (boolean, default false).
        When enabled, this skips generating the `repositories` block in `build.gradle` files,
        allowing `dependencyResolutionManagement` in `settings.gradle` with
        `RepositoriesMode.FAIL_ON_PROJECT_REPOS` to work correctly.

        This should be used in conjunction with `gradle-plugin-management` when configuring
        central repository management on enterprise networks.

        Configuration example:
        ```yaml
        config:
          gradle-central-dependency-management: true
          gradle-plugin-management: |
            pluginManagement {
                repositories {
                    maven { url 'https://internal-artifactory.example.com/gradle-plugins/' }
                }
            }
            dependencyResolutionManagement {
                repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
                repositories {
                    maven { url 'https://internal-artifactory.example.com/maven-releases/' }
                }
            }
        ```
      type: feat
  createdAt: "2025-12-17"
  irVersion: 61

- version: 3.26.0
  changelogEntry:
    - summary: |
        Add `gradle-plugin-management` configuration option to inject custom plugin management
        and dependency resolution configuration into `settings.gradle`. This enables SDK generation
        on enterprise networks that cannot access the Gradle Plugin Portal (`plugins.gradle.org`)
        by configuring internal Artifactory/Nexus repositories for plugin resolution.

        Configuration example:
        ```yaml
        config:
          gradle-plugin-management: |
            pluginManagement {
                repositories {
                    maven { url 'https://internal-artifactory.example.com/gradle-plugins/' }
                }
            }
            dependencyResolutionManagement {
                repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
                repositories {
                    maven { url 'https://internal-artifactory.example.com/maven-releases/' }
                }
            }
        ```
      type: feat
    - summary: |
        Fix `gradle-distribution-url` override in Java V2 generator to properly create the
        `gradle/wrapper` directory before writing `gradle-wrapper.properties`.
      type: fix
  createdAt: "2025-12-17"
  irVersion: 61

- version: 3.25.1
  changelogEntry:
    - summary: |
        Fix form-urlencoded request body handling to properly serialize request objects using
        Jackson's convertValue, preserving wire names from @JsonProperty annotations.
      type: fix
  createdAt: "2025-12-17"
  irVersion: 61

- version: 3.25.0
  changelogEntry:
    - summary: |
        Add `gradle-distribution-url` configuration option to allow overriding the Gradle wrapper
        distribution URL. This enables SDK generation on enterprise networks that cannot access
        `services.gradle.org` by pointing to an internal Gradle distribution mirror.

        Configuration example:
        ```yaml
        config:
          gradle-distribution-url: https://internal-mirror.example.com/gradle/gradle-8.14.3-bin.zip
        ```
      type: feat
  createdAt: "2025-12-16"
  irVersion: 61

- version: 3.24.5
  changelogEntry:
    - summary: |
        Fix OAuth token handling for optional expires_in field with default fallback, and skip
        literal properties in OAuth request building.
      type: fix
  createdAt: "2025-12-16"
  irVersion: 61

- version: 3.24.4
  changelogEntry:
    - summary: |
        Mitigate OutOfMemoryError when generating SDKs for large specs. (Specifically, the IR preprocessing
        preprocessing step now modifies the JSON tree in-place and avoids calling `.deepCopy()`.)
      type: fix
  createdAt: "2025-12-16"
  irVersion: 61

- version: 3.24.3
  changelogEntry:
    - summary: |
        Update libpng16-16 in container to fix CVE-2025-64720, CVE-2025-65018, CVE-2025-64505, CVE-2025-64506.
      type: fix
  createdAt: "2025-12-16"
  irVersion: 61

- version: 3.24.2
  changelogEntry:
    - summary: |
        Pass full `ClientOptions` instead of just `httpClient()` to custom pagination `create()` method.
        This gives custom pager implementations access to all client configuration including base URL,
        headers, and other options needed for making subsequent pagination requests.
      type: fix
  createdAt: "2025-12-15"
  irVersion: 61

- version: 3.24.1
  changelogEntry:
    - summary: |
        Fix Jackson deserialization conflict when a property starts with `with` (e.g., `withLabel`) and
        another property matches the suffix (e.g., `label`).
      type: fix
  createdAt: "2025-12-11"
  irVersion: 61

- version: 3.24.0
  changelogEntry:
    - summary: |
        Add support for configuring the default timeout via `default-timeout-in-seconds` in generators.yml.
        Previously, the default timeout was hardcoded to 60 seconds. Now you can customize it:

        Configuration example:
        ```yaml
        config:
          default-timeout-in-seconds: 120
        ```
      type: feat
  createdAt: "2025-12-09"
  irVersion: 61

- version: 3.23.4
  changelogEntry:
    - summary: |
        OAuth token override is now always enabled for APIs with OAuth client credentials authentication.
        The `oauth-token-override` config flag has been removed - SDK users can always choose between
        providing a pre-generated bearer token directly or using the OAuth client credentials flow.

        Generated usage:
        ```java
        // Option 1: Direct bearer token (bypass OAuth flow)
        SeedApiClient client = SeedApiClient.withToken("my-pre-generated-bearer-token")
            .url("https://api.example.com")
            .build();

        // Option 2: OAuth client credentials flow (automatic token management)
        SeedApiClient client = SeedApiClient.withCredentials("your-client-id", "your-client-secret")
            .url("https://api.example.com")
            .build();
        ```
      type: chore
  createdAt: "2025-12-09"
  irVersion: 61

- version: 3.23.3
  changelogEntry:
    - summary: |
        Fix OptionalNullable query parameters to correctly apply .orElse(default) for parameters with
        default values. Previously, only java.util.Optional was recognized for default value handling,
        causing OptionalNullable parameters to be passed directly without unwrapping. Now both Optional
        and OptionalNullable types are handled correctly: parameters with defaults use .orElse(default),
        and parameters without defaults use appropriate presence checks (!isAbsent() for OptionalNullable,
        isPresent() for Optional).
      type: fix
  createdAt: "2025-12-08"
  irVersion: 61

- version: 3.23.2
  changelogEntry:
    - summary: |
        Revert OAuth staged builder compatibility changes.
      type: fix
  createdAt: "2025-12-08"
  irVersion: 61

- version: 3.23.1
  changelogEntry:
    - summary: |
        Fix duplicate case label compilation errors when multiple error types map to the same HTTP
        status code. The generator now deduplicates errors by status code, keeping the first error
        declaration for each code. This prevents Java compilation errors in generated switch statements.
      type: fix
  createdAt: "2025-12-06"
  irVersion: 61

- version: 3.23.0
  changelogEntry:
    - summary: |
        Add OAuth token override support with compile-time safe staged builder pattern. When
        `oauth-token-override: true` is configured, SDK users can choose between the OAuth client
        credentials flow or providing a pre-generated bearer token directly.

        Configuration example:
        ```yaml
        config:
          oauth-token-override: true
        ```

        Generated usage:
        ```java
        // Option 1: Direct bearer token (bypass OAuth flow)
        SeedApiClient client = SeedApiClient.withToken("my-pre-generated-bearer-token")
            .url("https://api.example.com")
            .build();

        // Option 2: OAuth client credentials flow (automatic token management)
        SeedApiClient client = SeedApiClient.withCredentials("your-client-id", "your-client-secret")
            .url("https://api.example.com")
            .build();
        ```
      type: feat
  createdAt: "2025-12-05"
  irVersion: 61

- version: 3.22.0
  changelogEntry:
    - summary: |
        Add support for inferred authentication schemes. Inferred auth allows SDKs to automatically
        fetch tokens from custom (non-OAuth) token endpoints using `scheme: bearer` with `get-token`
        configuration. The generated `InferredAuthTokenSupplier` class handles token caching and
        automatic refresh with a 2-minute buffer before expiry.

        Configuration example:
        ```yaml
        auth:
          scheme: bearer
          get-token:
            endpoint: POST auth.retrieveToken
        ```

        Generated usage:
        ```java
        SeedApiClient client = SeedApiClient.builder()
            .apiKey("your-api-key")
            .build();
        // Token is automatically fetched and refreshed as needed
        ```
      type: feat
  createdAt: "2025-12-05"
  irVersion: 61

- version: 3.21.1
  changelogEntry:
    - summary: |
        Fix header parameters with `x-fern-parameter-name` to use the correct HTTP header name (wire value) instead of the SDK parameter name.
      type: fix
  createdAt: "2025-12-04"
  irVersion: 61

- version: 3.21.0
  changelogEntry:
    - summary: |
        Remove unused kotlin-stdlib from Gradle base image to address CVE-2020-29582 in container.
      type: fix
  createdAt: "2025-12-04"
  irVersion: 61

- version: 3.20.2
  changelogEntry:
    - summary: |
        Improve generator logging by removing verbose "java v2 generator" status messages and adding per-file logging. Each generated file is now logged individually, matching the C# generator pattern.
      type: fix
  createdAt: "2025-12-02"
  irVersion: 61

- version: 3.20.1
  changelogEntry:
    - summary: |
        Fix StreamTest generator to use Java 8 compatible constructs. Replaced List.of() and Map.of() (Java 9+) with Arrays.asList() and a createMap() helper method using HashMap.
      type: fix
  createdAt: "2025-11-27"
  irVersion: 61

- version: 3.20.0
  changelogEntry:
    - summary: |
        Update vulnerable dependencies.
      type: fix
  createdAt: "2025-11-26"
  irVersion: 61

- version: 3.19.0
  changelogEntry:
    - summary: |
        Add wire test support for OAuth APIs and multi-URL environments. Wire tests now:
        - Properly mock OAuth token endpoints with per-test token enqueuing
        - Use `.clientId()/.clientSecret()` for OAuth-authenticated APIs
        - Support custom OAuth headers (e.g., `apiKey`) required by token endpoints
        - Configure `Environment.custom()` builder for multi-URL environment APIs
        - Handle flexible JSON comparison allowing extra default fields in responses
      type: feat
  createdAt: "2025-11-25"
  irVersion: 61

- version: 3.18.13
  changelogEntry:
    - summary: |
        Skip wire test generation for OAuth and multi-URL environment APIs temporarily.
      type: fix
  createdAt: "2025-11-25"
  irVersion: 61

- version: 3.18.12
  changelogEntry:
    - summary: |
        Fix Java dynamic snippets for query parameters with `allow-multiple: true` and optional types. Snippets now generate `List<T>` instead of `List<Optional<T>>`, which matches the SDK builder's convenience overload.
      type: fix
  createdAt: "2025-11-25"
  irVersion: 61

- version: 3.18.11
  changelogEntry:
    - summary: |
        Fix dynamic snippets to preserve schema parameter order for staged builders.
      type: fix
  createdAt: "2025-11-25"
  irVersion: 61

- version: 3.18.10
  changelogEntry:
    - summary: |
        Fix Java dynamic snippets when use-local-date-for-dates is enabled. Snippets for date fields now generate LocalDate.parse(...) instead of string literals, matching SDKs configured to use LocalDate for dates. This fixes compilation errors in generated dynamic snippets for Java v2 when the use-local-date-for-dates flag is true.
      type: fix
  createdAt: "2025-11-24"
  irVersion: 61

- version: 3.18.9
  changelogEntry:
    - summary: |
        Fix wire test generation to use OptionalNullable when collapse-optional-nullable is enabled. Wire tests now correctly generate OptionalNullable.absent() and OptionalNullable.of() instead of Optional.empty() and Optional.of() for optional request bodies and method arguments when collapse-optional-nullable: true is configured. This includes support for nested optional/nullable types which collapse into a single `OptionalNullable<T>`.
      type: fix
  createdAt: "2025-11-24"
  irVersion: 61

- version: 3.18.8
  changelogEntry:
    - summary: |
        Skip InputStream overload generation for file upload endpoints with inline path parameters. This prevents compilation errors where InputStream methods would reference non-existent request parameters when path parameters are inlined.
      type: fix
  createdAt: "2025-11-23"
  irVersion: 61

- version: 3.18.7
  changelogEntry:
    - summary: |
        Skip InputStream overload generation for file upload endpoints with query parameters. This prevents compilation errors where InputStream methods would reference non-existent request parameters when accessing query parameters.
      type: fix
  createdAt: "2025-11-22"
  irVersion: 61

- version: 3.18.6
  changelogEntry:
    - summary: |
        Fix compilation errors in raw clients when inlinePathParameters is enabled. Raw client methods now correctly use path parameters directly instead of attempting to access non-existent request objects.
      type: fix
  createdAt: "2025-11-22"
  irVersion: 61

- version: 3.18.5
  changelogEntry:
    - summary: |
        Remove using generator-cli to push to GitHub for self-hosted SDKs; this is now handled in the local workspace runner.
      type: fix
  createdAt: "2025-11-21"
  irVersion: 61

- version: 3.18.4
  changelogEntry:
    - summary: |
        Fix missing @JsonInclude header on certain instances of `OptionalNullable<>`.
      type: fix
  createdAt: "2025-11-20"
  irVersion: 61

- version: 3.18.3
  changelogEntry:
    - summary: |
        Fix OptionalNullable compilation errors when collapse-optional-nullable is enabled. Corrected type witness syntax to generate `OptionalNullable.<Type>absent()` and prevented double-wrapping of OptionalNullable types.
      type: fix
  createdAt: "2025-11-20"
  irVersion: 61

- version: 3.18.2
  changelogEntry:
    - summary: |
        Fix bugs in 3.17.0's addition of InputStream-based method overloads.
      type: fix
  createdAt: "2025-11-20"
  irVersion: 61

- version: 3.18.1
  changelogEntry:
    - summary: |
        Fix bytes response support and snippet generation. Bytes responses now return `byte[]` instead of throwing exceptions. Empty bytes request bodies in snippets now generate valid default arguments.
      type: fix
  createdAt: "2025-11-20"
  irVersion: 61

- version: 3.18.0
  changelogEntry:
    - summary: |
        Add support for custom bidirectional pagination. APIs using custom pagination (e.g., HATEOAS links) can configure a custom pager name and receive skeleton classes with bidirectional navigation methods (`nextPage()`, `previousPage()`, `hasNext()`, `hasPrevious()`).

        Configuration:
        ```yaml
        customConfig:
          custom-pager-name: MyCustomPaginator
        ```
      type: feat
  createdAt: "2025-11-19"
  irVersion: 61

- version: 3.17.1
  changelogEntry:
    - summary: |
        Bump generator CLI version to publish new Docker image.
      type: chore
  createdAt: "2025-11-19"
  irVersion: 61

- version: 3.17.0
  changelogEntry:
    - summary: |
        Add InputStream-based method overloads for file upload endpoints. For each single-file upload endpoint, the generator now creates 4 additional overloads that accept InputStream + filename instead of File objects:
        - method(InputStream stream, String filename)
        - method(InputStream stream, String filename, MediaType mediaType)
        - method(InputStream stream, String filename, RequestOptions requestOptions)
        - method(InputStream stream, String filename, MediaType mediaType, RequestOptions requestOptions)

        This enables streaming file uploads without requiring files to be written to disk first. The implementation uses the existing FileStream wrapper class and InputStreamRequestBody for OkHttp integration. Note: Okio automatically closes the stream after upload, but users should still use try-with-resources for proper resource management.
      type: feat
  createdAt: "2025-11-18"
  irVersion: 61

- version: 3.16.1
  changelogEntry:
    - summary: |
        Fix OAuth client credentials token supplier to support custom properties and headers. OAuth token endpoints can now include custom headers (e.g., x-api-key) and custom body properties (e.g., entity_id) in addition to standard OAuth fields (client_id, client_secret, scopes). This enables authentication with non-standard OAuth implementations that require additional parameters.
      type: fix
  createdAt: "2025-11-18"
  irVersion: 61

- version: 3.16.0
  changelogEntry:
    - summary: |
        Add opt-in use-local-date-for-dates config flag to generate java.time.LocalDate instead of String for Fern date types.
      type: feat
  createdAt: "2025-11-14"
  irVersion: 61

- version: 3.15.1
  changelogEntry:
    - summary: |
        Fix SDK generation failures for endpoints with custom pagination. Endpoints using `x-fern-pagination: type: custom` now generate successfully, returning the raw response type without automatic pagination wrappers.
      type: fix
  createdAt: "2025-11-14"
  irVersion: 61

- version: 3.15.0
  changelogEntry:
    - summary: |
        Upgrade dependencies:
        okhttp 4.12.0 -> 5.2.1,
        jackson 2.17.2 -> 2.18.2,
        [internal use only] mockito 3.11.2 -> 4.11.0.
      type: feat
  createdAt: "2025-11-13"
  irVersion: 61

- version: 3.14.14
  changelogEntry:
    - summary: |
        Fix streaming method names and request types in wire tests. Wire tests now correctly normalize streaming endpoints to use `.methodStream()` naming pattern and `MethodStreamRequest` types, while non-streaming endpoints use `.method()` and `MethodRequest`. This eliminates "incompatible types" compilation errors where streaming method calls were paired with non-streaming response types.
      type: fix
  createdAt: "2025-11-13"
  irVersion: 61

- version: 3.14.13
  changelogEntry:
    - summary: |
        Revert unchecked operations warning fix in StreamTest generator due to type inference compilation errors. The previous fix (3.14.0) caused "incompatible types: inference variable T has incompatible equality constraints `Map<String,?>`,`Map`" errors when compiling generated StreamTest.java files. Restores the original implementation using raw types.
      type: fix
  createdAt: "2025-11-13"
  irVersion: 61

- version: 3.14.12
  changelogEntry:
    - summary: |
        Fix dynamic snippets compilation errors for literal-typed parameters. Literal-typed parameters (e.g., prompt with literal string value, stream with literal false) are now correctly filtered from builder method calls in generated snippets, as these fields only have hardcoded getters without corresponding setters. This maintains parity with Java v1 behavior where literal fields are excluded from all class builders (both model and request classes).
      type: fix
  createdAt: "2025-11-13"
  irVersion: 61

- version: 3.14.11
  changelogEntry:
    - summary: |
        Fix jsonEquals helper method not being generated in wire tests. The generator now correctly calls closeTestClass() to emit the jsonEquals helper method that enables numeric equivalence comparison in wire test assertions.
      type: fix
  createdAt: "2025-11-13"
  irVersion: 61

- version: 3.14.10
  changelogEntry:
    - summary: |
        Fix wire test failures for numeric type mismatches and header serialization. Wire tests now use numeric equivalence comparison to handle integer vs double type differences from OpenAPI specs. Headers are no longer incorrectly serialized into JSON request bodies - they now use @JsonIgnore and are sent only as HTTP headers.
      type: fix
  createdAt: "2025-11-12"
  irVersion: 61

- version: 3.14.9
  changelogEntry:
    - summary: Fix wire test compilation errors when using staged builders with collections. Builder method calls now correctly order required fields before collections like Lists, Sets, and Maps.
      type: fix
  createdAt: "2025-11-12"
  irVersion: 61

- version: 3.14.8
  changelogEntry:
    - summary: |
        Fix critical wire test generation failures causing build crashes. Implemented service name resolution to handle IR vs Dynamic IR mismatches and added graceful error handling instead of build failures.
      type: fix
  createdAt: "2025-11-12"
  irVersion: 61

- version: 3.14.7
  changelogEntry:
    - summary: Fix inconsistent behavior between local and remote Java generation by ensuring license files are copied and platform headers are populated in all generation scenarios
      type: fix
  createdAt: "2025-11-11"
  irVersion: 61

- version: 3.14.6
  changelogEntry:
    - summary: |
        Upgrade Gradle wrapper from 7.4.2 to 8.14.3. This update brings Java 24 support, GraalVM Native Image toolchain selection, enhanced test reporting, and build authoring improvements. The bundled Gradle wrapper files now use the latest stable Gradle 8.x release.
      type: chore
  createdAt: "2025-11-11"
  irVersion: 61

- version: 3.14.5
  changelogEntry:
    - summary: |
        Fix SDK generation failures for OpenAPI specs with nullable container types. The generator now properly handles nullable containers in response parsing and pagination, treating them distinctly from optional containers. Also adds support for literal container detection with improved error diagnostics.
        This fixes "Unexpected container type" errors that occurred when processing APIs with nullable types or array examples in query parameters.
      type: fix
  createdAt: "2025-11-11"
  irVersion: 61

- version: 3.14.4
  changelogEntry:
    - summary: |
        Replace gradle wrapper command with resource copy to eliminate internet requests during SDK generation. Gradle wrapper files are now copied from bundled resources instead of being downloaded via `gradle wrapper` command. All `./gradlew` invocations during generation have been removed to avoid network calls and HTTP proxy issues.
      type: fix
  createdAt: "2025-11-11"
  irVersion: 61

- version: 3.14.3
  changelogEntry:
    - summary: |
        Skip empty object validation in wire tests for optional request bodies. When request bodies are optional(nullable(T)) where T has only optional properties, wire tests now correctly skip `{}` validation when Optional.empty() is passed, matching actual SDK behavior.
      type: fix
  createdAt: "2025-11-11"
  irVersion: 61

- version: 3.14.2
  changelogEntry:
    - summary: |
        Fix double-wrapping of Optional.empty() in request bodies. Wire tests and dynamic snippets now correctly generate Optional.empty() instead of Optional.of(Optional.empty()) for optional request bodies.
      type: fix
  createdAt: "2025-11-07"
  irVersion: 61

- version: 3.14.1
  changelogEntry:
    - summary: |
        Fix wire test failures by pruning union base properties from expected JSON. The Java generator does not generate base properties for union types, so wire test expectations now exclude these fields to match actual SDK serialization behavior.
      type: fix
  createdAt: "2025-11-07"
  irVersion: 61

- version: 3.14.0
  changelogEntry:
    - summary: |
        Add support for WebSocket channels with bidirectional communication. Generated WebSocket clients
        provide automatic reconnection with exponential backoff, strongly-typed message handlers, and message
        queuing during disconnections. Clients are accessible via factory methods in subpackage clients.

        ```java
        // Create WebSocket client with path and query parameters
        RealtimeWebSocketClient ws = client.realtime().realtimeWebSocket(
            "session-123",
            Optional.of("gpt-4"),
            Optional.of(0)
        );

        // Register handlers and connect
        ws.onReceive(message -> System.out.println("Received: " + message.getAlpha()));
        ws.onConnected(() -> System.out.println("Connected!"));
        ws.connect().get();

        // Send typed messages
        ws.sendSend(SendEvent.builder()
            .sendText("Hello WebSocket!")
            .sendParam(42)
            .build());
        ```
      type: feat
  createdAt: "2025-11-07"
  irVersion: 61

- version: 3.13.0
  changelogEntry:
    - summary: |
        Added Generation Metadata file to output.
      type: feat
  createdAt: "2025-11-05"
  irVersion: 61

- version: 3.12.1
  changelogEntry:
    - summary: |
        Fix query and header parameters leaking into request body JSON. Only body parameters are now serialized in the request payload.
      type: fix
  createdAt: "2025-11-05"
  irVersion: 61

- version: 3.12.0
  changelogEntry:
    - summary: |
        Add support for API-level path parameters. Path parameters defined at the API level (e.g., `/test/{pathParam}`) are now configurable via the root client builder (`.pathParam(value)`).
      type: feat
  createdAt: "2025-11-04"
  irVersion: 61

- version: 3.11.7
  changelogEntry:
    - summary: |
        Fix ApiError toString() to display JSON-serialized body instead of hashcode (e.g., `{"title": "Bad Request", ...}` instead of `BadRequestProblems@4ac5ea99`).
      type: fix
  createdAt: "2025-11-04"
  irVersion: 61

- version: 3.11.6
  changelogEntry:
    - summary: |
        Fix path parameter prefixes (e.g., `v{version}`) being split into separate segments, producing URLs like .../v/1 instead of .../v1.
      type: fix
  createdAt: "2025-11-04"
  irVersion: 61

- version: 3.11.5
  changelogEntry:
    - summary: |
        Extract error body parsing to ObjectMappers.parseErrorBody() utility method. When servers return XML/HTML errors instead of JSON, the utility gracefully falls back to raw string instead of throwing JsonProcessingException, preserving HTTP status codes and error details.
      type: fix
  createdAt: "2025-11-04"
  irVersion: 61

- version: 3.11.4
  changelogEntry:
    - summary: |
        The `NullableNonemptyFilter` now correctly handles `OptionalNullable.isAbsent()` to exclude absent fields from JSON serialization in PATCH requests.
      type: fix
  createdAt: "2025-11-04"
  irVersion: 61

- version: 3.11.3
  changelogEntry:
    - summary: |
        Fix `collapse-optional-nullable` config not being applied in download files mode.
      type: fix
  createdAt: "2025-11-03"
  irVersion: 61

- version: 3.11.2
  changelogEntry:
    - summary: |
        Fix IllegalStateException: closed on error responses. Generated clients were calling responseBody.string() twice (once in success handler, once in error handler), but OkHttp's ResponseBody can only be read once. Now pre-reads response body before success check for JSON/text responses.
      type: fix
  createdAt: "2025-11-03"
  irVersion: 61

- version: 3.11.1
  changelogEntry:
    - summary: |
        Disable wire tests by default for Java SDKs while issues are being resolved.
      type: fix
  createdAt: "2025-11-03"
  irVersion: 61

- version: 3.11.0
  changelogEntry:
    - summary: |
        Add support for three-state nullable fields in PATCH requests via `collapse-optional-nullable` config.
        When enabled, optional nullable fields use `OptionalNullable<T>` to distinguish between omitted fields,
        explicit null values, and actual values. This enables proper PATCH request semantics for APIs that need
        to differentiate between "not specified" and "set to null".

        ```yaml
        customConfig:
          collapse-optional-nullable: true
        ```

        Generated usage:
        ```java
        UpdateRequest.builder()
            .fieldName(OptionalNullable.absent())    // Omit field
            .anotherField(OptionalNullable.ofNull()) // Clear field
            .valueField(OptionalNullable.of("value")) // Set value
            .build();
        ```
      type: feat
  createdAt: "2025-10-31"
  irVersion: 61

- version: 3.10.5
  changelogEntry:
    - summary: |
        Revert support for three-state nullable fields in PATCH requests introduced in 3.10.0 (PR #10104).
        Restores `Optional<T>` semantics and removes the `use-nullable-for-optional-fields` config and related `Nullable<T>` handling.
      type: fix
  createdAt: "2025-10-30"
  irVersion: 61

- version: 3.10.4
  changelogEntry:
    - summary: |
        Fix compilation errors when using boolean or long query parameters.
      type: fix
  createdAt: "2025-10-29"
  irVersion: 61

- version: 3.10.3
  changelogEntry:
    - summary: |
        Use Gradle wrapper for Spotless formatting instead of requiring gradle in PATH.
      type: fix
  createdAt: "2025-10-29"
  irVersion: 61

- version: 3.10.2
  changelogEntry:
    - summary: |
        Fix sync client delegation causing array query parameter compilation errors. Generator was using
        incorrect class names, breaking delegation and causing inline HTTP generation.
      type: fix
  createdAt: "2025-10-28"
  irVersion: 61

- version: 3.10.1
  changelogEntry:
    - summary: |
        Fixed nullable annotation generation in builder setters when `use-nullable-annotation` is enabled.
        Builder setter parameters for nullable fields now correctly use `@org.jetbrains.annotations.Nullable`
        instead of incorrectly attempting to use the `Nullable<T>` container class as an annotation.
        Also removed `@Nullable` from path parameters as they are always required in REST APIs.
      type: fix
  createdAt: "2025-10-28"
  irVersion: 61

- version: 3.10.0
  changelogEntry:
    - summary: |
        Add support for three-state nullable fields in PATCH requests via `use-nullable-for-optional-fields` config.
        When enabled, optional fields use `Nullable<T>` instead of `Optional<T>` to distinguish between
        omitted fields, explicit null values, and actual values.
      type: feat
  createdAt: "2025-10-28"
  irVersion: 61

- version: 3.9.4
  changelogEntry:
    - summary: |
        Documenting `.withRawResponse()` in `README.md`.
      type: chore
  createdAt: "2025-10-28"
  irVersion: 61

- version: 3.9.3
  changelogEntry:
    - summary: |
        Retries now check `Retry-After` and `X-RateLimit-Reset` before defaulting to exponential backoff.
      type: fix
  createdAt: "2025-10-27"
  irVersion: 61

- version: 3.9.2
  changelogEntry:
    - summary: |
        Fix nullable field serialization in PATCH requests with wrapped request bodies. Explicit null values
        (Nullable.ofNull()) are now correctly serialized as `{"field": null}` instead of being omitted like
        Nullable.empty().
      type: fix
  createdAt: "2025-10-23"
  irVersion: 61

- version: 3.9.1
  changelogEntry:
    - summary: |
        Fix raw client methods to return union types instead of first variant when using response
        properties (x-fern-sdk-return-value) with discriminated or undiscriminated unions.
      type: fix
  createdAt: "2025-10-23"
  irVersion: 61

- version: 3.9.0
  changelogEntry:
    - summary: |
        Add support for README example style configuration via `exampleStyle` field. When set to "minimal",
        generated README.md files show streamlined code examples with only required parameters, reducing
        verbosity for better readability. Defaults to "comprehensive" to maintain backward compatibility.
      type: feat
  createdAt: "2025-10-21"
  irVersion: 61

- version: 3.8.12
  changelogEntry:
    - summary: |
        Fixed wire test generation for application/x-www-form-urlencoded requests. Wire tests now correctly
        validate form-encoded request bodies instead of attempting to parse them as JSON, eliminating
        JsonParseException failures in generated test suites.
      type: fix
  createdAt: "2025-10-20"
  irVersion: 60

- version: 3.8.11
  changelogEntry:
    - summary: |
        Fix Java SDK generator to preserve original environment names for multi-URL environments (e.g., "E2E" instead of "E_2_E").
        Single-URL environments remain unchanged for backward compatibility.
      type: fix
  createdAt: "2025-10-16"
  irVersion: 60

- version: 3.8.10
  changelogEntry:
    - summary: |
        Fixed inconsistent file placement for resource-based core files. All Java files now use standard
        src/main/java/ structure in local generation mode.
      type: fix
  createdAt: "2025-10-09"
  irVersion: 60

- version: 3.8.9
  changelogEntry:
    - summary: |
        Fixed dynamic snippets incorrectly placing HTTP headers in request builders. Headers now correctly
        use RequestOptions.builder().addHeader() for body requests.
      type: fix
  createdAt: "2025-10-08"
  irVersion: 60

- version: 3.8.8
  changelogEntry:
    - summary: |
        Fix: Don't run spotlessApply if gradlew doesn't exist.
      type: fix
  createdAt: "2025-10-05"
  irVersion: 60

- version: 3.8.7
  changelogEntry:
    - summary: |
        Fixed spotlessCheck in generated SDKs.
      type: fix
  createdAt: "2025-10-04"
  irVersion: 60

- version: 3.8.6
  changelogEntry:
    - summary: |
        Fixed SSE stream terminator parsing for OpenAI-style `data: [DONE]` format. Terminators are now
        checked after data extraction and only at event boundaries to prevent data loss.
      type: fix
  createdAt: "2025-10-02"
  irVersion: 60

- version: 3.8.5
  changelogEntry:
    - summary: |
        Fix SSE parser concatenating multiple events into malformed JSON. Events are now properly
        separated at blank line boundaries per SSE specification, with correct handling of multiline
        data fields and stream terminators.
      type: fix
  createdAt: "2025-10-02"
  irVersion: 60

- version: 3.8.4
  changelogEntry:
    - summary: |
        Fixed code generation for undiscriminated unions with optional types. Generated code now correctly
        wraps optional values with `Optional.of()`, and wire tests are properly generated by default.
      type: fix
  createdAt: "2025-09-30"
  irVersion: 60

- version: 3.8.3
  changelogEntry:
    - summary: |
        Upgrade generator-cli dependency to fix local generation handling of .fernignore files.
      type: fix
  createdAt: "2025-10-01"
  irVersion: 60

- version: 3.8.2
  changelogEntry:
    - summary: |
        Fix local file system generation to use proper Gradle directory structure (src/main/java).
        Source files are now correctly placed at src/main/java/com/package instead of com/package
        at the root.
      type: fix
  createdAt: "2025-10-01"
  irVersion: 60

- version: 3.8.1
  changelogEntry:
    - summary: |
        Append decimal to whole number double literals to prevent compilation errors.
      type: fix
  createdAt: "2025-09-30"
  irVersion: 60

- version: 3.8.0
  changelogEntry:
    - summary: |
        Add `getResponse()` method to `BasePage` for accessing pagination metadata like cursor tokens.
        This enables stateless pagination by providing access to the full API response object.

        Usage example:
        ```java
        SyncPagingIterable<User> users = client.users().list();
        users.getResponse().ifPresent(response -> {
            String cursor = response.getNext();
            // Use cursor for stateless pagination
        });
        ```
      type: feat
  createdAt: "2025-09-29"
  irVersion: 60

- version: 3.7.0
  changelogEntry:
    - summary: |
        Wire tests are now enabled by default for all Java SDKs, providing comprehensive HTTP protocol
        validation tests using MockWebServer. Wire tests validate request/response serialization, HTTP
        methods, headers, and API contract adherence. To disable wire tests, explicitly set
        `enable-wire-tests: false` in your generator configuration.
      type: feat
  createdAt: "2025-09-29"
  irVersion: 60

- version: 3.6.3
  changelogEntry:
    - summary: |
        Fixed OAuth auth clients not receiving variables needed for token endpoints with path parameters.
      type: fix
  createdAt: "2025-09-28"
  irVersion: 60

- version: 3.6.2
  changelogEntry:
    - summary: |
        Fixed SDK variable setters incorrectly referencing non-existent `clientOptionsBuilder`.
        Variables now store in instance fields and apply via `setVariables()` method.
      type: fix
  createdAt: "2025-09-25"
  irVersion: 60

- version: 3.6.1
  changelogEntry:
    - summary: |
        Fixed wire tests failing with `InvalidDefinitionException` for `Optional<T>` serialization by using
        the configured `ObjectMappers.JSON_MAPPER` instead of plain `ObjectMapper`.
      type: fix
  createdAt: "2025-09-25"
  irVersion: 60

- version: 3.6.0
  changelogEntry:
    - summary: |
        Add support for PR mode for self-hosted/local sdk generation.
      type: feat
  createdAt: "2025-09-25"
  irVersion: 60

- version: 3.5.10
  changelogEntry:
    - summary: |
        Snippets now show client-level variables in builder instead of method parameters.
      type: fix
  createdAt: "2025-09-25"
  irVersion: 60

- version: 3.5.9
  changelogEntry:
    - summary: |
        Fixed missing `java.util.Optional` import in dynamic snippets generation for wire tests.
      type: fix
  createdAt: "2025-09-24"
  irVersion: 59

- version: 3.5.8
  changelogEntry:
    - summary: |
        Fixed wire test generation for union services and added automatic pagination package detection.
      type: fix
  createdAt: "2025-09-23"
  irVersion: 59

- version: 3.5.7
  changelogEntry:
    - summary: |
        Fixed `NullPointerException` in builder setters when collections are null by adding null checks before `addAll()`/`putAll()` calls.
      type: fix
  createdAt: "2025-09-22"
  irVersion: 59

- version: 3.5.6
  changelogEntry:
    - summary: |
        Fixed wire test generation: paginated endpoints return `SyncPagingIterable<T>`, auth methods use correct builder patterns
      type: fix
  createdAt: "2025-09-22"
  irVersion: 59

- version: 3.5.5
  changelogEntry:
    - summary: |
        Fixed wire test compilation errors: pagination types now use raw responses, union factory methods use
        correct variant names, and empty optionals generate `Optional.empty()` instead of invalid `Optional.of()` calls
      type: fix
  createdAt: "2025-09-20"
  irVersion: 59

- version: 3.5.4
  changelogEntry:
    - summary: |
        Fixed wire test compilation errors by adding missing imports for request/response types and
        correcting primitive type mapping.
      type: fix
  createdAt: "2025-09-18"
  irVersion: 59

- version: 3.5.3
  changelogEntry:
    - summary: |
        Fixes an issue where the generated usage snippets in the README.md was not prioritizing
        user defined example values over autogenerated example values.
      type: fix
  createdAt: "2025-09-17"
  irVersion: 59

- version: 3.5.2
  changelogEntry:
    - summary: |
        customReadmeSections from the generator invocation config are included in the README.md
      type: fix
  createdAt: "2025-09-17"
  irVersion: 59

- version: 3.5.1
  changelogEntry:
    - summary: |
        Refactored wire test generator to modular architecture for improved maintainability.
        Enhanced JSON formatting in tests with proper multi-line string concatenation for better readability.
      type: chore
  createdAt: "2025-09-17"
  irVersion: 59

- version: 3.5.0
  changelogEntry:
    - summary: |
        Enhanced wire testing framework with comprehensive SDK validation capabilities. Wire tests now include
        header validation from IR examples, multi-URL environment configuration support, complex type validation
        for unions/nullable/generic types, and full pagination testing with `Iterable<T>` support.
      type: feat
  createdAt: "2025-09-16"
  irVersion: 59

- version: 3.4.1
  changelogEntry:
    - summary: |
        Fix compilation errors when undiscriminated unions contain multiple members that resolve
        to the same Java type (e.g., multiple strings, string vs string enum). The generator now
        correctly disambiguates duplicate method signatures by adding numeric suffixes (of2, of3,
        visit2, visit3) to factory and visitor methods when needed.
      type: fix
  createdAt: "2025-09-16"
  irVersion: 59

- version: 3.4.0
  changelogEntry:
    - summary: |
        Add support for custom sections in the README.md via `customSections` config option.
      type: feat
  createdAt: "2025-09-15"
  irVersion: 59

- version: 3.3.0
  changelogEntry:
    - summary: |
        Wire tests now automatically configure authentication based on the API's auth scheme (Bearer, Basic, Header/Custom,
        OAuth, or Inferred) instead of using hardcoded tokens. Real authentication values are extracted from IR examples
        when available, making tests more accurate and maintainable.
      type: feat
  createdAt: "2025-09-15"
  irVersion: 59

- version: 3.2.2
  changelogEntry:
    - summary: |
        Fix nullable request bodies with Optional fields to correctly generate .isPresent() checks
        on the Optional field itself, rather than on the entire request object.
      type: fix
  createdAt: "2025-09-15"
  irVersion: 59

- version: 3.2.1
  changelogEntry:
    - summary: |
        Changed Optional.of() to Optional.ofNullable() to handle null values gracefully, allowing users to reset to default version.
      type: fix
  createdAt: "2025-09-15"
  irVersion: 59

- version: 3.2.0
  changelogEntry:
    - summary: |
        Add comprehensive request and response body validation to wire tests for Java SDKs.
        Wire tests now validate that SDKs correctly serialize request bodies and deserialize
        response bodies, catching regressions in JSON handling.
      type: feat
  createdAt: "2025-09-11"
  irVersion: 59

- version: 3.1.0
  changelogEntry:
    - summary: |
        Support Maven publishTarget from IR for local filesystem SDK generation.
      type: feat
  createdAt: "2025-09-11"
  irVersion: 59

- version: 3.0.1
  changelogEntry:
    - summary: |
        Fix compilation errors in generated SDK snippets for collections with optional types and unknown size arrays.
        Generated documentation (README.md and reference.md) now shows cleaner, more idiomatic Java code examples
        using `Arrays.asList()` directly instead of unnecessary `ArrayList` wrapping.
      type: fix
  createdAt: "2025-09-10"
  irVersion: 59

- version: 3.0.0
  changelogEntry:
    - summary: |
        The SDK generator now defaults to forward-compatible enums, providing resilience against new enum variants
        added on the backend. This is a breaking change that affects the structure of generated enum types.

        To revert to the previous behavior with traditional Java enums, add the following configuration to your
        `generators.yml` file:
        ```yaml
        generators:
          - name: fernapi/fern-java-sdk
            config:
              enable-forward-compatible-enums: false
        ```
      type: break
    - summary: |
        Forward-compatible enums are now enabled by default. Generated SDKs will no longer throw errors when
        encountering unknown enum variants, instead handling them gracefully with an UNKNOWN value. This is
        particularly important for:
        - Mobile applications that cannot be easily updated
        - Maintaining backward compatibility when backend adds new enum values
        - Arrays of enum values where new variants previously caused client failures

        With forward-compatible enums, the generated code changes from traditional Java enums to class-based
        enums that support unknown values through a visitor pattern.
      type: feat
  createdAt: "2025-09-09"
  irVersion: 59

- version: 2.43.3
  changelogEntry:
    - summary: |
        Bugfix to make sure that the Java SDK compiles when header based versioning with defaults is enabled.
      type: fix
  createdAt: "2025-09-03"
  irVersion: 59

- version: 2.43.2
  changelogEntry:
    - summary: |
        Fix custom license name extraction in build.gradle to display actual license names from LICENSE files
        instead of toString() representations. The generator now reads the first line of custom LICENSE files
        and displays it as the license name.
      type: fix
  createdAt: "2025-09-03"
  irVersion: 59

- version: 2.43.1
  changelogEntry:
    - summary: |
        Fix Maven Central signing configuration to correctly use 3-parameter useInMemoryPgpKeys() method.
        The signing block was incorrectly using MAVEN_SIGNATURE_SECRET_KEY as the key ID parameter
        instead of MAVEN_SIGNATURE_KID, causing Sonatype Central validation failures during deployment.
      type: fix
  createdAt: "2025-09-02"
  irVersion: 59

- version: 2.43.0
  changelogEntry:
    - summary: |
        Add support for the `apiName` and `disabledFeatures` readme config options.
      type: feat
  createdAt: "2025-08-29"
  irVersion: 59

- version: 2.42.1
  changelogEntry:
    - summary: |
        Fix nullable fields incorrectly requiring non-null values in staged builders when
        use-nullable-annotation is enabled.
      type: fix
  createdAt: "2025-08-27"
  irVersion: 58

- version: 2.42.0
  changelogEntry:
    - summary: |
        Add support for semantic distinction between `nullable<T>` and `optional<T>` types via `use-nullable-annotation` flag.
        When enabled, `nullable<T>` generates as raw type `T` with `@Nullable` annotation, while `optional<T>` remains as `Optional<T>`.
        This provides proper API semantics for fields that can be null vs those that may be absent from requests.

        ```yaml
        customConfig:
          use-nullable-annotation: true
        ```
      type: feat
  createdAt: "2025-08-25"
  irVersion: 58

- version: 2.41.3
  changelogEntry:
    - summary: |
        Add convenient `addHeader()` method to SDK builders for adding custom headers without requiring
        OkHttpClient customization or inheritance.
      type: feat
  createdAt: "2025-08-19"
  irVersion: 58

- version: 2.41.2
  changelogEntry:
    - summary: |
        Link reference.md in the README.md.
      type: feat
  createdAt: "2025-08-19"
  irVersion: 58

- version: 2.41.1
  changelogEntry:
    - summary: |
        Fix integer overflow when processing OpenAPI specs with large integer values in examples. Values exceeding Java's Integer range are automatically converted to long type to prevent generation failures.
      type: fix
  createdAt: "2025-08-15"
  irVersion: 58

- version: 2.41.0
  changelogEntry:
    - summary: |
        Add support for generating wire tests via `enable-wire-tests` flag. Wire tests verify HTTP protocol communication
        using MockWebServer and are generated for all endpoints in a service.

        ```yaml
        customConfig:
          enable-wire-tests: true
        ```

        Generated tests include:
        - Working 404/500 error tests that compile immediately
        - Success test templates with TODO comments for customization
        - Proper handling of staged vs regular builders
        - Constants for all magic strings for better maintainability

        Note: Complex request bodies and response validation require manual customization.
      type: feat
  createdAt: "2025-08-14"
  irVersion: 58

- version: 2.40.0
  changelogEntry:
    - summary: |
        Add support for client-side default parameter values via `use-default-request-parameter-values` flag.
        When enabled, query and header parameters with defaults become Optional types and defaults are automatically
        applied when not provided. Example:

        ```yaml
        customConfig:
          use-default-request-parameter-values: true
        ```

        Generated code:
        ```java
        // Parameters with defaults become Optional
        private final Optional<Integer> perPage;  // Has default: 50

        // Defaults are applied automatically
        QueryStringMapper.addQueryParameter(httpUrl, "per_page", request.getPerPage().orElse(50), false);
        ```
      type: feat
  createdAt: "2025-08-13"
  irVersion: 58

- version: 2.39.6
  changelogEntry:
    - summary: |
        Add opt-in extensible builder pattern via `enable-extensible-builders` flag. When enabled, builders use the self-type
        pattern allowing users to extend generated builders while maintaining type safety. Example:

        ```java
        class CustomBuilder extends BaseClientBuilder<CustomBuilder> {
            @Override
            protected CustomBuilder self() { return this; }

            public CustomBuilder workspaceId(String id) {
                // custom logic
                return this;
            }
        }
        ```
      type: feat
  createdAt: "2025-08-05"
  irVersion: 58

- version: 2.39.5
  changelogEntry:
    - summary: |
        Fix undiscriminated union deserialization to catch all RuntimeException types instead of just IllegalArgumentException.
      type: fix
  createdAt: "2025-08-05"
  irVersion: 58

- version: 2.39.4
  changelogEntry:
    - summary: |
        Ensure JUnit dependencies are always added when test files are generated
      type: fix
  createdAt: "2025-08-04"
  irVersion: 58

- version: 2.39.3
  changelogEntry:
    - summary: |
        Fix compilation error when using boolean path parameters by properly handling primitive boolean to String conversion
      type: fix
  createdAt: "2025-08-04"
  irVersion: 58

- version: 2.39.2
  changelogEntry:
    - summary: |
        Fix javadoc compilation errors by using HTML entities for special characters in builder examples
      type: fix
  createdAt: "2025-07-31"
  irVersion: 58

- version: 2.39.1
  changelogEntry:
    - summary: |
        Refactor builder extension pattern to use Template Method with dynamic generation. Configuration methods
        are only generated based on API spec (auth, headers, variables). All methods are protected for override.
      type: fix
  createdAt: "2025-07-25"
  irVersion: 58

- version: 2.39.0
  changelogEntry:
    - summary: |
        Enable builder extensibility for generated SDK clients. Builders are no longer marked as final, allowing users to extend them
        and customize client behavior. Added protected buildClientOptions() method for customization hooks and static from() method
        to ClientOptions.Builder for copying existing configurations. This enables use cases like environment variable expansion
        in URLs and custom authentication methods.
      type: feat
  createdAt: "2025-07-24"
  irVersion: 58

- version: 2.38.8
  changelogEntry:
    - summary: |
        Fix byte array convenience methods to include all parameters when delegating to InputStream methods.
      type: fix
  createdAt: "2025-07-23"
  irVersion: 58

- version: 2.38.7
  changelogEntry:
    - summary: |
        Swap InputStreamRequestBody arguments to match constructor.
      type: fix
  createdAt: "2025-07-23"
  irVersion: 58

- version: 2.38.6
  changelogEntry:
    - summary: |
        Add explicit type to pagination lambda parameters.
      type: fix
  createdAt: "2025-07-21"
  irVersion: 58

- version: 2.38.5
  changelogEntry:
    - summary: |
        Remove internal OkHttp utility dependency and use a more robust file closing method.
      type: chore
  createdAt: "2025-07-18"
  irVersion: 58

- version: 2.38.4
  changelogEntry:
    - summary: |
        Fix stream SSE test to use Java 8 compatible stream collection method.
      type: fix
  createdAt: "2025-07-17"
  irVersion: 58

- version: 2.38.3
  changelogEntry:
    - summary: |
        Add reference.md generation for Java SDKs.
      type: fix
  createdAt: "2025-07-16"
  irVersion: 58

- version: 2.38.2
  changelogEntry:
    - summary: |
        Fix java sdk readme generation to properly create maven shield.
      type: fix
  createdAt: "2025-07-09"
  irVersion: 58

- version: 2.38.1
  changelogEntry:
    - summary: |
        Fix JavaDoc generation to properly escape dollar signs ($) when using JavaPoet.

        When generating JavaDoc comments with JavaPoet, dollar signs need to be escaped as `$$` to prevent
        JavaPoet from interpreting them as template variables. This ensures that dollar signs in documentation
        are rendered correctly in the final generated code.
      type: fix
  createdAt: "2025-06-23"
  irVersion: 58

- version: 2.38.0
  changelogEntry:
    - summary: |
        Add support for custom config publish-to to enable publishing to Maven Central with proper metadata and signing configuration.

        ```yaml
        customConfig:
          publish-to: central
        ```

        This configuration enables automatic publishing to Maven Central with proper metadata and signing configuration.
      type: chore
  createdAt: "2025-06-23"
  irVersion: 58

- version: 2.37.2
  changelogEntry:
    - summary: |
        No changes. Publishing changes from 2.37.1-rc0 and 2.37.1-rc1 to release track.
      type: chore
  createdAt: "2025-06-23"
  irVersion: 58

- version: 2.37.1-rc1
  changelogEntry:
    - summary: |
        Remove Content-Type from headers when request has no body
      type: fix
  createdAt: "2025-06-16"
  irVersion: 58
- version: 2.37.1-rc0
  changelogEntry:
    - summary: |
        Fix array query params are treated as exploded: true
      type: fix
  createdAt: "2025-06-13"
  irVersion: 58
- version: 2.37.0
  changelogEntry:
    - summary: |
        Add support for generating a full project in filesystem mode.
      type: feat
  createdAt: "2025-06-04"
  irVersion: 58
- version: 2.36.5
  changelogEntry:
    - summary: Update the IR to v58.
      type: internal
  createdAt: "2025-06-03"
  irVersion: 58
- changelogEntry:
    - summary: |
        Generates docs for method types.
      type: fix
  createdAt: "2025-05-21"
  irVersion: 57
  version: 2.36.4
- changelogEntry:
    - summary: |
        Updates the generator to always commit changes, even if there are none, in self-hosted mode. This
        allows users to make sure that the generator actually ran and attempted to make a commit.
      type: fix
  createdAt: "2025-05-20"
  irVersion: 57
  version: 2.36.3
- changelogEntry:
    - summary: |
        Fix the generated README.md for the `maxRetries` configuration option, which is now
        shown on the client constructor.
      type: fix
  createdAt: "2025-05-15"
  irVersion: 57
  version: 2.36.2
- changelogEntry:
    - summary: |
        Add support for the custom introduction setting in the generated README.md.
      type: fix
  createdAt: "2025-05-13"
  irVersion: 57
  version: 2.36.1
- changelogEntry:
    - summary: |
        Support sending requests with content type application/x-www-form-urlencoded.
      type: feat
  createdAt: "2025-05-11"
  irVersion: 57
  version: 2.36.0
- changelogEntry:
    - summary: |
        Rerelease with the latest generator-cli.
      type: fix
  createdAt: "2025-05-01"
  irVersion: 57
  version: 2.35.3
- changelogEntry:
    - summary: |
        Install the generator-cli at build time as a fallback if runtime installation fails.
      type: fix
  createdAt: "2025-05-01"
  irVersion: 57
  version: 2.35.2
- changelogEntry:
    - summary: |
        Self hosted github user defaults to `fern-api[bot]`.
      type: fix
  createdAt: "2025-05-01"
  irVersion: 57
  version: 2.35.1
- changelogEntry:
    - summary: |
        Support pushing to GitHub enterprise.
      type: fix
  createdAt: "2025-05-01"
  irVersion: 57
  version: 2.35.0
- changelogEntry:
    - summary: |
        Upgrade to irV57
      type: fix
  createdAt: "2025-05-01"
  irVersion: 57
  version: 2.34.0
- changelogEntry:
    - summary: |
        (Corrected from 2.33.2) Use non-deprecated method to create request body
      type: fix
  createdAt: "2025-04-28"
  irVersion: 55
  version: 2.33.4
- changelogEntry:
    - summary: |
        Suppress unchecked cast warning for undiscriminated union visitor
      type: fix
  createdAt: "2025-04-28"
  irVersion: 55
  version: 2.33.3
- changelogEntry:
    - summary: |
        Use non-deprecated method to create request body
      type: fix
  createdAt: "2025-04-25"
  irVersion: 55
  version: 2.33.2
- changelogEntry:
    - summary: |
        Fix inline overrides undoing allow-multiple parameterization
      type: fix
  createdAt: "2025-04-24"
  irVersion: 55
  version: 2.33.1
- changelogEntry:
    - summary: |
        Support for literals in union types
      type: fix
  createdAt: "2025-04-23"
  irVersion: 55
  version: 2.33.0
- changelogEntry:
    - summary: |
        Auth header prefix should prepend with a concatenation operator
      type: fix
  createdAt: "2025-04-21"
  irVersion: 55
  version: 2.32.9
- changelogEntry:
    - summary: |
        Use safe name for version enum
      type: fix
  createdAt: "2025-04-09"
  irVersion: 55
  version: 2.32.8
- changelogEntry:
    - summary: |
        Run v2 generation for SDK generator only
      type: fix
  createdAt: "2025-04-09"
  irVersion: 55
  version: 2.32.7
- changelogEntry:
    - summary: |
        Fix getting the default version of an api versions enum to not require the `CURRENT` entry
      type: fix
  createdAt: "2025-04-09"
  irVersion: 55
  version: 2.32.6
- changelogEntry:
    - summary: |
        Fix inlining forward-compatible enums
      type: fix
  createdAt: "2025-04-08"
  irVersion: 55
  version: 2.32.5
- changelogEntry:
    - summary: |
        Fix typos in README generator
      type: fix
  createdAt: "2025-04-01"
  irVersion: 55
  version: 2.32.4
- changelogEntry:
    - summary: |
        Add logging for Java v2 generator call
      type: fix
  createdAt: "2025-04-01"
  irVersion: 55
  version: 2.32.3
- changelogEntry:
    - summary: |
        Add fallback snippet renderer for readme generation
      type: fix
  createdAt: "2025-04-01"
  irVersion: 55
  version: 2.32.2
- changelogEntry:
    - summary: |
        Fix pagination in raw clients
      type: fix
  createdAt: "2025-03-31"
  irVersion: 55
  version: 2.32.1
- changelogEntry:
    - summary: |
        Generate snippet.json
      type: feat
  createdAt: "2025-03-29"
  irVersion: 55
  version: 2.32.0
- changelogEntry:
    - summary: |
        Apply content type to request body creation
      type: fix
  createdAt: "2025-03-27"
  irVersion: 55
  version: 2.31.0
- changelogEntry:
    - summary: |
        Include response headers in API exceptions
      type: feat
  createdAt: "2025-03-27"
  irVersion: 55
  version: 2.30.0
- changelogEntry:
    - summary: |
        Query params respect allow-multiple
      type: fix
  createdAt: "2025-03-27"
  irVersion: 55
  version: 2.29.0
- changelogEntry:
    - summary: |
        Expose response headers
      type: feat
  createdAt: "2025-03-26"
  irVersion: 55
  version: 2.28.0
- changelogEntry:
    - summary: |
        Change method to `public static void main(String[] args)` in snippet generation
      type: fix
  createdAt: "2025-03-24"
  irVersion: 55
  version: 2.27.1
- changelogEntry:
    - summary: |
        Support automatic README.md generation
      type: feat
  createdAt: "2025-03-21"
  irVersion: 55
  version: 2.27.0
- changelogEntry:
    - summary: |
        Expose max retries for clients
      type: feat
  createdAt: "2025-03-13"
  irVersion: 55
  version: 2.26.0
- changelogEntry:
    - summary: |
        Add config to inline file properties
      type: feat
  createdAt: "2025-03-13"
  irVersion: 55
  version: 2.25.0
- changelogEntry:
    - summary: |
        Prevent put requests from generating without a request body
      type: fix
  createdAt: "2025-03-12"
  irVersion: 55
  version: 2.24.4
- changelogEntry:
    - summary: |
        Fix double unknown in forward-compatible enums
      type: fix
    - summary: |
        Prevent enum keyword use in package paths
      type: fix
  createdAt: "2025-03-12"
  irVersion: 55
  version: 2.24.3
- changelogEntry:
    - summary: |
        Remove 'object' from Java reserved strings list
      type: fix
  createdAt: "2025-03-12"
  irVersion: 55
  version: 2.24.2
- changelogEntry:
    - summary: |
        Add @JsonIgnore to non-serialization getters for nullables
      type: fix
  createdAt: "2025-03-11"
  irVersion: 55
  version: 2.24.1
- changelogEntry:
    - summary: |
        Fix wrapped request paths in flat mode
      type: fix
  createdAt: "2025-03-11"
  irVersion: 55
  version: 2.24.0
- changelogEntry:
    - summary: |
        Fix async client builder generation
      type: fix
  createdAt: "2025-03-07"
  irVersion: 55
  version: 2.23.1
- changelogEntry:
    - summary: |
        Represent protobuf uint as int rather than long
      type: fix
  createdAt: "2025-03-06"
  irVersion: 55
  version: 2.23.0
- changelogEntry:
    - summary: |
        Add support for explicit nulls in serialization
      type: feat
  createdAt: "2025-03-05"
  irVersion: 55
  version: 2.22.0
- changelogEntry:
    - summary: |
        Add async clients
      type: feat
  createdAt: "2025-03-04"
  irVersion: 55
  version: 2.21.0
- changelogEntry:
    - summary: |
        Fix type reference syntax in readValue calls
      type: fix
  createdAt: "2025-03-02"
  irVersion: 55
  version: 2.20.1
- changelogEntry:
    - summary: |
        Fix collection serialization in multipart form body without form encoding
      type: fix
  createdAt: "2025-02-27"
  irVersion: 55
  version: 2.20.0
- changelogEntry:
    - summary: |
        Enable overriding literal headers
      type: feat
  createdAt: "2025-02-26"
  irVersion: 55
  version: 2.19.0
- changelogEntry:
    - summary: |
        Fix form body serialization
      type: fix
  createdAt: "2025-02-25"
  irVersion: 55
  version: 2.18.1
- changelogEntry:
    - summary: |
        Support form-data with deep object query params
      type: feat
  createdAt: "2025-02-24"
  irVersion: 55
  version: 2.18.0
- changelogEntry:
    - summary: |
        Support deep object query parameters
      type: feat
  createdAt: "2025-02-24"
  irVersion: 55
  version: 2.17.0
- changelogEntry:
    - summary: |
        Upgrade IR version dependency to v55
      type: chore
  createdAt: "2025-02-20"
  irVersion: 55
  version: 2.16.0
- changelogEntry:
    - summary: |
        Add support for custom HTTP client in Java SDK
      type: feat
  createdAt: "2025-02-19"
  irVersion: 53
  version: 2.15.0
- changelogEntry:
    - summary: |
        Support user-agent header
      type: feat
  createdAt: "2025-02-19"
  irVersion: 53
  version: 2.14.0
- changelogEntry:
    - summary: |
        Flat package layout by setting `page-layout: flat`
      type: feat
  createdAt: "2025-02-18"
  irVersion: 53
  version: 2.13.0
- changelogEntry:
    - summary: |
        Fix collision with variant type called "Value" and internal interface name.
      type: fix
    - summary: |
        Prevent discriminant from deserializing as additional property in unwrapped variant.
      type: fix
  createdAt: "2025-02-14"
  irVersion: 53
  version: 2.12.1
- changelogEntry:
    - summary: |
        Let users define custom headers in request options
      type: feat
  createdAt: "2025-02-10"
  irVersion: 53
  version: 2.12.0
- changelogEntry:
    - summary: |
        Don't add a semicolon twice when rendering accept header
      type: fix
  createdAt: "2025-02-04"
  irVersion: 53
  version: 2.11.3
- changelogEntry:
    - summary: |
        Add accept header if endpoint has errors
      type: fix
  createdAt: "2025-02-03"
  irVersion: 53
  version: 2.11.2
- changelogEntry:
    - summary: |
        Send only request body reference for body-only wrapped request
      type: fix
  createdAt: "2025-02-03"
  irVersion: 53
  version: 2.11.1
- changelogEntry:
    - summary: |
        Add deep cursor path pagination support.
      type: feat
  createdAt: "2025-01-29"
  irVersion: 53
  version: 2.11.0
- changelogEntry:
    - summary: |
        Fix wrapped requests without inline path parameters checking not rendering
        no-request endpoint because of non-optional parameters
      type: fix
  createdAt: "2025-01-23"
  irVersion: 53
  version: 2.10.7
- changelogEntry:
    - summary: |
        Prevent accept header from being removed in wrapped requests
      type: fix
  createdAt: "2025-01-21"
  irVersion: 53
  version: 2.10.6
- changelogEntry:
    - summary: |
        Add Accept header for json responses
      type: fix
  createdAt: "2025-01-21"
  irVersion: 53
  version: 2.10.5
- changelogEntry:
    - summary: |
        Fix potential NPE initializing client options with default version
      type: fix
  createdAt: "2025-01-19"
  irVersion: 53
  version: 2.10.4
- changelogEntry:
    - summary: |
        Fix inlining unwrapped alias types.
      type: fix
  createdAt: "2025-01-17"
  irVersion: 53
  version: 2.10.3
- changelogEntry:
    - summary: |
        Omit methods with inlined types from interface definitions.
      type: fix
  createdAt: "2025-01-16"
  irVersion: 53
  version: 2.10.2
- changelogEntry:
    - summary: |
        Fix union inline type name conflict resolution.
      type: fix
  createdAt: "2025-01-16"
  irVersion: 53
  version: 2.10.1
- changelogEntry:
    - summary: |
        Support inline types in the Java generator.
      type: feat
  createdAt: "2025-01-16"
  irVersion: 53
  version: 2.10.0
- changelogEntry:
    - summary: |
        Support version headers in request and client options.
      type: feat
  createdAt: "2025-01-07"
  irVersion: 53
  version: 2.9.0
- changelogEntry:
    - summary: |
        Implement global timeout configuration for generated clients.
          ```java
          var client = Client.builder()
            .apiKey("...")
            .timeout(40)
            .build();
          ```
      type: feat
  createdAt: "2024-12-23"
  irVersion: 53
  version: 2.8.1
- changelogEntry:
    - summary: |
        Generate inline request bodies with their path parameters in the object.
      type: feat
  createdAt: "2024-12-20"
  irVersion: 53
  version: 2.8.0
- changelogEntry:
    - summary: |
        Apply Content-Type header from endpoint definition in SDK generator.
      type: feat
  createdAt: "2024-12-11"
  irVersion: 53
  version: 2.7.0
- changelogEntry:
    - summary: |
        Don't generate pagination with nonempty path. Fixes pagination seed tests breaking.
      type: fix
  createdAt: "2024-12-10"
  irVersion: 53
  version: 2.6.0
- changelogEntry:
    - summary: |
        Bump IR version to latest (v53)
      type: chore
  createdAt: "2024-12-10"
  irVersion: 53
  version: 2.5.0
- changelogEntry:
    - summary: |
        We now support overriding sdk package prefixes by adding a "package-prefix" key under the java-sdk generator
        configuration.
      type: feat
  createdAt: "2024-12-10"
  irVersion: 46
  version: 2.4.0

- changelogEntry:
    - summary: |
        The rootProject.name is now set in settings.gradle and ci.yml uses ./gradlew sonatypeCentralUpload for publishing.
      type: fix
  createdAt: "2024-12-04"
  irVersion: 46
  version: 2.3.1

- changelogEntry:
    - summary: |
        Fix publishing to Maven Central with proper signing configuration and metadata.
      type: feat
  createdAt: "2024-12-04"
  irVersion: 46
  version: 2.3.0

- changelogEntry:
    - summary: |
        We now provide endpoint methods for streaming byte array requests in addition to the previous methods accepting
        byte array directly.
      type: feat
    - summary: |
        Bump Jackson version to latest (2.17.2)
      type: chore
  createdAt: "2024-09-26"
  irVersion: 46
  version: 2.2.0

- changelogEntry:
    - summary: |
        We no longer enforce non-null constraints for Object type properties in builders.
      type: feat
  createdAt: "2024-09-11"
  irVersion: 46
  version: 2.1.0

- changelogEntry:
    - summary: |
        The SDK generator is now on major version 2. To take this upgrade without any breaks, please add the below
        configuration to your `generators.yml` file:
        ```yaml
        generators:
          - name: fernapi/fern-java-sdk
            config:
              disable-required-property-builder-checks: true
        ```
      type: break
    - summary: |
        Generated builder methods now enforce non-null checks for required fields, ensuring that all required
        fields are properly validated during object construction:
          ```java
          @java.lang.Override
          @JsonSetter("name")
          public NameStage name(@NotNull String name) {
              this.name = Objects.requireNonNull(name, "name must not be null");
              return this;
          }
          ```
      type: feat
  createdAt: "2024-09-05"
  irVersion: 46
  version: 2.0.0

- changelogEntry:
    - summary: |
        Public constructors can now be generated for all model types:
        ```yaml
        generators:
          - name: fernapi/fern-java-sdk
            config:
              enable-public-constructors: true # default false
          ```
      type: feat
  createdAt: "2024-09-04"
  irVersion: 46
  version: 1.0.7

- changelogEntry:
    - summary: Fixed a bug where optional collections are not handled properly in paginated responses.
      type: fix
  createdAt: "2024-09-04"
  irVersion: 46
  version: 1.0.6

- changelogEntry:
    - summary: Fixed a bug where local generation custom config doesn't pick up some values, including exception naming.
      type: fix
  createdAt: "2024-07-26"
  irVersion: 46
  version: 1.0.5

- changelogEntry:
    - summary: Fixed a bug where OkHttp responses could be closed prematurely.
      type: fix
  createdAt: "2024-07-24"
  irVersion: 46
  version: 1.0.4

- changelogEntry:
    - summary: Generated builder methods for optional fields can now accept null directly.
      type: feat
  createdAt: "2024-07-23"
  irVersion: 46
  version: 1.0.3

- changelogEntry:
    - summary: |
        The generator now adds a class-level `@JsonInclude(JsonInclude.Include.NON_ABSENT)` annotation to
        each generated type in place of the previous `@JsonInclude(JsonInclude.Include.NON_EMPTY)` by default. This is
        configurable in the `generators.yml` file:
        ```yaml
        generators:
          - name: fernapi/fern-java-sdk
            config:
              json-include: non-empty # default non-absent
        ```
      type: feat
  createdAt: "2024-07-02"
  irVersion: 46
  version: 1.0.2-rc0

- changelogEntry:
    - summary: |
        The Java SDK is now on major version 1. To take this upgrade without any breaks, please add the below
        configuration to your `generators.yml` file:
        ```yaml
        generators:
          - name: fernapi/fern-java-sdk
            config:
              base-api-exception-class-name: ApiError
              base-exception-class-name: CompanyException # Optional: This should only be set if default naming is undesirable
        ```
      type: break
    - summary: |
        We now generate Exception types for all errors that are defined in the IR. Generated clients with an
        error discrimination strategy of "status code" will throw one of these typed Exceptions based on the status code of
        error responses. Example error type:
        ```java
        public final class BadRequest extends MyCompanyApiError {
          public BadRequest(Object body) {
              super("BadRequest", 400, body);
          }
        }
        ```
      type: feat
  createdAt: "2024-06-26"
  irVersion: 46
  version: 1.0.1

- changelogEntry:
    - summary: Add support for cursor and offset pagination.
      added:
        - |
          Add support for cursor and offset pagination.

          For example, consider the following endpoint `/users` endpoint:

          ```yaml
          types:
            User:
              properties:
                name: string

            ListUserResponse:
              properties:
                next: optional<string>
                data: list<User>

          service:
            auth: false
            base-path: /users
            endpoints:
              list:
                path: ""
                method: GET
                pagination:
                  cursor: $request.starting_after
                  next_cursor: $response.next
                  results: $response.data
                request:
                  name: ListUsersRequest
                  query-parameters:
                    starting_after: optional<string>
                response: ListUsersResponse
          ```

          The generated `SyncPagingIterable<User>` can then be used to traverse through the `User` objects:

          ```java
          for (User user : client.users.list(...)) {
              System.out.println(user);
          }
          ```

          Or stream them:

          ```java
          client.users.list(...).streamItems().map(user -> ...);
          ```

          Or statically calling `nextPage()` to perform the pagination manually:

          ```java
          SyncPagingIterable<User> pager = client.users.list(...);
          // First page
          System.out.println(pager.getItems());
          // Second page
          pager = pager.nextPage();
          System.out.println(pager.getItems());
          ```
      type: feat
  createdAt: "2024-06-13"
  irVersion: 46
  version: 0.10.1

- changelogEntry:
    - summary: The generator now supports BigInteger types.
      type: feat
  createdAt: "2024-06-07"
  irVersion: 46
  version: 0.10.0

- changelogEntry:
    - summary: |
        `RequestOptions` are now generated with the `timeout` field initialized to `Optional.empty()` instead of `null` to avoid NPEs if `timeout` is not set in the builder.
      type: feat
  createdAt: "2024-06-06"
  irVersion: 42
  version: 0.9.8

- changelogEntry:
    - summary: |
        The SDK generator now generates `@java.lang.Override` over `@Override` in all files to avoid clashes with any
        `Override.java` class that may have been generated in the same package. The former was used most places, but not all,
        until this release.
      type: feat
  createdAt: "2024-06-06"
  irVersion: 42
  version: 0.9.7

- changelogEntry:
    - summary: The SDK generator now supports returning response properties from client methods rather than just the responses themselves.
      type: feat
  createdAt: "2024-06-05"
  irVersion: 42
  version: 0.9.6

- changelogEntry:
    - summary: Types without fields are now generated with builders. Previously, they were not, which made them impossible to initialize.
      type: fix
  createdAt: "2024-05-30"
  irVersion: 42
  version: 0.9.5

- changelogEntry:
    - summary: The SDK now generates undiscriminated unions with de-conflicted method signatures. Previously, certain undiscriminated unions would have failed to compile due to Java's type erasure causing conflicts.
      type: fix
  createdAt: "2024-05-30"
  irVersion: 42
  version: 0.9.4

- changelogEntry:
    - summary: Generated SDK clients with an OAuth security scheme will now automatically refresh access tokens before they expire.
      type: feat
  createdAt: "2024-05-23"
  irVersion: 42
  version: 0.9.3

- changelogEntry:
    - summary: Java 8 Compatibility.
      type: fix
  createdAt: "2024-05-21"
  irVersion: 42
  version: 0.9.2

- changelogEntry:
    - summary: |
        Support OAuth without token refresh. Example of initializing a client with OAuth:

        ```java
        ExampleApiClient client = ExampleApiClient
            .builder()
            .clientId("4bf2a37d-8512-44a2-af50-28a7701d9f2e")
            .clientSecret("b3b187b0-ef48-49ba-9d99-80d89fd11c4a")
            .build();
        ```
      type: fix
  createdAt: "2024-05-15"
  irVersion: 42
  version: 0.9.1

- changelogEntry:
    - summary: Bump intermediate representation to v42
      type: internal
  createdAt: "2024-05-13"
  irVersion: 42
  version: 0.9.0-rc0

- changelogEntry:
    - summary: Corrects the fix in 0.8.10 to check null value as opposed to a .isPresent check, given the header is not `Optional`, it's always `String`
      type: fix
  createdAt: "2024-05-08"
  irVersion: 31
  version: 0.8.11

- changelogEntry:
    - summary: Fixes regression from 0.8.8, headers are no longer added to the header map unless they are non-null.
      type: fix
  createdAt: "2024-05-08"
  irVersion: 31
  version: 0.8.10

- changelogEntry:
    - summary: Generated SDK clients now handle null response bodies and avoid NPEs when they receive error responses.
      type: fix
  createdAt: "2024-05-07"
  irVersion: 31
  version: 0.8.9

- changelogEntry:
    - summary: The generated SDKs no longer require global headers that are not directly related to auth if auth is mandatory within the SDK. Previously, the generator would require all global headers if auth was mandatory.
      type: fix
  createdAt: "2024-05-07"
  irVersion: 31
  version: 0.8.8

- changelogEntry:
    - summary: |
        You can now specify publishing metadata to populate your POM on publish:
        ```yaml
        generators:
          - name: fernapi/fern-java-sdk
            version: 0.X.Y
            output:
              location: maven
              registryUrl: ""
              publish-metadata:
                author: ""
                email: ""
                package-description: ""
                reference-url: ""
        ```
      type: feat
  createdAt: "2024-03-21"
  irVersion: 31
  version: 0.8.7

- changelogEntry:
    - summary: |
        The SDK now generates RequestOptions functions for timeouts with IdempotentRequestOptions correctly, previously
        timeout functions were only taking in regular RequestOptions. This also addresses a JavaPoet issue where fields were
        being initialized twice across RequestOptions and IdempotentRequestOptions classes, preventing the SDK from generating at all.
      type: fix
  createdAt: "2024-03-20"
  irVersion: 31
  version: 0.8.6

- changelogEntry:
    - summary: |
        Add in publishing config that allows for signing published artifacts, this is required for publishing to Maven
        Central.
        To sign your artifacts, you must add the below to your publishing config:
        ```yaml
        generators:
          - name: fernapi/fern-java-sdk
            version: 0.X.Y
            output:
              location: maven
              registryUrl: ""
              signature:
                keyId: ""
                password: ""
                secretKey: ""
        ```
        and secrets can be used, similar to how API keys are specified today:
        ```yaml
        generators:
          - name: fernapi/fern-java-sdk
            version: 0.X.Y
            output:
              location: maven
              registryUrl: ""
              signature:
                keyId: ${MY_KID_ENVVAR}
                password: ${MY_SECRET_ENVVAR}
                secretKey: ${MY_SECRET_KEY_ENVVAR}
        ```
      type: feat
  createdAt: "2024-03-18"
  irVersion: 31
  version: 0.8.5

- changelogEntry:
    - summary: Update docker image for Java SDK task runner.
      type: internal
  createdAt: "2024-02-23"
  irVersion: 31
  version: 0.8.5-rc0

- changelogEntry:
    - summary: |
        The timeout specified on the RequestOptions object now sets the timeout on the entire call, not just the
        read timeout of the request.
        As a refresher, a timeout can be added per request like so:
        ```java
        RequestOptions ro = RequestOptions.builder().timeout(90).build(); // Creates a timeout of 90 seconds for the request
        //  You could also specify the timeunit, similar to as if you were using OkHttp directly
        //  RequestOptions ro = RequestOptions.builder().timeout(2, TimeUnit.MINUTES).build();
        client.films.list(ro);
        ```
      type: fix
  createdAt: "2024-02-23"
  irVersion: 31
  version: 0.8.4

- changelogEntry:
    - summary: The SDK generator now always creates a valid name for union discriminator wrapper classes.
      type: fix
  createdAt: "2024-02-23"
  irVersion: 31
  version: 0.8.3

- changelogEntry:
    - summary: |
        File upload endpoints no longer fail to compile because the reference to
        the mime type variable is present.

        ```java
        // Code that failed to compile
        String fileMimeType = Files.probeContentType(file.toPath());
        MediaType fileMediaType = fileMimeType != null ? MediaType.parse(mimeType) : null; // mimeType undefined
        // Code that now compiles
        MediaType fileMediaType = fileMimeType != null ? MediaType.parse(fileMimeType) : null;
        ```
      type: fix
  createdAt: "2024-02-21"
  irVersion: 31
  version: 0.8.2

- changelogEntry:
    - summary: |
        The RequestOptions object now supports configuring an optional timeout to apply per-request.
        ```java
        RequestOptions ro = RequestOptions.builder().timeout(90).build(); // Creates a timeout of 90 seconds for the request
        //  You could also specify the timeunit, similar to as if you were using OkHttp directly
        //  RequestOptions ro = RequestOptions.builder().timeout(2, TimeUnit.MINUTES).build();
        client.films.list(ro);
        ```
      type: feat
  createdAt: "2024-02-14"
  irVersion: 31
  version: 0.8.1

- changelogEntry:
    - summary: |
        The SDK generator now supports whitelabelling. When this is turned on,
        there will be no mention of Fern in the generated code.

        **Note**: You must be on the enterprise tier to enable this mode.
      type: feat
  createdAt: "2024-02-11"
  irVersion: 31
  version: 0.8.0

- changelogEntry:
    - summary: |
        The SDK generator now supports idempotency headers. Users
        will be able to specify the idempotency headers in RequestOptions.

        ```java
        Imdb imdb = Imdb.builder()
          .apiKey("...")
          .build();

        var response = imdb.ticket.purchase("theatre-id", IdempotentRequestOptions.builder()
          .idempotencyKey("...")
          .build());
        ```
      type: feat

    - summary: |
        The SDK generator now supports scanning API credentials
         via environment variables.
         ```java
         Imdb imdb = Imdb.builder()
           .apiKey("...") // defaults to System.getenv("IMDB_API_KEY")
           .build();
         ```
      type: feat

    - summary: |
        The generated models now support boolean literals and users
        do not have to specify them in the builder.
        For example, for the following object
        ```yaml
        Actor:
          properties:
            name: string
            isMale: literal<true>
        ```
        the user will not need to specify the literal properties when building
        the object.
        ```java
        var actor = Actor.builder()
          .name("Brad Pitt")
          .build();
        ```
      type: feat
  createdAt: "2024-02-04"
  irVersion: 31
  version: 0.7.1

- changelogEntry:
    - summary: Release version 0.6.1
      type: internal
  createdAt: "2024-02-03"
  irVersion: 31
  version: 0.6.1