Fix asyncapi#1076: Added server.summary() hasSummary() functions

- summary(): Returns the server summary string or undefined
- hasSummary(): Returns boolean indicating if summary exists
- Added unit tests for the respective functions
- Tested the code by building, ensuring changes in esm, cjs

Author: AlexiusTatius

package-lock.json

@@ -9,6 +9,8 @@ import type { SecurityRequirementsInterface } from './security-requirements';
 export interface ServerInterface extends BaseModel, DescriptionMixinInterface, BindingsMixinInterface, ExtensionsMixinInterface, TagsMixinInterface {
   id(): string
   url(): string;
+  summary(): string | undefined;
+  hasSummary(): boolean;
   host(): string;
   hasPathname(): boolean;
   pathname(): string | undefined;

packages/parser/src/models/server.ts

@@ -34,6 +34,14 @@ export class Server extends BaseModel<v2.ServerObject, { id: string }> implement
   url(): string {
     return this._json.url;
   }
+  
+  summary(): string | undefined {
+    return this._json.summary;
+  }
+
+  hasSummary(): boolean {
+    return !!this._json.summary;
+  }
 
   host(): string {
     const url = new URL(this.url());

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

@@ -26,7 +26,7 @@ export class Server extends CoreModel<v3.ServerObject, { id: string }> implement
   id(): string {
     return this._meta.id;
   }
-
+  
   url(): string {
     let host = this.host();
     if (!host.endsWith('/')) {

packages/parser/src/models/v3/server.ts

@@ -41,6 +41,7 @@ export type ServersObject = Record<string, ServerObject>;
 export interface ServerObject extends SpecificationExtensions {
   url: string;
   protocol: string;
+  summary?: string;
   protocolVersion?: string;
   description?: string;
   variables?: Record<string, ServerVariableObject>;

packages/parser/src/spec-types/v2.ts

@@ -17,6 +17,7 @@ import { SecurityRequirement } from '../../../src/models/v2/security-requirement
 const doc = {
   development: {
     protocol: 'mqtt',
+    summary: 'mqtt development server is summary',
     protocolVersion: '1.0.0',
     url: 'development.gigantic-server.com',
     variables: {
@@ -43,6 +44,21 @@ describe('Server Model', function () {
     });
   });
 
+  describe('.summary()', function () {
+    it('should return value', function () {
+      expect(docItem.summary()).toEqual(doc.development.summary);
+    });
+  });
+
+  describe('.hasSummary()', function () {
+    it('should return true if summary is present', function () {
+      expect(docItem.hasSummary()).toEqual(true);
+    });
+    it('should return false if summary is missing', function () {
+      expect(emptyItem.hasSummary()).toEqual(false);
+    });
+  });
+
   describe('.hasProtocolVersion()', function () {
     it('should return true if protocolVersion is not missing', function () {
       expect(docItem.hasProtocolVersion()).toBeTruthy();

packages/parser/test/models/v2/server.spec.ts

@@ -18,6 +18,7 @@ import { xParserObjectUniqueId } from '../../../src/constants';
 const doc = {
   production: {
     host: 'rabbitmq.in.mycompany.com:5672',
+    summary: 'rabbitmq production server is summary',
     pathname: '/production',
     protocol: 'amqp',
     protocolVersion: '1.0.0',
@@ -45,6 +46,21 @@ describe('Server Model', function () {
     });
   });
 
+  describe('.summary()', function () {
+    it('should return value', function () {
+      expect(docItem.summary()).toEqual(doc.production.summary);
+    });
+  });
+
+  describe('.hasSummary()', function () {
+    it('should return true if summary is present', function () {
+      expect(docItem.hasSummary()).toEqual(true);
+    });
+    it('should return false if summary is missing', function () {
+      expect(emptyItem.hasSummary()).toEqual(false);
+    });
+  });
+
   describe('.host()', function () {
     it('should return value', function () {
       expect(docItem.host()).toEqual(doc.production.host);