# yaml-language-server: $schema=../../fern-versions-yml.schema.json - version: 0.5.2 changelogEntry: - summary: | Bump the OpenAPI generator container's Node base image from `node:22.22-alpine3.23` to `node:24.15-alpine3.23`. Aligns the generator with the rest of the Fern generator containers on a single Node major version (Node 24) and picks up Node 24's CVE patches. type: chore createdAt: "2026-05-11" irVersion: 66 - version: 0.5.1 changelogEntry: - summary: | Upgrade the generator base image to `node:22.22.2-alpine3.22` and run `apk upgrade` during the build to pick up the latest Alpine security patches. This addresses container vulnerabilities reported by Grype against the previously published image, including CVEs in `node`, `libssl3`/`libcrypto3`, `musl`, `busybox`, and `zlib`. Bundled npm dependencies (`tar`, `cross-spawn`, `glob`, `minimatch`, `brace-expansion`, `ip-address`, `diff`) are also picked up at their patched versions from the current lockfile. type: chore createdAt: "2026-05-06" irVersion: 66 - version: 0.5.0 changelogEntry: - summary: | The generator now emits OpenAPI 3.1.0 specifications (previously 3.0.1). As part of this: - `nullable: true` is no longer emitted. Optional/nullable types now use the OAS 3.1 idiom: `type: [T, "null"]` for primitives, and `anyOf: [$ref, {type: "null"}]` for references. This fixes the silent no-op where `$ref` + sibling `nullable` did nothing. - Parameters no longer emit both `example` and `examples` (they are mutually exclusive in OAS 3.0 and 3.1). `examples` is preferred when present. - `info.version` is populated with a non-empty default (`"0.0.0"`) instead of an empty string, which violated the spec. - `exclusiveMinimum`/`exclusiveMaximum` now emit as numbers (JSON Schema 2020-12) instead of the 3.0-era boolean format. - Single-element enums and union discriminant properties now use `const` instead of `enum: [singleValue]`. - Redundant `additionalProperties: true` is no longer emitted (defaults to true in 3.1). - Schema property examples use the 3.1 `examples` array instead of the deprecated singular `example` keyword. - Response descriptions now have meaningful defaults instead of empty strings. This is a breaking change for consumers relying on OAS 3.0 tooling. type: feat createdAt: "2026-04-13" irVersion: 66 - version: 0.4.0-rc.0 changelogEntry: - summary: | Upgrade to IR v66 which compresses the IR Name type, reducing IR size and increasing performance. type: feat - summary: | Fix security scheme names in the generated OpenAPI spec to use the casing configuration from the IR instead of hardcoded names. Scheme names now reflect the original key from the Fern definition, pascal-cased. type: fix createdAt: "2026-04-01" irVersion: 66 - version: 0.3.0 createdAt: "2026-02-27" changelogEntry: - type: feat summary: | The OpenAPI generator now includes `x-fern-availability` extensions in the generated OpenAPI spec for endpoints, query parameters, headers, object properties, and type declarations. irVersion: 53 - version: 0.2.0 createdAt: "2026-02-10" changelogEntry: - type: feat summary: | Add support for numeric validation constraints (minimum/maximum, exclusiveMinimum/exclusiveMaximum, multipleOf) and string length constraints (minLength/maxLength) in the generated OpenAPI schemas, parameters, and request bodies. irVersion: 53 - version: 0.1.8 createdAt: "2025-11-19" changelogEntry: - type: chore summary: | Bump generator CLI version to publish new Docker image. irVersion: 53 - version: 0.1.7 createdAt: "2025-01-24" changelogEntry: - type: fix summary: | The generator now correctly handles different success response codes. irVersion: 53 - version: 0.1.6 createdAt: "2024-12-20" changelogEntry: - type: fix summary: | The generator now correctly handles float types when converting to OpenAPI specs. irVersion: 53 - version: 0.1.5 createdAt: "2024-10-06" changelogEntry: - type: fix summary: | The generator now adds parameter level examples for global parameters. irVersion: 53 - version: 0.1.4 createdAt: "2024-09-25" changelogEntry: - type: fix summary: | The generator now handles `config.filename` being null so that the configuration for the generator can continue to be backwards compatible. irVersion: 53 - version: 0.1.3 createdAt: "2024-09-25" changelogEntry: - type: fix summary: | The OpenAPI generator now supports adding patterns to any string references. irVersion: 53 - version: 0.1.2 createdAt: "2024-09-25" changelogEntry: - type: feat summary: | The OpenAPI generator now supports a configuration to define the name of the file that you would like to output. ```yml generators.yml - name: fernapi/fern-openapi version: 0.1.2 config: filename: My-Openapi.yml ``` irVersion: 53 - version: 0.1.1 createdAt: "2024-09-25" changelogEntry: - type: fix summary: | The `customOverrides` configuration flag now supports explicit nulls as a way to delete keys in the generated OpenAPI spec. For example, if you want to exclude the `openapi.info` block in the generated spec, then you can do something along the lines: ```yml generators.yml - name: fernapi/fern-openapi version: 0.1.1 config: customOverrides: info: null # excludes the info field ``` irVersion: 53 - version: 0.1.0 createdAt: "2024-09-25" changelogEntry: - type: chore summary: | The OpenAPI generator now uses version 53 of the IR (previously was on version 23). You will need to upgrade your Fern CLI to the latest to run this version of the OpenAPI generator. irVersion: 53 - version: 0.0.32 createdAt: "2024-03-24" changelogEntry: - type: fix summary: | The generated OpenAPI spec now takes into account global path parameters. irVersion: 23 - version: 0.0.31 createdAt: "2024-03-22" changelogEntry: - type: fix summary: >- Update open api generator to v2 urls. - type: internal summary: >- Shared generator notification and config parsing logic. irVersion: 23 - version: 0.0.31-rc0 createdAt: "2024-03-20" changelogEntry: - type: fix summary: >- Update open api generator to v2 urls. irVersion: 23 - version: 0.0.30 createdAt: "2024-01-21" changelogEntry: - type: internal summary: Release 0.0.30 irVersion: 23