@nestjs/common 7.6.11 → 7.6.15

package/Readme.md

@@ -37,6 +37,7 @@ Nest is a framework for building efficient, scalable <a href="http://nodejs.org"
 
 * To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
 * 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:
+* [가이드](readme_kr.md)를 확인하려면, [docs.nestjs.com](https://docs.nestjs.com)를 방문하세요.:books: 
 
 ## Questions
 
@@ -95,11 +96,11 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
   <td align="center" valign="middle">
   <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" width="97" valign="middle" /></a> </td>
 <td align="center" valign="middle"><a href="https://sanyodigital.com/" target="_blank"><img src="https://nestjs.com/img/sanyo-digital.png" width="130" valign="middle" /></a></td></tr><tr><td align="center" valign="middle"><a href="https://vpn-review.com/vpn-for-torrenting" target="_blank"><img src="https://nestjs.com/img/vpn-review-logo.png" width="85" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://lambda-it.ch/" target="_blank"><img src="https://nestjs.com/img/lambda-it-logo.svg" width="115" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://pickwriters.com/top-10-translation-services" target="_blank"><img src="https://nestjs.com/img/pickwriters-logo.png" width="40" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://thewordpoint.com/services/localization" target="_blank"><img src="https://nestjs.com/img/thewordpoint-logo.png" width="40" valign="middle" /></a></td>
-<td align="center" valign="middle"><a href="https://streamat.se/" target="_blank"><img src="https://nestjs.com/img/streamat-logo.png" width="120" valign="middle" /></a></td>
-<td align="center" valign="middle"><a href="https://filmen.nu/" target="_blank"><img src="https://nestjs.com/img/filmen-logo.png" width="120" valign="middle" /></a></td></tr><tr>
 <td align="center" valign="middle"><a href="https://meercode.io/" target="_blank"><img src="https://nestjs.com/img/meercode-logo.png" width="60" valign="middle" /></a></td>
-  <td align="center" valign="middle"><a href="https://www.najlepszeplatformyforex.pl/blog/broker-xtb/" target="_blank"><img src="https://nestjs.com/img/npf-logo.jpg" width="200" valign="middle" /></a></td>
-    <td align="center" valign="middle"><a href="https://thestandarddaily.com/" target="_blank"><img src="https://nestjs.com/img/the-standard-daily-logo.png" width="180" valign="middle" /></a></td>
+  <td align="center" valign="middle"><a href="https://www.najlepszeplatformyforex.pl/blog/broker-xtb/" target="_blank"><img src="https://nestjs.com/img/npf-logo.jpg" width="200" valign="middle" /></a></td></tr><tr>
+<td align="center" valign="middle"><a href="https://thestandarddaily.com/" target="_blank"><img src="https://nestjs.com/img/the-standard-daily-logo.png" width="180" valign="middle" /></a></td>
+<td align="center" valign="middle"><a href="https://houseofangular.io/" target="_blank"><img src="https://nestjs.com/img/house-of-angular.png" width="100" valign="middle" /></a></td>
+<td align="center" valign="middle"><a href="https://rocketech.it/cases/?utm_source=google&utm_medium=badge&utm_campaign=nestjs" target="_blank"><img src="https://nestjs.com/img/rocketech-logo.svg" width="110" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers

package/cache/interceptors/cache.interceptor.js

@@ -15,8 +15,9 @@ let CacheInterceptor = class CacheInterceptor {
         this.reflector = reflector;
     }
     async intercept(context, next) {
+        var _a;
         const key = this.trackBy(context);
-        const ttlValueOrFactory = this.reflector.get(cache_constants_1.CACHE_TTL_METADATA, context.getHandler()) || null;
+        const ttlValueOrFactory = (_a = this.reflector.get(cache_constants_1.CACHE_TTL_METADATA, context.getHandler())) !== null && _a !== void 0 ? _a : null;
         if (!key) {
             return next.handle();
         }
@@ -33,7 +34,7 @@ let CacheInterceptor = class CacheInterceptor {
                 this.cacheManager.set(...args);
             }));
         }
-        catch (_a) {
+        catch (_b) {
             return next.handle();
         }
     }

package/decorators/http/route-params.decorator.d.ts

@@ -79,7 +79,7 @@ export declare const Session: () => ParameterDecorator;
  * Route handler parameter decorator. Extracts the `file` object
  * and populates the decorated parameter with the value of `file`.
  * Used in conjunction with
- * [multer middleware](https://github.com/expressjs/multer).
+ * [multer middleware](https://github.com/expressjs/multer) for Express-based applications.
  *
  * For example:
  * ```typescript
@@ -91,12 +91,63 @@ export declare const Session: () => ParameterDecorator;
  *
  * @publicApi
  */
-export declare const UploadedFile: (fileKey?: string) => ParameterDecorator;
+export declare function UploadedFile(): ParameterDecorator;
+/**
+ * Route handler parameter decorator. Extracts the `file` object
+ * and populates the decorated parameter with the value of `file`.
+ * Used in conjunction with
+ * [multer middleware](https://github.com/expressjs/multer) for Express-based applications.
+ *
+ * For example:
+ * ```typescript
+ * uploadFile(@UploadedFile() file) {
+ *   console.log(file);
+ * }
+ * ```
+ * @see [Request object](https://docs.nestjs.com/techniques/file-upload)
+ *
+ * @publicApi
+ */
+export declare function UploadedFile(...pipes: (Type<PipeTransform> | PipeTransform)[]): ParameterDecorator;
+/**
+ * Route handler parameter decorator. Extracts the `file` object
+ * and populates the decorated parameter with the value of `file`.
+ * Used in conjunction with
+ * [multer middleware](https://github.com/expressjs/multer) for Express-based applications.
+ *
+ * For example:
+ * ```typescript
+ * uploadFile(@UploadedFile() file) {
+ *   console.log(file);
+ * }
+ * ```
+ * @see [Request object](https://docs.nestjs.com/techniques/file-upload)
+ *
+ * @publicApi
+ */
+export declare function UploadedFile(fileKey?: string, ...pipes: (Type<PipeTransform> | PipeTransform)[]): ParameterDecorator;
+/**
+ * Route handler parameter decorator. Extracts the `files` object
+ * and populates the decorated parameter with the value of `files`.
+ * Used in conjunction with
+ * [multer middleware](https://github.com/expressjs/multer) for Express-based applications.
+ *
+ * For example:
+ * ```typescript
+ * uploadFile(@UploadedFiles() files) {
+ *   console.log(files);
+ * }
+ * ```
+ * @see [Request object](https://docs.nestjs.com/techniques/file-upload)
+ *
+ * @publicApi
+ */
+export declare function UploadedFiles(): ParameterDecorator;
 /**
  * Route handler parameter decorator. Extracts the `files` object
  * and populates the decorated parameter with the value of `files`.
  * Used in conjunction with
- * [multer middleware](https://github.com/expressjs/multer).
+ * [multer middleware](https://github.com/expressjs/multer) for Express-based applications.
  *
  * For example:
  * ```typescript
@@ -108,7 +159,7 @@ export declare const UploadedFile: (fileKey?: string) => ParameterDecorator;
  *
  * @publicApi
  */
-export declare const UploadedFiles: () => ParameterDecorator;
+export declare function UploadedFiles(...pipes: (Type<PipeTransform> | PipeTransform)[]): ParameterDecorator;
 /**
  * Route handler parameter decorator. Extracts the `headers`
  * property from the `req` object and populates the decorated

package/decorators/http/route-params.decorator.js

@@ -85,7 +85,7 @@ exports.Session = createRouteParamDecorator(route_paramtypes_enum_1.RouteParamty
  * Route handler parameter decorator. Extracts the `file` object
  * and populates the decorated parameter with the value of `file`.
  * Used in conjunction with
- * [multer middleware](https://github.com/expressjs/multer).
+ * [multer middleware](https://github.com/expressjs/multer) for Express-based applications.
  *
  * For example:
  * ```typescript
@@ -97,12 +97,15 @@ exports.Session = createRouteParamDecorator(route_paramtypes_enum_1.RouteParamty
  *
  * @publicApi
  */
-exports.UploadedFile = createRouteParamDecorator(route_paramtypes_enum_1.RouteParamtypes.FILE);
+function UploadedFile(fileKey, ...pipes) {
+    return createPipesRouteParamDecorator(route_paramtypes_enum_1.RouteParamtypes.FILE)(fileKey, ...pipes);
+}
+exports.UploadedFile = UploadedFile;
 /**
  * Route handler parameter decorator. Extracts the `files` object
  * and populates the decorated parameter with the value of `files`.
  * Used in conjunction with
- * [multer middleware](https://github.com/expressjs/multer).
+ * [multer middleware](https://github.com/expressjs/multer) for Express-based applications.
  *
  * For example:
  * ```typescript
@@ -114,7 +117,10 @@ exports.UploadedFile = createRouteParamDecorator(route_paramtypes_enum_1.RoutePa
  *
  * @publicApi
  */
-exports.UploadedFiles = createRouteParamDecorator(route_paramtypes_enum_1.RouteParamtypes.FILES);
+function UploadedFiles(...pipes) {
+    return createPipesRouteParamDecorator(route_paramtypes_enum_1.RouteParamtypes.FILES)(undefined, ...pipes);
+}
+exports.UploadedFiles = UploadedFiles;
 /**
  * Route handler parameter decorator. Extracts the `headers`
  * property from the `req` object and populates the decorated

package/interfaces/external/class-transform-options.interface.d.ts

@@ -55,4 +55,11 @@ export interface ClassTransformOptions {
      * This is useful when you convert a plain object to a class and have an optional field with a default value.
      */
     exposeDefaultValues?: boolean;
+    /**
+     * When set to true, fields with `undefined` as value will be included in class to plain transformation. Otherwise
+     * those fields will be omitted from the result.
+     *
+     * DEFAULT: `true`
+     */
+    exposeUnsetFields?: boolean;
 }

package/interfaces/external/cors-options.interface.d.ts

@@ -1,3 +1,4 @@
+declare type StaticOrigin = boolean | string | RegExp | (string | RegExp)[];
 /**
  * Set origin to a function implementing some custom logic. The function takes the
  * request origin as the first parameter and a callback (which expects the signature
@@ -7,7 +8,7 @@
  *
  * @publicApi
  */
-export declare type CustomOrigin = (requestOrigin: string, callback: (err: Error | null, allow?: boolean) => void) => void;
+export declare type CustomOrigin = (requestOrigin: string, callback: (err: Error | null, origin?: StaticOrigin) => void) => void;
 /**
  * Interface describing CORS options that can be set.
  *
@@ -18,7 +19,7 @@ export interface CorsOptions {
     /**
      * Configures the `Access-Control-Allow-Origins` CORS header.  See [here for more detail.](https://github.com/expressjs/cors#configuration-options)
      */
-    origin?: boolean | string | RegExp | (string | RegExp)[] | CustomOrigin;
+    origin?: StaticOrigin | CustomOrigin;
     /**
      * Configures the Access-Control-Allow-Methods CORS header.
      */
@@ -54,3 +55,4 @@ export interface CorsOptionsCallback {
 export interface CorsOptionsDelegate<T> {
     (req: T, cb: CorsOptionsCallback): void;
 }
+export {};

package/interfaces/http/http-server.interface.d.ts

@@ -35,7 +35,7 @@ export interface HttpServer<TRequest = any, TResponse = any> {
     createMiddlewareFactory(method: RequestMethod): ((path: string, callback: Function) => any) | Promise<(path: string, callback: Function) => any>;
     getRequestHostname?(request: TRequest): string;
     getRequestMethod?(request: TRequest): string;
-    getRequestUrl?(request: TResponse): string;
+    getRequestUrl?(request: TRequest): string;
     getInstance(): any;
     registerParserMiddleware(): any;
     enableCors(options: CorsOptions | CorsOptionsDelegate<TRequest>): any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/common",
-  "version": "7.6.11",
+  "version": "7.6.15",
   "description": "Nest - modern, fast, powerful node.js web framework (@common)",
   "author": "Kamil Mysliwiec",
   "homepage": "https://nestjs.com",

package/pipes/default-value.pipe.d.ts

@@ -1,4 +1,4 @@
-import { ArgumentMetadata, PipeTransform } from '../index';
+import { ArgumentMetadata, PipeTransform } from '../interfaces/features/pipe-transform.interface';
 /**
  * Defines the built-in DefaultValue Pipe
  *

package/pipes/default-value.pipe.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DefaultValuePipe = void 0;
 const tslib_1 = require("tslib");
-const index_1 = require("../index");
+const injectable_decorator_1 = require("../decorators/core/injectable.decorator");
 const shared_utils_1 = require("../utils/shared.utils");
 /**
  * Defines the built-in DefaultValue Pipe
@@ -24,7 +24,7 @@ let DefaultValuePipe = class DefaultValuePipe {
     }
 };
 DefaultValuePipe = tslib_1.__decorate([
-    index_1.Injectable(),
+    injectable_decorator_1.Injectable(),
     tslib_1.__metadata("design:paramtypes", [Object])
 ], DefaultValuePipe);
 exports.DefaultValuePipe = DefaultValuePipe;

package/pipes/parse-array.pipe.d.ts

@@ -1,6 +1,5 @@
-import { ArgumentMetadata } from '../index';
 import { Type } from '../interfaces';
-import { PipeTransform } from '../interfaces/features/pipe-transform.interface';
+import { ArgumentMetadata, PipeTransform } from '../interfaces/features/pipe-transform.interface';
 import { ValidationPipe, ValidationPipeOptions } from './validation.pipe';
 export interface ParseArrayOptions extends Omit<ValidationPipeOptions, 'transform' | 'validateCustomDecorators' | 'exceptionFactory'> {
     items?: Type<unknown>;

package/pipes/parse-array.pipe.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParseArrayPipe = void 0;
 const tslib_1 = require("tslib");
-const index_1 = require("../index");
+const injectable_decorator_1 = require("../decorators/core/injectable.decorator");
+const optional_decorator_1 = require("../decorators/core/optional.decorator");
+const http_status_enum_1 = require("../enums/http-status.enum");
 const http_error_by_code_util_1 = require("../utils/http-error-by-code.util");
 const shared_utils_1 = require("../utils/shared.utils");
 const validation_pipe_1 = require("./validation.pipe");
@@ -19,7 +21,7 @@ let ParseArrayPipe = class ParseArrayPipe {
     constructor(options = {}) {
         this.options = options;
         this.validationPipe = new validation_pipe_1.ValidationPipe(Object.assign({ transform: true, validateCustomDecorators: true }, options));
-        const { exceptionFactory, errorHttpStatusCode = index_1.HttpStatus.BAD_REQUEST, } = options;
+        const { exceptionFactory, errorHttpStatusCode = http_status_enum_1.HttpStatus.BAD_REQUEST, } = options;
         this.exceptionFactory =
             exceptionFactory ||
                 (error => new http_error_by_code_util_1.HttpErrorByCode[errorHttpStatusCode](error));
@@ -104,8 +106,8 @@ let ParseArrayPipe = class ParseArrayPipe {
     }
 };
 ParseArrayPipe = tslib_1.__decorate([
-    index_1.Injectable(),
-    tslib_1.__param(0, index_1.Optional()),
+    injectable_decorator_1.Injectable(),
+    tslib_1.__param(0, optional_decorator_1.Optional()),
     tslib_1.__metadata("design:paramtypes", [Object])
 ], ParseArrayPipe);
 exports.ParseArrayPipe = ParseArrayPipe;

package/pipes/parse-bool.pipe.d.ts

@@ -1,5 +1,4 @@
-import { ArgumentMetadata } from '../index';
-import { PipeTransform } from '../interfaces/features/pipe-transform.interface';
+import { ArgumentMetadata, PipeTransform } from '../interfaces/features/pipe-transform.interface';
 import { ErrorHttpStatusCode } from '../utils/http-error-by-code.util';
 export interface ParseBoolPipeOptions {
     errorHttpStatusCode?: ErrorHttpStatusCode;

package/pipes/parse-bool.pipe.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParseBoolPipe = void 0;
 const tslib_1 = require("tslib");
-const index_1 = require("../index");
+const injectable_decorator_1 = require("../decorators/core/injectable.decorator");
+const optional_decorator_1 = require("../decorators/core/optional.decorator");
+const http_status_enum_1 = require("../enums/http-status.enum");
 const http_error_by_code_util_1 = require("../utils/http-error-by-code.util");
 /**
  * Defines the built-in ParseBool Pipe
@@ -14,7 +16,7 @@ const http_error_by_code_util_1 = require("../utils/http-error-by-code.util");
 let ParseBoolPipe = class ParseBoolPipe {
     constructor(options) {
         options = options || {};
-        const { exceptionFactory, errorHttpStatusCode = index_1.HttpStatus.BAD_REQUEST, } = options;
+        const { exceptionFactory, errorHttpStatusCode = http_status_enum_1.HttpStatus.BAD_REQUEST, } = options;
         this.exceptionFactory =
             exceptionFactory ||
                 (error => new http_error_by_code_util_1.HttpErrorByCode[errorHttpStatusCode](error));
@@ -37,8 +39,8 @@ let ParseBoolPipe = class ParseBoolPipe {
     }
 };
 ParseBoolPipe = tslib_1.__decorate([
-    index_1.Injectable(),
-    tslib_1.__param(0, index_1.Optional()),
+    injectable_decorator_1.Injectable(),
+    tslib_1.__param(0, optional_decorator_1.Optional()),
     tslib_1.__metadata("design:paramtypes", [Object])
 ], ParseBoolPipe);
 exports.ParseBoolPipe = ParseBoolPipe;

package/pipes/parse-int.pipe.d.ts

@@ -1,5 +1,4 @@
-import { ArgumentMetadata } from '../index';
-import { PipeTransform } from '../interfaces/features/pipe-transform.interface';
+import { ArgumentMetadata, PipeTransform } from '../interfaces/features/pipe-transform.interface';
 import { ErrorHttpStatusCode } from '../utils/http-error-by-code.util';
 export interface ParseIntPipeOptions {
     errorHttpStatusCode?: ErrorHttpStatusCode;

package/pipes/parse-int.pipe.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParseIntPipe = void 0;
 const tslib_1 = require("tslib");
-const index_1 = require("../index");
+const injectable_decorator_1 = require("../decorators/core/injectable.decorator");
+const optional_decorator_1 = require("../decorators/core/optional.decorator");
+const http_status_enum_1 = require("../enums/http-status.enum");
 const http_error_by_code_util_1 = require("../utils/http-error-by-code.util");
 /**
  * Defines the built-in ParseInt Pipe
@@ -14,7 +16,7 @@ const http_error_by_code_util_1 = require("../utils/http-error-by-code.util");
 let ParseIntPipe = class ParseIntPipe {
     constructor(options) {
         options = options || {};
-        const { exceptionFactory, errorHttpStatusCode = index_1.HttpStatus.BAD_REQUEST, } = options;
+        const { exceptionFactory, errorHttpStatusCode = http_status_enum_1.HttpStatus.BAD_REQUEST, } = options;
         this.exceptionFactory =
             exceptionFactory ||
                 (error => new http_error_by_code_util_1.HttpErrorByCode[errorHttpStatusCode](error));
@@ -37,8 +39,8 @@ let ParseIntPipe = class ParseIntPipe {
     }
 };
 ParseIntPipe = tslib_1.__decorate([
-    index_1.Injectable(),
-    tslib_1.__param(0, index_1.Optional()),
+    injectable_decorator_1.Injectable(),
+    tslib_1.__param(0, optional_decorator_1.Optional()),
     tslib_1.__metadata("design:paramtypes", [Object])
 ], ParseIntPipe);
 exports.ParseIntPipe = ParseIntPipe;

package/pipes/parse-uuid.pipe.d.ts

@@ -1,5 +1,4 @@
-import { ArgumentMetadata } from '../index';
-import { PipeTransform } from '../interfaces/features/pipe-transform.interface';
+import { ArgumentMetadata, PipeTransform } from '../interfaces/features/pipe-transform.interface';
 import { ErrorHttpStatusCode } from '../utils/http-error-by-code.util';
 export interface ParseUUIDPipeOptions {
     version?: '3' | '4' | '5';

package/pipes/parse-uuid.pipe.js

@@ -2,14 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParseUUIDPipe = void 0;
 const tslib_1 = require("tslib");
-const decorators_1 = require("../decorators");
-const index_1 = require("../index");
+const injectable_decorator_1 = require("../decorators/core/injectable.decorator");
+const optional_decorator_1 = require("../decorators/core/optional.decorator");
+const http_status_enum_1 = require("../enums/http-status.enum");
 const http_error_by_code_util_1 = require("../utils/http-error-by-code.util");
 const is_uuid_1 = require("../utils/is-uuid");
 let ParseUUIDPipe = class ParseUUIDPipe {
     constructor(options) {
         options = options || {};
-        const { exceptionFactory, errorHttpStatusCode = index_1.HttpStatus.BAD_REQUEST, version, } = options;
+        const { exceptionFactory, errorHttpStatusCode = http_status_enum_1.HttpStatus.BAD_REQUEST, version, } = options;
         this.version = version;
         this.exceptionFactory =
             exceptionFactory ||
@@ -23,8 +24,8 @@ let ParseUUIDPipe = class ParseUUIDPipe {
     }
 };
 ParseUUIDPipe = tslib_1.__decorate([
-    index_1.Injectable(),
-    tslib_1.__param(0, decorators_1.Optional()),
+    injectable_decorator_1.Injectable(),
+    tslib_1.__param(0, optional_decorator_1.Optional()),
     tslib_1.__metadata("design:paramtypes", [Object])
 ], ParseUUIDPipe);
 exports.ParseUUIDPipe = ParseUUIDPipe;

package/pipes/validation.pipe.d.ts

@@ -1,7 +1,7 @@
-import { ArgumentMetadata, ValidationError } from '../index';
 import { ClassTransformOptions } from '../interfaces/external/class-transform-options.interface';
+import { ValidationError } from '../interfaces/external/validation-error.interface';
 import { ValidatorOptions } from '../interfaces/external/validator-options.interface';
-import { PipeTransform } from '../interfaces/features/pipe-transform.interface';
+import { ArgumentMetadata, PipeTransform } from '../interfaces/features/pipe-transform.interface';
 import { Type } from '../interfaces/type.interface';
 import { ErrorHttpStatusCode } from '../utils/http-error-by-code.util';
 export interface ValidationPipeOptions extends ValidatorOptions {