@nestjs/common 9.0.3 → 9.0.6

package/constants.d.ts

@@ -15,6 +15,10 @@ export declare const OPTIONAL_PROPERTY_DEPS_METADATA = "optional:properties_meta
 export declare const SCOPE_OPTIONS_METADATA = "scope:options";
 export declare const METHOD_METADATA = "method";
 export declare const ROUTE_ARGS_METADATA = "__routeArguments__";
+export declare const CUSTOM_ROUTE_ARGS_METADATA = "__customRouteArgs__";
+/**
+  * @deprecated Use `CUSTOM_ROUTE_ARGS_METADATA` instead
+  */
 export declare const CUSTOM_ROUTE_AGRS_METADATA = "__customRouteArgs__";
 export declare const EXCEPTION_FILTERS_METADATA = "__exceptionFilters__";
 export declare const FILTER_CATCH_EXCEPTIONS = "__filterCatchExceptions__";

package/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CATCH_WATERMARK = exports.CONTROLLER_WATERMARK = exports.INJECTABLE_WATERMARK = exports.VERSION_METADATA = exports.SSE_METADATA = exports.RESPONSE_PASSTHROUGH_METADATA = exports.REDIRECT_METADATA = exports.HEADERS_METADATA = exports.MODULE_PATH = exports.HTTP_CODE_METADATA = exports.INTERCEPTORS_METADATA = exports.RENDER_METADATA = exports.GUARDS_METADATA = exports.PIPES_METADATA = exports.FILTER_CATCH_EXCEPTIONS = exports.EXCEPTION_FILTERS_METADATA = exports.CUSTOM_ROUTE_AGRS_METADATA = exports.ROUTE_ARGS_METADATA = exports.METHOD_METADATA = exports.SCOPE_OPTIONS_METADATA = exports.OPTIONAL_PROPERTY_DEPS_METADATA = exports.PROPERTY_DEPS_METADATA = exports.OPTIONAL_DEPS_METADATA = exports.SELF_DECLARED_DEPS_METADATA = exports.PARAMTYPES_METADATA = exports.PATH_METADATA = exports.HOST_METADATA = exports.GLOBAL_MODULE_METADATA = exports.MODULE_METADATA = void 0;
+exports.CATCH_WATERMARK = exports.CONTROLLER_WATERMARK = exports.INJECTABLE_WATERMARK = exports.VERSION_METADATA = exports.SSE_METADATA = exports.RESPONSE_PASSTHROUGH_METADATA = exports.REDIRECT_METADATA = exports.HEADERS_METADATA = exports.MODULE_PATH = exports.HTTP_CODE_METADATA = exports.INTERCEPTORS_METADATA = exports.RENDER_METADATA = exports.GUARDS_METADATA = exports.PIPES_METADATA = exports.FILTER_CATCH_EXCEPTIONS = exports.EXCEPTION_FILTERS_METADATA = exports.CUSTOM_ROUTE_AGRS_METADATA = exports.CUSTOM_ROUTE_ARGS_METADATA = exports.ROUTE_ARGS_METADATA = exports.METHOD_METADATA = exports.SCOPE_OPTIONS_METADATA = exports.OPTIONAL_PROPERTY_DEPS_METADATA = exports.PROPERTY_DEPS_METADATA = exports.OPTIONAL_DEPS_METADATA = exports.SELF_DECLARED_DEPS_METADATA = exports.PARAMTYPES_METADATA = exports.PATH_METADATA = exports.HOST_METADATA = exports.GLOBAL_MODULE_METADATA = exports.MODULE_METADATA = void 0;
 exports.MODULE_METADATA = {
     IMPORTS: 'imports',
     PROVIDERS: 'providers',
@@ -18,7 +18,11 @@ exports.OPTIONAL_PROPERTY_DEPS_METADATA = 'optional:properties_metadata';
 exports.SCOPE_OPTIONS_METADATA = 'scope:options';
 exports.METHOD_METADATA = 'method';
 exports.ROUTE_ARGS_METADATA = '__routeArguments__';
-exports.CUSTOM_ROUTE_AGRS_METADATA = '__customRouteArgs__';
+exports.CUSTOM_ROUTE_ARGS_METADATA = '__customRouteArgs__';
+/**
+  * @deprecated Use `CUSTOM_ROUTE_ARGS_METADATA` instead
+  */
+exports.CUSTOM_ROUTE_AGRS_METADATA = exports.CUSTOM_ROUTE_ARGS_METADATA;
 exports.EXCEPTION_FILTERS_METADATA = '__exceptionFilters__';
 exports.FILTER_CATCH_EXCEPTIONS = '__filterCatchExceptions__';
 exports.PIPES_METADATA = '__pipes__';

package/file-stream/streamable-file.d.ts

@@ -1,9 +1,14 @@
 /// <reference types="node" />
 import { Readable } from 'stream';
 import { StreamableFileOptions } from './streamable-options.interface';
+export interface StreamableHandlerResponse {
+    statusCode: number;
+    send: (msg: string) => void;
+}
 export declare class StreamableFile {
     readonly options: StreamableFileOptions;
     private readonly stream;
+    protected handleError: (err: Error, response: StreamableHandlerResponse) => void;
     constructor(buffer: Uint8Array, options?: StreamableFileOptions);
     constructor(readable: Readable, options?: StreamableFileOptions);
     getStream(): Readable;
@@ -12,4 +17,6 @@ export declare class StreamableFile {
         disposition: string;
         length: number;
     };
+    get errorHandler(): (err: Error, response: StreamableHandlerResponse) => void;
+    setErrorHandler(handler: (err: Error, response: StreamableHandlerResponse) => void): this;
 }

package/file-stream/streamable-file.js

@@ -9,6 +9,10 @@ class StreamableFile {
         var _a;
         var _b;
         this.options = options;
+        this.handleError = (err, res) => {
+            res.statusCode = 400;
+            res.send(err.message);
+        };
         if (util_1.types.isUint8Array(bufferOrReadStream)) {
             this.stream = new stream_1.Readable();
             this.stream.push(bufferOrReadStream);
@@ -30,5 +34,12 @@ class StreamableFile {
             length,
         };
     }
+    get errorHandler() {
+        return this.handleError;
+    }
+    setErrorHandler(handler) {
+        this.handleError = handler;
+        return this;
+    }
 }
 exports.StreamableFile = StreamableFile;

package/module-utils/configurable-module.builder.js

@@ -5,6 +5,7 @@ const logger_service_1 = require("../services/logger.service");
 const random_string_generator_util_1 = require("../utils/random-string-generator.util");
 const constants_1 = require("./constants");
 const generate_options_injection_token_util_1 = require("./utils/generate-options-injection-token.util");
+const get_injection_providers_util_1 = require("./utils/get-injection-providers.util");
 /**
  * Factory that lets you create configurable modules and
  * provides a way to reduce the majority of dynamic module boilerplate.
@@ -156,6 +157,12 @@ class ConfigurableModuleBuilder {
             }
             static createAsyncProviders(options) {
                 if (options.useExisting || options.useFactory) {
+                    if (options.inject && options.provideInjectionTokensFrom) {
+                        return [
+                            this.createAsyncOptionsProvider(options),
+                            ...(0, get_injection_providers_util_1.getInjectionProviders)(options.provideInjectionTokensFrom, options.inject),
+                        ];
+                    }
                     return [this.createAsyncOptionsProvider(options)];
                 }
                 return [

package/module-utils/interfaces/configurable-module-async-options.interface.d.ts

@@ -1,4 +1,4 @@
-import { FactoryProvider, ModuleMetadata, Type } from '../../interfaces';
+import { FactoryProvider, ModuleMetadata, Provider, Type } from '../../interfaces';
 import { DEFAULT_FACTORY_CLASS_METHOD_KEY } from '../constants';
 /**
  * Interface that must be implemented by the module options factory class.
@@ -28,9 +28,15 @@ export interface ConfigurableModuleAsyncOptions<ModuleOptions, FactoryClassMetho
      * Function returning options (or a Promise resolving to options) to configure the
      * cache module.
      */
-    useFactory?: (...args: unknown[]) => Promise<ModuleOptions> | ModuleOptions;
+    useFactory?: (...args: any[]) => Promise<ModuleOptions> | ModuleOptions;
     /**
      * Dependencies that a Factory may inject.
      */
     inject?: FactoryProvider['inject'];
+    /**
+     * List of parent module's providers that will be filtered to only provide necessary
+     * providers for the 'inject' array
+     * useful to pass options to nested async modules
+     */
+    provideInjectionTokensFrom?: Provider[];
 }

package/module-utils/utils/get-injection-providers.util.d.ts

@@ -0,0 +1,8 @@
+import { Provider, FactoryProvider } from '../../interfaces';
+/**
+ *
+ * @param providers List of a module's providers
+ * @param tokens Injection tokens needed for a useFactory function (usually the module's options' token)
+ * @returns All the providers needed for the tokens' injection (searched recursively)
+ */
+export declare function getInjectionProviders(providers: Provider[], tokens: FactoryProvider['inject']): Provider[];

package/module-utils/utils/get-injection-providers.util.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInjectionProviders = void 0;
+/**
+ * check if x is OptionalFactoryDependency, based on prototype presence
+ * (to avoid classes with a static 'token' field)
+ * @param x
+ * @returns x is OptionalFactoryDependency
+ */
+function isOptionalFactoryDependency(x) {
+    return !!((x === null || x === void 0 ? void 0 : x.token) && !(x === null || x === void 0 ? void 0 : x.prototype));
+}
+const mapInjectToTokens = (t) => isOptionalFactoryDependency(t) ? t.token : t;
+/**
+ *
+ * @param providers List of a module's providers
+ * @param tokens Injection tokens needed for a useFactory function (usually the module's options' token)
+ * @returns All the providers needed for the tokens' injection (searched recursively)
+ */
+function getInjectionProviders(providers, tokens) {
+    const result = [];
+    let search = tokens.map(mapInjectToTokens);
+    while (search.length > 0) {
+        const match = (providers !== null && providers !== void 0 ? providers : []).filter(p => !result.includes(p) && // this prevents circular loops and duplication
+            (search.includes(p) || search.includes(p === null || p === void 0 ? void 0 : p.provide)));
+        result.push(...match);
+        // get injection tokens of the matched providers, if any
+        search = match
+            .filter(p => p === null || p === void 0 ? void 0 : p.inject)
+            .map(p => p.inject)
+            .flat()
+            .map(mapInjectToTokens);
+    }
+    return result;
+}
+exports.getInjectionProviders = getInjectionProviders;

package/package.json

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

package/pipes/file/parse-file-options.interface.d.ts

@@ -4,4 +4,9 @@ export interface ParseFileOptions {
     validators?: FileValidator[];
     errorHttpStatusCode?: ErrorHttpStatusCode;
     exceptionFactory?: (error: string) => any;
+    /**
+     * Defines if file parameter is required.
+     * @default true
+     */
+    fileIsRequired?: boolean;
 }

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

@@ -1,6 +1,6 @@
 import { PipeTransform } from '../../interfaces/features/pipe-transform.interface';
-import { ParseFileOptions } from './parse-file-options.interface';
 import { FileValidator } from './file-validator.interface';
+import { ParseFileOptions } from './parse-file-options.interface';
 /**
  * Defines the built-in ParseFile Pipe. This pipe can be used to validate incoming files
  * with `@UploadedFile()` decorator. You can use either other specific built-in validators
@@ -14,6 +14,7 @@ import { FileValidator } from './file-validator.interface';
 export declare class ParseFilePipe implements PipeTransform<any> {
     protected exceptionFactory: (error: string) => any;
     private readonly validators;
+    private readonly fileIsRequired;
     constructor(options?: ParseFileOptions);
     transform(value: any): Promise<any>;
     protected validate(file: any): Promise<any>;

package/pipes/file/parse-file.pipe.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParseFilePipe = void 0;
 const tslib_1 = require("tslib");
+const shared_utils_1 = require("../../utils/shared.utils");
 const core_1 = require("../../decorators/core");
 const enums_1 = require("../../enums");
 const http_error_by_code_util_1 = require("../../utils/http-error-by-code.util");
@@ -17,13 +18,20 @@ const http_error_by_code_util_1 = require("../../utils/http-error-by-code.util")
  */
 let ParseFilePipe = class ParseFilePipe {
     constructor(options = {}) {
-        const { exceptionFactory, errorHttpStatusCode = enums_1.HttpStatus.BAD_REQUEST, validators = [], } = options;
+        const { exceptionFactory, errorHttpStatusCode = enums_1.HttpStatus.BAD_REQUEST, validators = [], fileIsRequired, } = options;
         this.exceptionFactory =
             exceptionFactory ||
                 (error => new http_error_by_code_util_1.HttpErrorByCode[errorHttpStatusCode](error));
         this.validators = validators;
+        this.fileIsRequired = fileIsRequired !== null && fileIsRequired !== void 0 ? fileIsRequired : true;
     }
     async transform(value) {
+        if ((0, shared_utils_1.isUndefined)(value)) {
+            if (this.fileIsRequired) {
+                throw this.exceptionFactory('File is required');
+            }
+            return value;
+        }
         if (this.validators.length) {
             await this.validate(value);
         }

package/utils/assign-custom-metadata.util.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.assignCustomParameterMetadata = void 0;
 const constants_1 = require("../constants");
 function assignCustomParameterMetadata(args, paramtype, index, factory, data, ...pipes) {
-    return Object.assign(Object.assign({}, args), { [`${paramtype}${constants_1.CUSTOM_ROUTE_AGRS_METADATA}:${index}`]: {
+    return Object.assign(Object.assign({}, args), { [`${paramtype}${constants_1.CUSTOM_ROUTE_ARGS_METADATA}:${index}`]: {
             index,
             factory,
             data,