@depup/nestjs__common 11.2.2-depup.0 → 12.0.1-depup.0

package/decorators/core/use-pipes.decorator.js

@@ -1,10 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UsePipes = UsePipes;
-const constants_1 = require("../../constants");
-const extend_metadata_util_1 = require("../../utils/extend-metadata.util");
-const shared_utils_1 = require("../../utils/shared.utils");
-const validate_each_util_1 = require("../../utils/validate-each.util");
+import { PIPES_METADATA } from '../../constants.js';
+import { extendArrayMetadata } from '../../utils/extend-metadata.util.js';
+import { isFunction } from '../../utils/shared.utils.js';
+import { validateEach } from '../../utils/validate-each.util.js';
 /**
  * Decorator that binds pipes to the scope of the controller or method,
  * depending on its context.
@@ -26,16 +23,16 @@ const validate_each_util_1 = require("../../utils/validate-each.util");
  *
  * @publicApi
  */
-function UsePipes(...pipes) {
+export function UsePipes(...pipes) {
     return (target, key, descriptor) => {
-        const isPipeValid = (pipe) => pipe && ((0, shared_utils_1.isFunction)(pipe) || (0, shared_utils_1.isFunction)(pipe.transform));
+        const isPipeValid = (pipe) => pipe && (isFunction(pipe) || isFunction(pipe.transform));
         if (descriptor) {
-            (0, validate_each_util_1.validateEach)(target.constructor, pipes, isPipeValid, '@UsePipes', 'pipe');
-            (0, extend_metadata_util_1.extendArrayMetadata)(constants_1.PIPES_METADATA, pipes, descriptor.value);
+            validateEach(target.constructor, pipes, isPipeValid, '@UsePipes', 'pipe');
+            extendArrayMetadata(PIPES_METADATA, pipes, descriptor.value);
             return descriptor;
         }
-        (0, validate_each_util_1.validateEach)(target, pipes, isPipeValid, '@UsePipes', 'pipe');
-        (0, extend_metadata_util_1.extendArrayMetadata)(constants_1.PIPES_METADATA, pipes, target);
+        validateEach(target, pipes, isPipeValid, '@UsePipes', 'pipe');
+        extendArrayMetadata(PIPES_METADATA, pipes, target);
         return target;
     };
 }

package/decorators/core/version.decorator.d.ts

@@ -1,4 +1,4 @@
-import { VersionValue } from '../../interfaces/version-options.interface';
+import { VersionValue } from '../../interfaces/version-options.interface.js';
 /**
  * Sets the version of the endpoint to the passed version
  *

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,59 @@
-"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';
+import { isParameterDecoratorOptions } from '../../utils/parameter-decorator-options.util.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 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 argument)
+        const isDataOptions = hasParamData && !isNil(data) && 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;
+            // Merge positional pipes passed after the options object
+            finalPipes = [...(opts.pipes ?? []), ...paramPipes];
+        }
+        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,9 +1,9 @@
-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 './sse-signal.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';
+export * from './sse-signal.decorator.js';

package/decorators/http/index.js

@@ -1,12 +1,9 @@
-"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);
-tslib_1.__exportStar(require("./sse-signal.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';
+export * from './sse-signal.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.QueryMethod = 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 HTTP QUERY requests to the specified path.
  *
@@ -106,7 +102,7 @@ exports.Search = createMappingDecorator(request_method_enum_1.RequestMethod.SEAR
  *
  * @publicApi
  */
-exports.QueryMethod = createMappingDecorator(request_method_enum_1.RequestMethod.QUERY);
+export const QueryMethod = createMappingDecorator(RequestMethod.QUERY);
 /**
  * Route handler (method) Decorator. Routes Webdav PROPFIND requests to the specified path.
  *
@@ -114,7 +110,7 @@ exports.QueryMethod = createMappingDecorator(request_method_enum_1.RequestMethod
  *
  * @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.
  *
@@ -122,7 +118,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.
  *
@@ -130,7 +126,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.
  *
@@ -138,7 +134,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.
  *
@@ -146,7 +142,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.
  *
@@ -154,7 +150,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.
  *
@@ -162,4 +158,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);