🌿 ✨ [Scheduled] Upgrade Fern CLI

[fern-api]

Upgrading from 0.51.34 to 0.56.13 - Changelog

0.56.13

• fix: Correctly parse channel descriptions in AsyncAPI v2 and v3 specs.

0.56.12

• fix: Updated the OpenAPI parser to:

  • Support parsing references that point to external files (e.g. https://github.com/...)
  • Enable merging Intermediate Representations (IRs) when APIs have multiple OpenAPI specs
  • Skip legacy parsers when openapi-parser-v3 is enabled for cleaner CLI logging

0.56.11

• fix: Add x-fern-address extension for AsyncAPI v2.x.x specs to specify the channel address.

0.56.10

• fix: Enable correct environment generation when only provided an AsyncAPI spec.

0.56.9

• fix: Fix an issue where default values for query parameters would occasionally be omitted during parsing.

57 additional updates, see more




0.56.8

feat: OpenAPI file properties can now support descriptions.

0.56.7

internal: The CLI now recognizes that the latest C# SDK uses IRv57.

0.56.6

internal: The CLI now recognizes that the latest PHP SDK uses IRv57.

0.56.5

fix: Updated the CLI to gracefully handle unsupported security schemes (e.g. cookie-based auth) by skipping them
instead of throwing an error. This allows the CLI to continue processing the rest of the API definition even when
it encounters security schemes it cannot convert.

0.56.4

fix: Re-releasing the Fern CLI to fix an issue with the published package.

0.56.3

internal: Make the latest C# SDK generator consume IR v56.

0.56.2

fix: Re-releasing the Fern CLI to fix an issue with the published package.

0.56.1

fix: Re-releasing the Fern CLI to fix an issue with the published package.

0.56.0

fix: Fixed several issues with broken link detection in docs:

• Fixed handling of redirects to ensure broken links aren't reported when valid redirects exist
• Added proper handling of relative paths from different slugs
• Improved URL validation and error messages

Running fern docs broken-links will now scan your docs site and log any broken internal links.

0.56.0-rc6

fix: Hidden sections are now removed from the docs sitemap.

0.56.0-rc5

fix: Fixed duplicate validation messages in docs validation by deduplicating violations
that have the same message, node path, file path, and severity.

This prevents showing the same broken link error multiple times.

0.56.0-rc4

feat: If experimental.openapi-parser-v3 is enabled in docs.yml, OpenAPI documents will now be
converted directly to IR, bypassing the intermediate Fern Definition step.

This makes sure that the old code path is completely ignored if the flag is enabled.

0.56.0-rc3

feat: You can now specify custom pagination on your API and endpoints.
This lets you implement your own pagination strategy in the generated SDKs.

0.56.0-rc2

fix: Fix an issue where channel binding parameters with complex schemas were generated with conflicting names.

0.56.0-rc1

internal: Add support for a new option --from-openapi to the fern ir command. This command
will allow you to test early versions of the new OpenAPI parser which goes directly from
OpenAPI to IR.

fern ir ir.json --from-openapi

0.56.0-rc0

feat: Improve the fern docs broken-links output to make it easier to
understand. Logged violations now include clickable links to the
affected source files (in supported terminals).

Added a --broken-links flag to the fern check and fern docs dev
commands. If set, broken links will be logged.

0.55.1

fix: The Conjure Importer now correctly handles the auth property in endpoint definitions.

0.55.0

feat: The Fern definition now supports specifying object properties as read-only or write-only.

0.54.1

feat: Add support for the x-fern-enum extension in the AsyncAPI v3 parser.

0.54.0-rc12

feat: Add support for specifying C# snippets in the generators.yml file.

0.54.0-rc11

fix: Improve error logging in AsyncAPI v3 parser when parsing location headers.

0.54.0-rc10

chore: Migrate generators.yml without any specs.

0.54.0-rc9

chore: Detect swagger as OpenAPI files when migrating to specs configuration in generators.yml.

0.54.0-rc8

chore: Migration to specs configuration handles yaml/json files and checks for file existence.

0.54.0-rc7

chore: Add Java generator versions to migrations file from v55 to v54

0.54.0-rc6

fix: Improve generators.yml migration to api.specs syntax.

0.54.0-rc5

feat: Bump docs-resolvers to 0.0.64 to fix an issue with endpoint-level server parsing.

0.54.0-rc4

fix: Handle comments that include '*/' literal values. This previously caused any generator that uses c-style comments to fail.

0.54.0-rc3

feat: Modify the x-fern-examples extension to support Websocket session examples for AsyncAPI v3 specs.

0.54.0-rc2

feat: Add the x-fern-optional extension to the AsyncAPI v3 parser to allow for optional channel parameters.

chore: Improve the violations summary displayed by fern check and include elapsed time when available.

0.54.0-rc1

fix: Update CLI-side markdown parsing to detect more hrefs and srcs (where src files are automatically uploaded),
enabling the Download me pattern to work.

fix: Update fern docs broken-links to handle links within the current directory.

0.54.0-rc0

fix: Fix issue where the CLI would not parse asyncapi specs within the api.specs array in generators.yml.

feat: Migrate old spec configuration in generators.yml to the api.specs[] format.

feat: Log warnings when old generators.yml syntax is used during parsing.

0.53.18

fix: Fix an issue where de-conflicting message names in AsyncAPI v3 parser would only update subsequent message names,
but not the first occurrence.

0.53.17

fix: Fix an issue with the OpenAPI v2 parser where recursive subpackage slugs would not generate correctly.

0.53.16

fix: Enable x-fern-sdk-group-name extension in AsyncAPI v3 parser.

0.53.15

fix: Disable broken link checker until it is ready to release.

0.53.14

fix: Fixes an issue with the OpenAPI v2 parser where docs configs with no navigation structure would generate incorrect slugs.

0.53.13

fix: Resolve error where fern docs dev failed in Windows environments.

0.53.12

fix: Dynamically deconflict AsyncAPI message names when generating Fern Definition Types to preserve original naming
wherever possible.

0.53.11

fix: Fix an issue with the OpenAPI v2 parser where schemas with single value arrays were being incorrectly parsed.

0.53.10

fix: Support differentiated server URLs in WebSocket channels and correctly generate multi-url environments.

0.53.9

fix: Fix an issue with the OpenAPI v2 parser where incorrect slugs were being generated.

0.53.8

fix: Fix noindex behavior for section overview pages.

0.53.7

fix: Regenerate changelog.

0.53.6

fix: Correctly parse out channel address for v3 AsyncAPI specs.

0.53.5

fix: Support validation schemas in detailed Union types.

0.53.4

fix: Improve error logging on downloadLocalDocsBundle failure.

0.53.3

fix: noindex property in the frontmatter of a page is now implemented for site navigation + llms.txt.

0.53.2

fix: The OpenAPI parser now prefers the source extension set in the OpenAPI spec, and only writes
it if it is not already set.

0.53.1

fix: The OpenAPI v2 parser now parses Server specifications with variables.

0.53.0

feat: Users can now specify the idiomatic-request-names option in the generators.yml to adapt the behavior of the
autogenerated request names. The verb is now in front of the noun (e.g. UsersListRequest becomes ListUsersRequest).

This is disabled by default (for backwards compatibility), and can be enabled with the following:

# generators.yml
api:
  specs:
    - openapi: ./openapi/openapi.json
      settings:
        idiomatic-request-names: true

0.52.0

fix: Introduce the AsyncAPI 3.0.0 parser, which enables conditional parsing of both 2.x and 3.x AsyncAPI specs.

0.51.39

fix: The OpenAPI v2 parser now respects object properties as optional, generates display names for undiscriminated union object
types, and fixes minor issues with docs dev when using specific navigation locators in docs.yml specification.

0.51.38

fix: The OpenAPI v2 parser now ignores optional parameters when generating requests. It also improves upon generation with
better fallback logic for sparse requests.

0.51.37

fix: Fixed handling of Windows filepaths in the docs generator by ensuring consistent path separators and proper absolute path handling.

0.51.36

fix: Type reference example generation now handles extends and base properties correctly, as well as in-lined Alias types.

0.51.35

fix: The cli will now respect examples with null values in OpenAPI specs. This will allow for null properties to show up when using
OpenAPI parser v2.