Merge branch 'main' into add-asyncapi-rule

Author: harshit078

.changeset/young-eggs-beam.md

@@ -7,6 +7,20 @@ toc:
 
 <!-- do-not-remove -->
 
+## 2.30.5 (2026-05-12)
+
+### Patch Changes
+
+- Fixed a status code mismatch that occurred when using the `--har-output` option in the `respect` command.
+- Updated @redocly/openapi-core to v2.30.5.
+
+## 2.30.4 (2026-05-06)
+
+### Patch Changes
+
+- Updated `styled-components` dependency to `6.4.1`.
+- Updated @redocly/openapi-core to v2.30.4.
+
 ## 2.30.3 (2026-04-29)
 
 ### Patch Changes

docs/@v2/changelog.md

@@ -47,6 +47,7 @@ A minimum of one assertion property is required to be defined.
 | --------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | casing                      | string            | Asserts a casing style. Supported styles are: `camelCase`, `kebab-case`, `snake_case`, `PascalCase`, `MACRO_CASE`, `COBOL-CASE`, `flatcase`. See [casing example](#casing-example).                                                                                                                                                                                                                      |
 | const                       | string            | Asserts equality of a value. The behavior is the same as the `enum` assertion with exactly one value. See [const example](#const-example).                                                                                                                                                                                                                                                               |
+| contains                    | [string]          | Asserts that all listed strings are included in the value array. See [contains example](#contains-example).                                                                                                                                                                                                                                                                                              |
 | defined                     | boolean           | Asserts a property is defined. See [defined example](#defined-example).                                                                                                                                                                                                                                                                                                                                  |
 | disallowed                  | [string]          | Asserts all listed values are not defined. See [disallowed example](#disallowed-example).                                                                                                                                                                                                                                                                                                                |
 | enum                        | [string]          | Asserts a value is within a predefined list of values. Providing a single value in a list is an equality check. See [enum example](#enum-example).                                                                                                                                                                                                                                                       |
@@ -315,6 +316,32 @@ rules:
     message: Only application/json can be used
 ```
 
+### `contains` example
+
+Use `contains` to assert that every listed string appears as an element of a **string array** property (for example, the `required` field of a `Schema`).
+This differs from `required`, which checks for **object keys** rather than array values.
+
+The following example asserts that the `required` array of every schema includes both `page` and `items`.
+
+```yaml Response example
+rules:
+  rule/list-schema-required-fields:
+    subject:
+      type: Schema
+      property: required
+    where:
+      - subject:
+          type: Schema
+          property: properties
+        assertions:
+          defined: true
+    message: 'List schemas must include "page" and "items" in the required array'
+    assertions:
+      contains:
+        - page
+        - items
+```
+
 ### `defined` example
 
 The following example asserts that `x-codeSamples` is defined.

docs/@v2/rules/configurable-rules.md

@@ -1,5 +1,19 @@
 # @redocly/cli
 
+## 2.30.5
+
+### Patch Changes
+
+- Fixed a status code mismatch that occurred when using the `--har-output` option in the `respect` command.
+- Updated @redocly/openapi-core to v2.30.5.
+
+## 2.30.4
+
+### Patch Changes
+
+- Updated `styled-components` dependency to `6.4.1`.
+- Updated @redocly/openapi-core to v2.30.4.
+
 ## 2.30.3
 
 ### Patch Changes

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@redocly/cli",
-  "version": "2.30.3",
+  "version": "2.30.5",
   "description": "",
   "license": "MIT",
   "bin": {
@@ -43,8 +43,8 @@
     "@opentelemetry/sdk-trace-node": "2.6.1",
     "@opentelemetry/semantic-conventions": "1.40.0",
     "@redocly/cli-otel": "0.1.2",
-    "@redocly/openapi-core": "2.30.3",
-    "@redocly/respect-core": "2.30.3",
+    "@redocly/openapi-core": "2.30.5",
+    "@redocly/respect-core": "2.30.5",
     "ajv": "npm:@redocly/ajv@8.18.1",
     "ajv-formats": "^3.0.1",
     "colorette": "^1.2.0",

packages/cli/CHANGELOG.md

@@ -0,0 +1,53 @@
+import { createHarLog } from '../../../../commands/respect/har-logs/har-logs.js';
+import { withHar } from '../../../../commands/respect/har-logs/with-har.js';
+
+describe('withHar', () => {
+  it('should preserve the original response status', async () => {
+    const har = createHarLog({ version: '1.0.0' });
+    const dispatcher = { on: vi.fn() };
+    const originalResponse = new Response(JSON.stringify({ created: true }), {
+      status: 201,
+      statusText: 'Created',
+      headers: { 'content-type': 'application/json' },
+    });
+    const baseFetch = vi.fn(async () => {
+      return originalResponse;
+    });
+
+    const fetch = withHar(baseFetch as any, { har });
+    const response = await fetch('https://example.com/resources', {
+      method: 'POST',
+      dispatcher,
+    });
+
+    expect(response).toBe(originalResponse);
+    expect(response.status).toBe(201);
+    expect(response.statusText).toBe('Created');
+    expect(await response.json()).toEqual({ created: true });
+    expect(har.log.entries[0].response.status).toBe(201);
+  });
+
+  it('should return a bodyless response for no-content statuses', async () => {
+    const har = createHarLog({ version: '1.0.0' });
+    const dispatcher = { on: vi.fn() };
+    const originalResponse = new Response(null, {
+      status: 204,
+      statusText: 'No Content',
+    });
+    const baseFetch = vi.fn(async () => {
+      return originalResponse;
+    });
+
+    const fetch = withHar(baseFetch as any, { har });
+    const response = await fetch('https://example.com/resources', {
+      method: 'POST',
+      dispatcher,
+    });
+
+    expect(response).toBe(originalResponse);
+    expect(response.status).toBe(204);
+    expect(response.statusText).toBe('No Content');
+    expect(await response.text()).toBe('');
+    expect(har.log.entries[0].response.status).toBe(204);
+  });
+});

packages/cli/package.json

@@ -110,14 +110,15 @@ export const withHar: WithHar = function <T extends typeof fetch>(
     // Make the request
     const response = await baseFetch(input, options);
 
-    // Need to clone response to get both text and arrayBuffer
-    const responseClone = response.clone();
+    // Read from clones so HAR logging does not consume or reconstruct the real response.
+    const responseTextClone = response.clone();
+    const responseBufferClone = response.clone();
 
     // Update firstByte time when we get the response
     entry._timestamps.firstByte = process.hrtime();
 
     // Get the response body and update received time
-    const text = await response.text();
+    const text = response.body === null ? '' : await responseTextClone.text();
     entry._timestamps.received = process.hrtime();
 
     const harEntry = harEntryMap.get(requestId);
@@ -149,7 +150,7 @@ export const withHar: WithHar = function <T extends typeof fetch>(
     }
 
     if (harEntry._compressed) {
-      const rawBody = await responseClone.arrayBuffer();
+      const rawBody = await responseBufferClone.arrayBuffer();
       harEntry.response.content.size = rawBody.byteLength;
     } else {
       harEntry.response.content.size = text ? Buffer.byteLength(text) : -1;
@@ -211,15 +212,7 @@ export const withHar: WithHar = function <T extends typeof fetch>(
       parent.pageref = entry.pageref;
     });
 
-    const Response =
-      defaults.Response || baseFetch.Response || global.Response || response.constructor;
-    const responseCopy = new Response(text, {
-      status: response.statusCode,
-      statusText: response.statusText || '',
-      headers: response.headers,
-      url: response.url,
-    });
-    responseCopy.harEntry = entry;
+    response.harEntry = entry;
 
     if (Array.isArray(har?.log?.entries)) {
       har.log.entries.push(...parents, entry);
@@ -232,6 +225,6 @@ export const withHar: WithHar = function <T extends typeof fetch>(
       onHarEntry(entry);
     }
 
-    return responseCopy;
+    return response;
   } as T;
 };

packages/cli/src/__tests__/commands/respect/har-logs/with-har.test.ts

@@ -1,5 +1,17 @@
 # @redocly/openapi-core
 
+## 2.30.5
+
+### Patch Changes
+
+- Fixed an issue where using environment variables in `redocly.yaml` caused a config validation error during the build.
+
+## 2.30.4
+
+### Patch Changes
+
+- Added `contains` assertion to check that all listed strings are present in an array property.
+
 ## 2.30.3
 
 ### Patch Changes

packages/cli/src/commands/respect/har-logs/with-har.ts

@@ -1,6 +1,6 @@
 {
   "name": "@redocly/openapi-core",
-  "version": "2.30.3",
+  "version": "2.30.5",
   "description": "",
   "type": "module",
   "types": "lib/index.d.ts",