feat(apidom-ls): support oneOf field in Operation.message field

packages/apidom-ls/src/config/asyncapi/message/complete/message.ts

@@ -17,6 +17,19 @@ const messageComplete: ApidomCompletionItem[] = [
       value: 'A reference to a message',
     },
   },
+  {
+    label: 'oneOf',
+    insertText: 'oneOf',
+    kind: 14,
+    format: CompletionFormat.QUOTED,
+    type: CompletionType.PROPERTY,
+    insertTextFormat: 2,
+    documentation: {
+      kind: 'markdown',
+      value:
+        '`oneOf` key is specific to **Operation.message** fixed field. The key is allowed here to specify multiple messages. However, **a message MUST be valid only against one of the message objects.**',
+    },
+  },
   {
     label: 'headers',
     insertText: 'headers',

packages/apidom-ls/src/config/asyncapi/operation/lint/message.ts

@@ -7,7 +7,7 @@ const operationMessageLint: LinterMeta = {
   message: '"message" must be a Message Object',
   severity: 1,
   linterFunction: 'apilintElementOrClass',
-  linterParams: ['message'],
+  linterParams: [['message', 'operation-message-map']],
   marker: 'value',
   target: 'message',
   data: {},

packages/apidom-ns-asyncapi-2/src/elements/nces/OperationMessageMap.ts

@@ -0,0 +1,21 @@
+import { Attributes, Meta } from 'minim';
+import { ObjectElement, ArrayElement } from '@swagger-api/apidom-core';
+
+class OperationMessageMap extends ObjectElement {
+  static primaryClass = 'operation-message-map';
+
+  constructor(content?: Record<string, unknown>, meta?: Meta, attributes?: Attributes) {
+    super(content, meta, attributes);
+    this.classes.push(OperationMessageMap.primaryClass);
+  }
+
+  get oneOf(): ArrayElement | undefined {
+    return this.get('oneOf');
+  }
+
+  set oneOf(oneOf: ArrayElement | undefined) {
+    this.set('oneOf', oneOf);
+  }
+}
+
+export default OperationMessageMap;

packages/apidom-ns-asyncapi-2/src/refractor/plugins/replace-empty-element.ts

@@ -148,6 +148,7 @@ import ChannelItemServersElement from '../../elements/nces/ChannelItemsServers';
 import OAuthFlowScopesElement from '../../elements/nces/OAuthFlowScopes';
 import OperationTraitsElement from '../../elements/nces/OperationTraits';
 import ServerSecurityElement from '../../elements/nces/ServerSecurity';
+import OperationMessageMapElement from '../../elements/nces/OperationMessageMap';
 import OperationMessageElement from '../../elements/nces/OperationMessage';
 import MessageExamplesElement from '../../elements/nces/MessageExamples';
 import MessageTraitsElement from '../../elements/nces/MessageTraits';
@@ -872,6 +873,11 @@ const schema = {
       return new OperationTraitElement(...args);
     },
   },
+  [OperationMessageMapElement.primaryClass]: {
+    oneOf(...args: any[]) {
+      return new OperationMessageElement(...args);
+    },
+  },
   [OperationMessageElement.primaryClass]: {
     '<*>': function asterisk(...args: any[]) {
       return new MessageElement(...args);

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

@@ -4,6 +4,7 @@ import { ObjectElement, isArrayElement, BREAK } from '@swagger-api/apidom-core';
 import SpecificationVisitor from '../../SpecificationVisitor';
 import FallbackVisitor from '../../FallbackVisitor';
 import { isReferenceLikeElement } from '../../../predicates';
+import OperationMessageMapElement from '../../../../elements/nces/OperationMessageMap';
 import OperationMessageElement from '../../../../elements/nces/OperationMessage';
 
 const MessageVisitor = stampit(SpecificationVisitor, FallbackVisitor, {
@@ -13,7 +14,7 @@ const MessageVisitor = stampit(SpecificationVisitor, FallbackVisitor, {
         this.element = this.toRefractedElement(['document', 'objects', 'Reference'], objectElement);
         this.element.setMetaProperty('referenced-element', 'message');
       } else if (isArrayElement(objectElement.get('oneOf'))) {
-        this.element = new ObjectElement();
+        this.element = new OperationMessageMapElement();
         const operationMessageElement = new OperationMessageElement();
 
         objectElement.get('oneOf').forEach((item: ObjectElement) => {
@@ -28,7 +29,7 @@ const MessageVisitor = stampit(SpecificationVisitor, FallbackVisitor, {
           operationMessageElement.push(element);
         });
 
-        this.element.set('oneOf', operationMessageElement);
+        this.element.oneOf = operationMessageElement;
       } else {
         this.element = this.toRefractedElement(['document', 'objects', 'Message'], objectElement);
       }