@iot9x.com/nestjs-swagger v1.0.2

NestJS Swagger 插件增强版

注意：仍在开发中，目前仅在内部使用

文档地址

使用说明

外部人员仅供参考，请不要用于生产环境，因此导致的事故后果请自行承担。

环境

基于@nestjs/swagger v6.1.2

• node >=16.x
• nest >=9.x

安装

$ npm i @iot9x.com/nestjs-swagger
or
$ yarn add @iot9x.com/nestjs-swagger
or
$ pnpm add @iot9x.com/nestjs-swagger  # 推荐使用pnpm

配置

装饰器模式与原版功能一致，但是 plugin 模式有修改增强。

{
  "collection": "@nestjs/schematics",
  "sourceRoot": "src",
  "compilerOptions": {
    "plugins": [
      {
        "name": "@iot9x.com/nestjs-swagger",
        "options": {
          "dtoFileNameSuffix": [
            ".dto.ts"
          ],
          "controllerFileNameSuffix": ".controller.ts",
          "classValidatorShim": true,
          "introspectComments": true
        }
      }
    ]
  }
}

option配置：

export interface PluginOptions {
  dtoFileNameSuffix?: string | string[];
  controllerFileNameSuffix?: string | string[];
  classValidatorShim?: boolean;
  dtoKeyOfComment?: string;
  controllerKeyOfComment?: 'summary' | 'description';
  introspectComments?: boolean;
}

RoadMap

• √ 支持Controller中方法注释的@return注释描述。
• 支持ResDTO泛型类型。
• 支持interface类型参数的DTO解析。