@swagger-api/apidom-ns-openapi-3-1 1.0.0-alpha.0 → 1.0.0-alpha.10

package/CHANGELOG.md

@@ -3,6 +3,57 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.0.0-alpha.10](https://github.com/swagger-api/apidom/compare/v1.0.0-alpha.9...v1.0.0-alpha.10) (2024-10-21)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-alpha.9](https://github.com/swagger-api/apidom/compare/v1.0.0-alpha.8...v1.0.0-alpha.9) (2024-08-14)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-alpha.8](https://github.com/swagger-api/apidom/compare/v1.0.0-alpha.7...v1.0.0-alpha.8) (2024-08-08)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-alpha.7](https://github.com/swagger-api/apidom/compare/v1.0.0-alpha.6...v1.0.0-alpha.7) (2024-08-05)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-alpha.6](https://github.com/swagger-api/apidom/compare/v1.0.0-alpha.5...v1.0.0-alpha.6) (2024-07-09)
+
+### Bug Fixes
+
+- **ns-openapi-3-1:** set example to first element of examples in parameter examples refractor plugin ([#4230](https://github.com/swagger-api/apidom/issues/4230)) ([d85f72a](https://github.com/swagger-api/apidom/commit/d85f72ae327d521ae63e6096824ae994b9e486ca)), closes [#4229](https://github.com/swagger-api/apidom/issues/4229)
+
+# [1.0.0-alpha.5](https://github.com/swagger-api/apidom/compare/v1.0.0-alpha.4...v1.0.0-alpha.5) (2024-05-29)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-alpha.4](https://github.com/swagger-api/apidom/compare/v1.0.0-alpha.3...v1.0.0-alpha.4) (2024-05-29)
+
+### Features
+
+- **ns-openapi-3-1:** add idempotence to parameter examples refractor plugin ([#4142](https://github.com/swagger-api/apidom/issues/4142)) ([7cee6e9](https://github.com/swagger-api/apidom/commit/7cee6e9a74746338e60480a764485c7ec31a206f)), closes [#4134](https://github.com/swagger-api/apidom/issues/4134)
+- **ns-openapi-3-1:** make header example refractor plugin idempotent ([#4135](https://github.com/swagger-api/apidom/issues/4135)) ([524cce2](https://github.com/swagger-api/apidom/commit/524cce246b3919bed92aa197ce189dfc2792fb26)), closes [#4134](https://github.com/swagger-api/apidom/issues/4134)
+- **ns-openapi-3-1:** make operation ids refractor plugin idempotent ([#4151](https://github.com/swagger-api/apidom/issues/4151)) ([858cec6](https://github.com/swagger-api/apidom/commit/858cec60259ca74f00f90456dcdcebcdefbef288)), closes [#4134](https://github.com/swagger-api/apidom/issues/4134)
+- **ns-openapi-3-1:** make parameters plugin idempotent ([#4150](https://github.com/swagger-api/apidom/issues/4150)) ([7fdf6b5](https://github.com/swagger-api/apidom/commit/7fdf6b50263fb658e6fe62c54d91de746e73dc4e)), closes [#4134](https://github.com/swagger-api/apidom/issues/4134)
+- **ns-openapi-3-1:** make security requirements refractor plugin idempotent ([#4149](https://github.com/swagger-api/apidom/issues/4149)) ([e28f053](https://github.com/swagger-api/apidom/commit/e28f0533e32760f4a4ea5bf92351066327bff4dc)), closes [#4134](https://github.com/swagger-api/apidom/issues/4134)
+- **ns-openapi-3-1:** make servers refractor plugin idempotent ([#4152](https://github.com/swagger-api/apidom/issues/4152)) ([93e2d0f](https://github.com/swagger-api/apidom/commit/93e2d0f7f08add82309843abe991a3013440e5e2)), closes [#4134](https://github.com/swagger-api/apidom/issues/4134)
+
+# [1.0.0-alpha.3](https://github.com/swagger-api/apidom/compare/v1.0.0-alpha.2...v1.0.0-alpha.3) (2024-05-21)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-alpha.2](https://github.com/swagger-api/apidom/compare/v1.0.0-alpha.1...v1.0.0-alpha.2) (2024-05-20)
+
+### Features
+
+- **ast:** add support for mutable node replacements ([#4121](https://github.com/swagger-api/apidom/issues/4121)) ([b37ecd2](https://github.com/swagger-api/apidom/commit/b37ecd2dba83aaa3813bb539ae64e98b290f0292)), closes [#4120](https://github.com/swagger-api/apidom/issues/4120)
+
+# [1.0.0-alpha.1](https://github.com/swagger-api/apidom/compare/v1.0.0-alpha.0...v1.0.0-alpha.1) (2024-05-15)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
 # [1.0.0-alpha.0](https://github.com/swagger-api/apidom/compare/v0.99.2...v1.0.0-alpha.0) (2024-05-14)
 
 **Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1

package/cjs/index.cjs

@@ -33,8 +33,8 @@ var _normalizeOperationIds = _interopRequireDefault(require("./refractor/plugins
 exports.refractorPluginNormalizeOperationIds = _normalizeOperationIds.default;
 var _normalizeParameterExamples = _interopRequireDefault(require("./refractor/plugins/normalize-parameter-examples.cjs"));
 exports.refractorPluginNormalizeParameterExamples = _normalizeParameterExamples.default;
-var _normalizeHeaderExamples = _interopRequireDefault(require("./refractor/plugins/normalize-header-examples.cjs"));
-exports.refractorPluginNormalizeHeaderExamples = _normalizeHeaderExamples.default;
+var _index = _interopRequireDefault(require("./refractor/plugins/normalize-header-examples/index.cjs"));
+exports.refractorPluginNormalizeHeaderExamples = _index.default;
 var _toolbox = _interopRequireDefault(require("./refractor/toolbox.cjs"));
 exports.createToolbox = _toolbox.default;
 var _specification = _interopRequireDefault(require("./refractor/specification.cjs"));

package/cjs/refractor/plugins/normalize-header-examples/NormalizeStorage.cjs

@@ -0,0 +1,38 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = void 0;
+var _apidomCore = require("@swagger-api/apidom-core");
+class NormalizeStorage {
+  internalStore;
+  constructor(storageElement, storageField, storageSubField) {
+    this.storageElement = storageElement;
+    this.storageField = storageField;
+    this.storageSubField = storageSubField;
+  }
+  get store() {
+    if (!this.internalStore) {
+      let rootStore = this.storageElement.get(this.storageField);
+      if (!(0, _apidomCore.isObjectElement)(rootStore)) {
+        rootStore = new _apidomCore.ObjectElement();
+        this.storageElement.set(this.storageField, rootStore);
+      }
+      let store = rootStore.get(this.storageSubField);
+      if (!(0, _apidomCore.isArrayElement)(store)) {
+        store = new _apidomCore.ArrayElement();
+        rootStore.set(this.storageSubField, store);
+      }
+      this.internalStore = store;
+    }
+    return this.internalStore;
+  }
+  append(pointer) {
+    if (!this.includes(pointer)) {
+      this.store.push(pointer);
+    }
+  }
+  includes(pointer) {
+    return this.store.includes(pointer);
+  }
+}
+var _default = exports.default = NormalizeStorage;

package/cjs/refractor/plugins/{normalize-header-examples.cjs → normalize-header-examples/index.cjs}

@@ -1,8 +1,10 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
 exports.__esModule = true;
 exports.default = void 0;
 var _apidomCore = require("@swagger-api/apidom-core");
+var _NormalizeStorage = _interopRequireDefault(require("./NormalizeStorage.cjs"));
 /**
  * Override of Schema.example and Schema.examples field inside the Header Objects.
  *
@@ -14,13 +16,28 @@ var _apidomCore = require("@swagger-api/apidom-core");
  *
  * The example value SHALL override the example provided by the schema.
  * Furthermore, if referencing a schema that contains an example, the examples value SHALL override the example provided by the schema.
+ *
+ * NOTE: this plugin is idempotent
  */
-/* eslint-disable no-param-reassign */
-const plugin = () => ({
-  predicates
-}) => {
+
+const plugin = ({
+  storageField = 'x-normalized'
+} = {}) => toolbox => {
+  const {
+    predicates,
+    ancestorLineageToJSONPointer
+  } = toolbox;
+  let storage;
   return {
     visitor: {
+      OpenApi3_1Element: {
+        enter(element) {
+          storage = new _NormalizeStorage.default(element, storageField, 'header-examples');
+        },
+        leave() {
+          storage = undefined;
+        }
+      },
       HeaderElement: {
         leave(headerElement, key, parent, path, ancestors) {
           var _headerElement$schema, _headerElement$schema2;
@@ -37,6 +54,12 @@ const plugin = () => ({
           if (typeof ((_headerElement$schema = headerElement.schema) == null ? void 0 : _headerElement$schema.example) === 'undefined' && typeof ((_headerElement$schema2 = headerElement.schema) == null ? void 0 : _headerElement$schema2.examples) === 'undefined') {
             return;
           }
+          const headerJSONPointer = ancestorLineageToJSONPointer([...ancestors, parent, headerElement]);
+
+          // skip visiting this Header Object if it's already normalized
+          if (storage.includes(headerJSONPointer)) {
+            return;
+          }
 
           /**
            * Header.examples and Schema.examples have preferences over the older
@@ -49,9 +72,11 @@ const plugin = () => ({
             });
             if (typeof headerElement.schema.examples !== 'undefined') {
               headerElement.schema.set('examples', examples);
+              storage.append(headerJSONPointer);
             }
             if (typeof headerElement.schema.example !== 'undefined') {
-              headerElement.schema.set('example', examples);
+              headerElement.schema.set('example', examples[0]);
+              storage.append(headerJSONPointer);
             }
             return;
           }
@@ -62,9 +87,11 @@ const plugin = () => ({
           if (typeof headerElement.example !== 'undefined') {
             if (typeof headerElement.schema.examples !== 'undefined') {
               headerElement.schema.set('examples', [(0, _apidomCore.cloneDeep)(headerElement.example)]);
+              storage.append(headerJSONPointer);
             }
             if (typeof headerElement.schema.example !== 'undefined') {
               headerElement.schema.set('example', (0, _apidomCore.cloneDeep)(headerElement.example));
+              storage.append(headerJSONPointer);
             }
           }
         }
@@ -72,5 +99,4 @@ const plugin = () => ({
     }
   };
 };
-/* eslint-enable */
 var _default = exports.default = plugin;

package/cjs/refractor/plugins/normalize-operation-ids.cjs

@@ -1,9 +1,11 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
 exports.__esModule = true;
 exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomCore = require("@swagger-api/apidom-core");
+var _NormalizeStorage = _interopRequireDefault(require("./normalize-header-examples/NormalizeStorage.cjs"));
 const removeSpaces = operationId => {
   return operationId.replace(/\s/g, '');
 };
@@ -37,21 +39,29 @@ const normalizeOperationId = (operationId, path, method) => {
  * This plugin also guarantees the uniqueness of all defined Operation.operationId fields,
  * and make sure Link.operationId fields are pointing to correct and normalized Operation.operationId fields.
  *
+ * NOTE: this plugin is idempotent
  */
-/* eslint-disable no-param-reassign */
 
+/* eslint-disable no-param-reassign */
 const plugin = ({
+  storageField = 'x-normalized',
   operationIdNormalizer = normalizeOperationId
-} = {}) => ({
-  predicates,
-  namespace
-}) => {
-  const paths = [];
+} = {}) => toolbox => {
+  const {
+    predicates,
+    ancestorLineageToJSONPointer,
+    namespace
+  } = toolbox;
+  const pathTemplates = [];
   const normalizedOperations = [];
   const links = [];
+  let storage;
   return {
     visitor: {
       OpenApi3_1Element: {
+        enter(element) {
+          storage = new _NormalizeStorage.default(element, storageField, 'operation-ids');
+        },
         leave() {
           // group normalized operations by normalized operationId
           const normalizedOperationGroups = (0, _ramda.groupBy)(operationElement => {
@@ -88,30 +98,37 @@ const plugin = ({
           // cleanup the references
           normalizedOperations.length = 0;
           links.length = 0;
+          storage = undefined;
         }
       },
       PathItemElement: {
         enter(pathItemElement) {
           // `path` meta may not be always available, e.g. in Callback Object or Components Object
-          const path = (0, _ramda.defaultTo)('path', (0, _apidomCore.toValue)(pathItemElement.meta.get('path')));
-          paths.push(path);
+          const pathTemplate = (0, _ramda.defaultTo)('path', (0, _apidomCore.toValue)(pathItemElement.meta.get('path')));
+          pathTemplates.push(pathTemplate);
         },
         leave() {
-          paths.pop();
+          pathTemplates.pop();
         }
       },
       OperationElement: {
-        enter(operationElement) {
+        enter(operationElement, key, parent, path, ancestors) {
           // operationId field is undefined, needs no normalization
           if (typeof operationElement.operationId === 'undefined') return;
+          const operationJSONPointer = ancestorLineageToJSONPointer([...ancestors, parent, operationElement]);
+
+          // skip visiting this Operation Object if it's already normalized
+          if (storage.includes(operationJSONPointer)) {
+            return;
+          }
 
           // cast operationId to string type
           const originalOperationId = String((0, _apidomCore.toValue)(operationElement.operationId));
           // perform operationId normalization
-          const path = (0, _ramda.last)(paths);
+          const pathTemplate = (0, _ramda.last)(pathTemplates);
           // `http-method` meta may not be always available, e.g. in Callback Object or Components Object
           const method = (0, _ramda.defaultTo)('method', (0, _apidomCore.toValue)(operationElement.meta.get('http-method')));
-          const normalizedOperationId = operationIdNormalizer(originalOperationId, path, method);
+          const normalizedOperationId = operationIdNormalizer(originalOperationId, pathTemplate, method);
 
           // normalization is not necessary
           if (originalOperationId === normalizedOperationId) return;
@@ -121,6 +138,7 @@ const plugin = ({
           operationElement.set('__originalOperationId', originalOperationId);
           operationElement.meta.set('originalOperationId', originalOperationId);
           normalizedOperations.push(operationElement);
+          storage.append(operationJSONPointer);
         }
       },
       LinkElement: {

package/cjs/refractor/plugins/normalize-parameter-examples.cjs

@@ -1,8 +1,10 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
 exports.__esModule = true;
 exports.default = void 0;
 var _apidomCore = require("@swagger-api/apidom-core");
+var _NormalizeStorage = _interopRequireDefault(require("./normalize-header-examples/NormalizeStorage.cjs"));
 /**
  * Override of Schema.example and Schema.examples field inside the Parameter Objects.
  *
@@ -14,13 +16,28 @@ var _apidomCore = require("@swagger-api/apidom-core");
  *
  * The example value SHALL override the example provided by the schema.
  * Furthermore, if referencing a schema that contains an example, the examples value SHALL override the example provided by the schema.
+ *
+ * NOTE: this plugin is idempotent
  */
-/* eslint-disable no-param-reassign */
-const plugin = () => ({
-  predicates
-}) => {
+
+const plugin = ({
+  storageField = 'x-normalized'
+} = {}) => toolbox => {
+  const {
+    predicates,
+    ancestorLineageToJSONPointer
+  } = toolbox;
+  let storage;
   return {
     visitor: {
+      OpenApi3_1Element: {
+        enter(element) {
+          storage = new _NormalizeStorage.default(element, storageField, 'parameter-examples');
+        },
+        leave() {
+          storage = undefined;
+        }
+      },
       ParameterElement: {
         leave(parameterElement, key, parent, path, ancestors) {
           var _parameterElement$sch, _parameterElement$sch2;
@@ -37,6 +54,12 @@ const plugin = () => ({
           if (typeof ((_parameterElement$sch = parameterElement.schema) == null ? void 0 : _parameterElement$sch.example) === 'undefined' && typeof ((_parameterElement$sch2 = parameterElement.schema) == null ? void 0 : _parameterElement$sch2.examples) === 'undefined') {
             return;
           }
+          const parameterJSONPointer = ancestorLineageToJSONPointer([...ancestors, parent, parameterElement]);
+
+          // skip visiting this Parameter Object if it's already normalized
+          if (storage.includes(parameterJSONPointer)) {
+            return;
+          }
 
           /**
            * Parameter.examples and Schema.examples have preferences over the older
@@ -49,9 +72,11 @@ const plugin = () => ({
             });
             if (typeof parameterElement.schema.examples !== 'undefined') {
               parameterElement.schema.set('examples', examples);
+              storage.append(parameterJSONPointer);
             }
             if (typeof parameterElement.schema.example !== 'undefined') {
-              parameterElement.schema.set('example', examples);
+              parameterElement.schema.set('example', examples[0]);
+              storage.append(parameterJSONPointer);
             }
             return;
           }
@@ -62,9 +87,11 @@ const plugin = () => ({
           if (typeof parameterElement.example !== 'undefined') {
             if (typeof parameterElement.schema.examples !== 'undefined') {
               parameterElement.schema.set('examples', [(0, _apidomCore.cloneDeep)(parameterElement.example)]);
+              storage.append(parameterJSONPointer);
             }
             if (typeof parameterElement.schema.example !== 'undefined') {
               parameterElement.schema.set('example', (0, _apidomCore.cloneDeep)(parameterElement.example));
+              storage.append(parameterJSONPointer);
             }
           }
         }
@@ -72,5 +99,4 @@ const plugin = () => ({
     }
   };
 };
-/* eslint-enable */
 var _default = exports.default = plugin;

package/cjs/refractor/plugins/normalize-parameters.cjs

@@ -1,10 +1,12 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
 exports.__esModule = true;
 exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomCore = require("@swagger-api/apidom-core");
 var _apidomNsOpenapi = require("@swagger-api/apidom-ns-openapi-3-0");
+var _NormalizeStorage = _interopRequireDefault(require("./normalize-header-examples/NormalizeStorage.cjs"));
 /**
  * Inheritance of Parameter Objects.
  *
@@ -13,11 +15,18 @@ var _apidomNsOpenapi = require("@swagger-api/apidom-ns-openapi-3-0");
  * A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item,
  * the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters.
  * A unique parameter is defined by a combination of a name and location.
+ *
+ * NOTE: this plugin is idempotent
  */
+
 /* eslint-disable no-param-reassign */
-const plugin = () => ({
-  predicates
-}) => {
+const plugin = ({
+  storageField = 'x-normalized'
+} = {}) => toolbox => {
+  const {
+    predicates,
+    ancestorLineageToJSONPointer
+  } = toolbox;
   /**
    * Establishes identity between two Parameter Objects.
    *
@@ -33,8 +42,17 @@ const plugin = () => ({
     return (0, _apidomCore.toValue)(parameter1.name) === (0, _apidomCore.toValue)(parameter2.name) && (0, _apidomCore.toValue)(parameter1.in) === (0, _apidomCore.toValue)(parameter2.in);
   };
   const pathItemParameters = [];
+  let storage;
   return {
     visitor: {
+      OpenApi3_1Element: {
+        enter(element) {
+          storage = new _NormalizeStorage.default(element, storageField, 'parameters');
+        },
+        leave() {
+          storage = undefined;
+        }
+      },
       PathItemElement: {
         enter(pathItemElement, key, parent, path, ancestors) {
           // skip visiting this Path Item
@@ -55,18 +73,25 @@ const plugin = () => ({
         }
       },
       OperationElement: {
-        leave(operationElement) {
+        leave(operationElement, key, parent, path, ancestors) {
           const parentPathItemParameters = (0, _ramda.last)(pathItemParameters);
 
           // no Path Item Object parameters to inherit from
           if (!Array.isArray(parentPathItemParameters) || parentPathItemParameters.length === 0) {
             return;
           }
+          const operationJSONPointer = ancestorLineageToJSONPointer([...ancestors, parent, operationElement]);
+
+          // skip visiting this Operation Object if it's already normalized
+          if (storage.includes(operationJSONPointer)) {
+            return;
+          }
           const operationParameters = (0, _ramda.pathOr)([], ['parameters', 'content'], operationElement);
 
           // prefers the first item if two items compare equal based on the predicate
           const mergedParameters = (0, _ramda.uniqWith)(parameterEquals, [...operationParameters, ...parentPathItemParameters]);
           operationElement.parameters = new _apidomNsOpenapi.OperationParametersElement(mergedParameters);
+          storage.append(operationJSONPointer);
         }
       }
     }

package/cjs/refractor/plugins/normalize-security-requirements.cjs

@@ -1,8 +1,10 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
 exports.__esModule = true;
 exports.default = void 0;
 var _apidomNsOpenapi = require("@swagger-api/apidom-ns-openapi-3-0");
+var _NormalizeStorage = _interopRequireDefault(require("./normalize-header-examples/NormalizeStorage.cjs"));
 /**
  * Override of Security Requirement Objects.
  *
@@ -12,22 +14,31 @@ var _apidomNsOpenapi = require("@swagger-api/apidom-ns-openapi-3-0");
  * To remove a top-level security declaration, an empty array can be used.
  * When a list of Security Requirement Objects is defined on the OpenAPI Object or Operation Object,
  * only one of the Security Requirement Objects in the list needs to be satisfied to authorize the request.
+ *
+ * NOTE: this plugin is idempotent
  */
 
 /* eslint-disable no-param-reassign */
-const plugin = () => ({
-  predicates
-}) => {
+const plugin = ({
+  storageField = 'x-normalized'
+} = {}) => toolbox => {
+  const {
+    predicates,
+    ancestorLineageToJSONPointer
+  } = toolbox;
   let topLevelSecurity;
+  let storage;
   return {
     visitor: {
       OpenApi3_1Element: {
         enter(openapiElement) {
+          storage = new _NormalizeStorage.default(openapiElement, storageField, 'security-requirements');
           if (predicates.isArrayElement(openapiElement.security)) {
             topLevelSecurity = openapiElement.security;
           }
         },
         leave() {
+          storage = undefined;
           topLevelSecurity = undefined;
         }
       },
@@ -37,11 +48,18 @@ const plugin = () => ({
           if (ancestors.some(predicates.isComponentsElement)) {
             return;
           }
+          const operationJSONPointer = ancestorLineageToJSONPointer([...ancestors, parent, operationElement]);
+
+          // skip visiting this Operation Object if it's already normalized
+          if (storage.includes(operationJSONPointer)) {
+            return;
+          }
           const missingOperationLevelSecurity = typeof operationElement.security === 'undefined';
           const hasTopLevelSecurity = typeof topLevelSecurity !== 'undefined';
           if (missingOperationLevelSecurity && hasTopLevelSecurity) {
             var _topLevelSecurity;
             operationElement.security = new _apidomNsOpenapi.OperationSecurityElement((_topLevelSecurity = topLevelSecurity) == null ? void 0 : _topLevelSecurity.content);
+            storage.append(operationJSONPointer);
           }
         }
       }

package/cjs/refractor/plugins/normalize-servers.cjs

@@ -1,8 +1,10 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
 exports.__esModule = true;
 exports.default = void 0;
 var _apidomNsOpenapi = require("@swagger-api/apidom-ns-openapi-3-0");
+var _NormalizeStorage = _interopRequireDefault(require("./normalize-header-examples/NormalizeStorage.cjs"));
 /**
  * Override of Server Objects.
  *
@@ -17,30 +19,47 @@ var _apidomNsOpenapi = require("@swagger-api/apidom-ns-openapi-3-0");
  */
 
 /* eslint-disable no-param-reassign */
-const plugin = () => ({
-  predicates,
-  namespace
-}) => {
+const plugin = ({
+  storageField = 'x-normalized'
+} = {}) => toolbox => {
+  const {
+    namespace,
+    ancestorLineageToJSONPointer,
+    predicates
+  } = toolbox;
+  let storage;
   return {
     visitor: {
-      OpenApi3_1Element(openapiElement) {
-        const isServersUndefined = typeof openapiElement.servers === 'undefined';
-        const isServersArrayElement = predicates.isArrayElement(openapiElement.servers);
-        const isServersEmpty = isServersArrayElement && openapiElement.servers.length === 0;
-        // @ts-ignore
-        const defaultServer = namespace.elements.Server.refract({
-          url: '/'
-        });
-        if (isServersUndefined || !isServersArrayElement) {
-          openapiElement.servers = new _apidomNsOpenapi.ServersElement([defaultServer]);
-        } else if (isServersArrayElement && isServersEmpty) {
-          openapiElement.servers.push(defaultServer);
+      OpenApi3_1Element: {
+        enter(openapiElement) {
+          const isServersUndefined = typeof openapiElement.servers === 'undefined';
+          const isServersArrayElement = predicates.isArrayElement(openapiElement.servers);
+          const isServersEmpty = isServersArrayElement && openapiElement.servers.length === 0;
+          // @ts-ignore
+          const defaultServer = namespace.elements.Server.refract({
+            url: '/'
+          });
+          if (isServersUndefined || !isServersArrayElement) {
+            openapiElement.servers = new _apidomNsOpenapi.ServersElement([defaultServer]);
+          } else if (isServersArrayElement && isServersEmpty) {
+            openapiElement.servers.push(defaultServer);
+          }
+          storage = new _NormalizeStorage.default(openapiElement, storageField, 'servers');
+        },
+        leave() {
+          storage = undefined;
         }
       },
       PathItemElement(pathItemElement, key, parent, path, ancestors) {
         // skip visiting this Path Item
         if (ancestors.some(predicates.isComponentsElement)) return;
         if (!ancestors.some(predicates.isOpenApi3_1Element)) return;
+        const pathItemJSONPointer = ancestorLineageToJSONPointer([...ancestors, parent, pathItemElement]);
+
+        // skip visiting this Path Item Object if it's already normalized
+        if (storage.includes(pathItemJSONPointer)) {
+          return;
+        }
         const parentOpenapiElement = ancestors.find(predicates.isOpenApi3_1Element);
         const isServersUndefined = typeof pathItemElement.servers === 'undefined';
         const isServersArrayElement = predicates.isArrayElement(pathItemElement.servers);
@@ -58,12 +77,19 @@ const plugin = () => ({
               pathItemElement.servers.push(server);
             });
           }
+          storage.append(pathItemJSONPointer);
         }
       },
       OperationElement(operationElement, key, parent, path, ancestors) {
         // skip visiting this Operation
         if (ancestors.some(predicates.isComponentsElement)) return;
         if (!ancestors.some(predicates.isOpenApi3_1Element)) return;
+        const operationJSONPointer = ancestorLineageToJSONPointer([...ancestors, parent, operationElement]);
+
+        // skip visiting this Operation Object if it's already normalized
+        if (storage.includes(operationJSONPointer)) {
+          return;
+        }
 
         // @TODO(vladimir.gorej@gmail.com): can be replaced by Array.prototype.findLast in future
         const parentPathItemElement = [...ancestors].reverse().find(predicates.isPathItemElement);
@@ -82,6 +108,7 @@ const plugin = () => ({
               operationElement.servers.push(server);
             });
           }
+          storage.append(operationJSONPointer);
         }
       }
     }

package/cjs/refractor/toolbox.cjs

@@ -5,9 +5,31 @@ var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopReq
 exports.__esModule = true;
 exports.default = void 0;
 var _apidomCore = require("@swagger-api/apidom-core");
+var _apidomJsonPointer = require("@swagger-api/apidom-json-pointer");
 var _apidomNsOpenapi = require("@swagger-api/apidom-ns-openapi-3-0");
 var openApi3_1Predicates = _interopRequireWildcard(require("../predicates.cjs"));
 var _namespace = _interopRequireDefault(require("../namespace.cjs"));
+/**
+ * Translates visitor ancestor lineage to a JSON Pointer tokens.
+ * Ancestor lineage is constructed of following visitor method arguments:
+ *
+ *  - ancestors
+ *  - parent
+ *  - element
+ */
+const ancestorLineageToJSONPointer = elementPath => {
+  const jsonPointerTokens = elementPath.reduce((path, element, index) => {
+    if ((0, _apidomCore.isMemberElement)(element)) {
+      const token = String((0, _apidomCore.toValue)(element.key));
+      path.push(token);
+    } else if ((0, _apidomCore.isArrayElement)(elementPath[index - 2])) {
+      const token = String(elementPath[index - 2].content.indexOf(element));
+      path.push(token);
+    }
+    return path;
+  }, []);
+  return (0, _apidomJsonPointer.compile)(jsonPointerTokens);
+};
 const createToolbox = () => {
   const namespace = (0, _apidomCore.createNamespace)(_namespace.default);
   const predicates = {
@@ -23,6 +45,7 @@ const createToolbox = () => {
   };
   return {
     predicates,
+    ancestorLineageToJSONPointer,
     namespace
   };
 };