sales-frontend-utils 0.0.41 → 0.0.42

package/dist/index.d.cts

@@ -1,442 +1,11 @@
-import dayjs from 'dayjs';
-
-/**
- * 쓰로틀
- * @param func
- * @param delay
- * @returns
- */
-declare function throttle<T extends (...args: any[]) => void>(func: T, delay: number): (...args: Parameters<T>) => void;
-/**
- * 디바운스
- * @param func
- * @param delay
- * @returns
- */
-declare function debounce<T extends (...args: any[]) => void>(func: T, delay: number): (...args: Parameters<T>) => void;
-
-type ExecutionEnvironment = 'web' | 'android-webview' | 'ios-webview' | 'iframe' | 'unknown';
-/**
- * 운영체제 이름을 판단하는 타입
- */
-type OSName = 'windows' | 'mac' | 'linux' | 'android' | 'ios' | 'unknown';
-/**
- * 브라우저 이름을 판단하는 타입
- */
-type BrowserName = 'chrome' | 'firefox' | 'safari' | 'edge' | 'opera' | 'samsung' | 'unknown';
-
-/**
- * 한화생명 영업지원 웹 실행 환경 탐지
- * @returns
- */
-declare const getDspExecutionEnvironment: () => ExecutionEnvironment;
-/**
- * 한화생명 영업 앱 환경 여부 판단(DSP 앱 또는 FP 플래너 앱)
- * 운영 중인 프로덕션 앱에서 실행 중인지 확인
- * @returns
- */
-declare const isProductionApp: () => boolean;
-/**
- * UserAgent에 SspApp 이 있는지 검사
- * 있으면, DSP 앱
- * @param userAgent
- * @returns
- */
-declare const checkUserAgentDspApp: (userAgent: string) => boolean;
-/**
- * 한화생명 영업지원 웹뷰 환경 여부 판단
- * @returns 웹뷰(Android/iOS) 환경이면 true, 아니면 false
- */
-declare const isDspApp: () => boolean;
-/**
- * FP 플래너 웹뷰 환경 여부 판단
- * @returns
- */
-declare const isFpPlannerApp: () => boolean;
-/**
- * 영업 포털 환경 여부 판단
- * @returns
- */
-declare const isSalesPortal: () => boolean;
-/**
- * 태블릿 여부 판단
- * @param userAgent
- * @returns
- */
-declare const isTablet: (userAgent: string) => boolean;
-/**
- * 스마트폰 여부 판단
- * @param userAgent
- * @returns
- */
-declare const isPhone: (userAgent: string) => boolean;
-/**
- * 데스크톱 여부 판단
- * @param userAgent
- * @returns
- */
-declare const isPc: (userAgent: string) => boolean;
-/**
- * UserAgent에서 기기 타입 구분
- * @param userAgent
- * @returns
- */
-declare const getFormFactorFromUserAgent: (userAgent: string) => "tablet" | "pc" | "phone";
-/**
- * UserAgent에서 운영체제 이름을 추출
- * @param userAgent - 브라우저의 userAgent 문자열
- * @returns 운영체제 이름
- */
-declare const getOSName: (userAgent: string) => OSName;
-/**
- * 현재 브라우저의 운영체제 이름을 가져오기
- * @returns 현재 환경의 운영체제 이름
- */
-declare const getCurrentOSName: () => OSName;
-/**
- * UserAgent에서 OS 버전을 추출
- * @param userAgent - 브라우저의 userAgent 문자열
- * @returns OS 버전 문자열
- */
-declare const getOSVersion: (userAgent: string) => string;
-/**
- * UserAgent에서 브라우저 이름을 추출
- * @param userAgent - 브라우저의 userAgent 문자열
- * @returns 브라우저 이름
- */
-declare const getBrowserName: (userAgent: string) => BrowserName;
-/**
- * UserAgent에서 브라우저 버전을 추출
- * @param userAgent - 브라우저의 userAgent 문자열
- * @returns 브라우저 버전
- */
-declare const getBrowserVersion: (userAgent: string) => string;
-/**
- * 현재 브라우저의 OS 버전을 가져오기
- * @returns 현재 환경의 OS 버전
- */
-declare const getCurrentOSVersion: () => string;
-/**
- * 현재 브라우저의 이름을 가져오기
- * @returns 현재 환경의 브라우저 이름
- */
-declare const getCurrentBrowserName: () => BrowserName;
-/**
- * 현재 브라우저의 버전을 가져오기
- * @returns 현재 환경의 브라우저 버전
- */
-declare const getCurrentBrowserVersion: () => string;
-/**
- * 클라이언트용 디바이스 ID 생성 및 관리(임시값)
- */
-declare const getOrCreateDeviceId: () => string;
-/**
- * 디바이스 모델 감지
- */
-declare const getDeviceModel: () => string;
-
-/**
- * 호스트명에서 서브도메인을 추출합니다.
- * @param hostname 호스트명
- * @returns 서브도메인 (예: nxl-dsp-dev)
- */
-declare const getSubdomain: (hostname: string) => string;
-/**
- * 호스트명을 기반으로 환경을 판단합니다.
- * @param hostname 호스트명
- * @returns 환경 구분 문자열 ('local' | 'dev' | 'stg' | 'prd')
- */
-declare const getEnvironmentFromHostname: (hostname: string) => "local" | "dev" | "stg" | "prd";
-/**
- * @see https://github.com/storybookjs/storybook/issues/32028#issuecomment-3298982086
- * @note 스토리북에서 버그로인해 window객체를 정상적으로 탐지하지 못하는 이슈우회
- */
-declare const isClient: () => boolean;
-/**
- * 현재 실행 환경이 Storybook인지 확인하는 함수
- *
- * 사용 전, `viteFinal` 설정에서 `window.isStorybookEnv`를 `true`로 정의해야 정상 동작합니다.
- *
- * 예시:
- * ```ts
- * const config: StorybookConfig = {
- *   viteFinal: (config) => {
- *     // window.isStorybookEnv를 true로 설정 (boolean 값으로 처리됨)
- *     config.define = {
- *       ...config.define,
- *       'window.isStorybookEnv': 'true',
- *     };
- *
- *     return config;
- *   },
- * };
- * ```
- */
-declare const isStorybookEnv: () => boolean;
-/**
- * 현재 업무구분 코드 구하기
- * 원칙: pathname의 첫 번째가 업무구분코드를 사용할 경우 해당 값을 반환
- * @returns
- */
-declare const getBusinessWorkDivisionCode: () => string;
-/**
- * @description storybook에서 동작을 고려하여 수정한 버전
- * @returns
- */
-declare const getServicePath: () => string;
-/**
- * 환경에 맞는 API 호스트명을 반환합니다.
- * 호스트명을 강제하고 싶으면 두 번째 파라미터로 넘기세요.
- * @param currentHostname
- * @param forceApiHostName
- * @returns
- */
-declare const getApiHostNameFromEnvironment: (currentHostname: string, forceApiHostName?: string) => string;
-/**
- * 환경에 맞는 CDN 호스트명을 반환합니다.
- * 호스트명을 강제하고 싶으면 두 번째 파라미터로 넘기세요.
- * @param currentHostname
- * @param forceApiHostName
- * @returns
- */
-declare const getCdnHostNameFromEnvironment: (currentHostname: string, forceApiHostName?: string) => string;
-/**
- * @description
- *  환경에 맞는 비정형PI 호스트명을 반환합니다.
- * client side에서 사용하는 함수입니다.
- * @param serviceCode dea,dis,dcm
- * @param hostname window.location.hostname
- * @returns
- */
-declare const getDudApiBasePathFromEnvironment: (hostname?: string) => string;
-/**
- * @description
- *  환경에 맞는 Dsp 호스트명을 반환합니다.
- * client side에서 사용하는 함수입니다.
- * @param serviceCodeTo dea,dis 같은 api서버명
- * @param hostname window.location.hostname
- * @returns
- */
-declare const getDspApiBasePathFromEnvironment: (serviceCodeTo: string, hostname?: string) => string;
-/**
- * @description
- *  환경에 맞는 NLC 호스트명을 반환합니다.
- * client side에서 사용하는 함수입니다.
- * @param hostname window.location.hostname
- * @returns
- */
-declare const getNlcHostFromEnvironment: (hostname?: string) => "" | "https://nxl-nlc-stg.hanwhalife.com" | "https://nxl-nlc-dev.hanwhalife.com" | "https://nxl-nlc.hanwhalife.com";
-
-/**
- * Message 이벤트 헨들러를 관리하는 클래스입니다. (싱글턴)
- * 모든 message 핸들러는 여기를 통해 등록해야합니다.
- * window.addEventListener('message') 의 중복을 방지하기 위함입니다.
- */
-declare class MessageEventManager {
-    private static instance;
-    private handlers;
-    static getInstance(): MessageEventManager;
-    private constructor();
-    /**
-     *
-     * @param event
-     */
-    private handleMessage;
-    /**
-     * 이벤트 헨들러 함수를 등록합니다.
-     * @param key
-     * @param handler
-     */
-    registerHandler(key: string, handler: (event: MessageEvent) => void): void;
-    /**
-     * 이벤트 핸들러 함수를 삭제합니다.
-     * @param key
-     */
-    unregisterHandler(key: string): void;
-}
-
-interface ConvertTextToImgParams {
-    /** 이미지로 변환할 문자열 */
-    targetStr: string;
-    /** 캔버스 너비 (지정하지 않으면 텍스트 길이에 따라 자동 계산) */
-    canvasWidth?: number;
-    /** 캔버스 높이 (지정하지 않으면 기본값 150px) */
-    canvasHeight?: number;
-    /** 배경색 (지정하지 않으면 투명) */
-    backgroundColor?: string;
-    /** 폰트 크기 (지정하지 않으면 기본값 75px) */
-    fontSize?: number;
-    /** 폰트 색상 (지정하지 않으면 기본값 검정색) */
-    fontColor?: string;
-    /** 폰트 두께 (지정하지 않으면 기본값 bold) */
-    fontWeight?: string;
-    /** 폰트 패밀리 (지정하지 않으면 기본값 ) */
-    fontFamily?: string;
-}
-/**
- * 텍스트를 이미지(Base64)로 변환하는 함수
- * @param params - 변환에 필요한 파라미터 객체
- * @returns Base64로 인코딩된 이미지 데이터 URL
- */
-declare const convertTextToImg: ({ targetStr, canvasWidth, canvasHeight, backgroundColor, fontColor, fontSize, fontWeight, fontFamily }: ConvertTextToImgParams) => string;
-declare function drawImageResizeCentered(base64: string, size: {
-    canvasWidth: number;
-    canvasHeight: number;
-}): Promise<unknown>;
-
-declare const getCookie: (name: string) => string;
-declare const setCookie: (name: string, value: string, options?: {
-    expires?: number | Date;
-    path?: string;
-    domain?: string;
-    secure?: boolean;
-}) => void;
-declare const deleteCookie: (name: string, options?: {
-    path?: string;
-    domain?: string;
-}) => void;
-
-declare function base64ToBlob(base64String: string, contentType?: string): Blob;
-declare function base64ToFile(base64String: string, fileName: string, contentType?: string): File;
-declare function blobToFile(blob: Blob, fileName: string): File;
-declare function fileToBase64(file: File | Blob): Promise<string>;
-/**
- * 파일확장자 리턴
- * @param data string File Blob
- */
-declare function getExt(data: string | File | Blob): string | undefined;
-declare function objectUrlToBlob(objectUrl: string): Promise<Blob>;
-declare function objectUrlToBase64(objectUrl: string): Promise<string>;
-declare function downloadBlob(blob: Blob, filename: string): void;
-/**
- * image url을 File Object로 변경.
- * @param imageUrl fileObject로 변경할 image url
- * @return file object
- */
-declare function imageUrlToFile(imageUrl: string): Promise<File>;
-
-/**
- * element를 동적으로 추가하는 경우 사용.
- * @param el HTMLElement
- * @param e2e_type string
- */
-declare function addE2EObject(el: HTMLElement, e2e_type?: string): void;
-declare function hasAstx2(): boolean;
-interface Astx2Init {
-    initSuccess?: () => void;
-    initFailure?: () => void;
-    checkServerSuccess?: () => void;
-    checkServerFailure?: () => void;
-}
-declare const loadScript: (callback?: () => void) => void;
-/**
- * @description 페이지진입후 최초 실행
- */
-declare const initASTX2: ({ initSuccess, initFailure, checkServerSuccess, checkServerFailure }?: Astx2Init) => void;
-/**
- * form객체로 감싸진 html input이 아닌 개별 input을 컨트롤
- * id기반으로 데이터접근
- * @param ids string[]
- * @param onSuccess
- * @param onFailure
- */
-declare function getE2EDataIDs(ids: string[], onSuccess: (astx_data: any) => void, onFailure?: () => void): void;
-
-/**
- *
- * @param year
- * @param month
- * @returns
- */
-declare function getLastDay(year: number, month: number): 29 | 28 | 30 | 31;
-/**
- * 한달뒤 날짜를 포맷형태로 리턴
- * @param 20200101 or 2020.01.01
- * @param 'YYYY.MM.DD'
- * @returns
- */
-declare const getOneMonthLater: (value?: string, format?: string) => string;
-/**
- * 날짜 차이를 구한다. 포맷에 맞지 않으면 Not a Number 리턴
- * @param date1 (yyyymmdd or yyyy.mm.dd or yyyy-mm-dd)
- * @param date2 (yyyymmdd or yyyy.mm.dd or yyyy-mm-dd)
- * @returns date1 - date2
- */
-declare const getDateDiff: (date1: string | number | dayjs.Dayjs | Date, date2: string | number | dayjs.Dayjs | Date) => number;
-/**
- * 입력되어진 생년월일 값이 당일 기준으로 미래시점인 경우 false를 반환합니다. (회원체계 기준 9, 0 일 경우 오류)
- * @param front 주민등록번호 앞 6자리
- * @param back 주민등록번호 뒤 첫자리
- * @returns boolean
- */
-declare const validateBirthdate: (front: string, back: string) => boolean;
-/**
- * 목표 날짜가 비교 날짜 이후 인지 확인하는 함수 (YYYYMMDD 형식)
- * @param targetDate
- * @param compareDate
- * @returns boolean
- */
-declare function isDateAfter(targetDate: string | number | dayjs.Dayjs | Date, compareDate: string | number | dayjs.Dayjs | Date): boolean;
-/**
- * 날짜를 포맷형태로 리턴
- * @param 20200101 string
- * @param 'YYYY.MM.DD
- * @returns 포맷화된 날짜
- */
-declare const convertDateFormat: (value?: string | number | dayjs.Dayjs | Date, format?: string) => string;
-/**
- * 주어진 날짜가 오늘 날짜 이후인지 확인합니다.
- *
- * @param {string} dateString - 확인할 날짜 문자열입니다.
- * @param {dayjs.OptionType} [format] - 날짜 문자열의 형식입니다.
- * @returns {boolean} - 주어진 날짜가 오늘 이후라면 true를 반환합니다.
- */
-declare const isFutureDate: (dateString?: string | number | dayjs.Dayjs | Date, format?: dayjs.OptionType) => boolean;
-/**
- * 자주 사용하는 타입들 추가해두었습니다. 필요하신 형태 있으면 추가해주세요.
- */
-type DateFormat = 'YYYY-MM-DD' | 'YYYY.MM.DD' | 'YYYY-MM' | 'YYYY-MM-DD HH:mm:ss' | 'YYYY.MM.DD HH:mm:ss' | 'YYYY-MM-DD HH:mm' | 'YYYYMMDD' | 'YYYY.M.D' | 'YYYY.M' | 'YYYY.MM.DD(dd) HH:mm:ss' | 'HH:mm:ss' | 'YYYY.M.D(dd)' | 'HH:mm';
-interface Props {
-    /** 날짜 문자열 */
-    dateString: string | number | Date | dayjs.Dayjs;
-    /** 현재 날짜 포맷 */
-    fromFormat?: string;
-    /** 컨버팅할 날짜 포맷 */
-    toFormat: string;
-}
-/**
- * date string 을 입력받고 패턴에 맞게 포맷팅을 변경하는 유틸 함수
- * fromFormat 현재 날짜 포맷
- * toFormat 리턴 날짜 포맷
- */
-declare const convertDateString: ({ dateString, fromFormat, toFormat }: Props) => string;
-declare const isDate: (value: unknown) => boolean;
-/**
- * 날짜 유효성 검사
- *
- * @param {string} dateString - 검사할 날짜 문자열.
- * @param {dayjs.OptionType} [format] - 날짜 문자열의 형식입니다.
- * @returns {boolean} - 유효한 날짜이면 true를 반환하고, 그렇지 않으면 false를 반환합니다.
- */
-declare const isValidDate: (dateString?: string | number | dayjs.Dayjs | Date, format?: dayjs.OptionType) => boolean;
-type PeriodType = 'thisWeek' | 'lastWeek' | 'last7Days' | 'thisMonth' | 'lastMonth' | 'last365Days' | 'week' | 'month' | 'today';
-/**
- * @description
- * today 당일
- * week 7일: 오늘 기준 7일 전
- * month 30: 오늘 기준 30일 전
- * thisWeek 이번 주 (일요일 ~ 토요일)
- * lastWeek 지난 주 (일요일 ~ 토요일)
- * last7Days 최근 7일 (오늘 포함)
- * thisMonth 이번 달 (1일 ~ 말일)
- * lastMonth 지난 달 (1일 ~ 말일)
- * last365Days 최근 365일 (오늘 포함)
- * @param periodType
- * @returns
- */
-declare const getPeriodDate: (periodType: PeriodType | "today") => {
-    startDate: Date;
-    endDate: Date;
-} | null;
-
-export { type BrowserName, type DateFormat, type ExecutionEnvironment, MessageEventManager, type OSName, type PeriodType, addE2EObject, base64ToBlob, base64ToFile, blobToFile, checkUserAgentDspApp, convertDateFormat, convertDateString, convertTextToImg, debounce, deleteCookie, downloadBlob, drawImageResizeCentered, fileToBase64, getApiHostNameFromEnvironment, getBrowserName, getBrowserVersion, getBusinessWorkDivisionCode, getCdnHostNameFromEnvironment, getCookie, getCurrentBrowserName, getCurrentBrowserVersion, getCurrentOSName, getCurrentOSVersion, getDateDiff, getDeviceModel, getDspApiBasePathFromEnvironment, getDspExecutionEnvironment, getDudApiBasePathFromEnvironment, getE2EDataIDs, getEnvironmentFromHostname, getExt, getFormFactorFromUserAgent, getLastDay, getNlcHostFromEnvironment, getOSName, getOSVersion, getOneMonthLater, getOrCreateDeviceId, getPeriodDate, getServicePath, getSubdomain, hasAstx2, imageUrlToFile, initASTX2, isClient, isDate, isDateAfter, isDspApp, isFpPlannerApp, isFutureDate, isPc, isPhone, isProductionApp, isSalesPortal, isStorybookEnv, isTablet, isValidDate, loadScript, objectUrlToBase64, objectUrlToBlob, setCookie, throttle, validateBirthdate };
+export { debounce, throttle } from './utils/timing-utils.cjs';
+export { checkUserAgentDspApp, getBrowserName, getBrowserVersion, getCurrentBrowserName, getCurrentBrowserVersion, getCurrentOSName, getCurrentOSVersion, getDeviceModel, getDspExecutionEnvironment, getFormFactorFromUserAgent, getOSName, getOSVersion, getOrCreateDeviceId, isDspApp, isFpPlannerApp, isPc, isPhone, isProductionApp, isSalesPortal, isTablet } from './utils/user-agent-utils.cjs';
+export { getApiHostNameFromEnvironment, getBusinessWorkDivisionCode, getCdnHostNameFromEnvironment, getDspApiBasePathFromEnvironment, getDudApiBasePathFromEnvironment, getEnvironmentFromHostname, getNlcHostFromEnvironment, getServicePath, getSubdomain, isClient, isStorybookEnv } from './utils/environment-utils.cjs';
+export { MessageEventManager } from './utils/event-handler-utils.cjs';
+export { convertTextToImg, drawImageResizeCentered } from './utils/canvas-utils.cjs';
+export { deleteCookie, getCookie, setCookie } from './utils/cookie-utils.cjs';
+export { base64ToBlob, base64ToFile, blobToFile, downloadBlob, fileToBase64, getExt, imageUrlToFile, objectUrlToBase64, objectUrlToBlob } from './utils/file-utils.cjs';
+export { addE2EObject, getE2EDataIDs, hasAstx2, initASTX2, loadScript } from './utils/astx2-utils.cjs';
+export { DateFormat, PeriodType, convertDateFormat, convertDateString, getDateDiff, getLastDay, getOneMonthLater, getPeriodDate, isDate, isDateAfter, isFutureDate, isValidDate, validateBirthdate } from './utils/date-utils.cjs';
+export { BrowserName, ExecutionEnvironment, OSName } from './types/common.types.cjs';
+import 'dayjs';