@nestjs/common 9.3.12 → 9.4.1

package/Readme.md

@@ -1,11 +1,11 @@
 <p align="center">
-  <a href="http://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
 [circleci-url]: https://circleci.com/gh/nestjs/nest
 
-  <p align="center">A progressive <a href="http://nodejs.org" target="_blank">Node.js</a> framework for building efficient and scalable server-side applications.</p>
+  <p align="center">A progressive <a href="https://nodejs.org" target="_blank">Node.js</a> framework for building efficient and scalable server-side applications.</p>
     <p align="center">
 <a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/v/@nestjs/core.svg" alt="NPM Version" /></a>
 <a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/l/@nestjs/core.svg" alt="Package License" /></a>
@@ -132,7 +132,7 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
    <td align="center" valign="middle"><a href="https://klqc.de" target="_blank"><img src="https://nestjs.com/img/klcqcl-logo.png" width="120" valign="middle" /></a></td>
    <td align="center" valign="middle"><a href="https://thecasinowizard.com/bonuses/no-deposit-bonuses/" target="_blank"><img src="https://nestjs.com/img/casinowizard-logo.png" width="120" valign="middle" /></a></td></tr><tr>
      <td align="center" valign="middle"><a href="https://polygon-software.ch/" target="_blank"><img src="https://nestjs.com/img/polygon-logo.svg" width="120" valign="middle" /></a></td>
-   <td align="center" valign="middle"><a href="https://mobilereality.pl/" target="_blank"><img src="https://nestjs.com/img/mobile-reality-logo.png" width="45" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://themobilereality.com/" target="_blank"><img src="https://nestjs.com/img/mobile-reality-logo.png" width="45" valign="middle" /></a></td>
      <td align="center" valign="middle"><a href="https://boringowl.io/" target="_blank"><img src="https://nestjs.com/img/boringowl-logo.svg" width="120" valign="middle" /></a></td>
  <td align="center" valign="middle"><a href="https://www.mobilefactory.jp/" target="_blank"><img src="https://nestjs.com/img/mobilefactory-logo.png" width="100" valign="middle" /></a></td>
  <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>

package/cache/cache.constants.d.ts

@@ -1,4 +1,12 @@
+/**
+ * @deprecated `CacheModule` (from the `@nestjs/common` package) is deprecated and will be removed in the next major release. Please, use the `@nestjs/cache-manager` package instead
+ * @publicApi
+ */
 export declare const CACHE_MANAGER = "CACHE_MANAGER";
 export declare const CACHE_KEY_METADATA = "cache_module:cache_key";
 export declare const CACHE_TTL_METADATA = "cache_module:cache_ttl";
+/**
+ * @deprecated `CacheModule` (from the `@nestjs/common` package) is deprecated and will be removed in the next major release. Please, use the `@nestjs/cache-manager` package instead
+ * @publicApi
+ */
 export declare const CACHE_MODULE_OPTIONS: string | symbol;

package/cache/cache.constants.js

@@ -2,7 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CACHE_MODULE_OPTIONS = exports.CACHE_TTL_METADATA = exports.CACHE_KEY_METADATA = exports.CACHE_MANAGER = void 0;
 const cache_module_definition_1 = require("./cache.module-definition");
+/**
+ * @deprecated `CacheModule` (from the `@nestjs/common` package) is deprecated and will be removed in the next major release. Please, use the `@nestjs/cache-manager` package instead
+ * @publicApi
+ */
 exports.CACHE_MANAGER = 'CACHE_MANAGER';
 exports.CACHE_KEY_METADATA = 'cache_module:cache_key';
 exports.CACHE_TTL_METADATA = 'cache_module:cache_ttl';
+/**
+ * @deprecated `CacheModule` (from the `@nestjs/common` package) is deprecated and will be removed in the next major release. Please, use the `@nestjs/cache-manager` package instead
+ * @publicApi
+ */
 exports.CACHE_MODULE_OPTIONS = cache_module_definition_1.MODULE_OPTIONS_TOKEN;

package/cache/cache.module-definition.d.ts

@@ -1,2 +1,2 @@
 import { CacheModuleOptions } from './interfaces/cache-module.interface';
-export declare const ConfigurableModuleClass: import("../module-utils").ConfigurableModuleCls<CacheModuleOptions<Record<string, any>>, "register", "createCacheOptions", {}>, MODULE_OPTIONS_TOKEN: string | symbol;
+export declare const ConfigurableModuleClass: import("../module-utils").ConfigurableModuleCls<CacheModuleOptions, "register", "createCacheOptions", {}>, MODULE_OPTIONS_TOKEN: string | symbol;

package/cache/cache.module.d.ts

@@ -5,7 +5,7 @@ import { CacheModuleAsyncOptions, CacheModuleOptions } from './interfaces/cache-
  * Module that provides Nest cache-manager.
  *
  * @see [Caching](https://docs.nestjs.com/techniques/caching)
- *
+ * @deprecated `CacheModule` (from the `@nestjs/common` package) is deprecated and will be removed in the next major release. Please, use the `@nestjs/cache-manager` package instead
  * @publicApi
  */
 export declare class CacheModule extends ConfigurableModuleClass {

package/cache/cache.module.js

@@ -10,7 +10,7 @@ const cache_providers_1 = require("./cache.providers");
  * Module that provides Nest cache-manager.
  *
  * @see [Caching](https://docs.nestjs.com/techniques/caching)
- *
+ * @deprecated `CacheModule` (from the `@nestjs/common` package) is deprecated and will be removed in the next major release. Please, use the `@nestjs/cache-manager` package instead
  * @publicApi
  */
 let CacheModule = class CacheModule extends cache_module_definition_1.ConfigurableModuleClass {

package/cache/decorators/cache-key.decorator.d.ts

@@ -9,6 +9,7 @@
  *
  * @see [Caching](https://docs.nestjs.com/techniques/caching)
  *
+ * @deprecated `CacheModule` (from the `@nestjs/common` package) is deprecated and will be removed in the next major release. Please, use the `@nestjs/cache-manager` package instead
  * @publicApi
  */
 export declare const CacheKey: (key: string) => import("../../decorators").CustomDecorator<string>;

package/cache/decorators/cache-key.decorator.js

@@ -14,6 +14,7 @@ const cache_constants_1 = require("../cache.constants");
  *
  * @see [Caching](https://docs.nestjs.com/techniques/caching)
  *
+ * @deprecated `CacheModule` (from the `@nestjs/common` package) is deprecated and will be removed in the next major release. Please, use the `@nestjs/cache-manager` package instead
  * @publicApi
  */
 const CacheKey = (key) => (0, decorators_1.SetMetadata)(cache_constants_1.CACHE_KEY_METADATA, key);

package/cache/decorators/cache-ttl.decorator.d.ts

@@ -8,6 +8,7 @@ import { ExecutionContext } from '../../interfaces/features/execution-context.in
  *
  * @see [Caching](https://docs.nestjs.com/techniques/caching)
  *
+ * @deprecated `CacheModule` (from the `@nestjs/common` package) is deprecated and will be removed in the next major release. Please, use the `@nestjs/cache-manager` package instead
  * @publicApi
  */
 type CacheTTLFactory = (ctx: ExecutionContext) => Promise<number> | number;

package/cache/interceptors/cache.interceptor.d.ts

@@ -1,11 +1,13 @@
 import { Observable } from 'rxjs';
 import { CallHandler, ExecutionContext, HttpServer, NestInterceptor } from '../../interfaces';
+/** @deprecated Import from the "@nestjs/core" instead. */
 export interface HttpAdapterHost<T extends HttpServer = any> {
     httpAdapter: T;
 }
 /**
  * @see [Caching](https://docs.nestjs.com/techniques/caching)
  *
+ * @deprecated `CacheModule` (from the `@nestjs/common` package) is deprecated and will be removed in the next major release. Please, use the `@nestjs/cache-manager` package instead
  * @publicApi
  */
 export declare class CacheInterceptor implements NestInterceptor {

package/cache/interceptors/cache.interceptor.js

@@ -10,11 +10,14 @@ const logger_service_1 = require("../../services/logger.service");
 const load_package_util_1 = require("../../utils/load-package.util");
 const shared_utils_1 = require("../../utils/shared.utils");
 const cache_constants_1 = require("../cache.constants");
+/** @deprecated */
 const HTTP_ADAPTER_HOST = 'HttpAdapterHost';
+/** @deprecated */
 const REFLECTOR = 'Reflector';
 /**
  * @see [Caching](https://docs.nestjs.com/techniques/caching)
  *
+ * @deprecated `CacheModule` (from the `@nestjs/common` package) is deprecated and will be removed in the next major release. Please, use the `@nestjs/cache-manager` package instead
  * @publicApi
  */
 let CacheInterceptor = class CacheInterceptor {
@@ -26,6 +29,7 @@ let CacheInterceptor = class CacheInterceptor {
         // because the set method signature changed in v5
         const cacheManagerPackage = (0, load_package_util_1.loadPackage)('cache-manager', 'CacheModule', () => require('cache-manager'));
         this.cacheManagerIsv5OrGreater = 'memoryStore' in cacheManagerPackage;
+        logger_service_1.Logger.warn('DEPRECATED! "CacheModule" (from the "@nestjs/common" package) is deprecated and will be removed in the next major release. Please, use the "@nestjs/cache-manager" package instead.');
     }
     async intercept(context, next) {
         var _a;

package/interfaces/external/validator-options.interface.d.ts

@@ -69,7 +69,8 @@ export interface ValidatorOptions {
      */
     forbidUnknownValues?: boolean;
     /**
-     * When set to true, validation of the given property will stop after encountering the first error. Defaults to false.
+     * When set to true, validation of the given property will stop after encountering the first error.
+     * This is enabled by default.
      */
     stopAtFirstError?: boolean;
 }

package/interfaces/http/http-exception-body.interface.d.ts

@@ -0,0 +1,6 @@
+export type HttpExceptionBodyMessage = string | string[];
+export interface HttpExceptionBody {
+    message: HttpExceptionBodyMessage;
+    error?: string;
+    statusCode: number;
+}

package/interfaces/http/http-exception-body.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": "9.3.12",
+  "version": "9.4.1",
   "description": "Nest - modern, fast, powerful node.js web framework (@common)",
   "author": "Kamil Mysliwiec",
   "homepage": "https://nestjs.com",
@@ -10,7 +10,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/nestjs/nest"
+    "url": "https://github.com/nestjs/nest.git",
+    "directory": "packages/common"
   },
   "publishConfig": {
     "access": "public"
@@ -19,7 +20,7 @@
   "dependencies": {
     "iterare": "1.2.1",
     "tslib": "2.5.0",
-    "uid": "2.0.1"
+    "uid": "2.0.2"
   },
   "peerDependencies": {
     "cache-manager": "<=5",

package/pipes/file/interfaces/file.interface.d.ts

@@ -0,0 +1,4 @@
+export interface IFile {
+    mimetype: string;
+    size: number;
+}

package/pipes/file/interfaces/file.interface.js

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

package/pipes/file/interfaces/index.d.ts

@@ -0,0 +1 @@
+export * from './file.interface';

package/pipes/file/interfaces/index.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./file.interface"), exports);

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

@@ -1,6 +1,7 @@
 import { FileValidator } from './file-validator.interface';
 export type MaxFileSizeValidatorOptions = {
     maxSize: number;
+    message?: string | ((maxSize: number) => string);
 };
 /**
  * Defines the built-in MaxSize File Validator

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

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

package/pipes/parse-float.pipe.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParseFloatPipe = void 0;
 const tslib_1 = require("tslib");
 const index_1 = require("../index");
+const core_1 = require("../decorators/core");
 const http_error_by_code_util_1 = require("../utils/http-error-by-code.util");
 /**
  * Defines the built-in ParseFloat Pipe
@@ -43,8 +44,8 @@ let ParseFloatPipe = class ParseFloatPipe {
     }
 };
 ParseFloatPipe = tslib_1.__decorate([
-    (0, index_1.Injectable)(),
-    tslib_1.__param(0, (0, index_1.Optional)()),
+    (0, core_1.Injectable)(),
+    tslib_1.__param(0, (0, core_1.Optional)()),
     tslib_1.__metadata("design:paramtypes", [Object])
 ], ParseFloatPipe);
 exports.ParseFloatPipe = ParseFloatPipe;

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

@@ -27,6 +27,7 @@ export declare class ConsoleLogger implements LoggerService {
      * Write an 'error' level log, if the configured level allows for it.
      * Prints to `stderr` with newline.
      */
+    error(message: any, stackOrContext?: string): void;
     error(message: any, stack?: string, context?: string): void;
     error(message: any, ...optionalParams: [...any, string?, string?]): void;
     /**
@@ -70,9 +71,10 @@ export declare class ConsoleLogger implements LoggerService {
     protected stringifyMessage(message: unknown, logLevel: LogLevel): any;
     protected colorize(message: string, logLevel: LogLevel): string;
     protected printStackTrace(stack: string): void;
-    private updateAndGetTimestampDiff;
+    protected updateAndGetTimestampDiff(): string;
     protected formatTimestampDiff(timestampDiff: number): string;
     private getContextAndMessagesToPrint;
     private getContextAndStackAndMessagesToPrint;
+    private isStackFormat;
     private getColorByLogLevel;
 }

package/services/console-logger.service.js

@@ -179,6 +179,18 @@ let ConsoleLogger = ConsoleLogger_1 = class ConsoleLogger {
         };
     }
     getContextAndStackAndMessagesToPrint(args) {
+        if (args.length === 2) {
+            return this.isStackFormat(args[1])
+                ? {
+                    messages: [args[0]],
+                    stack: args[1],
+                    context: this.context,
+                }
+                : {
+                    messages: [args[0]],
+                    context: args[1],
+                };
+        }
         const { messages, context } = this.getContextAndMessagesToPrint(args);
         if ((messages === null || messages === void 0 ? void 0 : messages.length) <= 1) {
             return { messages, context };
@@ -195,6 +207,12 @@ let ConsoleLogger = ConsoleLogger_1 = class ConsoleLogger {
             context,
         };
     }
+    isStackFormat(stack) {
+        if (!(0, shared_utils_1.isString)(stack) && !(0, shared_utils_1.isUndefined)(stack)) {
+            return false;
+        }
+        return /^(.)+\n\s+at .+:\d+:\d+$/.test(stack);
+    }
     getColorByLogLevel(level) {
         switch (level) {
             case 'debug':

package/services/logger.service.d.ts

@@ -90,6 +90,7 @@ export declare class Logger implements LoggerService {
     /**
      * Write an 'error' level log.
      */
+    static error(message: any, stackOrContext?: string): void;
     static error(message: any, context?: string): void;
     static error(message: any, stack?: string, context?: string): void;
     static error(message: any, ...optionalParams: [...any, string?, string?]): void;
@@ -120,12 +121,12 @@ export declare class Logger implements LoggerService {
     static flush(): void;
     /**
      * Attach buffer.
-     * Turns on initialisation logs buffering.
+     * Turns on initialization logs buffering.
      */
     static attachBuffer(): void;
     /**
      * Detach buffer.
-     * Turns off initialisation logs buffering.
+     * Turns off initialization logs buffering.
      */
     static detachBuffer(): void;
     static getTimestamp(): string;

package/services/logger.service.js

@@ -101,14 +101,14 @@ let Logger = Logger_1 = class Logger {
     }
     /**
      * Attach buffer.
-     * Turns on initialisation logs buffering.
+     * Turns on initialization logs buffering.
      */
     static attachBuffer() {
         this.isBufferAttached = true;
     }
     /**
      * Detach buffer.
-     * Turns off initialisation logs buffering.
+     * Turns off initialization logs buffering.
      */
     static detachBuffer() {
         this.isBufferAttached = false;

package/utils/select-exception-filter-metadata.util.d.ts

@@ -0,0 +1,2 @@
+import { ExceptionFilterMetadata } from '../interfaces/exceptions';
+export declare const selectExceptionFilterMetadata: <T = any>(filters: ExceptionFilterMetadata[], exception: T) => ExceptionFilterMetadata | undefined;

package/utils/select-exception-filter-metadata.util.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectExceptionFilterMetadata = void 0;
+const selectExceptionFilterMetadata = (filters, exception) => filters.find(({ exceptionMetatypes }) => !exceptionMetatypes.length ||
+    exceptionMetatypes.some(ExceptionMetaType => exception instanceof ExceptionMetaType));
+exports.selectExceptionFilterMetadata = selectExceptionFilterMetadata;