@keq-request/nestjs 5.0.0-beta.9 → 5.0.1

package/dist/index.d.ts

@@ -1,62 +1,111 @@
-import * as _$_nestjs_common0 from "@nestjs/common";
-import { DynamicModule } from "@nestjs/common";
-import { KeqMiddleware } from "keq";
+import { KeqExecutionContext, KeqMiddleware, KeqNext, KeqRequest } from "keq";
+import { Type } from "@nestjs/common";
 
-//#region src/types/keq-module-options.d.ts
+//#region src/keq.module.d.ts
+declare class KeqModule {}
+//#endregion
+//#region src/constants.d.ts
+declare const KEQ_ROUTES: {
+  readonly ALL: symbol;
+};
+//#endregion
+//#region src/interfaces/keq-nest-middleware.interface.d.ts
+interface KeqNestMiddleware {
+  use(ctx: KeqExecutionContext, next: KeqNext): void | PromiseLike<void>;
+}
+//#endregion
+//#region src/keq-consumer.d.ts
+/**
+ * 为指定 Keq 模块按路由注册中间件。
+ *
+ * Keq 模块由 `@keq-request/cli` 生成，通过
+ * {@link InjectKeqConsumer} 装饰器注入本实例。
+ *
+ * @typeParam T - 目标模块类
+ *
+ * @example
+ * ```ts
+ * constructor(
+ *   \@InjectKeqConsumer(GeneratedModule) consumer: KeqConsumer<GeneratedModule>,
+ * ) {
+ *   consumer.apply(authMw).forRoutes('*')
+ * }
+ * ```
+ */
+declare class KeqConsumer<T = KeqModuleClass> {
+  private readonly keqRequest;
+  constructor(keqRequest: KeqRequest);
+  apply(...middlewares: Array<KeqNestMiddleware | KeqMiddleware>): KeqScopedConfigProxy<T>;
+}
+//#endregion
+//#region src/interfaces/keq-middleware-consumer.interface.d.ts
+interface KeqRouteInfo {
+  host?: string;
+  method?: string;
+  pathname?: string;
+}
+interface KeqModuleClass extends Type<any> {
+  readonly KEQ_REQUEST: symbol;
+  readonly KEQ_CONSUMER: symbol;
+}
+/** forRoutes() 接受的路由目标（不再包含 KeqModuleClass，模块绑定通过 @InjectKeqConsumer 实现） */
+type KeqRouteTarget = typeof KEQ_ROUTES.ALL | KeqRouteInfo;
+interface KeqMiddlewareConfigProxy {
+  exclude(...routes: KeqRouteInfo[]): KeqMiddlewareConfigProxy;
+  forRoutes(...routes: KeqRouteTarget[]): KeqMiddlewareConsumer;
+}
+/** 模块绑定 Consumer 的配置代理，forRoutes() 返回 KeqConsumer<T> */
+interface KeqScopedConfigProxy<T = KeqModuleClass> {
+  exclude(...routes: KeqRouteInfo[]): KeqScopedConfigProxy<T>;
+  forRoutes(...routes: KeqRouteTarget[]): KeqConsumer<T>;
+}
+//#endregion
+//#region src/keq-middleware-consumer.d.ts
+/**
+ * 全局中间件消费者，提供 `.apply().forRoutes()` API。
+ *
+ * `forRoutes()` 返回 `KeqMiddlewareConsumer` 自身，支持链式注册：
+ *
+ * ```ts
+ * consumer
+ *   .apply(mw1).forRoutes(KEQ_ROUTES.ALL)
+ *   .apply(mw2).forRoutes({ pathname: '/api/*' })
+ * ```
+ *
+ * 模块级别的中间件请使用 `@InjectKeqConsumer(GeneratedModule)` 注入
+ * `KeqConsumer<GeneratedModule>`，其 `forRoutes()` 直接作用于目标模块。
+ */
+declare class KeqMiddlewareConsumer {
+  private readonly keqRequest;
+  constructor(keqRequest: KeqRequest);
+  apply(...middlewares: Array<KeqNestMiddleware | KeqMiddleware>): KeqMiddlewareConfigProxy;
+}
+//#endregion
+//#region src/interfaces/keq-module-options.interface.d.ts
 interface KeqModuleOptions {
   middlewares?: KeqMiddleware[];
+  isolate?: boolean;
 }
 //#endregion
-//#region src/keq.module-definition.d.ts
-declare const ConfigurableModuleClass: _$_nestjs_common0.ConfigurableModuleCls<KeqModuleOptions, "register", "create", {}>, MODULE_OPTIONS_TOKEN: string | symbol, OPTIONS_TYPE: KeqModuleOptions & Partial<{}>, ASYNC_OPTIONS_TYPE: _$_nestjs_common0.ConfigurableModuleAsyncOptions<KeqModuleOptions, "create"> & Partial<{}>;
-//#endregion
-//#region src/keq.module.d.ts
+//#region src/decorators/inject-keq-consumer.decorator.d.ts
 /**
- * KeqModule - Dynamic module for integrating Keq HTTP client with NestJS
+ * 注入绑定到指定 Keq Module 的 `KeqConsumer<T>`。
  *
- * This module is global, so KeqRequest can be injected anywhere in your application
- * without needing to import the module in every feature module.
+ * 被注入的 Module Class 必须同时包含 `KEQ_REQUEST` 和 `KEQ_CONSUMER` 静态属性，
+ * 两者均由 keq CLI 生成。
  *
- * @example
- * ```typescript
- * // Synchronous registration
- * KeqModule.register({
- *   middlewares: [...]
- * })
- *
- * // Asynchronous registration
- * KeqModule.registerAsync({
- *   imports: [ConfigModule],
- *   useFactory: (config: ConfigService) => ({
- *     middlewares: [...]
- *   }),
- *   inject: [ConfigService]
- * })
- *
- * // Inject in service
- * class UserService {
- *   constructor(private readonly keqRequest: KeqRequest) {}
- *   async getUser(id: string) {
- *     return await this.keqRequest.get(`/users/${id}`).resolveWith('json')
- *   }
+ * 使用方式：
+ * ```ts
+ * constructor(
+ *   \@InjectKeqConsumer(GeneratedModule) consumer: KeqConsumer<GeneratedModule>,
+ * ) {
+ *   consumer.apply(mw).forRoutes('*')
  * }
  * ```
+ *
+ * @param moduleClass - 目标 KeqModule 类（需具有 `KEQ_REQUEST` 和 `KEQ_CONSUMER` symbol）
  */
-declare class KeqModule extends ConfigurableModuleClass {
-  /**
-   * Register the module with synchronous options
-   * @param options - Configuration options including middlewares
-   * @returns DynamicModule with KeqRequest provider
-   */
-  static register(options: typeof OPTIONS_TYPE): DynamicModule;
-  /**
-   * Register the module with asynchronous options
-   * Useful when you need to inject dependencies like ConfigService
-   * @param options - Async configuration options
-   * @returns DynamicModule with KeqRequest provider
-   */
-  static registerAsync(options: typeof ASYNC_OPTIONS_TYPE): DynamicModule;
-}
-//#endregion
-export { KeqModule, KeqModuleOptions };
+declare function InjectKeqConsumer<T extends KeqModuleClass>(moduleClass: T): ParameterDecorator;
+//#endregion
+export { InjectKeqConsumer, KEQ_ROUTES, KeqConsumer, type KeqMiddlewareConfigProxy, KeqMiddlewareConsumer, KeqModule, type KeqModuleClass, type KeqModuleOptions, type KeqNestMiddleware, type KeqRouteInfo, type KeqRouteTarget, type KeqScopedConfigProxy };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types/keq-module-options.ts","../src/keq.module-definition.ts","../src/keq.module.ts"],"mappings":";;;;;UAGiB,gBAAA;EACf,WAAA,GAAc,aAAA;AAAA;;;cCEd,uBAAA,EAAuB,iBAAA,CAAA,qBAAA,CAAA,gBAAA,6BAAA,oBAAA,mBAAA,YAAA,EAEX,gBAAA,GAAA,OAAA,MAAA,kBAAA,EACM,iBAAA,CAAA,8BAAA,CAAA,gBAAA,cAAA,OAAA;;;;;;ADNpB;;;;;;;;ACEA;;;;;;;;;;;;;;;;;;;;cCsDa,SAAA,SAAkB,uBAAA;EDnD7B;;;;;EAAA,OCyDO,QAAA,CAAS,OAAA,SAAgB,YAAA,GAAe,aAAA;EAN1B;;;;;;EAAA,OAoBd,aAAA,CAAc,OAAA,SAAgB,kBAAA,GAAqB,aAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/keq.module.ts","../src/constants.ts","../src/interfaces/keq-nest-middleware.interface.ts","../src/keq-consumer.ts","../src/interfaces/keq-middleware-consumer.interface.ts","../src/keq-middleware-consumer.ts","../src/interfaces/keq-module-options.interface.ts","../src/decorators/inject-keq-consumer.decorator.ts"],"mappings":";;;;cAaa,SAAA;;;cCbA,UAAA;EAAA,SAEH,GAAA;AAAA;;;UCCO,iBAAA;EACf,GAAA,CAAI,GAAA,EAAK,mBAAA,EAAqB,IAAA,EAAM,OAAA,UAAiB,WAAA;AAAA;;;AFCvD;;;;;;;;ACLA;;;;;;;;ACGA;AFEA,cGmBa,WAAA,KAAgB,cAAA;EAAA,iBACE,UAAA;cAAA,UAAA,EAAY,UAAA;EAEzC,KAAA,CAAA,GACK,WAAA,EAAa,KAAA,CAAM,iBAAA,GAAoB,aAAA,IACzC,oBAAA,CAAqB,CAAA;AAAA;;;UCvBT,YAAA;EACf,IAAA;EACA,MAAA;EACA,QAAA;AAAA;AAAA,UAGe,cAAA,SAAuB,IAAA;EAAA,SAC7B,WAAA;EAAA,SACA,YAAA;AAAA;;KAIC,cAAA,UAAwB,UAAA,CAAW,GAAA,GAAM,YAAA;AAAA,UAEpC,wBAAA;EACf,OAAA,IAAW,MAAA,EAAQ,YAAA,KAAiB,wBAAA;EACpC,SAAA,IAAa,MAAA,EAAQ,cAAA,KAAmB,qBAAA;AAAA;;UAIzB,oBAAA,KAAyB,cAAA;EACxC,OAAA,IAAW,MAAA,EAAQ,YAAA,KAAiB,oBAAA,CAAqB,CAAA;EACzD,SAAA,IAAa,MAAA,EAAQ,cAAA,KAAmB,WAAA,CAAY,CAAA;AAAA;;;AJvBtD;;;;;;;;ACLA;;;;;;ADKA,cKkBa,qBAAA;EAAA,iBACkB,UAAA;cAAA,UAAA,EAAY,UAAA;EAEzC,KAAA,CAAA,GACK,WAAA,EAAa,KAAA,CAAM,iBAAA,GAAoB,aAAA,IACzC,wBAAA;AAAA;;;UCzBY,gBAAA;EACf,WAAA,GAAc,aAAA;EACd,OAAA;AAAA;;;;;;ANAF;;;;;;;;ACLA;;;;;;iBMqBgB,iBAAA,WAA4B,cAAA,CAAA,CAC1C,WAAA,EAAa,CAAA,GACZ,kBAAA"}

package/dist/index.js

@@ -1,8 +1,138 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-let keq = require("keq");
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
 let _nestjs_common = require("@nestjs/common");
-//#region src/keq.module-definition.ts
-const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE, ASYNC_OPTIONS_TYPE } = new _nestjs_common.ConfigurableModuleBuilder().build();
+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-collector.ts
+/**
+* 中间件收集器，收集中间件配置条目并应用到指定的 {@link KeqRequest} 实例。
+*
+* 通过 `apply()` → `forRoutes()` 链式 API 收集多组中间件条目，
+* 在 `forRoutes()` 被调用时立即将中间件绑定到目标请求。
+*
+* 注意：该类并非 `@Injectable()`，由 Consumer 内部手动创建。
+*
+* @typeParam TConsumer - Consumer 类型（`KeqMiddlewareConsumer` 或 `KeqConsumer<T>`）
+*/
+var KeqMiddlewareCollector = class {
+	entries = [];
+	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);
+				return proxy;
+			},
+			forRoutes: (...routes) => {
+				entry.routes = routes;
+				if (excludedRouteInfos.length > 0) entry.excludedRouteInfos = excludedRouteInfos;
+				this.applyTo(keqRequest);
+				return consumer;
+			}
+		};
+		return proxy;
+	}
+	/**
+	* 将收集的所有中间件条目解析并应用到指定的 {@link KeqRequest} 实例。
+	*/
+	applyTo(keqRequest) {
+		for (const entry of this.entries) {
+			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));
+			}
+			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;
+				const route = this.buildRoute(routeTarget);
+				keqRequest.useRouter().route(route, resolved);
+			}
+		}
+	}
+	/**
+	* 标准化中间件：将不同形式的中间件统一为 {@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) {
+			const host = info.host;
+			routes.push((ctx) => ctx.request.url.host === host);
+		}
+		if (info.method) {
+			const method = info.method.toLowerCase();
+			routes.push((ctx) => ctx.request.method.toLowerCase() === method);
+		}
+		if (info.pathname) {
+			const isMatch = (0, picomatch.default)(info.pathname);
+			routes.push((ctx) => isMatch(ctx.request.url.pathname));
+		}
+		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 \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);
+}
 //#endregion
 //#region \0@oxc-project+runtime@0.127.0/helpers/decorate.js
 function __decorate(decorators, target, key, desc) {
@@ -12,47 +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
+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
 /**
-* Provider that creates and configures a KeqRequest instance
-* Applies any middlewares defined in the module options
+* 为指定 Keq 模块按路由注册中间件。
+*
+* Keq 模块由 `@keq-request/cli` 生成，通过
+* {@link InjectKeqConsumer} 装饰器注入本实例。
+*
+* @typeParam T - 目标模块类
+*
+* @example
+* ```ts
+* constructor(
+*   \@InjectKeqConsumer(GeneratedModule) consumer: KeqConsumer<GeneratedModule>,
+* ) {
+*   consumer.apply(authMw).forRoutes('*')
+* }
+* ```
 */
-const requestProvider = {
-	provide: keq.KeqRequest,
-	useFactory: (config) => {
-		const request = new keq.KeqRequest();
-		if (config.middlewares) for (const middleware of config.middlewares) request.use(middleware);
-		return request;
-	},
-	inject: [MODULE_OPTIONS_TOKEN]
-};
-let KeqModule = class KeqModule extends ConfigurableModuleClass {
-	/**
-	* Register the module with synchronous options
-	* @param options - Configuration options including middlewares
-	* @returns DynamicModule with KeqRequest provider
-	*/
-	static register(options) {
-		const mo = super.register(options);
-		mo.providers.push(requestProvider);
-		mo.global = true;
-		return mo;
+var KeqConsumer = class {
+	constructor(keqRequest) {
+		this.keqRequest = keqRequest;
 	}
-	/**
-	* Register the module with asynchronous options
-	* Useful when you need to inject dependencies like ConfigService
-	* @param options - Async configuration options
-	* @returns DynamicModule with KeqRequest provider
-	*/
-	static registerAsync(options) {
-		const mo = super.registerAsync(options);
-		mo.providers.push(requestProvider);
-		mo.global = true;
-		return mo;
+	apply(...middlewares) {
+		return new KeqMiddlewareCollector(this.keqRequest, this).apply(middlewares);
 	}
 };
-KeqModule = __decorate([(0, _nestjs_common.Global)()], 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":["ConfigurableModuleBuilder","KeqRequest"],"sources":["../src/keq.module-definition.ts","../src/keq.module.ts"],"sourcesContent":["\nimport { ConfigurableModuleBuilder } from '@nestjs/common'\nimport { KeqModuleOptions } from './types/keq-module-options'\n\n\nexport const {\n  ConfigurableModuleClass,\n  MODULE_OPTIONS_TOKEN,\n  OPTIONS_TYPE,\n  ASYNC_OPTIONS_TYPE,\n} = new ConfigurableModuleBuilder<KeqModuleOptions>().build()\n","\nimport { KeqRequest } from 'keq'\nimport { DynamicModule, Global, Provider } from '@nestjs/common'\nimport { ASYNC_OPTIONS_TYPE, ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } from './keq.module-definition.js'\nimport { KeqModuleOptions } from './types/index.js'\n\n\n/**\n * Provider that creates and configures a KeqRequest instance\n * Applies any middlewares defined in the module options\n */\nconst requestProvider: Provider = {\n  provide: KeqRequest,\n  useFactory: (config: KeqModuleOptions) => {\n    const request = new KeqRequest()\n\n    if (config.middlewares) {\n      for (const middleware of config.middlewares) {\n        request.use(middleware)\n      }\n    }\n\n    return request\n  },\n  inject: [MODULE_OPTIONS_TOKEN],\n}\n\n/**\n * KeqModule - Dynamic module for integrating Keq HTTP client with NestJS\n *\n * This module is global, so KeqRequest can be injected anywhere in your application\n * without needing to import the module in every feature module.\n *\n * @example\n * ```typescript\n * // Synchronous registration\n * KeqModule.register({\n *   middlewares: [...]\n * })\n *\n * // Asynchronous registration\n * KeqModule.registerAsync({\n *   imports: [ConfigModule],\n *   useFactory: (config: ConfigService) => ({\n *     middlewares: [...]\n *   }),\n *   inject: [ConfigService]\n * })\n *\n * // Inject in service\n * class UserService {\n *   constructor(private readonly keqRequest: KeqRequest) {}\n *   async getUser(id: string) {\n *     return await this.keqRequest.get(`/users/${id}`).resolveWith('json')\n *   }\n * }\n * ```\n */\n@Global()\nexport class KeqModule extends ConfigurableModuleClass {\n  /**\n   * Register the module with synchronous options\n   * @param options - Configuration options including middlewares\n   * @returns DynamicModule with KeqRequest provider\n   */\n  static register(options: typeof OPTIONS_TYPE): DynamicModule {\n    const mo = super.register(options)\n    mo.providers!.push(requestProvider)\n    mo.global = true\n\n    return mo\n  }\n\n  /**\n   * Register the module with asynchronous options\n   * Useful when you need to inject dependencies like ConfigService\n   * @param options - Async configuration options\n   * @returns DynamicModule with KeqRequest provider\n   */\n  static registerAsync(options: typeof ASYNC_OPTIONS_TYPE): DynamicModule {\n    const mo = super.registerAsync(options)\n    mo.providers!.push(requestProvider)\n    mo.global = true\n\n    return mo\n  }\n}\n"],"mappings":";;;;AAKA,MAAa,EACX,yBACA,sBACA,cACA,uBACE,IAAIA,eAAAA,2BAA6C,CAAC,OAAO;;;;;;;;;;;;;;;ACC7D,MAAM,kBAA4B;CAChC,SAASC,IAAAA;CACT,aAAa,WAA6B;EACxC,MAAM,UAAU,IAAIA,IAAAA,YAAY;AAEhC,MAAI,OAAO,YACT,MAAK,MAAM,cAAc,OAAO,YAC9B,SAAQ,IAAI,WAAW;AAI3B,SAAO;;CAET,QAAQ,CAAC,qBAAqB;CAC/B;AAkCM,IAAA,YAAA,MAAM,kBAAkB,wBAAwB;;;;;;CAMrD,OAAO,SAAS,SAA6C;EAC3D,MAAM,KAAK,MAAM,SAAS,QAAQ;AAClC,KAAG,UAAW,KAAK,gBAAgB;AACnC,KAAG,SAAS;AAEZ,SAAO;;;;;;;;CAST,OAAO,cAAc,SAAmD;EACtE,MAAM,KAAK,MAAM,cAAc,QAAQ;AACvC,KAAG,UAAW,KAAK,gBAAgB;AACnC,KAAG,SAAS;AAEZ,SAAO;;;oDA1BF,CAAA,EAAA,UAAA"}
+{"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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"}