sales-frontend-api 0.0.19 → 0.0.21

package/dist/server.d.cts

@@ -1,6 +1,5 @@
-import { H as HttpClientAxios, C as CustomError, c as customConfig, E as ErrorHandler, e as errorHandler, A as AbstractHttpClient } from './error-handler-DCenPKx5.cjs';
-import { customConfigFetch, interceptors, customResponse, fulfilled, rejected } from './common.cjs';
-import 'axios';
+import { a as GetterAsync, b as SetterAsync } from './header.types-duHbFvO0.cjs';
+export { A as AT, G as GetterSync, S as SetterSync, c as customHeaderNames } from './header.types-duHbFvO0.cjs';
 
 declare class AuthServer {
     /**
@@ -18,92 +17,141 @@ declare class AuthServer {
     refreshToken(): Promise<string>;
 }
 
-declare class SsrHttpClientAxios extends HttpClientAxios<CustomError> {
-    static query: string;
-    private ssrErrorHandler;
-    constructor(config?: customConfig);
-    setSsrErrorHandler(ssrErrorHandler: ErrorHandler): void;
+/**
+ * 서버사이드용 쿠키함수
+ */
+declare const cookieServer: {
+    getCookie(name: string): Promise<string>;
+    setCookie(name: string, value: string, options?: any): Promise<void>;
+    deleteCookie(name: string): Promise<void>;
+};
+
+declare class HeaderManagerAsync {
+    private getter;
+    private setter;
+    constructor(getter: GetterAsync, setter: SetterAsync);
     /**
-     * API 연동 실패시, 에러핸들러 셋팅 (특정페이지에서만 동작하는 개별 핸들러)
-     * @param handler ssrErrorHandler
+     * 커스텀 헤더를 비동기적으로 설정합니다.
      */
-    setLocalErrorHandler(handler: errorHandler, global?: boolean): void;
-}
-
-declare class FetchInstance {
+    setCustomHeaders(): Promise<void>;
     /**
-     * fetch 인스턴스 생성시 기본설정값 및 기타 필요한 정보들을 추가 가능
+     * 인증 토큰을 비동기적으로 설정합니다.
      */
-    protected config: customConfigFetch;
-    protected interceptors: interceptors<customConfigFetch, customResponse>;
-    constructor(config: customConfigFetch);
-    doFetch<dataType>(config: customConfigFetch): Promise<dataType>;
-    private getUrlWithParams;
-    get<dataType = any>(url: string, config?: customConfigFetch): Promise<dataType>;
-    post<dataType = any>(url: string, data?: any, config?: customConfigFetch): Promise<dataType>;
-    put<dataType = any>(url: string, data?: any, config?: customConfigFetch): Promise<dataType>;
-    delete<dataType = any>(url: string, data?: any, config?: customConfigFetch): Promise<dataType>;
-    addRequestInterceptor(onFulfilled: fulfilled<customConfigFetch>, onRejected?: rejected): void;
-    addResponseInterceptor(onFulfilled: fulfilled<customResponse>, onRejected?: rejected): void;
-    private getValue;
-    handleRequest(config: customConfigFetch): Promise<customConfigFetch>;
-    handleResponse(customResponse: customResponse): Promise<customResponse>;
-    handleResponseError(e: CustomError): Promise<void>;
+    setAuthToken(): Promise<void>;
+    /**
+     * 모든 헤더를 비동기적으로 설정합니다.
+     */
+    setAllHeaders(): Promise<void>;
 }
+declare const HeaderFunc: {
+    getHeader(name: string): Promise<string | null>;
+    setHeader(name: string, value: string): Promise<void>;
+};
 
-declare class HttpClientFetch extends AbstractHttpClient<customConfigFetch, FetchInstance, CustomError> {
-    protected errorHandler: null | ((e: CustomError) => void);
+/**
+ * HTTP 요청에 대한 설정을 나타냅니다.
+ * 표준 `RequestInit` 타입의 하위 집합이며, `params`와 `data`가 추가되었습니다.
+ * body를 제거하고 axios와 유사한 형태로 data로 작성.
+ * json변환 자동화 및 개발편의성.
+ */
+interface RequestConfig extends Omit<RequestInit, 'body'> {
+    url?: string;
+    params?: Record<string, any>;
+    data?: any;
+}
+/**
+ * HttpClient 인스턴스에 대한 설정입니다.
+ */
+interface HttpClientConfig {
+    baseURL?: string;
+    headers?: Record<string, string>;
+}
+/**
+ * 선택적인 성공 및 실패 핸들러를 포함하는 인터셉터의 구조
+ */
+interface Interceptor<V> {
+    onFulfilled?: (value: V) => V | Promise<V>;
+    onRejected?: (error: any) => any;
+}
+
+/**
+ * HTTP 오류를 위한 사용자 정의 오류
+ * 응답 객체를 포함
+ * @todo  CustomeError  > 다이렉트 에러 참고하여 수정 필요
+ */
+declare class HttpError extends Error {
+    response: Response;
+    data: any;
+    constructor(response: Response, data: any);
+}
+/**
+ * Axios와 유사하게 인터셉터 컬렉션을 관리합니다.
+ */
+declare class InterceptorManager<V> {
+    private handlers;
     /**
-     * HttpClientFetch request interceptor 동작시, 헤더에 주입될 헤더의 key,value
+     * 체인에 새 인터셉터를 추가
+     * @param onFulfilled - 프로미스가 이행되었을 때 호출할 함수
+     * @param onRejected - 프로미스가 거부되었을 때 호출할 함수
+     * @returns 인터셉터의 ID이며, 나중에 제거하는 데 사용
      */
-    protected headers: Record<string, string>;
+    use(onFulfilled?: (value: V) => V | Promise<V>, onRejected?: (error: any) => any): number;
     /**
-     * fetch 인스턴스 생성시 기본설정값 및 기타 필요한 정보들을 추가 가능
+     * ID를 사용하여 체인에서 인터셉터를 제거합니다.
+     * @param id - 제거할 인터셉터의 ID입니다.
      */
-    protected config: customConfigFetch;
+    eject(id: number): void;
     /**
-     * api연동을 수행할 실제 객체(axios, fetch 등의 다른 라이브러리로 교체가능한 영역)
-     * 현재 버전에서는 axios를 사용하여 구현됨.
+     * 주어진 프로미스에 대해 인터셉터 체인을 실행합니다.
+     * @param promise - 체인을 시작할 초기 프로미스입니다.
+     * @returns 전체 체인이 실행된 후 확인되는 새 프로미스입니다.
      */
-    api: FetchInstance;
-    constructor(config?: customConfigFetch);
-    put<dataType = any>(url: string, data?: any, config?: customConfigFetch): Promise<dataType>;
-    get<dataType = any>(url: string, config?: customConfigFetch): Promise<dataType>;
-    delete<dataType = any>(url: string, config?: customConfigFetch): Promise<dataType>;
-    post<dataType = any>(url: string, data?: any, config?: customConfigFetch): Promise<dataType>;
-    setHeader(key: string, value: string): void;
+    executeChain(promise: Promise<V>): Promise<V>;
 }
-
-type errorHandlerFethType = (response: CustomError, config: customConfigFetch) => void;
-declare abstract class ErrorHandlerFetch {
-    protected localThrow?: errorHandlerFethType;
-    /** 개별처리 + 글로벌처리 모두 사용할경우 : true ,  개별처리만 사용할 경우 : false */
-    protected globalCheck: boolean;
-    constructor();
-    setGlobalCheck(global: boolean): void;
-    /**
-     * 에러코드에 맞는 Error에러 객체를 throw 및 Sentry 리포팅 영역
-     */
-    private globalThrow;
-    setLocalHandler(func: errorHandlerFethType): void;
-    do(error: CustomError, config: customConfigFetch): void;
+/**
+ * @description middleware.ts에서 사용하기 위한 용도로 작성
+ */
+declare class FetchInstance {
+    private defaults;
+    interceptors: {
+        request: InterceptorManager<RequestConfig>;
+        response: InterceptorManager<Response>;
+    };
+    constructor(config?: HttpClientConfig);
     /**
-     * 발생한 CustomError 설정값에 따른 에러 처리 추가영역
-     * 상속한 server/client 에서 에러 핸들링
+     * 인터셉터를 적용하고 실제 fetch 호출을 수행
+     * @param config - 요청 설정
      */
-    abstract errorHandler(e: CustomError): void;
+    request<T = any>(config: RequestConfig): Promise<{
+        data: T;
+        response: Response;
+    }>;
+    get<T = any>(url: string, config?: Omit<RequestConfig, 'method'>): Promise<{
+        data: T;
+        response: Response;
+    }>;
+    post<T = any>(url: string, data: any, config?: Omit<RequestConfig, 'method' | 'data'>): Promise<{
+        data: T;
+        response: Response;
+    }>;
+    put<T = any>(url: string, data: any, config?: Omit<RequestConfig, 'method' | 'data'>): Promise<{
+        data: T;
+        response: Response;
+    }>;
+    delete<T = any>(url: string, config?: Omit<RequestConfig, 'method'>): Promise<{
+        data: T;
+        response: Response;
+    }>;
 }
 
-declare class SsrHttpClientFetch extends HttpClientFetch {
-    static query: string;
-    private ssrErrorHandlerFetch;
-    constructor(config?: customConfigFetch);
-    setSsrErrorFetchHandler(ssrErrorHandlerFetch: ErrorHandlerFetch): void;
-    /**
-     * API 연동 실패시, 에러핸들러 셋팅 (특정페이지에서만 동작하는 개별 핸들러)
-     * @param handler ssrErrorHandler
-     */
-    setLocalErrorHandler(handler: errorHandlerFethType): void;
+/**
+ * @description middleware에서 사용하는 용도.
+ * 인증토큰 처리외에 용도는 없음.
+ */
+declare class HttpClientFetch extends FetchInstance {
+    headerManager: HeaderManagerAsync;
+    headers: Record<string, string>;
+    constructor(config?: HttpClientConfig);
 }
 
-export { AuthServer, ErrorHandlerFetch, SsrHttpClientAxios, SsrHttpClientFetch, type errorHandlerFethType };
+export { AuthServer, FetchInstance, GetterAsync, HeaderFunc, HeaderManagerAsync, type HttpClientConfig, HttpClientFetch, HttpError, type Interceptor, type RequestConfig, SetterAsync, cookieServer };

package/dist/server.d.ts

@@ -1,6 +1,5 @@
-import { H as HttpClientAxios, C as CustomError, c as customConfig, E as ErrorHandler, e as errorHandler, A as AbstractHttpClient } from './error-handler-DCenPKx5.js';
-import { customConfigFetch, interceptors, customResponse, fulfilled, rejected } from './common.js';
-import 'axios';
+import { a as GetterAsync, b as SetterAsync } from './header.types-duHbFvO0.js';
+export { A as AT, G as GetterSync, S as SetterSync, c as customHeaderNames } from './header.types-duHbFvO0.js';
 
 declare class AuthServer {
     /**
@@ -18,92 +17,141 @@ declare class AuthServer {
     refreshToken(): Promise<string>;
 }
 
-declare class SsrHttpClientAxios extends HttpClientAxios<CustomError> {
-    static query: string;
-    private ssrErrorHandler;
-    constructor(config?: customConfig);
-    setSsrErrorHandler(ssrErrorHandler: ErrorHandler): void;
+/**
+ * 서버사이드용 쿠키함수
+ */
+declare const cookieServer: {
+    getCookie(name: string): Promise<string>;
+    setCookie(name: string, value: string, options?: any): Promise<void>;
+    deleteCookie(name: string): Promise<void>;
+};
+
+declare class HeaderManagerAsync {
+    private getter;
+    private setter;
+    constructor(getter: GetterAsync, setter: SetterAsync);
     /**
-     * API 연동 실패시, 에러핸들러 셋팅 (특정페이지에서만 동작하는 개별 핸들러)
-     * @param handler ssrErrorHandler
+     * 커스텀 헤더를 비동기적으로 설정합니다.
      */
-    setLocalErrorHandler(handler: errorHandler, global?: boolean): void;
-}
-
-declare class FetchInstance {
+    setCustomHeaders(): Promise<void>;
     /**
-     * fetch 인스턴스 생성시 기본설정값 및 기타 필요한 정보들을 추가 가능
+     * 인증 토큰을 비동기적으로 설정합니다.
      */
-    protected config: customConfigFetch;
-    protected interceptors: interceptors<customConfigFetch, customResponse>;
-    constructor(config: customConfigFetch);
-    doFetch<dataType>(config: customConfigFetch): Promise<dataType>;
-    private getUrlWithParams;
-    get<dataType = any>(url: string, config?: customConfigFetch): Promise<dataType>;
-    post<dataType = any>(url: string, data?: any, config?: customConfigFetch): Promise<dataType>;
-    put<dataType = any>(url: string, data?: any, config?: customConfigFetch): Promise<dataType>;
-    delete<dataType = any>(url: string, data?: any, config?: customConfigFetch): Promise<dataType>;
-    addRequestInterceptor(onFulfilled: fulfilled<customConfigFetch>, onRejected?: rejected): void;
-    addResponseInterceptor(onFulfilled: fulfilled<customResponse>, onRejected?: rejected): void;
-    private getValue;
-    handleRequest(config: customConfigFetch): Promise<customConfigFetch>;
-    handleResponse(customResponse: customResponse): Promise<customResponse>;
-    handleResponseError(e: CustomError): Promise<void>;
+    setAuthToken(): Promise<void>;
+    /**
+     * 모든 헤더를 비동기적으로 설정합니다.
+     */
+    setAllHeaders(): Promise<void>;
 }
+declare const HeaderFunc: {
+    getHeader(name: string): Promise<string | null>;
+    setHeader(name: string, value: string): Promise<void>;
+};
 
-declare class HttpClientFetch extends AbstractHttpClient<customConfigFetch, FetchInstance, CustomError> {
-    protected errorHandler: null | ((e: CustomError) => void);
+/**
+ * HTTP 요청에 대한 설정을 나타냅니다.
+ * 표준 `RequestInit` 타입의 하위 집합이며, `params`와 `data`가 추가되었습니다.
+ * body를 제거하고 axios와 유사한 형태로 data로 작성.
+ * json변환 자동화 및 개발편의성.
+ */
+interface RequestConfig extends Omit<RequestInit, 'body'> {
+    url?: string;
+    params?: Record<string, any>;
+    data?: any;
+}
+/**
+ * HttpClient 인스턴스에 대한 설정입니다.
+ */
+interface HttpClientConfig {
+    baseURL?: string;
+    headers?: Record<string, string>;
+}
+/**
+ * 선택적인 성공 및 실패 핸들러를 포함하는 인터셉터의 구조
+ */
+interface Interceptor<V> {
+    onFulfilled?: (value: V) => V | Promise<V>;
+    onRejected?: (error: any) => any;
+}
+
+/**
+ * HTTP 오류를 위한 사용자 정의 오류
+ * 응답 객체를 포함
+ * @todo  CustomeError  > 다이렉트 에러 참고하여 수정 필요
+ */
+declare class HttpError extends Error {
+    response: Response;
+    data: any;
+    constructor(response: Response, data: any);
+}
+/**
+ * Axios와 유사하게 인터셉터 컬렉션을 관리합니다.
+ */
+declare class InterceptorManager<V> {
+    private handlers;
     /**
-     * HttpClientFetch request interceptor 동작시, 헤더에 주입될 헤더의 key,value
+     * 체인에 새 인터셉터를 추가
+     * @param onFulfilled - 프로미스가 이행되었을 때 호출할 함수
+     * @param onRejected - 프로미스가 거부되었을 때 호출할 함수
+     * @returns 인터셉터의 ID이며, 나중에 제거하는 데 사용
      */
-    protected headers: Record<string, string>;
+    use(onFulfilled?: (value: V) => V | Promise<V>, onRejected?: (error: any) => any): number;
     /**
-     * fetch 인스턴스 생성시 기본설정값 및 기타 필요한 정보들을 추가 가능
+     * ID를 사용하여 체인에서 인터셉터를 제거합니다.
+     * @param id - 제거할 인터셉터의 ID입니다.
      */
-    protected config: customConfigFetch;
+    eject(id: number): void;
     /**
-     * api연동을 수행할 실제 객체(axios, fetch 등의 다른 라이브러리로 교체가능한 영역)
-     * 현재 버전에서는 axios를 사용하여 구현됨.
+     * 주어진 프로미스에 대해 인터셉터 체인을 실행합니다.
+     * @param promise - 체인을 시작할 초기 프로미스입니다.
+     * @returns 전체 체인이 실행된 후 확인되는 새 프로미스입니다.
      */
-    api: FetchInstance;
-    constructor(config?: customConfigFetch);
-    put<dataType = any>(url: string, data?: any, config?: customConfigFetch): Promise<dataType>;
-    get<dataType = any>(url: string, config?: customConfigFetch): Promise<dataType>;
-    delete<dataType = any>(url: string, config?: customConfigFetch): Promise<dataType>;
-    post<dataType = any>(url: string, data?: any, config?: customConfigFetch): Promise<dataType>;
-    setHeader(key: string, value: string): void;
+    executeChain(promise: Promise<V>): Promise<V>;
 }
-
-type errorHandlerFethType = (response: CustomError, config: customConfigFetch) => void;
-declare abstract class ErrorHandlerFetch {
-    protected localThrow?: errorHandlerFethType;
-    /** 개별처리 + 글로벌처리 모두 사용할경우 : true ,  개별처리만 사용할 경우 : false */
-    protected globalCheck: boolean;
-    constructor();
-    setGlobalCheck(global: boolean): void;
-    /**
-     * 에러코드에 맞는 Error에러 객체를 throw 및 Sentry 리포팅 영역
-     */
-    private globalThrow;
-    setLocalHandler(func: errorHandlerFethType): void;
-    do(error: CustomError, config: customConfigFetch): void;
+/**
+ * @description middleware.ts에서 사용하기 위한 용도로 작성
+ */
+declare class FetchInstance {
+    private defaults;
+    interceptors: {
+        request: InterceptorManager<RequestConfig>;
+        response: InterceptorManager<Response>;
+    };
+    constructor(config?: HttpClientConfig);
     /**
-     * 발생한 CustomError 설정값에 따른 에러 처리 추가영역
-     * 상속한 server/client 에서 에러 핸들링
+     * 인터셉터를 적용하고 실제 fetch 호출을 수행
+     * @param config - 요청 설정
      */
-    abstract errorHandler(e: CustomError): void;
+    request<T = any>(config: RequestConfig): Promise<{
+        data: T;
+        response: Response;
+    }>;
+    get<T = any>(url: string, config?: Omit<RequestConfig, 'method'>): Promise<{
+        data: T;
+        response: Response;
+    }>;
+    post<T = any>(url: string, data: any, config?: Omit<RequestConfig, 'method' | 'data'>): Promise<{
+        data: T;
+        response: Response;
+    }>;
+    put<T = any>(url: string, data: any, config?: Omit<RequestConfig, 'method' | 'data'>): Promise<{
+        data: T;
+        response: Response;
+    }>;
+    delete<T = any>(url: string, config?: Omit<RequestConfig, 'method'>): Promise<{
+        data: T;
+        response: Response;
+    }>;
 }
 
-declare class SsrHttpClientFetch extends HttpClientFetch {
-    static query: string;
-    private ssrErrorHandlerFetch;
-    constructor(config?: customConfigFetch);
-    setSsrErrorFetchHandler(ssrErrorHandlerFetch: ErrorHandlerFetch): void;
-    /**
-     * API 연동 실패시, 에러핸들러 셋팅 (특정페이지에서만 동작하는 개별 핸들러)
-     * @param handler ssrErrorHandler
-     */
-    setLocalErrorHandler(handler: errorHandlerFethType): void;
+/**
+ * @description middleware에서 사용하는 용도.
+ * 인증토큰 처리외에 용도는 없음.
+ */
+declare class HttpClientFetch extends FetchInstance {
+    headerManager: HeaderManagerAsync;
+    headers: Record<string, string>;
+    constructor(config?: HttpClientConfig);
 }
 
-export { AuthServer, ErrorHandlerFetch, SsrHttpClientAxios, SsrHttpClientFetch, type errorHandlerFethType };
+export { AuthServer, FetchInstance, GetterAsync, HeaderFunc, HeaderManagerAsync, type HttpClientConfig, HttpClientFetch, HttpError, type Interceptor, type RequestConfig, SetterAsync, cookieServer };