refactor: add models for server object

src/models/asyncapi.ts

@@ -5,10 +5,13 @@ import { AsyncAPIDocumentV2 } from "./v2";
 import { AsyncAPIDocumentV3 } from "./v3";
 
 import { ExternalDocsMixinInterface, SpecificationExtensionsMixinInterface, TagsMixinInterface } from "./mixins";
+import { ServerInterface } from "./server";
 
 export interface AsyncAPIDocumentInterface extends BaseModel, ExternalDocsMixinInterface, SpecificationExtensionsMixinInterface, TagsMixinInterface {
   version(): string;
   info(): InfoInterface;
+  servers(): Record<string, ServerInterface>;
+  server(name: string): ServerInterface;
 }
 
 export function newAsyncAPIDocument(json: Record<string, any>): AsyncAPIDocumentInterface {

src/models/server-security-requirement.ts

@@ -0,0 +1,5 @@
+import { BaseModel } from "./base";
+
+export interface ServerSecurityRequirementInterface extends BaseModel {
+
+}

src/models/server-variables.ts

@@ -0,0 +1,10 @@
+import { BaseModel } from "./base";
+
+export interface ServerVariableInterface extends BaseModel {
+    allowedValues(): any[];
+    allows(name: string): boolean;
+    hasAllowedValues(): boolean;
+    defaultValue(): string;
+    hasDefaultValue(): boolean;
+    examples(): [string]
+}

src/models/server.ts

@@ -0,0 +1,18 @@
+import { BaseModel } from "./base";
+import { ServerSecurityRequirementInterface } from "./server-security-requirement";
+import { ServerVariableInterface } from "./server-variables";
+import { BindingsMixinInterface, DescriptionMixinInterface, SpecificationExtensionsMixinInterface } from './mixins';
+
+export interface ServerInterface extends BaseModel, BindingsMixinInterface, DescriptionMixinInterface, SpecificationExtensionsMixinInterface {
+    url(): string;
+    hasUrl(): boolean;
+    protocol(): string;
+    hasProtocol(): boolean;
+    protocolVersion(): string | undefined;
+    hasProtocolVersion(): boolean;
+    variables(): Record<string, ServerVariableInterface>;
+    variables(): Record<string, ServerVariableInterface> | undefined;
+    variable(name: string): ServerVariableInterface | undefined;
+    hasVariables(): boolean;
+    security(): [ServerSecurityRequirementInterface] | undefined;
+}

src/models/utils.ts

@@ -0,0 +1,22 @@
+
+function getMapValue(obj: any, key: string, type: any, options?: any) {
+    if (typeof key !== 'string' || !obj) return null;
+    const v = obj[String(key)];
+    if (v === undefined) return null;
+    return type ? new type(v, options) : v;
+}
+
+export function createMapOfTypes(obj: any, type: any, options?: any) {
+    const result: Record<string, any> = {};
+    if (!obj) return result;
+
+    for (let [key, value] of Object.entries(obj)) {
+        result[String(key)] = new type(value, options);
+    }
+
+    return result;
+}
+
+export function getMapValueOfType(obj: any, key: string, type: any, options?: any) {
+    return getMapValue(obj, key, type, options);
+}

src/models/v2/asyncapi.ts

@@ -3,6 +3,9 @@ import { BaseModel } from "../base";
 import { Info } from "./info";
 
 import { Mixin, ExternalDocsMixin, SpecificationExtensionsMixin, TagsMixin } from '../mixins';
+import { ServerInterface } from "../server";
+import { createMapOfTypes, getMapValueOfType } from "../utils";
+import { Server } from "./server";
 
 export class AsyncAPIDocument 
   extends Mixin(BaseModel, ExternalDocsMixin, SpecificationExtensionsMixin, TagsMixin) 
@@ -15,4 +18,12 @@ export class AsyncAPIDocument
   info(): Info {
     return new Info(this.json("info"));
   }
+
+  servers(): Record<string, ServerInterface> {
+    return createMapOfTypes(this.json('servers'), Server);
+  }
+
+  server(name: string): ServerInterface {
+    return getMapValueOfType(this.json('servers'), name, Server);
+  }
 }

src/models/v2/index.ts

@@ -1,4 +1,6 @@
 export { AsyncAPIDocument as AsyncAPIDocumentV2 } from './asyncapi';
 export { Contact as ContactV2 } from './contact';
 export { Info as InfoV2 } from './info';
-export { License as LicenseV2 } from './license';
+export { License as LicenseV2 } from './license';
+export { Server as ServerV2 } from './server';
+export {ServerVariable as ServerVariableV2} from './server-variable';

src/models/v2/server-security-requirement.ts

@@ -0,0 +1,6 @@
+import { BaseModel } from '../base';
+import { ServerSecurityRequirementInterface } from '../server-security-requirement';
+
+export class ServerSecurityRequirement extends BaseModel implements ServerSecurityRequirementInterface {
+
+}

src/models/v2/server-variable.ts

@@ -0,0 +1,29 @@
+import {ServerVariableInterface} from '../server-variables';
+import {BaseModel} from '../base';
+
+export class ServerVariable extends BaseModel implements ServerVariableInterface {
+    allowedValues(): any[] {
+        return this.json('enum');
+    }
+
+    allows(name: string): boolean {
+        if(this.json('enum') === undefined) return true;
+        return this.json('enum').includes(name);
+    }
+
+    hasAllowedValues(): boolean {
+        return this.json('enum') !== undefined;
+    }
+
+    defaultValue(): string {
+        return this.json('default');
+    }
+
+    hasDefaultValue(): boolean {
+        return this.json('default') !== undefined;
+    }
+
+    examples(): [string] {
+        return this.json('examples');
+    }
+}

src/models/v2/server.ts

@@ -0,0 +1,53 @@
+import { createMapOfTypes, getMapValueOfType } from '../utils';
+import { ServerVariableInterface } from '../server-variables';
+import { BaseModel } from '../base';
+import { ServerInterface } from "../server";
+import { ServerVariable } from './server-variable';
+import { ServerSecurityRequirementInterface } from '../server-security-requirement';
+import { ServerSecurityRequirement } from './server-security-requirement';
+import { BindingsMixin, DescriptionMixin, Mixin, SpecificationExtensionsMixin } from '../mixins';
+
+export class Server extends Mixin(BaseModel, BindingsMixin, DescriptionMixin, SpecificationExtensionsMixin) implements ServerInterface {
+    url(): string {
+        return this.json('url');
+    }
+
+    hasUrl(): boolean {
+        return !!this.json('url');
+    }
+
+    protocol(): string {
+        return this.json('protocol');
+    }
+
+    hasProtocol(): boolean {
+        return !!this.json('protocol');
+    }
+
+    protocolVersion(): string {
+        return this.json('protocolVersion');
+    }
+
+    hasProtocolVersion(): boolean {
+        return !!this.json('protocolVersion');
+    }
+
+    variables(): Record<string, ServerVariableInterface>;
+    variables(): Record<string, ServerVariableInterface> | undefined {
+        if(!this.json('variables')) return undefined;
+        return createMapOfTypes(this.json('variables'), ServerVariable)
+    }
+
+    variable(name: string): ServerVariableInterface {
+        return getMapValueOfType(this.json('variables'), name, ServerVariable);
+    }
+
+    hasVariables(): boolean {
+        return !!this.json('variables');
+    }
+
+    security(): [ServerSecurityRequirementInterface] {
+        return this.json('security').map((sec: any) => new ServerSecurityRequirement(sec))
+    }
+
+}

src/models/v3/asyncapi.ts

@@ -3,6 +3,9 @@ import { BaseModel } from "../base";
 import { Info } from "./info";
 
 import { Mixin, ExternalDocsMixin, SpecificationExtensionsMixin, TagsMixin } from '../mixins';
+import { ServerInterface } from "../server";
+import { createMapOfTypes, getMapValueOfType } from "../utils";
+import { Server } from "./server";
 
 export class AsyncAPIDocument 
   extends Mixin(BaseModel, ExternalDocsMixin, SpecificationExtensionsMixin, TagsMixin) 
@@ -15,4 +18,12 @@ export class AsyncAPIDocument
   info(): Info {
     return new Info(this.json("info"));
   }
+
+  servers(): Record<string, ServerInterface> {
+    return createMapOfTypes(this.json('servers'), Server);
+  }
+
+  server(name: string): ServerInterface {
+    return getMapValueOfType(this.json('servers'), name, Server);
+  }
 }

src/models/v3/index.ts

@@ -1,4 +1,5 @@
 export { AsyncAPIDocument as AsyncAPIDocumentV3 } from './asyncapi';
 export { Contact as ContactV3 } from './contact';
 export { Info as InfoV3 } from './info';
-export { License as LicenseV3 } from './license';
+export { License as LicenseV3 } from './license';
+export {Server as ServerV3} from './server';

src/models/v3/server-recurity-requirement.ts

@@ -0,0 +1,6 @@
+import { BaseModel } from "../base";
+import { ServerSecurityRequirementInterface } from "../server-security-requirement";
+
+export class ServerSecurityRequirement extends BaseModel implements ServerSecurityRequirementInterface {
+
+}

src/models/v3/server-variable.ts

@@ -0,0 +1,27 @@
+import { BaseModel } from "../base";
+import { ServerVariableInterface } from "../server-variables";
+
+export class ServerVariable extends BaseModel implements ServerVariableInterface {
+    allowedValues(): any[] {
+        return this.json('enum');
+    }
+    allows(name: string): boolean {
+        if (this.json('enum') === undefined) return true;
+        return this.json('enum').includes(name);
+    }
+
+    hasAllowedValues(): boolean {
+        return this.json('enum') !== undefined;
+    }
+
+    defaultValue(): string {
+        return this.json('default');
+    }
+
+    hasDefaultValue(): boolean {
+        return this.json('default') !== undefined;
+    }
+    examples(): [string] {
+        return this.json('examples');
+    }
+}

src/models/v3/server.ts

@@ -0,0 +1,51 @@
+import { BaseModel } from "../base";
+import { BindingsMixin, DescriptionMixin, Mixin, SpecificationExtensionsMixin } from "../mixins";
+import { ServerInterface } from "../server";
+import { ServerSecurityRequirementInterface } from "../server-security-requirement";
+import { ServerVariableInterface } from "../server-variables";
+import { createMapOfTypes, getMapValueOfType } from "../utils";
+import { ServerSecurityRequirement } from "./server-recurity-requirement";
+import { ServerVariable } from "./server-variable";
+
+
+export class Server extends Mixin(BaseModel, BindingsMixin, DescriptionMixin, SpecificationExtensionsMixin) implements ServerInterface {
+    url(): string {
+        return this.json('url');
+    }
+
+    hasUrl(): boolean {
+        return !!this.json('url');
+    }
+
+    protocol(): string {
+        return this.json('protocol');
+    }
+
+    hasProtocol(): boolean {
+        return !!this.json('protocol');
+    }
+
+    protocolVersion(): string {
+        return this.json('protocolVersion');
+    }
+
+    hasProtocolVersion(): boolean {
+        return !!this.json('protocolVersion');
+    }
+
+    variables(): Record<string, ServerVariableInterface> {
+        return createMapOfTypes(this.json('variables'), ServerVariable);
+    }
+
+    variable(name: string): ServerVariableInterface {
+        return getMapValueOfType(this.json('variables'), name, ServerVariable);
+    }
+
+    hasVariables(): boolean {
+        return !!this.json('variables');
+    }
+
+    security(): [ServerSecurityRequirementInterface] | undefined {
+        return this.json('security').map((sec: any) => new ServerSecurityRequirement(sec))
+    }
+}