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

package/.turbo/turbo-build.log

@@ -1,10 +1,10 @@
 
-> @keq-request/nestjs@5.0.0-beta.9 build /home/runner/work/keq/keq/packages/nestjs
+> @keq-request/nestjs@5.0.1 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:2655) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/keq/keq/packages/nestjs/tsdown.config.ts?no-cache=13f8821f-6db3-40f6-9801-4c8ce3adbf53 is not specified and it doesn't parse as CommonJS.
+(node:2862) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/keq/keq/packages/nestjs/tsdown.config.ts?no-cache=458d8326-b0c5-4ed1-8725-3dd5fecc0756 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      2.35 kB │ gzip: 1.00 kB
-ℹ [CJS] dist/index.js.map  3.54 kB │ gzip: 1.35 kB
-ℹ [CJS] 2 files, total: 5.89 kB
+ℹ [CJS] dist/index.js       8.01 kB │ gzip: 2.93 kB
+ℹ [CJS] dist/index.js.map  11.70 kB │ gzip: 3.78 kB
+ℹ [CJS] 2 files, total: 19.72 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.54 kB │ gzip: 0.30 kB
-ℹ [CJS] dist/index.d.ts      2.17 kB │ gzip: 0.89 kB
-ℹ [CJS] 2 files, total: 2.71 kB
+ℹ [CJS] dist/index.d.ts.map  1.39 kB │ gzip: 0.55 kB
+ℹ [CJS] dist/index.d.ts      3.81 kB │ gzip: 1.45 kB
+ℹ [CJS] 2 files, total: 5.20 kB
 [PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-  - rolldown-plugin-dts:generate (49%)
-ℹ [ESM] dist/index.mjs        2.17 kB │ gzip: 0.92 kB
-ℹ [ESM] dist/index.mjs.map    3.49 kB │ gzip: 1.34 kB
-ℹ [ESM] dist/index.d.mts.map  0.54 kB │ gzip: 0.30 kB
-ℹ [ESM] dist/index.d.mts      2.17 kB │ gzip: 0.89 kB
-ℹ [ESM] 4 files, total: 8.37 kB
-✔ Build complete in 4631ms
-✔ Build complete in 4632ms
-  - tsdown:deps (46%)
+  - rolldown-plugin-dts:generate (47%)
+  - tsdown:deps (42%)
 See https://rolldown.rs/options/checks#plugintimings for more details.
 
+✔ Build complete in 5441ms
+ℹ [ESM] dist/index.mjs         6.58 kB │ gzip: 2.45 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.map    11.61 kB │ gzip: 3.75 kB
+ℹ [ESM] dist/index.d.mts.map   1.39 kB │ gzip: 0.55 kB
+ℹ [ESM] dist/index.d.mts       3.81 kB │ gzip: 1.46 kB
+ℹ [ESM] 4 files, total: 23.38 kB
 
+✔ Build complete in 5443ms

package/CHANGELOG.md

@@ -1,5 +1,141 @@
 # @keq-request/nestjs
 
+## 5.0.1
+
+## 5.0.0
+
+### Major Changes
+
+- 23c971f: **BREAKING CHANGE:** Add NestJS integration with dependency injection pattern.
+
+  - Introduce `KeqMiddlewareConsumer` as an injectable service and `@InjectKeqConsumer()` decorator with `KeqConsumer<T>` for module-scoped middleware.
+  - Remove `KeqMiddlewareModule` interface and `configureKeqMiddleware()` lifecycle method. Middleware is now registered by injecting `KeqMiddlewareConsumer` or `KeqConsumer<T>` directly into services.
+  - Remove `KeqMiddlewareConsumer` interface — it is now a concrete `@Injectable()` class provided by `KeqModule`.
+  - Remove `hasConfigureKeqMiddleware()` utility function.
+  - Remove `forRoutes()` support for `KeqModuleClass` route targets. Use `KeqConsumer<T>` (injected via `@InjectKeqConsumer(ModuleClass)`) for module-scoped middleware.
+  - `KeqModuleClass` now requires a static `KEQ_CONSUMER: symbol` property in addition to `KEQ_REQUEST`.
+  - `KeqModule` no longer has a `register()` static method — it is now a bare `@Global()` module. Import `KeqModule` directly.
+  - Add `@InjectKeqConsumer(ModuleClass)` decorator, `KeqConsumer<T>` class, `KeqRouteTarget` type, and `KeqScopedConfigProxy<T>` interface.
+  - Add `exclude()` method to `KeqMiddlewareConfigProxy`, allowing middleware to skip specific routes.
+  - CLI-generated NestJS modules auto-import `KeqModule` and expose `KEQ_CONSUMER` symbol with `KeqConsumer` provider for `@InjectKeqConsumer()` injection.
+
+### Patch Changes
+
+- Updated dependencies [c2d4453]
+- Updated dependencies [95908fd]
+- Updated dependencies [153244f]
+- Updated dependencies [0a2eb2f]
+- Updated dependencies [153244f]
+- Updated dependencies [a960073]
+- Updated dependencies [214ae66]
+- Updated dependencies [153244f]
+- Updated dependencies [7ff2162]
+- Updated dependencies [f84775d]
+- Updated dependencies [153244f]
+- Updated dependencies [a7a83da]
+- Updated dependencies [153244f]
+- Updated dependencies [153244f]
+- Updated dependencies [f8abc63]
+- Updated dependencies [153244f]
+- Updated dependencies [ca6c879]
+- Updated dependencies [b8d02ca]
+- Updated dependencies [0a04864]
+- Updated dependencies [153244f]
+- Updated dependencies [eed26f9]
+  - keq@5.0.0
+
+## 5.0.0-beta.19
+
+### Patch Changes
+
+- Updated dependencies [cc017de]
+  - keq@5.0.0-beta.19
+
+## 5.0.0-beta.18
+
+### Patch Changes
+
+- keq@5.0.0-beta.18
+
+## 5.0.0-beta.17
+
+### Patch Changes
+
+- keq@5.0.0-beta.17
+
+## 5.0.0-beta.16
+
+### Patch Changes
+
+- Updated dependencies [c2d4453]
+- Updated dependencies [a960073]
+- Updated dependencies [f84775d]
+  - keq@5.0.0-beta.16
+
+## 5.0.0-beta.15
+
+### Patch Changes
+
+- keq@5.0.0-beta.15
+
+## 5.0.0-beta.14
+
+### Major Changes
+
+- 23c971f: **BREAKING CHANGE:** Refactor NestJS middleware configuration from lifecycle hook pattern to dependency injection pattern, introducing `KeqMiddlewareConsumer` as an injectable service and `@InjectKeqConsumer()` decorator with `KeqConsumer<T>` for module-scoped middleware.
+
+  - Remove `KeqMiddlewareModule` interface and `configureKeqMiddleware()` lifecycle method. Middleware is now registered by injecting `KeqMiddlewareConsumer` or `KeqConsumer<T>` directly into services.
+  - Remove `KeqMiddlewareConsumer` interface — it is now a concrete `@Injectable()` class provided by `KeqModule`.
+  - Remove `hasConfigureKeqMiddleware()` utility function.
+  - Remove `forRoutes()` support for `KeqModuleClass` route targets. Use `KeqConsumer<T>` (injected via `@InjectKeqConsumer(ModuleClass)`) for module-scoped middleware.
+  - `KeqModuleClass` now requires a static `KEQ_CONSUMER: symbol` property in addition to `KEQ_REQUEST`.
+  - `KeqModule` no longer has a `register()` static method — it is now a bare `@Global()` module. Import `KeqModule` directly.
+  - Add `@InjectKeqConsumer(ModuleClass)` decorator, `KeqConsumer<T>` class, `KeqRouteTarget` type, and `KeqScopedConfigProxy<T>` interface.
+  - CLI-generated NestJS modules now expose `KEQ_CONSUMER` symbol and provide a `KeqConsumer` provider for `@InjectKeqConsumer()` injection.
+
+### Patch Changes
+
+- keq@5.0.0-beta.14
+
+## 5.0.0-beta.13
+
+### Patch Changes
+
+- 59f4773: **Fix:** ensure `configureKeqMiddleware()` works correctly in pnpm monorepos and validate module imports at startup.
+
+  - Fix middleware not being applied when pnpm creates multiple `@keq-request/nestjs` instances due to peerDependency version differences.
+  - Detect missing `KeqModule` imports in modules that implement `configureKeqMiddleware()` at startup, throwing a clear error instead of silently skipping middleware.
+  - Prevent middleware from being applied more than once when multiple `KeqModule` instances exist.
+  - Throw a descriptive error when a NestJS middleware class passed to `consumer.apply()` is not registered as a provider.
+  - keq@5.0.0-beta.13
+
+## 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
+
+- keq@5.0.0-beta.11
+
+## 5.0.0-beta.10
+
+### Minor Changes
+
+- 2e13e75: **BREAKING CHANGE:** Remove `request` option from `KeqModuleOptions`, use fork-based instance isolation instead.
+
+### Patch Changes
+
+- Updated dependencies [95908fd]
+  - keq@5.0.0-beta.10
+
 ## 5.0.0-beta.9
 
 ### Patch Changes

package/__tests__/keq-module.spec.ts

@@ -0,0 +1,203 @@
+import 'reflect-metadata'
+import { expect, test } from '@jest/globals'
+import type { KeqMiddleware } from 'keq'
+import { KeqRequest } from 'keq'
+import { KeqMiddlewareConsumer } from '../src/keq-middleware-consumer.js'
+import { KeqConsumer } from '../src/keq-consumer.js'
+import { KEQ_ROUTES } from '../src/constants.js'
+
+
+test('applies global middleware via forRoutes(KEQ_ROUTES.ALL)', () => {
+  const keqRequest = new KeqRequest()
+  const consumer = new KeqMiddlewareConsumer(keqRequest)
+
+  const middleware: KeqMiddleware = async (_ctx, next) => { await next() }
+  consumer.apply(middleware).forRoutes(KEQ_ROUTES.ALL)
+
+  expect(keqRequest.middlewares.length).toBe(1)
+})
+
+test('applies global middleware when forRoutes receives no arguments', () => {
+  const keqRequest = new KeqRequest()
+  const consumer = new KeqMiddlewareConsumer(keqRequest)
+
+  const middleware: KeqMiddleware = async (_ctx, next) => { await next() }
+  consumer.apply(middleware).forRoutes()
+
+  expect(keqRequest.middlewares.length).toBe(1)
+})
+
+test('applies route-specific middleware via forRoutes with KeqRouteInfo', () => {
+  const keqRequest = new KeqRequest()
+  const consumer = new KeqMiddlewareConsumer(keqRequest)
+
+  const middleware: KeqMiddleware = async (_ctx, next) => { await next() }
+  consumer.apply(middleware).forRoutes({ pathname: '/api/*' })
+
+  expect(keqRequest.middlewares.length).toBe(1)
+})
+
+test('supports multiple middleware in single apply()', () => {
+  const keqRequest = new KeqRequest()
+  const consumer = new KeqMiddlewareConsumer(keqRequest)
+
+  const mw1: KeqMiddleware = async (_ctx, next) => { await next() }
+  const mw2: KeqMiddleware = async (_ctx, next) => { await next() }
+  consumer.apply(mw1, mw2).forRoutes(KEQ_ROUTES.ALL)
+
+  expect(keqRequest.middlewares.length).toBe(2)
+})
+
+test('supports multiple apply() calls', () => {
+  const keqRequest = new KeqRequest()
+  const consumer = new KeqMiddlewareConsumer(keqRequest)
+
+  const mw1: KeqMiddleware = async (_ctx, next) => { await next() }
+  const mw2: KeqMiddleware = async (_ctx, next) => { await next() }
+
+  consumer.apply(mw1).forRoutes(KEQ_ROUTES.ALL)
+  consumer.apply(mw2).forRoutes({ pathname: '/api/*' })
+
+  expect(keqRequest.middlewares.length).toBe(2)
+})
+
+test('supports exclude().forRoutes() chaining', () => {
+  const keqRequest = new KeqRequest()
+  const consumer = new KeqMiddlewareConsumer(keqRequest)
+
+  const middleware: KeqMiddleware = async (_ctx, next) => { await next() }
+  consumer.apply(middleware).exclude({ pathname: '/health' }).forRoutes(KEQ_ROUTES.ALL)
+
+  expect(keqRequest.middlewares.length).toBe(1)
+})
+
+test('middleware is applied synchronously at forRoutes() call time', () => {
+  const keqRequest = new KeqRequest()
+  const consumer = new KeqMiddlewareConsumer(keqRequest)
+
+  const middleware: KeqMiddleware = async (_ctx, next) => { await next() }
+
+  expect(keqRequest.middlewares.length).toBe(0)
+  consumer.apply(middleware).forRoutes(KEQ_ROUTES.ALL)
+  expect(keqRequest.middlewares.length).toBe(1)
+})
+
+test('supports chaining multiple apply() calls via forRoutes returning consumer', () => {
+  const keqRequest = new KeqRequest()
+  const consumer = new KeqMiddlewareConsumer(keqRequest)
+
+  const mw1: KeqMiddleware = async (_ctx, next) => { await next() }
+  const mw2: KeqMiddleware = async (_ctx, next) => { await next() }
+  const mw3: KeqMiddleware = async (_ctx, next) => { await next() }
+
+  consumer
+    .apply(mw1).forRoutes(KEQ_ROUTES.ALL)
+    .apply(mw2).forRoutes({ pathname: '/api/*' })
+    .apply(mw3).exclude({ pathname: '/health' }).forRoutes(KEQ_ROUTES.ALL)
+
+  expect(keqRequest.middlewares.length).toBe(3)
+})
+
+// ─── KeqConsumer（模块绑定）测试 ──────────────────────────
+
+test('KeqConsumer applies middleware to its own KeqRequest', () => {
+  const scopedKeqRequest = new KeqRequest()
+  const consumer = new KeqConsumer(scopedKeqRequest)
+
+  const middleware: KeqMiddleware = async (_ctx, next) => { await next() }
+  consumer.apply(middleware).forRoutes(KEQ_ROUTES.ALL)
+
+  expect(scopedKeqRequest.middlewares.length).toBe(1)
+})
+
+test('KeqConsumer does not affect other KeqRequest instances', () => {
+  const globalKeqRequest = new KeqRequest()
+  const scopedKeqRequest = new KeqRequest()
+
+  const globalConsumer = new KeqMiddlewareConsumer(globalKeqRequest)
+  const scopedConsumer = new KeqConsumer(scopedKeqRequest)
+
+  const middleware: KeqMiddleware = async (_ctx, next) => { await next() }
+  scopedConsumer.apply(middleware).forRoutes(KEQ_ROUTES.ALL)
+
+  expect(scopedKeqRequest.middlewares.length).toBe(1)
+  expect(globalKeqRequest.middlewares.length).toBe(0)
+})
+
+// ─── KeqNestMiddleware 实例对象测试 ──────────────────────
+
+test('applies KeqNestMiddleware instance via apply()', () => {
+  const keqRequest = new KeqRequest()
+  const consumer = new KeqMiddlewareConsumer(keqRequest)
+
+  const middleware = {
+    use: async (_ctx: unknown, next: () => Promise<void>) => { await next() },
+  }
+  consumer.apply(middleware).forRoutes(KEQ_ROUTES.ALL)
+
+  expect(keqRequest.middlewares.length).toBe(1)
+})
+
+test('applies KeqNestMiddleware instance to specific route', () => {
+  const keqRequest = new KeqRequest()
+  const consumer = new KeqMiddlewareConsumer(keqRequest)
+
+  const middleware = {
+    use: async (_ctx: unknown, next: () => Promise<void>) => { await next() },
+  }
+  consumer.apply(middleware).forRoutes({ pathname: '/api/*' })
+
+  expect(keqRequest.middlewares.length).toBe(1)
+})
+
+test('mixes KeqMiddleware function and KeqNestMiddleware instance', () => {
+  const keqRequest = new KeqRequest()
+  const consumer = new KeqMiddlewareConsumer(keqRequest)
+
+  const fnMw: KeqMiddleware = async (_ctx, next) => { await next() }
+  const instanceMw = {
+    use: async (_ctx: unknown, next: () => Promise<void>) => { await next() },
+  }
+  consumer.apply(fnMw, instanceMw).forRoutes(KEQ_ROUTES.ALL)
+
+  expect(keqRequest.middlewares.length).toBe(2)
+})
+
+test('KeqNestMiddleware instance receives ctx and next in use()', async () => {
+  const keqRequest = new KeqRequest()
+  const consumer = new KeqMiddlewareConsumer(keqRequest)
+
+  let capturedCtx: unknown = null
+  let capturedNext: unknown = null
+
+  const middleware = {
+    use: async (ctx: unknown, next: () => Promise<void>) => {
+      capturedCtx = ctx
+      capturedNext = next
+      await next()
+    },
+  }
+  consumer.apply(middleware).forRoutes(KEQ_ROUTES.ALL)
+
+  const middlewareFn = keqRequest.middlewares[0]
+  const mockCtx = { request: { url: { host: 'example.com', pathname: '/' }, method: 'GET' } }
+  const mockNext = async () => {}
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  await (middlewareFn as any)(mockCtx, mockNext)
+
+  expect(capturedCtx).toBe(mockCtx)
+  expect(typeof capturedNext).toBe('function')
+})
+
+test('KeqConsumer accepts KeqNestMiddleware instance', () => {
+  const scopedKeqRequest = new KeqRequest()
+  const consumer = new KeqConsumer(scopedKeqRequest)
+
+  const middleware = {
+    use: async (_ctx: unknown, next: () => Promise<void>) => { await next() },
+  }
+  consumer.apply(middleware).forRoutes(KEQ_ROUTES.ALL)
+
+  expect(scopedKeqRequest.middlewares.length).toBe(1)
+})

package/dist/index.d.mts

@@ -1,62 +1,111 @@
-import { KeqMiddleware } from "keq";
-import * as _$_nestjs_common0 from "@nestjs/common";
-import { DynamicModule } from "@nestjs/common";
+import { Type } from "@nestjs/common";
+import { KeqExecutionContext, KeqMiddleware, KeqNext, KeqRequest } from "keq";
 
-//#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.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","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.mts","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"}