jordy 0.12.0

package/libs/adaptive-render/adaptive-render.type.d.ts

@@ -0,0 +1,63 @@
+import { FC, ComponentType } from 'react';
+/**
+ * 적응형 함수 설정 시 필요한 모델.
+ */
+export interface AdaptiveSettingModel<T> {
+    /**
+     * 네이티브 모바일앱 에서만 수행될 기능.
+     *
+     * 다른 조건들 대비 우선순위가 가장 높다.
+     *
+     * 미설정 시 앱에서 수행되지 않는다.
+     */
+    native?: T;
+    /**
+     * 모바일 에서만 수행될 기능.
+     *
+     * 미설정 시 모바일에서 수행되지 않는다.
+     */
+    mobile?: T;
+    /**
+     * 태블릿에서만 수행될 기능.
+     *
+     * 미설정 시 태블릿에서 수행되지 않는다.
+     */
+    tablet?: T;
+    /**
+     * 데스크탑에서만 수행될 기능.
+     *
+     * 미설정  desktop 에서 수행되지 않는다.
+     */
+    desktop?: T;
+}
+/**
+ * 적응형 렌더링에서 쓰이는 설정 모델.
+ */
+export interface AdaptiveRenderSettingModel<T> extends AdaptiveSettingModel<FC<T> | ComponentType<T>> {
+    /**
+     * 네이티브 모바일앱 에서만 보여질 컴포넌트.
+     *
+     * 다른 조건들 대비 우선순위가 가장 높다.
+     *
+     * 미설정 시 앱에서 보여지지 않는다.
+     */
+    native?: FC<T> | ComponentType<T>;
+    /**
+     * 모바일 에서만 보여질 컴포넌트.
+     *
+     * 미설정 시 모바일에서 보여지지 않는다.
+     */
+    mobile?: FC<T> | ComponentType<T>;
+    /**
+     * 태블릿에서만 보여질 컴포넌트.
+     *
+     * 미설정 시 태블릿에서 보여지지 않는다.
+     */
+    tablet?: FC<T> | ComponentType<T>;
+    /**
+     * 데스크탑에서만 보여질 컴포넌트.
+     *
+     * 미설정  desktop 에서 보여지지 않는다.
+     */
+    desktop?: FC<T> | ComponentType<T>;
+}

package/libs/adaptive-render/device.type.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 기기별 사이즈를 정의한 것.
+ *
+ * 사이즈 참고:
+ * https://stackoverflow.com/questions/6370690/media-queries-how-to-target-desktop-tablet-and-mobile
+ */
+export declare enum DeviceSizeEnum {
+    MOBILE_SM = 320,
+    MOBILE = 481,
+    TABLET_SM = 768,
+    TABLET = 961,
+    DESKTOP_SM = 1025,
+    DESKTOP = 1120
+}

package/libs/adaptive-render/index.d.ts

@@ -0,0 +1,4 @@
+export * from './AdaptiveRender';
+export * from './DeviceDetectContext';
+export * from './adaptive-render.type';
+export * from './withAdaptiveRender';

package/libs/adaptive-render/withAdaptiveRender.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+import { AdaptiveRenderSettingModel } from './adaptive-render.type';
+/**
+ * @description
+ * HOC: 적응형 컴포넌트를 만든다.
+ *
+ * desktop, tablet 및 mobile 에 맞는 컴포넌트를 인수로 넘겨주면 된다.
+ *
+ * 각각의 세가지 컴포넌트는 반드시 Props 를 공통으로 사용해야 한다.
+ *
+ * 그리고 사용 시 반드시 각 컴포넌트가 공통으로 사용하는 Props 타입을 제네릭 선언 해 주어야 한다.
+ *
+ * 한편, 각 대응되는 device 별 인수를 넣지 않을 경우 그 device 환경이 되면 컴포넌트 렌더링을 하지 않는다.
+ *
+ * @example
+ * interface InputProps {
+ *   name: string;
+ *   value: string;
+ * }
+ *
+ * // tablet 이 빠져 있으므로 tablet 환경에서는 렌더링 하지 않는다.
+ * // 사용 시 반드시 각 컴포넌트가 공통으로 사용하는 Props 타입을 제네릭 선언 해 주어야 한다.
+ * const AdaptiveInput = hocAdaptiveRender<InputProps>({
+ *   desktop: InputDesktop,
+ *   mobile: InputMobile,
+ * });
+ *
+ * // 사용 예
+ * export const Test: FC = () => (
+ *  <AdaptiveInput name="title" value="nani?" />
+ * );
+ *
+ * @param settings 적응형으로 설정할 컴포넌트들.
+ */
+export declare function withAdaptiveRender<T>(settings: AdaptiveRenderSettingModel<T>): React.FC<T>;

package/libs/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export * from './useDebounce';
+export * from './useQueryParams';
+export * from './useThrottle';

package/libs/hooks/useDebounce.d.ts

@@ -0,0 +1,29 @@
+interface DebounceHooksResult<T> {
+    (args: T): void;
+    stop(): void;
+}
+/**
+ * 훅: 디바운스를 적용 한다.
+ *
+ * 적용 시 별도로 함수가 반환되며, 이 함수는 특정시간이 지날 때 까지 재 호출이 없다면 비로소 인수로 주어진 내부 함수를 수행한다.
+ *
+ * 참고:
+ * https://medium.com/@feanar/debounce%EB%9E%80-%EB%AD%98%EA%B9%8C%EC%9A%94-82204c8b953f
+ *
+ * @example
+ * const Example: FC = () => {
+ *   const handler = (e: KeyboardEvent) => console.log(e.target.value);
+ *   // 300 미리초가 지날 때 까지 추가적인 입력이 없으면 콘솔에 출력한다.
+ *   const handleChange = useDebounce(handler, 300);
+ *
+ *   return (
+ *     <input onChange={handleChange} />
+ *   );
+ * };
+ *
+ * @param fn 디바운스를 적용 시킬 함수.
+ * @param time 시간 조건(ms). 기본 300.
+ * @param deps 생성되는 함수가 변경되어야 할 조건들 (dependencies)
+ */
+export declare function useDebounce<T = any>(fn: (args: T) => void, time?: number, deps?: any[]): DebounceHooksResult<T>;
+export {};

package/libs/hooks/useQueryParams.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 훅: 웹브라우저의 URL 파라미터 및 쿼리 파라미터를 합쳐서 하나의 객체로 만들어준다.
+ *
+ * 주의1: 쿼리 및 URL 파라미터의 key name 이 중복되지 않는 조건에서 사용해야한다.
+ *
+ * @see useParams
+ * @see qs.parse
+ */
+export declare function useQueryParams<T = unknown>(): T;
+/**
+ * 훅: 웹브라우저의 URL 파라미터 및 쿼리 파라미터를 합쳐서 하나의 객체로 만들어준다.
+ *
+ * 주의1: 쿼리 및 URL 파라미터의 key name 이 중복되지 않는 조건에서 사용해야한다.
+ *
+ * @param selector 변환된 쿼리 파라미터 객체를 원하는 타입으로 직접 변환하는 셀렉터.
+ * @see useParams
+ * @see qs.parse
+ */
+export declare function useQueryParams<T>(selector: (params: Record<string, string>) => T): T;

package/libs/hooks/useThrottle.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 훅: 쓰로틀을 적용한다.
+ *
+ * 적용 시 별도로 함수가 반환되며, 이 함수는 처음 수행 후 지정된 시간이 지날 때 까지 재호출이 되어도 다시 수행되지 않는다.
+ *
+ * 이 후 지정된 시간이 지나면 비로소 인수로 주어진 내부 콜백 함수를 수행한다.
+ *
+ * @example
+ * const Example: FC = () => {
+ *   const handler = (e: MouseEvent) => console.log('클릭이요!');
+ *   // 첫 클릭 이후로 버튼을 연타 하면 300 미리초가 지날 때만 한번씩 콘솔에 출력된다.
+ *   const handleClick = useThrottle(handler, 300);
+ *
+ *   return (
+ *     <button type="button" onClick={handleClick}>
+ *       0.3초마다 콘솔 찍히는 버튼!!
+ *     </button>
+ *   );
+ * };
+ *
+ * @param fn 쓰로틀을 적용시킬 함수.
+ * @param time 시간 조건(ms). 기본 300.
+ * @param deps 생성되는 함수가 변경되어야 할 조건들 (dependencies)
+ */
+export declare function useThrottle<T = any>(fn: (args: T) => void, time?: number, deps?: any[]): (args: T) => void;

package/libs/http-api/httpApi.factory.d.ts

@@ -0,0 +1,9 @@
+import { AxiosError } from 'axios';
+import { HttpApi, HttpApiErrorParser } from './network.type';
+/**
+ * Backend 에서 API를 호출하는 서비스를 생성한다.
+ * @param baseUrl 현재 서비스에서 API 호출 시 필요한 도메인 및 하위 경로를 정의 한다.
+ * @param headerProvider 헤더 제공자를 주입한다.
+ * @param withCredentials cross-domain 의 cookie 값을 가져올지의 여부 설정. 기본 true.
+ */
+export declare const createHttpApi: (baseUrl: string, parserVisitor: HttpApiErrorParser<AxiosError>, headerProvider?: () => Record<string, string>, withCredentials?: boolean, paramsSerializer?: (params: any) => string) => HttpApi;

package/libs/http-api/httpHeader.factory.d.ts

@@ -0,0 +1,15 @@
+import { TokenProvider } from '../storage';
+export declare const headerPipe: {
+    acceptContentType: (headerData: Record<string, string>) => Record<string, string>;
+    contentTypeFormPost: (headerData: Record<string, string>) => Record<string, string>;
+    contentTypeFormMultipart: (headerData: Record<string, string>) => Record<string, string>;
+    contentTypeJson: (headerData: Record<string, string>) => Record<string, string>;
+    bearerToken: (headerData: Record<string, string>, token?: string) => Record<string, string>;
+};
+/**
+ * HTTP 헤더를 제공한다.
+ * tokenProvider 설정 후 pipe 로 필요한 헤더 요소를 함수로 구성하여
+ * 다양한 HTTP 헤더를 만들 수 있다.
+ * @param tokenProvider 토큰을 보관하는 제공자.
+ */
+export declare const createHttpHeaderProvider: (tokenProvider?: TokenProvider) => (...pipes: ((defHeader: Record<string, string>, token?: string) => Record<string, string>)[]) => Record<string, string>;

package/libs/http-api/index.d.ts

@@ -0,0 +1,3 @@
+export * from './httpApi.factory';
+export * from './httpHeader.factory';
+export * from './network.type';

package/libs/http-api/network.type.d.ts

@@ -0,0 +1,109 @@
+import { MarshallingType } from '../types';
+/**
+ * 업로드 상태를 확인할 수 있는 객체.
+ */
+export interface UploadStateArgs {
+    /**
+     * 진행도. 0~100 까지의 수치.
+     */
+    progress: number;
+    /**
+     * 업로드된 바이트수.
+     */
+    loaded: number;
+    /**
+     * 업로드 해야 할 총 바이트수.
+     */
+    total: number;
+    /**
+     * 완료여부.
+     */
+    completed: boolean;
+}
+/**
+ * Axios 에서 업로드 상태 전달 콜백에 인자로 들어오는 이벤트 객체.
+ */
+export interface XhrUploadStateArgs {
+    /**
+     * 업로드 된 바이트 수
+     */
+    loaded: number;
+    /**
+     * 업로드 되어야 할 전체 바이트 수
+     */
+    total: number;
+}
+export interface HttpApiErrorParser<T, E extends Error = Error> {
+    parse(libErrObj: T): E;
+    throwOther<E extends Error>(err: E): never;
+    interrupt: <E extends Error>(error: E) => Promise<void>;
+}
+/**
+ * HTTP 프로토콜을 이용하여 비동기 통신을 수행한다.
+ */
+export interface HttpApi {
+    /**
+     * GET 메서드 호출
+     * @param url 호출 경로
+     * @param params 전달할 파라미터
+     * @param timeout 응답 제한시간 설정. 설정한 시간이 넘도록 응답이 없다면 중단하고 throw 를 일으킨다.
+     */
+    get<T = MarshallingType, P = Record<string, any> | void>(url: string, params?: P, timeout?: number): Promise<T>;
+    /**
+     * POST 메서드 호출
+     * @param url 호출 경로. 만약 쿼리 파라미터가 포함된다면 이 곳에 추가적으로 명시 해 주어야 한다.
+     * @param body 요청으로 보낼 데이터. json 으로 바꿔서 보내게 된다.
+     * @param timeout 응답 제한시간 설정. 설정한 시간이 넘도록 응답이 없다면 중단하고 throw 를 일으킨다.
+     */
+    post<T = MarshallingType, P = Record<string, any> | void>(url: string, body?: P, timeout?: number): Promise<T>;
+    /**
+     * PUT 메서드 호출
+     * @param url 호출 경로. 만약 쿼리 파라미터가 포함된다면 이 곳에 추가적으로 명시 해 주어야 한다.
+     * @param body 요청으로 보낼 데이터. json 으로 바꿔서 보내게 된다.
+     * @param timeout 응답 제한시간 설정. 설정한 시간이 넘도록 응답이 없다면 중단하고 throw 를 일으킨다.
+     */
+    put<T = MarshallingType, P = Record<string, any> | void>(url: string, body?: P, timeout?: number): Promise<T>;
+    /**
+     * PATCH 메서드 호출
+     * @param url 호출 경로. 만약 쿼리 파라미터가 포함된다면 이 곳에 추가적으로 명시 해 주어야 한다.
+     * @param body 요청으로 보낼 데이터. json 으로 바꿔서 보내게 된다.
+     * @param timeout 응답 제한시간 설정. 설정한 시간이 넘도록 응답이 없다면 중단하고 throw 를 일으킨다.
+     */
+    patch<T = MarshallingType, P = Record<string, any> | void>(url: string, body?: P, timeout?: number): Promise<T>;
+    /**
+     * DELETE 메서드 호출
+     * @param url 호출 경로
+     * @param params 전달할 파라미터
+     * @param timeout 응답 제한시간 설정. 설정한 시간이 넘도록 응답이 없다면 중단하고 throw 를 일으킨다.
+     */
+    delete<T = MarshallingType, P = Record<string, any> | void>(url: string, params?: P, timeout?: number): Promise<T>;
+    /**
+     * POST 메서드로 업로드 한다.
+     * @param url 업로드 경로
+     * @param data 업로드에 쓰이는 데이터
+     * @param progCallback 업로드 상황을 보내주는 콜백
+     * @param timeout 응답 제한시간 설정. 설정한 시간이 넘도록 응답이 없다면 중단하고 throw 를 일으킨다.
+     */
+    postUpload<T = void, P extends Record<string, any> = Record<string, string | File | File[]>>(url: string, data: P, progCallback?: (args: UploadStateArgs) => void, timeout?: number): Promise<T>;
+    /**
+     * PUT 메서드로 업로드 한다.
+     * @param url 업로드 경로
+     * @param data 업로드에 쓰이는 데이터
+     * @param progCallback 업로드 상황을 보내주는 콜백
+     * @param timeout 응답 제한시간 설정. 설정한 시간이 넘도록 응답이 없다면 중단하고 throw 를 일으킨다.
+     */
+    putUpload<T = void, P extends Record<string, any> = Record<string, string | File | File[]>>(url: string, data: P, progCallback?: (args: UploadStateArgs) => void, timeout?: number): Promise<T>;
+    /**
+     * GET 메서드로 파일을 비동기로 가져온다.
+     * @param url 파일을 가져올 경로
+     * @param params 전달할 파라미터
+     * @param filename 파일이 받아졌을 때 쓰여질 파일명.
+     */
+    getFile<P = Record<string, any> | void>(url: string, params?: P, filename?: string): Promise<File>;
+    /**
+     * GET 메서드로 blob을 비동기로 가져온다.
+     * @param url blob을 가져올 경로
+     * @param params 전달할 파라미터
+     */
+    getBlob<P = Record<string, any> | void>(url: string, params?: P): Promise<Blob>;
+}

package/libs/http-api/networkParser.d.ts

@@ -0,0 +1,9 @@
+import { AxiosError, AxiosResponse, Method } from 'axios';
+import { HttpApiErrorParser, UploadStateArgs } from './network.type';
+export declare const axiosResponseToData: <T>(axiosRes: AxiosResponse<T>) => T;
+export declare function axiosCreateHeader(headerProvider: () => Record<string, string>): {
+    common: Record<string, string>;
+};
+export declare const throwNewErrorForLib: <T>(parserVisitor: HttpApiErrorParser<T, Error>) => (anyError: any) => never;
+export declare const axiosUploadCommon: (baseUrl: string, parserVisitor: HttpApiErrorParser<AxiosError>, headerProvider: () => Record<string, string>, withCredentials?: boolean) => <T>(method: Method, url: string, data: FormData, progCallback?: (args: UploadStateArgs) => void, timeout?: number) => Promise<T>;
+export declare function convertToFormData(data: Record<string, string | File | File[]>): FormData;

package/libs/index.d.ts

@@ -0,0 +1,11 @@
+import { DeviceDetectProvider, withAdaptiveRender } from './adaptive-render';
+import { createHttpApi, createHttpHeaderProvider, headerPipe, HttpApi, HttpApiErrorParser, UploadStateArgs, XhrUploadStateArgs } from './http-api';
+import { cache } from './proxies';
+import { createGuardDispatch, createGuardSelector, ModuleRouteModel, renderRouteSystem } from './route-system';
+import validate, { mergeValidates, ValidateResultModel, ValidateBulkResultModel, ValidateCheckModel, ValidateBulkOptionType } from './validate';
+export * from './queries';
+export * from './storage';
+export * from './hooks';
+export * from './util';
+export * from './types';
+export { UploadStateArgs, XhrUploadStateArgs, HttpApiErrorParser, HttpApi, ModuleRouteModel, DeviceDetectProvider, withAdaptiveRender, createHttpApi, headerPipe, createHttpHeaderProvider, cache, renderRouteSystem, createGuardDispatch, createGuardSelector, validate, mergeValidates, ValidateResultModel, ValidateBulkResultModel, ValidateCheckModel, ValidateBulkOptionType, };

package/libs/proxies/cache.proxy.d.ts

@@ -0,0 +1,11 @@
+import { HttpApi } from '../http-api';
+declare type CacheProxy = (baseApi: HttpApi) => <T extends string | string[] | Record<string, any>, P = void | Record<string, any>>(url: string, params?: P) => Promise<T>;
+declare type CacheType = 'local' | 'session' | 'memory';
+/**
+ * 스토리지를 이용한 API 캐시를 적용한다.
+ *
+ * @param type local, session, memory 셋 중 하나. 기본 local.
+ * @param expiredTime 캐시가 만료되는 시간(seconds). 0 이하면 무제한. 기본 0.
+ */
+export declare function cache(type?: CacheType, expiredTime?: number): CacheProxy;
+export {};

package/libs/proxies/index.d.ts

@@ -0,0 +1 @@
+export * from './cache.proxy';

package/libs/queries/buildMutationCreator.d.ts

@@ -0,0 +1,37 @@
+import { EnhancedStore } from '@reduxjs/toolkit';
+interface MutationHooksCreatorSettingOptionDto<SR, SP, R, P, ReduxRootState> {
+    /**
+     * Mutation hooks의 고유키이다. auto dispatch 사용 시 반드시 필요하다.
+     *
+     * ### auto dispatch
+     * 매 요청마다 redux store의 dispatch를 수행한다. (devTool에 로그가 출력된다.)
+     */
+    key?: string;
+    /**
+     * 데이터 mutaion를 위한 함수
+     */
+    mutator: ((params: SP) => Promise<SR>) | ((params?: SP) => Promise<SR>);
+    /**
+     * 파라미터 변환기.
+     *
+     * UI Model로 전달된 파라미터를 Server측 파라미터로 변환한다.
+     */
+    parameterConverter?: (params: P, getState: () => ReduxRootState) => SP;
+    /**
+     * 받아온 결과 데이터에 대한 변환기.
+     *
+     * Server측 Entity와 response를 UI Model로 변환한다.
+     */
+    resultConverter?: (result: SR, getState: () => ReduxRootState) => R;
+}
+interface MutationResultType<R = void, P = void, E extends Error = Error> {
+    data: R | null;
+    error?: E;
+    loading: boolean;
+    mutate: (params?: P, throwable?: boolean) => Promise<boolean>;
+}
+interface MutationHooks<R = void, P = void, E extends Error = Error> {
+    (params?: R): MutationResultType<R, P, E>;
+}
+export declare function buildMutationCreator<S>(store: EnhancedStore<S>): <SR, SP, R, P, E extends Error>({ key, mutator, parameterConverter, resultConverter, }: MutationHooksCreatorSettingOptionDto<SR, SP, R, P, S>) => MutationHooks<R, P, E>;
+export {};

package/libs/queries/buildQueryCreator.d.ts

@@ -0,0 +1,115 @@
+import { EnhancedStore } from '@reduxjs/toolkit';
+import { StorageType } from '../storage';
+/**
+ * query hooks가 리턴하는 객체
+ */
+interface QueryHandler<R, P = void, E extends Error = Error> {
+    /**
+     * 응답(response) 받은 자료가 담겨있다.
+     *
+     * 원격에서 자료를 받아오기 전까지는 설정된 기본 자료가 담겨있다.
+     */
+    data: R;
+    /**
+     * 오류 내용
+     */
+    error?: E;
+    /**
+     * 응답을 받아오는 중인지 여부
+     */
+    loading: boolean;
+    /**
+     * 응답을 위한 요청 수행 함수
+     */
+    load: (params?: P) => Promise<void>;
+    /**
+     * 현재 쿼리에 담긴 데이터를 초기화하고 기본 자료를 담는다.
+     *
+     * @param removeCache true (기본) = 캐시와 내부 상태 모두 초기화, false = 내부 상태만 초기화
+     */
+    clear: (removeCache?: boolean) => void;
+}
+interface QueryHooksCreatorSettingOptionDto<SR, SP, R, P, ReduxRootState> {
+    /**
+     * 쿼리 훅스 고유키. 캐시나 auto dispatch 사용 시 반드시 필요하다.
+     *
+     * ### auto dispatch
+     * 매 요청 마다 redux store 의 dispatch 를 수행한다. (redux dev tool 에 해당 로그가 출력됨)
+     */
+    key?: string;
+    /**
+     * 캐시할 때 쓰일 서브키들을 설정한다.
+     *
+     * 들어오는 파라미터 객체에서 지정된 키만을 이용하여 캐시키를 만든다.
+     *
+     * **미 설정 시 기본 동작**: 들어오는 파라미터 객체의 _모든 키들을 대상_ 으로 동작된다.
+     *
+     * #### 해당 옵션이 무시되는 경우
+     * - cache 옵션이 'false` 라면 무시된다.
+     * - 들어오는 파라미터가 객체가 아니거나 비어있다면 해당 설정은 무시된다.
+     */
+    subKeysFromParams?: Array<keyof P>;
+    /**
+     * 캐시 종류 선택.
+     *
+     * key 옵션 설정 시 기본값이 자동으로 설정된다.
+     *
+     * false 를 주면 캐시를 사용하지 않는다.
+     *
+     * @default 'session'
+     */
+    cache?: StorageType | false;
+    /**
+     * 캐시 유효기간 설정. (seconds)
+     *
+     * 0 혹은 설정하지 않으면 기한이 없다.
+     *
+     * @default 0
+     */
+    expired?: number;
+    /**
+     * 게으른 수행(lazy fetch) 여부.
+     *
+     * true 로 설정 시 별도로 load 를 수행하지 않으면 데이터를 가져오지 않는다.
+     *
+     * @default false
+     */
+    lazy?: boolean;
+    /**
+     * 쿼리 훅스 수행과 동시에 곧바로 로딩으로 둘지의 여부.
+     *
+     * @default true
+     */
+    defaultLoading?: boolean;
+    /**
+     * 데이터 가져오기를 실제 수행 할 함수.
+     */
+    fetcher: ((params: SP) => Promise<SR>) | (() => Promise<SR>);
+    /**
+     * 적용할 기본자료.
+     *
+     * fetcher 가 자료를 가져오기 전 까지 기본적으로 제공 할 자료로 쓰인다.
+     */
+    defaultData: R | (() => R);
+    /**
+     * 파라미터 변환기.
+     *
+     * UI Model 로 전달된 파라미터를 Server 측 파라미터로 변환한다.
+     */
+    parameterConverter?: (params: P, getState: () => ReduxRootState) => SP;
+    /**
+     * 받아온 결과 데이터에 대한 변환기.
+     *
+     * Server 측 Entity 와 응답 자료를 UI Model 로 변환한다.
+     */
+    resultConverter?: (result: SR, getState: () => ReduxRootState, params: P) => R;
+}
+interface QueryHooks<R, P = void, E extends Error = Error> {
+    (params?: P): QueryHandler<R, P, E>;
+}
+interface CreateRepositoryQuery<S> {
+    <SR, SP, R, P, E extends Error = Error>(config: QueryHooksCreatorSettingOptionDto<SR, SP, R, P, S>): QueryHooks<R, P, E>;
+    <R, P, E extends Error = Error>(config: QueryHooksCreatorSettingOptionDto<R, P, R, P, S>): QueryHooks<R, P, E>;
+}
+export declare function buildQueryCreator<S>(store: EnhancedStore<S>): CreateRepositoryQuery<S>;
+export {};

package/libs/queries/index.d.ts

@@ -0,0 +1,2 @@
+export * from './buildMutationCreator';
+export * from './buildQueryCreator';

package/libs/queries/useMakeDeps.d.ts

@@ -0,0 +1 @@
+export declare function useMakeDeps<T>(args?: T, keys?: string[] | (keyof T)[]): any[];

package/libs/queries/utils/clearCacheByKeyword.d.ts

@@ -0,0 +1,14 @@
+import { StorageKeyManager, StorageType } from '../../storage';
+declare type LargeStorageType = Exclude<StorageType, 'cookie'>;
+declare function getStorage(type: LargeStorageType): StorageKeyManager;
+/**
+ * 캐시를 제거한다.
+ *
+ * 제공되는 cache 디코레이터로 만들어진 캐시들을 제거하는데 쓰인다.
+ *
+ * @param type 캐시 타입 (쿠키 제외)
+ * @param keyword 삭제 대상이 되는 키워드
+ * @returns
+ */
+export declare function clearCacheByKeyword(type: LargeStorageType, keyword: string | string[], storageGetter?: typeof getStorage): number;
+export {};

package/libs/queries/utils/createCacheKey.d.ts

@@ -0,0 +1 @@
+export declare function createCacheKey<P>(key: string, params?: P, subKeys?: Array<keyof P>): string;

package/libs/queries/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './clearCacheByKeyword';
+export * from './createCacheKey';

package/libs/route-system/AsyncGuard.d.ts

@@ -0,0 +1,8 @@
+import { ComponentType, FC } from 'react';
+interface AsyncGuardProps {
+    redirect?: string;
+    failComponent?: ComponentType<any>;
+    guard?: () => boolean | Promise<boolean>;
+}
+export declare const AsyncGuard: FC<AsyncGuardProps>;
+export {};

package/libs/route-system/index.d.ts

@@ -0,0 +1,3 @@
+export * from './renderRouteSystem';
+export * from './moduleRoute.model';
+export * from './routeSystem.util';

package/libs/route-system/moduleRoute.model.d.ts

@@ -0,0 +1,49 @@
+import { ComponentType } from 'react';
+/**
+ * 모듈에서 쓰이는 각종 페이지 컴포넌트의 라우팅 정보를 담은 객체
+ */
+export interface ModuleRouteModel {
+    /**
+     * 수행 경로
+     */
+    path: string;
+    /**
+     * 정확성 여부. 지정된 path 가 정확히 맞아야만 컴포넌트가 렌더링 된다.
+     */
+    exact?: boolean;
+    /**
+     * 현재 경로로 왔을 때 곧바로 이동될 다른 경로.
+     *
+     * 만약 guard 옵션에 설정이 되어있고 그 결과가 true 가 아니라면 설정된 주소를 사용하여 이동될 것이다.
+     */
+    redirect?: string;
+    /**
+     * 해당 페이지에 접근 시 별도 권한이 필요하다면 쓰이는 기능.
+     *
+     * 동기 혹은 비동기로 true 가 되면 페이지 렌더링이 된다.
+     *
+     * 만약 설정 되었음에도 true 가 안된다면,
+     * 1. failComponent 에 설정된 컴포넌트를 렌더링 한다.
+     * 2. failComponent 가 설정 안되어 있다면, redirect 에 설정된 주소로 이동된다.
+     * 3. 아무것도 설정되어 있지 않다면 루트(/) 경로로 이동한다.
+     *
+     * 설정하지 않을 경우 무조건 렌더링 한다.
+     */
+    guard?: () => boolean | Promise<boolean>;
+    /**
+     * 설정된 페이지 컴포넌트를 감싸서 함께 렌더링될 상위 컴포넌트
+     */
+    wrap?: ComponentType<any>;
+    /**
+     * 렌더링에 사용될 페이지 컴포넌트.
+     */
+    component?: ComponentType<any>;
+    /**
+     * guard 설정 결과가 false 일 때 렌더링 될 컴포넌트.
+     */
+    failComponent?: ComponentType<any>;
+    /**
+     * 하위 라우팅 설정
+     */
+    child?: ModuleRouteModel[];
+}

package/libs/route-system/renderRouteSystem.d.ts

@@ -0,0 +1,5 @@
+import { ComponentType } from 'react';
+import { ModuleRouteModel } from './moduleRoute.model';
+declare type GuardFunctionType = () => boolean | Promise<boolean>;
+export declare const renderRouteSystem: (routes: ModuleRouteModel[], withSwitch?: boolean, notFound?: ComponentType<any>, guardList?: GuardFunctionType[]) => JSX.Element | JSX.Element[];
+export {};

package/libs/route-system/routeSystem.util.d.ts

@@ -0,0 +1,4 @@
+import { EnhancedStore, AsyncThunkAction } from '@reduxjs/toolkit';
+import { CombinedState } from 'redux';
+export declare function createGuardDispatch<T>(store: EnhancedStore<CombinedState<T>>): <R>(effectResult: AsyncThunkAction<R, any, any>) => Promise<boolean>;
+export declare function createGuardSelector<T>(store: EnhancedStore<CombinedState<T>>): <R>(selector: (state: CombinedState<T>) => R) => R;

package/libs/storage/CookieStorageAdapter.d.ts

@@ -0,0 +1,11 @@
+import { CookieService, SimpleStorage } from './storage.type';
+import { MarshallingType } from '../types';
+export declare class CookieStorageAdapter<T extends MarshallingType> implements SimpleStorage<T> {
+    private cookie;
+    readonly key: string;
+    expiredTime: number;
+    constructor(cookie: CookieService, key: string, expiredTime?: number);
+    get(): T | null;
+    set(value: T): void;
+    remove(): void;
+}