type SwaggerOperation = {
    summary: string;
    tags?: string[];
    deprecated?: boolean;
    operationId?: string;
    parameters?: RouteParam[];
    requestBody?: {
        content: {
            'application/json': {
                schema: object;
            };
        };
    };
    responses: Record<number, SwaggerResponse>;
    security?: Array<{
        BearerAuth: [];
    }>;
};
type SwaggerResponse = {
    description: string;
    content?: {
        'application/json': SwaggerJSONContent;
    };
};
type SwaggerJSONContent = {
    schema: {
        type: 'object';
        properties: Record<string, {
            type: JSONSchemaType;
        }>;
    };
};
export type JSONSchemaType = 'string' | 'number' | 'boolean' | 'object' | 'array';
export type RouteParam = {
    name: string;
    in: 'path' | 'query' | 'header' | 'cookie';
    description?: string;
    required?: boolean;
    type: JSONSchemaType;
    example?: string | number | boolean | object | [];
};
export type SwaggerParams = {
    summary: string;
    tags?: string[];
    deprecated?: boolean;
    authentication?: boolean;
    operationId?: string;
    input?: object;
    output?: object;
    statusCode?: number;
    contentType?: string;
    errorMapping?: Record<number, {
        description: string;
        schema?: object;
    }>;
    routeParams?: RouteParam[];
};
export declare const buildSwaggerDoc: (params: SwaggerParams) => SwaggerOperation;
export {};