@nestjs/common 9.1.5 → 9.2.0

package/exceptions/unprocessable-entity.exception.js

@@ -20,7 +20,7 @@ class UnprocessableEntityException extends http_exception_1.HttpException {
      * @usageNotes
      * The HTTP response status code will be 422.
      * - The `objectOrError` argument defines the JSON response body or the message string.
-     * - The `description` argument contains a short description of the HTTP error.
+     * - The `descriptionOrOptions` argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
      *
      * By default, the JSON response body contains two properties:
      * - `statusCode`: this will be the value 422.
@@ -33,10 +33,11 @@ class UnprocessableEntityException extends http_exception_1.HttpException {
      * and return it as the JSON response body.
      *
      * @param objectOrError string or object describing the error condition.
-     * @param description a short description of the HTTP error.
+     * @param descriptionOrOptions either a short description of the HTTP error or an options object used to provide an underlying error cause
      */
-    constructor(objectOrError, description = 'Unprocessable Entity') {
-        super(http_exception_1.HttpException.createBody(objectOrError, description, http_status_enum_1.HttpStatus.UNPROCESSABLE_ENTITY), http_status_enum_1.HttpStatus.UNPROCESSABLE_ENTITY);
+    constructor(objectOrError, descriptionOrOptions = 'Unprocessable Entity') {
+        const { description, httpExceptionOptions } = http_exception_1.HttpException.extractDescriptionAndOptionsFrom(descriptionOrOptions);
+        super(http_exception_1.HttpException.createBody(objectOrError, description, http_status_enum_1.HttpStatus.UNPROCESSABLE_ENTITY), http_status_enum_1.HttpStatus.UNPROCESSABLE_ENTITY, httpExceptionOptions);
     }
 }
 exports.UnprocessableEntityException = UnprocessableEntityException;

package/exceptions/unsupported-media-type.exception.d.ts

@@ -1,4 +1,4 @@
-import { HttpException } from './http.exception';
+import { HttpException, HttpExceptionOptions } from './http.exception';
 /**
  * Defines an HTTP exception for *Unsupported Media Type* type errors.
  *
@@ -16,7 +16,7 @@ export declare class UnsupportedMediaTypeException extends HttpException {
      * @usageNotes
      * The HTTP response status code will be 415.
      * - The `objectOrError` argument defines the JSON response body or the message string.
-     * - The `description` argument contains a short description of the HTTP error.
+     * - The `descriptionOrOptions` argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
      *
      * By default, the JSON response body contains two properties:
      * - `statusCode`: this will be the value 415.
@@ -29,7 +29,7 @@ export declare class UnsupportedMediaTypeException extends HttpException {
      * and return it as the JSON response body.
      *
      * @param objectOrError string or object describing the error condition.
-     * @param description a short description of the HTTP error.
+     * @param descriptionOrOptions either a short description of the HTTP error or an options object used to provide an underlying error cause
      */
-    constructor(objectOrError?: string | object | any, description?: string);
+    constructor(objectOrError?: string | object | any, descriptionOrOptions?: string | HttpExceptionOptions);
 }

package/exceptions/unsupported-media-type.exception.js

@@ -20,7 +20,7 @@ class UnsupportedMediaTypeException extends http_exception_1.HttpException {
      * @usageNotes
      * The HTTP response status code will be 415.
      * - The `objectOrError` argument defines the JSON response body or the message string.
-     * - The `description` argument contains a short description of the HTTP error.
+     * - The `descriptionOrOptions` argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
      *
      * By default, the JSON response body contains two properties:
      * - `statusCode`: this will be the value 415.
@@ -33,10 +33,11 @@ class UnsupportedMediaTypeException extends http_exception_1.HttpException {
      * and return it as the JSON response body.
      *
      * @param objectOrError string or object describing the error condition.
-     * @param description a short description of the HTTP error.
+     * @param descriptionOrOptions either a short description of the HTTP error or an options object used to provide an underlying error cause
      */
-    constructor(objectOrError, description = 'Unsupported Media Type') {
-        super(http_exception_1.HttpException.createBody(objectOrError, description, http_status_enum_1.HttpStatus.UNSUPPORTED_MEDIA_TYPE), http_status_enum_1.HttpStatus.UNSUPPORTED_MEDIA_TYPE);
+    constructor(objectOrError, descriptionOrOptions = 'Unsupported Media Type') {
+        const { description, httpExceptionOptions } = http_exception_1.HttpException.extractDescriptionAndOptionsFrom(descriptionOrOptions);
+        super(http_exception_1.HttpException.createBody(objectOrError, description, http_status_enum_1.HttpStatus.UNSUPPORTED_MEDIA_TYPE), http_status_enum_1.HttpStatus.UNSUPPORTED_MEDIA_TYPE, httpExceptionOptions);
     }
 }
 exports.UnsupportedMediaTypeException = UnsupportedMediaTypeException;

package/interfaces/middleware/middleware-configuration.interface.d.ts

@@ -1,8 +1,10 @@
 import { RequestMethod } from '../../enums';
 import { Type } from '../type.interface';
+import { VersionValue } from '../version-options.interface';
 export interface RouteInfo {
     path: string;
     method: RequestMethod;
+    version?: VersionValue;
 }
 export interface MiddlewareConfiguration<T = any> {
     middleware: T;

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

@@ -2,6 +2,19 @@ import { ShutdownSignal } from '../enums/shutdown-signal.enum';
 import { LoggerService, LogLevel } from '../services/logger.service';
 import { DynamicModule } from './modules';
 import { Type } from './type.interface';
+export interface GetOrResolveOptions {
+    /**
+     * If enabled, lookup will only be performed in the host module.
+     * @default false
+     */
+    strict?: boolean;
+    /**
+     * If enabled, instead of returning a first instance registered under a given token,
+     * a list of instances will be returned.
+     * @default false
+     */
+    each?: boolean;
+}
 /**
  * Interface defining NestApplicationContext.
  *
@@ -17,18 +30,67 @@ export interface INestApplicationContext {
      * Retrieves an instance of either injectable or controller, otherwise, throws exception.
      * @returns {TResult}
      */
-    get<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Function | string | symbol, options?: {
-        strict: boolean;
+    get<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Function | string | symbol): TResult;
+    /**
+     * Retrieves an instance of either injectable or controller, otherwise, throws exception.
+     * @returns {TResult}
+     */
+    get<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Function | string | symbol, options: {
+        strict?: boolean;
+        each?: undefined | false;
     }): TResult;
+    /**
+     * Retrieves a list of instances of either injectables or controllers, otherwise, throws exception.
+     * @returns {Array<TResult>}
+     */
+    get<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Function | string | symbol, options: {
+        strict?: boolean;
+        each: true;
+    }): Array<TResult>;
+    /**
+     * Retrieves an instance (or a list of instances) of either injectable or controller, otherwise, throws exception.
+     * @returns {TResult | Array<TResult>}
+     */
+    get<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Function | string | symbol, options?: GetOrResolveOptions): TResult | Array<TResult>;
+    /**
+     * Resolves transient or request-scoped instance of either injectable or controller, otherwise, throws exception.
+     * @returns {Array<TResult>}
+     */
+    resolve<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Function | string | symbol): Promise<TResult>;
     /**
      * Resolves transient or request-scoped instance of either injectable or controller, otherwise, throws exception.
-     * @returns {Promise<TResult>}
+     * @returns {Array<TResult>}
+     */
+    resolve<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Function | string | symbol, contextId?: {
+        id: number;
+    }): Promise<TResult>;
+    /**
+     * Resolves transient or request-scoped instance of either injectable or controller, otherwise, throws exception.
+     * @returns {Array<TResult>}
      */
     resolve<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Function | string | symbol, contextId?: {
         id: number;
     }, options?: {
-        strict: boolean;
+        strict?: boolean;
+        each?: undefined | false;
     }): Promise<TResult>;
+    /**
+     * Resolves transient or request-scoped instances of either injectables or controllers, otherwise, throws exception.
+     * @returns {Array<TResult>}
+     */
+    resolve<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Function | string | symbol, contextId?: {
+        id: number;
+    }, options?: {
+        strict?: boolean;
+        each: true;
+    }): Promise<Array<TResult>>;
+    /**
+     * Resolves transient or request-scoped instance (or a list of instances) of either injectable or controller, otherwise, throws exception.
+     * @returns {Promise<TResult | Array<TResult>>}
+     */
+    resolve<TInput = any, TResult = TInput>(typeOrToken: Type<TInput> | Function | string | symbol, contextId?: {
+        id: number;
+    }, options?: GetOrResolveOptions): Promise<TResult | Array<TResult>>;
     /**
      * Registers the request/context object for a given context ID (DI container sub-tree).
      * @returns {void}

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

@@ -21,4 +21,9 @@ export interface NestApplicationOptions extends NestApplicationContextOptions {
      * Whether to register the raw request body on the request. Use `req.rawBody`.
      */
     rawBody?: boolean;
+    /**
+     * Force close open HTTP connections. Useful if restarting your application hangs due to
+     * keep-alive connections in the HTTP adapter.
+     */
+    forceCloseConnections?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/common",
-  "version": "9.1.5",
+  "version": "9.2.0",
   "description": "Nest - modern, fast, powerful node.js web framework (@common)",
   "author": "Kamil Mysliwiec",
   "homepage": "https://nestjs.com",
@@ -18,7 +18,7 @@
   "license": "MIT",
   "dependencies": {
     "iterare": "1.2.1",
-    "tslib": "2.4.0",
+    "tslib": "2.4.1",
     "uuid": "9.0.0"
   },
   "peerDependencies": {

package/pipes/file/parse-file-pipe.builder.d.ts

@@ -1,4 +1,5 @@
 import { FileTypeValidatorOptions } from './file-type.validator';
+import { FileValidator } from './file-validator.interface';
 import { MaxFileSizeValidatorOptions } from './max-file-size.validator';
 import { ParseFileOptions } from './parse-file-options.interface';
 import { ParseFilePipe } from './parse-file.pipe';
@@ -6,5 +7,6 @@ export declare class ParseFilePipeBuilder {
     private validators;
     addMaxSizeValidator(options: MaxFileSizeValidatorOptions): this;
     addFileTypeValidator(options: FileTypeValidatorOptions): this;
+    addValidator(validator: FileValidator): this;
     build(additionalOptions?: Omit<ParseFileOptions, 'validators'>): ParseFilePipe;
 }

package/pipes/file/parse-file-pipe.builder.js

@@ -9,11 +9,13 @@ class ParseFilePipeBuilder {
         this.validators = [];
     }
     addMaxSizeValidator(options) {
-        this.validators.push(new max_file_size_validator_1.MaxFileSizeValidator(options));
-        return this;
+        return this.addValidator(new max_file_size_validator_1.MaxFileSizeValidator(options));
     }
     addFileTypeValidator(options) {
-        this.validators.push(new file_type_validator_1.FileTypeValidator(options));
+        return this.addValidator(new file_type_validator_1.FileTypeValidator(options));
+    }
+    addValidator(validator) {
+        this.validators.push(validator);
         return this;
     }
     build(additionalOptions) {

package/services/console-logger.service.d.ts

@@ -65,11 +65,13 @@ export declare class ConsoleLogger implements LoggerService {
     protected getTimestamp(): string;
     protected printMessages(messages: unknown[], context?: string, logLevel?: LogLevel, writeStreamType?: 'stdout' | 'stderr'): void;
     protected formatPid(pid: number): string;
+    protected formatContext(context: string): string;
     protected formatMessage(logLevel: LogLevel, message: unknown, pidMessage: string, formattedLogLevel: string, contextMessage: string, timestampDiff: string): string;
     protected stringifyMessage(message: unknown, logLevel: LogLevel): string;
     protected colorize(message: string, logLevel: LogLevel): string;
     protected printStackTrace(stack: string): void;
     private updateAndGetTimestampDiff;
+    protected formatTimestampDiff(timestampDiff: number): string;
     private getContextAndMessagesToPrint;
     private getContextAndStackAndMessagesToPrint;
     private getColorByLogLevel;

package/services/console-logger.service.js

@@ -3,8 +3,7 @@ var ConsoleLogger_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConsoleLogger = void 0;
 const tslib_1 = require("tslib");
-const injectable_decorator_1 = require("../decorators/core/injectable.decorator");
-const optional_decorator_1 = require("../decorators/core/optional.decorator");
+const core_1 = require("../decorators/core");
 const cli_colors_util_1 = require("../utils/cli-colors.util");
 const shared_utils_1 = require("../utils/shared.utils");
 const utils_1 = require("./utils");
@@ -116,7 +115,7 @@ let ConsoleLogger = ConsoleLogger_1 = class ConsoleLogger {
     printMessages(messages, context = '', logLevel = 'log', writeStreamType) {
         messages.forEach(message => {
             const pidMessage = this.formatPid(process.pid);
-            const contextMessage = context ? (0, cli_colors_util_1.yellow)(`[${context}] `) : '';
+            const contextMessage = this.formatContext(context);
             const timestampDiff = this.updateAndGetTimestampDiff();
             const formattedLogLevel = logLevel.toUpperCase().padStart(7, ' ');
             const formattedMessage = this.formatMessage(logLevel, message, pidMessage, formattedLogLevel, contextMessage, timestampDiff);
@@ -126,6 +125,9 @@ let ConsoleLogger = ConsoleLogger_1 = class ConsoleLogger {
     formatPid(pid) {
         return `[Nest] ${pid}  - `;
     }
+    formatContext(context) {
+        return context ? (0, cli_colors_util_1.yellow)(`[${context}] `) : '';
+    }
     formatMessage(logLevel, message, pidMessage, formattedLogLevel, contextMessage, timestampDiff) {
         const output = this.stringifyMessage(message, logLevel);
         pidMessage = this.colorize(pidMessage, logLevel);
@@ -151,11 +153,14 @@ let ConsoleLogger = ConsoleLogger_1 = class ConsoleLogger {
         var _a;
         const includeTimestamp = ConsoleLogger_1.lastTimestampAt && ((_a = this.options) === null || _a === void 0 ? void 0 : _a.timestamp);
         const result = includeTimestamp
-            ? (0, cli_colors_util_1.yellow)(` +${Date.now() - ConsoleLogger_1.lastTimestampAt}ms`)
+            ? this.formatTimestampDiff(Date.now() - ConsoleLogger_1.lastTimestampAt)
             : '';
         ConsoleLogger_1.lastTimestampAt = Date.now();
         return result;
     }
+    formatTimestampDiff(timestampDiff) {
+        return (0, cli_colors_util_1.yellow)(` +${timestampDiff}ms`);
+    }
     getContextAndMessagesToPrint(args) {
         if ((args === null || args === void 0 ? void 0 : args.length) <= 1) {
             return { messages: args, context: this.context };
@@ -202,9 +207,9 @@ let ConsoleLogger = ConsoleLogger_1 = class ConsoleLogger {
     }
 };
 ConsoleLogger = ConsoleLogger_1 = tslib_1.__decorate([
-    (0, injectable_decorator_1.Injectable)(),
-    tslib_1.__param(0, (0, optional_decorator_1.Optional)()),
-    tslib_1.__param(1, (0, optional_decorator_1.Optional)()),
+    (0, core_1.Injectable)(),
+    tslib_1.__param(0, (0, core_1.Optional)()),
+    tslib_1.__param(1, (0, core_1.Optional)()),
     tslib_1.__metadata("design:paramtypes", [String, Object])
 ], ConsoleLogger);
 exports.ConsoleLogger = ConsoleLogger;