@uniai-fe/util-functions 0.1.0 → 0.1.1

package/README.md

@@ -2,12 +2,44 @@
 
 의존성을 최소화한 범용 도구 모음
 
+## 빠른 사용법 (API + 환경변수)
+
+- 1단계만 기억하세요: **env 맵만 넘겨 `createBackendApiClientFromEnv`를 호출**합니다.
+- 예시:
+
+  ```ts
+  import { createBackendApiClientFromEnv } from "@uniai-fe/util-functions/api";
+
+  // env 맵 → 도메인으로 바꿔주는 클라이언트를 한 번만 생성
+  const api = createBackendApiClientFromEnv({
+    ai: process.env.AI_API_BASE,
+    db: process.env.DB_API_BASE,
+    uniai: process.env.UNIAI_API_BASE,
+  });
+
+  export const { generateBackendQueryUrl_GET, fetchBackendQuery } = api;
+  export const apiLog = api.logger; // == nextAPILog
+  ```
+
+- 서비스 앱이든 모듈 패키지든 동일한 접근입니다. Next.js이면 `@uniai-fe/util-next`의 어댑터를 통해 같은 API를 그대로 사용하면 됩니다.
+
 ## 타입 선언 관리 메모
 
 - 내부 타입 정의는 `.d.ts` 대신 `.ts` 모듈(예: `src/core/format/types.ts`)로 유지합니다.
 - tsup 번들 과정에서 선언 전용 파일이 엔트리에 포함되면 경고가 발생할 수 있어,
   `.ts` 모듈로 import/export 하되 TypeScript가 컴파일 시 타입만 제거하도록 위임합니다.
 
+## 동작 원리 / 로직 개요
+
+- `createBackendApiClientFromEnv`는 env 맵 → `resolveDomain` → API 클라이언트로 이어지는 단계를 한 번에 처리합니다. env가 비어 있으면 `process.env[${INFRA}_API_BASE]` → `infra` 문자열 순으로 fallback 합니다.
+- 직접 제어가 필요하면 `createEnvDomainResolver`를 사용해 resolver만 만들고 `createBackendApiClient`에 주입할 수 있습니다.
+- 클라이언트에서 얻을 수 있는 것들:
+  - `generateBackendQueryUrl_GET`: 도메인 + 쿼리스트링 조합
+  - `fetchBackendQuery`: POST/DELETE 등 본문 포함 요청과 로깅/대체응답 처리
+  - `getQueryString`: 객체/URLSearchParams 직렬화
+  - `logger`: 공통 포맷 로거
+- 이 구조 덕분에 최종 사용 단계는 “한 번 정의한 클라이언트에서 함수 가져다 쓰기”로 끝납니다.
+
 ## Next.js 유틸 안내
 
 - Next 서버 전용 API 도우미는 `@uniai-fe/util-next` 패키지로 이동했습니다.

package/dist/api/index.cjs

@@ -45,10 +45,7 @@ var convertObjectToSearchParams = (data) => {
   }
   if (isKeyChainRecord(data) && Object.keys(data).length > 0) {
     const d = Object.fromEntries(
-      Object.entries(data).map(([key, value]) => [
-        key,
-        string(value)
-      ])
+      Object.entries(data).map(([key, value]) => [key, string(value)])
     );
     return new URLSearchParams(d);
   }
@@ -62,8 +59,8 @@ var convertObjectToSearchParams = (data) => {
 };
 var convert2Digit = (date_time) => date_time < 10 ? `0${date_time}` : String(date_time);
 
-// src/api/module.ts
-var defaultLogger = (method, routeUrl, queryUrl, ...messages) => {
+// src/api/util.ts
+var nextAPILog = (method, routeUrl, queryUrl, ...messages) => {
   if (process.env.NODE_ENV === "production") return;
   const DATE = dateFormat(/* @__PURE__ */ new Date());
   const TIME = new Intl.DateTimeFormat("en-US", {
@@ -75,9 +72,10 @@ var defaultLogger = (method, routeUrl, queryUrl, ...messages) => {
   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} )`,
+    `[Next Server API] \u23F1 ${DATE} ( ${TIME} )`,
     `
   \u03BB [${REQUEST_METHOD}] FE route`,
     `
@@ -91,6 +89,7 @@ var defaultLogger = (method, routeUrl, queryUrl, ...messages) => {
 `
   );
 };
+var getQueryString = (searchParams) => typeof searchParams !== "undefined" && convertObjectToSearchParams(searchParams).toString() ? `?${convertObjectToSearchParams(searchParams).toString()}` : "";
 var getFetchOptions = ({
   method,
   headers,
@@ -101,135 +100,171 @@ var getFetchOptions = ({
   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;
+
+// src/api/module.ts
+var generateBackendQueryUrl_GET = ({
+  domain,
+  routeUrl,
+  queryUrl,
+  searchParams,
+  // 가공이 완료된 파라미터
+  log,
+  logDisabled
+}) => {
+  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;
+  if (!logDisabled)
+    nextAPILog("get", routeUrl, url, {
+      ...log,
+      ...searchParams ? searchParams : {}
+    });
+  return url;
 };
-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;
+var fetchBackendQuery = async ({
+  domain,
+  method,
+  routeUrl,
+  queryUrl,
+  headers,
+  body,
+  bodyOriginData,
+  queryStringData,
+  log,
+  logDisabled,
+  fetchDisabled
+}) => {
+  const url = `${domain}${queryUrl}${getQueryString(queryStringData)}`;
+  const errRes = {
+    is_ok: false,
+    idx: "",
+    error: ""
   };
-  const fetchBackendQuery = async ({
-    infra,
-    domain,
-    routeUrl,
-    queryUrl,
+  const bodyData = convertObjectToSearchParams(bodyOriginData);
+  if (typeof bodyOriginData !== "undefined" && bodyData.toString() === "") {
+    if (!logDisabled) {
+      nextAPILog(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,
-    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
+    body
+  });
+  if (!body && typeof bodyOriginData !== "undefined")
+    Object.assign(option, { body: bodyData });
+  if (!logDisabled) {
+    nextAPILog(method.toLowerCase(), routeUrl, url, {
+      state: "READY",
+      ...option,
+      ...log
     });
-    if (!body && typeof bodyOriginData !== "undefined")
-      Object.assign(option, { body: bodyData });
-    const logFn = logger ?? baseLogger;
+  }
+  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;
+      nextAPILog(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: "READY",
-        ...option,
+      nextAPILog(method.toLowerCase(), routeUrl, url, {
+        state: "ERROR (RESPONSE)",
+        error,
         ...log
       });
     }
-    if (fetchDisabled) {
-      errRes.error = "API \uC694\uCCAD\uC81C\uD55C \uD65C\uC131\uD654\uB428.";
-      return errRes;
+    return errRes;
+  }
+};
+var fetchWithBody = async ({
+  domain,
+  method,
+  routeUrl,
+  queryUrl,
+  searchParams,
+  headers,
+  body,
+  bodyData,
+  isRawResponse,
+  alternateResponse,
+  debug,
+  disabled,
+  disabledLog
+}) => {
+  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;
+  const option = getFetchOptions({
+    method,
+    headers,
+    body
+  });
+  if (!body && typeof bodyData !== "undefined") {
+    if (typeof bodyData !== "undefined" && String(bodyData) === "") {
+      nextAPILog(method.toLowerCase(), routeUrl, url, {
+        state: "ERROR (BODY - DATA)",
+        error: "\uB370\uC774\uD130\uAC00 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
+        bodyData,
+        ...debug
+      });
+      return alternateResponse;
     }
-    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;
+    Object.assign(option, { body: bodyData });
+  }
+  if (!disabledLog)
+    nextAPILog(method.toLowerCase(), routeUrl, url, {
+      state: "READY",
+      ...option,
+      ...debug
+    });
+  if (disabled) {
+    nextAPILog(method.toLowerCase(), routeUrl, url, {
+      state: "FETCH DISABLED",
+      message: "API \uC694\uCCAD\uC81C\uD55C \uD65C\uC131\uD654\uB428."
+    });
+    return alternateResponse;
+  }
+  try {
+    const responseRaw = await fetch(url, option);
+    const resCode = responseRaw.status;
+    if (!disabledLog) {
+      nextAPILog(method.toLowerCase(), routeUrl, url, {
+        state: resCode === 200 ? "SUCCESS" : "FAIL",
+        code: resCode
+      });
     }
-  };
-  return {
-    getQueryString,
-    generateBackendQueryUrl_GET,
-    fetchBackendQuery,
-    logger: baseLogger
-  };
+    if (isRawResponse) return responseRaw;
+    const res = await responseRaw.json();
+    return res;
+  } catch (error) {
+    if (!disabledLog)
+      nextAPILog(method.toLowerCase(), routeUrl, url, {
+        state: "ERROR (RESPONSE)",
+        error,
+        ...debug
+      });
+    return alternateResponse;
+  }
 };
 
-exports.createBackendApiClient = createBackendApiClient;
-exports.defaultApiLogger = defaultLogger;
+exports.fetchBackendQuery = fetchBackendQuery;
+exports.fetchWithBody = fetchWithBody;
+exports.generateBackendQueryUrl_GET = generateBackendQueryUrl_GET;
+exports.getFetchOptions = getFetchOptions;
 exports.getQueryString = getQueryString;
+exports.nextAPILog = nextAPILog;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/api/index.cjs.map

@@ -1 +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"]}
+{"version":3,"sources":["../../src/validation/module.ts","../../src/format/module.ts","../../src/convert/module.ts","../../src/api/util.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) 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]) => [key, string(value)]),\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\";\nimport { dateFormat } from \"../format\";\n\n/**\n * 콘솔로그; Next.js API Route 디버깅용\n * @util\n * @param {string} method GET, POST, DELETE\n * @param {string} routeUrl Next.js route API route URL\n * @param {string} [queryUrl] DB API route URL\n * @param {unknown[]} [messages] 로그 데이터\n */\nexport const nextAPILog = (\n  method: string,\n  routeUrl: string,\n  queryUrl?: string,\n  ...messages: unknown[]\n) => {\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`,\n    `[Next Server 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 * API; 쿼리스트링 생성\n * @util\n * @param {unknown} [searchParams] 쿼리스트링으로 변환할 객체\n * @return {string} 쿼리스트링\n */\nexport const getQueryString = (searchParams?: unknown): string =>\n  typeof searchParams !== \"undefined\" &&\n  convertObjectToSearchParams(searchParams).toString()\n    ? `?${convertObjectToSearchParams(searchParams).toString()}`\n    : \"\";\n\n/**\n * API; POST/DELETE method option\n */\nexport const 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  // API fetch Headers\n  if (typeof headers !== \"undefined\") Object.assign(option, { headers });\n  // API fetch Body\n  if (typeof body !== \"undefined\") Object.assign(option, { body });\n  return option;\n};\n","import { convertObjectToSearchParams } from \"../convert\";\nimport { getFetchOptions, getQueryString, nextAPILog } from \"./util\";\nimport type { CommonPostResponseType } from \"./types\";\n\n/**\n * API 요청 url 생성; GET 타입\n * @util\n * @param {object} props\n * @param {\"ai\" | \"db\" | string} props.domain API 인프라\n * @param {string} props.routeUrl Next.js /app/api 라우트 주소\n * @param {string} props.queryUrl 백엔드 API url\n * @param {URLSearchParams} [props.searchParams] 쿼리 스트링 추출\n * @param {object} [props.log] 디버깅용 서버 로그 정보\n * @param {boolean} [props.logDisabled] 로그 비활성화\n * @return {string} GET API 요청 full url\n */\nexport const generateBackendQueryUrl_GET = ({\n  domain,\n  routeUrl,\n  queryUrl,\n  searchParams, // 가공이 완료된 파라미터\n  log,\n  logDisabled,\n}: {\n  /**\n   * API 도메인\n   */\n  domain: string;\n  /**\n   * Next.js /app/api 라우트 주소\n   */\n  routeUrl: string;\n  /**\n   * 백엔드 API url\n   */\n  queryUrl: string;\n} & Partial<{\n  /**\n   * 쿼리 스트링\n   * @desc\n   * - URLSearchParams 객체로 가공된 파라미터\n   */\n  searchParams: URLSearchParams | object;\n  /**\n   * 디버깅용 서버 로그 정보\n   */\n  log: object;\n  /**\n   * 로그 비활성화\n   * @default false\n   */\n  logDisabled: boolean;\n}>): string => {\n  // url 생성\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n  // 서버 로그 출력\n  if (!logDisabled)\n    nextAPILog(\"get\", routeUrl, url, {\n      ...log,\n      ...(searchParams ? searchParams : {}),\n    });\n\n  return url;\n};\n\n/**\n * API fetch 요청; POST/DELETE 타입\n * @util\n * @param {object} props\n * @param {\"ai\" | \"db\" | string} props.infra API 인프라\n * @param {\"POST\" | \"DELETE\"} props.method POST, DELETE\n * @param {string} props.routeUrl Next.js /app/api 라우트 주소\n * @param {string} props.queryUrl 백엔드 API url\n * @param {HeadersInit} [props.headers] fetch Headers\n * @param {BodyInit | null} [props.body] post/delete body (이대로 바로 전송됨)\n * @param {object} [props.bodyData] body로 전송하기 위해 가공이 필요한 데이터 객체\n * @param {object} [props.queryStringData] url에 쿼리스트링으로 요청하는 경우에 대한 데이터 객체\n * @param {object} [props.log] 디버깅용 서버 로그 정보\n * @param {boolean} [props.logDisabled] 로그 비활성화\n * @param {boolean} [props.fetchDisabled] fetch 실행 비활성화\n * @return {Promise<MutateAPICommonResponseType>} POST, DELETE 응답\n */\nexport const fetchBackendQuery = async <\n  FetchRequestType extends object,\n  FetchResponseType extends CommonPostResponseType,\n>({\n  domain,\n  method,\n  routeUrl,\n  queryUrl,\n  headers,\n  body,\n  bodyOriginData,\n  queryStringData,\n  log,\n  logDisabled,\n  fetchDisabled,\n}: {\n  /**\n   * API 도메인\n   */\n  domain: string;\n  /**\n   * 요청 방식\n   * POST, DELETE\n   */\n  method: \"POST\" | \"DELETE\";\n  /**\n   * 프론트 API URL\n   */\n  routeUrl: string;\n  /**\n   * 백엔드 API 요청 URL\n   */\n  queryUrl: string;\n} & Partial<{\n  /**\n   * fetch Headers\n   */\n  headers: HeadersInit;\n  /**\n   * fetch Body\n   */\n  body: BodyInit | null;\n  /**\n   * fetch Body 를 SearchParams 전환할 데이터\n   */\n  bodyOriginData: FetchRequestType;\n  /**\n   * URL 쿼리 스트링\n   */\n  queryStringData: FetchRequestType;\n  /**\n   * 디버그용 로그 객체\n   */\n  log: object;\n  /**\n   * 로그 비활성화\n   */\n  logDisabled: boolean;\n  /**\n   * fetch 비활성화\n   */\n  fetchDisabled: boolean;\n}>): Promise<FetchResponseType> => {\n  // 쿼리 url 생성\n  const url = `${domain}${queryUrl}${getQueryString(queryStringData)}`;\n\n  // 에러 응답\n  const errRes: FetchResponseType = {\n    is_ok: false,\n    idx: \"\",\n    error: \"\",\n  } as FetchResponseType;\n\n  const bodyData = convertObjectToSearchParams(bodyOriginData);\n\n  // bodyOriginData가 undefined가 아닌데도, bodyOriginData의 데이터가 유효하지 않은 경우\n  if (typeof bodyOriginData !== \"undefined\" && bodyData.toString() === \"\") {\n    if (!logDisabled) {\n      nextAPILog(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  // 쿼리 옵션 생성\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  // 로그 옵션\n  if (!logDisabled) {\n    // 쿼리 전 로그 출력\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...log,\n    });\n  }\n\n  // 디버깅을 위한 fetch 요청 제한\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      // API 응답 성공 여부\n      const isSuccess =\n        \"is_ok\" in res && typeof res?.is_ok === \"boolean\" && res.is_ok === true;\n\n      nextAPILog(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      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (RESPONSE)\",\n        error,\n        ...log,\n      });\n    }\n\n    return errRes;\n  }\n};\n\n/**\n * API; POST/DELETE method fetch\n * @util\n * @param {object} props\n * @param {\"ai\" | \"db\" | string} props.domain\n * @param {\"POST\" | \"DELETE\"} props.method POST, DELETE\n * @param {string} props.routeUrl Next.js /app/api 라우트 주소\n * @param {string} props.queryUrl 백엔드 API url\n * @param {HeadersInit} [props.headers] fetch Headers\n * @param {BodyInit | null} [props.body] post/delete body (이대로 바로 전송됨)\n * @param {object} [props.bodyData] body로 전송하기 위해 가공이 필요한 데이터 객체\n * @param {object} [props.log] 디버깅용 서버 로그 정보\n * @param {boolean} [props.logDisabled] 로그 비활성화\n * @param {boolean} [props.fetchDisabled] fetch 실행 비활성화\n * @param {object} [props.alternateResponse] fetch 실패 시 대체 응답\n * @return {Promise<ResponseType>} POST, DELETE 응답\n */\nexport const fetchWithBody = async <\n  BodyDataType = object,\n  ResponseType extends object | Response = Response,\n>({\n  domain,\n  method,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  headers,\n  body,\n  bodyData,\n  isRawResponse,\n  alternateResponse,\n  debug,\n  disabled,\n  disabledLog,\n}: {\n  /**\n   * API 도메인\n   */\n  domain: string;\n  /**\n   * 요청 방식\n   * POST, DELETE\n   */\n  method: string;\n  /**\n   * 프론트 API URL\n   */\n  routeUrl: string;\n  /**\n   * 백엔드 API 요청 URL\n   */\n  queryUrl: string;\n  /**\n   * fetch 실패 시 대체 응답\n   */\n  alternateResponse: ResponseType;\n} & Partial<{\n  searchParams: URLSearchParams | object;\n  /**\n   * fetch Headers\n   */\n  headers: HeadersInit;\n  /**\n   * fetch Body\n   */\n  body: BodyInit | null;\n  /**\n   * fetch Body Data\n   */\n  bodyData: BodyDataType;\n  /**\n   * 응답값 원본으로 return\n   * const responseRaw = await fetch(api);\n   */\n  isRawResponse: boolean;\n  /**\n   * 디버그용 로그 객체\n   */\n  debug: object;\n  /**\n   * fetch 비활성화\n   */\n  disabled: boolean;\n  /**\n   * 로그 비활성화\n   */\n  disabledLog: boolean;\n}>): Promise<ResponseType> => {\n  // ------------------------------------- API 요청 URL 생성\n\n  // url 생성\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n  // ------------------------------------- 쿼리 옵션 생성\n  const option: RequestInit = getFetchOptions({\n    method,\n    headers,\n    body,\n  });\n\n  // ------------------------------------- body data 적용\n  // 완성된 body가 없고, body 데이터는 있는 경우\n  if (!body && typeof bodyData !== \"undefined\") {\n    // bodyData가 undefined가 아닌데도, bodyData의 데이터가 유효하지 않은 경우\n    if (typeof bodyData !== \"undefined\" && String(bodyData) === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...debug,\n      });\n\n      return alternateResponse;\n    }\n\n    // option에 bodyData 적용\n    Object.assign(option, { body: bodyData });\n  }\n\n  // option 준비가 완료되면, READY 상태\n  if (!disabledLog)\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...debug,\n    });\n\n  // ------------------------------------- fetch 요청\n  if (disabled) {\n    // fetch 요청 비활성화\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"FETCH DISABLED\",\n      message: \"API 요청제한 활성화됨.\",\n    });\n    return alternateResponse;\n  }\n\n  try {\n    const responseRaw = await fetch(url, option);\n\n    // API 응답 상태 코드\n    const resCode = responseRaw.status;\n\n    // API 응답 성공 여부\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: resCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: resCode,\n      });\n    }\n\n    if (isRawResponse) return responseRaw as ResponseType;\n\n    const res = await responseRaw.json();\n    return res;\n  } catch (error: unknown) {\n    // 에러 응답\n    if (!disabledLog)\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (RESPONSE)\",\n        error,\n        ...debug,\n      });\n\n    return alternateResponse;\n  }\n};\n"]}