@uniai-fe/util-api 0.1.5 → 0.1.7

package/dist/index.cjs

@@ -2,15 +2,19 @@
 
 var utilFunctions = require('@uniai-fe/util-functions');
 
-// src/request/module.ts
+// src/response/module.ts
+var setAlternateResponse = (errorMessage, data) => ({
+  status: "fail",
+  errors: [
+    { field_name: "", message: errorMessage || "\uB370\uC774\uD130 \uC870\uD68C\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4." }
+  ],
+  data
+});
 var getQueryString = (searchParams) => {
   const serialized = utilFunctions.convertObjectToSearchParams(searchParams).toString();
   return serialized ? `?${serialized}` : "";
 };
 var nextAPILog = (method, routeUrl, queryUrl, ...messages) => {
-  if (process.env.NODE_ENV === "production") {
-    return;
-  }
   const date = /* @__PURE__ */ new Date();
   const dateText = date.toISOString().split("T")[0] ?? "";
   const timeText = `${date.toLocaleTimeString("en-US", { hour12: false })}.${date.getMilliseconds()}`;
@@ -56,11 +60,13 @@ var getFetchOptions = ({
   method,
   headers,
   body
-}) => ({
-  method,
-  ...typeof headers === "undefined" ? {} : { headers },
-  ...typeof body === "undefined" ? {} : { body }
-});
+}) => {
+  const option = { method };
+  if (typeof headers !== "undefined" && headers && Object.keys(headers).length > 0)
+    Object.assign(option, { headers });
+  if (typeof body !== "undefined" && body) Object.assign(option, { body });
+  return option;
+};
 var fetchWithBody = async ({
   domain,
   method,
@@ -136,5 +142,6 @@ exports.getFetchOptions = getFetchOptions;
 exports.getQueryString = getQueryString;
 exports.getRouteUrl = getRouteUrl;
 exports.nextAPILog = nextAPILog;
+exports.setAlternateResponse = setAlternateResponse;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/request/module.ts"],"names":["convertObjectToSearchParams"],"mappings":"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","file":"index.cjs","sourcesContent":["import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n  API_FetchWithBodyParams,\n  API_GetFetchOptionsParams,\n  API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/**\n * API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n */\nexport const getQueryString = (searchParams?: unknown): string => {\n  // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n  const serialized = convertObjectToSearchParams(searchParams).toString();\n  return serialized ? `?${serialized}` : \"\";\n};\n\n/**\n * API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query 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\") {\n    return;\n  }\n\n  // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n  const date = new Date();\n  const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n  const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n  const requestMethod = method.split(\"-\")[0]?.toUpperCase() || \"-\";\n  const responseMethod = method.split(\"-\")[1]?.toUpperCase() || requestMethod;\n\n  return console.log(\n    `\\n`,\n    `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n    `\\n  λ [${requestMethod}] FE route`,\n    `\\n   ${routeUrl}`,\n    ...(queryUrl\n      ? [`\\n  ═⏵ Ω [${responseMethod}] BE url`, `\\n   ${queryUrl}`, `\\n`]\n      : []),\n    ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n    `\\n`,\n  );\n};\n\n/**\n * API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams | object} [searchParams] 쿼리스트링 원본\n */\nexport const getRouteUrl = (\n  routeUrl: string,\n  searchParams?: URLSearchParams | object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/**\n * API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n */\nexport const generateQueryUrl = ({\n  method = \"GET\",\n  domain,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  log,\n  logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n  if (!logDisabled) {\n    nextAPILog(method, routeUrl, url, {\n      ...(log ?? {}),\n      ...(searchParams ?? {}),\n    });\n  }\n\n  return url;\n};\n\n/**\n * API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit | null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n *   method: \"POST\",\n *   headers: { \"Content-Type\": \"application/json\" },\n *   body: JSON.stringify({ farm_id: 1 }),\n * });\n */\nexport const getFetchOptions = ({\n  method,\n  headers,\n  body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n  method,\n  ...(typeof headers === \"undefined\" ? {} : { headers }),\n  ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\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}: API_FetchWithBodyParams<\n  BodyDataType,\n  ResponseType\n>): Promise<ResponseType> => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n  const option = getFetchOptions({ method, headers, body });\n\n  if (!body && typeof bodyData !== \"undefined\") {\n    // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n    const bodyParams = convertObjectToSearchParams(bodyData).toString();\n    if (bodyParams === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...(debug ?? {}),\n      });\n      return alternateResponse;\n    }\n    option.body = bodyData as BodyInit;\n  }\n\n  if (!disabledLog) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...(debug ?? {}),\n    });\n  }\n\n  if (disabled) {\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    const responseCode = responseRaw.status;\n\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: responseCode,\n      });\n    }\n\n    if (isRawResponse) {\n      return responseRaw as ResponseType;\n    }\n    return (await responseRaw.json()) as ResponseType;\n  } catch (error: unknown) {\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"]}
+{"version":3,"sources":["../src/response/module.ts","../src/request/module.ts"],"names":["convertObjectToSearchParams"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { API_Res_Base } from \"./types\";\n\nexport const setAlternateResponse = <ResponseDataType>(\n  errorMessage: string,\n  data: ResponseDataType,\n): API_Res_Base<ResponseDataType> => ({\n  status: \"fail\",\n  errors: [\n    { field_name: \"\", message: errorMessage || \"데이터 조회에 실패했습니다.\" },\n  ],\n  data,\n});\n","import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n  API_FetchWithBodyParams,\n  API_GetFetchOptionsParams,\n  API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/**\n * API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n */\nexport const getQueryString = (searchParams?: unknown): string => {\n  // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n  const serialized = convertObjectToSearchParams(searchParams).toString();\n  return serialized ? `?${serialized}` : \"\";\n};\n\n/**\n * API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n */\nexport const nextAPILog = (\n  method: string,\n  routeUrl: string,\n  queryUrl?: string,\n  ...messages: unknown[]\n) => {\n  // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n  // if (process.env.NODE_ENV === \"production\") {\n  //   return;\n  // }\n\n  // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n  const date = new Date();\n  const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n  const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n  const requestMethod = method.split(\"-\")[0]?.toUpperCase() || \"-\";\n  const responseMethod = method.split(\"-\")[1]?.toUpperCase() || requestMethod;\n\n  return console.log(\n    `\\n`,\n    `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n    `\\n  λ [${requestMethod}] FE route`,\n    `\\n   ${routeUrl}`,\n    ...(queryUrl\n      ? [`\\n  ═⏵ Ω [${responseMethod}] BE url`, `\\n   ${queryUrl}`, `\\n`]\n      : []),\n    ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n    `\\n`,\n  );\n};\n\n/**\n * API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams | object} [searchParams] 쿼리스트링 원본\n */\nexport const getRouteUrl = (\n  routeUrl: string,\n  searchParams?: URLSearchParams | object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/**\n * API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n */\nexport const generateQueryUrl = ({\n  method = \"GET\",\n  domain,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  log,\n  logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n  if (!logDisabled) {\n    nextAPILog(method, routeUrl, url, {\n      ...(log ?? {}),\n      ...(searchParams ?? {}),\n    });\n  }\n\n  return url;\n};\n\n/**\n * API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit | null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n *   method: \"POST\",\n *   headers: { \"Content-Type\": \"application/json\" },\n *   body: JSON.stringify({ farm_id: 1 }),\n * });\n */\nexport const getFetchOptions = ({\n  method,\n  headers,\n  body,\n}: API_GetFetchOptionsParams): RequestInit => {\n  const option: RequestInit = { method };\n\n  // API fetch Headers\n  if (\n    typeof headers !== \"undefined\" &&\n    headers &&\n    Object.keys(headers).length > 0\n  )\n    Object.assign(option, { headers });\n\n  // API fetch Body\n  if (typeof body !== \"undefined\" && body) Object.assign(option, { body });\n\n  return option;\n};\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\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}: API_FetchWithBodyParams<\n  BodyDataType,\n  ResponseType\n>): Promise<ResponseType> => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n  const option = getFetchOptions({ method, headers, body });\n\n  if (!body && typeof bodyData !== \"undefined\") {\n    // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n    const bodyParams = convertObjectToSearchParams(bodyData).toString();\n    if (bodyParams === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...(debug ?? {}),\n      });\n      return alternateResponse;\n    }\n    option.body = bodyData as BodyInit;\n  }\n\n  if (!disabledLog) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...(debug ?? {}),\n    });\n  }\n\n  if (disabled) {\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    const responseCode = responseRaw.status;\n\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: responseCode,\n      });\n    }\n\n    if (isRawResponse) {\n      return responseRaw as ResponseType;\n    }\n    return (await responseRaw.json()) as ResponseType;\n  } catch (error: unknown) {\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"]}

package/dist/index.d.cts

@@ -1,2 +1,3 @@
-export { API_Res_Base, API_Res_Error, API_Res_Pagination, API_Res_Status } from './response/index.cjs';
+export { setAlternateResponse } from './response/index.cjs';
+export { A as API_Res_Base, a as API_Res_Error, b as API_Res_Pagination, c as API_Res_Status } from './types-Djyp4Jr-.cjs';
 export { API_FetchWithBodyParams, API_FetchWithBodyResponseFallback, API_GenerateQueryUrlParams, API_GetFetchOptionsParams, fetchWithBody, generateQueryUrl, getFetchOptions, getQueryString, getRouteUrl, nextAPILog } from './request/index.cjs';

package/dist/index.d.ts

@@ -1,2 +1,3 @@
-export { API_Res_Base, API_Res_Error, API_Res_Pagination, API_Res_Status } from './response/index.js';
+export { setAlternateResponse } from './response/index.js';
+export { A as API_Res_Base, a as API_Res_Error, b as API_Res_Pagination, c as API_Res_Status } from './types-Djyp4Jr-.js';
 export { API_FetchWithBodyParams, API_FetchWithBodyResponseFallback, API_GenerateQueryUrlParams, API_GetFetchOptionsParams, fetchWithBody, generateQueryUrl, getFetchOptions, getQueryString, getRouteUrl, nextAPILog } from './request/index.js';

package/dist/index.mjs

@@ -1,14 +1,18 @@
 import { convertObjectToSearchParams } from '@uniai-fe/util-functions';
 
-// src/request/module.ts
+// src/response/module.ts
+var setAlternateResponse = (errorMessage, data) => ({
+  status: "fail",
+  errors: [
+    { field_name: "", message: errorMessage || "\uB370\uC774\uD130 \uC870\uD68C\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4." }
+  ],
+  data
+});
 var getQueryString = (searchParams) => {
   const serialized = convertObjectToSearchParams(searchParams).toString();
   return serialized ? `?${serialized}` : "";
 };
 var nextAPILog = (method, routeUrl, queryUrl, ...messages) => {
-  if (process.env.NODE_ENV === "production") {
-    return;
-  }
   const date = /* @__PURE__ */ new Date();
   const dateText = date.toISOString().split("T")[0] ?? "";
   const timeText = `${date.toLocaleTimeString("en-US", { hour12: false })}.${date.getMilliseconds()}`;
@@ -54,11 +58,13 @@ var getFetchOptions = ({
   method,
   headers,
   body
-}) => ({
-  method,
-  ...typeof headers === "undefined" ? {} : { headers },
-  ...typeof body === "undefined" ? {} : { body }
-});
+}) => {
+  const option = { method };
+  if (typeof headers !== "undefined" && headers && Object.keys(headers).length > 0)
+    Object.assign(option, { headers });
+  if (typeof body !== "undefined" && body) Object.assign(option, { body });
+  return option;
+};
 var fetchWithBody = async ({
   domain,
   method,
@@ -128,6 +134,6 @@ var fetchWithBody = async ({
   }
 };
 
-export { fetchWithBody, generateQueryUrl, getFetchOptions, getQueryString, getRouteUrl, nextAPILog };
+export { fetchWithBody, generateQueryUrl, getFetchOptions, getQueryString, getRouteUrl, nextAPILog, setAlternateResponse };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/request/module.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n  API_FetchWithBodyParams,\n  API_GetFetchOptionsParams,\n  API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/**\n * API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n */\nexport const getQueryString = (searchParams?: unknown): string => {\n  // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n  const serialized = convertObjectToSearchParams(searchParams).toString();\n  return serialized ? `?${serialized}` : \"\";\n};\n\n/**\n * API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query 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\") {\n    return;\n  }\n\n  // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n  const date = new Date();\n  const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n  const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n  const requestMethod = method.split(\"-\")[0]?.toUpperCase() || \"-\";\n  const responseMethod = method.split(\"-\")[1]?.toUpperCase() || requestMethod;\n\n  return console.log(\n    `\\n`,\n    `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n    `\\n  λ [${requestMethod}] FE route`,\n    `\\n   ${routeUrl}`,\n    ...(queryUrl\n      ? [`\\n  ═⏵ Ω [${responseMethod}] BE url`, `\\n   ${queryUrl}`, `\\n`]\n      : []),\n    ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n    `\\n`,\n  );\n};\n\n/**\n * API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams | object} [searchParams] 쿼리스트링 원본\n */\nexport const getRouteUrl = (\n  routeUrl: string,\n  searchParams?: URLSearchParams | object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/**\n * API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n */\nexport const generateQueryUrl = ({\n  method = \"GET\",\n  domain,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  log,\n  logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n  if (!logDisabled) {\n    nextAPILog(method, routeUrl, url, {\n      ...(log ?? {}),\n      ...(searchParams ?? {}),\n    });\n  }\n\n  return url;\n};\n\n/**\n * API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit | null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n *   method: \"POST\",\n *   headers: { \"Content-Type\": \"application/json\" },\n *   body: JSON.stringify({ farm_id: 1 }),\n * });\n */\nexport const getFetchOptions = ({\n  method,\n  headers,\n  body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n  method,\n  ...(typeof headers === \"undefined\" ? {} : { headers }),\n  ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\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}: API_FetchWithBodyParams<\n  BodyDataType,\n  ResponseType\n>): Promise<ResponseType> => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n  const option = getFetchOptions({ method, headers, body });\n\n  if (!body && typeof bodyData !== \"undefined\") {\n    // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n    const bodyParams = convertObjectToSearchParams(bodyData).toString();\n    if (bodyParams === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...(debug ?? {}),\n      });\n      return alternateResponse;\n    }\n    option.body = bodyData as BodyInit;\n  }\n\n  if (!disabledLog) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...(debug ?? {}),\n    });\n  }\n\n  if (disabled) {\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    const responseCode = responseRaw.status;\n\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: responseCode,\n      });\n    }\n\n    if (isRawResponse) {\n      return responseRaw as ResponseType;\n    }\n    return (await responseRaw.json()) as ResponseType;\n  } catch (error: unknown) {\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"]}
+{"version":3,"sources":["../src/response/module.ts","../src/request/module.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { API_Res_Base } from \"./types\";\n\nexport const setAlternateResponse = <ResponseDataType>(\n  errorMessage: string,\n  data: ResponseDataType,\n): API_Res_Base<ResponseDataType> => ({\n  status: \"fail\",\n  errors: [\n    { field_name: \"\", message: errorMessage || \"데이터 조회에 실패했습니다.\" },\n  ],\n  data,\n});\n","import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n  API_FetchWithBodyParams,\n  API_GetFetchOptionsParams,\n  API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/**\n * API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n */\nexport const getQueryString = (searchParams?: unknown): string => {\n  // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n  const serialized = convertObjectToSearchParams(searchParams).toString();\n  return serialized ? `?${serialized}` : \"\";\n};\n\n/**\n * API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n */\nexport const nextAPILog = (\n  method: string,\n  routeUrl: string,\n  queryUrl?: string,\n  ...messages: unknown[]\n) => {\n  // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n  // if (process.env.NODE_ENV === \"production\") {\n  //   return;\n  // }\n\n  // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n  const date = new Date();\n  const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n  const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n  const requestMethod = method.split(\"-\")[0]?.toUpperCase() || \"-\";\n  const responseMethod = method.split(\"-\")[1]?.toUpperCase() || requestMethod;\n\n  return console.log(\n    `\\n`,\n    `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n    `\\n  λ [${requestMethod}] FE route`,\n    `\\n   ${routeUrl}`,\n    ...(queryUrl\n      ? [`\\n  ═⏵ Ω [${responseMethod}] BE url`, `\\n   ${queryUrl}`, `\\n`]\n      : []),\n    ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n    `\\n`,\n  );\n};\n\n/**\n * API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams | object} [searchParams] 쿼리스트링 원본\n */\nexport const getRouteUrl = (\n  routeUrl: string,\n  searchParams?: URLSearchParams | object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/**\n * API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n */\nexport const generateQueryUrl = ({\n  method = \"GET\",\n  domain,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  log,\n  logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n  if (!logDisabled) {\n    nextAPILog(method, routeUrl, url, {\n      ...(log ?? {}),\n      ...(searchParams ?? {}),\n    });\n  }\n\n  return url;\n};\n\n/**\n * API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit | null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n *   method: \"POST\",\n *   headers: { \"Content-Type\": \"application/json\" },\n *   body: JSON.stringify({ farm_id: 1 }),\n * });\n */\nexport const getFetchOptions = ({\n  method,\n  headers,\n  body,\n}: API_GetFetchOptionsParams): RequestInit => {\n  const option: RequestInit = { method };\n\n  // API fetch Headers\n  if (\n    typeof headers !== \"undefined\" &&\n    headers &&\n    Object.keys(headers).length > 0\n  )\n    Object.assign(option, { headers });\n\n  // API fetch Body\n  if (typeof body !== \"undefined\" && body) Object.assign(option, { body });\n\n  return option;\n};\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\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}: API_FetchWithBodyParams<\n  BodyDataType,\n  ResponseType\n>): Promise<ResponseType> => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n  const option = getFetchOptions({ method, headers, body });\n\n  if (!body && typeof bodyData !== \"undefined\") {\n    // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n    const bodyParams = convertObjectToSearchParams(bodyData).toString();\n    if (bodyParams === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...(debug ?? {}),\n      });\n      return alternateResponse;\n    }\n    option.body = bodyData as BodyInit;\n  }\n\n  if (!disabledLog) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...(debug ?? {}),\n    });\n  }\n\n  if (disabled) {\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    const responseCode = responseRaw.status;\n\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: responseCode,\n      });\n    }\n\n    if (isRawResponse) {\n      return responseRaw as ResponseType;\n    }\n    return (await responseRaw.json()) as ResponseType;\n  } catch (error: unknown) {\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"]}

package/dist/request/index.cjs

@@ -8,9 +8,6 @@ var getQueryString = (searchParams) => {
   return serialized ? `?${serialized}` : "";
 };
 var nextAPILog = (method, routeUrl, queryUrl, ...messages) => {
-  if (process.env.NODE_ENV === "production") {
-    return;
-  }
   const date = /* @__PURE__ */ new Date();
   const dateText = date.toISOString().split("T")[0] ?? "";
   const timeText = `${date.toLocaleTimeString("en-US", { hour12: false })}.${date.getMilliseconds()}`;
@@ -56,11 +53,13 @@ var getFetchOptions = ({
   method,
   headers,
   body
-}) => ({
-  method,
-  ...typeof headers === "undefined" ? {} : { headers },
-  ...typeof body === "undefined" ? {} : { body }
-});
+}) => {
+  const option = { method };
+  if (typeof headers !== "undefined" && headers && Object.keys(headers).length > 0)
+    Object.assign(option, { headers });
+  if (typeof body !== "undefined" && body) Object.assign(option, { body });
+  return option;
+};
 var fetchWithBody = async ({
   domain,
   method,

package/dist/request/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/request/module.ts"],"names":["convertObjectToSearchParams"],"mappings":"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","file":"index.cjs","sourcesContent":["import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n  API_FetchWithBodyParams,\n  API_GetFetchOptionsParams,\n  API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/**\n * API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n */\nexport const getQueryString = (searchParams?: unknown): string => {\n  // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n  const serialized = convertObjectToSearchParams(searchParams).toString();\n  return serialized ? `?${serialized}` : \"\";\n};\n\n/**\n * API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query 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\") {\n    return;\n  }\n\n  // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n  const date = new Date();\n  const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n  const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n  const requestMethod = method.split(\"-\")[0]?.toUpperCase() || \"-\";\n  const responseMethod = method.split(\"-\")[1]?.toUpperCase() || requestMethod;\n\n  return console.log(\n    `\\n`,\n    `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n    `\\n  λ [${requestMethod}] FE route`,\n    `\\n   ${routeUrl}`,\n    ...(queryUrl\n      ? [`\\n  ═⏵ Ω [${responseMethod}] BE url`, `\\n   ${queryUrl}`, `\\n`]\n      : []),\n    ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n    `\\n`,\n  );\n};\n\n/**\n * API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams | object} [searchParams] 쿼리스트링 원본\n */\nexport const getRouteUrl = (\n  routeUrl: string,\n  searchParams?: URLSearchParams | object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/**\n * API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n */\nexport const generateQueryUrl = ({\n  method = \"GET\",\n  domain,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  log,\n  logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n  if (!logDisabled) {\n    nextAPILog(method, routeUrl, url, {\n      ...(log ?? {}),\n      ...(searchParams ?? {}),\n    });\n  }\n\n  return url;\n};\n\n/**\n * API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit | null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n *   method: \"POST\",\n *   headers: { \"Content-Type\": \"application/json\" },\n *   body: JSON.stringify({ farm_id: 1 }),\n * });\n */\nexport const getFetchOptions = ({\n  method,\n  headers,\n  body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n  method,\n  ...(typeof headers === \"undefined\" ? {} : { headers }),\n  ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\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}: API_FetchWithBodyParams<\n  BodyDataType,\n  ResponseType\n>): Promise<ResponseType> => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n  const option = getFetchOptions({ method, headers, body });\n\n  if (!body && typeof bodyData !== \"undefined\") {\n    // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n    const bodyParams = convertObjectToSearchParams(bodyData).toString();\n    if (bodyParams === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...(debug ?? {}),\n      });\n      return alternateResponse;\n    }\n    option.body = bodyData as BodyInit;\n  }\n\n  if (!disabledLog) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...(debug ?? {}),\n    });\n  }\n\n  if (disabled) {\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    const responseCode = responseRaw.status;\n\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: responseCode,\n      });\n    }\n\n    if (isRawResponse) {\n      return responseRaw as ResponseType;\n    }\n    return (await responseRaw.json()) as ResponseType;\n  } catch (error: unknown) {\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"]}
+{"version":3,"sources":["../../src/request/module.ts"],"names":["convertObjectToSearchParams"],"mappings":"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","file":"index.cjs","sourcesContent":["import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n  API_FetchWithBodyParams,\n  API_GetFetchOptionsParams,\n  API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/**\n * API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n */\nexport const getQueryString = (searchParams?: unknown): string => {\n  // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n  const serialized = convertObjectToSearchParams(searchParams).toString();\n  return serialized ? `?${serialized}` : \"\";\n};\n\n/**\n * API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n */\nexport const nextAPILog = (\n  method: string,\n  routeUrl: string,\n  queryUrl?: string,\n  ...messages: unknown[]\n) => {\n  // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n  // if (process.env.NODE_ENV === \"production\") {\n  //   return;\n  // }\n\n  // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n  const date = new Date();\n  const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n  const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n  const requestMethod = method.split(\"-\")[0]?.toUpperCase() || \"-\";\n  const responseMethod = method.split(\"-\")[1]?.toUpperCase() || requestMethod;\n\n  return console.log(\n    `\\n`,\n    `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n    `\\n  λ [${requestMethod}] FE route`,\n    `\\n   ${routeUrl}`,\n    ...(queryUrl\n      ? [`\\n  ═⏵ Ω [${responseMethod}] BE url`, `\\n   ${queryUrl}`, `\\n`]\n      : []),\n    ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n    `\\n`,\n  );\n};\n\n/**\n * API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams | object} [searchParams] 쿼리스트링 원본\n */\nexport const getRouteUrl = (\n  routeUrl: string,\n  searchParams?: URLSearchParams | object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/**\n * API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n */\nexport const generateQueryUrl = ({\n  method = \"GET\",\n  domain,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  log,\n  logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n  if (!logDisabled) {\n    nextAPILog(method, routeUrl, url, {\n      ...(log ?? {}),\n      ...(searchParams ?? {}),\n    });\n  }\n\n  return url;\n};\n\n/**\n * API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit | null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n *   method: \"POST\",\n *   headers: { \"Content-Type\": \"application/json\" },\n *   body: JSON.stringify({ farm_id: 1 }),\n * });\n */\nexport const getFetchOptions = ({\n  method,\n  headers,\n  body,\n}: API_GetFetchOptionsParams): RequestInit => {\n  const option: RequestInit = { method };\n\n  // API fetch Headers\n  if (\n    typeof headers !== \"undefined\" &&\n    headers &&\n    Object.keys(headers).length > 0\n  )\n    Object.assign(option, { headers });\n\n  // API fetch Body\n  if (typeof body !== \"undefined\" && body) Object.assign(option, { body });\n\n  return option;\n};\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\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}: API_FetchWithBodyParams<\n  BodyDataType,\n  ResponseType\n>): Promise<ResponseType> => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n  const option = getFetchOptions({ method, headers, body });\n\n  if (!body && typeof bodyData !== \"undefined\") {\n    // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n    const bodyParams = convertObjectToSearchParams(bodyData).toString();\n    if (bodyParams === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...(debug ?? {}),\n      });\n      return alternateResponse;\n    }\n    option.body = bodyData as BodyInit;\n  }\n\n  if (!disabledLog) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...(debug ?? {}),\n    });\n  }\n\n  if (disabled) {\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    const responseCode = responseRaw.status;\n\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: responseCode,\n      });\n    }\n\n    if (isRawResponse) {\n      return responseRaw as ResponseType;\n    }\n    return (await responseRaw.json()) as ResponseType;\n  } catch (error: unknown) {\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"]}

package/dist/request/index.d.cts

@@ -1,4 +1,4 @@
-import { API_Res_Base } from '../response/index.cjs';
+import { A as API_Res_Base } from '../types-Djyp4Jr-.cjs';
 
 /**
  * API Request Types; GET URL 생성 파라미터

package/dist/request/index.d.ts

@@ -1,4 +1,4 @@
-import { API_Res_Base } from '../response/index.js';
+import { A as API_Res_Base } from '../types-Djyp4Jr-.js';
 
 /**
  * API Request Types; GET URL 생성 파라미터

package/dist/request/index.mjs

@@ -6,9 +6,6 @@ var getQueryString = (searchParams) => {
   return serialized ? `?${serialized}` : "";
 };
 var nextAPILog = (method, routeUrl, queryUrl, ...messages) => {
-  if (process.env.NODE_ENV === "production") {
-    return;
-  }
   const date = /* @__PURE__ */ new Date();
   const dateText = date.toISOString().split("T")[0] ?? "";
   const timeText = `${date.toLocaleTimeString("en-US", { hour12: false })}.${date.getMilliseconds()}`;
@@ -54,11 +51,13 @@ var getFetchOptions = ({
   method,
   headers,
   body
-}) => ({
-  method,
-  ...typeof headers === "undefined" ? {} : { headers },
-  ...typeof body === "undefined" ? {} : { body }
-});
+}) => {
+  const option = { method };
+  if (typeof headers !== "undefined" && headers && Object.keys(headers).length > 0)
+    Object.assign(option, { headers });
+  if (typeof body !== "undefined" && body) Object.assign(option, { body });
+  return option;
+};
 var fetchWithBody = async ({
   domain,
   method,

package/dist/request/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/request/module.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n  API_FetchWithBodyParams,\n  API_GetFetchOptionsParams,\n  API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/**\n * API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n */\nexport const getQueryString = (searchParams?: unknown): string => {\n  // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n  const serialized = convertObjectToSearchParams(searchParams).toString();\n  return serialized ? `?${serialized}` : \"\";\n};\n\n/**\n * API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query 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\") {\n    return;\n  }\n\n  // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n  const date = new Date();\n  const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n  const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n  const requestMethod = method.split(\"-\")[0]?.toUpperCase() || \"-\";\n  const responseMethod = method.split(\"-\")[1]?.toUpperCase() || requestMethod;\n\n  return console.log(\n    `\\n`,\n    `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n    `\\n  λ [${requestMethod}] FE route`,\n    `\\n   ${routeUrl}`,\n    ...(queryUrl\n      ? [`\\n  ═⏵ Ω [${responseMethod}] BE url`, `\\n   ${queryUrl}`, `\\n`]\n      : []),\n    ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n    `\\n`,\n  );\n};\n\n/**\n * API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams | object} [searchParams] 쿼리스트링 원본\n */\nexport const getRouteUrl = (\n  routeUrl: string,\n  searchParams?: URLSearchParams | object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/**\n * API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n */\nexport const generateQueryUrl = ({\n  method = \"GET\",\n  domain,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  log,\n  logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n  if (!logDisabled) {\n    nextAPILog(method, routeUrl, url, {\n      ...(log ?? {}),\n      ...(searchParams ?? {}),\n    });\n  }\n\n  return url;\n};\n\n/**\n * API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit | null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n *   method: \"POST\",\n *   headers: { \"Content-Type\": \"application/json\" },\n *   body: JSON.stringify({ farm_id: 1 }),\n * });\n */\nexport const getFetchOptions = ({\n  method,\n  headers,\n  body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n  method,\n  ...(typeof headers === \"undefined\" ? {} : { headers }),\n  ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\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}: API_FetchWithBodyParams<\n  BodyDataType,\n  ResponseType\n>): Promise<ResponseType> => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n  const option = getFetchOptions({ method, headers, body });\n\n  if (!body && typeof bodyData !== \"undefined\") {\n    // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n    const bodyParams = convertObjectToSearchParams(bodyData).toString();\n    if (bodyParams === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...(debug ?? {}),\n      });\n      return alternateResponse;\n    }\n    option.body = bodyData as BodyInit;\n  }\n\n  if (!disabledLog) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...(debug ?? {}),\n    });\n  }\n\n  if (disabled) {\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    const responseCode = responseRaw.status;\n\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: responseCode,\n      });\n    }\n\n    if (isRawResponse) {\n      return responseRaw as ResponseType;\n    }\n    return (await responseRaw.json()) as ResponseType;\n  } catch (error: unknown) {\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"]}
+{"version":3,"sources":["../../src/request/module.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n  API_FetchWithBodyParams,\n  API_GetFetchOptionsParams,\n  API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/**\n * API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n */\nexport const getQueryString = (searchParams?: unknown): string => {\n  // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n  const serialized = convertObjectToSearchParams(searchParams).toString();\n  return serialized ? `?${serialized}` : \"\";\n};\n\n/**\n * API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n */\nexport const nextAPILog = (\n  method: string,\n  routeUrl: string,\n  queryUrl?: string,\n  ...messages: unknown[]\n) => {\n  // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n  // if (process.env.NODE_ENV === \"production\") {\n  //   return;\n  // }\n\n  // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n  const date = new Date();\n  const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n  const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n  const requestMethod = method.split(\"-\")[0]?.toUpperCase() || \"-\";\n  const responseMethod = method.split(\"-\")[1]?.toUpperCase() || requestMethod;\n\n  return console.log(\n    `\\n`,\n    `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n    `\\n  λ [${requestMethod}] FE route`,\n    `\\n   ${routeUrl}`,\n    ...(queryUrl\n      ? [`\\n  ═⏵ Ω [${responseMethod}] BE url`, `\\n   ${queryUrl}`, `\\n`]\n      : []),\n    ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n    `\\n`,\n  );\n};\n\n/**\n * API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams | object} [searchParams] 쿼리스트링 원본\n */\nexport const getRouteUrl = (\n  routeUrl: string,\n  searchParams?: URLSearchParams | object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/**\n * API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n */\nexport const generateQueryUrl = ({\n  method = \"GET\",\n  domain,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  log,\n  logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n  if (!logDisabled) {\n    nextAPILog(method, routeUrl, url, {\n      ...(log ?? {}),\n      ...(searchParams ?? {}),\n    });\n  }\n\n  return url;\n};\n\n/**\n * API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit | null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n *   method: \"POST\",\n *   headers: { \"Content-Type\": \"application/json\" },\n *   body: JSON.stringify({ farm_id: 1 }),\n * });\n */\nexport const getFetchOptions = ({\n  method,\n  headers,\n  body,\n}: API_GetFetchOptionsParams): RequestInit => {\n  const option: RequestInit = { method };\n\n  // API fetch Headers\n  if (\n    typeof headers !== \"undefined\" &&\n    headers &&\n    Object.keys(headers).length > 0\n  )\n    Object.assign(option, { headers });\n\n  // API fetch Body\n  if (typeof body !== \"undefined\" && body) Object.assign(option, { body });\n\n  return option;\n};\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\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}: API_FetchWithBodyParams<\n  BodyDataType,\n  ResponseType\n>): Promise<ResponseType> => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n  const option = getFetchOptions({ method, headers, body });\n\n  if (!body && typeof bodyData !== \"undefined\") {\n    // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n    const bodyParams = convertObjectToSearchParams(bodyData).toString();\n    if (bodyParams === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...(debug ?? {}),\n      });\n      return alternateResponse;\n    }\n    option.body = bodyData as BodyInit;\n  }\n\n  if (!disabledLog) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...(debug ?? {}),\n    });\n  }\n\n  if (disabled) {\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    const responseCode = responseRaw.status;\n\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: responseCode,\n      });\n    }\n\n    if (isRawResponse) {\n      return responseRaw as ResponseType;\n    }\n    return (await responseRaw.json()) as ResponseType;\n  } catch (error: unknown) {\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"]}

package/dist/response/index.cjs

@@ -1,4 +1,14 @@
 'use strict';
 
+// src/response/module.ts
+var setAlternateResponse = (errorMessage, data) => ({
+  status: "fail",
+  errors: [
+    { field_name: "", message: errorMessage || "\uB370\uC774\uD130 \uC870\uD68C\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4." }
+  ],
+  data
+});
+
+exports.setAlternateResponse = setAlternateResponse;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/response/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../../src/response/module.ts"],"names":[],"mappings":";;;AAEO,IAAM,oBAAA,GAAuB,CAClC,YAAA,EACA,IAAA,MACoC;AAAA,EACpC,MAAA,EAAQ,MAAA;AAAA,EACR,MAAA,EAAQ;AAAA,IACN,EAAE,UAAA,EAAY,EAAA,EAAI,OAAA,EAAS,gBAAgB,6EAAA;AAAkB,GAC/D;AAAA,EACA;AACF,CAAA","file":"index.cjs","sourcesContent":["import type { API_Res_Base } from \"./types\";\n\nexport const setAlternateResponse = <ResponseDataType>(\n  errorMessage: string,\n  data: ResponseDataType,\n): API_Res_Base<ResponseDataType> => ({\n  status: \"fail\",\n  errors: [\n    { field_name: \"\", message: errorMessage || \"데이터 조회에 실패했습니다.\" },\n  ],\n  data,\n});\n"]}

package/dist/response/index.d.cts

@@ -1,73 +1,6 @@
-/**
- * API Response Types; Error item
- * @property {string} field_name 에러 필드 이름
- * @property {string} message 에러 메시지
- */
-interface API_Res_Error extends Record<string, string> {
-    /**
-     * 에러 필드 이름
-     */
-    field_name: string;
-    /**
-     * 에러 메시지
-     */
-    message: string;
-}
-/**
- * API Response Types; Status 값 타입
- * @example
- * const status: API_Res_Status = "success";
- */
-type API_Res_Status = "success" | "fail" | "timeout" | string;
-/**
- * API Response Types; Base 응답 구조
- * @template {unknown} ResultDataType
- * @property {API_Res_Status} status 통신 상태
- * @property {ResultDataType} data 요청 응답 데이터
- * @property {API_Res_Error[]} errors 에러 목록
- * @property {string} [timestamp] 응답 시간(UTC ISO 문자열)
- * @example
- * type API_Res_User = API_Res_Base<{ user_id: number }>;
- */
-interface API_Res_Base<ResultDataType> {
-    /**
-     * 통신 상태
-     */
-    status: API_Res_Status;
-    /**
-     * 요청 응답 데이터
-     */
-    data: ResultDataType;
-    /**
-     * 에러 목록
-     */
-    errors: API_Res_Error[];
-    /**
-     * 응답 시간(UTC ISO 문자열)
-     */
-    timestamp?: string;
-}
-/**
- * API Response Types; Pagination 응답 데이터
- * @property {number} total_count 전체 아이템 수
- * @property {number} size 페이지당 아이템 수
- * @property {ItemData} items 아이템 데이터
- * @example
- * type UserPagination = API_Res_Pagination<{ rows: Array<{ user_id: number }> }>;
- */
-interface API_Res_Pagination<ItemData extends Record<string, unknown>> {
-    /**
-     * 전체 아이템 수
-     */
-    total_count: number;
-    /**
-     * 페이지당 아이템 수
-     */
-    size: number;
-    /**
-     * 아이템 데이터
-     */
-    items: ItemData;
-}
+import { A as API_Res_Base } from '../types-Djyp4Jr-.cjs';
+export { a as API_Res_Error, b as API_Res_Pagination, c as API_Res_Status } from '../types-Djyp4Jr-.cjs';
 
-export type { API_Res_Base, API_Res_Error, API_Res_Pagination, API_Res_Status };
+declare const setAlternateResponse: <ResponseDataType>(errorMessage: string, data: ResponseDataType) => API_Res_Base<ResponseDataType>;
+
+export { API_Res_Base, setAlternateResponse };

package/dist/response/index.d.ts

@@ -1,73 +1,6 @@
-/**
- * API Response Types; Error item
- * @property {string} field_name 에러 필드 이름
- * @property {string} message 에러 메시지
- */
-interface API_Res_Error extends Record<string, string> {
-    /**
-     * 에러 필드 이름
-     */
-    field_name: string;
-    /**
-     * 에러 메시지
-     */
-    message: string;
-}
-/**
- * API Response Types; Status 값 타입
- * @example
- * const status: API_Res_Status = "success";
- */
-type API_Res_Status = "success" | "fail" | "timeout" | string;
-/**
- * API Response Types; Base 응답 구조
- * @template {unknown} ResultDataType
- * @property {API_Res_Status} status 통신 상태
- * @property {ResultDataType} data 요청 응답 데이터
- * @property {API_Res_Error[]} errors 에러 목록
- * @property {string} [timestamp] 응답 시간(UTC ISO 문자열)
- * @example
- * type API_Res_User = API_Res_Base<{ user_id: number }>;
- */
-interface API_Res_Base<ResultDataType> {
-    /**
-     * 통신 상태
-     */
-    status: API_Res_Status;
-    /**
-     * 요청 응답 데이터
-     */
-    data: ResultDataType;
-    /**
-     * 에러 목록
-     */
-    errors: API_Res_Error[];
-    /**
-     * 응답 시간(UTC ISO 문자열)
-     */
-    timestamp?: string;
-}
-/**
- * API Response Types; Pagination 응답 데이터
- * @property {number} total_count 전체 아이템 수
- * @property {number} size 페이지당 아이템 수
- * @property {ItemData} items 아이템 데이터
- * @example
- * type UserPagination = API_Res_Pagination<{ rows: Array<{ user_id: number }> }>;
- */
-interface API_Res_Pagination<ItemData extends Record<string, unknown>> {
-    /**
-     * 전체 아이템 수
-     */
-    total_count: number;
-    /**
-     * 페이지당 아이템 수
-     */
-    size: number;
-    /**
-     * 아이템 데이터
-     */
-    items: ItemData;
-}
+import { A as API_Res_Base } from '../types-Djyp4Jr-.js';
+export { a as API_Res_Error, b as API_Res_Pagination, c as API_Res_Status } from '../types-Djyp4Jr-.js';
 
-export type { API_Res_Base, API_Res_Error, API_Res_Pagination, API_Res_Status };
+declare const setAlternateResponse: <ResponseDataType>(errorMessage: string, data: ResponseDataType) => API_Res_Base<ResponseDataType>;
+
+export { API_Res_Base, setAlternateResponse };

package/dist/response/index.mjs

@@ -1,3 +1,12 @@
+// src/response/module.ts
+var setAlternateResponse = (errorMessage, data) => ({
+  status: "fail",
+  errors: [
+    { field_name: "", message: errorMessage || "\uB370\uC774\uD130 \uC870\uD68C\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4." }
+  ],
+  data
+});
 
+export { setAlternateResponse };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/response/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}
+{"version":3,"sources":["../../src/response/module.ts"],"names":[],"mappings":";AAEO,IAAM,oBAAA,GAAuB,CAClC,YAAA,EACA,IAAA,MACoC;AAAA,EACpC,MAAA,EAAQ,MAAA;AAAA,EACR,MAAA,EAAQ;AAAA,IACN,EAAE,UAAA,EAAY,EAAA,EAAI,OAAA,EAAS,gBAAgB,6EAAA;AAAkB,GAC/D;AAAA,EACA;AACF,CAAA","file":"index.mjs","sourcesContent":["import type { API_Res_Base } from \"./types\";\n\nexport const setAlternateResponse = <ResponseDataType>(\n  errorMessage: string,\n  data: ResponseDataType,\n): API_Res_Base<ResponseDataType> => ({\n  status: \"fail\",\n  errors: [\n    { field_name: \"\", message: errorMessage || \"데이터 조회에 실패했습니다.\" },\n  ],\n  data,\n});\n"]}

package/dist/types-Djyp4Jr-.d.cts

@@ -0,0 +1,73 @@
+/**
+ * API Response Types; Error item
+ * @property {string} field_name 에러 필드 이름
+ * @property {string} message 에러 메시지
+ */
+interface API_Res_Error extends Record<string, string> {
+    /**
+     * 에러 필드 이름
+     */
+    field_name: string;
+    /**
+     * 에러 메시지
+     */
+    message: string;
+}
+/**
+ * API Response Types; Status 값 타입
+ * @example
+ * const status: API_Res_Status = "success";
+ */
+type API_Res_Status = "success" | "fail" | "timeout" | string;
+/**
+ * API Response Types; Base 응답 구조
+ * @template {unknown} ResultDataType
+ * @property {API_Res_Status} status 통신 상태
+ * @property {ResultDataType} data 요청 응답 데이터
+ * @property {API_Res_Error[]} errors 에러 목록
+ * @property {string} [timestamp] 응답 시간(UTC ISO 문자열)
+ * @example
+ * type API_Res_User = API_Res_Base<{ user_id: number }>;
+ */
+interface API_Res_Base<ResultDataType> {
+    /**
+     * 통신 상태
+     */
+    status: API_Res_Status;
+    /**
+     * 요청 응답 데이터
+     */
+    data: ResultDataType;
+    /**
+     * 에러 목록
+     */
+    errors: API_Res_Error[];
+    /**
+     * 응답 시간(UTC ISO 문자열)
+     */
+    timestamp?: string;
+}
+/**
+ * API Response Types; Pagination 응답 데이터
+ * @property {number} total_count 전체 아이템 수
+ * @property {number} size 페이지당 아이템 수
+ * @property {ItemData} items 아이템 데이터
+ * @example
+ * type UserPagination = API_Res_Pagination<{ rows: Array<{ user_id: number }> }>;
+ */
+interface API_Res_Pagination<ItemData extends Record<string, unknown>> {
+    /**
+     * 전체 아이템 수
+     */
+    total_count: number;
+    /**
+     * 페이지당 아이템 수
+     */
+    size: number;
+    /**
+     * 아이템 데이터
+     */
+    items: ItemData;
+}
+
+export type { API_Res_Base as A, API_Res_Error as a, API_Res_Pagination as b, API_Res_Status as c };

package/dist/types-Djyp4Jr-.d.ts

@@ -0,0 +1,73 @@
+/**
+ * API Response Types; Error item
+ * @property {string} field_name 에러 필드 이름
+ * @property {string} message 에러 메시지
+ */
+interface API_Res_Error extends Record<string, string> {
+    /**
+     * 에러 필드 이름
+     */
+    field_name: string;
+    /**
+     * 에러 메시지
+     */
+    message: string;
+}
+/**
+ * API Response Types; Status 값 타입
+ * @example
+ * const status: API_Res_Status = "success";
+ */
+type API_Res_Status = "success" | "fail" | "timeout" | string;
+/**
+ * API Response Types; Base 응답 구조
+ * @template {unknown} ResultDataType
+ * @property {API_Res_Status} status 통신 상태
+ * @property {ResultDataType} data 요청 응답 데이터
+ * @property {API_Res_Error[]} errors 에러 목록
+ * @property {string} [timestamp] 응답 시간(UTC ISO 문자열)
+ * @example
+ * type API_Res_User = API_Res_Base<{ user_id: number }>;
+ */
+interface API_Res_Base<ResultDataType> {
+    /**
+     * 통신 상태
+     */
+    status: API_Res_Status;
+    /**
+     * 요청 응답 데이터
+     */
+    data: ResultDataType;
+    /**
+     * 에러 목록
+     */
+    errors: API_Res_Error[];
+    /**
+     * 응답 시간(UTC ISO 문자열)
+     */
+    timestamp?: string;
+}
+/**
+ * API Response Types; Pagination 응답 데이터
+ * @property {number} total_count 전체 아이템 수
+ * @property {number} size 페이지당 아이템 수
+ * @property {ItemData} items 아이템 데이터
+ * @example
+ * type UserPagination = API_Res_Pagination<{ rows: Array<{ user_id: number }> }>;
+ */
+interface API_Res_Pagination<ItemData extends Record<string, unknown>> {
+    /**
+     * 전체 아이템 수
+     */
+    total_count: number;
+    /**
+     * 페이지당 아이템 수
+     */
+    size: number;
+    /**
+     * 아이템 데이터
+     */
+    items: ItemData;
+}
+
+export type { API_Res_Base as A, API_Res_Error as a, API_Res_Pagination as b, API_Res_Status as c };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniai-fe/util-api",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "API contract types and framework-agnostic utilities for UNIAI FE projects",
   "type": "module",
   "private": false,
@@ -10,7 +10,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "packageManager": "pnpm@10.30.2",
+  "packageManager": "pnpm@10.32.1",
   "engines": {
     "node": ">=24",
     "pnpm": ">=10"