@nestjs/common 9.3.0-beta.3 → 9.3.1

package/cache/decorators/cache-ttl.decorator.d.ts

@@ -10,6 +10,6 @@ import { ExecutionContext } from '../../interfaces/features/execution-context.in
  *
  * @publicApi
  */
-declare type CacheTTLFactory = (ctx: ExecutionContext) => Promise<number> | number;
+type CacheTTLFactory = (ctx: ExecutionContext) => Promise<number> | number;
 export declare const CacheTTL: (ttl: number | CacheTTLFactory) => import("../../decorators").CustomDecorator<string>;
 export {};

package/cache/interceptors/cache.interceptor.d.ts

@@ -3,6 +3,11 @@ import { CallHandler, ExecutionContext, HttpServer, NestInterceptor } from '../.
 export interface HttpAdapterHost<T extends HttpServer = any> {
     httpAdapter: T;
 }
+/**
+ * @see [Caching](https://docs.nestjs.com/techniques/caching)
+ *
+ * @publicApi
+ */
 export declare class CacheInterceptor implements NestInterceptor {
     protected readonly cacheManager: any;
     protected readonly reflector: any;

package/cache/interceptors/cache.interceptor.js

@@ -10,6 +10,11 @@ const shared_utils_1 = require("../../utils/shared.utils");
 const cache_constants_1 = require("../cache.constants");
 const HTTP_ADAPTER_HOST = 'HttpAdapterHost';
 const REFLECTOR = 'Reflector';
+/**
+ * @see [Caching](https://docs.nestjs.com/techniques/caching)
+ *
+ * @publicApi
+ */
 let CacheInterceptor = class CacheInterceptor {
     constructor(cacheManager, reflector) {
         this.cacheManager = cacheManager;

package/cache/interfaces/cache-manager.interface.d.ts

@@ -40,7 +40,7 @@ export interface CacheStoreSetOptions<T> {
  *
  * @publicApi
  */
-export interface CacheStoreFactory {
+export type CacheStoreFactory = {
     /**
      * Return a configured cache store.
      *
@@ -48,7 +48,7 @@ export interface CacheStoreFactory {
      * or `CacheModule.registerAsync()`
      */
     create(args: LiteralObject): CacheStore;
-}
+} | ((args: LiteralObject) => CacheStore | Promise<CacheStore>);
 /**
  * Interface defining Cache Manager configuration options.
  *

package/cache/interfaces/cache-module.interface.d.ts

@@ -1,7 +1,7 @@
 import { Provider, Type } from '../../interfaces';
 import { ConfigurableModuleAsyncOptions } from '../../module-utils';
 import { CacheManagerOptions } from './cache-manager.interface';
-export declare type CacheModuleOptions<StoreConfig extends Record<any, any> = Record<string, any>> = CacheManagerOptions & StoreConfig & {
+export type CacheModuleOptions<StoreConfig extends Record<any, any> = Record<string, any>> = CacheManagerOptions & StoreConfig & {
     /**
      * If "true', register `CacheModule` as a global module.
      */

package/constants.d.ts

@@ -31,7 +31,7 @@ export declare const ENHANCER_KEY_TO_SUBTYPE_MAP: {
     readonly __pipes__: "pipe";
     readonly __exceptionFilters__: "filter";
 };
-export declare type EnhancerSubtype = typeof ENHANCER_KEY_TO_SUBTYPE_MAP[keyof typeof ENHANCER_KEY_TO_SUBTYPE_MAP];
+export type EnhancerSubtype = typeof ENHANCER_KEY_TO_SUBTYPE_MAP[keyof typeof ENHANCER_KEY_TO_SUBTYPE_MAP];
 export declare const RENDER_METADATA = "__renderTemplate__";
 export declare const HTTP_CODE_METADATA = "__httpCode__";
 export declare const MODULE_PATH = "__module_path__";

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

@@ -1,5 +1,7 @@
 export declare function flatten<T extends Array<unknown> = any>(arr: T): T extends Array<infer R> ? R : never;
 /**
  * Decorator that sets required dependencies (required with a vanilla JavaScript objects)
+ *
+ * @publicApi
  */
 export declare const Dependencies: (...dependencies: Array<unknown>) => ClassDecorator;

package/decorators/core/dependencies.decorator.js

@@ -9,6 +9,8 @@ function flatten(arr) {
 exports.flatten = flatten;
 /**
  * Decorator that sets required dependencies (required with a vanilla JavaScript objects)
+ *
+ * @publicApi
  */
 const Dependencies = (...dependencies) => {
     const flattenDeps = flatten(dependencies);

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

@@ -27,4 +27,4 @@
  *
  * @publicApi
  */
-export declare function Inject<T = any>(token?: T): (target: object, key: string | symbol, index?: number) => void;
+export declare function Inject<T = any>(token?: T): (target: object, key: string | symbol | undefined, index?: number) => void;

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

@@ -7,7 +7,7 @@ import { Type } from '../../interfaces/type.interface';
  *
  * @publicApi
  */
-export declare type InjectableOptions = ScopeOptions;
+export type InjectableOptions = ScopeOptions;
 /**
  * Decorator that marks a class as a [provider](https://docs.nestjs.com/providers).
  * Providers can be injected into other classes via constructor parameter injection
@@ -37,4 +37,7 @@ export declare type InjectableOptions = ScopeOptions;
  * @publicApi
  */
 export declare function Injectable(options?: InjectableOptions): ClassDecorator;
+/**
+ * @publicApi
+ */
 export declare function mixin<T>(mixinClass: Type<T>): Type<T>;

package/decorators/core/injectable.decorator.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.mixin = exports.Injectable = void 0;
-const uuid_1 = require("uuid");
+const uid_1 = require("uid");
 const constants_1 = require("../../constants");
 /**
  * Decorator that marks a class as a [provider](https://docs.nestjs.com/providers).
@@ -38,9 +38,12 @@ function Injectable(options) {
     };
 }
 exports.Injectable = Injectable;
+/**
+ * @publicApi
+ */
 function mixin(mixinClass) {
     Object.defineProperty(mixinClass, 'name', {
-        value: (0, uuid_1.v4)(),
+        value: (0, uid_1.uid)(21),
     });
     Injectable()(mixinClass);
     return mixinClass;

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

@@ -11,4 +11,4 @@
  *
  * @publicApi
  */
-export declare function Optional(): (target: object, key: string | symbol, index?: number) => void;
+export declare function Optional(): (target: object, key: string | symbol | undefined, index?: number) => void;

package/decorators/core/set-metadata.decorator.d.ts

@@ -1,4 +1,4 @@
-export declare type CustomDecorator<TKey = string> = MethodDecorator & ClassDecorator & {
+export type CustomDecorator<TKey = string> = MethodDecorator & ClassDecorator & {
     KEY: TKey;
 };
 /**

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

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

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createParamDecorator = void 0;
-const uuid_1 = require("uuid");
+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");
@@ -9,9 +9,11 @@ const shared_utils_1 = require("../../utils/shared.utils");
  * Defines HTTP route param decorator
  *
  * @param factory
+ *
+ * @publicApi
  */
 function createParamDecorator(factory, enhancers = []) {
-    const paramtype = (0, uuid_1.v4)();
+    const paramtype = (0, uid_1.uid)(21);
     return (data, ...pipes) => (target, key, index) => {
         const args = Reflect.getMetadata(constants_1.ROUTE_ARGS_METADATA, target.constructor, key) || {};
         const isPipe = (pipe) => pipe &&

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

@@ -13,7 +13,7 @@ export interface ResponseDecoratorOptions {
      */
     passthrough: boolean;
 }
-export declare type ParamData = object | string | number;
+export type ParamData = object | string | number;
 export interface RouteParamMetadata {
     index: number;
     data?: ParamData;

package/enums/http-status.enum.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @publicApi
+ */
 export declare enum HttpStatus {
     CONTINUE = 100,
     SWITCHING_PROTOCOLS = 101,

package/enums/http-status.enum.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HttpStatus = void 0;
+/**
+ * @publicApi
+ */
 var HttpStatus;
 (function (HttpStatus) {
     HttpStatus[HttpStatus["CONTINUE"] = 100] = "CONTINUE";

package/exceptions/http.exception.js

@@ -76,6 +76,7 @@ class HttpException extends Error {
         }
     }
     initMessage() {
+        var _a, _b;
         if ((0, shared_utils_1.isString)(this.response)) {
             this.message = this.response;
         }
@@ -84,9 +85,8 @@ class HttpException extends Error {
             this.message = this.response.message;
         }
         else if (this.constructor) {
-            this.message = this.constructor.name
-                .match(/[A-Z][a-z]+|[0-9]+/g)
-                .join(' ');
+            this.message = (_b = (_a = this.constructor.name
+                .match(/[A-Z][a-z]+|[0-9]+/g)) === null || _a === void 0 ? void 0 : _a.join(' ')) !== null && _b !== void 0 ? _b : 'Error';
         }
     }
     initName() {

package/file-stream/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from './streamable-options.interface';
+export * from './streamable-handler-response.interface';

package/file-stream/interfaces/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./streamable-options.interface"), exports);
+tslib_1.__exportStar(require("./streamable-handler-response.interface"), exports);

package/file-stream/interfaces/streamable-handler-response.interface.d.ts

@@ -0,0 +1,12 @@
+export interface StreamableHandlerResponse {
+    /** `true` if the connection is destroyed, `false` otherwise. */
+    destroyed: boolean;
+    /** `true` if headers were sent, `false` otherwise. */
+    headersSent: boolean;
+    /** The status code that will be sent to the client when the headers get flushed. */
+    statusCode: number;
+    /** Sends the HTTP response. */
+    send: (body: string) => void;
+    /** Signals to the server that all of the response headers and body have been sent. */
+    end: () => void;
+}

package/file-stream/{streamable-options.interface.d.ts → interfaces/streamable-options.interface.d.ts}

@@ -1,3 +1,8 @@
+/**
+ * Options for `StreamableFile`
+ *
+ * @publicApi
+ */
 export interface StreamableFileOptions {
     type?: string;
     disposition?: string;

package/file-stream/interfaces/streamable-options.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,11 +1,11 @@
 /// <reference types="node" />
 import { Readable } from 'stream';
-import { StreamableFileOptions } from './streamable-options.interface';
-export interface StreamableHandlerResponse {
-    destroyed: boolean;
-    statusCode: number;
-    send: (msg: string) => void;
-}
+import { StreamableFileOptions, StreamableHandlerResponse } from './interfaces';
+/**
+ * @see [Streaming files](https://docs.nestjs.com/techniques/streaming-files)
+ *
+ * @publicApi
+ */
 export declare class StreamableFile {
     readonly options: StreamableFileOptions;
     private readonly stream;

package/file-stream/streamable-file.js

@@ -3,17 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StreamableFile = void 0;
 const stream_1 = require("stream");
 const util_1 = require("util");
+const enums_1 = require("../enums");
 const shared_utils_1 = require("../utils/shared.utils");
+/**
+ * @see [Streaming files](https://docs.nestjs.com/techniques/streaming-files)
+ *
+ * @publicApi
+ */
 class StreamableFile {
     constructor(bufferOrReadStream, options = {}) {
         var _a;
         var _b;
         this.options = options;
         this.handleError = (err, res) => {
-            if (!res.destroyed) {
-                res.statusCode = 400;
-                res.send(err.message);
+            if (res.destroyed) {
+                return;
             }
+            if (res.headersSent) {
+                res.end();
+                return;
+            }
+            res.statusCode = enums_1.HttpStatus.BAD_REQUEST;
+            res.send(err.message);
         };
         if (util_1.types.isUint8Array(bufferOrReadStream)) {
             this.stream = new stream_1.Readable();

package/interfaces/controllers/controller.interface.d.ts

@@ -1 +1 @@
-export declare type Controller = object;
+export type Controller = object;

package/interfaces/external/cors-options.interface.d.ts

@@ -1,4 +1,4 @@
-declare type StaticOrigin = boolean | string | RegExp | (string | RegExp)[];
+type StaticOrigin = boolean | string | RegExp | (string | RegExp)[];
 /**
  * Set origin to a function implementing some custom logic. The function takes the
  * request origin as the first parameter and a callback (which expects the signature
@@ -8,7 +8,7 @@ declare type StaticOrigin = boolean | string | RegExp | (string | RegExp)[];
  *
  * @publicApi
  */
-export declare type CustomOrigin = (requestOrigin: string, callback: (err: Error | null, origin?: StaticOrigin) => void) => void;
+export type CustomOrigin = (requestOrigin: string, callback: (err: Error | null, origin?: StaticOrigin) => void) => void;
 /**
  * Interface describing CORS options that can be set.
  *

package/interfaces/features/arguments-host.interface.d.ts

@@ -1,4 +1,4 @@
-export declare type ContextType = 'http' | 'ws' | 'rpc';
+export type ContextType = 'http' | 'ws' | 'rpc';
 /**
  * Methods to obtain request and response objects.
  *

package/interfaces/features/custom-route-param-factory.interface.d.ts

@@ -1 +1,4 @@
-export declare type CustomParamFactory<TData = any, TInput = any, TOutput = any> = (data: TData, input: TInput) => TOutput;
+/**
+ * @publicApi
+ */
+export type CustomParamFactory<TData = any, TInput = any, TOutput = any> = (data: TData, input: TInput) => TOutput;

package/interfaces/features/paramtype.interface.d.ts

@@ -1 +1,4 @@
-export declare type Paramtype = 'body' | 'query' | 'param' | 'custom';
+/**
+ * @publicApi
+ */
+export type Paramtype = 'body' | 'query' | 'param' | 'custom';

package/interfaces/features/pipe-transform.interface.d.ts

@@ -1,6 +1,6 @@
 import { Type } from '../type.interface';
 import { Paramtype } from './paramtype.interface';
-export declare type Transform<T = any> = (value: T, metadata: ArgumentMetadata) => any;
+export type Transform<T = any> = (value: T, metadata: ArgumentMetadata) => any;
 /**
  * Interface describing a pipe implementation's `transform()` method metadata argument.
  *

package/interfaces/http/http-server.interface.d.ts

@@ -2,11 +2,12 @@ import { RequestMethod } from '../../enums';
 import { CorsOptions, CorsOptionsDelegate } from '../../interfaces/external/cors-options.interface';
 import { NestApplicationOptions } from '../../interfaces/nest-application-options.interface';
 import { VersioningOptions, VersionValue } from '../version-options.interface';
-export declare type ErrorHandler<TRequest = any, TResponse = any> = (error: any, req: TRequest, res: TResponse, next?: Function) => any;
-export declare type RequestHandler<TRequest = any, TResponse = any> = (req: TRequest, res: TResponse, next?: Function) => any;
+export type ErrorHandler<TRequest = any, TResponse = any> = (error: any, req: TRequest, res: TResponse, next?: Function) => any;
+export type RequestHandler<TRequest = any, TResponse = any> = (req: TRequest, res: TResponse, next?: Function) => any;
 export interface HttpServer<TRequest = any, TResponse = any> {
     use(handler: RequestHandler<TRequest, TResponse> | ErrorHandler<TRequest, TResponse>): any;
     use(path: string, handler: RequestHandler<TRequest, TResponse> | ErrorHandler<TRequest, TResponse>): any;
+    useBodyParser?(...args: any[]): any;
     get(handler: RequestHandler<TRequest, TResponse>): any;
     get(path: string, handler: RequestHandler<TRequest, TResponse>): any;
     post(handler: RequestHandler<TRequest, TResponse>): any;

package/interfaces/http/raw-body-request.interface.d.ts

@@ -1,4 +1,7 @@
 /// <reference types="node" />
-export declare type RawBodyRequest<T> = T & {
+/**
+ * @publicApi
+ */
+export type RawBodyRequest<T> = T & {
     rawBody?: Buffer;
 };

package/interfaces/injectable.interface.d.ts

@@ -1 +1 @@
-export declare type Injectable = unknown;
+export type Injectable = unknown;

package/interfaces/microservices/nest-hybrid-application-options.interface.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @publicApi
+ */
 export interface NestHybridApplicationOptions {
     inheritAppConfig?: boolean;
 }

package/interfaces/microservices/nest-microservice-options.interface.d.ts

@@ -1,2 +1,5 @@
 import { NestApplicationContextOptions } from '../nest-application-context-options.interface';
-export declare type NestMicroserviceOptions = NestApplicationContextOptions;
+/**
+ * @publicApi
+ */
+export type NestMicroserviceOptions = NestApplicationContextOptions;

package/interfaces/middleware/middleware-config-proxy.interface.d.ts

@@ -1,6 +1,9 @@
 import { Type } from '../type.interface';
 import { RouteInfo } from './middleware-configuration.interface';
 import { MiddlewareConsumer } from './middleware-consumer.interface';
+/**
+ * @publicApi
+ */
 export interface MiddlewareConfigProxy {
     /**
      * Excludes routes from the currently processed middleware.

package/interfaces/middleware/nest-middleware.interface.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @see [Middleware](https://docs.nestjs.com/middleware)
+ *
+ * @publicApi
+ */
 export interface NestMiddleware<TRequest = any, TResponse = any> {
     use(req: TRequest, res: TResponse, next: (error?: Error | any) => void): any;
 }

package/interfaces/modules/injection-token.interface.d.ts

@@ -1,3 +1,6 @@
 import { Abstract } from '../abstract.interface';
 import { Type } from '../type.interface';
-export declare type InjectionToken = string | symbol | Type<any> | Abstract<any> | Function;
+/**
+ * @publicApi
+ */
+export type InjectionToken = string | symbol | Type<any> | Abstract<any> | Function;

package/interfaces/modules/nest-module.interface.d.ts

@@ -1,4 +1,7 @@
 import { MiddlewareConsumer } from '../middleware/middleware-consumer.interface';
+/**
+ * @publicApi
+ */
 export interface NestModule {
     configure(consumer: MiddlewareConsumer): any;
 }

package/interfaces/modules/optional-factory-dependency.interface.d.ts

@@ -1,5 +1,8 @@
 import { InjectionToken } from './injection-token.interface';
-export declare type OptionalFactoryDependency = {
+/**
+ * @publicApi
+ */
+export type OptionalFactoryDependency = {
     token: InjectionToken;
     optional: boolean;
 };

package/interfaces/modules/provider.interface.d.ts

@@ -6,7 +6,7 @@ import { OptionalFactoryDependency } from './optional-factory-dependency.interfa
  *
  * @publicApi
  */
-export declare type Provider<T = any> = Type<any> | ClassProvider<T> | ValueProvider<T> | FactoryProvider<T> | ExistingProvider<T>;
+export type Provider<T = any> = Type<any> | ClassProvider<T> | ValueProvider<T> | FactoryProvider<T> | ExistingProvider<T>;
 /**
  * Interface defining a *Class* type provider.
  *

package/interfaces/version-options.interface.d.ts

@@ -5,7 +5,10 @@ import { VersioningType } from '../enums/version-type.enum';
  * @publicApi
  */
 export declare const VERSION_NEUTRAL: unique symbol;
-export declare type VersionValue = string | typeof VERSION_NEUTRAL | Array<string | typeof VERSION_NEUTRAL>;
+/**
+ * @publicApi
+ */
+export type VersionValue = string | typeof VERSION_NEUTRAL | Array<string | typeof VERSION_NEUTRAL>;
 /**
  * @publicApi
  */
@@ -21,6 +24,9 @@ export interface VersionOptions {
      */
     version?: VersionValue;
 }
+/**
+ * @publicApi
+ */
 export interface HeaderVersioningOptions {
     type: VersioningType.HEADER;
     /**
@@ -28,6 +34,9 @@ export interface HeaderVersioningOptions {
      */
     header: string;
 }
+/**
+ * @publicApi
+ */
 export interface UriVersioningOptions {
     type: VersioningType.URI;
     /**
@@ -39,6 +48,9 @@ export interface UriVersioningOptions {
      */
     prefix?: string | false;
 }
+/**
+ * @publicApi
+ */
 export interface MediaTypeVersioningOptions {
     type: VersioningType.MEDIA_TYPE;
     /**
@@ -48,6 +60,9 @@ export interface MediaTypeVersioningOptions {
      */
     key: string;
 }
+/**
+ * @publicApi
+ */
 export interface CustomVersioningOptions {
     type: VersioningType.CUSTOM;
     /**
@@ -60,6 +75,9 @@ export interface CustomVersioningOptions {
      */
     extractor: (request: unknown) => string | string[];
 }
+/**
+ * @publicApi
+ */
 interface VersioningCommonOptions {
     /**
      * The default version to be used as a fallback when you did not provide some
@@ -70,5 +88,5 @@ interface VersioningCommonOptions {
 /**
  * @publicApi
  */
-export declare type VersioningOptions = VersioningCommonOptions & (HeaderVersioningOptions | UriVersioningOptions | MediaTypeVersioningOptions | CustomVersioningOptions);
+export type VersioningOptions = VersioningCommonOptions & (HeaderVersioningOptions | UriVersioningOptions | MediaTypeVersioningOptions | CustomVersioningOptions);
 export {};

package/interfaces/websockets/web-socket-adapter.interface.d.ts

@@ -1,8 +1,14 @@
 import { Observable } from 'rxjs';
+/**
+ * @publicApi
+ */
 export interface WsMessageHandler<T = string> {
     message: T;
     callback: (...args: any[]) => Observable<any> | Promise<any>;
 }
+/**
+ * @publicApi
+ */
 export interface WebSocketAdapter<TServer = any, TClient = any, TOptions = any> {
     create(port: number, options?: TOptions): TServer;
     bindClientConnect(server: TServer, callback: Function): any;

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

@@ -6,7 +6,7 @@ import { DEFAULT_FACTORY_CLASS_METHOD_KEY } from '../constants';
  *
  * @publicApi
  */
-export declare type ConfigurableModuleOptionsFactory<ModuleOptions, FactoryClassMethodKey extends string> = Record<`${FactoryClassMethodKey}`, () => Promise<ModuleOptions> | ModuleOptions>;
+export type ConfigurableModuleOptionsFactory<ModuleOptions, FactoryClassMethodKey extends string> = Record<`${FactoryClassMethodKey}`, () => Promise<ModuleOptions> | ModuleOptions>;
 /**
  * Interface that represents the module async options object
  * Factory method name varies depending on the "FactoryClassMethodKey" type argument.

package/module-utils/interfaces/configurable-module-cls.interface.d.ts

@@ -8,6 +8,6 @@ import { ConfigurableModuleAsyncOptions } from './configurable-module-async-opti
  *
  * @publicApi
  */
-export declare type ConfigurableModuleCls<ModuleOptions, MethodKey extends string = typeof DEFAULT_METHOD_KEY, FactoryClassMethodKey extends string = typeof DEFAULT_FACTORY_CLASS_METHOD_KEY, ExtraModuleDefinitionOptions = {}> = {
+export type ConfigurableModuleCls<ModuleOptions, MethodKey extends string = typeof DEFAULT_METHOD_KEY, FactoryClassMethodKey extends string = typeof DEFAULT_FACTORY_CLASS_METHOD_KEY, ExtraModuleDefinitionOptions = {}> = {
     new (): any;
 } & Record<`${MethodKey}`, (options: ModuleOptions & Partial<ExtraModuleDefinitionOptions>) => DynamicModule> & Record<`${MethodKey}Async`, (options: ConfigurableModuleAsyncOptions<ModuleOptions, FactoryClassMethodKey> & Partial<ExtraModuleDefinitionOptions>) => DynamicModule>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/common",
-  "version": "9.3.0-beta.3",
+  "version": "9.3.1",
   "description": "Nest - modern, fast, powerful node.js web framework (@common)",
   "author": "Kamil Mysliwiec",
   "homepage": "https://nestjs.com",
@@ -19,7 +19,7 @@
   "dependencies": {
     "iterare": "1.2.1",
     "tslib": "2.4.1",
-    "uuid": "9.0.0"
+    "uid": "2.0.1"
   },
   "peerDependencies": {
     "cache-manager": "<=5",

package/pipes/file/file-type.validator.d.ts

@@ -1,5 +1,5 @@
 import { FileValidator } from './file-validator.interface';
-export declare type FileTypeValidatorOptions = {
+export type FileTypeValidatorOptions = {
     fileType: string | RegExp;
 };
 /**

package/pipes/file/file-validator.interface.d.ts

@@ -1,5 +1,7 @@
 /**
  * Interface describing FileValidators, which can be added to a {@link ParseFilePipe}.
+ *
+ * @publicApi
  */
 export declare abstract class FileValidator<TValidationOptions = Record<string, any>> {
     protected readonly validationOptions: TValidationOptions;

package/pipes/file/file-validator.interface.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileValidator = void 0;
 /**
  * Interface describing FileValidators, which can be added to a {@link ParseFilePipe}.
+ *
+ * @publicApi
  */
 class FileValidator {
     constructor(validationOptions) {

package/pipes/file/max-file-size.validator.d.ts

@@ -1,5 +1,5 @@
 import { FileValidator } from './file-validator.interface';
-export declare type MaxFileSizeValidatorOptions = {
+export type MaxFileSizeValidatorOptions = {
     maxSize: number;
 };
 /**

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

@@ -1,5 +1,8 @@
 import { ErrorHttpStatusCode } from '../../utils/http-error-by-code.util';
 import { FileValidator } from './file-validator.interface';
+/**
+ * @publicApi
+ */
 export interface ParseFileOptions {
     validators?: FileValidator[];
     errorHttpStatusCode?: ErrorHttpStatusCode;

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

@@ -3,6 +3,9 @@ import { FileValidator } from './file-validator.interface';
 import { MaxFileSizeValidatorOptions } from './max-file-size.validator';
 import { ParseFileOptions } from './parse-file-options.interface';
 import { ParseFilePipe } from './parse-file.pipe';
+/**
+ * @publicApi
+ */
 export declare class ParseFilePipeBuilder {
     private validators;
     addMaxSizeValidator(options: MaxFileSizeValidatorOptions): this;

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

@@ -4,6 +4,9 @@ exports.ParseFilePipeBuilder = void 0;
 const file_type_validator_1 = require("./file-type.validator");
 const max_file_size_validator_1 = require("./max-file-size.validator");
 const parse_file_pipe_1 = require("./parse-file.pipe");
+/**
+ * @publicApi
+ */
 class ParseFilePipeBuilder {
     constructor() {
         this.validators = [];

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

@@ -17,6 +17,8 @@ export declare class ParseFilePipe implements PipeTransform<any> {
     private readonly fileIsRequired;
     constructor(options?: ParseFileOptions);
     transform(value: any): Promise<any>;
+    private validateFiles;
+    private thereAreNoFilesIn;
     protected validate(file: any): Promise<any>;
     private validateOrThrow;
     /**

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

@@ -2,10 +2,10 @@
 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");
+const shared_utils_1 = require("../../utils/shared.utils");
 /**
  * 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
@@ -26,17 +26,30 @@ let ParseFilePipe = class ParseFilePipe {
         this.fileIsRequired = fileIsRequired !== null && fileIsRequired !== void 0 ? fileIsRequired : true;
     }
     async transform(value) {
-        if ((0, shared_utils_1.isUndefined)(value)) {
+        if (this.thereAreNoFilesIn(value)) {
             if (this.fileIsRequired) {
                 throw this.exceptionFactory('File is required');
             }
             return value;
         }
         if (this.validators.length) {
-            await this.validate(value);
+            if (Array.isArray(value)) {
+                await this.validateFiles(value);
+            }
+            else {
+                await this.validate(value);
+            }
         }
         return value;
     }
+    validateFiles(files) {
+        return Promise.all(files.map(f => this.validate(f)));
+    }
+    thereAreNoFilesIn(value) {
+        const isEmptyArray = Array.isArray(value) && (0, shared_utils_1.isEmpty)(value);
+        const isEmptyObject = (0, shared_utils_1.isObject)(value) && (0, shared_utils_1.isEmpty)(Object.keys(value));
+        return (0, shared_utils_1.isUndefined)(value) || isEmptyArray || isEmptyObject;
+    }
     async validate(file) {
         for (const validator of this.validators) {
             await this.validateOrThrow(file, validator);

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

@@ -1,6 +1,9 @@
 import { Type } from '../interfaces';
 import { ArgumentMetadata, PipeTransform } from '../interfaces/features/pipe-transform.interface';
 import { ValidationPipe, ValidationPipeOptions } from './validation.pipe';
+/**
+ * @publicApi
+ */
 export interface ParseArrayOptions extends Omit<ValidationPipeOptions, 'transform' | 'validateCustomDecorators' | 'exceptionFactory'> {
     items?: Type<unknown>;
     separator?: string;

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

@@ -1,5 +1,8 @@
 import { ArgumentMetadata, PipeTransform } from '../interfaces/features/pipe-transform.interface';
 import { ErrorHttpStatusCode } from '../utils/http-error-by-code.util';
+/**
+ * @publicApi
+ */
 export interface ParseBoolPipeOptions {
     errorHttpStatusCode?: ErrorHttpStatusCode;
     exceptionFactory?: (error: string) => any;

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

@@ -1,6 +1,9 @@
 import { ArgumentMetadata } from '../index';
 import { PipeTransform } from '../interfaces/features/pipe-transform.interface';
 import { ErrorHttpStatusCode } from '../utils/http-error-by-code.util';
+/**
+ * @publicApi
+ */
 export interface ParseEnumPipeOptions {
     errorHttpStatusCode?: ErrorHttpStatusCode;
     exceptionFactory?: (error: string) => any;

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

@@ -1,6 +1,9 @@
 import { ArgumentMetadata } from '../index';
 import { PipeTransform } from '../interfaces/features/pipe-transform.interface';
 import { ErrorHttpStatusCode } from '../utils/http-error-by-code.util';
+/**
+ * @publicApi
+ */
 export interface ParseFloatPipeOptions {
     errorHttpStatusCode?: ErrorHttpStatusCode;
     exceptionFactory?: (error: string) => any;

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

@@ -1,5 +1,8 @@
 import { ArgumentMetadata, PipeTransform } from '../interfaces/features/pipe-transform.interface';
 import { ErrorHttpStatusCode } from '../utils/http-error-by-code.util';
+/**
+ * @publicApi
+ */
 export interface ParseIntPipeOptions {
     errorHttpStatusCode?: ErrorHttpStatusCode;
     exceptionFactory?: (error: string) => any;

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

@@ -1,10 +1,20 @@
 import { ArgumentMetadata, PipeTransform } from '../interfaces/features/pipe-transform.interface';
 import { ErrorHttpStatusCode } from '../utils/http-error-by-code.util';
+/**
+ * @publicApi
+ */
 export interface ParseUUIDPipeOptions {
     version?: '3' | '4' | '5';
     errorHttpStatusCode?: ErrorHttpStatusCode;
     exceptionFactory?: (errors: string) => any;
 }
+/**
+ * Defines the built-in ParseUUID Pipe
+ *
+ * @see [Built-in Pipes](https://docs.nestjs.com/pipes#built-in-pipes)
+ *
+ * @publicApi
+ */
 export declare class ParseUUIDPipe implements PipeTransform<string> {
     protected static uuidRegExps: {
         3: RegExp;

package/pipes/parse-uuid.pipe.js

@@ -8,6 +8,13 @@ const optional_decorator_1 = require("../decorators/core/optional.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");
+/**
+ * Defines the built-in ParseUUID Pipe
+ *
+ * @see [Built-in Pipes](https://docs.nestjs.com/pipes#built-in-pipes)
+ *
+ * @publicApi
+ */
 let ParseUUIDPipe = ParseUUIDPipe_1 = class ParseUUIDPipe {
     constructor(options) {
         options = options || {};

package/pipes/validation.pipe.d.ts

@@ -6,6 +6,9 @@ import { ValidatorPackage } from '../interfaces/external/validator-package.inter
 import { ArgumentMetadata, PipeTransform } from '../interfaces/features/pipe-transform.interface';
 import { Type } from '../interfaces/type.interface';
 import { ErrorHttpStatusCode } from '../utils/http-error-by-code.util';
+/**
+ * @publicApi
+ */
 export interface ValidationPipeOptions extends ValidatorOptions {
     transform?: boolean;
     disableErrorMessages?: boolean;
@@ -17,6 +20,11 @@ export interface ValidationPipeOptions extends ValidatorOptions {
     validatorPackage?: ValidatorPackage;
     transformerPackage?: TransformerPackage;
 }
+/**
+ * @see [Validation](https://docs.nestjs.com/techniques/validation)
+ *
+ * @publicApi
+ */
 export declare class ValidationPipe implements PipeTransform<any> {
     protected isTransformEnabled: boolean;
     protected isDetailedOutputDisabled?: boolean;

package/pipes/validation.pipe.js

@@ -12,6 +12,11 @@ const load_package_util_1 = require("../utils/load-package.util");
 const shared_utils_1 = require("../utils/shared.utils");
 let classValidator = {};
 let classTransformer = {};
+/**
+ * @see [Validation](https://docs.nestjs.com/techniques/validation)
+ *
+ * @publicApi
+ */
 let ValidationPipe = class ValidationPipe {
     constructor(options) {
         options = options || {};

package/serializer/class-serializer.interceptor.d.ts

@@ -6,9 +6,15 @@ import { TransformerPackage } from '../interfaces/external/transformer-package.i
 export interface PlainLiteralObject {
     [key: string]: any;
 }
+/**
+ * @publicApi
+ */
 export interface ClassSerializerInterceptorOptions extends ClassTransformOptions {
     transformerPackage?: TransformerPackage;
 }
+/**
+ * @publicApi
+ */
 export declare class ClassSerializerInterceptor implements NestInterceptor {
     protected readonly reflector: any;
     protected readonly defaultOptions: ClassSerializerInterceptorOptions;

package/serializer/class-serializer.interceptor.js

@@ -13,6 +13,9 @@ let classTransformer = {};
 // We need to deduplicate them here due to the circular dependency
 // between core and common packages
 const REFLECTOR = 'Reflector';
+/**
+ * @publicApi
+ */
 let ClassSerializerInterceptor = class ClassSerializerInterceptor {
     constructor(reflector, defaultOptions = {}) {
         var _a;

package/serializer/class-serializer.interfaces.d.ts

@@ -1,5 +1,8 @@
 import { ClassTransformOptions } from '../interfaces/external/class-transform-options.interface';
 import { Type } from '../interfaces';
+/**
+ * @publicApi
+ */
 export interface ClassSerializerContextOptions extends ClassTransformOptions {
     type?: Type<any>;
 }

package/serializer/decorators/serialize-options.decorator.d.ts

@@ -1,2 +1,5 @@
 import { ClassSerializerContextOptions } from '../class-serializer.interfaces';
+/**
+ * @publicApi
+ */
 export declare const SerializeOptions: (options: ClassSerializerContextOptions) => import("../../decorators").CustomDecorator<string>;

package/serializer/decorators/serialize-options.decorator.js

@@ -3,5 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SerializeOptions = void 0;
 const decorators_1 = require("../../decorators");
 const class_serializer_constants_1 = require("../class-serializer.constants");
+/**
+ * @publicApi
+ */
 const SerializeOptions = (options) => (0, decorators_1.SetMetadata)(class_serializer_constants_1.CLASS_SERIALIZER_OPTIONS, options);
 exports.SerializeOptions = SerializeOptions;

package/services/console-logger.service.js

@@ -14,6 +14,14 @@ const DEFAULT_LOG_LEVELS = [
     'debug',
     'verbose',
 ];
+const dateTimeFormatter = new Intl.DateTimeFormat(undefined, {
+    year: 'numeric',
+    hour: 'numeric',
+    minute: 'numeric',
+    second: 'numeric',
+    day: '2-digit',
+    month: '2-digit',
+});
 let ConsoleLogger = ConsoleLogger_1 = class ConsoleLogger {
     constructor(context, options = {}) {
         this.context = context;
@@ -102,15 +110,7 @@ let ConsoleLogger = ConsoleLogger_1 = class ConsoleLogger {
         return (0, utils_1.isLogLevelEnabled)(level, logLevels);
     }
     getTimestamp() {
-        const localeStringOptions = {
-            year: 'numeric',
-            hour: 'numeric',
-            minute: 'numeric',
-            second: 'numeric',
-            day: '2-digit',
-            month: '2-digit',
-        };
-        return new Date(Date.now()).toLocaleString(undefined, localeStringOptions);
+        return dateTimeFormatter.format(Date.now());
     }
     printMessages(messages, context = '', logLevel = 'log', writeStreamType) {
         messages.forEach(message => {

package/services/logger.service.d.ts

@@ -1,4 +1,10 @@
-export declare type LogLevel = 'log' | 'error' | 'warn' | 'debug' | 'verbose';
+/**
+ * @publicApi
+ */
+export type LogLevel = 'log' | 'error' | 'warn' | 'debug' | 'verbose';
+/**
+ * @publicApi
+ */
 export interface LoggerService {
     /**
      * Write a 'log' level log.
@@ -36,6 +42,9 @@ interface LogBufferRecord {
      */
     arguments: unknown[];
 }
+/**
+ * @publicApi
+ */
 export declare class Logger implements LoggerService {
     protected context?: string;
     protected options: {

package/services/logger.service.js

@@ -3,12 +3,22 @@ var Logger_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Logger = void 0;
 const tslib_1 = require("tslib");
-const injectable_decorator_1 = require("../decorators/core/injectable.decorator");
-const optional_decorator_1 = require("../decorators/core/optional.decorator");
+const core_1 = require("../decorators/core");
 const shared_utils_1 = require("../utils/shared.utils");
 const console_logger_service_1 = require("./console-logger.service");
 const utils_1 = require("./utils");
 const DEFAULT_LOGGER = new console_logger_service_1.ConsoleLogger();
+const dateTimeFormatter = new Intl.DateTimeFormat(undefined, {
+    year: 'numeric',
+    hour: 'numeric',
+    minute: 'numeric',
+    second: 'numeric',
+    day: '2-digit',
+    month: '2-digit',
+});
+/**
+ * @publicApi
+ */
 let Logger = Logger_1 = class Logger {
     constructor(context, options = {}) {
         this.context = context;
@@ -29,7 +39,7 @@ let Logger = Logger_1 = class Logger {
     error(message, ...optionalParams) {
         var _a;
         optionalParams = this.context
-            ? optionalParams.concat(this.context)
+            ? (optionalParams.length ? optionalParams : [undefined]).concat(this.context)
             : optionalParams;
         (_a = this.localInstance) === null || _a === void 0 ? void 0 : _a.error(message, ...optionalParams);
     }
@@ -104,15 +114,7 @@ let Logger = Logger_1 = class Logger {
         this.isBufferAttached = false;
     }
     static getTimestamp() {
-        const localeStringOptions = {
-            year: 'numeric',
-            hour: 'numeric',
-            minute: 'numeric',
-            second: 'numeric',
-            day: '2-digit',
-            month: '2-digit',
-        };
-        return new Date(Date.now()).toLocaleString(undefined, localeStringOptions);
+        return dateTimeFormatter.format(Date.now());
     }
     static overrideLogger(logger) {
         var _a;
@@ -224,9 +226,9 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:returntype", void 0)
 ], Logger, "verbose", null);
 Logger = Logger_1 = tslib_1.__decorate([
-    (0, injectable_decorator_1.Injectable)(),
-    tslib_1.__param(0, (0, optional_decorator_1.Optional)()),
-    tslib_1.__param(1, (0, optional_decorator_1.Optional)()),
+    (0, core_1.Injectable)(),
+    tslib_1.__param(0, (0, core_1.Optional)()),
+    tslib_1.__param(1, (0, core_1.Optional)()),
     tslib_1.__metadata("design:paramtypes", [String, Object])
 ], Logger);
 exports.Logger = Logger;

package/utils/forward-ref.util.d.ts

@@ -1,2 +1,5 @@
 import { ForwardReference } from '../interfaces/modules/forward-reference.interface';
+/**
+ * @publicApi
+ */
 export declare const forwardRef: (fn: () => any) => ForwardReference;

package/utils/forward-ref.util.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.forwardRef = void 0;
+/**
+ * @publicApi
+ */
 const forwardRef = (fn) => ({
     forwardRef: fn,
 });

package/utils/http-error-by-code.util.d.ts

@@ -1,4 +1,4 @@
 import { HttpStatus } from '../enums';
 import { Type } from '../interfaces';
-export declare type ErrorHttpStatusCode = HttpStatus.BAD_GATEWAY | HttpStatus.BAD_REQUEST | HttpStatus.CONFLICT | HttpStatus.FORBIDDEN | HttpStatus.GATEWAY_TIMEOUT | HttpStatus.GONE | HttpStatus.I_AM_A_TEAPOT | HttpStatus.INTERNAL_SERVER_ERROR | HttpStatus.METHOD_NOT_ALLOWED | HttpStatus.NOT_ACCEPTABLE | HttpStatus.NOT_FOUND | HttpStatus.NOT_IMPLEMENTED | HttpStatus.PAYLOAD_TOO_LARGE | HttpStatus.PRECONDITION_FAILED | HttpStatus.REQUEST_TIMEOUT | HttpStatus.SERVICE_UNAVAILABLE | HttpStatus.UNAUTHORIZED | HttpStatus.UNPROCESSABLE_ENTITY | HttpStatus.UNSUPPORTED_MEDIA_TYPE;
+export type ErrorHttpStatusCode = HttpStatus.BAD_GATEWAY | HttpStatus.BAD_REQUEST | HttpStatus.CONFLICT | HttpStatus.FORBIDDEN | HttpStatus.GATEWAY_TIMEOUT | HttpStatus.GONE | HttpStatus.I_AM_A_TEAPOT | HttpStatus.INTERNAL_SERVER_ERROR | HttpStatus.METHOD_NOT_ALLOWED | HttpStatus.NOT_ACCEPTABLE | HttpStatus.NOT_FOUND | HttpStatus.NOT_IMPLEMENTED | HttpStatus.PAYLOAD_TOO_LARGE | HttpStatus.PRECONDITION_FAILED | HttpStatus.REQUEST_TIMEOUT | HttpStatus.SERVICE_UNAVAILABLE | HttpStatus.UNAUTHORIZED | HttpStatus.UNPROCESSABLE_ENTITY | HttpStatus.UNSUPPORTED_MEDIA_TYPE;
 export declare const HttpErrorByCode: Record<ErrorHttpStatusCode, Type<unknown>>;

package/utils/merge-with-values.util.d.ts

@@ -1,4 +1,4 @@
-export declare type Constructor<T> = new (...args: any[]) => T;
+export type Constructor<T> = new (...args: any[]) => T;
 export declare const MergeWithValues: <T extends Constructor<{}>>(data: {
     [param: string]: any;
 }) => (Metatype: T) => any;

package/utils/random-string-generator.util.d.ts

@@ -1 +1 @@
-export declare const randomStringGenerator: () => any;
+export declare const randomStringGenerator: () => string;

package/utils/random-string-generator.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.randomStringGenerator = void 0;
-const uuid_1 = require("uuid");
-const randomStringGenerator = () => (0, uuid_1.v4)();
+const uid_1 = require("uid");
+const randomStringGenerator = () => (0, uid_1.uid)(21);
 exports.randomStringGenerator = randomStringGenerator;