devsam/core
3
6
Fork 1
Code Issues 60 Pull Requests Releases 1 Wiki Activity

feat: APICoveryType에 맞게 InvalidResponse 확장

Browse Source
This commit is contained in:
Hide_D
2022-08-18 01:08:38 +09:00
parent b0f3c1c97d
commit 9512ea9b52
1 changed files with 224 additions and 111 deletions
Download Patch File Download Diff File Expand all files Collapse all files
hwe/ts/util/callSammoAPI.ts
+224 -111
View File
@@ -1,157 +1,270 @@
import ky from 'ky'; import ky from "ky";
import { isArray, isEmpty } from "lodash"; import { isArray, isEmpty } from "lodash";
export type ValidResponse = { export type ValidResponse = {
result: true result: true;
} };
export type APIRecoveryType = "login" | "2fa" | "gateway" | "game_login" | "game_quota";
export const APIRecoveryConst = {
Login: 'login',
TwoFactorAuth: '2fa',
Gateway: 'gateway',
GameLogin: 'game_login',
GameQuota: 'game_quota',
} as const;
export type InvalidResponse = { export type InvalidResponse = {
result: false; result: false;
reason: string; reason: string;
} recovery?: APIRecoveryType;
recovery_arg?: string | number;
};
export type RawArgType = Record<string, unknown> | Record<string, unknown>[] | undefined; export type RawArgType = Record<string, unknown> | Record<string, unknown>[] | undefined;
interface BasicAPICallT<ArgType extends RawArgType, ResultType extends ValidResponse, ErrorType extends InvalidResponse> { interface BasicAPICallT<
(args: ArgType): Promise<ResultType>; ArgType extends RawArgType,
(args: ArgType, returnError: false): Promise<ResultType>; ResultType extends ValidResponse,
(args: ArgType, returnError: true): Promise<ResultType | ErrorType>; ErrorType extends InvalidResponse
> {
(args: ArgType): Promise<ResultType>;
(args: ArgType, returnError: false): Promise<ResultType>;
(args: ArgType, returnError: true): Promise<ResultType | ErrorType>;
} }
interface EmptyAPICallT<ResultType extends ValidResponse, ErrorType extends InvalidResponse> { interface EmptyAPICallT<ResultType extends ValidResponse, ErrorType extends InvalidResponse> {
(): Promise<ResultType>; (): Promise<ResultType>;
(args: undefined): Promise<ResultType>; (args: undefined): Promise<ResultType>;
(args: undefined, returnError: false): Promise<ResultType>; (args: undefined, returnError: false): Promise<ResultType>;
(args: undefined, returnError: true): Promise<ResultType | ErrorType>; (args: undefined, returnError: true): Promise<ResultType | ErrorType>;
} }
// eslint-disable-next-line @typescript-eslint/no-explicit-any // eslint-disable-next-line @typescript-eslint/no-explicit-any
export type ArgTypeOf<T> = T extends APICallT<infer A, any, any> ? A : never; export type ArgTypeOf<T> = T extends APICallT<infer A, any, any> ? A : never;
export type APICallT< export type APICallT<
ArgType extends RawArgType, ArgType extends RawArgType,
ResultType extends ValidResponse = ValidResponse, ResultType extends ValidResponse = ValidResponse,
ErrorType extends InvalidResponse = InvalidResponse ErrorType extends InvalidResponse = InvalidResponse
> = ArgType extends undefined > = ArgType extends undefined ? EmptyAPICallT<ResultType, ErrorType> : BasicAPICallT<ArgType, ResultType, ErrorType>;
? EmptyAPICallT<ResultType, ErrorType>
: BasicAPICallT<ArgType, ResultType, ErrorType>;
type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'head' | 'delete'; type HttpMethod = "get" | "post" | "put" | "patch" | "head" | "delete";
export type APITail = typeof GET | typeof POST | typeof PUT | typeof PATCH | typeof HEAD | typeof DELETE; export type APITail = typeof GET | typeof POST | typeof PUT | typeof PATCH | typeof HEAD | typeof DELETE;
const httpMethodMap = new Map<APITail, HttpMethod>([ const httpMethodMap = new Map<APITail, HttpMethod>([
[GET, 'get'], [GET, "get"],
[POST, 'post'], [POST, "post"],
[PUT, 'put'], [PUT, "put"],
[PATCH, 'patch'], [PATCH, "patch"],
[HEAD, 'head'], [HEAD, "head"],
[DELETE, 'delete'], [DELETE, "delete"],
]); ]);
export function extractHttpMethod(tail: APITail): HttpMethod { export function extractHttpMethod(tail: APITail): HttpMethod {
return httpMethodMap.get(tail) ?? 'post'; return httpMethodMap.get(tail) ?? "post";
} }
const apiTarget = 'api.php'; const apiTarget = "api.php";
let apiPath = apiTarget; let apiPath = apiTarget;
export function setSammoAPIPrefix(prefix: string) { export function setSammoAPIPrefix(prefix: string) {
apiPath = `${prefix}/${apiTarget}`; apiPath = `${prefix}/${apiTarget}`;
} }
export async function callSammoAPI<ResultType extends ValidResponse>(method: HttpMethod, path: string | string[], args: RawArgType, paramArgs: Record<string, string | number> | undefined): Promise<ResultType>; export async function callSammoAPI<ResultType extends ValidResponse>(
export async function callSammoAPI<ResultType extends ValidResponse>(method: HttpMethod, path: string | string[], args: RawArgType, paramArgs: Record<string, string | number> | undefined, returnError: false): Promise<ResultType>; method: HttpMethod,
export async function callSammoAPI<ResultType extends ValidResponse, ErrorType extends InvalidResponse>(method: HttpMethod, path: string | string[], args: RawArgType, paramArgs: Record<string, string | number> | undefined, returnError: true): Promise<ResultType | ErrorType>; path: string | string[],
export async function callSammoAPI<ResultType extends ValidResponse, ErrorType extends InvalidResponse>(method: HttpMethod, path: string | string[], args: RawArgType, paramArgs: Record<string, string | number> | undefined, returnError = false): Promise<ResultType | ErrorType> { args: RawArgType,
if (isArray(path)) { paramArgs: Record<string, string | number> | undefined
path = path.join('/'); ): Promise<ResultType>;
export async function callSammoAPI<ResultType extends ValidResponse>(
method: HttpMethod,
path: string | string[],
args: RawArgType,
paramArgs: Record<string, string | number> | undefined,
returnError: false
): Promise<ResultType>;
export async function callSammoAPI<ResultType extends ValidResponse, ErrorType extends InvalidResponse>(
method: HttpMethod,
path: string | string[],
args: RawArgType,
paramArgs: Record<string, string | number> | undefined,
returnError: true
): Promise<ResultType | ErrorType>;
export async function callSammoAPI<ResultType extends ValidResponse, ErrorType extends InvalidResponse>(
method: HttpMethod,
path: string | string[],
args: RawArgType,
paramArgs: Record<string, string | number> | undefined,
returnError = false
): Promise<ResultType | ErrorType> {
if (isArray(path)) {
path = path.join("/");
}
if (args && isEmpty(args)) {
args = undefined;
}
const result = (await (() => {
if (method == "get") {
return ky(apiPath, {
searchParams: {
...paramArgs,
...(args as typeof paramArgs),
path,
},
method,
headers: {
"content-type": "application/json",
},
});
} }
return ky("api.php", {
searchParams: {
...paramArgs,
path,
},
method,
json: args,
headers: {
"content-type": "application/json",
},
});
})().json()) as ErrorType | ResultType;
if (args && isEmpty(args)) { if (!result.result) {
args = undefined; if (returnError) {
return result;
} }
throw result.reason;
const result = await (() => { }
if (method == 'get') { return result;
return ky(apiPath, {
searchParams: {
...paramArgs,
...(args as typeof paramArgs),
path,
},
method,
headers: {
'content-type': 'application/json'
}
});
}
return ky('api.php', {
searchParams: {
...paramArgs,
path,
},
method,
json: args,
headers: {
'content-type': 'application/json'
}
});
})().json() as ErrorType | ResultType;
if (!result.result) {
if (returnError) {
return result;
}
throw result.reason;
}
return result;
} }
export async function GET<ResultType extends ValidResponse, ArgType extends undefined = undefined>(args?: ArgType): Promise<ResultType>; export async function GET<ResultType extends ValidResponse, ArgType extends undefined = undefined>(
export async function GET<ResultType extends ValidResponse, ArgType extends undefined = undefined>(args: ArgType | undefined, returnError: false): Promise<ResultType>; args?: ArgType
export async function GET<ResultType extends ValidResponse, ErrorType extends InvalidResponse, ArgType extends undefined = undefined>(args: ArgType | undefined, returnError: true): Promise<ResultType | ErrorType>; ): Promise<ResultType>;
export async function GET<ResultType extends ValidResponse, ErrorType extends InvalidResponse, ArgType extends undefined = undefined>(args?: ArgType, returnError = false): Promise<ResultType | ErrorType> { export async function GET<ResultType extends ValidResponse, ArgType extends undefined = undefined>(
console.error(`Can't directly call GET. ${args}, ${returnError}. Use auto-generated path API.`); args: ArgType | undefined,
return callSammoAPI<ResultType, ErrorType>('get', [], args, undefined, true); returnError: false
): Promise<ResultType>;
export async function GET<
ResultType extends ValidResponse,
ErrorType extends InvalidResponse,
ArgType extends undefined = undefined
>(args: ArgType | undefined, returnError: true): Promise<ResultType | ErrorType>;
export async function GET<
ResultType extends ValidResponse,
ErrorType extends InvalidResponse,
ArgType extends undefined = undefined
>(args?: ArgType, returnError = false): Promise<ResultType | ErrorType> {
console.error(`Can't directly call GET. ${args}, ${returnError}. Use auto-generated path API.`);
return callSammoAPI<ResultType, ErrorType>("get", [], args, undefined, true);
} }
export async function POST<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(args?: ArgType): Promise<ResultType>; export async function POST<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(
export async function POST<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(args: ArgType | undefined, returnError: false): Promise<ResultType>; args?: ArgType
export async function POST<ResultType extends ValidResponse, ErrorType extends InvalidResponse, ArgType extends RawArgType = RawArgType>(args: ArgType | undefined, returnError: true): Promise<ResultType | ErrorType>; ): Promise<ResultType>;
export async function POST<ResultType extends ValidResponse, ErrorType extends InvalidResponse, ArgType extends RawArgType = RawArgType>(args?: ArgType, returnError = false): Promise<ResultType | ErrorType> { export async function POST<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(
console.error(`Can't directly call POST. ${args}, ${returnError}. Use auto-generated path API.`); args: ArgType | undefined,
return callSammoAPI<ResultType, ErrorType>('post', [], args, undefined, true); returnError: false
): Promise<ResultType>;
export async function POST<
ResultType extends ValidResponse,
ErrorType extends InvalidResponse,
ArgType extends RawArgType = RawArgType
>(args: ArgType | undefined, returnError: true): Promise<ResultType | ErrorType>;
export async function POST<
ResultType extends ValidResponse,
ErrorType extends InvalidResponse,
ArgType extends RawArgType = RawArgType
>(args?: ArgType, returnError = false): Promise<ResultType | ErrorType> {
console.error(`Can't directly call POST. ${args}, ${returnError}. Use auto-generated path API.`);
return callSammoAPI<ResultType, ErrorType>("post", [], args, undefined, true);
} }
export async function PUT<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(args?: ArgType): Promise<ResultType>; export async function PUT<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(
export async function PUT<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(args: ArgType | undefined, returnError: false): Promise<ResultType>; args?: ArgType
export async function PUT<ResultType extends ValidResponse, ErrorType extends InvalidResponse, ArgType extends RawArgType = RawArgType>(args: ArgType | undefined, returnError: true): Promise<ResultType | ErrorType>; ): Promise<ResultType>;
export async function PUT<ResultType extends ValidResponse, ErrorType extends InvalidResponse, ArgType extends RawArgType = RawArgType>(args?: ArgType, returnError = false): Promise<ResultType | ErrorType> { export async function PUT<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(
console.error(`Can't directly call PUT. ${args}, ${returnError}. Use auto-generated path API.`); args: ArgType | undefined,
return callSammoAPI<ResultType, ErrorType>('put', [], args, undefined, true); returnError: false
): Promise<ResultType>;
export async function PUT<
ResultType extends ValidResponse,
ErrorType extends InvalidResponse,
ArgType extends RawArgType = RawArgType
>(args: ArgType | undefined, returnError: true): Promise<ResultType | ErrorType>;
export async function PUT<
ResultType extends ValidResponse,
ErrorType extends InvalidResponse,
ArgType extends RawArgType = RawArgType
>(args?: ArgType, returnError = false): Promise<ResultType | ErrorType> {
console.error(`Can't directly call PUT. ${args}, ${returnError}. Use auto-generated path API.`);
return callSammoAPI<ResultType, ErrorType>("put", [], args, undefined, true);
} }
export async function PATCH<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(args?: ArgType): Promise<ResultType>; export async function PATCH<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(
export async function PATCH<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(args: ArgType | undefined, returnError: false): Promise<ResultType>; args?: ArgType
export async function PATCH<ResultType extends ValidResponse, ErrorType extends InvalidResponse, ArgType extends RawArgType = RawArgType>(args: ArgType | undefined, returnError: true): Promise<ResultType | ErrorType>; ): Promise<ResultType>;
export async function PATCH<ResultType extends ValidResponse, ErrorType extends InvalidResponse, ArgType extends RawArgType = RawArgType>(args?: ArgType, returnError = false): Promise<ResultType | ErrorType> { export async function PATCH<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(
console.error(`Can't directly call PATCH. ${args}, ${returnError}. Use auto-generated path API.`); args: ArgType | undefined,
return callSammoAPI<ResultType, ErrorType>('patch', [], args, undefined, true); returnError: false
): Promise<ResultType>;
export async function PATCH<
ResultType extends ValidResponse,
ErrorType extends InvalidResponse,
ArgType extends RawArgType = RawArgType
>(args: ArgType | undefined, returnError: true): Promise<ResultType | ErrorType>;
export async function PATCH<
ResultType extends ValidResponse,
ErrorType extends InvalidResponse,
ArgType extends RawArgType = RawArgType
>(args?: ArgType, returnError = false): Promise<ResultType | ErrorType> {
console.error(`Can't directly call PATCH. ${args}, ${returnError}. Use auto-generated path API.`);
return callSammoAPI<ResultType, ErrorType>("patch", [], args, undefined, true);
} }
export async function HEAD<ResultType extends ValidResponse, ArgType extends undefined = undefined>(args?: ArgType): Promise<ResultType>; export async function HEAD<ResultType extends ValidResponse, ArgType extends undefined = undefined>(
export async function HEAD<ResultType extends ValidResponse, ArgType extends undefined = undefined>(args: ArgType | undefined, returnError: false): Promise<ResultType>; args?: ArgType
export async function HEAD<ResultType extends ValidResponse, ErrorType extends InvalidResponse, ArgType extends undefined = undefined>(args: ArgType | undefined, returnError: true): Promise<ResultType | ErrorType>; ): Promise<ResultType>;
export async function HEAD<ResultType extends ValidResponse, ErrorType extends InvalidResponse, ArgType extends undefined = undefined>(args?: ArgType, returnError = false): Promise<ResultType | ErrorType> { export async function HEAD<ResultType extends ValidResponse, ArgType extends undefined = undefined>(
console.error(`Can't directly call HEAD. ${args}, ${returnError}. Use auto-generated path API.`); args: ArgType | undefined,
return callSammoAPI<ResultType, ErrorType>('head', [], args, undefined, true); returnError: false
): Promise<ResultType>;
export async function HEAD<
ResultType extends ValidResponse,
ErrorType extends InvalidResponse,
ArgType extends undefined = undefined
>(args: ArgType | undefined, returnError: true): Promise<ResultType | ErrorType>;
export async function HEAD<
ResultType extends ValidResponse,
ErrorType extends InvalidResponse,
ArgType extends undefined = undefined
>(args?: ArgType, returnError = false): Promise<ResultType | ErrorType> {
console.error(`Can't directly call HEAD. ${args}, ${returnError}. Use auto-generated path API.`);
return callSammoAPI<ResultType, ErrorType>("head", [], args, undefined, true);
} }
export async function DELETE<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(args?: ArgType): Promise<ResultType>; export async function DELETE<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(
export async function DELETE<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(args: ArgType | undefined, returnError: false): Promise<ResultType>; args?: ArgType
export async function DELETE<ResultType extends ValidResponse, ErrorType extends InvalidResponse, ArgType extends RawArgType = RawArgType>(args: ArgType | undefined, returnError: true): Promise<ResultType | ErrorType>; ): Promise<ResultType>;
export async function DELETE<ResultType extends ValidResponse, ErrorType extends InvalidResponse, ArgType extends RawArgType = RawArgType>(args?: ArgType, returnError = false): Promise<ResultType | ErrorType> { export async function DELETE<ResultType extends ValidResponse, ArgType extends RawArgType = RawArgType>(
console.error(`Can't directly call DELETE. ${args}, ${returnError}. Use auto-generated path API.`); args: ArgType | undefined,
return callSammoAPI<ResultType, ErrorType>('patch', [], args, undefined, true); returnError: false
} ): Promise<ResultType>;
export async function DELETE<
ResultType extends ValidResponse,
ErrorType extends InvalidResponse,
ArgType extends RawArgType = RawArgType
>(args: ArgType | undefined, returnError: true): Promise<ResultType | ErrorType>;
export async function DELETE<
ResultType extends ValidResponse,
ErrorType extends InvalidResponse,
ArgType extends RawArgType = RawArgType
>(args?: ArgType, returnError = false): Promise<ResultType | ErrorType> {
console.error(`Can't directly call DELETE. ${args}, ${returnError}. Use auto-generated path API.`);
return callSammoAPI<ResultType, ErrorType>("patch", [], args, undefined, true);
}