@nestjs/common 12.0.0-alpha.3 → 12.0.0-alpha.5

package/Readme.md

@@ -129,6 +129,7 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <tr>
 <td align="center" valign="middle"><a href="https://solcellsforetag.se/" target="_blank"><img src="https://nestjs.com/img/logos/solcellsforetag-logo.svg" width="140" valign="middle" /></a></td>
 <td align="center" valign="middle"><a href="https://www.route4me.com/" target="_blank"><img src="https://nestjs.com/img/logos/route4me-logo.svg" width="100" valign="middle" /></a></td>
+<td align="center" valign="middle"><a href="https://memory2.co/" target="_blank"><img src="https://images.opencollective.com/memory-squared/bbe37f5/avatar/256.png?height=50" width="50" valign="middle" /></a></td>
 </tr>
 </table>
 

package/index.d.ts

@@ -3,7 +3,7 @@ export * from './decorators/index.js';
 export * from './enums/index.js';
 export * from './exceptions/index.js';
 export * from './file-stream/index.js';
-export { Abstract, ArgumentMetadata, ArgumentsHost, BeforeApplicationShutdown, CallHandler, CanActivate, ClassProvider, ContextType, DynamicModule, ExceptionFilter, ExecutionContext, ExistingProvider, FactoryProvider, ForwardReference, HttpServer, HttpExceptionBody, HttpExceptionBodyMessage, HttpRedirectResponse, INestApplication, INestApplicationContext, INestMicroservice, InjectionToken, IntrospectionResult, MessageEvent, MiddlewareConsumer, ModuleMetadata, NestApplicationOptions, NestHybridApplicationOptions, NestInterceptor, NestMiddleware, PreRequestHook, NestModule, OnApplicationBootstrap, OnApplicationShutdown, OnModuleDestroy, OnModuleInit, OptionalFactoryDependency, Paramtype, PipeTransform, Provider, RawBodyRequest, RpcExceptionFilter, Scope, ScopeOptions, Type, ValidationError, ValueProvider, VersioningOptions, VERSION_NEUTRAL, WebSocketAdapter, WsExceptionFilter, WsMessageHandler, } from './interfaces/index.js';
+export { Abstract, ArgumentMetadata, ArgumentsHost, BeforeApplicationShutdown, CallHandler, CanActivate, ClassProvider, ContextType, DynamicModule, ExceptionFilter, ExecutionContext, ExistingProvider, FactoryProvider, ForwardReference, HttpServer, HttpExceptionBody, HttpExceptionBodyMessage, HttpRedirectResponse, INestApplication, INestApplicationContext, INestMicroservice, InjectionToken, IntrospectionResult, MessageEvent, MiddlewareConsumer, ModuleMetadata, NestApplicationOptions, NestHybridApplicationOptions, NestInterceptor, NestMiddleware, PreRequestHook, NestModule, OnApplicationBootstrap, OnApplicationShutdown, OnModuleDestroy, OnModuleInit, OptionalFactoryDependency, Paramtype, PipeTransform, Provider, RawBodyRequest, RouteConflictPolicy, RouteConflictPolicyLevel, RouteResolutionStrategy, RpcExceptionFilter, Scope, ScopeOptions, Type, ValidationError, ValueProvider, VersioningOptions, VERSION_NEUTRAL, WebSocketAdapter, WsExceptionFilter, WsMessageHandler, } from './interfaces/index.js';
 export * from './module-utils/index.js';
 export * from './pipes/index.js';
 export * from './serializer/index.js';

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

@@ -68,4 +68,5 @@ export interface HttpServer<TRequest = any, TResponse = any, ServerInstance = an
     init?(): Promise<void>;
     applyVersionFilter(handler: Function, version: VersionValue, versioningOptions: VersioningOptions): (req: TRequest, res: TResponse, next: () => void) => Function;
     normalizePath?(path: string): string;
+    isRouteOrderSensitive?(): boolean;
 }

package/interfaces/index.d.ts

@@ -24,6 +24,7 @@ export * from './nest-application-context.interface.js';
 export * from './nest-application-options.interface.js';
 export * from './nest-application.interface.js';
 export * from './nest-microservice.interface.js';
+export * from './router-options.interface.js';
 export * from './scope-options.interface.js';
 export * from './shutdown-hooks-options.interface.js';
 export * from './type.interface.js';

package/interfaces/index.js

@@ -24,6 +24,7 @@ export * from './nest-application-context.interface.js';
 export * from './nest-application-options.interface.js';
 export * from './nest-application.interface.js';
 export * from './nest-microservice.interface.js';
+export * from './router-options.interface.js';
 export * from './scope-options.interface.js';
 export * from './shutdown-hooks-options.interface.js';
 export * from './type.interface.js';

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

@@ -1,6 +1,7 @@
 import { CorsOptions, CorsOptionsDelegate } from './external/cors-options.interface.js';
 import { HttpsOptions } from './external/https-options.interface.js';
 import { NestApplicationContextOptions } from './nest-application-context-options.interface.js';
+import { RouteConflictPolicy, RouteResolutionStrategy } from './router-options.interface.js';
 /**
  * @publicApi
  */
@@ -32,4 +33,18 @@ export interface NestApplicationOptions extends NestApplicationContextOptions {
      * @default false
      */
     return503OnClosing?: boolean;
+    /**
+     * Per-kind policy for overlapping HTTP routes detected at bootstrap.
+     * Distinguishes `duplicate` (identical method+path+host+version) from
+     * `shadow` (patterns that can match the same request, e.g. `/users/me`
+     * vs `/users/:id`). Each kind defaults to `'off'`.
+     */
+    routeConflictPolicy?: RouteConflictPolicy;
+    /**
+     * Order in which HTTP routes are registered on the underlying adapter.
+     * `'specificity'` registers literal segments before parametric and
+     * wildcard ones on order-sensitive adapters (such as Express). Defaults
+     * to `'declaration'`.
+     */
+    routeResolutionStrategy?: RouteResolutionStrategy;
 }

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

@@ -0,0 +1,28 @@
+/**
+ * Severity level applied to a single kind of route conflict detected at
+ * bootstrap.
+ *
+ * @publicApi
+ */
+export type RouteConflictPolicyLevel = 'off' | 'warn' | 'error';
+/**
+ * Per-kind policy for overlapping routes detected at bootstrap.
+ * `duplicate` covers identical (method, path, host, version) registrations.
+ * `shadow` covers patterns that can match the same request (for example
+ * `/users/me` vs `/users/:id`). Each kind defaults to `'off'`.
+ *
+ * @publicApi
+ */
+export interface RouteConflictPolicy {
+    duplicate?: RouteConflictPolicyLevel;
+    shadow?: RouteConflictPolicyLevel;
+}
+/**
+ * Order in which routes are registered on the underlying HTTP adapter.
+ * `'specificity'` registers literal segments before parametric and
+ * wildcard ones on order-sensitive adapters (such as Express). Defaults
+ * to `'declaration'`.
+ *
+ * @publicApi
+ */
+export type RouteResolutionStrategy = 'declaration' | 'specificity';

package/interfaces/router-options.interface.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/common",
-  "version": "12.0.0-alpha.3",
+  "version": "12.0.0-alpha.5",
   "description": "Nest - modern, fast, powerful node.js web framework (@common)",
   "author": "Kamil Mysliwiec",
   "homepage": "https://nestjs.com",
@@ -46,5 +46,5 @@
       "optional": true
     }
   },
-  "gitHead": "1c9d5482a65a446ede8dd1195bfa1cbbc16e0857"
+  "gitHead": "d91b72cc9567e6a09e3ad6075b2fb801e71adfc8"
 }