@nestjs/common 11.1.9 → 11.1.10

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.9",
+  "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.1.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;
 }