@speclynx/apidom-ns-openapi-2 4.0.2 → 4.0.3

package/src/predicates.ts

@@ -0,0 +1,194 @@
+import SwaggerElement from './elements/Swagger.ts';
+import SwaggerVersionElement from './elements/SwaggerVersion.ts';
+import InfoElement from './elements/Info.ts';
+import ContactElement from './elements/Contact.ts';
+import LicenseElement from './elements/License.ts';
+import PathsElement from './elements/Paths.ts';
+import PathItemElement from './elements/PathItem.ts';
+import OperationElement from './elements/Operation.ts';
+import ExternalDocumentationElement from './elements/ExternalDocumentation.ts';
+import ParameterElement from './elements/Parameter.ts';
+import ItemsElement from './elements/Items.ts';
+import ExampleElement from './elements/Example.ts';
+import ResponsesElement from './elements/Responses.ts';
+import ResponseElement from './elements/Response.ts';
+import HeadersElement from './elements/Headers.ts';
+import HeaderElement from './elements/Header.ts';
+import TagElement from './elements/Tag.ts';
+import ReferenceElement from './elements/Reference.ts';
+import SchemaElement from './elements/Schema.ts';
+import XmlElement from './elements/Xml.ts';
+import DefinitionsElement from './elements/Definitions.ts';
+import ParametersDefinitionsElement from './elements/ParametersDefinitions.ts';
+import ResponsesDefinitionsElement from './elements/ResponsesDefinitions.ts';
+import SecurityDefinitionsElement from './elements/SecurityDefinitions.ts';
+import SecuritySchemeElement from './elements/SecurityScheme.ts';
+import SecurityRequirementElement from './elements/SecurityRequirement.ts';
+import ScopesElement from './elements/Scopes.ts';
+
+/**
+ * @public
+ */
+export const isSwaggerElement = (element: unknown): element is SwaggerElement =>
+  element instanceof SwaggerElement;
+
+/**
+ * @public
+ */
+export const isSwaggerVersionElement = (element: unknown): element is SwaggerVersionElement =>
+  element instanceof SwaggerVersionElement;
+
+/**
+ * @public
+ */
+export const isInfoElement = (element: unknown): element is InfoElement =>
+  element instanceof InfoElement;
+
+/**
+ * @public
+ */
+export const isLicenseElement = (element: unknown): element is LicenseElement =>
+  element instanceof LicenseElement;
+
+/**
+ * @public
+ */
+export const isContactElement = (element: unknown): element is ContactElement =>
+  element instanceof ContactElement;
+
+/**
+ * @public
+ */
+export const isPathsElement = (element: unknown): element is PathsElement =>
+  element instanceof PathsElement;
+
+/**
+ * @public
+ */
+export const isPathItemElement = (element: unknown): element is PathItemElement =>
+  element instanceof PathItemElement;
+
+/**
+ * @public
+ */
+export const isOperationElement = (element: unknown): element is OperationElement =>
+  element instanceof OperationElement;
+
+/**
+ * @public
+ */
+export const isExternalDocumentationElement = (
+  element: unknown,
+): element is ExternalDocumentationElement => element instanceof ExternalDocumentationElement;
+
+/**
+ * @public
+ */
+export const isParameterElement = (element: unknown): element is ParameterElement =>
+  element instanceof ParameterElement;
+
+/**
+ * @public
+ */
+export const isItemsElement = (element: unknown): element is ItemsElement =>
+  element instanceof ItemsElement;
+
+/**
+ * @public
+ */
+export const isResponsesElement = (element: unknown): element is ResponsesElement =>
+  element instanceof ResponsesElement;
+
+/**
+ * @public
+ */
+export const isResponseElement = (element: unknown): element is ResponseElement =>
+  element instanceof ResponseElement;
+
+/**
+ * @public
+ */
+export const isHeadersElement = (element: unknown): element is HeadersElement =>
+  element instanceof HeadersElement;
+
+/**
+ * @public
+ */
+export const isExampleElement = (element: unknown): element is ExampleElement =>
+  element instanceof ExampleElement;
+
+/**
+ * @public
+ */
+export const isHeaderElement = (element: unknown): element is HeaderElement =>
+  element instanceof HeaderElement;
+
+/**
+ * @public
+ */
+export const isTagElement = (element: unknown): element is TagElement =>
+  element instanceof TagElement;
+
+/**
+ * @public
+ */
+export const isReferenceElement = (element: unknown): element is ReferenceElement =>
+  element instanceof ReferenceElement;
+
+/**
+ * @public
+ */
+export const isSchemaElement = (element: unknown): element is SchemaElement =>
+  element instanceof SchemaElement;
+
+/**
+ * @public
+ */
+export const isXmlElement = (element: unknown): element is XmlElement =>
+  element instanceof XmlElement;
+
+/**
+ * @public
+ */
+export const isResponsesDefinitionsElement = (
+  element: unknown,
+): element is ResponsesDefinitionsElement => element instanceof ResponsesDefinitionsElement;
+
+/**
+ * @public
+ */
+export const isSecurityDefinitionsElement = (
+  element: unknown,
+): element is SecurityDefinitionsElement => element instanceof SecurityDefinitionsElement;
+
+/**
+ * @public
+ */
+export const isDefinitionsElement = (element: unknown): element is DefinitionsElement =>
+  element instanceof DefinitionsElement;
+
+/**
+ * @public
+ */
+export const isParametersDefinitionsElement = (
+  element: unknown,
+): element is ParametersDefinitionsElement => element instanceof ParametersDefinitionsElement;
+
+/**
+ * @public
+ */
+export const isSecuritySchemeElement = (element: unknown): element is SecuritySchemeElement =>
+  element instanceof SecuritySchemeElement;
+
+/**
+ * @public
+ */
+export const isScopesElement = (element: unknown): element is ScopesElement =>
+  element instanceof ScopesElement;
+
+/**
+ * @public
+ */
+export const isSecurityRequirementElement = (
+  element: unknown,
+): element is SecurityRequirementElement => element instanceof SecurityRequirementElement;

package/src/refractor/index.cjs

@@ -0,0 +1,316 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.refractXml = exports.refractTag = exports.refractSwagger = exports.refractSecurityScheme = exports.refractSecurityRequirement = exports.refractSecurityDefinitions = exports.refractScopes = exports.refractSchema = exports.refractResponsesDefinitions = exports.refractResponses = exports.refractResponse = exports.refractReference = exports.refractPaths = exports.refractPathItem = exports.refractParametersDefinitions = exports.refractParameter = exports.refractOperation = exports.refractLicense = exports.refractItems = exports.refractInfo = exports.refractHeaders = exports.refractHeader = exports.refractExternalDocumentation = exports.refractExample = exports.refractDefinitions = exports.refractContact = exports.default = void 0;
+var _apidomCore = require("@speclynx/apidom-core");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+var _apidomTraverse = require("@speclynx/apidom-traverse");
+var _ramda = require("ramda");
+var _specification = _interopRequireDefault(require("./specification.cjs"));
+var _toolbox = _interopRequireDefault(require("./toolbox.cjs"));
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+const refract = (value, {
+  element = 'swagger',
+  plugins = [],
+  specificationObj = _specification.default,
+  consume = false
+} = {}) => {
+  const genericElement = (0, _apidomDatamodel.refract)(value);
+  const resolvedSpec = (0, _apidomCore.resolveSpecification)(specificationObj);
+  const elementMap = resolvedSpec.elementMap;
+  const specPath = elementMap[element];
+  if (!specPath) {
+    throw new Error(`Unknown element type: "${element}"`);
+  }
+
+  /**
+   * This is where generic ApiDOM becomes semantic (namespace applied).
+   * We don't allow consumers to hook into this translation.
+   * Though we allow consumers to define their own plugins on already transformed ApiDOM.
+   */
+  const RootVisitorClass = (0, _ramda.path)(specPath, resolvedSpec);
+  const rootVisitor = new RootVisitorClass({
+    specObj: resolvedSpec,
+    consume
+  });
+  (0, _apidomTraverse.traverse)(genericElement, rootVisitor);
+
+  /**
+   * Running plugins visitors means extra single traversal === performance hit.
+   */
+  return (0, _apidomCore.dispatchRefractorPlugins)(rootVisitor.element, plugins, {
+    toolboxCreator: _toolbox.default
+  });
+};
+
+/**
+ * Refracts a value into a SwaggerElement.
+ * @public
+ */
+const refractSwagger = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'swagger'
+});
+
+/**
+ * Refracts a value into an InfoElement.
+ * @public
+ */
+exports.refractSwagger = refractSwagger;
+const refractInfo = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'info'
+});
+
+/**
+ * Refracts a value into a ContactElement.
+ * @public
+ */
+exports.refractInfo = refractInfo;
+const refractContact = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'contact'
+});
+
+/**
+ * Refracts a value into a LicenseElement.
+ * @public
+ */
+exports.refractContact = refractContact;
+const refractLicense = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'license'
+});
+
+/**
+ * Refracts a value into a PathsElement.
+ * @public
+ */
+exports.refractLicense = refractLicense;
+const refractPaths = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'paths'
+});
+
+/**
+ * Refracts a value into a PathItemElement.
+ * @public
+ */
+exports.refractPaths = refractPaths;
+const refractPathItem = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'pathItem'
+});
+
+/**
+ * Refracts a value into an OperationElement.
+ * @public
+ */
+exports.refractPathItem = refractPathItem;
+const refractOperation = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'operation'
+});
+
+/**
+ * Refracts a value into an ExternalDocumentationElement.
+ * @public
+ */
+exports.refractOperation = refractOperation;
+const refractExternalDocumentation = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'externalDocumentation'
+});
+
+/**
+ * Refracts a value into a ParameterElement.
+ * @public
+ */
+exports.refractExternalDocumentation = refractExternalDocumentation;
+const refractParameter = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'parameter'
+});
+
+/**
+ * Refracts a value into an ItemsElement.
+ * @public
+ */
+exports.refractParameter = refractParameter;
+const refractItems = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'items'
+});
+
+/**
+ * Refracts a value into a ResponsesElement.
+ * @public
+ */
+exports.refractItems = refractItems;
+const refractResponses = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'responses'
+});
+
+/**
+ * Refracts a value into a ResponseElement.
+ * @public
+ */
+exports.refractResponses = refractResponses;
+const refractResponse = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'response'
+});
+
+/**
+ * Refracts a value into a HeadersElement.
+ * @public
+ */
+exports.refractResponse = refractResponse;
+const refractHeaders = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'headers'
+});
+
+/**
+ * Refracts a value into an ExampleElement.
+ * @public
+ */
+exports.refractHeaders = refractHeaders;
+const refractExample = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'example'
+});
+
+/**
+ * Refracts a value into a HeaderElement.
+ * @public
+ */
+exports.refractExample = refractExample;
+const refractHeader = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'header'
+});
+
+/**
+ * Refracts a value into a TagElement.
+ * @public
+ */
+exports.refractHeader = refractHeader;
+const refractTag = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'tag'
+});
+
+/**
+ * Refracts a value into a ReferenceElement.
+ * @public
+ */
+exports.refractTag = refractTag;
+const refractReference = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'reference'
+});
+
+/**
+ * Refracts a value into a SchemaElement.
+ * @public
+ */
+exports.refractReference = refractReference;
+const refractSchema = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'schema'
+});
+
+/**
+ * Refracts a value into an XmlElement.
+ * @public
+ */
+exports.refractSchema = refractSchema;
+const refractXml = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'xml'
+});
+
+/**
+ * Refracts a value into a DefinitionsElement.
+ * @public
+ */
+exports.refractXml = refractXml;
+const refractDefinitions = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'definitions'
+});
+
+/**
+ * Refracts a value into a ParametersDefinitionsElement.
+ * @public
+ */
+exports.refractDefinitions = refractDefinitions;
+const refractParametersDefinitions = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'parametersDefinitions'
+});
+
+/**
+ * Refracts a value into a ResponsesDefinitionsElement.
+ * @public
+ */
+exports.refractParametersDefinitions = refractParametersDefinitions;
+const refractResponsesDefinitions = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'responsesDefinitions'
+});
+
+/**
+ * Refracts a value into a SecurityDefinitionsElement.
+ * @public
+ */
+exports.refractResponsesDefinitions = refractResponsesDefinitions;
+const refractSecurityDefinitions = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'securityDefinitions'
+});
+
+/**
+ * Refracts a value into a SecuritySchemeElement.
+ * @public
+ */
+exports.refractSecurityDefinitions = refractSecurityDefinitions;
+const refractSecurityScheme = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'securityScheme'
+});
+
+/**
+ * Refracts a value into a ScopesElement.
+ * @public
+ */
+exports.refractSecurityScheme = refractSecurityScheme;
+const refractScopes = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'scopes'
+});
+
+/**
+ * Refracts a value into a SecurityRequirementElement.
+ * @public
+ */
+exports.refractScopes = refractScopes;
+const refractSecurityRequirement = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'securityRequirement'
+});
+exports.refractSecurityRequirement = refractSecurityRequirement;
+var _default = exports.default = refract;