105 lines
3.8 KiB
TypeScript
105 lines
3.8 KiB
TypeScript
import { IJsonSchemaTypes } from "../../types/IJSONSchema";
|
|
|
|
// Symbols for the Property Registery:
|
|
const _registeredOpenAPIMethods_ = Symbol('_registeredOpenAPIMethods_');
|
|
const _registeredOpenAPIParams_ = Symbol('_registeredOpenAPIParams_');
|
|
|
|
// Interfaces for the Class
|
|
export interface IExportToOpenAPIParameters {
|
|
uri?: string
|
|
}
|
|
|
|
export interface IOpenAPIServiceParameters {
|
|
uris?: {
|
|
// Is able to express a link like:
|
|
// users/{id}, where as the element provided
|
|
// in the brackets MUST BE part of the Parameters.
|
|
uri: string,
|
|
convertfunction: () => {}
|
|
}[],
|
|
parameters?: {
|
|
in: 'path' | 'body' | 'query',
|
|
// The element provided in the name MUST BE part of the Parameters.
|
|
name: string,
|
|
required: boolean,
|
|
type: IJsonSchemaTypes
|
|
}[],
|
|
description?: string,
|
|
tags?: string[],
|
|
operationId?: string
|
|
}
|
|
|
|
export interface IExportMethodToOpenAPIParameters {
|
|
method?: Array<'post' | 'get'> | 'post' | 'get',
|
|
post?: IOpenAPIServiceParameters,
|
|
get?: IOpenAPIServiceParameters
|
|
}
|
|
|
|
export interface IExportPropertyToOpenAPIParameters {
|
|
uri?: string,
|
|
readonly?: boolean
|
|
}
|
|
|
|
/**
|
|
* Decorator used to export a Class API over openAPI
|
|
* @param options
|
|
*/
|
|
export function exportsElementsToOpenAPI(options: IExportToOpenAPIParameters) {
|
|
return function <T extends { new(...args: any[]): {} }>(Base: T) {
|
|
return class extends Base {
|
|
constructor(...args: any[]) {
|
|
super(...args);
|
|
|
|
const _this = this as any;
|
|
|
|
// extract the Registered Methods of the Class.
|
|
const registeredMethods = Base.prototype[_registeredOpenAPIMethods_] as Map<string, IExportMethodToOpenAPIParameters>;
|
|
const registeredParams = Base.prototype[_registeredOpenAPIParams_] as Map<string, IExportPropertyToOpenAPIParameters>;
|
|
|
|
// Online if they are present, iterate over them
|
|
if (registeredMethods) {
|
|
_this.__OpenAPIRegisterdMethods = (cb: (methodName: string, callback: (...args) => Promise<any>, options: IExportMethodToOpenAPIParameters) => void) => {
|
|
registeredMethods.forEach((options, methodName) => {
|
|
// Callback the Method
|
|
cb(methodName, async (...args) => _this[methodName](...args), options);
|
|
});
|
|
}
|
|
}
|
|
|
|
// Online if they are present, iterate over them
|
|
if (registeredParams) {
|
|
_this.__OpenAPIRegisterdParams = (cb: (methodName: string, callback: (...args) => Promise<any>, options: IExportPropertyToOpenAPIParameters) => void) => {
|
|
registeredParams.forEach((options, methodName) => {
|
|
// Callback the Method
|
|
cb(methodName, async (...args) => _this[methodName](...args), options);
|
|
});
|
|
}
|
|
}
|
|
}
|
|
};
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Decorator, used to export the Method.
|
|
* @param options
|
|
*/
|
|
export function exportMethodToOpenAPI(options: IExportMethodToOpenAPIParameters = {}) {
|
|
return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
|
|
target[_registeredOpenAPIMethods_] = target[_registeredOpenAPIMethods_] || new Map<string, IExportMethodToOpenAPIParameters>();
|
|
// Here we just add some information that class decorator will use
|
|
target[_registeredOpenAPIMethods_].set(propertyKey, options);
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Decorator, will create a POST and GET api for the Parameter.
|
|
* @param options
|
|
*/
|
|
export function exportPropertyToOpenAPI(options: IExportPropertyToOpenAPIParameters = {}) {
|
|
return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
|
|
target[_registeredOpenAPIParams_] = target[_registeredOpenAPIParams_] || new Map<string, IExportPropertyToOpenAPIParameters>();
|
|
// Here we just add some information that class decorator will use
|
|
target[_registeredOpenAPIParams_].set(propertyKey, options);
|
|
};
|
|
} |