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

package/dist/index.js

@@ -22,23 +22,37 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 let _nestjs_common = require("@nestjs/common");
-let _nestjs_core = require("@nestjs/core");
 let keq = require("keq");
 let picomatch = require("picomatch");
 picomatch = __toESM(picomatch);
 //#region src/constants.ts
 const KEQ_ROUTES = { ALL: Symbol("KEQ_ROUTES.ALL") };
 //#endregion
-//#region src/keq-middleware-consumer.ts
-var KeqMiddlewareConsumerImpl = class {
+//#region src/keq-middleware-collector.ts
+/**
+* 中间件收集器，收集中间件配置条目并应用到指定的 {@link KeqRequest} 实例。
+*
+* 通过 `apply()` → `forRoutes()` 链式 API 收集多组中间件条目，
+* 在 `forRoutes()` 被调用时立即将中间件绑定到目标请求。
+*
+* 注意：该类并非 `@Injectable()`，由 Consumer 内部手动创建。
+*
+* @typeParam TConsumer - Consumer 类型（`KeqMiddlewareConsumer` 或 `KeqConsumer<T>`）
+*/
+var KeqMiddlewareCollector = class {
 	entries = [];
-	apply(...middlewares) {
+	constructor(keqRequest, consumer) {
+		this.keqRequest = keqRequest;
+		this.consumer = consumer;
+	}
+	apply(middlewares) {
 		const entry = {
 			middlewares,
 			routes: []
 		};
 		const excludedRouteInfos = [];
 		this.entries.push(entry);
+		const { keqRequest, consumer } = this;
 		const proxy = {
 			exclude: (...routes) => {
 				excludedRouteInfos.push(...routes);
@@ -47,14 +61,18 @@ var KeqMiddlewareConsumerImpl = class {
 			forRoutes: (...routes) => {
 				entry.routes = routes;
 				if (excludedRouteInfos.length > 0) entry.excludedRouteInfos = excludedRouteInfos;
-				return this;
+				this.applyTo(keqRequest);
+				return consumer;
 			}
 		};
 		return proxy;
 	}
-	applyTo(keqRequest, moduleRef) {
+	/**
+	* 将收集的所有中间件条目解析并应用到指定的 {@link KeqRequest} 实例。
+	*/
+	applyTo(keqRequest) {
 		for (const entry of this.entries) {
-			let resolved = entry.middlewares.map((m) => this.resolveMiddleware(m, moduleRef));
+			let resolved = entry.middlewares.map((m) => this.normalizeMiddleware(m));
 			if (entry.excludedRouteInfos && entry.excludedRouteInfos.length > 0) {
 				const excludedRoutes = entry.excludedRouteInfos.map((info) => this.buildRoute(info));
 				resolved = resolved.map((mw) => this.wrapWithExclusion(mw, excludedRoutes));
@@ -62,31 +80,25 @@ var KeqMiddlewareConsumerImpl = class {
 			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;
-				if (this.isKeqModuleClass(routeTarget)) {
-					const targetRequest = moduleRef.get(routeTarget.KEQ_REQUEST, { strict: false });
-					if (targetRequest) for (const mw of resolved) targetRequest.use(mw);
-				} else {
-					const route = this.buildRoute(routeTarget);
-					keqRequest.useRouter().route(route, resolved);
-				}
+				const route = this.buildRoute(routeTarget);
+				keqRequest.useRouter().route(route, resolved);
 			}
 		}
 	}
-	isKeqModuleClass(route) {
-		return typeof route === "function" && "KEQ_REQUEST" in route && typeof route.KEQ_REQUEST === "symbol";
-	}
-	isNestMiddlewareClass(m) {
-		return typeof m === "function" && m.prototype !== void 0 && "use" in m.prototype;
-	}
-	resolveMiddleware(m, moduleRef) {
-		if (this.isNestMiddlewareClass(m)) {
-			const instance = moduleRef.get(m, { strict: false });
-			return async (ctx, next) => {
-				await instance.use(ctx, next);
-			};
-		}
+	/**
+	* 标准化中间件：将不同形式的中间件统一为 {@link KeqMiddleware} 函数。
+	* - 若已是 {@link KeqMiddleware} 函数 → 直接返回
+	* - 若为 {@link KeqNestMiddleware} 实例对象 → 包装 `use` 方法为中间件函数
+	*/
+	normalizeMiddleware(m) {
+		if (this.isNestMiddlewareInstance(m)) return async (ctx, next) => {
+			await m.use(ctx, next);
+		};
 		return m;
 	}
+	isNestMiddlewareInstance(m) {
+		return typeof m === "object" && m !== null && "use" in m;
+	}
 	buildRoute(info) {
 		const routes = [];
 		if (info.host) {
@@ -117,11 +129,6 @@ var KeqMiddlewareConsumerImpl = class {
 	}
 };
 //#endregion
-//#region src/utils/has-configure-keq-middleware.ts
-function hasConfigureKeqMiddleware(instance) {
-	return instance !== null && instance !== void 0 && typeof instance.configureKeqMiddleware === "function";
-}
-//#endregion
 //#region \0@oxc-project+runtime@0.127.0/helpers/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
@@ -135,42 +142,86 @@ function __decorate(decorators, target, key, desc) {
 	return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 //#endregion
+//#region src/keq-middleware-consumer.ts
+var _ref;
+let KeqMiddlewareConsumer = class KeqMiddlewareConsumer {
+	constructor(keqRequest) {
+		this.keqRequest = keqRequest;
+	}
+	apply(...middlewares) {
+		return new KeqMiddlewareCollector(this.keqRequest, this).apply(middlewares);
+	}
+};
+KeqMiddlewareConsumer = __decorate([(0, _nestjs_common.Injectable)(), __decorateMetadata("design:paramtypes", [typeof (_ref = typeof keq.KeqRequest !== "undefined" && keq.KeqRequest) === "function" ? _ref : Object])], KeqMiddlewareConsumer);
+//#endregion
 //#region src/keq.module.ts
-var _ref, _ref2, _ref3;
-let KeqModule = class KeqModule {
-	constructor(modulesContainer, moduleRef, keqRequest) {
-		this.modulesContainer = modulesContainer;
-		this.moduleRef = moduleRef;
+let KeqModule = class KeqModule {};
+KeqModule = __decorate([(0, _nestjs_common.Global)(), (0, _nestjs_common.Module)({
+	providers: [{
+		provide: keq.KeqRequest,
+		useFactory: () => new keq.KeqRequest()
+	}, KeqMiddlewareConsumer],
+	exports: [keq.KeqRequest, KeqMiddlewareConsumer]
+})], KeqModule);
+//#endregion
+//#region src/keq-consumer.ts
+/**
+* 为指定 Keq 模块按路由注册中间件。
+*
+* Keq 模块由 `@keq-request/cli` 生成，通过
+* {@link InjectKeqConsumer} 装饰器注入本实例。
+*
+* @typeParam T - 目标模块类
+*
+* @example
+* ```ts
+* constructor(
+*   \@InjectKeqConsumer(GeneratedModule) consumer: KeqConsumer<GeneratedModule>,
+* ) {
+*   consumer.apply(authMw).forRoutes('*')
+* }
+* ```
+*/
+var KeqConsumer = class {
+	constructor(keqRequest) {
 		this.keqRequest = keqRequest;
 	}
-	onModuleInit() {
-		for (const [, moduleWrapper] of this.modulesContainer) {
-			const instance = moduleWrapper.instance;
-			if (hasConfigureKeqMiddleware(instance)) {
-				const consumer = new KeqMiddlewareConsumerImpl();
-				instance.configureKeqMiddleware(consumer);
-				consumer.applyTo(this.keqRequest, this.moduleRef);
-			}
-		}
+	apply(...middlewares) {
+		return new KeqMiddlewareCollector(this.keqRequest, this).apply(middlewares);
 	}
 };
-KeqModule = __decorate([
-	(0, _nestjs_common.Global)(),
-	(0, _nestjs_common.Module)({
-		providers: [{
-			provide: keq.KeqRequest,
-			useFactory: () => new keq.KeqRequest()
-		}],
-		exports: [keq.KeqRequest]
-	}),
-	__decorateMetadata("design:paramtypes", [
-		typeof (_ref = typeof _nestjs_core.ModulesContainer !== "undefined" && _nestjs_core.ModulesContainer) === "function" ? _ref : Object,
-		typeof (_ref2 = typeof _nestjs_core.ModuleRef !== "undefined" && _nestjs_core.ModuleRef) === "function" ? _ref2 : Object,
-		typeof (_ref3 = typeof keq.KeqRequest !== "undefined" && keq.KeqRequest) === "function" ? _ref3 : Object
-	])
-], KeqModule);
 //#endregion
+//#region src/decorators/inject-keq-consumer.decorator.ts
+/**
+* 注入绑定到指定 Keq Module 的 `KeqConsumer<T>`。
+*
+* 被注入的 Module Class 必须同时包含 `KEQ_REQUEST` 和 `KEQ_CONSUMER` 静态属性，
+* 两者均由 keq CLI 生成。
+*
+* 使用方式：
+* ```ts
+* constructor(
+*   \@InjectKeqConsumer(GeneratedModule) consumer: KeqConsumer<GeneratedModule>,
+* ) {
+*   consumer.apply(mw).forRoutes('*')
+* }
+* ```
+*
+* @param moduleClass - 目标 KeqModule 类（需具有 `KEQ_REQUEST` 和 `KEQ_CONSUMER` symbol）
+*/
+function InjectKeqConsumer(moduleClass) {
+	return (0, _nestjs_common.Inject)(moduleClass.KEQ_CONSUMER);
+}
+//#endregion
+exports.InjectKeqConsumer = InjectKeqConsumer;
 exports.KEQ_ROUTES = KEQ_ROUTES;
+exports.KeqConsumer = KeqConsumer;
+Object.defineProperty(exports, "KeqMiddlewareConsumer", {
+	enumerable: true,
+	get: function() {
+		return KeqMiddlewareConsumer;
+	}
+});
 Object.defineProperty(exports, "KeqModule", {
 	enumerable: true,
 	get: function() {

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 { 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,MAAa,aAAa,EACxB,KAAK,OAAO,iBAAiB,EAC9B;;;ACcD,IAAa,4BAAb,MAAwE;CACtE,UAAqC,EAAE;CAEvC,MAAM,GAAG,aAAuF;EAC9F,MAAM,QAAyB;GAAE;GAAa,QAAQ,EAAE;GAAE;EAC1D,MAAM,qBAAqC,EAAE;AAC7C,OAAK,QAAQ,KAAK,MAAM;EAExB,MAAM,QAAkC;GACtC,UAAU,GAAG,WAAW;AACtB,uBAAmB,KAAK,GAAG,OAAO;AAClC,WAAO;;GAET,YAAY,GAAG,WAAW;AACxB,UAAM,SAAS;AACf,QAAI,mBAAmB,SAAS,EAC9B,OAAM,qBAAqB;AAE7B,WAAO;;GAEV;AACD,SAAO;;CAGT,QAAQ,YAAwB,WAA4B;AAC1D,OAAK,MAAM,SAAS,KAAK,SAAS;GAChC,IAAI,WAAW,MAAM,YAAY,KAAK,MAAM,KAAK,kBAAkB,GAAG,UAAU,CAAC;AAEjF,OAAI,MAAM,sBAAsB,MAAM,mBAAmB,SAAS,GAAG;IACnE,MAAM,iBAAiB,MAAM,mBAAmB,KAAK,SAAS,KAAK,WAAW,KAAK,CAAC;AACpF,eAAW,SAAS,KAAK,OAAO,KAAK,kBAAkB,IAAI,eAAe,CAAC;;AAM7E,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,WAAA,GAAA,UAAA,SAA+C,KAAK,SAAS;AACnE,UAAO,MAAM,QAAQ,QAAQ,IAAI,QAAQ,IAAI,SAAS,CAAC;;AAEzD,MAAI,OAAO,WAAW,EAAG,QAAO,OAAO;AACvC,UAAA,GAAA,IAAA,cAAoB,OAAO;;CAG7B,kBAA0B,YAA2B,gBAA2C;EAC9F,MAAM,WAA0B,OAAO,KAAK,SAAS;AACnD,OAAI,MAAM,KAAK,cAAc,KAAK,eAAe,CAC/C,QAAO,MAAM;AAEf,UAAO,WAAW,KAAK,KAAK;;AAE9B,SAAO;;CAGT,MAAc,cAAc,KAA0B,gBAA8C;AAClG,OAAK,MAAM,SAAS,eAClB,KAAI,MAAM,MAAM,IAAI,CAAE,QAAO;AAE/B,SAAO;;;;;AC3HX,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;;;;;;6BAlBhD;4BACD;EACN,WAAW,CAAC;GAAE,SAASA,IAAAA;GAAY,kBAAkB,IAAIA,IAAAA,YAAY;GAAE,CAAC;EACxE,SAAS,CAACA,IAAAA,WAAW;EACtB,CAAC"}
+{"version":3,"file":"index.js","names":["KeqRequest"],"sources":["../src/constants.ts","../src/keq-middleware-collector.ts","../src/keq-middleware-consumer.ts","../src/keq.module.ts","../src/keq-consumer.ts","../src/decorators/inject-keq-consumer.decorator.ts"],"sourcesContent":["export const KEQ_ROUTES = {\n  ALL: Symbol('KEQ_ROUTES.ALL'),\n} as const\n","import type { KeqExecutionContext, KeqMiddleware, KeqRoute } from 'keq'\nimport { composeRoute, KeqRequest } from 'keq'\nimport picomatch from 'picomatch'\nimport { KEQ_ROUTES } from './constants.js'\nimport type { KeqMiddlewareConfigProxy, KeqRouteTarget, KeqRouteInfo } from './interfaces/keq-middleware-consumer.interface.js'\nimport type { KeqNestMiddleware } from './interfaces/keq-nest-middleware.interface.js'\n\n\n/** 单条中间件注册条目 */\ninterface MiddlewareEntry {\n  middlewares: Array<KeqNestMiddleware | KeqMiddleware>\n  routes: KeqRouteTarget[]\n  excludedRouteInfos?: KeqRouteInfo[]\n}\n\n/**\n * 中间件收集器，收集中间件配置条目并应用到指定的 {@link KeqRequest} 实例。\n *\n * 通过 `apply()` → `forRoutes()` 链式 API 收集多组中间件条目，\n * 在 `forRoutes()` 被调用时立即将中间件绑定到目标请求。\n *\n * 注意：该类并非 `@Injectable()`，由 Consumer 内部手动创建。\n *\n * @typeParam TConsumer - Consumer 类型（`KeqMiddlewareConsumer` 或 `KeqConsumer<T>`）\n */\nexport class KeqMiddlewareCollector<TConsumer extends object = object> {\n  private entries: MiddlewareEntry[] = []\n\n  constructor(\n    private readonly keqRequest: KeqRequest,\n    private readonly consumer: TConsumer,\n  ) {}\n\n  apply(\n    middlewares: Array<KeqNestMiddleware | KeqMiddleware>,\n  ): KeqMiddlewareConfigProxy {\n    const entry: MiddlewareEntry = { middlewares, routes: [] }\n    const excludedRouteInfos: KeqRouteInfo[] = []\n    this.entries.push(entry)\n\n    const { keqRequest, consumer } = this\n\n    const proxy = {\n      exclude: (...routes: KeqRouteInfo[]) => {\n        excludedRouteInfos.push(...routes)\n        return proxy\n      },\n      forRoutes: (...routes: KeqRouteTarget[]) => {\n        entry.routes = routes\n        if (excludedRouteInfos.length > 0) {\n          entry.excludedRouteInfos = excludedRouteInfos\n        }\n        this.applyTo(keqRequest)\n        return consumer\n      },\n    }\n    return proxy as unknown as KeqMiddlewareConfigProxy\n  }\n\n  /**\n   * 将收集的所有中间件条目解析并应用到指定的 {@link KeqRequest} 实例。\n   */\n  applyTo(keqRequest: KeqRequest): void {\n    for (const entry of this.entries) {\n      let resolved = entry.middlewares.map((m) => this.normalizeMiddleware(m))\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\n        = entry.routes.length === 0 || 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          const route = this.buildRoute(routeTarget as KeqRouteInfo)\n          keqRequest.useRouter().route(route, resolved)\n        }\n      }\n    }\n  }\n\n  // ─── 中间件标准化 ────────────────────────────────────\n\n  /**\n   * 标准化中间件：将不同形式的中间件统一为 {@link KeqMiddleware} 函数。\n   * - 若已是 {@link KeqMiddleware} 函数 → 直接返回\n   * - 若为 {@link KeqNestMiddleware} 实例对象 → 包装 `use` 方法为中间件函数\n   */\n  private normalizeMiddleware(\n    m: KeqNestMiddleware | KeqMiddleware,\n  ): KeqMiddleware {\n    if (this.isNestMiddlewareInstance(m)) {\n      return async (ctx, next) => {\n        await m.use(ctx, next)\n      }\n    }\n    return m\n  }\n\n  private isNestMiddlewareInstance(\n    m: KeqNestMiddleware | KeqMiddleware,\n  ): m is KeqNestMiddleware {\n    return typeof m === 'object' && m !== null && 'use' in m\n  }\n\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(\n    ctx: KeqExecutionContext,\n    excludedRoutes: KeqRoute[],\n  ): Promise<boolean> {\n    for (const route of excludedRoutes) {\n      if (await route(ctx)) return true\n    }\n    return false\n  }\n}\n","import { Injectable } from '@nestjs/common'\nimport type { KeqMiddleware } from 'keq'\nimport { KeqRequest } from 'keq'\nimport type { KeqMiddlewareConfigProxy } from './interfaces/keq-middleware-consumer.interface.js'\nimport type { KeqNestMiddleware } from './interfaces/keq-nest-middleware.interface.js'\nimport { KeqMiddlewareCollector } from './keq-middleware-collector.js'\n\n\n/**\n * 全局中间件消费者，提供 `.apply().forRoutes()` API。\n *\n * `forRoutes()` 返回 `KeqMiddlewareConsumer` 自身，支持链式注册：\n *\n * ```ts\n * consumer\n *   .apply(mw1).forRoutes(KEQ_ROUTES.ALL)\n *   .apply(mw2).forRoutes({ pathname: '/api/*' })\n * ```\n *\n * 模块级别的中间件请使用 `@InjectKeqConsumer(GeneratedModule)` 注入\n * `KeqConsumer<GeneratedModule>`，其 `forRoutes()` 直接作用于目标模块。\n */\n@Injectable()\nexport class KeqMiddlewareConsumer {\n  constructor(private readonly keqRequest: KeqRequest) {}\n\n  apply(\n    ...middlewares: Array<KeqNestMiddleware | KeqMiddleware>\n  ): KeqMiddlewareConfigProxy {\n    const collector = new KeqMiddlewareCollector(this.keqRequest, this)\n    return collector.apply(middlewares)\n  }\n}\n","import { Global, Module } from '@nestjs/common'\nimport { KeqRequest } from 'keq'\nimport { KeqMiddlewareConsumer } from './keq-middleware-consumer.js'\n\n\n@Global()\n@Module({\n  providers: [\n    { provide: KeqRequest, useFactory: () => new KeqRequest() },\n    KeqMiddlewareConsumer,\n  ],\n  exports: [KeqRequest, KeqMiddlewareConsumer],\n})\nexport class KeqModule {}\n","import type { KeqMiddleware } from 'keq'\nimport { KeqRequest } from 'keq'\nimport type { KeqModuleClass, KeqScopedConfigProxy } from './interfaces/keq-middleware-consumer.interface.js'\nimport type { KeqNestMiddleware } from './interfaces/keq-nest-middleware.interface.js'\nimport { KeqMiddlewareCollector } from './keq-middleware-collector.js'\n\n\n/**\n * 为指定 Keq 模块按路由注册中间件。\n *\n * Keq 模块由 `@keq-request/cli` 生成，通过\n * {@link InjectKeqConsumer} 装饰器注入本实例。\n *\n * @typeParam T - 目标模块类\n *\n * @example\n * ```ts\n * constructor(\n *   \\@InjectKeqConsumer(GeneratedModule) consumer: KeqConsumer<GeneratedModule>,\n * ) {\n *   consumer.apply(authMw).forRoutes('*')\n * }\n * ```\n */\nexport class KeqConsumer<T = KeqModuleClass> {\n  constructor(private readonly keqRequest: KeqRequest) {}\n\n  apply(\n    ...middlewares: Array<KeqNestMiddleware | KeqMiddleware>\n  ): KeqScopedConfigProxy<T> {\n    const collector = new KeqMiddlewareCollector(this.keqRequest, this)\n    return collector.apply(middlewares) as unknown as KeqScopedConfigProxy<T>\n  }\n}\n","import { Inject } from '@nestjs/common'\nimport type { KeqModuleClass } from '../interfaces/keq-middleware-consumer.interface.js'\n\n\n/**\n * 注入绑定到指定 Keq Module 的 `KeqConsumer<T>`。\n *\n * 被注入的 Module Class 必须同时包含 `KEQ_REQUEST` 和 `KEQ_CONSUMER` 静态属性，\n * 两者均由 keq CLI 生成。\n *\n * 使用方式：\n * ```ts\n * constructor(\n *   \\@InjectKeqConsumer(GeneratedModule) consumer: KeqConsumer<GeneratedModule>,\n * ) {\n *   consumer.apply(mw).forRoutes('*')\n * }\n * ```\n *\n * @param moduleClass - 目标 KeqModule 类（需具有 `KEQ_REQUEST` 和 `KEQ_CONSUMER` symbol）\n */\nexport function InjectKeqConsumer<T extends KeqModuleClass>(\n  moduleClass: T,\n): ParameterDecorator {\n  return Inject(moduleClass.KEQ_CONSUMER)\n}\n"],"mappings":"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"}

package/dist/index.mjs

@@ -1,20 +1,34 @@
-import { Global, Module } from "@nestjs/common";
-import { ModuleRef, ModulesContainer } from "@nestjs/core";
+import { Global, Inject, Injectable, Module } from "@nestjs/common";
 import { KeqRequest, composeRoute } from "keq";
 import picomatch from "picomatch";
 //#region src/constants.ts
 const KEQ_ROUTES = { ALL: Symbol("KEQ_ROUTES.ALL") };
 //#endregion
-//#region src/keq-middleware-consumer.ts
-var KeqMiddlewareConsumerImpl = class {
+//#region src/keq-middleware-collector.ts
+/**
+* 中间件收集器，收集中间件配置条目并应用到指定的 {@link KeqRequest} 实例。
+*
+* 通过 `apply()` → `forRoutes()` 链式 API 收集多组中间件条目，
+* 在 `forRoutes()` 被调用时立即将中间件绑定到目标请求。
+*
+* 注意：该类并非 `@Injectable()`，由 Consumer 内部手动创建。
+*
+* @typeParam TConsumer - Consumer 类型（`KeqMiddlewareConsumer` 或 `KeqConsumer<T>`）
+*/
+var KeqMiddlewareCollector = class {
 	entries = [];
-	apply(...middlewares) {
+	constructor(keqRequest, consumer) {
+		this.keqRequest = keqRequest;
+		this.consumer = consumer;
+	}
+	apply(middlewares) {
 		const entry = {
 			middlewares,
 			routes: []
 		};
 		const excludedRouteInfos = [];
 		this.entries.push(entry);
+		const { keqRequest, consumer } = this;
 		const proxy = {
 			exclude: (...routes) => {
 				excludedRouteInfos.push(...routes);
@@ -23,14 +37,18 @@ var KeqMiddlewareConsumerImpl = class {
 			forRoutes: (...routes) => {
 				entry.routes = routes;
 				if (excludedRouteInfos.length > 0) entry.excludedRouteInfos = excludedRouteInfos;
-				return this;
+				this.applyTo(keqRequest);
+				return consumer;
 			}
 		};
 		return proxy;
 	}
-	applyTo(keqRequest, moduleRef) {
+	/**
+	* 将收集的所有中间件条目解析并应用到指定的 {@link KeqRequest} 实例。
+	*/
+	applyTo(keqRequest) {
 		for (const entry of this.entries) {
-			let resolved = entry.middlewares.map((m) => this.resolveMiddleware(m, moduleRef));
+			let resolved = entry.middlewares.map((m) => this.normalizeMiddleware(m));
 			if (entry.excludedRouteInfos && entry.excludedRouteInfos.length > 0) {
 				const excludedRoutes = entry.excludedRouteInfos.map((info) => this.buildRoute(info));
 				resolved = resolved.map((mw) => this.wrapWithExclusion(mw, excludedRoutes));
@@ -38,31 +56,25 @@ var KeqMiddlewareConsumerImpl = class {
 			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;
-				if (this.isKeqModuleClass(routeTarget)) {
-					const targetRequest = moduleRef.get(routeTarget.KEQ_REQUEST, { strict: false });
-					if (targetRequest) for (const mw of resolved) targetRequest.use(mw);
-				} else {
-					const route = this.buildRoute(routeTarget);
-					keqRequest.useRouter().route(route, resolved);
-				}
+				const route = this.buildRoute(routeTarget);
+				keqRequest.useRouter().route(route, resolved);
 			}
 		}
 	}
-	isKeqModuleClass(route) {
-		return typeof route === "function" && "KEQ_REQUEST" in route && typeof route.KEQ_REQUEST === "symbol";
-	}
-	isNestMiddlewareClass(m) {
-		return typeof m === "function" && m.prototype !== void 0 && "use" in m.prototype;
-	}
-	resolveMiddleware(m, moduleRef) {
-		if (this.isNestMiddlewareClass(m)) {
-			const instance = moduleRef.get(m, { strict: false });
-			return async (ctx, next) => {
-				await instance.use(ctx, next);
-			};
-		}
+	/**
+	* 标准化中间件：将不同形式的中间件统一为 {@link KeqMiddleware} 函数。
+	* - 若已是 {@link KeqMiddleware} 函数 → 直接返回
+	* - 若为 {@link KeqNestMiddleware} 实例对象 → 包装 `use` 方法为中间件函数
+	*/
+	normalizeMiddleware(m) {
+		if (this.isNestMiddlewareInstance(m)) return async (ctx, next) => {
+			await m.use(ctx, next);
+		};
 		return m;
 	}
+	isNestMiddlewareInstance(m) {
+		return typeof m === "object" && m !== null && "use" in m;
+	}
 	buildRoute(info) {
 		const routes = [];
 		if (info.host) {
@@ -93,11 +105,6 @@ var KeqMiddlewareConsumerImpl = class {
 	}
 };
 //#endregion
-//#region src/utils/has-configure-keq-middleware.ts
-function hasConfigureKeqMiddleware(instance) {
-	return instance !== null && instance !== void 0 && typeof instance.configureKeqMiddleware === "function";
-}
-//#endregion
 //#region \0@oxc-project+runtime@0.127.0/helpers/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
@@ -111,41 +118,77 @@ function __decorate(decorators, target, key, desc) {
 	return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 //#endregion
+//#region src/keq-middleware-consumer.ts
+var _ref;
+let KeqMiddlewareConsumer = class KeqMiddlewareConsumer {
+	constructor(keqRequest) {
+		this.keqRequest = keqRequest;
+	}
+	apply(...middlewares) {
+		return new KeqMiddlewareCollector(this.keqRequest, this).apply(middlewares);
+	}
+};
+KeqMiddlewareConsumer = __decorate([Injectable(), __decorateMetadata("design:paramtypes", [typeof (_ref = typeof KeqRequest !== "undefined" && KeqRequest) === "function" ? _ref : Object])], KeqMiddlewareConsumer);
+//#endregion
 //#region src/keq.module.ts
-var _ref, _ref2, _ref3;
-let KeqModule = class KeqModule {
-	constructor(modulesContainer, moduleRef, keqRequest) {
-		this.modulesContainer = modulesContainer;
-		this.moduleRef = moduleRef;
+let KeqModule = class KeqModule {};
+KeqModule = __decorate([Global(), Module({
+	providers: [{
+		provide: KeqRequest,
+		useFactory: () => new KeqRequest()
+	}, KeqMiddlewareConsumer],
+	exports: [KeqRequest, KeqMiddlewareConsumer]
+})], KeqModule);
+//#endregion
+//#region src/keq-consumer.ts
+/**
+* 为指定 Keq 模块按路由注册中间件。
+*
+* Keq 模块由 `@keq-request/cli` 生成，通过
+* {@link InjectKeqConsumer} 装饰器注入本实例。
+*
+* @typeParam T - 目标模块类
+*
+* @example
+* ```ts
+* constructor(
+*   \@InjectKeqConsumer(GeneratedModule) consumer: KeqConsumer<GeneratedModule>,
+* ) {
+*   consumer.apply(authMw).forRoutes('*')
+* }
+* ```
+*/
+var KeqConsumer = class {
+	constructor(keqRequest) {
 		this.keqRequest = keqRequest;
 	}
-	onModuleInit() {
-		for (const [, moduleWrapper] of this.modulesContainer) {
-			const instance = moduleWrapper.instance;
-			if (hasConfigureKeqMiddleware(instance)) {
-				const consumer = new KeqMiddlewareConsumerImpl();
-				instance.configureKeqMiddleware(consumer);
-				consumer.applyTo(this.keqRequest, this.moduleRef);
-			}
-		}
+	apply(...middlewares) {
+		return new KeqMiddlewareCollector(this.keqRequest, this).apply(middlewares);
 	}
 };
-KeqModule = __decorate([
-	Global(),
-	Module({
-		providers: [{
-			provide: KeqRequest,
-			useFactory: () => new KeqRequest()
-		}],
-		exports: [KeqRequest]
-	}),
-	__decorateMetadata("design:paramtypes", [
-		typeof (_ref = typeof ModulesContainer !== "undefined" && ModulesContainer) === "function" ? _ref : Object,
-		typeof (_ref2 = typeof ModuleRef !== "undefined" && ModuleRef) === "function" ? _ref2 : Object,
-		typeof (_ref3 = typeof KeqRequest !== "undefined" && KeqRequest) === "function" ? _ref3 : Object
-	])
-], KeqModule);
 //#endregion
-export { KEQ_ROUTES, KeqModule };
+//#region src/decorators/inject-keq-consumer.decorator.ts
+/**
+* 注入绑定到指定 Keq Module 的 `KeqConsumer<T>`。
+*
+* 被注入的 Module Class 必须同时包含 `KEQ_REQUEST` 和 `KEQ_CONSUMER` 静态属性，
+* 两者均由 keq CLI 生成。
+*
+* 使用方式：
+* ```ts
+* constructor(
+*   \@InjectKeqConsumer(GeneratedModule) consumer: KeqConsumer<GeneratedModule>,
+* ) {
+*   consumer.apply(mw).forRoutes('*')
+* }
+* ```
+*
+* @param moduleClass - 目标 KeqModule 类（需具有 `KEQ_REQUEST` 和 `KEQ_CONSUMER` symbol）
+*/
+function InjectKeqConsumer(moduleClass) {
+	return Inject(moduleClass.KEQ_CONSUMER);
+}
+//#endregion
+export { InjectKeqConsumer, KEQ_ROUTES, KeqConsumer, KeqMiddlewareConsumer, KeqModule };
 
 //# sourceMappingURL=index.mjs.map

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 { 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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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/constants.ts","../src/keq-middleware-collector.ts","../src/keq-middleware-consumer.ts","../src/keq.module.ts","../src/keq-consumer.ts","../src/decorators/inject-keq-consumer.decorator.ts"],"sourcesContent":["export const KEQ_ROUTES = {\n  ALL: Symbol('KEQ_ROUTES.ALL'),\n} as const\n","import type { KeqExecutionContext, KeqMiddleware, KeqRoute } from 'keq'\nimport { composeRoute, KeqRequest } from 'keq'\nimport picomatch from 'picomatch'\nimport { KEQ_ROUTES } from './constants.js'\nimport type { KeqMiddlewareConfigProxy, KeqRouteTarget, KeqRouteInfo } from './interfaces/keq-middleware-consumer.interface.js'\nimport type { KeqNestMiddleware } from './interfaces/keq-nest-middleware.interface.js'\n\n\n/** 单条中间件注册条目 */\ninterface MiddlewareEntry {\n  middlewares: Array<KeqNestMiddleware | KeqMiddleware>\n  routes: KeqRouteTarget[]\n  excludedRouteInfos?: KeqRouteInfo[]\n}\n\n/**\n * 中间件收集器，收集中间件配置条目并应用到指定的 {@link KeqRequest} 实例。\n *\n * 通过 `apply()` → `forRoutes()` 链式 API 收集多组中间件条目，\n * 在 `forRoutes()` 被调用时立即将中间件绑定到目标请求。\n *\n * 注意：该类并非 `@Injectable()`，由 Consumer 内部手动创建。\n *\n * @typeParam TConsumer - Consumer 类型（`KeqMiddlewareConsumer` 或 `KeqConsumer<T>`）\n */\nexport class KeqMiddlewareCollector<TConsumer extends object = object> {\n  private entries: MiddlewareEntry[] = []\n\n  constructor(\n    private readonly keqRequest: KeqRequest,\n    private readonly consumer: TConsumer,\n  ) {}\n\n  apply(\n    middlewares: Array<KeqNestMiddleware | KeqMiddleware>,\n  ): KeqMiddlewareConfigProxy {\n    const entry: MiddlewareEntry = { middlewares, routes: [] }\n    const excludedRouteInfos: KeqRouteInfo[] = []\n    this.entries.push(entry)\n\n    const { keqRequest, consumer } = this\n\n    const proxy = {\n      exclude: (...routes: KeqRouteInfo[]) => {\n        excludedRouteInfos.push(...routes)\n        return proxy\n      },\n      forRoutes: (...routes: KeqRouteTarget[]) => {\n        entry.routes = routes\n        if (excludedRouteInfos.length > 0) {\n          entry.excludedRouteInfos = excludedRouteInfos\n        }\n        this.applyTo(keqRequest)\n        return consumer\n      },\n    }\n    return proxy as unknown as KeqMiddlewareConfigProxy\n  }\n\n  /**\n   * 将收集的所有中间件条目解析并应用到指定的 {@link KeqRequest} 实例。\n   */\n  applyTo(keqRequest: KeqRequest): void {\n    for (const entry of this.entries) {\n      let resolved = entry.middlewares.map((m) => this.normalizeMiddleware(m))\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\n        = entry.routes.length === 0 || 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          const route = this.buildRoute(routeTarget as KeqRouteInfo)\n          keqRequest.useRouter().route(route, resolved)\n        }\n      }\n    }\n  }\n\n  // ─── 中间件标准化 ────────────────────────────────────\n\n  /**\n   * 标准化中间件：将不同形式的中间件统一为 {@link KeqMiddleware} 函数。\n   * - 若已是 {@link KeqMiddleware} 函数 → 直接返回\n   * - 若为 {@link KeqNestMiddleware} 实例对象 → 包装 `use` 方法为中间件函数\n   */\n  private normalizeMiddleware(\n    m: KeqNestMiddleware | KeqMiddleware,\n  ): KeqMiddleware {\n    if (this.isNestMiddlewareInstance(m)) {\n      return async (ctx, next) => {\n        await m.use(ctx, next)\n      }\n    }\n    return m\n  }\n\n  private isNestMiddlewareInstance(\n    m: KeqNestMiddleware | KeqMiddleware,\n  ): m is KeqNestMiddleware {\n    return typeof m === 'object' && m !== null && 'use' in m\n  }\n\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(\n    ctx: KeqExecutionContext,\n    excludedRoutes: KeqRoute[],\n  ): Promise<boolean> {\n    for (const route of excludedRoutes) {\n      if (await route(ctx)) return true\n    }\n    return false\n  }\n}\n","import { Injectable } from '@nestjs/common'\nimport type { KeqMiddleware } from 'keq'\nimport { KeqRequest } from 'keq'\nimport type { KeqMiddlewareConfigProxy } from './interfaces/keq-middleware-consumer.interface.js'\nimport type { KeqNestMiddleware } from './interfaces/keq-nest-middleware.interface.js'\nimport { KeqMiddlewareCollector } from './keq-middleware-collector.js'\n\n\n/**\n * 全局中间件消费者，提供 `.apply().forRoutes()` API。\n *\n * `forRoutes()` 返回 `KeqMiddlewareConsumer` 自身，支持链式注册：\n *\n * ```ts\n * consumer\n *   .apply(mw1).forRoutes(KEQ_ROUTES.ALL)\n *   .apply(mw2).forRoutes({ pathname: '/api/*' })\n * ```\n *\n * 模块级别的中间件请使用 `@InjectKeqConsumer(GeneratedModule)` 注入\n * `KeqConsumer<GeneratedModule>`，其 `forRoutes()` 直接作用于目标模块。\n */\n@Injectable()\nexport class KeqMiddlewareConsumer {\n  constructor(private readonly keqRequest: KeqRequest) {}\n\n  apply(\n    ...middlewares: Array<KeqNestMiddleware | KeqMiddleware>\n  ): KeqMiddlewareConfigProxy {\n    const collector = new KeqMiddlewareCollector(this.keqRequest, this)\n    return collector.apply(middlewares)\n  }\n}\n","import { Global, Module } from '@nestjs/common'\nimport { KeqRequest } from 'keq'\nimport { KeqMiddlewareConsumer } from './keq-middleware-consumer.js'\n\n\n@Global()\n@Module({\n  providers: [\n    { provide: KeqRequest, useFactory: () => new KeqRequest() },\n    KeqMiddlewareConsumer,\n  ],\n  exports: [KeqRequest, KeqMiddlewareConsumer],\n})\nexport class KeqModule {}\n","import type { KeqMiddleware } from 'keq'\nimport { KeqRequest } from 'keq'\nimport type { KeqModuleClass, KeqScopedConfigProxy } from './interfaces/keq-middleware-consumer.interface.js'\nimport type { KeqNestMiddleware } from './interfaces/keq-nest-middleware.interface.js'\nimport { KeqMiddlewareCollector } from './keq-middleware-collector.js'\n\n\n/**\n * 为指定 Keq 模块按路由注册中间件。\n *\n * Keq 模块由 `@keq-request/cli` 生成，通过\n * {@link InjectKeqConsumer} 装饰器注入本实例。\n *\n * @typeParam T - 目标模块类\n *\n * @example\n * ```ts\n * constructor(\n *   \\@InjectKeqConsumer(GeneratedModule) consumer: KeqConsumer<GeneratedModule>,\n * ) {\n *   consumer.apply(authMw).forRoutes('*')\n * }\n * ```\n */\nexport class KeqConsumer<T = KeqModuleClass> {\n  constructor(private readonly keqRequest: KeqRequest) {}\n\n  apply(\n    ...middlewares: Array<KeqNestMiddleware | KeqMiddleware>\n  ): KeqScopedConfigProxy<T> {\n    const collector = new KeqMiddlewareCollector(this.keqRequest, this)\n    return collector.apply(middlewares) as unknown as KeqScopedConfigProxy<T>\n  }\n}\n","import { Inject } from '@nestjs/common'\nimport type { KeqModuleClass } from '../interfaces/keq-middleware-consumer.interface.js'\n\n\n/**\n * 注入绑定到指定 Keq Module 的 `KeqConsumer<T>`。\n *\n * 被注入的 Module Class 必须同时包含 `KEQ_REQUEST` 和 `KEQ_CONSUMER` 静态属性，\n * 两者均由 keq CLI 生成。\n *\n * 使用方式：\n * ```ts\n * constructor(\n *   \\@InjectKeqConsumer(GeneratedModule) consumer: KeqConsumer<GeneratedModule>,\n * ) {\n *   consumer.apply(mw).forRoutes('*')\n * }\n * ```\n *\n * @param moduleClass - 目标 KeqModule 类（需具有 `KEQ_REQUEST` 和 `KEQ_CONSUMER` symbol）\n */\nexport function InjectKeqConsumer<T extends KeqModuleClass>(\n  moduleClass: T,\n): ParameterDecorator {\n  return Inject(moduleClass.KEQ_CONSUMER)\n}\n"],"mappings":"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"}

package/jest.config.cts

@@ -5,6 +5,16 @@ import { compilerOptions } from './tsconfig.json'
 
 // eslint-disable-next-line @typescript-eslint/require-await
 export default async (): Promise<Config> => ({
-  preset: 'ts-jest',
-  moduleNameMapper: pathsToModuleNameMapper(compilerOptions.paths, { prefix: '<rootDir>/src', useESM: true }),
+  transform: {
+    '^.+\\.tsx?$': ['ts-jest', {
+      tsconfig: {
+        noEmitOnError: false,
+      },
+    }],
+  },
+  testMatch: [
+    '<rootDir>/__tests__/**/*.spec.ts',
+    '<rootDir>/src/**/*.spec.ts',
+  ],
+  moduleNameMapper: pathsToModuleNameMapper(compilerOptions.paths, { prefix: '<rootDir>', useESM: true }),
 })

package/package.json

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

package/src/decorators/inject-keq-consumer.decorator.ts

@@ -0,0 +1,26 @@
+import { Inject } from '@nestjs/common'
+import type { KeqModuleClass } from '../interfaces/keq-middleware-consumer.interface.js'
+
+
+/**
+ * 注入绑定到指定 Keq Module 的 `KeqConsumer<T>`。
+ *
+ * 被注入的 Module Class 必须同时包含 `KEQ_REQUEST` 和 `KEQ_CONSUMER` 静态属性，
+ * 两者均由 keq CLI 生成。
+ *
+ * 使用方式：
+ * ```ts
+ * constructor(
+ *   \@InjectKeqConsumer(GeneratedModule) consumer: KeqConsumer<GeneratedModule>,
+ * ) {
+ *   consumer.apply(mw).forRoutes('*')
+ * }
+ * ```
+ *
+ * @param moduleClass - 目标 KeqModule 类（需具有 `KEQ_REQUEST` 和 `KEQ_CONSUMER` symbol）
+ */
+export function InjectKeqConsumer<T extends KeqModuleClass>(
+  moduleClass: T,
+): ParameterDecorator {
+  return Inject(moduleClass.KEQ_CONSUMER)
+}

package/src/index.ts

@@ -1,3 +1,6 @@
 export * from './keq.module.js'
+export * from './keq-middleware-consumer.js'
+export * from './keq-consumer.js'
 export * from './constants.js'
 export * from './interfaces/index.js'
+export { InjectKeqConsumer } from './decorators/inject-keq-consumer.decorator.js'