@uniai-fe/util-functions 0.0.1

package/src/functions/format.ts

@@ -0,0 +1,318 @@
+import { convert2Digit } from "./convert";
+import { maskPhone } from "./mask";
+import { isValidDateType } from "./validation";
+import type { DateTimeFormatOptionsType } from "@uniai/types";
+
+/**
+ * comma 마스킹된 숫자 Number 타입으로 변환
+ * @util
+ * @param {number | string} value 타입 변환 값
+ * @param {boolean} [isString]
+ * @return {number | string}
+ */
+export const getNumberReplaceComma = (
+  value: unknown,
+  isString?: boolean,
+): number | string => {
+  if (
+    !["number", "string"].includes(typeof value) ||
+    value === null ||
+    value === ""
+  )
+    return "";
+
+  if (typeof value === "number") return value;
+
+  const v = Number(String(value).replace(/[^0-9.-]/g, ""));
+  if (isNaN(Number(v))) return isString ? "" : 0;
+
+  return isString ? String(v) : v;
+};
+
+/**
+ * 수량을 1000단위로 comma표기
+ * @util
+ * @param {unknown} value 숫자
+ * @param {number} [digit] 소수점 자리수 고정 옵션
+ * @return {string}
+ */
+export const lengthFormat = (value: unknown, digit?: number): string => {
+  if (
+    !["number", "string"].includes(typeof value) ||
+    value === null ||
+    value === ""
+  )
+    return "-";
+
+  if (isNaN(Number(getNumberReplaceComma(value)))) return String(value);
+
+  // 소수점 고정 옵션
+  const digitOptions: Intl.NumberFormatOptions =
+    typeof digit === "number"
+      ? { minimumFractionDigits: digit, maximumFractionDigits: digit }
+      : {};
+
+  return new Intl.NumberFormat("en-US", digitOptions).format(Number(value));
+};
+
+/**
+ * 날짜 사용 옵션
+ */
+const DATE_FULL_OPTION: Intl.DateTimeFormatOptions = {
+  year: "numeric",
+  month: "2-digit",
+  day: "2-digit",
+};
+
+/**
+ * 날짜 사용 안함 옵션
+ */
+const NO_DATE_OPTION: Intl.DateTimeFormatOptions = {
+  year: undefined,
+  month: undefined,
+  day: undefined,
+};
+
+/**
+ * 24시간 사용 옵션
+ */
+const TIME_FULL_OPTION: Intl.DateTimeFormatOptions = {
+  hour12: false,
+  hour: "2-digit",
+  minute: "2-digit",
+  second: "2-digit",
+};
+
+/**
+ * 시간 사용 안함 옵션
+ */
+const NO_TIME_OPTION: Intl.DateTimeFormatOptions = {
+  hour: undefined,
+  minute: undefined,
+  second: undefined,
+};
+
+/**
+ * 접속위치에 따른 시간대 보정
+ * @util
+ * @param {Date} date 보정할 시간
+ * @return {Date} 보정된 시간
+ */
+// 변경: correctTimezone 함수를 UTC 산출 후 KST로 변경
+export const correctTimezone = (date: string | Date): Date => {
+  const utc =
+    new Date(date).getTime() + new Date(date).getTimezoneOffset() * 60000;
+  return new Date(utc + 9 * 60 * 60000);
+};
+
+/**
+ * Date 타입 데이터를 yyyy-mm-dd로 변환
+ * @util
+ * @param {unknown} date
+ * @param {DateTimeFormatOptionsType} [options]
+ * @param {Intl.LocalesArgument} [options.formatTimezone] 시간 기준; 기본값 ko-KR
+ * @param {Intl.DateTimeFormatOptions} [options.formatOptions]
+ * @param {boolean | boolean[]} [options.isKorean] // ymd 또는 [year, month?, day?]
+ * @param {boolean} [options.isCorrection] 시간 보정
+ * @param {boolean} [options.isISOString] ISO 문자열
+ * @return {string} yyyy-mm-dd 또는 각 옵션에 대한 날짜포맷
+ */
+// 변경: dateFormat 함수에서 isCorrection 옵션 사용 시 toISOString()의 결과를 슬라이스하여 "YYYY-MM-DDTHH:MM:SS" 형식 반환
+export const dateFormat = (
+  date: unknown,
+  options?: Partial<DateTimeFormatOptionsType>,
+): string => {
+  if (isValidDateType(date)) {
+    const d = new Date(date as string | number | Date);
+    const corrDate = correctTimezone(d);
+
+    // toISOString()으로 변환 시, KST 적용되지 않음
+    const defaultDateFormat = options?.isCorrection
+      ? `${corrDate.getFullYear()}-${convert2Digit(corrDate.getMonth() + 1)}-${convert2Digit(corrDate.getDate())}`
+      : `${d.getFullYear()}-${convert2Digit(d.getMonth() + 1)}-${convert2Digit(d.getDate())}`;
+
+    if (options?.isISOString) return defaultDateFormat;
+
+    const onlyDate = defaultDateFormat || "";
+
+    if (options?.isKorean) {
+      const [y, m, d] = onlyDate.split("-");
+      if (options.isKorean === true) return `${y}년 ${m}월 ${d}일`;
+      const __ymd = options.isKorean.map((apply, index) => {
+        switch (index) {
+          case 0:
+            return apply ? `${y}년` : "";
+          case 1:
+            return apply ? `${m}월` : "";
+          case 2:
+            return apply ? `${d}일` : "";
+          default:
+            return "";
+        }
+      });
+      return __ymd.join(" ");
+    }
+
+    if (typeof options?.formatOptions !== "undefined")
+      return new Intl.DateTimeFormat(
+        options?.formatTimezone ? options.formatTimezone : "ko-KR",
+        { ...DATE_FULL_OPTION, ...options.formatOptions, ...NO_TIME_OPTION },
+      ).format(d);
+    return onlyDate;
+  }
+  return String(date);
+};
+
+/**
+ * Date 타입 데이터를 HH:MM:SS 시간으로 변환
+ * @util
+ * @param {unknown} date
+ * @param {DateTimeFormatOptionsType} [options]
+ * @param {Intl.LocalesArgument} [options.formatTimezone] 시간 기준; 기본값 ko-KR
+ * @param {Intl.DateTimeFormatOptions} [options.formatOptions]
+ * @param {boolean | boolean[]} [options.isKorean] // ymd 또는 [year, month?, day?]
+ * @param {boolean} [options.isCorrection] 시간 보정
+ * @param {boolean} [options.isISOString] ISO 문자열
+ * @return {string} HH:MM:SS
+ */
+// 변경: timeFormat 함수에서 isCorrection 옵션 사용 시 toISOString()의 시간 부분만 슬라이스하여 "HH:MM:SS" 형식 반환
+export const timeFormat = (
+  date: unknown,
+  options?: Partial<DateTimeFormatOptionsType>,
+): string => {
+  if (isValidDateType(date)) {
+    const d = new Date(date as string | number | Date);
+
+    if (options?.isKST) {
+      const utc = d.getTime() + 60 * 60 * 1000 * 9;
+      d.setTime(utc);
+    }
+
+    const defaultDateFormat = options?.isCorrection
+      ? correctTimezone(d).toISOString().split("T")[1].split(".")[0]
+      : new Intl.DateTimeFormat("en-US", {
+          ...TIME_FULL_OPTION,
+          ...NO_DATE_OPTION,
+        }).format(d);
+
+    if (options?.isISOString) return defaultDateFormat;
+
+    const onlyDate = defaultDateFormat || "";
+
+    if (options?.isKorean) {
+      const [hr, min, sec] = onlyDate.split(":");
+      if (options.isKorean === true) return `${hr}시간 ${min}분 ${sec}초`;
+      const __hms = options.isKorean.map((apply, index) => {
+        switch (index) {
+          case 0:
+            return apply ? `${hr}시간` : "";
+          case 1:
+            return apply ? `${min}분` : "";
+          case 2:
+            return apply ? `${d}초` : "";
+          default:
+            return "";
+        }
+      });
+      return __hms.join(" ");
+    }
+
+    if (typeof options?.formatOptions !== "undefined") {
+      const res = new Intl.DateTimeFormat(
+        options?.formatTimezone ? options.formatTimezone : "ko-KR",
+        { ...TIME_FULL_OPTION, ...options.formatOptions, ...NO_DATE_OPTION },
+      ).format(d);
+
+      // console.log("res", res);
+      return res;
+    }
+
+    return onlyDate;
+  }
+  return String(date);
+};
+
+/**
+ * 소요시간 변환
+ * @util
+ * @param {number | null} duration 초 단위 시간값
+ */
+export const durationFormat = (
+  duration: number | null,
+  options?: Partial<{
+    hours: boolean;
+    minutes: boolean;
+    seconds: boolean;
+  }>,
+): string => {
+  if (duration === null) return String(duration);
+
+  const hours: number | null =
+    options?.hours === false ? null : Math.floor(duration / (60 * 60));
+  const minutes: number | null =
+    options?.minutes === false ? null : Math.floor((duration % (60 * 60)) / 60);
+  const seconds: number | null =
+    options?.seconds === false ? null : duration % 60;
+
+  const HH = hours !== null ? `${hours}시간 ` : "";
+  const MM = minutes !== null ? `${minutes}분 ` : "";
+  const SS = seconds !== null ? `${seconds}초` : "";
+
+  return `${HH}${MM}${SS}`.trim();
+};
+
+/**
+ * 전화번호 타입 데이터로 변환
+ * @util
+ * @param {string | number} value
+ * @return {string}
+ * @desc
+ * - 규칙: [
+ *      999-9999(7),
+ *      9999-9999(8),
+ *      99-999-9999(9),
+ *      99-9999-9999(10),
+ *      999-999-9999(10),
+ *      999-9999-9999(11),
+ *    ];
+ * - 지역번호 구분:
+ *    01X: 휴대전화
+ *    02 ~ 0XX: 지역번호
+ */
+export const phoneNumberFormat = maskPhone;
+
+/**
+ * 정수 숫자를 +/-를 붙인 형태로 변환
+ * @util
+ * @param {unknown} value
+ * @param {boolean} [isMaskLength] 길이 마스킹 여부
+ * @return {string}
+ */
+export const deltaFormat = (
+  value: unknown,
+  digit: number = 0,
+  isMaskLength: boolean = true,
+): string => {
+  if (typeof value === "undefined" || value === null || isNaN(Number(value)))
+    return "-";
+
+  const v = Number(value);
+
+  if (v > 0) return isMaskLength ? `+${lengthFormat(v, digit)}` : `+${v}`;
+  return lengthFormat(v, digit);
+};
+
+/**
+ * 거리를 m 또는 km로 변환
+ * @util
+ * @param {number | null} distance
+ * @return {string}
+ */
+export const distanceFormat = (
+  distance: number | null,
+  isUseUnit: boolean = true,
+): string => {
+  if (distance === null) return "-";
+  if (distance < 1000) return `${distance}${isUseUnit ? "m" : ""}`;
+  return `${Math.floor(distance / 1000)}${isUseUnit ? "km" : ""}`;
+};

package/src/functions/log.ts

@@ -0,0 +1,9 @@
+/**
+ * 콘솔로그; 개발용
+ * @util
+ * @param {unknown[]} arg
+ */
+export function consoleLog(...arg: unknown[]) {
+  if (process.env.NODE_ENV === "production") return;
+  return console.log(...arg);
+}

package/src/functions/mask.ts

@@ -0,0 +1,175 @@
+/**
+ * 전화번호 포맷 마스크
+ * @util
+ * @param {string | number} value
+ * @return {string}
+ * @desc
+ * - 규칙: [
+ *      999-9999(7),
+ *      9999-9999(8),
+ *      99-999-9999(9),
+ *      99-9999-9999(10),
+ *      999-999-9999(10),
+ *      999-9999-9999(11),
+ *    ];
+ * - 지역번호 구분:
+ *    01X: 휴대전화
+ *    02 ~ 0XX: 지역번호
+ */
+export function maskPhone(value: string | number): string {
+  // 입력값
+  const originValue = String(value).replace(/[^0-9]/g, "");
+
+  if (isNaN(Number(originValue))) return originValue;
+
+  // 11자리 제한
+  const v = originValue.length > 11 ? originValue.slice(0, 11) : originValue;
+
+  let maskValue = v;
+
+  // 999-9999
+  if (3 < v.length && v.length <= 7) {
+    maskValue = `${v.slice(0, 3)}-${v.slice(3)}`;
+  }
+  // 9999-9999
+  else if (v.length === 8) {
+    maskValue = `${v.slice(0, 4)}-${v.slice(4)}`;
+  }
+  // 99-999-9999
+  else if (v.length === 9) {
+    maskValue = `${v.slice(0, 2)}-${v.slice(2, 5)}-${v.slice(5)}`;
+  }
+  // 99-9999-9999, 999-999-9999
+  else if (v.length === 10) {
+    const firstDigits = v.startsWith("02") ? 2 : 3;
+    // 02-9999-9999
+    if (firstDigits === 2) {
+      maskValue = `${v.slice(0, 2)}-${v.slice(2, 6)}-${v.slice(6)}`;
+    }
+    // 0XX-999-9999
+    else {
+      maskValue = `${v.slice(0, 3)}-${v.slice(3, 6)}-${v.slice(6)}`;
+    }
+  } else if (v.length > 10) {
+    maskValue = `${v.slice(0, 3)}-${v.slice(3, 7)}-${v.slice(7)}`;
+  }
+
+  return maskValue;
+}
+
+/**
+ * 주민등록번호 포맷 마스크
+ * @util
+ * @param {string | number} value
+ * @return {string}
+ * @desc
+ * - 규칙: 999999-9999999
+ */
+export function maskResidentCode(value: string | number): string {
+  // 입력값
+  const originValue = String(value).replace(/[^0-9]/g, "");
+
+  if (isNaN(Number(originValue))) return originValue;
+
+  // 11자리 제한
+  const v = originValue.length > 6 ? originValue.slice(0, 6) : originValue;
+  return v.length > 6 ? v.slice(0, 6) : v;
+
+  let maskValue = v;
+
+  // 999999-9999999
+  if (6 < v.length) {
+    maskValue = `${v.slice(0, 6)}-${v.slice(6)}`;
+  }
+
+  return maskValue;
+}
+
+/**
+ * 사업자등록번호 포맷 마스크
+ * @util
+ * @param {string | number} value
+ * @return {string}
+ * @desc
+ * - 규칙: 999-99-99999
+ */
+export function maskBusinessCode(value: string | number): string {
+  // 입력값
+  const originValue = String(value).replace(/[^0-9]/g, "");
+
+  if (isNaN(Number(originValue))) return originValue;
+
+  // 11자리 제한
+  const v = originValue.length > 10 ? originValue.slice(0, 10) : originValue;
+
+  let maskValue = v;
+
+  // 999-99-99999
+  if (3 < v.length && v.length < 6) {
+    maskValue = `${v.slice(0, 3)}-${v.slice(3)}`;
+  } else if (6 <= v.length) {
+    maskValue = `${v.slice(0, 3)}-${v.slice(3, 5)}-${v.slice(5)}`;
+  }
+
+  return maskValue;
+}
+
+/**
+ * 1,000단위 숫자 구분 comma (decimal separator)
+ * @util
+ * @param {string | number} value
+ * @param {Intl.NumberFormatOptions} options
+ * @return {string}
+ */
+export function maskDecimalSeparator(
+  value: string | number,
+  options?: Intl.NumberFormatOptions,
+): string {
+  // 입력값
+  const pureNumberValue = String(value).replace(/[^0-9.-]/g, "");
+
+  if (isNaN(Number(pureNumberValue))) return pureNumberValue;
+
+  const originValue = String(value).replace(/[^0-9,.-]/g, "");
+  const isPoint =
+    originValue !== "" && originValue.indexOf(".") === originValue.length - 1;
+
+  const v = String(value).replace(/[^0-9.-]/g, "");
+  if (isNaN(Number(v))) return String(originValue);
+
+  return v === ""
+    ? ""
+    : `${new Intl.NumberFormat("en-US", {
+        style: "decimal",
+        ...options,
+      }).format(Number(v))}${isPoint ? "." : ""}`;
+}
+
+/**
+ * 날짜 표현
+ * @util
+ * @param {string | number} value
+ * @return {string}
+ * @desc
+ * - 규칙 : 9999-99-99
+ */
+export function maskDate(value: string | number): string {
+  // 입력값
+  const originValue = String(value).replace(/[^0-9]/g, "");
+
+  if (isNaN(Number(originValue))) return originValue;
+
+  // 8자리 제한
+  const v = originValue.length > 8 ? originValue.slice(0, 8) : originValue;
+
+  let maskValue = v;
+
+  // 9999.99.99.
+  if (4 < v.length && v.length < 7) {
+    maskValue = `${v.slice(0, 4)}-${v.slice(4)}`;
+  } else if (7 <= v.length) {
+    maskValue = `${v.slice(0, 4)}-${v.slice(4, 6)}-${v.slice(6)}`;
+  }
+
+  return maskValue;
+}

package/src/functions/reg-exp.ts

@@ -0,0 +1,26 @@
+/**
+ * 정규식 패턴으로 특수기호 제거
+ * @util
+ * @param {string} text
+ * @return {string}
+ */
+export const escapeSymbol = (text: string): string => {
+  // 정규식 패턴. 특수 문자를 찾습니다.
+  const specialCharPattern = /([.*+?^${}()|[\]\\])/g;
+
+  // 텍스트에서 특수 문자를 찾아서 escape 처리합니다.
+  const escapedText = text.replace(specialCharPattern, "\\$1");
+
+  return escapedText;
+};
+
+/**
+ * 정규식 패턴으로 따옴표 제거
+ * @util
+ * @param {string} text
+ * @return {string}
+ */
+export const escapeQuotes = (text: string): string => {
+  const quotesPattern = /["']/g;
+  return text.replace(quotesPattern, "");
+};

package/src/functions/route.ts

@@ -0,0 +1,46 @@
+import type { SitemapDataType, SitemapMatchDataType } from "@uniai/types";
+
+/**
+ * 현재 경로와 가장 근접한 경로 데이터 추출
+ * @param {SitemapDataType[]} routes 사이트맵 배열 데이터
+ * @param {string} currentPath 현재 경로
+ * @return {SitemapDataType | null} 경로 데이터
+ */
+export const getClosestRoute = (
+  routes: SitemapDataType[],
+  currentPath: string,
+): SitemapDataType | null => {
+  let deepestMatch: SitemapDataType | null = null;
+  for (const route of routes) {
+    if (currentPath.startsWith(route.path)) {
+      if (!deepestMatch || route.path.length > deepestMatch.path.length) {
+        deepestMatch = route;
+      }
+    }
+  }
+  return deepestMatch;
+};
+
+/**
+ * 경로 일치 데이터 추출
+ * @util
+ * @param {SitemapDataType[]} routes 사이트맵 배열 데이터
+ * @param {string} currentPath 현재 경로
+ * @return {SitemapDataType | undefined} 경로 데이터
+ */
+export const getMatchRoute = (
+  routes: SitemapDataType[],
+  currentPath: string,
+): SitemapMatchDataType => {
+  const res: SitemapMatchDataType = { category: null, depth: null };
+
+  // 1 depth
+  res.category = getClosestRoute(routes, currentPath);
+
+  // 2 depth
+  if (res.category && res.category.depth) {
+    res.depth = getClosestRoute(res.category.depth, currentPath);
+  }
+
+  return res;
+};

package/src/functions/sort.ts

@@ -0,0 +1,71 @@
+/**
+ * 오름차순 정렬
+ * @util
+ * @param {string | number | null} a
+ * @param {string | number | null} b
+ */
+export const sortAsc = (
+  a: string | number | null,
+  b: string | number | null,
+) => {
+  if (a === null || b === null) {
+    if (a === null && b !== null) return 1;
+    if (a !== null && b === null) return -1;
+    return 0;
+  }
+  return a < b ? -1 : a > b ? 1 : 0;
+};
+
+/**
+ * 내림차순 정렬
+ * @util
+ * @param {string | number | null} a
+ * @param {string | number | null} b
+ */
+export const sortDesc = (
+  a: string | number | null,
+  b: string | number | null,
+) => {
+  if (a === null || b === null) {
+    if (a === null && b !== null) return 1;
+    if (a !== null && b === null) return -1;
+    return 0;
+  }
+  return a > b ? -1 : a < b ? 1 : 0;
+};
+
+/**
+ * 날짜순 오름차순 정렬
+ * @util
+ * @param {Date | number | string | null} a
+ * @param {Date | number | string | null} b
+ */
+export const sortDateAsc = (
+  a: string | number | Date | null,
+  b: string | number | Date | null,
+) => {
+  if (a === null || b === null) {
+    if (a === null && b !== null) return 1;
+    if (a !== null && b === null) return -1;
+    return 0;
+  }
+  return sortAsc(new Date(a).getTime(), new Date(b).getTime());
+};
+
+/**
+ * 날짜순 내림차순 정렬
+ * @util
+ * @param {Date | number | string | null} a
+ * @param {Date | number | string | null} b
+ */
+export const sortDateDesc = (
+  a: string | number | Date | null,
+  b: string | number | Date | null,
+) => {
+  if (a === null || b === null) {
+    if (a === null && b !== null) return 1;
+    if (a !== null && b === null) return -1;
+    return 0;
+  }
+  return sortDesc(new Date(a).getTime(), new Date(b).getTime());
+};