Releases: Redocly/redocly-cli
Releases · Redocly/redocly-cli
@redocly/[email protected]
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 thelogin
andpush
commands to work exclusively with Reunite.
Removed thepreview-docs
command as part of platform modernization.
Use thepreview
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]
Minor Changes
- Extracted
nullable
validation from thestruct
rule into a newnullable-type-sibling
rule for OpenAPI 3.0. This allows users to disablenullable
validation separately from other structural checks. - Added the
no-duplicated-tag-names
rule to check for duplications in thetags
field in API descriptions.
@redocly/[email protected]
Major Changes
- Removed backward compatibility for the
spec
rule. Usestruct
instead. - Removed support for the deprecated
apiDefinitions
option in the Redocly config. Useapis
instead.
Removed thelabels
field within theapis
section, which was associated with the legacy Redocly API Registry product. - Removed support for the deprecated
features.openapi
andfeatures.mockServer
configuration options. Useopenapi
andmockServer
directly instead. - Removed backward compatibility for the deprecated
lint
andstyleguide
options in the Redocly config.
Userules
,decorators
and other related options on the root level instead. - Removed the deprecated
disallowAdditionalProperties
option support in rules. UseallowAdditionalProperties
instead. - Removed the deprecated
undefined
assertion. Usedefined
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 thelogin
andpush
commands to work exclusively with Reunite.
Removed thepreview-docs
command as part of platform modernization.
Use thepreview
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. Userule/
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.
RemovedStyleguideConfig
class in favor of the unifiedConfig
class.
RemovedgetMergedConfig
function - useConfig.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 thepath-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]
Minor Changes
- Extracted
nullable
validation from thestruct
rule into a newnullable-type-sibling
rule for OpenAPI 3.0. This allows users to disablenullable
validation separately from other structural checks. - Added the
no-duplicated-tag-names
rule to check for duplications in thetags
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]
Major Changes
- Removed backward compatibility for the
spec
rule. Usestruct
instead. - Removed support for the deprecated
apiDefinitions
option in the Redocly config. Useapis
instead.
Removed thelabels
field within theapis
section, which was associated with the legacy Redocly API Registry product. - Removed support for the deprecated
features.openapi
andfeatures.mockServer
configuration options. Useopenapi
andmockServer
directly instead. - Removed backward compatibility for the deprecated
lint
andstyleguide
options in the Redocly config.
Userules
,decorators
and other related options on the root level instead. - Removed the deprecated
disallowAdditionalProperties
option support in rules. UseallowAdditionalProperties
instead. - Removed the deprecated
undefined
assertion. Usedefined
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 thelogin
andpush
commands to work exclusively with Reunite.
Removed thepreview-docs
command as part of platform modernization.
Use thepreview
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. Userule/
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 encounteringnull
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]
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]
@redocly/[email protected]
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]
Patch Changes
- Updated @redocly/openapi-core to v1.34.3.