@nestjs/common 11.1.8 → 11.1.10

package/Readme.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="https://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="120" alt="Nest Logo" /></a>
+  <a href="https://nestjs.com/" target="_blank"><img src="https://nestjs.com/img/logo-small.svg" width="120" alt="Nest Logo" /></a>
 </p>
 
 [circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456
@@ -49,7 +49,7 @@ Please make sure to read the [Issue Reporting Checklist](https://github.com/nest
 
 ## Consulting
 
-With official support, you can get expert help straight from Nest core team. We provide dedicated technical support, migration strategies, advice on best practices (and design decisions), PR reviews, and team augmentation. Read more about [support here](https://enterprise.nestjs.com).
+With official support, you can get expert help straight from the Nest core team. We provide dedicated technical support, migration strategies, advice on best practices (and design decisions), PR reviews, and team augmentation. Read more about [support here](https://enterprise.nestjs.com).
 
 ## Support
 
@@ -92,6 +92,8 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <td align="center" valign="middle"><a href="https://www.itflashcards.com/" target="_blank"><img src="https://nestjs.com/img/logos/it_flashcards-logo.png" width="170" valign="middle" /></a></td>
 <td align="center" valign="middle"><a href="https://arcjet.com/?ref=nestjs" target="_blank"><img src="https://nestjs.com/img/logos/arcjet-logo.svg" width="170" valign="middle" /></a></td>
 <td align="center" valign="middle"><a href="https://crawljobs.com" target="_blank"><img src="https://nestjs.com/img/logos/crawljobs-logo.svg" width="130" valign="middle" /></a></td>
+</tr><tr>
+<td align="center" valign="middle"><a href="https://pandektes.com" target="_blank"><img src="https://nestjs.com/img/logos/pandektes-logo.png" width="65" valign="middle" /></a></td>
 </tr>
 </table>
 

package/decorators/http/sse.decorator.d.ts

@@ -1,6 +1,10 @@
+import { METHOD_METADATA } from '../../constants';
+import { RequestMethod } from '../../enums/request-method.enum';
 /**
  * Declares this route as a Server-Sent-Events endpoint
  *
  * @publicApi
  */
-export declare function Sse(path?: string): MethodDecorator;
+export declare function Sse(path?: string, options?: {
+    [METHOD_METADATA]?: RequestMethod;
+}): MethodDecorator;

package/decorators/http/sse.decorator.js

@@ -8,11 +8,13 @@ const request_method_enum_1 = require("../../enums/request-method.enum");
  *
  * @publicApi
  */
-function Sse(path) {
+function Sse(path, options = {
+    [constants_1.METHOD_METADATA]: request_method_enum_1.RequestMethod.GET,
+}) {
     return (target, key, descriptor) => {
         path = path && path.length ? path : '/';
         Reflect.defineMetadata(constants_1.PATH_METADATA, path, descriptor.value);
-        Reflect.defineMetadata(constants_1.METHOD_METADATA, request_method_enum_1.RequestMethod.GET, descriptor.value);
+        Reflect.defineMetadata(constants_1.METHOD_METADATA, options[constants_1.METHOD_METADATA], descriptor.value);
         Reflect.defineMetadata(constants_1.SSE_METADATA, true, descriptor.value);
         return descriptor;
     };

package/interfaces/index.d.ts

@@ -24,6 +24,7 @@ export * from './nest-application-options.interface';
 export * from './nest-application.interface';
 export * from './nest-microservice.interface';
 export * from './scope-options.interface';
+export * from './shutdown-hooks-options.interface';
 export * from './type.interface';
 export * from './version-options.interface';
 export * from './websockets/web-socket-adapter.interface';

package/interfaces/index.js

@@ -27,6 +27,7 @@ tslib_1.__exportStar(require("./nest-application-options.interface"), exports);
 tslib_1.__exportStar(require("./nest-application.interface"), exports);
 tslib_1.__exportStar(require("./nest-microservice.interface"), exports);
 tslib_1.__exportStar(require("./scope-options.interface"), exports);
+tslib_1.__exportStar(require("./shutdown-hooks-options.interface"), exports);
 tslib_1.__exportStar(require("./type.interface"), exports);
 tslib_1.__exportStar(require("./version-options.interface"), exports);
 tslib_1.__exportStar(require("./websockets/web-socket-adapter.interface"), exports);

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

@@ -2,6 +2,7 @@ import { ShutdownSignal } from '../enums/shutdown-signal.enum';
 import { LoggerService, LogLevel } from '../services/logger.service';
 import { DynamicModule } from './modules';
 import { NestApplicationContextOptions } from './nest-application-context-options.interface';
+import { ShutdownHooksOptions } from './shutdown-hooks-options.interface';
 import { Type } from './type.interface';
 export type SelectOptions = Pick<NestApplicationContextOptions, 'abortOnError'>;
 export interface GetOrResolveOptions {
@@ -121,9 +122,12 @@ export interface INestApplicationContext {
      * `onApplicationShutdown` function of a provider if the
      * process receives a shutdown signal.
      *
+     * @param {ShutdownSignal[] | string[]} [signals] The system signals to listen to
+     * @param {ShutdownHooksOptions} [options] Options for configuring shutdown hooks behavior
+     *
      * @returns {this} The Nest application context instance
      */
-    enableShutdownHooks(signals?: ShutdownSignal[] | string[]): this;
+    enableShutdownHooks(signals?: ShutdownSignal[] | string[], options?: ShutdownHooksOptions): this;
     /**
      * Initializes the Nest application.
      * Calls the Nest lifecycle events.

package/interfaces/shutdown-hooks-options.interface.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Options for configuring shutdown hooks behavior.
+ *
+ * @publicApi
+ */
+export interface ShutdownHooksOptions {
+    /**
+     * If true, uses `process.exit()` instead of `process.kill(process.pid, signal)`
+     * after shutdown hooks complete. This ensures the 'exit' event is properly
+     * triggered, which is required for async loggers (like Pino with transports)
+     * to flush their buffers before the process terminates.
+     *
+     * Note: Using `process.exit()` will:
+     * - Change the exit code (e.g., SIGTERM: 143 → 0)
+     * - May not trigger other signal handlers from third-party libraries
+     * - May affect orchestrator (Kubernetes, Docker) behavior
+     *
+     * @default false
+     */
+    useProcessExit?: boolean;
+}

package/interfaces/shutdown-hooks-options.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/common",
-  "version": "11.1.8",
+  "version": "11.1.10",
   "description": "Nest - modern, fast, powerful node.js web framework (@common)",
   "author": "Kamil Mysliwiec",
   "homepage": "https://nestjs.com",
@@ -18,7 +18,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "file-type": "21.0.0",
+    "file-type": "21.1.1",
     "iterare": "1.2.1",
     "load-esm": "1.0.3",
     "tslib": "2.8.1",
@@ -37,5 +37,6 @@
     "class-transformer": {
       "optional": true
     }
-  }
+  },
+  "gitHead": "8ea5aaef561c87065bf0b358771de8c8b62e7835"
 }

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

@@ -1,7 +1,39 @@
+import { FileValidatorContext } from './file-validator-context.interface';
 import { FileValidator } from './file-validator.interface';
 import { IFile } from './interfaces';
+type FileTypeValidatorContext = FileValidatorContext<Omit<FileTypeValidatorOptions, 'errorMessage'>>;
 export type FileTypeValidatorOptions = {
+    /**
+     * Expected file type(s) for validation. Can be a string (MIME type)
+     * or a regular expression to match multiple types.
+     *
+     * @example
+     * // Match a single MIME type
+     * fileType: 'image/png'
+     *
+     * @example
+     * // Match multiple types using RegExp
+     * fileType: /^image\/(png|jpeg)$/
+     */
     fileType: string | RegExp;
+    /**
+     * Custom error message displayed when file type validation fails
+     * Can be provided as a static string, or as a factory function
+     * that receives the validation context (file and validator configuration)
+     * and returns a dynamic error message.
+     *
+     * @example
+     * // Static message
+     * new FileTypeValidator({ fileType: 'image/png', errorMessage: 'Only PNG allowed' })
+     *
+     * @example
+     * // Dynamic message based on file object and validator configuration
+     * new FileTypeValidator({
+     *   fileType: 'image/png',
+     *   errorMessage: ctx => `Received file type '${ctx.file?.mimetype}', but expected '${ctx.config.fileType}'`
+     * })
+     */
+    errorMessage?: string | ((ctx: FileTypeValidatorContext) => string);
     /**
      * If `true`, the validator will skip the magic numbers validation.
      * This can be useful when you can't identify some files as there are no common magic numbers available for some file types.
@@ -27,3 +59,4 @@ export declare class FileTypeValidator extends FileValidator<FileTypeValidatorOp
     buildErrorMessage(file?: IFile): string;
     isValid(file?: IFile): Promise<boolean>;
 }
+export {};

package/pipes/file/file-type.validator.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileTypeValidator = void 0;
+const logger_service_1 = require("../../services/logger.service");
 const file_validator_interface_1 = require("./file-validator.interface");
 const load_esm_1 = require("load-esm");
+const logger = new logger_service_1.Logger('FileTypeValidator');
 /**
  * Defines the built-in FileTypeValidator. It validates incoming files by examining
  * their magic numbers using the file-type package, providing more reliable file type validation
@@ -14,9 +16,14 @@ const load_esm_1 = require("load-esm");
  */
 class FileTypeValidator extends file_validator_interface_1.FileValidator {
     buildErrorMessage(file) {
-        const expected = this.validationOptions.fileType;
+        const { errorMessage, ...config } = this.validationOptions;
+        if (errorMessage) {
+            return typeof errorMessage === 'function'
+                ? errorMessage({ file, config })
+                : errorMessage;
+        }
         if (file?.mimetype) {
-            const baseMessage = `Validation failed (current file type is ${file.mimetype}, expected type is ${expected})`;
+            const baseMessage = `Validation failed (current file type is ${file.mimetype}, expected type is ${this.validationOptions.fileType})`;
             /**
              * If fallbackToMimetype is enabled, this means the validator failed to detect the file type
              * via magic number inspection (e.g. due to an unknown or too short buffer),
@@ -29,7 +36,7 @@ class FileTypeValidator extends file_validator_interface_1.FileValidator {
             }
             return baseMessage;
         }
-        return `Validation failed (expected type is ${expected})`;
+        return `Validation failed (expected type is ${this.validationOptions.fileType})`;
     }
     async isValid(file) {
         if (!this.validationOptions) {
@@ -40,10 +47,23 @@ class FileTypeValidator extends file_validator_interface_1.FileValidator {
         if (this.validationOptions.skipMagicNumbersValidation) {
             return (isFileValid && !!file.mimetype.match(this.validationOptions.fileType));
         }
-        if (!isFileValid || !file.buffer)
+        if (!isFileValid)
+            return false;
+        if (!file.buffer) {
+            if (this.validationOptions.fallbackToMimetype) {
+                return !!file.mimetype.match(this.validationOptions.fileType);
+            }
             return false;
+        }
         try {
-            const { fileTypeFromBuffer } = await (0, load_esm_1.loadEsm)('file-type');
+            let fileTypePath;
+            try {
+                fileTypePath = require.resolve('file-type');
+            }
+            catch {
+                fileTypePath = 'file-type';
+            }
+            const { fileTypeFromBuffer } = await (0, load_esm_1.loadEsm)(fileTypePath);
             const fileType = await fileTypeFromBuffer(file.buffer);
             if (fileType) {
                 // Match detected mime type against allowed type
@@ -59,7 +79,20 @@ class FileTypeValidator extends file_validator_interface_1.FileValidator {
             }
             return false;
         }
-        catch {
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Check for common ESM loading issues
+            if (errorMessage.includes('ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING') ||
+                errorMessage.includes('Cannot find module') ||
+                errorMessage.includes('ERR_MODULE_NOT_FOUND')) {
+                logger.warn(`Failed to load the "file-type" package for magic number validation. ` +
+                    `If you are using Jest, run it with NODE_OPTIONS="--experimental-vm-modules". ` +
+                    `Error: ${errorMessage}`);
+            }
+            // Fallback to mimetype if enabled
+            if (this.validationOptions.fallbackToMimetype) {
+                return !!file.mimetype.match(this.validationOptions.fileType);
+            }
             return false;
         }
     }

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

@@ -0,0 +1,5 @@
+import { IFile } from './interfaces';
+export type FileValidatorContext<TConfig> = {
+    file?: IFile;
+    config: TConfig;
+};

package/pipes/file/file-validator-context.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/pipes/file/max-file-size.validator.d.ts

@@ -1,8 +1,34 @@
+import { FileValidatorContext } from './file-validator-context.interface';
 import { FileValidator } from './file-validator.interface';
 import { IFile } from './interfaces';
+type MaxFileSizeValidatorContext = FileValidatorContext<Omit<MaxFileSizeValidatorOptions, 'errorMessage' | 'message'>>;
 export type MaxFileSizeValidatorOptions = {
+    /**
+     * Maximum allowed file size in bytes.
+     */
     maxSize: number;
+    /**
+     * @deprecated Use `errorMessage` instead.
+     */
     message?: string | ((maxSize: number) => string);
+    /**
+     * Custom error message returned when file size validation fails.
+     * Can be provided as a static string, or as a factory function
+     * that receives the validation context (file and validator configuration)
+     * and returns a dynamic error message.
+     *
+     * @example
+     * // Static message
+     * new MaxFileSizeValidator({ maxSize: 1000, errorMessage: 'File size exceeds the limit' })
+     *
+     * @example
+     * // Dynamic message based on file object and validator configuration
+     * new MaxFileSizeValidator({
+     *   maxSize: 1000,
+     *   errorMessage: ctx => `Received file size is ${ctx.file?.size}, but it must be smaller than ${ctx.config.maxSize}.`
+     * })
+     */
+    errorMessage?: string | ((ctx: MaxFileSizeValidatorContext) => string);
 };
 /**
  * Defines the built-in MaxSize File Validator
@@ -15,3 +41,4 @@ export declare class MaxFileSizeValidator extends FileValidator<MaxFileSizeValid
     buildErrorMessage(file?: IFile): string;
     isValid(file?: IFile): boolean;
 }
+export {};

package/pipes/file/max-file-size.validator.js

@@ -11,11 +11,16 @@ const file_validator_interface_1 = require("./file-validator.interface");
  */
 class MaxFileSizeValidator extends file_validator_interface_1.FileValidator {
     buildErrorMessage(file) {
-        if ('message' in this.validationOptions) {
-            if (typeof this.validationOptions.message === 'function') {
-                return this.validationOptions.message(this.validationOptions.maxSize);
-            }
-            return this.validationOptions.message;
+        const { errorMessage, message, ...config } = this.validationOptions;
+        if (errorMessage) {
+            return typeof errorMessage === 'function'
+                ? errorMessage({ file, config })
+                : errorMessage;
+        }
+        if (message) {
+            return typeof message === 'function'
+                ? message(this.validationOptions.maxSize)
+                : message;
         }
         if (file?.size) {
             return `Validation failed (current file size is ${file.size}, expected size is less than ${this.validationOptions.maxSize})`;

package/pipes/validation.pipe.js

@@ -175,6 +175,8 @@ let ValidationPipe = class ValidationPipe {
             return;
         }
         delete value.__proto__;
+        delete value.constructor;
+        delete value.prototype;
         for (const key in value) {
             this.stripProtoKeys(value[key]);
         }

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

@@ -21,9 +21,12 @@ function isLogLevelEnabled(targetLevel, logLevels) {
     if (logLevels.includes(targetLevel)) {
         return true;
     }
-    const highestLogLevelValue = logLevels
-        .map(level => LOG_LEVEL_VALUES[level])
-        .sort((a, b) => b - a)?.[0];
+    let highestLogLevelValue = -Infinity;
+    for (const level of logLevels) {
+        const v = LOG_LEVEL_VALUES[level];
+        if (v > highestLogLevelValue)
+            highestLogLevelValue = v;
+    }
     const targetLevelValue = LOG_LEVEL_VALUES[targetLevel];
     return targetLevelValue >= highestLogLevelValue;
 }