Develop

src/lib/swagger-express-ts/api-model-property.decorator.ts

@@ -1,61 +1,68 @@
-import { SwaggerService } from "./swagger.service";
-import { IApiOperationArgsBase } from "./i-api-operation-args.base";
+import {SwaggerService} from "./swagger.service";
+import {IApiOperationArgsBase} from "./i-api-operation-args.base";
 
 export interface IApiModelPropertyArgs {
-  /**
-   * Define if property is required.
-   * Optional. Default is false.
-   */
-  required?: boolean;
-
-  /**
-   * Define format of property. Example: SwaggerDefinitionConstant.Definition.Property.Format.INT_64
-   * Optional.
-   */
-  format?: string;
-
-  /**
-   * Define type of property. Example: SwaggerDefinitionConstant.Definition.Property.Type.STRING
-   * Optional.
-   */
-  type?: string;
-
-  /**
-   * Define description.
-   * Optional.
-   */
-  description?: string;
-
-  /**
-   * Define enum;
-   * Optional.
-   */
-  enum?: string[];
-
-  /**
-   * Define model.
-   * Optional.
-   */
-  model?: string;
-
-  /**
-   * Define type of item. Example: SwaggerDefinitionConstant.Definition.Property.Type.STRING
-   * Optional.
-   */
-  itemType?: string;
+    /**
+     * Define if property is required.
+     * Optional. Default is false.
+     */
+    required?: boolean;
+
+    /**
+     * Define format of property. Example: SwaggerDefinitionConstant.Definition.Property.Format.INT_64
+     * Optional.
+     */
+    format?: string;
+
+    /**
+     * Define type of property. Example: SwaggerDefinitionConstant.Definition.Property.Type.STRING
+     * Optional.
+     */
+    type?: string;
+
+    /**
+     * Define description.
+     * Optional.
+     */
+    description?: string;
+
+    /**
+     * Define enum;
+     * Optional.
+     */
+    enum?: string[];
+
+    /**
+     * Define model.
+     * Optional.
+     */
+    model?: string;
+
+    /**
+     * Define type of item. Example: SwaggerDefinitionConstant.Definition.Property.Type.STRING
+     * Optional.
+     */
+    itemType?: string;
+
+    /**
+     * Define apiVersion. Example: v1
+     * Optional.
+     */
+    apiVersion?: string[];
 }
 
-export function ApiModelProperty(
-  args?: IApiModelPropertyArgs
-): PropertyDecorator {
-  return function(target: any, propertyKey: string | symbol) {
-    const propertyType = Reflect.getMetadata("design:type", target, propertyKey)
-      .name;
-    SwaggerService.getInstance().addApiModelProperty(
-      args,
-      target,
-      propertyKey,
-      propertyType
-    );
-  };
+export function ApiModelProperty(args?: IApiModelPropertyArgs): PropertyDecorator {
+    return function (target: any, propertyKey: string | symbol) {
+        const propertyType = Reflect.getMetadata("design:type", target, propertyKey)
+            .name;
+        const apiVersions = args.apiVersion || ["v1"];
+        apiVersions.forEach((apiV: string) => {
+            SwaggerService.getInstance(apiV).addApiModelProperty(
+                args,
+                target,
+                propertyKey,
+                propertyType
+            );
+        });
+    };
 }

src/lib/swagger-express-ts/api-model.decorator.ts

@@ -1,13 +1,16 @@
-import { SwaggerService } from "./swagger.service";
-import { IApiOperationArgsBase } from "./i-api-operation-args.base";
+import {SwaggerService} from "./swagger.service";
 
 export interface IApiModelArgs {
-  description?: string;
-  name?: string;
+    description?: string;
+    name?: string;
+    apiVersion?: string[];
 }
 
 export function ApiModel(args?: IApiModelArgs): ClassDecorator {
-  return function(target: any) {
-    SwaggerService.getInstance().addApiModel(args, target);
-  };
+    return function (target: any) {
+        const apiVersions = args.apiVersion || ["v1"];
+        apiVersions.forEach((apiV: string) => {
+            SwaggerService.getInstance(apiV).addApiModel(args, target);
+        });
+    };
 }

src/lib/swagger-express-ts/api-operation-delete.decorator.ts

@@ -1,15 +1,20 @@
-import { SwaggerService } from "./swagger.service";
-import { IApiOperationArgsBase } from "./i-api-operation-args.base";
-export interface IApiOperationDeleteArgs extends IApiOperationArgsBase {}
+import {SwaggerService} from "./swagger.service";
+import {IApiOperationArgsBase} from "./i-api-operation-args.base";
 
-export function ApiOperationDelete(
-  args: IApiOperationDeleteArgs
-): MethodDecorator {
-  return function(
-    target: any,
-    propertyKey: string | symbol,
-    descriptor: PropertyDescriptor
-  ) {
-    SwaggerService.getInstance().addOperationDelete(args, target, propertyKey);
-  };
+export interface IApiOperationDeleteArgs extends IApiOperationArgsBase {
+}
+
+export function ApiOperationDelete(args: IApiOperationDeleteArgs): MethodDecorator {
+    return function (target: any,
+                     propertyKey: string | symbol,
+                     descriptor: PropertyDescriptor) {
+        const apiVersions = args.apiVersion || ["v1"];
+        apiVersions.forEach((apiV: string) => {
+            SwaggerService.getInstance(apiV).addOperationDelete(
+                args,
+                target,
+                propertyKey
+            );
+        });
+    };
 }

src/lib/swagger-express-ts/api-operation-get.decorator.ts

@@ -1,13 +1,20 @@
-import { SwaggerService } from "./swagger.service";
-import { IApiOperationArgsBase } from "./i-api-operation-args.base";
-export interface IApiOperationGetArgs extends IApiOperationArgsBase {}
+import {SwaggerService} from "./swagger.service";
+import {IApiOperationArgsBase} from "./i-api-operation-args.base";
+
+export interface IApiOperationGetArgs extends IApiOperationArgsBase {
+}
 
 export function ApiOperationGet(args: IApiOperationGetArgs): MethodDecorator {
-  return function(
-    target: any,
-    propertyKey: string | symbol,
-    descriptor: PropertyDescriptor
-  ) {
-    SwaggerService.getInstance().addOperationGet(args, target, propertyKey);
-  };
+    return function (target: any,
+                     propertyKey: string | symbol,
+                     descriptor: PropertyDescriptor) {
+        const apiVersions = args.apiVersion || ["v1"];
+        apiVersions.forEach((apiV: string) => {
+            SwaggerService.getInstance(apiV).addOperationGet(
+                args,
+                target,
+                propertyKey
+            );
+        });
+    };
 }

src/lib/swagger-express-ts/api-operation-patch.decorator.ts

@@ -1,15 +1,20 @@
-import { SwaggerService } from "./swagger.service";
-import { IApiOperationArgsBase } from "./i-api-operation-args.base";
-export interface IApiOperationPatchArgs extends IApiOperationArgsBase {}
+import {SwaggerService} from "./swagger.service";
+import {IApiOperationArgsBase} from "./i-api-operation-args.base";
 
-export function ApiOperationPatch(
-  args: IApiOperationPatchArgs
-): MethodDecorator {
-  return function(
-    target: any,
-    propertyKey: string | symbol,
-    descriptor: PropertyDescriptor
-  ) {
-    SwaggerService.getInstance().addOperationPatch(args, target, propertyKey);
-  };
+export interface IApiOperationPatchArgs extends IApiOperationArgsBase {
+}
+
+export function ApiOperationPatch(args: IApiOperationPatchArgs): MethodDecorator {
+    return function (target: any,
+                     propertyKey: string | symbol,
+                     descriptor: PropertyDescriptor) {
+        const apiVersions = args.apiVersion || ["v1"];
+        apiVersions.forEach((apiV: string) => {
+            SwaggerService.getInstance(apiV).addOperationPatch(
+                args,
+                target,
+                propertyKey
+            );
+        });
+    };
 }

src/lib/swagger-express-ts/api-operation-post.decorator.ts

@@ -1,13 +1,20 @@
-import { SwaggerService } from "./swagger.service";
-import { IApiOperationArgsBase } from "./i-api-operation-args.base";
-export interface IApiOperationPostArgs extends IApiOperationArgsBase {}
+import {SwaggerService} from "./swagger.service";
+import {IApiOperationArgsBase} from "./i-api-operation-args.base";
+
+export interface IApiOperationPostArgs extends IApiOperationArgsBase {
+}
 
 export function ApiOperationPost(args: IApiOperationPostArgs): MethodDecorator {
-  return function(
-    target: any,
-    propertyKey: string | symbol,
-    descriptor: PropertyDescriptor
-  ) {
-    SwaggerService.getInstance().addOperationPost(args, target, propertyKey);
-  };
+    return function (target: any,
+                     propertyKey: string | symbol,
+                     descriptor: PropertyDescriptor) {
+        const apiVersions = args.apiVersion || ["v1"];
+        apiVersions.forEach((apiV: string) => {
+            SwaggerService.getInstance(apiV).addOperationPost(
+                args,
+                target,
+                propertyKey
+            );
+        });
+    };
 }

src/lib/swagger-express-ts/api-operation-put.decorator.ts

@@ -1,13 +1,20 @@
-import { SwaggerService } from "./swagger.service";
-import { IApiOperationArgsBase } from "./i-api-operation-args.base";
-export interface IApiOperationPutArgs extends IApiOperationArgsBase {}
+import {SwaggerService} from "./swagger.service";
+import {IApiOperationArgsBase} from "./i-api-operation-args.base";
+
+export interface IApiOperationPutArgs extends IApiOperationArgsBase {
+}
 
 export function ApiOperationPut(args: IApiOperationPutArgs): MethodDecorator {
-  return function(
-    target: any,
-    propertyKey: string | symbol,
-    descriptor: PropertyDescriptor
-  ) {
-    SwaggerService.getInstance().addOperationPut(args, target, propertyKey);
-  };
+    return function (target: any,
+                     propertyKey: string | symbol,
+                     descriptor: PropertyDescriptor) {
+        const apiVersions = args.apiVersion || ["v1"];
+        apiVersions.forEach((apiV: string) => {
+            SwaggerService.getInstance(apiV).addOperationPut(
+                args,
+                target,
+                propertyKey
+            );
+        });
+    };
 }

src/lib/swagger-express-ts/api-path.decorator.ts

@@ -1,13 +1,19 @@
-import { SwaggerService } from "./swagger.service";
+import {SwaggerService} from "./swagger.service";
+
 export interface IApiPathArgs {
-  path: string;
-  name: string;
-  description?: string;
-  security?: { [key: string]: any[] };
-  deprecated?: boolean;
+    path: string;
+    name: string;
+    description?: string;
+    security?: { [key: string]: any[] };
+    deprecated?: boolean;
+    apiVersion?: string[];
 }
+
 export function ApiPath(args: IApiPathArgs): ClassDecorator {
-  return function(target: any) {
-    SwaggerService.getInstance().addPath(args, target);
-  };
+    return function (target: any) {
+        const apiVersions = args.apiVersion || ["v1"];
+        apiVersions.forEach((apiV: string) => {
+            SwaggerService.getInstance(apiV).addPath(args, target);
+        });
+    };
 }