docs: add using with nestjs

Author: Val-istar-Guo

docs/7.libraries/1.cli/1.overview.mdx

@@ -1,7 +1,7 @@
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 import InstallPackagesCode from '@site/docs/components/_install-packages-code.mdx'
-import PackageManager from '@site/docs/components/_package-manager.mdx';
+import ExecPackageCommandCode from '@site/docs/components/_exec-package-command-code.mdx'
 
 # 概览
 
@@ -136,7 +136,7 @@ import PackageManager from '@site/docs/components/_package-manager.mdx';
 
 接下来，在终端执行以下命令：
 
-<PackageManager command="keq build" />
+<ExecPackageCommandCode command="keq build" />
 
 执行完成后，`@keq-request/cli` 会在 `./src/apis/cat_service/` 目录下生成如下文件：
 

docs/8.advanced/3.using-with-nestjs.mdx

@@ -0,0 +1,135 @@
+import InstallPackagesCode from '@site/docs/components/_install-packages-code.mdx'
+import ExecPackageCommandCode from '@site/docs/components/_exec-package-command-code.mdx'
+
+# 在 NestJS 中使用 Keq
+
+本文介绍如何在 NestJS 项目中集成 Keq，以及如何使用 OpenAPI 自动生成类型安全的客户端代码。
+
+## 安装依赖
+
+
+<InstallPackagesCode packages="keq @keq-request/cli @keq-request/nestjs" />
+
+## 注册 KeqModule
+
+在应用的根模块中注册 `KeqModule`：
+
+```typescript title="src/app.module.ts"
+import { Module } from '@nestjs/common'
+import { KeqModule } from '@keq-request/nestjs'
+import { validateStatusCode } from '@keq-request/exception'
+
+@Module({
+  imports: [
+    KeqModule.register({                // [!code ++]
+      middlewares: [                    // [!code ++]
+        // 配置全局中间件                  [!code ++]
+        validateStatusCode(),           // [!code ++]
+      ]                                 // [!code ++]
+    }),                                 // [!code ++]
+
+    /* ...其他模块... */
+  ]
+})
+export class AppModule {}
+```
+
+注册后即可在 Service 中通过依赖注入使用 `KeqRequest`：
+
+```typescript title="src/app.service.ts"
+import { Injectable } from '@nestjs/common'
+import { KeqRequest } from 'keq'
+
+@Injectable()
+export class AppService {
+  constructor(private readonly request: KeqRequest) {}
+
+  async getCats() {
+    const cats = await this.request.get('https://api.example.com/cats')
+    return cats
+  }
+}
+```
+
+## 使用 OpenAPI 生成 NestJS 模块
+
+`@keq-request/cli` 支持从 OpenAPI 文档生成 NestJS 模块，提供完整的类型定义和依赖注入支持。
+
+### 配置生成模式
+
+在 `.keqrc.ts` 中设置 `mode` 为 `nestjs-module`：
+
+```typescript title=".keqrc.ts"
+import { defineKeqConfig, FileNamingStyle } from '@keq-request/cli'
+
+export default defineKeqConfig({
+  mode: 'nestjs-module',   // [!code ++]
+  outdir: "./src/apis",
+  fileNamingStyle: FileNamingStyle.snakeCase,
+  modules: {
+    catService: "./cat-service-swagger.json",
+  },
+})
+```
+
+运行生成命令：
+
+<ExecPackageCommandCode command="keq build" />
+
+### 注册生成的模块
+
+将生成的模块导入到应用中：
+
+```typescript title="src/app.module.ts"
+import { Module } from '@nestjs/common'
+import { KeqModule } from '@keq-request/nestjs'
+import { CatServiceModule } from './apis/cat_service/cat_service.module' // [!code ++]
+
+@Module({
+  imports: [
+    // 必须注册 KeqModule
+    KeqModule.register({
+      // 配置全局中间件
+      middlewares: [
+        validateStatusCode(),
+      ]
+    }),
+
+    // 注册生成的模块
+    CatServiceModule.register({                                   // [!code ++]
+      // 模块级中间件配置                                            [!code ++]
+      middlewares: [                                              // [!code ++]
+        setBaseUrl('https://cat-api.example.com'),                // [!code ++]
+        appendHeader('Authorization', 'Bearer YOUR_TOKEN_HERE'),  // [!code ++]
+      ]                                                           // [!code ++]
+    }),                                                           // [!code ++]
+  ]
+})
+export class AppModule {}
+```
+
+:::tip 中间件执行顺序
+请求发送时，中间件的执行顺序为：全局中间件 → 模块级中间件。
+:::
+
+### 使用生成的客户端
+
+```typescript title="src/cat.service.ts"
+import { Injectable } from '@nestjs/common'
+import { CatServiceClient } from './apis/cat_service/cat_service.client'
+
+@Injectable()
+export class CatService {
+  constructor(private readonly catServiceClient: CatServiceClient) {}
+
+  async getCats() {
+    const response = await this.catServiceClient.getCats<200>()
+    return response.body
+  }
+
+  async getCatById(id: string) {
+    const response = await this.catServiceClient.getCatById<200>({ id })
+    return response.body
+  }
+}
+```

docs/components/_exec-package-command-code.mdx

@@ -0,0 +1,10 @@
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+import CodeBlock from '@theme/CodeBlock';
+import PackageManager from './_package-manager.mdx';
+
+<PackageManager
+  npm={`npx ${props.command}`}
+  pnpm={`pnpm ${props.command}`}
+  yarn={`yarn ${props.command}`}
+/>

docs/components/_install-packages-code.mdx

@@ -3,4 +3,8 @@ import TabItem from '@theme/TabItem';
 import CodeBlock from '@theme/CodeBlock';
 import PackageManager from './_package-manager.mdx';
 
-<PackageManager command={`install ${props.packages}@alpha`} />
+<PackageManager
+  npm={`npm install ${props.packages.split(' ').map(pkg => `${pkg}@alpha`).join(' ')}`}
+  pnpm={`pnpm install ${props.packages.split(' ').map(pkg => `${pkg}@alpha`).join(' ')}`}
+  yarn={`yarn install ${props.packages.split(' ').map(pkg => `${pkg}@alpha`).join(' ')}`}
+/>

docs/components/_package-manager.mdx

@@ -5,17 +5,17 @@ import CodeBlock from '@theme/CodeBlock';
 <Tabs groupId="package-manager">
   <TabItem value="npm" label="npm" default>
     <CodeBlock language="bash">
-    {`npm ${props.command}`}
+    {props.npm}
     </CodeBlock>
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
     <CodeBlock language="bash">
-    {`pnpm ${props.command}`}
+    {props.pnpm}
     </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="yarn">
     <CodeBlock language="bash">
-    {`yarn ${props.command}`}
+    {props.yarn}
     </CodeBlock>
   </TabItem>
 </Tabs>