@jentic/arazzo-parser 1.0.0-alpha.23 → 1.0.0-alpha.25

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.0.0-alpha.25](https://github.com/jentic/jentic-arazzo-tools/compare/v1.0.0-alpha.24...v1.0.0-alpha.25) (2026-03-11)
+
+### Bug Fixes
+
+- **release:** fix issue in lerna not publishing _.cjs|_.mjs files ([8982184](https://github.com/jentic/jentic-arazzo-tools/commit/8982184ddae167b6f2a772114f9a9321f3b67d14))
+
+# [1.0.0-alpha.24](https://github.com/jentic/jentic-arazzo-tools/compare/v1.0.0-alpha.23...v1.0.0-alpha.24) (2026-03-11)
+
+**Note:** Version bump only for package @jentic/arazzo-parser
+
 # [1.0.0-alpha.23](https://github.com/jentic/jentic-arazzo-tools/compare/v1.0.0-alpha.22...v1.0.0-alpha.23) (2026-03-11)
 
 ### Features

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

@@ -38197,7 +38197,9 @@ class Path {
    *
    * @example
    * // For a path to $.paths['/pets'].get in an OpenAPI document:
+   * ```
    * path.getPathKeys(); // => ['paths', '/pets', 'get']
+   * ```
    */
   getPathKeys() {
     const keys = [];
@@ -38232,18 +38234,22 @@ class Path {
    *          or Normalized JSONPath like "$['paths']['/pets']['get']['responses']['200']"
    *
    * @example
+   * ```
    * // JSON Pointer examples:
    * path.formatPath(); // "" (root)
    * path.formatPath(); // "/info"
    * path.formatPath(); // "/paths/~1pets/get"
    * path.formatPath(); // "/paths/~1users~1{id}/parameters/0"
+   * ```
    *
    * @example
+   * ```
    * // JSONPath examples:
    * path.formatPath('jsonpath'); // "$" (root)
    * path.formatPath('jsonpath'); // "$['info']"
    * path.formatPath('jsonpath'); // "$['paths']['/pets']['get']"
    * path.formatPath('jsonpath'); // "$['paths']['/users/{id}']['parameters'][0]"
+   * ```
    */
   formatPath(pathFormat = 'jsonpointer') {
     const parts = this.getPathKeys();
@@ -38453,15 +38459,15 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _traversal_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(66061);
 
 /**
- * Finds all elements matching the predicate.
+ * Finds all paths whose elements match the predicate.
  * @public
  */
 const filter = (element, predicate) => {
   const result = [];
   (0,_traversal_mjs__WEBPACK_IMPORTED_MODULE_0__.traverse)(element, {
     enter(path) {
-      if (predicate(path.node)) {
-        result.push(path.node);
+      if (predicate(path)) {
+        result.push(path);
       }
     }
   });
@@ -38487,7 +38493,7 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 /**
- * Finds the most inner node at the given offset.
+ * Finds the path of the most inner node at the given offset.
  * If includeRightBound is set, also finds nodes that end at the given offset.
  * @public
  */
@@ -38512,7 +38518,7 @@ const findAtOffset = (element, options) => {
       const endOffset = node.endOffset;
       const isWithinOffsetRange = offset >= startOffset && (offset < endOffset || includeRightBound && offset <= endOffset);
       if (isWithinOffsetRange) {
-        result.push(node);
+        result.push(path);
         return; // push to stack and dive in
       }
       path.skip(); // skip entire sub-tree
@@ -38535,15 +38541,15 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _traversal_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(66061);
 
 /**
- * Find first element that satisfies the provided predicate.
+ * Finds first path whose element satisfies the provided predicate.
  * @public
  */
 const find = (element, predicate) => {
   let result;
   (0,_traversal_mjs__WEBPACK_IMPORTED_MODULE_0__.traverse)(element, {
     enter(path) {
-      if (predicate(path.node)) {
-        result = path.node;
+      if (predicate(path)) {
+        result = path;
         path.stop();
       }
     }
@@ -38562,9 +38568,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(62823);
-/* harmony import */ var _traversal_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(66061);
-
+/* harmony import */ var _traversal_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(66061);
 
 /**
  * @public
@@ -38573,7 +38577,7 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 /**
- * Executes the callback on this element and all descendants.
+ * Executes the callback on this element's path and all descendant paths.
  * @public
  */
 const forEach = (element, options) => {
@@ -38581,15 +38585,15 @@ const forEach = (element, options) => {
   let predicate;
   if (typeof options === 'function') {
     callback = options;
-    predicate = _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isElement;
+    predicate = () => true;
   } else {
     callback = options.callback ?? (() => {});
-    predicate = options.predicate ?? _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isElement;
+    predicate = options.predicate ?? (() => true);
   }
-  (0,_traversal_mjs__WEBPACK_IMPORTED_MODULE_1__.traverse)(element, {
+  (0,_traversal_mjs__WEBPACK_IMPORTED_MODULE_0__.traverse)(element, {
     enter(path) {
-      if (predicate(path.node)) {
-        callback(path.node);
+      if (predicate(path)) {
+        callback(path);
       }
     }
   });
@@ -38638,11 +38642,11 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _filter_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(5800);
 
 /**
- * Complement of filter. Finds all elements NOT matching the predicate.
+ * Complement of filter. Finds all paths whose elements do NOT match the predicate.
  * @public
  */
 const reject = (element, predicate) => {
-  return (0,_filter_mjs__WEBPACK_IMPORTED_MODULE_0__["default"])(element, el => !predicate(el));
+  return (0,_filter_mjs__WEBPACK_IMPORTED_MODULE_0__["default"])(element, path => !predicate(path));
 };
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (reject);
 
@@ -38659,7 +38663,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _find_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(66919);
 
 /**
- * Tests whether at least one element passes the predicate.
+ * Tests whether at least one path's element passes the predicate.
  * @public
  */
 const some = (element, predicate) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jentic/arazzo-parser",
-  "version": "1.0.0-alpha.23",
+  "version": "1.0.0-alpha.25",
   "description": "Parser for Arazzo Documents producing SpecLynx ApiDOM data model.",
   "keywords": [
     "arazzo",
@@ -48,27 +48,26 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@babel/runtime-corejs3": "^7.28.4",
-    "@speclynx/apidom-datamodel": "^3.2.1",
-    "@speclynx/apidom-error": "^3.2.1",
-    "@speclynx/apidom-ns-arazzo-1": "^3.2.1",
-    "@speclynx/apidom-parser-adapter-arazzo-json-1": "^3.2.1",
-    "@speclynx/apidom-parser-adapter-arazzo-yaml-1": "^3.2.1",
-    "@speclynx/apidom-parser-adapter-openapi-json-2": "^3.2.1",
-    "@speclynx/apidom-parser-adapter-openapi-json-3-0": "^3.2.1",
-    "@speclynx/apidom-parser-adapter-openapi-json-3-1": "^3.2.1",
-    "@speclynx/apidom-parser-adapter-openapi-yaml-2": "^3.2.1",
-    "@speclynx/apidom-parser-adapter-openapi-yaml-3-0": "^3.2.1",
-    "@speclynx/apidom-parser-adapter-openapi-yaml-3-1": "^3.2.1",
-    "@speclynx/apidom-reference": "^3.2.1",
+    "@speclynx/apidom-datamodel": "^4.0.3",
+    "@speclynx/apidom-error": "^4.0.3",
+    "@speclynx/apidom-ns-arazzo-1": "^4.0.3",
+    "@speclynx/apidom-parser-adapter-arazzo-json-1": "^4.0.3",
+    "@speclynx/apidom-parser-adapter-arazzo-yaml-1": "^4.0.3",
+    "@speclynx/apidom-parser-adapter-openapi-json-2": "^4.0.3",
+    "@speclynx/apidom-parser-adapter-openapi-json-3-0": "^4.0.3",
+    "@speclynx/apidom-parser-adapter-openapi-json-3-1": "^4.0.3",
+    "@speclynx/apidom-parser-adapter-openapi-yaml-2": "^4.0.3",
+    "@speclynx/apidom-parser-adapter-openapi-yaml-3-0": "^4.0.3",
+    "@speclynx/apidom-parser-adapter-openapi-yaml-3-1": "^4.0.3",
+    "@speclynx/apidom-reference": "^4.0.3",
     "ramda-adjunct": "^6.0.0",
     "type-fest": "^5.4.3"
   },
   "devDependencies": {
-    "@speclynx/apidom-core": "^3.2.1"
+    "@speclynx/apidom-core": "^4.0.3"
   },
   "files": [
-    "src/**/*.mjs",
-    "src/**/*.cjs",
+    "src/",
     "dist/",
     "types/arazzo-parser.d.ts",
     "LICENSE",
@@ -76,5 +75,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "d3bd28db525dc1c4cf46d2b9ccf83fecade420a1"
+  "gitHead": "b9a3213b0561fc58e0491c7e638d6a96383befff"
 }

package/src/errors/ParseError.cjs

@@ -0,0 +1,11 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = void 0;
+var _apidomError = require("@speclynx/apidom-error");
+class ParseError extends _apidomError.ApiDOMError {
+  constructor(message, options) {
+    super(message, options);
+  }
+}
+var _default = exports.default = ParseError;

package/src/errors/ParseError.mjs

@@ -0,0 +1,7 @@
+import { ApiDOMError } from '@speclynx/apidom-error';
+class ParseError extends ApiDOMError {
+  constructor(message, options) {
+    super(message, options);
+  }
+}
+export default ParseError;

package/src/index.cjs

@@ -0,0 +1,10 @@
+"use strict";
+
+exports.__esModule = true;
+exports.parseOpenAPI = exports.parseArazzo = exports.defaultOpenAPIOptions = exports.defaultArazzoOptions = void 0;
+var _parseArazzo = require("./parse-arazzo.cjs");
+exports.parseArazzo = _parseArazzo.parse;
+exports.defaultArazzoOptions = _parseArazzo.defaultOptions;
+var _parseOpenapi = require("./parse-openapi.cjs");
+exports.parseOpenAPI = _parseOpenapi.parse;
+exports.defaultOpenAPIOptions = _parseOpenapi.defaultOptions;

package/src/index.mjs

@@ -0,0 +1,2 @@
+export { parse as parseArazzo, defaultOptions as defaultArazzoOptions } from "./parse-arazzo.mjs";
+export { parse as parseOpenAPI, defaultOptions as defaultOpenAPIOptions } from "./parse-openapi.mjs";

package/src/parse-arazzo.cjs

@@ -0,0 +1,204 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.defaultOptions = void 0;
+exports.parse = parse;
+var _empty = require("@speclynx/apidom-reference/configuration/empty");
+var _arazzoJson = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/arazzo-json-1"));
+var _arazzoYaml = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/arazzo-yaml-1"));
+var _openapiJson = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/openapi-json-2"));
+var _openapiYaml = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/openapi-yaml-2"));
+var _openapiJson2 = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/openapi-json-3-0"));
+var _openapiYaml2 = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/openapi-yaml-3-0"));
+var _openapiJson3 = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/openapi-json-3-1"));
+var _openapiYaml3 = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/openapi-yaml-3-1"));
+var _file = _interopRequireDefault(require("@speclynx/apidom-reference/resolve/resolvers/file"));
+var _httpAxios = _interopRequireDefault(require("@speclynx/apidom-reference/resolve/resolvers/http-axios"));
+var _apidomParserAdapterArazzoJson = require("@speclynx/apidom-parser-adapter-arazzo-json-1");
+var _apidomNsArazzo = require("@speclynx/apidom-ns-arazzo-1");
+var _apidomParserAdapterArazzoYaml = require("@speclynx/apidom-parser-adapter-arazzo-yaml-1");
+var _ramdaAdjunct = require("ramda-adjunct");
+var _ParseError = _interopRequireDefault(require("./errors/ParseError.cjs"));
+var _index = _interopRequireDefault(require("./resolve/resolvers/memory/index.cjs"));
+/**
+ * Options for parsing Arazzo Documents.
+ * @public
+ */
+
+/**
+ * Default reference options for parsing Arazzo Documents.
+ * @public
+ */
+const defaultOptions = exports.defaultOptions = {
+  parse: {
+    parsers: [new _arazzoJson.default({
+      allowEmpty: false
+    }), new _arazzoYaml.default({
+      allowEmpty: false
+    }), new _openapiJson.default({
+      allowEmpty: false
+    }), new _openapiYaml.default({
+      allowEmpty: false
+    }), new _openapiJson2.default({
+      allowEmpty: false
+    }), new _openapiYaml2.default({
+      allowEmpty: false
+    }), new _openapiJson3.default({
+      allowEmpty: false
+    }), new _openapiYaml3.default({
+      allowEmpty: false
+    })],
+    parserOpts: {
+      sourceMap: false,
+      style: false,
+      strict: true,
+      sourceDescriptions: false
+    }
+  },
+  resolve: {
+    resolvers: [new _index.default(), new _file.default({
+      fileAllowList: ['*.json', '*.yaml', '*.yml']
+    }), new _httpAxios.default({
+      timeout: 15000,
+      redirects: 5,
+      withCredentials: false
+    })],
+    resolverOpts: {}
+  }
+};
+
+/**
+ * Parses an Arazzo Document from an object.
+ * @param source - The Arazzo Document as a plain object
+ * @param options - Reference options (uses defaultOptions when not provided)
+ * @returns A promise that resolves to the parsed Arazzo 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 Arazzo Document from a string or URI.
+ * @param source - The Arazzo 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 Arazzo 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 Arazzo Document from a string, object, or URI.
+ * @param source - The Arazzo Document as a plain object, string content, or URI
+ * @param options - Reference options (uses defaultOptions when not provided)
+ * @returns A promise that resolves to the parsed Arazzo 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 Arazzo 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 Arazzo detection to identify and parse inline JSON or YAML content
+ * 3. URI string - if not detected as Arazzo content, treats as file system path or HTTP(S) URL
+ *
+ * @param source - The Arazzo 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 Arazzo 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 parseArazzo({ arazzo: '1.0.1', info: {...} });
+ * ```
+ *
+ * @example
+ * Parse inline JSON
+ * ```typescript
+ * const result = await parseArazzo('{"arazzo": "1.0.1", "info": {...}}');
+ * ```
+ *
+ * @example
+ * Parse from file
+ * ```typescript
+ * const result = await parseArazzo('/path/to/arazzo.json');
+ * ```
+ *
+ * @example
+ * Parse from URL
+ * ```typescript
+ * const result = await parseArazzo('https://example.com/arazzo.yaml');
+ * ```
+ *
+ * @example
+ * Parse with custom options
+ * ```typescript
+ * const result = await parseArazzo('/path/to/arazzo.json', customOptions);
+ * ```
+ * @public
+ */
+async function parse(source, options = {}) {
+  let mergedOptions = (0, _empty.mergeOptions)(defaultOptions, options);
+  const strict = mergedOptions.parse?.parserOpts?.strict ?? true;
+  let sourceProvenance;
+  if ((0, _ramdaAdjunct.isPlainObject)(source)) {
+    const document = JSON.stringify(source, null, 2);
+    mergedOptions = (0, _empty.mergeOptions)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document
+        }
+      }
+    });
+    source = 'memory://arazzo.json';
+    sourceProvenance = '[object]';
+  } else if (await (0, _apidomParserAdapterArazzoJson.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0, _empty.mergeOptions)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://arazzo.json';
+    sourceProvenance = '[inline JSON]';
+  } else if (await (0, _apidomParserAdapterArazzoYaml.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0, _empty.mergeOptions)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://arazzo.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, _empty.parse)(source, mergedOptions);
+
+    // set retrievalURI metadata for file/URL sources (not for inline content)
+    if (!source.startsWith('memory://')) {
+      parseResult.meta.set('retrievalURI', source);
+    }
+
+    // validate that the parsed document is an Arazzo specification
+    if (!(0, _apidomNsArazzo.isArazzoSpecification1Element)(parseResult.api)) {
+      throw new _empty.UnmatchedParserError(`Could not find a parser that can parse "${sourceProvenance}" as an Arazzo specification`);
+    }
+    return parseResult;
+  } catch (error) {
+    throw new _ParseError.default(`Failed to parse Arazzo Document from "${sourceProvenance}"`, {
+      cause: error
+    });
+  }
+}

package/src/parse-arazzo.mjs

@@ -0,0 +1,197 @@
+import { parse as parseURI, mergeOptions, UnmatchedParserError } from '@speclynx/apidom-reference/configuration/empty';
+import ArazzoJSON1Parser from '@speclynx/apidom-reference/parse/parsers/arazzo-json-1';
+import ArazzoYAML1Parser from '@speclynx/apidom-reference/parse/parsers/arazzo-yaml-1';
+import OpenApiJSON2Parser from '@speclynx/apidom-reference/parse/parsers/openapi-json-2';
+import OpenApiYAML2Parser from '@speclynx/apidom-reference/parse/parsers/openapi-yaml-2';
+import OpenApiJSON3_0Parser from '@speclynx/apidom-reference/parse/parsers/openapi-json-3-0';
+import OpenApiYAML3_0Parser from '@speclynx/apidom-reference/parse/parsers/openapi-yaml-3-0';
+import OpenApiJSON3_1Parser from '@speclynx/apidom-reference/parse/parsers/openapi-json-3-1';
+import OpenApiYAML3_1Parser from '@speclynx/apidom-reference/parse/parsers/openapi-yaml-3-1';
+import FileResolver from '@speclynx/apidom-reference/resolve/resolvers/file';
+import HTTPResolverAxios from '@speclynx/apidom-reference/resolve/resolvers/http-axios';
+import { detect as detectArazzoJSON } from '@speclynx/apidom-parser-adapter-arazzo-json-1';
+import { isArazzoSpecification1Element } from '@speclynx/apidom-ns-arazzo-1';
+import { detect as detectArazzoYAML } from '@speclynx/apidom-parser-adapter-arazzo-yaml-1';
+import { isPlainObject } from 'ramda-adjunct';
+import ParseError from "./errors/ParseError.mjs";
+import MemoryResolver from "./resolve/resolvers/memory/index.mjs";
+/**
+ * Options for parsing Arazzo Documents.
+ * @public
+ */
+/**
+ * Default reference options for parsing Arazzo Documents.
+ * @public
+ */
+export const defaultOptions = {
+  parse: {
+    parsers: [new ArazzoJSON1Parser({
+      allowEmpty: false
+    }), new ArazzoYAML1Parser({
+      allowEmpty: false
+    }), new OpenApiJSON2Parser({
+      allowEmpty: false
+    }), new OpenApiYAML2Parser({
+      allowEmpty: false
+    }), new OpenApiJSON3_0Parser({
+      allowEmpty: false
+    }), new OpenApiYAML3_0Parser({
+      allowEmpty: false
+    }), new OpenApiJSON3_1Parser({
+      allowEmpty: false
+    }), new OpenApiYAML3_1Parser({
+      allowEmpty: false
+    })],
+    parserOpts: {
+      sourceMap: false,
+      style: false,
+      strict: true,
+      sourceDescriptions: false
+    }
+  },
+  resolve: {
+    resolvers: [new MemoryResolver(), new FileResolver({
+      fileAllowList: ['*.json', '*.yaml', '*.yml']
+    }), new HTTPResolverAxios({
+      timeout: 15000,
+      redirects: 5,
+      withCredentials: false
+    })],
+    resolverOpts: {}
+  }
+};
+
+/**
+ * Parses an Arazzo Document from an object.
+ * @param source - The Arazzo Document as a plain object
+ * @param options - Reference options (uses defaultOptions when not provided)
+ * @returns A promise that resolves to the parsed Arazzo 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 Arazzo Document from a string or URI.
+ * @param source - The Arazzo 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 Arazzo 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 Arazzo Document from a string, object, or URI.
+ * @param source - The Arazzo Document as a plain object, string content, or URI
+ * @param options - Reference options (uses defaultOptions when not provided)
+ * @returns A promise that resolves to the parsed Arazzo 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 Arazzo 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 Arazzo detection to identify and parse inline JSON or YAML content
+ * 3. URI string - if not detected as Arazzo content, treats as file system path or HTTP(S) URL
+ *
+ * @param source - The Arazzo 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 Arazzo 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 parseArazzo({ arazzo: '1.0.1', info: {...} });
+ * ```
+ *
+ * @example
+ * Parse inline JSON
+ * ```typescript
+ * const result = await parseArazzo('{"arazzo": "1.0.1", "info": {...}}');
+ * ```
+ *
+ * @example
+ * Parse from file
+ * ```typescript
+ * const result = await parseArazzo('/path/to/arazzo.json');
+ * ```
+ *
+ * @example
+ * Parse from URL
+ * ```typescript
+ * const result = await parseArazzo('https://example.com/arazzo.yaml');
+ * ```
+ *
+ * @example
+ * Parse with custom options
+ * ```typescript
+ * const result = await parseArazzo('/path/to/arazzo.json', customOptions);
+ * ```
+ * @public
+ */
+export async function parse(source, options = {}) {
+  let mergedOptions = mergeOptions(defaultOptions, options);
+  const strict = mergedOptions.parse?.parserOpts?.strict ?? true;
+  let sourceProvenance;
+  if (isPlainObject(source)) {
+    const document = JSON.stringify(source, null, 2);
+    mergedOptions = mergeOptions(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document
+        }
+      }
+    });
+    source = 'memory://arazzo.json';
+    sourceProvenance = '[object]';
+  } else if (await detectArazzoJSON(source, {
+    strict
+  })) {
+    mergedOptions = mergeOptions(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://arazzo.json';
+    sourceProvenance = '[inline JSON]';
+  } else if (await detectArazzoYAML(source, {
+    strict
+  })) {
+    mergedOptions = mergeOptions(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://arazzo.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 parseURI(source, mergedOptions);
+
+    // set retrievalURI metadata for file/URL sources (not for inline content)
+    if (!source.startsWith('memory://')) {
+      parseResult.meta.set('retrievalURI', source);
+    }
+
+    // validate that the parsed document is an Arazzo specification
+    if (!isArazzoSpecification1Element(parseResult.api)) {
+      throw new UnmatchedParserError(`Could not find a parser that can parse "${sourceProvenance}" as an Arazzo specification`);
+    }
+    return parseResult;
+  } catch (error) {
+    throw new ParseError(`Failed to parse Arazzo Document from "${sourceProvenance}"`, {
+      cause: error
+    });
+  }
+}

package/src/parse-openapi.cjs

@@ -0,0 +1,234 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.defaultOptions = void 0;
+exports.parse = parse;
+var _empty = require("@speclynx/apidom-reference/configuration/empty");
+var _openapiJson = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/openapi-json-2"));
+var _openapiYaml = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/openapi-yaml-2"));
+var _openapiJson2 = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/openapi-json-3-0"));
+var _openapiYaml2 = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/openapi-yaml-3-0"));
+var _openapiJson3 = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/openapi-json-3-1"));
+var _openapiYaml3 = _interopRequireDefault(require("@speclynx/apidom-reference/parse/parsers/openapi-yaml-3-1"));
+var _apidomParserAdapterOpenapiJson = require("@speclynx/apidom-parser-adapter-openapi-json-3-1");
+var _apidomParserAdapterOpenapiYaml = require("@speclynx/apidom-parser-adapter-openapi-yaml-3-1");
+var _apidomParserAdapterOpenapiJson2 = require("@speclynx/apidom-parser-adapter-openapi-json-3-0");
+var _apidomParserAdapterOpenapiYaml2 = require("@speclynx/apidom-parser-adapter-openapi-yaml-3-0");
+var _apidomParserAdapterOpenapiJson3 = require("@speclynx/apidom-parser-adapter-openapi-json-2");
+var _apidomParserAdapterOpenapiYaml3 = require("@speclynx/apidom-parser-adapter-openapi-yaml-2");
+var _ramdaAdjunct = require("ramda-adjunct");
+var _ParseError = _interopRequireDefault(require("./errors/ParseError.cjs"));
+var _index = _interopRequireDefault(require("./resolve/resolvers/memory/index.cjs"));
+var _parseArazzo = require("./parse-arazzo.cjs");
+/**
+ * Options for parsing OpenAPI Documents.
+ * @public
+ */
+
+/**
+ * Default reference options for parsing OpenAPI Documents.
+ * @public
+ */
+const defaultOptions = exports.defaultOptions = {
+  parse: {
+    parsers: [new _openapiJson.default({
+      allowEmpty: false
+    }), new _openapiYaml.default({
+      allowEmpty: false
+    }), new _openapiJson2.default({
+      allowEmpty: false
+    }), new _openapiYaml2.default({
+      allowEmpty: false
+    }), new _openapiJson3.default({
+      allowEmpty: false
+    }), new _openapiYaml3.default({
+      allowEmpty: false
+    })],
+    parserOpts: {
+      ..._parseArazzo.defaultOptions.parse.parserOpts
+    }
+  },
+  resolve: {
+    resolvers: [new _index.default(), ..._parseArazzo.defaultOptions.resolve.resolvers.filter(r => r.name !== 'memory')],
+    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.
+ * @param source - The OpenAPI Document as a plain object, string content, or URI
+ * @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, _empty.mergeOptions)(defaultOptions, options);
+  const strict = mergedOptions.parse?.parserOpts?.strict ?? true;
+  let sourceProvenance;
+  if ((0, _ramdaAdjunct.isPlainObject)(source)) {
+    const document = JSON.stringify(source, null, 2);
+    mergedOptions = (0, _empty.mergeOptions)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document
+        }
+      }
+    });
+    source = 'memory://openapi.json';
+    sourceProvenance = '[object]';
+  } else if (await (0, _apidomParserAdapterOpenapiJson3.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0, _empty.mergeOptions)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.json';
+    sourceProvenance = '[inline JSON]';
+  } else if (await (0, _apidomParserAdapterOpenapiYaml3.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0, _empty.mergeOptions)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.yaml';
+    sourceProvenance = '[inline YAML]';
+  } else if (await (0, _apidomParserAdapterOpenapiJson2.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0, _empty.mergeOptions)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.json';
+    sourceProvenance = '[inline JSON]';
+  } else if (await (0, _apidomParserAdapterOpenapiYaml2.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0, _empty.mergeOptions)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.yaml';
+    sourceProvenance = '[inline YAML]';
+  } else if (await (0, _apidomParserAdapterOpenapiJson.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0, _empty.mergeOptions)(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.json';
+    sourceProvenance = '[inline JSON]';
+  } else if (await (0, _apidomParserAdapterOpenapiYaml.detect)(source, {
+    strict
+  })) {
+    mergedOptions = (0, _empty.mergeOptions)(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, _empty.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 _ParseError.default(`Failed to parse OpenAPI Document from "${sourceProvenance}"`, {
+      cause: error
+    });
+  }
+}

package/src/parse-openapi.mjs

@@ -0,0 +1,227 @@
+import { parse as parseURI, mergeOptions } from '@speclynx/apidom-reference/configuration/empty';
+import OpenApiJSON2Parser from '@speclynx/apidom-reference/parse/parsers/openapi-json-2';
+import OpenApiYAML2Parser from '@speclynx/apidom-reference/parse/parsers/openapi-yaml-2';
+import OpenApiJSON3_0Parser from '@speclynx/apidom-reference/parse/parsers/openapi-json-3-0';
+import OpenApiYAML3_0Parser from '@speclynx/apidom-reference/parse/parsers/openapi-yaml-3-0';
+import OpenApiJSON3_1Parser from '@speclynx/apidom-reference/parse/parsers/openapi-json-3-1';
+import OpenApiYAML3_1Parser from '@speclynx/apidom-reference/parse/parsers/openapi-yaml-3-1';
+import { detect as detectOpenApiJSON3_1 } from '@speclynx/apidom-parser-adapter-openapi-json-3-1';
+import { detect as detectOpenApiYAML3_1 } from '@speclynx/apidom-parser-adapter-openapi-yaml-3-1';
+import { detect as detectOpenApiJSON3_0 } from '@speclynx/apidom-parser-adapter-openapi-json-3-0';
+import { detect as detectOpenApiYAML3_0 } from '@speclynx/apidom-parser-adapter-openapi-yaml-3-0';
+import { detect as detectOpenApiJSON2 } from '@speclynx/apidom-parser-adapter-openapi-json-2';
+import { detect as detectOpenApiYAML2 } from '@speclynx/apidom-parser-adapter-openapi-yaml-2';
+import { isPlainObject } from 'ramda-adjunct';
+import ParseError from "./errors/ParseError.mjs";
+import MemoryResolver from "./resolve/resolvers/memory/index.mjs";
+import { defaultOptions as arazzoDefaultOptions } from "./parse-arazzo.mjs";
+/**
+ * Options for parsing OpenAPI Documents.
+ * @public
+ */
+/**
+ * Default reference options for parsing OpenAPI Documents.
+ * @public
+ */
+export const defaultOptions = {
+  parse: {
+    parsers: [new OpenApiJSON2Parser({
+      allowEmpty: false
+    }), new OpenApiYAML2Parser({
+      allowEmpty: false
+    }), new OpenApiJSON3_0Parser({
+      allowEmpty: false
+    }), new OpenApiYAML3_0Parser({
+      allowEmpty: false
+    }), new OpenApiJSON3_1Parser({
+      allowEmpty: false
+    }), new OpenApiYAML3_1Parser({
+      allowEmpty: false
+    })],
+    parserOpts: {
+      ...arazzoDefaultOptions.parse.parserOpts
+    }
+  },
+  resolve: {
+    resolvers: [new MemoryResolver(), ...arazzoDefaultOptions.resolve.resolvers.filter(r => r.name !== 'memory')],
+    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.
+ * @param source - The OpenAPI Document as a plain object, string content, or URI
+ * @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
+ */
+export async function parse(source, options = {}) {
+  let mergedOptions = mergeOptions(defaultOptions, options);
+  const strict = mergedOptions.parse?.parserOpts?.strict ?? true;
+  let sourceProvenance;
+  if (isPlainObject(source)) {
+    const document = JSON.stringify(source, null, 2);
+    mergedOptions = mergeOptions(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document
+        }
+      }
+    });
+    source = 'memory://openapi.json';
+    sourceProvenance = '[object]';
+  } else if (await detectOpenApiJSON2(source, {
+    strict
+  })) {
+    mergedOptions = mergeOptions(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.json';
+    sourceProvenance = '[inline JSON]';
+  } else if (await detectOpenApiYAML2(source, {
+    strict
+  })) {
+    mergedOptions = mergeOptions(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.yaml';
+    sourceProvenance = '[inline YAML]';
+  } else if (await detectOpenApiJSON3_0(source, {
+    strict
+  })) {
+    mergedOptions = mergeOptions(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.json';
+    sourceProvenance = '[inline JSON]';
+  } else if (await detectOpenApiYAML3_0(source, {
+    strict
+  })) {
+    mergedOptions = mergeOptions(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.yaml';
+    sourceProvenance = '[inline YAML]';
+  } else if (await detectOpenApiJSON3_1(source, {
+    strict
+  })) {
+    mergedOptions = mergeOptions(mergedOptions, {
+      resolve: {
+        resolverOpts: {
+          document: source
+        }
+      }
+    });
+    source = 'memory://openapi.json';
+    sourceProvenance = '[inline JSON]';
+  } else if (await detectOpenApiYAML3_1(source, {
+    strict
+  })) {
+    mergedOptions = mergeOptions(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 parseURI(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 ParseError(`Failed to parse OpenAPI Document from "${sourceProvenance}"`, {
+      cause: error
+    });
+  }
+}

package/src/resolve/resolvers/memory/index.cjs

@@ -0,0 +1,29 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = void 0;
+var _empty = require("@speclynx/apidom-reference/configuration/empty");
+/**
+ * @public
+ */
+class MemoryResolver extends _empty.Resolver {
+  constructor() {
+    super({
+      name: 'memory'
+    });
+  }
+  canRead(file) {
+    return file.uri.startsWith('memory://') && this.document !== undefined;
+  }
+  async read(file) {
+    try {
+      const encoder = new TextEncoder();
+      return encoder.encode(this.document);
+    } catch (error) {
+      throw new _empty.ResolverError(`Error opening file "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+var _default = exports.default = MemoryResolver;

package/src/resolve/resolvers/memory/index.mjs

@@ -0,0 +1,25 @@
+import { Resolver, ResolverError } from '@speclynx/apidom-reference/configuration/empty';
+/**
+ * @public
+ */
+class MemoryResolver extends Resolver {
+  constructor() {
+    super({
+      name: 'memory'
+    });
+  }
+  canRead(file) {
+    return file.uri.startsWith('memory://') && this.document !== undefined;
+  }
+  async read(file) {
+    try {
+      const encoder = new TextEncoder();
+      return encoder.encode(this.document);
+    } catch (error) {
+      throw new ResolverError(`Error opening file "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+export default MemoryResolver;