@nestjs/common 10.4.11 → 10.4.13

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

@@ -302,6 +302,26 @@ export declare function Body(property: string, ...pipes: (Type<PipeTransform> |
  * @publicApi
  */
 export declare function RawBody(): ParameterDecorator;
+/**
+ * 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
+ */
+export declare function RawBody(...pipes: (Type<PipeTransform<Buffer | undefined>> | PipeTransform<Buffer | undefined>)[]): ParameterDecorator;
 /**
  * Route handler parameter decorator. Extracts the `params`
  * property from the `req` object and populates the decorated

package/exceptions/intrinsic.exception.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Exception that represents an intrinsic error in the application.
+ * When thrown, the default exception filter will not log the error message.
+ *
+ * @publicApi
+ */
+export declare class IntrinsicException extends Error {
+}

package/exceptions/intrinsic.exception.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntrinsicException = void 0;
+/**
+ * Exception that represents an intrinsic error in the application.
+ * When thrown, the default exception filter will not log the error message.
+ *
+ * @publicApi
+ */
+class IntrinsicException extends Error {
+}
+exports.IntrinsicException = IntrinsicException;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/common",
-  "version": "10.4.11",
+  "version": "10.4.13",
   "description": "Nest - modern, fast, powerful node.js web framework (@common)",
   "author": "Kamil Mysliwiec",
   "homepage": "https://nestjs.com",
@@ -19,7 +19,7 @@
   "license": "MIT",
   "dependencies": {
     "iterare": "1.2.1",
-    "tslib": "2.7.0",
+    "tslib": "2.8.1",
     "uid": "2.0.2"
   },
   "peerDependencies": {

package/pipes/parse-date.pipe.d.ts

@@ -0,0 +1,37 @@
+import { PipeTransform } from '../interfaces/features/pipe-transform.interface';
+import { ErrorHttpStatusCode } from '../utils/http-error-by-code.util';
+export interface ParseDatePipeOptions {
+    /**
+     * If true, the pipe will return null or undefined if the value is not provided
+     * @default false
+     */
+    optional?: boolean;
+    /**
+     * Default value for the date
+     */
+    default?: () => Date;
+    /**
+     * The HTTP status code to be used in the response when the validation fails.
+     */
+    errorHttpStatusCode?: ErrorHttpStatusCode;
+    /**
+     * A factory function that returns an exception object to be thrown
+     * if validation fails.
+     * @param error Error message
+     * @returns The exception object
+     */
+    exceptionFactory?: (error: string) => any;
+}
+export declare class ParseDatePipe implements PipeTransform<string | number | undefined | null> {
+    private readonly options;
+    protected exceptionFactory: (error: string) => any;
+    constructor(options?: ParseDatePipeOptions);
+    /**
+     * Method that accesses and performs optional transformation on argument for
+     * in-flight requests.
+     *
+     * @param value currently processed route argument
+     * @param metadata contains metadata about the currently processed route argument
+     */
+    transform(value: string | number | undefined | null): Date | null | undefined;
+}

package/pipes/parse-date.pipe.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParseDatePipe = void 0;
+const tslib_1 = require("tslib");
+const injectable_decorator_1 = require("../decorators/core/injectable.decorator");
+const http_status_enum_1 = require("../enums/http-status.enum");
+const http_error_by_code_util_1 = require("../utils/http-error-by-code.util");
+const shared_utils_1 = require("../utils/shared.utils");
+let ParseDatePipe = class ParseDatePipe {
+    constructor(options = {}) {
+        this.options = options;
+        const { exceptionFactory, errorHttpStatusCode = http_status_enum_1.HttpStatus.BAD_REQUEST } = options;
+        this.exceptionFactory =
+            exceptionFactory ||
+                (error => new http_error_by_code_util_1.HttpErrorByCode[errorHttpStatusCode](error));
+    }
+    /**
+     * Method that accesses and performs optional transformation on argument for
+     * in-flight requests.
+     *
+     * @param value currently processed route argument
+     * @param metadata contains metadata about the currently processed route argument
+     */
+    transform(value) {
+        if (this.options.optional && (0, shared_utils_1.isNil)(value)) {
+            return this.options.default ? this.options.default() : value;
+        }
+        if (!value) {
+            throw this.exceptionFactory('Validation failed (no Date provided)');
+        }
+        const transformedValue = new Date(value);
+        if (isNaN(transformedValue.getTime())) {
+            throw this.exceptionFactory('Validation failed (invalid date format)');
+        }
+        return transformedValue;
+    }
+};
+exports.ParseDatePipe = ParseDatePipe;
+exports.ParseDatePipe = ParseDatePipe = tslib_1.__decorate([
+    (0, injectable_decorator_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], ParseDatePipe);

package/pipes/validation.pipe.js

@@ -131,6 +131,9 @@ let ValidationPipe = class ValidationPipe {
         if (metatype === Number) {
             return +value;
         }
+        if (metatype === String && !(0, shared_utils_1.isUndefined)(value)) {
+            return String(value);
+        }
         return value;
     }
     toEmptyIfNil(value, metatype) {