@speclynx/apidom-reference 1.12.1

package/src/parse/parsers/asyncapi-json-2/index.mjs

@@ -0,0 +1,49 @@
+import { pick } from 'ramda';
+import { parse, mediaTypes as AsyncAPI2MediaTypes, detect } from '@speclynx/apidom-parser-adapter-asyncapi-json-2';
+import ParserError from "../../../errors/ParserError.mjs";
+import Parser from "../Parser.mjs";
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class AsyncAPIJSON2Parser extends Parser {
+  syntacticAnalysis;
+  refractorOpts;
+  constructor(options) {
+    const {
+      fileExtensions = [],
+      mediaTypes = AsyncAPI2MediaTypes,
+      ...rest
+    } = options ?? {};
+    super({
+      ...rest,
+      name: 'asyncapi-json-2',
+      fileExtensions,
+      mediaTypes
+    });
+  }
+  async canParse(file) {
+    const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    if (!hasSupportedFileExtension) return false;
+    if (hasSupportedMediaType) return true;
+    if (!hasSupportedMediaType) {
+      return detect(file.toString());
+    }
+    return false;
+  }
+  async parse(file) {
+    const source = file.toString();
+    try {
+      const parserOpts = pick(['sourceMap', 'syntacticAnalysis', 'refractorOpts'], this);
+      return await parse(source, parserOpts);
+    } catch (error) {
+      throw new ParserError(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+export default AsyncAPIJSON2Parser;

package/src/parse/parsers/asyncapi-yaml-2/index.cjs

@@ -0,0 +1,54 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _ramda = require("ramda");
+var _apidomParserAdapterAsyncapiYaml = require("@speclynx/apidom-parser-adapter-asyncapi-yaml-2");
+var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
+var _Parser = _interopRequireDefault(require("../Parser.cjs"));
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class AsyncAPIYAML2Parser extends _Parser.default {
+  refractorOpts;
+  constructor(options) {
+    const {
+      fileExtensions = [],
+      mediaTypes = _apidomParserAdapterAsyncapiYaml.mediaTypes,
+      ...rest
+    } = options ?? {};
+    super({
+      ...rest,
+      name: 'asyncapi-yaml-2',
+      fileExtensions,
+      mediaTypes
+    });
+  }
+  async canParse(file) {
+    const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    if (!hasSupportedFileExtension) return false;
+    if (hasSupportedMediaType) return true;
+    if (!hasSupportedMediaType) {
+      return (0, _apidomParserAdapterAsyncapiYaml.detect)(file.toString());
+    }
+    return false;
+  }
+  async parse(file) {
+    const source = file.toString();
+    try {
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'refractorOpts'], this);
+      return await (0, _apidomParserAdapterAsyncapiYaml.parse)(source, parserOpts);
+    } catch (error) {
+      throw new _ParserError.default(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+var _default = exports.default = AsyncAPIYAML2Parser;

package/src/parse/parsers/asyncapi-yaml-2/index.mjs

@@ -0,0 +1,48 @@
+import { pick } from 'ramda';
+import { parse, mediaTypes as AsyncAPI2MediaTypes, detect } from '@speclynx/apidom-parser-adapter-asyncapi-yaml-2';
+import ParserError from "../../../errors/ParserError.mjs";
+import Parser from "../Parser.mjs";
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class AsyncAPIYAML2Parser extends Parser {
+  refractorOpts;
+  constructor(options) {
+    const {
+      fileExtensions = [],
+      mediaTypes = AsyncAPI2MediaTypes,
+      ...rest
+    } = options ?? {};
+    super({
+      ...rest,
+      name: 'asyncapi-yaml-2',
+      fileExtensions,
+      mediaTypes
+    });
+  }
+  async canParse(file) {
+    const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    if (!hasSupportedFileExtension) return false;
+    if (hasSupportedMediaType) return true;
+    if (!hasSupportedMediaType) {
+      return detect(file.toString());
+    }
+    return false;
+  }
+  async parse(file) {
+    const source = file.toString();
+    try {
+      const parserOpts = pick(['sourceMap', 'refractorOpts'], this);
+      return await parse(source, parserOpts);
+    } catch (error) {
+      throw new ParserError(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+export default AsyncAPIYAML2Parser;

package/src/parse/parsers/binary/index-browser.cjs

@@ -0,0 +1,56 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _apidomCore = require("@speclynx/apidom-core");
+var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
+var _Parser = _interopRequireDefault(require("../Parser.cjs"));
+/**
+ * Everything that is not recognized by other parsers will be considered by this parser
+ * as a binary data and will be encoded to Base64 format.
+ * @public
+ */
+
+/**
+ * @public
+ */
+class BinaryParser extends _Parser.default {
+  constructor(options) {
+    super({
+      ...(options ?? {}),
+      name: 'binary'
+    });
+  }
+  canParse(file) {
+    return this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+  }
+  parse(file) {
+    try {
+      /**
+       * More information about binary strings and btoa function in following link:
+       *   https://developer.mozilla.org/en-US/docs/Web/API/btoa
+       *
+       * @example
+       * ArrayBuffer to base64 conversion:
+       *
+       * const binaryString = String.fromCharCode.apply(null, file.data);
+       * base64String = btoa(binaryString);
+       */
+      const binaryString = unescape(encodeURIComponent(file.toString()));
+      const base64String = btoa(binaryString);
+      const parseResultElement = new _apidomCore.ParseResultElement();
+      if (base64String.length !== 0) {
+        const base64StringElement = new _apidomCore.StringElement(base64String);
+        base64StringElement.classes.push('result');
+        parseResultElement.push(base64StringElement);
+      }
+      return parseResultElement;
+    } catch (error) {
+      throw new _ParserError.default(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+var _default = exports.default = BinaryParser;

package/src/parse/parsers/binary/index-browser.mjs

@@ -0,0 +1,50 @@
+import { ParseResultElement, StringElement } from '@speclynx/apidom-core';
+import ParserError from "../../../errors/ParserError.mjs";
+import Parser from "../Parser.mjs";
+/**
+ * Everything that is not recognized by other parsers will be considered by this parser
+ * as a binary data and will be encoded to Base64 format.
+ * @public
+ */
+/**
+ * @public
+ */
+class BinaryParser extends Parser {
+  constructor(options) {
+    super({
+      ...(options ?? {}),
+      name: 'binary'
+    });
+  }
+  canParse(file) {
+    return this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+  }
+  parse(file) {
+    try {
+      /**
+       * More information about binary strings and btoa function in following link:
+       *   https://developer.mozilla.org/en-US/docs/Web/API/btoa
+       *
+       * @example
+       * ArrayBuffer to base64 conversion:
+       *
+       * const binaryString = String.fromCharCode.apply(null, file.data);
+       * base64String = btoa(binaryString);
+       */
+      const binaryString = unescape(encodeURIComponent(file.toString()));
+      const base64String = btoa(binaryString);
+      const parseResultElement = new ParseResultElement();
+      if (base64String.length !== 0) {
+        const base64StringElement = new StringElement(base64String);
+        base64StringElement.classes.push('result');
+        parseResultElement.push(base64StringElement);
+      }
+      return parseResultElement;
+    } catch (error) {
+      throw new ParserError(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+export default BinaryParser;

package/src/parse/parsers/binary/index-node.cjs

@@ -0,0 +1,51 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _nodeBuffer = require("node:buffer");
+var _apidomCore = require("@speclynx/apidom-core");
+var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
+var _Parser = _interopRequireDefault(require("../Parser.cjs"));
+/**
+ * Everything that is not recognized by other parsers will be considered by this parser
+ * as a binary data and will be encoded to Base64 format.
+ * @public
+ */
+
+/**
+ * @public
+ */
+class BinaryParser extends _Parser.default {
+  constructor(options) {
+    super({
+      ...(options ?? {}),
+      name: 'binary'
+    });
+  }
+  canParse(file) {
+    return this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+  }
+  parse(file) {
+    let base64String;
+    try {
+      base64String = _nodeBuffer.Buffer.from(file.data).toString('base64');
+    } catch {
+      base64String = _nodeBuffer.Buffer.from(file.toString()).toString('base64');
+    }
+    try {
+      const parseResultElement = new _apidomCore.ParseResultElement();
+      if (base64String.length !== 0) {
+        const base64StringElement = new _apidomCore.StringElement(base64String);
+        base64StringElement.classes.push('result');
+        parseResultElement.push(base64StringElement);
+      }
+      return parseResultElement;
+    } catch (error) {
+      throw new _ParserError.default(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+var _default = exports.default = BinaryParser;

package/src/parse/parsers/binary/index-node.mjs

@@ -0,0 +1,45 @@
+import { Buffer } from 'node:buffer';
+import { ParseResultElement, StringElement } from '@speclynx/apidom-core';
+import ParserError from "../../../errors/ParserError.mjs";
+import Parser from "../Parser.mjs";
+/**
+ * Everything that is not recognized by other parsers will be considered by this parser
+ * as a binary data and will be encoded to Base64 format.
+ * @public
+ */
+/**
+ * @public
+ */
+class BinaryParser extends Parser {
+  constructor(options) {
+    super({
+      ...(options ?? {}),
+      name: 'binary'
+    });
+  }
+  canParse(file) {
+    return this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+  }
+  parse(file) {
+    let base64String;
+    try {
+      base64String = Buffer.from(file.data).toString('base64');
+    } catch {
+      base64String = Buffer.from(file.toString()).toString('base64');
+    }
+    try {
+      const parseResultElement = new ParseResultElement();
+      if (base64String.length !== 0) {
+        const base64StringElement = new StringElement(base64String);
+        base64StringElement.classes.push('result');
+        parseResultElement.push(base64StringElement);
+      }
+      return parseResultElement;
+    } catch (error) {
+      throw new ParserError(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+export default BinaryParser;

package/src/parse/parsers/json/index.cjs

@@ -0,0 +1,54 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _ramda = require("ramda");
+var _apidomParserAdapterJson = require("@speclynx/apidom-parser-adapter-json");
+var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
+var _Parser = _interopRequireDefault(require("../Parser.cjs"));
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class JSONParser extends _Parser.default {
+  syntacticAnalysis;
+  constructor(options) {
+    const {
+      fileExtensions = [],
+      mediaTypes = _apidomParserAdapterJson.mediaTypes,
+      ...rest
+    } = options ?? {};
+    super({
+      ...rest,
+      name: 'json',
+      fileExtensions,
+      mediaTypes
+    });
+  }
+  async canParse(file) {
+    const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    if (!hasSupportedFileExtension) return false;
+    if (hasSupportedMediaType) return true;
+    if (!hasSupportedMediaType) {
+      return (0, _apidomParserAdapterJson.detect)(file.toString());
+    }
+    return false;
+  }
+  async parse(file) {
+    const source = file.toString();
+    try {
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'syntacticAnalysis'], this);
+      return await (0, _apidomParserAdapterJson.parse)(source, parserOpts);
+    } catch (error) {
+      throw new _ParserError.default(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+var _default = exports.default = JSONParser;

package/src/parse/parsers/json/index.mjs

@@ -0,0 +1,48 @@
+import { pick } from 'ramda';
+import { parse, mediaTypes as JSONMediaTypes, detect } from '@speclynx/apidom-parser-adapter-json';
+import ParserError from "../../../errors/ParserError.mjs";
+import Parser from "../Parser.mjs";
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class JSONParser extends Parser {
+  syntacticAnalysis;
+  constructor(options) {
+    const {
+      fileExtensions = [],
+      mediaTypes = JSONMediaTypes,
+      ...rest
+    } = options ?? {};
+    super({
+      ...rest,
+      name: 'json',
+      fileExtensions,
+      mediaTypes
+    });
+  }
+  async canParse(file) {
+    const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    if (!hasSupportedFileExtension) return false;
+    if (hasSupportedMediaType) return true;
+    if (!hasSupportedMediaType) {
+      return detect(file.toString());
+    }
+    return false;
+  }
+  async parse(file) {
+    const source = file.toString();
+    try {
+      const parserOpts = pick(['sourceMap', 'syntacticAnalysis'], this);
+      return await parse(source, parserOpts);
+    } catch (error) {
+      throw new ParserError(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+export default JSONParser;

package/src/parse/parsers/openapi-json-2/index.cjs

@@ -0,0 +1,55 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _ramda = require("ramda");
+var _apidomParserAdapterOpenapiJson = require("@speclynx/apidom-parser-adapter-openapi-json-2");
+var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
+var _Parser = _interopRequireDefault(require("../Parser.cjs"));
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class OpenAPIJSON2Parser extends _Parser.default {
+  syntacticAnalysis;
+  refractorOpts;
+  constructor(options) {
+    const {
+      fileExtensions = [],
+      mediaTypes = _apidomParserAdapterOpenapiJson.mediaTypes,
+      ...rest
+    } = options ?? {};
+    super({
+      ...rest,
+      name: 'openapi-json-2',
+      fileExtensions,
+      mediaTypes
+    });
+  }
+  async canParse(file) {
+    const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    if (!hasSupportedFileExtension) return false;
+    if (hasSupportedMediaType) return true;
+    if (!hasSupportedMediaType) {
+      return (0, _apidomParserAdapterOpenapiJson.detect)(file.toString());
+    }
+    return false;
+  }
+  async parse(file) {
+    const source = file.toString();
+    try {
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'syntacticAnalysis', 'refractorOpts'], this);
+      return await (0, _apidomParserAdapterOpenapiJson.parse)(source, parserOpts);
+    } catch (error) {
+      throw new _ParserError.default(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+var _default = exports.default = OpenAPIJSON2Parser;

package/src/parse/parsers/openapi-json-2/index.mjs

@@ -0,0 +1,49 @@
+import { pick } from 'ramda';
+import { parse, mediaTypes as OpenAPI2MediaTypes, detect } from '@speclynx/apidom-parser-adapter-openapi-json-2';
+import ParserError from "../../../errors/ParserError.mjs";
+import Parser from "../Parser.mjs";
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class OpenAPIJSON2Parser extends Parser {
+  syntacticAnalysis;
+  refractorOpts;
+  constructor(options) {
+    const {
+      fileExtensions = [],
+      mediaTypes = OpenAPI2MediaTypes,
+      ...rest
+    } = options ?? {};
+    super({
+      ...rest,
+      name: 'openapi-json-2',
+      fileExtensions,
+      mediaTypes
+    });
+  }
+  async canParse(file) {
+    const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    if (!hasSupportedFileExtension) return false;
+    if (hasSupportedMediaType) return true;
+    if (!hasSupportedMediaType) {
+      return detect(file.toString());
+    }
+    return false;
+  }
+  async parse(file) {
+    const source = file.toString();
+    try {
+      const parserOpts = pick(['sourceMap', 'syntacticAnalysis', 'refractorOpts'], this);
+      return await parse(source, parserOpts);
+    } catch (error) {
+      throw new ParserError(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+export default OpenAPIJSON2Parser;

package/src/parse/parsers/openapi-json-3-0/index.cjs

@@ -0,0 +1,55 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _ramda = require("ramda");
+var _apidomParserAdapterOpenapiJson = require("@speclynx/apidom-parser-adapter-openapi-json-3-0");
+var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
+var _Parser = _interopRequireDefault(require("../Parser.cjs"));
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class OpenAPIJSON3_0Parser extends _Parser.default {
+  syntacticAnalysis;
+  refractorOpts;
+  constructor(options) {
+    const {
+      fileExtensions = [],
+      mediaTypes = _apidomParserAdapterOpenapiJson.mediaTypes,
+      ...rest
+    } = options ?? {};
+    super({
+      ...rest,
+      name: 'openapi-json-3-0',
+      fileExtensions,
+      mediaTypes
+    });
+  }
+  async canParse(file) {
+    const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    if (!hasSupportedFileExtension) return false;
+    if (hasSupportedMediaType) return true;
+    if (!hasSupportedMediaType) {
+      return (0, _apidomParserAdapterOpenapiJson.detect)(file.toString());
+    }
+    return false;
+  }
+  async parse(file) {
+    const source = file.toString();
+    try {
+      const parserOpts = (0, _ramda.pick)(['sourceMap', 'syntacticAnalysis', 'refractorOpts'], this);
+      return await (0, _apidomParserAdapterOpenapiJson.parse)(source, parserOpts);
+    } catch (error) {
+      throw new _ParserError.default(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+var _default = exports.default = OpenAPIJSON3_0Parser;

package/src/parse/parsers/openapi-json-3-0/index.mjs

@@ -0,0 +1,49 @@
+import { pick } from 'ramda';
+import { parse, mediaTypes as OpenAPI3_0MediaTypes, detect } from '@speclynx/apidom-parser-adapter-openapi-json-3-0';
+import ParserError from "../../../errors/ParserError.mjs";
+import Parser from "../Parser.mjs";
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class OpenAPIJSON3_0Parser extends Parser {
+  syntacticAnalysis;
+  refractorOpts;
+  constructor(options) {
+    const {
+      fileExtensions = [],
+      mediaTypes = OpenAPI3_0MediaTypes,
+      ...rest
+    } = options ?? {};
+    super({
+      ...rest,
+      name: 'openapi-json-3-0',
+      fileExtensions,
+      mediaTypes
+    });
+  }
+  async canParse(file) {
+    const hasSupportedFileExtension = this.fileExtensions.length === 0 ? true : this.fileExtensions.includes(file.extension);
+    const hasSupportedMediaType = this.mediaTypes.includes(file.mediaType);
+    if (!hasSupportedFileExtension) return false;
+    if (hasSupportedMediaType) return true;
+    if (!hasSupportedMediaType) {
+      return detect(file.toString());
+    }
+    return false;
+  }
+  async parse(file) {
+    const source = file.toString();
+    try {
+      const parserOpts = pick(['sourceMap', 'syntacticAnalysis', 'refractorOpts'], this);
+      return await parse(source, parserOpts);
+    } catch (error) {
+      throw new ParserError(`Error parsing "${file.uri}"`, {
+        cause: error
+      });
+    }
+  }
+}
+export default OpenAPIJSON3_0Parser;