@uniai-fe/util-functions 0.0.1 → 0.1.0

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2025 UNIAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+This project includes third-party software governed by additional licenses,
+including Apache License 2.0. Refer to `THIRD_PARTY_NOTICES.md` for the full
+text of those notices and any required attributions.

package/README.md

@@ -0,0 +1,15 @@
+# util / functions
+
+의존성을 최소화한 범용 도구 모음
+
+## 타입 선언 관리 메모
+
+- 내부 타입 정의는 `.d.ts` 대신 `.ts` 모듈(예: `src/core/format/types.ts`)로 유지합니다.
+- tsup 번들 과정에서 선언 전용 파일이 엔트리에 포함되면 경고가 발생할 수 있어,
+  `.ts` 모듈로 import/export 하되 TypeScript가 컴파일 시 타입만 제거하도록 위임합니다.
+
+## Next.js 유틸 안내
+
+- Next 서버 전용 API 도우미는 `@uniai-fe/util-next` 패키지로 이동했습니다.
+- 환경 구성(`api-infra.config.ts`)을 통해 도메인을 주입한 뒤 util-functions의 공용 API 헬퍼를 활용하세요.
+- JSX/파일 등 React 의존 유틸은 `@uniai-fe/util-react` 패키지에서 제공됩니다.

package/dist/api/index.cjs

@@ -0,0 +1,235 @@
+'use strict';
+
+// src/validation/module.ts
+var isValidDateNumber = (dateNumber) => {
+  const DATE_MIN = 16724988e5;
+  const DATE_MAX = 48281724e5;
+  return DATE_MIN < dateNumber && dateNumber < DATE_MAX;
+};
+var isValidDateType = (date) => {
+  if (!date) return false;
+  if (typeof date === "string" || typeof date === "number" && isValidDateNumber(date) || date instanceof Date)
+    return new Date(date) instanceof Date && !isNaN(new Date(date).valueOf());
+  return false;
+};
+var correctTimezone = (date) => {
+  const utc = new Date(date).getTime() + new Date(date).getTimezoneOffset() * 6e4;
+  return new Date(utc + 9 * 60 * 6e4);
+};
+var dateFormat = (date, options) => {
+  if (isValidDateType(date)) {
+    const d = new Date(date);
+    correctTimezone(d);
+    const defaultDateFormat = `${d.getFullYear()}-${convert2Digit(d.getMonth() + 1)}-${convert2Digit(d.getDate())}`;
+    const onlyDate = defaultDateFormat || "";
+    return onlyDate;
+  }
+  return String(date);
+};
+
+// src/convert/module.ts
+var isKeyChainRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value) && typeof value !== "function";
+var string = (value) => {
+  if (typeof value === "string") return value;
+  return JSON.stringify(value);
+};
+var convertObjectToSearchParams = (data) => {
+  if (!data) {
+    console.log("[convertObjectToSearchParams] \uB370\uC774\uD130\uAC00 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC74C", {
+      data
+    });
+    return new URLSearchParams();
+  }
+  if (data instanceof URLSearchParams) {
+    return data;
+  }
+  if (isKeyChainRecord(data) && Object.keys(data).length > 0) {
+    const d = Object.fromEntries(
+      Object.entries(data).map(([key, value]) => [
+        key,
+        string(value)
+      ])
+    );
+    return new URLSearchParams(d);
+  }
+  console.log("[convertObjectToSearchParams] \uB370\uC774\uD130\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D8", {
+    data,
+    type: typeof data,
+    key: isKeyChainRecord(data) ? Object.keys(data) : [],
+    array: Array.isArray(data)
+  });
+  return new URLSearchParams();
+};
+var convert2Digit = (date_time) => date_time < 10 ? `0${date_time}` : String(date_time);
+
+// src/api/module.ts
+var defaultLogger = (method, routeUrl, queryUrl, ...messages) => {
+  if (process.env.NODE_ENV === "production") return;
+  const DATE = dateFormat(/* @__PURE__ */ new Date());
+  const TIME = new Intl.DateTimeFormat("en-US", {
+    hour: "numeric",
+    minute: "numeric",
+    second: "numeric",
+    hour12: false
+  }).format(/* @__PURE__ */ new Date()) + "." + (/* @__PURE__ */ new Date()).getMilliseconds();
+  const REQUEST_METHOD = method.split("-")[0]?.toUpperCase() || "-";
+  const RESPONSE_METHOD = method.split("-")[1] ? method.split("-")[1]?.toUpperCase() || "-" : REQUEST_METHOD;
+  return console.log(
+    `
+`,
+    `[Backend API] \u23F1 ${DATE} ( ${TIME} )`,
+    `
+  \u03BB [${REQUEST_METHOD}] FE route`,
+    `
+   ${routeUrl}`,
+    ...queryUrl ? [`
+  \u2550\u23F5 \u03A9 [${RESPONSE_METHOD}] BE url`, `
+   ${queryUrl}`, `
+`] : [],
+    ...messages?.[0] ? [` \u25C7-`, ...messages] : [],
+    `
+`
+  );
+};
+var getFetchOptions = ({
+  method,
+  headers,
+  body
+}) => {
+  const option = { method };
+  if (typeof headers !== "undefined") Object.assign(option, { headers });
+  if (typeof body !== "undefined") Object.assign(option, { body });
+  return option;
+};
+var getQueryString = (searchParams) => {
+  if (typeof searchParams === "undefined" || convertObjectToSearchParams(searchParams).toString() === "")
+    return "";
+  return `?${convertObjectToSearchParams(searchParams).toString()}`;
+};
+var resolveDomain = (infra, explicitDomain, resolver) => {
+  if (typeof explicitDomain === "string" && explicitDomain)
+    return explicitDomain;
+  if (typeof infra === "undefined") {
+    throw new Error(
+      "[createBackendApiClient] infra \uAC00 \uC9C0\uC815\uB418\uC9C0 \uC54A\uC544 \uB3C4\uBA54\uC778\uC744 \uD574\uC11D\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."
+    );
+  }
+  const domain = resolver(infra);
+  if (!domain) {
+    throw new Error(
+      `[createBackendApiClient] \uB3C4\uBA54\uC778\uC744 \uD574\uC11D\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. (infra: ${infra})`
+    );
+  }
+  return domain;
+};
+var createBackendApiClient = (config) => {
+  const baseLogger = config.logger ?? defaultLogger;
+  const generateBackendQueryUrl_GET = ({
+    infra,
+    domain,
+    routeUrl,
+    queryUrl,
+    searchParams,
+    log,
+    logDisabled,
+    logger
+  }) => {
+    const resolvedDomain = resolveDomain(infra, domain, config.resolveDomain);
+    const url = `${resolvedDomain}${queryUrl}${getQueryString(searchParams)}`;
+    const logFn = logger ?? baseLogger;
+    if (!logDisabled)
+      logFn("get", routeUrl, url, {
+        ...log,
+        ...searchParams ? searchParams : {}
+      });
+    return url;
+  };
+  const fetchBackendQuery = async ({
+    infra,
+    domain,
+    routeUrl,
+    queryUrl,
+    method,
+    headers,
+    body,
+    bodyOriginData,
+    queryStringData,
+    log,
+    logDisabled,
+    fetchDisabled,
+    logger
+  }) => {
+    const resolvedDomain = resolveDomain(infra, domain, config.resolveDomain);
+    const url = `${resolvedDomain}${queryUrl}${getQueryString(queryStringData)}`;
+    const errRes = {
+      is_ok: false,
+      idx: "",
+      error: ""
+    };
+    const bodyData = convertObjectToSearchParams(bodyOriginData);
+    if (typeof bodyOriginData !== "undefined" && bodyData.toString() === "") {
+      if (!logDisabled) {
+        (logger ?? baseLogger)(method.toLowerCase(), routeUrl, url, {
+          state: "ERROR (BODY - ORIGIN DATA)",
+          error: "\uB370\uC774\uD130\uAC00 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
+          bodyOriginData,
+          ...log
+        });
+      }
+      errRes.error = "\uB370\uC774\uD130\uAC00 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.";
+      return errRes;
+    }
+    const option = getFetchOptions({
+      method,
+      headers,
+      body
+    });
+    if (!body && typeof bodyOriginData !== "undefined")
+      Object.assign(option, { body: bodyData });
+    const logFn = logger ?? baseLogger;
+    if (!logDisabled) {
+      logFn(method.toLowerCase(), routeUrl, url, {
+        state: "READY",
+        ...option,
+        ...log
+      });
+    }
+    if (fetchDisabled) {
+      errRes.error = "API \uC694\uCCAD\uC81C\uD55C \uD65C\uC131\uD654\uB428.";
+      return errRes;
+    }
+    try {
+      const res = await (await fetch(url, option)).json();
+      if (!logDisabled) {
+        const isSuccess = "is_ok" in res && typeof res?.is_ok === "boolean" && res.is_ok === true;
+        logFn(method.toLowerCase(), routeUrl, url, {
+          state: isSuccess ? "SUCCESS" : "FAIL",
+          ...res
+        });
+      }
+      return res;
+    } catch (error) {
+      errRes.error = error instanceof Error ? error.message || "\uC54C \uC218 \uC5C6\uB294 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD558\uC600\uC2B5\uB2C8\uB2E4." : String(error);
+      if (!logDisabled) {
+        logFn(method.toLowerCase(), routeUrl, url, {
+          state: "ERROR (RESPONSE)",
+          error,
+          ...log
+        });
+      }
+      return errRes;
+    }
+  };
+  return {
+    getQueryString,
+    generateBackendQueryUrl_GET,
+    fetchBackendQuery,
+    logger: baseLogger
+  };
+};
+
+exports.createBackendApiClient = createBackendApiClient;
+exports.defaultApiLogger = defaultLogger;
+exports.getQueryString = getQueryString;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/api/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/validation/module.ts","../../src/format/module.ts","../../src/convert/module.ts","../../src/api/module.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * validation; 인덱스 데이터 체크\n * @util\n * @validation\n * @param {string | number} idxValue 인덱스 데이터\n * @return {boolean}\n */\nimport type {\n  BuildingNoListString,\n  NullableNumericIdentifier,\n  NumericIdentifier,\n  TimeFormatString,\n} from \"./type\";\n\nexport const isValidIdx = (idxValue?: NumericIdentifier): boolean =>\n  typeof idxValue !== \"undefined\" &&\n  idxValue !== \"\" &&\n  !isNaN(Number(idxValue)) &&\n  Number(idxValue) > 0;\n\n/**\n * validation; 배열 데이터 체크\n * @util\n * @validation\n * @param {unknown} array 배열 데이터\n * @return {boolean}\n */\nexport const isValidArray = (array?: unknown): boolean =>\n  typeof array !== \"undefined\" && Array.isArray(array);\n\n/**\n * validation; 사업자등록번호 데이터 체크\n * @util\n * @validation\n * @param {unknown} businessCode 농장 사업자등록번호\n * @return {boolean}\n */\nexport const isValidBusinessCode = (businessCode: unknown): boolean => {\n  if (!businessCode) return false;\n  if (String(businessCode).length === 10) return !isNaN(Number(businessCode));\n  return false;\n};\n\n/**\n * validation; 날짜 변환을 허용할 유효 number 시간값 체크\n * @util\n * @validation\n * @param {number} dateNumber\n * @return {boolean}\n */\nexport const isValidDateNumber = (dateNumber: number): boolean => {\n  const DATE_MIN = 1672498800000; // 2023-01-01T00:00:00\n  const DATE_MAX = 4828172400000; // 2123-01-01T00:00:00\n  return DATE_MIN < dateNumber && dateNumber < DATE_MAX;\n};\n\n/**\n * validation; 날짜 데이터 체크\n * @util\n * @validation\n * @param {unknown} date 날짜\n * @return {boolean}\n */\nexport const isValidDateType = (date: unknown): boolean => {\n  if (!date) return false;\n  if (\n    typeof date === \"string\" ||\n    (typeof date === \"number\" && isValidDateNumber(date)) ||\n    date instanceof Date\n  )\n    return new Date(date) instanceof Date && !isNaN(new Date(date).valueOf());\n  return false;\n};\n\n/**\n * validation; uuidx 계군 식별코드 데이터 체크\n * @util\n * @validation\n * @param {string} uuidx 계군 식별코드\n * @return {boolean}\n */\nexport const isValidUuidx = (uuidx?: string): boolean =>\n  typeof uuidx !== \"undefined\" && uuidx !== \"\";\n\n/**\n * validation; 사육동 번호 데이터 체크\n * @util\n * @validation\n * @param {string | number} buildingNo 사육동 번호\n * @return {boolean}\n */\nexport const isValidBuildingNo = (\n  buildingNo?: NullableNumericIdentifier,\n): boolean =>\n  typeof buildingNo !== \"undefined\" &&\n  buildingNo !== \"\" &&\n  !isNaN(Number(buildingNo)) &&\n  Number(buildingNo) > 0;\n\n/**\n * validation; building_no_s 사육동 번호 복수형 데이터 체크\n * @util\n * @validation\n * @param {string} buildingNoList 사육동 번호 1,2,4,...\n * @return {boolean}\n */\nexport const isValidBuildingNoList = (\n  buildingNoList?: BuildingNoListString,\n): boolean =>\n  typeof buildingNoList === \"string\" &&\n  buildingNoList !== \"\" &&\n  buildingNoList.split(\",\").length > 0;\n\n/**\n * validation; 숫자 데이터 체크\n * @util\n * @validation\n * @param {unknown} value 숫자 확인 데이터\n * @return {boolean}\n */\nexport const isValidNumber = (value: unknown): boolean =>\n  typeof value !== \"undefined\" && !isNaN(Number(value)) && value !== \"\";\n\n/**\n * validation; 카테고리 이름이 업체인지 여부\n * @util\n * @validation\n * @param {string} categoryName 카테고리 이름\n * @return {boolean}\n */\nexport const isValidFirmCategory = (categoryName?: string): boolean =>\n  typeof categoryName === \"string\" &&\n  /[농장|정부기관|유통사|수의사|병성기관|부화장|도계장|사료|약품|유니아이]/.test(\n    categoryName,\n  );\n\n/**\n * validation; 카테고리 이름이 약품/사료인지 여부\n * @util\n * @validation\n * @param {string} categoryName 카테고리 이름\n * @return {boolean}\n */\nexport const isValidFeedMedicineCategory = (categoryName?: string): boolean =>\n  typeof categoryName === \"string\" && /[약품|사료]/.test(categoryName);\n\n/**\n * validation; 시간 데이터 HH:MM:SS 포맷 체크\n * @util\n * @validation\n * @param {string} time\n * @return {boolean}\n */\nexport const isValidTimeStringFormat = (time: TimeFormatString): boolean => {\n  const hms = time.split(\":\");\n  if (hms.length !== 3 || hms.some(t => isNaN(Number(t)))) return false;\n\n  // hour\n  if (Number(hms[0]) < 0 || Number(hms[0]) > 24) return false;\n  // minutes\n  if (Number(hms[1]) < 0 || Number(hms[1]) > 59) return false;\n  // seconds\n  if (Number(hms[2]) < 0 || Number(hms[2]) > 59) return false;\n\n  return true;\n};\n","import { convert2Digit } from \"../convert/module\";\nimport { maskPhone } from \"../mask/module\";\nimport { isValidDateType } from \"../validation/module\";\nimport type { DateTimeFormatOptionsType, DurationFormatOptions } from \"./type\";\n\n/**\n * comma 마스킹된 숫자 Number 타입으로 변환\n * @util\n * @param {number | string} value 타입 변환 값\n * @param {boolean} [isString]\n * @return {number | string}\n */\nexport const getNumberReplaceComma = (\n  value: unknown,\n  isString?: boolean,\n): number | string => {\n  if (\n    ![\"number\", \"string\"].includes(typeof value) ||\n    value === null ||\n    value === \"\"\n  )\n    return \"\";\n\n  if (typeof value === \"number\") return value;\n\n  const v = Number(String(value).replace(/[^0-9.-]/g, \"\"));\n  if (isNaN(Number(v))) return isString ? \"\" : 0;\n\n  return isString ? String(v) : v;\n};\n\n/**\n * 수량을 1000단위로 comma표기\n * @util\n * @param {unknown} value 숫자\n * @param {number} [digit] 소수점 자리수 고정 옵션\n * @return {string}\n */\nexport const lengthFormat = (value: unknown, digit?: number): string => {\n  if (\n    ![\"number\", \"string\"].includes(typeof value) ||\n    value === null ||\n    value === \"\"\n  )\n    return \"-\";\n\n  if (isNaN(Number(getNumberReplaceComma(value)))) return String(value);\n\n  // 소수점 고정 옵션\n  const digitOptions: Intl.NumberFormatOptions =\n    typeof digit === \"number\"\n      ? { minimumFractionDigits: digit, maximumFractionDigits: digit }\n      : {};\n\n  return new Intl.NumberFormat(\"en-US\", digitOptions).format(Number(value));\n};\n\n/**\n * 날짜 사용 옵션\n */\nconst DATE_FULL_OPTION: Intl.DateTimeFormatOptions = {\n  year: \"numeric\",\n  month: \"2-digit\",\n  day: \"2-digit\",\n};\n\n/**\n * 날짜 사용 안함 옵션\n */\nconst NO_DATE_OPTION: Intl.DateTimeFormatOptions = {\n  year: undefined,\n  month: undefined,\n  day: undefined,\n};\n\n/**\n * 24시간 사용 옵션\n */\nconst TIME_FULL_OPTION: Intl.DateTimeFormatOptions = {\n  hour12: false,\n  hour: \"2-digit\",\n  minute: \"2-digit\",\n  second: \"2-digit\",\n};\n\n/**\n * 시간 사용 안함 옵션\n */\nconst NO_TIME_OPTION: Intl.DateTimeFormatOptions = {\n  hour: undefined,\n  minute: undefined,\n  second: undefined,\n};\n\n/**\n * 접속위치에 따른 시간대 보정\n * @util\n * @param {Date} date 보정할 시간\n * @return {Date} 보정된 시간\n */\n// 변경: correctTimezone 함수를 UTC 산출 후 KST로 변경\nexport const correctTimezone = (date: string | Date): Date => {\n  const utc =\n    new Date(date).getTime() + new Date(date).getTimezoneOffset() * 60000;\n  return new Date(utc + 9 * 60 * 60000);\n};\n\n/**\n * Date 타입 데이터를 yyyy-mm-dd로 변환\n * @util\n * @param {unknown} date\n * @param {DateTimeFormatOptionsType} [options]\n * @param {Intl.LocalesArgument} [options.formatTimezone] 시간 기준; 기본값 ko-KR\n * @param {Intl.DateTimeFormatOptions} [options.formatOptions]\n * @param {boolean | boolean[]} [options.isKorean] // ymd 또는 [year, month?, day?]\n * @param {boolean} [options.isCorrection] 시간 보정\n * @param {boolean} [options.isISOString] ISO 문자열\n * @return {string} yyyy-mm-dd 또는 각 옵션에 대한 날짜포맷\n */\n// 변경: dateFormat 함수에서 isCorrection 옵션 사용 시 toISOString()의 결과를 슬라이스하여 \"YYYY-MM-DDTHH:MM:SS\" 형식 반환\nexport const dateFormat = (\n  date: unknown,\n  options?: Partial<DateTimeFormatOptionsType>,\n): string => {\n  if (isValidDateType(date)) {\n    const d = new Date(date as string | number | Date);\n    const corrDate = correctTimezone(d);\n\n    // toISOString()으로 변환 시, KST 적용되지 않음\n    const defaultDateFormat = options?.isCorrection\n      ? `${corrDate.getFullYear()}-${convert2Digit(corrDate.getMonth() + 1)}-${convert2Digit(corrDate.getDate())}`\n      : `${d.getFullYear()}-${convert2Digit(d.getMonth() + 1)}-${convert2Digit(d.getDate())}`;\n\n    if (options?.isISOString) return defaultDateFormat;\n\n    const onlyDate = defaultDateFormat || \"\";\n\n    if (options?.isKorean) {\n      const [y, m, d] = onlyDate.split(\"-\");\n      if (options.isKorean === true) return `${y}년 ${m}월 ${d}일`;\n      const __ymd = options.isKorean.map((apply, index) => {\n        switch (index) {\n          case 0:\n            return apply ? `${y}년` : \"\";\n          case 1:\n            return apply ? `${m}월` : \"\";\n          case 2:\n            return apply ? `${d}일` : \"\";\n          default:\n            return \"\";\n        }\n      });\n      return __ymd.join(\" \");\n    }\n\n    if (typeof options?.formatOptions !== \"undefined\")\n      return new Intl.DateTimeFormat(\n        options?.formatTimezone ? options.formatTimezone : \"ko-KR\",\n        { ...DATE_FULL_OPTION, ...options.formatOptions, ...NO_TIME_OPTION },\n      ).format(d);\n    return onlyDate;\n  }\n  return String(date);\n};\n\n/**\n * Date 타입 데이터를 HH:MM:SS 시간으로 변환\n * @util\n * @param {unknown} date\n * @param {DateTimeFormatOptionsType} [options]\n * @param {Intl.LocalesArgument} [options.formatTimezone] 시간 기준; 기본값 ko-KR\n * @param {Intl.DateTimeFormatOptions} [options.formatOptions]\n * @param {boolean | boolean[]} [options.isKorean] // ymd 또는 [year, month?, day?]\n * @param {boolean} [options.isCorrection] 시간 보정\n * @param {boolean} [options.isISOString] ISO 문자열\n * @return {string} HH:MM:SS\n */\n// 변경: timeFormat 함수에서 isCorrection 옵션 사용 시 toISOString()의 시간 부분만 슬라이스하여 \"HH:MM:SS\" 형식 반환\nexport const timeFormat = (\n  date: unknown,\n  options?: Partial<DateTimeFormatOptionsType>,\n): string => {\n  if (isValidDateType(date)) {\n    const d = new Date(date as string | number | Date);\n\n    if (options?.isKST) {\n      const utc = d.getTime() + 60 * 60 * 1000 * 9;\n      d.setTime(utc);\n    }\n\n    const defaultDateFormat = options?.isCorrection\n      ? correctTimezone(d).toISOString().split(\"T\")[1].split(\".\")[0]\n      : new Intl.DateTimeFormat(\"en-US\", {\n          ...TIME_FULL_OPTION,\n          ...NO_DATE_OPTION,\n        }).format(d);\n\n    if (options?.isISOString) return defaultDateFormat;\n\n    const onlyDate = defaultDateFormat || \"\";\n\n    if (options?.isKorean) {\n      const [hr, min, sec] = onlyDate.split(\":\");\n      if (options.isKorean === true) return `${hr}시간 ${min}분 ${sec}초`;\n      const __hms = options.isKorean.map((apply, index) => {\n        switch (index) {\n          case 0:\n            return apply ? `${hr}시간` : \"\";\n          case 1:\n            return apply ? `${min}분` : \"\";\n          case 2:\n            return apply ? `${d}초` : \"\";\n          default:\n            return \"\";\n        }\n      });\n      return __hms.join(\" \");\n    }\n\n    if (typeof options?.formatOptions !== \"undefined\") {\n      const res = new Intl.DateTimeFormat(\n        options?.formatTimezone ? options.formatTimezone : \"ko-KR\",\n        { ...TIME_FULL_OPTION, ...options.formatOptions, ...NO_DATE_OPTION },\n      ).format(d);\n\n      // console.log(\"res\", res);\n      return res;\n    }\n\n    return onlyDate;\n  }\n  return String(date);\n};\n\n/**\n * 소요시간 변환\n * @util\n * @param {number | null} duration 초 단위 시간값\n */\nexport const durationFormat = (\n  duration: number | null,\n  options?: Partial<DurationFormatOptions>,\n): string => {\n  if (duration === null) return String(duration);\n\n  const hours: number | null =\n    options?.hours === false ? null : Math.floor(duration / (60 * 60));\n  const minutes: number | null =\n    options?.minutes === false ? null : Math.floor((duration % (60 * 60)) / 60);\n  const seconds: number | null =\n    options?.seconds === false ? null : duration % 60;\n\n  const HH = hours !== null ? `${hours}시간 ` : \"\";\n  const MM = minutes !== null ? `${minutes}분 ` : \"\";\n  const SS = seconds !== null ? `${seconds}초` : \"\";\n\n  return `${HH}${MM}${SS}`.trim();\n};\n\n/**\n * 전화번호 타입 데이터로 변환\n * @util\n * @param {string | number} value\n * @return {string}\n * @desc\n * - 규칙: [\n *      999-9999(7),\n *      9999-9999(8),\n *      99-999-9999(9),\n *      99-9999-9999(10),\n *      999-999-9999(10),\n *      999-9999-9999(11),\n *    ];\n * - 지역번호 구분:\n *    01X: 휴대전화\n *    02 ~ 0XX: 지역번호\n */\nexport const phoneNumberFormat = maskPhone;\n\n/**\n * 정수 숫자를 +/-를 붙인 형태로 변환\n * @util\n * @param {unknown} value\n * @param {boolean} [isMaskLength] 길이 마스킹 여부\n * @return {string}\n */\nexport const deltaFormat = (\n  value: unknown,\n  digit: number = 0,\n  isMaskLength: boolean = true,\n): string => {\n  if (typeof value === \"undefined\" || value === null || isNaN(Number(value)))\n    return \"-\";\n\n  const v = Number(value);\n\n  if (v > 0) return isMaskLength ? `+${lengthFormat(v, digit)}` : `+${v}`;\n  return lengthFormat(v, digit);\n};\n\n/**\n * 거리를 m 또는 km로 변환\n * @util\n * @param {number | null} distance\n * @return {string}\n */\nexport const distanceFormat = (\n  distance: number | null,\n  isUseUnit: boolean = true,\n): string => {\n  if (distance === null) return \"-\";\n  if (distance < 1000) return `${distance}${isUseUnit ? \"m\" : \"\"}`;\n  return `${Math.floor(distance / 1000)}${isUseUnit ? \"km\" : \"\"}`;\n};\n","import { isValidDateType } from \"../validation/module\";\nimport { dateFormat } from \"../format/module\";\nimport type { KeyChainRecord } from \"./type\";\n\nconst isKeyChainRecord = (value: unknown): value is KeyChainRecord =>\n  typeof value === \"object\" &&\n  value !== null &&\n  !Array.isArray(value) &&\n  typeof value !== \"function\";\n\n/**\n * 데이터를 스트링으로 변환\n * @util\n * @param {unknown} value\n * @return {string}\n */\nexport const string = (value: unknown): string => {\n  if (typeof value === \"string\") return value;\n  return JSON.stringify(value);\n};\n\n/**\n * 세션/로컬 스토리지 데이터 parsing\n * @util\n * @param {string} data 세션/로컬 스토리지 데이터\n * @return {unknown}\n */\nexport const parseData = (data: string): unknown => {\n  // 괄호 여부 -> object | array\n  if (/^(\\{|\\[)/.test(data)) return JSON.parse(data);\n  // 숫자 여부 -> number\n  else if (!isNaN(Number(data))) return Number(data);\n  // 불리언 여부 -> boolean\n  else if (data === \"true\" || data === \"false\") return JSON.parse(data);\n  // undefined\n  else if (data === \"undefined\") return undefined;\n\n  return data; // string\n};\n\n/**\n * 키체인에 해당하는 데이터 추출\n * @util\n * @param {unknown} data 세션/로컬 스토리지 데이터\n * @param {string} keyChain 키체인\n * @return {unknown}\n */\nexport const getValueByKeyChain = (\n  data: unknown,\n  keyChain: string,\n): unknown => {\n  // 프로퍼티를 가진 객체인지 확인\n  if (isKeyChainRecord(data)) {\n    // 키 체인이 남았는지 확인\n    const firstChainIndex: number = keyChain.indexOf(\".\");\n    if (firstChainIndex === -1)\n      return data[keyChain as keyof KeyChainRecord];\n\n    // 키 체인이 끝나지 않은 경우\n    const currentKey: string = keyChain.slice(0, firstChainIndex);\n    const remainKeyChain: string = keyChain.slice(firstChainIndex + 1);\n    const foundData = data[currentKey as keyof KeyChainRecord];\n    return isKeyChainRecord(foundData)\n      ? getValueByKeyChain(foundData, remainKeyChain)\n      : undefined;\n  }\n\n  return data;\n};\n\n/**\n * object -> URLSearchParams 데이터 변환\n * @param {unknown} data\n * @return {URLSearchParams | string}\n */\nexport const convertObjectToSearchParams = (data: unknown): URLSearchParams => {\n  if (!data) {\n    console.log(\"[convertObjectToSearchParams] 데이터가 유효하지 않음\", {\n      data,\n    });\n    return new URLSearchParams();\n  }\n  if (data instanceof URLSearchParams) {\n    return data;\n  }\n\n  if (isKeyChainRecord(data) && Object.keys(data).length > 0) {\n    const d = Object.fromEntries(\n      Object.entries(data).map(([key, value]) => [\n        key,\n        string(value),\n      ]),\n    );\n    return new URLSearchParams(d);\n  }\n\n  console.log(\"[convertObjectToSearchParams] 데이터가 객체가 아님\", {\n    data,\n    type: typeof data,\n    key: isKeyChainRecord(data) ? Object.keys(data) : [],\n    array: Array.isArray(data),\n  });\n  return new URLSearchParams();\n};\n\n// /**\n//  * 배열 추가형 입력 테이블 register rule 필터링\n//  * @util\n//  * @param {RegisterOptionsType} ruleCollection\n//  * @param {boolean} isActive\n//  * @return {RegisterOptionsType}\n//  */\n// export function getFieldArrayValidOptions(\n//   ruleCollection: RegisterOptionsType,\n//   isActive: boolean,\n// ): RegisterOptionsType {\n//   const entries = Object.entries(ruleCollection);\n//   const filtered = entries.map(([dataName, rule]) => {\n//     const ruleEntries = Object.entries(rule).filter(\n//       ([ruleKey]) => ruleKey !== \"required\",\n//     );\n//     return [dataName, Object.fromEntries(ruleEntries)];\n//   });\n\n//   return isActive ? ruleCollection : Object.fromEntries(filtered);\n// }\n\n/**\n * 텍스트 capitalize 첫글자 대문자 변환\n * @util\n * @param {string} value 텍스트\n * @return {string}\n */\nexport const capitalize = (value: string): string => {\n  const first = value.charAt(0).toUpperCase();\n  const others = value.slice(1);\n  return `${first}${others}`;\n};\n\n/**\n * kg -> g 변환\n * @util\n * @param {number | string} kg\n * @return {number} gram\n */\nexport const covertGram = (kg: number | string): number => Number(kg) * 1000;\n\n/**\n * g -> kg 변환\n * @util\n * @param {number | string} gram\n * @return {number} kg\n */\nexport const covertKilogram = (gram: number | string): number =>\n  Number(gram) / 1000;\n\n/**\n * ml -> L 변환\n * @util\n * @param {number | string} ml\n * @return {number} liter\n */\nexport const convertLiter = (ml: number | string): number => Number(ml) / 1000;\n\n/**\n * L -> ml 변환\n * @util\n * @param {number | string} liter\n * @return {number} ml\n */\nexport const convertMilliliter = (liter: number | string): number =>\n  Number(liter) * 1000;\n\n/**\n * 데이터 가공\n * @util\n * @param {unknown} value\n * @return {unknown}\n * @desc\n * - 빈칸 또는 줄바꿈 텍스트 모두 제거\n * - 날짜 데이터 yyyy-mm-ddTHH:MM:SS 변환\n */\nexport function extractCoreValue<TOriginType>(value: TOriginType): TOriginType {\n  if (isValidDateType(value)) return dateFormat(value) as TOriginType;\n  if (typeof value === \"string\")\n    return value.replace(/[\\s\\n\\t]+/g, \"\") as TOriginType;\n  return value;\n}\n\n/**\n * 자연수로 된 숫자를, 지정된 자리수만큼 0을 채워서 반환\n * @util\n * @param {number} v 소수점 제외\n * @param {number} [digitLength] 자릿수 (기본값 2)\n * @return {string}\n */\nexport function convertDigit(v: number, digitLength: number = 2): string {\n  const valueLength = String(Math.floor(v)).length;\n  const restLength = digitLength - valueLength;\n  const fill = Array(restLength).fill(0).join(\"\");\n\n  return `${fill}${v}`;\n}\n\n/**\n * 날짜 시간을 2-digit으로 맞춤\n * @util\n * @param {number} date_time\n * @return {string}\n */\nexport const convert2Digit = (date_time: number): string =>\n  date_time < 10 ? `0${date_time}` : String(date_time);\n","import { convertObjectToSearchParams } from \"../convert/module\";\nimport { dateFormat } from \"../format/module\";\nimport type {\n  ApiLogger,\n  BackendApiConfig,\n  CommonPostResponseType,\n  FetchBackendQueryOptions,\n  GenerateBackendQueryUrlOptions,\n  InfraKey,\n} from \"./type\";\n\n/**\n * 기본 API 로거.\n * 개발 환경에서만 동작하며 요청/응답 정보를 콘솔에 출력합니다.\n */\nconst defaultLogger: ApiLogger = (method, routeUrl, queryUrl, ...messages) => {\n  if (process.env.NODE_ENV === \"production\") return;\n\n  const DATE = dateFormat(new Date());\n  const TIME =\n    new Intl.DateTimeFormat(\"en-US\", {\n      hour: \"numeric\",\n      minute: \"numeric\",\n      second: \"numeric\",\n      hour12: false,\n    }).format(new Date()) +\n    \".\" +\n    new Date().getMilliseconds();\n\n  const REQUEST_METHOD = method.split(\"-\")[0]?.toUpperCase() || \"-\";\n  const RESPONSE_METHOD = method.split(\"-\")[1]\n    ? method.split(\"-\")[1]?.toUpperCase() || \"-\"\n    : REQUEST_METHOD;\n\n  return console.log(\n    `\\n`,\n    `[Backend API] ⏱ ${DATE} ( ${TIME} )`,\n    `\\n  λ [${REQUEST_METHOD}] FE route`,\n    `\\n   ${routeUrl}`,\n    ...(queryUrl\n      ? [`\\n  ═⏵ Ω [${RESPONSE_METHOD}] BE url`, `\\n   ${queryUrl}`, `\\n`]\n      : []),\n    ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n    `\\n`,\n  );\n};\n\n/**\n * fetch 호출을 위한 옵션 객체를 생성합니다.\n */\nconst getFetchOptions = ({\n  method,\n  headers,\n  body,\n}: {\n  method: string;\n} & Partial<{\n  headers: HeadersInit;\n  body: BodyInit | null;\n}>): RequestInit => {\n  const option: RequestInit = { method };\n  if (typeof headers !== \"undefined\") Object.assign(option, { headers });\n  if (typeof body !== \"undefined\") Object.assign(option, { body });\n  return option;\n};\n\n/**\n * 객체나 URLSearchParams를 쿼리스트링으로 직렬화합니다.\n */\nconst getQueryString = (searchParams?: unknown): string => {\n  if (\n    typeof searchParams === \"undefined\" ||\n    convertObjectToSearchParams(searchParams).toString() === \"\"\n  )\n    return \"\";\n\n  return `?${convertObjectToSearchParams(searchParams).toString()}`;\n};\n\n/**\n * 도메인 해석 로직을 수행합니다.\n * 명시적 도메인이 있으면 우선 사용하고, 그렇지 않으면 resolver를 호출합니다.\n */\nconst resolveDomain = <Infra extends InfraKey>(\n  infra: Infra | undefined,\n  explicitDomain: string | undefined,\n  resolver: BackendApiConfig<Infra>[\"resolveDomain\"],\n): string => {\n  if (typeof explicitDomain === \"string\" && explicitDomain)\n    return explicitDomain;\n  if (typeof infra === \"undefined\") {\n    throw new Error(\n      \"[createBackendApiClient] infra 가 지정되지 않아 도메인을 해석할 수 없습니다.\",\n    );\n  }\n  const domain = resolver(infra);\n  if (!domain) {\n    throw new Error(\n      `[createBackendApiClient] 도메인을 해석할 수 없습니다. (infra: ${infra})`,\n    );\n  }\n  return domain;\n};\n\n/**\n * 인프라 도메인 해석기와 로거를 주입받아 API 헬퍼 집합을 생성합니다.\n */\nexport const createBackendApiClient = <Infra extends InfraKey = InfraKey>(\n  config: BackendApiConfig<Infra>,\n) => {\n  const baseLogger = config.logger ?? defaultLogger;\n\n  const generateBackendQueryUrl_GET = ({\n    infra,\n    domain,\n    routeUrl,\n    queryUrl,\n    searchParams,\n    log,\n    logDisabled,\n    logger,\n  }: GenerateBackendQueryUrlOptions<Infra>): string => {\n    const resolvedDomain = resolveDomain(infra, domain, config.resolveDomain);\n    const url = `${resolvedDomain}${queryUrl}${getQueryString(searchParams)}`;\n    const logFn = logger ?? baseLogger;\n\n    if (!logDisabled)\n      logFn(\"get\", routeUrl, url, {\n        ...log,\n        ...(searchParams ? searchParams : {}),\n      });\n\n    return url;\n  };\n\n  const fetchBackendQuery = async <\n    FetchRequestType extends object,\n    FetchResponseType extends CommonPostResponseType,\n  >({\n    infra,\n    domain,\n    routeUrl,\n    queryUrl,\n    method,\n    headers,\n    body,\n    bodyOriginData,\n    queryStringData,\n    log,\n    logDisabled,\n    fetchDisabled,\n    logger,\n  }: FetchBackendQueryOptions<\n    Infra,\n    FetchRequestType\n  >): Promise<FetchResponseType> => {\n    const resolvedDomain = resolveDomain(infra, domain, config.resolveDomain);\n    const url = `${resolvedDomain}${queryUrl}${getQueryString(queryStringData)}`;\n    const errRes: FetchResponseType = {\n      is_ok: false,\n      idx: \"\",\n      error: \"\",\n    } as FetchResponseType;\n\n    const bodyData = convertObjectToSearchParams(bodyOriginData);\n\n    if (typeof bodyOriginData !== \"undefined\" && bodyData.toString() === \"\") {\n      if (!logDisabled) {\n        (logger ?? baseLogger)(method.toLowerCase(), routeUrl, url, {\n          state: \"ERROR (BODY - ORIGIN DATA)\",\n          error: \"데이터가 유효하지 않습니다.\",\n          bodyOriginData,\n          ...log,\n        });\n      }\n      errRes.error = \"데이터가 유효하지 않습니다.\";\n      return errRes;\n    }\n\n    const option: RequestInit = getFetchOptions({\n      method,\n      headers,\n      body,\n    });\n    if (!body && typeof bodyOriginData !== \"undefined\")\n      Object.assign(option, { body: bodyData });\n\n    const logFn = logger ?? baseLogger;\n    if (!logDisabled) {\n      logFn(method.toLowerCase(), routeUrl, url, {\n        state: \"READY\",\n        ...option,\n        ...log,\n      });\n    }\n\n    if (fetchDisabled) {\n      errRes.error = \"API 요청제한 활성화됨.\";\n      return errRes;\n    }\n\n    try {\n      const res: FetchResponseType = await (await fetch(url, option)).json();\n\n      if (!logDisabled) {\n        const isSuccess =\n          \"is_ok\" in res &&\n          typeof res?.is_ok === \"boolean\" &&\n          res.is_ok === true;\n\n        logFn(method.toLowerCase(), routeUrl, url, {\n          state: isSuccess ? \"SUCCESS\" : \"FAIL\",\n          ...res,\n        });\n      }\n\n      return res;\n    } catch (error: unknown) {\n      errRes.error =\n        error instanceof Error\n          ? error.message || \"알 수 없는 오류가 발생하였습니다.\"\n          : String(error);\n\n      if (!logDisabled) {\n        logFn(method.toLowerCase(), routeUrl, url, {\n          state: \"ERROR (RESPONSE)\",\n          error,\n          ...log,\n        });\n      }\n\n      return errRes;\n    }\n  };\n\n  return {\n    getQueryString,\n    generateBackendQueryUrl_GET,\n    fetchBackendQuery,\n    logger: baseLogger,\n  };\n};\n\nexport { getQueryString, defaultLogger as defaultApiLogger };\n"]}

package/dist/api/index.d.cts

@@ -0,0 +1,55 @@
+export { D as DateTimeFormatOptionsType } from '../type-CNV_n0-w.cjs';
+
+type InfraKey = "ai" | "db" | "uniai" | (string & {});
+type CommonPostResponseType = {
+    is_ok: boolean;
+    idx?: string | number;
+    uuidx?: string;
+    error: string;
+};
+type DomainResolver<Infra extends InfraKey = InfraKey> = (infra: Infra) => string | undefined;
+type ApiLogger = (method: string, routeUrl: string, queryUrl?: string, ...messages: unknown[]) => void;
+type BackendApiConfig<Infra extends InfraKey = InfraKey> = {
+    resolveDomain: DomainResolver<Infra>;
+    logger?: ApiLogger;
+};
+type GenerateBackendQueryUrlOptions<Infra extends InfraKey = InfraKey> = {
+    routeUrl: string;
+    queryUrl: string;
+    infra?: Infra;
+    domain?: string;
+    searchParams?: URLSearchParams | object;
+    log?: object;
+    logDisabled?: boolean;
+    logger?: ApiLogger;
+};
+type FetchBackendQueryOptions<Infra extends InfraKey, FetchRequestType extends object> = GenerateBackendQueryUrlOptions<Infra> & Partial<{
+    headers: HeadersInit;
+    body: BodyInit | null;
+    bodyOriginData: FetchRequestType;
+    queryStringData: FetchRequestType;
+    fetchDisabled: boolean;
+}> & {
+    method: "POST" | "DELETE";
+};
+
+/**
+ * 기본 API 로거.
+ * 개발 환경에서만 동작하며 요청/응답 정보를 콘솔에 출력합니다.
+ */
+declare const defaultLogger: ApiLogger;
+/**
+ * 객체나 URLSearchParams를 쿼리스트링으로 직렬화합니다.
+ */
+declare const getQueryString: (searchParams?: unknown) => string;
+/**
+ * 인프라 도메인 해석기와 로거를 주입받아 API 헬퍼 집합을 생성합니다.
+ */
+declare const createBackendApiClient: <Infra extends InfraKey = InfraKey>(config: BackendApiConfig<Infra>) => {
+    getQueryString: (searchParams?: unknown) => string;
+    generateBackendQueryUrl_GET: ({ infra, domain, routeUrl, queryUrl, searchParams, log, logDisabled, logger, }: GenerateBackendQueryUrlOptions<Infra>) => string;
+    fetchBackendQuery: <FetchRequestType extends object, FetchResponseType extends CommonPostResponseType>({ infra, domain, routeUrl, queryUrl, method, headers, body, bodyOriginData, queryStringData, log, logDisabled, fetchDisabled, logger, }: FetchBackendQueryOptions<Infra, FetchRequestType>) => Promise<FetchResponseType>;
+    logger: ApiLogger;
+};
+
+export { type ApiLogger, type BackendApiConfig, type CommonPostResponseType, type DomainResolver, type FetchBackendQueryOptions, type GenerateBackendQueryUrlOptions, type InfraKey, createBackendApiClient, defaultLogger as defaultApiLogger, getQueryString };

package/dist/api/index.d.ts

@@ -0,0 +1,55 @@
+export { D as DateTimeFormatOptionsType } from '../type-CNV_n0-w.js';
+
+type InfraKey = "ai" | "db" | "uniai" | (string & {});
+type CommonPostResponseType = {
+    is_ok: boolean;
+    idx?: string | number;
+    uuidx?: string;
+    error: string;
+};
+type DomainResolver<Infra extends InfraKey = InfraKey> = (infra: Infra) => string | undefined;
+type ApiLogger = (method: string, routeUrl: string, queryUrl?: string, ...messages: unknown[]) => void;
+type BackendApiConfig<Infra extends InfraKey = InfraKey> = {
+    resolveDomain: DomainResolver<Infra>;
+    logger?: ApiLogger;
+};
+type GenerateBackendQueryUrlOptions<Infra extends InfraKey = InfraKey> = {
+    routeUrl: string;
+    queryUrl: string;
+    infra?: Infra;
+    domain?: string;
+    searchParams?: URLSearchParams | object;
+    log?: object;
+    logDisabled?: boolean;
+    logger?: ApiLogger;
+};
+type FetchBackendQueryOptions<Infra extends InfraKey, FetchRequestType extends object> = GenerateBackendQueryUrlOptions<Infra> & Partial<{
+    headers: HeadersInit;
+    body: BodyInit | null;
+    bodyOriginData: FetchRequestType;
+    queryStringData: FetchRequestType;
+    fetchDisabled: boolean;
+}> & {
+    method: "POST" | "DELETE";
+};
+
+/**
+ * 기본 API 로거.
+ * 개발 환경에서만 동작하며 요청/응답 정보를 콘솔에 출력합니다.
+ */
+declare const defaultLogger: ApiLogger;
+/**
+ * 객체나 URLSearchParams를 쿼리스트링으로 직렬화합니다.
+ */
+declare const getQueryString: (searchParams?: unknown) => string;
+/**
+ * 인프라 도메인 해석기와 로거를 주입받아 API 헬퍼 집합을 생성합니다.
+ */
+declare const createBackendApiClient: <Infra extends InfraKey = InfraKey>(config: BackendApiConfig<Infra>) => {
+    getQueryString: (searchParams?: unknown) => string;
+    generateBackendQueryUrl_GET: ({ infra, domain, routeUrl, queryUrl, searchParams, log, logDisabled, logger, }: GenerateBackendQueryUrlOptions<Infra>) => string;
+    fetchBackendQuery: <FetchRequestType extends object, FetchResponseType extends CommonPostResponseType>({ infra, domain, routeUrl, queryUrl, method, headers, body, bodyOriginData, queryStringData, log, logDisabled, fetchDisabled, logger, }: FetchBackendQueryOptions<Infra, FetchRequestType>) => Promise<FetchResponseType>;
+    logger: ApiLogger;
+};
+
+export { type ApiLogger, type BackendApiConfig, type CommonPostResponseType, type DomainResolver, type FetchBackendQueryOptions, type GenerateBackendQueryUrlOptions, type InfraKey, createBackendApiClient, defaultLogger as defaultApiLogger, getQueryString };