@nestjs/common 8.2.0 → 8.2.4

package/Readme.md

@@ -57,10 +57,13 @@ With official support, you can get expert help straight from Nest core team. We
 Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
 
 #### Principal Sponsors
-<table style="text-align:center;"><tr><td>
+<table style="text-align:center;"><tr>
+  <td><a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="200" valign="middle" /></a></td>
+  <td><a href="https://www.redhat.com" target="_blank"><img src="https://nestjs.com/img/red-hat-logo.svg" width="200" valign="middle" /></a></td>
+<td>
 <a href="https://github.com/Sanofi-IADC" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/sanofi.png" width="180" valign="middle" /></a></td>
 <td>
-<a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="200" valign="middle" /></a></td>
+<a href="https://nx.dev" target="_blank"><img src="https://nestjs.com/img/nx-logo.png" height="45" valign="middle" /></a></td>
 </tr></table>
 
 #### Gold Sponsors
@@ -78,7 +81,7 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <table style="text-align:center;"><tr><td>
 <a href="https://neoteric.eu/" target="_blank"><img src="https://nestjs.com/img/neoteric-cut.png" width="120" valign="middle" /></a> </td><td>
   <a href="http://gojob.com" target="_blank"><img src="http://nestjs.com/img/gojob-logo.png" valign="middle" width="100" /></a> </td><td>
-<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></td><td>
+<a href="https://www.myleodsc.com/" target="_blank"><img src="https://nestjs.com/img/myleo-logo.png" width="180" valign="middle" /></td><td>
 <a href="https://careers.meetdandy.com/?gh_src=063ba61e3us" target="_blank"><img src="https://nestjs.com/img/dandy-roles-logo.svg" width="150" valign="middle" /></td><td>
 <a href="https://www.castlecraft.in" target="_blank"><img src="https://nestjs.com/img/castlecraft-logo.png" width="150" valign="middle" /></td>
 <td><a href="https://www.tinystacks.com" target="_blank"><img src="https://nestjs.com/img/tinystacks-logo.png#1" width="140" valign="middle" /></td></tr></table>
@@ -113,6 +116,8 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
   <td align="center" valign="middle"><a href="https://studyclerk.com/pay-for-research-paper" target="_blank"><img src="https://nestjs.com/img/studyclerk-logo.png" width="125" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://xyndata.com" target="_blank"><img src="https://nestjs.com/img/xyndata-logo.png" width="125" valign="middle" /></a></td></tr><tr>
   <td align="center" valign="middle"><a href="https://www.anonymistic.com/" target="_blank"><img src="https://nestjs.com/img/anonymistic-logo.png" width="125" valign="middle" /></a></td>
 <td align="center" valign="middle"><a href="https://www.naologic.com/" target="_blank"><img src="https://nestjs.com/img/naologic-logo.svg" width="125" valign="middle" /></a></td>
+  <td align="center" valign="middle"><a href="https://messaged.com/" target="_blank"><img src="https://nestjs.com/img/messaged-logo.png" width="50" valign="middle" /></a></td>
+  <td align="center" valign="middle"><a href="https://triplecore.io" target="_blank"><img src="https://nestjs.com/img/triplecore-logo.svg" width="50" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers

package/cache/cache.module.d.ts

@@ -15,7 +15,7 @@ export declare class CacheModule {
      *
      * @see [Customize caching](https://docs.nestjs.com/techniques/caching#customize-caching)
      */
-    static register(options?: CacheModuleOptions): DynamicModule;
+    static register<StoreConfig extends Record<any, any> = Record<string, any>>(options?: CacheModuleOptions<StoreConfig>): DynamicModule;
     /**
      * Configure the cache manager dynamically.
      *
@@ -24,7 +24,7 @@ export declare class CacheModule {
      *
      * @see [Async configuration](https://docs.nestjs.com/techniques/caching#async-configuration)
      */
-    static registerAsync(options: CacheModuleAsyncOptions): DynamicModule;
+    static registerAsync<StoreConfig extends Record<any, any> = Record<string, any>>(options: CacheModuleAsyncOptions<StoreConfig>): DynamicModule;
     private static createAsyncProviders;
     private static createAsyncOptionsProvider;
 }

package/cache/interfaces/cache-module.interface.d.ts

@@ -1,12 +1,11 @@
 import { ModuleMetadata, Provider, Type } from '../../interfaces';
 import { CacheManagerOptions } from './cache-manager.interface';
-export interface CacheModuleOptions extends CacheManagerOptions {
+export declare type CacheModuleOptions<StoreConfig extends Record<any, any> = Record<string, any>> = CacheManagerOptions & StoreConfig & {
     /**
      * If "true', register `CacheModule` as a global module.
      */
     isGlobal?: boolean;
-    [key: string]: any;
-}
+};
 /**
  * Interface describing a `CacheOptionsFactory`.  Providers supplying configuration
  * options for the Cache module must implement this interface.
@@ -15,8 +14,8 @@ export interface CacheModuleOptions extends CacheManagerOptions {
  *
  * @publicApi
  */
-export interface CacheOptionsFactory {
-    createCacheOptions(): Promise<CacheModuleOptions> | CacheModuleOptions;
+export interface CacheOptionsFactory<StoreConfig extends Record<any, any> = Record<string, any>> {
+    createCacheOptions(): Promise<CacheModuleOptions<StoreConfig>> | CacheModuleOptions<StoreConfig>;
 }
 /**
  * Options for dynamically configuring the Cache module.
@@ -25,22 +24,22 @@ export interface CacheOptionsFactory {
  *
  * @publicApi
  */
-export interface CacheModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+export interface CacheModuleAsyncOptions<StoreConfig extends Record<any, any> = Record<string, any>> extends Pick<ModuleMetadata, 'imports'> {
     /**
      * Injection token resolving to an existing provider. The provider must implement
      * the `CacheOptionsFactory` interface.
      */
-    useExisting?: Type<CacheOptionsFactory>;
+    useExisting?: Type<CacheOptionsFactory<StoreConfig>>;
     /**
      * Injection token resolving to a class that will be instantiated as a provider.
      * The class must implement the `CacheOptionsFactory` interface.
      */
-    useClass?: Type<CacheOptionsFactory>;
+    useClass?: Type<CacheOptionsFactory<StoreConfig>>;
     /**
      * Function returning options (or a Promise resolving to options) to configure the
      * cache module.
      */
-    useFactory?: (...args: any[]) => Promise<CacheModuleOptions> | CacheModuleOptions;
+    useFactory?: (...args: any[]) => Promise<CacheModuleOptions<StoreConfig>> | CacheModuleOptions<StoreConfig>;
     /**
      * Dependencies that a Factory may inject.
      */

package/constants.d.ts

@@ -29,3 +29,6 @@ export declare const REDIRECT_METADATA = "__redirect__";
 export declare const RESPONSE_PASSTHROUGH_METADATA = "__responsePassthrough__";
 export declare const SSE_METADATA = "__sse__";
 export declare const VERSION_METADATA = "__version__";
+export declare const INJECTABLE_WATERMARK = "__injectable__";
+export declare const CONTROLLER_WATERMARK = "__controller__";
+export declare const CATCH_WATERMARK = "__catch__";

package/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION_METADATA = exports.SSE_METADATA = exports.RESPONSE_PASSTHROUGH_METADATA = exports.REDIRECT_METADATA = exports.HEADERS_METADATA = exports.MODULE_PATH = exports.HTTP_CODE_METADATA = exports.INTERCEPTORS_METADATA = exports.RENDER_METADATA = exports.GUARDS_METADATA = exports.PIPES_METADATA = exports.FILTER_CATCH_EXCEPTIONS = exports.EXCEPTION_FILTERS_METADATA = exports.CUSTOM_ROUTE_AGRS_METADATA = exports.ROUTE_ARGS_METADATA = exports.METHOD_METADATA = exports.SCOPE_OPTIONS_METADATA = exports.OPTIONAL_PROPERTY_DEPS_METADATA = exports.PROPERTY_DEPS_METADATA = exports.OPTIONAL_DEPS_METADATA = exports.SELF_DECLARED_DEPS_METADATA = exports.PARAMTYPES_METADATA = exports.PATH_METADATA = exports.HOST_METADATA = exports.GLOBAL_MODULE_METADATA = exports.MODULE_METADATA = void 0;
+exports.CATCH_WATERMARK = exports.CONTROLLER_WATERMARK = exports.INJECTABLE_WATERMARK = exports.VERSION_METADATA = exports.SSE_METADATA = exports.RESPONSE_PASSTHROUGH_METADATA = exports.REDIRECT_METADATA = exports.HEADERS_METADATA = exports.MODULE_PATH = exports.HTTP_CODE_METADATA = exports.INTERCEPTORS_METADATA = exports.RENDER_METADATA = exports.GUARDS_METADATA = exports.PIPES_METADATA = exports.FILTER_CATCH_EXCEPTIONS = exports.EXCEPTION_FILTERS_METADATA = exports.CUSTOM_ROUTE_AGRS_METADATA = exports.ROUTE_ARGS_METADATA = exports.METHOD_METADATA = exports.SCOPE_OPTIONS_METADATA = exports.OPTIONAL_PROPERTY_DEPS_METADATA = exports.PROPERTY_DEPS_METADATA = exports.OPTIONAL_DEPS_METADATA = exports.SELF_DECLARED_DEPS_METADATA = exports.PARAMTYPES_METADATA = exports.PATH_METADATA = exports.HOST_METADATA = exports.GLOBAL_MODULE_METADATA = exports.MODULE_METADATA = void 0;
 exports.MODULE_METADATA = {
     IMPORTS: 'imports',
     PROVIDERS: 'providers',
@@ -32,3 +32,6 @@ exports.REDIRECT_METADATA = '__redirect__';
 exports.RESPONSE_PASSTHROUGH_METADATA = '__responsePassthrough__';
 exports.SSE_METADATA = '__sse__';
 exports.VERSION_METADATA = '__version__';
+exports.INJECTABLE_WATERMARK = '__injectable__';
+exports.CONTROLLER_WATERMARK = '__controller__';
+exports.CATCH_WATERMARK = '__catch__';

package/decorators/core/catch.decorator.js

@@ -21,6 +21,7 @@ const constants_1 = require("../../constants");
  */
 function Catch(...exceptions) {
     return (target) => {
+        Reflect.defineMetadata(constants_1.CATCH_WATERMARK, true, target);
         Reflect.defineMetadata(constants_1.FILTER_CATCH_EXCEPTIONS, exceptions, target);
     };
 }

package/decorators/core/controller.decorator.js

@@ -47,9 +47,12 @@ function Controller(prefixOrOptions) {
                 prefixOrOptions.path || defaultPath,
                 prefixOrOptions.host,
                 { scope: prefixOrOptions.scope },
-                prefixOrOptions.version,
+                Array.isArray(prefixOrOptions.version)
+                    ? Array.from(new Set(prefixOrOptions.version))
+                    : prefixOrOptions.version,
             ];
     return (target) => {
+        Reflect.defineMetadata(constants_1.CONTROLLER_WATERMARK, true, target);
         Reflect.defineMetadata(constants_1.PATH_METADATA, path, target);
         Reflect.defineMetadata(constants_1.HOST_METADATA, host, target);
         Reflect.defineMetadata(constants_1.SCOPE_OPTIONS_METADATA, scopeOptions, target);

package/decorators/core/injectable.decorator.js

@@ -33,6 +33,7 @@ const constants_1 = require("../../constants");
  */
 function Injectable(options) {
     return (target) => {
+        Reflect.defineMetadata(constants_1.INJECTABLE_WATERMARK, true, target);
         Reflect.defineMetadata(constants_1.SCOPE_OPTIONS_METADATA, options, target);
     };
 }

package/decorators/core/version.decorator.js

@@ -8,6 +8,10 @@ const constants_1 = require("../../constants");
  * @publicApi
  */
 function Version(version) {
+    if (Array.isArray(version)) {
+        // Drop duplicated versions
+        version = Array.from(new Set(version));
+    }
     return (target, key, descriptor) => {
         Reflect.defineMetadata(constants_1.VERSION_METADATA, version, descriptor.value);
         return descriptor;

package/file-stream/streamable-file.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StreamableFile = void 0;
 const stream_1 = require("stream");
+const shared_utils_1 = require("../utils/shared.utils");
 class StreamableFile {
     constructor(bufferOrReadStream, options = {}) {
         this.options = options;
@@ -10,8 +11,7 @@ class StreamableFile {
             this.stream.push(bufferOrReadStream);
             this.stream.push(null);
         }
-        else if (bufferOrReadStream.pipe &&
-            typeof bufferOrReadStream.pipe === 'function') {
+        else if (bufferOrReadStream.pipe && shared_utils_1.isFunction(bufferOrReadStream.pipe)) {
             this.stream = bufferOrReadStream;
         }
     }

package/interfaces/nest-application-context.interface.d.ts

@@ -1,6 +1,5 @@
 import { ShutdownSignal } from '../enums/shutdown-signal.enum';
 import { LoggerService, LogLevel } from '../services/logger.service';
-import { Abstract } from './abstract.interface';
 import { DynamicModule } from './modules';
 import { Type } from './type.interface';
 /**
@@ -18,14 +17,14 @@ export interface INestApplicationContext {
      * Retrieves an instance of either injectable or controller, otherwise, throws exception.
      * @returns {TResult}
      */
-    get<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Abstract<TInput> | string | symbol, options?: {
+    get<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Function | string | symbol, options?: {
         strict: boolean;
     }): TResult;
     /**
      * Resolves transient or request-scoped instance of either injectable or controller, otherwise, throws exception.
      * @returns {Promise<TResult>}
      */
-    resolve<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Abstract<TInput> | string | symbol, contextId?: {
+    resolve<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Function | string | symbol, contextId?: {
         id: number;
     }, options?: {
         strict: boolean;
@@ -43,7 +42,8 @@ export interface INestApplicationContext {
      */
     close(): Promise<void>;
     /**
-     * Sets custom logger service
+     * Sets custom logger service.
+     * Flushes buffered logs if auto flush is on.
      * @returns {void}
      */
     useLogger(logger: LoggerService | LogLevel[] | false): void;

package/interfaces/version-options.interface.d.ts

@@ -5,7 +5,7 @@ import { VersioningType } from '../enums/version-type.enum';
  * @publicApi
  */
 export declare const VERSION_NEUTRAL: unique symbol;
-export declare type VersionValue = string | string[] | typeof VERSION_NEUTRAL;
+export declare type VersionValue = string | typeof VERSION_NEUTRAL | Array<string | typeof VERSION_NEUTRAL>;
 /**
  * @publicApi
  */

package/package.json

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

package/pipes/parse-array.pipe.js

@@ -115,18 +115,18 @@ let ParseArrayPipe = class ParseArrayPipe {
         if (this.options.items === Number) {
             const value = originalValue !== null && originalValue !== '' ? +originalValue : NaN;
             if (isNaN(value)) {
-                throw this.exceptionFactory(`${typeof index !== 'undefined' ? `[${index}] ` : ''}item must be a number`);
+                throw this.exceptionFactory(`${shared_utils_1.isUndefined(index) ? '' : `[${index}] `}item must be a number`);
             }
             return value;
         }
         else if (this.options.items === String) {
-            if (typeof originalValue !== 'string') {
+            if (!shared_utils_1.isString(originalValue)) {
                 return `${originalValue}`;
             }
         }
         else if (this.options.items === Boolean) {
             if (typeof originalValue !== 'boolean') {
-                throw this.exceptionFactory(`${typeof index !== 'undefined' ? `[${index}] ` : ''}item must be a boolean value`);
+                throw this.exceptionFactory(`${shared_utils_1.isUndefined(index) ? '' : `[${index}] `}item must be a boolean value`);
             }
         }
         return originalValue;

package/pipes/parse-enum.pipe.js

@@ -38,7 +38,7 @@ let ParseEnumPipe = class ParseEnumPipe {
     }
     isEnum(value) {
         const enumValues = Object.keys(this.enumType).map(item => this.enumType[item]);
-        return enumValues.indexOf(value) >= 0;
+        return enumValues.includes(value);
     }
 };
 ParseEnumPipe = tslib_1.__decorate([

package/pipes/validation.pipe.js

@@ -121,7 +121,7 @@ let ValidationPipe = class ValidationPipe {
         delete value.__proto__;
         const keys = Object.keys(value);
         iterare_1.iterate(keys)
-            .filter(key => typeof value[key] === 'object' && value[key])
+            .filter(key => shared_utils_1.isObject(value[key]) && value[key])
             .forEach(key => this.stripProtoKeys(value[key]));
     }
     isPrimitive(value) {

package/services/console-logger.service.js

@@ -147,7 +147,7 @@ let ConsoleLogger = ConsoleLogger_1 = class ConsoleLogger {
             return { messages: args, context: this.context };
         }
         const lastElement = args[args.length - 1];
-        const isContext = typeof lastElement === 'string';
+        const isContext = shared_utils_1.isString(lastElement);
         if (!isContext) {
             return { messages: args, context: this.context };
         }
@@ -162,7 +162,7 @@ let ConsoleLogger = ConsoleLogger_1 = class ConsoleLogger {
             return { messages, context };
         }
         const lastElement = messages[messages.length - 1];
-        const isStack = typeof lastElement === 'string';
+        const isStack = shared_utils_1.isString(lastElement);
         if (!isStack) {
             return { messages, context };
         }

package/utils/is-uuid.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isUUID = void 0;
 const exceptions_1 = require("../exceptions");
+const shared_utils_1 = require("./shared.utils");
 const uuid = {
     3: /^[0-9A-F]{8}-[0-9A-F]{4}-3[0-9A-F]{3}-[0-9A-F]{4}-[0-9A-F]{12}$/i,
     4: /^[0-9A-F]{8}-[0-9A-F]{4}-4[0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i,
@@ -9,7 +10,7 @@ const uuid = {
     all: /^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$/i,
 };
 function isUUID(str, version = 'all') {
-    if (typeof str !== 'string') {
+    if (!shared_utils_1.isString(str)) {
         throw new exceptions_1.BadRequestException('The value passed as UUID is not a string');
     }
     const pattern = uuid[version];