@nestjs/common 9.3.11 → 9.4.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/common",
-  "version": "9.3.11",
+  "version": "9.4.0",
   "description": "Nest - modern, fast, powerful node.js web framework (@common)",
   "author": "Kamil Mysliwiec",
   "homepage": "https://nestjs.com",
@@ -19,7 +19,7 @@
   "dependencies": {
     "iterare": "1.2.1",
     "tslib": "2.5.0",
-    "uid": "2.0.1"
+    "uid": "2.0.2"
   },
   "peerDependencies": {
     "cache-manager": "<=5",

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

@@ -67,10 +67,10 @@ export declare class ConsoleLogger implements LoggerService {
     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 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;

package/services/console-logger.service.js

@@ -135,9 +135,12 @@ let ConsoleLogger = ConsoleLogger_1 = class ConsoleLogger {
         return `${pidMessage}${this.getTimestamp()} ${formattedLogLevel} ${contextMessage}${output}${timestampDiff}\n`;
     }
     stringifyMessage(message, logLevel) {
-        return (0, shared_utils_1.isPlainObject)(message) || Array.isArray(message)
-            ? `${this.colorize('Object:', logLevel)}\n${JSON.stringify(message, (key, value) => typeof value === 'bigint' ? value.toString() : value, 2)}\n`
-            : this.colorize(message, logLevel);
+        // If the message is a function, call it and re-resolve its value.
+        return (0, shared_utils_1.isFunction)(message)
+            ? this.stringifyMessage(message(), logLevel)
+            : (0, shared_utils_1.isPlainObject)(message) || Array.isArray(message)
+                ? `${this.colorize('Object:', logLevel)}\n${JSON.stringify(message, (key, value) => typeof value === 'bigint' ? value.toString() : value, 2)}\n`
+                : this.colorize(message, logLevel);
     }
     colorize(message, logLevel) {
         const color = this.getColorByLogLevel(logLevel);

package/services/logger.service.d.ts

@@ -120,12 +120,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/shared.utils.d.ts

@@ -4,7 +4,7 @@ export declare const isPlainObject: (fn: any) => fn is object;
 export declare const addLeadingSlash: (path?: string) => string;
 export declare const normalizePath: (path?: string) => string;
 export declare const stripEndSlash: (path: string) => string;
-export declare const isFunction: (val: any) => boolean;
+export declare const isFunction: (val: any) => val is Function;
 export declare const isString: (val: any) => val is string;
 export declare const isNumber: (val: any) => val is number;
 export declare const isConstructor: (val: any) => boolean;