@keq-request/nestjs 5.0.0-beta.11 → 5.0.0-beta.12

package/.turbo/turbo-build.log

@@ -1,10 +1,10 @@
 
-> @keq-request/nestjs@5.0.0-beta.11 build /home/runner/work/keq/keq/packages/nestjs
+> @keq-request/nestjs@5.0.0-beta.12 build /home/runner/work/keq/keq/packages/nestjs
 > tsdown
 
 ℹ tsdown v0.21.10 powered by rolldown v1.0.0-rc.17
 ℹ config file: /home/runner/work/keq/keq/packages/nestjs/tsdown.config.ts 
-(node:2746) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/keq/keq/packages/nestjs/tsdown.config.ts?no-cache=0efd33bf-1c41-465a-8588-1641d5aab98c is not specified and it doesn't parse as CommonJS.
+(node:2656) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/keq/keq/packages/nestjs/tsdown.config.ts?no-cache=9597eb0e-a7b3-4070-b281-a70050e6a072 is not specified and it doesn't parse as CommonJS.
 Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
 To eliminate this warning, add "type": "module" to /home/runner/work/keq/keq/packages/nestjs/package.json.
 (Use `node --trace-warnings ...` to show where the warning was created)
@@ -12,25 +12,25 @@ To eliminate this warning, add "type": "module" to /home/runner/work/keq/keq/pac
 ℹ target: node20
 ℹ tsconfig: tsconfig.lib.json
 ℹ Build start
-ℹ [CJS] dist/index.js      5.83 kB │ gzip: 2.01 kB
-ℹ [CJS] dist/index.js.map  7.28 kB │ gzip: 2.38 kB
-ℹ [CJS] 2 files, total: 13.11 kB
+ℹ [CJS] dist/index.js      6.68 kB │ gzip: 2.21 kB
+ℹ [CJS] dist/index.js.map  9.02 kB │ gzip: 2.82 kB
+ℹ [CJS] 2 files, total: 15.70 kB
 [PLUGIN_TIMINGS] Warning: Your build spent significant time in plugin `tsdown:deps`. See https://rolldown.rs/options/checks#plugintimings for more details.
 
-ℹ [CJS] dist/index.d.ts.map  0.99 kB │ gzip: 0.43 kB
-ℹ [CJS] dist/index.d.ts      1.86 kB │ gzip: 0.65 kB
-ℹ [CJS] 2 files, total: 2.85 kB
+ℹ [CJS] dist/index.d.ts.map  1.03 kB │ gzip: 0.44 kB
+ℹ [CJS] dist/index.d.ts      1.92 kB │ gzip: 0.67 kB
 [PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-  - rolldown-plugin-dts:generate (48%)
-  - tsdown:deps (46%)
+  - rolldown-plugin-dts:generate (63%)
+ℹ [CJS] 2 files, total: 2.96 kB
+✔ Build complete in 5744ms
+  - tsdown:deps (31%)
 See https://rolldown.rs/options/checks#plugintimings for more details.
 
-✔ Build complete in 5198ms
+ℹ [ESM] dist/index.mjs        5.39 kB │ gzip: 1.77 kB
+ℹ [ESM] dist/index.mjs.map    8.95 kB │ gzip: 2.79 kB
+ℹ [ESM] dist/index.d.mts.map  1.03 kB │ gzip: 0.45 kB
+ℹ [ESM] dist/index.d.mts      1.93 kB │ gzip: 0.67 kB
+ℹ [ESM] 4 files, total: 17.30 kB
 [PLUGIN_TIMINGS] Warning: Your build spent significant time in plugin `rolldown-plugin-dts:generate`. See https://rolldown.rs/options/checks#plugintimings for more details.
-ℹ [ESM] dist/index.mjs        4.54 kB │ gzip: 1.57 kB
 
-ℹ [ESM] dist/index.mjs.map    7.21 kB │ gzip: 2.36 kB
-ℹ [ESM] dist/index.d.mts.map  0.99 kB │ gzip: 0.43 kB
-ℹ [ESM] dist/index.d.mts      1.86 kB │ gzip: 0.66 kB
-ℹ [ESM] 4 files, total: 14.60 kB
-✔ Build complete in 5201ms
+✔ Build complete in 5755ms

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @keq-request/nestjs
 
+## 5.0.0-beta.12
+
+### Minor Changes
+
+- fbc851f: **Feat:** Add `exclude()` method to `KeqMiddlewareConfigProxy`, allowing middleware to skip specific routes. Supports `KeqRouteInfo` with `host`, `method`, and `pathname` patterns, following the NestJS `MiddlewareConfigProxy.exclude()` convention.
+
+### Patch Changes
+
+- keq@5.0.0-beta.12
+
 ## 5.0.0-beta.11
 
 ### Patch Changes

package/dist/index.d.mts

@@ -31,6 +31,7 @@ interface KeqModuleClass {
   readonly KEQ_REQUEST: symbol;
 }
 interface KeqMiddlewareConfigProxy {
+  exclude(...routes: KeqRouteInfo[]): KeqMiddlewareConfigProxy;
   forRoutes(...routes: Array<typeof KEQ_ROUTES.ALL | KeqRouteInfo | KeqModuleClass>): KeqMiddlewareConsumer;
 }
 interface KeqMiddlewareConsumer {

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/keq.module.ts","../src/constants.ts","../src/interfaces/keq-nest-middleware.interface.ts","../src/interfaces/keq-middleware-consumer.interface.ts","../src/interfaces/keq-middleware-module.interface.ts","../src/interfaces/keq-module-options.interface.ts"],"mappings":";;;;;cAYa,SAAA,YAAqB,YAAA;EAAA,iBAEb,gBAAA;EAAA,iBACA,SAAA;EAAA,iBACA,UAAA;cAFA,gBAAA,EAAkB,gBAAA,EAClB,SAAA,EAAW,SAAA,EACX,UAAA,EAAY,UAAA;EAG/B,YAAA,CAAA;AAAA;;;cCnBW,UAAA;EAAA,SAEH,GAAA;AAAA;;;UCCO,iBAAA;EACf,GAAA,CAAI,GAAA,EAAK,mBAAA,EAAqB,IAAA,EAAM,OAAA,UAAiB,WAAA;AAAA;;;UCEtC,YAAA;EACf,IAAA;EACA,MAAA;EACA,QAAA;AAAA;AAAA,UAGe,cAAA;EAAA,SACN,WAAA;AAAA;AAAA,UAGM,wBAAA;EACf,SAAA,IAAa,MAAA,EAAQ,KAAA,QAAa,UAAA,CAAW,GAAA,GAAM,YAAA,GAAe,cAAA,IAAkB,qBAAA;AAAA;AAAA,UAGrE,qBAAA;EACf,KAAA,IAAS,WAAA,EAAa,KAAA,CAAM,IAAA,CAAK,iBAAA,IAAqB,aAAA,IAAiB,wBAAA;AAAA;;;UClBxD,mBAAA;EACf,sBAAA,CAAuB,QAAA,EAAU,qBAAA;AAAA;;;UCDlB,gBAAA;EACf,WAAA,GAAc,aAAA;EACd,OAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/keq.module.ts","../src/constants.ts","../src/interfaces/keq-nest-middleware.interface.ts","../src/interfaces/keq-middleware-consumer.interface.ts","../src/interfaces/keq-middleware-module.interface.ts","../src/interfaces/keq-module-options.interface.ts"],"mappings":";;;;;cAYa,SAAA,YAAqB,YAAA;EAAA,iBAEb,gBAAA;EAAA,iBACA,SAAA;EAAA,iBACA,UAAA;cAFA,gBAAA,EAAkB,gBAAA,EAClB,SAAA,EAAW,SAAA,EACX,UAAA,EAAY,UAAA;EAG/B,YAAA,CAAA;AAAA;;;cCnBW,UAAA;EAAA,SAEH,GAAA;AAAA;;;UCCO,iBAAA;EACf,GAAA,CAAI,GAAA,EAAK,mBAAA,EAAqB,IAAA,EAAM,OAAA,UAAiB,WAAA;AAAA;;;UCEtC,YAAA;EACf,IAAA;EACA,MAAA;EACA,QAAA;AAAA;AAAA,UAGe,cAAA;EAAA,SACN,WAAA;AAAA;AAAA,UAGM,wBAAA;EACf,OAAA,IAAW,MAAA,EAAQ,YAAA,KAAiB,wBAAA;EACpC,SAAA,IAAa,MAAA,EAAQ,KAAA,QAAa,UAAA,CAAW,GAAA,GAAM,YAAA,GAAe,cAAA,IAAkB,qBAAA;AAAA;AAAA,UAGrE,qBAAA;EACf,KAAA,IAAS,WAAA,EAAa,KAAA,CAAM,IAAA,CAAK,iBAAA,IAAqB,aAAA,IAAiB,wBAAA;AAAA;;;UCnBxD,mBAAA;EACf,sBAAA,CAAuB,QAAA,EAAU,qBAAA;AAAA;;;UCDlB,gBAAA;EACf,WAAA,GAAc,aAAA;EACd,OAAA;AAAA"}

package/dist/index.d.ts

@@ -31,6 +31,7 @@ interface KeqModuleClass {
   readonly KEQ_REQUEST: symbol;
 }
 interface KeqMiddlewareConfigProxy {
+  exclude(...routes: KeqRouteInfo[]): KeqMiddlewareConfigProxy;
   forRoutes(...routes: Array<typeof KEQ_ROUTES.ALL | KeqRouteInfo | KeqModuleClass>): KeqMiddlewareConsumer;
 }
 interface KeqMiddlewareConsumer {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/keq.module.ts","../src/constants.ts","../src/interfaces/keq-nest-middleware.interface.ts","../src/interfaces/keq-middleware-consumer.interface.ts","../src/interfaces/keq-middleware-module.interface.ts","../src/interfaces/keq-module-options.interface.ts"],"mappings":";;;;;cAYa,SAAA,YAAqB,YAAA;EAAA,iBAEb,gBAAA;EAAA,iBACA,SAAA;EAAA,iBACA,UAAA;cAFA,gBAAA,EAAkB,gBAAA,EAClB,SAAA,EAAW,SAAA,EACX,UAAA,EAAY,UAAA;EAG/B,YAAA,CAAA;AAAA;;;cCnBW,UAAA;EAAA,SAEH,GAAA;AAAA;;;UCCO,iBAAA;EACf,GAAA,CAAI,GAAA,EAAK,mBAAA,EAAqB,IAAA,EAAM,OAAA,UAAiB,WAAA;AAAA;;;UCEtC,YAAA;EACf,IAAA;EACA,MAAA;EACA,QAAA;AAAA;AAAA,UAGe,cAAA;EAAA,SACN,WAAA;AAAA;AAAA,UAGM,wBAAA;EACf,SAAA,IAAa,MAAA,EAAQ,KAAA,QAAa,UAAA,CAAW,GAAA,GAAM,YAAA,GAAe,cAAA,IAAkB,qBAAA;AAAA;AAAA,UAGrE,qBAAA;EACf,KAAA,IAAS,WAAA,EAAa,KAAA,CAAM,IAAA,CAAK,iBAAA,IAAqB,aAAA,IAAiB,wBAAA;AAAA;;;UClBxD,mBAAA;EACf,sBAAA,CAAuB,QAAA,EAAU,qBAAA;AAAA;;;UCDlB,gBAAA;EACf,WAAA,GAAc,aAAA;EACd,OAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/keq.module.ts","../src/constants.ts","../src/interfaces/keq-nest-middleware.interface.ts","../src/interfaces/keq-middleware-consumer.interface.ts","../src/interfaces/keq-middleware-module.interface.ts","../src/interfaces/keq-module-options.interface.ts"],"mappings":";;;;;cAYa,SAAA,YAAqB,YAAA;EAAA,iBAEb,gBAAA;EAAA,iBACA,SAAA;EAAA,iBACA,UAAA;cAFA,gBAAA,EAAkB,gBAAA,EAClB,SAAA,EAAW,SAAA,EACX,UAAA,EAAY,UAAA;EAG/B,YAAA,CAAA;AAAA;;;cCnBW,UAAA;EAAA,SAEH,GAAA;AAAA;;;UCCO,iBAAA;EACf,GAAA,CAAI,GAAA,EAAK,mBAAA,EAAqB,IAAA,EAAM,OAAA,UAAiB,WAAA;AAAA;;;UCEtC,YAAA;EACf,IAAA;EACA,MAAA;EACA,QAAA;AAAA;AAAA,UAGe,cAAA;EAAA,SACN,WAAA;AAAA;AAAA,UAGM,wBAAA;EACf,OAAA,IAAW,MAAA,EAAQ,YAAA,KAAiB,wBAAA;EACpC,SAAA,IAAa,MAAA,EAAQ,KAAA,QAAa,UAAA,CAAW,GAAA,GAAM,YAAA,GAAe,cAAA,IAAkB,qBAAA;AAAA;AAAA,UAGrE,qBAAA;EACf,KAAA,IAAS,WAAA,EAAa,KAAA,CAAM,IAAA,CAAK,iBAAA,IAAqB,aAAA,IAAiB,wBAAA;AAAA;;;UCnBxD,mBAAA;EACf,sBAAA,CAAuB,QAAA,EAAU,qBAAA;AAAA;;;UCDlB,gBAAA;EACf,WAAA,GAAc,aAAA;EACd,OAAA;AAAA"}

package/dist/index.js

@@ -37,15 +37,28 @@ var KeqMiddlewareConsumerImpl = class {
 			middlewares,
 			routes: []
 		};
+		const excludedRouteInfos = [];
 		this.entries.push(entry);
-		return { forRoutes: (...routes) => {
-			entry.routes = routes;
-			return this;
-		} };
+		const proxy = {
+			exclude: (...routes) => {
+				excludedRouteInfos.push(...routes);
+				return proxy;
+			},
+			forRoutes: (...routes) => {
+				entry.routes = routes;
+				if (excludedRouteInfos.length > 0) entry.excludedRouteInfos = excludedRouteInfos;
+				return this;
+			}
+		};
+		return proxy;
 	}
 	applyTo(keqRequest, moduleRef) {
 		for (const entry of this.entries) {
-			const resolved = entry.middlewares.map((m) => this.resolveMiddleware(m, moduleRef));
+			let resolved = entry.middlewares.map((m) => this.resolveMiddleware(m, moduleRef));
+			if (entry.excludedRouteInfos && entry.excludedRouteInfos.length > 0) {
+				const excludedRoutes = entry.excludedRouteInfos.map((info) => this.buildRoute(info));
+				resolved = resolved.map((mw) => this.wrapWithExclusion(mw, excludedRoutes));
+			}
 			if (entry.routes.length === 0 || entry.routes.some((r) => r === KEQ_ROUTES.ALL)) for (const mw of resolved) keqRequest.use(mw);
 			else for (const routeTarget of entry.routes) {
 				if (routeTarget === KEQ_ROUTES.ALL) continue;
@@ -91,6 +104,17 @@ var KeqMiddlewareConsumerImpl = class {
 		if (routes.length === 1) return routes[0];
 		return (0, keq.composeRoute)(routes);
 	}
+	wrapWithExclusion(middleware, excludedRoutes) {
+		const excluded = async (ctx, next) => {
+			if (await this.checkExcluded(ctx, excludedRoutes)) return next();
+			return middleware(ctx, next);
+		};
+		return excluded;
+	}
+	async checkExcluded(ctx, excludedRoutes) {
+		for (const route of excludedRoutes) if (await route(ctx)) return true;
+		return false;
+	}
 };
 //#endregion
 //#region src/utils/has-configure-keq-middleware.ts

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["KeqRequest"],"sources":["../src/constants.ts","../src/keq-middleware-consumer.ts","../src/utils/has-configure-keq-middleware.ts","../src/keq.module.ts"],"sourcesContent":["export const KEQ_ROUTES = {\n  ALL: Symbol('KEQ_ROUTES.ALL'),\n} as const\n","import type { Type } from '@nestjs/common'\nimport type { ModuleRef } from '@nestjs/core'\nimport type { KeqMiddleware, KeqRoute } from 'keq'\nimport { composeRoute, KeqRequest } from 'keq'\nimport picomatch from 'picomatch'\nimport { KEQ_ROUTES } from './constants.js'\nimport type { KeqMiddlewareConfigProxy, KeqMiddlewareConsumer, KeqModuleClass, KeqRouteInfo } from './interfaces/keq-middleware-consumer.interface.js'\nimport type { KeqNestMiddleware } from './interfaces/keq-nest-middleware.interface.js'\n\n\ninterface MiddlewareEntry {\n  middlewares: Array<Type<KeqNestMiddleware> | KeqMiddleware>\n  routes: Array<typeof KEQ_ROUTES.ALL | KeqRouteInfo | KeqModuleClass>\n}\n\nexport class KeqMiddlewareConsumerImpl implements KeqMiddlewareConsumer {\n  private entries: MiddlewareEntry[] = []\n\n  apply(...middlewares: Array<Type<KeqNestMiddleware> | KeqMiddleware>): KeqMiddlewareConfigProxy {\n    const entry: MiddlewareEntry = { middlewares, routes: [] }\n    this.entries.push(entry)\n    return {\n      forRoutes: (...routes) => {\n        entry.routes = routes\n        return this\n      },\n    }\n  }\n\n  applyTo(keqRequest: KeqRequest, moduleRef: ModuleRef): void {\n    for (const entry of this.entries) {\n      const resolved = entry.middlewares.map((m) => this.resolveMiddleware(m, moduleRef))\n      const isGlobal = entry.routes.length === 0\n        || entry.routes.some((r) => r === KEQ_ROUTES.ALL)\n\n      if (isGlobal) {\n        for (const mw of resolved) keqRequest.use(mw)\n      } else {\n        for (const routeTarget of entry.routes) {\n          if (routeTarget === KEQ_ROUTES.ALL) continue\n\n          if (this.isKeqModuleClass(routeTarget)) {\n            const targetRequest = moduleRef.get<KeqRequest>(routeTarget.KEQ_REQUEST, { strict: false })\n            if (targetRequest) {\n              for (const mw of resolved) targetRequest.use(mw)\n            }\n          } else {\n            const route = this.buildRoute(routeTarget as KeqRouteInfo)\n            keqRequest.useRouter().route(route, resolved)\n          }\n        }\n      }\n    }\n  }\n\n  private isKeqModuleClass(route: unknown): route is KeqModuleClass {\n    return (\n      typeof route === 'function'\n      && 'KEQ_REQUEST' in route\n      && typeof (route as Record<string, unknown>).KEQ_REQUEST === 'symbol'\n    )\n  }\n\n  private isNestMiddlewareClass(m: Type<KeqNestMiddleware> | KeqMiddleware): m is Type<KeqNestMiddleware> {\n    return typeof m === 'function' && m.prototype !== undefined && 'use' in m.prototype\n  }\n\n  private resolveMiddleware(m: Type<KeqNestMiddleware> | KeqMiddleware, moduleRef: ModuleRef): KeqMiddleware {\n    if (this.isNestMiddlewareClass(m)) {\n      const instance = moduleRef.get<KeqNestMiddleware>(m, { strict: false })\n      return async (ctx, next) => {\n        await instance.use(ctx, next)\n      }\n    }\n    return m\n  }\n\n  private buildRoute(info: KeqRouteInfo): KeqRoute {\n    const routes: KeqRoute[] = []\n    if (info.host) {\n      const host = info.host\n      routes.push((ctx) => ctx.request.url.host === host)\n    }\n    if (info.method) {\n      const method = info.method.toLowerCase()\n      routes.push((ctx) => ctx.request.method.toLowerCase() === method)\n    }\n    if (info.pathname) {\n      const isMatch: (test: string) => boolean = picomatch(info.pathname)\n      routes.push((ctx) => isMatch(ctx.request.url.pathname))\n    }\n    if (routes.length === 1) return routes[0]\n    return composeRoute(routes)\n  }\n}\n","import type { KeqMiddlewareModule } from '../interfaces/keq-middleware-module.interface.js'\n\n\nexport function hasConfigureKeqMiddleware(instance: unknown): instance is KeqMiddlewareModule {\n  return (\n    instance !== null\n    && instance !== undefined\n    && typeof (instance as Record<string, unknown>).configureKeqMiddleware === 'function'\n  )\n}\n","import { Global, Module, OnModuleInit } from '@nestjs/common'\nimport { ModulesContainer, ModuleRef } from '@nestjs/core'\nimport { KeqRequest } from 'keq'\nimport { KeqMiddlewareConsumerImpl } from './keq-middleware-consumer.js'\nimport { hasConfigureKeqMiddleware } from './utils/has-configure-keq-middleware.js'\n\n\n@Global()\n@Module({\n  providers: [{ provide: KeqRequest, useFactory: () => new KeqRequest() }],\n  exports: [KeqRequest],\n})\nexport class KeqModule implements OnModuleInit {\n  constructor(\n    private readonly modulesContainer: ModulesContainer,\n    private readonly moduleRef: ModuleRef,\n    private readonly keqRequest: KeqRequest,\n  ) {}\n\n  onModuleInit(): void {\n    for (const [, moduleWrapper] of this.modulesContainer) {\n      const instance = moduleWrapper.instance\n      if (hasConfigureKeqMiddleware(instance)) {\n        const consumer = new KeqMiddlewareConsumerImpl()\n        instance.configureKeqMiddleware(consumer)\n        consumer.applyTo(this.keqRequest, this.moduleRef)\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["KeqRequest"],"sources":["../src/constants.ts","../src/keq-middleware-consumer.ts","../src/utils/has-configure-keq-middleware.ts","../src/keq.module.ts"],"sourcesContent":["export const KEQ_ROUTES = {\n  ALL: Symbol('KEQ_ROUTES.ALL'),\n} as const\n","import type { Type } from '@nestjs/common'\nimport type { ModuleRef } from '@nestjs/core'\nimport type { KeqExecutionContext, KeqMiddleware, KeqRoute } from 'keq'\nimport { composeRoute, KeqRequest } from 'keq'\nimport picomatch from 'picomatch'\nimport { KEQ_ROUTES } from './constants.js'\nimport type { KeqMiddlewareConfigProxy, KeqMiddlewareConsumer, KeqModuleClass, KeqRouteInfo } from './interfaces/keq-middleware-consumer.interface.js'\nimport type { KeqNestMiddleware } from './interfaces/keq-nest-middleware.interface.js'\n\n\ninterface MiddlewareEntry {\n  middlewares: Array<Type<KeqNestMiddleware> | KeqMiddleware>\n  routes: Array<typeof KEQ_ROUTES.ALL | KeqRouteInfo | KeqModuleClass>\n  excludedRouteInfos?: KeqRouteInfo[]\n}\n\nexport class KeqMiddlewareConsumerImpl implements KeqMiddlewareConsumer {\n  private entries: MiddlewareEntry[] = []\n\n  apply(...middlewares: Array<Type<KeqNestMiddleware> | KeqMiddleware>): KeqMiddlewareConfigProxy {\n    const entry: MiddlewareEntry = { middlewares, routes: [] }\n    const excludedRouteInfos: KeqRouteInfo[] = []\n    this.entries.push(entry)\n\n    const proxy: KeqMiddlewareConfigProxy = {\n      exclude: (...routes) => {\n        excludedRouteInfos.push(...routes)\n        return proxy\n      },\n      forRoutes: (...routes) => {\n        entry.routes = routes\n        if (excludedRouteInfos.length > 0) {\n          entry.excludedRouteInfos = excludedRouteInfos\n        }\n        return this\n      },\n    }\n    return proxy\n  }\n\n  applyTo(keqRequest: KeqRequest, moduleRef: ModuleRef): void {\n    for (const entry of this.entries) {\n      let resolved = entry.middlewares.map((m) => this.resolveMiddleware(m, moduleRef))\n\n      if (entry.excludedRouteInfos && entry.excludedRouteInfos.length > 0) {\n        const excludedRoutes = entry.excludedRouteInfos.map((info) => this.buildRoute(info))\n        resolved = resolved.map((mw) => this.wrapWithExclusion(mw, excludedRoutes))\n      }\n\n      const isGlobal = entry.routes.length === 0\n        || entry.routes.some((r) => r === KEQ_ROUTES.ALL)\n\n      if (isGlobal) {\n        for (const mw of resolved) keqRequest.use(mw)\n      } else {\n        for (const routeTarget of entry.routes) {\n          if (routeTarget === KEQ_ROUTES.ALL) continue\n\n          if (this.isKeqModuleClass(routeTarget)) {\n            const targetRequest = moduleRef.get<KeqRequest>(routeTarget.KEQ_REQUEST, { strict: false })\n            if (targetRequest) {\n              for (const mw of resolved) targetRequest.use(mw)\n            }\n          } else {\n            const route = this.buildRoute(routeTarget as KeqRouteInfo)\n            keqRequest.useRouter().route(route, resolved)\n          }\n        }\n      }\n    }\n  }\n\n  private isKeqModuleClass(route: unknown): route is KeqModuleClass {\n    return (\n      typeof route === 'function'\n      && 'KEQ_REQUEST' in route\n      && typeof (route as Record<string, unknown>).KEQ_REQUEST === 'symbol'\n    )\n  }\n\n  private isNestMiddlewareClass(m: Type<KeqNestMiddleware> | KeqMiddleware): m is Type<KeqNestMiddleware> {\n    return typeof m === 'function' && m.prototype !== undefined && 'use' in m.prototype\n  }\n\n  private resolveMiddleware(m: Type<KeqNestMiddleware> | KeqMiddleware, moduleRef: ModuleRef): KeqMiddleware {\n    if (this.isNestMiddlewareClass(m)) {\n      const instance = moduleRef.get<KeqNestMiddleware>(m, { strict: false })\n      return async (ctx, next) => {\n        await instance.use(ctx, next)\n      }\n    }\n    return m\n  }\n\n  private buildRoute(info: KeqRouteInfo): KeqRoute {\n    const routes: KeqRoute[] = []\n    if (info.host) {\n      const host = info.host\n      routes.push((ctx) => ctx.request.url.host === host)\n    }\n    if (info.method) {\n      const method = info.method.toLowerCase()\n      routes.push((ctx) => ctx.request.method.toLowerCase() === method)\n    }\n    if (info.pathname) {\n      const isMatch: (test: string) => boolean = picomatch(info.pathname)\n      routes.push((ctx) => isMatch(ctx.request.url.pathname))\n    }\n    if (routes.length === 1) return routes[0]\n    return composeRoute(routes)\n  }\n\n  private wrapWithExclusion(middleware: KeqMiddleware, excludedRoutes: KeqRoute[]): KeqMiddleware {\n    const excluded: KeqMiddleware = async (ctx, next) => {\n      if (await this.checkExcluded(ctx, excludedRoutes)) {\n        return next()\n      }\n      return middleware(ctx, next)\n    }\n    return excluded\n  }\n\n  private async checkExcluded(ctx: KeqExecutionContext, excludedRoutes: KeqRoute[]): Promise<boolean> {\n    for (const route of excludedRoutes) {\n      if (await route(ctx)) return true\n    }\n    return false\n  }\n}\n","import type { KeqMiddlewareModule } from '../interfaces/keq-middleware-module.interface.js'\n\n\nexport function hasConfigureKeqMiddleware(instance: unknown): instance is KeqMiddlewareModule {\n  return (\n    instance !== null\n    && instance !== undefined\n    && typeof (instance as Record<string, unknown>).configureKeqMiddleware === 'function'\n  )\n}\n","import { Global, Module, OnModuleInit } from '@nestjs/common'\nimport { ModulesContainer, ModuleRef } from '@nestjs/core'\nimport { KeqRequest } from 'keq'\nimport { KeqMiddlewareConsumerImpl } from './keq-middleware-consumer.js'\nimport { hasConfigureKeqMiddleware } from './utils/has-configure-keq-middleware.js'\n\n\n@Global()\n@Module({\n  providers: [{ provide: KeqRequest, useFactory: () => new KeqRequest() }],\n  exports: [KeqRequest],\n})\nexport class KeqModule implements OnModuleInit {\n  constructor(\n    private readonly modulesContainer: ModulesContainer,\n    private readonly moduleRef: ModuleRef,\n    private readonly keqRequest: KeqRequest,\n  ) {}\n\n  onModuleInit(): void {\n    for (const [, moduleWrapper] of this.modulesContainer) {\n      const instance = moduleWrapper.instance\n      if (hasConfigureKeqMiddleware(instance)) {\n        const consumer = new KeqMiddlewareConsumerImpl()\n        instance.configureKeqMiddleware(consumer)\n        consumer.applyTo(this.keqRequest, this.moduleRef)\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/index.mjs

@@ -13,15 +13,28 @@ var KeqMiddlewareConsumerImpl = class {
 			middlewares,
 			routes: []
 		};
+		const excludedRouteInfos = [];
 		this.entries.push(entry);
-		return { forRoutes: (...routes) => {
-			entry.routes = routes;
-			return this;
-		} };
+		const proxy = {
+			exclude: (...routes) => {
+				excludedRouteInfos.push(...routes);
+				return proxy;
+			},
+			forRoutes: (...routes) => {
+				entry.routes = routes;
+				if (excludedRouteInfos.length > 0) entry.excludedRouteInfos = excludedRouteInfos;
+				return this;
+			}
+		};
+		return proxy;
 	}
 	applyTo(keqRequest, moduleRef) {
 		for (const entry of this.entries) {
-			const resolved = entry.middlewares.map((m) => this.resolveMiddleware(m, moduleRef));
+			let resolved = entry.middlewares.map((m) => this.resolveMiddleware(m, moduleRef));
+			if (entry.excludedRouteInfos && entry.excludedRouteInfos.length > 0) {
+				const excludedRoutes = entry.excludedRouteInfos.map((info) => this.buildRoute(info));
+				resolved = resolved.map((mw) => this.wrapWithExclusion(mw, excludedRoutes));
+			}
 			if (entry.routes.length === 0 || entry.routes.some((r) => r === KEQ_ROUTES.ALL)) for (const mw of resolved) keqRequest.use(mw);
 			else for (const routeTarget of entry.routes) {
 				if (routeTarget === KEQ_ROUTES.ALL) continue;
@@ -67,6 +80,17 @@ var KeqMiddlewareConsumerImpl = class {
 		if (routes.length === 1) return routes[0];
 		return composeRoute(routes);
 	}
+	wrapWithExclusion(middleware, excludedRoutes) {
+		const excluded = async (ctx, next) => {
+			if (await this.checkExcluded(ctx, excludedRoutes)) return next();
+			return middleware(ctx, next);
+		};
+		return excluded;
+	}
+	async checkExcluded(ctx, excludedRoutes) {
+		for (const route of excludedRoutes) if (await route(ctx)) return true;
+		return false;
+	}
 };
 //#endregion
 //#region src/utils/has-configure-keq-middleware.ts

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/constants.ts","../src/keq-middleware-consumer.ts","../src/utils/has-configure-keq-middleware.ts","../src/keq.module.ts"],"sourcesContent":["export const KEQ_ROUTES = {\n  ALL: Symbol('KEQ_ROUTES.ALL'),\n} as const\n","import type { Type } from '@nestjs/common'\nimport type { ModuleRef } from '@nestjs/core'\nimport type { KeqMiddleware, KeqRoute } from 'keq'\nimport { composeRoute, KeqRequest } from 'keq'\nimport picomatch from 'picomatch'\nimport { KEQ_ROUTES } from './constants.js'\nimport type { KeqMiddlewareConfigProxy, KeqMiddlewareConsumer, KeqModuleClass, KeqRouteInfo } from './interfaces/keq-middleware-consumer.interface.js'\nimport type { KeqNestMiddleware } from './interfaces/keq-nest-middleware.interface.js'\n\n\ninterface MiddlewareEntry {\n  middlewares: Array<Type<KeqNestMiddleware> | KeqMiddleware>\n  routes: Array<typeof KEQ_ROUTES.ALL | KeqRouteInfo | KeqModuleClass>\n}\n\nexport class KeqMiddlewareConsumerImpl implements KeqMiddlewareConsumer {\n  private entries: MiddlewareEntry[] = []\n\n  apply(...middlewares: Array<Type<KeqNestMiddleware> | KeqMiddleware>): KeqMiddlewareConfigProxy {\n    const entry: MiddlewareEntry = { middlewares, routes: [] }\n    this.entries.push(entry)\n    return {\n      forRoutes: (...routes) => {\n        entry.routes = routes\n        return this\n      },\n    }\n  }\n\n  applyTo(keqRequest: KeqRequest, moduleRef: ModuleRef): void {\n    for (const entry of this.entries) {\n      const resolved = entry.middlewares.map((m) => this.resolveMiddleware(m, moduleRef))\n      const isGlobal = entry.routes.length === 0\n        || entry.routes.some((r) => r === KEQ_ROUTES.ALL)\n\n      if (isGlobal) {\n        for (const mw of resolved) keqRequest.use(mw)\n      } else {\n        for (const routeTarget of entry.routes) {\n          if (routeTarget === KEQ_ROUTES.ALL) continue\n\n          if (this.isKeqModuleClass(routeTarget)) {\n            const targetRequest = moduleRef.get<KeqRequest>(routeTarget.KEQ_REQUEST, { strict: false })\n            if (targetRequest) {\n              for (const mw of resolved) targetRequest.use(mw)\n            }\n          } else {\n            const route = this.buildRoute(routeTarget as KeqRouteInfo)\n            keqRequest.useRouter().route(route, resolved)\n          }\n        }\n      }\n    }\n  }\n\n  private isKeqModuleClass(route: unknown): route is KeqModuleClass {\n    return (\n      typeof route === 'function'\n      && 'KEQ_REQUEST' in route\n      && typeof (route as Record<string, unknown>).KEQ_REQUEST === 'symbol'\n    )\n  }\n\n  private isNestMiddlewareClass(m: Type<KeqNestMiddleware> | KeqMiddleware): m is Type<KeqNestMiddleware> {\n    return typeof m === 'function' && m.prototype !== undefined && 'use' in m.prototype\n  }\n\n  private resolveMiddleware(m: Type<KeqNestMiddleware> | KeqMiddleware, moduleRef: ModuleRef): KeqMiddleware {\n    if (this.isNestMiddlewareClass(m)) {\n      const instance = moduleRef.get<KeqNestMiddleware>(m, { strict: false })\n      return async (ctx, next) => {\n        await instance.use(ctx, next)\n      }\n    }\n    return m\n  }\n\n  private buildRoute(info: KeqRouteInfo): KeqRoute {\n    const routes: KeqRoute[] = []\n    if (info.host) {\n      const host = info.host\n      routes.push((ctx) => ctx.request.url.host === host)\n    }\n    if (info.method) {\n      const method = info.method.toLowerCase()\n      routes.push((ctx) => ctx.request.method.toLowerCase() === method)\n    }\n    if (info.pathname) {\n      const isMatch: (test: string) => boolean = picomatch(info.pathname)\n      routes.push((ctx) => isMatch(ctx.request.url.pathname))\n    }\n    if (routes.length === 1) return routes[0]\n    return composeRoute(routes)\n  }\n}\n","import type { KeqMiddlewareModule } from '../interfaces/keq-middleware-module.interface.js'\n\n\nexport function hasConfigureKeqMiddleware(instance: unknown): instance is KeqMiddlewareModule {\n  return (\n    instance !== null\n    && instance !== undefined\n    && typeof (instance as Record<string, unknown>).configureKeqMiddleware === 'function'\n  )\n}\n","import { Global, Module, OnModuleInit } from '@nestjs/common'\nimport { ModulesContainer, ModuleRef } from '@nestjs/core'\nimport { KeqRequest } from 'keq'\nimport { KeqMiddlewareConsumerImpl } from './keq-middleware-consumer.js'\nimport { hasConfigureKeqMiddleware } from './utils/has-configure-keq-middleware.js'\n\n\n@Global()\n@Module({\n  providers: [{ provide: KeqRequest, useFactory: () => new KeqRequest() }],\n  exports: [KeqRequest],\n})\nexport class KeqModule implements OnModuleInit {\n  constructor(\n    private readonly modulesContainer: ModulesContainer,\n    private readonly moduleRef: ModuleRef,\n    private readonly keqRequest: KeqRequest,\n  ) {}\n\n  onModuleInit(): void {\n    for (const [, moduleWrapper] of this.modulesContainer) {\n      const instance = moduleWrapper.instance\n      if (hasConfigureKeqMiddleware(instance)) {\n        const consumer = new KeqMiddlewareConsumerImpl()\n        instance.configureKeqMiddleware(consumer)\n        consumer.applyTo(this.keqRequest, this.moduleRef)\n      }\n    }\n  }\n}\n"],"mappings":";;;;;AAAA,MAAa,aAAa,EACxB,KAAK,OAAO,iBAAiB,EAC9B;;;ACaD,IAAa,4BAAb,MAAwE;CACtE,UAAqC,EAAE;CAEvC,MAAM,GAAG,aAAuF;EAC9F,MAAM,QAAyB;GAAE;GAAa,QAAQ,EAAE;GAAE;AAC1D,OAAK,QAAQ,KAAK,MAAM;AACxB,SAAO,EACL,YAAY,GAAG,WAAW;AACxB,SAAM,SAAS;AACf,UAAO;KAEV;;CAGH,QAAQ,YAAwB,WAA4B;AAC1D,OAAK,MAAM,SAAS,KAAK,SAAS;GAChC,MAAM,WAAW,MAAM,YAAY,KAAK,MAAM,KAAK,kBAAkB,GAAG,UAAU,CAAC;AAInF,OAHiB,MAAM,OAAO,WAAW,KACpC,MAAM,OAAO,MAAM,MAAM,MAAM,WAAW,IAAI,CAGjD,MAAK,MAAM,MAAM,SAAU,YAAW,IAAI,GAAG;OAE7C,MAAK,MAAM,eAAe,MAAM,QAAQ;AACtC,QAAI,gBAAgB,WAAW,IAAK;AAEpC,QAAI,KAAK,iBAAiB,YAAY,EAAE;KACtC,MAAM,gBAAgB,UAAU,IAAgB,YAAY,aAAa,EAAE,QAAQ,OAAO,CAAC;AAC3F,SAAI,cACF,MAAK,MAAM,MAAM,SAAU,eAAc,IAAI,GAAG;WAE7C;KACL,MAAM,QAAQ,KAAK,WAAW,YAA4B;AAC1D,gBAAW,WAAW,CAAC,MAAM,OAAO,SAAS;;;;;CAOvD,iBAAyB,OAAyC;AAChE,SACE,OAAO,UAAU,cACd,iBAAiB,SACjB,OAAQ,MAAkC,gBAAgB;;CAIjE,sBAA8B,GAA0E;AACtG,SAAO,OAAO,MAAM,cAAc,EAAE,cAAc,KAAA,KAAa,SAAS,EAAE;;CAG5E,kBAA0B,GAA4C,WAAqC;AACzG,MAAI,KAAK,sBAAsB,EAAE,EAAE;GACjC,MAAM,WAAW,UAAU,IAAuB,GAAG,EAAE,QAAQ,OAAO,CAAC;AACvE,UAAO,OAAO,KAAK,SAAS;AAC1B,UAAM,SAAS,IAAI,KAAK,KAAK;;;AAGjC,SAAO;;CAGT,WAAmB,MAA8B;EAC/C,MAAM,SAAqB,EAAE;AAC7B,MAAI,KAAK,MAAM;GACb,MAAM,OAAO,KAAK;AAClB,UAAO,MAAM,QAAQ,IAAI,QAAQ,IAAI,SAAS,KAAK;;AAErD,MAAI,KAAK,QAAQ;GACf,MAAM,SAAS,KAAK,OAAO,aAAa;AACxC,UAAO,MAAM,QAAQ,IAAI,QAAQ,OAAO,aAAa,KAAK,OAAO;;AAEnE,MAAI,KAAK,UAAU;GACjB,MAAM,UAAqC,UAAU,KAAK,SAAS;AACnE,UAAO,MAAM,QAAQ,QAAQ,IAAI,QAAQ,IAAI,SAAS,CAAC;;AAEzD,MAAI,OAAO,WAAW,EAAG,QAAO,OAAO;AACvC,SAAO,aAAa,OAAO;;;;;ACzF/B,SAAgB,0BAA0B,UAAoD;AAC5F,QACE,aAAa,QACV,aAAa,KAAA,KACb,OAAQ,SAAqC,2BAA2B;;;;;;;;;;;;;;;;;;ACKxE,IAAA,YAAA,MAAM,UAAkC;CAC7C,YACE,kBACA,WACA,YACA;AAHiB,OAAA,mBAAA;AACA,OAAA,YAAA;AACA,OAAA,aAAA;;CAGnB,eAAqB;AACnB,OAAK,MAAM,GAAG,kBAAkB,KAAK,kBAAkB;GACrD,MAAM,WAAW,cAAc;AAC/B,OAAI,0BAA0B,SAAS,EAAE;IACvC,MAAM,WAAW,IAAI,2BAA2B;AAChD,aAAS,uBAAuB,SAAS;AACzC,aAAS,QAAQ,KAAK,YAAY,KAAK,UAAU;;;;;;CAlBxD,QAAQ;CACR,OAAO;EACN,WAAW,CAAC;GAAE,SAAS;GAAY,kBAAkB,IAAI,YAAY;GAAE,CAAC;EACxE,SAAS,CAAC,WAAW;EACtB,CAAC"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/constants.ts","../src/keq-middleware-consumer.ts","../src/utils/has-configure-keq-middleware.ts","../src/keq.module.ts"],"sourcesContent":["export const KEQ_ROUTES = {\n  ALL: Symbol('KEQ_ROUTES.ALL'),\n} as const\n","import type { Type } from '@nestjs/common'\nimport type { ModuleRef } from '@nestjs/core'\nimport type { KeqExecutionContext, KeqMiddleware, KeqRoute } from 'keq'\nimport { composeRoute, KeqRequest } from 'keq'\nimport picomatch from 'picomatch'\nimport { KEQ_ROUTES } from './constants.js'\nimport type { KeqMiddlewareConfigProxy, KeqMiddlewareConsumer, KeqModuleClass, KeqRouteInfo } from './interfaces/keq-middleware-consumer.interface.js'\nimport type { KeqNestMiddleware } from './interfaces/keq-nest-middleware.interface.js'\n\n\ninterface MiddlewareEntry {\n  middlewares: Array<Type<KeqNestMiddleware> | KeqMiddleware>\n  routes: Array<typeof KEQ_ROUTES.ALL | KeqRouteInfo | KeqModuleClass>\n  excludedRouteInfos?: KeqRouteInfo[]\n}\n\nexport class KeqMiddlewareConsumerImpl implements KeqMiddlewareConsumer {\n  private entries: MiddlewareEntry[] = []\n\n  apply(...middlewares: Array<Type<KeqNestMiddleware> | KeqMiddleware>): KeqMiddlewareConfigProxy {\n    const entry: MiddlewareEntry = { middlewares, routes: [] }\n    const excludedRouteInfos: KeqRouteInfo[] = []\n    this.entries.push(entry)\n\n    const proxy: KeqMiddlewareConfigProxy = {\n      exclude: (...routes) => {\n        excludedRouteInfos.push(...routes)\n        return proxy\n      },\n      forRoutes: (...routes) => {\n        entry.routes = routes\n        if (excludedRouteInfos.length > 0) {\n          entry.excludedRouteInfos = excludedRouteInfos\n        }\n        return this\n      },\n    }\n    return proxy\n  }\n\n  applyTo(keqRequest: KeqRequest, moduleRef: ModuleRef): void {\n    for (const entry of this.entries) {\n      let resolved = entry.middlewares.map((m) => this.resolveMiddleware(m, moduleRef))\n\n      if (entry.excludedRouteInfos && entry.excludedRouteInfos.length > 0) {\n        const excludedRoutes = entry.excludedRouteInfos.map((info) => this.buildRoute(info))\n        resolved = resolved.map((mw) => this.wrapWithExclusion(mw, excludedRoutes))\n      }\n\n      const isGlobal = entry.routes.length === 0\n        || entry.routes.some((r) => r === KEQ_ROUTES.ALL)\n\n      if (isGlobal) {\n        for (const mw of resolved) keqRequest.use(mw)\n      } else {\n        for (const routeTarget of entry.routes) {\n          if (routeTarget === KEQ_ROUTES.ALL) continue\n\n          if (this.isKeqModuleClass(routeTarget)) {\n            const targetRequest = moduleRef.get<KeqRequest>(routeTarget.KEQ_REQUEST, { strict: false })\n            if (targetRequest) {\n              for (const mw of resolved) targetRequest.use(mw)\n            }\n          } else {\n            const route = this.buildRoute(routeTarget as KeqRouteInfo)\n            keqRequest.useRouter().route(route, resolved)\n          }\n        }\n      }\n    }\n  }\n\n  private isKeqModuleClass(route: unknown): route is KeqModuleClass {\n    return (\n      typeof route === 'function'\n      && 'KEQ_REQUEST' in route\n      && typeof (route as Record<string, unknown>).KEQ_REQUEST === 'symbol'\n    )\n  }\n\n  private isNestMiddlewareClass(m: Type<KeqNestMiddleware> | KeqMiddleware): m is Type<KeqNestMiddleware> {\n    return typeof m === 'function' && m.prototype !== undefined && 'use' in m.prototype\n  }\n\n  private resolveMiddleware(m: Type<KeqNestMiddleware> | KeqMiddleware, moduleRef: ModuleRef): KeqMiddleware {\n    if (this.isNestMiddlewareClass(m)) {\n      const instance = moduleRef.get<KeqNestMiddleware>(m, { strict: false })\n      return async (ctx, next) => {\n        await instance.use(ctx, next)\n      }\n    }\n    return m\n  }\n\n  private buildRoute(info: KeqRouteInfo): KeqRoute {\n    const routes: KeqRoute[] = []\n    if (info.host) {\n      const host = info.host\n      routes.push((ctx) => ctx.request.url.host === host)\n    }\n    if (info.method) {\n      const method = info.method.toLowerCase()\n      routes.push((ctx) => ctx.request.method.toLowerCase() === method)\n    }\n    if (info.pathname) {\n      const isMatch: (test: string) => boolean = picomatch(info.pathname)\n      routes.push((ctx) => isMatch(ctx.request.url.pathname))\n    }\n    if (routes.length === 1) return routes[0]\n    return composeRoute(routes)\n  }\n\n  private wrapWithExclusion(middleware: KeqMiddleware, excludedRoutes: KeqRoute[]): KeqMiddleware {\n    const excluded: KeqMiddleware = async (ctx, next) => {\n      if (await this.checkExcluded(ctx, excludedRoutes)) {\n        return next()\n      }\n      return middleware(ctx, next)\n    }\n    return excluded\n  }\n\n  private async checkExcluded(ctx: KeqExecutionContext, excludedRoutes: KeqRoute[]): Promise<boolean> {\n    for (const route of excludedRoutes) {\n      if (await route(ctx)) return true\n    }\n    return false\n  }\n}\n","import type { KeqMiddlewareModule } from '../interfaces/keq-middleware-module.interface.js'\n\n\nexport function hasConfigureKeqMiddleware(instance: unknown): instance is KeqMiddlewareModule {\n  return (\n    instance !== null\n    && instance !== undefined\n    && typeof (instance as Record<string, unknown>).configureKeqMiddleware === 'function'\n  )\n}\n","import { Global, Module, OnModuleInit } from '@nestjs/common'\nimport { ModulesContainer, ModuleRef } from '@nestjs/core'\nimport { KeqRequest } from 'keq'\nimport { KeqMiddlewareConsumerImpl } from './keq-middleware-consumer.js'\nimport { hasConfigureKeqMiddleware } from './utils/has-configure-keq-middleware.js'\n\n\n@Global()\n@Module({\n  providers: [{ provide: KeqRequest, useFactory: () => new KeqRequest() }],\n  exports: [KeqRequest],\n})\nexport class KeqModule implements OnModuleInit {\n  constructor(\n    private readonly modulesContainer: ModulesContainer,\n    private readonly moduleRef: ModuleRef,\n    private readonly keqRequest: KeqRequest,\n  ) {}\n\n  onModuleInit(): void {\n    for (const [, moduleWrapper] of this.modulesContainer) {\n      const instance = moduleWrapper.instance\n      if (hasConfigureKeqMiddleware(instance)) {\n        const consumer = new KeqMiddlewareConsumerImpl()\n        instance.configureKeqMiddleware(consumer)\n        consumer.applyTo(this.keqRequest, this.moduleRef)\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keq-request/nestjs",
-  "version": "5.0.0-beta.11",
+  "version": "5.0.0-beta.12",
   "description": "Request API write by Typescript for flexibility, readability, and a low learning curve.",
   "keywords": [
     "request",
@@ -41,12 +41,12 @@
     "@nestjs/core": "^11.1.19",
     "@types/node": "^20.19.39",
     "@types/picomatch": "^4.0.0",
-    "keq": "5.0.0-beta.11"
+    "keq": "5.0.0-beta.12"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",
     "@nestjs/core": "^11.0.0",
-    "keq": "^5.0.0-beta.11"
+    "keq": "^5.0.0-beta.12"
   },
   "engines": {
     "node": ">=20.0.0"

package/src/interfaces/keq-middleware-consumer.interface.ts

@@ -15,6 +15,7 @@ export interface KeqModuleClass {
 }
 
 export interface KeqMiddlewareConfigProxy {
+  exclude(...routes: KeqRouteInfo[]): KeqMiddlewareConfigProxy
   forRoutes(...routes: Array<typeof KEQ_ROUTES.ALL | KeqRouteInfo | KeqModuleClass>): KeqMiddlewareConsumer
 }
 

package/src/keq-middleware-consumer.ts

@@ -1,6 +1,6 @@
 import type { Type } from '@nestjs/common'
 import type { ModuleRef } from '@nestjs/core'
-import type { KeqMiddleware, KeqRoute } from 'keq'
+import type { KeqExecutionContext, KeqMiddleware, KeqRoute } from 'keq'
 import { composeRoute, KeqRequest } from 'keq'
 import picomatch from 'picomatch'
 import { KEQ_ROUTES } from './constants.js'
@@ -11,6 +11,7 @@ import type { KeqNestMiddleware } from './interfaces/keq-nest-middleware.interfa
 interface MiddlewareEntry {
   middlewares: Array<Type<KeqNestMiddleware> | KeqMiddleware>
   routes: Array<typeof KEQ_ROUTES.ALL | KeqRouteInfo | KeqModuleClass>
+  excludedRouteInfos?: KeqRouteInfo[]
 }
 
 export class KeqMiddlewareConsumerImpl implements KeqMiddlewareConsumer {
@@ -18,18 +19,34 @@ export class KeqMiddlewareConsumerImpl implements KeqMiddlewareConsumer {
 
   apply(...middlewares: Array<Type<KeqNestMiddleware> | KeqMiddleware>): KeqMiddlewareConfigProxy {
     const entry: MiddlewareEntry = { middlewares, routes: [] }
+    const excludedRouteInfos: KeqRouteInfo[] = []
     this.entries.push(entry)
-    return {
+
+    const proxy: KeqMiddlewareConfigProxy = {
+      exclude: (...routes) => {
+        excludedRouteInfos.push(...routes)
+        return proxy
+      },
       forRoutes: (...routes) => {
         entry.routes = routes
+        if (excludedRouteInfos.length > 0) {
+          entry.excludedRouteInfos = excludedRouteInfos
+        }
         return this
       },
     }
+    return proxy
   }
 
   applyTo(keqRequest: KeqRequest, moduleRef: ModuleRef): void {
     for (const entry of this.entries) {
-      const resolved = entry.middlewares.map((m) => this.resolveMiddleware(m, moduleRef))
+      let resolved = entry.middlewares.map((m) => this.resolveMiddleware(m, moduleRef))
+
+      if (entry.excludedRouteInfos && entry.excludedRouteInfos.length > 0) {
+        const excludedRoutes = entry.excludedRouteInfos.map((info) => this.buildRoute(info))
+        resolved = resolved.map((mw) => this.wrapWithExclusion(mw, excludedRoutes))
+      }
+
       const isGlobal = entry.routes.length === 0
         || entry.routes.some((r) => r === KEQ_ROUTES.ALL)
 
@@ -92,4 +109,21 @@ export class KeqMiddlewareConsumerImpl implements KeqMiddlewareConsumer {
     if (routes.length === 1) return routes[0]
     return composeRoute(routes)
   }
+
+  private wrapWithExclusion(middleware: KeqMiddleware, excludedRoutes: KeqRoute[]): KeqMiddleware {
+    const excluded: KeqMiddleware = async (ctx, next) => {
+      if (await this.checkExcluded(ctx, excludedRoutes)) {
+        return next()
+      }
+      return middleware(ctx, next)
+    }
+    return excluded
+  }
+
+  private async checkExcluded(ctx: KeqExecutionContext, excludedRoutes: KeqRoute[]): Promise<boolean> {
+    for (const route of excludedRoutes) {
+      if (await route(ctx)) return true
+    }
+    return false
+  }
 }