@nestjs/common 10.1.2 → 10.2.0

package/Readme.md

@@ -23,7 +23,7 @@
 
 ## Description
 
-Nest is a framework for building efficient, scalable <a href="https://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with  <a href="https://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
+Nest is a framework for building efficient, scalable <a href="https://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with <a href="https://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
 
 <p>Under the hood, Nest makes use of <a href="https://expressjs.com/" target="_blank">Express</a>, but also, provides compatibility with a wide range of other libraries, like e.g. <a href="https://github.com/fastify/fastify" target="_blank">Fastify</a>, allowing for easy use of the myriad third-party plugins which are available.</p>
 
@@ -34,10 +34,10 @@ Nest is a framework for building efficient, scalable <a href="https://nodejs.org
 
 ## Getting started
 
-* 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:
-* [ガイド](readme_jp.md)は [docs.nestjs.com](https://docs.nestjs.com)でご確認ください。 :books:
+- 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:
+- [ガイド](readme_jp.md)は [docs.nestjs.com](https://docs.nestjs.com)でご確認ください。 :books:
 
 ## Questions
 
@@ -56,10 +56,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 from 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><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://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="170" valign="middle" /></a></td>
+<td>
+<a href="https://amplication.com/" target="_blank"><img src="https://nestjs.com/img/amplication-logo.svg" width="190" valign="middle" /></a></td>
 </tr></table>
 
 #### Gold Sponsors
@@ -69,8 +72,7 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <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://nx.dev" target="_blank"><img src="https://nestjs.com/img/nx-logo.png" height="45" valign="middle" /></a></td><td>
-  <a href="https://amplication.com/" target="_blank"><img src="https://nestjs.com/img/amplication-logo.svg" width="190" 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>
   <td>
 <a href="https://weld.app/" target="_blank"><img src="https://nestjs.com/img/weld-logo.svg" width="140" valign="middle" /></a></td>
 <td>
@@ -86,7 +88,8 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 #### Silver Sponsors
 
 <table style="text-align:center;"><tr>
-<td><a href="https://n.inc" target="_blank"><img src="https://nestjs.com/img/n-inc-logo.svg" width="120" valign="middle" /></td></tr>
+<td><a href="https://n.inc" target="_blank"><img src="https://nestjs.com/img/n-inc-logo.svg" width="120" valign="middle" /></td>
+<td><a href="https://twistag.com/" target="_blank"><img src="https://nestjs.com/img/twistag-logo.png" width="120" valign="middle" /></td></tr>
 </table>
 
 #### Sponsors
@@ -111,6 +114,8 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
  <td align="center" valign="middle"><a href="https://nordbot.app/" target="_blank"><img src="https://nestjs.com/img/nordbot-logo.png" width="120" valign="middle" /></a></td></tr><tr>
  <td align="center" valign="middle"><a href="https://doppio.sh/" target="_blank"><img src="https://nestjs.com/img/dopiosh-logo.png" width="50" valign="middle" /></a></td>
    <td align="center" valign="middle"><a href="https://www.hingehealth.com/" target="_blank"><img src="https://nestjs.com/img/hinge-health-logo.svg" width="100" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://julienferand.dev/" target="_blank"><img src="https://nestjs.com/img/julienferand-logo.jpeg" width="65" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://www.tripoffice.com/" target="_blank"><img src="https://nestjs.com/img/tripoffice-logo.png" width="140" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers
@@ -119,9 +124,9 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 
 ## Stay in touch
 
-* Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec)
-* Website - [https://nestjs.com](https://nestjs.com/)
-* Twitter - [@nestframework](https://twitter.com/nestframework)
+- Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec)
+- Website - [https://nestjs.com](https://nestjs.com/)
+- Twitter - [@nestframework](https://twitter.com/nestframework)
 
 ## License
 

package/package.json

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

package/pipes/file/file-validator.interface.d.ts

@@ -12,7 +12,7 @@ export declare abstract class FileValidator<TValidationOptions = Record<string,
      * Indicates if this file should be considered valid, according to the options passed in the constructor.
      * @param file the file from the request object
      */
-    abstract isValid(file?: TFile): boolean | Promise<boolean>;
+    abstract isValid(file?: TFile | TFile[] | Record<string, TFile[]>): boolean | Promise<boolean>;
     /**
      * Builds an error message in case the validation fails.
      * @param file the file from the request object

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

@@ -48,6 +48,12 @@ export declare class ConsoleLogger implements LoggerService {
      */
     verbose(message: any, context?: string): void;
     verbose(message: any, ...optionalParams: [...any, string?]): void;
+    /**
+     * Write a 'fatal' level log, if the configured level allows for it.
+     * Prints to `stdout` with newline.
+     */
+    fatal(message: any, context?: string): void;
+    fatal(message: any, ...optionalParams: [...any, string?]): void;
     /**
      * Set log levels
      * @param levels log levels

package/services/console-logger.service.js

@@ -13,6 +13,7 @@ const DEFAULT_LOG_LEVELS = [
     'warn',
     'debug',
     'verbose',
+    'fatal',
 ];
 const dateTimeFormatter = new Intl.DateTimeFormat(undefined, {
     year: 'numeric',
@@ -81,6 +82,16 @@ let ConsoleLogger = exports.ConsoleLogger = ConsoleLogger_1 = class ConsoleLogge
         ]);
         this.printMessages(messages, context, 'verbose');
     }
+    fatal(message, ...optionalParams) {
+        if (!this.isLevelEnabled('fatal')) {
+            return;
+        }
+        const { messages, context } = this.getContextAndMessagesToPrint([
+            message,
+            ...optionalParams,
+        ]);
+        this.printMessages(messages, context, 'fatal');
+    }
     /**
      * Set log levels
      * @param levels log levels
@@ -221,6 +232,8 @@ let ConsoleLogger = exports.ConsoleLogger = ConsoleLogger_1 = class ConsoleLogge
                 return cli_colors_util_1.clc.red;
             case 'verbose':
                 return cli_colors_util_1.clc.cyanBright;
+            case 'fatal':
+                return cli_colors_util_1.clc.bold;
             default:
                 return cli_colors_util_1.clc.green;
         }

package/services/logger.service.d.ts

@@ -1,7 +1,7 @@
 /**
  * @publicApi
  */
-export type LogLevel = 'log' | 'error' | 'warn' | 'debug' | 'verbose';
+export type LogLevel = 'log' | 'error' | 'warn' | 'debug' | 'verbose' | 'fatal';
 /**
  * @publicApi
  */
@@ -26,6 +26,10 @@ export interface LoggerService {
      * Write a 'verbose' level log.
      */
     verbose?(message: any, ...optionalParams: any[]): any;
+    /**
+     * Write a 'fatal' level log.
+     */
+    fatal?(message: any, ...optionalParams: any[]): any;
     /**
      * Set log levels.
      * @param levels log levels
@@ -87,6 +91,11 @@ export declare class Logger implements LoggerService {
      */
     verbose(message: any, context?: string): void;
     verbose(message: any, ...optionalParams: [...any, string?]): void;
+    /**
+     * Write a 'fatal' level log.
+     */
+    fatal(message: any, context?: string): void;
+    fatal(message: any, ...optionalParams: [...any, string?]): void;
     /**
      * Write an 'error' level log.
      */
@@ -115,6 +124,11 @@ export declare class Logger implements LoggerService {
      */
     static verbose(message: any, context?: string): void;
     static verbose(message: any, ...optionalParams: [...any, string?]): void;
+    /**
+     * Write a 'fatal' level log.
+     */
+    static fatal(message: any, context?: string): void;
+    static fatal(message: any, ...optionalParams: [...any, string?]): void;
     /**
      * Print buffered logs and detach buffer.
      */

package/services/logger.service.js

@@ -66,6 +66,12 @@ let Logger = exports.Logger = Logger_1 = class Logger {
             : optionalParams;
         this.localInstance?.verbose?.(message, ...optionalParams);
     }
+    fatal(message, ...optionalParams) {
+        optionalParams = this.context
+            ? optionalParams.concat(this.context)
+            : optionalParams;
+        this.localInstance?.fatal?.(message, ...optionalParams);
+    }
     static error(message, ...optionalParams) {
         this.staticInstanceRef?.error(message, ...optionalParams);
     }
@@ -81,6 +87,9 @@ let Logger = exports.Logger = Logger_1 = class Logger {
     static verbose(message, ...optionalParams) {
         this.staticInstanceRef?.verbose?.(message, ...optionalParams);
     }
+    static fatal(message, ...optionalParams) {
+        this.staticInstanceRef?.fatal?.(message, ...optionalParams);
+    }
     /**
      * Print buffered logs and detach buffer.
      */
@@ -183,6 +192,12 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", [Object, Object]),
     tslib_1.__metadata("design:returntype", void 0)
 ], Logger.prototype, "verbose", null);
+tslib_1.__decorate([
+    Logger_1.WrapBuffer,
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, Object]),
+    tslib_1.__metadata("design:returntype", void 0)
+], Logger.prototype, "fatal", null);
 tslib_1.__decorate([
     Logger_1.WrapBuffer,
     tslib_1.__metadata("design:type", Function),
@@ -213,6 +228,12 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", [Object, Object]),
     tslib_1.__metadata("design:returntype", void 0)
 ], Logger, "verbose", null);
+tslib_1.__decorate([
+    Logger_1.WrapBuffer,
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, Object]),
+    tslib_1.__metadata("design:returntype", void 0)
+], Logger, "fatal", null);
 exports.Logger = Logger = Logger_1 = tslib_1.__decorate([
     (0, core_1.Injectable)(),
     tslib_1.__param(0, (0, core_1.Optional)()),

package/services/utils/is-log-level-enabled.util.js

@@ -7,6 +7,7 @@ const LOG_LEVEL_VALUES = {
     log: 2,
     warn: 3,
     error: 4,
+    fatal: 5,
 };
 /**
  * Checks if target level is enabled.