@speclynx/apidom-parser 3.2.0 → 4.0.0

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [4.0.0](https://github.com/speclynx/apidom/compare/v3.2.1...v4.0.0) (2026-03-11)
+
+**Note:** Version bump only for package @speclynx/apidom-parser
+
+## [3.2.1](https://github.com/speclynx/apidom/compare/v3.2.0...v3.2.1) (2026-03-09)
+
+**Note:** Version bump only for package @speclynx/apidom-parser
+
 # [3.2.0](https://github.com/speclynx/apidom/compare/v3.1.0...v3.2.0) (2026-03-08)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speclynx/apidom-parser",
-  "version": "3.2.0",
+  "version": "4.0.0",
   "description": "Parser consumes parser adapters and provides unified API for parsing.",
   "keywords": [
     "apidom",
@@ -59,9 +59,9 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@babel/runtime-corejs3": "^7.28.4",
-    "@speclynx/apidom-core": "3.2.0",
-    "@speclynx/apidom-datamodel": "3.2.0",
-    "@speclynx/apidom-error": "3.2.0",
+    "@speclynx/apidom-core": "4.0.0",
+    "@speclynx/apidom-datamodel": "4.0.0",
+    "@speclynx/apidom-error": "4.0.0",
     "ramda": "~0.32.0",
     "ramda-adjunct": "^6.0.0"
   },
@@ -75,5 +75,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "eeb2f01cd34fb0a95617f02bc1b6683aefc028f2"
+  "gitHead": "384ff82a1bb68d015fd6801de641898b4b582876"
 }

package/src/errors/ParserError.cjs

@@ -1,24 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.default = void 0;
-var _apidomError = require("@speclynx/apidom-error");
-/**
- * @public
- */
-
-/**
- * @public
- */
-class ParserError extends _apidomError.ApiDOMStructuredError {
-  source;
-  parserOptions;
-  constructor(message, structuredOptions) {
-    super(message, structuredOptions);
-    if (typeof structuredOptions !== 'undefined') {
-      this.source = structuredOptions.source;
-      this.parserOptions = structuredOptions.parserOptions;
-    }
-  }
-}
-var _default = exports.default = ParserError;

package/src/errors/ParserError.mjs

@@ -1,21 +0,0 @@
-import { ApiDOMStructuredError } from '@speclynx/apidom-error';
-
-/**
- * @public
- */
-
-/**
- * @public
- */
-class ParserError extends ApiDOMStructuredError {
-  source;
-  parserOptions;
-  constructor(message, structuredOptions) {
-    super(message, structuredOptions);
-    if (typeof structuredOptions !== 'undefined') {
-      this.source = structuredOptions.source;
-      this.parserOptions = structuredOptions.parserOptions;
-    }
-  }
-}
-export default ParserError;

package/src/parser.cjs

@@ -1,117 +0,0 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
-exports.__esModule = true;
-exports.default = void 0;
-var _ramda = require("ramda");
-var _ramdaAdjunct = require("ramda-adjunct");
-var _apidomCore = require("@speclynx/apidom-core");
-var _ParserError = _interopRequireDefault(require("./errors/ParserError.cjs"));
-exports.ParserError = _ParserError.default;
-/**
- * @public
- */
-
-/**
- * @public
- */
-
-/**
- * @public
- */
-
-/**
- * @public
- */
-
-/**
- * @public
- */
-class ApiDOMParser {
-  adapters = [];
-  async detectAdapterCandidates(source, options = {}) {
-    const candidates = [];
-    for (const adapter of this.adapters) {
-      if ((0, _ramdaAdjunct.isFunction)(adapter.detect) && (await adapter.detect(source, options))) {
-        candidates.push(adapter);
-      }
-    }
-    return candidates;
-  }
-  async findAdapter(source, options = {}) {
-    if ((0, _ramdaAdjunct.isString)(options.mediaType)) {
-      return this.adapters.find(adapter => {
-        if (!(0, _ramdaAdjunct.isArray)(adapter.mediaTypes)) return false;
-        return adapter.mediaTypes.includes(options.mediaType);
-      });
-    }
-    const candidates = await this.detectAdapterCandidates(source, options);
-    return (0, _ramda.head)(candidates);
-  }
-  use(adapter) {
-    this.adapters.push(adapter);
-    return this;
-  }
-  async findNamespace(source, options = {}) {
-    const adapter = await this.findAdapter(source, options);
-    return adapter?.namespace;
-  }
-  async findMediaType(source) {
-    const adapter = await this.findAdapter(source, {});
-    if (typeof adapter === 'undefined') {
-      return new _apidomCore.MediaTypes().unknownMediaType;
-    }
-    if (typeof adapter.mediaTypes === 'undefined') {
-      return new _apidomCore.MediaTypes().unknownMediaType;
-    }
-    if (typeof adapter.detectionRegExp === 'undefined') {
-      return adapter.mediaTypes.latest();
-    }
-    const {
-      detectionRegExp
-    } = adapter;
-    const matches = source.match(detectionRegExp);
-    if (matches === null) {
-      return new _apidomCore.MediaTypes().unknownMediaType;
-    }
-    const {
-      groups
-    } = matches;
-    const version = groups?.version || groups?.version_json || groups?.version_yaml;
-    const format = groups?.version_json ? 'json' : groups?.version_yaml ? 'yaml' : 'generic';
-    if (typeof version === 'undefined') {
-      return adapter.mediaTypes.latest();
-    }
-
-    // @ts-ignore
-    return adapter.mediaTypes.findBy(version, format);
-  }
-  async parse(source, options = {}) {
-    let adapter;
-    try {
-      adapter = await this.findAdapter(source, options);
-    } catch (error) {
-      throw new _ParserError.default('Encountered an unexpected error while matching parser adapters against the source.', {
-        source,
-        parserOptions: options,
-        cause: error
-      });
-    }
-    if ((0, _ramdaAdjunct.isUndefined)(adapter)) {
-      throw new _ParserError.default('Source did not match any registered parsers', {
-        source,
-        parserOptions: options
-      });
-    }
-    try {
-      return adapter.parse(source, options);
-    } catch (error) {
-      throw new _ParserError.default('Parsing encountered an unexpected error.', {
-        source,
-        parserOptions: options,
-        cause: error
-      });
-    }
-  }
-}
-var _default = exports.default = ApiDOMParser;

package/src/parser.mjs

@@ -1,113 +0,0 @@
-import { head } from 'ramda';
-import { isArray, isFunction, isString, isUndefined } from 'ramda-adjunct';
-import { MediaTypes } from '@speclynx/apidom-core';
-import ParserError from "./errors/ParserError.mjs";
-export { ParserError };
-
-/**
- * @public
- */
-
-/**
- * @public
- */
-
-/**
- * @public
- */
-
-/**
- * @public
- */
-
-/**
- * @public
- */
-class ApiDOMParser {
-  adapters = [];
-  async detectAdapterCandidates(source, options = {}) {
-    const candidates = [];
-    for (const adapter of this.adapters) {
-      if (isFunction(adapter.detect) && (await adapter.detect(source, options))) {
-        candidates.push(adapter);
-      }
-    }
-    return candidates;
-  }
-  async findAdapter(source, options = {}) {
-    if (isString(options.mediaType)) {
-      return this.adapters.find(adapter => {
-        if (!isArray(adapter.mediaTypes)) return false;
-        return adapter.mediaTypes.includes(options.mediaType);
-      });
-    }
-    const candidates = await this.detectAdapterCandidates(source, options);
-    return head(candidates);
-  }
-  use(adapter) {
-    this.adapters.push(adapter);
-    return this;
-  }
-  async findNamespace(source, options = {}) {
-    const adapter = await this.findAdapter(source, options);
-    return adapter?.namespace;
-  }
-  async findMediaType(source) {
-    const adapter = await this.findAdapter(source, {});
-    if (typeof adapter === 'undefined') {
-      return new MediaTypes().unknownMediaType;
-    }
-    if (typeof adapter.mediaTypes === 'undefined') {
-      return new MediaTypes().unknownMediaType;
-    }
-    if (typeof adapter.detectionRegExp === 'undefined') {
-      return adapter.mediaTypes.latest();
-    }
-    const {
-      detectionRegExp
-    } = adapter;
-    const matches = source.match(detectionRegExp);
-    if (matches === null) {
-      return new MediaTypes().unknownMediaType;
-    }
-    const {
-      groups
-    } = matches;
-    const version = groups?.version || groups?.version_json || groups?.version_yaml;
-    const format = groups?.version_json ? 'json' : groups?.version_yaml ? 'yaml' : 'generic';
-    if (typeof version === 'undefined') {
-      return adapter.mediaTypes.latest();
-    }
-
-    // @ts-ignore
-    return adapter.mediaTypes.findBy(version, format);
-  }
-  async parse(source, options = {}) {
-    let adapter;
-    try {
-      adapter = await this.findAdapter(source, options);
-    } catch (error) {
-      throw new ParserError('Encountered an unexpected error while matching parser adapters against the source.', {
-        source,
-        parserOptions: options,
-        cause: error
-      });
-    }
-    if (isUndefined(adapter)) {
-      throw new ParserError('Source did not match any registered parsers', {
-        source,
-        parserOptions: options
-      });
-    }
-    try {
-      return adapter.parse(source, options);
-    } catch (error) {
-      throw new ParserError('Parsing encountered an unexpected error.', {
-        source,
-        parserOptions: options,
-        cause: error
-      });
-    }
-  }
-}
-export default ApiDOMParser;