Skip to content

Releases: Redocly/redocly-cli

@redocly/[email protected]

09 Jul 07:55
0d83150
Compare
Choose a tag to compare
Pre-release

Major Changes

  • Removed support for the legacy Redocly API Registry in favor of the new Reunite platform.
    Reunite provides improved API management capabilities and better integration with Redocly's tooling ecosystem.
    Migrated the login and push commands to work exclusively with Reunite.
    Removed the preview-docs command as part of platform modernization.
    Use the preview command instead.
  • Migrated the codebase to ES Modules from CommonJS, bringing improved code organization and better support for modern JavaScript features.
    Update to Node.js version 20.19.0+, 22.12.0+, or 23+.

Minor Changes

  • Added x-security extension for Respect that enables secure handling of authentication in Arazzo workflows.
    Use this extension to:

    • Define security schemes at the step level using either predefined schemes or inline definitions
    • Pass values of secrets (passwords, tokens, API keys)
    • Support multiple authentication types including API Key (query, header, or cookie), Basic Authentication, Bearer Token, Digest Authentication, OAuth2, and OpenID Connect
    • Automatically transform security parameters into appropriate HTTP headers or query parameters
  • Added new CLI options for the respect command to improve test execution control.

Patch Changes

  • Improved Respect's error handling when server URLs are missing from both OpenAPI descriptions and CLI options.
  • Updated @redocly/openapi-core to v2.0.0-next.0.

@redocly/[email protected]

09 Jul 14:37
6bfa8ec
Compare
Choose a tag to compare
Pre-release

Minor Changes

  • Extracted nullable validation from the struct rule into a new nullable-type-sibling rule for OpenAPI 3.0. This allows users to disable nullable validation separately from other structural checks.
  • Added the no-duplicated-tag-names rule to check for duplications in the tags field in API descriptions.

@redocly/[email protected]

09 Jul 07:55
0d83150
Compare
Choose a tag to compare
Pre-release

Major Changes

  • Removed backward compatibility for the spec rule. Use struct instead.
  • Removed support for the deprecated apiDefinitions option in the Redocly config. Use apis instead.
    Removed the labels field within the apis section, which was associated with the legacy Redocly API Registry product.
  • Removed support for the deprecated features.openapi and features.mockServer configuration options. Use openapi and mockServer directly instead.
  • Removed backward compatibility for the deprecated lint and styleguide options in the Redocly config.
    Use rules, decorators and other related options on the root level instead.
  • Removed the deprecated disallowAdditionalProperties option support in rules. Use allowAdditionalProperties instead.
  • Removed the deprecated undefined assertion. Use defined instead.
  • Removed support for the legacy Redocly API Registry in favor of the new Reunite platform.
    Reunite provides improved API management capabilities and better integration with Redocly's tooling ecosystem.
    Migrated the login and push commands to work exclusively with Reunite.
    Removed the preview-docs command as part of platform modernization.
    Use the preview command instead.
  • Removed support for the deprecated referenceDocs option, which was related to the legacy Reference docs product.
  • Added support for extends bundling and array-based plugin configuration.
    Fixed the extends order in the configuration.
  • Removed support for the deprecated assert/ prefix in configurable rules. Use rule/ prefix instead.
  • Migrated the codebase to ES Modules from CommonJS, bringing improved code organization and better support for modern JavaScript features.
    Update to Node.js version 20.19.0+, 22.12.0+, or 23+.
  • Streamlined Redocly configuration interfaces for improved developer experience.
    Removed StyleguideConfig class in favor of the unified Config class.
    Removed getMergedConfig function - use Config.forAlias() method instead to retrieve API-specific configurations.

Minor Changes

  • Added x-security extension for Respect that enables secure handling of authentication in Arazzo workflows.
    Use this extension to:

    • Define security schemes at the step level using either predefined schemes or inline definitions
    • Pass values of secrets (passwords, tokens, API keys)
    • Support multiple authentication types including API Key (query, header, or cookie), Basic Authentication, Bearer Token, Digest Authentication, OAuth2, and OpenID Connect
    • Automatically transform security parameters into appropriate HTTP headers or query parameters

Patch Changes

  • Fixed an issue where the ignoreLastPathSegment option of the path-segment-plural rule had no effect if the path contained only one segment, resulting in an error.
  • Updated @redocly/config to v0.24.1.
  • Fixed Redocly CLI to correctly read residency from the Redocly configuration file.
  • Fixed incorrect validation logic for the constructor property.

@redocly/[email protected]

09 Jul 14:37
6bfa8ec
Compare
Choose a tag to compare
Pre-release

Minor Changes

  • Extracted nullable validation from the struct rule into a new nullable-type-sibling rule for OpenAPI 3.0. This allows users to disable nullable validation separately from other structural checks.
  • Added the no-duplicated-tag-names rule to check for duplications in the tags field in API descriptions.
  • Implemented automatic masking of sensitive fields (such as tokens and passwords) in response bodies to enhance security and prevent accidental exposure of secrets in logs and outputs.

Patch Changes

  • Updated @redocly/openapi-core to v2.0.0-next.1.

@redocly/[email protected]

09 Jul 07:55
0d83150
Compare
Choose a tag to compare
Pre-release

Major Changes

  • Removed backward compatibility for the spec rule. Use struct instead.
  • Removed support for the deprecated apiDefinitions option in the Redocly config. Use apis instead.
    Removed the labels field within the apis section, which was associated with the legacy Redocly API Registry product.
  • Removed support for the deprecated features.openapi and features.mockServer configuration options. Use openapi and mockServer directly instead.
  • Removed backward compatibility for the deprecated lint and styleguide options in the Redocly config.
    Use rules, decorators and other related options on the root level instead.
  • Removed the deprecated disallowAdditionalProperties option support in rules. Use allowAdditionalProperties instead.
  • Removed the deprecated undefined assertion. Use defined instead.
  • Removed support for the legacy Redocly API Registry in favor of the new Reunite platform.
    Reunite provides improved API management capabilities and better integration with Redocly's tooling ecosystem.
    Migrated the login and push commands to work exclusively with Reunite.
    Removed the preview-docs command as part of platform modernization.
    Use the preview command instead.
  • Removed support for the deprecated referenceDocs option, which was related to the legacy Reference docs product.
  • Removed support for the deprecated assert/ prefix in configurable rules. Use rule/ prefix instead.
  • Migrated the codebase to ES Modules from CommonJS, bringing improved code organization and better support for modern JavaScript features.
    Update to Node.js version 20.19.0+, 22.12.0+, or 23+.

Minor Changes

  • Added x-security extension for Respect that enables secure handling of authentication in Arazzo workflows.
    Use this extension to:

    • Define security schemes at the step level using either predefined schemes or inline definitions
    • Pass values of secrets (passwords, tokens, API keys)
    • Support multiple authentication types including API Key (query, header, or cookie), Basic Authentication, Bearer Token, Digest Authentication, OAuth2, and OpenID Connect
    • Automatically transform security parameters into appropriate HTTP headers or query parameters
  • Added environment variable support for CLI arguments using Yargs .env() method to parse environment variables with matching prefixes.

  • Added new CLI options for the respect command to improve test execution control.

Patch Changes

  • Fixed no-undefined-server-variable crash when encountering null values in the server list.
  • Updated Redoc to v2.5.0.
  • Fixed alias detection when using --config from a different folder than the current working directory.
  • Fixed Redocly CLI to correctly read residency from the Redocly configuration file.
  • Improved Respect's error handling when server URLs are missing from both OpenAPI descriptions and CLI options.
  • Updated @redocly/respect-core to v2.0.0-next.0.

@redocly/[email protected]

27 Jun 13:43
545df72
Compare
Choose a tag to compare

Patch Changes

  • Resolved an issue where [email protected] injected an unintended message into the output.
  • Updated @redocly/openapi-core to v1.34.4.

@redocly/[email protected]

27 Jun 13:43
545df72
Compare
Choose a tag to compare

@redocly/[email protected]

27 Jun 13:43
545df72
Compare
Choose a tag to compare

Patch Changes

  • Resolved an issue where [email protected] injected an unintended message into the output.
  • Updated @redocly/respect-core to v1.34.4.

@redocly/[email protected]

22 Apr 14:02
38e692f
Compare
Choose a tag to compare

Patch Changes

  • Updated @redocly/openapi-core to v1.34.3.

@redocly/[email protected]

22 Apr 14:02
38e692f
Compare
Choose a tag to compare