@scalar/openapi-parser 0.10.16 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @scalar/openapi-parser
 
+## 0.11.0
+
+### Minor Changes
+
+- 483ca93: chore: require Node 20 (or above)
+
+### Patch Changes
+
+- bd602d3: chore: mark pipeline syntax as deprecated
+- 1d1470c: feat: speed up the upgrade utility
+
+## 0.10.17
+
+### Patch Changes
+
+- 8c7bad8: chore: move build tooling to esbuild
+
 ## 0.10.16
 
 ### Patch Changes

package/README.md

@@ -7,14 +7,6 @@
 
 Modern OpenAPI parser written in TypeScript with support for OpenAPI 3.1, OpenAPI 3.0 and Swagger 2.0.
 
-## Goals
-
-- [x] Written in TypeScript
-- [x] Runs in Node.js and in the browser (without any polyfills or configuration)
-- [x] Tested with hundreds of real world examples
-- [ ] Amazing error output
-- [ ] Support for OpenAPI 4.0 👀
-
 ## Installation
 
 ```bash
@@ -140,25 +132,6 @@ const result = sanitize({
 console.log(result)
 ```
 
-### Pipeline syntax
-
-```ts
-import { openapi } from '@scalar/openapi-parser'
-
-const specification = …
-
-// New pipeline …
-const result = openapi()
-  // loads the specification …
-  .load(specification)
-  // upgrades to OpenAPI 3.1 …
-  .upgrade()
-  // removes all internal operations …
-  .filter((schema) => !schema?.['x-internal'])
-  // done!
-  .get()
-```
-
 ### Then/Catch syntax
 
 If you’re more the then/catch type of guy, that’s fine:

package/dist/configuration/index.js

@@ -1,27 +1,24 @@
-import Swagger20 from '../schemas/v2.0/schema.json.js';
-import OpenApi30 from '../schemas/v3.0/schema.json.js';
-import OpenApi31 from '../schemas/v3.1/schema.json.js';
-
-/**
- * A list of the supported OpenAPI specifications
- */
+import Swagger20 from "../schemas/v2.0/schema.js";
+import OpenApi30 from "../schemas/v3.0/schema.js";
+import OpenApi31 from "../schemas/v3.1/schema.js";
 const OpenApiSpecifications = {
-    '2.0': Swagger20,
-    '3.0': OpenApi30,
-    '3.1': OpenApi31,
+  "2.0": Swagger20,
+  "3.0": OpenApi30,
+  "3.1": OpenApi31
 };
 const OpenApiVersions = Object.keys(OpenApiSpecifications);
-/**
- * List of error messages used in the Validator
- */
 const ERRORS = {
-    EMPTY_OR_INVALID: 'Can’t find JSON, YAML or filename in data',
-    // URI_MUST_BE_STRING: 'uri parameter or $id attribute must be a string',
-    OPENAPI_VERSION_NOT_SUPPORTED: 'Can’t find supported Swagger/OpenAPI version in specification, version must be a string.',
-    INVALID_REFERENCE: 'Can’t resolve reference: %s',
-    EXTERNAL_REFERENCE_NOT_FOUND: 'Can’t resolve external reference: %s',
-    FILE_DOES_NOT_EXIST: 'File does not exist: %s',
-    NO_CONTENT: 'No content found',
+  EMPTY_OR_INVALID: "Can\u2019t find JSON, YAML or filename in data",
+  // URI_MUST_BE_STRING: 'uri parameter or $id attribute must be a string',
+  OPENAPI_VERSION_NOT_SUPPORTED: "Can\u2019t find supported Swagger/OpenAPI version in specification, version must be a string.",
+  INVALID_REFERENCE: "Can\u2019t resolve reference: %s",
+  EXTERNAL_REFERENCE_NOT_FOUND: "Can\u2019t resolve external reference: %s",
+  FILE_DOES_NOT_EXIST: "File does not exist: %s",
+  NO_CONTENT: "No content found"
 };
-
-export { ERRORS, OpenApiSpecifications, OpenApiVersions };
+export {
+  ERRORS,
+  OpenApiSpecifications,
+  OpenApiVersions
+};
+//# sourceMappingURL=index.js.map

package/dist/configuration/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/configuration/index.ts"],
+  "sourcesContent": ["import Swagger20 from '../schemas/v2.0/schema'\nimport OpenApi30 from '../schemas/v3.0/schema'\nimport OpenApi31 from '../schemas/v3.1/schema'\n\n/**\n * A list of the supported OpenAPI specifications\n */\nexport const OpenApiSpecifications = {\n  '2.0': Swagger20,\n  '3.0': OpenApi30,\n  '3.1': OpenApi31,\n}\n\nexport type OpenApiVersion = keyof typeof OpenApiSpecifications\n\nexport const OpenApiVersions = Object.keys(OpenApiSpecifications) as OpenApiVersion[]\n\n/**\n * List of error messages used in the Validator\n */\nexport const ERRORS = {\n  EMPTY_OR_INVALID: 'Can\u2019t find JSON, YAML or filename in data',\n  // URI_MUST_BE_STRING: 'uri parameter or $id attribute must be a string',\n  OPENAPI_VERSION_NOT_SUPPORTED:\n    'Can\u2019t find supported Swagger/OpenAPI version in specification, version must be a string.',\n  INVALID_REFERENCE: 'Can\u2019t resolve reference: %s',\n  EXTERNAL_REFERENCE_NOT_FOUND: 'Can\u2019t resolve external reference: %s',\n  FILE_DOES_NOT_EXIST: 'File does not exist: %s',\n  NO_CONTENT: 'No content found',\n} as const\n\nexport type ValidationError = keyof typeof ERRORS\n"],
+  "mappings": "AAAA,OAAO,eAAe;AACtB,OAAO,eAAe;AACtB,OAAO,eAAe;AAKf,MAAM,wBAAwB;AAAA,EACnC,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AACT;AAIO,MAAM,kBAAkB,OAAO,KAAK,qBAAqB;AAKzD,MAAM,SAAS;AAAA,EACpB,kBAAkB;AAAA;AAAA,EAElB,+BACE;AAAA,EACF,mBAAmB;AAAA,EACnB,8BAA8B;AAAA,EAC9B,qBAAqB;AAAA,EACrB,YAAY;AACd;",
+  "names": []
+}

package/dist/declarations.d.js

@@ -0,0 +1 @@
+//# sourceMappingURL=declarations.d.js.map

package/dist/declarations.d.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export * from './configuration/index.ts';
-export * from './lib/Validator/index.ts';
-export * from './types/index.ts';
-export * from './utils/index.ts';
+export * from './configuration/index.js';
+export * from './lib/Validator/index.js';
+export * from './types/index.js';
+export * from './utils/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA"}

package/dist/index.js

@@ -1,29 +1,5 @@
-export { ERRORS, OpenApiSpecifications, OpenApiVersions } from './configuration/index.js';
-export { Validator, jsonSchemaVersions } from './lib/Validator/Validator.js';
-export { resolveReferences } from './utils/resolveReferences.js';
-export { dereference } from './utils/dereference.js';
-export { details } from './utils/details.js';
-export { escapeJsonPointer } from './utils/escapeJsonPointer.js';
-export { filter } from './utils/filter.js';
-export { getEntrypoint } from './utils/getEntrypoint.js';
-export { getListOfReferences } from './utils/getListOfReferences.js';
-export { getSegmentsFromPath } from './utils/getSegmentsFromPath.js';
-export { isFilesystem } from './utils/isFilesystem.js';
-export { isJson } from './utils/isJson.js';
-export { isObject } from './utils/isObject.js';
-export { isYaml } from './utils/isYaml.js';
-export { load } from './utils/load/load.js';
-export { normalize } from './utils/normalize.js';
-export { openapi } from './utils/openapi/openapi.js';
-export { toJson } from './utils/toJson.js';
-export { toYaml } from './utils/toYaml.js';
-export { transformErrors } from './utils/transformErrors.js';
-export { traverse } from './utils/traverse.js';
-export { unescapeJsonPointer } from './utils/unescapeJsonPointer.js';
-export { upgrade } from './utils/upgrade.js';
-export { isSchemaPath, upgradeFromThreeToThreeOne } from './utils/upgradeFromThreeToThreeOne.js';
-export { upgradeFromTwoToThree } from './utils/upgradeFromTwoToThree.js';
-export { validate } from './utils/validate.js';
-export { DEFAULT_OPENAPI_VERSION } from './utils/transform/utils/addLatestOpenApiVersion.js';
-export { DEFAULT_TITLE, DEFAULT_VERSION } from './utils/transform/utils/addInfoObject.js';
-export { sanitize } from './utils/transform/sanitize.js';
+export * from "./configuration/index.js";
+export * from "./lib/Validator/index.js";
+export * from "./types/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["export * from './configuration/index'\nexport * from './lib/Validator/index'\nexport * from './types/index'\nexport * from './utils/index'\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/lib/Validator/Validator.d.ts

@@ -1,7 +1,7 @@
 import Ajv04 from 'ajv-draft-04';
 import Ajv2020 from 'ajv/dist/2020.js';
-import { type OpenApiVersion } from '../../configuration/index.ts';
-import type { AnyObject, Filesystem, ThrowOnErrorOption, ValidateResult } from '../../types/index.ts';
+import { type OpenApiVersion } from '../../configuration/index.js';
+import type { AnyObject, Filesystem, ThrowOnErrorOption, ValidateResult } from '../../types/index.js';
 /**
  * Configure available JSON Schema versions
  */

package/dist/lib/Validator/Validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Validator.d.ts","sourceRoot":"","sources":["../../../src/lib/Validator/Validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,cAAc,CAAA;AAEhC,OAAO,OAAO,MAAM,kBAAkB,CAAA;AAEtC,OAAO,EAAiC,KAAK,cAAc,EAAmB,MAAM,8BAA8B,CAAA;AAClH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAKrG;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;CAG9B,CAAA;AAED,qBAAa,SAAS;IACb,OAAO,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAA;IAErC,OAAc,iBAAiB,4BAAkB;IAGjD,SAAS,CAAC,aAAa,EAAE,MAAM,CAC7B,MAAM,EACN,CAAC,CAAC,aAAa,EAAE,SAAS,KAAK,OAAO,CAAC,GAAG;QACxC,MAAM,EAAE,MAAM,CAAA;KACf,CACF,CAAK;IAEN,SAAS,CAAC,MAAM,EAAE,MAAM,CAAA;IAExB,SAAS,CAAC,oBAAoB,EAAE,MAAM,CAAA;IAEtC,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAE5B,aAAa,EAAE,SAAS,CAAA;IAE/B;;OAEG;IACG,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAoF7F;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,cAAc;CA+B9C"}
+{"version":3,"file":"Validator.d.ts","sourceRoot":"","sources":["../../../src/lib/Validator/Validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,cAAc,CAAA;AAEhC,OAAO,OAAO,MAAM,kBAAkB,CAAA;AAEtC,OAAO,EAAiC,KAAK,cAAc,EAAmB,MAAM,2BAA2B,CAAA;AAC/G,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAKlG;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;CAG9B,CAAA;AAED,qBAAa,SAAS;IACb,OAAO,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAA;IAErC,OAAc,iBAAiB,4BAAkB;IAGjD,SAAS,CAAC,aAAa,EAAE,MAAM,CAC7B,MAAM,EACN,CAAC,CAAC,aAAa,EAAE,SAAS,KAAK,OAAO,CAAC,GAAG;QACxC,MAAM,EAAE,MAAM,CAAA;KACf,CACF,CAAK;IAEN,SAAS,CAAC,MAAM,EAAE,MAAM,CAAA;IAExB,SAAS,CAAC,oBAAoB,EAAE,MAAM,CAAA;IAEtC,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAE5B,aAAa,EAAE,SAAS,CAAA;IAE/B;;OAEG;IACG,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAoF7F;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,cAAc;CA8B9C"}

package/dist/lib/Validator/Validator.js

@@ -1,128 +1,108 @@
-import Ajv04 from 'ajv-draft-04';
-import addFormats from 'ajv-formats';
-import Ajv2020 from 'ajv/dist/2020.js';
-import { OpenApiVersions, ERRORS, OpenApiSpecifications } from '../../configuration/index.js';
-import { details } from '../../utils/details.js';
-import { resolveReferences } from '../../utils/resolveReferences.js';
-import { transformErrors } from '../../utils/transformErrors.js';
-
-/**
- * Configure available JSON Schema versions
- */
+import Ajv04 from "ajv-draft-04";
+import addFormats from "ajv-formats";
+import Ajv2020 from "ajv/dist/2020.js";
+import { ERRORS, OpenApiSpecifications, OpenApiVersions } from "../../configuration/index.js";
+import { details as getOpenApiVersion } from "../../utils/details.js";
+import { resolveReferences } from "../../utils/resolveReferences.js";
+import { transformErrors } from "../../utils/transformErrors.js";
 const jsonSchemaVersions = {
-    'http://json-schema.org/draft-04/schema#': Ajv04,
-    'https://json-schema.org/draft/2020-12/schema': Ajv2020,
+  "http://json-schema.org/draft-04/schema#": Ajv04,
+  "https://json-schema.org/draft/2020-12/schema": Ajv2020
 };
 class Validator {
-    version;
-    static supportedVersions = OpenApiVersions;
-    // Object with function *or* object { errors: string }
-    ajvValidators = {};
-    errors;
-    specificationVersion;
-    specificationType;
-    specification;
-    /**
-     * Checks whether a specification is valid and all references can be resolved.
-     */
-    async validate(filesystem, options) {
-        const entrypoint = filesystem.find((file) => file.isEntrypoint);
-        const specification = entrypoint?.specification;
-        // TODO: How does this work with a filesystem?
-        this.specification = specification;
-        // TODO: defaulting info.version to keep parser compatible with the previous one
-        // we should bubble this error up and not throw on it
-        if (this.specification?.info && !this.specification.info.version) {
-            this.specification.info.version = '0.0.1';
+  version;
+  static supportedVersions = OpenApiVersions;
+  // Object with function *or* object { errors: string }
+  ajvValidators = {};
+  errors;
+  specificationVersion;
+  specificationType;
+  specification;
+  /**
+   * Checks whether a specification is valid and all references can be resolved.
+   */
+  async validate(filesystem, options) {
+    const entrypoint = filesystem.find((file) => file.isEntrypoint);
+    const specification = entrypoint?.specification;
+    this.specification = specification;
+    if (this.specification?.info && !this.specification.info.version) {
+      this.specification.info.version = "0.0.1";
+    }
+    try {
+      if (specification === void 0 || specification === null) {
+        if (options?.throwOnError) {
+          throw new Error(ERRORS.EMPTY_OR_INVALID);
         }
-        try {
-            // AnyObject is empty or invalid
-            if (specification === undefined || specification === null) {
-                if (options?.throwOnError) {
-                    throw new Error(ERRORS.EMPTY_OR_INVALID);
-                }
-                return {
-                    valid: false,
-                    errors: transformErrors(entrypoint, ERRORS.EMPTY_OR_INVALID),
-                };
-            }
-            // Meta data about the specification
-            const { version, specificationType, specificationVersion } = details(specification);
-            this.version = version;
-            this.specificationVersion = specificationVersion;
-            this.specificationType = specificationType;
-            // AnyObject is not supported
-            if (!version) {
-                if (options?.throwOnError) {
-                    throw new Error(ERRORS.OPENAPI_VERSION_NOT_SUPPORTED);
-                }
-                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);
-            // Error handling
-            if (validateSchema.errors) {
-                if (validateSchema.errors.length > 0) {
-                    if (options?.throwOnError) {
-                        throw new Error(validateSchema.errors[0]);
-                    }
-                    return {
-                        valid: false,
-                        errors: transformErrors(entrypoint, validateSchema.errors),
-                    };
-                }
-            }
-            // Check if the references are valid
-            const resolvedReferences = resolveReferences(filesystem, options);
-            return {
-                valid: schemaResult && resolvedReferences.valid,
-                errors: [...(schemaResult.errors ?? []), ...resolvedReferences.errors],
-                schema: resolvedReferences.schema,
-            };
+        return {
+          valid: false,
+          errors: transformErrors(entrypoint, ERRORS.EMPTY_OR_INVALID)
+        };
+      }
+      const { version, specificationType, specificationVersion } = getOpenApiVersion(specification);
+      this.version = version;
+      this.specificationVersion = specificationVersion;
+      this.specificationType = specificationType;
+      if (!version) {
+        if (options?.throwOnError) {
+          throw new Error(ERRORS.OPENAPI_VERSION_NOT_SUPPORTED);
         }
-        catch (error) {
-            // Something went horribly wrong!
-            if (options?.throwOnError) {
-                throw error;
-            }
-            return {
-                valid: false,
-                errors: transformErrors(entrypoint, error.message ?? error),
-            };
+        return {
+          valid: false,
+          errors: transformErrors(entrypoint, ERRORS.OPENAPI_VERSION_NOT_SUPPORTED)
+        };
+      }
+      const validateSchema = await this.getAjvValidator(version);
+      const schemaResult = validateSchema(specification);
+      if (validateSchema.errors) {
+        if (validateSchema.errors.length > 0) {
+          if (options?.throwOnError) {
+            throw new Error(validateSchema.errors[0]);
+          }
+          return {
+            valid: false,
+            errors: transformErrors(entrypoint, validateSchema.errors)
+          };
         }
+      }
+      const resolvedReferences = resolveReferences(filesystem, options);
+      return {
+        valid: schemaResult && resolvedReferences.valid,
+        errors: [...schemaResult.errors ?? [], ...resolvedReferences.errors],
+        schema: resolvedReferences.schema
+      };
+    } catch (error) {
+      if (options?.throwOnError) {
+        throw error;
+      }
+      return {
+        valid: false,
+        errors: transformErrors(entrypoint, error.message ?? error)
+      };
     }
-    /**
-     * Ajv JSON schema validator
-     */
-    async getAjvValidator(version) {
-        // Schema loaded already
-        if (this.ajvValidators[version]) {
-            return this.ajvValidators[version];
-        }
-        // Load OpenAPI Schema
-        const schema = OpenApiSpecifications[version];
-        // 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
-        // @ts-expect-error ajv-formats is not well typed
-        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));
+  }
+  /**
+   * Ajv JSON schema validator
+   */
+  async getAjvValidator(version) {
+    if (this.ajvValidators[version]) {
+      return this.ajvValidators[version];
     }
+    const schema = OpenApiSpecifications[version];
+    const AjvClass = jsonSchemaVersions[schema.$schema];
+    const ajv = new AjvClass({
+      // Ajv is a bit too strict in its strict validation of OpenAPI schemas.
+      // Switch strict mode off.
+      strict: false
+    });
+    addFormats(ajv);
+    if (version === "3.1") {
+      ajv.addFormat("media-range", true);
+    }
+    return this.ajvValidators[version] = ajv.compile(schema);
+  }
 }
-
-export { Validator, jsonSchemaVersions };
+export {
+  Validator,
+  jsonSchemaVersions
+};
+//# sourceMappingURL=Validator.js.map

package/dist/lib/Validator/Validator.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/Validator/Validator.ts"],
+  "sourcesContent": ["import Ajv04 from 'ajv-draft-04'\nimport addFormats from 'ajv-formats'\nimport Ajv2020 from 'ajv/dist/2020.js'\n\nimport { ERRORS, OpenApiSpecifications, type OpenApiVersion, OpenApiVersions } from '../../configuration/index'\nimport type { AnyObject, Filesystem, ThrowOnErrorOption, ValidateResult } from '../../types/index'\nimport { details as getOpenApiVersion } from '../../utils/details'\nimport { resolveReferences } from '../../utils/resolveReferences'\nimport { transformErrors } from '../../utils/transformErrors'\n\n/**\n * Configure available JSON Schema versions\n */\nexport const jsonSchemaVersions = {\n  'http://json-schema.org/draft-04/schema#': Ajv04,\n  'https://json-schema.org/draft/2020-12/schema': Ajv2020,\n}\n\nexport class Validator {\n  public version: '2.0' | '3.0' | '3.1'\n\n  public static supportedVersions = OpenApiVersions\n\n  // Object with function *or* object { errors: string }\n  protected ajvValidators: Record<\n    string,\n    ((specification: AnyObject) => boolean) & {\n      errors: string\n    }\n  > = {}\n\n  protected errors: string\n\n  protected specificationVersion: string\n\n  protected specificationType: string\n\n  public specification: AnyObject\n\n  /**\n   * Checks whether a specification is valid and all references can be resolved.\n   */\n  async validate(filesystem: Filesystem, options?: ThrowOnErrorOption): Promise<ValidateResult> {\n    const entrypoint = filesystem.find((file) => file.isEntrypoint)\n    const specification = entrypoint?.specification\n\n    // TODO: How does this work with a filesystem?\n    this.specification = specification\n\n    // TODO: defaulting info.version to keep parser compatible with the previous one\n    // we should bubble this error up and not throw on it\n    if (this.specification?.info && !this.specification.info.version) {\n      this.specification.info.version = '0.0.1'\n    }\n\n    try {\n      // AnyObject is empty or invalid\n      if (specification === undefined || specification === null) {\n        if (options?.throwOnError) {\n          throw new Error(ERRORS.EMPTY_OR_INVALID)\n        }\n\n        return {\n          valid: false,\n          errors: transformErrors(entrypoint, ERRORS.EMPTY_OR_INVALID),\n        }\n      }\n\n      // Meta data about the specification\n      const { version, specificationType, specificationVersion } = getOpenApiVersion(specification)\n\n      this.version = version\n      this.specificationVersion = specificationVersion\n      this.specificationType = specificationType\n\n      // AnyObject is not supported\n      if (!version) {\n        if (options?.throwOnError) {\n          throw new Error(ERRORS.OPENAPI_VERSION_NOT_SUPPORTED)\n        }\n\n        return {\n          valid: false,\n          errors: transformErrors(entrypoint, ERRORS.OPENAPI_VERSION_NOT_SUPPORTED),\n        }\n      }\n\n      // Get the correct OpenAPI validator\n      const validateSchema = await this.getAjvValidator(version)\n      const schemaResult = validateSchema(specification)\n\n      // Error handling\n      if (validateSchema.errors) {\n        if (validateSchema.errors.length > 0) {\n          if (options?.throwOnError) {\n            throw new Error(validateSchema.errors[0])\n          }\n\n          return {\n            valid: false,\n            errors: transformErrors(entrypoint, validateSchema.errors),\n          }\n        }\n      }\n\n      // Check if the references are valid\n      const resolvedReferences = resolveReferences(filesystem, options)\n\n      return {\n        valid: schemaResult && resolvedReferences.valid,\n        errors: [...(schemaResult.errors ?? []), ...resolvedReferences.errors],\n        schema: resolvedReferences.schema,\n      }\n    } catch (error) {\n      // Something went horribly wrong!\n      if (options?.throwOnError) {\n        throw error\n      }\n\n      return {\n        valid: false,\n        errors: transformErrors(entrypoint, error.message ?? error),\n      }\n    }\n  }\n\n  /**\n   * Ajv JSON schema validator\n   */\n  async getAjvValidator(version: OpenApiVersion) {\n    // Schema loaded already\n    if (this.ajvValidators[version]) {\n      return this.ajvValidators[version]\n    }\n\n    // Load OpenAPI Schema\n    const schema = OpenApiSpecifications[version]\n\n    // Load JSON Schema\n    const AjvClass = jsonSchemaVersions[schema.$schema]\n\n    // Get the correct Ajv validator\n    const ajv = new AjvClass({\n      // Ajv is a bit too strict in its strict validation of OpenAPI schemas.\n      // Switch strict mode off.\n      strict: false,\n    })\n\n    // Register formats\n    // https://ajv.js.org/packages/ajv-formats.html#formats\n    addFormats(ajv)\n\n    // OpenAPI 3.1 uses media-range format\n    if (version === '3.1') {\n      ajv.addFormat('media-range', true)\n    }\n\n    return (this.ajvValidators[version] = ajv.compile(schema))\n  }\n}\n"],
+  "mappings": "AAAA,OAAO,WAAW;AAClB,OAAO,gBAAgB;AACvB,OAAO,aAAa;AAEpB,SAAS,QAAQ,uBAA4C,uBAAuB;AAEpF,SAAS,WAAW,yBAAyB;AAC7C,SAAS,yBAAyB;AAClC,SAAS,uBAAuB;AAKzB,MAAM,qBAAqB;AAAA,EAChC,2CAA2C;AAAA,EAC3C,gDAAgD;AAClD;AAEO,MAAM,UAAU;AAAA,EACd;AAAA,EAEP,OAAc,oBAAoB;AAAA;AAAA,EAGxB,gBAKN,CAAC;AAAA,EAEK;AAAA,EAEA;AAAA,EAEA;AAAA,EAEH;AAAA;AAAA;AAAA;AAAA,EAKP,MAAM,SAAS,YAAwB,SAAuD;AAC5F,UAAM,aAAa,WAAW,KAAK,CAAC,SAAS,KAAK,YAAY;AAC9D,UAAM,gBAAgB,YAAY;AAGlC,SAAK,gBAAgB;AAIrB,QAAI,KAAK,eAAe,QAAQ,CAAC,KAAK,cAAc,KAAK,SAAS;AAChE,WAAK,cAAc,KAAK,UAAU;AAAA,IACpC;AAEA,QAAI;AAEF,UAAI,kBAAkB,UAAa,kBAAkB,MAAM;AACzD,YAAI,SAAS,cAAc;AACzB,gBAAM,IAAI,MAAM,OAAO,gBAAgB;AAAA,QACzC;AAEA,eAAO;AAAA,UACL,OAAO;AAAA,UACP,QAAQ,gBAAgB,YAAY,OAAO,gBAAgB;AAAA,QAC7D;AAAA,MACF;AAGA,YAAM,EAAE,SAAS,mBAAmB,qBAAqB,IAAI,kBAAkB,aAAa;AAE5F,WAAK,UAAU;AACf,WAAK,uBAAuB;AAC5B,WAAK,oBAAoB;AAGzB,UAAI,CAAC,SAAS;AACZ,YAAI,SAAS,cAAc;AACzB,gBAAM,IAAI,MAAM,OAAO,6BAA6B;AAAA,QACtD;AAEA,eAAO;AAAA,UACL,OAAO;AAAA,UACP,QAAQ,gBAAgB,YAAY,OAAO,6BAA6B;AAAA,QAC1E;AAAA,MACF;AAGA,YAAM,iBAAiB,MAAM,KAAK,gBAAgB,OAAO;AACzD,YAAM,eAAe,eAAe,aAAa;AAGjD,UAAI,eAAe,QAAQ;AACzB,YAAI,eAAe,OAAO,SAAS,GAAG;AACpC,cAAI,SAAS,cAAc;AACzB,kBAAM,IAAI,MAAM,eAAe,OAAO,CAAC,CAAC;AAAA,UAC1C;AAEA,iBAAO;AAAA,YACL,OAAO;AAAA,YACP,QAAQ,gBAAgB,YAAY,eAAe,MAAM;AAAA,UAC3D;AAAA,QACF;AAAA,MACF;AAGA,YAAM,qBAAqB,kBAAkB,YAAY,OAAO;AAEhE,aAAO;AAAA,QACL,OAAO,gBAAgB,mBAAmB;AAAA,QAC1C,QAAQ,CAAC,GAAI,aAAa,UAAU,CAAC,GAAI,GAAG,mBAAmB,MAAM;AAAA,QACrE,QAAQ,mBAAmB;AAAA,MAC7B;AAAA,IACF,SAAS,OAAO;AAEd,UAAI,SAAS,cAAc;AACzB,cAAM;AAAA,MACR;AAEA,aAAO;AAAA,QACL,OAAO;AAAA,QACP,QAAQ,gBAAgB,YAAY,MAAM,WAAW,KAAK;AAAA,MAC5D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,gBAAgB,SAAyB;AAE7C,QAAI,KAAK,cAAc,OAAO,GAAG;AAC/B,aAAO,KAAK,cAAc,OAAO;AAAA,IACnC;AAGA,UAAM,SAAS,sBAAsB,OAAO;AAG5C,UAAM,WAAW,mBAAmB,OAAO,OAAO;AAGlD,UAAM,MAAM,IAAI,SAAS;AAAA;AAAA;AAAA,MAGvB,QAAQ;AAAA,IACV,CAAC;AAID,eAAW,GAAG;AAGd,QAAI,YAAY,OAAO;AACrB,UAAI,UAAU,eAAe,IAAI;AAAA,IACnC;AAEA,WAAQ,KAAK,cAAc,OAAO,IAAI,IAAI,QAAQ,MAAM;AAAA,EAC1D;AACF;",
+  "names": []
+}

package/dist/lib/Validator/Validator.test.js

@@ -0,0 +1,8 @@
+import { describe, expect, it } from "vitest";
+import { Validator } from "./Validator.js";
+describe("Validator", () => {
+  it("returns all supported versions", () => {
+    expect(Validator.supportedVersions).toMatchObject(["2.0", "3.0", "3.1"]);
+  });
+});
+//# sourceMappingURL=Validator.test.js.map

package/dist/lib/Validator/Validator.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/Validator/Validator.test.ts"],
+  "sourcesContent": ["import { describe, expect, it } from 'vitest'\n\nimport { Validator } from './Validator'\n\ndescribe('Validator', () => {\n  it('returns all supported versions', () => {\n    expect(Validator.supportedVersions).toMatchObject(['2.0', '3.0', '3.1'])\n  })\n})\n"],
+  "mappings": "AAAA,SAAS,UAAU,QAAQ,UAAU;AAErC,SAAS,iBAAiB;AAE1B,SAAS,aAAa,MAAM;AAC1B,KAAG,kCAAkC,MAAM;AACzC,WAAO,UAAU,iBAAiB,EAAE,cAAc,CAAC,OAAO,OAAO,KAAK,CAAC;AAAA,EACzE,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/lib/Validator/index.d.ts

@@ -1,3 +1,3 @@
-export * from './Validator.ts';
-export * from '../../utils/resolveReferences.ts';
+export * from './Validator.js';
+export * from '../../utils/resolveReferences.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/Validator/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/Validator/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kCAAkC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/Validator/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,+BAA+B,CAAA"}

package/dist/lib/Validator/index.js

@@ -0,0 +1,3 @@
+export * from "./Validator.js";
+export * from "../../utils/resolveReferences.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/Validator/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/Validator/index.ts"],
+  "sourcesContent": ["export * from './Validator'\nexport * from '../../utils/resolveReferences'\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/plugins/fetch-urls/fetchUrls.d.ts

@@ -1,4 +1,4 @@
-import type { LoadPlugin } from '../../utils/load/load.ts';
+import type { LoadPlugin } from '../../utils/load/load.js';
 export declare const fetchUrlsDefaultConfiguration: {
     limit: number;
 };

package/dist/plugins/fetch-urls/fetchUrls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetchUrls.d.ts","sourceRoot":"","sources":["../../../src/plugins/fetch-urls/fetchUrls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D,eAAO,MAAM,6BAA6B;;CAEzC,CAAA;AAED,eAAO,MAAM,SAAS,EAAE,CAAC,mBAAmB,CAAC,EAAE;IAC7C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC3C,KAAK,UA2CL,CAAA"}
+{"version":3,"file":"fetchUrls.d.ts","sourceRoot":"","sources":["../../../src/plugins/fetch-urls/fetchUrls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD,eAAO,MAAM,6BAA6B;;CAEzC,CAAA;AAED,eAAO,MAAM,SAAS,EAAE,CAAC,mBAAmB,CAAC,EAAE;IAC7C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC3C,KAAK,UA2CL,CAAA"}

package/dist/plugins/fetch-urls/fetchUrls.js

@@ -1,43 +1,40 @@
 const fetchUrlsDefaultConfiguration = {
-    limit: 20,
+  limit: 20
 };
 const fetchUrls = (customConfiguration) => {
-    // State
-    let numberOfRequests = 0;
-    // Configuration
-    const configuration = {
-        ...fetchUrlsDefaultConfiguration,
-        ...customConfiguration,
-    };
-    return {
-        check(value) {
-            // Not a string
-            if (typeof value !== 'string') {
-                return false;
-            }
-            // Not http/https
-            if (!value.startsWith('http://') && !value.startsWith('https://')) {
-                return false;
-            }
-            return true;
-        },
-        async get(value) {
-            // Limit ht enumber of requests
-            if (configuration?.limit !== false && numberOfRequests >= configuration?.limit) {
-                console.warn(`[fetchUrls] Maximum number of requests reeached (${configuration?.limit}), skipping request`);
-                return undefined;
-            }
-            try {
-                numberOfRequests++;
-                const response = await (configuration?.fetch ? configuration.fetch(value) : fetch(value));
-                return await response.text();
-            }
-            catch (error) {
-                console.error('[fetchUrls]', error.message, `(${value})`);
-                return undefined;
-            }
-        },
-    };
+  let numberOfRequests = 0;
+  const configuration = {
+    ...fetchUrlsDefaultConfiguration,
+    ...customConfiguration
+  };
+  return {
+    check(value) {
+      if (typeof value !== "string") {
+        return false;
+      }
+      if (!value.startsWith("http://") && !value.startsWith("https://")) {
+        return false;
+      }
+      return true;
+    },
+    async get(value) {
+      if (configuration?.limit !== false && numberOfRequests >= configuration?.limit) {
+        console.warn(`[fetchUrls] Maximum number of requests reeached (${configuration?.limit}), skipping request`);
+        return void 0;
+      }
+      try {
+        numberOfRequests++;
+        const response = await (configuration?.fetch ? configuration.fetch(value) : fetch(value));
+        return await response.text();
+      } catch (error) {
+        console.error("[fetchUrls]", error.message, `(${value})`);
+        return void 0;
+      }
+    }
+  };
 };
-
-export { fetchUrls, fetchUrlsDefaultConfiguration };
+export {
+  fetchUrls,
+  fetchUrlsDefaultConfiguration
+};
+//# sourceMappingURL=fetchUrls.js.map

package/dist/plugins/fetch-urls/fetchUrls.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugins/fetch-urls/fetchUrls.ts"],
+  "sourcesContent": ["import type { LoadPlugin } from '../../utils/load/load'\n\nexport const fetchUrlsDefaultConfiguration = {\n  limit: 20,\n}\n\nexport const fetchUrls: (customConfiguration?: {\n  /**\n   * Limit the number of requests. Set to `false` to disable the limit.\n   */\n  limit?: number | false\n  /**\n   * Fetch function to use instead of the global fetch. Use this to intercept requests.\n   */\n  fetch?: (url: string) => Promise<Response>\n}) => LoadPlugin = (customConfiguration) => {\n  // State\n  let numberOfRequests = 0\n\n  // Configuration\n  const configuration = {\n    ...fetchUrlsDefaultConfiguration,\n    ...customConfiguration,\n  }\n\n  return {\n    check(value?: any) {\n      // Not a string\n      if (typeof value !== 'string') {\n        return false\n      }\n\n      // Not http/https\n      if (!value.startsWith('http://') && !value.startsWith('https://')) {\n        return false\n      }\n\n      return true\n    },\n    async get(value?: any) {\n      // Limit ht enumber of requests\n      if (configuration?.limit !== false && numberOfRequests >= configuration?.limit) {\n        console.warn(`[fetchUrls] Maximum number of requests reeached (${configuration?.limit}), skipping request`)\n        return undefined\n      }\n\n      try {\n        numberOfRequests++\n\n        const response = await (configuration?.fetch ? configuration.fetch(value) : fetch(value))\n\n        return await response.text()\n      } catch (error) {\n        console.error('[fetchUrls]', error.message, `(${value})`)\n        return undefined\n      }\n    },\n  }\n}\n"],
+  "mappings": "AAEO,MAAM,gCAAgC;AAAA,EAC3C,OAAO;AACT;AAEO,MAAM,YASM,CAAC,wBAAwB;AAE1C,MAAI,mBAAmB;AAGvB,QAAM,gBAAgB;AAAA,IACpB,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAEA,SAAO;AAAA,IACL,MAAM,OAAa;AAEjB,UAAI,OAAO,UAAU,UAAU;AAC7B,eAAO;AAAA,MACT;AAGA,UAAI,CAAC,MAAM,WAAW,SAAS,KAAK,CAAC,MAAM,WAAW,UAAU,GAAG;AACjE,eAAO;AAAA,MACT;AAEA,aAAO;AAAA,IACT;AAAA,IACA,MAAM,IAAI,OAAa;AAErB,UAAI,eAAe,UAAU,SAAS,oBAAoB,eAAe,OAAO;AAC9E,gBAAQ,KAAK,oDAAoD,eAAe,KAAK,qBAAqB;AAC1G,eAAO;AAAA,MACT;AAEA,UAAI;AACF;AAEA,cAAM,WAAW,OAAO,eAAe,QAAQ,cAAc,MAAM,KAAK,IAAI,MAAM,KAAK;AAEvF,eAAO,MAAM,SAAS,KAAK;AAAA,MAC7B,SAAS,OAAO;AACd,gBAAQ,MAAM,eAAe,MAAM,SAAS,IAAI,KAAK,GAAG;AACxD,eAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}