@nest-boot/middleware 7.2.2 → 7.3.0

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

@@ -11,8 +11,12 @@ export interface MiddlewareConfig {
     routes: (string | Type | RouteInfo)[];
     /** Routes to exclude from the middleware */
     excludeRoutes: (string | RouteInfo)[];
-    /** Middlewares that must be applied before this one */
+    /** Middlewares that must be registered and applied before this one */
     dependencyMiddlewares: Type<NestMiddleware>[];
+    /** Middlewares that should be applied before this one when registered */
+    afterMiddlewares: Type<NestMiddleware>[];
+    /** Middlewares that should be applied after this one when registered */
+    beforeMiddlewares: Type<NestMiddleware>[];
     /** Whether to disable global exclude routes for this middleware */
     disabledGlobalExcludeRoutes: boolean;
 }

package/dist/middleware.configurator.d.ts

@@ -3,20 +3,78 @@ import { NestMiddleware, RouteInfo } from "@nestjs/common/interfaces";
 import { MiddlewareManager } from "./middleware.manager";
 import { MiddlewareInstanceOrFunction } from "./types";
 /**
- * Configurator for applying middlewares to routes.
+ * Fluent configurator for applying middlewares to routes.
+ *
+ * @remarks
+ * Provides a chainable API for specifying route patterns, exclusions,
+ * and dependency ordering when registering middleware.
  */
 export declare class MiddlewareConfigurator {
     private readonly manager;
     private readonly middlewares;
+    /** Whether global route exclusions are disabled for these middlewares. @internal */
     private disabledGlobalExcludeRoutes;
+    /** Routes excluded from middleware processing. @internal */
     private readonly excludeRoutes;
+    /** Middleware types that must run before this middleware. @internal */
     private readonly dependencyMiddlewares;
+    /** Middleware types that should run before this middleware when registered. @internal */
+    private readonly afterMiddlewares;
+    /** Middleware types that should run after this middleware when registered. @internal */
+    private readonly beforeMiddlewares;
     /**
-     * @internal
+     * Creates a new MiddlewareConfigurator instance.
+     * @param manager - The middleware manager that owns this configurator
+     * @param middlewares - The middleware instances or functions to configure
      */
     constructor(manager: MiddlewareManager, middlewares: MiddlewareInstanceOrFunction[]);
+    /**
+     * Disables global route exclusions for these middlewares.
+     * @returns This configurator for chaining
+     */
     disableGlobalExcludeRoutes(): this;
+    /**
+     * Excludes specific routes from middleware processing.
+     * @param routes - Route patterns or RouteInfo objects to exclude
+     * @returns This configurator for chaining
+     */
     exclude(...routes: (string | RouteInfo)[]): this;
+    /**
+     * Declares middlewares that should run after this middleware when registered.
+     *
+     * @remarks
+     * This is a soft ordering hint. Unregistered middleware types are ignored.
+     *
+     * @param beforeMiddlewares - Middleware types that should run after this middleware
+     * @returns This configurator for chaining
+     */
+    before(...beforeMiddlewares: Type<NestMiddleware>[]): this;
+    /**
+     * Declares middlewares that should run before this middleware when registered.
+     *
+     * @remarks
+     * This is a soft ordering hint. Unregistered middleware types are ignored.
+     *
+     * @param afterMiddlewares - Middleware types that should run before this middleware
+     * @returns This configurator for chaining
+     */
+    after(...afterMiddlewares: Type<NestMiddleware>[]): this;
+    /**
+     * Declares middleware dependencies for ordering. Dependencies must be registered
+     * and must run before this middleware.
+     *
+     * @remarks
+     * This is a hard prerequisite. An unregistered dependency throws during
+     * middleware configuration.
+     *
+     * @param dependencyMiddlewares - Middleware types that must run before this middleware
+     * @returns This configurator for chaining
+     */
     dependencies(...dependencyMiddlewares: Type<NestMiddleware>[]): this;
+    /**
+     * Applies the configured middlewares to the specified routes.
+     * @param routes - Route patterns, controller types, or RouteInfo objects
+     * @returns The parent {@link MiddlewareManager} for further configuration
+     */
     forRoutes(...routes: (string | Type | RouteInfo)[]): MiddlewareManager;
 }

package/dist/middleware.configurator.js

@@ -2,31 +2,95 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MiddlewareConfigurator = void 0;
 /**
- * Configurator for applying middlewares to routes.
+ * Fluent configurator for applying middlewares to routes.
+ *
+ * @remarks
+ * Provides a chainable API for specifying route patterns, exclusions,
+ * and dependency ordering when registering middleware.
  */
 class MiddlewareConfigurator {
     /**
-     * @internal
+     * Creates a new MiddlewareConfigurator instance.
+     * @param manager - The middleware manager that owns this configurator
+     * @param middlewares - The middleware instances or functions to configure
      */
     constructor(manager, middlewares) {
         this.manager = manager;
         this.middlewares = middlewares;
+        /** Whether global route exclusions are disabled for these middlewares. @internal */
         this.disabledGlobalExcludeRoutes = false;
+        /** Routes excluded from middleware processing. @internal */
         this.excludeRoutes = [];
+        /** Middleware types that must run before this middleware. @internal */
         this.dependencyMiddlewares = [];
+        /** Middleware types that should run before this middleware when registered. @internal */
+        this.afterMiddlewares = [];
+        /** Middleware types that should run after this middleware when registered. @internal */
+        this.beforeMiddlewares = [];
     }
+    /**
+     * Disables global route exclusions for these middlewares.
+     * @returns This configurator for chaining
+     */
     disableGlobalExcludeRoutes() {
         this.disabledGlobalExcludeRoutes = true;
         return this;
     }
+    /**
+     * Excludes specific routes from middleware processing.
+     * @param routes - Route patterns or RouteInfo objects to exclude
+     * @returns This configurator for chaining
+     */
     exclude(...routes) {
         this.excludeRoutes.push(...routes);
         return this;
     }
+    /**
+     * Declares middlewares that should run after this middleware when registered.
+     *
+     * @remarks
+     * This is a soft ordering hint. Unregistered middleware types are ignored.
+     *
+     * @param beforeMiddlewares - Middleware types that should run after this middleware
+     * @returns This configurator for chaining
+     */
+    before(...beforeMiddlewares) {
+        this.beforeMiddlewares.push(...beforeMiddlewares);
+        return this;
+    }
+    /**
+     * Declares middlewares that should run before this middleware when registered.
+     *
+     * @remarks
+     * This is a soft ordering hint. Unregistered middleware types are ignored.
+     *
+     * @param afterMiddlewares - Middleware types that should run before this middleware
+     * @returns This configurator for chaining
+     */
+    after(...afterMiddlewares) {
+        this.afterMiddlewares.push(...afterMiddlewares);
+        return this;
+    }
+    /**
+     * Declares middleware dependencies for ordering. Dependencies must be registered
+     * and must run before this middleware.
+     *
+     * @remarks
+     * This is a hard prerequisite. An unregistered dependency throws during
+     * middleware configuration.
+     *
+     * @param dependencyMiddlewares - Middleware types that must run before this middleware
+     * @returns This configurator for chaining
+     */
     dependencies(...dependencyMiddlewares) {
         this.dependencyMiddlewares.push(...dependencyMiddlewares);
         return this;
     }
+    /**
+     * Applies the configured middlewares to the specified routes.
+     * @param routes - Route patterns, controller types, or RouteInfo objects
+     * @returns The parent {@link MiddlewareManager} for further configuration
+     */
     forRoutes(...routes) {
         if (routes.length === 0) {
             return this.manager;
@@ -44,6 +108,8 @@ class MiddlewareConfigurator {
                 routes,
                 excludeRoutes: this.excludeRoutes,
                 dependencyMiddlewares: this.dependencyMiddlewares,
+                afterMiddlewares: this.afterMiddlewares,
+                beforeMiddlewares: this.beforeMiddlewares,
                 disabledGlobalExcludeRoutes: this.disabledGlobalExcludeRoutes,
             });
         });

package/dist/middleware.configurator.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.configurator.js","sourceRoot":"","sources":["../src/middleware.configurator.ts"],"names":[],"mappings":";;;AAMA;;GAEG;AACH,MAAa,sBAAsB;IAOjC;;OAEG;IACH,YACmB,OAA0B,EAC1B,WAA2C;QAD3C,YAAO,GAAP,OAAO,CAAmB;QAC1B,gBAAW,GAAX,WAAW,CAAgC;QAXtD,gCAA2B,GAAG,KAAK,CAAC;QAE3B,kBAAa,GAA2B,EAAE,CAAC;QAE3C,0BAAqB,GAA2B,EAAE,CAAC;IAQjE,CAAC;IAEG,0BAA0B;QAC/B,IAAI,CAAC,2BAA2B,GAAG,IAAI,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,OAAO,CAAC,GAAG,MAA8B;QAC9C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,YAAY,CAAC,GAAG,qBAA6C;QAClE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,SAAS,CACd,GAAG,MAAqC;QAExC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YACtC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,EAAE;gBAC/C,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;oBAC7B,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;wBACxB,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;oBACjC,CAAC;yBAAM,CAAC;wBACN,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC;gBACD,MAAM;gBACN,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;gBACjD,2BAA2B,EAAE,IAAI,CAAC,2BAA2B;aAC9D,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF;AAvDD,wDAuDC"}
+{"version":3,"file":"middleware.configurator.js","sourceRoot":"","sources":["../src/middleware.configurator.ts"],"names":[],"mappings":";;;AAMA;;;;;;GAMG;AACH,MAAa,sBAAsB;IAgBjC;;;;OAIG;IACH,YACmB,OAA0B,EAC1B,WAA2C;QAD3C,YAAO,GAAP,OAAO,CAAmB;QAC1B,gBAAW,GAAX,WAAW,CAAgC;QAtB9D,oFAAoF;QAC5E,gCAA2B,GAAG,KAAK,CAAC;QAE5C,4DAA4D;QAC3C,kBAAa,GAA2B,EAAE,CAAC;QAE5D,uEAAuE;QACtD,0BAAqB,GAA2B,EAAE,CAAC;QAEpE,yFAAyF;QACxE,qBAAgB,GAA2B,EAAE,CAAC;QAE/D,wFAAwF;QACvE,sBAAiB,GAA2B,EAAE,CAAC;IAU7D,CAAC;IAEJ;;;OAGG;IACI,0BAA0B;QAC/B,IAAI,CAAC,2BAA2B,GAAG,IAAI,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACI,OAAO,CAAC,GAAG,MAA8B;QAC9C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,iBAAyC;QACxD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,GAAG,gBAAwC;QACtD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;OAUG;IACI,YAAY,CAAC,GAAG,qBAA6C;QAClE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACI,SAAS,CACd,GAAG,MAAqC;QAExC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YACtC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,EAAE;gBAC/C,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;oBAC7B,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;wBACxB,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;oBACjC,CAAC;yBAAM,CAAC;wBACN,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC;gBACD,MAAM;gBACN,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;gBACjD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;gBACzC,2BAA2B,EAAE,IAAI,CAAC,2BAA2B;aAC9D,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF;AAzHD,wDAyHC"}

package/dist/middleware.manager.d.ts

@@ -3,21 +3,34 @@ import { MiddlewareConfig } from "./interfaces";
 import { MiddlewareConfigurator } from "./middleware.configurator";
 import { MiddlewareInstanceOrFunction } from "./types";
 /**
- * Manages middleware registration and configuration.
+ * Service that manages middleware registration and topological ordering.
+ *
+ * @remarks
+ * Provides an API similar to NestJS `MiddlewareConsumer` but adds support
+ * for dependency-based ordering and global route exclusions.
  */
 export declare class MiddlewareManager {
+    /** Global routes excluded from all middleware processing. @internal */
     private globalExcludeRoutes;
-    /**
-     * @internal
-     */
+    /** Map of middleware instances to their configurations. @internal */
     readonly middlewareConfigMap: Map<MiddlewareInstanceOrFunction, MiddlewareConfig>;
+    /** Returns middleware configs sorted by dependency order. @internal */
     private get middlewareConfigs();
     /**
-     * Applies middlewares to routes.
-     * @param middlewares - The middlewares to apply
-     * @returns A configurator for specifying routes
+     * Creates a middleware configurator for the given middlewares.
+     * @param middlewares - Middleware instances or functions to apply
+     * @returns A {@link MiddlewareConfigurator} for specifying routes and options
      */
     apply(...middlewares: MiddlewareInstanceOrFunction[]): MiddlewareConfigurator;
+    /**
+     * Adds routes to the global exclusion list (applies to all middlewares).
+     * @param routes - Route patterns or RouteInfo objects to exclude globally
+     * @returns This manager for chaining
+     */
     globalExclude(...routes: (string | RouteInfo)[]): this;
+    /**
+     * Applies all registered middleware configurations to the NestJS middleware consumer.
+     * @param consumer - The NestJS middleware consumer from the module's configure method
+     */
     configure(consumer: MiddlewareConsumer): void;
 }

package/dist/middleware.manager.js

@@ -10,16 +10,20 @@ exports.MiddlewareManager = void 0;
 const common_1 = require("@nestjs/common");
 const middleware_configurator_1 = require("./middleware.configurator");
 /**
- * Manages middleware registration and configuration.
+ * Service that manages middleware registration and topological ordering.
+ *
+ * @remarks
+ * Provides an API similar to NestJS `MiddlewareConsumer` but adds support
+ * for dependency-based ordering and global route exclusions.
  */
 let MiddlewareManager = class MiddlewareManager {
     constructor() {
+        /** Global routes excluded from all middleware processing. @internal */
         this.globalExcludeRoutes = [];
-        /**
-         * @internal
-         */
+        /** Map of middleware instances to their configurations. @internal */
         this.middlewareConfigMap = new Map();
     }
+    /** Returns middleware configs sorted by dependency order. @internal */
     get middlewareConfigs() {
         const sorted = [];
         const visited = new Set();
@@ -30,6 +34,31 @@ let MiddlewareManager = class MiddlewareManager {
                 typeToMiddleware.set(middleware.constructor, middleware);
             }
         }
+        const resolveDependencyMiddleware = (middlewareType) => {
+            const middleware = typeToMiddleware.get(middlewareType);
+            if (!middleware) {
+                throw new Error(`Dependency middleware ${middlewareType.name} is not registered`);
+            }
+            return middleware;
+        };
+        const dependencyMap = new Map();
+        for (const [middleware, config] of this.middlewareConfigMap) {
+            dependencyMap.set(middleware, config.dependencyMiddlewares.map((dependencyMiddleware) => resolveDependencyMiddleware(dependencyMiddleware)));
+        }
+        for (const [middleware, config] of this.middlewareConfigMap) {
+            for (const afterMiddleware of config.afterMiddlewares) {
+                const dependency = typeToMiddleware.get(afterMiddleware);
+                if (dependency) {
+                    dependencyMap.get(middleware)?.push(dependency);
+                }
+            }
+            for (const beforeMiddleware of config.beforeMiddlewares) {
+                const dependent = typeToMiddleware.get(beforeMiddleware);
+                if (dependent) {
+                    dependencyMap.get(dependent)?.push(middleware);
+                }
+            }
+        }
         const visit = (middleware) => {
             if (visited.has(middleware)) {
                 return;
@@ -38,15 +67,9 @@ let MiddlewareManager = class MiddlewareManager {
                 throw new Error("Circular dependency detected in middleware");
             }
             visiting.add(middleware);
-            const config = this.middlewareConfigMap.get(middleware);
-            if (config?.dependencyMiddlewares) {
-                for (const dependencyMiddleware of config.dependencyMiddlewares) {
-                    const depMiddleware = typeToMiddleware.get(dependencyMiddleware);
-                    if (!depMiddleware) {
-                        throw new Error(`Dependency middleware ${dependencyMiddleware.name} is not registered`);
-                    }
-                    visit(depMiddleware);
-                }
+            const dependencies = dependencyMap.get(middleware) ?? [];
+            for (const dependency of dependencies) {
+                visit(dependency);
             }
             visiting.delete(middleware);
             visited.add(middleware);
@@ -60,17 +83,26 @@ let MiddlewareManager = class MiddlewareManager {
             .filter((config) => config !== undefined);
     }
     /**
-     * Applies middlewares to routes.
-     * @param middlewares - The middlewares to apply
-     * @returns A configurator for specifying routes
+     * Creates a middleware configurator for the given middlewares.
+     * @param middlewares - Middleware instances or functions to apply
+     * @returns A {@link MiddlewareConfigurator} for specifying routes and options
      */
     apply(...middlewares) {
         return new middleware_configurator_1.MiddlewareConfigurator(this, middlewares);
     }
+    /**
+     * Adds routes to the global exclusion list (applies to all middlewares).
+     * @param routes - Route patterns or RouteInfo objects to exclude globally
+     * @returns This manager for chaining
+     */
     globalExclude(...routes) {
         this.globalExcludeRoutes.push(...routes);
         return this;
     }
+    /**
+     * Applies all registered middleware configurations to the NestJS middleware consumer.
+     * @param consumer - The NestJS middleware consumer from the module's configure method
+     */
     configure(consumer) {
         for (const config of this.middlewareConfigs) {
             const proxy = consumer.apply(config.middleware);

package/dist/middleware.manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.manager.js","sourceRoot":"","sources":["../src/middleware.manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"middleware.manager.js","sourceRoot":"","sources":["../src/middleware.manager.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAkE;AAIlE,uEAAmE;AAGnE;;;;;;GAMG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAAvB;QACL,uEAAuE;QAC/D,wBAAmB,GAA2B,EAAE,CAAC;QAEzD,qEAAqE;QACrD,wBAAmB,GAAG,IAAI,GAAG,EAG1C,CAAC;IAkIN,CAAC;IAhIC,uEAAuE;IACvE,IAAY,iBAAiB;QAC3B,MAAM,MAAM,GAAmC,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;QACxD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;QAEzD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAwC,CAAC;QACzE,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC;YACzD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;gBAC7D,gBAAgB,CAAC,GAAG,CAClB,UAAU,CAAC,WAAmC,EAC9C,UAAU,CACX,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,2BAA2B,GAAG,CAClC,cAAoC,EACpC,EAAE;YACF,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YACxD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CACb,yBAAyB,cAAc,CAAC,IAAI,oBAAoB,CACjE,CAAC;YACJ,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC;QAEF,MAAM,aAAa,GAAG,IAAI,GAAG,EAG1B,CAAC;QAEJ,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5D,aAAa,CAAC,GAAG,CACf,UAAU,EACV,MAAM,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,oBAAoB,EAAE,EAAE,CACxD,2BAA2B,CAAC,oBAAoB,CAAC,CAClD,CACF,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5D,KAAK,MAAM,eAAe,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBACtD,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBACzD,IAAI,UAAU,EAAE,CAAC;oBACf,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YAED,KAAK,MAAM,gBAAgB,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;gBACxD,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;gBACzD,IAAI,SAAS,EAAE,CAAC;oBACd,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,UAAwC,EAAE,EAAE;YACzD,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC5B,OAAO;YACT,CAAC;YAED,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAChE,CAAC;YAED,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAEzB,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACzD,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;gBACtC,KAAK,CAAC,UAAU,CAAC,CAAC;YACpB,CAAC;YAED,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1B,CAAC,CAAC;QAEF,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC;YACzD,KAAK,CAAC,UAAU,CAAC,CAAC;QACpB,CAAC;QAED,OAAO,MAAM;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aAC3C,MAAM,CAAC,CAAC,MAAM,EAA8B,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IAC1E,CAAC;IAED;;;;OAIG;IACH,KAAK,CACH,GAAG,WAA2C;QAE9C,OAAO,IAAI,gDAAsB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,GAAG,MAA8B;QAC7C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,QAA4B;QACpC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAEhD,MAAM,aAAa,GAAG,MAAM,CAAC,2BAA2B;gBACtD,CAAC,CAAC,MAAM,CAAC,aAAa;gBACtB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,mBAAmB,EAAE,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;YAE3D,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,KAAK,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;YAClC,CAAC;YAED,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;CACF,CAAA;AA1IY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;GACA,iBAAiB,CA0I7B"}

package/dist/middleware.manager.spec.d.ts

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

package/dist/middleware.manager.spec.js

@@ -0,0 +1,197 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const MiddlewareExports = __importStar(require("."));
+const middleware_manager_1 = require("./middleware.manager");
+const middleware_module_1 = require("./middleware.module");
+class RecordingMiddleware {
+    constructor(name, calls) {
+        this.name = name;
+        this.calls = calls;
+    }
+    use(_req, _res, next) {
+        this.calls.push(this.name);
+        next();
+    }
+}
+class FirstMiddleware extends RecordingMiddleware {
+}
+class SecondMiddleware extends RecordingMiddleware {
+}
+class MissingMiddleware extends RecordingMiddleware {
+}
+const createMiddlewareConsumer = () => {
+    const middlewares = [];
+    const proxy = {
+        exclude: jest.fn().mockReturnThis(),
+        forRoutes: jest.fn().mockReturnThis(),
+    };
+    const consumer = {
+        apply: jest.fn((middleware) => {
+            middlewares.push(middleware);
+            return proxy;
+        }),
+    };
+    return { consumer, middlewares, proxy };
+};
+const collectMiddlewares = (manager) => {
+    const { consumer, middlewares } = createMiddlewareConsumer();
+    manager.configure(consumer);
+    return middlewares;
+};
+const runMiddlewares = (middlewares) => {
+    for (const middleware of middlewares) {
+        middleware({}, {}, jest.fn());
+    }
+};
+describe("MiddlewareManager", () => {
+    it("exports middleware APIs from the package entrypoint", () => {
+        expect(MiddlewareExports.MiddlewareManager).toBe(middleware_manager_1.MiddlewareManager);
+        expect(MiddlewareExports.MiddlewareModule).toBe(middleware_module_1.MiddlewareModule);
+    });
+    it("applies middleware after target middleware", () => {
+        const calls = [];
+        const first = new FirstMiddleware("first", calls);
+        const second = new SecondMiddleware("second", calls);
+        const manager = new middleware_manager_1.MiddlewareManager();
+        manager.apply(second).after(FirstMiddleware).forRoutes("*");
+        manager.apply(first).forRoutes("*");
+        runMiddlewares(collectMiddlewares(manager));
+        expect(calls).toEqual(["first", "second"]);
+    });
+    it("applies hard dependency middleware before current middleware", () => {
+        const calls = [];
+        const first = new FirstMiddleware("first", calls);
+        const second = new SecondMiddleware("second", calls);
+        const manager = new middleware_manager_1.MiddlewareManager();
+        manager.apply(second).dependencies(FirstMiddleware).forRoutes("*");
+        manager.apply(first).forRoutes("*");
+        runMiddlewares(collectMiddlewares(manager));
+        expect(calls).toEqual(["first", "second"]);
+    });
+    it("applies middleware before target middleware", () => {
+        const calls = [];
+        const first = new FirstMiddleware("first", calls);
+        const second = new SecondMiddleware("second", calls);
+        const manager = new middleware_manager_1.MiddlewareManager();
+        manager.apply(second).forRoutes("*");
+        manager.apply(first).before(SecondMiddleware).forRoutes("*");
+        runMiddlewares(collectMiddlewares(manager));
+        expect(calls).toEqual(["first", "second"]);
+    });
+    it("ignores after target middleware when it is not registered", () => {
+        const calls = [];
+        const first = new FirstMiddleware("first", calls);
+        const manager = new middleware_manager_1.MiddlewareManager();
+        manager.apply(first).after(MissingMiddleware).forRoutes("*");
+        runMiddlewares(collectMiddlewares(manager));
+        expect(calls).toEqual(["first"]);
+    });
+    it("ignores before target middleware when it is not registered", () => {
+        const calls = [];
+        const first = new FirstMiddleware("first", calls);
+        const manager = new middleware_manager_1.MiddlewareManager();
+        manager.apply(first).before(MissingMiddleware).forRoutes("*");
+        runMiddlewares(collectMiddlewares(manager));
+        expect(calls).toEqual(["first"]);
+    });
+    it("throws when dependencies reference an unregistered middleware", () => {
+        const calls = [];
+        const first = new FirstMiddleware("first", calls);
+        const manager = new middleware_manager_1.MiddlewareManager();
+        manager.apply(first).dependencies(MissingMiddleware).forRoutes("*");
+        expect(() => collectMiddlewares(manager)).toThrow("Dependency middleware MissingMiddleware is not registered");
+    });
+    it("throws when middleware ordering is circular", () => {
+        const calls = [];
+        const first = new FirstMiddleware("first", calls);
+        const second = new SecondMiddleware("second", calls);
+        const manager = new middleware_manager_1.MiddlewareManager();
+        manager.apply(first).before(SecondMiddleware).forRoutes("*");
+        manager.apply(second).before(FirstMiddleware).forRoutes("*");
+        expect(() => collectMiddlewares(manager)).toThrow("Circular dependency detected in middleware");
+    });
+    it("applies function middleware with route exclusions", () => {
+        const calls = [];
+        const manager = new middleware_manager_1.MiddlewareManager();
+        const { consumer, middlewares, proxy } = createMiddlewareConsumer();
+        manager
+            .globalExclude("/global")
+            .apply((_req, _res, next) => {
+            calls.push("function");
+            next();
+        })
+            .exclude("/local")
+            .forRoutes("/route");
+        manager.configure(consumer);
+        runMiddlewares(middlewares);
+        expect(proxy.exclude).toHaveBeenCalledWith("/global", "/local");
+        expect(proxy.forRoutes).toHaveBeenCalledWith("/route");
+        expect(calls).toEqual(["function"]);
+    });
+    it("can disable global exclude routes for a middleware", () => {
+        const calls = [];
+        const first = new FirstMiddleware("first", calls);
+        const manager = new middleware_manager_1.MiddlewareManager();
+        const { consumer, proxy } = createMiddlewareConsumer();
+        manager
+            .globalExclude("/global")
+            .apply(first)
+            .disableGlobalExcludeRoutes()
+            .exclude("/local")
+            .forRoutes("/route");
+        manager.configure(consumer);
+        expect(proxy.exclude).toHaveBeenCalledWith("/local");
+        expect(proxy.exclude).not.toHaveBeenCalledWith("/global");
+    });
+    it("returns manager without registering middleware when no routes are provided", () => {
+        const calls = [];
+        const first = new FirstMiddleware("first", calls);
+        const manager = new middleware_manager_1.MiddlewareManager();
+        expect(manager.apply(first).forRoutes()).toBe(manager);
+        expect(collectMiddlewares(manager)).toEqual([]);
+    });
+    it("delegates module configuration to the middleware manager", () => {
+        const configure = jest.fn();
+        const manager = {
+            configure,
+        };
+        const consumer = {};
+        const module = new middleware_module_1.MiddlewareModule(manager);
+        module.configure(consumer);
+        expect(configure).toHaveBeenCalledWith(consumer);
+    });
+});
+//# sourceMappingURL=middleware.manager.spec.js.map

package/dist/middleware.manager.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.manager.spec.js","sourceRoot":"","sources":["../src/middleware.manager.spec.ts"],"names":[],"mappings":"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"}

package/dist/middleware.module.d.ts

@@ -1,7 +1,15 @@
 import { MiddlewareConsumer, NestModule } from "@nestjs/common";
 import { MiddlewareManager } from "./middleware.manager";
+/**
+ * Global module that provides the {@link MiddlewareManager} for registering
+ * and configuring middleware with dependency ordering support.
+ */
 export declare class MiddlewareModule implements NestModule {
     private readonly middlewareManager;
+    /** Creates a new MiddlewareModule instance.
+     * @param middlewareManager - The middleware manager instance
+     */
     constructor(middlewareManager: MiddlewareManager);
+    /** Configures all registered middlewares through the NestJS middleware consumer. */
     configure(consumer: MiddlewareConsumer): void;
 }

package/dist/middleware.module.js

@@ -12,10 +12,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MiddlewareModule = void 0;
 const common_1 = require("@nestjs/common");
 const middleware_manager_1 = require("./middleware.manager");
+/**
+ * Global module that provides the {@link MiddlewareManager} for registering
+ * and configuring middleware with dependency ordering support.
+ */
 let MiddlewareModule = class MiddlewareModule {
+    /** Creates a new MiddlewareModule instance.
+     * @param middlewareManager - The middleware manager instance
+     */
     constructor(middlewareManager) {
         this.middlewareManager = middlewareManager;
     }
+    /** Configures all registered middlewares through the NestJS middleware consumer. */
     configure(consumer) {
         this.middlewareManager.configure(consumer);
     }

package/dist/middleware.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.module.js","sourceRoot":"","sources":["../src/middleware.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAgF;AAEhF,6DAAyD;AAOlD,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,YAA6B,iBAAoC;QAApC,sBAAiB,GAAjB,iBAAiB,CAAmB;IAAG,CAAC;IAErE,SAAS,CAAC,QAA4B;QACpC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;CACF,CAAA;AANY,4CAAgB;2BAAhB,gBAAgB;IAL5B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,sCAAiB,CAAC;QAC9B,OAAO,EAAE,CAAC,sCAAiB,CAAC;KAC7B,CAAC;qCAEgD,sCAAiB;GADtD,gBAAgB,CAM5B"}
+{"version":3,"file":"middleware.module.js","sourceRoot":"","sources":["../src/middleware.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAgF;AAEhF,6DAAyD;AAEzD;;;GAGG;AAMI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B;;OAEG;IACH,YAA6B,iBAAoC;QAApC,sBAAiB,GAAjB,iBAAiB,CAAmB;IAAG,CAAC;IAErE,oFAAoF;IACpF,SAAS,CAAC,QAA4B;QACpC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;CACF,CAAA;AAVY,4CAAgB;2BAAhB,gBAAgB;IAL5B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,sCAAiB,CAAC;QAC9B,OAAO,EAAE,CAAC,sCAAiB,CAAC;KAC7B,CAAC;qCAKgD,sCAAiB;GAJtD,gBAAgB,CAU5B"}