UNPKG

@hestjs/scalar

Version:

HestJS Scalar API Reference Integration - Beautiful API documentation for HestJS applications

62 lines 1.58 kB
import 'reflect-metadata'; import type { ControllerConstructor } from '@hestjs/core'; import type { OpenAPIV3 } from './decorators/openapi.decorators'; /** * OpenAPI 生成器配置 */ export interface OpenAPIGeneratorConfig { /** 基础文档信息 */ info: OpenAPIV3.InfoObject; /** 服务器配置 */ servers?: OpenAPIV3.ServerObject[]; /** 安全方案 */ security?: OpenAPIV3.SecurityRequirementObject[]; /** 全局标签 */ tags?: OpenAPIV3.TagObject[]; /** 外部文档 */ externalDocs?: OpenAPIV3.ExternalDocumentationObject; /** 全局组件 */ components?: OpenAPIV3.ComponentsObject; } /** * OpenAPI 文档生成器 */ export declare class OpenAPIGenerator { private config; private paths; private components; constructor(config: OpenAPIGeneratorConfig); /** * 从控制器类生成 OpenAPI 路径 */ addController(controller: ControllerConstructor, basePath?: string): void; /** * 生成操作对象 */ private generateOperation; /** * 从类添加 Schema */ private addSchemaFromClass; /** * 标准化路径 */ private normalizePath; /** * 拼接路径 */ private joinPaths; /** * 添加全局组件 */ addComponent(type: keyof OpenAPIV3.ComponentsObject, name: string, component: any): void; /** * 生成完整的 OpenAPI 文档 */ generateDocument(): OpenAPIV3; /** * 重置生成器 */ reset(): void; } //# sourceMappingURL=openapi-generator.d.ts.map