core_ng/server/api/clientAPI.ts

import ky from 'ky';
import type { APIExecuter, APINamespace, HttpMethod, InvalidResponse, RawArgType, ValidResponse } from './base.js';
import isArray from 'lodash-es/isArray.js';
import isEmpty from 'lodash-es/isEmpty.js';

const apiPath = process.env.API_ROOT_PATH ?? process.env.VITE_API_ROOT_PATH ?? '/api';

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>(
    args: ArgType | undefined,
    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 callClientAPI<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>(
    args: ArgType | undefined,
    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 callClientAPI<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>(
    args: ArgType | undefined,
    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 callClientAPI<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>(
    args: ArgType | undefined,
    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 callClientAPI<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>(
    args: ArgType | undefined,
    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 callClientAPI<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>(
    args: ArgType | undefined,
    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 callClientAPI<ResultType, ErrorType>("patch", [], args, undefined, true);
}


export async function callClientAPI<ResultType extends ValidResponse>(
    method: HttpMethod,
    path: string | string[],
    args: RawArgType,
    paramArgs: Record<string, string | number> | undefined
): Promise<ResultType>;
export async function callClientAPI<ResultType extends ValidResponse>(
    method: HttpMethod,
    path: string | string[],
    args: RawArgType,
    paramArgs: Record<string, string | number> | undefined,
    returnError: false
): Promise<ResultType>;
export async function callClientAPI<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 callClientAPI<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",
                },
                timeout: 30000,
                retry: 0,
            });
        }
        return ky(apiPath, {
            searchParams: {
                ...paramArgs,
                path,
            },
            method,
            json: args,
            headers: {
                "content-type": "application/json",
            },
            timeout: 30000,
            retry: 0,
        });
    })().json()) as ErrorType | ResultType;

    if (!result.result) {
        if (returnError) {
            return result;
        }
        throw result.reason;
    }
    return result;
}

//TODO: type이 하나 만들어져야 함. 이것은 typescript의 type system으로.
//TODO: const로 실제 구조가 하나 더 만들어 져야 함. 이것은 위의 type을 satisfy하여야 함.