fix(oas3): modify formatVersion function

Author: Marco Friso

packages/openapi3-parser/lib/parser.js

@@ -4,7 +4,7 @@ const R = require('ramda');
 const parseYAML = require('./parser/parseYAML');
 
 const {
-  isAnnotation, isWarningAnnotation, isObject, isMember, hasKey,
+  isAnnotation, isWarningAnnotation, isObject, isMember, hasKey, isString,
 } = require('./predicates');
 const { createError } = require('./elements');
 const pipeParseResult = require('./pipeParseResult');
@@ -137,24 +137,26 @@ function parse(source, context) {
     document
   );
 
-  if (!isAnnotation(parseResult.content[0])) {
-    const formatVersion = R.pipe(
+  const formatVersion = R.tryCatch(
+    R.pipe(
       R.prop('content'),
       R.find(isObject),
       R.prop('content'),
-      R.find(R.both(isMember, hasKey('openapi')))
-    )(document).toValue().value;
+      R.find(R.both(isMember, hasKey('openapi'))),
+      R.path(['content', 'value']),
+      R.and(isString, R.prop('content'))
+    ), R.always('3.0.3')
+  )(document);
 
-    const formatLink = `https://spec.openapis.org/oas/v${formatVersion}`;
-    const { Link } = context.namespace.elements;
-    const link = new Link();
+  const formatLink = `https://spec.openapis.org/oas/v${formatVersion}`;
+  const { Link } = context.namespace.elements;
+  const link = new Link();
 
-    link.title = `OpenAPI ${formatVersion}`;
-    link.relation = 'via';
-    link.href = formatLink;
+  link.title = `OpenAPI ${formatVersion}`;
+  link.relation = 'via';
+  link.href = formatLink;
 
-    parseResult.links.push(link);
-  }
+  parseResult.links.push(link);
 
   return parseResult;
 }

packages/openapi3-parser/test/unit/parser-test.js

@@ -51,4 +51,15 @@ describe('#parse', () => {
     expect(link.title.toValue()).to.equal('OpenAPI 3.0.0');
     expect(link.href.toValue()).to.equal('https://spec.openapis.org/oas/v3.0.0');
   });
+
+  it('add OpenAPI 3.0.3 format link when fails to parse an OAS3 document', () => {
+    const source = '{}{}';
+    const parseResult = parse(source, context);
+
+    const link = parseResult.links.get(0);
+    expect(link).to.be.instanceof(Link);
+    expect(link.relation.toValue()).to.equal('via');
+    expect(link.title.toValue()).to.equal('OpenAPI 3.0.3');
+    expect(link.href.toValue()).to.equal('https://spec.openapis.org/oas/v3.0.3');
+  });
 });