Merge branch 'master' of https://github.com/nestjs/swagger

Author: kamilmysliwiec

lib/decorators/api-response.decorator.ts

@@ -4,7 +4,8 @@ import { omit } from 'lodash';
 import { DECORATORS } from '../constants';
 import {
   ResponseObject,
-  SchemaObject
+  SchemaObject,
+  ReferenceObject
 } from '../interfaces/open-api-spec.interface';
 import { getTypeIsArrayTuple } from './helpers';
 
@@ -18,7 +19,7 @@ export interface ApiResponseMetadata
 
 export interface ApiResponseSchemaHost
   extends Omit<ResponseObject, 'description'> {
-  schema: SchemaObject;
+  schema: SchemaObject & Partial<ReferenceObject>;
   status?: number;
   description?: string;
 }
@@ -180,6 +181,14 @@ export const ApiNotImplementedResponse = (options: ApiResponseOptions = {}) =>
     status: HttpStatus.NOT_IMPLEMENTED
   });
 
+export const ApiPreconditionFailedResponse = (
+  options: ApiResponseOptions = {}
+) =>
+  ApiResponse({
+    ...options,
+    status: HttpStatus.PRECONDITION_FAILED
+  });
+
 export const ApiPayloadTooLargeResponse = (options: ApiResponseOptions = {}) =>
   ApiResponse({
     ...options,