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"; import { InvalidProc, ProcDecorator, ProcDecoratorChain, ResolveChain } from './ProcDecorator/base'; import { clamp } from 'lodash-es'; 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; readonly abstract procDecorator: PD; // eslint-disable-next-line @typescript-eslint/no-explicit-any private preDecorator: ProcDecorator[] = []; // eslint-disable-next-line @typescript-eslint/no-explicit-any private postDecorator: (ProcDecorator | undefined)[] = []; private decoratorParsed = false; public parseDecorator(): void { if (this.decoratorParsed) { return; } this.decoratorParsed = true; if (!this.procDecorator) { return; } for (const procGen of this.procDecorator) { const proc = procGen(); if (Array.isArray(proc)) { this.preDecorator.push(proc[0]); this.postDecorator.push(undefined); } else { this.preDecorator.push(proc); this.postDecorator.push(proc); } } } private async preCtx(expressReq: Request, expressRes: Response): Promise | [InvalidProc, ResolveChain, number]> { if (!this.procDecorator) { return {} as ResolveChain; } let ctx = {} as ResolveChain; for (const [idx, proc] of this.preDecorator.entries()) { try { const result = await proc(ctx, expressReq, expressRes, true); if ('invalidProcSymbol' in result) { return [result, ctx, idx]; } ctx = result; } catch (e) { return [{ result: false, reason: `internal error[${idx}]: ${e}`, invalidProcSymbol: ['preCtx', idx], }, ctx, idx]; } } return ctx; } private async postCtx(ctx: ResolveChain, expressReq: Request, expressRes: Response, index = -1): Promise<[InvalidProc, number] | undefined> { if (!this.procDecorator) { return; } let isValidRoute = true; if(index !== -1 && index !== this.postDecorator.length){ isValidRoute = false; index = clamp(index, 0, this.postDecorator.length); } for (let i = index - 1; i >= 0; i--) { const proc = this.postDecorator[i]; if(!proc){ continue; } try { const result = await proc(ctx, expressReq, expressRes, isValidRoute); if ('invalidProcSymbol' in result) { result.invalidProcSymbol = ['postCtx', i, result.invalidProcSymbol]; return [result, i]; } ctx = result; } catch (e) { return [{ result: false, reason: `internal error[${i}]: ${e}`, invalidProcSymbol: ['postCtx', i], }, i]; } } return; } protected abstract parseQuery(expressReq: Request): Promise; protected abstract api(query: Q, ctx: ResolveChain, expressReq: Request, expressRes: Response): Promise; public async run(expressReq: Request, expressRes: Response): Promise { const query = await this.parseQuery(expressReq); const ctx = await this.preCtx(expressReq, expressRes); if (Array.isArray(ctx)) { const [invalidProc, errCtx, idx] = ctx; if (idx == 0){ expressRes.json(invalidProc); return; } const result = await this.postCtx(errCtx, expressReq, expressRes, idx); if (result === undefined) { expressRes.json(invalidProc); return; } const [postInvalidProc,] = result; expressRes.json(postInvalidProc); return; } const result = await this.api(query, ctx, expressReq, expressRes); const postResult = await this.postCtx(ctx, expressReq, expressRes); if (postResult !== undefined) { if(result === true){ //NOTE: 이미 api에서 response를 보낸 특이 케이스. return; } const [invalidProc,] = postResult; invalidProc.alreadyProcessed = true; expressRes.json(invalidProc); return; } if (result !== true) { 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 = // eslint-disable-next-line @typescript-eslint/no-explicit-any T extends GetAPICallT ? ClassType> : // eslint-disable-next-line @typescript-eslint/no-explicit-any T extends PostAPICallT ? ClassType> : // eslint-disable-next-line @typescript-eslint/no-explicit-any T extends PutAPICallT ? ClassType> : // eslint-disable-next-line @typescript-eslint/no-explicit-any T extends DeleteAPICallT ? ClassType> : // eslint-disable-next-line @typescript-eslint/no-explicit-any T extends PatchAPICallT ? ClassType> : // eslint-disable-next-line @typescript-eslint/no-explicit-any T extends HeadAPICallT ? ClassType> : never; export type APINamespaceType = { [K in keyof T]: T[K] extends Callable ? APIServerType : T[K] extends DefAPINamespace ? APINamespaceType : never; };