@nestjs/core 11.1.16 → 11.1.18

package/Readme.md

@@ -29,7 +29,7 @@ Nest is a framework for building efficient, scalable <a href="https://nodejs.org
 
 ## Philosophy
 
-<p>In recent years, thanks to Node.js, JavaScript has become the “lingua franca” of the web for both front and backend applications, giving rise to awesome projects like <a href="https://angular.io/" target="_blank">Angular</a>, <a href="https://github.com/facebook/react" target="_blank">React</a>, and <a href="https://github.com/vuejs/vue" target="_blank">Vue</a>, which improve developer productivity and enable the construction of fast, testable, and extensible frontend applications. However, on the server-side, while there are a lot of superb libraries, helpers, and tools for Node, none of them effectively solve the main problem - the architecture.</p>
+<p>In recent years, thanks to Node.js, JavaScript has become the “lingua franca” of the web for both front-end and back-end applications, giving rise to awesome projects like <a href="https://angular.io/" target="_blank">Angular</a>, <a href="https://github.com/facebook/react" target="_blank">React</a>, and <a href="https://github.com/vuejs/vue" target="_blank">Vue</a>, which improve developer productivity and enable the construction of fast, testable, and extensible frontend applications. However, on the server-side, while there are a lot of superb libraries, helpers, and tools for Node, none of them effectively solve the main problem - the architecture.</p>
 <p>Nest aims to provide an application architecture out of the box which allows for effortless creation of highly testable, scalable, and loosely coupled and easily maintainable applications. The architecture is heavily inspired by Angular.</p>
 
 ## Getting started

package/hooks/utils/get-instances-grouped-by-hierarchy-level.d.ts

@@ -0,0 +1,3 @@
+import { InjectionToken } from '@nestjs/common';
+import { InstanceWrapper } from '../../injector/instance-wrapper.js';
+export declare function getInstancesGroupedByHierarchyLevel(...collections: Array<Map<InjectionToken, InstanceWrapper> | Array<[InjectionToken, InstanceWrapper]>>): Map<number, unknown[]>;

package/hooks/utils/get-instances-grouped-by-hierarchy-level.js

@@ -0,0 +1,27 @@
+export function getInstancesGroupedByHierarchyLevel(...collections) {
+    const groupedByHierarchyLevel = new Map();
+    for (const collection of collections) {
+        for (const [_, wrapper] of collection) {
+            if (!wrapper.isDependencyTreeStatic()) {
+                continue;
+            }
+            const level = wrapper.hierarchyLevel;
+            if (!groupedByHierarchyLevel.has(level)) {
+                groupedByHierarchyLevel.set(level, []);
+            }
+            const byHierarchyLevelGroup = groupedByHierarchyLevel.get(level);
+            if (wrapper.isTransient) {
+                const staticTransientInstances = wrapper
+                    .getStaticTransientInstances()
+                    .filter(i => !!i)
+                    .map(i => i.instance);
+                byHierarchyLevelGroup.push(...staticTransientInstances);
+                continue;
+            }
+            if (wrapper.instance) {
+                byHierarchyLevelGroup.push(wrapper.instance);
+            }
+        }
+    }
+    return groupedByHierarchyLevel;
+}

package/hooks/utils/get-sorted-hierarchy-levels.d.ts

@@ -0,0 +1 @@
+export declare function getSortedHierarchyLevels(groups: Map<number, unknown[]>, order?: 'ASC' | 'DESC'): number[];

package/hooks/utils/get-sorted-hierarchy-levels.js

@@ -0,0 +1,7 @@
+export function getSortedHierarchyLevels(groups, order = 'ASC') {
+    const comparator = order === 'ASC'
+        ? (a, b) => a - b
+        : (a, b) => b - a;
+    const levels = Array.from(groups.keys()).sort(comparator);
+    return levels;
+}

package/index.d.ts

@@ -11,7 +11,7 @@ export * from './metadata-scanner';
 export * from './middleware';
 export * from './nest-application';
 export * from './nest-application-context';
-export { NestFactory } from './nest-factory';
+export { IEntryNestModule, NestFactory } from './nest-factory';
 export * from './repl';
 export * from './router';
 export * from './services';

package/injector/injector.js

@@ -210,7 +210,7 @@ class Injector {
         ];
         const selfParams = this.reflectSelfParams(type);
         selfParams.forEach(({ index, param }) => (paramtypes[index] = param));
-        return paramtypes;
+        return Array.from(paramtypes);
     }
     reflectOptionalParams(type) {
         return Reflect.getMetadata(constants_1.OPTIONAL_DEPS_METADATA, type) || [];

package/injector/module-ref.js

@@ -5,6 +5,7 @@ const common_1 = require("@nestjs/common");
 const get_class_scope_1 = require("../helpers/get-class-scope");
 const is_durable_1 = require("../helpers/is-durable");
 const abstract_instance_resolver_1 = require("./abstract-instance-resolver");
+const constants_1 = require("./constants");
 const injector_1 = require("./injector");
 const instance_links_host_1 = require("./instance-links-host");
 const instance_wrapper_1 = require("./instance-wrapper");
@@ -46,16 +47,23 @@ class ModuleRef extends abstract_instance_resolver_1.AbstractInstanceResolver {
             durable: (0, is_durable_1.isDurable)(type),
             host: moduleRef,
         });
+        if (type?.prototype) {
+            wrapper.setInstanceByContextId(contextId ?? constants_1.STATIC_CONTEXT, {
+                instance: Object.create(type.prototype),
+                isResolved: false,
+                isPending: false,
+            });
+        }
         /* eslint-disable-next-line no-async-promise-executor */
         return new Promise(async (resolve, reject) => {
             try {
                 const callback = async (instances) => {
-                    const properties = await this.injector.resolveProperties(wrapper, moduleRef, undefined, contextId);
+                    const properties = await this.injector.resolveProperties(wrapper, moduleRef, undefined, contextId, wrapper);
                     const instance = new type(...instances);
                     this.injector.applyProperties(instance, properties);
                     resolve(instance);
                 };
-                await this.injector.resolveConstructorParams(wrapper, moduleRef, undefined, callback, contextId);
+                await this.injector.resolveConstructorParams(wrapper, moduleRef, undefined, callback, contextId, wrapper);
             }
             catch (err) {
                 reject(err);

package/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from './module-definition.interface.js';
+export * from './module-override.interface.js';

package/interfaces/index.js

@@ -0,0 +1,2 @@
+export * from './module-definition.interface.js';
+export * from './module-override.interface.js';

package/internal.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Internal module - not part of the public API.
+ * These exports are used by sibling @nestjs packages.
+ * Do not depend on these in your application code.
+ * @internal
+ * @module
+ */
+export { RuntimeException } from './errors/exceptions/runtime.exception.js';
+export { InvalidExceptionFilterException } from './errors/exceptions/invalid-exception-filter.exception.js';
+export { MESSAGES } from './constants.js';
+export { DependenciesScanner } from './scanner.js';
+export { Injector, InjectorDependencyContext } from './injector/injector.js';
+export { InstanceLoader } from './injector/instance-loader.js';
+export { InstanceWrapper } from './injector/instance-wrapper.js';
+export { Module } from './injector/module.js';
+export { STATIC_CONTEXT } from './injector/constants.js';
+export { ExecutionContextHost } from './helpers/execution-context-host.js';
+export { ContextUtils, ParamProperties } from './helpers/context-utils.js';
+export { HandlerMetadataStorage } from './helpers/handler-metadata-storage.js';
+export { RouterMethodFactory } from './helpers/router-method-factory.js';
+export { loadAdapter } from './helpers/load-adapter.js';
+export { optionalRequire } from './helpers/optional-require.js';
+export { ParamsMetadata } from './helpers/interfaces/index.js';
+export { GuardsConsumer } from './guards/guards-consumer.js';
+export { GuardsContextCreator } from './guards/guards-context-creator.js';
+export { FORBIDDEN_MESSAGE } from './guards/constants.js';
+export { PipesConsumer } from './pipes/pipes-consumer.js';
+export { PipesContextCreator } from './pipes/pipes-context-creator.js';
+export { ParamsTokenFactory } from './pipes/params-token-factory.js';
+export { InterceptorsConsumer } from './interceptors/interceptors-consumer.js';
+export { InterceptorsContextCreator } from './interceptors/interceptors-context-creator.js';
+export { BaseExceptionFilterContext } from './exceptions/base-exception-filter-context.js';
+export { LegacyRouteConverter } from './router/legacy-route-converter.js';
+export { REQUEST_CONTEXT_ID } from './router/request/request-constants.js';
+export { NoopGraphInspector } from './inspector/noop-graph-inspector.js';
+export { UuidFactory, UuidFactoryMode } from './inspector/uuid-factory.js';
+export { ModuleDefinition } from './interfaces/module-definition.interface.js';
+export { ModuleOverride } from './interfaces/module-override.interface.js';

package/internal.js

@@ -0,0 +1,46 @@
+/**
+ * Internal module - not part of the public API.
+ * These exports are used by sibling @nestjs packages.
+ * Do not depend on these in your application code.
+ * @internal
+ * @module
+ */
+// Errors
+export { RuntimeException } from './errors/exceptions/runtime.exception.js';
+export { InvalidExceptionFilterException } from './errors/exceptions/invalid-exception-filter.exception.js';
+// Constants
+export { MESSAGES } from './constants.js';
+// Scanner
+export { DependenciesScanner } from './scanner.js';
+// Injector
+export { Injector } from './injector/injector.js';
+export { InstanceLoader } from './injector/instance-loader.js';
+export { InstanceWrapper } from './injector/instance-wrapper.js';
+export { Module } from './injector/module.js';
+export { STATIC_CONTEXT } from './injector/constants.js';
+// Helpers
+export { ExecutionContextHost } from './helpers/execution-context-host.js';
+export { ContextUtils } from './helpers/context-utils.js';
+export { HandlerMetadataStorage } from './helpers/handler-metadata-storage.js';
+export { RouterMethodFactory } from './helpers/router-method-factory.js';
+export { loadAdapter } from './helpers/load-adapter.js';
+export { optionalRequire } from './helpers/optional-require.js';
+// Guards
+export { GuardsConsumer } from './guards/guards-consumer.js';
+export { GuardsContextCreator } from './guards/guards-context-creator.js';
+export { FORBIDDEN_MESSAGE } from './guards/constants.js';
+// Pipes
+export { PipesConsumer } from './pipes/pipes-consumer.js';
+export { PipesContextCreator } from './pipes/pipes-context-creator.js';
+export { ParamsTokenFactory } from './pipes/params-token-factory.js';
+// Interceptors
+export { InterceptorsConsumer } from './interceptors/interceptors-consumer.js';
+export { InterceptorsContextCreator } from './interceptors/interceptors-context-creator.js';
+// Exceptions
+export { BaseExceptionFilterContext } from './exceptions/base-exception-filter-context.js';
+// Router
+export { LegacyRouteConverter } from './router/legacy-route-converter.js';
+export { REQUEST_CONTEXT_ID } from './router/request/request-constants.js';
+// Inspector
+export { NoopGraphInspector } from './inspector/noop-graph-inspector.js';
+export { UuidFactory, UuidFactoryMode } from './inspector/uuid-factory.js';

package/middleware/middleware-module.js

@@ -174,7 +174,10 @@ class MiddlewareModule {
         const middlewareFunction = isMethodAll
             ? proxy
             : (req, res, next) => {
-                if (applicationRef.getRequestMethod?.(req) === requestMethod) {
+                const actualRequestMethod = applicationRef.getRequestMethod?.(req);
+                if (actualRequestMethod === requestMethod ||
+                    (actualRequestMethod === request_method_enum_1.RequestMethod[request_method_enum_1.RequestMethod.HEAD] &&
+                        requestMethod === request_method_enum_1.RequestMethod[request_method_enum_1.RequestMethod.GET])) {
                     return proxy(req, res, next);
                 }
                 return next();

package/nest-factory.d.ts

@@ -3,7 +3,12 @@ import { NestMicroserviceOptions } from '@nestjs/common/interfaces/microservices
 import { NestApplicationContextOptions } from '@nestjs/common/interfaces/nest-application-context-options.interface';
 import { NestApplicationOptions } from '@nestjs/common/interfaces/nest-application-options.interface';
 import { AbstractHttpAdapter } from './adapters/http-adapter';
-type IEntryNestModule = Type<any> | DynamicModule | ForwardReference | Promise<IEntryNestModule>;
+/**
+ * Represents the entry (root) module type accepted by the NestFactory methods.
+ *
+ * @publicApi
+ */
+export type IEntryNestModule = Type<any> | DynamicModule | ForwardReference | Promise<IEntryNestModule>;
 /**
  * @publicApi
  */
@@ -80,4 +85,3 @@ export declare class NestFactoryStatic {
  * @publicApi
  */
 export declare const NestFactory: NestFactoryStatic;
-export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/core",
-  "version": "11.1.16",
+  "version": "11.1.18",
   "description": "Nest - modern, fast, powerful node.js web framework (@core)",
   "author": "Kamil Mysliwiec",
   "license": "MIT",
@@ -34,12 +34,12 @@
     "@nuxt/opencollective": "0.4.1",
     "fast-safe-stringify": "2.1.1",
     "iterare": "1.2.1",
-    "path-to-regexp": "8.3.0",
+    "path-to-regexp": "8.4.2",
     "tslib": "2.8.1",
     "uid": "2.0.2"
   },
   "devDependencies": {
-    "@nestjs/common": "11.1.16"
+    "@nestjs/common": "11.1.18"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",
@@ -60,5 +60,5 @@
       "optional": true
     }
   },
-  "gitHead": "315e698096208868b43dda25f2db9ac9d7c1d822"
+  "gitHead": "3c1cc5f91e95fcec27c3694cd42a08a50e85cc5f"
 }

package/router/sse-stream.js

@@ -56,9 +56,10 @@ class SseStream extends stream_1.Transform {
         return super.pipe(destination, options);
     }
     _transform(message, encoding, callback) {
-        let data = message.type ? `event: ${message.type}\n` : '';
-        data += message.id ? `id: ${message.id}\n` : '';
-        data += message.retry ? `retry: ${message.retry}\n` : '';
+        const sanitize = (val) => String(val).replace(/[\r\n]/g, '');
+        let data = message.type ? `event: ${sanitize(message.type)}\n` : '';
+        data += message.id ? `id: ${sanitize(message.id)}\n` : '';
+        data += message.retry ? `retry: ${sanitize(message.retry)}\n` : '';
         data += message.data ? toDataString(message.data) : '';
         data += '\n';
         this.push(data);