用途:为 NestJS 项目提供标准化 API 响应模式与常见约定,统一成功响应、分页与错误结构。
主要能力:一是通用响应包装,通过 TransformInterceptor 将数据包装为 { statusCode, data, meta };二是分页标准,使用严格的 PageOptionsDto(page/take/order)与 PageDto<T>(data/meta),并涉及 Swagger 泛型需配合 ApiExtraModels 与 schema 路径解析;三是自定义错误响应,定义 ApiErrorResponse 类,包含 statusCode、message、error、timestamp、path 字段,并可通过 @ApiBadRequestResponse({ type: ApiErrorResponse }) 全局或按控制器应用。
用法要点:按上述拦截器与 DTO 约定改造控制器返回;分页装饰器需参考完整 ApiPaginatedResponse 实现。
适用场景:需要统一接口响应格式、统一分页参数与返回、统一错误输出的 NestJS 后端服务。
限制:资料未提供具体安装命令、依赖版本、完整代码实现与收费信息;优先级标注为 P1(OPERATIONAL)。