@nestjs/common 11.1.16 → 12.0.0-alpha.0

package/decorators/core/version.decorator.js

@@ -1,19 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Version = Version;
-const constants_1 = require("../../constants");
+import { VERSION_METADATA } from '../../constants.js';
 /**
  * Sets the version of the endpoint to the passed version
  *
  * @publicApi
  */
-function Version(version) {
+export function Version(version) {
     if (Array.isArray(version)) {
         // Drop duplicated versions
         version = Array.from(new Set(version));
     }
     return (target, key, descriptor) => {
-        Reflect.defineMetadata(constants_1.VERSION_METADATA, version, descriptor.value);
+        Reflect.defineMetadata(VERSION_METADATA, version, descriptor.value);
         return descriptor;
     };
 }

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

@@ -1,13 +1,14 @@
-import { PipeTransform } from '../../index';
-import { Type } from '../../interfaces';
-import { CustomParamFactory } from '../../interfaces/features/custom-route-param-factory.interface';
+import { PipeTransform } from '../../index.js';
+import { CustomParamFactory } from '../../interfaces/features/custom-route-param-factory.interface.js';
+import { Type } from '../../interfaces/index.js';
+import { ParameterDecoratorOptions } from './route-params.decorator.js';
 export type ParamDecoratorEnhancer = ParameterDecorator;
 /**
- * Defines HTTP route param decorator
+ * Defines route param decorator
  *
  * @param factory
  * @param enhancers
  *
  * @publicApi
  */
-export declare function createParamDecorator<FactoryData = any, FactoryOutput = any>(factory: CustomParamFactory<FactoryData, FactoryOutput>, enhancers?: ParamDecoratorEnhancer[]): (...dataOrPipes: (Type<PipeTransform> | PipeTransform | FactoryData)[]) => ParameterDecorator;
+export declare function createParamDecorator<FactoryData = any, FactoryOutput = any>(factory: CustomParamFactory<FactoryData, FactoryOutput>, enhancers?: ParamDecoratorEnhancer[]): (...dataOrPipes: (Type<PipeTransform> | PipeTransform | FactoryData | ParameterDecoratorOptions)[]) => ParameterDecorator;

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

@@ -1,32 +1,64 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createParamDecorator = createParamDecorator;
-const uid_1 = require("uid");
-const constants_1 = require("../../constants");
-const assign_custom_metadata_util_1 = require("../../utils/assign-custom-metadata.util");
-const shared_utils_1 = require("../../utils/shared.utils");
+import { uid } from 'uid';
+import { ROUTE_ARGS_METADATA } from '../../constants.js';
+import { assignCustomParameterMetadata } from '../../utils/assign-custom-metadata.util.js';
+import { isFunction, isNil } from '../../utils/shared.utils.js';
 /**
- * Defines HTTP route param decorator
+ * Defines route param decorator
  *
  * @param factory
  * @param enhancers
  *
  * @publicApi
  */
-function createParamDecorator(factory, enhancers = []) {
-    const paramtype = (0, uid_1.uid)(21);
+export function createParamDecorator(factory, enhancers = []) {
+    const paramtype = uid(21);
     return (data, ...pipes) => (target, key, index) => {
-        const args = Reflect.getMetadata(constants_1.ROUTE_ARGS_METADATA, target.constructor, key) ||
+        const args = Reflect.getMetadata(ROUTE_ARGS_METADATA, target.constructor, key) ||
             {};
         const isPipe = (pipe) => pipe &&
-            (((0, shared_utils_1.isFunction)(pipe) &&
+            ((isFunction(pipe) &&
                 pipe.prototype &&
-                (0, shared_utils_1.isFunction)(pipe.prototype.transform)) ||
-                (0, shared_utils_1.isFunction)(pipe.transform));
-        const hasParamData = (0, shared_utils_1.isNil)(data) || !isPipe(data);
+                isFunction(pipe.prototype.transform)) ||
+                isFunction(pipe.transform));
+        const isParameterDecoratorOptions = (value) => value &&
+            typeof value === 'object' &&
+            !isPipe(value) &&
+            ('schema' in value || 'pipes' in value);
+        const hasParamData = isNil(data) || !isPipe(data);
         const paramData = hasParamData ? data : undefined;
         const paramPipes = hasParamData ? pipes : [data, ...pipes];
-        Reflect.defineMetadata(constants_1.ROUTE_ARGS_METADATA, (0, assign_custom_metadata_util_1.assignCustomParameterMetadata)(args, paramtype, index, factory, paramData, ...paramPipes), target.constructor, key);
+        // Check if data itself is an options object (when used as the first and only argument)
+        const isDataOptions = hasParamData &&
+            !isNil(data) &&
+            paramPipes.length === 0 &&
+            isParameterDecoratorOptions(data);
+        // Check if the last pipe argument is actually an options object
+        const lastPipeArg = paramPipes.length > 0 ? paramPipes[paramPipes.length - 1] : undefined;
+        const isLastPipeOptions = !isDataOptions && isParameterDecoratorOptions(lastPipeArg);
+        let finalData;
+        let finalSchema;
+        let finalPipes;
+        if (isDataOptions) {
+            const opts = data;
+            finalData = undefined;
+            finalSchema = opts.schema;
+            finalPipes = (opts.pipes ?? []);
+        }
+        else if (isLastPipeOptions) {
+            const opts = lastPipeArg;
+            finalData = paramData;
+            finalSchema = opts.schema;
+            finalPipes = [
+                ...paramPipes.slice(0, -1),
+                ...(opts.pipes ?? []),
+            ];
+        }
+        else {
+            finalData = paramData;
+            finalSchema = undefined;
+            finalPipes = paramPipes;
+        }
+        Reflect.defineMetadata(ROUTE_ARGS_METADATA, assignCustomParameterMetadata(args, paramtype, index, factory, finalData, finalSchema, ...finalPipes), target.constructor, key);
         enhancers.forEach(fn => fn(target, key, index));
     };
 }

package/decorators/http/header.decorator.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Header = Header;
-const constants_1 = require("../../constants");
-const extend_metadata_util_1 = require("../../utils/extend-metadata.util");
+import { HEADERS_METADATA } from '../../constants.js';
+import { extendArrayMetadata } from '../../utils/extend-metadata.util.js';
 /**
  * Request method Decorator.  Sets a response header.
  *
@@ -17,9 +14,9 @@ const extend_metadata_util_1 = require("../../utils/extend-metadata.util");
  *
  * @publicApi
  */
-function Header(name, value) {
+export function Header(name, value) {
     return (target, key, descriptor) => {
-        (0, extend_metadata_util_1.extendArrayMetadata)(constants_1.HEADERS_METADATA, [{ name, value }], descriptor.value);
+        extendArrayMetadata(HEADERS_METADATA, [{ name, value }], descriptor.value);
         return descriptor;
     };
 }

package/decorators/http/http-code.decorator.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpCode = HttpCode;
-const constants_1 = require("../../constants");
+import { HTTP_CODE_METADATA } from '../../constants.js';
 /**
  * Request method Decorator.  Defines the HTTP response status code.  Overrides
  * default status code for the decorated request method.
@@ -12,9 +9,9 @@ const constants_1 = require("../../constants");
  *
  * @publicApi
  */
-function HttpCode(statusCode) {
+export function HttpCode(statusCode) {
     return (target, key, descriptor) => {
-        Reflect.defineMetadata(constants_1.HTTP_CODE_METADATA, statusCode, descriptor.value);
+        Reflect.defineMetadata(HTTP_CODE_METADATA, statusCode, descriptor.value);
         return descriptor;
     };
 }

package/decorators/http/index.d.ts

@@ -1,8 +1,8 @@
-export * from './request-mapping.decorator';
-export * from './route-params.decorator';
-export * from './http-code.decorator';
-export * from './create-route-param-metadata.decorator';
-export * from './render.decorator';
-export * from './header.decorator';
-export * from './redirect.decorator';
-export * from './sse.decorator';
+export * from './request-mapping.decorator.js';
+export * from './route-params.decorator.js';
+export * from './http-code.decorator.js';
+export * from './create-route-param-metadata.decorator.js';
+export * from './render.decorator.js';
+export * from './header.decorator.js';
+export * from './redirect.decorator.js';
+export * from './sse.decorator.js';

package/decorators/http/index.js

@@ -1,11 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./request-mapping.decorator"), exports);
-tslib_1.__exportStar(require("./route-params.decorator"), exports);
-tslib_1.__exportStar(require("./http-code.decorator"), exports);
-tslib_1.__exportStar(require("./create-route-param-metadata.decorator"), exports);
-tslib_1.__exportStar(require("./render.decorator"), exports);
-tslib_1.__exportStar(require("./header.decorator"), exports);
-tslib_1.__exportStar(require("./redirect.decorator"), exports);
-tslib_1.__exportStar(require("./sse.decorator"), exports);
+export * from './request-mapping.decorator.js';
+export * from './route-params.decorator.js';
+export * from './http-code.decorator.js';
+export * from './create-route-param-metadata.decorator.js';
+export * from './render.decorator.js';
+export * from './header.decorator.js';
+export * from './redirect.decorator.js';
+export * from './sse.decorator.js';

package/decorators/http/redirect.decorator.js

@@ -1,15 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Redirect = Redirect;
-const constants_1 = require("../../constants");
+import { REDIRECT_METADATA } from '../../constants.js';
 /**
  * Redirects request to the specified URL.
  *
  * @publicApi
  */
-function Redirect(url = '', statusCode) {
+export function Redirect(url = '', statusCode) {
     return (target, key, descriptor) => {
-        Reflect.defineMetadata(constants_1.REDIRECT_METADATA, { statusCode, url }, descriptor.value);
+        Reflect.defineMetadata(REDIRECT_METADATA, { statusCode, url }, descriptor.value);
         return descriptor;
     };
 }

package/decorators/http/render.decorator.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Render = Render;
-const constants_1 = require("../../constants");
+import { RENDER_METADATA } from '../../constants.js';
 /**
  * Route handler method Decorator.  Defines a template to be rendered by the controller.
  *
@@ -13,9 +10,9 @@ const constants_1 = require("../../constants");
  *
  * @publicApi
  */
-function Render(template) {
+export function Render(template) {
     return (target, key, descriptor) => {
-        Reflect.defineMetadata(constants_1.RENDER_METADATA, template, descriptor.value);
+        Reflect.defineMetadata(RENDER_METADATA, template, descriptor.value);
         return descriptor;
     };
 }

package/decorators/http/request-mapping.decorator.d.ts

@@ -1,4 +1,4 @@
-import { RequestMethod } from '../../enums/request-method.enum';
+import { RequestMethod } from '../../enums/request-method.enum.js';
 export interface RequestMappingMetadata {
     path?: string | string[];
     method?: RequestMethod;

package/decorators/http/request-mapping.decorator.js

@@ -1,27 +1,23 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Unlock = exports.Lock = exports.Move = exports.Copy = exports.Mkcol = exports.Proppatch = exports.Propfind = exports.Search = exports.All = exports.Head = exports.Options = exports.Patch = exports.Put = exports.Delete = exports.Get = exports.Post = exports.RequestMapping = void 0;
-const constants_1 = require("../../constants");
-const request_method_enum_1 = require("../../enums/request-method.enum");
+import { METHOD_METADATA, PATH_METADATA } from '../../constants.js';
+import { RequestMethod } from '../../enums/request-method.enum.js';
 const defaultMetadata = {
-    [constants_1.PATH_METADATA]: '/',
-    [constants_1.METHOD_METADATA]: request_method_enum_1.RequestMethod.GET,
+    [PATH_METADATA]: '/',
+    [METHOD_METADATA]: RequestMethod.GET,
 };
-const RequestMapping = (metadata = defaultMetadata) => {
-    const pathMetadata = metadata[constants_1.PATH_METADATA];
+export const RequestMapping = (metadata = defaultMetadata) => {
+    const pathMetadata = metadata[PATH_METADATA];
     const path = pathMetadata && pathMetadata.length ? pathMetadata : '/';
-    const requestMethod = metadata[constants_1.METHOD_METADATA] || request_method_enum_1.RequestMethod.GET;
+    const requestMethod = metadata[METHOD_METADATA] || RequestMethod.GET;
     return (target, key, descriptor) => {
-        Reflect.defineMetadata(constants_1.PATH_METADATA, path, descriptor.value);
-        Reflect.defineMetadata(constants_1.METHOD_METADATA, requestMethod, descriptor.value);
+        Reflect.defineMetadata(PATH_METADATA, path, descriptor.value);
+        Reflect.defineMetadata(METHOD_METADATA, requestMethod, descriptor.value);
         return descriptor;
     };
 };
-exports.RequestMapping = RequestMapping;
 const createMappingDecorator = (method) => (path) => {
-    return (0, exports.RequestMapping)({
-        [constants_1.PATH_METADATA]: path,
-        [constants_1.METHOD_METADATA]: method,
+    return RequestMapping({
+        [PATH_METADATA]: path,
+        [METHOD_METADATA]: method,
     });
 };
 /**
@@ -31,7 +27,7 @@ const createMappingDecorator = (method) => (path) => {
  *
  * @publicApi
  */
-exports.Post = createMappingDecorator(request_method_enum_1.RequestMethod.POST);
+export const Post = createMappingDecorator(RequestMethod.POST);
 /**
  * Route handler (method) Decorator. Routes HTTP GET requests to the specified path.
  *
@@ -39,7 +35,7 @@ exports.Post = createMappingDecorator(request_method_enum_1.RequestMethod.POST);
  *
  * @publicApi
  */
-exports.Get = createMappingDecorator(request_method_enum_1.RequestMethod.GET);
+export const Get = createMappingDecorator(RequestMethod.GET);
 /**
  * Route handler (method) Decorator. Routes HTTP DELETE requests to the specified path.
  *
@@ -47,7 +43,7 @@ exports.Get = createMappingDecorator(request_method_enum_1.RequestMethod.GET);
  *
  * @publicApi
  */
-exports.Delete = createMappingDecorator(request_method_enum_1.RequestMethod.DELETE);
+export const Delete = createMappingDecorator(RequestMethod.DELETE);
 /**
  * Route handler (method) Decorator. Routes HTTP PUT requests to the specified path.
  *
@@ -55,7 +51,7 @@ exports.Delete = createMappingDecorator(request_method_enum_1.RequestMethod.DELE
  *
  * @publicApi
  */
-exports.Put = createMappingDecorator(request_method_enum_1.RequestMethod.PUT);
+export const Put = createMappingDecorator(RequestMethod.PUT);
 /**
  * Route handler (method) Decorator. Routes HTTP PATCH requests to the specified path.
  *
@@ -63,7 +59,7 @@ exports.Put = createMappingDecorator(request_method_enum_1.RequestMethod.PUT);
  *
  * @publicApi
  */
-exports.Patch = createMappingDecorator(request_method_enum_1.RequestMethod.PATCH);
+export const Patch = createMappingDecorator(RequestMethod.PATCH);
 /**
  * Route handler (method) Decorator. Routes HTTP OPTIONS requests to the specified path.
  *
@@ -71,7 +67,7 @@ exports.Patch = createMappingDecorator(request_method_enum_1.RequestMethod.PATCH
  *
  * @publicApi
  */
-exports.Options = createMappingDecorator(request_method_enum_1.RequestMethod.OPTIONS);
+export const Options = createMappingDecorator(RequestMethod.OPTIONS);
 /**
  * Route handler (method) Decorator. Routes HTTP HEAD requests to the specified path.
  *
@@ -79,7 +75,7 @@ exports.Options = createMappingDecorator(request_method_enum_1.RequestMethod.OPT
  *
  * @publicApi
  */
-exports.Head = createMappingDecorator(request_method_enum_1.RequestMethod.HEAD);
+export const Head = createMappingDecorator(RequestMethod.HEAD);
 /**
  * Route handler (method) Decorator. Routes all HTTP requests to the specified path.
  *
@@ -87,7 +83,7 @@ exports.Head = createMappingDecorator(request_method_enum_1.RequestMethod.HEAD);
  *
  * @publicApi
  */
-exports.All = createMappingDecorator(request_method_enum_1.RequestMethod.ALL);
+export const All = createMappingDecorator(RequestMethod.ALL);
 /**
  * Route handler (method) Decorator. Routes HTTP SEARCH requests to the specified path.
  *
@@ -95,7 +91,7 @@ exports.All = createMappingDecorator(request_method_enum_1.RequestMethod.ALL);
  *
  * @publicApi
  */
-exports.Search = createMappingDecorator(request_method_enum_1.RequestMethod.SEARCH);
+export const Search = createMappingDecorator(RequestMethod.SEARCH);
 /**
  * Route handler (method) Decorator. Routes Webdav PROPFIND requests to the specified path.
  *
@@ -103,7 +99,7 @@ exports.Search = createMappingDecorator(request_method_enum_1.RequestMethod.SEAR
  *
  * @publicApi
  */
-exports.Propfind = createMappingDecorator(request_method_enum_1.RequestMethod.PROPFIND);
+export const Propfind = createMappingDecorator(RequestMethod.PROPFIND);
 /**
  * Route handler (method) Decorator. Routes Webdav PROPPATCH requests to the specified path.
  *
@@ -111,7 +107,7 @@ exports.Propfind = createMappingDecorator(request_method_enum_1.RequestMethod.PR
  *
  * @publicApi
  */
-exports.Proppatch = createMappingDecorator(request_method_enum_1.RequestMethod.PROPPATCH);
+export const Proppatch = createMappingDecorator(RequestMethod.PROPPATCH);
 /**
  * Route handler (method) Decorator. Routes Webdav MKCOL requests to the specified path.
  *
@@ -119,7 +115,7 @@ exports.Proppatch = createMappingDecorator(request_method_enum_1.RequestMethod.P
  *
  * @publicApi
  */
-exports.Mkcol = createMappingDecorator(request_method_enum_1.RequestMethod.MKCOL);
+export const Mkcol = createMappingDecorator(RequestMethod.MKCOL);
 /**
  * Route handler (method) Decorator. Routes Webdav COPY requests to the specified path.
  *
@@ -127,7 +123,7 @@ exports.Mkcol = createMappingDecorator(request_method_enum_1.RequestMethod.MKCOL
  *
  * @publicApi
  */
-exports.Copy = createMappingDecorator(request_method_enum_1.RequestMethod.COPY);
+export const Copy = createMappingDecorator(RequestMethod.COPY);
 /**
  * Route handler (method) Decorator. Routes Webdav MOVE requests to the specified path.
  *
@@ -135,7 +131,7 @@ exports.Copy = createMappingDecorator(request_method_enum_1.RequestMethod.COPY);
  *
  * @publicApi
  */
-exports.Move = createMappingDecorator(request_method_enum_1.RequestMethod.MOVE);
+export const Move = createMappingDecorator(RequestMethod.MOVE);
 /**
  * Route handler (method) Decorator. Routes Webdav LOCK requests to the specified path.
  *
@@ -143,7 +139,7 @@ exports.Move = createMappingDecorator(request_method_enum_1.RequestMethod.MOVE);
  *
  * @publicApi
  */
-exports.Lock = createMappingDecorator(request_method_enum_1.RequestMethod.LOCK);
+export const Lock = createMappingDecorator(RequestMethod.LOCK);
 /**
  * Route handler (method) Decorator. Routes Webdav UNLOCK requests to the specified path.
  *
@@ -151,4 +147,4 @@ exports.Lock = createMappingDecorator(request_method_enum_1.RequestMethod.LOCK);
  *
  * @publicApi
  */
-exports.Unlock = createMappingDecorator(request_method_enum_1.RequestMethod.UNLOCK);
+export const Unlock = createMappingDecorator(RequestMethod.UNLOCK);

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

@@ -1,5 +1,21 @@
-import { PipeTransform } from '../../index';
-import { Type } from '../../interfaces';
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import { PipeTransform } from '../../index.js';
+import { Type } from '../../interfaces/index.js';
+/**
+ * The options that can be passed to a handler's parameter decorator, such as `@Query()`, `@Body()`, and others.
+ * These options allow you to specify a schema for validation and transformation, as well as any pipes to apply to the parameter.
+ */
+export interface ParameterDecoratorOptions {
+    /**
+     * The schema to use to retrieve within the pipes,
+     * to, for example, validate the parameter against the schema or to apply transformations based on the schema.
+     */
+    schema?: StandardSchemaV1;
+    /**
+     * The list of pipes to apply to the parameter.
+     */
+    pipes?: (Type<PipeTransform> | PipeTransform)[];
+}
 /**
  * The `@Response()`/`@Res` parameter decorator options.
  */
@@ -18,8 +34,11 @@ export interface RouteParamMetadata {
     index: number;
     data?: ParamData;
 }
-export declare function assignMetadata<TParamtype = any, TArgs = any>(args: TArgs, paramtype: TParamtype, index: number, data?: ParamData, ...pipes: (Type<PipeTransform> | PipeTransform)[]): TArgs & {
+export declare function assignMetadata<TParamtype = any, TArgs = any>(args: TArgs, paramtype: TParamtype, index: number, options: {
+    data?: ParamData;
+} & ParameterDecoratorOptions): TArgs & {
     [x: string]: {
+        schema?: StandardSchemaV1<unknown, unknown> | undefined;
         index: number;
         data: ParamData | undefined;
         pipes: (PipeTransform<any, any> | Type<PipeTransform<any, any>>)[];
@@ -231,6 +250,43 @@ export declare function Query(...pipes: (Type<PipeTransform> | PipeTransform)[])
  * @publicApi
  */
 export declare function Query(property: string, ...pipes: (Type<PipeTransform> | PipeTransform)[]): ParameterDecorator;
+/**
+ * Route handler parameter decorator. Extracts the `query`
+ * property from the `req` object and populates the decorated
+ * parameter with the value of `query`. May also apply pipes to the bound
+ * query parameter.
+ *
+ * For example:
+ * ```typescript
+ * async find(@Query('user') user: string)
+ * ```
+ *
+ * @param property name of single property to extract from the `query` object
+ * @param options options object containing additional configuration for the decorator, such as pipes and schema
+ *
+ * @see [Request object](https://docs.nestjs.com/controllers#request-object)
+ *
+ * @publicApi
+ */
+export declare function Query(property: string, options: ParameterDecoratorOptions): ParameterDecorator;
+/**
+ * Route handler parameter decorator. Extracts the `query`
+ * property from the `req` object and populates the decorated
+ * parameter with the value of `query`. May also apply pipes to the bound
+ * query parameter.
+ *
+ * For example:
+ * ```typescript
+ * async find(@Query({ schema: z.object({ user: z.string() }) }) query)
+ * ```
+ *
+ * @param options options object containing additional configuration for the decorator, such as pipes and schema
+ *
+ * @see [Request object](https://docs.nestjs.com/controllers#request-object)
+ *
+ * @publicApi
+ */
+export declare function Query(options: ParameterDecoratorOptions): ParameterDecorator;
 /**
  * Route handler parameter decorator. Extracts the entire `body`
  * object from the `req` object and populates the decorated
@@ -266,6 +322,23 @@ export declare function Body(): ParameterDecorator;
  * @publicApi
  */
 export declare function Body(...pipes: (Type<PipeTransform> | PipeTransform)[]): ParameterDecorator;
+/**
+ * Route handler parameter decorator. Extracts the entire `body` object
+ * property, or optionally a named property of the `body` object, from
+ * the `req` object and populates the decorated parameter with that value.
+ *
+ * For example:
+ * ```typescript
+ * async create(@Body('role') role: string)
+ * ```
+ *
+ * @param options options to apply to the bound body parameter.
+ *
+ * @see [Request object](https://docs.nestjs.com/controllers#request-object)
+ *
+ * @publicApi
+ */
+export declare function Body(options: ParameterDecoratorOptions): ParameterDecorator;
 /**
  * Route handler parameter decorator. Extracts a single property from
  * the `body` object property of the `req` object and populates the decorated
@@ -287,6 +360,26 @@ 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 entire `body` object
+ * property, or optionally a named property of the `body` object, from
+ * the `req` object and populates the decorated parameter with that value.
+ * Also applies pipes to the bound body parameter.
+ *
+ * For example:
+ * ```typescript
+ * async create(@Body('role', new ValidationPipe()) role: string)
+ * ```
+ *
+ * @param property name of single property to extract from the `body` object
+ * @param options options to apply to the bound body parameter.
+ *
+ * @see [Request object](https://docs.nestjs.com/controllers#request-object)
+ * @see [Working with pipes](https://docs.nestjs.com/custom-decorators#working-with-pipes)
+ *
+ * @publicApi
+ */
+export declare function Body(property: string, options: ParameterDecoratorOptions): ParameterDecorator;
 /**
  * Route handler parameter decorator. Extracts the `rawBody` Buffer
  * property from the `req` object and populates the decorated parameter with that value.
@@ -322,6 +415,25 @@ export declare function RawBody(): ParameterDecorator;
  * @publicApi
  */
 export declare function RawBody(...pipes: (Type<PipeTransform<Buffer | undefined>> | PipeTransform<Buffer | undefined>)[]): 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({ schema: z.instanceof(Buffer) }) rawBody: Buffer)
+ * ```
+ *
+ * @param options options object containing additional configuration for the decorator, such as pipes and schema
+ *
+ * @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(options: ParameterDecoratorOptions): ParameterDecorator;
 /**
  * Route handler parameter decorator. Extracts the `params`
  * property from the `req` object and populates the decorated
@@ -397,6 +509,44 @@ export declare function Param(...pipes: (Type<PipeTransform> | PipeTransform)[])
  * @publicApi
  */
 export declare function Param(property: string, ...pipes: (Type<PipeTransform> | PipeTransform)[]): ParameterDecorator;
+/**
+ * Route handler parameter decorator. Extracts the `params`
+ * property from the `req` object and populates the decorated
+ * parameter with the value of `params`. May also apply pipes to the bound
+ * parameter.
+ *
+ * For example, extracting a single param:
+ * ```typescript
+ * findOne(@Param('id', { schema: z.string().uuid() }) id: string)
+ * ```
+ * @param property name of single property to extract from the `req` object
+ * @param options options object containing additional configuration for the decorator, such as pipes and schema
+ *
+ * @see [Request object](https://docs.nestjs.com/controllers#request-object)
+ * @see [Working with pipes](https://docs.nestjs.com/custom-decorators#working-with-pipes)
+ *
+ * @publicApi
+ */
+export declare function Param(property: string, options: ParameterDecoratorOptions): ParameterDecorator;
+/**
+ * Route handler parameter decorator. Extracts the `params`
+ * property from the `req` object and populates the decorated
+ * parameter with the value of `params`. May also apply pipes to the bound
+ * parameter.
+ *
+ * For example:
+ * ```typescript
+ * findOne(@Param({ schema: z.object({ id: z.string().uuid() }) }) params)
+ * ```
+ *
+ * @param options options object containing additional configuration for the decorator, such as pipes and schema
+ *
+ * @see [Request object](https://docs.nestjs.com/controllers#request-object)
+ * @see [Working with pipes](https://docs.nestjs.com/custom-decorators#working-with-pipes)
+ *
+ * @publicApi
+ */
+export declare function Param(options: ParameterDecoratorOptions): ParameterDecorator;
 /**
  * Route handler parameter decorator. Extracts the `hosts`
  * property from the `req` object and populates the decorated