import type { Request, Response } from 'express'; import type { Callable, DefAPINamespace, DeleteAPICallT, GetAPICallT, HeadAPICallT, HttpMethod, InvalidResponse, PatchAPICallT, PostAPICallT, PutAPICallT, RawArgType, ValidResponse, recoveryMethod } from '../apiStructure/defs'; import { validate, type ValidatorOptions, } from "class-validator"; import { type ClassTransformOptions, plainToInstance } from "class-transformer"; export type APINamespace = { [key: string]: APINamespace // eslint-disable-next-line @typescript-eslint/no-explicit-any | ClassType> // eslint-disable-next-line @typescript-eslint/no-explicit-any | ClassType> // eslint-disable-next-line @typescript-eslint/no-explicit-any | ClassType> // eslint-disable-next-line @typescript-eslint/no-explicit-any | ClassType> // eslint-disable-next-line @typescript-eslint/no-explicit-any | ClassType> // eslint-disable-next-line @typescript-eslint/no-explicit-any | ClassType> ; } type ValidatorType = T extends undefined ? undefined : ClassType; // eslint-disable-next-line @typescript-eslint/no-explicit-any export type AnyAPIExecuter = APIExecuter; export abstract class APIExecuter{ readonly abstract reqType: HttpMethod; readonly abstract argValidator?: ValidatorType; protected abstract parseQuery(expressReq: Request): Promise; protected abstract api(query: Q, expressReq: Request, expressRes: Response): Promise; public async run(expressReq: Request, expressRes: Response): Promise { const query = await this.parseQuery(expressReq); //TODO: middleware (인증, 요구사항, 아마도 decorator) const result = await this.api(query, expressReq, expressRes); if (result === true) { return; } expressRes.json(result); } } export abstract class APIBodyParseExecuter extends APIExecuter{ protected async parseQuery(expressReq: Request): Promise { if (!this.argValidator) { return expressReq.body as Q; } const query = expressReq.body; const classObject = plainToInstance(this.argValidator, query); const errors = await validate(classObject); if (errors.length) { throw errors; } return classObject as Q; } } export abstract class GET extends APIExecuter{ override readonly reqType = 'get'; protected async parseQuery(expressReq: Request): Promise { if (!this.argValidator) { return expressReq.query as Q; } const query = expressReq.query; const classObject = plainToInstance(this.argValidator, query); const errors = await validate(classObject); if (errors.length) { throw errors; } return classObject as Q; } } export abstract class POST extends APIBodyParseExecuter{ readonly reqType = 'post'; } export abstract class PUT extends APIBodyParseExecuter{ readonly reqType = 'put'; } export abstract class DELETE extends APIBodyParseExecuter{ readonly reqType = 'delete'; } export abstract class PATCH extends APIBodyParseExecuter{ readonly reqType = 'patch'; } export abstract class HEAD extends APIBodyParseExecuter{ readonly reqType = 'head'; } export function raiseError(reason: string, recovery?: recoveryMethod): InvalidResponse { if (recovery) { return { result: false, reason, recovery, }; } return { result: false, reason, }; } // eslint-disable-next-line @typescript-eslint/no-explicit-any export type ClassType = new (...args: any[]) => T; export type APIServerType = T extends GetAPICallT ? ClassType> : T extends PostAPICallT ? ClassType> : T extends PutAPICallT ? ClassType> : T extends DeleteAPICallT ? ClassType> : T extends PatchAPICallT ? ClassType> : T extends HeadAPICallT ? ClassType> : never; export type APINamespaceType = { [K in keyof T]: T[K] extends Callable ? APIServerType : T[K] extends DefAPINamespace ? APINamespaceType : never; };