@nestjs/common 10.3.2 → 10.3.4

package/Readme.md

@@ -25,12 +25,12 @@
 
 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>
+<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 <a href="https://github.com/fastify/fastify" target="_blank">Fastify</a>, allowing for easy use of the myriad of third-party plugins which are available.</p>
 
 ## Philosophy
 
-<p>In recent years, thanks to Node.js, JavaScript has become the “lingua franca” of the web for both front and backend applications, giving rise to awesome projects like <a href="https://angular.io/" target="_blank">Angular</a>, <a href="https://github.com/facebook/react" target="_blank">React</a> and <a href="https://github.com/vuejs/vue" target="_blank">Vue</a> which improve developer productivity and enable the construction of fast, testable, extensible frontend applications. However, on the server-side, while there are a lot of superb libraries, helpers and tools for Node, none of them effectively solve the main problem - the architecture.</p>
-<p>Nest aims to provide an application architecture out of the box which allows for effortless creation of highly testable, scalable, loosely coupled and easily maintainable applications. The architecture is heavily inspired by Angular.</p>
+<p>In recent years, thanks to Node.js, JavaScript has become the “lingua franca” of the web for both front and backend applications, giving rise to awesome projects like <a href="https://angular.io/" target="_blank">Angular</a>, <a href="https://github.com/facebook/react" target="_blank">React</a>, and <a href="https://github.com/vuejs/vue" target="_blank">Vue</a>, which improve developer productivity and enable the construction of fast, testable, and extensible frontend applications. However, on the server-side, while there are a lot of superb libraries, helpers, and tools for Node, none of them effectively solve the main problem - the architecture.</p>
+<p>Nest aims to provide an application architecture out of the box which allows for effortless creation of highly testable, scalable, and loosely coupled and easily maintainable applications. The architecture is heavily inspired by Angular.</p>
 
 ## Getting started
 
@@ -93,7 +93,6 @@ Nest is an MIT-licensed open source project. It can grow thanks to the 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>
 <td><a href="https://twistag.com/" target="_blank"><img src="https://nestjs.com/img/twistag-logo.png" width="120" valign="middle" /></td>
-<td><a href="https://immediateedgeapp.org/" target="_blank"><img src="https://nestjs.com/img/immediate-edge-logo.png" width="120" valign="middle" /></td>
 </tr>
 </table>
 

package/decorators/http/create-route-param-metadata.decorator.d.ts

@@ -6,6 +6,7 @@ export type ParamDecoratorEnhancer = ParameterDecorator;
  * Defines HTTP route param decorator
  *
  * @param factory
+ * @param enhancers
  *
  * @publicApi
  */

package/decorators/http/create-route-param-metadata.decorator.js

@@ -9,6 +9,7 @@ const shared_utils_1 = require("../../utils/shared.utils");
  * Defines HTTP route param decorator
  *
  * @param factory
+ * @param enhancers
  *
  * @publicApi
  */

package/decorators/http/route-params.decorator.d.ts

@@ -287,6 +287,21 @@ export declare function Body(...pipes: (Type<PipeTransform> | PipeTransform)[]):
  * @publicApi
  */
 export declare function Body(property: string, ...pipes: (Type<PipeTransform> | PipeTransform)[]): ParameterDecorator;
+/**
+ * Route handler parameter decorator. Extracts the `rawBody` Buffer
+ * property from the `req` object and populates the decorated parameter with that value.
+ *
+ * For example:
+ * ```typescript
+ * async create(@RawBody() rawBody: Buffer | undefined)
+ * ```
+ *
+ * @see [Request object](https://docs.nestjs.com/controllers#request-object)
+ * @see [Raw body](https://docs.nestjs.com/faq/raw-body)
+ *
+ * @publicApi
+ */
+export declare function RawBody(): ParameterDecorator;
 /**
  * Route handler parameter decorator. Extracts the `params`
  * property from the `req` object and populates the decorated

package/decorators/http/route-params.decorator.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Res = exports.Req = exports.HostParam = exports.Param = exports.Body = exports.Query = exports.Headers = exports.UploadedFiles = exports.UploadedFile = exports.Session = exports.Ip = exports.Next = exports.Response = exports.Request = exports.assignMetadata = void 0;
+exports.Res = exports.Req = exports.HostParam = exports.Param = exports.RawBody = exports.Body = exports.Query = exports.Headers = exports.UploadedFiles = exports.UploadedFile = exports.Session = exports.Ip = exports.Next = exports.Response = exports.Request = exports.assignMetadata = void 0;
 const constants_1 = require("../../constants");
 const route_paramtypes_enum_1 = require("../../enums/route-paramtypes.enum");
 const shared_utils_1 = require("../../utils/shared.utils");
@@ -184,6 +184,29 @@ function Body(property, ...pipes) {
     return createPipesRouteParamDecorator(route_paramtypes_enum_1.RouteParamtypes.BODY)(property, ...pipes);
 }
 exports.Body = Body;
+/**
+ * Route handler parameter decorator. Extracts the `rawBody` Buffer
+ * property from the `req` object and populates the decorated parameter with that value.
+ * Also applies pipes to the bound rawBody parameter.
+ *
+ * For example:
+ * ```typescript
+ * async create(@RawBody(new ValidationPipe()) rawBody: Buffer)
+ * ```
+ *
+ * @param pipes one or more pipes - either instances or classes - to apply to
+ * the bound body parameter.
+ *
+ * @see [Request object](https://docs.nestjs.com/controllers#request-object)
+ * @see [Raw body](https://docs.nestjs.com/faq/raw-body)
+ * @see [Working with pipes](https://docs.nestjs.com/custom-decorators#working-with-pipes)
+ *
+ * @publicApi
+ */
+function RawBody(...pipes) {
+    return createPipesRouteParamDecorator(route_paramtypes_enum_1.RouteParamtypes.RAW_BODY)(undefined, ...pipes);
+}
+exports.RawBody = RawBody;
 /**
  * Route handler parameter decorator. Extracts the `params`
  * property from the `req` object and populates the decorated

package/enums/route-paramtypes.enum.d.ts

@@ -3,12 +3,13 @@ export declare enum RouteParamtypes {
     RESPONSE = 1,
     NEXT = 2,
     BODY = 3,
-    QUERY = 4,
-    PARAM = 5,
-    HEADERS = 6,
-    SESSION = 7,
-    FILE = 8,
-    FILES = 9,
-    HOST = 10,
-    IP = 11
+    RAW_BODY = 4,
+    QUERY = 5,
+    PARAM = 6,
+    HEADERS = 7,
+    SESSION = 8,
+    FILE = 9,
+    FILES = 10,
+    HOST = 11,
+    IP = 12
 }

package/enums/route-paramtypes.enum.js

@@ -7,12 +7,13 @@ var RouteParamtypes;
     RouteParamtypes[RouteParamtypes["RESPONSE"] = 1] = "RESPONSE";
     RouteParamtypes[RouteParamtypes["NEXT"] = 2] = "NEXT";
     RouteParamtypes[RouteParamtypes["BODY"] = 3] = "BODY";
-    RouteParamtypes[RouteParamtypes["QUERY"] = 4] = "QUERY";
-    RouteParamtypes[RouteParamtypes["PARAM"] = 5] = "PARAM";
-    RouteParamtypes[RouteParamtypes["HEADERS"] = 6] = "HEADERS";
-    RouteParamtypes[RouteParamtypes["SESSION"] = 7] = "SESSION";
-    RouteParamtypes[RouteParamtypes["FILE"] = 8] = "FILE";
-    RouteParamtypes[RouteParamtypes["FILES"] = 9] = "FILES";
-    RouteParamtypes[RouteParamtypes["HOST"] = 10] = "HOST";
-    RouteParamtypes[RouteParamtypes["IP"] = 11] = "IP";
+    RouteParamtypes[RouteParamtypes["RAW_BODY"] = 4] = "RAW_BODY";
+    RouteParamtypes[RouteParamtypes["QUERY"] = 5] = "QUERY";
+    RouteParamtypes[RouteParamtypes["PARAM"] = 6] = "PARAM";
+    RouteParamtypes[RouteParamtypes["HEADERS"] = 7] = "HEADERS";
+    RouteParamtypes[RouteParamtypes["SESSION"] = 8] = "SESSION";
+    RouteParamtypes[RouteParamtypes["FILE"] = 9] = "FILE";
+    RouteParamtypes[RouteParamtypes["FILES"] = 10] = "FILES";
+    RouteParamtypes[RouteParamtypes["HOST"] = 11] = "HOST";
+    RouteParamtypes[RouteParamtypes["IP"] = 12] = "IP";
 })(RouteParamtypes || (exports.RouteParamtypes = RouteParamtypes = {}));

package/exceptions/http.exception.d.ts

@@ -24,7 +24,6 @@ export declare class HttpException extends Error {
      * Instantiate a plain HTTP Exception.
      *
      * @example
-     * throw new HttpException()
      * throw new HttpException('message', HttpStatus.BAD_REQUEST)
      * throw new HttpException('custom message', HttpStatus.BAD_REQUEST, {
      *  cause: new Error('Cause Error'),

package/exceptions/http.exception.js

@@ -15,7 +15,6 @@ class HttpException extends Error {
      * Instantiate a plain HTTP Exception.
      *
      * @example
-     * throw new HttpException()
      * throw new HttpException('message', HttpStatus.BAD_REQUEST)
      * throw new HttpException('custom message', HttpStatus.BAD_REQUEST, {
      *  cause: new Error('Cause Error'),

package/module-utils/configurable-module.builder.d.ts

@@ -7,7 +7,7 @@ import { ConfigurableModuleHost } from './interfaces';
  */
 export interface ConfigurableModuleBuilderOptions {
     /**
-     * Specified what injection token should be used for the module options provider.
+     * Specifies what injection token should be used for the module options provider.
      * By default, an auto-generated UUID will be used.
      */
     optionsInjectionToken?: string | symbol;
@@ -16,11 +16,11 @@ export interface ConfigurableModuleBuilderOptions {
      * Explicitly specifying the "moduleName" will instruct the "ConfigurableModuleBuilder"
      * to use a more descriptive provider token.
      *
-     * For example, if `moduleName: "Cache"` then auto-generated provider token will be "CACHE_MODULE_OPTIONS".
+     * For example, `moduleName: "Cache"` will auto-generate the provider token: "CACHE_MODULE_OPTIONS".
      */
     moduleName?: string;
     /**
-     * Indicates whether module should always be "transient", meaning,
+     * Indicates whether module should always be "transient" - meaning,
      * every time you call the static method to construct a dynamic module,
      * regardless of what arguments you pass in, a new "unique" module will be created.
      *

package/package.json

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

package/services/console-logger.service.js

@@ -227,7 +227,7 @@ let ConsoleLogger = ConsoleLogger_1 = class ConsoleLogger {
         if (!(0, shared_utils_1.isString)(stack) && !(0, shared_utils_1.isUndefined)(stack)) {
             return false;
         }
-        return /^(.)+\n\s+at .+:\d+:\d+$/.test(stack);
+        return /^(.)+\n\s+at .+:\d+:\d+/.test(stack);
     }
     getColorByLogLevel(level) {
         switch (level) {