@usearazzo/parser 1.0.1-alpha.1 → 1.0.1-alpha.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usearazzo/parser",
-  "version": "1.0.1-alpha.1",
+  "version": "1.0.1-alpha.3",
   "description": "Parser for the Arazzo Specification language: documents, runtime expressions, and criterion conditions.",
   "keywords": [
     "arazzo",
@@ -52,26 +52,26 @@
   "author": "Vladimir Gorej <vladimir.gorej@gmail.com>",
   "license": "Apache-2.0",
   "dependencies": {
-    "@babel/runtime-corejs3": "^8.0.0",
-    "@speclynx/apidom-datamodel": "^5.2.2",
-    "@speclynx/apidom-error": "^5.2.2",
-    "@speclynx/apidom-ns-arazzo-1": "^5.2.2",
-    "@speclynx/apidom-parser-adapter-arazzo-json-1": "^5.2.2",
-    "@speclynx/apidom-parser-adapter-arazzo-yaml-1": "^5.2.2",
-    "@speclynx/apidom-parser-adapter-openapi-json-2": "^5.2.2",
-    "@speclynx/apidom-parser-adapter-openapi-json-3-0": "^5.2.2",
-    "@speclynx/apidom-parser-adapter-openapi-json-3-1": "^5.2.2",
-    "@speclynx/apidom-parser-adapter-openapi-yaml-2": "^5.2.2",
-    "@speclynx/apidom-parser-adapter-openapi-yaml-3-0": "^5.2.2",
-    "@speclynx/apidom-parser-adapter-openapi-yaml-3-1": "^5.2.2",
-    "@speclynx/apidom-reference": "^5.2.2",
+    "@babel/runtime-corejs3": "^8.0.5",
+    "@speclynx/apidom-datamodel": "^5.2.6",
+    "@speclynx/apidom-error": "^5.2.6",
+    "@speclynx/apidom-ns-arazzo-1": "^5.2.6",
+    "@speclynx/apidom-parser-adapter-arazzo-json-1": "^5.2.6",
+    "@speclynx/apidom-parser-adapter-arazzo-yaml-1": "^5.2.6",
+    "@speclynx/apidom-parser-adapter-openapi-json-2": "^5.2.6",
+    "@speclynx/apidom-parser-adapter-openapi-json-3-0": "^5.2.6",
+    "@speclynx/apidom-parser-adapter-openapi-json-3-1": "^5.2.6",
+    "@speclynx/apidom-parser-adapter-openapi-yaml-2": "^5.2.6",
+    "@speclynx/apidom-parser-adapter-openapi-yaml-3-0": "^5.2.6",
+    "@speclynx/apidom-parser-adapter-openapi-yaml-3-1": "^5.2.6",
+    "@speclynx/apidom-reference": "^5.2.6",
     "@swaggerexpert/arazzo-criterion": "^1.0.1",
     "@swaggerexpert/arazzo-runtime-expression": "^3.2.0",
     "ramda-adjunct": "^6.0.0",
     "type-fest": "^5.4.4"
   },
   "devDependencies": {
-    "@speclynx/apidom-core": "^5.2.2"
+    "@speclynx/apidom-core": "^5.2.6"
   },
   "files": [
     "src/**/*.mjs",
@@ -83,5 +83,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "fcbec52d36dee98bdf11fa6a96c9f3a5c39811b1"
+  "gitHead": "a2e566eb717faeba184c4c41f7b65a7c508bad7c"
 }

package/src/parse-arazzo.cjs

@@ -108,9 +108,11 @@ const defaultOptions = exports.defaultOptions = {
  * 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
+ * 3. URI string - if not detected as Arazzo content, treats as file system path or HTTP(S) URL.
+ *    A relative file system path resolves against the current working directory.
  *
- * @param source - The Arazzo Document as an object, string content, or a file system path / HTTP(S) URL
+ * @param source - The Arazzo Document as an object, string content, or a file system path / HTTP(S) URL.
+ *   A relative file system path resolves against the current working directory.
  * @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.
@@ -169,6 +171,18 @@ async function parse(source, options = {}) {
     sourceProvenance = '[inline YAML]';
   } else {
     sourceProvenance = _empty.url.isHttpUrl(source) || _empty.url.getProtocol(source) === 'file' || _empty.url.isURI(`file://${source}`) ? source : '[inline CONTENT]';
+
+    // a relative file system path resolves against the current working directory; the string
+    // doubles as the base URI for relative source description URLs, where a relative base
+    // resolves against the filesystem root instead of the document. Not gated on the
+    // provenance above: isURI(`file://${source}`) rejects a first segment with a space,
+    // which is a valid relative path. A leading slash or backslash (UNC, drive-rooted) is
+    // already rooted and passes through untouched. RegExp.test coerces a null/undefined
+    // passed at runtime despite the string type, deferring to parseURI below for a proper
+    // ParseError instead of throwing here.
+    if (!_empty.url.isHttpUrl(source) && _empty.url.getProtocol(source) !== 'file' && !/^[\\/]/.test(source)) {
+      source = _empty.url.resolve(_empty.url.fromFileSystemPath(_empty.url.cwd()), source);
+    }
   }
 
   // in-memory documents are served under their synthetic memory:// URI, or under the

package/src/parse-arazzo.mjs

@@ -99,9 +99,11 @@ export const defaultOptions = {
  * 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
+ * 3. URI string - if not detected as Arazzo content, treats as file system path or HTTP(S) URL.
+ *    A relative file system path resolves against the current working directory.
  *
- * @param source - The Arazzo Document as an object, string content, or a file system path / HTTP(S) URL
+ * @param source - The Arazzo Document as an object, string content, or a file system path / HTTP(S) URL.
+ *   A relative file system path resolves against the current working directory.
  * @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.
@@ -160,6 +162,18 @@ export async function parse(source, options = {}) {
     sourceProvenance = '[inline YAML]';
   } else {
     sourceProvenance = url.isHttpUrl(source) || url.getProtocol(source) === 'file' || url.isURI(`file://${source}`) ? source : '[inline CONTENT]';
+
+    // a relative file system path resolves against the current working directory; the string
+    // doubles as the base URI for relative source description URLs, where a relative base
+    // resolves against the filesystem root instead of the document. Not gated on the
+    // provenance above: isURI(`file://${source}`) rejects a first segment with a space,
+    // which is a valid relative path. A leading slash or backslash (UNC, drive-rooted) is
+    // already rooted and passes through untouched. RegExp.test coerces a null/undefined
+    // passed at runtime despite the string type, deferring to parseURI below for a proper
+    // ParseError instead of throwing here.
+    if (!url.isHttpUrl(source) && url.getProtocol(source) !== 'file' && !/^[\\/]/.test(source)) {
+      source = url.resolve(url.fromFileSystemPath(url.cwd()), source);
+    }
   }
 
   // in-memory documents are served under their synthetic memory:// URI, or under the

package/src/parse-openapi.cjs

@@ -91,9 +91,11 @@ const defaultOptions = exports.defaultOptions = {
  * 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
+ * 3. URI string - if not detected as OpenAPI content, treats as file system path or HTTP(S) URL.
+ *    A relative file system path resolves against the current working directory.
  *
- * @param source - The OpenAPI Document as an object, string content, or a file system path / HTTP(S) URL
+ * @param source - The OpenAPI Document as an object, string content, or a file system path / HTTP(S) URL.
+ *   A relative file system path resolves against the current working directory.
  * @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.
@@ -176,6 +178,16 @@ async function parse(source, options = {}) {
     sourceProvenance = '[inline YAML]';
   } else {
     sourceProvenance = source;
+
+    // a relative file system path resolves against the current working directory; the string
+    // doubles as the base URI for relative references, where a relative base resolves against
+    // the filesystem root instead of the document. A leading slash or backslash (UNC,
+    // drive-rooted) is already rooted and passes through untouched. RegExp.test coerces a
+    // null/undefined passed at runtime despite the string type, deferring to parseURI below
+    // for a proper ParseError instead of throwing here.
+    if (!_empty.url.isHttpUrl(source) && _empty.url.getProtocol(source) !== 'file' && !/^[\\/]/.test(source)) {
+      source = _empty.url.resolve(_empty.url.fromFileSystemPath(_empty.url.cwd()), source);
+    }
   }
 
   // in-memory documents are served under their synthetic memory:// URI, or under the

package/src/parse-openapi.mjs

@@ -1,4 +1,4 @@
-import { parse as parseURI } from '@speclynx/apidom-reference/configuration/empty';
+import { url, parse as parseURI } 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';
@@ -82,9 +82,11 @@ export const defaultOptions = {
  * 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
+ * 3. URI string - if not detected as OpenAPI content, treats as file system path or HTTP(S) URL.
+ *    A relative file system path resolves against the current working directory.
  *
- * @param source - The OpenAPI Document as an object, string content, or a file system path / HTTP(S) URL
+ * @param source - The OpenAPI Document as an object, string content, or a file system path / HTTP(S) URL.
+ *   A relative file system path resolves against the current working directory.
  * @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.
@@ -167,6 +169,16 @@ export async function parse(source, options = {}) {
     sourceProvenance = '[inline YAML]';
   } else {
     sourceProvenance = source;
+
+    // a relative file system path resolves against the current working directory; the string
+    // doubles as the base URI for relative references, where a relative base resolves against
+    // the filesystem root instead of the document. A leading slash or backslash (UNC,
+    // drive-rooted) is already rooted and passes through untouched. RegExp.test coerces a
+    // null/undefined passed at runtime despite the string type, deferring to parseURI below
+    // for a proper ParseError instead of throwing here.
+    if (!url.isHttpUrl(source) && url.getProtocol(source) !== 'file' && !/^[\\/]/.test(source)) {
+      source = url.resolve(url.fromFileSystemPath(url.cwd()), source);
+    }
   }
 
   // in-memory documents are served under their synthetic memory:// URI, or under the