@speclynx/apidom-reference 4.0.2 → 4.0.3

package/src/dereference/strategies/openapi-3-1/util.cjs

@@ -0,0 +1,68 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
+exports.__esModule = true;
+exports.resolveSchema$refField = exports.resolveSchema$idField = exports.refractToSchemaElement = exports.maybeRefractToSchemaElement = void 0;
+var _ramda = require("ramda");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+var _apidomCore = require("@speclynx/apidom-core");
+var _apidomNsOpenapi = require("@speclynx/apidom-ns-openapi-3-1");
+var url = _interopRequireWildcard(require("../../../util/url.cjs"));
+/**
+ * @public
+ */
+const resolveSchema$refField = (retrievalURI, schemaElement) => {
+  if (typeof schemaElement.$ref === 'undefined') {
+    return undefined;
+  }
+  const hash = url.getHash((0, _apidomCore.toValue)(schemaElement.$ref));
+  const ancestorsSchemaIdentifiers = schemaElement.meta.get('ancestorsSchemaIdentifiers');
+  const $refBaseURI = (0, _ramda.reduce)((acc, uri) => {
+    return url.resolve(acc, url.sanitize(url.stripHash(uri)));
+  }, retrievalURI, [...ancestorsSchemaIdentifiers, (0, _apidomCore.toValue)(schemaElement.$ref)]);
+  return `${$refBaseURI}${hash === '#' ? '' : hash}`;
+};
+
+/**
+ * @public
+ */
+exports.resolveSchema$refField = resolveSchema$refField;
+const resolveSchema$idField = (retrievalURI, schemaElement) => {
+  if (typeof schemaElement.$id === 'undefined') {
+    return undefined;
+  }
+  const ancestorsSchemaIdentifiers = schemaElement.meta.get('ancestorsSchemaIdentifiers');
+  return (0, _ramda.reduce)((acc, $id) => {
+    return url.resolve(acc, url.sanitize(url.stripHash($id)));
+  }, retrievalURI, ancestorsSchemaIdentifiers);
+};
+
+/**
+ * Cached version of SchemaElement.refract.
+ */
+exports.resolveSchema$idField = resolveSchema$idField;
+const refractToSchemaElement = element => {
+  if (refractToSchemaElement.cache.has(element)) {
+    return refractToSchemaElement.cache.get(element);
+  }
+  const refracted = (0, _apidomNsOpenapi.refractSchema)(element);
+  refractToSchemaElement.cache.set(element, refracted);
+  return refracted;
+};
+exports.refractToSchemaElement = refractToSchemaElement;
+refractToSchemaElement.cache = new WeakMap();
+
+/**
+ * @public
+ */
+const maybeRefractToSchemaElement = element => {
+  /**
+   * Conditional version of refractToSchemaElement, that acts as an identity
+   * function for all non-primitive Element instances.
+   */
+  if ((0, _apidomDatamodel.isPrimitiveElement)(element)) {
+    return refractToSchemaElement(element);
+  }
+  return element;
+};
+exports.maybeRefractToSchemaElement = maybeRefractToSchemaElement;

package/src/dereference/strategies/openapi-3-1/util.mjs

@@ -0,0 +1,59 @@
+import { reduce } from 'ramda';
+import { isPrimitiveElement } from '@speclynx/apidom-datamodel';
+import { toValue } from '@speclynx/apidom-core';
+import { refractSchema } from '@speclynx/apidom-ns-openapi-3-1';
+import * as url from "../../../util/url.mjs";
+/**
+ * @public
+ */
+export const resolveSchema$refField = (retrievalURI, schemaElement) => {
+  if (typeof schemaElement.$ref === 'undefined') {
+    return undefined;
+  }
+  const hash = url.getHash(toValue(schemaElement.$ref));
+  const ancestorsSchemaIdentifiers = schemaElement.meta.get('ancestorsSchemaIdentifiers');
+  const $refBaseURI = reduce((acc, uri) => {
+    return url.resolve(acc, url.sanitize(url.stripHash(uri)));
+  }, retrievalURI, [...ancestorsSchemaIdentifiers, toValue(schemaElement.$ref)]);
+  return `${$refBaseURI}${hash === '#' ? '' : hash}`;
+};
+
+/**
+ * @public
+ */
+export const resolveSchema$idField = (retrievalURI, schemaElement) => {
+  if (typeof schemaElement.$id === 'undefined') {
+    return undefined;
+  }
+  const ancestorsSchemaIdentifiers = schemaElement.meta.get('ancestorsSchemaIdentifiers');
+  return reduce((acc, $id) => {
+    return url.resolve(acc, url.sanitize(url.stripHash($id)));
+  }, retrievalURI, ancestorsSchemaIdentifiers);
+};
+
+/**
+ * Cached version of SchemaElement.refract.
+ */
+export const refractToSchemaElement = element => {
+  if (refractToSchemaElement.cache.has(element)) {
+    return refractToSchemaElement.cache.get(element);
+  }
+  const refracted = refractSchema(element);
+  refractToSchemaElement.cache.set(element, refracted);
+  return refracted;
+};
+refractToSchemaElement.cache = new WeakMap();
+
+/**
+ * @public
+ */
+export const maybeRefractToSchemaElement = element => {
+  /**
+   * Conditional version of refractToSchemaElement, that acts as an identity
+   * function for all non-primitive Element instances.
+   */
+  if (isPrimitiveElement(element)) {
+    return refractToSchemaElement(element);
+  }
+  return element;
+};

package/src/dereference/strategies/openapi-3-1/util.ts

@@ -0,0 +1,83 @@
+import { reduce } from 'ramda';
+import { Element, isPrimitiveElement } from '@speclynx/apidom-datamodel';
+import { toValue } from '@speclynx/apidom-core';
+import { JSONSchemaElement } from '@speclynx/apidom-ns-json-schema-2020-12';
+import { refractSchema } from '@speclynx/apidom-ns-openapi-3-1';
+
+import * as url from '../../../util/url.ts';
+
+/**
+ * @public
+ */
+export const resolveSchema$refField = (retrievalURI: string, schemaElement: JSONSchemaElement) => {
+  if (typeof schemaElement.$ref === 'undefined') {
+    return undefined;
+  }
+
+  const hash = url.getHash(toValue(schemaElement.$ref) as string);
+  const ancestorsSchemaIdentifiers = schemaElement.meta.get(
+    'ancestorsSchemaIdentifiers',
+  ) as string[];
+  const $refBaseURI = reduce(
+    (acc: string, uri: string): string => {
+      return url.resolve(acc, url.sanitize(url.stripHash(uri)));
+    },
+    retrievalURI,
+    [...ancestorsSchemaIdentifiers, toValue(schemaElement.$ref) as string],
+  );
+
+  return `${$refBaseURI}${hash === '#' ? '' : hash}`;
+};
+
+/**
+ * @public
+ */
+export const resolveSchema$idField = (
+  retrievalURI: string,
+  schemaElement: JSONSchemaElement,
+): string | undefined => {
+  if (typeof schemaElement.$id === 'undefined') {
+    return undefined;
+  }
+
+  const ancestorsSchemaIdentifiers = schemaElement.meta.get(
+    'ancestorsSchemaIdentifiers',
+  ) as string[];
+
+  return reduce(
+    (acc: string, $id: string): string => {
+      return url.resolve(acc, url.sanitize(url.stripHash($id)));
+    },
+    retrievalURI,
+    ancestorsSchemaIdentifiers,
+  );
+};
+
+/**
+ * Cached version of SchemaElement.refract.
+ */
+export const refractToSchemaElement = <T extends Element>(element: T) => {
+  if (refractToSchemaElement.cache.has(element)) {
+    return refractToSchemaElement.cache.get(element);
+  }
+
+  const refracted = refractSchema(element);
+  refractToSchemaElement.cache.set(element, refracted);
+  return refracted;
+};
+refractToSchemaElement.cache = new WeakMap();
+
+/**
+ * @public
+ */
+export const maybeRefractToSchemaElement = <T extends Element>(element: T) => {
+  /**
+   * Conditional version of refractToSchemaElement, that acts as an identity
+   * function for all non-primitive Element instances.
+   */
+  if (isPrimitiveElement(element)) {
+    return refractToSchemaElement(element);
+  }
+
+  return element;
+};