feat(parser-adapter-openapi-json-3-0): add support for OpenAPI 3.0.4 (#4616)

Refs #4612

Author: char0n

packages/apidom-parser-adapter-openapi-json-3-0/src/adapter.ts

@@ -9,7 +9,7 @@ export { default as mediaTypes } from './media-types.ts';
 /**
  * @public
  */
-export const detectionRegExp = /"openapi"\s*:\s*"(?<version_json>3\.0\.([0123]))"/;
+export const detectionRegExp = /"openapi"\s*:\s*"(?<version_json>3\.0\.(?:[1-9]\d*|0))"/;
 
 /**
  * @public

packages/apidom-parser-adapter-openapi-json-3-0/test/adapter.ts

@@ -21,8 +21,8 @@ describe('adapter', function () {
       assert.isFalse(await adapter.detect('{"openapi": "3.1.0"}'));
     });
 
-    specify('should not detect patch version bump', async function () {
-      assert.isFalse(await adapter.detect('{"openapi": "3.0.4"}'));
+    specify('should detect patch version bump', async function () {
+      assert.isTrue(await adapter.detect('{"openapi": "3.0.24"}'));
     });
 
     specify('should not detect minor and patch version bump', async function () {
@@ -75,8 +75,24 @@ describe('adapter', function () {
   });
 
   context('detectionRegExp', function () {
+    specify('should detect version ranges in forward compatible way', function () {
+      assert.isTrue(adapter.detectionRegExp.test('"openapi": "3.0.0"'));
+      assert.isTrue(adapter.detectionRegExp.test('"openapi": "3.0.1"'));
+      assert.isTrue(adapter.detectionRegExp.test('"openapi": "3.0.2"'));
+      assert.isTrue(adapter.detectionRegExp.test('"openapi": "3.0.3"'));
+      assert.isTrue(adapter.detectionRegExp.test('"openapi": "3.0.4"'));
+      assert.isTrue(adapter.detectionRegExp.test('"openapi": "3.0.5"'));
+      assert.isTrue(adapter.detectionRegExp.test('"openapi": "3.0.6"'));
+      assert.isTrue(adapter.detectionRegExp.test('"openapi": "3.0.145"'));
+    });
+
+    specify('should reject rc version ranges', function () {
+      assert.isFalse(adapter.detectionRegExp.test('"openapi": "3.0.0-rc2"'));
+      assert.isFalse(adapter.detectionRegExp.test('"openapi": "3.0.0-rc1"'));
+      assert.isFalse(adapter.detectionRegExp.test('"openapi": "3.0.0-rc0"'));
+    });
+
     specify('should reject invalid version ranges', function () {
-      assert.isFalse(adapter.detectionRegExp.test('"openapi": "3.0.4"'));
       assert.isFalse(adapter.detectionRegExp.test('"openapi": "3.1.145"'));
       assert.isFalse(adapter.detectionRegExp.test('"openapi": "3.1.0"'));
       assert.isFalse(adapter.detectionRegExp.test('"openapi": "3.01.0"'));

packages/apidom-parser-adapter-openapi-json-3-0/test/fixtures/sample-api.json

@@ -1,5 +1,5 @@
 {
-  "openapi": "3.0.3",
+  "openapi": "3.0.4",
   "info": {
     "title": "Sample Pet Store App",
     "description": "This is a sample server for a pet store.",

packages/apidom-parser-adapter-openapi-json-3-0/test/fixtures/sample-api.yaml

@@ -1,5 +1,5 @@
 ---
-openapi: 3.0.3
+openapi: 3.0.4
 info:
   title: Sample Pet Store App
   description: This is a sample server for a pet store.

packages/apidom-parser-adapter-openapi-json-3-0/test/media-types.ts

@@ -6,6 +6,14 @@ import * as openApiJsonAdapter from '../src/adapter.ts';
 describe('given adapter is used in parser', function () {
   const parser = new ApiDOMParser().use(openApiJsonAdapter);
 
+  context('given OpenAPI 3.0.4 definition in JSON format', function () {
+    specify('should find appropriate media type', async function () {
+      const mediaType = await parser.findMediaType('{"openapi": "3.0.4"}');
+
+      assert.strictEqual(mediaType, 'application/vnd.oai.openapi+json;version=3.0.4');
+    });
+  });
+
   context('given OpenAPI 3.0.3 definition in JSON format', function () {
     specify('should find appropriate media type', async function () {
       const mediaType = await parser.findMediaType('{"openapi": "3.0.3"}');
@@ -38,9 +46,25 @@ describe('given adapter is used in parser', function () {
     });
   });
 
-  context('given OpenAPI 3.0.3-rc3 definition in JSON format', function () {
+  context('given OpenAPI 3.0.0-rc2 definition in JSON format', function () {
+    specify('should not find appropriate media type', async function () {
+      const mediaType = await parser.findMediaType('{"openapi": "3.0.0-rc2"}');
+
+      assert.strictEqual(mediaType, 'application/octet-stream');
+    });
+  });
+
+  context('given OpenAPI 3.0.0-rc1 definition in JSON format', function () {
+    specify('should not find appropriate media type', async function () {
+      const mediaType = await parser.findMediaType('{"openapi": "3.0.0-rc1"}');
+
+      assert.strictEqual(mediaType, 'application/octet-stream');
+    });
+  });
+
+  context('given OpenAPI 3.0.0-rc0 definition in JSON format', function () {
     specify('should not find appropriate media type', async function () {
-      const mediaType = await parser.findMediaType('{"openapi": "3.0.3-rc3"}');
+      const mediaType = await parser.findMediaType('{"openapi": "3.0.0-rc0"}');
 
       assert.strictEqual(mediaType, 'application/octet-stream');
     });