@jentic/arazzo-parser 1.0.0-alpha.6 → 1.0.0-alpha.8

package/dist/jentic-arazzo-parser.browser.js

@@ -39,28 +39,25 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   defaultOptions: () => (/* binding */ defaultOptions),
 /* harmony export */   parse: () => (/* binding */ parse)
 /* harmony export */ });
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(7456);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(84149);
-/* harmony import */ var _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(212);
-/* harmony import */ var _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(8841);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_arazzo_json_1__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(30678);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_arazzo_yaml_1__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(90862);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_2__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(76680);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(41643);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(48834);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(52393);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(61275);
-/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(28208);
-/* harmony import */ var _speclynx_apidom_reference_resolve_resolvers_file__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(41939);
-/* harmony import */ var _speclynx_apidom_reference_resolve_resolvers_http_axios__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(31751);
-/* harmony import */ var _speclynx_apidom_parser_adapter_arazzo_json_1__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(47282);
-/* harmony import */ var _speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(75728);
-/* harmony import */ var _speclynx_apidom_parser_adapter_arazzo_yaml_1__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(67341);
-/* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(34606);
-/* harmony import */ var _errors_ParseError_ts__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(10425);
-/* harmony import */ var _resolve_resolvers_memory_index_ts__WEBPACK_IMPORTED_MODULE_19__ = __webpack_require__(30513);
-
-
+/* harmony import */ var _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(212);
+/* harmony import */ var _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(8841);
+/* harmony import */ var _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(88164);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_arazzo_json_1__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(30678);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_arazzo_yaml_1__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(90862);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_2__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(76680);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(41643);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(48834);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(52393);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(61275);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(28208);
+/* harmony import */ var _speclynx_apidom_reference_resolve_resolvers_file__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(41939);
+/* harmony import */ var _speclynx_apidom_reference_resolve_resolvers_http_axios__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(31751);
+/* harmony import */ var _speclynx_apidom_parser_adapter_arazzo_json_1__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(47282);
+/* harmony import */ var _speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(75728);
+/* harmony import */ var _speclynx_apidom_parser_adapter_arazzo_yaml_1__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(67341);
+/* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(34606);
+/* harmony import */ var _errors_ParseError_ts__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(10425);
+/* harmony import */ var _resolve_resolvers_memory_index_ts__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(30513);
 
 
 
@@ -90,30 +87,30 @@ __webpack_require__.r(__webpack_exports__);
  */
 const defaultOptions = {
   parse: {
-    parsers: [new _speclynx_apidom_reference_parse_parsers_arazzo_json_1__WEBPACK_IMPORTED_MODULE_4__["default"]({
+    parsers: [new _speclynx_apidom_reference_parse_parsers_arazzo_json_1__WEBPACK_IMPORTED_MODULE_3__["default"]({
       allowEmpty: false,
       fileExtensions: ['.json'],
-      parseFn: _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_2__.parse
-    }), new _speclynx_apidom_reference_parse_parsers_arazzo_yaml_1__WEBPACK_IMPORTED_MODULE_5__["default"]({
+      parseFn: _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_0__.parse
+    }), new _speclynx_apidom_reference_parse_parsers_arazzo_yaml_1__WEBPACK_IMPORTED_MODULE_4__["default"]({
       allowEmpty: false,
       fileExtensions: ['.yaml', '.yml'],
-      parseFn: _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_2__.parse
-    }), new _speclynx_apidom_reference_parse_parsers_openapi_json_2__WEBPACK_IMPORTED_MODULE_6__["default"]({
+      parseFn: _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_0__.parse
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_json_2__WEBPACK_IMPORTED_MODULE_5__["default"]({
       allowEmpty: false,
       fileExtensions: ['.json']
-    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_7__["default"]({
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_6__["default"]({
       allowEmpty: false,
       fileExtensions: ['.yaml', '.yml']
-    }), new _speclynx_apidom_reference_parse_parsers_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_8__["default"]({
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_7__["default"]({
       allowEmpty: false,
       fileExtensions: ['.json']
-    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_9__["default"]({
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_8__["default"]({
       allowEmpty: false,
       fileExtensions: ['.yaml', '.yml']
-    }), new _speclynx_apidom_reference_parse_parsers_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_10__["default"]({
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_9__["default"]({
       allowEmpty: false,
       fileExtensions: ['.json']
-    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_11__["default"]({
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_10__["default"]({
       allowEmpty: false,
       fileExtensions: ['.yaml', '.yml']
     })],
@@ -124,9 +121,9 @@ const defaultOptions = {
     }
   },
   resolve: {
-    resolvers: [new _resolve_resolvers_memory_index_ts__WEBPACK_IMPORTED_MODULE_19__["default"](), new _speclynx_apidom_reference_resolve_resolvers_file__WEBPACK_IMPORTED_MODULE_12__["default"]({
+    resolvers: [new _resolve_resolvers_memory_index_ts__WEBPACK_IMPORTED_MODULE_18__["default"](), new _speclynx_apidom_reference_resolve_resolvers_file__WEBPACK_IMPORTED_MODULE_11__["default"]({
       fileAllowList: ['*.json', '*.yaml', '*.yml']
-    }), new _speclynx_apidom_reference_resolve_resolvers_http_axios__WEBPACK_IMPORTED_MODULE_13__["default"]({
+    }), new _speclynx_apidom_reference_resolve_resolvers_http_axios__WEBPACK_IMPORTED_MODULE_12__["default"]({
       timeout: 5000,
       redirects: 5,
       withCredentials: false
@@ -198,39 +195,39 @@ const defaultOptions = {
  * @public
  */
 async function parse(source, options = {}) {
-  let mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_3__.merge)(defaultOptions, options);
+  let mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.merge)(defaultOptions, options);
   const strict = mergedOptions.parse?.parserOpts?.strict ?? true;
   let sourceProvenance;
-  if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_17__["default"])(source)) {
-    const arazzoDocument = JSON.stringify(source, null, 2);
-    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_3__.merge)(mergedOptions, {
+  if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_16__["default"])(source)) {
+    const document = JSON.stringify(source, null, 2);
+    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.merge)(mergedOptions, {
       resolve: {
         resolverOpts: {
-          arazzoDocument
+          document
         }
       }
     });
     source = 'memory://arazzo.json';
     sourceProvenance = '[object]';
-  } else if (await (0,_speclynx_apidom_parser_adapter_arazzo_json_1__WEBPACK_IMPORTED_MODULE_14__.detect)(source, {
+  } else if (await (0,_speclynx_apidom_parser_adapter_arazzo_json_1__WEBPACK_IMPORTED_MODULE_13__.detect)(source, {
     strict
   })) {
-    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_3__.merge)(mergedOptions, {
+    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.merge)(mergedOptions, {
       resolve: {
         resolverOpts: {
-          arazzoDocument: source
+          document: source
         }
       }
     });
     source = 'memory://arazzo.json';
     sourceProvenance = '[inline JSON]';
-  } else if (await (0,_speclynx_apidom_parser_adapter_arazzo_yaml_1__WEBPACK_IMPORTED_MODULE_16__.detect)(source, {
+  } else if (await (0,_speclynx_apidom_parser_adapter_arazzo_yaml_1__WEBPACK_IMPORTED_MODULE_15__.detect)(source, {
     strict
   })) {
-    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_3__.merge)(mergedOptions, {
+    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.merge)(mergedOptions, {
       resolve: {
         resolverOpts: {
-          arazzoDocument: source
+          document: source
         }
       }
     });
@@ -242,7 +239,7 @@ async function parse(source, options = {}) {
 
   // next we assume that source is either file system URI or HTTP(S) URL
   try {
-    const parseResult = await (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_2__.parse)(source, mergedOptions);
+    const parseResult = await (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_0__.parse)(source, mergedOptions);
 
     // set retrievalURI metadata for file/URL sources (not for inline content)
     if (!source.startsWith('memory://')) {
@@ -250,19 +247,277 @@ async function parse(source, options = {}) {
     }
 
     // validate that the parsed document is an Arazzo specification
-    if (!(0,_speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_15__.isArazzoSpecification1Element)(parseResult.api)) {
-      const annotation = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["default"]('Document is not a valid Arazzo specification. Expected an Arazzo document with "arazzo" version field.', {
-        classes: ['error']
-      });
-      // remove 'api' class so .api returns undefined, but keep parsed result available
-      if (parseResult.api) {
-        parseResult.api.classes = parseResult.api.classes.filter(cls => (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_0__["default"])(cls) !== 'api');
+    if (!(0,_speclynx_apidom_ns_arazzo_1__WEBPACK_IMPORTED_MODULE_14__.isArazzoSpecification1Element)(parseResult.api)) {
+      throw new _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_2__["default"](`Could not find a parser that can parse "${sourceProvenance}" as an Arazzo specification`);
+    }
+    return parseResult;
+  } catch (error) {
+    throw new _errors_ParseError_ts__WEBPACK_IMPORTED_MODULE_17__["default"](`Failed to parse Arazzo Document from "${sourceProvenance}"`, {
+      cause: error
+    });
+  }
+}
+
+/***/ },
+
+/***/ 71228
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   defaultOptions: () => (/* binding */ defaultOptions),
+/* harmony export */   parse: () => (/* binding */ parse)
+/* harmony export */ });
+/* harmony import */ var _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(212);
+/* harmony import */ var _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(8841);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_2__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(76680);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(41643);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(48834);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(52393);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(61275);
+/* harmony import */ var _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(28208);
+/* harmony import */ var _speclynx_apidom_reference_resolve_resolvers_file__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(41939);
+/* harmony import */ var _speclynx_apidom_reference_resolve_resolvers_http_axios__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(31751);
+/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(10343);
+/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(43244);
+/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(50142);
+/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(99474);
+/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_json_2__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(64820);
+/* harmony import */ var _speclynx_apidom_parser_adapter_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(71527);
+/* harmony import */ var ramda_adjunct__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(34606);
+/* harmony import */ var _errors_ParseError_ts__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(10425);
+/* harmony import */ var _resolve_resolvers_memory_index_ts__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(30513);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+/**
+ * Options for parsing OpenAPI Documents.
+ * @public
+ */
+
+/**
+ * Default reference options for parsing OpenAPI Documents.
+ * @public
+ */
+const defaultOptions = {
+  parse: {
+    parsers: [new _speclynx_apidom_reference_parse_parsers_openapi_json_2__WEBPACK_IMPORTED_MODULE_2__["default"]({
+      allowEmpty: false,
+      fileExtensions: ['.json']
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_3__["default"]({
+      allowEmpty: false,
+      fileExtensions: ['.yaml', '.yml']
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_4__["default"]({
+      allowEmpty: false,
+      fileExtensions: ['.json']
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_5__["default"]({
+      allowEmpty: false,
+      fileExtensions: ['.yaml', '.yml']
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_6__["default"]({
+      allowEmpty: false,
+      fileExtensions: ['.json']
+    }), new _speclynx_apidom_reference_parse_parsers_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_7__["default"]({
+      allowEmpty: false,
+      fileExtensions: ['.yaml', '.yml']
+    })],
+    parserOpts: {
+      sourceMap: false,
+      strict: true
+    }
+  },
+  resolve: {
+    resolvers: [new _resolve_resolvers_memory_index_ts__WEBPACK_IMPORTED_MODULE_18__["default"](), new _speclynx_apidom_reference_resolve_resolvers_file__WEBPACK_IMPORTED_MODULE_8__["default"]({
+      fileAllowList: ['*.json', '*.yaml', '*.yml']
+    }), new _speclynx_apidom_reference_resolve_resolvers_http_axios__WEBPACK_IMPORTED_MODULE_9__["default"]({
+      timeout: 5000,
+      redirects: 5,
+      withCredentials: false
+    })],
+    resolverOpts: {}
+  }
+};
+
+/**
+ * Parses an OpenAPI Document from an object.
+ * @param source - The OpenAPI Document as a plain object
+ * @param options - Reference options (uses defaultOptions when not provided)
+ * @returns A promise that resolves to the parsed OpenAPI Document as ApiDOM data model
+ * @throws ParseError - When parsing fails for any reason. The original error is available via the `cause` property.
+ * @public
+ */
+
+/**
+ * Parses an OpenAPI Document from a string or URI.
+ * @param source - The OpenAPI Document as string content, or a file system path / HTTP(S) URL
+ * @param options - Reference options (uses defaultOptions when not provided)
+ * @returns A promise that resolves to the parsed OpenAPI Document as ApiDOM data model
+ * @throws ParseError - When parsing fails for any reason. The original error is available via the `cause` property.
+ * @public
+ */
+
+/**
+ * Parses an OpenAPI Document from a string, object, or URI.
+ *
+ * The function handles three types of input:
+ * 1. Object - converts to JSON string and parses (source maps supported with `strict: false`)
+ * 2. String content - uses OpenAPI detection to identify and parse inline JSON or YAML content
+ * 3. URI string - if not detected as OpenAPI content, treats as file system path or HTTP(S) URL
+ *
+ * @param source - The OpenAPI Document as an object, string content, or a file system path / HTTP(S) URL
+ * @param options - Reference options (uses defaultOptions when not provided)
+ * @returns A promise that resolves to the parsed OpenAPI Document as ApiDOM data model
+ * @throws ParseError - When parsing fails for any reason. The original error is available via the `cause` property.
+ *
+ * @example
+ * Parse from object
+ * ```typescript
+ * const result = await parseOpenAPI({ openapi: '3.1.0', info: {...} });
+ * ```
+ *
+ * @example
+ * Parse inline JSON
+ * ```typescript
+ * const result = await parseOpenAPI('{"openapi": "3.1.0", "info": {...}}');
+ * ```
+ *
+ * @example
+ * Parse from file
+ * ```typescript
+ * const result = await parseOpenAPI('/path/to/openapi.json');
+ * ```
+ *
+ * @example
+ * Parse from URL
+ * ```typescript
+ * const result = await parseOpenAPI('https://example.com/openapi.yaml');
+ * ```
+ *
+ * @example
+ * Parse with custom options
+ * ```typescript
+ * const result = await parseOpenAPI('/path/to/openapi.json', customOptions);
+ * ```
+ * @public
+ */
+async function parse(source, options = {}) {
+  let mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.merge)(defaultOptions, options);
+  const strict = mergedOptions.parse?.parserOpts?.strict ?? true;
+  let sourceProvenance;
+  if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_16__["default"])(source)) {
+    const document = JSON.stringify(source, null, 2);
+    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.merge)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document
+        }
       }
-      parseResult.push(annotation);
+    });
+    source = 'memory://openapi.json';
+    sourceProvenance = '[object]';
+  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_json_2__WEBPACK_IMPORTED_MODULE_14__.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.merge)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.json';
+    sourceProvenance = '[inline JSON]';
+  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_yaml_2__WEBPACK_IMPORTED_MODULE_15__.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.merge)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.yaml';
+    sourceProvenance = '[inline YAML]';
+  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_json_3_0__WEBPACK_IMPORTED_MODULE_12__.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.merge)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.json';
+    sourceProvenance = '[inline JSON]';
+  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_yaml_3_0__WEBPACK_IMPORTED_MODULE_13__.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.merge)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.yaml';
+    sourceProvenance = '[inline YAML]';
+  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_json_3_1__WEBPACK_IMPORTED_MODULE_10__.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.merge)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.json';
+    sourceProvenance = '[inline JSON]';
+  } else if (await (0,_speclynx_apidom_parser_adapter_openapi_yaml_3_1__WEBPACK_IMPORTED_MODULE_11__.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__.merge)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.yaml';
+    sourceProvenance = '[inline YAML]';
+  } else {
+    sourceProvenance = source;
+  }
+
+  // next we assume that source is either file system URI or HTTP(S) URL
+  try {
+    const parseResult = await (0,_speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_0__.parse)(source, mergedOptions);
+
+    // set retrievalURI metadata for file/URL sources (not for inline content)
+    if (!source.startsWith('memory://')) {
+      parseResult.meta.set('retrievalURI', source);
     }
     return parseResult;
   } catch (error) {
-    throw new _errors_ParseError_ts__WEBPACK_IMPORTED_MODULE_18__["default"](`Failed to parse Arazzo Document from "${sourceProvenance}"`, {
+    throw new _errors_ParseError_ts__WEBPACK_IMPORTED_MODULE_17__["default"](`Failed to parse OpenAPI Document from "${sourceProvenance}"`, {
       cause: error
     });
   }
@@ -291,12 +546,12 @@ class MemoryResolver extends _speclynx_apidom_reference_configuration_empty__WEB
     });
   }
   canRead(file) {
-    return file.uri.startsWith('memory://') && typeof this.arazzoDocument === 'string';
+    return file.uri.startsWith('memory://') && this.document !== undefined;
   }
   async read(file) {
     try {
       const encoder = new TextEncoder();
-      return encoder.encode(this.arazzoDocument);
+      return encoder.encode(this.document);
     } catch (error) {
       throw new _speclynx_apidom_reference_configuration_empty__WEBPACK_IMPORTED_MODULE_1__["default"](`Error opening file "${file.uri}"`, {
         cause: error
@@ -42316,7 +42571,7 @@ const bundle = async (uri, options) => {
 
   // we couldn't find any bundle strategy for this File
   if ((0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(bundleStrategies)) {
-    throw new _errors_UnmatchedBundleStrategyError_mjs__WEBPACK_IMPORTED_MODULE_4__["default"](file.uri);
+    throw new _errors_UnmatchedBundleStrategyError_mjs__WEBPACK_IMPORTED_MODULE_4__["default"](`Could not find a bundle strategy that can bundle the file "${file.uri}"`);
   }
   try {
     const {
@@ -42414,7 +42669,7 @@ const dereferenceApiDOM = async (element, options) => {
 
   // we couldn't find any dereference strategy for this File
   if ((0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(dereferenceStrategies)) {
-    throw new _errors_UnmatchedDereferenceStrategyError_mjs__WEBPACK_IMPORTED_MODULE_7__["default"](file.uri);
+    throw new _errors_UnmatchedDereferenceStrategyError_mjs__WEBPACK_IMPORTED_MODULE_7__["default"](`Could not find a dereference strategy that can dereference the file "${file.uri}"`);
   }
   try {
     const {
@@ -42637,7 +42892,7 @@ __webpack_require__.r(__webpack_exports__);
  */
 class InvalidJsonSchema$anchorError extends _JsonSchema$anchorError_mjs__WEBPACK_IMPORTED_MODULE_0__["default"] {
   constructor(anchor) {
-    super(`Invalid JSON Schema $anchor "${anchor}".`);
+    super(`Invalid JSON Schema $anchor "${anchor}"`);
   }
 }
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (InvalidJsonSchema$anchorError);
@@ -42873,6 +43128,24 @@ class UnmatchedDereferenceStrategyError extends _DereferenceError_mjs__WEBPACK_I
 
 /***/ },
 
+/***/ 88164
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
+/* harmony export */ });
+/* harmony import */ var _ParserError_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(21982);
+
+/**
+ * @public
+ */
+class UnmatchedParserError extends _ParserError_mjs__WEBPACK_IMPORTED_MODULE_0__["default"] {}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (UnmatchedParserError);
+
+/***/ },
+
 /***/ 64188
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -42943,6 +43216,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   ResolverError: () => (/* reexport safe */ _errors_ResolverError_mjs__WEBPACK_IMPORTED_MODULE_34__["default"]),
 /* harmony export */   UnmatchedBundleStrategyError: () => (/* reexport safe */ _errors_UnmatchedBundleStrategyError_mjs__WEBPACK_IMPORTED_MODULE_20__["default"]),
 /* harmony export */   UnmatchedDereferenceStrategyError: () => (/* reexport safe */ _errors_UnmatchedDereferenceStrategyError_mjs__WEBPACK_IMPORTED_MODULE_35__["default"]),
+/* harmony export */   UnmatchedParserError: () => (/* reexport safe */ _errors_UnmatchedParserError_mjs__WEBPACK_IMPORTED_MODULE_38__["default"]),
 /* harmony export */   UnmatchedResolveStrategyError: () => (/* reexport safe */ _errors_UnmatchedResolveStrategyError_mjs__WEBPACK_IMPORTED_MODULE_36__["default"]),
 /* harmony export */   UnmatchedResolverError: () => (/* reexport safe */ _errors_UnmatchedResolverError_mjs__WEBPACK_IMPORTED_MODULE_37__["default"]),
 /* harmony export */   bundle: () => (/* binding */ bundle),
@@ -42994,6 +43268,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _errors_UnmatchedDereferenceStrategyError_mjs__WEBPACK_IMPORTED_MODULE_35__ = __webpack_require__(37348);
 /* harmony import */ var _errors_UnmatchedResolveStrategyError_mjs__WEBPACK_IMPORTED_MODULE_36__ = __webpack_require__(64188);
 /* harmony import */ var _errors_UnmatchedResolverError_mjs__WEBPACK_IMPORTED_MODULE_37__ = __webpack_require__(32617);
+/* harmony import */ var _errors_UnmatchedParserError_mjs__WEBPACK_IMPORTED_MODULE_38__ = __webpack_require__(88164);
+
 
 
 
@@ -43342,7 +43618,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _File_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(2514);
 /* harmony import */ var _util_plugins_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(66821);
 /* harmony import */ var _errors_ParseError_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(82361);
-/* harmony import */ var _errors_UnmatchedResolverError_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(32617);
+/* harmony import */ var _errors_UnmatchedParserError_mjs__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(88164);
 /* harmony import */ var _resolve_util_mjs__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(25807);
 
 
@@ -43363,7 +43639,7 @@ const parseFile = async (file, options) => {
 
   // we couldn't find any parser for this File
   if ((0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(parsers)) {
-    throw new _errors_UnmatchedResolverError_mjs__WEBPACK_IMPORTED_MODULE_5__["default"](file.uri);
+    throw new _errors_UnmatchedParserError_mjs__WEBPACK_IMPORTED_MODULE_5__["default"](`Could not find a parser that can parse the file "${file.uri}"`);
   }
   try {
     const {
@@ -43373,7 +43649,7 @@ const parseFile = async (file, options) => {
 
     // empty files handling
     if (!plugin.allowEmpty && result.isEmpty) {
-      return Promise.reject(new _errors_ParseError_mjs__WEBPACK_IMPORTED_MODULE_4__["default"](`Error while parsing file "${file.uri}". File is empty.`));
+      return Promise.reject(new _errors_ParseError_mjs__WEBPACK_IMPORTED_MODULE_4__["default"](`Error while parsing file "${file.uri}": file is empty`));
     }
     return result;
   } catch (error) {
@@ -44250,9 +44526,9 @@ const resolveApiDOM = async (element, options) => {
   });
   const resolveStrategies = await _util_plugins_mjs__WEBPACK_IMPORTED_MODULE_6__.filter('canResolve', [file, options], options.resolve.strategies);
 
-  // we couldn't find any resolver for this File
+  // we couldn't find any resolve strategy for this File
   if ((0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(resolveStrategies)) {
-    throw new _errors_UnmatchedResolveStrategyError_mjs__WEBPACK_IMPORTED_MODULE_9__["default"](file.uri);
+    throw new _errors_UnmatchedResolveStrategyError_mjs__WEBPACK_IMPORTED_MODULE_9__["default"](`Could not find a resolve strategy that can resolve the file "${file.uri}"`);
   }
   try {
     const {
@@ -44530,7 +44806,7 @@ const readFile = async (file, options) => {
 
   // we couldn't find any resolver for this File
   if ((0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(resolvers)) {
-    throw new _errors_UnmatchedResolverError_mjs__WEBPACK_IMPORTED_MODULE_3__["default"](file.uri);
+    throw new _errors_UnmatchedResolverError_mjs__WEBPACK_IMPORTED_MODULE_3__["default"](`Could not find a resolver that can read the file "${file.uri}"`);
   }
   try {
     const {
@@ -77620,10 +77896,14 @@ var __webpack_exports__ = {};
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   defaultOptions: () => (/* reexport safe */ _parse_arazzo_ts__WEBPACK_IMPORTED_MODULE_0__.defaultOptions),
-/* harmony export */   parseArazzo: () => (/* reexport safe */ _parse_arazzo_ts__WEBPACK_IMPORTED_MODULE_0__.parse)
+/* harmony export */   defaultArazzoOptions: () => (/* reexport safe */ _parse_arazzo_ts__WEBPACK_IMPORTED_MODULE_0__.defaultOptions),
+/* harmony export */   defaultOpenAPIOptions: () => (/* reexport safe */ _parse_openapi_ts__WEBPACK_IMPORTED_MODULE_1__.defaultOptions),
+/* harmony export */   parseArazzo: () => (/* reexport safe */ _parse_arazzo_ts__WEBPACK_IMPORTED_MODULE_0__.parse),
+/* harmony export */   parseOpenAPI: () => (/* reexport safe */ _parse_openapi_ts__WEBPACK_IMPORTED_MODULE_1__.parse)
 /* harmony export */ });
 /* harmony import */ var _parse_arazzo_ts__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(30089);
+/* harmony import */ var _parse_openapi_ts__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(71228);
+
 
 })();