80 lines
3.0 KiB
TypeScript
80 lines
3.0 KiB
TypeScript
|
|
import type { Request, Response } from 'express';
|
|
|
|
export interface ValidResponse {
|
|
result: true;
|
|
}
|
|
|
|
export type recoveryMethod = 'refreshEntirePage' | 'retryAPI' | 'gameLogin' | 'gatewayLogin' | 'gatewayPIN';
|
|
|
|
export interface InvalidResponse {
|
|
result: false;
|
|
reason: string;
|
|
recovery?: recoveryMethod;
|
|
}
|
|
|
|
export const treatedSpecial = Symbol('treatedSpecial');
|
|
export type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head';
|
|
export type RawArgType = Record<string, unknown> | Record<string, unknown>[] | undefined;
|
|
|
|
export type APINamespace = {
|
|
[key: string]: APINamespace
|
|
| GET<any, any, any>
|
|
| POST<any, any, any>
|
|
| PUT<any, any, any>
|
|
| DELETE<any, any, any>
|
|
| PATCH<any, any, any>
|
|
| HEAD<any, any, any>
|
|
;
|
|
}
|
|
|
|
export abstract class APIExecuter<R extends ValidResponse, E extends InvalidResponse, Q extends RawArgType>{
|
|
readonly abstract reqType: HttpMethod | HttpMethod[];
|
|
protected abstract parseQuery(expressReq: Request): Promise<Q>;
|
|
protected abstract api(query: Q, expressReq: Request, expressRes: Response): Promise<R | E | typeof treatedSpecial>;
|
|
public async run(expressReq: Request, expressRes: Response): Promise<void> {
|
|
const query = await this.parseQuery(expressReq);
|
|
//TODO: middleware (인증, 요구사항, 아마도 decorator)
|
|
const result = await this.api(query, expressReq, expressRes);
|
|
if (result === treatedSpecial) {
|
|
return;
|
|
}
|
|
expressRes.json(result);
|
|
}
|
|
}
|
|
|
|
export abstract class APIBodyParseExecuter<R extends ValidResponse, E extends InvalidResponse, Q extends RawArgType> extends APIExecuter<R, E, Q>{
|
|
protected async parseQuery(expressReq: Request): Promise<Q> {
|
|
throw new Error('Not implemented');
|
|
return expressReq.body;
|
|
}
|
|
}
|
|
|
|
export abstract class GET<R extends ValidResponse, E extends InvalidResponse, Q extends RawArgType> extends APIExecuter<R, E, Q>{
|
|
override readonly reqType = 'get';
|
|
protected async parseQuery(expressReq: Request): Promise<Q> {
|
|
expressReq.query;
|
|
throw new Error('Not implemented');
|
|
return expressReq.query as unknown as Q;
|
|
}
|
|
}
|
|
|
|
export abstract class POST<R extends ValidResponse, E extends InvalidResponse, Q extends RawArgType> extends APIBodyParseExecuter<R, E, Q>{
|
|
readonly reqType = 'post';
|
|
}
|
|
|
|
export abstract class PUT<R extends ValidResponse, E extends InvalidResponse, Q extends RawArgType> extends APIBodyParseExecuter<R, E, Q>{
|
|
readonly reqType = 'put';
|
|
}
|
|
|
|
export abstract class DELETE<R extends ValidResponse, E extends InvalidResponse, Q extends RawArgType> extends APIBodyParseExecuter<R, E, Q>{
|
|
readonly reqType = 'delete';
|
|
}
|
|
|
|
export abstract class PATCH<R extends ValidResponse, E extends InvalidResponse, Q extends RawArgType> extends APIBodyParseExecuter<R, E, Q>{
|
|
readonly reqType = 'patch';
|
|
}
|
|
|
|
export abstract class HEAD<R extends ValidResponse, E extends InvalidResponse, Q extends RawArgType> extends APIBodyParseExecuter<R, E, Q>{
|
|
readonly reqType = 'head';
|
|
} |