feat: enable title configuration in the v3 spec

.gitignore

@@ -1,4 +1,5 @@
 node_modules
+.npm-cache
 .vscode
 .DS_Store
 /docs

packages/parser/src/models/channel.ts

@@ -1,11 +1,11 @@
 import type { BaseModel } from './base';
 import type { ChannelParametersInterface } from './channel-parameters';
 import type { MessagesInterface } from './messages';
-import type { BindingsMixinInterface, DescriptionMixinInterface, ExtensionsMixinInterface } from './mixins';
+import type { BindingsMixinInterface, DescriptionMixinInterface, ExtensionsMixinInterface, TitleMixinInterface } from './mixins';
 import type { OperationsInterface } from './operations';
 import type { ServersInterface } from './servers';
 
-export interface ChannelInterface extends BaseModel, BindingsMixinInterface, DescriptionMixinInterface, ExtensionsMixinInterface {
+export interface ChannelInterface extends BaseModel, BindingsMixinInterface, DescriptionMixinInterface, ExtensionsMixinInterface, TitleMixinInterface {
   id(): string;
   address(): string | null | undefined;
   servers(): ServersInterface;

packages/parser/src/models/v2/channel.ts

@@ -39,6 +39,14 @@ export class Channel extends BaseModel<v2.ChannelObject, { id: string, address:
     return description(this);
   }
 
+  hasTitle(): boolean {
+    return false;
+  }
+
+  title(): string | undefined {
+    return undefined;
+  }
+
   servers(): ServersInterface {
     const servers: ServerInterface[] = [];
     const allowedServers: string[] = this._json.servers || [];

packages/parser/test/models/v2/utils.ts

@@ -147,4 +147,5 @@ export function assertTags(model: Constructor<TagsMixinInterface>) {
       expect(d3.tags().length).toEqual(0);
     });
   });
-}
+}
+

packages/parser/test/models/v3/asyncapi.spec.ts

@@ -269,6 +269,22 @@ describe('AsyncAPIDocument model', function() {
       const d = new AsyncAPIDocument(doc);
       expect(d.allChannels()).toBeInstanceOf(Channels);
     });
+
+    it('should expose channel title and hasTitle (#1067)', function() {
+      const doc = serializeInput<v3.AsyncAPIObject>({
+        channels: {
+          'user/signup': {
+            address: 'user/signup',
+            title: 'User signup channel',
+          },
+        },
+      });
+      const d = new AsyncAPIDocument(doc);
+      const channel = d.allChannels().all()[0];
+      expect(channel.id()).toEqual('user/signup');
+      expect(channel.hasTitle()).toEqual(true);
+      expect(channel.title()).toEqual('User signup channel');
+    });
   });
 
   describe('.allOperations()', function() {

packages/parser/test/parse.spec.ts

@@ -437,6 +437,26 @@ describe('parse()', function () {
     expect(filterLastVersionDiagnostics(diagnostics).length === 0).toEqual(true);
   });
 
+  it('should return channel title from allChannels() (#1067)', async function () {
+    const { document, diagnostics } = await parser.parse(`
+asyncapi: 3.0.0
+info:
+  title: API
+  version: 1.0.0
+channels:
+  user/signup:
+    address: user/signup
+    title: User signup channel
+`);
+
+    expect(document).toBeDefined();
+    expect(filterLastVersionDiagnostics(diagnostics).length === 0).toEqual(true);
+    const channel = document!.allChannels().all()[0];
+    expect(channel.id()).toEqual('user/signup');
+    expect(channel.hasTitle()).toEqual(true);
+    expect(channel.title()).toEqual('User signup channel');
+  });
+
   it('should not parse invalid v3 YAML document and give error in line 153 (#936)', async function () {
     const documentRaw = `asyncapi: 3.0.0
 info: