Skip to main content
Module

x/alosaur/openapi/mod.ts

Alosaur - Deno web framework with many decorators
Very Popular
Go to Latest
File
import { getMetadataArgsStorage, ObjectKeyAny, AppSettings } from '../src/mod.ts';import { writeJsonSync } from 'https://deno.land/std/fs/mod.ts';
import { MetaRoute } from '../src/models/meta-route.ts';import { MetadataArgsStorage } from '../src/metadata/metadata.ts';import { registerControllers } from '../src/utils/register-controllers.ts';import { registerAreas } from '../src/utils/register-areas.ts';import { OpenApiBuilder } from './builder/openapi-builder.ts';import * as oa from './builder/openapi-models.ts';
/** * For testing this builder use this editor: * https://editor.swagger.io/ */
// Builder OpenAPI v3.0.0export class AlosaurOpenApiBuilder { private classes: ObjectKeyAny[] = []; private metadata: MetadataArgsStorage; private routes: MetaRoute[] = []; private builder = new OpenApiBuilder();
static create(settings: AppSettings): AlosaurOpenApiBuilder { return new AlosaurOpenApiBuilder(settings); }
constructor(settings: AppSettings) { this.metadata = getMetadataArgsStorage();
registerAreas(this.metadata); registerControllers( this.metadata.controllers, this.classes, (route: MetaRoute) => { // '/app/home/test/:id/:name/detail' => '/app/home/test/{id}/{name}/detail' const openApiRoute: string = route.route.replace(/:[A-Za-z1-9]+/g, (m) => `{${m.substr(1)}}`); this.builder.addPath(openApiRoute, this.getPathItem(route)); }, false, ); }
public getSpec(): oa.OpenAPIObject { return this.builder.getSpec(); }
public saveToFile(path: string = './openapi.json'): AlosaurOpenApiBuilder { writeJsonSync(path, this.getSpec()); return this; }
public print(): void { console.log(this.builder.getSpec()); }
private getPathItem(route: MetaRoute): oa.PathItemObject { const operation: oa.OperationObject = { tags: [route.baseRoute], responses: { '200': { description: '', }, }, };
// @ts-ignore: Object is possibly 'null'. operation.parameters = [] as oa.ParameterObject[];
// TODO Add all paramentrs route.params.forEach((param) => { // TODO reference object switch (param.type) { case 'query': // @ts-ignore: Object is possibly 'null'. operation.parameters.push({ // @ts-ignore: Object is possibly 'null'. name: param.name, in: 'query', schema: { type: 'string' }, }); break;
case 'route-param': // @ts-ignore: Object is possibly 'null'. operation.parameters.push({ // @ts-ignore: Object is possibly 'null'. name: param.name, required: true, in: 'path', schema: { type: 'string' }, }); break;
case 'cookie': // @ts-ignore: Object is possibly 'null'. operation.parameters.push({ // @ts-ignore: Object is possibly 'null'. name: param.name, in: 'cookie', schema: { type: 'string' }, }); break; } });
return { [route.method.toLowerCase()]: operation, }; }
public addTitle(title: string): AlosaurOpenApiBuilder { this.builder.addTitle(title); return this; }
public addVersion(version: string): AlosaurOpenApiBuilder { this.builder.addVersion(version); return this; }
public addDescription(description: string): AlosaurOpenApiBuilder { this.builder.addDescription(description); return this; }
public addServer(server: oa.ServerObject): AlosaurOpenApiBuilder { this.builder.addServer(server); return this; }}