import { MediaType, Method } from '../common';
import { Schema } from '../schema';
/**
 * @see https://swagger.io/docs/specification/describing-parameters/
 */
export type Paths = Record<string, Record<Method, OperationMetadata_v3>>;
export type ParameterLocation_v3 = 'query' | 'path';
export interface OperationMetadata_v3 {
    operationId: string;
    /** 当前接口说明 */
    summary: string;
    /** 参数列表 */
    parameters: Parameter_v3[];
    /** 接口标签，作为api分类用，多个分类将转成字符串 */
    tags: string[];
    /** 请求携带的参数 */
    requestBody?: RequestBody_v3;
    /** api返回值 */
    responses: Responses_v3;
}
export interface Parameter_v3 {
    /** 参数字段名称 */
    name: string;
    /** 参数位置 */
    in: ParameterLocation_v3;
    /** 参数详细定义 */
    schema: Schema;
    /**
     * query 参数类型 比如string、number
     */
    type: string;
    /**
     * 数据类型，eg: int32,date-time
     */
    format: string;
    /**
     * 是否为必填
     * @default false
     */
    required?: boolean;
    /** 参数描述 */
    description?: string;
    /**
     * 允许无值，只有字段的情况
     * @example GET /foo?metadata
     */
    allowEmptyValue?: boolean;
    /** 案例 */
    examples?: object;
    /** 废弃 */
    deprecated?: boolean;
}
export type RequestBody_v3 = RequestBodyObject_v3 | RequestBodyRef_v3;
export interface RequestBodyObject_v3 {
    content?: BodyObjectContent_v3;
    /** body 的描述 */
    description?: string;
    /** body 是否可选 */
    required?: boolean;
}
export interface RequestBodyRef_v3 {
    $ref: `#/components/requestBodies/${string}`;
}
export type BodyObjectContent_v3 = Partial<Record<MediaType, {
    schema: Schema;
}>>;
export interface ResponseBodyObject_v3 {
    content?: BodyObjectContent_v3;
    /** body 的描述 */
    description?: string;
}
export interface Responses_v3 {
    200?: ResponseBodyObject_v3;
    [k: string]: any;
}