feat(ns-asyncapi-2-0): add full support for Operation Object

Refs #387

Author: char0n

apidom/packages/apidom-ns-asyncapi-2-0/README.md

@@ -150,7 +150,7 @@ Only fully implemented specification objects should be checked here.
 - [x] [Default Content Type](https://github.com/asyncapi/spec/blob/master/spec/asyncapi.md#defaultContentTypeString)
 - [x] [Channels Object](https://github.com/asyncapi/spec/blob/master/spec/asyncapi.md#channelsObject)
 - [x] [Channel Item Object](https://github.com/asyncapi/spec/blob/master/spec/asyncapi.md#channelItemObject)
-- [ ] [Operation Object](https://github.com/asyncapi/spec/blob/master/spec/asyncapi.md#operationObject) (partial)
+- [x] [Operation Object](https://github.com/asyncapi/spec/blob/master/spec/asyncapi.md#operationObject)
 - [x] [Operation Trait Object](https://github.com/asyncapi/spec/blob/master/spec/asyncapi.md#operationTraitObject)
 - [x] [Message Object](https://github.com/asyncapi/spec/blob/master/spec/asyncapi.md#messageObject)
 - [x] [Message Trait Object](https://github.com/asyncapi/spec/blob/master/spec/asyncapi.md#messageTraitObject)

apidom/packages/apidom-ns-asyncapi-2-0/src/elements/Operation.ts

@@ -1,10 +1,80 @@
-import { Attributes, Meta, ObjectElement } from 'minim';
+import { Attributes, Meta } from 'minim';
+import { ObjectElement, StringElement, ArrayElement } from 'apidom';
+
+import TagsElement from './Tags';
+import ExternalDocumentationElement from './ExternalDocumentation';
+import OperationBindingsElement from './OperationBindings';
+import ReferenceElement from './Reference';
 
 class Operation extends ObjectElement {
   constructor(content?: Record<string, unknown>, meta?: Meta, attributes?: Attributes) {
     super(content, meta, attributes);
     this.element = 'operation';
   }
+
+  get operationId(): StringElement {
+    return this.get('operationId');
+  }
+
+  set operationId(operationId: StringElement) {
+    this.set('operationId', operationId);
+  }
+
+  get summary(): StringElement {
+    return this.get('summary');
+  }
+
+  set summary(summary: StringElement) {
+    this.set('summary', summary);
+  }
+
+  get description(): StringElement {
+    return this.get('description');
+  }
+
+  set description(description: StringElement) {
+    this.set('description', description);
+  }
+
+  get tags(): TagsElement | undefined {
+    return this.get('tags');
+  }
+
+  set tags(tags: TagsElement | undefined) {
+    this.set('tags', tags);
+  }
+
+  get externalDocs(): ExternalDocumentationElement | undefined {
+    return this.get('externalDocs');
+  }
+
+  set externalDocs(externalDocs: ExternalDocumentationElement | undefined) {
+    this.set('externalDocs', externalDocs);
+  }
+
+  get bindings(): OperationBindingsElement | ReferenceElement | undefined {
+    return this.get('bindings');
+  }
+
+  set bindings(bindings: OperationBindingsElement | ReferenceElement | undefined) {
+    this.set('bindings', bindings);
+  }
+
+  get traits(): ArrayElement | undefined {
+    return this.get('traits');
+  }
+
+  set traits(traits: ArrayElement | undefined) {
+    this.set('traits', traits);
+  }
+
+  get message(): ArrayElement | undefined {
+    return this.get('message');
+  }
+
+  set message(message: ArrayElement | undefined) {
+    this.set('message', message);
+  }
 }
 
 export default Operation;

apidom/packages/apidom-ns-asyncapi-2-0/src/refractor/specification.ts

@@ -65,6 +65,12 @@ import ComponentsVisitor from './visitors/async-api-2-0/components';
 import ComponentsSchemasVisitor from './visitors/async-api-2-0/components/SchemasVisitor';
 import ComponentParametersVisitor from './visitors/async-api-2-0/components/ParametersVisitor';
 import OperationVisitor from './visitors/async-api-2-0/operation';
+import OperationOperationIdVisitor from './visitors/async-api-2-0/operation/OperationIdVisitor';
+import OperationSummaryVisitor from './visitors/async-api-2-0/operation/SummaryVisitor';
+import OperationDescriptionVisitor from './visitors/async-api-2-0/operation/DescriptionVisitor';
+import OperationBindingsVisitor_ from './visitors/async-api-2-0/operation/BindingsVisitor';
+import OperationTraitsVisitor from './visitors/async-api-2-0/operation/TraitsVisitor';
+import OperationMessageVisitor from './visitors/async-api-2-0/operation/MessageVisitor';
 import TagsVisitor from './visitors/async-api-2-0/tags';
 import TagVisitor from './visitors/async-api-2-0/tag';
 import TagNameVisitor from './visitors/async-api-2-0/tag/NameVisitor';
@@ -345,7 +351,20 @@ const specification = {
         },
         Operation: {
           $visitor: OperationVisitor,
-          fixedFields: {},
+          fixedFields: {
+            operationId: OperationOperationIdVisitor,
+            summary: OperationSummaryVisitor,
+            description: OperationDescriptionVisitor,
+            tags: {
+              $ref: '#/visitors/document/objects/Tags',
+            },
+            externalDocs: {
+              $ref: '#/visitors/document/objects/ExternalDocumentation',
+            },
+            bindings: OperationBindingsVisitor_,
+            traits: OperationTraitsVisitor,
+            message: OperationMessageVisitor,
+          },
         },
         OperationTrait: {
           $visitor: OperationTraitVisitor,

apidom/packages/apidom-ns-asyncapi-2-0/src/refractor/visitors/async-api-2-0/operation/BindingsVisitor.ts

@@ -0,0 +1,32 @@
+import stampit from 'stampit';
+import { T as stubTrue } from 'ramda';
+import { ObjectElement } from 'apidom';
+
+import ReferenceElement from '../../../../elements/Reference';
+import AlternatingVisitor from '../../generics/AlternatingVisitor';
+import FallbackVisitor from '../../FallbackVisitor';
+import { isReferenceLikeElement } from '../../../predicates';
+import { isReferenceElement } from '../../../../predicates';
+
+const BindingsVisitor = stampit(AlternatingVisitor, FallbackVisitor, {
+  props: {
+    alternator: [
+      { predicate: isReferenceLikeElement, specPath: ['document', 'objects', 'Reference'] },
+      { predicate: stubTrue, specPath: ['document', 'objects', 'OperationBindings'] },
+    ],
+  },
+  methods: {
+    ObjectElement(objectElement: ObjectElement) {
+      // @ts-ignore
+      const result = AlternatingVisitor.compose.methods.ObjectElement.call(this, objectElement);
+
+      this.element.filter(isReferenceElement).forEach((referenceElement: ReferenceElement) => {
+        referenceElement.setMetaProperty('referenced-element', 'operationBindings');
+      });
+
+      return result;
+    },
+  },
+});
+
+export default BindingsVisitor;

apidom/packages/apidom-ns-asyncapi-2-0/src/refractor/visitors/async-api-2-0/operation/DescriptionVisitor.ts

@@ -0,0 +1,5 @@
+import FallbackVisitor from '../../FallbackVisitor';
+
+const DescriptionVisitor = FallbackVisitor;
+
+export default DescriptionVisitor;

apidom/packages/apidom-ns-asyncapi-2-0/src/refractor/visitors/async-api-2-0/operation/MessageVisitor.ts

@@ -0,0 +1,34 @@
+import stampit from 'stampit';
+import { ArrayElement, Element, BREAK } from 'apidom';
+
+import SpecificationVisitor from '../../SpecificationVisitor';
+import FallbackVisitor from '../../FallbackVisitor';
+import { isReferenceLikeElement } from '../../../predicates';
+
+const MessageVisitor = stampit(SpecificationVisitor, FallbackVisitor, {
+  init() {
+    this.element = new ArrayElement();
+  },
+  methods: {
+    ArrayElement(arrayElement: ArrayElement) {
+      arrayElement.forEach((item: Element) => {
+        let element;
+
+        if (isReferenceLikeElement(item)) {
+          element = this.toRefractedElement(['document', 'objects', 'Reference'], item);
+          element.setMetaProperty('referenced-element', 'message');
+        } else {
+          element = this.toRefractedElement(['document', 'objects', 'Message'], item);
+        }
+
+        this.element.push(element);
+      });
+
+      this.copyMetaAndAttributes(arrayElement, this.element);
+
+      return BREAK;
+    },
+  },
+});
+
+export default MessageVisitor;

apidom/packages/apidom-ns-asyncapi-2-0/src/refractor/visitors/async-api-2-0/operation/OperationIdVisitor.ts

@@ -0,0 +1,5 @@
+import FallbackVisitor from '../../FallbackVisitor';
+
+const OperationIdVisitor = FallbackVisitor;
+
+export default OperationIdVisitor;

apidom/packages/apidom-ns-asyncapi-2-0/src/refractor/visitors/async-api-2-0/operation/SummaryVisitor.ts

@@ -0,0 +1,5 @@
+import FallbackVisitor from '../../FallbackVisitor';
+
+const SummaryVisitor = FallbackVisitor;
+
+export default SummaryVisitor;

apidom/packages/apidom-ns-asyncapi-2-0/src/refractor/visitors/async-api-2-0/operation/TraitsVisitor.ts

@@ -0,0 +1,34 @@
+import stampit from 'stampit';
+import { ArrayElement, Element, BREAK } from 'apidom';
+
+import SpecificationVisitor from '../../SpecificationVisitor';
+import FallbackVisitor from '../../FallbackVisitor';
+import { isReferenceLikeElement } from '../../../predicates';
+
+const TraitsVisitor = stampit(SpecificationVisitor, FallbackVisitor, {
+  init() {
+    this.element = new ArrayElement();
+  },
+  methods: {
+    ArrayElement(arrayElement: ArrayElement) {
+      arrayElement.forEach((item: Element) => {
+        let element;
+
+        if (isReferenceLikeElement(item)) {
+          element = this.toRefractedElement(['document', 'objects', 'Reference'], item);
+          element.setMetaProperty('referenced-element', 'operationTrait');
+        } else {
+          element = this.toRefractedElement(['document', 'objects', 'OperationTrait'], item);
+        }
+
+        this.element.push(element);
+      });
+
+      this.copyMetaAndAttributes(arrayElement, this.element);
+
+      return BREAK;
+    },
+  },
+});
+
+export default TraitsVisitor;